debug-toolkit 0.4.0

package/README.md

@@ -0,0 +1,236 @@
+# debug-toolkit
+
+Closed-loop debugging for AI coding agents. One MCP server gives your agent the ability to **see code running** — not just read and write it.
+
+```
+npx debug-toolkit demo     # see it work (no AI needed)
+npx debug-toolkit init     # install in your project
+```
+
+## The Problem
+
+When an AI agent hits a bug, it reads code and guesses a fix. You run it, paste the error back, the agent guesses again. Repeat 5-8 times.
+
+debug-toolkit eliminates that loop. The agent investigates the error, instruments the code, captures runtime output, verifies the fix, and cleans up — all through MCP tool calls. No copy-pasting. No manual log hunting.
+
+## How It Works
+
+```
+investigate → instrument → capture → fix → verify → cleanup
+```
+
+One debug session. Full context. Diagnosis saved for next time.
+
+```
+┌─────────────────────────────────────────────────────────┐
+│  Agent gets error from user                             │
+│  ↓                                                      │
+│  debug_investigate  → error type, source code, git,     │
+│                       environment, past solutions        │
+│  ↓                                                      │
+│  debug_instrument   → adds tagged logging to source     │
+│  ↓                                                      │
+│  debug_capture      → collects runtime output           │
+│  ↓                                                      │
+│  Agent applies fix                                      │
+│  ↓                                                      │
+│  debug_verify       → runs tests, confirms fix          │
+│  ↓                                                      │
+│  debug_cleanup      → removes markers, saves diagnosis  │
+│                       + causal chain to memory           │
+│  ↓                                                      │
+│  Next session: debug_investigate auto-recalls the fix   │
+└─────────────────────────────────────────────────────────┘
+```
+
+## Setup
+
+### Any project (JS/TS/Python/Go)
+
+```bash
+npx debug-toolkit init
+```
+
+Generates `.claude/mcp.json`, installs a pre-commit safety hook, detects your dev command. Restart Claude Code and you're done.
+
+### Tauri projects (auto-detected)
+
+```bash
+cd my-tauri-app
+npx debug-toolkit init
+```
+
+If `src-tauri/` exists, debug-toolkit automatically:
+- Sets dev command to `cargo tauri dev`
+- Enables `RUST_BACKTRACE=1` and `RUST_LOG=info`
+- Parses Rust panics, backtraces, and cargo build errors
+- Discovers and tails `tauri-plugin-log` files from platform-specific paths
+- Detects Tauri-specific errors (invoke, capability, plugin, window, asset)
+
+### Manual MCP config
+
+Add to `.claude/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "debug-toolkit": {
+      "command": "npx",
+      "args": ["-y", "debug-toolkit"]
+    }
+  }
+}
+```
+
+## Two Modes
+
+**Pure MCP** (default) — Just the MCP server on stdio. Agent gets all tools. No wrapper needed.
+
+```bash
+npx debug-toolkit
+```
+
+**Serve** — Wraps your dev server. Adds browser console/network capture via HTTP proxy + WebSocket.
+
+```bash
+npx debug-toolkit serve -- npm run dev
+npx debug-toolkit serve -- cargo tauri dev
+```
+
+## Tools
+
+### debug_investigate
+
+**Start here.** Give it an error message or stack trace. Returns:
+
+- Error classification (type, category, severity, suggestion)
+- Source code at the exact crash site (highlighted)
+- Git context (branch, commit, recent changes to those files)
+- Runtime environment (Node/Rust version, frameworks, env vars — secrets redacted)
+- Past solutions from memory (with staleness info and causal chains)
+
+```
+Input:  { error: "TypeError: Cannot read properties of undefined (reading 'map')" }
+Output: { error, sourceCode, git, environment, pastSolutions, nextStep }
+```
+
+### debug_recall
+
+Search past debug sessions for similar errors. Returns diagnoses ranked by relevance, with staleness tracking (has the code changed since?) and causal chains (where was the actual bug?).
+
+```
+Input:  { query: "TypeError undefined map" }
+Output: { matches: [{ diagnosis, stale, rootCause }] }
+```
+
+### debug_patterns
+
+Detect systemic issues across all past sessions:
+
+| Pattern | What it finds |
+|---------|--------------|
+| **Recurring error** | Same error type in same file, 3+ times |
+| **Hot file** | Files in 15%+ of debug sessions |
+| **Regression** | Bug fixed once, came back |
+| **Error cluster** | Multiple errors within 2 hours |
+
+### debug_instrument
+
+Add tagged logging to source files. Supports JS/TS, Python, Go, and Rust:
+
+| Language | Output |
+|----------|--------|
+| JS/TS | `console.log("[DBG_001]", expr)` |
+| Python | `print(f"[DBG_001] {expr}")` |
+| Go | `fmt.Printf("[DBG_001] %v\n", expr)` |
+| Rust | `eprintln!("[DBG_001] {:?}", expr)` |
+
+Each marker links to a hypothesis. Respects indentation. Auto-cleans on cleanup.
+
+### debug_capture
+
+Run a command and capture output, or drain buffered events from terminal, browser, and Tauri log files. Tagged output is linked to hypotheses. Results are paginated.
+
+### debug_verify
+
+After applying a fix, run the test command and get a clear pass/fail with exit code and error output.
+
+### debug_cleanup
+
+Remove ALL instrumentation, verify files are restored, and save the diagnosis + causal chain to memory. Provide `rootCause` to teach the system where the actual bug was:
+
+```json
+{
+  "diagnosis": "getUsers() returns undefined when db not connected",
+  "rootCause": {
+    "trigger": "missing db.connect() call",
+    "errorFile": "src/api.ts",
+    "causeFile": "src/db.ts",
+    "fixDescription": "added connect() before query"
+  }
+}
+```
+
+### debug_session
+
+Lightweight view of current state: hypotheses, active instruments, recent captures.
+
+## Memory System
+
+debug-toolkit learns from every session:
+
+**Recall** — When you investigate a new error, it auto-searches past diagnoses. If a similar error was solved before, the agent gets the previous diagnosis, which files were involved, and the causal chain.
+
+**Staleness** — Every diagnosis is tagged with the git SHA. When recalled, the system checks if the referenced files have changed. Stale diagnoses are flagged but still shown.
+
+**Causal chains** — Records where the error appeared vs. where the actual bug was. Next time, the agent goes straight to the cause file instead of the symptom.
+
+**Patterns** — Detects recurring errors, hot files, regressions, and error clusters across all sessions.
+
+## Language Support
+
+| Feature | JS/TS | Python | Go | Rust/Tauri |
+|---------|-------|--------|----|------------|
+| Stack trace parsing | Node.js frames | Python tracebacks | — | Panics, backtraces, cargo errors |
+| Error classification | TypeError, ReferenceError, etc. | — | — | Panic, borrow, Tauri IPC/capability/plugin |
+| Code instrumentation | `console.log` | `print()` | `fmt.Printf` | `eprintln!` |
+| Source extraction | Yes | Yes | Yes | Yes |
+| Log file tailing | — | — | — | `tauri-plugin-log` auto-discovery |
+| Environment detection | package.json, frameworks | Python version | — | Cargo.toml, tauri.conf.json, plugins |
+
+## Security
+
+- **Path traversal protection** — all file operations validated against project root
+- **Expression validation** — blocks `eval`, `require`, `exec` in instrumentation
+- **Secret redaction** — tokens, API keys, passwords, JWTs auto-redacted before storage
+- **Localhost-only proxy** — binds to 127.0.0.1
+- **Pre-commit hook** — blocks commits containing debug markers
+- **Atomic writes** — temp file + rename, no corruption on crash
+- **`.debug/` auto-gitignored**
+
+## Architecture
+
+15 files, 3,451 lines of TypeScript. 4 npm dependencies.
+
+```
+src/
+  mcp.ts          473 lines  — 8 tools + 1 resource + MCP server
+  context.ts      420 lines  — Investigation engine (stack parsing, source, git, env)
+  demo.ts         398 lines  — Self-contained interactive demo
+  memory.ts       369 lines  — Cross-session memory with staleness + patterns
+  capture.ts      276 lines  — Ring buffers, terminal pipe, Tauri log tailing
+  proxy.ts        200 lines  — HTTP proxy + HTML injection + WebSocket
+  index.ts        204 lines  — CLI entry point (mcp, serve, init, demo, clean)
+  security.ts     185 lines  — Path traversal, expression validation, redaction
+  session.ts      162 lines  — Data model, atomic persistence, marker index
+  injected.js     151 lines  — Browser console/network/error capture script
+  instrument.ts   140 lines  — Language-aware instrumentation (JS/TS/Py/Go/Rust)
+  cleanup.ts      126 lines  — Single-pass marker removal with verification
+  cli.ts          125 lines  — ANSI terminal UI
+  hook.ts         122 lines  — Git pre-commit hook
+  methodology.ts  100 lines  — Always-available debugging guide
+```
+
+## License
+
+MIT

