laminark 0.1.0 → 2.21.7

package/plugin/scripts/install.sh

@@ -1,34 +1,18 @@
 #!/bin/bash
-# Install Laminark via npm + MCP server registration
-# Fully standalone — no git clone required.
+# Bootstrap installer for Laminark plugin.
+# Works around EXDEV (cross-device rename) errors on btrfs subvolumes,
+# separate /tmp partitions, and other cross-device setups.
 #
-# Usage: curl -fsSL https://raw.githubusercontent.com/NoobyNull/Laminark/master/plugin/scripts/install.sh | bash
-#   or:  ./plugin/scripts/install.sh
+# Usage: curl -fsSL <raw-url> | bash
+#   or:  ./scripts/install.sh
 
 set -e
 
-echo "Laminark Installer"
-echo "=================="
+echo "Laminark Marketplace 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
-
+# Check if claude CLI is available
 if ! command -v claude &> /dev/null; then
   echo "Error: claude CLI not found"
   echo "Please install Claude Code first: https://claude.com/claude-code"
@@ -36,104 +20,44 @@ if ! command -v claude &> /dev/null; then
 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
+if claude plugin list 2>/dev/null | grep -q "laminark"; then
+  CURRENT_VERSION=$(claude plugin list 2>/dev/null | grep "laminark" | awk '{print $2}' || echo "unknown")
   echo "Currently installed: v$CURRENT_VERSION"
-  echo "Reinstalling..."
+  echo ""
+  read -p "Update/reinstall? (Y/n): " -n 1 -r
+  echo ""
+  if [[ $REPLY =~ ^[Nn]$ ]]; then
+    echo "Installation cancelled."
+    exit 0
+  fi
+  echo "Removing existing installation..."
+  claude plugin remove laminark 2>/dev/null || true
 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"
+# Set up TMPDIR to avoid EXDEV errors
+CLAUDE_DIR="${CLAUDE_HOME:-$HOME/.claude}"
+SAFE_TMP="$CLAUDE_DIR/tmp"
 
-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 "Installing Laminark from marketplace..."
+mkdir -p "$SAFE_TMP"
+TMPDIR="$SAFE_TMP" claude plugin install laminark
+STATUS=$?
+rm -rf "$SAFE_TMP"
+
+if [ $STATUS -eq 0 ]; then
+  NEW_VERSION=$(claude plugin list 2>/dev/null | grep "laminark" | awk '{print $2}' || echo "unknown")
   echo ""
-  echo "  Install: claude plugin add gsd"
-  echo "  More info: https://github.com/gsd-framework/gsd"
+  echo "✓ Laminark installed successfully! (v$NEW_VERSION)"
   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
+  echo "Next steps:"
+  echo "  1. Enable the plugin: claude plugin enable laminark"
+  echo "  2. Start a new Claude Code session"
+  echo "  3. Verify with: /mcp (should show laminark tools)"
+else
+  echo ""
+  echo "✗ Installation failed with exit code $STATUS"
+  exit $STATUS
 fi
 
 exit 0

package/plugin/scripts/local-install.sh

@@ -1,8 +1,9 @@
 #!/bin/bash
-# Local development installation for Laminark
-# Uses npm link + MCP server registration + hooks pointing at repo dist/
+# Local installation wrapper for Laminark plugin.
+# Works around EXDEV (cross-device rename) errors on btrfs subvolumes,
+# separate /tmp partitions, and other cross-device setups.
 #
-# Usage: ./plugin/scripts/local-install.sh [path-to-laminark]
+# Usage: ./scripts/local-install.sh [path-to-laminark]
 #   Default path: current directory (.)
 
 set -e
@@ -21,8 +22,8 @@ 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"
+if [ ! -d "$PLUGIN_PATH/dist" ]; then
+  echo "Error: dist/ directory not found in $PLUGIN_PATH"
   echo "Please run 'npm install && npm run build' first"
   exit 1
 fi
@@ -36,103 +37,67 @@ 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"
+  echo "Version to install: v$NEW_VERSION"
+else
+  NEW_VERSION="unknown"
 fi
 
