issue-flow 0.18.0 → 0.20.0

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   getPackageVersion
-} from "./chunk-C5TL7T4V.js";
+} from "./chunk-2YM2VH6R.js";
 import {
   DEFAULT_INACTIVITY_TIMEOUT_MS,
   installShutdownHandlers,
@@ -12,27 +12,29 @@ import {
   setRoutingCliOverrides,
   setVerifyCliOverrides,
   setWebCliOverrides
-} from "./chunk-QF7VEL3M.js";
-import "./chunk-LI35PIIS.js";
+} from "./chunk-YC24E66P.js";
 import {
   printError,
   setGlobalTimeout,
   setInactivityTimeout,
   setVerbose
-} from "./chunk-XZUEFTUP.js";
-import "./chunk-QPGEFLMY.js";
-import "./chunk-HAKDLR6N.js";
-import "./chunk-YVPZUN6X.js";
-import "./chunk-DUS5ZNKL.js";
-import "./chunk-6K2LCFG6.js";
-import "./chunk-PPZ3K4YM.js";
-import "./chunk-SOM4QA6C.js";
+} from "./chunk-DBLXLKGU.js";
+import "./chunk-I64N6RL6.js";
+import "./chunk-DIMDAYZS.js";
+import "./chunk-WB4FA2EH.js";
+import "./chunk-VHQMMY2D.js";
+import "./chunk-P3LRUNC6.js";
+import "./chunk-RDPK7LYK.js";
+import "./chunk-JCR5C5A7.js";
+import "./chunk-NP47HRX2.js";
 import {
   isAgentProviderId
-} from "./chunk-ICM463EO.js";
-import "./chunk-XEYH6ZZI.js";
-import "./chunk-P3LRUNC6.js";
-import "./chunk-3R27MJ5R.js";
+} from "./chunk-44RF3VFG.js";
+import "./chunk-7MJGYPHF.js";
+import "./chunk-XNK5UN2D.js";
+import "./chunk-MAJ6QDRL.js";
+import "./chunk-KUA6KBBD.js";
+import "./chunk-PFWHHYEO.js";
 
 // src/cli.ts
 import { Command, InvalidArgumentError, Option } from "commander";
@@ -228,7 +230,7 @@ function withGlobalOptions(cmd) {
     parseInteger
   ).option(
     "--agent <provider>",
-    "Run every phase on this agent (claude|codex|cursor|antigravity)"
+    "Run every phase on this agent (claude|codex|cursor|antigravity|opencode)"
   ).option("--agent-model <model>", "Override the model for every phase").option(
     "--agent-phase <phase>=<provider>[:<model>]",
     "Override one phase (repeatable)",
@@ -244,7 +246,9 @@ 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.");
+      throw new InvalidArgumentError(
+        "Must be one of: claude, codex, cursor, antigravity, opencode."
+      );
     }
     overrides.forceProvider = opts.agent;
   }
@@ -353,8 +357,8 @@ withIssueOptions(
   )
 ).action(
   async (options) => {
-    const { loadIssuesConfig } = await import("./config-LEBZZCJP.js");
-    const { runInit } = await import("./init-TO6MUXO4.js");
+    const { loadIssuesConfig } = await import("./config-6YTWPDBK.js");
+    const { runInit } = await import("./init-4LB2YKWP.js");
     const { preferredProvider } = await loadIssuesConfig();
     const code = await runInit(preferredProvider, {
       ...options,
@@ -376,7 +380,7 @@ withGlobalOptions(
     }
     throw error;
   }
-  const { runGenerate } = await import("./generate-JGW5JSKB.js");
+  const { runGenerate } = await import("./generate-QATMDKOK.js");
   const code = await runGenerate(options.prompt, target);
   process.exit(code);
 });
@@ -390,7 +394,7 @@ withUserStoryNumberingOptions(
           ).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(
+          ).option("--pr-review", "Review the created Pull Request after the pr phase").option("--close-issue", "Close issues after successful delivery; remember this choice").option("--no-close-issue", "Revoke automatic issue closure").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
@@ -419,7 +423,7 @@ withUserStoryNumberingOptions(
       }
       throw error;
     }
