@cachly-dev/mcp-server 0.10.120 → 0.10.122

package/dist/src/ambient-cli.d.ts

@@ -1,4 +1,4 @@
-import { type LessonCandidate, type GateOptions } from './ambient-recall.js';
+import { type RecallMemory, type LessonCandidate, type GateOptions } from './ambient-recall.js';
 /** The subset of the Claude Code hook payload we care about. */
 export interface HookPayload {
     hook_event_name?: string;
@@ -47,6 +47,19 @@ export declare function truncateToTokens(text: string, maxTokens: number): strin
  * Kept to one short line — its own token cost is counted as injected.
  */
 export declare const CREDIT_FOOTER = "(If this memory just saved you from a wrong path, record it: `npx @cachly-dev/mcp-server@latest ambient-credit <tokens-saved>`)";
+/**
+ * Der Beleg: WANN es gelernt wurde und WORAN.
+ *
+ * Ohne Beleg ist proaktive Erinnerung eine Behauptung — und Behauptungen einer
+ * Maschine prueft niemand nach, man glaubt sie oder ignoriert sie. Mit Datum
+ * und Datei wird daraus eine nachpruefbare Aussage: "am 24.07., in
+ * infra/backup.sh — ging damals schief". Genau das macht den Unterschied
+ * zwischen einem Hinweis, dem man folgt, und einem, den man wegklickt.
+ *
+ * Bewusst kurz gehalten (eine Zeile, hoechstens zwei Dateien): der Beleg wird
+ * bei JEDER Erinnerung mitgezahlt und darf das Token-Budget nicht sprengen.
+ */
+export declare function formatProvenance(l: LessonCandidate): string;
 /**
  * Render the gated lessons into a context block for the agent.
  *   • A single already-formatted briefing (multi-line summary — what smart_recall
@@ -63,6 +76,9 @@ export declare function formatContextBlock(lessons: LessonCandidate[], withCredi
  */
 export declare function buildHookOutput(event: string, additionalContext: string): string;
 export interface AmbientDeps {
+    /** Optionales Trigger-Gedaechtnis (Dedupe + Ruhe-Budget). Fehlt es, bleibt das Verhalten zustandslos. */
+    loadMemory?: () => RecallMemory | null | undefined;
+    saveMemory?: (m: RecallMemory) => void;
     /** Fetch candidate lessons for a query. Should already be scoped to the brain. */
     recall: (query: string, event: string) => Promise<LessonCandidate[]>;
     /** Overrides for the relevance gate. */

package/dist/src/ambient-cli.js

@@ -13,7 +13,7 @@
 //     a crashing hook can never block or corrupt the agent's turn.
 //   • Self-limited: recall runs under a hard timeout budget; a slow brain never
 //     stalls the user's prompt.
-import { isTrivialPrompt, selectInjectable, estimateTokens, } from './ambient-recall.js';
+import { decideRecall, commitInjection, emptyMemory, isTrivialPrompt, selectInjectable, estimateTokens, } from './ambient-recall.js';
 /** Parse the hook payload from stdin. Never throws — returns null on any problem. */
 export function parseHookPayload(raw) {
     const trimmed = (raw ?? '').trim();
@@ -101,6 +101,36 @@ export function truncateToTokens(text, maxTokens) {
  * Kept to one short line — its own token cost is counted as injected.
  */
 export const CREDIT_FOOTER = '(If this memory just saved you from a wrong path, record it: `npx @cachly-dev/mcp-server@latest ambient-credit <tokens-saved>`)';
+/**
+ * Der Beleg: WANN es gelernt wurde und WORAN.
+ *
+ * Ohne Beleg ist proaktive Erinnerung eine Behauptung — und Behauptungen einer
+ * Maschine prueft niemand nach, man glaubt sie oder ignoriert sie. Mit Datum
+ * und Datei wird daraus eine nachpruefbare Aussage: "am 24.07., in
+ * infra/backup.sh — ging damals schief". Genau das macht den Unterschied
+ * zwischen einem Hinweis, dem man folgt, und einem, den man wegklickt.
+ *
+ * Bewusst kurz gehalten (eine Zeile, hoechstens zwei Dateien): der Beleg wird
+ * bei JEDER Erinnerung mitgezahlt und darf das Token-Budget nicht sprengen.
+ */
+export function formatProvenance(l) {
+    const teile = [];
+    if (l.learnedAt) {
+        const d = new Date(l.learnedAt);
+        if (!Number.isNaN(d.getTime())) {
+            teile.push(`am ${String(d.getDate()).padStart(2, "0")}.${String(d.getMonth() + 1).padStart(2, "0")}.`);
+        }
+    }
+    if (l.files?.length) {
+        const f = l.files.slice(0, 2).join(", ");
+        teile.push(`in ${f}${l.files.length > 2 ? ` (+${l.files.length - 2})` : ""}`);
+    }
+    if (l.outcome === "failure")
+        teile.push("ging damals schief");
+    else if (l.outcome === "success")
+        teile.push("so ging es damals gut aus");
+    return teile.length ? `  ↳ ${teile.join(" · ")}` : "";
+}
 /**
  * Render the gated lessons into a context block for the agent.
  *   • A single already-formatted briefing (multi-line summary — what smart_recall
@@ -115,7 +145,12 @@ export function formatContextBlock(lessons, withCreditFooter = false) {
     const body = lessons.length === 1 && lessons[0].summary.includes('\n')
         ? lessons[0].summary.trim()
         : `🧠 Relevant memory from your cachly brain (auto-recalled):\n` +
-            lessons.map((l) => `- ${l.summary.trim()}`).join('\n');
+            lessons
+                .map((l) => {
+                const beleg = formatProvenance(l);
+                return `- ${l.summary.trim()}` + (beleg ? '\n' + beleg : '');
+            })
+                .join('\n');
     return withCreditFooter ? `${body}\n${CREDIT_FOOTER}` : body;
 }
 /**
@@ -181,7 +216,26 @@ export async function runAmbient(raw, deps) {
     // SessionStart/PreToolUse have no user prompt, so their trivial-skip is
     // meaningless; pass the recall query itself so the gate's non-trivial branch runs.
     const gateInput = event === 'UserPromptSubmit' ? (payload.prompt ?? query) : query;
-    const decision = selectInjectable(gateInput, candidates, deps.gate);
+    // Antizipation braucht Timing, nicht nur Relevanz: dieselbe Lektion in jedem
+    // zweiten Turn ist kein Hinweis mehr, sondern Laerm. `decideRecall` bringt
+    // Dedupe, Ruhe-Budget und einen risikoabhaengigen Ausloesemoment mit; ohne
+    // Gedaechtnis-Deps bleibt das Verhalten exakt wie bisher (reiner Gate).
+    const memory = deps.loadMemory?.() ?? emptyMemory();
+    const decision = deps.loadMemory
+        ? decideRecall(gateInput, candidates, memory, deps.gate)
+        : {
+            ...selectInjectable(gateInput, candidates, deps.gate),
+            risk: 'normal',
+            suppressedDuplicates: [],
+        };
+    if (deps.saveMemory) {
+        try {
+            deps.saveMemory(commitInjection(memory, decision));
+        }
+        catch {
+            // Gedaechtnis ist Komfort, kein Muss — ein Schreibfehler darf den Turn nie stoppen
+        }
+    }
     if (!decision.inject)
         return '';
     // Credit footer only where a recall can change a decision mid-flight.

package/dist/src/ambient-cli.js.map

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

package/dist/src/ambient-deps.d.ts

@@ -0,0 +1,26 @@
+import { type AmbientDeps } from './ambient-cli.js';
+import { type RecallMemory } from './ambient-recall.js';
+export interface BuildAmbientDepsOptions {
+    /** Brain instance to recall from. Missing/empty → recall is a no-op (never calls `smartRecall`). */
+    instanceId?: string;
+    /** The raw `smart_recall` call (already scoped to `instanceId` by the caller). */
+    smartRecall: (query: string) => Promise<string>;
+    /** Optional trigger memory (dedupe + quiet-budget). Stateless when omitted. */
+    loadMemory?: () => RecallMemory | null | undefined;
+    saveMemory?: (m: RecallMemory) => void;
+    /** Auto-backoff probe (§6.3 guardrail 3). */
+    backoff?: () => boolean | Promise<boolean>;
+    /** Called with the estimated injected tokens whenever context is emitted. */
+    onInject?: (tokens: number, event: string) => void;
+    /** Hard latency budget for the whole recall step (ms). Default 3000. */
+    timeoutMs?: number;
+}
+/**
+ * Builds the ONE production `AmbientDeps` used by the `ambient-recall` CLI
+ * entrypoint. This is the exact mapping that used to be inlined at the call
+ * site: a miss-detection heuristic, a token-truncated summary, and a
+ * content-derived candidate id — wrapped around whatever `smartRecall`
+ * implementation the caller passes in (production: `handleTool('smart_recall', ...)`;
+ * tests: a stub).
+ */
+export declare function buildAmbientDeps(opts: BuildAmbientDepsOptions): AmbientDeps;

package/dist/src/ambient-deps.js

@@ -0,0 +1,55 @@
+// Ambient Recall — the production `AmbientDeps` factory.
+//
+// ambient-cli.ts (`runAmbient`) is dependency-injected on purpose so it can be
+// unit-tested without a network. This module is the OTHER half of that seam:
+// the one place that turns a raw `smart_recall` string reply into the
+// `AmbientDeps.recall` candidates the gate understands — miss-detection,
+// truncation and content-based IDs (PR #241 regression: the id must come from
+// the summary, never a constant like 'ambient', or "same lesson twice" and
+// "different lesson" become indistinguishable in `RecallMemory`).
+//
+// Previously this mapping lived inline at the `ambient-recall` CLI call site
+// in index.ts. Moved here so the exact production wiring — not a hand-copied
+// approximation of it — is what the seam test (SDK-003) exercises across
+// multiple turns.
+import { truncateToTokens } from './ambient-cli.js';
+import { candidateIdFor } from './ambient-recall.js';
+/** A brain reply that carries no usable lesson — same heuristic as smart_recall's own callers. */
+const NO_LESSONS_RE = /No lessons found|no lessons|No matches found/i;
+/** Below this length a `smart_recall` reply is boilerplate, not a real lesson. */
+const MIN_LESSON_CHARS = 80;
+/** Hard cap on how much of one recalled lesson may be injected (§6.2 budget). */
+const MAX_LESSON_TOKENS = 500;
+/**
+ * Builds the ONE production `AmbientDeps` used by the `ambient-recall` CLI
+ * entrypoint. This is the exact mapping that used to be inlined at the call
+ * site: a miss-detection heuristic, a token-truncated summary, and a
+ * content-derived candidate id — wrapped around whatever `smartRecall`
+ * implementation the caller passes in (production: `handleTool('smart_recall', ...)`;
+ * tests: a stub).
+ */
+export function buildAmbientDeps(opts) {
+    const { instanceId, smartRecall, loadMemory, saveMemory, backoff, onInject, timeoutMs } = opts;
+    return {
+        timeoutMs: timeoutMs ?? 3000, // §6.3 guardrail 4: never stall the prompt on a slow brain
+        // Ambient injection budget: one relevance-ranked briefing, hard-capped.
+        // smart_recall already returns its hits best-first, so the capped head is
+        // the high-signal part. Per-lesson structured candidates are a future slice.
+        gate: { topK: 1, maxTokens: MAX_LESSON_TOKENS },
+        loadMemory,
+        saveMemory,
+        backoff,
+        onInject,
+        recall: async (query) => {
+            if (!instanceId)
+                return [];
+            const text = String((await smartRecall(query)) ?? '');
+            const miss = text.length < MIN_LESSON_CHARS || NO_LESSONS_RE.test(text);
+            if (miss)
+                return [];
+            const summary = truncateToTokens(text, MAX_LESSON_TOKENS);
+            return [{ id: candidateIdFor(summary), summary, confidence: 0.9, score: 0.9 }];
+        },
+    };
+}
+//# sourceMappingURL=ambient-deps.js.map

package/dist/src/ambient-deps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ambient-deps.js","sourceRoot":"","sources":["../../src/ambient-deps.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,EAAE;AACF,+EAA+E;AAC/E,6EAA6E;AAC7E,sEAAsE;AACtE,yEAAyE;AACzE,8EAA8E;AAC9E,2EAA2E;AAC3E,kEAAkE;AAClE,EAAE;AACF,6EAA6E;AAC7E,6EAA6E;AAC7E,yEAAyE;AACzE,kBAAkB;AAElB,OAAO,EAAE,gBAAgB,EAAoB,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,cAAc,EAAqB,MAAM,qBAAqB,CAAC;AAExE,kGAAkG;AAClG,MAAM,aAAa,GAAG,+CAA+C,CAAC;AAEtE,kFAAkF;AAClF,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAE5B,iFAAiF;AACjF,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAkB9B;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAA6B;IAC5D,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;IAC/F,OAAO;QACL,SAAS,EAAE,SAAS,IAAI,IAAI,EAAE,2DAA2D;QACzF,wEAAwE;QACxE,0EAA0E;QAC1E,6EAA6E;QAC7E,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,iBAAiB,EAAE;QAC/C,UAAU;QACV,UAAU;QACV,OAAO;QACP,QAAQ;QACR,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACtB,IAAI,CAAC,UAAU;gBAAE,OAAO,EAAE,CAAC;YAC3B,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,MAAM,WAAW,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACtD,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,GAAG,gBAAgB,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxE,IAAI,IAAI;gBAAE,OAAO,EAAE,CAAC;YACpB,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;YAC1D,OAAO,CAAC,EAAE,EAAE,EAAE,cAAc,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QACjF,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/src/ambient-memory.d.ts

@@ -0,0 +1,12 @@
+import { type RecallMemory } from './ambient-recall.js';
+/**
+ * Loads the persisted {@link RecallMemory} from `<dir>/ambient-memory.json`.
+ * Falls back to {@link emptyMemory} when the file is missing, corrupt, larger
+ * than 64KB, or structurally invalid. Never throws.
+ */
+export declare function loadAmbientMemory(dir?: string): RecallMemory;
+/**
+ * Persists `memory` to `<dir>/ambient-memory.json` via write-then-rename so a
+ * crash mid-write never corrupts the file for the next read. Never throws.
+ */
+export declare function saveAmbientMemory(memory: RecallMemory, dir?: string): void;

package/dist/src/ambient-memory.js

@@ -0,0 +1,67 @@
+import { mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { emptyMemory } from './ambient-recall.js';
+const MEMORY_FILE_NAME = 'ambient-memory.json';
+const MAX_MEMORY_BYTES = 64 * 1024;
+function defaultAmbientMemoryDir() {
+    const home = process.env.HOME ?? process.env.USERPROFILE ?? '.';
+    return resolve(home, '.cachly');
+}
+function isFiniteNumberRecord(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return false;
+    return Object.values(value).every((n) => typeof n === 'number' && Number.isFinite(n));
+}
+function isValidMemory(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const m = value;
+    if (typeof m.turn !== 'number' || !Number.isFinite(m.turn))
+        return false;
+    if (!isFiniteNumberRecord(m.lastInjectedTurn))
+        return false;
+    if (!Array.isArray(m.injectionTurns))
+        return false;
+    if (!m.injectionTurns.every((n) => typeof n === 'number' && Number.isFinite(n)))
+        return false;
+    return true;
+}
+/**
+ * Loads the persisted {@link RecallMemory} from `<dir>/ambient-memory.json`.
+ * Falls back to {@link emptyMemory} when the file is missing, corrupt, larger
+ * than 64KB, or structurally invalid. Never throws.
+ */
+export function loadAmbientMemory(dir = defaultAmbientMemoryDir()) {
+    try {
+        const raw = readFileSync(resolve(dir, MEMORY_FILE_NAME), 'utf-8');
+        if (Buffer.byteLength(raw, 'utf-8') > MAX_MEMORY_BYTES)
+            return emptyMemory();
+        const parsed = JSON.parse(raw);
+        if (!isValidMemory(parsed))
+            return emptyMemory();
+        return {
+            turn: parsed.turn,
+            lastInjectedTurn: { ...parsed.lastInjectedTurn },
+            injectionTurns: [...parsed.injectionTurns],
+        };
+    }
+    catch {
+        return emptyMemory();
+    }
+}
+/**
+ * Persists `memory` to `<dir>/ambient-memory.json` via write-then-rename so a
+ * crash mid-write never corrupts the file for the next read. Never throws.
+ */
+export function saveAmbientMemory(memory, dir = defaultAmbientMemoryDir()) {
+    try {
+        mkdirSync(dir, { recursive: true });
+        const path = resolve(dir, MEMORY_FILE_NAME);
+        const tmp = `${path}.tmp`;
+        writeFileSync(tmp, JSON.stringify(memory), 'utf-8');
+        renameSync(tmp, path);
+    }
+    catch {
+    }
+}
+//# sourceMappingURL=ambient-memory.js.map

package/dist/src/ambient-memory.js.map

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

package/dist/src/ambient-recall.d.ts

@@ -7,6 +7,12 @@ export interface LessonCandidate {
     /** Semantic similarity of the lesson to the current prompt, [0,1]. */
     score: number;
     severity?: 'critical' | 'major' | 'minor';
+    /** Wann die Lektion gelernt wurde (ISO) — Grundlage des Belegs. */
+    learnedAt?: string;
+    /** Dateien, an denen sie entstand — der konkreteste Beleg. */
+    files?: string[];
+    /** Wie es damals ausging. */
+    outcome?: "success" | "failure" | "partial";
 }
 export interface GateOptions {
     /** Minimum brain confidence to be eligible. */
@@ -19,6 +25,12 @@ export interface GateOptions {
     maxTokens: number;
 }
 export declare const DEFAULT_GATE: GateOptions;
+/**
+ * Derives a content-based candidate ID from a summary string. Enables
+ * ID-based deduplication to suppress "the same advice" while allowing
+ * "different advice" through. See PR #241.
+ */
+export declare function candidateIdFor(summary: string): string;
 /** Rough token estimate (~4 chars/token) — good enough for a per-turn budget. */
 export declare function estimateTokens(text: string): number;
 /**
@@ -57,3 +69,59 @@ export declare function netBalance(records: TurnRecord[]): NetBalance;
  * there is enough signal (>= minTurns) so early noise doesn't trip it.
  */
 export declare function shouldBackoff(records: TurnRecord[], windowN?: number, minTurns?: number): boolean;
+/** Wie riskant ist der Moment — bestimmt, wie eifrig erinnert werden darf. */
+export type PromptRisk = 'high' | 'normal' | 'low';
+/**
+ * Risikoeinschätzung des Auslösemoments. Sie verschiebt die Schwellen, statt
+ * eine zweite, konkurrierende Entscheidung zu treffen — eine Stellschraube
+ * weniger, und der Gate bleibt die einzige Wahrheit über Relevanz.
+ */
+export declare function promptRisk(prompt: string): PromptRisk;
+/** Schwellen-Anpassung je Risiko (klein gehalten und bewusst begründet). */
+export declare function gateForRisk(risk: PromptRisk, base?: GateOptions): GateOptions;
+export interface TimingOptions {
+    /** Dieselbe Lektion frühestens nach so vielen Turns erneut. */
+    repeatCooldownTurns: number;
+    /** Höchstzahl Einwürfe im gleitenden Fenster. */
+    maxInjectionsPerWindow: number;
+    /** Größe des gleitenden Fensters in Turns. */
+    windowTurns: number;
+    /** Mindestruhe unmittelbar nach einem Einwurf (in Turns). */
+    minSilenceTurns: number;
+}
+export declare const DEFAULT_TIMING: TimingOptions;
+/** Gedächtnis über die letzten Einwürfe — vom Aufrufer gehalten und übergeben. */
+export interface RecallMemory {
+    /** Aktueller Turn-Zähler (monoton steigend). */
+    turn: number;
+    /** Lektions-ID → Turn des letzten Einwurfs. */
+    lastInjectedTurn: Record<string, number>;
+    /** Turns, in denen etwas eingeworfen wurde (aufsteigend). */
+    injectionTurns: number[];
+}
+export declare function emptyMemory(): RecallMemory;
+export type TimingReason = 'quiet-budget' | 'silence-window' | 'all-duplicates';
+export interface RecallDecision extends GateDecision {
+    risk: PromptRisk;
+    /** Kandidaten, die nur wegen der Abklingzeit entfielen (Diagnose/Telemetrie). */
+    suppressedDuplicates: string[];
+    timingReason?: TimingReason;
+}
+/**
+ * Die vollständige Entscheidung: Relevanz (Gate) UND Zeitpunkt (Timing).
+ *
+ * Reihenfolge ist Absicht: erst die billigen Ausschlüsse (Ruhe, Budget), dann
+ * Dedupe, erst zuletzt der teure Relevanz-Gate — so kostet ein unterdrückter
+ * Turn praktisch nichts.
+ *
+ * Die Funktion ist seiteneffektfrei; `commitInjection` schreibt das Gedächtnis
+ * fort, damit Aufrufer selbst entscheiden, ob ein Vorschlag wirklich gezeigt
+ * wurde (z. B. bei abgebrochenem Turn).
+ */
+export declare function decideRecall(prompt: string, candidates: LessonCandidate[], memory: RecallMemory, gateOverrides?: Partial<GateOptions>, timingOverrides?: Partial<TimingOptions>): RecallDecision;
+/**
+ * Schreibt das Gedächtnis nach einem TATSÄCHLICH gezeigten Einwurf fort.
+ * Der Turn-Zähler wird immer erhöht — auch ohne Einwurf, sonst laufen
+ * Abklingzeit und Fenster nicht weiter.
+ */
+export declare function commitInjection(memory: RecallMemory, decision: RecallDecision, timingOverrides?: Partial<TimingOptions>): RecallMemory;

package/dist/src/ambient-recall.js

@@ -9,6 +9,7 @@
 //
 // This module is pure and dependency-free so it is exhaustively unit-tested; the
 // hook scripts + telemetry layer build on top of it.
+import { createHash } from 'node:crypto';
 // Deliberately conservative defaults: it is far cheaper to skip a marginal
 // lesson than to erode the "−60% tokens" credibility by injecting noise.
 export const DEFAULT_GATE = {
@@ -17,6 +18,15 @@ export const DEFAULT_GATE = {
     topK: 3,
     maxTokens: 240,
 };
+/**
+ * Derives a content-based candidate ID from a summary string. Enables
+ * ID-based deduplication to suppress "the same advice" while allowing
+ * "different advice" through. See PR #241.
+ */
+export function candidateIdFor(summary) {
+    const hash = createHash('sha256').update(summary).digest('hex');
+    return hash.slice(0, 16);
+}
 /** Rough token estimate (~4 chars/token) — good enough for a per-turn budget. */
 export function estimateTokens(text) {
     return Math.ceil(text.trim().length / 4);
@@ -93,4 +103,119 @@ export function shouldBackoff(records, windowN = 20, minTurns = 8) {
         return false;
     return netBalance(recent).net < 0;
 }
+// Schritte, die man nicht zurücknehmen kann: hier ist eine verpasste Lektion
+// teuer, ein überflüssiger Hinweis dagegen billig.
+const RISKY_RE = /\b(deploy\w*|migrat\w*|rollback|revert|drop\s+(table|database|schema)|truncate|rm\s+-rf|force[- ]push|prune|restore|rotat\w*|secret\w*|credential\w*|production|prod|live|kunde\w*|customer\w*|delete|loesch\w*|lösch\w*)\b/i;
+// Reine Bestätigungen/Fortsetzungen: hier beginnt keine neue Arbeit.
+const CONTINUATION_RE = /^(ok(ay)?|ja|nein|weiter|passt|danke|thanks|go|los|mach|jup|yes|no|sure|next)\b[\s.!]*$/i;
+/**
+ * Risikoeinschätzung des Auslösemoments. Sie verschiebt die Schwellen, statt
+ * eine zweite, konkurrierende Entscheidung zu treffen — eine Stellschraube
+ * weniger, und der Gate bleibt die einzige Wahrheit über Relevanz.
+ */
+export function promptRisk(prompt) {
+    const p = prompt.trim();
+    if (CONTINUATION_RE.test(p))
+        return 'low';
+    if (RISKY_RE.test(p))
+        return 'high';
+    return 'normal';
+}
+/** Schwellen-Anpassung je Risiko (klein gehalten und bewusst begründet). */
+export function gateForRisk(risk, base = DEFAULT_GATE) {
+    if (risk === 'high') {
+        // Vor irreversiblen Schritten darf eine etwas schwächere Übereinstimmung
+        // reichen — die vermiedene Katastrophe ist jeden Token wert.
+        return { ...base, minScore: Math.max(0, base.minScore - 0.07), topK: base.topK, maxTokens: base.maxTokens + 120 };
+    }
+    if (risk === 'low') {
+        // Im Geplauder muss es sehr deutlich sein, sonst lieber schweigen.
+        return { ...base, minScore: Math.min(1, base.minScore + 0.1), topK: 1, maxTokens: Math.min(base.maxTokens, 120) };
+    }
+    return { ...base };
+}
+// Ein Einwurf pro ~3 Turns im Schnitt: oft genug, um zu helfen, selten genug,
+// dass er auffällt, wenn er kommt.
+export const DEFAULT_TIMING = {
+    repeatCooldownTurns: 12,
+    maxInjectionsPerWindow: 3,
+    windowTurns: 10,
+    minSilenceTurns: 1,
+};
+export function emptyMemory() {
+    return { turn: 0, lastInjectedTurn: {}, injectionTurns: [] };
+}
+/**
+ * Die vollständige Entscheidung: Relevanz (Gate) UND Zeitpunkt (Timing).
+ *
+ * Reihenfolge ist Absicht: erst die billigen Ausschlüsse (Ruhe, Budget), dann
+ * Dedupe, erst zuletzt der teure Relevanz-Gate — so kostet ein unterdrückter
+ * Turn praktisch nichts.
+ *
+ * Die Funktion ist seiteneffektfrei; `commitInjection` schreibt das Gedächtnis
+ * fort, damit Aufrufer selbst entscheiden, ob ein Vorschlag wirklich gezeigt
+ * wurde (z. B. bei abgebrochenem Turn).
+ */
+export function decideRecall(prompt, candidates, memory, gateOverrides = {}, timingOverrides = {}) {
+    const t = { ...DEFAULT_TIMING, ...timingOverrides };
+    const risk = promptRisk(prompt);
+    const none = (reason, timingReason) => ({
+        inject: false, reason, selected: [], tokens: 0, risk,
+        suppressedDuplicates: [], timingReason,
+    });
+    if (isTrivialPrompt(prompt))
+        return none('trivial-skip');
+    // Mindestruhe nach dem letzten Einwurf.
+    const last = memory.injectionTurns[memory.injectionTurns.length - 1];
+    if (last !== undefined && memory.turn - last <= t.minSilenceTurns) {
+        return none('no-candidate-passed-gate', 'silence-window');
+    }
+    // Ruhe-Budget im gleitenden Fenster.
+    const inWindow = memory.injectionTurns.filter((n) => memory.turn - n < t.windowTurns).length;
+    if (inWindow >= t.maxInjectionsPerWindow) {
+        return none('no-candidate-passed-gate', 'quiet-budget');
+    }
+    // Dedupe: was gerade erst gesagt wurde, wird nicht wiederholt.
+    const suppressedDuplicates = [];
+    const fresh = candidates.filter((c) => {
+        const seen = memory.lastInjectedTurn[c.id];
+        if (seen !== undefined && memory.turn - seen < t.repeatCooldownTurns) {
+            suppressedDuplicates.push(c.id);
+            return false;
+        }
+        return true;
+    });
+    if (candidates.length > 0 && fresh.length === 0) {
+        return { ...none('no-candidate-passed-gate', 'all-duplicates'), suppressedDuplicates };
+    }
+    const gate = selectInjectable(prompt, fresh, { ...gateForRisk(risk), ...gateOverrides });
+    return { ...gate, risk, suppressedDuplicates };
+}
+/**
+ * Schreibt das Gedächtnis nach einem TATSÄCHLICH gezeigten Einwurf fort.
+ * Der Turn-Zähler wird immer erhöht — auch ohne Einwurf, sonst laufen
+ * Abklingzeit und Fenster nicht weiter.
+ */
+export function commitInjection(memory, decision, timingOverrides = {}) {
+    const t = { ...DEFAULT_TIMING, ...timingOverrides };
+    const next = {
+        turn: memory.turn + 1,
+        lastInjectedTurn: { ...memory.lastInjectedTurn },
+        injectionTurns: [...memory.injectionTurns],
+    };
+    if (decision.inject) {
+        for (const c of decision.selected)
+            next.lastInjectedTurn[c.id] = memory.turn;
+        next.injectionTurns.push(memory.turn);
+    }
+    // Nach Ablauf der Fenster sind Eintraege bedeutungslos — sonst waechst das
+    // Gedaechtnis in langen Sitzungen unbegrenzt mit.
+    const horizon = memory.turn - Math.max(t.windowTurns, t.repeatCooldownTurns);
+    next.injectionTurns = next.injectionTurns.filter((n) => n >= horizon);
+    for (const [id, turn] of Object.entries(next.lastInjectedTurn)) {
+        if (turn < horizon)
+            delete next.lastInjectedTurn[id];
+    }
+    return next;
+}
 //# sourceMappingURL=ambient-recall.js.map

package/dist/src/ambient-recall.js.map

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

package/dist/src/confidence.js

@@ -4,6 +4,18 @@ export const CONFIDENCE_WARN_DAYS = Number(process.env.CACHLY_CONFIDENCE_WARN_DA
 export const CONFIDENCE_STALE_DAYS = Number(process.env.CACHLY_CONFIDENCE_STALE_DAYS ?? 10);
 export const CONFIDENCE_WARN_VALUE = 0.7;
 export const CONFIDENCE_STALE_VALUE = 0.5;
+// ── One of THREE deliberately-different age/decay curves. Do NOT unify them. ──
+// This one (SHARP: 0.7@5d, 0.5@10d) is a user-facing *staleness warning* — it
+// drives the recall_best_solution freshness badge and brain_predict, where the
+// point is to shout "verify before applying" once a lesson is old.
+//   • Ranking uses a SEPARATE, gentle curve — search.ts `recencyBoost`
+//     (0.5^(age/7)+0.5, range [0.5,1.5]). It is bench-tuned. Feeding THIS sharp
+//     curve into the recall rerank regressed every Cachly-Bench floor (home P@1
+//     92→77%) and was reverted — see PR #228. Relevant lessons are often days
+//     /weeks old; penalising age hard in ranking buries the right answer.
+//   • The knowledge_decay *report* uses a THIRD, points-based curve
+//     (advanced.ts) that also folds in recall_count + outcome.
+// Three purposes, three curves — that divergence is intentional, not a bug.
 /** Calculate current confidence for a lesson based on how long since last verified. */
 export function calculateConfidence(lesson) {
     const ref = lesson.verified_at ?? lesson.ts;

package/dist/src/confidence.js.map

@@ -1 +1 @@
-{"version":3,"file":"confidence.js","sourceRoot":"","sources":["../../src/confidence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,iFAAiF;AACjF,MAAM,CAAC,MAAM,oBAAoB,GAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,2BAA2B,IAAK,CAAC,CAAC,CAAC;AAC3F,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,4BAA4B,IAAI,EAAE,CAAC,CAAC;AAC5F,MAAM,CAAC,MAAM,qBAAqB,GAAI,GAAG,CAAC;AAC1C,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAE1C,uFAAuF;AACvF,MAAM,UAAU,mBAAmB,CAAC,MAAmE;IACrG,MAAM,GAAG,GAAG,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,EAAE,CAAC;IAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC;IACnD,MAAM,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAC;IACjC,IAAI,OAAO,IAAI,qBAAqB;QAAE,OAAO,sBAAsB,CAAC;IACpE,IAAI,OAAO,IAAI,oBAAoB;QAAG,OAAO,qBAAqB,CAAC;IACnE,OAAO,GAAG,GAAG,CAAC,OAAO,GAAG,oBAAoB,CAAC,GAAG,CAAC,GAAG,GAAG,qBAAqB,CAAC,CAAC;AAChF,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,eAAe,CAAC,UAAkB,EAAE,OAAe;IACjE,IAAI,UAAU,IAAI,GAAG;QAAE,OAAO,GAAG,CAAC;IAClC,IAAI,UAAU,IAAI,GAAG;QAAE,OAAO,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,qBAAqB,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,6BAA6B,CAAC;IACxI,OAAO,aAAa,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,qBAAqB,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,uBAAuB,CAAC;AACnH,CAAC;AAED,gEAAgE;AAChE,MAAM,CAAC,MAAM,oBAAoB,GAAyD;IACxF,QAAQ,EAAG,EAAE,QAAQ,EAAE,CAAC,UAAU,CAAC,EAAiB,IAAI,EAAE,2BAA2B,EAAE;IACvF,MAAM,EAAK,EAAE,QAAQ,EAAE,CAAC,UAAU,CAAC,EAAiB,IAAI,EAAE,yBAAyB,EAAE;IACrF,OAAO,EAAI,EAAE,QAAQ,EAAE,CAAC,UAAU,CAAC,EAAiB,IAAI,EAAE,oDAAoD,EAAE;IAChH,SAAS,EAAE,EAAE,QAAQ,EAAE,EAAE,EAA2B,IAAI,EAAE,wEAAwE,EAAE;IACpI,QAAQ,EAAG,EAAE,QAAQ,EAAE,EAAE,EAA2B,IAAI,EAAE,gDAAgD,EAAE;CAC7G,CAAC;AAEF,0FAA0F;AAC1F,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACnE,CAAC"}
+{"version":3,"file":"confidence.js","sourceRoot":"","sources":["../../src/confidence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,iFAAiF;AACjF,MAAM,CAAC,MAAM,oBAAoB,GAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,2BAA2B,IAAK,CAAC,CAAC,CAAC;AAC3F,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,4BAA4B,IAAI,EAAE,CAAC,CAAC;AAC5F,MAAM,CAAC,MAAM,qBAAqB,GAAI,GAAG,CAAC;AAC1C,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAE1C,iFAAiF;AACjF,8EAA8E;AAC9E,+EAA+E;AAC/E,mEAAmE;AACnE,uEAAuE;AACvE,gFAAgF;AAChF,gFAAgF;AAChF,8EAA8E;AAC9E,0EAA0E;AAC1E,oEAAoE;AACpE,+DAA+D;AAC/D,4EAA4E;AAC5E,uFAAuF;AACvF,MAAM,UAAU,mBAAmB,CAAC,MAAmE;IACrG,MAAM,GAAG,GAAG,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,EAAE,CAAC;IAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC;IACnD,MAAM,OAAO,GAAG,KAAK,GAAG,QAAQ,CAAC;IACjC,IAAI,OAAO,IAAI,qBAAqB;QAAE,OAAO,sBAAsB,CAAC;IACpE,IAAI,OAAO,IAAI,oBAAoB;QAAG,OAAO,qBAAqB,CAAC;IACnE,OAAO,GAAG,GAAG,CAAC,OAAO,GAAG,oBAAoB,CAAC,GAAG,CAAC,GAAG,GAAG,qBAAqB,CAAC,CAAC;AAChF,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,eAAe,CAAC,UAAkB,EAAE,OAAe;IACjE,IAAI,UAAU,IAAI,GAAG;QAAE,OAAO,GAAG,CAAC;IAClC,IAAI,UAAU,IAAI,GAAG;QAAE,OAAO,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,qBAAqB,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,6BAA6B,CAAC;IACxI,OAAO,aAAa,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,qBAAqB,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,uBAAuB,CAAC;AACnH,CAAC;AAED,gEAAgE;AAChE,MAAM,CAAC,MAAM,oBAAoB,GAAyD;IACxF,QAAQ,EAAG,EAAE,QAAQ,EAAE,CAAC,UAAU,CAAC,EAAiB,IAAI,EAAE,2BAA2B,EAAE;IACvF,MAAM,EAAK,EAAE,QAAQ,EAAE,CAAC,UAAU,CAAC,EAAiB,IAAI,EAAE,yBAAyB,EAAE;IACrF,OAAO,EAAI,EAAE,QAAQ,EAAE,CAAC,UAAU,CAAC,EAAiB,IAAI,EAAE,oDAAoD,EAAE;IAChH,SAAS,EAAE,EAAE,QAAQ,EAAE,EAAE,EAA2B,IAAI,EAAE,wEAAwE,EAAE;IACpI,QAAQ,EAAG,EAAE,QAAQ,EAAE,EAAE,EAA2B,IAAI,EAAE,gDAAgD,EAAE;CAC7G,CAAC;AAEF,0FAA0F;AAC1F,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACnE,CAAC"}

package/dist/src/handlers/advanced.js

@@ -429,6 +429,13 @@ export async function handleAdvancedTool(name, args, getConnection, _apiFetch) {
                         continue;
                     const age_days = Math.floor(ageMs / 86400000);
                     const recalls = l.recall_count ?? 0;
+                    // The THIRD deliberately-different decay curve (see confidence.ts /
+                    // search.ts recencyBoost). This one is a *report-only* health score on
+                    // a 0–100 scale that also folds in recall_count and outcome — it is not
+                    // a ranking signal and not the freshness badge. Kept separate on
+                    // purpose; do not "unify" the three (a single curve regresses either
+                    // the Cachly-Bench ranking floors — see PR #228 — or these reports).
+                    //
                     // Confidence formula:
                     // base = 100 → decays by 1pt/day after 7 days, floored at 5
                     // boost: +5 per recall, capped at +50