@xera-ai/core 0.4.0 → 0.4.1

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

@@ -1 +1 @@
-{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/bin-internal/report.ts"],"names":[],"mappings":"AAcA,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAgC/D"}
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../src/bin-internal/report.ts"],"names":[],"mappings":"AAiBA,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAuF/D"}

package/dist/bin-internal/verify-prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"verify-prompts.d.ts","sourceRoot":"","sources":["../../src/bin-internal/verify-prompts.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAaD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,EAAE,CA8B7D;AAED,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAQvE"}
+{"version":3,"file":"verify-prompts.d.ts","sourceRoot":"","sources":["../../src/bin-internal/verify-prompts.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAeD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,EAAE,CA8B7D;AAED,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAQvE"}

package/dist/classifier/aggregate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"aggregate.d.ts","sourceRoot":"","sources":["../../src/classifier/aggregate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAc,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAYlF,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,sBAAsB,EAAE,GAAG,cAAc,CAoBtF"}
+{"version":3,"file":"aggregate.d.ts","sourceRoot":"","sources":["../../src/classifier/aggregate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAc,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAalF,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,sBAAsB,EAAE,GAAG,cAAc,CAoBtF"}

package/dist/graph/classify.d.ts

@@ -0,0 +1,42 @@
+import type { Classification, ScenarioNode, Snapshot, TicketNode } from './types';
+export interface ClassifyInput {
+    scenarioId: string;
+    traceClassification: Classification;
+}
+export interface CandidateEvidence {
+    ticketId: string;
+    summary: string;
+    modifiedArea: string;
+    relevantAcRef?: string;
+}
+export interface ClassifyEvidence {
+    candidateTickets?: CandidateEvidence[];
+    reasoning?: string;
+    expectedByTest?: string;
+    actualInApp?: string;
+    proposedAction?: 'regenerate-scenario' | 'review-and-decide';
+}
+export interface ClassifyOutput {
+    classification: Classification;
+    confidence: number;
+    evidence?: ClassifyEvidence;
+}
+export interface OutdatedDecision {
+    classification: 'TEST_OUTDATED' | 'BUG' | 'AMBIGUOUS';
+    confidence: number;
+    evidence: {
+        reasoning: string;
+        expectedByTest?: string;
+        actualInApp?: string;
+        relevantAcRef?: string;
+    };
+}
+export type DecideOutdated = (args: {
+    scenario: ScenarioNode;
+    candidates: TicketNode[];
+}) => Promise<OutdatedDecision>;
+export declare function findCandidateTickets(graph: Snapshot, scenario: ScenarioNode): TicketNode[];
+export declare function enhanceClassification(input: ClassifyInput, graph: Snapshot, decideOutdated: DecideOutdated, options?: {
+    threshold?: number;
+}): Promise<ClassifyOutput>;
+//# sourceMappingURL=classify.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"classify.d.ts","sourceRoot":"","sources":["../../src/graph/classify.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAElF,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,cAAc,CAAC;CACrC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,qBAAqB,GAAG,mBAAmB,CAAC;CAC9D;AAED,MAAM,WAAW,cAAc;IAC7B,cAAc,EAAE,cAAc,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,cAAc,EAAE,eAAe,GAAG,KAAK,GAAG,WAAW,CAAC;IACtD,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE;QACR,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE;IAClC,QAAQ,EAAE,YAAY,CAAC;IACvB,UAAU,EAAE,UAAU,EAAE,CAAC;CAC1B,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAKhC,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,GAAG,UAAU,EAAE,CA2B1F;AAED,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,aAAa,EACpB,KAAK,EAAE,QAAQ,EACf,cAAc,EAAE,cAAc,EAC9B,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACnC,OAAO,CAAC,cAAc,CAAC,CA4CzB"}

package/dist/graph/enrich.d.ts

@@ -0,0 +1,10 @@
+export interface EnrichOptions {
+    force?: boolean;
+}
+export interface EnrichResult {
+    ticketId: string;
+    similarCount: number;
+    enrichedAt: string;
+}
+export declare function enrichTicket(repoRoot: string, ticketId: string, opts: EnrichOptions): Promise<EnrichResult>;
+//# sourceMappingURL=enrich.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"enrich.d.ts","sourceRoot":"","sources":["../../src/graph/enrich.ts"],"names":[],"mappings":"AAqBA,MAAM,WAAW,aAAa;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAkBD,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,YAAY,CAAC,CAmDvB"}

package/dist/graph/index.d.ts

@@ -1,7 +1,12 @@
+export type { CandidateEvidence, ClassifyEvidence, ClassifyInput, ClassifyOutput, DecideOutdated, OutdatedDecision, } from './classify';
+export { enhanceClassification, findCandidateTickets, } from './classify';
 export type { CostSummary, LlmCallLog } from './cost';
 export { logLlmCall, summarizeCost } from './cost';
+export type { EnrichOptions, EnrichResult } from './enrich';
+export { enrichTicket } from './enrich';
 export { currentYyyyMm, graphPaths } from './paths';
 export { EventSchema, safeParseEvent } from './schema';
+export { buildSimilarityPrompt } from './similarity';
 export { appendEvents, computeEventsHash, deriveSnapshot, isSnapshotStale, loadAllEvents, loadSnapshot, writeSnapshot, } from './store';
 export * from './types';
 export { ulid } from './ulid';

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,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACvD,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,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"}

package/dist/graph/schema.d.ts

@@ -108,6 +108,7 @@ export declare const EventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             SELECTOR_DRIFT: "SELECTOR_DRIFT";
             FLAKY: "FLAKY";
             TEST_BUG: "TEST_BUG";
+            TEST_OUTDATED: "TEST_OUTDATED";
         }>;
         confidence: z.ZodEnum<{
             low: "low";
@@ -130,6 +131,7 @@ export declare const EventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             SELECTOR_DRIFT: "SELECTOR_DRIFT";
             FLAKY: "FLAKY";
             TEST_BUG: "TEST_BUG";
+            TEST_OUTDATED: "TEST_OUTDATED";
         }>;
         disputedTo: z.ZodEnum<{
             PASS: "PASS";
@@ -137,6 +139,7 @@ export declare const EventSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
             SELECTOR_DRIFT: "SELECTOR_DRIFT";
             FLAKY: "FLAKY";
             TEST_BUG: "TEST_BUG";
+            TEST_OUTDATED: "TEST_OUTDATED";
         }>;
         qaActor: z.ZodString;
         qaReason: z.ZodOptional<z.ZodString>;

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

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/graph/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AA+GrC,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BActB,CAAC;AAEH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,OAAO,GACb;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,KAAK,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAA;CAAE,CAIxE"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/graph/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAsHrC,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BActB,CAAC;AAEH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,OAAO,GACb;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,KAAK,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAA;CAAE,CAIxE"}

package/dist/graph/similarity.d.ts

@@ -0,0 +1,3 @@
+import type { TicketNode } from './types';
+export declare function buildSimilarityPrompt(target: TicketNode, candidates: TicketNode[]): string;
+//# sourceMappingURL=similarity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"similarity.d.ts","sourceRoot":"","sources":["../../src/graph/similarity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAI1C,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,MAAM,CAsC1F"}

package/dist/graph/types.d.ts

@@ -2,7 +2,7 @@ export declare const SCHEMA_VERSION: 1;
 export type Priority = 'p0' | 'p1' | 'p2';
 export type ScenarioStatus = 'pass' | 'fail';
 export type EdgeKind = 'tests' | 'uses' | 'covers' | 'modifies' | 'jira-linked' | 'similar' | 'ran';
-export type Classification = 'REAL_BUG' | 'TEST_BUG' | 'SELECTOR_DRIFT' | 'FLAKY' | 'PASS';
+export type Classification = 'REAL_BUG' | 'TEST_BUG' | 'SELECTOR_DRIFT' | 'FLAKY' | 'PASS' | 'TEST_OUTDATED';
 export interface TicketFetchedPayload {
     ticketId: string;
     summary: string;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/graph/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/graph/types.ts"],"names":[],"mappings":"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"}

package/dist/src/index.js

@@ -107,7 +107,14 @@ function generateRunId(now = new Date) {
 import { existsSync as existsSync3, mkdirSync as mkdirSync2, readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "fs";
 import { dirname as dirname2 } from "path";
 import { z as z2 } from "zod";
-var ClassificationEnum = z2.enum(["PASS", "REAL_BUG", "SELECTOR_DRIFT", "FLAKY", "TEST_BUG"]);
+var ClassificationEnum = z2.enum([
+  "PASS",
+  "REAL_BUG",
+  "SELECTOR_DRIFT",
+  "FLAKY",
+  "TEST_BUG",
+  "TEST_OUTDATED"
+]);
 var ResultEnum = z2.enum(["PASS", "FAIL"]);
 var ConfidenceEnum = z2.enum(["low", "medium", "high"]);
 var HistoryEntrySchema = z2.object({

package/package.json

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

package/src/artifact/status.ts

@@ -2,7 +2,14 @@ import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { dirname } from 'node:path';
 import { z } from 'zod';
 
-const ClassificationEnum = z.enum(['PASS', 'REAL_BUG', 'SELECTOR_DRIFT', 'FLAKY', 'TEST_BUG']);
+const ClassificationEnum = z.enum([
+  'PASS',
+  'REAL_BUG',
+  'SELECTOR_DRIFT',
+  'FLAKY',
+  'TEST_BUG',
+  'TEST_OUTDATED',
+]);
 const ResultEnum = z.enum(['PASS', 'FAIL']);
 const ConfidenceEnum = z.enum(['low', 'medium', 'high']);
 

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

@@ -0,0 +1,28 @@
+import { enrichTicket } from '../graph/enrich';
+
+export async function graphEnrichCmd(argv: string[]): Promise<number> {
+  let ticket: string | undefined;
+  let force = false;
+  for (let i = 0; i < argv.length; i++) {
+    if (argv[i] === '--ticket') ticket = argv[++i];
+    else if (argv[i] === '--force') force = true;
+  }
+
+  const repoRoot = process.cwd();
+
+  if (!ticket) {
+    console.error('[graph-enrich] usage: graph-enrich --ticket <id> [--force]');
+    return 1;
+  }
+
+  try {
+    const result = await enrichTicket(repoRoot, ticket, { force });
+    console.log(
+      `[graph-enrich] ${ticket} enriched (${result.similarCount} similar edges, at ${result.enrichedAt})`,
+    );
+    return 0;
+  } catch (e) {
+    console.error(`[graph-enrich] ${ticket} failed: ${(e as Error).message}`);
+    return 1;
+  }
+}

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

@@ -4,6 +4,8 @@ import { basename, join } from 'node:path';
 import { parse as parseYaml } from 'yaml';
 import { appendEvents } from '../graph/store';
 import type {
+  Classification,
+  ClassificationDisputedPayload,
   EdgeDiscoveredPayload,
   Event,
   PomPromotedPayload,
@@ -192,7 +194,9 @@ function parseFlags(args: string[]): Map<string, string> {
 export async function graphRecordCmd(argv: string[]): Promise<number> {
   const [action, ...rest] = argv;
   if (!action) {
-    console.error(`Usage: xera-internal graph-record <fetch|script|exec|classify|promote> [args]`);
+    console.error(
+      `Usage: xera-internal graph-record <fetch|script|exec|classify|promote|dispute> [args]`,
+    );
     return 1;
   }
   const repoRoot = process.cwd();
@@ -236,6 +240,46 @@ export async function graphRecordCmd(argv: string[]): Promise<number> {
     case 'promote': {
       return recordPromote(repoRoot, parseFlags(rest));
     }
+    case 'dispute': {
+      const flags = parseFlags(rest);
+      const runId = flags.get('--run-id');
+      const scenarioIdArg = flags.get('--scenario-id');
+      const from = flags.get('--from');
+      const to = flags.get('--to');
+      const actor = flags.get('--actor');
+      const reason = flags.get('--reason');
+      if (!runId || !scenarioIdArg || !from || !to || !actor) {
+        console.error(
+          '[graph-record dispute] required: --run-id --scenario-id --from --to --actor [--reason]',
+        );
+        return 1;
+      }
+      const validClass = [
+        'REAL_BUG',
+        'TEST_BUG',
+        'SELECTOR_DRIFT',
+        'FLAKY',
+        'PASS',
+        'TEST_OUTDATED',
+      ];
+      if (!validClass.includes(from) || !validClass.includes(to)) {
+        console.error(
+          `[graph-record dispute] --from and --to must be one of: ${validClass.join(', ')}`,
+        );
+        return 1;
+      }
+      const payload: ClassificationDisputedPayload = {
+        runId,
+        scenarioId: scenarioIdArg,
+        originalClassification: from as Classification,
+        disputedTo: to as Classification,
+        qaActor: actor,
+      };
+      if (reason) payload.qaReason = reason;
+      const e = makeEvent('xera-report', 'classification.disputed', payload);
+      appendEvents(repoRoot, [e], { skill: 'xera-report', ticketId: scenarioIdArg.slice(0, 12) });
+      return 0;
+    }
     default:
       console.error(`Unknown action: ${action}`);
       return 1;

package/src/bin-internal/index.ts

@@ -5,6 +5,7 @@ import { evalReportCmd } from './eval-report';
 import { execCmd } from './exec';
 import { fetchCmd } from './fetch';
 import { graphBackfillCmd } from './graph-backfill';
+import { graphEnrichCmd } from './graph-enrich';
 import { graphQueryCmd } from './graph-query';
 import { graphRecordCmd } from './graph-record';
 import { graphSnapshotCmd } from './graph-snapshot';
@@ -28,6 +29,7 @@ const COMMANDS: Record<string, (argv: string[]) => Promise<number>> = {
   exec: execCmd,
   fetch: fetchCmd,
   'graph-backfill': graphBackfillCmd,
+  'graph-enrich': graphEnrichCmd,
   'graph-query': graphQueryCmd,
   'graph-record': graphRecordCmd,
   'graph-snapshot': graphSnapshotCmd,

package/src/bin-internal/report.ts

@@ -1,8 +1,11 @@
-import { readFileSync, writeFileSync } from 'node:fs';
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { resolveArtifactPaths } from '../artifact/paths';
 import { aggregateScenarios } from '../classifier/aggregate';
 import type { ScenarioClassification } from '../classifier/types';
+import type { OutdatedDecision } from '../graph/classify';
+import { enhanceClassification } from '../graph/classify';
+import { deriveSnapshot, loadAllEvents } from '../graph/store';
 import { buildJiraComment } from '../reporter/jira-comment';
 import { writeStatusFromClassification } from '../reporter/status-writer';
 
@@ -23,20 +26,75 @@ export async function reportCmd(argv: string[]): Promise<number> {
   const input = JSON.parse(readFileSync(inputArg.slice('--input='.length), 'utf8')) as ReportInput;
 
   const aggregated = aggregateScenarios(input.scenarios);
+
+  // v0.6.1: TEST_OUTDATED enhancement.
+  // The /xera-report skill writes outdated-decisions.json BEFORE invoking this subcommand,
+  // containing { [scenarioId]: { classification, confidence, evidence } } for every
+  // failing scenario the skill ran the LLM on. We use those decisions directly via
+  // an injected resolver — no Claude call here.
+  const decisionsPath = join(paths.ticketDir, 'runs', input.runId, 'outdated-decisions.json');
+  const decisions: Record<string, OutdatedDecision> = existsSync(decisionsPath)
+    ? (JSON.parse(readFileSync(decisionsPath, 'utf8')) as Record<string, OutdatedDecision>)
+    : {};
+
+  const graph = deriveSnapshot(loadAllEvents(process.cwd()));
+
+  // Build a lookup: normalized name → scenarioId (graph node id) for this ticket.
+  // This mirrors how graph-record-script.ts stores scenarios using sha1(ticket:name),
+  // but here we look up by the stored node id so both sha1-keyed and stub-keyed graphs work.
+  const normalizeScenarioName = (name: string) => name.trim().toLowerCase().replace(/\s+/g, ' ');
+
+  const scenarioIdByName: Record<string, string> = {};
+  for (const [id, node] of Object.entries(graph.scenarios)) {
+    if (node.ticketId === ticket) {
+      scenarioIdByName[normalizeScenarioName(node.name)] = id;
+    }
+  }
+
+  const enhancedScenarios: ScenarioClassification[] = await Promise.all(
+    aggregated.scenarios.map(async (s) => {
+      if (s.outcome !== 'FAIL') return s;
+      const scenarioId = scenarioIdByName[normalizeScenarioName(s.name)];
+      if (!scenarioId) return s;
+      const decision = decisions[scenarioId];
+      const decideOutdated = async (): Promise<OutdatedDecision> =>
+        decision ?? {
+          classification: 'BUG' as const,
+          confidence: 0,
+          evidence: { reasoning: 'no LLM decision' },
+        };
+      const enhanced = await enhanceClassification(
+        { scenarioId, traceClassification: s.class },
+        graph,
+        decideOutdated,
+      );
+      if (enhanced.classification !== s.class) {
+        return {
+          ...s,
+          class: enhanced.classification,
+          rationale: `${s.rationale} | TEST_OUTDATED override (conf ${enhanced.confidence})`,
+        };
+      }
+      return s;
+    }),
+  );
+
+  const reAggregated = aggregateScenarios(enhancedScenarios);
+
   const ts = new Date().toISOString();
   writeStatusFromClassification(paths.statusPath, {
     ticket,
     runTs: ts,
-    classification: aggregated,
+    classification: reAggregated,
     scenarioCounts: input.scenarioCounts,
   });
 
   const md = buildJiraComment({
     ticket,
     runId: input.runId,
-    overall: aggregated.overall,
-    overallConfidence: aggregated.overallConfidence,
-    scenarios: aggregated.scenarios,
+    overall: reAggregated.overall,
+    overallConfidence: reAggregated.overallConfidence,
+    scenarios: reAggregated.scenarios,
     xeraVersion: '0.1.0',
     promptsVersion: '1.0.0',
   });

package/src/bin-internal/verify-prompts.ts

@@ -11,6 +11,8 @@ const IN_SCOPE_PROMPTS = [
   'script-from-feature.md',
   'heal-locator.md',
   'extract-areas.md',
+  'similarity-match.md',
+  'classify-outdated.md',
 ] as const;
 
 const REQUIRED_SECTION_HEADING = '## Handling untrusted input';

package/src/classifier/aggregate.ts

@@ -2,6 +2,7 @@ import type { ClassifyOutput, Confidence, ScenarioClassification } from './types
 
 const CLASS_PRIORITY: Array<ClassifyOutput['overall']> = [
   'REAL_BUG',
+  'TEST_OUTDATED',
   'TEST_BUG',
   'SELECTOR_DRIFT',
   'FLAKY',

package/src/graph/classify.ts

@@ -0,0 +1,126 @@
+import type { Classification, ScenarioNode, Snapshot, TicketNode } from './types';
+
+export interface ClassifyInput {
+  scenarioId: string;
+  traceClassification: Classification;
+}
+
+export interface CandidateEvidence {
+  ticketId: string;
+  summary: string;
+  modifiedArea: string;
+  relevantAcRef?: string;
+}
+
+export interface ClassifyEvidence {
+  candidateTickets?: CandidateEvidence[];
+  reasoning?: string;
+  expectedByTest?: string;
+  actualInApp?: string;
+  proposedAction?: 'regenerate-scenario' | 'review-and-decide';
+}
+
+export interface ClassifyOutput {
+  classification: Classification;
+  confidence: number;
+  evidence?: ClassifyEvidence;
+}
+
+export interface OutdatedDecision {
+  classification: 'TEST_OUTDATED' | 'BUG' | 'AMBIGUOUS';
+  confidence: number;
+  evidence: {
+    reasoning: string;
+    expectedByTest?: string;
+    actualInApp?: string;
+    relevantAcRef?: string;
+  };
+}
+
+export type DecideOutdated = (args: {
+  scenario: ScenarioNode;
+  candidates: TicketNode[];
+}) => Promise<OutdatedDecision>;
+
+const DEFAULT_THRESHOLD = 0.7;
+const SHORT_CIRCUIT: Classification[] = ['FLAKY', 'PASS'];
+
+export function findCandidateTickets(graph: Snapshot, scenario: ScenarioNode): TicketNode[] {
+  const poms = graph.edges
+    .filter((e) => e.kind === 'uses' && e.from === scenario.id)
+    .map((e) => e.to);
+  if (poms.length === 0) return [];
+
+  const areas = graph.edges
+    .filter((e) => e.kind === 'covers' && poms.includes(e.from))
+    .map((e) => e.to);
+  if (areas.length === 0) return [];
+
+  const ticketIds = graph.edges
+    .filter((e) => e.kind === 'modifies' && areas.includes(e.to))
+    .map((e) => e.from);
+
+  const seen = new Set<string>();
+  const out: TicketNode[] = [];
+  for (const id of ticketIds) {
+    if (seen.has(id)) continue;
+    seen.add(id);
+    if (id === scenario.ticketId) continue;
+    const t = graph.tickets[id];
+    if (!t) continue;
+    if (t.fetchedAt <= scenario.generatedAt) continue;
+    out.push(t);
+  }
+  return out;
+}
+
+export async function enhanceClassification(
+  input: ClassifyInput,
+  graph: Snapshot,
+  decideOutdated: DecideOutdated,
+  options: { threshold?: number } = {},
+): Promise<ClassifyOutput> {
+  const threshold = options.threshold ?? DEFAULT_THRESHOLD;
+  if (SHORT_CIRCUIT.includes(input.traceClassification)) {
+    return { classification: input.traceClassification, confidence: 1 };
+  }
+
+  const scenario = graph.scenarios[input.scenarioId];
+  if (!scenario) return { classification: input.traceClassification, confidence: 1 };
+
+  const candidates = findCandidateTickets(graph, scenario);
+  if (candidates.length === 0) {
+    return { classification: input.traceClassification, confidence: 1 };
+  }
+
+  const candidateEvidence: CandidateEvidence[] = candidates.map((t) => {
+    const area = graph.edges.find((e) => e.kind === 'modifies' && e.from === t.id)?.to ?? '';
+    const ev: CandidateEvidence = { ticketId: t.id, summary: t.summary, modifiedArea: area };
+    if (t.ac[0]) ev.relevantAcRef = t.ac[0];
+    return ev;
+  });
+
+  const decision = await decideOutdated({ scenario, candidates });
+
+  if (decision.classification === 'TEST_OUTDATED' && decision.confidence >= threshold) {
+    const evidence: ClassifyEvidence = {
+      candidateTickets: candidateEvidence,
+      reasoning: decision.evidence.reasoning,
+      proposedAction: 'regenerate-scenario',
+    };
+    if (decision.evidence.expectedByTest)
+      evidence.expectedByTest = decision.evidence.expectedByTest;
+    if (decision.evidence.actualInApp) evidence.actualInApp = decision.evidence.actualInApp;
+    return {
+      classification: 'TEST_OUTDATED',
+      confidence: decision.confidence,
+      evidence,
+    };
+  }
+
+  return {
+    classification: input.traceClassification,
+    confidence: 1,
+    evidence: { candidateTickets: candidateEvidence },
+  };
+}