debuganything 0.0.0-stage → 1.0.0

package/dist/setup-NTPRUTMT.js

@@ -0,0 +1,265 @@
+#!/usr/bin/env node
+import {
+  HOOK_SCRIPT
+} from "./chunk-7MMXFUUN.js";
+
+// src/setup.ts
+import { readFile, writeFile, mkdir, copyFile, access } from "fs/promises";
+import { existsSync } from "fs";
+import { homedir } from "os";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+import { createInterface } from "readline/promises";
+import pc from "picocolors";
+var MCP_ENTRY = { command: "npx", args: ["-y", "debuganything@latest", "serve"] };
+var AGENTS = [
+  {
+    id: "claude",
+    label: "Claude Code",
+    configPath: (h) => join(h, ".claude.json"),
+    detect: (h) => existsSync(join(h, ".claude.json")) || existsSync(join(h, ".claude", "settings.json")) || existsSync(join(h, ".claude")),
+    format: "json",
+    key: "mcpServers",
+    skillsDir: (h) => join(h, ".claude", "skills", "debug-anything")
+  },
+  {
+    id: "codex",
+    label: "Codex",
+    configPath: (h) => join(h, ".codex", "config.toml"),
+    detect: (h) => existsSync(join(h, ".codex")),
+    format: "toml",
+    key: "mcp_servers.debuganything",
+    skillsDir: (h) => join(h, ".codex", "skills", "debug-anything")
+  },
+  {
+    id: "cursor",
+    label: "Cursor",
+    configPath: (h) => join(h, ".cursor", "mcp.json"),
+    detect: (h) => existsSync(join(h, ".cursor")),
+    format: "json",
+    key: "mcpServers"
+  },
+  {
+    id: "gemini",
+    label: "Gemini CLI",
+    configPath: (h) => join(h, ".gemini", "settings.json"),
+    detect: (h) => existsSync(join(h, ".gemini")),
+    format: "json",
+    key: "mcpServers",
+    skillsDir: (h) => join(h, ".gemini", "skills", "debug-anything")
+  }
+];
+function patchJsonConfig(existing, key = "mcpServers") {
+  let obj = {};
+  if (existing && existing.trim()) {
+    try {
+      obj = JSON.parse(existing);
+    } catch {
+      throw new Error("existing config is not valid JSON; refusing to overwrite it");
+    }
+  }
+  const servers = obj[key] ?? {};
+  const current = JSON.stringify(servers.debuganything ?? null);
+  const desired = JSON.stringify(MCP_ENTRY);
+  if (current === desired) return { next: existing ?? JSON.stringify(obj, null, 2) + "\n", changed: false };
+  servers.debuganything = { command: MCP_ENTRY.command, args: [...MCP_ENTRY.args] };
+  obj[key] = servers;
+  return { next: JSON.stringify(obj, null, 2) + "\n", changed: true };
+}
+function patchClaudeHooks(existing, scriptPath) {
+  let obj = {};
+  if (existing && existing.trim()) {
+    try {
+      obj = JSON.parse(existing);
+    } catch {
+      throw new Error("existing settings.json is not valid JSON; refusing to overwrite it");
+    }
+  }
+  const cmd = `node "${scriptPath}"`;
+  const hooks = obj.hooks ??= {};
+  let changed = false;
+  const ensure = (event, matcher) => {
+    const list = hooks[event] ??= [];
+    const has = list.some((g) => Array.isArray(g?.hooks) && g.hooks.some((h) => typeof h?.command === "string" && h.command.includes("debuganything-hook.mjs")));
+    if (has) return;
+    list.push({ ...matcher ? { matcher } : {}, hooks: [{ type: "command", command: cmd, timeout: 10 }] });
+    changed = true;
+  };
+  ensure("PostToolUse", "Bash");
+  ensure("UserPromptSubmit", void 0);
+  return { next: JSON.stringify(obj, null, 2) + "\n", changed };
+}
+var TOML_BLOCK = `[mcp_servers.debuganything]
+command = "npx"
+args = ["-y", "debuganything@latest", "serve"]
+`;
+function patchTomlConfig(existing) {
+  const text = existing ?? "";
+  const re = /^\[mcp_servers\.debuganything\]\n(?:(?!\[)[^\n]*\n?)*/m;
+  if (re.test(text)) {
+    const current = re.exec(text)[0];
+    if (current.trim() === TOML_BLOCK.trim()) return { next: text, changed: false };
+    return { next: text.replace(re, TOML_BLOCK), changed: true };
+  }
+  const sep = text.length && !text.endsWith("\n") ? "\n\n" : text.length ? "\n" : "";
+  return { next: text + sep + TOML_BLOCK, changed: true };
+}
+function skillSourceDir() {
+  const here = dirname(fileURLToPath(import.meta.url));
+  for (const cand of [join(here, "..", "skills", "debug-anything"), join(here, "..", "..", "skills", "debug-anything")]) {
+    if (existsSync(join(cand, "SKILL.md"))) return cand;
+  }
+  throw new Error("skills/debug-anything/SKILL.md not found next to the package");
+}
+async function setup(opts = {}) {
+  const home = opts.home ?? homedir();
+  const log = opts.log ?? ((s) => process.stdout.write(s + "\n"));
+  const wanted = AGENTS.filter((a) => opts.agents ? opts.agents.includes(a.id) : a.detect(home));
+  const written = [];
+  const skipped = [];
+  if (wanted.length === 0) {
+    log(pc.yellow("No supported agent detected (looked for ~/.claude.json, ~/.codex/, ~/.cursor/, ~/.gemini/)."));
+    log(`Add this to your agent's MCP config manually:
+${JSON.stringify({ mcpServers: { debuganything: MCP_ENTRY } }, null, 2)}`);
+    return { written, skipped };
+  }
+  log(pc.bold("Debug Anything setup will:"));
+  const plans = [];
+  for (const agent of wanted) {
+    const path = agent.configPath(home);
+    const existing = existsSync(path) ? await readFile(path, "utf8") : null;
+    const { next, changed } = agent.format === "json" ? patchJsonConfig(existing, agent.key) : patchTomlConfig(existing);
+    plans.push({ agent, path, next, changed, existing });
+    log(`
+${pc.cyan("\u2022")} ${pc.bold(agent.label)} \u2192 ${path} ${changed ? "" : pc.dim("(already registered)")}`);
+    if (changed) {
+      log(pc.dim(agent.format === "json" ? JSON.stringify({ [agent.key]: { debuganything: MCP_ENTRY } }, null, 2) : TOML_BLOCK.trim()));
+    }
+    if (agent.skillsDir) log(pc.dim(`  + copy skills/debug-anything/SKILL.md \u2192 ${agent.skillsDir(home)}/SKILL.md`));
+    if (agent.id === "claude" && opts.hooks !== false) {
+      log(pc.dim(`  + write ${join(home, ".debuganything", "hooks", "debuganything-hook.mjs")} and register it in ${join(home, ".claude", "settings.json")} (hooks.PostToolUse[Bash], hooks.UserPromptSubmit) so the agent reaches for Debug Anything on EADDRINUSE / OOM / timeouts / "it hangs" without being asked. Disable with --no-hooks.`));
+    }
+  }
+  if (opts.dryRun) {
+    log(pc.dim("\n--dry-run: nothing written."));
+    return { written, skipped: plans.map((p) => p.path) };
+  }
+  if (!opts.yes) {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    const ans = (await rl.question("\nApply these changes? Existing files are backed up to *.bak-debuganything [y/N] ")).trim().toLowerCase();
+    rl.close();
+    if (ans !== "y" && ans !== "yes") {
+      log("aborted; nothing written");
+      return { written, skipped: plans.map((p) => p.path) };
+    }
+  }
+  const skillSrc = skillSourceDir();
+  for (const p of plans) {
+    if (p.changed) {
+      await mkdir(dirname(p.path), { recursive: true });
+      if (p.existing !== null) await copyFile(p.path, `${p.path}.bak-debuganything`);
+      await writeFile(p.path, p.next);
+      written.push(p.path);
+    } else skipped.push(p.path);
+    if (p.agent.skillsDir) {
+      const dir = p.agent.skillsDir(home);
+      await mkdir(dir, { recursive: true });
+      await copyFile(join(skillSrc, "SKILL.md"), join(dir, "SKILL.md"));
+      written.push(join(dir, "SKILL.md"));
+    }
+    if (p.agent.id === "claude" && opts.hooks !== false) {
+      const hookDir = join(home, ".debuganything", "hooks");
+      await mkdir(hookDir, { recursive: true });
+      const script = join(hookDir, "debuganything-hook.mjs");
+      await writeFile(script, HOOK_SCRIPT, { mode: 493 });
+      written.push(script);
+      const settingsPath = join(home, ".claude", "settings.json");
+      const existing = existsSync(settingsPath) ? await readFile(settingsPath, "utf8") : null;
+      const { next, changed } = patchClaudeHooks(existing, script);
+      if (changed) {
+        await mkdir(dirname(settingsPath), { recursive: true });
+        if (existing !== null) await copyFile(settingsPath, `${settingsPath}.bak-debuganything`);
+        await writeFile(settingsPath, next);
+        written.push(settingsPath);
+      }
+    }
+  }
+  log(`
+${pc.green("Done.")} ${written.length} file(s) written. ${pc.bold("Restart your agent")} and ask it: \u201CMy API gets slow after a few minutes \u2014 attach to it and tell me why, with evidence.\u201D`);
+  return { written, skipped };
+}
+async function fileExists(p) {
+  try {
+    await access(p);
+    return true;
+  } catch {
+    return false;
+  }
+}
+var AGENTS_MD_BLOCK = `## Runtime debugging with Debug Anything
+
+DEA (Debug Anything) is registered as an MCP server for this repo (\`.mcp.json\`, \`.cursor/mcp.json\`).
+When something *running* misbehaves \u2014 a command hangs, a test times out, you see EADDRINUSE / ECONNREFUSED /
+EMFILE / exit 137 / OOM / a segfault, a server you started does not respond, or the user says slow, hang,
+leak or crash \u2014 attach and measure before theorizing: \`readiness\` \u2192 \`attach\` \u2192 \`dump_stacks\` /
+\`profile_cpu\` / \`inspect_sockets\` / \`snapshot_memory\` / \`container_info\` \u2192 \`detach\`. Cite evidence ids
+(e.g. \`profile_cpu#2/e3\`). Read-only tools need no permission; \`capture_traffic\` needs the user's consent.
+After a performance fix, re-measure and \`diff_runs\` to prove it; put the evidence ids in the PR.
+Docs: https://github.com/shreyassaw5394/debuganything
+`;
+function patchAgentsMd(existing) {
+  const text = existing ?? "";
+  if (text.includes("## Runtime debugging with Debug Anything")) return { next: text, changed: false };
+  const sep = text.length === 0 ? "" : text.endsWith("\n\n") ? "" : text.endsWith("\n") ? "\n" : "\n\n";
+  return { next: text + sep + AGENTS_MD_BLOCK, changed: true };
+}
+async function init(opts = {}) {
+  const dir = opts.dir ?? process.cwd();
+  const log = opts.log ?? ((s) => process.stdout.write(s + "\n"));
+  const written = [];
+  const skipped = [];
+  const plans = [];
+  for (const rel of [".mcp.json", join(".cursor", "mcp.json")]) {
+    const path = join(dir, rel);
+    const existing = existsSync(path) ? await readFile(path, "utf8") : null;
+    const { next, changed } = patchJsonConfig(existing);
+    plans.push({ path, next, changed, existing, what: "MCP server entry" });
+  }
+  const candidates = ["AGENTS.md", "CLAUDE.md"].map((f) => join(dir, f));
+  const target = candidates.find((p) => existsSync(p)) ?? candidates[0];
+  const existingMd = existsSync(target) ? await readFile(target, "utf8") : null;
+  const md = patchAgentsMd(existingMd);
+  plans.push({ path: target, next: md.next, changed: md.changed, existing: existingMd, what: "runtime-debugging rule for agents" });
+  log(pc.bold(`Debug Anything init in ${dir} will:`));
+  for (const p of plans) log(`${pc.cyan("\u2022")} ${p.path} ${p.changed ? pc.dim(`(+ ${p.what})`) : pc.dim("(already set up)")}`);
+  if (opts.dryRun) {
+    log(pc.dim("--dry-run: nothing written."));
+    return { written, skipped: plans.map((p) => p.path) };
+  }
+  for (const p of plans) {
+    if (!p.changed) {
+      skipped.push(p.path);
+      continue;
+    }
+    await mkdir(dirname(p.path), { recursive: true });
+    if (p.existing !== null) await copyFile(p.path, `${p.path}.bak-debuganything`);
+    await writeFile(p.path, p.next);
+    written.push(p.path);
+  }
+  log(`${pc.green("Done.")} Commit these files so every teammate's agent gets Debug Anything. Each person still runs ${pc.bold("npx debuganything setup")} once for the skill and hook.`);
+  return { written, skipped };
+}
+export {
+  AGENTS,
+  AGENTS_MD_BLOCK,
+  MCP_ENTRY,
+  TOML_BLOCK,
+  fileExists,
+  init,
+  patchAgentsMd,
+  patchClaudeHooks,
+  patchJsonConfig,
+  patchTomlConfig,
+  setup
+};
+//# sourceMappingURL=setup-NTPRUTMT.js.map

package/dist/setup-NTPRUTMT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/setup.ts"],"sourcesContent":["/**\n * `debuganything setup` — register the MCP server + skill with Claude Code, Codex,\n * Cursor and Gemini CLI. Shows the exact change, backs up the file, writes.\n */\nimport { readFile, writeFile, mkdir, copyFile, access } from \"node:fs/promises\";\nimport { existsSync } from \"node:fs\";\nimport { homedir } from \"node:os\";\nimport { dirname, join } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { createInterface } from \"node:readline/promises\";\nimport pc from \"picocolors\";\nimport { HOOK_SCRIPT } from \"./hook.js\";\n\nexport const MCP_ENTRY = { command: \"npx\", args: [\"-y\", \"debuganything@latest\", \"serve\"] } as const;\n\nexport interface AgentTarget {\n  id: \"claude\" | \"codex\" | \"cursor\" | \"gemini\";\n  label: string;\n  configPath(home: string): string;\n  /** Config exists → agent considered installed. Claude Code may have either file. */\n  detect(home: string): boolean;\n  format: \"json\" | \"toml\";\n  /** JSON path to the mcpServers object, or TOML table name. */\n  key: string;\n  skillsDir?(home: string): string;\n}\n\nexport const AGENTS: AgentTarget[] = [\n  {\n    id: \"claude\",\n    label: \"Claude Code\",\n    configPath: (h) => join(h, \".claude.json\"),\n    detect: (h) => existsSync(join(h, \".claude.json\")) || existsSync(join(h, \".claude\", \"settings.json\")) || existsSync(join(h, \".claude\")),\n    format: \"json\",\n    key: \"mcpServers\",\n    skillsDir: (h) => join(h, \".claude\", \"skills\", \"debug-anything\"),\n  },\n  {\n    id: \"codex\",\n    label: \"Codex\",\n    configPath: (h) => join(h, \".codex\", \"config.toml\"),\n    detect: (h) => existsSync(join(h, \".codex\")),\n    format: \"toml\",\n    key: \"mcp_servers.debuganything\",\n    skillsDir: (h) => join(h, \".codex\", \"skills\", \"debug-anything\"),\n  },\n  {\n    id: \"cursor\",\n    label: \"Cursor\",\n    configPath: (h) => join(h, \".cursor\", \"mcp.json\"),\n    detect: (h) => existsSync(join(h, \".cursor\")),\n    format: \"json\",\n    key: \"mcpServers\",\n  },\n  {\n    id: \"gemini\",\n    label: \"Gemini CLI\",\n    configPath: (h) => join(h, \".gemini\", \"settings.json\"),\n    detect: (h) => existsSync(join(h, \".gemini\")),\n    format: \"json\",\n    key: \"mcpServers\",\n    skillsDir: (h) => join(h, \".gemini\", \"skills\", \"debug-anything\"),\n  },\n];\n\n/** Produce the new JSON config text given existing text. Pure. */\nexport function patchJsonConfig(existing: string | null, key = \"mcpServers\"): { next: string; changed: boolean } {\n  let obj: Record<string, unknown> = {};\n  if (existing && existing.trim()) {\n    try {\n      obj = JSON.parse(existing) as Record<string, unknown>;\n    } catch {\n      throw new Error(\"existing config is not valid JSON; refusing to overwrite it\");\n    }\n  }\n  const servers = ((obj[key] as Record<string, unknown> | undefined) ?? {}) as Record<string, unknown>;\n  const current = JSON.stringify(servers.debuganything ?? null);\n  const desired = JSON.stringify(MCP_ENTRY);\n  if (current === desired) return { next: existing ?? JSON.stringify(obj, null, 2) + \"\\n\", changed: false };\n  servers.debuganything = { command: MCP_ENTRY.command, args: [...MCP_ENTRY.args] };\n  obj[key] = servers;\n  return { next: JSON.stringify(obj, null, 2) + \"\\n\", changed: true };\n}\n\n/** Claude Code hooks entries (settings.json). Pure. */\nexport function patchClaudeHooks(existing: string | null, scriptPath: string): { next: string; changed: boolean } {\n  let obj: Record<string, any> = {};\n  if (existing && existing.trim()) {\n    try {\n      obj = JSON.parse(existing);\n    } catch {\n      throw new Error(\"existing settings.json is not valid JSON; refusing to overwrite it\");\n    }\n  }\n  const cmd = `node \"${scriptPath}\"`;\n  const hooks = (obj.hooks ??= {});\n  let changed = false;\n  const ensure = (event: string, matcher: string | undefined) => {\n    const list: any[] = (hooks[event] ??= []);\n    const has = list.some((g) => Array.isArray(g?.hooks) && g.hooks.some((h: any) => typeof h?.command === \"string\" && h.command.includes(\"debuganything-hook.mjs\")));\n    if (has) return;\n    list.push({ ...(matcher ? { matcher } : {}), hooks: [{ type: \"command\", command: cmd, timeout: 10 }] });\n    changed = true;\n  };\n  ensure(\"PostToolUse\", \"Bash\");\n  ensure(\"UserPromptSubmit\", undefined);\n  return { next: JSON.stringify(obj, null, 2) + \"\\n\", changed };\n}\n\nexport const TOML_BLOCK = `[mcp_servers.debuganything]\\ncommand = \"npx\"\\nargs = [\"-y\", \"debuganything@latest\", \"serve\"]\\n`;\n\n/** Patch a TOML config: replace an existing [mcp_servers.debuganything] table or append one. Pure, no TOML dependency. */\nexport function patchTomlConfig(existing: string | null): { next: string; changed: boolean } {\n  const text = existing ?? \"\";\n  const re = /^\\[mcp_servers\\.debuganything\\]\\n(?:(?!\\[)[^\\n]*\\n?)*/m;\n  if (re.test(text)) {\n    const current = re.exec(text)![0];\n    if (current.trim() === TOML_BLOCK.trim()) return { next: text, changed: false };\n    return { next: text.replace(re, TOML_BLOCK), changed: true };\n  }\n  const sep = text.length && !text.endsWith(\"\\n\") ? \"\\n\\n\" : text.length ? \"\\n\" : \"\";\n  return { next: text + sep + TOML_BLOCK, changed: true };\n}\n\nfunction skillSourceDir(): string {\n  // dist/cli.js → ../skills ; src/setup.ts → ../skills\n  const here = dirname(fileURLToPath(import.meta.url));\n  for (const cand of [join(here, \"..\", \"skills\", \"debug-anything\"), join(here, \"..\", \"..\", \"skills\", \"debug-anything\")]) {\n    if (existsSync(join(cand, \"SKILL.md\"))) return cand;\n  }\n  throw new Error(\"skills/debug-anything/SKILL.md not found next to the package\");\n}\n\nexport interface SetupOptions {\n  yes?: boolean;\n  home?: string;\n  agents?: string[];\n  dryRun?: boolean;\n  /** Install the Claude Code proactive hook (default true). */\n  hooks?: boolean;\n  /** Test hook. */\n  log?: (s: string) => void;\n}\n\nexport async function setup(opts: SetupOptions = {}): Promise<{ written: string[]; skipped: string[] }> {\n  const home = opts.home ?? homedir();\n  const log = opts.log ?? ((s: string) => process.stdout.write(s + \"\\n\"));\n  const wanted = AGENTS.filter((a) => (opts.agents ? opts.agents.includes(a.id) : a.detect(home)));\n  const written: string[] = [];\n  const skipped: string[] = [];\n  if (wanted.length === 0) {\n    log(pc.yellow(\"No supported agent detected (looked for ~/.claude.json, ~/.codex/, ~/.cursor/, ~/.gemini/).\"));\n    log(`Add this to your agent's MCP config manually:\\n${JSON.stringify({ mcpServers: { debuganything: MCP_ENTRY } }, null, 2)}`);\n    return { written, skipped };\n  }\n  log(pc.bold(\"Debug Anything setup will:\"));\n  const plans: Array<{ agent: AgentTarget; path: string; next: string; changed: boolean; existing: string | null }> = [];\n  for (const agent of wanted) {\n    const path = agent.configPath(home);\n    const existing = existsSync(path) ? await readFile(path, \"utf8\") : null;\n    const { next, changed } = agent.format === \"json\" ? patchJsonConfig(existing, agent.key) : patchTomlConfig(existing);\n    plans.push({ agent, path, next, changed, existing });\n    log(`\\n${pc.cyan(\"•\")} ${pc.bold(agent.label)} → ${path} ${changed ? \"\" : pc.dim(\"(already registered)\")}`);\n    if (changed) {\n      log(pc.dim(agent.format === \"json\" ? JSON.stringify({ [agent.key]: { debuganything: MCP_ENTRY } }, null, 2) : TOML_BLOCK.trim()));\n    }\n    if (agent.skillsDir) log(pc.dim(`  + copy skills/debug-anything/SKILL.md → ${agent.skillsDir(home)}/SKILL.md`));\n    if (agent.id === \"claude\" && opts.hooks !== false) {\n      log(pc.dim(`  + write ${join(home, \".debuganything\", \"hooks\", \"debuganything-hook.mjs\")} and register it in ${join(home, \".claude\", \"settings.json\")} (hooks.PostToolUse[Bash], hooks.UserPromptSubmit) so the agent reaches for Debug Anything on EADDRINUSE / OOM / timeouts / \"it hangs\" without being asked. Disable with --no-hooks.`));\n    }\n  }\n  if (opts.dryRun) {\n    log(pc.dim(\"\\n--dry-run: nothing written.\"));\n    return { written, skipped: plans.map((p) => p.path) };\n  }\n  if (!opts.yes) {\n    const rl = createInterface({ input: process.stdin, output: process.stdout });\n    const ans = (await rl.question(\"\\nApply these changes? Existing files are backed up to *.bak-debuganything [y/N] \")).trim().toLowerCase();\n    rl.close();\n    if (ans !== \"y\" && ans !== \"yes\") {\n      log(\"aborted; nothing written\");\n      return { written, skipped: plans.map((p) => p.path) };\n    }\n  }\n  const skillSrc = skillSourceDir();\n  for (const p of plans) {\n    if (p.changed) {\n      await mkdir(dirname(p.path), { recursive: true });\n      if (p.existing !== null) await copyFile(p.path, `${p.path}.bak-debuganything`);\n      await writeFile(p.path, p.next);\n      written.push(p.path);\n    } else skipped.push(p.path);\n    if (p.agent.skillsDir) {\n      const dir = p.agent.skillsDir(home);\n      await mkdir(dir, { recursive: true });\n      await copyFile(join(skillSrc, \"SKILL.md\"), join(dir, \"SKILL.md\"));\n      written.push(join(dir, \"SKILL.md\"));\n    }\n    if (p.agent.id === \"claude\" && opts.hooks !== false) {\n      const hookDir = join(home, \".debuganything\", \"hooks\");\n      await mkdir(hookDir, { recursive: true });\n      const script = join(hookDir, \"debuganything-hook.mjs\");\n      await writeFile(script, HOOK_SCRIPT, { mode: 0o755 });\n      written.push(script);\n      const settingsPath = join(home, \".claude\", \"settings.json\");\n      const existing = existsSync(settingsPath) ? await readFile(settingsPath, \"utf8\") : null;\n      const { next, changed } = patchClaudeHooks(existing, script);\n      if (changed) {\n        await mkdir(dirname(settingsPath), { recursive: true });\n        if (existing !== null) await copyFile(settingsPath, `${settingsPath}.bak-debuganything`);\n        await writeFile(settingsPath, next);\n        written.push(settingsPath);\n      }\n    }\n  }\n  log(`\\n${pc.green(\"Done.\")} ${written.length} file(s) written. ${pc.bold(\"Restart your agent\")} and ask it: “My API gets slow after a few minutes — attach to it and tell me why, with evidence.”`);\n  return { written, skipped };\n}\n\nexport async function fileExists(p: string): Promise<boolean> {\n  try {\n    await access(p);\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n\n// ---------------------------------------------------------------------------\n// `debuganything init` — project-level setup so every teammate's agent gets Debug Anything\n// ---------------------------------------------------------------------------\n\nexport const AGENTS_MD_BLOCK = `## Runtime debugging with Debug Anything\n\nDEA (Debug Anything) is registered as an MCP server for this repo (\\`.mcp.json\\`, \\`.cursor/mcp.json\\`).\nWhen something *running* misbehaves — a command hangs, a test times out, you see EADDRINUSE / ECONNREFUSED /\nEMFILE / exit 137 / OOM / a segfault, a server you started does not respond, or the user says slow, hang,\nleak or crash — attach and measure before theorizing: \\`readiness\\` → \\`attach\\` → \\`dump_stacks\\` /\n\\`profile_cpu\\` / \\`inspect_sockets\\` / \\`snapshot_memory\\` / \\`container_info\\` → \\`detach\\`. Cite evidence ids\n(e.g. \\`profile_cpu#2/e3\\`). Read-only tools need no permission; \\`capture_traffic\\` needs the user's consent.\nAfter a performance fix, re-measure and \\`diff_runs\\` to prove it; put the evidence ids in the PR.\nDocs: https://github.com/shreyassaw5394/debuganything\n`;\n\nexport interface InitOptions {\n  dir?: string;\n  dryRun?: boolean;\n  log?: (s: string) => void;\n}\n\n/** Append the Debug Anything block to an AGENTS.md/CLAUDE.md-style file if not present. Pure. */\nexport function patchAgentsMd(existing: string | null): { next: string; changed: boolean } {\n  const text = existing ?? \"\";\n  if (text.includes(\"## Runtime debugging with Debug Anything\")) return { next: text, changed: false };\n  const sep = text.length === 0 ? \"\" : text.endsWith(\"\\n\\n\") ? \"\" : text.endsWith(\"\\n\") ? \"\\n\" : \"\\n\\n\";\n  return { next: text + sep + AGENTS_MD_BLOCK, changed: true };\n}\n\nexport async function init(opts: InitOptions = {}): Promise<{ written: string[]; skipped: string[] }> {\n  const dir = opts.dir ?? process.cwd();\n  const log = opts.log ?? ((s: string) => process.stdout.write(s + \"\\n\"));\n  const written: string[] = [];\n  const skipped: string[] = [];\n  const plans: Array<{ path: string; next: string; changed: boolean; existing: string | null; what: string }> = [];\n  for (const rel of [\".mcp.json\", join(\".cursor\", \"mcp.json\")]) {\n    const path = join(dir, rel);\n    const existing = existsSync(path) ? await readFile(path, \"utf8\") : null;\n    const { next, changed } = patchJsonConfig(existing);\n    plans.push({ path, next, changed, existing, what: \"MCP server entry\" });\n  }\n  // One agent-instructions file: prefer existing AGENTS.md, then CLAUDE.md, else create AGENTS.md.\n  const candidates = [\"AGENTS.md\", \"CLAUDE.md\"].map((f) => join(dir, f));\n  const target = candidates.find((p) => existsSync(p)) ?? candidates[0]!;\n  const existingMd = existsSync(target) ? await readFile(target, \"utf8\") : null;\n  const md = patchAgentsMd(existingMd);\n  plans.push({ path: target, next: md.next, changed: md.changed, existing: existingMd, what: \"runtime-debugging rule for agents\" });\n\n  log(pc.bold(`Debug Anything init in ${dir} will:`));\n  for (const p of plans) log(`${pc.cyan(\"•\")} ${p.path} ${p.changed ? pc.dim(`(+ ${p.what})`) : pc.dim(\"(already set up)\")}`);\n  if (opts.dryRun) {\n    log(pc.dim(\"--dry-run: nothing written.\"));\n    return { written, skipped: plans.map((p) => p.path) };\n  }\n  for (const p of plans) {\n    if (!p.changed) {\n      skipped.push(p.path);\n      continue;\n    }\n    await mkdir(dirname(p.path), { recursive: true });\n    if (p.existing !== null) await copyFile(p.path, `${p.path}.bak-debuganything`);\n    await writeFile(p.path, p.next);\n    written.push(p.path);\n  }\n  log(`${pc.green(\"Done.\")} Commit these files so every teammate's agent gets Debug Anything. Each person still runs ${pc.bold(\"npx debuganything setup\")} once for the skill and hook.`);\n  return { written, skipped };\n}\n"],"mappings":"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","names":[]}

