sela-core 1.0.6 → 1.0.8

package/dist/services/IntentAuditor.js

@@ -46,15 +46,15 @@ dotenv.config();
 const FALLBACK_VERDICT = {
     verdict: "SUSPICIOUS",
     confidence: 0,
-    reason: "Auditor unavailable — defaulting to cautious SUSPICIOUS verdict",
+    reason: "Auditor unavailable - defaulting to cautious SUSPICIOUS verdict",
     inversionType: null,
 };
 // Ancestry drift penalties (spec §2.1).
 // Applied as negative adjustments to the LLM's confidence score.
 // Maximum combined penalty: −30 pts.
 const DRIFT_PENALTIES = [
-    { full: -20, partial: -10 }, // depth 1 — direct parent
-    { full: -10, partial: -5 }, // depth 2 — grandparent
+    { full: -20, partial: -10 }, // depth 1 - direct parent
+    { full: -10, partial: -5 }, // depth 2 - grandparent
 ];
 // Anchor bonuses: positive-only (spec §3.3).
 // closestLabel exact match:  +10 pts
@@ -85,8 +85,8 @@ RULES:
 3. Minor reformatting is irrelevant. "Save Changes" and "Save" are CONSISTENT.
 4. Role/aria context matters. A button that was "Submit" becoming "Cancel" is INCONSISTENT (identity inversion).
 5. When both texts are very short (3 chars or less) and differ, prefer SUSPICIOUS unless an obvious opposite pair.
