mrvn-cli 0.3.2 → 0.3.3

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)) {
@@ -17934,7 +17934,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 +17943,1172 @@ 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 };
+}
+
+// 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";
+  for (const raw of lines) {
+    const line = raw;
+    if (inList && !/^\s*[-*]\s/.test(line) && !/^\s*\d+\.\s/.test(line) && line.trim() !== "") {
+      out.push(`</${listTag}>`);
+      inList = false;
+    }
+    const headingMatch = line.match(/^(#{1,3})\s+(.+)$/);
+    if (headingMatch) {
+      const level = headingMatch[1].length;
+      out.push(`<h${level}>${inline(headingMatch[2])}</h${level}>`);
+      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>`);
+      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>`);
+      continue;
+    }
+    if (line.trim() === "") {
+      if (inList) {
+        out.push(`</${listTag}>`);
+        inList = false;
+      }
+      continue;
+    }
+    out.push(`<p>${inline(line)}</p>`);
+  }
+  if (inList) out.push(`</${listTag}>`);
+  return out.join("\n");
+}
+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" }
+  ];
+  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">
+      ${body}
+    </main>
+  </div>
+</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;
+}
+
+/* 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; }
+
+/* Cards grid */
+.cards {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(200px, 1fr));
+  gap: 1rem;
+  margin-bottom: 2rem;
+}
+
+.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;
+}
+
+/* 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); }
+`;
+}
+
+// src/web/templates/pages/overview.ts
+function overviewPage(data) {
+  const cards = data.types.map(
+    (t) => `
+      <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");
+  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>
+
+    <div class="cards">
+      ${cards}
+    </div>
+
+    <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>
+  `;
+}
+
+// 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 body = overviewPage(data);
+      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;
+    }
+    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: { readOnly: 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: { readOnly: 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: { readOnly: 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: { readOnly: true } }
+    )
+  ];
+}
+
+// src/agent/mcp-server.ts
 function createMarvinMcpServer(store, options) {
   const tools = [
     ...createDecisionTools(store),
@@ -17952,7 +19118,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 +19191,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,
           {
@@ -18251,10 +19418,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 +19451,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.",
       {