mrvn-cli 0.5.24 → 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"]);
@@ -20841,20 +21056,38 @@ async function _assessArtifactRecursive(store, client, host, options, visited, d
     }
   }
   if (options.applyUpdates) {
-    const assessmentSummary = buildAssessmentSummary(
+    const newEntry = buildAssessmentSummary(
       commentSummary,
       commentAnalysisProgress,
       signals,
       children,
       linkedIssues
     );
+    const existingHistory = Array.isArray(fm.assessmentHistory) ? fm.assessmentHistory : [];
+    const legacySummary = fm.assessmentSummary;
+    const allEntries = [newEntry, ...existingHistory];
+    if (legacySummary?.generatedAt) {
+      allEntries.push(legacySummary);
+    }
+    const MAX_HISTORY = 100;
+    const seen = /* @__PURE__ */ new Set();
+    const assessmentHistory = allEntries.filter((entry) => {
+      if (!entry.generatedAt) return false;
+      if (seen.has(entry.generatedAt)) return false;
+      seen.add(entry.generatedAt);
+      return true;
+    }).sort((a, b) => (b.generatedAt ?? "").localeCompare(a.generatedAt ?? "")).slice(0, MAX_HISTORY);
     try {
-      store.update(fm.id, {
-        assessmentSummary,
-        lastAssessedAt: assessmentSummary.generatedAt
-      });
+      const payload = {
+        assessmentHistory,
+        lastAssessedAt: newEntry.generatedAt
+      };
+      if (fm.assessmentSummary !== void 0) {
+        payload.assessmentSummary = void 0;
+      }
+      store.update(fm.id, payload);
     } catch (err) {
-      errors.push(`Failed to persist assessment summary: ${err instanceof Error ? err.message : String(err)}`);
+      errors.push(`Failed to persist assessment history: ${err instanceof Error ? err.message : String(err)}`);
     }
   }
   return {
@@ -22981,8 +23214,30 @@ function inline(text) {
   s = s.replace(/__([^_]+)__/g, "<strong>$1</strong>");
   s = s.replace(/\*([^*]+)\*/g, "<em>$1</em>");
   s = s.replace(/_([^_]+)_/g, "<em>$1</em>");
+  s = linkArtifactIds(s);
   return s;
 }
+var ID_PREFIX_TO_TYPE = (() => {
+  const entries = [];
+  for (const [type, prefix] of Object.entries(CORE_ID_PREFIXES)) {
+    entries.push([prefix, type]);
+  }
+  for (const reg of COMMON_REGISTRATIONS) {
+    if (!entries.some(([p]) => p === reg.idPrefix)) {
+      entries.push([reg.idPrefix, reg.type]);
+    }
+  }
+  entries.sort((a, b) => b[0].length - a[0].length);
+  return new Map(entries);
+})();
+function linkArtifactIds(html) {
+  return html.replace(/\b([A-Z]{1,3})-(\d{3,})\b/g, (match, prefix, num) => {
+    const type = ID_PREFIX_TO_TYPE.get(prefix);
+    if (!type) return match;
+    const id = `${prefix}-${num}`;
+    return `<a href="/docs/${type}/${id}" class="artifact-link">${match}</a>`;
+  });
+}
 function layout(opts, body) {
   const switcherHtml = opts.personaSwitcherHtml ?? "";
   let navHtml;
@@ -23694,6 +23949,75 @@ tr:hover td {
   margin: 0.75rem 0;
 }
 
+/* Artifact cross-links */
+a.artifact-link {
+  color: var(--accent);
+  text-decoration: none;
+  font-weight: 500;
+  border-bottom: 1px dotted var(--accent);
+}
+a.artifact-link:hover {
+  border-bottom-style: solid;
+}
+
+/* Assessment timeline */
+.assessment-timeline {
+  margin-top: 1.5rem;
+}
+.assessment-timeline h3 {
+  font-size: 1rem;
+  font-weight: 600;
+  margin-bottom: 0.75rem;
+}
+.assessment-entry {
+  background: var(--bg-card);
+  border: 1px solid var(--border);
+  border-radius: var(--radius);
+  padding: 0.75rem 1rem;
+  margin-bottom: 0.75rem;
+}
+.assessment-entry.assessment-latest {
+  border-left: 3px solid var(--accent);
+}
+.assessment-header {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+  margin-bottom: 0.5rem;
+}
+.assessment-date {
+  font-size: 0.8rem;
+  color: var(--text-dim);
+  font-family: var(--mono);
+}
+.assessment-comment {
+  font-size: 0.875rem;
+  line-height: 1.6;
+  margin-bottom: 0.5rem;
+}
+.assessment-stat {
+  font-size: 0.8rem;
+  color: var(--text-dim);
+  margin-bottom: 0.25rem;
+}
+.assessment-stat strong {
+  color: var(--text);
+}
+.assessment-signals {
+  list-style: none;
+  padding: 0;
+  margin: 0.5rem 0 0;
+}
+.assessment-signals li {
+  font-size: 0.8rem;
+  padding: 0.15rem 0;
+}
+.progress-bar-inline {
+  font-family: var(--mono);
+  font-size: 0.75rem;
+  letter-spacing: -0.5px;
+}
+
 /* Filters */
 .filters {
   display: flex;
@@ -23928,6 +24252,65 @@ tr:hover td {
 .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;
@@ -24854,767 +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"]);
-  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)}${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>` : ""}
-  `;
-}
-
-// 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 registerPersonaPage(persona, pageId, renderer) {
-  PAGE_RENDERERS.set(`${persona}/${pageId}`, renderer);
-}
-function getPersonaView(mode) {
-  if (!mode) return void 0;
-  return VIEWS.get(mode);
-}
-function getPersonaPageRenderer(persona, pageId) {
-  return PAGE_RENDERERS.get(`${persona}/${pageId}`);
+// 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 getAllPersonaViews() {
-  return [...VIEWS.values()];
+function mermaidBlock(definition, extraClass) {
+  const cls = ["mermaid-container", extraClass].filter(Boolean).join(" ");
+  return `<div class="${cls}"><pre class="mermaid">
+${definition}
+</pre></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 placeholder(message) {
+  return `<div class="mermaid-container mermaid-empty"><p>${message}</p></div>`;
 }
-function parsePersonaFromPath(pathname) {
-  const match = pathname.match(/^\/(po|dm|tl)(?:\/|$)/);
-  return match ? match[1] : null;
+function toMs(date5) {
+  return (/* @__PURE__ */ new Date(date5 + "T00:00:00")).getTime();
 }
-function resolvePersona(pathname, params) {
-  return parsePersonaFromPath(pathname) ?? parsePersonaFromUrl(params);
+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()}`;
 }
-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}
+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 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 });
+    }
+  }
+  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="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;
 
