sela-core 1.0.7 → 1.0.8

package/dist/engine/SelaEngine.js

@@ -91,13 +91,13 @@ class SelaEngine {
         // pre-scan. Keeping it separate from the SourceUpdater's project avoids
         // polluting that cache with files we may never actually mutate.
         this.astDirectiveScanner = new ASTSourceUpdater_1.ASTSourceUpdater();
-        // Local healing cache — short-circuits the LLM call when an identical
+        // Local healing cache - short-circuits the LLM call when an identical
         // (filePath, oldSelector) pair was healed safely in a prior session.
         // Disabled when SELA_NO_CACHE=1; reads/writes skipped during dry runs.
         this.healingCache = HealingCacheService_1.sharedHealingCache;
     }
     // ─────────────────────────────────────────────────────────────
-    // healArgument — repairs a wrong action argument (e.g. selectOption)
+    // healArgument - repairs a wrong action argument (e.g. selectOption)
     // ─────────────────────────────────────────────────────────────
     async healArgument(page, selector, action, oldArgument, stableId, filePath, line) {
         console.log(`[Sela] 🔧 HEALING ARGUMENT for action '${action}': "${oldArgument}"`);
@@ -130,7 +130,7 @@ CRITICAL: Do NOT return a CSS selector like "#my-select". Return plain text only
         return null;
     }
     // ─────────────────────────────────────────────────────────────
