@selfcure/selfcure 0.1.0

package/README.md

@@ -0,0 +1,17 @@
+# @selfcure/selfcure
+
+> Self-healing loop for **selfcure** — feeds trace + error to the configured LLM, applies a diff, and re-validates.
+
+Part of selfcure's **legacy BYOK pipeline** (fallback for teams not using the Playwright Test Agents' Healer). On a failing test, it sends the trace and error to the configured provider, applies the proposed diff, and re-runs to confirm the fix. **BYOK** — bring your own key.
+
+Internal library powering `selfcure heal`. The headline, preventive flow is `selfcure lint` — see [`@selfcure/cli`](https://www.npmjs.com/package/@selfcure/cli).
+
+## Install
+
+```bash
+npm install @selfcure/selfcure
+```
+
+## Docs
+
+Full documentation: https://github.com/ricardofrancocustodio/selfcure#readme

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+import { AIConfig } from '@selfcure/generator';
+import { TestResult } from '@selfcure/runner';
+
+interface HealOptions {
+    /** Resolved `ai` block from selfcure.config.mjs — provider + model overrides */
+    ai: AIConfig;
+    /** How many times to attempt patching before giving up */
+    maxAttempts?: number;
+    /** Playwright config needed to re-run after patching */
+    playwrightConfig: string;
+}
+interface HealResult {
+    filePath: string;
+    healed: boolean;
+    attempts: number;
+    /** Unified diff that was ultimately applied, if any */
+    patchApplied?: string;
+    finalError?: string;
+}
+/**
+ * For each failing test result, ask the configured LLM for a diff, apply it,
+ * and re-validate by reading the patched file. Rejects the patch and rolls
+ * back if the file cannot be parsed after patching.
+ */
+declare function heal(failedTests: TestResult[], options: HealOptions): Promise<HealResult[]>;
+
+export { type HealOptions, type HealResult, heal as default, heal };

package/dist/index.js

@@ -0,0 +1,71 @@
+// src/index.ts
+import { generateText } from "ai";
+import fs from "fs-extra";
+import { getModel } from "@selfcure/generator";
+function buildHealPrompt(result, source) {
+  return `You are an expert Playwright test engineer fixing a failing test.
+
+## Failing test file
+\`\`\`typescript
+${source}
+\`\`\`
+
+## Error
+\`\`\`
+${result.error ?? "Unknown error"}
+\`\`\`
+
+Produce a unified diff (--- a/test  +++ b/test) that fixes the failure.
+Output ONLY the diff, no explanation.`;
+}
+function applyUnifiedDiff(original, diff) {
+  const lines = original.split("\n");
+  for (const line of diff.split("\n")) {
+    if (line.startsWith("-") && !line.startsWith("---")) {
+      const idx = lines.indexOf(line.slice(1));
+      if (idx !== -1) lines.splice(idx, 1);
+    } else if (line.startsWith("+") && !line.startsWith("+++")) {
+      lines.push(line.slice(1));
+    }
+  }
+  return lines.join("\n");
+}
+async function heal(failedTests, options) {
+  const model = getModel(options.ai, "healing");
+  const maxAttempts = options.maxAttempts ?? 3;
+  const results = [];
+  for (const failed of failedTests) {
+    if (failed.passed) continue;
+    let attempts = 0;
+    let healed = false;
+    let patchApplied;
+    let finalError;
+    const original = await fs.readFile(failed.filePath, "utf-8");
+    while (attempts < maxAttempts && !healed) {
+      attempts++;
+      const current = await fs.readFile(failed.filePath, "utf-8");
+      const { text: diff } = await generateText({
+        model,
+        prompt: buildHealPrompt(failed, current),
+        maxOutputTokens: 2048
+      });
+      const patched = applyUnifiedDiff(current, diff);
+      try {
+        new Function(patched.replace(/^import .+$/gm, ""));
+        await fs.writeFile(failed.filePath, patched, "utf-8");
+        patchApplied = diff;
+        healed = true;
+      } catch (err) {
+        finalError = String(err);
+        await fs.writeFile(failed.filePath, original, "utf-8");
+      }
+    }
+    results.push({ filePath: failed.filePath, healed, attempts, patchApplied, finalError });
+  }
+  return results;
+}
+var index_default = heal;
+export {
+  index_default as default,
+  heal
+};

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@selfcure/selfcure",
+  "version": "0.1.0",
+  "description": "Self-healing loop — sends trace + error to the configured LLM, applies diff, re-validates",
+  "type": "module",
+  "license": "MIT",
+  "author": "ricardofrancocustodio",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ricardofrancocustodio/selfcure.git",
+    "directory": "packages/selfcure"
+  },
+  "homepage": "https://github.com/ricardofrancocustodio/selfcure#readme",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": ["dist"],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts",
+    "dev": "tsup src/index.ts --format esm --watch",
+    "test": "vitest"
+  },
+  "dependencies": {
+    "@selfcure/generator": "^0.1.0",
+    "@selfcure/runner": "^0.1.0",
+    "ai": "^6.0.191",
+    "fs-extra": "^11.3.5"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4"
+  }
+}