Function registerAndonCommands

orchestrate/skills/orchestrate/scripts/cli/andon.ts:19–119

(program: Command)

 * reasons back out of history.
 */
export function registerAndonCommands(program: Command): void {
  const andonProgram = program
    .command("andon")
    .description("Raise or clear the tree-wide Andon spawn pause.");

  andonProgram
    .command("raise")
    .requiredOption(
      "--reason <text>",
      "Posted to the run thread so the tree sees why orchestration paused."
    )
    .option(
      "--workspace <path>",
      "Workspace containing plan.json with slackKickoffRef"
    )
    .option(
      "--sender <name>",
      "Label for the reason message (defaults to $USER, else 'operator')",
      defaultSender()
    )
    .option(
      "--agent-id <id>",
      "Cloud agent id for the footer link back to cursor.com (omit for operator-issued raises)."
    )
    .description(
      "Post the reason in the run thread and add :rotating_light: to the kickoff message."
    )
    .action(
      async (opts: {
        reason: string;
        workspace?: string;
        sender: string;
        agentId?: string;
      }) => {
        try {
          const { slack, ref } = loadAndonTargetOrBail(opts);
          const head = `${ANDON_RAISED_PREFIX} by ${opts.sender}: ${opts.reason}`;
          await slack.postCommentInThread({
            threadTs: ref.ts,
            text: appendAgentFooter(head, opts.agentId),
            username: "orchestrate",
          });
          await slack.addReaction({ ...ref, name: "rotating_light" });
        } catch (err) {
          console.error(`andon raise failed: ${errorMessage(err)}`);
          process.exit(1);
        }
      }
    );

  andonProgram
    .command("clear")
    .option(
      "--workspace <path>",
      "Workspace containing plan.json with slackKickoffRef"
    )
    .option(
      "--note <text>",