{"record":{"id":"1933c9df772ac761","repo":"stablyai/orca","slug":"invalid-argument-1933c9","errorCode":"invalid_argument","errorMessage":"--priority must be between 0 and 4","messagePattern":"--priority must be between 0 and 4","errorType":"exception","errorClass":"RuntimeClientError","httpStatus":null,"severity":"error","filePath":"src/cli/handlers/linear-list-issues.ts","lineNumber":18,"sourceCode":"import type {\n  LinearMcpIssueListRequest,\n  LinearMcpIssueListResult\n} from '../../shared/linear-agent-access'\nimport type { CommandHandler } from '../dispatch'\nimport {\n  getOptionalNonNegativeIntegerFlag,\n  getOptionalPositiveIntegerFlag,\n  getOptionalStringFlag\n} from '../flags'\nimport { printResult } from '../format'\nimport { formatLinearMcpIssueList, printLinearMcpIssueListWarnings } from '../linear-format'\nimport { RuntimeClientError } from '../runtime-client'\n\nexport const runLinearListIssues: CommandHandler = async ({ flags, client, json }) => {\n  const priority = getOptionalNonNegativeIntegerFlag(flags, 'priority')\n  if (priority !== undefined && priority > 4) {\n    throw new RuntimeClientError('invalid_argument', '--priority must be between 0 and 4')\n  }\n  const request: LinearMcpIssueListRequest = {\n    team: getOptionalStringFlag(flags, 'team'),\n    cycle: getOptionalStringFlag(flags, 'cycle'),\n    label: getOptionalStringFlag(flags, 'label'),\n    limit: getOptionalPositiveIntegerFlag(flags, 'limit'),\n    query: getOptionalStringFlag(flags, 'query'),\n    state: getOptionalStringFlag(flags, 'state'),\n    cursor: getOptionalStringFlag(flags, 'cursor'),\n    orderBy: getOrderBy(flags),\n    project: getOptionalStringFlag(flags, 'project'),\n    release: getOptionalStringFlag(flags, 'release'),\n    assignee: getOptionalStringFlag(flags, 'assignee'),\n    delegate: getOptionalStringFlag(flags, 'delegate'),\n    parentId: getOptionalStringFlag(flags, 'parent-id'),\n    priority,\n    createdAt: getOptionalStringFlag(flags, 'created-at'),\n    updatedAt: getOptionalStringFlag(flags, 'updated-at'),","sourceCodeStart":1,"sourceCodeEnd":36,"githubUrl":"https://github.com/stablyai/orca/blob/1136503c6a231a16dce8f921f6fadb63d181e8db/src/cli/handlers/linear-list-issues.ts#L1-L36","documentation":"Thrown by the linear list-issues handler when --priority is provided and is a non-negative integer greater than 4. Priority is parsed via getOptionalNonNegativeIntegerFlag (which already rejects negatives and non-integers), then an upper-bound check rejects anything above 4. Linear priorities are 0 (lowest) through 4 (highest).","triggerScenarios":"Passing --priority 5, --priority 9, or any integer > 4. The check is `priority !== undefined && priority > 4` after the non-negative-integer parse.","commonSituations":"Assuming a 1-10 priority scale; treating higher numbers as valid because the non-negative parser accepted them; migrating from a system with a wider priority range.","solutions":["Use a priority value between 0 and 4 inclusive.","Map any higher-scale priority down to Linear's 0-4 range before passing it.","Omit --priority to list issues across all priorities."],"exampleFix":"// before\norca linear list-issues --priority 9\n// after\norca linear list-issues --priority 4","handlingStrategy":"validation","validationCode":"function priorityInRange(p: number | undefined): boolean {\n  return p === undefined || (Number.isInteger(p) && p >= 0 && p <= 4);\n}","typeGuard":"function isLinearPriority(value: unknown): value is number {\n  return typeof value === 'number' && Number.isInteger(value) && value >= 0 && value <= 4;\n}","tryCatchPattern":null,"preventionTips":["Remember Linear priorities run 0 (low) to 4 (high).","Omit --priority to list issues across all priorities."],"tags":["cli","linear","argument-validation","priority"],"backgroundTag":null,"analyzedSha":"1136503c6a231a16dce8f921f6fadb63d181e8db","analyzedAt":"2026-08-12T23:15:58.167Z","schemaVersion":2},"datasetVersion":"2026-08-12T23:17:12.415Z"}