minutes-mcp 0.7.0 → 0.8.0

package/dist/index.d.ts

@@ -12,10 +12,14 @@
  *   - process_audio: Process an audio file through the pipeline
  *   - add_note: Add a timestamped note to a recording or meeting
  *   - consistency_report: Flag conflicting decisions and stale commitments
- *   - get_person_profile: Build a profile for a person across meetings
+ *   - get_person_profile: Rich relationship profile for a person (graph index)
+ *   - track_commitments: List open/stale commitments, filter by person
+ *   - relationship_map: All contacts with scores and losing-touch alerts
  *   - research_topic: Cross-meeting topic research
  *   - qmd_collection_status: Check QMD collection registration
  *   - register_qmd_collection: Register Minutes output as QMD collection
+ *   - list_voices: List enrolled voice profiles for speaker identification
+ *   - confirm_speaker: Confirm/correct speaker attribution in a meeting
  *
  * All tools use execFile (not exec) to shell out to the `minutes` CLI binary.
  * No shell interpolation — safe from injection.

package/dist/index.js

@@ -12,17 +12,21 @@
  *   - process_audio: Process an audio file through the pipeline
  *   - add_note: Add a timestamped note to a recording or meeting
  *   - consistency_report: Flag conflicting decisions and stale commitments
- *   - get_person_profile: Build a profile for a person across meetings
+ *   - get_person_profile: Rich relationship profile for a person (graph index)
+ *   - track_commitments: List open/stale commitments, filter by person
+ *   - relationship_map: All contacts with scores and losing-touch alerts
  *   - research_topic: Cross-meeting topic research
  *   - qmd_collection_status: Check QMD collection registration
  *   - register_qmd_collection: Register Minutes output as QMD collection
+ *   - list_voices: List enrolled voice profiles for speaker identification
+ *   - confirm_speaker: Confirm/correct speaker attribution in a meeting
  *
  * All tools use execFile (not exec) to shell out to the `minutes` CLI binary.
  * No shell interpolation — safe from injection.
  */
 import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { registerAppTool, registerAppResource, RESOURCE_MIME_TYPE, } from "@modelcontextprotocol/ext-apps/server";
+import { registerAppTool, registerAppResource, RESOURCE_MIME_TYPE, EXTENSION_ID, } from "@modelcontextprotocol/ext-apps/server";
 import { z } from "zod";
 import { execFile, spawn } from "child_process";
 import { promisify } from "util";
