laminark 0.1.0

package/plugin/hooks/hooks.json

@@ -0,0 +1,78 @@
+{
+  "description": "Laminark: persistent adaptive memory for Claude Code",
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ${CLAUDE_PLUGIN_ROOT}/scripts/ensure-deps.sh node ${CLAUDE_PLUGIN_ROOT}/dist/hooks/handler.js",
+            "statusMessage": "Loading Laminark memory context...",
+            "timeout": 10
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ${CLAUDE_PLUGIN_ROOT}/scripts/ensure-deps.sh node ${CLAUDE_PLUGIN_ROOT}/dist/hooks/handler.js",
+            "timeout": 2
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ${CLAUDE_PLUGIN_ROOT}/scripts/ensure-deps.sh node ${CLAUDE_PLUGIN_ROOT}/dist/hooks/handler.js",
+            "async": true,
+            "timeout": 30
+          }
+        ]
+      }
+    ],
+    "PostToolUseFailure": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ${CLAUDE_PLUGIN_ROOT}/scripts/ensure-deps.sh node ${CLAUDE_PLUGIN_ROOT}/dist/hooks/handler.js",
+            "async": true,
+            "timeout": 30
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ${CLAUDE_PLUGIN_ROOT}/scripts/ensure-deps.sh node ${CLAUDE_PLUGIN_ROOT}/dist/hooks/handler.js",
+            "async": true,
+            "timeout": 15
+          }
+        ]
+      }
+    ],
+    "SessionEnd": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "bash ${CLAUDE_PLUGIN_ROOT}/scripts/ensure-deps.sh node ${CLAUDE_PLUGIN_ROOT}/dist/hooks/handler.js",
+            "async": true,
+            "timeout": 15
+          }
+        ]
+      }
+    ]
+  }
+}

package/plugin/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "laminark-plugin",
+  "version": "0.1.0",
+  "private": true,
+  "description": "Laminark plugin runtime dependencies",
+  "type": "module",
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.2.42",
+    "@hono/node-server": "^1.19.9",
+    "@huggingface/transformers": "^3.8.1",
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "better-sqlite3": "^12.6.2",
+    "hono": "^4.11.9",
+    "sqlite-vec": "^0.1.7-alpha.2",
+    "zod": "^4.3.6"
+  }
+}

package/plugin/scripts/README.md

@@ -0,0 +1,65 @@
+# Scripts
+
+## Installation Scripts
+
+| Script | Purpose |
+|--------|---------|
+| `install.sh` | Full install: npm global + MCP server + hooks |
+| `local-install.sh` | Dev install: npm link + MCP server + hooks (points at repo) |
+| `update.sh` | Update: `npm update -g laminark` |
+| `uninstall.sh` | Remove MCP server, hooks, and npm package |
+| `verify-install.sh` | Check installation status |
+
+## How It Works
+
+Laminark installs via three steps:
+
+1. **npm package** — `npm install -g laminark` puts `laminark-server` and `laminark-hook` on PATH
+2. **MCP server** — `claude mcp add-json` registers the MCP server in `~/.claude/settings.json`
+3. **Hooks** — Hook entries are merged into `~/.claude/settings.json` to capture session events
+
+## Version Bumping
+
+Laminark uses `MILESTONE.PHASE.SEQUENTIAL` versioning aligned with GSD (Get Shit Done) workflow.
+
+### Format: `M.P.S`
+- **M** = Milestone generation (1, 2, 3...)
+- **P** = Absolute phase number (1, 2, 3... 21+)
+- **S** = Sequential release within phase (0, 1, 2...)
+
+### Automatic Bumping (CI/CD)
+
+The GitHub Actions workflow automatically bumps the **patch** version (S) on every push to master:
+```bash
+2.21.0 → 2.21.1
+```
+
+This is for incremental fixes and updates within the same phase.
+
+### Manual Bumping
+
+When starting a **new phase** or **milestone**, manually run:
+
+```bash
+# New phase (phase 21 → 22)
+./scripts/bump-version.sh phase
+# 2.21.0 → 2.22.0
+
+# New milestone (generation 2 → 3)
+./scripts/bump-version.sh milestone
+# 2.21.0 → 3.22.0
+```
+
+Then commit and push:
+```bash
+git add package.json
+git commit -m "chore: bump to vX.Y.0 for phase Z"
+git push
+```
+
+### Version History
+
+- **v1.8.0** - Phase 8 (Milestone v1.0 complete)
+- **v2.16.0** - Phase 16 (Milestone v2.0 complete)
+- **v2.18.0** - Phase 18 (Milestone v2.1 complete)
+- **v2.21.0** - Phase 21 (Milestone v2.2 complete)

