sela-core 1.0.6 → 1.0.8

package/dist/errors/SelaError.d.ts

@@ -0,0 +1,132 @@
+export type SelaSubsystem = "SafetyGuard" | "IntentAuditor" | "ASTUpdater" | "Proxy" | "LLMService" | "Registry" | "ChainValidator" | "Engine" | "Report";
+export interface SelaErrorContext {
+    filePath?: string;
+    line?: number;
+    column?: number;
+    selector?: string;
+    healedSelector?: string;
+    stableId?: string;
+    testTitle?: string;
+    testFile?: string;
+    branch?: string;
+    /** SafetyGuard verdict level when the error originated in SafetyGuard. */
+    safetyLevel?: "BLOCKED" | "FAIL_HARD" | "REQUIRES_REVIEW" | "SAFE";
+    /** Auditor verdict surfaced in the context for SafetyGuard rejections. */
+    auditorVerdict?: "CONSISTENT" | "INCONSISTENT" | "SUSPICIOUS";
+    /** Raw + adjusted LLM confidence so downstream telemetry can plot drift. */
+    aiConfidence?: number;
+    auditorConfidence?: number;
+    /** Free-form extension slot. Prefer adding a named field above when possible. */
+    [key: string]: unknown;
+}
+export interface SelaErrorJSON {
+    name: string;
+    subsystem: SelaSubsystem;
+    code: string;
+    reason: string;
+    message: string;
+    context: SelaErrorContext;
+    stack?: string;
+    cause?: string;
+}
+export interface SelaErrorInit {
+    subsystem: SelaSubsystem;
+    /**
+     * Stable machine-readable error code. Must match `[A-Z][A-Z0-9_]+`.
+     * Recommended convention: short subsystem-prefix + verb/noun.
+     * See SELA_ERROR_CODES below for the canonical catalogue.
+     */
+    code: string;
+    /** Human-readable explanation. Becomes the tail of the formatted message. */
+    reason: string;
+    context?: SelaErrorContext;
+    /** Original error wrapped by this SelaError, if any. */
+    cause?: unknown;
+}
+export declare class SelaError extends Error {
+    readonly subsystem: SelaSubsystem;
+    readonly code: string;
+    readonly reason: string;
+    readonly context: SelaErrorContext;
+    constructor(init: SelaErrorInit);
+    static formatMessage(subsystem: SelaSubsystem, code: string, reason: string): string;
+    toJSON(): SelaErrorJSON;
+}
+export declare function isSelaError(err: unknown): err is SelaError;
+export declare function isSelaErrorFrom(err: unknown, subsystem: SelaSubsystem): err is SelaError;
+export declare const SAFETY_GUARD_CODES: {
+    readonly FAIL_HARD_VISIBILITY_GHOST: "SG_FAIL_HARD_VISIBILITY_GHOST";
+    readonly FAIL_HARD_VISIBILITY_OCCLUDED: "SG_FAIL_HARD_VISIBILITY_OCCLUDED";
+    readonly BLOCKED_LOW_CONFIDENCE: "SG_BLOCKED_LOW_CONFIDENCE";
+    readonly FAIL_HARD_SEMANTIC_INVERSION: "SG_FAIL_HARD_SEMANTIC_INVERSION";
+    readonly FAIL_HARD_STATUS_INVERSION: "SG_FAIL_HARD_STATUS_INVERSION";
+    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";
+    /** Generic dispatcher when SafetyDecision arrives without an explicit code. */
+    readonly GENERIC_REJECTION: "SG_GENERIC_REJECTION";
+};
+export type SafetyGuardCode = (typeof SAFETY_GUARD_CODES)[keyof typeof SAFETY_GUARD_CODES];
+export declare const INTENT_AUDITOR_CODES: {
+    /** Caller asked for an audit but no Anthropic client was configured. */
+    readonly DISABLED: "IA_DISABLED";
+    readonly INVALID_JSON: "IA_INVALID_JSON";
+    readonly CALL_FAILED: "IA_CALL_FAILED";
+};
+export type IntentAuditorCode = (typeof INTENT_AUDITOR_CODES)[keyof typeof INTENT_AUDITOR_CODES];
+export declare const LLM_SERVICE_CODES: {
+    readonly NO_API_KEY: "LLM_NO_API_KEY";
+    readonly INVALID_JSON: "LLM_INVALID_JSON";
+    readonly MISSING_SEGMENTS: "LLM_MISSING_SEGMENTS";
+    readonly NOT_FOUND: "LLM_NOT_FOUND";
+    readonly API_CALL_FAILED: "LLM_API_CALL_FAILED";
+};
+export type LLMServiceCode = (typeof LLM_SERVICE_CODES)[keyof typeof LLM_SERVICE_CODES];
+export declare const AST_UPDATER_CODES: {
+    readonly UNSUPPORTED_NODE: "AST_UNSUPPORTED_NODE";
+    readonly TEMPLATE_LITERAL_SKIP: "AST_TEMPLATE_LITERAL_SKIP";
+    readonly CIRCULAR_RECEIVER: "AST_CIRCULAR_RECEIVER";
+    readonly DEFINITION_NOT_FOUND: "AST_DEFINITION_NOT_FOUND";
+    readonly MAX_DEPTH_EXCEEDED: "AST_MAX_DEPTH_EXCEEDED";
+    readonly SAVE_FAILED: "AST_SAVE_FAILED";
+    /**
+     * Developer pinned the failing statement with `// sela-fail-fast`.
+     * Heal pipeline is aborted before any LLM call; FailedEvent is
+     * recorded with category "Skipped by Developer".
+     */
+    readonly HEAL_DISABLED_BY_DIRECTIVE: "AST_HEAL_DISABLED_BY_DIRECTIVE";
+};
+export type ASTUpdaterCode = (typeof AST_UPDATER_CODES)[keyof typeof AST_UPDATER_CODES];
+export declare const PROXY_CODES: {
+    readonly FRAME_SCOPED: "PRX_FRAME_SCOPED";
+    readonly REBUILD_FAILED: "PRX_REBUILD_FAILED";
+    readonly NON_LOCATOR_TARGET: "PRX_NON_LOCATOR_TARGET";
+};
+export type ProxyCode = (typeof PROXY_CODES)[keyof typeof PROXY_CODES];
+export declare const REGISTRY_CODES: {
+    readonly CONTEXT_MISMATCH: "REG_CONTEXT_MISMATCH";
+    readonly FINGERPRINT_COLLISION: "REG_FINGERPRINT_COLLISION";
+};
+export type RegistryCode = (typeof REGISTRY_CODES)[keyof typeof REGISTRY_CODES];
+export declare const REPORT_CODES: {
+    /** Event passed to the validator was null, undefined, or not an object. */
+    readonly MALFORMED_EVENT: "REP_MALFORMED_EVENT";
+    /** Event.kind is not one of HEALED|FAILED|PROTECTED. */
+    readonly UNKNOWN_KIND: "REP_UNKNOWN_KIND";
+    /** Event is missing a field declared mandatory for its kind. */
+    readonly MISSING_FIELD: "REP_MISSING_FIELD";
+    /** Event contains a field of the wrong type. */
+    readonly INVALID_FIELD_TYPE: "REP_INVALID_FIELD_TYPE";
+    /** Disk write failed during flushToDisk(). */
+    readonly FLUSH_FAILED: "REP_FLUSH_FAILED";
+};
+export type ReportCode = (typeof REPORT_CODES)[keyof typeof REPORT_CODES];
+export declare const CHAIN_VALIDATOR_CODES: {
+    readonly TYPE_FLOW: "CV_TYPE_FLOW";
+    readonly SCHEMA: "CV_SCHEMA";
+    readonly RECEIVER: "CV_RECEIVER";
+    readonly PLACEMENT: "CV_PLACEMENT";
+    readonly SEMANTIC_DOWNGRADE: "CV_SEMANTIC_DOWNGRADE";
+};
+export type ChainValidatorCode = (typeof CHAIN_VALIDATOR_CODES)[keyof typeof CHAIN_VALIDATOR_CODES];
+//# sourceMappingURL=SelaError.d.ts.map

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

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