@@ -237,7 +241,13 @@ function validatePathInDirectories(path, roots, allowedExts) {
 // ── MCP Server ──────────────────────────────────────────────
 const server = new McpServer({
     name: "minutes",
-    version: "0.7.0",
+    version: "0.8.0",
+});
+// Declare MCP Apps extension support so hosts classify this server as interactive.
+// The `extensions` field is part of the draft MCP spec (SEP-1724) — not yet in the
+// stable SDK types, so we cast through `any`.
+server.server.registerCapabilities({
+    extensions: { [EXTENSION_ID]: {} },
 });
 // Configurable directories — override via env vars in Claude Desktop extension settings
 const MEETINGS_DIR = process.env.MEETINGS_DIR || join(homedir(), "meetings");
@@ -583,74 +593,84 @@ registerAppTool(server, "consistency_report", {
 });
 // ── Tool: get_person_profile ───────────────────────────────
 registerAppTool(server, "get_person_profile", {
-    description: "Build a first-pass profile for a person across meetings using structured intent data.",
+    description: "Get a rich relationship profile for a person: meetings, commitments, topics, relationship score, and trend. Uses the conversation graph index for instant results.",
     inputSchema: {
         name: z.string().describe("Person / attendee name to profile"),
     },
     annotations: { title: "Person Profile", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
     _meta: { ui: { resourceUri: UI_RESOURCE_URI } },
 }, async ({ name }) => {
-    // Pure-TS fallback when CLI is not available
-    if (!(await isCliAvailable())) {
-        const profile = await reader.getPersonProfile(MEETINGS_DIR, name);
-        const sections = [];
-        if (profile.topics.length > 0)
-            sections.push("Topics: " + profile.topics.join(", "));
-        if (profile.meetings.length > 0) {
-            sections.push("Meetings:\n" + profile.meetings.map((m) => `- ${m.date} — ${m.title}`).join("\n"));
+    // Try graph index first (via CLI `minutes people --json`)
+    if (await isCliAvailable()) {
+        const { stdout } = await runMinutes(["people", "--json"]);
+        const people = parseJsonOutput(stdout);
+        if (Array.isArray(people)) {
+            const nameLower = name.toLowerCase();
+            const match = people.find((p) => p.name?.toLowerCase().includes(nameLower) ||
+                p.slug?.toLowerCase().includes(nameLower));
+            if (match) {
+                const daysSince = Math.round(match.days_since || 0);
+                const last = daysSince < 1 ? "today" : daysSince < 2 ? "yesterday" : `${daysSince}d ago`;
+                const sections = [];
+                sections.push(`Relationship score: ${(match.score || 0).toFixed(1)} | ${match.meeting_count} meetings | last: ${last}`);
+                if (match.losing_touch) {
+                    sections.push("⚠ LOSING TOUCH — meeting frequency has declined");
+                }
+                if (match.top_topics?.length > 0) {
+                    sections.push("Top topics: " + match.top_topics.join(", "));
+                }
+                if (match.open_commitments > 0) {
+                    sections.push(`Open commitments: ${match.open_commitments}`);
+                }
+                return {
+                    content: [{ type: "text", text: `Profile for ${match.name}:\n\n${sections.join("\n")}` }],
+                    structuredContent: { ...match, view: "person" },
+                    _meta: { ui: { resourceUri: UI_RESOURCE_URI }, view: "person" },
+                };
+            }
         }
-        if (profile.openActions.length > 0) {
-            sections.push("Open actions:\n" + profile.openActions.map((a) => `- ${a.task} (${a.status})`).join("\n"));
+        // Fall back to legacy CLI person command for richer meeting-level data
+        const { stdout: legacyOut, stderr } = await runMinutes(["person", name]);
+        const profile = parseJsonOutput(legacyOut);
+        if (profile && typeof profile === "object") {
+            const topics = Array.isArray(profile.top_topics) ? profile.top_topics : [];
+            const openIntents = Array.isArray(profile.open_intents) ? profile.open_intents : [];
+            const recentMeetings = Array.isArray(profile.recent_meetings) ? profile.recent_meetings : [];
+            if (topics.length === 0 && openIntents.length === 0 && recentMeetings.length === 0) {
+                return {
+                    content: [{ type: "text", text: `No profile data found for ${name}.` }],
+                    structuredContent: { name, top_topics: [], open_intents: [], recent_meetings: [], view: "person" },
+                    _meta: { ui: { resourceUri: UI_RESOURCE_URI }, view: "person" },
+                };
+            }
+            const sections = [];
+            if (topics.length > 0)
+                sections.push("Top topics:\n" + topics.map((t) => `- ${t.topic} (${t.count})`).join("\n"));
+            if (openIntents.length > 0)
+                sections.push("Open commitments:\n" + openIntents.map((i) => `- ${i.kind}: ${i.what}${i.by_date ? ` by ${i.by_date}` : ""}`).join("\n"));
+            if (recentMeetings.length > 0)
+                sections.push("Recent meetings:\n" + recentMeetings.map((m) => `- ${m.date} — ${m.title}`).join("\n"));
+            return {
+                content: [{ type: "text", text: `Profile for ${profile.name}:\n\n${sections.join("\n\n")}` }],
+                structuredContent: { ...profile, view: "person" },
+                _meta: { ui: { resourceUri: UI_RESOURCE_URI }, view: "person" },
+            };
         }
-        const text = sections.length > 0 ? sections.join("\n\n") : `No profile data found for ${name}.`;
-        return {
-            content: [{ type: "text", text }],
-            structuredContent: { name, top_topics: profile.topics.map((t) => ({ topic: t, count: 1 })), open_intents: profile.openActions, recent_meetings: profile.meetings, view: "person" },
-            _meta: { ui: { resourceUri: UI_RESOURCE_URI }, view: "person" },
-        };
-    }
-    const { stdout, stderr } = await runMinutes(["person", name]);
-    const profile = parseJsonOutput(stdout);
-    if (!profile || typeof profile !== "object") {
-        return { content: [{ type: "text", text: stderr || stdout }] };
-    }
-    const topics = Array.isArray(profile.top_topics) ? profile.top_topics : [];
-    const openIntents = Array.isArray(profile.open_intents) ? profile.open_intents : [];
-    const recentMeetings = Array.isArray(profile.recent_meetings)
-        ? profile.recent_meetings
-        : [];
-    if (topics.length === 0 && openIntents.length === 0 && recentMeetings.length === 0) {
-        return {
-            content: [{ type: "text", text: `No profile data found for ${name}.` }],
-            structuredContent: { name, top_topics: [], open_intents: [], recent_meetings: [], view: "person" },
-            _meta: { ui: { resourceUri: UI_RESOURCE_URI }, view: "person" },
-        };
+        return { content: [{ type: "text", text: stderr || legacyOut || `No data found for ${name}.` }] };
     }
+    // Pure-TS fallback when CLI is not available
+    const profile = await reader.getPersonProfile(MEETINGS_DIR, name);
     const sections = [];
-    if (topics.length > 0) {
-        sections.push("Top topics:\n" +
-            topics.map((topic) => `- ${topic.topic} (${topic.count})`).join("\n"));
-    }
-    if (openIntents.length > 0) {
-        sections.push("Open commitments/actions:\n" +
-            openIntents
-                .map((intent) => `- ${intent.kind}: ${intent.what}${intent.by_date ? ` by ${intent.by_date}` : ""}`)
-                .join("\n"));
-    }
-    if (recentMeetings.length > 0) {
-        sections.push("Recent meetings:\n" +
-            recentMeetings
-                .map((meeting) => `- ${meeting.date} — ${meeting.title}`)
-                .join("\n"));
-    }
+    if (profile.topics.length > 0)
+        sections.push("Topics: " + profile.topics.join(", "));
+    if (profile.meetings.length > 0)
+        sections.push("Meetings:\n" + profile.meetings.map((m) => `- ${m.date} — ${m.title}`).join("\n"));
+    if (profile.openActions.length > 0)
+        sections.push("Open actions:\n" + profile.openActions.map((a) => `- ${a.task} (${a.status})`).join("\n"));
+    const text = sections.length > 0 ? sections.join("\n\n") : `No profile data found for ${name}.`;
     return {
-        content: [
-            {
-                type: "text",
-                text: `Profile for ${profile.name}:\n\n${sections.join("\n\n")}`,
-            },
-        ],
-        structuredContent: { ...profile, view: "person" },
+        content: [{ type: "text", text }],
+        structuredContent: { name, top_topics: profile.topics.map((t) => ({ topic: t, count: 1 })), open_intents: profile.openActions, recent_meetings: profile.meetings, view: "person" },
         _meta: { ui: { resourceUri: UI_RESOURCE_URI }, view: "person" },
     };
 });
@@ -912,6 +932,107 @@ server.tool("register_qmd_collection", "Register the Minutes output directory as
         ],
     };
 });
+// ── Tool: track_commitments ─────────────────────────────────
+registerAppTool(server, "track_commitments", {
+    description: "List open and stale commitments (action items, intents, decisions) across all meetings. Optionally filter by person. Answers: 'What did I promise Sarah?' or 'What's overdue?'",
+    inputSchema: {
+        person: z.string().optional().describe("Filter by person name or slug (optional — omit for all commitments)"),
+    },
+    annotations: { title: "Track Commitments", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    _meta: { ui: { resourceUri: UI_RESOURCE_URI } },
+}, async ({ person }) => {
+    if (!(await isCliAvailable())) {
+        return { content: [{ type: "text", text: "Minutes CLI not available. Install with: cargo install minutes-cli" }] };
+    }
+    // Use dedicated commitments command for full text detail
+    const args = ["commitments", "--json"];
+    if (person)
+        args.push("--person", person);
+    const { stdout } = await runMinutes(args);
+    const commitments = parseJsonOutput(stdout);
+    if (!Array.isArray(commitments) || commitments.length === 0) {
+        const scope = person ? ` for ${person}` : "";
+        return {
+            content: [{ type: "text", text: `No open commitments found${scope}.` }],
+            structuredContent: { commitments: [], person: person || null, view: "commitments" },
+            _meta: { ui: { resourceUri: UI_RESOURCE_URI }, view: "commitments" },
+        };
+    }
+    // Group by status
+    const stale = commitments.filter((c) => c.status === "stale");
+    const open = commitments.filter((c) => c.status === "open");
+    const lines = [];
+    if (stale.length > 0) {
+        lines.push(`STALE (${stale.length} overdue):`);
+        for (const c of stale) {
+            const who = c.person_name || "unassigned";
+            lines.push(`  ⚠ ${c.text} (${who}; due: ${c.due_date || "no date"}; from: ${c.meeting_title})`);
+        }
+    }
+    if (open.length > 0) {
+        if (stale.length > 0)
+            lines.push("");
+        lines.push(`OPEN (${open.length}):`);
+        for (const c of open) {
+            const who = c.person_name || "unassigned";
+            lines.push(`  · ${c.text} (${who}; from: ${c.meeting_title})`);
+        }
+    }
+    const text = `Commitments${person ? ` for ${person}` : ""}:\n\n${lines.join("\n")}`;
+    return {
+        content: [{ type: "text", text }],
+        structuredContent: { commitments, person: person || null, stale_count: stale.length, open_count: open.length, view: "commitments" },
+        _meta: { ui: { resourceUri: UI_RESOURCE_URI }, view: "commitments" },
+    };
+});
+// ── Tool: relationship_map ──────────────────────────────────
+registerAppTool(server, "relationship_map", {
+    description: "Show all contacts with relationship scores, meeting frequency, and 'losing touch' alerts. Overview of your entire conversation network.",
+    inputSchema: {
+        limit: z.number().optional().describe("Max people to return (default: 15)"),
+    },
+    annotations: { title: "Relationship Map", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
+    _meta: { ui: { resourceUri: UI_RESOURCE_URI } },
+}, async ({ limit }) => {
+    if (!(await isCliAvailable())) {
+        return { content: [{ type: "text", text: "Minutes CLI not available. Install with: cargo install minutes-cli" }] };
+    }
+    const maxPeople = limit || 15;
+    const { stdout } = await runMinutes(["people", "--json", "--limit", String(maxPeople)]);
+    const people = parseJsonOutput(stdout);
+    if (!Array.isArray(people) || people.length === 0) {
+        return {
+            content: [{ type: "text", text: "No relationship data found. Run: minutes people --rebuild" }],
+            structuredContent: { people: [], view: "relationship_map" },
+            _meta: { ui: { resourceUri: UI_RESOURCE_URI }, view: "relationship_map" },
+        };
+    }
+    // Format human-readable output
+    const lines = [];
+    const losingTouch = [];
+    for (const p of people) {
+        const daysSince = Math.round(p.days_since || 0);
+        const last = daysSince < 1 ? "today" : daysSince < 2 ? "yesterday" : `${daysSince}d ago`;
+        const status = p.losing_touch
+            ? "⚠ losing touch"
+            : p.open_commitments > 0
+                ? `${p.open_commitments} open commitment${p.open_commitments !== 1 ? "s" : ""}`
+                : "✓ all clear";
+        lines.push(`${p.name} — ${p.meeting_count} meetings, last: ${last}, ${status} (score: ${(p.score || 0).toFixed(1)})`);
+        if (p.losing_touch) {
+            losingTouch.push(`${p.name} — ${p.meeting_count} meetings total, last seen ${daysSince}d ago`);
+        }
+    }
+    let text = `Relationship Map (${people.length} contacts):\n\n${lines.join("\n")}`;
+    if (losingTouch.length > 0) {
+        text += `\n\nLosing Touch:\n${losingTouch.join("\n")}`;
+    }
+    return {
+        content: [{ type: "text", text }],
+        structuredContent: { people, view: "relationship_map" },
+        _meta: { ui: { resourceUri: UI_RESOURCE_URI }, view: "relationship_map" },
+    };
+});
 // ── Resources ───────────────────────────────────────────────
 server.resource("recent_meetings", "minutes://meetings/recent", { description: "List of recent meetings and memos" }, async () => {
     if (!(await isCliAvailable())) {
@@ -1069,6 +1190,53 @@ server.tool("stop_dictation", "Stop the current dictation session.", {}, { title
         ],
     };
 });
+// ── Tool: list_voices ────────────────────────────────────────
+server.tool("list_voices", "List enrolled voice profiles for speaker identification. Shows who has been enrolled, sample count, and model version.", {}, { title: "Voice Profiles", readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false }, async () => {
+    if (!(await isCliAvailable())) {
+        return { content: [{ type: "text", text: "Minutes CLI not available." }] };
+    }
+    const { stdout, stderr } = await runMinutes(["voices", "--json"]);
+    const profiles = parseJsonOutput(stdout);
+    if (!Array.isArray(profiles) || profiles.length === 0) {
+        return {
+            content: [{ type: "text", text: "No voice profiles enrolled. The user can enroll with: minutes enroll" }],
+        };
+    }
+    const lines = profiles.map((p) => `${p.name} — ${p.sample_count} samples, ${p.source} (${p.model_version})`);
+    return {
+        content: [{ type: "text", text: `Voice profiles (${profiles.length}):\n\n${lines.join("\n")}` }],
+        structuredContent: { profiles, view: "voices" },
+    };
+});
+// ── Tool: confirm_speaker ────────────────────────────────────
+server.tool("confirm_speaker", "Confirm or correct a speaker attribution in a meeting. Promotes the attribution to High confidence and rewrites the transcript label. Optionally saves the speaker's voice profile for future meetings.", {
+    meeting: z.string().describe("Path to the meeting markdown file"),
+    speaker_label: z.string().describe("Speaker label to confirm (e.g., SPEAKER_1)"),
+    name: z.string().describe("Real name to assign to this speaker"),
+    save_voice: z.boolean().optional().default(false).describe("Save this speaker's voice profile for future automatic identification"),
+}, { title: "Confirm Speaker", readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false }, async ({ meeting, speaker_label, name, save_voice }) => {
+    if (!(await isCliAvailable())) {
+        return { content: [{ type: "text", text: "Minutes CLI not available." }] };
+    }
+    const args = ["confirm", "--meeting", meeting, "--speaker", speaker_label, "--name", name];
+    if (save_voice)
+        args.push("--save-voice");
+    try {
+        const { stdout, stderr } = await runMinutes(args);
+        const output = (stderr || stdout || "").trim();
+        return {
+            content: [{ type: "text", text: output || `Confirmed: ${speaker_label} = ${name}` }],
+            structuredContent: { meeting, speaker_label, name, save_voice, confirmed: true },
+        };
+    }
+    catch (error) {
+        const msg = error?.stderr || error?.message || String(error);
+        return {
+            content: [{ type: "text", text: `Failed to confirm speaker: ${msg}` }],
+            isError: true,
+        };
+    }
+});
 // ── Start server ────────────────────────────────────────────
 async function main() {
     const transport = new StdioServerTransport();