debug-toolkit 0.4.0

package/dist/index.js

@@ -0,0 +1,203 @@
+#!/usr/bin/env node
+import { spawn } from "node:child_process";
+import { resolve, join } from "node:path";
+import { existsSync, mkdirSync, writeFileSync, readFileSync } from "node:fs";
+import treeKill from "tree-kill";
+import { pipeProcess } from "./capture.js";
+import { startProxy, detectPort } from "./proxy.js";
+import { setCwd, startMcpServer } from "./mcp.js";
+import { installHook } from "./hook.js";
+import { cleanupFromManifest } from "./cleanup.js";
+import { banner, info, success, warn, error, dim, section, kv, ready, printHelp, sym, c } from "./cli.js";
+// --- Parse ---
+function parseArgs(argv) {
+    const args = argv.slice(2);
+    const cmd = args[0] ?? "mcp"; // DEFAULT: pure MCP server (zero-config!)
+    if (["clean", "init", "demo", "help", "--help", "-h", "mcp"].includes(cmd)) {
+        return { command: cmd.replace(/^-+/, ""), port: null, childCommand: [] };
+    }
+    if (cmd !== "serve")
+        return { command: "mcp", port: null, childCommand: [] };
+    let port = null;
+    const child = [];
+    let past = false;
+    for (let i = 1; i < args.length; i++) {
+        if (args[i] === "--") {
+            past = true;
+            continue;
+        }
+        if (past) {
+            child.push(args[i]);
+            continue;
+        }
+        if (args[i] === "--port" && args[i + 1]) {
+            port = parseInt(args[i + 1], 10);
+            i++;
+        }
+    }
+    return { command: "serve", port, childCommand: child };
+}
+// --- Init ---
+function initCommand(cwd) {
+    banner();
+    section("SETUP");
+    let devCmd = ["npm", "run", "dev"];
+    let isTauri = false;
+    const pkgPath = join(cwd, "package.json");
+    if (existsSync(pkgPath)) {
+        try {
+            const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+            // Detect Tauri project
+            const hasTauriCli = pkg.devDependencies?.["@tauri-apps/cli"] || pkg.dependencies?.["@tauri-apps/cli"];
+            const hasTauriScript = pkg.scripts?.["tauri"];
+            if ((hasTauriCli || hasTauriScript) && existsSync(join(cwd, "src-tauri"))) {
+                isTauri = true;
+                devCmd = ["cargo", "tauri", "dev"];
+                success(`Detected ${c.bold}Tauri${c.reset} project: ${c.bold}${pkg.name ?? "unknown"}${c.reset}`);
+            }
+            else {
+                if (pkg.scripts?.dev)
+                    devCmd = ["npm", "run", "dev"];
+                else if (pkg.scripts?.start)
+                    devCmd = ["npm", "start"];
+                else if (pkg.scripts?.serve)
+                    devCmd = ["npm", "run", "serve"];
+                success(`Detected project: ${c.bold}${pkg.name ?? "unknown"}${c.reset}`);
+            }
+        }
+        catch { }
+    }
+    // Write MCP config
+    const claudeDir = join(cwd, ".claude");
+    if (!existsSync(claudeDir))
+        mkdirSync(claudeDir, { recursive: true });
+    const mcpPath = join(claudeDir, "mcp.json");
+    const existing = existsSync(mcpPath) ? JSON.parse(readFileSync(mcpPath, "utf-8")) : { mcpServers: {} };
+    existing.mcpServers ??= {};
+    // OPTION A: Pure MCP mode (zero-config, no proxy)
+    existing.mcpServers["debug-toolkit"] = {
+        command: "npx",
+        args: ["-y", "debug-toolkit"],
+    };
+    // OPTION B: With dev server wrapping (full capture)
+    existing.mcpServers["debug-toolkit-serve"] = {
+        command: "npx",
+        args: ["-y", "debug-toolkit", "serve", "--", ...devCmd],
+    };
+    writeFileSync(mcpPath, JSON.stringify(existing, null, 2) + "\n");
+    success(`MCP config ${sym.arrow} ${mcpPath}`);
+    // Hook
+    const h = installHook(cwd);
+    if (h.installed)
+        success(h.message);
+    if (isTauri) {
+        section("TAURI SUPPORT");
+        info(`${c.green}${sym.check}${c.reset} Rust stack trace parsing (panics + backtraces)`);
+        info(`${c.green}${sym.check}${c.reset} Tauri error classification (invoke, capability, plugin)`);
+        info(`${c.green}${sym.check}${c.reset} Rust code instrumentation (eprintln! with markers)`);
+        info(`${c.green}${sym.check}${c.reset} Tauri log file auto-discovery and tailing`);
+        info(`${c.green}${sym.check}${c.reset} RUST_BACKTRACE=1 auto-enabled in serve mode`);
+        dim("");
+    }
+    section("TWO MODES");
+    info(`${c.cyan}debug-toolkit${c.reset}        ${c.dim}Pure MCP server — investigate, instrument, verify${c.reset}`);
+    info(`${c.cyan}debug-toolkit serve${c.reset}   ${c.dim}+ dev server wrapping for ${isTauri ? "Tauri" : "browser"} capture${c.reset}`);
+    dim("");
+    info("Both modes registered. Restart Claude Code to activate.");
+    dim(`Edit ${mcpPath} to customize\n`);
+}
+// --- Main ---
+async function main() {
+    const parsed = parseArgs(process.argv);
+    const cwd = resolve(process.cwd());
+    setCwd(cwd);
+    switch (parsed.command) {
+        case "help":
+            printHelp();
+            break;
+        case "demo": {
+            const { runDemo } = await import("./demo.js");
+            await runDemo();
+            break;
+        }
+        case "init":
+            initCommand(cwd);
+            break;
+        case "clean": {
+            banner();
+            info("Scanning for debug markers...");
+            const r = cleanupFromManifest(cwd);
+            if (r.cleaned === 0)
+                success("Clean — no markers found.");
+            else {
+                success(`${r.cleaned} file(s) cleaned`);
+                for (const f of r.filesProcessed)
+                    dim(`  ${sym.arrow} ${f}`);
+                if (!r.verified)
+                    for (const e of r.errors)
+                        error(e);
+            }
+            process.exit(r.verified ? 0 : 1);
+            break;
+        }
+        // DEFAULT: Pure MCP server. No dev server wrapping needed.
+        // Just start the MCP server on stdio. The agent gets 6 tools instantly.
+        case "mcp": {
+            await startMcpServer();
+            break;
+        }
+        case "serve": {
+            if (parsed.childCommand.length === 0) {
+                error("No command specified");
+                dim("  Usage: debug-toolkit serve -- <command>");
+                process.exit(1);
+            }
+            const childCmd = parsed.childCommand.join(" ");
+            banner();
+            kv("process", childCmd);
+            // Auto-enable Rust backtraces for Tauri/Rust projects
+            const childEnv = { ...process.env };
+            if (!childEnv.RUST_BACKTRACE)
+                childEnv.RUST_BACKTRACE = "1";
+            if (!childEnv.RUST_LOG)
+                childEnv.RUST_LOG = "info";
+            const child = spawn(childCmd, {
+                shell: true,
+                stdio: ["inherit", "pipe", "pipe"],
+                cwd,
+                env: childEnv,
+            });
+            pipeProcess(child);
+            installHook(cwd);
+            let proxyHandle = null;
+            if (child.stdout) {
+                try {
+                    const target = parsed.port ?? (await detectPort(child.stdout));
+                    const listen = parsed.port ? parsed.port + 1 : target + 1000;
+                    proxyHandle = startProxy({ targetPort: target, listenPort: listen });
+                    kv("proxy", `http://localhost:${listen} ${sym.arrow} :${target}`);
+                }
+                catch (e) {
+                    warn(`Proxy unavailable: ${e instanceof Error ? e.message : ""}`);
+                }
+            }
+            startMcpServer().catch((e) => error(`MCP: ${e}`));
+            ready(8);
+            const cleanup = () => {
+                if (child.pid)
+                    treeKill(child.pid, "SIGTERM");
+                proxyHandle?.close();
+            };
+            process.on("SIGINT", cleanup);
+            process.on("SIGTERM", cleanup);
+            child.on("close", (code) => {
+                dim(`Process exited (${code})`);
+                proxyHandle?.close();
+                process.exit(code ?? 0);
+            });
+            break;
+        }
+    }
+}
+main().catch((e) => { error(String(e)); process.exit(1); });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/injected.js

