laminark 2.21.7 → 2.21.9

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

@@ -1,5 +1,23 @@
 # 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.
@@ -34,7 +52,7 @@ When starting a **new phase** or **milestone**, manually run:
 
 Then commit and push:
 ```bash
-git add package.json .claude-plugin/plugin.json .claude-plugin/marketplace.json
+git add package.json
 git commit -m "chore: bump to vX.Y.0 for phase Z"
 git push
 ```

package/plugin/scripts/bump-version.sh

@@ -1,44 +1,49 @@
 #!/bin/bash
-# Bump version using MILESTONE.PHASE.SEQUENTIAL format
-# Usage: ./scripts/bump-version.sh [patch|phase|milestone]
+# Bump version using standard semver (patch | minor | major)
+# Usage: ./plugin/scripts/bump-version.sh [patch|minor|major]
 #
 # 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)
+#   ./plugin/scripts/bump-version.sh patch   # 0.1.0 -> 0.1.1 (default)
+#   ./plugin/scripts/bump-version.sh minor   # 0.1.0 -> 0.2.0
+#   ./plugin/scripts/bump-version.sh major   # 0.1.0 -> 1.0.0
 
 set -euo pipefail
 SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
-ROOT="$SCRIPT_DIR/.."
+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"
+IFS='.' read -r MAJOR MINOR PATCH <<< "$CURRENT"
 
-# Determine next version based on bump type
 case "$BUMP_TYPE" in
   patch)
-    NEXT="$MILESTONE.$PHASE.$((SEQUENTIAL + 1))"
+    NEXT="$MAJOR.$MINOR.$((PATCH + 1))"
     ;;
-  phase)
-    NEXT="$MILESTONE.$((PHASE + 1)).0"
+  minor)
+    NEXT="$MAJOR.$((MINOR + 1)).0"
     ;;
-  milestone)
-    NEXT="$((MILESTONE + 1)).$((PHASE + 1)).0"
+  major)
+    NEXT="$((MAJOR + 1)).0.0"
     ;;
   *)
-    echo "Error: Invalid bump type '$BUMP_TYPE'. Use: patch, phase, or milestone" >&2
+    echo "Error: Invalid bump type '$BUMP_TYPE'. Use: patch, minor, or major" >&2
     exit 1
     ;;
 esac
 
-# Update version in all files
-sed -i "s/\"version\": \"$CURRENT\"/\"version\": \"$NEXT\"/" \
+# Update version in all files that track it
+for file in \
   "$ROOT/package.json" \
-  "$ROOT/.claude-plugin/plugin.json" \
+  "$ROOT/package-lock.json" \
+  "$ROOT/plugin/package.json" \
+  "$ROOT/plugin/.claude-plugin/plugin.json" \
   "$ROOT/.claude-plugin/marketplace.json"
+do
+  if [ -f "$file" ]; then
+    sed -i "s/\"version\": \"$CURRENT\"/\"version\": \"$NEXT\"/" "$file"
+  fi
+done
 
-echo "$NEXT"
+echo "Bumped $CURRENT -> $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

@@ -1,11 +1,14 @@
 #!/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" ]; then
+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"
-  TMPDIR="$NPM_TMP" npm install --prefix "$PLUGIN_ROOT" --production --silent --cache "$NPM_TMP/cache" 2>/dev/null
+  # 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"

package/plugin/scripts/install.sh

@@ -1,18 +1,34 @@
 #!/bin/bash
-# Bootstrap installer for Laminark plugin.
-# Works around EXDEV (cross-device rename) errors on btrfs subvolumes,
-# separate /tmp partitions, and other cross-device setups.
+# Install Laminark via npm + MCP server registration
+# Fully standalone — no git clone required.
 #
-# Usage: curl -fsSL <raw-url> | bash
-#   or:  ./scripts/install.sh
+# Usage: curl -fsSL https://raw.githubusercontent.com/NoobyNull/Laminark/master/plugin/scripts/install.sh | bash
+#   or:  ./plugin/scripts/install.sh
 
 set -e
 
-echo "Laminark Marketplace Installer"
-echo "==============================="
+echo "Laminark Installer"
+echo "=================="
 echo ""
 
-# Check if claude CLI is available
+# 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"
@@ -20,44 +36,104 @@ if ! command -v claude &> /dev/null; then
 fi
 
 # 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")
+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 ""
-  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
+  echo "Reinstalling..."
 fi
 
-# Set up TMPDIR to avoid EXDEV errors
-CLAUDE_DIR="${CLAUDE_HOME:-$HOME/.claude}"
-SAFE_TMP="$CLAUDE_DIR/tmp"
+# 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 "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 "✓ Laminark installed successfully! (v$NEW_VERSION)"
+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 "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 "  Install: claude plugin add gsd"
+  echo "  More info: https://github.com/gsd-framework/gsd"
   echo ""
-  echo "✗ Installation failed with exit code $STATUS"
-  exit $STATUS
+  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

@@ -1,9 +1,8 @@
 #!/bin/bash
-# Local installation wrapper for Laminark plugin.
-# Works around EXDEV (cross-device rename) errors on btrfs subvolumes,
-# separate /tmp partitions, and other cross-device setups.
+# Local development installation for Laminark
+# Uses npm link + MCP server registration + hooks pointing at repo dist/
 #
-# Usage: ./scripts/local-install.sh [path-to-laminark]
+# Usage: ./plugin/scripts/local-install.sh [path-to-laminark]
 #   Default path: current directory (.)
 
 set -e
@@ -22,8 +21,8 @@ echo ""
 echo "Installing from: $PLUGIN_PATH"
 
 # Validate prerequisites
-if [ ! -d "$PLUGIN_PATH/dist" ]; then
-  echo "Error: dist/ directory not found in $PLUGIN_PATH"
+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
@@ -37,67 +36,103 @@ 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 to install: v$NEW_VERSION"
-else
-  NEW_VERSION="unknown"
+  echo "Version: v$NEW_VERSION"
 fi
 
-# 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 ""
-
-  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
-
-  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 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 "Creating temporary directory: $SAFE_TMP"
-mkdir -p "$SAFE_TMP"
+echo "Registering MCP server with Claude Code..."
+claude mcp add-json laminark '{"command":"laminark-server"}' -s user
+echo "✓ MCP server registered"
 
-# Run claude plugin add with TMPDIR override
-echo "Running: claude plugin add $PLUGIN_PATH"
-TMPDIR="$SAFE_TMP" claude plugin add "$PLUGIN_PATH"
-STATUS=$?
+# 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"
 
-# Clean up
-rm -rf "$SAFE_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
 
-if [ $STATUS -eq 0 ]; then
-  echo ""
-  echo "✓ Laminark plugin installed successfully!"
+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 "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 "  Install: claude plugin add gsd"
+  echo "  More info: https://github.com/gsd-framework/gsd"
   echo ""
-  echo "✗ Installation failed with exit code $STATUS"
-  exit $STATUS
+  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