sela-core 1.0.6 → 1.0.7

package/dist/services/ASTSourceUpdater.js

@@ -37,6 +37,9 @@ exports.ASTSourceUpdater = void 0;
 const path = __importStar(require("path"));
 const fs = __importStar(require("fs"));
 const ts_morph_1 = require("ts-morph");
+const DryRunGuard_1 = require("../config/DryRunGuard");
+const WorkspaceSnapshotService_1 = require("./WorkspaceSnapshotService");
+const SelaError_1 = require("../errors/SelaError");
 const HealingRegistry_1 = require("../engine/HealingRegistry");
 const ArgumentTypeAnalyzer_1 = require("./ArgumentTypeAnalyzer");
 const BlastRadiusAnalyzer_1 = require("./BlastRadiusAnalyzer");
@@ -723,6 +726,33 @@ function resolveVariableToSegments(sourceFile, varName, beforeLine, depth = 0) {
     };
 }
 // ═══════════════════════════════════════════════════════════════════
+// SHARED PERSISTENCE HOOK
+//
+// Module-level write gate shared between `ASTSourceUpdater` and the
+// internal `NodeTransformationStrategy`. Centralises three concerns
+// every `saveSync` call site needs:
+//   1. `DryRunGuard.active()` short-circuit — keeps the mutation in
+//      memory but suppresses the on-disk write under SELA_DRY_RUN.
+//   2. `sharedWorkspaceSnapshot.preWrite()` — captures `contentBefore`
+//      so the Clean-Room ledger / Local DX rollback can rewind.
+//   3. `sharedWorkspaceSnapshot.postWrite()` — refreshes `contentAfter`
+//      so `getMutatedSnapshots()` (driving the pending-prompts ledger
+//      and the interactive CLI prompt) sees the new disk state.
+//
+// Strategies do NOT receive the persistence service via DI — they call
+// this helper directly. Same singleton, zero coupling, one code path.
+// ═══════════════════════════════════════════════════════════════════
+function persistSourceFile(sourceFile) {
+    if (DryRunGuard_1.DryRunGuard.active()) {
+        DryRunGuard_1.DryRunGuard.logSkippedWrite("saveSync", sourceFile.getFilePath());
+        return;
+    }
+    const fp = sourceFile.getFilePath();
+    WorkspaceSnapshotService_1.sharedWorkspaceSnapshot.preWrite(fp);
+    sourceFile.saveSync();
+    WorkspaceSnapshotService_1.sharedWorkspaceSnapshot.postWrite(fp);
+}
+// ═══════════════════════════════════════════════════════════════════
 // NODE TRANSFORMATION STRATEGY — Scope-Aware, Zero-Redundancy
 // ═══════════════════════════════════════════════════════════════════
 class NodeTransformationStrategy {
@@ -959,7 +989,7 @@ class NodeTransformationStrategy {
                 `  ${newCode.split("\n")[0]}`);
             try {
                 chainTop.replaceWithText(newCode);
-                sourceFile.saveSync();
+                persistSourceFile(sourceFile);
                 return {
                     success: true,
                     reason: `scope-aware transform [${effectiveReceiver}]: ${resolvedSegments.length} segments`,
@@ -1146,7 +1176,7 @@ class NodeTransformationStrategy {
         console.log(`[NodeTransform] 🔬 Partial: segment[${changedIdx}] .${currentMethodName}() → ${newCallText}`);
         try {
             targetCall.replaceWithText(newCallText);
-            sourceFile.saveSync();
+            persistSourceFile(sourceFile);
             return {
                 success: true,
                 reason: `partial: seg[${changedIdx}] .${currentMethodName}() → .${newSeg.type}()`,
@@ -1201,7 +1231,7 @@ class NodeTransformationStrategy {
             if (!ts_morph_1.Node.isStringLiteral(firstArg))
                 continue;
             firstArg.replaceWithText(`"${newSelector}"`);
-            sourceFile.saveSync();
+            persistSourceFile(sourceFile);
             return true;
         }
         return false;
@@ -1529,6 +1559,112 @@ class ASTSourceUpdater {
     flushAdvisories() {
         this.advisoryBuffer.flush();
     }
+    /**
+     * Centralised write hook for every ts-morph `saveSync` call in this class.
+     * When `SELA_DRY_RUN` is active the AST mutation stays in memory but the
+     * on-disk file is left untouched — the heal pipeline can still compute a
+     * candidate diff via `sourceFile.getFullText()` and the report layer
+     * tags the event with `dryRun: true`.
+     */
+    _persistChanges(sourceFile) {
+        persistSourceFile(sourceFile);
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // FAIL-FAST DIRECTIVE SCAN
+    //
+    // Walks the leading comment ranges of the failing statement (and the
+    // CallExpression node when it differs) looking for the directive
+    // `// sela-fail-fast`.  When found, throws `SelaError(ASTUpdater,
+    // AST_HEAL_DISABLED_BY_DIRECTIVE)` so SelaEngine can short-circuit
+    // BEFORE the LLM call and record a FailedEvent in the "Skipped by
+    // Developer" category.
+    //
+    // Implementation note — ts-morph's `Node.getLeadingCommentRanges()`
+    // returns `ts.CommentRange[]` (offsets, not text). We slice the full
+    // source text by `(pos, end)` to recover the raw comment for each
+    // range, matching both `//` line comments and `/* */` block comments
+    // with either `sela-fail-fast` or `@sela-fail-fast` spelling.
+    // ─────────────────────────────────────────────────────────────────
+    scanFailFastDirective(caller) {
+        const filePath = this.resolveFilePath(caller.filePath);
+        if (!filePath)
+            return { failFast: false };
+        let sourceFile = this.project.getSourceFile(filePath);
+        if (sourceFile) {
+            sourceFile.refreshFromFileSystemSync();
+        }
+        else {
+            sourceFile = this.project.addSourceFileAtPath(filePath);
+        }
+        if (caller.line <= 0)
+            return { failFast: false };
+        const failureNode = this.findNodeAtLine(sourceFile, caller.line);
+        if (!failureNode)
+            return { failFast: false };
+        const statement = this.getEnclosingStatement(failureNode);
+        // Collect candidate comment-owning nodes: enclosing statement (catches
+        // pre-statement comments) AND the failure node itself (catches inline
+        // pre-CallExpression comments inside multi-line chains). De-dup by
+        // offset to avoid double-matching.
+        const fullText = sourceFile.getFullText();
+        const seen = new Set();
+        const nodes = [];
+        if (statement)
+            nodes.push(statement);
+        if (failureNode !== statement)
+            nodes.push(failureNode);
+        const DIRECTIVE_RE = /\/[\/*]\s*@?sela-fail-fast\b/i;
+        for (const node of nodes) {
+            let ranges = [];
+            try {
+                ranges = node.getLeadingCommentRanges() ?? [];
+            }
+            catch {
+                ranges = [];
+            }
+            for (const r of ranges) {
+                const pos = r.getPos();
+                const end = r.getEnd();
+                const key = `${pos}:${end}`;
+                if (seen.has(key))
+                    continue;
+                seen.add(key);
+                const text = fullText.slice(pos, end);
+                if (DIRECTIVE_RE.test(text)) {
+                    const lineNum = sourceFile.getLineAndColumnAtPos(pos).line;
+                    return {
+                        failFast: true,
+                        matchedComment: text.trim(),
+                        matchedLine: lineNum,
+                    };
+                }
+            }
+        }
+        return { failFast: false };
+    }
+    /**
+     * Convenience helper — runs `scanFailFastDirective` and throws the
+     * canonical SelaError when the directive is present. Used by SelaEngine
+     * as the very first gate inside `heal()`.
+     */
+    enforceFailFastDirective(caller) {
+        const result = this.scanFailFastDirective(caller);
+        if (!result.failFast)
+            return;
+        throw new SelaError_1.SelaError({
+            subsystem: "ASTUpdater",
+            code: SelaError_1.AST_UPDATER_CODES.HEAL_DISABLED_BY_DIRECTIVE,
+            reason: `Heal disabled by developer directive at ${path.basename(caller.filePath)}` +
+                (result.matchedLine ? `:${result.matchedLine}` : ""),
+            context: {
+                filePath: caller.filePath,
+                line: caller.line,
+                directiveLine: result.matchedLine,
+                directiveText: result.matchedComment,
+                category: "Skipped by Developer",
+            },
+        });
+    }
     constructor() {
         this.project = new ts_morph_1.Project({
             useInMemoryFileSystem: false,
@@ -1673,6 +1809,14 @@ class ASTSourceUpdater {
         const statement = failureNode
             ? this.getEnclosingStatement(failureNode)
             : undefined;
+        // ─── Developer fail-fast directive ─────────────────────────────
+        // Scan leading comments on the enclosing statement (and the failure
+        // node when they differ) for `// sela-fail-fast`. When present, abort
+        // all heal work with SelaError(AST_HEAL_DISABLED_BY_DIRECTIVE) so the
+        // engine records a FailedEvent in the "Skipped by Developer" bucket.
+        // Defense-in-depth — SelaEngine also calls this at the very start of
+        // heal() to skip the LLM round-trip entirely.
+        this.enforceFailFastDirective(caller);
         const suspectIdentifier = statement
             ? this.identifySuspectIdentifier(statement, caller.line)
             : null;
@@ -1850,7 +1994,7 @@ class ASTSourceUpdater {
             console.log(`[ASTUpdater] 🔗 H: full replace (depth=${chainDepth}) →\n${newCode}`);
             try {
                 chainTop.replaceWithText(newCode);
-                sourceFile.saveSync();
+                this._persistChanges(sourceFile);
                 return {
                     success: true,
                     reason: `smart chain applied (${resolvedSegments.length} segments, depth=${chainDepth})`,
@@ -1914,7 +2058,7 @@ class ASTSourceUpdater {
         console.log(`[ASTUpdater] 🔗 H partial: .${currentMethodName}() → ${newCallText}`);
         try {
             targetCall.replaceWithText(newCallText);
-            sourceFile.saveSync();
+            this._persistChanges(sourceFile);
             return {
                 success: true,
                 reason: `partial chain heal: segment[${changedIdx}] .${currentMethodName}() → .${newSeg.type}()`,
@@ -1975,7 +2119,7 @@ class ASTSourceUpdater {
             const newCallText = buildCallText(rootReceiver, newSem);
             try {
                 chainTop.replaceWithText(newCallText);
-                sourceFile.saveSync();
+                this._persistChanges(sourceFile);
                 return {
                     success: true,
                     reason: `chain collapsed atomically (depth=${chainDepth})`,
@@ -2059,7 +2203,7 @@ class ASTSourceUpdater {
                     }
                 }
                 if (anyFixed) {
-                    sourceFile.saveSync();
+                    this._persistChanges(sourceFile);
                     return {
                         success: true,
                         reason: `upstream variable '${varName}' fixed`,
@@ -2070,7 +2214,7 @@ class ASTSourceUpdater {
                 for (const change of changedFrames) {
                     const result = this.replaceStringLiteralInRange(sourceFile, change.old, change.new, declLine, Math.min(sourceFile.getEndLineNumber(), declLine + 8));
                     if (result !== null) {
-                        sourceFile.saveSync();
+                        this._persistChanges(sourceFile);
                         return {
                             success: true,
                             reason: "multi-line frame fixed",
@@ -2085,7 +2229,7 @@ class ASTSourceUpdater {
             for (const change of changedFrames) {
                 const result = this.replaceStringLiteralInRange(sourceFile, change.old, change.new, Math.max(1, caller.line - 15), caller.line);
                 if (result !== null) {
-                    sourceFile.saveSync();
+                    this._persistChanges(sourceFile);
                     return {
                         success: true,
                         reason: "inline frame fixed",
@@ -2166,10 +2310,10 @@ class ASTSourceUpdater {
                     const newCallText = buildCallText(effectiveReceiver, newSem);
                     try {
                         chainTop.replaceWithText(newCallText);
-                        sourceFile.saveSync();
+                        this._persistChanges(sourceFile);
                         const cascadePairs = this.performCascadeHeal(sourceFile, oldSelector, newSelector, oldSem, newSem);
                         if (cascadePairs.length > 0) {
-                            sourceFile.saveSync();
+                            this._persistChanges(sourceFile);
                             HealingRegistry_1.HealingRegistry.getInstance().broadcastCascade({ filePath: caller.filePath, line: caller.line }, cascadePairs);
                         }
                         return {
@@ -2208,10 +2352,10 @@ class ASTSourceUpdater {
                 const { chainTop: tailChainTop, rootReceiver } = climbToChainTop(tailCall);
                 try {
                     tailChainTop.replaceWithText(buildCallText(rootReceiver, newSem));
-                    sourceFile.saveSync();
+                    this._persistChanges(sourceFile);
                     const cascadePairs = this.performCascadeHeal(sourceFile, oldSelector, newSelector, oldSem, newSem);
                     if (cascadePairs.length > 0) {
-                        sourceFile.saveSync();
+                        this._persistChanges(sourceFile);
                         HealingRegistry_1.HealingRegistry.getInstance().broadcastCascade({ filePath: caller.filePath, line: caller.line }, cascadePairs);
                     }
                     return {
@@ -2228,10 +2372,10 @@ class ASTSourceUpdater {
             }
             const fixed = this.replaceChainTailOnly(tailCall, newSem, newSelector);
             if (fixed) {
-                sourceFile.saveSync();
+                this._persistChanges(sourceFile);
                 const cascadePairs = this.performCascadeHeal(sourceFile, oldSelector, newSelector, oldSem, newSem);
                 if (cascadePairs.length > 0) {
-                    sourceFile.saveSync();
+                    this._persistChanges(sourceFile);
                     HealingRegistry_1.HealingRegistry.getInstance().broadcastCascade({ filePath: caller.filePath, line: caller.line }, cascadePairs);
                 }
                 return {
@@ -2253,7 +2397,7 @@ class ASTSourceUpdater {
             if (chainDepth > 0 || isLeafOfChain(call)) {
                 try {
                     stmtChainTop.replaceWithText(buildCallText(rootReceiver, newSem));
-                    sourceFile.saveSync();
+                    this._persistChanges(sourceFile);
                     return {
                         success: true,
                         reason: "direct statement chain collapse",
@@ -2264,10 +2408,10 @@ class ASTSourceUpdater {
                 catch { }
             }
             if (this.replaceChainTailOnly(call, newSem, newSelector)) {
-                sourceFile.saveSync();
+                this._persistChanges(sourceFile);
                 const cascadePairs = this.performCascadeHeal(sourceFile, oldSelector, newSelector, oldSem, newSem);
                 if (cascadePairs.length > 0) {
-                    sourceFile.saveSync();
+                    this._persistChanges(sourceFile);
                     HealingRegistry_1.HealingRegistry.getInstance().broadcastCascade({ filePath: caller.filePath, line: caller.line }, cascadePairs);
                 }
                 return {
@@ -2301,10 +2445,10 @@ class ASTSourceUpdater {
                 try {
                     chainTop.replaceWithText(buildCallText(rootReceiver, newSem));
                     const fixLine = chainTop.getStartLineNumber();
-                    sourceFile.saveSync();
+                    this._persistChanges(sourceFile);
                     const cascadePairs = this.performCascadeHeal(sourceFile, oldSelector, newSelector, oldSem, newSem);
                     if (cascadePairs.length > 0) {
-                        sourceFile.saveSync();
+                        this._persistChanges(sourceFile);
                         HealingRegistry_1.HealingRegistry.getInstance().broadcastCascade({ filePath: caller.filePath, line: caller.line }, cascadePairs);
                     }
                     return {
@@ -2319,10 +2463,10 @@ class ASTSourceUpdater {
             }
             if (this.applySemanticFix(call, newSem, newSelector)) {
                 const fixLine = call.getStartLineNumber();
-                sourceFile.saveSync();
+                this._persistChanges(sourceFile);
                 const cascadePairs = this.performCascadeHeal(sourceFile, oldSelector, newSelector, oldSem, newSem);
                 if (cascadePairs.length > 0) {
-                    sourceFile.saveSync();
+                    this._persistChanges(sourceFile);
                     HealingRegistry_1.HealingRegistry.getInstance().broadcastCascade({ filePath: caller.filePath, line: caller.line }, cascadePairs);
                 }
                 return {
@@ -2385,7 +2529,7 @@ class ASTSourceUpdater {
             if (newText !== fullText) {
                 tmpl.replaceWithText(newText.trim());
                 const line = tmpl.getStartLineNumber();
-                sourceFile.saveSync();
+                this._persistChanges(sourceFile);
                 return {
                     success: true,
                     reason: "template literal suffix updated",
@@ -2430,7 +2574,7 @@ class ASTSourceUpdater {
             if (chainDepth > 0 || isLeafOfChain(call)) {
                 try {
                     chainTop.replaceWithText(buildCallText(rootReceiver, newSem));
-                    sourceFile.saveSync();
+                    this._persistChanges(sourceFile);
                     return {
                         success: true,
                         reason: `fragment scan chain collapse .${callSem.method}() @ line ${call.getStartLineNumber()}`,
@@ -2441,7 +2585,7 @@ class ASTSourceUpdater {
                 catch { }
             }
             if (this.replaceChainTailOnly(call, newSem, newSelector)) {
-                sourceFile.saveSync();
+                this._persistChanges(sourceFile);
                 return {
                     success: true,
                     reason: `fragment scan fixed .${callSem.method}() @ line ${call.getStartLineNumber()}`,
@@ -2618,7 +2762,7 @@ class ASTSourceUpdater {
             const propName = firstArg.getName();
             const result = this.updateObjectProperty(sourceFile, objName, propName, oldSem.primaryArg, newSem.primaryArg);
             if (result !== null) {
-                sourceFile.saveSync();
+                this._persistChanges(sourceFile);
                 return {
                     success: true,
                     reason: `'${objName}.${propName}' updated`,
@@ -3032,7 +3176,7 @@ class ASTSourceUpdater {
         }
         const lineUpdated = node.getStartLineNumber() - 1;
         node.replaceWithText(patchResult.patchedTemplate);
-        sourceFile.saveSync();
+        this._persistChanges(sourceFile);
         if (!this.validateFileSyntax(sourceFile)) {
             return {
                 success: false,
@@ -3068,7 +3212,7 @@ class ASTSourceUpdater {
                 const result = InitializerUpdater_1.InitializerUpdater.apply(init, sourceFile, newSpanVal);
                 if (!result)
                     return null;
-                sourceFile.saveSync();
+                this._persistChanges(sourceFile);
                 return {
                     success: true,
                     reason: `span literal updated via trace`,
@@ -3132,7 +3276,7 @@ class ASTSourceUpdater {
             }
             const lineUpdated = fnAnalysis.templateNode.getStartLineNumber() - 1;
             fnAnalysis.templateNode.replaceWithText(patchResult.patchedTemplate);
-            fnAnalysis.functionFile.saveSync();
+            this._persistChanges(fnAnalysis.functionFile);
             if (!this.validateFileSyntax(fnAnalysis.functionFile)) {
                 return {
                     success: false,

package/dist/services/HealReportService.d.ts

@@ -41,6 +41,13 @@ interface HealEventBase {
 }
 export interface HealedEvent extends HealEventBase {
     kind: "HEALED";
+    /**
+     * Marks events produced during a `SELA_DRY_RUN=1` session — the in-memory
+     * heal completed (LLM call, SafetyGuard verdict, candidate diff captured)
+     * but no source file was modified and no commit was produced. Reports
+     * render these with an explicit "Dry Run · No Write" chip.
+     */
+    dryRun?: boolean;
     oldSelector: string;
     newSelector: string;
     /** First removed line from the native git diff (backward-compat fallback). */
@@ -83,6 +90,16 @@ export interface FailedEvent extends HealEventBase {
     aiConfidence?: number;
     aiExplanation?: string;
     dnaBefore: DnaSummary | null;
+    /**
+     * Base64-encoded PNG screenshot captured by `SelaReporter` from the
+     * Playwright `TestResult.attachments` slot at the moment the test
+     * failed. NEVER prefixed with `data:image/png;base64,` — the HTML
+     * renderer prepends the data URL header at render time so the JSON
+     * payload stays compact and the bytes survive Playwright's temp
+     * folder cleanup. `undefined` when no screenshot was attached
+     * (worker crash, screenshot disabled, off-attachment failure).
+     */
+    failureScreenshotPng?: string;
 }
 export interface ProtectedEvent extends HealEventBase {
     kind: "PROTECTED";
@@ -114,6 +131,31 @@ export declare class HealReportService {
     getHealedEvents(): HealedEvent[];
     /** All PROTECTED events (SafetyGuard blocks) accumulated in this session. */
     getProtectedEvents(): ProtectedEvent[];
+    /** All FAILED events accumulated in this session. */
+    getFailedEvents(): FailedEvent[];
+    /**
+     * Inject a Playwright failure screenshot (Base64 PNG, no data: prefix)
+     * onto the FAILED event(s) matching the supplied identity hints. Used
+     * by `SelaReporter` to enrich engine-emitted FAILED events with the
+     * Playwright-captured screenshot from `TestResult.attachments`.
+     *
+     * Match policy (all supplied hints must agree):
+     *   • `sourceFile` — suffix-matched both directions to absorb
+     *     project-relative vs absolute path mismatches between the engine
+     *     (relative) and Playwright TestInfo.location.file (absolute).
+     *   • `testTitle` — exact match.
+     *   • `stableId`  — exact match.
+     *
+     * Returns the number of events updated. Zero means the caller should
+     * keep the screenshot pending until the matching FailedEvent is
+     * recorded (worker-crash edge case where the heal pipeline did not
+     * run before the Reporter received the failure).
+     */
+    attachFailureScreenshot(match: {
+        sourceFile?: string;
+        testTitle?: string;
+        stableId?: string;
+    }, base64Png: string): number;
     /**
      * Write `sela-report.html` (+ `sela-report.json` debug dump) to cwd.
      * Returns the absolute path of the HTML report, or null if nothing to write.

package/dist/services/HealReportService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HealReportService.d.ts","sourceRoot":"","sources":["../../src/services/HealReportService.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACvE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAMlD,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAAC;AAE9D,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,iBAAiB,CAAC;IAC3B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,YAAY,CAAC,eAAe,CAAC,CAAC;IAC7C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,aAAa;IACrB,IAAI,EAAE,aAAa,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,WAAY,SAAQ,aAAa;IAChD,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,8EAA8E;IAC9E,WAAW,EAAE,MAAM,CAAC;IACpB,4EAA4E;IAC5E,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,UAAU,CAAC;IACtB,QAAQ,EAAE,UAAU,GAAG,IAAI,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAChD,aAAa,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CACtD;AAED,MAAM,WAAW,WAAY,SAAQ,aAAa;IAChD,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,UAAU,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,cAAe,SAAQ,aAAa;IACnD,IAAI,EAAE,WAAW,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7B,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,UAAU,GAAG,IAAI,CAAC;IAC7B,QAAQ,EAAE,UAAU,GAAG,IAAI,CAAC;IAC5B,aAAa,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CACtD;AAED,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,WAAW,GAAG,cAAc,CAAC;AAWnE,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,GAAG,UAAU,GAAG,IAAI,CAgB5F;AAMD,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,SAAS,CAAoC;IAErD,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAI9B,IAAI,IAAI,MAAM;IAId,KAAK,IAAI,IAAI;IAKb,UAAU,IAAI,OAAO;IAIrB,qDAAqD;IACrD,eAAe,IAAI,WAAW,EAAE;IAIhC,6EAA6E;IAC7E,kBAAkB,IAAI,cAAc,EAAE;IAItC;;;OAGG;IACH,WAAW,CAAC,SAAS,GAAE,MAAsB,GAAG,MAAM,GAAG,IAAI;IAyB7D,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,YAAY;CAwBrB;AAMD,eAAO,MAAM,gBAAgB,mBAA0B,CAAC"}
+{"version":3,"file":"HealReportService.d.ts","sourceRoot":"","sources":["../../src/services/HealReportService.ts"],"names":[],"mappings":"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"}

package/dist/services/HealReportService.js

@@ -96,6 +96,52 @@ class HealReportService {
     getProtectedEvents() {
         return this.events.filter((e) => e.kind === "PROTECTED");
     }
+    /** All FAILED events accumulated in this session. */
+    getFailedEvents() {
+        return this.events.filter((e) => e.kind === "FAILED");
+    }
+    /**
+     * Inject a Playwright failure screenshot (Base64 PNG, no data: prefix)
+     * onto the FAILED event(s) matching the supplied identity hints. Used
+     * by `SelaReporter` to enrich engine-emitted FAILED events with the
+     * Playwright-captured screenshot from `TestResult.attachments`.
+     *
+     * Match policy (all supplied hints must agree):
+     *   • `sourceFile` — suffix-matched both directions to absorb
+     *     project-relative vs absolute path mismatches between the engine
+     *     (relative) and Playwright TestInfo.location.file (absolute).
+     *   • `testTitle` — exact match.
+     *   • `stableId`  — exact match.
+     *
+     * Returns the number of events updated. Zero means the caller should
+     * keep the screenshot pending until the matching FailedEvent is
+     * recorded (worker-crash edge case where the heal pipeline did not
+     * run before the Reporter received the failure).
+     */
+    attachFailureScreenshot(match, base64Png) {
+        if (!base64Png)
+            return 0;
+        const norm = (p) => (p ?? "").replace(/\\/g, "/").toLowerCase();
+        const targetFile = norm(match.sourceFile);
+        let touched = 0;
+        for (const ev of this.events) {
+            if (ev.kind !== "FAILED")
+                continue;
+            const evFile = norm(ev.sourceFile);
+            const fileMatch = !targetFile ||
+                !evFile ||
+                evFile === targetFile ||
+                evFile.endsWith(targetFile) ||
+                targetFile.endsWith(evFile);
+            const titleMatch = !match.testTitle || ev.testTitle === match.testTitle;
+            const idMatch = !match.stableId || ev.stableId === match.stableId;
+            if (fileMatch && titleMatch && idMatch) {
+                ev.failureScreenshotPng = base64Png;
+                touched++;
+            }
+        }
+        return touched;
+    }
     /**
      * Write `sela-report.html` (+ `sela-report.json` debug dump) to cwd.
      * Returns the absolute path of the HTML report, or null if nothing to write.
@@ -684,6 +730,23 @@ a:hover { text-decoration: underline; }
 .tag.ghost   { color: var(--warn);    border-color: rgba(251,191,36,0.3); }
 .tag.occlude { color: var(--bad);     border-color: rgba(248,113,113,0.3); }
 
+/* Failure context — Playwright screenshot rendered inline on FAILED cards */
+.failure-img {
+  background: var(--bg-1); border: 1px solid var(--line);
+  border-radius: var(--radius-sm); padding: 8px;
+  overflow: hidden;
+}
+.failure-img img {
+  display: block; max-width: 100%; height: auto;
+  border-radius: 4px;
+  background: #000;
+  outline: 1px solid var(--line);
+}
+.failure-img .img-meta {
+  font-family: var(--mono); font-size: 11px; color: var(--text-muted);
+  padding: 6px 4px 0;
+}
+
 /* Empty state */
 .empty {
   margin-top: 32px; padding: 60px 20px; text-align: center;
@@ -1061,6 +1124,19 @@ const REPORT_JS = String.raw `
     );
   }
 
+  function renderFailureContext(ev) {
+    if (ev.kind !== "FAILED" || !ev.failureScreenshotPng) return "";
+    return (
+      '<div class="section">' +
+        '<div class="section-title"><span class="marker"></span>Failure Context · Playwright Screenshot</div>' +
+        '<div class="failure-img">' +
+          '<img src="data:image/png;base64,' + ev.failureScreenshotPng + '" alt="Playwright failure screenshot" loading="lazy" />' +
+          '<div class="img-meta">captured by SelaReporter at test failure · base64-embedded · survives Playwright temp cleanup</div>' +
+        '</div>' +
+      '</div>'
+    );
+  }
+
   function renderAlts(ev) {
     if (ev.kind !== "HEALED" || !ev.aiAlternatives || !ev.aiAlternatives.length) return "";
     return (
@@ -1150,7 +1226,10 @@ const REPORT_JS = String.raw `
       '</div>'
     );
 
-    // 5. Alternatives
+    // 5. Failure Context — Playwright screenshot (FAILED only)
+    blocks.push(renderFailureContext(ev));
+
+    // 6. Alternatives
     blocks.push(renderAlts(ev));
 
     // 6. Actions