{"record":{"id":"96a2add2193c4abf","repo":"stablyai/orca","slug":"orchestration-migration-required","errorCode":"orchestration_migration_required","errorMessage":"The legacy automatic coordinator command is retired. No effects were applied.","messagePattern":"The legacy automatic coordinator command is retired\\. No effects were applied\\.","errorType":"exception","errorClass":"RuntimeClientError","httpStatus":null,"severity":"error","filePath":"src/cli/handlers/orchestration.ts","lineNumber":1208,"sourceCode":"    }>('orchestration.dispatchShow', {\n      task: getRequiredStringFlag(flags, 'task'),\n      preamble: showPreamble,\n      from,\n      devMode: isDevCliInvocation()\n    })\n    printResult(result, json, (r) => {\n      if (r.preamble && showPreamble) {\n        return r.preamble\n      }\n      if (!r.dispatch) {\n        return 'No dispatch context found.'\n      }\n      return `${r.dispatch.id} task=${r.dispatch.task_id} [${r.dispatch.status}]`\n    })\n  },\n\n  'orchestration coordinator-start': async () => {\n    throw new RuntimeClientError(\n      'orchestration_migration_required',\n      'The legacy automatic coordinator command is retired. No effects were applied.',\n      orchestrationMigrationData('command_retired')\n    )\n  },\n\n  'orchestration coordinator-stop': async () => {\n    throw new RuntimeClientError(\n      'orchestration_migration_required',\n      'The legacy automatic coordinator command is retired. No effects were applied.',\n      orchestrationMigrationData('command_retired')\n    )\n  },\n\n  'orchestration gate-create': async ({ flags, client, cwd, json }) => {\n    const result = await callMutation<{\n      gate: { id: string; task_id: string; status: string }\n    }>(client, flags, 'orchestration.gateCreate', {","sourceCodeStart":1190,"sourceCodeEnd":1226,"githubUrl":"https://github.com/stablyai/orca/blob/1136503c6a231a16dce8f921f6fadb63d181e8db/src/cli/handlers/orchestration.ts#L1190-L1226","documentation":"Thrown unconditionally by the 'orchestration coordinator-start' handler (lines 1207-1213). The command is retired: the legacy automatic coordinator has been replaced by the Run/Dispatch/task model, so invoking it always errors with orchestration_migration_required and no effects are applied. The error carries structured migration data (orchestrationMigrationData('command_retired')) pointing the user to the orchestration skill and the required contract version.","triggerScenarios":"Calling 'orchestration coordinator-start' under any circumstances — the handler body is a single throw with no conditions. It is reached whenever the CLI routes to this verb.","commonSituations":"Old scripts, docs, or muscle memory invoking the retired coordinator command after an Orca upgrade; automation that has not migrated to the Run-based model.","solutions":["Stop using 'orchestration coordinator-start'; it is permanently retired.","Migrate to the Run model: use 'orchestration run-create' / 'run-use' and 'task-create' / 'dispatch' instead.","Run 'skills get orchestration --full' (the nextSteps in the error data) for the migration guide."],"exampleFix":"// before\norca orchestration coordinator-start\n// after\norca orchestration run-create --objective \"coordinate feature X\"","handlingStrategy":"fallback","validationCode":"// The command is unconditionally retired; detect and reroute before calling.\nconst RETIRED = ['orchestration coordinator-start', 'orchestration coordinator-stop']\nif (RETIRED.includes(command)) {\n  // reroute to run-create / task-create / dispatch instead of invoking the CLI\n}","typeGuard":"function isRetiredCoordinatorCommand(cmd: string): boolean {\n  return cmd === 'orchestration coordinator-start' || cmd === 'orchestration coordinator-stop'\n}","tryCatchPattern":"try {\n  await runCli('orchestration coordinator-start')\n} catch (err) {\n  if (err instanceof RuntimeClientError && err.code === 'orchestration_migration_required') {\n    // migrate the caller to run-create/task-create/dispatch; do not retry the retired command\n  } else { throw err }\n}","preventionTips":["Remove coordinator-start/stop from all scripts and docs.","Migrate automation to the Run/Dispatch/task model.","Run 'skills get orchestration --full' for the official migration guide."],"tags":["cli","orchestration","deprecated","migration","coordinator"],"backgroundTag":null,"analyzedSha":"1136503c6a231a16dce8f921f6fadb63d181e8db","analyzedAt":"2026-08-12T23:15:58.167Z","schemaVersion":2},"datasetVersion":"2026-08-12T23:17:12.415Z"}