package/dist/target-WJE4WFYA.js

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+import {
+  containerIdFromCgroup,
+  descendantPids,
+  detectRuntime,
+  exePath,
+  guessKind,
+  listProcesses,
+  parsePs,
+  processInfo,
+  resolvePid,
+  resolveTarget,
+  spawnCommand,
+  splitArgs,
+  targetPids,
+  threadIds
+} from "./chunk-5RAKTYW5.js";
+import "./chunk-D742WJPT.js";
+import "./chunk-STFC7C5C.js";
+export {
+  containerIdFromCgroup,
+  descendantPids,
+  detectRuntime,
+  exePath,
+  guessKind,
+  listProcesses,
+  parsePs,
+  processInfo,
+  resolvePid,
+  resolveTarget,
+  spawnCommand,
+  splitArgs,
+  targetPids,
+  threadIds
+};
+//# sourceMappingURL=target-WJE4WFYA.js.map

package/dist/target-WJE4WFYA.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/gemini-extension.json

@@ -0,0 +1,9 @@
+{
+  "name": "debuganything",
+  "version": "0.3.0",
+  "description": "Debug Anything: observe any running process and get evidence-backed findings.",
+  "mcpServers": {
+    "debuganything": { "command": "npx", "args": ["-y", "debuganything@latest", "serve"] }
+  },
+  "contextFileName": "GEMINI.md"
+}