package/SKILL.md

@@ -0,0 +1,104 @@
+---
+name: debug-toolkit
+description: Closed-loop debugging for AI agents with cross-session memory. Investigate errors, recall past fixes, detect patterns, instrument code, capture output, verify fixes, auto-cleanup with causal chains. Start every debugging task with debug_investigate.
+tools: ["debug_investigate", "debug_recall", "debug_patterns", "debug_instrument", "debug_capture", "debug_verify", "debug_cleanup", "debug_session"]
+---
+
+# debug-toolkit
+
+You have access to a debugging toolkit via MCP. These tools let you SEE code running — not just read and write it. They also learn from every debug session and get smarter over time.
+
+## When to Use
+
+Use these tools whenever you encounter:
+- A runtime error or stack trace
+- A test failure
+- Code that runs but produces wrong output
+- A bug report from the user
+
+## The Workflow
+
+**ALWAYS start with `debug_investigate`.** It auto-recalls past solutions.
+
+```
+1. debug_investigate  → understand the error + auto-recall past fixes
+2. debug_instrument   → add logging if investigation wasn't enough
+3. debug_capture      → collect runtime output
+4. (apply fix)        → edit the code
+5. debug_verify       → confirm the fix works
+6. debug_cleanup      → remove markers, save diagnosis + causal chain
+```
+
+## Tool Reference
+
+### debug_investigate
+**Start here.** Parses error text, finds source files, shows the exact lines, gets git context. Auto-searches memory for past solutions with staleness info.
+```
+Input: { error: "<stack trace>", problem?: "description" }
+Output: { error, sourceCode, git, environment, pastSolutions?, nextStep }
+```
+Past solutions include `stale` (has code changed?) and `rootCause` (causal chain from last fix).
+
+### debug_recall
+Explicitly search past debug sessions. Returns diagnoses with staleness and causal chains.
+```
+Input: { query: "TypeError Cannot read properties email" }
+Output: { matches: [{ problem, diagnosis, stale, staleness?, rootCause? }] }
+```
+
+### debug_patterns
+Detect patterns across ALL past sessions. Use periodically.
+```
+Input: {}
+Output: { patterns: [{ type, severity, message }] }
+```
+Pattern types: `recurring_error`, `hot_file`, `regression`, `error_cluster`.
+
+### debug_instrument
+Add tagged logging. Each marker links to a hypothesis.
+```
+Input: { sessionId, filePath, lineNumber, expression: "req.body", hypothesis?: "body is undefined" }
+```
+
+### debug_capture
+Run a command and capture output, or drain buffered events.
+```
+Input: { sessionId, command?: "npm test", limit?: 30 }
+```
+
+### debug_verify
+After applying a fix, run the test command and check pass/fail.
+```
+Input: { sessionId, command: "npm test" }
+```
+
+### debug_cleanup
+Remove ALL instrumentation, save diagnosis + causal chain to memory.
+```
+Input: {
+  sessionId,
+  diagnosis?: "root cause was...",
+  rootCause?: {
+    trigger: "missing null check",
+    errorFile: "src/api.ts",
+    causeFile: "src/db.ts",
+    fixDescription: "added null check before .map()"
+  }
+}
+```
+**Always provide rootCause** — it's the most valuable data for future sessions.
+
+### debug_session
+Lightweight view of current session state.
+```
+Input: { sessionId }
+```
+
+## Rules
+1. NEVER skip debug_investigate. It's the highest-leverage step.
+2. Read `nextStep` in every response — it tells you what to do.
+3. If past solutions are found, check `stale` — fresh solutions can be trusted.
+4. Instrument 1-2 files, not 10. Narrow first.
+5. ALWAYS run debug_verify before claiming a fix works.
+6. ALWAYS provide `rootCause` in debug_cleanup — it teaches the system.
+7. Run debug_patterns periodically to spot systemic issues.

