mrvn-cli 0.3.2 → 0.3.5

package/dist/marvin-serve.js

@@ -6474,13 +6474,13 @@ var error16 = () => {
     // no unit
   };
   const typeEntry = (t) => t ? TypeNames[t] : void 0;
-  const typeLabel = (t) => {
+  const typeLabel2 = (t) => {
     const e = typeEntry(t);
     if (e)
       return e.label;
     return t ?? TypeNames.unknown.label;
   };
-  const withDefinite = (t) => `\u05D4${typeLabel(t)}`;
+  const withDefinite = (t) => `\u05D4${typeLabel2(t)}`;
   const verbFor = (t) => {
     const e = typeEntry(t);
     const gender = e?.gender ?? "m";
@@ -6530,7 +6530,7 @@ var error16 = () => {
     switch (issue2.code) {
       case "invalid_type": {
         const expectedKey = issue2.expected;
-        const expected = TypeDictionary[expectedKey ?? ""] ?? typeLabel(expectedKey);
+        const expected = TypeDictionary[expectedKey ?? ""] ?? typeLabel2(expectedKey);
         const receivedType = parsedType(issue2.input);
         const received = TypeDictionary[receivedType] ?? TypeNames[receivedType]?.label ?? receivedType;
         if (/^[A-Z]/.test(issue2.expected)) {
@@ -14227,7 +14227,7 @@ function createDecisionTools(store) {
           content: [{ type: "text", text: JSON.stringify(summary, null, 2) }]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool(
       "get_decision",
@@ -14254,7 +14254,7 @@ function createDecisionTools(store) {
           ]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool(
       "create_decision",
@@ -14315,6 +14315,19 @@ function createDecisionTools(store) {
 
 // src/agent/tools/actions.ts
 import { tool as tool2 } 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 [
     tool2(
@@ -14330,19 +14343,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 } }
     ),
     tool2(
       "get_action",
@@ -14369,7 +14387,7 @@ function createActionTools(store) {
           ]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool2(
       "create_action",
@@ -14380,9 +14398,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",
           {
@@ -14390,17 +14417,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") }]
         };
       }
     ),
@@ -14413,10 +14444,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: [
@@ -14427,6 +14473,35 @@ function createActionTools(store) {
           ]
         };
       }
+    ),
+    tool2(
+      "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 } }
     )
   ];
 }
@@ -14454,7 +14529,7 @@ function createQuestionTools(store) {
           content: [{ type: "text", text: JSON.stringify(summary, null, 2) }]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool3(
       "get_question",
@@ -14481,7 +14556,7 @@ function createQuestionTools(store) {
           ]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool3(
       "create_question",
@@ -14574,7 +14649,7 @@ function createDocumentTools(store) {
           ]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool4(
       "read_document",
@@ -14601,7 +14676,7 @@ function createDocumentTools(store) {
           ]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool4(
       "project_summary",
@@ -14629,7 +14704,7 @@ function createDocumentTools(store) {
           content: [{ type: "text", text: JSON.stringify(summary, null, 2) }]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     )
   ];
 }
@@ -14666,7 +14741,7 @@ function createSourceTools(manifest) {
           ]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool5(
       "get_source_info",
@@ -14700,7 +14775,7 @@ function createSourceTools(manifest) {
           ]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     )
   ];
 }
@@ -14731,7 +14806,7 @@ function createSessionTools(store) {
           content: [{ type: "text", text: JSON.stringify(summary, null, 2) }]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool6(
       "get_session",
@@ -14749,7 +14824,7 @@ function createSessionTools(store) {
           content: [{ type: "text", text: JSON.stringify(session, null, 2) }]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     )
   ];
 }
@@ -14842,7 +14917,7 @@ function createMeetingTools(store) {
           content: [{ type: "text", text: JSON.stringify(summary, null, 2) }]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool7(
       "get_meeting",
@@ -14869,7 +14944,7 @@ function createMeetingTools(store) {
           ]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool7(
       "create_meeting",
@@ -14994,7 +15069,7 @@ function createMeetingTools(store) {
           content: [{ type: "text", text: sections.join("\n") }]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     )
   ];
 }
@@ -15011,9 +15086,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")
@@ -15122,6 +15205,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 [
@@ -15141,7 +15471,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,
@@ -15160,7 +15491,7 @@ function createReportTools(store) {
           content: [{ type: "text", text: JSON.stringify(report, null, 2) }]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool8(
       "generate_risk_register",
@@ -15204,7 +15535,7 @@ function createReportTools(store) {
           content: [{ type: "text", text: JSON.stringify(register, null, 2) }]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool8(
       "generate_gar_report",
@@ -15217,7 +15548,7 @@ function createReportTools(store) {
           content: [{ type: "text", text: JSON.stringify(report, null, 2) }]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool8(
       "generate_epic_progress",
@@ -15302,7 +15633,7 @@ function createReportTools(store) {
           ]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool8(
       "generate_sprint_progress",
@@ -15347,7 +15678,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
               }))
             }
           };
@@ -15356,7 +15688,7 @@ function createReportTools(store) {
           content: [{ type: "text", text: JSON.stringify({ sprints }, null, 2) }]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool8(
       "generate_feature_progress",
@@ -15396,7 +15728,20 @@ function createReportTools(store) {
           content: [{ type: "text", text: JSON.stringify({ features }, null, 2) }]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
+    ),
+    tool8(
+      "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 } }
     ),
     tool8(
       "save_report",
@@ -15458,7 +15803,7 @@ function createFeatureTools(store) {
           content: [{ type: "text", text: JSON.stringify(summary, null, 2) }]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool9(
       "get_feature",
@@ -15485,7 +15830,7 @@ function createFeatureTools(store) {
           ]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool9(
       "create_feature",
@@ -15576,7 +15921,7 @@ function createEpicTools(store) {
           content: [{ type: "text", text: JSON.stringify(summary, null, 2) }]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool10(
       "get_epic",
@@ -15603,7 +15948,7 @@ function createEpicTools(store) {
           ]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool10(
       "create_epic",
@@ -15735,7 +16080,7 @@ function createContributionTools(store) {
           content: [{ type: "text", text: JSON.stringify(summary, null, 2) }]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool11(
       "get_contribution",
@@ -15762,7 +16107,7 @@ function createContributionTools(store) {
           ]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool11(
       "create_contribution",
@@ -15847,7 +16192,7 @@ function createSprintTools(store) {
           content: [{ type: "text", text: JSON.stringify(summary, null, 2) }]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool12(
       "get_sprint",
@@ -15874,7 +16219,7 @@ function createSprintTools(store) {
           ]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool12(
       "create_sprint",
@@ -16171,7 +16516,7 @@ function createSprintPlanningTools(store) {
           content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     )
   ];
 }
@@ -16225,6 +16570,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.
@@ -16255,6 +16601,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.
@@ -16314,6 +16661,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.
@@ -16333,7 +16685,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.
@@ -16379,7 +16731,7 @@ function createUseCaseTools(store) {
           content: [{ type: "text", text: JSON.stringify(summary, null, 2) }]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool14(
       "get_use_case",
@@ -16406,7 +16758,7 @@ function createUseCaseTools(store) {
           ]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool14(
       "create_use_case",
@@ -16504,7 +16856,7 @@ function createTechAssessmentTools(store) {
           content: [{ type: "text", text: JSON.stringify(summary, null, 2) }]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool15(
       "get_tech_assessment",
@@ -16531,7 +16883,7 @@ function createTechAssessmentTools(store) {
           ]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool15(
       "create_tech_assessment",
@@ -16665,7 +17017,7 @@ function createExtensionDesignTools(store) {
           content: [{ type: "text", text: JSON.stringify(summary, null, 2) }]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool16(
       "get_extension_design",
@@ -16692,7 +17044,7 @@ function createExtensionDesignTools(store) {
           ]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool16(
       "create_extension_design",
@@ -16844,7 +17196,7 @@ function createAemReportTools(store) {
           ]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool17(
       "generate_tech_readiness",
@@ -16896,7 +17248,7 @@ function createAemReportTools(store) {
           ]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool17(
       "generate_phase_status",
@@ -16951,7 +17303,7 @@ function createAemReportTools(store) {
           ]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     )
   ];
 }
@@ -16983,7 +17335,7 @@ function createAemPhaseTools(store, marvinDir) {
           ]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool18(
       "advance_phase",
@@ -17428,7 +17780,7 @@ function createJiraTools(store) {
           content: [{ type: "text", text: JSON.stringify(summary, null, 2) }]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     tool19(
       "get_jira_issue",
@@ -17460,7 +17812,7 @@ function createJiraTools(store) {
           ]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     ),
     // --- Jira → Local tools ---
     tool19(
@@ -17934,7 +18286,7 @@ ${fragment}`);
 }
 
 // src/skills/action-tools.ts
-import { tool as tool20 } from "@anthropic-ai/claude-agent-sdk";
+import { tool as tool21 } from "@anthropic-ai/claude-agent-sdk";
 
 // src/skills/action-runner.ts
 import { query } from "@anthropic-ai/claude-agent-sdk";
@@ -17943,6 +18295,1570 @@ import { query } from "@anthropic-ai/claude-agent-sdk";
 import {
   createSdkMcpServer
 } from "@anthropic-ai/claude-agent-sdk";
+
+// src/agent/tools/web.ts
+import * as http2 from "http";
+import { tool as tool20 } from "@anthropic-ai/claude-agent-sdk";
+
+// src/web/data.ts
+function getOverviewData(store) {
+  const types = [];
+  const counts = store.counts();
+  for (const type of store.registeredTypes) {
+    const total = counts[type] ?? 0;
+    const open = store.list({ type, status: "open" }).length;
+    types.push({ type, total, open });
+  }
+  const allDocs = store.list();
+  const sorted = allDocs.sort(
+    (a, b) => (b.frontmatter.updated ?? b.frontmatter.created).localeCompare(
+      a.frontmatter.updated ?? a.frontmatter.created
+    )
+  );
+  return { types, recent: sorted.slice(0, 20) };
+}
+function getDocumentListData(store, type, filterStatus, filterOwner) {
+  if (!store.registeredTypes.includes(type)) return void 0;
+  const allOfType = store.list({ type });
+  const statuses = [...new Set(allOfType.map((d) => d.frontmatter.status))].sort();
+  const owners = [
+    ...new Set(allOfType.map((d) => d.frontmatter.owner).filter(Boolean))
+  ].sort();
+  let docs = allOfType;
+  if (filterStatus) {
+    docs = docs.filter((d) => d.frontmatter.status === filterStatus);
+  }
+  if (filterOwner) {
+    docs = docs.filter((d) => d.frontmatter.owner === filterOwner);
+  }
+  docs.sort((a, b) => a.frontmatter.id.localeCompare(b.frontmatter.id));
+  return { type, docs, statuses, owners, filterStatus, filterOwner };
+}
+function getDocumentDetail(store, type, id) {
+  if (!store.registeredTypes.includes(type)) return void 0;
+  return store.get(id);
+}
+function getGarData(store, projectName) {
+  const metrics = collectGarMetrics(store);
+  return evaluateGar(projectName, metrics);
+}
+function getBoardData(store, type) {
+  const docs = type ? store.list({ type }) : store.list();
+  const types = store.registeredTypes;
+  const byStatus = /* @__PURE__ */ new Map();
+  for (const doc of docs) {
+    const status = doc.frontmatter.status;
+    if (!byStatus.has(status)) byStatus.set(status, []);
+    byStatus.get(status).push(doc);
+  }
+  const statusOrder = ["open", "draft", "in-progress", "blocked"];
+  const allStatuses = [...byStatus.keys()];
+  const ordered = [];
+  for (const s of statusOrder) {
+    if (allStatuses.includes(s)) ordered.push(s);
+  }
+  for (const s of allStatuses.sort()) {
+    if (!ordered.includes(s) && s !== "done" && s !== "closed" && s !== "resolved") {
+      ordered.push(s);
+    }
+  }
+  for (const s of ["done", "closed", "resolved"]) {
+    if (allStatuses.includes(s)) ordered.push(s);
+  }
+  const columns = ordered.map((status) => ({
+    status,
+    docs: byStatus.get(status) ?? []
+  }));
+  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) {
+  return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
+function statusBadge(status) {
+  const cls = {
+    open: "badge-open",
+    done: "badge-done",
+    closed: "badge-done",
+    resolved: "badge-resolved",
+    "in-progress": "badge-in-progress",
+    "in progress": "badge-in-progress",
+    draft: "badge-draft",
+    blocked: "badge-blocked"
+  }[status.toLowerCase()] ?? "badge-default";
+  return `<span class="badge ${cls}">${escapeHtml(status)}</span>`;
+}
+function formatDate(iso) {
+  if (!iso) return "";
+  return iso.slice(0, 10);
+}
+function typeLabel(type) {
+  return type.replace(/-/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
+}
+function renderMarkdown(md) {
+  const lines = md.split("\n");
+  const out = [];
+  let inList = false;
+  let listTag = "ul";
+  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+(.+)$/);
+    if (ulMatch) {
+      if (!inList || listTag !== "ul") {
+        if (inList) out.push(`</${listTag}>`);
+        out.push("<ul>");
+        inList = true;
+        listTag = "ul";
+      }
+      out.push(`<li>${inline(ulMatch[1])}</li>`);
+      i++;
+      continue;
+    }
+    const olMatch = line.match(/^\s*\d+\.\s+(.+)$/);
+    if (olMatch) {
+      if (!inList || listTag !== "ol") {
+        if (inList) out.push(`</${listTag}>`);
+        out.push("<ol>");
+        inList = true;
+        listTag = "ol";
+      }
+      out.push(`<li>${inline(olMatch[1])}</li>`);
+      i++;
+      continue;
+    }
+    if (line.trim() === "") {
+      if (inList) {
+        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>");
+  s = s.replace(/\*\*([^*]+)\*\*/g, "<strong>$1</strong>");
+  s = s.replace(/__([^_]+)__/g, "<strong>$1</strong>");
+  s = s.replace(/\*([^*]+)\*/g, "<em>$1</em>");
+  s = s.replace(/_([^_]+)_/g, "<em>$1</em>");
+  return s;
+}
+function layout(opts, body) {
+  const topItems = [
+    { href: "/", label: "Overview" },
+    { href: "/board", label: "Board" },
+    { 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) => {
+    const links = group.types.map((type) => {
+      const href = `/docs/${type}`;
+      return `<a href="${href}" class="${isActive(href)}">${typeLabel(type)}s</a>`;
+    }).join("\n          ");
+    return `
+        <div class="nav-group">
+          <div class="nav-group-label">${escapeHtml(group.label)}</div>
+          ${links}
+        </div>`;
+  }).join("\n");
+  return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>${escapeHtml(opts.title)} \u2014 Marvin</title>
+  <link rel="stylesheet" href="/styles.css">
+</head>
+<body>
+  <div class="shell">
+    <aside class="sidebar">
+      <div class="sidebar-brand">
+        <h1>Marvin</h1>
+        <div class="project-name">${escapeHtml(opts.projectName)}</div>
+      </div>
+      <nav>
+        ${topItems.map((n) => `<a href="${n.href}" class="${isActive(n.href)}">${n.label}</a>`).join("\n        ")}
+        ${groupsHtml}
+      </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>`;
+}
+
+// src/web/templates/styles.ts
+function renderStyles() {
+  return `
+:root {
+  --bg: #0f1117;
+  --bg-card: #1a1d27;
+  --bg-hover: #222632;
+  --border: #2a2e3a;
+  --text: #e1e4ea;
+  --text-dim: #8b8fa4;
+  --accent: #6c8cff;
+  --accent-dim: #4a6ad4;
+  --green: #34d399;
+  --amber: #fbbf24;
+  --red: #f87171;
+  --radius: 8px;
+  --font: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
+  --mono: "SF Mono", "Fira Code", monospace;
+}
+
+* { margin: 0; padding: 0; box-sizing: border-box; }
+
+body {
+  font-family: var(--font);
+  background: var(--bg);
+  color: var(--text);
+  line-height: 1.6;
+  min-height: 100vh;
+}
+
+a { color: var(--accent); text-decoration: none; }
+a:hover { text-decoration: underline; }
+
+/* Layout */
+.shell {
+  display: flex;
+  min-height: 100vh;
+}
+
+.sidebar {
+  width: 220px;
+  background: var(--bg-card);
+  border-right: 1px solid var(--border);
+  padding: 1.5rem 0;
+  position: fixed;
+  top: 0;
+  left: 0;
+  bottom: 0;
+  overflow-y: auto;
+}
+
+.sidebar-brand {
+  padding: 0 1.25rem 1.25rem;
+  border-bottom: 1px solid var(--border);
+  margin-bottom: 1rem;
+}
+
+.sidebar-brand h1 {
+  font-size: 1.1rem;
+  font-weight: 700;
+  color: var(--accent);
+  letter-spacing: -0.02em;
+}
+
+.sidebar-brand .project-name {
+  font-size: 0.75rem;
+  color: var(--text-dim);
+  margin-top: 0.25rem;
+}
+
+.sidebar nav a {
+  display: block;
+  padding: 0.5rem 1.25rem;
+  color: var(--text-dim);
+  font-size: 0.875rem;
+  transition: background 0.15s, color 0.15s;
+}
+
+.sidebar nav a:hover {
+  background: var(--bg-hover);
+  color: var(--text);
+  text-decoration: none;
+}
+
+.sidebar nav a.active {
+  color: var(--accent);
+  background: rgba(108, 140, 255, 0.08);
+  border-right: 2px solid var(--accent);
+}
+
+.nav-group {
+  margin-top: 0.75rem;
+  padding-top: 0.75rem;
+  border-top: 1px solid var(--border);
+}
+
+.nav-group-label {
+  padding: 0.25rem 1.25rem 0.25rem;
+  font-size: 0.65rem;
+  text-transform: uppercase;
+  letter-spacing: 0.08em;
+  color: var(--text-dim);
+  font-weight: 600;
+}
+
+.main {
+  margin-left: 220px;
+  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 {
+  margin-bottom: 2rem;
+}
+
+.page-header h2 {
+  font-size: 1.5rem;
+  font-weight: 600;
+}
+
+.page-header .subtitle {
+  color: var(--text-dim);
+  font-size: 0.875rem;
+  margin-top: 0.25rem;
+}
+
+/* Breadcrumb */
+.breadcrumb {
+  font-size: 0.8rem;
+  color: var(--text-dim);
+  margin-bottom: 1rem;
+}
+
+.breadcrumb a { color: var(--text-dim); }
+.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: 0.5rem;
+}
+
+.card {
+  background: var(--bg-card);
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  padding: 1.25rem;
+  transition: border-color 0.15s;
+}
+
+.card:hover {
+  border-color: var(--accent-dim);
+}
+
+.card a { color: inherit; text-decoration: none; display: block; }
+
+.card .card-label {
+  font-size: 0.75rem;
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+  color: var(--text-dim);
+  margin-bottom: 0.5rem;
+}
+
+.card .card-value {
+  font-size: 1.75rem;
+  font-weight: 700;
+}
+
+.card .card-sub {
+  font-size: 0.8rem;
+  color: var(--text-dim);
+  margin-top: 0.25rem;
+}
+
+/* Status badge */
+.badge {
+  display: inline-block;
+  padding: 0.15rem 0.6rem;
+  border-radius: 999px;
+  font-size: 0.7rem;
+  font-weight: 600;
+  text-transform: uppercase;
+  letter-spacing: 0.03em;
+}
+
+.badge-open { background: rgba(108, 140, 255, 0.15); color: var(--accent); }
+.badge-done { background: rgba(52, 211, 153, 0.15); color: var(--green); }
+.badge-in-progress { background: rgba(251, 191, 36, 0.15); color: var(--amber); }
+.badge-draft { background: rgba(139, 143, 164, 0.15); color: var(--text-dim); }
+.badge-closed, .badge-resolved { background: rgba(52, 211, 153, 0.15); color: var(--green); }
+.badge-blocked { background: rgba(248, 113, 113, 0.15); color: var(--red); }
+.badge-default { background: rgba(139, 143, 164, 0.1); color: var(--text-dim); }
+
+/* Table */
+.table-wrap {
+  overflow-x: auto;
+}
+
+table {
+  width: 100%;
+  border-collapse: collapse;
+}
+
+th {
+  text-align: left;
+  padding: 0.6rem 0.75rem;
+  font-size: 0.7rem;
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+  color: var(--text-dim);
+  border-bottom: 1px solid var(--border);
+}
+
+td {
+  padding: 0.6rem 0.75rem;
+  font-size: 0.875rem;
+  border-bottom: 1px solid var(--border);
+}
+
+tr:hover td {
+  background: var(--bg-hover);
+}
+
+/* GAR */
+.gar-overall {
+  text-align: center;
+  padding: 2rem;
+  margin-bottom: 2rem;
+  border-radius: var(--radius);
+  border: 1px solid var(--border);
+  background: var(--bg-card);
+}
+
+.gar-overall .dot {
+  width: 60px;
+  height: 60px;
+  border-radius: 50%;
+  display: inline-block;
+  margin-bottom: 0.75rem;
+}
+
+.gar-overall .label {
+  font-size: 1.1rem;
+  font-weight: 600;
+  text-transform: uppercase;
+}
+
+.gar-areas {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(260px, 1fr));
+  gap: 1rem;
+}
+
+.gar-area {
+  background: var(--bg-card);
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  padding: 1.25rem;
+}
+
+.gar-area .area-header {
+  display: flex;
+  align-items: center;
+  gap: 0.6rem;
+  margin-bottom: 0.75rem;
+}
+
+.gar-area .area-dot {
+  width: 14px;
+  height: 14px;
+  border-radius: 50%;
+  flex-shrink: 0;
+}
+
+.gar-area .area-name {
+  font-weight: 600;
+  font-size: 1rem;
+}
+
+.gar-area .area-summary {
+  font-size: 0.85rem;
+  color: var(--text-dim);
+  margin-bottom: 0.75rem;
+}
+
+.gar-area ul {
+  list-style: none;
+  font-size: 0.8rem;
+}
+
+.gar-area li {
+  padding: 0.2rem 0;
+  color: var(--text-dim);
+}
+
+.gar-area li .ref-id {
+  color: var(--accent);
+  font-family: var(--mono);
+  margin-right: 0.4rem;
+}
+
+.dot-green { background: var(--green); }
+.dot-amber { background: var(--amber); }
+.dot-red { background: var(--red); }
+
+/* Board / Kanban */
+.board {
+  display: flex;
+  gap: 1rem;
+  overflow-x: auto;
+  padding-bottom: 1rem;
+}
+
+.board-column {
+  min-width: 240px;
+  max-width: 300px;
+  flex: 1;
+}
+
+.board-column-header {
+  font-size: 0.75rem;
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+  color: var(--text-dim);
+  padding: 0.5rem 0.75rem;
+  border-bottom: 2px solid var(--border);
+  margin-bottom: 0.5rem;
+  display: flex;
+  justify-content: space-between;
+}
+
+.board-column-header .count {
+  background: var(--bg-hover);
+  padding: 0 0.5rem;
+  border-radius: 999px;
+  font-size: 0.7rem;
+}
+
+.board-card {
+  background: var(--bg-card);
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  padding: 0.75rem;
+  margin-bottom: 0.5rem;
+  transition: border-color 0.15s;
+}
+
+.board-card:hover {
+  border-color: var(--accent-dim);
+}
+
+.board-card .bc-id {
+  font-family: var(--mono);
+  font-size: 0.7rem;
+  color: var(--accent);
+}
+
+.board-card .bc-title {
+  font-size: 0.85rem;
+  margin: 0.25rem 0;
+}
+
+.board-card .bc-owner {
+  font-size: 0.7rem;
+  color: var(--text-dim);
+}
+
+/* Detail page */
+.detail-meta {
+  background: var(--bg-card);
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  padding: 1.25rem;
+  margin-bottom: 1.5rem;
+}
+
+.detail-meta dl {
+  display: grid;
+  grid-template-columns: 120px 1fr;
+  gap: 0.4rem 1rem;
+}
+
+.detail-meta dt {
+  font-size: 0.75rem;
+  text-transform: uppercase;
+  letter-spacing: 0.05em;
+  color: var(--text-dim);
+}
+
+.detail-meta dd {
+  font-size: 0.875rem;
+}
+
+.detail-content {
+  background: var(--bg-card);
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  padding: 1.5rem;
+  line-height: 1.7;
+}
+
+.detail-content h1, .detail-content h2, .detail-content h3 {
+  margin: 1.25rem 0 0.5rem;
+  font-weight: 600;
+}
+
+.detail-content h1 { font-size: 1.3rem; }
+.detail-content h2 { font-size: 1.15rem; }
+.detail-content h3 { font-size: 1rem; }
+.detail-content p { margin-bottom: 0.75rem; }
+.detail-content ul, .detail-content ol { margin: 0.5rem 0 0.75rem 1.5rem; }
+.detail-content li { margin-bottom: 0.25rem; }
+.detail-content code {
+  background: var(--bg-hover);
+  padding: 0.1rem 0.35rem;
+  border-radius: 3px;
+  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 {
+  display: flex;
+  gap: 0.75rem;
+  margin-bottom: 1.5rem;
+  flex-wrap: wrap;
+}
+
+.filters select {
+  background: var(--bg-card);
+  border: 1px solid var(--border);
+  color: var(--text);
+  padding: 0.4rem 0.75rem;
+  border-radius: var(--radius);
+  font-size: 0.8rem;
+  cursor: pointer;
+}
+
+.filters select:focus {
+  outline: none;
+  border-color: var(--accent);
+}
+
+/* Empty state */
+.empty {
+  text-align: center;
+  padding: 3rem;
+  color: var(--text-dim);
+}
+
+.empty p { font-size: 0.9rem; }
+
+/* Section heading */
+.section-title {
+  font-size: 0.9rem;
+  font-weight: 600;
+  margin: 1.5rem 0 0.75rem;
+}
+
+/* Priority */
+.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 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>`;
+}
+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>
+          <td><a href="/docs/${doc.frontmatter.type}/${doc.frontmatter.id}">${escapeHtml(doc.frontmatter.id)}</a></td>
+          <td>${escapeHtml(doc.frontmatter.title)}</td>
+          <td>${escapeHtml(typeLabel(doc.frontmatter.type))}</td>
+          <td>${statusBadge(doc.frontmatter.status)}</td>
+          <td>${formatDate(doc.frontmatter.updated ?? doc.frontmatter.created)}</td>
+        </tr>`
+  ).join("\n");
+  return `
+    <div class="page-header">
+      <h2>Project Overview</h2>
+    </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 ? `
+    <div class="table-wrap">
+      <table>
+        <thead>
+          <tr>
+            <th>ID</th>
+            <th>Title</th>
+            <th>Type</th>
+            <th>Status</th>
+            <th>Updated</th>
+          </tr>
+        </thead>
+        <tbody>
+          ${rows}
+        </tbody>
+      </table>
+    </div>` : `<div class="empty"><p>No documents yet.</p></div>`}
+  `;
+}
+
+// src/web/templates/pages/documents.ts
+function documentsPage(data) {
+  const label = typeLabel(data.type);
+  const statusOptions = data.statuses.map(
+    (s) => `<option value="${escapeHtml(s)}"${data.filterStatus === s ? " selected" : ""}>${escapeHtml(s)}</option>`
+  ).join("");
+  const ownerOptions = data.owners.map(
+    (o) => `<option value="${escapeHtml(o)}"${data.filterOwner === o ? " selected" : ""}>${escapeHtml(o)}</option>`
+  ).join("");
+  const rows = data.docs.map(
+    (doc) => `
+        <tr>
+          <td><a href="/docs/${data.type}/${doc.frontmatter.id}">${escapeHtml(doc.frontmatter.id)}</a></td>
+          <td><a href="/docs/${data.type}/${doc.frontmatter.id}">${escapeHtml(doc.frontmatter.title)}</a></td>
+          <td>${statusBadge(doc.frontmatter.status)}</td>
+          <td>${escapeHtml(doc.frontmatter.owner ?? "\u2014")}</td>
+          <td>${doc.frontmatter.priority ? `<span class="priority-${doc.frontmatter.priority.toLowerCase()}">${escapeHtml(doc.frontmatter.priority)}</span>` : "\u2014"}</td>
+          <td>${formatDate(doc.frontmatter.updated ?? doc.frontmatter.created)}</td>
+        </tr>`
+  ).join("\n");
+  return `
+    <div class="page-header">
+      <h2>${escapeHtml(label)}s</h2>
+      <div class="subtitle">${data.docs.length} document${data.docs.length !== 1 ? "s" : ""}</div>
+    </div>
+
+    <div class="filters">
+      <select onchange="filterByStatus(this.value)">
+        <option value="">All statuses</option>
+        ${statusOptions}
+      </select>
+      <select onchange="filterByOwner(this.value)">
+        <option value="">All owners</option>
+        ${ownerOptions}
+      </select>
+    </div>
+
+    ${data.docs.length > 0 ? `
+    <div class="table-wrap">
+      <table>
+        <thead>
+          <tr>
+            <th>ID</th>
+            <th>Title</th>
+            <th>Status</th>
+            <th>Owner</th>
+            <th>Priority</th>
+            <th>Updated</th>
+          </tr>
+        </thead>
+        <tbody>
+          ${rows}
+        </tbody>
+      </table>
+    </div>` : `<div class="empty"><p>No ${label.toLowerCase()}s found.</p></div>`}
+
+    <script>
+      function filterByStatus(status) {
+        const url = new URL(window.location);
+        if (status) url.searchParams.set('status', status);
+        else url.searchParams.delete('status');
+        window.location = url;
+      }
+      function filterByOwner(owner) {
+        const url = new URL(window.location);
+        if (owner) url.searchParams.set('owner', owner);
+        else url.searchParams.delete('owner');
+        window.location = url;
+      }
+    </script>
+  `;
+}
+
+// src/web/templates/pages/document-detail.ts
+function documentDetailPage(doc) {
+  const fm = doc.frontmatter;
+  const label = typeLabel(fm.type);
+  const skipKeys = /* @__PURE__ */ new Set(["title", "type"]);
+  const entries = Object.entries(fm).filter(
+    ([key]) => !skipKeys.has(key) && fm[key] != null
+  );
+  const dtDd = entries.map(([key, value]) => {
+    let rendered;
+    if (key === "status") {
+      rendered = statusBadge(value);
+    } else if (key === "tags" && Array.isArray(value)) {
+      rendered = value.map((t) => `<span class="badge badge-default">${escapeHtml(t)}</span>`).join(" ");
+    } else if (key === "created" || key === "updated") {
+      rendered = formatDate(value);
+    } else {
+      rendered = escapeHtml(String(value));
+    }
+    return `<dt>${escapeHtml(key)}</dt><dd>${rendered}</dd>`;
+  }).join("\n        ");
+  return `
+    <div class="breadcrumb">
+      <a href="/">Overview</a><span class="sep">/</span>
+      <a href="/docs/${fm.type}">${escapeHtml(label)}s</a><span class="sep">/</span>
+      ${escapeHtml(fm.id)}
+    </div>
+
+    <div class="page-header">
+      <h2>${escapeHtml(fm.title)}</h2>
+      <div class="subtitle">${escapeHtml(fm.id)} &middot; ${escapeHtml(label)}</div>
+    </div>
+
+    <div class="detail-meta">
+      <dl>
+        ${dtDd}
+      </dl>
+    </div>
+
+    ${doc.content.trim() ? `<div class="detail-content">${renderMarkdown(doc.content)}</div>` : ""}
+  `;
+}
+
+// src/web/templates/pages/gar.ts
+function garPage(report) {
+  const dotClass = `dot-${report.overall}`;
+  const areaCards = report.areas.map(
+    (area) => `
+      <div class="gar-area">
+        <div class="area-header">
+          <div class="area-dot dot-${area.status}"></div>
+          <div class="area-name">${escapeHtml(area.name)}</div>
+        </div>
+        <div class="area-summary">${escapeHtml(area.summary)}</div>
+        ${area.items.length > 0 ? `<ul>${area.items.map((item) => `<li><span class="ref-id">${escapeHtml(item.id)}</span>${escapeHtml(item.title)}</li>`).join("")}</ul>` : ""}
+      </div>`
+  ).join("\n");
+  return `
+    <div class="page-header">
+      <h2>GAR Report</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>
+
+    <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
+    )
+  }) : ""}
+  `;
+}
+
+// src/web/templates/pages/board.ts
+function boardPage(data) {
+  const typeOptions = data.types.map(
+    (t) => `<option value="${escapeHtml(t)}"${data.type === t ? " selected" : ""}>${escapeHtml(typeLabel(t))}s</option>`
+  ).join("");
+  const columns = data.columns.map(
+    (col) => `
+      <div class="board-column">
+        <div class="board-column-header">
+          <span>${escapeHtml(col.status)}</span>
+          <span class="count">${col.docs.length}</span>
+        </div>
+        ${col.docs.map(
+      (doc) => `
+          <div class="board-card">
+            <a href="/docs/${doc.frontmatter.type}/${doc.frontmatter.id}">
+              <div class="bc-id">${escapeHtml(doc.frontmatter.id)}</div>
+              <div class="bc-title">${escapeHtml(doc.frontmatter.title)}</div>
+              ${doc.frontmatter.owner ? `<div class="bc-owner">${escapeHtml(doc.frontmatter.owner)}</div>` : ""}
+            </a>
+          </div>`
+    ).join("\n")}
+      </div>`
+  ).join("\n");
+  return `
+    <div class="page-header">
+      <h2>Status Board</h2>
+    </div>
+
+    <div class="filters">
+      <select onchange="filterByType(this.value)">
+        <option value="">All types</option>
+        ${typeOptions}
+      </select>
+    </div>
+
+    ${data.columns.length > 0 ? `<div class="board">${columns}</div>` : `<div class="empty"><p>No documents to display.</p></div>`}
+
+    <script>
+      function filterByType(type) {
+        if (type) window.location = '/board/' + type;
+        else window.location = '/board';
+      }
+    </script>
+  `;
+}
+
+// src/web/router.ts
+function handleRequest(req, res, store, projectName, navGroups) {
+  const parsed = new URL(req.url ?? "/", `http://${req.headers.host ?? "localhost"}`);
+  const pathname = parsed.pathname;
+  const navTypes = store.registeredTypes;
+  try {
+    if (pathname === "/styles.css") {
+      res.writeHead(200, {
+        "Content-Type": "text/css",
+        "Cache-Control": "public, max-age=300"
+      });
+      res.end(renderStyles());
+      return;
+    }
+    if (pathname === "/") {
+      const data = getOverviewData(store);
+      const diagrams = getDiagramData(store);
+      const body = overviewPage(data, diagrams, navGroups);
+      respond(res, layout({ title: "Overview", activePath: "/", projectName, navGroups }, body));
+      return;
+    }
+    if (pathname === "/gar") {
+      const report = getGarData(store, projectName);
+      const body = garPage(report);
+      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];
+      if (type && !navTypes.includes(type)) {
+        notFound(res, projectName, navGroups, pathname);
+        return;
+      }
+      const data = getBoardData(store, type);
+      const body = boardPage(data);
+      respond(res, layout({ title: "Board", activePath: "/board", projectName, navGroups }, body));
+      return;
+    }
+    const detailMatch = pathname.match(/^\/docs\/([^/]+)\/([^/]+)$/);
+    if (detailMatch) {
+      const [, type, id] = detailMatch;
+      const doc = getDocumentDetail(store, type, id);
+      if (!doc) {
+        notFound(res, projectName, navGroups, pathname);
+        return;
+      }
+      const body = documentDetailPage(doc);
+      respond(res, layout({ title: `${id} \u2014 ${doc.frontmatter.title}`, activePath: `/docs/${type}`, projectName, navGroups }, body));
+      return;
+    }
+    const listMatch = pathname.match(/^\/docs\/([^/]+)$/);
+    if (listMatch) {
+      const type = listMatch[1];
+      const filterStatus = parsed.searchParams.get("status") ?? void 0;
+      const filterOwner = parsed.searchParams.get("owner") ?? void 0;
+      const data = getDocumentListData(store, type, filterStatus, filterOwner);
+      if (!data) {
+        notFound(res, projectName, navGroups, pathname);
+        return;
+      }
+      const body = documentsPage(data);
+      respond(res, layout({ title: `${type}`, activePath: `/docs/${type}`, projectName, navGroups }, body));
+      return;
+    }
+    notFound(res, projectName, navGroups, pathname);
+  } catch (err) {
+    console.error("[marvin web] Error handling request:", err);
+    res.writeHead(500, { "Content-Type": "text/html" });
+    res.end("<h1>500 \u2014 Internal Server Error</h1>");
+  }
+}
+function respond(res, html) {
+  res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
+  res.end(html);
+}
+function notFound(res, projectName, navGroups, activePath) {
+  const body = `<div class="empty"><h2>404</h2><p>Page not found.</p><p><a href="/">Go to overview</a></p></div>`;
+  res.writeHead(404, { "Content-Type": "text/html; charset=utf-8" });
+  res.end(layout({ title: "Not Found", activePath, projectName, navGroups }, body));
+}
+
+// src/web/server.ts
+import * as http from "http";
+import { exec } from "child_process";
+function openBrowser(url2) {
+  const platform = process.platform;
+  const cmd = platform === "darwin" ? `open "${url2}"` : platform === "win32" ? `start "${url2}"` : `xdg-open "${url2}"`;
+  exec(cmd, (err) => {
+    if (err) {
+    }
+  });
+}
+
+// src/agent/tools/web.ts
+var runningServer = null;
+function createWebTools(store, projectName, navGroups) {
+  return [
+    tool20(
+      "start_web_dashboard",
+      "Start the Marvin web dashboard on a local port. Returns the base URL. If already running, returns the existing URL.",
+      {
+        port: external_exports.number().optional().describe("Port to listen on (default: 3000)"),
+        open: external_exports.boolean().optional().describe("Open the dashboard in the default browser (default: true)")
+      },
+      async (args) => {
+        const port = args.port ?? 3e3;
+        if (runningServer) {
+          const url3 = `http://localhost:${runningServer.port}`;
+          return {
+            content: [{ type: "text", text: `Dashboard already running at ${url3}` }]
+          };
+        }
+        const server = http2.createServer((req, res) => {
+          handleRequest(req, res, store, projectName, navGroups);
+        });
+        await new Promise((resolve3, reject) => {
+          server.on("error", reject);
+          server.listen(port, () => resolve3());
+        });
+        runningServer = { server, port };
+        const url2 = `http://localhost:${port}`;
+        if (args.open !== false) {
+          openBrowser(url2);
+        }
+        return {
+          content: [{ type: "text", text: `Dashboard started at ${url2}` }]
+        };
+      }
+    ),
+    tool20(
+      "stop_web_dashboard",
+      "Stop the running Marvin web dashboard.",
+      {},
+      async () => {
+        if (!runningServer) {
+          return {
+            content: [{ type: "text", text: "No dashboard is currently running." }],
+            isError: true
+          };
+        }
+        await new Promise((resolve3) => {
+          runningServer.server.close(() => resolve3());
+        });
+        runningServer = null;
+        return {
+          content: [{ type: "text", text: "Dashboard stopped." }]
+        };
+      }
+    ),
+    tool20(
+      "get_web_dashboard_urls",
+      "Get all available dashboard page URLs. The dashboard must be running.",
+      {},
+      async () => {
+        if (!runningServer) {
+          return {
+            content: [{ type: "text", text: "Dashboard is not running. Use start_web_dashboard first." }],
+            isError: true
+          };
+        }
+        const base = `http://localhost:${runningServer.port}`;
+        const urls = {
+          overview: base,
+          gar: `${base}/gar`,
+          board: `${base}/board`
+        };
+        for (const type of store.registeredTypes) {
+          urls[type] = `${base}/docs/${type}`;
+        }
+        return {
+          content: [{ type: "text", text: JSON.stringify(urls, null, 2) }]
+        };
+      },
+      { annotations: { readOnlyHint: true } }
+    ),
+    tool20(
+      "get_dashboard_overview",
+      "Get the project overview data: document type counts and recent activity. Works without the web server running.",
+      {},
+      async () => {
+        const data = getOverviewData(store);
+        const result = {
+          types: data.types,
+          recent: data.recent.map((d) => ({
+            id: d.frontmatter.id,
+            type: d.frontmatter.type,
+            title: d.frontmatter.title,
+            status: d.frontmatter.status,
+            updated: d.frontmatter.updated ?? d.frontmatter.created
+          }))
+        };
+        return {
+          content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+        };
+      },
+      { annotations: { readOnlyHint: true } }
+    ),
+    tool20(
+      "get_dashboard_gar",
+      "Get the GAR (Governance, Actions, Risks) report as JSON. Works without the web server running.",
+      {},
+      async () => {
+        const report = getGarData(store, projectName);
+        return {
+          content: [{ type: "text", text: JSON.stringify(report, null, 2) }]
+        };
+      },
+      { annotations: { readOnlyHint: true } }
+    ),
+    tool20(
+      "get_dashboard_board",
+      "Get board data showing documents grouped by status. Optionally filter by document type. Works without the web server running.",
+      {
+        type: external_exports.string().optional().describe("Document type to filter by (e.g. 'decision', 'action')")
+      },
+      async (args) => {
+        const data = getBoardData(store, args.type);
+        const result = {
+          type: data.type ?? "all",
+          types: data.types,
+          columns: data.columns.map((col) => ({
+            status: col.status,
+            count: col.docs.length,
+            docs: col.docs.map((d) => ({
+              id: d.frontmatter.id,
+              type: d.frontmatter.type,
+              title: d.frontmatter.title,
+              owner: d.frontmatter.owner
+            }))
+          }))
+        };
+        return {
+          content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+        };
+      },
+      { annotations: { readOnlyHint: true } }
+    )
+  ];
+}
+
+// src/agent/mcp-server.ts
 function createMarvinMcpServer(store, options) {
   const tools = [
     ...createDecisionTools(store),
@@ -17952,7 +19868,8 @@ function createMarvinMcpServer(store, options) {
     ...options?.manifest ? createSourceTools(options.manifest) : [],
     ...options?.sessionStore ? createSessionTools(options.sessionStore) : [],
     ...options?.pluginTools ?? [],
-    ...options?.skillTools ?? []
+    ...options?.skillTools ?? [],
+    ...options?.projectName && options?.navGroups ? createWebTools(store, options.projectName, options.navGroups) : []
   ];
   return createSdkMcpServer({
     name: "marvin-governance",
@@ -18024,7 +19941,7 @@ function createSkillActionTools(skills, context) {
     if (!skill.actions) continue;
     for (const action of skill.actions) {
       tools.push(
-        tool20(
+        tool21(
           `${skill.id}__${action.id}`,
           action.description,
           {
@@ -18094,6 +20011,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
@@ -18251,10 +20170,10 @@ ${lines.join("\n\n")}`;
 }
 
 // src/mcp/persona-tools.ts
-import { tool as tool21 } from "@anthropic-ai/claude-agent-sdk";
+import { tool as tool22 } from "@anthropic-ai/claude-agent-sdk";
 function createPersonaTools(ctx, marvinDir) {
   return [
-    tool21(
+    tool22(
       "set_persona",
       "Set the active persona for this session. Returns full guidance for the selected persona including behavioral rules, allowed document types, and scope. Call this before working to ensure persona-appropriate behavior.",
       {
@@ -18284,7 +20203,7 @@ ${summaries}`
         };
       }
     ),
-    tool21(
+    tool22(
       "get_persona_guidance",
       "Get guidance for a persona without changing the active persona. If no persona is specified, lists all available personas with summaries.",
       {
@@ -18319,7 +20238,7 @@ ${summaries}`
           content: [{ type: "text", text: guidance }]
         };
       },
-      { annotations: { readOnly: true } }
+      { annotations: { readOnlyHint: true } }
     )
   ];
 }