mrvn-cli 0.2.2 → 0.2.4

package/dist/marvin-serve.js

@@ -15526,19 +15526,141 @@ function createEpicTools(store) {
   ];
 }
 
+// src/plugins/builtin/tools/contributions.ts
+import { tool as tool11 } from "@anthropic-ai/claude-agent-sdk";
+function createContributionTools(store) {
+  return [
+    tool11(
+      "list_contributions",
+      "List all contributions in the project, optionally filtered by persona, contribution type, or status",
+      {
+        persona: external_exports.string().optional().describe("Filter by persona (e.g. 'tech-lead', 'product-owner')"),
+        contributionType: external_exports.string().optional().describe("Filter by contribution type (e.g. 'action-result', 'risk-finding')"),
+        status: external_exports.string().optional().describe("Filter by status")
+      },
+      async (args) => {
+        let docs = store.list({ type: "contribution", status: args.status });
+        if (args.persona) {
+          docs = docs.filter((d) => d.frontmatter.persona === args.persona);
+        }
+        if (args.contributionType) {
+          docs = docs.filter((d) => d.frontmatter.contributionType === args.contributionType);
+        }
+        const summary = docs.map((d) => ({
+          id: d.frontmatter.id,
+          title: d.frontmatter.title,
+          status: d.frontmatter.status,
+          persona: d.frontmatter.persona,
+          contributionType: d.frontmatter.contributionType,
+          aboutArtifact: d.frontmatter.aboutArtifact,
+          created: d.frontmatter.created,
+          tags: d.frontmatter.tags
+        }));
+        return {
+          content: [{ type: "text", text: JSON.stringify(summary, null, 2) }]
+        };
+      },
+      { annotations: { readOnly: true } }
+    ),
+    tool11(
+      "get_contribution",
+      "Get the full content of a specific contribution by ID",
+      { id: external_exports.string().describe("Contribution ID (e.g. 'C-001')") },
+      async (args) => {
+        const doc = store.get(args.id);
+        if (!doc) {
+          return {
+            content: [{ type: "text", text: `Contribution ${args.id} not found` }],
+            isError: true
+          };
+        }
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(
+                { ...doc.frontmatter, content: doc.content },
+                null,
+                2
+              )
+            }
+          ]
+        };
+      },
+      { annotations: { readOnly: true } }
+    ),
+    tool11(
+      "create_contribution",
+      "Create a new contribution record from a persona",
+      {
+        title: external_exports.string().describe("Title of the contribution"),
+        content: external_exports.string().describe("Contribution content \u2014 the input from the persona"),
+        persona: external_exports.string().describe("Persona making the contribution (e.g. 'tech-lead')"),
+        contributionType: external_exports.string().describe("Type of contribution (e.g. 'action-result', 'risk-finding')"),
+        aboutArtifact: external_exports.string().optional().describe("Artifact ID this contribution relates to (e.g. 'A-001')"),
+        status: external_exports.string().optional().describe("Status (default: 'open')"),
+        tags: external_exports.array(external_exports.string()).optional().describe("Tags for categorization")
+      },
+      async (args) => {
+        const frontmatter = {
+          title: args.title,
+          status: args.status ?? "open",
+          persona: args.persona,
+          contributionType: args.contributionType
+        };
+        if (args.aboutArtifact) frontmatter.aboutArtifact = args.aboutArtifact;
+        if (args.tags) frontmatter.tags = args.tags;
+        const doc = store.create("contribution", frontmatter, args.content);
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Created contribution ${doc.frontmatter.id}: ${doc.frontmatter.title}`
+            }
+          ]
+        };
+      }
+    ),
+    tool11(
+      "update_contribution",
+      "Update an existing contribution (e.g. to append an Effects section)",
+      {
+        id: external_exports.string().describe("Contribution ID to update"),
+        title: external_exports.string().optional().describe("New title"),
+        status: external_exports.string().optional().describe("New status"),
+        content: external_exports.string().optional().describe("New content")
+      },
+      async (args) => {
+        const { id, content, ...updates } = args;
+        const doc = store.update(id, updates, content);
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Updated contribution ${doc.frontmatter.id}: ${doc.frontmatter.title}`
+            }
+          ]
+        };
+      }
+    )
+  ];
+}
+
 // src/plugins/common.ts
 var COMMON_REGISTRATIONS = [
   { type: "meeting", dirName: "meetings", idPrefix: "M" },
   { type: "report", dirName: "reports", idPrefix: "R" },
   { type: "feature", dirName: "features", idPrefix: "F" },
-  { type: "epic", dirName: "epics", idPrefix: "E" }
+  { type: "epic", dirName: "epics", idPrefix: "E" },
+  { type: "contribution", dirName: "contributions", idPrefix: "C" }
 ];
 function createCommonTools(store) {
   return [
     ...createMeetingTools(store),
     ...createReportTools(store),
     ...createFeatureTools(store),
-    ...createEpicTools(store)
+    ...createEpicTools(store),
+    ...createContributionTools(store)
   ];
 }
 
