claude-launchpad 1.10.1 → 1.14.0

package/README.md

@@ -70,7 +70,7 @@ The three-file split keeps each concern where it belongs:
 | `TASKS.md` | What we're doing now | Current sprint, session log (empty between sprints) |
 | `BACKLOG.md` | What we're doing later | WP-NNN template, 7 mandatory fields, P0/P1/P2/P3 sections |
 
-Init generates all three plus `.claude/rules/workflow.md`, a path-scoped rule file Claude auto-loads only when editing BACKLOG.md or TASKS.md. It also installs a `workflow-check.sh` hook that warns on drift: duplicate WP IDs across files, TASKS.md > 80 lines, Current Sprint > 15 items, Session Log > 3 entries.
+Init generates all three plus `.claude/rules/workflow.md`, a path-scoped rule file Claude auto-loads only when editing BACKLOG.md or TASKS.md. It also installs a `workflow-check.sh` hook that injects drift warnings into Claude's context (as PostToolUse `additionalContext` — bare hook stdout never reaches the model): a WP entry live in both files, TASKS.md > 80 lines, Current Sprint > 15 items, Session Log > 3 entries, and dependency-blind pulls (`Depends on:` WP still in the backlog).
 
 Doctor flags MEDIUM when workflow.md is missing, LOW when the hook is missing, and MEDIUM on duplicate `## Memory` headings in CLAUDE.md. `--fix` installs or repairs any of them without clobbering existing user content. See the [workflow docs](https://mboss37.github.io/claude-launchpad/docs/workflow) for the full lifecycle.
 
@@ -96,7 +96,7 @@ Runs 7 analyzers against your `.claude/` directory and CLAUDE.md. No API calls,
 | **Instruction Budget** | Too many instructions. Claude starts ignoring rules past ~200. |
 | **CLAUDE.md Quality** | Missing sections, vague instructions, hardcoded secrets, duplicate `## Memory` headings |
 | **Settings** | No hooks configured, dangerous tool access without safety nets |
-| **Hooks** | Missing auto-format, no .env protection, no PostCompact hook, no workflow-check hook, no auto-sync on session end |
+| **Hooks** | Missing auto-format, no .env protection, dead PostCompact hooks (the event doesn't exist — `--fix` migrates to a SessionStart `compact` matcher), missing workflow-check hook, missing jq, no auto-sync on session end |
 | **Rules** | Dead rule files, stale references, empty configs, missing `.claude/rules/workflow.md` |
 | **Permissions** | Credential exposure (~/.ssh, ~/.aws), blanket Bash approval, bypass-mode unprotected |
 | **MCP Servers** | Invalid transport configs, missing commands/URLs |
@@ -134,7 +134,7 @@ Reads your manifest files (package.json, go.mod, pyproject.toml, etc.) and gener
 
 **What init writes:**
 - Always: `CLAUDE.md`, `TASKS.md`, `BACKLOG.md`, `.claude/settings.json`
-- Creates when missing: `.claude/.gitignore`, `.claudeignore`, `.claude/rules/conventions.md`
+- Creates when missing: `.claude/.gitignore`, `.claudeignore`, `.claude/rules/conventions.md`, `.claude/rules/workflow.md`, `.claude/rules/hooks.md`, `.claude/rules/verification.md`, `.claude/agents/code-reviewer.md`
 - Offers `/lp-enhance` install (project/global/skip) if not already present
 - CLAUDE.md includes a stop-and-swarm rule: after 3 failed attempts, Claude spins up parallel agents instead of retrying the same approach
 
@@ -213,25 +213,35 @@ CLAUDE.md rules are ~80% reliable. Hooks are 100% enforced by the harness. Init
 | **Auto-format** | After any Write/Edit | Runs your language's formatter (prettier, ruff, gofmt, rustfmt, etc.) |
 | **SessionStart** | Session opens | Injects TASKS.md so Claude knows where you left off |
 | **PostCompact** | After context compression | Re-injects TASKS.md so Claude doesn't lose sprint state mid-session |
-| **workflow-check** | After BACKLOG.md/TASKS.md Edit/Write | Warns on duplicate WP IDs across files, TASKS.md > 80 lines, Current Sprint > 15 items, Session Log > 3 entries |
+| **workflow-check** | After BACKLOG.md/TASKS.md Edit/Write | Injects context warnings: WP entry in both files, TASKS.md > 80 lines, Current Sprint > 15 items, Session Log > 3 entries, dependency-blind pulls |
 | **sprint-size / sprint-open** | Session start / `git commit` | Warns on microsprints (<3 WPs), oversized sprints (>7 WPs), new sprint opened without BACKLOG cleanup |
 
-Memory projects get two additional hooks:
+Memory projects get three additional hooks:
 
 | Hook | Trigger | What it does |
 |---|---|---|
 | **SessionStart pull** | Session opens | Auto-pulls memories from GitHub Gist |
+| **SessionStart context** | Session opens | Injects the most relevant memories into Claude's context (6-signal scoring + diversity + token budget) |
 | **SessionEnd push** | Session closes | Auto-pushes new memories to GitHub Gist |
 
 ## Memory (optional)
 
 Claude's built-in memory resets per machine. Launchpad gives each project persistent, cross-device memory that syncs via a private GitHub Gist. Switch laptops and your decisions are already there.
 
+**Why this memory and not another:**
+
+- **Free cross-machine sync.** Native Claude Code memory is single-machine; cloud memory layers need API keys and subscriptions. Launchpad syncs through a private GitHub Gist you already have — zero cost, deletions propagate, machines converge.
+- **Measured, not assumed.** The only Claude Code memory with a benchmark suite (59 tests) gating every release: retrieval quality, injection quality, decay accuracy, scale. `doctor` diagnoses memory health; `eval` proves behavior.
+- **Zero infrastructure.** One native dep, stdio MCP, local SQLite. No Docker, no vector DB service, no localhost API server, no cloud account.
+- **Engineered injection.** Session context is packed by 6-signal relevance scoring with diversity re-ranking under a token budget — not just "last N memories".
+
 ```bash
 claude-launchpad memory
 ```
 
-Interactive setup if not installed, stats if it is. Requires native deps first: `npm install better-sqlite3 sqlite-vec`. Sync requires the [GitHub CLI](https://cli.github.com/).
+Interactive setup if not installed, stats if it is. The one native dep is installed for you (`npm install -g better-sqlite3`) or on demand. Sync requires the [GitHub CLI](https://cli.github.com/).
+
+Once set up, `claude-launchpad memory sync` is the everyday command — pull + push in one call, so every machine has the same project brain. Deletions propagate too (tombstones): machines converge to the same memory set, never more, never less. This is the piece Claude Code's built-in memory doesn't do — see [built-in vs Launchpad memory](https://mboss37.github.io/claude-launchpad/docs/memory#built-in-memory-vs-launchpad-memory).
 
 - Relevant memories auto-injected at session start, new memories stored as Claude works
 - Stale knowledge fades, important decisions persist

package/dist/{chunk-P2LGPNNY.js → chunk-D6RAMWH6.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   log
-} from "./chunk-3OFOCOXM.js";
+} from "./chunk-QEPE3WVF.js";
 
 // src/commands/memory/utils/require-deps.ts
 import { createRequire } from "module";
@@ -31,7 +31,7 @@ async function requireMemoryDeps() {
     log.blank();
     log.info("Run this to install them:");
     log.blank();
-    log.step("  npm install -g better-sqlite3 sqlite-vec");
+    log.step("  npm install -g better-sqlite3");
     log.blank();
     log.info("This requires a C++ compiler (Xcode on macOS, build-essential on Linux).");
     log.info("After installing, run `claude-launchpad memory` again.");
@@ -44,4 +44,4 @@ export {
   cwdRequire,
   requireMemoryDeps
 };
-//# sourceMappingURL=chunk-P2LGPNNY.js.map
+//# sourceMappingURL=chunk-D6RAMWH6.js.map

package/dist/{chunk-P2LGPNNY.js.map → chunk-D6RAMWH6.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/commands/memory/utils/require-deps.ts"],"sourcesContent":["import { createRequire } from \"node:module\";\nimport { execSync } from \"node:child_process\";\nimport { join } from \"node:path\";\nimport { log } from \"../../../lib/output.js\";\n\n/**\n * Require that resolves native deps from multiple locations:\n * 1. cwd's node_modules (local project install)\n * 2. Global node_modules (npm install -g)\n * 3. CLI's own resolution chain (fallback)\n */\nexport function cwdRequire(id: string): unknown {\n  // Try local project first\n  try {\n    const localRequire = createRequire(join(process.cwd(), \"package.json\"));\n    return localRequire(id);\n  } catch { /* not in local */ }\n\n  // Try global node_modules\n  try {\n    const globalPrefix = execSync(\"npm config get prefix\", { encoding: \"utf-8\" }).trim();\n    const globalRequire = createRequire(join(globalPrefix, \"lib\", \"node_modules\", \"package.json\"));\n    return globalRequire(id);\n  } catch { /* not in global */ }\n\n  throw new Error(`Cannot find module '${id}' in local or global node_modules`);\n}\n\n/**\n * Check if memory native dependencies are available.\n * Called at the start of any subcommand that needs SQLite.\n * Returns true if deps are available, exits with helpful message if not.\n */\nexport async function requireMemoryDeps(): Promise<boolean> {\n  try {\n    cwdRequire(\"better-sqlite3\");\n    return true;\n  } catch {\n    log.blank();\n    log.error(\"Memory system requires native dependencies that are not installed.\");\n    log.blank();\n    log.info(\"Run this to install them:\");\n    log.blank();\n    log.step(\"  npm install -g better-sqlite3 sqlite-vec\");\n    log.blank();\n    log.info(\"This requires a C++ compiler (Xcode on macOS, build-essential on Linux).\");\n    log.info(\"After installing, run `claude-launchpad memory` again.\");\n    log.blank();\n    process.exit(1);\n  }\n}\n\n"],"mappings":";;;;;;AAAA,SAAS,qBAAqB;AAC9B,SAAS,gBAAgB;AACzB,SAAS,YAAY;AASd,SAAS,WAAW,IAAqB;AAE9C,MAAI;AACF,UAAM,eAAe,cAAc,KAAK,QAAQ,IAAI,GAAG,cAAc,CAAC;AACtE,WAAO,aAAa,EAAE;AAAA,EACxB,QAAQ;AAAA,EAAqB;AAG7B,MAAI;AACF,UAAM,eAAe,SAAS,yBAAyB,EAAE,UAAU,QAAQ,CAAC,EAAE,KAAK;AACnF,UAAM,gBAAgB,cAAc,KAAK,cAAc,OAAO,gBAAgB,cAAc,CAAC;AAC7F,WAAO,cAAc,EAAE;AAAA,EACzB,QAAQ;AAAA,EAAsB;AAE9B,QAAM,IAAI,MAAM,uBAAuB,EAAE,mCAAmC;AAC9E;AAOA,eAAsB,oBAAsC;AAC1D,MAAI;AACF,eAAW,gBAAgB;AAC3B,WAAO;AAAA,EACT,QAAQ;AACN,QAAI,MAAM;AACV,QAAI,MAAM,oEAAoE;AAC9E,QAAI,MAAM;AACV,QAAI,KAAK,2BAA2B;AACpC,QAAI,MAAM;AACV,QAAI,KAAK,4CAA4C;AACrD,QAAI,MAAM;AACV,QAAI,KAAK,0EAA0E;AACnF,QAAI,KAAK,wDAAwD;AACjE,QAAI,MAAM;AACV,YAAQ,KAAK,CAAC;AAAA,EAChB;AACF;","names":[]}
+{"version":3,"sources":["../src/commands/memory/utils/require-deps.ts"],"sourcesContent":["import { createRequire } from \"node:module\";\nimport { execSync } from \"node:child_process\";\nimport { join } from \"node:path\";\nimport { log } from \"../../../lib/output.js\";\n\n/**\n * Require that resolves native deps from multiple locations:\n * 1. cwd's node_modules (local project install)\n * 2. Global node_modules (npm install -g)\n * 3. CLI's own resolution chain (fallback)\n */\nexport function cwdRequire(id: string): unknown {\n  // Try local project first\n  try {\n    const localRequire = createRequire(join(process.cwd(), \"package.json\"));\n    return localRequire(id);\n  } catch { /* not in local */ }\n\n  // Try global node_modules\n  try {\n    const globalPrefix = execSync(\"npm config get prefix\", { encoding: \"utf-8\" }).trim();\n    const globalRequire = createRequire(join(globalPrefix, \"lib\", \"node_modules\", \"package.json\"));\n    return globalRequire(id);\n  } catch { /* not in global */ }\n\n  throw new Error(`Cannot find module '${id}' in local or global node_modules`);\n}\n\n/**\n * Check if memory native dependencies are available.\n * Called at the start of any subcommand that needs SQLite.\n * Returns true if deps are available, exits with helpful message if not.\n */\nexport async function requireMemoryDeps(): Promise<boolean> {\n  try {\n    cwdRequire(\"better-sqlite3\");\n    return true;\n  } catch {\n    log.blank();\n    log.error(\"Memory system requires native dependencies that are not installed.\");\n    log.blank();\n    log.info(\"Run this to install them:\");\n    log.blank();\n    log.step(\"  npm install -g better-sqlite3\");\n    log.blank();\n    log.info(\"This requires a C++ compiler (Xcode on macOS, build-essential on Linux).\");\n    log.info(\"After installing, run `claude-launchpad memory` again.\");\n    log.blank();\n    process.exit(1);\n  }\n}\n\n"],"mappings":";;;;;;AAAA,SAAS,qBAAqB;AAC9B,SAAS,gBAAgB;AACzB,SAAS,YAAY;AASd,SAAS,WAAW,IAAqB;AAE9C,MAAI;AACF,UAAM,eAAe,cAAc,KAAK,QAAQ,IAAI,GAAG,cAAc,CAAC;AACtE,WAAO,aAAa,EAAE;AAAA,EACxB,QAAQ;AAAA,EAAqB;AAG7B,MAAI;AACF,UAAM,eAAe,SAAS,yBAAyB,EAAE,UAAU,QAAQ,CAAC,EAAE,KAAK;AACnF,UAAM,gBAAgB,cAAc,KAAK,cAAc,OAAO,gBAAgB,cAAc,CAAC;AAC7F,WAAO,cAAc,EAAE;AAAA,EACzB,QAAQ;AAAA,EAAsB;AAE9B,QAAM,IAAI,MAAM,uBAAuB,EAAE,mCAAmC;AAC9E;AAOA,eAAsB,oBAAsC;AAC1D,MAAI;AACF,eAAW,gBAAgB;AAC3B,WAAO;AAAA,EACT,QAAQ;AACN,QAAI,MAAM;AACV,QAAI,MAAM,oEAAoE;AAC9E,QAAI,MAAM;AACV,QAAI,KAAK,2BAA2B;AACpC,QAAI,MAAM;AACV,QAAI,KAAK,iCAAiC;AAC1C,QAAI,MAAM;AACV,QAAI,KAAK,0EAA0E;AACnF,QAAI,KAAK,wDAAwD;AACjE,QAAI,MAAM;AACV,YAAQ,KAAK,CAAC;AAAA,EAChB;AACF;","names":[]}

package/dist/chunk-HSGSTSVN.js

@@ -0,0 +1,212 @@
+#!/usr/bin/env node
+
+// src/commands/memory/storage/relation-repo.ts
+function rowToRelation(row) {
+  return {
+    sourceId: row.source_id,
+    targetId: row.target_id,
+    relationType: row.relation_type,
+    createdAt: row.created_at
+  };
+}
+var RelationRepo = class {
+  #stmts;
+  constructor(db) {
+    this.#stmts = {
+      insert: db.prepare(`
+        INSERT OR IGNORE INTO relations (source_id, target_id, relation_type)
+        VALUES (?, ?, ?)
+      `),
+      getBySource: db.prepare("SELECT * FROM relations WHERE source_id = ?"),
+      getByTarget: db.prepare("SELECT * FROM relations WHERE target_id = ?"),
+      getByMemory: db.prepare(`
+        SELECT * FROM relations WHERE source_id = ? OR target_id = ?
+      `),
+      delete: db.prepare(`
+        DELETE FROM relations WHERE source_id = ? AND target_id = ? AND relation_type = ?
+      `),
+      countByMemory: db.prepare(`
+        SELECT COUNT(*) as count FROM relations WHERE source_id = ? OR target_id = ?
+      `),
+      count: db.prepare("SELECT COUNT(*) as count FROM relations"),
+      getAll: db.prepare("SELECT * FROM relations"),
+      deleteOrphaned: db.prepare(`
+        DELETE FROM relations
+        WHERE source_id NOT IN (SELECT id FROM memories)
+           OR target_id NOT IN (SELECT id FROM memories)
+      `)
+    };
+  }
+  create(sourceId, targetId, relationType) {
+    const result = this.#stmts.insert.run(sourceId, targetId, relationType);
+    return result.changes > 0;
+  }
+  getBySource(sourceId) {
+    const rows = this.#stmts.getBySource.all(sourceId);
+    return rows.map(rowToRelation);
+  }
+  getByTarget(targetId) {
+    const rows = this.#stmts.getByTarget.all(targetId);
+    return rows.map(rowToRelation);
+  }
+  getByMemory(memoryId) {
+    const rows = this.#stmts.getByMemory.all(memoryId, memoryId);
+    return rows.map(rowToRelation);
+  }
+  delete(sourceId, targetId, relationType) {
+    const result = this.#stmts.delete.run(sourceId, targetId, relationType);
+    return result.changes > 0;
+  }
+  countByMemory(memoryId) {
+    const row = this.#stmts.countByMemory.get(memoryId, memoryId);
+    return row.count;
+  }
+  count() {
+    const row = this.#stmts.count.get();
+    return row.count;
+  }
+  getAll() {
+    const rows = this.#stmts.getAll.all();
+    return rows.map(rowToRelation);
+  }
+  deleteOrphaned() {
+    const result = this.#stmts.deleteOrphaned.run();
+    return result.changes;
+  }
+};
+
+// src/commands/memory/storage/search-repo.ts
+var SearchRepo = class {
+  #stmts;
+  constructor(db) {
+    this.#stmts = {
+      ftsSearch: db.prepare(`
+        SELECT
+          m.rowid,
+          m.id as memory_id,
+          bm25(memories_fts, 5.0, 1.0, 2.0) as rank
+        FROM memories_fts f
+        JOIN memories m ON m.rowid = f.rowid
+        WHERE memories_fts MATCH @query
+        ORDER BY rank
+        LIMIT @limit
+      `),
+      ftsSearchByProject: db.prepare(`
+        SELECT
+          m.rowid,
+          m.id as memory_id,
+          bm25(memories_fts, 5.0, 1.0, 2.0) as rank
+        FROM memories_fts f
+        JOIN memories m ON m.rowid = f.rowid
+        WHERE memories_fts MATCH @query
+          AND (m.project = @project OR m.project IS NULL)
+        ORDER BY rank
+        LIMIT @limit
+      `),
+      ftsSearchFiltered: db.prepare(`
+        SELECT
+          m.rowid,
+          m.id as memory_id,
+          bm25(memories_fts, 5.0, 1.0, 2.0) as rank
+        FROM memories_fts f
+        JOIN memories m ON m.rowid = f.rowid
+        WHERE memories_fts MATCH @query
+          AND m.type = @type
+          AND m.importance >= @minImportance
+        ORDER BY rank
+        LIMIT @limit
+      `),
+      ftsSearchFilteredByProject: db.prepare(`
+        SELECT
+          m.rowid,
+          m.id as memory_id,
+          bm25(memories_fts, 5.0, 1.0, 2.0) as rank
+        FROM memories_fts f
+        JOIN memories m ON m.rowid = f.rowid
+        WHERE memories_fts MATCH @query
+          AND m.type = @type
+          AND m.importance >= @minImportance
+          AND (m.project = @project OR m.project IS NULL)
+        ORDER BY rank
+        LIMIT @limit
+      `)
+    };
+  }
+  /**
+   * Full-text search using BM25 ranking.
+   * Returns matches sorted by relevance (most relevant first).
+   */
+  searchFts(options) {
+    const ftsQuery = toFtsQuery(options.query);
+    if (!ftsQuery) return [];
+    try {
+      const hasType = !!options.type;
+      const hasProject = !!options.project;
+      let rows;
+      if (hasType && hasProject) {
+        rows = this.#stmts.ftsSearchFilteredByProject.all({
+          query: ftsQuery,
+          limit: options.limit,
+          type: options.type,
+          minImportance: options.minImportance ?? 0,
+          project: options.project
+        });
+      } else if (hasType) {
+        rows = this.#stmts.ftsSearchFiltered.all({
+          query: ftsQuery,
+          limit: options.limit,
+          type: options.type,
+          minImportance: options.minImportance ?? 0
+        });
+      } else if (hasProject) {
+        rows = this.#stmts.ftsSearchByProject.all({
+          query: ftsQuery,
+          limit: options.limit,
+          project: options.project
+        });
+      } else {
+        rows = this.#stmts.ftsSearch.all({
+          query: ftsQuery,
+          limit: options.limit
+        });
+      }
+      return rows.map((r) => ({
+        rowid: r.rowid,
+        memoryId: r.memory_id,
+        rank: r.rank
+      }));
+    } catch (err) {
+      console.error("[agentic-memory] FTS5 search error:", err instanceof Error ? err.message : err);
+      return [];
+    }
+  }
+};
+var SYNONYMS = {
+  auth: ["authentication", "login", "oauth", "jwt"],
+  authentication: ["auth", "login", "oauth"],
+  login: ["auth", "authentication", "signin"],
+  db: ["database", "sql", "sqlite", "postgres"],
+  database: ["db", "sql", "sqlite", "postgres"],
+  api: ["endpoint", "route", "rest", "graphql"],
+  deploy: ["deployment", "release", "ship", "publish"],
+  test: ["testing", "spec", "jest", "vitest"],
+  config: ["configuration", "settings", "setup"],
+  err: ["error", "exception", "crash", "bug"],
+  error: ["err", "exception", "crash", "bug"]
+};
+function toFtsQuery(input) {
+  const words = input.replace(/[^\w\s]/g, " ").split(/\s+/).filter((w) => w.length > 0);
+  if (words.length === 0) return null;
+  const expanded = words.flatMap((w) => {
+    const lower = w.toLowerCase();
+    const syns = SYNONYMS[lower];
+    return syns ? [w, ...syns] : [w];
+  });
+  return [...new Set(expanded)].map((w) => `"${w}"`).join(" OR ");
+}
+
+export {
+  RelationRepo,
+  SearchRepo
+};
+//# sourceMappingURL=chunk-HSGSTSVN.js.map

