@xera-ai/core 0.13.0 → 0.14.0

package/dist/bin/internal.js

@@ -490,6 +490,7 @@ var init_schema = __esm(() => {
     "SELECTOR_DRIFT",
     "FLAKY",
     "PASS",
+    "SKIPPED",
     "TEST_OUTDATED",
     "CONTRACT_DRIFT",
     "RATE_LIMITED",
@@ -828,9 +829,10 @@ function deriveSnapshot(events) {
       }
       case "ac-coverage.backfilled": {
         const { ts, ticketId, mappings } = e.payload;
+        const touchedScenarios = new Set(mappings.map((m) => m.scenarioId));
         for (let i = edges.length - 1;i >= 0; i--) {
           const ed = edges[i];
-          if (ed.kind === "satisfies" && ed.source === "ac-coverage" && ed.to.startsWith(`${ticketId}#ac-`)) {
+          if (ed.kind === "satisfies" && ed.source === "ac-coverage" && ed.to.startsWith(`${ticketId}#ac-`) && touchedScenarios.has(ed.from)) {
             edges.splice(i, 1);
           }
         }
@@ -8175,6 +8177,7 @@ var init_paths2 = __esm(() => {
 var exports_graph_record = {};
 __export(exports_graph_record, {
   recordFetch: () => recordFetch,
+  recordExec: () => recordExec,
   graphRecordCmd: () => graphRecordCmd
 });
 import { createHash as createHash3 } from "crypto";
@@ -8476,6 +8479,7 @@ async function graphRecordCmd(argv) {
         "SELECTOR_DRIFT",
         "FLAKY",
         "PASS",
+        "SKIPPED",
         "TEST_OUTDATED",
         "CONTRACT_DRIFT",
         "RATE_LIMITED",
@@ -8657,15 +8661,15 @@ function findUnmapped(snap) {
     const ticketScenarios = Object.values(snap.scenarios).filter((s) => s.ticketId === ticket.id);
     if (ticketScenarios.length === 0)
       continue;
-    const acsForTicket = Object.values(snap.acNodes).filter((ac) => ac.ticketId === ticket.id);
-    const hasAnyEdge = snap.edges.some((e) => e.kind === "satisfies" && acsForTicket.some((ac) => ac.id === e.to));
-    if (hasAnyEdge)
+    const acIdsForTicket = new Set(Object.values(snap.acNodes).filter((ac) => ac.ticketId === ticket.id).map((ac) => ac.id));
+    const unmappedScenarios = ticketScenarios.filter((s) => !snap.edges.some((e) => e.kind === "satisfies" && e.from === s.id && acIdsForTicket.has(e.to)));
+    if (unmappedScenarios.length === 0)
       continue;
     out.push({
       id: ticket.id,
       summary: ticket.summary,
       acs: ticket.ac,
-      scenarios: ticketScenarios.map((s) => ({
+      scenarios: unmappedScenarios.map((s) => ({
         id: s.id,
         name: s.name,
         gherkin: s.gherkin
@@ -9094,15 +9098,17 @@ function buildCoverageReport(snap, config, now) {
 }
 function needsBackfill(snap) {
   for (const ticket of Object.values(snap.tickets)) {
-    const acsForTicket = Object.values(snap.acNodes).filter((ac) => ac.ticketId === ticket.id);
-    if (acsForTicket.length === 0)
+    const acIdsForTicket = new Set(Object.values(snap.acNodes).filter((ac) => ac.ticketId === ticket.id).map((ac) => ac.id));
+    if (acIdsForTicket.size === 0)
       continue;
     const scenariosForTicket = Object.values(snap.scenarios).filter((s) => s.ticketId === ticket.id);
     if (scenariosForTicket.length === 0)
       continue;
-    const hasAnyEdge = snap.edges.some((e) => e.kind === "satisfies" && acsForTicket.some((ac) => ac.id === e.to));
-    if (!hasAnyEdge)
-      return true;
+    for (const s of scenariosForTicket) {
+      const mapped = snap.edges.some((e) => e.kind === "satisfies" && e.from === s.id && acIdsForTicket.has(e.to));
+      if (!mapped)
+        return true;
+    }
   }
   return false;
 }
@@ -12656,10 +12662,11 @@ async function lintCmd(argv) {
 import { existsSync as existsSync27, readdirSync as readdirSync7 } from "fs";
 import { join as join28 } from "path";
 init_paths2();
+init_graph_record();
 async function normalizeCmd(argv) {
   const ticket = argv[0];
   if (!ticket) {
-    console.error("[xera:normalize] usage: normalize <TICKET> [--run=<runId>]");
+    console.error("[xera:normalize] usage: normalize <TICKET> [--run=<runId>] [--no-graph-record]");
     return 1;
   }
   const paths = resolveArtifactPaths(process.cwd(), ticket);
@@ -12674,17 +12681,24 @@ async function normalizeCmd(argv) {
     console.error(`[xera:normalize] runs/${runId} missing`);
     return 1;
   }
+  const skipGraphRecord = argv.includes("--no-graph-record");
   const meta = readMeta(paths.metaPath);
   const adapter = meta?.adapter ?? "web";
   if (adapter === "http") {
     const { normalizeHttpRun } = await import("@xera-ai/http");
     await normalizeHttpRun({ runId, runDir });
     console.log(`[xera:normalize] wrote normalized.json (http)`);
-    return 0;
+  } else {
+    const { normalizeRun } = await import("@xera-ai/web");
+    const r = await normalizeRun({ runId, runDir });
+    console.log(`[xera:normalize] wrote normalized.json (scrubbed_fields_count=${r.scrubbed_fields_count})`);
+  }
+  if (!skipGraphRecord) {
+    const code = await recordExec(process.cwd(), ticket, runId);
+    if (code !== 0) {
+      console.warn(`[xera:normalize] graph-record exec exited ${code} \u2014 continuing (non-fatal)`);
+    }
   }
-  const { normalizeRun } = await import("@xera-ai/web");
-  const r = await normalizeRun({ runId, runDir });
-  console.log(`[xera:normalize] wrote normalized.json (scrubbed_fields_count=${r.scrubbed_fields_count})`);
   return 0;
 }
 
@@ -12699,6 +12713,7 @@ import { dirname as dirname8 } from "path";
 import { z as z10 } from "zod";
 var ClassificationEnum = z10.enum([
   "PASS",
+  "SKIPPED",
   "REAL_BUG",
   "SELECTOR_DRIFT",
   "FLAKY",
@@ -12963,7 +12978,7 @@ function classifyRateLimited(input) {
 
 // src/graph/classify.ts
 var DEFAULT_THRESHOLD = 0.7;
-var SHORT_CIRCUIT = ["FLAKY", "PASS"];
+var SHORT_CIRCUIT = ["FLAKY", "PASS", "SKIPPED"];
 function findCandidateTickets(graph, scenario) {
   const poms = graph.edges.filter((e) => e.kind === "uses" && e.from === scenario.id).map((e) => e.to);
   if (poms.length === 0)

package/dist/src/index.js

@@ -146,6 +146,7 @@ import { dirname as dirname2 } from "path";
 import { z as z2 } from "zod";
 var ClassificationEnum = z2.enum([
   "PASS",
+  "SKIPPED",
   "REAL_BUG",
   "SELECTOR_DRIFT",
   "FLAKY",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xera-ai/core",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -31,8 +31,8 @@
   },
   "dependencies": {
     "zod": "4.4.3",
-    "@xera-ai/web": "^0.13.0",
-    "@xera-ai/http": "^0.13.0",
+    "@xera-ai/web": "^0.14.0",
+    "@xera-ai/http": "^0.14.0",
     "@playwright/test": "1.60.0",
     "dotenv": "^16.0.0",
     "fflate": "0.8.3",

package/src/artifact/status.ts

@@ -4,6 +4,7 @@ import { z } from 'zod';
 
 const ClassificationEnum = z.enum([
   'PASS',
+  'SKIPPED',
   'REAL_BUG',
   'SELECTOR_DRIFT',
   'FLAKY',

package/src/bin-internal/ac-coverage-backfill-prepare.ts

@@ -18,16 +18,26 @@ function findUnmapped(snap: Snapshot): BackfillInput {
     if (ticket.ac.length === 0) continue;
     const ticketScenarios = Object.values(snap.scenarios).filter((s) => s.ticketId === ticket.id);
     if (ticketScenarios.length === 0) continue;
-    const acsForTicket = Object.values(snap.acNodes).filter((ac) => ac.ticketId === ticket.id);
-    const hasAnyEdge = snap.edges.some(
-      (e) => e.kind === 'satisfies' && acsForTicket.some((ac) => ac.id === e.to),
+    const acIdsForTicket = new Set(
+      Object.values(snap.acNodes)
+        .filter((ac) => ac.ticketId === ticket.id)
+        .map((ac) => ac.id),
     );
-    if (hasAnyEdge) continue;
+    // Per-scenario: a scenario is "unmapped" if it has no `satisfies` edge to
+    // any of this ticket's ACs. Surface only those — finalize is now additive
+    // (#119) so partial mappings won't clobber prior edges.
+    const unmappedScenarios = ticketScenarios.filter(
+      (s) =>
+        !snap.edges.some(
+          (e) => e.kind === 'satisfies' && e.from === s.id && acIdsForTicket.has(e.to),
+        ),
+    );
+    if (unmappedScenarios.length === 0) continue;
     out.push({
       id: ticket.id,
       summary: ticket.summary,
       acs: ticket.ac,
-      scenarios: ticketScenarios.map((s) => ({
+      scenarios: unmappedScenarios.map((s) => ({
         id: s.id,
         name: s.name,
         gherkin: s.gherkin,

package/src/bin-internal/graph-record.ts

@@ -190,7 +190,7 @@ async function recordScript(repoRoot: string, ticket: string): Promise<number> {
   return recordScriptImpl(repoRoot, ticket);
 }
 
-async function recordExec(repoRoot: string, ticket: string, runId: string): Promise<number> {
+export async function recordExec(repoRoot: string, ticket: string, runId: string): Promise<number> {
   const { normalizedPath } = resolveArtifactPaths(repoRoot, ticket).runPath(runId);
   if (!existsSync(normalizedPath)) {
     console.error(`[graph-record exec] normalized.json missing`);
@@ -362,6 +362,7 @@ export async function graphRecordCmd(argv: string[]): Promise<number> {
         'SELECTOR_DRIFT',
         'FLAKY',
         'PASS',
+        'SKIPPED',
         'TEST_OUTDATED',
         'CONTRACT_DRIFT',
         'RATE_LIMITED',

package/src/bin-internal/normalize.ts

@@ -2,11 +2,12 @@ import { existsSync, readdirSync } from 'node:fs';
 import { join } from 'node:path';
 import { readMeta } from '../artifact/meta';
 import { resolveArtifactPaths } from '../artifact/paths';
+import { recordExec } from './graph-record';
 
 export async function normalizeCmd(argv: string[]): Promise<number> {
   const ticket = argv[0];
   if (!ticket) {
-    console.error('[xera:normalize] usage: normalize <TICKET> [--run=<runId>]');
+    console.error('[xera:normalize] usage: normalize <TICKET> [--run=<runId>] [--no-graph-record]');
     return 1;
   }
   const paths = resolveArtifactPaths(process.cwd(), ticket);
@@ -26,6 +27,7 @@ export async function normalizeCmd(argv: string[]): Promise<number> {
     console.error(`[xera:normalize] runs/${runId} missing`);
     return 1;
   }
+  const skipGraphRecord = argv.includes('--no-graph-record');
 
   const meta = readMeta(paths.metaPath);
   const adapter = meta?.adapter ?? 'web';
@@ -34,13 +36,23 @@ export async function normalizeCmd(argv: string[]): Promise<number> {
     const { normalizeHttpRun } = await import('@xera-ai/http');
     await normalizeHttpRun({ runId, runDir });
     console.log(`[xera:normalize] wrote normalized.json (http)`);
-    return 0;
+  } else {
+    const { normalizeRun } = await import('@xera-ai/web');
+    const r = await normalizeRun({ runId, runDir });
+    console.log(
+      `[xera:normalize] wrote normalized.json (scrubbed_fields_count=${r.scrubbed_fields_count})`,
+    );
   }
 
-  const { normalizeRun } = await import('@xera-ai/web');
-  const r = await normalizeRun({ runId, runDir });
-  console.log(
-    `[xera:normalize] wrote normalized.json (scrubbed_fields_count=${r.scrubbed_fields_count})`,
-  );
+  // Emit run.completed events so the graph's latest_failures (and any
+  // recency-based risk scoring) reflect this run. Without this the
+  // /xera-run pipeline silently renders failed scenarios as green in
+  // graph.html — see #118.
+  if (!skipGraphRecord) {
+    const code = await recordExec(process.cwd(), ticket, runId);
+    if (code !== 0) {
+      console.warn(`[xera:normalize] graph-record exec exited ${code} — continuing (non-fatal)`);
+    }
+  }
   return 0;
 }

package/src/coverage/report.ts

@@ -114,17 +114,26 @@ export function buildCoverageReport(
 }
 
 function needsBackfill(snap: Snapshot): boolean {
+  // True when at least one scenario lacks a `satisfies` edge to its ticket's
+  // ACs. Mirrors `findUnmapped` in ac-coverage-backfill-prepare so the flag
+  // and the prepare output stay consistent for partially mapped tickets (#119).
   for (const ticket of Object.values(snap.tickets)) {
-    const acsForTicket = Object.values(snap.acNodes).filter((ac) => ac.ticketId === ticket.id);
-    if (acsForTicket.length === 0) continue;
+    const acIdsForTicket = new Set(
+      Object.values(snap.acNodes)
+        .filter((ac) => ac.ticketId === ticket.id)
+        .map((ac) => ac.id),
+    );
+    if (acIdsForTicket.size === 0) continue;
     const scenariosForTicket = Object.values(snap.scenarios).filter(
       (s) => s.ticketId === ticket.id,
     );
     if (scenariosForTicket.length === 0) continue;
-    const hasAnyEdge = snap.edges.some(
-      (e) => e.kind === 'satisfies' && acsForTicket.some((ac) => ac.id === e.to),
-    );
-    if (!hasAnyEdge) return true;
+    for (const s of scenariosForTicket) {
+      const mapped = snap.edges.some(
+        (e) => e.kind === 'satisfies' && e.from === s.id && acIdsForTicket.has(e.to),
+      );
+      if (!mapped) return true;
+    }
   }
   return false;
 }

package/src/graph/classify.ts

@@ -43,7 +43,7 @@ export type DecideOutdated = (args: {
 }) => Promise<OutdatedDecision>;
 
 const DEFAULT_THRESHOLD = 0.7;
-const SHORT_CIRCUIT: Classification[] = ['FLAKY', 'PASS'];
+const SHORT_CIRCUIT: Classification[] = ['FLAKY', 'PASS', 'SKIPPED'];
 
 export function findCandidateTickets(graph: Snapshot, scenario: ScenarioNode): TicketNode[] {
   const poms = graph.edges

package/src/graph/schema.ts

@@ -78,6 +78,7 @@ const classification = z.enum([
   'SELECTOR_DRIFT',
   'FLAKY',
   'PASS',
+  'SKIPPED',
   'TEST_OUTDATED',
   'CONTRACT_DRIFT',
   'RATE_LIMITED',

package/src/graph/store.ts

@@ -277,13 +277,18 @@ export function deriveSnapshot(events: Event[]): Snapshot {
       }
       case 'ac-coverage.backfilled': {
         const { ts, ticketId, mappings } = e.payload;
-        // Remove prior backfill edges for this ticket (idempotent)
+        // Upsert per scenarioId: drop only the prior backfill edges from the
+        // scenarios this event maps, then add the new edges. Scenarios not
+        // mentioned in the payload keep their prior edges so partial backfills
+        // are additive (matches every other handler — see #119).
+        const touchedScenarios = new Set(mappings.map((m) => m.scenarioId));
         for (let i = edges.length - 1; i >= 0; i--) {
           const ed = edges[i]!;
           if (
             ed.kind === 'satisfies' &&
             ed.source === 'ac-coverage' &&
-            ed.to.startsWith(`${ticketId}#ac-`)
+            ed.to.startsWith(`${ticketId}#ac-`) &&
+            touchedScenarios.has(ed.from)
           ) {
             edges.splice(i, 1);
           }

package/src/graph/types.ts

@@ -20,6 +20,7 @@ export type Classification =
   | 'SELECTOR_DRIFT'
   | 'FLAKY'
   | 'PASS'
+  | 'SKIPPED'
   | 'TEST_OUTDATED'
   | 'CONTRACT_DRIFT'
   | 'RATE_LIMITED'