-    const { runPipeline } = await import("./run-2RXJCJKT.js");
+    const { runPipeline } = await import("./run-XMACQBRJ.js");
     const code = await runPipeline(
       issues,
       options.mode,
@@ -427,6 +431,7 @@ withUserStoryNumberingOptions(
       phases.noBranch,
       phases.prReview,
       {
+        closeIssue: options.closeIssue,
         yes: scope.yes,
         only: scope.only,
         cascade: scope.cascade,
@@ -445,32 +450,66 @@ withUserStoryNumberingOptions(
 );
 withIssueOptions(
   withGlobalOptions(
-    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")
+    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("--close-issue", "Close issues after successful delivery; remember this choice").option("--no-close-issue", "Revoke automatic issue closure").option("--mode <mode>", "Execution mode: auto | manual", "auto")
   )
-).action(async (issue, options) => {
-  const { runResume } = await import("./resume-URCU6CIJ.js");
-  const code = await runResume(issue, {
-    ...options.all === void 0 ? {} : { all: options.all },
-    ...options.mode === void 0 ? {} : { mode: options.mode }
+).action(
+  async (issue, options) => {
+    const { runResume } = await import("./resume-BWJZGBLZ.js");
+    const code = await runResume(issue, {
+      ...options.closeIssue === void 0 ? {} : { closeIssue: options.closeIssue },
+      ...options.all === void 0 ? {} : { all: options.all },
+      ...options.mode === void 0 ? {} : { mode: options.mode }
+    });
+    process.exit(code);
+  }
+);
+var artifactsCommand = program.command("artifacts").description("Inspect local artifacts without changing files or CLI state");
+if (process.argv.includes("--json")) {
+  artifactsCommand.configureOutput({ writeErr: () => {
+  } }).exitOverride((error) => {
+    if (error.exitCode === 0) process.exit(0);
+    console.log(
+      JSON.stringify({
+        schemaVersion: 1,
+        ok: false,
+        data: null,
+        errors: [{ code: "arguments", path: "", message: error.message }]
+      })
+    );
+    process.exit(1);
   });
-  process.exit(code);
-});
+}
+for (const operation of ["plan", "issue"]) {
+  const command = artifactsCommand.command(operation).argument("[file]", "Artifact path");
+  if (operation === "issue") command.argument("[metadata]", "Optional metadata.json");
+  else command.option("--context", "Select current execution facts without history");
+  command.option("--json", "Emit a versioned JSON inspection").allowExcessArguments(false);
+  command.action(async (...args) => {
+    const file = args[0];
+    const metadata = operation === "issue" ? args[1] : void 0;
+    const options = args[operation === "issue" ? 2 : 1];
+    const { runArtifacts } = await import("./artifacts-AMJQJFFV.js");
+    process.exit(
+      await runArtifacts(options.context ? "context" : operation, file, metadata, options.json)
+    );
+  });
+}
 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-O4FORFIH.js");
+  const { runStatus } = await import("./operations-RUQP2Y2F.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")
+  program.command("usage").description("Aggregate execution telemetry from SQLite").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, trigger or status").option("--json", "Emit the assembled totals as JSON")
 ).action(
   async (issue, options) => {
-    const { runUsage, USAGE_GROUP_KEYS } = await import("./usage-KTMYXAPF.js");
+    const { runUsage, USAGE_GROUP_KEYS } = await import("./usage-JOODVE5O.js");
     const by = options.by;
     if (by !== void 0 && !USAGE_GROUP_KEYS.includes(by)) {
-      printError("Must be one of: harness, provider, model, purpose, status.");
+      printError("Must be one of: harness, provider, model, purpose, trigger, status.");
       process.exit(1);
     }
     process.exit(
@@ -485,20 +524,51 @@ 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-76L6ZAZL.js");
+  const { runPs } = await import("./ps-UIKSOUAQ.js");
   process.exit(await runPs(options));
 });
+var db = program.command("db").description("Inspect and maintain the Issue Flow SQLite database");
+db.command("check").description("Run SQLite integrity_check").action(async () => {
+  const { runDbCheck } = await import("./db-QAZG4LQD.js");
+  process.exit(await runDbCheck());
+});
+db.command("backup").description("Create a consistent SQLite backup").option("--destination <path>", "Where to write the backup").action(async (options) => {
+  const { runDbBackup } = await import("./db-QAZG4LQD.js");
+  process.exit(await runDbBackup(options.destination));
+});
+db.command("vacuum").description("Rebuild the SQLite database to reclaim unused space").action(async () => {
+  const { runDbVacuum } = await import("./db-QAZG4LQD.js");
+  process.exit(await runDbVacuum());
+});
+db.command("export").description("Export structured SQLite state as readable JSON").option("--destination <path>", "Where to write the JSON export (stdout by default)").action(async (options) => {
+  const { runDbExport } = await import("./db-QAZG4LQD.js");
+  process.exit(await runDbExport(options.destination));
+});
+db.command("verify").description("Compare task and queue projections with canonical SQLite state").action(async () => {
+  const { runDbVerify } = await import("./db-QAZG4LQD.js");
+  process.exit(await runDbVerify());
+});
+db.command("import").description("Import preserved compatibility artifacts").option("--with-events", "Also import the potentially large JSONL journal").action(async (options) => {
+  const { runDbImport } = await import("./db-QAZG4LQD.js");
+  process.exit(await runDbImport(options));
+});
 withGlobalOptions(
   program.command("runs").description("History of the runs of this project, with how each ended")
 ).action(async () => {
-  const { runRuns } = await import("./operations-O4FORFIH.js");
+  const { runRuns } = await import("./operations-RUQP2Y2F.js");
   process.exit(await runRuns());
 });
+withGlobalOptions(
+  program.command("history").description("Relational phase, invocation and verdict history for one issue").argument("<issue>", "Issue identifier").option("--json", "Emit the complete history as JSON")
+).action(async (issue, options) => {
+  const { runHistory } = await import("./history-NBPUZVGQ.js");
+  process.exit(await runHistory(issue, options));
+});
 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-O4FORFIH.js");
+    const { runLogs } = await import("./operations-RUQP2Y2F.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, {
@@ -512,13 +582,13 @@ withGlobalOptions(
 withGlobalOptions(
   program.command("pause").description("Ask the running pipeline to stop after writing a checkpoint")
 ).action(async () => {
-  const { runPause } = await import("./operations-O4FORFIH.js");
+  const { runPause } = await import("./operations-RUQP2Y2F.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-O4FORFIH.js");
+  const { runCancel } = await import("./operations-RUQP2Y2F.js");
   process.exit(await runCancel(issue));
 });
 withIssueOptions(
@@ -526,7 +596,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-Q4ONIWRZ.js");
+  const { runAnalyze } = await import("./analyze-UEJ2R3H5.js");
   const code = await runAnalyze(issue);
   process.exit(code);
 });
@@ -535,7 +605,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-6CYEMLDY.js");
+  const { runPrd } = await import("./prd-ET6XKYRS.js");
   const code = await runPrd(issue);
   process.exit(code);
 });
@@ -556,7 +626,7 @@ withUserStoryNumberingOptions(
     }
     throw error;
   }
-  const { runPlan } = await import("./plan-OXAT344Q.js");
+  const { runPlan } = await import("./plan-2NMSHTMD.js");
   const code = await runPlan(issue, void 0, numbering);
   process.exit(code);
 });
