mrvn-cli 0.4.5 → 0.4.7

package/dist/index.js

@@ -223,9 +223,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;
@@ -236,9 +236,9 @@ var DocumentStore = class {
         const filePath = path3.join(dir, file2);
         const raw = fs3.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);
       }
@@ -15412,6 +15412,210 @@ function evaluateHealth(projectName, metrics) {
   };
 }
 
+// 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 byStatus = {};
+  const byType = {};
+  let doneCount = 0;
+  let inProgressCount = 0;
+  let openCount = 0;
+  let blockedCount = 0;
+  for (const doc of workItemDocs) {
+    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 workItems = {
+    total: workItemDocs.length,
+    done: doneCount,
+    inProgress: inProgressCount,
+    open: openCount,
+    blocked: blockedCount,
+    completionPct: workItemDocs.length > 0 ? Math.round(doneCount / workItemDocs.length * 100) : 0,
+    byStatus,
+    byType,
+    items: workItemDocs.map((d) => ({
+      id: d.frontmatter.id,
+      title: d.frontmatter.title,
+      type: d.frontmatter.type,
+      status: d.frontmatter.status
+    }))
+  };
+  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.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/web/data.ts
 function getOverviewData(store) {
   const types = [];
@@ -15533,7 +15737,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();
@@ -15542,7 +15746,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");
@@ -15606,7 +15810,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 });
@@ -15623,7 +15827,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(
@@ -15721,8 +15925,28 @@ 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) {
+  const tag = opts?.titleTag ?? "div";
+  const cls = opts?.titleClass ?? "section-title";
+  const collapsed = opts?.defaultCollapsed ? " collapsed" : "";
+  return `
+    <div class="collapsible${collapsed}" data-section-id="${escapeHtml(sectionId)}">
+      <${tag} class="${cls} collapsible-header" onclick="toggleSection(this)">
+        <svg class="collapsible-chevron" viewBox="0 0 16 16" width="14" height="14" fill="currentColor">
+          <path d="M4.94 5.72a.75.75 0 0 1 1.06-.02L8 7.56l1.97-1.84a.75.75 0 1 1 1.02 1.1l-2.5 2.34a.75.75 0 0 1-1.02 0l-2.5-2.34a.75.75 0 0 1-.03-1.06z"/>
+        </svg>
+        <span>${title}</span>
+      </${tag}>
+      <div class="collapsible-body">
+        ${content}
+      </div>
+    </div>`;
+}
 function escapeHtml(str) {
   return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
 }
