laminark 0.1.0 → 2.21.7

package/.claude-plugin/marketplace.json

@@ -0,0 +1,15 @@
+{
+  "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": "2.21.6",
+      "category": "productivity"
+    }
+  ]
+}

package/README.md

@@ -14,18 +14,28 @@ Persistent adaptive memory for Claude Code. Automatically captures observations
 
 ## Installation
 
-### Quick Install (Recommended)
+User-level installation is recommended. This enables Laminark across all your projects with data automatically isolated per project directory.
 
-One command — no git clone needed:
+### UI Installation (Easiest)
+
+To install via Claude Code's UI (`/plugin` command), first set up TMPDIR to avoid EXDEV errors:
 
 ```bash
-curl -fsSL https://raw.githubusercontent.com/NoobyNull/Laminark/master/plugin/scripts/install.sh | bash
+# One-time setup - run this once
+git clone https://github.com/NoobyNull/Laminark.git
+cd Laminark
+./scripts/setup-tmpdir.sh
+
+# Then restart your terminal and restart Claude Code
 ```
 
-This will:
-1. Install `laminark` globally via npm
-2. Register the MCP server with Claude Code
-3. Configure hooks in `~/.claude/settings.json`
+After setup, you can install/update via Claude's UI:
+1. In Claude Code, type `/plugin`
+2. Select "Add marketplace"
+3. Enter `NoobyNull/Laminark`
+4. Click "Install"
+
+**Why this is needed:** Systems with separate filesystems for `/home/` and `/tmp/` (common with btrfs, Docker, or separate partitions) encounter EXDEV errors during plugin installation. Setting TMPDIR fixes this globally.
 
 ### Local Installation (Development)
 
@@ -36,67 +46,92 @@ git clone https://github.com/NoobyNull/Laminark.git
 cd Laminark
 npm install
 npm run build
-./plugin/scripts/local-install.sh
+./scripts/local-install.sh
 ```
 
-This uses `npm link` so changes to the repo are reflected immediately after rebuilding.
+### Marketplace Installation (End Users)
+
+```bash
+./scripts/install.sh
+# Or: curl -fsSL https://raw.githubusercontent.com/NoobyNull/Laminark/master/scripts/install.sh | bash
+```
 
 ### Manual Installation (Advanced)
 
-If you need manual control:
+If you need manual control or encounter issues:
 
 ```bash
-# Install the package
-npm install -g laminark
-
-# Register MCP server
-claude mcp add-json laminark '{"command":"laminark-server"}' -s user
-
-# Configure hooks manually in ~/.claude/settings.json
-# (see install.sh for the hook structure)
+# Set TMPDIR to avoid cross-device errors
+export TMPDIR=~/.claude/tmp
+mkdir -p "$TMPDIR"
+claude plugin add /path/to/Laminark
 ```
 
 ### Post-Installation
 
-Verify installation:
+Enable the plugin:
 
 ```bash
-# If installed from repo:
-./plugin/scripts/verify-install.sh
+claude plugin enable laminark
+```
+
+Verify installation:
 
-# Or check manually:
-npm list -g laminark && claude mcp list | grep laminark
+```bash
+claude plugin list  # Should show laminark
 ```
 
 Laminark will now run in every Claude Code session. Each project's memory is isolated by directory path -- Project A and Project B never share data, but each project remembers across sessions.
 
 ### Updating
 
+Check for and install updates:
+
 ```bash
-npm update -g laminark
-# Or: ./plugin/scripts/update.sh
+./scripts/update.sh
+# Or: npm run update
 ```
 
+The update script will:
+- Check your current version
+- Fetch the latest version from GitHub
+- Prompt before updating
+- Handle EXDEV errors automatically
+
 ### Uninstalling
 
+Remove the plugin with optional data cleanup:
+
 ```bash
