debug-toolkit 0.4.0

package/dist/cleanup.js

@@ -0,0 +1,103 @@
+import { existsSync, readFileSync, writeFileSync, renameSync } from "node:fs";
+import { saveSession } from "./session.js";
+// --- Marker removal patterns ---
+// JS/Go: single-line inline markers with /* */ comments
+const INLINE_RE = /[ \t]*\/\*\s*__DBG_START_(\w+)__\s*\*\/.*?\/\*\s*__DBG_END_\1__\s*\*\/[ \t]*\n?/g;
+// Python: multi-line block markers with # comments (handles indentation)
+const BLOCK_RE = /[ \t]*#\s*__DBG_START_(\w+)__.*\n(?:[ \t]*.*\n)*?[ \t]*#\s*__DBG_END_\1__.*\n?/gm;
+// Detection: any marker present?
+const HAS_MARKER = /__DBG_(?:START|END)_\w+__/;
+function removeMarkers(content) {
+    const hadMarkers = HAS_MARKER.test(content);
+    if (!hadMarkers)
+        return { cleaned: content, hadMarkers: false };
+    let cleaned = content.replace(INLINE_RE, "");
+    cleaned = cleaned.replace(BLOCK_RE, "");
+    return { cleaned, hadMarkers: true };
+}
+function atomicWriteFile(path, data) {
+    const tmp = `${path}.dbg_clean_${process.pid}`;
+    writeFileSync(tmp, data);
+    renameSync(tmp, path);
+}
+export function cleanupSession(cwd, session) {
+    const errors = [];
+    let cleaned = 0;
+    const filesProcessed = [];
+    const files = [...new Set(session.instrumentation.filter((r) => r.active).map((r) => r.filePath))];
+    for (const fp of files) {
+        if (!existsSync(fp)) {
+            errors.push(`File missing: ${fp}`);
+            continue;
+        }
+        const content = readFileSync(fp, "utf-8");
+        const { cleaned: result, hadMarkers } = removeMarkers(content);
+        if (hadMarkers) {
+            atomicWriteFile(fp, result);
+            cleaned++;
+            filesProcessed.push(fp);
+            // Single-pass verify: check the content we just wrote
+            if (HAS_MARKER.test(result)) {
+                errors.push(`Markers remain after cleanup: ${fp}`);
+            }
+        }
+    }
+    // Mark all records inactive
+    for (const r of session.instrumentation)
+        r.active = false;
+    session._markerIndex = {};
+    session.status = "resolved";
+    saveSession(cwd, session);
+    return {
+        cleaned,
+        verified: errors.length === 0,
+        errors,
+        filesProcessed,
+    };
+}
+/**
+ * Emergency cleanup from manifest-less scan of session files.
+ */
+export function cleanupFromManifest(cwd) {
+    // Scan all session files to find active instrumentation
+    const { existsSync: ex, readdirSync } = require("node:fs");
+    const { join } = require("node:path");
+    const sessionsDir = join(cwd, ".debug", "sessions");
+    if (!ex(sessionsDir))
+        return { cleaned: 0, verified: true, errors: [], filesProcessed: [] };
+    const allFiles = new Set();
+    for (const f of readdirSync(sessionsDir)) {
+        if (!f.endsWith(".json"))
+            continue;
+        try {
+            const session = JSON.parse(readFileSync(join(sessionsDir, f), "utf-8"));
+            for (const r of session.instrumentation ?? []) {
+                if (r.active)
+                    allFiles.add(r.filePath);
+            }
+        }
+        catch { /* skip corrupt sessions */ }
+    }
+    if (allFiles.size === 0)
+        return { cleaned: 0, verified: true, errors: [], filesProcessed: [] };
+    const errors = [];
+    let cleaned = 0;
+    const filesProcessed = [];
+    for (const fp of allFiles) {
+        if (!existsSync(fp)) {
+            errors.push(`Missing: ${fp}`);
+            continue;
+        }
+        const content = readFileSync(fp, "utf-8");
+        const { cleaned: result, hadMarkers } = removeMarkers(content);
+        if (hadMarkers) {
+            atomicWriteFile(fp, result);
+            cleaned++;
+            filesProcessed.push(fp);
+            if (HAS_MARKER.test(result))
+                errors.push(`Markers remain: ${fp}`);
+        }
+    }
+    return { cleaned, verified: errors.length === 0, errors, filesProcessed };
+}
+//# sourceMappingURL=cleanup.js.map

