memtrace 0.1.25 → 0.1.27

package/README.md

@@ -233,6 +233,19 @@ Skills and plugins are shared between Claude Code and Claude Desktop — both ac
 }
 ```
 
+### Uninstall
+
+```bash
+memtrace uninstall              # removes skills, MCP server, plugin, and settings
+npm uninstall -g memtrace       # removes the binary
+```
+
+Already ran `npm uninstall` first? The cleanup script is persisted at `~/.memtrace/uninstall.js`:
+
+```bash
+node ~/.memtrace/uninstall.js
+```
+
 ## Languages
 
 Rust · Go · TypeScript · JavaScript · Python · Java · C · C++ · C# · Swift · Kotlin · Ruby · PHP · Dart · Scala · Perl — and more via Tree-sitter.

package/bin/memtrace.js

@@ -4,6 +4,45 @@
 const { spawnSync } = require("child_process");
 const { getBinaryPath } = require("../install.js");
 
+// ── Handle `memtrace uninstall` before delegating to the Rust binary ────────
+// npm v7+ does NOT fire preuninstall hooks for global packages (npm/cli#3042).
+// This command provides reliable cleanup users can run before `npm uninstall -g`.
+
+const args = process.argv.slice(2);
+
+if (args[0] === "uninstall" || args[0] === "cleanup") {
+  const path = require("path");
+  const os = require("os");
+
+  // Try the bundled script first, then the persisted copy in ~/.memtrace/
+  const candidates = [
+    path.join(__dirname, "..", "uninstall.js"),
+    path.join(os.homedir(), ".memtrace", "uninstall.js"),
+  ];
+
+  let ran = false;
+  for (const p of candidates) {
+    try {
+      require(p);
+      ran = true;
+      break;
+    } catch (e) {
+      // try next candidate
+    }
+  }
+
+  if (!ran) {
+    console.error("memtrace: could not find uninstall script");
+    process.exit(1);
+  }
+
+  console.log("");
+  console.log("Now run: npm uninstall -g memtrace");
+  process.exit(0);
+}
+
+// ── Delegate everything else to the Rust binary ─────────────────────────────
+
 let binaryPath;
 try {
   binaryPath = getBinaryPath();
@@ -12,7 +51,7 @@ try {
   process.exit(1);
 }
 
-const result = spawnSync(binaryPath, process.argv.slice(2), {
+const result = spawnSync(binaryPath, args, {
   stdio: "inherit",
   env: process.env,
 });

package/install.js

@@ -231,6 +231,19 @@ if (require.main === module) {
       console.warn(`memtrace: MCP server registration failed: ${e.message}`);
     }
   }
+
+  // 5. Persist uninstall script to ~/.memtrace/ so it survives `npm uninstall -g`
+  //    (npm v7+ does NOT fire preuninstall hooks for global packages — npm/cli#3042)
+  try {
+    const memtraceDir = path.join(os.homedir(), ".memtrace");
+    fs.mkdirSync(memtraceDir, { recursive: true });
+    const src = path.join(__dirname, "uninstall.js");
+    const dest = path.join(memtraceDir, "uninstall.js");
+    fs.copyFileSync(src, dest);
+    console.log(`memtrace: persisted uninstall script to ${dest}`);
+  } catch (e) {
+    console.warn(`memtrace: failed to persist uninstall script: ${e.message}`);
+  }
 }
 
 module.exports = { getBinaryPath };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memtrace",
-  "version": "0.1.25",
+  "version": "0.1.27",
   "description": "Code intelligence graph — MCP server + AI agent skills + visualization UI",
   "keywords": [
     "mcp",

package/uninstall.js

@@ -138,9 +138,9 @@ function tryClaudeCliUninstall() {
   }
 }
 
-// ── Main preuninstall ───────────────────────────────────────────────────────
+// ── Main uninstall logic ───────────────────────────────────────────────────
 
-if (require.main === module) {
+function run() {
   console.log("memtrace: cleaning up...");
 
   // 1. Remove skills
@@ -171,5 +171,24 @@ if (require.main === module) {
     console.warn(`memtrace: MCP server removal failed: ${e.message}`);
   }
 
+  // 5. Clean up ~/.memtrace/ (the persisted uninstall script itself)
+  try {
+    const memtraceDir = path.join(os.homedir(), ".memtrace");
+    if (fs.existsSync(memtraceDir)) {
+      fs.rmSync(memtraceDir, { recursive: true, force: true });
+      console.log("memtrace: removed ~/.memtrace/");
+    }
+  } catch (e) {
+    console.warn(`memtrace: failed to remove ~/.memtrace/: ${e.message}`);
+  }
+
   console.log("memtrace: uninstall complete");
 }
+
+// Run when called directly (npm preuninstall hook) or when require()'d
+if (require.main === module) {
+  run();
+} else {
+  // Called via `memtrace uninstall` — run immediately
+  run();
+}