sela-core 0.1.0-alpha.34 → 0.1.0-alpha.36

package/dist/cli/commands/init.d.ts

@@ -1,3 +1,15 @@
 import { Command } from "commander";
+export interface InitOptions {
+    updateImports?: boolean;
+    /** Skip the conventions auto-discovery wizard. */
+    conventions?: boolean;
+    /** Enable the optional LLM polish step (Commander: --no-llm sets false). */
+    llm?: boolean;
+    yes?: boolean;
+    dryRun?: boolean;
+    glob?: string;
+    maxFiles?: string;
+    fileTimeout?: string;
+}
 export declare function registerInit(program: Command): void;
 //# sourceMappingURL=init.d.ts.map

package/dist/cli/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6BpC,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAWnD"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA8BpC,MAAM,WAAW,WAAW;IAC1B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kDAAkD;IAClD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,4EAA4E;IAC5E,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAoBnD"}

package/dist/cli/commands/init.js

@@ -37,6 +37,7 @@ exports.registerInit = registerInit;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const logger_js_1 = require("../../utils/logger.js");
+const conventionsInit_js_1 = require("../conventionsInit.js");
 const PACKAGE_NAME = "sela-core";
 const CONFIG_TEMPLATE_TS = `import { defineConfig } from '${PACKAGE_NAME}';
 
@@ -60,8 +61,15 @@ const REQUIRED_ENV_VARS = ["ANTHROPIC_API_KEY"];
 function registerInit(program) {
     program
         .command("init")
-        .description("Initialize Sela in the current project")
+        .description("Initialize Sela and auto-discover your testing conventions")
         .option("--no-update-imports", "Skip swapping @playwright/test imports to sela-core")
+        .option("--no-conventions", "Skip the conventions auto-discovery wizard")
+        .option("--no-llm", "Skip the optional Claude refinement step")
+        .option("-y, --yes", "Accept defaults (smart discovery + write)")
+        .option("--dry-run", "Print conventions to stdout without writing")
+        .option("--glob <pattern>", "Scan files matching this glob (non-interactive)")
+        .option("--max-files <n>", "Hard cap on files scanned")
+        .option("--file-timeout <ms>", "Per-file analysis budget (ms)")
         .action(async (opts) => {
         await runInit(opts);
     });
@@ -106,6 +114,18 @@ async function runInit(opts) {
     }
     logger_js_1.logger.info(`\nSpec files should import from:`);
     logger_js_1.logger.info(`   import { test, expect } from '${PACKAGE_NAME}'\n`);
+    // ── Conventions auto-discovery (default ON; opt out --no-conventions) ──
+    if (opts.conventions !== false) {
+        logger_js_1.logger.info(`Discovering testing conventions…`);
+        await (0, conventionsInit_js_1.runConventionsWizard)(cwd, {
+            llm: opts.llm,
+            yes: opts.yes,
+            dryRun: opts.dryRun,
+            glob: opts.glob,
+            maxFiles: opts.maxFiles ? Number(opts.maxFiles) : undefined,
+            fileTimeoutMs: opts.fileTimeout ? Number(opts.fileTimeout) : undefined,
+        });
+    }
 }
 function loadDotEnv(cwd) {
     const envPath = path.join(cwd, ".env");

package/dist/cli/commands/pr.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pr.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/pr.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAczC;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CA+EhD"}
+{"version":3,"file":"pr.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/pr.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAczC;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAsEhD"}

package/dist/cli/commands/pr.js

@@ -34,7 +34,6 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerPr = registerPr;
-const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const PendingPromptLedger_js_1 = require("../../services/PendingPromptLedger.js");
 const SelaReporter_js_1 = require("../../reporter/SelaReporter.js");
@@ -76,20 +75,12 @@ function registerPr(parent) {
         // The aggregator machine checked out the original (broken) source files
         // and never ran tests itself, so we must physically write the patched
         // code here — otherwise git sees 0 mutations and skips the PR entirely.
-        const entries = (0, PendingPromptLedger_js_1.readLedgerEntriesFromDir)(resolvedLedgerDir);
-        let patchedCount = 0;
-        for (const entry of entries) {
-            // Use relativePath so the patch lands correctly on this machine
-            // regardless of the absolute path the worker recorded.
-            const targetPath = path.resolve(opts.cwd, entry.relativePath);
-            try {
-                fs.writeFileSync(targetPath, entry.contentAfter, "utf8");
-                patchedCount++;
-            }
-            catch (err) {
-                console.error(`[sela pr aggregate] Failed to patch ${targetPath}: ${err instanceof Error ? err.message : String(err)}`);
-            }
-        }
+        //
+        // mergeLedgerEntriesByFile applies each shard's granular patches
+        // sequentially against the shared baseline so ALL shards' fixes are
+        // preserved (no last-write-wins clobber). Falls back to contentAfter
+        // blob for legacy ledgers that predate the patches field.
+        const patchedCount = await (0, PendingPromptLedger_js_1.mergeLedgerEntriesByFile)(resolvedLedgerDir, opts.cwd);
         if (patchedCount === 0) {
             console.error("[sela pr aggregate] No source patches could be applied to disk — skipping PR.");
             return;

package/dist/cli/commands/shadowRegression.d.ts

@@ -0,0 +1,21 @@
+import type { Command } from "commander";
+import type { RegressionResult } from "../../services/ReportGenerator.js";
+/**
+ * `sela shadow-regression --manifest <path>`
+ *
+ * Job 2 of the stateless shadow-regression flow. Reads the manifest emitted by
+ * Job 1, re-runs the affected specs with the proposed shared-locator heal hot-
+ * swapped into memory (SELA_REGRESSION_ACTIVE), parses Playwright's JSON
+ * report, and merges a PASSED/FAILED verdict into the existing sela-report.
+ * Zero source-code mutation — the heal lives only in execution memory.
+ *
+ * Exit code: 1 when the regression FAILS (downstream side-effects), else 0.
+ */
+export declare function registerShadowRegression(program: Command): void;
+/**
+ * Flatten a Playwright JSON report into RegressionResult[], walking nested
+ * suites. A spec is FAILED when `ok` is false; the first failing result's error
+ * (message + stack, ANSI-stripped) is attached for the report drilldown.
+ */
+export declare function collectResults(report: any): RegressionResult[];
+//# sourceMappingURL=shadowRegression.d.ts.map

package/dist/cli/commands/shadowRegression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadowRegression.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/shadowRegression.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOzC,OAAO,KAAK,EACV,gBAAgB,EAEjB,MAAM,mCAAmC,CAAC;AAe3C;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgI/D;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,GAAG,GAAG,gBAAgB,EAAE,CAqC9D"}

package/dist/cli/commands/shadowRegression.js

@@ -0,0 +1,193 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerShadowRegression = registerShadowRegression;
+exports.collectResults = collectResults;
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+const RegressionManifestService_js_1 = require("../../services/RegressionManifestService.js");
+const HealReportService_js_1 = require("../../services/HealReportService.js");
+// eslint-disable-next-line no-control-regex
+const ANSI = /\[[0-9;]*m/g;
+function stripAnsi(s) {
+    return s.replace(ANSI, "");
+}
+/**
+ * `sela shadow-regression --manifest <path>`
+ *
+ * Job 2 of the stateless shadow-regression flow. Reads the manifest emitted by
+ * Job 1, re-runs the affected specs with the proposed shared-locator heal hot-
+ * swapped into memory (SELA_REGRESSION_ACTIVE), parses Playwright's JSON
+ * report, and merges a PASSED/FAILED verdict into the existing sela-report.
+ * Zero source-code mutation — the heal lives only in execution memory.
+ *
+ * Exit code: 1 when the regression FAILS (downstream side-effects), else 0.
+ */
+function registerShadowRegression(program) {
+    program
+        .command("shadow-regression")
+        .description("Verify a bypassed shared-locator heal against its downstream blast radius " +
+        "(stateless, in-memory, zero disk mutation)")
+        .requiredOption("--manifest <path>", "Path to sela-regression-manifest.json (emitted by the primary run)")
+        .option("--dir <path>", "Project dir holding sela-report.json (merge target)", process.cwd())
+        .option("--config <path>", "Playwright config to pass through to the run")
+        .option("--report <path>", "Override path to the base sela-report.json to merge into")
+        .action(async (opts) => {
+        const targetDir = path.resolve(opts.dir ?? process.cwd());
+        const manifestAbs = path.isAbsolute(opts.manifest)
+            ? opts.manifest
+            : path.resolve(process.cwd(), opts.manifest);
+        // 1. Load + validate the manifest (throws loudly on bad input).
+        let manifest;
+        try {
+            manifest = RegressionManifestService_js_1.RegressionManifestService.readManifest(manifestAbs);
+        }
+        catch (err) {
+            process.stderr.write(`[sela] ${err.message}\n`);
+            process.exit(1);
+            return;
+        }
+        if (manifest.records.length === 0) {
+            process.stdout.write("[sela] Manifest has no bypassed locators — nothing to verify.\n");
+            return;
+        }
+        // 2. Union of affected spec files across all records (dedup).
+        const affectedFiles = Array.from(new Set(manifest.records.flatMap((r) => r.affectedFiles)));
+        if (affectedFiles.length === 0) {
+            process.stdout.write("[sela] No affected files in manifest — nothing to re-run.\n");
+            return;
+        }
+        // 3. Run Playwright over the affected files with the JSON reporter and
+        //    the injection env active. JSON goes to a temp file via
+        //    PLAYWRIGHT_JSON_OUTPUT_NAME so stdout stays clean.
+        const tmpJson = path.join(fs.mkdtempSync(path.join(os.tmpdir(), "sela-shadow-")), "pw-report.json");
+        const pwArgs = ["playwright", "test", ...affectedFiles, "--reporter=json"];
+        if (opts.config)
+            pwArgs.push(`--config=${opts.config}`);
+        process.stdout.write(`[sela] Shadow regression: re-running ${affectedFiles.length} affected ` +
+            `spec file(s) with ${manifest.records.length} injected heal(s)…\n`);
+        const run = (0, child_process_1.spawnSync)("npx", pwArgs, {
+            cwd: targetDir,
+            shell: true,
+            env: {
+                ...process.env,
+                SELA_REGRESSION_ACTIVE: "true",
+                SELA_REGRESSION_MANIFEST: manifestAbs,
+                PLAYWRIGHT_JSON_OUTPUT_NAME: tmpJson,
+            },
+            encoding: "utf8",
+            maxBuffer: 64 * 1024 * 1024,
+        });
+        // 4. Parse the JSON report → RegressionResult[].
+        let pwReport;
+        try {
+            pwReport = JSON.parse(fs.readFileSync(tmpJson, "utf8"));
+        }
+        catch (err) {
+            process.stderr.write(`[sela] Could not read Playwright JSON report (${tmpJson}): ${err.message}\n`);
+            if (run.stderr)
+                process.stderr.write(run.stderr.toString());
+            process.exit(1);
+            return;
+        }
+        const regressionTests = collectResults(pwReport);
+        const regressionState = regressionTests.some((t) => t.status === "FAILED")
+            ? "FAILURE"
+            : "SUCCESS";
+        // 5. Merge the verdict into the report + regenerate the dashboard.
+        let htmlPath;
+        try {
+            htmlPath = (0, HealReportService_js_1.mergeRegressionIntoReport)(targetDir, { regressionState, regressionTests }, { reportJsonPath: opts.report });
+        }
+        catch (err) {
+            process.stderr.write(`[sela] Report merge failed: ${err.message}\n`);
+            process.exit(1);
+            return;
+        }
+        const passN = regressionTests.filter((t) => t.status === "PASSED").length;
+        const failN = regressionTests.filter((t) => t.status === "FAILED").length;
+        process.stdout.write(`[sela] Regression ${regressionState}: ${passN} passed · ${failN} failed.\n` +
+            `       Report updated: ${path.relative(process.cwd(), htmlPath)}\n`);
+        // FAILURE = the proposed fix breaks downstream tests → fail the CI job.
+        process.exit(regressionState === "FAILURE" ? 1 : 0);
+    });
+}
+/**
+ * Flatten a Playwright JSON report into RegressionResult[], walking nested
+ * suites. A spec is FAILED when `ok` is false; the first failing result's error
+ * (message + stack, ANSI-stripped) is attached for the report drilldown.
+ */
+function collectResults(report) {
+    const out = [];
+    const walk = (suite, fileFallback) => {
+        const file = suite?.file ?? fileFallback;
+        for (const spec of suite?.specs ?? []) {
+            const specFile = spec.file ?? file ?? "";
+            const ok = spec.ok !== false;
+            let error;
+            if (!ok) {
+                for (const t of spec.tests ?? []) {
+                    for (const r of t.results ?? []) {
+                        if (r.status === "passed" || r.status === "skipped")
+                            continue;
+                        const e = (r.errors && r.errors[0]) || r.error;
+                        if (e) {
+                            error = {
+                                message: stripAnsi(String(e.message ?? "")),
+                                stack: e.stack ? stripAnsi(String(e.stack)) : undefined,
+                            };
+                            break;
+                        }
+                    }
+                    if (error)
+                        break;
+                }
+            }
+            out.push({
+                status: ok ? "PASSED" : "FAILED",
+                testName: spec.title ?? "",
+                filePath: specFile,
+                ...(error ? { error } : {}),
+            });
+        }
+        for (const child of suite?.suites ?? [])
+            walk(child, file);
+    };
+    for (const s of report?.suites ?? [])
+        walk(s);
+    return out;
+}

package/dist/cli/conventionsInit.d.ts

@@ -0,0 +1,51 @@
+import type Anthropic from "@anthropic-ai/sdk";
+import { type ScanOptions } from "../services/ConventionsScanner.js";
+import { type Conventions, type ScanStats } from "../config/Conventions.js";
+export type DiscoveryMode = "smart" | "folders" | "glob";
+export interface ConventionsInitOptions {
+    /** smart | folders | glob. */
+    mode?: DiscoveryMode;
+    /** Folders (cwd-relative) when mode === 'folders'. */
+    folders?: string[];
+    /** Glob pattern when mode === 'glob'. */
+    glob?: string;
+    fileTimeoutMs?: number;
+    maxFiles?: number;
+    /** Run the optional LLM polish step. Default: false. */
+    llm?: boolean;
+    /** Injected Anthropic client (tests). Falls back to a sanitizing client. */
+    client?: Anthropic;
+    model?: string;
+    /** Print JSON to stdout, write nothing. */
+    dryRun?: boolean;
+}
+/** Convert a glob (supports **, *, ?) to an anchored RegExp over posix paths. */
+export declare function globToRegex(glob: string): RegExp;
+/** Resolve the absolute, sorted spec file list for a discovery mode. */
+export declare function resolveSpecFiles(cwd: string, opts: Pick<ConventionsInitOptions, "mode" | "folders" | "glob">): string[];
+export interface GenerationResult {
+    conventions: Conventions;
+    stats: ScanStats;
+}
+export declare function generateConventions(files: string[], opts?: ConventionsInitOptions & {
+    onProgress?: ScanOptions["onProgress"];
+}): Promise<GenerationResult>;
+/**
+ * Optional LLM refinement. Sends ONLY the integer stats blob + the draft (no
+ * raw source) and asks Claude to correct obvious misjudgements while keeping
+ * the exact schema. Fully defensive: any failure returns null → caller keeps
+ * the deterministic draft.
+ */
+export declare function polishConventions(draft: Conventions, stats: ScanStats, client: Anthropic, model: string): Promise<Conventions | null>;
+export interface WriteResult {
+    path: string;
+    json: string;
+    written: boolean;
+}
+export declare function writeConventionsArtifact(cwd: string, conventions: Conventions, opts?: {
+    dryRun?: boolean;
+}): WriteResult;
+export declare function runConventionsWizard(cwd: string, opts?: ConventionsInitOptions & {
+    yes?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=conventionsInit.d.ts.map

package/dist/cli/conventionsInit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conventionsInit.d.ts","sourceRoot":"","sources":["../../src/cli/conventionsInit.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,SAAS,MAAM,mBAAmB,CAAC;AAO/C,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,SAAS,EAEf,MAAM,0BAA0B,CAAC;AAelC,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEzD,MAAM,WAAW,sBAAsB;IACrC,8BAA8B;IAC9B,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,4EAA4E;IAC5E,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAkCD,iFAAiF;AACjF,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA0BhD;AAED,wEAAwE;AACxE,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,IAAI,CAAC,sBAAsB,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC,GAC9D,MAAM,EAAE,CAcV;AAMD,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,WAAW,CAAC;IACzB,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,MAAM,EAAE,EACf,IAAI,GAAE,sBAAsB,GAAG;IAAE,UAAU,CAAC,EAAE,WAAW,CAAC,YAAY,CAAC,CAAA;CAAO,GAC7E,OAAO,CAAC,gBAAgB,CAAC,CAsB3B;AAQD;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,SAAS,EAChB,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CA4C7B;AAMD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,WAAW,EACxB,IAAI,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GAC9B,WAAW,CAQb;AAMD,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,sBAAsB,GAAG;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAO,GACpD,OAAO,CAAC,IAAI,CAAC,CAgHf"}