package/dist/chunk-HSGSTSVN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/commands/memory/storage/relation-repo.ts","../src/commands/memory/storage/search-repo.ts"],"sourcesContent":["import type Database from 'better-sqlite3';\nimport type { Relation, RelationType } from '../types.js';\n\ninterface RelationRow {\n  source_id: string;\n  target_id: string;\n  relation_type: string;\n  created_at: string;\n}\n\nfunction rowToRelation(row: RelationRow): Relation {\n  return {\n    sourceId: row.source_id,\n    targetId: row.target_id,\n    relationType: row.relation_type as RelationType,\n    createdAt: row.created_at,\n  };\n}\n\nexport class RelationRepo {\n  readonly #stmts;\n\n  constructor(db: Database.Database) {\n    this.#stmts = {\n      insert: db.prepare(`\n        INSERT OR IGNORE INTO relations (source_id, target_id, relation_type)\n        VALUES (?, ?, ?)\n      `),\n      getBySource: db.prepare('SELECT * FROM relations WHERE source_id = ?'),\n      getByTarget: db.prepare('SELECT * FROM relations WHERE target_id = ?'),\n      getByMemory: db.prepare(`\n        SELECT * FROM relations WHERE source_id = ? OR target_id = ?\n      `),\n      delete: db.prepare(`\n        DELETE FROM relations WHERE source_id = ? AND target_id = ? AND relation_type = ?\n      `),\n      countByMemory: db.prepare(`\n        SELECT COUNT(*) as count FROM relations WHERE source_id = ? OR target_id = ?\n      `),\n      count: db.prepare('SELECT COUNT(*) as count FROM relations'),\n      getAll: db.prepare('SELECT * FROM relations'),\n      deleteOrphaned: db.prepare(`\n        DELETE FROM relations\n        WHERE source_id NOT IN (SELECT id FROM memories)\n           OR target_id NOT IN (SELECT id FROM memories)\n      `),\n    };\n  }\n\n  create(sourceId: string, targetId: string, relationType: RelationType): boolean {\n    const result = this.#stmts.insert.run(sourceId, targetId, relationType);\n    return result.changes > 0;\n  }\n\n  getBySource(sourceId: string): readonly Relation[] {\n    const rows = this.#stmts.getBySource.all(sourceId) as RelationRow[];\n    return rows.map(rowToRelation);\n  }\n\n  getByTarget(targetId: string): readonly Relation[] {\n    const rows = this.#stmts.getByTarget.all(targetId) as RelationRow[];\n    return rows.map(rowToRelation);\n  }\n\n  getByMemory(memoryId: string): readonly Relation[] {\n    const rows = this.#stmts.getByMemory.all(memoryId, memoryId) as RelationRow[];\n    return rows.map(rowToRelation);\n  }\n\n  delete(sourceId: string, targetId: string, relationType: RelationType): boolean {\n    const result = this.#stmts.delete.run(sourceId, targetId, relationType);\n    return result.changes > 0;\n  }\n\n  countByMemory(memoryId: string): number {\n    const row = this.#stmts.countByMemory.get(memoryId, memoryId) as { count: number };\n    return row.count;\n  }\n\n  count(): number {\n    const row = this.#stmts.count.get() as { count: number };\n    return row.count;\n  }\n\n  getAll(): readonly Relation[] {\n    const rows = this.#stmts.getAll.all() as RelationRow[];\n    return rows.map(rowToRelation);\n  }\n\n  deleteOrphaned(): number {\n    const result = this.#stmts.deleteOrphaned.run();\n    return result.changes;\n  }\n}\n","import type Database from 'better-sqlite3';\nimport type { FtsMatch, MemoryType } from '../types.js';\n\n// ── FTS5 Search ───────────────────────────────────────────────\n\nexport interface FtsSearchOptions {\n  readonly query: string;\n  readonly limit: number;\n  readonly type?: MemoryType;\n  readonly minImportance?: number;\n  readonly project?: string;\n}\n\n\nexport class SearchRepo {\n  readonly #stmts;\n\n  constructor(db: Database.Database) {\n    // FTS5 search with BM25 ranking (weights: title=5.0, content=1.0, tags=2.0)\n    this.#stmts = {\n      ftsSearch: db.prepare(`\n        SELECT\n          m.rowid,\n          m.id as memory_id,\n          bm25(memories_fts, 5.0, 1.0, 2.0) as rank\n        FROM memories_fts f\n        JOIN memories m ON m.rowid = f.rowid\n        WHERE memories_fts MATCH @query\n        ORDER BY rank\n        LIMIT @limit\n      `),\n      ftsSearchByProject: db.prepare(`\n        SELECT\n          m.rowid,\n          m.id as memory_id,\n          bm25(memories_fts, 5.0, 1.0, 2.0) as rank\n        FROM memories_fts f\n        JOIN memories m ON m.rowid = f.rowid\n        WHERE memories_fts MATCH @query\n          AND (m.project = @project OR m.project IS NULL)\n        ORDER BY rank\n        LIMIT @limit\n      `),\n      ftsSearchFiltered: db.prepare(`\n        SELECT\n          m.rowid,\n          m.id as memory_id,\n          bm25(memories_fts, 5.0, 1.0, 2.0) as rank\n        FROM memories_fts f\n        JOIN memories m ON m.rowid = f.rowid\n        WHERE memories_fts MATCH @query\n          AND m.type = @type\n          AND m.importance >= @minImportance\n        ORDER BY rank\n        LIMIT @limit\n      `),\n      ftsSearchFilteredByProject: db.prepare(`\n        SELECT\n          m.rowid,\n          m.id as memory_id,\n          bm25(memories_fts, 5.0, 1.0, 2.0) as rank\n        FROM memories_fts f\n        JOIN memories m ON m.rowid = f.rowid\n        WHERE memories_fts MATCH @query\n          AND m.type = @type\n          AND m.importance >= @minImportance\n          AND (m.project = @project OR m.project IS NULL)\n        ORDER BY rank\n        LIMIT @limit\n      `),\n    };\n  }\n\n  /**\n   * Full-text search using BM25 ranking.\n   * Returns matches sorted by relevance (most relevant first).\n   */\n  searchFts(options: FtsSearchOptions): readonly FtsMatch[] {\n    const ftsQuery = toFtsQuery(options.query);\n    if (!ftsQuery) return [];\n\n    try {\n      const hasType = !!options.type;\n      const hasProject = !!options.project;\n\n      let rows: FtsRow[];\n      if (hasType && hasProject) {\n        rows = this.#stmts.ftsSearchFilteredByProject.all({\n          query: ftsQuery, limit: options.limit,\n          type: options.type, minImportance: options.minImportance ?? 0,\n          project: options.project,\n        }) as FtsRow[];\n      } else if (hasType) {\n        rows = this.#stmts.ftsSearchFiltered.all({\n          query: ftsQuery, limit: options.limit,\n          type: options.type, minImportance: options.minImportance ?? 0,\n        }) as FtsRow[];\n      } else if (hasProject) {\n        rows = this.#stmts.ftsSearchByProject.all({\n          query: ftsQuery, limit: options.limit,\n          project: options.project,\n        }) as FtsRow[];\n      } else {\n        rows = this.#stmts.ftsSearch.all({\n          query: ftsQuery, limit: options.limit,\n        }) as FtsRow[];\n      }\n\n      return rows.map(r => ({\n        rowid: r.rowid,\n        memoryId: r.memory_id,\n        rank: r.rank,\n      }));\n    } catch (err) {\n      // FTS5 MATCH throws on invalid query syntax - degrade gracefully\n      console.error('[agentic-memory] FTS5 search error:', err instanceof Error ? err.message : err);\n      return [];\n    }\n  }\n\n}\n\n// ── Internal helpers ──────────────────────────────────────────\n\ninterface FtsRow {\n  rowid: number;\n  memory_id: string;\n  rank: number;\n}\n\n// Synonym expansion for common dev terms\nconst SYNONYMS: Record<string, readonly string[]> = {\n  auth: ['authentication', 'login', 'oauth', 'jwt'],\n  authentication: ['auth', 'login', 'oauth'],\n  login: ['auth', 'authentication', 'signin'],\n  db: ['database', 'sql', 'sqlite', 'postgres'],\n  database: ['db', 'sql', 'sqlite', 'postgres'],\n  api: ['endpoint', 'route', 'rest', 'graphql'],\n  deploy: ['deployment', 'release', 'ship', 'publish'],\n  test: ['testing', 'spec', 'jest', 'vitest'],\n  config: ['configuration', 'settings', 'setup'],\n  err: ['error', 'exception', 'crash', 'bug'],\n  error: ['err', 'exception', 'crash', 'bug'],\n};\n\n/**\n * Convert a natural language query to FTS5 query syntax.\n * Expands synonyms and wraps words in quotes for safe matching.\n */\nfunction toFtsQuery(input: string): string | null {\n  const words = input\n    .replace(/[^\\w\\s]/g, ' ')\n    .split(/\\s+/)\n    .filter(w => w.length > 0);\n\n  if (words.length === 0) return null;\n\n  const expanded = words.flatMap((w) => {\n    const lower = w.toLowerCase();\n    const syns = SYNONYMS[lower];\n    return syns ? [w, ...syns] : [w];\n  });\n\n  return [...new Set(expanded)].map(w => `\"${w}\"`).join(' OR ');\n}\n"],"mappings":"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","names":[]}