laminark 2.21.9 → 2.22.1

package/plugin/scripts/local-install.sh

@@ -1,32 +1,41 @@
 #!/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]
+# Creates a symlink from the repo's plugin/ directory into the Claude Code
+# plugin cache, so changes take effect without copying files.
+#
+# Usage: ./plugin/scripts/local-install.sh [path-to-laminark-repo]
 #   Default path: current directory (.)
 
 set -e
 
 # Parse path argument (default to current directory)
-PLUGIN_PATH="${1:-.}"
+REPO_PATH="${1:-.}"
 
 # Resolve to absolute path
-if [[ "$PLUGIN_PATH" != /* ]]; then
-  PLUGIN_PATH="$(cd "$PLUGIN_PATH" && pwd)"
+if [[ "$REPO_PATH" != /* ]]; then
+  REPO_PATH="$(cd "$REPO_PATH" && pwd)"
 fi
 
-echo "Laminark Local Installer"
-echo "========================"
+PLUGIN_SRC="$REPO_PATH/plugin"
+
+echo "Laminark Local Installer (Dev Mode)"
+echo "===================================="
 echo ""
-echo "Installing from: $PLUGIN_PATH"
+echo "Repo: $REPO_PATH"
 
 # Validate prerequisites
-if [ ! -d "$PLUGIN_PATH/plugin/dist" ]; then
-  echo "Error: plugin/dist/ directory not found in $PLUGIN_PATH"
+if [ ! -d "$PLUGIN_SRC/dist" ]; then
+  echo "Error: plugin/dist/ directory not found"
   echo "Please run 'npm install && npm run build' first"
   exit 1
 fi
 
+if [ ! -f "$PLUGIN_SRC/.claude-plugin/plugin.json" ]; then
+  echo "Error: plugin/.claude-plugin/plugin.json 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"
@@ -34,105 +43,124 @@ if ! command -v claude &> /dev/null; then
 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
+NEW_VERSION=$(grep '"version"' "$REPO_PATH/package.json" | head -1 | sed -E 's/.*"version": "([^"]+)".*/\1/')
+echo "Version: v$NEW_VERSION"
 
-# Step 1: npm link from repo root
+# Step 1: npm link from repo root (optional — only for CLI bin entries)
 echo ""
 echo "Linking package globally..."
-cd "$PLUGIN_PATH"
-npm link
-echo "✓ npm link complete"
+cd "$REPO_PATH"
+if npm link 2>/dev/null; then
+  echo "✓ npm link complete"
+else
+  echo "⚠ npm link failed (permission issue) — skipping"
+  echo "  This is fine for dev mode. The plugin system doesn't need global bin entries."
+fi
 
-# 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 2: Create symlink in plugin cache
+CLAUDE_HOME="${CLAUDE_HOME:-$HOME/.claude}"
+CACHE_DIR="$CLAUDE_HOME/plugins/cache/laminark/laminark/$NEW_VERSION"
 
-# 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"
+echo "Creating plugin symlink in cache..."
+
+# Remove existing cache entry (could be a real dir from previous install)
+if [ -e "$CACHE_DIR" ]; then
+  rm -rf "$CACHE_DIR"
+fi
+
+mkdir -p "$(dirname "$CACHE_DIR")"
+ln -sf "$PLUGIN_SRC" "$CACHE_DIR"
+echo "✓ Symlinked $CACHE_DIR -> $PLUGIN_SRC"
+
+# Step 3: Register in installed_plugins.json
+INSTALLED_FILE="$CLAUDE_HOME/plugins/installed_plugins.json"
+mkdir -p "$CLAUDE_HOME/plugins"
 
 node -e '
 const fs = require("fs");
-const settingsPath = process.argv[1];
-const handlerPath = process.argv[2];
-const hookCmd = `node "${handlerPath}"`;
+const path = process.argv[1];
+const version = process.argv[2];
 
-let settings = {};
-if (fs.existsSync(settingsPath)) {
-  settings = JSON.parse(fs.readFileSync(settingsPath, "utf8"));
+let data = { version: 2, plugins: {} };
+if (fs.existsSync(path)) {
+  try { data = JSON.parse(fs.readFileSync(path, "utf8")); } catch {}
 }
 
-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 }
+data.plugins.laminark = {
+  marketplace: "laminark",
+  version: version,
+  enabled: true
 };
 
-for (const [event, hookConfig] of Object.entries(hookEvents)) {
-  if (!settings.hooks[event]) settings.hooks[event] = [];
+fs.writeFileSync(path, JSON.stringify(data, null, 2) + "\n");
+' "$INSTALLED_FILE" "$NEW_VERSION"
+echo "✓ Plugin registered"
 
-  // 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")))
-  );
+# Step 4: Enable plugin and clean up legacy config
+SETTINGS_FILE="$CLAUDE_HOME/settings.json"
 
-  // Add the dev hook
-  settings.hooks[event].push({
-    hooks: [hookConfig]
-  });
+node -e '
+const fs = require("fs");
+const settingsPath = process.argv[1];
+
+let settings = {};
+if (fs.existsSync(settingsPath)) {
+  try { settings = JSON.parse(fs.readFileSync(settingsPath, "utf8")); } catch {}
+}
+
+// Enable the plugin
+if (!settings.enabledPlugins) settings.enabledPlugins = {};
+settings.enabledPlugins["laminark@laminark"] = true;
+
+// Remove any legacy manual hooks
+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")))
+    );
+    if (settings.hooks[event].length === 0) {
+      delete settings.hooks[event];
+    }
+  }
+  if (Object.keys(settings.hooks).length === 0) {
+    delete settings.hooks;
+  }
+}
+
+// Remove legacy MCP registration
+if (settings.mcpServers && settings.mcpServers.laminark) {
+  delete settings.mcpServers.laminark;
+  if (Object.keys(settings.mcpServers).length === 0) {
+    delete settings.mcpServers;
+  }
 }
 
 fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n");
