Function registerTaskCommands

orchestrate/skills/orchestrate/scripts/cli/task.ts:49–476

(program: Command)

};

export function registerTaskCommands(program: Command): void {
  program
    .command("run")
    .argument(
      "<workspace>",
      "Path to the orchestrate workspace (contains plan.json)"
    )
    .option(
      "--root",
      "Mark this as the root workspace for the operator-facing re-run hint."
    )
    .option(
      "--slack-channel <id>",
      "Slack channel id for the root run. Falls back to SLACK_CHANNEL_ID."
    )
    .option(
      "--max-runtime-sec <number>",
      "Exit with code 100 after this many seconds when non-terminal work remains.",
      String(DEFAULT_MAX_RUNTIME_SEC)
    )
    .option(
      "--exit-on-all-done",
      "Keep draining to quiescence instead of returning on the first terminal error. Default is exit-on-error so the planner reacts to failures promptly (in-flight workers reattach on the next run)."
    )
    .description(
      "Run the reconcile loop: spawn pending tasks (respecting dependsOn), wait for handoffs, write them to <workspace>/handoffs/, repeat until terminal. Idempotent — rerun to pick up plan.json changes or retries."
    )
    .action(
      async (
        workspace: string,
        opts: {
          root?: boolean;
          slackChannel?: string;
          maxRuntimeSec: string;
          exitOnAllDone?: boolean;
        }
      ) => {
        const maxRuntimeSec = parsePositiveIntegerOrBail({
          value: opts.maxRuntimeSec,
          flag: "--max-runtime-sec",
        });
        const slackChannel = opts.root
          ? resolveWorkspaceSlackChannelOrBail({
              workspace,
              explicit: opts.slackChannel,
            })
          : undefined;
        const mgr = await loadOrBail(workspace, { slackChannel });
        const code = await runOrchestrateLoop(mgr, {
          maxRuntimeSec,
          rootMode: opts.root,
          exitOnError: !opts.exitOnAllDone,
        });
        process.exit(code);
      }
    );

  program