mrvn-cli 0.5.24 → 0.5.26

package/dist/marvin.js

@@ -15170,6 +15170,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"]);
@@ -19522,8 +19737,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;
@@ -20235,6 +20472,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;
@@ -20469,6 +20775,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;
@@ -21395,282 +21760,27 @@ 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);
-}
-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>`;
-}
-
-// src/reports/sprint-summary/risk-assessment.ts
-import { query as query2 } 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 = query2({
-    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/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/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 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 buildTimelineGantt(data, maxSprints = 6) {
   const sprintsWithDates = data.sprints.filter((s) => s.startDate && s.endDate).sort((a, b) => a.startDate < b.startDate ? -1 : 1);
@@ -21880,145 +21990,705 @@ function buildArtifactFlowchart(data) {
         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;
+        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);
+        });
+      }
+
+      // 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;
+      }
+
+      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) {
+        // 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);
+      }
+
+      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}.`);
+  }
+  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;
+
+      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;
+      }
+
+      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>`;
+}
+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>
+
+    ${doc.content.trim() ? `<div class="detail-content">${renderMarkdown(doc.content)}</div>` : ""}
+
+    ${timelineHtml}
+
+    ${store ? renderRelationshipsAndLineage(store, fm.id) : ""}
+  `;
+}
+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");
+}
+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>`;
+}
+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="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>`;
+}
+
+// src/reports/sprint-summary/risk-assessment.ts
+import { query as query2 } 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.
 
-          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 = query2({
+    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);
       }
-
-      // 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);
-            }
-          });
+    }
+    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);
         }
-        return visited;
       }
-
-      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 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);
+        }
       }
-
-      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 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");
+}
 
-      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;
+// 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';
         }
-
-        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 buildStatusPie(title, counts) {
-  const entries = Object.entries(counts).filter(([, v]) => v > 0);
-  if (entries.length === 0) {
-    return placeholder(`No data for ${title}.`);
-  }
-  const lines = [`pie title ${sanitize(title, 60)}`];
-  for (const [label, count] of entries) {
-    lines.push(`  "${sanitize(label, 30)}" : ${count}`);
-  }
-  return mermaidBlock(lines.join("\n"));
-}
-function buildHealthGauge(categories) {
-  const valid = categories.filter((c) => c.total > 0);
-  if (valid.length === 0) {
-    return placeholder("No completeness data available.");
-  }
-  const pies = valid.map((cat) => {
-    const incomplete = cat.total - cat.complete;
-    const lines = [
-      `pie title ${sanitize(cat.name, 30)}`,
-      `  "Complete" : ${cat.complete}`,
-      `  "Incomplete" : ${incomplete}`
-    ];
-    return mermaidBlock(lines.join("\n"));
-  });
-  return `<div class="mermaid-row">${pies.join("\n")}</div>`;
-}
 
 // src/web/templates/pages/po/dashboard.ts
 var DONE_STATUSES5 = /* @__PURE__ */ new Set(["done", "closed", "resolved", "cancelled"]);
@@ -25152,7 +25822,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;
     }
@@ -27052,20 +27722,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 {
@@ -33661,7 +34349,7 @@ function createProgram() {
   const program2 = new Command();
   program2.name("marvin").description(
     "AI-powered product development assistant with Product Owner, Delivery Manager, and Technical Lead personas"
-  ).version("0.5.24");
+  ).version("0.5.26");
   program2.command("init").description("Initialize a new Marvin project in the current directory").action(async () => {
     await initCommand();
   });