laminark 2.21.6

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

@@ -0,0 +1,182 @@
+# Laminark
+
+Persistent adaptive memory for Claude Code. Automatically captures observations from your coding sessions, classifies them using LLM-based curation, and surfaces relevant context when you need it.
+
+## Features
+
+- Automatic observation capture via Claude Code hooks (Write, Edit, Bash, etc.)
+- LLM-based classification: discoveries, problems, solutions (noise filtered out)
+- Full-text search with BM25 ranking
+- Knowledge graph with entity and relationship tracking
+- Cross-session memory scoped per project
+- Web UI for browsing observations and graph
+- Duplicate detection and secret redaction
+
+## Installation
+
+User-level installation is recommended. This enables Laminark across all your projects with data automatically isolated per project directory.
+
+### UI Installation (Easiest)
+
+To install via Claude Code's UI (`/plugin` command), first set up TMPDIR to avoid EXDEV errors:
+
+```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
+```
+
+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)
+
+For local development or testing:
+
+```bash
+git clone https://github.com/NoobyNull/Laminark.git
+cd Laminark
+npm install
+npm run build
+./scripts/local-install.sh
+```
+
+### 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 or encounter issues:
+
+```bash
+# Set TMPDIR to avoid cross-device errors
+export TMPDIR=~/.claude/tmp
+mkdir -p "$TMPDIR"
+claude plugin add /path/to/Laminark
+```
+
+### Post-Installation
+
+Enable the plugin:
+
+```bash
+claude plugin enable laminark
+```
+
+Verify installation:
+
+```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
+./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
+./scripts/uninstall.sh
+# Or: npm run uninstall
+```
+
+The uninstall script will:
+- Remove the plugin
+- Ask if you want to keep or delete your data
+- Clean up plugin cache
+
+### Troubleshooting: EXDEV Errors
+
+If you see `EXDEV: cross-device link not permitted` errors:
+
+**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.
+
+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?
+
+- Works in every project automatically -- no per-project `.mcp.json` needed
+- Cross-session memory persists for each project
+- Single database at `~/.laminark/data.db`, scoped by project hash
+- Hooks and MCP tools are available everywhere
+
+## Data Storage
+
+All data is stored in a single SQLite database at `~/.laminark/data.db`. Each project is identified by a SHA-256 hash of its directory path, ensuring complete isolation between projects.
+
+## MCP Tools
+
+| Tool | Description |
+|------|-------------|
+| `save_memory` | Save an observation with optional title |
+| `recall` | Search, view, purge, or restore memories |
+| `query_graph` | Query the knowledge graph for entities and relationships |
+| `graph_stats` | View knowledge graph statistics |
+| `topic_context` | Show recently stashed context threads |
+| `status` | Show Laminark status and statistics |
+
+## Development
+
+```bash
+npm install
+npm run build
+npm test
+```
+
+## Release History
+
+See [CHANGELOG.md](CHANGELOG.md) for detailed release notes.
+
+**Versioning:** Laminark uses `MILESTONE.PHASE.SEQUENTIAL` format (e.g., v2.21.0) aligned with GSD workflow phases.
+
+**Latest Releases:**
+- **v2.21.0** (2026-02-14) - Phase 21: Graph Visualization (Milestone v2.2 complete)
+- **v2.18.0** (2026-02-14) - Phase 18: Agent SDK Migration (Milestone v2.1 complete)
+- **v2.16.0** (2026-02-10) - Phase 16: Staleness Management (Milestone v2.0 complete)
+- **v1.8.0** (2026-02-09) - Phase 8: Web Visualization (Milestone v1.0 complete)
+
+See [.planning/MILESTONES.md](.planning/MILESTONES.md) for comprehensive milestone documentation.
+
+## License
+
+ISC

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "laminark",
+  "version": "2.21.6",
+  "description": "Persistent adaptive memory for Claude Code",
+  "type": "module",
+  "bin": {
+    "laminark-server": "./plugin/dist/index.js",
+    "laminark-hook": "./plugin/dist/hooks/handler.js"
+  },
+  "main": "./plugin/dist/index.js",
+  "types": "./plugin/dist/index.d.ts",
+  "files": [
+    "plugin",
+    ".claude-plugin"
+  ],
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "check": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build",
+    "install:local": "./scripts/local-install.sh",
+    "install:marketplace": "./scripts/install.sh",
+    "update": "./scripts/update.sh",
+    "uninstall": "./scripts/uninstall.sh"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/NoobyNull/Laminark.git"
+  },
+  "keywords": [
+    "claude",
+    "memory",
+    "mcp",
+    "sqlite"
+  ],
+  "license": "ISC",
+  "bugs": {
+    "url": "https://github.com/NoobyNull/Laminark/issues"
+  },
+  "homepage": "https://github.com/NoobyNull/Laminark#readme",
+  "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"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^25.2.2",
+    "tsdown": "^0.20.3",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  }
+}

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

