tracebug 1.5.0 → 1.7.0

package/README.md

@@ -1,37 +1,37 @@
-# tracebug
-
-The TraceBug CLI — a **local MCP server** that lets AI coding agents debug [TraceBug](https://github.com/prashantsinghmangat/tracebug-ai) bug-report exports, plus one-command framework setup.
-
-Zero dependencies. ~24 KB. Node ≥ 18.
-
-## MCP server
-
-Connect Claude Code, Cursor, Windsurf, or VS Code to the `.html` bug reports the [TraceBug Chrome extension](https://chromewebstore.google.com/detail/fdemmibikigigkfjngclmdheeajhdgaj) exports:
-
-```bash
-claude mcp add tracebug -- npx -y tracebug mcp --dir ./bug-reports
-```
-
-The agent gets six read tools — `list_bug_reports`, `get_bug_report` (with a prioritized investigation guide), `get_console_errors`, `get_network_activity`, `get_repro_steps`, `get_screenshot` — and a `/tracebug:debug_bug_report` prompt.
-
-**Everything stays on your machine.** The server binds to stdio only, opens zero network connections, and reads the report files from your disk. No account, no cloud, no upload.
-
-Full guide: [tracebug.netlify.app/docs/mcp](https://tracebug.netlify.app/docs/mcp)
-
-## Project setup
-
-```bash
-npx tracebug init
-```
-
-Detects your framework (React, Next.js, Vue, Angular, Svelte, Nuxt, vanilla) and prints the setup snippet for the [`tracebug-sdk`](https://www.npmjs.com/package/tracebug-sdk) — the embeddable capture SDK.
-
-## Related packages
-
-| Package | What it is |
-|---|---|
-| [`tracebug`](https://www.npmjs.com/package/tracebug) (this one) | CLI: MCP server + `init`. For developers *receiving* bug reports. |
-| [`tracebug-sdk`](https://www.npmjs.com/package/tracebug-sdk) | The full SDK for embedding capture in your app. Includes this CLI too. |
-| [Chrome extension](https://chromewebstore.google.com/detail/fdemmibikigigkfjngclmdheeajhdgaj) | Zero-code capture for QA/testers on any website. |
-
-MIT © Prashant Singh Mangat
+# tracebug
+
+The TraceBug CLI — a **local MCP server** that lets AI coding agents debug [TraceBug](https://github.com/prashantsinghmangat/tracebug-ai) bug-report exports, plus one-command framework setup.
+
+Zero dependencies. ~24 KB. Node ≥ 18.
+
+## MCP server
+
+Connect Claude Code, Cursor, Windsurf, or VS Code to the `.html` bug reports the [TraceBug Chrome extension](https://chromewebstore.google.com/detail/fdemmibikigigkfjngclmdheeajhdgaj) exports:
+
+```bash
+claude mcp add tracebug -- npx -y tracebug mcp --dir ./bug-reports
+```
+
+The agent gets six read tools — `list_bug_reports`, `get_bug_report` (with a prioritized investigation guide), `get_console_errors`, `get_network_activity`, `get_repro_steps`, `get_screenshot` — and a `/tracebug:debug_bug_report` prompt.
+
+**Everything stays on your machine.** The server binds to stdio only, opens zero network connections, and reads the report files from your disk. No account, no cloud, no upload.
+
+Full guide: [tracebug.dev/docs/mcp](https://tracebug.dev/docs/mcp)
+
+## Project setup
+
+```bash
+npx tracebug init
+```
+
+Detects your framework (React, Next.js, Vue, Angular, Svelte, Nuxt, vanilla) and prints the setup snippet for the [`tracebug-sdk`](https://www.npmjs.com/package/tracebug-sdk) — the embeddable capture SDK.
+
+## Related packages
+
+| Package | What it is |
+|---|---|
+| [`tracebug`](https://www.npmjs.com/package/tracebug) (this one) | CLI: MCP server + `init`. For developers *receiving* bug reports. |
+| [`tracebug-sdk`](https://www.npmjs.com/package/tracebug-sdk) | The full SDK for embedding capture in your app. Includes this CLI too. |
+| [Chrome extension](https://chromewebstore.google.com/detail/fdemmibikigigkfjngclmdheeajhdgaj) | Zero-code capture for QA/testers on any website. |
+
+MIT © Prashant Singh Mangat

package/bin.mjs

@@ -17,7 +17,9 @@ __export(mcp_server_exports, {
   buildDebugPrompt: () => buildDebugPrompt,
   buildInvestigationGuide: () => buildInvestigationGuide,
   callTool: () => callTool,
+  collectReports: () => collectReports,
   handleMessage: () => handleMessage,
+  knownReportDirs: () => knownReportDirs,
   parseReportFile: () => parseReportFile,
   runMcpServer: () => runMcpServer,
   scanReportFiles: () => scanReportFiles,
@@ -30,6 +32,7 @@ __export(mcp_server_exports, {
 });
 import * as fs from "fs";
 import * as path from "path";
+import * as os from "os";
 function parseReportFile(filePath) {
   let raw;
   try {
@@ -56,8 +59,9 @@ function parseReportFile(filePath) {
 function isReportPayload(p) {
   return typeof p === "object" && p !== null && typeof p.meta === "object" && p.meta !== null && typeof p.meta.title === "string" && typeof p.meta.sessionId === "string";
 }
-function scanReportFiles(dir, depth = 0) {
-  if (depth > MAX_SCAN_DEPTH) return [];
+function scanReportFiles(dir, depth = 0, opts = {}) {
+  const maxDepth = opts.maxDepth ?? MAX_SCAN_DEPTH;
+  if (depth > maxDepth) return [];
   let entries;
   try {
     entries = fs.readdirSync(dir, { withFileTypes: true });
@@ -69,19 +73,69 @@ function scanReportFiles(dir, depth = 0) {
     const full = path.join(dir, entry.name);
     if (entry.isDirectory()) {
       if (!SKIP_DIRS.has(entry.name) && !entry.name.startsWith(".")) {
-        found.push(...scanReportFiles(full, depth + 1));
+        found.push(...scanReportFiles(full, depth + 1, opts));
       }
     } else if (entry.name.endsWith(".html") || entry.name.endsWith(".json")) {
+      if (opts.nameFilter && !opts.nameFilter(entry.name)) continue;
       if (parseReportFile(full) !== null) found.push(full);
     }
   }
   return found;
 }
+function knownReportDirs(baseDir) {
+  const raw = [baseDir, process.cwd()];
+  try {
+    const home = os.homedir();
+    raw.push(path.join(home, "Downloads"), path.join(home, "Desktop"));
+  } catch {
+  }
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  for (const d of raw) {
+    let key;
+    try {
+      key = path.resolve(d);
+    } catch {
+      continue;
+    }
+    if (seen.has(key)) continue;
+    seen.add(key);
+    try {
+      if (fs.statSync(d).isDirectory()) out.push(d);
+    } catch {
+    }
+  }
+  return out;
+}
+function collectReports(baseDir) {
+  const seen = /* @__PURE__ */ new Set();
+  const out = [];
+  const add = (f) => {
+    const key = path.resolve(f);
+    if (!seen.has(key)) {
+      seen.add(key);
+      out.push(f);
+    }
+  };
+  for (const f of scanReportFiles(baseDir)) add(f);
+  const baseKey = path.resolve(baseDir);
+  for (const dir of knownReportDirs(baseDir)) {
+    if (path.resolve(dir) === baseKey) continue;
+    for (const f of scanReportFiles(dir, 0, { maxDepth: 1, nameFilter: (n) => TB_EXPORT_NAME_RE.test(n) })) add(f);
+  }
+  return out;
+}
+function displayReportName(baseDir, file) {
+  const rel = path.relative(baseDir, file);
+  return rel && !rel.startsWith("..") && !path.isAbsolute(rel) ? rel : path.basename(file);
+}
 function requireReport(baseDir, file) {
-  const direct = path.isAbsolute(file) ? file : path.join(baseDir, file);
-  const directPayload = parseReportFile(direct);
-  if (directPayload) return { payload: directPayload, resolved: direct };
-  const candidates = scanReportFiles(baseDir);
+  const directCandidates = path.isAbsolute(file) ? [file] : [path.join(baseDir, file), path.resolve(process.cwd(), file)];
+  for (const direct of directCandidates) {
+    const p = parseReportFile(direct);
+    if (p) return { payload: p, resolved: direct };
+  }
+  const candidates = collectReports(baseDir);
   const query = file.toLowerCase();
   let match = candidates.find((c) => path.basename(c).toLowerCase() === query);
   if (!match) {
@@ -92,9 +146,9 @@ function requireReport(baseDir, file) {
     });
   }
   if (match) return { payload: parseReportFile(match), resolved: match };
-  const available = candidates.map((c) => path.relative(baseDir, c) || c);
+  const available = candidates.map((c) => displayReportName(baseDir, c));
   throw new Error(
-    `Not a TraceBug export: ${file}. ` + (available.length ? `Available reports: ${available.join(", ")}` : `No reports found under ${baseDir} \u2014 check the server's --dir.`)
+    `Not a TraceBug export: ${file}. ` + (available.length ? `Available reports: ${available.join(", ")}` : `No reports found under ${baseDir}, Downloads, or Desktop \u2014 pass an absolute path, or point the server's --dir at your reports folder.`)
   );
 }
 function buildInvestigationGuide(p) {
@@ -131,11 +185,11 @@ function buildInvestigationGuide(p) {
 }
 function toolListBugReports(baseDir, args2) {
   const scanDir = args2.dir ? path.isAbsolute(args2.dir) ? args2.dir : path.join(baseDir, args2.dir) : baseDir;
-  const files = scanReportFiles(scanDir);
+  const files = args2.dir ? scanReportFiles(scanDir) : AUTO_DISCOVER ? collectReports(baseDir) : scanReportFiles(baseDir);
   const reports = files.map((file) => {
     const p = parseReportFile(file);
     return {
-      file: path.relative(baseDir, file) || file,
+      file: displayReportName(baseDir, file),
       title: p.meta.title,
       summary: p.meta.summary,
       severity: p.meta.severity,
@@ -154,7 +208,7 @@ function toolListBugReports(baseDir, args2) {
   });
   return {
     count: reports.length,
-    scannedDir: scanDir,
+    scannedDir: args2.dir ? scanDir : AUTO_DISCOVER ? knownReportDirs(baseDir).join(", ") : baseDir,
     reports,
     ...reports.length ? { nextStep: "Call get_bug_report on a file for the full overview plus a prioritized investigation guide." } : {}
   };
@@ -338,11 +392,13 @@ function handleMessage(baseDir, msg) {
 function reply(id, result) {
   return { jsonrpc: "2.0", id: id ?? null, result };
 }
-function runMcpServer(baseDir, version) {
+function runMcpServer(baseDir, version, autoDiscover = false) {
   SERVER_VERSION = version;
-  process.stderr.write(`TraceBug MCP server \u2014 reading bug reports from ${baseDir}
-`);
-  return new Promise((resolve) => {
+  AUTO_DISCOVER = autoDiscover;
+  process.stderr.write(
+    `TraceBug MCP server \u2014 reading bug reports from ${baseDir}` + (autoDiscover ? " (+ Downloads/Desktop auto-discovery)" : "") + "\n"
+  );
+  return new Promise((resolve2) => {
     let buffer = "";
     process.stdin.setEncoding("utf8");
     process.stdin.on("data", (chunk) => {
@@ -365,16 +421,17 @@ function runMcpServer(baseDir, version) {
         if (response) process.stdout.write(JSON.stringify(response) + "\n");
       }
     });
-    process.stdin.on("end", () => resolve());
+    process.stdin.on("end", () => resolve2());
   });
 }
-var TB_DATA_RE, MAX_SCAN_DEPTH, SKIP_DIRS, FILE_PROP, TOOL_DEFINITIONS, PROMPT_DEFINITIONS, SERVER_VERSION;
+var TB_DATA_RE, MAX_SCAN_DEPTH, SKIP_DIRS, TB_EXPORT_NAME_RE, FILE_PROP, TOOL_DEFINITIONS, PROMPT_DEFINITIONS, SERVER_VERSION, AUTO_DISCOVER;
 var init_mcp_server = __esm({
   "cli/mcp-server.ts"() {
     "use strict";
     TB_DATA_RE = /<script id="tb-data" type="application\/json">([\s\S]*?)<\/script>/;
     MAX_SCAN_DEPTH = 3;
     SKIP_DIRS = /* @__PURE__ */ new Set(["node_modules", ".git", ".next", "dist", "build", "coverage", "out"]);
+    TB_EXPORT_NAME_RE = /^tracebug[-.]/i;
     FILE_PROP = {
       file: {
         type: "string",
@@ -446,6 +503,7 @@ var init_mcp_server = __esm({
       }
     ];
     SERVER_VERSION = "0.0.0";
+    AUTO_DISCOVER = false;
   }
 });
 
@@ -455,6 +513,7 @@ var command = args[0];
 var BOLD = "\x1B[1m";
 var CYAN = "\x1B[36m";
 var GREEN = "\x1B[32m";
+var YELLOW = "\x1B[33m";
 var DIM = "\x1B[2m";
 var RESET = "\x1B[0m";
 async function main() {
@@ -477,7 +536,8 @@ async function startMcpServer() {
   const fs2 = await import("fs");
   const path2 = await import("path");
   const dirFlag = args.indexOf("--dir");
-  const baseDir = dirFlag !== -1 && args[dirFlag + 1] ? path2.resolve(args[dirFlag + 1]) : process.cwd();
+  const hasExplicitDir = dirFlag !== -1 && !!args[dirFlag + 1];
+  const baseDir = hasExplicitDir ? path2.resolve(args[dirFlag + 1]) : process.cwd();
   let version = "0.0.0";
   for (const rel of ["./package.json", "../package.json"]) {
     try {
@@ -489,14 +549,14 @@ async function startMcpServer() {
     } catch {
     }
   }
-  await runMcpServer2(baseDir, version);
+  await runMcpServer2(baseDir, version, !hasExplicitDir);
 }
 function printHelp() {
   console.log(`
 ${BOLD}TraceBug CLI${RESET} \u2014 Debug bugs in seconds, not hours
 
 ${BOLD}Commands:${RESET}
-  ${CYAN}init${RESET}    Set up TraceBug in your project
+  ${CYAN}init${RESET}    Print the exact TraceBug setup for your framework (incl. the gotcha)
   ${CYAN}mcp${RESET}     Start the MCP server so AI agents (Claude Code, Cursor) can read
           exported bug reports. Options: ${DIM}--dir <path>${RESET} (default: current dir)
   ${CYAN}help${RESET}    Show this help message
@@ -509,12 +569,14 @@ ${BOLD}Docs:${RESET} https://tracebug.dev/docs
 `);
 }
 async function initProject() {
-  console.log(`
-${BOLD}${CYAN}TraceBug${RESET} \u2014 Setting up bug reporting
-`);
   const fs2 = await import("fs");
   const path2 = await import("path");
   const cwd = process.cwd();
+  const projectId = path2.basename(cwd) || "my-app";
+  console.log(`
+${BOLD}${CYAN}TraceBug${RESET} \u2014 the exact setup for your framework`);
+  console.log(`${DIM}(this prints the right snippet \u2014 it doesn't install or edit any files)${RESET}
+`);
   let framework = "vanilla";
   const pkgPath = path2.join(cwd, "package.json");
   if (fs2.existsSync(pkgPath)) {
@@ -523,69 +585,101 @@ ${BOLD}${CYAN}TraceBug${RESET} \u2014 Setting up bug reporting
       const deps = { ...pkg.dependencies, ...pkg.devDependencies };
       if (deps["next"]) framework = "nextjs";
       else if (deps["nuxt"]) framework = "nuxt";
-      else if (deps["vue"]) framework = "vue";
       else if (deps["@angular/core"]) framework = "angular";
       else if (deps["svelte"]) framework = "svelte";
+      else if (deps["vue"]) framework = "vue";
       else if (deps["react"]) framework = "react";
     } catch {
     }
   }
-  console.log(`  Detected framework: ${GREEN}${framework}${RESET}`);
-  const snippets = {
-    nextjs: `// app/tracebug.tsx (create this file)
+  const guides = {
+    nextjs: {
+      snippet: `// 1 \u2014 create app/tracebug.tsx
 "use client";
 import { useEffect } from "react";
 
 export default function TraceBugInit() {
   useEffect(() => {
-    import("tracebug-sdk").then(({ default: TraceBug }) => {
-      TraceBug.init({ projectId: "${path2.basename(cwd)}" });
-    });
+    import("tracebug-sdk").then(({ default: TraceBug }) =>
+      TraceBug.init({ projectId: "${projectId}", enabled: "auto" })
+    );
   }, []);
   return null;
 }
 
-// Then add <TraceBugInit /> to your root layout.tsx`,
-    react: `// src/main.tsx (add to your entry file)
-import TraceBug from "tracebug-sdk";
-TraceBug.init({ projectId: "${path2.basename(cwd)}" });`,
-    vue: `// main.ts (add to your entry file)
+// 2 \u2014 mount it once inside <body> in app/layout.tsx:  <TraceBugInit />`,
+      gotcha: `App Router components run on the server by default, but TraceBug is
+  browser-only. It must live in a Client Component ("use client") and fire from
+  useEffect \u2014 calling init() in a server component silently does nothing.`
+    },
+    nuxt: {
+      snippet: `// plugins/tracebug.client.ts   (the .client suffix is required)
 import TraceBug from "tracebug-sdk";
-TraceBug.init({ projectId: "${path2.basename(cwd)}" });`,
-    svelte: `<!-- +layout.svelte (add to your root layout) -->
+
+export default defineNuxtPlugin(() => {
+  TraceBug.init({ projectId: "${projectId}", enabled: "auto" });
+});`,
+      gotcha: `The ".client.ts" filename is what keeps TraceBug out of the SSR
+  bundle \u2014 a plain tracebug.ts would try to run during server render and crash.`
+    },
+    svelte: {
+      snippet: `<!-- src/routes/+layout.svelte -->
 <script>
-  import { onMount } from 'svelte';
-  import TraceBug from 'tracebug-sdk';
-  onMount(() => TraceBug.init({ projectId: "${path2.basename(cwd)}" }));
+  import { onMount } from "svelte";
+  import TraceBug from "tracebug-sdk";
+  onMount(() => TraceBug.init({ projectId: "${projectId}", enabled: "auto" }));
 </script>`,
-    angular: `// app.component.ts (add to constructor or ngOnInit)
+      gotcha: `Use onMount \u2014 it only runs in the browser, keeping TraceBug out of
+  SvelteKit's SSR pass. A top-level init() call would break the server render.`
+    },
+    react: {
+      snippet: `// src/main.tsx  (your app entry file)
 import TraceBug from "tracebug-sdk";
-TraceBug.init({ projectId: "${path2.basename(cwd)}" });`,
-    vanilla: `<!-- Add before </body> -->
+
+TraceBug.init({ projectId: "${projectId}", enabled: "auto" });`
+    },
+    vue: {
+      snippet: `// src/main.ts  (your app entry file)
+import TraceBug from "tracebug-sdk";
+
+TraceBug.init({ projectId: "${projectId}", enabled: "auto" });`
+    },
+    angular: {
+      snippet: `// src/main.ts  (before bootstrapApplication / bootstrapModule)
+import TraceBug from "tracebug-sdk";
+
+TraceBug.init({ projectId: "${projectId}", enabled: "auto" });`
+    },
+    vanilla: {
+      snippet: `<!-- add before </body> -->
 <script type="module">
   import TraceBug from "tracebug-sdk";
-  TraceBug.init({ projectId: "${path2.basename(cwd)}" });
-</script>`,
-    nuxt: `// plugins/tracebug.client.ts (create this file)
-import TraceBug from "tracebug-sdk";
-export default defineNuxtPlugin(() => {
-  TraceBug.init({ projectId: "${path2.basename(cwd)}" });
-});`
+  TraceBug.init({ projectId: "${projectId}", enabled: "auto" });
+</script>`
+    }
   };
-  console.log(`
-${BOLD}Add this to your project:${RESET}
+  const guide = guides[framework];
+  console.log(`  Detected framework: ${GREEN}${framework}${RESET}
 `);
-  console.log(`${DIM}\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500${RESET}`);
-  console.log(snippets[framework]);
-  console.log(`${DIM}\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500${RESET}`);
-  console.log(`
-${BOLD}Next steps:${RESET}
-  1. Install the SDK:  ${CYAN}npm install tracebug-sdk${RESET}
-  2. Add the snippet above to your app
-  3. Run your dev server and interact with your app
-  4. Click the TraceBug toolbar to see captured sessions
-
-${GREEN}Done!${RESET} TraceBug is ready. Happy debugging.
+  console.log(`${BOLD}1. Install the SDK${RESET}`);
+  console.log(`   ${CYAN}npm install tracebug-sdk${RESET}
+`);
+  console.log(`${BOLD}2. Add this yourself${RESET}`);
+  console.log(`${DIM}\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500${RESET}`);
+  console.log(guide.snippet);
+  console.log(`${DIM}\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500${RESET}
+`);
+  if (guide.gotcha) {
+    console.log(`${YELLOW}${BOLD}\u26A0 Heads up (${framework}):${RESET}${YELLOW} ${guide.gotcha}${RESET}
+`);
+  }
+  console.log(`${DIM}  enabled: "auto" loads TraceBug in dev & staging only \u2014 it never ships
+  to your production users. Set enabled: true to force it on.${RESET}
+`);
+  console.log(`${BOLD}3. Run your app${RESET}, reproduce a bug, then click ${BOLD}Export .html${RESET} on the toolbar.
+`);
+  console.log(`${DIM}Hand the exported report to your AI agent:${RESET}  ${CYAN}npx tracebug mcp${RESET}`);
+  console.log(`${DIM}Full guide:${RESET}  https://tracebug.dev/docs/getting-started
 `);
 }
 main().catch(console.error);

package/package.json

@@ -1,43 +1,43 @@
-{
-  "name": "tracebug",
-  "version": "1.5.0",
-  "description": "TraceBug CLI — local MCP server that lets AI coding agents (Claude Code, Cursor, VS Code) debug TraceBug bug-report exports, plus framework setup via `tracebug init`. Zero dependencies.",
-  "type": "module",
-  "bin": {
-    "tracebug": "./bin.mjs"
-  },
-  "files": [
-    "bin.mjs",
-    "README.md"
-  ],
-  "engines": {
-    "node": ">=18"
-  },
-  "scripts": {
-    "prepublishOnly": "node -e \"if(!require('fs').existsSync('bin.mjs')){console.error('bin.mjs missing - run: npm run build:cli (from the repo root)');process.exit(1)}\""
-  },
-  "keywords": [
-    "mcp",
-    "model-context-protocol",
-    "bug-reporting",
-    "debugging",
-    "claude-code",
-    "cursor",
-    "ai-agents",
-    "tracebug"
-  ],
-  "author": {
-    "name": "Prashant Singh Mangat",
-    "url": "https://github.com/prashantsinghmangat"
-  },
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/prashantsinghmangat/tracebug-ai.git",
-    "directory": "packages/tracebug"
-  },
-  "homepage": "https://tracebug.netlify.app/docs/mcp",
-  "bugs": {
-    "url": "https://github.com/prashantsinghmangat/tracebug-ai/issues"
-  }
-}
+{
+  "name": "tracebug",
+  "version": "1.7.0",
+  "description": "TraceBug CLI — local MCP server that lets AI coding agents (Claude Code, Cursor, VS Code) debug TraceBug bug-report exports, plus framework setup via `tracebug init`. Zero dependencies.",
+  "type": "module",
+  "bin": {
+    "tracebug": "./bin.mjs"
+  },
+  "files": [
+    "bin.mjs",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "prepublishOnly": "node -e \"if(!require('fs').existsSync('bin.mjs')){console.error('bin.mjs missing - run: npm run build:cli (from the repo root)');process.exit(1)}\""
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "bug-reporting",
+    "debugging",
+    "claude-code",
+    "cursor",
+    "ai-agents",
+    "tracebug"
+  ],
+  "author": {
+    "name": "Prashant Singh Mangat",
+    "url": "https://github.com/prashantsinghmangat"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/prashantsinghmangat/tracebug-ai.git",
+    "directory": "packages/tracebug"
+  },
+  "homepage": "https://tracebug.dev/docs/mcp",
+  "bugs": {
+    "url": "https://github.com/prashantsinghmangat/tracebug-ai/issues"
+  }
+}