sela-core 1.0.6 → 1.0.7

package/dist/errors/SelaError.js

@@ -0,0 +1,155 @@
+"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",
+    BLOCKED_SIMILARITY_FLOOR: "SG_BLOCKED_SIMILARITY_FLOOR",
+    /** 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.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

@@ -4,6 +4,7 @@ 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,
@@ -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,11 +35,14 @@ 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();
@@ -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") {
@@ -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 ───────────────────────────────────
@@ -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")

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

@@ -4,4 +4,6 @@ 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,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"}

package/dist/index.js

@@ -4,7 +4,7 @@
 // Drop-in replacement for @playwright/test:
 //   import { test, expect } from 'sela-core'
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.expect = exports.test = exports.selectors = exports.devices = exports.webkit = exports.firefox = exports.chromium = exports.defineConfig = void 0;
+exports.SelaReporter = exports.expect = exports.test = exports.selectors = exports.devices = exports.webkit = exports.firefox = exports.chromium = exports.defineConfig = void 0;
 // Config DSL exported FIRST so `sela.config.ts` can `import { defineConfig }`
 // without triggering the heavier fixtures/engine graph during config load.
 var defineConfig_js_1 = require("./config/defineConfig.js");
@@ -24,3 +24,8 @@ Object.defineProperty(exports, "test", { enumerable: true, get: function () { re
 // 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']]`
+// 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");
+Object.defineProperty(exports, "SelaReporter", { enumerable: true, get: function () { return SelaReporter_js_1.SelaReporter; } });

package/dist/reporter/SelaReporter.d.ts

@@ -0,0 +1,110 @@
+import type { Reporter, TestCase, TestResult, FullConfig, Suite, FullResult } from "@playwright/test/reporter";
+import { HealReportService } from "../services/HealReportService.js";
+import type { SelaEngine } from "../engine/SelaEngine.js";
+import { type PendingPromptEntry } from "../services/PendingPromptLedger.js";
+import { type InteractiveReviewOutcome } from "../services/InteractiveReview.js";
+export interface ReporterEngine {
+    commitUpdates(): Promise<void>;
+}
+export interface ReporterLogger {
+    info: (msg: string) => void;
+    warn: (msg: string) => void;
+    error: (msg: string) => void;
+}
+export interface SelaReporterOpts {
+    /**
+     * Skip the `ANTHROPIC_API_KEY` presence check. Tests inject this so
+     * the reporter does not surface a noisy warning when no real key is
+     * required to drive the lifecycle.
+     */
+    skipApiKeyCheck?: boolean;
+    /** Override the engine. Defaults to `sharedEngine`. */
+    engine?: ReporterEngine | SelaEngine;
+    /** Override the report buffer. Defaults to `sharedHealReport`. */
+    report?: HealReportService;
+    /** Override the logger (defaults to `console`). */
+    logger?: ReporterLogger;
+    /** Override cwd used to locate the pending-prompts ledger. Defaults to process.cwd(). */
+    cwd?: string;
+    /**
+     * Inject the ledger reader — tests stub this so they don't have to
+     * touch the real filesystem.
+     */
+    readLedger?: (cwd: string) => PendingPromptEntry[];
+    /** Inject the ledger cleaner. */
+    clearLedger?: (cwd: string) => void;
+    /**
+     * Inject the interactive review runner. Tests stub this to assert that
+     * the reporter wires the ledger entries through unchanged.
+     */
+    runReview?: (entries: PendingPromptEntry[]) => Promise<InteractiveReviewOutcome[]>;
+    /**
+     * Override the CI detection — true means "behave as CI" (skip the
+     * interactive review). Defaults to checking `process.env.CI`.
+     */
+    isCi?: () => boolean;
+}
+export declare class SelaReporter implements Reporter {
+    private readonly engine;
+    private readonly report;
+    private readonly logger;
+    private readonly skipApiKeyCheck;
+    private readonly cwd;
+    private readonly readLedger;
+    private readonly clearLedger;
+    private readonly runReview;
+    private readonly isCi;
+    /**
+     * Screenshots that arrived before a matching FailedEvent existed in
+     * the shared report. Re-flushed once at onEnd time so worker-crash
+     * scenarios (no fixture teardown ⇒ no engine-side FailedEvent yet)
+     * still get their visual context attached.
+     *
+     * Key shape: `${normalisedSourceFile}::${testTitle}`.
+     */
+    private readonly pendingScreenshots;
+    /**
+     * Mirror of the failures the reporter observed, kept so external
+     * consumers (and tests) can audit what the reporter saw without
+     * having to subscribe to the entire Playwright Reporter API.
+     */
+    private readonly failures;
+    constructor(opts?: SelaReporterOpts);
+    onBegin(_config?: FullConfig, _suite?: Suite): void;
+    onTestEnd(test: TestCase, result: TestResult): void;
+    onEnd(_result?: FullResult): Promise<void>;
+    /** Reporter prints nothing of its own — Playwright stdio stays clean. */
+    printsToStdio(): boolean;
+    /**
+     * Walk every buffered pending screenshot and try to attach it to a
+     * now-existing FailedEvent. Successfully-attached entries are
+     * removed; unmatched entries are dropped (the matching FailedEvent
+     * never arrived — most likely worker crashed before the engine
+     * could record one).
+     *
+     * Returns the number of FailedEvents touched.
+     */
+    flushPendingScreenshots(): number;
+    /** Test hook — read-only snapshot of recorded failures. */
+    getRecordedFailures(): ReadonlyArray<{
+        sourceFile: string;
+        sourceLine?: number;
+        testTitle: string;
+        status: string;
+        hasScreenshot: boolean;
+    }>;
+    /** Test hook — number of screenshots still waiting for a FailedEvent. */
+    getPendingScreenshotCount(): number;
+    private pendingKey;
+    private normalisePath;
+    /**
+     * Convert the first PNG attachment on a TestResult into a Base64
+     * string immediately. Prefers an in-memory `body` when Playwright
+     * already inlined the bytes (faster, no IO); falls back to reading
+     * the attachment `path` synchronously BEFORE Playwright has a chance
+     * to clean up its temp folder.
+     */
+    private extractScreenshotBase64;
+}
+export default SelaReporter;
+//# sourceMappingURL=SelaReporter.d.ts.map

