@cyber-dash-tech/revela 0.15.4 → 0.16.2

package/lib/narrative-state/map-html.ts

@@ -44,6 +44,23 @@ export function renderNarrativeMapHtmlWithDisplay(map: NarrativeMap, display: Va
     .layout { display:grid; grid-template-columns:minmax(0,1fr) minmax(360px,430px); gap:18px; margin-top:18px; align-items:start; }
     .flow,.detail-panel { background:rgba(255,253,248,.92); border:1px solid var(--line); border-radius:24px; box-shadow:var(--shadow); }
     .flow { padding:20px; }
+    .workbench { margin-top:18px; background:rgba(255,253,248,.92); border:1px solid var(--line); border-radius:24px; box-shadow:var(--shadow); padding:18px 20px; }
+    .workbench h2 { margin:0; font-size:18px; letter-spacing:-.025em; }
+    .workbench-summary { display:grid; grid-template-columns:repeat(auto-fit,minmax(190px,1fr)); gap:10px; margin-top:14px; }
+    .summary-item { border:1px solid var(--line); border-radius:14px; background:#fff; padding:11px 12px; }
+    .summary-label { display:block; color:var(--muted); font-size:11px; font-weight:850; letter-spacing:.05em; text-transform:uppercase; }
+    .summary-value { display:block; margin-top:4px; color:#51483f; font-size:14px; font-weight:850; }
+    .filter-row { display:flex; flex-wrap:wrap; gap:8px; margin-top:14px; }
+    .filter-button { cursor:pointer; border:1px solid var(--line); border-radius:999px; background:#fff; color:var(--muted); padding:8px 11px; font-size:12px; font-weight:850; }
+    .filter-button.active { border-color:var(--accent); color:var(--accent); background:#fff4ea; }
+    .filter-status { margin:10px 0 0; color:var(--muted); font-size:12px; font-weight:780; }
+    .filter-empty { display:none; margin-top:10px; border:1px dashed var(--line); border-radius:14px; padding:12px; color:var(--muted); background:#fffaf3; font-size:13px; }
+    .coverage-grid { margin-top:16px; display:grid; grid-template-columns:repeat(auto-fit,minmax(260px,1fr)); gap:10px; }
+    .coverage-item { border:1px solid var(--line); border-radius:16px; background:#fff; padding:13px; }
+    .coverage-item h3 { margin:0; font-size:14px; line-height:1.2; }
+    .coverage-meta { display:flex; flex-wrap:wrap; gap:6px; margin-top:9px; }
+    .coverage-detail { margin:9px 0 0; color:var(--muted); font-size:12px; line-height:1.45; }
+    .coverage-detail strong { color:#51483f; }
     .flow-head { display:flex; justify-content:space-between; gap:14px; align-items:flex-start; margin-bottom:18px; }
     .flow-head h2 { margin:0; font-size:18px; letter-spacing:-.025em; }
     .flow-note { margin:4px 0 0; color:var(--muted); font-size:13px; line-height:1.45; }
@@ -64,6 +81,10 @@ export function renderNarrativeMapHtmlWithDisplay(map: NarrativeMap, display: Va
     .claim-section { border-top:1px solid #eee4d8; padding-top:9px; }
     .section-label { display:block; margin-bottom:3px; color:var(--accent); font-size:10px; font-weight:900; letter-spacing:.08em; text-transform:uppercase; }
     .section-text { display:block; color:#51483f; font-size:13px; line-height:1.46; white-space:pre-line; }
+    .next-actions { display:flex; flex-direction:column; gap:8px; }
+    .next-action { border:1px solid #eee4d8; border-radius:12px; padding:9px; background:#fffaf3; }
+    .next-action strong { display:block; color:#51483f; font-size:13px; }
+    .next-action code { display:inline-block; margin-top:5px; color:#9c4d1d; font-size:12px; }
     .relation-strip { margin-top:12px; display:grid; gap:7px; }
     .relation { display:grid; grid-template-columns:auto minmax(0,1fr); gap:8px; align-items:flex-start; color:var(--muted); font-size:13px; line-height:1.35; }
     .relation-badge { flex:0 0 auto; border-radius:999px; padding:3px 7px; background:#fff4e8; color:#9c4d1d; border:1px solid #efcfb8; font-size:10px; font-weight:850; text-transform:uppercase; letter-spacing:.04em; }
@@ -121,12 +142,16 @@ export function renderNarrativeMapHtmlWithDisplay(map: NarrativeMap, display: Va
         <div class="detail-body" id="detail-body">${initial?.detailHtml ?? emptyCard(display.labels.claimFlow, display.labels.noClaims)}</div>
       </aside>
     </div>
+    ${renderWorkbench(map, display)}
   </main>
   <div class="hidden-detail">
     ${nodes.map((node) => `<template id="detail-${escapeAttr(node.id)}" data-title="${escapeHtml(node.title)}" data-subtitle="${escapeHtml(claimSubtitle(node.claim, display))}">${node.detailHtml}</template>`).join("")}
   </div>
   <script>
     const buttons = Array.from(document.querySelectorAll('.claim-card'));
+    const filters = Array.from(document.querySelectorAll('.filter-button'));
+    const filterStatus = document.getElementById('filter-status');
+    const filterEmpty = document.getElementById('filter-empty');
     const title = document.getElementById('detail-title');
     const sub = document.getElementById('detail-sub');
     const body = document.getElementById('detail-body');
@@ -139,6 +164,19 @@ export function renderNarrativeMapHtmlWithDisplay(map: NarrativeMap, display: Va
       buttons.forEach((button) => button.classList.toggle('active', button.dataset.nodeId === id));
     }
     buttons.forEach((button) => button.addEventListener('click', () => selectClaim(button.dataset.nodeId)));
+    filters.forEach((button) => button.addEventListener('click', () => {
+      const filter = button.dataset.filterId || 'all';
+      filters.forEach((item) => item.classList.toggle('active', item === button));
+      buttons.forEach((claimButton) => {
+        const flags = (claimButton.dataset.filters || '').split(' ');
+        claimButton.closest('.claim-step').style.display = filter === 'all' || flags.includes(filter) ? '' : 'none';
+      });
+      const visibleButtons = buttons.filter((claimButton) => claimButton.closest('.claim-step').style.display !== 'none');
+      const activeButton = buttons.find((claimButton) => claimButton.classList.contains('active'));
+      if (visibleButtons.length > 0 && (!activeButton || activeButton.closest('.claim-step').style.display === 'none')) selectClaim(visibleButtons[0].dataset.nodeId);
+      if (filterStatus) filterStatus.textContent = (button.dataset.filterLabel || filter) + ': ' + visibleButtons.length;
+      if (filterEmpty) filterEmpty.style.display = visibleButtons.length === 0 ? 'block' : 'none';
+    }));
   </script>
 </body>
 </html>`
@@ -158,7 +196,7 @@ function renderStep(node: FlowNode, map: NarrativeMap, display: ValidatedNarrati
   const outgoing = map.claimRelations.filter((relation) => relation.fromClaimId === node.claim.id)
   return `<div class="claim-step">
     <div class="step-rail"><div class="step-dot">${index + 1}</div><div class="step-line"></div></div>
-    <button class="claim-card ${escapeAttr(node.claim.evidenceStatus)}${active ? " active" : ""}" data-node-id="${escapeAttr(node.id)}" type="button">
+    <button class="claim-card ${escapeAttr(node.claim.evidenceStatus)}${active ? " active" : ""}" data-node-id="${escapeAttr(node.id)}" data-filters="${escapeHtml(node.claim.workbenchFlags.join(" "))}" type="button">
       <span class="claim-title">${escapeHtml(node.title)}</span>
       <span class="claim-meta"><span class="tag">${escapeHtml(localizeValue(node.claim.kind, display))}</span><span class="tag">${escapeHtml(localizeValue(node.claim.importance, display))}</span><span class="tag">${escapeHtml(localizeValue(node.claim.evidenceStatus, display))}</span><span class="tag">${escapeHtml(node.claim.id)}</span></span>
       ${renderDisplayCardSummary(node.displayCard, display)}
@@ -213,9 +251,66 @@ function claimDetail(claim: NarrativeMapClaim, map: NarrativeMap, display: Valid
     ...(gaps.length ? [[display.labels.researchGaps, gaps.map((item) => `${item.question} [${item.status}/${item.priority}]`).join("<br>")] as [string, string]] : []),
     ...(slideRefs.length ? [[display.labels.coveredSlides, slideRefs.map((ref) => localizeSlideRef(ref, display)).join("<br>")] as [string, string]] : []),
     ...(coverageGaps.length ? [[systemTerm("artifactCoverage", display), coverageGaps.map((artifact) => `${artifact.type}: ${artifact.coverageStatus}${artifact.staleReasons.length ? ` - ${artifact.staleReasons.join("; ")}` : ""}`).join("<br>")] as [string, string]] : []),
+    ...(claim.nextActions.length ? [[systemTerm("nextActions", display), renderNextActions(claim, display), true] as [string, string, boolean]] : []),
   ])
 }
 
+function renderWorkbench(map: NarrativeMap, display: ValidatedNarrativeDisplayModel): string {
+  return `<section class="workbench" aria-label="Story workbench">
+    <h2>${escapeHtml(systemTerm("storyWorkbench", display))}</h2>
+    <p class="flow-note">${escapeHtml(workbenchNote(display))}</p>
+    ${renderWorkbenchSummary(map, display)}
+    <div class="filter-row" aria-label="Story filters">
+      ${map.workbench.filters.map((filter, index) => `<button type="button" class="filter-button${index === 0 ? " active" : ""}" data-filter-id="${escapeAttr(filter.id)}" data-filter-label="${escapeHtml(localizeFilter(filter.label, display))}">${escapeHtml(localizeFilter(filter.label, display))} (${filter.count})</button>`).join("")}
+    </div>
+    <p class="filter-status" id="filter-status">${escapeHtml(localizeFilter(map.workbench.filters[0]?.label ?? "All claims", display))}: ${map.workbench.filters[0]?.count ?? 0}</p>
+    <div class="filter-empty" id="filter-empty">${escapeHtml(noClaimsMatchFilter(display))}</div>
+    <div class="coverage-grid">
+      ${map.workbench.artifactCoverage.length ? map.workbench.artifactCoverage.map((item) => renderCoverageItem(item, display)).join("") : renderNoRenderTargetCard(map, display)}
+    </div>
+  </section>`
+}
+
+function renderWorkbenchSummary(map: NarrativeMap, display: ValidatedNarrativeDisplayModel): string {
+  const summary = map.workbench.summary
+  return `<div class="workbench-summary" aria-label="Story readiness summary">
+    <div class="summary-item"><span class="summary-label">${escapeHtml(systemTerm("approval", display))}</span><span class="summary-value">${escapeHtml(localizeValue(summary.approval, display))}</span></div>
+    <div class="summary-item"><span class="summary-label">${escapeHtml(readinessSummaryTerm("evidenceBlockers", display))}</span><span class="summary-value">${summary.evidenceBlockersCount}</span></div>
+    <div class="summary-item"><span class="summary-label">${escapeHtml(readinessSummaryTerm("artifactStatus", display))}</span><span class="summary-value">${escapeHtml(localizeValue(summary.artifactStatus, display))}</span></div>
+    <div class="summary-item"><span class="summary-label">${escapeHtml(readinessSummaryTerm("primaryNextCommand", display))}</span><span class="summary-value"><code>${escapeHtml(summary.primaryNextCommand)}</code></span></div>
+    <div class="summary-item"><span class="summary-label">${escapeHtml(readinessSummaryTerm("primaryNextReason", display))}</span><span class="summary-value">${escapeHtml(summary.primaryNextReason)}</span></div>
+  </div>`
+}
+
+function renderNoRenderTargetCard(map: NarrativeMap, display: ValidatedNarrativeDisplayModel): string {
+  const action = map.workbench.renderTargetAction
+  if (!action) return emptyCard(systemTerm("artifactCoverage", display), systemTerm("noRenderTargets", display))
+  return `<article class="coverage-item">
+    <h3>${escapeHtml(systemTerm("artifactCoverage", display))}</h3>
+    <p class="coverage-detail">${escapeHtml(systemTerm("noRenderTargets", display))}</p>
+    <p class="coverage-detail"><strong>${escapeHtml(systemTerm("notes", display))}:</strong> ${escapeHtml(localizeAction(action.label, display))} - ${escapeHtml(action.reason)}</p>
+    <p class="coverage-detail"><strong>${escapeHtml(systemTerm("recommendedNextCommand", display))}:</strong> <code>${escapeHtml(action.command)}</code></p>
+  </article>`
+}
+
+function renderCoverageItem(item: NarrativeMap["workbench"]["artifactCoverage"][number], display: ValidatedNarrativeDisplayModel): string {
+  const title = item.outputPath ?? item.artifactId
+  const slides = item.affectedSlides.map((slide) => `${localizeSlideRef(`slide ${slide.slideIndex}`, display)}: ${slide.slideTitle} (${slide.claimId}, ${slide.role}/${slide.location})`).join("<br>")
+  return `<article class="coverage-item">
+    <h3>${escapeHtml(title)}</h3>
+    <div class="coverage-meta"><span class="pill ${escapeAttr(item.coverageStatus)}">${escapeHtml(localizeValue(item.coverageStatus, display))}</span><span class="tag">${escapeHtml(item.type)}</span>${item.contractStatus ? `<span class="tag">${escapeHtml(item.contractStatus)}</span>` : ""}</div>
+    <p class="coverage-detail"><strong>${escapeHtml(systemTerm("missingClaims", display))}:</strong> ${escapeHtml(item.missingClaimIds.join(", ") || systemTerm("none", display))}</p>
+    <p class="coverage-detail"><strong>${escapeHtml(systemTerm("affectedClaims", display))}:</strong> ${escapeHtml(item.affectedClaimIds.join(", ") || systemTerm("none", display))}</p>
+    <p class="coverage-detail"><strong>${escapeHtml(systemTerm("affectedSlides", display))}:</strong> ${slides ? allowBreaks(slides) : escapeHtml(systemTerm("none", display))}</p>
+    <p class="coverage-detail"><strong>${escapeHtml(systemTerm("notes", display))}:</strong> ${escapeHtml([item.statusNote, ...item.staleReasons].filter(Boolean).join("; ") || systemTerm("none", display))}</p>
+    <p class="coverage-detail"><strong>${escapeHtml(systemTerm("recommendedNextCommand", display))}:</strong> <code>${escapeHtml(item.recommendedNextCommand)}</code></p>
+  </article>`
+}
+
+function renderNextActions(claim: NarrativeMapClaim, display: ValidatedNarrativeDisplayModel): string {
+  return `<span class="next-actions">${claim.nextActions.map((action) => `<span class="next-action"><strong>${escapeHtml(localizeAction(action.label, display))}</strong>${escapeHtml(action.reason)}<br><code>${escapeHtml(action.command)}</code></span>`).join("")}</span>`
+}
+
 function relationText(relation: NarrativeMapClaimRelation, display: ValidatedNarrativeDisplayModel): string {
   const from = displayClaimText(relation.fromClaimId, relation.fromClaimText, display)
   const to = displayClaimText(relation.toClaimId, relation.toClaimText, display)
@@ -259,8 +354,8 @@ function missingRationale(display: ValidatedNarrativeDisplayModel): string {
   return "Causal rationale is not recorded."
 }
 
-function detailCards(rows: Array<[string, string]>): string {
-  return rows.map(([label, value]) => `<div class="detail-card"><h3>${escapeHtml(label)}</h3><p>${allowBreaks(value)}</p></div>`).join("")
+function detailCards(rows: Array<[string, string] | [string, string, boolean]>): string {
+  return rows.map(([label, value, raw]) => `<div class="detail-card"><h3>${escapeHtml(label)}</h3><p>${raw ? value : allowBreaks(value)}</p></div>`).join("")
 }
 
 function emptyCard(label: string, value: string): string {
@@ -292,14 +387,46 @@ function sectionLabels(display: ValidatedNarrativeDisplayModel): Record<string,
   return { role: "Role", narrativeJob: "Narrative job", evidenceSummary: "Evidence summary", riskOrGapSummary: "Risk / gap" }
 }
 
+function workbenchNote(display: ValidatedNarrativeDisplayModel): string {
+  return display.labels.workbenchNote
+}
+
+function localizeFilter(value: string, display: ValidatedNarrativeDisplayModel): string {
+  const zh: Record<string, string> = { "All claims": "全部主张", "Missing evidence": "证据缺失", "Partial evidence": "部分证据", "Stale artifacts": "过期产物", "Open gaps": "开放缺口", Risks: "风险", "High-priority objections": "高优先级异议" }
+  const ja: Record<string, string> = { "All claims": "すべてのクレーム", "Missing evidence": "根拠不足", "Partial evidence": "一部根拠", "Stale artifacts": "古い成果物", "Open gaps": "未解決ギャップ", Risks: "リスク", "High-priority objections": "高優先度の反論" }
+  const table = isChineseLanguage(display.language) ? zh : isJapaneseLanguage(display.language) ? ja : {}
+  return table[value] ?? value
+}
+
+function localizeAction(value: string, display: ValidatedNarrativeDisplayModel): string {
+  const zh: Record<string, string> = { "Research this gap": "研究这个缺口", "Attach findings": "附加研究发现", "Narrow claim": "收窄主张", "Approve narrative": "批准叙事", "Make deck": "制作 deck", "Remake stale artifact": "重新生成过期产物" }
+  const ja: Record<string, string> = { "Research this gap": "このギャップを調査", "Attach findings": "調査結果を紐付け", "Narrow claim": "クレームを絞る", "Approve narrative": "ナラティブを承認", "Make deck": "デッキを作成", "Remake stale artifact": "古い成果物を再生成" }
+  const table = isChineseLanguage(display.language) ? zh : isJapaneseLanguage(display.language) ? ja : {}
+  return table[value] ?? value
+}
+
+function readinessSummaryTerm(value: string, display: ValidatedNarrativeDisplayModel): string {
+  const zh: Record<string, string> = { evidenceBlockers: "证据阻塞", artifactStatus: "产物状态", primaryNextCommand: "首要建议命令", primaryNextReason: "首要建议原因" }
+  const ja: Record<string, string> = { evidenceBlockers: "根拠ブロッカー", artifactStatus: "成果物ステータス", primaryNextCommand: "最優先コマンド", primaryNextReason: "最優先理由" }
+  const en: Record<string, string> = { evidenceBlockers: "Evidence blockers", artifactStatus: "Artifact status", primaryNextCommand: "Primary next command", primaryNextReason: "Primary next reason" }
+  return (isChineseLanguage(display.language) ? zh : isJapaneseLanguage(display.language) ? ja : en)[value] ?? value
+}
+
+function noClaimsMatchFilter(display: ValidatedNarrativeDisplayModel): string {
+  if (isChineseLanguage(display.language)) return "没有主张匹配这个过滤器。"
+  if (isJapaneseLanguage(display.language)) return "このフィルターに一致するクレームはありません。"
+  return "No claims match this filter."
+}
+
 function systemTerm(term: string, display: ValidatedNarrativeDisplayModel): string {
-  const zh: Record<string, string> = { approval: "审批", claims: "主张", relations: "关系", inferred: "未确认", relation: "关系", from: "来自", to: "指向", rationale: "说明", strength: "强度", findingsFile: "研究文件", location: "位置", quote: "引用", caveat: "注意事项", artifacts: "产物", attention: "需关注", artifactCoverage: "产物覆盖" }
-  const ja: Record<string, string> = { approval: "承認", claims: "クレーム", relations: "関係", inferred: "未確認", relation: "関係", from: "起点", to: "終点", rationale: "理由", strength: "強度", findingsFile: "調査ファイル", location: "場所", quote: "引用", caveat: "留意点", artifacts: "成果物", attention: "要確認", artifactCoverage: "成果物カバレッジ" }
-  const en: Record<string, string> = { approval: "approval", claims: "claims", relations: "relations", inferred: "unconfirmed", relation: "relation", from: "from", to: "to", rationale: "rationale", strength: "strength", findingsFile: "findings file", location: "location", quote: "quote", caveat: "caveat", artifacts: "artifacts", attention: "need attention", artifactCoverage: "Artifact coverage" }
+  const zh: Record<string, string> = { approval: "审批", claims: "主张", relations: "关系", inferred: "未确认", relation: "关系", from: "来自", to: "指向", rationale: "说明", strength: "强度", findingsFile: "研究文件", location: "位置", quote: "引用", caveat: "注意事项", artifacts: "产物", attention: "需关注", artifactCoverage: display.labels.artifactCoverage, storyWorkbench: display.labels.storyWorkbench, noRenderTargets: display.labels.noRenderTargets, nextActions: display.labels.nextActions, missingClaims: display.labels.missingClaims, affectedClaims: display.labels.affectedClaims, affectedSlides: display.labels.affectedSlides, notes: display.labels.notes, recommendedNextCommand: display.labels.recommendedNextCommand, none: display.labels.none }
+  const ja: Record<string, string> = { approval: "承認", claims: "クレーム", relations: "関係", inferred: "未確認", relation: "関係", from: "起点", to: "終点", rationale: "理由", strength: "強度", findingsFile: "調査ファイル", location: "場所", quote: "引用", caveat: "留意点", artifacts: "成果物", attention: "要確認", artifactCoverage: display.labels.artifactCoverage, storyWorkbench: display.labels.storyWorkbench, noRenderTargets: display.labels.noRenderTargets, nextActions: display.labels.nextActions, missingClaims: display.labels.missingClaims, affectedClaims: display.labels.affectedClaims, affectedSlides: display.labels.affectedSlides, notes: display.labels.notes, recommendedNextCommand: display.labels.recommendedNextCommand, none: display.labels.none }
+  const en: Record<string, string> = { approval: "approval", claims: "claims", relations: "relations", inferred: "unconfirmed", relation: "relation", from: "from", to: "to", rationale: "rationale", strength: "strength", findingsFile: "findings file", location: "location", quote: "quote", caveat: "caveat", artifacts: "artifacts", attention: "need attention", artifactCoverage: display.labels.artifactCoverage, storyWorkbench: display.labels.storyWorkbench, noRenderTargets: display.labels.noRenderTargets, nextActions: display.labels.nextActions, missingClaims: display.labels.missingClaims, affectedClaims: display.labels.affectedClaims, affectedSlides: display.labels.affectedSlides, notes: display.labels.notes, recommendedNextCommand: display.labels.recommendedNextCommand, none: display.labels.none }
   return (isChineseLanguage(display.language) ? zh : isJapaneseLanguage(display.language) ? ja : en)[term] ?? term
 }
 
 function localizeValue(value: string, display: ValidatedNarrativeDisplayModel): string {
+  if (value === "no_target") return isChineseLanguage(display.language) ? "无 render target" : isJapaneseLanguage(display.language) ? "render target なし" : "no target"
   const zh: Record<string, string> = {
     current: "当前", stale: "已过期", missing: "缺失", approved: "已批准", ready_for_approval: "待批准", needs_research: "需要研究", needs_user_confirmation: "需要用户确认", blocked: "受阻", draft: "草稿",
     supported: "已支持", partial: "部分支持", weak: "弱支持", not_required: "无需证据", central: "核心", supporting: "支撑", background: "背景",

package/lib/narrative-state/map.ts

@@ -23,6 +23,7 @@ export interface NarrativeMap {
   risks: NarrativeMapRisk[]
   researchGaps: NarrativeMapResearchGap[]
   artifactCoverage: NarrativeMapArtifact[]
+  workbench: NarrativeMapWorkbench
   nextActions: string[]
 }
 
@@ -38,7 +39,60 @@ export interface NarrativeMapSnapshot {
   approval: "current" | "stale" | "missing"
 }
 
-export type NarrativeMapClaim = ClaimEvidenceRecord
+export interface NarrativeMapClaim extends ClaimEvidenceRecord {
+  nextActions: NarrativeMapNextAction[]
+  workbenchFlags: NarrativeMapFilterId[]
+}
+
+export type NarrativeMapActionKind = "research" | "attach_findings" | "narrow_claim" | "approve_narrative" | "make_deck" | "remake_artifact"
+
+export type NarrativeMapArtifactStatus = "current" | "stale" | "partial" | "missing" | "no_target"
+
+export interface NarrativeMapNextAction {
+  kind: NarrativeMapActionKind
+  label: string
+  command: string
+  reason: string
+}
+
+export type NarrativeMapFilterId = "all" | "missing_evidence" | "partial_evidence" | "stale_artifacts" | "open_gaps" | "risks" | "high_priority_objections"
+
+export interface NarrativeMapWorkbenchFilter {
+  id: NarrativeMapFilterId
+  label: string
+  count: number
+  claimIds: string[]
+}
+
+export interface NarrativeMapArtifactWorkItem {
+  artifactId: string
+  type: RenderTarget["type"]
+  outputPath?: string
+  coverageStatus: NarrativeMapArtifact["coverageStatus"]
+  contractStatus?: RenderTarget["contractStatus"]
+  affectedClaimIds: string[]
+  missingClaimIds: string[]
+  affectedSlides: Array<{ claimId: string; slideIndex: number; slideTitle: string; role: string; location: string }>
+  staleReasons: string[]
+  statusNote: string
+  recommendedNextCommand: string
+}
+
+export interface NarrativeMapWorkbenchSummary {
+  approval: NarrativeMapSnapshot["approval"]
+  evidenceBlockersCount: number
+  artifactStatus: NarrativeMapArtifactStatus
+  primaryNextCommand: string
+  primaryNextReason: string
+  readinessNextActions: string[]
+}
+
+export interface NarrativeMapWorkbench {
+  summary: NarrativeMapWorkbenchSummary
+  filters: NarrativeMapWorkbenchFilter[]
+  artifactCoverage: NarrativeMapArtifactWorkItem[]
+  renderTargetAction?: NarrativeMapNextAction
+}
 
 export type NarrativeMapEvidence = ClaimEvidenceBindingRecord
 
@@ -91,8 +145,28 @@ export function buildNarrativeMap(state: DecksState): NarrativeMap {
   const reviewed = reviewNarrativeState({ ...state, narrative })
   const readiness = reviewed.result
   const narrativeHash = computeNarrativeHash(narrative)
-  const board = getClaimEvidenceBoard({ ...state, narrative })
+  const rawBoard = getClaimEvidenceBoard({ ...state, narrative })
   const objectionRisk = getObjectionRiskClaimIndex({ ...state, narrative })
+  const researchGaps = (narrative.researchGaps ?? []).map((gap) => ({ ...gap, targetText: targetText(narrative, gap) }))
+  const artifactCoverage = getArtifactClaimRefs({ ...state, narrative }).map((artifact) => ({
+    id: artifact.artifactId,
+    type: artifact.type,
+    outputPath: artifact.outputPath,
+    contractStatus: artifact.contractStatus,
+    sourceNodeIds: artifact.sourceNodeIds,
+    claimIds: artifact.claimIds,
+    narrativeIds: artifact.narrativeIds,
+    slideRefs: artifact.slideRefs,
+    coverageStatus: artifact.coverageStatus,
+    affectedClaimIds: artifact.affectedClaimIds,
+    missingClaimIds: artifact.missingClaimIds,
+    staleReasons: artifact.staleReasons,
+    stale: artifact.stale,
+    staleReason: artifact.staleReason,
+    note: artifact.note,
+  }))
+  const claims = withWorkbenchClaimData(rawBoard.claims, narrative, readiness.approval?.current === true, objectionRisk, researchGaps, artifactCoverage)
+  const claimFlow = claimRecordsInNarrativeOrder(narrative, claims)
 
   return {
     version: 1,
@@ -107,33 +181,259 @@ export function buildNarrativeMap(state: DecksState): NarrativeMap {
       thesis: narrative.thesis?.statement,
       approval: readiness.approval?.current ? "current" : readiness.approval?.stale ? "stale" : "missing",
     },
-    claims: board.claims,
-    claimFlow: claimRecordsInNarrativeOrder(narrative, board.claims),
+    claims,
+    claimFlow,
     claimRelations: mapClaimRelations(narrative),
     objections: objectionRisk.objections,
     risks: objectionRisk.risks,
-    researchGaps: (narrative.researchGaps ?? []).map((gap) => ({ ...gap, targetText: targetText(narrative, gap) })),
-    artifactCoverage: getArtifactClaimRefs({ ...state, narrative }).map((artifact) => ({
-      id: artifact.artifactId,
+    researchGaps,
+    artifactCoverage,
+    workbench: buildWorkbench(claimFlow, artifactCoverage, readiness.approval?.current === true, readiness.nextActions, readiness.approval?.current ? "current" : readiness.approval?.stale ? "stale" : "missing"),
+    nextActions: readiness.nextActions,
+  }
+}
+
+function withWorkbenchClaimData(
+  claimsByStatus: Record<NarrativeClaim["evidenceStatus"], ClaimEvidenceRecord[]>,
+  narrative: NarrativeStateV1,
+  approved: boolean,
+  objectionRisk: ReturnType<typeof getObjectionRiskClaimIndex>,
+  researchGaps: NarrativeMapResearchGap[],
+  artifacts: NarrativeMapArtifact[],
+): Record<NarrativeClaim["evidenceStatus"], NarrativeMapClaim[]> {
+  return Object.fromEntries(Object.entries(claimsByStatus).map(([status, claims]) => [
+    status,
+    claims.map((claim) => ({
+      ...claim,
+      nextActions: claimNextActions(claim, narrative, approved, objectionRisk, researchGaps, artifacts),
+      workbenchFlags: claimWorkbenchFlags(claim, objectionRisk, researchGaps, artifacts),
+    })),
+  ])) as Record<NarrativeClaim["evidenceStatus"], NarrativeMapClaim[]>
+}
+
+function claimNextActions(
+  claim: ClaimEvidenceRecord,
+  narrative: NarrativeStateV1,
+  approved: boolean,
+  objectionRisk: ReturnType<typeof getObjectionRiskClaimIndex>,
+  researchGaps: NarrativeMapResearchGap[],
+  artifacts: NarrativeMapArtifact[],
+): NarrativeMapNextAction[] {
+  const actions: NarrativeMapNextAction[] = []
+  const claimGaps = researchGaps.filter((gap) => gap.targetType === "claim" && gap.targetId === claim.id)
+  const hasSavedFindings = claimGaps.some((gap) => gap.status === "findings_saved" || gap.status === "attached")
+  const needsEvidence = claim.evidenceRequired && (claim.evidenceStatus === "missing" || claim.evidenceStatus === "weak")
+  const partialEvidence = claim.evidenceRequired && claim.evidenceStatus === "partial"
+  const affectedArtifacts = artifacts.filter((artifact) => artifact.coverageStatus !== "current" && (artifact.affectedClaimIds.includes(claim.id) || artifact.missingClaimIds.includes(claim.id) || artifact.claimIds.includes(claim.id)))
+
+  if (needsEvidence || claimGaps.some((gap) => gap.status === "open" || gap.status === "in_progress")) actions.push({
+    kind: "research",
+    label: "Research this gap",
+    command: "/revela research",
+    reason: needsEvidence ? "Required evidence is missing or weak for this claim." : "An open research gap targets this claim.",
+  })
+  if (hasSavedFindings) actions.push({
+    kind: "attach_findings",
+    label: "Attach findings",
+    command: "/revela research",
+    reason: "Saved or attached findings still need canonical evidence binding.",
+  })
+  if (partialEvidence || Boolean(claim.unsupportedScope)) actions.push({
+    kind: "narrow_claim",
+    label: "Narrow claim",
+    command: "/revela story",
+    reason: claim.unsupportedScope || "Evidence only partially supports the claim scope.",
+  })
+  if (!approved) actions.push({
+    kind: "approve_narrative",
+    label: "Approve narrative",
+    command: "/revela story",
+    reason: "The current narrative is not approved for artifact rendering.",
+  })
+  if (approved && artifacts.length === 0) actions.push({
+    kind: "make_deck",
+    label: "Make deck",
+    command: "/revela make --deck",
+    reason: "No render target is recorded for this approved narrative.",
+  })
+  if (approved && affectedArtifacts.length > 0) actions.push({
+    kind: "remake_artifact",
+    label: "Remake stale artifact",
+    command: "/revela make --deck",
+    reason: "Artifact coverage is stale, partial, or missing for this claim.",
+  })
+  if (approved && actions.length === 0 && claim.importance === "central") actions.push({
+    kind: "make_deck",
+    label: "Make deck",
+    command: "/revela make --deck",
+    reason: "Central claim is ready to hand off to an artifact.",
+  })
+
+  return dedupeActions(actions)
+}
+
+function claimWorkbenchFlags(
+  claim: ClaimEvidenceRecord,
+  objectionRisk: ReturnType<typeof getObjectionRiskClaimIndex>,
+  researchGaps: NarrativeMapResearchGap[],
+  artifacts: NarrativeMapArtifact[],
+): NarrativeMapFilterId[] {
+  const flags: NarrativeMapFilterId[] = ["all"]
+  if (claim.evidenceRequired && claim.evidenceStatus === "missing") flags.push("missing_evidence")
+  if (claim.evidenceRequired && (claim.evidenceStatus === "partial" || claim.evidenceStatus === "weak")) flags.push("partial_evidence")
+  if (researchGaps.some((gap) => gap.targetType === "claim" && gap.targetId === claim.id && (gap.status === "open" || gap.status === "in_progress" || gap.status === "findings_saved"))) flags.push("open_gaps")
+  if (objectionRisk.risks.some((risk) => risk.claimId === claim.id)) flags.push("risks")
+  if (objectionRisk.objections.some((objection) => objection.claimId === claim.id && objection.priority === "high")) flags.push("high_priority_objections")
+  if (artifacts.some((artifact) => artifact.coverageStatus !== "current" && (artifact.affectedClaimIds.includes(claim.id) || artifact.missingClaimIds.includes(claim.id) || artifact.claimIds.includes(claim.id)))) flags.push("stale_artifacts")
+  return [...new Set(flags)]
+}
+
+function buildWorkbench(
+  claims: NarrativeMapClaim[],
+  artifacts: NarrativeMapArtifact[],
+  approved: boolean,
+  readinessNextActions: string[],
+  approval: NarrativeMapSnapshot["approval"],
+): NarrativeMapWorkbench {
+  const filterLabels: Record<NarrativeMapFilterId, string> = {
+    all: "All claims",
+    missing_evidence: "Missing evidence",
+    partial_evidence: "Partial evidence",
+    stale_artifacts: "Stale artifacts",
+    open_gaps: "Open gaps",
+    risks: "Risks",
+    high_priority_objections: "High-priority objections",
+  }
+  const filterIds: NarrativeMapFilterId[] = ["all", "missing_evidence", "partial_evidence", "stale_artifacts", "open_gaps", "risks", "high_priority_objections"]
+  const renderTargetAction = artifacts.length === 0 ? {
+    kind: approved ? "make_deck" as const : "approve_narrative" as const,
+    label: approved ? "Make deck" : "Approve narrative",
+    command: approved ? "/revela make --deck" : "/revela story",
+    reason: approved ? "No render target is recorded for this approved narrative." : "Narrative approval is required before rendering artifacts.",
+  } : undefined
+  return {
+    summary: buildWorkbenchSummary(claims, artifacts, approval, readinessNextActions, renderTargetAction?.command),
+    filters: filterIds.map((id) => {
+      const claimIds = claims.filter((claim) => claim.workbenchFlags.includes(id)).map((claim) => claim.id)
+      return { id, label: filterLabels[id], count: claimIds.length, claimIds }
+    }),
+    artifactCoverage: artifacts.map((artifact) => ({
+      artifactId: artifact.id,
       type: artifact.type,
       outputPath: artifact.outputPath,
-      contractStatus: artifact.contractStatus,
-      sourceNodeIds: artifact.sourceNodeIds,
-      claimIds: artifact.claimIds,
-      narrativeIds: artifact.narrativeIds,
-      slideRefs: artifact.slideRefs,
       coverageStatus: artifact.coverageStatus,
+      contractStatus: artifact.contractStatus,
       affectedClaimIds: artifact.affectedClaimIds,
       missingClaimIds: artifact.missingClaimIds,
+      affectedSlides: artifact.slideRefs
+        .filter((ref) => artifact.affectedClaimIds.includes(ref.claimId) || artifact.missingClaimIds.includes(ref.claimId) || artifact.coverageStatus !== "current")
+        .map((ref) => ({ claimId: ref.claimId, slideIndex: ref.slideIndex, slideTitle: ref.slideTitle, role: ref.role, location: ref.location })),
       staleReasons: artifact.staleReasons,
-      stale: artifact.stale,
-      staleReason: artifact.staleReason,
-      note: artifact.note,
+      statusNote: artifactStatusNote(artifact, artifacts),
+      recommendedNextCommand: recommendedArtifactCommand(artifact, artifacts),
     })),
-    nextActions: readiness.nextActions,
+    renderTargetAction,
+  }
+}
+
+function buildWorkbenchSummary(
+  claims: NarrativeMapClaim[],
+  artifacts: NarrativeMapArtifact[],
+  approval: NarrativeMapSnapshot["approval"],
+  readinessNextActions: string[],
+  renderTargetCommand?: string,
+): NarrativeMapWorkbenchSummary {
+  const evidenceBlockersCount = claims.filter((claim) => claim.evidenceRequired && (claim.evidenceStatus === "missing" || claim.evidenceStatus === "weak" || claim.evidenceStatus === "partial")).length
+  const artifactStatus = aggregateArtifactStatus(artifacts)
+  const primaryNext = primaryNextDecision({ approval, evidenceBlockersCount, artifactStatus, artifacts, renderTargetCommand })
+  return {
+    approval,
+    evidenceBlockersCount,
+    artifactStatus,
+    primaryNextCommand: primaryNext.command,
+    primaryNextReason: primaryNext.reason,
+    readinessNextActions,
+  }
+}
+
+function primaryNextDecision(input: { approval: NarrativeMapSnapshot["approval"]; evidenceBlockersCount: number; artifactStatus: NarrativeMapArtifactStatus; artifacts: NarrativeMapArtifact[]; renderTargetCommand?: string }): { command: string; reason: string } {
+  if (input.evidenceBlockersCount > 0) return {
+    command: "/revela research",
+    reason: `${input.evidenceBlockersCount} evidence-required claim${input.evidenceBlockersCount === 1 ? "" : "s"} still need stronger support before artifact handoff.`,
+  }
+  if (input.approval !== "current") return {
+    command: "/revela story",
+    reason: input.approval === "stale" ? "Narrative approval is stale after meaning changed." : "Narrative approval is missing before artifact rendering.",
+  }
+  if (input.artifactStatus === "no_target") return {
+    command: input.renderTargetCommand ?? "/revela make --deck",
+    reason: "Approved narrative has no recorded render target yet.",
+  }
+  if (input.artifactStatus !== "current") {
+    const command = input.artifacts.map((artifact) => recommendedArtifactCommand(artifact, input.artifacts)).find((item) => item !== "/revela review --deck") ?? "/revela make --deck"
+    return {
+      command,
+      reason: artifactStatusReason(input.artifactStatus, command),
+    }
+  }
+  return {
+    command: "/revela review --deck",
+    reason: "Current HTML deck coverage is recorded; review is the next read-only workspace.",
   }
 }
 
+function aggregateArtifactStatus(artifacts: NarrativeMapArtifact[]): NarrativeMapArtifactStatus {
+  if (artifacts.length === 0) return "no_target"
+  if (artifacts.some((artifact) => artifact.coverageStatus === "stale")) return "stale"
+  if (artifacts.some((artifact) => artifact.coverageStatus === "missing")) return "missing"
+  if (artifacts.some((artifact) => artifact.coverageStatus === "partial")) return "partial"
+  return "current"
+}
+
+function recommendedArtifactCommand(artifact: NarrativeMapArtifact, artifacts: NarrativeMapArtifact[]): string {
+  if (artifact.coverageStatus === "current") return artifact.type === "html_deck" ? "/revela review --deck" : exportCommand(artifact.type) ?? "/revela review --deck"
+  if (artifact.type === "html_deck") return "/revela make --deck"
+  if ((artifact.type === "pdf" || artifact.type === "pptx") && activeHtmlIsCurrent(artifact, artifacts)) return exportCommand(artifact.type) ?? "/revela make --deck"
+  return "/revela make --deck"
+}
+
+function artifactStatusNote(artifact: NarrativeMapArtifact, artifacts: NarrativeMapArtifact[]): string {
+  if (artifact.coverageStatus === "current") return artifact.type === "html_deck" ? "Current HTML deck is ready for review or export." : `Current ${artifact.type.toUpperCase()} export is recorded.`
+  const command = recommendedArtifactCommand(artifact, artifacts)
+  if ((artifact.type === "pdf" || artifact.type === "pptx") && command.startsWith("/revela export")) return `HTML deck is current; refresh the ${artifact.type.toUpperCase()} export.`
+  if (artifact.coverageStatus === "partial") return "Artifact is partial; remake the deck so all central or evidence-required claims are covered."
+  if (artifact.coverageStatus === "missing") return "Artifact is missing required narrative coverage; remake the deck from the approved narrative."
+  return "Artifact is stale relative to the current narrative; remake the deck from the approved narrative."
+}
+
+function artifactStatusReason(status: Exclude<NarrativeMapArtifactStatus, "current" | "no_target">, command: string): string {
+  if (command.startsWith("/revela export")) return "HTML deck coverage is current, but a derived export is stale and should be refreshed."
+  if (status === "partial") return "At least one render target only partially covers central or evidence-required claims."
+  if (status === "missing") return "At least one render target is missing required narrative coverage."
+  return "At least one render target is stale relative to the current narrative."
+}
+
+function activeHtmlIsCurrent(artifact: NarrativeMapArtifact, artifacts: NarrativeMapArtifact[]): boolean {
+  const expectedHtmlPath = artifact.outputPath?.replace(/\.(pdf|pptx)$/i, ".html")
+  return artifacts.some((item) => item.type === "html_deck" && item.coverageStatus === "current" && (!expectedHtmlPath || item.outputPath === expectedHtmlPath))
+}
+
+function exportCommand(type: RenderTarget["type"]): string | undefined {
+  if (type === "pdf") return "/revela export --deck pdf"
+  if (type === "pptx") return "/revela export --deck pptx"
+  return undefined
+}
+
+function dedupeActions(actions: NarrativeMapNextAction[]): NarrativeMapNextAction[] {
+  const seen = new Set<string>()
+  return actions.filter((action) => {
+    const key = `${action.kind}:${action.command}`
+    if (seen.has(key)) return false
+    seen.add(key)
+    return true
+  })
+}
+
 function claimRecordsInNarrativeOrder(narrative: NarrativeStateV1, claimsByStatus: Record<NarrativeClaim["evidenceStatus"], NarrativeMapClaim[]>): NarrativeMapClaim[] {
   const records = new Map(Object.values(claimsByStatus).flat().map((claim) => [claim.id, claim]))
   return narrative.claims.map((claim) => records.get(claim.id)).filter((claim): claim is NarrativeMapClaim => Boolean(claim))
@@ -197,6 +497,7 @@ export function formatNarrativeMap(map: NarrativeMap): string {
       for (const evidence of claim.evidence) {
         lines.push(`  Evidence: ${evidenceLine(evidence)}`)
       }
+      if (claim.nextActions.length > 0) lines.push(`  Next actions: ${claim.nextActions.map((action) => `${action.label} (${action.command})`).join("; ")}`)
     }
   }
 
@@ -245,6 +546,22 @@ export function formatNarrativeMap(map: NarrativeMap): string {
     if (artifact.note) lines.push(`  Note: ${artifact.note}`)
   }
 
+  lines.push("", "## Story Workbench")
+  lines.push(`- Summary approval: ${map.workbench.summary.approval}`)
+  lines.push(`- Summary evidence blockers: ${map.workbench.summary.evidenceBlockersCount}`)
+  lines.push(`- Summary artifact status: ${map.workbench.summary.artifactStatus}`)
+  lines.push(`- Summary primary next command: ${map.workbench.summary.primaryNextCommand}`)
+  lines.push(`- Summary primary next reason: ${map.workbench.summary.primaryNextReason}`)
+  for (const filter of map.workbench.filters) lines.push(`- Filter ${filter.id}: ${filter.count}${filter.claimIds.length ? ` (${filter.claimIds.join(", ")})` : ""}`)
+  if (map.workbench.renderTargetAction) lines.push(`- Render target action: ${map.workbench.renderTargetAction.label} (${map.workbench.renderTargetAction.command})`)
+  for (const item of map.workbench.artifactCoverage) {
+    lines.push(`- Artifact work item: ${item.type}: ${item.outputPath ?? item.artifactId} [${item.coverageStatus}] -> ${item.recommendedNextCommand}`)
+    lines.push(`  Status note: ${item.statusNote}`)
+    if (item.missingClaimIds.length) lines.push(`  Missing claims: ${item.missingClaimIds.join(", ")}`)
+    if (item.affectedClaimIds.length) lines.push(`  Affected claims: ${item.affectedClaimIds.join(", ")}`)
+    if (item.affectedSlides.length) lines.push(`  Affected slides: ${item.affectedSlides.map((slide) => `${slide.slideIndex}:${slide.claimId}`).join(", ")}`)
+  }
+
   lines.push("", "## Next Actions")
   if (map.nextActions.length === 0) lines.push("- None")
   else for (const action of map.nextActions) lines.push(`- ${action}`)