@xera-ai/core 0.4.2 → 0.4.3

package/dist/bin/internal.js

@@ -9457,6 +9457,306 @@ async function graphQueryCmd(argv) {
 // src/bin-internal/index.ts
 init_graph_record();
 
+// src/bin-internal/graph-render.ts
+import { mkdirSync as mkdirSync11, renameSync as renameSync2, writeFileSync as writeFileSync10 } from "fs";
+import { dirname as dirname7, join as join17 } from "path";
+
+// src/graph/render.ts
+import { readFileSync as readFileSync17 } from "fs";
+import { dirname as dirname6, join as join16 } from "path";
+import { fileURLToPath } from "url";
+var COLORS = {
+  ticket: "#3B82F6",
+  scenarioPass: "#10B981",
+  scenarioFail: "#EF4444",
+  pom: "#F59E0B",
+  area: "#6B7280",
+  failure: "#EF4444",
+  edgeModifies: "#EF4444",
+  edgeDefault: "#9CA3AF",
+  edgeJira: "#3B82F6",
+  edgeSimilar: "#A855F7"
+};
+function ticketsAfter(since, fetchedAt) {
+  if (!since)
+    return true;
+  return Date.parse(fetchedAt) >= Date.parse(since);
+}
+function scenariosAfter(since, generatedAt) {
+  if (!since)
+    return true;
+  return Date.parse(generatedAt) >= Date.parse(since);
+}
+function buildTicketNode(snap, ticketId) {
+  const t = snap.tickets[ticketId];
+  const usageCount = snap.edges.filter((e) => e.kind === "tests" && e.from === ticketId).length;
+  const node = {
+    id: t.id,
+    label: t.id,
+    group: "Ticket",
+    color: COLORS.ticket,
+    shape: "dot",
+    size: 10 + Math.min(usageCount * 2, 20),
+    title: `${t.id} \u2014 ${t.summary}`
+  };
+  return node;
+}
+function buildScenarioNode(snap, scenarioId2) {
+  const s = snap.scenarios[scenarioId2];
+  const failed = snap.latest_failures[scenarioId2];
+  const sizeBase = s.priority === "p0" ? 14 : s.priority === "p1" ? 11 : 9;
+  const node = {
+    id: s.id,
+    label: s.name,
+    group: "Scenario",
+    color: failed ? COLORS.scenarioFail : COLORS.scenarioPass,
+    shape: "square",
+    size: sizeBase,
+    title: `${s.ticketId} / ${s.name} [${s.priority.toUpperCase()}]`
+  };
+  return node;
+}
+function buildPomNode(snap, pomId2) {
+  const p = snap.poms[pomId2];
+  const usageCount = snap.edges.filter((e) => e.kind === "uses" && e.to === pomId2).length;
+  const node = {
+    id: p.id,
+    label: p.filePath.split("/").pop() ?? p.id,
+    group: "POM",
+    color: COLORS.pom,
+    shape: "diamond",
+    size: 8 + Math.min(usageCount * 2, 16),
+    title: `${p.filePath} (${p.route || "no route"})`
+  };
+  return node;
+}
+function buildAreaNode(snap, areaId) {
+  const a = snap.areas[areaId];
+  const node = {
+    id: a.id,
+    label: a.id,
+    group: "SUTArea",
+    color: COLORS.area,
+    shape: "hexagon",
+    size: 12,
+    title: `area: ${a.id}`
+  };
+  return node;
+}
+function buildFailureNode(_snap, failure) {
+  const node = {
+    id: failure.id,
+    label: "fail",
+    group: "Failure",
+    color: COLORS.failure,
+    shape: "triangle",
+    size: 10,
+    title: `failure on ${failure.scenarioId} @ ${failure.ts}`
+  };
+  return node;
+}
+function buildEdge(edge, idx) {
+  const v = {
+    id: `e-${idx}`,
+    from: edge.from,
+    to: edge.to,
+    label: edge.kind,
+    arrows: "to",
+    width: 1
+  };
+  switch (edge.kind) {
+    case "modifies":
+      v.color = COLORS.edgeModifies;
+      v.dashes = true;
+      v.width = 2;
+      break;
+    case "jira-linked":
+      v.color = COLORS.edgeJira;
+      v.dashes = true;
+      break;
+    case "similar":
+      v.color = COLORS.edgeSimilar;
+      v.dashes = false;
+      v.width = 1 + Math.round((edge.confidence ?? 0) * 3);
+      break;
+    default:
+      v.color = COLORS.edgeDefault;
+      break;
+  }
+  return v;
+}
+function bfsFromTicket(snap, ticketId, depth) {
+  const nodeIds = new Set([ticketId]);
+  const edgeIdxs = new Set;
+  let frontier = new Set([ticketId]);
+  for (let d = 0;d < depth; d++) {
+    const next = new Set;
+    snap.edges.forEach((e, i) => {
+      if (frontier.has(e.from) && !nodeIds.has(e.to)) {
+        nodeIds.add(e.to);
+        next.add(e.to);
+        edgeIdxs.add(i);
+      } else if (frontier.has(e.to) && !nodeIds.has(e.from)) {
+        nodeIds.add(e.from);
+        next.add(e.from);
+        edgeIdxs.add(i);
+      } else if (frontier.has(e.from) && nodeIds.has(e.to)) {
+        edgeIdxs.add(i);
+      } else if (frontier.has(e.to) && nodeIds.has(e.from)) {
+        edgeIdxs.add(i);
+      }
+    });
+    frontier = next;
+    if (frontier.size === 0)
+      break;
+  }
+  return { nodeIds, edgeIdxs };
+}
+function transformForVisNetwork(snap, opts) {
+  const mode = opts.performanceMode ?? "full";
+  const nodes = [];
+  const edges = [];
+  let includeTickets = new Set;
+  let includeScenarios = new Set;
+  let includePoms = new Set;
+  let includeAreas = new Set;
+  let includeEdgeIdxs = new Set;
+  if (opts.ticketId) {
+    const result = bfsFromTicket(snap, opts.ticketId, opts.depth ?? 2);
+    for (const id of result.nodeIds) {
+      if (snap.tickets[id])
+        includeTickets.add(id);
+      else if (snap.scenarios[id])
+        includeScenarios.add(id);
+      else if (snap.poms[id])
+        includePoms.add(id);
+      else if (snap.areas[id])
+        includeAreas.add(id);
+    }
+    includeEdgeIdxs = result.edgeIdxs;
+  } else {
+    includeTickets = new Set(Object.keys(snap.tickets).filter((id) => ticketsAfter(opts.since, snap.tickets[id].fetchedAt)));
+    includeScenarios = new Set(Object.keys(snap.scenarios).filter((id) => scenariosAfter(opts.since, snap.scenarios[id].generatedAt)));
+    includePoms = new Set(Object.keys(snap.poms));
+    includeAreas = new Set(Object.keys(snap.areas));
+    snap.edges.forEach((_, i) => {
+      includeEdgeIdxs.add(i);
+    });
+  }
+  if (mode === "ticket-only") {
+    includeScenarios.clear();
+    includePoms.clear();
+    includeAreas.clear();
+  }
+  for (const id of includeTickets)
+    nodes.push(buildTicketNode(snap, id));
+  for (const id of includeScenarios)
+    nodes.push(buildScenarioNode(snap, id));
+  for (const id of includePoms)
+    nodes.push(buildPomNode(snap, id));
+  for (const id of includeAreas)
+    nodes.push(buildAreaNode(snap, id));
+  for (const failure of Object.values(snap.latest_failures)) {
+    if (includeScenarios.has(failure.scenarioId)) {
+      nodes.push(buildFailureNode(snap, failure));
+    }
+  }
+  const visibleNodeIds = new Set(nodes.map((n) => n.id));
+  for (const i of includeEdgeIdxs) {
+    const e = snap.edges[i];
+    if (!e)
+      continue;
+    if (!visibleNodeIds.has(e.from) || !visibleNodeIds.has(e.to))
+      continue;
+    edges.push(buildEdge(e, i));
+  }
+  const stats = {
+    tickets: includeTickets.size,
+    scenarios: includeScenarios.size,
+    poms: includePoms.size,
+    areas: includeAreas.size,
+    failures: nodes.filter((n) => n.group === "Failure").length,
+    edges: edges.length
+  };
+  return { nodes, edges, stats };
+}
+var __filename2 = fileURLToPath(import.meta.url);
+var __dirname2 = dirname6(__filename2);
+var TEMPLATES_DIR = join16(__dirname2, "templates");
+function loadTemplate(name) {
+  return readFileSync17(join16(TEMPLATES_DIR, name), "utf8");
+}
+function statsToHuman(s) {
+  return `${s.tickets} tickets \xB7 ${s.scenarios} scenarios \xB7 ${s.poms} POMs \xB7 ${s.edges} edges`;
+}
+function renderHtml(input) {
+  const template = loadTemplate("graph.html.template");
+  const css = loadTemplate("graph.css");
+  const js = loadTemplate("graph.js");
+  const visNetwork = loadTemplate("vis-network.min.js");
+  const graphJson = JSON.stringify(input.data);
+  const statsHuman = statsToHuman(input.stats);
+  return template.replace("{{CSS}}", () => css).replace("{{STATS}}", () => statsHuman).replace("{{GENERATED_AT}}", () => input.generatedAt).replace("{{VIS_NETWORK_JS}}", () => visNetwork).replace("{{GRAPH_DATA}}", () => graphJson).replace("{{INTERACTION_JS}}", () => js);
+}
+
+// src/bin-internal/graph-render.ts
+init_store();
+function parseDepth(s) {
+  const n = s ? Number.parseInt(s, 10) : 2;
+  if (n === 1 || n === 3)
+    return n;
+  return 2;
+}
+function decidePerformanceMode(nodeCount) {
+  if (nodeCount > 2000)
+    return "text-fallback";
+  if (nodeCount > 500)
+    return "ticket-only";
+  return "full";
+}
+async function graphRenderCmd(argv) {
+  let outPath;
+  let ticketId;
+  let since;
+  let depth = 2;
+  for (let i = 0;i < argv.length; i++) {
+    if (argv[i] === "--out")
+      outPath = argv[++i];
+    else if (argv[i] === "--ticket")
+      ticketId = argv[++i];
+    else if (argv[i] === "--since")
+      since = argv[++i];
+    else if (argv[i] === "--depth")
+      depth = parseDepth(argv[++i]);
+  }
+  const repoRoot = process.cwd();
+  const finalPath = outPath ?? join17(repoRoot, ".xera/graph.html");
+  const snap = deriveSnapshot(loadAllEvents(repoRoot));
+  const totalNodeCount = Object.keys(snap.tickets).length + Object.keys(snap.scenarios).length + Object.keys(snap.poms).length + Object.keys(snap.areas).length;
+  const performanceMode = decidePerformanceMode(totalNodeCount);
+  if (performanceMode === "text-fallback") {
+    const txtPath = finalPath.replace(/\.html$/, ".txt");
+    mkdirSync11(dirname7(txtPath), { recursive: true });
+    writeFileSync10(txtPath, `Graph too large for HTML viewer (${totalNodeCount} nodes). Use 'xera:graph-query --format text' instead.
+`);
+    console.log(`[graph-render] graph too large (${totalNodeCount} nodes); wrote ${txtPath}`);
+    return 0;
+  }
+  const opts = { depth, performanceMode };
+  if (ticketId)
+    opts.ticketId = ticketId;
+  if (since)
+    opts.since = since;
+  const data = transformForVisNetwork(snap, opts);
+  const html = renderHtml({ data, stats: data.stats, generatedAt: new Date().toISOString() });
+  mkdirSync11(dirname7(finalPath), { recursive: true });
+  const tmpPath = `${finalPath}.tmp`;
+  writeFileSync10(tmpPath, html);
+  renameSync2(tmpPath, finalPath);
+  console.log(`[graph-render] wrote ${finalPath} (${data.stats.tickets} tickets \xB7 ${data.stats.scenarios} scenarios \xB7 ${html.length} bytes)`);
+  return 0;
+}
+
 // src/bin-internal/graph-snapshot.ts
 init_store();
 async function graphSnapshotCmd(argv) {
@@ -9482,8 +9782,8 @@ async function graphSnapshotCmd(argv) {
 }
 
 // src/bin-internal/heal-prepare.ts
-import { existsSync as existsSync20, readdirSync as readdirSync6, readFileSync as readFileSync17, writeFileSync as writeFileSync10 } from "fs";
-import { join as join16 } from "path";
+import { existsSync as existsSync20, readdirSync as readdirSync6, readFileSync as readFileSync18, writeFileSync as writeFileSync11 } from "fs";
+import { join as join18 } from "path";
 import { scrubFreeText } from "@xera-ai/web";
 
 // ../../node_modules/.bun/fflate@0.8.3/node_modules/fflate/esm/index.mjs
@@ -9913,7 +10213,7 @@ function classifyKind(raw) {
 function extractDomSnapshot(tracePath) {
   if (!existsSync20(tracePath))
     return "";
-  const buf = readFileSync17(tracePath);
+  const buf = readFileSync18(tracePath);
   const entries = unzipSync(buf);
   const traceKey = Object.keys(entries).find((name) => name.endsWith(".trace"));
   let chosenKey = null;
@@ -9961,16 +10261,16 @@ function extractDomSnapshot(tracePath) {
   return scrubFreeText(html);
 }
 function findPomLine(ticketDir, rawLocator) {
-  const pomDir = join16(ticketDir, "page-objects");
+  const pomDir = join18(ticketDir, "page-objects");
   const candidates = [];
   if (existsSync20(pomDir)) {
     for (const name of readdirSync6(pomDir)) {
       if (name.endsWith(".ts"))
-        candidates.push(join16(pomDir, name));
+        candidates.push(join18(pomDir, name));
     }
   }
   for (const file of candidates) {
-    const text = readFileSync17(file, "utf8");
+    const text = readFileSync18(file, "utf8");
     const lines = text.split(`
 `);
     for (let i2 = 0;i2 < lines.length; i2++) {
@@ -10008,13 +10308,13 @@ function findGherkinStep(featureText, rawLocator) {
 }
 function healPrepare(repoRoot, ticket, runId, scenarioName) {
   const paths = resolveArtifactPaths(repoRoot, ticket);
-  const classifierPath = join16(paths.ticketDir, "classifier-input.json");
-  const classifier = JSON.parse(readFileSync17(classifierPath, "utf8"));
+  const classifierPath = join18(paths.ticketDir, "classifier-input.json");
+  const classifier = JSON.parse(readFileSync18(classifierPath, "utf8"));
   const cls = classifier.scenarios.find((s) => s.name === scenarioName);
   if (!cls)
     throw new Error(`scenario not found in classifier-input: "${scenarioName}"`);
-  const runDir = join16(paths.runsDir, runId);
-  const normalized = JSON.parse(readFileSync17(join16(runDir, "normalized.json"), "utf8"));
+  const runDir = join18(paths.runsDir, runId);
+  const normalized = JSON.parse(readFileSync18(join18(runDir, "normalized.json"), "utf8"));
   const normSc = normalized.scenarios.find((s) => s.name === scenarioName);
   if (!normSc?.failure)
     throw new Error(`no failure recorded for scenario "${scenarioName}"`);
@@ -10025,9 +10325,9 @@ function healPrepare(repoRoot, ticket, runId, scenarioName) {
   const raw = m[1].trim();
   const kind = classifyKind(raw);
   const pomLoc = findPomLine(paths.ticketDir, raw);
-  const featureText = readFileSync17(paths.featurePath, "utf8");
+  const featureText = readFileSync18(paths.featurePath, "utf8");
   const gherkinStep = findGherkinStep(featureText, raw);
-  const domSnapshotAtFailure = extractDomSnapshot(join16(runDir, "trace.zip"));
+  const domSnapshotAtFailure = extractDomSnapshot(join18(runDir, "trace.zip"));
   return {
     ticket,
     runId,
@@ -10047,8 +10347,8 @@ async function healPrepareCmd(argv) {
   try {
     const result = healPrepare(process.cwd(), ticket, runId, scenarioName);
     const paths = resolveArtifactPaths(process.cwd(), ticket);
-    const outPath = join16(paths.runsDir, runId, "heal-input.json");
-    writeFileSync10(outPath, JSON.stringify(result, null, 2));
+    const outPath = join18(paths.runsDir, runId, "heal-input.json");
+    writeFileSync11(outPath, JSON.stringify(result, null, 2));
     console.log(`[xera:heal-prepare] wrote ${outPath}`);
     return 0;
   } catch (err2) {
@@ -10058,8 +10358,8 @@ async function healPrepareCmd(argv) {
 }
 
 // src/bin-internal/impact-prepare.ts
-import { mkdirSync as mkdirSync11, writeFileSync as writeFileSync11 } from "fs";
-import { join as join17 } from "path";
+import { mkdirSync as mkdirSync12, writeFileSync as writeFileSync12 } from "fs";
+import { join as join19 } from "path";
 
 // src/graph/impact.ts
 var PRIORITY_WEIGHT = { p0: 3, p1: 2, p2: 1 };
@@ -10264,7 +10564,7 @@ function renderImpactMarkdown(report) {
 
 // src/bin-internal/impact-prepare.ts
 init_store();
-function parseDepth(s) {
+function parseDepth2(s) {
   const n = s ? Number.parseInt(s, 10) : 2;
   if (n === 1 || n === 3)
     return n;
@@ -10286,7 +10586,7 @@ async function impactPrepareCmd(argv) {
   let quiet = false;
   for (let i2 = 1;i2 < argv.length; i2++) {
     if (argv[i2] === "--depth")
-      depth = parseDepth(argv[++i2]);
+      depth = parseDepth2(argv[++i2]);
     else if (argv[i2] === "--min-priority")
       minPriority = parseMinPriority(argv[++i2]);
     else if (argv[i2] === "--quiet")
@@ -10309,11 +10609,11 @@ async function impactPrepareCmd(argv) {
     scenarios,
     generatedAt: new Date().toISOString()
   };
-  const impactDir = join17(repoRoot, ".xera/impact");
-  mkdirSync11(impactDir, { recursive: true });
-  writeFileSync11(join17(impactDir, `${ticket}.json`), JSON.stringify(report, null, 2));
+  const impactDir = join19(repoRoot, ".xera/impact");
+  mkdirSync12(impactDir, { recursive: true });
+  writeFileSync12(join19(impactDir, `${ticket}.json`), JSON.stringify(report, null, 2));
   if (!quiet) {
-    writeFileSync11(join17(impactDir, `${ticket}.md`), renderImpactMarkdown(report));
+    writeFileSync12(join19(impactDir, `${ticket}.md`), renderImpactMarkdown(report));
   }
   return 0;
 }
@@ -10339,7 +10639,7 @@ async function lintCmd(argv) {
 
 // src/bin-internal/normalize.ts
 import { existsSync as existsSync21, readdirSync as readdirSync7 } from "fs";
-import { join as join18 } from "path";
+import { join as join20 } from "path";
 import { normalizeRun } from "@xera-ai/web";
 async function normalizeCmd(argv) {
   const ticket = argv[0];
@@ -10354,7 +10654,7 @@ async function normalizeCmd(argv) {
     console.error("[xera:normalize] no run found");
     return 1;
   }
-  const runDir = join18(paths.runsDir, runId);
+  const runDir = join20(paths.runsDir, runId);
   if (!existsSync21(runDir)) {
     console.error(`[xera:normalize] runs/${runId} missing`);
     return 1;
@@ -10365,12 +10665,12 @@ async function normalizeCmd(argv) {
 }
 
 // src/bin-internal/post.ts
-import { existsSync as existsSync23, readFileSync as readFileSync19 } from "fs";
-import { join as join19 } from "path";
+import { existsSync as existsSync23, readFileSync as readFileSync20 } from "fs";
+import { join as join21 } from "path";
 
 // src/artifact/status.ts
-import { existsSync as existsSync22, mkdirSync as mkdirSync12, readFileSync as readFileSync18, writeFileSync as writeFileSync12 } from "fs";
-import { dirname as dirname6 } from "path";
+import { existsSync as existsSync22, mkdirSync as mkdirSync13, readFileSync as readFileSync19, writeFileSync as writeFileSync13 } from "fs";
+import { dirname as dirname8 } from "path";
 import { z as z7 } from "zod";
 var ClassificationEnum = z7.enum([
   "PASS",
@@ -10406,11 +10706,11 @@ var HISTORY_CAP = 20;
 function readStatus(path) {
   if (!existsSync22(path))
     return null;
-  return StatusJsonSchema.parse(JSON.parse(readFileSync18(path, "utf8")));
+  return StatusJsonSchema.parse(JSON.parse(readFileSync19(path, "utf8")));
 }
 function writeStatus(path, status) {
-  mkdirSync12(dirname6(path), { recursive: true });
-  writeFileSync12(path, JSON.stringify(status, null, 2));
+  mkdirSync13(dirname8(path), { recursive: true });
+  writeFileSync13(path, JSON.stringify(status, null, 2));
 }
 function appendHistory(path, entry) {
   const s = readStatus(path);
@@ -10436,12 +10736,12 @@ async function postCmd(argv) {
     return 0;
   }
   const paths = resolveArtifactPaths(cwd, ticket);
-  const draftPath = join19(paths.ticketDir, "jira-comment.draft.md");
+  const draftPath = join21(paths.ticketDir, "jira-comment.draft.md");
   if (!existsSync23(draftPath)) {
     console.error(`[xera:post] no draft at ${draftPath}; run \`xera-internal report\` first.`);
     return 1;
   }
-  const body = readFileSync19(draftPath, "utf8");
+  const body = readFileSync20(draftPath, "utf8");
   const client = await createJiraClient({
     baseUrl: config.jira.baseUrl,
     preferMcp: true,
@@ -10469,8 +10769,8 @@ async function promoteCmd(argv) {
 }
 
 // src/bin-internal/report.ts
-import { existsSync as existsSync25, readFileSync as readFileSync20, writeFileSync as writeFileSync13 } from "fs";
-import { join as join20 } from "path";
+import { existsSync as existsSync25, readFileSync as readFileSync21, writeFileSync as writeFileSync14 } from "fs";
+import { join as join22 } from "path";
 
 // src/classifier/aggregate.ts
 var CLASS_PRIORITY = [
@@ -10642,10 +10942,10 @@ async function reportCmd(argv) {
     return 1;
   }
   const paths = resolveArtifactPaths(process.cwd(), ticket);
-  const input = JSON.parse(readFileSync20(inputArg.slice("--input=".length), "utf8"));
+  const input = JSON.parse(readFileSync21(inputArg.slice("--input=".length), "utf8"));
   const aggregated = aggregateScenarios(input.scenarios);
-  const decisionsPath = join20(paths.ticketDir, "runs", input.runId, "outdated-decisions.json");
-  const decisions = existsSync25(decisionsPath) ? JSON.parse(readFileSync20(decisionsPath, "utf8")) : {};
+  const decisionsPath = join22(paths.ticketDir, "runs", input.runId, "outdated-decisions.json");
+  const decisions = existsSync25(decisionsPath) ? JSON.parse(readFileSync21(decisionsPath, "utf8")) : {};
   const graph = deriveSnapshot(loadAllEvents(process.cwd()));
   const normalizeScenarioName = (name) => name.trim().toLowerCase().replace(/\s+/g, " ");
   const scenarioIdByName = {};
@@ -10693,8 +10993,8 @@ async function reportCmd(argv) {
     xeraVersion: "0.1.0",
     promptsVersion: "1.0.0"
   });
-  const draftPath = join20(paths.ticketDir, "jira-comment.draft.md");
-  writeFileSync13(draftPath, md);
+  const draftPath = join22(paths.ticketDir, "jira-comment.draft.md");
+  writeFileSync14(draftPath, md);
   console.log(`[xera:report] wrote status.json and ${draftPath}`);
   return 0;
 }
@@ -10761,7 +11061,7 @@ async function unlockCmd(argv) {
 }
 
 // src/bin-internal/validate-feature.ts
-import { existsSync as existsSync26, readFileSync as readFileSync21 } from "fs";
+import { existsSync as existsSync26, readFileSync as readFileSync22 } from "fs";
 import { validateGherkin as validateGherkin2 } from "@xera-ai/web";
 async function validateFeatureCmd(argv) {
   const ticket = argv[0];
@@ -10774,7 +11074,7 @@ async function validateFeatureCmd(argv) {
     console.error(`[xera:validate-feature] missing ${paths.featurePath}`);
     return 1;
   }
-  const r = validateGherkin2(readFileSync21(paths.featurePath, "utf8"));
+  const r = validateGherkin2(readFileSync22(paths.featurePath, "utf8"));
   if (r.ok) {
     console.log("[xera:validate-feature] ok");
     return 0;
@@ -10794,6 +11094,7 @@ var COMMANDS = {
   fetch: fetchCmd,
   "graph-backfill": graphBackfillCmd,
   "graph-enrich": graphEnrichCmd,
+  "graph-render": graphRenderCmd,
   "graph-query": graphQueryCmd,
   "graph-record": graphRecordCmd,
   "graph-snapshot": graphSnapshotCmd,

package/dist/bin-internal/graph-render.d.ts

@@ -0,0 +1,2 @@
+export declare function graphRenderCmd(argv: string[]): Promise<number>;
+//# sourceMappingURL=graph-render.d.ts.map

package/dist/bin-internal/graph-render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-render.d.ts","sourceRoot":"","sources":["../../src/bin-internal/graph-render.ts"],"names":[],"mappings":"AAkBA,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAmDpE"}

package/dist/bin-internal/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bin-internal/index.ts"],"names":[],"mappings":"AAkDA,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAczD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bin-internal/index.ts"],"names":[],"mappings":"AAoDA,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAczD"}

package/dist/graph/index.d.ts

@@ -7,6 +7,8 @@ export { enrichTicket } from './enrich';
 export type { ImpactEdge, ImpactOpts, ImpactReport, ImpactScenario, } from './impact';
 export { renderImpactMarkdown, riskScore, walkImpact, } from './impact';
 export { currentYyyyMm, graphPaths } from './paths';
+export type { GraphStats, RenderHtmlInput, RenderOpts, VisEdge, VisNode } from './render';
+export { renderHtml, transformForVisNetwork } from './render';
 export { EventSchema, safeParseEvent } from './schema';
 export { buildSimilarityPrompt } from './similarity';
 export { appendEvents, computeEventsHash, deriveSnapshot, isSnapshotStale, loadAllEvents, loadSnapshot, writeSnapshot, } from './store';

package/dist/graph/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/graph/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,cAAc,EACd,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACnD,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,YAAY,EACV,UAAU,EACV,UAAU,EACV,YAAY,EACZ,cAAc,GACf,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,oBAAoB,EACpB,SAAS,EACT,UAAU,GACX,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,aAAa,EACb,YAAY,EACZ,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/graph/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,cAAc,EACd,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACnD,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,YAAY,EACV,UAAU,EACV,UAAU,EACV,YAAY,EACZ,cAAc,GACf,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,oBAAoB,EACpB,SAAS,EACT,UAAU,GACX,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACpD,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1F,OAAO,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,aAAa,EACb,YAAY,EACZ,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC"}

package/dist/graph/render.d.ts

@@ -0,0 +1,50 @@
+import type { Snapshot } from './types';
+export interface VisNode {
+    id: string;
+    label: string;
+    group: 'Ticket' | 'Scenario' | 'POM' | 'SUTArea' | 'Failure';
+    color?: string;
+    shape?: string;
+    size?: number;
+    title?: string;
+    borderWidth?: number;
+}
+export interface VisEdge {
+    id?: string;
+    from: string;
+    to: string;
+    label?: string;
+    color?: string;
+    dashes?: boolean;
+    width?: number;
+    arrows?: string;
+}
+export interface GraphStats {
+    tickets: number;
+    scenarios: number;
+    poms: number;
+    areas: number;
+    failures: number;
+    edges: number;
+}
+export interface RenderOpts {
+    since?: string;
+    ticketId?: string;
+    depth?: 1 | 2 | 3;
+    performanceMode?: 'full' | 'ticket-only' | 'text-fallback';
+}
+export declare function transformForVisNetwork(snap: Snapshot, opts: RenderOpts): {
+    nodes: VisNode[];
+    edges: VisEdge[];
+    stats: GraphStats;
+};
+export interface RenderHtmlInput {
+    data: {
+        nodes: VisNode[];
+        edges: VisEdge[];
+    };
+    stats: GraphStats;
+    generatedAt: string;
+}
+export declare function renderHtml(input: RenderHtmlInput): string;
+//# sourceMappingURL=render.d.ts.map

package/dist/graph/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../src/graph/render.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAc,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEpD,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,QAAQ,GAAG,UAAU,GAAG,KAAK,GAAG,SAAS,GAAG,SAAS,CAAC;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,eAAe,CAAC;CAC5D;AAmKD,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,QAAQ,EACd,IAAI,EAAE,UAAU,GACf;IACD,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,KAAK,EAAE,UAAU,CAAC;CACnB,CA4EA;AAcD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE;QAAE,KAAK,EAAE,OAAO,EAAE,CAAC;QAAC,KAAK,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;IAC7C,KAAK,EAAE,UAAU,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAgBzD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xera-ai/core",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",