mrvn-cli 0.5.25 → 0.5.26

package/dist/marvin-serve.js

@@ -16218,6 +16218,221 @@ function getUpcomingData(store) {
 function getSprintSummaryData(store, sprintId) {
   return collectSprintSummaryData(store, sprintId);
 }
+var SIBLING_CAP = 8;
+var ARTIFACT_ID_PATTERN = /\b([A-Z]{1,3}-\d{3,})\b/g;
+function getArtifactRelationships(store, docId) {
+  const doc = store.get(docId);
+  if (!doc) return null;
+  const fm = doc.frontmatter;
+  const allDocs = store.list();
+  const docIndex = new Map(allDocs.map((d) => [d.frontmatter.id, d]));
+  const origins = [];
+  const parents = [];
+  const children = [];
+  const external = [];
+  const edges = [];
+  const seen = /* @__PURE__ */ new Set([docId]);
+  const addIfExists = (id, relationship, bucket) => {
+    if (seen.has(id)) return false;
+    const target = docIndex.get(id);
+    if (!target) return false;
+    seen.add(id);
+    bucket.push({
+      id: target.frontmatter.id,
+      title: target.frontmatter.title,
+      type: target.frontmatter.type,
+      status: target.frontmatter.status,
+      relationship
+    });
+    return true;
+  };
+  const parentId = fm.aboutArtifact;
+  if (parentId && addIfExists(parentId, "parent", parents)) {
+    edges.push({ from: parentId, to: docId });
+  }
+  const linkedEpics = normalizeLinkedEpics(fm.linkedEpic);
+  for (const epicId of linkedEpics) {
+    if (addIfExists(epicId, "epic", parents)) {
+      edges.push({ from: epicId, to: docId });
+    }
+    const epicDoc = docIndex.get(epicId);
+    if (epicDoc) {
+      const features = normalizeLinkedFeatures(epicDoc.frontmatter.linkedFeature);
+      for (const fid of features) {
+        if (addIfExists(fid, "feature", parents)) {
+          edges.push({ from: fid, to: epicId });
+        }
+      }
+    }
+  }
+  const tags = fm.tags ?? [];
+  for (const tag of tags) {
+    if (tag.startsWith("sprint:")) {
+      const sprintId = tag.slice(7);
+      if (addIfExists(sprintId, "sprint", parents)) {
+        edges.push({ from: sprintId, to: docId });
+      }
+    }
+  }
+  for (const tag of tags) {
+    if (tag.startsWith("source:")) {
+      const sourceId = tag.slice(7);
+      if (addIfExists(sourceId, "source", origins)) {
+        edges.push({ from: sourceId, to: docId });
+      }
+    }
+  }
+  const sourceField = fm.source;
+  if (sourceField && /^[A-Z]{1,3}-\d{3,}$/.test(sourceField)) {
+    if (addIfExists(sourceField, "source", origins)) {
+      edges.push({ from: sourceField, to: docId });
+    }
+  }
+  for (const d of allDocs) {
+    if (d.frontmatter.aboutArtifact === docId) {
+      if (addIfExists(d.frontmatter.id, "child", children)) {
+        edges.push({ from: docId, to: d.frontmatter.id });
+      }
+    }
+  }
+  if (fm.type === "epic") {
+    const epicTag = `epic:${docId}`;
+    for (const d of allDocs) {
+      const dfm = d.frontmatter;
+      const dLinkedEpics = normalizeLinkedEpics(dfm.linkedEpic);
+      const dTags = dfm.tags ?? [];
+      if (dLinkedEpics.includes(docId) || dTags.includes(epicTag)) {
+        if (addIfExists(dfm.id, "child", children)) {
+          edges.push({ from: docId, to: dfm.id });
+        }
+      }
+    }
+  }
+  if (parentId) {
+    let siblingCount = 0;
+    for (const d of allDocs) {
+      if (siblingCount >= SIBLING_CAP) break;
+      if (d.frontmatter.aboutArtifact === parentId && d.frontmatter.id !== docId) {
+        if (addIfExists(d.frontmatter.id, "sibling", children)) {
+          edges.push({ from: parentId, to: d.frontmatter.id });
+          siblingCount++;
+        }
+      }
+    }
+  }
+  const jiraKey = fm.jiraKey;
+  const jiraUrl = fm.jiraUrl;
+  if (jiraKey) {
+    external.push({
+      id: jiraKey,
+      title: jiraUrl ?? `Jira: ${jiraKey}`,
+      type: "jira",
+      status: "",
+      relationship: "jira"
+    });
+    edges.push({ from: docId, to: jiraKey });
+  }
+  if (doc.content) {
+    const matches = doc.content.matchAll(ARTIFACT_ID_PATTERN);
+    for (const m of matches) {
+      const refId = m[1];
+      if (refId !== docId && docIndex.has(refId)) {
+        if (addIfExists(refId, "mentioned", external)) {
+          edges.push({ from: docId, to: refId });
+        }
+      }
+    }
+  }
+  return {
+    origins,
+    parents,
+    self: {
+      id: fm.id,
+      title: fm.title,
+      type: fm.type,
+      status: fm.status,
+      relationship: "self"
+    },
+    children,
+    external,
+    edges
+  };
+}
+function getArtifactLineageEvents(store, docId) {
+  const doc = store.get(docId);
+  if (!doc) return [];
+  const fm = doc.frontmatter;
+  const events = [];
+  if (fm.created) {
+    events.push({
+      date: fm.created,
+      type: "created",
+      label: `${fm.id} created`
+    });
+  }
+  const tags = fm.tags ?? [];
+  for (const tag of tags) {
+    if (tag.startsWith("source:")) {
+      const sourceId = tag.slice(7);
+      const sourceDoc = store.get(sourceId);
+      if (sourceDoc) {
+        events.push({
+          date: sourceDoc.frontmatter.created,
+          type: "source-linked",
+          label: `Originated from ${sourceId} \u2014 ${sourceDoc.frontmatter.title}`,
+          relatedId: sourceId
+        });
+      }
+    }
+  }
+  const allDocs = store.list();
+  for (const d of allDocs) {
+    if (d.frontmatter.aboutArtifact === docId) {
+      events.push({
+        date: d.frontmatter.created,
+        type: "child-spawned",
+        label: `Spawned ${d.frontmatter.type} ${d.frontmatter.id} \u2014 ${d.frontmatter.title}`,
+        relatedId: d.frontmatter.id
+      });
+    }
+  }
+  if (fm.type === "epic") {
+    const epicTag = `epic:${docId}`;
+    for (const d of allDocs) {
+      if (d.frontmatter.aboutArtifact === docId) continue;
+      const dLinkedEpics = normalizeLinkedEpics(d.frontmatter.linkedEpic);
+      const dTags = d.frontmatter.tags ?? [];
+      if (dLinkedEpics.includes(docId) || dTags.includes(epicTag)) {
+        events.push({
+          date: d.frontmatter.created,
+          type: "child-spawned",
+          label: `Linked ${d.frontmatter.type} ${d.frontmatter.id} \u2014 ${d.frontmatter.title}`,
+          relatedId: d.frontmatter.id
+        });
+      }
+    }
+  }
+  const history = fm.assessmentHistory ?? [];
+  for (const entry of history) {
+    if (entry.generatedAt) {
+      events.push({
+        date: entry.generatedAt,
+        type: "assessment",
+        label: "Assessment performed"
+      });
+    }
+  }
+  const lastSync = fm.lastJiraSyncAt;
+  if (lastSync) {
+    events.push({
+      date: lastSync,
+      type: "jira-sync",
+      label: `Synced with Jira ${fm.jiraKey ?? ""}`
+    });
+  }
+  events.sort((a, b) => (b.date ?? "").localeCompare(a.date ?? ""));
+  return events;
+}
 
 // src/reports/gar/collector.ts
 var DONE_STATUSES4 = /* @__PURE__ */ new Set(["done", "closed", "resolved", "cancelled"]);
@@ -24037,6 +24252,65 @@ a.artifact-link:hover {
 .flow-line-lit { stroke: var(--accent) !important; stroke-width: 2 !important; }
 .flow-line-dim { opacity: 0.08; }
 
+/* Relationship graph: self-node emphasis */
+.flow-self {
+  border-left-width: 4px;
+  background: var(--bg-hover);
+  box-shadow: 0 0 0 1px var(--accent-dim);
+}
+.flow-self .flow-node-id {
+  color: var(--accent);
+  font-weight: 600;
+}
+
+/* Relationship graph: external nodes */
+.flow-external {
+  border-left-color: var(--text-dim);
+  border-left-style: dashed;
+}
+
+/* Relationship graph: empty state */
+.flow-empty {
+  padding: 2rem;
+  text-align: center;
+  color: var(--text-dim);
+  font-size: 0.85rem;
+}
+
+/* Lineage timeline */
+.lineage-timeline {
+  margin-top: 1.5rem;
+}
+.lineage-timeline h3 {
+  font-size: 1rem;
+  font-weight: 600;
+  margin-bottom: 0.75rem;
+}
+.lineage-entry {
+  display: flex;
+  gap: 0.5rem;
+  padding: 0.4rem 0;
+  padding-left: 0.25rem;
+}
+.lineage-marker {
+  flex-shrink: 0;
+  font-size: 0.7rem;
+  line-height: 1.4rem;
+}
+.lineage-content {
+  display: flex;
+  flex-direction: column;
+  gap: 0.1rem;
+}
+.lineage-date {
+  font-size: 0.7rem;
+  color: var(--text-dim);
+  font-family: var(--mono);
+}
+.lineage-label {
+  font-size: 0.85rem;
+}
+
 /* Gantt truncation note */
 .mermaid-note {
   font-size: 0.75rem;
@@ -24963,842 +25237,1072 @@ function documentsPage(data) {
   `;
 }
 
-// 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", "assessmentHistory", "assessmentSummary"]);
-  const entries = Object.entries(fm).filter(
-    ([key, value]) => !skipKeys.has(key) && value != null && typeof value !== "object"
-  );
-  const arrayEntries = Object.entries(fm).filter(
-    ([key, value]) => !skipKeys.has(key) && Array.isArray(value) && value.every((v) => typeof v === "string")
-  );
-  const allEntries = [
-    ...entries.filter(([, v]) => !Array.isArray(v)),
-    ...arrayEntries
-  ];
-  const dtDd = allEntries.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" || key === "lastAssessedAt" || key === "lastJiraSyncAt") {
-      rendered = formatDate(value);
-    } else {
-      rendered = linkArtifactIds(escapeHtml(String(value)));
-    }
-    return `<dt>${escapeHtml(key)}</dt><dd>${rendered}</dd>`;
-  }).join("\n        ");
-  const rawHistory = Array.isArray(fm.assessmentHistory) ? fm.assessmentHistory : fm.assessmentSummary && typeof fm.assessmentSummary === "object" ? [fm.assessmentSummary] : [];
-  const assessmentHistory = rawHistory.filter(isValidAssessmentEntry).sort((a, b) => (b.generatedAt ?? "").localeCompare(a.generatedAt ?? ""));
-  const timelineHtml = assessmentHistory.length > 0 ? renderAssessmentTimeline(assessmentHistory) : "";
-  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)}${integrationIcons(fm)}</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>` : ""}
-
-    ${timelineHtml}
-  `;
-}
-function isValidAssessmentEntry(value) {
-  if (typeof value !== "object" || value === null) return false;
-  const obj = value;
-  if (typeof obj.generatedAt !== "string") return false;
-  if (obj.signals !== void 0 && !Array.isArray(obj.signals)) return false;
-  return true;
-}
-function normalizeEntry(entry) {
-  return {
-    generatedAt: entry.generatedAt ?? "",
-    commentSummary: typeof entry.commentSummary === "string" ? entry.commentSummary : null,
-    commentAnalysisProgress: typeof entry.commentAnalysisProgress === "number" ? entry.commentAnalysisProgress : null,
-    signals: Array.isArray(entry.signals) ? entry.signals.filter((s) => typeof s === "string") : [],
-    childCount: typeof entry.childCount === "number" ? entry.childCount : 0,
-    childDoneCount: typeof entry.childDoneCount === "number" ? entry.childDoneCount : 0,
-    childRollupProgress: typeof entry.childRollupProgress === "number" ? entry.childRollupProgress : null,
-    linkedIssueCount: typeof entry.linkedIssueCount === "number" ? entry.linkedIssueCount : 0
-  };
-}
-function renderAssessmentTimeline(history) {
-  const entries = history.map((raw, i) => {
-    const entry = normalizeEntry(raw);
-    const date5 = entry.generatedAt ? formatDate(entry.generatedAt) : "Unknown date";
-    const time3 = entry.generatedAt?.slice(11, 16) ?? "";
-    const isLatest = i === 0;
-    const parts = [];
-    if (entry.commentSummary) {
-      parts.push(`<div class="assessment-comment">${linkArtifactIds(escapeHtml(entry.commentSummary))}</div>`);
-    }
-    if (entry.commentAnalysisProgress !== null) {
-      parts.push(`<div class="assessment-stat">\u{1F4CA} Comment-derived progress: <strong>${entry.commentAnalysisProgress}%</strong></div>`);
-    }
-    if (entry.childCount > 0) {
-      const bar = progressBarHtml(entry.childRollupProgress ?? 0);
-      parts.push(`<div class="assessment-stat">\u{1F476} Children: ${entry.childDoneCount}/${entry.childCount} done ${bar} ${entry.childRollupProgress ?? 0}%</div>`);
-    }
-    if (entry.linkedIssueCount > 0) {
-      parts.push(`<div class="assessment-stat">\u{1F517} Linked issues: ${entry.linkedIssueCount}</div>`);
-    }
-    if (entry.signals.length > 0) {
-      const signalItems = entry.signals.map((s) => `<li>${linkArtifactIds(escapeHtml(s))}</li>`).join("");
-      parts.push(`<ul class="assessment-signals">${signalItems}</ul>`);
-    }
-    return `
-      <div class="assessment-entry${isLatest ? " assessment-latest" : ""}">
-        <div class="assessment-header">
-          <span class="assessment-date">${escapeHtml(date5)} ${escapeHtml(time3)}</span>
-          ${isLatest ? '<span class="badge badge-default">Latest</span>' : ""}
-        </div>
-        ${parts.join("\n")}
-      </div>`;
-  });
-  return `
-    <div class="assessment-timeline">
-      <h3>Assessment History</h3>
-      ${entries.join("\n")}
-    </div>`;
+// 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 progressBarHtml(pct) {
-  const filled = Math.round(Math.max(0, Math.min(100, pct)) / 10);
-  const empty = 10 - filled;
-  return `<span class="progress-bar-inline">${"\u2588".repeat(filled)}${"\u2591".repeat(empty)}</span>`;
+function mermaidBlock(definition, extraClass) {
+  const cls = ["mermaid-container", extraClass].filter(Boolean).join(" ");
+  return `<div class="${cls}"><pre class="mermaid">
+${definition}
+</pre></div>`;
 }
-
-// src/web/persona-views.ts
-var VIEWS = /* @__PURE__ */ new Map();
-var PAGE_RENDERERS = /* @__PURE__ */ new Map();
-function registerPersonaView(config2) {
-  VIEWS.set(config2.shortName, config2);
+function placeholder(message) {
+  return `<div class="mermaid-container mermaid-empty"><p>${message}</p></div>`;
 }
-function registerPersonaPage(persona, pageId, renderer) {
-  PAGE_RENDERERS.set(`${persona}/${pageId}`, renderer);
+function toMs(date5) {
+  return (/* @__PURE__ */ new Date(date5 + "T00:00:00")).getTime();
 }
-function getPersonaView(mode) {
-  if (!mode) return void 0;
-  return VIEWS.get(mode);
+function fmtDate(ms) {
+  const d = new Date(ms);
+  const months = ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"];
+  return `${months[d.getMonth()]} ${d.getDate()}`;
 }
-function getPersonaPageRenderer(persona, pageId) {
-  return PAGE_RENDERERS.get(`${persona}/${pageId}`);
-}
-function getAllPersonaViews() {
-  return [...VIEWS.values()];
-}
-var VALID_PERSONAS = /* @__PURE__ */ new Set(["po", "dm", "tl"]);
-function parsePersonaFromUrl(params) {
-  const value = params.get("persona")?.toLowerCase();
-  if (value && VALID_PERSONAS.has(value)) return value;
-  return null;
-}
-function parsePersonaFromPath(pathname) {
-  const match = pathname.match(/^\/(po|dm|tl)(?:\/|$)/);
-  return match ? match[1] : null;
+function buildTimelineGantt(data, maxSprints = 6) {
+  const sprintsWithDates = data.sprints.filter((s) => s.startDate && s.endDate).sort((a, b) => a.startDate < b.startDate ? -1 : 1);
+  if (sprintsWithDates.length === 0) {
+    return placeholder("No timeline data available \u2014 sprints need start and end dates.");
+  }
+  const truncated = sprintsWithDates.length > maxSprints;
+  const visibleSprints = truncated ? sprintsWithDates.slice(-maxSprints) : sprintsWithDates;
+  const hiddenCount = sprintsWithDates.length - visibleSprints.length;
+  const epicMap = new Map(data.epics.map((e) => [e.id, e]));
+  const allStarts = visibleSprints.map((s) => toMs(s.startDate));
+  const allEnds = visibleSprints.map((s) => toMs(s.endDate));
+  const timelineStart = Math.min(...allStarts);
+  const timelineEnd = Math.max(...allEnds);
+  const span = timelineEnd - timelineStart || 1;
+  const pct = (ms) => (ms - timelineStart) / span * 100;
+  const DAY = 864e5;
+  const markers = [];
+  let tick = timelineStart;
+  const startDay = new Date(tick).getDay();
+  tick += (8 - startDay) % 7 * DAY;
+  while (tick <= timelineEnd) {
+    const left = pct(tick);
+    markers.push(
+      `<div class="gantt-marker" style="left:${left.toFixed(2)}%"><span>${fmtDate(tick)}</span></div>`
+    );
+    tick += 7 * DAY;
+  }
+  const gridLines = [];
+  let gridTick = timelineStart;
+  const gridStartDay = new Date(gridTick).getDay();
+  gridTick += (8 - gridStartDay) % 7 * DAY;
+  while (gridTick <= timelineEnd) {
+    gridLines.push(`<div class="gantt-grid-line" style="left:${pct(gridTick).toFixed(2)}%"></div>`);
+    gridTick += 7 * DAY;
+  }
+  const sprintBoundaries = /* @__PURE__ */ new Set();
+  for (const sprint of visibleSprints) {
+    sprintBoundaries.add(toMs(sprint.startDate));
+    sprintBoundaries.add(toMs(sprint.endDate));
+  }
+  const sprintLines = [...sprintBoundaries].map(
+    (ms) => `<div class="gantt-sprint-line" style="left:${pct(ms).toFixed(2)}%"></div>`
+  );
+  const now = Date.now();
+  let todayMarker = "";
+  if (now >= timelineStart && now <= timelineEnd) {
+    todayMarker = `<div class="gantt-today" style="left:${pct(now).toFixed(2)}%"></div>`;
+  }
+  const sprintBlocks = visibleSprints.map((sprint) => {
+    const sStart = toMs(sprint.startDate);
+    const sEnd = toMs(sprint.endDate);
+    const left = pct(sStart).toFixed(2);
+    const width = (pct(sEnd) - pct(sStart)).toFixed(2);
+    return `<div class="gantt-sprint-block" style="left:${left}%;width:${width}%">${sanitize(sprint.id, 20)}</div>`;
+  }).join("");
+  const sprintBandRow = `<div class="gantt-row gantt-sprint-band-row">
+      <div class="gantt-label gantt-section-label">Sprints</div>
+      <div class="gantt-track gantt-sprint-band">${sprintBlocks}</div>
+    </div>`;
+  const epicSpanMap = /* @__PURE__ */ new Map();
+  for (const sprint of visibleSprints) {
+    const sStart = toMs(sprint.startDate);
+    const sEnd = toMs(sprint.endDate);
+    for (const eid of sprint.linkedEpics) {
+      if (!epicMap.has(eid)) continue;
+      const existing = epicSpanMap.get(eid);
+      if (existing) {
+        existing.startMs = Math.min(existing.startMs, sStart);
+        existing.endMs = Math.max(existing.endMs, sEnd);
+      } else {
+        epicSpanMap.set(eid, { startMs: sStart, endMs: sEnd });
+      }
+    }
+  }
+  const sortedEpicIds = [...epicSpanMap.keys()].sort((a, b) => {
+    const aSpan = epicSpanMap.get(a);
+    const bSpan = epicSpanMap.get(b);
+    if (aSpan.startMs !== bSpan.startMs) return aSpan.startMs - bSpan.startMs;
+    return a.localeCompare(b);
+  });
+  const epicRows = sortedEpicIds.map((eid) => {
+    const epic = epicMap.get(eid);
+    const { startMs, endMs } = epicSpanMap.get(eid);
+    const cls = epic.status === "done" || epic.status === "completed" ? "gantt-bar-done" : epic.status === "in-progress" || epic.status === "active" ? "gantt-bar-active" : epic.status === "blocked" ? "gantt-bar-blocked" : "gantt-bar-default";
+    const left = pct(startMs).toFixed(2);
+    const width = (pct(endMs) - pct(startMs)).toFixed(2);
+    const label = sanitize(epic.id + " " + epic.title);
+    return `<div class="gantt-row">
+        <div class="gantt-label">${label}</div>
+        <div class="gantt-track">
+          <div class="gantt-bar ${cls}" style="left:${left}%;width:${width}%"></div>
+        </div>
+      </div>`;
+  }).join("\n");
+  const note = truncated ? `<div class="mermaid-note">${hiddenCount} earlier sprint${hiddenCount > 1 ? "s" : ""} not shown</div>` : "";
+  return `${note}
+    <div class="gantt">
+      <div class="gantt-chart">
+        <div class="gantt-header">
+          <div class="gantt-label"></div>
+          <div class="gantt-track gantt-dates">${markers.join("")}</div>
+        </div>
+        ${sprintBandRow}
+        ${epicRows}
+      </div>
+      <div class="gantt-overlay">
+        <div class="gantt-label"></div>
+        <div class="gantt-track">${gridLines.join("")}${sprintLines.join("")}${todayMarker}</div>
+      </div>
+    </div>`;
 }
-function resolvePersona(pathname, params) {
-  return parsePersonaFromPath(pathname) ?? parsePersonaFromUrl(params);
+function statusClass(status) {
+  const s = status.toLowerCase();
+  if (s === "done" || s === "completed") return "flow-done";
+  if (s === "in-progress" || s === "active") return "flow-active";
+  if (s === "blocked") return "flow-blocked";
+  return "flow-default";
 }
-var SHARED_NAV_ITEMS = [
-  { pageId: "timeline", label: "Timeline" },
-  { pageId: "board", label: "Board" },
-  { pageId: "upcoming", label: "Upcoming" },
-  { pageId: "sprint-summary", label: "Sprint Summary" },
-  { pageId: "gar", label: "GAR Report" },
-  { pageId: "health", label: "Health" }
-];
-
-// src/web/templates/pages/persona-picker.ts
-function personaPickerPage() {
-  const views = getAllPersonaViews();
-  const cards = views.map(
-    (v) => `
-      <a href="/${v.shortName}/dashboard" class="persona-picker-card" style="--persona-card-accent: ${v.color}">
-        <div class="persona-picker-name">${escapeHtml(v.displayName)}</div>
-        <div class="persona-picker-desc">${escapeHtml(v.description)}</div>
-      </a>`
-  ).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 edges = [];
+  const epicsByFeature = /* @__PURE__ */ new Map();
+  for (const epic of data.epics) {
+    for (const fid of epic.linkedFeature) {
+      if (!epicsByFeature.has(fid)) epicsByFeature.set(fid, []);
+      epicsByFeature.get(fid).push(epic.id);
+      edges.push({ from: fid, to: epic.id });
+    }
+  }
+  const sprintsByEpic = /* @__PURE__ */ new Map();
+  for (const sprint of data.sprints) {
+    for (const eid of sprint.linkedEpics) {
+      if (!sprintsByEpic.has(eid)) sprintsByEpic.set(eid, []);
+      sprintsByEpic.get(eid).push(sprint.id);
+      edges.push({ from: eid, to: sprint.id });
+    }
+  }
+  const connectedFeatureIds = new Set(epicsByFeature.keys());
+  const connectedEpicIds = /* @__PURE__ */ new Set();
+  for (const ids of epicsByFeature.values()) ids.forEach((id) => connectedEpicIds.add(id));
+  for (const ids of sprintsByEpic.values()) ids.forEach(() => {
+  });
+  for (const eid of sprintsByEpic.keys()) connectedEpicIds.add(eid);
+  const connectedSprintIds = /* @__PURE__ */ new Set();
+  for (const ids of sprintsByEpic.values()) ids.forEach((id) => connectedSprintIds.add(id));
+  const features = data.features.filter((f) => connectedFeatureIds.has(f.id));
+  const epics = data.epics.filter((e) => connectedEpicIds.has(e.id));
+  const sprints = data.sprints.filter((s) => connectedSprintIds.has(s.id)).sort((a, b) => (a.startDate ?? "").localeCompare(b.startDate ?? ""));
+  if (features.length === 0 && epics.length === 0) {
+    return placeholder("No artifact relationships found \u2014 link epics to features and sprints.");
+  }
+  const renderNode = (id, title, status, type) => `<div class="flow-node ${statusClass(status)}" data-flow-id="${id}">
+      <a class="flow-node-id" href="/docs/${type}/${id}">${id}</a>
+      <span class="flow-node-title">${sanitize(title, 35)}</span>
+    </div>`;
+  const featuresHtml = features.map((f) => renderNode(f.id, f.title, f.status, "feature")).join("\n");
+  const epicsHtml = epics.map((e) => renderNode(e.id, e.title, e.status, "epic")).join("\n");
+  const sprintsHtml = sprints.map((s) => renderNode(s.id, s.title, s.status, "sprint")).join("\n");
+  const edgesJson = JSON.stringify(edges);
   return `
-    <div class="persona-picker">
-      <h2>Choose Your View</h2>
-      <p class="persona-picker-subtitle">Select a role to see a curated dashboard with the pages most relevant to you.</p>
-      <div class="persona-picker-grid">
-        ${cards}
+    <div class="flow-diagram" id="flow-diagram">
+      <svg class="flow-lines" id="flow-lines"></svg>
+      <div class="flow-columns">
+        <div class="flow-column">
+          <div class="flow-column-header">Features</div>
+          ${featuresHtml}
+        </div>
+        <div class="flow-column">
+          <div class="flow-column-header">Epics</div>
+          ${epicsHtml}
+        </div>
+        <div class="flow-column">
+          <div class="flow-column-header">Sprints</div>
+          ${sprintsHtml}
+        </div>
       </div>
-    </div>`;
-}
+    </div>
+    <script>
+    (function() {
+      var edges = ${edgesJson};
+      var container = document.getElementById('flow-diagram');
+      var svg = document.getElementById('flow-lines');
+      if (!container || !svg) return;
 
-// src/reports/sprint-summary/risk-assessment.ts
-import { query as query3 } from "@anthropic-ai/claude-agent-sdk";
-var SYSTEM_PROMPT2 = `You are a delivery management assistant generating a data-driven risk assessment.
+      // Build directed adjacency maps for traversal
+      var fwd = {};   // from \u2192 [to] (Feature\u2192Epic, Epic\u2192Sprint)
+      var bwd = {};   // to \u2192 [from] (Sprint\u2192Epic, Epic\u2192Feature)
+      edges.forEach(function(e) {
+        if (!fwd[e.from]) fwd[e.from] = [];
+        if (!bwd[e.to]) bwd[e.to] = [];
+        fwd[e.from].push(e.to);
+        bwd[e.to].push(e.from);
+      });
 
-IMPORTANT: All the data you need is provided in the user message below. Do NOT attempt to look up, search for, or request additional information. Analyze ONLY the data given and produce your assessment immediately.
+      function drawLines() {
+        var rect = container.getBoundingClientRect();
+        var scrollW = container.scrollWidth;
+        var scrollH = container.scrollHeight;
+        svg.setAttribute('width', scrollW);
+        svg.setAttribute('height', scrollH);
+        svg.innerHTML = '';
 
-Produce a concise markdown assessment with these sections:
+        // Use scroll offsets so lines align with scrolled content
+        var scrollLeft = container.scrollLeft;
+        var scrollTop = container.scrollTop;
 
-## Status Assessment
-One-line verdict: is this risk actively being mitigated, stalled, or escalating?
+        edges.forEach(function(edge) {
+          var fromEl = container.querySelector('[data-flow-id="' + edge.from + '"]');
+          var toEl = container.querySelector('[data-flow-id="' + edge.to + '"]');
+          if (!fromEl || !toEl) return;
 
-## Related Activity
-What actions, decisions, or contributions are connected to this risk? How are they progressing? Be specific \u2014 reference artifact IDs from the data provided.
+          var fr = fromEl.getBoundingClientRect();
+          var tr = toEl.getBoundingClientRect();
+          var x1 = fr.right - rect.left + scrollLeft;
+          var y1 = fr.top + fr.height / 2 - rect.top + scrollTop;
+          var x2 = tr.left - rect.left + scrollLeft;
+          var y2 = tr.top + tr.height / 2 - rect.top + scrollTop;
+          var mx = (x1 + x2) / 2;
 
-## Trajectory
-Based on the data (status of related items, time remaining, ownership), is this risk trending toward resolution or toward becoming a blocker? Explain your reasoning with concrete evidence.
+          var path = document.createElementNS('http://www.w3.org/2000/svg', 'path');
+          path.setAttribute('d', 'M' + x1 + ',' + y1 + ' C' + mx + ',' + y1 + ' ' + mx + ',' + y2 + ' ' + x2 + ',' + y2);
+          path.setAttribute('fill', 'none');
+          path.setAttribute('stroke', '#2a2e3a');
+          path.setAttribute('stroke-width', '1.5');
+          path.dataset.from = edge.from;
+          path.dataset.to = edge.to;
+          svg.appendChild(path);
+        });
+      }
 
-## Recommendation
-One concrete next step to move this risk toward resolution.
+      // Find directly related nodes via directed traversal
+      // Follows forward edges (Feature\u2192Epic\u2192Sprint) and backward edges
+      // (Sprint\u2192Epic\u2192Feature) separately to avoid sideways expansion
+      function findConnected(startId) {
+        var visited = {};
+        visited[startId] = true;
+        // Traverse forward (from\u2192to direction)
+        var queue = [startId];
+        while (queue.length) {
+          var id = queue.shift();
+          (fwd[id] || []).forEach(function(neighbor) {
+            if (!visited[neighbor]) {
+              visited[neighbor] = true;
+              queue.push(neighbor);
+            }
+          });
+        }
+        // Traverse backward (to\u2192from direction)
+        queue = [startId];
+        while (queue.length) {
+          var id = queue.shift();
+          (bwd[id] || []).forEach(function(neighbor) {
+            if (!visited[neighbor]) {
+              visited[neighbor] = true;
+              queue.push(neighbor);
+            }
+          });
+        }
+        return visited;
+      }
 
-Rules:
-- Reference artifact IDs, dates, owners, and statuses from the provided data
-- Keep the tone professional and direct
-- Do NOT speculate beyond what the data supports \u2014 if information is insufficient, say so explicitly
-- Do NOT ask for more information or say you will look things up \u2014 everything you need is in the prompt
-- Produce the full assessment text directly`;
-async function generateRiskAssessment(data, riskId, store) {
-  const risk = data.risks.find((r) => r.id === riskId);
-  if (!risk) return "Risk not found in sprint data.";
-  const prompt = buildSingleRiskPrompt(data, risk, store);
-  const result = query3({
-    prompt,
-    options: {
-      systemPrompt: SYSTEM_PROMPT2,
-      maxTurns: 1,
-      tools: [],
-      allowedTools: []
-    }
-  });
-  for await (const msg of result) {
-    if (msg.type === "assistant") {
-      const text = msg.message.content.find(
-        (b) => b.type === "text"
-      );
-      if (text) return text.text;
-    }
-  }
-  return "Unable to generate risk assessment.";
-}
-function buildSingleRiskPrompt(data, risk, store) {
-  const sections = [];
-  sections.push(`# Sprint: ${data.sprint.id} \u2014 ${data.sprint.title}`);
-  if (data.sprint.goal) sections.push(`Goal: ${data.sprint.goal}`);
-  sections.push(`Days remaining: ${data.timeline.daysRemaining} / ${data.timeline.totalDays}`);
-  sections.push(`Completion: ${data.workItems.completionPct}%`);
-  sections.push("");
-  const doc = store.get(risk.id);
-  sections.push(`# RISK: ${risk.id} \u2014 ${risk.title}`);
-  sections.push(`Type: ${risk.type}`);
-  if (doc) {
-    sections.push(`Status: ${doc.frontmatter.status}`);
-    if (doc.frontmatter.owner) sections.push(`Owner: ${doc.frontmatter.owner}`);
-    if (doc.frontmatter.assignee) sections.push(`Assignee: ${doc.frontmatter.assignee}`);
-    if (doc.frontmatter.priority) sections.push(`Priority: ${doc.frontmatter.priority}`);
-    if (doc.frontmatter.dueDate) sections.push(`Due date: ${doc.frontmatter.dueDate}`);
-    if (doc.frontmatter.created) sections.push(`Created: ${doc.frontmatter.created.slice(0, 10)}`);
-    const tags = doc.frontmatter.tags ?? [];
-    if (tags.length > 0) sections.push(`Tags: ${tags.join(", ")}`);
-    if (doc.content.trim()) {
-      sections.push(`
-Description:
-${doc.content.trim()}`);
-    }
-    const allDocs = store.list();
-    const relatedIds = /* @__PURE__ */ new Set();
-    for (const d of allDocs) {
-      if (d.frontmatter.aboutArtifact === risk.id) {
-        relatedIds.add(d.frontmatter.id);
+      function highlight(hoveredId) {
+        var connected = findConnected(hoveredId);
+        container.querySelectorAll('.flow-node').forEach(function(n) {
+          if (connected[n.dataset.flowId]) {
+            n.classList.add('flow-lit');
+            n.classList.remove('flow-dim');
+          } else {
+            n.classList.add('flow-dim');
+            n.classList.remove('flow-lit');
+          }
+        });
+        svg.querySelectorAll('path').forEach(function(p) {
+          if (connected[p.dataset.from] && connected[p.dataset.to]) {
+            p.classList.add('flow-line-lit');
+            p.classList.remove('flow-line-dim');
+          } else {
+            p.classList.add('flow-line-dim');
+            p.classList.remove('flow-line-lit');
+          }
+        });
       }
-    }
-    const idPattern = /\b([A-Z]-\d{3,})\b/g;
-    let match;
-    while ((match = idPattern.exec(doc.content)) !== null) {
-      relatedIds.add(match[1]);
-    }
-    const significantTags = tags.filter(
-      (t) => !t.startsWith("sprint:") && !t.startsWith("focus:") && t !== "risk"
-    );
-    if (significantTags.length > 0) {
-      for (const d of allDocs) {
-        if (d.frontmatter.id === risk.id) continue;
-        const dTags = d.frontmatter.tags ?? [];
-        if (significantTags.some((t) => dTags.includes(t))) {
-          relatedIds.add(d.frontmatter.id);
-        }
+
+      function clearHighlight() {
+        container.querySelectorAll('.flow-node').forEach(function(n) { n.classList.remove('flow-lit', 'flow-dim'); });
+        svg.querySelectorAll('path').forEach(function(p) { p.classList.remove('flow-line-lit', 'flow-line-dim'); });
       }
-    }
-    const about = doc.frontmatter.aboutArtifact;
-    if (about) {
-      relatedIds.add(about);
-      for (const d of allDocs) {
-        if (d.frontmatter.aboutArtifact === about && d.frontmatter.id !== risk.id) {
-          relatedIds.add(d.frontmatter.id);
+
+      var activeId = null;
+      container.addEventListener('click', function(e) {
+        // Let the ID link navigate normally
+        if (e.target.closest('a')) return;
+
+        var node = e.target.closest('.flow-node');
+        var clickedId = node ? node.dataset.flowId : null;
+
+        if (!clickedId || clickedId === activeId) {
+          activeId = null;
+          clearHighlight();
+          return;
         }
+
+        activeId = clickedId;
+        highlight(clickedId);
+      });
+
+      function drawAndHighlight() {
+        drawLines();
+        if (activeId) highlight(activeId);
       }
-    }
-    const relatedDocs = [...relatedIds].map((id) => store.get(id)).filter((d) => d != null).slice(0, 20);
-    if (relatedDocs.length > 0) {
-      sections.push(`
-## Related Documents (${relatedDocs.length})`);
-      for (const rd of relatedDocs) {
-        const owner = rd.frontmatter.owner ?? "unowned";
-        const summary = rd.content.trim().slice(0, 300);
-        sections.push(
-          `- ${rd.frontmatter.id} (${rd.frontmatter.type}) [${rd.frontmatter.status}] \u2014 ${rd.frontmatter.title}`
-        );
-        sections.push(`  Owner: ${owner}${rd.frontmatter.dueDate ? `, Due: ${rd.frontmatter.dueDate}` : ""}`);
-        if (summary) sections.push(`  Summary: ${summary}${rd.content.trim().length > 300 ? "..." : ""}`);
-      }
-    }
+
+      requestAnimationFrame(function() { setTimeout(drawAndHighlight, 100); });
+      window.addEventListener('resize', drawAndHighlight);
+      container.addEventListener('scroll', drawAndHighlight);
+      new ResizeObserver(drawAndHighlight).observe(container);
+    })();
+    </script>`;
+}
+function buildStatusPie(title, counts) {
+  const entries = Object.entries(counts).filter(([, v]) => v > 0);
+  if (entries.length === 0) {
+    return placeholder(`No data for ${title}.`);
   }
-  sections.push("");
-  sections.push(`---`);
-  sections.push(`
-Generate the risk assessment for ${risk.id} based on the data above.`);
-  return sections.join("\n");
+  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/artifact-graph.ts
+function buildArtifactRelationGraph(data) {
+  const hasContent = data.origins.length > 0 || data.parents.length > 0 || data.children.length > 0 || data.external.length > 0;
+  if (!hasContent) {
+    return `<div class="flow-diagram flow-empty"><p>No relationships found for this artifact.</p></div>`;
+  }
+  const edges = data.edges;
+  const renderNode = (id, title, status, type) => {
+    const href = type === "jira" ? title.startsWith("http") ? title : "#" : `/docs/${type}/${id}`;
+    const target = type === "jira" ? ' target="_blank" rel="noopener"' : "";
+    const cls = type === "jira" ? "flow-node flow-external" : `flow-node ${statusClass(status)}`;
+    const displayTitle = type === "jira" ? "Jira Issue" : sanitize(title, 35);
+    const displayId = type === "jira" ? `${id} \u2197` : id;
+    return `<div class="${cls}" data-flow-id="${escapeHtml(id)}">
+      <a class="flow-node-id" href="${escapeHtml(href)}"${target}>${escapeHtml(displayId)}</a>
+      <span class="flow-node-title">${escapeHtml(displayTitle)}</span>
+    </div>`;
+  };
+  const selfNode = `<div class="flow-node flow-self ${statusClass(data.self.status)}" data-flow-id="${escapeHtml(data.self.id)}">
+    <span class="flow-node-id">${escapeHtml(data.self.id)}</span>
+    <span class="flow-node-title">${escapeHtml(sanitize(data.self.title, 35))}</span>
+  </div>`;
+  const columns = [];
+  if (data.origins.length > 0) {
+    columns.push({
+      header: "Origins",
+      nodes: data.origins.map((a) => renderNode(a.id, a.title, a.status, a.type)).join("\n")
+    });
+  }
+  if (data.parents.length > 0) {
+    columns.push({
+      header: "Parents",
+      nodes: data.parents.map((a) => renderNode(a.id, a.title, a.status, a.type)).join("\n")
+    });
+  }
+  columns.push({
+    header: data.self.type.replace(/-/g, " ").replace(/\b\w/g, (c) => c.toUpperCase()),
+    nodes: selfNode
+  });
+  if (data.children.length > 0) {
+    columns.push({
+      header: "Children",
+      nodes: data.children.map((a) => renderNode(a.id, a.title, a.status, a.type)).join("\n")
+    });
+  }
+  if (data.external.length > 0) {
+    columns.push({
+      header: "External",
+      nodes: data.external.map((a) => renderNode(a.id, a.title, a.status, a.type)).join("\n")
+    });
+  }
+  const columnsHtml = columns.map((col) => `
+    <div class="flow-column">
+      <div class="flow-column-header">${escapeHtml(col.header)}</div>
+      ${col.nodes}
+    </div>`).join("\n");
+  const edgesJson = JSON.stringify(edges);
+  return `
+    <div class="flow-diagram" id="rel-graph">
+      <svg class="flow-lines" id="rel-lines"></svg>
+      <div class="flow-columns">
+        ${columnsHtml}
+      </div>
+    </div>
+    <script>
+    (function() {
+      var edges = ${edgesJson};
+      var container = document.getElementById('rel-graph');
+      var svg = document.getElementById('rel-lines');
+      if (!container || !svg) return;
 
-// src/personas/builtin/product-owner.ts
-var productOwner = {
-  id: "product-owner",
-  name: "Product Owner",
-  shortName: "po",
-  description: "Focuses on product vision, stakeholder needs, backlog prioritization, and value delivery.",
-  systemPrompt: `You are Marvin, acting as a **Product Owner**. Your role is to help the team maximize the value delivered by the product.
+      var fwd = {};
+      var bwd = {};
+      edges.forEach(function(e) {
+        if (!fwd[e.from]) fwd[e.from] = [];
+        if (!bwd[e.to]) bwd[e.to] = [];
+        fwd[e.from].push(e.to);
+        bwd[e.to].push(e.from);
+      });
 
-## Core Responsibilities
-- Define and communicate the product vision and strategy
-- Manage and prioritize the product backlog
-- Ensure stakeholder needs are understood and addressed
-- Make decisions about scope, priority, and trade-offs
-- Accept or reject work results based on acceptance criteria
+      function drawLines() {
+        var rect = container.getBoundingClientRect();
+        var scrollW = container.scrollWidth;
+        var scrollH = container.scrollHeight;
+        svg.setAttribute('width', scrollW);
+        svg.setAttribute('height', scrollH);
+        svg.innerHTML = '';
 
-## How You Work
-- Ask clarifying questions to understand business value and user needs
-- Create and refine decisions (D-xxx) for important product choices
-- Track questions (Q-xxx) that need stakeholder input
-- Define acceptance criteria for features and deliverables
-- Prioritize actions (A-xxx) based on business value
+        var scrollLeft = container.scrollLeft;
+        var scrollTop = container.scrollTop;
 
-## Communication Style
-- Business-oriented language, avoid unnecessary technical jargon
-- Focus on outcomes and value, not implementation details
-- Be decisive but transparent about trade-offs
-- Challenge assumptions that don't align with product goals`,
-  focusAreas: [
-    "Product vision and strategy",
-    "Backlog management",
-    "Stakeholder communication",
-    "Value delivery",
-    "Acceptance criteria",
-    "Feature definition and prioritization"
-  ],
-  documentTypes: ["decision", "question", "action", "feature"],
-  contributionTypes: ["stakeholder-feedback", "acceptance-result", "priority-change", "market-insight"]
-};
+        edges.forEach(function(edge) {
+          var fromEl = container.querySelector('[data-flow-id="' + edge.from + '"]');
+          var toEl = container.querySelector('[data-flow-id="' + edge.to + '"]');
+          if (!fromEl || !toEl) return;
 
-// src/personas/builtin/delivery-manager.ts
-var deliveryManager = {
-  id: "delivery-manager",
-  name: "Delivery Manager",
-  shortName: "dm",
-  description: "Focuses on project delivery, risk management, team coordination, and process governance.",
-  systemPrompt: `You are Marvin, acting as a **Delivery Manager**. Your role is to ensure the project is delivered on time, within scope, and with managed risks.
+          var fr = fromEl.getBoundingClientRect();
+          var tr = toEl.getBoundingClientRect();
+          var x1 = fr.right - rect.left + scrollLeft;
+          var y1 = fr.top + fr.height / 2 - rect.top + scrollTop;
+          var x2 = tr.left - rect.left + scrollLeft;
+          var y2 = tr.top + tr.height / 2 - rect.top + scrollTop;
+          var mx = (x1 + x2) / 2;
 
-## Core Responsibilities
-- Track project progress and identify blockers
-- Manage risks, issues, and dependencies
-- Coordinate between team members and stakeholders
-- Ensure governance processes are followed (decisions logged, actions tracked)
-- Facilitate meetings and ensure outcomes are captured
+          var path = document.createElementNS('http://www.w3.org/2000/svg', 'path');
+          path.setAttribute('d', 'M' + x1 + ',' + y1 + ' C' + mx + ',' + y1 + ' ' + mx + ',' + y2 + ' ' + x2 + ',' + y2);
+          path.setAttribute('fill', 'none');
+          path.setAttribute('stroke', '#2a2e3a');
+          path.setAttribute('stroke-width', '1.5');
+          path.dataset.from = edge.from;
+          path.dataset.to = edge.to;
+          svg.appendChild(path);
+        });
+      }
 
-## 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
-- Create meeting notes and ensure action items are assigned
+      function findConnected(startId) {
+        var visited = {};
+        visited[startId] = true;
+        var queue = [startId];
+        while (queue.length) {
+          var id = queue.shift();
+          (fwd[id] || []).forEach(function(n) {
+            if (!visited[n]) { visited[n] = true; queue.push(n); }
+          });
+        }
+        queue = [startId];
+        while (queue.length) {
+          var id = queue.shift();
+          (bwd[id] || []).forEach(function(n) {
+            if (!visited[n]) { visited[n] = true; queue.push(n); }
+          });
+        }
+        return visited;
+      }
 
-## Communication Style
-- Process-oriented but pragmatic
-- Focus on status, risks, and blockers
-- Be proactive about follow-ups and deadlines
-- Keep stakeholders informed with concise updates`,
-  focusAreas: [
-    "Project delivery",
-    "Risk management",
-    "Team coordination",
-    "Process governance",
-    "Status tracking",
-    "Epic scheduling and tracking",
-    "Sprint planning and tracking"
-  ],
-  documentTypes: ["action", "decision", "meeting", "question", "feature", "epic", "task", "sprint"],
-  contributionTypes: ["risk-finding", "blocker-report", "dependency-update", "status-assessment"]
-};
+      function highlight(hoveredId) {
+        var connected = findConnected(hoveredId);
+        container.querySelectorAll('.flow-node').forEach(function(n) {
+          if (connected[n.dataset.flowId]) {
+            n.classList.add('flow-lit'); n.classList.remove('flow-dim');
+          } else {
+            n.classList.add('flow-dim'); n.classList.remove('flow-lit');
+          }
+        });
+        svg.querySelectorAll('path').forEach(function(p) {
+          if (connected[p.dataset.from] && connected[p.dataset.to]) {
+            p.classList.add('flow-line-lit'); p.classList.remove('flow-line-dim');
+          } else {
+            p.classList.add('flow-line-dim'); p.classList.remove('flow-line-lit');
+          }
+        });
+      }
 
-// src/personas/builtin/tech-lead.ts
-var techLead = {
-  id: "tech-lead",
-  name: "Technical Lead",
-  shortName: "tl",
-  description: "Focuses on technical architecture, code quality, technical decisions, and implementation guidance.",
-  systemPrompt: `You are Marvin, acting as a **Technical Lead**. Your role is to guide the team on technical decisions and ensure high-quality implementation.
+      function clearHighlight() {
+        container.querySelectorAll('.flow-node').forEach(function(n) { n.classList.remove('flow-lit', 'flow-dim'); });
+        svg.querySelectorAll('path').forEach(function(p) { p.classList.remove('flow-line-lit', 'flow-line-dim'); });
+      }
 
-## Core Responsibilities
-- Define and maintain technical architecture
-- Make and document technical decisions with clear rationale
-- Review technical approaches and identify potential issues
-- Guide the team on best practices and patterns
-- Evaluate technical risks and propose mitigations
+      var activeId = null;
+      container.addEventListener('click', function(e) {
+        if (e.target.closest('a')) return;
+        var node = e.target.closest('.flow-node');
+        var clickedId = node ? node.dataset.flowId : null;
+        if (!clickedId || clickedId === activeId) {
+          activeId = null; clearHighlight(); return;
+        }
+        activeId = clickedId;
+        highlight(clickedId);
+      });
 
-## How You Work
-- Create decisions (D-xxx) for significant technical choices (framework, architecture, patterns)
-- Document technical questions (Q-xxx) that need investigation or proof-of-concept
-- Define technical actions (A-xxx) for implementation tasks
-- Consider non-functional requirements (performance, security, maintainability)
-- Provide clear technical guidance with examples when helpful
+      function drawAndHighlight() {
+        drawLines();
+        if (activeId) highlight(activeId);
+      }
 
-## Communication Style
-- Technical but accessible \u2014 explain complex concepts clearly
-- Evidence-based decision making with documented trade-offs
-- Pragmatic about technical debt vs. delivery speed
-- Focus on maintainability and long-term sustainability`,
-  focusAreas: [
-    "Technical architecture",
-    "Code quality",
-    "Technical decisions",
-    "Implementation guidance",
-    "Non-functional requirements",
-    "Epic creation and scoping",
-    "Task creation and breakdown",
-    "Sprint scoping and technical execution"
-  ],
-  documentTypes: ["decision", "action", "question", "epic", "task", "sprint"],
-  contributionTypes: ["action-result", "spike-findings", "technical-assessment", "architecture-review"]
+      requestAnimationFrame(function() { setTimeout(drawAndHighlight, 100); });
+      window.addEventListener('resize', drawAndHighlight);
+      container.addEventListener('scroll', drawAndHighlight);
+      new ResizeObserver(drawAndHighlight).observe(container);
+    })();
+    </script>`;
+}
+var EVENT_ICONS = {
+  "created": "\u{1F7E2}",
+  "source-linked": "\u{1F535}",
+  "child-spawned": "\u{1F7E1}",
+  "assessment": "\u{1F7E3}",
+  "jira-sync": "\u{1F537}"
 };
+function buildLineageTimeline(events) {
+  if (events.length === 0) {
+    return "";
+  }
+  const entries = events.map((event) => {
+    const icon = EVENT_ICONS[event.type] ?? "\u26AA";
+    const date5 = event.date ? formatDate(event.date) : "";
+    const time3 = event.date?.slice(11, 16) ?? "";
+    const label = linkArtifactIds(escapeHtml(event.label));
+    return `
+      <div class="lineage-entry lineage-${escapeHtml(event.type)}">
+        <div class="lineage-marker">${icon}</div>
+        <div class="lineage-content">
+          <span class="lineage-date">${escapeHtml(date5)} ${escapeHtml(time3)}</span>
+          <span class="lineage-label">${label}</span>
+        </div>
+      </div>`;
+  });
+  return `
+    <div class="lineage-timeline">
+      <h3>Lineage</h3>
+      ${entries.join("\n")}
+    </div>`;
+}
+
+// src/web/templates/pages/document-detail.ts
+function documentDetailPage(doc, store) {
+  const fm = doc.frontmatter;
+  const label = typeLabel(fm.type);
+  const skipKeys = /* @__PURE__ */ new Set(["title", "type", "assessmentHistory", "assessmentSummary"]);
+  const entries = Object.entries(fm).filter(
+    ([key, value]) => !skipKeys.has(key) && value != null && typeof value !== "object"
+  );
+  const arrayEntries = Object.entries(fm).filter(
+    ([key, value]) => !skipKeys.has(key) && Array.isArray(value) && value.every((v) => typeof v === "string")
+  );
+  const allEntries = [
+    ...entries.filter(([, v]) => !Array.isArray(v)),
+    ...arrayEntries
+  ];
+  const dtDd = allEntries.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" || key === "lastAssessedAt" || key === "lastJiraSyncAt") {
+      rendered = formatDate(value);
+    } else {
+      rendered = linkArtifactIds(escapeHtml(String(value)));
+    }
+    return `<dt>${escapeHtml(key)}</dt><dd>${rendered}</dd>`;
+  }).join("\n        ");
+  const rawHistory = Array.isArray(fm.assessmentHistory) ? fm.assessmentHistory : fm.assessmentSummary && typeof fm.assessmentSummary === "object" ? [fm.assessmentSummary] : [];
+  const assessmentHistory = rawHistory.filter(isValidAssessmentEntry).sort((a, b) => (b.generatedAt ?? "").localeCompare(a.generatedAt ?? ""));
+  const timelineHtml = assessmentHistory.length > 0 ? renderAssessmentTimeline(assessmentHistory) : "";
+  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)}${integrationIcons(fm)}</h2>
+      <div class="subtitle">${escapeHtml(fm.id)} &middot; ${escapeHtml(label)}</div>
+    </div>
+
+    <div class="detail-meta">
+      <dl>
+        ${dtDd}
+      </dl>
+    </div>
 
-// src/personas/registry.ts
-var BUILTIN_PERSONAS = [
-  productOwner,
-  deliveryManager,
-  techLead
-];
-function getPersona(idOrShortName) {
-  const key = idOrShortName.toLowerCase();
-  return BUILTIN_PERSONAS.find(
-    (p) => p.id === key || p.shortName === key
-  );
+    ${doc.content.trim() ? `<div class="detail-content">${renderMarkdown(doc.content)}</div>` : ""}
+
+    ${timelineHtml}
+
+    ${store ? renderRelationshipsAndLineage(store, fm.id) : ""}
+  `;
 }
-function listPersonas() {
-  return [...BUILTIN_PERSONAS];
+function renderRelationshipsAndLineage(store, docId) {
+  const parts = [];
+  const relationships = getArtifactRelationships(store, docId);
+  if (relationships) {
+    const graphHtml = buildArtifactRelationGraph(relationships);
+    parts.push(collapsibleSection("rel-graph-" + docId, "Relationships", graphHtml));
+  }
+  const events = getArtifactLineageEvents(store, docId);
+  if (events.length > 0) {
+    const lineageHtml = buildLineageTimeline(events);
+    parts.push(collapsibleSection("lineage-" + docId, "Lineage", lineageHtml, { defaultCollapsed: true }));
+  }
+  return parts.join("\n");
 }
-
-// src/web/templates/persona-switcher.ts
-function renderPersonaSwitcher(current, _currentPath) {
-  const views = getAllPersonaViews();
-  if (views.length === 0) return "";
-  const options = views.map(
-    (v) => `<option value="${v.shortName}"${current === v.shortName ? " selected" : ""}>${escapeHtml(v.displayName)}</option>`
-  ).join("\n          ");
+function isValidAssessmentEntry(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const obj = value;
+  if (typeof obj.generatedAt !== "string") return false;
+  if (obj.signals !== void 0 && !Array.isArray(obj.signals)) return false;
+  return true;
+}
+function normalizeEntry(entry) {
+  return {
+    generatedAt: entry.generatedAt ?? "",
+    commentSummary: typeof entry.commentSummary === "string" ? entry.commentSummary : null,
+    commentAnalysisProgress: typeof entry.commentAnalysisProgress === "number" ? entry.commentAnalysisProgress : null,
+    signals: Array.isArray(entry.signals) ? entry.signals.filter((s) => typeof s === "string") : [],
+    childCount: typeof entry.childCount === "number" ? entry.childCount : 0,
+    childDoneCount: typeof entry.childDoneCount === "number" ? entry.childDoneCount : 0,
+    childRollupProgress: typeof entry.childRollupProgress === "number" ? entry.childRollupProgress : null,
+    linkedIssueCount: typeof entry.linkedIssueCount === "number" ? entry.linkedIssueCount : 0
+  };
+}
+function renderAssessmentTimeline(history) {
+  const entries = history.map((raw, i) => {
+    const entry = normalizeEntry(raw);
+    const date5 = entry.generatedAt ? formatDate(entry.generatedAt) : "Unknown date";
+    const time3 = entry.generatedAt?.slice(11, 16) ?? "";
+    const isLatest = i === 0;
+    const parts = [];
+    if (entry.commentSummary) {
+      parts.push(`<div class="assessment-comment">${linkArtifactIds(escapeHtml(entry.commentSummary))}</div>`);
+    }
+    if (entry.commentAnalysisProgress !== null) {
+      parts.push(`<div class="assessment-stat">\u{1F4CA} Comment-derived progress: <strong>${entry.commentAnalysisProgress}%</strong></div>`);
+    }
+    if (entry.childCount > 0) {
+      const bar = progressBarHtml(entry.childRollupProgress ?? 0);
+      parts.push(`<div class="assessment-stat">\u{1F476} Children: ${entry.childDoneCount}/${entry.childCount} done ${bar} ${entry.childRollupProgress ?? 0}%</div>`);
+    }
+    if (entry.linkedIssueCount > 0) {
+      parts.push(`<div class="assessment-stat">\u{1F517} Linked issues: ${entry.linkedIssueCount}</div>`);
+    }
+    if (entry.signals.length > 0) {
+      const signalItems = entry.signals.map((s) => `<li>${linkArtifactIds(escapeHtml(s))}</li>`).join("");
+      parts.push(`<ul class="assessment-signals">${signalItems}</ul>`);
+    }
+    return `
+      <div class="assessment-entry${isLatest ? " assessment-latest" : ""}">
+        <div class="assessment-header">
+          <span class="assessment-date">${escapeHtml(date5)} ${escapeHtml(time3)}</span>
+          ${isLatest ? '<span class="badge badge-default">Latest</span>' : ""}
+        </div>
+        ${parts.join("\n")}
+      </div>`;
+  });
   return `
-    <div class="persona-switcher">
-      <label class="persona-label" for="persona-select">View</label>
-      <select class="persona-select" id="persona-select" onchange="switchPersona(this.value)">
-          ${options}
-      </select>
-    </div>
-    <script>
-      function switchPersona(value) {
-        if (value) {
-          window.location.href = '/' + value + '/dashboard';
-        }
-      }
-    </script>`;
+    <div class="assessment-timeline">
+      <h3>Assessment History</h3>
+      ${entries.join("\n")}
+    </div>`;
+}
+function progressBarHtml(pct) {
+  const filled = Math.round(Math.max(0, Math.min(100, pct)) / 10);
+  const empty = 10 - filled;
+  return `<span class="progress-bar-inline">${"\u2588".repeat(filled)}${"\u2591".repeat(empty)}</span>`;
 }
 
-// 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;
+// src/web/persona-views.ts
+var VIEWS = /* @__PURE__ */ new Map();
+var PAGE_RENDERERS = /* @__PURE__ */ new Map();
+function registerPersonaView(config2) {
+  VIEWS.set(config2.shortName, config2);
 }
-function mermaidBlock(definition, extraClass) {
-  const cls = ["mermaid-container", extraClass].filter(Boolean).join(" ");
-  return `<div class="${cls}"><pre class="mermaid">
-${definition}
-</pre></div>`;
+function registerPersonaPage(persona, pageId, renderer) {
+  PAGE_RENDERERS.set(`${persona}/${pageId}`, renderer);
 }
-function placeholder(message) {
-  return `<div class="mermaid-container mermaid-empty"><p>${message}</p></div>`;
+function getPersonaView(mode) {
+  if (!mode) return void 0;
+  return VIEWS.get(mode);
 }
-function toMs(date5) {
-  return (/* @__PURE__ */ new Date(date5 + "T00:00:00")).getTime();
+function getPersonaPageRenderer(persona, pageId) {
+  return PAGE_RENDERERS.get(`${persona}/${pageId}`);
 }
-function fmtDate(ms) {
-  const d = new Date(ms);
-  const months = ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"];
-  return `${months[d.getMonth()]} ${d.getDate()}`;
+function getAllPersonaViews() {
+  return [...VIEWS.values()];
 }
-function buildTimelineGantt(data, maxSprints = 6) {
-  const sprintsWithDates = data.sprints.filter((s) => s.startDate && s.endDate).sort((a, b) => a.startDate < b.startDate ? -1 : 1);
-  if (sprintsWithDates.length === 0) {
-    return placeholder("No timeline data available \u2014 sprints need start and end dates.");
-  }
-  const truncated = sprintsWithDates.length > maxSprints;
-  const visibleSprints = truncated ? sprintsWithDates.slice(-maxSprints) : sprintsWithDates;
-  const hiddenCount = sprintsWithDates.length - visibleSprints.length;
-  const epicMap = new Map(data.epics.map((e) => [e.id, e]));
-  const allStarts = visibleSprints.map((s) => toMs(s.startDate));
-  const allEnds = visibleSprints.map((s) => toMs(s.endDate));
-  const timelineStart = Math.min(...allStarts);
-  const timelineEnd = Math.max(...allEnds);
-  const span = timelineEnd - timelineStart || 1;
-  const pct = (ms) => (ms - timelineStart) / span * 100;
-  const DAY = 864e5;
-  const markers = [];
-  let tick = timelineStart;
-  const startDay = new Date(tick).getDay();
-  tick += (8 - startDay) % 7 * DAY;
-  while (tick <= timelineEnd) {
-    const left = pct(tick);
-    markers.push(
-      `<div class="gantt-marker" style="left:${left.toFixed(2)}%"><span>${fmtDate(tick)}</span></div>`
-    );
-    tick += 7 * DAY;
-  }
-  const gridLines = [];
-  let gridTick = timelineStart;
-  const gridStartDay = new Date(gridTick).getDay();
-  gridTick += (8 - gridStartDay) % 7 * DAY;
-  while (gridTick <= timelineEnd) {
-    gridLines.push(`<div class="gantt-grid-line" style="left:${pct(gridTick).toFixed(2)}%"></div>`);
-    gridTick += 7 * DAY;
-  }
-  const sprintBoundaries = /* @__PURE__ */ new Set();
-  for (const sprint of visibleSprints) {
-    sprintBoundaries.add(toMs(sprint.startDate));
-    sprintBoundaries.add(toMs(sprint.endDate));
-  }
-  const sprintLines = [...sprintBoundaries].map(
-    (ms) => `<div class="gantt-sprint-line" style="left:${pct(ms).toFixed(2)}%"></div>`
-  );
-  const now = Date.now();
-  let todayMarker = "";
-  if (now >= timelineStart && now <= timelineEnd) {
-    todayMarker = `<div class="gantt-today" style="left:${pct(now).toFixed(2)}%"></div>`;
-  }
-  const sprintBlocks = visibleSprints.map((sprint) => {
-    const sStart = toMs(sprint.startDate);
-    const sEnd = toMs(sprint.endDate);
-    const left = pct(sStart).toFixed(2);
-    const width = (pct(sEnd) - pct(sStart)).toFixed(2);
-    return `<div class="gantt-sprint-block" style="left:${left}%;width:${width}%">${sanitize(sprint.id, 20)}</div>`;
-  }).join("");
-  const sprintBandRow = `<div class="gantt-row gantt-sprint-band-row">
-      <div class="gantt-label gantt-section-label">Sprints</div>
-      <div class="gantt-track gantt-sprint-band">${sprintBlocks}</div>
-    </div>`;
-  const epicSpanMap = /* @__PURE__ */ new Map();
-  for (const sprint of visibleSprints) {
-    const sStart = toMs(sprint.startDate);
-    const sEnd = toMs(sprint.endDate);
-    for (const eid of sprint.linkedEpics) {
-      if (!epicMap.has(eid)) continue;
-      const existing = epicSpanMap.get(eid);
-      if (existing) {
-        existing.startMs = Math.min(existing.startMs, sStart);
-        existing.endMs = Math.max(existing.endMs, sEnd);
-      } else {
-        epicSpanMap.set(eid, { startMs: sStart, endMs: sEnd });
-      }
-    }
-  }
-  const sortedEpicIds = [...epicSpanMap.keys()].sort((a, b) => {
-    const aSpan = epicSpanMap.get(a);
-    const bSpan = epicSpanMap.get(b);
-    if (aSpan.startMs !== bSpan.startMs) return aSpan.startMs - bSpan.startMs;
-    return a.localeCompare(b);
-  });
-  const epicRows = sortedEpicIds.map((eid) => {
-    const epic = epicMap.get(eid);
-    const { startMs, endMs } = epicSpanMap.get(eid);
-    const cls = epic.status === "done" || epic.status === "completed" ? "gantt-bar-done" : epic.status === "in-progress" || epic.status === "active" ? "gantt-bar-active" : epic.status === "blocked" ? "gantt-bar-blocked" : "gantt-bar-default";
-    const left = pct(startMs).toFixed(2);
-    const width = (pct(endMs) - pct(startMs)).toFixed(2);
-    const label = sanitize(epic.id + " " + epic.title);
-    return `<div class="gantt-row">
-        <div class="gantt-label">${label}</div>
-        <div class="gantt-track">
-          <div class="gantt-bar ${cls}" style="left:${left}%;width:${width}%"></div>
-        </div>
-      </div>`;
-  }).join("\n");
-  const note = truncated ? `<div class="mermaid-note">${hiddenCount} earlier sprint${hiddenCount > 1 ? "s" : ""} not shown</div>` : "";
-  return `${note}
-    <div class="gantt">
-      <div class="gantt-chart">
-        <div class="gantt-header">
-          <div class="gantt-label"></div>
-          <div class="gantt-track gantt-dates">${markers.join("")}</div>
-        </div>
-        ${sprintBandRow}
-        ${epicRows}
-      </div>
-      <div class="gantt-overlay">
-        <div class="gantt-label"></div>
-        <div class="gantt-track">${gridLines.join("")}${sprintLines.join("")}${todayMarker}</div>
+var VALID_PERSONAS = /* @__PURE__ */ new Set(["po", "dm", "tl"]);
+function parsePersonaFromUrl(params) {
+  const value = params.get("persona")?.toLowerCase();
+  if (value && VALID_PERSONAS.has(value)) return value;
+  return null;
+}
+function parsePersonaFromPath(pathname) {
+  const match = pathname.match(/^\/(po|dm|tl)(?:\/|$)/);
+  return match ? match[1] : null;
+}
+function resolvePersona(pathname, params) {
+  return parsePersonaFromPath(pathname) ?? parsePersonaFromUrl(params);
+}
+var SHARED_NAV_ITEMS = [
+  { pageId: "timeline", label: "Timeline" },
+  { pageId: "board", label: "Board" },
+  { pageId: "upcoming", label: "Upcoming" },
+  { pageId: "sprint-summary", label: "Sprint Summary" },
+  { pageId: "gar", label: "GAR Report" },
+  { pageId: "health", label: "Health" }
+];
+
+// src/web/templates/pages/persona-picker.ts
+function personaPickerPage() {
+  const views = getAllPersonaViews();
+  const cards = views.map(
+    (v) => `
+      <a href="/${v.shortName}/dashboard" class="persona-picker-card" style="--persona-card-accent: ${v.color}">
+        <div class="persona-picker-name">${escapeHtml(v.displayName)}</div>
+        <div class="persona-picker-desc">${escapeHtml(v.description)}</div>
+      </a>`
+  ).join("\n");
+  return `
+    <div class="persona-picker">
+      <h2>Choose Your View</h2>
+      <p class="persona-picker-subtitle">Select a role to see a curated dashboard with the pages most relevant to you.</p>
+      <div class="persona-picker-grid">
+        ${cards}
       </div>
     </div>`;
 }
-function statusClass(status) {
-  const s = status.toLowerCase();
-  if (s === "done" || s === "completed") return "flow-done";
-  if (s === "in-progress" || s === "active") return "flow-active";
-  if (s === "blocked") return "flow-blocked";
-  return "flow-default";
-}
-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 edges = [];
-  const epicsByFeature = /* @__PURE__ */ new Map();
-  for (const epic of data.epics) {
-    for (const fid of epic.linkedFeature) {
-      if (!epicsByFeature.has(fid)) epicsByFeature.set(fid, []);
-      epicsByFeature.get(fid).push(epic.id);
-      edges.push({ from: fid, to: epic.id });
+
+// src/reports/sprint-summary/risk-assessment.ts
+import { query as query3 } from "@anthropic-ai/claude-agent-sdk";
+var SYSTEM_PROMPT2 = `You are a delivery management assistant generating a data-driven risk assessment.
+
+IMPORTANT: All the data you need is provided in the user message below. Do NOT attempt to look up, search for, or request additional information. Analyze ONLY the data given and produce your assessment immediately.
+
+Produce a concise markdown assessment with these sections:
+
+## Status Assessment
+One-line verdict: is this risk actively being mitigated, stalled, or escalating?
+
+## Related Activity
+What actions, decisions, or contributions are connected to this risk? How are they progressing? Be specific \u2014 reference artifact IDs from the data provided.
+
+## Trajectory
+Based on the data (status of related items, time remaining, ownership), is this risk trending toward resolution or toward becoming a blocker? Explain your reasoning with concrete evidence.
+
+## Recommendation
+One concrete next step to move this risk toward resolution.
+
+Rules:
+- Reference artifact IDs, dates, owners, and statuses from the provided data
+- Keep the tone professional and direct
+- Do NOT speculate beyond what the data supports \u2014 if information is insufficient, say so explicitly
+- Do NOT ask for more information or say you will look things up \u2014 everything you need is in the prompt
+- Produce the full assessment text directly`;
+async function generateRiskAssessment(data, riskId, store) {
+  const risk = data.risks.find((r) => r.id === riskId);
+  if (!risk) return "Risk not found in sprint data.";
+  const prompt = buildSingleRiskPrompt(data, risk, store);
+  const result = query3({
+    prompt,
+    options: {
+      systemPrompt: SYSTEM_PROMPT2,
+      maxTurns: 1,
+      tools: [],
+      allowedTools: []
     }
-  }
-  const sprintsByEpic = /* @__PURE__ */ new Map();
-  for (const sprint of data.sprints) {
-    for (const eid of sprint.linkedEpics) {
-      if (!sprintsByEpic.has(eid)) sprintsByEpic.set(eid, []);
-      sprintsByEpic.get(eid).push(sprint.id);
-      edges.push({ from: eid, to: sprint.id });
+  });
+  for await (const msg of result) {
+    if (msg.type === "assistant") {
+      const text = msg.message.content.find(
+        (b) => b.type === "text"
+      );
+      if (text) return text.text;
     }
   }
-  const connectedFeatureIds = new Set(epicsByFeature.keys());
-  const connectedEpicIds = /* @__PURE__ */ new Set();
-  for (const ids of epicsByFeature.values()) ids.forEach((id) => connectedEpicIds.add(id));
-  for (const ids of sprintsByEpic.values()) ids.forEach(() => {
-  });
-  for (const eid of sprintsByEpic.keys()) connectedEpicIds.add(eid);
-  const connectedSprintIds = /* @__PURE__ */ new Set();
-  for (const ids of sprintsByEpic.values()) ids.forEach((id) => connectedSprintIds.add(id));
-  const features = data.features.filter((f) => connectedFeatureIds.has(f.id));
-  const epics = data.epics.filter((e) => connectedEpicIds.has(e.id));
-  const sprints = data.sprints.filter((s) => connectedSprintIds.has(s.id)).sort((a, b) => (a.startDate ?? "").localeCompare(b.startDate ?? ""));
-  if (features.length === 0 && epics.length === 0) {
-    return placeholder("No artifact relationships found \u2014 link epics to features and sprints.");
+  return "Unable to generate risk assessment.";
+}
+function buildSingleRiskPrompt(data, risk, store) {
+  const sections = [];
+  sections.push(`# Sprint: ${data.sprint.id} \u2014 ${data.sprint.title}`);
+  if (data.sprint.goal) sections.push(`Goal: ${data.sprint.goal}`);
+  sections.push(`Days remaining: ${data.timeline.daysRemaining} / ${data.timeline.totalDays}`);
+  sections.push(`Completion: ${data.workItems.completionPct}%`);
+  sections.push("");
+  const doc = store.get(risk.id);
+  sections.push(`# RISK: ${risk.id} \u2014 ${risk.title}`);
+  sections.push(`Type: ${risk.type}`);
+  if (doc) {
+    sections.push(`Status: ${doc.frontmatter.status}`);
+    if (doc.frontmatter.owner) sections.push(`Owner: ${doc.frontmatter.owner}`);
+    if (doc.frontmatter.assignee) sections.push(`Assignee: ${doc.frontmatter.assignee}`);
+    if (doc.frontmatter.priority) sections.push(`Priority: ${doc.frontmatter.priority}`);
+    if (doc.frontmatter.dueDate) sections.push(`Due date: ${doc.frontmatter.dueDate}`);
+    if (doc.frontmatter.created) sections.push(`Created: ${doc.frontmatter.created.slice(0, 10)}`);
+    const tags = doc.frontmatter.tags ?? [];
+    if (tags.length > 0) sections.push(`Tags: ${tags.join(", ")}`);
+    if (doc.content.trim()) {
+      sections.push(`
+Description:
+${doc.content.trim()}`);
+    }
+    const allDocs = store.list();
+    const relatedIds = /* @__PURE__ */ new Set();
+    for (const d of allDocs) {
+      if (d.frontmatter.aboutArtifact === risk.id) {
+        relatedIds.add(d.frontmatter.id);
+      }
+    }
+    const idPattern = /\b([A-Z]-\d{3,})\b/g;
+    let match;
+    while ((match = idPattern.exec(doc.content)) !== null) {
+      relatedIds.add(match[1]);
+    }
+    const significantTags = tags.filter(
+      (t) => !t.startsWith("sprint:") && !t.startsWith("focus:") && t !== "risk"
+    );
+    if (significantTags.length > 0) {
+      for (const d of allDocs) {
+        if (d.frontmatter.id === risk.id) continue;
+        const dTags = d.frontmatter.tags ?? [];
+        if (significantTags.some((t) => dTags.includes(t))) {
+          relatedIds.add(d.frontmatter.id);
+        }
+      }
+    }
+    const about = doc.frontmatter.aboutArtifact;
+    if (about) {
+      relatedIds.add(about);
+      for (const d of allDocs) {
+        if (d.frontmatter.aboutArtifact === about && d.frontmatter.id !== risk.id) {
+          relatedIds.add(d.frontmatter.id);
+        }
+      }
+    }
+    const relatedDocs = [...relatedIds].map((id) => store.get(id)).filter((d) => d != null).slice(0, 20);
+    if (relatedDocs.length > 0) {
+      sections.push(`
+## Related Documents (${relatedDocs.length})`);
+      for (const rd of relatedDocs) {
+        const owner = rd.frontmatter.owner ?? "unowned";
+        const summary = rd.content.trim().slice(0, 300);
+        sections.push(
+          `- ${rd.frontmatter.id} (${rd.frontmatter.type}) [${rd.frontmatter.status}] \u2014 ${rd.frontmatter.title}`
+        );
+        sections.push(`  Owner: ${owner}${rd.frontmatter.dueDate ? `, Due: ${rd.frontmatter.dueDate}` : ""}`);
+        if (summary) sections.push(`  Summary: ${summary}${rd.content.trim().length > 300 ? "..." : ""}`);
+      }
+    }
   }
-  const renderNode = (id, title, status, type) => `<div class="flow-node ${statusClass(status)}" data-flow-id="${id}">
-      <a class="flow-node-id" href="/docs/${type}/${id}">${id}</a>
-      <span class="flow-node-title">${sanitize(title, 35)}</span>
-    </div>`;
-  const featuresHtml = features.map((f) => renderNode(f.id, f.title, f.status, "feature")).join("\n");
-  const epicsHtml = epics.map((e) => renderNode(e.id, e.title, e.status, "epic")).join("\n");
-  const sprintsHtml = sprints.map((s) => renderNode(s.id, s.title, s.status, "sprint")).join("\n");
-  const edgesJson = JSON.stringify(edges);
-  return `
-    <div class="flow-diagram" id="flow-diagram">
-      <svg class="flow-lines" id="flow-lines"></svg>
-      <div class="flow-columns">
-        <div class="flow-column">
-          <div class="flow-column-header">Features</div>
-          ${featuresHtml}
-        </div>
-        <div class="flow-column">
-          <div class="flow-column-header">Epics</div>
-          ${epicsHtml}
-        </div>
-        <div class="flow-column">
-          <div class="flow-column-header">Sprints</div>
-          ${sprintsHtml}
-        </div>
-      </div>
-    </div>
-    <script>
-    (function() {
-      var edges = ${edgesJson};
-      var container = document.getElementById('flow-diagram');
-      var svg = document.getElementById('flow-lines');
-      if (!container || !svg) return;
-
-      // Build directed adjacency maps for traversal
-      var fwd = {};   // from \u2192 [to] (Feature\u2192Epic, Epic\u2192Sprint)
-      var bwd = {};   // to \u2192 [from] (Sprint\u2192Epic, Epic\u2192Feature)
-      edges.forEach(function(e) {
-        if (!fwd[e.from]) fwd[e.from] = [];
-        if (!bwd[e.to]) bwd[e.to] = [];
-        fwd[e.from].push(e.to);
-        bwd[e.to].push(e.from);
-      });
-
-      function drawLines() {
-        var rect = container.getBoundingClientRect();
-        var scrollW = container.scrollWidth;
-        var scrollH = container.scrollHeight;
-        svg.setAttribute('width', scrollW);
-        svg.setAttribute('height', scrollH);
-        svg.innerHTML = '';
+  sections.push("");
+  sections.push(`---`);
+  sections.push(`
+Generate the risk assessment for ${risk.id} based on the data above.`);
+  return sections.join("\n");
+}
 
-        // Use scroll offsets so lines align with scrolled content
-        var scrollLeft = container.scrollLeft;
-        var scrollTop = container.scrollTop;
+// src/personas/builtin/product-owner.ts
+var productOwner = {
+  id: "product-owner",
+  name: "Product Owner",
+  shortName: "po",
+  description: "Focuses on product vision, stakeholder needs, backlog prioritization, and value delivery.",
+  systemPrompt: `You are Marvin, acting as a **Product Owner**. Your role is to help the team maximize the value delivered by the product.
 
-        edges.forEach(function(edge) {
-          var fromEl = container.querySelector('[data-flow-id="' + edge.from + '"]');
-          var toEl = container.querySelector('[data-flow-id="' + edge.to + '"]');
-          if (!fromEl || !toEl) return;
+## Core Responsibilities
+- Define and communicate the product vision and strategy
+- Manage and prioritize the product backlog
+- Ensure stakeholder needs are understood and addressed
+- Make decisions about scope, priority, and trade-offs
+- Accept or reject work results based on acceptance criteria
 
-          var fr = fromEl.getBoundingClientRect();
-          var tr = toEl.getBoundingClientRect();
-          var x1 = fr.right - rect.left + scrollLeft;
-          var y1 = fr.top + fr.height / 2 - rect.top + scrollTop;
-          var x2 = tr.left - rect.left + scrollLeft;
-          var y2 = tr.top + tr.height / 2 - rect.top + scrollTop;
-          var mx = (x1 + x2) / 2;
+## How You Work
+- Ask clarifying questions to understand business value and user needs
+- Create and refine decisions (D-xxx) for important product choices
+- Track questions (Q-xxx) that need stakeholder input
+- Define acceptance criteria for features and deliverables
+- Prioritize actions (A-xxx) based on business value
 
-          var path = document.createElementNS('http://www.w3.org/2000/svg', 'path');
-          path.setAttribute('d', 'M' + x1 + ',' + y1 + ' C' + mx + ',' + y1 + ' ' + mx + ',' + y2 + ' ' + x2 + ',' + y2);
-          path.setAttribute('fill', 'none');
-          path.setAttribute('stroke', '#2a2e3a');
-          path.setAttribute('stroke-width', '1.5');
-          path.dataset.from = edge.from;
-          path.dataset.to = edge.to;
-          svg.appendChild(path);
-        });
-      }
+## Communication Style
+- Business-oriented language, avoid unnecessary technical jargon
+- Focus on outcomes and value, not implementation details
+- Be decisive but transparent about trade-offs
+- Challenge assumptions that don't align with product goals`,
+  focusAreas: [
+    "Product vision and strategy",
+    "Backlog management",
+    "Stakeholder communication",
+    "Value delivery",
+    "Acceptance criteria",
+    "Feature definition and prioritization"
+  ],
+  documentTypes: ["decision", "question", "action", "feature"],
+  contributionTypes: ["stakeholder-feedback", "acceptance-result", "priority-change", "market-insight"]
+};
 
-      // Find directly related nodes via directed traversal
-      // Follows forward edges (Feature\u2192Epic\u2192Sprint) and backward edges
-      // (Sprint\u2192Epic\u2192Feature) separately to avoid sideways expansion
-      function findConnected(startId) {
-        var visited = {};
-        visited[startId] = true;
-        // Traverse forward (from\u2192to direction)
-        var queue = [startId];
-        while (queue.length) {
-          var id = queue.shift();
-          (fwd[id] || []).forEach(function(neighbor) {
-            if (!visited[neighbor]) {
-              visited[neighbor] = true;
-              queue.push(neighbor);
-            }
-          });
-        }
-        // Traverse backward (to\u2192from direction)
-        queue = [startId];
-        while (queue.length) {
-          var id = queue.shift();
-          (bwd[id] || []).forEach(function(neighbor) {
-            if (!visited[neighbor]) {
-              visited[neighbor] = true;
-              queue.push(neighbor);
-            }
-          });
-        }
-        return visited;
-      }
+// src/personas/builtin/delivery-manager.ts
+var deliveryManager = {
+  id: "delivery-manager",
+  name: "Delivery Manager",
+  shortName: "dm",
+  description: "Focuses on project delivery, risk management, team coordination, and process governance.",
+  systemPrompt: `You are Marvin, acting as a **Delivery Manager**. Your role is to ensure the project is delivered on time, within scope, and with managed risks.
 
-      function highlight(hoveredId) {
-        var connected = findConnected(hoveredId);
-        container.querySelectorAll('.flow-node').forEach(function(n) {
-          if (connected[n.dataset.flowId]) {
-            n.classList.add('flow-lit');
-            n.classList.remove('flow-dim');
-          } else {
-            n.classList.add('flow-dim');
-            n.classList.remove('flow-lit');
-          }
-        });
-        svg.querySelectorAll('path').forEach(function(p) {
-          if (connected[p.dataset.from] && connected[p.dataset.to]) {
-            p.classList.add('flow-line-lit');
-            p.classList.remove('flow-line-dim');
-          } else {
-            p.classList.add('flow-line-dim');
-            p.classList.remove('flow-line-lit');
-          }
-        });
-      }
+## Core Responsibilities
+- Track project progress and identify blockers
+- Manage risks, issues, and dependencies
+- Coordinate between team members and stakeholders
+- Ensure governance processes are followed (decisions logged, actions tracked)
+- Facilitate meetings and ensure outcomes are captured
 
-      function clearHighlight() {
-        container.querySelectorAll('.flow-node').forEach(function(n) { n.classList.remove('flow-lit', 'flow-dim'); });
-        svg.querySelectorAll('path').forEach(function(p) { p.classList.remove('flow-line-lit', 'flow-line-dim'); });
-      }
+## 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
+- Create meeting notes and ensure action items are assigned
 
-      var activeId = null;
-      container.addEventListener('click', function(e) {
-        // Let the ID link navigate normally
-        if (e.target.closest('a')) return;
+## Communication Style
+- Process-oriented but pragmatic
+- Focus on status, risks, and blockers
+- Be proactive about follow-ups and deadlines
+- Keep stakeholders informed with concise updates`,
+  focusAreas: [
+    "Project delivery",
+    "Risk management",
+    "Team coordination",
+    "Process governance",
+    "Status tracking",
+    "Epic scheduling and tracking",
+    "Sprint planning and tracking"
+  ],
+  documentTypes: ["action", "decision", "meeting", "question", "feature", "epic", "task", "sprint"],
+  contributionTypes: ["risk-finding", "blocker-report", "dependency-update", "status-assessment"]
+};
 
-        var node = e.target.closest('.flow-node');
-        var clickedId = node ? node.dataset.flowId : null;
+// src/personas/builtin/tech-lead.ts
+var techLead = {
+  id: "tech-lead",
+  name: "Technical Lead",
+  shortName: "tl",
+  description: "Focuses on technical architecture, code quality, technical decisions, and implementation guidance.",
+  systemPrompt: `You are Marvin, acting as a **Technical Lead**. Your role is to guide the team on technical decisions and ensure high-quality implementation.
 
-        if (!clickedId || clickedId === activeId) {
-          activeId = null;
-          clearHighlight();
-          return;
-        }
+## Core Responsibilities
+- Define and maintain technical architecture
+- Make and document technical decisions with clear rationale
+- Review technical approaches and identify potential issues
+- Guide the team on best practices and patterns
+- Evaluate technical risks and propose mitigations
 
-        activeId = clickedId;
-        highlight(clickedId);
-      });
+## How You Work
+- Create decisions (D-xxx) for significant technical choices (framework, architecture, patterns)
+- Document technical questions (Q-xxx) that need investigation or proof-of-concept
+- Define technical actions (A-xxx) for implementation tasks
+- Consider non-functional requirements (performance, security, maintainability)
+- Provide clear technical guidance with examples when helpful
 
-      function drawAndHighlight() {
-        drawLines();
-        if (activeId) highlight(activeId);
-      }
+## Communication Style
+- Technical but accessible \u2014 explain complex concepts clearly
+- Evidence-based decision making with documented trade-offs
+- Pragmatic about technical debt vs. delivery speed
+- Focus on maintainability and long-term sustainability`,
+  focusAreas: [
+    "Technical architecture",
+    "Code quality",
+    "Technical decisions",
+    "Implementation guidance",
+    "Non-functional requirements",
+    "Epic creation and scoping",
+    "Task creation and breakdown",
+    "Sprint scoping and technical execution"
+  ],
+  documentTypes: ["decision", "action", "question", "epic", "task", "sprint"],
+  contributionTypes: ["action-result", "spike-findings", "technical-assessment", "architecture-review"]
+};
 
-      requestAnimationFrame(function() { setTimeout(drawAndHighlight, 100); });
-      window.addEventListener('resize', drawAndHighlight);
-      container.addEventListener('scroll', drawAndHighlight);
-      new ResizeObserver(drawAndHighlight).observe(container);
-    })();
-    </script>`;
+// src/personas/registry.ts
+var BUILTIN_PERSONAS = [
+  productOwner,
+  deliveryManager,
+  techLead
+];
+function getPersona(idOrShortName) {
+  const key = idOrShortName.toLowerCase();
+  return BUILTIN_PERSONAS.find(
+    (p) => p.id === key || p.shortName === key
+  );
 }
-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 listPersonas() {
+  return [...BUILTIN_PERSONAS];
 }
-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/persona-switcher.ts
+function renderPersonaSwitcher(current, _currentPath) {
+  const views = getAllPersonaViews();
+  if (views.length === 0) return "";
+  const options = views.map(
+    (v) => `<option value="${v.shortName}"${current === v.shortName ? " selected" : ""}>${escapeHtml(v.displayName)}</option>`
+  ).join("\n          ");
+  return `
+    <div class="persona-switcher">
+      <label class="persona-label" for="persona-select">View</label>
+      <select class="persona-select" id="persona-select" onchange="switchPersona(this.value)">
+          ${options}
+      </select>
+    </div>
+    <script>
+      function switchPersona(value) {
+        if (value) {
+          window.location.href = '/' + value + '/dashboard';
+        }
+      }
+    </script>`;
 }
 
 // src/web/templates/pages/po/dashboard.ts
@@ -28933,7 +29437,7 @@ function handleRequest(req, res, store, projectName, navGroups) {
         notFound(res, projectName, navGroups, pathname, persona, pOpts);
         return;
       }
-      const body = documentDetailPage(doc);
+      const body = documentDetailPage(doc, store);
       respond(res, layout({ title: `${id} \u2014 ${doc.frontmatter.title}`, activePath: `/docs/${type}`, projectName, navGroups, persona, ...pOpts }, body));
       return;
     }