persisted-memory 1.0.0

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "persisted-memory",
+  "version": "1.0.0",
+  "description": "Persistent memory system for Claude Code via MCP — dual-write to Markdown + LanceDB with hybrid semantic search",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "persisted-memory": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "!dist/__tests__",
+    "hooks",
+    "scripts",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "mcp",
+    "claude",
+    "claude-code",
+    "memory",
+    "persistent-memory",
+    "vector-search",
+    "lancedb",
+    "model-context-protocol",
+    "ai",
+    "llm"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/saharat/persisted-memory"
+  },
+  "license": "MIT",
+  "author": "saharat",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "build": "tsc && cp src/viewer/index.html dist/viewer/index.html",
+    "dev": "tsc --watch",
+    "viewer": "node dist/cli/viewer.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  },
+  "dependencies": {
+    "@lancedb/lancedb": "^0.26.2",
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "apache-arrow": "18.1.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/node": "^20",
+    "@vitest/coverage-v8": "^3.1.0",
+    "typescript": "^5.6",
+    "vitest": "^3.1.0"
+  }
+}

package/scripts/install.sh

@@ -0,0 +1,125 @@
+#!/bin/bash
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "$0")/.." && pwd)"
+HOOKS_DIR="$SCRIPT_DIR/hooks"
+SETTINGS_FILE="$HOME/.claude/settings.json"
+
+echo "=== Persisted Memory — Install ==="
+echo ""
+
+# 1. Build
+echo "Building persisted-memory..."
+cd "$SCRIPT_DIR"
+yarn install --immutable 2>/dev/null || yarn install
+yarn build
+echo "  Build complete."
+echo ""
+
+# 2. Register MCP server (user-level)
+echo "Registering MCP server (user-level)..."
+claude mcp add --scope user memory -- node "$SCRIPT_DIR/dist/index.js"
+echo "  MCP server registered."
+echo ""
+
+# 3. Make hook scripts executable
+echo "Making hook scripts executable..."
+chmod +x "$HOOKS_DIR"/*.sh
+echo ""
+
+# 4. Merge hooks into ~/.claude/settings.json
+echo "Registering hooks in $SETTINGS_FILE..."
+
+# Ensure settings file exists
+mkdir -p "$HOME/.claude"
+if [ ! -f "$SETTINGS_FILE" ]; then
+  echo '{}' > "$SETTINGS_FILE"
+fi
+
+node -e "
+const fs = require('fs');
+const settingsPath = '$SETTINGS_FILE';
+const hooksDir = '$HOOKS_DIR';
+
+let settings;
+try {
+  settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8'));
+} catch {
+  settings = {};
+}
+
+settings.hooks = settings.hooks || {};
+
+// Define our hooks with a marker so we can identify them later
+const MARKER = 'persisted-memory';
+
+const hookDefs = {
+  SessionStart: {
+    hooks: [{ type: 'command', command: 'bash ' + hooksDir + '/on-session-start.sh' }]
+  },
+  PreCompact: {
+    hooks: [{ type: 'command', command: 'bash ' + hooksDir + '/on-pre-compact.sh' }]
+  },
+  PostToolUse: {
+    matcher: 'Edit|Write',
+    hooks: [{ type: 'command', command: 'bash ' + hooksDir + '/on-post-tool.sh' }]
+  },
+  Stop: {
+    hooks: [{ type: 'command', command: 'bash ' + hooksDir + '/on-stop.sh' }]
+  },
+  SessionEnd: {
+    hooks: [{ type: 'command', command: 'bash ' + hooksDir + '/on-session-end.sh' }]
+  }
+};
+
+for (const [event, def] of Object.entries(hookDefs)) {
+  if (!settings.hooks[event]) {
+    settings.hooks[event] = [];
+  }
+
+  // Remove any existing persisted-memory hooks (idempotent)
+  settings.hooks[event] = settings.hooks[event].filter(
+    entry => !JSON.stringify(entry).includes('persisted_memory')
+  );
+
+  // Add our hook
+  settings.hooks[event].push(def);
+}
+
+fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
+console.log('  Hooks registered successfully.');
+"
+
+# 5. Add user-level CLAUDE.md instructions
+CLAUDE_MD="$HOME/.claude/CLAUDE.md"
+MEMORY_BLOCK="## Persistent Memory System
+- Persistent memory is enabled for all projects via MCP server \"memory\"
+- After context compaction, key context is preserved in \`.claude/memory/\`
+- Use \`memory_search\` to recall past decisions, patterns, and context
+- Use \`memory_store\` to explicitly save important decisions (type: \"decision\", importance: \"high\")
+- Use \`memory_recall\` for a specific topic (e.g., \"authentication flow\")
+- Use \`memory_status\` to check memory stats and Ollama availability
+- Memory data lives at \`<project>/.claude/memory/\` — Markdown files are the source of truth"
+
+if [ -f "$CLAUDE_MD" ]; then
+  if ! grep -q "Persistent Memory System" "$CLAUDE_MD"; then
+    echo "" >> "$CLAUDE_MD"
+    echo "$MEMORY_BLOCK" >> "$CLAUDE_MD"
+    echo "  Added memory instructions to $CLAUDE_MD"
+  else
+    echo "  Memory instructions already in $CLAUDE_MD"
+  fi
+else
+  echo "$MEMORY_BLOCK" > "$CLAUDE_MD"
+  echo "  Created $CLAUDE_MD with memory instructions"
+fi
+
+echo ""
+echo "=== Installation complete! ==="
+echo ""
+echo "  MCP server: node $SCRIPT_DIR/dist/index.js"
+echo "  Memory data: <project>/.claude/memory/"
+echo ""
+echo "  Add to your project .gitignore: .claude/memory/.lance/"
+echo ""
+echo "  Restart Claude Code to activate."

package/scripts/uninstall.sh

@@ -0,0 +1,59 @@
+#!/bin/bash
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "$0")/.." && pwd)"
+SETTINGS_FILE="$HOME/.claude/settings.json"
+
+echo "=== Persisted Memory — Uninstall ==="
+echo ""
+
+# 1. Remove MCP server
+echo "Removing MCP server registration..."
+claude mcp remove --scope user memory 2>/dev/null || echo "  (not registered)"
+echo ""
+
+# 2. Remove hooks from settings.json
+echo "Removing hooks from $SETTINGS_FILE..."
+if [ -f "$SETTINGS_FILE" ]; then
+  node -e "
+const fs = require('fs');
+const settingsPath = '$SETTINGS_FILE';
+
+let settings;
+try {
+  settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8'));
+} catch {
+  process.exit(0);
+}
+
+if (!settings.hooks) process.exit(0);
+
+for (const event of Object.keys(settings.hooks)) {
+  if (Array.isArray(settings.hooks[event])) {
+    settings.hooks[event] = settings.hooks[event].filter(
+      entry => !JSON.stringify(entry).includes('persisted_memory')
+    );
+    // Remove empty arrays
+    if (settings.hooks[event].length === 0) {
+      delete settings.hooks[event];
+    }
+  }
+}
+
+// Remove hooks key if empty
+if (Object.keys(settings.hooks).length === 0) {
+  delete settings.hooks;
+}
+
+fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
+console.log('  Hooks removed.');
+"
+fi
+
+echo ""
+echo "=== Uninstall complete! ==="
+echo ""
+echo "  Note: Per-project memory data at <project>/.claude/memory/ is preserved."
+echo "  Delete manually if no longer needed."
+echo ""
+echo "  Restart Claude Code to deactivate."