package/plugin/scripts/bump-version.sh

@@ -0,0 +1,42 @@
+#!/bin/bash
+# Bump version using MILESTONE.PHASE.SEQUENTIAL format
+# Usage: ./scripts/bump-version.sh [patch|phase|milestone]
+#
+# Examples:
+#   ./scripts/bump-version.sh patch      # 2.21.0 -> 2.21.1 (default)
+#   ./scripts/bump-version.sh phase      # 2.21.0 -> 2.22.0 (new phase)
+#   ./scripts/bump-version.sh milestone  # 2.21.0 -> 3.22.0 (new milestone)
+
+set -euo pipefail
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+ROOT="$SCRIPT_DIR/.."
+
+BUMP_TYPE="${1:-patch}"
+
+CURRENT=$(node -e "console.log(require('$ROOT/package.json').version)")
+
+# Parse current version
+IFS='.' read -r MILESTONE PHASE SEQUENTIAL <<< "$CURRENT"
+
+# Determine next version based on bump type
+case "$BUMP_TYPE" in
+  patch)
+    NEXT="$MILESTONE.$PHASE.$((SEQUENTIAL + 1))"
+    ;;
+  phase)
+    NEXT="$MILESTONE.$((PHASE + 1)).0"
+    ;;
+  milestone)
+    NEXT="$((MILESTONE + 1)).$((PHASE + 1)).0"
+    ;;
+  *)
+    echo "Error: Invalid bump type '$BUMP_TYPE'. Use: patch, phase, or milestone" >&2
+    exit 1
+    ;;
+esac
+
+# Update version in all files
+sed -i "s/\"version\": \"$CURRENT\"/\"version\": \"$NEXT\"/" \
+  "$ROOT/package.json"
+
+echo "$NEXT"

package/plugin/scripts/dev-sync.sh