package/dist/errors/SelaError.js

@@ -0,0 +1,154 @@
+"use strict";
+// src/errors/SelaError.ts
+//
+// Structured error hierarchy for Sela.
+//
+// Every error thrown across the heal pipeline MUST be a SelaError so that:
+//   1. Callers can branch on `err.subsystem` and `err.code` without
+//      string-parsing `err.message`.
+//   2. Telemetry / report layers get a machine-readable JSON shape.
+//   3. The canonical message format is enforced by the constructor and
+//      cannot drift over time:  `[Sela-<Subsystem>] <CODE>: <reason>`
+//
+// Public message regex (used by tests/unit/engine/error-indicativity.test.ts):
+//   /^\[Sela-(SafetyGuard|IntentAuditor|ASTUpdater|Proxy|LLMService|Registry|ChainValidator|Engine)\] [A-Z][A-Z0-9_]+: .+$/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CHAIN_VALIDATOR_CODES = exports.REPORT_CODES = exports.REGISTRY_CODES = exports.PROXY_CODES = exports.AST_UPDATER_CODES = exports.LLM_SERVICE_CODES = exports.INTENT_AUDITOR_CODES = exports.SAFETY_GUARD_CODES = exports.SelaError = void 0;
+exports.isSelaError = isSelaError;
+exports.isSelaErrorFrom = isSelaErrorFrom;
+// ───────────────────────────────────────────────────────────────────
+// 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
+// surface area tiny.
+// ───────────────────────────────────────────────────────────────────
+const CODE_PATTERN = /^[A-Z][A-Z0-9_]+$/;
+class SelaError extends Error {
+    subsystem;
+    code;
+    reason;
+    context;
+    constructor(init) {
+        if (!CODE_PATTERN.test(init.code)) {
+            throw new Error(`[SelaError] invalid code "${init.code}" - must match ${CODE_PATTERN}`);
+        }
+        const formatted = SelaError.formatMessage(init.subsystem, init.code, init.reason);
+        super(formatted);
+        this.name = `SelaError(${init.subsystem})`;
+        this.subsystem = init.subsystem;
+        this.code = init.code;
+        this.reason = init.reason;
+        this.context = init.context ?? {};
+        if (init.cause !== undefined) {
+            this.cause = init.cause;
+        }
+        // Maintain prototype chain through transpilation (ES5 target).
+        Object.setPrototypeOf(this, new.target.prototype);
+        if (typeof Error.captureStackTrace ===
+            "function") {
+            Error.captureStackTrace(this, new.target);
+        }
+    }
+    static formatMessage(subsystem, code, reason) {
+        return `[Sela-${subsystem}] ${code}: ${reason}`;
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            subsystem: this.subsystem,
+            code: this.code,
+            reason: this.reason,
+            message: this.message,
+            context: this.context,
+            stack: this.stack,
+            cause: this.cause instanceof Error
+                ? this.cause.message
+                : undefined,
+        };
+    }
+}
+exports.SelaError = SelaError;
+// ───────────────────────────────────────────────────────────────────
+// Type guards
+// ───────────────────────────────────────────────────────────────────
+function isSelaError(err) {
+    return err instanceof SelaError;
+}
+function isSelaErrorFrom(err, subsystem) {
+    return err instanceof SelaError && err.subsystem === subsystem;
+}
+// ───────────────────────────────────────────────────────────────────
+// Canonical code catalogue
+//
+// 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.
+// ───────────────────────────────────────────────────────────────────
+exports.SAFETY_GUARD_CODES = {
+    FAIL_HARD_VISIBILITY_GHOST: "SG_FAIL_HARD_VISIBILITY_GHOST",
+    FAIL_HARD_VISIBILITY_OCCLUDED: "SG_FAIL_HARD_VISIBILITY_OCCLUDED",
+    BLOCKED_LOW_CONFIDENCE: "SG_BLOCKED_LOW_CONFIDENCE",
+    FAIL_HARD_SEMANTIC_INVERSION: "SG_FAIL_HARD_SEMANTIC_INVERSION",
+    FAIL_HARD_STATUS_INVERSION: "SG_FAIL_HARD_STATUS_INVERSION",
+    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",
+    /** Generic dispatcher when SafetyDecision arrives without an explicit code. */
+    GENERIC_REJECTION: "SG_GENERIC_REJECTION",
+};
+exports.INTENT_AUDITOR_CODES = {
+    /** Caller asked for an audit but no Anthropic client was configured. */
+    DISABLED: "IA_DISABLED",
+    INVALID_JSON: "IA_INVALID_JSON",
+    CALL_FAILED: "IA_CALL_FAILED",
+};
+exports.LLM_SERVICE_CODES = {
+    NO_API_KEY: "LLM_NO_API_KEY",
+    INVALID_JSON: "LLM_INVALID_JSON",
+    MISSING_SEGMENTS: "LLM_MISSING_SEGMENTS",
+    NOT_FOUND: "LLM_NOT_FOUND",
+    API_CALL_FAILED: "LLM_API_CALL_FAILED",
+};
+exports.AST_UPDATER_CODES = {
+    UNSUPPORTED_NODE: "AST_UNSUPPORTED_NODE",
+    TEMPLATE_LITERAL_SKIP: "AST_TEMPLATE_LITERAL_SKIP",
+    CIRCULAR_RECEIVER: "AST_CIRCULAR_RECEIVER",
+    DEFINITION_NOT_FOUND: "AST_DEFINITION_NOT_FOUND",
+    MAX_DEPTH_EXCEEDED: "AST_MAX_DEPTH_EXCEEDED",
+    SAVE_FAILED: "AST_SAVE_FAILED",
+    /**
+     * Developer pinned the failing statement with `// sela-fail-fast`.
+     * Heal pipeline is aborted before any LLM call; FailedEvent is
+     * recorded with category "Skipped by Developer".
+     */
+    HEAL_DISABLED_BY_DIRECTIVE: "AST_HEAL_DISABLED_BY_DIRECTIVE",
+};
+exports.PROXY_CODES = {
+    FRAME_SCOPED: "PRX_FRAME_SCOPED",
+    REBUILD_FAILED: "PRX_REBUILD_FAILED",
+    NON_LOCATOR_TARGET: "PRX_NON_LOCATOR_TARGET",
+};
+exports.REGISTRY_CODES = {
+    CONTEXT_MISMATCH: "REG_CONTEXT_MISMATCH",
+    FINGERPRINT_COLLISION: "REG_FINGERPRINT_COLLISION",
+};
+exports.REPORT_CODES = {
+    /** Event passed to the validator was null, undefined, or not an object. */
+    MALFORMED_EVENT: "REP_MALFORMED_EVENT",
+    /** Event.kind is not one of HEALED|FAILED|PROTECTED. */
+    UNKNOWN_KIND: "REP_UNKNOWN_KIND",
+    /** Event is missing a field declared mandatory for its kind. */
+    MISSING_FIELD: "REP_MISSING_FIELD",
+    /** Event contains a field of the wrong type. */
+    INVALID_FIELD_TYPE: "REP_INVALID_FIELD_TYPE",
+    /** Disk write failed during flushToDisk(). */
+    FLUSH_FAILED: "REP_FLUSH_FAILED",
+};
+exports.CHAIN_VALIDATOR_CODES = {
+    TYPE_FLOW: "CV_TYPE_FLOW",
+    SCHEMA: "CV_SCHEMA",
+    RECEIVER: "CV_RECEIVER",
+    PLACEMENT: "CV_PLACEMENT",
+    SEMANTIC_DOWNGRADE: "CV_SEMANTIC_DOWNGRADE",
+};

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.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"expectProxy.d.ts","sourceRoot":"","sources":["../../src/fixtures/expectProxy.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,OAAO,EAER,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAgOlD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,OAAO,kBAAkB,EAAE,IAAI,EACrC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EAAE,6CAA6C;AAClE,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,GAAG,IAAI,GAChD,CAAC,cAAc,EAAE,OAAO,KAAK,GAAG,CAiElC"}
+{"version":3,"file":"expectProxy.d.ts","sourceRoot":"","sources":["../../src/fixtures/expectProxy.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,OAAO,EAER,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAiOlD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,OAAO,kBAAkB,EAAE,IAAI,EACrC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EAAE,6CAA6C;AAClE,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,GAAG,IAAI,GAChD,CAAC,cAAc,EAAE,OAAO,KAAK,GAAG,CAsElC"}

package/dist/fixtures/expectProxy.js

@@ -1,9 +1,10 @@
 "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");
 const HealingRegistry_1 = require("../engine/HealingRegistry");
