sela-core 0.1.0-alpha.1

package/dist/fixtures/moduleExpect.d.ts

@@ -0,0 +1,2 @@
+export declare function expect(value: unknown): any;
+//# sourceMappingURL=moduleExpect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"moduleExpect.d.ts","sourceRoot":"","sources":["../../src/fixtures/moduleExpect.ts"],"names":[],"mappings":"AA8CA,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,GAAG,CAa1C"}

package/dist/fixtures/moduleExpect.js

@@ -0,0 +1,54 @@
+"use strict";
+// Standalone module-level expect for `import { expect } from 'sela'` usage.
+// Creates a per-call healing expect using the shared engine singleton.
+// Falls back to raw Playwright expect for non-Locator values.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.expect = expect;
+const test_1 = require("@playwright/test");
+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")
+        return null;
+    // Sela locator proxy exposes _selaPage directly
+    const proxied = value._selaPage;
+    if (proxied)
+        return proxied;
+    // Playwright public API: Locator.page()
+    if (typeof value.page === "function") {
+        try {
+            return value.page();
+        }
+        catch {
+            return null;
+        }
+    }
+    return null;
+}
+function getCallerFile() {
+    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"
+    // The path may include Windows drive letters (colon after C/D/...).
+    const FRAME_WITH_PARENS = /\(([^()]+?):\d+:\d+\)\s*$/;
+    const FRAME_BARE = /\s+at\s+(.+?):\d+:\d+\s*$/;
+    for (let i = 1; i < lines.length; i++) {
+        const line = lines[i];
+        if (!/\.(spec|test)\.[jt]sx?/.test(line))
+            continue;
+        const m = line.match(FRAME_WITH_PARENS) ?? line.match(FRAME_BARE);
+        if (m && m[1])
+            return m[1].trim();
+    }
+    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.resolveSelaProxy)(value);
+    }
+    return (0, test_1.expect)(value);
+}

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 "_selaSelector" 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

@@ -0,0 +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";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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,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

@@ -0,0 +1,31 @@
+"use strict";
+// sela-core - AI self-healing Playwright wrapper
+//
+// Drop-in replacement for @playwright/test:
+//   import { test, expect } from 'sela-core'
+Object.defineProperty(exports, "__esModule", { value: true });
+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");
+Object.defineProperty(exports, "defineConfig", { enumerable: true, get: function () { return defineConfig_js_1.defineConfig; } });
+// Playwright value exports (launchers, devices, etc.)
+var test_1 = require("@playwright/test");
+Object.defineProperty(exports, "chromium", { enumerable: true, get: function () { return test_1.chromium; } });
+Object.defineProperty(exports, "firefox", { enumerable: true, get: function () { return test_1.firefox; } });
+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,
+// 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')
+// 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,165 @@
+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 PrintReviewDeps } 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 review printer. Tests stub this to assert that the
+     * reporter wires the ledger entries + HTML report path through unchanged.
+     */
+    printReview?: (deps: PrintReviewDeps) => void;
+    /**
+     * Override the resolution of the HTML report path. Returns `null` when
+     * no report exists. Defaults to `<cwd>/sela-report.html` when the file
+     * is on disk.
+     */
+    resolveReportPath?: (cwd: string) => string | null;
+    /**
+     * Override the CI detection - true means "behave as CI" (skip the
+     * post-run notify). Defaults to checking `process.env.CI`.
+     */
+    isCi?: () => boolean;
+    /**
+     * Fan in per-worker report shards into the final report (SELA-5). Tests
+     * stub this; the default discovers `<cwd>/.sela/report-shards/sela-shard-*`
+     * and merges them via ReportMergeService, then clears the shard dir.
+     */
+    mergeShards?: (cwd: string) => void;
+    /**
+     * Install process-level SIGINT/SIGTERM handlers in onBegin. Defaults
+     * to true. Tests pass `false` so vitest's own signal lifecycle isn't
+     * polluted by leftover handlers between cases.
+     */
+    installSignalHandlers?: 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 printReview;
+    private readonly resolveReportPath;
+    private readonly isCi;
+    private readonly mergeShards;
+    private readonly shouldInstallSignalHandlers;
+    private shutdownHandler;
+    private shuttingDown;
+    /** Total tests in the suite, captured at onBegin for the end-of-run summary. */
+    private totalTests;
+    /**
+     * 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;
+    /**
+     * Tally the run's outcome from the report buffer. MUST be called before
+     * commitUpdates() clears the in-memory events. "Errors detected" counts
+     * every broken selector Sela engaged (healed + held + failed); "skipped"
+     * counts heals declined by a developer fail-fast directive.
+     */
+    private collectRunSummary;
+    /**
+     * Render the summary table — but only when Sela actually did something.
+     * A run with zero detected errors prints nothing, keeping the terminal
+     * clean for the common all-green case.
+     */
+    private renderRunSummary;
+    /**
+     * Install the SIGINT/SIGTERM listener once per reporter. First signal
+     * triggers an orderly drain; second signal hard-exits with code 130
+     * (SIGINT) / 143 (SIGTERM) so the user can always escape if the drain
+     * itself wedges (e.g. a stuck LLM call).
+     */
+    private installShutdownHandler;
+    private uninstallShutdownHandler;
+    /**
+     * Best-effort drain on signal. Mirrors the orderly onEnd path but
+     * swallows every error - we never want to throw inside a signal
+     * handler because Node prints raw stack traces otherwise.
+     *
+     * Exposed for tests so they can drive the shutdown without raising
+     * a real signal in the vitest process.
+     */
+    gracefulShutdown(): Promise<void>;
+    /**
+     * 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":"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"}