@@ -0,0 +1,13 @@
+{
+  "name": "laminark",
+  "description": "Persistent adaptive memory for Claude Code. Automatic observation capture, semantic search, topic detection, knowledge graph, and web visualization.",
+  "version": "2.21.6",
+  "author": {
+    "name": "NoobyNull"
+  },
+  "homepage": "https://github.com/NoobyNull/Laminark",
+  "repository": "https://github.com/NoobyNull/Laminark",
+  "license": "ISC",
+  "keywords": ["memory", "mcp", "sqlite", "knowledge-graph", "semantic-search"],
+  "skills": "./skills/"
+}

package/plugin/.mcp.json

@@ -0,0 +1,12 @@
+{
+  "mcpServers": {
+    "laminark": {
+      "command": "bash",
+      "args": [
+        "${CLAUDE_PLUGIN_ROOT}/scripts/ensure-deps.sh",
+        "node",
+        "${CLAUDE_PLUGIN_ROOT}/dist/index.js"
+      ]
+    }
+  }
+}

package/plugin/dist/analysis/worker.d.ts

@@ -0,0 +1 @@
+export { };

package/plugin/dist/analysis/worker.js

@@ -0,0 +1,233 @@
+import { t as getConfigDir } from "../config-t8LZeB-u.mjs";
+import { join } from "node:path";
+import { parentPort } from "node:worker_threads";
+
+//#region src/analysis/engines/local-onnx.ts
+/**
+* Local ONNX embedding engine using @huggingface/transformers.
+*
+* Loads BGE Small EN v1.5 (quantized q8) via dynamic import() for
+* zero startup cost (DQ-04). Model files are cached in ~/.laminark/models/.
+*/
+/**
+* Embedding engine backed by BGE Small EN v1.5 running locally via ONNX Runtime.
+*
+* All public methods catch errors internally and return null/false.
+*/
+var LocalOnnxEngine = class {
+	pipe = null;
+	ready = false;
+	/**
+	* Lazily loads the model via dynamic import().
+	*
+	* - Uses `@huggingface/transformers` loaded at runtime (not bundled)
+	* - Caches model files in ~/.laminark/models/
+	* - Returns false on any error (missing runtime, download failure, etc.)
+	*/
+	async initialize() {
+		try {
+			const { pipeline, env } = await import("@huggingface/transformers");
+			env.cacheDir = join(getConfigDir(), "models");
+			this.pipe = await pipeline("feature-extraction", "Xenova/bge-small-en-v1.5", { dtype: "q8" });
+			this.ready = true;
+			return true;
+		} catch {
+			this.ready = false;
+			return false;
+		}
+	}
+	/**
+	* Embeds a single text string into a 384-dimensional vector.
+	*
+	* Returns null if:
+	* - Engine not initialized
+	* - Input is empty/whitespace
+	* - Pipeline throws
+	*/
+	async embed(text) {
+		if (!this.ready || !this.pipe) return null;
+		if (!text || text.trim().length === 0) return null;
+		try {
+			const output = await this.pipe(text, {
+				pooling: "cls",
+				normalize: true
+			});
+			return Float32Array.from(output.data);
+		} catch {
+			return null;
+		}
+	}
+	/**
+	* Embeds multiple texts, preserving order.
+	*
+	* Returns null for any text that was empty or failed.
+	*/
+	async embedBatch(texts) {
+		const results = [];
+		for (const text of texts) if (!text || text.trim().length === 0) results.push(null);
+		else results.push(await this.embed(text));
+		return results;
+	}
+	/** BGE Small EN v1.5 produces 384-dimensional embeddings. */
+	dimensions() {
+		return 384;
+	}
+	/** Engine identifier. */
+	name() {
+		return "bge-small-en-v1.5-q8";
+	}
+	/** Whether the model loaded successfully. */
+	isReady() {
+		return this.ready;
+	}
+};
+
+//#endregion
+//#region src/analysis/engines/keyword-only.ts
+/**
+* Embedding engine that produces no embeddings.
+*
+* Acts as a silent fallback so that the rest of the system can
+* operate in keyword-only mode without special-casing missing engines.
+*/
+var KeywordOnlyEngine = class {
+	/** Always returns null -- no model available. */
+	async embed() {
+		return null;
+	}
+	/** Returns array of nulls matching input length. */
+	async embedBatch(texts) {
+		return texts.map(() => null);
+	}
+	/** No dimensions -- no model. */
+	dimensions() {
+		return 0;
+	}
+	/** Engine identifier. */
+	name() {
+		return "keyword-only";
+	}
+	/** Intentionally returns false -- this engine has no model. */
+	async initialize() {
+		return false;
+	}
+	/** Always false -- no model loaded. */
+	isReady() {
+		return false;
+	}
+};
+
+//#endregion
+//#region src/analysis/embedder.ts
+/**
+* EmbeddingEngine interface and factory.
+*
+* Defines the pluggable abstraction for text embedding.
+* All consumers depend on this interface -- never on concrete engines.
+*/
+/**
+* Creates and initializes an embedding engine.
+*
+* Attempts LocalOnnxEngine first. If initialization fails (missing model,
+* ONNX runtime unavailable, etc.), falls back to KeywordOnlyEngine.
+*
+* Never throws -- always returns a valid engine.
+*/
+async function createEmbeddingEngine() {
+	const onnxEngine = new LocalOnnxEngine();
+	if (await onnxEngine.initialize()) return onnxEngine;
+	return new KeywordOnlyEngine();
+}
+
+//#endregion
+//#region src/analysis/worker.ts
+/**
+* Worker thread entry point for off-main-thread embedding.
+*
+* Receives embed/embed_batch/shutdown messages from the main thread via
+* parentPort, runs the embedding engine, and responds with Float32Array
+* results using zero-copy transfer.
+*
+* Compiled as a separate tsdown entry point to dist/analysis/worker.js.
+*/
+if (!parentPort) throw new Error("worker.ts must be run as a Worker thread");
+const port = parentPort;
+async function init() {
+	let engineName = "keyword-only";
+	let dimensions = 0;
+	try {
+		const engine = await createEmbeddingEngine();
+		engineName = engine.name();
+		dimensions = engine.dimensions();
+		port.postMessage({
+			type: "ready",
+			engineName,
+			dimensions
+		});
+		port.on("message", async (msg) => {
+			if (msg.type === "embed") try {
+				const embedding = await engine.embed(msg.text);
+				if (embedding === null) port.postMessage({
+					type: "embed_result",
+					id: msg.id,
+					embedding: null
+				});
+				else {
+					const buf = embedding.buffer;
+					port.postMessage({
+						type: "embed_result",
+						id: msg.id,
+						embedding
+					}, [buf]);
+				}
+			} catch {
+				port.postMessage({
+					type: "embed_result",
+					id: msg.id,
+					embedding: null
+				});
+			}
+			else if (msg.type === "embed_batch") try {
+				const embeddings = await engine.embedBatch(msg.texts);
+				const transferList = [];
+				for (const emb of embeddings) if (emb !== null) transferList.push(emb.buffer);
+				port.postMessage({
+					type: "embed_batch_result",
+					id: msg.id,
+					embeddings
+				}, transferList);
+			} catch {
+				port.postMessage({
+					type: "embed_batch_result",
+					id: msg.id,
+					embeddings: msg.texts.map(() => null)
+				});
+			}
+			else if (msg.type === "shutdown") process.exit(0);
+		});
+	} catch {
+		port.postMessage({
+			type: "ready",
+			engineName,
+			dimensions
+		});
+		port.on("message", (msg) => {
+			if (msg.type === "embed") port.postMessage({
+				type: "embed_result",
+				id: msg.id,
+				embedding: null
+			});
+			else if (msg.type === "embed_batch") port.postMessage({
+				type: "embed_batch_result",
+				id: msg.id,
+				embeddings: msg.texts.map(() => null)
+			});
+			else if (msg.type === "shutdown") process.exit(0);
+		});
+	}
+}
+init();
+
+//#endregion
+export {  };
+//# sourceMappingURL=worker.js.map

