issue-flow 0.11.1 → 0.13.0

package/dist/cli.js

@@ -1,17 +1,36 @@
 #!/usr/bin/env node
 import {
+  DEFAULT_INACTIVITY_TIMEOUT_MS,
+  installShutdownHandlers,
+  parseAgentPhaseFlag,
+  setAgentCliOverrides,
   setIssuesCliOverrides,
+  setResilienceCliOverrides,
+  setRoutingCliOverrides,
+  setVerifyCliOverrides,
   setWebCliOverrides
-} from "./chunk-VQ5VN7DF.js";
+} from "./chunk-CNBYCMSU.js";
+import "./chunk-HQAHNIAR.js";
 import {
   printError,
   setGlobalTimeout,
+  setInactivityTimeout,
   setVerbose
-} from "./chunk-HC2MT7BX.js";
+} from "./chunk-IYV6KNVF.js";
+import "./chunk-6FDFRNXZ.js";
+import "./chunk-P3LRUNC6.js";
+import "./chunk-DIG5XKQQ.js";
+import {
+  isAgentProviderId
+} from "./chunk-NEZZ6KDR.js";
+import "./chunk-TX5WIVYP.js";
+import "./chunk-KQHB7ZT3.js";
+import "./chunk-7Z4Y3VKM.js";
+import "./chunk-XEYH6ZZI.js";
 
 // src/cli.ts
 import { createRequire } from "module";
-import { Command, InvalidArgumentError } from "commander";
+import { Command, InvalidArgumentError, Option } from "commander";
 
 // src/cli-options.ts
 function resolveNoBranch(options) {
@@ -29,9 +48,15 @@ function resolveQueueScopeFlags(options) {
       "--yes cannot be combined with --only: --yes runs the whole discovered hierarchy, --only runs just the issues you informed."
     );
   }
+  if (options.cascade === true && options.only === true) {
+    throw new CliFlagError(
+      "--cascade cannot be combined with --only: --cascade runs the container hierarchy, --only runs just the issues you informed."
+    );
+  }
   return {
     yes: options.yes === true ? true : void 0,
-    only: options.only === true ? true : void 0
+    only: options.only === true ? true : void 0,
+    cascade: options.cascade === true ? true : void 0
   };
 }
 function resolveRunPhaseFlags(options) {
@@ -107,6 +132,37 @@ function resolveGenerateTarget(opts) {
   return selected[0];
 }
 
+// src/resilience/cli-flags.ts
+function continuousProfile() {
+  return {
+    profile: "continuous",
+    providers: { failover: true },
+    queue: { onIssueFailure: "skip" },
+    journal: { enabled: true },
+    watchdog: { inactivityTimeoutMs: DEFAULT_INACTIVITY_TIMEOUT_MS }
+  };
+}
+function resolveResilienceOverrides(flags) {
+  const continuous = flags.continuous === true || flags.resilient === true;
+  const overrides = continuous ? continuousProfile() : {};
+  if (flags.failover === false) {
+    overrides.providers = { ...overrides.providers, failover: false };
+  }
+  if (flags.autoDecompose === true) {
+    overrides.decompose = { ...overrides.decompose, auto: true };
+  }
+  if (flags.inactivityTimeout !== void 0) {
+    overrides.watchdog = {
+      ...overrides.watchdog,
+      inactivityTimeoutMs: flags.inactivityTimeout * 1e3
+    };
+  }
+  if (flags.onIssueFailure !== void 0) {
+    overrides.queue = { ...overrides.queue, onIssueFailure: flags.onIssueFailure };
+  }
+  return overrides;
+}
+
 // src/cli.ts
 var require2 = createRequire(import.meta.url);
 var { version } = require2("../package.json");
@@ -117,6 +173,20 @@ function parseInteger(value) {
   }
   return parsed;
 }