@@ -0,0 +1,151 @@
+(function () {
+  "use strict";
+
+  var wsUrl =
+    "ws://" + location.hostname + ":" + location.port + "/__debug_toolkit/ws";
+  var ws;
+  var queue = [];
+  var reconnectAttempts = 0;
+  var maxReconnects = 5;
+
+  function send(type, data) {
+    var msg = JSON.stringify({ type: type, data: data, ts: Date.now() });
+    if (ws && ws.readyState === WebSocket.OPEN) {
+      ws.send(msg);
+    } else {
+      queue.push(msg);
+      if (queue.length > 100) queue.shift(); // Prevent unbounded queue growth
+    }
+  }
+
+  function connect() {
+    try {
+      ws = new WebSocket(wsUrl);
+    } catch (_) {
+      return;
+    }
+
+    ws.addEventListener("open", function () {
+      reconnectAttempts = 0;
+      for (var i = 0; i < queue.length; i++) {
+        ws.send(queue[i]);
+      }
+      queue = [];
+    });
+
+    ws.addEventListener("close", function () {
+      if (reconnectAttempts >= maxReconnects) return;
+      var delay = Math.min(1000 * Math.pow(2, reconnectAttempts), 16000);
+      reconnectAttempts++;
+      setTimeout(connect, delay);
+    });
+
+    ws.addEventListener("error", function () {
+      // Errors are followed by close events, so reconnect logic handles it
+    });
+  }
+
+  connect();
+
+  // --- Console capture ---
+  var methods = ["log", "warn", "error", "info", "debug"];
+  methods.forEach(function (method) {
+    var orig = console[method];
+    console[method] = function () {
+      var args = Array.prototype.slice.call(arguments);
+      send("console", {
+        level: method,
+        args: args.map(function (a) {
+          try {
+            return typeof a === "object" ? JSON.stringify(a) : String(a);
+          } catch (_) {
+            return "[unserializable]";
+          }
+        }),
+      });
+      return orig.apply(console, arguments);
+    };
+  });
+
+  // --- Error capture ---
+  window.addEventListener("error", function (e) {
+    send("error", {
+      message: e.message,
+      source: e.filename,
+      line: e.lineno,
+      column: e.colno,
+    });
+  });
+
+  window.addEventListener("unhandledrejection", function (e) {
+    send("error", {
+      message: e.reason ? String(e.reason) : "Unhandled promise rejection",
+      type: "unhandledrejection",
+    });
+  });
+
+  // --- Network failure capture (fetch) ---
+  var origFetch = window.fetch;
+  window.fetch = function () {
+    var args = arguments;
+    var url = String(args[0] && args[0].url ? args[0].url : args[0]);
+    var method =
+      (args[1] && args[1].method) ||
+      (args[0] && args[0].method) ||
+      "GET";
+
+    return origFetch.apply(this, args).then(
+      function (res) {
+        if (!res.ok) {
+          send("network", {
+            url: url,
+            method: method,
+            status: res.status,
+            statusText: res.statusText,
+          });
+        }
+        return res;
+      },
+      function (err) {
+        send("network", {
+          url: url,
+          method: method,
+          error: err.message || String(err),
+        });
+        throw err;
+      },
+    );
+  };
+
+  // --- Network failure capture (XMLHttpRequest) ---
+  var origOpen = XMLHttpRequest.prototype.open;
+  var origSend = XMLHttpRequest.prototype.send;
+
+  XMLHttpRequest.prototype.open = function (method, url) {
+    this._dbg_method = method;
+    this._dbg_url = String(url);
+    return origOpen.apply(this, arguments);
+  };
+
+  XMLHttpRequest.prototype.send = function () {
+    var self = this;
+    self.addEventListener("load", function () {
+      if (self.status >= 400) {
+        send("network", {
+          url: self._dbg_url,
+          method: self._dbg_method,
+          status: self.status,
+          statusText: self.statusText,
+        });
+      }
+    });
+    self.addEventListener("error", function () {
+      send("network", {
+        url: self._dbg_url,
+        method: self._dbg_method,
+        error: "Network error",
+      });
+    });
+    return origSend.apply(this, arguments);
+  };
+})();

