mrvn-cli 0.1.0 → 0.1.2

package/dist/marvin.js

@@ -14029,6 +14029,72 @@ function createMeetingTools(store) {
           ]
         };
       }
+    ),
+    tool(
+      "analyze_meeting",
+      "Analyze a meeting to identify decisions, actions, and questions. Returns the meeting content with existing project context so you can extract and create artifacts using the create_decision, create_action, and create_question tools.",
+      {
+        id: external_exports.string().describe("Meeting ID to analyze (e.g. 'M-001')"),
+        include_context: external_exports.boolean().optional().describe("Include existing artifacts for dedup awareness (default: true)")
+      },
+      async (args) => {
+        const doc = store.get(args.id);
+        if (!doc) {
+          return {
+            content: [{ type: "text", text: `Meeting ${args.id} not found` }],
+            isError: true
+          };
+        }
+        if (doc.frontmatter.type !== "meeting") {
+          return {
+            content: [{ type: "text", text: `Document ${args.id} is not a meeting (type: ${doc.frontmatter.type})` }],
+            isError: true
+          };
+        }
+        const includeContext = args.include_context !== false;
+        const sections = [];
+        sections.push(`# Meeting: ${doc.frontmatter.title} (${args.id})`);
+        sections.push(`**Status:** ${doc.frontmatter.status}`);
+        sections.push(`**Date:** ${doc.frontmatter.date ?? doc.frontmatter.created}`);
+        if (doc.frontmatter.attendees) {
+          sections.push(`**Attendees:** ${doc.frontmatter.attendees.join(", ")}`);
+        }
+        sections.push("");
+        sections.push(doc.content);
+        if (includeContext) {
+          const decisions = store.list({ type: "decision" });
+          const actions = store.list({ type: "action" });
+          const questions = store.list({ type: "question" });
+          sections.push("\n---\n# Existing Artifacts (for dedup awareness)");
+          if (decisions.length > 0) {
+            sections.push("\n## Existing Decisions");
+            for (const d of decisions) {
+              sections.push(`- ${d.frontmatter.id}: ${d.frontmatter.title} [${d.frontmatter.status}]`);
+            }
+          }
+          if (actions.length > 0) {
+            sections.push("\n## Existing Actions");
+            for (const a of actions) {
+              sections.push(`- ${a.frontmatter.id}: ${a.frontmatter.title} [${a.frontmatter.status}]`);
+            }
+          }
+          if (questions.length > 0) {
+            sections.push("\n## Existing Questions");
+            for (const q of questions) {
+              sections.push(`- ${q.frontmatter.id}: ${q.frontmatter.title} [${q.frontmatter.status}]`);
+            }
+          }
+        }
+        sections.push("\n---\n# Instructions");
+        sections.push(`Analyze this meeting and create artifacts using create_decision, create_action, and create_question tools.`);
+        sections.push(`For each artifact, include the tag "source:${args.id}" for traceability.`);
+        sections.push(`After creating artifacts, update the meeting using update_meeting to append an Outcomes section listing the created artifact IDs.`);
+        sections.push(`Avoid creating duplicates of existing artifacts listed above.`);
+        return {
+          content: [{ type: "text", text: sections.join("\n") }]
+        };
+      },
+      { annotations: { readOnly: true } }
     )
   ];
 }