-    // heal — repairs a broken selector
+    // heal - repairs a broken selector
     // ─────────────────────────────────────────────────────────────
     async heal(page, fullSelector, elementSelectorOnly, stableId, filePath, line, healMode = "action") {
         console.log(`\n[Sela] 🛠️  HEALING START for: ${stableId}`);
@@ -148,7 +148,7 @@ CRITICAL: Do NOT return a CSS selector like "#my-select". Return plain text only
         catch (directiveErr) {
             if ((0, SelaError_1.isSelaErrorFrom)(directiveErr, "ASTUpdater") &&
                 directiveErr.code === SelaError_1.AST_UPDATER_CODES.HEAL_DISABLED_BY_DIRECTIVE) {
-                console.warn(`[Sela] 🛑 Skipped by Developer — ${directiveErr.reason}`);
+                console.warn(`[Sela] 🛑 Skipped by Developer - ${directiveErr.reason}`);
                 const skipEvent = {
                     kind: "FAILED",
                     stableId,
@@ -218,10 +218,10 @@ If the text has NOT changed, omit the "contentChange" field entirely.`;
                     return "";
                 const lines = [];
                 if (anchors.closestLabel) {
-                    lines.push(`- Label: "${anchors.closestLabel}" — the UI label or heading associated with this element.`);
+                    lines.push(`- Label: "${anchors.closestLabel}" - the UI label or heading associated with this element.`);
                 }
                 if (anchors.rowAnchor) {
-                    lines.push(`- Row key: "${anchors.rowAnchor}" — unique cell text identifying the table row this element belonged to.`);
+                    lines.push(`- Row key: "${anchors.rowAnchor}" - unique cell text identifying the table row this element belonged to.`);
                 }
                 if (lines.length === 0)
                     return "";
@@ -236,12 +236,12 @@ If the text has NOT changed, omit the "contentChange" field entirely.`;
             // pair AND SafetyGuard cleared it, replay the cached fix instead
             // of paying the LLM round-trip. Disabled when SELA_NO_CACHE=1.
             // The synthetic aiFix is fed through SafetyGuard exactly like a
-            // fresh LLM response — cache is a latency optimisation, never a
+            // fresh LLM response - cache is a latency optimisation, never a
             // safety bypass.
             let aiFix = null;
             let cacheHit = false;
             // Fingerprint inputs the cache key depends on. Recomputed every
-            // heal so a DNA rewrite — which changes `dnaContentHash` —
+            // heal so a DNA rewrite - which changes `dnaContentHash` -
             // automatically invalidates every prior entry without an explicit
             // purge.
             const dnaContentHash = (0, HealingCacheService_1.hashDnaContent)(lastKnownState ?? null);
@@ -255,13 +255,14 @@ If the text has NOT changed, omit the "contentChange" field entirely.`;
             if (!this.config.noCache) {
                 const cached = this.healingCache.get(cacheKeyInput);
                 if (cached) {
-                    console.log(`[Sela] 🧊 Cache hit (0ms LLM) — replaying healed selector "${cached.healedSelector}"`);
+                    console.log(`[Sela] 🧊 Cache hit (0ms LLM) - replaying healed selector "${cached.healedSelector}"`);
                     aiFix = {
                         status: "FIXED",
                         new_selector: cached.healedSelector,
                         chainSegments: cached.chainSegments,
-                        segments: cached.segments ??
-                            [{ type: "element", selector: cached.healedSelector }],
+                        segments: cached.segments ?? [
+                            { type: "element", selector: cached.healedSelector },
+                        ],
                         confidence: cached.confidence,
                         contentChange: cached.contentChange,
                         explanation: cached.explanation ?? "Replayed from local healing cache",
@@ -308,7 +309,7 @@ If the text has NOT changed, omit the "contentChange" field entirely.`;
                     console.log(`[Sela] 🔍 Step 3.5: Live text fetch skipped (element not yet rendered or non-text)`);
                 }
                 // ── Step 3.6: Atomic v2 capture of the candidate element ──
-                // Single page.evaluate() call — collects visibility, ancestry,
+                // Single page.evaluate() call - collects visibility, ancestry,
                 // and anchors of the healed element for SafetyGuard use.
                 // Returns null on any failure; never blocks the heal.
                 const liveSnapshot = await this.snapshotService.captureElement(page, elementOnlySelector, successfulPath);
@@ -321,7 +322,7 @@ If the text has NOT changed, omit the "contentChange" field entirely.`;
                         : "";
                     const occFlag = liveVisibility?.isOccluded ? " 🫥 OCCLUDED" : "";
                     console.log(`[Sela] 🔍 Step 3.6: Live v2 capture complete` +
-                        `${ghostFlag}${occFlag} — ancestry depth: ${liveAncestry?.length ?? 0}`);
+                        `${ghostFlag}${occFlag} - ancestry depth: ${liveAncestry?.length ?? 0}`);
                 }
                 else {
                     console.log(`[Sela] 🔍 Step 3.6: Live v2 capture skipped`);
@@ -355,7 +356,7 @@ If the text has NOT changed, omit the "contentChange" field entirely.`;
                     }
                     // ── Report: PROTECTED (or BLOCKED non-INCONSISTENT) ─────────
                     // The auto-fix was blocked. If the auditor verdict is INCONSISTENT
-                    // this is a "Security Win" — a masked regression was caught.
+                    // this is a "Security Win" - a masked regression was caught.
                     const protectedEvent = {
                         kind: "PROTECTED",
                         stableId,
@@ -407,7 +408,7 @@ If the text has NOT changed, omit the "contentChange" field entirely.`;
                         parts.push(`${breakdown.penalty} ancestry drift`);
                     if (breakdown.bonus !== 0)
                         parts.push(`+${breakdown.bonus} anchor match`);
-                    console.log(`[Sela] 📊 Score — AI: ${fmtPctEngine(aiFix.confidence)} | ` +
+                    console.log(`[Sela] 📊 Score - AI: ${fmtPctEngine(aiFix.confidence)} | ` +
                         `Auditor: ${fmtPctEngine(breakdown.adjustedConfidence)} ` +
                         `(raw ${fmtPctEngine(breakdown.rawConfidence)}, ${parts.join(", ")})`);
                 }
@@ -417,7 +418,7 @@ If the text has NOT changed, omit the "contentChange" field entirely.`;
                 //   1. updateResult.lineUpdated  (the strategy's literal write location)
                 //   2. updateResult.definitionSite.line  (semantic JumpToDef target,
                 //      used when the mutation crossed into a const/variable declaration)
-                //   3. line  (the original failure line — last-resort fallback)
+                //   3. line  (the original failure line - last-resort fallback)
                 // For cross-file definitionSite.file, we still read the new line from
                 // the SAME file that was mutated.
                 const defSite = updateResult.definitionSite;
@@ -430,7 +431,7 @@ If the text has NOT changed, omit the "contentChange" field entirely.`;
                     line;
                 const mutatedFilePath = !sameFileDef && defSite ? defSite.file : filePath;
                 // Clean-Room isolated diff. We diff the in-memory snapshot recorded
-                // by WorkspaceSnapshotService (contentBefore — disk state right
+                // by WorkspaceSnapshotService (contentBefore - disk state right
                 // before Sela's first write to this file) against the post-write
                 // disk state. The result contains EXCLUSIVELY Sela's selector swap;
                 // any developer dirty edits sit identically in both buffers and
@@ -441,12 +442,14 @@ If the text has NOT changed, omit the "contentChange" field entirely.`;
                 // Backward-compat: keep oldCodeLine/newCodeLine populated from the
                 // first -/+ pair inside the diff. When git produced no diff (file
                 // untracked, git unavailable, …) fall back to a direct disk read of
-                // the mutated line — strictly inferior but preserves old reports.
-                const oldCodeLine = firstChange.oldLine ?? this._safeReadLine(mutatedFilePath, writtenLine);
-                const newCodeLine = firstChange.newLine ?? this._safeReadLine(mutatedFilePath, writtenLine);
+                // the mutated line - strictly inferior but preserves old reports.
+                const oldCodeLine = firstChange.oldLine ??
+                    this._safeReadLine(mutatedFilePath, writtenLine);
+                const newCodeLine = firstChange.newLine ??
+                    this._safeReadLine(mutatedFilePath, writtenLine);
                 const canonicalSelector = updateResult.healedLocatorString ?? newFullSelector;
                 console.log(`[Sela] ✅ Canonical selector (disk == runtime): "${canonicalSelector}"`);
-                // Buffer CLI-ready metadata — merged into DNA at commitUpdates() time.
+                // Buffer CLI-ready metadata - merged into DNA at commitUpdates() time.
                 // Sanitize filePath: strip any residual "at " stack-trace prefix + whitespace,
                 // then resolve to an absolute path before converting to project-relative form.
                 const match = filePath.match(/at\s+(.*)/i);
@@ -515,7 +518,7 @@ If the text has NOT changed, omit the "contentChange" field entirely.`;
                     contentChange: aiFix.contentChange,
                 };
                 HealReportService_1.sharedHealReport.record(healedEvent);
-                // ── Cache write — persist this safe heal for future sessions ──
+                // ── Cache write - persist this safe heal for future sessions ──
                 // Best-effort: failures are logged inside the service and never
                 // block the heal return. Skipped automatically during dry runs
                 // and when SELA_NO_CACHE=1.
@@ -536,7 +539,7 @@ If the text has NOT changed, omit the "contentChange" field entirely.`;
                 }
                 return canonicalSelector;
             }
-            // AI did not return FIXED — record as FAILED.
+            // AI did not return FIXED - record as FAILED.
             const failedEvent = {
                 kind: "FAILED",
                 stableId,
@@ -562,9 +565,12 @@ If the text has NOT changed, omit the "contentChange" field entirely.`;
             // Prefer the structured instanceof check; fall back to message-substring
             // detection for any legacy throw sites that have not yet been migrated.
             const isSafetyBlock = (0, SelaError_1.isSelaErrorFrom)(error, "SafetyGuard") ||
-                (typeof error?.message === "string" && error.message.includes("[Sela-SafetyGuard]")) ||
-                (typeof error?.message === "string" && error.message.includes("[SafetyGuard]"));
-            const isNotFoundAlreadyRecorded = typeof error?.message === "string" && error.message === "AI could not provide a fix";
+                (typeof error?.message === "string" &&
+                    error.message.includes("[Sela-SafetyGuard]")) ||
+                (typeof error?.message === "string" &&
+                    error.message.includes("[SafetyGuard]"));
+            const isNotFoundAlreadyRecorded = typeof error?.message === "string" &&
+                error.message === "AI could not provide a fix";
             if (!isSafetyBlock && !isNotFoundAlreadyRecorded) {
                 const failedEvent = {
                     kind: "FAILED",
@@ -594,14 +600,20 @@ If the text has NOT changed, omit the "contentChange" field entirely.`;
         if (!filePath)
             return "";
         const match = filePath.match(/at\s+(.*)/i);
-        const cleaned = (match ? match[1] : filePath).replace(/^\(|\)$/g, "").trim();
-        const abs = path.isAbsolute(cleaned) ? cleaned : path.resolve(process.cwd(), cleaned);
+        const cleaned = (match ? match[1] : filePath)
+            .replace(/^\(|\)$/g, "")
+            .trim();
+        const abs = path.isAbsolute(cleaned)
+            ? cleaned
+            : path.resolve(process.cwd(), cleaned);
         return path.relative(process.cwd(), abs) || abs;
     }
     _safeReadLine(filePath, lineNumber) {
         try {
             const cleaned = this._toReportFile(filePath);
-            const abs = path.isAbsolute(cleaned) ? cleaned : path.resolve(process.cwd(), cleaned);
+            const abs = path.isAbsolute(cleaned)
+                ? cleaned
+                : path.resolve(process.cwd(), cleaned);
             if (!fs.existsSync(abs))
                 return "";
             const lines = fs.readFileSync(abs, "utf8").split(/\r?\n/);
@@ -654,7 +666,7 @@ If the text has NOT changed, omit the "contentChange" field entirely.`;
      * `gitUnifiedDiff` payload yet.
      *
      * Carefully skips the diff preamble (--- a/file, +++ b/file, "diff ",
-     * "index ", rename headers) — those lines would otherwise be mistaken for
+     * "index ", rename headers) - those lines would otherwise be mistaken for
      * a -/+ change pair and produce nonsense like the original "line replaced
      * by itself" output. Real change lines only count once the parser has seen
      * a "@@" hunk header.
@@ -694,7 +706,7 @@ If the text has NOT changed, omit the "contentChange" field entirely.`;
         if (!meta || !meta.auditorVerdict)
             return null;
         // Keep auditor confidence as `undefined` when SafetyGuard did not produce
-        // one — the renderer fmtPct helper turns it into "n/a" rather than 0%.
+        // one - the renderer fmtPct helper turns it into "n/a" rather than 0%.
         const conf = typeof meta.auditorConfidence === "number" &&
             Number.isFinite(meta.auditorConfidence)
             ? meta.auditorConfidence
@@ -766,15 +778,16 @@ If the text has NOT changed, omit the "contentChange" field entirely.`;
     _buildReasoningSteps(ctx) {
         const steps = [];
         if (ctx.dnaTag || ctx.dnaText) {
-            steps.push(`Recovered DNA baseline — previously a <${ctx.dnaTag ?? "?"}>` +
-                (ctx.dnaText ? ` with text "${ctx.dnaText}"` : "") + ".");
+            steps.push(`Recovered DNA baseline - previously a <${ctx.dnaTag ?? "?"}>` +
+                (ctx.dnaText ? ` with text "${ctx.dnaText}"` : "") +
+                ".");
         }
         if (ctx.successfulPath.length > 0) {
             steps.push(`Resolved DOM context inside ${ctx.successfulPath.length} nested frame(s): ${ctx.successfulPath.join(" >> ")}.`);
         }
         const firstSeg = ctx.aiFix.chainSegments?.[0];
         if (firstSeg) {
-            steps.push(`AI preserved the ${firstSeg.type} pattern — semantic locator over raw CSS path.`);
+            steps.push(`AI preserved the ${firstSeg.type} pattern - semantic locator over raw CSS path.`);
         }
         if (ctx.aiFix.explanation) {
             steps.push(`AI reasoning: ${ctx.aiFix.explanation}`);
@@ -783,7 +796,7 @@ If the text has NOT changed, omit the "contentChange" field entirely.`;
         if (ctx.aiFix.contentChange) {
             steps.push(`Detected content drift: "${ctx.aiFix.contentChange.oldText}" → "${ctx.aiFix.contentChange.newText}".`);
         }
-        steps.push(`SafetyGuard verdict: ${ctx.safetyLevel} — change cleared for write.`);
+        steps.push(`SafetyGuard verdict: ${ctx.safetyLevel} - change cleared for write.`);
         steps.push(`Source updated via ${ctx.strategy} at line ${ctx.writtenLine}.`);
         if (ctx.blastRadius != null && ctx.blastRadius > 0) {
             steps.push(`Blast radius: ${ctx.blastRadius} dependent test reference(s) inherited the fix.`);
@@ -808,7 +821,7 @@ If the text has NOT changed, omit the "contentChange" field entirely.`;
             this.testTitleBuffer.clear();
             SourceUpdater_1.SourceUpdater.flushAdvisories();
         }
-        // ── Sela Insights — render the transparent healing report ───────
+        // ── Sela Insights - render the transparent healing report ───────
         let reportHtmlPath = null;
         const healedEvents = HealReportService_1.sharedHealReport.getHealedEvents();
         const protectedEvents = HealReportService_1.sharedHealReport.getProtectedEvents();
@@ -827,11 +840,12 @@ If the text has NOT changed, omit the "contentChange" field entirely.`;
         // ── Dual-Mode post-run lifecycle ─────────────────────────────────
         //
         // CI (process.env.CI truthy) → Clean-Room PR automation (existing flow).
-        // Local DX (CI falsy)        → Interactive CLI review of each mutated
-        //                              file; Apply keeps the on-disk fix, Reject
-        //                              rewinds via WorkspaceSnapshotService.
+        // Local DX (CI falsy)        → Write-and-notify: AST mutations are
+        //                              already on disk; the reporter prints a
+        //                              diff + vscode:// deeplink + report link
+        //                              via printHealReview() (no Y/N prompt).
         //
-        // The interactive branch deliberately bypasses PR automation because:
+        // The local branch deliberately bypasses PR automation because:
         //   • AST fixes are ALREADY persisted to disk (the test passed on them).
         //   • Local devs want to inspect + cherry-pick, not auto-commit.
         if (isCiEnvironment()) {
@@ -858,11 +872,11 @@ If the text has NOT changed, omit the "contentChange" field entirely.`;
             }
         }
         else if (healedEvents.length > 0) {
-            // Local DX: do NOT block this process on stdin — workers have no
-            // TTY and would deadlock until Playwright's per-test timeout fires.
-            // Serialise the mutated snapshots to a cross-process ledger; the
-            // SelaReporter drains it from `onEnd()` in the main process where
-            // an interactive `readline` is safe.
+            // Local DX: serialise the mutated snapshots to a cross-process
+            // ledger. The SelaReporter drains it from `onEnd()` in the main
+            // process and prints a non-blocking summary (diff + vscode://
+            // deeplink). Mutations are already on disk - the ledger only
+            // exists so the reporter knows what to narrate.
             try {
                 (0, PendingPromptLedger_1.writePendingPromptsLedger)({
                     cwd: process.cwd(),
@@ -887,12 +901,12 @@ If the text has NOT changed, omit the "contentChange" field entirely.`;
         WorkspaceSnapshotService_1.sharedWorkspaceSnapshot.clear();
     }
     // ─────────────────────────────────────────────────────────────
-    // fetchLiveText — frame-aware innerText fetch (zero-trust probe)
+    // fetchLiveText - frame-aware innerText fetch (zero-trust probe)
     //
     // Navigates the frame chain encoded in successfulPath, then calls
     // .first().innerText() on the element-only selector.  Uses a short
     // 1.5 s timeout so it never adds meaningful latency.  Returns null
-    // on ANY failure — the caller must treat null as "no data" and skip
+    // on ANY failure - the caller must treat null as "no data" and skip
     // live verification rather than blocking the heal.
     // ─────────────────────────────────────────────────────────────
     async fetchLiveText(page, elementOnlySelector, framePath) {
@@ -923,7 +937,7 @@ If the text has NOT changed, omit the "contentChange" field entirely.`;
             p === "frame" ||
             p.includes("frame-"));
         if (aiHasFrameSegments) {
-            console.log(`[Sela] 🔗 AI returned full frame path — using directly: ${aiNewSelector}`);
+            console.log(`[Sela] 🔗 AI returned full frame path - using directly: ${aiNewSelector}`);
             return aiNewSelector;
         }
         return [...frameParts, ...aiParts].join(" >> ");
@@ -951,7 +965,7 @@ If the text has NOT changed, omit the "contentChange" field entirely.`;
         return arrayOfFiles;
     }
     // ─────────────────────────────────────────────────────────────
-    // captureSuccessfulElement — capture and buffer a v2 DNA snapshot.
+    // captureSuccessfulElement - capture and buffer a v2 DNA snapshot.
     //
     // Replaces the previous DOMUtils.getElementDNA() path with a single
     // captureElement() call that collects all v2 metrics atomically.

package/dist/errors/SelaError.d.ts

@@ -63,7 +63,6 @@ export declare const SAFETY_GUARD_CODES: {
     readonly BLOCKED_ROLE_SWAP_ASSERTION: "SG_BLOCKED_ROLE_SWAP_ASSERTION";
     readonly FAIL_HARD_AUDITOR_INCONSISTENT: "SG_FAIL_HARD_AUDITOR_INCONSISTENT";
     readonly BLOCKED_AUDITOR_SUSPICIOUS: "SG_BLOCKED_AUDITOR_SUSPICIOUS";
-    readonly BLOCKED_SIMILARITY_FLOOR: "SG_BLOCKED_SIMILARITY_FLOOR";
     /** Generic dispatcher when SafetyDecision arrives without an explicit code. */
     readonly GENERIC_REJECTION: "SG_GENERIC_REJECTION";
 };

package/dist/errors/SelaError.d.ts.map

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

package/dist/errors/SelaError.js

@@ -17,7 +17,7 @@ exports.CHAIN_VALIDATOR_CODES = exports.REPORT_CODES = exports.REGISTRY_CODES =
 exports.isSelaError = isSelaError;
 exports.isSelaErrorFrom = isSelaErrorFrom;
 // ───────────────────────────────────────────────────────────────────
-// SelaError — single class for the whole hierarchy.
+// SelaError - single class for the whole hierarchy.
 //
 // We intentionally avoid a tree of subclasses; `instanceof SelaError` +
 // `err.subsystem === "X"` is more flexible for callers and keeps the
@@ -31,7 +31,7 @@ class SelaError extends Error {
     context;
     constructor(init) {
         if (!CODE_PATTERN.test(init.code)) {
-            throw new Error(`[SelaError] invalid code "${init.code}" — must match ${CODE_PATTERN}`);
+            throw new Error(`[SelaError] invalid code "${init.code}" - must match ${CODE_PATTERN}`);
         }
         const formatted = SelaError.formatMessage(init.subsystem, init.code, init.reason);
         super(formatted);
@@ -45,9 +45,9 @@ class SelaError extends Error {
         }
         // Maintain prototype chain through transpilation (ES5 target).
         Object.setPrototypeOf(this, new.target.prototype);
-        if (typeof Error.captureStackTrace === "function") {
-            Error
-                .captureStackTrace(this, new.target);
+        if (typeof Error.captureStackTrace ===
+            "function") {
+            Error.captureStackTrace(this, new.target);
         }
     }
     static formatMessage(subsystem, code, reason) {
@@ -81,7 +81,7 @@ function isSelaErrorFrom(err, subsystem) {
 // ───────────────────────────────────────────────────────────────────
 // Canonical code catalogue
 //
-// Tests assert against these constants — never hand-write code strings
+// Tests assert against these constants - never hand-write code strings
 // at throw sites.  Adding a new code requires adding it here first so
 // the catalogue stays in sync with the error-indicativity contract.
 // ───────────────────────────────────────────────────────────────────
@@ -94,7 +94,6 @@ exports.SAFETY_GUARD_CODES = {
     BLOCKED_ROLE_SWAP_ASSERTION: "SG_BLOCKED_ROLE_SWAP_ASSERTION",
     FAIL_HARD_AUDITOR_INCONSISTENT: "SG_FAIL_HARD_AUDITOR_INCONSISTENT",
     BLOCKED_AUDITOR_SUSPICIOUS: "SG_BLOCKED_AUDITOR_SUSPICIOUS",
-    BLOCKED_SIMILARITY_FLOOR: "SG_BLOCKED_SIMILARITY_FLOOR",
     /** Generic dispatcher when SafetyDecision arrives without an explicit code. */
     GENERIC_REJECTION: "SG_GENERIC_REJECTION",
 };

package/dist/fixtures/expectProxy.d.ts

@@ -1,7 +1,7 @@
 import { Locator } from "@playwright/test";
 import { SelaEngine } from "../engine/SelaEngine";
 /**
- * createHealingExpect — drop-in replacement for Playwright's expect().
+ * createHealingExpect - drop-in replacement for Playwright's expect().
  *
  * @param resolveProxy  Optional callback that unwraps a Fixwright proxy
  * to its current live Locator. Supplied by

package/dist/fixtures/expectProxy.js

@@ -1,5 +1,5 @@
 "use strict";
-// src/fixtures/expectProxy.ts — full replacement
+// src/fixtures/expectProxy.ts - full replacement
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createHealingExpect = createHealingExpect;
 const test_1 = require("@playwright/test");
@@ -17,7 +17,7 @@ function isElementNotFoundError(err) {
     return ELEMENT_NOT_FOUND_PATTERNS.some((p) => p.test(err.message));
 }
 /**
- * Returns true only for genuine Playwright Locator instances —
+ * Returns true only for genuine Playwright Locator instances -
  * not FrameLocator proxies or Fixwright proxy objects.
  *
  * A real Locator has _frame internally.
@@ -31,7 +31,7 @@ function isRealLocator(value) {
     if (typeof value !== "object")
         return false;
     // Fixwright locator proxies expose `_fixwrightSelector`. The proxy forwards
-    // `_frame` via Reflect.get so `hasFrame` would lie — explicitly reject them
+    // `_frame` via Reflect.get so `hasFrame` would lie - explicitly reject them
     // here. Callers should unwrap via `resolveProxy` first.
     if (value._fixwrightSelector !== undefined)
         return false;
@@ -63,7 +63,7 @@ function extractSelectorFromLocator(locator) {
  * frame segments (e.g. "#modern-frame-container >> #status-label-v2").
  *
  * A plain page.locator() call with a frame >> element string is NOT
- * a valid locator for frame content — Playwright rejects it with
+ * a valid locator for frame content - Playwright rejects it with
  * "toHaveText can be only used with Locator object".
  *
  * This function correctly chains frameLocator() calls for each frame
@@ -128,13 +128,13 @@ function wrapMatcher(matcher, locator, matcherName, engine, page, ctx) {
             if (!rawSelector)
                 throw err;
             console.log(`[Sela] ⚠️ Assertion failed for "${rawSelector}", attempting heal…`);
-            // Fast path — already healed in this test via registry
+            // Fast path - already healed in this test via registry
             const resolved = HealingRegistry_1.HealingRegistry.getInstance().resolveSelector(rawSelector, ctx);
             let healedSelector = resolved;
             if (resolved === rawSelector) {
-                // Slow path — ask the engine + LLM.
+                // Slow path - ask the engine + LLM.
                 // engine.heal() writes the fix to disk AND returns the canonical
-                // healedLocatorString from SourceUpdater — the exact same string
+                // healedLocatorString from SourceUpdater - the exact same string
                 // that was saved to the file.  This is the handshake that guarantees
                 // disk and runtime are in sync (no "ghost failures").
                 const stableId = require("crypto")
@@ -182,7 +182,7 @@ const WRAPPED_MATCHERS = [
     "toBeFocused",
 ];
 /**
- * createHealingExpect — drop-in replacement for Playwright's expect().
+ * createHealingExpect - drop-in replacement for Playwright's expect().
  *
  * @param resolveProxy  Optional callback that unwraps a Fixwright proxy
  * to its current live Locator. Supplied by
@@ -204,7 +204,7 @@ resolveProxy) {
             return initialLine;
         };
         const actualLine = getCallerLine(); // כאן אנחנו מקבלים את השורה הנכונה!
-        // Step 1 — unwrap Fixwright proxy to real active Locator
+        // Step 1 - unwrap Fixwright proxy to real active Locator
         let resolved = locatorOrValue;
         if (resolveProxy) {
             const unwrapped = resolveProxy(locatorOrValue);
@@ -217,7 +217,7 @@ resolveProxy) {
         if (base === null || typeof base !== "object") {
             return base;
         }
-        // Step 2 — only wrap matchers for genuine page-level Locator objects.
+        // Step 2 - only wrap matchers for genuine page-level Locator objects.
         if (!isRealLocator(resolved)) {
             return base;
         }
@@ -226,7 +226,7 @@ resolveProxy) {
         const ctx = { filePath, line: actualLine };
         const proxy = new Proxy(base, {
             get(target, prop) {
-                // Sela proxy identity — honored before any string-only branch so
+                // Sela proxy identity - honored before any string-only branch so
                 // callers can detect a Sela expect proxy via Symbol.for("sela.proxy").
                 if (prop === proxyTag_1.SELA_PROXY)
                     return "expect";

package/dist/fixtures/index.js

@@ -47,7 +47,7 @@ const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const registry = HealingRegistry_1.HealingRegistry.getInstance();
 const proxyToActiveLocator = new WeakMap();
-// Module-level resolver — moduleExpect.ts uses this to unwrap a Fixwright
+// Module-level resolver - moduleExpect.ts uses this to unwrap a Fixwright
 // locator proxy back to its live underlying Playwright Locator without
 // needing access to the WeakMap directly.
 function resolveFixwrightProxy(value) {
@@ -157,7 +157,7 @@ const GET_BY_METHODS = {
     getByTitle: (args) => `internal:attr=[title=${JSON.stringify(args[0])}]`,
 };
 // ─────────────────────────────────────────────────────────────────
-// buildLiveLocator — registry-aware
+// buildLiveLocator - registry-aware
 //
 // NEW: resolves the selector through the HealingRegistry before
 // constructing the Playwright Locator. Zero cost when no heal has
@@ -240,7 +240,7 @@ function buildHealedArgs(prop, args, timeout = 8000) {
 // runWithHealArgument (unchanged from original)
 // ─────────────────────────────────────────────────────────────────
 async function runWithHealArgument(rawPage, prop, args, fullSelector, stableId, callerInfo, originalError) {
-    console.log(`[Sela] 💡 Element visible, action '${prop}' failed — healing argument…`);
+    console.log(`[Sela] 💡 Element visible, action '${prop}' failed - healing argument…`);
     const oldArgument = typeof args[0] === "string" ? args[0] : JSON.stringify(args[0]);
     const newArgument = await singleton_1.sharedEngine.healArgument(rawPage, fullSelector, prop, oldArgument, stableId, callerInfo.filePath, callerInfo.line);
     if (!newArgument)
@@ -250,11 +250,11 @@ async function runWithHealArgument(rawPage, prop, args, fullSelector, stableId,
     return await locator[prop](...healedArgs);
 }
 // ─────────────────────────────────────────────────────────────────
-// runWithHeal — pre-flight registry check added
+// runWithHeal - pre-flight registry check added
 //
 // NEW: Before the first Playwright attempt, resolve the selector
 // through the registry. If a previous heal already mapped it, the
-// first attempt uses the healed selector and succeeds immediately —
+// first attempt uses the healed selector and succeeds immediately -
 // no timeout, no AI call, no file write.
 // ─────────────────────────────────────────────────────────────────
 async function runWithHeal(rawPage, prop, args, fullSelector, elementSelectorOnly, stableId, callerInfo) {
@@ -451,7 +451,7 @@ function createFrameLocatorProxy(rawFrameLocator, frameSelector, rawPage, testTi
         : frameSelector;
     return new Proxy(rawFrameLocator, {
         get(fTarget, fProp) {
-            // Sela proxy identity — honor before the string-only fast path so
+            // Sela proxy identity - honor before the string-only fast path so
             // symbol probes from tests / debuggers return the kind tag.
             if (fProp === proxyTag_1.SELA_PROXY)
                 return "framelocator";
@@ -468,13 +468,13 @@ function createFrameLocatorProxy(rawFrameLocator, frameSelector, rawPage, testTi
     });
 }
 // ─────────────────────────────────────────────────────────────────
-// createLocatorProxy — Runtime Selector Injection added
+// createLocatorProxy - Runtime Selector Injection added
 //
 // NEW additions vs original:
 //  1. Resolves selector through registry on creation (handles proxies
 //     born after a heal has already broadcast).
 //  2. Subscribes to registry so any future broadcast swaps
-//     activeLocator on the same tick — before the next await.
+//     activeLocator on the same tick - before the next await.
 //  3. Exposes _fixwrightUnsubscribe so the fixture can clean up.
 // ─────────────────────────────────────────────────────────────────
 function createLocatorProxy(rawLocator, selector, rawPage, testTitle, actionCounter, elementSelectorOnly) {
@@ -494,7 +494,7 @@ function createLocatorProxy(rawLocator, selector, rawPage, testTitle, actionCoun
         ? buildLiveLocator(rawPage, initialResolved) // already healed
         : rawLocator; // fresh, use as-is
     // ── Subscribe: swap activeLocator when a heal fires ──────────
-    // Inside createLocatorProxy — full updated subscribe block
+    // Inside createLocatorProxy - full updated subscribe block
     // בתוך createLocatorProxy - תחליף את הבלוק של ה-subscribe בזה:
     const unsubscribe = registry.subscribe((fp, oldSel, newSel) => {
         // בדיקה אם הסלקטור הנוכחי מכיל את הישן או שהוא הישן בעצמו
@@ -524,7 +524,7 @@ function createLocatorProxy(rawLocator, selector, rawPage, testTitle, actionCoun
     });
     const proxy = new Proxy(rawLocator, {
         get(target, prop, receiver) {
-            // Sela proxy identity — must be honored before any string-only branch
+            // Sela proxy identity - must be honored before any string-only branch
             // so callers can reliably detect a Sela proxy via Symbol.for("sela.proxy").
             if (prop === proxyTag_1.SELA_PROXY)
                 return "locator";
@@ -657,9 +657,9 @@ function createLocatorProxy(rawLocator, selector, rawPage, testTitle, actionCoun
     return proxy;
 }
 // ─────────────────────────────────────────────────────────────────
-// test fixture — teardown added
+// test fixture - teardown added
 // ─────────────────────────────────────────────────────────────────
-// ─── expect — healing proxy replacing the plain baseExpect proxy ──────────────
+// ─── expect - healing proxy replacing the plain baseExpect proxy ──────────────
 exports.test = test_1.test.extend({
     page: async ({ page }, use, testInfo) => {
         page.on("console", (msg) => {
@@ -672,7 +672,7 @@ exports.test = test_1.test.extend({
         const unsubscribers = [];
         const pageProxy = new Proxy(page, {
             get(target, prop) {
-                // Sela proxy identity — honored before any other branch so callers
+                // Sela proxy identity - honored before any other branch so callers
                 // can reliably detect a Sela page proxy via Symbol.for("sela.proxy").
                 if (prop === proxyTag_1.SELA_PROXY)
                     return "page";
@@ -714,7 +714,7 @@ exports.test = test_1.test.extend({
     },
     expect: async ({ page }, use, testInfo) => {
         const healingExpect = (0, expectProxy_1.createHealingExpect)(singleton_1.sharedEngine, page, testInfo.file, 0, 
-        // Inject proxy resolver — gives expectProxy.ts access to the live
+        // Inject proxy resolver - gives expectProxy.ts access to the live
         // active Locator without exposing the WeakMap directly.
         (value) => {
             if (value && typeof value === "object") {

package/dist/fixtures/proxyTag.d.ts

@@ -3,7 +3,7 @@ export type SelaProxyKind = "locator" | "framelocator" | "page" | "expect";
 /**
  * Returns the proxy kind if `v` is a Sela proxy, otherwise `null`.
  *
- * Performs no instanceof checks against Playwright internals — relies
+ * Performs no instanceof checks against Playwright internals - relies
  * solely on the `SELA_PROXY` symbol contract. Always safe to call on
  * arbitrary values (null/undefined/primitive → null).
  */