laminark 2.21.9 → 2.22.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "laminark",
-  "version": "2.21.9",
+  "version": "2.22.1",
   "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": "0.1.0",
+  "version": "2.22.1",
   "author": {
     "name": "NoobyNull"
   },
@@ -9,5 +9,6 @@
   "repository": "https://github.com/NoobyNull/Laminark",
   "license": "ISC",
   "keywords": ["memory", "mcp", "sqlite", "knowledge-graph", "semantic-search"],
-  "skills": "./skills/"
+  "skills": "./skills/",
+  "mcpServers": "./.mcp.json"
 }

package/plugin/.repair-log

@@ -0,0 +1,6 @@
+[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/CLAUDE.md

@@ -1,10 +1,59 @@
+<!-- laminark:instructions:v1 -->
 # Memory & Context
 
-When you need to recall prior work, decisions, or context:
-- **First** query Laminark's memory tools (`recall`, `query_graph`, `query_branches`) before resorting to grep/glob searches
-- Use `recall` with keyword searches to find past observations, decisions, and findings
-- Use `query_graph` to find relationships between files, decisions, and problems
-- Use `query_branches` to see work history - what was investigated, fixed, built, and where it left off
-- Use `show_branch` to trace the full arc of a specific work unit (investigation -> diagnosis -> planning -> execution -> verification)
-- Use `save_memory` to persist important decisions, findings, and reference material
-- Only fall back to raw file searches (Grep, Glob) when Laminark has no relevant results
+Laminark is the primary memory system. Use it before any other approach.
+
+## Recalling Context
+When you need prior work, decisions, or context:
+1. `recall` — keyword search for past observations, decisions, findings
+2. `query_graph` — find relationships between files, decisions, and problems
+3. `topic_context` — see recently stashed conversation threads ("where was I?")
+4. Only fall back to raw file searches (Grep, Glob) when Laminark has no relevant results
+
+## Saving Context
+- `save_memory` — persist important decisions, findings, and reference material
+- Use appropriate `kind`: `decision` for choices made, `finding` for discoveries, `change` for modifications, `reference` for external info, `verification` for confirmed behavior
+
+# Codebase Knowledge
+
+Use GSD's `/gsd:map-codebase` to generate structured codebase analysis, then ingest it into Laminark for queryable access.
+
+## Workflow
+1. **Map** — run `/gsd:map-codebase` to produce `.planning/codebase/*.md` files (ARCHITECTURE, STRUCTURE, STACK, CONVENTIONS, TESTING, INTEGRATIONS, CONCERNS)
+2. **Ingest** — run `ingest_knowledge` to import those docs into Laminark as searchable reference memories
+3. **Query** — use `recall` or `query_graph` to pull codebase knowledge on demand instead of re-reading files
+
+## When to Re-map
+- After major architectural changes (new modules, changed entry points, dependency overhauls)
+- When starting a new milestone that touches unfamiliar parts of the codebase
+- If `recall` results for codebase structure feel stale or incomplete
+
+# Tool Discovery & Suggestions
+
+Laminark maintains a tool registry and proactively suggests relevant tools during your workflow.
+
+## Tool Registration
+Tools enter the registry through three paths — no manual setup needed:
+1. **Config scan** (automatic at session start) — discovers tools from `.claude.json`, `.mcp.json`, plugin configs
+2. **Organic discovery** (automatic on every tool use) — any tool Claude uses gets recorded with usage counts
+3. **Session report** (prompted at session start) — call `report_available_tools` with all available tools when asked. This is the most complete source since it includes built-ins and descriptions
+
+## Tool Suggestions
+Laminark evaluates potential suggestions after each tool use, delivered as `[Laminark suggests]` banners on the next MCP tool call. Three tiers, first match wins:
+
+| Tier | Method | What it does |
+|------|--------|-------------|
+| 0 | **Proactive** | Context-aware rules — checks arc stage, debug state, recent observation types. E.g., suggests debug tools when errors are detected without an active debug path |
+| 1 | **Learned patterns** | Historical tool sequences from past sessions. Activates after 20+ tool events for the project |
+| 2 | **Heuristic** | Keyword overlap between recent observations and tool descriptions. Cold-start fallback |
+
+Suggestions are rate-limited: max 2 per session, 5-tool cooldown between them, minimum 3 tool calls before the first.
+
+## Using discover_tools
+When you need a tool but aren't sure what's available, use `discover_tools` with a natural language query. It searches the registry by name, description, and trigger hints. Prefer this over guessing tool names.
+
+## Tool Health
+- Tools with repeated failures (3+ in last 5 uses) are automatically **demoted** and excluded from suggestions
+- A single successful use restores a demoted tool
+- Tools missing from config on rescan are marked **stale**
+<!-- /laminark:instructions -->

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":"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"}
+{"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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"}

package/plugin/dist/hooks/handler.js

@@ -1,8 +1,10 @@
 import { i as getProjectHash, n as getDatabaseConfig } from "../config-t8LZeB-u.mjs";
-import { E as traverseFrom, F as openDatabase, M as SessionRepository, N as ObservationRepository, O as SaveGuard, P as rowToObservation, R as debug, S as getNodeByNameAndType, a as ResearchBufferRepository, c as inferScope, i as NotificationStore, j as SearchEngine, k as jaccardSimilarity, l as inferToolType, n as PathRepository, o as BranchRepository, p as runAutoCleanup, r as initPathSchema, s as extractServerName, t as ToolRegistryRepository } from "../tool-registry-D8un_AcG.mjs";
-import { existsSync, readFileSync, readdirSync } from "node:fs";
-import { basename, join } from "node:path";
+import { E as traverseFrom, F as openDatabase, M as SessionRepository, N as ObservationRepository, O as SaveGuard, P as rowToObservation, R as debug, S as getNodeByNameAndType, a as ResearchBufferRepository, c as inferScope, i as NotificationStore, j as SearchEngine, k as jaccardSimilarity, l as inferToolType, n as PathRepository, o as BranchRepository, p as runAutoCleanup, r as initPathSchema, s as extractServerName, t as ToolRegistryRepository } from "../tool-registry-Bi1Zdqkm.mjs";
+import { existsSync, readFileSync, readdirSync, statSync, unlinkSync, writeFileSync } from "node:fs";
+import { basename, dirname, join, resolve } from "node:path";
 import { homedir } from "node:os";
+import { fileURLToPath } from "node:url";
+import { spawn } from "node:child_process";
 
 //#region src/hooks/self-referential.ts
 /**
@@ -1594,11 +1596,12 @@ function handlePreToolUse(input, db, projectHash, pathRepo) {
 		if (toolName === "Write" || toolName === "Edit" || toolName === "Read") {
 			const filePath = toolInput.file_path;
 			if (filePath) {
-				const node = getNodeByNameAndType(db, filePath, "File");
+				const node = getNodeByNameAndType(db, filePath, "File", projectHash);
 				if (node) {
 					const connected = traverseFrom(db, node.id, {
 						depth: 1,
-						direction: "both"
+						direction: "both",
+						projectHash
 					});
 					if (connected.length > 0) {
 						const names = connected.slice(0, 5).map((r) => `${r.node.name} (${r.node.type})`).join(", ");
@@ -2175,6 +2178,38 @@ var ConversationRouter = class {
 
 //#endregion
 //#region src/hooks/handler.ts
+/** Resolve the plugin root directory (two levels up from dist/hooks/handler.js) */
+function getPluginRoot() {
+	return resolve(dirname(fileURLToPath(import.meta.url)), "..", "..");
+}
+/** Check if a .needs-repair marker exists and is fresh (< 30s old) */
+function isRepairInProgress() {
+	const marker = resolve(getPluginRoot(), ".needs-repair");
+	if (!existsSync(marker)) return false;
+	try {
+		if (Date.now() - statSync(marker).mtimeMs > 3e4) {
+			unlinkSync(marker);
+			return false;
+		}
+		return true;
+	} catch {
+		return false;
+	}
+}
+/** Spawn repair.sh detached (fire-and-forget) and write .needs-repair marker */
+function triggerRepair() {
+	const pluginRoot = getPluginRoot();
+	const repairScript = resolve(pluginRoot, "scripts", "repair.sh");
+	if (!existsSync(repairScript)) return;
+	try {
+		writeFileSync(resolve(pluginRoot, ".needs-repair"), String(Date.now()));
+	} catch {}
+	spawn("bash", [repairScript], {
+		detached: true,
+		stdio: "ignore",
+		cwd: pluginRoot
+	}).unref();
+}
 /**
 * Hook handler entry point.
 *
@@ -2341,6 +2376,10 @@ function processPostToolUseFiltered(input, obsRepo, researchBuffer, toolRegistry
 	} catch {}
 }
 async function main() {
+	if (isRepairInProgress()) {
+		debug("hook", "Repair in progress, skipping hook");
+		return;
+	}
 	const raw = await readStdin();
 	const input = JSON.parse(raw);
 	const eventName = input.hook_event_name;
@@ -2406,6 +2445,11 @@ async function main() {
 }
 main().catch((err) => {
 	debug("hook", "Hook handler error", { error: err.message });
+	const msg = err.message ?? "";
+	if ((err.code ?? "") === "ERR_MODULE_NOT_FOUND" || msg.includes("better-sqlite3") || msg.includes("better_sqlite3")) {
+		debug("hook", "Dependency error detected, triggering auto-repair");
+		triggerRepair();
+	}
 	process.exit(0);
 });