package/dist/capture.d.ts

@@ -0,0 +1,46 @@
+import { type ChildProcess } from "node:child_process";
+import { type Capture, type DebugSession } from "./session.js";
+declare class RingBuffer<T> {
+    private buf;
+    private head;
+    private count;
+    private cap;
+    constructor(capacity: number);
+    push(item: T): void;
+    drain(): T[];
+    get length(): number;
+}
+export declare const terminalBuffer: RingBuffer<Capture>;
+export declare const browserBuffer: RingBuffer<Capture>;
+export declare function pipeProcess(child: ChildProcess): void;
+export declare function runAndCapture(command: string, timeoutMs?: number): Promise<Capture[]>;
+export declare function onBrowserEvent(event: {
+    type: string;
+    data: unknown;
+    ts: number;
+}): void;
+export declare function drainCaptures(cwd: string, session: DebugSession): Capture[];
+/**
+ * Discover Tauri log files for a project.
+ * Searches platform-specific log directories based on the bundle identifier.
+ */
+export declare function discoverTauriLogs(cwd: string): {
+    logDir: string | null;
+    logFiles: string[];
+    identifier: string | null;
+};
+/**
+ * Read recent lines from Tauri log files.
+ * Returns captures from the most recent log file.
+ */
+export declare function readTauriLogs(cwd: string, tailLines?: number): Capture[];
+export declare function getRecentCaptures(session: DebugSession, opts?: {
+    limit?: number;
+    source?: string;
+    markerOnly?: boolean;
+}): {
+    captures: Capture[];
+    total: number;
+    showing: number;
+};
+export {};