-# Step 1: npm link from repo root
-echo ""
-echo "Linking package globally..."
-cd "$PLUGIN_PATH"
-npm link
-echo "✓ npm link complete"
+# Check if already installed
+if claude plugin list 2>/dev/null | grep -q "laminark"; then
+  CURRENT_VERSION=$(claude plugin list 2>/dev/null | grep "laminark" | awk '{print $2}' || echo "unknown")
+  echo "Currently installed: v$CURRENT_VERSION"
+  echo ""
 
-# 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"
+  if [ "$CURRENT_VERSION" = "$NEW_VERSION" ]; then
+    echo "Same version is already installed."
+    read -p "Reinstall anyway? (y/N): " -n 1 -r
+    echo ""
+    if [[ ! $REPLY =~ ^[Yy]$ ]]; then
+      echo "Installation cancelled."
+      exit 0
+    fi
+  else
+    echo "An existing version is installed."
+    read -p "Update from v$CURRENT_VERSION to v$NEW_VERSION? (Y/n): " -n 1 -r
+    echo ""
+    if [[ $REPLY =~ ^[Nn]$ ]]; then
+      echo "Installation cancelled."
+      exit 0
+    fi
+  fi
 
-# 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"
+  echo "Removing existing installation..."
+  TMPDIR="$SAFE_TMP" claude plugin remove laminark 2>/dev/null || true
+fi
+
+# Set up safe temp directory on same filesystem as ~/.claude/
+CLAUDE_DIR="${CLAUDE_HOME:-$HOME/.claude}"
+SAFE_TMP="$CLAUDE_DIR/tmp"
 
-# 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
+echo "Creating temporary directory: $SAFE_TMP"
+mkdir -p "$SAFE_TMP"
+
+# Run claude plugin add with TMPDIR override
+echo "Running: claude plugin add $PLUGIN_PATH"
+TMPDIR="$SAFE_TMP" claude plugin add "$PLUGIN_PATH"
+STATUS=$?
 
-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.)"
+# Clean up
+rm -rf "$SAFE_TMP"
+
+if [ $STATUS -eq 0 ]; then
   echo ""
-  echo "  Install: claude plugin add gsd"
-  echo "  More info: https://github.com/gsd-framework/gsd"
+  echo "✓ Laminark plugin installed successfully!"
   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
+  echo "Next steps:"
+  echo "  1. Enable the plugin: claude plugin enable laminark"
+  echo "  2. Start a new Claude Code session"
+  echo "  3. Verify with: /mcp (should show laminark tools)"
+else
+  echo ""
+  echo "✗ Installation failed with exit code $STATUS"
+  exit $STATUS
 fi
 
 exit 0

package/plugin/scripts/setup-tmpdir.sh

@@ -0,0 +1,65 @@
+#!/bin/bash
+# Set up TMPDIR globally to avoid EXDEV errors in Claude Code
+# This allows the Claude UI plugin installation to work correctly
+
+set -e
+
+echo "Claude Code TMPDIR Setup"
+echo "========================"
+echo ""
+echo "This script will configure your shell to use ~/.claude/tmp as TMPDIR,"
+echo "which prevents EXDEV errors when installing plugins via Claude's UI."
+echo ""
+
+# Create the temp directory
+CLAUDE_DIR="${CLAUDE_HOME:-$HOME/.claude}"
+TMPDIR_PATH="$CLAUDE_DIR/tmp"
+
+mkdir -p "$TMPDIR_PATH"
+echo "✓ Created directory: $TMPDIR_PATH"
+
+# Detect shell
+SHELL_NAME=$(basename "$SHELL")
+if [ "$SHELL_NAME" = "zsh" ]; then
+  PROFILE="$HOME/.zshrc"
+elif [ "$SHELL_NAME" = "bash" ]; then
+  PROFILE="$HOME/.bashrc"
+else
+  echo "Warning: Unsupported shell: $SHELL_NAME"
+  echo "Please manually add this to your shell profile:"
+  echo ""
+  echo "  export TMPDIR=\$HOME/.claude/tmp"
+  echo "  mkdir -p \$TMPDIR"
+  echo ""
+  exit 1
+fi
+
+# Check if already configured
+if grep -q "export TMPDIR.*\.claude/tmp" "$PROFILE" 2>/dev/null; then
+  echo ""
+  echo "✓ TMPDIR already configured in $PROFILE"
+else
+  echo ""
+  echo "Adding TMPDIR configuration to $PROFILE..."
+  cat >> "$PROFILE" << 'EOF'
+
+# Claude Code TMPDIR workaround for EXDEV errors
+export TMPDIR=$HOME/.claude/tmp
+mkdir -p $TMPDIR
+EOF
+  echo "✓ Added TMPDIR configuration to $PROFILE"
+fi
+
+echo ""
+echo "✓ Setup complete!"
+echo ""
+echo "Next steps:"
+echo "  1. Restart your terminal (or run: source $PROFILE)"
+echo "  2. Restart Claude Code"
+echo "  3. Try installing Laminark via Claude's UI:"
+echo "     /plugin → marketplace → NoobyNull/Laminark → install"
+echo ""
+echo "To verify TMPDIR is set, run: echo \$TMPDIR"
+echo "Expected output: $TMPDIR_PATH"
+
+exit 0

