@danielmarbach/mnemonic-mcp 0.27.2 → 0.29.0

package/build/tools/recall-helpers.js

@@ -0,0 +1,217 @@
+import { getEffectiveMetadata } from "../role-suggestions.js";
+import { computeRecallMetadataBoost, shouldApplyTemporalFiltering, computeTemporalRecencyBoost, isWithinTemporalFilterWindow } from "../recall.js";
+import { getOrBuildProjection } from "../projections.js";
+import { attempt } from "../error-utils.js";
+import { getSessionCachedProjectionTokens, setSessionCachedProjectionTokens, getOrBuildVaultNoteList } from "../cache.js";
+import { tokenize, prepareTfIdfCorpusFromTokenizedDocuments, rankDocumentsByTfIdf, LEXICAL_RESCUE_CANDIDATE_LIMIT, LEXICAL_RESCUE_THRESHOLD, LEXICAL_RESCUE_RESULT_LIMIT } from "../lexical.js";
+// ── Recall candidate context ──────────────────────────────────────────────────
+export function buildRecallCandidateContext(note) {
+    const metadata = getEffectiveMetadata(note);
+    const relatedCount = note.relatedTo?.length ?? 0;
+    return {
+        metadata,
+        metadataBoost: computeRecallMetadataBoost(metadata),
+        lifecycle: note.lifecycle,
+        relatedCount,
+        connectionDiversity: new Set((note.relatedTo ?? []).map((rel) => rel.type)).size,
+        structureScore: Math.min(0.04, [
+            note.content.includes("## ") ? 0.02 : 0,
+            note.content.includes("- ") || note.content.includes("1. ") ? 0.01 : 0,
+            note.content.length >= 400 ? 0.01 : 0,
+        ].reduce((sum, value) => sum + value, 0)),
+    };
+}
+// ── Lexical rescue ────────────────────────────────────────────────────────────
+export const PROJECT_SCOPE_BOOST = 0.03;
+export async function collectLexicalRescueCandidates(vaults, query, temporalQueryHint, project, scope, tags, lifecycle, existingIds) {
+    const projectId = project?.id;
+    const applyTemporalFilter = shouldApplyTemporalFiltering(temporalQueryHint);
+    const temporalFilterWindowDays = applyTemporalFilter ? temporalQueryHint?.filterWindowDays : undefined;
+    const existingIdSet = new Set(existingIds.map((c) => c.id));
+    const rescuePool = [];
+    for (const vault of vaults) {
+        const notes = await vault.storage.listNotes().catch(() => []);
+        for (const note of notes) {
+            if (existingIdSet.has(note.id))
+                continue;
+            if (tags && tags.length > 0) {
+                const noteTags = new Set(note.tags);
+                if (!tags.every((t) => noteTags.has(t)))
+                    continue;
+            }
+            if (lifecycle && note.lifecycle !== lifecycle)
+                continue;
+            const isProjectNote = note.project !== undefined;
+            const isCurrentProject = project && note.project === project.id;
+            if (scope === "project" && !isCurrentProject)
+                continue;
+            if (scope === "global" && isProjectNote)
+                continue;
+            if (applyTemporalFilter
+                && temporalFilterWindowDays !== undefined
+                && !isWithinTemporalFilterWindow(note.updatedAt, temporalFilterWindowDays)) {
+                continue;
+            }
+            const projection = await getOrBuildProjection(vault.storage, note).catch(() => undefined);
+            if (!projection)
+                continue;
+            rescuePool.push({
+                id: note.id,
+                vault,
+                isCurrentProject: Boolean(isCurrentProject),
+                updatedAt: note.updatedAt,
+                projectionText: projection.projectionText,
+                projectionTokens: projectId
+                    ? getSessionCachedProjectionTokens(projectId, vault.storage.vaultPath, note.id, projection.projectionText) ?? tokenize(projection.projectionText)
+                    : tokenize(projection.projectionText),
+                context: buildRecallCandidateContext(note),
+            });
+            if (projectId) {
+                setSessionCachedProjectionTokens(projectId, vault.storage.vaultPath, note.id, projection.projectionText, rescuePool[rescuePool.length - 1].projectionTokens);
+            }
+        }
+    }
+    const rescueDocuments = rescuePool.map((candidate) => ({
+        id: candidate.id,
+        text: candidate.projectionText,
+    }));
+    const preparedRescueCorpus = prepareTfIdfCorpusFromTokenizedDocuments(rescuePool.map((candidate) => ({
+        id: candidate.id,
+        text: candidate.projectionText,
+        tokens: candidate.projectionTokens,
+    })));
+    const rankedRescueIds = new Map(rankDocumentsByTfIdf(query, rescueDocuments, LEXICAL_RESCUE_CANDIDATE_LIMIT, preparedRescueCorpus).map((candidate) => [candidate.id, candidate.score]));
+    const candidates = [];
+    for (const candidate of rescuePool) {
+        const tfIdfScore = rankedRescueIds.get(candidate.id);
+        if (tfIdfScore === undefined || tfIdfScore <= 0)
+            continue;
+        const lexicalScore = tfIdfScore;
+        if (lexicalScore < LEXICAL_RESCUE_THRESHOLD)
+            continue;
+        const temporalBoost = temporalQueryHint
+            ? computeTemporalRecencyBoost(candidate.updatedAt, temporalQueryHint)
+            : 0;
+        const boost = (candidate.isCurrentProject ? PROJECT_SCOPE_BOOST : 0) + candidate.context.metadataBoost + temporalBoost;
+        candidates.push({
+            id: candidate.id,
+            score: lexicalScore,
+            semanticScoreForPromotion: 0,
+            boosted: boost,
+            vault: candidate.vault,
+            isCurrentProject: candidate.isCurrentProject,
+            lexicalScore,
+            lifecycle: candidate.context.lifecycle,
+            relatedCount: candidate.context.relatedCount,
+            connectionDiversity: candidate.context.connectionDiversity,
+            structureScore: candidate.context.structureScore,
+            metadata: candidate.context.metadata,
+        });
+    }
+    return candidates
+        .sort((a, b) => (b.lexicalScore ?? 0) - (a.lexicalScore ?? 0))
+        .slice(0, LEXICAL_RESCUE_RESULT_LIMIT);
+}
+export function tokenizeTagDiscoveryText(value) {
+    return value
+        .toLowerCase()
+        .split(/[^a-z0-9]+/)
+        .filter(Boolean);
+}
+export function countTokenOverlap(tokens, other) {
+    let matches = 0;
+    for (const token of other) {
+        if (tokens.has(token)) {
+            matches++;
+        }
+    }
+    return matches;
+}
+export function escapeRegex(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+export function hasExactTagContextMatch(tag, values) {
+    const normalizedTag = tag.toLowerCase();
+    const pattern = new RegExp(`(^|[^a-z0-9_-])${escapeRegex(normalizedTag)}([^a-z0-9_-]|$)`);
+    return values.some(value => value ? pattern.test(value.toLowerCase()) : false);
+}
+export async function identifyHighPriorityAnchors(vaults, projectId) {
+    const anchorIds = new Set();
+    const anchorLookup = new Map();
+    for (const vault of vaults) {
+        const vaultResult = await attempt("recall:anchor-scan", async () => {
+            const notes = await getOrBuildVaultNoteList(projectId, vault);
+            if (!notes)
+                return undefined;
+            const supersededTargets = new Set();
+            for (const note of notes) {
+                if (note.project !== projectId)
+                    continue;
+                for (const rel of note.relatedTo ?? []) {
+                    if (rel.type === "supersedes") {
+                        supersededTargets.add(rel.id);
+                    }
+                }
+            }
+            for (const note of notes) {
+                if (note.project !== projectId)
+                    continue;
+                if ((note.alwaysLoad === true || note.role === "summary")
+                    && !supersededTargets.has(note.id)) {
+                    anchorIds.add(note.id);
+                    anchorLookup.set(note.id, note.title);
+                }
+            }
+            return undefined;
+        });
+        if (!vaultResult.ok)
+            continue;
+    }
+    return { anchorIds, anchorLookup };
+}
+export async function computeRecallDiversity(results) {
+    const result = await attempt("recall:diversity", () => {
+        const allTags = new Set();
+        const roleCounts = new Map();
+        const lifecycleCounts = new Map();
+        for (const r of results) {
+            for (const tag of r.tags) {
+                allTags.add(tag);
+            }
+            if (r.role) {
+                roleCounts.set(r.role, (roleCounts.get(r.role) ?? 0) + 1);
+            }
+            lifecycleCounts.set(r.lifecycle, (lifecycleCounts.get(r.lifecycle) ?? 0) + 1);
+        }
+        return {
+            themeCount: allTags.size,
+            roleMix: Object.fromEntries(roleCounts),
+            lifecycleMix: Object.fromEntries(lifecycleCounts),
+        };
+    });
+    if (!result.ok)
+        return undefined;
+    return result.value;
+}
+export async function computeRecallRetrievalCoverage(resultIds, anchorIds, anchorLookup, maxMissing = 5) {
+    const result = await attempt("recall:coverage", () => {
+        const resultIdSet = new Set(resultIds);
+        const anchorsInResults = [...anchorIds].filter((id) => resultIdSet.has(id)).length;
+        const highPriorityAnchorsTotal = anchorIds.size;
+        const fraction = highPriorityAnchorsTotal > 0 ? anchorsInResults / highPriorityAnchorsTotal : 0;
+        const missingAnchors = [...anchorIds]
+            .filter((id) => !resultIdSet.has(id))
+            .slice(0, maxMissing)
+            .map((id) => ({ id, title: anchorLookup.get(id) ?? "(unknown)" }));
+        return {
+            anchorsInResults,
+            highPriorityAnchorsTotal,
+            fraction,
+            missingAnchors,
+        };
+    });
+    if (!result.ok)
+        return undefined;
+    return result.value;
+}
+//# sourceMappingURL=recall-helpers.js.map

package/build/tools/recall-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recall-helpers.js","sourceRoot":"","sources":["../../src/tools/recall-helpers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,0BAA0B,EAAsD,4BAA4B,EAAE,2BAA2B,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAC;AACvM,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,gCAAgC,EAAE,gCAAgC,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAC1H,OAAO,EAAE,QAAQ,EAAE,wCAAwC,EAAE,oBAAoB,EAAE,8BAA8B,EAAE,wBAAwB,EAAE,2BAA2B,EAAE,MAAM,eAAe,CAAC;AAGhM,iFAAiF;AAEjF,MAAM,UAAU,2BAA2B,CAAC,IAAU;IACpD,MAAM,QAAQ,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,EAAE,MAAM,IAAI,CAAC,CAAC;IACjD,OAAO;QACL,QAAQ;QACR,aAAa,EAAE,0BAA0B,CAAC,QAAQ,CAAC;QACnD,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,YAAY;QACZ,mBAAmB,EAAE,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;QAChF,cAAc,EAAE,IAAI,CAAC,GAAG,CACtB,IAAI,EACJ;YACE,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACvC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACtE,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;SACtC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,EAAE,CAAC,CAAC,CACzC;KACF,CAAC;AACJ,CAAC;AAED,iFAAiF;AAEjF,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC;AAExC,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAClD,MAAe,EACf,KAAa,EACb,iBAAgD,EAChD,OAAiD,EACjD,KAAmC,EACnC,IAA0B,EAC1B,SAAoC,EACpC,WAAoC;IAEpC,MAAM,SAAS,GAAG,OAAO,EAAE,EAAE,CAAC;IAC9B,MAAM,mBAAmB,GAAG,4BAA4B,CAAC,iBAAiB,CAAC,CAAC;IAC5E,MAAM,wBAAwB,GAAG,mBAAmB,CAAC,CAAC,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAAC,CAAC,SAAS,CAAC;IACvG,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5D,MAAM,UAAU,GAQX,EAAE,CAAC;IAER,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QAC9D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBAAE,SAAS;YAEzC,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC5B,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACpC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;oBAAE,SAAS;YACpD,CAAC;YAED,IAAI,SAAS,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS;gBAAE,SAAS;YAExD,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC;YACjD,MAAM,gBAAgB,GAAG,OAAO,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO,CAAC,EAAE,CAAC;YAEhE,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,gBAAgB;gBAAE,SAAS;YACvD,IAAI,KAAK,KAAK,QAAQ,IAAI,aAAa;gBAAE,SAAS;YAClD,IACE,mBAAmB;mBAChB,wBAAwB,KAAK,SAAS;mBACtC,CAAC,4BAA4B,CAAC,IAAI,CAAC,SAAS,EAAE,wBAAwB,CAAC,EAC1E,CAAC;gBACD,SAAS;YACX,CAAC;YAED,MAAM,UAAU,GAAG,MAAM,oBAAoB,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YAC1F,IAAI,CAAC,UAAU;gBAAE,SAAS;YAE1B,UAAU,CAAC,IAAI,CAAC;gBACd,EAAE,EAAE,IAAI,CAAC,EAAE;gBACX,KAAK;gBACL,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,CAAC;gBAC3C,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,cAAc,EAAE,UAAU,CAAC,cAAc;gBACzC,gBAAgB,EAAE,SAAS;oBACzB,CAAC,CAAC,gCAAgC,CAChC,SAAS,EACT,KAAK,CAAC,OAAO,CAAC,SAAS,EACvB,IAAI,CAAC,EAAE,EACP,UAAU,CAAC,cAAc,CAC1B,IAAI,QAAQ,CAAC,UAAU,CAAC,cAAc,CAAC;oBACxC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,cAAc,CAAC;gBACvC,OAAO,EAAE,2BAA2B,CAAC,IAAI,CAAC;aAC3C,CAAC,CAAC;YAEH,IAAI,SAAS,EAAE,CAAC;gBACd,gCAAgC,CAC9B,SAAS,EACT,KAAK,CAAC,OAAO,CAAC,SAAS,EACvB,IAAI,CAAC,EAAE,EACP,UAAU,CAAC,cAAc,EACzB,UAAU,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,gBAAgB,CACpD,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,eAAe,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACrD,EAAE,EAAE,SAAS,CAAC,EAAE;QAChB,IAAI,EAAE,SAAS,CAAC,cAAc;KAC/B,CAAC,CAAC,CAAC;IAEJ,MAAM,oBAAoB,GAAG,wCAAwC,CACnE,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QAC7B,EAAE,EAAE,SAAS,CAAC,EAAE;QAChB,IAAI,EAAE,SAAS,CAAC,cAAc;QAC9B,MAAM,EAAE,SAAS,CAAC,gBAAgB;KACnC,CAAC,CAAC,CACJ,CAAC;IAEF,MAAM,eAAe,GAAG,IAAI,GAAG,CAC7B,oBAAoB,CAClB,KAAK,EACL,eAAe,EACf,8BAA8B,EAC9B,oBAAoB,CACrB,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,EAAE,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,CACtD,CAAC;IAEF,MAAM,UAAU,GAA4B,EAAE,CAAC;IAC/C,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,UAAU,GAAG,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACrD,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,IAAI,CAAC;YAAE,SAAS;QAE1D,MAAM,YAAY,GAAG,UAAU,CAAC;QAChC,IAAI,YAAY,GAAG,wBAAwB;YAAE,SAAS;QAEtD,MAAM,aAAa,GAAG,iBAAiB;YACrC,CAAC,CAAC,2BAA2B,CAAC,SAAS,CAAC,SAAS,EAAE,iBAAiB,CAAC;YACrE,CAAC,CAAC,CAAC,CAAC;QACN,MAAM,KAAK,GAAG,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC,aAAa,GAAG,aAAa,CAAC;QACvH,UAAU,CAAC,IAAI,CAAC;YACd,EAAE,EAAE,SAAS,CAAC,EAAE;YAChB,KAAK,EAAE,YAAY;YACnB,yBAAyB,EAAE,CAAC;YAC5B,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,SAAS,CAAC,KAAK;YACtB,gBAAgB,EAAE,SAAS,CAAC,gBAAgB;YAC5C,YAAY;YACZ,SAAS,EAAE,SAAS,CAAC,OAAO,CAAC,SAAS;YACtC,YAAY,EAAE,SAAS,CAAC,OAAO,CAAC,YAAY;YAC5C,mBAAmB,EAAE,SAAS,CAAC,OAAO,CAAC,mBAAmB;YAC1D,cAAc,EAAE,SAAS,CAAC,OAAO,CAAC,cAAc;YAChD,QAAQ,EAAE,SAAS,CAAC,OAAO,CAAC,QAAQ;SACrC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,UAAU;SACd,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,CAAC;SAC7D,KAAK,CAAC,CAAC,EAAE,2BAA2B,CAAC,CAAC;AAC3C,CAAC;AAYD,MAAM,UAAU,wBAAwB,CAAC,KAAa;IACpD,OAAO,KAAK;SACT,WAAW,EAAE;SACb,KAAK,CAAC,YAAY,CAAC;SACnB,MAAM,CAAC,OAAO,CAAC,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAmB,EAAE,KAAuB;IAC5E,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;QAC1B,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,GAAW,EAAE,MAAiC;IACpF,MAAM,aAAa,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IACxC,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,kBAAkB,WAAW,CAAC,aAAa,CAAC,iBAAiB,CAAC,CAAC;IAC1F,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AACjF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,MAAe,EACf,SAAiB;IAEjB,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,MAAM,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE/C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,WAAW,GAAG,MAAM,OAAO,CAAC,oBAAoB,EAAE,KAAK,IAAI,EAAE;YACjE,MAAM,KAAK,GAAG,MAAM,uBAAuB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YAC9D,IAAI,CAAC,KAAK;gBAAE,OAAO,SAAS,CAAC;YAC7B,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAU,CAAC;YAC5C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;oBAAE,SAAS;gBACzC,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,SAAS,IAAI,EAAE,EAAE,CAAC;oBACvC,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;wBAC9B,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;oBAChC,CAAC;gBACH,CAAC;YACH,CAAC;YACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;oBAAE,SAAS;gBACzC,IACE,CAAC,IAAI,CAAC,UAAU,KAAK,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,CAAC;uBAClD,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAClC,CAAC;oBACD,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;oBACvB,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;gBACxC,CAAC;YACH,CAAC;YACD,OAAO,SAAS,CAAC;QACnB,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,WAAW,CAAC,EAAE;YAAE,SAAS;IAChC,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;AACrC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAAuF;IAEvF,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,kBAAkB,EAAE,GAAG,EAAE;QACpD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAClC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC7C,MAAM,eAAe,GAAG,IAAI,GAAG,EAAkB,CAAC;QAElD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,KAAK,MAAM,GAAG,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;gBACzB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACnB,CAAC;YACD,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;gBACX,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC5D,CAAC;YACD,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAChF,CAAC;QAED,OAAO;YACL,UAAU,EAAE,OAAO,CAAC,IAAI;YACxB,OAAO,EAAE,MAAM,CAAC,WAAW,CAAC,UAAU,CAA2B;YACjE,YAAY,EAAE,MAAM,CAAC,WAAW,CAAC,eAAe,CAA2B;SAC5E,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,SAAS,CAAC;IACjC,OAAO,MAAM,CAAC,KAAK,CAAC;AACtB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAClD,SAAmB,EACnB,SAAsB,EACtB,YAAiC,EACjC,UAAU,GAAG,CAAC;IAEd,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,iBAAiB,EAAE,GAAG,EAAE;QACnD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;QACvC,MAAM,gBAAgB,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;QACnF,MAAM,wBAAwB,GAAG,SAAS,CAAC,IAAI,CAAC;QAChD,MAAM,QAAQ,GAAG,wBAAwB,GAAG,CAAC,CAAC,CAAC,CAAC,gBAAgB,GAAG,wBAAwB,CAAC,CAAC,CAAC,CAAC,CAAC;QAEhG,MAAM,cAAc,GAAG,CAAC,GAAG,SAAS,CAAC;aAClC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;aACpC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC;aACpB,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,WAAW,EAAE,CAAC,CAAC,CAAC;QAErE,OAAO;YACL,gBAAgB;YAChB,wBAAwB;YACxB,QAAQ;YACR,cAAc;SACf,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,SAAS,CAAC;IACjC,OAAO,MAAM,CAAC,KAAK,CAAC;AACtB,CAAC"}

package/build/tools/recall.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ServerContext } from "../server-context.js";
+export declare function registerRecallTool(server: McpServer, ctx: ServerContext): void;
+//# sourceMappingURL=recall.d.ts.map

