sela-core 1.0.7 → 1.0.8

package/dist/services/ChainValidator.js

@@ -6,11 +6,11 @@
 //
 // Runs 5 sequential guards before any AST mutation occurs:
 //
-//   [1] SchemaValidator    — required fields, no unknown segment types
-//   [2] TypeFlowValidator  — tracks Locator|FrameLocator state
-//   [3] ReceiverValidator  — root must match original chain's receiver
-//   [4] PlacementValidator — filter() / nth() / first() only after Locator
-//   [5] SemanticUpgrader   — upgrades flat CSS to semantic where possible
+//   [1] SchemaValidator    - required fields, no unknown segment types
+//   [2] TypeFlowValidator  - tracks Locator|FrameLocator state
+//   [3] ReceiverValidator  - root must match original chain's receiver
+//   [4] PlacementValidator - filter() / nth() / first() only after Locator
+//   [5] SemanticUpgrader   - upgrades flat CSS to semantic where possible
 //
 // Each guard returns a ValidationResult. The pipeline short-circuits on
 // the first REJECT, falling back to the original flat-CSS strategy.
@@ -139,7 +139,7 @@ const VALID_ARIA_ROLES = new Set([
     "generic",
 ]);
 // ─────────────────────────────────────────────────────────────────
-// GUARD 1 — Schema Validator
+// GUARD 1 - Schema Validator
 // ─────────────────────────────────────────────────────────────────
 function schemaValidate(segments) {
     if (!Array.isArray(segments) || segments.length === 0) {
@@ -226,7 +226,7 @@ function schemaValidate(segments) {
     return { valid: true };
 }
 // ─────────────────────────────────────────────────────────────────
-// GUARD 2 — Type Flow Validator
+// GUARD 2 - Type Flow Validator
 //
 // Simulates the chain execution, tracking whether the current
 // expression is a Locator, FrameLocator, or Page/unknown.
@@ -266,13 +266,13 @@ function typeFlowValidate(segments, rootType) {
     if (currentType === "FrameLocator") {
         return {
             valid: false,
-            reason: "chain ends on FrameLocator — assertions require a Locator at the end",
+            reason: "chain ends on FrameLocator - assertions require a Locator at the end",
         };
     }
     return { valid: true };
 }
 // ─────────────────────────────────────────────────────────────────
-// GUARD 3 — Receiver Validator
+// GUARD 3 - Receiver Validator
 //
 // The first segment's effective receiver must be compatible with
 // the original code's root receiver. Prevents `page.getByRole()`
@@ -284,14 +284,14 @@ function receiverValidate(segments, originalRootReceiver, proposedRootReceiver)
     // If both are "page" or both are the same variable, we're fine
     if (orig === proposed)
         return { valid: true };
-    // "page" is a global receiver — the AI sometimes proposes it even when
+    // "page" is a global receiver - the AI sometimes proposes it even when
     // the original chain was scoped. This is only acceptable if the original
     // chain itself started from "page".
     const PAGE_RECEIVERS = new Set(["page", "context", "browser"]);
     if (PAGE_RECEIVERS.has(proposed) && !PAGE_RECEIVERS.has(orig)) {
         return {
             valid: false,
-            reason: `receiver mismatch: original chain rooted at "${orig}" but proposed chain starts from "${proposed}" — this would change element scope`,
+            reason: `receiver mismatch: original chain rooted at "${orig}" but proposed chain starts from "${proposed}" - this would change element scope`,
         };
     }
     // If the original root is a local variable and proposed is different,
@@ -299,14 +299,14 @@ function receiverValidate(segments, originalRootReceiver, proposedRootReceiver)
     // We allow this since sometimes variables are renamed but semantically
     // equivalent.
     if (!PAGE_RECEIVERS.has(orig) && !PAGE_RECEIVERS.has(proposed)) {
-        // Both are custom variables — trust the AI's context
-        console.warn(`[ChainValidator] ⚠️ Receiver mismatch: "${orig}" vs "${proposed}" — proceeding cautiously`);
+        // Both are custom variables - trust the AI's context
+        console.warn(`[ChainValidator] ⚠️ Receiver mismatch: "${orig}" vs "${proposed}" - proceeding cautiously`);
         return { valid: true };
     }
     return { valid: true };
 }
 // ─────────────────────────────────────────────────────────────────
-// GUARD 4 — Placement Validator
+// GUARD 4 - Placement Validator
 //
 // Validates placement-sensitive rules:
 //   - filter/first/last/nth must follow a Locator-producing segment
@@ -322,7 +322,7 @@ function placementValidate(segments) {
             if (prev.type === "frameLocator") {
                 return {
                     valid: false,
-                    reason: `segment[${i}] .${seg.type}() placed immediately after frameLocator() — invalid`,
+                    reason: `segment[${i}] .${seg.type}() placed immediately after frameLocator() - invalid`,
                 };
             }
         }
@@ -335,7 +335,7 @@ function placementValidate(segments) {
             if (!hasAnyPredicate) {
                 return {
                     valid: false,
-                    reason: `segment[${i}] filter() has all-empty predicates — would be a no-op`,
+                    reason: `segment[${i}] filter() has all-empty predicates - would be a no-op`,
                 };
             }
         }
@@ -343,16 +343,16 @@ function placementValidate(segments) {
     return { valid: true };
 }
 // ─────────────────────────────────────────────────────────────────
-// GUARD 5 — Semantic Upgrader
+// GUARD 5 - Semantic Upgrader
 //
 // Opportunistically upgrades flat CSS locator segments to semantic
 // equivalents following Playwright's priority hierarchy:
 //   1. getByTestId  (data-testid)
 //   2. getByRole    (aria role inference from CSS)
 //   3. getByLabel   (form elements)
-//   4. locator      (CSS — unchanged)
+//   4. locator      (CSS - unchanged)
 //
-// This guard NEVER rejects — it only upgrades and returns the
+// This guard NEVER rejects - it only upgrades and returns the
 // possibly-improved segments.
 // ─────────────────────────────────────────────────────────────────
 const ROLE_BY_TAG = {
@@ -396,12 +396,12 @@ function tryUpgradeToSemantic(seg) {
             return { type: "getByRole", role };
         }
     }
-    // Priority 3b: button[type="submit"] or button.classname — still a button role
+    // Priority 3b: button[type="submit"] or button.classname - still a button role
     const buttonMatch = css.match(/^button(?:[.[#][^\s]*)?$/);
     if (buttonMatch) {
         return { type: "getByRole", role: "button" };
     }
-    // Priority 4: has-text() — convert to getByText
+    // Priority 4: has-text() - convert to getByText
     const hasTextMatch = css.match(/^.*:has-text\(["']([^"']+)["']\)$/);
     if (hasTextMatch) {
         return { type: "getByText", text: hasTextMatch[1] };
@@ -506,7 +506,7 @@ class ChainValidator {
         // Guard 2: Type flow
         const effectiveRootType = rootType === "unknown" ? "Locator" : rootType;
         // For Page-level (page.xxx), the root is not yet a Locator/FrameLocator
-        // — we treat the first segment as the producer.
+        // - we treat the first segment as the producer.
         const isPageReceiver = originalRootReceiver === "page" ||
             originalRootReceiver === "context" ||
             originalRootReceiver === "browser";

package/dist/services/CrossFileHealer.js

@@ -45,12 +45,12 @@ const InitializerUpdater_js_1 = require("./InitializerUpdater.js");
 // then delegates mutation to InitializerUpdater.
 //
 // Entry point: CrossFileHealer.heal()
-//   modulePath  — the import specifier string (e.g. "./constants")
-//   symbolName  — the exported identifier name (e.g. "SHARED_SEL")
-//   oldValue    — the current string value (used for verification)
-//   newValue    — the replacement value
-//   callerFilePath — absolute path of the file containing the import
-//   project     — the shared ASTSourceUpdater Project instance
+//   modulePath  - the import specifier string (e.g. "./constants")
+//   symbolName  - the exported identifier name (e.g. "SHARED_SEL")
+//   oldValue    - the current string value (used for verification)
+//   newValue    - the replacement value
+//   callerFilePath - absolute path of the file containing the import
+//   project     - the shared ASTSourceUpdater Project instance
 // ═══════════════════════════════════════════════════════════════════
 const DEPTH_GUARD = 3;
 class CrossFileHealer {
@@ -91,7 +91,7 @@ class CrossFileHealer {
         if (!traceResult.found) {
             // Follow re-export chains (barrel files).
             if (traceResult.crossFile) {
-                console.log(`[CrossFileHealer] 🔄 "${symbolName}" re-exported from "${traceResult.modulePath}" — following chain`);
+                console.log(`[CrossFileHealer] 🔄 "${symbolName}" re-exported from "${traceResult.modulePath}" - following chain`);
                 return CrossFileHealer.heal(traceResult.modulePath, traceResult.symbolName, newValue, externalPath, project, depth + 1);
             }
             return {

package/dist/services/DefinitionTracer.d.ts

@@ -3,7 +3,7 @@ export type TraceResult = {
     found: true;
     targetNode: Node;
     targetFile: SourceFile;
-    /** The enclosing VariableDeclaration or PropertyAssignment — used by BlastRadiusAnalyzer. */
+    /** The enclosing VariableDeclaration or PropertyAssignment - used by BlastRadiusAnalyzer. */
     declarationNode?: Node;
 } | {
     found: false;

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

@@ -1 +1 @@
-{"version":3,"file":"DefinitionTracer.d.ts","sourceRoot":"","sources":["../../src/services/DefinitionTracer.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,IAAI,EACJ,UAAU,EAKV,aAAa,EACb,6BAA6B,EAC7B,kBAAkB,EAGnB,MAAM,UAAU,CAAC;AAMlB,MAAM,MAAM,WAAW,GACnB;IACE,KAAK,EAAE,IAAI,CAAC;IACZ,UAAU,EAAE,IAAI,CAAC;IACjB,UAAU,EAAE,UAAU,CAAC;IACvB,6FAA6F;IAC7F,eAAe,CAAC,EAAE,IAAI,CAAC;CACxB,GACD;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,SAAS,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACzE;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,SAAS,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvD,MAAM,MAAM,kBAAkB,GAC1B;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,YAAY,EAAE,kBAAkB,CAAC;IACjC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,YAAY,EAAE,UAAU,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;CACtB,GACD;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,WAAW,EAAE,aAAa,GAAG,6BAA6B,CAAC;IAC3D,YAAY,EAAE,UAAU,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;CACtB,GACD;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAcxC,qBAAa,gBAAgB;IAK3B,MAAM,CAAC,eAAe,CACpB,cAAc,EAAE,IAAI,EACpB,UAAU,EAAE,UAAU,EACtB,UAAU,EAAE,MAAM,EAClB,KAAK,SAAI,GACR,WAAW;IAqFd,MAAM,CAAC,mBAAmB,CACxB,cAAc,EAAE,IAAI,EACpB,UAAU,EAAE,UAAU,EACtB,UAAU,EAAE,MAAM,GACjB,WAAW;IA0Ed,MAAM,CAAC,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,WAAW;CA6B5E;AASD,qBAAa,wBAAwB;IACnC,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,GAAG,kBAAkB;CAiF3E"}
+{"version":3,"file":"DefinitionTracer.d.ts","sourceRoot":"","sources":["../../src/services/DefinitionTracer.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,IAAI,EACJ,UAAU,EAKV,aAAa,EACb,6BAA6B,EAC7B,kBAAkB,EAGnB,MAAM,UAAU,CAAC;AAMlB,MAAM,MAAM,WAAW,GACnB;IACE,KAAK,EAAE,IAAI,CAAC;IACZ,UAAU,EAAE,IAAI,CAAC;IACjB,UAAU,EAAE,UAAU,CAAC;IACvB,6FAA6F;IAC7F,eAAe,CAAC,EAAE,IAAI,CAAC;CACxB,GACD;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,SAAS,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACzE;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,SAAS,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvD,MAAM,MAAM,kBAAkB,GAC1B;IACE,IAAI,EAAE,UAAU,CAAC;IACjB,YAAY,EAAE,kBAAkB,CAAC;IACjC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,YAAY,EAAE,UAAU,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;CACtB,GACD;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,WAAW,EAAE,aAAa,GAAG,6BAA6B,CAAC;IAC3D,YAAY,EAAE,UAAU,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;CACtB,GACD;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAcxC,qBAAa,gBAAgB;IAK3B,MAAM,CAAC,eAAe,CACpB,cAAc,EAAE,IAAI,EACpB,UAAU,EAAE,UAAU,EACtB,UAAU,EAAE,MAAM,EAClB,KAAK,SAAI,GACR,WAAW;IA0Fd,MAAM,CAAC,mBAAmB,CACxB,cAAc,EAAE,IAAI,EACpB,UAAU,EAAE,UAAU,EACtB,UAAU,EAAE,MAAM,GACjB,WAAW;IA+Ed,MAAM,CAAC,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,WAAW;CAkC5E;AASD,qBAAa,wBAAwB;IACnC,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,GAAG,kBAAkB;CAmF3E"}

package/dist/services/DefinitionTracer.js

@@ -5,8 +5,8 @@ const ts_morph_1 = require("ts-morph");
 // ═══════════════════════════════════════════════════════════════════
 // DefinitionTracer
 //
-// T-5: traceIdentifier — follow bare variable name to its initializer.
-// T-6: tracePropertyAccess — follow OBJECT.prop to the property value.
+// T-5: traceIdentifier - follow bare variable name to its initializer.
+// T-6: tracePropertyAccess - follow OBJECT.prop to the property value.
 //
 // In-file first; signals crossFile when symbol comes from an import.
 // Never does I/O beyond what ts-morph provides on the given SourceFile.
@@ -42,9 +42,14 @@ class DefinitionTracer {
             }
             console.log(`[DefinitionTracer] ✅ traceIdentifier: "${symbolName}" → ` +
                 `${init.getKindName()} @ ${sourceFile.getBaseName()}:${init.getStartLineNumber()}`);
-            return { found: true, targetNode: init, targetFile: sourceFile, declarationNode: decl };
+            return {
+                found: true,
+                targetNode: init,
+                targetFile: sourceFile,
+                declarationNode: decl,
+            };
         }
-        // 2. Symbol not in file — check import declarations.
+        // 2. Symbol not in file - check import declarations.
         const imported = findImportedSymbol(sourceFile, symbolName);
         if (imported) {
             console.log(`[DefinitionTracer] 🌐 traceIdentifier: "${symbolName}" comes from "${imported.modulePath}" (cross-file)`);
@@ -71,7 +76,7 @@ class DefinitionTracer {
             }
         }
         catch {
-            // Language service unavailable — not an error.
+            // Language service unavailable - not an error.
         }
         return {
             found: false,
@@ -115,7 +120,7 @@ class DefinitionTracer {
                 reason: `"${objectName}" initializer is not an ObjectLiteralExpression (got ${init?.getKindName() ?? "none"})`,
             };
         }
-        // ts-morph getProperty(name) — returns the first matching property.
+        // ts-morph getProperty(name) - returns the first matching property.
         const prop = init.getProperty(propName);
         if (!prop || !ts_morph_1.Node.isPropertyAssignment(prop)) {
             return {
@@ -135,10 +140,15 @@ class DefinitionTracer {
         console.log(`[DefinitionTracer] ✅ tracePropertyAccess: "${objectName}.${propName}" → ` +
             `${valueNode.getKindName()} "${valueNode.getText()}" ` +
             `@ ${sourceFile.getBaseName()}:${valueNode.getStartLineNumber()}`);
-        return { found: true, targetNode: valueNode, targetFile: sourceFile, declarationNode: prop };
+        return {
+            found: true,
+            targetNode: valueNode,
+            targetFile: sourceFile,
+            declarationNode: prop,
+        };
     }
     // ─────────────────────────────────────────────────────────────────
-    // traceByName — used by CrossFileHealer
+    // traceByName - used by CrossFileHealer
     //
     // Like traceIdentifier but takes a plain symbol name string instead
     // of an Identifier node.  Searches the entire file (no callerLine
@@ -166,7 +176,12 @@ class DefinitionTracer {
         }
         console.log(`[DefinitionTracer] ✅ traceByName: "${symbolName}" → ` +
             `${init.getKindName()} @ ${sourceFile.getBaseName()}:${init.getStartLineNumber()}`);
-        return { found: true, targetNode: init, targetFile: sourceFile, declarationNode: decl };
+        return {
+            found: true,
+            targetNode: init,
+            targetFile: sourceFile,
+            declarationNode: decl,
+        };
     }
 }
 exports.DefinitionTracer = DefinitionTracer;
@@ -241,7 +256,7 @@ class FunctionalReturnAnalyzer {
         }
         return {
             kind: "complex",
-            reason: `"${calleeName}" return expression is ${returnExpr.getKindName()} — not directly healable`,
+            reason: `"${calleeName}" return expression is ${returnExpr.getKindName()} - not directly healable`,
         };
     }
 }
@@ -316,7 +331,7 @@ function findFunctionBody(sourceFile, fnName) {
             const arrow = init;
             const params = arrow.getParameters().map((p) => p.getName());
             const body = arrow.getBody();
-            // Concise body: (role) => `...`  — body IS the return expression.
+            // Concise body: (role) => `...`  - body IS the return expression.
             if (!ts_morph_1.Node.isBlock(body)) {
                 return { returnExpr: body, params, line: decl.getStartLineNumber() };
             }
@@ -338,13 +353,13 @@ function findFunctionBody(sourceFile, fnName) {
     return null;
 }
 function extractReturnExpression(body) {
-    // Concise arrow body — the node itself is the return value.
+    // Concise arrow body - the node itself is the return value.
     if (!ts_morph_1.Node.isBlock(body))
         return body;
     // Block body: search for ReturnStatement.
     const returnStmts = body.getDescendantsOfKind(ts_morph_1.SyntaxKind.ReturnStatement);
     if (returnStmts.length === 0)
         return null;
-    // Use the first one — for conditional returns we signal COMPLEX upstream.
+    // Use the first one - for conditional returns we signal COMPLEX upstream.
     return returnStmts[0].getExpression() ?? null;
 }

package/dist/services/DnaEditorService.d.ts

@@ -1,4 +1,4 @@
-import type { ElementSnapshotV2 } from '../types/index.js';
+import type { ElementSnapshotV2 } from "../types/index.js";
 export interface ValidationResult {
     valid: boolean;
     errors: string[];
@@ -9,7 +9,7 @@ export interface DnaSnapshotExtended extends ElementSnapshotV2 {
     sourceFile?: string;
     sourceLine?: number;
     lastHealed?: string | null;
-    status?: 'healed' | 'broken';
+    status?: "healed" | "broken";
     originalSelector?: string;
     healedSelector?: string;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"DnaEditorService.d.ts","sourceRoot":"","sources":["../../src/services/DnaEditorService.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAID,MAAM,WAAW,mBAAoB,SAAQ,iBAAiB;IAC5D,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,QAAQ,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAEpD,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAChD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,OAAO,GAAG,gBAAgB,CAAC;CAChD;AA4BD,qBAAa,gBAAiB,YAAW,iBAAiB;IAC5C,OAAO,CAAC,QAAQ,CAAC,WAAW;gBAAX,WAAW,EAAE,MAAM;IAE1C,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAgB/C,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC;IAwCpD,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa1C,QAAQ,CAAC,SAAS,EAAE,OAAO,GAAG,gBAAgB;CAoG/C"}
+{"version":3,"file":"DnaEditorService.d.ts","sourceRoot":"","sources":["../../src/services/DnaEditorService.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE3D,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAID,MAAM,WAAW,mBAAoB,SAAQ,iBAAiB;IAC5D,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,QAAQ,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAEpD,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAChD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACrD,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,OAAO,GAAG,gBAAgB,CAAC;CAChD;AA6BD,qBAAa,gBAAiB,YAAW,iBAAiB;IAC5C,OAAO,CAAC,QAAQ,CAAC,WAAW;gBAAX,WAAW,EAAE,MAAM;IAE1C,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAgB/C,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC;IA2CpD,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa1C,QAAQ,CAAC,SAAS,EAAE,OAAO,GAAG,gBAAgB;CA4H/C"}

package/dist/services/DnaEditorService.js

@@ -17,14 +17,14 @@ function bakPath(dir, key) {
 }
 // Derive a best-effort selector from engine snapshot fields when none is stored.
 function deriveSelector(snap) {
-    const id = snap['id'];
-    const classes = snap['classes'];
-    const tagName = snap['tagName'];
-    if (typeof id === 'string' && id)
+    const id = snap["id"];
+    const classes = snap["classes"];
+    const tagName = snap["tagName"];
+    if (typeof id === "string" && id)
         return `#${id}`;
     if (Array.isArray(classes) && classes.length > 0)
-        return `.${classes.join('.')}`;
-    return typeof tagName === 'string' ? tagName : 'unknown';
+        return `.${classes.join(".")}`;
+    return typeof tagName === "string" ? tagName : "unknown";
 }
 function dnaError(message, code) {
     const err = new Error(message);
@@ -40,15 +40,15 @@ class DnaEditorService {
         const target = jsonPath(this.snapshotDir, key);
         let raw;
         try {
-            raw = await promises_1.default.readFile(target, 'utf-8');
+            raw = await promises_1.default.readFile(target, "utf-8");
         }
         catch {
-            throw dnaError(`DNA not found: ${key}`, 'DNA_NOT_FOUND');
+            throw dnaError(`DNA not found: ${key}`, "DNA_NOT_FOUND");
         }
         const parsed = JSON.parse(raw);
         // Promote to extended format if selector not stored
-        if (!parsed['selector']) {
-            parsed['selector'] = deriveSelector(parsed);
+        if (!parsed["selector"]) {
+            parsed["selector"] = deriveSelector(parsed);
         }
         return parsed;
     }
@@ -59,22 +59,25 @@ class DnaEditorService {
         // 1. Read existing snapshot
         const original = await this.read(key);
         // 2. Shallow-merge patch (arrays and objects replaced, not deep-merged)
-        const merged = { ...original, ...patch };
+        const merged = {
+            ...original,
+            ...patch,
+        };
         // Any CLI write = human has reviewed the DNA → clear auto-heal status flag.
-        delete merged['status'];
-        // 3. Derive selector only when absent — never override an explicit (possibly invalid) value
-        if (merged['selector'] == null) {
-            merged['selector'] = deriveSelector(merged);
+        delete merged["status"];
+        // 3. Derive selector only when absent - never override an explicit (possibly invalid) value
+        if (merged["selector"] == null) {
+            merged["selector"] = deriveSelector(merged);
         }
         // 4. Validate before touching disk
         const validation = this.validate(merged);
         if (!validation.valid) {
-            throw dnaError(`Validation failed for ${key}: ${validation.errors.join('; ')}`, 'VALIDATION_FAILED');
+            throw dnaError(`Validation failed for ${key}: ${validation.errors.join("; ")}`, "VALIDATION_FAILED");
         }
         // 5. Backup current file (overwrite previous bak)
-        await promises_1.default.writeFile(bak, JSON.stringify(original, null, 2), 'utf-8');
+        await promises_1.default.writeFile(bak, JSON.stringify(original, null, 2), "utf-8");
         // 6. Write to tmp
-        await promises_1.default.writeFile(tmp, JSON.stringify(merged, null, 2), 'utf-8');
+        await promises_1.default.writeFile(tmp, JSON.stringify(merged, null, 2), "utf-8");
         // 7. Atomic rename tmp → json
         await promises_1.default.rename(tmp, target);
         return bak;
@@ -86,111 +89,127 @@ class DnaEditorService {
             await promises_1.default.access(bak);
         }
         catch {
-            throw dnaError(`No backup found for: ${key}`, 'DNA_NOT_FOUND');
+            throw dnaError(`No backup found for: ${key}`, "DNA_NOT_FOUND");
         }
         await promises_1.default.rename(bak, target);
     }
     validate(candidate) {
         const errors = [];
-        if (typeof candidate !== 'object' || candidate === null || Array.isArray(candidate)) {
-            return { valid: false, errors: ['candidate must be a plain object'] };
+        if (typeof candidate !== "object" ||
+            candidate === null ||
+            Array.isArray(candidate)) {
+            return { valid: false, errors: ["candidate must be a plain object"] };
         }
         const snap = candidate;
         // ── Required top-level fields ─────────────────────────────────────────────
-        for (const field of ['tagName', 'selector', 'schemaVersion', 'timestamp']) {
+        for (const field of [
+            "tagName",
+            "selector",
+            "schemaVersion",
+            "timestamp",
+        ]) {
             if (!(field in snap) || snap[field] === undefined) {
                 errors.push(`Missing required field: ${field}`);
             }
         }
-        if (snap['schemaVersion'] !== 2) {
-            errors.push(`schemaVersion must be 2, got ${String(snap['schemaVersion'])}`);
+        if (snap["schemaVersion"] !== 2) {
+            errors.push(`schemaVersion must be 2, got ${String(snap["schemaVersion"])}`);
         }
         // ── selector ─────────────────────────────────────────────────────────────
-        const sel = snap['selector'];
-        if (typeof sel === 'string') {
-            if (sel.trim() === '')
-                errors.push('selector must not be empty');
-            if (sel === 'undefined')
+        const sel = snap["selector"];
+        if (typeof sel === "string") {
+            if (sel.trim() === "")
+                errors.push("selector must not be empty");
+            if (sel === "undefined")
                 errors.push('selector must not be the string "undefined"');
             if (/[\r\n]/.test(sel))
-                errors.push('selector must not contain raw newlines');
+                errors.push("selector must not contain raw newlines");
         }
-        else if ('selector' in snap) {
-            errors.push('selector must be a string');
+        else if ("selector" in snap) {
+            errors.push("selector must be a string");
         }
         // ── tagName ───────────────────────────────────────────────────────────────
-        const tag = snap['tagName'];
-        if (typeof tag === 'string') {
+        const tag = snap["tagName"];
+        if (typeof tag === "string") {
             if (!/^[a-z][a-z0-9-]*$/.test(tag)) {
-                errors.push('tagName must match /^[a-z][a-z0-9-]*$/');
+                errors.push("tagName must match /^[a-z][a-z0-9-]*$/");
             }
         }
-        else if ('tagName' in snap) {
-            errors.push('tagName must be a string');
+        else if ("tagName" in snap) {
+            errors.push("tagName must be a string");
         }
         // ── text ─────────────────────────────────────────────────────────────────
-        const text = snap['text'];
+        const text = snap["text"];
         if (text !== null && text !== undefined) {
-            if (typeof text !== 'string') {
-                errors.push('text must be a string or null');
+            if (typeof text !== "string") {
+                errors.push("text must be a string or null");
             }
             else if (text.length >= 2000) {
-                errors.push('text must be fewer than 2000 characters');
+                errors.push("text must be fewer than 2000 characters");
             }
         }
         // ── attributes ───────────────────────────────────────────────────────────
-        const attrs = snap['attributes'];
+        const attrs = snap["attributes"];
         if (attrs !== undefined) {
-            if (typeof attrs !== 'object' || attrs === null || Array.isArray(attrs)) {
-                errors.push('attributes must be a plain object');
+            if (typeof attrs !== "object" || attrs === null || Array.isArray(attrs)) {
+                errors.push("attributes must be a plain object");
             }
             else {
                 for (const [k, v] of Object.entries(attrs)) {
                     if (!k)
-                        errors.push('attributes keys must not be empty');
-                    if (typeof v !== 'string')
+                        errors.push("attributes keys must not be empty");
+                    if (typeof v !== "string")
                         errors.push(`attributes["${k}"] must be a string`);
                 }
             }
         }
         // ── visibility (all 4 keys required) ─────────────────────────────────────
-        const vis = snap['visibility'];
-        if (typeof vis === 'object' && vis !== null && !Array.isArray(vis)) {
+        const vis = snap["visibility"];
+        if (typeof vis === "object" && vis !== null && !Array.isArray(vis)) {
             const visObj = vis;
-            for (const key of ['isGhost', 'ghostReason', 'isOccluded', 'opacity']) {
+            for (const key of [
+                "isGhost",
+                "ghostReason",
+                "isOccluded",
+                "opacity",
+            ]) {
                 if (!(key in visObj))
                     errors.push(`visibility.${key} is required`);
             }
         }
         else {
-            errors.push('visibility block is required and must be an object');
+            errors.push("visibility block is required and must be an object");
         }
         // ── anchors (all 3 keys required) ────────────────────────────────────────
-        const anch = snap['anchors'];
-        if (typeof anch === 'object' && anch !== null && !Array.isArray(anch)) {
+        const anch = snap["anchors"];
+        if (typeof anch === "object" && anch !== null && !Array.isArray(anch)) {
             const anchObj = anch;
-            for (const key of ['closestLabel', 'rowAnchor', 'neighborTexts']) {
+            for (const key of [
+                "closestLabel",
+                "rowAnchor",
+                "neighborTexts",
+            ]) {
                 if (!(key in anchObj))
                     errors.push(`anchors.${key} is required`);
             }
-            const cl = anchObj['closestLabel'];
-            if (cl !== null && typeof cl !== 'string') {
-                errors.push('anchors.closestLabel must be a string or null');
+            const cl = anchObj["closestLabel"];
+            if (cl !== null && typeof cl !== "string") {
+                errors.push("anchors.closestLabel must be a string or null");
             }
-            const nt = anchObj['neighborTexts'];
+            const nt = anchObj["neighborTexts"];
             if (!Array.isArray(nt)) {
-                errors.push('anchors.neighborTexts must be an array');
+                errors.push("anchors.neighborTexts must be an array");
             }
             else {
                 if (nt.length > 10)
-                    errors.push('anchors.neighborTexts must have at most 10 elements');
-                if (!nt.every((x) => typeof x === 'string')) {
-                    errors.push('anchors.neighborTexts elements must all be strings');
+                    errors.push("anchors.neighborTexts must have at most 10 elements");
+                if (!nt.every((x) => typeof x === "string")) {
+                    errors.push("anchors.neighborTexts elements must all be strings");
                 }
             }
         }
         else {
-            errors.push('anchors block is required and must be an object');
+            errors.push("anchors block is required and must be an object");
         }
         return { valid: errors.length === 0, errors };
     }

package/dist/services/DnaIndexService.d.ts

@@ -1,4 +1,4 @@
-import type { DnaRecord, DnaIndex } from './types.js';
+import type { DnaRecord, DnaIndex } from "./types.js";
 export interface IDnaIndexService {
     buildIndex(snapshotDir: string): Promise<DnaIndex>;
     findBySelector(pattern: string): DnaRecord[];

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

@@ -1 +1 @@
-{"version":3,"file":"DnaIndexService.d.ts","sourceRoot":"","sources":["../../src/services/DnaIndexService.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAatD,MAAM,WAAW,gBAAgB;IAC/B,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnD,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,CAAC;IAC7C,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,CAAC;IACzC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,CAAC;IAChD,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,CAAC;IAC9C,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IACxC,QAAQ,IAAI,QAAQ,CAAC;IACrB,OAAO,IAAI,IAAI,CAAC;CACjB;AAkED,qBAAa,eAAgB,YAAW,gBAAgB;IACtD,OAAO,CAAC,WAAW,CAAyB;IAEtC,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAkCxD,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE;IAK5C,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE;IAKxC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE;IAO/C,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE;IAK7C,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAIvC,QAAQ,IAAI,QAAQ;IAIpB,OAAO,IAAI,IAAI;IAIf,OAAO,CAAC,YAAY;CAQrB"}
+{"version":3,"file":"DnaIndexService.d.ts","sourceRoot":"","sources":["../../src/services/DnaIndexService.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAatD,MAAM,WAAW,gBAAgB;IAC/B,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACnD,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,CAAC;IAC7C,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,CAAC;IACzC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,CAAC;IAChD,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,CAAC;IAC9C,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IACxC,QAAQ,IAAI,QAAQ,CAAC;IACrB,OAAO,IAAI,IAAI,CAAC;CACjB;AAkED,qBAAa,eAAgB,YAAW,gBAAgB;IACtD,OAAO,CAAC,WAAW,CAAyB;IAEtC,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAoCxD,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE;IAK5C,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE;IAOxC,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE;IAO/C,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE;IAK7C,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAIvC,QAAQ,IAAI,QAAQ;IAIpB,OAAO,IAAI,IAAI;IAIf,OAAO,CAAC,YAAY;CAQrB"}