@@ -15548,7 +15670,7 @@ var genericAgilePlugin = {
   name: "Generic Agile",
   description: "Default methodology plugin providing standard agile governance patterns for decisions, actions, and questions.",
   version: "0.1.0",
-  documentTypes: ["decision", "action", "question", "meeting", "report", "feature", "epic"],
+  documentTypes: ["decision", "action", "question", "meeting", "report", "feature", "epic", "contribution"],
   documentTypeRegistrations: [...COMMON_REGISTRATIONS],
   tools: (store) => [...createCommonTools(store)],
   promptFragments: {
@@ -15569,7 +15691,13 @@ var genericAgilePlugin = {
 - Create features as "draft" and approve them when requirements are clear and prioritized.
 - Do NOT create epics \u2014 that is the Tech Lead's responsibility. You can view epics to track progress.
 - Use priority levels (critical, high, medium, low) to communicate business value.
-- Tag features for categorization and cross-referencing.`,
+- Tag features for categorization and cross-referencing.
+
+**Contribution Tools:**
+- **list_contributions** / **get_contribution**: Browse and read contribution records.
+- **create_contribution**: Record a contribution with persona, type, and optional related artifact.
+- **update_contribution**: Update a contribution (e.g. append effects).
+- Available contribution types: stakeholder-feedback, acceptance-result, priority-change, market-insight.`,
     "tech-lead": `You own epics and break approved features into implementation work.
 
 **Epic Tools:**
@@ -15590,7 +15718,13 @@ var genericAgilePlugin = {
 - Only create epics against approved features \u2014 create_epic enforces this.
 - Tag work items (actions, decisions, questions) with \`epic:E-xxx\` to group them under an epic.
 - Collaborate with the Delivery Manager on target dates and effort estimates.
-- Each epic should have a clear scope and definition of done.`,
+- Each epic should have a clear scope and definition of done.
+
+**Contribution Tools:**
+- **list_contributions** / **get_contribution**: Browse and read contribution records.
+- **create_contribution**: Record a contribution with persona, type, and optional related artifact.
+- **update_contribution**: Update a contribution (e.g. append effects).
+- Available contribution types: action-result, spike-findings, technical-assessment, architecture-review.`,
     "delivery-manager": `You track delivery across features and epics, manage schedules, and report on progress.
 
 **Report Tools:**
@@ -15618,7 +15752,13 @@ var genericAgilePlugin = {
 - 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 analyze_meeting after meetings to extract outcomes into governance artifacts.`,
+- Use analyze_meeting after meetings to extract outcomes into governance artifacts.
+
+**Contribution Tools:**
+- **list_contributions** / **get_contribution**: Browse and read contribution records.
+- **create_contribution**: Record a contribution with persona, type, and optional related artifact.
+- **update_contribution**: Update a contribution (e.g. append effects).
+- Available contribution types: risk-finding, blocker-report, dependency-update, status-assessment.`,
     "*": `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.
@@ -15630,15 +15770,20 @@ var genericAgilePlugin = {
 - **list_meetings** / **get_meeting**: Browse and read meeting records.
 - **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.`
+- **analyze_meeting**: Analyze a meeting to extract decisions, actions, and questions as governance artifacts.
+
+**Contributions** (C-xxx): Structured inputs from personas outside of meetings (e.g. action results, risk findings, stakeholder feedback). Contributions are analyzed to produce governance effects.
+- **list_contributions** / **get_contribution**: Browse and read contribution records.
+- **create_contribution**: Record a contribution with persona, type, and optional related artifact.
+- **update_contribution**: Update a contribution (e.g. append effects).`
   }
 };
 
 // src/plugins/builtin/tools/use-cases.ts
-import { tool as tool11 } from "@anthropic-ai/claude-agent-sdk";
+import { tool as tool12 } from "@anthropic-ai/claude-agent-sdk";
 function createUseCaseTools(store) {
   return [
-    tool11(
+    tool12(
       "list_use_cases",
       "List all extension use cases, optionally filtered by status or extension type",
       {
@@ -15668,7 +15813,7 @@ function createUseCaseTools(store) {
       },
       { annotations: { readOnly: true } }
     ),
-    tool11(
+    tool12(
       "get_use_case",
       "Get the full content of a specific use case by ID",
       { id: external_exports.string().describe("Use case ID (e.g. 'UC-001')") },
@@ -15695,7 +15840,7 @@ function createUseCaseTools(store) {
       },
       { annotations: { readOnly: true } }
     ),
-    tool11(
+    tool12(
       "create_use_case",
       "Create a new extension use case definition (Phase 1: Assess Extension Use Case)",
       {
@@ -15729,7 +15874,7 @@ function createUseCaseTools(store) {
         };
       }
     ),
-    tool11(
+    tool12(
       "update_use_case",
       "Update an existing extension use case",
       {
@@ -15759,10 +15904,10 @@ function createUseCaseTools(store) {
 }
 
 // src/plugins/builtin/tools/tech-assessments.ts
-import { tool as tool12 } from "@anthropic-ai/claude-agent-sdk";
+import { tool as tool13 } from "@anthropic-ai/claude-agent-sdk";
 function createTechAssessmentTools(store) {
   return [
-    tool12(
+    tool13(
       "list_tech_assessments",
       "List all technology assessments, optionally filtered by status",
       {
@@ -15793,7 +15938,7 @@ function createTechAssessmentTools(store) {
       },
       { annotations: { readOnly: true } }
     ),
-    tool12(
+    tool13(
       "get_tech_assessment",
       "Get the full content of a specific technology assessment by ID",
       { id: external_exports.string().describe("Tech assessment ID (e.g. 'TA-001')") },
@@ -15820,7 +15965,7 @@ function createTechAssessmentTools(store) {
       },
       { annotations: { readOnly: true } }
     ),
-    tool12(
+    tool13(
       "create_tech_assessment",
       "Create a new technology assessment linked to an assessed/approved use case (Phase 2: Assess Extension Technology)",
       {
@@ -15891,7 +16036,7 @@ function createTechAssessmentTools(store) {
         };
       }
     ),
-    tool12(
+    tool13(
       "update_tech_assessment",
       "Update an existing technology assessment. The linked use case cannot be changed.",
       {
@@ -15921,10 +16066,10 @@ function createTechAssessmentTools(store) {
 }
 
 // src/plugins/builtin/tools/extension-designs.ts
-import { tool as tool13 } from "@anthropic-ai/claude-agent-sdk";
+import { tool as tool14 } from "@anthropic-ai/claude-agent-sdk";
 function createExtensionDesignTools(store) {
   return [
-    tool13(
+    tool14(
       "list_extension_designs",
       "List all extension designs, optionally filtered by status",
       {
@@ -15954,7 +16099,7 @@ function createExtensionDesignTools(store) {
       },
       { annotations: { readOnly: true } }
     ),
-    tool13(
+    tool14(
       "get_extension_design",
       "Get the full content of a specific extension design by ID",
       { id: external_exports.string().describe("Extension design ID (e.g. 'XD-001')") },
@@ -15981,7 +16126,7 @@ function createExtensionDesignTools(store) {
       },
       { annotations: { readOnly: true } }
     ),
-    tool13(
+    tool14(
       "create_extension_design",
       "Create a new extension design linked to a recommended tech assessment (Phase 3: Define Extension Target Solution)",
       {
@@ -16049,7 +16194,7 @@ function createExtensionDesignTools(store) {
         };
       }
     ),
-    tool13(
+    tool14(
       "update_extension_design",
       "Update an existing extension design. The linked tech assessment cannot be changed.",
       {
@@ -16078,10 +16223,10 @@ function createExtensionDesignTools(store) {
 }
 
 // src/plugins/builtin/tools/aem-reports.ts
-import { tool as tool14 } from "@anthropic-ai/claude-agent-sdk";
+import { tool as tool15 } from "@anthropic-ai/claude-agent-sdk";
 function createAemReportTools(store) {
   return [
-    tool14(
+    tool15(
       "generate_extension_portfolio",
       "Generate a portfolio view of all use cases with their linked tech assessments and extension designs",
       {},
@@ -16133,7 +16278,7 @@ function createAemReportTools(store) {
       },
       { annotations: { readOnly: true } }
     ),
-    tool14(
+    tool15(
       "generate_tech_readiness",
       "Generate a BTP technology readiness report showing service coverage and gaps across assessments",
       {},
@@ -16185,7 +16330,7 @@ function createAemReportTools(store) {
       },
       { annotations: { readOnly: true } }
     ),
-    tool14(
+    tool15(
       "generate_phase_status",
       "Generate a phase progress report showing artifact counts and readiness per AEM phase",
       {},
@@ -16247,11 +16392,11 @@ function createAemReportTools(store) {
 import * as fs6 from "fs";
 import * as path6 from "path";
 import * as YAML4 from "yaml";
-import { tool as tool15 } from "@anthropic-ai/claude-agent-sdk";
+import { tool as tool16 } from "@anthropic-ai/claude-agent-sdk";
 var PHASES = ["assess-use-case", "assess-technology", "define-solution"];
 function createAemPhaseTools(store, marvinDir) {
   return [
-    tool15(
+    tool16(
       "get_current_phase",
       "Get the current AEM phase from project configuration",
       {},
@@ -16272,7 +16417,7 @@ function createAemPhaseTools(store, marvinDir) {
       },
       { annotations: { readOnly: true } }
     ),
-    tool15(
+    tool16(
       "advance_phase",
       "Advance to the next AEM phase. Performs soft gate checks and warns if artifacts are incomplete, but does not block.",
       {
@@ -16738,7 +16883,7 @@ ${fragment}`);
 }
 
 // src/skills/action-tools.ts
-import { tool as tool16 } from "@anthropic-ai/claude-agent-sdk";
+import { tool as tool17 } from "@anthropic-ai/claude-agent-sdk";
 
 // src/skills/action-runner.ts
 import { query } from "@anthropic-ai/claude-agent-sdk";
@@ -16828,7 +16973,7 @@ function createSkillActionTools(skills, context) {
     if (!skill.actions) continue;
     for (const action of skill.actions) {
       tools.push(
-        tool16(
+        tool17(
           `${skill.id}__${action.id}`,
           action.description,
           {
@@ -16877,7 +17022,8 @@ var productOwner = {
     "Acceptance criteria",
     "Feature definition and prioritization"
   ],
-  documentTypes: ["decision", "question", "action", "feature"]
+  documentTypes: ["decision", "question", "action", "feature"],
+  contributionTypes: ["stakeholder-feedback", "acceptance-result", "priority-change", "market-insight"]
 };
 
 // src/personas/builtin/delivery-manager.ts
@@ -16915,7 +17061,8 @@ var deliveryManager = {
     "Status tracking",
     "Epic scheduling and tracking"
   ],
-  documentTypes: ["action", "decision", "meeting", "question", "feature", "epic"]
+  documentTypes: ["action", "decision", "meeting", "question", "feature", "epic"],
+  contributionTypes: ["risk-finding", "blocker-report", "dependency-update", "status-assessment"]
 };
 
 // src/personas/builtin/tech-lead.ts
@@ -16953,7 +17100,8 @@ var techLead = {
     "Non-functional requirements",
     "Epic creation and scoping"
   ],
-  documentTypes: ["decision", "action", "question", "epic"]
+  documentTypes: ["decision", "action", "question", "epic"],
+  contributionTypes: ["action-result", "spike-findings", "technical-assessment", "architecture-review"]
 };
 
 // src/personas/registry.ts
@@ -17050,10 +17198,10 @@ ${lines.join("\n\n")}`;
 }
 
 // src/mcp/persona-tools.ts
-import { tool as tool17 } from "@anthropic-ai/claude-agent-sdk";
+import { tool as tool18 } from "@anthropic-ai/claude-agent-sdk";
 function createPersonaTools(ctx, marvinDir) {
   return [
-    tool17(
+    tool18(
       "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.",
       {
@@ -17083,7 +17231,7 @@ ${summaries}`
         };
       }
     ),
-    tool17(
+    tool18(
       "get_persona_guidance",
       "Get guidance for a persona without changing the active persona. If no persona is specified, lists all available personas with summaries.",
       {