@@ -15845,6 +16069,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" },
@@ -15890,6 +16115,32 @@ function layout(opts, body) {
       ${body}
     </main>
   </div>
+  <script>
+    function toggleSection(header) {
+      var section = header.closest('.collapsible');
+      if (!section) return;
+      section.classList.toggle('collapsed');
+      var id = section.getAttribute('data-section-id');
+      if (id) {
+        try {
+          var state = JSON.parse(localStorage.getItem('marvin-collapsed') || '{}');
+          state[id] = section.classList.contains('collapsed');
+          localStorage.setItem('marvin-collapsed', JSON.stringify(state));
+        } catch(e) {}
+      }
+    }
+    // Restore collapsed state on load
+    (function() {
+      try {
+        var state = JSON.parse(localStorage.getItem('marvin-collapsed') || '{}');
+        document.querySelectorAll('.collapsible[data-section-id]').forEach(function(el) {
+          var id = el.getAttribute('data-section-id');
+          if (state[id] === true) el.classList.add('collapsed');
+          else if (state[id] === false) el.classList.remove('collapsed');
+        });
+      } catch(e) {}
+    })();
+  </script>
   <script src="https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.min.js"></script>
   <script>mermaid.initialize({
     startOnLoad: true,
@@ -16713,13 +16964,60 @@ tr:hover td {
   white-space: nowrap;
 }
 
+.gantt-grid-line {
+  position: absolute;
+  top: 0;
+  bottom: 0;
+  width: 1px;
+  background: var(--border);
+  opacity: 0.35;
+}
+
+.gantt-sprint-line {
+  position: absolute;
+  top: 0;
+  bottom: 0;
+  width: 1px;
+  background: var(--text-dim);
+  opacity: 0.3;
+}
+
 .gantt-today {
   position: absolute;
   top: 0;
   bottom: 0;
-  width: 2px;
+  width: 3px;
   background: var(--red);
-  opacity: 0.7;
+  opacity: 0.8;
+  border-radius: 1px;
+}
+
+/* Sprint band in timeline */
+.gantt-sprint-band-row {
+  border-bottom: 1px solid var(--border);
+  margin-bottom: 0.25rem;
+}
+
+.gantt-sprint-band {
+  height: 32px;
+}
+
+.gantt-sprint-block {
+  position: absolute;
+  top: 2px;
+  bottom: 2px;
+  background: var(--bg-hover);
+  border: 1px solid var(--border);
+  border-radius: 4px;
+  font-size: 0.65rem;
+  color: var(--text-dim);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  overflow: hidden;
+  white-space: nowrap;
+  text-overflow: ellipsis;
+  padding: 0 0.4rem;
 }
 
 /* Pie chart color overrides */
@@ -16781,6 +17079,146 @@ 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;
+  display: flex;
+  align-items: center;
+  gap: 0.4rem;
+  user-select: none;
+}
+
+.collapsible-header:hover {
+  color: var(--accent);
+}
+
+.collapsible-chevron {
+  transition: transform 0.2s ease;
+  flex-shrink: 0;
+}
+
+.collapsible.collapsed .collapsible-chevron {
+  transform: rotate(-90deg);
+}
+
+.collapsible-body {
+  overflow: hidden;
+  max-height: 5000px;
+  transition: max-height 0.3s ease, opacity 0.2s ease;
+  opacity: 1;
+}
+
+.collapsible.collapsed .collapsible-body {
+  max-height: 0;
+  opacity: 0;
+}
 `;
 }
 
@@ -16833,35 +17271,73 @@ function buildTimelineGantt(data, maxSprints = 6) {
     );
     tick += 7 * DAY;
   }
+  const gridLines = [];
+  let gridTick = timelineStart;
+  const gridStartDay = new Date(gridTick).getDay();
+  gridTick += (8 - gridStartDay) % 7 * DAY;
+  while (gridTick <= timelineEnd) {
+    gridLines.push(`<div class="gantt-grid-line" style="left:${pct(gridTick).toFixed(2)}%"></div>`);
+    gridTick += 7 * DAY;
+  }
+  const sprintBoundaries = /* @__PURE__ */ new Set();
+  for (const sprint of visibleSprints) {
+    sprintBoundaries.add(toMs(sprint.startDate));
+    sprintBoundaries.add(toMs(sprint.endDate));
+  }
+  const sprintLines = [...sprintBoundaries].map(
+    (ms) => `<div class="gantt-sprint-line" style="left:${pct(ms).toFixed(2)}%"></div>`
+  );
   const now = Date.now();
   let todayMarker = "";
   if (now >= timelineStart && now <= timelineEnd) {
     todayMarker = `<div class="gantt-today" style="left:${pct(now).toFixed(2)}%"></div>`;
   }
-  const rows = [];
+  const sprintBlocks = visibleSprints.map((sprint) => {
+    const sStart = toMs(sprint.startDate);
+    const sEnd = toMs(sprint.endDate);
+    const left = pct(sStart).toFixed(2);
+    const width = (pct(sEnd) - pct(sStart)).toFixed(2);
+    return `<div class="gantt-sprint-block" style="left:${left}%;width:${width}%">${sanitize(sprint.id, 20)}</div>`;
+  }).join("");
+  const sprintBandRow = `<div class="gantt-row gantt-sprint-band-row">
+      <div class="gantt-label gantt-section-label">Sprints</div>
+      <div class="gantt-track gantt-sprint-band">${sprintBlocks}</div>
+    </div>`;
+  const epicSpanMap = /* @__PURE__ */ new Map();
   for (const sprint of visibleSprints) {
     const sStart = toMs(sprint.startDate);
     const sEnd = toMs(sprint.endDate);
-    rows.push(`<div class="gantt-section-row">
-      <div class="gantt-label gantt-section-label">${sanitize(sprint.id + " " + sprint.title, 50)}</div>
-      <div class="gantt-track">
-        <div class="gantt-section-bg" style="left:${pct(sStart).toFixed(2)}%;width:${(pct(sEnd) - pct(sStart)).toFixed(2)}%"></div>
-      </div>
-    </div>`);
-    const linked = sprint.linkedEpics.map((eid) => epicMap.get(eid)).filter(Boolean);
-    const items = linked.length > 0 ? linked.map((e) => ({ label: sanitize(e.id + " " + e.title), status: e.status })) : [{ label: sanitize(sprint.title), status: sprint.status }];
-    for (const item of items) {
-      const cls = item.status === "done" || item.status === "completed" ? "gantt-bar-done" : item.status === "in-progress" || item.status === "active" ? "gantt-bar-active" : item.status === "blocked" ? "gantt-bar-blocked" : "gantt-bar-default";
-      const left = pct(sStart).toFixed(2);
-      const width = (pct(sEnd) - pct(sStart)).toFixed(2);
-      rows.push(`<div class="gantt-row">
-        <div class="gantt-label">${item.label}</div>
+    for (const eid of sprint.linkedEpics) {
+      if (!epicMap.has(eid)) continue;
+      const existing = epicSpanMap.get(eid);
+      if (existing) {
+        existing.startMs = Math.min(existing.startMs, sStart);
+        existing.endMs = Math.max(existing.endMs, sEnd);
+      } else {
+        epicSpanMap.set(eid, { startMs: sStart, endMs: sEnd });
+      }
+    }
+  }
+  const sortedEpicIds = [...epicSpanMap.keys()].sort((a, b) => {
+    const aSpan = epicSpanMap.get(a);
+    const bSpan = epicSpanMap.get(b);
+    if (aSpan.startMs !== bSpan.startMs) return aSpan.startMs - bSpan.startMs;
+    return a.localeCompare(b);
+  });
+  const epicRows = sortedEpicIds.map((eid) => {
+    const epic = epicMap.get(eid);
+    const { startMs, endMs } = epicSpanMap.get(eid);
+    const cls = epic.status === "done" || epic.status === "completed" ? "gantt-bar-done" : epic.status === "in-progress" || epic.status === "active" ? "gantt-bar-active" : epic.status === "blocked" ? "gantt-bar-blocked" : "gantt-bar-default";
+    const left = pct(startMs).toFixed(2);
+    const width = (pct(endMs) - pct(startMs)).toFixed(2);
+    const label = sanitize(epic.id + " " + epic.title);
+    return `<div class="gantt-row">
+        <div class="gantt-label">${label}</div>
         <div class="gantt-track">
           <div class="gantt-bar ${cls}" style="left:${left}%;width:${width}%"></div>
         </div>
-      </div>`);
-    }
-  }
+      </div>`;
+  }).join("\n");
   const note = truncated ? `<div class="mermaid-note">${hiddenCount} earlier sprint${hiddenCount > 1 ? "s" : ""} not shown</div>` : "";
   return `${note}
     <div class="gantt">