package/hooks/debuganything-hook.mjs

@@ -0,0 +1,36 @@
+#!/usr/bin/env node
+// Debug Anything proactive hook for Claude Code. Installed by `debuganything setup`; remove the hooks entries in
+// ~/.claude/settings.json (or run `debuganything setup --no-hooks`) to disable. Reads the hook event on stdin,
+// prints additional context when command output or the prompt shows a runtime-problem signal.
+const TRIGGERS = [{"id":"port_busy","pattern":"EADDRINUSE|address already in use|port (\\d+) is (already )?in use|bind\\(\\): Address already in use","flags":"i","scope":"both","hint":"run `debuganything port <port>` (or inspect_sockets) to see which pid holds the port; never kill it blindly"},{"id":"conn_refused","pattern":"ECONNREFUSED|connection refused|ECONNRESET|socket hang up|ETIMEDOUT|connect timed out|EHOSTUNREACH","flags":"i","scope":"output","hint":"attach Debug Anything to the client and run inspect_sockets / trace_syscalls (network) to see which remote fails and how"},{"id":"fd_exhaustion","pattern":"EMFILE|too many open files|ENFILE","flags":"i","scope":"both","hint":"attach Debug Anything and run inspect_files (fd growth, deleted-but-open) and inspect_sockets (CLOSE_WAIT pileups)"},{"id":"oom","pattern":"OOMKilled|Out of memory|oom-kill|exit(ed)? (code|status)[ =:]*137|Killed process \\d+|JavaScript heap out of memory|MemoryError|Cannot allocate memory","flags":"i","scope":"both","hint":"attach Debug Anything: container_info (OOM/limits) and snapshot_memory twice around load, then diff_runs to name the retainer"},{"id":"timeout","pattern":"timed? ?out after|Timeout - Async callback|Test timeout of|exceeded timeout|context deadline exceeded|TimeoutError","flags":"i","scope":"output","hint":"if the process under test is still running, attach Debug Anything and run dump_stacks (waiting on a lock? a socket?) before changing timeouts"},{"id":"hang_words","pattern":"\\b(hangs?|hanging|stuck|frozen|freezes|deadlock(ed)?|not responding|never (returns|finishes|completes))\\b","flags":"i","scope":"prompt","hint":"attach Debug Anything and run dump_stacks first — do not theorize about the hang from the code"},{"id":"slow_words","pattern":"\\b(slow|slower|latency|p99|p95|takes forever|sluggish|cpu (is )?(pegged|at 100)|100% cpu)\\b","flags":"i","scope":"prompt","hint":"attach Debug Anything and run profile_cpu then trace_syscalls (file,network) — measure before optimizing"},{"id":"leak_words","pattern":"\\b(memory (leak|keeps growing|grows|usage grows)|leaking|rss (grows|keeps)|heap (grows|keeps growing)|out of memory)\\b","flags":"i","scope":"prompt","hint":"attach Debug Anything, snapshot_memory, exercise the target, snapshot_memory again, diff_runs"},{"id":"crash_words","pattern":"\\b(crashed|crashes|keeps restarting|restart loop|CrashLoopBackOff|segfault|SIGSEGV|core dumped|exit code 1[34][0-9])\\b","flags":"i","scope":"both","hint":"attach Debug Anything to the container/pid and run container_info (exit code, OOM, restarts, log tail)"},{"id":"segv","pattern":"Segmentation fault|SIGSEGV|SIGABRT|SIGBUS|core dumped|fatal error: unexpected signal","flags":"i","scope":"output","hint":"if it restarted, attach Debug Anything and dump_stacks/profile_cpu to catch the lead-up; hand the symbol to a step debugger or a static-analysis tool"}];
+let raw = "";
+process.stdin.setEncoding("utf8");
+process.stdin.on("data", (c) => (raw += c));
+process.stdin.on("end", () => {
+  let ev;
+  try { ev = JSON.parse(raw); } catch { return; }
+  const event = ev.hook_event_name || "";
+  let text = "";
+  let scope = "output";
+  if (event === "UserPromptSubmit") { text = String(ev.prompt || ""); scope = "prompt"; }
+  else if (event === "PostToolUse") {
+    if (ev.tool_name !== "Bash") return;
+    const r = ev.tool_response || {};
+    text = [r.stdout, r.stderr, r.output, typeof r === "string" ? r : ""].filter(Boolean).join("\n");
+    const cmd = String((ev.tool_input || {}).command || "");
+    if (/\b(debuganything|debugany)\b/.test(cmd)) return; // don't nudge about Debug Anything's own output
+  } else return;
+  if (!text || text.length > 400000) return;
+  const hits = [];
+  for (const t of TRIGGERS) {
+    if (t.scope !== "both" && t.scope !== scope) continue;
+    const m = new RegExp(t.pattern, t.flags).exec(text);
+    if (m) hits.push({ id: t.id, hint: t.hint, match: m[0].slice(0, 80) });
+  }
+  if (!hits.length) return;
+  const where = scope === "output" ? "The last command's output" : "The user's message";
+  const lines = hits.slice(0, 3).map((h) => "- " + h.id + " (\u201c" + h.match + "\u201d): " + h.hint);
+  const additionalContext = ["[Debug Anything] " + where + " shows a runtime problem signal. Debug Anything is installed: observe before you theorize.", ...lines,
+    "Protocol: readiness (once per session) \u2192 attach <pid|container|command> \u2192 the tool above \u2192 detach. Cite evidence ids (e.g. dump_stacks#2/e3) in your answer; capture_traffic needs the user's consent. Skip this if the user explicitly said not to attach to anything."].join("\n");
+  process.stdout.write(JSON.stringify({ hookSpecificOutput: { hookEventName: event, additionalContext } }) + "\n");
+});

