sela-core 1.0.7 → 1.0.9

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",
 };
@@ -145,6 +144,14 @@ exports.REPORT_CODES = {
     INVALID_FIELD_TYPE: "REP_INVALID_FIELD_TYPE",
     /** Disk write failed during flushToDisk(). */
     FLUSH_FAILED: "REP_FLUSH_FAILED",
+    /**
+     * A prior `.sela-history.json` existed on disk but could not be parsed as
+     * a JSON array. The merge path refuses to silently overwrite it with a
+     * fresh window (which would destroy the rolling history), so it aborts.
+     */
+    HISTORY_CORRUPT: "REP_HISTORY_CORRUPT",
+    /** A shard report file existed but was not valid JSON / had no events array. */
+    SHARD_UNREADABLE: "REP_SHARD_UNREADABLE",
 };
 exports.CHAIN_VALIDATOR_CODES = {
     TYPE_FLOW: "CV_TYPE_FLOW",

package/dist/fixtures/expectProxy.d.ts

@@ -1,9 +1,9 @@
 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
+ * @param resolveProxy  Optional callback that unwraps a Sela proxy
  * to its current live Locator. Supplied by
  * fixtures/index.ts which owns proxyToActiveLocator.
  */

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,8 +17,8 @@ function isElementNotFoundError(err) {
     return ELEMENT_NOT_FOUND_PATTERNS.some((p) => p.test(err.message));
 }
 /**
- * Returns true only for genuine Playwright Locator instances —
- * not FrameLocator proxies or Fixwright proxy objects.
+ * Returns true only for genuine Playwright Locator instances -
+ * not FrameLocator proxies or Sela proxy objects.
  *
  * A real Locator has _frame internally.
  * A FrameLocator has _frameSelector instead.
@@ -30,10 +30,10 @@ function isRealLocator(value) {
         return false;
     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
+    // Sela locator proxies expose `_selaSelector`. The proxy forwards
+    // `_frame` via Reflect.get so `hasFrame` would lie - explicitly reject them
     // here. Callers should unwrap via `resolveProxy` first.
-    if (value._fixwrightSelector !== undefined)
+    if (value._selaSelector !== undefined)
         return false;
     const hasFrame = value._frame !== undefined ||
         value._impl?._frame !== undefined;
@@ -63,13 +63,13 @@ 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
  * segment, then calls .locator() for the final element segment.
  *
- * Convention used by FixwrightEngine segments:
+ * Convention used by SelaEngine segments:
  *   - Frame segments look like CSS selectors for iframes (#id, .class)
  *     but produce a FrameLocator, not a Locator.
  *   - The last segment is always the element selector.
@@ -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,9 +182,9 @@ 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
+ * @param resolveProxy  Optional callback that unwraps a Sela proxy
  * to its current live Locator. Supplied by
  * fixtures/index.ts which owns proxyToActiveLocator.
  */
@@ -204,7 +204,7 @@ resolveProxy) {
             return initialLine;
         };
         const actualLine = getCallerLine(); // כאן אנחנו מקבלים את השורה הנכונה!
-        // Step 1 — unwrap Fixwright proxy to real active Locator
+        // Step 1 - unwrap Sela 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.d.ts

@@ -1,6 +1,6 @@
 import { Locator, Page } from "@playwright/test";
 import { createHealingExpect } from "./expectProxy";
-export declare function resolveFixwrightProxy(value: unknown): Locator | null;
+export declare function resolveSelaProxy(value: unknown): Locator | null;
 export declare function createFrameLocatorProxy(rawFrameLocator: any, frameSelector: string, rawPage: Page, testTitle: string, actionCounter: {
     value: number;
 }, parentChain: string): any;
@@ -9,6 +9,22 @@ export declare function createLocatorProxy(rawLocator: Locator, selector: string
 }, elementSelectorOnly?: string): any;
 export declare const test: import("@playwright/test").TestType<import("@playwright/test").PlaywrightTestArgs & import("@playwright/test").PlaywrightTestOptions & {
     expect: ReturnType<typeof createHealingExpect>;
-}, import("@playwright/test").PlaywrightWorkerArgs & import("@playwright/test").PlaywrightWorkerOptions>;
+}, import("@playwright/test").PlaywrightWorkerArgs & import("@playwright/test").PlaywrightWorkerOptions & {
+    /**
+     * Worker-scoped lifecycle anchor. Its teardown runs EXACTLY ONCE per
+     * worker process - after every test in that worker has finished - which
+     * is the only correct place to flush the suite-wide healing report.
+     *
+     * Why a worker fixture and not the reporter's onEnd():
+     *   Playwright runs tests in worker processes; the reporter lives in the
+     *   main process. The `sharedHealReport` buffer, `HealingRegistry`, and
+     *   `sharedWorkspaceSnapshot` singletons that accumulate heal events all
+     *   live in the WORKER. The main-process reporter cannot see them, so the
+     *   flush MUST happen worker-side. The reporter's cross-process
+     *   PendingPromptLedger (written here, drained in onEnd) is what carries
+     *   the DX-review summary back to the main process.
+     */
+    _selaWorkerLifecycle: void;
+}>;
 export { createHealingExpect } from "./expectProxy";
 //# sourceMappingURL=index.d.ts.map