@@ -14627,6 +14693,7 @@ var genericAgilePlugin = {
 - **list_meetings** / **get_meeting**: Browse and read meeting records.
 - **create_meeting**: Record new meetings with attendees, date, and agenda.
 - **update_meeting**: Update meeting status or notes after completion.
+- **analyze_meeting**: Analyze a meeting to review its outcomes and extract artifacts.
 
 **Key Workflow Rules:**
 - Create features as "draft" and approve them when requirements are clear and prioritized.
@@ -14647,6 +14714,7 @@ var genericAgilePlugin = {
 - **list_meetings** / **get_meeting**: Browse and read meeting records.
 - **create_meeting**: Record new meetings with attendees, date, and agenda.
 - **update_meeting**: Update meeting status or notes after completion.
+- **analyze_meeting**: Analyze a meeting to review its outcomes and extract artifacts.
 
 **Key Workflow Rules:**
 - Only create epics against approved features \u2014 create_epic enforces this.
@@ -14674,11 +14742,13 @@ var genericAgilePlugin = {
 - **list_meetings** / **get_meeting**: Browse and read meeting records.
 - **create_meeting**: Record new meetings with attendees, date, and agenda.
 - **update_meeting**: Update meeting status or notes after completion.
+- **analyze_meeting**: Analyze a completed meeting to extract decisions, actions, and questions. Use this to ensure meeting outcomes are properly tracked as governance artifacts.
 
 **Key Workflow Rules:**
 - After generating any report, offer to save it with save_report for audit trail.
 - Proactively flag risks: unowned actions, overdue items, epics linked to deferred features.
-- Use feature progress reports for stakeholder updates and epic progress for sprint-level tracking.`,
+- Use feature progress reports for stakeholder updates and epic progress for sprint-level tracking.
+- Use analyze_meeting after meetings to extract outcomes into governance artifacts.`,
     "*": `You have access to feature, epic, and meeting tools for project coordination:
 
 **Features** (F-xxx): Product capabilities defined by the Product Owner. Features progress through draft \u2192 approved \u2192 done.
@@ -14689,7 +14759,8 @@ var genericAgilePlugin = {
 
 - **list_meetings** / **get_meeting**: Browse and read meeting records.
 - **create_meeting**: Record meetings with attendees, date, and agenda.
-- **update_meeting**: Update meeting status or notes.`
+- **update_meeting**: Update meeting status or notes.
+- **analyze_meeting**: Analyze a meeting to extract decisions, actions, and questions as governance artifacts.`
   }
 };
 
@@ -15975,9 +16046,9 @@ var DocumentStore = class {
       }
     }
   }
-  list(query5) {
+  list(query6) {
     const results = [];
-    const types = query5?.type ? [query5.type] : Object.keys(this.typeDirs);
+    const types = query6?.type ? [query6.type] : Object.keys(this.typeDirs);
     for (const type of types) {
       const dirName = this.typeDirs[type];
       if (!dirName) continue;
@@ -15988,9 +16059,9 @@ var DocumentStore = class {
         const filePath = path5.join(dir, file2);
         const raw = fs5.readFileSync(filePath, "utf-8");
         const doc = parseDocument(raw, filePath);
-        if (query5?.status && doc.frontmatter.status !== query5.status) continue;
-        if (query5?.owner && doc.frontmatter.owner !== query5.owner) continue;
-        if (query5?.tag && (!doc.frontmatter.tags || !doc.frontmatter.tags.includes(query5.tag)))
+        if (query6?.status && doc.frontmatter.status !== query6.status) continue;
+        if (query6?.owner && doc.frontmatter.owner !== query6.owner) continue;
+        if (query6?.tag && (!doc.frontmatter.tags || !doc.frontmatter.tags.includes(query6.tag)))
           continue;
         results.push(doc);
       }
@@ -17232,6 +17303,7 @@ Marvin \u2014 ${persona.name}
       "mcp__marvin-governance__get_source_info",
       "mcp__marvin-governance__list_sessions",
       "mcp__marvin-governance__get_session",
+      "mcp__marvin-governance__analyze_meeting",
       ...pluginTools.map((t) => `mcp__marvin-governance__${t.name}`),
       ...codeSkillTools.map((t) => `mcp__marvin-governance__${t.name}`),
       ...actionTools.map((t) => `mcp__marvin-governance__${t.name}`)
@@ -18922,6 +18994,263 @@ async function importCommand(inputPath, options) {
   }
 }
 
+// src/cli/commands/analyze.ts
+import chalk13 from "chalk";
+
+// src/analysis/analyze.ts
+import chalk12 from "chalk";
+import ora4 from "ora";
+import { query as query5 } from "@anthropic-ai/claude-agent-sdk";
+
+// src/analysis/prompts.ts
+function buildAnalyzeSystemPrompt(persona, projectConfig, isDraft) {
+  const parts = [];
+  parts.push(persona.systemPrompt);
+  parts.push(`
+## Project Context
+- **Project Name:** ${projectConfig.name}
+- **Methodology:** ${projectConfig.methodology ?? "Generic Agile"}
+`);
+  parts.push(`
+## Meeting Analysis Task
+You are analyzing a meeting record to extract governance artifacts for the project.
+Review the meeting content thoroughly and identify:
+
+1. **Decisions** (D-xxx): Any decisions made during the meeting \u2014 architectural choices, process agreements, technology selections, or resolved discussion points.
+2. **Actions** (A-xxx): Tasks assigned, follow-ups agreed upon, work items to be done, or commitments made during the meeting.
+3. **Questions** (Q-xxx): Open questions raised, unresolved discussion points, items needing further investigation, or clarifications needed.
+
+For each artifact, provide:
+- A clear, concise title
+- Detailed content with rationale or context from the meeting discussion
+- Appropriate status (decisions: "decided" or "open"; actions: "open"; questions: "open")
+- Relevant tags for categorization
+`);
+  if (isDraft) {
+    parts.push(`
+## Mode: Draft Proposal
+Present your findings as a structured proposal. Do NOT create any artifacts.
+Format your response as:
+
+### Proposed Decisions
+For each decision:
+- **Title:** [title]
+- **Status:** [decided/open]
+- **Content:** [description and rationale from the meeting]
+- **Tags:** [comma-separated tags]
+
+### Proposed Actions
+For each action:
+- **Title:** [title]
+- **Assignee:** [who was assigned, if mentioned]
+- **Content:** [what needs to be done]
+- **Tags:** [comma-separated tags]
+
+### Proposed Questions
+For each question:
+- **Title:** [title]
+- **Content:** [what needs clarification and why]
+- **Tags:** [comma-separated tags]
+
+### Summary
+Provide a brief summary of the meeting outcomes and any recommendations.
+`);
+  } else {
+    parts.push(`
+## Mode: Direct Creation
+Use the MCP tools to create artifacts directly:
+- Use \`create_decision\` for decisions
+- Use \`create_action\` for action items
+- Use \`create_question\` for questions
+
+Before creating artifacts, check existing ones using the list tools to avoid duplicates.
+
+For EVERY artifact you create, include:
+- A \`source:<meeting-id>\` tag in the tags array (the meeting ID is provided in the user prompt)
+- Clear title and detailed content with context from the meeting
+
+After creating all artifacts, provide a summary of what was created.
+`);
+  }
+  return parts.join("\n");
+}
+function buildAnalyzeUserPrompt(meetingId, meetingContent, meetingTitle, isDraft) {
+  const mode = isDraft ? "propose" : "create";
+  return `Please analyze the following meeting record and ${mode} governance artifacts (decisions, actions, questions) based on its content.
+
+**Meeting ID:** ${meetingId}
+**Meeting Title:** ${meetingTitle}
+
+---
+${meetingContent}
+---
+
+Analyze this meeting thoroughly and ${mode} all relevant governance artifacts. Tag each artifact with "source:${meetingId}" for traceability back to this meeting.`;
+}
+
+// src/analysis/analyze.ts
+async function analyzeMeeting(options) {
+  const { marvinDir, meetingId, draft, persona: personaInput } = options;
+  const config2 = getConfig(marvinDir);
+  const personaId = resolvePersonaId(personaInput);
+  const persona = getPersona(personaId);
+  const plugin = resolvePlugin(config2.project.methodology);
+  const registrations = plugin?.documentTypeRegistrations ?? [];
+  const store = new DocumentStore(marvinDir, registrations);
+  const meetingDoc = store.get(meetingId);
+  if (!meetingDoc) {
+    throw new Error(`Meeting ${meetingId} not found`);
+  }
+  if (meetingDoc.frontmatter.type !== "meeting") {
+    throw new Error(`Document ${meetingId} is not a meeting (type: ${meetingDoc.frontmatter.type})`);
+  }
+  const createdArtifacts = [];
+  if (!draft) {
+    const originalCreate = store.create.bind(store);
+    store.create = (type, frontmatter, content) => {
+      const tags = frontmatter.tags ?? [];
+      const sourceTag = `source:${meetingId}`;
+      if (!tags.includes(sourceTag)) {
+        tags.push(sourceTag);
+      }
+      const doc = originalCreate(type, { ...frontmatter, source: meetingId, tags }, content);
+      createdArtifacts.push(doc.frontmatter.id);
+      return doc;
+    };
+  }
+  const pluginTools = plugin ? getPluginTools(plugin, store, marvinDir) : [];
+  const mcpServer = createMarvinMcpServer(store, { pluginTools });
+  const systemPrompt = buildAnalyzeSystemPrompt(persona, config2.project, draft);
+  const userPrompt = buildAnalyzeUserPrompt(
+    meetingId,
+    meetingDoc.content,
+    meetingDoc.frontmatter.title,
+    draft
+  );
+  const spinner = ora4({ text: `Analyzing meeting ${meetingId}...`, color: "cyan" });
+  spinner.start();
+  try {
+    const conversation = query5({
+      prompt: userPrompt,
+      options: {
+        systemPrompt,
+        mcpServers: { "marvin-governance": mcpServer },
+        permissionMode: "acceptEdits",
+        maxTurns: 10,
+        tools: [],
+        allowedTools: [
+          "mcp__marvin-governance__create_decision",
+          "mcp__marvin-governance__create_action",
+          "mcp__marvin-governance__create_question",
+          "mcp__marvin-governance__list_decisions",
+          "mcp__marvin-governance__list_actions",
+          "mcp__marvin-governance__list_questions"
+        ]
+      }
+    });
+    for await (const message of conversation) {
+      handleAnalyzeMessage(message, spinner);
+    }
+    if (!draft && createdArtifacts.length > 0) {
+      appendOutcomesToMeeting(store, meetingDoc.frontmatter.id, meetingDoc.content, createdArtifacts, store);
+    }
+    spinner.stop();
+    if (draft) {
+      console.log(chalk12.dim(`
+Draft proposal complete. No artifacts were created.`));
+      console.log(chalk12.dim(`Use "marvin analyze ${meetingId} --no-draft" to create artifacts.`));
+    } else {
+      console.log(chalk12.green(`
+Created ${createdArtifacts.length} artifact${createdArtifacts.length === 1 ? "" : "s"} from meeting ${meetingId}`));
+      if (createdArtifacts.length > 0) {
+        console.log(chalk12.dim(`  ${createdArtifacts.join(", ")}`));
+      }
+    }
+    return { meetingId, artifacts: createdArtifacts, draft };
+  } catch (err) {
+    spinner.stop();
+    throw err;
+  }
+}
+function appendOutcomesToMeeting(store, meetingId, existingContent, artifacts, storeInstance) {
+  const outcomeLines = artifacts.map((id) => {
+    const doc = storeInstance.get(id);
+    const title = doc ? doc.frontmatter.title : id;
+    return `- ${id}: ${title}`;
+  });
+  const outcomesSection = `
+
+## Outcomes
+${outcomeLines.join("\n")}`;
+  const updatedContent = existingContent + outcomesSection;
+  store.update(meetingId, {}, updatedContent);
+}
+function handleAnalyzeMessage(message, spinner) {
+  switch (message.type) {
+    case "assistant": {
+      spinner.stop();
+      const textBlocks = message.message.content.filter(
+        (b) => b.type === "text"
+      );
+      if (textBlocks.length > 0) {
+        console.log(
+          chalk12.cyan("\nMarvin: ") + textBlocks.map((b) => b.text).join("\n")
+        );
+      }
+      break;
+    }
+    case "system": {
+      if (message.subtype === "init") {
+        spinner.start("Analyzing...");
+      }
+      break;
+    }
+    case "result": {
+      spinner.stop();
+      if (message.subtype !== "success") {
+        console.log(
+          chalk12.red(`
+Analysis ended with error: ${message.subtype}`)
+        );
+      }
+      break;
+    }
+  }
+}
+
+// src/cli/commands/analyze.ts
+async function analyzeCommand(meetingId, options) {
+  const project = loadProject();
+  const marvinDir = project.marvinDir;
+  const config2 = getConfig(marvinDir);
+  const plugin = resolvePlugin(config2.project.methodology);
+  const registrations = plugin?.documentTypeRegistrations ?? [];
+  const store = new DocumentStore(marvinDir, registrations);
+  const meetingDoc = store.get(meetingId);
+  if (!meetingDoc) {
+    console.log(chalk13.red(`Meeting ${meetingId} not found.`));
+    console.log(chalk13.dim(`Use "marvin chat --as dm" to create meetings, or check the ID.`));
+    return;
+  }
+  if (meetingDoc.frontmatter.type !== "meeting") {
+    console.log(chalk13.red(`Document ${meetingId} is not a meeting (type: ${meetingDoc.frontmatter.type}).`));
+    return;
+  }
+  const isDraft = options.draft !== false;
+  const persona = options.as ?? "delivery-manager";
+  console.log(chalk13.bold(`
+Analyzing meeting: ${meetingDoc.frontmatter.title}`));
+  console.log(chalk13.dim(`Mode: ${isDraft ? "draft (propose only)" : "direct (create artifacts)"}`));
+  console.log(chalk13.dim(`Persona: ${persona}
+`));
+  await analyzeMeeting({
+    marvinDir,
+    meetingId,
+    draft: isDraft,
+    persona
+  });
+}
+
 // src/cli/program.ts
 function createProgram() {
   const program2 = new Command();
@@ -18967,6 +19296,9 @@ function createProgram() {
   program2.command("clone <url> [directory]").description("Clone governance data from a remote repository").action(async (url2, directory) => {
     await cloneCommand(url2, directory);
   });
+  program2.command("analyze <meeting-id>").description("Analyze a meeting to extract decisions, actions, and questions").option("--draft", "Propose artifacts without creating them (default)").option("--no-draft", "Create artifacts directly via MCP tools").option("--as <persona>", "Persona for analysis (default: delivery-manager)").action(async (meetingId, options) => {
+    await analyzeCommand(meetingId, options);
+  });
   program2.command("import <path>").description("Import documents or sources from external paths").option("--dry-run", "Preview without writing files").option(
     "--conflict <strategy>",
     "ID conflict strategy: renumber, skip, overwrite (default: renumber)"