-' "$SETTINGS_FILE" "$HANDLER_PATH"
+' "$SETTINGS_FILE"
+echo "✓ Plugin enabled in settings"
 
-echo "✓ Hooks configured (dev: $HANDLER_PATH)"
+# Remove legacy MCP registration if present
+if claude mcp list 2>/dev/null | grep -q "^laminark:"; then
+  claude mcp remove laminark -s user 2>/dev/null || true
+  echo "✓ Legacy MCP registration removed"
+fi
+
+# Step 5: CLAUDE.md instructions are auto-provisioned on first MCP server start
+# (handled by ensure-deps.sh — no manual step needed)
 
 # Done
 echo ""
-echo "✓ Laminark v$NEW_VERSION installed locally!"
+echo "✓ Laminark v$NEW_VERSION installed locally (dev mode)!"
+echo ""
+echo "Dev workflow:"
+echo "  npm run build    # Rebuild after code changes"
+echo "  (symlink means changes are live — no sync needed)"
+echo "  API changes still need a Claude Code session restart."
 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
+echo "  2. Verify with: /plugin (should show laminark)"
+echo "  3. Check tools with: /mcp (should show laminark tools)"
 
 exit 0

package/plugin/scripts/repair.sh

@@ -0,0 +1,71 @@
+#!/bin/bash
+# Standalone repair script for Laminark plugin dependencies
+# Can be triggered manually or by the hook handler on dependency errors.
+# Exit codes: 0 = healthy or repaired, 1 = repair failed
+set -euo pipefail
+
+PLUGIN_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+REPAIR_LOG="$PLUGIN_ROOT/.repair-log"
+NEEDS_REPAIR="$PLUGIN_ROOT/.needs-repair"
+HEALTHY=true
+
+log_repair() {
+  echo "[$(date -Iseconds)] repair: $1" >> "$REPAIR_LOG"
+}
+
+log_repair "--- Repair script started ---"
+
+# 1. Check native addon binary exists
+if [ ! -f "$PLUGIN_ROOT/node_modules/better-sqlite3/build/Release/better_sqlite3.node" ]; then
+  log_repair "FAIL: better-sqlite3 native addon missing"
+  HEALTHY=false
+fi
+
+# 2. Test that better-sqlite3 loads in Node
+if $HEALTHY; then
+  if ! node -e "require('better-sqlite3')" 2>/dev/null; then
+    log_repair "FAIL: better-sqlite3 require() failed"
+    HEALTHY=false
+  fi
+fi
+
+# 3. Verify dist files exist and aren't empty
+if [ ! -s "$PLUGIN_ROOT/dist/hooks/handler.js" ]; then
+  log_repair "WARN: dist/hooks/handler.js missing or empty"
+  # This can't be fixed by reinstalling deps — just log it
+fi
+
+if [ ! -s "$PLUGIN_ROOT/dist/index.js" ]; then
+  log_repair "WARN: dist/index.js missing or empty"
+fi
+
+# 4. Repair if unhealthy
+if ! $HEALTHY; then
+  log_repair "Repairing: wiping node_modules and reinstalling"
+
+  rm -rf "$PLUGIN_ROOT/node_modules"
+
+  NPM_TMP="$PLUGIN_ROOT/.npm-tmp"
+  mkdir -p "$NPM_TMP"
+
+  TMPDIR="$NPM_TMP" npm install --prefix "$PLUGIN_ROOT" --omit=dev --ignore-scripts --silent --cache "$NPM_TMP/cache" 2>>"$REPAIR_LOG"
+  npm rebuild --prefix "$PLUGIN_ROOT" better-sqlite3 --silent 2>>"$REPAIR_LOG"
+  rm -rf "$NPM_TMP"
+
+  # Verify repair succeeded
+  if node -e "require('better-sqlite3')" 2>/dev/null; then
+    log_repair "OK: repair succeeded, better-sqlite3 loads"
+  else
+    log_repair "ERROR: repair failed, better-sqlite3 still broken"
+    rm -f "$NEEDS_REPAIR"
+    exit 1
+  fi
+else
+  log_repair "OK: all checks passed, no repair needed"
+fi
+
+# Clean up marker file
+rm -f "$NEEDS_REPAIR"
+
+log_repair "--- Repair script finished ---"
+exit 0