package/dist/fixtures/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fixtures/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAI/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAYpD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI,CAIpE;AA2jBD,wBAAgB,uBAAuB,CACrC,eAAe,EAAE,GAAG,EACpB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,IAAI,EACb,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,EAChC,WAAW,EAAE,MAAM,GAClB,GAAG,CAuCL;AAaD,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,OAAO,EACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,IAAI,EACb,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,EAChC,mBAAmB,CAAC,EAAE,MAAM,GAC3B,GAAG,CAkPL;AAQD,eAAO,MAAM,IAAI;YACP,UAAU,CAAC,OAAO,mBAAmB,CAAC;wGAkG9C,CAAC;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/fixtures/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAI/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAYpD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI,CAI/D;AA2jBD,wBAAgB,uBAAuB,CACrC,eAAe,EAAE,GAAG,EACpB,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,IAAI,EACb,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,EAChC,WAAW,EAAE,MAAM,GAClB,GAAG,CAuCL;AAaD,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,OAAO,EACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,IAAI,EACb,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,EAChC,mBAAmB,CAAC,EAAE,MAAM,GAC3B,GAAG,CAkPL;AAQD,eAAO,MAAM,IAAI;YAEL,UAAU,CAAC,OAAO,mBAAmB,CAAC;;IAG9C;;;;;;;;;;;;;OAaG;0BACmB,IAAI;EAwH5B,CAAC;AAGH,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC"}

package/dist/fixtures/index.js

@@ -34,7 +34,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createHealingExpect = exports.test = void 0;
-exports.resolveFixwrightProxy = resolveFixwrightProxy;
+exports.resolveSelaProxy = resolveSelaProxy;
 exports.createFrameLocatorProxy = createFrameLocatorProxy;
 exports.createLocatorProxy = createLocatorProxy;
 const test_1 = require("@playwright/test");
@@ -47,10 +47,10 @@ 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 Sela
 // locator proxy back to its live underlying Playwright Locator without
 // needing access to the WeakMap directly.