package/dist/instrument.d.ts

@@ -0,0 +1,15 @@
+import { type DebugSession, type InstrumentationRecord } from "./session.js";
+export interface InstrumentOptions {
+    cwd: string;
+    session: DebugSession;
+    filePath: string;
+    lineNumber: number;
+    expression: string;
+    hypothesisId?: string;
+}
+export interface InstrumentResult {
+    record: InstrumentationRecord;
+    markerTag: string;
+    insertedCode: string;
+}
+export declare function instrumentFile(opts: InstrumentOptions): InstrumentResult;

package/dist/instrument.js

@@ -0,0 +1,87 @@
+import { readFileSync, statSync, renameSync, writeFileSync } from "node:fs";
+import { extname } from "node:path";
+import { validateFilePath, validateExpression } from "./security.js";
+import { newInstrumentationId, nextMarkerTag, indexMarker, saveSession, MAX_FILE_SIZE, } from "./session.js";
+const EXT_MAP = {
+    ".js": "js",
+    ".jsx": "js",
+    ".mjs": "js",
+    ".cjs": "js",
+    ".ts": "ts",
+    ".tsx": "ts",
+    ".mts": "ts",
+    ".cts": "ts",
+    ".py": "py",
+    ".go": "go",
+    ".rs": "rs",
+};
+function detectLanguage(filePath) {
+    return EXT_MAP[extname(filePath)] ?? "unknown";
+}
+// --- Indentation detection ---
+function getIndentation(line) {
+    const match = line.match(/^(\s*)/);
+    return match ? match[1] : "";
+}
+// --- Marker generation ---
+function wrapInstrumentation(lang, tag, expression, indent) {
+    switch (lang) {
+        case "js":
+        case "ts":
+            return `${indent}/* __DBG_START_${tag}__ */ console.log("[${tag}]", ${expression}); /* __DBG_END_${tag}__ */`;
+        case "py":
+            return `${indent}# __DBG_START_${tag}__\n${indent}print(f"[${tag}] {${expression}}")\n${indent}# __DBG_END_${tag}__`;
+        case "go":
+            return `${indent}/* __DBG_START_${tag}__ */ fmt.Printf("[${tag}] %v\\n", ${expression}) /* __DBG_END_${tag}__ */`;
+        case "rs":
+            return `${indent}/* __DBG_START_${tag}__ */ eprintln!("[${tag}] {:?}", ${expression}); /* __DBG_END_${tag}__ */`;
+        default:
+            return `${indent}/* __DBG_START_${tag}__ */ console.log("[${tag}]", ${expression}); /* __DBG_END_${tag}__ */`;
+    }
+}
+export function instrumentFile(opts) {
+    const { cwd, session, filePath, lineNumber, expression, hypothesisId } = opts;
+    // Security: validate file path and expression
+    const safePath = validateFilePath(filePath, cwd);
+    const safeExpression = validateExpression(expression);
+    // Safety: check file size
+    const stat = statSync(safePath);
+    if (stat.size > MAX_FILE_SIZE) {
+        throw new Error(`File too large (${stat.size} bytes). Max ${MAX_FILE_SIZE / 1024 / 1024}MB.`);
+    }
+    const lang = detectLanguage(safePath);
+    const content = readFileSync(safePath, "utf-8");
+    const lines = content.split("\n");
+    // Clamp line number to valid range
+    const insertAt = Math.min(Math.max(lineNumber, 0), lines.length);
+    // Detect indentation from the target line (or the line before it)
+    const targetLine = lines[insertAt] ?? lines[insertAt - 1] ?? "";
+    const indent = getIndentation(targetLine);
+    const tag = nextMarkerTag();
+    const insertedCode = wrapInstrumentation(lang, tag, safeExpression, indent);
+    // Insert the instrumentation lines
+    const instrumentLines = insertedCode.split("\n");
+    lines.splice(insertAt, 0, ...instrumentLines);
+    // Atomic write: write to tmp file then rename
+    const tmpPath = `${safePath}.dbg_tmp_${Date.now()}`;
+    writeFileSync(tmpPath, lines.join("\n"));
+    renameSync(tmpPath, safePath);
+    // Record with hypothesis link
+    const record = {
+        id: newInstrumentationId(),
+        filePath: safePath,
+        lineNumber: insertAt,
+        markerTag: tag,
+        language: lang,
+        insertedCode,
+        active: true,
+        hypothesisId: hypothesisId ?? null,
+    };
+    session.instrumentation.push(record);
+    // Index marker → hypothesis for O(1) lookup during capture linking
+    indexMarker(session, tag, hypothesisId ?? null);
+    // Single save (no separate manifest file)
+    saveSession(cwd, session);
+    return { record, markerTag: tag, insertedCode };
+}
+//# sourceMappingURL=instrument.js.map

package/dist/instrument.js.map

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

package/dist/mcp.d.ts

@@ -0,0 +1,14 @@
+/**
+ * mcp.ts — MCP server with 9 tools + 1 resource.
+ *
+ * Design principles:
+ *   1. One tool = one complete outcome. No chatty multi-step protocols.
+ *   2. Preprocess, don't dump. Summarize and highlight, never return raw arrays.
+ *   3. Every response tells the agent what to do next.
+ *   4. Context window space is precious — keep responses compact.
+ *   5. Memory: save diagnoses, recall past fixes for similar errors.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function setCwd(dir: string): void;
+export declare function createMcpServer(): McpServer;
+export declare function startMcpServer(): Promise<void>;