monomind 2.5.4 → 2.5.5

package/packages/@monomind/cli/dist/src/mcp-tools/monograph-tools.js

@@ -168,10 +168,22 @@ const monographQueryTool = {
             const label = input.label;
             const rerank = input.rerank ?? true;
             const damping = input.damping ?? 0.5;
+            const zeroResultHint = /\s/.test(query) && !/[A-Z]/.test(query.replace(/\s+/g, '').slice(1))
+                ? ' Hint: monograph indexes identifiers and filenames — try camelCase/PascalCase (e.g. "AgentSpawn") or a filename instead of a phrase.'
+                : '';
+            // Lightweight staleness check — fire-and-forget background rebuild;
+            // append warning to results so the agent knows data may be outdated.
+            let stalenessNote = '';
+            const repoPath = getProjectCwd();
+            const staleness = await computeCommitsBehind(repoPath);
+            if (staleness && staleness.commitsBehind > 0) {
+                const triggered = triggerBackgroundBuildIfNeeded(repoPath, staleness.commitsBehind);
+                stalenessNote = `\n⚠ Index is ${staleness.commitsBehind} commit(s) behind HEAD${triggered ? ' — rebuild triggered' : ''}.`;
+            }
             if (process.env['MONOGRAPH_EMBEDDINGS'] === 'true') {
                 const results = await hybridQuery(db, query, { limit: rerank ? limit * 2 : limit, label });
                 if (results.length === 0)
-                    return text('No results found.');
+                    return text('No results found.' + zeroResultHint + stalenessNote);
                 if (rerank) {
                     const seeds = results.map(r => ({
                         id: r.id, name: r.name ?? r.id, label: r.label ?? '?',
@@ -184,17 +196,17 @@ const monographQueryTool = {
                         const tag = r.boostedByNeighbors ? ' [PPR-boosted]' : '';
                         return `[${r.label}] ${r.name}  ${loc}  (score: ${r.score.toFixed(4)})${tag}`;
                     });
-                    return text(lines.join('\n'));
+                    return text(lines.join('\n') + stalenessNote);
                 }
                 const lines = results.map(r => {
                     const loc = r.filePath ? (r.startLine != null ? `${r.filePath}:${r.startLine}` : r.filePath) : '';
                     return `[${r.label ?? '?'}] ${r.name ?? r.id}  ${loc}  (score: ${r.score.toFixed(4)})`;
                 });
-                return text(lines.join('\n'));
+                return text(lines.join('\n') + stalenessNote);
             }
             const results = ftsSearch(db, query, rerank ? limit * 2 : limit, label);
             if (results.length === 0)
-                return text('No results found.');
+                return text('No results found.' + zeroResultHint + stalenessNote);
             if (rerank) {
                 const seeds = results.map(r => ({
                     id: r.id, name: r.name, label: r.label,
@@ -207,13 +219,13 @@ const monographQueryTool = {
                     const tag = r.boostedByNeighbors ? ' [PPR-boosted]' : '';
                     return `[${r.label}] ${r.name}  ${loc}  (score: ${r.score.toFixed(3)})${tag}`;
                 });
-                return text(lines.join('\n'));
+                return text(lines.join('\n') + stalenessNote);
             }
             const lines = results.map(r => {
                 const loc = r.filePath ? (r.startLine != null ? `${r.filePath}:${r.startLine}` : r.filePath) : '';
                 return `[${r.label}] ${r.name}  ${loc}  (score: ${r.rank.toFixed(3)})`;
             });
-            return text(lines.join('\n'));
+            return text(lines.join('\n') + stalenessNote);
         }
         finally {
             closeDb(db);
@@ -762,10 +774,11 @@ async function computeCommitsBehind(repoPath) {
  * Shared staleness threshold: both monograph_staleness and monograph_suggest (checkStaleness)
  * trigger a background rebuild only when the index is more than this many commits behind HEAD.
  * Using a shared constant prevents conflicting rebuild pressure during active dev sessions.
- * Was 10 (11-commit trigger) — loose enough that a "2 commits behind" graph (the common
- * case session banners actually report) never rebuilt and silently served stale results.
+ * Was 10 → 3 → 1. Even 3 let routine small commits accumulate stale results
+ * silently. At 1 (rebuild triggers at 2+ behind), staleness rarely persists
+ * across sessions.
  */
-const STALENESS_THRESHOLD = 3;
+const STALENESS_THRESHOLD = 1;
 /**
  * Fire-and-forget background rebuild. Uses a module-level guard so concurrent
  * MCP tool calls (e.g. repeated monograph_suggest checkStaleness) don't pile up builds.

package/packages/@monomind/cli/dist/src/mcp-tools/neural-tools.d.ts

@@ -5,7 +5,7 @@
  * No ML training, gradient descent, or neural network inference occurs.
  * The "train" tool embeds and stores; the "predict" tool finds similar stored
  * patterns. Embeddings come from the shared memory/embedding-operations.ts
- * pipeline (LanceDB bridge -> ONNX -> deterministic hash fallback).
+ * pipeline (SQLite-backed memory bridge -> ONNX -> deterministic hash fallback).
  *
  * All pattern storage is delegated to intelligence.ts's LocalReasoningBank
  * (single source of truth for patterns.json). No separate models.json store.

package/packages/@monomind/cli/dist/src/mcp-tools/neural-tools.js

@@ -5,7 +5,7 @@
  * No ML training, gradient descent, or neural network inference occurs.
  * The "train" tool embeds and stores; the "predict" tool finds similar stored
  * patterns. Embeddings come from the shared memory/embedding-operations.ts
- * pipeline (LanceDB bridge -> ONNX -> deterministic hash fallback).
+ * pipeline (SQLite-backed memory bridge -> ONNX -> deterministic hash fallback).
  *
  * All pattern storage is delegated to intelligence.ts's LocalReasoningBank
  * (single source of truth for patterns.json). No separate models.json store.
@@ -16,11 +16,11 @@ const MAX_PATTERNS = 10000;
 const MAX_TRAINING_ENTRIES = 1000;
 const MAX_TEXT_LENGTH = 64 * 1024;
 const MAX_SEARCH_QUERY_LENGTH = 16 * 1024;
-// Embeddings: delegate to the shared embedding pipeline (LanceDB bridge -> ONNX ->
+// Embeddings: delegate to the shared embedding pipeline (SQLite-backed memory bridge -> ONNX ->
 // deterministic hash fallback) in memory/embedding-operations.ts.
 let lastEmbeddingModel = 'unknown';
 /**
- * Generate embedding via the shared pipeline (LanceDB bridge -> ONNX -> deterministic
+ * Generate embedding via the shared pipeline (SQLite-backed memory bridge -> ONNX -> deterministic
  * hash), same one used by CLI `neural` commands and memory search. Falls back to a
  * local deterministic hash only if the shared module fails to load entirely.
  */

package/packages/@monomind/cli/dist/src/mcp-tools/system-tools.js

@@ -143,7 +143,7 @@ export const systemTools = [
             let agentCounts = { active: 0, total: 0 };
             let taskCounts = { pending: 0, completed: 0, failed: 0 };
             let _metricsSource = 'none';
-            // Primary: LanceDB bridge
+            // Primary: SQLite-backed memory bridge
             try {
                 const bridge = await import('../memory/memory-bridge.js');
                 const agentResults = await bridge.bridgeListEntries({ namespace: 'agents', limit: 10000 });

package/packages/@monomind/cli/dist/src/memory/embedding-operations.js

@@ -38,7 +38,7 @@ export async function loadEmbeddingModel(options) {
             loadTime: 0
         };
     }
-    // ADR-053: Try LanceDB bridge first
+    // ADR-053: Try SQLite-backed memory bridge first
     const bridge = await getBridge();
     if (bridge) {
         const bridgeResult = await bridge.bridgeLoadEmbeddingModel();
@@ -148,7 +148,7 @@ export async function generateEmbedding(text) {
         text = String(text ?? '');
     if (text.length > 16 * 1024)
         text = text.slice(0, 16 * 1024);
-    // ADR-053: Try LanceDB bridge first
+    // ADR-053: Try SQLite-backed memory bridge first
     const bridge = await getBridge();
     if (bridge) {
         const bridgeResult = await bridge.bridgeGenerateEmbedding(text);

package/packages/@monomind/cli/dist/src/memory/hnsw-operations.js

@@ -6,7 +6,7 @@
  */
 import * as fs from 'fs';
 import * as path from 'path';
-// ADR-053: Lazy import of LanceDB memory bridge
+// ADR-053: Lazy import of SQLite-backed memory bridge
 let _bridge;
 async function getBridge() {
     if (_bridge === null)
@@ -34,38 +34,65 @@ async function loadHNSWIndexClass() {
         return null;
     }
 }
-/** Read entries with parseable embeddings of the expected dimension from the sql.js DB. */
+/** Read entries with parseable embeddings of the expected dimension from SQLite. */
 async function loadEntriesFromDb(dbPath, dimensions) {
     if (!fs.existsSync(dbPath))
         return [];
-    const initSqlJs = (await import('sql.js')).default;
-    const SQL = await initSqlJs();
-    const fileBuffer = fs.readFileSync(dbPath);
-    const db = new SQL.Database(fileBuffer);
+    const { safeParseEmbedding } = await import('./memory-bridge.js');
+    const results = [];
+    // Prefer better-sqlite3 (mmap-backed, doesn't load full DB into memory)
     try {
-        const { safeParseEmbedding } = await import('./memory-bridge.js');
-        const stmt = db.prepare(`SELECT id, key, namespace, content, embedding FROM memory_entries WHERE status = 'active' AND embedding IS NOT NULL LIMIT 50000`);
-        const rows = [];
-        while (stmt.step())
-            rows.push(stmt.get());
-        stmt.free();
-        const results = [];
-        for (const row of rows) {
-            const [id, key, namespace, content, embeddingJson] = row;
-            const parsed = safeParseEmbedding(embeddingJson);
-            if (!parsed || parsed.length !== dimensions)
-                continue;
-            results.push({
-                id,
-                vector: new Float32Array(parsed),
-                entry: { id, key: key || id, namespace: namespace || 'default', content: content || '' },
-            });
+        const Database = (await import('better-sqlite3')).default;
+        const db = new Database(dbPath, { readonly: true });
+        try {
+            const rows = db.prepare(`SELECT id, key, namespace, content, embedding FROM memory_entries WHERE status = 'active' AND embedding IS NOT NULL ORDER BY rowid DESC LIMIT 10000`).all();
+            for (const row of rows) {
+                const parsed = safeParseEmbedding(row.embedding);
+                if (!parsed || parsed.length !== dimensions)
+                    continue;
+                results.push({
+                    id: row.id,
+                    vector: new Float32Array(parsed),
+                    entry: { id: row.id, key: row.key || row.id, namespace: row.namespace || 'default', content: row.content || '' },
+                });
+            }
+        }
+        finally {
+            db.close();
         }
         return results;
     }
-    finally {
-        db.close();
+    catch {
+        // better-sqlite3 native binding unavailable — fall back to sql.js (WASM)
+    }
+    try {
+        const initSqlJs = (await import('sql.js')).default;
+        const SQL = await initSqlJs();
+        const fileBuffer = fs.readFileSync(dbPath);
+        const db = new SQL.Database(fileBuffer);
+        try {
+            const stmt = db.prepare(`SELECT id, key, namespace, content, embedding FROM memory_entries WHERE status = 'active' AND embedding IS NOT NULL ORDER BY rowid DESC LIMIT 10000`);
+            while (stmt.step()) {
+                const [id, key, namespace, content, embeddingJson] = stmt.get();
+                const parsed = safeParseEmbedding(embeddingJson);
+                if (!parsed || parsed.length !== dimensions)
+                    continue;
+                results.push({
+                    id,
+                    vector: new Float32Array(parsed),
+                    entry: { id, key: key || id, namespace: namespace || 'default', content: content || '' },
+                });
+            }
+            stmt.free();
+        }
+        finally {
+            db.close();
+        }
+    }
+    catch {
+        // Neither SQLite driver available
     }
+    return results;
 }
 /**
  * Get or create the HNSW index singleton
@@ -204,7 +231,7 @@ export async function searchHNSWIndex(queryEmbedding, options) {
 export function getHNSWStatus() {
     // ADR-053: If bridge was previously loaded, report availability
     if (_bridge && _bridge !== null) {
-        // Bridge is loaded — HNSW-equivalent is available via LanceDB
+        // Bridge is loaded — HNSW-equivalent is available via the SQLite backend
         return {
             available: true,
             initialized: true,

package/packages/@monomind/cli/dist/src/memory/intelligence.js

@@ -847,7 +847,7 @@ export async function recordStep(step) {
     }
     try {
         // Generate embedding if not provided
-        // ADR-053: Try LanceDB bridge embedder first
+        // ADR-053: Try SQLite-backed memory bridge embedder first
         let embedding = step.embedding;
         if (!embedding) {
             try {
@@ -952,7 +952,7 @@ export async function findSimilarPatterns(query, options) {
             return [];
     }
     try {
-        // ADR-053: Try LanceDB bridge embedder first
+        // ADR-053: Try SQLite-backed memory bridge embedder first
         let queryEmbedding = null;
         try {
             const bridge = await import('./memory-bridge.js');

package/packages/@monomind/cli/dist/src/memory/memory-bridge.d.ts

@@ -1,7 +1,10 @@
 /**
- * Memory Bridge — Routes CLI memory operations through LanceDB
+ * Memory Bridge — Routes CLI memory operations through SQLite
  *
- * Uses LanceDBBackend from @monoes/memory.
+ * Uses SQLiteBackend (better-sqlite3, sql.js WASM fallback) from @monoes/memory.
+ * LanceDB was replaced by this SQLite engine 2026-07; the on-disk data
+ * directory is still named `lancedb` for legacy/back-compat path resolution
+ * (see getDbPath below) but no longer holds LanceDB data.
  * All exported function signatures are unchanged.
  *
  * @module v1/cli/memory-bridge
@@ -15,7 +18,8 @@ export declare function safeParseEmbedding(raw: string | null | undefined): numb
 export declare function getGlobalBrainDir(): string;
 /** Sentinel callers pass as dbPath to address the global brain. */
 export declare const GLOBAL_BRAIN = "@global";
-/** Resolve the real on-disk LanceDB path for a given custom path (or the default). */
+/** Resolve the real on-disk SQLite data-dir path for a given custom path (or the
+ *  default) — the dir is still named `lancedb` for legacy path back-compat. */
 export declare function bridgeGetDbPath(customPath?: string): string;
 export declare function bridgeStoreEntry(options: {
     key: string;

package/packages/@monomind/cli/dist/src/memory/memory-bridge.js

@@ -1,7 +1,10 @@
 /**
- * Memory Bridge — Routes CLI memory operations through LanceDB
+ * Memory Bridge — Routes CLI memory operations through SQLite
  *
- * Uses LanceDBBackend from @monoes/memory.
+ * Uses SQLiteBackend (better-sqlite3, sql.js WASM fallback) from @monoes/memory.
+ * LanceDB was replaced by this SQLite engine 2026-07; the on-disk data
+ * directory is still named `lancedb` for legacy/back-compat path resolution
+ * (see getDbPath below) but no longer holds LanceDB data.
  * All exported function signatures are unchanged.
  *
  * @module v1/cli/memory-bridge
@@ -103,7 +106,8 @@ function getDbPath(customPath) {
         return resolved;
     return defaultDir;
 }
-/** Resolve the real on-disk LanceDB path for a given custom path (or the default). */
+/** Resolve the real on-disk SQLite data-dir path for a given custom path (or the
+ *  default) — the dir is still named `lancedb` for legacy path back-compat. */
 export function bridgeGetDbPath(customPath) {
     return getDbPath(customPath);
 }
@@ -161,6 +165,7 @@ function generateId(prefix) {
     return `${prefix}_${Date.now()}_${crypto.randomBytes(8).toString('hex')}`;
 }
 const backendSlots = new Map();
+const MAX_BACKEND_SLOTS = 5;
 let _embedder = null;
 let _embedderPromise = null;
 const MAX_INIT_ATTEMPTS = 3;
@@ -203,6 +208,15 @@ async function getBackend(dbPath) {
     const dir = getDbPath(dbPath);
     let slot = backendSlots.get(dir);
     if (!slot) {
+        if (backendSlots.size >= MAX_BACKEND_SLOTS) {
+            const oldest = backendSlots.keys().next().value;
+            const evicted = backendSlots.get(oldest);
+            try {
+                evicted?.instance?.close?.();
+            }
+            catch { /* best effort */ }
+            backendSlots.delete(oldest);
+        }
         slot = { promise: null, instance: null, available: null, attempts: 0 };
         backendSlots.set(dir, slot);
     }
@@ -608,7 +622,7 @@ export async function bridgeGetBackendStats(dbPath) {
         return null;
     }
 }
-// ===== HNSW (replaced by LanceDB ANN — stubs kept for API compat) =====
+// ===== HNSW (replaced by the SQLite backend's ANN search — stubs kept for API compat) =====
 export async function bridgeGetHNSWStatus(dbPath) {
     const backend = await getBackend(dbPath);
     if (!backend)
@@ -622,7 +636,7 @@ export async function bridgeGetHNSWStatus(dbPath) {
     }
 }
 export async function bridgeSearchHNSW(options) {
-    // Delegate to bridgeSearchEntries which uses LanceDB ANN
+    // Delegate to bridgeSearchEntries which uses the SQLite backend's ANN search
     const result = await bridgeSearchEntries({
         query: options.query,
         namespace: options.namespace,
@@ -639,7 +653,7 @@ export async function bridgeSearchHNSW(options) {
     };
 }
 export async function bridgeAddToHNSW(options) {
-    // LanceDB indexes entries automatically on store — this is a no-op
+    // The SQLite backend indexes entries automatically on store — this is a no-op
     const backend = await getBackend(options.dbPath);
     if (!backend)
         return null;
@@ -651,7 +665,7 @@ export async function bridgeAddToHNSW(options) {
         return { success: true };
     }
 }
-// ===== Controller stubs (LanceDB has no equivalent controllers) =====
+// ===== Controller stubs (the SQLite backend has no equivalent controllers) =====
 export async function bridgeGetController(controllerName, dbPath) {
     await getBackend(dbPath);
     return null;
@@ -932,13 +946,13 @@ export async function bridgeRouteTask(options) {
 export async function bridgeHealthCheck(dbPath) {
     const backend = await getBackend(dbPath);
     if (!backend)
-        return { healthy: false, backend: 'lancedb', error: 'unavailable' };
+        return { healthy: false, backend: 'sqlite', error: 'unavailable' };
     try {
         const health = await backend.healthCheck?.();
         const stats = await backend.getStats?.();
         return {
             healthy: health?.healthy ?? true,
-            backend: 'lancedb',
+            backend: 'sqlite',
             stats: stats ? {
                 totalEntries: stats.totalEntries ?? 0,
                 namespaces: Object.keys(stats.entriesByNamespace ?? {}),
@@ -946,7 +960,7 @@ export async function bridgeHealthCheck(dbPath) {
         };
     }
     catch {
-        return { healthy: false, backend: 'lancedb' };
+        return { healthy: false, backend: 'sqlite' };
     }
 }
 // ===== Hierarchical memory =====

package/packages/@monomind/cli/dist/src/memory/memory-crud.js

@@ -214,7 +214,7 @@ export async function verifyMemoryInit(dbPath, options) {
  * This bypasses MCP and writes directly to the database
  */
 export async function storeEntry(options) {
-    // ADR-053: Try LanceDB memory bridge first
+    // ADR-053: Try SQLite-backed memory bridge first
     const bridge = await getBridge();
     if (bridge) {
         const bridgeResult = await bridge.bridgeStoreEntry(options);
@@ -335,7 +335,7 @@ export async function storeEntry(options) {
  * Issue #980: Properly supports namespaced entries
  */
 export async function deleteEntry(options) {
-    // ADR-053: Try LanceDB memory bridge first
+    // ADR-053: Try SQLite-backed memory bridge first
     const bridge = await getBridge();
     if (bridge) {
         const bridgeResult = await bridge.bridgeDeleteEntry(options);

package/packages/@monomind/cli/dist/src/memory/memory-initializer.d.ts

@@ -3,8 +3,8 @@
  * Properly initializes the memory database with sql.js (WASM SQLite)
  * Includes pattern tables, vector embeddings, migration state tracking
  *
- * ADR-053: Routes through ControllerRegistry → LanceDB when available,
- * falls back to raw sql.js for backwards compatibility.
+ * ADR-053: Routes through ControllerRegistry → SQLite-backed memory bridge
+ * when available, falls back to raw sql.js for backwards compatibility.
  *
  * @module v1/cli/memory-initializer
  */

package/packages/@monomind/cli/dist/src/memory/memory-initializer.js

@@ -3,8 +3,8 @@
  * Properly initializes the memory database with sql.js (WASM SQLite)
  * Includes pattern tables, vector embeddings, migration state tracking
  *
- * ADR-053: Routes through ControllerRegistry → LanceDB when available,
- * falls back to raw sql.js for backwards compatibility.
+ * ADR-053: Routes through ControllerRegistry → SQLite-backed memory bridge
+ * when available, falls back to raw sql.js for backwards compatibility.
  *
  * @module v1/cli/memory-initializer
  */
@@ -12,7 +12,7 @@ import * as fs from 'fs';
 import * as path from 'path';
 /** Maximum SQLite database file size accepted before read (256 MB). */
 const MAX_DB_FILE_BYTES = 256 * 1024 * 1024;
-// ADR-053: Lazy import of LanceDB memory bridge
+// ADR-053: Lazy import of SQLite-backed memory bridge
 let _bridge;
 async function getBridge() {
     if (_bridge === null)
@@ -71,15 +71,15 @@ INSERT OR IGNORE INTO vector_indexes (id, name, dimensions) VALUES
 `;
 }
 /**
- * ADR-053: Activate ControllerRegistry so LanceDB controllers
+ * ADR-053: Activate ControllerRegistry so memory-backend controllers
  * (ReasoningBank, SkillLibrary, ExplainableRecall, etc.) are instantiated.
  *
  * Uses the memory-bridge's getControllerRegistry() which lazily creates
  * a singleton ControllerRegistry and initializes it with the given dbPath.
  * After this call, all enabled controllers are ready for immediate use.
  *
- * Failures are isolated: if @monomind/memory or LanceDB is not available,
- * this returns an empty result without throwing.
+ * Failures are isolated: if @monomind/memory or the SQLite backend is not
+ * available, this returns an empty result without throwing.
  */
 async function activateControllerRegistry(dbPath, verbose) {
     const startTime = performance.now();

package/packages/@monomind/cli/dist/src/memory/memory-read.js

@@ -14,7 +14,7 @@ import { searchHNSWIndex } from './hnsw-operations.js';
 import { cosineSimilarity as cosineSim } from '../utils/cosine-similarity.js';
 /** Maximum SQLite database file size accepted before read (256 MB). */
 const MAX_DB_FILE_BYTES = 256 * 1024 * 1024;
-// ADR-053: Lazy import of LanceDB memory bridge
+// ADR-053: Lazy import of SQLite-backed memory bridge
 let _bridge;
 async function getBridge() {
     if (_bridge === null)
@@ -35,7 +35,7 @@ async function getBridge() {
  * Uses HNSW index for 150x faster search when available
  */
 export async function searchEntries(options) {
-    // ADR-053: Try LanceDB memory bridge first
+    // ADR-053: Try SQLite-backed memory bridge first
     const bridge = await getBridge();
     if (bridge) {
         const bridgeResult = await bridge.bridgeSearchEntries(options);
@@ -143,7 +143,7 @@ export async function searchEntries(options) {
  * List all entries from the memory database
  */
 export async function listEntries(options) {
-    // ADR-053: Try LanceDB memory bridge first
+    // ADR-053: Try SQLite-backed memory bridge first
     const bridge = await getBridge();
     if (bridge) {
         const bridgeResult = await bridge.bridgeListEntries(options);
@@ -241,7 +241,7 @@ export async function listEntries(options) {
  * Get a specific entry from the memory database
  */
 export async function getEntry(options) {
-    // ADR-053: Try LanceDB memory bridge first
+    // ADR-053: Try SQLite-backed memory bridge first
     const bridge = await getBridge();
     if (bridge) {
         const bridgeResult = await bridge.bridgeGetEntry(options);

package/packages/@monomind/cli/dist/src/orgrt/daemon.js

@@ -47,15 +47,17 @@ export class OrgDaemon {
         const cwd = join(this.root, ORG_DIR, name, 'workspace');
         mkdirSync(cwd, { recursive: true });
         const bus = new OrgBus(name, run, dir);
-        // Bounded in-memory tail: bus.jsonl on disk is the full durable record;
-        // this buffer only backs busEvents() (test-loop, /api/history) and would
-        // otherwise grow without limit for a long-running scheduled org — each
-        // Write's captured content snapshot alone can be up to 200KB (policy.ts).
-        const MAX_COLLECTED = 5000;
+        // Lightweight in-memory tail for busEvents() (test-loop, /api/history).
+        // Full events (including Write content snapshots) live on disk in bus.jsonl;
+        // the in-memory copy strips bulky data.content to keep RAM flat.
+        const MAX_COLLECTED = 1000;
         const collected = [];
         let lastActivity = Date.now();
         bus.subscribe(e => {
-            collected.push(e);
+            const slim = e.data?.content != null
+                ? { ...e, data: { ...e.data, content: undefined } }
+                : e;
+            collected.push(slim);
             if (collected.length > MAX_COLLECTED)
                 collected.splice(0, collected.length - MAX_COLLECTED);
             // The watchdog's own nudge event must not count as org activity, or a
@@ -543,6 +545,10 @@ export class OrgDaemon {
         catch (err) {
             console.error(`org ${name}: could not write run history:`, err instanceof Error ? err.message : err);
         }
+        finally {
+            this.recallUsage.delete(name);
+            this.orgLearnedRuns.delete(`${name}:${org.run}`);
+        }
         // the "org stopped" event above triggers the forwarder's final org:complete /
         // session:complete POST — without waiting for it here, the CLI process can exit
         // (and kill the in-flight fetch) before that last event reaches the dashboard,

package/packages/@monomind/cli/dist/src/orgrt/mailbox.d.ts

@@ -14,6 +14,7 @@ export interface OrgUserMessage {
  * stream() is passed as the `prompt` of query() to keep the session open.
  */
 export declare class Mailbox {
+    private static readonly MAX_QUEUE;
     private queue;
     private wake;
     private closed;

package/packages/@monomind/cli/dist/src/orgrt/mailbox.js

@@ -4,6 +4,7 @@
  * stream() is passed as the `prompt` of query() to keep the session open.
  */
 export class Mailbox {
+    static MAX_QUEUE = 500;
     queue = [];
     wake = null;
     closed = false;
@@ -12,6 +13,9 @@ export class Mailbox {
     push(text) {
         if (this.closed)
             return;
+        if (this.queue.length >= Mailbox.MAX_QUEUE) {
+            this.queue.shift();
+        }
         this.queue.push(text);
         this.wake?.();
         this.wake = null;

package/packages/@monomind/cli/dist/src/orgrt/policy.js

@@ -10,7 +10,7 @@ const READ_TOOLS = new Set(['Read', 'Glob', 'Grep']);
 const WEB_TOOLS = new Set(['WebFetch', 'WebSearch']);
 /** Cap for inline content snapshots on 'asset' events (bytes, UTF-16 chars) — keeps
  *  bus.jsonl / the dashboard's per-session event log from bloating on large writes. */
-const SNAPSHOT_MAX_CHARS = 200_000;
+const SNAPSHOT_MAX_CHARS = 20_000;
 const REGEX_METACHARS = new Set('.+^${}()|[]\\'.split(''));
 /**
  * tiny glob→RegExp: `**\/` matches zero-or-more leading directories (so

package/packages/@monomind/cli/dist/src/orgrt/server.js

@@ -27,6 +27,31 @@ export async function startOrgServer(daemon, port = 0) {
                 }
             });
         }
+        else if (req.method === 'POST' && req.url === '/api/human-message') {
+            let body = '';
+            req.on('data', c => { body += c; });
+            req.on('end', () => {
+                (async () => {
+                    try {
+                        const payload = JSON.parse(body || '{}');
+                        if (!payload.org || !payload.role || !payload.text) {
+                            res.writeHead(400, { 'Content-Type': 'application/json' });
+                            res.end(JSON.stringify({ ok: false, error: 'org, role, text are required' }));
+                            return;
+                        }
+                        const receipt = await daemon.deliver(payload.org, 'human', payload.role, 'message from human', payload.text);
+                        const ok = !receipt.startsWith('ERROR:');
+                        res.writeHead(ok ? 200 : 404, { 'Content-Type': 'application/json' });
+                        res.end(JSON.stringify({ ok, receipt }));
+                    }
+                    catch (err) {
+                        res.writeHead(400, { 'Content-Type': 'application/json' });
+                        res.end(JSON.stringify({ ok: false, error: err instanceof Error ? err.message : 'bad request' }));
+                    }
+                })();
+            });
+            return;
+        }
         else if (req.method === 'POST' && req.url === '/api/answer-question') {
             let body = '';
             req.on('data', c => { body += c; });