mrvn-cli 0.2.3 → 0.2.5

package/dist/marvin.js

@@ -14313,6 +14313,60 @@ function createReportTools(store) {
       },
       { annotations: { readOnly: true } }
     ),
+    tool2(
+      "generate_sprint_progress",
+      "Generate progress report for a sprint or all sprints, showing linked epics and tagged work items",
+      {
+        sprint: external_exports.string().optional().describe("Specific sprint ID (e.g. 'SP-001') or omit for all")
+      },
+      async (args) => {
+        const allDocs = store.list();
+        const sprintDocs = store.list({ type: "sprint" });
+        const sprints = sprintDocs.filter((s) => !args.sprint || s.frontmatter.id === args.sprint).map((sprintDoc) => {
+          const sprintId = sprintDoc.frontmatter.id;
+          const linkedEpicIds = sprintDoc.frontmatter.linkedEpics ?? [];
+          const linkedEpics = linkedEpicIds.map((epicId) => {
+            const epic = store.get(epicId);
+            return epic ? { id: epicId, title: epic.frontmatter.title, status: epic.frontmatter.status } : { id: epicId, title: "(not found)", status: "unknown" };
+          });
+          const workItems = allDocs.filter(
+            (d) => d.frontmatter.type !== "sprint" && d.frontmatter.type !== "epic" && d.frontmatter.tags?.includes(`sprint:${sprintId}`)
+          );
+          const byStatus = {};
+          for (const doc of workItems) {
+            byStatus[doc.frontmatter.status] = (byStatus[doc.frontmatter.status] ?? 0) + 1;
+          }
+          const doneCount = (byStatus["done"] ?? 0) + (byStatus["resolved"] ?? 0) + (byStatus["closed"] ?? 0);
+          const total = workItems.length;
+          const completionPct = total > 0 ? Math.round(doneCount / total * 100) : 0;
+          return {
+            id: sprintDoc.frontmatter.id,
+            title: sprintDoc.frontmatter.title,
+            status: sprintDoc.frontmatter.status,
+            goal: sprintDoc.frontmatter.goal,
+            startDate: sprintDoc.frontmatter.startDate,
+            endDate: sprintDoc.frontmatter.endDate,
+            linkedEpics,
+            workItems: {
+              total,
+              done: doneCount,
+              completionPct,
+              byStatus,
+              items: workItems.map((d) => ({
+                id: d.frontmatter.id,
+                title: d.frontmatter.title,
+                type: d.frontmatter.type,
+                status: d.frontmatter.status
+              }))
+            }
+          };
+        });
+        return {
+          content: [{ type: "text", text: JSON.stringify({ sprints }, null, 2) }]
+        };
+      },
+      { annotations: { readOnly: true } }
+    ),
     tool2(
       "generate_feature_progress",
       "Generate progress report for features and their linked epics",
@@ -14359,7 +14413,7 @@ function createReportTools(store) {
       {
         title: external_exports.string().describe("Report title"),
         content: external_exports.string().describe("Full report content in markdown"),
-        reportType: external_exports.enum(["status", "risk-register", "gar", "epic-progress", "feature-progress", "custom"]).describe("Type of report"),
+        reportType: external_exports.enum(["status", "risk-register", "gar", "epic-progress", "feature-progress", "sprint-progress", "custom"]).describe("Type of report"),
         tags: external_exports.array(external_exports.string()).optional().describe("Additional tags")
       },
       async (args) => {
@@ -14656,19 +14710,316 @@ function createEpicTools(store) {
   ];
 }
 
+// src/plugins/builtin/tools/contributions.ts
+import { tool as tool5 } from "@anthropic-ai/claude-agent-sdk";
+function createContributionTools(store) {
+  return [
+    tool5(
+      "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 } }
+    ),
+    tool5(
+      "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 } }
+    ),
+    tool5(
+      "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}`
+            }
+          ]
+        };
+      }
+    ),
+    tool5(
+      "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/builtin/tools/sprints.ts
+import { tool as tool6 } from "@anthropic-ai/claude-agent-sdk";
+function createSprintTools(store) {
+  return [
+    tool6(
+      "list_sprints",
+      "List all sprints in the project, optionally filtered by status",
+      {
+        status: external_exports.enum(["planned", "active", "completed", "cancelled"]).optional().describe("Filter by sprint status")
+      },
+      async (args) => {
+        const docs = store.list({ type: "sprint", status: args.status });
+        const summary = docs.map((d) => ({
+          id: d.frontmatter.id,
+          title: d.frontmatter.title,
+          status: d.frontmatter.status,
+          goal: d.frontmatter.goal,
+          startDate: d.frontmatter.startDate,
+          endDate: d.frontmatter.endDate,
+          linkedEpics: d.frontmatter.linkedEpics,
+          tags: d.frontmatter.tags
+        }));
+        return {
+          content: [{ type: "text", text: JSON.stringify(summary, null, 2) }]
+        };
+      },
+      { annotations: { readOnly: true } }
+    ),
+    tool6(
+      "get_sprint",
+      "Get the full content of a specific sprint by ID",
+      { id: external_exports.string().describe("Sprint ID (e.g. 'SP-001')") },
+      async (args) => {
+        const doc = store.get(args.id);
+        if (!doc) {
+          return {
+            content: [{ type: "text", text: `Sprint ${args.id} not found` }],
+            isError: true
+          };
+        }
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(
+                { ...doc.frontmatter, content: doc.content },
+                null,
+                2
+              )
+            }
+          ]
+        };
+      },
+      { annotations: { readOnly: true } }
+    ),
+    tool6(
+      "create_sprint",
+      "Create a new sprint with dates, goal, and optionally linked epics",
+      {
+        title: external_exports.string().describe("Sprint title"),
+        content: external_exports.string().describe("Sprint description and objectives"),
+        goal: external_exports.string().describe("Sprint goal \u2014 what this sprint aims to deliver"),
+        startDate: external_exports.string().describe("Sprint start date (ISO format, e.g. '2026-03-01')"),
+        endDate: external_exports.string().describe("Sprint end date (ISO format, e.g. '2026-03-14')"),
+        status: external_exports.enum(["planned", "active", "completed", "cancelled"]).optional().describe("Sprint status (default: 'planned')"),
+        linkedEpics: external_exports.array(external_exports.string()).optional().describe("Epic IDs to link (e.g. ['E-001', 'E-003']). Soft-validated: warns if not found but still creates."),
+        tags: external_exports.array(external_exports.string()).optional().describe("Additional tags")
+      },
+      async (args) => {
+        const warnings = [];
+        if (args.linkedEpics) {
+          for (const epicId of args.linkedEpics) {
+            const epic = store.get(epicId);
+            if (!epic) {
+              warnings.push(`Epic ${epicId} not found (linked anyway)`);
+            }
+          }
+        }
+        const frontmatter = {
+          title: args.title,
+          status: args.status ?? "planned",
+          goal: args.goal,
+          startDate: args.startDate,
+          endDate: args.endDate,
+          linkedEpics: args.linkedEpics ?? [],
+          tags: [...args.tags ?? []]
+        };
+        const doc = store.create("sprint", frontmatter, args.content);
+        const sprintId = doc.frontmatter.id;
+        if (args.linkedEpics) {
+          for (const epicId of args.linkedEpics) {
+            const epic = store.get(epicId);
+            if (epic) {
+              const existingTags = epic.frontmatter.tags ?? [];
+              const sprintTag = `sprint:${sprintId}`;
+              if (!existingTags.includes(sprintTag)) {
+                store.update(epicId, { tags: [...existingTags, sprintTag] });
+              }
+            }
+          }
+        }
+        const parts = [`Created sprint ${sprintId}: ${doc.frontmatter.title}`];
+        if (warnings.length > 0) {
+          parts.push(`Warnings: ${warnings.join("; ")}`);
+        }
+        return {
+          content: [{ type: "text", text: parts.join("\n") }]
+        };
+      }
+    ),
+    tool6(
+      "update_sprint",
+      "Update an existing sprint. Cannot change id or type.",
+      {
+        id: external_exports.string().describe("Sprint ID to update"),
+        title: external_exports.string().optional().describe("New title"),
+        status: external_exports.enum(["planned", "active", "completed", "cancelled"]).optional().describe("New status"),
+        content: external_exports.string().optional().describe("New content"),
+        goal: external_exports.string().optional().describe("New sprint goal"),
+        startDate: external_exports.string().optional().describe("New start date"),
+        endDate: external_exports.string().optional().describe("New end date"),
+        linkedEpics: external_exports.array(external_exports.string()).optional().describe("New list of linked epic IDs (replaces existing)"),
+        tags: external_exports.array(external_exports.string()).optional().describe("New tags (replaces existing)")
+      },
+      async (args) => {
+        const { id, content, linkedEpics, ...updates } = args;
+        const existing = store.get(id);
+        if (!existing) {
+          return {
+            content: [{ type: "text", text: `Sprint ${id} not found` }],
+            isError: true
+          };
+        }
+        if (linkedEpics !== void 0) {
+          const oldLinked = existing.frontmatter.linkedEpics ?? [];
+          const sprintTag = `sprint:${id}`;
+          const removed = oldLinked.filter((e) => !linkedEpics.includes(e));
+          for (const epicId of removed) {
+            const epic = store.get(epicId);
+            if (epic) {
+              const tags = epic.frontmatter.tags ?? [];
+              const filtered = tags.filter((t) => t !== sprintTag);
+              if (filtered.length !== tags.length) {
+                store.update(epicId, { tags: filtered });
+              }
+            }
+          }
+          const added = linkedEpics.filter((e) => !oldLinked.includes(e));
+          for (const epicId of added) {
+            const epic = store.get(epicId);
+            if (epic) {
+              const tags = epic.frontmatter.tags ?? [];
+              if (!tags.includes(sprintTag)) {
+                store.update(epicId, { tags: [...tags, sprintTag] });
+              }
+            }
+          }
+          updates.linkedEpics = linkedEpics;
+        }
+        const doc = store.update(id, updates, content);
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Updated sprint ${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" },
+  { type: "sprint", dirName: "sprints", idPrefix: "SP" }
 ];
 function createCommonTools(store) {
   return [
     ...createMeetingTools(store),
     ...createReportTools(store),
     ...createFeatureTools(store),
-    ...createEpicTools(store)
+    ...createEpicTools(store),
+    ...createContributionTools(store),
+    ...createSprintTools(store)
   ];
 }
 
@@ -14678,7 +15029,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", "sprint"],
   documentTypeRegistrations: [...COMMON_REGISTRATIONS],
   tools: (store) => [...createCommonTools(store)],
   promptFragments: {
@@ -14699,7 +15050,16 @@ 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.
+
+**Sprint Tools (read-only for awareness):**
+- **list_sprints** / **get_sprint**: View sprints to understand delivery timelines and iteration scope.`,
     "tech-lead": `You own epics and break approved features into implementation work.
 
 **Epic Tools:**
@@ -14720,7 +15080,19 @@ 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.
+
+**Sprint Tools:**
+- **list_sprints** / **get_sprint**: View sprints to understand iteration scope and delivery dates.
+- **update_sprint**: Assign epics to sprints by updating linkedEpics when breaking features into work.
+- Tag technical actions and decisions with \`sprint:SP-xxx\` to associate them with a sprint.
+- Use **generate_sprint_progress** to track technical work completion within an iteration.`,
     "delivery-manager": `You track delivery across features and epics, manage schedules, and report on progress.
 
 **Report Tools:**
@@ -14748,27 +15120,53 @@ 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.`,
-    "*": `You have access to feature, epic, and meeting tools for project coordination:
+- 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.
+
+**Sprint Tools:**
+- **list_sprints** / **get_sprint**: Browse and read sprint definitions.
+- **create_sprint**: Create sprints with dates, goals, and linked epics. Use status "planned" for upcoming sprints or "active"/"completed"/"cancelled" for current/past sprints.
+- **update_sprint**: Update sprint status, dates, goal, or linked epics. When linkedEpics changes, affected epics are re-tagged automatically.
+- **generate_sprint_progress**: Progress report for a specific sprint or all sprints \u2014 shows linked epics with statuses, work items tagged \`sprint:SP-xxx\` grouped by status, and done/total completion %.
+- Use \`save_report\` with reportType "sprint-progress" to persist sprint reports.
+
+**Sprint Workflow:**
+- Create sprints with clear goals and date boundaries.
+- Assign epics to sprints via linkedEpics.
+- Tag work items (actions, decisions, questions) with \`sprint:SP-xxx\` for sprint scoping.
+- Track delivery dates and flag at-risk sprints.
+- Register past/completed sprints for historical tracking.`,
+    "*": `You have access to feature, epic, sprint, and meeting tools for project coordination:
 
 **Features** (F-xxx): Product capabilities defined by the Product Owner. Features progress through draft \u2192 approved \u2192 done.
 **Epics** (E-xxx): Implementation work packages created by the Tech Lead, linked to approved features. Epics progress through planned \u2192 in-progress \u2192 done.
+**Sprints** (SP-xxx): Time-boxed iterations that group epics and work items with delivery dates. Sprints progress through planned \u2192 active \u2192 completed (or cancelled).
 **Meetings**: Meeting records with attendees, agendas, and notes.
 
-**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.
+**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, the Delivery Manager plans sprints and tracks dates and progress. Work items are associated with sprints via \`sprint:SP-xxx\` tags.
 
 - **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 tool5 } from "@anthropic-ai/claude-agent-sdk";
+import { tool as tool7 } from "@anthropic-ai/claude-agent-sdk";
 function createUseCaseTools(store) {
   return [
-    tool5(
+    tool7(
       "list_use_cases",
       "List all extension use cases, optionally filtered by status or extension type",
       {
@@ -14798,7 +15196,7 @@ function createUseCaseTools(store) {
       },
       { annotations: { readOnly: true } }
     ),
-    tool5(
+    tool7(
       "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')") },
@@ -14825,7 +15223,7 @@ function createUseCaseTools(store) {
       },
       { annotations: { readOnly: true } }
     ),
-    tool5(
+    tool7(
       "create_use_case",
       "Create a new extension use case definition (Phase 1: Assess Extension Use Case)",
       {
@@ -14859,7 +15257,7 @@ function createUseCaseTools(store) {
         };
       }
     ),
-    tool5(
+    tool7(
       "update_use_case",
       "Update an existing extension use case",
       {
@@ -14889,10 +15287,10 @@ function createUseCaseTools(store) {
 }
 
 // src/plugins/builtin/tools/tech-assessments.ts
-import { tool as tool6 } from "@anthropic-ai/claude-agent-sdk";
+import { tool as tool8 } from "@anthropic-ai/claude-agent-sdk";
 function createTechAssessmentTools(store) {
   return [
-    tool6(
+    tool8(
       "list_tech_assessments",
       "List all technology assessments, optionally filtered by status",
       {
@@ -14923,7 +15321,7 @@ function createTechAssessmentTools(store) {
       },
       { annotations: { readOnly: true } }
     ),
-    tool6(
+    tool8(
       "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')") },
@@ -14950,7 +15348,7 @@ function createTechAssessmentTools(store) {
       },
       { annotations: { readOnly: true } }
     ),
-    tool6(
+    tool8(
       "create_tech_assessment",
       "Create a new technology assessment linked to an assessed/approved use case (Phase 2: Assess Extension Technology)",
       {
@@ -15021,7 +15419,7 @@ function createTechAssessmentTools(store) {
         };
       }
     ),
-    tool6(
+    tool8(
       "update_tech_assessment",
       "Update an existing technology assessment. The linked use case cannot be changed.",
       {
@@ -15051,10 +15449,10 @@ function createTechAssessmentTools(store) {
 }
 
 // src/plugins/builtin/tools/extension-designs.ts
-import { tool as tool7 } from "@anthropic-ai/claude-agent-sdk";
+import { tool as tool9 } from "@anthropic-ai/claude-agent-sdk";
 function createExtensionDesignTools(store) {
   return [
-    tool7(
+    tool9(
       "list_extension_designs",
       "List all extension designs, optionally filtered by status",
       {
@@ -15084,7 +15482,7 @@ function createExtensionDesignTools(store) {
       },
       { annotations: { readOnly: true } }
     ),
-    tool7(
+    tool9(
       "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')") },
@@ -15111,7 +15509,7 @@ function createExtensionDesignTools(store) {
       },
       { annotations: { readOnly: true } }
     ),
-    tool7(
+    tool9(
       "create_extension_design",
       "Create a new extension design linked to a recommended tech assessment (Phase 3: Define Extension Target Solution)",
       {
@@ -15179,7 +15577,7 @@ function createExtensionDesignTools(store) {
         };
       }
     ),
-    tool7(
+    tool9(
       "update_extension_design",
       "Update an existing extension design. The linked tech assessment cannot be changed.",
       {
@@ -15208,10 +15606,10 @@ function createExtensionDesignTools(store) {
 }
 
 // src/plugins/builtin/tools/aem-reports.ts
-import { tool as tool8 } from "@anthropic-ai/claude-agent-sdk";
+import { tool as tool10 } from "@anthropic-ai/claude-agent-sdk";
 function createAemReportTools(store) {
   return [
-    tool8(
+    tool10(
       "generate_extension_portfolio",
       "Generate a portfolio view of all use cases with their linked tech assessments and extension designs",
       {},
@@ -15263,7 +15661,7 @@ function createAemReportTools(store) {
       },
       { annotations: { readOnly: true } }
     ),
-    tool8(
+    tool10(
       "generate_tech_readiness",
       "Generate a BTP technology readiness report showing service coverage and gaps across assessments",
       {},
@@ -15315,7 +15713,7 @@ function createAemReportTools(store) {
       },
       { annotations: { readOnly: true } }
     ),
-    tool8(
+    tool10(
       "generate_phase_status",
       "Generate a phase progress report showing artifact counts and readiness per AEM phase",
       {},
@@ -15377,11 +15775,11 @@ function createAemReportTools(store) {
 import * as fs3 from "fs";
 import * as path3 from "path";
 import * as YAML2 from "yaml";
-import { tool as tool9 } from "@anthropic-ai/claude-agent-sdk";
+import { tool as tool11 } from "@anthropic-ai/claude-agent-sdk";
 var PHASES = ["assess-use-case", "assess-technology", "define-solution"];
 function createAemPhaseTools(store, marvinDir) {
   return [
-    tool9(
+    tool11(
       "get_current_phase",
       "Get the current AEM phase from project configuration",
       {},
@@ -15402,7 +15800,7 @@ function createAemPhaseTools(store, marvinDir) {
       },
       { annotations: { readOnly: true } }
     ),
-    tool9(
+    tool11(
       "advance_phase",
       "Advance to the next AEM phase. Performs soft gate checks and warns if artifacts are incomplete, but does not block.",
       {
@@ -15813,7 +16211,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
@@ -15849,9 +16248,11 @@ var deliveryManager = {
     "Team coordination",
     "Process governance",
     "Status tracking",
-    "Epic scheduling and tracking"
+    "Epic scheduling and tracking",
+    "Sprint planning and tracking"
   ],
-  documentTypes: ["action", "decision", "meeting", "question", "feature", "epic"]
+  documentTypes: ["action", "decision", "meeting", "question", "feature", "epic", "sprint"],
+  contributionTypes: ["risk-finding", "blocker-report", "dependency-update", "status-assessment"]
 };
 
 // src/personas/builtin/tech-lead.ts
@@ -15887,9 +16288,11 @@ var techLead = {
     "Technical decisions",
     "Implementation guidance",
     "Non-functional requirements",
-    "Epic creation and scoping"
+    "Epic creation and scoping",
+    "Sprint scoping and technical execution"
   ],
-  documentTypes: ["decision", "action", "question", "epic"]
+  documentTypes: ["decision", "action", "question", "epic", "sprint"],
+  contributionTypes: ["action-result", "spike-findings", "technical-assessment", "architecture-review"]
 };
 
 // src/personas/registry.ts
@@ -15947,6 +16350,7 @@ You have access to governance tools for managing project artifacts:
 - **Questions** (Q-xxx): List, get, create, and update questions
 - **Features** (F-xxx): List, get, create, and update feature definitions
 - **Epics** (E-xxx): List, get, create, and update implementation epics (must link to approved features)
+- **Sprints** (SP-xxx): List, get, create, and update time-boxed iterations with linked epics and delivery dates
 - **Documents**: Search and read any project document
 - **Sources**: List source documents and view their processing status and derived artifacts
 
@@ -16046,9 +16450,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;
@@ -16059,9 +16463,9 @@ var DocumentStore = class {
         const filePath = path5.join(dir, file2);
         const raw = fs5.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);
       }
@@ -16264,10 +16668,10 @@ import {
 } from "@anthropic-ai/claude-agent-sdk";
 
 // src/agent/tools/decisions.ts
-import { tool as tool10 } from "@anthropic-ai/claude-agent-sdk";
+import { tool as tool12 } from "@anthropic-ai/claude-agent-sdk";
 function createDecisionTools(store) {
   return [
-    tool10(
+    tool12(
       "list_decisions",
       "List all decisions in the project, optionally filtered by status",
       { status: external_exports.string().optional().describe("Filter by status (e.g. 'open', 'decided', 'superseded')") },
@@ -16285,7 +16689,7 @@ function createDecisionTools(store) {
       },
       { annotations: { readOnly: true } }
     ),
-    tool10(
+    tool12(
       "get_decision",
       "Get the full content of a specific decision by ID",
       { id: external_exports.string().describe("Decision ID (e.g. 'D-001')") },
@@ -16312,7 +16716,7 @@ function createDecisionTools(store) {
       },
       { annotations: { readOnly: true } }
     ),
-    tool10(
+    tool12(
       "create_decision",
       "Create a new decision record",
       {
@@ -16343,7 +16747,7 @@ function createDecisionTools(store) {
         };
       }
     ),
-    tool10(
+    tool12(
       "update_decision",
       "Update an existing decision",
       {
@@ -16370,10 +16774,10 @@ function createDecisionTools(store) {
 }
 
 // src/agent/tools/actions.ts
-import { tool as tool11 } from "@anthropic-ai/claude-agent-sdk";
+import { tool as tool13 } from "@anthropic-ai/claude-agent-sdk";
 function createActionTools(store) {
   return [
-    tool11(
+    tool13(
       "list_actions",
       "List all action items in the project, optionally filtered by status or owner",
       {
@@ -16400,7 +16804,7 @@ function createActionTools(store) {
       },
       { annotations: { readOnly: true } }
     ),
-    tool11(
+    tool13(
       "get_action",
       "Get the full content of a specific action item by ID",
       { id: external_exports.string().describe("Action ID (e.g. 'A-001')") },
@@ -16427,7 +16831,7 @@ function createActionTools(store) {
       },
       { annotations: { readOnly: true } }
     ),
-    tool11(
+    tool13(
       "create_action",
       "Create a new action item",
       {
@@ -16460,7 +16864,7 @@ function createActionTools(store) {
         };
       }
     ),
-    tool11(
+    tool13(
       "update_action",
       "Update an existing action item",
       {
@@ -16488,10 +16892,10 @@ function createActionTools(store) {
 }
 
 // src/agent/tools/questions.ts
-import { tool as tool12 } from "@anthropic-ai/claude-agent-sdk";
+import { tool as tool14 } from "@anthropic-ai/claude-agent-sdk";
 function createQuestionTools(store) {
   return [
-    tool12(
+    tool14(
       "list_questions",
       "List all questions in the project, optionally filtered by status",
       {
@@ -16512,7 +16916,7 @@ function createQuestionTools(store) {
       },
       { annotations: { readOnly: true } }
     ),
-    tool12(
+    tool14(
       "get_question",
       "Get the full content of a specific question by ID",
       { id: external_exports.string().describe("Question ID (e.g. 'Q-001')") },
@@ -16539,7 +16943,7 @@ function createQuestionTools(store) {
       },
       { annotations: { readOnly: true } }
     ),
-    tool12(
+    tool14(
       "create_question",
       "Create a new question that needs to be answered",
       {
@@ -16570,7 +16974,7 @@ function createQuestionTools(store) {
         };
       }
     ),
-    tool12(
+    tool14(
       "update_question",
       "Update an existing question",
       {
@@ -16597,10 +17001,10 @@ function createQuestionTools(store) {
 }
 
 // src/agent/tools/documents.ts
-import { tool as tool13 } from "@anthropic-ai/claude-agent-sdk";
+import { tool as tool15 } from "@anthropic-ai/claude-agent-sdk";
 function createDocumentTools(store) {
   return [
-    tool13(
+    tool15(
       "search_documents",
       "Search all project documents, optionally filtered by type, status, or tag",
       {
@@ -16632,7 +17036,7 @@ function createDocumentTools(store) {
       },
       { annotations: { readOnly: true } }
     ),
-    tool13(
+    tool15(
       "read_document",
       "Read the full content of any project document by ID",
       { id: external_exports.string().describe("Document ID (e.g. 'D-001', 'A-003', 'Q-002')") },
@@ -16659,7 +17063,7 @@ function createDocumentTools(store) {
       },
       { annotations: { readOnly: true } }
     ),
-    tool13(
+    tool15(
       "project_summary",
       "Get a summary of all project documents and their counts",
       {},
@@ -16691,10 +17095,10 @@ function createDocumentTools(store) {
 }
 
 // src/agent/tools/sources.ts
-import { tool as tool14 } from "@anthropic-ai/claude-agent-sdk";
+import { tool as tool16 } from "@anthropic-ai/claude-agent-sdk";
 function createSourceTools(manifest) {
   return [
-    tool14(
+    tool16(
       "list_sources",
       "List all source documents and their processing status",
       {
@@ -16724,7 +17128,7 @@ function createSourceTools(manifest) {
       },
       { annotations: { readOnly: true } }
     ),
-    tool14(
+    tool16(
       "get_source_info",
       "Get detailed information about a specific source document",
       {
@@ -16762,10 +17166,10 @@ function createSourceTools(manifest) {
 }
 
 // src/agent/tools/sessions.ts
-import { tool as tool15 } from "@anthropic-ai/claude-agent-sdk";
+import { tool as tool17 } from "@anthropic-ai/claude-agent-sdk";
 function createSessionTools(store) {
   return [
-    tool15(
+    tool17(
       "list_sessions",
       "List all saved chat sessions, sorted by most recently used",
       {
@@ -16789,7 +17193,7 @@ function createSessionTools(store) {
       },
       { annotations: { readOnly: true } }
     ),
-    tool15(
+    tool17(
       "get_session",
       "Get details of a specific saved session by name",
       { name: external_exports.string().describe("Session name (e.g. 'jwt-auth-decision')") },
@@ -18378,7 +18782,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 tool18 } from "@anthropic-ai/claude-agent-sdk";
 
 // src/skills/action-runner.ts
 import { query as query4 } from "@anthropic-ai/claude-agent-sdk";
@@ -18444,7 +18848,7 @@ function createSkillActionTools(skills, context) {
     if (!skill.actions) continue;
     for (const action of skill.actions) {
       tools.push(
-        tool16(
+        tool18(
           `${skill.id}__${action.id}`,
           action.description,
           {
@@ -18536,10 +18940,10 @@ ${lines.join("\n\n")}`;
 }
 
 // src/mcp/persona-tools.ts
-import { tool as tool17 } from "@anthropic-ai/claude-agent-sdk";
+import { tool as tool19 } from "@anthropic-ai/claude-agent-sdk";
 function createPersonaTools(ctx, marvinDir) {
   return [
-    tool17(
+    tool19(
       "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.",
       {
@@ -18569,7 +18973,7 @@ ${summaries}`
         };
       }
     ),
-    tool17(
+    tool19(
       "get_persona_guidance",
       "Get guidance for a persona without changing the active persona. If no persona is specified, lists all available personas with summaries.",
       {
@@ -19184,7 +19588,8 @@ function getDirNameForType(store, type) {
     meeting: "meetings",
     report: "reports",
     feature: "features",
-    epic: "epics"
+    epic: "epics",
+    sprint: "sprints"
   };
   return typeDir[type] ?? `${type}s`;
 }
@@ -19681,12 +20086,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 program2 = new Command();
   program2.name("marvin").description(
     "AI-powered product development assistant with Product Owner, Delivery Manager, and Technical Lead personas"
-  ).version("0.2.3");
+  ).version("0.2.5");
   program2.command("init").description("Initialize a new Marvin project in the current directory").action(async () => {
     await initCommand();
   });
@@ -19729,6 +20539,9 @@ function createProgram() {
   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("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);
+  });
   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)"