package/dist/cleanup.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Terminal UI utilities — colors, symbols, formatting.
+ * Zero dependencies. Works in any terminal.
+ */
+declare const c: {
+    reset: string;
+    bold: string;
+    dim: string;
+    green: string;
+    yellow: string;
+    blue: string;
+    magenta: string;
+    cyan: string;
+    red: string;
+    gray: string;
+    white: string;
+    bgGreen: string;
+    bgBlue: string;
+};
+export declare const sym: {
+    check: string;
+    cross: string;
+    arrow: string;
+    dot: string;
+    circle: string;
+    bar: string;
+    dash: string;
+    bolt: string;
+};
+export declare function banner(): void;
+export declare function info(msg: string): void;
+export declare function success(msg: string): void;
+export declare function warn(msg: string): void;
+export declare function error(msg: string): void;
+export declare function dim(msg: string): void;
+export declare function section(title: string): void;
+export declare function kv(key: string, value: string): void;
+export declare function ready(toolCount: number): void;
+export declare function printHelp(): void;
+export { c };

package/dist/cli.js

@@ -0,0 +1,109 @@
+/**
+ * Terminal UI utilities — colors, symbols, formatting.
+ * Zero dependencies. Works in any terminal.
+ */
+const isColor = process.env.NO_COLOR === undefined && process.stderr.isTTY;
+// --- ANSI colors ---
+const c = {
+    reset: isColor ? "\x1b[0m" : "",
+    bold: isColor ? "\x1b[1m" : "",
+    dim: isColor ? "\x1b[2m" : "",
+    green: isColor ? "\x1b[32m" : "",
+    yellow: isColor ? "\x1b[33m" : "",
+    blue: isColor ? "\x1b[34m" : "",
+    magenta: isColor ? "\x1b[35m" : "",
+    cyan: isColor ? "\x1b[36m" : "",
+    red: isColor ? "\x1b[31m" : "",
+    gray: isColor ? "\x1b[90m" : "",
+    white: isColor ? "\x1b[97m" : "",
+    bgGreen: isColor ? "\x1b[42m" : "",
+    bgBlue: isColor ? "\x1b[44m" : "",
+};
+// --- Symbols ---
+export const sym = {
+    check: isColor ? "✓" : "[OK]",
+    cross: isColor ? "✗" : "[FAIL]",
+    arrow: isColor ? "→" : "->",
+    dot: isColor ? "●" : "*",
+    circle: isColor ? "○" : "-",
+    bar: isColor ? "│" : "|",
+    dash: isColor ? "─" : "-",
+    bolt: isColor ? "⚡" : "!",
+};
+// --- Log functions (all go to stderr, stdout reserved for MCP) ---
+export function banner() {
+    const lines = [
+        "",
+        `  ${c.bold}${c.cyan}debug-toolkit${c.reset} ${c.dim}v0.3.0${c.reset}`,
+        `  ${c.dim}closed-loop debugging for AI agents${c.reset}`,
+        "",
+    ];
+    process.stderr.write(lines.join("\n") + "\n");
+}
+export function info(msg) {
+    process.stderr.write(`  ${c.blue}${sym.dot}${c.reset} ${msg}\n`);
+}
+export function success(msg) {
+    process.stderr.write(`  ${c.green}${sym.check}${c.reset} ${msg}\n`);
+}
+export function warn(msg) {
+    process.stderr.write(`  ${c.yellow}${sym.bolt}${c.reset} ${msg}\n`);
+}
+export function error(msg) {
+    process.stderr.write(`  ${c.red}${sym.cross}${c.reset} ${msg}\n`);
+}
+export function dim(msg) {
+    process.stderr.write(`  ${c.dim}${msg}${c.reset}\n`);
+}
+export function section(title) {
+    process.stderr.write(`\n  ${c.bold}${title}${c.reset}\n`);
+}
+export function kv(key, value) {
+    process.stderr.write(`  ${c.dim}${key}${c.reset} ${value}\n`);
+}
+export function ready(toolCount) {
+    process.stderr.write(`\n  ${c.bgBlue}${c.white}${c.bold} READY ${c.reset} ${c.bold}${toolCount} MCP tools available${c.reset}\n\n`);
+}
+export function printHelp() {
+    console.log(`
+  ${c.bold}${c.cyan}debug-toolkit${c.reset} ${c.dim}v0.3.0${c.reset}
+  ${c.dim}Closed-loop debugging for AI agents${c.reset}
+
+  ${c.bold}SETUP${c.reset} ${c.dim}(one time)${c.reset}
+    ${c.green}npx debug-toolkit init${c.reset}
+
+  ${c.bold}TWO MODES${c.reset}
+    ${c.white}Pure MCP${c.reset}   Just add to your MCP config. No wrapper needed.
+               ${c.dim}Agent gets: investigate, instrument, capture, verify, cleanup${c.reset}
+
+    ${c.white}Serve${c.reset}      ${c.green}npx debug-toolkit serve -- npm run dev${c.reset}
+               ${c.dim}Everything above + browser console/network capture via proxy${c.reset}
+
+  ${c.bold}8 TOOLS + 1 RESOURCE${c.reset} ${c.dim}(what the AI agent sees)${c.reset}
+    ${c.cyan}debug_investigate${c.reset}   ${c.bold}Error in ${sym.arrow} full context out${c.reset} ${c.dim}+ auto-recall past fixes${c.reset}
+    ${c.cyan}debug_recall${c.reset}        Search past sessions ${c.dim}(with staleness + causal chains)${c.reset}
+    ${c.cyan}debug_patterns${c.reset}      Detect recurring errors, hot files, regressions
+    ${c.cyan}debug_instrument${c.reset}    Add tagged logging to source files
+    ${c.cyan}debug_capture${c.reset}       Collect runtime output ${c.dim}(paginated)${c.reset}
+    ${c.cyan}debug_verify${c.reset}        Run command, check pass/fail
+    ${c.cyan}debug_cleanup${c.reset}       Remove instrumentation ${c.dim}+ save diagnosis + causal chain${c.reset}
+    ${c.cyan}debug_session${c.reset}       View session state
+    ${c.dim}debug://methodology${c.reset}  ${c.dim}Always-available debugging guide (MCP resource)${c.reset}
+
+  ${c.bold}THE WORKFLOW${c.reset}
+    ${c.dim}1.${c.reset} ${c.cyan}debug_recall${c.reset}       ${c.dim}${sym.arrow} check if solved before${c.reset}
+    ${c.dim}2.${c.reset} ${c.cyan}debug_investigate${c.reset}  ${c.dim}${sym.arrow} understand the error${c.reset}
+    ${c.dim}3.${c.reset} ${c.cyan}debug_instrument${c.reset}   ${c.dim}${sym.arrow} add logging to probe${c.reset}
+    ${c.dim}4.${c.reset} ${c.cyan}debug_capture${c.reset}      ${c.dim}${sym.arrow} collect evidence${c.reset}
+    ${c.dim}5.${c.reset} ${c.white}apply fix${c.reset}           ${c.dim}${sym.arrow} agent edits code${c.reset}
+    ${c.dim}6.${c.reset} ${c.cyan}debug_verify${c.reset}       ${c.dim}${sym.arrow} confirm it works${c.reset}
+    ${c.dim}7.${c.reset} ${c.cyan}debug_cleanup${c.reset}      ${c.dim}${sym.arrow} remove markers, save to memory${c.reset}
+
+  ${c.bold}SECURITY${c.reset}
+    ${c.green}${sym.check}${c.reset} Path traversal protection    ${c.green}${sym.check}${c.reset} Auto-redact secrets
+    ${c.green}${sym.check}${c.reset} Localhost-only proxy         ${c.green}${sym.check}${c.reset} Pre-commit safety hook
+    ${c.green}${sym.check}${c.reset} .debug/ auto-gitignored      ${c.green}${sym.check}${c.reset} Atomic file writes
+`);
+}
+export { c };
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/context.d.ts

