issue-flow 0.15.0 → 0.17.0

package/dist/{chunk-XRLRKTQA.js → chunk-Z5O2XBWA.js}

@@ -1,47 +1,47 @@
 #!/usr/bin/env node
 import {
   listPullRequests
-} from "./chunk-4RXYFWP7.js";
+} from "./chunk-YUNBOUQH.js";
 import {
   publishPhaseMetrics,
   resolvePolicyPlaceholders
-} from "./chunk-PCN7ZQND.js";
+} from "./chunk-HLAPOUEM.js";
 import {
   applyPlaceholders,
   loadPrompt
-} from "./chunk-A35HE4V7.js";
+} from "./chunk-7F7LGMVO.js";
 import {
   DEFAULT_HEADLESS_TIMEOUT_MS,
   runHeadless
-} from "./chunk-5ZKBIXET.js";
+} from "./chunk-UK4E2FUA.js";
 import {
   loadPrReviewConfig
-} from "./chunk-WM3Y7Q4A.js";
+} from "./chunk-HY5HLFDU.js";
 import {
   resolveIssuePaths
-} from "./chunk-VR34TXHF.js";
+} from "./chunk-DV7HUC4Z.js";
 import {
   getGlobalTimeout,
   printError,
   printInfo,
   printSuccess,
   printWarning
-} from "./chunk-NVZMBXTE.js";
-import {
-  getSessionPublisher
-} from "./chunk-6QYMSNVA.js";
+} from "./chunk-XZUEFTUP.js";
 import {
   getCurrentBranch,
   run
-} from "./chunk-GSZCQUCY.js";
+} from "./chunk-YVPZUN6X.js";
+import {
+  getSessionPublisher
+} from "./chunk-DUS5ZNKL.js";
 import {
   isoNow,
   loadTaskPlan,
   saveTaskPlan
-} from "./chunk-XQHFC62U.js";
+} from "./chunk-SOM4QA6C.js";
 import {
   writeFileAtomic
-} from "./chunk-7Z4Y3VKM.js";
+} from "./chunk-3R27MJ5R.js";
 
 // src/commands/pr-review.ts
 import { join as join3 } from "path";
@@ -802,4 +802,4 @@ export {
   exitCodeFor,
   runPrReview
 };
-//# sourceMappingURL=chunk-XRLRKTQA.js.map
+//# sourceMappingURL=chunk-Z5O2XBWA.js.map

package/dist/cli.js

@@ -1,4 +1,7 @@
 #!/usr/bin/env node
+import {
+  getPackageVersion
+} from "./chunk-C5TL7T4V.js";
 import {
   DEFAULT_INACTIVITY_TIMEOUT_MS,
   installShutdownHandlers,
@@ -9,30 +12,29 @@ import {
   setRoutingCliOverrides,
   setVerifyCliOverrides,
   setWebCliOverrides
-} from "./chunk-WM3Y7Q4A.js";
-import "./chunk-VR34TXHF.js";
+} from "./chunk-HY5HLFDU.js";
+import "./chunk-DV7HUC4Z.js";
 import {
   printError,
   setGlobalTimeout,
   setInactivityTimeout,
   setVerbose
-} from "./chunk-NVZMBXTE.js";
-import "./chunk-6QYMSNVA.js";
-import "./chunk-AYYMW33T.js";
+} from "./chunk-XZUEFTUP.js";
+import "./chunk-QPGEFLMY.js";
 import "./chunk-HAKDLR6N.js";
-import "./chunk-GSZCQUCY.js";
-import "./chunk-TBDP6QPJ.js";
-import "./chunk-P3LRUNC6.js";
-import "./chunk-UNQYMR3H.js";
-import "./chunk-XQHFC62U.js";
+import "./chunk-YVPZUN6X.js";
+import "./chunk-DUS5ZNKL.js";
+import "./chunk-YII4U7ZD.js";
+import "./chunk-PPZ3K4YM.js";
+import "./chunk-SOM4QA6C.js";
 import {
   isAgentProviderId
-} from "./chunk-XDKGA6UX.js";
-import "./chunk-7Z4Y3VKM.js";
+} from "./chunk-ICM463EO.js";
 import "./chunk-XEYH6ZZI.js";
+import "./chunk-P3LRUNC6.js";
+import "./chunk-3R27MJ5R.js";
 
 // src/cli.ts
-import { createRequire } from "module";
 import { Command, InvalidArgumentError, Option } from "commander";
 
 // src/cli-options.ts
@@ -179,8 +181,7 @@ function resolveResilienceOverrides(flags) {
 }
 
 // src/cli.ts
