executable-stories-formatters 1.20.0 → 1.21.0

package/dist/cli.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 
 // src/cli.ts
-import * as fs19 from "fs";
-import * as path25 from "path";
+import * as fs16 from "fs";
+import * as path22 from "path";
 import { parseArgs as parseArgs4 } from "util";
 import { canonicalizeRun as canonicalizeRun7 } from "executable-stories-core/converters/acl/canonicalize";
 import {
@@ -127,7 +127,6 @@ Useful commands (all take \`raw-run.json\`):
 - \`executable-stories check <raw-run.json>\` \u2014 failure summary with non-zero exit (agent backpressure)
 - \`executable-stories list <raw-run.json>\` \u2014 scenario listing
 - \`executable-stories compare <baseline> <current>\` \u2014 behavioural diff between runs
-- \`executable-stories dev\` \u2014 live docs site (scaffold once with \`init-astro --install\`)
 
 <!-- generated by executable-stories; edit or delete freely \u2014 it will not be rewritten -->
 `;
@@ -626,7 +625,7 @@ function createTestRailProvider(config, auth, deps) {
       if (response.status === 429 && attempt < MAX_ATTEMPTS - 1) {
         const retryAfter = Number(response.headers.get("retry-after") ?? "1");
         deps.logger.warn(`TestRail rate limit hit, retrying in ${retryAfter}s`);
-        await new Promise((resolve13) => setTimeout(resolve13, Math.max(1, retryAfter) * 1e3));
+        await new Promise((resolve12) => setTimeout(resolve12, Math.max(1, retryAfter) * 1e3));
         continue;
       }
       const text2 = await response.text();
@@ -1181,14 +1180,10 @@ var COMPLETION_SUBCOMMANDS = [
   ["triage", "Discovery worklist: failing scenarios, regressions first"],
   ["validate", "Validate a JSON file against the schema"],
   ["doctor", "Diagnose the run JSON: location, schema version, contents"],
-  ["dev", "Run the Astro docs site dev server"],
-  ["init-astro", "Scaffold a thin Astro docs site"],
-  ["new", "Scaffold a docs page from a template"],
   ["check-links", "Scan docs for broken links"],
   ["push", "Send a run to a cloud ingest endpoint (any framework's output)"],
   ["coverage", "Compare stories against a test-management system (read-only)"],
   ["sync", "Push cases, executions, and evidence to TestRail or Xray"],
-  ["import-openapi", "Generate API doc pages from an OpenAPI spec"],
   ["publish-confluence", "Publish an ADF JSON file to Confluence"],
   ["publish-jira", "Publish an ADF JSON file to a Jira issue"],
   ["deploy", "Record deployments, show status, detect drift"],
@@ -2009,9 +2004,9 @@ function renderDiffHunk(file, hunk, anchoredStart, anchoredCount) {
     const sign = line.kind === "add" ? "+" : line.kind === "del" ? "-" : " ";
     return `<tr class="${cls}"><td class="diff-ln">${o}</td><td class="diff-ln">${n}</td><td class="diff-sign">${sign}</td><td class="diff-code">${escapeHtml(line.text)}</td></tr>`;
   });
-  const path26 = file.newPath ?? file.oldPath ?? "";
+  const path23 = file.newPath ?? file.oldPath ?? "";
   return `<div class="diff-hunk">
-    <div class="diff-file-header"><code>${escapeHtml(path26)}</code> <span class="subtle">@@ -${hunk.oldStart} +${hunk.newStart} @@ ${escapeHtml(hunk.header)}</span></div>
+    <div class="diff-file-header"><code>${escapeHtml(path23)}</code> <span class="subtle">@@ -${hunk.oldStart} +${hunk.newStart} @@ ${escapeHtml(hunk.header)}</span></div>
     <table class="diff-table"><tbody>${rows.join("")}</tbody></table>
   </div>`;
 }
@@ -2304,7 +2299,8 @@ function renderClaim(lines, claim) {
   lines.push("");
   lines.push(`- File: \`${claim.sourceFile}:${claim.sourceLine}\``);
   if (claim.changeType !== "unknown") {
-    lines.push(`- Change: \`${claim.changeType}\``);
+    const inferred = claim.changeTypeConfidence === void 0 ? "" : ` _(inferred, jev ${claim.changeTypeConfidence.toFixed(2)})_`;
+    lines.push(`- Change: \`${claim.changeType}\`${inferred}`);
   }
   const tickets = claim.testCase.story.tickets ?? [];
   if (tickets.length > 0) {
@@ -2572,6 +2568,7 @@ function toJsonClaim(claim) {
     status: claim.status,
     audience: claim.audience,
     changeType: claim.changeType,
+    ...claim.changeTypeConfidence === void 0 ? {} : { changeTypeConfidence: claim.changeTypeConfidence },
     strength: claim.strength,
     strengthReasons: claim.strengthReasons,
     coversFiles: claim.coversFiles
@@ -2597,6 +2594,50 @@ function buildReviewJson(review) {
   };
 }
 
+// src/jev.ts
+var JEV_ENDPOINT = "https://api.typesafe.ai/v1/systemone";
+var JEV_MODEL = "jev-latest";
+function createJevClient(options) {
+  const {
+    apiKey,
+    model = JEV_MODEL,
+    endpoint = JEV_ENDPOINT,
+    fetch: fetch2 = globalThis.fetch,
+    timeoutMs = 1e4
+  } = options;
+  return {
+    model,
+    // One attempt per question set; add backoff on 429/529 if a loop hits rate limits.
+    async ask(state, questions) {
+      const response = await fetch2(endpoint, {
+        method: "POST",
+        headers: { Authorization: `Bearer ${apiKey}`, "Content-Type": "application/json" },
+        body: JSON.stringify({ model, state, questions }),
+        signal: AbortSignal.timeout(timeoutMs)
+      });
+      if (!response.ok) throw new Error(`Jev ${response.status}: ${(await response.text()).slice(0, 200)}`);
+      const body = await response.json();
+      if (!body.answers) throw new Error("Jev response has no answers");
+      return body.answers;
+    }
+  };
+}
+function jevFromEnv(env = process.env) {
+  const apiKey = env.JEV_API_KEY;
+  if (!apiKey) return void 0;
+  return createJevClient({
+    apiKey,
+    ...env.JEV_MODEL ? { model: env.JEV_MODEL } : {},
+    ...env.JEV_ENDPOINT ? { endpoint: env.JEV_ENDPOINT } : {}
+  });
+}
+function asChoice(answer) {
+  return answer?.type === "choice" ? answer : void 0;
+}
+function asNoul(answer) {
+  return answer?.type === "noul" ? answer.noul : void 0;
+}
+
 // src/goal.ts
 var ACTIVE = ["passed", "failed"];
 function buildGoal(args, _deps = {}) {
@@ -2642,9 +2683,41 @@ function buildGoal(args, _deps = {}) {
     requirements,
     regressions,
     regressionsEnforced: Boolean(baseline && args.enforceNoRegressions),
-    ratchet: { enforced: Boolean(baseline && args.enforceRatchet), violations }
+    ratchet: { enforced: Boolean(baseline && args.enforceRatchet), violations, advisories: [] }
   };
 }
+var GOAL_WEAKENED_MIN_PROBABILITY = 0.75;
+var stepText = (tc) => tc.story.steps.map((s) => `${s.keyword} ${s.text}`);
+async function enrichGoal(report, args, jev) {
+  const { baseline } = args;
+  if (!baseline || !report.ratchet.enforced) return report;
+  const current = new Map(args.run.testCases.map((tc) => [tc.id, tc]));
+  const flagged = new Set(report.ratchet.violations.map((v) => v.id));
+  const rewritten = baseline.testCases.flatMap((base) => {
+    const now = current.get(base.id);
+    if (!now || flagged.has(base.id)) return [];
+    const before = stepText(base);
+    const after = stepText(now);
+    return before.join("\n") === after.join("\n") ? [] : [{ base, before, after }];
+  });
+  const advisories = (await Promise.all(
+    rewritten.map(async ({ base, before, after }) => {
+      const answers = await jev.ask(
+        { baseline: before, now: after },
+        {
+          weakened: {
+            type: "noul",
+            instructions: "Does the NOW scenario check less than the BASELINE scenario: fewer or weaker assertions, looser expectations, or a removed check?"
+          }
+        }
+      );
+      const p = asNoul(answers.weakened);
+      if (p === void 0 || p < GOAL_WEAKENED_MIN_PROBABILITY) return [];
+      return [{ id: base.id, title: base.story.scenario, kind: "weakened", detail: `jev ${p.toFixed(2)}: steps rewritten, checks less` }];
+    })
+  )).flat();
+  return { ...report, ratchet: { ...report.ratchet, advisories } };
+}
 function evaluate(selector, matched) {
   const passed = matched.filter((tc) => tc.status === "passed").length;
   const failing = matched.filter((tc) => tc.status !== "passed").map((tc) => tc.story.scenario);
@@ -2686,6 +2759,9 @@ function renderGoal(report, format) {
         lines.push(`    ${v.kind}: ${v.title} (${v.detail})`);
       }
     }
+    for (const v of report.ratchet.advisories) {
+      lines.push(`    advisory ${v.kind}: ${v.title} (${v.detail})`);
+    }
   }
   return lines.join("\n");
 }
@@ -2768,193 +2844,8 @@ function updateHistory(args) {
   };
 }
 
-// src/import-openapi.ts
-import * as fs6 from "fs";
-import * as path7 from "path";
-import { parse as parseYamlString } from "yaml";
-var HTTP_METHODS = ["get", "post", "put", "patch", "delete", "options", "head"];
-function parseYaml2(raw, specPath) {
-  try {
-    return parseYamlString(raw);
-  } catch (err) {
-    throw new Error(`Could not parse YAML spec ${specPath}: ${err.message}`, {
-      cause: err
-    });
-  }
-}
-function parseSpec(specPath) {
-  if (!fs6.existsSync(specPath)) throw new Error(`Spec not found: ${specPath}`);
-  const raw = fs6.readFileSync(specPath, "utf8");
-  const ext = path7.extname(specPath).toLowerCase();
-  if (ext === ".json") return JSON.parse(raw);
-  if (ext === ".yaml" || ext === ".yml") return parseYaml2(raw, specPath);
-  try {
-    return JSON.parse(raw);
-  } catch {
-    return parseYaml2(raw, specPath);
-  }
-}
-function extractEndpoints(spec) {
-  const paths = spec.paths ?? {};
-  const endpoints = [];
-  for (const [route, item] of Object.entries(paths)) {
-    if (!item || typeof item !== "object") continue;
-    for (const method of HTTP_METHODS) {
-      const op = item[method];
-      if (!op || typeof op !== "object") continue;
-      const tags = Array.isArray(op.tags) && op.tags.length > 0 ? op.tags : ["API"];
-      endpoints.push({
-        method: method.toUpperCase(),
-        path: route,
-        operationId: typeof op.operationId === "string" ? op.operationId : void 0,
-        summary: typeof op.summary === "string" && op.summary || typeof op.description === "string" && op.description || "",
-        tag: String(tags[0])
-      });
-    }
-  }
-  return endpoints;
-}
-function loadScenarios(runFile) {
-  if (!runFile) return [];
-  if (!fs6.existsSync(runFile)) throw new Error(`Run file not found: ${runFile}`);
-  const report = JSON.parse(fs6.readFileSync(runFile, "utf8"));
-  return (report.features ?? []).flatMap((f) => f.scenarios ?? []);
-}
-function endpointRefs(endpoint) {
-  const refs = [
-    endpoint.operationId,
-    `${endpoint.method} ${endpoint.path}`,
-    endpoint.path
-  ].filter((r) => Boolean(r));
-  return refs;
-}
-function scenarioMatchesEndpoint(scenario, refs) {
-  const tags = scenario.tags ?? [];
-  return refs.some(
-    (ref) => scenario.id === ref || scenario.title === ref || tags.includes(ref)
-  );
-}
-function computeCoverage(endpoints, scenarios) {
-  return endpoints.map((endpoint) => {
-    const refs = endpointRefs(endpoint);
-    const matched = scenarios.filter((s) => scenarioMatchesEndpoint(s, refs));
-    let status;
-    if (matched.length === 0) status = "uncovered";
-    else if (matched.some((s) => s.status === "failed")) status = "failing";
-    else status = "covered";
-    return {
-      endpoint,
-      status,
-      stories: matched.map((s) => ({
-        id: s.id ?? s.title ?? "",
-        title: s.title ?? s.id ?? "story",
-        status: s.status ?? "passed"
-      }))
-    };
-  });
-}
-function slug(input) {
-  return input.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "") || "api";
-}
-function yamlQuote(value) {
-  return value.replace(/'/g, "''");
-}
-function coverageSummary(rows) {
-  return {
-    total: rows.length,
-    covered: rows.filter((r) => r.status === "covered").length,
-    failing: rows.filter((r) => r.status === "failing").length,
-    uncovered: rows.filter((r) => r.status === "uncovered").length
-  };
-}
-function renderTagPage(tag, rows, hasRun) {
-  const endpoints = rows.map((r) => ({
-    method: r.endpoint.method,
-    path: r.endpoint.path,
-    summary: r.endpoint.summary || "",
-    status: r.status,
-    stories: r.stories
-  }));
-  const summary = coverageSummary(rows);
-  return `---
-title: 'API \u2014 ${yamlQuote(tag)}'
-description: 'Endpoints for ${yamlQuote(tag)}, linked to the stories that exercise them.'
----
-
-import ApiOperations from 'executable-stories-astro/components/ApiOperations.astro';
-
-<ApiOperations
-  tag={${JSON.stringify(tag)}}
-  hasRun={${hasRun}}
-  summary={${JSON.stringify(summary)}}
-  endpoints={${JSON.stringify(endpoints)}}
-/>
-`;
-}
-function renderIndex(groups, hasRun, totals2) {
-  const rows = [...groups.entries()].map(([tag, eps]) => {
-    const covered = eps.filter((e) => e.status === "covered").length;
-    const cov = hasRun ? ` | ${covered}/${eps.length} covered` : "";
-    return `- [${tag}](./${slug(tag)}/) \u2014 ${eps.length} endpoint(s)${cov}`;
-  }).join("\n");
-  const coverageNote = hasRun ? `
-**${totals2.coveredCount} of ${totals2.endpointCount} endpoints** are covered by a passing story.` + (totals2.uncoveredCount > 0 ? ` \u26A0 ${totals2.uncoveredCount} endpoint(s) have no verifying test.` : "") : "\nRe-run with `--run <story-report.json>` to show per-endpoint test coverage.";
-  return `---
-title: 'API reference'
-description: 'API endpoints generated from OpenAPI, linked to verifying stories.'
----
-
-${coverageNote}
-
-${rows}
-`;
-}
-async function importOpenApi(options) {
-  const spec = parseSpec(options.specPath);
-  const endpoints = extractEndpoints(spec);
-  if (endpoints.length === 0) {
-    throw new Error(`No endpoints found in ${options.specPath} (expected an OpenAPI "paths" object).`);
-  }
-  const scenarios = loadScenarios(options.runFile);
-  const hasRun = Boolean(options.runFile);
-  const coverage = computeCoverage(endpoints, scenarios);
-  const groups = /* @__PURE__ */ new Map();
-  for (const item of coverage) {
-    const list = groups.get(item.endpoint.tag) ?? [];
-    list.push(item);
-    groups.set(item.endpoint.tag, list);
-  }
-  const outputDir = options.outputDir ?? path7.join("src", "content", "docs", "api");
-  if (fs6.existsSync(outputDir) && !options.force) {
-    const entries = fs6.readdirSync(outputDir);
-    if (entries.length > 0) {
-      throw new Error(`Output directory "${outputDir}" is not empty. Use --force to overwrite.`);
-    }
-  }
-  fs6.mkdirSync(outputDir, { recursive: true });
-  const coveredCount = coverage.filter((c) => c.status === "covered").length;
-  const uncoveredCount = coverage.filter((c) => c.status === "uncovered").length;
-  fs6.writeFileSync(
-    path7.join(outputDir, "index.mdx"),
-    renderIndex(groups, hasRun, { endpointCount: endpoints.length, coveredCount, uncoveredCount }),
-    "utf8"
-  );
-  for (const [tag, rows] of groups) {
-    const dir = path7.join(outputDir, slug(tag));
-    fs6.mkdirSync(dir, { recursive: true });
-    fs6.writeFileSync(path7.join(dir, "index.mdx"), renderTagPage(tag, rows, hasRun), "utf8");
-  }
-  return {
-    outputDir,
-    pageCount: groups.size + 1,
-    endpointCount: endpoints.length,
-    coveredCount,
-    uncoveredCount
-  };
-}
-
 // src/index.ts
-import * as path17 from "path";
+import * as path16 from "path";
 import * as fsPromises3 from "fs/promises";
 import { canonicalizeRun as canonicalizeRun2 } from "executable-stories-core/converters/acl/canonicalize";
 
@@ -3979,8 +3870,8 @@ import { assertNever } from "executable-stories-core/utils/assert-never";
 import { behaviourFingerprint as behaviourFingerprint2, behaviourSimilarity as behaviourSimilarity2 } from "executable-stories-core/converters/acl/ids";
 
 // src/sync/lockfile.ts
-import * as fs7 from "fs";
-import * as path8 from "path";
+import * as fs6 from "fs";
+import * as path7 from "path";
 import { createHash } from "crypto";
 var DEFAULT_LOCKFILE_PATH = ".executable-stories/sync.lock.json";
 var LOCKFILE_VERSION = 1;
@@ -5562,14 +5453,14 @@ function selectTestCases(args, deps) {
 }
 
 // src/watch.ts
-import * as fs12 from "fs";
-import * as path15 from "path";
+import * as fs11 from "fs";
+import * as path14 from "path";
 import { canonicalizeRun } from "executable-stories-core/converters/acl/canonicalize";
 import { synthesizeStories } from "executable-stories-core/converters/synthesize";
 
 // src/report-generator.ts
-import * as path14 from "path";
-import * as fs11 from "fs";
+import * as path13 from "path";
+import * as fs10 from "fs";
 import * as fsPromises2 from "fs/promises";
 import { toStoryReportWithIndex } from "executable-stories-core/converters/story-report";
 
@@ -6599,9 +6490,9 @@ var MAX_FUZZ = 2;
 var normalize = (line) => line.trim();
 var HUNK_HEADER = /^@@ -(\d+)(?:,(\d+))? \+(\d+)(?:,(\d+))? @@ ?(.*)$/;
 function stripPathPrefix(raw) {
-  const path26 = raw.split("	")[0].trim();
-  if (path26 === "/dev/null") return void 0;
-  return path26.replace(/^[ab]\//, "");
+  const path23 = raw.split("	")[0].trim();
+  if (path23 === "/dev/null") return void 0;
+  return path23.replace(/^[ab]\//, "");
 }
 function parseUnifiedDiff(patch) {
   const files = [];
@@ -6681,7 +6572,7 @@ function createAnchor(args) {
   };
 }
 function changedRunCandidates(anchor, file, fileIndex) {
-  const path26 = file.newPath ?? file.oldPath ?? "";
+  const path23 = file.newPath ?? file.oldPath ?? "";
   const out = [];
   file.hunks.forEach((hunk, hunkIndex) => {
     outer: for (let i = 0; i + anchor.changed.length <= hunk.lines.length; i++) {
@@ -6692,7 +6583,7 @@ function changedRunCandidates(anchor, file, fileIndex) {
           continue outer;
         }
       }
-      out.push({ fileIndex, file: path26, hunkIndex, lineIndex: i, lines: hunk.lines });
+      out.push({ fileIndex, file: path23, hunkIndex, lineIndex: i, lines: hunk.lines });
     }
   });
   return out;
@@ -6789,18 +6680,18 @@ function deriveChangeType(tags) {
   }
   return "unknown";
 }
-function extensionOf(path26) {
-  const base = path26.split("/").pop() ?? path26;
+function extensionOf(path23) {
+  const base = path23.split("/").pop() ?? path23;
   const dot = base.lastIndexOf(".");
   return dot === -1 ? "" : base.slice(dot + 1).toLowerCase();
 }
-function isTestFile(path26) {
-  return TEST_INFIX.test(path26);
+function isTestFile(path23) {
+  return TEST_INFIX.test(path23);
 }
-function isReviewableSource(path26) {
-  if (isTestFile(path26)) return false;
-  if (path26.endsWith(".d.ts")) return false;
-  return CODE_EXTENSIONS.has(extensionOf(path26));
+function isReviewableSource(path23) {
+  if (isTestFile(path23)) return false;
+  if (path23.endsWith(".d.ts")) return false;
+  return CODE_EXTENSIONS.has(extensionOf(path23));
 }
 function testBaseKey(testFile) {
   return testFile.replace(TEST_INFIX, "");
@@ -6910,7 +6801,7 @@ function toClaim(testCase, changedSourcePaths) {
   const { strength, reasons } = gradeEvidence(testCase, audience);
   const key = testBaseKey(testCase.sourceFile);
   const coversFiles = changedSourcePaths.filter(
-    (path26) => sourceBaseKey(path26) === key
+    (path23) => sourceBaseKey(path23) === key
   );
   return {
     id: testCase.id,
@@ -7011,6 +6902,61 @@ function buildReview(run, context = { changedFiles: [] }) {
     codeDiffs: (context.codeDiffs ?? []).map((d) => buildCodeDiff(d, run, context))
   };
 }
+var REVIEW_CHANGE_TYPE_MIN_CONFIDENCE = 0.6;
+var PATCH_EXCERPT_CHARS = 4e3;
+var CHANGE_TYPE_CRITERIA = {
+  feature: "new user-visible behaviour or capability",
+  bugfix: "corrects behaviour that was wrong",
+  refactor: "restructures code without changing behaviour",
+  perf: "same behaviour, faster or cheaper",
+  deps: "dependency, toolchain, or lockfile change"
+};
+async function enrichReview(review, jev) {
+  const untagged = review.claims.filter((c) => c.changeType === "unknown" && c.coversFiles.length > 0);
+  if (untagged.length === 0) return review;
+  const hunksByPath = /* @__PURE__ */ new Map();
+  for (const group of review.context.codeDiffs ?? []) {
+    for (const file of parseUnifiedDiff(group.patch)) {
+      const path23 = file.newPath ?? file.oldPath;
+      if (!path23) continue;
+      const text2 = file.hunks.flatMap((h) => h.lines.map((l) => (l.kind === "add" ? "+" : l.kind === "del" ? "-" : " ") + l.text));
+      hunksByPath.set(path23, [...hunksByPath.get(path23) ?? [], ...text2]);
+    }
+  }
+  const inferred = /* @__PURE__ */ new Map();
+  await Promise.all(
+    untagged.map(async (claim) => {
+      const patch = claim.coversFiles.flatMap((f) => hunksByPath.get(f) ?? []).join("\n").slice(0, PATCH_EXCERPT_CHARS);
+      const answers = await jev.ask(
+        {
+          scenario: claim.scenario,
+          steps: claim.testCase.story.steps.map((s) => `${s.keyword} ${s.text}`),
+          ...claim.intent ? { intent: claim.intent } : {},
+          changedFiles: claim.coversFiles,
+          ...patch ? { patch } : {}
+        },
+        {
+          changeType: {
+            type: "choice",
+            instructions: "What kind of change does this scenario prove?",
+            criteria: CHANGE_TYPE_CRITERIA
+          }
+        }
+      );
+      const answer = asChoice(answers.changeType);
+      if (!answer || answer.confidence < REVIEW_CHANGE_TYPE_MIN_CONFIDENCE) return;
+      const changeType = answer.choice;
+      if (VALID_CHANGE_TYPES.has(changeType)) inferred.set(claim.id, { changeType, confidence: answer.confidence });
+    })
+  );
+  return {
+    ...review,
+    claims: review.claims.map((claim) => {
+      const hit = inferred.get(claim.id);
+      return hit ? { ...claim, changeType: hit.changeType, changeTypeConfidence: hit.confidence } : claim;
+    })
+  };
+}
 function codeDiffDiagnostics(review) {
   const issues = [];
   for (const evidence of review.codeDiffs) {
@@ -7082,14 +7028,14 @@ var TraceabilityMatrixFormatter = class {
       lines.push("");
       lines.push(`Status: ${renderRequirementStatus(req.status)}`);
       if (req.covers.length > 0) {
-        lines.push(`Covers: ${req.covers.map((path26) => `\`${path26}\``).join(", ")}`);
+        lines.push(`Covers: ${req.covers.map((path23) => `\`${path23}\``).join(", ")}`);
       }
       lines.push("");
       lines.push("| Status | Scenario | Source | Covers |");
       lines.push("| --- | --- | --- | --- |");
       for (const scenario of req.scenarios) {
         const source = `${scenario.sourceFile}:${scenario.sourceLine}`;
-        const covers = scenario.covers.length > 0 ? scenario.covers.map((path26) => `\`${path26}\``).join(", ") : "";
+        const covers = scenario.covers.length > 0 ? scenario.covers.map((path23) => `\`${path23}\``).join(", ") : "";
         lines.push(`| ${scenario.status} | ${escapePipe2(scenario.title)} | \`${source}\` | ${covers} |`);
       }
       lines.push("");
@@ -7863,8 +7809,8 @@ function extractDocAttachments(step) {
   }
   return attachments;
 }
-function guessMediaType(path26) {
-  const lower = path26.toLowerCase();
+function guessMediaType(path23) {
+  const lower = path23.toLowerCase();
   if (lower.endsWith(".png")) return "image/png";
   if (lower.endsWith(".jpg") || lower.endsWith(".jpeg")) return "image/jpeg";
   if (lower.endsWith(".gif")) return "image/gif";
@@ -8005,11 +7951,11 @@ var CucumberHtmlFormatter = class {
     for (const envelope of envelopes) {
       const accepted = htmlStream.write(envelope);
       if (!accepted) {
-        await new Promise((resolve13) => htmlStream.once("drain", resolve13));
+        await new Promise((resolve12) => htmlStream.once("drain", resolve12));
       }
     }
-    await new Promise((resolve13, reject) => {
-      collector.on("finish", resolve13);
+    await new Promise((resolve12, reject) => {
+      collector.on("finish", resolve12);
       collector.on("error", reject);
       htmlStream.end();
     });
@@ -8018,7 +7964,7 @@ var CucumberHtmlFormatter = class {
 };
 
 // src/colocated-index.ts
-import path9 from "path";
+import path8 from "path";
 import { REPORT_FAVICON_LINK as REPORT_FAVICON_LINK3 } from "executable-stories-core/utils/report-favicon";
 function escapeHtml3(value) {
   return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
@@ -8039,7 +7985,7 @@ function buildIndexEntries(run, reportsBySourceFile, indexDir) {
       const key = bucket(tc.status);
       if (key) counts[key] += 1;
     }
-    const href = path9.relative(indexDir, reportPath).split(path9.sep).join("/");
+    const href = path8.relative(indexDir, reportPath).split(path8.sep).join("/");
     entries.push({ href, sourceFile, counts });
   }
   return entries.sort((a, b) => {
@@ -8113,7 +8059,7 @@ ${REPORT_FAVICON_LINK3}
 }
 
 // src/file-reports.ts
-import path10 from "path";
+import path9 from "path";
 import * as fsPromises from "fs/promises";
 var BY_FILE_DIR = "by-file";
 function reportSourceFile(report) {
@@ -8132,14 +8078,14 @@ function toPosix(p) {
   return p.replace(/\\/g, "/");
 }
 function byFileDirFor(outputDir) {
-  return path10.posix.join(outputDir.replace(/\\/g, "/"), BY_FILE_DIR);
+  return path9.posix.join(outputDir.replace(/\\/g, "/"), BY_FILE_DIR);
 }
 function readFileReports(dir, deps) {
   const names = deps.listDir(dir);
   if (!names) return [];
   const reports = [];
   for (const name of names.filter((n) => n.endsWith(".json")).sort()) {
-    const filePath = path10.posix.join(dir, name);
+    const filePath = path9.posix.join(dir, name);
     try {
       const parsed = JSON.parse(deps.readFile(filePath));
       if (Array.isArray(parsed?.testCases) && reportSourceFile(parsed)) {
@@ -8204,7 +8150,7 @@ async function updateFileReports(args, deps) {
       deps
     );
     await deps.writeFile(
-      path10.posix.join(dir, reportFileNameFor(sourceFile)),
+      path9.posix.join(dir, reportFileNameFor(sourceFile)),
       `${JSON.stringify(report, null, 2)}
 `
     );
@@ -8233,7 +8179,7 @@ async function removeReportsFor(args, deps) {
 async function removeOtherReportsFor(args, deps) {
   for (const name of deps.listDir(args.dir) ?? []) {
     if (!name.endsWith(".json") || name === args.keep) continue;
-    const filePath = path10.posix.join(args.dir, name);
+    const filePath = path9.posix.join(args.dir, name);
     try {
       const other = JSON.parse(deps.readFile(filePath));
       if (reportSourceFile(other) !== args.sourceFile) continue;
@@ -8270,14 +8216,14 @@ function warnAboutUnreported(args, deps) {
   );
 }
 function prunable(args, deps) {
-  const resolve13 = (sourceFile) => path10.resolve(args.projectRoot, sourceFile);
+  const resolve12 = (sourceFile) => path9.resolve(args.projectRoot, sourceFile);
   const canResolveSources = args.ran.some(
-    (sourceFile) => deps.fileExists(resolve13(sourceFile))
+    (sourceFile) => deps.fileExists(resolve12(sourceFile))
   );
   if (!canResolveSources) return [];
   const ran = new Set(args.ran);
   return args.stored.filter(
-    (sourceFile) => !ran.has(sourceFile) && !deps.fileExists(resolve13(sourceFile))
+    (sourceFile) => !ran.has(sourceFile) && !deps.fileExists(resolve12(sourceFile))
   );
 }
 
@@ -8797,25 +8743,25 @@ function groupBy3(items, keyFn) {
 }
 
 // src/formatters/astro-assets.ts
-import * as fs9 from "fs";
-import * as path12 from "path";
-
-// src/bundler/copy-asset.ts
 import * as fs8 from "fs";
 import * as path11 from "path";
+
+// src/bundler/copy-asset.ts
+import * as fs7 from "fs";
+import * as path10 from "path";
 import * as crypto from "crypto";
 function copyAsset(sourcePath, assetsDir) {
-  if (!fs8.existsSync(assetsDir)) {
-    fs8.mkdirSync(assetsDir, { recursive: true });
+  if (!fs7.existsSync(assetsDir)) {
+    fs7.mkdirSync(assetsDir, { recursive: true });
   }
-  const content = fs8.readFileSync(sourcePath);
+  const content = fs7.readFileSync(sourcePath);
   const hash = crypto.createHash("sha256").update(content).digest("hex").slice(0, 8);
-  const ext = path11.extname(sourcePath);
-  const baseName = sanitize(path11.basename(sourcePath, ext));
+  const ext = path10.extname(sourcePath);
+  const baseName = sanitize(path10.basename(sourcePath, ext));
   const destName = `${baseName}-${hash}${ext}`;
-  const destPath = path11.join(assetsDir, destName);
-  if (!fs8.existsSync(destPath)) {
-    fs8.copyFileSync(sourcePath, destPath);
+  const destPath = path10.join(assetsDir, destName);
+  if (!fs7.existsSync(destPath)) {
+    fs7.copyFileSync(sourcePath, destPath);
   }
   return `assets/${destName}`;
 }
@@ -8831,7 +8777,7 @@ function isRemoteRef(src) {
 }
 function isAbsoluteRef(src) {
   const trimmed = src.trim();
-  return path12.posix.isAbsolute(trimmed) || path12.win32.isAbsolute(trimmed);
+  return path11.posix.isAbsolute(trimmed) || path11.win32.isAbsolute(trimmed);
 }
 function isRelativeLocalPath(src) {
   return !isRemoteRef(src) && !isAbsoluteRef(src);
@@ -8921,8 +8867,8 @@ function copyMarkdownAssets(options) {
   const pathMap = /* @__PURE__ */ new Map();
   const missing = [];
   for (const ref of refs) {
-    const absPath = isAbsoluteRef(ref) ? ref : path12.resolve(markdownDir, ref);
-    if (!fs9.existsSync(absPath)) {
+    const absPath = isAbsoluteRef(ref) ? ref : path11.resolve(markdownDir, ref);
+    if (!fs8.existsSync(absPath)) {
       if (isAbsoluteRef(ref)) continue;
       if (!allowMissing) {
         throw new Error(`Asset not found: ${absPath}`);
@@ -8944,8 +8890,8 @@ function copyMarkdownAssets(options) {
 }
 
 // src/bundler/bundle-assets.ts
-import * as fs10 from "fs";
-import * as path13 from "path";
+import * as fs9 from "fs";
+import * as path12 from "path";
 
 // src/bundler/scan-html-assets.ts
 function scanHtmlAssets(html) {
@@ -8977,15 +8923,15 @@ function isLocalAssetRef(ref) {
 
 // src/bundler/bundle-assets.ts
 function bundleAssets(htmlPath, options = {}) {
-  const htmlDir = path13.dirname(htmlPath);
-  const assetsDir = path13.join(htmlDir, "assets");
-  let html = fs10.readFileSync(htmlPath, "utf8");
+  const htmlDir = path12.dirname(htmlPath);
+  const assetsDir = path12.join(htmlDir, "assets");
+  let html = fs9.readFileSync(htmlPath, "utf8");
   const refs = scanHtmlAssets(html);
   let copiedCount = 0;
   const missing = [];
   for (const ref of refs) {
-    const absolutePath = path13.resolve(htmlDir, ref);
-    if (!fs10.existsSync(absolutePath)) {
+    const absolutePath = path12.resolve(htmlDir, ref);
+    if (!fs9.existsSync(absolutePath)) {
       missing.push(ref);
       continue;
     }
@@ -8999,7 +8945,7 @@ function bundleAssets(htmlPath, options = {}) {
       `Missing asset${missing.length > 1 ? "s" : ""}: ${missing.join(", ")}`
     );
   }
-  fs10.writeFileSync(htmlPath, html, "utf8");
+  fs9.writeFileSync(htmlPath, html, "utf8");
   return {
     copiedCount,
     missingCount: missing.length,
@@ -9098,11 +9044,11 @@ function computeOutputPath(sourceFile, format, mode, colocatedStyle, baseOutputD
   const ext = FORMAT_EXTENSIONS[format];
   const effectiveName = outputName + (outputNameSuffix ?? "");
   if (mode === "aggregated") {
-    return toPosix2(path14.join(baseOutputDir, joinNameAndExt(effectiveName, ext)));
+    return toPosix2(path13.join(baseOutputDir, joinNameAndExt(effectiveName, ext)));
   }
   const normalizedSource = toPosix2(sourceFile);
-  const dirOfSource = path14.posix.dirname(normalizedSource);
-  let baseName = path14.posix.basename(normalizedSource);
+  const dirOfSource = path13.posix.dirname(normalizedSource);
+  let baseName = path13.posix.basename(normalizedSource);
   for (const testExt of TEST_EXTENSIONS) {
     if (baseName.endsWith(testExt)) {
       baseName = baseName.slice(0, -testExt.length);
@@ -9111,12 +9057,12 @@ function computeOutputPath(sourceFile, format, mode, colocatedStyle, baseOutputD
   }
   const fileName = `${baseName}.${effectiveName}${ext}`;
   if (colocatedStyle === "adjacent") {
-    return toPosix2(path14.posix.join(dirOfSource, fileName));
+    return toPosix2(path13.posix.join(dirOfSource, fileName));
   }
   if (colocatedStyle === "flat") {
-    return toPosix2(path14.posix.join(baseOutputDir, `${cleanTestStem(normalizedSource)}${ext}`));
+    return toPosix2(path13.posix.join(baseOutputDir, `${cleanTestStem(normalizedSource)}${ext}`));
   }
-  return toPosix2(path14.posix.join(baseOutputDir, dirOfSource, fileName));
+  return toPosix2(path13.posix.join(baseOutputDir, dirOfSource, fileName));
 }
 function groupTestCasesByOutput(testCases, format, options, logger, outputNameSuffix) {
   const groups = /* @__PURE__ */ new Map();
@@ -9202,15 +9148,15 @@ var ReportGenerator = class {
     this.deps = {
       logger: deps?.logger ?? console,
       writeFile: deps?.writeFile ?? ((p, c) => fsPromises2.writeFile(p, c, "utf8")),
-      readFile: deps?.readFile ?? ((p) => fs11.readFileSync(p, "utf8")),
+      readFile: deps?.readFile ?? ((p) => fs10.readFileSync(p, "utf8")),
       listDir: deps?.listDir ?? ((dir) => {
         try {
-          return fs11.readdirSync(dir);
+          return fs10.readdirSync(dir);
         } catch {
           return void 0;
         }
       }),
-      fileExists: deps?.fileExists ?? ((p) => fs11.existsSync(p)),
+      fileExists: deps?.fileExists ?? ((p) => fs10.existsSync(p)),
       removeFile: deps?.removeFile ?? ((p) => fsPromises2.rm(p, { force: true }))
     };
   }
@@ -9396,12 +9342,12 @@ var ReportGenerator = class {
         }
       }
       await this.bundleMarkdownAssets(results.get("markdown"), (markdownDir) => ({
-        assetsDir: path14.join(markdownDir, "assets"),
+        assetsDir: path13.join(markdownDir, "assets"),
         assetsBaseUrl: "assets"
       }));
       await this.bundleMarkdownAssets(results.get("astro-markdown"), () => ({
         // assetsDir is resolved from CWD (same as outputDir), not relative to outputDir
-        assetsDir: path14.resolve(this.options.astro.assetsDir),
+        assetsDir: path13.resolve(this.options.astro.assetsDir),
         assetsBaseUrl: this.options.astro.assetsBaseUrl
       }));
     }
@@ -9416,7 +9362,7 @@ var ReportGenerator = class {
     if (!markdownPaths) return;
     for (const markdownPath of markdownPaths) {
       const markdown = await fsPromises2.readFile(markdownPath, "utf8");
-      const markdownDir = path14.dirname(markdownPath);
+      const markdownDir = path13.dirname(markdownPath);
       const result = copyMarkdownAssets({
         markdown,
         markdownDir,
@@ -9460,16 +9406,16 @@ var ReportGenerator = class {
       bySourceFile.set(sourceFile, outputPath);
     }
     if (bySourceFile.size === 0) return void 0;
-    const indexPath = toPosix2(path14.join(this.options.outputDir, "index.html"));
+    const indexPath = toPosix2(path13.join(this.options.outputDir, "index.html"));
     if (htmlPaths.some((p) => toPosix2(p) === indexPath)) {
       this.deps.logger.warn?.(
         `Skipping colocated index: a report already occupies ${indexPath}.`
       );
       return void 0;
     }
-    const entries = buildIndexEntries(run, bySourceFile, path14.dirname(indexPath));
+    const entries = buildIndexEntries(run, bySourceFile, path13.dirname(indexPath));
     const html = renderColocatedIndex(entries, this.options.html.title);
-    await fsPromises2.mkdir(path14.dirname(indexPath), { recursive: true });
+    await fsPromises2.mkdir(path13.dirname(indexPath), { recursive: true });
     await this.deps.writeFile(indexPath, html);
     return indexPath;
   }
@@ -9488,10 +9434,10 @@ var ReportGenerator = class {
     if (groups.size === 0 && this.options.output.mode === "aggregated") {
       const ext = FORMAT_EXTENSIONS[format];
       const effectiveName = this.options.outputName + (outputNameSuffix ?? "");
-      const outputPath = toPosix2(path14.join(this.options.outputDir, joinNameAndExt(effectiveName, ext)));
+      const outputPath = toPosix2(path13.join(this.options.outputDir, joinNameAndExt(effectiveName, ext)));
       const content = await this.formatContent(run, format, outputPath);
       if (content === "" && SKIP_WHEN_EMPTY.has(format)) return [];
-      const dir = path14.dirname(outputPath);
+      const dir = path13.dirname(outputPath);
       await fsPromises2.mkdir(dir, { recursive: true });
       await this.deps.writeFile(outputPath, content);
       return [outputPath];
@@ -9504,7 +9450,7 @@ var ReportGenerator = class {
       };
       const content = await this.formatContent(groupRun, format, outputPath);
       if (content === "" && SKIP_WHEN_EMPTY.has(format)) continue;
-      const dir = path14.dirname(outputPath);
+      const dir = path13.dirname(outputPath);
       await fsPromises2.mkdir(dir, { recursive: true });
       await this.deps.writeFile(outputPath, content);
       writtenPaths.push(outputPath);
@@ -9701,8 +9647,8 @@ function toRun(data, inputType, synthesize) {
   return canonicalizeRun(raw);
 }
 async function regenerateRun(options, deps = {}) {
-  const read = deps.readFile ?? ((filePath) => fs12.readFileSync(filePath, "utf8"));
-  const data = JSON.parse(read(path15.resolve(options.input)));
+  const read = deps.readFile ?? ((filePath) => fs11.readFileSync(filePath, "utf8"));
+  const data = JSON.parse(read(path14.resolve(options.input)));
   const run = toRun(data, options.inputType ?? "raw", options.synthesize !== false);
   const generator = new ReportGenerator({
     formats: options.formats,
@@ -9718,7 +9664,7 @@ async function regenerateArtifacts(options, deps = {}) {
 function startWatch(options, deps = {}) {
   const log = deps.log ?? ((message) => console.log(message));
   const regenerate = deps.regenerate ?? ((input) => regenerateArtifacts({ ...options, input }, deps));
-  const watchFn = deps.watch ?? ((filePath, listener) => fs12.watch(filePath, listener));
+  const watchFn = deps.watch ?? ((filePath, listener) => fs11.watch(filePath, listener));
   const debounceMs = options.debounceMs ?? 150;
   let timer;
   let running = false;
@@ -9747,7 +9693,7 @@ function startWatch(options, deps = {}) {
     timer = setTimeout(() => void run(), debounceMs);
   };
   trigger();
-  const watcher = watchFn(path15.resolve(options.input), trigger);
+  const watcher = watchFn(path14.resolve(options.input), trigger);
   return {
     close: () => {
       if (timer) clearTimeout(timer);
@@ -9760,7 +9706,7 @@ function startWatch(options, deps = {}) {
 import { advanceState, initialRunState } from "executable-stories-core";
 
 // src/runs-lifecycle.ts
-import path16 from "path";
+import path15 from "path";
 function relativeAge(thenMs, nowMs) {
   const deltaMs = Math.max(0, nowMs - thenMs);
   const minutes = Math.floor(deltaMs / 6e4);
@@ -9776,7 +9722,7 @@ function readFileReports2(dir, deps) {
   const files = [];
   const unreadable = [];
   for (const name of names) {
-    const filePath = path16.posix.join(dir, name);
+    const filePath = path15.posix.join(dir, name);
     try {
       const run = JSON.parse(deps.readFile(filePath));
       const testCases = run.testCases ?? [];
@@ -9837,7 +9783,7 @@ function runsStatus(args, deps) {
 function runsReset(args, deps) {
   const directory = byFileDirFor(args.outputDir);
   const names = (deps.listDir(directory) ?? []).filter((n) => n.endsWith(".json"));
-  for (const name of names) deps.removeFile(path16.posix.join(directory, name));
+  for (const name of names) deps.removeFile(path15.posix.join(directory, name));
   const text2 = names.length === 0 ? `Nothing to reset: no per-file reports in ${directory}.` : `Removed ${names.length} per-file report${names.length === 1 ? "" : "s"} from ${directory}.
 Run your full test suite to write them again.`;
   return { directory, removed: names.length, text: text2 };
@@ -10692,8 +10638,8 @@ function toRegExp(pattern) {
   const tail = body.endsWith("/") ? ".*" : "(/.*)?";
   return new RegExp(`^${floating ? "(.*/)?" : ""}${globbed}${tail}$`);
 }
-function ownersFor(rules, path26) {
-  const clean = path26.replace(/^\.\//, "").replace(/^\//, "");
+function ownersFor(rules, path23) {
+  const clean = path23.replace(/^\.\//, "").replace(/^\//, "");
   let owners = [];
   for (const rule of rules) {
     if (toRegExp(rule.pattern).test(clean)) owners = rule.owners;
@@ -10708,8 +10654,8 @@ function buildTriage(args, _deps = {}) {
     if (!codeowners) return [];
     const paths = tc.story.covers?.length ? tc.story.covers : [tc.sourceFile];
     const found = /* @__PURE__ */ new Set();
-    for (const path26 of paths) {
-      for (const owner of ownersFor(codeowners, path26)) found.add(owner);
+    for (const path23 of paths) {
+      for (const owner of ownersFor(codeowners, path23)) found.add(owner);
     }
     return [...found];
   };
@@ -10748,6 +10694,55 @@ function buildTriage(args, _deps = {}) {
     items
   };
 }
+var TRIAGE_SUGGEST_MIN_PROBABILITY = 0.5;
+var FAILURE_KIND_CRITERIA = {
+  product: "the application code under test behaves wrongly",
+  test: "the scenario, assertion, fixture, or test data is wrong or stale",
+  infra: "environment, network, timeout, resource, or flaky-timing failure"
+};
+async function enrichTriage(report, testCases, jev, codeowners) {
+  const candidates = new Set(testCases.flatMap((tc) => tc.story.covers ?? []));
+  for (const rule of codeowners ?? []) candidates.add(rule.pattern);
+  const criteria = Object.fromEntries([...candidates].map((path23) => [path23, null]));
+  const byId = new Map(testCases.map((tc) => [tc.id, tc]));
+  const items = await Promise.all(
+    report.items.map(async (item) => {
+      if (item.covers.length > 0) return item;
+      const tc = byId.get(item.id);
+      const answers = await jev.ask(
+        {
+          scenario: item.scenario,
+          steps: tc?.story.steps.map((s) => `${s.keyword} ${s.text}`) ?? [],
+          testFile: item.location,
+          error: item.errorMessage ?? null
+        },
+        {
+          kind: {
+            type: "choice",
+            instructions: "What is most likely broken, given this failing scenario and its error?",
+            criteria: FAILURE_KIND_CRITERIA
+          },
+          ...candidates.size > 0 ? {
+            covers: {
+              type: "choice",
+              instructions: "Which of these product paths does the fix for this failure most likely land in?",
+              criteria
+            }
+          } : {}
+        }
+      );
+      const kind = asChoice(answers.kind);
+      const covers = asChoice(answers.covers);
+      const probability = covers ? covers.probabilities[covers.choice] ?? 0 : 0;
+      return {
+        ...item,
+        ...kind && kind.choice in FAILURE_KIND_CRITERIA ? { failureKind: { kind: kind.choice, confidence: kind.confidence } } : {},
+        ...covers && probability >= TRIAGE_SUGGEST_MIN_PROBABILITY ? { suggestedCovers: { path: covers.choice, probability } } : {}
+      };
+    })
+  );
+  return { ...report, items };
+}
 function renderTriage(report, format, options = {}) {
   if (format === "json") return JSON.stringify(report, null, 2);
   if (report.items.length === 0) {
@@ -10765,9 +10760,14 @@ function renderTriage(report, format, options = {}) {
     }
     if (item.covers.length > 0) {
       lines.push(`   fix: ${item.covers.join(", ")}`);
+    } else if (item.suggestedCovers) {
+      lines.push(`   fix: ${item.suggestedCovers.path}? (jev ${item.suggestedCovers.probability.toFixed(2)}, no covers declared)`);
     } else {
       lines.push("   fix: (no covers declared \u2014 add `covers` to route this to code)");
     }
+    if (item.failureKind) {
+      lines.push(`   kind: ${item.failureKind.kind} (jev ${item.failureKind.confidence.toFixed(2)})`);
+    }
     if (item.tickets.length > 0) {
       lines.push(`   ticket: ${item.tickets.join(", ")}`);
     }
@@ -10971,7 +10971,7 @@ async function generateRunComparison(args) {
   await fsPromises3.mkdir(outputDir, { recursive: true });
   for (const format of args.formats) {
     const ext = format === "html" ? ".html" : format === "changelog" ? ".changelog.md" : ".md";
-    const outputPath = toPosix2(path17.join(outputDir, `${outputName}${ext}`));
+    const outputPath = toPosix2(path16.join(outputDir, `${outputName}${ext}`));
     const content = format === "html" ? new RunDiffHtmlFormatter({ title: args.title }).format(diff) : format === "changelog" ? new RunDiffChangelogFormatter().format(diff) : new RunDiffMarkdownFormatter({ title: args.title }).format(diff);
     await fsPromises3.writeFile(outputPath, content, "utf8");
     files.push(outputPath);
@@ -10979,119 +10979,9 @@ async function generateRunComparison(args) {
   return { files, diff };
 }
 
-// src/init-astro.ts
-import { spawnSync } from "child_process";
-import * as fs13 from "fs";
-import * as path18 from "path";
-import { fileURLToPath } from "url";
-var __dirname = path18.dirname(fileURLToPath(import.meta.url));
-function detectPackageManager(cwd = process.cwd()) {
-  if (fs13.existsSync(path18.join(cwd, "pnpm-lock.yaml"))) return "pnpm";
-  if (fs13.existsSync(path18.join(cwd, "yarn.lock"))) return "yarn";
-  if (fs13.existsSync(path18.join(cwd, "bun.lock")) || fs13.existsSync(path18.join(cwd, "bun.lockb"))) {
-    return "bun";
-  }
-  return "npm";
-}
-function runPackageManager(pm, pmArgs, cwd) {
-  const result = spawnSync(pm, pmArgs, {
-    cwd,
-    stdio: "inherit",
-    shell: process.platform === "win32"
-  });
-  return result.status;
-}
-function installScaffoldDependencies(targetDir, pm) {
-  return runPackageManager(pm, ["install"], targetDir) === 0;
-}
-function runDocsDev(siteDir) {
-  if (!isScaffoldedAstroSite(siteDir)) {
-    return { kind: "not-scaffolded" };
-  }
-  const pm = detectPackageManager();
-  if (!fs13.existsSync(path18.join(siteDir, "node_modules"))) {
-    console.log(`Installing docs site dependencies with ${pm}\u2026`);
-    if (!installScaffoldDependencies(siteDir, pm)) {
-      return { kind: "install-failed", pm };
-    }
-  }
-  console.log("Tip: run your tests in watch mode in another terminal \u2014 the site hot-reloads on every run.");
-  return { kind: "dev-exited", status: runPackageManager(pm, ["run", "dev"], siteDir) };
-}
-var SCAFFOLD_MARKER = "executable-stories.config.mjs";
-function isScaffoldedAstroSite(dir) {
-  return fs13.existsSync(path18.join(dir, SCAFFOLD_MARKER));
-}
-function initAstro(options = {}) {
-  const targetDir = options.targetDir ?? "./story-docs";
-  const force = options.force ?? false;
-  const update = options.update ?? false;
-  const templateDir = path18.resolve(__dirname, "..", "templates", "astro-thin");
-  if (!fs13.existsSync(templateDir)) {
-    throw new Error(
-      `Template directory not found at ${templateDir}. Ensure the package is installed correctly.`
-    );
-  }
-  if (update) {
-    return updateScaffoldDeps(templateDir, targetDir);
-  }
-  if (fs13.existsSync(targetDir)) {
-    const entries = fs13.readdirSync(targetDir);
-    if (entries.length > 0 && !force) {
-      throw new Error(
-        `Directory "${targetDir}" already exists and is not empty. Use --force to overlay the template (existing files are kept; same-path template files are overwritten), or --update to refresh framework files only.`
-      );
-    }
-  }
-  copyDirRecursive(templateDir, targetDir);
-  return { targetDir };
-}
-function updateScaffoldDeps(templateDir, targetDir) {
-  if (!isScaffoldedAstroSite(targetDir)) {
-    throw new Error(
-      `"${targetDir}" does not look like a scaffolded docs site. Run init-astro (without --update) first.`
-    );
-  }
-  mergeDependencies(templateDir, targetDir);
-  return { targetDir };
-}
-function mergeDependencies(templateDir, targetDir) {
-  const tmplPkgPath = path18.join(templateDir, "package.json");
-  const userPkgPath = path18.join(targetDir, "package.json");
-  if (!fs13.existsSync(tmplPkgPath) || !fs13.existsSync(userPkgPath)) return;
-  const tmpl = JSON.parse(fs13.readFileSync(tmplPkgPath, "utf8"));
-  const user = JSON.parse(fs13.readFileSync(userPkgPath, "utf8"));
-  user.dependencies = user.dependencies ?? {};
-  let changed = false;
-  for (const [name, version] of Object.entries(tmpl.dependencies ?? {})) {
-    if (!(name in user.dependencies)) {
-      user.dependencies[name] = version;
-      changed = true;
-    }
-  }
-  if (changed) {
-    fs13.writeFileSync(userPkgPath, `${JSON.stringify(user, null, 2)}
-`, "utf8");
-  }
-}
-function copyDirRecursive(src, dest) {
-  fs13.mkdirSync(dest, { recursive: true });
-  const entries = fs13.readdirSync(src, { withFileTypes: true });
-  for (const entry of entries) {
-    const srcPath = path18.join(src, entry.name);
-    const destName = entry.name === "gitignore" ? ".gitignore" : entry.name;
-    const destPath = path18.join(dest, destName);
-    if (entry.isDirectory()) {
-      copyDirRecursive(srcPath, destPath);
-    } else {
-      fs13.copyFileSync(srcPath, destPath);
-    }
-  }
-}
-
 // src/open-report.ts
 import { spawn } from "child_process";
-import path19 from "path";
+import path17 from "path";
 function openCommand(platform) {
   if (platform === "darwin") return { command: "open", args: [] };
   if (platform === "win32") return { command: "cmd", args: ["/c", "start", ""] };
@@ -11107,7 +10997,7 @@ function openInBrowser(file, platform = process.platform) {
   }
   const { command, args } = openCommand(platform);
   try {
-    const child = spawn(command, [...args, path19.resolve(file)], { stdio: "ignore", detached: true });
+    const child = spawn(command, [...args, path17.resolve(file)], { stdio: "ignore", detached: true });
     child.on("error", (err) => {
       console.error(`--open: could not open ${file}: ${err.message}`);
     });
@@ -11147,8 +11037,8 @@ function expandPreset(preset, explicitFormats, userSetFormat) {
 
 // src/push.ts
 import { execFileSync } from "child_process";
-import * as fs14 from "fs";
-import * as path20 from "path";
+import * as fs12 from "fs";
+import * as path18 from "path";
 import { parseArgs } from "util";
 import { canonicalizeRun as canonicalizeRun4 } from "executable-stories-core/converters/acl/canonicalize";
 import { toStoryReport as toStoryReport7 } from "executable-stories-core/converters/story-report";
@@ -11209,16 +11099,16 @@ the job summary, and the run id is written to GITHUB_OUTPUT as ingest-run-id.
 Exit codes: 0 pushed, 1 push rejected/failed, 4 usage error, 5 gate blocked.`;
 function defaultDeps() {
   return {
-    readFile: (filePath) => fs14.readFileSync(filePath, "utf8"),
+    readFile: (filePath) => fs12.readFileSync(filePath, "utf8"),
     listDir: (dirPath) => {
       try {
-        return fs14.readdirSync(dirPath);
+        return fs12.readdirSync(dirPath);
       } catch {
         return void 0;
       }
     },
-    appendFile: (filePath, text2) => fs14.appendFileSync(filePath, text2),
-    writeFile: (filePath, text2) => fs14.writeFileSync(filePath, text2, "utf8"),
+    appendFile: (filePath, text2) => fs12.appendFileSync(filePath, text2),
+    writeFile: (filePath, text2) => fs12.writeFileSync(filePath, text2, "utf8"),
     fetchFn: fetch,
     git: (args) => {
       try {
@@ -11249,7 +11139,7 @@ function readInput(inputPath, deps) {
   const entries = deps.listDir(inputPath);
   if (!entries) return deps.readFile(inputPath);
   const results = entries.filter((name) => name.endsWith("-result.json")).sort().map((name) => {
-    const file = path20.join(inputPath, name);
+    const file = path18.join(inputPath, name);
     try {
       return JSON.parse(deps.readFile(file));
     } catch (err) {
@@ -11732,8 +11622,8 @@ Release gate: clear for ${commit}`);
 }
 
 // src/share.ts
-import * as fs15 from "fs";
-import * as path21 from "path";
+import * as fs13 from "fs";
+import * as path19 from "path";
 import { parseArgs as parseArgs2 } from "util";
 import { canonicalizeRun as canonicalizeRun5 } from "executable-stories-core/converters/acl/canonicalize";
 import { collectReportAssets, rewriteReportAssets } from "executable-stories-core/report-assets";
@@ -11767,11 +11657,11 @@ Options:
 Exit codes: 0 shared, 1 rejected or failed, 4 usage error.`;
 function defaultDeps2() {
   return {
-    readFile: (filePath) => fs15.readFileSync(filePath, "utf8"),
-    readBinary: (filePath) => new Uint8Array(fs15.readFileSync(filePath)),
+    readFile: (filePath) => fs13.readFileSync(filePath, "utf8"),
+    readBinary: (filePath) => new Uint8Array(fs13.readFileSync(filePath)),
     fileSize: (filePath) => {
       try {
-        const stat = fs15.statSync(filePath);
+        const stat = fs13.statSync(filePath);
         return stat.isFile() ? stat.size : void 0;
       } catch {
         return void 0;
@@ -11779,7 +11669,7 @@ function defaultDeps2() {
     },
     listDir: (dirPath) => {
       try {
-        return fs15.readdirSync(dirPath);
+        return fs13.readdirSync(dirPath);
       } catch {
         return void 0;
       }
@@ -11807,11 +11697,11 @@ var CONTENT_TYPES = {
   ".zip": "application/zip"
 };
 function contentTypeFor(filePath) {
-  return CONTENT_TYPES[path21.extname(filePath).toLowerCase()] ?? "application/octet-stream";
+  return CONTENT_TYPES[path19.extname(filePath).toLowerCase()] ?? "application/octet-stream";
 }
 function resolveReport(inputPath, deps) {
   const entries = deps.listDir(inputPath);
-  const candidates = entries === void 0 ? [inputPath] : candidateNames(entries).map((name) => path21.join(inputPath, name));
+  const candidates = entries === void 0 ? [inputPath] : candidateNames(entries).map((name) => path19.join(inputPath, name));
   if (candidates.length === 0) {
     throw new Error(
       "no report in it. Generate one first: executable-stories format <run.json> --format story-report-json --output-dir <dir> --output-name index"
@@ -11860,12 +11750,12 @@ function asStoryReport(data, filePath) {
   }
 }
 function keyFor(assetPath, reportDir, taken) {
-  const resolved = path21.resolve(reportDir, assetPath);
-  const relative3 = path21.relative(reportDir, resolved);
-  const inside = relative3 !== "" && !relative3.startsWith("..") && !path21.isAbsolute(relative3);
-  const base = inside ? relative3.split(path21.sep).join("/") : `assets/${path21.basename(resolved)}`;
+  const resolved = path19.resolve(reportDir, assetPath);
+  const relative3 = path19.relative(reportDir, resolved);
+  const inside = relative3 !== "" && !relative3.startsWith("..") && !path19.isAbsolute(relative3);
+  const base = inside ? relative3.split(path19.sep).join("/") : `assets/${path19.basename(resolved)}`;
   let key = base;
-  const ext = path21.extname(base);
+  const ext = path19.extname(base);
   const stem = base.slice(0, base.length - ext.length);
   for (let n = 2; taken.has(key); n++) key = `${stem}-${n}${ext}`;
   taken.add(key);
@@ -11877,7 +11767,7 @@ function planAssets(report, reportDir, deps) {
   const keyByPath = /* @__PURE__ */ new Map();
   const taken = /* @__PURE__ */ new Set();
   for (const assetPath of collectReportAssets(report)) {
-    const localPath = path21.resolve(reportDir, assetPath);
+    const localPath = path19.resolve(reportDir, assetPath);
     const bytes = deps.fileSize(localPath);
     const key = keyFor(assetPath, reportDir, taken);
     keyByPath.set(assetPath, key);
@@ -11959,7 +11849,7 @@ async function runShare(rawArgs, depsOverride = {}) {
     deps.error(`Could not read ${inputPath}: ${err instanceof Error ? err.message : String(err)}`);
     return EXIT_USAGE2;
   }
-  const reportDir = path21.dirname(reportPath);
+  const reportDir = path19.dirname(reportPath);
   const { assets, missing, keyByPath } = planAssets(report, reportDir, deps);
   for (const assetPath of missing) {
     deps.error(`Warning: ${assetPath} is missing, so it will not be in the share.`);
@@ -12041,7 +11931,7 @@ async function runShare(rawArgs, depsOverride = {}) {
     return EXIT_SUCCESS2;
   }
   const withAssets = assets.length === 1 ? "1 asset" : `${assets.length} assets`;
-  deps.log(`Shared ${path21.basename(reportPath)} (${withAssets}):`);
+  deps.log(`Shared ${path19.basename(reportPath)} (${withAssets}):`);
   deps.log(`  ${created.url}`);
   deps.log(
     emails.length > 0 ? `  Only ${emails.join(", ")} can open it, after signing in.` : "  Anyone with the link can open it."
@@ -12050,13 +11940,13 @@ async function runShare(rawArgs, depsOverride = {}) {
 }
 
 // src/run-file.ts
-import fs16 from "fs";
-import path22 from "path";
+import fs14 from "fs";
+import path20 from "path";
 var DEFAULT_RUN_FILES = [".executable-stories/raw-run.json", "reports/raw-run.json"];
 var SUPPORTED_RAW_RUN_SCHEMA = 1;
 function findDefaultRunFile(cwd = process.cwd()) {
   for (const candidate of DEFAULT_RUN_FILES) {
-    if (fs16.existsSync(path22.resolve(cwd, candidate))) return candidate;
+    if (fs14.existsSync(path20.resolve(cwd, candidate))) return candidate;
   }
   return void 0;
 }
@@ -12082,8 +11972,8 @@ function diagnoseRunFile(file, cwd = process.cwd()) {
     });
     return { checks, healthy: false };
   }
-  const abs = path22.resolve(cwd, resolved);
-  if (!fs16.existsSync(abs)) {
+  const abs = path20.resolve(cwd, resolved);
+  if (!fs14.existsSync(abs)) {
     checks.push({
       label: "run file",
       status: "fail",
@@ -12092,7 +11982,7 @@ function diagnoseRunFile(file, cwd = process.cwd()) {
     });
     return { checks, healthy: false };
   }
-  const stat = fs16.statSync(abs);
+  const stat = fs14.statSync(abs);
   checks.push({
     label: "run file",
     status: "ok",
@@ -12100,7 +11990,7 @@ function diagnoseRunFile(file, cwd = process.cwd()) {
   });
   let parsed;
   try {
-    parsed = JSON.parse(fs16.readFileSync(abs, "utf8"));
+    parsed = JSON.parse(fs14.readFileSync(abs, "utf8"));
   } catch (err) {
     checks.push({
       label: "json",
@@ -12187,246 +12077,6 @@ function formatDoctorReport(report) {
   return lines.join("\n");
 }
 
-// src/scaffold-doc.ts
-import * as fs17 from "fs";
-import * as path23 from "path";
-var TEMPLATES = [
-  "adr",
-  "runbook",
-  "decision-log",
-  "incident",
-  "scenario-note"
-];
-function slugify2(input) {
-  return input.toLowerCase().trim().replace(/['"]/g, "").replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "") || "untitled";
-}
-function isoDate(today) {
-  return today.toISOString().slice(0, 10);
-}
-function nextSeq(dir) {
-  let max = 0;
-  try {
-    for (const entry of fs17.readdirSync(dir)) {
-      const match = /^(\d{1,4})-/.exec(entry);
-      if (match) max = Math.max(max, Number.parseInt(match[1], 10));
-    }
-  } catch {
-  }
-  return String(max + 1).padStart(4, "0");
-}
-var COMPONENTS = "../../../components";
-var TEMPLATE_SPECS = {
-  adr: {
-    subdir: "adr",
-    filename: (slug2, ctx) => `${ctx.seq}-${slug2}`,
-    content: (ctx) => `---
-title: 'ADR ${ctx.seq} \u2014 ${ctx.name}'
-description: '${ctx.name}'
-# Link the stories that prove this decision. The badge under the title turns
-# red the moment any of them fail, so this record can't drift from the code.
-verifiedBy: []
----
-
-## Status
-
-**Proposed** \u2014 proposed \xB7 accepted \xB7 superseded \xB7 deprecated
-
-## Context
-
-_What problem are we solving? What constraints and forces apply?_
-
-## Decision
-
-_What did we decide to do?_
-
-## Consequences
-
-_What becomes easier, and what becomes harder, as a result?_
-
-## Verified by
-
-Add the story ids or tags that exercise this decision to \`verifiedBy\` in the
-frontmatter above. Until you do, the badge reads **Unverified** \u2014 by design.
-`
-  },
-  runbook: {
-    subdir: "runbooks",
-    filename: (slug2) => slug2,
-    content: (ctx) => `---
-title: 'Runbook \u2014 ${ctx.name}'
-description: 'Operational runbook for ${ctx.name}'
----
-
-import Checklist from '${COMPONENTS}/Checklist.astro';
-import VerifiedStep from '${COMPONENTS}/VerifiedStep.astro';
-
-_When to use this runbook, prerequisites, and who to contact._
-
-## Steps
-
-Each step linked with \`story=\` shows a live green check when its test passed in
-the last run \u2014 so this runbook is trustworthy, not aspirational.
-
-<Checklist>
-  <VerifiedStep story="">Describe the first action, and link the story that verifies it.</VerifiedStep>
-  <VerifiedStep>A manual step with no automated check.</VerifiedStep>
-</Checklist>
-
-## Rollback
-
-_How to safely undo if something goes wrong._
-`
-  },
-  "decision-log": {
-    subdir: "decisions",
-    filename: (slug2) => slug2,
-    content: (ctx) => `---
-title: 'Decision log \u2014 ${ctx.name}'
-description: 'Running log of decisions for ${ctx.name}'
----
-
-A lightweight running log. For weightier decisions, scaffold a full ADR with
-\`executable-stories new adr\`.
-
-| Date | Decision | Owner | Verified by |
-| ---- | -------- | ----- | ----------- |
-| ${ctx.isoDate} | _What was decided_ | _Who_ | _story id or tag_ |
-`
-  },
-  incident: {
-    subdir: "incidents",
-    filename: (slug2, ctx) => `${ctx.isoDate}-${slug2}`,
-    content: (ctx) => `---
-title: 'Incident \u2014 ${ctx.name}'
-description: 'Post-mortem for ${ctx.name}'
-# Link the regression story added to stop this recurring.
-verifiedBy: []
----
-
-## Summary
-
-_What happened, who was affected, and for how long._
-
-## Timeline
-
-| Time | Event |
-| ---- | ----- |
-| ${ctx.isoDate} | Detected |
-
-## Root cause
-
-_The underlying cause, not just the trigger._
-
-## Resolution
-
-_How it was fixed._
-
-## Action items
-
-- [ ] Add a regression story and link it in \`verifiedBy\` so a silent recurrence
-  becomes a failing badge.
-`
-  },
-  "scenario-note": {
-    subdir: "notes",
-    filename: (_slug, ctx) => ctx.scenarioId ?? ctx.slug,
-    content: (ctx) => `---
-title: 'Business context \u2014 ${ctx.name}'
-description: 'Stakeholder context for ${ctx.name}'
-scenarioId: ${ctx.scenarioId}
-# Link this note back to the scenario it explains so the badge and explorer stay aligned.
-verifiedBy: [${ctx.scenarioId}]
----
-
-This page is hand-written commentary for a generated scenario. The generated
-stories render live from the run JSON, so this page is never overwritten.
-
-## Why this behavior matters
-
-_Describe the business rule, policy, customer promise, or operational nuance._
-
-## Caveats
-
-- _What readers should know when this scenario passes_
-- _Any assumptions, exclusions, or follow-up links_
-`
-  }
-};
-function isTemplateName(value) {
-  return TEMPLATES.includes(value);
-}
-function scaffoldDoc(options) {
-  const { template } = options;
-  if (!isTemplateName(template)) {
-    throw new Error(
-      `Unknown template "${template}". Available: ${TEMPLATES.join(", ")}.`
-    );
-  }
-  const spec = TEMPLATE_SPECS[template];
-  const baseDir = options.baseDir ?? path23.join("src", "content", "docs");
-  const today = options.today ?? /* @__PURE__ */ new Date();
-  const name = (options.name ?? "").trim() || defaultName(template);
-  const slug2 = slugify2(name);
-  const scenarioId = normalizeScenarioId(options.scenarioId);
-  const dir = path23.join(baseDir, spec.subdir);
-  if (template === "scenario-note" && !scenarioId) {
-    throw new Error(`Template "scenario-note" requires --scenario-id.`);
-  }
-  const ctx = {
-    name,
-    slug: slug2,
-    scenarioId,
-    isoDate: isoDate(today),
-    seq: nextSeq(dir)
-  };
-  const filename = `${spec.filename(slug2, ctx)}.mdx`;
-  const filePath = path23.join(dir, filename);
-  if (fs17.existsSync(filePath) && !options.force) {
-    throw new Error(
-      `File "${filePath}" already exists. Use --force to overwrite.`
-    );
-  }
-  fs17.mkdirSync(dir, { recursive: true });
-  fs17.writeFileSync(filePath, spec.content(ctx), "utf8");
-  return { template, path: filePath, title: titleFor2(template, ctx) };
-}
-function defaultName(template) {
-  switch (template) {
-    case "adr":
-      return "Untitled decision";
-    case "runbook":
-      return "Untitled runbook";
-    case "decision-log":
-      return "Decisions";
-    case "incident":
-      return "Untitled incident";
-    case "scenario-note":
-      return "Untitled scenario note";
-  }
-}
-function titleFor2(template, ctx) {
-  switch (template) {
-    case "adr":
-      return `ADR ${ctx.seq} \u2014 ${ctx.name}`;
-    case "runbook":
-      return `Runbook \u2014 ${ctx.name}`;
-    case "decision-log":
-      return `Decision log \u2014 ${ctx.name}`;
-    case "incident":
-      return `Incident \u2014 ${ctx.name}`;
-    case "scenario-note":
-      return `Business context \u2014 ${ctx.name}`;
-  }
-}
-function normalizeScenarioId(input) {
-  const value = input?.trim();
-  if (!value) return void 0;
-  if (value.includes("/") || value.includes("\\")) {
-    throw new Error(`scenarioId must not contain path separators.`);
-  }
-  return value;
-}
-
 // src/summary-line.ts
 function summaryLine(counts, files, durationMs, options = {}) {
   const { passed, failed, skipped, pending } = counts;
@@ -12456,8 +12106,8 @@ function summaryLine(counts, files, durationMs, options = {}) {
 }
 
 // src/sync/run.ts
-import * as fs18 from "fs";
-import * as path24 from "path";
+import * as fs15 from "fs";
+import * as path21 from "path";
 import { parseArgs as parseArgs3 } from "util";
 import { canonicalizeRun as canonicalizeRun6 } from "executable-stories-core/converters/acl/canonicalize";
 import { synthesizeStories as synthesizeStories4 } from "executable-stories-core/converters/synthesize";
@@ -12512,11 +12162,11 @@ pull request that created the case.
 Exit codes: 0 applied (or planned), 1 some writes failed, 4 usage error.`;
 function defaultDeps3() {
   return {
-    readFile: (filePath) => fs18.readFileSync(filePath, "utf8"),
-    fileExists: (filePath) => fs18.existsSync(filePath),
+    readFile: (filePath) => fs15.readFileSync(filePath, "utf8"),
+    fileExists: (filePath) => fs15.existsSync(filePath),
     writeFile: (filePath, contents) => {
-      fs18.mkdirSync(path24.dirname(path24.resolve(filePath)), { recursive: true });
-      fs18.writeFileSync(filePath, contents, "utf8");
+      fs15.mkdirSync(path21.dirname(path21.resolve(filePath)), { recursive: true });
+      fs15.writeFileSync(filePath, contents, "utf8");
     },
     fetchFn: globalThis.fetch,
     env: process.env,
@@ -12697,8 +12347,8 @@ async function runSyncCommand(mode, rawArgs, depsOverride = {}) {
     deps.error(`Could not read from ${providerName}: ${err instanceof Error ? err.message : String(err)}`);
     return EXIT_FAILED;
   }
-  const jsonPath = path24.join(outputDir, `sync-coverage.${providerName}.json`);
-  const markdownPath = path24.join(outputDir, `sync-coverage.${providerName}.md`);
+  const jsonPath = path21.join(outputDir, `sync-coverage.${providerName}.json`);
+  const markdownPath = path21.join(outputDir, `sync-coverage.${providerName}.md`);
   deps.writeFile(jsonPath, `${JSON.stringify(buildCoverageJson(analysis), null, 2)}
 `);
   deps.writeFile(markdownPath, `${renderCoverageMarkdown(analysis)}
@@ -13767,17 +13417,17 @@ function validateRawRun(data) {
     return { valid: true, errors: [] };
   }
   const errors = (validate.errors ?? []).map((err) => {
-    const path26 = err.instancePath || "/";
+    const path23 = err.instancePath || "/";
     const message = err.message ?? "unknown error";
     if (err.keyword === "additionalProperties") {
       const extra = err.params.additionalProperty;
-      return `${path26}: ${message} \u2014 '${extra}'`;
+      return `${path23}: ${message} \u2014 '${extra}'`;
     }
     if (err.keyword === "enum") {
       const allowed = err.params.allowedValues;
-      return `${path26}: ${message} \u2014 allowed: ${JSON.stringify(allowed)}`;
+      return `${path23}: ${message} \u2014 allowed: ${JSON.stringify(allowed)}`;
     }
-    return `${path26}: ${message}`;
+    return `${path23}: ${message}`;
   });
   return { valid: false, errors };
 }
@@ -13792,7 +13442,7 @@ import { toStoryReport as toStoryReport9 } from "executable-stories-core/convert
 function buildGhAttachCommand(args) {
   const assets = collectReportAssets2(toStoryReport9(args.run));
   if (assets.length === 0) return void 0;
-  const attachments = assets.map((path26) => `--attach '${path26}'`).join(" \\\n  ");
+  const attachments = assets.map((path23) => `--attach '${path23}'`).join(" \\\n  ");
   return `gh pr comment ${args.pr ?? "<number>"} --body-file ${args.bodyFile} \\
   ${attachments}`;
 }
@@ -13833,15 +13483,11 @@ USAGE
   executable-stories triage <file|directory> [--baseline <path|auto>] [--triage-format text|json] [--by-owner]
   executable-stories validate <file>
   executable-stories validate --stdin
-  executable-stories dev [directory]
-  executable-stories init-astro [directory] [--install] [--force] [--update]
-  executable-stories new <template> "<name>" [options]
   executable-stories check-links <dir> [options]
   executable-stories push <run.json|results.xml|allure-results/> [--format <fmt>] [--title <text>] [--env <name>] [--description <text|@file.md>] [--gate] [--force]
   executable-stories share <reports-dir|report.json> [--emails <a@b,c@d>] [--expires-days <n>]
   executable-stories coverage <testrail|xray> <run.json> [options]
   executable-stories sync <testrail|xray> <run.json> [--apply] [options]
-  executable-stories import-openapi <spec> [options]
   executable-stories publish-confluence <file.adf.json> [options]
   executable-stories publish-jira <file.adf.json> [options]
   executable-stories deploy record <file> --env <env> [--tag <tag>] [options]
@@ -13863,27 +13509,24 @@ SUBCOMMANDS
   doctor             Diagnose the run JSON: where it is, whether it parses, schema version vs this CLI, what it contains
   runs               Inspect or clear the accumulated run state: "runs status", "runs reset"
   completion         Output a shell completion script (bash, zsh, fish)
-  init-astro         Scaffold a thin Astro docs site (Starlight + executable-stories-astro; live stories at /stories)
-  new                Scaffold a docs page from a template (adr, runbook, decision-log, incident, scenario-note)
   check-links        Scan docs for broken internal/external links (CI-friendly exit code)
   push               Send a run to a cloud ingest endpoint: StoryReport, raw run, JUnit XML, Playwright JSON or allure-results
   share              Publish a report (with its screenshots and video) and print a link to it
   coverage           Compare your stories against a test-management system (read-only)
   sync               Push cases, executions, and evidence to TestRail or Xray (dry run by default)
-  import-openapi     Generate API doc pages from an OpenAPI spec, linked to verifying stories
   publish-confluence Publish an ADF JSON file to a Confluence page via REST API
   publish-jira       Publish an ADF JSON file to a Jira issue (as comment or description)
   deploy             Record deployments, show environment status, detect drift
 
 OPTIONS
   --format <formats>            Comma-separated formats: html, markdown, release-manifest, traceability-matrix, traceability-csv, junit, cucumber-json, cucumber-messages, cucumber-html, astro-markdown, confluence, story-report-json, scenario-index-json, behavior-manifest-json, agent-text, span-graph, or custom names from config (default: html)
-                                  astro-markdown    Starlight-flavored Markdown (single aggregated page; for a live site use "init-astro" + "astro dev")
+                                  astro-markdown    Starlight-flavored Markdown (single aggregated page)
                                   confluence        Atlassian Document Format (ADF) JSON for Confluence / Jira
                                   behavior-manifest-json Agent-readable behavior manifest and debugger warnings
                                   agent-text        Full run as flat token-lean plain text for pasting into an LLM
                                   span-graph        Architecture the run exercised, from its OTel spans, as mermaid.
                                                     Writes nothing when the run carries no spans
-                                  html              Standalone interactive HTML report, rendered via executable-stories-react (same component tree as the Astro site)
+                                  html              Standalone interactive HTML report, rendered via executable-stories-react
                                   cucumber-html     Official Cucumber HTML report
                                   markdown          Markdown documentation
                                   junit             JUnit XML
@@ -14007,6 +13650,14 @@ TRIAGE
   with no covers are flagged. --triage-format json emits the work queue. triage
   always exits 0 \u2014 it reports work, it does not gate.
 
+JEV (optional)
+  With JEV_API_KEY set, triage, goal, and review ask Jev (TypeSafe AI) the
+  bounded questions their rules leave blank: triage suggests a covers path and
+  a failure kind (product/test/infra) for unrouted failures; goal flags
+  rewritten scenarios that check less as advisories; review infers change-type
+  for claims with no change:* tag. Every answer carries its probability and
+  none of them changes an exit code. JEV_MODEL / JEV_ENDPOINT override defaults.
+
 COMPARE
   compare supports --format html,markdown,changelog
   changelog writes a release-notes-style behavior changelog (<output-name>.changelog.md)
@@ -14030,13 +13681,6 @@ DEPLOY
   executable-stories deploy diff <env-a> <env-b> [--ledger <path>]
     Show scenario drift between two environments (what's in one but not the other).
 
-INIT-ASTRO
-  executable-stories dev [directory]          Run the live docs site (default: ./story-docs); installs its deps on first use
-  executable-stories init-astro [directory]   Scaffold into directory (default: ./story-docs)
-    --install    Also run the package manager install (detected from your lockfile) so the site is ready to \`dev\`
-  --force                                      Write into a non-empty directory (overlays template files)
-  --update                                     Refresh framework files only (keeps your content + config)
-
 PUBLISH-CONFLUENCE
   executable-stories publish-confluence <file.adf.json> [options]
   --page-id <id>               Update an existing page (alternative to --space-id)
@@ -14183,19 +13827,9 @@ async function parseCliArgs(argv) {
     process.exit(EXIT_SUCCESS4);
   }
   const subcommand = args[0];
-  if (subcommand !== "format" && subcommand !== "watch" && subcommand !== "compare" && subcommand !== "gate-release" && subcommand !== "deploy" && subcommand !== "review" && subcommand !== "list" && subcommand !== "check" && subcommand !== "check-explainers" && subcommand !== "goal" && subcommand !== "triage" && subcommand !== "validate" && subcommand !== "doctor" && subcommand !== "completion" && subcommand !== "dev" && subcommand !== "init-astro" && subcommand !== "new" && subcommand !== "check-links" && subcommand !== "push" && subcommand !== "share" && subcommand !== "import-openapi" && subcommand !== "publish-confluence" && subcommand !== "publish-jira" && subcommand !== "sync" && subcommand !== "coverage" && subcommand !== "runs") {
-    if (subcommand === "serve" || subcommand === "build-docs") {
-      console.error(
-        `The "${subcommand}" subcommand was removed. Living docs are now an Astro site, rendered live from the run JSON (no Markdown generation step):
-  1. executable-stories init-astro --install   (one-time scaffold)
-  2. run your tests in watch mode in one terminal
-  3. run \`executable-stories dev\` in another \u2014 it hot-reloads the docs.
-See: https://github.com/jagreehal/executable-stories (executable-stories-astro).`
-      );
-      process.exit(EXIT_USAGE4);
-    }
+  if (subcommand !== "format" && subcommand !== "watch" && subcommand !== "compare" && subcommand !== "gate-release" && subcommand !== "deploy" && subcommand !== "review" && subcommand !== "list" && subcommand !== "check" && subcommand !== "check-explainers" && subcommand !== "goal" && subcommand !== "triage" && subcommand !== "validate" && subcommand !== "doctor" && subcommand !== "completion" && subcommand !== "check-links" && subcommand !== "push" && subcommand !== "share" && subcommand !== "publish-confluence" && subcommand !== "publish-jira" && subcommand !== "sync" && subcommand !== "coverage" && subcommand !== "runs") {
     console.error(
-      `Unknown subcommand: "${subcommand}". Use "format", "watch", "compare", "gate-release", "deploy", "review", "list", "check", "check-explainers", "goal", "triage", "validate", "doctor", "completion", "dev", "init-astro", "new", "check-links", "push", "share", "sync", "coverage", "import-openapi", "publish-confluence", or "publish-jira".`
+      `Unknown subcommand: "${subcommand}". Use "format", "watch", "compare", "gate-release", "deploy", "review", "list", "check", "check-explainers", "goal", "triage", "validate", "doctor", "completion", "check-links", "push", "share", "sync", "coverage", "publish-confluence", or "publish-jira".`
     );
     process.exit(EXIT_USAGE4);
   }
@@ -14218,15 +13852,15 @@ See: https://github.com/jagreehal/executable-stories (executable-stories-astro).
     const outputDirFlag = args.indexOf("--output-dir");
     const outputDir = outputDirFlag >= 0 ? args[outputDirFlag + 1] : void 0;
     const deps = {
-      readFile: (filePath) => fs19.readFileSync(filePath, "utf8"),
+      readFile: (filePath) => fs16.readFileSync(filePath, "utf8"),
       listDir: (dir) => {
         try {
-          return fs19.readdirSync(dir);
+          return fs16.readdirSync(dir);
         } catch {
           return void 0;
         }
       },
-      removeFile: (filePath) => fs19.rmSync(filePath, { force: true }),
+      removeFile: (filePath) => fs16.rmSync(filePath, { force: true }),
       logger: console
     };
     if (action === "status") {
@@ -14258,88 +13892,6 @@ See: https://github.com/jagreehal/executable-stories (executable-stories-astro).
   if (subcommand === "deploy") {
     process.exit(await runDeploy(args.slice(1)));
   }
-  if (subcommand === "dev") {
-    const devArgs = args.slice(1);
-    const siteDir = devArgs.find((a) => !a.startsWith("--")) ?? "./story-docs";
-    const dev = runDocsDev(siteDir);
-    if (dev.kind === "not-scaffolded") {
-      console.error(
-        `No docs site found at ${siteDir}. Create one (scaffold + install) with:
-  npx executable-stories init-astro --install`
-      );
-      process.exit(EXIT_USAGE4);
-    }
-    if (dev.kind === "install-failed") {
-      console.error(
-        `"${dev.pm} install" failed in ${siteDir} \u2014 run it manually, then retry.`
-      );
-      process.exit(EXIT_GENERATION);
-    }
-    process.exit(dev.status ?? EXIT_GENERATION);
-  }
-  if (subcommand === "init-astro") {
-    const initArgs = args.slice(1);
-    const targetDir = initArgs.find((a) => !a.startsWith("--")) ?? "./story-docs";
-    const force = initArgs.includes("--force");
-    const update = initArgs.includes("--update");
-    const install = initArgs.includes("--install");
-    try {
-      const result = initAstro({ targetDir, force, update });
-      if (update) {
-        console.log(
-          `Updated ${result.targetDir} (content + config left untouched)`
-        );
-        console.log(
-          "  Framework updates come via: pnpm update executable-stories-astro"
-        );
-        process.exit(EXIT_SUCCESS4);
-      }
-      console.log(`Scaffolded Astro docs site at ${result.targetDir}`);
-      const pm = detectPackageManager();
-      if (install) {
-        console.log(`Installing dependencies with ${pm}\u2026`);
-        if (!installScaffoldDependencies(result.targetDir, pm)) {
-          console.error(
-            `Scaffold complete, but "${pm} install" failed in ${result.targetDir} \u2014 run it manually, then \`${pm} run dev\`.`
-          );
-          process.exit(EXIT_GENERATION);
-        }
-      }
-      console.log("");
-      console.log("Next steps:");
-      let step = 1;
-      if (!install) {
-        console.log(`  ${step++}. cd ${result.targetDir} && ${pm} install`);
-      }
-      console.log(
-        `  ${step++}. In your TEST project, add the StoryReporter with a rawRunPath, e.g.`
-      );
-      console.log(
-        "       StoryReporter({ rawRunPath: 'reports/raw-run.json' })"
-      );
-      console.log(
-        `  ${step++}. Run your tests in watch mode (terminal 1):  ${pm} test --watch`
-      );
-      console.log(
-        `  ${step++}. Run the docs dev server (terminal 2):  npx executable-stories dev`
-      );
-      console.log(
-        "     Editing tests hot-reloads the Stories pages \u2014 nothing is written to disk."
-      );
-      console.log("");
-      console.log(
-        "Everything is configured in one file: executable-stories.config.mjs"
-      );
-      console.log(
-        "  \u2014 sources, scenario selection (include/exclude), grouping (groupBy), docs, and theme."
-      );
-      process.exit(EXIT_SUCCESS4);
-    } catch (err) {
-      console.error(`Error: ${err.message}`);
-      process.exit(EXIT_USAGE4);
-    }
-  }
-  if (subcommand === "new") process.exit(runNew(args.slice(1)));
   if (subcommand === "check-links")
     process.exit(await runCheckLinks(args.slice(1)));
   if (subcommand === "push") process.exit(await runPush(args.slice(1)));
@@ -14348,8 +13900,6 @@ See: https://github.com/jagreehal/executable-stories (executable-stories-astro).
     process.exit(await runSyncCommand("sync", args.slice(1)));
   if (subcommand === "coverage")
     process.exit(await runSyncCommand("coverage", args.slice(1)));
-  if (subcommand === "import-openapi")
-    process.exit(await runImportOpenApi(args.slice(1)));
   const { values, positionals, tokens } = parseArgs4({
     args: args.slice(1),
     options: CLI_OPTIONS,
@@ -14467,7 +14017,7 @@ See: https://github.com/jagreehal/executable-stories (executable-stories-astro).
   const requestedFormats = preset.formats;
   if (requestedFormats.includes("astro")) {
     console.warn(
-      "\u26A0 The 'astro' format was renamed to 'astro-markdown' \u2014 it emits Starlight Markdown, not the\n  executable-stories-astro live integration. '--format astro' still works but will be removed in a\n  future major; use 'astro-markdown', or scaffold a live site with `init-astro` + `astro dev`."
+      "\u26A0 The 'astro' format was renamed to 'astro-markdown'. '--format astro' still works but will be\n  removed in a future major; use 'astro-markdown'."
     );
   }
   const allRequestedFormats = requestedFormats.map(
@@ -14719,30 +14269,30 @@ async function readInput2(args) {
   if (args.stdin) {
     return readStdin();
   }
-  const filePath = path25.resolve(args.inputFile);
-  if (!fs19.existsSync(filePath)) {
+  const filePath = path22.resolve(args.inputFile);
+  if (!fs16.existsSync(filePath)) {
     console.error(`Error: File not found: ${filePath}`);
     process.exit(EXIT_USAGE4);
   }
-  return fs19.readFileSync(filePath, "utf8");
+  return fs16.readFileSync(filePath, "utf8");
 }
 function validateReportsDirectory(args) {
   const input = args.inputFile;
   if (!input || args.stdin) return void 0;
-  const resolved = path25.resolve(input);
-  if (!fs19.existsSync(resolved) || !fs19.statSync(resolved).isDirectory())
+  const resolved = path22.resolve(input);
+  if (!fs16.existsSync(resolved) || !fs16.statSync(resolved).isDirectory())
     return void 0;
-  const names = fs19.readdirSync(resolved).filter((n) => n.endsWith(".json")).sort();
+  const names = fs16.readdirSync(resolved).filter((n) => n.endsWith(".json")).sort();
   if (names.length === 0) {
     console.error(`Error: no per-file reports (*.json) in ${input}.`);
     return EXIT_USAGE4;
   }
   const problems = [];
   for (const name of names) {
-    const filePath = path25.join(resolved, name);
+    const filePath = path22.join(resolved, name);
     try {
       const run = JSON.parse(
-        fs19.readFileSync(filePath, "utf8")
+        fs16.readFileSync(filePath, "utf8")
       );
       const result = validateCanonicalRun2(run);
       if (!result.valid) {
@@ -14766,16 +14316,16 @@ function readAggregateInput(args) {
   const input = args.inputFile;
   if (!input || args.stdin) return void 0;
   if (args.subcommand === "validate") return void 0;
-  const resolved = path25.resolve(input);
-  if (!fs19.existsSync(resolved) || !fs19.statSync(resolved).isDirectory())
+  const resolved = path22.resolve(input);
+  if (!fs16.existsSync(resolved) || !fs16.statSync(resolved).isDirectory())
     return void 0;
   const result = aggregateReports(
     { dir: resolved.replace(/\\/g, "/") },
     {
-      readFile: (p) => fs19.readFileSync(p, "utf8"),
+      readFile: (p) => fs16.readFileSync(p, "utf8"),
       listDir: (dir) => {
         try {
-          return fs19.readdirSync(dir);
+          return fs16.readdirSync(dir);
         } catch {
           return void 0;
         }
@@ -14797,19 +14347,19 @@ async function readRunInput(args) {
   return normalizeRunFromText(await readInput2(args), args).run;
 }
 function readFileInput(filePath) {
-  const resolved = path25.resolve(filePath);
-  if (!fs19.existsSync(resolved)) {
+  const resolved = path22.resolve(filePath);
+  if (!fs16.existsSync(resolved)) {
     console.error(`Error: File not found: ${resolved}`);
     process.exit(EXIT_USAGE4);
   }
-  return fs19.readFileSync(resolved, "utf8");
+  return fs16.readFileSync(resolved, "utf8");
 }
 function readStdin() {
-  return new Promise((resolve13, reject) => {
+  return new Promise((resolve12, reject) => {
     const chunks = [];
     process.stdin.setEncoding("utf8");
     process.stdin.on("data", (chunk) => chunks.push(chunk));
-    process.stdin.on("end", () => resolve13(chunks.join("")));
+    process.stdin.on("end", () => resolve12(chunks.join("")));
     process.stdin.on("error", reject);
   });
 }
@@ -14957,16 +14507,16 @@ function tryNormalizeRunFromText(text2, args) {
   }
 }
 function listBaselineCandidates(currentFile, args) {
-  const baselineDir = path25.resolve(
-    args.baselineDir ?? path25.dirname(currentFile)
+  const baselineDir = path22.resolve(
+    args.baselineDir ?? path22.dirname(currentFile)
   );
-  const currentResolved = path25.resolve(currentFile);
-  if (!fs19.existsSync(baselineDir)) {
+  const currentResolved = path22.resolve(currentFile);
+  if (!fs16.existsSync(baselineDir)) {
     console.error(`Error: baseline directory not found: ${baselineDir}`);
     process.exit(EXIT_USAGE4);
   }
-  const entries = fs19.readdirSync(baselineDir, { withFileTypes: true });
-  return entries.filter((entry) => entry.isFile()).map((entry) => path25.join(baselineDir, entry.name)).filter((candidate) => path25.resolve(candidate) !== currentResolved).filter(
+  const entries = fs16.readdirSync(baselineDir, { withFileTypes: true });
+  return entries.filter((entry) => entry.isFile()).map((entry) => path22.join(baselineDir, entry.name)).filter((candidate) => path22.resolve(candidate) !== currentResolved).filter(
     (candidate) => args.inputType === "ndjson" ? candidate.endsWith(".ndjson") : candidate.endsWith(".json")
   );
 }
@@ -14975,7 +14525,7 @@ function resolveBaselineAuto(currentFile, currentRun, args) {
   const comparable = [];
   for (const candidate of candidates) {
     const run = tryNormalizeRunFromText(
-      fs19.readFileSync(candidate, "utf8"),
+      fs16.readFileSync(candidate, "utf8"),
       args
     );
     if (run) {
@@ -14984,7 +14534,7 @@ function resolveBaselineAuto(currentFile, currentRun, args) {
   }
   if (comparable.length === 0) {
     console.error(
-      `Error: no compatible baseline files found in ${path25.resolve(args.baselineDir ?? path25.dirname(currentFile))}.`
+      `Error: no compatible baseline files found in ${path22.resolve(args.baselineDir ?? path22.dirname(currentFile))}.`
     );
     process.exit(EXIT_USAGE4);
   }
@@ -15155,7 +14705,8 @@ async function runReview(ctx) {
   const { args } = ctx;
   const run = applySelection(await readRunInput(args), args);
   const context = loadReviewContext(args);
-  const review = buildReview(run, context);
+  const built = buildReview(run, context);
+  const review = await withJev(built, (jev) => enrichReview(built, jev));
   try {
     const files = writeReviewReport(review, args);
     for (const f of files) {
@@ -15239,7 +14790,7 @@ async function runCheckExplainers(ctx) {
     );
     process.exit(EXIT_USAGE4);
   }
-  if (!fs19.existsSync(args.explainersDir) || !fs19.statSync(args.explainersDir).isDirectory()) {
+  if (!fs16.existsSync(args.explainersDir) || !fs16.statSync(args.explainersDir).isDirectory()) {
     console.error(
       `Error: --explainers-dir "${args.explainersDir}" is not a directory.`
     );
@@ -15253,30 +14804,39 @@ async function runCheckExplainers(ctx) {
   }
   process.exit(EXIT_SUCCESS4);
 }
+async function withJev(report, enrich) {
+  const jev = jevFromEnv();
+  if (!jev) return report;
+  try {
+    return await enrich(jev);
+  } catch (err) {
+    console.error(`Jev unavailable, deterministic output only: ${err instanceof Error ? err.message : String(err)}`);
+    return report;
+  }
+}
 async function runGoal(ctx) {
   const { args } = ctx;
   const run = applySelection(await readRunInput(args), args);
   const baseline = resolveBaselineRun(args, run);
-  const report = buildGoal(
-    {
-      run,
-      baseline,
-      requireTags: args.requireTags,
-      requireTickets: args.requireTickets,
-      requireScenarios: args.requireScenarios,
-      enforceNoRegressions: args.noRegressions,
-      enforceRatchet: !args.noRatchet,
-      format: args.goalFormat
-    },
-    {}
-  );
+  const goalArgs = {
+    run,
+    baseline,
+    requireTags: args.requireTags,
+    requireTickets: args.requireTickets,
+    requireScenarios: args.requireScenarios,
+    enforceNoRegressions: args.noRegressions,
+    enforceRatchet: !args.noRatchet,
+    format: args.goalFormat
+  };
+  const built = buildGoal(goalArgs, {});
+  const report = await withJev(built, (jev) => enrichGoal(built, goalArgs, jev));
   console.log(renderGoal(report, args.goalFormat));
   process.exit(report.met ? EXIT_SUCCESS4 : EXIT_AGENT_GATE);
 }
 function readCodeowners() {
   for (const candidate of ["CODEOWNERS", ".github/CODEOWNERS", "docs/CODEOWNERS"]) {
-    if (fs19.existsSync(candidate)) {
-      return parseCodeowners(fs19.readFileSync(candidate, "utf8"));
+    if (fs16.existsSync(candidate)) {
+      return parseCodeowners(fs16.readFileSync(candidate, "utf8"));
     }
   }
   console.error(
@@ -15289,7 +14849,7 @@ async function runTriage(ctx) {
   const run = applySelection(await readRunInput(args), args);
   const baseline = resolveBaselineStatusMap(args, run);
   const codeowners = args.byOwner ? readCodeowners() : void 0;
-  const report = buildTriage(
+  const built = buildTriage(
     {
       testCases: run.testCases,
       baseline,
@@ -15298,6 +14858,7 @@ async function runTriage(ctx) {
     },
     {}
   );
+  const report = await withJev(built, (jev) => enrichTriage(built, run.testCases, jev, codeowners));
   console.log(renderTriage(report, args.triageFormat, { byOwner: args.byOwner }));
   process.exit(EXIT_SUCCESS4);
 }
@@ -15396,9 +14957,9 @@ async function runFormatOrValidate(ctx) {
       process.exit(EXIT_SCHEMA_VALIDATION);
     }
     if (args.emitCanonical) {
-      const outPath = path25.resolve(args.emitCanonical);
-      fs19.mkdirSync(path25.dirname(outPath), { recursive: true });
-      fs19.writeFileSync(outPath, JSON.stringify(run, null, 2), "utf8");
+      const outPath = path22.resolve(args.emitCanonical);
+      fs16.mkdirSync(path22.dirname(outPath), { recursive: true });
+      fs16.writeFileSync(outPath, JSON.stringify(run, null, 2), "utf8");
     }
     try {
       const history = runHistoryPipeline(run, args);
@@ -15462,9 +15023,9 @@ ${msg}`);
     }
     const run = data;
     if (args.emitCanonical) {
-      const outPath = path25.resolve(args.emitCanonical);
-      fs19.mkdirSync(path25.dirname(outPath), { recursive: true });
-      fs19.writeFileSync(outPath, JSON.stringify(run, null, 2), "utf8");
+      const outPath = path22.resolve(args.emitCanonical);
+      fs16.mkdirSync(path22.dirname(outPath), { recursive: true });
+      fs16.writeFileSync(outPath, JSON.stringify(run, null, 2), "utf8");
     }
     try {
       const history = runHistoryPipeline(run, args);
@@ -15523,9 +15084,9 @@ ${msg}`);
     process.exit(EXIT_CANONICAL_VALIDATION);
   }
   if (args.emitCanonical) {
-    const outPath = path25.resolve(args.emitCanonical);
-    fs19.mkdirSync(path25.dirname(outPath), { recursive: true });
-    fs19.writeFileSync(outPath, JSON.stringify(canonical, null, 2), "utf8");
+    const outPath = path22.resolve(args.emitCanonical);
+    fs16.mkdirSync(path22.dirname(outPath), { recursive: true });
+    fs16.writeFileSync(outPath, JSON.stringify(canonical, null, 2), "utf8");
   }
   try {
     const history = runHistoryPipeline(canonical, args);
@@ -15560,9 +15121,9 @@ function runCustomFormatters(run, customRequested, formatters, args) {
       const ext = formatter.fileExtension ?? formatName;
       const baseName = args.outputName ?? "report";
       const filename = args.outputNameTimestamp ? `${baseName}-${Math.floor(run.startedAtMs / 1e3)}.${ext}` : `${baseName}.${ext}`;
-      const filepath = path25.join(outputDir, filename);
-      fs19.mkdirSync(outputDir, { recursive: true });
-      fs19.writeFileSync(filepath, content, "utf8");
+      const filepath = path22.join(outputDir, filename);
+      fs16.mkdirSync(outputDir, { recursive: true });
+      fs16.writeFileSync(filepath, content, "utf8");
       console.log(`Generated: ${filepath}`);
     } catch (err) {
       console.error(
@@ -15616,13 +15177,13 @@ async function dispatchNotifications(run, args) {
 }
 function runHistoryPipeline(run, args) {
   if (!args.historyFile) return void 0;
-  const historyPath = path25.resolve(args.historyFile);
+  const historyPath = path22.resolve(args.historyFile);
   const store = loadHistory(
     { filePath: historyPath },
     {
       readFile: (p) => {
         try {
-          return fs19.readFileSync(p, "utf8");
+          return fs16.readFileSync(p, "utf8");
         } catch {
           return void 0;
         }
@@ -15635,12 +15196,12 @@ function runHistoryPipeline(run, args) {
     run,
     maxRuns: args.maxHistoryRuns
   });
-  const dir = path25.dirname(historyPath);
-  fs19.mkdirSync(dir, { recursive: true });
+  const dir = path22.dirname(historyPath);
+  fs16.mkdirSync(dir, { recursive: true });
   saveHistory(
     { filePath: historyPath, store: updated },
     {
-      writeFile: (p, content) => fs19.writeFileSync(p, content, "utf8")
+      writeFile: (p, content) => fs16.writeFileSync(p, content, "utf8")
     }
   );
   let metricsCount = 0;
@@ -15706,7 +15267,7 @@ async function generateReports(run, args, historyStore, _droppedMissingStory = 0
     files.push(...paths);
     (EXECUTION_ONLY_FORMATS.has(format) ? executionFiles : documentationFiles).push(...paths);
   }
-  const createdArtifactsReadme = writeArtifactsReadme(args.outputDir);
+  writeArtifactsReadme(args.outputDir);
   const documented = generator.renderedRun ?? run;
   const wroteDocumentation = args.formats.some(
     (f) => !EXECUTION_ONLY_FORMATS.has(f)
@@ -15740,7 +15301,6 @@ async function generateReports(run, args, historyStore, _droppedMissingStory = 0
   return {
     files,
     counts,
-    createdArtifactsReadme,
     // A run that traced itself can draw the architecture it exercised, and
     // nobody discovers a format they have never seen named.
     spansUnused: !args.formats.includes("span-graph") && !args.htmlArchitecture && documented.testCases.some((tc) => (tc.story.otelSpans?.length ?? 0) > 0),
@@ -15885,13 +15445,13 @@ function writeReviewReport(review, args) {
   const outputDir = args.outputDir ?? "reports";
   const baseName = args.outputName ?? "evidence-review";
   const suffix = args.outputNameTimestamp ? `-${Math.floor(review.run.startedAtMs / 1e3)}` : "";
-  fs19.mkdirSync(outputDir, { recursive: true });
-  const mdPath = path25.join(outputDir, `${baseName}${suffix}.md`);
-  const htmlPath = path25.join(outputDir, `${baseName}${suffix}.html`);
-  const jsonPath = path25.join(outputDir, `${baseName}${suffix}.review.json`);
-  fs19.writeFileSync(mdPath, markdown, "utf8");
-  fs19.writeFileSync(htmlPath, html, "utf8");
-  fs19.writeFileSync(
+  fs16.mkdirSync(outputDir, { recursive: true });
+  const mdPath = path22.join(outputDir, `${baseName}${suffix}.md`);
+  const htmlPath = path22.join(outputDir, `${baseName}${suffix}.html`);
+  const jsonPath = path22.join(outputDir, `${baseName}${suffix}.review.json`);
+  fs16.writeFileSync(mdPath, markdown, "utf8");
+  fs16.writeFileSync(htmlPath, html, "utf8");
+  fs16.writeFileSync(
     jsonPath,
     `${JSON.stringify(buildReviewJson(review), null, 2)}
 `,
@@ -15987,11 +15547,6 @@ function printResult(result, args, startMs, droppedMissingStory = 0) {
         "Tip: this run carries OTel spans, so it can draw the architecture it exercised: --format span-graph (a file), --html-architecture (a section in the HTML report)"
       );
     }
-    if (result.createdArtifactsReadme && !isScaffoldedAstroSite(".") && !isScaffoldedAstroSite("./story-docs")) {
-      console.error(
-        "Tip: for a live docs site (stories, explainers, freshness): npx executable-stories init-astro --install"
-      );
-    }
   }
   if (args.open) {
     openInBrowser(pickOpenTarget(result.files));
@@ -16000,9 +15555,9 @@ function printResult(result, args, startMs, droppedMissingStory = 0) {
 function printCompareResult(result, args, startMs) {
   const durationMs = Date.now() - startMs;
   if (result.prSummary && args.prSummaryFile) {
-    const outputPath = path25.resolve(args.prSummaryFile);
-    fs19.mkdirSync(path25.dirname(outputPath), { recursive: true });
-    fs19.writeFileSync(outputPath, result.prSummary, "utf8");
+    const outputPath = path22.resolve(args.prSummaryFile);
+    fs16.mkdirSync(path22.dirname(outputPath), { recursive: true });
+    fs16.writeFileSync(outputPath, result.prSummary, "utf8");
   }
   if (args.jsonSummary) {
     console.log(
@@ -16036,13 +15591,13 @@ function printCompareResult(result, args, startMs) {
   }
 }
 function loadReleasePolicy(policyPath) {
-  const resolved = path25.resolve(policyPath);
-  if (!fs19.existsSync(resolved)) {
+  const resolved = path22.resolve(policyPath);
+  if (!fs16.existsSync(resolved)) {
     console.error(`Error: release policy file not found: ${resolved}`);
     process.exit(EXIT_USAGE4);
   }
   try {
-    const raw = JSON.parse(fs19.readFileSync(resolved, "utf8"));
+    const raw = JSON.parse(fs16.readFileSync(resolved, "utf8"));
     return {
       allowedOmissions: Array.isArray(raw.allowedOmissions) ? raw.allowedOmissions : [],
       allowedRegressions: Array.isArray(raw.allowedRegressions) ? raw.allowedRegressions : [],
@@ -16148,7 +15703,7 @@ Generate an API token at https://id.atlassian.com/manage-profile/security/api-to
     );
     process.exit(EXIT_USAGE4);
   }
-  if (!fs19.existsSync(inputFile)) {
+  if (!fs16.existsSync(inputFile)) {
     console.error(`Error: file not found: ${inputFile}`);
     process.exit(EXIT_USAGE4);
   }
@@ -16176,7 +15731,7 @@ Generate an API token at https://id.atlassian.com/manage-profile/security/api-to
     console.error("Error: --title is required when creating a new page");
     process.exit(EXIT_USAGE4);
   }
-  const adf = fs19.readFileSync(path25.resolve(inputFile), "utf8");
+  const adf = fs16.readFileSync(path22.resolve(inputFile), "utf8");
   if (dryRun) {
     console.log(
       JSON.stringify(
@@ -16257,7 +15812,7 @@ Generate an API token at https://id.atlassian.com/manage-profile/security/api-to
     );
     process.exit(EXIT_USAGE4);
   }
-  if (!fs19.existsSync(inputFile)) {
+  if (!fs16.existsSync(inputFile)) {
     console.error(`Error: file not found: ${inputFile}`);
     process.exit(EXIT_USAGE4);
   }
@@ -16284,7 +15839,7 @@ Generate an API token at https://id.atlassian.com/manage-profile/security/api-to
     process.exit(EXIT_USAGE4);
   }
   const mode = modeRaw;
-  const adf = fs19.readFileSync(path25.resolve(inputFile), "utf8");
+  const adf = fs16.readFileSync(path22.resolve(inputFile), "utf8");
   if (dryRun) {
     console.log(
       JSON.stringify(
@@ -16325,46 +15880,6 @@ Generate an API token at https://id.atlassian.com/manage-profile/security/api-to
     process.exit(EXIT_GENERATION);
   }
 }
-function runNew(rawArgs) {
-  const { values, positionals } = parseArgs4({
-    args: rawArgs,
-    options: {
-      dir: { type: "string" },
-      force: { type: "boolean", default: false },
-      "scenario-id": { type: "string" }
-    },
-    allowPositionals: true,
-    strict: true
-  });
-  const template = positionals[0];
-  const name = positionals.slice(1).join(" ");
-  if (!template) {
-    console.error(
-      `Usage: executable-stories new <template> "<name>" [--dir <docs-dir>] [--scenario-id <id>] [--force]`
-    );
-    console.error(`Templates: ${TEMPLATES.join(", ")}`);
-    return EXIT_USAGE4;
-  }
-  try {
-    const result = scaffoldDoc({
-      template,
-      name,
-      scenarioId: values["scenario-id"],
-      baseDir: values.dir,
-      force: values.force
-    });
-    console.log(`Created ${result.template}: ${result.path}`);
-    console.log(`  Title: ${result.title}`);
-    console.log("");
-    console.log(
-      "Next: fill in the content and link verifying stories in `verifiedBy`."
-    );
-    return EXIT_SUCCESS4;
-  } catch (err) {
-    console.error(`Error: ${err.message}`);
-    return EXIT_USAGE4;
-  }
-}
 async function runCheckLinks(rawArgs) {
   const { values, positionals } = parseArgs4({
     args: rawArgs,
@@ -16394,48 +15909,6 @@ async function runCheckLinks(rawArgs) {
     return EXIT_USAGE4;
   }
 }
-async function runImportOpenApi(rawArgs) {
-  const { values, positionals } = parseArgs4({
-    args: rawArgs,
-    options: {
-      "output-dir": { type: "string" },
-      run: { type: "string" },
-      force: { type: "boolean", default: false }
-    },
-    allowPositionals: true,
-    strict: true
-  });
-  const spec = positionals[0];
-  if (!spec) {
-    console.error(
-      `Usage: executable-stories import-openapi <spec.json|yaml> [--output-dir <dir>] [--run <story-report.json>] [--force]`
-    );
-    return EXIT_USAGE4;
-  }
-  try {
-    const result = await importOpenApi({
-      specPath: spec,
-      outputDir: values["output-dir"],
-      runFile: values.run,
-      force: values.force
-    });
-    console.log(
-      `Generated ${result.pageCount} API page(s) at ${result.outputDir}`
-    );
-    console.log(
-      `  Covered endpoints: ${result.coveredCount} / ${result.endpointCount}`
-    );
-    if (result.uncoveredCount > 0) {
-      console.log(
-        `  \u26A0 ${result.uncoveredCount} endpoint(s) have no verifying story`
-      );
-    }
-    return EXIT_SUCCESS4;
-  } catch (err) {
-    console.error(`Error: ${err.message}`);
-    return EXIT_USAGE4;
-  }
-}
 async function runDeploy(rawArgs) {
   const mode = rawArgs[0];
   if (!mode || !["record", "status", "diff"].includes(mode)) {