package/build/tools/recall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recall.d.ts","sourceRoot":"","sources":["../../src/tools/recall.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAoE1D,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,aAAa,GAAG,IAAI,CAuf9E"}

package/build/tools/recall.js

@@ -0,0 +1,413 @@
+import { z } from "zod";
+import { performance } from "perf_hooks";
+import { memoryId } from "../brands.js";
+import { RecallResultSchema, } from "../structured-content.js";
+import { embed, cosineSimilarity } from "../embeddings.js";
+import { detectTemporalQueryHint, shouldApplyTemporalFiltering, isWithinTemporalFilterWindow, computeTemporalRecencyBoost, computeHybridScore, selectRecallResults, selectWorkflowResults, applyLexicalReranking, enrichRescueCandidateScores, resolveDiscoveredVaults, applyCanonicalExplanationPromotion, applyGraphSpreadingActivation, assignDenseRanks, } from "../recall.js";
+import { shouldTriggerLexicalRescue } from "../lexical.js";
+import { attempt } from "../error-utils.js";
+import { getOrBuildVaultEmbeddings, getOrBuildVaultNoteList, setSessionCachedProjection, getSessionCachedProjection, recordSessionNoteAccess, setSessionCachedNote, getSessionCachedNote, } from "../cache.js";
+import { getOrBuildProjection } from "../projections.js";
+import { embedMissingNotes } from "../helpers/embed.js";
+import { ensureBranchSynced, resolveProject, noteProjectRef, projectParam, } from "../helpers/project.js";
+import { storageLabel } from "../helpers/vault.js";
+import { formatNote, formatTemporalHistory, formatRelationshipPreview, toRecallFreshness, toRecallRankBand, formatRetrievalEvidenceHint, } from "../helpers/index.js";
+import { getNoteProvenance, buildTemporalHistoryEntry, computeConfidence, computeSignalStrength, } from "../provenance.js";
+import { enrichTemporalHistory } from "../temporal-interpretation.js";
+import { getRelationshipPreview } from "../relationships.js";
+import { collectLexicalRescueCandidates, buildRecallCandidateContext, identifyHighPriorityAnchors, computeRecallDiversity, computeRecallRetrievalCoverage } from "./recall-helpers.js";
+export function registerRecallTool(server, ctx) {
+    server.registerTool("recall", {
+        title: "Recall",
+        description: "Semantic search over stored memories using embeddings.\n\n" +
+            "Supports opt-in temporal mode (`mode: \"temporal\"`) to enrich top semantic matches with compact git-backed history.\n\n" +
+            "Supports workflow mode (`mode: \"workflow\"`) to prioritize RPIR-style chain reconstruction while retaining compatibility with legacy relationships.\n\n" +
+            "Use this when:\n" +
+            "- You know the topic but not the exact memory id\n" +
+            "- You are starting a session and want relevant prior context\n" +
+            "- You want to check whether a memory already exists before creating another one\n" +
+            "- You explicitly want to inspect how a note evolved over time\n\n" +
+            "Do not use this when:\n" +
+            "- You already know the exact id; use `get`\n" +
+            "- You just want to browse by tags or scope; use `list`\n\n" +
+            "Returns:\n" +
+            "- Ranked memory matches with scores, vault label, tags, lifecycle, and updated time\n" +
+            "- Bounded 1-hop relationship previews automatically attached to top results\n" +
+            "- In temporal mode, optional compact history entries for top matches\n" +
+            "- Optional retrieval evidence via `evidence: \"compact\"` for why a result ranked\n" +
+            "- `recallScopeNoteCount`: total notes visible in the recall scope (omit-aware: if vault is small, consider increasing limit)\n" +
+            "- `diversity`: theme count (unique tags), role mix, and lifecycle mix of selected results — use to gauge whether results span enough perspectives\n" +
+            "- `retrievalCoverage`: fraction of high-priority anchors (alwaysLoad or summary notes) present in results, with capped missing list — use to decide if another recall with broader terms is needed\n" +
+            "- `signalStrength`: per-result composite quality signal (0-0.50) from role, centrality, lifecycle, and recency — higher values mean more structural support; use alongside confidence to assess note reliability\n\n" +
+            "Read-only.\n\n" +
+            "Typical next step:\n" +
+            "- Use `get`, `update`, `relate`, or `consolidate` based on the results.",
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+        inputSchema: z.object({
+            query: z.string().describe("Natural-language search query describing the topic, decision, bug, preference, or context you want to find."),
+            cwd: projectParam,
+            limit: z.number().int().min(1).max(20).optional().default(ctx.defaultRecallLimit),
+            minSimilarity: z.number().min(0).max(1).optional().default(ctx.defaultMinSimilarity),
+            mode: z.enum(["default", "temporal", "workflow"]).optional().default("default").describe("Use `temporal` for compact git-backed history, or `workflow` for RPIR-oriented chain reconstruction."),
+            verbose: z.boolean().optional().default(false).describe("Only meaningful with `mode: \"temporal\"`. Adds richer stats-based history context without returning raw diffs."),
+            evidence: z.enum(["compact"]).optional().describe("Optional retrieval rationale. Omit for default output; use `compact` for bounded rank and lineage signals."),
+            tags: z.array(z.string()).optional().describe("Filter results to notes with all of these tags."),
+            scope: z
+                .enum(["project", "global", "all"])
+                .optional()
+                .default("all")
+                .describe("'project' = only this project's memories (project-scoped storage), " +
+                "'global' = only unscoped memories (main/global storage), " +
+                "'all' = both, with project notes boosted (default)"),
+            lifecycle: z.enum(["temporary", "permanent"]).optional().describe("Filter results by lifecycle. Useful for recovering working-state with `lifecycle: temporary` after `project_memory_summary` orientation."),
+        }),
+        outputSchema: RecallResultSchema,
+    }, async ({ query, cwd, limit, minSimilarity, mode, verbose, evidence, tags, scope, lifecycle }) => {
+        const t0Recall = performance.now();
+        await ensureBranchSynced(ctx, cwd);
+        const project = await resolveProject(ctx, cwd);
+        const queryVec = await embed(query);
+        const vaults = await ctx.vaultManager.searchOrder(cwd);
+        let effectiveLimit = limit;
+        let recallScopeNoteCount;
+        if (project) {
+            const scopeResult = await attempt("recall:scope-notes", async () => {
+                let totalVisible = 0;
+                for (const vault of vaults) {
+                    const noteList = await getOrBuildVaultNoteList(project.id, vault);
+                    if (noteList) {
+                        totalVisible += noteList.length;
+                    }
+                }
+                recallScopeNoteCount = totalVisible;
+                if (limit >= ctx.defaultRecallLimit && totalVisible <= 25) {
+                    effectiveLimit = Math.min(totalVisible, 20);
+                }
+            });
+            if (!scopeResult.ok) {
+                // fail-soft: use configured limit
+            }
+        }
+        const noteCache = new Map();
+        const noteCacheKey = (vault, id) => `${vault.storage.vaultPath}::${id}`;
+        const readCachedNote = async (vault, id) => {
+            // Check session cache first (populated when getOrBuildVaultEmbeddings was called)
+            if (project) {
+                const sessionNote = getSessionCachedNote(project.id, vault.storage.vaultPath, id);
+                if (sessionNote !== undefined)
+                    return sessionNote;
+            }
+            const key = noteCacheKey(vault, id);
+            const cached = noteCache.get(key);
+            if (cached) {
+                return cached;
+            }
+            const note = await vault.storage.readNote(memoryId(id));
+            if (note) {
+                noteCache.set(key, note);
+            }
+            return note;
+        };
+        await Promise.allSettled(vaults.map((vault) => embedMissingNotes(ctx, vault.storage).catch(() => { })));
+        const scored = [];
+        const temporalQueryHint = detectTemporalQueryHint(query);
+        const applyTemporalFilter = shouldApplyTemporalFiltering(temporalQueryHint);
+        const temporalFilterWindowDays = applyTemporalFilter ? temporalQueryHint?.filterWindowDays : undefined;
+        for (const vault of vaults) {
+            const embeddings = project
+                ? (await getOrBuildVaultEmbeddings(project.id, vault)) ?? await vault.storage.listEmbeddings()
+                : await vault.storage.listEmbeddings();
+            for (const rec of embeddings) {
+                const rawScore = cosineSimilarity(queryVec, rec.embedding);
+                if (rawScore < minSimilarity)
+                    continue;
+                const note = await readCachedNote(vault, rec.id);
+                if (!note)
+                    continue;
+                if (tags && tags.length > 0) {
+                    const noteTags = new Set(note.tags);
+                    if (!tags.every((t) => noteTags.has(t)))
+                        continue;
+                }
+                if (lifecycle && note.lifecycle !== lifecycle) {
+                    continue;
+                }
+                const isProjectNote = note.project !== undefined;
+                const isCurrentProject = project && note.project === project.id;
+                if (scope === "project") {
+                    if (!isCurrentProject)
+                        continue;
+                }
+                else if (scope === "global") {
+                    if (isProjectNote)
+                        continue;
+                }
+                if (applyTemporalFilter
+                    && temporalFilterWindowDays !== undefined
+                    && !isWithinTemporalFilterWindow(note.updatedAt, temporalFilterWindowDays)) {
+                    continue;
+                }
+                const context = buildRecallCandidateContext(note);
+                const temporalBoost = temporalQueryHint
+                    ? computeTemporalRecencyBoost(note.updatedAt, temporalQueryHint)
+                    : 0;
+                const boost = (isCurrentProject ? ctx.projectScopeBoost : 0) + context.metadataBoost + temporalBoost;
+                scored.push({
+                    id: rec.id,
+                    score: rawScore,
+                    semanticScoreForPromotion: rawScore,
+                    boosted: rawScore + boost,
+                    vault,
+                    isCurrentProject: Boolean(isCurrentProject),
+                    lifecycle: context.lifecycle,
+                    relatedCount: context.relatedCount,
+                    connectionDiversity: context.connectionDiversity,
+                    structureScore: context.structureScore,
+                    metadata: context.metadata,
+                });
+            }
+        }
+        const projectionTexts = new Map();
+        const noteRelationships = new Map();
+        for (const candidate of scored) {
+            const note = await readCachedNote(candidate.vault, candidate.id).catch(() => null);
+            if (!note) {
+                continue;
+            }
+            if (note.relatedTo && note.relatedTo.length > 0) {
+                noteRelationships.set(candidate.id, note.relatedTo.map((r) => ({ id: r.id, type: r.type })));
+            }
+            const projection = await getOrBuildProjection(candidate.vault.storage, note).catch(() => undefined);
+            if (!projection) {
+                continue;
+            }
+            projectionTexts.set(candidate.id, projection.projectionText);
+            if (project) {
+                setSessionCachedProjection(project.id, candidate.id, projection);
+            }
+        }
+        // Apply lexical reranking over semantic candidates (fail-soft)
+        const getProjectionText = (id) => {
+            const inlineProjection = projectionTexts.get(id);
+            if (inlineProjection) {
+                return inlineProjection;
+            }
+            if (project) {
+                const cached = getSessionCachedProjection(project.id, id);
+                if (cached)
+                    return cached.projectionText;
+            }
+            return undefined;
+        };
+        const strongestSemanticScore = scored.reduce((max, candidate) => max === undefined ? candidate.score : Math.max(max, candidate.score), undefined);
+        const reranked = applyLexicalReranking(scored, query, getProjectionText);
+        const semanticCandidateIds = new Set(reranked.map((candidate) => candidate.id));
+        // Apply graph spreading activation: traverse related notes and boost their scores
+        const preSpreadIds = new Set(reranked.map((c) => c.id));
+        const getNoteRelationships = (id) => {
+            return noteRelationships.get(id);
+        };
+        const withGraphSpread = applyGraphSpreadingActivation(reranked, getNoteRelationships);
+        const graphDiscoveredIds = new Set(withGraphSpread.filter((candidate) => !semanticCandidateIds.has(candidate.id)).map((candidate) => candidate.id));
+        // Resolve correct vault for graph-discovered candidates that inherited their
+        // entry point's vault instead of their own.
+        await resolveDiscoveredVaults(withGraphSpread, preSpreadIds, async (id) => {
+            for (const v of vaults) {
+                const note = await v.storage.readNote(memoryId(id)).catch(() => null);
+                if (note) {
+                    const isCurrentProject = project ? note.project === project.id : false;
+                    return { vault: v, isCurrentProject };
+                }
+            }
+            return undefined;
+        });
+        // Re-assign semanticRank after graph spreading since scores are now modified
+        // and graph-discovered candidates have no semanticRank.
+        const sortedByScore = [...withGraphSpread].sort((a, b) => b.score - a.score || b.boosted - a.boosted);
+        assignDenseRanks(sortedByScore, (candidate) => candidate.score, (candidate, rank) => {
+            candidate.semanticRank = rank;
+        });
+        let promoted = applyCanonicalExplanationPromotion(withGraphSpread);
+        let rescueCandidateIds = new Set();
+        // Lexical rescue: when semantic results are weak, scan projections for additional candidates.
+        // Skip rescue when the caller set a strict minSimilarity above the default,
+        // because rescue candidates lack genuine semantic backing.
+        const rescueAllowed = minSimilarity <= ctx.defaultMinSimilarity;
+        if (rescueAllowed && shouldTriggerLexicalRescue(strongestSemanticScore, scored.length)) {
+            const rescueCandidates = await collectLexicalRescueCandidates(vaults, query, temporalQueryHint, project ?? undefined, scope, tags, lifecycle, promoted);
+            promoted.push(...rescueCandidates);
+            rescueCandidateIds = new Set(rescueCandidates.map((candidate) => candidate.id));
+            enrichRescueCandidateScores(promoted, query, getProjectionText);
+            promoted = applyCanonicalExplanationPromotion(promoted);
+        }
+        const top = mode === "workflow"
+            ? selectWorkflowResults(promoted, effectiveLimit, scope)
+            : selectRecallResults(promoted, effectiveLimit, scope);
+        if (top.length === 0) {
+            const structuredContent = {
+                action: "recalled",
+                query,
+                scope: scope || "all",
+                recallScopeNoteCount,
+                results: [],
+            };
+            return { content: [{ type: "text", text: "No memories found matching that query." }], structuredContent };
+        }
+        const header = project
+            ? `Recall results for project **${project.name}** (scope: ${scope}):`
+            : `Recall results (global):`;
+        const sections = [];
+        const structuredResults = [];
+        // Determine how many top results get relationship expansion
+        // Top 1 by default, top 3 if result count is small
+        const recallRelationshipLimit = top.length <= 3 ? 3 : 1;
+        for (const [index, { id, score, vault, boosted, semanticRank, lexicalRank, canonicalExplanationScore, metadata, isCurrentProject }] of top.entries()) {
+            const note = await readCachedNote(vault, id);
+            if (note) {
+                const centrality = note.relatedTo?.length ?? 0;
+                const filePath = `${vault.notesRelDir}/${id}.md`;
+                const provenance = await getNoteProvenance(vault.git, filePath);
+                const signalStrengthResult = await attempt("recall:signal-strength", async () => {
+                    const ss = computeSignalStrength({
+                        lifecycle: note.lifecycle,
+                        updatedAt: note.updatedAt,
+                        role: note.role,
+                        centrality,
+                    });
+                    return Number.isFinite(ss) ? ss : undefined;
+                });
+                const signalStrength = signalStrengthResult.ok ? signalStrengthResult.value : undefined;
+                const confidence = computeConfidence(note.lifecycle, note.updatedAt, centrality, signalStrength);
+                let history;
+                let historySummary;
+                if (mode === "temporal") {
+                    if (index < ctx.temporalHistoryNoteLimit) {
+                        const commits = await vault.git.getFileHistory(filePath, ctx.temporalHistoryCommitLimit);
+                        const rawHistory = await Promise.all(commits.map(async (commit) => {
+                            const stats = await vault.git.getCommitStats(filePath, commit.hash);
+                            return buildTemporalHistoryEntry(commit, stats, verbose);
+                        }));
+                        const enriched = enrichTemporalHistory(rawHistory);
+                        history = verbose
+                            ? enriched.interpretedHistory
+                            : enriched.interpretedHistory.map(entry => ({ ...entry, stats: undefined }));
+                        historySummary = enriched.historySummary;
+                    }
+                }
+                // Add relationship preview for top N results (fail-soft)
+                let relationships;
+                if (index < recallRelationshipLimit) {
+                    relationships = await getRelationshipPreview(note, ctx.vaultManager.allKnownVaults(), { activeProjectId: project?.id, limit: 3 });
+                }
+                const formattedHistory = mode === "temporal" && history !== undefined
+                    ? `\n\n${formatTemporalHistory(history)}`
+                    : "";
+                const formattedRelationships = relationships !== undefined
+                    ? `\n\n${formatRelationshipPreview(relationships)}`
+                    : "";
+                const provenanceLine = provenance || confidence
+                    ? `\n**confidence:** ${confidence ?? "medium"}${provenance?.recentlyChanged ? " | **recently changed**" : ""}${signalStrength !== undefined ? ` | signalStrength: ${signalStrength.toFixed(2)}` : ""}`
+                    : signalStrength !== undefined
+                        ? `\n**signalStrength:** ${signalStrength.toFixed(2)}`
+                        : "";
+                const supersededRelations = (note.relatedTo ?? []).filter((rel) => rel.type === "supersedes");
+                const retrievalEvidence = evidence === "compact"
+                    ? {
+                        channels: [
+                            semanticRank !== undefined ? "semantic" : undefined,
+                            lexicalRank !== undefined ? "lexical" : undefined,
+                            graphDiscoveredIds.has(id) ? "graph" : undefined,
+                            rescueCandidateIds.has(id) ? "rescue" : undefined,
+                            canonicalExplanationScore !== undefined && canonicalExplanationScore > 0 ? "canonical" : undefined,
+                            temporalQueryHint ? "temporal-boost" : undefined,
+                        ].filter((value) => value !== undefined),
+                        rankBand: toRecallRankBand(semanticRank),
+                        projectRelevant: isCurrentProject,
+                        freshness: toRecallFreshness(note.updatedAt),
+                        superseded: supersededRelations.length > 0,
+                        supersededBy: supersededRelations.length > 0 ? supersededRelations[0]?.id : undefined,
+                        supersededCount: supersededRelations.length > 0 ? supersededRelations.length : undefined,
+                    }
+                    : undefined;
+                const evidenceLine = retrievalEvidence
+                    ? `\n${formatRetrievalEvidenceHint(retrievalEvidence, metadata?.role)}`
+                    : "";
+                // Suppress raw related IDs when enriched preview is shown to avoid duplication
+                sections.push(`${formatNote(note, score, relationships === undefined)}${provenanceLine}${evidenceLine}${formattedHistory}${formattedRelationships}`);
+                structuredResults.push({
+                    id,
+                    title: note.title,
+                    score,
+                    boosted,
+                    project: noteProjectRef(note),
+                    vault: storageLabel(vault),
+                    tags: note.tags,
+                    lifecycle: note.lifecycle,
+                    role: note.role,
+                    updatedAt: note.updatedAt,
+                    provenance,
+                    confidence,
+                    signalStrength,
+                    history,
+                    historySummary,
+                    relationships,
+                    retrievalEvidence,
+                });
+                if (project) {
+                    setSessionCachedNote(project.id, vault.storage.vaultPath, note);
+                    recordSessionNoteAccess(project.id, vault.storage.vaultPath, id, "recall", computeHybridScore({
+                        id,
+                        score,
+                        boosted,
+                        vault,
+                        isCurrentProject: note.project === project.id,
+                    }));
+                }
+            }
+        }
+        let diversity;
+        let retrievalCoverage;
+        if (structuredResults.length > 0) {
+            diversity = await computeRecallDiversity(structuredResults);
+            if (project) {
+                const { anchorIds, anchorLookup } = await identifyHighPriorityAnchors(vaults, project.id);
+                const coverageResult = await computeRecallRetrievalCoverage(structuredResults.map((r) => r.id), anchorIds, anchorLookup);
+                if (coverageResult) {
+                    retrievalCoverage = coverageResult;
+                }
+            }
+        }
+        const diagnosticsParts = [];
+        if (recallScopeNoteCount !== undefined) {
+            diagnosticsParts.push(`scope notes: ${recallScopeNoteCount}`);
+        }
+        if (diversity) {
+            diagnosticsParts.push(`themes: ${diversity.themeCount}`);
+        }
+        if (retrievalCoverage) {
+            diagnosticsParts.push(`anchor coverage: ${retrievalCoverage.fraction.toFixed(2)} (${retrievalCoverage.anchorsInResults}/${retrievalCoverage.highPriorityAnchorsTotal})`);
+        }
+        const diagnosticsLine = diagnosticsParts.length > 0 ? `\n${diagnosticsParts.join(" | ")}` : "";
+        const textContent = `${header}${diagnosticsLine}\n\n${sections.join("\n\n---\n\n")}`;
+        const structuredContent = {
+            action: "recalled",
+            query,
+            scope: scope || "all",
+            recallScopeNoteCount,
+            diversity,
+            retrievalCoverage,
+            results: structuredResults,
+        };
+        console.error(`[recall:timing] ${(performance.now() - t0Recall).toFixed(1)}ms`);
+        return {
+            content: [{ type: "text", text: textContent }],
+            structuredContent,
+        };
+    });
+}
+//# sourceMappingURL=recall.js.map