mrvn-cli 0.2.4 → 0.2.6

package/dist/index.js

@@ -438,9 +438,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"]
 };
 
@@ -477,9 +478,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"]
 };
 
@@ -528,6 +530,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
 
@@ -15511,6 +15514,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",
@@ -15557,7 +15614,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) => {
@@ -15974,13 +16031,369 @@ 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/builtin/tools/sprint-planning.ts
+import { tool as tool13 } from "@anthropic-ai/claude-agent-sdk";
+var PRIORITY_ORDER = {
+  critical: 0,
+  high: 1,
+  medium: 2,
+  low: 3
+};
+function priorityRank(p) {
+  return PRIORITY_ORDER[p ?? ""] ?? 99;
+}
+function createSprintPlanningTools(store) {
+  return [
+    tool13(
+      "gather_sprint_planning_context",
+      "Aggregate all planning-relevant data for proposing the next sprint: approved features, backlog epics, active sprint, velocity reference, blockers, and summary stats",
+      {
+        focusFeature: external_exports.string().optional().describe("Filter backlog to epics of a specific feature ID (e.g. 'F-001')"),
+        sprintDurationDays: external_exports.number().optional().describe("Expected sprint duration in days \u2014 passed through for capacity reasoning")
+      },
+      async (args) => {
+        const features = store.list({ type: "feature" });
+        const epics = store.list({ type: "epic" });
+        const sprints = store.list({ type: "sprint" });
+        const questions = store.list({ type: "question", status: "open" });
+        const contributions = store.list({ type: "contribution" });
+        const approvedFeatures = features.filter((f) => f.frontmatter.status === "approved").sort((a, b) => priorityRank(a.frontmatter.priority) - priorityRank(b.frontmatter.priority)).map((f) => {
+          const linkedEpics = epics.filter((e) => e.frontmatter.linkedFeature === f.frontmatter.id);
+          const epicsByStatus = {};
+          for (const e of linkedEpics) {
+            epicsByStatus[e.frontmatter.status] = (epicsByStatus[e.frontmatter.status] ?? 0) + 1;
+          }
+          return {
+            id: f.frontmatter.id,
+            title: f.frontmatter.title,
+            priority: f.frontmatter.priority,
+            owner: f.frontmatter.owner,
+            epicCount: linkedEpics.length,
+            epicsByStatus
+          };
+        });
+        const assignedEpicIds = /* @__PURE__ */ new Set();
+        for (const sp of sprints) {
+          const linked = sp.frontmatter.linkedEpics ?? [];
+          for (const id of linked) assignedEpicIds.add(id);
+        }
+        const featureMap = new Map(features.map((f) => [f.frontmatter.id, f]));
+        let backlogEpics = epics.filter(
+          (e) => !assignedEpicIds.has(e.frontmatter.id) && e.frontmatter.status !== "done"
+        );
+        if (args.focusFeature) {
+          backlogEpics = backlogEpics.filter(
+            (e) => e.frontmatter.linkedFeature === args.focusFeature
+          );
+        }
+        const backlog = backlogEpics.sort((a, b) => {
+          const fa = featureMap.get(a.frontmatter.linkedFeature);
+          const fb = featureMap.get(b.frontmatter.linkedFeature);
+          return priorityRank(fa?.frontmatter.priority) - priorityRank(fb?.frontmatter.priority);
+        }).map((e) => {
+          const parent = featureMap.get(e.frontmatter.linkedFeature);
+          return {
+            id: e.frontmatter.id,
+            title: e.frontmatter.title,
+            status: e.frontmatter.status,
+            linkedFeature: e.frontmatter.linkedFeature,
+            featureTitle: parent?.frontmatter.title ?? null,
+            featurePriority: parent?.frontmatter.priority ?? null,
+            estimatedEffort: e.frontmatter.estimatedEffort ?? null,
+            targetDate: e.frontmatter.targetDate ?? null
+          };
+        });
+        const activeSprintDoc = sprints.find((s) => s.frontmatter.status === "active") ?? null;
+        let activeSprint = null;
+        if (activeSprintDoc) {
+          const linkedEpicIds = activeSprintDoc.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 allDocs = store.list();
+          const sprintTag = `sprint:${activeSprintDoc.frontmatter.id}`;
+          const workItems = allDocs.filter(
+            (d) => d.frontmatter.type !== "sprint" && d.frontmatter.type !== "epic" && d.frontmatter.tags?.includes(sprintTag)
+          );
+          const doneCount = workItems.filter(
+            (d) => d.frontmatter.status === "done" || d.frontmatter.status === "resolved" || d.frontmatter.status === "closed"
+          ).length;
+          const completionPct = workItems.length > 0 ? Math.round(doneCount / workItems.length * 100) : 0;
+          activeSprint = {
+            id: activeSprintDoc.frontmatter.id,
+            title: activeSprintDoc.frontmatter.title,
+            goal: activeSprintDoc.frontmatter.goal,
+            startDate: activeSprintDoc.frontmatter.startDate,
+            endDate: activeSprintDoc.frontmatter.endDate,
+            linkedEpics,
+            workItems: { total: workItems.length, done: doneCount, completionPct }
+          };
+        }
+        const completedSprints = sprints.filter((s) => s.frontmatter.status === "completed").sort((a, b) => {
+          const da = a.frontmatter.endDate ?? "";
+          const db = b.frontmatter.endDate ?? "";
+          return da < db ? 1 : da > db ? -1 : 0;
+        }).slice(0, 2);
+        const velocityReference = completedSprints.map((sp) => {
+          const linkedEpicIds = sp.frontmatter.linkedEpics ?? [];
+          const efforts = [];
+          for (const epicId of linkedEpicIds) {
+            const epic = store.get(epicId);
+            if (epic?.frontmatter.estimatedEffort) {
+              efforts.push(String(epic.frontmatter.estimatedEffort));
+            }
+          }
+          const allDocs = store.list();
+          const sprintTag = `sprint:${sp.frontmatter.id}`;
+          const workItems = allDocs.filter(
+            (d) => d.frontmatter.type !== "sprint" && d.frontmatter.type !== "epic" && d.frontmatter.tags?.includes(sprintTag)
+          );
+          return {
+            id: sp.frontmatter.id,
+            title: sp.frontmatter.title,
+            startDate: sp.frontmatter.startDate,
+            endDate: sp.frontmatter.endDate,
+            epicCount: linkedEpicIds.length,
+            efforts,
+            workItemCount: workItems.length
+          };
+        });
+        const openBlockerContributions = contributions.filter(
+          (c) => c.frontmatter.status === "open" && (c.frontmatter.contributionType === "risk-finding" || c.frontmatter.contributionType === "blocker-report")
+        );
+        const blockers = {
+          openQuestions: questions.map((q) => ({
+            id: q.frontmatter.id,
+            title: q.frontmatter.title
+          })),
+          openRiskAndBlockerContributions: openBlockerContributions.map((c) => ({
+            id: c.frontmatter.id,
+            title: c.frontmatter.title,
+            contributionType: c.frontmatter.contributionType
+          }))
+        };
+        const totalBacklogEfforts = backlog.filter((e) => e.estimatedEffort !== null).map((e) => String(e.estimatedEffort));
+        const approvedFeaturesWithNoEpics = approvedFeatures.filter((f) => f.epicCount === 0).map((f) => ({ id: f.id, title: f.title }));
+        const now = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+        const epicsAtRisk = epics.filter((e) => {
+          if (e.frontmatter.status === "done") return false;
+          if (e.frontmatter.targetDate && e.frontmatter.targetDate < now) return true;
+          const parent = featureMap.get(e.frontmatter.linkedFeature);
+          if (parent?.frontmatter.status === "deferred") return true;
+          return false;
+        }).map((e) => ({
+          id: e.frontmatter.id,
+          title: e.frontmatter.title,
+          reason: e.frontmatter.targetDate && e.frontmatter.targetDate < now ? "past-target-date" : "deferred-feature"
+        }));
+        const plannedSprintCount = sprints.filter((s) => s.frontmatter.status === "planned").length;
+        const summary = {
+          totalBacklogEpics: backlog.length,
+          totalBacklogEfforts,
+          approvedFeaturesWithNoEpics,
+          epicsAtRisk,
+          plannedSprintCount
+        };
+        const result = {
+          approvedFeatures,
+          backlog,
+          activeSprint,
+          velocityReference,
+          blockers,
+          summary,
+          ...args.sprintDurationDays !== void 0 ? { sprintDurationDays: args.sprintDurationDays } : {}
+        };
+        return {
+          content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+        };
+      },
+      { annotations: { readOnly: true } }
+    )
+  ];
+}
+
 // 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 [
@@ -15988,7 +16401,9 @@ function createCommonTools(store) {
     ...createReportTools(store),
     ...createFeatureTools(store),
     ...createEpicTools(store),
-    ...createContributionTools(store)
+    ...createContributionTools(store),
+    ...createSprintTools(store),
+    ...createSprintPlanningTools(store)
   ];
 }
 
