mirror of
https://github.com/stablyai/orca.git
synced 2026-09-29 08:03:20 +00:00
Brennan Benson
a10a2ba53c
* feat(linear): add MCP-style save issue * fix(linear): harden save issue parity * fix(linear): close save issue contract gaps * docs(linear): bundle project discovery with save issue
164 lines
6.1 KiB
TypeScript
164 lines
6.1 KiB
TypeScript
export function getRemoteLinearReadHelp(commandPath: string[]): string | null {
|
|
if (commandPath.length === 1 && commandPath[0] === 'linear') {
|
|
return LINEAR_HELP
|
|
}
|
|
if (matchesRemoteCommand(commandPath, 'linear', 'issue')) {
|
|
return LINEAR_ISSUE_HELP
|
|
}
|
|
if (matchesRemoteCommand(commandPath, 'linear', 'list-issues')) {
|
|
return LINEAR_MCP_ISSUE_LIST_HELP
|
|
}
|
|
if (matchesRemoteCommand(commandPath, 'linear', 'search')) {
|
|
return LINEAR_SEARCH_HELP
|
|
}
|
|
if (matchesRemoteCommand(commandPath, 'linear', 'team', 'list')) {
|
|
return LINEAR_TEAM_LIST_HELP
|
|
}
|
|
if (matchesRemoteCommand(commandPath, 'linear', 'team', 'members')) {
|
|
return LINEAR_TEAM_MEMBERS_HELP
|
|
}
|
|
if (matchesRemoteCommand(commandPath, 'linear', 'team', 'states')) {
|
|
return LINEAR_TEAM_STATES_HELP
|
|
}
|
|
if (matchesRemoteCommand(commandPath, 'linear', 'team', 'labels')) {
|
|
return LINEAR_TEAM_LABELS_HELP
|
|
}
|
|
if (matchesRemoteCommand(commandPath, 'linear', 'project', 'list')) {
|
|
return LINEAR_PROJECT_LIST_HELP
|
|
}
|
|
if (matchesRemoteCommand(commandPath, 'linear', 'list')) {
|
|
return LINEAR_LIST_HELP
|
|
}
|
|
return null
|
|
}
|
|
|
|
function matchesRemoteCommand(commandPath: string[], ...command: string[]): boolean {
|
|
return (
|
|
commandPath.length === command.length &&
|
|
command.every((part, index) => commandPath[index] === part)
|
|
)
|
|
}
|
|
|
|
const LINEAR_HELP = `orca linear
|
|
|
|
Usage: orca linear <command> [options]
|
|
|
|
Commands:
|
|
save-issue Create or update a Linear issue
|
|
list-issues List Linear issues with MCP-compatible filters
|
|
relation add Add a Linear issue relation
|
|
relation remove Remove a Linear issue relation
|
|
issue Read Linear issue context for agents
|
|
search Search connected Linear workspaces
|
|
team list List connected Linear teams
|
|
team members List Linear team members
|
|
team states List Linear team workflow states
|
|
team labels List Linear team labels
|
|
project list List connected Linear projects
|
|
list List Linear issues
|
|
assignee set Set a Linear issue assignee
|
|
assignee clear Clear a Linear issue assignee
|
|
priority set Set a Linear issue priority
|
|
priority clear Clear a Linear issue priority
|
|
estimate set Set a Linear issue estimate
|
|
estimate clear Clear a Linear issue estimate
|
|
due-date set Set a Linear issue due date
|
|
due-date clear Clear a Linear issue due date
|
|
label add Add labels to a Linear issue
|
|
label remove Remove labels from a Linear issue
|
|
label set Replace labels on a Linear issue
|
|
status set Set a Linear issue status
|
|
comment add Add a comment to a Linear issue
|
|
attach Attach a link to a Linear issue
|
|
create Create a Linear issue
|
|
|
|
Run \`orca linear <command> --help\` for command-specific usage.`
|
|
|
|
const LINEAR_ISSUE_HELP = `orca linear issue
|
|
|
|
Usage: orca linear issue [<id>] [--current] [--comments] [--children] [--depth <n>] [--attachments] [--relations] [--activity] [--full] [--workspace <id>] [--json]
|
|
|
|
Read Linear issue context for agents
|
|
|
|
Options:
|
|
--help Show this help message
|
|
--json Emit machine-readable JSON
|
|
--pairing-code
|
|
--environment
|
|
--current Use the current Orca worktree linked Linear issue
|
|
--comments Include threaded Linear comments
|
|
--children Include recursive child issues
|
|
--depth <n> Child issue depth for --children/--full
|
|
--attachments Include attachment metadata and URLs
|
|
--relations Include blocking, related, and duplicate links
|
|
--activity Include issue field-change history
|
|
--full Include all supported V1 issue context within caps
|
|
--workspace <id> Connected Linear workspace id
|
|
--id <id> Linear issue key, id, or URL
|
|
|
|
Examples:
|
|
$ orca linear issue ENG-123
|
|
$ orca linear issue --current --comments
|
|
$ orca linear issue https://linear.app/acme/issue/ENG-123 --full --json`
|
|
|
|
const LINEAR_MCP_ISSUE_LIST_HELP = `orca linear list-issues
|
|
|
|
Usage: orca linear list-issues [--team <team>] [--cycle <cycle>] [--label <label>] [--limit <n>] [--query <text>] [--state <state>] [--cursor <cursor>] [--order-by createdAt|updatedAt] [--project <project>] [--release <release>] [--assignee <user|me|null>] [--delegate <user|me|null>] [--parent-id <issue|null>] [--priority <0-4>] [--created-at <datetime|duration>] [--updated-at <datetime|duration>] [--include-archived] [--workspace <id>|all] [--json]
|
|
|
|
List Linear issues with MCP-compatible filters and cursor pagination`
|
|
|
|
const LINEAR_SEARCH_HELP = `orca linear search
|
|
|
|
Usage: orca linear search <query> [--limit <n>] [--workspace <id>|all] [--json]
|
|
|
|
Search connected Linear workspaces
|
|
|
|
Options:
|
|
--help Show this help message
|
|
--json Emit machine-readable JSON
|
|
--pairing-code
|
|
--environment
|
|
--limit <n> Maximum number of rows to return
|
|
--workspace <id|all> Connected Linear workspace id, or all
|
|
--query <text> Text to search across Linear issues
|
|
|
|
Examples:
|
|
$ orca linear search "auth bug"
|
|
$ orca linear search ENG --workspace all --json`
|
|
|
|
const LINEAR_TEAM_LIST_HELP = `orca linear team list
|
|
|
|
Usage: orca linear team list [--workspace <id>|all] [--json]
|
|
|
|
List connected Linear teams`
|
|
|
|
const LINEAR_TEAM_MEMBERS_HELP = `orca linear team members
|
|
|
|
Usage: orca linear team members --team <key|id> [--workspace <id>] [--json]
|
|
|
|
List Linear team members`
|
|
|
|
const LINEAR_TEAM_STATES_HELP = `orca linear team states
|
|
|
|
Usage: orca linear team states --team <key|id> [--workspace <id>] [--json]
|
|
|
|
List Linear team workflow states`
|
|
|
|
const LINEAR_TEAM_LABELS_HELP = `orca linear team labels
|
|
|
|
Usage: orca linear team labels --team <key|id> [--workspace <id>] [--json]
|
|
|
|
List Linear team labels`
|
|
|
|
const LINEAR_PROJECT_LIST_HELP = `orca linear project list
|
|
|
|
Usage: orca linear project list [--query <text>] [--limit <n>] [--workspace <id>|all] [--json]
|
|
|
|
List connected Linear projects`
|
|
|
|
const LINEAR_LIST_HELP = `orca linear list
|
|
|
|
Usage: orca linear list [--filter assigned|created|all|completed|open] [--team <key|id>] [--limit <n>] [--workspace <id>|all] [--json]
|
|
|
|
List Linear issues`
|