@@ -575,7 +645,7 @@ withWebOptions(
 ).action(
   async (positionalMaxIter, options) => {
     try {
-      const { runExecute } = await import("./execute-LELOSR5T.js");
+      const { runExecute } = await import("./execute-QCT64D37.js");
       const code = await runExecute(positionalMaxIter, options);
       process.exit(code);
     } catch (error) {
@@ -589,7 +659,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-LVZT2TMW.js");
+  const { runReview } = await import("./review-2MTZLNSS.js");
   const code = await runReview(issue);
   process.exit(code);
 });
@@ -598,7 +668,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-UZHNKKZC.js");
+  const { runPr } = await import("./pr-QKFO5HI3.js");
   const code = await runPr(issue);
   process.exit(code);
 });
@@ -606,21 +676,21 @@ 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-B5UPHHR5.js");
+  const { runWebServe } = await import("./web-TLMWJ2BM.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-B5UPHHR5.js");
+  const { runWebStop } = await import("./web-TLMWJ2BM.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-U5NBFAO5.js");
+  const { runPolicy } = await import("./policy-RKKFF5A2.js");
   const code = await runPolicy(options);
   process.exit(code);
 });
@@ -628,49 +698,49 @@ var routingCommand = withGlobalOptions(
   program.command("routing").description("Inspect and configure adaptive harness/model routing")
 );
 routingCommand.option("--json", "Emit the resolved routing config as JSON").action(async (_options, command) => {
-  const { runRoutingInspect } = await import("./routing-EK6RBZM4.js");
+  const { runRoutingInspect } = await import("./routing-RM5ABHHD.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-EK6RBZM4.js");
+  const { runRoutingExplain } = await import("./routing-RM5ABHHD.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").option("--active", "Apply the policy to future runs instead of leaving routing in shadow mode").action(async (policy, _options, command) => {
-  const { runRoutingUse } = await import("./routing-EK6RBZM4.js");
+  const { runRoutingUse } = await import("./routing-RM5ABHHD.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, command) => {
-  const { runRoutingReport } = await import("./routing-EK6RBZM4.js");
+  const { runRoutingReport } = await import("./routing-RM5ABHHD.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-XOT6YW5L.js");
+  const { runConventionsBranch } = await import("./conventions-5UPOTU42.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-XOT6YW5L.js");
+    const { runConventionsCommit } = await import("./conventions-5UPOTU42.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-XOT6YW5L.js");
+  const { runConventionsPrTitle } = await import("./conventions-5UPOTU42.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-HMZTXCRT.js");
+  const { runAgent } = await import("./agent-4DHRKZ2Z.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(
+agentCommand.command("use").description("Write an agent preference to config.json or .issue-flow.json").argument("<provider>", "claude, codex, cursor, antigravity or opencode").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-HMZTXCRT.js");
+    const { runAgentUse } = await import("./agent-4DHRKZ2Z.js");
     const code = await runAgentUse(provider, options);
     process.exit(code);
   }
@@ -682,7 +752,7 @@ withGlobalOptions(
   )
 ).action(
   async (pr, options) => {
-    const { runPrReview } = await import("./pr-review-Q4ACAWDM.js");
+    const { runPrReview } = await import("./pr-review-H2BFD6F2.js");
     const code = await runPrReview(pr, options);
     process.exit(code);
   }
@@ -708,7 +778,7 @@ withGlobalOptions(
       printError("Unknown bench mode. Use 'synthetic' or 'real'.");
       process.exit(1);
     }
-    const { runBench } = await import("./bench-WWWXLTFH.js");
+    const { runBench } = await import("./bench-RNRXVEFK.js");
     process.exit(
       await runBench({
         ...options.mode === void 0 ? {} : { mode: options.mode },
@@ -726,13 +796,13 @@ withGlobalOptions(
   }
 );
 program.action(async () => {
-  const { listLiveRuns } = await import("./registry-XLHHYLTR.js");
+  const { listLiveRuns } = await import("./registry-HV7M6MAH.js");
   const runs = await listLiveRuns();
   if (runs.length === 0) {
     program.help();
     return;
   }
-  const { runPs } = await import("./ps-76L6ZAZL.js");
+  const { runPs } = await import("./ps-UIKSOUAQ.js");
   process.exit(await runPs());
 });
 program.parse();