-var require2 = createRequire(import.meta.url);
-var { version } = require2("../package.json");
+var version = getPackageVersion();
 function parseInteger(value) {
   const parsed = parseInt(value, 10);
   if (Number.isNaN(parsed) || parsed < 0) {
@@ -352,8 +353,8 @@ withIssueOptions(
   )
 ).action(
   async (options) => {
-    const { loadIssuesConfig } = await import("./config-UMP6DBJB.js");
-    const { runInit } = await import("./init-LLBVJNPE.js");
+    const { loadIssuesConfig } = await import("./config-KGZUPAUP.js");
+    const { runInit } = await import("./init-PDVQDRS6.js");
     const { preferredProvider } = await loadIssuesConfig();
     const code = await runInit(preferredProvider, {
       ...options,
@@ -375,7 +376,7 @@ withGlobalOptions(
     }
     throw error;
   }
-  const { runGenerate } = await import("./generate-AGBT7EHX.js");
+  const { runGenerate } = await import("./generate-CX6KNHZS.js");
   const code = await runGenerate(options.prompt, target);
   process.exit(code);
 });
@@ -418,7 +419,7 @@ withUserStoryNumberingOptions(
       }
       throw error;
     }
-    const { runPipeline } = await import("./run-5EHIFF2V.js");
+    const { runPipeline } = await import("./run-3MPORLF5.js");
     const code = await runPipeline(
       issues,
       options.mode,
@@ -447,7 +448,7 @@ withIssueOptions(
     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-QNLQSCR5.js");
+  const { runResume } = await import("./resume-VLWIE264.js");
   const code = await runResume(issue, {
     ...options.all === void 0 ? {} : { all: options.all },
     ...options.mode === void 0 ? {} : { mode: options.mode }
@@ -457,7 +458,7 @@ withIssueOptions(
 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-JQYK2EMT.js");
+  const { runStatus } = await import("./operations-CAKIT2BO.js");
   process.exit(
     await runStatus(issue, { ...options.json === void 0 ? {} : { json: options.json } })
   );
@@ -466,7 +467,7 @@ 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-QL563I7F.js");
+    const { runUsage, USAGE_GROUP_KEYS } = await import("./usage-U7QNGCPK.js");
     const by = options.by;
     if (by !== void 0 && !USAGE_GROUP_KEYS.includes(by)) {
       printError("Must be one of: harness, provider, model, purpose, status.");
@@ -484,20 +485,20 @@ withGlobalOptions(
 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-KUUZ6TUL.js");
+  const { runPs } = await import("./ps-76L6ZAZL.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-JQYK2EMT.js");
+  const { runRuns } = await import("./operations-CAKIT2BO.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-JQYK2EMT.js");
+    const { runLogs } = await import("./operations-CAKIT2BO.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, {
@@ -511,13 +512,13 @@ withGlobalOptions(
 withGlobalOptions(
   program.command("pause").description("Ask the running pipeline to stop after writing a checkpoint")
 ).action(async () => {
-  const { runPause } = await import("./operations-JQYK2EMT.js");
+  const { runPause } = await import("./operations-CAKIT2BO.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-JQYK2EMT.js");
+  const { runCancel } = await import("./operations-CAKIT2BO.js");
   process.exit(await runCancel(issue));
 });
 withIssueOptions(
@@ -525,7 +526,7 @@ withIssueOptions(
     program.command("analyze").description("Analyze an issue with the configured agent").argument("<issue>", "Issue number")
   )
 ).action(async (issue) => {
-  const { runAnalyze } = await import("./analyze-O2PYDIFK.js");
+  const { runAnalyze } = await import("./analyze-6M3KEOX7.js");
   const code = await runAnalyze(issue);
   process.exit(code);
 });
@@ -534,7 +535,7 @@ withIssueOptions(
     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-D6YDYAFX.js");
+  const { runPrd } = await import("./prd-ZNC4T5BS.js");
   const code = await runPrd(issue);
   process.exit(code);
 });
@@ -555,7 +556,7 @@ withUserStoryNumberingOptions(
     }
     throw error;
   }
-  const { runPlan } = await import("./plan-HSLWDJEZ.js");
+  const { runPlan } = await import("./plan-PRORGS3L.js");
   const code = await runPlan(issue, void 0, numbering);
   process.exit(code);
 });
@@ -574,7 +575,7 @@ withWebOptions(
 ).action(
   async (positionalMaxIter, options) => {
     try {
-      const { runExecute } = await import("./execute-E3BRMDAQ.js");
+      const { runExecute } = await import("./execute-QL3ZQIAP.js");
       const code = await runExecute(positionalMaxIter, options);
       process.exit(code);
     } catch (error) {
@@ -588,7 +589,7 @@ withIssueOptions(
     program.command("review").description("Validate an issue resolution with the configured agent").argument("<issue>", "Issue number")
   )
 ).action(async (issue) => {
-  const { runReview } = await import("./review-3KJ4BH2V.js");
+  const { runReview } = await import("./review-7CREJDKB.js");
   const code = await runReview(issue);
   process.exit(code);
 });
@@ -597,7 +598,7 @@ withIssueOptions(
     program.command("pr").description("Create a pull request with the configured agent").argument("<issue>", "Issue number")
   )
 ).action(async (issue) => {
-  const { runPr } = await import("./pr-6TCZXG6K.js");
+  const { runPr } = await import("./pr-27RMQI5F.js");
   const code = await runPr(issue);
   process.exit(code);
 });
@@ -605,63 +606,71 @@ 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-PPSMNTQ6.js");
+  const { runWebServe } = await import("./web-HUNDHCJ4.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-PPSMNTQ6.js");
+  const { runWebStop } = await import("./web-HUNDHCJ4.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-IMRXGG7X.js");
+  const { runPolicy } = await import("./policy-WX6O2JID.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)")
+  program.command("routing").description("Inspect and configure adaptive harness/model routing")
 );
-routingCommand.option("--json", "Emit the resolved routing config as JSON").action(async (options) => {
-  const { runRoutingInspect } = await import("./routing-TN7GLMGU.js");
-  process.exit(await runRoutingInspect(options));
+routingCommand.option("--json", "Emit the resolved routing config as JSON").action(async (_options, command) => {
+  const { runRoutingInspect } = await import("./routing-VCDYHSXA.js");
+  process.exit(await runRoutingInspect(command.opts()));
+});
+routingCommand.command("explain").description("Explain the resolved routing target for every phase").option("--json", "Emit JSON").action(async (_options, command) => {
+  const { runRoutingExplain } = await import("./routing-VCDYHSXA.js");
+  process.exit(await runRoutingExplain(command.optsWithGlobals()));
+});
+routingCommand.command("use").description("Enable an embedded routing policy").argument("<policy>", "Policy name (recommended)").option("--global", "Write ~/.issue-flow/config.json (default)").option("--project", "Write .issue-flow.json instead").action(async (policy, _options, command) => {
+  const { runRoutingUse } = await import("./routing-VCDYHSXA.js");
+  process.exit(await runRoutingUse(policy, command.optsWithGlobals()));
 });
-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-TN7GLMGU.js");
-  process.exit(await runRoutingReport(options));
+routingCommand.command("report").description("Shadow agreement between selected and actual harness").option("--issue <n>", "Issue number").option("--json", "Emit JSON").action(async (_options, command) => {
+  const { runRoutingReport } = await import("./routing-VCDYHSXA.js");
+  process.exit(await runRoutingReport(command.optsWithGlobals()));
 });
 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-DKH7AE4T.js");
+  const { runConventionsBranch } = await import("./conventions-RYN7OXJN.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-DKH7AE4T.js");
+    const { runConventionsCommit } = await import("./conventions-RYN7OXJN.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-DKH7AE4T.js");
+  const { runConventionsPrTitle } = await import("./conventions-RYN7OXJN.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-AT64RXTA.js");
+  const { runAgent } = await import("./agent-TB6W7PT7.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-AT64RXTA.js");
+    const { runAgentUse } = await import("./agent-TB6W7PT7.js");
     const code = await runAgentUse(provider, options);
     process.exit(code);
   }
@@ -673,7 +682,7 @@ withGlobalOptions(
   )
 ).action(
   async (pr, options) => {
-    const { runPrReview } = await import("./pr-review-6MWJO2NP.js");
+    const { runPrReview } = await import("./pr-review-VNESMAMT.js");
     const code = await runPrReview(pr, options);
     process.exit(code);
   }
@@ -699,7 +708,7 @@ withGlobalOptions(
       printError("Unknown bench mode. Use 'synthetic' or 'real'.");
       process.exit(1);
     }
-    const { runBench } = await import("./bench-ODFPAGW6.js");
+    const { runBench } = await import("./bench-FM7I7EIV.js");
     process.exit(
       await runBench({
         ...options.mode === void 0 ? {} : { mode: options.mode },
@@ -717,13 +726,13 @@ withGlobalOptions(
   }
 );
 program.action(async () => {
-  const { listLiveRuns } = await import("./registry-SB7XTMGE.js");
+  const { listLiveRuns } = await import("./registry-XLHHYLTR.js");
   const runs = await listLiveRuns();
   if (runs.length === 0) {
     program.help();
     return;
   }
-  const { runPs } = await import("./ps-KUUZ6TUL.js");
+  const { runPs } = await import("./ps-76L6ZAZL.js");
   process.exit(await runPs());
 });
 program.parse();