package/plugin/dist/analysis/worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.js","names":[],"sources":["../../../src/analysis/engines/local-onnx.ts","../../../src/analysis/engines/keyword-only.ts","../../../src/analysis/embedder.ts","../../../src/analysis/worker.ts"],"sourcesContent":["/**\n * Local ONNX embedding engine using @huggingface/transformers.\n *\n * Loads BGE Small EN v1.5 (quantized q8) via dynamic import() for\n * zero startup cost (DQ-04). Model files are cached in ~/.laminark/models/.\n */\n\nimport { join } from 'node:path';\n\nimport { getConfigDir } from '../../shared/config.js';\nimport type { EmbeddingEngine } from '../embedder.js';\n\n// Pipeline type from @huggingface/transformers -- kept as `unknown` to avoid\n// hard dependency on the library's type definitions at import time.\ntype Pipeline = (\n  text: string,\n  options?: { pooling?: string; normalize?: boolean },\n) => Promise<{ data: ArrayLike<number> }>;\n\n/**\n * Embedding engine backed by BGE Small EN v1.5 running locally via ONNX Runtime.\n *\n * All public methods catch errors internally and return null/false.\n */\nexport class LocalOnnxEngine implements EmbeddingEngine {\n  private pipe: Pipeline | null = null;\n  private ready = false;\n\n  /**\n   * Lazily loads the model via dynamic import().\n   *\n   * - Uses `@huggingface/transformers` loaded at runtime (not bundled)\n   * - Caches model files in ~/.laminark/models/\n   * - Returns false on any error (missing runtime, download failure, etc.)\n   */\n  async initialize(): Promise<boolean> {\n    try {\n      const { pipeline, env } = await import('@huggingface/transformers');\n\n      // Cache models in user config directory\n      env.cacheDir = join(getConfigDir(), 'models');\n\n      this.pipe = (await pipeline('feature-extraction', 'Xenova/bge-small-en-v1.5', {\n        dtype: 'q8',\n      })) as unknown as Pipeline;\n\n      this.ready = true;\n      return true;\n    } catch {\n      this.ready = false;\n      return false;\n    }\n  }\n\n  /**\n   * Embeds a single text string into a 384-dimensional vector.\n   *\n   * Returns null if:\n   * - Engine not initialized\n   * - Input is empty/whitespace\n   * - Pipeline throws\n   */\n  async embed(text: string): Promise<Float32Array | null> {\n    if (!this.ready || !this.pipe) {\n      return null;\n    }\n\n    if (!text || text.trim().length === 0) {\n      return null;\n    }\n\n    try {\n      const output = await this.pipe(text, { pooling: 'cls', normalize: true });\n      return Float32Array.from(output.data);\n    } catch {\n      return null;\n    }\n  }\n\n  /**\n   * Embeds multiple texts, preserving order.\n   *\n   * Returns null for any text that was empty or failed.\n   */\n  async embedBatch(texts: string[]): Promise<(Float32Array | null)[]> {\n    const results: (Float32Array | null)[] = [];\n\n    for (const text of texts) {\n      if (!text || text.trim().length === 0) {\n        results.push(null);\n      } else {\n        results.push(await this.embed(text));\n      }\n    }\n\n    return results;\n  }\n\n  /** BGE Small EN v1.5 produces 384-dimensional embeddings. */\n  dimensions(): number {\n    return 384;\n  }\n\n  /** Engine identifier. */\n  name(): string {\n    return 'bge-small-en-v1.5-q8';\n  }\n\n  /** Whether the model loaded successfully. */\n  isReady(): boolean {\n    return this.ready;\n  }\n}\n","/**\n * Null fallback embedding engine for graceful degradation (DQ-03).\n *\n * Used when the ONNX runtime or model is unavailable.\n * All embedding methods return null -- search falls back to keyword-only (FTS5).\n */\n\nimport type { EmbeddingEngine } from '../embedder.js';\n\n/**\n * Embedding engine that produces no embeddings.\n *\n * Acts as a silent fallback so that the rest of the system can\n * operate in keyword-only mode without special-casing missing engines.\n */\nexport class KeywordOnlyEngine implements EmbeddingEngine {\n  /** Always returns null -- no model available. */\n  async embed(): Promise<Float32Array | null> {\n    return null;\n  }\n\n  /** Returns array of nulls matching input length. */\n  async embedBatch(texts: string[]): Promise<(Float32Array | null)[]> {\n    return texts.map(() => null);\n  }\n\n  /** No dimensions -- no model. */\n  dimensions(): number {\n    return 0;\n  }\n\n  /** Engine identifier. */\n  name(): string {\n    return 'keyword-only';\n  }\n\n  /** Intentionally returns false -- this engine has no model. */\n  async initialize(): Promise<boolean> {\n    return false;\n  }\n\n  /** Always false -- no model loaded. */\n  isReady(): boolean {\n    return false;\n  }\n}\n","/**\n * EmbeddingEngine interface and factory.\n *\n * Defines the pluggable abstraction for text embedding.\n * All consumers depend on this interface -- never on concrete engines.\n */\n\nimport { LocalOnnxEngine } from './engines/local-onnx.js';\nimport { KeywordOnlyEngine } from './engines/keyword-only.js';\n\n/**\n * Pluggable embedding engine abstraction.\n *\n * All methods that can fail return null/false -- engines NEVER throw.\n * This is critical for graceful degradation (DQ-03).\n */\nexport interface EmbeddingEngine {\n  /** Embed a single text string. Returns null on failure or empty input. */\n  embed(text: string): Promise<Float32Array | null>;\n\n  /** Embed multiple texts. Returns null for any that failed or were empty. */\n  embedBatch(texts: string[]): Promise<(Float32Array | null)[]>;\n\n  /** Embedding dimensions (384 for BGE Small, 0 for keyword-only). */\n  dimensions(): number;\n\n  /** Engine identifier string. */\n  name(): string;\n\n  /** Lazy initialization. Returns true on success, false on failure. */\n  initialize(): Promise<boolean>;\n\n  /** Whether initialize() has been called and succeeded. */\n  isReady(): boolean;\n}\n\n/**\n * Creates and initializes an embedding engine.\n *\n * Attempts LocalOnnxEngine first. If initialization fails (missing model,\n * ONNX runtime unavailable, etc.), falls back to KeywordOnlyEngine.\n *\n * Never throws -- always returns a valid engine.\n */\nexport async function createEmbeddingEngine(): Promise<EmbeddingEngine> {\n  const onnxEngine = new LocalOnnxEngine();\n  const success = await onnxEngine.initialize();\n\n  if (success) {\n    return onnxEngine;\n  }\n\n  return new KeywordOnlyEngine();\n}\n","/**\n * Worker thread entry point for off-main-thread embedding.\n *\n * Receives embed/embed_batch/shutdown messages from the main thread via\n * parentPort, runs the embedding engine, and responds with Float32Array\n * results using zero-copy transfer.\n *\n * Compiled as a separate tsdown entry point to dist/analysis/worker.js.\n */\n\nimport { parentPort } from 'node:worker_threads';\nimport { createEmbeddingEngine } from './embedder.js';\n\nif (!parentPort) {\n  throw new Error('worker.ts must be run as a Worker thread');\n}\n\nconst port = parentPort;\n\ninterface EmbedMessage {\n  type: 'embed';\n  id: string;\n  text: string;\n}\n\ninterface EmbedBatchMessage {\n  type: 'embed_batch';\n  id: string;\n  texts: string[];\n}\n\ninterface ShutdownMessage {\n  type: 'shutdown';\n}\n\ntype WorkerMessage = EmbedMessage | EmbedBatchMessage | ShutdownMessage;\n\nasync function init(): Promise<void> {\n  let engineName = 'keyword-only';\n  let dimensions = 0;\n\n  try {\n    const engine = await createEmbeddingEngine();\n    engineName = engine.name();\n    dimensions = engine.dimensions();\n\n    port.postMessage({ type: 'ready', engineName, dimensions });\n\n    port.on('message', async (msg: WorkerMessage) => {\n      if (msg.type === 'embed') {\n        try {\n          const embedding = await engine.embed(msg.text);\n\n          if (embedding === null) {\n            port.postMessage({ type: 'embed_result', id: msg.id, embedding: null });\n          } else {\n            // Zero-copy transfer of the underlying ArrayBuffer\n            const buf = embedding.buffer as ArrayBuffer;\n            port.postMessage(\n              { type: 'embed_result', id: msg.id, embedding },\n              [buf],\n            );\n          }\n        } catch {\n          port.postMessage({ type: 'embed_result', id: msg.id, embedding: null });\n        }\n      } else if (msg.type === 'embed_batch') {\n        try {\n          const embeddings = await engine.embedBatch(msg.texts);\n\n          // Collect non-null buffers for zero-copy transfer\n          const transferList: ArrayBuffer[] = [];\n          for (const emb of embeddings) {\n            if (emb !== null) {\n              transferList.push(emb.buffer as ArrayBuffer);\n            }\n          }\n\n          port.postMessage(\n            { type: 'embed_batch_result', id: msg.id, embeddings },\n            transferList,\n          );\n        } catch {\n          port.postMessage({\n            type: 'embed_batch_result',\n            id: msg.id,\n            embeddings: msg.texts.map(() => null),\n          });\n        }\n      } else if (msg.type === 'shutdown') {\n        process.exit(0);\n      }\n    });\n  } catch {\n    // Engine creation failed -- still report ready with keyword-only fallback\n    port.postMessage({ type: 'ready', engineName, dimensions });\n\n    port.on('message', (msg: WorkerMessage) => {\n      if (msg.type === 'embed') {\n        port.postMessage({ type: 'embed_result', id: msg.id, embedding: null });\n      } else if (msg.type === 'embed_batch') {\n        port.postMessage({\n          type: 'embed_batch_result',\n          id: msg.id,\n          embeddings: msg.texts.map(() => null),\n        });\n      } else if (msg.type === 'shutdown') {\n        process.exit(0);\n      }\n    });\n  }\n}\n\ninit();\n"],"mappings":"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"}