+function parseUsd(value) {
+  const parsed = Number.parseFloat(value);
+  if (!Number.isFinite(parsed) || parsed < 0) {
+    throw new InvalidArgumentError("Must be a non-negative number.");
+  }
+  return parsed;
+}
+function collectString(value, previous) {
+  return [...previous, value];
+}
+function parseQueueFailureMode(value) {
+  if (value === "stop" || value === "skip" || value === "block") return value;
+  throw new InvalidArgumentError("Must be one of: stop, skip, block.");
+}
 function parseStartUs(value) {
   const parsed = parseInteger(value);
   if (parsed < 1) {
@@ -132,11 +202,78 @@ function withUserStoryNumberingOptions(cmd) {
   );
 }
 function withGlobalOptions(cmd) {
-  return cmd.option("-v, --verbose", "Show Claude progress output in real time").option(
+  return cmd.option("-v, --verbose", "Show agent progress output in real time").option(
     "-t, --timeout <seconds>",
     "Override headless timeout in seconds (0 = no limit)",
     parseInteger
-  );
+  ).option(
+    "--inactivity-timeout <seconds>",
+    "Stop the agent after this many seconds with no output (0 = no watchdog)",
+    parseInteger
+  ).option(
+    "--agent <provider>",
+    "Run every phase on this agent (claude|codex|cursor|antigravity)"
+  ).option("--agent-model <model>", "Override the model for every phase").option(
+    "--agent-phase <phase>=<provider>[:<model>]",
+    "Override one phase (repeatable)",
+    collectAgentPhase,
+    {}
+  ).option("--verify-level <level>", "Acceptance-contract level: L0 | L1 | L2 | L3 | L5").option("--no-cross-verify", "Keep L2 off even when a trigger would fire").option("--no-escalation", "Keep routing.escalation.enabled off").option("--max-cost <usd>", "Issue cost ceiling in USD (Issue Flow enforces it)", parseUsd).option("--max-duration <seconds>", "Issue duration ceiling in seconds", parseInteger);
+}
+function collectAgentPhase(value, previous) {
+  const parsed = parseAgentPhaseFlag(value);
+  return { ...previous, [parsed.phase]: parsed.block };
+}
+function resolveAgentOverrides(opts) {
+  const overrides = {};
+  if (typeof opts.agent === "string") {
+    if (!isAgentProviderId(opts.agent)) {
+      throw new InvalidArgumentError("Must be one of: claude, codex, cursor, antigravity.");
+    }
+    overrides.forceProvider = opts.agent;
+  }
+  if (typeof opts.agentModel === "string") {
+    overrides.forceModel = opts.agentModel;
+  }
+  if (opts.agentPhase && typeof opts.agentPhase === "object") {
+    overrides.phases = opts.agentPhase;
+  }
+  return overrides;
+}
+var VERIFY_LEVELS = ["L0", "L1", "L2", "L3", "L5"];
+function resolveVerifyOverrides(opts) {
+  const overrides = {};
+  if (typeof opts.verifyLevel === "string") {
+    if (!VERIFY_LEVELS.includes(opts.verifyLevel)) {
+      throw new InvalidArgumentError("Must be one of: L0, L1, L2, L3, L5.");
+    }
+    overrides.level = opts.verifyLevel;
+  }
+  if (opts.crossVerify === false) overrides.crossVerify = false;
+  return overrides;
+}
+function resolveRoutingOverrides(opts) {
+  const overrides = {};
+  if (opts.escalation === false) {
+    overrides.escalation = {
+      enabled: false,
+      minAttemptsBeforeEscalation: 2,
+      maxEscalations: 2,
+      maxRungs: ["effort", "model", "harness"]
+    };
+  }
+  if (typeof opts.maxCost === "number" || typeof opts.maxDuration === "number") {
+    overrides.ceilings = {
+      maxCostUsdPerIssue: typeof opts.maxCost === "number" ? opts.maxCost : null,
+      maxDurationMsPerIssue: typeof opts.maxDuration === "number" ? opts.maxDuration * 1e3 : null,
+      maxExecutionsPerIssue: null,
+      onCeiling: "block"
+    };
+  }
+  return overrides;
+}
+function withResilienceOptions(cmd) {
+  return cmd.option("--continuous", "Long-running profile: keep going without supervision").option("--resilient", "Alias of --continuous").option("--no-failover", "Never migrate a phase to another agent provider").option("--auto-decompose", "Act on a decomposition report instead of only writing it");
 }
 function withWebOptions(cmd) {
   return cmd.option("--web", "Enable the web monitoring server").option("--serve", "Alias for --web").option("--port <n>", "Web server port (default: 3737)", parseInteger).option("--host <h>", "Web server host (default: 0.0.0.0)").option("--refresh <s>", "Suggested UI polling interval in seconds", parseInteger).option("--web-log-limit <n>", "Max log entries kept in the snapshot", parseInteger).option("--web-no-logs", "Exclude logs from the published snapshot");
@@ -168,9 +305,10 @@ function resolveWebOverrides(opts) {
 }
 var program = new Command();
 program.name("issue-flow").description(
-  "Unified CLI for orchestrating the full issue-flow pipeline via Claude Code Headless."
+  "Unified CLI for orchestrating the full issue-flow pipeline via Claude Code, Codex CLI, Cursor CLI or Antigravity CLI."
 ).version(version);
 program.hook("preAction", (_thisCommand, actionCommand) => {
+  installShutdownHandlers();
   const opts = actionCommand.opts();
   if (opts.verbose) {
     setVerbose(true);
@@ -178,7 +316,31 @@ program.hook("preAction", (_thisCommand, actionCommand) => {
   if (opts.timeout !== void 0) {
     setGlobalTimeout(opts.timeout * 1e3);
   }
+  if (opts.inactivityTimeout !== void 0) {
+    setInactivityTimeout(opts.inactivityTimeout * 1e3);
+  }
   setWebCliOverrides(resolveWebOverrides(opts));
+  try {
+    setVerifyCliOverrides(resolveVerifyOverrides(opts));
+    setAgentCliOverrides(resolveAgentOverrides(opts));
+    setRoutingCliOverrides(resolveRoutingOverrides(opts));
+  } catch (error) {
+    if (error instanceof InvalidArgumentError) {
+      printError(error.message);
+      process.exit(1);
+    }
+    throw error;
+  }
+  setResilienceCliOverrides(
+    resolveResilienceOverrides({
+      continuous: opts.continuous,
+      resilient: opts.resilient,
+      failover: opts.failover,
+      autoDecompose: opts.autoDecompose,
+      inactivityTimeout: opts.inactivityTimeout,
+      onIssueFailure: opts.onIssueFailure
+    })
+  );
   try {
     setIssuesCliOverrides(resolveIssuesOverrides(opts));
   } catch (error) {
@@ -193,19 +355,22 @@ withIssueOptions(
   withGlobalOptions(
     program.command("init").description(
       "Check prerequisites and report (or create) the conventions this repository is missing"
-    ).option("--apply", "Create the missing files instead of only reporting them").option("--json", "Emit the plan as JSON").option("--scope <dir>", "Resolve the conventions for a subdirectory (monorepo)").option("--check-only", "Only verify prerequisites, as earlier releases did")
+    ).option("--apply", "Create the missing files instead of only reporting them").option("--json", "Emit the plan as JSON").option("--scope <dir>", "Resolve the conventions for a subdirectory (monorepo)").option("--check-only", "Only verify prerequisites, as earlier releases did").option("--no-agent-prompt", "Skip the first-run agent choice")
   )
 ).action(
   async (options) => {
-    const { loadIssuesConfig } = await import("./config-4THHOXNN.js");
-    const { runInit } = await import("./init-PRMOTQ7N.js");
+    const { loadIssuesConfig } = await import("./config-MEM2IWWN.js");
+    const { runInit } = await import("./init-OKWEC3EV.js");
     const { preferredProvider } = await loadIssuesConfig();
-    const code = await runInit(preferredProvider, options);
+    const code = await runInit(preferredProvider, {
+      ...options,
+      noAgentPrompt: options.agentPrompt === false
+    });
     process.exit(code);
   }
 );
 withGlobalOptions(
-  program.command("generate").description("Draft an issue via Claude Code Headless and create it").requiredOption("--prompt <text>", "Issue description text").option("--github", "Create the issue on GitHub").option("--local", "Create the issue under issues/<n>/ only").option("--both", "Create the issue on GitHub and mirror it locally")
+  program.command("generate").description("Draft an issue with the configured agent and create it").requiredOption("--prompt <text>", "Issue description text").option("--github", "Create the issue on GitHub").option("--local", "Create the issue under issues/<n>/ only").option("--both", "Create the issue on GitHub and mirror it locally")
 ).action(async (options) => {
   let target;
   try {
@@ -217,20 +382,30 @@ withGlobalOptions(
     }
     throw error;
   }
-  const { runGenerate } = await import("./generate-TBVTLMOP.js");
+  const { runGenerate } = await import("./generate-MVQI7A45.js");
   const code = await runGenerate(options.prompt, target);
   process.exit(code);
 });
 withUserStoryNumberingOptions(
-  withWebOptions(
-    withIssueOptions(
-      withGlobalOptions(
-        program.command("run").description(
-          "Execute the full pipeline: prd \u2192 plan \u2192 execute \u2192 review \u2192 pr (\u2192 pr-review, optional)"
-        ).argument("<issues...>", 'Issue number(s): 42, "42,43" or 42 43').option("--mode <mode>", "Execution mode: auto | manual", "auto").option("--from <phase>", "Resume from a specific phase").option(
-          "--no-branch",
-          "Run pipeline on current branch without creating a new branch or PR"
-        ).option("--pr-review", "Review the created Pull Request after the pr phase").option("-y, --yes", "Run the whole discovered hierarchy without confirmation").option("--only", "Run just the issues informed, without their hierarchy")
+  withResilienceOptions(
+    withWebOptions(
+      withIssueOptions(
+        withGlobalOptions(
+          program.command("run").description(
+            "Execute the full pipeline: prd \u2192 plan \u2192 execute \u2192 review \u2192 pr (\u2192 pr-review, optional)"
+          ).argument("<issues...>", 'Issue number(s): 42, "42,43" or 42 43').option("--mode <mode>", "Execution mode: auto | manual", "auto").option("--from <phase>", "Resume from a specific phase").option(
+            "--no-branch",
+            "Run pipeline on current branch without creating a new branch or PR"
+          ).option("--pr-review", "Review the created Pull Request after the pr phase").option("-y, --yes", "Run the whole discovered hierarchy without confirmation").option("--cascade", "Run the children of a container, without implementing it").option("--only", "Run just the issues informed, without their hierarchy").option(
+            "--retry-limit <number>",
+            "Retry transient Claude failures up to N consecutive times",
+            parseInteger
+          ).option("--retry-forever", "Retry transient Claude failures indefinitely").option(
+            "--on-issue-failure <mode>",
+            "In a queue, on a failing issue: stop | skip | block",
+            parseQueueFailureMode
+          ).option("-d, --background", "Detach after confirmation and return the terminal").addOption(new Option("--detached-child").hideHelp())
+        )
       )
     )
   )
@@ -250,7 +425,7 @@ withUserStoryNumberingOptions(
       }
       throw error;
     }
-    const { runPipeline } = await import("./run-DBF2VWUN.js");
+    const { runPipeline } = await import("./run-YU4TR62R.js");
     const code = await runPipeline(
       issues,
       options.mode,
@@ -260,8 +435,14 @@ withUserStoryNumberingOptions(
       {
         yes: scope.yes,
         only: scope.only,
+        cascade: scope.cascade,
         continueNumbering: numbering.continueFlag,
-        startUs: numbering.startUs
+        startUs: numbering.startUs,
+        retryLimit: options.retryLimit,
+        retryForever: options.retryForever,
+        onIssueFailure: options.onIssueFailure,
+        background: options.background,
+        detachedChild: options.detachedChild
       }
     );
     process.exit(code);
@@ -269,26 +450,104 @@ withUserStoryNumberingOptions(
 );
 withIssueOptions(
   withGlobalOptions(
-    program.command("analyze").description("Analyze an issue via Claude Code Headless").argument("<issue>", "Issue number")
+    program.command("resume").description("Resume an interrupted pipeline from the phase it stopped at").argument("[issue]", "Issue to resume. Omitted: the most recently attempted one").option("--all", "Resume every unfinished issue of this project, in order").option("--mode <mode>", "Execution mode: auto | manual", "auto")
+  )
+).action(async (issue, options) => {
+  const { runResume } = await import("./resume-QMEPMSZW.js");
+  const code = await runResume(issue, {
+    ...options.all === void 0 ? {} : { all: options.all },
+    ...options.mode === void 0 ? {} : { mode: options.mode }
+  });
+  process.exit(code);
+});
+withGlobalOptions(
+  program.command("status").description("What is running right now, in which phase, and since when").argument("[issue]", "Restrict the report to one issue").option("--json", "Emit the assembled state as JSON")
+).action(async (issue, options) => {
+  const { runStatus } = await import("./operations-LU6JA3BX.js");
+  process.exit(
+    await runStatus(issue, { ...options.json === void 0 ? {} : { json: options.json } })
+  );
+});
+withGlobalOptions(
+  program.command("usage").description("Aggregate execution telemetry from tasks.json").argument("[issue]", "Restrict the report to one issue").option("--issue <issue>", "Same as the positional argument").option("--since <date>", "Only executions started on or after this ISO date").option("--by <key>", "Group by harness, provider, model, purpose or status").option("--json", "Emit the assembled totals as JSON")
+).action(
+  async (issue, options) => {
+    const { runUsage, USAGE_GROUP_KEYS } = await import("./usage-VCFLDA5Y.js");
+    const by = options.by;
+    if (by !== void 0 && !USAGE_GROUP_KEYS.includes(by)) {
+      printError("Must be one of: harness, provider, model, purpose, status.");
+      process.exit(1);
+    }
+    process.exit(
+      await runUsage(issue ?? options.issue, {
+        ...options.since === void 0 ? {} : { since: options.since },
+        ...by === void 0 ? {} : { by },
+        ...options.json === void 0 ? {} : { json: options.json }
+      })
+    );
+  }
+);
+withGlobalOptions(
+  program.command("ps").description("Every issue-flow run active on this machine").option("--json", "Emit the listing as JSON").option("--watch", "Refresh the listing until interrupted")
+).action(async (options) => {
+  const { runPs } = await import("./ps-TNE44R5V.js");
+  process.exit(await runPs(options));
+});
+withGlobalOptions(
+  program.command("runs").description("History of the runs of this project, with how each ended")
+).action(async () => {
+  const { runRuns } = await import("./operations-LU6JA3BX.js");
+  process.exit(await runRuns());
+});
+withGlobalOptions(
+  program.command("logs").description("Read the execution journal (events.jsonl), filtered and readable").argument("[issue]", "Issue to read. Omitted: the most recently attempted one").option("--issue <issue>", "Same as the positional argument").option("--follow", "Keep reading as the journal grows").option("--tail <n>", "How many entries to show first (default 50)", parseInteger).option("--kind <kinds>", "Only these event types, comma separated (retry, phase:end, \u2026)")
+).action(
+  async (issue, options) => {
+    const { runLogs } = await import("./operations-LU6JA3BX.js");
+    const kinds = options.kind === void 0 ? void 0 : options.kind.split(",").map((kind) => kind.trim()).filter((kind) => kind !== "");
+    process.exit(
+      await runLogs(issue ?? options.issue, {
+        ...kinds === void 0 ? {} : { kind: kinds },
+        ...options.follow === void 0 ? {} : { follow: options.follow },
+        ...options.tail === void 0 ? {} : { tail: options.tail }
+      })
+    );
+  }
+);
+withGlobalOptions(
+  program.command("pause").description("Ask the running pipeline to stop after writing a checkpoint")
+).action(async () => {
+  const { runPause } = await import("./operations-LU6JA3BX.js");
+  process.exit(await runPause());
+});
+withGlobalOptions(
+  program.command("cancel").description("Stop the run and mark the issue so a resume does not pick it up").argument("[issue]", "Issue to cancel. Omitted: the most recently attempted one")
+).action(async (issue) => {
+  const { runCancel } = await import("./operations-LU6JA3BX.js");
+  process.exit(await runCancel(issue));
+});
+withIssueOptions(
+  withGlobalOptions(
+    program.command("analyze").description("Analyze an issue with the configured agent").argument("<issue>", "Issue number")
   )
 ).action(async (issue) => {
-  const { runAnalyze } = await import("./analyze-XV3K25K3.js");
+  const { runAnalyze } = await import("./analyze-WS47UYGN.js");
   const code = await runAnalyze(issue);
   process.exit(code);
 });
 withIssueOptions(
   withGlobalOptions(
-    program.command("prd").description("Generate a PRD from an analyzed issue via Claude Code Headless").argument("<issue>", "Issue number")
+    program.command("prd").description("Generate a PRD from an analyzed issue with the configured agent").argument("<issue>", "Issue number")
   )
 ).action(async (issue) => {
-  const { runPrd } = await import("./prd-4PWLCGH5.js");
+  const { runPrd } = await import("./prd-5O6GYCC6.js");
   const code = await runPrd(issue);
   process.exit(code);
 });
 withUserStoryNumberingOptions(
   withIssueOptions(
     withGlobalOptions(
-      program.command("plan").description("Convert a PRD to a tasks.json task plan via Claude Code Headless").argument("<issue>", "Issue number")
+      program.command("plan").description("Convert a PRD to a tasks.json task plan with the configured agent").argument("<issue>", "Issue number")
     )
   )
 ).action(async (issue, options) => {
@@ -302,7 +561,7 @@ withUserStoryNumberingOptions(
     }
     throw error;
   }
-  const { runPlan } = await import("./plan-Y2BYZD24.js");
+  const { runPlan } = await import("./plan-LEJJF3DE.js");
   const code = await runPlan(issue, void 0, numbering);
   process.exit(code);
 });
@@ -321,7 +580,7 @@ withWebOptions(
 ).action(
   async (positionalMaxIter, options) => {
     try {
-      const { runExecute } = await import("./execute-5OEKLM5X.js");
+      const { runExecute } = await import("./execute-NITIHHCK.js");
       const code = await runExecute(positionalMaxIter, options);
       process.exit(code);
     } catch (error) {
@@ -332,19 +591,19 @@ withWebOptions(
 );
 withIssueOptions(
   withGlobalOptions(
-    program.command("review").description("Validate an issue resolution via Claude Code Headless").argument("<issue>", "Issue number")
+    program.command("review").description("Validate an issue resolution with the configured agent").argument("<issue>", "Issue number")
   )
 ).action(async (issue) => {
-  const { runReview } = await import("./review-QGVAHEZF.js");
+  const { runReview } = await import("./review-YKWD6SNN.js");
   const code = await runReview(issue);
   process.exit(code);
 });
 withIssueOptions(
   withGlobalOptions(
-    program.command("pr").description("Create a pull request via Claude Code Headless").argument("<issue>", "Issue number")
+    program.command("pr").description("Create a pull request with the configured agent").argument("<issue>", "Issue number")
   )
 ).action(async (issue) => {
-  const { runPr } = await import("./pr-H6GLOSXF.js");
+  const { runPr } = await import("./pr-HPVUZ7S3.js");
   const code = await runPr(issue);
   process.exit(code);
 });
@@ -352,35 +611,126 @@ var webCommand = program.command("web").description("Manage the web monitoring s
 webCommand.command("serve").description(
   "Run the web monitor server in the foreground (internal \u2014 spawned detached by --web)"
 ).option("--port <n>", "Web server port (default: 3737)", parseInteger).option("--host <h>", "Web server host (default: 0.0.0.0)").option("--refresh <s>", "Suggested UI polling interval in seconds", parseInteger).action(async (options) => {
-  const { runWebServe } = await import("./web-ANQQTTRD.js");
+  const { runWebServe } = await import("./web-XVHLX62B.js");
   const code = await runWebServe(options);
   if (code !== 0) {
     process.exit(code);
   }
 });
 webCommand.command("stop").description("Stop the running web monitor server").action(async () => {
-  const { runWebStop } = await import("./web-ANQQTTRD.js");
+  const { runWebStop } = await import("./web-XVHLX62B.js");
   const code = await runWebStop();
   process.exit(code);
 });
 withGlobalOptions(
   program.command("policy").description("Inspect the policies discovered in this repository and their provenance").option("--scope <dir>", "Resolve the policy for a subdirectory (monorepo)").option("--json", "Emit the resolved policy as JSON")
 ).action(async (options) => {
-  const { runPolicy } = await import("./policy-XQW5NUIE.js");
+  const { runPolicy } = await import("./policy-JSYEK5B2.js");
   const code = await runPolicy(options);
   process.exit(code);
 });
+var routingCommand = withGlobalOptions(
+  program.command("routing").description("Inspect the shadow router (records a recommendation, does not act)")
+);
+routingCommand.option("--json", "Emit the resolved routing config as JSON").action(async (options) => {
+  const { runRoutingInspect } = await import("./routing-2ZUMZPJB.js");
+  process.exit(await runRoutingInspect(options));
+});
+routingCommand.command("report").description("Shadow agreement between selected and actual harness").option("--issue <n>", "Issue number").option("--json", "Emit JSON").action(async (options) => {
+  const { runRoutingReport } = await import("./routing-2ZUMZPJB.js");
+  process.exit(await runRoutingReport(options));
+});
+var conventionsCommand = withGlobalOptions(
+  program.command("conventions").description("Compute the repository Git convention (branch, commit, PR title)")
+);
+conventionsCommand.command("branch").description("Print the deterministic branch name for an issue").option("--issue <n>", "Issue number").option("--title <text>", "Issue title, when the issue cannot be resolved").option("--json", "Emit JSON").action(async (options) => {
+  const { runConventionsBranch } = await import("./conventions-WV4NDXGH.js");
+  process.exit(await runConventionsBranch(options));
+});
+conventionsCommand.command("commit").description("Print a Conventional Commit message").requiredOption("--type <type>", "Change type (feat, fix, docs, \u2026)").option("--scope <scope>", "Optional scope").requiredOption("--subject <text>", "Commit subject").option("--issue <n>", "Issue number for the Refs trailer").option("--story <id>", "Story id (US-010)").option("--breaking <text>", "Breaking change description").option("--json", "Emit JSON").action(
+  async (options) => {
+    const { runConventionsCommit } = await import("./conventions-WV4NDXGH.js");
+    process.exit(await runConventionsCommit(options));
+  }
+);
+conventionsCommand.command("pr-title").description("Print the Conventional Commit Pull Request title").option("--issue <n>", "Issue number").option("--title <text>", "Issue title, when the issue cannot be resolved").option("--json", "Emit JSON").action(async (options) => {
+  const { runConventionsPrTitle } = await import("./conventions-WV4NDXGH.js");
+  process.exit(await runConventionsPrTitle(options));
+});
+var agentCommand = withGlobalOptions(
+  program.command("agent").description("Inspect the resolved agent and model for each phase").option("--json", "Emit the resolved agent configuration as JSON")
+);
+agentCommand.action(async (options) => {
+  const { runAgent } = await import("./agent-BXRIEKVM.js");
+  const code = await runAgent(options);
+  process.exit(code);
+});
+agentCommand.command("use").description("Write an agent preference to config.json or .issue-flow.json").argument("<provider>", "claude, codex, cursor or antigravity").option("--model <model>", "Model identifier for this preference").option("--global", "Write to ~/.issue-flow/config.json (default)").option("--project", "Write to .issue-flow.json in the repository").option("--phase <phase>", "Write only the override for this phase").action(
+  async (provider, options) => {
+    const { runAgentUse } = await import("./agent-BXRIEKVM.js");
+    const code = await runAgentUse(provider, options);
+    process.exit(code);
+  }
+);
 withGlobalOptions(
-  program.command("pr-review").description("Review a Pull Request as a whole via Claude Code Headless").argument("[pr]", "Pull Request number (discovered from the session when omitted)").option("--issue <n>", "Issue the Pull Request belongs to").option("--round <n>", "Rewrite a specific review round instead of appending a new one").option("--yes", "Skip the confirmation of the discovered Pull Request").option(
+  program.command("pr-review").description("Review a Pull Request as a whole with the configured agent").argument("[pr]", "Pull Request number (discovered from the session when omitted)").option("--issue <n>", "Issue the Pull Request belongs to").option("--round <n>", "Rewrite a specific review round instead of appending a new one").option("--yes", "Skip the confirmation of the discovered Pull Request").option(
     "--fail-on <level>",
     "Verdict that fails the command: request-changes | suggestions | none"
   )
 ).action(
   async (pr, options) => {
-    const { runPrReview } = await import("./pr-review-CK5FR6WX.js");
+    const { runPrReview } = await import("./pr-review-R2QZBT3F.js");
     const code = await runPrReview(pr, options);
     process.exit(code);
   }
 );
+withGlobalOptions(
+  program.command("bench").description("Measure the corpus: synthetic (CI) or real (paid, on demand)").option("--mode <mode>", "synthetic (default, free) or real (fixtures + harness)").option(
+    "--task <class>",
+    "Corpus class (repeatable): trivial, small, medium, analysis",
+    collectString,
+    []
+  ).option("--arm <name>", "Experiment arm (repeatable). Default: baseline", collectString, []).option("--repeats <n>", "Repetitions per cell (default 5)", parseInteger).option(
+    "--campaign-max-cost <usd>",
+    "Campaign cost ceiling in USD (evaluateCeilings)",
+    parseUsd
+  ).option(
+    "--campaign-max-duration <ms>",
+    "Campaign duration ceiling in milliseconds",
+    parseInteger
+  ).option("--out <path>", "Write the markdown report to this path").option("--yes", "Skip the paid-campaign confirmation").option("--repo <path>", "Investigation escape; does not produce a publishable row").option("--json", "Also emit the campaign JSON")
+).action(
+  async (options) => {
+    if (options.mode !== void 0 && options.mode !== "synthetic" && options.mode !== "real") {
+      printError("Unknown bench mode. Use 'synthetic' or 'real'.");
+      process.exit(1);
+    }
+    const { runBench } = await import("./bench-SA3BOME5.js");
+    process.exit(
+      await runBench({
+        ...options.mode === void 0 ? {} : { mode: options.mode },
+        ...options.task === void 0 || options.task.length === 0 ? {} : { task: options.task },
+        ...options.arm === void 0 || options.arm.length === 0 ? {} : { arm: options.arm },
+        ...options.repeats === void 0 ? {} : { repeats: options.repeats },
+        ...options.campaignMaxCost === void 0 ? {} : { maxCost: options.campaignMaxCost },
+        ...options.campaignMaxDuration === void 0 ? {} : { maxDuration: options.campaignMaxDuration },
+        ...options.out === void 0 ? {} : { out: options.out },
+        ...options.yes === void 0 ? {} : { yes: options.yes },
+        ...options.repo === void 0 ? {} : { repo: options.repo },
+        ...options.json === void 0 ? {} : { json: options.json }
+      })
+    );
+  }
+);
+program.action(async () => {
+  const { listLiveRuns } = await import("./registry-LGPE53QD.js");
+  const runs = await listLiveRuns();
+  if (runs.length === 0) {
+    program.help();
+    return;
+  }
+  const { runPs } = await import("./ps-TNE44R5V.js");
+  process.exit(await runPs());
+});
 program.parse();
 //# sourceMappingURL=cli.js.map