-6. In "assertion" mode, be stricter — lean toward SUSPICIOUS or INCONSISTENT when the change is ambiguous.
-7. In "action" mode, be more lenient — lean toward CONSISTENT when the change looks like a UI refactor.
+6. In "assertion" mode, be stricter - lean toward SUSPICIOUS or INCONSISTENT when the change is ambiguous.
+7. In "action" mode, be more lenient - lean toward CONSISTENT when the change looks like a UI refactor.
 
 RESPONSE FORMAT (strict JSON, no other text):
 {
@@ -95,16 +95,29 @@ RESPONSE FORMAT (strict JSON, no other text):
   "reason": "<one sentence explaining the verdict>",
   "inversionType": "polarity" | "quantitative" | "state" | "identity" | null
 }`;
-// ═══════════════════════════════════════════════════════════════════
-// IntentAuditor
-// ═══════════════════════════════════════════════════════════════════
+const DEFAULT_AUDITOR_MODEL = "claude-haiku-4-5-20251001";
 class IntentAuditor {
     anthropic;
     disabled;
-    constructor() {
-        const apiKey = process.env.ANTHROPIC_API_KEY;
+    model;
+    constructor(opts = {}) {
+        this.model = opts.model ?? DEFAULT_AUDITOR_MODEL;
+        // Explicit `null` from the caller forces disabled mode - used by tests.
+        if (opts.anthropic === null) {
+            this.anthropic = null;
+            this.disabled = true;
+            return;
+        }
+        // Caller supplied a ready-to-use client → use it as-is.
+        if (opts.anthropic !== undefined) {
+            this.anthropic = opts.anthropic;
+            this.disabled = false;
+            return;
+        }
+        // Otherwise fall back to env-based construction (legacy default).
+        const apiKey = opts.apiKey ?? process.env.ANTHROPIC_API_KEY;
         if (!apiKey) {
-            console.warn("[IntentAuditor] ANTHROPIC_API_KEY not set — auditor disabled, will return SUSPICIOUS for all audited heals");
+            console.warn("[IntentAuditor] ANTHROPIC_API_KEY not set - auditor disabled, will return SUSPICIOUS for all audited heals");
             this.anthropic = null;
             this.disabled = true;
         }
@@ -128,7 +141,7 @@ class IntentAuditor {
             .join("\n");
         try {
             const response = await this.anthropic.messages.create({
-                model: "claude-haiku-4-5-20251001",
+                model: this.model,
                 max_tokens: 256,
                 temperature: 0.1,
                 system: SYSTEM_PROMPT,
@@ -141,7 +154,7 @@ class IntentAuditor {
             // ── Structural scoring ────────────────────────────────────────
             // Apply ancestry drift penalty and anchor bonus to the LLM's raw
             // confidence.  The semantic verdict category (CONSISTENT / SUSPICIOUS /
-            // INCONSISTENT) is never changed by scoring — only the confidence value.
+            // INCONSISTENT) is never changed by scoring - only the confidence value.
             // The low-confidence CONSISTENT→SUSPICIOUS downgrade is re-evaluated
             // after scoring so the adjusted value is used for the threshold.
             const penalty = this.computeAncestryPenalty(req.dnaAncestry ?? [], req.liveAncestry ?? []);
@@ -159,7 +172,11 @@ class IntentAuditor {
                 // Re-apply low-confidence CONSISTENT downgrade with the adjusted value.
                 // The raw check in parseVerdict used the pre-adjustment confidence; a
                 // penalty may push a borderline CONSISTENT below the 50% threshold.
-                const scoring = { rawConfidence: rawVerdict.confidence, penalty, bonus };
+                const scoring = {
+                    rawConfidence: rawVerdict.confidence,
+                    penalty,
+                    bonus,
+                };
                 if (rawVerdict.verdict === "CONSISTENT" && adjConf < 50) {
                     finalVerdict = {
                         verdict: "SUSPICIOUS",
@@ -171,22 +188,29 @@ class IntentAuditor {
                     console.log(`[IntentAuditor] CONSISTENT→SUSPICIOUS after scoring (${rawVerdict.confidence}%→${adjConf}%)`);
                 }
                 else {
-                    finalVerdict = { ...rawVerdict, confidence: adjConf, scoreBreakdown: scoring };
+                    finalVerdict = {
+                        ...rawVerdict,
+                        confidence: adjConf,
+                        scoreBreakdown: scoring,
+                    };
                 }
             }
             else {
                 finalVerdict = rawVerdict;
             }
-            console.log(`[IntentAuditor] verdict=${finalVerdict.verdict} (${finalVerdict.confidence}%) — ${finalVerdict.reason}`);
+            console.log(`[IntentAuditor] verdict=${finalVerdict.verdict} (${finalVerdict.confidence}%) - ${finalVerdict.reason}`);
             return finalVerdict;
         }
         catch (err) {
-            console.warn(`[IntentAuditor] Warning: Auditor call failed: ${err.message} — returning SUSPICIOUS`);
-            return { ...FALLBACK_VERDICT, reason: `Auditor call failed: ${err.message}` };
+            console.warn(`[IntentAuditor] Warning: Auditor call failed: ${err.message} - returning SUSPICIOUS`);
+            return {
+                ...FALLBACK_VERDICT,
+                reason: `Auditor call failed: ${err.message}`,
+            };
         }
     }
     // ─────────────────────────────────────────────────────────────
-    // computeAncestryPenalty — DNA v2 Ancestry Drift  (spec §2)
+    // computeAncestryPenalty - DNA v2 Ancestry Drift  (spec §2)
     //
     // Compares at most 2 ancestor depths between the DNA baseline and
     // the live candidate.  Returns a value in [−30, 0]; 0 = no drift.
@@ -203,7 +227,7 @@ class IntentAuditor {
     // ─────────────────────────────────────────────────────────────
     computeAncestryPenalty(dnaPath, livePath) {
         if (dnaPath.length === 0)
-            return 0; // v1 migrated snapshot — skip
+            return 0; // v1 migrated snapshot - skip
         let totalPenalty = 0;
         const maxDepth = Math.min(dnaPath.length, livePath.length, 2);
         for (let i = 0; i < maxDepth; i++) {
@@ -216,21 +240,21 @@ class IntentAuditor {
             const depthLabel = i === 0 ? "depth-1 (parent)" : "depth-2 (grandparent)";
             if (dna.tag !== live.tag) {
                 totalPenalty += full;
-                console.log(`[IntentAuditor] 🏗️  Ancestry drift ${full} pts — ${depthLabel}: ` +
+                console.log(`[IntentAuditor] 🏗️  Ancestry drift ${full} pts - ${depthLabel}: ` +
                     `tag mismatch (${dna.fingerprint} → ${live.fingerprint})`);
             }
             else {
                 totalPenalty += partial;
-                console.log(`[IntentAuditor] 🏗️  Ancestry drift ${partial} pts — ${depthLabel}: ` +
+                console.log(`[IntentAuditor] 🏗️  Ancestry drift ${partial} pts - ${depthLabel}: ` +
                     `same tag, id/class changed (${dna.fingerprint} → ${live.fingerprint})`);
             }
         }
         return totalPenalty;
     }
     // ─────────────────────────────────────────────────────────────
-    // computeAnchorBonus — DNA v2 Anchor Confirmation  (spec §3.3)
+    // computeAnchorBonus - DNA v2 Anchor Confirmation  (spec §3.3)
     //
-    // Anchors only provide positive confirmation — no penalty for
+    // Anchors only provide positive confirmation - no penalty for
     // mismatch.  Returns a value in [0, +15].
     //
     // closestLabel exact match (case-insensitive):  +10 pts
@@ -244,13 +268,13 @@ class IntentAuditor {
         const liveLabel = liveAnchors.closestLabel?.toLowerCase().trim();
         if (dnaLabel && liveLabel && dnaLabel === liveLabel) {
             bonus += ANCHOR_BONUS_LABEL;
-            console.log(`[IntentAuditor] 🎯 Anchor +${ANCHOR_BONUS_LABEL} pts — closestLabel match: "${dnaAnchors.closestLabel}"`);
+            console.log(`[IntentAuditor] 🎯 Anchor +${ANCHOR_BONUS_LABEL} pts - closestLabel match: "${dnaAnchors.closestLabel}"`);
         }
         const dnaRow = dnaAnchors.rowAnchor?.toLowerCase().trim();
         const liveRow = liveAnchors.rowAnchor?.toLowerCase().trim();
         if (dnaRow && liveRow && dnaRow === liveRow) {
             bonus += ANCHOR_BONUS_ROW;
-            console.log(`[IntentAuditor] 🎯 Anchor +${ANCHOR_BONUS_ROW} pts — rowAnchor match: "${dnaAnchors.rowAnchor}"`);
+            console.log(`[IntentAuditor] 🎯 Anchor +${ANCHOR_BONUS_ROW} pts - rowAnchor match: "${dnaAnchors.rowAnchor}"`);
         }
         return bonus;
     }

package/dist/services/InteractiveReview.d.ts

@@ -0,0 +1,15 @@
+import type { PendingPromptEntry } from "./PendingPromptLedger";
+export interface PrintReviewDeps {
+    entries: PendingPromptEntry[];
+    /** Override the console sink - tests capture output for assertions. */
+    log?: (msg: string) => void;
+    /** Absolute path of the rendered Sela Insights HTML report, when present. */
+    reportHtmlPath?: string | null;
+}
+/**
+ * Print the post-run review summary. Returns immediately - never blocks
+ * on stdin. Safe to call from the reporter's onEnd() in any environment
+ * (TTY, piped CI, IDE-integrated runner).
+ */
+export declare function printHealReview(deps: PrintReviewDeps): void;
+//# sourceMappingURL=InteractiveReview.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"InteractiveReview.d.ts","sourceRoot":"","sources":["../../src/services/InteractiveReview.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,uEAAuE;IACvE,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,6EAA6E;IAC7E,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CA0B3D"}

package/dist/services/InteractiveReview.js

@@ -0,0 +1,125 @@
+"use strict";
+// src/services/InteractiveReview.ts
+//
+// Local DX - Post-run summary printer (MVP write-and-notify).
+//
+// The MVP flow is write-on-disk-then-notify: workers (and the engine)
+// already mutated the source files in-place during execution. The
+// reporter calls printHealReview() at the end purely to display:
+//   • a banner with the number of mutated files,
+//   • per-file isolated unified diff (clean room - never the working tree),
+//   • a vscode://file deeplink to the mutated line,
+//   • an optional deeplink to the generated HTML insights report.
+//
+// No prompts. No rollback. No blocking on stdin. SIGINT handling lives
+// in SelaReporter - this module is pure stdout/stderr.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.printHealReview = printHealReview;
+const path = __importStar(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+const IsolatedDiff_1 = require("../utils/IsolatedDiff");
+/**
+ * Print the post-run review summary. Returns immediately - never blocks
+ * on stdin. Safe to call from the reporter's onEnd() in any environment
+ * (TTY, piped CI, IDE-integrated runner).
+ */
+function printHealReview(deps) {
+    const log = deps.log ?? ((m) => process.stdout.write(m + "\n"));
+    const entries = deps.entries ?? [];
+    const reportHtmlPath = deps.reportHtmlPath ?? null;
+    if (entries.length === 0 && !reportHtmlPath)
+        return;
+    log("");
+    if (entries.length > 0) {
+        log(chalk_1.default.bold.bgCyan.black(` [Sela] Local DX Review - ${entries.length} fix${entries.length === 1 ? "" : "es"} applied to disk `));
+        for (const entry of entries) {
+            renderEntry(entry, log);
+        }
+    }
+    if (reportHtmlPath) {
+        log("");
+        log(chalk_1.default.bold(`[Sela] 📄 Insights report:`));
+        log(`   ${chalk_1.default.cyan(buildFileLink(reportHtmlPath))}`);
+    }
+    log("");
+}
+function renderEntry(entry, log) {
+    const fileName = path.basename(entry.absolutePath);
+    const diff = (0, IsolatedDiff_1.generateUnifiedDiff)(entry.contentBefore, entry.contentAfter, {
+        filePath: entry.relativePath,
+    });
+    log("");
+    log(chalk_1.default.bold(`[Sela] 🔧 Healed selector in ${fileName}`));
+    log("");
+    log(colorizeDiff(diff));
+    log("");
+    log(`👉 Open in VS Code:`);
+    log(`   ${chalk_1.default.cyan(buildVsCodeLink(entry.absolutePath, entry.lineNumber))}`);
+}
+function colorizeDiff(diff) {
+    if (!diff)
+        return chalk_1.default.dim("(no diff)");
+    return diff
+        .split("\n")
+        .map((row) => {
+        if (row.startsWith("+++") ||
+            row.startsWith("---") ||
+            row.startsWith("diff --git")) {
+            return chalk_1.default.bold(row);
+        }
+        if (row.startsWith("@@"))
+            return chalk_1.default.cyan(row);
+        if (row.startsWith("+"))
+            return chalk_1.default.green(row);
+        if (row.startsWith("-"))
+            return chalk_1.default.red(row);
+        return row;
+    })
+        .join("\n");
+}
+function buildVsCodeLink(absPath, line) {
+    const normalised = absPath.split(path.sep).join("/");
+    return line && line > 0
+        ? `vscode://file/${normalised}:${line}`
+        : `vscode://file/${normalised}`;
+}
+function buildFileLink(absPath) {
+    const normalised = absPath.split(path.sep).join("/");
+    return `file://${normalised}`;
+}