+const proxyTag_1 = require("./proxyTag");
 const ELEMENT_NOT_FOUND_PATTERNS = [
     /element.*not found/i,
     /locator.*resolved to.*\d+ element/i,
@@ -16,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.
@@ -30,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;
@@ -62,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
@@ -127,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")
@@ -181,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
@@ -203,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);
@@ -216,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;
         }
@@ -225,6 +226,12 @@ resolveProxy) {
         const ctx = { filePath, line: actualLine };
         const proxy = new Proxy(base, {
             get(target, prop) {
+                // 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";
+                if (typeof prop !== "string")
+                    return target[prop];
                 const val = target[prop];
                 if (typeof val === "function" &&
                     WRAPPED_MATCHERS.includes(prop)) {

package/dist/fixtures/index.d.ts

@@ -1,6 +1,12 @@
-import { Locator } from "@playwright/test";
+import { Locator, Page } from "@playwright/test";
 import { createHealingExpect } from "./expectProxy";
 export declare function resolveFixwrightProxy(value: unknown): Locator | null;
+export declare function createFrameLocatorProxy(rawFrameLocator: any, frameSelector: string, rawPage: Page, testTitle: string, actionCounter: {
+    value: number;
+}, parentChain: string): any;
+export declare function createLocatorProxy(rawLocator: Locator, selector: string, rawPage: Page, testTitle: string, actionCounter: {
+    value: number;
+}, 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>;

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,EAAQ,MAAM,kBAAkB,CAAC;AAI/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAWpD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI,CAIpE;AAi3BD,eAAO,MAAM,IAAI;YACP,UAAU,CAAC,OAAO,mBAAmB,CAAC;wGA+F9C,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,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"}

package/dist/fixtures/index.js

@@ -35,16 +35,19 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createHealingExpect = exports.test = void 0;
 exports.resolveFixwrightProxy = resolveFixwrightProxy;
+exports.createFrameLocatorProxy = createFrameLocatorProxy;
+exports.createLocatorProxy = createLocatorProxy;
 const test_1 = require("@playwright/test");
 const StackUtils_1 = require("../utils/StackUtils");
 const HealingRegistry_1 = require("../engine/HealingRegistry");
 const singleton_1 = require("../engine/singleton");
 const expectProxy_1 = require("./expectProxy");
+const proxyTag_1 = require("./proxyTag");
 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) {
@@ -154,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
@@ -237,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)
@@ -247,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) {
@@ -448,6 +451,10 @@ 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
+            // symbol probes from tests / debuggers return the kind tag.
+            if (fProp === proxyTag_1.SELA_PROXY)
+                return "framelocator";
             if (typeof fProp !== "string")
                 return Reflect.get(fTarget, fProp);
             if (fProp === "frameLocator") {
@@ -461,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) {
@@ -487,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) => {
         // בדיקה אם הסלקטור הנוכחי מכיל את הישן או שהוא הישן בעצמו
@@ -517,6 +524,10 @@ 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
+            // 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 ───────────────────────────────────
@@ -646,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) => {
@@ -661,6 +672,10 @@ 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
+                // can reliably detect a Sela page proxy via Symbol.for("sela.proxy").
+                if (prop === proxyTag_1.SELA_PROXY)
+                    return "page";
                 if (prop === "_rawPage")
                     return target;
                 if (typeof prop !== "string")
@@ -699,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

@@ -0,0 +1,12 @@
+export declare const SELA_PROXY: unique symbol;
+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
+ * solely on the `SELA_PROXY` symbol contract. Always safe to call on
+ * arbitrary values (null/undefined/primitive → null).
+ */
+export declare function selaProxyKind(v: unknown): SelaProxyKind | null;
+export declare function isSelaProxy(v: unknown, kind?: SelaProxyKind): boolean;
+//# sourceMappingURL=proxyTag.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"proxyTag.d.ts","sourceRoot":"","sources":["../../src/fixtures/proxyTag.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,UAAU,eAA2B,CAAC;AAEnD,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,cAAc,GAAG,MAAM,GAAG,QAAQ,CAAC;AAE3E;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,GAAG,aAAa,GAAG,IAAI,CAa9D;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAIrE"}

package/dist/fixtures/proxyTag.js

@@ -0,0 +1,45 @@
+"use strict";
+// src/fixtures/proxyTag.ts
+//
+// 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.
+//
+// We use Symbol.for() (a registered symbol) so the identity survives
+// across module boundaries when multiple bundles end up in the same
+// process (vitest worker pools, side-loaded fixtures, etc.).
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SELA_PROXY = void 0;
+exports.selaProxyKind = selaProxyKind;
+exports.isSelaProxy = isSelaProxy;
+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
+ * solely on the `SELA_PROXY` symbol contract. Always safe to call on
+ * arbitrary values (null/undefined/primitive → null).
+ */
+function selaProxyKind(v) {
+    if (v === null || v === undefined)
+        return null;
+    if (typeof v !== "object" && typeof v !== "function")
+        return null;
+    const tag = v[exports.SELA_PROXY];
+    if (tag === "locator" ||
+        tag === "framelocator" ||
+        tag === "page" ||
+        tag === "expect") {
+        return tag;
+    }
+    return null;
+}
+function isSelaProxy(v, kind) {
+    const k = selaProxyKind(v);
+    if (k === null)
+        return false;
+    return kind === undefined ? true : k === kind;
+}

package/dist/index.d.ts

@@ -1,7 +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 { 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"}
+{"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"}