-// 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.
+      // 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);
+      });
 
-Produce a concise markdown assessment with these sections:
+      function drawLines() {
+        var rect = container.getBoundingClientRect();
+        var scrollW = container.scrollWidth;
+        var scrollH = container.scrollHeight;
+        svg.setAttribute('width', scrollW);
+        svg.setAttribute('height', scrollH);
+        svg.innerHTML = '';
 
-## Status Assessment
-One-line verdict: is this risk actively being mitigated, stalled, or escalating?
+        // Use scroll offsets so lines align with scrolled content
+        var scrollLeft = container.scrollLeft;
+        var scrollTop = container.scrollTop;
 
-## 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.
+        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;
 
-## 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 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;
 
-## Recommendation
-One concrete next step to move this risk toward resolution.
+          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);
+        });
+      }
 
-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);
-      }
-    }
-    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);
+      // 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);
+            }
+          });
         }
-      }
-    }
-    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);
+        // 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;
       }
-    }
-    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 ? "..." : ""}`);
-      }
-    }
-  }
-  sections.push("");
-  sections.push(`---`);
-  sections.push(`
-Generate the risk assessment for ${risk.id} based on the data above.`);
-  return sections.join("\n");
-}
-
-// 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.
-
-## 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
 
-## 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
+      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');
+          }
+        });
+      }
 
-## 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"]
-};
+      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'); });
+      }
 
-// 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 activeId = null;
+      container.addEventListener('click', function(e) {
+        // Let the ID link navigate normally
+        if (e.target.closest('a')) return;
 
-## 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 node = e.target.closest('.flow-node');
+        var clickedId = node ? node.dataset.flowId : null;
 
-## 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
+        if (!clickedId || clickedId === activeId) {
+          activeId = null;
+          clearHighlight();
+          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"]
-};
+        activeId = clickedId;
+        highlight(clickedId);
+      });
 
-// 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 drawAndHighlight() {
+        drawLines();
+        if (activeId) highlight(activeId);
+      }
 
-## 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
-
-## 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
-
-## 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"]
-};
-
-// 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
-  );
+      requestAnimationFrame(function() { setTimeout(drawAndHighlight, 100); });
+      window.addEventListener('resize', drawAndHighlight);
+      container.addEventListener('scroll', drawAndHighlight);
+      new ResizeObserver(drawAndHighlight).observe(container);
+    })();
+    </script>`;
 }
