mrvn-cli 0.2.0 → 0.2.2

package/dist/index.js

@@ -275,7 +275,7 @@ var DocumentStore = class {
       updated: now,
       ...cleaned
     };
-    const fileName = type === "meeting" ? `${now.slice(0, 10)}-${slugify(fullFrontmatter.title)}.md` : `${id}.md`;
+    const fileName = type === "meeting" ? `${cleaned.date?.slice(0, 10) ?? now.slice(0, 10)}-${slugify(fullFrontmatter.title)}.md` : `${id}.md`;
     const filePath = path3.join(dir, fileName);
     const doc = {
       frontmatter: fullFrontmatter,
@@ -299,7 +299,7 @@ var DocumentStore = class {
     }
     const dir = path3.join(this.docsDir, dirName);
     fs3.mkdirSync(dir, { recursive: true });
-    const fileName = type === "meeting" ? `${frontmatter.created.slice(0, 10)}-${slugify(frontmatter.title)}.md` : `${frontmatter.id}.md`;
+    const fileName = type === "meeting" ? `${frontmatter.date?.slice(0, 10) ?? frontmatter.created.slice(0, 10)}-${slugify(frontmatter.title)}.md` : `${frontmatter.id}.md`;
     const filePath = path3.join(dir, fileName);
     const doc = { frontmatter, content, filePath };
     fs3.writeFileSync(filePath, serializeDocument(doc), "utf-8");
@@ -15176,7 +15176,7 @@ function createMeetingTools(store) {
         owner: external_exports.string().optional().describe("Meeting organizer"),
         tags: external_exports.array(external_exports.string()).optional().describe("Tags for categorization"),
         attendees: external_exports.array(external_exports.string()).optional().describe("List of attendees"),
-        date: external_exports.string().optional().describe("Meeting date (ISO format)")
+        date: external_exports.string().describe("Date the meeting took place (ISO format, e.g. '2025-01-15'). Extract from the meeting content. If not found, ask the user before calling this tool.")
       },
       async (args) => {
         const frontmatter = {
@@ -15186,7 +15186,7 @@ function createMeetingTools(store) {
         if (args.owner) frontmatter.owner = args.owner;
         if (args.tags) frontmatter.tags = args.tags;
         if (args.attendees) frontmatter.attendees = args.attendees;
-        if (args.date) frontmatter.date = args.date;
+        frontmatter.date = args.date;
         const doc = store.create(
           "meeting",
           frontmatter,
@@ -15886,7 +15886,7 @@ var genericAgilePlugin = {
 
 **Meeting Tools:**
 - **list_meetings** / **get_meeting**: Browse and read meeting records.
-- **create_meeting**: Record new meetings with attendees, date, and agenda.
+- **create_meeting**: Record new meetings with attendees, date, and agenda. The meeting date is required \u2014 extract it from the meeting content or ask the user if not found.
 - **update_meeting**: Update meeting status or notes after completion.
 - **analyze_meeting**: Analyze a meeting to review its outcomes and extract artifacts.
 
@@ -15907,7 +15907,7 @@ var genericAgilePlugin = {
 
 **Meeting Tools:**
 - **list_meetings** / **get_meeting**: Browse and read meeting records.
-- **create_meeting**: Record new meetings with attendees, date, and agenda.
+- **create_meeting**: Record new meetings with attendees, date, and agenda. The meeting date is required \u2014 extract it from the meeting content or ask the user if not found.
 - **update_meeting**: Update meeting status or notes after completion.
 - **analyze_meeting**: Analyze a meeting to review its outcomes and extract artifacts.
 
@@ -15935,7 +15935,7 @@ var genericAgilePlugin = {
 
 **Meeting Tools:**
 - **list_meetings** / **get_meeting**: Browse and read meeting records.
-- **create_meeting**: Record new meetings with attendees, date, and agenda.
+- **create_meeting**: Record new meetings with attendees, date, and agenda. The meeting date is required \u2014 extract it from the meeting content or ask the user if not found.
 - **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.
 
@@ -15953,7 +15953,7 @@ var genericAgilePlugin = {
 **Key workflow rule:** Epics must link to approved features \u2014 the system enforces this. The Product Owner defines and approves features, the Tech Lead breaks them into epics, and the Delivery Manager tracks dates and progress.
 
 - **list_meetings** / **get_meeting**: Browse and read meeting records.
-- **create_meeting**: Record meetings with attendees, date, and agenda.
+- **create_meeting**: Record meetings with attendees, date, and agenda. The meeting date is required \u2014 extract it from the meeting content or ask the user if not found.
 - **update_meeting**: Update meeting status or notes.
 - **analyze_meeting**: Analyze a meeting to extract decisions, actions, and questions as governance artifacts.`
   }
@@ -17452,6 +17452,213 @@ function createSkillActionTools(skills, context) {
   return tools;
 }
 
+// src/mcp/persona-context.ts
+var PersonaContextManager = class {
+  activePersona = null;
+  setPersona(idOrShortName) {
+    const persona = getPersona(idOrShortName);
+    if (persona) {
+      this.activePersona = persona;
+    }
+    return persona;
+  }
+  getActivePersona() {
+    return this.activePersona;
+  }
+  clearPersona() {
+    this.activePersona = null;
+  }
+  isDocumentTypeAllowed(docType) {
+    if (!this.activePersona) return true;
+    return this.activePersona.documentTypes.includes(docType);
+  }
+};
+function buildMcpGuidance(persona, marvinDir) {
+  const parts = [];
+  parts.push(`# Active Persona: ${persona.name} (${persona.shortName})`);
+  parts.push(`
+${persona.description}`);
+  parts.push(`
+## Focus Areas`);
+  for (const area of persona.focusAreas) {
+    parts.push(`- ${area}`);
+  }
+  parts.push(`
+## Allowed Document Types`);
+  parts.push(persona.documentTypes.join(", "));
+  parts.push(`
+## Behavioral Instructions`);
+  parts.push(persona.systemPrompt);
+  try {
+    const config2 = loadProjectConfig(marvinDir);
+    const plugin = resolvePlugin(config2.methodology);
+    if (plugin) {
+      const fragment = getPluginPromptFragment(plugin, persona.id);
+      if (fragment) {
+        parts.push(`
+## Plugin Rules`);
+        parts.push(fragment);
+      }
+    }
+    const allSkills = loadAllSkills(marvinDir);
+    const skillIds = resolveSkillsForPersona(
+      persona.id,
+      config2.skills,
+      allSkills
+    );
+    if (skillIds.length > 0) {
+      const fragment = getSkillPromptFragment(skillIds, allSkills, persona.id);
+      if (fragment) {
+        parts.push(`
+## Skill Rules`);
+        parts.push(fragment);
+      }
+    }
+  } catch {
+  }
+  return parts.join("\n");
+}
+function buildPersonaSummaries() {
+  const personas = listPersonas();
+  const lines = personas.map(
+    (p) => `- **${p.name}** (${p.shortName}): ${p.description}
+  Document types: ${p.documentTypes.join(", ")}`
+  );
+  return `# Available Personas
+
+${lines.join("\n\n")}`;
+}
+
+// src/mcp/persona-tools.ts
+import { tool as tool17 } from "@anthropic-ai/claude-agent-sdk";
+function createPersonaTools(ctx, marvinDir) {
+  return [
+    tool17(
+      "set_persona",
+      "Set the active persona for this session. Returns full guidance for the selected persona including behavioral rules, allowed document types, and scope. Call this before working to ensure persona-appropriate behavior.",
+      {
+        persona: external_exports.string().describe(
+          'Persona ID or short name (e.g. "po", "product-owner", "dm", "delivery-manager", "tl", "tech-lead")'
+        )
+      },
+      async (args) => {
+        const resolved = ctx.setPersona(args.persona);
+        if (!resolved) {
+          const summaries = buildPersonaSummaries();
+          return {
+            content: [
+              {
+                type: "text",
+                text: `Unknown persona "${args.persona}".
+
+${summaries}`
+              }
+            ],
+            isError: true
+          };
+        }
+        const guidance = buildMcpGuidance(resolved, marvinDir);
+        return {
+          content: [{ type: "text", text: guidance }]
+        };
+      }
+    ),
+    tool17(
+      "get_persona_guidance",
+      "Get guidance for a persona without changing the active persona. If no persona is specified, lists all available personas with summaries.",
+      {
+        persona: external_exports.string().optional().describe(
+          "Optional persona ID or short name. Omit to list all personas."
+        )
+      },
+      async (args) => {
+        if (!args.persona) {
+          const summaries = buildPersonaSummaries();
+          return {
+            content: [{ type: "text", text: summaries }]
+          };
+        }
+        const resolved = getPersona(args.persona);
+        if (!resolved) {
+          const summaries = buildPersonaSummaries();
+          return {
+            content: [
+              {
+                type: "text",
+                text: `Unknown persona "${args.persona}".
+
+${summaries}`
+              }
+            ],
+            isError: true
+          };
+        }
+        const guidance = buildMcpGuidance(resolved, marvinDir);
+        return {
+          content: [{ type: "text", text: guidance }]
+        };
+      },
+      { annotations: { readOnly: true } }
+    )
+  ];
+}
+
+// src/mcp/tool-wrapper.ts
+function extractDocType(toolName) {
+  if (toolName === "save_report") return "report";
+  const match = toolName.match(/^(?:create|update)_(\w+)$/);
+  return match ? match[1] : void 0;
+}
+function wrapToolsWithPersonaValidation(tools, ctx) {
+  return tools.map((t) => {
+    const docType = extractDocType(t.name);
+    if (!docType) return t;
+    return {
+      ...t,
+      handler: async (args, extra) => {
+        const persona = ctx.getActivePersona();
+        if (!persona) {
+          const summaries = buildPersonaSummaries();
+          return {
+            content: [
+              {
+                type: "text",
+                text: `[PERSONA REQUIRED] You must set an active persona before creating or updating documents. Call the set_persona tool first.
+
+${summaries}`
+              }
+            ],
+            isError: true
+          };
+        }
+        const result = await t.handler(args, extra);
+        if (ctx.isDocumentTypeAllowed(docType)) {
+          return result;
+        }
+        const warning = [
+          `[PERSONA WARNING] You are acting as ${persona.name} (${persona.shortName}). Creating/updating "${docType}" documents is outside your typical scope.`,
+          "",
+          `Your allowed document types: ${persona.documentTypes.join(", ")}`,
+          "",
+          "Consider whether this is the right persona for this task, or switch with set_persona.",
+          "",
+          "---"
+        ].join("\n");
+        const content = Array.isArray(result.content) ? result.content.map(
+          (block, index) => {
+            if (index === 0 && block.type === "text" && block.text) {
+              return { ...block, text: `${warning}
+${block.text}` };
+            }
+            return block;
+          }
+        ) : result.content;
+        return { ...result, content };
+      }
+    };
+  });
+}
+
 // src/mcp/stdio-server.ts
 function collectTools(marvinDir) {
   const config2 = loadProjectConfig(marvinDir);
@@ -17514,8 +17721,11 @@ async function startStdioServer(options) {
     { name: "marvin-governance", version: "0.1.0" },
     { capabilities: { tools: {} } }
   );
-  const tools = collectTools(options.marvinDir);
-  registerSdkTools(server, tools);
+  const contextManager = new PersonaContextManager();
+  const governanceTools = collectTools(options.marvinDir);
+  const personaTools = createPersonaTools(contextManager, options.marvinDir);
+  const wrappedTools = wrapToolsWithPersonaValidation(governanceTools, contextManager);
+  registerSdkTools(server, [...personaTools, ...wrappedTools]);
   const transport = new StdioServerTransport();
   await server.connect(transport);
 }
@@ -19482,7 +19692,7 @@ function createProgram() {
   const program = new Command();
   program.name("marvin").description(
     "AI-powered product development assistant with Product Owner, Delivery Manager, and Technical Lead personas"
-  ).version("0.2.0");
+  ).version("0.2.1");
   program.command("init").description("Initialize a new Marvin project in the current directory").action(async () => {
     await initCommand();
   });