-claude mcp remove laminark -s user
-npm uninstall -g laminark
-# Then remove laminark hook entries from ~/.claude/settings.json
-# Optionally: rm -rf ~/.laminark  (deletes all memories)
+./scripts/uninstall.sh
+# Or: npm run uninstall
 ```
 
-## Recommended: GSD (Get Shit Done)
+The uninstall script will:
+- Remove the plugin
+- Ask if you want to keep or delete your data
+- Clean up plugin cache
 
-Laminark pairs well with [GSD](https://github.com/gsd-framework/gsd) by [@gsd-framework](https://github.com/gsd-framework), a structured workflow plugin for Claude Code. While Laminark handles persistent memory and context, GSD provides project planning, phased execution, and atomic commits. Together they give Claude Code sessions continuity (Laminark) and structure (GSD).
+### Troubleshooting: EXDEV Errors
 
-> **Note:** GSD is an independent project. Its authors do not endorse or recommend Laminark. This is our recommendation based on how well the two tools complement each other.
+If you see `EXDEV: cross-device link not permitted` errors:
 
-```bash
-claude plugin add gsd
-```
+**Cause:** Your `/home/` and `/tmp/` directories are on different filesystems (common with btrfs, Docker, or separate partitions).
+
+**Solutions (choose one):**
+
+1. **For UI installation** - Run the setup script once:
+   ```bash
+   ./scripts/setup-tmpdir.sh
+   # Then restart terminal and Claude Code
+   ```
+   This configures TMPDIR globally, allowing you to use Claude's `/plugin` UI.
 
-The install scripts will offer to install GSD automatically if it isn't already present.
+2. **For command-line installation** - Use our scripts:
+   ```bash
+   ./scripts/local-install.sh  # or ./scripts/install.sh
+   ```
+   These scripts handle EXDEV automatically without global configuration.
 
 ## Why User-Level?
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "laminark",
-  "version": "0.1.0",
+  "version": "2.21.7",
   "description": "Persistent adaptive memory for Claude Code",
   "type": "module",
   "bin": {
@@ -10,7 +10,8 @@
   "main": "./plugin/dist/index.js",
   "types": "./plugin/dist/index.d.ts",
   "files": [
-    "plugin"
+    "plugin",
+    ".claude-plugin"
   ],
   "engines": {
     "node": ">=22.0.0"
@@ -21,13 +22,10 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "prepublishOnly": "npm run build",
-    "install:local": "./plugin/scripts/local-install.sh",
-    "install:global": "./plugin/scripts/install.sh",
-    "update": "./plugin/scripts/update.sh",
-    "uninstall": "./plugin/scripts/uninstall.sh",
-    "verify": "./plugin/scripts/verify-install.sh",
-    "sync": "./plugin/scripts/dev-sync.sh",
-    "dev": "npm run build && npm run sync"
+    "install:local": "./scripts/local-install.sh",
+    "install:marketplace": "./scripts/install.sh",
+    "update": "./scripts/update.sh",
+    "uninstall": "./scripts/uninstall.sh"
   },
   "repository": {
     "type": "git",

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": "0.1.0",
+  "version": "2.21.6",
   "author": {
     "name": "NoobyNull"
   },

package/plugin/dist/hooks/handler.d.ts

@@ -1,4 +1,4 @@
-import { t as ObservationRepository } from "../observations-CorAAc1A.mjs";
+import { t as ObservationRepository } from "../observations-Ch0nc47i.mjs";
 import * as better_sqlite30 from "better-sqlite3";
 import Database from "better-sqlite3";
 
@@ -63,7 +63,6 @@ interface DiscoveredTool {
   projectHash: string | null;
   description: string | null;
   serverName: string | null;
-  triggerHints: string | null;
 }
 /**
  * Raw database row from the tool_registry table (snake_case).
@@ -77,7 +76,6 @@ interface ToolRegistryRow {
   project_hash: string | null;
   description: string | null;
   server_name: string | null;
-  trigger_hints: string | null;
   usage_count: number;
   last_used_at: string | null;
   discovered_at: string;

package/plugin/dist/hooks/handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handler.d.ts","names":[],"sources":["../../../src/storage/research-buffer.ts","../../../src/shared/tool-types.ts","../../../src/storage/tool-registry.ts","../../../src/hooks/handler.ts"],"mappings":";;;;;;;;;AAcA;;;;;;cAAa,wBAAA;EAAA,iBACM,EAAA;EAAA,iBACA,WAAA;EAAA,iBAEA,UAAA;EAAA,iBACA,aAAA;EAAA,iBACA,SAAA;cAEL,EAAA,EAAI,QAAA,CAAc,QAAA,EAAU,WAAA;EAAA;;;EA2BxC,GAAA,CAAI,KAAA;IACF,SAAA;IACA,QAAA;IACA,MAAA;EAAA;EAmBA;;;EAFF,SAAA,CACE,SAAA,UACA,aAAA,YACC,KAAA;IAAQ,QAAA;IAAkB,MAAA;IAAgB,SAAA;EAAA;EAiBV;;;EAAnC,KAAA,CAAM,gBAAA;AAAA;;;;;;KCtFI,QAAA;;ADWZ;;KCNY,SAAA;;;;;UAMK,cAAA;EACf,IAAA;EACA,QAAA,EAAU,QAAA;EACV,KAAA,EAAO,SAAA;EACP,MAAA;EACA,WAAA;EACA,WAAA;EACA,UAAA;EACA,YAAA;AAAA;;;;UAMe,eAAA;EACf,EAAA;EACA,IAAA;EACA,SAAA;EACA,KAAA;EACA,MAAA;EACA,YAAA;EACA,WAAA;EACA,WAAA;EACA,aAAA;EACA,WAAA;EACA,YAAA;EACA,aAAA;EACA,UAAA;EACA,MAAA;AAAA;;;;UAkBe,cAAA;EACf,SAAA;EACA,WAAA;EACA,SAAA;AAAA;;;;UAMe,gBAAA;EACf,IAAA,EAAM,eAAA;EACN,KAAA;EACA,SAAA;AAAA;;;;;;AD1DF;;;;;;;cEEa,sBAAA;EAAA,iBACM,EAAA;EAAA,iBAGA,UAAA;EAAA,iBACA,eAAA;EAAA,iBACA,cAAA;EAAA,iBACA,aAAA;EAAA,iBACA,UAAA;EAAA,iBACA,SAAA;EAAA,iBACA,0BAAA;EAAA,iBACA,eAAA;EAAA,iBACA,mBAAA;EAAA,iBACA,sBAAA;EAAA,iBACA,iBAAA;EAAA,iBACA,kBAAA;EAAA,iBACA,aAAA;EAAA,iBACA,eAAA;EAAA,iBACA,cAAA;EAAA,iBACA,oBAAA;EAAA,iBACA,0BAAA;cAEL,EAAA,EAAI,QAAA,CAAc,QAAA;EFmDxB;;;;EE4GN,MAAA,CAAO,IAAA,EAAM,cAAA;;ADlMf;;;ECwNE,WAAA,CAAY,IAAA,UAAc,WAAA;EDxNR;AAKpB;;;;;AAMA;EC6NE,cAAA,CACE,IAAA,UACA,QAAA,EAAU,IAAA,CAAK,cAAA,WACf,SAAA,kBACA,OAAA;;;;EAqBF,aAAA,CAAc,WAAA,WAAsB,eAAA;EDpP1B;;;;EC4PV,sBAAA,CAAuB,WAAA,WAAsB,eAAA;EDxP7C;;;EC+PA,SAAA,CAAU,IAAA,WAAe,eAAA;ED7Pb;AAMd;;EC+PE,MAAA,CAAA,GAAU,eAAA;ED/PoB;;;ECsQ9B,KAAA,CAAA;EDlQA;;;;EC2QA,eAAA,CAAgB,QAAA,UAAkB,WAAA,UAAqB,YAAA,YAAmC,cAAA;EDtQ1F;;;EC8QA,kBAAA,CAAmB,SAAA,WAAoB,cAAA;ED1QvC;;;;ECkRA,aAAA,CAAc,WAAA,UAAqB,YAAA,YAAmC,cAAA;ED/PzC;;;;;ECwQ7B,cAAA,CAAe,WAAA,UAAqB,KAAA,YAAsB,cAAA;EDrQjD;;AAMX;;EC2QE,SAAA,CAAU,IAAA,UAAc,WAAA;ED1QH;;;ECsRrB,WAAA,CAAY,IAAA,UAAc,WAAA;EDpR1B;;;;ECiSA,UAAA,CAAW,IAAA,UAAc,WAAA;;AAzV3B;;;EAsWE,qBAAA,CAAsB,WAAA,WAAsB,eAAA;EAjL/B;;;;;EA+Lb,sBAAA,CAAuB,QAAA,UAAkB,WAAA,UAAqB,KAAA,YAAoB,KAAA;IAAQ,OAAA;EAAA;EAjFnD;;;;;EAAA,QAmG/B,aAAA;EAyDuB;;;;EAtC/B,eAAA,CAAgB,KAAA,UAAe,OAAA;IAAY,KAAA;IAAgB,KAAA;EAAA,IAAmB,gBAAA;EAkKjC;;;;EA5H7C,cAAA,CAAe,cAAA,EAAgB,YAAA,EAAc,OAAA;IAAY,KAAA;IAAgB,KAAA;EAAA,IAAmB,KAAA;IAAQ,OAAA;IAAiB,QAAA;EAAA;EAnbpG;;;;;EAwdX,WAAA,CACJ,KAAA,UACA,OAAA;IACE,KAAA;IACA,KAAA;IACA,MAAA;MAAW,OAAA;MAAoB,KAAA,CAAM,IAAA,WAAe,OAAA,CAAQ,YAAA;IAAA;IAC5D,gBAAA;EAAA,IAED,OAAA,CAAQ,gBAAA;EAvTE;;;;EAwXb,cAAA,CAAe,MAAA,UAAgB,SAAA,EAAW,YAAA;EAlV1C;;;;EAgWA,mBAAA,CAAoB,KAAA,YAAoB,KAAA;IAAQ,EAAA;IAAY,IAAA;IAAc,WAAA;EAAA;AAAA;;;;;AF7jB5E;;;;iBGkDgB,0BAAA,CACd,KAAA,EAAO,MAAA,mBACP,OAAA,EAAS,qBAAA,EACT,cAAA,GAAiB,wBAAA,EACjB,YAAA,GAAe,sBAAA,EACf,WAAA,WACA,EAAA,GAFqC,eAAA,CAEP,QAAA"}
+{"version":3,"file":"handler.d.ts","names":[],"sources":["../../../src/storage/research-buffer.ts","../../../src/shared/tool-types.ts","../../../src/storage/tool-registry.ts","../../../src/hooks/handler.ts"],"mappings":"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"}