package/hooks/hooks.json

@@ -0,0 +1,10 @@
+{
+  "hooks": {
+    "PostToolUse": [
+      { "matcher": "Bash", "hooks": [{ "type": "command", "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/debuganything-hook.mjs\"", "timeout": 10 }] }
+    ],
+    "UserPromptSubmit": [
+      { "hooks": [{ "type": "command", "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/debuganything-hook.mjs\"", "timeout": 10 }] }
+    ]
+  }
+}

package/package.json

@@ -1,6 +1,88 @@
 {
   "name": "debuganything",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "mcpName": "io.github.shreyassaw5394/debuganything",
+  "version": "1.0.0",
+  "description": "Debug Anything: observe and diagnose any running process, container or pod from your agent with one CLI and MCP server. Evidence, not guesses.",
+  "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/shreyassaw5394/debuganything.git"
+  },
+  "homepage": "https://debuganything.dev",
+  "bugs": {
+    "url": "https://github.com/shreyassaw5394/debuganything/issues"
+  },
+  "keywords": [
+    "debugging",
+    "observability",
+    "profiling",
+    "strace",
+    "py-spy",
+    "perf",
+    "flamegraph",
+    "tcpdump",
+    "lsof",
+    "gdb",
+    "heap-snapshot",
+    "agents",
+    "agent-skills",
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "cli",
+    "debuganything"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "debuganything": "dist/cli.js",
+    "debugany": "dist/cli.js"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "files": [
+    "dist",
+    "skills",
+    "server.json",
+    "README.md",
+    "DISCLAIMER.md",
+    "LICENSE",
+    "assets/debuganything-mark-512.png",
+    "assets/debuganything-logo.png",
+    ".claude-plugin/plugin.json",
+    "hooks/hooks.json",
+    "hooks/debuganything-hook.mjs",
+    "gemini-extension.json",
+    "GEMINI.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsx src/cli.ts",
+    "serve": "tsx src/cli.ts serve",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "oxlint src tests",
+    "typecheck": "tsc --noEmit",
+    "check": "npm run typecheck && npm run lint && npm run test && npm run build",
+    "schemas": "tsx scripts/export-schemas.ts",
+    "prepublishOnly": "npm run check"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.32.1",
+    "commander": "^15.0.0",
+    "execa": "^10.1.1",
+    "picocolors": "^1.1.1",
+    "zod": "^4.6.7"
+  },
+  "devDependencies": {
+    "@types/node": "^26.6.5",
+    "oxlint": "^1.88.0",
+    "tsup": "^9.0.0",
+    "tsx": "^4.23.15",
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.5"
+  }
 }