package/plugin/dist/config-t8LZeB-u.mjs

@@ -0,0 +1,90 @@
+import { mkdirSync, readFileSync, realpathSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { createHash } from "node:crypto";
+import { homedir } from "node:os";
+
+//#region src/shared/config.ts
+/**
+* Cached debug-enabled flag.
+* Resolved once per process -- debug mode does not change at runtime.
+*/
+let _debugCached = null;
+/**
+* Returns whether debug logging is enabled for this process.
+*
+* Resolution order:
+* 1. `LAMINARK_DEBUG` env var -- `"1"` or `"true"` enables debug mode
+* 2. `~/.laminark/config.json` -- `{ "debug": true }` enables debug mode
+* 3. Default: disabled
+*
+* The result is cached after the first call.
+*/
+function isDebugEnabled() {
+	if (_debugCached !== null) return _debugCached;
+	const envVal = process.env.LAMINARK_DEBUG;
+	if (envVal === "1" || envVal === "true") {
+		_debugCached = true;
+		return true;
+	}
+	try {
+		const raw = readFileSync(join(getConfigDir(), "config.json"), "utf-8");
+		if (JSON.parse(raw).debug === true) {
+			_debugCached = true;
+			return true;
+		}
+	} catch {}
+	_debugCached = false;
+	return false;
+}
+/**
+* Default busy timeout in milliseconds.
+* Must be >= 5000ms to prevent SQLITE_BUSY under concurrent load.
+* Source: SQLite docs + better-sqlite3 performance recommendations.
+*/
+const DEFAULT_BUSY_TIMEOUT = 5e3;
+/**
+* Returns the Laminark data directory.
+* Default: ~/.claude/plugins/cache/laminark/data/
+* Creates the directory recursively if it does not exist.
+*
+* Supports LAMINARK_DATA_DIR env var override for testing --
+* redirects all data storage to a custom directory without
+* affecting the real plugin data.
+*/
+function getConfigDir() {
+	const dir = process.env.LAMINARK_DATA_DIR || join(homedir(), ".claude", "plugins", "cache", "laminark", "data");
+	mkdirSync(dir, { recursive: true });
+	return dir;
+}
+/**
+* Returns the path to the single Laminark database file.
+* Single database at ~/.claude/plugins/cache/laminark/data/data.db for ALL projects.
+*/
+function getDbPath() {
+	return join(getConfigDir(), "data.db");
+}
+/**
+* Creates a deterministic SHA-256 hash of a project directory path.
+* Uses realpathSync to canonicalize (resolves symlinks) to prevent
+* multiple hashes for the same directory via different paths.
+*
+* @param projectDir - The project directory path to hash
+* @returns First 16 hex characters of the SHA-256 hash
+*/
+function getProjectHash(projectDir) {
+	const canonical = realpathSync(resolve(projectDir));
+	return createHash("sha256").update(canonical).digest("hex").slice(0, 16);
+}
+/**
+* Returns the default database configuration.
+*/
+function getDatabaseConfig() {
+	return {
+		dbPath: getDbPath(),
+		busyTimeout: DEFAULT_BUSY_TIMEOUT
+	};
+}
+
+//#endregion
+export { isDebugEnabled as a, getProjectHash as i, getDatabaseConfig as n, getDbPath as r, getConfigDir as t };
+//# sourceMappingURL=config-t8LZeB-u.mjs.map

package/plugin/dist/config-t8LZeB-u.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-t8LZeB-u.mjs","names":[],"sources":["../../src/shared/config.ts"],"sourcesContent":["import { createHash } from 'node:crypto';\nimport { mkdirSync, readFileSync, realpathSync } from 'node:fs';\nimport { homedir } from 'node:os';\nimport { join, resolve } from 'node:path';\n\nimport type { DatabaseConfig } from './types.js';\n\n/**\n * Cached debug-enabled flag.\n * Resolved once per process -- debug mode does not change at runtime.\n */\nlet _debugCached: boolean | null = null;\n\n/**\n * Returns whether debug logging is enabled for this process.\n *\n * Resolution order:\n * 1. `LAMINARK_DEBUG` env var -- `\"1\"` or `\"true\"` enables debug mode\n * 2. `~/.laminark/config.json` -- `{ \"debug\": true }` enables debug mode\n * 3. Default: disabled\n *\n * The result is cached after the first call.\n */\nexport function isDebugEnabled(): boolean {\n  if (_debugCached !== null) {\n    return _debugCached;\n  }\n\n  // Check environment variable first\n  const envVal = process.env.LAMINARK_DEBUG;\n  if (envVal === '1' || envVal === 'true') {\n    _debugCached = true;\n    return true;\n  }\n\n  // Check config.json\n  try {\n    const configPath = join(getConfigDir(), 'config.json');\n    const raw = readFileSync(configPath, 'utf-8');\n    const config = JSON.parse(raw) as Record<string, unknown>;\n    if (config.debug === true) {\n      _debugCached = true;\n      return true;\n    }\n  } catch {\n    // Config file doesn't exist or is invalid -- that's fine\n  }\n\n  _debugCached = false;\n  return false;\n}\n\n/**\n * Default busy timeout in milliseconds.\n * Must be >= 5000ms to prevent SQLITE_BUSY under concurrent load.\n * Source: SQLite docs + better-sqlite3 performance recommendations.\n */\nexport const DEFAULT_BUSY_TIMEOUT = 5000;\n\n/**\n * Returns the Laminark data directory.\n * Default: ~/.claude/plugins/cache/laminark/data/\n * Creates the directory recursively if it does not exist.\n *\n * Supports LAMINARK_DATA_DIR env var override for testing --\n * redirects all data storage to a custom directory without\n * affecting the real plugin data.\n */\nexport function getConfigDir(): string {\n  const dir = process.env.LAMINARK_DATA_DIR || join(homedir(), '.claude', 'plugins', 'cache', 'laminark', 'data');\n  mkdirSync(dir, { recursive: true });\n  return dir;\n}\n\n/**\n * Returns the path to the single Laminark database file.\n * Single database at ~/.claude/plugins/cache/laminark/data/data.db for ALL projects.\n */\nexport function getDbPath(): string {\n  return join(getConfigDir(), 'data.db');\n}\n\n/**\n * Creates a deterministic SHA-256 hash of a project directory path.\n * Uses realpathSync to canonicalize (resolves symlinks) to prevent\n * multiple hashes for the same directory via different paths.\n *\n * @param projectDir - The project directory path to hash\n * @returns First 16 hex characters of the SHA-256 hash\n */\nexport function getProjectHash(projectDir: string): string {\n  const canonical = realpathSync(resolve(projectDir));\n  return createHash('sha256').update(canonical).digest('hex').slice(0, 16);\n}\n\n/**\n * Returns the default database configuration.\n */\nexport function getDatabaseConfig(): DatabaseConfig {\n  return {\n    dbPath: getDbPath(),\n    busyTimeout: DEFAULT_BUSY_TIMEOUT,\n  };\n}\n"],"mappings":";;;;;;;;;;AAWA,IAAI,eAA+B;;;;;;;;;;;AAYnC,SAAgB,iBAA0B;AACxC,KAAI,iBAAiB,KACnB,QAAO;CAIT,MAAM,SAAS,QAAQ,IAAI;AAC3B,KAAI,WAAW,OAAO,WAAW,QAAQ;AACvC,iBAAe;AACf,SAAO;;AAIT,KAAI;EAEF,MAAM,MAAM,aADO,KAAK,cAAc,EAAE,cAAc,EACjB,QAAQ;AAE7C,MADe,KAAK,MAAM,IAAI,CACnB,UAAU,MAAM;AACzB,kBAAe;AACf,UAAO;;SAEH;AAIR,gBAAe;AACf,QAAO;;;;;;;AAQT,MAAa,uBAAuB;;;;;;;;;;AAWpC,SAAgB,eAAuB;CACrC,MAAM,MAAM,QAAQ,IAAI,qBAAqB,KAAK,SAAS,EAAE,WAAW,WAAW,SAAS,YAAY,OAAO;AAC/G,WAAU,KAAK,EAAE,WAAW,MAAM,CAAC;AACnC,QAAO;;;;;;AAOT,SAAgB,YAAoB;AAClC,QAAO,KAAK,cAAc,EAAE,UAAU;;;;;;;;;;AAWxC,SAAgB,eAAe,YAA4B;CACzD,MAAM,YAAY,aAAa,QAAQ,WAAW,CAAC;AACnD,QAAO,WAAW,SAAS,CAAC,OAAO,UAAU,CAAC,OAAO,MAAM,CAAC,MAAM,GAAG,GAAG;;;;;AAM1E,SAAgB,oBAAoC;AAClD,QAAO;EACL,QAAQ,WAAW;EACnB,aAAa;EACd"}