minutes-mcp 0.28.2 → 0.29.0

package/dist/index.d.ts

@@ -640,6 +640,8 @@ export declare function verifiedStopRecordingSummary(snapshot: {
         };
     };
 }): string;
+/** Temporal projection consumes only the exact authorized corpus snapshot. */
+export declare function policyDecisionHistory(snapshot: StableCorpusSnapshot): reader.DecisionHistoryEntry[];
 export declare function readVerifiedScreenImage(imagePath: string, expectedByteSize: number, expectedSha256: string, screenRoot?: string, hooks?: BoundReadHooks): Promise<Buffer>;
 export declare function restrictedMeetingStubResult(meeting: PolicyVerifiedMeeting): {
     content: {

package/dist/index.js

@@ -841,11 +841,11 @@ export async function policySearchMeetings(dir, query, limit, includeRestricted,
     const boundedLimit = normalizeMcpResultLimit(limit, MCP_POLICY_MEETING_RESULT_MAX, "policy search");
     if (!query)
         return [];
-    const needle = query.toLowerCase();
-    return policyMatchingSnapshotOperation(dir, includeRestricted, (meeting) => meeting.frontmatter.title.toLowerCase().includes(needle) ||
-        meeting.body.toLowerCase().includes(needle), (snapshots) => {
+    return policyMatchingSnapshotOperation(dir, includeRestricted, (meeting) => reader.lexicalMatch(meeting.frontmatter.title, meeting.body, query) !== null, (snapshots) => {
         const results = [];
-        for (const snapshot of newestPolicySnapshots(snapshots)) {
+        const ranked = snapshots.map((snapshot) => ({ snapshot, score: reader.lexicalMatch(snapshot.meeting.frontmatter.title, snapshot.meeting.body, query)?.score ?? 0 }));
+        ranked.sort((a, b) => reader.compareSearchMatches({ score: a.score, date: a.snapshot.meeting.frontmatter.date, path: a.snapshot.path }, { score: b.score, date: b.snapshot.meeting.frontmatter.date, path: b.snapshot.path }));
+        for (const { snapshot } of ranked) {
             results.push(snapshot.meeting);
             if (results.length >= boundedLimit)
                 break;
@@ -867,17 +867,10 @@ function meetingMatchesSince(meeting, since) {
     return Number.isFinite(boundary) && Number.isFinite(meetingDate) && meetingDate >= boundary;
 }
 function meetingMatchesPerson(meeting, person) {
-    if (!person)
+    if (person === undefined)
         return true;
-    const needle = person.trim().toLowerCase();
-    if (!needle)
-        return true;
-    const people = [
-        ...meeting.frontmatter.attendees,
-        ...meeting.frontmatter.people,
-        ...(meeting.frontmatter.attendees_raw || "").split(/[,;\n]/),
-    ];
-    return people.some((entry) => entry.trim().toLowerCase().includes(needle));
+    const identity = reader.resolvePersonIdentity([meeting], person);
+    return !!identity && reader.meetingMentionsPerson(meeting, identity);
 }
 function normalizedPersonSelector(value) {
     return (value ?? "").trim().replace(/\s+/g, " ").toLowerCase();
@@ -910,7 +903,7 @@ export function policyIntentResults(meetings, query, intentKind, owner, limit =
         const queryFields = includeMeetingTitleInQuery
             ? [what, who || "", meeting.frontmatter.title]
             : [what, who || ""];
-        if (needle && !queryFields.some((value) => value.toLowerCase().includes(needle)))
+        if (needle && !reader.lexicalMatch("", queryFields.join(" "), query))
             return false;
         if (ownerNeedle && !ownerMatchesExactSelector(who, ownerNeedle))
             return false;
@@ -1037,17 +1030,30 @@ function meetingMatchesToolSearch(meeting, filter) {
     if (intentMode) {
         return policyIntentResults([meeting], filter.query, filter.intentKind, filter.owner, 1).length > 0;
     }
-    const needle = filter.query.trim().toLowerCase();
-    return needle.length > 0 &&
-        (meeting.frontmatter.title.toLowerCase().includes(needle) ||
-            meeting.body.toLowerCase().includes(needle));
+    return reader.lexicalMatch(meeting.frontmatter.title, meeting.body, filter.query) !== null;
 }
 export function collectPolicyToolSearchSnapshots(snapshot, includeRestricted, filter) {
-    return newestPolicySnapshots(collectPolicyVerifiedMeetingSnapshots(snapshot, includeRestricted, (meeting) => meetingMatchesToolSearch(meeting, filter)));
+    const matches = [];
+    for (const file of snapshot.files) {
+        if (!isActiveCorpusMeetingPath(file.path, snapshot.canonicalRoot))
+            continue;
+        const meeting = parsePolicyVerifiedMeeting(file.content, file.path);
+        if (!meeting || (!includeRestricted && meetingSensitivity(meeting) === "restricted"))
+            continue;
+        if (!meetingMatchesToolSearch(meeting, filter))
+            continue;
+        meeting.retrieval = reader.lexicalMatch(meeting.frontmatter.title, meeting.body, filter.query) ?? undefined;
+        matches.push({ path: file.path, content: file.content, meeting });
+    }
+    return matches.sort((a, b) => reader.compareSearchMatches({ score: a.meeting.retrieval?.score ?? 0, date: a.meeting.frontmatter.date, path: a.path }, { score: b.meeting.retrieval?.score ?? 0, date: b.meeting.frontmatter.date, path: b.path })).slice(0, MCP_POLICY_MEETING_RESULT_MAX);
 }
-async function policyToolSearchMeetings(dir, includeRestricted, filter) {
+async function policyToolSearchMeetings(dir, includeRestricted, filter, limit = MCP_MEETING_RESULT_MAX) {
     return withStableCorpusLease(dir, (snapshot) => collectPolicyToolSearchSnapshots(snapshot, includeRestricted, filter)
-        .map((entry) => entry.meeting));
+        .slice(0, limit)
+        .map((entry) => ({ ...entry.meeting, evidence: reader.buildSourceEvidence({
+            path: entry.path, content: entry.content, body: entry.meeting.body,
+            speakerMap: entry.meeting.frontmatter.speaker_map,
+        }, { query: filter.query, limit: 3 }) })));
 }
 export function openActionsFromMeetings(meetings, limit = MCP_ACTION_RESULT_MAX) {
     const boundedLimit = normalizeMcpResultLimit(limit, MCP_ACTION_RESULT_MAX, "open action");
@@ -1336,7 +1342,7 @@ export function researchTopicProjection(sourceMeetings, query) {
     for (const meeting of meetings) {
         for (const decision of meeting.frontmatter.decisions) {
             if (!needle ||
-                ![decision.text, decision.topic || ""].some((value) => value.toLowerCase().includes(needle))) {
+                !reader.lexicalMatch(decision.topic || "", decision.text, query)) {
                 continue;
             }
             const line = `- ${boundedMcpField(meeting.frontmatter.date) ?? ""} — ${boundedMcpField(decision.text) ?? ""} (${boundedMcpField(meeting.frontmatter.title) ?? ""})`;
@@ -1351,7 +1357,7 @@ export function researchTopicProjection(sourceMeetings, query) {
     const topicCounts = new Map();
     for (const meeting of meetings) {
         for (const rawTag of meeting.frontmatter.tags) {
-            if (!needle || !rawTag.toLowerCase().includes(needle))
+            if (!needle || !reader.lexicalMatch(rawTag, "", query))
                 continue;
             const topic = boundedMcpField(rawTag) ?? "";
             if (!topic)
@@ -1591,7 +1597,7 @@ const COPILOT_SUPPORTED = hasFeature(CLI_CAPABILITIES, "copilot_realtime");
 // `./version.ts` (see issue #183). Hosted `.mcpb` bundles will run
 // against CLIs with different minor/patch numbers within the same
 // major; that is explicitly supported.
-const MCP_SERVER_VERSION = "0.28.2";
+const MCP_SERVER_VERSION = "0.29.0";
 export function parseKnowledgeConfig(configContent) {
     const knowledgeMatch = configContent.match(/\[knowledge\][\s\S]*?(?=\n\[|$)/);
     if (!knowledgeMatch) {
@@ -4109,7 +4115,7 @@ registerDocsAppTool("search_meetings", {
         intentKind: intent_kind,
         owner,
         intentsOnly: intents_only,
-    });
+    }, intentMode ? MCP_POLICY_MEETING_RESULT_MAX : boundedLimit);
     let results;
     if (intentMode) {
         results = policyIntentResults(meetings, query, intent_kind, owner, boundedLimit);
@@ -4119,7 +4125,9 @@ registerDocsAppTool("search_meetings", {
         for (const meeting of meetings) {
             matches.push({
                 ...meetingSearchItem(meeting),
-                snippet: liveMeetingSnippet(meeting.body, query),
+                snippet: meeting.evidence?.segments[0]?.quote ?? liveMeetingSnippet(meeting.body, query),
+                retrieval: meeting.retrieval,
+                evidence: meeting.evidence,
             });
             if (matches.length >= boundedLimit)
                 break;
@@ -4311,6 +4319,17 @@ if (hasFeature(CLI_CAPABILITIES, "get_moment"))
             _meta: { ui: { resourceUri: UI_RESOURCE_URI }, view: "context", kind: "get_moment" },
         };
     });
+/** Temporal projection consumes only the exact authorized corpus snapshot. */
+export function policyDecisionHistory(snapshot) {
+    const sources = snapshot.files.flatMap((file) => {
+        if (!isActiveCorpusMeetingPath(file.path, snapshot.canonicalRoot))
+            return [];
+        const meeting = parsePolicyVerifiedMeeting(file.content, file.path);
+        return !meeting || meetingSensitivity(meeting) === "restricted"
+            ? [] : [{ ...meeting, content: file.content }];
+    });
+    return reader.buildDecisionHistory(sources);
+}
 // ── Tool: consistency_report ───────────────────────────────
 // ── Tool: get_screen_context ───────────────────────────────
 // Direct image content is returned only for paths that the CLI resolved from
@@ -4445,14 +4464,18 @@ registerDocsAppTool("consistency_report", {
     annotations: { title: "Consistency Report", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     _meta: { ui: { resourceUri: UI_RESOURCE_URI } },
 }, async ({ owner, stale_after_days }) => {
+    const meetingsDir = await getEffectiveMeetingsDir();
     if (!(await isCliAvailable())) {
-        return { content: [{ type: "text", text: `Consistency reports require the full CLI for structured intent analysis.\n\n${CLI_INSTALL_MSG}` }] };
+        const decisionHistory = await withStableCorpusLease(meetingsDir, policyDecisionHistory);
+        return {
+            content: [{ type: "text", text: `Decision history: ${decisionHistory.length} sourced records. Full stale-commitment analysis requires the Minutes CLI.` }],
+            structuredContent: { decision_conflicts: [], stale_commitments: [], decision_history: decisionHistory, analysis_available: false, view: "report" },
+        };
     }
     const capabilities = await ensureCliCapabilities(["consistency_corpus_root_v1"]);
     if (capabilities.kind !== "report" || !hasFeature(capabilities, "consistency_corpus_root_v1")) {
         throw new Error("Consistency reports require a Minutes CLI that supports the selected meeting folder. Update Minutes, then try again.");
     }
-    const meetingsDir = await getEffectiveMeetingsDir();
     const args = ["consistency", "--dir", meetingsDir, "--stale-after-days", String(stale_after_days)];
     if (owner)
         args.push("--owner", owner);
@@ -4461,6 +4484,7 @@ registerDocsAppTool("consistency_report", {
     if (!report || typeof report !== "object") {
         return { content: [{ type: "text", text: stderr || stdout }] };
     }
+    const decisionHistory = await withStableCorpusLease(meetingsDir, policyDecisionHistory);
     const decisionConflicts = Array.isArray(report.decision_conflicts)
         ? report.decision_conflicts
         : [];
@@ -4470,7 +4494,7 @@ registerDocsAppTool("consistency_report", {
     if (decisionConflicts.length === 0 && staleCommitments.length === 0) {
         return {
             content: [{ type: "text", text: "No consistency issues found." }],
-            structuredContent: { decision_conflicts: [], stale_commitments: [], view: "report" },
+            structuredContent: { decision_conflicts: [], stale_commitments: [], decision_history: decisionHistory, view: "report" },
             _meta: { ui: { resourceUri: UI_RESOURCE_URI }, view: "report" },
         };
     }
@@ -4489,7 +4513,7 @@ registerDocsAppTool("consistency_report", {
     }
     return {
         content: [{ type: "text", text: sections.join("\n\n") }],
-        structuredContent: { decision_conflicts: decisionConflicts, stale_commitments: staleCommitments, view: "report" },
+        structuredContent: { decision_conflicts: decisionConflicts, stale_commitments: staleCommitments, decision_history: decisionHistory, view: "report" },
         _meta: { ui: { resourceUri: UI_RESOURCE_URI }, view: "report" },
     };
 });
@@ -4585,14 +4609,14 @@ registerTool("research_topic", "Research a topic across policy-authorized meetin
     const needle = query.trim().toLowerCase();
     const meetingsDir = await getEffectiveMeetingsDir();
     const sourceMeetings = await policyListMeetings(meetingsDir, MCP_POLICY_MEETING_RESULT_MAX, include_restricted);
+    const identity = attendee === undefined ? undefined : reader.resolvePersonIdentity(sourceMeetings, attendee);
     const meetings = [];
     if (needle.length > 0) {
         for (const meeting of sourceMeetings) {
             if ((contentType && meeting.frontmatter.type !== contentType) ||
                 !meetingMatchesSince(meeting, since) ||
-                !meetingMatchesPerson(meeting, attendee) ||
-                (!meeting.frontmatter.title.toLowerCase().includes(needle) &&
-                    !meeting.body.toLowerCase().includes(needle))) {
+                (attendee !== undefined && (!identity || !reader.meetingMentionsPerson(meeting, identity))) ||
+                !reader.lexicalMatch(meeting.frontmatter.title, meeting.body, query)) {
                 continue;
             }
             meetings.push(meeting);
@@ -4699,10 +4723,13 @@ registerDocsAppTool("get_meeting", {
                 // Non-fatal: fall through to raw content with no speaker_map enrichment.
             }
         }
-        let structuredOut = structured;
+        let structuredOut = {
+            ...structured,
+            evidence: reader.buildSourceEvidence({ path: resolved, content: rawContent, body: rawParsed.body, speakerMap: rawParsed.frontmatter.speaker_map }),
+        };
         if (include_restricted && meetingSensitivity(sensitivityParsed) === "restricted") {
             structuredOut = {
-                ...structured,
+                ...structuredOut,
                 sensitivity: "restricted",
                 sensitivity_override: { applied: true, logged: "durable-jsonl" },
             };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minutes-mcp",
-  "version": "0.28.2",
+  "version": "0.29.0",
   "mcpName": "io.github.silverstein/minutes",
   "description": "MCP server for minutes \u2014 conversation memory for AI assistants. Works with Claude Desktop, Mistral Vibe, Cursor, Windsurf, and any MCP client.",
   "main": "dist/index.js",
@@ -47,7 +47,7 @@
   "dependencies": {
     "@modelcontextprotocol/ext-apps": "^2.0.0",
     "@modelcontextprotocol/sdk": "^1.31.0",
-    "minutes-sdk": "0.28.2",
+    "minutes-sdk": "0.29.0",
     "yaml": "^2.8.3",
     "zod": "^3.25 || ^4.0"
   },