@gh-symphony/cli 0.4.6 → 0.4.9

package/dist/index.js

@@ -5,6 +5,13 @@ import {
   setNoColor,
   yellow
 } from "./chunk-MVRF7BES.js";
+import {
+  writeCliError
+} from "./chunk-MAJOIZ5Q.js";
+import {
+  formatErrorForTerminal,
+  hasVerboseFlag
+} from "./chunk-77H5ED5L.js";
 import {
   resolveConfigDir
 } from "./chunk-YZP5N5XP.js";
@@ -61,6 +68,7 @@ var COMMAND_OPTIONS = {
   setup: [
     "--non-interactive",
     "--output",
+    "--runtime",
     "--skip-skills",
     "--skip-context",
     ...GLOBAL_OPTIONS
@@ -351,7 +359,7 @@ var HELP_SECTIONS = [
       },
       {
         name: "--verbose, -v",
-        description: "Verbose output"
+        description: "Verbose output, including top-level error stack traces"
       },
       {
         name: "--json",
@@ -417,21 +425,25 @@ function createRemovedCommandHandler(message) {
 
 // src/index.ts
 var COMMANDS = {
-  workflow: () => import("./workflow-WG55ZIZ6.js"),
-  setup: () => import("./setup-IJMKV5YA.js"),
-  doctor: () => import("./doctor-YV5NV4HX.js"),
-  upgrade: () => import("./upgrade-TS42ZOSU.js"),
-  repo: () => import("./repo-LBNPFDDF.js"),
+  workflow: () => import("./workflow-J3APOEMI.js"),
+  setup: () => import("./setup-KBZ7PU2R.js"),
+  doctor: () => import("./doctor-U57B6LVZ.js"),
+  upgrade: () => import("./upgrade-FUZ2ZM72.js"),
+  repo: () => import("./repo-CKOHL2HD.js"),
   config: () => import("./config-cmd-OIVIUKG7.js"),
-  version: () => import("./version-QXB4FBVW.js")
+  version: () => import("./version-64B3R6RT.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 with stack traces").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 : void 0;
+  const configDirSource = configInput !== void 0 ? "cli" : typeof process.env.GH_SYMPHONY_CONFIG_DIR === "string" ? "env" : "default";
+  const hasConfigOverride = configDirSource === "cli" || hasExplicitConfigEnvOverride();
   const options = {
     configDir: resolveConfigDir(configInput),
+    configDirOverride: hasConfigOverride,
+    configDirSource,
     verbose: Boolean(values.verbose),
     json: Boolean(values.json),
     noColor: Boolean(values.noColor)
@@ -442,6 +454,13 @@ function resolveGlobalOptions(values) {
   setNoColor(options.noColor);
   return options;
 }
+function hasExplicitConfigEnvOverride() {
+  const envConfigDir = process.env.GH_SYMPHONY_CONFIG_DIR;
+  if (!envConfigDir) {
+    return false;
+  }
+  return envConfigDir !== "/var/lib/gh-symphony";
+}
 function resolveProjectId(values) {
   return values.projectId ?? values.project;
 }
@@ -470,6 +489,62 @@ function shellArgument(value) {
 function hasVersionFlag(argv) {
   return argv.some((arg) => arg === "--version" || arg === "-V");
 }
+function extractNamespaceCommand(argv) {
+  const positionals = [];
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i];
+    if (!arg) {
+      continue;
+    }
+    if (arg === "--config" || arg === "--config-dir") {
+      i += 1;
+      continue;
+    }
+    if (arg.startsWith("--config=") || arg.startsWith("--config-dir=")) {
+      continue;
+    }
+    if (arg === "--json" || arg === "--no-color" || arg === "--verbose" || arg === "-v") {
+      continue;
+    }
+    if (arg.startsWith("-")) {
+      continue;
+    }
+    positionals.push(arg);
+    if (positionals.length === 2) {
+      break;
+    }
+  }
+  return {
+    namespace: positionals[0],
+    subcommand: positionals[1]
+  };
+}
+function getChildCommandNames(command) {
+  return command.commands.map((child) => child.name());
+}
+function handleUnknownNamespaceCommand(argv, program) {
+  const { namespace, subcommand } = extractNamespaceCommand(argv);
+  if (!namespace || !subcommand) {
+    return false;
+  }
+  const namespaceCommand = program.commands.find(
+    (command) => command.name() === namespace
+  );
+  if (!namespaceCommand || !["repo", "workflow"].includes(namespace)) {
+    return false;
+  }
+  if (getChildCommandNames(namespaceCommand).includes(subcommand)) {
+    return false;
+  }
+  writeCliError({
+    code: "unknown_command",
+    message: `error: unknown command '${subcommand}' for '${namespace}'`,
+    usage: "(run with --help for usage)",
+    json: argv.includes("--json"),
+    exitCode: 1
+  });
+  return true;
+}
 function resolveVersionOptions(argv) {
   const options = {
     configDir: resolveConfigDir(),
@@ -514,7 +589,7 @@ function createProgram() {
     markInvoked
   );
   const workflow = addGlobalOptions(
-    program.command("workflow").description("Manage WORKFLOW.md authoring")
+    program.command("workflow").description("Manage WORKFLOW.md authoring").showHelpAfterError("(run with --help for usage)")
   );
   workflow.action(async function() {
     markInvoked();
@@ -567,13 +642,17 @@ function createProgram() {
     await invokeHandler("workflow", args, values);
   });
   addGlobalOptions(
-    program.command("setup").description("Run the one-command first-run setup flow").option("--non-interactive", "Run without prompts").option("--output <path>", "Write WORKFLOW.md to a custom path").option("--skip-skills", "Skip runtime skill generation").option("--skip-context", "Deprecated no-op").allowExcessArguments(false)
+    program.command("setup").description("Run the one-command first-run setup flow").option("--non-interactive", "Run without prompts").option("--output <path>", "Write WORKFLOW.md to a custom path").option(
+      "--runtime <kind>",
+      "Runtime preset: codex-app-server or claude-print"
+    ).option("--skip-skills", "Skip runtime skill generation").option("--skip-context", "Deprecated no-op").allowExcessArguments(false)
   ).action(async function() {
     markInvoked();
     const values = this.optsWithGlobals();
     const args = [];
     pushOption(args, "--non-interactive", values.nonInteractive);
     pushOption(args, "--output", values.output);
+    pushOption(args, "--runtime", values.runtime);
     pushOption(args, "--skip-skills", values.skipSkills);
     pushOption(args, "--skip-context", values.skipContext);
     await invokeHandler("setup", args, values);
@@ -651,23 +730,23 @@ function createProgram() {
     )([], resolveGlobalOptions(this.optsWithGlobals()));
   });
   const repo = addGlobalOptions(
-    program.command("repo").description("Manage the current repository runtime")
+    program.command("repo").description("Manage the current repository runtime").showHelpAfterError("(run with --help for usage)")
   );
   repo.action(async function() {
     markInvoked();
     await invokeHandler("repo", [], this.optsWithGlobals());
   });
-  addGlobalOptions(repo.command("list").description("Removed")).action(
-    async function() {
-      markInvoked();
-      await invokeRemovedCommand(
-        "Removed. Repository identity is shown by 'repo status'.",
-        this.optsWithGlobals()
-      );
-    }
-  );
   addGlobalOptions(
-    repo.command("add").description("Removed").argument("[owner/name]", "Repository spec").allowExcessArguments(false)
+    repo.command("list", { hidden: true }).description("Removed")
+  ).action(async function() {
+    markInvoked();
+    await invokeRemovedCommand(
+      "Removed. Repository identity is shown by 'repo status'.",
+      this.optsWithGlobals()
+    );
+  });
+  addGlobalOptions(
+    repo.command("add", { hidden: true }).description("Removed").argument("[owner/name]", "Repository spec").allowExcessArguments(false)
   ).action(async function() {
     markInvoked();
     await invokeRemovedCommand(
@@ -676,7 +755,7 @@ function createProgram() {
     );
   });
   addGlobalOptions(
-    repo.command("remove").description("Removed").argument("[owner/name]", "Repository spec").allowExcessArguments(false)
+    repo.command("remove", { hidden: true }).description("Removed").argument("[owner/name]", "Repository spec").allowExcessArguments(false)
   ).action(async function() {
     markInvoked();
     await invokeRemovedCommand(
@@ -685,7 +764,7 @@ function createProgram() {
     );
   });
   addGlobalOptions(
-    repo.command("sync").description("Removed").allowExcessArguments(false)
+    repo.command("sync", { hidden: true }).description("Removed").allowExcessArguments(false)
   ).action(async function() {
     markInvoked();
     await invokeRemovedCommand(
@@ -706,7 +785,7 @@ function createProgram() {
   addGlobalOptions(
     repo.command("start").description("Start the orchestrator for the current repository").option("-d, --daemon", "Start in daemon mode").option("--once", "Run a single orchestration tick and exit").option("--assigned-only", "Limit this run to assigned issues").option(
       "--http [port]",
-      "Expose dashboard and refresh endpoints over HTTP"
+      "Expose the JSON status API and refresh endpoints over HTTP"
     ).option(
       "--web [port]",
       "Expose the control plane web dashboard and API over HTTP"
@@ -742,11 +821,18 @@ function createProgram() {
     await invokeHandler("repo", args, values);
   });
   addGlobalOptions(
-    repo.command("run").description("Dispatch a single issue from the current repository").argument("[args...]", "Issue identifier and passthrough options").option("--log-level <level>", "Orchestrator lifecycle log level").option("-w, --watch", "Watch status after dispatch").allowUnknownOption(true).allowExcessArguments(true)
-  ).action(async function(passthrough) {
+    repo.command("run").description("Dispatch a single issue from the current repository").usage("[options] <issue>").argument("[issue]", "Issue identifier (owner/repo#number)").option("--log-level <level>", "Orchestrator lifecycle log level").option("-w, --watch", "Watch status after dispatch").allowUnknownOption(true).allowExcessArguments(true).addHelpText(
+      "after",
+      "\nExamples:\n  $ gh-symphony repo run owner/repo#123\n"
+    )
+  ).action(async function(issue) {
     markInvoked();
     const values = this.optsWithGlobals();
-    const args = ["run", ...passthrough];
+    const args = ["run"];
+    if (issue) {
+      args.push(issue);
+    }
+    args.push(...this.args.slice(issue ? 1 : 0));
     pushOption(args, "--log-level", values.logLevel);
     pushOption(args, "--watch", values.watch);
     await invokeHandler("repo", args, values);
@@ -773,11 +859,18 @@ function createProgram() {
     await invokeHandler("repo", args, values);
   });
   addGlobalOptions(
-    repo.command("explain").description("Explain why a repository issue is not dispatching").argument("[args...]", "Issue identifier and passthrough options").option("--workflow <path>", "Path to the WORKFLOW.md file to evaluate").allowUnknownOption(true).allowExcessArguments(true)
-  ).action(async function(passthrough) {
+    repo.command("explain").description("Explain why a repository issue is not dispatching").usage("[options] <issue>").argument("[issue]", "Issue identifier (owner/repo#number)").option("--workflow <path>", "Path to the WORKFLOW.md file to evaluate").allowUnknownOption(true).allowExcessArguments(true).addHelpText(
+      "after",
+      "\nExamples:\n  $ gh-symphony repo explain owner/repo#123\n"
+    )
+  ).action(async function(issue) {
     markInvoked();
     const values = this.optsWithGlobals();
-    const args = ["explain", ...passthrough];
+    const args = ["explain"];
+    if (issue) {
+      args.push(issue);
+    }
+    args.push(...this.args.slice(issue ? 1 : 0));
     pushOption(args, "--workflow", values.workflow);
     await invokeHandler("repo", args, values);
   });
@@ -841,6 +934,9 @@ async function runCli(argv) {
     await versionModule.default([], resolveVersionOptions(argv));
     return;
   }
+  if (handleUnknownNamespaceCommand(argv, program)) {
+    return;
+  }
   try {
     await program.parseAsync(["node", "gh-symphony", ...argv], {
       from: "node"
@@ -865,12 +961,14 @@ async function main() {
 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"}
-`
+      formatErrorForTerminal(error, {
+        verbose: hasVerboseFlag(process.argv.slice(2))
+      })
     );
     process.exitCode = 1;
   });
 }
 export {
+  resolveGlobalOptions,
   runCli
 };