package/plugin/scripts/uninstall.sh

@@ -1,5 +1,5 @@
 #!/bin/bash
-# Uninstall Laminark: remove MCP server, hooks, and npm package
+# Uninstall Laminark: remove plugin from cache, settings, and npm
 
 set -e
 
@@ -7,24 +7,20 @@ 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
+CLAUDE_HOME="${CLAUDE_HOME:-$HOME/.claude}"
 
 # Check what's installed
 NPM_VERSION=$(npm list -g laminark --depth=0 2>/dev/null | grep laminark@ | sed 's/.*@//' || echo "")
+CACHE_EXISTS=false
+if [ -d "$CLAUDE_HOME/plugins/cache/laminark" ]; then
+  CACHE_EXISTS=true
+fi
+
 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
+if [ "$CACHE_EXISTS" = true ]; then
+  echo "Plugin cache: present"
 fi
 
 echo ""
@@ -37,57 +33,86 @@ if [[ ! $REPLY =~ ^[Yy]$ ]]; then
   exit 0
 fi
 
-# Step 1: Remove MCP server
-if [ "$MCP_REGISTERED" = "true" ]; then
+# Step 1: Remove plugin from cache
+if [ "$CACHE_EXISTS" = true ]; then
   echo ""
-  echo "Removing MCP server..."
-  claude mcp remove laminark -s user 2>/dev/null || true
-  echo "✓ MCP server removed"
+  echo "Removing plugin from cache..."
+  rm -rf "$CLAUDE_HOME/plugins/cache/laminark"
+  echo "✓ Plugin cache removed"
 fi
 
-# Step 2: Remove hooks from settings.json
-echo ""
-echo "Removing hooks from settings..."
-SETTINGS_FILE="${CLAUDE_HOME:-$HOME/.claude}/settings.json"
+# Step 2: Remove from installed_plugins.json
+INSTALLED_FILE="$CLAUDE_HOME/plugins/installed_plugins.json"
+if [ -f "$INSTALLED_FILE" ]; then
+  node -e '
+const fs = require("fs");
+const path = process.argv[1];
+let data = JSON.parse(fs.readFileSync(path, "utf8"));
+delete data.plugins.laminark;
+fs.writeFileSync(path, JSON.stringify(data, null, 2) + "\n");
+' "$INSTALLED_FILE" 2>/dev/null || true
+  echo "✓ Plugin registration removed"
+fi
 
+# Step 3: Remove from settings
+SETTINGS_FILE="$CLAUDE_HOME/settings.json"
 if [ -f "$SETTINGS_FILE" ]; then
+  echo ""
+  echo "Cleaning up settings..."
   node -e '
 const fs = require("fs");
 const settingsPath = process.argv[1];
-
 const settings = JSON.parse(fs.readFileSync(settingsPath, "utf8"));
 
