laminark 2.21.6

package/plugin/scripts/install.sh

@@ -0,0 +1,63 @@
+#!/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.
+#
+# Usage: curl -fsSL <raw-url> | bash
+#   or:  ./scripts/install.sh
+
+set -e
+
+echo "Laminark Marketplace Installer"
+echo "==============================="
+echo ""
+
+# 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"
+  exit 1
+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 ""
+  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
+
+# Set up TMPDIR to avoid EXDEV errors
+CLAUDE_DIR="${CLAUDE_HOME:-$HOME/.claude}"
+SAFE_TMP="$CLAUDE_DIR/tmp"
+
+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 ""
+  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

@@ -0,0 +1,103 @@
+#!/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.
+#
+# Usage: ./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/dist" ]; then
+  echo "Error: 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 to install: v$NEW_VERSION"
+else
+  NEW_VERSION="unknown"
+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"
+
+echo ""
+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=$?
+
+# Clean up
+rm -rf "$SAFE_TMP"
+
+if [ $STATUS -eq 0 ]; then
+  echo ""
+  echo "✓ Laminark plugin installed successfully!"
+  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 ""
+  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

@@ -0,0 +1,95 @@
+#!/bin/bash
+# Uninstall Laminark plugin with optional data cleanup
+
+set -e
+
+echo "Laminark Uninstaller"
+echo "===================="
+echo ""
+
+# 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"
+  exit 1
+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
+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
+
+# Remove the plugin
+echo "Removing plugin..."
+claude plugin remove laminark
+echo "✓ Plugin removed"
+
+# Ask about data cleanup
+echo ""
+echo "Data cleanup options:"
+echo "  1. Keep all data (can reinstall later without losing memories)"
+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-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!"
+      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: ./scripts/local-install.sh or ./scripts/install.sh"
+
+exit 0

package/plugin/scripts/update.sh

