@mhosaic/feedback-cli 0.20.0 → 0.22.0

package/dist/bin.js

@@ -20,9 +20,13 @@ async function main() {
     return runVerify(args);
   }
   if (cmd === "install-skill") {
-    const { runInstallSkill } = await import("./install-skill-QJ4ZDVVR.js");
+    const { runInstallSkill } = await import("./install-skill-PO5YSXWY.js");
     return runInstallSkill(args);
   }
+  if (cmd === "qa") {
+    const { runQa } = await import("./qa-YR4GCV6T.js");
+    return runQa(args);
+  }
   if (cmd === "--version" || cmd === "-v") {
     process.stdout.write("0.14.1\n");
     return;
@@ -35,6 +39,7 @@ Usage:
   mhosaic-feedback verify         Ping the backend with the configured key
   mhosaic-feedback eject          Strip widget integration from this project
   mhosaic-feedback install-skill  Copy the Claude Code skill to ~/.claude/skills
+  mhosaic-feedback qa             Run QA-meter commands (sitemap|generate|build|check|refresh)
 `);
   process.exitCode = 1;
 }

package/dist/bin.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/bin.ts"],"sourcesContent":["async function main() {\n  const [, , cmd, ...args] = process.argv\n  if (!cmd || cmd === 'init') {\n    const { runInit } = await import('./commands/init')\n    return runInit(args)\n  }\n  if (cmd === 'doctor') {\n    const { runDoctor } = await import('./commands/doctor')\n    return runDoctor(args)\n  }\n  if (cmd === 'eject') {\n    const { runEject } = await import('./commands/eject')\n    return runEject(args)\n  }\n  if (cmd === 'verify') {\n    const { runVerify } = await import('./commands/verify')\n    return runVerify(args)\n  }\n  if (cmd === 'install-skill') {\n    const { runInstallSkill } = await import('./commands/install-skill')\n    return runInstallSkill(args)\n  }\n  if (cmd === '--version' || cmd === '-v') {\n    process.stdout.write('0.14.1\\n')\n    return\n  }\n  process.stderr.write(`Unknown command: ${cmd}\\n\\nUsage:\\n  mhosaic-feedback init           Set up the widget in this project\\n  mhosaic-feedback doctor         Check local setup\\n  mhosaic-feedback verify         Ping the backend with the configured key\\n  mhosaic-feedback eject          Strip widget integration from this project\\n  mhosaic-feedback install-skill  Copy the Claude Code skill to ~/.claude/skills\\n`)\n  process.exitCode = 1\n}\n\nmain().catch((err) => {\n  process.stderr.write(`${err instanceof Error ? err.message : String(err)}\\n`)\n  process.exitCode = 1\n})\n"],"mappings":";;;AAAA,eAAe,OAAO;AACpB,QAAM,CAAC,EAAE,EAAE,KAAK,GAAG,IAAI,IAAI,QAAQ;AACnC,MAAI,CAAC,OAAO,QAAQ,QAAQ;AAC1B,UAAM,EAAE,QAAQ,IAAI,MAAM,OAAO,oBAAiB;AAClD,WAAO,QAAQ,IAAI;AAAA,EACrB;AACA,MAAI,QAAQ,UAAU;AACpB,UAAM,EAAE,UAAU,IAAI,MAAM,OAAO,sBAAmB;AACtD,WAAO,UAAU,IAAI;AAAA,EACvB;AACA,MAAI,QAAQ,SAAS;AACnB,UAAM,EAAE,SAAS,IAAI,MAAM,OAAO,qBAAkB;AACpD,WAAO,SAAS,IAAI;AAAA,EACtB;AACA,MAAI,QAAQ,UAAU;AACpB,UAAM,EAAE,UAAU,IAAI,MAAM,OAAO,sBAAmB;AACtD,WAAO,UAAU,IAAI;AAAA,EACvB;AACA,MAAI,QAAQ,iBAAiB;AAC3B,UAAM,EAAE,gBAAgB,IAAI,MAAM,OAAO,6BAA0B;AACnE,WAAO,gBAAgB,IAAI;AAAA,EAC7B;AACA,MAAI,QAAQ,eAAe,QAAQ,MAAM;AACvC,YAAQ,OAAO,MAAM,UAAU;AAC/B;AAAA,EACF;AACA,UAAQ,OAAO,MAAM,oBAAoB,GAAG;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,CAAoX;AACha,UAAQ,WAAW;AACrB;AAEA,KAAK,EAAE,MAAM,CAAC,QAAQ;AACpB,UAAQ,OAAO,MAAM,GAAG,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG,CAAC;AAAA,CAAI;AAC5E,UAAQ,WAAW;AACrB,CAAC;","names":[]}
+{"version":3,"sources":["../src/bin.ts"],"sourcesContent":["async function main() {\n  const [, , cmd, ...args] = process.argv\n  if (!cmd || cmd === 'init') {\n    const { runInit } = await import('./commands/init')\n    return runInit(args)\n  }\n  if (cmd === 'doctor') {\n    const { runDoctor } = await import('./commands/doctor')\n    return runDoctor(args)\n  }\n  if (cmd === 'eject') {\n    const { runEject } = await import('./commands/eject')\n    return runEject(args)\n  }\n  if (cmd === 'verify') {\n    const { runVerify } = await import('./commands/verify')\n    return runVerify(args)\n  }\n  if (cmd === 'install-skill') {\n    const { runInstallSkill } = await import('./commands/install-skill')\n    return runInstallSkill(args)\n  }\n  if (cmd === 'qa') {\n    const { runQa } = await import('./qa')\n    return runQa(args)\n  }\n  if (cmd === '--version' || cmd === '-v') {\n    process.stdout.write('0.14.1\\n')\n    return\n  }\n  process.stderr.write(`Unknown command: ${cmd}\\n\\nUsage:\\n  mhosaic-feedback init           Set up the widget in this project\\n  mhosaic-feedback doctor         Check local setup\\n  mhosaic-feedback verify         Ping the backend with the configured key\\n  mhosaic-feedback eject          Strip widget integration from this project\\n  mhosaic-feedback install-skill  Copy the Claude Code skill to ~/.claude/skills\\n  mhosaic-feedback qa             Run QA-meter commands (sitemap|generate|build|check|refresh)\\n`)\n  process.exitCode = 1\n}\n\nmain().catch((err) => {\n  process.stderr.write(`${err instanceof Error ? err.message : String(err)}\\n`)\n  process.exitCode = 1\n})\n"],"mappings":";;;AAAA,eAAe,OAAO;AACpB,QAAM,CAAC,EAAE,EAAE,KAAK,GAAG,IAAI,IAAI,QAAQ;AACnC,MAAI,CAAC,OAAO,QAAQ,QAAQ;AAC1B,UAAM,EAAE,QAAQ,IAAI,MAAM,OAAO,oBAAiB;AAClD,WAAO,QAAQ,IAAI;AAAA,EACrB;AACA,MAAI,QAAQ,UAAU;AACpB,UAAM,EAAE,UAAU,IAAI,MAAM,OAAO,sBAAmB;AACtD,WAAO,UAAU,IAAI;AAAA,EACvB;AACA,MAAI,QAAQ,SAAS;AACnB,UAAM,EAAE,SAAS,IAAI,MAAM,OAAO,qBAAkB;AACpD,WAAO,SAAS,IAAI;AAAA,EACtB;AACA,MAAI,QAAQ,UAAU;AACpB,UAAM,EAAE,UAAU,IAAI,MAAM,OAAO,sBAAmB;AACtD,WAAO,UAAU,IAAI;AAAA,EACvB;AACA,MAAI,QAAQ,iBAAiB;AAC3B,UAAM,EAAE,gBAAgB,IAAI,MAAM,OAAO,6BAA0B;AACnE,WAAO,gBAAgB,IAAI;AAAA,EAC7B;AACA,MAAI,QAAQ,MAAM;AAChB,UAAM,EAAE,MAAM,IAAI,MAAM,OAAO,kBAAM;AACrC,WAAO,MAAM,IAAI;AAAA,EACnB;AACA,MAAI,QAAQ,eAAe,QAAQ,MAAM;AACvC,YAAQ,OAAO,MAAM,UAAU;AAC/B;AAAA,EACF;AACA,UAAQ,OAAO,MAAM,oBAAoB,GAAG;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,CAAod;AAChgB,UAAQ,WAAW;AACrB;AAEA,KAAK,EAAE,MAAM,CAAC,QAAQ;AACpB,UAAQ,OAAO,MAAM,GAAG,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG,CAAC;AAAA,CAAI;AAC5E,UAAQ,WAAW;AACrB,CAAC;","names":[]}

package/dist/build-RCLWV2WL.js

@@ -0,0 +1,565 @@
+#!/usr/bin/env node
+import {
+  loadQaConfig
+} from "./chunk-IHJPCMYF.js";
+
+// src/qa/build.ts
+import { existsSync as existsSync2, mkdirSync, readFileSync as readFileSync3, writeFileSync } from "fs";
+import { dirname } from "path";
+
+// src/qa/color.ts
+function deriveScenarioColor(automated, dev, client) {
+  const rejected = dev.rejected === true || client.rejected === true;
+  if (automated.status === "failing" || rejected) {
+    return "red";
+  }
+  const everRun = automated.status !== "never_run";
+  const anyHuman = dev.validated || client.validated;
+  if (!everRun && !anyHuman) {
+    return "gray";
+  }
+  const fresh = dev.stale !== true && client.stale !== true;
+  if (automated.status === "passing" && dev.validated && client.validated && fresh) {
+    return "green";
+  }
+  return "yellow";
+}
+function aggregateColor(colors) {
+  if (colors.length === 0) {
+    return "gray";
+  }
+  if (colors.includes("red")) {
+    return "red";
+  }
+  if (colors.every((c) => c === "green")) {
+    return "green";
+  }
+  if (colors.every((c) => c === "gray")) {
+    return "gray";
+  }
+  return "yellow";
+}
+function isValidationStale(opts) {
+  if (!opts.validatedAt) {
+    return false;
+  }
+  return opts.automatedStatus === "failing" && !!opts.automatedAt && opts.automatedAt > opts.validatedAt;
+}
+
+// src/qa/results.ts
+import { readFileSync } from "fs";
+function provenanceFor(retried) {
+  const parts = [];
+  const runner = process.env.QA_RUNNER;
+  const database = process.env.QA_DATABASE;
+  const authMode = process.env.QA_AUTH_MODE;
+  if (runner) parts.push(runner);
+  if (database) parts.push(database);
+  if (authMode) parts.push(authMode);
+  if (retried) parts.push("retried");
+  return parts.length > 0 ? parts.join(" \xB7 ") : void 0;
+}
+function laneFor(test) {
+  const results = test.results ?? [];
+  if (results.length === 0) {
+    return { status: "never_run" };
+  }
+  const last = results[results.length - 1];
+  const at = last.startTime;
+  const retried = (last.retry ?? 0) > 0 || results.length > 1;
+  let status;
+  if (last.status === "passed") {
+    status = retried ? "flaky" : "passing";
+  } else {
+    status = "failing";
+  }
+  const provenance = provenanceFor(retried);
+  return { status, ...at ? { at } : {}, ...provenance ? { provenance } : {} };
+}
+function readResults(file) {
+  const lanes = /* @__PURE__ */ new Map();
+  let report;
+  try {
+    report = JSON.parse(readFileSync(file, "utf8"));
+  } catch (err) {
+    throw new Error(`qa build: failed to read Playwright report ${file}: ${err instanceof Error ? err.message : String(err)}`);
+  }
+  const walk = (suite) => {
+    for (const spec of suite.specs ?? []) {
+      const specFile = spec.file ?? suite.file;
+      if (!specFile || !spec.title) continue;
+      for (const test of spec.tests ?? []) {
+        lanes.set(`${specFile}::${spec.title}`, laneFor(test));
+      }
+    }
+    for (const child of suite.suites ?? []) walk(child);
+  };
+  for (const suite of report.suites ?? []) walk(suite);
+  return lanes;
+}
+
+// src/qa/load-suites.ts
+import { existsSync, readFileSync as readFileSync2, readdirSync, statSync } from "fs";
+import { join } from "path";
+import { parse } from "yaml";
+function discoverModuleSuites(suitesDir) {
+  const modulesDir = join(suitesDir, "modules");
+  if (!existsSync(modulesDir)) return [];
+  const out = [];
+  for (const name of readdirSync(modulesDir).sort()) {
+    const sub = join(modulesDir, name);
+    if (!statSync(sub).isDirectory()) continue;
+    const file = readdirSync(sub).find((f) => f.endsWith("-test-suite.yaml"));
+    if (file) out.push(join(sub, file));
+  }
+  return out;
+}
+function discoverGeneratedSuites(suitesDir) {
+  const genDir = join(suitesDir, "generated");
+  if (!existsSync(genDir)) return [];
+  return readdirSync(genDir).filter((f) => f.endsWith(".yaml") || f.endsWith(".yml")).sort().map((f) => join(genDir, f));
+}
+function discoverCrossSuites(suitesDir) {
+  if (!existsSync(suitesDir)) return [];
+  return readdirSync(suitesDir).filter((f) => f.endsWith("-test-suite.yaml")).sort().map((f) => join(suitesDir, f));
+}
+function parseSuiteLabels(rawText) {
+  const labels = {};
+  const re = /^\s*#\s*-+\s*Suite\s+(\S+)\s*[—–-]\s*(.+?)\s*-*\s*$/gm;
+  let m;
+  while ((m = re.exec(rawText)) !== null) {
+    labels[m[1]] = m[2].replace(/\s*\([^)]*\)\s*$/, "").trim();
+  }
+  return labels;
+}
+function expandRoutes(value, pageSets) {
+  if (!value) return [];
+  if (typeof value === "string") return pageSets[value] ?? [value];
+  return value.flatMap((entry) => pageSets[entry] ? pageSets[entry] : [entry]);
+}
+function caseStatusOf(testCase) {
+  const s = testCase.status;
+  if (s === "covered" || s === "manual" || s === "blocked" || s === "open-question") return s;
+  return "manual";
+}
+function loadScenarioSeeds(suitesDir) {
+  const modules = {};
+  const byPattern = /* @__PURE__ */ new Map();
+  const coveredPatterns = /* @__PURE__ */ new Set();
+  const push = (pattern, seed) => {
+    if (!pattern) return;
+    const list = byPattern.get(pattern);
+    if (list) list.push(seed);
+    else byPattern.set(pattern, [seed]);
+  };
+  const moduleFiles = [
+    ...discoverModuleSuites(suitesDir).map((path) => ({ path, origin: "authored" })),
+    ...discoverGeneratedSuites(suitesDir).map((path) => ({ path, origin: "generated" }))
+  ];
+  for (const { path, origin } of moduleFiles) {
+    const raw = readFileSync2(path, "utf8");
+    const doc = parse(raw);
+    if (!doc || !doc.meta) continue;
+    const section = doc.meta.section ?? path;
+    const existing = modules[section];
+    if (existing) {
+      existing.cases.push(...doc.test_cases ?? []);
+      if (origin === "authored") existing.origin = "authored";
+    } else {
+      modules[section] = {
+        section,
+        pages: doc.pages ?? {},
+        pageSets: doc.page_sets ?? {},
+        labels: parseSuiteLabels(raw),
+        cases: [...doc.test_cases ?? []],
+        origin
+      };
+    }
+    if (existing) {
+      for (const [key, page] of Object.entries(doc.pages ?? {})) {
+        if (!(key in existing.pages)) existing.pages[key] = page;
+      }
+      for (const [key, set] of Object.entries(doc.page_sets ?? {})) {
+        if (!(key in existing.pageSets)) existing.pageSets[key] = set;
+      }
+    }
+  }
+  for (const { path, origin } of moduleFiles) {
+    const raw = readFileSync2(path, "utf8");
+    const doc = parse(raw);
+    if (!doc || !doc.meta) continue;
+    const section = doc.meta.section ?? path;
+    const mod = modules[section];
+    const labels = mod.labels;
+    const localPages = { ...mod.pages, ...doc.pages ?? {} };
+    const localPageSets = { ...mod.pageSets, ...doc.page_sets ?? {} };
+    for (const testCase of doc.test_cases ?? []) {
+      const routes = expandRoutes(testCase.applies_to, localPageSets);
+      const traversed = (testCase.traverses ?? []).map((t) => t.pattern).filter(Boolean);
+      const groupKey = testCase.suite ?? "?";
+      const label = labels[groupKey] ?? `Suite ${groupKey}`;
+      const status = caseStatusOf(testCase);
+      const specFallback = routes.length > 0 ? localPages[routes[0]]?.spec : void 0;
+      const specPath = testCase.automation?.spec ?? specFallback;
+      const testTitle = testCase.automation?.test_title ?? localPages[routes[0]]?.test_title;
+      const dedupKey = specPath && testTitle ? `${specPath}::${testTitle}` : void 0;
+      const displayTitle = origin === "authored" && testCase.automation?.type === "playwright" && testCase.automation?.test_title ? testCase.automation.test_title : testCase.title;
+      for (const route of routes) {
+        const page = localPages[route];
+        const pattern = page?.pattern;
+        if (!pattern) continue;
+        if (status === "covered") coveredPatterns.add(pattern);
+        push(pattern, {
+          id: `s-${section}-${testCase.id}-${route}`,
+          external_key: testCase.external_key ?? `${section}#${testCase.id}`,
+          title: displayTitle,
+          source: testCase.automation?.type === "playwright" ? "reporter" : "manual",
+          ...specPath ? { spec_path: specPath } : {},
+          ...testTitle ? { test_title: testTitle } : {},
+          group: { key: groupKey, label },
+          ...testCase.priority ? { priority: testCase.priority } : {},
+          caseStatus: status,
+          ...testCase.grounding ? { grounding: testCase.grounding } : {},
+          pages: [
+            { pattern, role: "primary" },
+            ...traversed.map((p) => ({ pattern: p, role: "traversed" }))
+          ],
+          pattern,
+          origin,
+          ...dedupKey ? { dedupKey } : {}
+        });
+      }
+    }
+  }
+  for (const crossPath of discoverCrossSuites(suitesDir)) {
+    const raw = readFileSync2(crossPath, "utf8");
+    const doc = parse(raw);
+    if (!doc || doc.meta?.kind !== "cross-module") continue;
+    const pair = doc.meta?.pair ?? [];
+    const crossLabel = pair.length ? `Inter-modules (${pair.join(" \xD7 ")})` : "Inter-modules";
+    for (const testCase of doc.test_cases ?? []) {
+      const refs = [];
+      for (const touch of testCase.touches ?? []) {
+        const mod = modules[touch.module];
+        if (!mod) continue;
+        const routes = touch.route ? [touch.route] : expandRoutes(touch.page_set, mod.pageSets);
+        for (const route of routes) {
+          const pattern = mod.pages[route]?.pattern;
+          if (pattern) refs.push({ pattern, role: touch.role === "origin" ? "primary" : "traversed" });
+        }
+      }
+      const patterns = [...new Set(refs.map((r) => r.pattern))];
+      const status = caseStatusOf(testCase);
+      for (const pattern of patterns) {
+        push(pattern, {
+          id: `s-cross-${testCase.id}-${pattern}`,
+          external_key: `cross#${testCase.id}`,
+          title: testCase.title,
+          source: "manual",
+          group: { key: "X", label: crossLabel },
+          ...testCase.priority ? { priority: testCase.priority } : {},
+          caseStatus: status,
+          ...testCase.grounding ? { grounding: testCase.grounding } : {},
+          pages: [{ pattern, role: "primary" }, ...refs.filter((r) => r.pattern !== pattern)],
+          pattern,
+          origin: "authored"
+        });
+      }
+    }
+  }
+  return { byPattern, coveredPatterns };
+}
+
+// src/qa/build.ts
+var EMPTY_HUMAN = { validated: false, stale: false };
+var FALLBACK_VERSION = "0.0.0";
+function idFor(pattern) {
+  return "p" + pattern.replace(/[^a-zA-Z0-9]+/g, "-").replace(/-+$/, "");
+}
+function humanize(str) {
+  if (!str) return "";
+  const cleaned = str.replace(/[:?()*]/g, "").replace(/[-_/]+/g, " ").trim();
+  return cleaned ? cleaned.charAt(0).toUpperCase() + cleaned.slice(1) : "";
+}
+function lastSegment(pattern) {
+  const parts = pattern.split("/").filter(Boolean);
+  return parts[parts.length - 1] ?? "";
+}
+function titleForPage(page) {
+  return page.title || humanize(page.route_name ?? "") || humanize(lastSegment(page.path_pattern)) || page.path_pattern;
+}
+function emptyCounts() {
+  return { scenarios: 0, passing: 0, dev_validated: 0, client_validated: 0 };
+}
+function countsFor(scenarios) {
+  return {
+    scenarios: scenarios.length,
+    passing: scenarios.filter((s) => s.automated.status === "passing").length,
+    dev_validated: scenarios.filter((s) => s.dev.validated).length,
+    client_validated: scenarios.filter((s) => s.client.validated).length
+  };
+}
+function loadDevValidations(file) {
+  const out = /* @__PURE__ */ new Map();
+  if (!file || !existsSync2(file)) return out;
+  let parsed;
+  try {
+    parsed = JSON.parse(readFileSync3(file, "utf8"));
+  } catch (err) {
+    throw new Error(`qa build: failed to read dev validations ${file}: ${err instanceof Error ? err.message : String(err)}`);
+  }
+  const events = Array.isArray(parsed) ? parsed : Array.isArray(parsed.events) ? parsed.events : [];
+  for (const ev of events) {
+    if (!ev.external_key) continue;
+    const prev = out.get(ev.external_key);
+    if (!prev || (ev.at ?? "") >= (prev.at ?? "")) out.set(ev.external_key, ev);
+  }
+  return out;
+}
+function assembleScenario(seed, results, devEvents) {
+  let automated = { status: "never_run" };
+  if (seed.caseStatus === "covered" && seed.spec_path && seed.test_title) {
+    const lane = results.get(`${seed.spec_path}::${seed.test_title}`);
+    if (lane) {
+      automated = {
+        status: lane.status,
+        ...lane.at ? { at: lane.at } : {},
+        ...lane.provenance ? { provenance: lane.provenance } : {}
+      };
+    }
+  }
+  let dev = { ...EMPTY_HUMAN };
+  const ev = devEvents.get(seed.external_key);
+  if (ev) {
+    const stale = ev.validated ? isValidationStale({
+      ...ev.at ? { validatedAt: ev.at } : {},
+      automatedStatus: automated.status,
+      ...automated.at ? { automatedAt: automated.at } : {}
+    }) : false;
+    dev = {
+      validated: ev.validated === true,
+      stale,
+      ...ev.rejected ? { rejected: true } : {},
+      ...ev.by ? { by: ev.by } : {},
+      ...ev.at ? { at: ev.at } : {},
+      ...ev.app_version ? { app_version: ev.app_version } : {},
+      ...ev.note ? { note: ev.note } : {}
+    };
+  }
+  const client = { ...EMPTY_HUMAN };
+  const color = deriveScenarioColor(automated, dev, client);
+  return {
+    id: seed.id,
+    external_key: seed.external_key,
+    title: seed.title,
+    color,
+    source: seed.source,
+    ...seed.spec_path ? { spec_path: seed.spec_path } : {},
+    pages: seed.pages,
+    group: seed.group,
+    ...seed.priority ? { priority: seed.priority } : {},
+    ...seed.caseStatus ? { caseStatus: seed.caseStatus } : {},
+    ...seed.grounding ? { grounding: seed.grounding } : {},
+    automated,
+    dev,
+    client
+  };
+}
+function dedupSeeds(byPattern) {
+  const authoredKeys = /* @__PURE__ */ new Set();
+  for (const seeds of byPattern.values()) {
+    for (const seed of seeds) {
+      if (seed.origin === "authored" && seed.dedupKey) authoredKeys.add(seed.dedupKey);
+    }
+  }
+  const out = /* @__PURE__ */ new Map();
+  for (const [pattern, seeds] of byPattern) {
+    const kept = seeds.filter(
+      (seed) => !(seed.origin === "generated" && seed.dedupKey && authoredKeys.has(seed.dedupKey))
+    );
+    out.set(pattern, kept);
+  }
+  return out;
+}
+function primaryColors(scenarios, pattern) {
+  return scenarios.filter((s) => (s.pages ?? []).some((ref) => ref.pattern === pattern && ref.role === "primary")).map((s) => s.color);
+}
+function loadSitemap(file) {
+  let parsed;
+  try {
+    parsed = JSON.parse(readFileSync3(file, "utf8"));
+  } catch (err) {
+    throw new Error(`qa build: failed to read sitemap ${file}: ${err instanceof Error ? err.message : String(err)}`);
+  }
+  if (typeof parsed !== "object" || parsed === null || !Array.isArray(parsed.pages)) {
+    throw new Error(`qa build: sitemap ${file} is malformed (expected { format, pages: [] })`);
+  }
+  return parsed;
+}
+function buildArtifact(cfg, opts = {}) {
+  const appVersion = opts.appVersion ?? cfg.appVersion ?? FALLBACK_VERSION;
+  const generatedAt = opts.generatedAt ?? FALLBACK_VERSION;
+  const { byPattern: rawByPattern } = loadScenarioSeeds(cfg.suitesDir);
+  const byPattern = dedupSeeds(rawByPattern);
+  const results = cfg.resultsFile && existsSync2(cfg.resultsFile) ? readResults(cfg.resultsFile) : /* @__PURE__ */ new Map();
+  const devEvents = loadDevValidations(cfg.devValidationsFile);
+  const scenariosByPattern = /* @__PURE__ */ new Map();
+  for (const [pattern, seeds] of byPattern) {
+    scenariosByPattern.set(
+      pattern,
+      seeds.map((seed) => assembleScenario(seed, results, devEvents))
+    );
+  }
+  if (!cfg.sitemap) {
+    return buildDegraded(scenariosByPattern, cfg, appVersion, generatedAt);
+  }
+  return buildWithSitemap(loadSitemap(cfg.sitemap.file), scenariosByPattern, cfg, appVersion, generatedAt);
+}
+function pageStatusFor(pattern, title, scenarios) {
+  return {
+    page: { id: idFor(pattern), path_pattern: pattern, title },
+    color: aggregateColor(primaryColors(scenarios, pattern)),
+    counts: countsFor(scenarios),
+    scenarios
+  };
+}
+function pct(num, den) {
+  return den === 0 ? 0 : Math.round(100 * num / den);
+}
+function metricFor(pageStatuses, navigableTotal) {
+  const pagesWithScenarios = pageStatuses.filter((s) => s.counts.scenarios > 0).length;
+  const scenariosTotal = pageStatuses.reduce((n, s) => n + s.counts.scenarios, 0);
+  const scenariosPassing = pageStatuses.reduce((n, s) => n + s.counts.passing, 0);
+  return {
+    pages_with_scenarios_pct: pct(pagesWithScenarios, navigableTotal),
+    scenarios_passing_pct: pct(scenariosPassing, scenariosTotal)
+  };
+}
+function buildWithSitemap(sitemap, scenariosByPattern, cfg, appVersion, generatedAt) {
+  const allPages = sitemap.pages;
+  const navigable = allPages.filter((p) => !p.structural);
+  const titleByPattern = new Map(allPages.map((p) => [p.path_pattern, titleForPage(p)]));
+  const pageStatusByPattern = /* @__PURE__ */ new Map();
+  for (const page of navigable) {
+    const scenarios = scenariosByPattern.get(page.path_pattern) ?? [];
+    pageStatusByPattern.set(
+      page.path_pattern,
+      pageStatusFor(page.path_pattern, titleByPattern.get(page.path_pattern), scenarios)
+    );
+  }
+  const orphanPages = [];
+  for (const [pattern, scenarios] of scenariosByPattern) {
+    if (!pageStatusByPattern.has(pattern)) {
+      orphanPages.push(pageStatusFor(pattern, humanize(lastSegment(pattern)) || pattern, scenarios));
+    }
+  }
+  const pages = [...pageStatusByPattern.values(), ...orphanPages];
+  const childrenByParent = /* @__PURE__ */ new Map();
+  for (const p of allPages) {
+    const list = childrenByParent.get(p.parent);
+    if (list) list.push(p);
+    else childrenByParent.set(p.parent, [p]);
+  }
+  const subtree = (pattern) => {
+    const out = [pattern];
+    for (const child of childrenByParent.get(pattern) ?? []) out.push(...subtree(child.path_pattern));
+    return out;
+  };
+  const rollupOver = (statuses) => ({
+    pages_total: statuses.length,
+    pages_green: statuses.filter((s) => s.color === "green").length,
+    scenarios_total: statuses.reduce((n, s) => n + s.counts.scenarios, 0),
+    scenarios_green: statuses.reduce((n, s) => n + s.scenarios.filter((x) => x.color === "green").length, 0)
+  });
+  const nodes = allPages.map((page) => {
+    const status = pageStatusByPattern.get(page.path_pattern);
+    const ownCounts = status ? status.counts : emptyCounts();
+    const descStatuses = subtree(page.path_pattern).map((pat) => pageStatusByPattern.get(pat)).filter((s) => Boolean(s));
+    return {
+      id: idFor(page.path_pattern),
+      path_pattern: page.path_pattern,
+      title: titleByPattern.get(page.path_pattern),
+      // Map the input `parent` (a path_pattern) → that node's id; null stays a root.
+      parent_id: page.parent ? idFor(page.parent) : null,
+      order: page.order,
+      ...page.structural ? { structural: true } : {},
+      color: aggregateColor(descStatuses.map((s) => s.color)),
+      counts: ownCounts,
+      rollup: rollupOver(descStatuses)
+    };
+  });
+  const metric = metricFor(pages, navigable.length + orphanPages.length);
+  return {
+    format: 1,
+    environment: cfg.environment,
+    app_version: appVersion,
+    generated_at: generatedAt,
+    pages,
+    sitemap: nodes,
+    metric
+  };
+}
+function buildDegraded(scenariosByPattern, cfg, appVersion, generatedAt) {
+  const patterns = [...scenariosByPattern.keys()].sort((a, b) => a.localeCompare(b));
+  const pages = patterns.map(
+    (pattern) => pageStatusFor(pattern, humanize(lastSegment(pattern)) || pattern, scenariosByPattern.get(pattern))
+  );
+  const sitemap = pages.map((ps, i) => ({
+    id: ps.page.id,
+    path_pattern: ps.page.path_pattern,
+    title: ps.page.title,
+    parent_id: null,
+    order: i,
+    color: ps.color,
+    counts: ps.counts,
+    rollup: {
+      pages_total: 1,
+      pages_green: ps.color === "green" ? 1 : 0,
+      scenarios_total: ps.counts.scenarios,
+      scenarios_green: ps.scenarios.filter((x) => x.color === "green").length
+    }
+  }));
+  return {
+    format: 1,
+    environment: cfg.environment,
+    app_version: appVersion,
+    generated_at: generatedAt,
+    pages,
+    sitemap,
+    metric: metricFor(pages, pages.length)
+  };
+}
+function parseVersion(args) {
+  const i = args.indexOf("--version");
+  if (i >= 0 && args[i + 1]) return args[i + 1];
+  return void 0;
+}
+async function runBuild(args) {
+  const cfg = loadQaConfig(process.cwd());
+  const appVersion = parseVersion(args);
+  let artifact;
+  try {
+    artifact = buildArtifact(cfg, {
+      ...appVersion ? { appVersion } : {},
+      generatedAt: (/* @__PURE__ */ new Date()).toISOString()
+    });
+  } catch (err) {
+    process.stderr.write(`${err instanceof Error ? err.message : String(err)}
+`);
+    process.exitCode = 1;
+    return;
+  }
+  mkdirSync(dirname(cfg.outFile), { recursive: true });
+  writeFileSync(cfg.outFile, `${JSON.stringify(artifact, null, 2)}
+`, "utf8");
+  process.stderr.write(
+    `qa build \u2192 ${cfg.outFile}
+  ${artifact.metric.pages_with_scenarios_pct}% pages with scenarios \xB7 ${artifact.metric.scenarios_passing_pct}% scenarios passing
+`
+  );
+}
+export {
+  buildArtifact,
+  runBuild
+};
+//# sourceMappingURL=build-RCLWV2WL.js.map