-function listPersonas() {
-  return [...BUILTIN_PERSONAS];
+function buildStatusPie(title, counts) {
+  const entries = Object.entries(counts).filter(([, v]) => v > 0);
+  if (entries.length === 0) {
+    return placeholder(`No data for ${title}.`);
+  }
+  const lines = [`pie title ${sanitize(title, 60)}`];
+  for (const [label, count] of entries) {
+    lines.push(`  "${sanitize(label, 30)}" : ${count}`);
+  }
+  return mermaidBlock(lines.join("\n"));
+}
+function buildHealthGauge(categories) {
+  const valid = categories.filter((c) => c.total > 0);
+  if (valid.length === 0) {
+    return placeholder("No completeness data available.");
+  }
+  const pies = valid.map((cat) => {
+    const incomplete = cat.total - cat.complete;
+    const lines = [
+      `pie title ${sanitize(cat.name, 30)}`,
+      `  "Complete" : ${cat.complete}`,
+      `  "Incomplete" : ${incomplete}`
+    ];
+    return mermaidBlock(lines.join("\n"));
+  });
+  return `<div class="mermaid-row">${pies.join("\n")}</div>`;
 }
 
-// src/web/templates/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          ");
+// 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="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 class="flow-diagram" id="rel-graph">
+      <svg class="flow-lines" id="rel-lines"></svg>
+      <div class="flow-columns">
+        ${columnsHtml}
+      </div>
     </div>
     <script>
-      function switchPersona(value) {
-        if (value) {
-          window.location.href = '/' + value + '/dashboard';
+    (function() {
+      var edges = ${edgesJson};
+      var container = document.getElementById('rel-graph');
+      var svg = document.getElementById('rel-lines');
+      if (!container || !svg) return;
+
+      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);
+      });
+
+      function drawLines() {
+        var rect = container.getBoundingClientRect();
+        var scrollW = container.scrollWidth;
+        var scrollH = container.scrollHeight;
+        svg.setAttribute('width', scrollW);
+        svg.setAttribute('height', scrollH);
+        svg.innerHTML = '';
+
+        var scrollLeft = container.scrollLeft;
+        var scrollTop = container.scrollTop;
+
+        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;
+
+          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;
+
+          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);
+        });
+      }
+
+      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;
       }
