@nxuss/lemma 1.37.0 → 1.39.0

package/dist/cjs/mcp/workspaceShared.js.map

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

package/dist/cjs/proxy/ProjectRegistry.d.ts

@@ -2,16 +2,60 @@ export interface RegisteredProject {
     name: string;
     path: string;
     stack: string;
+    /** Last handshake or tool call — what getActive() ranks by. Heartbeats don't move it. */
     lastActive: number;
+    /** Last sign of life from any MCP server in this project: handshake, heartbeat or tool call. */
+    lastSeen: number;
+    /** Last MCP tool call, or null if the project connected but hasn't called a tool yet. */
+    lastToolCall: number | null;
+    toolCallCount: number;
 }
+export type ProjectStatus = 'active' | 'idle' | 'offline';
+export interface ProjectSnapshot extends RegisteredProject {
+    status: ProjectStatus;
+    /** Distinct memories a recall note (hook, briefing or read-tool note) put in front of an agent. */
+    offeredCount: number;
+    /** Of those, how many the agent then opened with get_memory. */
+    usedCount: number;
+}
+/** MCP servers heartbeat every 30s; three missed beats and the project counts as disconnected. */
+export declare const OFFLINE_AFTER_MS = 90000;
+/** Same threshold /api/mcp-status uses for "active". */
+export declare const ACTIVE_WITHIN_MS = 60000;
+/**
+ * A get_memory counts as using an offered memory only this soon after the offer — a stand-in
+ * for "the same working session", since the hook knows the host's session id and the MCP
+ * server doesn't.
+ */
+export declare const RECALL_USE_WINDOW_MS: number;
 export declare class ProjectRegistry {
     private projects;
+    private recall;
+    private tally;
     register(projectPath: string, name: string, stack: string): RegisteredProject;
+    /**
+     * Keep-alive from an MCP server. Re-registers a project the daemon forgot (it restarted),
+     * but leaves lastActive alone so idle sessions heartbeating in the background don't steal
+     * getActive() from the project actually being worked on.
+     */
+    heartbeat(projectPath: string, name: string, stack: string): RegisteredProject;
+    /** A tool call from this project. Registers it if the handshake never reached this daemon. */
+    recordToolCall(projectPath: string): RegisteredProject;
+    /** A recall note offered these memories in this project. Doesn't touch connection status. */
+    recordOffered(projectPath: string, ids: string[], now?: number): void;
+    /**
+     * get_memory read `id` in this project. True when a note had offered it within
+     * RECALL_USE_WINDOW_MS — the agent acted on recall it didn't have to search for. A read of a
+     * memory nobody offered (an id from search_memory, or carried over) is not counted here.
+     */
+    recordRecallUse(projectPath: string, id: string, now?: number): boolean;
     get(projectPath: string): RegisteredProject | undefined;
     touch(projectPath: string): void;
     getActive(): RegisteredProject | null;
     findByPathFragment(text: string): RegisteredProject | null;
     isStale(project: RegisteredProject, hours?: number): boolean;
     getAll(): RegisteredProject[];
+    /** Every known project with its connection status, most recently active first. */
+    snapshot(now?: number): ProjectSnapshot[];
 }
 //# sourceMappingURL=ProjectRegistry.d.ts.map