package/dist/capture.js

@@ -0,0 +1,246 @@
+import { spawn } from "node:child_process";
+import { existsSync, readFileSync, readdirSync, statSync } from "node:fs";
+import { join, basename } from "node:path";
+import { redactSensitiveData } from "./security.js";
+import { newCaptureId, lookupHypothesis, saveSession, } from "./session.js";
+// --- Marker tag extraction ---
+const MARKER_RE = /\[DBG_(\d{3})\]/;
+function extractMarkerTag(text) {
+    const m = MARKER_RE.exec(text);
+    return m ? `DBG_${m[1]}` : null;
+}
+// --- Ring buffer: fixed-size, no allocation on push ---
+class RingBuffer {
+    buf;
+    head = 0;
+    count = 0;
+    cap;
+    constructor(capacity) {
+        this.cap = capacity;
+        this.buf = new Array(capacity);
+    }
+    push(item) {
+        this.buf[this.head] = item;
+        this.head = (this.head + 1) % this.cap;
+        if (this.count < this.cap)
+            this.count++;
+    }
+    drain() {
+        if (this.count === 0)
+            return [];
+        const start = (this.head - this.count + this.cap) % this.cap;
+        const result = [];
+        for (let i = 0; i < this.count; i++) {
+            result.push(this.buf[(start + i) % this.cap]);
+        }
+        this.count = 0;
+        this.head = 0;
+        return result;
+    }
+    get length() { return this.count; }
+}
+// --- Buffers ---
+export const terminalBuffer = new RingBuffer(500);
+export const browserBuffer = new RingBuffer(200);
+// --- Terminal pipe ---
+export function pipeProcess(child) {
+    const pipe = (stream, isErr) => {
+        if (!stream)
+            return;
+        stream.on("data", (chunk) => {
+            const text = chunk.toString();
+            (isErr ? process.stderr : process.stdout).write(chunk);
+            for (const line of text.split("\n")) {
+                const t = line.trim();
+                if (!t)
+                    continue;
+                terminalBuffer.push({
+                    id: newCaptureId(),
+                    timestamp: new Date().toISOString(),
+                    source: "terminal",
+                    markerTag: extractMarkerTag(t),
+                    data: { text: redactSensitiveData(t), stream: isErr ? "stderr" : "stdout" },
+                    hypothesisId: null,
+                });
+            }
+        });
+    };
+    pipe(child.stdout, false);
+    pipe(child.stderr, true);
+}
+// --- Run command and capture ---
+export function runAndCapture(command, timeoutMs = 30_000) {
+    return new Promise((resolve, reject) => {
+        const out = [];
+        const child = spawn(command, { shell: true, stdio: "pipe" });
+        const timer = setTimeout(() => { child.kill(); resolve(out); }, timeoutMs);
+        const handle = (stream, name) => {
+            if (!stream)
+                return;
+            stream.on("data", (chunk) => {
+                for (const line of chunk.toString().split("\n")) {
+                    const t = line.trim();
+                    if (!t)
+                        continue;
+                    out.push({
+                        id: newCaptureId(),
+                        timestamp: new Date().toISOString(),
+                        source: "terminal",
+                        markerTag: extractMarkerTag(t),
+                        data: { text: redactSensitiveData(t), stream: name },
+                        hypothesisId: null,
+                    });
+                }
+            });
+        };
+        handle(child.stdout, "stdout");
+        handle(child.stderr, "stderr");
+        child.on("close", (code) => {
+            clearTimeout(timer);
+            out.push({
+                id: newCaptureId(), timestamp: new Date().toISOString(),
+                source: "terminal", markerTag: null,
+                data: { text: `exit:${code}`, stream: "meta" }, hypothesisId: null,
+            });
+            resolve(out);
+        });
+        child.on("error", (e) => { clearTimeout(timer); reject(e); });
+    });
+}
+// --- Browser event handler ---
+export function onBrowserEvent(event) {
+    const srcMap = {
+        console: "browser-console", network: "browser-network", error: "browser-error",
+    };
+    const src = srcMap[event.type] ?? "browser-console";
+    const str = typeof event.data === "object" ? JSON.stringify(event.data) : String(event.data);
+    browserBuffer.push({
+        id: newCaptureId(),
+        timestamp: new Date(event.ts).toISOString(),
+        source: src,
+        markerTag: extractMarkerTag(str),
+        data: event.data,
+        hypothesisId: null,
+    });
+}
+// --- Drain + link (O(n) using pre-built index, not O(n*m)) ---
+export function drainCaptures(cwd, session) {
+    const all = [...terminalBuffer.drain(), ...browserBuffer.drain()];
+    for (const c of all) {
+        if (c.markerTag) {
+            // O(1) lookup via pre-built index instead of O(m) scan
+            const hypId = lookupHypothesis(session, c.markerTag);
+            if (hypId) {
+                c.hypothesisId = hypId;
+                const hyp = session.hypotheses.find((h) => h.id === hypId);
+                if (hyp && !hyp.evidence.includes(c.id))
+                    hyp.evidence.push(c.id);
+            }
+        }
+    }
+    session.captures.push(...all);
+    saveSession(cwd, session);
+    return all;
+}
+// --- Tauri log file discovery and reading ---
+/**
+ * Discover Tauri log files for a project.
+ * Searches platform-specific log directories based on the bundle identifier.
+ */
+export function discoverTauriLogs(cwd) {
+    // Read bundle identifier from tauri.conf.json
+    let identifier = null;
+    const confPath = join(cwd, "src-tauri", "tauri.conf.json");
+    if (existsSync(confPath)) {
+        try {
+            const conf = JSON.parse(readFileSync(confPath, "utf-8"));
+            identifier = conf.identifier ?? conf.bundle?.identifier ?? null;
+        }
+        catch { }
+    }
+    if (!identifier)
+        return { logDir: null, logFiles: [], identifier: null };
+    // Platform-specific log directories
+    const home = process.env.HOME ?? process.env.USERPROFILE ?? "";
+    const candidates = [];
+    if (process.platform === "darwin") {
+        candidates.push(join(home, "Library", "Logs", identifier));
+    }
+    else if (process.platform === "win32") {
+        const appdata = process.env.APPDATA ?? join(home, "AppData", "Roaming");
+        candidates.push(join(appdata, identifier, "logs"));
+    }
+    else {
+        // Linux
+        candidates.push(join(home, ".config", identifier, "logs"));
+    }
+    for (const dir of candidates) {
+        if (existsSync(dir)) {
+            try {
+                const files = readdirSync(dir)
+                    .filter((f) => f.endsWith(".log"))
+                    .map((f) => join(dir, f))
+                    .sort((a, b) => {
+                    // Most recently modified first
+                    try {
+                        return statSync(b).mtimeMs - statSync(a).mtimeMs;
+                    }
+                    catch {
+                        return 0;
+                    }
+                });
+                return { logDir: dir, logFiles: files, identifier };
+            }
+            catch { }
+        }
+    }
+    return { logDir: null, logFiles: [], identifier };
+}
+/**
+ * Read recent lines from Tauri log files.
+ * Returns captures from the most recent log file.
+ */
+export function readTauriLogs(cwd, tailLines = 50) {
+    const { logFiles } = discoverTauriLogs(cwd);
+    if (logFiles.length === 0)
+        return [];
+    const captures = [];
+    const logFile = logFiles[0]; // Most recent
+    try {
+        const content = readFileSync(logFile, "utf-8");
+        const lines = content.split("\n").slice(-tailLines);
+        for (const line of lines) {
+            const t = line.trim();
+            if (!t)
+                continue;
+            captures.push({
+                id: newCaptureId(),
+                timestamp: new Date().toISOString(),
+                source: "tauri-log",
+                markerTag: extractMarkerTag(t),
+                data: { text: redactSensitiveData(t), file: basename(logFile), stream: "log" },
+                hypothesisId: null,
+            });
+        }
+    }
+    catch { }
+    return captures;
+}
+// --- Paginated capture retrieval (avoids dumping entire session) ---
+export function getRecentCaptures(session, opts = {}) {
+    let filtered = session.captures;
+    if (opts.source) {
+        filtered = filtered.filter((c) => c.source === opts.source);
+    }
+    if (opts.markerOnly) {
+        filtered = filtered.filter((c) => c.markerTag !== null);
+    }
+    const limit = opts.limit ?? 50;
+    const recent = filtered.slice(-limit);
+    return {
+        captures: recent,
+        total: filtered.length,
+        showing: recent.length,
+    };
+}
+//# sourceMappingURL=capture.js.map

package/dist/capture.js.map

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

package/dist/cleanup.d.ts

@@ -0,0 +1,12 @@
+import { type DebugSession } from "./session.js";
+export interface CleanupResult {
+    cleaned: number;
+    verified: boolean;
+    errors: string[];
+    filesProcessed: string[];
+}
+export declare function cleanupSession(cwd: string, session: DebugSession): CleanupResult;
+/**
+ * Emergency cleanup from manifest-less scan of session files.
+ */
+export declare function cleanupFromManifest(cwd: string): CleanupResult;