executable-stories-formatters 0.10.0 → 0.11.1

package/dist/index.cjs

@@ -44,6 +44,7 @@ __export(src_exports, {
   MIN_METRIC_SAMPLES: () => MIN_METRIC_SAMPLES,
   MIN_PERF_SAMPLES: () => MIN_PERF_SAMPLES,
   MarkdownFormatter: () => MarkdownFormatter,
+  ReleaseManifestFormatter: () => ReleaseManifestFormatter,
   ReportGenerator: () => ReportGenerator,
   ReviewHtmlFormatter: () => ReviewHtmlFormatter,
   ReviewMarkdownFormatter: () => ReviewMarkdownFormatter,
@@ -83,10 +84,13 @@ __export(src_exports, {
   generateTestCaseId: () => generateTestCaseId,
   getAvailableThemes: () => getAvailableThemes,
   getCssOnlyThemes: () => getCssOnlyThemes,
+  getDeploymentStatus: () => getDeploymentStatus,
+  getEnvironmentDrift: () => getEnvironmentDrift,
   gradeEvidence: () => gradeEvidence,
   hasSufficientHistory: () => hasSufficientHistory,
   isReviewableSource: () => isReviewableSource,
   isTestFile: () => isTestFile,
+  joinNameAndExt: () => joinNameAndExt,
   listScenarios: () => listScenarios,
   loadHistory: () => loadHistory,
   mergeStepResults: () => mergeStepResults,
@@ -103,6 +107,7 @@ __export(src_exports, {
   readBranchName: () => readBranchName,
   readGitSha: () => readGitSha,
   readPackageVersion: () => readPackageVersion,
+  recordDeployment: () => recordDeployment,
   regenerateArtifacts: () => regenerateArtifacts,
   resolveAttachment: () => resolveAttachment,
   resolveAttachments: () => resolveAttachments,
@@ -122,6 +127,7 @@ __export(src_exports, {
   toBehaviorManifest: () => toBehaviorManifest,
   toCIInfo: () => toCIInfo,
   toRawCIInfo: () => toRawCIInfo,
+  toReleaseManifest: () => toReleaseManifest,
   toScenarioIndex: () => toScenarioIndex,
   toStoryReport: () => toStoryReport,
   tryGetActiveOtelContext: () => tryGetActiveOtelContext,
@@ -129,8 +135,8 @@ __export(src_exports, {
   validateCanonicalRun: () => validateCanonicalRun
 });
 module.exports = __toCommonJS(src_exports);
-var fs9 = require("fs");
-var path10 = __toESM(require("path"), 1);
+var fs10 = require("fs");
+var path11 = __toESM(require("path"), 1);
 var fsPromises = __toESM(require("fs/promises"), 1);
 
 // src/converters/acl/status.ts
@@ -893,6 +899,15 @@ function copyDocEntry(entry) {
         phase: entry.phase,
         ...children
       };
+    case "video":
+      return {
+        kind: "video",
+        path: entry.path,
+        ...entry.caption ? { caption: entry.caption } : {},
+        ...entry.poster ? { poster: entry.poster } : {},
+        phase: entry.phase,
+        ...children
+      };
     case "custom":
       return {
         kind: "custom",
@@ -1010,23 +1025,23 @@ function buildFeature(relSourceFile, group) {
 function ensureUniqueFeatureIds(features) {
   const seen = /* @__PURE__ */ new Map();
   for (const f of features) {
-    const count = seen.get(f.id) ?? 0;
-    if (count > 0) f.id = `${f.id}-${count + 1}`;
-    seen.set(f.id, count + 1);
+    const count2 = seen.get(f.id) ?? 0;
+    if (count2 > 0) f.id = `${f.id}-${count2 + 1}`;
+    seen.set(f.id, count2 + 1);
   }
 }
 function ensureUniqueScenarioIds(feature) {
   const seen = /* @__PURE__ */ new Map();
   for (const s of feature.scenarios) {
-    const count = seen.get(s.id) ?? 0;
-    if (count > 0) {
-      const newId = `${s.id}-${count + 1}`;
+    const count2 = seen.get(s.id) ?? 0;
+    if (count2 > 0) {
+      const newId = `${s.id}-${count2 + 1}`;
       for (const step of s.steps) {
         step.id = step.id.replace(s.id, newId);
       }
       s.id = newId;
     }
-    seen.set(s.id, count + 1);
+    seen.set(s.id, count2 + 1);
   }
 }
 function toStoryReport(run) {
@@ -14054,6 +14069,23 @@ function renderDocScreenshot(entry, deps) {
   ${entry.alt ? `<div class="doc-screenshot-caption">${deps.escapeHtml(entry.alt)}</div>` : ""}
 </div>`;
 }
+function renderDocVideo(entry, deps) {
+  const isRemote = /^(?:https?:|data:)/i.test(entry.path);
+  const isAbsoluteFsPath = !isRemote && /^(?:[/\\]|[A-Za-z]:[/\\])/.test(entry.path);
+  const captionHtml = entry.caption ? `<div class="doc-video-caption">${deps.escapeHtml(entry.caption)}</div>` : "";
+  if ((deps.embedScreenshots ?? true) && isAbsoluteFsPath) {
+    return `<div class="doc-video doc-video-missing">
+  <div class="doc-video-missing-label">Video unavailable</div>
+  <div class="doc-video-missing-path">${deps.escapeHtml(entry.path)}</div>
+  ${captionHtml}
+</div>`;
+  }
+  const poster = entry.poster ? ` poster="${deps.escapeHtml(entry.poster)}"` : "";
+  return `<div class="doc-video">
+  <video class="doc-video-player" controls preload="metadata"${poster} src="${deps.escapeHtml(entry.path)}"></video>
+  ${captionHtml}
+</div>`;
+}
 function renderDocCustom(entry, deps) {
   if (entry.type === "visual" && entry.data && typeof entry.data === "object") {
     const data = entry.data;
@@ -14107,6 +14139,9 @@ function renderDocEntry(entry, deps) {
     case "screenshot":
       html = renderDocScreenshot(entry, deps);
       break;
+    case "video":
+      html = renderDocVideo(entry, deps);
+      break;
     case "custom":
       html = renderDocCustom(entry, deps);
       break;
@@ -15433,6 +15468,19 @@ var MarkdownFormatter = class {
       case "screenshot":
         lines.push(`${indent}![${entry.alt ?? "Screenshot"}](${entry.path})`);
         break;
+      case "video": {
+        const poster = entry.poster ? ` poster="${entry.poster}"` : "";
+        lines.push(`${indent}`);
+        lines.push(`${indent}<video controls preload="metadata"${poster} class="doc-video">`);
+        lines.push(`${indent}  <source src="${entry.path}" />`);
+        lines.push(`${indent}</video>`);
+        if (entry.caption) {
+          lines.push(`${indent}`);
+          lines.push(`${indent}*${entry.caption}*`);
+        }
+        lines.push(`${indent}`);
+        break;
+      }
       case "custom":
         if (entry.type === "visual" && entry.data && typeof entry.data === "object") {
           const data = entry.data;
@@ -15525,6 +15573,88 @@ function groupBy6(items, keyFn) {
   return map;
 }
 
+// src/formatters/release-manifest.ts
+var import_node_crypto2 = require("crypto");
+var ReleaseManifestFormatter = class {
+  format(run) {
+    const manifest = toReleaseManifest(run);
+    const lines = [];
+    lines.push("# Release Manifest");
+    lines.push("");
+    lines.push(`Generated: ${manifest.generatedAt}`);
+    lines.push(`Run: ${manifest.run.startedAt} to ${manifest.run.finishedAt}`);
+    if (manifest.run.branch) lines.push(`Branch: ${manifest.run.branch}`);
+    if (manifest.run.gitSha) lines.push(`Commit: ${manifest.run.gitSha}`);
+    lines.push(`Tested-together hash: \`${manifest.testedTogetherHash}\``);
+    lines.push("");
+    lines.push("| Scenarios | Passed | Failed | Skipped | Pending |");
+    lines.push("| ---: | ---: | ---: | ---: | ---: |");
+    lines.push(`| ${manifest.run.total} | ${manifest.run.passed} | ${manifest.run.failed} | ${manifest.run.skipped} | ${manifest.run.pending} |`);
+    lines.push("");
+    lines.push("## Scenarios");
+    lines.push("");
+    lines.push("| Status | Scenario | Source | Tags |");
+    lines.push("| --- | --- | --- | --- |");
+    for (const scenario of manifest.scenarios) {
+      const source = `${scenario.sourceFile}:${scenario.sourceLine}`;
+      const tags = scenario.tags.length > 0 ? scenario.tags.map((tag) => `\`${tag}\``).join(", ") : "";
+      lines.push(`| ${renderStatus(scenario.status)} | ${escapePipe(scenario.title)} | \`${source}\` | ${tags} |`);
+    }
+    return lines.join("\n");
+  }
+};
+function toReleaseManifest(run) {
+  const scenarios = [...run.testCases].sort((a, b) => a.id.localeCompare(b.id)).map((tc) => ({
+    id: tc.id,
+    title: tc.story.scenario,
+    status: tc.status,
+    sourceFile: tc.sourceFile,
+    sourceLine: tc.sourceLine,
+    tags: tc.tags
+  }));
+  const fingerprint = scenarios.map((scenario) => `${scenario.id}:${scenario.status}`).join("\n");
+  return {
+    schemaVersion: "1.0",
+    generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    run: {
+      startedAt: new Date(run.startedAtMs).toISOString(),
+      finishedAt: new Date(run.finishedAtMs).toISOString(),
+      gitSha: run.gitSha,
+      branch: getBranch(run),
+      total: run.testCases.length,
+      passed: count(run.testCases, "passed"),
+      failed: count(run.testCases, "failed"),
+      skipped: count(run.testCases, "skipped"),
+      pending: count(run.testCases, "pending")
+    },
+    testedTogetherHash: (0, import_node_crypto2.createHash)("sha256").update(fingerprint).digest("hex"),
+    scenarios
+  };
+}
+function getBranch(run) {
+  return run.ci?.branch;
+}
+function count(testCases, status) {
+  return testCases.filter((tc) => tc.status === status).length;
+}
+function renderStatus(status) {
+  switch (status) {
+    case "passed":
+      return "passed";
+    case "failed":
+      return "failed";
+    case "skipped":
+      return "skipped";
+    case "pending":
+      return "pending";
+    default:
+      return status;
+  }
+}
+function escapePipe(value) {
+  return value.replace(/\|/g, "\\|");
+}
+
 // src/formatters/cucumber-messages/synthesize-feature.ts
 function extractFeatureName(testCases, uri) {
   for (const tc of testCases) {
@@ -15591,7 +15721,7 @@ function synthesizeFeature(uri, testCases) {
 }
 
 // src/utils/cucumber-messages.ts
-var import_node_crypto2 = require("crypto");
+var import_node_crypto3 = require("crypto");
 function msToTimestamp(ms) {
   const seconds = Math.floor(ms / 1e3);
   const nanos = Math.round(ms % 1e3 * 1e6);
@@ -15657,7 +15787,7 @@ function statusToCucumberStatus(status) {
 }
 function deterministicId(kind, salt, ...parts) {
   const input = [salt, kind, ...parts].join("::");
-  return (0, import_node_crypto2.createHash)("sha1").update(input).digest("hex").slice(0, 36);
+  return (0, import_node_crypto3.createHash)("sha1").update(input).digest("hex").slice(0, 36);
 }
 
 // src/formatters/cucumber-messages/build-gherkin-document.ts
@@ -16145,8 +16275,8 @@ function extractDocAttachments(step) {
   }
   return attachments;
 }
-function guessMediaType(path11) {
-  const lower = path11.toLowerCase();
+function guessMediaType(path12) {
+  const lower = path12.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";
@@ -16287,11 +16417,11 @@ var CucumberHtmlFormatter = class {
     for (const envelope of envelopes) {
       const accepted = htmlStream.write(envelope);
       if (!accepted) {
-        await new Promise((resolve8) => htmlStream.once("drain", resolve8));
+        await new Promise((resolve9) => htmlStream.once("drain", resolve9));
       }
     }
-    await new Promise((resolve8, reject) => {
-      collector.on("finish", resolve8);
+    await new Promise((resolve9, reject) => {
+      collector.on("finish", resolve9);
       collector.on("error", reject);
       htmlStream.end();
     });
@@ -16592,6 +16722,8 @@ function formatDocEntry(doc) {
       return `${escapeHtml2(doc.title ?? "mermaid diagram")}: <code>${escapeHtml2(doc.code)}</code>`;
     case "screenshot":
       return `${doc.alt ? `${escapeHtml2(doc.alt)}: ` : ""}${escapeHtml2(doc.path)}`;
+    case "video":
+      return `${doc.caption ? `${escapeHtml2(doc.caption)}: ` : ""}${escapeHtml2(doc.path)}`;
     case "custom":
       return `${escapeHtml2(doc.type)}: ${escapeHtml2(JSON.stringify(doc.data))}`;
   }
@@ -17048,6 +17180,8 @@ function formatDocEntry2(doc) {
       return `${doc.title ?? "mermaid diagram"}: \`${doc.code}\``;
     case "screenshot":
       return `${doc.alt ? `${doc.alt}: ` : ""}${doc.path}`;
+    case "video":
+      return `${doc.caption ? `${doc.caption}: ` : ""}${doc.path}`;
     case "custom":
       return `${doc.type}: ${JSON.stringify(doc.data)}`;
   }
@@ -17293,19 +17427,35 @@ function replaceAssetRef(html, original, replacement) {
   return html;
 }
 
+// src/utils/source-file.ts
+function cleanTestStem(fileName) {
+  const base = fileName.split(/[\\/]/).pop() ?? fileName;
+  const stripped = base.replace(/\.(story\.)?(test|spec|cy)\.[cm]?[jt]sx?$/i, "");
+  if (stripped !== base) return stripped;
+  return base.replace(/\.[^.]+$/, "");
+}
+function humanizeSourceFile(fileName) {
+  return cleanTestStem(fileName).split(/[-_.\s]+/).filter(Boolean).map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(" ");
+}
+
 // src/formatters/astro.ts
 var AstroFormatter = class _AstroFormatter {
   markdownFormatter;
   title;
+  perFileTitle;
   constructor(options = {}) {
     this.title = options.markdown?.title ?? "User Stories";
+    this.perFileTitle = options.perFileTitle ?? false;
     this.markdownFormatter = new MarkdownFormatter({
       ...options.markdown,
       title: this.title,
       stepStyle: "gherkin",
       includeFrontMatter: false,
       includeSummaryTable: false,
-      includeMetadata: false
+      includeMetadata: false,
+      // A per-file page is one file already — group by suite/describe so the
+      // body shows clean section headings, not the redundant source path.
+      groupBy: this.perFileTitle ? "suite" : options.markdown?.groupBy ?? "file"
     });
   }
   format(run) {
@@ -17315,13 +17465,31 @@ var AstroFormatter = class _AstroFormatter {
     return `${frontmatter}
 ${body}`;
   }
+  /**
+   * Title for the page. A per-file page (one source file — i.e. colocated mode)
+   * is titled by its suite/describe name, falling back to a humanized filename,
+   * so the docs nav reads "Convert Currency" not "User Stories" six times over.
+   * Multi-file (aggregated) pages keep the configured title.
+   */
+  deriveTitle(run) {
+    if (!this.perFileTitle) return this.title;
+    const sourceFiles = new Set(
+      run.testCases.map((tc) => tc.sourceFile).filter((f) => f && f !== "unknown")
+    );
+    if (sourceFiles.size !== 1) return this.title;
+    const suites = new Set(
+      run.testCases.map((tc) => tc.titlePath?.[0]).filter((s) => Boolean(s))
+    );
+    if (suites.size === 1) return [...suites][0];
+    return humanizeSourceFile([...sourceFiles][0]) || this.title;
+  }
   buildFrontmatter(run) {
     const badge = _AstroFormatter.computeBadge(run.testCases);
-    const count = run.testCases.length;
-    const description = `${count} scenario${count !== 1 ? "s" : ""} \u2014 ${badge.text.toLowerCase()}`;
+    const count2 = run.testCases.length;
+    const description = `${count2} scenario${count2 !== 1 ? "s" : ""} \u2014 ${badge.text.toLowerCase()}`;
     const lines = [
       "---",
-      `title: ${this.title}`,
+      `title: ${yamlScalar(this.deriveTitle(run))}`,
       `description: ${description}`,
       "sidebar:",
       "  badge:",
@@ -17339,6 +17507,12 @@ ${body}`;
     return { text: "Passed", variant: "success" };
   }
 };
+function yamlScalar(value) {
+  if (/[:#[\]{}&*!|>'"%@`]|^[\s-]|\s$/.test(value)) {
+    return `'${value.replace(/'/g, "''")}'`;
+  }
+  return value;
+}
 
 // src/formatters/confluence.ts
 var ConfluenceFormatter = class {
@@ -17615,6 +17789,15 @@ ${tc.errorStack}` : "");
           ])
         );
         break;
+      case "video":
+        content.push(
+          paragraph([
+            text(entry.caption ?? "Video", strong()),
+            text(": "),
+            link(entry.path, entry.path)
+          ])
+        );
+        break;
       case "custom":
         content.push(paragraph([text(`[${entry.type}]`, strong())]));
         content.push(codeBlock(JSON.stringify(entry.data ?? null, null, 2), "json"));
@@ -17784,6 +17967,13 @@ function scanMarkdownAssets(markdown) {
       found.add(src);
     }
   }
+  const posterRe = /<video[^>]+\bposter=["']([^"']+)["'][^>]*>/gi;
+  while ((match = posterRe.exec(stripped)) !== null) {
+    const src = match[1].trim();
+    if (isLocalPath(src)) {
+      found.add(src);
+    }
+  }
   return Array.from(found);
 }
 function splitByCode(markdown) {
@@ -17834,6 +18024,19 @@ function rewriteProseSegment(prose, assetsBaseUrl, pathMap) {
       return `${pre}${assetsBaseUrl}/${trimmed}${post}`;
     }
   );
+  result = result.replace(
+    /(<video[^>]+\bposter=["'])([^"']+)(["'][^>]*>)/gi,
+    (full, pre, src, post) => {
+      const trimmed = src.trim();
+      if (!isLocalPath(trimmed)) return full;
+      if (pathMap) {
+        const mapped = pathMap.get(trimmed);
+        if (mapped === void 0) return full;
+        return `${pre}${assetsBaseUrl}/${mapped}${post}`;
+      }
+      return `${pre}${assetsBaseUrl}/${trimmed}${post}`;
+    }
+  );
   return result;
 }
 function rewriteAssetPaths(markdown, assetsBaseUrl, pathMap) {
@@ -18281,14 +18484,14 @@ ${result.errors.join("\n")}`);
 }
 
 // src/coverage-index.ts
-function normalizePath(path11) {
-  return path11.replace(/^\.\//, "");
+function normalizePath(path12) {
+  return path12.replace(/^\.\//, "");
 }
 function scenariosCoveringPaths(index, paths) {
   const queries = paths.map(normalizePath);
   return index.scenarios.filter(
     (scenario) => scenario.covers.some(
-      (glob) => queries.some((path11) => matchesPattern(normalizePath(glob), path11))
+      (glob) => queries.some((path12) => matchesPattern(normalizePath(glob), path12))
     )
   );
 }
@@ -19600,7 +19803,7 @@ async function sendTeamsNotification(args, deps) {
 }
 
 // src/notifiers/hmac.ts
-var import_node_crypto3 = require("crypto");
+var import_node_crypto4 = require("crypto");
 function signBody(args) {
   let input;
   let timestamp;
@@ -19610,7 +19813,7 @@ function signBody(args) {
   } else {
     input = args.body;
   }
-  const hex = (0, import_node_crypto3.createHmac)("sha256", args.secret).update(input, "utf8").digest("hex");
+  const hex = (0, import_node_crypto4.createHmac)("sha256", args.secret).update(input, "utf8").digest("hex");
   return {
     signature: `sha256=${hex}`,
     timestamp
@@ -20206,18 +20409,18 @@ function deriveChangeType(tags) {
   }
   return "unknown";
 }
-function extensionOf(path11) {
-  const base = path11.split("/").pop() ?? path11;
+function extensionOf(path12) {
+  const base = path12.split("/").pop() ?? path12;
   const dot = base.lastIndexOf(".");
   return dot === -1 ? "" : base.slice(dot + 1).toLowerCase();
 }
-function isTestFile(path11) {
-  return TEST_INFIX.test(path11);
+function isTestFile(path12) {
+  return TEST_INFIX.test(path12);
 }
-function isReviewableSource(path11) {
-  if (isTestFile(path11)) return false;
-  if (path11.endsWith(".d.ts")) return false;
-  return CODE_EXTENSIONS.has(extensionOf(path11));
+function isReviewableSource(path12) {
+  if (isTestFile(path12)) return false;
+  if (path12.endsWith(".d.ts")) return false;
+  return CODE_EXTENSIONS.has(extensionOf(path12));
 }
 function testBaseKey(testFile) {
   return testFile.replace(TEST_INFIX, "");
@@ -20321,7 +20524,7 @@ function toClaim(testCase, changedSourcePaths) {
   const { strength, reasons } = gradeEvidence(testCase, audience);
   const key = testBaseKey(testCase.sourceFile);
   const coversFiles = changedSourcePaths.filter(
-    (path11) => sourceBaseKey(path11) === key
+    (path12) => sourceBaseKey(path12) === key
   );
   return {
     id: testCase.id,
@@ -20851,11 +21054,116 @@ applyTheme(getEffectiveTheme());` : "";
   }
 };
 
+// src/deploy/ledger.ts
+var fs9 = __toESM(require("fs"), 1);
+var path10 = __toESM(require("path"), 1);
+function createEmptyLedger() {
+  return {
+    deployments: [],
+    schemaVersion: 1
+  };
+}
+function loadLedger(ledgerPath) {
+  const resolved = path10.resolve(ledgerPath);
+  if (!fs9.existsSync(resolved)) {
+    return createEmptyLedger();
+  }
+  try {
+    const raw = JSON.parse(fs9.readFileSync(resolved, "utf8"));
+    if (raw.schemaVersion !== 1) {
+      throw new Error(`Unsupported ledger schemaVersion: ${raw.schemaVersion}`);
+    }
+    return raw;
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    throw new Error(`Failed to load deployment ledger at ${resolved}: ${msg}`);
+  }
+}
+function saveLedger(ledger, ledgerPath) {
+  const resolved = path10.resolve(ledgerPath);
+  const dir = path10.dirname(resolved);
+  fs9.mkdirSync(dir, { recursive: true });
+  fs9.writeFileSync(resolved, JSON.stringify(ledger, null, 2), "utf8");
+}
+function getLatestDeployment(ledger, environment) {
+  return [...ledger.deployments].reverse().find((d) => d.environment === environment);
+}
+
+// src/deploy/index.ts
+function recordDeployment(args) {
+  const ledger = loadLedger(args.ledgerPath);
+  const previous = getLatestDeployment(ledger, args.environment);
+  const entry = {
+    environment: args.environment,
+    tag: args.tag,
+    sha: args.run.gitSha,
+    runFile: args.runFilePath,
+    scenarioIds: args.run.testCases.map((tc) => tc.id),
+    scenarioStatuses: Object.fromEntries(args.run.testCases.map((tc) => [tc.id, tc.status])),
+    timestamp: new Date(args.run.finishedAtMs).toISOString(),
+    summary: countStatuses(args.run)
+  };
+  ledger.deployments.push(entry);
+  if (previous) {
+    const previousIds = new Set(previous.scenarioIds);
+    const added = entry.scenarioIds.filter((id) => !previousIds.has(id)).length;
+    const removed = previous.scenarioIds.filter((id) => !entry.scenarioIds.includes(id)).length;
+    if (added > 0 || removed > 0) {
+    }
+  }
+  saveLedger(ledger, args.ledgerPath);
+  return { entry, ledgerPath: args.ledgerPath };
+}
+function getDeploymentStatus(ledgerPath) {
+  const ledger = loadLedger(ledgerPath);
+  const environments = {};
+  for (const entry of ledger.deployments) {
+    environments[entry.environment] = {
+      latest: entry,
+      previousDeployment: environments[entry.environment]?.latest
+    };
+  }
+  return { environments, ledgerPath };
+}
+function getEnvironmentDrift(ledgerPath, envA, envB) {
+  const ledger = loadLedger(ledgerPath);
+  const aEntry = getLatestDeployment(ledger, envA);
+  const bEntry = getLatestDeployment(ledger, envB);
+  if (!aEntry) {
+    throw new Error(`No deployment found for environment "${envA}"`);
+  }
+  if (!bEntry) {
+    throw new Error(`No deployment found for environment "${envB}"`);
+  }
+  const aIds = new Set(aEntry.scenarioIds);
+  const bIds = new Set(bEntry.scenarioIds);
+  const onlyInA = aEntry.scenarioIds.filter((id) => !bIds.has(id));
+  const onlyInB = bEntry.scenarioIds.filter((id) => !aIds.has(id));
+  const inBoth = aEntry.scenarioIds.filter((id) => bIds.has(id));
+  const statusChanged = inBoth.map((id) => ({
+    id,
+    statusA: aEntry.scenarioStatuses?.[id] ?? "unknown",
+    statusB: bEntry.scenarioStatuses?.[id] ?? "unknown"
+  })).filter((item) => item.statusA !== item.statusB);
+  return { environmentA: envA, environmentB: envB, onlyInA, onlyInB, inBoth, statusChanged, aEntry, bEntry };
+}
+function countStatuses(run) {
+  const summary = { total: 0, passed: 0, failed: 0, skipped: 0, pending: 0 };
+  for (const tc of run.testCases) {
+    summary.total++;
+    if (tc.status in summary) {
+      summary[tc.status]++;
+    }
+  }
+  return summary;
+}
+
 // src/index.ts
 var FORMAT_EXTENSIONS = {
   astro: ".md",
   "behavior-manifest-json": ".behavior-manifest.json",
   markdown: ".md",
+  "release-manifest": ".release-manifest.md",
   html: ".html",
   "cucumber-html": ".cucumber.html",
   junit: ".junit.xml",
@@ -20865,6 +21173,10 @@ var FORMAT_EXTENSIONS = {
   "scenario-index-json": ".scenarios-index.json",
   "story-report-json": ".story-report.json"
 };
+function joinNameAndExt(name, ext) {
+  const stutter = `.${name}.`;
+  return ext.startsWith(stutter) ? `${name}.${ext.slice(stutter.length)}` : `${name}${ext}`;
+}
 var TEST_EXTENSIONS = [
   ".test.ts",
   ".test.tsx",
@@ -20890,11 +21202,11 @@ function computeOutputPath(sourceFile, format, mode, colocatedStyle, baseOutputD
   const ext = FORMAT_EXTENSIONS[format];
   const effectiveName = outputName + (outputNameSuffix ?? "");
   if (mode === "aggregated") {
-    return toPosix(path10.join(baseOutputDir, `${effectiveName}${ext}`));
+    return toPosix(path11.join(baseOutputDir, joinNameAndExt(effectiveName, ext)));
   }
   const normalizedSource = toPosix(sourceFile);
-  const dirOfSource = path10.posix.dirname(normalizedSource);
-  let baseName = path10.posix.basename(normalizedSource);
+  const dirOfSource = path11.posix.dirname(normalizedSource);
+  let baseName = path11.posix.basename(normalizedSource);
   for (const testExt of TEST_EXTENSIONS) {
     if (baseName.endsWith(testExt)) {
       baseName = baseName.slice(0, -testExt.length);
@@ -20903,9 +21215,12 @@ function computeOutputPath(sourceFile, format, mode, colocatedStyle, baseOutputD
   }
   const fileName = `${baseName}.${effectiveName}${ext}`;
   if (colocatedStyle === "adjacent") {
-    return toPosix(path10.posix.join(dirOfSource, fileName));
+    return toPosix(path11.posix.join(dirOfSource, fileName));
   }
-  return toPosix(path10.posix.join(baseOutputDir, dirOfSource, fileName));
+  if (colocatedStyle === "flat") {
+    return toPosix(path11.posix.join(baseOutputDir, `${cleanTestStem(normalizedSource)}${ext}`));
+  }
+  return toPosix(path11.posix.join(baseOutputDir, dirOfSource, fileName));
 }
 function groupTestCasesByOutput(testCases, format, options, logger, outputNameSuffix) {
   const groups = /* @__PURE__ */ new Map();
@@ -21112,8 +21427,8 @@ var ReportGenerator = class {
       if (astroPaths) {
         for (const mdPath of astroPaths) {
           const content = await fsPromises.readFile(mdPath, "utf8");
-          const mdDir = path10.dirname(mdPath);
-          const assetsDir = path10.resolve(this.options.astro.assetsDir);
+          const mdDir = path11.dirname(mdPath);
+          const assetsDir = path11.resolve(this.options.astro.assetsDir);
           const result = copyMarkdownAssets({
             markdown: content,
             markdownDir: mdDir,
@@ -21144,9 +21459,9 @@ 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 = toPosix(path10.join(this.options.outputDir, `${effectiveName}${ext}`));
+      const outputPath = toPosix(path11.join(this.options.outputDir, joinNameAndExt(effectiveName, ext)));
       const content = await this.formatContent(run, format);
-      const dir = path10.dirname(outputPath);
+      const dir = path11.dirname(outputPath);
       await fsPromises.mkdir(dir, { recursive: true });
       await this.deps.writeFile(outputPath, content);
       return [outputPath];
@@ -21158,7 +21473,7 @@ var ReportGenerator = class {
         testCases
       };
       const content = await this.formatContent(groupRun, format);
-      const dir = path10.dirname(outputPath);
+      const dir = path11.dirname(outputPath);
       await fsPromises.mkdir(dir, { recursive: true });
       await this.deps.writeFile(outputPath, content);
       writtenPaths.push(outputPath);
@@ -21224,6 +21539,8 @@ var ReportGenerator = class {
       case "astro": {
         const formatter = new AstroFormatter({
           assetsBaseUrl: this.options.astro.assetsBaseUrl,
+          // Colocated = one page per file, so title each by its own suite/file.
+          perFileTitle: this.options.output.mode === "colocated",
           markdown: this.options.astro.markdown
         });
         return formatter.format(run);
@@ -21265,6 +21582,10 @@ var ReportGenerator = class {
         });
         return formatter.format(run);
       }
+      case "release-manifest": {
+        const formatter = new ReleaseManifestFormatter();
+        return formatter.format(run);
+      }
       case "story-report-json": {
         const formatter = new StoryReportJsonFormatter({
           pretty: this.options.storyReportJson.pretty
@@ -21299,7 +21620,7 @@ async function generateRunComparison(args) {
   await fsPromises.mkdir(outputDir, { recursive: true });
   for (const format of args.formats) {
     const ext = format === "html" ? ".html" : ".md";
-    const outputPath = toPosix(path10.join(outputDir, `${outputName}${ext}`));
+    const outputPath = toPosix(path11.join(outputDir, `${outputName}${ext}`));
     const content = format === "html" ? new RunDiffHtmlFormatter({ title: args.title }).format(diff) : new RunDiffMarkdownFormatter({ title: args.title }).format(diff);
     await fsPromises.writeFile(outputPath, content, "utf8");
     files.push(outputPath);
@@ -21334,6 +21655,7 @@ function normalizePlaywrightResults(testResults, adapterOptions, canonicalizeOpt
   MIN_METRIC_SAMPLES,
   MIN_PERF_SAMPLES,
   MarkdownFormatter,
+  ReleaseManifestFormatter,
   ReportGenerator,
   ReviewHtmlFormatter,
   ReviewMarkdownFormatter,
@@ -21373,10 +21695,13 @@ function normalizePlaywrightResults(testResults, adapterOptions, canonicalizeOpt
   generateTestCaseId,
   getAvailableThemes,
   getCssOnlyThemes,
+  getDeploymentStatus,
+  getEnvironmentDrift,
   gradeEvidence,
   hasSufficientHistory,
   isReviewableSource,
   isTestFile,
+  joinNameAndExt,
   listScenarios,
   loadHistory,
   mergeStepResults,
@@ -21393,6 +21718,7 @@ function normalizePlaywrightResults(testResults, adapterOptions, canonicalizeOpt
   readBranchName,
   readGitSha,
   readPackageVersion,
+  recordDeployment,
   regenerateArtifacts,
   resolveAttachment,
   resolveAttachments,
@@ -21412,6 +21738,7 @@ function normalizePlaywrightResults(testResults, adapterOptions, canonicalizeOpt
   toBehaviorManifest,
   toCIInfo,
   toRawCIInfo,
+  toReleaseManifest,
   toScenarioIndex,
   toStoryReport,
   tryGetActiveOtelContext,