@@ -0,0 +1,58 @@
+#!/bin/bash
+# Sync dev plugin build to the cached Claude Code plugin installation.
+# Run after `npm run build` to hot-update the running plugin without restarting.
+#
+# Usage: ./plugin/scripts/dev-sync.sh
+#
+# Note: Static files (UI, hooks) take effect immediately on next page load.
+#       Compiled server code (dist/) requires a Claude Code session restart
+#       to pick up API changes.
+
+set -e
+
+CLAUDE_HOME="${CLAUDE_HOME:-$HOME/.claude}"
+CACHE_BASE="$CLAUDE_HOME/plugins/cache/laminark/laminark"
+
+# Resolve the repo root (script lives in plugin/scripts/)
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+PLUGIN_SRC="$REPO_ROOT/plugin"
+
+# Verify source exists
+if [ ! -d "$PLUGIN_SRC/dist" ]; then
+  echo "Error: plugin/dist/ not found. Run 'npm run build' first."
+  exit 1
+fi
+
+# Find cached installation(s)
+if [ ! -d "$CACHE_BASE" ]; then
+  echo "Error: No cached Laminark plugin found at $CACHE_BASE"
+  echo "Install Laminark first: claude plugin add laminark"
+  exit 1
+fi
+
+# Sync to every cached version (usually just one)
+SYNCED=0
+for CACHE_DIR in "$CACHE_BASE"/*/; do
+  [ -d "$CACHE_DIR" ] || continue
+  VERSION=$(basename "$CACHE_DIR")
+
+  rsync -a --delete \
+    --exclude '*.db' \
+    --exclude '*.db-wal' \
+    --exclude '*.db-shm' \
+    --exclude 'node_modules' \
+    "$PLUGIN_SRC/" "$CACHE_DIR"
+
+  echo "Synced to $VERSION"
+  SYNCED=$((SYNCED + 1))
+done
+
+if [ "$SYNCED" -eq 0 ]; then
+  echo "Error: No version directories found in $CACHE_BASE"
+  exit 1
+fi
+
+echo ""
+echo "Done. $SYNCED cached installation(s) updated."
+echo "UI changes are live. API changes need a session restart."

package/plugin/scripts/ensure-deps.sh

@@ -0,0 +1,15 @@
+#!/bin/bash
+# Auto-install production dependencies if missing (first run after plugin install)
+PLUGIN_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+if [ ! -d "$PLUGIN_ROOT/node_modules/better-sqlite3/build" ]; then
+  # Use local tmp dir to avoid EXDEV errors on btrfs subvolumes / cross-device setups
+  NPM_TMP="$PLUGIN_ROOT/.npm-tmp"
+  mkdir -p "$NPM_TMP"
+  # Install deps without running install scripts (sharp build fails without node-addon-api)
+  # then selectively rebuild better-sqlite3 which needs its native addon
+  TMPDIR="$NPM_TMP" npm install --prefix "$PLUGIN_ROOT" --omit=dev --ignore-scripts --silent --cache "$NPM_TMP/cache" 2>/dev/null
+  npm rebuild --prefix "$PLUGIN_ROOT" better-sqlite3 --silent 2>/dev/null
+  rm -rf "$NPM_TMP"
+fi
+cd "$PLUGIN_ROOT"
+exec "$@"

package/plugin/scripts/install.sh

@@ -0,0 +1,139 @@
+#!/bin/bash
+# Install Laminark via npm + MCP server registration
+# Fully standalone — no git clone required.
+#
+# Usage: curl -fsSL https://raw.githubusercontent.com/NoobyNull/Laminark/master/plugin/scripts/install.sh | bash
+#   or:  ./plugin/scripts/install.sh
+
+set -e
+
+echo "Laminark Installer"
+echo "=================="
+echo ""
+
+# Check prerequisites
+if ! command -v node &> /dev/null; then
+  echo "Error: node not found"
+  echo "Please install Node.js >= 22: https://nodejs.org"
+  exit 1
+fi
+
+NODE_MAJOR=$(node -e "console.log(process.versions.node.split('.')[0])")
+if [ "$NODE_MAJOR" -lt 22 ]; then
+  echo "Error: Node.js >= 22 required (found v$(node -v))"
+  exit 1
+fi
+
+if ! command -v npm &> /dev/null; then
+  echo "Error: npm not found"
+  exit 1
+fi
+
+if ! command -v claude &> /dev/null; then
+  echo "Error: claude CLI not found"
+  echo "Please install Claude Code first: https://claude.com/claude-code"
+  exit 1
+fi
+
+# Check if already installed
+CURRENT_VERSION=$(npm list -g laminark --depth=0 2>/dev/null | grep laminark@ | sed 's/.*@//' || echo "")
+if [ -n "$CURRENT_VERSION" ]; then
+  echo "Currently installed: v$CURRENT_VERSION"
+  echo "Reinstalling..."
+fi
+
+# Step 1: Install via npm
+echo ""
+echo "Installing laminark globally via npm..."
+npm install -g laminark
+echo "✓ npm package installed"
+
+# Step 2: Register MCP server
+echo ""
+echo "Registering MCP server with Claude Code..."
+claude mcp add-json laminark '{"command":"laminark-server"}' -s user
+echo "✓ MCP server registered"
+
+# Step 3: Configure hooks in ~/.claude/settings.json
+echo ""
+echo "Configuring hooks..."
+SETTINGS_FILE="${CLAUDE_HOME:-$HOME/.claude}/settings.json"
+
+node -e '
+const fs = require("fs");
+const path = require("path");
+const settingsPath = process.argv[1];
+
+// Ensure directory exists
+fs.mkdirSync(path.dirname(settingsPath), { recursive: true });
+
+let settings = {};
+if (fs.existsSync(settingsPath)) {
+  settings = JSON.parse(fs.readFileSync(settingsPath, "utf8"));
+}
+
+if (!settings.hooks) settings.hooks = {};
+
+const hookEvents = {
+  SessionStart: { type: "command", command: "laminark-hook", statusMessage: "Loading Laminark memory context...", timeout: 10 },
+  PreToolUse:   { type: "command", command: "laminark-hook", timeout: 2 },
+  PostToolUse:  { type: "command", command: "laminark-hook", async: true, timeout: 30 },
+  PostToolUseFailure: { type: "command", command: "laminark-hook", async: true, timeout: 30 },
+  Stop:         { type: "command", command: "laminark-hook", async: true, timeout: 15 },
+  SessionEnd:   { type: "command", command: "laminark-hook", async: true, timeout: 15 }
+};
+
+for (const [event, hookConfig] of Object.entries(hookEvents)) {
+  if (!settings.hooks[event]) settings.hooks[event] = [];
+
+  // Remove any existing laminark hooks, then re-add (ensures up-to-date config)
+  settings.hooks[event] = settings.hooks[event].filter(entry =>
+    !(entry.hooks && entry.hooks.some(h => h.command && h.command.includes("laminark")))
+  );
+
+  settings.hooks[event].push({
+    hooks: [hookConfig]
+  });
+}
+
+fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n");
+' "$SETTINGS_FILE"
+
+echo "✓ Hooks configured"
+
+# Done
+NEW_VERSION=$(npm list -g laminark --depth=0 2>/dev/null | grep laminark@ | sed 's/.*@//' || echo "unknown")
+echo ""
+echo "✓ Laminark v$NEW_VERSION installed successfully!"
+echo ""
+echo "Next steps:"
+echo "  1. Start a new Claude Code session"
+echo "  2. Verify with: /mcp (should show laminark tools)"
+
+# Step 4: Recommend GSD (Get Shit Done) workflow plugin
+echo ""
+GSD_INSTALLED=false
+if [ -d "${CLAUDE_HOME:-$HOME/.claude}/commands/gsd" ] || [ -d "${CLAUDE_HOME:-$HOME/.claude}/plugins/gsd" ]; then
+  GSD_INSTALLED=true
+fi
+
+if [ "$GSD_INSTALLED" = false ]; then
+  echo "Recommended: Install GSD (Get Shit Done) by @gsd-framework"
+  echo "  GSD is an independent workflow plugin for Claude Code that pairs"
+  echo "  well with Laminark — it handles project planning, phased execution,"
+  echo "  and atomic commits while Laminark provides persistent memory."
+  echo "  (GSD does not endorse or recommend Laminark — this is our suggestion.)"
+  echo ""
+  echo "  Install: claude plugin add gsd"
+  echo "  More info: https://github.com/gsd-framework/gsd"
+  echo ""
+  if [ -t 0 ]; then
+    read -rp "Install GSD now? [y/N] " INSTALL_GSD
+    if [[ "$INSTALL_GSD" =~ ^[Yy]$ ]]; then
+      echo ""
+      claude plugin add gsd 2>/dev/null && echo "✓ GSD installed" || echo "  GSD install skipped (install manually with: claude plugin add gsd)"
+    fi
+  fi
+fi
+
+exit 0

package/plugin/scripts/local-install.sh

@@ -0,0 +1,138 @@
+#!/bin/bash
+# Local development installation for Laminark
+# Uses npm link + MCP server registration + hooks pointing at repo dist/
+#
+# Usage: ./plugin/scripts/local-install.sh [path-to-laminark]
+#   Default path: current directory (.)
+
+set -e
+
+# Parse path argument (default to current directory)
+PLUGIN_PATH="${1:-.}"
+
+# Resolve to absolute path
+if [[ "$PLUGIN_PATH" != /* ]]; then
+  PLUGIN_PATH="$(cd "$PLUGIN_PATH" && pwd)"
+fi
+
+echo "Laminark Local Installer"
+echo "========================"
+echo ""
+echo "Installing from: $PLUGIN_PATH"
+
+# Validate prerequisites
+if [ ! -d "$PLUGIN_PATH/plugin/dist" ]; then
+  echo "Error: plugin/dist/ directory not found in $PLUGIN_PATH"
+  echo "Please run 'npm install && npm run build' first"
+  exit 1
+fi
+
+if ! command -v claude &> /dev/null; then
+  echo "Error: claude CLI not found"
+  echo "Please install Claude Code first: https://claude.com/claude-code"
+  exit 1
+fi
+
+# Get version from package.json
+if [ -f "$PLUGIN_PATH/package.json" ]; then
+  NEW_VERSION=$(grep '"version"' "$PLUGIN_PATH/package.json" | head -1 | sed -E 's/.*"version": "([^"]+)".*/\1/')
+  echo "Version: v$NEW_VERSION"
+fi
+
+# Step 1: npm link from repo root
+echo ""
+echo "Linking package globally..."
+cd "$PLUGIN_PATH"
+npm link
+echo "✓ npm link complete"
+
+# Step 2: Register MCP server
+echo ""
+echo "Registering MCP server with Claude Code..."
+claude mcp add-json laminark '{"command":"laminark-server"}' -s user
+echo "✓ MCP server registered"
+
+# Step 3: Configure hooks using repo's dist/hooks/handler.js
+echo ""
+echo "Configuring hooks (dev mode - pointing at repo)..."
+SETTINGS_FILE="${CLAUDE_HOME:-$HOME/.claude}/settings.json"
+HANDLER_PATH="$PLUGIN_PATH/plugin/dist/hooks/handler.js"
+
+node -e '
+const fs = require("fs");
+const settingsPath = process.argv[1];
+const handlerPath = process.argv[2];
+const hookCmd = `node "${handlerPath}"`;
+
+let settings = {};
+if (fs.existsSync(settingsPath)) {
+  settings = JSON.parse(fs.readFileSync(settingsPath, "utf8"));
+}
+
+if (!settings.hooks) settings.hooks = {};
+
+const hookEvents = {
+  SessionStart: { type: "command", command: hookCmd, statusMessage: "Loading Laminark memory context...", timeout: 10 },
+  PreToolUse:   { type: "command", command: hookCmd, timeout: 2 },
+  PostToolUse:  { type: "command", command: hookCmd, async: true, timeout: 30 },
+  PostToolUseFailure: { type: "command", command: hookCmd, async: true, timeout: 30 },
+  Stop:         { type: "command", command: hookCmd, async: true, timeout: 15 },
+  SessionEnd:   { type: "command", command: hookCmd, async: true, timeout: 15 }
+};
+
+for (const [event, hookConfig] of Object.entries(hookEvents)) {
+  if (!settings.hooks[event]) settings.hooks[event] = [];
+
+  // Remove any existing laminark hooks for this event
+  settings.hooks[event] = settings.hooks[event].filter(entry =>
+    !(entry.hooks && entry.hooks.some(h => h.command && h.command.includes("laminark")))
+  );
+
+  // Add the dev hook
+  settings.hooks[event].push({
+    hooks: [hookConfig]
+  });
+}
+
+fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n");
+' "$SETTINGS_FILE" "$HANDLER_PATH"
+
+echo "✓ Hooks configured (dev: $HANDLER_PATH)"
+
+# Done
+echo ""
+echo "✓ Laminark v$NEW_VERSION installed locally!"
+echo ""
+echo "Next steps:"
+echo "  1. Start a new Claude Code session"
+echo "  2. Verify with: /mcp (should show laminark tools)"
+echo ""
+echo "To switch to production install: npm install -g laminark && ./plugin/scripts/install.sh"
+
+# Step 4: Recommend GSD (Get Shit Done) workflow plugin
+echo ""
+GSD_INSTALLED=false
+if [ -d "${CLAUDE_HOME:-$HOME/.claude}/commands/gsd" ] || [ -d "${CLAUDE_HOME:-$HOME/.claude}/plugins/gsd" ]; then
+  GSD_INSTALLED=true
+fi
+
+if [ "$GSD_INSTALLED" = false ]; then
+  echo "Recommended: Install GSD (Get Shit Done) by @gsd-framework"
+  echo "  GSD is an independent workflow plugin for Claude Code that pairs"
+  echo "  well with Laminark — it handles project planning, phased execution,"
+  echo "  and atomic commits while Laminark provides persistent memory."
+  echo "  (GSD does not endorse or recommend Laminark — this is our suggestion.)"
+  echo ""
+  echo "  Install: claude plugin add gsd"
+  echo "  More info: https://github.com/gsd-framework/gsd"
+  echo ""
+  if [ -t 0 ]; then
+    read -rp "Install GSD now? [y/N] " INSTALL_GSD
+    if [[ "$INSTALL_GSD" =~ ^[Yy]$ ]]; then
+      echo ""
+      claude plugin add gsd 2>/dev/null && echo "✓ GSD installed" || echo "  GSD install skipped (install manually with: claude plugin add gsd)"
+    fi
+  fi
+fi
+
+exit 0

