crbro-memory 2.1.2 → 2.3.0

package/bin/crbro.mjs

@@ -2,7 +2,7 @@
 
 // ─── CRBRO CLI ───────────────────────────────────────────────────
 // Command-line interface for CRBRO memory system
-// Supports: init, status, mine, setup-miner, miner-status,
+// Supports: init, status, secret, mine, setup-miner, miner-status,
 //           remove-miner, and MCP server mode (default)
 
 import { platform, homedir } from 'os';
@@ -584,6 +584,149 @@ if (command === 'init') {
     }
   }).catch(console.error);
 
+} else if (command === 'secret') {
+  // ─── Credentials, from the terminal ────────────────────────────
+  //
+  // Until 2.3 the only way to store a credential was the crbro_secret MCP
+  // tool, which means typing it into a conversation with a model. For a
+  // module whose whole point is that a secret never touches the brain, that
+  // was the wrong last mile. These subcommands close it: the value is read
+  // from stdin, never from argv, so it stays out of the shell history and
+  // out of the process table where `ps` and Task Manager can read it.
+  const sub = args[1];
+  const name = args[2];
+
+  const readPiped = () => new Promise((resolve, reject) => {
+    let data = '';
+    process.stdin.setEncoding('utf8');
+    process.stdin.on('data', (d) => { data += d; });
+    process.stdin.on('end', () => resolve(data.replace(/\r?\n$/, '')));
+    process.stdin.on('error', reject);
+  });
+
+  // Interactive read with the echo off. Raw mode hands us every keystroke,
+  // so nothing is drawn and nothing survives in the terminal scrollback.
+  const readHidden = (promptText) => new Promise((resolve, reject) => {
+    const stdin = process.stdin;
+    let value = '';
+    const cleanup = () => {
+      stdin.removeListener('data', onData);
+      if (stdin.isTTY) stdin.setRawMode(false);
+      stdin.pause();
+    };
+    const onData = (chunk) => {
+      for (const ch of chunk.toString('utf8')) {
+        if (ch === '\r' || ch === '\n') { cleanup(); process.stderr.write('\n'); return resolve(value); }
+        if (ch === '\u0003') { cleanup(); process.stderr.write('\n'); return reject(new Error('Cancelled — nothing was stored.')); }
+        if (ch === '\u007f' || ch === '\b') { value = value.slice(0, -1); continue; }
+        value += ch;
+      }
+    };
+    process.stderr.write(promptText);
+    if (stdin.isTTY) stdin.setRawMode(true);
+    stdin.resume();
+    stdin.on('data', onData);
+  });
+
+  const flagValue = (flag) => {
+    const i = args.indexOf(flag);
+    return i !== -1 && args[i + 1] ? args[i + 1] : '';
+  };
+
+  import('../dist/engine/keychain.js').then(async (kc) => {
+    try {
+      if (sub === 'status') {
+        const { backend, reason } = kc.detectBackend();
+        console.log('');
+        console.log('  🔐 CRBRO keychain');
+        console.log('  ─────────────────');
+        console.log(`  Backend:  ${backend || '❌ none available'}`);
+        if (reason) console.log(`  Reason:   ${reason}`);
+        if (backend === 'windows-dpapi') {
+          const dir = process.env['CRBRO_KEYS_DIR'] || join(homedir(), '.crbro-keys');
+          console.log(`  Store:    ${join(dir, 'keys.dpapi')}`);
+          console.log('            Sealed to this Windows account: copied to another');
+          console.log('            machine or lifted from a backup, it is unreadable.');
+        }
+        console.log('');
+        console.log('  The store lives outside the brain. No sync, no team space and no');
+        console.log('  crbro_share can reach it — per machine, on purpose.');
+        console.log('');
+        return;
+      }
+
+      if (sub === 'list') {
+        const secrets = kc.listSecrets();
+        console.log('');
+        if (secrets.length === 0) {
+          console.log('  🔐 No credentials stored on this machine yet.');
+          console.log('     Store one:  npx crbro-memory secret set MY_TOKEN');
+          console.log('');
+          return;
+        }
+        console.log(`  🔐 ${secrets.length} credential(s) — names only, values are never listed.`);
+        console.log('  ──────────────────────────────────────────────────────────');
+        for (const s of secrets) {
+          console.log(`  ${s.name.padEnd(28)} ${s.updated}  ${s.description || ''}`.trimEnd());
+        }
+        console.log('');
+        return;
+      }
+
+      if (!name) {
+        console.error(`  ❌ Missing name. Usage: npx crbro-memory secret ${sub || '<set|get|list|remove|status>'} NAME`);
+        process.exit(1);
+      }
+
+      if (sub === 'set') {
+        const value = process.stdin.isTTY
+          ? await readHidden(`  Value for ${name} (input hidden, Enter to finish): `)
+          : await readPiped();
+        if (!value) {
+          console.error('  ❌ Empty value. Nothing was stored.');
+          process.exit(1);
+        }
+        kc.setSecret(name, value, flagValue('--description'));
+        console.log(`  ✅ ${name} sealed in the OS keychain. CRBRO keeps no copy.`);
+        console.log('     Record only the NAME in the brain, never the value.');
+        return;
+      }
+
+      if (sub === 'get') {
+        const value = kc.getSecret(name);
+        if (value === null) {
+          console.error(`  ❌ ${name} not found on this machine.`);
+          process.exit(1);
+        }
+        if (process.stdout.isTTY) {
+          process.stderr.write('  ⚠️  Printing a credential to the screen. Pipe it instead to keep it out of the scrollback.\n');
+        }
+        process.stdout.write(value + '\n');
+        return;
+      }
+
+      if (sub === 'remove') {
+        if (!args.includes('--yes')) {
+          console.error(`  ❌ This deletes ${name} from the keychain and cannot be undone.`);
+          console.error(`     Re-run to confirm:  npx crbro-memory secret remove ${name} --yes`);
+          process.exit(1);
+        }
+        const removed = kc.removeSecret(name);
+        console.log(removed ? `  ✅ ${name} removed.` : `  ⚪ ${name} was not there. Nothing changed.`);
+        return;
+      }
+
+      console.error('  Usage: npx crbro-memory secret <set|get|list|remove|status> [NAME]');
+      process.exit(1);
+    } catch (err) {
+      console.error(`  ❌ ${err instanceof Error ? err.message : err}`);
+      process.exit(1);
+    }
+  }).catch((err) => {
+    console.error(`  ❌ ${err instanceof Error ? err.message : err}`);
+    process.exit(1);
+  });
+
 } else if (command === '--help' || command === '-h') {
   // ─── Help ──────────────────────────────────────────────────────
   console.log('');
@@ -609,6 +752,13 @@ if (command === 'init') {
   console.log('    npx crbro-memory semantic build   Embed the whole brain once (needs CRBRO_SEMANTIC=1)');
   console.log('    npx crbro-memory semantic status  Runtime, model and whether it is enabled');
   console.log('');
+  console.log('  Credentials (per machine, sealed in the OS keychain):');
+  console.log('    npx crbro-memory secret set NAME     Store one; the value is read from stdin, never argv');
+  console.log('    npx crbro-memory secret list         Names only, never values');
+  console.log('    npx crbro-memory secret get NAME     Print one; pipe it to keep it off the screen');
+  console.log('    npx crbro-memory secret remove NAME --yes');
+  console.log('    npx crbro-memory secret status       Which keychain this machine offers');
+  console.log('');
   console.log('  Server:');
   console.log('    npx crbro-memory                  Start MCP server (stdio)');
   console.log('');

package/dist/engine/hippocampus.d.ts

@@ -1,5 +1,11 @@
 import type { Brain } from './brain.js';
 import type { SessionLog } from '../types/index.js';
+/**
+ * Accept 'session_2026-09-03' or '2026-09-03'; null for anything that is not
+ * a day id, so a reference never turns into a path — "../manifest" was read
+ * back as a log before this check existed.
+ */
+export declare function normalizeSessionId(ref: string): string | null;
 export declare class Hippocampus {
     private brain;
     constructor(brain: Brain);
@@ -39,6 +45,8 @@ export declare class Hippocampus {
         date: string;
         kinds: string[];
     }>>;
+    /** One log by id, whole; null when the reference is not a day id or the log is gone. */
+    readSession(sessionRef: string): Promise<SessionLog | null>;
     /**
      * Delete one session log, after copying it to quarantine — the same
      * "nothing is deleted outright" rule the cortex follows.

package/dist/engine/hippocampus.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hippocampus.d.ts","sourceRoot":"","sources":["../../src/engine/hippocampus.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAUpD,qBAAa,WAAW;IACV,OAAO,CAAC,KAAK;gBAAL,KAAK,EAAE,KAAK;IAEhC;;;;;;;OAOG;IACG,UAAU,CAAC,IAAI,EAAE;QACrB,OAAO,EAAE,MAAM,CAAC;QAChB,cAAc,EAAE,MAAM,EAAE,CAAC;QACzB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,GAAG,OAAO,CAAC,UAAU,GAAG;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IA0ChD;;OAEG;IACG,YAAY,CAAC,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAe7D;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAK5C;;;;OAIG;IACG,YAAY,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IAW3F;;;OAGG;IACG,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;CAgBlH"}
+{"version":3,"file":"hippocampus.d.ts","sourceRoot":"","sources":["../../src/engine/hippocampus.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAIpD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI7D;AAED,qBAAa,WAAW;IACV,OAAO,CAAC,KAAK;gBAAL,KAAK,EAAE,KAAK;IAEhC;;;;;;;OAOG;IACG,UAAU,CAAC,IAAI,EAAE;QACrB,OAAO,EAAE,MAAM,CAAC;QAChB,cAAc,EAAE,MAAM,EAAE,CAAC;QACzB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;QAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,GAAG,OAAO,CAAC,UAAU,GAAG;QAAE,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IA0ChD;;OAEG;IACG,YAAY,CAAC,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAe7D;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAK5C;;;;OAIG;IACG,YAAY,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IAW3F,wFAAwF;IAClF,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAMjE;;;OAGG;IACG,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;CAiBlH"}

package/dist/engine/hippocampus.js

@@ -3,14 +3,20 @@
 // Session logging and memory formation
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Hippocampus = void 0;
+exports.normalizeSessionId = normalizeSessionId;
 const fs_js_1 = require("../utils/fs.js");
 const ids_js_1 = require("../utils/ids.js");
 const secrets_js_1 = require("./secrets.js");
 const SESSION_PREFIX = 'session_';
-/** Accept 'session_2026-09-03' or '2026-09-03'. */
+/**
+ * Accept 'session_2026-09-03' or '2026-09-03'; null for anything that is not
+ * a day id, so a reference never turns into a path — "../manifest" was read
+ * back as a log before this check existed.
+ */
 function normalizeSessionId(ref) {
     const t = (ref || '').trim();
-    return t.startsWith(SESSION_PREFIX) ? t : `${SESSION_PREFIX}${t}`;
+    const id = t.startsWith(SESSION_PREFIX) ? t : `${SESSION_PREFIX}${t}`;
+    return /^session_\d{4}-\d{2}-\d{2}$/.test(id) ? id : null;
 }
 class Hippocampus {
     brain;
@@ -99,12 +105,21 @@ class Hippocampus {
         }
         return out;
     }
+    /** One log by id, whole; null when the reference is not a day id or the log is gone. */
+    async readSession(sessionRef) {
+        const session_id = normalizeSessionId(sessionRef);
+        if (!session_id)
+            return null;
+        return (0, fs_js_1.readJSON)(this.brain.paths.session(session_id));
+    }
     /**
      * Delete one session log, after copying it to quarantine — the same
      * "nothing is deleted outright" rule the cortex follows.
      */
     async forgetSession(sessionRef) {
         const session_id = normalizeSessionId(sessionRef);
+        if (!session_id)
+            return { session_id: (sessionRef || '').trim(), removed: false, backup: null };
         const ruta = this.brain.paths.session(session_id);
         const log = await (0, fs_js_1.readJSON)(ruta);
         if (!log)

package/dist/engine/hippocampus.js.map

@@ -1 +1 @@
-{"version":3,"file":"hippocampus.js","sourceRoot":"","sources":["../../src/engine/hippocampus.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hippocampus.js","sourceRoot":"","sources":["../../src/engine/hippocampus.ts"],"names":[],"mappings":"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"}

package/dist/search/index.d.ts

@@ -10,10 +10,30 @@ import type { Neuron, SearchResult } from '../types/index.js';
  * 2.0) are no longer chunked, so an index built before it must be rebuilt or
  * it would keep serving entries that were retired.
  */
-export declare const INDEX_VERSION = 6;
+export declare const INDEX_VERSION = 7;
 /** Filled in by search/searchMany when the caller passes it: what the list left out. */
 export interface SearchStats {
     matched_neurons?: number;
+    /** Day logs whose summary mentions the query — a list of their own, never mixed with neurons. */
+    sessions?: SessionMatch[];
+    /** How many day logs had a hit at all, before the cap on sessions: three never reads as "only three". */
+    sessions_total?: number;
+}
+/**
+ * A session log that matched. The diary is searchable since 2.2, but it is
+ * narrative, not knowledge: a session hit points at where something was
+ * told, it never outranks the fact that answers. Read the whole log with
+ * crbro_inspect view=sessions session=<session_id>.
+ */
+export interface SessionMatch {
+    session_id: string;
+    date: string;
+    entry_id: string;
+    preview: string;
+    chars: number;
+    matched_terms: number;
+    query_terms: number;
+    confidence: 'strong' | 'weak';
 }
 export declare class SearchEngine {
     private brain;
@@ -124,6 +144,8 @@ export declare class SearchEngine {
     }): Promise<{
         results: SearchResult[];
         matched_neurons: number;
+        sessions: SessionMatch[];
+        sessions_total: number;
     }>;
     /**
      * Blend the vector ranking into the lexical one with reciprocal-rank
@@ -164,6 +186,16 @@ export declare class SearchEngine {
     private searchTerm;
     /** Build and insert every chunk of a neuron. */
     private insertNeuronChunks;
+    /**
+     * Index one session log, replacing whatever it had. Called by consolidate
+     * for the day just logged and by rebuild for the whole diary.
+     */
+    indexSession(log: {
+        session_id: string;
+        date?: string;
+        summary?: string;
+    }): Promise<void>;
+    private insertSessionChunks;
     private put;
     /**
      * Drop every chunk belonging to a neuron.

package/dist/search/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/search/index.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAQ,MAAM,mBAAmB,CAAC;AAEpE;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,IAAI,CAAC;AAoE/B,wFAAwF;AACxF,MAAM,WAAW,WAAW;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAiBD,qBAAa,YAAY;IA2BX,OAAO,CAAC,KAAK;IA1BzB,OAAO,CAAC,EAAE,CAAyB;IACnC,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,YAAY,CAA+B;IAEnD;;;;;;;OAOG;IACH,OAAO,CAAC,cAAc,CAAkC;IAExD;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAA8B;IAC9C,gEAAgE;IAChE,OAAO,CAAC,YAAY,CAA6B;IACjD,gEAAgE;IAChE,OAAO,CAAC,SAAS,CAA8B;gBAE3B,KAAK,EAAE,KAAK;IAMhC,6DAA6D;IAC7D,aAAa,IAAI,MAAM;IAMvB;;;;;;;;OAQG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA6B3B;;;;;;;;;;OAUG;YACW,OAAO;IAQrB;;;;;OAKG;IACG,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC;IA0BhC;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWhD;;;OAGG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOnD,6EAA6E;IACvE,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC;IAItC,mCAAmC;IAC7B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB9B,0EAA0E;IACpE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B;;;;;;;;OAQG;IACG,MAAM,CACV,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,WAAW,CAAA;KAAE,GACjE,OAAO,CAAC,YAAY,EAAE,CAAC;IAwE1B;;;;;;OAMG;IACG,UAAU,CACd,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,WAAW,CAAA;KAAO,GACrE,OAAO,CAAC,YAAY,EAAE,CAAC;IAmD1B;;;;OAIG;IACG,mBAAmB,CACvB,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GAChD,OAAO,CAAC;QAAE,OAAO,EAAE,YAAY,EAAE,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAC;IAMhE;;;;;;OAMG;YACW,YAAY;IA0C1B,mEAAmE;YACrD,eAAe;IAY7B;;;;;;;;;;;;OAYG;YACW,kBAAkB;IAiGhC;;;;OAIG;IACH,OAAO,CAAC,SAAS;IA2BjB;;;;;OAKG;YACW,UAAU;IAyCxB,gDAAgD;YAClC,kBAAkB;YA8HlB,GAAG;IAwBjB;;;;;;;OAOG;YACW,kBAAkB;IAkBhC;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAoBvB,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,SAAS;IAYjB;;;;OAIG;YACW,eAAe;CAO9B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/search/index.ts"],"names":[],"mappings":"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"}

package/dist/search/index.js

@@ -36,7 +36,7 @@ const ops_js_1 = require("../sync/ops.js");
  * 2.0) are no longer chunked, so an index built before it must be rebuilt or
  * it would keep serving entries that were retired.
  */
-exports.INDEX_VERSION = 6; // 4: keys field (1.15) · 5: entry_status (2.0) · 6: eid per chunk (2.1)
+exports.INDEX_VERSION = 7; // 4: keys field (1.15) · 5: entry_status (2.0) · 6: eid per chunk (2.1) · 7: session logs indexed (2.2)
 /** Weight given to a neuron for each *additional* chunk that matches. */
 const BREADTH_BONUS = 0.05;
 /** Cap on the breadth bonus — breadth is a tiebreaker, never the main signal. */
@@ -95,6 +95,62 @@ const SCHEMA = {
     added: 'string',
     heat: 'number',
 };
+const SESSION_MATCHES = 3;
+const SESSION_CHUNK = 700;
+/** Best chunk per session, top sessions by coverage-weighted score; total is how many days had a hit. */
+function topSessions(hits, queryTerms) {
+    const porSesion = new Map();
+    for (const h of hits.values()) {
+        const prev = porSesion.get(h.session);
+        if (!prev || h.score * h.matched > prev.score * prev.matched)
+            porSesion.set(h.session, h);
+    }
+    const matches = [...porSesion.values()]
+        // Ties broken by id, newest first, so the list is the same on every run.
+        .sort((a, b) => b.score * b.matched - a.score * a.matched || (a.session < b.session ? 1 : -1))
+        .slice(0, SESSION_MATCHES)
+        .map((h) => {
+        const strong = queryTerms <= 1 ? h.matched >= 1 : h.matched >= 2 && h.matched / queryTerms >= 0.5;
+        return {
+            session_id: h.session,
+            date: h.date,
+            entry_id: h.eid,
+            preview: h.text.length > 300 ? `${h.text.slice(0, 300).trimEnd()}…` : h.text,
+            chars: h.text.length,
+            matched_terms: h.matched,
+            query_terms: queryTerms,
+            confidence: strong ? 'strong' : 'weak',
+        };
+    });
+    return { matches, total: porSesion.size };
+}
+/**
+ * A summary becomes paragraphs of at most SESSION_CHUNK characters: a match
+ * then points at the paragraph that mentions the thing, and the preview is
+ * the paragraph itself, not the opening of a 7,000-character day.
+ */
+function sessionChunks(summary) {
+    const out = [];
+    for (const parrafo of summary.split(/\n-{3,}\n|\n{2,}/)) {
+        const p = parrafo.trim();
+        if (!p)
+            continue;
+        if (p.length <= SESSION_CHUNK) {
+            out.push(p);
+            continue;
+        }
+        let resto = p;
+        while (resto.length > SESSION_CHUNK) {
+            const corte = resto.lastIndexOf(' ', SESSION_CHUNK);
+            const at = corte > SESSION_CHUNK / 2 ? corte : SESSION_CHUNK;
+            out.push(resto.slice(0, at).trim());
+            resto = resto.slice(at).trim();
+        }
+        if (resto)
+            out.push(resto);
+    }
+    return out;
+}
 class SearchEngine {
     brain;
     db = null;
@@ -184,8 +240,10 @@ class SearchEngine {
         if (indexAt === 0)
             return true;
         const cortexAt = await (0, fs_js_1.newestMtime)(this.brain.paths.cortex);
+        // The diary is indexed too (2.2): a log written by another process counts.
+        const diaryAt = await (0, fs_js_1.newestMtime)(this.brain.paths.hippocampus);
         // One second of slack: a write landing during a rebuild is not staleness.
-        return cortexAt > indexAt + 1000;
+        return Math.max(cortexAt, diaryAt) > indexAt + 1000;
     }
     /**
      * Rebuild the whole index from the cortex.
@@ -209,6 +267,17 @@ class SearchEngine {
                 // Skip unreadable neuron, keep going.
             }
         }
+        // The diary too (2.2): every session log, as paragraphs.
+        for (const id of await (0, fs_js_1.listJSONFiles)(this.brain.paths.hippocampus)) {
+            try {
+                const log = await (0, fs_js_1.readJSON)(this.brain.paths.session(id));
+                if (log?.summary)
+                    await this.insertSessionChunks(log);
+            }
+            catch {
+                // Skip unreadable log, keep going.
+            }
+        }
         // Embeddings off the critical path: a rebuild after an upgrade must not
         // hold boot for minutes on a big brain. Recall serves what is embedded so
         // far; the vectors go to disk with the next index write.
@@ -293,6 +362,7 @@ class SearchEngine {
         if (terms.length === 0)
             return [];
         const perChunk = new Map();
+        const perSession = new Map();
         for (const term of terms) {
             const hits = await this.searchTerm(term, options?.domain);
             if (hits.length === 0)
@@ -302,6 +372,19 @@ class SearchEngine {
                 const doc = hit.document;
                 const key = doc.id;
                 const normalised = best > 0 ? hit.score / best : 0;
+                // Session logs are searched, but never as neurons: they keep a list
+                // of their own, so a long narrative cannot outrank the fact that
+                // answers, and the neuron path below never sees them.
+                if (doc.kind === 'session') {
+                    const prev = perSession.get(key);
+                    if (prev) {
+                        prev.score += normalised;
+                        prev.matched += 1;
+                    }
+                    else
+                        perSession.set(key, { session: String(doc.name || ''), date: String(doc.added || ''), text: String(doc.text || ''), eid: String(doc.eid || ''), score: normalised, matched: 1 });
+                    continue;
+                }
                 const existing = perChunk.get(key);
                 if (existing) {
                     existing.score += normalised;
@@ -334,6 +417,11 @@ class SearchEngine {
         if (this.semantic && this.semantic.ready() && this.semantic.count() > 0) {
             await this.fuseSemantic(query, perChunk, options?.domain);
         }
+        if (options?.stats) {
+            const top = topSessions(perSession, terms.length);
+            options.stats.sessions = top.matches;
+            options.stats.sessions_total = top.total;
+        }
         if (perChunk.size === 0)
             return [];
         // Group chunks by neuron, best first.
@@ -367,7 +455,36 @@ class SearchEngine {
         if (distintas.length === 1)
             return this.search(distintas[0], options);
         const limit = options.limit ?? 10;
-        const listas = await Promise.all(distintas.map(q => this.search(q, { ...options, limit: Math.max(limit, 10) * 2 })));
+        const porConsulta = distintas.map(() => ({}));
+        const listas = await Promise.all(distintas.map((q, i) => this.search(q, { ...options, stats: porConsulta[i], limit: Math.max(limit, 10) * 2 })));
+        if (options.stats) {
+            // Session hits: a day that several phrasings point at ranks first, then
+            // by accumulated coverage (matched over query terms, so 2/2 beats 3/8).
+            // The row kept is the best-covered one, strong if any phrasing found it
+            // so — and the same phrasings in any order give the same list.
+            const cobertura = (m) => (m.query_terms > 0 ? m.matched_terms / m.query_terms : 0);
+            const fusion = new Map();
+            for (const s of porConsulta) {
+                for (const m of s.sessions || []) {
+                    const f = fusion.get(m.session_id);
+                    if (!f) {
+                        fusion.set(m.session_id, { row: m, cobertura: cobertura(m), frases: 1, strong: m.confidence === 'strong' });
+                        continue;
+                    }
+                    f.cobertura += cobertura(m);
+                    f.frases += 1;
+                    f.strong = f.strong || m.confidence === 'strong';
+                    if (cobertura(m) > cobertura(f.row) || (cobertura(m) === cobertura(f.row) && m.matched_terms > f.row.matched_terms))
+                        f.row = m;
+                }
+            }
+            options.stats.sessions = [...fusion.values()]
+                .sort((a, b) => b.frases - a.frases || b.cobertura - a.cobertura || (a.row.session_id < b.row.session_id ? 1 : -1))
+                .slice(0, SESSION_MATCHES)
+                .map(f => ({ ...f.row, confidence: f.strong ? 'strong' : f.row.confidence }));
+            // Each phrasing counted its own days: the union is at least the largest count.
+            options.stats.sessions_total = Math.max(fusion.size, ...porConsulta.map(s => s.sessions_total || 0));
+        }
         const fused = new Map();
         const alsoOf = (r) => alsoLine(r.matching_content, r.matched_kind || '', r.matched_added || '', r.entry_id);
         for (const lista of listas) {
@@ -424,7 +541,8 @@ class SearchEngine {
     async searchManyWithStats(queries, options = {}) {
         const stats = {};
         const results = await this.searchMany(queries, { ...options, stats });
-        return { results, matched_neurons: stats.matched_neurons ?? results.length };
+        const sessions = stats.sessions ?? [];
+        return { results, matched_neurons: stats.matched_neurons ?? results.length, sessions, sessions_total: stats.sessions_total ?? sessions.length };
     }
     /**
      * Blend the vector ranking into the lexical one with reciprocal-rank
@@ -455,7 +573,7 @@ class SearchEngine {
             catch {
                 doc = undefined;
             }
-            if (!doc || doc.kind === 'header')
+            if (!doc || doc.kind === 'header' || doc.kind === 'session')
                 continue;
             if (domain && doc.domain !== domain)
                 continue;
@@ -642,7 +760,9 @@ class SearchEngine {
             // Filtered here, not with an Orama `where` clause: a `where` on a
             // plain string field matches nothing at all, so the old code turned
             // every domain-scoped recall into zero results (measured).
-            return domain ? hits.filter(h => h.document.domain === domain) : hits;
+            // Day logs have no domain: a domain-scoped recall still lists the days
+            // that mention it, in their own list, or the diary vanished in silence.
+            return domain ? hits.filter(h => h.document.kind === 'session' || h.document.domain === domain) : hits;
         };
         let hits = await run(0);
         // Try the other grammatical number too, and keep the best score each
@@ -662,8 +782,14 @@ class SearchEngine {
             }
             hits = [...mejor.values()].sort((a, b) => b.score - a.score);
         }
-        if (hits.length === 0 && term.length >= 5) {
-            hits = await run(1);
+        // Decided on neuron hits, not on hits at all: since 2.2 a day log that
+        // repeats the user's typo verbatim is an exact hit, and it must not switch
+        // off the slack that still finds the fact spelled right.
+        if (term.length >= 5 && !hits.some(h => h.document.kind !== 'session')) {
+            const vistos = new Set(hits.map(h => h.document.id));
+            const fuzzy = (await run(1)).filter(h => h.document.kind !== 'session' && !vistos.has(h.document.id));
+            if (fuzzy.length > 0)
+                hits = [...hits, ...fuzzy].sort((a, b) => b.score - a.score);
         }
         return hits;
     }
@@ -795,6 +921,38 @@ class SearchEngine {
             });
         }
     }
+    /**
+     * Index one session log, replacing whatever it had. Called by consolidate
+     * for the day just logged and by rebuild for the whole diary.
+     */
+    async indexSession(log) {
+        if (!this.db)
+            await this.init();
+        if (!this.db)
+            return;
+        await this.removeNeuronChunks(`session:${log.session_id}`);
+        if (log.summary)
+            await this.insertSessionChunks(log);
+        this.markDirty();
+    }
+    async insertSessionChunks(log) {
+        const trozos = sessionChunks(String(log.summary || ''));
+        for (let i = 0; i < trozos.length; i++) {
+            await this.put({
+                id: (0, hash_js_1.chunkId)(`session:${log.session_id}`, trozos[i]),
+                neuron: `session:${log.session_id}`,
+                name: log.session_id,
+                text: trozos[i],
+                keys: '',
+                kind: 'session',
+                eid: `${log.session_id}#${i}`,
+                domain: '',
+                tags: '',
+                added: log.date || '',
+                heat: 0,
+            });
+        }
+    }
     async put(doc) {
         try {
             await (0, orama_1.insert)(this.db, doc);
@@ -815,8 +973,9 @@ class SearchEngine {
         }
         ids.add(String(doc.id));
         // Headers are name + tags: lexical only, they would only add noise to
-        // the vector index.
-        if (this.semantic && doc.kind !== 'header') {
+        // the vector index. Session logs stay lexical too, for now: the words a
+        // day was described with are the words it is asked about.
+        if (this.semantic && doc.kind !== 'header' && doc.kind !== 'session') {
             this.pendingEmbed.set(String(doc.id), String(doc.text || ''));
         }
     }