@@ -15998,7 +16413,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: {
@@ -16025,7 +16440,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:**
@@ -16052,7 +16470,18 @@ 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.
+
+**Sprint Planning:**
+- When asked to plan or propose a sprint, ALWAYS call **gather_sprint_planning_context** first.
+- Focus on: technical readiness of each epic, open technical questions or spikes, effort balance across the sprint, and feature coverage.
+- Present a structured sprint proposal with technical rationale for each selected epic, known technical risks, and any prerequisite work that should be completed first.`,
     "delivery-manager": `You track delivery across features and epics, manage schedules, and report on progress.
 
 **Report Tools:**
@@ -16086,14 +16515,35 @@ 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.
+
+**Sprint Planning:**
+- When asked to plan or propose a sprint, ALWAYS call **gather_sprint_planning_context** first. It aggregates approved features, backlog epics, active sprint status, velocity from recent sprints, blockers, and summary stats in one call.
+- Reason through: priority (critical/high features first), capacity (compare backlog effort to velocity reference), dependencies and blockers, balance across features, and risk.
+- Present a structured sprint proposal: title, goal, suggested dates, selected epics with rationale for each, excluded epics with reason, and identified risks.
+- After user confirmation, use **create_sprint** with the agreed epics to persist the sprint.`,
+    "*": `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.
@@ -16108,10 +16558,10 @@ var genericAgilePlugin = {
 };
 
 // src/plugins/builtin/tools/use-cases.ts
-import { tool as tool12 } from "@anthropic-ai/claude-agent-sdk";
+import { tool as tool14 } from "@anthropic-ai/claude-agent-sdk";
 function createUseCaseTools(store) {
   return [
-    tool12(
+    tool14(
       "list_use_cases",
       "List all extension use cases, optionally filtered by status or extension type",
       {
@@ -16141,7 +16591,7 @@ function createUseCaseTools(store) {
       },
       { annotations: { readOnly: true } }
     ),
-    tool12(
+    tool14(
       "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')") },
@@ -16168,7 +16618,7 @@ function createUseCaseTools(store) {
       },
       { annotations: { readOnly: true } }
     ),
-    tool12(
+    tool14(
       "create_use_case",
       "Create a new extension use case definition (Phase 1: Assess Extension Use Case)",
       {
@@ -16202,7 +16652,7 @@ function createUseCaseTools(store) {
         };
       }
     ),
-    tool12(
+    tool14(
       "update_use_case",
       "Update an existing extension use case",
       {
@@ -16232,10 +16682,10 @@ function createUseCaseTools(store) {
 }
 
 // src/plugins/builtin/tools/tech-assessments.ts
-import { tool as tool13 } from "@anthropic-ai/claude-agent-sdk";
+import { tool as tool15 } from "@anthropic-ai/claude-agent-sdk";
 function createTechAssessmentTools(store) {
   return [
-    tool13(
+    tool15(
       "list_tech_assessments",
       "List all technology assessments, optionally filtered by status",
       {
@@ -16266,7 +16716,7 @@ function createTechAssessmentTools(store) {
       },
       { annotations: { readOnly: true } }
     ),
-    tool13(
+    tool15(
       "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')") },
@@ -16293,7 +16743,7 @@ function createTechAssessmentTools(store) {
       },
       { annotations: { readOnly: true } }
     ),
-    tool13(
+    tool15(
       "create_tech_assessment",
       "Create a new technology assessment linked to an assessed/approved use case (Phase 2: Assess Extension Technology)",
       {
@@ -16364,7 +16814,7 @@ function createTechAssessmentTools(store) {
         };
       }
     ),
-    tool13(
+    tool15(
       "update_tech_assessment",
       "Update an existing technology assessment. The linked use case cannot be changed.",
       {
@@ -16394,10 +16844,10 @@ function createTechAssessmentTools(store) {
 }
 
 // src/plugins/builtin/tools/extension-designs.ts
-import { tool as tool14 } from "@anthropic-ai/claude-agent-sdk";
+import { tool as tool16 } from "@anthropic-ai/claude-agent-sdk";
 function createExtensionDesignTools(store) {
   return [
-    tool14(
+    tool16(
       "list_extension_designs",
       "List all extension designs, optionally filtered by status",
       {
@@ -16427,7 +16877,7 @@ function createExtensionDesignTools(store) {
       },
       { annotations: { readOnly: true } }
     ),
-    tool14(
+    tool16(
       "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')") },
@@ -16454,7 +16904,7 @@ function createExtensionDesignTools(store) {
       },
       { annotations: { readOnly: true } }
     ),
-    tool14(
+    tool16(
       "create_extension_design",
       "Create a new extension design linked to a recommended tech assessment (Phase 3: Define Extension Target Solution)",
       {
@@ -16522,7 +16972,7 @@ function createExtensionDesignTools(store) {
         };
       }
     ),
-    tool14(
+    tool16(
       "update_extension_design",
       "Update an existing extension design. The linked tech assessment cannot be changed.",
       {
@@ -16551,10 +17001,10 @@ function createExtensionDesignTools(store) {
 }
 
 // src/plugins/builtin/tools/aem-reports.ts
-import { tool as tool15 } from "@anthropic-ai/claude-agent-sdk";
+import { tool as tool17 } from "@anthropic-ai/claude-agent-sdk";
 function createAemReportTools(store) {
   return [
-    tool15(
+    tool17(
       "generate_extension_portfolio",
       "Generate a portfolio view of all use cases with their linked tech assessments and extension designs",
       {},
@@ -16606,7 +17056,7 @@ function createAemReportTools(store) {
       },
       { annotations: { readOnly: true } }
     ),
-    tool15(
+    tool17(
       "generate_tech_readiness",
       "Generate a BTP technology readiness report showing service coverage and gaps across assessments",
       {},
@@ -16658,7 +17108,7 @@ function createAemReportTools(store) {
       },
       { annotations: { readOnly: true } }
     ),
-    tool15(
+    tool17(
       "generate_phase_status",
       "Generate a phase progress report showing artifact counts and readiness per AEM phase",
       {},
@@ -16720,11 +17170,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 tool18 } from "@anthropic-ai/claude-agent-sdk";
 var PHASES = ["assess-use-case", "assess-technology", "define-solution"];
 function createAemPhaseTools(store, marvinDir) {
   return [
-    tool16(
+    tool18(
       "get_current_phase",
       "Get the current AEM phase from project configuration",
       {},
@@ -16745,7 +17195,7 @@ function createAemPhaseTools(store, marvinDir) {
       },
       { annotations: { readOnly: true } }
     ),
-    tool16(
+    tool18(
       "advance_phase",
       "Advance to the next AEM phase. Performs soft gate checks and warns if artifacts are incomplete, but does not block.",
       {
@@ -17520,7 +17970,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 tool17 } from "@anthropic-ai/claude-agent-sdk";
+import { tool as tool19 } from "@anthropic-ai/claude-agent-sdk";
 
 // src/skills/action-runner.ts
 import { query as query3 } from "@anthropic-ai/claude-agent-sdk";
@@ -17586,7 +18036,7 @@ function createSkillActionTools(skills, context) {
     if (!skill.actions) continue;
     for (const action of skill.actions) {
       tools.push(
-        tool17(
+        tool19(
           `${skill.id}__${action.id}`,
           action.description,
           {
@@ -17678,10 +18128,10 @@ ${lines.join("\n\n")}`;
 }
 
 // src/mcp/persona-tools.ts
-import { tool as tool18 } from "@anthropic-ai/claude-agent-sdk";
+import { tool as tool20 } from "@anthropic-ai/claude-agent-sdk";
 function createPersonaTools(ctx, marvinDir) {
   return [
-    tool18(
+    tool20(
       "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.",
       {
@@ -17711,7 +18161,7 @@ ${summaries}`
         };
       }
     ),
-    tool18(
+    tool20(
       "get_persona_guidance",
       "Get guidance for a persona without changing the active persona. If no persona is specified, lists all available personas with summaries.",
       {
@@ -19338,7 +19788,8 @@ function getDirNameForType(store, type) {
     meeting: "meetings",
     report: "reports",
     feature: "features",
-    epic: "epics"
+    epic: "epics",
+    sprint: "sprints"
   };
   return typeDir[type] ?? `${type}s`;
 }
@@ -20245,7 +20696,7 @@ function createProgram() {
   const program = new Command();
   program.name("marvin").description(
     "AI-powered product development assistant with Product Owner, Delivery Manager, and Technical Lead personas"
-  ).version("0.2.4");
+  ).version("0.2.6");
   program.command("init").description("Initialize a new Marvin project in the current directory").action(async () => {
     await initCommand();
   });