package/plugin/scripts/uninstall.sh

@@ -1,5 +1,5 @@
 #!/bin/bash
-# Uninstall Laminark: remove MCP server, hooks, and npm package
+# Uninstall Laminark plugin with optional data cleanup
 
 set -e
 
@@ -9,24 +9,20 @@ 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
+  echo "Error: claude CLI not found"
+  echo "Please install Claude Code first: https://claude.com/claude-code"
+  exit 1
 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
+# Check if plugin is installed
+if ! claude plugin list 2>/dev/null | grep -q "laminark"; then
+  echo "Laminark plugin is not installed."
+  exit 0
 fi
 
+# Get current version
+CURRENT_VERSION=$(claude plugin list 2>/dev/null | grep "laminark" | awk '{print $2}' || echo "unknown")
+echo "Currently installed: laminark v$CURRENT_VERSION"
 echo ""
 
 # Ask for confirmation
@@ -37,76 +33,42 @@ if [[ ! $REPLY =~ ^[Yy]$ ]]; then
   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
+# Remove the plugin
+echo "Removing plugin..."
+claude plugin remove laminark
+echo "✓ Plugin removed"
 
-# 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
+# Ask about 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 "  2. Remove plugin cache only (keeps user data at ~/.laminark/)"
+echo "  3. Remove everything (plugin cache + all memories and data)"
 echo ""
-read -p "Choose option (1-2, default=1): " -n 1 -r CLEANUP_OPTION
+read -p "Choose option (1-3, default=1): " -n 1 -r CLEANUP_OPTION
 echo ""
 
 case $CLEANUP_OPTION in
   2)
+    echo "Removing plugin cache..."
+    CACHE_DIR="${CLAUDE_HOME:-$HOME/.claude}/plugins/cache/laminark"
+    if [ -d "$CACHE_DIR" ]; then
+      rm -rf "$CACHE_DIR"
+      echo "✓ Plugin cache removed: $CACHE_DIR"
+    else
+      echo "  No cache directory found"
+    fi
+    ;;
+  3)
+    echo "Removing all data..."
+    CACHE_DIR="${CLAUDE_HOME:-$HOME/.claude}/plugins/cache/laminark"
     DATA_DIR="$HOME/.laminark"
+
+    if [ -d "$CACHE_DIR" ]; then
+      rm -rf "$CACHE_DIR"
+      echo "✓ Plugin cache removed: $CACHE_DIR"
+    fi
+
     if [ -d "$DATA_DIR" ]; then
       echo ""
       echo "WARNING: This will delete all your memories and observations!"
@@ -128,6 +90,6 @@ esac
 echo ""
 echo "✓ Uninstall complete!"
 echo ""
-echo "To reinstall: npm install -g laminark && ./plugin/scripts/install.sh"
+echo "To reinstall: ./scripts/local-install.sh or ./scripts/install.sh"
 
 exit 0