package/plugin/scripts/uninstall.sh

@@ -0,0 +1,133 @@
+#!/bin/bash
+# Uninstall Laminark: remove MCP server, hooks, and npm package
+
+set -e
+
+echo "Laminark Uninstaller"
+echo "===================="
+echo ""
+
+# Check if claude CLI is available
+if ! command -v claude &> /dev/null; then
+  echo "Warning: claude CLI not found, skipping MCP/hook cleanup"
+  SKIP_CLAUDE=true
+fi
+
+# Check what's installed
+NPM_VERSION=$(npm list -g laminark --depth=0 2>/dev/null | grep laminark@ | sed 's/.*@//' || echo "")
+if [ -n "$NPM_VERSION" ]; then
+  echo "npm package: v$NPM_VERSION"
+fi
+
+# Check MCP registration
+if [ "$SKIP_CLAUDE" != "true" ]; then
+  if claude mcp list 2>/dev/null | grep -q "laminark"; then
+    echo "MCP server: registered"
+    MCP_REGISTERED=true
+  fi
+fi
+
+echo ""
+
+# Ask for confirmation
+read -p "Are you sure you want to uninstall Laminark? (y/N): " -n 1 -r
+echo ""
+if [[ ! $REPLY =~ ^[Yy]$ ]]; then
+  echo "Uninstall cancelled."
+  exit 0
+fi
+
+# Step 1: Remove MCP server
+if [ "$MCP_REGISTERED" = "true" ]; then
+  echo ""
+  echo "Removing MCP server..."
+  claude mcp remove laminark -s user 2>/dev/null || true
+  echo "✓ MCP server removed"
+fi
+
+# Step 2: Remove hooks from settings.json
+echo ""
+echo "Removing hooks from settings..."
+SETTINGS_FILE="${CLAUDE_HOME:-$HOME/.claude}/settings.json"
+
+if [ -f "$SETTINGS_FILE" ]; then
+  node -e '
+const fs = require("fs");
+const settingsPath = process.argv[1];
+
+const settings = JSON.parse(fs.readFileSync(settingsPath, "utf8"));
+
+if (settings.hooks) {
+  for (const [event, entries] of Object.entries(settings.hooks)) {
+    settings.hooks[event] = entries.filter(entry =>
+      !(entry.hooks && entry.hooks.some(h => h.command && h.command.includes("laminark")))
+    );
+    // Remove empty arrays
+    if (settings.hooks[event].length === 0) {
+      delete settings.hooks[event];
+    }
+  }
+  // Remove empty hooks object
+  if (Object.keys(settings.hooks).length === 0) {
+    delete settings.hooks;
+  }
+}
+
+// Remove laminark from enabledPlugins if present
+if (settings.enabledPlugins) {
+  for (const key of Object.keys(settings.enabledPlugins)) {
+    if (key.includes("laminark")) {
+      delete settings.enabledPlugins[key];
+    }
+  }
+}
+
+fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n");
+' "$SETTINGS_FILE"
+  echo "✓ Hooks removed"
+fi
+
+# Step 3: Uninstall npm package
+if [ -n "$NPM_VERSION" ]; then
+  echo ""
+  echo "Uninstalling npm package..."
+  npm uninstall -g laminark
+  echo "✓ npm package removed"
+fi
+
+# Step 4: Optional data cleanup
+echo ""
+echo "Data cleanup options:"
+echo "  1. Keep all data (can reinstall later without losing memories)"
+echo "  2. Remove everything (all memories and data)"
+echo ""
+read -p "Choose option (1-2, default=1): " -n 1 -r CLEANUP_OPTION
+echo ""
+
+case $CLEANUP_OPTION in
+  2)
+    DATA_DIR="$HOME/.laminark"
+    if [ -d "$DATA_DIR" ]; then
+      echo ""
+      echo "WARNING: This will delete all your memories and observations!"
+      read -p "Delete $DATA_DIR? (y/N): " -n 1 -r
+      echo ""
+      if [[ $REPLY =~ ^[Yy]$ ]]; then
+        rm -rf "$DATA_DIR"
+        echo "✓ Data directory removed: $DATA_DIR"
+      else
+        echo "  Kept data directory: $DATA_DIR"
+      fi
+    fi
+    ;;
+  *)
+    echo "Keeping all data."
+    ;;
+esac
+
+echo ""
+echo "✓ Uninstall complete!"
+echo ""
+echo "To reinstall: npm install -g laminark && ./plugin/scripts/install.sh"
+
+exit 0