@gh-symphony/cli 0.0.14 → 0.0.15

package/dist/index.js

@@ -1,383 +1,595 @@
 #!/usr/bin/env node
-import { realpathSync } from "node:fs";
-import { pathToFileURL } from "node:url";
-import { Command, CommanderError, InvalidArgumentError, Option, } from "commander";
-import { resolveConfigDir } from "./config.js";
-import { renderCompletionScript } from "./completion.js";
-const COMMANDS = {
-    init: () => import("./commands/init.js"),
-    start: () => import("./commands/start.js"),
-    stop: () => import("./commands/stop.js"),
-    status: () => import("./commands/status.js"),
-    run: () => import("./commands/run.js"),
-    recover: () => import("./commands/recover.js"),
-    logs: () => import("./commands/logs.js"),
-    project: () => import("./commands/project.js"),
-    repo: () => import("./commands/repo.js"),
-    config: () => import("./commands/config-cmd.js"),
-    version: () => import("./commands/version.js"),
+import {
+  resolveConfigDir
+} from "./chunk-ROGRTUFI.js";
+
+// src/index.ts
+import { realpathSync } from "fs";
+import { pathToFileURL } from "url";
+import {
+  Command,
+  CommanderError,
+  InvalidArgumentError,
+  Option
+} from "commander";
+
+// src/completion.ts
+var TOP_LEVEL_COMMANDS = [
+  "init",
+  "start",
+  "stop",
+  "status",
+  "run",
+  "recover",
+  "logs",
+  "project",
+  "repo",
+  "config",
+  "completion",
+  "help",
+  "version"
+];
+var GLOBAL_OPTIONS = [
+  "--config",
+  "--config-dir",
+  "--verbose",
+  "-v",
+  "--json",
+  "--no-color",
+  "--help",
+  "-h",
+  "--version",
+  "-V"
+];
+var GLOBAL_OPTIONS_WITH_VALUES = ["--config", "--config-dir"];
+var COMMAND_OPTIONS = {
+  completion: ["bash", "zsh", "fish"],
+  start: ["--project-id", "--project", "--daemon", "-d", ...GLOBAL_OPTIONS],
+  stop: ["--project-id", "--project", "--force", ...GLOBAL_OPTIONS],
+  status: ["--project-id", "--project", "--watch", "-w", ...GLOBAL_OPTIONS],
+  run: ["--project-id", "--project", "--watch", "-w", ...GLOBAL_OPTIONS],
+  recover: ["--project-id", "--project", "--dry-run", ...GLOBAL_OPTIONS],
+  logs: [
+    "--project-id",
+    "--project",
+    "--follow",
+    "-f",
+    "--issue",
+    "--run",
+    "--level",
+    ...GLOBAL_OPTIONS
+  ],
+  project: ["add", "list", "remove", "start", "stop", "switch", "status"],
+  "project:add": [
+    "--non-interactive",
+    "--project",
+    "--workspace-dir",
+    "--assigned-only",
+    ...GLOBAL_OPTIONS
+  ],
+  "project:list": [...GLOBAL_OPTIONS],
+  "project:remove": [...GLOBAL_OPTIONS],
+  "project:start": [
+    "--project-id",
+    "--project",
+    "--daemon",
+    "-d",
+    ...GLOBAL_OPTIONS
+  ],
+  "project:stop": ["--project-id", "--project", "--force", ...GLOBAL_OPTIONS],
+  "project:switch": [...GLOBAL_OPTIONS],
+  "project:status": [
+    "--project-id",
+    "--project",
+    "--watch",
+    "-w",
+    ...GLOBAL_OPTIONS
+  ],
+  repo: ["list", "add", "remove"],
+  "repo:list": [...GLOBAL_OPTIONS],
+  "repo:add": [...GLOBAL_OPTIONS],
+  "repo:remove": [...GLOBAL_OPTIONS],
+  config: ["show", "set", "edit"],
+  "config:show": [...GLOBAL_OPTIONS],
+  "config:set": [...GLOBAL_OPTIONS],
+  "config:edit": [...GLOBAL_OPTIONS]
+};
+function quoteWords(values) {
+  return values.join(" ");
+}
+function renderBashCasePatterns() {
+  return Object.entries(COMMAND_OPTIONS).map(([key, values]) => {
+    const [command, subcommand] = key.split(":");
+    if (!subcommand) {
+      if (command === "completion") {
+        return `    completion)
+      COMPREPLY=( $(compgen -W "${quoteWords(values)}" -- "$cur") )
+      return
+      ;;`;
+      }
+      if (command === "project" || command === "repo" || command === "config") {
+        return `    ${command})
+      COMPREPLY=( $(compgen -W "${quoteWords(values)}" -- "$cur") )
+      return
+      ;;`;
+      }
+      return `    ${command})
+      COMPREPLY=( $(compgen -W "${quoteWords(values)}" -- "$cur") )
+      return
+      ;;`;
+    }
+    return `    ${command}:${subcommand})
+      COMPREPLY=( $(compgen -W "${quoteWords(values)}" -- "$cur") )
+      return
+      ;;`;
+  }).join("\n");
+}
+function renderFishLines() {
+  const lines = GLOBAL_OPTIONS.map(
+    (option) => option.startsWith("--") ? `complete -c gh-symphony -f -l ${option.slice(2)}` : `complete -c gh-symphony -f -s ${option.slice(1)}`
+  );
+  for (const command of TOP_LEVEL_COMMANDS) {
+    lines.push(
+      `complete -c gh-symphony -f -n '__fish_use_subcommand' -a '${command}'`
+    );
+  }
+  for (const subcommand of COMMAND_OPTIONS.project ?? []) {
+    lines.push(
+      `complete -c gh-symphony -f -n '__fish_seen_subcommand_from project' -a '${subcommand}'`
+    );
+  }
+  for (const subcommand of COMMAND_OPTIONS.repo ?? []) {
+    lines.push(
+      `complete -c gh-symphony -f -n '__fish_seen_subcommand_from repo' -a '${subcommand}'`
+    );
+  }
+  for (const subcommand of COMMAND_OPTIONS.config ?? []) {
+    lines.push(
+      `complete -c gh-symphony -f -n '__fish_seen_subcommand_from config' -a '${subcommand}'`
+    );
+  }
+  for (const shell of COMMAND_OPTIONS.completion ?? []) {
+    lines.push(
+      `complete -c gh-symphony -f -n '__fish_seen_subcommand_from completion' -a '${shell}'`
+    );
+  }
+  return lines.join("\n");
+}
+function renderCompletionScript(shell) {
+  if (shell === "fish") {
+    return `${renderFishLines()}
+`;
+  }
+  const bashFunction = `# shellcheck shell=bash
+_gh_symphony_find_context() {
+  GH_SYMPHONY_COMMAND=""
+  GH_SYMPHONY_SUBCOMMAND=""
+
+  local idx=1
+  local token=""
+  local expects_value=0
+
+  while (( idx < COMP_CWORD )); do
+    token="\${COMP_WORDS[idx]}"
+
+    if (( expects_value )); then
+      expects_value=0
+      (( idx++ ))
+      continue
+    fi
+
+    case "\${token}" in
+      ${GLOBAL_OPTIONS_WITH_VALUES.map((option) => `${option}`).join("|")})
+        expects_value=1
+        ;;
+      ${GLOBAL_OPTIONS_WITH_VALUES.map((option) => `${option}=*`).join("|")})
+        ;;
+      ${GLOBAL_OPTIONS.filter((option) => !GLOBAL_OPTIONS_WITH_VALUES.includes(option)).join("|")})
+        ;;
+      -*)
+        ;;
+      *)
+        if [[ -z "\${GH_SYMPHONY_COMMAND}" ]]; then
+          GH_SYMPHONY_COMMAND="\${token}"
+        elif [[ -z "\${GH_SYMPHONY_SUBCOMMAND}" ]]; then
+          GH_SYMPHONY_SUBCOMMAND="\${token}"
+        fi
+        ;;
+    esac
+
+    (( idx++ ))
+  done
+}
+
+_gh_symphony_completion() {
+  local cur prev path
+  cur="\${COMP_WORDS[COMP_CWORD]}"
+  prev=""
+  if (( COMP_CWORD > 0 )); then
+    prev="\${COMP_WORDS[COMP_CWORD-1]}"
+  fi
+
+  _gh_symphony_find_context
+  path="\${GH_SYMPHONY_COMMAND}"
+
+  if [[ -z "\${path}" ]]; then
+    COMPREPLY=( $(compgen -W "${quoteWords(TOP_LEVEL_COMMANDS)} ${quoteWords(GLOBAL_OPTIONS)}" -- "$cur") )
+    return
+  fi
+
+  if [[ "\${path}" == "project" || "\${path}" == "repo" || "\${path}" == "config" || "\${path}" == "completion" ]]; then
+    if [[ -n "\${GH_SYMPHONY_SUBCOMMAND}" ]]; then
+      path="\${path}:\${GH_SYMPHONY_SUBCOMMAND}"
+    fi
+  fi
+
+  case "\${path}" in
+${renderBashCasePatterns()}
+  esac
+}
+`;
+  if (shell === "zsh") {
+    return `autoload -Uz compinit && compinit
+autoload -U +X bashcompinit && bashcompinit
+${bashFunction}complete -F _gh_symphony_completion gh-symphony
+`;
+  }
+  return `${bashFunction}complete -F _gh_symphony_completion gh-symphony
+`;
+}
+
+// src/index.ts
+var COMMANDS = {
+  init: () => import("./init-EZXQAXZM.js"),
+  start: () => import("./start-PIFQMIC2.js"),
+  stop: () => import("./stop-AA3AP5M6.js"),
+  status: () => import("./status-3WK5BWRZ.js"),
+  run: () => import("./run-DYINRZHK.js"),
+  recover: () => import("./recover-T6ME6C56.js"),
+  logs: () => import("./logs-6LNGT2GF.js"),
+  project: () => import("./project-3ELXQ35D.js"),
+  repo: () => import("./repo-R3XBIVAX.js"),
+  config: () => import("./config-cmd-AZ7POMAA.js"),
+  version: () => import("./version-VBB62JWI.js")
 };
 function addGlobalOptions(command) {
-    return command
-        .option("--config <dir>", "Config directory")
-        .addOption(new Option("--config-dir <dir>").hideHelp())
-        .option("-v, --verbose", "Enable verbose output")
-        .option("--json", "Output in JSON format")
-        .option("--no-color", "Disable color output");
+  return command.option("--config <dir>", "Config directory").addOption(new Option("--config-dir <dir>").hideHelp()).option("-v, --verbose", "Enable verbose output").option("--json", "Output in JSON format").option("--no-color", "Disable color output");
 }
 function resolveGlobalOptions(values) {
-    const configInput = typeof values.config === "string"
-        ? values.config
-        : typeof values.configDir === "string"
-            ? values.configDir
-            : undefined;
-    const options = {
-        configDir: resolveConfigDir(configInput),
-        verbose: Boolean(values.verbose),
-        json: Boolean(values.json),
-        noColor: Boolean(values.noColor),
-    };
-    if (options.noColor) {
-        process.env.NO_COLOR = "1";
-    }
-    return options;
+  const configInput = typeof values.config === "string" ? values.config : typeof values.configDir === "string" ? values.configDir : void 0;
+  const options = {
+    configDir: resolveConfigDir(configInput),
+    verbose: Boolean(values.verbose),
+    json: Boolean(values.json),
+    noColor: Boolean(values.noColor)
+  };
+  if (options.noColor) {
+    process.env.NO_COLOR = "1";
+  }
+  return options;
 }
 function resolveProjectId(values) {
-    return values.projectId ?? values.project;
+  return values.projectId ?? values.project;
 }
 function pushOption(args, flag, value) {
-    if (typeof value === "string" && value.length > 0) {
-        args.push(flag, value);
-        return;
-    }
-    if (value === true) {
-        args.push(flag);
-    }
+  if (typeof value === "string" && value.length > 0) {
+    args.push(flag, value);
+    return;
+  }
+  if (value === true) {
+    args.push(flag);
+  }
 }
 async function invokeHandler(key, args, values) {
-    const module = await COMMANDS[key]();
-    await module.default(args, resolveGlobalOptions(values));
+  const module = await COMMANDS[key]();
+  await module.default(args, resolveGlobalOptions(values));
 }
 function shellArgument(value) {
-    if (value === "bash" || value === "zsh" || value === "fish") {
-        return value;
-    }
-    throw new InvalidArgumentError("Shell must be one of: bash, zsh, fish");
+  if (value === "bash" || value === "zsh" || value === "fish") {
+    return value;
+  }
+  throw new InvalidArgumentError("Shell must be one of: bash, zsh, fish");
 }
 function hasVersionFlag(argv) {
-    return argv.some((arg) => arg === "--version" || arg === "-V");
+  return argv.some((arg) => arg === "--version" || arg === "-V");
 }
 function resolveVersionOptions(argv) {
-    const options = {
-        configDir: resolveConfigDir(),
-        verbose: argv.some((arg) => arg === "--verbose" || arg === "-v"),
-        json: argv.includes("--json"),
-        noColor: argv.includes("--no-color"),
-    };
-    if (options.noColor) {
-        process.env.NO_COLOR = "1";
-    }
-    return options;
+  const options = {
+    configDir: resolveConfigDir(),
+    verbose: argv.some((arg) => arg === "--verbose" || arg === "-v"),
+    json: argv.includes("--json"),
+    noColor: argv.includes("--no-color")
+  };
+  if (options.noColor) {
+    process.env.NO_COLOR = "1";
+  }
+  return options;
 }
 function createProgram() {
-    let actionInvoked = false;
-    const markInvoked = () => {
-        actionInvoked = true;
-    };
-    const program = addGlobalOptions(new Command()
-        .name("gh-symphony")
-        .description("AI Coding Agent Orchestrator")
-        .exitOverride()
-        .helpOption("-h, --help", "Show help")
-        .addHelpCommand("help [command]", "Show help for command")
-        .showHelpAfterError("(run with --help for usage)")
-        .option("-V, --version", "Show version"));
-    addGlobalOptions(program
-        .command("init")
-        .description("Interactive project setup wizard")
-        .allowExcessArguments(false)).action(async function () {
-        markInvoked();
-        await invokeHandler("init", [], this.optsWithGlobals());
-    });
-    addGlobalOptions(program
-        .command("start")
-        .description("Start the orchestrator")
-        .option("-d, --daemon", "Start in daemon mode")
-        .option("--log-level <level>", "Orchestrator lifecycle log level")
-        .option("--project-id <projectId>", "Project identifier")
-        .addOption(new Option("--project <projectId>").hideHelp())
-        .allowExcessArguments(false)).action(async function () {
-        markInvoked();
-        const values = this.optsWithGlobals();
-        const args = [];
-        pushOption(args, "--project-id", resolveProjectId(values));
-        pushOption(args, "--daemon", values.daemon);
-        pushOption(args, "--log-level", values.logLevel);
-        await invokeHandler("start", args, values);
-    });
-    addGlobalOptions(program
-        .command("stop")
-        .description("Stop the background orchestrator")
-        .option("--force", "Force stop with SIGKILL")
-        .option("--project-id <projectId>", "Project identifier")
-        .addOption(new Option("--project <projectId>").hideHelp())
-        .allowExcessArguments(false)).action(async function () {
-        markInvoked();
-        const values = this.optsWithGlobals();
-        const args = [];
-        pushOption(args, "--project-id", resolveProjectId(values));
-        pushOption(args, "--force", values.force);
-        await invokeHandler("stop", args, values);
-    });
-    addGlobalOptions(program
-        .command("status")
-        .description("Show orchestrator status")
-        .option("-w, --watch", "Watch status continuously")
-        .option("--project-id <projectId>", "Project identifier")
-        .addOption(new Option("--project <projectId>").hideHelp())
-        .allowExcessArguments(false)).action(async function () {
-        markInvoked();
-        const values = this.optsWithGlobals();
-        const args = [];
-        pushOption(args, "--project-id", resolveProjectId(values));
-        pushOption(args, "--watch", values.watch);
-        await invokeHandler("status", args, values);
-    });
-    addGlobalOptions(program
-        .command("run")
-        .description("Dispatch a single issue")
-        .argument("<issue>", "Issue identifier")
-        .option("--log-level <level>", "Orchestrator lifecycle log level")
-        .option("-w, --watch", "Watch status after dispatch")
-        .option("--project-id <projectId>", "Project identifier")
-        .addOption(new Option("--project <projectId>").hideHelp())
-        .allowExcessArguments(false)).action(async function (issue) {
-        markInvoked();
-        const values = this.optsWithGlobals();
-        const args = [issue];
-        pushOption(args, "--project-id", resolveProjectId(values));
-        pushOption(args, "--log-level", values.logLevel);
-        pushOption(args, "--watch", values.watch);
-        await invokeHandler("run", args, values);
-    });
-    addGlobalOptions(program
-        .command("recover")
-        .description("Recover stalled runs")
-        .option("--dry-run", "Show recoverable runs without recovering")
-        .option("--project-id <projectId>", "Project identifier")
-        .addOption(new Option("--project <projectId>").hideHelp())
-        .allowExcessArguments(false)).action(async function () {
-        markInvoked();
-        const values = this.optsWithGlobals();
-        const args = [];
-        pushOption(args, "--project-id", resolveProjectId(values));
-        pushOption(args, "--dry-run", values.dryRun);
-        await invokeHandler("recover", args, values);
-    });
-    addGlobalOptions(program
-        .command("logs")
-        .description("View orchestrator logs")
-        .option("-f, --follow", "Follow new log lines")
-        .option("--issue <issue>", "Filter by issue identifier")
-        .option("--run <runId>", "Read events for a specific run")
-        .option("--level <level>", "Filter by log level")
-        .option("--project-id <projectId>", "Project identifier")
-        .addOption(new Option("--project <projectId>").hideHelp())
-        .allowExcessArguments(false)).action(async function () {
-        markInvoked();
-        const values = this.optsWithGlobals();
-        const args = [];
-        pushOption(args, "--project-id", resolveProjectId(values));
-        pushOption(args, "--follow", values.follow);
-        pushOption(args, "--issue", values.issue);
-        pushOption(args, "--run", values.run);
-        pushOption(args, "--level", values.level);
-        await invokeHandler("logs", args, values);
-    });
-    const project = addGlobalOptions(program.command("project").description("Manage configured projects"));
-    project.action(async function () {
-        markInvoked();
-        await invokeHandler("project", [], this.optsWithGlobals());
-    });
-    addGlobalOptions(project
-        .command("add")
-        .description("Add a new project")
-        .option("--non-interactive", "Run without prompts")
-        .option("--project <id>", "GitHub Project ID")
-        .option("--workspace-dir <path>", "Workspace directory")
-        .option("--assigned-only", "Limit processing to assigned issues")
-        .allowExcessArguments(false)).action(async function () {
-        markInvoked();
-        const values = this.optsWithGlobals();
-        const args = [];
-        pushOption(args, "--non-interactive", values.nonInteractive);
-        pushOption(args, "--project", values.project);
-        pushOption(args, "--workspace-dir", values.workspaceDir);
-        pushOption(args, "--assigned-only", values.assignedOnly);
-        await invokeHandler("project", ["add", ...args], values);
-    });
-    addGlobalOptions(project.command("list").description("List configured projects")).action(async function () {
-        markInvoked();
-        const values = this.optsWithGlobals();
-        await invokeHandler("project", ["list"], values);
-    });
-    addGlobalOptions(project
-        .command("remove")
-        .description("Remove a project")
-        .argument("<projectId>", "Project identifier")
-        .allowExcessArguments(false)).action(async function (projectId) {
-        markInvoked();
-        await invokeHandler("project", ["remove", projectId], this.optsWithGlobals());
-    });
-    addGlobalOptions(project
-        .command("start")
-        .description("Start a specific project")
-        .option("-d, --daemon", "Start in daemon mode")
-        .option("--log-level <level>", "Orchestrator lifecycle log level")
-        .option("--project-id <projectId>", "Project identifier")
-        .addOption(new Option("--project <projectId>").hideHelp())
-        .allowExcessArguments(false)).action(async function () {
-        markInvoked();
-        const values = this.optsWithGlobals();
-        const args = ["start"];
-        pushOption(args, "--project-id", resolveProjectId(values));
-        pushOption(args, "--daemon", values.daemon);
-        pushOption(args, "--log-level", values.logLevel);
-        await invokeHandler("project", args, values);
-    });
-    addGlobalOptions(project
-        .command("stop")
-        .description("Stop a specific project")
-        .option("--force", "Force stop with SIGKILL")
-        .option("--project-id <projectId>", "Project identifier")
-        .addOption(new Option("--project <projectId>").hideHelp())
-        .allowExcessArguments(false)).action(async function () {
-        markInvoked();
-        const values = this.optsWithGlobals();
-        const args = ["stop"];
-        pushOption(args, "--project-id", resolveProjectId(values));
-        pushOption(args, "--force", values.force);
-        await invokeHandler("project", args, values);
-    });
-    addGlobalOptions(project.command("switch").description("Switch the active project")).action(async function () {
-        markInvoked();
-        await invokeHandler("project", ["switch"], this.optsWithGlobals());
-    });
-    addGlobalOptions(project
-        .command("status")
-        .description("Show status for a specific project")
-        .option("-w, --watch", "Watch status continuously")
-        .option("--project-id <projectId>", "Project identifier")
-        .addOption(new Option("--project <projectId>").hideHelp())
-        .allowExcessArguments(false)).action(async function () {
-        markInvoked();
-        const values = this.optsWithGlobals();
-        const args = ["status"];
-        pushOption(args, "--project-id", resolveProjectId(values));
-        pushOption(args, "--watch", values.watch);
-        await invokeHandler("project", args, values);
-    });
-    const repo = addGlobalOptions(program
-        .command("repo")
-        .description("Manage repositories in the active project"));
-    repo.action(async function () {
-        markInvoked();
-        await invokeHandler("repo", [], this.optsWithGlobals());
-    });
-    addGlobalOptions(repo.command("list").description("List repositories")).action(async function () {
-        markInvoked();
-        await invokeHandler("repo", ["list"], this.optsWithGlobals());
-    });
-    addGlobalOptions(repo
-        .command("add")
-        .description("Add a repository")
-        .argument("<owner/name>", "Repository spec")
-        .allowExcessArguments(false)).action(async function (repoSpec) {
-        markInvoked();
-        await invokeHandler("repo", ["add", repoSpec], this.optsWithGlobals());
-    });
-    addGlobalOptions(repo
-        .command("remove")
-        .description("Remove a repository")
-        .argument("<owner/name>", "Repository spec")
-        .allowExcessArguments(false)).action(async function (repoSpec) {
-        markInvoked();
-        await invokeHandler("repo", ["remove", repoSpec], this.optsWithGlobals());
-    });
-    const config = addGlobalOptions(program.command("config").description("Manage CLI configuration"));
-    config.action(async function () {
-        markInvoked();
-        await invokeHandler("config", [], this.optsWithGlobals());
-    });
-    addGlobalOptions(config.command("show").description("Show configuration")).action(async function () {
-        markInvoked();
-        await invokeHandler("config", ["show"], this.optsWithGlobals());
-    });
-    addGlobalOptions(config
-        .command("set")
-        .description("Set a configuration value")
-        .argument("<key>", "Configuration key")
-        .argument("<value>", "Configuration value")
-        .allowExcessArguments(false)).action(async function (key, value) {
-        markInvoked();
-        await invokeHandler("config", ["set", key, value], this.optsWithGlobals());
-    });
-    addGlobalOptions(config.command("edit").description("Open config in $EDITOR")).action(async function () {
-        markInvoked();
-        await invokeHandler("config", ["edit"], this.optsWithGlobals());
-    });
-    addGlobalOptions(program
-        .command("completion")
-        .description("Print shell completion script")
-        .argument("<shell>", "Shell name", shellArgument)
-        .allowExcessArguments(false)).action(async function (shell) {
-        markInvoked();
-        process.stdout.write(renderCompletionScript(shell));
-    });
-    program
-        .command("version")
-        .description("Show version")
-        .allowExcessArguments(false)
-        .action(async function () {
-        markInvoked();
-        await invokeHandler("version", [], this.optsWithGlobals());
-    });
-    return { program, wasInvoked: () => actionInvoked };
+  let actionInvoked = false;
+  const markInvoked = () => {
+    actionInvoked = true;
+  };
+  const program = addGlobalOptions(
+    new Command().name("gh-symphony").description("AI Coding Agent Orchestrator").exitOverride().helpOption("-h, --help", "Show help").addHelpCommand("help [command]", "Show help for command").showHelpAfterError("(run with --help for usage)").option("-V, --version", "Show version")
+  );
+  addGlobalOptions(
+    program.command("init").description("Interactive project setup wizard").allowExcessArguments(false)
+  ).action(async function() {
+    markInvoked();
+    await invokeHandler("init", [], this.optsWithGlobals());
+  });
+  addGlobalOptions(
+    program.command("start").description("Start the orchestrator").option("-d, --daemon", "Start in daemon mode").option("--http [port]", "Expose dashboard and refresh endpoints over HTTP").option("--log-level <level>", "Orchestrator lifecycle log level").option("--project-id <projectId>", "Project identifier").addOption(new Option("--project <projectId>").hideHelp()).allowExcessArguments(false)
+  ).action(async function() {
+    markInvoked();
+    const values = this.optsWithGlobals();
+    const args = [];
+    pushOption(args, "--project-id", resolveProjectId(values));
+    pushOption(args, "--daemon", values.daemon);
+    pushOption(args, "--http", values.http);
+    pushOption(args, "--log-level", values.logLevel);
+    await invokeHandler("start", args, values);
+  });
+  addGlobalOptions(
+    program.command("stop").description("Stop the background orchestrator").option("--force", "Force stop with SIGKILL").option("--project-id <projectId>", "Project identifier").addOption(new Option("--project <projectId>").hideHelp()).allowExcessArguments(false)
+  ).action(async function() {
+    markInvoked();
+    const values = this.optsWithGlobals();
+    const args = [];
+    pushOption(args, "--project-id", resolveProjectId(values));
+    pushOption(args, "--force", values.force);
+    await invokeHandler("stop", args, values);
+  });
+  addGlobalOptions(
+    program.command("status").description("Show orchestrator status").option("-w, --watch", "Watch status continuously").option("--project-id <projectId>", "Project identifier").addOption(new Option("--project <projectId>").hideHelp()).allowExcessArguments(false)
+  ).action(async function() {
+    markInvoked();
+    const values = this.optsWithGlobals();
+    const args = [];
+    pushOption(args, "--project-id", resolveProjectId(values));
+    pushOption(args, "--watch", values.watch);
+    await invokeHandler("status", args, values);
+  });
+  addGlobalOptions(
+    program.command("run").description("Dispatch a single issue").argument("<issue>", "Issue identifier").option("--log-level <level>", "Orchestrator lifecycle log level").option("-w, --watch", "Watch status after dispatch").option("--project-id <projectId>", "Project identifier").addOption(new Option("--project <projectId>").hideHelp()).allowExcessArguments(false)
+  ).action(async function(issue) {
+    markInvoked();
+    const values = this.optsWithGlobals();
+    const args = [issue];
+    pushOption(args, "--project-id", resolveProjectId(values));
+    pushOption(args, "--log-level", values.logLevel);
+    pushOption(args, "--watch", values.watch);
+    await invokeHandler("run", args, values);
+  });
+  addGlobalOptions(
+    program.command("recover").description("Recover stalled runs").option("--dry-run", "Show recoverable runs without recovering").option("--project-id <projectId>", "Project identifier").addOption(new Option("--project <projectId>").hideHelp()).allowExcessArguments(false)
+  ).action(async function() {
+    markInvoked();
+    const values = this.optsWithGlobals();
+    const args = [];
+    pushOption(args, "--project-id", resolveProjectId(values));
+    pushOption(args, "--dry-run", values.dryRun);
+    await invokeHandler("recover", args, values);
+  });
+  addGlobalOptions(
+    program.command("logs").description("View orchestrator logs").option("-f, --follow", "Follow new log lines").option("--issue <issue>", "Filter by issue identifier").option("--run <runId>", "Read events for a specific run").option("--level <level>", "Filter by log level").option("--project-id <projectId>", "Project identifier").addOption(new Option("--project <projectId>").hideHelp()).allowExcessArguments(false)
+  ).action(async function() {
+    markInvoked();
+    const values = this.optsWithGlobals();
+    const args = [];
+    pushOption(args, "--project-id", resolveProjectId(values));
+    pushOption(args, "--follow", values.follow);
+    pushOption(args, "--issue", values.issue);
+    pushOption(args, "--run", values.run);
+    pushOption(args, "--level", values.level);
+    await invokeHandler("logs", args, values);
+  });
+  const project = addGlobalOptions(
+    program.command("project").description("Manage configured projects")
+  );
+  project.action(async function() {
+    markInvoked();
+    await invokeHandler("project", [], this.optsWithGlobals());
+  });
+  addGlobalOptions(
+    project.command("add").description("Add a new project").option("--non-interactive", "Run without prompts").option("--project <id>", "GitHub Project ID").option("--workspace-dir <path>", "Workspace directory").option("--assigned-only", "Limit processing to assigned issues").allowExcessArguments(false)
+  ).action(async function() {
+    markInvoked();
+    const values = this.optsWithGlobals();
+    const args = [];
+    pushOption(args, "--non-interactive", values.nonInteractive);
+    pushOption(args, "--project", values.project);
+    pushOption(args, "--workspace-dir", values.workspaceDir);
+    pushOption(args, "--assigned-only", values.assignedOnly);
+    await invokeHandler("project", ["add", ...args], values);
+  });
+  addGlobalOptions(
+    project.command("list").description("List configured projects")
+  ).action(async function() {
+    markInvoked();
+    const values = this.optsWithGlobals();
+    await invokeHandler("project", ["list"], values);
+  });
+  addGlobalOptions(
+    project.command("remove").description("Remove a project").argument("<projectId>", "Project identifier").allowExcessArguments(false)
+  ).action(async function(projectId) {
+    markInvoked();
+    await invokeHandler(
+      "project",
+      ["remove", projectId],
+      this.optsWithGlobals()
+    );
+  });
+  addGlobalOptions(
+    project.command("start").description("Start a specific project").option("-d, --daemon", "Start in daemon mode").option("--http [port]", "Expose dashboard and refresh endpoints over HTTP").option("--log-level <level>", "Orchestrator lifecycle log level").option("--project-id <projectId>", "Project identifier").addOption(new Option("--project <projectId>").hideHelp()).allowExcessArguments(false)
+  ).action(async function() {
+    markInvoked();
+    const values = this.optsWithGlobals();
+    const args = ["start"];
+    pushOption(args, "--project-id", resolveProjectId(values));
+    pushOption(args, "--daemon", values.daemon);
+    pushOption(args, "--http", values.http);
+    pushOption(args, "--log-level", values.logLevel);
+    await invokeHandler("project", args, values);
+  });
+  addGlobalOptions(
+    project.command("stop").description("Stop a specific project").option("--force", "Force stop with SIGKILL").option("--project-id <projectId>", "Project identifier").addOption(new Option("--project <projectId>").hideHelp()).allowExcessArguments(false)
+  ).action(async function() {
+    markInvoked();
+    const values = this.optsWithGlobals();
+    const args = ["stop"];
+    pushOption(args, "--project-id", resolveProjectId(values));
+    pushOption(args, "--force", values.force);
+    await invokeHandler("project", args, values);
+  });
+  addGlobalOptions(
+    project.command("switch").description("Switch the active project")
+  ).action(async function() {
+    markInvoked();
+    await invokeHandler(
+      "project",
+      ["switch"],
+      this.optsWithGlobals()
+    );
+  });
+  addGlobalOptions(
+    project.command("status").description("Show status for a specific project").option("-w, --watch", "Watch status continuously").option("--project-id <projectId>", "Project identifier").addOption(new Option("--project <projectId>").hideHelp()).allowExcessArguments(false)
+  ).action(async function() {
+    markInvoked();
+    const values = this.optsWithGlobals();
+    const args = ["status"];
+    pushOption(args, "--project-id", resolveProjectId(values));
+    pushOption(args, "--watch", values.watch);
+    await invokeHandler("project", args, values);
+  });
+  const repo = addGlobalOptions(
+    program.command("repo").description("Manage repositories in the active project")
+  );
+  repo.action(async function() {
+    markInvoked();
+    await invokeHandler("repo", [], this.optsWithGlobals());
+  });
+  addGlobalOptions(
+    repo.command("list").description("List repositories")
+  ).action(async function() {
+    markInvoked();
+    await invokeHandler(
+      "repo",
+      ["list"],
+      this.optsWithGlobals()
+    );
+  });
+  addGlobalOptions(
+    repo.command("add").description("Add a repository").argument("<owner/name>", "Repository spec").allowExcessArguments(false)
+  ).action(async function(repoSpec) {
+    markInvoked();
+    await invokeHandler(
+      "repo",
+      ["add", repoSpec],
+      this.optsWithGlobals()
+    );
+  });
+  addGlobalOptions(
+    repo.command("remove").description("Remove a repository").argument("<owner/name>", "Repository spec").allowExcessArguments(false)
+  ).action(async function(repoSpec) {
+    markInvoked();
+    await invokeHandler(
+      "repo",
+      ["remove", repoSpec],
+      this.optsWithGlobals()
+    );
+  });
+  const config = addGlobalOptions(
+    program.command("config").description("Manage CLI configuration")
+  );
+  config.action(async function() {
+    markInvoked();
+    await invokeHandler("config", [], this.optsWithGlobals());
+  });
+  addGlobalOptions(
+    config.command("show").description("Show configuration")
+  ).action(async function() {
+    markInvoked();
+    await invokeHandler(
+      "config",
+      ["show"],
+      this.optsWithGlobals()
+    );
+  });
+  addGlobalOptions(
+    config.command("set").description("Set a configuration value").argument("<key>", "Configuration key").argument("<value>", "Configuration value").allowExcessArguments(false)
+  ).action(async function(key, value) {
+    markInvoked();
+    await invokeHandler(
+      "config",
+      ["set", key, value],
+      this.optsWithGlobals()
+    );
+  });
+  addGlobalOptions(
+    config.command("edit").description("Open config in $EDITOR")
+  ).action(async function() {
+    markInvoked();
+    await invokeHandler(
+      "config",
+      ["edit"],
+      this.optsWithGlobals()
+    );
+  });
+  addGlobalOptions(
+    program.command("completion").description("Print shell completion script").argument("<shell>", "Shell name", shellArgument).allowExcessArguments(false)
+  ).action(async function(shell) {
+    markInvoked();
+    process.stdout.write(renderCompletionScript(shell));
+  });
+  program.command("version").description("Show version").allowExcessArguments(false).action(async function() {
+    markInvoked();
+    await invokeHandler(
+      "version",
+      [],
+      this.optsWithGlobals()
+    );
+  });
+  return { program, wasInvoked: () => actionInvoked };
 }
-export async function runCli(argv) {
-    const { program, wasInvoked } = createProgram();
-    if (hasVersionFlag(argv)) {
-        const versionModule = await COMMANDS.version();
-        await versionModule.default([], resolveVersionOptions(argv));
-        return;
+async function runCli(argv) {
+  const { program, wasInvoked } = createProgram();
+  if (hasVersionFlag(argv)) {
+    const versionModule = await COMMANDS.version();
+    await versionModule.default([], resolveVersionOptions(argv));
+    return;
+  }
+  try {
+    await program.parseAsync(["node", "gh-symphony", ...argv], {
+      from: "node"
+    });
+    if (!wasInvoked()) {
+      program.outputHelp();
     }
-    try {
-        await program.parseAsync(["node", "gh-symphony", ...argv], {
-            from: "node",
-        });
-        if (!wasInvoked()) {
-            program.outputHelp();
-        }
+  } catch (error) {
+    if (error instanceof CommanderError && error.code === "commander.helpDisplayed") {
+      return;
     }
-    catch (error) {
-        if (error instanceof CommanderError &&
-            error.code === "commander.helpDisplayed") {
-            return;
-        }
-        if (error instanceof CommanderError) {
-            process.exitCode = error.exitCode;
-            return;
-        }
-        throw error;
+    if (error instanceof CommanderError) {
+      process.exitCode = error.exitCode;
+      return;
     }
+    throw error;
+  }
 }
 async function main() {
-    await runCli(process.argv.slice(2));
+  await runCli(process.argv.slice(2));
 }
-if (process.argv[1] &&
-    import.meta.url === pathToFileURL(realpathSync(process.argv[1])).href) {
-    main().catch((error) => {
-        process.stderr.write(`${error instanceof Error ? error.message : "Unknown error"}\n`);
-        process.exitCode = 1;
-    });
+if (process.argv[1] && import.meta.url === pathToFileURL(realpathSync(process.argv[1])).href) {
+  main().catch((error) => {
+    process.stderr.write(
+      `${error instanceof Error ? error.message : "Unknown error"}
+`
+    );
+    process.exitCode = 1;
+  });
 }
+export {
+  runCli
+};