mrvn-cli 0.5.25 → 0.5.27

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"]);
@@ -20560,6 +20775,65 @@ a.artifact-link:hover {
 .flow-line-lit { stroke: var(--accent) !important; stroke-width: 2 !important; }
 .flow-line-dim { opacity: 0.08; }
 
+/* Relationship graph: self-node emphasis */
+.flow-self {
+  border-left-width: 4px;
+  background: var(--bg-hover);
+  box-shadow: 0 0 0 1px var(--accent-dim);
+}
+.flow-self .flow-node-id {
+  color: var(--accent);
+  font-weight: 600;
+}
+
+/* Relationship graph: external nodes */
+.flow-external {
+  border-left-color: var(--text-dim);
+  border-left-style: dashed;
+}
+
+/* Relationship graph: empty state */
+.flow-empty {
+  padding: 2rem;
+  text-align: center;
+  color: var(--text-dim);
+  font-size: 0.85rem;
+}
+
+/* Lineage timeline */
+.lineage-timeline {
+  margin-top: 1.5rem;
+}
+.lineage-timeline h3 {
+  font-size: 1rem;
+  font-weight: 600;
+  margin-bottom: 0.75rem;
+}
+.lineage-entry {
+  display: flex;
+  gap: 0.5rem;
+  padding: 0.4rem 0;
+  padding-left: 0.25rem;
+}
+.lineage-marker {
+  flex-shrink: 0;
+  font-size: 0.7rem;
+  line-height: 1.4rem;
+}
+.lineage-content {
+  display: flex;
+  flex-direction: column;
+  gap: 0.1rem;
+}
+.lineage-date {
+  font-size: 0.7rem;
+  color: var(--text-dim);
+  font-family: var(--mono);
+}
+.lineage-label {
+  font-size: 0.85rem;
+}
+
 /* Gantt truncation note */
 .mermaid-note {
   font-size: 0.75rem;
@@ -21486,357 +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", "assessmentHistory", "assessmentSummary"]);
-  const entries = Object.entries(fm).filter(
-    ([key, value]) => !skipKeys.has(key) && value != null && typeof value !== "object"
-  );
-  const arrayEntries = Object.entries(fm).filter(
-    ([key, value]) => !skipKeys.has(key) && Array.isArray(value) && value.every((v) => typeof v === "string")
-  );
-  const allEntries = [
-    ...entries.filter(([, v]) => !Array.isArray(v)),
-    ...arrayEntries
-  ];
-  const dtDd = allEntries.map(([key, value]) => {
-    let rendered;
-    if (key === "status") {
-      rendered = statusBadge(value);
-    } else if (key === "tags" && Array.isArray(value)) {
-      rendered = value.map((t) => `<span class="badge badge-default">${escapeHtml(t)}</span>`).join(" ");
-    } else if (key === "created" || key === "updated" || key === "lastAssessedAt" || key === "lastJiraSyncAt") {
-      rendered = formatDate(value);
-    } else {
-      rendered = linkArtifactIds(escapeHtml(String(value)));
-    }
-    return `<dt>${escapeHtml(key)}</dt><dd>${rendered}</dd>`;
-  }).join("\n        ");
-  const rawHistory = Array.isArray(fm.assessmentHistory) ? fm.assessmentHistory : fm.assessmentSummary && typeof fm.assessmentSummary === "object" ? [fm.assessmentSummary] : [];
-  const assessmentHistory = rawHistory.filter(isValidAssessmentEntry).sort((a, b) => (b.generatedAt ?? "").localeCompare(a.generatedAt ?? ""));
-  const timelineHtml = assessmentHistory.length > 0 ? renderAssessmentTimeline(assessmentHistory) : "";
-  return `
-    <div class="breadcrumb">
-      <a href="/">Overview</a><span class="sep">/</span>
-      <a href="/docs/${fm.type}">${escapeHtml(label)}s</a><span class="sep">/</span>
-      ${escapeHtml(fm.id)}
-    </div>
-
-    <div class="page-header">
-      <h2>${escapeHtml(fm.title)}${integrationIcons(fm)}</h2>
-      <div class="subtitle">${escapeHtml(fm.id)} &middot; ${escapeHtml(label)}</div>
-    </div>
-
-    <div class="detail-meta">
-      <dl>
-        ${dtDd}
-      </dl>
-    </div>
-
-    ${doc.content.trim() ? `<div class="detail-content">${renderMarkdown(doc.content)}</div>` : ""}
-
-    ${timelineHtml}
-  `;
-}
-function isValidAssessmentEntry(value) {
-  if (typeof value !== "object" || value === null) return false;
-  const obj = value;
-  if (typeof obj.generatedAt !== "string") return false;
-  if (obj.signals !== void 0 && !Array.isArray(obj.signals)) return false;
-  return true;
-}
-function normalizeEntry(entry) {
-  return {
-    generatedAt: entry.generatedAt ?? "",
-    commentSummary: typeof entry.commentSummary === "string" ? entry.commentSummary : null,
-    commentAnalysisProgress: typeof entry.commentAnalysisProgress === "number" ? entry.commentAnalysisProgress : null,
-    signals: Array.isArray(entry.signals) ? entry.signals.filter((s) => typeof s === "string") : [],
-    childCount: typeof entry.childCount === "number" ? entry.childCount : 0,
-    childDoneCount: typeof entry.childDoneCount === "number" ? entry.childDoneCount : 0,
-    childRollupProgress: typeof entry.childRollupProgress === "number" ? entry.childRollupProgress : null,
-    linkedIssueCount: typeof entry.linkedIssueCount === "number" ? entry.linkedIssueCount : 0
-  };
-}
-function renderAssessmentTimeline(history) {
-  const entries = history.map((raw, i) => {
-    const entry = normalizeEntry(raw);
-    const date5 = entry.generatedAt ? formatDate(entry.generatedAt) : "Unknown date";
-    const time3 = entry.generatedAt?.slice(11, 16) ?? "";
-    const isLatest = i === 0;
-    const parts = [];
-    if (entry.commentSummary) {
-      parts.push(`<div class="assessment-comment">${linkArtifactIds(escapeHtml(entry.commentSummary))}</div>`);
-    }
-    if (entry.commentAnalysisProgress !== null) {
-      parts.push(`<div class="assessment-stat">\u{1F4CA} Comment-derived progress: <strong>${entry.commentAnalysisProgress}%</strong></div>`);
-    }
-    if (entry.childCount > 0) {
-      const bar = progressBarHtml(entry.childRollupProgress ?? 0);
-      parts.push(`<div class="assessment-stat">\u{1F476} Children: ${entry.childDoneCount}/${entry.childCount} done ${bar} ${entry.childRollupProgress ?? 0}%</div>`);
-    }
-    if (entry.linkedIssueCount > 0) {
-      parts.push(`<div class="assessment-stat">\u{1F517} Linked issues: ${entry.linkedIssueCount}</div>`);
-    }
-    if (entry.signals.length > 0) {
-      const signalItems = entry.signals.map((s) => `<li>${linkArtifactIds(escapeHtml(s))}</li>`).join("");
-      parts.push(`<ul class="assessment-signals">${signalItems}</ul>`);
-    }
-    return `
-      <div class="assessment-entry${isLatest ? " assessment-latest" : ""}">
-        <div class="assessment-header">
-          <span class="assessment-date">${escapeHtml(date5)} ${escapeHtml(time3)}</span>
-          ${isLatest ? '<span class="badge badge-default">Latest</span>' : ""}
-        </div>
-        ${parts.join("\n")}
-      </div>`;
-  });
-  return `
-    <div class="assessment-timeline">
-      <h3>Assessment History</h3>
-      ${entries.join("\n")}
-    </div>`;
-}
-function progressBarHtml(pct) {
-  const filled = Math.round(Math.max(0, Math.min(100, pct)) / 10);
-  const empty = 10 - filled;
-  return `<span class="progress-bar-inline">${"\u2588".repeat(filled)}${"\u2591".repeat(empty)}</span>`;
+// src/web/templates/mermaid.ts
+function sanitize(text, maxLen = 40) {
+  const cleaned = text.replace(/["'`]/g, "").replace(/[\r\n]+/g, " ");
+  return cleaned.length > maxLen ? cleaned.slice(0, maxLen - 1) + "\u2026" : cleaned;
 }
-
-// src/web/persona-views.ts
-var VIEWS = /* @__PURE__ */ new Map();
-var PAGE_RENDERERS = /* @__PURE__ */ new Map();
-function registerPersonaView(config2) {
-  VIEWS.set(config2.shortName, config2);
+function mermaidBlock(definition, extraClass) {
+  const cls = ["mermaid-container", extraClass].filter(Boolean).join(" ");
+  return `<div class="${cls}"><pre class="mermaid">
+${definition}
+</pre></div>`;
 }
-function registerPersonaPage(persona, pageId, renderer) {
-  PAGE_RENDERERS.set(`${persona}/${pageId}`, renderer);
+function placeholder(message) {
+  return `<div class="mermaid-container mermaid-empty"><p>${message}</p></div>`;
 }
-function getPersonaView(mode) {
-  if (!mode) return void 0;
-  return VIEWS.get(mode);
+function toMs(date5) {
+  return (/* @__PURE__ */ new Date(date5 + "T00:00:00")).getTime();
 }
-function getPersonaPageRenderer(persona, pageId) {
-  return PAGE_RENDERERS.get(`${persona}/${pageId}`);
-}
-function 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.
-
-## 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);
@@ -22101,89 +22045,656 @@ function buildArtifactFlowchart(data) {
         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 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,
+    blockerProgress: typeof entry.blockerProgress === "number" ? entry.blockerProgress : null,
+    totalBlockers: typeof entry.totalBlockers === "number" ? entry.totalBlockers : 0,
+    resolvedBlockers: typeof entry.resolvedBlockers === "number" ? entry.resolvedBlockers : 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.totalBlockers > 0) {
+      const bar = progressBarHtml(entry.blockerProgress ?? 0);
+      parts.push(`<div class="assessment-stat">\u{1F6A7} Blockers: ${entry.resolvedBlockers}/${entry.totalBlockers} resolved ${bar} ${entry.blockerProgress ?? 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>`;
+}
 
-      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/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.
 
-      var activeId = null;
-      container.addEventListener('click', function(e) {
-        // Let the ID link navigate normally
-        if (e.target.closest('a')) return;
+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.
 
-        var node = e.target.closest('.flow-node');
-        var clickedId = node ? node.dataset.flowId : null;
+Produce a concise markdown assessment with these sections:
 
-        if (!clickedId || clickedId === activeId) {
-          activeId = null;
-          clearHighlight();
-          return;
-        }
+## Status Assessment
+One-line verdict: is this risk actively being mitigated, stalled, or escalating?
 
-        activeId = clickedId;
-        highlight(clickedId);
-      });
+## 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.
 
-      function drawAndHighlight() {
-        drawLines();
-        if (activeId) highlight(activeId);
-      }
+## 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.
 
-      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}`);
+## 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 mermaidBlock(lines.join("\n"));
+  return "Unable to generate risk assessment.";
 }
-function buildHealthGauge(categories) {
-  const valid = categories.filter((c) => c.total > 0);
-  if (valid.length === 0) {
-    return placeholder("No completeness data available.");
+function buildSingleRiskPrompt(data, risk, store) {
+  const sections = [];
+  sections.push(`# Sprint: ${data.sprint.id} \u2014 ${data.sprint.title}`);
+  if (data.sprint.goal) sections.push(`Goal: ${data.sprint.goal}`);
+  sections.push(`Days remaining: ${data.timeline.daysRemaining} / ${data.timeline.totalDays}`);
+  sections.push(`Completion: ${data.workItems.completionPct}%`);
+  sections.push("");
+  const doc = store.get(risk.id);
+  sections.push(`# RISK: ${risk.id} \u2014 ${risk.title}`);
+  sections.push(`Type: ${risk.type}`);
+  if (doc) {
+    sections.push(`Status: ${doc.frontmatter.status}`);
+    if (doc.frontmatter.owner) sections.push(`Owner: ${doc.frontmatter.owner}`);
+    if (doc.frontmatter.assignee) sections.push(`Assignee: ${doc.frontmatter.assignee}`);
+    if (doc.frontmatter.priority) sections.push(`Priority: ${doc.frontmatter.priority}`);
+    if (doc.frontmatter.dueDate) sections.push(`Due date: ${doc.frontmatter.dueDate}`);
+    if (doc.frontmatter.created) sections.push(`Created: ${doc.frontmatter.created.slice(0, 10)}`);
+    const tags = doc.frontmatter.tags ?? [];
+    if (tags.length > 0) sections.push(`Tags: ${tags.join(", ")}`);
+    if (doc.content.trim()) {
+      sections.push(`
+Description:
+${doc.content.trim()}`);
+    }
+    const allDocs = store.list();
+    const relatedIds = /* @__PURE__ */ new Set();
+    for (const d of allDocs) {
+      if (d.frontmatter.aboutArtifact === risk.id) {
+        relatedIds.add(d.frontmatter.id);
+      }
+    }
+    const idPattern = /\b([A-Z]-\d{3,})\b/g;
+    let match;
+    while ((match = idPattern.exec(doc.content)) !== null) {
+      relatedIds.add(match[1]);
+    }
+    const significantTags = tags.filter(
+      (t) => !t.startsWith("sprint:") && !t.startsWith("focus:") && t !== "risk"
+    );
+    if (significantTags.length > 0) {
+      for (const d of allDocs) {
+        if (d.frontmatter.id === risk.id) continue;
+        const dTags = d.frontmatter.tags ?? [];
+        if (significantTags.some((t) => dTags.includes(t))) {
+          relatedIds.add(d.frontmatter.id);
+        }
+      }
+    }
+    const about = doc.frontmatter.aboutArtifact;
+    if (about) {
+      relatedIds.add(about);
+      for (const d of allDocs) {
+        if (d.frontmatter.aboutArtifact === about && d.frontmatter.id !== risk.id) {
+          relatedIds.add(d.frontmatter.id);
+        }
+      }
+    }
+    const relatedDocs = [...relatedIds].map((id) => store.get(id)).filter((d) => d != null).slice(0, 20);
+    if (relatedDocs.length > 0) {
+      sections.push(`
+## Related Documents (${relatedDocs.length})`);
+      for (const rd of relatedDocs) {
+        const owner = rd.frontmatter.owner ?? "unowned";
+        const summary = rd.content.trim().slice(0, 300);
+        sections.push(
+          `- ${rd.frontmatter.id} (${rd.frontmatter.type}) [${rd.frontmatter.status}] \u2014 ${rd.frontmatter.title}`
+        );
+        sections.push(`  Owner: ${owner}${rd.frontmatter.dueDate ? `, Due: ${rd.frontmatter.dueDate}` : ""}`);
+        if (summary) sections.push(`  Summary: ${summary}${rd.content.trim().length > 300 ? "..." : ""}`);
+      }
+    }
   }
-  const 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>`;
+  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/pages/po/dashboard.ts
@@ -25318,7 +25829,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;
     }
@@ -26768,6 +27279,15 @@ function analyzeLinkedIssueSignals(linkedIssues, frontmatter, jiraKey, proposedU
     });
   }
 }
+function computeBlockerProgress(linkedIssues, prerequisiteWeight) {
+  const blockerLinks = linkedIssues.filter(
+    (l) => BLOCKER_LINK_PATTERNS.some((p) => l.relationship.toLowerCase().includes(p.split(" ")[0]))
+  );
+  if (blockerLinks.length === 0) return null;
+  const resolved = blockerLinks.filter((l) => l.isDone).length;
+  const blockerProgress = Math.round(resolved / blockerLinks.length * prerequisiteWeight * 100);
+  return { blockerProgress, totalBlockers: blockerLinks.length, resolvedBlockers: resolved };
+}
 var LINKED_COMMENT_ANALYSIS_PROMPT = `You are a delivery management assistant analyzing Jira comments from linked issues for progress signals.
 
 For each linked issue below, read the comments and produce a 1-sentence summary focused on: impact on the parent issue, blockers, or decisions.
@@ -27181,6 +27701,39 @@ async function _assessArtifactRecursive(store, client, host, options, visited, d
       });
     }
   }
+  const prerequisiteWeight = options.prerequisiteWeight ?? 0.3;
+  const blockerResult = computeBlockerProgress(linkedIssues, prerequisiteWeight);
+  let blockerProgressValue = null;
+  let totalBlockersCount = 0;
+  let resolvedBlockersCount = 0;
+  if (blockerResult && !fm.progressOverride && !DONE_STATUSES15.has(fm.status)) {
+    blockerProgressValue = blockerResult.blockerProgress;
+    totalBlockersCount = blockerResult.totalBlockers;
+    resolvedBlockersCount = blockerResult.resolvedBlockers;
+    const lastProgressUpdate = findLast(proposedUpdates, (u) => u.artifactId === fm.id && u.field === "progress");
+    const implementationProgress = lastProgressUpdate ? lastProgressUpdate.proposedValue : currentProgress;
+    const combinedProgress = Math.round(
+      blockerResult.blockerProgress + implementationProgress * (1 - prerequisiteWeight)
+    );
+    const estimatedProgress = Math.max(currentProgress, combinedProgress);
+    if (estimatedProgress !== currentProgress && estimatedProgress !== implementationProgress) {
+      for (let i = proposedUpdates.length - 1; i >= 0; i--) {
+        if (proposedUpdates[i].artifactId === fm.id && proposedUpdates[i].field === "progress") {
+          proposedUpdates.splice(i, 1);
+        }
+      }
+      proposedUpdates.push({
+        artifactId: fm.id,
+        field: "progress",
+        currentValue: currentProgress,
+        proposedValue: estimatedProgress,
+        reason: `Blocker resolution (${resolvedBlockersCount}/${totalBlockersCount}) + implementation \u2192 dependency-weighted progress ${estimatedProgress}%`
+      });
+    }
+  } else if (blockerResult) {
+    totalBlockersCount = blockerResult.totalBlockers;
+    resolvedBlockersCount = blockerResult.resolvedBlockers;
+  }
   const signals = buildSignals(commentSignals, linkedIssues, statusDrift, proposedMarvinStatus);
   const appliedUpdates = [];
   if (options.applyUpdates && proposedUpdates.length > 0) {
@@ -27223,7 +27776,10 @@ async function _assessArtifactRecursive(store, client, host, options, visited, d
       commentAnalysisProgress,
       signals,
       children,
-      linkedIssues
+      linkedIssues,
+      blockerProgressValue,
+      totalBlockersCount,
+      resolvedBlockersCount
     );
     const existingHistory = Array.isArray(fm.assessmentHistory) ? fm.assessmentHistory : [];
     const legacySummary = fm.assessmentSummary;
@@ -27272,6 +27828,9 @@ async function _assessArtifactRecursive(store, client, host, options, visited, d
     commentAnalysisProgress,
     linkedIssues,
     linkedIssueSignals,
+    blockerProgress: blockerProgressValue,
+    totalBlockers: totalBlockersCount,
+    resolvedBlockers: resolvedBlockersCount,
     children,
     proposedUpdates: options.applyUpdates ? [] : proposedUpdates,
     appliedUpdates,
@@ -27451,6 +28010,9 @@ function emptyArtifactReport(artifactId, errors) {
     commentAnalysisProgress: null,
     linkedIssues: [],
     linkedIssueSignals: [],
+    blockerProgress: null,
+    totalBlockers: 0,
+    resolvedBlockers: 0,
     children: [],
     proposedUpdates: [],
     appliedUpdates: [],
@@ -27458,7 +28020,7 @@ function emptyArtifactReport(artifactId, errors) {
     errors
   };
 }
-function buildAssessmentSummary(commentSummary, commentAnalysisProgress, signals, children, linkedIssues) {
+function buildAssessmentSummary(commentSummary, commentAnalysisProgress, signals, children, linkedIssues, blockerProgress = null, totalBlockers = 0, resolvedBlockers = 0) {
   const childProgressValues = children.map((c) => {
     const updates = c.appliedUpdates.length > 0 ? c.appliedUpdates : c.proposedUpdates;
     const lastStatus = findLast(updates, (u) => u.field === "status");
@@ -27482,7 +28044,10 @@ function buildAssessmentSummary(commentSummary, commentAnalysisProgress, signals
     childCount: children.length,
     childDoneCount,
     childRollupProgress,
-    linkedIssueCount: linkedIssues.length
+    linkedIssueCount: linkedIssues.length,
+    blockerProgress,
+    totalBlockers,
+    resolvedBlockers
   };
 }
 function formatArtifactReport(report) {
@@ -27518,6 +28083,12 @@ function formatArtifactReport(report) {
     }
     parts.push("");
   }
+  if (report.totalBlockers > 0) {
+    parts.push(`## Blocker Resolution`);
+    const bpLabel = report.blockerProgress !== null ? `${report.blockerProgress}%` : "n/a (skipped)";
+    parts.push(`  ${report.resolvedBlockers}/${report.totalBlockers} blockers resolved \u2192 ${bpLabel} prerequisite progress`);
+    parts.push("");
+  }
   if (report.children.length > 0) {
     const doneCount = report.children.filter((c) => DONE_STATUSES15.has(c.marvinStatus)).length;
     const childProgress = Math.round(
@@ -28416,10 +28987,11 @@ function createJiraTools(store, projectConfig) {
     // --- Single-artifact assessment ---
     tool20(
       "assess_artifact",
-      "Deep assessment of a single Marvin artifact (task, action, or epic). Fetches live Jira status, analyzes comments with LLM, traverses all linked issues, detects drift, rolls up child progress, and extracts contextual signals (blockers, unblocks, handoffs, superseded work).",
+      "Deep assessment of a single Marvin artifact (task, action, or epic). Fetches live Jira status, analyzes comments with LLM, traverses all linked issues, detects drift, rolls up child progress, computes dependency-weighted progress from blocker resolution, and extracts contextual signals (blockers, unblocks, handoffs, superseded work).",
       {
         artifactId: external_exports.string().describe("Marvin artifact ID (e.g. 'T-063', 'A-151', 'E-003')"),
-        applyUpdates: external_exports.boolean().optional().describe("Apply proposed status/progress updates to the artifact (default false)")
+        applyUpdates: external_exports.boolean().optional().describe("Apply proposed status/progress updates to the artifact (default false)"),
+        prerequisiteWeight: external_exports.number().min(0).max(1).optional().describe("Weight for blocker-resolution progress signal (0-1, default 0.3). Portion of effort attributed to dependency readiness.")
       },
       async (args) => {
         const jira = createJiraClient(jiraUserConfig);
@@ -28431,6 +29003,7 @@ function createJiraTools(store, projectConfig) {
           {
             artifactId: args.artifactId,
             applyUpdates: args.applyUpdates ?? false,
+            prerequisiteWeight: args.prerequisiteWeight,
             statusMap
           }
         );
@@ -33845,7 +34418,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.25");
+  ).version("0.5.27");
   program2.command("init").description("Initialize a new Marvin project in the current directory").action(async () => {
     await initCommand();
   });