executable-stories-formatters 0.7.0 → 0.7.2

package/dist/cli.js

@@ -2,8 +2,8 @@
 
 // src/cli.ts
 import { parseArgs } from "util";
-import * as fs3 from "fs";
-import * as path3 from "path";
+import * as fs5 from "fs";
+import * as path5 from "path";
 
 // src/validation/schema-validator.ts
 import Ajv from "ajv/dist/2020.js";
@@ -175,8 +175,21 @@ var raw_run_schema_default = {
         },
         tickets: {
           type: "array",
-          items: { type: "string" },
-          description: "Ticket/issue references for requirements traceability (e.g., ['JIRA-123'])."
+          items: {
+            oneOf: [
+              { type: "string" },
+              {
+                type: "object",
+                properties: {
+                  id: { type: "string" },
+                  url: { type: "string" }
+                },
+                required: ["id"],
+                additionalProperties: false
+              }
+            ]
+          },
+          description: "Ticket/issue references. Each item is either a string ID or an object with id and optional url."
         },
         meta: {
           type: "object",
@@ -261,7 +274,8 @@ var raw_run_schema_default = {
           properties: {
             kind: { const: "note" },
             text: { type: "string" },
-            phase: { $ref: "#/$defs/DocPhase" }
+            phase: { $ref: "#/$defs/DocPhase" },
+            children: { type: "array", items: { $ref: "#/$defs/DocEntry" }, description: "Nested child doc entries for grouping." }
           },
           required: ["kind", "text", "phase"],
           additionalProperties: false
@@ -275,7 +289,8 @@ var raw_run_schema_default = {
               type: "array",
               items: { type: "string" }
             },
-            phase: { $ref: "#/$defs/DocPhase" }
+            phase: { $ref: "#/$defs/DocPhase" },
+            children: { type: "array", items: { $ref: "#/$defs/DocEntry" }, description: "Nested child doc entries for grouping." }
           },
           required: ["kind", "names", "phase"],
           additionalProperties: false
@@ -287,7 +302,8 @@ var raw_run_schema_default = {
             kind: { const: "kv" },
             label: { type: "string" },
             value: {},
-            phase: { $ref: "#/$defs/DocPhase" }
+            phase: { $ref: "#/$defs/DocPhase" },
+            children: { type: "array", items: { $ref: "#/$defs/DocEntry" }, description: "Nested child doc entries for grouping." }
           },
           required: ["kind", "label", "value", "phase"],
           additionalProperties: false
@@ -300,7 +316,8 @@ var raw_run_schema_default = {
             label: { type: "string" },
             content: { type: "string" },
             lang: { type: "string" },
-            phase: { $ref: "#/$defs/DocPhase" }
+            phase: { $ref: "#/$defs/DocPhase" },
+            children: { type: "array", items: { $ref: "#/$defs/DocEntry" }, description: "Nested child doc entries for grouping." }
           },
           required: ["kind", "label", "content", "phase"],
           additionalProperties: false
@@ -322,7 +339,8 @@ var raw_run_schema_default = {
                 items: { type: "string" }
               }
             },
-            phase: { $ref: "#/$defs/DocPhase" }
+            phase: { $ref: "#/$defs/DocPhase" },
+            children: { type: "array", items: { $ref: "#/$defs/DocEntry" }, description: "Nested child doc entries for grouping." }
           },
           required: ["kind", "label", "columns", "rows", "phase"],
           additionalProperties: false
@@ -334,7 +352,8 @@ var raw_run_schema_default = {
             kind: { const: "link" },
             label: { type: "string" },
             url: { type: "string" },
-            phase: { $ref: "#/$defs/DocPhase" }
+            phase: { $ref: "#/$defs/DocPhase" },
+            children: { type: "array", items: { $ref: "#/$defs/DocEntry" }, description: "Nested child doc entries for grouping." }
           },
           required: ["kind", "label", "url", "phase"],
           additionalProperties: false
@@ -346,7 +365,8 @@ var raw_run_schema_default = {
             kind: { const: "section" },
             title: { type: "string" },
             markdown: { type: "string" },
-            phase: { $ref: "#/$defs/DocPhase" }
+            phase: { $ref: "#/$defs/DocPhase" },
+            children: { type: "array", items: { $ref: "#/$defs/DocEntry" }, description: "Nested child doc entries for grouping." }
           },
           required: ["kind", "title", "markdown", "phase"],
           additionalProperties: false
@@ -358,7 +378,8 @@ var raw_run_schema_default = {
             kind: { const: "mermaid" },
             code: { type: "string" },
             title: { type: "string" },
-            phase: { $ref: "#/$defs/DocPhase" }
+            phase: { $ref: "#/$defs/DocPhase" },
+            children: { type: "array", items: { $ref: "#/$defs/DocEntry" }, description: "Nested child doc entries for grouping." }
           },
           required: ["kind", "code", "phase"],
           additionalProperties: false
@@ -370,7 +391,8 @@ var raw_run_schema_default = {
             kind: { const: "screenshot" },
             path: { type: "string" },
             alt: { type: "string" },
-            phase: { $ref: "#/$defs/DocPhase" }
+            phase: { $ref: "#/$defs/DocPhase" },
+            children: { type: "array", items: { $ref: "#/$defs/DocEntry" }, description: "Nested child doc entries for grouping." }
           },
           required: ["kind", "path", "phase"],
           additionalProperties: false
