laminark 2.22.2 → 2.22.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "laminark",
-  "version": "2.22.2",
+  "version": "2.22.3",
   "description": "Persistent adaptive memory for Claude Code",
   "type": "module",
   "bin": {

package/plugin/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "laminark",
   "description": "Persistent adaptive memory for Claude Code. Automatic observation capture, semantic search, topic detection, knowledge graph, and web visualization.",
-  "version": "2.22.2",
+  "version": "2.22.3",
   "author": {
     "name": "NoobyNull"
   },

package/plugin/scripts/install.sh

@@ -1,8 +1,8 @@
 #!/bin/bash
 # Install Laminark as a Claude Code plugin
 #
-# Installs the npm package globally, registers it as a marketplace,
-# then installs the plugin through the official Claude Code plugin system.
+# Downloads from npm and directly populates the plugin cache.
+# Registers the marketplace and plugin metadata so Claude Code recognizes it.
 #
 # Usage: curl -fsSL https://raw.githubusercontent.com/NoobyNull/Laminark/master/plugin/scripts/install.sh | bash
 #   or:  ./plugin/scripts/install.sh
@@ -31,43 +31,58 @@ if ! command -v npm &> /dev/null; then
   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"
+CLAUDE_HOME="${CLAUDE_HOME:-$HOME/.claude}"
+CACHE_BASE="$CLAUDE_HOME/plugins/cache/laminark"
+MARKETPLACE_BASE="$CLAUDE_HOME/plugins/marketplaces/laminark"
+
+# Step 1: Download the package to a temp dir
+echo "Fetching latest version from npm..."
+LATEST_VERSION=$(npm view laminark version 2>/dev/null || echo "")
+if [ -z "$LATEST_VERSION" ]; then
+  echo "Error: could not fetch version from npm"
   exit 1
 fi
+echo "  Version: $LATEST_VERSION"
 
-# 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
+WORK_DIR=$(mktemp -d)
+trap 'rm -rf "$WORK_DIR"' EXIT
 
-# Step 1: Install via npm (gets the files onto disk)
-echo ""
-echo "Installing laminark globally via npm..."
-npm install -g laminark
-echo "✓ npm package installed"
+npm pack laminark@"$LATEST_VERSION" --pack-destination "$WORK_DIR" --silent 2>/dev/null
+TARBALL=$(ls "$WORK_DIR"/laminark-*.tgz 2>/dev/null | head -1)
+if [ -z "$TARBALL" ]; then
+  echo "Error: failed to download package"
+  exit 1
+fi
 
-# Step 2: Locate the installed package
-NPM_GLOBAL_ROOT=$(npm root -g)
-LAMINARK_ROOT="$NPM_GLOBAL_ROOT/laminark"
+tar xzf "$TARBALL" -C "$WORK_DIR"
+PKG_ROOT="$WORK_DIR/package"
+EXTRACTED="$PKG_ROOT/plugin"
 
-if [ ! -d "$LAMINARK_ROOT/plugin" ]; then
-  echo "Error: Plugin directory not found at $LAMINARK_ROOT/plugin"
-  echo "npm install may have failed."
+if [ ! -d "$EXTRACTED" ]; then
+  echo "Error: plugin directory not found in package"
   exit 1
 fi
+echo "  Downloaded."
 
-NEW_VERSION=$(node -e "console.log(require('$LAMINARK_ROOT/package.json').version)")
-echo "  Version: $NEW_VERSION"
+# Step 2: Install dependencies
+echo ""
+echo "Installing dependencies..."
+NPM_TMP="$WORK_DIR/npm-tmp"
+mkdir -p "$NPM_TMP"
+TMPDIR="$NPM_TMP" npm install --prefix "$EXTRACTED" --omit=dev --ignore-scripts --silent --cache "$NPM_TMP/cache" 2>/dev/null
+npm rebuild --prefix "$EXTRACTED" better-sqlite3 --silent 2>/dev/null
+rm -rf "$NPM_TMP"
+
+# Verify the handler loads
+if ! (cd "$EXTRACTED" && node -e "import('./dist/hooks/handler.js')" 2>/dev/null); then
+  echo "Error: handler verification failed"
+  exit 1
+fi
+echo "  Dependencies verified."
 
 # Step 3: Remove legacy installations
-CLAUDE_HOME="${CLAUDE_HOME:-$HOME/.claude}"
 SETTINGS_FILE="$CLAUDE_HOME/settings.json"
 
-# Remove legacy manual hooks and MCP registrations from settings
 if [ -f "$SETTINGS_FILE" ]; then
   node -e '
 const fs = require("fs");
@@ -108,44 +123,95 @@ if (settings.mcpServers && settings.mcpServers.laminark) {
 
 if (changed) {
   fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n");
-  console.log("✓ Removed legacy hooks/MCP from settings");
+  console.log("  Removed legacy hooks/MCP from settings");
 }
 ' "$SETTINGS_FILE"
 fi
 
-# Remove legacy MCP server registration
-if claude mcp list 2>/dev/null | grep -q "^laminark:"; then
-  echo "Removing legacy MCP server registration..."
-  claude mcp remove laminark -s user 2>/dev/null || true
-  echo "✓ Legacy MCP registration removed"
-fi
-
-# Step 4: Register the npm package as a marketplace source
+# Step 4: Populate the plugin cache directly
 echo ""
-echo "Registering laminark marketplace..."
+echo "Installing to plugin cache..."
 
-# Remove existing marketplace registration to force re-add
-claude plugin marketplace remove laminark 2>/dev/null || true
-claude plugin marketplace add "$LAMINARK_ROOT"
-echo "✓ Marketplace registered"
+PLUGIN_CACHE="$CACHE_BASE/laminark/$LATEST_VERSION"
 
-# Step 5: Install the plugin via Claude Code's plugin system
-echo ""
-echo "Installing plugin..."
+# Remove any existing cache for this version
+rm -rf "$PLUGIN_CACHE"
+mkdir -p "$PLUGIN_CACHE"
+
+# Copy everything from the extracted plugin
+cp -a "$EXTRACTED/." "$PLUGIN_CACHE/"
+
+# Write sentinel — deps are already verified
+echo "$LATEST_VERSION" > "$PLUGIN_CACHE/.deps-ok"
+
+# Remove orphan marker if present
+rm -f "$PLUGIN_CACHE/.orphaned_at"
 
-# Uninstall first to avoid conflicts
-claude plugin uninstall laminark@laminark 2>/dev/null || true
-claude plugin install laminark@laminark
-echo "✓ Plugin installed"
+echo "  Cache populated."
 
-# Step 6: CLAUDE.md instructions are auto-provisioned on first MCP server start
-# (handled by ensure-deps.sh — no manual step needed)
+# Step 5: Set up the marketplace source
+echo "Setting up marketplace..."
+
+# Create marketplace structure
+mkdir -p "$MARKETPLACE_BASE/.claude-plugin"
+mkdir -p "$MARKETPLACE_BASE/plugin"
+
+# Copy plugin files to marketplace (without node_modules — the cache has them)
+rsync -a --exclude node_modules "$EXTRACTED/" "$MARKETPLACE_BASE/plugin/" 2>/dev/null || cp -a "$EXTRACTED/." "$MARKETPLACE_BASE/plugin/"
+
+# Write marketplace.json
+cat > "$MARKETPLACE_BASE/.claude-plugin/marketplace.json" << MKJSON
+{
+  "name": "laminark",
+  "owner": {
+    "name": "NoobyNull"
+  },
+  "plugins": [
+    {
+      "name": "laminark",
+      "source": "./plugin",
+      "description": "Persistent adaptive memory for Claude Code. Automatic observation capture, semantic search, topic detection, knowledge graph, and web visualization.",
+      "version": "$LATEST_VERSION",
+      "category": "productivity"
+    }
+  ]
+}
+MKJSON
+
+# Copy repo-level files the marketplace expects
+for f in .gitignore README.md CHANGELOG.md tsconfig.json package.json package-lock.json; do
+  if [ -f "$PKG_ROOT/$f" ]; then
+    cp "$PKG_ROOT/$f" "$MARKETPLACE_BASE/$f" 2>/dev/null || true
+  fi
+done
+
+echo "  Marketplace registered."
+
+# Step 6: Register with Claude Code's plugin system (if CLI available and not nested)
+if command -v claude &> /dev/null && [ -z "$CLAUDECODE" ]; then
+  echo ""
+  echo "Registering with Claude Code..."
+  claude plugin marketplace remove laminark 2>/dev/null || true
+  claude plugin marketplace add "$MARKETPLACE_BASE" 2>/dev/null || true
+  claude plugin uninstall laminark@laminark 2>/dev/null || true
+  claude plugin install laminark@laminark 2>/dev/null || true
+  echo "  Registered."
+fi
+
+# Clean up old version caches
+if [ -d "$CACHE_BASE/laminark" ]; then
+  for OLD_DIR in "$CACHE_BASE/laminark"/*/; do
+    OLD_VER=$(basename "$OLD_DIR")
+    if [ "$OLD_VER" != "$LATEST_VERSION" ] && [ -d "$OLD_DIR" ]; then
+      rm -rf "$OLD_DIR"
+      echo "  Removed old cache: v$OLD_VER"
+    fi
+  done
+fi
 
 # Done
 echo ""
-echo "✓ Laminark v$NEW_VERSION installed successfully!"
-echo ""
-echo "The plugin system now manages hooks, MCP server, and skills automatically."
+echo "Laminark v$LATEST_VERSION installed successfully!"
 echo ""
 echo "Next steps:"
 echo "  1. Start a new Claude Code session"
@@ -173,7 +239,7 @@ if [ "$GSD_INSTALLED" = false ]; 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)"
+      claude plugin add gsd 2>/dev/null && echo "  GSD installed" || echo "  GSD install skipped (install manually with: claude plugin add gsd)"
     fi
   fi
 fi

package/plugin/scripts/update.sh

@@ -1,63 +1,154 @@
 #!/bin/bash
 # Update Laminark to the latest version
-# Updates the npm package and uses the plugin system to refresh the cache
+#
+# Downloads the latest npm package and directly updates the plugin cache.
+# Works from inside a Claude Code session (no `claude plugin` commands needed).
+#
+# Usage: bash /path/to/update.sh
+#   or via ensure-deps.sh auto-update check
 
 set -e
 
-echo "Laminark Updater"
-echo "================"
-echo ""
-
 CLAUDE_HOME="${CLAUDE_HOME:-$HOME/.claude}"
+CACHE_BASE="$CLAUDE_HOME/plugins/cache/laminark/laminark"
+MARKETPLACE_BASE="$CLAUDE_HOME/plugins/marketplaces/laminark"
+
+log() { echo "  $1"; }
 
-# Check if npm is available
+# Check prerequisites
+if ! command -v node &> /dev/null; then
+  echo "Error: node not found"
+  exit 1
+fi
 if ! command -v npm &> /dev/null; then
   echo "Error: npm not found"
   exit 1
 fi
 
-# Check if installed
-CURRENT_VERSION=$(npm list -g laminark --depth=0 2>/dev/null | grep laminark@ | sed 's/.*@//' || echo "")
+echo "Laminark Updater"
+echo "================"
+echo ""
+
+# Detect current installed version from cache
+CURRENT_VERSION=""
+if [ -d "$CACHE_BASE" ]; then
+  CURRENT_VERSION=$(ls -1 "$CACHE_BASE" 2>/dev/null | sort -V | tail -1)
+fi
+
 if [ -z "$CURRENT_VERSION" ]; then
-  echo "Laminark is not installed globally."
-  echo "Run: ./plugin/scripts/install.sh"
+  echo "No cached installation found. Run the installer first."
   exit 1
 fi
 
-echo "Currently installed: v$CURRENT_VERSION"
+echo "Installed: v$CURRENT_VERSION"
+
+# Check latest version on npm
+LATEST_VERSION=$(npm view laminark version 2>/dev/null || echo "")
+if [ -z "$LATEST_VERSION" ]; then
+  echo "Could not check npm for latest version (offline?)"
+  exit 1
+fi
+
+echo "Latest:    v$LATEST_VERSION"
 echo ""
-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")
+if [ "$CURRENT_VERSION" = "$LATEST_VERSION" ]; then
+  echo "Already on the latest version."
+  exit 0
+fi
 
-if [ "$CURRENT_VERSION" = "$NEW_VERSION" ]; then
-  echo "✓ Already at latest version: v$NEW_VERSION"
-else
-  echo "✓ npm updated: v$CURRENT_VERSION → v$NEW_VERSION"
+# Download and extract the latest package to a temp dir
+WORK_DIR=$(mktemp -d)
+trap 'rm -rf "$WORK_DIR"' EXIT
 
-  # Update via plugin system if marketplace is registered
-  if command -v claude &> /dev/null; then
-    echo ""
-    echo "Updating plugin cache..."
+echo "Downloading v$LATEST_VERSION..."
+npm pack laminark@"$LATEST_VERSION" --pack-destination "$WORK_DIR" --silent 2>/dev/null
+TARBALL=$(ls "$WORK_DIR"/laminark-*.tgz 2>/dev/null | head -1)
+if [ -z "$TARBALL" ]; then
+  echo "Error: failed to download package"
+  exit 1
+fi
+
+tar xzf "$TARBALL" -C "$WORK_DIR"
+EXTRACTED="$WORK_DIR/package/plugin"
 
-    # Update the marketplace to pick up new version
-    claude plugin marketplace update laminark 2>/dev/null || true
+if [ ! -d "$EXTRACTED" ]; then
+  echo "Error: plugin directory not found in package"
+  exit 1
+fi
+
+# Install dependencies in the extracted plugin dir
+log "Installing dependencies..."
+NPM_TMP="$WORK_DIR/npm-tmp"
+mkdir -p "$NPM_TMP"
+TMPDIR="$NPM_TMP" npm install --prefix "$EXTRACTED" --omit=dev --ignore-scripts --silent --cache "$NPM_TMP/cache" 2>/dev/null
+npm rebuild --prefix "$EXTRACTED" better-sqlite3 --silent 2>/dev/null
+rm -rf "$NPM_TMP"
+
+# Verify the handler loads before replacing the cache
+if ! (cd "$EXTRACTED" && node -e "import('./dist/hooks/handler.js')" 2>/dev/null); then
+  echo "Error: handler verification failed after dependency install"
+  echo "The downloaded package may be broken. Aborting."
+  exit 1
+fi
 
-    # 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
-    }
+log "Handler verified."
 
-    echo "✓ Plugin cache updated to v$NEW_VERSION"
+# Create the new cache directory
+NEW_CACHE="$CACHE_BASE/$LATEST_VERSION"
+mkdir -p "$NEW_CACHE"
+
+# Preserve data that lives in the cache (db, repair log)
+# The actual DB lives at cache/laminark/data/data.db — not version-specific
+OLD_CACHE="$CACHE_BASE/$CURRENT_VERSION"
+
+# Copy the new plugin files (everything except node_modules, which we copy separately)
+log "Updating cache..."
+rsync -a --delete \
+  --exclude node_modules \
+  --exclude .deps-ok \
+  --exclude .repair-log \
+  --exclude .orphaned_at \
+  --exclude laminark.db \
+  "$EXTRACTED/" "$NEW_CACHE/"
+
+# Copy node_modules (with working deps)
+rsync -a --delete "$EXTRACTED/node_modules/" "$NEW_CACHE/node_modules/"
+
+# Write sentinel — deps are already verified
+echo "$LATEST_VERSION" > "$NEW_CACHE/.deps-ok"
+
+# Update the marketplace source if it exists
+if [ -d "$MARKETPLACE_BASE/plugin" ]; then
+  rsync -a --delete \
+    --exclude node_modules \
+    "$EXTRACTED/" "$MARKETPLACE_BASE/plugin/"
+  # Update marketplace.json version
+  if [ -f "$MARKETPLACE_BASE/.claude-plugin/marketplace.json" ]; then
+    node -e '
+const fs = require("fs");
+const p = process.argv[1];
+const v = process.argv[2];
+try {
+  const m = JSON.parse(fs.readFileSync(p, "utf8"));
+  if (m.plugins) m.plugins.forEach(p => p.version = v);
+  fs.writeFileSync(p, JSON.stringify(m, null, 2) + "\n");
+} catch {}
+' "$MARKETPLACE_BASE/.claude-plugin/marketplace.json" "$LATEST_VERSION"
   fi
 fi
 
-# CLAUDE.md instructions are auto-updated on next MCP server start
-# (handled by ensure-deps.sh — no manual step needed)
+# Clean up old version cache (if different)
+if [ "$CURRENT_VERSION" != "$LATEST_VERSION" ] && [ -d "$OLD_CACHE" ]; then
+  rm -rf "$OLD_CACHE"
+  log "Removed old cache (v$CURRENT_VERSION)"
+fi
+
+# Remove orphan marker if present
+rm -f "$NEW_CACHE/.orphaned_at"
 
+echo ""
+echo "Updated: v$CURRENT_VERSION → v$LATEST_VERSION"
 echo ""
 echo "Restart your Claude Code session for changes to take effect."
 

package/plugin/.repair-log

@@ -1,6 +0,0 @@
-[2026-02-25T06:54:01-08:00] doctor: Reinstalling dependencies...
-[2026-02-25T06:54:07-08:00] doctor: Rebuilding better-sqlite3 native addon...
-[2026-02-26T06:51:30-08:00] ensure-deps: Appended Laminark instructions to /home/matthew/.claude/CLAUDE.md (laminark:instructions:v1)
-[2026-02-26T06:52:32-08:00] ensure-deps: Created /home/matthew/.claude/CLAUDE.md with Laminark instructions (laminark:instructions:v1)
-[2026-02-26T06:52:38-08:00] ensure-deps: Appended Laminark instructions to /tmp/test-claude-home/CLAUDE.md (laminark:instructions:v1)
-[2026-02-26T06:52:46-08:00] ensure-deps: Updated Laminark instructions in /tmp/test-claude-home/CLAUDE.md (laminark:instructions:v0 -> laminark:instructions:v1)

package/plugin/node_modules/.bin/node-which

@@ -1,52 +0,0 @@
-#!/usr/bin/env node
-var which = require("../")
-if (process.argv.length < 3)
-  usage()
-
-function usage () {
-  console.error('usage: which [-as] program ...')
-  process.exit(1)
-}
-
-var all = false
-var silent = false
-var dashdash = false
-var args = process.argv.slice(2).filter(function (arg) {
-  if (dashdash || !/^-/.test(arg))
-    return true
-
-  if (arg === '--') {
-    dashdash = true
-    return false
-  }
-
-  var flags = arg.substr(1).split('')
-  for (var f = 0; f < flags.length; f++) {
-    var flag = flags[f]
-    switch (flag) {
-      case 's':
-        silent = true
-        break
-      case 'a':
-        all = true
-        break
-      default:
-        console.error('which: illegal option -- ' + flag)
-        usage()
-    }
-  }
-  return false
-})
-
-process.exit(args.reduce(function (pv, current) {
-  try {
-    var f = which.sync(current, { all: all })
-    if (all)
-      f = f.join('\n')
-    if (!silent)
-      console.log(f)
-    return pv;
-  } catch (e) {
-    return 1;
-  }
-}, 0))

package/plugin/node_modules/.bin/prebuild-install

@@ -1,78 +0,0 @@
-#!/usr/bin/env node
-
-const path = require('path')
-const fs = require('fs')
-const napi = require('napi-build-utils')
-
-const pkg = require(path.resolve('package.json'))
-const rc = require('./rc')(pkg)
-const log = require('./log')(rc, process.env)
-const download = require('./download')
-const asset = require('./asset')
-const util = require('./util')
-
-const prebuildClientVersion = require('./package.json').version
-if (rc.version) {
-  console.log(prebuildClientVersion)
-  process.exit(0)
-}
-
-if (rc.path) process.chdir(rc.path)
-
-if (rc.runtime === 'electron' && rc.target[0] === '4' && rc.abi === '64') {
-  log.error(`Electron version ${rc.target} found - skipping prebuild-install work due to known ABI issue`)
-  log.error('More information about this issue can be found at https://github.com/lgeiger/node-abi/issues/54')
-  process.exit(1)
-}
-
-if (!fs.existsSync('package.json')) {
-  log.error('setup', 'No package.json found. Aborting...')
-  process.exit(1)
-}
-
-if (rc.help) {
-  console.error(fs.readFileSync(path.join(__dirname, 'help.txt'), 'utf-8'))
-  process.exit(0)
-}
-
-log.info('begin', 'Prebuild-install version', prebuildClientVersion)
-
-const opts = Object.assign({}, rc, { pkg: pkg, log: log })
-
-if (napi.isNapiRuntime(rc.runtime)) napi.logUnsupportedVersion(rc.target, log)
-
-const origin = util.packageOrigin(process.env, pkg)
-
-if (opts.force) {
-  log.warn('install', 'prebuilt binaries enforced with --force!')
-  log.warn('install', 'prebuilt binaries may be out of date!')
-} else if (origin && origin.length > 4 && origin.substr(0, 4) === 'git+') {
-  log.info('install', 'installing from git repository, skipping download.')
-  process.exit(1)
-} else if (opts.buildFromSource) {
-  log.info('install', '--build-from-source specified, not attempting download.')
-  process.exit(1)
-}
-
-const startDownload = function (downloadUrl) {
-  download(downloadUrl, opts, function (err) {
-    if (err) {
-      log.warn('install', err.message)
-      return process.exit(1)
-    }
-    log.info('install', 'Successfully installed prebuilt binary!')
-  })
-}
-
-if (opts.token) {
-  asset(opts, function (err, assetId) {
-    if (err) {
-      log.warn('install', err.message)
-      return process.exit(1)
-    }
-
-    startDownload(util.getAssetUrl(opts, assetId))
-  })
-} else {
-  startDownload(util.getDownloadUrl(opts))
-}

package/plugin/node_modules/.bin/rc

@@ -1,4 +0,0 @@
-#! /usr/bin/env node
-var rc = require('./index')
-
-console.log(JSON.stringify(rc(process.argv[2]), false, 2))