+// Remove enabledPlugins entry
+if (settings.enabledPlugins) {
+  for (const key of Object.keys(settings.enabledPlugins)) {
+    if (key.includes("laminark")) {
+      delete settings.enabledPlugins[key];
+    }
+  }
+  if (Object.keys(settings.enabledPlugins).length === 0) {
+    delete settings.enabledPlugins;
+  }
+}
+
+// Remove any legacy manual hooks
 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];
-    }
+// Remove legacy MCP registration
+if (settings.mcpServers && settings.mcpServers.laminark) {
+  delete settings.mcpServers.laminark;
+  if (Object.keys(settings.mcpServers).length === 0) {
+    delete settings.mcpServers;
   }
 }
 
 fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n");
 ' "$SETTINGS_FILE"
-  echo "✓ Hooks removed"
+  echo "✓ Settings cleaned up"
+fi
+
+# Step 4: Remove legacy MCP registration if present
+if command -v claude &> /dev/null; then
+  if claude mcp list 2>/dev/null | grep -q "^laminark:"; then
+    claude mcp remove laminark -s user 2>/dev/null || true
+    echo "✓ Legacy MCP registration removed"
+  fi
 fi
 
-# Step 3: Uninstall npm package
+# Step 5: Uninstall npm package
 if [ -n "$NPM_VERSION" ]; then
   echo ""
   echo "Uninstalling npm package..."
@@ -95,7 +120,7 @@ if [ -n "$NPM_VERSION" ]; then
   echo "✓ npm package removed"
 fi
 
-# Step 4: Optional data cleanup
+# Step 6: Optional data cleanup
 echo ""
 echo "Data cleanup options:"
 echo "  1. Keep all data (can reinstall later without losing memories)"
@@ -106,19 +131,21 @@ 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"
+    # Check both possible data locations
+    for DATA_DIR in "$HOME/.laminark" "$CLAUDE_HOME/plugins/cache/laminark"; do
+      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
-    fi
+    done
     ;;
   *)
     echo "Keeping all data."
@@ -128,6 +155,6 @@ esac
 echo ""
 echo "✓ Uninstall complete!"
 echo ""
-echo "To reinstall: npm install -g laminark && ./plugin/scripts/install.sh"
+echo "To reinstall: curl -fsSL https://raw.githubusercontent.com/NoobyNull/Laminark/master/plugin/scripts/install.sh | bash"
 
 exit 0

package/plugin/scripts/update.sh

@@ -1,5 +1,6 @@
 #!/bin/bash
-# Update Laminark to the latest version via npm
+# Update Laminark to the latest version
+# Updates the npm package and uses the plugin system to refresh the cache
 
 set -e
 
@@ -7,6 +8,8 @@ echo "Laminark Updater"
 echo "================"
 echo ""
 
+CLAUDE_HOME="${CLAUDE_HOME:-$HOME/.claude}"
+
 # Check if npm is available
 if ! command -v npm &> /dev/null; then
   echo "Error: npm not found"
@@ -23,16 +26,38 @@ fi
 
 echo "Currently installed: v$CURRENT_VERSION"
 echo ""
-echo "Updating..."
+echo "Updating npm package..."
 npm update -g laminark
 
 NEW_VERSION=$(npm list -g laminark --depth=0 2>/dev/null | grep laminark@ | sed 's/.*@//' || echo "unknown")
-echo ""
+
 if [ "$CURRENT_VERSION" = "$NEW_VERSION" ]; then
   echo "✓ Already at latest version: v$NEW_VERSION"
 else
-  echo "✓ Updated: v$CURRENT_VERSION → v$NEW_VERSION"
+  echo "✓ npm updated: v$CURRENT_VERSION → v$NEW_VERSION"
+
+  # Update via plugin system if marketplace is registered
+  if command -v claude &> /dev/null; then
+    echo ""
+    echo "Updating plugin cache..."
+
+    # Update the marketplace to pick up new version
+    claude plugin marketplace update laminark 2>/dev/null || true
+
+    # Update the plugin via the official system
+    claude plugin update laminark@laminark 2>/dev/null || {
+      # Fallback: uninstall and reinstall
+      claude plugin uninstall laminark@laminark 2>/dev/null || true
+      claude plugin install laminark@laminark 2>/dev/null || true
+    }
+
+    echo "✓ Plugin cache updated to v$NEW_VERSION"
+  fi
 fi
+
+# CLAUDE.md instructions are auto-updated on next MCP server start
+# (handled by ensure-deps.sh — no manual step needed)
+
 echo ""
 echo "Restart your Claude Code session for changes to take effect."