@@ -382,7 +404,8 @@ var raw_run_schema_default = {
             kind: { const: "custom" },
             type: { type: "string" },
             data: {},
-            phase: { $ref: "#/$defs/DocPhase" }
+            phase: { $ref: "#/$defs/DocPhase" },
+            children: { type: "array", items: { $ref: "#/$defs/DocEntry" }, description: "Nested child doc entries for grouping." }
           },
           required: ["kind", "type", "data", "phase"],
           additionalProperties: false
@@ -469,17 +492,17 @@ function validateRawRun(data) {
     return { valid: true, errors: [] };
   }
   const errors = (validate.errors ?? []).map((err) => {
-    const path4 = err.instancePath || "/";
+    const path6 = err.instancePath || "/";
     const message = err.message ?? "unknown error";
     if (err.keyword === "additionalProperties") {
       const extra = err.params.additionalProperty;
-      return `${path4}: ${message} \u2014 '${extra}'`;
+      return `${path6}: ${message} \u2014 '${extra}'`;
     }
     if (err.keyword === "enum") {
       const allowed = err.params.allowedValues;
-      return `${path4}: ${message} \u2014 allowed: ${JSON.stringify(allowed)}`;
+      return `${path6}: ${message} \u2014 allowed: ${JSON.stringify(allowed)}`;
     }
-    return `${path4}: ${message}`;
+    return `${path6}: ${message}`;
   });
   return { valid: false, errors };
 }
@@ -793,6 +816,9 @@ function canonicalizeTestCase(raw, options, projectRoot) {
     projectRoot
   });
   const tags = normalizeTags(story);
