@lh8ppl/claude-memory-kit 0.2.3 → 0.2.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lh8ppl/claude-memory-kit",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "cmk — the CLI for claude-memory-kit. Per-project, in-repo memory system for Claude Code.",
   "type": "module",
   "bin": {

package/src/doctor.mjs

@@ -1,4 +1,4 @@
-// `cmk doctor` — health checks HC-1..HC-9 (Task 37, T-031).
+// `cmk doctor` — health checks HC-1..HC-7 (Task 37, T-031; memsearch HC-1/HC-7 removed in Task 120).
 //
 // Public boundary:
 //   async runDoctor({projectRoot, userDir, now, promptUser?, ...overrides})
@@ -6,7 +6,7 @@
 //
 // HCResult shape:
 //   {
-//     id: 'HC-1' | ... | 'HC-9',
+//     id: 'HC-1' | ... | 'HC-7',
 //     name: string,
 //     status: 'pass' | 'fail' | 'skip',
 //     message: string,
@@ -15,10 +15,10 @@
 //   }
 //
 // Per design §14. Composes on:
-//   - cooldown.mjs (HC-3 distill freshness via cooldown marker mtime is
+//   - cooldown.mjs (HC-2 distill freshness via cooldown marker mtime is
 //     NOT used — we read recent.md mtime directly, more accurate)
-//   - lazy-compress.mjs::cronSentinelPath (HC-6 cron registration check)
-//   - lock-discipline.mjs::detectStaleLocks (HC-9)
+//   - lazy-compress.mjs::cronSentinelPath (HC-5 cron registration check)
+//   - lock-discipline.mjs::detectStaleLocks (HC-7)
 //   - platform-commands.mjs — cross-platform repair command emission
 //
 // Critical rule per design §14 + tasks.md 37.5: any repair requiring
@@ -38,7 +38,6 @@ import {
   statSync,
   writeFileSync,
 } from 'node:fs';
-import { spawnBinSync } from './spawn-bin.mjs';
 import { homedir } from 'node:os';
 import { basename, join } from 'node:path';
 import { nowIso } from './audit-log.mjs';
@@ -56,62 +55,15 @@ const MEMORY_DIR_REL = ['context', 'memory'];
 const LOCKS_REL = ['context', '.locks'];
 const NATIVE_MEMORY_LOG_REL = ['context', '.locks', 'native-memory-status.log'];
 
-// --- HC-1: memsearch installed ----------------------------------------
-async function hc1Memsearch() {
-  // Layer 5b (semantic search) is OPTIONAL per ADR-0008. Missing
-  // memsearch → skip (not fail). The kit ships keyword-only as v0.1.0;
-  // semantic requires a separate `pip install memsearch[onnx]`.
-  // `requiresInstall: true` so the CLI prompts before auto-installing.
-  try {
-    // spawnBinSync resolves the Windows .cmd shim without `shell:true`+args
-    // (no DEP0190; #4). memsearch's only arg is `--version` (no spaces), so
-    // the quoting is a no-op here — the win is dropping the deprecated combo.
-    const r = spawnBinSync('memsearch', ['--version'], {
-      encoding: 'utf8',
-      // M1 fix (skill-review 2026-05-28): 3.5s tolerates Windows
-      // cold-Python startup (AV scan + .pyc generation on first hit
-      // can push past 2s for a healthy install). HC-2..9 are file-
-      // system ops that complete in ≪100ms total, so HC-1 + the rest
-      // still fits comfortably inside the 5s NFR budget. Timeout →
-      // 'skip' so cmk doctor completes regardless.
-      timeout: 3_500,
-    });
-    if (r.status === 0) {
-      return {
-        id: 'HC-1',
-        name: 'memsearch installed (semantic search backend)',
-        status: 'pass',
-        message: `memsearch ${(r.stdout || '').trim() || 'detected'}`,
-      };
-    }
-  } catch {
-    // fall through to skip
-  }
-  // The user (2026-05-28): make the feature impact explicit so users
-  // understand WHAT THEY LOSE by skipping the install, not just that
-  // a check failed. Matches the user's directive: "ask before we do
-  // anything, explain if they dont install they dont get certain
-  // features".
-  return {
-    id: 'HC-1',
-    name: 'memsearch installed (semantic search backend)',
-    status: 'skip',
-    message:
-      'memsearch not on PATH — Layer 5b semantic backend disabled. Features unavailable: `cmk search --mode=semantic` (will error), `cmk search --mode=hybrid` (will error). Keyword search (`cmk search --mode=keyword`, default) still works fully.',
-    recoveryCommand: 'python -m pip install "memsearch[onnx]"',
-    requiresInstall: true,
-  };
-}
-
-// --- HC-2: Stop + SessionStart hooks registered -----------------------
-function hc2Hooks({ projectRoot }) {
+// --- HC-1: Stop + SessionStart hooks registered -----------------------
+function hc1Hooks({ projectRoot }) {
   // Per design §5 — the kit's hooks live in .claude/settings.json
   // alongside its plugin manifest. Required for auto-extract +
   // session-end compression to fire.
   const settingsPath = join(projectRoot, '.claude', 'settings.json');
   if (!existsSync(settingsPath)) {
     return {
-      id: 'HC-2',
+      id: 'HC-1',
       name: 'Stop + SessionStart hooks registered',
       status: 'fail',
       message: '.claude/settings.json missing — hooks not wired',
@@ -123,7 +75,7 @@ function hc2Hooks({ projectRoot }) {
     settings = JSON.parse(readFileSync(settingsPath, 'utf8'));
   } catch (err) {
     return {
-      id: 'HC-2',
+      id: 'HC-1',
       name: 'Stop + SessionStart hooks registered',
       status: 'fail',
       message: `.claude/settings.json parse error: ${err?.message ?? err}`,
@@ -170,7 +122,7 @@ function hc2Hooks({ projectRoot }) {
   }
   if (missing.length > 0) {
     return {
-      id: 'HC-2',
+      id: 'HC-1',
       name: 'Stop + SessionStart hooks registered',
       status: 'fail',
       message: `missing hook references: ${missing.join(', ')}`,
@@ -178,15 +130,15 @@ function hc2Hooks({ projectRoot }) {
     };
   }
   return {
-    id: 'HC-2',
+    id: 'HC-1',
     name: 'Stop + SessionStart hooks registered',
     status: 'pass',
     message: 'all kit hooks wired to their correct event arrays in .claude/settings.json',
   };
 }
 
-// --- HC-3: distill freshness (≤2 days) --------------------------------
-function hc3DistillFreshness({ projectRoot, now }) {
+// --- HC-2: distill freshness (≤2 days) --------------------------------
+function hc2DistillFreshness({ projectRoot, now }) {
   const recentPath = join(projectRoot, ...RECENT_MD_REL);
   if (!existsSync(recentPath)) {
     // Not a failure: on a fresh project there's nothing distilled yet, and
@@ -194,7 +146,7 @@ function hc3DistillFreshness({ projectRoot, now }) {
     // (or `cmk daily-distill`). "Stale recent.md" below IS a real fail; a
     // never-built one is just "not yet" — mirror HC-5's skip-on-fresh.
     return {
-      id: 'HC-3',
+      id: 'HC-2',
       name: 'Daily distill is fresh (≤2 days)',
       status: 'skip',
       message: 'recent.md not built yet — nothing to distill. Runs automatically (lazy-on-read at SessionStart, or `cmk daily-distill`) once there is session content.',
@@ -205,7 +157,7 @@ function hc3DistillFreshness({ projectRoot, now }) {
     mtimeMs = statSync(recentPath).mtimeMs;
   } catch (err) {
     return {
-      id: 'HC-3',
+      id: 'HC-2',
       name: 'Daily distill is fresh (≤2 days)',
       status: 'fail',
       message: `recent.md stat error: ${err?.message ?? err}`,
@@ -216,7 +168,7 @@ function hc3DistillFreshness({ projectRoot, now }) {
   const ageMs = nowMs - mtimeMs;
   if (ageMs > TWO_DAYS_MS) {
     return {
-      id: 'HC-3',
+      id: 'HC-2',
       name: 'Daily distill is fresh (≤2 days)',
       status: 'fail',
       message: `recent.md ${Math.round(ageMs / (24 * 60 * 60 * 1000))}d old (cutoff: 2d)`,
@@ -224,21 +176,21 @@ function hc3DistillFreshness({ projectRoot, now }) {
     };
   }
   return {
-    id: 'HC-3',
+    id: 'HC-2',
     name: 'Daily distill is fresh (≤2 days)',
     status: 'pass',
     message: `recent.md ${Math.round(ageMs / (60 * 60 * 1000))}h old`,
   };
 }
 
-// --- HC-4: transcripts firing (≤3 days) -------------------------------
-function hc4Transcripts({ projectRoot, now }) {
+// --- HC-3: transcripts firing (≤3 days) -------------------------------
+function hc3Transcripts({ projectRoot, now }) {
   const transcriptsDir = join(projectRoot, ...TRANSCRIPTS_REL);
   if (!existsSync(transcriptsDir)) {
     // Fresh project, never had a Claude Code session here → nothing to fire
     // yet. Skip, don't fail (the dir + first transcript appear on the first turn).
     return {
-      id: 'HC-4',
+      id: 'HC-3',
       name: 'Transcripts firing (≤3 days)',
       status: 'skip',
       message: 'no transcripts yet — they appear after your first Claude Code turn in this project.',
@@ -262,7 +214,7 @@ function hc4Transcripts({ projectRoot, now }) {
     // Dir exists (scaffolded) but no transcripts captured yet → still "not
     // yet", not a failure.
     return {
-      id: 'HC-4',
+      id: 'HC-3',
       name: 'Transcripts firing (≤3 days)',
       status: 'skip',
       message: 'no transcripts yet — they appear after your first Claude Code turn in this project.',
@@ -272,7 +224,7 @@ function hc4Transcripts({ projectRoot, now }) {
     // Transcripts EXIST but none recent → the kit was capturing and stopped.
     // That IS a real signal (the Stop hook may not be firing here).
     return {
-      id: 'HC-4',
+      id: 'HC-3',
       name: 'Transcripts firing (≤3 days)',
       status: 'fail',
       message: 'transcripts exist but none within 3 days — the Stop hook may have stopped firing (is this project Claude Code\'s primary cwd?)',
@@ -280,20 +232,20 @@ function hc4Transcripts({ projectRoot, now }) {
     };
   }
   return {
-    id: 'HC-4',
+    id: 'HC-3',
     name: 'Transcripts firing (≤3 days)',
     status: 'pass',
     message: `${recentCount} transcript(s) within 3 days`,
   };
 }
 
-// --- HC-5: INDEX.md matches context/memory/ ---------------------------
-function hc5IndexConsistency({ projectRoot }) {
+// --- HC-4: INDEX.md matches context/memory/ ---------------------------
+function hc4IndexConsistency({ projectRoot }) {
   const memoryDir = join(projectRoot, ...MEMORY_DIR_REL);
   const indexPath = join(projectRoot, ...MEMORY_INDEX_REL);
   if (!existsSync(memoryDir)) {
     return {
-      id: 'HC-5',
+      id: 'HC-4',
       name: 'INDEX.md matches context/memory/ files',
       status: 'skip',
       message: 'context/memory/ missing — no granular facts to index yet',
@@ -301,7 +253,7 @@ function hc5IndexConsistency({ projectRoot }) {
   }
   if (!existsSync(indexPath)) {
     return {
-      id: 'HC-5',
+      id: 'HC-4',
       name: 'INDEX.md matches context/memory/ files',
       status: 'fail',
       message: 'context/memory/INDEX.md missing',
@@ -316,7 +268,7 @@ function hc5IndexConsistency({ projectRoot }) {
     );
   } catch (err) {
     return {
-      id: 'HC-5',
+      id: 'HC-4',
       name: 'INDEX.md matches context/memory/ files',
       status: 'fail',
       message: `readdir error: ${err?.message ?? err}`,
@@ -330,7 +282,7 @@ function hc5IndexConsistency({ projectRoot }) {
     indexText = readFileSync(indexPath, 'utf8');
   } catch (err) {
     return {
-      id: 'HC-5',
+      id: 'HC-4',
       name: 'INDEX.md matches context/memory/ files',
       status: 'fail',
       message: `INDEX.md read error: ${err?.message ?? err}`,
@@ -365,7 +317,7 @@ function hc5IndexConsistency({ projectRoot }) {
   const inIndexNotFacts = [...indexEntries].filter((f) => !factSet.has(f));
   if (inFactsNotIndex.length === 0 && inIndexNotFacts.length === 0) {
     return {
-      id: 'HC-5',
+      id: 'HC-4',
       name: 'INDEX.md matches context/memory/ files',
       status: 'pass',
       message: `${factFiles.length} fact file(s); INDEX in sync`,
@@ -375,7 +327,7 @@ function hc5IndexConsistency({ projectRoot }) {
   if (inFactsNotIndex.length > 0) parts.push(`missing from INDEX: ${inFactsNotIndex.length}`);
   if (inIndexNotFacts.length > 0) parts.push(`stale in INDEX: ${inIndexNotFacts.length}`);
   return {
-    id: 'HC-5',
+    id: 'HC-4',
     name: 'INDEX.md matches context/memory/ files',
     status: 'fail',
     message: parts.join('; '),
@@ -383,11 +335,11 @@ function hc5IndexConsistency({ projectRoot }) {
   };
 }
 
-// --- HC-6: Cron jobs registered with host scheduler -------------------
-function hc6CronRegistered({ projectRoot }) {
+// --- HC-5: Cron jobs registered with host scheduler -------------------
+function hc5CronRegistered({ projectRoot }) {
   if (existsSync(cronSentinelPath(projectRoot))) {
     return {
-      id: 'HC-6',
+      id: 'HC-5',
       name: 'Cron jobs registered with host scheduler',
       status: 'pass',
       message: 'cron-registered sentinel present',
@@ -398,38 +350,15 @@ function hc6CronRegistered({ projectRoot }) {
   // SKIP, not a FAIL — flagging an optional, working-by-fallback feature as a
   // failure made a healthy fresh install read as broken.
   return {
-    id: 'HC-6',
+    id: 'HC-5',
     name: 'Cron jobs registered with host scheduler',
     status: 'skip',
     message: 'cron not registered (optional) — using the lazy-on-read fallback (compresses at SessionStart). Run `cmk register-crons` for scheduled background compression.',
   };
 }
 
-// --- HC-7: memsearch backend reachable --------------------------------
-function hc7MemsearchReachable(hc1Result) {
-  // Only relevant if HC-1 passed. Skip when memsearch isn't installed.
-  if (hc1Result.status !== 'pass') {
-    return {
-      id: 'HC-7',
-      name: 'memsearch backend reachable',
-      status: 'skip',
-      message: 'depends on HC-1 (memsearch installed) — skipped',
-    };
-  }
-  // HC-1 already proves memsearch --version succeeds. For HC-7 the
-  // additional check would be milvus reachability — out of scope for
-  // v0.1.0's keyword-only ship (Layer 5b is v0.1.x). Treat HC-7 as
-  // pass when HC-1 passes.
-  return {
-    id: 'HC-7',
-    name: 'memsearch backend reachable',
-    status: 'pass',
-    message: 'memsearch responds to --version (milvus reachability is Layer 5b / v0.1.x)',
-  };
-}
-
-// --- HC-8: Native Anthropic Auto Memory status -----------------------
-function hc8NativeAutoMemory({ projectRoot, now }) {
+// --- HC-6: Native Anthropic Auto Memory status -----------------------
+function hc6NativeAutoMemory({ projectRoot, now }) {
   // Per ADR-0011 — detect whether Anthropic's native Auto Memory is
   // also active for this project. Non-fatal; informational. Log the
   // result to context/.locks/native-memory-status.log so users can
@@ -507,19 +436,19 @@ function hc8NativeAutoMemory({ projectRoot, now }) {
   }
 
   return {
-    id: 'HC-8',
+    id: 'HC-6',
     name: 'Native Anthropic Auto Memory status detected',
     status: 'pass',
     message,
   };
 }
 
-// --- HC-9: Stale lock files -------------------------------------------
-function hc9StaleLocks({ projectRoot, userDir }) {
+// --- HC-7: Stale lock files -------------------------------------------
+function hc7StaleLocks({ projectRoot, userDir }) {
   const stale = detectStaleLocks(projectRoot, { userDir }).filter((r) => r.stale);
   if (stale.length === 0) {
     return {
-      id: 'HC-9',
+      id: 'HC-7',
       name: 'No stale lock files',
       status: 'pass',
       message: 'all locks healthy',
@@ -533,7 +462,7 @@ function hc9StaleLocks({ projectRoot, userDir }) {
     ? ` (+ ${stale.length - 1} more — re-run after cleaning to surface)`
     : '';
   return {
-    id: 'HC-9',
+    id: 'HC-7',
     name: 'No stale lock files',
     status: 'fail',
     message: `${stale.length} stale lock(s); first: ${first.path} (${first.reason})${moreNote}`,
@@ -542,7 +471,7 @@ function hc9StaleLocks({ projectRoot, userDir }) {
 }
 
 /**
- * Run the full 9-check health audit.
+ * Run the full 7-check health audit.
  *
  * @param {object} opts
  * @param {string} opts.projectRoot
@@ -573,20 +502,18 @@ export async function runDoctor({
   const ts = now ?? nowIso();
   const resolvedUserDir = userDir ?? join(homedir(), '.claude-memory-kit');
 
-  // Run in order. HC-7 depends on HC-1's verdict.
-  const c1 = await hc1Memsearch();
-  const c2 = hc2Hooks({ projectRoot });
-  const c3 = hc3DistillFreshness({ projectRoot, now: ts });
-  const c4 = hc4Transcripts({ projectRoot, now: ts });
-  const c5 = hc5IndexConsistency({ projectRoot });
-  const c6 = hc6CronRegistered({ projectRoot });
-  const c7 = hc7MemsearchReachable(c1);
-  const c8 = hc8NativeAutoMemory({ projectRoot, now: ts });
-  const c9 = hc9StaleLocks({ projectRoot, userDir: resolvedUserDir });
+  // Run all checks in order.
+  const c1 = hc1Hooks({ projectRoot });
+  const c2 = hc2DistillFreshness({ projectRoot, now: ts });
+  const c3 = hc3Transcripts({ projectRoot, now: ts });
+  const c4 = hc4IndexConsistency({ projectRoot });
+  const c5 = hc5CronRegistered({ projectRoot });
+  const c6 = hc6NativeAutoMemory({ projectRoot, now: ts });
+  const c7 = hc7StaleLocks({ projectRoot, userDir: resolvedUserDir });
 
   return {
     action: 'completed',
-    checks: [c1, c2, c3, c4, c5, c6, c7, c8, c9],
+    checks: [c1, c2, c3, c4, c5, c6, c7],
     duration_ms: Date.now() - t0,
   };
 }

package/src/mcp-server.mjs

@@ -505,7 +505,7 @@ export function buildMcpServer({ projectRoot, userDir, db, semanticBackend }) {
   server.registerTool(
     'mk_search',
     {
-      description: 'Search kit memory (FTS5 keyword by default; semantic + hybrid require Layer 5b memsearch install).',
+      description: 'Search kit memory (FTS5 keyword by default; semantic + hybrid require the Layer-5b semantic backend, not yet shipped).',
       inputSchema: {
         query: z.string().min(1).describe('search query'),
         mode: z.enum(['keyword', 'semantic', 'hybrid']).optional(),

package/src/result-shapes.mjs

@@ -104,9 +104,9 @@ export const ERROR_CATEGORIES = Object.freeze({
   POISON_GUARD: 'poison_guard',
 
   // `cmk search` requested --mode=semantic or --mode=hybrid but the
-  // Layer 5b memsearch+Milvus install isn't present (Task 30, design
+  // Layer-5b semantic backend is not yet shipped (Task 30, design
   // §9.3). Pairs with `process.exitCode = 2` in subcommands.mjs per
-  // tasks.md 30.2's explicit "exit 2 when not installed" contract.
+  // tasks.md 30.2's explicit "exit 2 when unavailable" contract.
   // NO silent fallback to keyword — the user asked for semantic,
   // and the surface should fail-loud so they know what's missing.
   SEMANTIC_UNAVAILABLE: 'semantic_unavailable',

package/src/search.mjs

@@ -11,8 +11,9 @@
 //             ~100ms for 10k bullets. Always available — the keyword
 //             backend ships in v0.1.0 with no extra install.
 //
-//   semantic  memsearch + Milvus (Layer 5b — optional install). The kit
-//             does NOT ship memsearch in v0.1.0; this mode errors with
+//   semantic  the Layer-5b semantic backend (not yet shipped — the embedded
+//             vector backend is a future release; the DI seam below is the
+//             drop-in point). Until then this mode errors with
 //             ERROR_CATEGORIES.SEMANTIC_UNAVAILABLE when the caller
 //             requests it without injecting a semantic backend. NO silent
 //             fallback to keyword — design §9.3's explicit "exit 2 when
@@ -260,14 +261,14 @@ export function search(opts = {}) {
   }
 
   // Semantic + hybrid require an injected backend. Production v0.1.0
-  // passes undefined → error with the install-memsearch hint. v0.1.x
-  // wires the real backend.
+  // passes undefined → error with the not-yet-shipped hint. A future
+  // release wires the real Layer-5b backend via the semanticBackend seam.
   if (mode === SEARCH_MODES.SEMANTIC || mode === SEARCH_MODES.HYBRID) {
     if (typeof opts.semanticBackend !== 'function') {
       return errorResult({
         category: ERROR_CATEGORIES.SEMANTIC_UNAVAILABLE,
         errors: [
-          'memsearch not installed — install via the Layer 5b install path. ' +
+          'the Layer-5b semantic backend is not yet shipped — semantic/hybrid search will land in a future release. ' +
             'Use --mode=keyword for the always-available FTS5 search.',
         ],
       });

package/src/spawn-bin.mjs

@@ -3,7 +3,7 @@
 //
 // Why this exists
 // ---------------
-// Spawning an npm-global bin (claude, memsearch, cmk-*) needs `shell:true` on
+// Spawning an npm-global bin (claude, cmk-*) needs `shell:true` on
 // Windows so the `.cmd` shim resolves through cmd.exe — Node won't auto-resolve
 // `.cmd`/`.bat` without a shell (CVE-2024-27980 hardening). But `shell:true`
 // WITH an args array is doubly bad:
@@ -73,7 +73,12 @@ export function spawnBin(bin, args = [], opts = {}, deps = {}) {
   return spawnImpl(bin, args, { ...opts, shell: false });
 }
 
-/** Synchronous twin of spawnBin (for one-shot checks like `cmk doctor`'s memsearch probe). */
+/**
+ * Synchronous twin of spawnBin, for one-shot bin checks.
+ * NOTE: currently unused — the `cmk doctor` memsearch probe that used it was
+ * removed in Task 120. Kept as the sync counterpart to spawnBin for future
+ * one-shot checks; remove if it stays unused.
+ */
 export function spawnBinSync(bin, args = [], opts = {}, deps = {}) {
   const { spawnImpl = spawnSync, platform = process.platform } = deps;
   if (platform === 'win32') {

package/src/subcommands.mjs

@@ -249,10 +249,11 @@ function runLessonsPromote(id, options = {}) {
 /**
  * `cmk search` — Task 30. Hybrid keyword + optional semantic.
  *
- * v0.1.0 ships the keyword backend (FTS5 BM25 over the observations
- * index). Semantic + hybrid modes require the Layer 5b memsearch+Milvus
- * install which isn't bundled in v0.1.0; both error with exit code 2
- * and a clear "memsearch not installed" hint per tasks.md 30.2.
+ * The keyword backend (FTS5 BM25 over the observations index) always
+ * ships. Semantic + hybrid modes require the Layer-5b semantic backend,
+ * which is not yet shipped; both error with exit code 2 and a clear
+ * "not yet shipped" hint per tasks.md 30.2. The `semanticBackend` DI seam
+ * is the drop-in point for the future backend.
  *
  * Filter flags (per tasks.md 30.4):
  *   --mode <keyword|semantic|hybrid>   (default keyword)
@@ -1652,7 +1653,7 @@ export const subcommands = [
     milestone: 30,
     argSpec: [{ flags: '<query...>', description: 'query terms' }],
     optionSpec: [
-      { flags: '--mode <mode>', description: 'keyword | semantic | hybrid (default: keyword; semantic+hybrid need memsearch — Layer 5b install, not in v0.1.0)' },
+      { flags: '--mode <mode>', description: 'keyword | semantic | hybrid (default: keyword; semantic + hybrid need the Layer-5b semantic backend, not yet shipped)' },
       { flags: '--min-trust <level>', description: 'low | medium | high' },
       { flags: '--tier <tier>', description: 'U | P | L (filter to a single tier)' },
       { flags: '--since <date>', description: 'ISO date — exclude observations older than this' },

package/template/support/cron-jobs/nightly-memsearch-index.md

@@ -1,17 +0,0 @@
----
-name: Nightly MemSearch Index
-time: '02:00'
-days: daily
-active: 'true'
-description: 'Re-indexes context/ markdown files for vector search'
-timeout: 10m
-job_type: shell_command
-command: 'bash scripts/memsearch-index-with-flush.sh context/memory context/sessions context/transcripts'
-working_directory: '${CLAUDE_PROJECT_DIR}'
-# Requires Layer 5 installed (memsearch on PATH + a reachable Milvus backend).
-# On Windows: Docker Desktop running with Milvus container — see context/SETUP.md.
-# If memsearch isn't installed or backend isn't reachable, the task will fail;
-# HC-7 (backend reachability) will flag it on the next session start.
----
-
-Updates the memsearch vector index with any new content from `context/memory/`, `context/sessions/`, and `context/transcripts/`. Idempotent: only re-embeds chunks whose hash changed since the last run.

package/template/support/milvus-deploy/README.md

@@ -1,57 +0,0 @@
-# Milvus deployment (Windows + optional)
-
-This compose stack runs Milvus v2.6.16 plus its required dependencies (etcd, MinIO) as three local containers. It's used by **Layer 5** (memsearch vector search) of the memory system.
-
-## When you need this
-
-- **Windows**: required. `milvus-lite` (the default embedded vector store memsearch ships) has no Windows wheels on PyPI. Use this Docker stack instead.
-- **Linux / macOS**: optional. memsearch auto-installs milvus-lite and uses it at `~/.memsearch/milvus.db`. Skip this directory entirely unless you specifically want a remote Milvus.
-
-## Bring it up
-
-```bash
-cd milvus-deploy
-docker compose up -d
-```
-
-Wait ~30-60 seconds for all three containers to report `(healthy)`:
-
-```bash
-docker compose ps
-```
-
-You should see `milvus-etcd`, `milvus-minio`, `milvus-standalone` all `Up (healthy)`.
-
-## Configure memsearch to use it
-
-```bash
-memsearch config set milvus.uri "http://localhost:19530"
-```
-
-## Bring it down
-
-```bash
-docker compose down
-```
-
-Volumes persist in `./volumes/` — re-running `up -d` reuses the same data.
-
-## Why a multi-container stack and not just `milvus-standalone`?
-
-Milvus standalone needs etcd (metadata store) and MinIO (object storage for segments and index data). On Linux/macOS, `milvus-lite` bundles all of that into one Python wheel; on Windows there's no equivalent wheel, so the three services run as separate containers.
-
-The single-container `docker run milvusdb/milvus:latest standalone` pattern referenced in some older docs is no longer supported — `latest` is `v3.0-beta` whose entrypoint doesn't accept `standalone` as a command. Use this compose file with the pinned versions instead.
-
-## Known quirk: memsearch index without flush
-
-memsearch v0.4.x doesn't call `flush()` after `MilvusStore.upsert()`. On Milvus v2.6+ (Woodpecker WAL), this means `memsearch index` reports success but the data isn't searchable until a flush forces the growing segment to seal.
-
-Use `scripts/memsearch-index-with-flush.sh` instead of raw `memsearch index` until upstream ships a fix. Tracked as [memsearch issue #534](https://github.com/zilliztech/memsearch/issues/534).
-
-## Pinned versions
-
-| Image | Version | Why pinned |
-|---|---|---|
-| `milvusdb/milvus` | `v2.6.16` | Latest stable v2.6 line. `latest` tag is v3.0-beta and crashes. |
-| `quay.io/coreos/etcd` | `v3.5.25` | Compatible with milvus v2.6. |
-| `minio/minio` | `RELEASE.2024-12-18T13-15-44Z` | Recent stable RELEASE tag. |

package/template/support/milvus-deploy/docker-compose.yml

@@ -1,66 +0,0 @@
-version: '3.5'
-
-services:
-  etcd:
-    container_name: milvus-etcd
-    image: quay.io/coreos/etcd:v3.5.25
-    environment:
-      - ETCD_AUTO_COMPACTION_MODE=revision
-      - ETCD_AUTO_COMPACTION_RETENTION=1000
-      - ETCD_QUOTA_BACKEND_BYTES=4294967296
-      - ETCD_SNAPSHOT_COUNT=50000
-    volumes:
-      - ${DOCKER_VOLUME_DIRECTORY:-.}/volumes/etcd:/etcd
-    command: etcd -advertise-client-urls=http://etcd:2379 -listen-client-urls http://0.0.0.0:2379 --data-dir /etcd
-    healthcheck:
-      test: ["CMD", "etcdctl", "endpoint", "health"]
-      interval: 30s
-      timeout: 20s
-      retries: 3
-
-  minio:
-    container_name: milvus-minio
-    image: minio/minio:RELEASE.2024-12-18T13-15-44Z
-    environment:
-      MINIO_ACCESS_KEY: minioadmin
-      MINIO_SECRET_KEY: minioadmin
-    ports:
-      - "9001:9001"
-      - "9000:9000"
-    volumes:
-      - ${DOCKER_VOLUME_DIRECTORY:-.}/volumes/minio:/minio_data
-    command: minio server /minio_data --console-address ":9001"
-    healthcheck:
-      test: ["CMD", "curl", "-f", "http://localhost:9000/minio/health/live"]
-      interval: 30s
-      timeout: 20s
-      retries: 3
-
-  standalone:
-    container_name: milvus-standalone
-    image: milvusdb/milvus:v2.6.16
-    command: ["milvus", "run", "standalone"]
-    security_opt:
-    - seccomp:unconfined
-    environment:
-      ETCD_ENDPOINTS: etcd:2379
-      MINIO_ADDRESS: minio:9000
-      MQ_TYPE: woodpecker
-    volumes:
-      - ${DOCKER_VOLUME_DIRECTORY:-.}/volumes/milvus:/var/lib/milvus
-    healthcheck:
-      test: ["CMD", "curl", "-f", "http://localhost:9091/healthz"]
-      interval: 30s
-      start_period: 90s
-      timeout: 20s
-      retries: 3
-    ports:
-      - "19530:19530"
-      - "9091:9091"
-    depends_on:
-      - "etcd"
-      - "minio"
-
-networks:
-  default:
-    name: milvus

package/template/support/scripts/memsearch-index-with-flush.sh

@@ -1,59 +0,0 @@
-#!/usr/bin/env bash
-#
-# Wraps `memsearch index` to also force a Milvus flush afterward.
-#
-# Why: Milvus v2.6+ uses the Woodpecker WAL backend, which (unlike v2.5's
-# Pulsar) does not auto-flush growing segments on a short timer. As a result,
-# `memsearch index` reports "Indexed N chunks" successfully but
-# `get_collection_stats` returns 0 rows and search returns no results until
-# a manual flush forces the growing segment to seal.
-#
-# This wrapper runs the index, then issues a flush via pymilvus.
-#
-# Usage:
-#   bash scripts/memsearch-index-with-flush.sh context/memory context/sessions context/transcripts
-#
-# Reads MILVUS_URI from env (falls back to the memsearch config value, then localhost).
-# Reads MILVUS_COLLECTION from env (falls back to memsearch config, then "memsearch_chunks").
-
-# Task Scheduler / launchd / unattended cron contexts don't always inherit
-# the user's PATH. Set it up explicitly for the common locations.
-case ":$PATH:" in
-    *":/usr/bin:"*) ;;
-    *) export PATH="/usr/bin:/usr/local/bin:/opt/homebrew/bin:/c/Program Files/Git/usr/bin:$PATH" ;;
-esac
-
-# On Windows, also add the Python Scripts dir where `memsearch.exe` lands.
-if [ -d "/c/Users/$USERNAME/AppData/Local/Programs/Python" ]; then
-    for d in /c/Users/$USERNAME/AppData/Local/Programs/Python/Python*/Scripts \
-             /c/Users/$USERNAME/AppData/Local/Programs/Python/Python*; do
-        [ -d "$d" ] && export PATH="$d:$PATH"
-    done
-fi
-
-set -euo pipefail
-
-# Step 1 — index. Pass through all args.
-memsearch index "$@"
-
-# Step 2 — flush.
-MILVUS_URI="${MILVUS_URI:-$(memsearch config get milvus.uri 2>/dev/null | tail -n1 | tr -d '\r')}"
-MILVUS_COLLECTION="${MILVUS_COLLECTION:-$(memsearch config get milvus.collection 2>/dev/null | tail -n1 | tr -d '\r')}"
-MILVUS_URI="${MILVUS_URI:-http://localhost:19530}"
-MILVUS_COLLECTION="${MILVUS_COLLECTION:-memsearch_chunks}"
-
-# Flush only if we're using a remote Milvus (milvus-lite auto-flushes).
-case "$MILVUS_URI" in
-    http://*|https://*|tcp://*)
-        python -c "
-from pymilvus import MilvusClient
-client = MilvusClient(uri='${MILVUS_URI}')
-client.flush('${MILVUS_COLLECTION}')
-stats = client.get_collection_stats('${MILVUS_COLLECTION}')
-print(f'Flushed. Collection {stats!r}')
-"
-        ;;
-    *)
-        echo "Local milvus-lite detected (${MILVUS_URI}); skipping flush (auto-flush)."
-        ;;
-esac