mrvn-cli 0.2.3 → 0.2.4

package/dist/index.js

@@ -218,9 +218,9 @@ var DocumentStore = class {
       }
     }
   }
-  list(query6) {
+  list(query7) {
     const results = [];
-    const types = query6?.type ? [query6.type] : Object.keys(this.typeDirs);
+    const types = query7?.type ? [query7.type] : Object.keys(this.typeDirs);
     for (const type of types) {
       const dirName = this.typeDirs[type];
       if (!dirName) continue;
@@ -231,9 +231,9 @@ var DocumentStore = class {
         const filePath = path3.join(dir, file2);
         const raw = fs3.readFileSync(filePath, "utf-8");
         const doc = parseDocument(raw, filePath);
-        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)))
+        if (query7?.status && doc.frontmatter.status !== query7.status) continue;
+        if (query7?.owner && doc.frontmatter.owner !== query7.owner) continue;
+        if (query7?.tag && (!doc.frontmatter.tags || !doc.frontmatter.tags.includes(query7.tag)))
           continue;
         results.push(doc);
       }
@@ -401,7 +401,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
@@ -439,7 +440,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
@@ -477,7 +479,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
@@ -15851,19 +15854,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)
   ];
 }
 
@@ -15873,7 +15998,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: {
@@ -15894,7 +16019,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:**
@@ -15915,7 +16046,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:**
@@ -15943,7 +16080,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.
@@ -15955,15 +16098,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",
       {
@@ -15993,7 +16141,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')") },
@@ -16020,7 +16168,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)",
       {
@@ -16054,7 +16202,7 @@ function createUseCaseTools(store) {
         };
       }
     ),
