mrvn-cli 0.3.3 → 0.3.5

package/dist/marvin.js

@@ -13942,7 +13942,7 @@ function createMeetingTools(store) {
           content: [{ type: "text", text: JSON.stringify(summary, null, 2) }]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool(
       "get_meeting",
@@ -13969,7 +13969,7 @@ function createMeetingTools(store) {
           ]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool(
       "create_meeting",
@@ -14094,7 +14094,7 @@ function createMeetingTools(store) {
           content: [{ type: "text", text: sections.join("\n") }]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     )
   ];
 }
@@ -14111,9 +14111,17 @@ function collectGarMetrics(store) {
   const blockedItems = allDocs.filter(
     (d) => d.frontmatter.tags?.includes("blocked")
   );
-  const overdueItems = allDocs.filter(
+  const tagOverdueItems = allDocs.filter(
     (d) => d.frontmatter.tags?.includes("overdue")
   );
+  const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+  const dateOverdueActions = openActions.filter((d) => {
+    const dueDate = d.frontmatter.dueDate;
+    return typeof dueDate === "string" && dueDate < today;
+  });
+  const overdueItems = [...tagOverdueItems, ...dateOverdueActions].filter(
+    (d, i, arr) => arr.findIndex((x) => x.frontmatter.id === d.frontmatter.id) === i
+  );
   const openQuestions = store.list({ type: "question", status: "open" });
   const riskItems = allDocs.filter(
     (d) => d.frontmatter.tags?.includes("risk")
@@ -14222,6 +14230,253 @@ function evaluateGar(projectName, metrics) {
   };
 }
 
+// src/reports/health/collector.ts
+var FIELD_CHECKS = [
+  {
+    type: "action",
+    openStatuses: ["open", "in-progress"],
+    requiredFields: ["owner", "priority", "dueDate", "content"]
+  },
+  {
+    type: "decision",
+    openStatuses: ["open", "proposed"],
+    requiredFields: ["owner", "content"]
+  },
+  {
+    type: "question",
+    openStatuses: ["open"],
+    requiredFields: ["owner", "content"]
+  },
+  {
+    type: "feature",
+    openStatuses: ["draft", "approved"],
+    requiredFields: ["owner", "priority", "content"]
+  },
+  {
+    type: "epic",
+    openStatuses: ["planned", "in-progress"],
+    requiredFields: ["owner", "targetDate", "estimatedEffort", "content"]
+  },
+  {
+    type: "sprint",
+    openStatuses: ["planned", "active"],
+    requiredFields: ["goal", "startDate", "endDate", "linkedEpics"]
+  }
+];
+var STALE_THRESHOLD_DAYS = 14;
+var AGING_THRESHOLD_DAYS = 30;
+function daysBetween(a, b) {
+  const msPerDay = 864e5;
+  const dateA = new Date(a);
+  const dateB = new Date(b);
+  return Math.floor(Math.abs(dateB.getTime() - dateA.getTime()) / msPerDay);
+}
+function checkMissingFields(doc, requiredFields) {
+  const missing = [];
+  for (const field of requiredFields) {
+    if (field === "content") {
+      if (!doc.content || doc.content.trim().length === 0) {
+        missing.push("content");
+      }
+    } else if (field === "linkedEpics") {
+      const val = doc.frontmatter[field];
+      if (!Array.isArray(val) || val.length === 0) {
+        missing.push(field);
+      }
+    } else {
+      const val = doc.frontmatter[field];
+      if (val === void 0 || val === null || val === "") {
+        missing.push(field);
+      }
+    }
+  }
+  return missing;
+}
+function collectCompleteness(store) {
+  const result = {};
+  for (const check2 of FIELD_CHECKS) {
+    const allOfType = store.list({ type: check2.type });
+    const openDocs = allOfType.filter(
+      (d) => check2.openStatuses.includes(d.frontmatter.status)
+    );
+    const gaps = [];
+    let complete = 0;
+    for (const doc of openDocs) {
+      const missingFields = checkMissingFields(doc, check2.requiredFields);
+      if (missingFields.length === 0) {
+        complete++;
+      } else {
+        gaps.push({
+          id: doc.frontmatter.id,
+          title: doc.frontmatter.title,
+          missingFields
+        });
+      }
+    }
+    result[check2.type] = {
+      total: openDocs.length,
+      complete,
+      gaps
+    };
+  }
+  return result;
+}
+function collectProcess(store) {
+  const today = (/* @__PURE__ */ new Date()).toISOString();
+  const allDocs = store.list();
+  const openStatuses = new Set(FIELD_CHECKS.flatMap((c) => c.openStatuses));
+  const openDocs = allDocs.filter((d) => openStatuses.has(d.frontmatter.status));
+  const stale = [];
+  for (const doc of openDocs) {
+    const updated = doc.frontmatter.updated ?? doc.frontmatter.created;
+    const days = daysBetween(updated, today);
+    if (days >= STALE_THRESHOLD_DAYS) {
+      stale.push({ id: doc.frontmatter.id, title: doc.frontmatter.title, days });
+    }
+  }
+  const openActions = store.list({ type: "action" }).filter((d) => d.frontmatter.status === "open" || d.frontmatter.status === "in-progress");
+  const agingActions = [];
+  for (const doc of openActions) {
+    const days = daysBetween(doc.frontmatter.created, today);
+    if (days >= AGING_THRESHOLD_DAYS) {
+      agingActions.push({ id: doc.frontmatter.id, title: doc.frontmatter.title, days });
+    }
+  }
+  const resolvedDecisions = store.list({ type: "decision" }).filter((d) => !["open", "proposed"].includes(d.frontmatter.status));
+  let decisionTotal = 0;
+  for (const doc of resolvedDecisions) {
+    decisionTotal += daysBetween(doc.frontmatter.created, doc.frontmatter.updated);
+  }
+  const decisionVelocity = {
+    avgDays: resolvedDecisions.length > 0 ? Math.round(decisionTotal / resolvedDecisions.length) : 0,
+    count: resolvedDecisions.length
+  };
+  const answeredQuestions = store.list({ type: "question" }).filter((d) => d.frontmatter.status !== "open");
+  let questionTotal = 0;
+  for (const doc of answeredQuestions) {
+    questionTotal += daysBetween(doc.frontmatter.created, doc.frontmatter.updated);
+  }
+  const questionResolution = {
+    avgDays: answeredQuestions.length > 0 ? Math.round(questionTotal / answeredQuestions.length) : 0,
+    count: answeredQuestions.length
+  };
+  return { stale, agingActions, decisionVelocity, questionResolution };
+}
+function collectHealthMetrics(store) {
+  return {
+    completeness: collectCompleteness(store),
+    process: collectProcess(store)
+  };
+}
+
+// src/reports/health/evaluator.ts
+function worstStatus2(statuses) {
+  if (statuses.includes("red")) return "red";
+  if (statuses.includes("amber")) return "amber";
+  return "green";
+}
+function completenessStatus(total, complete) {
+  if (total === 0) return "green";
+  const pct = Math.round(complete / total * 100);
+  if (pct >= 100) return "green";
+  if (pct >= 75) return "amber";
+  return "red";
+}
+var TYPE_LABELS = {
+  action: "Actions",
+  decision: "Decisions",
+  question: "Questions",
+  feature: "Features",
+  epic: "Epics",
+  sprint: "Sprints"
+};
+function evaluateHealth(projectName, metrics) {
+  const completeness = [];
+  for (const [type, catMetrics] of Object.entries(metrics.completeness)) {
+    const { total, complete, gaps } = catMetrics;
+    const status = completenessStatus(total, complete);
+    const pct = total > 0 ? Math.round(complete / total * 100) : 100;
+    completeness.push({
+      name: TYPE_LABELS[type] ?? type,
+      status,
+      summary: `${pct}% complete (${complete}/${total})`,
+      items: gaps.map((g) => ({
+        id: g.id,
+        detail: `missing: ${g.missingFields.join(", ")}`
+      }))
+    });
+  }
+  const process3 = [];
+  const staleCount = metrics.process.stale.length;
+  const staleStatus = staleCount === 0 ? "green" : staleCount <= 3 ? "amber" : "red";
+  process3.push({
+    name: "Stale Items",
+    status: staleStatus,
+    summary: staleCount === 0 ? "no stale items" : `${staleCount} item(s) not updated in 14+ days`,
+    items: metrics.process.stale.map((s) => ({
+      id: s.id,
+      detail: `${s.days} days since last update`
+    }))
+  });
+  const agingCount = metrics.process.agingActions.length;
+  const agingStatus = agingCount === 0 ? "green" : agingCount <= 3 ? "amber" : "red";
+  process3.push({
+    name: "Aging Actions",
+    status: agingStatus,
+    summary: agingCount === 0 ? "no aging actions" : `${agingCount} action(s) open for 30+ days`,
+    items: metrics.process.agingActions.map((a) => ({
+      id: a.id,
+      detail: `open for ${a.days} days`
+    }))
+  });
+  const dv = metrics.process.decisionVelocity;
+  let dvStatus;
+  if (dv.count === 0) {
+    dvStatus = "green";
+  } else if (dv.avgDays <= 7) {
+    dvStatus = "green";
+  } else if (dv.avgDays <= 21) {
+    dvStatus = "amber";
+  } else {
+    dvStatus = "red";
+  }
+  process3.push({
+    name: "Decision Velocity",
+    status: dvStatus,
+    summary: dv.count === 0 ? "no resolved decisions" : `avg ${dv.avgDays} days to resolve (${dv.count} decision(s))`,
+    items: []
+  });
+  const qr = metrics.process.questionResolution;
+  let qrStatus;
+  if (qr.count === 0) {
+    qrStatus = "green";
+  } else if (qr.avgDays <= 7) {
+    qrStatus = "green";
+  } else if (qr.avgDays <= 14) {
+    qrStatus = "amber";
+  } else {
+    qrStatus = "red";
+  }
+  process3.push({
+    name: "Question Resolution",
+    status: qrStatus,
+    summary: qr.count === 0 ? "no answered questions" : `avg ${qr.avgDays} days to answer (${qr.count} question(s))`,
+    items: []
+  });
+  const allStatuses = [
+    ...completeness.map((c) => c.status),
+    ...process3.map((p) => p.status)
+  ];
+  const overall = worstStatus2(allStatuses);
+  return {
+    projectName,
+    generatedAt: (/* @__PURE__ */ new Date()).toISOString().slice(0, 10),
+    overall,
+    completeness,
+    process: process3
+  };
+}
+
 // src/plugins/builtin/tools/reports.ts
 function createReportTools(store) {
   return [
@@ -14241,7 +14496,8 @@ function createReportTools(store) {
             id: d.frontmatter.id,
             title: d.frontmatter.title,
             owner: d.frontmatter.owner,
-            priority: d.frontmatter.priority
+            priority: d.frontmatter.priority,
+            dueDate: d.frontmatter.dueDate
           })),
           completedActions: completedActions.map((d) => ({
             id: d.frontmatter.id,
@@ -14260,7 +14516,7 @@ function createReportTools(store) {
           content: [{ type: "text", text: JSON.stringify(report, null, 2) }]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool2(
       "generate_risk_register",
@@ -14304,7 +14560,7 @@ function createReportTools(store) {
           content: [{ type: "text", text: JSON.stringify(register, null, 2) }]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool2(
       "generate_gar_report",
@@ -14317,7 +14573,7 @@ function createReportTools(store) {
           content: [{ type: "text", text: JSON.stringify(report, null, 2) }]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool2(
       "generate_epic_progress",
@@ -14402,7 +14658,7 @@ function createReportTools(store) {
           ]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool2(
       "generate_sprint_progress",
@@ -14447,7 +14703,8 @@ function createReportTools(store) {
                 id: d.frontmatter.id,
                 title: d.frontmatter.title,
                 type: d.frontmatter.type,
-                status: d.frontmatter.status
+                status: d.frontmatter.status,
+                dueDate: d.frontmatter.dueDate
               }))
             }
           };
@@ -14456,7 +14713,7 @@ function createReportTools(store) {
           content: [{ type: "text", text: JSON.stringify({ sprints }, null, 2) }]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool2(
       "generate_feature_progress",
@@ -14496,7 +14753,20 @@ function createReportTools(store) {
           content: [{ type: "text", text: JSON.stringify({ features }, null, 2) }]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
+    ),
+    tool2(
+      "generate_health_report",
+      "Generate a governance health check report covering artifact completeness and process health metrics",
+      {},
+      async () => {
+        const metrics = collectHealthMetrics(store);
+        const report = evaluateHealth("project", metrics);
+        return {
+          content: [{ type: "text", text: JSON.stringify(report, null, 2) }]
+        };
+      },
+      { annotations: { readOnlyHint: true } }
     ),
     tool2(
       "save_report",
@@ -14558,7 +14828,7 @@ function createFeatureTools(store) {
           content: [{ type: "text", text: JSON.stringify(summary, null, 2) }]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool3(
       "get_feature",
@@ -14585,7 +14855,7 @@ function createFeatureTools(store) {
           ]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool3(
       "create_feature",
@@ -14676,7 +14946,7 @@ function createEpicTools(store) {
           content: [{ type: "text", text: JSON.stringify(summary, null, 2) }]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool4(
       "get_epic",
@@ -14703,7 +14973,7 @@ function createEpicTools(store) {
           ]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool4(
       "create_epic",
@@ -14835,7 +15105,7 @@ function createContributionTools(store) {
           content: [{ type: "text", text: JSON.stringify(summary, null, 2) }]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool5(
       "get_contribution",
@@ -14862,7 +15132,7 @@ function createContributionTools(store) {
           ]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool5(
       "create_contribution",
@@ -14947,7 +15217,7 @@ function createSprintTools(store) {
           content: [{ type: "text", text: JSON.stringify(summary, null, 2) }]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool6(
       "get_sprint",
@@ -14974,7 +15244,7 @@ function createSprintTools(store) {
           ]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool6(
       "create_sprint",
@@ -15271,7 +15541,7 @@ function createSprintPlanningTools(store) {
           content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     )
   ];
 }
@@ -15325,6 +15595,7 @@ var genericAgilePlugin = {
 - Do NOT create epics \u2014 that is the Tech Lead's responsibility. You can view epics to track progress.
 - Use priority levels (critical, high, medium, low) to communicate business value.
 - Tag features for categorization and cross-referencing.
+- Include a \`dueDate\` on actions when target dates are known, to enable schedule tracking and overdue detection.
 
 **Contribution Tools:**
 - **list_contributions** / **get_contribution**: Browse and read contribution records.
@@ -15355,6 +15626,7 @@ var genericAgilePlugin = {
 - Tag work items (actions, decisions, questions) with \`epic:E-xxx\` to group them under an epic.
 - Collaborate with the Delivery Manager on target dates and effort estimates.
 - Each epic should have a clear scope and definition of done.
+- Set \`dueDate\` on technical actions based on sprint timelines or epic target dates. Use the \`sprints\` parameter to assign actions to relevant sprints.
 
 **Contribution Tools:**
 - **list_contributions** / **get_contribution**: Browse and read contribution records.
@@ -15414,6 +15686,11 @@ var genericAgilePlugin = {
 - **generate_sprint_progress**: Progress report for a specific sprint or all sprints \u2014 shows linked epics with statuses, work items tagged \`sprint:SP-xxx\` grouped by status, and done/total completion %.
 - Use \`save_report\` with reportType "sprint-progress" to persist sprint reports.
 
+**Date Enforcement:**
+- Always set \`dueDate\` when creating or updating actions. Use the \`sprints\` parameter to assign actions to sprints \u2014 the tool translates this into \`sprint:SP-xxx\` tags automatically.
+- When create_action suggests matching sprints in its response, review and assign accordingly using update_action.
+- Use \`suggest_sprints_for_action\` to find the right sprint for existing actions that lack sprint assignment.
+
 **Sprint Workflow:**
 - Create sprints with clear goals and date boundaries.
 - Assign epics to sprints via linkedEpics.
@@ -15433,7 +15710,7 @@ var genericAgilePlugin = {
 **Sprints** (SP-xxx): Time-boxed iterations that group epics and work items with delivery dates. Sprints progress through planned \u2192 active \u2192 completed (or cancelled).
 **Meetings**: Meeting records with attendees, agendas, and notes.
 
-**Key workflow rule:** Epics must link to approved features \u2014 the system enforces this. The Product Owner defines and approves features, the Tech Lead breaks them into epics, the Delivery Manager plans sprints and tracks dates and progress. Work items are associated with sprints via \`sprint:SP-xxx\` tags.
+**Key workflow rule:** Epics must link to approved features \u2014 the system enforces this. The Product Owner defines and approves features, the Tech Lead breaks them into epics, the Delivery Manager plans sprints and tracks dates and progress. Work items are associated with sprints via \`sprint:SP-xxx\` tags. Actions support a \`dueDate\` field for schedule tracking \u2014 actions with a past due date are automatically flagged as overdue in GAR reports. Use the \`sprints\` parameter on create_action/update_action to assign actions to sprints.
 
 - **list_meetings** / **get_meeting**: Browse and read meeting records.
 - **create_meeting**: Record meetings with attendees, date, and agenda. The meeting date is required \u2014 extract it from the meeting content or ask the user if not found.
@@ -15479,7 +15756,7 @@ function createUseCaseTools(store) {
           content: [{ type: "text", text: JSON.stringify(summary, null, 2) }]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool8(
       "get_use_case",
@@ -15506,7 +15783,7 @@ function createUseCaseTools(store) {
           ]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool8(
       "create_use_case",
@@ -15604,7 +15881,7 @@ function createTechAssessmentTools(store) {
           content: [{ type: "text", text: JSON.stringify(summary, null, 2) }]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool9(
       "get_tech_assessment",
@@ -15631,7 +15908,7 @@ function createTechAssessmentTools(store) {
           ]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool9(
       "create_tech_assessment",
@@ -15765,7 +16042,7 @@ function createExtensionDesignTools(store) {
           content: [{ type: "text", text: JSON.stringify(summary, null, 2) }]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool10(
       "get_extension_design",
@@ -15792,7 +16069,7 @@ function createExtensionDesignTools(store) {
           ]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool10(
       "create_extension_design",
@@ -15944,7 +16221,7 @@ function createAemReportTools(store) {
           ]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool11(
       "generate_tech_readiness",
@@ -15996,7 +16273,7 @@ function createAemReportTools(store) {
           ]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool11(
       "generate_phase_status",
@@ -16051,7 +16328,7 @@ function createAemReportTools(store) {
           ]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     )
   ];
 }
@@ -16083,7 +16360,7 @@ function createAemPhaseTools(store, marvinDir) {
           ]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool12(
       "advance_phase",
@@ -16517,6 +16794,8 @@ var deliveryManager = {
 
 ## How You Work
 - Review open actions (A-xxx) and follow up on overdue items
+- Ensure every action has a dueDate \u2014 use update_action to backfill existing ones
+- Assign actions to sprints when sprint planning is active, using the sprints parameter
 - Ensure decisions (D-xxx) are properly documented with rationale
 - Track questions (Q-xxx) and ensure they get answered
 - Monitor project health and flag risks early
@@ -16631,7 +16910,7 @@ function buildSystemPrompt(persona, projectConfig, pluginPromptFragment, skillPr
 ## Available Tools
 You have access to governance tools for managing project artifacts:
 - **Decisions** (D-xxx): List, get, create, and update decisions
-- **Actions** (A-xxx): List, get, create, and update action items
+- **Actions** (A-xxx): List, get, create, and update action items. Actions support \`dueDate\` for schedule tracking and \`sprints\` for sprint assignment.
 - **Questions** (Q-xxx): List, get, create, and update questions
 - **Features** (F-xxx): List, get, create, and update feature definitions
 - **Epics** (E-xxx): List, get, create, and update implementation epics (must link to approved features)
@@ -16982,7 +17261,7 @@ function createDecisionTools(store) {
           content: [{ type: "text", text: JSON.stringify(summary, null, 2) }]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool13(
       "get_decision",
@@ -17009,7 +17288,7 @@ function createDecisionTools(store) {
           ]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool13(
       "create_decision",
@@ -17070,6 +17349,19 @@ function createDecisionTools(store) {
 
 // src/agent/tools/actions.ts
 import { tool as tool14 } from "@anthropic-ai/claude-agent-sdk";
+function findMatchingSprints(store, dueDate) {
+  const sprints = store.list({ type: "sprint" });
+  return sprints.filter((s) => {
+    const start = s.frontmatter.startDate;
+    const end = s.frontmatter.endDate;
+    return start && end && dueDate >= start && dueDate <= end;
+  }).map((s) => ({
+    id: s.frontmatter.id,
+    title: s.frontmatter.title,
+    startDate: s.frontmatter.startDate,
+    endDate: s.frontmatter.endDate
+  }));
+}
 function createActionTools(store) {
   return [
     tool14(
@@ -17085,19 +17377,24 @@ function createActionTools(store) {
           status: args.status,
           owner: args.owner
         });
-        const summary = docs.map((d) => ({
-          id: d.frontmatter.id,
-          title: d.frontmatter.title,
-          status: d.frontmatter.status,
-          owner: d.frontmatter.owner,
-          priority: d.frontmatter.priority,
-          created: d.frontmatter.created
-        }));
+        const summary = docs.map((d) => {
+          const sprintIds = (d.frontmatter.tags ?? []).filter((t) => t.startsWith("sprint:")).map((t) => t.slice(7));
+          return {
+            id: d.frontmatter.id,
+            title: d.frontmatter.title,
+            status: d.frontmatter.status,
+            owner: d.frontmatter.owner,
+            priority: d.frontmatter.priority,
+            dueDate: d.frontmatter.dueDate,
+            sprints: sprintIds.length > 0 ? sprintIds : void 0,
+            created: d.frontmatter.created
+          };
+        });
         return {
           content: [{ type: "text", text: JSON.stringify(summary, null, 2) }]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool14(
       "get_action",
@@ -17124,7 +17421,7 @@ function createActionTools(store) {
           ]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool14(
       "create_action",
@@ -17135,9 +17432,18 @@ function createActionTools(store) {
         status: external_exports.string().optional().describe("Status (default: 'open')"),
         owner: external_exports.string().optional().describe("Person responsible"),
         priority: external_exports.string().optional().describe("Priority (high, medium, low)"),
-        tags: external_exports.array(external_exports.string()).optional().describe("Tags for categorization")
+        tags: external_exports.array(external_exports.string()).optional().describe("Tags for categorization"),
+        dueDate: external_exports.string().optional().describe("Due date in ISO format (e.g. '2026-03-15')"),
+        sprints: external_exports.array(external_exports.string()).optional().describe("Sprint IDs to assign (e.g. ['SP-001']). Adds sprint:SP-xxx tags.")
       },
       async (args) => {
+        const tags = [...args.tags ?? []];
+        if (args.sprints) {
+          for (const sprintId of args.sprints) {
+            const tag = `sprint:${sprintId}`;
+            if (!tags.includes(tag)) tags.push(tag);
+          }
+        }
         const doc = store.create(
           "action",
           {
@@ -17145,17 +17451,21 @@ function createActionTools(store) {
             status: args.status,
             owner: args.owner,
             priority: args.priority,
-            tags: args.tags
+            tags: tags.length > 0 ? tags : void 0,
+            dueDate: args.dueDate
           },
           args.content
         );
+        const parts = [`Created action ${doc.frontmatter.id}: ${doc.frontmatter.title}`];
+        if (args.dueDate && (!args.sprints || args.sprints.length === 0)) {
+          const matching = findMatchingSprints(store, args.dueDate);
+          if (matching.length > 0) {
+            const suggestions = matching.map((s) => `${s.id} "${s.title}" (${s.startDate} \u2013 ${s.endDate})`).join(", ");
+            parts.push(`Suggested sprints for dueDate ${args.dueDate}: ${suggestions}. Use the sprints parameter or update_action to assign.`);
+          }
+        }
         return {
-          content: [
-            {
-              type: "text",
-              text: `Created action ${doc.frontmatter.id}: ${doc.frontmatter.title}`
-            }
-          ]
+          content: [{ type: "text", text: parts.join("\n") }]
         };
       }
     ),
@@ -17168,10 +17478,25 @@ function createActionTools(store) {
         status: external_exports.string().optional().describe("New status"),
         content: external_exports.string().optional().describe("New content"),
         owner: external_exports.string().optional().describe("New owner"),
-        priority: external_exports.string().optional().describe("New priority")
+        priority: external_exports.string().optional().describe("New priority"),
+        dueDate: external_exports.string().optional().describe("Due date in ISO format (e.g. '2026-03-15')"),
+        sprints: external_exports.array(external_exports.string()).optional().describe("Sprint IDs to assign (replaces existing sprint tags). E.g. ['SP-001'].")
       },
       async (args) => {
-        const { id, content, ...updates } = args;
+        const { id, content, sprints, ...updates } = args;
+        if (sprints !== void 0) {
+          const existing = store.get(id);
+          if (!existing) {
+            return {
+              content: [{ type: "text", text: `Action ${id} not found` }],
+              isError: true
+            };
+          }
+          const existingTags = existing.frontmatter.tags ?? [];
+          const nonSprintTags = existingTags.filter((t) => !t.startsWith("sprint:"));
+          const newSprintTags = sprints.map((s) => `sprint:${s}`);
+          updates.tags = [...nonSprintTags, ...newSprintTags];
+        }
         const doc = store.update(id, updates, content);
         return {
           content: [
@@ -17182,6 +17507,35 @@ function createActionTools(store) {
           ]
         };
       }
+    ),
+    tool14(
+      "suggest_sprints_for_action",
+      "Suggest sprints whose date range contains the given due date. Helps assign actions to the right sprint.",
+      {
+        dueDate: external_exports.string().describe("Due date in ISO format (e.g. '2026-03-15')")
+      },
+      async (args) => {
+        const matching = findMatchingSprints(store, args.dueDate);
+        if (matching.length === 0) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: `No sprints found containing dueDate ${args.dueDate}.`
+              }
+            ]
+          };
+        }
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify(matching, null, 2)
+            }
+          ]
+        };
+      },
+      { annotations: { readOnlyHint: true } }
     )
   ];
 }
@@ -17209,7 +17563,7 @@ function createQuestionTools(store) {
           content: [{ type: "text", text: JSON.stringify(summary, null, 2) }]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool15(
       "get_question",
@@ -17236,7 +17590,7 @@ function createQuestionTools(store) {
           ]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool15(
       "create_question",
@@ -17329,7 +17683,7 @@ function createDocumentTools(store) {
           ]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool16(
       "read_document",
@@ -17356,7 +17710,7 @@ function createDocumentTools(store) {
           ]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool16(
       "project_summary",
@@ -17384,7 +17738,7 @@ function createDocumentTools(store) {
           content: [{ type: "text", text: JSON.stringify(summary, null, 2) }]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     )
   ];
 }
@@ -17421,7 +17775,7 @@ function createSourceTools(manifest) {
           ]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool17(
       "get_source_info",
@@ -17455,7 +17809,7 @@ function createSourceTools(manifest) {
           ]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     )
   ];
 }
@@ -17486,7 +17840,7 @@ function createSessionTools(store) {
           content: [{ type: "text", text: JSON.stringify(summary, null, 2) }]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool18(
       "get_session",
@@ -17504,7 +17858,7 @@ function createSessionTools(store) {
           content: [{ type: "text", text: JSON.stringify(session, null, 2) }]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     )
   ];
 }
@@ -17584,6 +17938,46 @@ function getBoardData(store, type) {
   }));
   return { columns, type, types };
 }
+function getDiagramData(store) {
+  const allDocs = store.list();
+  const sprints = [];
+  const epics = [];
+  const features = [];
+  const statusCounts = {};
+  for (const doc of allDocs) {
+    const fm = doc.frontmatter;
+    const status = fm.status.toLowerCase();
+    statusCounts[status] = (statusCounts[status] ?? 0) + 1;
+    switch (fm.type) {
+      case "sprint":
+        sprints.push({
+          id: fm.id,
+          title: fm.title,
+          status: fm.status,
+          startDate: fm.startDate,
+          endDate: fm.endDate,
+          linkedEpics: fm.linkedEpics ?? []
+        });
+        break;
+      case "epic":
+        epics.push({
+          id: fm.id,
+          title: fm.title,
+          status: fm.status,
+          linkedFeature: fm.linkedFeature
+        });
+        break;
+      case "feature":
+        features.push({
+          id: fm.id,
+          title: fm.title,
+          status: fm.status
+        });
+        break;
+    }
+  }
+  return { sprints, epics, features, statusCounts };
+}
 
 // src/web/templates/layout.ts
 function escapeHtml(str) {
@@ -17614,16 +18008,43 @@ function renderMarkdown(md) {
   const out = [];
   let inList = false;
   let listTag = "ul";
-  for (const raw of lines) {
-    const line = raw;
+  let inTable = false;
+  let i = 0;
+  while (i < lines.length) {
+    const line = lines[i];
     if (inList && !/^\s*[-*]\s/.test(line) && !/^\s*\d+\.\s/.test(line) && line.trim() !== "") {
       out.push(`</${listTag}>`);
       inList = false;
     }
+    if (inTable && !/^\s*\|/.test(line)) {
+      out.push("</tbody></table></div>");
+      inTable = false;
+    }
+    if (/^(-{3,}|\*{3,}|_{3,})\s*$/.test(line.trim())) {
+      i++;
+      out.push("<hr>");
+      continue;
+    }
+    if (!inTable && /^\s*\|/.test(line) && i + 1 < lines.length && /^\s*\|[\s:|-]+\|\s*$/.test(lines[i + 1])) {
+      const headers = parseTableRow(line);
+      out.push('<div class="table-wrap"><table><thead><tr>');
+      out.push(headers.map((h) => `<th>${inline(h)}</th>`).join(""));
+      out.push("</tr></thead><tbody>");
+      inTable = true;
+      i += 2;
+      continue;
+    }
+    if (inTable && /^\s*\|/.test(line)) {
+      const cells = parseTableRow(line);
+      out.push("<tr>" + cells.map((c) => `<td>${inline(c)}</td>`).join("") + "</tr>");
+      i++;
+      continue;
+    }
     const headingMatch = line.match(/^(#{1,3})\s+(.+)$/);
     if (headingMatch) {
       const level = headingMatch[1].length;
       out.push(`<h${level}>${inline(headingMatch[2])}</h${level}>`);
+      i++;
       continue;
     }
     const ulMatch = line.match(/^\s*[-*]\s+(.+)$/);
@@ -17635,6 +18056,7 @@ function renderMarkdown(md) {
         listTag = "ul";
       }
       out.push(`<li>${inline(ulMatch[1])}</li>`);
+      i++;
       continue;
     }
     const olMatch = line.match(/^\s*\d+\.\s+(.+)$/);
@@ -17646,6 +18068,7 @@ function renderMarkdown(md) {
         listTag = "ol";
       }
       out.push(`<li>${inline(olMatch[1])}</li>`);
+      i++;
       continue;
     }
     if (line.trim() === "") {
@@ -17653,13 +18076,19 @@ function renderMarkdown(md) {
         out.push(`</${listTag}>`);
         inList = false;
       }
+      i++;
       continue;
     }
     out.push(`<p>${inline(line)}</p>`);
+    i++;
   }
   if (inList) out.push(`</${listTag}>`);
+  if (inTable) out.push("</tbody></table></div>");
   return out.join("\n");
 }
+function parseTableRow(line) {
+  return line.replace(/^\s*\|/, "").replace(/\|\s*$/, "").split("|").map((cell) => cell.trim());
+}
 function inline(text) {
   let s = escapeHtml(text);
   s = s.replace(/`([^`]+)`/g, "<code>$1</code>");
@@ -17673,7 +18102,8 @@ function layout(opts, body) {
   const topItems = [
     { href: "/", label: "Overview" },
     { href: "/board", label: "Board" },
-    { href: "/gar", label: "GAR Report" }
+    { href: "/gar", label: "GAR Report" },
+    { href: "/health", label: "Health" }
   ];
   const isActive = (href) => opts.activePath === href || href !== "/" && opts.activePath.startsWith(href) ? " active" : "";
   const groupsHtml = opts.navGroups.map((group) => {
@@ -17708,9 +18138,15 @@ function layout(opts, body) {
       </nav>
     </aside>
     <main class="main">
+      <button class="expand-toggle" onclick="document.querySelector('.main').classList.toggle('expanded')" title="Toggle wide view">
+        <svg class="icon-expand" viewBox="0 0 16 16" width="16" height="16" fill="currentColor"><path d="M1 1h5v1.5H3.56l3.72 3.72-1.06 1.06L2.5 3.56V6H1V1zm14 14h-5v-1.5h2.44l-3.72-3.72 1.06-1.06 3.72 3.72V10H15v5z"/></svg>
+        <svg class="icon-collapse" viewBox="0 0 16 16" width="16" height="16" fill="currentColor"><path d="M6 7H1V5.5h2.44L0.22 2.28l1.06-1.06L4.5 4.44V2H6v5zm4-1h5v1.5h-2.44l3.22 3.22-1.06 1.06L11.5 8.56V11H10V6z"/></svg>
+      </button>
       ${body}
     </main>
   </div>
+  <script src="https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.min.js"></script>
+  <script>mermaid.initialize({ startOnLoad: true, theme: 'dark' });</script>
 </body>
 </html>`;
 }
@@ -17825,7 +18261,33 @@ a:hover { text-decoration: underline; }
   flex: 1;
   padding: 2rem 2.5rem;
   max-width: 1200px;
+  position: relative;
+  transition: max-width 0.2s ease;
+}
+.main.expanded {
+  max-width: none;
+}
+.expand-toggle {
+  position: absolute;
+  top: 1rem;
+  right: 1rem;
+  background: var(--bg-card);
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  color: var(--text-dim);
+  cursor: pointer;
+  padding: 0.4rem;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  transition: color 0.15s, border-color 0.15s;
 }
+.expand-toggle:hover {
+  color: var(--text);
+  border-color: var(--text-dim);
+}
+.main.expanded .icon-expand { display: none; }
+.main:not(.expanded) .icon-collapse { display: none; }
 
 /* Page header */
 .page-header {
@@ -17854,12 +18316,26 @@ a:hover { text-decoration: underline; }
 .breadcrumb a:hover { color: var(--accent); }
 .breadcrumb .sep { margin: 0 0.4rem; }
 
+/* Card groups */
+.card-group {
+  margin-bottom: 1.5rem;
+}
+
+.card-group-label {
+  font-size: 0.7rem;
+  text-transform: uppercase;
+  letter-spacing: 0.08em;
+  color: var(--text-dim);
+  font-weight: 600;
+  margin-bottom: 0.5rem;
+}
+
 /* Cards grid */
 .cards {
   display: grid;
   grid-template-columns: repeat(auto-fill, minmax(200px, 1fr));
   gap: 1rem;
-  margin-bottom: 2rem;
+  margin-bottom: 0.5rem;
 }
 
 .card {
@@ -18140,6 +18616,14 @@ tr:hover td {
   font-family: var(--mono);
   font-size: 0.85em;
 }
+.detail-content hr {
+  border: none;
+  border-top: 1px solid var(--border);
+  margin: 1.25rem 0;
+}
+.detail-content .table-wrap {
+  margin: 0.75rem 0;
+}
 
 /* Filters */
 .filters {
@@ -18184,21 +18668,206 @@ tr:hover td {
 .priority-high { color: var(--red); }
 .priority-medium { color: var(--amber); }
 .priority-low { color: var(--green); }
+
+/* Health */
+.health-section-title {
+  font-size: 1.1rem;
+  font-weight: 600;
+  margin: 2rem 0 1rem;
+  color: var(--text);
+}
+
+/* Mermaid diagrams */
+.mermaid-container {
+  background: var(--bg-card);
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  padding: 1.5rem;
+  margin: 1rem 0;
+  overflow-x: auto;
+}
+
+.mermaid-container .mermaid {
+  display: flex;
+  justify-content: center;
+}
+
+.mermaid-empty {
+  text-align: center;
+  color: var(--text-dim);
+  font-size: 0.875rem;
+}
+
+.mermaid-row {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(250px, 1fr));
+  gap: 1rem;
+}
+
+.mermaid-row .mermaid-container {
+  margin: 0;
+}
 `;
 }
 
+// src/web/templates/mermaid.ts
+function sanitize(text, maxLen = 40) {
+  const cleaned = text.replace(/["'`]/g, "").replace(/[\r\n]+/g, " ");
+  return cleaned.length > maxLen ? cleaned.slice(0, maxLen - 1) + "\u2026" : cleaned;
+}
+function mermaidBlock(definition) {
+  return `<div class="mermaid-container"><pre class="mermaid">
+${definition}
+</pre></div>`;
+}
+function placeholder(message) {
+  return `<div class="mermaid-container mermaid-empty"><p>${message}</p></div>`;
+}
+function buildTimelineGantt(data) {
+  const sprintsWithDates = data.sprints.filter((s) => s.startDate && s.endDate);
+  if (sprintsWithDates.length === 0) {
+    return placeholder("No timeline data available \u2014 sprints need start and end dates.");
+  }
+  const epicMap = new Map(data.epics.map((e) => [e.id, e]));
+  const lines = ["gantt", "  title Project Timeline", "  dateFormat YYYY-MM-DD"];
+  for (const sprint of sprintsWithDates) {
+    lines.push(`  section ${sanitize(sprint.id + " " + sprint.title, 50)}`);
+    const linked = sprint.linkedEpics.map((eid) => epicMap.get(eid)).filter(Boolean);
+    if (linked.length === 0) {
+      lines.push(`    ${sanitize(sprint.title)} :${sprint.startDate}, ${sprint.endDate}`);
+    } else {
+      for (const epic of linked) {
+        const tag = epic.status === "in-progress" ? "active, " : epic.status === "done" ? "done, " : "";
+        lines.push(`    ${sanitize(epic.id + " " + epic.title)} :${tag}${sprint.startDate}, ${sprint.endDate}`);
+      }
+    }
+  }
+  return mermaidBlock(lines.join("\n"));
+}
+function buildArtifactFlowchart(data) {
+  if (data.features.length === 0 && data.epics.length === 0) {
+    return placeholder("No artifact relationships found \u2014 create features and epics to see the hierarchy.");
+  }
+  const lines = ["graph TD"];
+  lines.push("  classDef done fill:#065f46,stroke:#34d399,color:#d1fae5");
+  lines.push("  classDef inprogress fill:#78350f,stroke:#fbbf24,color:#fef3c7");
+  lines.push("  classDef blocked fill:#7f1d1d,stroke:#f87171,color:#fee2e2");
+  lines.push("  classDef default fill:#1e293b,stroke:#475569,color:#e2e8f0");
+  const nodeIds = /* @__PURE__ */ new Set();
+  for (const epic of data.epics) {
+    if (epic.linkedFeature) {
+      const feature = data.features.find((f) => f.id === epic.linkedFeature);
+      if (feature) {
+        const fNode = feature.id.replace(/-/g, "_");
+        const eNode = epic.id.replace(/-/g, "_");
+        if (!nodeIds.has(fNode)) {
+          lines.push(`  ${fNode}["${sanitize(feature.id + " " + feature.title)}"]`);
+          nodeIds.add(fNode);
+        }
+        if (!nodeIds.has(eNode)) {
+          lines.push(`  ${eNode}["${sanitize(epic.id + " " + epic.title)}"]`);
+          nodeIds.add(eNode);
+        }
+        lines.push(`  ${fNode} --> ${eNode}`);
+      }
+    }
+  }
+  for (const sprint of data.sprints) {
+    const sNode = sprint.id.replace(/-/g, "_");
+    for (const epicId of sprint.linkedEpics) {
+      const epic = data.epics.find((e) => e.id === epicId);
+      if (epic) {
+        const eNode = epic.id.replace(/-/g, "_");
+        if (!nodeIds.has(eNode)) {
+          lines.push(`  ${eNode}["${sanitize(epic.id + " " + epic.title)}"]`);
+          nodeIds.add(eNode);
+        }
+        if (!nodeIds.has(sNode)) {
+          lines.push(`  ${sNode}["${sanitize(sprint.id + " " + sprint.title)}"]`);
+          nodeIds.add(sNode);
+        }
+        lines.push(`  ${eNode} --> ${sNode}`);
+      }
+    }
+  }
+  if (nodeIds.size === 0) {
+    return placeholder("No artifact relationships found \u2014 link epics to features and sprints.");
+  }
+  const allItems = [
+    ...data.features.map((f) => ({ id: f.id, status: f.status })),
+    ...data.epics.map((e) => ({ id: e.id, status: e.status })),
+    ...data.sprints.map((s) => ({ id: s.id, status: s.status }))
+  ];
+  for (const item of allItems) {
+    const node = item.id.replace(/-/g, "_");
+    if (!nodeIds.has(node)) continue;
+    const cls = item.status === "done" || item.status === "completed" ? "done" : item.status === "in-progress" || item.status === "active" ? "inprogress" : item.status === "blocked" ? "blocked" : null;
+    if (cls) {
+      lines.push(`  class ${node} ${cls}`);
+    }
+  }
+  return mermaidBlock(lines.join("\n"));
+}
+function buildStatusPie(title, counts) {
+  const entries = Object.entries(counts).filter(([, v]) => v > 0);
+  if (entries.length === 0) {
+    return placeholder(`No data for ${title}.`);
+  }
+  const lines = [`pie title ${sanitize(title, 60)}`];
+  for (const [label, count] of entries) {
+    lines.push(`  "${sanitize(label, 30)}" : ${count}`);
+  }
+  return mermaidBlock(lines.join("\n"));
+}
+function buildHealthGauge(categories) {
+  const valid = categories.filter((c) => c.total > 0);
+  if (valid.length === 0) {
+    return placeholder("No completeness data available.");
+  }
+  const pies = valid.map((cat) => {
+    const incomplete = cat.total - cat.complete;
+    const lines = [
+      `pie title ${sanitize(cat.name, 30)}`,
+      `  "Complete" : ${cat.complete}`,
+      `  "Incomplete" : ${incomplete}`
+    ];
+    return mermaidBlock(lines.join("\n"));
+  });
+  return `<div class="mermaid-row">${pies.join("\n")}</div>`;
+}
+
 // src/web/templates/pages/overview.ts
-function overviewPage(data) {
-  const cards = data.types.map(
-    (t) => `
+function renderCard(t) {
+  return `
       <div class="card">
         <a href="/docs/${t.type}">
           <div class="card-label">${escapeHtml(typeLabel(t.type))}s</div>
           <div class="card-value">${t.total}</div>
           ${t.open > 0 ? `<div class="card-sub">${t.open} open</div>` : `<div class="card-sub">none open</div>`}
         </a>
-      </div>`
-  ).join("\n");
+      </div>`;
+}
+function overviewPage(data, diagrams, navGroups) {
+  const typeMap = new Map(data.types.map((t) => [t.type, t]));
+  const placed = /* @__PURE__ */ new Set();
+  const groupSections = navGroups.map((group) => {
+    const groupCards = group.types.filter((type) => typeMap.has(type)).map((type) => {
+      placed.add(type);
+      return renderCard(typeMap.get(type));
+    });
+    if (groupCards.length === 0) return "";
+    return `
+      <div class="card-group">
+        <div class="card-group-label">${escapeHtml(group.label)}</div>
+        <div class="cards">${groupCards.join("\n")}</div>
+      </div>`;
+  }).filter(Boolean).join("\n");
+  const ungrouped = data.types.filter((t) => !placed.has(t.type));
+  const ungroupedSection = ungrouped.length > 0 ? `
+      <div class="card-group">
+        <div class="card-group-label">Other</div>
+        <div class="cards">${ungrouped.map(renderCard).join("\n")}</div>
+      </div>` : "";
   const rows = data.recent.map(
     (doc) => `
         <tr>
@@ -18214,9 +18883,14 @@ function overviewPage(data) {
       <h2>Project Overview</h2>
     </div>
 
-    <div class="cards">
-      ${cards}
-    </div>
+    ${groupSections}
+    ${ungroupedSection}
+
+    <div class="section-title">Project Timeline</div>
+    ${buildTimelineGantt(diagrams)}
+
+    <div class="section-title">Artifact Relationships</div>
+    ${buildArtifactFlowchart(diagrams)}
 
     <div class="section-title">Recent Activity</div>
     ${data.recent.length > 0 ? `
@@ -18383,6 +19057,76 @@ function garPage(report) {
     <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)
+  })}
+  `;
+}
+
+// src/web/templates/pages/health.ts
+function healthPage(report, metrics) {
+  const dotClass = `dot-${report.overall}`;
+  function renderSection(title, categories) {
+    const cards = categories.map(
+      (cat) => `
+        <div class="gar-area">
+          <div class="area-header">
+            <div class="area-dot dot-${cat.status}"></div>
+            <div class="area-name">${escapeHtml(cat.name)}</div>
+          </div>
+          <div class="area-summary">${escapeHtml(cat.summary)}</div>
+          ${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 `
+    <div class="page-header">
+      <h2>Governance Health Check</h2>
+      <div class="subtitle">Generated ${escapeHtml(report.generatedAt)}</div>
+    </div>
+
+    <div class="gar-overall">
+      <div class="dot ${dotClass}"></div>
+      <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("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
+    )
+  }) : ""}
   `;
 }
 
@@ -18449,7 +19193,8 @@ function handleRequest(req, res, store, projectName, navGroups) {
     }
     if (pathname === "/") {
       const data = getOverviewData(store);
-      const body = overviewPage(data);
+      const diagrams = getDiagramData(store);
+      const body = overviewPage(data, diagrams, navGroups);
       respond(res, layout({ title: "Overview", activePath: "/", projectName, navGroups }, body));
       return;
     }
@@ -18459,6 +19204,13 @@ function handleRequest(req, res, store, projectName, navGroups) {
       respond(res, layout({ title: "GAR Report", activePath: "/gar", projectName, navGroups }, body));
       return;
     }
+    if (pathname === "/health") {
+      const healthMetrics = collectHealthMetrics(store);
+      const report = evaluateHealth(projectName, healthMetrics);
+      const body = healthPage(report, healthMetrics);
+      respond(res, layout({ title: "Health Check", activePath: "/health", projectName, navGroups }, body));
+      return;
+    }
     const boardMatch = pathname.match(/^\/board(?:\/([^/]+))?$/);
     if (boardMatch) {
       const type = boardMatch[1];
@@ -18698,7 +19450,7 @@ function createJiraTools(store) {
           content: [{ type: "text", text: JSON.stringify(summary, null, 2) }]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool19(
       "get_jira_issue",
@@ -18730,7 +19482,7 @@ function createJiraTools(store) {
           ]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     // --- Jira → Local tools ---
     tool19(
@@ -19461,7 +20213,7 @@ function createWebTools(store, projectName, navGroups) {
           content: [{ type: "text", text: JSON.stringify(urls, null, 2) }]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool20(
       "get_dashboard_overview",
@@ -19483,7 +20235,7 @@ function createWebTools(store, projectName, navGroups) {
           content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool20(
       "get_dashboard_gar",
@@ -19495,7 +20247,7 @@ function createWebTools(store, projectName, navGroups) {
           content: [{ type: "text", text: JSON.stringify(report, null, 2) }]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool20(
       "get_dashboard_board",
@@ -19523,7 +20275,7 @@ function createWebTools(store, projectName, navGroups) {
           content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     )
   ];
 }
@@ -21074,7 +21826,7 @@ ${summaries}`
           content: [{ type: "text", text: guidance }]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     )
   ];
 }
@@ -22629,6 +23381,105 @@ function renderConfluence(report) {
   return lines.join("\n");
 }
 
+// src/reports/health/render-ascii.ts
+import chalk17 from "chalk";
+var STATUS_DOT2 = {
+  green: chalk17.green("\u25CF"),
+  amber: chalk17.yellow("\u25CF"),
+  red: chalk17.red("\u25CF")
+};
+var STATUS_LABEL2 = {
+  green: chalk17.green.bold("GREEN"),
+  amber: chalk17.yellow.bold("AMBER"),
+  red: chalk17.red.bold("RED")
+};
+var SEPARATOR2 = chalk17.dim("\u2500".repeat(60));
+function renderAscii2(report) {
+  const lines = [];
+  lines.push("");
+  lines.push(chalk17.bold(`  Health Check \xB7 ${report.projectName}`));
+  lines.push(chalk17.dim(`  ${report.generatedAt}`));
+  lines.push("");
+  lines.push(`  Overall:  ${STATUS_LABEL2[report.overall]}`);
+  lines.push("");
+  lines.push(`  ${SEPARATOR2}`);
+  lines.push(chalk17.bold("  Completeness"));
+  lines.push(`  ${SEPARATOR2}`);
+  for (const cat of report.completeness) {
+    lines.push(`  ${STATUS_DOT2[cat.status]} ${chalk17.bold(cat.name.padEnd(16))} ${cat.summary}`);
+    for (const item of cat.items) {
+      lines.push(`    ${chalk17.dim("\u2514")} ${item.id} ${chalk17.dim(item.detail)}`);
+    }
+  }
+  lines.push("");
+  lines.push(`  ${SEPARATOR2}`);
+  lines.push(chalk17.bold("  Process"));
+  lines.push(`  ${SEPARATOR2}`);
+  for (const cat of report.process) {
+    lines.push(`  ${STATUS_DOT2[cat.status]} ${chalk17.bold(cat.name.padEnd(22))} ${cat.summary}`);
+    for (const item of cat.items) {
+      lines.push(`    ${chalk17.dim("\u2514")} ${item.id} ${chalk17.dim(item.detail)}`);
+    }
+  }
+  lines.push(`  ${SEPARATOR2}`);
+  lines.push("");
+  return lines.join("\n");
+}
+
+// src/reports/health/render-confluence.ts
+var EMOJI2 = {
+  green: ":green_circle:",
+  amber: ":yellow_circle:",
+  red: ":red_circle:"
+};
+function renderConfluence2(report) {
+  const lines = [];
+  lines.push(`# Health Check \u2014 ${report.projectName}`);
+  lines.push("");
+  lines.push(`**Date:** ${report.generatedAt}`);
+  lines.push(`**Overall:** ${EMOJI2[report.overall]} ${report.overall.toUpperCase()}`);
+  lines.push("");
+  lines.push("## Completeness");
+  lines.push("");
+  lines.push("| Category | Status | Summary |");
+  lines.push("|----------|--------|---------|");
+  for (const cat of report.completeness) {
+    lines.push(
+      `| ${cat.name} | ${EMOJI2[cat.status]} ${cat.status.toUpperCase()} | ${cat.summary} |`
+    );
+  }
+  lines.push("");
+  for (const cat of report.completeness) {
+    if (cat.items.length === 0) continue;
+    lines.push(`### ${cat.name}`);
+    lines.push("");
+    for (const item of cat.items) {
+      lines.push(`- **${item.id}** ${item.detail}`);
+    }
+    lines.push("");
+  }
+  lines.push("## Process");
+  lines.push("");
+  lines.push("| Metric | Status | Summary |");
+  lines.push("|--------|--------|---------|");
+  for (const cat of report.process) {
+    lines.push(
+      `| ${cat.name} | ${EMOJI2[cat.status]} ${cat.status.toUpperCase()} | ${cat.summary} |`
+    );
+  }
+  lines.push("");
+  for (const cat of report.process) {
+    if (cat.items.length === 0) continue;
+    lines.push(`### ${cat.name}`);
+    lines.push("");
+    for (const item of cat.items) {
+      lines.push(`- **${item.id}** ${item.detail}`);
+    }
+    lines.push("");
+  }
+  return lines.join("\n");
+}
+
 // src/cli/commands/report.ts
 async function garReportCommand(options) {
   const project = loadProject();
@@ -22644,6 +23495,20 @@ async function garReportCommand(options) {
     console.log(renderAscii(report));
   }
 }
+async function healthReportCommand(options) {
+  const project = loadProject();
+  const plugin = resolvePlugin(project.config.methodology);
+  const registrations = plugin?.documentTypeRegistrations ?? [];
+  const store = new DocumentStore(project.marvinDir, registrations);
+  const metrics = collectHealthMetrics(store);
+  const report = evaluateHealth(project.config.name, metrics);
+  const format = options.format ?? "ascii";
+  if (format === "confluence") {
+    console.log(renderConfluence2(report));
+  } else {
+    console.log(renderAscii2(report));
+  }
+}
 
 // src/cli/commands/web.ts
 async function webCommand(options) {
@@ -22660,7 +23525,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.3.3");
+  ).version("0.3.5");
   program2.command("init").description("Initialize a new Marvin project in the current directory").action(async () => {
     await initCommand();
   });
@@ -22737,6 +23602,12 @@ function createProgram() {
   ).action(async (options) => {
     await garReportCommand(options);
   });
+  reportCmd.command("health").description("Generate a governance health check report").option(
+    "--format <format>",
+    "Output format: ascii or confluence (default: ascii)"
+  ).action(async (options) => {
+    await healthReportCommand(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);
   });