+  if (story.tickets) {
+    story.tickets = normalizeTickets(story.tickets);
+  }
   const titlePath = buildTitlePath(raw, story);
   return {
     id,
@@ -816,6 +842,9 @@ function normalizeTags(story) {
   const tags = story.tags ?? [];
   return [...new Set(tags)].sort();
 }
+function normalizeTickets(raw) {
+  return raw.map((t) => typeof t === "string" ? { id: t } : t);
+}
 function buildTitlePath(raw, story) {
   if (story.suitePath && story.suitePath.length > 0) {
     return story.suitePath;
@@ -937,7 +966,7 @@ ${result.errors.join("\n")}`);
 
 // src/index.ts
 import "fs";
-import * as path2 from "path";
+import * as path4 from "path";
 import * as fsPromises from "fs/promises";
 
 // src/converters/acl/lines.ts
@@ -3247,6 +3276,16 @@ body {
   background: none;
 }
 
+/* ============================================================================
+   Documentation Entries - Children
+   ============================================================================ */
+.doc-children {
+  margin-left: 1rem;
+  padding-left: 1rem;
+  border-left: 2px solid var(--border);
+  margin-top: 0.25rem;
+}
+
 /* ============================================================================
    Trace View - OTel span waterfall
    ============================================================================ */
@@ -12958,30 +12997,46 @@ function renderDocCustom(entry, deps) {
 </div>`;
 }
 function renderDocEntry(entry, deps) {
+  let html;
   switch (entry.kind) {
     case "note":
-      return renderDocNote(entry, deps);
+      html = renderDocNote(entry, deps);
+      break;
     case "tag":
-      return renderDocTag(entry, deps);
+      html = renderDocTag(entry, deps);
+      break;
     case "kv":
-      return renderDocKv(entry, deps);
+      html = renderDocKv(entry, deps);
+      break;
     case "code":
-      return renderDocCode(entry, deps);
+      html = renderDocCode(entry, deps);
+      break;
     case "table":
-      return renderDocTable(entry, deps);
+      html = renderDocTable(entry, deps);
+      break;
     case "link":
-      return renderDocLink(entry, deps);
+      html = renderDocLink(entry, deps);
+      break;
     case "section":
-      return renderDocSection(entry, deps);
+      html = renderDocSection(entry, deps);
+      break;
     case "mermaid":
-      return renderDocMermaid(entry, deps);
+      html = renderDocMermaid(entry, deps);
+      break;
     case "screenshot":
-      return renderDocScreenshot(entry, deps);
+      html = renderDocScreenshot(entry, deps);
+      break;
     case "custom":
-      return renderDocCustom(entry, deps);
+      html = renderDocCustom(entry, deps);
+      break;
     default:
-      return "";
+      html = "";
+  }
+  if (entry.children && entry.children.length > 0) {
+    const childrenHtml = entry.children.map((child) => renderDocEntry(child, deps)).join("");
+    html += `<div class="doc-children">${childrenHtml}</div>`;
   }
+  return html;
 }
 
 // src/formatters/html/renderers/steps.ts
@@ -13038,12 +13093,20 @@ function highlightStepParams(text, deps) {
 var MIN_METRIC_SAMPLES = 5;
 
 // src/formatters/html/renderers/scenario.ts
+function renderTicket(ticket, template, escapeHtml3) {
+  const url = ticket.url ?? (template ? template.replace("{ticket}", ticket.id) : void 0);
+  if (url) {
+    return `<a class="tag ticket-tag" href="${escapeHtml3(url)}" target="_blank" rel="noopener noreferrer">${escapeHtml3(ticket.id)}</a>`;
+  }
+  return `<span class="tag ticket-tag">${escapeHtml3(ticket.id)}</span>`;
+}
 function renderScenario(args, deps) {
   const { tc } = args;
   const statusIcon = deps.getStatusIcon(tc.status);
   const statusClass = `status-${tc.status}`;
   const duration = tc.durationMs > 0 ? `${(tc.durationMs / 1e3).toFixed(2)}s` : "";
   const tags = tc.tags.map((t) => `<span class="tag">${deps.escapeHtml(t)}</span>`).join("");
+  const tickets = (tc.story.tickets ?? []).map((t) => renderTicket(t, deps.ticketUrlTemplate, deps.escapeHtml)).join("");
   const otelMeta = tc.story.meta?.otel;
   let traceBadge = "";
   if (otelMeta?.traceId) {
@@ -13111,7 +13174,7 @@ function renderScenario(args, deps) {
         <span class="status-icon ${statusClass}">${statusIcon}</span>
         <span class="scenario-name">${deps.escapeHtml(tc.story.scenario)}</span>
       </div>
-      <div class="scenario-meta">${tags}${sourceLink}${traceBadge}${metricBadges}</div>
+      <div class="scenario-meta">${tags}${tickets}${sourceLink}${traceBadge}${metricBadges}</div>
     </div>
     <span class="scenario-duration">${duration}</span>
   </div>
@@ -13456,6 +13519,7 @@ function normalizeOptions(options = {}) {
     mermaidEnabled: options.mermaidEnabled ?? true,
     markdownEnabled: options.markdownEnabled ?? true,
     permalinkBaseUrl: options.permalinkBaseUrl,
+    ticketUrlTemplate: options.ticketUrlTemplate,
     theme: options.theme ?? "default"
   };
 }
@@ -13488,7 +13552,8 @@ function createHtmlFormatter(options = {}) {
     renderAttachments: (args, d) => renderAttachments(args, d),
     renderTraceView: (args, d) => renderTraceView(args, d),
     embedScreenshots: opts.embedScreenshots,
-    permalinkBaseUrl: opts.permalinkBaseUrl
+    permalinkBaseUrl: opts.permalinkBaseUrl,
+    ticketUrlTemplate: opts.ticketUrlTemplate
   };
   const featureDeps = {
     escapeHtml,
@@ -14001,14 +14066,16 @@ var MarkdownFormatter = class {
     }
     if (tc.story.tickets && tc.story.tickets.length > 0) {
       const ticketTemplate = this.options.ticketUrlTemplate;
-      if (ticketTemplate) {
-        const ticketLinks = tc.story.tickets.map(
-          (t) => `[${t}](${ticketTemplate.replace("{ticket}", t)})`
-        );
-        meta.push(`Tickets: ${ticketLinks.join(", ")}`);
-      } else {
-        meta.push(`Tickets: ${tc.story.tickets.map((t) => `\`${t}\``).join(", ")}`);
-      }
+      const ticketLinks = tc.story.tickets.map((t) => {
+        if (t.url) {
+          return `[${t.id}](${t.url})`;
+        }
+        if (ticketTemplate) {
+          return `[${t.id}](${ticketTemplate.replace("{ticket}", t.id)})`;
+        }
+        return `\`${t.id}\``;
+      });
+      meta.push(`Tickets: ${ticketLinks.join(", ")}`);
     }
     const otelMeta = tc.story.meta?.otel;
     if (otelMeta?.traceId) {
@@ -14182,6 +14249,12 @@ var MarkdownFormatter = class {
         lines.push(`${indent}`);
         break;
     }
+    if (entry.children && entry.children.length > 0) {
+      const childIndent = indent + "  ";
+      for (const child of entry.children) {
+        this.renderDocEntry(lines, child, childIndent);
+      }
+    }
   }
   /**
    * Get status icon for a status.
@@ -14254,8 +14327,8 @@ function extractFeatureName(testCases, uri) {
       return tc.titlePath[0];
     }
   }
-  const basename2 = uri.replace(/^.*[\\/]/, "").replace(/\.[^.]+$/, "");
-  return basename2.replace(/[-_]+/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
+  const basename3 = uri.replace(/^.*[\\/]/, "").replace(/\.[^.]+$/, "");
+  return basename3.replace(/[-_]+/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
 }
 function synthesizeFeature(uri, testCases) {
   const featureName = extractFeatureName(testCases, uri);
@@ -14867,8 +14940,8 @@ function extractDocAttachments(step) {
   }
   return attachments;
 }
-function guessMediaType(path4) {
-  const lower = path4.toLowerCase();
+function guessMediaType(path6) {
+  const lower = path6.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";
@@ -15009,11 +15082,11 @@ var CucumberHtmlFormatter = class {
     for (const envelope of envelopes) {
       const accepted = htmlStream.write(envelope);
       if (!accepted) {
-        await new Promise((resolve3) => htmlStream.once("drain", resolve3));
+        await new Promise((resolve4) => htmlStream.once("drain", resolve4));
       }
     }
-    await new Promise((resolve3, reject) => {
-      collector.on("finish", resolve3);
+    await new Promise((resolve4, reject) => {
+      collector.on("finish", resolve4);
       collector.on("error", reject);
       htmlStream.end();
     });
@@ -15161,7 +15234,7 @@ function buildFlags(baseline, current) {
     steps: stableJson(baseline.story.steps) !== stableJson(current.story.steps),
     docs: stableJson(baselineDocs) !== stableJson(currentDocs),
     tags: !compareStringArrays(baseline.tags, current.tags),
-    tickets: !compareStringArrays(baseline.story.tickets ?? [], current.story.tickets ?? []),
+    tickets: stableJson(baseline.story.tickets ?? []) !== stableJson(current.story.tickets ?? []),
     source: baseline.sourceFile !== current.sourceFile || baseline.sourceLine !== current.sourceLine,
     duration: baseline.durationMs !== current.durationMs,
     attachments: stableJson(baseline.attachments) !== stableJson(current.attachments),
@@ -15384,7 +15457,7 @@ function renderScenarioCard(scenario) {
                   <dd>${escapeHtml2(before.errorMessage ?? "") || "&nbsp;"}</dd>
                   ${scenario.flags.steps ? `<dt>Steps</dt><dd>${formatSteps(before.steps)}</dd>` : ""}
                   ${scenario.flags.docs ? `<dt>Docs</dt><dd>${formatDocs(before.docs)}</dd>` : ""}
-                  ${scenario.flags.tickets ? `<dt>Tickets</dt><dd>${escapeHtml2(before.tickets.join(", ")) || "&nbsp;"}</dd>` : ""}
+                  ${scenario.flags.tickets ? `<dt>Tickets</dt><dd>${escapeHtml2(before.tickets.map((t) => t.id).join(", ")) || "&nbsp;"}</dd>` : ""}
                 </dl>
               </section>
               <section>
@@ -15398,7 +15471,7 @@ function renderScenarioCard(scenario) {
                   <dd>${escapeHtml2(after.errorMessage ?? "") || "&nbsp;"}</dd>
                   ${scenario.flags.steps ? `<dt>Steps</dt><dd>${formatSteps(after.steps)}</dd>` : ""}
                   ${scenario.flags.docs ? `<dt>Docs</dt><dd>${formatDocs(after.docs)}</dd>` : ""}
-                  ${scenario.flags.tickets ? `<dt>Tickets</dt><dd>${escapeHtml2(after.tickets.join(", ")) || "&nbsp;"}</dd>` : ""}
+                  ${scenario.flags.tickets ? `<dt>Tickets</dt><dd>${escapeHtml2(after.tickets.map((t) => t.id).join(", ")) || "&nbsp;"}</dd>` : ""}
                 </dl>
               </section>
             </div>` : (() => {
@@ -15412,7 +15485,7 @@ function renderScenarioCard(scenario) {
     return `<div class="snapshot-detail">
                 <dl>
                   ${hasTags ? `<dt>Tags</dt><dd>${escapeHtml2(snapshot.tags.join(", "))}</dd>` : ""}
-                  ${hasTickets ? `<dt>Tickets</dt><dd>${escapeHtml2(snapshot.tickets.join(", "))}</dd>` : ""}
+                  ${hasTickets ? `<dt>Tickets</dt><dd>${escapeHtml2(snapshot.tickets.map((t) => t.id).join(", "))}</dd>` : ""}
                   ${hasSteps ? `<dt>Steps</dt><dd>${formatSteps(snapshot.steps)}</dd>` : ""}
                   ${hasDocs ? `<dt>Docs</dt><dd>${formatDocs(snapshot.docs)}</dd>` : ""}
                 </dl>
@@ -15727,7 +15800,7 @@ function renderScenario2(lines, scenario) {
       lines.push(`| Docs | ${escapeCell(formatDocs2(before.docs))} | ${escapeCell(formatDocs2(after.docs))} |`);
     }
     if (scenario.flags.tickets) {
-      lines.push(`| Tickets | ${escapeCell(before.tickets.join(", "))} | ${escapeCell(after.tickets.join(", "))} |`);
+      lines.push(`| Tickets | ${escapeCell(before.tickets.map((t) => t.id).join(", "))} | ${escapeCell(after.tickets.map((t) => t.id).join(", "))} |`);
     }
     lines.push("");
   } else {
@@ -15743,7 +15816,7 @@ function renderSnapshotDetail(lines, snapshot) {
     lines.push("");
   }
   if (snapshot.tickets.length > 0) {
-    lines.push(`**Tickets:** ${snapshot.tickets.join(", ")}`);
+    lines.push(`**Tickets:** ${snapshot.tickets.map((t) => t.id).join(", ")}`);
     lines.push("");
   }
   if (snapshot.steps.length > 0) {
@@ -15941,6 +16014,110 @@ function selectTestCases(args, deps) {
   return sortTestCases(selected, sortMode);
 }
 
+// src/bundler/bundle-assets.ts
+import * as fs3 from "fs";
+import * as path3 from "path";
+
+// src/bundler/scan-html-assets.ts
+function scanHtmlAssets(html) {
+  const seen = /* @__PURE__ */ new Set();
+  const patterns = [
+    /<(?:img|video)\b[^>]*?\bsrc=["']([^"']+)["']/g,
+    /<a\b[^>]*?\bclass=["']attachment["'][^>]*?\bhref=["']([^"']+)["']/g,
+    /<a\b[^>]*?\bhref=["']([^"']+)["'][^>]*?\bclass=["']attachment["']/g
+  ];
+  for (const pattern of patterns) {
+    let match;
+    while ((match = pattern.exec(html)) !== null) {
+      const ref = match[1];
+      if (isLocalAssetRef(ref) && !seen.has(ref)) {
+        seen.add(ref);
+      }
+    }
+  }
+  return [...seen];
+}
+function isLocalAssetRef(ref) {
+  if (!ref) return false;
+  if (ref.startsWith("data:")) return false;
+  if (ref.startsWith("http://") || ref.startsWith("https://")) return false;
+  if (ref.startsWith("#")) return false;
+  return true;
+}
+
+// src/bundler/copy-asset.ts
+import * as fs2 from "fs";
+import * as path2 from "path";
+import * as crypto from "crypto";
+function copyAsset(sourcePath, assetsDir) {
+  if (!fs2.existsSync(assetsDir)) {
+    fs2.mkdirSync(assetsDir, { recursive: true });
+  }
+  const content = fs2.readFileSync(sourcePath);
+  const hash = crypto.createHash("sha256").update(content).digest("hex").slice(0, 8);
+  const ext = path2.extname(sourcePath);
+  const baseName = sanitize(path2.basename(sourcePath, ext));
+  const destName = `${baseName}-${hash}${ext}`;
+  const destPath = path2.join(assetsDir, destName);
+  if (!fs2.existsSync(destPath)) {
+    fs2.copyFileSync(sourcePath, destPath);
+  }
+  return `assets/${destName}`;
+}
+function sanitize(name) {
+  return name.replace(/[^a-zA-Z0-9._-]/g, "-").replace(/-{2,}/g, "-").replace(/^-|-$/g, "");
+}
+
+// src/bundler/bundle-assets.ts
+function bundleAssets(htmlPath, options = {}) {
+  const htmlDir = path3.dirname(htmlPath);
+  const assetsDir = path3.join(htmlDir, "assets");
+  let html = fs3.readFileSync(htmlPath, "utf8");
+  const refs = scanHtmlAssets(html);
+  let copiedCount = 0;
+  const missing = [];
+  for (const ref of refs) {
+    const absolutePath = path3.resolve(htmlDir, ref);
+    if (!fs3.existsSync(absolutePath)) {
+      missing.push(ref);
+      continue;
+    }
+    const newRelPath = copyAsset(absolutePath, assetsDir);
+    html = replaceAssetRef(html, ref, newRelPath);
+    copiedCount++;
+  }
+  if (missing.length > 0 && !options.allowMissing) {
+    throw new Error(
+      `Missing asset${missing.length > 1 ? "s" : ""}: ${missing.join(", ")}`
+    );
+  }
+  fs3.writeFileSync(htmlPath, html, "utf8");
+  return {
+    copiedCount,
+    missingCount: missing.length,
+    missing
+  };
+}
+function replaceAssetRef(html, original, replacement) {
+  const escaped = original.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const srcPattern = new RegExp(
+    `(<(?:img|video)\\b[^>]*?\\bsrc=["'])${escaped}(["'])`,
+    "g"
+  );
+  html = html.replace(srcPattern, `$1${replacement}$2`);
+  const hrefClassFirst = new RegExp(
+    `(<a\\b[^>]*?\\bclass=["']attachment["'][^>]*?\\bhref=["'])${escaped}(["'])`,
+    "g"
+  );
+  html = html.replace(hrefClassFirst, `$1${replacement}$2`);
+  const hrefHrefFirst = new RegExp(
+    `(<a\\b[^>]*?\\bhref=["'])${escaped}(["'][^>]*?\\bclass=["']attachment["'])`,
+    "g"
+  );
+  html = html.replace(hrefHrefFirst, `$1${replacement}$2`);
+  return html;
+}
+
 // src/converters/ndjson-parser.ts
 function parseNdjson(ndjson) {
   const lines = ndjson.trim().split("\n").filter(Boolean);
@@ -16967,11 +17144,11 @@ function computeOutputPath(sourceFile, format, mode, colocatedStyle, baseOutputD
   const ext = FORMAT_EXTENSIONS[format];
   const effectiveName = outputName + (outputNameSuffix ?? "");
   if (mode === "aggregated") {
-    return toPosix(path2.join(baseOutputDir, `${effectiveName}${ext}`));
+    return toPosix(path4.join(baseOutputDir, `${effectiveName}${ext}`));
   }
   const normalizedSource = toPosix(sourceFile);
-  const dirOfSource = path2.posix.dirname(normalizedSource);
-  let baseName = path2.posix.basename(normalizedSource);
+  const dirOfSource = path4.posix.dirname(normalizedSource);
+  let baseName = path4.posix.basename(normalizedSource);
   for (const testExt of TEST_EXTENSIONS) {
     if (baseName.endsWith(testExt)) {
       baseName = baseName.slice(0, -testExt.length);
@@ -16980,9 +17157,9 @@ function computeOutputPath(sourceFile, format, mode, colocatedStyle, baseOutputD
   }
   const fileName = `${baseName}.${effectiveName}${ext}`;
   if (colocatedStyle === "adjacent") {
-    return toPosix(path2.posix.join(dirOfSource, fileName));
+    return toPosix(path4.posix.join(dirOfSource, fileName));
   }
-  return toPosix(path2.posix.join(baseOutputDir, dirOfSource, fileName));
+  return toPosix(path4.posix.join(baseOutputDir, dirOfSource, fileName));
 }
 function groupTestCasesByOutput(testCases, format, options, logger, outputNameSuffix) {
   const groups = /* @__PURE__ */ new Map();
@@ -17081,6 +17258,7 @@ var ReportGenerator = class {
         mermaidEnabled: options.html?.mermaidEnabled ?? true,
         markdownEnabled: options.html?.markdownEnabled ?? true,
         permalinkBaseUrl: options.html?.permalinkBaseUrl,
+        ticketUrlTemplate: options.html?.ticketUrlTemplate,
         theme: options.html?.theme ?? "default"
       },
       junit: {
@@ -17104,7 +17282,9 @@ var ReportGenerator = class {
         traceUrlTemplate: options.markdown?.traceUrlTemplate,
         includeSourceLinks: options.markdown?.includeSourceLinks ?? true,
         customRenderers: options.markdown?.customRenderers
-      }
+      },
+      assetMode: options.assetMode ?? "none",
+      allowMissingAssets: options.allowMissingAssets ?? false
     };
   }
   /**
@@ -17131,6 +17311,16 @@ var ReportGenerator = class {
       const paths = await this.generateFormat(filteredRun, format);
       results.set(format, paths);
     }
+    if (this.options.assetMode === "copy") {
+      const htmlPaths = results.get("html");
+      if (htmlPaths) {
+        for (const htmlPath of htmlPaths) {
+          bundleAssets(htmlPath, {
+            allowMissing: this.options.allowMissingAssets
+          });
+        }
+      }
+    }
     return results;
   }
   /**
@@ -17148,9 +17338,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(path2.join(this.options.outputDir, `${effectiveName}${ext}`));
+      const outputPath = toPosix(path4.join(this.options.outputDir, `${effectiveName}${ext}`));
       const content = await this.formatContent(run, format);
-      const dir = path2.dirname(outputPath);
+      const dir = path4.dirname(outputPath);
       await fsPromises.mkdir(dir, { recursive: true });
       await this.deps.writeFile(outputPath, content);
       return [outputPath];
@@ -17162,7 +17352,7 @@ var ReportGenerator = class {
         testCases
       };
       const content = await this.formatContent(groupRun, format);
-      const dir = path2.dirname(outputPath);
+      const dir = path4.dirname(outputPath);
       await fsPromises.mkdir(dir, { recursive: true });
       await this.deps.writeFile(outputPath, content);
       writtenPaths.push(outputPath);
@@ -17191,7 +17381,8 @@ var ReportGenerator = class {
           syntaxHighlighting: this.options.html.syntaxHighlighting,
           mermaidEnabled: this.options.html.mermaidEnabled,
           markdownEnabled: this.options.html.markdownEnabled,
-          permalinkBaseUrl: this.options.html.permalinkBaseUrl
+          permalinkBaseUrl: this.options.html.permalinkBaseUrl,
+          ticketUrlTemplate: this.options.html.ticketUrlTemplate
         });
         return formatter.format(run);
       }
@@ -17256,7 +17447,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(path2.join(outputDir, `${outputName}${ext}`));
+    const outputPath = toPosix(path4.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);
@@ -17312,6 +17503,9 @@ OPTIONS
   --html-no-mermaid             Disable mermaid diagrams in HTML (enabled by default)
   --html-no-markdown            Disable markdown parsing in HTML (enabled by default)
   --html-permalink-base-url <url> Base URL for source permalinks in HTML (e.g. "https://github.com/org/repo/blob/main")
+  --html-ticket-url-template <url> URL template for ticket links in HTML (use {ticket} as placeholder)
+  --asset-mode <mode>         Asset bundling: "none" (default) or "copy"
+  --allow-missing-assets      Warn on missing assets instead of failing
   --stdin                       Read JSON from stdin instead of file
   --json-summary                Print machine-parsable JSON summary
   --baseline <path|auto>        Compare baseline file, or auto-pick a prior run for compare
@@ -17391,6 +17585,7 @@ function parseCliArgs(argv) {
       "html-no-mermaid": { type: "boolean", default: false },
       "html-no-markdown": { type: "boolean", default: false },
       "html-permalink-base-url": { type: "string" },
+      "html-ticket-url-template": { type: "string" },
       stdin: { type: "boolean", default: false },
       "json-summary": { type: "boolean", default: false },
       "emit-canonical": { type: "string" },
@@ -17407,6 +17602,8 @@ function parseCliArgs(argv) {
       "webhook-hmac-secret": { type: "string" },
       "webhook-hmac-header": { type: "string" },
       "webhook-hmac-timestamp": { type: "boolean", default: false },
+      "asset-mode": { type: "string", default: "none" },
+      "allow-missing-assets": { type: "boolean", default: false },
       "pr-summary": { type: "boolean", default: false },
       "pr-summary-file": { type: "string" },
       help: { type: "boolean", default: false }
@@ -17516,6 +17713,12 @@ function parseCliArgs(argv) {
     console.error(`Error: --sort-test-cases must be id, source, or none, got "${sortTestCasesRaw}".`);
     process.exit(EXIT_USAGE);
   }
+  const assetModeRaw = values["asset-mode"];
+  const validAssetModes = /* @__PURE__ */ new Set(["none", "copy"]);
+  if (!validAssetModes.has(assetModeRaw)) {
+    console.error(`Error: --asset-mode must be "none" or "copy", got "${assetModeRaw}".`);
+    process.exit(EXIT_USAGE);
+  }
   return {
     subcommand,
     inputFile,
@@ -17541,6 +17744,7 @@ function parseCliArgs(argv) {
     htmlNoMermaid: values["html-no-mermaid"],
     htmlNoMarkdown: values["html-no-markdown"],
     htmlPermalinkBaseUrl: values["html-permalink-base-url"],
+    htmlTicketUrlTemplate: values["html-ticket-url-template"],
     jsonSummary: values["json-summary"],
     emitCanonical: values["emit-canonical"],
     slackWebhook,
@@ -17556,6 +17760,8 @@ function parseCliArgs(argv) {
     webhookHmacSecret: values["webhook-hmac-secret"],
     webhookHmacHeader: values["webhook-hmac-header"] ?? "X-Signature",
     webhookHmacTimestamp: values["webhook-hmac-timestamp"],
+    assetMode: assetModeRaw,
+    allowMissingAssets: values["allow-missing-assets"],
     prSummary: values["pr-summary"],
     prSummaryFile: values["pr-summary-file"]
   };
@@ -17564,27 +17770,27 @@ async function readInput(args) {
   if (args.stdin) {
     return readStdin();
   }
-  const filePath = path3.resolve(args.inputFile);
-  if (!fs3.existsSync(filePath)) {
+  const filePath = path5.resolve(args.inputFile);
+  if (!fs5.existsSync(filePath)) {
     console.error(`Error: File not found: ${filePath}`);
     process.exit(EXIT_USAGE);
   }
-  return fs3.readFileSync(filePath, "utf8");
+  return fs5.readFileSync(filePath, "utf8");
 }
 function readFileInput(filePath) {
-  const resolved = path3.resolve(filePath);
-  if (!fs3.existsSync(resolved)) {
+  const resolved = path5.resolve(filePath);
+  if (!fs5.existsSync(resolved)) {
     console.error(`Error: File not found: ${resolved}`);
     process.exit(EXIT_USAGE);
   }
-  return fs3.readFileSync(resolved, "utf8");
+  return fs5.readFileSync(resolved, "utf8");
 }
 function readStdin() {
-  return new Promise((resolve3, reject) => {
+  return new Promise((resolve4, reject) => {
     const chunks = [];
     process.stdin.setEncoding("utf8");
     process.stdin.on("data", (chunk) => chunks.push(chunk));
-    process.stdin.on("end", () => resolve3(chunks.join("")));
+    process.stdin.on("end", () => resolve4(chunks.join("")));
     process.stdin.on("error", reject);
   });
 }
@@ -17710,14 +17916,14 @@ function tryNormalizeRunFromText(text, args) {
   }
 }
 function listBaselineCandidates(currentFile, args) {
-  const baselineDir = path3.resolve(args.baselineDir ?? path3.dirname(currentFile));
-  const currentResolved = path3.resolve(currentFile);
-  if (!fs3.existsSync(baselineDir)) {
+  const baselineDir = path5.resolve(args.baselineDir ?? path5.dirname(currentFile));
+  const currentResolved = path5.resolve(currentFile);
+  if (!fs5.existsSync(baselineDir)) {
     console.error(`Error: baseline directory not found: ${baselineDir}`);
     process.exit(EXIT_USAGE);
   }
-  const entries = fs3.readdirSync(baselineDir, { withFileTypes: true });
-  return entries.filter((entry) => entry.isFile()).map((entry) => path3.join(baselineDir, entry.name)).filter((candidate) => path3.resolve(candidate) !== currentResolved).filter(
+  const entries = fs5.readdirSync(baselineDir, { withFileTypes: true });
+  return entries.filter((entry) => entry.isFile()).map((entry) => path5.join(baselineDir, entry.name)).filter((candidate) => path5.resolve(candidate) !== currentResolved).filter(
     (candidate) => args.inputType === "ndjson" ? candidate.endsWith(".ndjson") : candidate.endsWith(".json")
   );
 }
@@ -17725,14 +17931,14 @@ function resolveBaselineAuto(currentFile, currentRun, args) {
   const candidates = listBaselineCandidates(currentFile, args);
   const comparable = [];
   for (const candidate of candidates) {
-    const run = tryNormalizeRunFromText(fs3.readFileSync(candidate, "utf8"), args);
+    const run = tryNormalizeRunFromText(fs5.readFileSync(candidate, "utf8"), args);
     if (run) {
       comparable.push({ file: candidate, run });
     }
   }
   if (comparable.length === 0) {
     console.error(
-      `Error: no compatible baseline files found in ${path3.resolve(args.baselineDir ?? path3.dirname(currentFile))}.`
+      `Error: no compatible baseline files found in ${path5.resolve(args.baselineDir ?? path5.dirname(currentFile))}.`
     );
     process.exit(EXIT_USAGE);
   }
@@ -17813,9 +18019,9 @@ async function main() {
       process.exit(EXIT_SCHEMA_VALIDATION);
     }
     if (args.emitCanonical) {
-      const outPath = path3.resolve(args.emitCanonical);
-      fs3.mkdirSync(path3.dirname(outPath), { recursive: true });
-      fs3.writeFileSync(outPath, JSON.stringify(run, null, 2), "utf8");
+      const outPath = path5.resolve(args.emitCanonical);
+      fs5.mkdirSync(path5.dirname(outPath), { recursive: true });
+      fs5.writeFileSync(outPath, JSON.stringify(run, null, 2), "utf8");
     }
     try {
       const result = await generateReports(run, args);
@@ -17871,9 +18077,9 @@ ${msg}`);
     }
     const run = data;
     if (args.emitCanonical) {
-      const outPath = path3.resolve(args.emitCanonical);
-      fs3.mkdirSync(path3.dirname(outPath), { recursive: true });
-      fs3.writeFileSync(outPath, JSON.stringify(run, null, 2), "utf8");
+      const outPath = path5.resolve(args.emitCanonical);
+      fs5.mkdirSync(path5.dirname(outPath), { recursive: true });
+      fs5.writeFileSync(outPath, JSON.stringify(run, null, 2), "utf8");
     }
     try {
       const result = await generateReports(run, args);
@@ -17928,9 +18134,9 @@ ${msg}`);
     process.exit(EXIT_CANONICAL_VALIDATION);
   }
   if (args.emitCanonical) {
-    const outPath = path3.resolve(args.emitCanonical);
-    fs3.mkdirSync(path3.dirname(outPath), { recursive: true });
-    fs3.writeFileSync(outPath, JSON.stringify(canonical, null, 2), "utf8");
+    const outPath = path5.resolve(args.emitCanonical);
+    fs5.mkdirSync(path5.dirname(outPath), { recursive: true });
+    fs5.writeFileSync(outPath, JSON.stringify(canonical, null, 2), "utf8");
   }
   try {
     const result = await generateReports(canonical, args, droppedMissingStory);
@@ -17987,13 +18193,13 @@ async function dispatchNotifications(run, args) {
 }
 function runHistoryPipeline(run, args) {
   if (!args.historyFile) return;
-  const historyPath = path3.resolve(args.historyFile);
+  const historyPath = path5.resolve(args.historyFile);
   const store = loadHistory(
     { filePath: historyPath },
     {
       readFile: (p) => {
         try {
-          return fs3.readFileSync(p, "utf8");
+          return fs5.readFileSync(p, "utf8");
         } catch {
           return void 0;
         }
@@ -18006,11 +18212,11 @@ function runHistoryPipeline(run, args) {
     run,
     maxRuns: args.maxHistoryRuns
   });
-  const dir = path3.dirname(historyPath);
-  fs3.mkdirSync(dir, { recursive: true });
+  const dir = path5.dirname(historyPath);
+  fs5.mkdirSync(dir, { recursive: true });
   saveHistory(
     { filePath: historyPath, store: updated },
-    { writeFile: (p, content) => fs3.writeFileSync(p, content, "utf8") }
+    { writeFile: (p, content) => fs5.writeFileSync(p, content, "utf8") }
   );
   let metricsCount = 0;
   for (const testId of Object.keys(updated.tests)) {
@@ -18040,8 +18246,11 @@ async function generateReports(run, args, _droppedMissingStory = 0) {
       syntaxHighlighting: !args.htmlNoSyntaxHighlighting,
       mermaidEnabled: !args.htmlNoMermaid,
       markdownEnabled: !args.htmlNoMarkdown,
-      permalinkBaseUrl: args.htmlPermalinkBaseUrl
-    }
+      permalinkBaseUrl: args.htmlPermalinkBaseUrl,
+      ticketUrlTemplate: args.htmlTicketUrlTemplate
+    },
+    assetMode: args.assetMode,
+    allowMissingAssets: args.allowMissingAssets
   });
   const resultMap = await generator.generate(run);
   const files = [];
@@ -18103,9 +18312,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 = path3.resolve(args.prSummaryFile);
-    fs3.mkdirSync(path3.dirname(outputPath), { recursive: true });
-    fs3.writeFileSync(outputPath, result.prSummary, "utf8");
+    const outputPath = path5.resolve(args.prSummaryFile);
+    fs5.mkdirSync(path5.dirname(outputPath), { recursive: true });
+    fs5.writeFileSync(outputPath, result.prSummary, "utf8");
   }
   if (args.jsonSummary) {
     console.log(