@danielmarbach/mnemonic-mcp 0.27.2 → 0.28.0

package/build/tools/recall-helpers.js

@@ -0,0 +1,137 @@
+import { getEffectiveMetadata } from "../role-suggestions.js";
+import { computeRecallMetadataBoost, shouldApplyTemporalFiltering, computeTemporalRecencyBoost, isWithinTemporalFilterWindow } from "../recall.js";
+import { getOrBuildProjection } from "../projections.js";
+import { getSessionCachedProjectionTokens, setSessionCachedProjectionTokens } 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);
+}
+//# 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":"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"}

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;AAgE1D,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,aAAa,GAAG,IAAI,CA+a9E"}

package/build/tools/recall.js

@@ -0,0 +1,343 @@
+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 { getOrBuildVaultEmbeddings, 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, } from "../provenance.js";
+import { enrichTemporalHistory } from "../temporal-interpretation.js";
+import { getRelationshipPreview } from "../relationships.js";
+import { collectLexicalRescueCandidates, buildRecallCandidateContext } 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\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);
+        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, limit, scope)
+            : selectRecallResults(promoted, limit, scope);
+        if (top.length === 0) {
+            const structuredContent = { action: "recalled", query, scope: scope || "all", 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 confidence = computeConfidence(note.lifecycle, note.updatedAt, centrality);
+                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**" : ""}`
+                    : "";
+                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,
+                    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,
+                    }));
+                }
+            }
+        }
+        const textContent = `${header}\n\n${sections.join("\n\n---\n\n")}`;
+        const structuredContent = {
+            action: "recalled",
+            query,
+            scope: scope || "all",
+            results: structuredResults,
+        };
+        console.error(`[recall:timing] ${(performance.now() - t0Recall).toFixed(1)}ms`);
+        return {
+            content: [{ type: "text", text: textContent }],
+            structuredContent,
+        };
+    });
+}
+//# sourceMappingURL=recall.js.map

package/build/tools/recall.js.map

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

package/build/tools/recent-memories.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 registerRecentMemoriesTool(server: McpServer, ctx: ServerContext): void;
+//# sourceMappingURL=recent-memories.d.ts.map

package/build/tools/recent-memories.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recent-memories.d.ts","sourceRoot":"","sources":["../../src/tools/recent-memories.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAc1D,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,aAAa,GAAG,IAAI,CAqFtF"}

package/build/tools/recent-memories.js

@@ -0,0 +1,79 @@
+import { z } from "zod";
+import { RecentResultSchema } from "../structured-content.js";
+import { projectParam, toProjectRef, noteProjectRef, ensureBranchSynced, } from "../helpers/project.js";
+import { collectVisibleNotes, formatListEntry, storageLabel, } from "../helpers/vault.js";
+export function registerRecentMemoriesTool(server, ctx) {
+    server.registerTool("recent_memories", {
+        title: "Recent Memories",
+        description: "Show the most recently updated memories.\n\n" +
+            "Use this when:\n" +
+            "- You want to see what changed most recently\n" +
+            "- You are resuming work and want a quick chronological view\n\n" +
+            "Do not use this when:\n" +
+            "- You need topic-based search; use `recall`\n" +
+            "- You need a tag/scope inventory; use `list`\n\n" +
+            "Returns:\n" +
+            "- Recently updated memories with ids, timestamps, storage labels, and basic metadata\n\n" +
+            "Read-only.\n\n" +
+            "Typical next step:\n" +
+            "- Use `get` for exact inspection or `update` to continue refining a recent note.",
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+        inputSchema: z.object({
+            cwd: projectParam,
+            scope: z.enum(["project", "global", "all"]).optional().default("all"),
+            storedIn: z.enum(["project-vault", "main-vault", "any"]).optional().default("any"),
+            limit: z.number().int().min(1).max(20).optional().default(5),
+            includePreview: z.boolean().optional().default(true),
+            includeStorage: z.boolean().optional().default(true),
+            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: RecentResultSchema,
+    }, async ({ cwd, scope, storedIn, limit, includePreview, includeStorage, lifecycle }) => {
+        await ensureBranchSynced(ctx, cwd);
+        const { project, entries } = await collectVisibleNotes(ctx, cwd, scope, undefined, storedIn);
+        let filteredEntries = entries;
+        if (lifecycle) {
+            filteredEntries = entries.filter(({ note }) => note.lifecycle === lifecycle);
+        }
+        const recent = [...filteredEntries]
+            .sort((a, b) => b.note.updatedAt.localeCompare(a.note.updatedAt))
+            .slice(0, limit);
+        if (recent.length === 0) {
+            const structuredContent = { action: "recent_shown", project: toProjectRef(project), count: 0, limit: limit || 5, notes: [] };
+            return { content: [{ type: "text", text: "No memories found." }], structuredContent };
+        }
+        const header = project && scope !== "global"
+            ? `Recent memories for ${project.name}:`
+            : "Recent memories:";
+        const lines = recent.map((entry) => formatListEntry(entry, {
+            includePreview,
+            includeStorage,
+            includeUpdated: true,
+        }));
+        const textContent = `${header}\n\n${lines.join("\n")}`;
+        const structuredNotes = recent.map(({ note, vault }) => ({
+            id: note.id,
+            title: note.title,
+            project: noteProjectRef(note),
+            tags: note.tags,
+            lifecycle: note.lifecycle,
+            vault: storageLabel(vault),
+            updatedAt: note.updatedAt,
+            preview: includePreview && note.content ? note.content.substring(0, 100) + (note.content.length > 100 ? "..." : "") : undefined,
+        }));
+        const structuredContent = {
+            action: "recent_shown",
+            project: toProjectRef(project),
+            count: recent.length,
+            limit: limit || 5,
+            notes: structuredNotes,
+        };
+        return { content: [{ type: "text", text: textContent }], structuredContent };
+    });
+}
+//# sourceMappingURL=recent-memories.js.map

package/build/tools/recent-memories.js.map

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

package/build/tools/relate.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 registerRelateTool(server: McpServer, ctx: ServerContext): void;
+//# sourceMappingURL=relate.d.ts.map