package/dist/services/LLMService.d.ts

@@ -1,3 +1,4 @@
+import Anthropic from "@anthropic-ai/sdk";
 import { FixRequest } from "../types";
 export interface SelectorSegment {
     type: "frame" | "element";
@@ -78,7 +79,7 @@ export interface FixResponse {
     originalChainHint?: SmartChainSegment[];
     /**
      * Confidence score 0-100. Undefined when the model omitted it or returned a
-     * non-finite value — downstream code must treat undefined as "unknown" and
+     * non-finite value - downstream code must treat undefined as "unknown" and
      * render "n/a" rather than synthesising a 0.
      */
     confidence?: number;
@@ -86,9 +87,24 @@ export interface FixResponse {
     new_selector?: string | null;
     contentChange?: ContentChange;
 }
+/**
+ * Constructor options for LLMService.
+ *
+ * - `anthropic`: pre-built Anthropic client. Tests use this to inject a
+ *   mock client without touching env vars or network.
+ * - `apiKey`: override the env-based ANTHROPIC_API_KEY when constructing
+ *   the default client.
+ * - `model`: override the Sonnet model id (lets tests pin the SDK call).
+ */
+export interface LLMServiceOptions {
+    anthropic?: Anthropic;
+    apiKey?: string;
+    model?: string;
+}
 export declare class LLMService {
     private anthropic;
-    constructor();
+    private readonly model;
+    constructor(opts?: LLMServiceOptions);
     private cleanJson;
     /**
      * Attempts to infer contentChange when the AI did not return the field.

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

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

package/dist/services/LLMService.js

@@ -39,6 +39,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.LLMService = void 0;
 const sdk_1 = __importDefault(require("@anthropic-ai/sdk"));
 const dotenv = __importStar(require("dotenv"));
+const SelaError_1 = require("../errors/SelaError");
 dotenv.config();
 // ─────────────────────────────────────────────────────────────────
 // SYSTEM PROMPT
@@ -70,11 +71,11 @@ Narrowing: filter, first, last, nth
 You MUST return a "chainSegments" array for the permanent code fix AND a matching "segments" array for the runtime proxy.
 
 Build the chain in this priority order:
-  PRIORITY 1 — getByTestId
-  PRIORITY 2 — getByRole (ALWAYS include "name" if it exists in the DOM to ensure uniqueness)
-  PRIORITY 3 — getByLabel
-  PRIORITY 4 — getByText (use exact: true if possible)
-  NARROWING — Use filter({ hasText: "..." }) to isolate an element within a repeated container.
+  PRIORITY 1 - getByTestId
+  PRIORITY 2 - getByRole (ALWAYS include "name" if it exists in the DOM to ensure uniqueness)
+  PRIORITY 3 - getByLabel
+  PRIORITY 4 - getByText (use exact: true if possible)
+  NARROWING - Use filter({ hasText: "..." }) to isolate an element within a repeated container.
 
 ### PROXY SELECTOR CONSTRUCTION (segments field)
 The "segments[0].selector" string is used for an immediate "live" retry. 
@@ -89,10 +90,10 @@ Preserve the original code's structural pattern from "originalChainHint":
 
 ### TEMPLATE LITERAL / FUNCTION SELECTOR PRESERVATION
 When the failing selector originates from a Template Literal or a function returning a template,
-preserve the attribute structure — update the value inside the attribute rather than removing it.
+preserve the attribute structure - update the value inside the attribute rather than removing it.
 For chain selectors: if the original was "#section-B >> input[data-role='user_legacy']"
 and the DNA shows data-role changed to "user_active", return "#section-B >> input[data-role='user_active']".
-NEVER simplify to "#section-B >> input" — that loses the attribute and breaks automated source healing.
+NEVER simplify to "#section-B >> input" - that loses the attribute and breaks automated source healing.
 The healing system depends on the attribute value being present in your response to patch the template variable.
 
 ### TYPE SAFETY RULES
@@ -104,21 +105,21 @@ If the element's text changed, you MUST include:
   "contentChange": { "oldText": "<previous>", "newText": "<current>" }
 
 ### CONFIDENCE SCORE (MANDATORY)
-You MUST include a numeric "confidence" field — an INTEGER in the range 0-100 —
+You MUST include a numeric "confidence" field - an INTEGER in the range 0-100 -
 representing how certain you are that the returned chain will resolve the
 intended element on the next test run. Use this rubric:
-  - 90-100: stable id, data-testid, or unique role+name — zero ambiguity in the DOM.
+  - 90-100: stable id, data-testid, or unique role+name - zero ambiguity in the DOM.
   - 70-89:  strong semantic match, but some structural drift or competing candidates.
-  - 50-69:  best-guess match — multiple plausible candidates required disambiguation.
-  - 1-49:   speculative match — return this only when no better candidate exists.
+  - 50-69:  best-guess match - multiple plausible candidates required disambiguation.
+  - 1-49:   speculative match - return this only when no better candidate exists.
 NEVER omit this field. NEVER return it as a string, boolean, or null.
-Reports rendered downstream will show "n/a" when this field is missing — which
+Reports rendered downstream will show "n/a" when this field is missing - which
 is a clear failure signal to the developer reviewing the heal.
 
 ### MANDATORY OUTPUT FORMAT
 Return ONLY valid JSON.
 
-Example output — Identifying a specific button in a list row:
+Example output - Identifying a specific button in a list row:
 {
   "status": "FIXED",
   "confidence": 92,
@@ -199,15 +200,24 @@ function inferOriginalChainHint(selector) {
     }
     return segments;
 }
-// ─────────────────────────────────────────────────────────────────
-// LLM SERVICE
-// ─────────────────────────────────────────────────────────────────
+const DEFAULT_LLM_MODEL = "claude-sonnet-4-20250514";
 class LLMService {
     anthropic;
-    constructor() {
-        const apiKey = process.env.ANTHROPIC_API_KEY || "";
-        if (!apiKey)
-            throw new Error("ANTHROPIC_API_KEY not found in .env");
+    model;
+    constructor(opts = {}) {
+        this.model = opts.model ?? DEFAULT_LLM_MODEL;
+        if (opts.anthropic) {
+            this.anthropic = opts.anthropic;
+            return;
+        }
+        const apiKey = opts.apiKey ?? process.env.ANTHROPIC_API_KEY ?? "";
+        if (!apiKey) {
+            throw new SelaError_1.SelaError({
+                subsystem: "LLMService",
+                code: SelaError_1.LLM_SERVICE_CODES.NO_API_KEY,
+                reason: "ANTHROPIC_API_KEY not found - pass an `anthropic` client or `apiKey` to LLMService(), or set the env var",
+            });
+        }
         this.anthropic = new sdk_1.default({ apiKey });
     }
     cleanJson(text) {
@@ -329,7 +339,7 @@ ${request.targetIntent}
 ### PREVIOUS DNA (Element Fingerprint):
 ${dnaSummary && Object.keys(dnaSummary).length > 0
             ? JSON.stringify(dnaSummary, null, 2)
-            : "NO DNA (First run — infer from selector and DOM)"}
+            : "NO DNA (First run - infer from selector and DOM)"}
 
 ### CURRENT DOM SNIPPET:
 ${request.currentDom}
@@ -341,10 +351,10 @@ ${request.currentDom}
 4. Populate "contentChange" if the element's visible text changed.
 5. Also populate "segments" (legacy format) for backward compatibility.
 
-Return ONLY a raw JSON object — no markdown, no preamble.`;
+Return ONLY a raw JSON object - no markdown, no preamble.`;
         try {
             const msg = await this.anthropic.messages.create({
-                model: "claude-sonnet-4-20250514",
+                model: this.model,
                 max_tokens: 1024,
                 system: SYSTEM_PROMPT_TEXT +
                     "\nIMPORTANT: Respond ONLY with a raw JSON object.",

package/dist/services/PRAutomationService.d.ts

@@ -1,5 +1,6 @@
 import type { ResolvedPRAutomation, PRStrategy, BugAction } from "../config/SelaConfig";
 import type { HealedEvent, ProtectedEvent } from "./HealReportService";
+import { type WorkspaceSnapshotService } from "./WorkspaceSnapshotService";
 export interface BranchInfo {
     branch: string | null;
     isPR: boolean;
@@ -32,6 +33,18 @@ export interface ExecutionResult {
     branchPushed: string | null;
     errors: string[];
 }
-export declare function execute(cfg: ResolvedPRAutomation, decision: StrategyDecision, heals: HealedEvent[], branchInfo: BranchInfo, ctx: ExecuteContext): Promise<ExecutionResult>;
+/**
+ * Clean-Room execution lifecycle.
+ *
+ * The legacy flow committed the developer's whole dirty working tree onto
+ * the PR branch - polluting reviewers with `test.only`, commented debug
+ * blocks, etc. This refactor isolates Sela's specific AST changes onto an
+ * ephemeral branch, leaves the developer's local workspace byte-identical
+ * to its pre-Sela state, and is wrapped in a try/finally that restores
+ * the workspace even on mid-flight crashes.
+ */
+export declare function execute(cfg: ResolvedPRAutomation, decision: StrategyDecision, heals: HealedEvent[], branchInfo: BranchInfo, ctx: ExecuteContext, 
+/** Injectable for tests - defaults to the module singleton. */
+workspace?: WorkspaceSnapshotService): Promise<ExecutionResult>;
 export declare function handleBugDetected(action: BugAction, events: ProtectedEvent[], branchInfo: BranchInfo, ctx: ExecuteContext): Promise<void>;
 //# sourceMappingURL=PRAutomationService.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"PRAutomationService.d.ts","sourceRoot":"","sources":["../../src/services/PRAutomationService.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EACV,oBAAoB,EACpB,UAAU,EACV,SAAS,EACV,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACf,MAAM,qBAAqB,CAAC;AAM7B,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,UAAU,CAAC;IACtB,UAAU,EAAE,UAAU,CAAC;IACvB,eAAe,EAAE,kBAAkB,GAAG,gBAAgB,GAAG,aAAa,GAAG,IAAI,CAAC;IAC9E;;;;OAIG;IACH,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,6EAA6E;IAC7E,oBAAoB,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1C;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AA2ED,wBAAgB,YAAY,CAAC,GAAG,GAAE,MAAsB,GAAG,UAAU,CA8EpE;AAMD,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,oBAAoB,EACzB,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,KAAK,EAAE,WAAW,EAAE,GACnB,gBAAgB,CAgElB;AAMD,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAEzC;AAuFD,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,UAAU,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,wBAAsB,OAAO,CAC3B,GAAG,EAAE,oBAAoB,EACzB,QAAQ,EAAE,gBAAgB,EAC1B,KAAK,EAAE,WAAW,EAAE,EACpB,UAAU,EAAE,UAAU,EACtB,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,eAAe,CAAC,CA4J1B;AAMD,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,cAAc,EAAE,EACxB,UAAU,EAAE,UAAU,EACtB,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,IAAI,CAAC,CA0Ff"}
+{"version":3,"file":"PRAutomationService.d.ts","sourceRoot":"","sources":["../../src/services/PRAutomationService.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EACV,oBAAoB,EACpB,UAAU,EACV,SAAS,EACV,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAGL,KAAK,wBAAwB,EAC9B,MAAM,4BAA4B,CAAC;AAOpC,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,UAAU,CAAC;IACtB,UAAU,EAAE,UAAU,CAAC;IACvB,eAAe,EAAE,kBAAkB,GAAG,gBAAgB,GAAG,aAAa,GAAG,IAAI,CAAC;IAC9E;;;;OAIG;IACH,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,6EAA6E;IAC7E,oBAAoB,EAAE,MAAM,GAAG,SAAS,CAAC;CAC1C;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAiFD,wBAAgB,YAAY,CAAC,GAAG,GAAE,MAAsB,GAAG,UAAU,CA+EpE;AAMD,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,oBAAoB,EACzB,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,KAAK,EAAE,WAAW,EAAE,GACnB,gBAAgB,CAgElB;AAMD,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAEzC;AA6FD,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,UAAU,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;;;;;GASG;AACH,wBAAsB,OAAO,CAC3B,GAAG,EAAE,oBAAoB,EACzB,QAAQ,EAAE,gBAAgB,EAC1B,KAAK,EAAE,WAAW,EAAE,EACpB,UAAU,EAAE,UAAU,EACtB,GAAG,EAAE,cAAc;AACnB,+DAA+D;AAC/D,SAAS,GAAE,wBAAkD,GAC5D,OAAO,CAAC,eAAe,CAAC,CAkG1B;AAwTD,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,cAAc,EAAE,EACxB,UAAU,EAAE,UAAU,EACtB,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,IAAI,CAAC,CA4Gf"}