sela-core 0.1.0-alpha.1

package/dist/services/BlastRadiusAnalyzer.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BlastRadiusAnalyzer = void 0;
+const ts_morph_1 = require("ts-morph");
+const logger_1 = require("../utils/logger");
+// ═══════════════════════════════════════════════════════════════════
+// BlastRadiusAnalyzer
+//
+// Before mutating a definition-site node, determine how many tests
+// reference it.  Uses ts-morph's findReferences() for cross-file
+// accuracy.  On any analysis failure, defaults to risk:'low' and logs
+// a warning - never blocks healing due to analysis error.
+// ═══════════════════════════════════════════════════════════════════
+class BlastRadiusAnalyzer {
+    static analyze(declarationNode, _sourceFile, _project) {
+        try {
+            return BlastRadiusAnalyzer.doAnalyze(declarationNode);
+        }
+        catch (e) {
+            logger_1.logger.warn(`BlastRadius analysis failed, defaulting to low risk: ${e.message}`);
+            return {
+                totalReferences: 0,
+                testFunctionCount: 0,
+                affectedFiles: [],
+                risk: "low",
+            };
+        }
+    }
+    static doAnalyze(declarationNode) {
+        const nameNode = BlastRadiusAnalyzer.getNameNode(declarationNode);
+        if (!nameNode) {
+            return {
+                totalReferences: 0,
+                testFunctionCount: 0,
+                affectedFiles: [],
+                risk: "low",
+            };
+        }
+        const refs = nameNode
+            .getProject()
+            .getLanguageService()
+            .findReferences(nameNode);
+        const affectedFilesSet = new Set();
+        let totalRefs = 0;
+        // Key = filePath:startLine of the enclosing test() / it() call.
+        const enclosingTestKeys = new Set();
+        for (const refSymbol of refs) {
+            for (const ref of refSymbol.getReferences()) {
+                if (ref.isDefinition())
+                    continue;
+                totalRefs++;
+                affectedFilesSet.add(ref.getSourceFile().getFilePath());
+                // Walk ancestors to find the enclosing test() or it() call.
+                let ancestor = ref.getNode();
+                while (ancestor) {
+                    if (ts_morph_1.Node.isCallExpression(ancestor) &&
+                        BlastRadiusAnalyzer.isTestCall(ancestor)) {
+                        enclosingTestKeys.add(`${ref.getSourceFile().getFilePath()}:${ancestor.getStartLineNumber()}`);
+                        break;
+                    }
+                    ancestor = ancestor.getParent();
+                }
+            }
+        }
+        const testFunctionCount = enclosingTestKeys.size;
+        const risk = testFunctionCount >= 4
+            ? "high"
+            : testFunctionCount >= 2
+                ? "medium"
+                : "low";
+        return {
+            totalReferences: totalRefs,
+            testFunctionCount,
+            affectedFiles: [...affectedFilesSet],
+            risk,
+        };
+    }
+    static getNameNode(node) {
+        if (ts_morph_1.Node.isVariableDeclaration(node))
+            return node.getNameNode();
+        if (node.getKind() === ts_morph_1.SyntaxKind.PropertyAssignment &&
+            ts_morph_1.Node.isPropertyAssignment(node)) {
+            return node.getNameNode();
+        }
+        // For already-resolved StringLiteral / Identifier targets.
+        return node;
+    }
+    static isTestCall(call) {
+        if (!ts_morph_1.Node.isCallExpression(call))
+            return false;
+        const expr = call.getExpression();
+        // Handles: test("...", ...) and test.only / test.skip etc.
+        if (ts_morph_1.Node.isIdentifier(expr)) {
+            const name = expr.getText();
+            return name === "test" || name === "it";
+        }
+        if (ts_morph_1.Node.isPropertyAccessExpression(expr)) {
+            const obj = expr.getExpression();
+            if (ts_morph_1.Node.isIdentifier(obj)) {
+                const name = obj.getText();
+                return name === "test" || name === "it";
+            }
+        }
+        return false;
+    }
+}
+exports.BlastRadiusAnalyzer = BlastRadiusAnalyzer;

package/dist/services/ChainValidator.d.ts

@@ -0,0 +1,76 @@
+export type ChainSegment = {
+    type: "locator";
+    selector: string;
+} | {
+    type: "frameLocator";
+    selector: string;
+} | {
+    type: "getByRole";
+    role: string;
+    name?: string;
+    exact?: boolean;
+} | {
+    type: "getByLabel";
+    text: string;
+    exact?: boolean;
+} | {
+    type: "getByText";
+    text: string;
+    exact?: boolean;
+} | {
+    type: "getByPlaceholder";
+    text: string;
+} | {
+    type: "getByTestId";
+    testId: string;
+} | {
+    type: "getByAltText";
+    text: string;
+} | {
+    type: "getByTitle";
+    text: string;
+} | {
+    type: "filter";
+    hasText?: string;
+    hasNotText?: string;
+    has?: string;
+    hasNot?: string;
+} | {
+    type: "first";
+} | {
+    type: "last";
+} | {
+    type: "nth";
+    index: number;
+};
+export type ReturnType = "Locator" | "FrameLocator" | "unknown";
+export interface ValidationResult {
+    valid: boolean;
+    reason?: string;
+    segments?: ChainSegment[];
+}
+export declare function segmentsToCode(receiver: string, segments: ChainSegment[], multiLine?: boolean): string;
+export interface ChainValidationInput {
+    segments: unknown[];
+    originalRootReceiver: string;
+    proposedRootReceiver: string;
+    rootType?: ReturnType;
+    applySemanticUpgrade?: boolean;
+}
+export interface ChainValidationOutput {
+    valid: boolean;
+    reason?: string;
+    segments?: ChainSegment[];
+    code?: string;
+    multiLine?: boolean;
+}
+export declare class ChainValidator {
+    validate(input: ChainValidationInput): ChainValidationOutput;
+    /**
+     * Lightweight check: does this segment array describe the same
+     * semantic intent as the old flat selector string?
+     * Used as a sanity check before committing an AST write.
+     */
+    intentMatches(segments: ChainSegment[], oldFlatSelector: string): boolean;
+}
+//# sourceMappingURL=ChainValidator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ChainValidator.d.ts","sourceRoot":"","sources":["../../src/services/ChainValidator.ts"],"names":[],"mappings":"AAuBA,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GACnE;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACpC;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GACD;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnC,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,cAAc,GAAG,SAAS,CAAC;AAEhE,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;CAC3B;AA2cD,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,YAAY,EAAE,EACxB,SAAS,GAAE,OAAe,GACzB,MAAM,CAkER;AAWD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,EAAE,UAAU,CAAC;IACtB,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,qBAAa,cAAc;IACzB,QAAQ,CAAC,KAAK,EAAE,oBAAoB,GAAG,qBAAqB;IAsE5D;;;;OAIG;IACH,aAAa,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO;CA0B1E"}