mrvn-cli 0.2.9 → 0.3.0

package/dist/index.js

@@ -213,6 +213,11 @@ var DocumentStore = class {
         const raw = fs3.readFileSync(filePath, "utf-8");
         const doc = parseDocument(raw, filePath);
         if (doc.frontmatter.id) {
+          if (this.index.has(doc.frontmatter.id)) {
+            console.warn(
+              `[marvin] Duplicate ID "${doc.frontmatter.id}" in ${file2} \u2014 conflicts with existing entry. Run ID repair to fix.`
+            );
+          }
           this.index.set(doc.frontmatter.id, doc.frontmatter);
         }
       }
@@ -333,14 +338,22 @@ var DocumentStore = class {
     if (!prefix) {
       throw new Error(`Unknown document type: ${type}`);
     }
-    const pattern = new RegExp(`^${prefix}-(\\d+)$`);
+    const dirName = this.typeDirs[type];
+    const dir = path3.join(this.docsDir, dirName);
+    if (!fs3.existsSync(dir)) return `${prefix}-001`;
+    const idPattern = new RegExp(`^${prefix}-(\\d+)$`);
+    const files = fs3.readdirSync(dir).filter((f) => f.endsWith(".md"));
     let maxNum = 0;
-    for (const id of this.index.keys()) {
-      const match = id.match(pattern);
+    for (const file2 of files) {
+      const filePath = path3.join(dir, file2);
+      const raw = fs3.readFileSync(filePath, "utf-8");
+      const doc = parseDocument(raw, filePath);
+      const match = doc.frontmatter.id?.match(idPattern);
       if (match) {
         maxNum = Math.max(maxNum, parseInt(match[1], 10));
       }
     }
+    maxNum = Math.max(maxNum, files.length);
     return `${prefix}-${String(maxNum + 1).padStart(3, "0")}`;
   }
   counts() {
@@ -6599,13 +6612,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";
@@ -6655,7 +6668,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)) {
@@ -20364,8 +20377,8 @@ function executeImportPlan(plan, store, marvinDir, options) {
 }
 function formatPlanSummary(plan) {
   const lines = [];
-  const typeLabel = classificationLabel(plan.classification.type);
-  lines.push(`Detected: ${typeLabel}`);
+  const typeLabel2 = classificationLabel(plan.classification.type);
+  lines.push(`Detected: ${typeLabel2}`);
   lines.push(`Source:   ${plan.classification.inputPath}`);
   lines.push("");
   const imports = plan.items.filter((i) => i.action === "import");
@@ -21398,12 +21411,1048 @@ async function garReportCommand(options) {
   }
 }
 
+// src/web/server.ts
+import * as http from "http";
+import { exec } from "child_process";
+
+// 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 navItems = [
+    { href: "/", label: "Overview" },
+    { href: "/board", label: "Board" },
+    { href: "/gar", label: "GAR Report" }
+  ];
+  const typeNavItems = opts.navTypes.map((type) => ({
+    href: `/docs/${type}`,
+    label: typeLabel(type) + "s"
+  }));
+  const isActive = (href) => opts.activePath === href || href !== "/" && opts.activePath.startsWith(href) ? " active" : "";
+  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>
+        ${navItems.map((n) => `<a href="${n.href}" class="${isActive(n.href)}">${n.label}</a>`).join("\n        ")}
+        ${typeNavItems.map((n) => `<a href="${n.href}" class="${isActive(n.href)}">${n.label}</a>`).join("\n        ")}
+      </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);
+}
+
+.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) {
+  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, navTypes }, body));
+      return;
+    }
+    if (pathname === "/gar") {
+      const report = getGarData(store, projectName);
+      const body = garPage(report);
+      respond(res, layout({ title: "GAR Report", activePath: "/gar", projectName, navTypes }, body));
+      return;
+    }
+    const boardMatch = pathname.match(/^\/board(?:\/([^/]+))?$/);
+    if (boardMatch) {
+      const type = boardMatch[1];
+      if (type && !navTypes.includes(type)) {
+        notFound(res, projectName, navTypes, pathname);
+        return;
+      }
+      const data = getBoardData(store, type);
+      const body = boardPage(data);
+      respond(res, layout({ title: "Board", activePath: "/board", projectName, navTypes }, body));
+      return;
+    }
+    const detailMatch = pathname.match(/^\/docs\/([^/]+)\/([^/]+)$/);
+    if (detailMatch) {
+      const [, type, id] = detailMatch;
+      const doc = getDocumentDetail(store, type, id);
+      if (!doc) {
+        notFound(res, projectName, navTypes, pathname);
+        return;
+      }
+      const body = documentDetailPage(doc);
+      respond(res, layout({ title: `${id} \u2014 ${doc.frontmatter.title}`, activePath: `/docs/${type}`, projectName, navTypes }, 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, navTypes, pathname);
+        return;
+      }
+      const body = documentsPage(data);
+      respond(res, layout({ title: `${type}`, activePath: `/docs/${type}`, projectName, navTypes }, body));
+      return;
+    }
+    notFound(res, projectName, navTypes, 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, navTypes, 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, navTypes }, body));
+}
+
+// src/web/server.ts
+async function startWebServer(opts) {
+  const project = loadProject();
+  const plugin = resolvePlugin(project.config.methodology);
+  const pluginRegs = plugin?.documentTypeRegistrations ?? [];
+  const allSkills = loadAllSkills(project.marvinDir);
+  const allSkillIds = [...allSkills.keys()];
+  const skillRegs = collectSkillRegistrations(allSkillIds, allSkills);
+  const store = new DocumentStore(project.marvinDir, [
+    ...pluginRegs,
+    ...skillRegs
+  ]);
+  const projectName = project.config.name;
+  const server = http.createServer((req, res) => {
+    handleRequest(req, res, store, projectName);
+  });
+  server.listen(opts.port, () => {
+    const url2 = `http://localhost:${opts.port}`;
+    console.log(`
+  Marvin dashboard running at ${url2}
+`);
+    console.log("  Press Ctrl+C to stop.\n");
+    if (opts.open) {
+      openBrowser(url2);
+    }
+  });
+  const shutdown = () => {
+    console.log("\n  Shutting down...\n");
+    server.close(() => process.exit(0));
+    setTimeout(() => process.exit(0), 2e3);
+  };
+  process.on("SIGINT", shutdown);
+  process.on("SIGTERM", shutdown);
+}
+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/cli/commands/web.ts
+async function webCommand(options) {
+  const port = options.port ? parseInt(options.port, 10) : 3e3;
+  if (isNaN(port) || port < 1 || port > 65535) {
+    console.error("Error: invalid port number");
+    process.exit(1);
+  }
+  await startWebServer({ port, open: options.open });
+}
+
 // src/cli/program.ts
 function createProgram() {
   const program = new Command();
   program.name("marvin").description(
     "AI-powered product development assistant with Product Owner, Delivery Manager, and Technical Lead personas"
-  ).version("0.2.9");
+  ).version("0.2.10");
   program.command("init").description("Initialize a new Marvin project in the current directory").action(async () => {
     await initCommand();
   });
@@ -21480,6 +22529,9 @@ function createProgram() {
   ).action(async (options) => {
     await garReportCommand(options);
   });
+  program.command("web").description("Launch a local web dashboard for project data").option("-p, --port <port>", "Port to listen on (default: 3000)").option("--no-open", "Don't auto-open the browser").action(async (options) => {
+    await webCommand(options);
+  });
   return program;
 }
 export {