errase 1.0.0

package/README.md

@@ -0,0 +1,21 @@
+# ERRase CLI
+
+AI-powered browser debugging. Detects runtime errors, reads your source files, and applies fixes automatically.
+
+## Usage
+
+```bash
+npx errase /path/to/your/project
+```
+
+## Setup
+
+1. Install the [ERRase Chrome Extension](#)
+2. Get a free [Groq API key](https://console.groq.com)
+3. Enter your key in the extension popup
+4. Run `npx errase` in your project directory
+
+## Requirements
+
+- Node.js 18+
+- Next.js project (more frameworks coming soon)

package/dist/index.js

@@ -0,0 +1,185 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const express_1 = __importDefault(require("express"));
+const ws_1 = require("ws");
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const source_map_js_1 = require("source-map-js");
+const projectRoot = process.argv[2]
+    ? path_1.default.resolve(process.argv[2])
+    : process.cwd();
+const app = (0, express_1.default)();
+const server = app.listen(7891, () => [
+    console.log("[ERRase CLI] Running on port 7891"),
+    console.log("[ERRase CLI] Project root:", projectRoot)
+]);
+const wss = new ws_1.WebSocketServer({ server });
+// Extracts all bundled JS URLs + line/col from a raw browser stack trace
+function parseBundledStack(stack) {
+    const frames = [];
+    for (const line of stack.split(/\r?\n/)) {
+        const match = line.match(/\(?(https?:\/\/.+?\.js):(\d+):(\d+)\)?/);
+        if (match)
+            frames.push({ bundledUrl: match[1], line: parseInt(match[2]), column: parseInt(match[3]) });
+    }
+    return frames;
+}
+// Iterates all stack frames, resolves source maps, and returns the first frame
+// that maps to a project file (skipping node_modules frames).
+async function resolveToProjectFile(stack) {
+    const frames = parseBundledStack(stack);
+    for (const frame of frames) {
+        let rawMap;
+        try {
+            rawMap = await fetchSourceMap(frame.bundledUrl);
+        }
+        catch {
+            continue;
+        }
+        const consumer = new source_map_js_1.SourceMapConsumer(rawMap);
+        const original = consumer.originalPositionFor({ line: frame.line, column: frame.column });
+        if (!original.source || original.line == null)
+            continue;
+        if (original.source.includes("node_modules"))
+            continue;
+        const filename = stripSourcePrefix(original.source);
+        if (filename.includes("node_modules"))
+            continue;
+        return { filename, lineNumber: original.line };
+    }
+    return null;
+}
+async function fetchSourceMap(bundledUrl) {
+    const res = await fetch(bundledUrl + ".map");
+    if (!res.ok)
+        throw new Error(`Source map not found: ${bundledUrl}.map (${res.status})`);
+    return res.json();
+}
+// Strips webpack:// or file:// prefixes from source map source paths, returning
+// a path relative to projectRoot suitable for disk reads.
+// e.g. webpack://_N_E/./app/page.tsx       →  app/page.tsx
+//      file:///C:/path/to/project/app/page.tsx  →  app/page.tsx
+function stripSourcePrefix(source) {
+    const webpackMatch = source.match(/^webpack:\/\/[^/]*\/\.\/(.+)$/) ?? source.match(/^webpack:\/\/[^/]*\/(.+)$/);
+    if (webpackMatch)
+        return webpackMatch[1];
+    if (source.startsWith("file://")) {
+        const decoded = decodeURIComponent(source);
+        // file:///C:/... on Windows, file:///... on Unix
+        const absolute = decoded.replace(/^file:\/\/\//, "").replace(/^file:\/\//, "");
+        return path_1.default.relative(projectRoot, absolute);
+    }
+    return source;
+}
+function readContextLines(filename, lineNumber, context = 15) {
+    const fullPath = path_1.default.join(projectRoot, filename);
+    if (!fs_1.default.existsSync(fullPath))
+        throw new Error(`File not found: ${fullPath}`);
+    const lines = fs_1.default.readFileSync(fullPath, "utf-8").split("\n");
+    const start = Math.max(0, lineNumber - 1 - context);
+    const end = Math.min(lines.length, lineNumber + context);
+    return lines.slice(start, end).map((l, i) => `${start + i + 1}: ${l}`).join("\n");
+}
+wss.on("connection", (socket) => {
+    console.log("[ERRase CLI] Extension connected");
+    socket.on("message", async (data) => {
+        let message;
+        try {
+            message = JSON.parse(data.toString());
+        }
+        catch {
+            console.log("[ERRase CLI] Could not parse message, skipping");
+            return;
+        }
+        if (message.type === "ERROR_DETECTED") {
+            console.log("[ERRase CLI] Error received:");
+            console.log("  Message:", message.message);
+            console.log("  URL:", message.url);
+            let resolved = null;
+            try {
+                resolved = await resolveToProjectFile(message.stack);
+            }
+            catch (err) {
+                console.log("[ERRase CLI] Source map resolution failed:", err);
+                return;
+            }
+            if (!resolved) {
+                console.log("[ERRase CLI] Could not resolve stack to a project file (all frames are node_modules or unmapped)");
+                return;
+            }
+            const { filename, lineNumber } = resolved;
+            console.log(`[ERRase CLI] Mapped to: ${filename}:${lineNumber}`);
+            try {
+                const snippet = readContextLines(filename, lineNumber);
+                console.log(`[ERRase CLI] Context (±30 lines around line ${lineNumber}):\n${snippet}`);
+                socket.send(JSON.stringify({
+                    type: "ERROR_CONTEXT",
+                    filename,
+                    lineNumber,
+                    message: message.message,
+                    stack: message.stack,
+                    fileContent: snippet
+                }));
+            }
+            catch (err) {
+                console.log("[ERRase CLI] Could not read source file:", err);
+            }
+        }
+        if (message.type === "ANALYZE_REQUEST") {
+            console.log("[ERRase CLI] Analyze request received:");
+            console.log("  File:", message.filename);
+            try {
+                const response = await fetch("https://errase-production.up.railway.app/analyze", {
+                    method: "POST",
+                    headers: { "Content-Type": "application/json" },
+                    body: JSON.stringify({
+                        message: message.message,
+                        filename: message.filename,
+                        lineNumber: message.lineNumber,
+                        fileContents: message.fileContents,
+                        groqApiKey: message.groqApiKey
+                    })
+                });
+                const fix = await response.json();
+                console.log("[ERRase Backend response]:", JSON.stringify(fix, null, 2));
+                socket.send(JSON.stringify({
+                    type: "FIX_READY",
+                    explanation: fix.explanation,
+                    confidence: fix.confidence,
+                    originalLine: fix.originalLine,
+                    fixedLine: fix.fixedLine,
+                    diff: fix.diff,
+                }));
+            }
+            catch (error) {
+                console.error("[ERRase CLI] Failed to reach backend:", error);
+            }
+        }
+        if (message.type === "APPLY_FIX") {
+            console.log("[ERRase CLI] Applying fix to:", message.filename);
+            try {
+                const fullPath = path_1.default.join(projectRoot, message.filename);
+                const fileContent = fs_1.default.readFileSync(fullPath, "utf-8");
+                if (!fileContent.includes(message.originalLine)) {
+                    console.error("[ERRase CLI] originalLine not found in file");
+                    console.error("[ERRase CLI] Searched for:", JSON.stringify(message.originalLine));
+                    console.error("[ERRase CLI] File start:", fileContent.slice(0, 500));
+                    return;
+                }
+                const updated = fileContent.replace(message.originalLine, message.fixedLine);
+                fs_1.default.writeFileSync(fullPath, updated, "utf-8");
+                console.log("[ERRase CLI] Fix applied to:", fullPath);
+            }
+            catch (error) {
+                console.error("[ERRase CLI] Failed to apply fix:", error);
+            }
+        }
+    });
+    socket.on("close", () => {
+        console.log("[ERRase CLI] Extension disconnected");
+    });
+});

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "errase",
+  "version": "1.0.0",
+  "main": "dist/index.js",
+  "bin": {
+    "errase": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "nodemon --exec ts-node src/index.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "debugging",
+    "ai",
+    "chrome-extension",
+    "developer-tools",
+    "nextjs"
+  ],
+  "author": "Craig Rosario",
+  "license": "ISC",
+  "description": "AI-powered browser debugging assistant. Detects runtime errors, reads your source files, and applies AI-generated fixes without leaving the tab.",
+  "dependencies": {
+    "diff": "^9.0.0",
+    "express": "^5.2.1",
+    "source-map-js": "^1.2.1",
+    "ws": "^8.20.1"
+  },
+  "devDependencies": {
+    "@types/diff": "^7.0.2",
+    "@types/express": "^5.0.6",
+    "@types/node": "^25.9.1",
+    "@types/ws": "^8.18.1",
+    "nodemon": "^3.1.14",
+    "ts-node": "^10.9.2",
+    "typescript": "^6.0.3"
+  },
+  "homepage": "https://errase.vercel.app",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Craig-Rosario/ERRase"
+  },
+  "bugs": {
+    "url": "https://github.com/Craig-Rosario/ERRase/issues"
+  }
+}

package/src/index.ts

@@ -0,0 +1,191 @@
+#!/usr/bin/env node
+import express from "express"
+import { WebSocketServer } from "ws"
+import fs from "fs"
+import path from "path"
+import { SourceMapConsumer } from "source-map-js"
+
+const projectRoot = process.argv[2]
+    ? path.resolve(process.argv[2])
+    : process.cwd()
+
+const app = express();
+
+const server = app.listen(7891, () => [
+    console.log("[ERRase CLI] Running on port 7891"),
+    console.log("[ERRase CLI] Project root:", projectRoot)
+])
+
+const wss = new WebSocketServer({ server });
+
+// Extracts all bundled JS URLs + line/col from a raw browser stack trace
+function parseBundledStack(stack: string): Array<{ bundledUrl: string; line: number; column: number }> {
+    const frames: Array<{ bundledUrl: string; line: number; column: number }> = []
+    for (const line of stack.split(/\r?\n/)) {
+        const match = line.match(/\(?(https?:\/\/.+?\.js):(\d+):(\d+)\)?/)
+        if (match) frames.push({ bundledUrl: match[1], line: parseInt(match[2]), column: parseInt(match[3]) })
+    }
+    return frames
+}
+
+// Iterates all stack frames, resolves source maps, and returns the first frame
+// that maps to a project file (skipping node_modules frames).
+async function resolveToProjectFile(stack: string): Promise<{ filename: string; lineNumber: number } | null> {
+    const frames = parseBundledStack(stack)
+    for (const frame of frames) {
+        let rawMap: any
+        try {
+            rawMap = await fetchSourceMap(frame.bundledUrl)
+        } catch {
+            continue
+        }
+        const consumer = new SourceMapConsumer(rawMap)
+        const original = consumer.originalPositionFor({ line: frame.line, column: frame.column })
+        if (!original.source || original.line == null) continue
+        if (original.source.includes("node_modules")) continue
+        const filename = stripSourcePrefix(original.source)
+        if (filename.includes("node_modules")) continue
+        return { filename, lineNumber: original.line }
+    }
+    return null
+}
+
+async function fetchSourceMap(bundledUrl: string): Promise<any> {
+    const res = await fetch(bundledUrl + ".map")
+    if (!res.ok) throw new Error(`Source map not found: ${bundledUrl}.map (${res.status})`)
+    return res.json()
+}
+
+// Strips webpack:// or file:// prefixes from source map source paths, returning
+// a path relative to projectRoot suitable for disk reads.
+// e.g. webpack://_N_E/./app/page.tsx       →  app/page.tsx
+//      file:///C:/path/to/project/app/page.tsx  →  app/page.tsx
+function stripSourcePrefix(source: string): string {
+    const webpackMatch = source.match(/^webpack:\/\/[^/]*\/\.\/(.+)$/) ?? source.match(/^webpack:\/\/[^/]*\/(.+)$/)
+    if (webpackMatch) return webpackMatch[1]
+
+    if (source.startsWith("file://")) {
+        const decoded = decodeURIComponent(source)
+        // file:///C:/... on Windows, file:///... on Unix
+        const absolute = decoded.replace(/^file:\/\/\//, "").replace(/^file:\/\//, "")
+        return path.relative(projectRoot, absolute)
+    }
+
+    return source
+}
+
+function readContextLines(filename: string, lineNumber: number, context = 15): string {
+    const fullPath = path.join(projectRoot, filename)
+    if (!fs.existsSync(fullPath)) throw new Error(`File not found: ${fullPath}`)
+    const lines = fs.readFileSync(fullPath, "utf-8").split("\n")
+    const start = Math.max(0, lineNumber - 1 - context)
+    const end = Math.min(lines.length, lineNumber + context)
+    return lines.slice(start, end).map((l, i) => `${start + i + 1}: ${l}`).join("\n")
+}
+
+wss.on("connection", (socket) => {
+    console.log("[ERRase CLI] Extension connected")
+
+    socket.on("message", async (data) => {
+        let message: any
+        try {
+            message = JSON.parse(data.toString())
+        } catch {
+            console.log("[ERRase CLI] Could not parse message, skipping")
+            return
+        }
+
+        if (message.type === "ERROR_DETECTED") {
+            console.log("[ERRase CLI] Error received:")
+            console.log("  Message:", message.message)
+            console.log("  URL:", message.url)
+
+            let resolved: { filename: string; lineNumber: number } | null = null
+            try {
+                resolved = await resolveToProjectFile(message.stack)
+            } catch (err) {
+                console.log("[ERRase CLI] Source map resolution failed:", err)
+                return
+            }
+
+            if (!resolved) {
+                console.log("[ERRase CLI] Could not resolve stack to a project file (all frames are node_modules or unmapped)")
+                return
+            }
+
+            const { filename, lineNumber } = resolved
+            console.log(`[ERRase CLI] Mapped to: ${filename}:${lineNumber}`)
+
+            try {
+                const snippet = readContextLines(filename, lineNumber)
+                console.log(`[ERRase CLI] Context (±30 lines around line ${lineNumber}):\n${snippet}`)
+
+                socket.send(JSON.stringify({
+                    type: "ERROR_CONTEXT",
+                    filename,
+                    lineNumber,
+                    message: message.message,
+                    stack: message.stack,
+                    fileContent: snippet
+                }))
+            } catch (err) {
+                console.log("[ERRase CLI] Could not read source file:", err)
+            }
+        }
+
+        if (message.type === "ANALYZE_REQUEST") {
+            console.log("[ERRase CLI] Analyze request received:")
+            console.log("  File:", message.filename)
+
+            try {
+                const response = await fetch("https://errase-production.up.railway.app/analyze", {
+                    method: "POST",
+                    headers: { "Content-Type": "application/json" },
+                    body: JSON.stringify({
+                        message: message.message,
+                        filename: message.filename,
+                        lineNumber: message.lineNumber,
+                        fileContents: message.fileContents,
+                        groqApiKey: message.groqApiKey
+                    })
+                })
+                const fix = await response.json() as any;
+                console.log("[ERRase Backend response]:", JSON.stringify(fix, null, 2))
+                socket.send(JSON.stringify({
+                    type: "FIX_READY",
+                    explanation: fix.explanation,
+                    confidence: fix.confidence,
+                    originalLine: fix.originalLine,
+                    fixedLine: fix.fixedLine,
+                    diff: fix.diff,
+                }))
+
+            } catch (error) {
+                console.error("[ERRase CLI] Failed to reach backend:", error)
+            }
+        }
+
+        if (message.type === "APPLY_FIX") {
+            console.log("[ERRase CLI] Applying fix to:", message.filename)
+            try {
+                const fullPath = path.join(projectRoot, message.filename)
+                const fileContent = fs.readFileSync(fullPath, "utf-8")
+                if (!fileContent.includes(message.originalLine)) {
+                    console.error("[ERRase CLI] originalLine not found in file")
+                    console.error("[ERRase CLI] Searched for:", JSON.stringify(message.originalLine))
+                    console.error("[ERRase CLI] File start:", fileContent.slice(0, 500))
+                    return
+                }
+                const updated = fileContent.replace(message.originalLine, message.fixedLine)
+                fs.writeFileSync(fullPath, updated, "utf-8")
+                console.log("[ERRase CLI] Fix applied to:", fullPath)
+            } catch (error) {
+                console.error("[ERRase CLI] Failed to apply fix:", error)
+            }
+        }
+    })
+
+    socket.on("close", () => {
+        console.log("[ERRase CLI] Extension disconnected");
+    })
+})

package/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": false,
+    "esModuleInterop": true
+  }
+}