-    </script>`;
-}
 
-// src/web/templates/mermaid.ts
-function sanitize(text, maxLen = 40) {
-  const cleaned = text.replace(/["'`]/g, "").replace(/[\r\n]+/g, " ");
-  return cleaned.length > maxLen ? cleaned.slice(0, maxLen - 1) + "\u2026" : cleaned;
-}
-function mermaidBlock(definition, extraClass) {
-  const cls = ["mermaid-container", extraClass].filter(Boolean).join(" ");
-  return `<div class="${cls}"><pre class="mermaid">
-${definition}
-</pre></div>`;
-}
-function placeholder(message) {
-  return `<div class="mermaid-container mermaid-empty"><p>${message}</p></div>`;
-}
-function toMs(date5) {
-  return (/* @__PURE__ */ new Date(date5 + "T00:00:00")).getTime();
-}
-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 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');
+          }
+        });
+      }
+
+      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'); });
+      }
+
+      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);
+      });
+
+      function drawAndHighlight() {
+        drawLines();
+        if (activeId) highlight(activeId);
+      }
+
+      requestAnimationFrame(function() { setTimeout(drawAndHighlight, 100); });
+      window.addEventListener('resize', drawAndHighlight);
+      container.addEventListener('scroll', drawAndHighlight);
+      new ResizeObserver(drawAndHighlight).observe(container);
+    })();
+    </script>`;
 }
-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.");
+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 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>
+  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>`;
-  }).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>
+  });
+  return `
+    <div class="lineage-timeline">
+      <h3>Lineage</h3>
+      ${entries.join("\n")}
     </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";
+
+// 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>
+
+    ${doc.content.trim() ? `<div class="detail-content">${renderMarkdown(doc.content)}</div>` : ""}
+
+    ${timelineHtml}
+
+    ${store ? renderRelationshipsAndLineage(store, fm.id) : ""}
+  `;
 }
-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.");
+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 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 events = getArtifactLineageEvents(store, docId);
+  if (events.length > 0) {
+    const lineageHtml = buildLineageTimeline(events);
+    parts.push(collapsibleSection("lineage-" + docId, "Lineage", lineageHtml, { defaultCollapsed: true }));
   }
-  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 });
+  return parts.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>`);
     }
-  }
-  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(() => {
+    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>`;
   });
-  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>
+  return `
+    <div class="assessment-timeline">
+      <h3>Assessment History</h3>
+      ${entries.join("\n")}
     </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);
+}
+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/persona-views.ts
+var VIEWS = /* @__PURE__ */ new Map();
+var PAGE_RENDERERS = /* @__PURE__ */ new Map();
+function registerPersonaView(config2) {
+  VIEWS.set(config2.shortName, config2);
+}
+function registerPersonaPage(persona, pageId, renderer) {
+  PAGE_RENDERERS.set(`${persona}/${pageId}`, renderer);
+}
+function getPersonaView(mode) {
+  if (!mode) return void 0;
+  return VIEWS.get(mode);
+}
+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 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="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 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>
-    <script>
-    (function() {
-      var edges = ${edgesJson};
-      var container = document.getElementById('flow-diagram');
-      var svg = document.getElementById('flow-lines');
-      if (!container || !svg) return;
+    </div>`;
+}
 
-      // 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);
-      });
+// 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.
 
-      function drawLines() {
-        var rect = container.getBoundingClientRect();
-        var scrollW = container.scrollWidth;
-        var scrollH = container.scrollHeight;
-        svg.setAttribute('width', scrollW);
-        svg.setAttribute('height', scrollH);
-        svg.innerHTML = '';
+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.
 
-        // Use scroll offsets so lines align with scrolled content
-        var scrollLeft = container.scrollLeft;
-        var scrollTop = container.scrollTop;
+Produce a concise markdown assessment with these sections:
 
-        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;
+## 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: []
+    }
+  });
+  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);
+      }
+    }
+    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 ? "..." : ""}`);
+      }
+    }
+  }
+  sections.push("");
+  sections.push(`---`);
+  sections.push(`
+Generate the risk assessment for ${risk.id} based on the data above.`);
+  return sections.join("\n");
+}
+
+// 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.
+
+## 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
@@ -28749,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;
     }