package/dist/cjs/proxy/ProjectRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ProjectRegistry.d.ts","sourceRoot":"","sources":["../../../src/proxy/ProjectRegistry.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAwC;IAExD,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,iBAAiB;IAiB7E,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAIvD,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAKhC,SAAS,IAAI,iBAAiB,GAAG,IAAI;IAYrC,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI;IAQ1D,OAAO,CAAC,OAAO,EAAE,iBAAiB,EAAE,KAAK,SAAK,GAAG,OAAO;IAIxD,MAAM,IAAI,iBAAiB,EAAE;CAG9B"}
+{"version":3,"file":"ProjectRegistry.d.ts","sourceRoot":"","sources":["../../../src/proxy/ProjectRegistry.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,yFAAyF;IACzF,UAAU,EAAE,MAAM,CAAC;IACnB,gGAAgG;IAChG,QAAQ,EAAE,MAAM,CAAC;IACjB,yFAAyF;IACzF,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;AAE1D,MAAM,WAAW,eAAgB,SAAQ,iBAAiB;IACxD,MAAM,EAAE,aAAa,CAAC;IACtB,mGAAmG;IACnG,YAAY,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,kGAAkG;AAClG,eAAO,MAAM,gBAAgB,QAAS,CAAC;AACvC,wDAAwD;AACxD,eAAO,MAAM,gBAAgB,QAAS,CAAC;AACvC;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,QAAqB,CAAC;AAWvD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAwC;IACxD,OAAO,CAAC,MAAM,CAAkC;IAEhD,OAAO,CAAC,KAAK;IASb,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,iBAAiB;IAsB7E;;;;OAIG;IACH,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,iBAAiB;IAQ9E,8FAA8F;IAC9F,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,iBAAiB;IAUtD,6FAA6F;IAC7F,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,GAAG,SAAa,GAAG,IAAI;IAUzE;;;;OAIG;IACH,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,SAAa,GAAG,OAAO;IAQ3E,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAIvD,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAKhC,SAAS,IAAI,iBAAiB,GAAG,IAAI;IAYrC,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI;IAQ1D,OAAO,CAAC,OAAO,EAAE,iBAAiB,EAAE,KAAK,SAAK,GAAG,OAAO;IAIxD,MAAM,IAAI,iBAAiB,EAAE;IAI7B,kFAAkF;IAClF,QAAQ,CAAC,GAAG,SAAa,GAAG,eAAe,EAAE;CAW9C"}

package/dist/cjs/proxy/ProjectRegistry.js

@@ -1,14 +1,37 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ProjectRegistry = void 0;
+exports.ProjectRegistry = exports.RECALL_USE_WINDOW_MS = exports.ACTIVE_WITHIN_MS = exports.OFFLINE_AFTER_MS = void 0;
+/** MCP servers heartbeat every 30s; three missed beats and the project counts as disconnected. */
+exports.OFFLINE_AFTER_MS = 90000;
+/** Same threshold /api/mcp-status uses for "active". */
+exports.ACTIVE_WITHIN_MS = 60000;
+/**
+ * A get_memory counts as using an offered memory only this soon after the offer — a stand-in
+ * for "the same working session", since the hook knows the host's session id and the MCP
+ * server doesn't.
+ */
+exports.RECALL_USE_WINDOW_MS = 6 * 60 * 60 * 1000;
+const MAX_OFFERED_PER_PROJECT = 2000;
+const folderName = (projectPath) => projectPath.split(/[\\/]/).filter(Boolean).pop() || projectPath;
 class ProjectRegistry {
     constructor() {
         this.projects = new Map();
+        this.recall = new Map();
+    }
+    tally(projectPath) {
+        let t = this.recall.get(projectPath);
+        if (!t) {
+            t = { offered: new Map(), used: new Set() };
+            this.recall.set(projectPath, t);
+        }
+        return t;
     }
     register(projectPath, name, stack) {
+        const now = Date.now();
         const existing = this.projects.get(projectPath);
         if (existing) {
-            existing.lastActive = Date.now();
+            existing.lastActive = now;
+            existing.lastSeen = now;
             if (stack && stack !== existing.stack)
                 existing.stack = stack;
             return existing;
@@ -17,11 +40,63 @@ class ProjectRegistry {
             name,
             path: projectPath,
             stack,
-            lastActive: Date.now(),
+            lastActive: now,
+            lastSeen: now,
+            lastToolCall: null,
+            toolCallCount: 0,
         };
         this.projects.set(projectPath, project);
         return project;
     }
+    /**
+     * Keep-alive from an MCP server. Re-registers a project the daemon forgot (it restarted),
+     * but leaves lastActive alone so idle sessions heartbeating in the background don't steal
+     * getActive() from the project actually being worked on.
+     */
+    heartbeat(projectPath, name, stack) {
+        const existing = this.projects.get(projectPath);
+        if (!existing)
+            return this.register(projectPath, name, stack);
+        existing.lastSeen = Date.now();
+        if (stack && stack !== existing.stack)
+            existing.stack = stack;
+        return existing;
+    }
+    /** A tool call from this project. Registers it if the handshake never reached this daemon. */
+    recordToolCall(projectPath) {
+        const project = this.projects.get(projectPath) ?? this.register(projectPath, folderName(projectPath), '');
+        const now = Date.now();
+        project.lastActive = now;
+        project.lastSeen = now;
+        project.lastToolCall = now;
+        project.toolCallCount++;
+        return project;
+    }
+    /** A recall note offered these memories in this project. Doesn't touch connection status. */
+    recordOffered(projectPath, ids, now = Date.now()) {
+        if (!this.projects.has(projectPath))
+            this.register(projectPath, folderName(projectPath), '');
+        const { offered } = this.tally(projectPath);
+        for (const id of ids) {
+            offered.delete(id); // re-insert so the oldest offers are the ones evicted
+            offered.set(id, now);
+        }
+        while (offered.size > MAX_OFFERED_PER_PROJECT)
+            offered.delete(offered.keys().next().value);
+    }
+    /**
+     * get_memory read `id` in this project. True when a note had offered it within
+     * RECALL_USE_WINDOW_MS — the agent acted on recall it didn't have to search for. A read of a
+     * memory nobody offered (an id from search_memory, or carried over) is not counted here.
+     */
+    recordRecallUse(projectPath, id, now = Date.now()) {
+        const t = this.recall.get(projectPath);
+        const at = t?.offered.get(id);
+        if (!t || at === undefined || now - at > exports.RECALL_USE_WINDOW_MS)
+            return false;
+        t.used.add(id);
+        return true;
+    }
     get(projectPath) {
         return this.projects.get(projectPath);
     }
@@ -55,6 +130,20 @@ class ProjectRegistry {
     getAll() {
         return Array.from(this.projects.values());
     }
+    /** Every known project with its connection status, most recently active first. */
+    snapshot(now = Date.now()) {
+        return this.getAll()
+            .map((p) => {
+            let status = 'idle';
+            if (now - p.lastSeen > exports.OFFLINE_AFTER_MS)
+                status = 'offline';
+            else if (p.lastToolCall !== null && now - p.lastToolCall < exports.ACTIVE_WITHIN_MS)
+                status = 'active';
+            const t = this.recall.get(p.path);
+            return { ...p, status, offeredCount: t?.offered.size ?? 0, usedCount: t?.used.size ?? 0 };
+        })
+            .sort((a, b) => b.lastActive - a.lastActive);
+    }
 }
 exports.ProjectRegistry = ProjectRegistry;
 //# sourceMappingURL=ProjectRegistry.js.map

package/dist/cjs/proxy/ProjectRegistry.js.map

@@ -1 +1 @@
-{"version":3,"file":"ProjectRegistry.js","sourceRoot":"","sources":["../../../src/proxy/ProjectRegistry.ts"],"names":[],"mappings":";;;AAOA,MAAa,eAAe;IAA5B;QACU,aAAQ,GAAG,IAAI,GAAG,EAA6B,CAAC;IAuD1D,CAAC;IArDC,QAAQ,CAAC,WAAmB,EAAE,IAAY,EAAE,KAAa;QACvD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAChD,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACjC,IAAI,KAAK,IAAI,KAAK,KAAK,QAAQ,CAAC,KAAK;gBAAE,QAAQ,CAAC,KAAK,GAAG,KAAK,CAAC;YAC9D,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,MAAM,OAAO,GAAsB;YACjC,IAAI;YACJ,IAAI,EAAE,WAAW;YACjB,KAAK;YACL,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;SACvB,CAAC;QACF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACxC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,GAAG,CAAC,WAAmB;QACrB,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,WAAmB;QACvB,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACzC,IAAI,CAAC;YAAE,CAAC,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACnC,CAAC;IAED,SAAS;QACP,IAAI,MAAM,GAA6B,IAAI,CAAC;QAC5C,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YACvC,IAAI,CAAC,CAAC,UAAU,GAAG,MAAM,EAAE,CAAC;gBAC1B,MAAM,GAAG,CAAC,CAAC,UAAU,CAAC;gBACtB,MAAM,GAAG,CAAC,CAAC;YACb,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,kBAAkB,CAAC,IAAY;QAC7B,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC5C,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;YACvC,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;gBAAE,OAAO,CAAC,CAAC;QAC3E,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CAAC,OAA0B,EAAE,KAAK,GAAG,EAAE;QAC5C,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,UAAU,GAAG,KAAK,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAClE,CAAC;IAED,MAAM;QACJ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5C,CAAC;CACF;AAxDD,0CAwDC"}
+{"version":3,"file":"ProjectRegistry.js","sourceRoot":"","sources":["../../../src/proxy/ProjectRegistry.ts"],"names":[],"mappings":"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"}

package/dist/cjs/subconscious/HostRecall.d.ts

@@ -8,7 +8,7 @@
  * has no reason to. This module answers a host PostToolUse hook payload with the same kind of
  * note, at the same three moments:
  *
- *  - Reading a file the Brain has memories about → their ids (formatRecallNote's rule).
+ *  - Reading a file the Brain has memories about → a digest of the most relevant (recallDigest).
  *  - Editing a file a documented FAILED attempt depends on → a warning. Plain "this will go
  *    stale" notes stay off for native edits: they are the common case and not worth context.
  *  - A verdict command (test/build/lint) failing with an error the Brain already has a recorded
@@ -27,6 +27,14 @@
  * only when a search actually returns it to a caller.
  */
 import { TheBrainV2 } from './TheBrainV2';
+import type { RecallTrigger } from '../utils/reportSavings';
+/** A note plus what it put in front of the agent — reported to the dashboard as recall. */
+export interface RecallNote {
+    text: string;
+    /** Ids the note named. Empty for notes that carry no memory (stale build, status question). */
+    offered: string[];
+    trigger: RecallTrigger;
+}
 /**
  * BM25 similarity is normalized against the corpus, so the top result of any query scores
  * high — and every fix memory shares the "fix:" token. It only nominates candidates; this
@@ -41,9 +49,21 @@ export declare function headlineOverlap(a: string, b: string): number;
  * Never throws: a recall hint must never be the reason a tool call reports an error.
  */
 export declare function recallForHookPayload(payload: unknown, cwd?: string, brain?: TheBrainV2): string;
+/** recallForHookPayload with what the note offered, for reporting. Null when there's no note. */
+export declare function hookRecall(payload: unknown, cwd?: string, brain?: TheBrainV2): RecallNote | null;
 export declare function isStatusQuestion(prompt: string): boolean;
-/** Share of the memory headline's terms that also appear in the prompt. */
-export declare function headlineCoverage(headline: string, prompt: string): number;
+/**
+ * How much of what the prompt is about appears in a memory's headline: the IDF-weighted share
+ * of the prompt's words (or their stem / bilingual synonym) found among the headline's terms.
+ *
+ * This replaced "share of the headline found in the prompt", which needed a short prompt to
+ * restate half of a long, specific headline: measured on Lemma's own Brain it offered the right
+ * memory for 1 of 30 real questions; weighted toward the prompt's rare words it offers several
+ * times more and never a wrong one (thresholds above). Prompts with under PROMPT_MIN_UNITS
+ * informative words are skipped, which is where the false offers were. This note arrives unasked on every prompt, so it keeps
+ * a floor — search_memory, which the agent calls on purpose, does not.
+ */
+export declare function promptCoverage(headline: string, prompt: string, idf: (term: string) => number): number;
 /**
  * The note (empty string for none) for a host UserPromptSubmit payload. This is the one
  * moment recall can happen before the agent answers from its own notes: a status question
@@ -63,4 +83,17 @@ export interface PromptRecallOptions {
     mcpProcessDir?: string;
 }
 export declare function recallForPrompt(payload: unknown, cwd?: string, brain?: TheBrainV2, options?: PromptRecallOptions): string;
+/** recallForPrompt with the memories it offered, for reporting. Null when there's nothing to say. */
+export declare function promptRecall(payload: unknown, cwd?: string, brain?: TheBrainV2, options?: PromptRecallOptions): RecallNote | null;
+/** Tools the playbook names, in one ToolSearch line for hosts that defer MCP schemas. */
+export declare const PLAYBOOK_TOOLS: string[];
+/**
+ * When to reach for Lemma — triggers, not judgment calls. "Use it when it adds value" let every
+ * individual call look cheaper native; these are the moments where Lemma does something the
+ * native tools can't, so there is no cheaper alternative to weigh.
+ */
+export declare const LEMMA_PLAYBOOK: string;
+export declare function sessionBriefing(payload: unknown, cwd?: string, brain?: TheBrainV2): string;
+/** sessionBriefing with the memories it named, for reporting. */
+export declare function sessionRecall(payload: unknown, cwd?: string, brain?: TheBrainV2): RecallNote | null;
 //# sourceMappingURL=HostRecall.d.ts.map

package/dist/cjs/subconscious/HostRecall.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HostRecall.d.ts","sourceRoot":"","sources":["../../../src/subconscious/HostRecall.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAIH,OAAO,EAA0C,UAAU,EAAE,MAAM,cAAc,CAAC;AAQlF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAmEzC,uFAAuF;AACvF,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAO5D;AAwBD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,UAAU,GAAG,MAAM,CAgC/F;AAWD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAExD;AAQD,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAOzE;AAQD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,mBAAmB;IAClC,gGAAgG;IAChG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,UAAU,EAAE,OAAO,GAAE,mBAAwB,GAAG,MAAM,CAqD7H"}
+{"version":3,"file":"HostRecall.d.ts","sourceRoot":"","sources":["../../../src/subconscious/HostRecall.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAIH,OAAO,EAA0C,UAAU,EAAY,MAAM,cAAc,CAAC;AAO5F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,2FAA2F;AAC3F,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,+FAA+F;IAC/F,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,aAAa,CAAC;CACxB;AAKD;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAoEzC,uFAAuF;AACvF,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAO5D;AA0BD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,UAAU,GAAG,MAAM,CAE/F;AAED,iGAAiG;AACjG,wBAAgB,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI,CAgChG;AAWD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAExD;AA6BD;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,MAAM,CAYtG;AAQD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,mBAAmB;IAClC,gGAAgG;IAChG,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,UAAU,EAAE,OAAO,GAAE,mBAAwB,GAAG,MAAM,CAE7H;AAED,qGAAqG;AACrG,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,UAAU,EAAE,OAAO,GAAE,mBAAwB,GAAG,UAAU,GAAG,IAAI,CA6DrI;AASD,yFAAyF;AACzF,eAAO,MAAM,cAAc,UAQ1B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,cAAc,QAQf,CAAC;AAIb,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,UAAU,GAAG,MAAM,CAE1F;AAED,iEAAiE;AACjE,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI,CAiCnG"}

package/dist/cjs/subconscious/HostRecall.js

@@ -9,7 +9,7 @@
  * has no reason to. This module answers a host PostToolUse hook payload with the same kind of
  * note, at the same three moments:
  *
- *  - Reading a file the Brain has memories about → their ids (formatRecallNote's rule).
+ *  - Reading a file the Brain has memories about → a digest of the most relevant (recallDigest).
  *  - Editing a file a documented FAILED attempt depends on → a warning. Plain "this will go
  *    stale" notes stay off for native edits: they are the common case and not worth context.
  *  - A verdict command (test/build/lint) failing with an error the Brain already has a recorded
@@ -31,12 +31,16 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FIX_MATCH_MIN_OVERLAP = void 0;
+exports.LEMMA_PLAYBOOK = exports.PLAYBOOK_TOOLS = exports.FIX_MATCH_MIN_OVERLAP = void 0;
 exports.headlineOverlap = headlineOverlap;
 exports.recallForHookPayload = recallForHookPayload;
+exports.hookRecall = hookRecall;
 exports.isStatusQuestion = isStatusQuestion;
-exports.headlineCoverage = headlineCoverage;
+exports.promptCoverage = promptCoverage;
 exports.recallForPrompt = recallForPrompt;
+exports.promptRecall = promptRecall;
+exports.sessionBriefing = sessionBriefing;
+exports.sessionRecall = sessionRecall;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const TheBrainV2_1 = require("./TheBrainV2");
@@ -45,6 +49,7 @@ const FixCapture_1 = require("../utils/FixCapture");
 const ageLabel_1 = require("../utils/ageLabel");
 const StoreDraft_1 = require("../utils/StoreDraft");
 const staleBuild_1 = require("../mcp/staleBuild");
+const recallDigest_1 = require("./recallDigest");
 const STATE_FILE = path_1.default.join('.lemma', 'session', 'host-recall.json');
 /**
  * BM25 similarity is normalized against the corpus, so the top result of any query scores
@@ -86,12 +91,12 @@ function fileNote(brain, toolName, filePath) {
         return null;
     const name = path_1.default.basename(filePath);
     if (READ_TOOLS.has(toolName)) {
-        const ids = result.hits.map((h) => h.id).sort();
-        let text = `🧠 Lemma Brain has ${result.hits.length} ${plural(result.hits.length, 'memory', 'memories')} about ${name}: ${ids.join(', ')}. verify_memory ${plural(ids.length, 'it', 'them')} before investigating from scratch.`;
-        if (result.failedHits.length > 0) {
-            text += ` ⚠️ ${result.failedHits.map((h) => h.id).join(', ')} document an approach that FAILED here — read before repeating it.`;
-        }
-        return { key: `read::${path_1.default.resolve(filePath)}::${ids.join(',')}`, text };
+        const hits = (0, recallDigest_1.recallableHits)(brain, result.hits);
+        if (hits.length === 0)
+            return null;
+        const ids = hits.map((h) => h.id).sort();
+        const digest = (0, recallDigest_1.digestFileHits)(brain, hits);
+        return { key: `read::${path_1.default.resolve(filePath)}::${ids.join(',')}`, text: (0, recallDigest_1.formatFileDigest)(name, digest), offered: digest.ids, trigger: 'read' };
     }
     // Native edits: only the escalated case. "N memories will go stale" on every edit is noise.
     if (result.failedHits.length === 0)
@@ -100,6 +105,8 @@ function fileNote(brain, toolName, filePath) {
     return {
         key: `edit::${path_1.default.resolve(filePath)}::${failedIds.join(',')}`,
         text: `⚠️ Lemma Brain: ${failedIds.join(', ')} document an approach to ${name} that was tried and FAILED. get_memory them before continuing down this path.`,
+        offered: failedIds,
+        trigger: 'edit',
     };
 }
 function headlineTerms(text) {
@@ -144,6 +151,8 @@ function failureNote(brain, root, output) {
     return {
         key: `fix::${match.id}`,
         text: `🧠 Lemma Brain has a recorded fix for a failure like this one (id ${match.id}): "${match.query.slice(0, 120)}". get_memory ${match.id} for the files and diff that fixed it.`,
+        offered: [match.id],
+        trigger: 'failure',
     };
 }
 /**
@@ -151,9 +160,13 @@ function failureNote(brain, root, output) {
  * Never throws: a recall hint must never be the reason a tool call reports an error.
  */
 function recallForHookPayload(payload, cwd, brain) {
+    return hookRecall(payload, cwd, brain)?.text ?? '';
+}
+/** recallForHookPayload with what the note offered, for reporting. Null when there's no note. */
+function hookRecall(payload, cwd, brain) {
     try {
         if (!payload || typeof payload !== 'object')
-            return '';
+            return null;
         const p = payload;
         const toolName = typeof p.tool_name === 'string' ? p.tool_name : '';
         const root = (0, TeamBrain_1.repoRoot)(cwd || p.cwd || process.cwd());
@@ -162,31 +175,31 @@ function recallForHookPayload(payload, cwd, brain) {
         if (READ_TOOLS.has(toolName) || EDIT_TOOLS.has(toolName)) {
             const raw = p.tool_input?.file_path ?? p.tool_input?.notebook_path;
             if (typeof raw !== 'string' || !raw)
-                return '';
+                return null;
             const filePath = path_1.default.isAbsolute(raw) ? raw : path_1.default.join(root, raw);
             note = fileNote(b, toolName, filePath);
         }
         else if (toolName === 'Bash') {
             const command = p.tool_input?.command;
             if (typeof command !== 'string' || !(0, FixCapture_1.isVerdictCommand)(command))
-                return '';
+                return null;
             const verdict = (0, FixCapture_1.hookVerdict)(p);
             if (!verdict || verdict.passed)
-                return '';
+                return null;
             note = failureNote(b, root, verdict.output);
         }
         if (!note)
-            return '';
+            return null;
         const sessionId = typeof p.session_id === 'string' ? p.session_id : '';
         const state = readState(root, sessionId);
         if (state.noted.includes(note.key))
-            return '';
+            return null;
         state.noted.push(note.key);
         writeState(root, state);
-        return note.text;
+        return { text: note.text, offered: note.offered, trigger: note.trigger };
     }
     catch {
-        return '';
+        return null;
     }
 }
 /**
@@ -201,20 +214,52 @@ function isStatusQuestion(prompt) {
 }
 /** At most this many memories are named in one prompt note. */
 const MAX_PROMPT_HITS = 3;
-/** A prompt is long and a memory headline short, so overlap is measured against the headline. */
+/**
+ * Share of the prompt's information (IDF-weighted) a memory headline must carry: the best-ranked
+ * memory needs PROMPT_TOP_COVERAGE, the next ones PROMPT_MIN_COVERAGE. Measured on Lemma's own
+ * Brain: 13 of 35 real questions get the right memory and none a wrong one, while 1 of 40
+ * unrelated work prompts gets an offer. The lexical rank is right far more often than any
+ * single memory's coverage says, so the top result gets the lower bar.
+ */
+const PROMPT_TOP_COVERAGE = 0.4;
 const PROMPT_MIN_COVERAGE = 0.5;
-const PROMPT_MIN_HEADLINE_TERMS = 3;
-/** Share of the memory headline's terms that also appear in the prompt. */
-function headlineCoverage(headline, prompt) {
-    const h = headlineTerms(headline);
-    if (h.size < PROMPT_MIN_HEADLINE_TERMS)
+/** Prompts with fewer informative words ("run the tests", "commit and push") carry no topic. */
+const PROMPT_MIN_UNITS = 3;
+/** Each word of `text` with its index expansions (stem, synonym tag); stop words drop out. */
+function wordUnits(text) {
+    const words = new Set(text
+        .normalize('NFD')
+        .replace(/[\u0300-\u036f]/g, '')
+        .toLowerCase()
+        .split(/[^a-z0-9]+/)
+        .filter(Boolean));
+    return [...words].map((w) => (0, TheBrainV2_1.tokenize)(w)).filter((u) => u.length > 0);
+}
+/**
+ * How much of what the prompt is about appears in a memory's headline: the IDF-weighted share
+ * of the prompt's words (or their stem / bilingual synonym) found among the headline's terms.
+ *
+ * This replaced "share of the headline found in the prompt", which needed a short prompt to
+ * restate half of a long, specific headline: measured on Lemma's own Brain it offered the right
+ * memory for 1 of 30 real questions; weighted toward the prompt's rare words it offers several
+ * times more and never a wrong one (thresholds above). Prompts with under PROMPT_MIN_UNITS
+ * informative words are skipped, which is where the false offers were. This note arrives unasked on every prompt, so it keeps
+ * a floor — search_memory, which the agent calls on purpose, does not.
+ */
+function promptCoverage(headline, prompt, idf) {
+    const units = wordUnits(prompt);
+    if (units.length < PROMPT_MIN_UNITS)
         return 0;
-    const p = headlineTerms(prompt);
-    let shared = 0;
-    for (const t of h)
-        if (p.has(t))
-            shared++;
-    return shared / h.size;
+    const head = new Set((0, TheBrainV2_1.tokenize)(headline));
+    let total = 0;
+    let covered = 0;
+    for (const unit of units) {
+        const weight = Math.max(...unit.map(idf));
+        total += weight;
+        if (unit.some((t) => head.has(t)))
+            covered += weight;
+    }
+    return total > 0 ? covered / total : 0;
 }
 function promptKey(prompt) {
     let h = 0;
@@ -223,27 +268,37 @@ function promptKey(prompt) {
     return `prompt::${h}`;
 }
 function recallForPrompt(payload, cwd, brain, options = {}) {
+    return promptRecall(payload, cwd, brain, options)?.text ?? '';
+}
+/** recallForPrompt with the memories it offered, for reporting. Null when there's nothing to say. */
+function promptRecall(payload, cwd, brain, options = {}) {
     try {
         if (!payload || typeof payload !== 'object')
-            return '';
+            return null;
         const p = payload;
         const prompt = typeof p.prompt === 'string' ? p.prompt.trim() : '';
         // Slash commands and one-word replies carry no topic worth a lookup.
         if (prompt.length < 12 || prompt.startsWith('/'))
-            return '';
+            return null;
         const root = (0, TeamBrain_1.repoRoot)(cwd || p.cwd || process.cwd());
         const b = brain ?? (0, TheBrainV2_1.getBrain)();
         const lines = [];
         const hits = b
             .search(prompt.slice(0, 600), 8, 0, { countStats: false, projectId: (0, TheBrainV2_1.deriveProjectId)(root), strictProject: true })
-            .filter((r) => headlineCoverage(r.query, prompt) >= PROMPT_MIN_COVERAGE)
+            .filter((r, rank) => promptCoverage(r.query, prompt, (t) => b.termIdf(t)) >= (rank === 0 ? PROMPT_TOP_COVERAGE : PROMPT_MIN_COVERAGE))
+            .filter((r) => {
+            const entry = b.getEntry(r.id);
+            return !entry || (0, TheBrainV2_1.entrySource)(entry) !== 'auto-git';
+        })
             .slice(0, MAX_PROMPT_HITS);
         if (hits.length > 0) {
+            // With the headline: an id alone gives the agent nothing to judge relevance by.
             const described = hits.map((r) => {
                 const verdict = !r.fresh ? 'STALE' : r.untracked ? 'untracked' : 'fresh';
-                return `${r.id} (${(0, ageLabel_1.ageLabel)(r.timestamp)}, ${verdict}${r.outcome === 'failed' ? ', FAILED approach' : ''})`;
+                const head = r.query.replace(/\s+/g, ' ').trim();
+                return `  • ${r.id} (${verdict}, ${(0, ageLabel_1.ageLabel)(r.timestamp)}${r.outcome === 'failed' ? ', FAILED approach' : ''}): ${head.length > 110 ? `${head.slice(0, 109)}…` : head}`;
             });
-            lines.push(`🧠 Lemma Brain has ${plural(hits.length, 'a memory', 'memories')} that may bear on this: ${described.join('; ')}. get_memory / verify_memory before relying on ${plural(hits.length, 'it', 'them')}.`);
+            lines.push(`🧠 Lemma Brain has ${plural(hits.length, 'a memory', 'memories')} that may bear on this:`, ...described, `get_memory the one that applies before relying on it; a STALE one must be re-checked against the current code.`);
         }
         if (isStatusQuestion(prompt)) {
             lines.push('🧠 This is a status question: recalled memories and notes go stale as MRs merge and issues close. Verify live state (git fetch/log, gh/glab) before saying what is pending.');
@@ -253,9 +308,11 @@ function recallForPrompt(payload, cwd, brain, options = {}) {
         const out = [];
         // Topical lines are deduped per prompt; the other two have their own one-shot rules.
         const key = promptKey(prompt);
+        let offered = [];
         if (lines.length > 0 && !state.noted.includes(key)) {
             out.push(...lines);
             state.noted.push(key);
+            offered = hits.map((r) => r.id);
         }
         // A build newer than the running MCP process is spoken once per host session: it is true
         // until the user reconnects, and the tool-result suffix never reaches someone who does not
@@ -271,12 +328,82 @@ function recallForPrompt(payload, cwd, brain, options = {}) {
         if (draft)
             out.push(draft);
         if (out.length === 0)
-            return '';
+            return null;
         writeState(root, state);
-        return out.join('\n');
+        return { text: out.join('\n'), offered, trigger: 'prompt' };
     }
     catch {
-        return '';
+        return null;
+    }
+}
+// ── SessionStart: the briefing that used to depend on the agent calling for it ──────────
+//
+// CLAUDE.md said "call get_project_onboarding at the start" and "search_memory before
+// investigating". Both were prose the agent could weigh and skip — and did: a session could
+// run start to finish on native tools and never learn the Brain held the answer. A SessionStart
+// hook puts the essentials in context before the first prompt, with no tool call to forget.
+/** Tools the playbook names, in one ToolSearch line for hosts that defer MCP schemas. */
+exports.PLAYBOOK_TOOLS = [
+    'search_memory',
+    'get_memory',
+    'verify_memory',
+    'store_memory',
+    'update_memory',
+    'read_workspace_file',
+    'search_workspace',
+];
+/**
+ * When to reach for Lemma — triggers, not judgment calls. "Use it when it adds value" let every
+ * individual call look cheaper native; these are the moments where Lemma does something the
+ * native tools can't, so there is no cheaper alternative to weigh.
+ */
+exports.LEMMA_PLAYBOOK = [
+    'Lemma playbook — follow these triggers:',
+    '  - Before investigating a bug, error or "why does X": search_memory with the error text or question.',
+    '  - A 🧠 note names memories: get_memory the top one before re-deriving what it says.',
+    '  - A fix is verified (tests pass, build succeeds, user confirms): store_memory with filePaths — the root cause, trap or failed approach, not a summary of what changed (git log has that).',
+    '  - A memory turned out outdated or wrong: update_memory / forget_memory — never store a near-duplicate.',
+    '  - Reading code you have not located yet, or that may hold secrets: search_workspace / read_workspace_file (they scrub keys).',
+    `If Lemma's tools are deferred, load them in ONE ToolSearch: select:${exports.PLAYBOOK_TOOLS.map((t) => `mcp__lemma__${t}`).join(',')}`,
+].join('\n');
+const BRIEFING_MEMORIES = 3;
+function sessionBriefing(payload, cwd, brain) {
+    return sessionRecall(payload, cwd, brain)?.text ?? '';
+}
+/** sessionBriefing with the memories it named, for reporting. */
+function sessionRecall(payload, cwd, brain) {
+    try {
+        const p = payload && typeof payload === 'object' ? payload : {};
+        const root = (0, TeamBrain_1.repoRoot)(cwd || p.cwd || process.cwd());
+        const b = brain ?? (0, TheBrainV2_1.getBrain)();
+        const projectId = (0, TheBrainV2_1.deriveProjectId)(root);
+        const lines = [];
+        let offered = [];
+        const { total, items } = b.list({ projectId, limit: 50 });
+        if (total === 0) {
+            lines.push(`🧠 Lemma is active in ${path_1.default.basename(root)}. The Brain has no memories for this project yet — store_memory once a fix is verified so the next session starts ahead.`);
+        }
+        else {
+            // Newest memories someone wrote on purpose; commit-log ingests are recalled per file instead.
+            const deliberate = items
+                .filter((i) => {
+                const entry = b.getEntry(i.id);
+                return !!entry && (0, TheBrainV2_1.entrySource)(entry) !== 'auto-git';
+            })
+                .slice(0, BRIEFING_MEMORIES);
+            lines.push(`🧠 Lemma is active in ${path_1.default.basename(root)}: the Brain holds ${total} ${plural(total, 'memory', 'memories')} for this project.`);
+            if (deliberate.length > 0) {
+                lines.push('Most recent decisions and fixes:');
+                const digest = (0, recallDigest_1.digestFileHits)(b, deliberate, BRIEFING_MEMORIES);
+                lines.push(...digest.lines);
+                offered = digest.ids;
+            }
+        }
+        lines.push(exports.LEMMA_PLAYBOOK);
+        return { text: lines.join('\n'), offered, trigger: 'session' };
+    }
+    catch {
+        return null;
     }
 }
 //# sourceMappingURL=HostRecall.js.map