mrvn-cli 0.4.6 → 0.4.8

package/dist/marvin.js

@@ -14495,6 +14495,385 @@ function evaluateHealth(projectName, metrics) {
   };
 }
 
+// src/plugins/builtin/tools/task-utils.ts
+function normalizeLinkedEpics(value) {
+  if (value === void 0 || value === null) return [];
+  if (typeof value === "string") {
+    try {
+      const parsed = JSON.parse(value);
+      if (Array.isArray(parsed)) return parsed.filter((v) => typeof v === "string");
+    } catch {
+    }
+    return [value];
+  }
+  if (Array.isArray(value)) return value.filter((v) => typeof v === "string");
+  return [];
+}
+function generateEpicTags(epics) {
+  return epics.map((id) => `epic:${id}`);
+}
+
+// src/reports/sprint-summary/collector.ts
+var DONE_STATUSES = /* @__PURE__ */ new Set(["done", "closed", "resolved", "cancelled"]);
+function collectSprintSummaryData(store, sprintId) {
+  const allDocs = store.list();
+  const sprintDocs = allDocs.filter((d) => d.frontmatter.type === "sprint");
+  let sprintDoc;
+  if (sprintId) {
+    sprintDoc = sprintDocs.find((d) => d.frontmatter.id === sprintId);
+  } else {
+    sprintDoc = sprintDocs.find((d) => d.frontmatter.status === "active");
+  }
+  if (!sprintDoc) return null;
+  const fm = sprintDoc.frontmatter;
+  const startDate = fm.startDate;
+  const endDate = fm.endDate;
+  const today = /* @__PURE__ */ new Date();
+  const todayStr = today.toISOString().slice(0, 10);
+  let daysElapsed = 0;
+  let daysRemaining = 0;
+  let totalDays = 0;
+  let percentComplete = 0;
+  if (startDate && endDate) {
+    const startMs = new Date(startDate).getTime();
+    const endMs = new Date(endDate).getTime();
+    const todayMs = today.getTime();
+    const msPerDay = 864e5;
+    totalDays = Math.max(1, Math.round((endMs - startMs) / msPerDay));
+    daysElapsed = Math.max(0, Math.round((todayMs - startMs) / msPerDay));
+    daysRemaining = Math.max(0, Math.round((endMs - todayMs) / msPerDay));
+    percentComplete = Math.min(100, Math.round(daysElapsed / totalDays * 100));
+  }
+  const linkedEpicIds = normalizeLinkedEpics(fm.linkedEpics);
+  const epicToTasks = /* @__PURE__ */ new Map();
+  const allTasks = allDocs.filter((d) => d.frontmatter.type === "task");
+  for (const task of allTasks) {
+    const tags = task.frontmatter.tags ?? [];
+    for (const tag of tags) {
+      if (tag.startsWith("epic:")) {
+        const epicId = tag.slice(5);
+        if (!epicToTasks.has(epicId)) epicToTasks.set(epicId, []);
+        epicToTasks.get(epicId).push(task);
+      }
+    }
+  }
+  const linkedEpics = linkedEpicIds.map((epicId) => {
+    const epic = store.get(epicId);
+    const tasks = epicToTasks.get(epicId) ?? [];
+    const tasksDone = tasks.filter((t) => DONE_STATUSES.has(t.frontmatter.status)).length;
+    return {
+      id: epicId,
+      title: epic?.frontmatter.title ?? "(not found)",
+      status: epic?.frontmatter.status ?? "unknown",
+      tasksDone,
+      tasksTotal: tasks.length
+    };
+  });
+  const sprintTag = `sprint:${fm.id}`;
+  const workItemDocs = allDocs.filter(
+    (d) => d.frontmatter.type !== "sprint" && d.frontmatter.type !== "epic" && d.frontmatter.tags?.includes(sprintTag)
+  );
+  const primaryDocs = workItemDocs.filter((d) => d.frontmatter.type !== "contribution");
+  const byStatus = {};
+  const byType = {};
+  let doneCount = 0;
+  let inProgressCount = 0;
+  let openCount = 0;
+  let blockedCount = 0;
+  for (const doc of primaryDocs) {
+    const s = doc.frontmatter.status;
+    byStatus[s] = (byStatus[s] ?? 0) + 1;
+    byType[doc.frontmatter.type] = (byType[doc.frontmatter.type] ?? 0) + 1;
+    if (DONE_STATUSES.has(s)) doneCount++;
+    else if (s === "in-progress") inProgressCount++;
+    else if (s === "blocked") blockedCount++;
+    else openCount++;
+  }
+  const allItemsById = /* @__PURE__ */ new Map();
+  const childrenByParent = /* @__PURE__ */ new Map();
+  const sprintItemIds = new Set(workItemDocs.map((d) => d.frontmatter.id));
+  for (const doc of workItemDocs) {
+    const about = doc.frontmatter.aboutArtifact;
+    const item = {
+      id: doc.frontmatter.id,
+      title: doc.frontmatter.title,
+      type: doc.frontmatter.type,
+      status: doc.frontmatter.status,
+      aboutArtifact: about
+    };
+    allItemsById.set(item.id, item);
+    if (about && sprintItemIds.has(about)) {
+      if (!childrenByParent.has(about)) childrenByParent.set(about, []);
+      childrenByParent.get(about).push(item);
+    }
+  }
+  const itemsWithChildren = /* @__PURE__ */ new Set();
+  for (const [parentId, children] of childrenByParent) {
+    const parent = allItemsById.get(parentId);
+    if (parent) {
+      parent.children = children;
+      for (const child of children) itemsWithChildren.add(child.id);
+    }
+  }
+  for (const item of allItemsById.values()) {
+    if (item.children) {
+      for (const child of item.children) {
+        const grandchildren = childrenByParent.get(child.id);
+        if (grandchildren) {
+          child.children = grandchildren;
+          for (const gc of grandchildren) itemsWithChildren.add(gc.id);
+        }
+      }
+    }
+  }
+  const items = [];
+  for (const doc of workItemDocs) {
+    if (!itemsWithChildren.has(doc.frontmatter.id)) {
+      items.push(allItemsById.get(doc.frontmatter.id));
+    }
+  }
+  const workItems = {
+    total: primaryDocs.length,
+    done: doneCount,
+    inProgress: inProgressCount,
+    open: openCount,
+    blocked: blockedCount,
+    completionPct: primaryDocs.length > 0 ? Math.round(doneCount / primaryDocs.length * 100) : 0,
+    byStatus,
+    byType,
+    items
+  };
+  const meetings = [];
+  if (startDate && endDate) {
+    const meetingDocs = allDocs.filter((d) => d.frontmatter.type === "meeting");
+    for (const m of meetingDocs) {
+      const meetingDate = m.frontmatter.date ?? m.frontmatter.created.slice(0, 10);
+      if (meetingDate >= startDate && meetingDate <= endDate) {
+        meetings.push({
+          id: m.frontmatter.id,
+          title: m.frontmatter.title,
+          date: meetingDate
+        });
+      }
+    }
+    meetings.sort((a, b) => a.date.localeCompare(b.date));
+  }
+  const artifacts = [];
+  if (startDate && endDate) {
+    for (const doc of allDocs) {
+      if (doc.frontmatter.type === "sprint") continue;
+      const created = doc.frontmatter.created.slice(0, 10);
+      const updated = doc.frontmatter.updated.slice(0, 10);
+      if (created >= startDate && created <= endDate) {
+        artifacts.push({
+          id: doc.frontmatter.id,
+          title: doc.frontmatter.title,
+          type: doc.frontmatter.type,
+          action: "created",
+          date: created
+        });
+      } else if (updated >= startDate && updated <= endDate && updated !== created) {
+        artifacts.push({
+          id: doc.frontmatter.id,
+          title: doc.frontmatter.title,
+          type: doc.frontmatter.type,
+          action: "updated",
+          date: updated
+        });
+      }
+    }
+    artifacts.sort((a, b) => b.date.localeCompare(a.date));
+  }
+  const relevantTags = /* @__PURE__ */ new Set([sprintTag, ...linkedEpicIds.map((id) => `epic:${id}`)]);
+  const openActions = allDocs.filter(
+    (d) => d.frontmatter.type === "action" && !DONE_STATUSES.has(d.frontmatter.status) && d.frontmatter.tags?.some((t) => relevantTags.has(t))
+  ).map((d) => ({
+    id: d.frontmatter.id,
+    title: d.frontmatter.title,
+    owner: d.frontmatter.owner,
+    dueDate: d.frontmatter.dueDate
+  }));
+  const openQuestions = allDocs.filter(
+    (d) => d.frontmatter.type === "question" && d.frontmatter.status === "open" && d.frontmatter.tags?.some((t) => relevantTags.has(t))
+  ).map((d) => ({
+    id: d.frontmatter.id,
+    title: d.frontmatter.title
+  }));
+  const blockers = allDocs.filter(
+    (d) => d.frontmatter.status === "blocked" && d.frontmatter.tags?.includes(sprintTag)
+  ).map((d) => ({
+    id: d.frontmatter.id,
+    title: d.frontmatter.title,
+    type: d.frontmatter.type
+  }));
+  const riskBlockers = allDocs.filter(
+    (d) => !DONE_STATUSES.has(d.frontmatter.status) && d.frontmatter.tags?.includes("risk") && d.frontmatter.tags?.some((t) => relevantTags.has(t)) && !blockers.some((b) => b.id === d.frontmatter.id)
+  );
+  for (const d of riskBlockers) {
+    blockers.push({
+      id: d.frontmatter.id,
+      title: d.frontmatter.title,
+      type: d.frontmatter.type
+    });
+  }
+  let velocity = null;
+  const currentRate = workItems.completionPct;
+  const completedSprints = sprintDocs.filter((s) => DONE_STATUSES.has(s.frontmatter.status) && s.frontmatter.id !== fm.id).sort((a, b) => (b.frontmatter.endDate ?? "").localeCompare(a.frontmatter.endDate ?? ""));
+  if (completedSprints.length > 0) {
+    const prev = completedSprints[0];
+    const prevTag = `sprint:${prev.frontmatter.id}`;
+    const prevWorkItems = allDocs.filter(
+      (d) => d.frontmatter.type !== "sprint" && d.frontmatter.type !== "epic" && d.frontmatter.type !== "contribution" && d.frontmatter.tags?.includes(prevTag)
+    );
+    const prevDone = prevWorkItems.filter((d) => DONE_STATUSES.has(d.frontmatter.status)).length;
+    const prevRate = prevWorkItems.length > 0 ? Math.round(prevDone / prevWorkItems.length * 100) : 0;
+    velocity = {
+      currentCompletionRate: currentRate,
+      previousSprintRate: prevRate,
+      previousSprintId: prev.frontmatter.id
+    };
+  } else {
+    velocity = { currentCompletionRate: currentRate };
+  }
+  return {
+    sprint: {
+      id: fm.id,
+      title: fm.title,
+      goal: fm.goal,
+      status: fm.status,
+      startDate,
+      endDate
+    },
+    timeline: { daysElapsed, daysRemaining, totalDays, percentComplete },
+    linkedEpics,
+    workItems,
+    meetings,
+    artifacts,
+    openActions,
+    openQuestions,
+    blockers,
+    velocity
+  };
+}
+
+// src/reports/sprint-summary/generator.ts
+import { query } from "@anthropic-ai/claude-agent-sdk";
+async function generateSprintSummary(data) {
+  const prompt = buildPrompt(data);
+  const result = query({
+    prompt,
+    options: {
+      systemPrompt: SYSTEM_PROMPT,
+      maxTurns: 1,
+      tools: [],
+      allowedTools: []
+    }
+  });
+  for await (const msg of result) {
+    if (msg.type === "assistant") {
+      const text = msg.message.content.find(
+        (b) => b.type === "text"
+      );
+      if (text) return text.text;
+    }
+  }
+  return "Unable to generate sprint summary.";
+}
+var SYSTEM_PROMPT = `You are a delivery management assistant generating a sprint summary narrative. Produce a concise, insightful markdown report. Do NOT include a top-level heading \u2014 the caller will add one. Use the following structure:
+
+## Sprint Health
+One-line verdict on overall sprint health (healthy / at risk / behind).
+
+## Goal Progress
+How close the team is to achieving the sprint goal. Reference the goal text and completion metrics.
+
+## Key Achievements
+Notable completions, decisions made, meetings held during the sprint. Use bullet points.
+
+## Current Risks
+Blockers, overdue items, unresolved questions, items without owners. Use bullet points. If none, say so.
+
+## Outcome Projection
+Given the current pace and time remaining, what's the likely outcome? Will the sprint goal be met?
+
+Be specific \u2014 reference artifact IDs, dates, and numbers from the data. Keep the tone professional but direct.`;
+function buildPrompt(data) {
+  const sections = [];
+  sections.push(`# Sprint: ${data.sprint.id} \u2014 ${data.sprint.title}`);
+  sections.push(`Status: ${data.sprint.status}`);
+  if (data.sprint.goal) sections.push(`Goal: ${data.sprint.goal}`);
+  if (data.sprint.startDate) sections.push(`Start: ${data.sprint.startDate}`);
+  if (data.sprint.endDate) sections.push(`End: ${data.sprint.endDate}`);
+  sections.push(`
+## Timeline`);
+  sections.push(`Days elapsed: ${data.timeline.daysElapsed} / ${data.timeline.totalDays}`);
+  sections.push(`Days remaining: ${data.timeline.daysRemaining}`);
+  sections.push(`Timeline progress: ${data.timeline.percentComplete}%`);
+  sections.push(`
+## Work Items`);
+  sections.push(`Total: ${data.workItems.total}, Done: ${data.workItems.done}, In Progress: ${data.workItems.inProgress}, Open: ${data.workItems.open}, Blocked: ${data.workItems.blocked}`);
+  sections.push(`Completion: ${data.workItems.completionPct}%`);
+  if (Object.keys(data.workItems.byType).length > 0) {
+    sections.push(`By type: ${Object.entries(data.workItems.byType).map(([t, n]) => `${t}: ${n}`).join(", ")}`);
+  }
+  if (data.linkedEpics.length > 0) {
+    sections.push(`
+## Linked Epics`);
+    for (const e of data.linkedEpics) {
+      sections.push(`- ${e.id}: ${e.title} [${e.status}] \u2014 ${e.tasksDone}/${e.tasksTotal} tasks done`);
+    }
+  }
+  if (data.meetings.length > 0) {
+    sections.push(`
+## Meetings During Sprint`);
+    for (const m of data.meetings) {
+      sections.push(`- ${m.date}: ${m.id} \u2014 ${m.title}`);
+    }
+  }
+  if (data.artifacts.length > 0) {
+    sections.push(`
+## Artifacts Created/Updated During Sprint`);
+    for (const a of data.artifacts.slice(0, 20)) {
+      sections.push(`- ${a.date}: ${a.id} (${a.type}) ${a.action} \u2014 ${a.title}`);
+    }
+    if (data.artifacts.length > 20) {
+      sections.push(`... and ${data.artifacts.length - 20} more`);
+    }
+  }
+  if (data.openActions.length > 0) {
+    sections.push(`
+## Open Actions`);
+    for (const a of data.openActions) {
+      const owner = a.owner ?? "unowned";
+      const due = a.dueDate ?? "no due date";
+      sections.push(`- ${a.id}: ${a.title} (${owner}, ${due})`);
+    }
+  }
+  if (data.openQuestions.length > 0) {
+    sections.push(`
+## Open Questions`);
+    for (const q of data.openQuestions) {
+      sections.push(`- ${q.id}: ${q.title}`);
+    }
+  }
+  if (data.blockers.length > 0) {
+    sections.push(`
+## Blockers`);
+    for (const b of data.blockers) {
+      sections.push(`- ${b.id} (${b.type}): ${b.title}`);
+    }
+  }
+  if (data.velocity) {
+    sections.push(`
+## Velocity`);
+    sections.push(`Current sprint completion rate: ${data.velocity.currentCompletionRate}%`);
+    if (data.velocity.previousSprintRate !== void 0) {
+      sections.push(`Previous sprint (${data.velocity.previousSprintId}): ${data.velocity.previousSprintRate}%`);
+    }
+  }
+  return sections.join("\n");
+}
+
 // src/plugins/builtin/tools/reports.ts
 function createReportTools(store) {
   return [
@@ -14786,6 +15165,25 @@ function createReportTools(store) {
       },
       { annotations: { readOnlyHint: true } }
     ),
+    tool2(
+      "generate_sprint_summary",
+      "Generate an AI-powered narrative summary of a sprint's progress, health, achievements, risks, and projected outcome",
+      {
+        sprint: external_exports.string().optional().describe("Sprint ID (e.g. 'SP-001'). Omit for the active sprint.")
+      },
+      async (args) => {
+        const data = collectSprintSummaryData(store, args.sprint);
+        if (!data) {
+          const msg = args.sprint ? `Sprint ${args.sprint} not found.` : "No active sprint found.";
+          return { content: [{ type: "text", text: msg }], isError: true };
+        }
+        const summary = await generateSprintSummary(data);
+        return {
+          content: [{ type: "text", text: summary }]
+        };
+      },
+      { annotations: { readOnlyHint: true } }
+    ),
     tool2(
       "save_report",
       "Save a generated report as a persistent document",
@@ -15218,18 +15616,18 @@ function createContributionTools(store) {
         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')"),
+        aboutArtifact: external_exports.string().describe("Artifact ID this contribution relates to (e.g. 'A-001', 'T-003')"),
+        status: external_exports.string().optional().describe("Status (default: 'done')"),
         tags: external_exports.array(external_exports.string()).optional().describe("Tags for categorization")
       },
       async (args) => {
         const frontmatter = {
           title: args.title,
-          status: args.status ?? "open",
+          status: args.status ?? "done",
           persona: args.persona,
           contributionType: args.contributionType
         };
-        if (args.aboutArtifact) frontmatter.aboutArtifact = args.aboutArtifact;
+        frontmatter.aboutArtifact = args.aboutArtifact;
         if (args.tags) frontmatter.tags = args.tags;
         const doc = store.create("contribution", frontmatter, args.content);
         return {
@@ -15629,26 +16027,6 @@ function createSprintPlanningTools(store) {
 
 // src/plugins/builtin/tools/tasks.ts
 import { tool as tool8 } from "@anthropic-ai/claude-agent-sdk";
-
-// src/plugins/builtin/tools/task-utils.ts
-function normalizeLinkedEpics(value) {
-  if (value === void 0 || value === null) return [];
-  if (typeof value === "string") {
-    try {
-      const parsed = JSON.parse(value);
-      if (Array.isArray(parsed)) return parsed.filter((v) => typeof v === "string");
-    } catch {
-    }
-    return [value];
-  }
-  if (Array.isArray(value)) return value.filter((v) => typeof v === "string");
-  return [];
-}
-function generateEpicTags(epics) {
-  return epics.map((id) => `epic:${id}`);
-}
-
-// src/plugins/builtin/tools/tasks.ts
 var linkedEpicArray = external_exports.preprocess(
   (val) => {
     if (typeof val === "string") {
@@ -15733,6 +16111,7 @@ function createTaskTools(store) {
         title: external_exports.string().describe("Task title"),
         content: external_exports.string().describe("Task description and implementation details"),
         linkedEpic: linkedEpicArray.describe("Epic ID(s) to link this task to (e.g. ['E-001'] or ['E-001', 'E-002'])"),
+        aboutArtifact: external_exports.string().optional().describe("Parent artifact this task derives from (e.g. 'A-001')"),
         status: external_exports.enum(["backlog", "ready", "in-progress", "review", "done"]).optional().describe("Task status (default: 'backlog')"),
         acceptanceCriteria: external_exports.string().optional().describe("Acceptance criteria for the task"),
         technicalNotes: external_exports.string().optional().describe("Technical implementation notes"),
@@ -15758,6 +16137,7 @@ function createTaskTools(store) {
           linkedEpic: linkedEpics,
           tags: [...generateEpicTags(linkedEpics), ...args.tags ?? []]
         };
+        if (args.aboutArtifact) frontmatter.aboutArtifact = args.aboutArtifact;
         if (args.acceptanceCriteria) frontmatter.acceptanceCriteria = args.acceptanceCriteria;
         if (args.technicalNotes) frontmatter.technicalNotes = args.technicalNotes;
         if (args.estimatedPoints !== void 0) frontmatter.estimatedPoints = args.estimatedPoints;
@@ -15781,6 +16161,7 @@ function createTaskTools(store) {
       {
         id: external_exports.string().describe("Task ID to update"),
         title: external_exports.string().optional().describe("New title"),
+        aboutArtifact: external_exports.string().optional().describe("Parent artifact this task derives from (e.g. 'A-001')"),
         status: external_exports.enum(["backlog", "ready", "in-progress", "review", "done"]).optional().describe("New status"),
         content: external_exports.string().optional().describe("New content"),
         linkedEpic: linkedEpicArray.optional().describe("New linked epic ID(s)"),
@@ -17243,7 +17624,7 @@ import * as readline from "readline";
 import chalk2 from "chalk";
 import ora from "ora";
 import {
-  query as query2
+  query as query3
 } from "@anthropic-ai/claude-agent-sdk";
 
 // src/personas/prompt-builder.ts
@@ -17383,9 +17764,9 @@ var DocumentStore = class {
       }
     }
   }
-  list(query7) {
+  list(query8) {
     const results = [];
-    const types = query7?.type ? [query7.type] : Object.keys(this.typeDirs);
+    const types = query8?.type ? [query8.type] : Object.keys(this.typeDirs);
     for (const type of types) {
       const dirName = this.typeDirs[type];
       if (!dirName) continue;
@@ -17396,9 +17777,9 @@ var DocumentStore = class {
         const filePath = path6.join(dir, file2);
         const raw = fs6.readFileSync(filePath, "utf-8");
         const doc = parseDocument(raw, filePath);
-        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)))
+        if (query8?.status && doc.frontmatter.status !== query8.status) continue;
+        if (query8?.owner && doc.frontmatter.owner !== query8.owner) continue;
+        if (query8?.tag && (!doc.frontmatter.tags || !doc.frontmatter.tags.includes(query8.tag)))
           continue;
         results.push(doc);
       }
@@ -18364,7 +18745,7 @@ function computeUrgency(dueDateStr, todayStr) {
   if (diffDays <= 14) return "upcoming";
   return "later";
 }
-var DONE_STATUSES = /* @__PURE__ */ new Set(["done", "closed", "resolved", "cancelled"]);
+var DONE_STATUSES2 = /* @__PURE__ */ new Set(["done", "closed", "resolved", "cancelled"]);
 function getUpcomingData(store) {
   const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
   const allDocs = store.list();
@@ -18373,7 +18754,7 @@ function getUpcomingData(store) {
     docById.set(doc.frontmatter.id, doc);
   }
   const actions = allDocs.filter(
-    (d) => d.frontmatter.type === "action" && !DONE_STATUSES.has(d.frontmatter.status)
+    (d) => d.frontmatter.type === "action" && !DONE_STATUSES2.has(d.frontmatter.status)
   );
   const actionsWithDue = actions.filter((d) => d.frontmatter.dueDate);
   const sprints = allDocs.filter((d) => d.frontmatter.type === "sprint");
@@ -18437,7 +18818,7 @@ function getUpcomingData(store) {
     const sprintEnd = sprint.frontmatter.endDate;
     const sprintTaskDocs = getSprintTasks(sprint);
     for (const task of sprintTaskDocs) {
-      if (DONE_STATUSES.has(task.frontmatter.status)) continue;
+      if (DONE_STATUSES2.has(task.frontmatter.status)) continue;
       const existing = taskSprintMap.get(task.frontmatter.id);
       if (!existing || sprintEnd < existing.sprintEnd) {
         taskSprintMap.set(task.frontmatter.id, { task, sprint, sprintEnd });
@@ -18454,7 +18835,7 @@ function getUpcomingData(store) {
     urgency: computeUrgency(sprintEnd, today)
   })).sort((a, b) => a.sprintEndDate.localeCompare(b.sprintEndDate));
   const openItems = allDocs.filter(
-    (d) => ["action", "question", "task"].includes(d.frontmatter.type) && !DONE_STATUSES.has(d.frontmatter.status)
+    (d) => ["action", "question", "task"].includes(d.frontmatter.type) && !DONE_STATUSES2.has(d.frontmatter.status)
   );
   const fourteenDaysAgo = new Date(todayMs - fourteenDaysMs).toISOString().slice(0, 10);
   const recentMeetings = allDocs.filter(
@@ -18552,6 +18933,9 @@ function getUpcomingData(store) {
   }).filter((item) => item.score > 0).sort((a, b) => b.score - a.score).slice(0, 15);
   return { dueSoonActions, dueSoonSprintTasks, trending };
 }
+function getSprintSummaryData(store, sprintId) {
+  return collectSprintSummaryData(store, sprintId);
+}
 
 // src/web/templates/layout.ts
 function collapsibleSection(sectionId, title, content, opts) {
@@ -18693,6 +19077,7 @@ function layout(opts, body) {
   const topItems = [
     { href: "/", label: "Overview" },
     { href: "/upcoming", label: "Upcoming" },
+    { href: "/sprint-summary", label: "Sprint Summary" },
     { href: "/timeline", label: "Timeline" },
     { href: "/board", label: "Board" },
     { href: "/gar", label: "GAR Report" },
@@ -19076,6 +19461,17 @@ tr:hover td {
   background: var(--bg-hover);
 }
 
+/* Hierarchical work-item sub-rows */
+.child-row td {
+  font-size: 0.8125rem;
+  border-bottom-style: dashed;
+}
+.contribution-row td {
+  font-size: 0.8125rem;
+  color: var(--text-dim);
+  border-bottom-style: dashed;
+}
+
 /* GAR */
 .gar-overall {
   text-align: center;
@@ -19703,6 +20099,112 @@ tr:hover td {
 
 .text-dim { color: var(--text-dim); }
 
+/* Sprint Summary */
+.sprint-goal {
+  background: var(--bg-card);
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  padding: 0.75rem 1rem;
+  margin-bottom: 1rem;
+  font-size: 0.9rem;
+  color: var(--text);
+}
+
+.sprint-progress-bar {
+  position: relative;
+  height: 24px;
+  background: var(--bg-card);
+  border: 1px solid var(--border);
+  border-radius: 12px;
+  margin-bottom: 1.25rem;
+  overflow: hidden;
+}
+
+.sprint-progress-fill {
+  height: 100%;
+  background: linear-gradient(90deg, var(--accent-dim), var(--accent));
+  border-radius: 12px;
+  transition: width 0.3s ease;
+}
+
+.sprint-progress-label {
+  position: absolute;
+  top: 50%;
+  left: 50%;
+  transform: translate(-50%, -50%);
+  font-size: 0.7rem;
+  font-weight: 700;
+  color: var(--text);
+}
+
+.sprint-ai-section {
+  margin-top: 2rem;
+  background: var(--bg-card);
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  padding: 1.5rem;
+}
+
+.sprint-ai-section h3 {
+  font-size: 1rem;
+  font-weight: 600;
+  margin-bottom: 0.5rem;
+}
+
+.sprint-generate-btn {
+  background: var(--accent);
+  color: #fff;
+  border: none;
+  border-radius: var(--radius);
+  padding: 0.5rem 1.25rem;
+  font-size: 0.85rem;
+  font-weight: 600;
+  cursor: pointer;
+  margin-top: 0.75rem;
+  transition: background 0.15s;
+}
+
+.sprint-generate-btn:hover:not(:disabled) {
+  background: var(--accent-dim);
+}
+
+.sprint-generate-btn:disabled {
+  opacity: 0.5;
+  cursor: not-allowed;
+}
+
+.sprint-loading {
+  display: flex;
+  align-items: center;
+  gap: 0.75rem;
+  padding: 1rem 0;
+  color: var(--text-dim);
+  font-size: 0.85rem;
+}
+
+.sprint-spinner {
+  width: 20px;
+  height: 20px;
+  border: 2px solid var(--border);
+  border-top-color: var(--accent);
+  border-radius: 50%;
+  animation: sprint-spin 0.8s linear infinite;
+}
+
+@keyframes sprint-spin {
+  to { transform: rotate(360deg); }
+}
+
+.sprint-error {
+  color: var(--red);
+  font-size: 0.85rem;
+  padding: 0.5rem 0;
+}
+
+.sprint-ai-section .detail-content {
+  margin-top: 1rem;
+}
+
 /* Collapsible sections */
 .collapsible-header {
   cursor: pointer;
@@ -20594,7 +21096,211 @@ function upcomingPage(data) {
   `;
 }
 
+// src/web/templates/pages/sprint-summary.ts
+function progressBar(pct) {
+  return `<div class="sprint-progress-bar">
+    <div class="sprint-progress-fill" style="width: ${pct}%"></div>
+    <span class="sprint-progress-label">${pct}%</span>
+  </div>`;
+}
+function sprintSummaryPage(data, cached2) {
+  if (!data) {
+    return `
+      <div class="page-header">
+        <h2>Sprint Summary</h2>
+        <div class="subtitle">AI-powered sprint narrative</div>
+      </div>
+      <div class="empty">
+        <h3>No Active Sprint</h3>
+        <p>No active sprint found. Create a sprint and set its status to "active" to see the summary.</p>
+      </div>`;
+  }
+  const statsCards = `
+    <div class="cards">
+      <div class="card">
+        <div class="card-label">Completion</div>
+        <div class="card-value">${data.workItems.completionPct}%</div>
+        <div class="card-sub">${data.workItems.done} / ${data.workItems.total} items done</div>
+      </div>
+      <div class="card">
+        <div class="card-label">Days Remaining</div>
+        <div class="card-value">${data.timeline.daysRemaining}</div>
+        <div class="card-sub">${data.timeline.daysElapsed} of ${data.timeline.totalDays} elapsed</div>
+      </div>
+      <div class="card">
+        <div class="card-label">Epics</div>
+        <div class="card-value">${data.linkedEpics.length}</div>
+        <div class="card-sub">linked to sprint</div>
+      </div>
+      <div class="card">
+        <div class="card-label">Blockers</div>
+        <div class="card-value${data.blockers.length > 0 ? " priority-high" : ""}">${data.blockers.length}</div>
+        <div class="card-sub">${data.openActions.length} open actions</div>
+      </div>
+    </div>`;
+  const epicsTable = data.linkedEpics.length > 0 ? collapsibleSection(
+    "ss-epics",
+    "Linked Epics",
+    `<div class="table-wrap">
+          <table>
+            <thead>
+              <tr><th>ID</th><th>Title</th><th>Status</th><th>Tasks</th></tr>
+            </thead>
+            <tbody>
+              ${data.linkedEpics.map((e) => `
+              <tr>
+                <td><a href="/docs/epic/${escapeHtml(e.id)}">${escapeHtml(e.id)}</a></td>
+                <td>${escapeHtml(e.title)}</td>
+                <td>${statusBadge(e.status)}</td>
+                <td>${e.tasksDone} / ${e.tasksTotal}</td>
+              </tr>`).join("")}
+            </tbody>
+          </table>
+        </div>`,
+    { titleTag: "h3" }
+  ) : "";
+  function renderItemRows(items, depth = 0) {
+    return items.flatMap((w) => {
+      const isChild = depth > 0;
+      const isContribution = w.type === "contribution";
+      const rowClass = isContribution ? ' class="contribution-row"' : isChild ? ' class="child-row"' : "";
+      const indent = depth > 0 ? ` style="padding-left: ${0.75 + depth * 1}rem"` : "";
+      const row = `
+              <tr${rowClass}>
+                <td${indent}><a href="/docs/${escapeHtml(w.type)}/${escapeHtml(w.id)}">${escapeHtml(w.id)}</a></td>
+                <td>${escapeHtml(w.title)}</td>
+                <td>${escapeHtml(typeLabel(w.type))}</td>
+                <td>${statusBadge(w.status)}</td>
+              </tr>`;
+      const childRows = w.children ? renderItemRows(w.children, depth + 1) : [];
+      return [row, ...childRows];
+    });
+  }
+  const workItemRows = renderItemRows(data.workItems.items);
+  const workItemsSection = workItemRows.length > 0 ? collapsibleSection(
+    "ss-work-items",
+    "Work Items",
+    `<div class="table-wrap">
+          <table>
+            <thead>
+              <tr><th>ID</th><th>Title</th><th>Type</th><th>Status</th></tr>
+            </thead>
+            <tbody>
+              ${workItemRows.join("")}
+            </tbody>
+          </table>
+        </div>`,
+    { titleTag: "h3", defaultCollapsed: true }
+  ) : "";
+  const activitySection = data.artifacts.length > 0 ? collapsibleSection(
+    "ss-activity",
+    "Recent Activity",
+    `<div class="table-wrap">
+          <table>
+            <thead>
+              <tr><th>Date</th><th>ID</th><th>Title</th><th>Type</th><th>Action</th></tr>
+            </thead>
+            <tbody>
+              ${data.artifacts.slice(0, 15).map((a) => `
+              <tr>
+                <td>${formatDate(a.date)}</td>
+                <td><a href="/docs/${escapeHtml(a.type)}/${escapeHtml(a.id)}">${escapeHtml(a.id)}</a></td>
+                <td>${escapeHtml(a.title)}</td>
+                <td>${escapeHtml(typeLabel(a.type))}</td>
+                <td>${escapeHtml(a.action)}</td>
+              </tr>`).join("")}
+            </tbody>
+          </table>
+        </div>`,
+    { titleTag: "h3", defaultCollapsed: true }
+  ) : "";
+  const meetingsSection = data.meetings.length > 0 ? collapsibleSection(
+    "ss-meetings",
+    `Meetings (${data.meetings.length})`,
+    `<div class="table-wrap">
+          <table>
+            <thead>
+              <tr><th>Date</th><th>ID</th><th>Title</th></tr>
+            </thead>
+            <tbody>
+              ${data.meetings.map((m) => `
+              <tr>
+                <td>${formatDate(m.date)}</td>
+                <td><a href="/docs/meeting/${escapeHtml(m.id)}">${escapeHtml(m.id)}</a></td>
+                <td>${escapeHtml(m.title)}</td>
+              </tr>`).join("")}
+            </tbody>
+          </table>
+        </div>`,
+    { titleTag: "h3", defaultCollapsed: true }
+  ) : "";
+  const goalHtml = data.sprint.goal ? `<div class="sprint-goal"><strong>Goal:</strong> ${escapeHtml(data.sprint.goal)}</div>` : "";
+  const dateRange = data.sprint.startDate && data.sprint.endDate ? `<span class="text-dim">${formatDate(data.sprint.startDate)} \u2014 ${formatDate(data.sprint.endDate)}</span>` : "";
+  return `
+    <div class="page-header">
+      <h2>${escapeHtml(data.sprint.id)} \u2014 ${escapeHtml(data.sprint.title)} ${statusBadge(data.sprint.status)}</h2>
+      <div class="subtitle">Sprint Summary ${dateRange}</div>
+    </div>
+    ${goalHtml}
+    ${progressBar(data.timeline.percentComplete)}
+    ${statsCards}
+    ${epicsTable}
+    ${workItemsSection}
+    ${activitySection}
+    ${meetingsSection}
+
+    <div class="sprint-ai-section">
+      <h3>AI Summary</h3>
+      ${cached2 ? `<p class="text-dim">Generated ${formatDate(cached2.generatedAt)} at ${cached2.generatedAt.slice(11, 16)} UTC</p>` : `<p class="text-dim">Generate a narrative summary of this sprint's progress, risks, and projections.</p>`}
+      <button class="sprint-generate-btn" onclick="generateSummary()" id="generate-btn">${cached2 ? "Regenerate" : "Generate AI Summary"}</button>
+      <div id="summary-loading" class="sprint-loading" style="display:none">
+        <div class="sprint-spinner"></div>
+        <span>Generating summary...</span>
+      </div>
+      <div id="summary-error" class="sprint-error" style="display:none"></div>
+      <div id="summary-content" class="detail-content"${cached2 ? "" : ' style="display:none"'}>${cached2 ? cached2.html : ""}</div>
+    </div>
+
+    <script>
+      async function generateSummary() {
+        var btn = document.getElementById('generate-btn');
+        var loading = document.getElementById('summary-loading');
+        var errorEl = document.getElementById('summary-error');
+        var content = document.getElementById('summary-content');
+
+        btn.disabled = true;
+        btn.style.display = 'none';
+        loading.style.display = 'flex';
+        errorEl.style.display = 'none';
+        content.style.display = 'none';
+
+        try {
+          var res = await fetch('/api/sprint-summary', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ sprintId: '${escapeHtml(data.sprint.id)}' })
+          });
+          var json = await res.json();
+          if (!res.ok) throw new Error(json.error || 'Failed to generate summary');
+          loading.style.display = 'none';
+          content.innerHTML = json.html;
+          content.style.display = 'block';
+          btn.textContent = 'Regenerate';
+          btn.style.display = '';
+          btn.disabled = false;
+        } catch (e) {
+          loading.style.display = 'none';
+          errorEl.textContent = e.message;
+          errorEl.style.display = 'block';
+          btn.style.display = '';
+          btn.disabled = false;
+        }
+      }
+    </script>`;
+}
+
 // src/web/router.ts
+var sprintSummaryCache = /* @__PURE__ */ new Map();
 function handleRequest(req, res, store, projectName, navGroups) {
   const parsed = new URL(req.url ?? "/", `http://${req.headers.host ?? "localhost"}`);
   const pathname = parsed.pathname;
@@ -20640,6 +21346,42 @@ function handleRequest(req, res, store, projectName, navGroups) {
       respond(res, layout({ title: "Upcoming", activePath: "/upcoming", projectName, navGroups }, body));
       return;
     }
+    if (pathname === "/sprint-summary" && req.method === "GET") {
+      const sprintId = parsed.searchParams.get("sprint") ?? void 0;
+      const data = getSprintSummaryData(store, sprintId);
+      const cached2 = data ? sprintSummaryCache.get(data.sprint.id) : void 0;
+      const body = sprintSummaryPage(data, cached2 ? { html: cached2.html, generatedAt: cached2.generatedAt } : void 0);
+      respond(res, layout({ title: "Sprint Summary", activePath: "/sprint-summary", projectName, navGroups }, body));
+      return;
+    }
+    if (pathname === "/api/sprint-summary" && req.method === "POST") {
+      let bodyStr = "";
+      req.on("data", (chunk) => {
+        bodyStr += chunk;
+      });
+      req.on("end", async () => {
+        try {
+          const { sprintId } = JSON.parse(bodyStr || "{}");
+          const data = getSprintSummaryData(store, sprintId);
+          if (!data) {
+            res.writeHead(404, { "Content-Type": "application/json" });
+            res.end(JSON.stringify({ error: "Sprint not found" }));
+            return;
+          }
+          const summary = await generateSprintSummary(data);
+          const html = renderMarkdown(summary);
+          const generatedAt = (/* @__PURE__ */ new Date()).toISOString();
+          sprintSummaryCache.set(data.sprint.id, { html, generatedAt });
+          res.writeHead(200, { "Content-Type": "application/json" });
+          res.end(JSON.stringify({ summary, html, generatedAt }));
+        } catch (err) {
+          console.error("[marvin web] Sprint summary generation error:", err);
+          res.writeHead(500, { "Content-Type": "application/json" });
+          res.end(JSON.stringify({ error: "Failed to generate summary" }));
+        }
+      });
+      return;
+    }
     const boardMatch = pathname.match(/^\/board(?:\/([^/]+))?$/);
     if (boardMatch) {
       const type = boardMatch[1];
@@ -22135,6 +22877,24 @@ function createWebTools(store, projectName, navGroups) {
         };
       },
       { annotations: { readOnlyHint: true } }
+    ),
+    tool22(
+      "get_dashboard_sprint_summary",
+      "Get sprint summary data for the active sprint or a specific sprint. Returns structured data about progress, epics, work items, meetings, and blockers. Works without the web server running.",
+      {
+        sprint: external_exports.string().optional().describe("Sprint ID (e.g. 'SP-001'). Omit for the active sprint.")
+      },
+      async (args) => {
+        const data = getSprintSummaryData(store, args.sprint);
+        if (!data) {
+          const msg = args.sprint ? `Sprint ${args.sprint} not found.` : "No active sprint found.";
+          return { content: [{ type: "text", text: msg }], isError: true };
+        }
+        return {
+          content: [{ type: "text", text: JSON.stringify(data, null, 2) }]
+        };
+      },
+      { annotations: { readOnlyHint: true } }
     )
   ];
 }
@@ -22160,11 +22920,11 @@ function createMarvinMcpServer(store, options) {
 }
 
 // src/agent/session-namer.ts
-import { query } from "@anthropic-ai/claude-agent-sdk";
+import { query as query2 } from "@anthropic-ai/claude-agent-sdk";
 async function generateSessionName(turns) {
   try {
     const transcript = turns.slice(-20).map((t) => `${t.role}: ${t.content.slice(0, 200)}`).join("\n");
-    const result = query({
+    const result = query2({
       prompt: `Summarize this conversation in 3-5 words as a kebab-case name suitable for a filename. Output ONLY the name, nothing else.
 
 ${transcript}`,
@@ -22431,6 +23191,7 @@ Marvin \u2014 ${persona.name}
       "mcp__marvin-governance__get_dashboard_gar",
       "mcp__marvin-governance__get_dashboard_board",
       "mcp__marvin-governance__get_dashboard_upcoming",
+      "mcp__marvin-governance__get_dashboard_sprint_summary",
       ...pluginTools.map((t) => `mcp__marvin-governance__${t.name}`),
       ...codeSkillTools.map((t) => `mcp__marvin-governance__${t.name}`)
     ]
@@ -22441,7 +23202,7 @@ Marvin \u2014 ${persona.name}
   if (existingSession) {
     queryOptions.resume = existingSession.id;
   }
-  const conversation = query2({
+  const conversation = query3({
     prompt,
     options: queryOptions
   });
@@ -22800,7 +23561,7 @@ import * as fs12 from "fs";
 import * as path12 from "path";
 import chalk7 from "chalk";
 import ora2 from "ora";
-import { query as query3 } from "@anthropic-ai/claude-agent-sdk";
+import { query as query4 } from "@anthropic-ai/claude-agent-sdk";
 
 // src/sources/prompts.ts
 function buildIngestSystemPrompt(persona, projectConfig, isDraft) {
@@ -22933,7 +23694,7 @@ async function ingestFile(options) {
   const spinner = ora2({ text: `Analyzing ${fileName}...`, color: "cyan" });
   spinner.start();
   try {
-    const conversation = query3({
+    const conversation = query4({
       prompt: userPrompt,
       options: {
         systemPrompt,
@@ -23463,7 +24224,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { tool as tool23 } from "@anthropic-ai/claude-agent-sdk";
 
 // src/skills/action-runner.ts
-import { query as query4 } from "@anthropic-ai/claude-agent-sdk";
+import { query as query5 } from "@anthropic-ai/claude-agent-sdk";
 var GOVERNANCE_TOOL_NAMES2 = [
   "mcp__marvin-governance__list_decisions",
   "mcp__marvin-governance__get_decision",
@@ -23485,7 +24246,7 @@ async function runSkillAction(action, userPrompt, context) {
   try {
     const mcpServer = createMarvinMcpServer(context.store);
     const allowedTools = action.allowGovernanceTools !== false ? GOVERNANCE_TOOL_NAMES2 : [];
-    const conversation = query4({
+    const conversation = query5({
       prompt: userPrompt,
       options: {
         systemPrompt: action.systemPrompt,
@@ -24526,7 +25287,7 @@ import chalk13 from "chalk";
 // src/analysis/analyze.ts
 import chalk12 from "chalk";
 import ora4 from "ora";
-import { query as query5 } from "@anthropic-ai/claude-agent-sdk";
+import { query as query6 } from "@anthropic-ai/claude-agent-sdk";
 
 // src/analysis/prompts.ts
 function buildAnalyzeSystemPrompt(persona, projectConfig, isDraft) {
@@ -24656,7 +25417,7 @@ async function analyzeMeeting(options) {
   const spinner = ora4({ text: `Analyzing meeting ${meetingId}...`, color: "cyan" });
   spinner.start();
   try {
-    const conversation = query5({
+    const conversation = query6({
       prompt: userPrompt,
       options: {
         systemPrompt,
@@ -24783,7 +25544,7 @@ 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";
+import { query as query7 } from "@anthropic-ai/claude-agent-sdk";
 
 // src/contributions/prompts.ts
 function buildContributeSystemPrompt(persona, contributionType, projectConfig, isDraft) {
@@ -25037,7 +25798,7 @@ async function contributeFromPersona(options) {
       "mcp__marvin-governance__get_action",
       "mcp__marvin-governance__get_question"
     ];
-    const conversation = query6({
+    const conversation = query7({
       prompt: userPrompt,
       options: {
         systemPrompt,
@@ -25183,6 +25944,9 @@ Contribution: ${options.type}`));
   });
 }
 
+// src/cli/commands/report.ts
+import ora6 from "ora";
+
 // src/reports/gar/render-ascii.ts
 import chalk16 from "chalk";
 var STATUS_DOT = {
@@ -25377,6 +26141,47 @@ async function healthReportCommand(options) {
     console.log(renderAscii2(report));
   }
 }
+async function sprintSummaryCommand(options) {
+  const project = loadProject();
+  const plugin = resolvePlugin(project.config.methodology);
+  const pluginRegistrations = plugin?.documentTypeRegistrations ?? [];
+  const allSkills = loadAllSkills(project.marvinDir);
+  const allSkillIds = [...allSkills.keys()];
+  const skillRegistrations = collectSkillRegistrations(allSkillIds, allSkills);
+  const store = new DocumentStore(project.marvinDir, [...pluginRegistrations, ...skillRegistrations]);
+  const data = collectSprintSummaryData(store, options.sprint);
+  if (!data) {
+    const msg = options.sprint ? `Sprint ${options.sprint} not found.` : "No active sprint found. Use --sprint <id> to specify one.";
+    console.error(msg);
+    process.exit(1);
+  }
+  const spinner = ora6({ text: "Generating AI sprint summary...", color: "cyan" }).start();
+  try {
+    const summary = await generateSprintSummary(data);
+    spinner.stop();
+    const header = `# Sprint Summary: ${data.sprint.id} \u2014 ${data.sprint.title}
+
+`;
+    console.log(header + summary);
+    if (options.save) {
+      const doc = store.create(
+        "report",
+        {
+          title: `Sprint Summary: ${data.sprint.title}`,
+          status: "final",
+          tags: [`report-type:sprint-summary`, `sprint:${data.sprint.id}`]
+        },
+        summary
+      );
+      console.log(`
+Saved as ${doc.frontmatter.id}`);
+    }
+  } catch (err) {
+    spinner.stop();
+    console.error("Failed to generate sprint summary:", err);
+    process.exit(1);
+  }
+}
 
 // src/cli/commands/web.ts
 async function webCommand(options) {
@@ -25419,7 +26224,7 @@ 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.4.6");
+  ).version("0.4.8");
   program2.command("init").description("Initialize a new Marvin project in the current directory").action(async () => {
     await initCommand();
   });
@@ -25502,6 +26307,9 @@ function createProgram() {
   ).action(async (options) => {
     await healthReportCommand(options);
   });
+  reportCmd.command("sprint-summary").description("Generate an AI-powered sprint summary narrative").option("--sprint <id>", "Sprint ID (defaults to active sprint)").option("--save", "Save the summary as a report document").action(async (options) => {
+    await sprintSummaryCommand(options);
+  });
   program2.command("web").description("Launch a local web dashboard for project data").option("-p, --port <port>", "Port to listen on (default: 3000)").option("--no-open", "Don't auto-open the browser").action(async (options) => {
     await webCommand(options);
   });