package/dist/reporter/SelaReporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SelaReporter.d.ts","sourceRoot":"","sources":["../../src/reporter/SelaReporter.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EACV,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,UAAU,EACV,KAAK,EACL,UAAU,EACX,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAEL,iBAAiB,EAElB,MAAM,kCAAkC,CAAC;AAE1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1D,OAAO,EAGL,KAAK,kBAAkB,EACxB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,kCAAkC,CAAC;AAO1C,MAAM,WAAW,cAAc;IAC7B,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,uDAAuD;IACvD,MAAM,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC;IACrC,kEAAkE;IAClE,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,mDAAmD;IACnD,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,yFAAyF;IACzF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,kBAAkB,EAAE,CAAC;IACnD,iCAAiC;IACjC,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,kBAAkB,EAAE,KAAK,OAAO,CAAC,wBAAwB,EAAE,CAAC,CAAC;IACnF;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,OAAO,CAAC;CACtB;AAMD,qBAAa,YAAa,YAAW,QAAQ;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoB;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAU;IAC1C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAwC;IACnE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAwB;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAEe;IACzC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgB;IAErC;;;;;;;OAOG;IACH,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA6B;IAEhE;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAMjB;gBAEI,IAAI,GAAE,gBAAqB;IAsBvC,OAAO,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,KAAK,GAAG,IAAI;IAOnD,SAAS,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI;IAmC7C,KAAK,CAAC,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAkEhD,yEAAyE;IACzE,aAAa,IAAI,OAAO;IASxB;;;;;;;;OAQG;IACH,uBAAuB,IAAI,MAAM;IAsBjC,2DAA2D;IAC3D,mBAAmB,IAAI,aAAa,CAAC;QACnC,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,aAAa,EAAE,OAAO,CAAC;KACxB,CAAC;IAIF,yEAAyE;IACzE,yBAAyB,IAAI,MAAM;IAQnC,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,aAAa;IAWrB;;;;;;OAMG;IACH,OAAO,CAAC,uBAAuB;CA6BhC;AAgBD,eAAe,YAAY,CAAC"}