mrvn-cli 0.2.4 → 0.2.5

package/dist/marvin-serve.js

@@ -15183,6 +15183,60 @@ function createReportTools(store) {
       },
       { annotations: { readOnly: true } }
     ),
+    tool8(
+      "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 } }
+    ),
     tool8(
       "generate_feature_progress",
       "Generate progress report for features and their linked epics",
@@ -15229,7 +15283,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) => {
@@ -15646,13 +15700,187 @@ function createContributionTools(store) {
   ];
 }
 
+// src/plugins/builtin/tools/sprints.ts
+import { tool as tool12 } from "@anthropic-ai/claude-agent-sdk";
+function createSprintTools(store) {
+  return [
+    tool12(
+      "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 } }
+    ),
+    tool12(
+      "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 } }
+    ),
+    tool12(
+      "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") }]
+        };
+      }
+    ),
+    tool12(
+      "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: "contribution", dirName: "contributions", idPrefix: "C" }
+  { type: "contribution", dirName: "contributions", idPrefix: "C" },
+  { type: "sprint", dirName: "sprints", idPrefix: "SP" }
 ];
 function createCommonTools(store) {
   return [
@@ -15660,7 +15888,8 @@ function createCommonTools(store) {
     ...createReportTools(store),
     ...createFeatureTools(store),
     ...createEpicTools(store),
-    ...createContributionTools(store)
+    ...createContributionTools(store),
+    ...createSprintTools(store)
   ];
 }
 
@@ -15670,7 +15899,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", "contribution"],
+  documentTypes: ["decision", "action", "question", "meeting", "report", "feature", "epic", "contribution", "sprint"],
   documentTypeRegistrations: [...COMMON_REGISTRATIONS],
   tools: (store) => [...createCommonTools(store)],
   promptFragments: {
@@ -15697,7 +15926,10 @@ var genericAgilePlugin = {
 - **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.`,
+- 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:**
@@ -15724,7 +15956,13 @@ var genericAgilePlugin = {
 - **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.`,
+- 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:**
@@ -15758,14 +15996,29 @@ var genericAgilePlugin = {
 - **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:
+- 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.
@@ -15780,10 +16033,10 @@ var genericAgilePlugin = {
 };
 
 // src/plugins/builtin/tools/use-cases.ts
-import { tool as tool12 } from "@anthropic-ai/claude-agent-sdk";
+import { tool as tool13 } from "@anthropic-ai/claude-agent-sdk";
 function createUseCaseTools(store) {
   return [
-    tool12(
+    tool13(
       "list_use_cases",
       "List all extension use cases, optionally filtered by status or extension type",
       {
@@ -15813,7 +16066,7 @@ function createUseCaseTools(store) {
       },
       { annotations: { readOnly: true } }
     ),
-    tool12(
+    tool13(
       "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')") },
@@ -15840,7 +16093,7 @@ function createUseCaseTools(store) {
       },
       { annotations: { readOnly: true } }
     ),
-    tool12(
+    tool13(
       "create_use_case",
       "Create a new extension use case definition (Phase 1: Assess Extension Use Case)",
       {
@@ -15874,7 +16127,7 @@ function createUseCaseTools(store) {
         };
       }
     ),
-    tool12(
+    tool13(
       "update_use_case",
       "Update an existing extension use case",
       {
@@ -15904,10 +16157,10 @@ function createUseCaseTools(store) {
 }
 
 // src/plugins/builtin/tools/tech-assessments.ts
-import { tool as tool13 } from "@anthropic-ai/claude-agent-sdk";
+import { tool as tool14 } from "@anthropic-ai/claude-agent-sdk";
 function createTechAssessmentTools(store) {
   return [
-    tool13(
+    tool14(
       "list_tech_assessments",
       "List all technology assessments, optionally filtered by status",
       {
@@ -15938,7 +16191,7 @@ function createTechAssessmentTools(store) {
       },
       { annotations: { readOnly: true } }
     ),
-    tool13(
+    tool14(
       "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')") },
@@ -15965,7 +16218,7 @@ function createTechAssessmentTools(store) {
       },
       { annotations: { readOnly: true } }
     ),
-    tool13(
+    tool14(
       "create_tech_assessment",
       "Create a new technology assessment linked to an assessed/approved use case (Phase 2: Assess Extension Technology)",
       {
@@ -16036,7 +16289,7 @@ function createTechAssessmentTools(store) {
         };
       }
     ),
-    tool13(
+    tool14(
       "update_tech_assessment",
       "Update an existing technology assessment. The linked use case cannot be changed.",
       {
@@ -16066,10 +16319,10 @@ function createTechAssessmentTools(store) {
 }
 
 // src/plugins/builtin/tools/extension-designs.ts
-import { tool as tool14 } from "@anthropic-ai/claude-agent-sdk";
+import { tool as tool15 } from "@anthropic-ai/claude-agent-sdk";
 function createExtensionDesignTools(store) {
   return [
-    tool14(
+    tool15(
       "list_extension_designs",
       "List all extension designs, optionally filtered by status",
       {
@@ -16099,7 +16352,7 @@ function createExtensionDesignTools(store) {
       },
       { annotations: { readOnly: true } }
     ),
-    tool14(
+    tool15(
       "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')") },
@@ -16126,7 +16379,7 @@ function createExtensionDesignTools(store) {
       },
       { annotations: { readOnly: true } }
     ),
-    tool14(
+    tool15(
       "create_extension_design",
       "Create a new extension design linked to a recommended tech assessment (Phase 3: Define Extension Target Solution)",
       {
@@ -16194,7 +16447,7 @@ function createExtensionDesignTools(store) {
         };
       }
     ),
-    tool14(
+    tool15(
       "update_extension_design",
       "Update an existing extension design. The linked tech assessment cannot be changed.",
       {
@@ -16223,10 +16476,10 @@ function createExtensionDesignTools(store) {
 }
 
 // src/plugins/builtin/tools/aem-reports.ts
-import { tool as tool15 } from "@anthropic-ai/claude-agent-sdk";
+import { tool as tool16 } from "@anthropic-ai/claude-agent-sdk";
 function createAemReportTools(store) {
   return [
-    tool15(
+    tool16(
       "generate_extension_portfolio",
       "Generate a portfolio view of all use cases with their linked tech assessments and extension designs",
       {},
@@ -16278,7 +16531,7 @@ function createAemReportTools(store) {
       },
       { annotations: { readOnly: true } }
     ),
-    tool15(
+    tool16(
       "generate_tech_readiness",
       "Generate a BTP technology readiness report showing service coverage and gaps across assessments",
       {},
@@ -16330,7 +16583,7 @@ function createAemReportTools(store) {
       },
       { annotations: { readOnly: true } }
     ),
-    tool15(
+    tool16(
       "generate_phase_status",
       "Generate a phase progress report showing artifact counts and readiness per AEM phase",
       {},
@@ -16392,11 +16645,11 @@ function createAemReportTools(store) {
 import * as fs6 from "fs";
 import * as path6 from "path";
 import * as YAML4 from "yaml";
-import { tool as tool16 } from "@anthropic-ai/claude-agent-sdk";
+import { tool as tool17 } from "@anthropic-ai/claude-agent-sdk";
 var PHASES = ["assess-use-case", "assess-technology", "define-solution"];
 function createAemPhaseTools(store, marvinDir) {
   return [
-    tool16(
+    tool17(
       "get_current_phase",
       "Get the current AEM phase from project configuration",
       {},
@@ -16417,7 +16670,7 @@ function createAemPhaseTools(store, marvinDir) {
       },
       { annotations: { readOnly: true } }
     ),
-    tool16(
+    tool17(
       "advance_phase",
       "Advance to the next AEM phase. Performs soft gate checks and warns if artifacts are incomplete, but does not block.",
       {
@@ -16883,7 +17136,7 @@ ${fragment}`);
 }
 
 // src/skills/action-tools.ts
-import { tool as tool17 } from "@anthropic-ai/claude-agent-sdk";
+import { tool as tool18 } from "@anthropic-ai/claude-agent-sdk";
 
 // src/skills/action-runner.ts
 import { query } from "@anthropic-ai/claude-agent-sdk";
@@ -16973,7 +17226,7 @@ function createSkillActionTools(skills, context) {
     if (!skill.actions) continue;
     for (const action of skill.actions) {
       tools.push(
-        tool17(
+        tool18(
           `${skill.id}__${action.id}`,
           action.description,
           {
@@ -17059,9 +17312,10 @@ 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"]
 };
 
@@ -17098,9 +17352,10 @@ 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"]
 };
 
@@ -17198,10 +17453,10 @@ ${lines.join("\n\n")}`;
 }
 
 // src/mcp/persona-tools.ts
-import { tool as tool18 } from "@anthropic-ai/claude-agent-sdk";
+import { tool as tool19 } from "@anthropic-ai/claude-agent-sdk";
 function createPersonaTools(ctx, marvinDir) {
   return [
-    tool18(
+    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.",
       {
@@ -17231,7 +17486,7 @@ ${summaries}`
         };
       }
     ),
-    tool18(
+    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.",
       {