@@ -0,0 +1,59 @@
+/**
+ * context.ts — Automatic context gathering engine.
+ *
+ * The #1 insight: developers waste most debugging time gathering context,
+ * not fixing bugs. This module automates that entirely.
+ *
+ * Given an error string, it:
+ *   1. Parses stack frames to find relevant source files
+ *   2. Reads those files (the exact lines around the error)
+ *   3. Gets the git diff showing recent changes to those files
+ *   4. Captures the runtime environment
+ *   5. Returns a single structured object with everything the agent needs
+ */
+export interface StackFrame {
+    fn: string;
+    file: string;
+    line: number;
+    col: number | null;
+    isUserCode: boolean;
+}
+interface SourceSnippet {
+    file: string;
+    relativePath: string;
+    startLine: number;
+    endLine: number;
+    lines: string;
+    errorLine: number;
+}
+interface GitContext {
+    branch: string | null;
+    commit: string | null;
+    dirty: number;
+    recentChanges: string | null;
+}
+interface EnvSnapshot {
+    platform: string;
+    node: string;
+    python: string | null;
+    rust: string | null;
+    project: string | null;
+    frameworks: Record<string, string>;
+    envVars: Record<string, string>;
+}
+export interface ErrorClassification {
+    type: string;
+    summary: string;
+    category: string;
+    severity: "fatal" | "error" | "warning";
+    suggestion: string;
+}
+export interface InvestigationResult {
+    error: ErrorClassification;
+    sourceCode: SourceSnippet[];
+    git: GitContext;
+    environment: EnvSnapshot;
+    frames: StackFrame[];
+}
+export declare function investigate(errorText: string, cwd: string): InvestigationResult;
+export {};

