sela-core 1.0.7 → 1.0.8

package/dist/services/SourceUpdater.js

@@ -41,7 +41,7 @@ const ASTSourceUpdater_1 = require("./ASTSourceUpdater");
 const DryRunGuard_1 = require("../config/DryRunGuard");
 const WorkspaceSnapshotService_1 = require("./WorkspaceSnapshotService");
 const SelaError_1 = require("../errors/SelaError");
-// Centralised write gate — every disk-mutating `fs.writeFileSync` call in
+// Centralised write gate - every disk-mutating `fs.writeFileSync` call in
 // this module routes through `persistFile` so the SELA_DRY_RUN bypass is
 // enforced in one place, and the Clean-Room WorkspaceSnapshotService
 // records contentBefore/contentAfter for isolated in-memory diffing.
@@ -310,19 +310,19 @@ function updateTemplateLiteralPreservingVars(line, oldSelector, newSelector, dom
 // GIT HELPER  (used by branch strategy and autoCommit)
 //
 // Design goals:
-//   • Lean — no stash, no branch-switching, no complex state management.
-//   • Commit-based — write first (inPlace), then commit.  If git fails,
+//   • Lean - no stash, no branch-switching, no complex state management.
+//   • Commit-based - write first (inPlace), then commit.  If git fails,
 //     the fix is still on disk (silent inPlace fallback).
-//   • Detached HEAD aware — skips silently in CI environments that check
+//   • Detached HEAD aware - skips silently in CI environments that check
 //     out a specific SHA without a branch ref.
 // ─────────────────────────────────────────────────────────────────
 function runGitOperations(absoluteFilePath, createBranch, relativeFilePath) {
     const filename = path.basename(relativeFilePath);
-    // Dry-run gate — suppress branch creation, `git add`, and auto-commit.
+    // Dry-run gate - suppress branch creation, `git add`, and auto-commit.
     // Mirrors the persistFile() skip so a dry run is fully observable in CI
     // without ever producing a commit.
     if (DryRunGuard_1.DryRunGuard.active()) {
-        console.log(`[SourceUpdater] 🌵 Dry Run — skip git operations for ${filename}`);
+        console.log(`[SourceUpdater] 🌵 Dry Run - skip git operations for ${filename}`);
         return;
     }
     try {
@@ -331,7 +331,7 @@ function runGitOperations(absoluteFilePath, createBranch, relativeFilePath) {
             (0, child_process_1.execSync)("git symbolic-ref HEAD", { stdio: "pipe" });
         }
         catch {
-            console.warn(`[SourceUpdater] ⚠️  Detached HEAD — git operations skipped (fix is saved to disk)`);
+            console.warn(`[SourceUpdater] ⚠️  Detached HEAD - git operations skipped (fix is saved to disk)`);
             return;
         }
         if (createBranch) {
@@ -346,7 +346,7 @@ function runGitOperations(absoluteFilePath, createBranch, relativeFilePath) {
         console.log(`[SourceUpdater] ✅ Auto-committed fix in: ${filename}`);
     }
     catch (err) {
-        console.warn(`[SourceUpdater] ⚠️  Git operation failed: ${err.message} — fix written to disk (inPlace fallback)`);
+        console.warn(`[SourceUpdater] ⚠️  Git operation failed: ${err.message} - fix written to disk (inPlace fallback)`);
     }
 }
 class SourceUpdater {
@@ -376,7 +376,7 @@ class SourceUpdater {
         return result;
     }
     // ─────────────────────────────────────────────────────────────
-    // commentOnly helper — inserts a TODO comment above the failing
+    // commentOnly helper - inserts a TODO comment above the failing
     // call site and returns success:false so the engine knows the
     // source was NOT rewritten (no retry suppression needed).
     // ─────────────────────────────────────────────────────────────
@@ -402,12 +402,12 @@ class SourceUpdater {
         catch (err) {
             return {
                 success: false,
-                reason: `COMMENT_ONLY: write failed — ${err.message}`,
+                reason: `COMMENT_ONLY: write failed - ${err.message}`,
             };
         }
     }
     // ─────────────────────────────────────────────────────────────
-    // CORE UPDATE — Layered Healing (AST primary, Regex fallback)
+    // CORE UPDATE - Layered Healing (AST primary, Regex fallback)
     // Called by update(); never call directly from outside the class.
     // ─────────────────────────────────────────────────────────────
     static _coreUpdate(caller, oldSelector, newSelector, domContext, dnaAttrHint, fullSelectorContext, aiSegments, contentChange, smartChainSegments, originalChainHint) {
@@ -442,7 +442,7 @@ class SourceUpdater {
             if (astResult.success) {
                 console.log(`[SourceUpdater] ✅ AST Strategy ${astResult.strategy} SUCCESS` +
                     (astResult.lineUpdated !== undefined
-                        ? ` — line ${astResult.lineUpdated + 1}`
+                        ? ` - line ${astResult.lineUpdated + 1}`
                         : ""));
                 return {
                     success: true,
@@ -458,18 +458,19 @@ class SourceUpdater {
             // PROPERTY_ACCESS / TEMPLATE_LITERAL) but could not safely resolve the new
             // value.  Regex cannot do better and will corrupt the definition site.
             if (astResult.strategy === "semantic-guard") {
-                console.warn(`[SourceUpdater] 🛑 Regex blocked — semantic guard fired. ` +
+                console.warn(`[SourceUpdater] 🛑 Regex blocked - semantic guard fired. ` +
                     `Source unchanged. Reason: ${astResult.reason}`);
                 return { success: false, reason: astResult.reason };
             }
             console.log(`[SourceUpdater] ⚠️ AST engine exhausted (${astResult.reason}), falling back to Regex`);
         }
         catch (astError) {
-            // Developer pinned the failing statement with `// sela-fail-fast` —
+            // Developer pinned the failing statement with `// sela-fail-fast` -
             // propagate the directive instead of swallowing into the Regex
             // fallback chain (which would defeat the whole point of the gate).
             if ((0, SelaError_1.isSelaErrorFrom)(astError, "ASTUpdater") &&
-                astError.code === SelaError_1.AST_UPDATER_CODES.HEAL_DISABLED_BY_DIRECTIVE) {
+                astError.code ===
+                    SelaError_1.AST_UPDATER_CODES.HEAL_DISABLED_BY_DIRECTIVE) {
                 throw astError;
             }
             console.warn(`[SourceUpdater] ⚠️ AST engine error: ${astError.message}. Falling back to Regex`);
@@ -479,7 +480,7 @@ class SourceUpdater {
         const raw = fs.readFileSync(filePath, "utf8");
         const lines = raw.split(/\r?\n/);
         if (caller.line <= 0) {
-            console.log(`[SourceUpdater] ⚠️  line ${caller.line} invalid — running Regex Strategy G only`);
+            console.log(`[SourceUpdater] ⚠️  line ${caller.line} invalid - running Regex Strategy G only`);
             if (contentChange) {
                 const assertResult = SourceUpdater.strategyAssertionHealing(lines, 1, contentChange, true);
                 if (assertResult.success) {
@@ -511,7 +512,7 @@ class SourceUpdater {
             if (layeredResult.success) {
                 tryAssertionHealing();
                 persistFile(filePath, lines.join("\n"));
-                console.log(`[SourceUpdater] ✅ Strategy 0 (Layered Healing) SUCCESS — line ${layeredResult.lineUpdated + 1}`);
+                console.log(`[SourceUpdater] ✅ Strategy 0 (Layered Healing) SUCCESS - line ${layeredResult.lineUpdated + 1}`);
                 return layeredResult;
             }
         }
@@ -587,7 +588,7 @@ class SourceUpdater {
         };
     }
     // ─────────────────────────────────────────────────────────────
-    // STRATEGY F (Regex) — Full Chain Collapsing
+    // STRATEGY F (Regex) - Full Chain Collapsing
     // ─────────────────────────────────────────────────────────────
     static strategyChainCollapse_Regex(lines, callerLine, oldSelector, newSelector) {
         console.log(`[Strategy-F] ⛓️  Starting Regex Chain Collapse...`);
@@ -638,7 +639,7 @@ class SourceUpdater {
         return { success: false, reason: "chain detected but could not replace" };
     }
     // ─────────────────────────────────────────────────────────────
-    // STRATEGY G (Regex) — Assertion Healing
+    // STRATEGY G (Regex) - Assertion Healing
     // ─────────────────────────────────────────────────────────────
     static strategyAssertionHealing(lines, callerLine, contentChange, wholeFile = false) {
         const { oldText, newText } = contentChange;
@@ -693,7 +694,7 @@ class SourceUpdater {
         return { success: false, reason: "no assertions to heal" };
     }
     // ─────────────────────────────────────────────────────────────
-    // STRATEGY 0 — Layered Healing (Upstream Variable Tracing)
+    // STRATEGY 0 - Layered Healing (Upstream Variable Tracing)
     // ─────────────────────────────────────────────────────────────
     static strategyLayeredHealing(lines, callerLine, oldElementSelector, aiSegments, fullSelectorContext) {
         console.log(`[SourceUpdater] 🧠 Strategy 0: Starting Layered Healing...`);
@@ -746,7 +747,7 @@ class SourceUpdater {
         return null;
     }
     // ─────────────────────────────────────────────────────────────
-    // STRATEGY 1 — Chain Collapse (leaf-only precision replacement)
+    // STRATEGY 1 - Chain Collapse (leaf-only precision replacement)
     // ─────────────────────────────────────────────────────────────
     static strategyChainCollapse(lines, callerLine, oldSelector, newSelector) {
         const oldLeaf = oldSelector
@@ -788,7 +789,7 @@ class SourceUpdater {
         };
     }
     // ─────────────────────────────────────────────────────────────
-    // STRATEGY 2 — Direct Literal
+    // STRATEGY 2 - Direct Literal
     // ─────────────────────────────────────────────────────────────
     static strategyDirectLiteral(lines, callerLine, oldSelector, newSelector) {
         const windowSize = 10;
@@ -821,7 +822,7 @@ class SourceUpdater {
         return { success: false, reason: "no direct literal" };
     }
     // ─────────────────────────────────────────────────────────────
-    // STRATEGY 3 — Upstream Variable/Const
+    // STRATEGY 3 - Upstream Variable/Const
     // ─────────────────────────────────────────────────────────────
     static strategyUpstreamVariable(lines, callerLine, oldSelector, newSelector) {
         const callBlock = lines
@@ -858,7 +859,7 @@ class SourceUpdater {
         return { success: false, reason: "no upstream variable" };
     }
     // ─────────────────────────────────────────────────────────────
-    // STRATEGY 4 — Chained Locator Dedup
+    // STRATEGY 4 - Chained Locator Dedup
     // ─────────────────────────────────────────────────────────────
     static strategyChainedLocator(lines, callerLine, oldSelector, newSelector) {
         const blockStart = Math.max(0, callerLine - 10);
@@ -885,7 +886,7 @@ class SourceUpdater {
         return { success: false, reason: "dedup found but literal not replaced" };
     }
     // ─────────────────────────────────────────────────────────────
-    // STRATEGY 5 — Function/Template with Variable Preservation
+    // STRATEGY 5 - Function/Template with Variable Preservation
     // ─────────────────────────────────────────────────────────────
     static strategyFunctionReturn(lines, callerLine, oldSelector, newSelector, domContext, dnaAttrHint) {
         const callBlock = lines
@@ -970,7 +971,7 @@ class SourceUpdater {
         return { success: false, reason: "function strategy exhausted" };
     }
     // ─────────────────────────────────────────────────────────────
-    // STRATEGY 6 — Global Scan
+    // STRATEGY 6 - Global Scan
     // ─────────────────────────────────────────────────────────────
     static strategyGlobalScan(lines, oldSelector, newSelector) {
         const lastOldPart = oldSelector.split(">>").pop().trim();

package/dist/services/TemplateDiffService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TemplateDiffService.d.ts","sourceRoot":"","sources":["../../src/services/TemplateDiffService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,kBAAkB,EAAc,MAAM,UAAU,CAAC;AAMhE,MAAM,MAAM,eAAe,GACvB;IACE,EAAE,EAAE,IAAI,CAAC;IACT,mFAAmF;IACnF,eAAe,EAAE,MAAM,CAAC;IACxB,0DAA0D;IAC1D,qBAAqB,EAAE,MAAM,EAAE,CAAC;CACjC,GACD;IACE,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B,CAAC;AA6BN,qBAAa,mBAAmB;IAW9B,MAAM,CAAC,YAAY,CACjB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,eAAe;IA6GlB,MAAM,CAAC,gBAAgB,CACrB,YAAY,EAAE,kBAAkB,EAChC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,eAAe;IAoFlB,MAAM,CAAC,qBAAqB,CAC1B,YAAY,EAAE,kBAAkB,EAChC,QAAQ,EAAE,MAAM,GACf,MAAM,EAAE,GAAG,IAAI;CASnB;AAgJD,6DAA6D;AAC7D,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKtD"}
+{"version":3,"file":"TemplateDiffService.d.ts","sourceRoot":"","sources":["../../src/services/TemplateDiffService.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,kBAAkB,EAAc,MAAM,UAAU,CAAC;AAMhE,MAAM,MAAM,eAAe,GACvB;IACE,EAAE,EAAE,IAAI,CAAC;IACT,mFAAmF;IACnF,eAAe,EAAE,MAAM,CAAC;IACxB,0DAA0D;IAC1D,qBAAqB,EAAE,MAAM,EAAE,CAAC;CACjC,GACD;IACE,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B,CAAC;AA6BN,qBAAa,mBAAmB;IAW9B,MAAM,CAAC,YAAY,CACjB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,eAAe;IAiHlB,MAAM,CAAC,gBAAgB,CACrB,YAAY,EAAE,kBAAkB,EAChC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,eAAe;IAoFlB,MAAM,CAAC,qBAAqB,CAC1B,YAAY,EAAE,kBAAkB,EAChC,QAAQ,EAAE,MAAM,GACf,MAAM,EAAE,GAAG,IAAI;CASnB;AAgJD,6DAA6D;AAC7D,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKtD"}

package/dist/services/TemplateDiffService.js

@@ -5,13 +5,13 @@ exports.escapeForTemplate = escapeForTemplate;
 // ═══════════════════════════════════════════════════════════════════
 // TemplateDiffService
 //
-// T-8: String-based API — diffAndPatch()
+// T-8: String-based API - diffAndPatch()
 //   Given a template source like `input[data-role="${role}_legacy"]`,
 //   its resolved old string, and an AI-proposed new string, compute
 //   the patched template that preserves ${...} spans while updating
 //   only the changed static segments.
 //
-// T-8.1: Node-based API — computeNodePatch()
+// T-8.1: Node-based API - computeNodePatch()
 //   Wraps diffAndPatch() using the TemplateExpression AST node as the
 //   source of truth (avoids text-parsing ambiguity). Returns the full
 //   patched template text for use with templateNode.replaceWithText().
@@ -34,7 +34,7 @@ class TemplateDiffService {
         const exprSegs = segments
             .filter((s) => s.type === "expr")
             .map((s) => s.text);
-        // No spans — the "template" is just a plain string.
+        // No spans - the "template" is just a plain string.
         if (exprSegs.length === 0) {
             if (resolvedOld !== resolvedNew) {
                 return {
@@ -43,18 +43,21 @@ class TemplateDiffService {
                     changedSegmentIndices: [0],
                 };
             }
-            return { ok: false, reason: "resolvedOld === resolvedNew — no change needed" };
+            return {
+                ok: false,
+                reason: "resolvedOld === resolvedNew - no change needed",
+            };
         }
         // Extract span values from resolvedOld using static segments as anchors.
         const spanValues = extractSpanValues(staticSegs, resolvedOld);
         if (!spanValues) {
             return {
                 ok: false,
-                reason: "template static segments don't align with resolvedOld — possible desync. " +
+                reason: "template static segments don't align with resolvedOld - possible desync. " +
                     `template="${templateText}", resolvedOld="${resolvedOld}"`,
             };
         }
-        // Verify reconstruction — extractSpanValues already guarantees this
+        // Verify reconstruction - extractSpanValues already guarantees this
         // implicitly, but an explicit check catches any edge-case bugs early.
         {
             let check = "";
@@ -76,13 +79,13 @@ class TemplateDiffService {
             return {
                 ok: false,
                 reason: `dynamic span value(s) [${spanValues.map((v) => `"${v}"`).join(", ")}] ` +
-                    `not found in resolvedNew="${resolvedNew}" — structural change, manual review required`,
+                    `not found in resolvedNew="${resolvedNew}" - structural change, manual review required`,
             };
         }
         if (newStaticSegs.length !== staticSegs.length) {
             return {
                 ok: false,
-                reason: "static segment count mismatch after alignment — structural change",
+                reason: "static segment count mismatch after alignment - structural change",
             };
         }
         // Diff: find which static segments changed.
@@ -94,14 +97,14 @@ class TemplateDiffService {
         if (changedIndices.length === 0) {
             return {
                 ok: false,
-                reason: "no static segment changed — the difference is in a dynamic span. " +
+                reason: "no static segment changed - the difference is in a dynamic span. " +
                     "Update the argument passed to the function instead.",
             };
         }
         if (changedIndices.length > 1) {
             return {
                 ok: false,
-                reason: `${changedIndices.length} static segments changed simultaneously — ` +
+                reason: `${changedIndices.length} static segments changed simultaneously - ` +
                     "ambiguous, manual review required",
             };
         }
@@ -119,7 +122,7 @@ class TemplateDiffService {
     //
     // Uses the TemplateExpression AST node as the authoritative source
     // of static/expr segments (avoids text-parsing edge cases).
-    // Returns `patchedText` — pass directly to templateNode.replaceWithText().
+    // Returns `patchedText` - pass directly to templateNode.replaceWithText().
     // ─────────────────────────────────────────────────────────────────
     static computeNodePatch(templateNode, resolvedOld, resolvedNew) {
         // Extract static segments and expr texts directly from the AST.
@@ -172,13 +175,13 @@ class TemplateDiffService {
         if (changedIndices.length === 0) {
             return {
                 ok: false,
-                reason: "difference is in dynamic span — update call-site argument",
+                reason: "difference is in dynamic span - update call-site argument",
             };
         }
         if (changedIndices.length > 1) {
             return {
                 ok: false,
-                reason: `${changedIndices.length} static segments changed — ambiguous`,
+                reason: `${changedIndices.length} static segments changed - ambiguous`,
             };
         }
         const patchedStatics = [...staticSegs];
@@ -238,7 +241,7 @@ function parseTemplateSource(text) {
  *
  * Algorithm: iterate over all static segments in order. After consuming
  * each static segment, find the next static as the delimiter for the
- * span value — then advance pos to the start of that next static so
+ * span value - then advance pos to the start of that next static so
  * the following iteration can consume it. This ensures pos is always
  * consistent at the start of each static segment.
  *
@@ -265,7 +268,7 @@ function extractSpanValues(staticSegments, resolved) {
             break;
         }
         if (nextStatic === "") {
-            // Empty non-trailing static: adjacent spans — boundary is ambiguous.
+            // Empty non-trailing static: adjacent spans - boundary is ambiguous.
             return null;
         }
         const delimIdx = resolved.indexOf(nextStatic, pos);

package/dist/services/WorkspaceSnapshotService.d.ts

@@ -1,16 +1,16 @@
 export interface FileSnapshot {
     /** Absolute, normalised path of the tracked file. */
     absolutePath: string;
-    /** Project-relative path (posix slashes) — for diff headers + PR commits. */
+    /** Project-relative path (posix slashes) - for diff headers + PR commits. */
     relativePath: string;
     /**
      * Disk content captured BEFORE Sela's first write to this file.
-     * May contain the developer's uncommitted edits — that's the point.
+     * May contain the developer's uncommitted edits - that's the point.
      */
     contentBefore: string;
     /** Disk content captured AFTER Sela's latest write. `null` until first postWrite(). */
     contentAfter: string | null;
-    /** Content of the file at `HEAD` (last committed) — `null` when untracked / no git. */
+    /** Content of the file at `HEAD` (last committed) - `null` when untracked / no git. */
     headContent: string | null;
     /** True when `contentBefore !== headContent`, i.e. developer had dirty edits. */
     hadUncommittedChanges: boolean;
@@ -25,11 +25,11 @@ export declare class WorkspaceSnapshotService {
     setCwd(cwd: string): void;
     /**
      * Record the pre-mutation state of `filePath` if not already tracked.
-     * Idempotent — only the FIRST call per file matters.
+     * Idempotent - only the FIRST call per file matters.
      */
     preWrite(filePath: string): void;
     /**
-     * Refresh the post-mutation state. Safe to call multiple times — each
+     * Refresh the post-mutation state. Safe to call multiple times - each
      * call overwrites `contentAfter` with the latest disk state.
      */
     postWrite(filePath: string): void;
@@ -45,7 +45,7 @@ export declare class WorkspaceSnapshotService {
     /** All snapshots with a real mutation recorded. */
     getMutatedSnapshots(): FileSnapshot[];
     /**
-     * Rewind every tracked file on disk to `contentBefore` — restoring the
+     * Rewind every tracked file on disk to `contentBefore` - restoring the
      * developer's pre-Sela workspace state byte-for-byte.
      */
     restoreOriginal(): void;

package/dist/services/WorkspaceSnapshotService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WorkspaceSnapshotService.d.ts","sourceRoot":"","sources":["../../src/services/WorkspaceSnapshotService.ts"],"names":[],"mappings":"AAyBA,MAAM,WAAW,YAAY;IAC3B,qDAAqD;IACrD,YAAY,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,YAAY,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB,uFAAuF;IACvF,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,uFAAuF;IACvF,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,iFAAiF;IACjF,qBAAqB,EAAE,OAAO,CAAC;IAC/B,uEAAuE;IACvE,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,qBAAa,wBAAwB;IACnC,OAAO,CAAC,SAAS,CAAmC;IACpD,OAAO,CAAC,GAAG,CAAS;gBAER,GAAG,GAAE,MAAsB;IAIvC,sEAAsE;IACtE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIzB;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAqBhC;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IASjC,0EAA0E;IAC1E,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAIlD,+CAA+C;IAC/C,eAAe,IAAI,YAAY,EAAE;IAIjC;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAMpC,mDAAmD;IACnD,mBAAmB,IAAI,YAAY,EAAE;IAMrC;;;OAGG;IACH,eAAe,IAAI,IAAI;IAMvB;;;;OAIG;IACH,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAOhD,OAAO,CAAC,cAAc;IAUtB;;;;OAIG;IACH,cAAc,IAAI,IAAI;IAOtB,KAAK,IAAI,IAAI;IAQb,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,UAAU;IAKlB,OAAO,CAAC,eAAe;CAcxB;AAED,eAAO,MAAM,uBAAuB,0BAAiC,CAAC"}
+{"version":3,"file":"WorkspaceSnapshotService.d.ts","sourceRoot":"","sources":["../../src/services/WorkspaceSnapshotService.ts"],"names":[],"mappings":"AAyBA,MAAM,WAAW,YAAY;IAC3B,qDAAqD;IACrD,YAAY,EAAE,MAAM,CAAC;IACrB,6EAA6E;IAC7E,YAAY,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB,uFAAuF;IACvF,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,uFAAuF;IACvF,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,iFAAiF;IACjF,qBAAqB,EAAE,OAAO,CAAC;IAC/B,uEAAuE;IACvE,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,qBAAa,wBAAwB;IACnC,OAAO,CAAC,SAAS,CAAmC;IACpD,OAAO,CAAC,GAAG,CAAS;gBAER,GAAG,GAAE,MAAsB;IAIvC,sEAAsE;IACtE,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIzB;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAqBhC;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAOjC,0EAA0E;IAC1E,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAIlD,+CAA+C;IAC/C,eAAe,IAAI,YAAY,EAAE;IAIjC;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAMpC,mDAAmD;IACnD,mBAAmB,IAAI,YAAY,EAAE;IAMrC;;;OAGG;IACH,eAAe,IAAI,IAAI;IAMvB;;;;OAIG;IACH,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAOhD,OAAO,CAAC,cAAc;IAUtB;;;;OAIG;IACH,cAAc,IAAI,IAAI;IAOtB,KAAK,IAAI,IAAI;IAQb,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,UAAU;IAKlB,OAAO,CAAC,eAAe;CAcxB;AAED,eAAO,MAAM,uBAAuB,0BAAiC,CAAC"}

package/dist/services/WorkspaceSnapshotService.js

@@ -1,7 +1,7 @@
 "use strict";
 // src/services/WorkspaceSnapshotService.ts
 //
-// Clean-Room Architecture — file 1 of 2.
+// Clean-Room Architecture - file 1 of 2.
 //
 // Tracks the EXACT content of every file Sela mutates during a session, so:
 //   • The HTML report diff can be generated from an isolated in-memory diff
@@ -10,12 +10,12 @@
 //     byte-for-byte after a PR is opened on an isolated branch.
 //
 // Lifecycle:
-//   preWrite(path)   — first call per file records `contentBefore` (disk
+//   preWrite(path)   - first call per file records `contentBefore` (disk
 //                      snapshot right before Sela touches it) + HEAD blob.
-//   postWrite(path)  — refreshes `contentAfter` (latest disk state).
-//   restoreOriginal()— writes contentBefore back to every tracked file.
-//   restoreMutated() — writes contentAfter back to every tracked file.
-//   clear()          — empties the ledger.
+//   postWrite(path)  - refreshes `contentAfter` (latest disk state).
+//   restoreOriginal()- writes contentBefore back to every tracked file.
+//   restoreMutated() - writes contentAfter back to every tracked file.
+//   clear()          - empties the ledger.
 //
 // Singleton `sharedWorkspaceSnapshot` is the canonical instance the
 // SourceUpdater / ASTSourceUpdater write hooks talk to.
@@ -69,7 +69,7 @@ class WorkspaceSnapshotService {
     }
     /**
      * Record the pre-mutation state of `filePath` if not already tracked.
-     * Idempotent — only the FIRST call per file matters.
+     * Idempotent - only the FIRST call per file matters.
      */
     preWrite(filePath) {
         const abs = this.normalise(filePath);
@@ -90,7 +90,7 @@ class WorkspaceSnapshotService {
         });
     }
     /**
-     * Refresh the post-mutation state. Safe to call multiple times — each
+     * Refresh the post-mutation state. Safe to call multiple times - each
      * call overwrites `contentAfter` with the latest disk state.
      */
     postWrite(filePath) {
@@ -98,9 +98,7 @@ class WorkspaceSnapshotService {
         const snap = this.snapshots.get(abs);
         if (!snap)
             return;
-        snap.contentAfter = fs.existsSync(abs)
-            ? fs.readFileSync(abs, "utf8")
-            : "";
+        snap.contentAfter = fs.existsSync(abs) ? fs.readFileSync(abs, "utf8") : "";
     }
     /** Lookup by absolute or relative path. Returns `null` when untracked. */
     getSnapshot(filePath) {
@@ -125,7 +123,7 @@ class WorkspaceSnapshotService {
         return this.getAllSnapshots().filter((s) => s.contentAfter !== null && s.contentAfter !== s.contentBefore);
     }
     /**
-     * Rewind every tracked file on disk to `contentBefore` — restoring the
+     * Rewind every tracked file on disk to `contentBefore` - restoring the
      * developer's pre-Sela workspace state byte-for-byte.
      */
     restoreOriginal() {

package/dist/types/index.d.ts

@@ -2,7 +2,7 @@ export interface AncestorNode {
     tag: string;
     id: string | null;
     classes: string[];
-    /** "{tag}#{id}[{classes_sorted_asc}]" — stable fingerprint for drift comparison */
+    /** "{tag}#{id}[{classes_sorted_asc}]" - stable fingerprint for drift comparison */
     fingerprint: string;
 }
 export type GhostCondition = "G1_DISPLAY_NONE" | "G2_VISIBILITY_HIDDEN" | "G3_OPACITY_ZERO" | "G4_POINTER_EVENTS_NONE" | "G5_ZERO_AREA" | "G6_CONTENT_VISIBILITY_HIDDEN";

package/dist/utils/IsolatedDiff.d.ts

@@ -32,13 +32,13 @@ export declare function extractChangeBlocks(before: string, after: string): Chan
 export interface ApplyBlocksResult {
     ok: boolean;
     result?: string;
-    /** Human-readable failure reason — surfaced in the PR-automation log. */
+    /** Human-readable failure reason - surfaced in the PR-automation log. */
     reason?: string;
 }
 /**
  * Replay a list of change blocks against a fresh base buffer (typically
  * the file's `HEAD` blob). Each block is applied via UNIQUE substring
- * replacement — when the old block is missing or ambiguous in the base,
+ * replacement - when the old block is missing or ambiguous in the base,
  * we fail loudly rather than silently mutating the wrong spot.
  */
 export declare function applyChangeBlocks(base: string, blocks: ChangeBlock[]): ApplyBlocksResult;

package/dist/utils/IsolatedDiff.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IsolatedDiff.d.ts","sourceRoot":"","sources":["../../src/utils/IsolatedDiff.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,mBAAmB;IAClC,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,mBAAwB,GAC7B,MAAM,CAsBR;AA2PD,MAAM,WAAW,WAAW;IAC1B,sEAAsE;IACtE,QAAQ,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,QAAQ,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,YAAY,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,YAAY,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,EAAE,CAoDhF;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,WAAW,EAAE,GACpB,iBAAiB,CAoDnB"}
+{"version":3,"file":"IsolatedDiff.d.ts","sourceRoot":"","sources":["../../src/utils/IsolatedDiff.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,mBAAmB;IAClC,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,mBAAwB,GAC7B,MAAM,CAsBR;AA6PD,MAAM,WAAW,WAAW;IAC1B,sEAAsE;IACtE,QAAQ,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,QAAQ,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,YAAY,EAAE,MAAM,CAAC;IACrB,yEAAyE;IACzE,YAAY,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,WAAW,EAAE,CAoDf;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,WAAW,EAAE,GACpB,iBAAiB,CAuDnB"}

package/dist/utils/IsolatedDiff.js

@@ -2,7 +2,7 @@
 // src/utils/IsolatedDiff.ts
 //
 // Pure-JS unified-diff generator. No external `diff` package, no shell-out to
-// `git diff` — the result is guaranteed to be a function ONLY of the two
+// `git diff` - the result is guaranteed to be a function ONLY of the two
 // in-memory buffers passed in, never of any global working-tree state.
 //
 // This is the foundation of the Clean-Room Architecture: the HTML report
@@ -47,7 +47,7 @@ function generateUnifiedDiff(before, after, opts = {}) {
     return out.join("\n") + "\n";
 }
 // ────────────────────────────────────────────────────────────────────
-// LINE SPLITTER — preserves trailing newline / CRLF so we can emit the
+// LINE SPLITTER - preserves trailing newline / CRLF so we can emit the
 // canonical `` marker when needed.
 // ────────────────────────────────────────────────────────────────────
 function splitKeepEol(text) {
@@ -200,7 +200,7 @@ function groupHunks(ops, ctx) {
                     // Anchor on the corresponding `b` position. For pure-deletions at
                     // the top of file `op.a === 0` ⇒ newStart should be 0 (special
                     // header form `+0,0`). For mid-file deletions use the running b
-                    // cursor — derive it from prior ops.
+                    // cursor - derive it from prior ops.
                     newStartIdx = computeBAnchor(ops, k);
                 }
                 const line = ctx.a[op.a];
@@ -296,7 +296,7 @@ function extractChangeBlocks(before, after) {
         }
         let anchorBefore = null;
         if (oldLines.length === 0) {
-            // Pure addition — find preceding unchanged anchor line.
+            // Pure addition - find preceding unchanged anchor line.
             for (let k = start - 1; k >= 0; k--) {
                 const op = ops[k];
                 if (op.kind === "eq") {
@@ -318,7 +318,7 @@ function extractChangeBlocks(before, after) {
 /**
  * Replay a list of change blocks against a fresh base buffer (typically
  * the file's `HEAD` blob). Each block is applied via UNIQUE substring
- * replacement — when the old block is missing or ambiguous in the base,
+ * replacement - when the old block is missing or ambiguous in the base,
  * we fail loudly rather than silently mutating the wrong spot.
  */
 function applyChangeBlocks(base, blocks) {
@@ -328,7 +328,7 @@ function applyChangeBlocks(base, blocks) {
             // Pure addition.
             if (block.anchorBefore === null) {
                 if (working.length === 0) {
-                    // Empty file — prepend.
+                    // Empty file - prepend.
                     working = block.newBlock + working;
                     continue;
                 }
@@ -351,25 +351,28 @@ function applyChangeBlocks(base, blocks) {
                 };
             }
             const insertAt = idx + block.anchorBefore.length;
-            working = working.slice(0, insertAt) + block.newBlock + working.slice(insertAt);
+            working =
+                working.slice(0, insertAt) + block.newBlock + working.slice(insertAt);
             continue;
         }
         const idx = working.indexOf(block.oldBlock);
         if (idx === -1) {
             return {
                 ok: false,
-                reason: `block not found in clean base — developer's dirty state likely overlaps Sela's mutation site: "${snippet(block.oldBlock)}"`,
+                reason: `block not found in clean base - developer's dirty state likely overlaps Sela's mutation site: "${snippet(block.oldBlock)}"`,
             };
         }
         const lastIdx = working.lastIndexOf(block.oldBlock);
         if (idx !== lastIdx) {
             return {
                 ok: false,
-                reason: `block matches multiple locations in clean base — refusing to guess: "${snippet(block.oldBlock)}"`,
+                reason: `block matches multiple locations in clean base - refusing to guess: "${snippet(block.oldBlock)}"`,
             };
         }
         working =
-            working.slice(0, idx) + block.newBlock + working.slice(idx + block.oldBlock.length);
+            working.slice(0, idx) +
+                block.newBlock +
+                working.slice(idx + block.oldBlock.length);
     }
     return { ok: true, result: working };
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "sela-core",
-  "version": "1.0.7",
-  "description": "AI self-healing Playwright wrapper — drop-in replacement for @playwright/test",
+  "version": "1.0.8",
+  "description": "AI self-healing Playwright wrapper - drop-in replacement for @playwright/test",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {