minutes-mcp 0.13.2 → 0.13.3

package/dist/index.d.ts

@@ -32,4 +32,5 @@ export type KnowledgeConfigStatus = {
     adapter: string;
     engine: string;
 };
+export declare function shouldRunMainEntry(argv1: string | null | undefined, moduleFilename: string): boolean;
 export declare function parseKnowledgeConfig(configContent: string): KnowledgeConfigStatus | null;

package/dist/index.js

@@ -37,7 +37,7 @@ import { registerAppTool, registerAppResource, RESOURCE_MIME_TYPE, EXTENSION_ID,
 import { z } from "zod";
 import { execFile, spawn } from "child_process";
 import { promisify } from "util";
-import { existsSync } from "fs";
+import { copyFileSync, existsSync, mkdirSync, readdirSync, realpathSync } from "fs";
 import { mkdir, readFile, rm, writeFile } from "fs/promises";
 import { delimiter, dirname, join, resolve } from "path";
 import { fileURLToPath } from "url";
@@ -45,6 +45,73 @@ import { homedir } from "os";
 import * as reader from "minutes-sdk";
 import { canonicalizeRoot, expandHomeLikePath, validatePathInDirectories, validatePathInDirectory, } from "./paths.js";
 crashTrace("imports-complete");
+// ── Demo mode (--demo flag) ────────────────────────────────
+// `npx minutes-mcp --demo` is a one-shot setup: copies bundled fixture
+// meetings to ~/.minutes/demo/, prints the MCP config snippet with an explicit
+// MEETINGS_DIR env override, prints suggested questions, and exits 0.
+//
+// The printed config uses env:{ MEETINGS_DIR } pointing at the demo dir. No
+// separate --demo flag at runtime. The MCP host just launches standard
+// `minutes-mcp`; the env override is what routes it at the demo corpus. This
+// avoids the TTY-detection ambiguity that an earlier dual-mode design had.
+//
+// Guarded on `--demo` AND on being the actual entry point so importers don't
+// trigger disk side effects by mistake.
+const IS_ENTRY_POINT = Boolean(process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url));
+if (IS_ENTRY_POINT && process.argv.includes("--demo")) {
+    handleDemoSetup();
+}
+function handleDemoSetup() {
+    const demoDir = join(homedir(), ".minutes", "demo");
+    const here = dirname(fileURLToPath(import.meta.url));
+    // Package layout after build: dist/index.js; fixtures live at
+    // <pkg>/fixtures/demo/ next to dist/.
+    const fixturesSrc = resolve(here, "..", "fixtures", "demo");
+    if (!existsSync(fixturesSrc)) {
+        console.error(`[minutes-mcp --demo] bundled fixtures not found at ${fixturesSrc}. ` +
+            `This build of minutes-mcp is missing the demo corpus. ` +
+            `Try upgrading with: npm install -g minutes-mcp@latest`);
+        process.exit(1);
+    }
+    mkdirSync(demoDir, { recursive: true });
+    for (const entry of readdirSync(fixturesSrc)) {
+        if (!entry.endsWith(".md"))
+            continue;
+        copyFileSync(join(fixturesSrc, entry), join(demoDir, entry));
+    }
+    // The config snippet embeds the fully-resolved demoDir so users don't have
+    // to fill it in manually. MCP hosts inject this env when launching the
+    // server; the server's existing MEETINGS_DIR logic (line ~800) picks it up.
+    const configSnippet = JSON.stringify({
+        mcpServers: {
+            "minutes-demo": {
+                command: "npx",
+                args: ["minutes-mcp"],
+                env: {
+                    MEETINGS_DIR: demoDir,
+                },
+            },
+        },
+    }, null, 2);
+    console.log("");
+    console.log("Demo corpus ready at: " + demoDir);
+    console.log("5 fixture meetings with a pricing reversal, a customer commitment that slips, and a feature cut.");
+    console.log("");
+    console.log("═══ MCP config (paste into Claude Desktop, Cursor, Claude Code, or any MCP client) ═══");
+    console.log(configSnippet);
+    console.log("");
+    console.log("═══ Try asking your agent ═══");
+    console.log("  • List the meetings in this corpus.");
+    console.log("  • What did we decide about pricing? Which decision is current?");
+    console.log("  • What got killed in the last product prioritization meeting?");
+    console.log("  • What action items are still open, and who owns each?");
+    console.log("  • Summarize the Northwind customer thread.");
+    console.log("");
+    console.log("Note: some structured tools (consistency report, person profile) auto-install the Minutes CLI on first use.");
+    console.log("Full setup (real audio capture, transcription, real meetings): https://useminutes.app");
+    console.log("");
+    process.exit(0);
+}
 const UI_RESOURCE_URI = "ui://minutes/dashboard";
 const MCP_TOOLS_DOCS_BASE_URL = "https://useminutes.app/docs/mcp/tools";
 export const MEETING_INSIGHT_KINDS = ["decision", "commitment", "question"];
@@ -146,6 +213,22 @@ async function triggerQmdIndex() {
 // ESM-compatible __dirname
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
+function canonicalEntrypointPath(filePath) {
+    if (!filePath)
+        return null;
+    const resolved = resolve(filePath);
+    try {
+        return realpathSync(resolved);
+    }
+    catch {
+        return resolved;
+    }
+}
+export function shouldRunMainEntry(argv1, moduleFilename) {
+    const entryPath = canonicalEntrypointPath(argv1);
+    const modulePath = canonicalEntrypointPath(moduleFilename);
+    return !!entryPath && !!modulePath && entryPath === modulePath;
+}
 // ── Extension runtime detection ───────────────────────────────
 // When running as a Claude Desktop extension (.mcpb), Claude uses its built-in
 // Node.js runtime.  Child processes spawned from that runtime land in a
@@ -199,7 +282,7 @@ function findMinutesBinary() {
 }
 let MINUTES_BIN = findMinutesBinary();
 // ── Expected CLI version (must match this MCP server release) ──
-const MCP_SERVER_VERSION = "0.13.2";
+const MCP_SERVER_VERSION = "0.13.3";
 const EXPECTED_CLI_VERSION = MCP_SERVER_VERSION;
 export function parseKnowledgeConfig(configContent) {
     const knowledgeMatch = configContent.match(/\[knowledge\][\s\S]*?(?=\n\[|$)/);
@@ -2134,9 +2217,9 @@ crashTrace("pre-main-guard", {
     argv1: process.argv[1] ?? null,
     resolvedArgv1: process.argv[1] ? resolve(process.argv[1]) : null,
     __filename,
-    match: process.argv[1] ? resolve(process.argv[1]) === __filename : false,
+    match: shouldRunMainEntry(process.argv[1], __filename),
 });
-if (process.argv[1] && resolve(process.argv[1]) === __filename) {
+if (shouldRunMainEntry(process.argv[1], __filename)) {
     main().catch((error) => {
         crashTrace("main-rejected", error);
         console.error("Fatal error:", error);

package/fixtures/demo/2026-02-28-pricing-strategy.md

@@ -0,0 +1,47 @@
+---
+title: Pricing Strategy — Monthly Billing Test
+type: meeting
+minutes_demo: true
+date: 2026-02-28T10:00:00-07:00
+duration: 48m
+attendees: [Mat S., Alex K., Jordan M.]
+people: [mat, alex, jordan]
+tags: [pricing, gtm, experiment]
+decisions:
+  - text: Launch monthly billing alongside annual, starting with the next three consultant signups
+    topic: pricing
+    authority: high
+action_items:
+  - assignee: jordan
+    task: Draft monthly billing landing copy
+    due: 2026-03-07
+    status: open
+  - assignee: alex
+    task: Wire monthly price into Stripe
+    due: 2026-03-10
+    status: open
+speaker_map:
+  - speaker_label: SPEAKER_0
+    name: mat
+    confidence: high
+    source: manual
+  - speaker_label: SPEAKER_1
+    name: alex
+    confidence: high
+    source: manual
+  - speaker_label: SPEAKER_2
+    name: jordan
+    confidence: high
+    source: manual
+---
+
+## Summary
+
+- Seven consultants pushed back on annual this month. Testing monthly for the segment.
+- Decision: monthly billing for the next three consultant signups. Annual stays default for enterprise.
+
+## Transcript
+
+[SPEAKER_0 0:00] Let's talk pricing. Seven consultants this month pushed back on annual.
+[SPEAKER_1 0:31] Monthly kills payback. Breakeven moves from 11 months to 14.
+[SPEAKER_0 1:02] Run it narrow. Next three consultant signups get monthly. Annual stays default for enterprise. Reassess Q2.

package/fixtures/demo/2026-03-04-northwind-call.md

@@ -0,0 +1,43 @@
+---
+title: Northwind Customer Call — SSO Friction
+type: meeting
+minutes_demo: true
+date: 2026-03-04T15:30:00-07:00
+duration: 31m
+attendees: [Mat S., Riley B.]
+people: [mat, riley]
+tags: [customer, northwind, onboarding, retention]
+decisions:
+  - text: Ship SSO nested-groups fix for Northwind-shaped accounts before end of Q1 (2026-03-31)
+    topic: sso
+    authority: high
+action_items:
+  - assignee: mat
+    task: Fix SSO nested-groups onboarding for Northwind
+    due: 2026-03-31
+    status: open
+    promised_to: riley
+speaker_map:
+  - speaker_label: SPEAKER_0
+    name: mat
+    confidence: high
+    source: manual
+  - speaker_label: SPEAKER_1
+    name: riley
+    confidence: high
+    source: manual
+---
+
+## Summary
+
+- Riley (Northwind, Director of Ops) frustrated. SSO nested-groups failing for their Okta setup.
+- Mat personally committed to ship the fix before 2026-03-31.
+- Riley used the word "churn" twice unprompted.
+
+## Transcript
+
+[SPEAKER_1 0:00] Half of our eighteen people bounced at SSO this month. I can't keep selling this.
+[SPEAKER_0 0:22] What's the failure point?
+[SPEAKER_1 0:29] Okta nested groups. Your product expects flat users.
+[SPEAKER_0 0:49] End of the quarter. March 31. That's a personal commitment from me.
+[SPEAKER_1 1:02] If it slips, we're going to have a different conversation in Q2.

package/fixtures/demo/2026-03-11-eng-standup.md

@@ -0,0 +1,37 @@
+---
+title: Eng Standup — Alex Takes SSO
+type: meeting
+minutes_demo: true
+date: 2026-03-11T09:30:00-07:00
+duration: 22m
+attendees: [Mat S., Alex K., Sam W.]
+people: [mat, alex, sam]
+tags: [engineering, sso, standup]
+decisions:
+  - text: Alex owns SSO nested-groups support, targeting ship by 2026-03-25
+    topic: sso
+    authority: high
+action_items:
+  - assignee: alex
+    task: Ship SSO nested-groups support
+    due: 2026-03-25
+    status: open
+speaker_map:
+  - speaker_label: SPEAKER_0
+    name: mat
+    confidence: high
+    source: manual
+  - speaker_label: SPEAKER_1
+    name: alex
+    confidence: high
+    source: manual
+---
+
+## Summary
+
+- Alex took SSO nested-groups. Target ship 2026-03-25, buffer before the Northwind-promised 2026-03-31.
+
+## Transcript
+
+[SPEAKER_0 0:00] I need status on SSO nested groups. Committed to Riley, March 31.
+[SPEAKER_1 0:11] I can take it. Week of work. Target March 25, gives a week of slack.

package/fixtures/demo/2026-03-25-pricing-reversal.md

@@ -0,0 +1,44 @@
+---
+title: Pricing Follow-up — Reverse the Monthly Experiment
+type: meeting
+minutes_demo: true
+date: 2026-03-25T10:00:00-07:00
+duration: 34m
+attendees: [Mat S., Alex K., Jordan M.]
+people: [mat, alex, jordan]
+tags: [pricing, gtm, decision-reversal]
+decisions:
+  - text: Revert to annual-only billing across all segments. Monthly billing experiment did not generate enough signups to justify the payback hit.
+    topic: pricing
+    authority: high
+    supersedes: "2026-02-28 monthly billing decision"
+action_items:
+  - assignee: jordan
+    task: Pull monthly billing from the landing page
+    due: 2026-03-27
+    status: open
+speaker_map:
+  - speaker_label: SPEAKER_0
+    name: mat
+    confidence: high
+    source: manual
+  - speaker_label: SPEAKER_1
+    name: alex
+    confidence: high
+    source: manual
+  - speaker_label: SPEAKER_2
+    name: jordan
+    confidence: high
+    source: manual
+---
+
+## Summary
+
+- Four monthly signups in three weeks, below the 12 threshold. Churn on the four tracking worse than baseline.
+- Decision: revert to annual-only. Explicitly supersedes the 2026-02-28 launch decision.
+
+## Transcript
+
+[SPEAKER_2 0:00] Four monthly signups in three weeks. The threshold was twelve.
+[SPEAKER_1 0:14] Churn on the four is worse than annual baseline. Two of four canceled before month two.
+[SPEAKER_0 0:47] To be clear: we are reversing the 2026-02-28 decision. Going annual-only, effective immediately.

package/fixtures/demo/2026-04-17-prioritization.md

@@ -0,0 +1,52 @@
+---
+title: Product Prioritization — Q2 Cut Lines
+type: meeting
+minutes_demo: true
+date: 2026-04-17T13:00:00-07:00
+duration: 58m
+attendees: [Mat S., Alex K., Sam W., Jordan M.]
+people: [mat, alex, sam, jordan]
+tags: [product, prioritization, q2, roadmap]
+decisions:
+  - text: Kill the advanced analytics feature. It was on the Q2 roadmap; it is no longer.
+    topic: advanced-analytics
+    authority: high
+  - text: Keep team billing as the primary Q2 engineering investment
+    topic: team-billing
+    authority: high
+  - text: Ship a scoped reporting-exports fix in Q2. Date-ranged CSV export, no dashboard, no visualizations.
+    topic: reporting-exports
+    authority: high
+action_items:
+  - assignee: sam
+    task: Remove advanced analytics mockups from the product roadmap page
+    due: 2026-04-18
+    status: open
+  - assignee: alex
+    task: Ship scoped reporting-exports (date-ranged CSV) by 2026-05-02
+    due: 2026-05-02
+    status: open
+speaker_map:
+  - speaker_label: SPEAKER_0
+    name: mat
+    confidence: high
+    source: manual
+  - speaker_label: SPEAKER_1
+    name: alex
+    confidence: high
+    source: manual
+---
+
+## Summary
+
+- Advanced analytics cut from Q2 roadmap.
+- Team billing stays as primary Q2 investment.
+- Reporting exports get a scoped green-light: date-ranged CSV only, two weeks of engineering, ship 2026-05-02.
+
+## Transcript
+
+[SPEAKER_0 0:00] Three things on the table. Advanced analytics, team billing, reporting exports.
+[SPEAKER_1 0:08] Kill analytics. No customer pulling for it.
+[SPEAKER_0 0:34] Killed. Team billing stays, on track for April 15. Reporting exports scoped: date-ranged CSV, no dashboard.
+[SPEAKER_1 1:02] Two weeks if it's literally date filter + CSV.
+[SPEAKER_0 1:14] Scope locked. Ship by May 2.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "minutes-mcp",
-  "version": "0.13.2",
+  "version": "0.13.3",
   "description": "MCP server for minutes — conversation memory for AI assistants. Works with Claude Desktop, Mistral Vibe, Cursor, Windsurf, and any MCP client.",
   "main": "dist/index.js",
   "type": "module",
@@ -10,6 +10,7 @@
   "files": [
     "dist/",
     "dist-ui/",
+    "fixtures/",
     "LICENSE"
   ],
   "keywords": [
@@ -40,7 +41,7 @@
   "dependencies": {
     "@modelcontextprotocol/ext-apps": "^1.6.0",
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "minutes-sdk": "^0.13.1",
+    "minutes-sdk": "^0.13.3",
     "yaml": "^2.8.3",
     "zod": "^3.25 || ^4.0"
   },