package/server.json

@@ -0,0 +1,30 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-07-09/server.schema.json",
+  "name": "io.github.shreyassaw5394/debuganything",
+  "description": "Observe any running process from your agent. strace, py-spy, perf, lsof, tcpdump as evidence.",
+  "status": "active",
+  "repository": {
+    "url": "https://github.com/shreyassaw5394/debuganything",
+    "source": "github"
+  },
+  "version": "1.0.0",
+  "packages": [
+    {
+      "registryType": "npm",
+      "registryBaseUrl": "https://registry.npmjs.org",
+      "identifier": "debuganything",
+      "version": "1.0.0",
+      "runtimeHint": "npx",
+      "transport": {
+        "type": "stdio"
+      },
+      "packageArguments": [
+        {
+          "type": "positional",
+          "value": "serve"
+        }
+      ]
+    }
+  ],
+  "websiteUrl": "https://debuganything.dev"
+}

package/skills/debug-anything/SKILL.md

@@ -0,0 +1,102 @@
+---
+name: debug-anything
+description: Use when the user reports a bug that involves a running system (slow, hanging, leaking, crashing, port in use, weird network behavior) AND proactively, without being asked, whenever a command you ran hangs or times out, output shows EADDRINUSE / ECONNREFUSED / EMFILE / exit 137 / OOM / segfault, a server you started does not respond, or you just changed performance-sensitive code. Observe before you theorize.
+---
+
+# Debug Anything
+
+Debug Anything gives you eyes on running software: syscalls, CPU profiles, thread stacks,
+sockets, file descriptors, packets, heap retainers, container state. Every
+tool returns the same `ToolResult` with `findings` that cite `evidence` ids.
+You only get to claim what the evidence supports.
+
+## Use it without being asked
+
+You are equipped with Debug Anything. Reach for it on your own when you see any of these;
+do not wait for the user to say "debug this" and do not ask permission for
+read-only observation (only `capture_traffic` needs consent):
+
+| Signal | First move |
+|---|---|
+| A command you ran hangs, or a test times out and the process is still alive | `attach` it, `dump_stacks` |
+| `EADDRINUSE` / "port already in use" | `debuganything port <n>` or `inspect_sockets`; report the pid, do not kill it |
+| `ECONNREFUSED`, `ETIMEDOUT`, `socket hang up` | `inspect_sockets`, `trace_syscalls` (network) on the client |
+| `EMFILE` / too many open files | `inspect_files` (growth, deleted-but-open), `inspect_sockets` (CLOSE_WAIT) |
+| exit 137, `OOMKilled`, "JavaScript heap out of memory" | `container_info`, then `snapshot_memory` ×2 + `diff_runs` |
+| Segfault / exit 139 / crash loop | `container_info`; if it restarted, `dump_stacks` + `profile_cpu` to catch the lead-up |
+| The user says slow / p99 / CPU pegged | `profile_cpu`, then `trace_syscalls` (file,network) |
+| The user says hang / stuck / frozen / deadlock | `dump_stacks` twice |
+| The user says leak / memory keeps growing | `snapshot_memory`, load, `snapshot_memory`, `diff_runs` |
+| You started a long-running service to test something | consider `attach --kind command` so its output and fds are captured from the start |
+| You just changed performance-sensitive code | measure before and after with the same tool and `diff_runs`; put the evidence ids in the PR |
+
+Keep it proportionate: `readiness` once per session, `attach`, one or two
+tools, `detach`. Only attach to processes that belong to the user's project or
+that they pointed you at. Say what you observed and what you could not
+(`limitations`) in one short paragraph with evidence ids.
+
+## Session protocol
+
+1. **Always call `readiness` first** in a session. Read `tools_available` and
+   `tools_unavailable`; do not call tools that are unavailable, tell the user
+   what is missing and the install hint instead.
+2. **Always `attach` before any other tool.** Pass a pid, container name, pod
+   (`namespace/name`) or a command (`kind: "command"` spawns it under
+   capture). Use the returned `session_id` for everything.
+3. **Always `detach` at the end.** It stops captures and writes the report.
+4. Prefer each result's `suggested_next`. Stop when the evidence answers the
+   question.
+
+## Investigation orders
+
+**Slow** (`dea_slow`): `profile_cpu` → `trace_syscalls` (network,file) →
+`inspect_sockets` → `report`. CPU-bound if a few frames dominate self time;
+otherwise look at blocked syscalls and remote hosts.
+
+**Leak** (`dea_leak`): `snapshot_memory` → exercise the target → `snapshot_memory`
+→ `diff_runs a=snapshot_memory#1 b=snapshot_memory#2` → `report`. The top
+grower in retained size is the suspect. RSS up without heap up → native memory.
+
+**Hang** (`dea_hang`): `dump_stacks` → `inspect_sockets` → `trace_syscalls`
+(5 s) → `report`. Two threads each waiting on the other's lock = deadlock
+(look for `lock_wait` evidence). One thread in a socket read = waiting on a
+remote.
+
+**Crash** (`dea_crash`): `container_info` (OOMKilled, exit code, restarts,
+cgroup limits, log tail) → `report`. Exit 137 = SIGKILL (often OOM),
+139 = SIGSEGV, 143 = SIGTERM.
+
+**Port busy** (`dea_port_busy`): CLI `debuganything port <port>` or `attach` candidates
+and `inspect_sockets`; report pid + command line. Never kill it yourself.
+
+## Evidence rules
+
+- **Never state a root cause without citing an evidence id** from a tool
+  result, e.g. "readFileSync dominates CPU (profile_cpu#1/e2)".
+- Phrase unsupported ideas as hypotheses and name the tool that would test
+  them: "Hypothesis: downstream latency. Test: trace_syscalls network."
+- Respect `confidence`: "observed" is read from tool output; "inferred" is a
+  reasoning step — say which is which.
+- Read `limitations`. "sampled 10 s", "no symbols", "ran without root" change
+  what you may conclude.
+
+## Consent and safety
+
+- `capture_traffic` requires `consent: true`. **Ask the user before passing
+  it.** Packet captures can contain secrets.
+- Debug Anything is read-only and never escalates privileges. If a tool returns
+  `ok: false` with a sudo command in `limitations`, show the user that command;
+  do not try to run it yourself.
+- Payloads are redacted; raw artifacts under `~/.debuganything/sessions/` are not.
+
+## After a fix
+
+Re-run the same measuring tool and call `diff_runs` on the before/after run
+ids to prove the fix. Put the diff's evidence ids in your summary.
+
+## Handoffs
+
+- **Step debugger.** When Debug Anything localizes a problem to a function or thread,
+  suggest attaching a step debugger (e.g. mcp-debugger) at `<file:function>`.
+  Debug Anything tells you where to look; a step debugger lets you look inside.
+- **Static analysis.** When Debug Anything names a native symbol, shared library or binary you cannot read (a hot frame in `libfoo.so`, a thread parked in `pthread_mutex_lock` under `worker_b`), hand that symbol to a decompiler / static-analysis tool to see what it does; cite Debug Anything's evidence for the runtime facts and the static tool's for the code facts.