@@ -16870,11 +17346,12 @@ function buildTimelineGantt(data, maxSprints = 6) {
           <div class="gantt-label"></div>
           <div class="gantt-track gantt-dates">${markers.join("")}</div>
         </div>
-        ${rows.join("\n")}
+        ${sprintBandRow}
+        ${epicRows}
       </div>
       <div class="gantt-overlay">
         <div class="gantt-label"></div>
-        <div class="gantt-track">${todayMarker}</div>
+        <div class="gantt-track">${gridLines.join("")}${sprintLines.join("")}${todayMarker}</div>
       </div>
     </div>`;
 }
@@ -17154,11 +17631,12 @@ function overviewPage(data, diagrams, navGroups) {
 
     <div class="section-title"><a href="/timeline">Project Timeline &rarr;</a></div>
 
-    <div class="section-title">Artifact Relationships</div>
-    ${buildArtifactFlowchart(diagrams)}
+    ${collapsibleSection("overview-relationships", "Artifact Relationships", buildArtifactFlowchart(diagrams))}
 
-    <div class="section-title">Recent Activity</div>
-    ${data.recent.length > 0 ? `
+    ${collapsibleSection(
+    "overview-recent",
+    "Recent Activity",
+    data.recent.length > 0 ? `
     <div class="table-wrap">
       <table>
         <thead>
@@ -17174,7 +17652,8 @@ function overviewPage(data, diagrams, navGroups) {
           ${rows}
         </tbody>
       </table>
-    </div>` : `<div class="empty"><p>No documents yet.</p></div>`}
+    </div>` : `<div class="empty"><p>No documents yet.</p></div>`
+  )}
   `;
 }
 
@@ -17319,23 +17798,24 @@ function garPage(report) {
       <div class="label">Overall: ${escapeHtml(report.overall)}</div>
     </div>
 
-    <div class="gar-areas">
-      ${areaCards}
-    </div>
+    ${collapsibleSection("gar-areas", "Areas", `<div class="gar-areas">${areaCards}</div>`)}
 
-    <div class="section-title">Status Distribution</div>
-    ${buildStatusPie("Action Status", {
-    Open: report.metrics.scope.open,
-    Done: report.metrics.scope.done,
-    "In Progress": Math.max(0, report.metrics.scope.total - report.metrics.scope.open - report.metrics.scope.done)
-  })}
+    ${collapsibleSection(
+    "gar-status-dist",
+    "Status Distribution",
+    buildStatusPie("Action Status", {
+      Open: report.metrics.scope.open,
+      Done: report.metrics.scope.done,
+      "In Progress": Math.max(0, report.metrics.scope.total - report.metrics.scope.open - report.metrics.scope.done)
+    })
+  )}
   `;
 }
 
 // src/web/templates/pages/health.ts
 function healthPage(report, metrics) {
   const dotClass = `dot-${report.overall}`;
-  function renderSection(title, categories) {
+  function renderSection(sectionId, title, categories) {
     const cards = categories.map(
       (cat) => `
         <div class="gar-area">
@@ -17347,10 +17827,9 @@ function healthPage(report, metrics) {
           ${cat.items.length > 0 ? `<ul>${cat.items.map((item) => `<li><span class="ref-id">${escapeHtml(item.id)}</span>${escapeHtml(item.detail)}</li>`).join("")}</ul>` : ""}
         </div>`
     ).join("\n");
-    return `
-      <div class="health-section-title">${escapeHtml(title)}</div>
-      <div class="gar-areas">${cards}</div>
-    `;
+    return collapsibleSection(sectionId, title, `<div class="gar-areas">${cards}</div>`, {
+      titleClass: "health-section-title"
+    });
   }
   return `
     <div class="page-header">
@@ -17363,35 +17842,43 @@ function healthPage(report, metrics) {
       <div class="label">Overall: ${escapeHtml(report.overall)}</div>
     </div>
 
-    ${renderSection("Completeness", report.completeness)}
-
-    <div class="health-section-title">Completeness Overview</div>
-    ${buildHealthGauge(
-    metrics ? Object.entries(metrics.completeness).map(([name, cat]) => ({
-      name: name.replace(/\b\w/g, (c) => c.toUpperCase()),
-      complete: cat.complete,
-      total: cat.total
-    })) : report.completeness.map((c) => {
-      const match = c.summary.match(/(\d+)\s*\/\s*(\d+)/);
-      return {
-        name: c.name,
-        complete: match ? parseInt(match[1], 10) : 0,
-        total: match ? parseInt(match[2], 10) : 0
-      };
-    })
+    ${renderSection("health-completeness", "Completeness", report.completeness)}
+
+    ${collapsibleSection(
+    "health-completeness-overview",
+    "Completeness Overview",
+    buildHealthGauge(
+      metrics ? Object.entries(metrics.completeness).map(([name, cat]) => ({
+        name: name.replace(/\b\w/g, (c) => c.toUpperCase()),
+        complete: cat.complete,
+        total: cat.total
+      })) : report.completeness.map((c) => {
+        const match = c.summary.match(/(\d+)\s*\/\s*(\d+)/);
+        return {
+          name: c.name,
+          complete: match ? parseInt(match[1], 10) : 0,
+          total: match ? parseInt(match[2], 10) : 0
+        };
+      })
+    ),
+    { titleClass: "health-section-title" }
   )}
 
-    ${renderSection("Process", report.process)}
-
-    <div class="health-section-title">Process Summary</div>
-    ${metrics ? buildStatusPie("Process Health", {
-    Stale: metrics.process.stale.length,
-    "Aging Actions": metrics.process.agingActions.length,
-    Healthy: Math.max(
-      0,
-      (metrics.completeness ? Object.values(metrics.completeness).reduce((sum, c) => sum + c.total, 0) : 0) - metrics.process.stale.length - metrics.process.agingActions.length
-    )
-  }) : ""}
+    ${renderSection("health-process", "Process", report.process)}
+
+    ${collapsibleSection(
+    "health-process-summary",
+    "Process Summary",
+    metrics ? buildStatusPie("Process Health", {
+      Stale: metrics.process.stale.length,
+      "Aging Actions": metrics.process.agingActions.length,
+      Healthy: Math.max(
+        0,
+        (metrics.completeness ? Object.values(metrics.completeness).reduce((sum, c) => sum + c.total, 0) : 0) - metrics.process.stale.length - metrics.process.agingActions.length
+      )
+    }) : "",
+    { titleClass: "health-section-title" }
+  )}
   `;
 }
 
@@ -17449,7 +17936,7 @@ function timelinePage(diagrams) {
   return `
     <div class="page-header">
       <h2>Project Timeline</h2>
-      <div class="subtitle">Sprint schedule with linked epics</div>
+      <div class="subtitle">Epic timeline across sprints</div>
     </div>
 
     ${buildTimelineGantt(diagrams)}
@@ -17477,9 +17964,10 @@ function upcomingPage(data) {
   const hasActions = data.dueSoonActions.length > 0;
   const hasSprintTasks = data.dueSoonSprintTasks.length > 0;
   const hasTrending = data.trending.length > 0;
-  const actionsTable = hasActions ? `
-    <h3 class="section-title">Due Soon \u2014 Actions</h3>
-    <div class="table-wrap">
+  const actionsTable = hasActions ? collapsibleSection(
+    "upcoming-actions",
+    "Due Soon \u2014 Actions",
+    `<div class="table-wrap">
       <table>
         <thead>
           <tr>
@@ -17494,7 +17982,7 @@ function upcomingPage(data) {
         </thead>
         <tbody>
           ${data.dueSoonActions.map(
-    (a) => `
+      (a) => `
           <tr class="${urgencyRowClass(a.urgency)}">
             <td><a href="/docs/action/${escapeHtml(a.id)}">${escapeHtml(a.id)}</a></td>
             <td>${escapeHtml(a.title)}</td>
@@ -17504,13 +17992,16 @@ function upcomingPage(data) {
             <td>${urgencyBadge(a.urgency)}</td>
             <td>${a.relatedTaskCount > 0 ? a.relatedTaskCount : "\u2014"}</td>
           </tr>`
-  ).join("")}
+    ).join("")}
         </tbody>
       </table>
-    </div>` : "";
-  const sprintTasksTable = hasSprintTasks ? `
-    <h3 class="section-title">Due Soon \u2014 Sprint Tasks</h3>
-    <div class="table-wrap">
+    </div>`,
+    { titleTag: "h3" }
+  ) : "";
+  const sprintTasksTable = hasSprintTasks ? collapsibleSection(
+    "upcoming-sprint-tasks",
+    "Due Soon \u2014 Sprint Tasks",
+    `<div class="table-wrap">
       <table>
         <thead>
           <tr>
@@ -17524,7 +18015,7 @@ function upcomingPage(data) {
         </thead>
         <tbody>
           ${data.dueSoonSprintTasks.map(
-    (t) => `
+      (t) => `
           <tr class="${urgencyRowClass(t.urgency)}">
             <td><a href="/docs/task/${escapeHtml(t.id)}">${escapeHtml(t.id)}</a></td>
             <td>${escapeHtml(t.title)}</td>
@@ -17533,13 +18024,16 @@ function upcomingPage(data) {
             <td>${formatDate(t.sprintEndDate)}</td>
             <td>${urgencyBadge(t.urgency)}</td>
           </tr>`
-  ).join("")}
+    ).join("")}
         </tbody>
       </table>
-    </div>` : "";
-  const trendingTable = hasTrending ? `
-    <h3 class="section-title">Trending</h3>
-    <div class="table-wrap">
+    </div>`,
+    { titleTag: "h3" }
+  ) : "";
+  const trendingTable = hasTrending ? collapsibleSection(
+    "upcoming-trending",
+    "Trending",
+    `<div class="table-wrap">
       <table>
         <thead>
           <tr>
@@ -17554,7 +18048,7 @@ function upcomingPage(data) {
         </thead>
         <tbody>
           ${data.trending.map(
-    (t, i) => `
+      (t, i) => `
           <tr>
             <td><span class="trending-rank">${i + 1}</span></td>
             <td><a href="/docs/${escapeHtml(t.type)}/${escapeHtml(t.id)}">${escapeHtml(t.id)}</a></td>
@@ -17564,10 +18058,12 @@ function upcomingPage(data) {
             <td><span class="trending-score">${t.score}</span></td>
             <td>${t.signals.map((s) => `<span class="signal-tag">${escapeHtml(s.factor)} +${s.points}</span>`).join(" ")}</td>
           </tr>`
-  ).join("")}
+    ).join("")}
         </tbody>
       </table>
-    </div>` : "";
+    </div>`,
+    { titleTag: "h3" }
+  ) : "";
   const emptyState = !hasActions && !hasSprintTasks && !hasTrending ? '<div class="empty"><p>No upcoming items or trending activity found.</p></div>' : "";
   return `
     <div class="page-header">
@@ -17581,7 +18077,317 @@ 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" }
+  ) : "";
+  const workItemsSection = data.workItems.total > 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>
+              ${data.workItems.items.map((w) => `
+              <tr>
+                <td><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>`).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/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/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;
@@ -17627,6 +18433,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];
@@ -18156,6 +18998,25 @@ function createReportTools(store) {
       },
       { annotations: { readOnlyHint: true } }
     ),
+    tool8(
+      "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 } }
+    ),
     tool8(
       "save_report",
       "Save a generated report as a persistent document",
@@ -20865,8 +21726,8 @@ function gatherContext(store, focusFeature, includeDecisions = true, includeQues
       title: e.frontmatter.title,
       status: e.frontmatter.status,
       linkedFeature: normalizeLinkedFeatures(e.frontmatter.linkedFeature),
-      targetDate: e.frontmatter.targetDate ?? null,
-      estimatedEffort: e.frontmatter.estimatedEffort ?? null,
+      targetDate: typeof e.frontmatter.targetDate === "string" ? e.frontmatter.targetDate : null,
+      estimatedEffort: typeof e.frontmatter.estimatedEffort === "string" ? e.frontmatter.estimatedEffort : null,
       content: e.content,
       linkedTaskCount: tasks.filter(
         (t) => normalizeLinkedEpics(t.frontmatter.linkedEpic).includes(e.frontmatter.id)
@@ -20877,10 +21738,10 @@ function gatherContext(store, focusFeature, includeDecisions = true, includeQues
       title: t.frontmatter.title,
       status: t.frontmatter.status,
       linkedEpic: normalizeLinkedEpics(t.frontmatter.linkedEpic),
-      acceptanceCriteria: t.frontmatter.acceptanceCriteria ?? null,
-      technicalNotes: t.frontmatter.technicalNotes ?? null,
-      complexity: t.frontmatter.complexity ?? null,
-      estimatedPoints: t.frontmatter.estimatedPoints ?? null,
+      acceptanceCriteria: typeof t.frontmatter.acceptanceCriteria === "string" ? t.frontmatter.acceptanceCriteria : null,
+      technicalNotes: typeof t.frontmatter.technicalNotes === "string" ? t.frontmatter.technicalNotes : null,
+      complexity: typeof t.frontmatter.complexity === "string" ? t.frontmatter.complexity : null,
+      estimatedPoints: typeof t.frontmatter.estimatedPoints === "number" ? t.frontmatter.estimatedPoints : null,
       priority: t.frontmatter.priority ?? null
     })),
     decisions: allDecisions.map((d) => ({
@@ -21703,6 +22564,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 } }
     )
   ];
 }
@@ -21734,7 +22613,7 @@ import * as readline from "readline";
 import chalk from "chalk";
 import ora from "ora";
 import {
-  query as query2
+  query as query3
 } from "@anthropic-ai/claude-agent-sdk";
 
 // src/storage/session-store.ts
@@ -21805,11 +22684,11 @@ var SessionStore = class {
 };
 
 // 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}`,
@@ -22076,6 +22955,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}`)
     ]
@@ -22086,7 +22966,7 @@ Marvin \u2014 ${persona.name}
   if (existingSession) {
     queryOptions.resume = existingSession.id;
   }
-  const conversation = query2({
+  const conversation = query3({
     prompt,
     options: queryOptions
   });
@@ -22178,7 +23058,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 query3 } from "@anthropic-ai/claude-agent-sdk";
+import { query as query4 } from "@anthropic-ai/claude-agent-sdk";
 var GOVERNANCE_TOOL_NAMES2 = [
   "mcp__marvin-governance__list_decisions",
   "mcp__marvin-governance__get_decision",
@@ -22200,7 +23080,7 @@ async function runSkillAction(action, userPrompt, context) {
   try {
     const mcpServer = createMarvinMcpServer(context.store);
     const allowedTools = action.allowGovernanceTools !== false ? GOVERNANCE_TOOL_NAMES2 : [];
-    const conversation = query3({
+    const conversation = query4({
       prompt: userPrompt,
       options: {
         systemPrompt: action.systemPrompt,
@@ -22994,7 +23874,7 @@ import * as fs13 from "fs";
 import * as path13 from "path";
 import chalk7 from "chalk";
 import ora2 from "ora";
-import { query as query4 } from "@anthropic-ai/claude-agent-sdk";
+import { query as query5 } from "@anthropic-ai/claude-agent-sdk";
 
 // src/sources/prompts.ts
 function buildIngestSystemPrompt(persona, projectConfig, isDraft) {
@@ -23127,7 +24007,7 @@ async function ingestFile(options) {
   const spinner = ora2({ text: `Analyzing ${fileName}...`, color: "cyan" });
   spinner.start();
   try {
-    const conversation = query4({
+    const conversation = query5({
       prompt: userPrompt,
       options: {
         systemPrompt,
@@ -24348,7 +25228,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) {
@@ -24478,7 +25358,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,
@@ -24605,7 +25485,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) {
@@ -24859,7 +25739,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,
@@ -25005,6 +25885,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 = {
@@ -25199,6 +26082,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) {
@@ -25241,7 +26165,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.4.5");
+  ).version("0.4.7");
   program.command("init").description("Initialize a new Marvin project in the current directory").action(async () => {
     await initCommand();
   });
@@ -25324,6 +26248,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);
+  });
   program.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);
   });