@@ -0,0 +1,88 @@
+#!/bin/bash
+# Update Laminark plugin to the latest version
+
+set -e
+
+echo "Laminark Update Checker"
+echo "======================="
+echo ""
+
+# 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"
+  exit 1
+fi
+
+# Check if plugin is installed
+if ! claude plugin list 2>/dev/null | grep -q "laminark"; then
+  echo "Laminark is not installed."
+  echo "Run ./scripts/install.sh to install it."
+  exit 1
+fi
+
+# Get current version
+CURRENT_VERSION=$(claude plugin list 2>/dev/null | grep "laminark" | awk '{print $2}' || echo "unknown")
+echo "Currently installed: v$CURRENT_VERSION"
+
+# Check for updates (try to get latest version from GitHub)
+echo "Checking for updates..."
+LATEST_VERSION=$(curl -fsSL https://api.github.com/repos/NoobyNull/Laminark/releases/latest 2>/dev/null | grep '"tag_name"' | sed -E 's/.*"v?([^"]+)".*/\1/' || echo "")
+
+if [ -z "$LATEST_VERSION" ]; then
+  echo "Warning: Could not check for updates (GitHub API unavailable)"
+  echo ""
+  read -p "Force reinstall anyway? (y/N): " -n 1 -r
+  echo ""
+  if [[ ! $REPLY =~ ^[Yy]$ ]]; then
+    echo "Update cancelled."
+    exit 0
+  fi
+  FORCE_UPDATE=true
+else
+  echo "Latest available: v$LATEST_VERSION"
+  echo ""
+
+  # Compare versions
+  if [ "$CURRENT_VERSION" = "$LATEST_VERSION" ]; then
+    echo "You already have the latest version!"
+    echo ""
+    read -p "Reinstall anyway? (y/N): " -n 1 -r
+    echo ""
+    if [[ ! $REPLY =~ ^[Yy]$ ]]; then
+      echo "Update cancelled."
+      exit 0
+    fi
+  fi
+fi
+
+# Set up TMPDIR to avoid EXDEV errors
+CLAUDE_DIR="${CLAUDE_HOME:-$HOME/.claude}"
+SAFE_TMP="$CLAUDE_DIR/tmp"
+mkdir -p "$SAFE_TMP"
+
+# Reinstall the plugin
+echo ""
+echo "Updating Laminark..."
+TMPDIR="$SAFE_TMP" claude plugin remove laminark 2>/dev/null || true
+TMPDIR="$SAFE_TMP" claude plugin install laminark
+STATUS=$?
+
+# Clean up
+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 updated successfully!"
+  echo "  Previous version: v$CURRENT_VERSION"
+  echo "  Current version: v$NEW_VERSION"
+  echo ""
+  echo "Restart your Claude Code session for changes to take effect."
+else
+  echo ""
+  echo "✗ Update failed with exit code $STATUS"
+  exit $STATUS
+fi
+
+exit 0

package/plugin/scripts/verify-install.sh

@@ -0,0 +1,43 @@
+#!/bin/bash
+# Verify Laminark plugin installation
+# Checks: plugin registered, enabled status, provides next steps
+
+set -e
+
+echo "Checking Laminark installation..."
+echo ""
+
+# 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"
+  exit 1
+fi
+
+# Check if plugin is registered
+if claude plugin list 2>/dev/null | grep -q "laminark"; then
+  echo "✓ Plugin registered: laminark"
+else
+  echo "✗ Plugin not registered"
+  echo "  Please run: ./scripts/local-install.sh"
+  exit 1
+fi
+
+# Check if plugin is enabled
+if claude plugin list 2>/dev/null | grep "laminark" | grep -q "enabled"; then
+  echo "✓ Plugin enabled"
+else
+  echo "⚠ Plugin registered but not enabled"
+  echo "  Run: claude plugin enable laminark"
+fi
+
+echo ""
+echo "Installation verified successfully!"
+echo ""
+echo "Next steps:"
+echo "  1. Start a new Claude Code session"
+echo "  2. Check MCP tools with: /mcp"
+echo "  3. Check hooks with: /hooks"
+echo "  4. Try searching memories with: recall"
+
+exit 0

package/plugin/ui/activity.js

@@ -0,0 +1,185 @@
+/**
+ * Laminark Activity Feed Module
+ *
+ * Listens to SSE-dispatched CustomEvents and renders a live activity feed.
+ * Max 100 items in memory, newest first. Supports clear and slide-in animation.
+ */
+
+(function () {
+  var MAX_ITEMS = 100;
+  var items = [];
+  var feedEl = null;
+
+  var EVENT_CONFIG = {
+    'laminark:new_observation': {
+      icon: '\u{1F4DD}',
+      label: 'Observation',
+      cssClass: 'activity-observation',
+      format: function (d) {
+        return d.text || (d.id ? 'Observation ' + d.id.substring(0, 8) : 'New observation');
+      },
+    },
+    'laminark:entity_updated': {
+      icon: '\u{1F9E9}',
+      label: 'Entity',
+      cssClass: 'activity-entity',
+      format: function (d) {
+        return (d.label || d.name || d.id || 'Unknown') + (d.type ? ' (' + d.type + ')' : '');
+      },
+    },
+    'laminark:topic_shift': {
+      icon: '\u{1F500}',
+      label: 'Topic Shift',
+      cssClass: 'activity-topic-shift',
+      format: function (d) {
+        var msg = 'Topic shift detected';
+        if (d.confidence != null) msg += ' (' + (d.confidence * 100).toFixed(0) + '% confidence)';
+        return msg;
+      },
+    },
+    'laminark:session_start': {
+      icon: '\u{25B6}\uFE0F',
+      label: 'Session Start',
+      cssClass: 'activity-session-start',
+      format: function (d) {
+        return 'Session started' + (d.id ? ': ' + d.id.substring(0, 8) : '');
+      },
+    },
+    'laminark:session_end': {
+      icon: '\u{23F9}\uFE0F',
+      label: 'Session End',
+      cssClass: 'activity-session-end',
+      format: function (d) {
+        return 'Session ended' + (d.id ? ': ' + d.id.substring(0, 8) : '');
+      },
+    },
+  };
+
+  function relativeTime(isoString) {
+    if (!isoString) return 'just now';
+    try {
+      var diff = Date.now() - new Date(isoString).getTime();
+      if (diff < 0) diff = 0;
+      var secs = Math.floor(diff / 1000);
+      if (secs < 60) return secs + 's ago';
+      var mins = Math.floor(secs / 60);
+      if (mins < 60) return mins + 'm ago';
+      var hrs = Math.floor(mins / 60);
+      if (hrs < 24) return hrs + 'h ago';
+      return Math.floor(hrs / 24) + 'd ago';
+    } catch (_e) {
+      return 'just now';
+    }
+  }
+
+  function createItemEl(item) {
+    var el = document.createElement('div');
+    el.className = 'activity-item ' + item.cssClass + ' activity-slide-in';
+
+    var iconSpan = document.createElement('span');
+    iconSpan.className = 'activity-icon';
+    iconSpan.textContent = item.icon;
+    el.appendChild(iconSpan);
+
+    var body = document.createElement('div');
+    body.className = 'activity-body';
+
+    var title = document.createElement('div');
+    title.className = 'activity-title';
+    title.textContent = item.label;
+    body.appendChild(title);
+
+    var desc = document.createElement('div');
+    desc.className = 'activity-desc';
+    desc.textContent = item.description;
+    body.appendChild(desc);
+
+    el.appendChild(body);
+
+    var time = document.createElement('span');
+    time.className = 'activity-time';
+    time.textContent = relativeTime(item.timestamp);
+    el.appendChild(time);
+
+    return el;
+  }
+
+  function renderFeed() {
+    if (!feedEl) return;
+
+    if (items.length === 0) {
+      feedEl.innerHTML = '<p class="empty-state">Waiting for live events...</p>';
+      return;
+    }
+
+    feedEl.innerHTML = '';
+    items.forEach(function (item) {
+      feedEl.appendChild(createItemEl(item));
+    });
+  }
+
+  function addItem(eventName, detail) {
+    var config = EVENT_CONFIG[eventName];
+    if (!config) return;
+
+    var item = {
+      icon: config.icon,
+      label: config.label,
+      cssClass: config.cssClass,
+      description: config.format(detail || {}),
+      timestamp: detail.createdAt || detail.timestamp || new Date().toISOString(),
+    };
+
+    items.unshift(item);
+    if (items.length > MAX_ITEMS) {
+      items = items.slice(0, MAX_ITEMS);
+    }
+
+    // If feed is visible, prepend DOM element directly for performance
+    if (feedEl) {
+      // Remove empty state if present
+      var empty = feedEl.querySelector('.empty-state');
+      if (empty) empty.remove();
+
+      var el = createItemEl(item);
+      if (feedEl.firstChild) {
+        feedEl.insertBefore(el, feedEl.firstChild);
+      } else {
+        feedEl.appendChild(el);
+      }
+
+      // Trim excess DOM nodes
+      while (feedEl.children.length > MAX_ITEMS) {
+        feedEl.removeChild(feedEl.lastChild);
+      }
+    }
+  }
+
+  function clearFeed() {
+    items = [];
+    renderFeed();
+  }
+
+  function initActivityFeed() {
+    feedEl = document.getElementById('activity-feed');
+
+    var clearBtn = document.getElementById('activity-clear-btn');
+    if (clearBtn) {
+      clearBtn.addEventListener('click', clearFeed);
+    }
+
+    // Listen to all SSE event types
+    Object.keys(EVENT_CONFIG).forEach(function (eventName) {
+      document.addEventListener(eventName, function (e) {
+        addItem(eventName, e.detail || {});
+      });
+    });
+
+    renderFeed();
+  }
+
+  window.laminarkActivity = {
+    initActivityFeed: initActivityFeed,
+    clearFeed: clearFeed,
+  };
+})();