package/dist/context.js

@@ -0,0 +1,338 @@
+/**
+ * context.ts — Automatic context gathering engine.
+ *
+ * The #1 insight: developers waste most debugging time gathering context,
+ * not fixing bugs. This module automates that entirely.
+ *
+ * Given an error string, it:
+ *   1. Parses stack frames to find relevant source files
+ *   2. Reads those files (the exact lines around the error)
+ *   3. Gets the git diff showing recent changes to those files
+ *   4. Captures the runtime environment
+ *   5. Returns a single structured object with everything the agent needs
+ */
+import { execSync } from "node:child_process";
+import { existsSync, readFileSync, statSync } from "node:fs";
+import { join, relative, isAbsolute } from "node:path";
+import { redactSensitiveData } from "./security.js";
+// Match "at FnName (file:line:col)" or "at file:line:col"
+const NODE_FRAME = /at\s+(?:([\w$.< >\[\]]+?)\s+)?\(?([^\s()]+):(\d+):(\d+)\)?/gm;
+const PY_FRAME = /File "(.+?)", line (\d+)(?:, in (.+))?/g;
+// Rust backtrace: "   4: my_app::handler at ./src-tauri/src/main.rs:15:10"
+const RUST_FRAME = /^\s*\d+:\s+([\w:<>]+)(?:\s+at\s+(.+?):(\d+)(?::(\d+))?)?$/gm;
+// Rust panic location: "thread 'main' panicked at 'msg', src/main.rs:15:10"
+const RUST_PANIC = /panicked at (?:'[^']*'|"[^"]*"),\s*(.+?):(\d+):(\d+)/;
+// Cargo error: "error[E0308]: mismatched types\n --> src/main.rs:15:10"
+const CARGO_ERROR_LOC = /-->\s*(.+?):(\d+):(\d+)/g;
+function parseStackFrames(error, cwd) {
+    const frames = [];
+    const seen = new Set();
+    // Detect if this is a Rust error (parse Rust-specific formats FIRST,
+    // before Node.js regex grabs "at file:line:col" from backtraces)
+    const isRustError = /panicked at|stack backtrace:|error\[E\d+]|-->\s*\S+\.rs:/.test(error);
+    let m;
+    if (isRustError) {
+        // Rust panic location
+        const panic = RUST_PANIC.exec(error);
+        if (panic) {
+            const key = `${panic[1]}:${panic[2]}`;
+            seen.add(key);
+            frames.push({
+                fn: "<panic>",
+                file: panic[1],
+                line: +panic[2],
+                col: +panic[3],
+                isUserCode: !panic[1].includes(".cargo") && !panic[1].includes("/rustc/"),
+            });
+        }
+        // Rust backtrace frames
+        RUST_FRAME.lastIndex = 0;
+        while ((m = RUST_FRAME.exec(error)) !== null) {
+            if (!m[2])
+                continue;
+            const file = m[2].replace(/^\.\//, "");
+            const key = `${file}:${m[3]}`;
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            frames.push({
+                fn: m[1],
+                file,
+                line: +m[3],
+                col: m[4] ? +m[4] : null,
+                isUserCode: !file.includes(".cargo") && !file.includes("/rustc/")
+                    && !file.includes("registry/src"),
+            });
+        }
+        // Cargo compiler error locations
+        CARGO_ERROR_LOC.lastIndex = 0;
+        while ((m = CARGO_ERROR_LOC.exec(error)) !== null) {
+            const key = `${m[1]}:${m[2]}`;
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            frames.push({
+                fn: "<compile>",
+                file: m[1],
+                line: +m[2],
+                col: +m[3],
+                isUserCode: true,
+            });
+        }
+    }
+    // Node.js / JS / TS (skip if already parsed as Rust)
+    if (!isRustError) {
+        NODE_FRAME.lastIndex = 0;
+        while ((m = NODE_FRAME.exec(error)) !== null) {
+            const key = `${m[2]}:${m[3]}`;
+            if (seen.has(key))
+                continue;
+            seen.add(key);
+            const file = m[2];
+            frames.push({
+                fn: m[1] ?? "<anonymous>",
+                file,
+                line: +m[3],
+                col: +m[4],
+                isUserCode: !file.includes("node_modules") && !file.startsWith("node:"),
+            });
+        }
+    }
+    // Python
+    PY_FRAME.lastIndex = 0;
+    while ((m = PY_FRAME.exec(error)) !== null) {
+        const key = `${m[1]}:${m[2]}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        frames.push({
+            fn: m[3] ?? "<module>",
+            file: m[1],
+            line: +m[2],
+            col: null,
+            isUserCode: !m[1].includes("site-packages") && !m[1].includes("/lib/python"),
+        });
+    }
+    return frames;
+}
+function extractSourceSnippets(frames, cwd, contextLines = 5) {
+    const snippets = [];
+    const seen = new Set();
+    // Only user code frames, up to 3 files
+    const userFrames = frames.filter((f) => f.isUserCode).slice(0, 3);
+    for (const frame of userFrames) {
+        let filePath = frame.file;
+        // Resolve relative to cwd
+        if (!isAbsolute(filePath))
+            filePath = join(cwd, filePath);
+        if (!existsSync(filePath))
+            continue;
+        if (seen.has(filePath))
+            continue;
+        seen.add(filePath);
+        try {
+            const stat = statSync(filePath);
+            if (stat.size > 1_000_000)
+                continue; // Skip files > 1MB
+            const content = readFileSync(filePath, "utf-8");
+            const allLines = content.split("\n");
+            const start = Math.max(0, frame.line - contextLines - 1);
+            const end = Math.min(allLines.length, frame.line + contextLines);
+            const slice = allLines.slice(start, end);
+            // Number the lines
+            const numbered = slice.map((l, i) => {
+                const lineNum = start + i + 1;
+                const marker = lineNum === frame.line ? " >> " : "    ";
+                return `${marker}${lineNum} | ${l}`;
+            }).join("\n");
+            snippets.push({
+                file: filePath,
+                relativePath: relative(cwd, filePath),
+                startLine: start + 1,
+                endLine: end,
+                lines: numbered,
+                errorLine: frame.line,
+            });
+        }
+        catch { /* skip unreadable files */ }
+    }
+    return snippets;
+}
+function getGitContext(cwd, files) {
+    const ctx = { branch: null, commit: null, dirty: 0, recentChanges: null };
+    try {
+        ctx.branch = execSync("git branch --show-current 2>/dev/null", { cwd, timeout: 3000 }).toString().trim();
+        ctx.commit = execSync("git rev-parse --short HEAD 2>/dev/null", { cwd, timeout: 3000 }).toString().trim();
+        const status = execSync("git status --porcelain 2>/dev/null", { cwd, timeout: 3000 }).toString().trim();
+        ctx.dirty = status ? status.split("\n").length : 0;
+        // Get recent changes to relevant files (last 3 commits)
+        if (files.length > 0) {
+            const relFiles = files.map((f) => relative(cwd, f)).filter((f) => !f.startsWith(".."));
+            if (relFiles.length > 0) {
+                const fileArgs = relFiles.map((f) => `"${f}"`).join(" ");
+                try {
+                    const diff = execSync(`git log --oneline -3 --diff-filter=M -- ${fileArgs} 2>/dev/null`, { cwd, timeout: 5000 }).toString().trim();
+                    if (diff)
+                        ctx.recentChanges = diff;
+                }
+                catch { }
+                // Also get unstaged changes
+                try {
+                    const unstaged = execSync(`git diff --stat -- ${fileArgs} 2>/dev/null`, { cwd, timeout: 5000 }).toString().trim();
+                    if (unstaged) {
+                        ctx.recentChanges = (ctx.recentChanges ? ctx.recentChanges + "\n\n" : "") +
+                            "Unstaged changes:\n" + unstaged;
+                    }
+                }
+                catch { }
+            }
+        }
+    }
+    catch { /* not a git repo */ }
+    return ctx;
+}
+function getEnvironment(cwd) {
+    const env = {
+        platform: `${process.platform}/${process.arch}`,
+        node: process.version,
+        python: null,
+        rust: null,
+        project: null,
+        frameworks: {},
+        envVars: {},
+    };
+    try {
+        env.python = execSync("python3 --version 2>&1", { timeout: 2000 }).toString().trim();
+    }
+    catch { }
+    try {
+        env.rust = execSync("rustc --version 2>&1", { timeout: 2000 }).toString().trim();
+    }
+    catch { }
+    const pkgPath = join(cwd, "package.json");
+    if (existsSync(pkgPath)) {
+        try {
+            const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+            env.project = pkg.name ?? null;
+            for (const name of ["react", "next", "vue", "nuxt", "svelte", "express", "fastify", "vite", "typescript", "tailwindcss", "prisma", "drizzle", "@tauri-apps/api", "@tauri-apps/cli"]) {
+                const v = pkg.dependencies?.[name] ?? pkg.devDependencies?.[name];
+                if (v)
+                    env.frameworks[name] = v;
+            }
+        }
+        catch { }
+    }
+    // Detect Tauri project (Cargo.toml with tauri dependency)
+    const tauriConfPath = join(cwd, "src-tauri", "tauri.conf.json");
+    const cargoPath = join(cwd, "src-tauri", "Cargo.toml");
+    if (existsSync(tauriConfPath)) {
+        try {
+            const conf = JSON.parse(readFileSync(tauriConfPath, "utf-8"));
+            env.frameworks["tauri"] = conf.version ?? "v2";
+            env.frameworks["tauri-identifier"] = conf.identifier ?? conf.bundle?.identifier ?? "unknown";
+        }
+        catch { }
+    }
+    if (existsSync(cargoPath)) {
+        try {
+            const cargo = readFileSync(cargoPath, "utf-8");
+            const tauriVer = cargo.match(/tauri\s*=\s*\{[^}]*version\s*=\s*"([^"]+)"/);
+            if (tauriVer)
+                env.frameworks["tauri-core"] = tauriVer[1];
+            // Detect plugins
+            const plugins = [...cargo.matchAll(/tauri-plugin-(\w+)/g)].map((m) => m[1]);
+            if (plugins.length > 0)
+                env.frameworks["tauri-plugins"] = plugins.join(", ");
+        }
+        catch { }
+    }
+    for (const k of ["NODE_ENV", "PORT", "HOST", "DATABASE_URL", "API_URL", "RUST_BACKTRACE", "RUST_LOG"]) {
+        if (process.env[k])
+            env.envVars[k] = redactSensitiveData(process.env[k]);
+    }
+    return env;
+}
+function classifyError(raw) {
+    const r = {
+        type: "Unknown",
+        summary: raw.split("\n")[0]?.slice(0, 200) ?? "",
+        category: "runtime",
+        severity: "error",
+        suggestion: "",
+    };
+    const tm = raw.match(/^(\w+Error):\s*(.*)/m);
+    if (tm) {
+        r.type = tm[1];
+        r.summary = tm[2];
+    }
+    // Detect Rust panic first (overrides generic matching)
+    const panicMatch = raw.match(/thread '(.+?)' panicked at (?:'([^']*)'|"([^"]*)")/);
+    if (panicMatch) {
+        r.type = "Panic";
+        r.summary = panicMatch[2] ?? panicMatch[3] ?? "panic";
+        r.category = "rust-panic";
+        r.severity = "fatal";
+        r.suggestion = "Rust panic — check the unwrap()/expect() call. Set RUST_BACKTRACE=1 for a full backtrace.";
+        return r;
+    }
+    // Detect Cargo build errors
+    const cargoErr = raw.match(/^error\[E(\d+)]: (.+)/m);
+    if (cargoErr) {
+        r.type = `CargoError[E${cargoErr[1]}]`;
+        r.summary = cargoErr[2];
+        r.category = "rust-compile";
+        r.severity = "fatal";
+        r.suggestion = `Rust compilation error E${cargoErr[1]}. Check the source location shown after "-->".`;
+        return r;
+    }
+    const rules = [
+        // ── Tauri-specific (check before generic web errors) ──
+        [/invoke\s+error|__TAURI_IPC__|ipc.*error/i, "tauri-ipc", "error", "Tauri invoke failed — check command registration in generate_handler![] and argument types"],
+        [/capability.*not.*found|permission.*denied.*tauri|not allowed.*command/i, "tauri-capability", "error", "Tauri capability/permission error — add the command permission to src-tauri/capabilities/*.json"],
+        [/PluginInitialization|plugin.*failed.*init/i, "tauri-plugin", "error", "Tauri plugin failed to initialize — check plugin setup in Builder::plugin()"],
+        [/WindowLabelAlreadyExists|WebviewLabelAlreadyExists/i, "tauri-window", "error", "Duplicate window/webview label — use a unique label for each window"],
+        [/WebviewNotFound|WindowNotFound/i, "tauri-window", "error", "Window/webview not found — check the label matches what was created"],
+        [/AssetNotFound/i, "tauri-asset", "error", "Frontend asset not found — check frontendDist in tauri.conf.json points to your build output"],
+        [/CannotDeserializeScope/i, "tauri-acl", "error", "Tauri ACL scope deserialization failed — check capability scope definitions"],
+        [/tauri.*setup|Setup.*error/i, "tauri-setup", "fatal", "Tauri app setup failed — check the setup closure in Builder::setup()"],
+        // ── Rust-specific ──
+        [/unwrap\(\).*on.*None/i, "rust-panic", "fatal", "Called unwrap() on None — use match, if let, or ? operator instead"],
+        [/unwrap\(\).*on.*Err/i, "rust-panic", "fatal", "Called unwrap() on Err — use match or ? operator to handle the error"],
+        [/borrow.*already.*mutably|cannot borrow/i, "rust-borrow", "fatal", "Rust borrow checker error — check for overlapping mutable references"],
+        [/overflow|underflow/i, "rust-arithmetic", "error", "Integer overflow/underflow — use checked_add/checked_sub or wrapping operations"],
+        // ── General (JS/TS/Python/Go) ──
+        [/TypeError/i, "type", "error", "Check for null/undefined values being accessed as objects"],
+        [/ReferenceError/i, "reference", "error", "Check for typos in variable/function names or missing imports"],
+        [/SyntaxError/i, "syntax", "fatal", "Check for missing brackets, quotes, or invalid syntax"],
+        [/ECONNREFUSED/i, "network", "error", "The server/API isn't running — start it first"],
+        [/ENOENT|no such file/i, "filesystem", "error", "File doesn't exist — check the path"],
+        [/Cannot find module/i, "dependency", "error", "Run `npm install` to install missing dependencies"],
+        [/ERR_MODULE_NOT_FOUND/i, "esm", "error", "Add .js extension to import or set type:module in package.json"],
+        [/EACCES|Permission denied/i, "permissions", "error", "Check file permissions or run with elevated privileges"],
+        [/\b401\b/, "auth", "error", "Authentication failed — token may be expired"],
+        [/\b403\b/, "authz", "error", "Permission denied — check authorization"],
+        [/\b404\b/, "not-found", "error", "Endpoint doesn't exist — check the URL path"],
+        [/\b5\d{2}\b/, "server", "error", "Server error — check the backend logs"],
+        [/out of memory|heap/i, "memory", "fatal", "Process ran out of memory — check for leaks or increase limit"],
+        [/SIGKILL|SIGTERM/i, "killed", "fatal", "Process was killed — may be OOM or timeout"],
+    ];
+    for (const [pat, cat, sev, sugg] of rules) {
+        if (pat.test(raw)) {
+            r.category = cat;
+            r.severity = sev;
+            r.suggestion = sugg;
+            break;
+        }
+    }
+    return r;
+}
+export function investigate(errorText, cwd) {
+    const frames = parseStackFrames(errorText, cwd);
+    const sourceCode = extractSourceSnippets(frames, cwd);
+    const relevantFiles = sourceCode.map((s) => s.file);
+    const git = getGitContext(cwd, relevantFiles);
+    const environment = getEnvironment(cwd);
+    const error = classifyError(errorText);
+    return { error, sourceCode, git, environment, frames };
+}
+//# sourceMappingURL=context.js.map