sela-core 0.1.0-alpha.1

package/dist/services/InteractiveReview.js

@@ -0,0 +1,128 @@
+"use strict";
+// src/services/InteractiveReview.ts
+//
+// Local DX - Post-run summary printer (MVP write-and-notify).
+//
+// The MVP flow is write-on-disk-then-notify: workers (and the engine)
+// already mutated the source files in-place during execution. The
+// reporter calls printHealReview() at the end purely to display:
+//   • a banner with the number of mutated files,
+//   • per-file isolated unified diff (clean room - never the working tree),
+//   • a vscode://file deeplink to the mutated line,
+//   • an optional deeplink to the generated HTML insights report.
+//
+// No prompts. No rollback. No blocking on stdin. SIGINT handling lives
+// in SelaReporter - this module is pure stdout/stderr.
+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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.printHealReview = printHealReview;
+const path = __importStar(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+const IsolatedDiff_1 = require("../utils/IsolatedDiff");
+/**
+ * Print the post-run review summary. Returns immediately - never blocks
+ * on stdin. Safe to call from the reporter's onEnd() in any environment
+ * (TTY, piped CI, IDE-integrated runner).
+ */
+function printHealReview(deps) {
+    const log = deps.log ?? ((m) => process.stdout.write(m + "\n"));
+    const entries = deps.entries ?? [];
+    const reportHtmlPath = deps.reportHtmlPath ?? null;
+    if (entries.length === 0 && !reportHtmlPath)
+        return;
+    log("");
+    if (entries.length > 0) {
+        // Count actual healed selectors (a file can hold several), not files.
+        const fileCount = entries.length;
+        const fixCount = entries.reduce((n, e) => n + (e.healCount ?? 1), 0);
+        log(chalk_1.default.bold.bgCyan.black(` [Sela] Local DX Review - ${fixCount} fix${fixCount === 1 ? "" : "es"} applied across ${fileCount} file${fileCount === 1 ? "" : "s"} `));
+        for (const entry of entries) {
+            renderEntry(entry, log);
+        }
+    }
+    if (reportHtmlPath) {
+        log("");
+        log(chalk_1.default.bold(`[Sela] 📄 Insights report:`));
+        log(`   ${chalk_1.default.cyan(buildFileLink(reportHtmlPath))}`);
+    }
+    log("");
+}
+function renderEntry(entry, log) {
+    const fileName = path.basename(entry.absolutePath);
+    const diff = (0, IsolatedDiff_1.generateUnifiedDiff)(entry.contentBefore, entry.contentAfter, {
+        filePath: entry.relativePath,
+    });
+    log("");
+    log(chalk_1.default.bold(`[Sela] 🔧 Healed selector in ${fileName}`));
+    log("");
+    log(colorizeDiff(diff));
+    log("");
+    log(`👉 Open in VS Code:`);
+    log(`   ${chalk_1.default.cyan(buildVsCodeLink(entry.absolutePath, entry.lineNumber))}`);
+}
+function colorizeDiff(diff) {
+    if (!diff)
+        return chalk_1.default.dim("(no diff)");
+    return diff
+        .split("\n")
+        .map((row) => {
+        if (row.startsWith("+++") ||
+            row.startsWith("---") ||
+            row.startsWith("diff --git")) {
+            return chalk_1.default.bold(row);
+        }
+        if (row.startsWith("@@"))
+            return chalk_1.default.cyan(row);
+        if (row.startsWith("+"))
+            return chalk_1.default.green(row);
+        if (row.startsWith("-"))
+            return chalk_1.default.red(row);
+        return row;
+    })
+        .join("\n");
+}
+function buildVsCodeLink(absPath, line) {
+    const normalised = absPath.split(path.sep).join("/");
+    return line && line > 0
+        ? `vscode://file/${normalised}:${line}`
+        : `vscode://file/${normalised}`;
+}
+function buildFileLink(absPath) {
+    const normalised = absPath.split(path.sep).join("/");
+    return `file://${normalised}`;
+}

package/dist/services/LLMService.d.ts

@@ -0,0 +1,121 @@
+import Anthropic from "@anthropic-ai/sdk";
+import { FixRequest } from "../types";
+export interface SelectorSegment {
+    type: "frame" | "element";
+    selector: string;
+}
+export interface ContentChange {
+    oldText: string;
+    newText: string;
+}
+export type SmartChainSegment = {
+    type: "locator";
+    selector: string;
+    hasText?: string;
+    has?: string;
+    hasNot?: string;
+} | {
+    type: "frameLocator";
+    selector: string;
+} | {
+    type: "getByRole";
+    role: string;
+    name?: string;
+    exact?: boolean;
+    level?: number;
+    checked?: boolean;
+    pressed?: boolean;
+    expanded?: boolean;
+    selected?: boolean;
+    disabled?: boolean;
+} | {
+    type: "getByLabel";
+    text: string;
+    exact?: boolean;
+} | {
+    type: "getByText";
+    text: string;
+    exact?: boolean;
+} | {
+    type: "getByPlaceholder";
+    text: string;
+    exact?: boolean;
+} | {
+    type: "getByTestId";
+    testId: string;
+} | {
+    type: "getByAltText";
+    text: string;
+    exact?: boolean;
+} | {
+    type: "getByTitle";
+    text: string;
+    exact?: boolean;
+} | {
+    type: "filter";
+    hasText?: string;
+    hasNotText?: string;
+    has?: string;
+    hasNot?: string;
+} | {
+    type: "first";
+} | {
+    type: "last";
+} | {
+    type: "nth";
+    index: number;
+};
+export interface FixResponse {
+    status: "FIXED" | "NOT_FOUND";
+    /**
+     * LEGACY/PROXY: This selector is used for IMMEDIATE RETRY in the proxy.
+     * CRITICAL: Must be as specific as the chainSegments to avoid Strict Mode errors.
+     */
+    segments: SelectorSegment[];
+    /**
+     * NEW: Rich semantic chain segments for AST source update.
+     */
+    chainSegments?: SmartChainSegment[];
+    originalChainHint?: SmartChainSegment[];
+    /**
+     * Confidence score 0-100. Undefined when the model omitted it or returned a
+     * non-finite value - downstream code must treat undefined as "unknown" and
+     * render "n/a" rather than synthesising a 0.
+     */
+    confidence?: number;
+    explanation: string;
+    new_selector?: string | null;
+    contentChange?: ContentChange;
+}
+/**
+ * Constructor options for LLMService.
+ *
+ * - `anthropic`: pre-built Anthropic client. Tests use this to inject a
+ *   mock client without touching env vars or network.
+ * - `apiKey`: override the env-based ANTHROPIC_API_KEY when constructing
+ *   the default client.
+ * - `model`: override the Sonnet model id (lets tests pin the SDK call).
+ */
+export interface LLMServiceOptions {
+    anthropic?: Anthropic;
+    apiKey?: string;
+    model?: string;
+}
+export declare class LLMService {
+    private anthropic;
+    private readonly model;
+    constructor(opts?: LLMServiceOptions);
+    private cleanJson;
+    /**
+     * Attempts to infer contentChange when the AI did not return the field.
+     *
+     * Strategies (in order of confidence):
+     *
+     * 1. previousState.text  vs  has-text() in new selector
+     * 2. has-text() in old selector vs new selector
+     * 3. intentDescription text vs new selector
+     */
+    private inferContentChange;
+    getFix(request: FixRequest): Promise<FixResponse>;
+}
+//# sourceMappingURL=LLMService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LLMService.d.ts","sourceRoot":"","sources":["../../src/services/LLMService.ts"],"names":[],"mappings":"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"}