memtrace 0.1.24 → 0.1.25

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>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memtrace",
-  "version": "0.1.24",
+  "version": "0.1.25",
   "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,175 @@
+#!/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 preuninstall ───────────────────────────────────────────────────────
+
+if (require.main === module) {
+  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");
+}