laminark 0.1.0

package/plugin/scripts/update.sh

@@ -0,0 +1,39 @@
+#!/bin/bash
+# Update Laminark to the latest version via npm
+
+set -e
+
+echo "Laminark Updater"
+echo "================"
+echo ""
+
+# Check if npm is available
+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 "")
+if [ -z "$CURRENT_VERSION" ]; then
+  echo "Laminark is not installed globally."
+  echo "Run: ./plugin/scripts/install.sh"
+  exit 1
+fi
+
+echo "Currently installed: v$CURRENT_VERSION"
+echo ""
+echo "Updating..."
+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"
+fi
+echo ""
+echo "Restart your Claude Code session for changes to take effect."
+
+exit 0

package/plugin/scripts/verify-install.sh

@@ -0,0 +1,87 @@
+#!/bin/bash
+# Verify Laminark installation
+# Checks: npm global package, MCP server, hooks in settings.json
+
+set -e
+
+echo "Checking Laminark installation..."
+echo ""
+
+ERRORS=0
+
+# Check 1: npm global package
+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"
+else
+  # Check for npm link (dev install)
+  if command -v laminark-server &> /dev/null; then
+    echo "✓ laminark-server on PATH (linked)"
+  else
+    echo "✗ npm package not installed"
+    ERRORS=$((ERRORS + 1))
+  fi
+fi
+
+# Check 2: laminark-server binary
+if command -v laminark-server &> /dev/null; then
+  echo "✓ laminark-server binary available"
+else
+  echo "✗ laminark-server not found on PATH"
+  ERRORS=$((ERRORS + 1))
+fi
+
+# Check 3: laminark-hook binary
+if command -v laminark-hook &> /dev/null; then
+  echo "✓ laminark-hook binary available"
+else
+  echo "⚠ laminark-hook not on PATH (hooks may use direct node path)"
+fi
+
+# Check 4: Claude CLI
+if ! command -v claude &> /dev/null; then
+  echo "✗ claude CLI not found"
+  ERRORS=$((ERRORS + 1))
+else
+  # Check 5: MCP server registration
+  if claude mcp list 2>/dev/null | grep -q "laminark"; then
+    echo "✓ MCP server registered"
+  else
+    echo "✗ MCP server not registered"
+    echo "  Run: claude mcp add-json laminark '{\"command\":\"laminark-server\"}' -s user"
+    ERRORS=$((ERRORS + 1))
+  fi
+fi
+
+# Check 6: Hooks in settings.json
+SETTINGS_FILE="${CLAUDE_HOME:-$HOME/.claude}/settings.json"
+if [ -f "$SETTINGS_FILE" ]; then
+  if grep -q "laminark" "$SETTINGS_FILE"; then
+    echo "✓ Hooks configured in settings.json"
+  else
+    echo "✗ No laminark hooks in settings.json"
+    ERRORS=$((ERRORS + 1))
+  fi
+else
+  echo "✗ Settings file not found: $SETTINGS_FILE"
+  ERRORS=$((ERRORS + 1))
+fi
+
+# Check 7: Data directory
+DATA_DIR="$HOME/.laminark"
+if [ -d "$DATA_DIR" ]; then
+  echo "✓ Data directory exists: $DATA_DIR"
+else
+  echo "⚠ Data directory not yet created (will be created on first use)"
+fi
+
+echo ""
+if [ $ERRORS -eq 0 ]; then
+  echo "Installation verified successfully!"
+  echo ""
+  echo "Start a new Claude Code session to use Laminark."
+else
+  echo "Found $ERRORS issue(s). Run ./plugin/scripts/install.sh to fix."
+fi
+
+exit $ERRORS

package/plugin/skills/status/SKILL.md

@@ -0,0 +1,6 @@
+---
+name: status
+description: Show Laminark system status — connection info, memory count, token stats, and capabilities
+---
+
+Call the `mcp__plugin_laminark_laminark__status` tool with no arguments and display the result to the user.

package/plugin/ui/activity.js

@@ -0,0 +1,197 @@
+/**
+ * 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;
+
+    // Filter out events from other projects
+    if (detail.projectHash && window.laminarkState && window.laminarkState.currentProject &&
+        detail.projectHash !== window.laminarkState.currentProject) {
+      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 || {});
+      });
+    });
+
+    // Clear feed when project changes
+    var projectSelect = document.getElementById('project-selector');
+    if (projectSelect) {
+      projectSelect.addEventListener('change', clearFeed);
+    }
+
+    renderFeed();
+  }
+
+  window.laminarkActivity = {
+    initActivityFeed: initActivityFeed,
+    clearFeed: clearFeed,
+  };
+})();