-    tool11(
+    tool12(
       "update_use_case",
       "Update an existing extension use case",
       {
@@ -16084,10 +16232,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",
       {
@@ -16118,7 +16266,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')") },
@@ -16145,7 +16293,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)",
       {
@@ -16216,7 +16364,7 @@ function createTechAssessmentTools(store) {
         };
       }
     ),
-    tool12(
+    tool13(
       "update_tech_assessment",
       "Update an existing technology assessment. The linked use case cannot be changed.",
       {
@@ -16246,10 +16394,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",
       {
@@ -16279,7 +16427,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')") },
@@ -16306,7 +16454,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)",
       {
@@ -16374,7 +16522,7 @@ function createExtensionDesignTools(store) {
         };
       }
     ),
-    tool13(
+    tool14(
       "update_extension_design",
       "Update an existing extension design. The linked tech assessment cannot be changed.",
       {
@@ -16403,10 +16551,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",
       {},
@@ -16458,7 +16606,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",
       {},
@@ -16510,7 +16658,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",
       {},
@@ -16572,11 +16720,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",
       {},
@@ -16597,7 +16745,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.",
       {
@@ -17372,7 +17520,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 
 // 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 as query3 } from "@anthropic-ai/claude-agent-sdk";
@@ -17438,7 +17586,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,
           {
@@ -17530,10 +17678,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.",
       {
@@ -17563,7 +17711,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.",
       {
@@ -19687,12 +19835,417 @@ Analyzing meeting: ${meetingDoc.frontmatter.title}`));
   });
 }
 
+// src/cli/commands/contribute.ts
+import chalk15 from "chalk";
+
+// src/contributions/contribute.ts
+import chalk14 from "chalk";
+import ora5 from "ora";
+import { query as query6 } from "@anthropic-ai/claude-agent-sdk";
+
+// src/contributions/prompts.ts
+function buildContributeSystemPrompt(persona, contributionType, projectConfig, isDraft) {
+  const parts = [];
+  parts.push(persona.systemPrompt);
+  parts.push(`
+## Project Context
+- **Project Name:** ${projectConfig.name}
+- **Methodology:** ${projectConfig.methodology ?? "Generic Agile"}
+`);
+  parts.push(`
+## Contribution Analysis Task
+You are processing a **${contributionType}** contribution from the **${persona.name}**.
+Review the contribution content and determine what governance effects should follow.
+
+Possible effects include:
+1. **Create** new artifacts \u2014 decisions (D-xxx), actions (A-xxx), questions (Q-xxx)
+2. **Update** existing artifacts \u2014 change status, add information, close items
+`);
+  parts.push(buildContributionTypeInstructions(contributionType));
+  if (isDraft) {
+    parts.push(`
+## Mode: Draft Proposal
+Present your findings as a structured proposal. Do NOT create or update any artifacts.
+Format your response as:
+
+### Proposed Effects
+For each effect:
+- **Action:** [create/update]
+- **Target:** [new artifact type or existing artifact ID]
+- **Details:** [what would be created or changed]
+- **Rationale:** [why this effect follows from the contribution]
+
+### Summary
+Provide a brief summary of the contribution analysis and recommendations.
+`);
+  } else {
+    parts.push(`
+## Mode: Direct Execution
+Use the MCP tools to create and update artifacts directly:
+- Use \`create_decision\` / \`create_action\` / \`create_question\` for new artifacts
+- Use \`update_decision\` / \`update_action\` / \`update_question\` to modify existing ones
+- Use \`list_decisions\` / \`list_actions\` / \`list_questions\` to check existing artifacts before creating or updating
+
+Before creating artifacts, check existing ones using the list tools to avoid duplicates.
+
+For EVERY artifact you create or update, include:
+- A \`source:<contribution-id>\` tag in the tags array (the contribution ID is provided in the user prompt)
+- Clear title and detailed content with context from the contribution
+
+After processing all effects, provide a summary of what was created and updated.
+`);
+  }
+  return parts.join("\n");
+}
+function buildContributionTypeInstructions(contributionType) {
+  const instructions = {
+    "action-result": `
+### Type-Specific Guidance: Action Result
+The contributor is reporting results of a completed action.
+- Update the referenced action's status to "done" if results are conclusive
+- Check if the results answer any open questions \u2014 if so, update those questions
+- Check if results challenge any existing decisions \u2014 if so, create a new question or update the decision
+- If results reveal new work, create new actions`,
+    "spike-findings": `
+### Type-Specific Guidance: Spike Findings
+The contributor is sharing findings from a technical investigation (spike).
+- Create decisions for any architectural or technical choices made
+- Update or close the original spike action if referenced
+- Create new actions for follow-up implementation work
+- Create questions for areas needing further investigation`,
+    "technical-assessment": `
+### Type-Specific Guidance: Technical Assessment
+The contributor is providing a technical evaluation.
+- Create decisions for technical recommendations
+- Create actions for remediation or improvement tasks
+- Create questions for areas needing more investigation
+- Flag any risks by tagging artifacts with "risk"`,
+    "architecture-review": `
+### Type-Specific Guidance: Architecture Review
+The contributor is documenting an architecture review.
+- Create decisions for architectural choices and trade-offs
+- Create actions for any architectural changes needed
+- Create questions for design concerns or alternatives to evaluate
+- Update existing decisions if the review validates or challenges them`,
+    "stakeholder-feedback": `
+### Type-Specific Guidance: Stakeholder Feedback
+The contributor is relaying feedback from stakeholders.
+- Create or update decisions based on stakeholder direction
+- Create actions for requested changes or follow-ups
+- Create questions for items needing clarification
+- Update priorities on existing artifacts if feedback changes priorities`,
+    "acceptance-result": `
+### Type-Specific Guidance: Acceptance Result
+The contributor is reporting results of acceptance testing.
+- Update the referenced action/feature status based on pass/fail
+- Create new actions for any rework needed
+- Create questions for ambiguous acceptance criteria
+- If accepted, mark related actions as "done"`,
+    "priority-change": `
+### Type-Specific Guidance: Priority Change
+The contributor is communicating a change in priorities.
+- Update priority fields on affected artifacts
+- Create decisions documenting the priority change rationale
+- Create actions for any re-planning needed
+- Flag any blocked or impacted items`,
+    "market-insight": `
+### Type-Specific Guidance: Market Insight
+The contributor is sharing market intelligence or competitive information.
+- Create decisions if the insight drives product direction changes
+- Create questions for areas needing further market research
+- Create actions for competitive response tasks
+- Update existing features or priorities if affected`,
+    "risk-finding": `
+### Type-Specific Guidance: Risk Finding
+The contributor is identifying a project risk.
+- Create actions for risk mitigation tasks
+- Create decisions for risk response strategies
+- Create questions for risks needing further assessment
+- Tag all related artifacts with "risk" for tracking`,
+    "blocker-report": `
+### Type-Specific Guidance: Blocker Report
+The contributor is reporting a blocker.
+- Create actions to resolve the blocker
+- Update blocked artifacts' status or add blocking context
+- Create questions for blockers needing external input
+- Escalate by creating high-priority actions if critical`,
+    "dependency-update": `
+### Type-Specific Guidance: Dependency Update
+The contributor is reporting on external or internal dependencies.
+- Update affected actions with dependency information
+- Create new actions for dependency-related tasks
+- Create questions for uncertain dependencies
+- Update timelines or flag schedule risks`,
+    "status-assessment": `
+### Type-Specific Guidance: Status Assessment
+The contributor is providing a delivery status assessment.
+- Update action statuses based on assessment
+- Create actions for corrective measures
+- Create questions for items needing investigation
+- Create decisions for any process changes needed`
+  };
+  return instructions[contributionType] ?? `
+### Type-Specific Guidance
+Analyze the contribution and determine appropriate governance effects based on the content.`;
+}
+function buildContributeUserPrompt(contributionId, contributionType, content, aboutArtifact, isDraft) {
+  const mode = isDraft ? "propose" : "execute";
+  const aboutLine = aboutArtifact ? `
+**Related Artifact:** ${aboutArtifact}` : "";
+  return `Please analyze the following contribution and ${mode} governance effects.
+
+**Contribution ID:** ${contributionId}
+**Contribution Type:** ${contributionType}${aboutLine}
+
+---
+${content}
+---
+
+Analyze this contribution thoroughly and ${mode} all relevant governance effects (create new artifacts, update existing ones). Tag each created or updated artifact with "source:${contributionId}" for traceability.`;
+}
+
+// src/contributions/contribute.ts
+async function contributeFromPersona(options) {
+  const { marvinDir, prompt, aboutArtifact, draft } = options;
+  const config2 = getConfig(marvinDir);
+  const personaId = resolvePersonaId(options.persona);
+  const persona = getPersona(personaId);
+  const allowedTypes = persona.contributionTypes ?? [];
+  if (allowedTypes.length > 0 && !allowedTypes.includes(options.contributionType)) {
+    throw new Error(
+      `Contribution type "${options.contributionType}" is not valid for persona "${persona.name}". Allowed types: ${allowedTypes.join(", ")}`
+    );
+  }
+  const plugin = resolvePlugin(config2.project.methodology);
+  const registrations = plugin?.documentTypeRegistrations ?? [];
+  const store = new DocumentStore(marvinDir, registrations);
+  const contributionFrontmatter = {
+    title: `${options.contributionType}: ${prompt.slice(0, 60)}${prompt.length > 60 ? "..." : ""}`,
+    status: "open",
+    persona: personaId,
+    contributionType: options.contributionType
+  };
+  if (aboutArtifact) contributionFrontmatter.aboutArtifact = aboutArtifact;
+  const contributionDoc = store.create("contribution", contributionFrontmatter, prompt);
+  const contributionId = contributionDoc.frontmatter.id;
+  const createdArtifacts = [];
+  const updatedArtifacts = [];
+  if (!draft) {
+    const originalCreate = store.create.bind(store);
+    store.create = (type, frontmatter, content) => {
+      const tags = frontmatter.tags ?? [];
+      const sourceTag = `source:${contributionId}`;
+      if (!tags.includes(sourceTag)) {
+        tags.push(sourceTag);
+      }
+      const doc = originalCreate(type, { ...frontmatter, source: contributionId, tags }, content);
+      createdArtifacts.push(doc.frontmatter.id);
+      return doc;
+    };
+    const originalUpdate = store.update.bind(store);
+    store.update = (id, updates, content) => {
+      if (id === contributionId) {
+        return originalUpdate(id, updates, content);
+      }
+      const existing = store.get(id);
+      const existingTags = existing?.frontmatter.tags ?? [];
+      const sourceTag = `source:${contributionId}`;
+      if (!existingTags.includes(sourceTag)) {
+        existingTags.push(sourceTag);
+      }
+      const doc = originalUpdate(id, { ...updates, tags: existingTags }, content);
+      if (!updatedArtifacts.includes(id)) {
+        updatedArtifacts.push(id);
+      }
+      return doc;
+    };
+  }
+  const pluginTools = plugin ? getPluginTools(plugin, store, marvinDir) : [];
+  const mcpServer = createMarvinMcpServer(store, { pluginTools });
+  const systemPrompt = buildContributeSystemPrompt(persona, options.contributionType, config2.project, draft);
+  const userPrompt = buildContributeUserPrompt(
+    contributionId,
+    options.contributionType,
+    prompt,
+    aboutArtifact,
+    draft
+  );
+  const spinner = ora5({ text: `Processing contribution ${contributionId}...`, color: "cyan" });
+  spinner.start();
+  try {
+    const allowedTools = draft ? [
+      "mcp__marvin-governance__list_decisions",
+      "mcp__marvin-governance__list_actions",
+      "mcp__marvin-governance__list_questions",
+      "mcp__marvin-governance__get_decision",
+      "mcp__marvin-governance__get_action",
+      "mcp__marvin-governance__get_question"
+    ] : [
+      "mcp__marvin-governance__create_decision",
+      "mcp__marvin-governance__create_action",
+      "mcp__marvin-governance__create_question",
+      "mcp__marvin-governance__update_decision",
+      "mcp__marvin-governance__update_action",
+      "mcp__marvin-governance__update_question",
+      "mcp__marvin-governance__list_decisions",
+      "mcp__marvin-governance__list_actions",
+      "mcp__marvin-governance__list_questions",
+      "mcp__marvin-governance__get_decision",
+      "mcp__marvin-governance__get_action",
+      "mcp__marvin-governance__get_question"
+    ];
+    const conversation = query6({
+      prompt: userPrompt,
+      options: {
+        systemPrompt,
+        mcpServers: { "marvin-governance": mcpServer },
+        permissionMode: "acceptEdits",
+        maxTurns: 10,
+        tools: [],
+        allowedTools
+      }
+    });
+    for await (const message of conversation) {
+      handleContributeMessage(message, spinner);
+    }
+    const effects = [...createdArtifacts, ...updatedArtifacts];
+    if (!draft && effects.length > 0) {
+      appendEffectsToContribution(store, contributionId, contributionDoc.content, createdArtifacts, updatedArtifacts, store);
+    }
+    spinner.stop();
+    if (draft) {
+      console.log(chalk14.dim(`
+Draft proposal complete. No artifacts were created or updated.`));
+      console.log(chalk14.dim(`Use --no-draft to execute effects directly.`));
+    } else {
+      const totalEffects = createdArtifacts.length + updatedArtifacts.length;
+      console.log(chalk14.green(`
+Contribution ${contributionId} processed: ${totalEffects} effect${totalEffects === 1 ? "" : "s"}`));
+      if (createdArtifacts.length > 0) {
+        console.log(chalk14.dim(`  Created: ${createdArtifacts.join(", ")}`));
+      }
+      if (updatedArtifacts.length > 0) {
+        console.log(chalk14.dim(`  Updated: ${updatedArtifacts.join(", ")}`));
+      }
+    }
+    return { contributionId, effects, draft };
+  } catch (err) {
+    spinner.stop();
+    throw err;
+  }
+}
+function appendEffectsToContribution(store, contributionId, existingContent, created, updated, storeInstance) {
+  const lines = [];
+  if (created.length > 0) {
+    lines.push("### Created");
+    for (const id of created) {
+      const doc = storeInstance.get(id);
+      const title = doc ? doc.frontmatter.title : id;
+      lines.push(`- ${id}: ${title}`);
+    }
+  }
+  if (updated.length > 0) {
+    lines.push("### Updated");
+    for (const id of updated) {
+      const doc = storeInstance.get(id);
+      const title = doc ? doc.frontmatter.title : id;
+      lines.push(`- ${id}: ${title}`);
+    }
+  }
+  const effectsSection = `
+
+## Effects
+${lines.join("\n")}`;
+  const updatedContent = existingContent + effectsSection;
+  store.update(contributionId, { status: "processed" }, updatedContent);
+}
+function handleContributeMessage(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(
+          chalk14.cyan("\nMarvin: ") + textBlocks.map((b) => b.text).join("\n")
+        );
+      }
+      break;
+    }
+    case "system": {
+      if (message.subtype === "init") {
+        spinner.start("Analyzing contribution...");
+      }
+      break;
+    }
+    case "result": {
+      spinner.stop();
+      if (message.subtype !== "success") {
+        console.log(
+          chalk14.red(`
+Contribution analysis ended with error: ${message.subtype}`)
+        );
+      }
+      break;
+    }
+  }
+}
+
+// src/cli/commands/contribute.ts
+async function contributeCommand(options) {
+  const project = loadProject();
+  const marvinDir = project.marvinDir;
+  if (!options.as) {
+    console.log(chalk15.red("Missing required option: --as <persona>"));
+    console.log(chalk15.dim('Example: marvin contribute --as tl --type action-result --prompt "..."'));
+    return;
+  }
+  if (!options.type) {
+    console.log(chalk15.red("Missing required option: --type <contribution-type>"));
+    const personaId2 = resolvePersonaId(options.as);
+    const persona2 = getPersona(personaId2);
+    if (persona2?.contributionTypes?.length) {
+      console.log(chalk15.dim(`Available types for ${persona2.name}: ${persona2.contributionTypes.join(", ")}`));
+    }
+    return;
+  }
+  if (!options.prompt) {
+    console.log(chalk15.red("Missing required option: --prompt <text>"));
+    console.log(chalk15.dim("Provide the contribution content via --prompt."));
+    return;
+  }
+  const personaId = resolvePersonaId(options.as);
+  const persona = getPersona(personaId);
+  if (!persona) {
+    console.log(chalk15.red(`Unknown persona: ${options.as}`));
+    return;
+  }
+  const isDraft = options.draft !== false;
+  console.log(chalk15.bold(`
+Contribution: ${options.type}`));
+  console.log(chalk15.dim(`Persona: ${persona.name}`));
+  console.log(chalk15.dim(`Mode: ${isDraft ? "draft (propose only)" : "direct (execute effects)"}`));
+  if (options.about) {
+    console.log(chalk15.dim(`About: ${options.about}`));
+  }
+  console.log();
+  await contributeFromPersona({
+    marvinDir,
+    persona: options.as,
+    contributionType: options.type,
+    prompt: options.prompt,
+    aboutArtifact: options.about,
+    draft: isDraft
+  });
+}
+
 // src/cli/program.ts
 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.3");
+  ).version("0.2.4");
   program.command("init").description("Initialize a new Marvin project in the current directory").action(async () => {
     await initCommand();
   });
@@ -19735,6 +20288,9 @@ function createProgram() {
   program.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);
   });
+  program.command("contribute").description("Submit a structured contribution from a persona to generate governance effects").requiredOption("--as <persona>", "Persona making the contribution (po, dm, tl)").requiredOption("--type <type>", "Contribution type (e.g. action-result, risk-finding)").requiredOption("--prompt <text>", "Contribution content").option("--about <artifact-id>", "Related artifact ID (e.g. A-001)").option("--draft", "Propose effects without executing (default)").option("--no-draft", "Execute effects directly").action(async (options) => {
+    await contributeCommand(options);
+  });
   program.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)"