-function resolveFixwrightProxy(value) {
+function resolveSelaProxy(value) {
     if (!value || typeof value !== "object")
         return null;
     const getActive = proxyToActiveLocator.get(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,14 +468,14 @@ 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.
-//  3. Exposes _fixwrightUnsubscribe so the fixture can clean up.
+//     activeLocator on the same tick - before the next await.
+//  3. Exposes _selaUnsubscribe so the fixture can clean up.
 // ─────────────────────────────────────────────────────────────────
 function createLocatorProxy(rawLocator, selector, rawPage, testTitle, actionCounter, elementSelectorOnly) {
     // Defensive: Proxy ctor throws "Cannot create proxy with a non-object as target"
@@ -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,24 +524,24 @@ 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";
             if (typeof prop !== "string")
                 return Reflect.get(target, prop, receiver);
             // ── Internal accessors ───────────────────────────────────
-            if (prop === "_fixwrightSelector")
+            if (prop === "_selaSelector")
                 return currentFullSelector;
-            if (prop === "_fixwrightPage")
+            if (prop === "_selaPage")
                 return rawPage;
-            if (prop === "_fixwrightTestTitle")
+            if (prop === "_selaTestTitle")
                 return testTitle;
-            if (prop === "_fixwrightActionCounter")
+            if (prop === "_selaActionCounter")
                 return actionCounter;
-            if (prop === "_fixwrightElementSelector")
+            if (prop === "_selaElementSelector")
                 return currentElementSelector;
-            if (prop === "_fixwrightUnsubscribe")
+            if (prop === "_selaUnsubscribe")
                 return unsubscribe;
             // ── getBy* ───────────────────────────────────────────────
             if (prop in GET_BY_METHODS) {
@@ -657,10 +657,25 @@ 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({
+    // ── Worker-scoped flush anchor (auto) ───────────────────────────────
+    // Setup is a no-op; the teardown after `use()` is the suite-end flush.
+    // Aggregation spans the ENTIRE worker run because commitUpdates() is no
+    // longer called per test - the report buffer, registry heal-map, and
+    // workspace snapshot accumulate across all tests and flush once here.
+    _selaWorkerLifecycle: [
+        async ({}, use) => {
+            await use();
+            // Single suite-wide commit: saves DNA snapshots, flushes the Insights
+            // report + .sela-history.json ONCE, and writes the DX-review ledger
+            // with the full set of healed events from the whole worker run.
+            await singleton_1.sharedEngine.commitUpdates();
+        },
+        { scope: "worker", auto: true },
+    ],
     page: async ({ page }, use, testInfo) => {
         page.on("console", (msg) => {
             if (msg.text().includes("[DOM-EXTRACT]")) {
@@ -672,7 +687,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";
@@ -683,7 +698,7 @@ exports.test = test_1.test.extend({
                 if (prop === "locator") {
                     return (selector) => {
                         const p = createLocatorProxy(target.locator(selector), selector, rawPage, testInfo.title, actionCounter, selector);
-                        const u = p._fixwrightUnsubscribe;
+                        const u = p._selaUnsubscribe;
                         if (u)
                             unsubscribers.push(u);
                         return p;
@@ -696,7 +711,7 @@ exports.test = test_1.test.extend({
                     return (...args) => {
                         const semanticSelector = GET_BY_METHODS[prop](args);
                         const p = createLocatorProxy(target[prop](...args), semanticSelector, rawPage, testInfo.title, actionCounter, semanticSelector);
-                        const u = p._fixwrightUnsubscribe;
+                        const u = p._selaUnsubscribe;
                         if (u)
                             unsubscribers.push(u);
                         return p;
@@ -706,15 +721,20 @@ exports.test = test_1.test.extend({
             },
         });
         await use(pageProxy);
-        // ── Teardown ─────────────────────────────────────────────────
+        // ── Per-test teardown ─────────────────────────────────────────
+        // Release this test's proxy registry subscriptions and drop per-test
+        // listeners. We deliberately DO NOT call engine.commitUpdates() here -
+        // flushing per test is what produced the per-test report writes, the
+        // duplicated .sela-history.json entries (each "healed":1), and the
+        // last-test-only DX diff. The suite-wide flush lives in the
+        // worker-scoped `_selaWorkerLifecycle` teardown above.
         for (const u of unsubscribers)
             u();
         registry.clearForTest();
-        await singleton_1.sharedEngine.commitUpdates();
     },
     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/moduleExpect.js

@@ -9,14 +9,14 @@ const singleton_js_1 = require("../engine/singleton.js");
 const expectProxy_js_1 = require("./expectProxy.js");
 const index_js_1 = require("./index.js");
 function extractPage(value) {
-    if (!value || typeof value !== 'object')
+    if (!value || typeof value !== "object")
         return null;
-    // Fixwright locator proxy exposes _fixwrightPage directly
-    const proxied = value._fixwrightPage;
+    // Sela locator proxy exposes _selaPage directly
+    const proxied = value._selaPage;
     if (proxied)
         return proxied;
     // Playwright public API: Locator.page()
-    if (typeof value.page === 'function') {
+    if (typeof value.page === "function") {
         try {
             return value.page();
         }
@@ -27,7 +27,7 @@ function extractPage(value) {
     return null;
 }
 function getCallerFile() {
-    const lines = new Error().stack?.split('\n') ?? [];
+    const lines = new Error().stack?.split("\n") ?? [];
     // Match BOTH frame shapes V8 emits:
     //   "    at fnName (D:\\path\\file.spec.ts:17:20)"
     //   "    at D:\\path\\file.spec.ts:17:20"
@@ -42,13 +42,13 @@ function getCallerFile() {
         if (m && m[1])
             return m[1].trim();
     }
-    return '';
+    return "";
 }
 function expect(value) {
     const page = extractPage(value);
     if (page) {
         const filePath = getCallerFile();
-        return (0, expectProxy_js_1.createHealingExpect)(singleton_js_1.sharedEngine, page, filePath, 0, index_js_1.resolveFixwrightProxy)(value);
+        return (0, expectProxy_js_1.createHealingExpect)(singleton_js_1.sharedEngine, page, filePath, 0, index_js_1.resolveSelaProxy)(value);
     }
     return (0, test_1.expect)(value);
 }

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).
  */

package/dist/fixtures/proxyTag.js

@@ -4,9 +4,9 @@
 // Single source of truth for the Sela proxy tag.
 //
 // Every Sela-created Proxy (locator, frame-locator, page, expect) honors a
-// `get` trap on this symbol and returns the kind string. Consumers — the
-// surface-diff test, internal helpers, debuggers — can identify Sela
-// proxies without touching the brittle "_fixwrightSelector" heuristic.
+// `get` trap on this symbol and returns the kind string. Consumers - the
+// surface-diff test, internal helpers, debuggers - can identify Sela
+// proxies without touching the brittle "_selaSelector" heuristic.
 //
 // We use Symbol.for() (a registered symbol) so the identity survives
 // across module boundaries when multiple bundles end up in the same
@@ -19,7 +19,7 @@ exports.SELA_PROXY = Symbol.for("sela.proxy");
 /**
  * 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).
  */

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-export { defineConfig } from './config/defineConfig.js';
-export type { SelaConfig, ResolvedConfig } from './config/SelaConfig.js';
-export type * from '@playwright/test';
-export { chromium, firefox, webkit, devices, selectors } from '@playwright/test';
-export { test } from './fixtures/index.js';
-export { expect } from './fixtures/moduleExpect.js';
-export { SelaReporter } from './reporter/SelaReporter.js';
-export type { SelaReporterOpts, ReporterEngine, ReporterLogger } from './reporter/SelaReporter.js';
+export { defineConfig } from "./config/defineConfig.js";
+export type { SelaConfig, ResolvedConfig } from "./config/SelaConfig.js";
+export type * from "@playwright/test";
+export { chromium, firefox, webkit, devices, selectors, } from "@playwright/test";
+export { test } from "./fixtures/index.js";
+export { expect } from "./fixtures/moduleExpect.js";
+export { SelaReporter } from "./reporter/SelaReporter.js";
+export type { SelaReporterOpts, ReporterEngine, ReporterLogger, } from "./reporter/SelaReporter.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGzE,mBAAmB,kBAAkB,CAAC;AAGtC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAIjF,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAI3C,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAKpD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGzE,mBAAmB,kBAAkB,CAAC;AAGtC,OAAO,EACL,QAAQ,EACR,OAAO,EACP,MAAM,EACN,OAAO,EACP,SAAS,GACV,MAAM,kBAAkB,CAAC;AAI1B,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAI3C,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAKpD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,YAAY,EACV,gBAAgB,EAChB,cAAc,EACd,cAAc,GACf,MAAM,4BAA4B,CAAC"}

package/dist/index.js

@@ -1,5 +1,5 @@
 "use strict";
-// sela-core — AI self-healing Playwright wrapper
+// sela-core - AI self-healing Playwright wrapper
 //
 // Drop-in replacement for @playwright/test:
 //   import { test, expect } from 'sela-core'
@@ -16,15 +16,15 @@ Object.defineProperty(exports, "firefox", { enumerable: true, get: function () {
 Object.defineProperty(exports, "webkit", { enumerable: true, get: function () { return test_1.webkit; } });
 Object.defineProperty(exports, "devices", { enumerable: true, get: function () { return test_1.devices; } });
 Object.defineProperty(exports, "selectors", { enumerable: true, get: function () { return test_1.selectors; } });
-// Sela's extended test — includes DNA capture, trace collection,
+// Sela's extended test - includes DNA capture, trace collection,
 // locator proxy, and fixture-scoped healing expect
 var index_js_1 = require("./fixtures/index.js");
 Object.defineProperty(exports, "test", { enumerable: true, get: function () { return index_js_1.test; } });
-// Sela's healing expect — works standalone (import { expect } from 'sela-core')
+// Sela's healing expect - works standalone (import { expect } from 'sela-core')
 // Detects page from locator, falls back to raw PW expect for non-locators
 var moduleExpect_js_1 = require("./fixtures/moduleExpect.js");
 Object.defineProperty(exports, "expect", { enumerable: true, get: function () { return moduleExpect_js_1.expect; } });
-// Playwright Reporter — drop into `reporter: [['sela-core/reporter']]`
+// Playwright Reporter - drop into `reporter: [['sela-core/reporter']]`
 // in playwright.config.ts to drive heal-and-report at the reporter layer
 // (safety net for worker crashes + Playwright failure screenshot capture).
 var SelaReporter_js_1 = require("./reporter/SelaReporter.js");