memtrace 0.1.24 → 0.1.26

package/README.md

@@ -15,6 +15,8 @@
   <a href="https://memtrace.dev"><img src="https://img.shields.io/badge/docs-memtrace.dev-00D4B8?style=flat-square" alt="docs" /></a>
 </p>
 
+> **Early Access** — Memtrace is under active development. Core indexing and structural search are stable. Temporal features (evolution scoring, timeline replay) are functional but may have rough edges. [Report issues here.](https://github.com/syncable-dev/memtrace-public/issues)
+
 ---
 
 Memtrace gives coding agents something they've never had: **structural memory**. Not vector similarity. Not semantic chunking. A real knowledge graph compiled from your codebase's AST — where every function, class, interface, and API endpoint exists as a node with deterministic, typed relationships.
@@ -56,35 +58,19 @@ All benchmarks run on the same machine, same codebase, same queries. No cherry-p
 
 ### Does it find the right thing?
 
-<picture>
-  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/syncable-dev/memtrace-public/main/assets/benchmarks/search-accuracy.svg"/>
-  <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/syncable-dev/memtrace-public/main/assets/benchmarks/search-accuracy.svg"/>
-  <img alt="Search accuracy: Memtrace 83.5% vs Vector RAG 25.8%" src="https://raw.githubusercontent.com/syncable-dev/memtrace-public/main/assets/benchmarks/search-accuracy.svg" width="720"/>
-</picture>
+<img alt="Search accuracy: Memtrace 83.5% vs Vector RAG 25.8%" src="https://raw.githubusercontent.com/syncable-dev/memtrace-public/main/assets/benchmarks/search-accuracy.svg" width="720"/>
 
 ### How fast?
 
-<picture>
-  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/syncable-dev/memtrace-public/main/assets/benchmarks/search-latency.svg"/>
-  <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/syncable-dev/memtrace-public/main/assets/benchmarks/search-latency.svg"/>
-  <img alt="Search latency: Memtrace 4.6ms vs GitNexus 220ms vs CodeGrapher 466.7ms" src="https://raw.githubusercontent.com/syncable-dev/memtrace-public/main/assets/benchmarks/search-latency.svg" width="720"/>
-</picture>
+<img alt="Search latency: Memtrace 4.6ms vs GitNexus 220ms vs CodeGrapher 466.7ms" src="https://raw.githubusercontent.com/syncable-dev/memtrace-public/main/assets/benchmarks/search-latency.svg" width="720"/>
 
 ### How much context does it save?
 
-<picture>
-  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/syncable-dev/memtrace-public/main/assets/benchmarks/token-context.svg"/>
-  <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/syncable-dev/memtrace-public/main/assets/benchmarks/token-context.svg"/>
-  <img alt="Token usage: Memtrace 284K vs Vector RAG 2.4M — 88.2% reduction" src="https://raw.githubusercontent.com/syncable-dev/memtrace-public/main/assets/benchmarks/token-context.svg" width="720"/>
-</picture>
+<img alt="Token usage: Memtrace 284K vs Vector RAG 2.4M — 88.2% reduction" src="https://raw.githubusercontent.com/syncable-dev/memtrace-public/main/assets/benchmarks/token-context.svg" width="720"/>
 
 ### How long to set up?
 
-<picture>
-  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/syncable-dev/memtrace-public/main/assets/benchmarks/indexing-speed.svg"/>
-  <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/syncable-dev/memtrace-public/main/assets/benchmarks/indexing-speed.svg"/>
-  <img alt="Indexing: Memtrace 1.5s vs Graphiti 6h vs Mem0 31m" src="https://raw.githubusercontent.com/syncable-dev/memtrace-public/main/assets/benchmarks/indexing-speed.svg" width="720"/>
-</picture>
+<img alt="Indexing: Memtrace 1.5s vs Graphiti 6h vs Mem0 31m" src="https://raw.githubusercontent.com/syncable-dev/memtrace-public/main/assets/benchmarks/indexing-speed.svg" width="720"/>
 
 <details>
 <summary><strong>Memtrace vs. general memory systems (Mem0, Graphiti)</strong></summary>
@@ -247,6 +233,15 @@ Skills and plugins are shared between Claude Code and Claude Desktop — both ac
 }
 ```
 
+### Uninstall
+
+```bash
+memtrace uninstall              # removes skills, MCP server, and plugin from settings
+npm uninstall -g memtrace       # removes the binary
+```
+
+> **Why two commands?** npm v7+ [does not run lifecycle hooks](https://github.com/npm/cli/issues/3042) for global packages. `memtrace uninstall` handles the cleanup that npm can't.
+
 ## 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,31 @@
 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 uninstallPath = path.join(__dirname, "..", "uninstall.js");
+
+  try {
+    // Load and run the uninstall script directly
+    require(uninstallPath);
+  } catch (e) {
+    console.error(`memtrace: uninstall failed: ${e.message}`);
+    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 +37,7 @@ try {
   process.exit(1);
 }
 
-const result = spawnSync(binaryPath, process.argv.slice(2), {
+const result = spawnSync(binaryPath, args, {
   stdio: "inherit",
   env: process.env,
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memtrace",
-  "version": "0.1.24",
+  "version": "0.1.26",
   "description": "Code intelligence graph — MCP server + AI agent skills + visualization UI",
   "keywords": [
     "mcp",
@@ -23,10 +23,12 @@
   "files": [
     "bin/",
     "skills/",
-    "install.js"
+    "install.js",
+    "uninstall.js"
   ],
   "scripts": {
-    "postinstall": "node install.js"
+    "postinstall": "node install.js",
+    "preuninstall": "node uninstall.js"
   },
   "optionalDependencies": {
     "@memtrace/darwin-arm64": "0.1.0",

package/uninstall.js

@@ -0,0 +1,183 @@
+#!/usr/bin/env node
+"use strict";
+
+const os = require("os");
+const path = require("path");
+const fs = require("fs");
+const { execSync } = require("child_process");
+
+// ── Constants ─────────────────────────────────────────────────────────────────
+
+const PLUGIN_NAME = "memtrace-skills";
+const MARKETPLACE_NAME = "memtrace";
+const MCP_SERVER_NAME = "memtrace";
+
+const SKILL_NAMES = [
+  // Commands
+  "memtrace-api-topology",
+  "memtrace-evolution",
+  "memtrace-graph",
+  "memtrace-impact",
+  "memtrace-index",
+  "memtrace-quality",
+  "memtrace-relationships",
+  "memtrace-search",
+  // Workflows
+  "memtrace-change-impact-analysis",
+  "memtrace-codebase-exploration",
+  "memtrace-incident-investigation",
+  "memtrace-refactoring-guide",
+];
+
+// ── Remove skills ───────────────────────────────────────────────────────────
+
+function removeSkills() {
+  const claudeSkillsDir = path.join(os.homedir(), ".claude", "skills");
+  let removed = 0;
+
+  for (const name of SKILL_NAMES) {
+    const skillDir = path.join(claudeSkillsDir, name);
+    if (fs.existsSync(skillDir)) {
+      try {
+        fs.rmSync(skillDir, { recursive: true, force: true });
+        removed++;
+      } catch (e) {
+        console.warn(`memtrace: failed to remove skill ${name}: ${e.message}`);
+      }
+    }
+  }
+
+  if (removed > 0) {
+    console.log(`memtrace: removed ${removed} skills from ${claudeSkillsDir}`);
+  }
+}
+
+// ── Settings.json helpers ────────────────────────────────────────────────────
+
+function readSettings() {
+  const settingsFile = path.join(os.homedir(), ".claude", "settings.json");
+  if (fs.existsSync(settingsFile)) {
+    try {
+      return JSON.parse(fs.readFileSync(settingsFile, "utf-8"));
+    } catch {
+      return {};
+    }
+  }
+  return {};
+}
+
+function writeSettings(settings) {
+  const settingsFile = path.join(os.homedir(), ".claude", "settings.json");
+  fs.writeFileSync(settingsFile, JSON.stringify(settings, null, 2) + "\n");
+}
+
+// ── Remove MCP server ───────────────────────────────────────────────────────
+
+function removeMcpServer() {
+  const settings = readSettings();
+  let changed = false;
+
+  if (settings.mcpServers && settings.mcpServers[MCP_SERVER_NAME]) {
+    delete settings.mcpServers[MCP_SERVER_NAME];
+    if (Object.keys(settings.mcpServers).length === 0) {
+      delete settings.mcpServers;
+    }
+    changed = true;
+    console.log("memtrace: removed MCP server from ~/.claude/settings.json");
+  }
+
+  if (changed) writeSettings(settings);
+}
+
+// ── Remove plugin + marketplace ─────────────────────────────────────────────
+
+function removePlugin() {
+  const settings = readSettings();
+  let changed = false;
+  const pluginKey = `${PLUGIN_NAME}@${MARKETPLACE_NAME}`;
+
+  if (settings.enabledPlugins && settings.enabledPlugins[pluginKey] !== undefined) {
+    delete settings.enabledPlugins[pluginKey];
+    if (Object.keys(settings.enabledPlugins).length === 0) {
+      delete settings.enabledPlugins;
+    }
+    changed = true;
+    console.log(`memtrace: removed plugin ${pluginKey}`);
+  }
+
+  if (settings.extraKnownMarketplaces && settings.extraKnownMarketplaces[MARKETPLACE_NAME]) {
+    delete settings.extraKnownMarketplaces[MARKETPLACE_NAME];
+    if (Object.keys(settings.extraKnownMarketplaces).length === 0) {
+      delete settings.extraKnownMarketplaces;
+    }
+    changed = true;
+    console.log(`memtrace: removed marketplace ${MARKETPLACE_NAME}`);
+  }
+
+  if (changed) writeSettings(settings);
+}
+
+// ── Try Claude CLI uninstall ────────────────────────────────────────────────
+
+function tryClaudeCliUninstall() {
+  try {
+    execSync("which claude", { stdio: "ignore" });
+  } catch {
+    return false;
+  }
+
+  try {
+    execSync(`claude plugin uninstall ${PLUGIN_NAME}@${MARKETPLACE_NAME} --scope user`, {
+      stdio: "ignore",
+      timeout: 15000,
+    });
+    console.log("memtrace: uninstalled plugin via Claude CLI");
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// ── Main uninstall logic ───────────────────────────────────────────────────
+
+function run() {
+  console.log("memtrace: cleaning up...");
+
+  // 1. Remove skills
+  try {
+    removeSkills();
+  } catch (e) {
+    console.warn(`memtrace: skill removal failed: ${e.message}`);
+  }
+
+  // 2. Try Claude CLI uninstall, then manual cleanup
+  try {
+    tryClaudeCliUninstall();
+  } catch (e) {
+    // silent
+  }
+
+  // 3. Remove plugin + marketplace from settings
+  try {
+    removePlugin();
+  } catch (e) {
+    console.warn(`memtrace: plugin removal failed: ${e.message}`);
+  }
+
+  // 4. Remove MCP server from settings
+  try {
+    removeMcpServer();
+  } catch (e) {
+    console.warn(`memtrace: MCP server removal failed: ${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();
+}