@cyber-dash-tech/revela 0.15.4 → 0.16.1

package/lib/commands/narrative.ts

@@ -124,7 +124,13 @@ export function buildNarrativeViewPrompt(options: { workspaceRoot: string; langu
     })),
     relations: map.claimRelations.map((relation) => ({ id: relation.id, fromClaimId: relation.fromClaimId, toClaimId: relation.toClaimId, relation: relation.relation, rationale: relation.rationale, inferred: relation.inferred })),
     researchGaps: map.researchGaps.map((gap) => ({ id: gap.id, targetType: gap.targetType, targetId: gap.targetId, status: gap.status, priority: gap.priority, question: gap.question })),
-    artifactCoverage: map.artifactCoverage.map((artifact) => ({ type: artifact.type, outputPath: artifact.outputPath, stale: artifact.stale, slideRefs: artifact.slideRefs.map((ref) => ({ claimId: ref.claimId, slideIndex: ref.slideIndex, role: ref.role, match: ref.match, location: ref.location })) })),
+    artifactCoverage: map.artifactCoverage.map((artifact) => ({ type: artifact.type, outputPath: artifact.outputPath, stale: artifact.stale, coverageStatus: artifact.coverageStatus, affectedClaimIds: artifact.affectedClaimIds, missingClaimIds: artifact.missingClaimIds, slideRefs: artifact.slideRefs.map((ref) => ({ claimId: ref.claimId, slideIndex: ref.slideIndex, role: ref.role, match: ref.match, location: ref.location })) })),
+    workbench: {
+      summary: map.workbench.summary,
+      filters: map.workbench.filters,
+      renderTargetAction: map.workbench.renderTargetAction,
+      artifactCoverage: map.workbench.artifactCoverage.map((item) => ({ type: item.type, outputPath: item.outputPath, coverageStatus: item.coverageStatus, affectedClaimIds: item.affectedClaimIds, missingClaimIds: item.missingClaimIds, statusNote: item.statusNote, recommendedNextCommand: item.recommendedNextCommand })),
+    },
   }
 
   return `Prepare the read-only Revela narrative UI display model.
@@ -141,11 +147,11 @@ Hard rules:
 - Do not invent new claims, evidence, relations, slide coverage, source paths, findings files, quotes, or caveats.
 - Preserve every claimId exactly.
 - Preserve every relation endpoint exactly: fromClaimId, toClaimId, relation.
-- You may only organize and localize display copy for the UI: pageTitle, summaryLine, section labels, claim card displayTitle, roleLabel, narrativeJob, evidenceSummary, riskOrGapSummary, relation displayLabel, and relation displayRationale.
+- You may only organize and localize display copy for the UI: pageTitle, summaryLine, section labels including Story workbench labels, claim card displayTitle, roleLabel, narrativeJob, evidenceSummary, riskOrGapSummary, relation displayLabel, and relation displayRationale.
 - For inferred relations, do not provide relation displayLabel or displayRationale; inferred relations are unconfirmed order notes, not causal/support/dependency judgments.
 - relation displayRationale may only localize or clarify an existing canonical relation rationale. If relation.rationale is missing or the relation is inferred, do not provide displayRationale; the UI will show the missing or inferred status.
 - Keep source paths, findings files, claim IDs, narrative hash, and numbers unchanged.
-- Translate normal UI/display text into the target language request: pageTitle, summaryLine, labels, claim displayTitle, roleLabel, narrativeJob, evidenceSummary, riskOrGapSummary, relation displayLabel, and relation displayRationale.
+- Translate normal UI/display text into the target language request: pageTitle, summaryLine, labels including workbench labels, claim displayTitle, roleLabel, narrativeJob, evidenceSummary, riskOrGapSummary, relation displayLabel, and relation displayRationale.
 - Do not translate claim IDs, relation endpoints, narrative hash, source paths, findings files, URLs, numbers, or quoted/source facts.
 - Use natural business and manufacturing terminology in the target language, not word-by-word machine translation.
 - If a fact is missing, describe it as missing instead of filling it in.

package/lib/commands/review.ts

@@ -205,7 +205,7 @@ Workflow:
 8. For substantial decision decks, preserve a compact \`narrativeBrief\` through \`upsertDeck\` when the conversation or confirmed plan supports it. Do not invent stakeholder beliefs, objections, or risks; leave gaps visible if unknown.
 9. For substantial decision decks, launch the Task subagent with \`subagent_type: "revela-narrative-reviewer"\` after deck/slides are up to date. Ask it to read the current \`DECKS.json\`, run only its fixed rubric, use stable finding IDs, return \`Findings: none\` when all checks pass, and avoid optional pre-write improvements. Do not ask it to write state, call \`revela-decks review\`, or produce HTML.
 10. Call \`revela-decks\` action \`review\`. The tool computes and writes \`writeReadiness\` plus structured readiness issues for the current workspace deck.
-11. Briefly report whether the deck is ready. If blocked, list the exact blockers returned by the tool. If warnings exist, list them after blockers as residual risks; separate evidence/source warnings from narrative warnings when possible. If the review result includes \`evidenceCandidates\`, add a separate \`Candidate evidence bindings\` section with candidateId, slide index/title, supported claim scope, sourceKind, findingsFile/sourcePath, quote/snippet, caveat, evidenceDraft summary, unsupportedScope, and recommendedRewrite. Tell the user they may explicitly ask to apply selected candidate IDs; do not apply them during review. If candidates are absent but \`evidenceCandidateSearch\` is present, briefly report searched file counts and the best near misses so the user can tell whether review failed to search or searched but did not find a bindable match. If the reviewer returned findings, include them in a separate \`Narrative reviewer notes\` section and label them advisory.
+11. Briefly report whether the deck is ready. If blocked, list the exact blockers returned by the tool. If warnings exist, list them after blockers as residual risks; separate evidence/source warnings from narrative warnings when possible. If the review result includes \`diagnostics\`, include a \`Plan and coverage diagnostics\` section with plan quality blockers/warnings, artifact \`coverageStatus\`, \`missingClaimIds\`, \`affectedClaimIds\`, stale reasons, and \`nextActions\`. If the review result includes \`evidenceCandidates\`, add a separate \`Candidate evidence bindings\` section with candidateId, slide index/title, supported claim scope, sourceKind, findingsFile/sourcePath, quote/snippet, caveat, evidenceDraft summary, unsupportedScope, and recommendedRewrite. Tell the user they may explicitly ask to apply selected candidate IDs; do not apply them during review. If candidates are absent but \`evidenceCandidateSearch\` is present, briefly report searched file counts and the best near misses so the user can tell whether review failed to search or searched but did not find a bindable match. If the reviewer returned findings, include them in a separate \`Narrative reviewer notes\` section and label them advisory.
 
 Minimum conditions for \`ready\`:
 - Topic, audience, slide count, language, and visual style/design are decided.
@@ -225,6 +225,7 @@ Report format:
 - Start with \`Ready: yes/no\`.
 - If blocked, list each blocker with slide index/title when the tool provides it, the issue type, and the suggested next action.
 - If warnings exist but the deck is otherwise ready, say the deck can be written but note the residual risks.
+- Include coverage-driven make diagnostics when returned: whether the active deck artifact coverage is current/stale/partial/missing, which required claims are missing, which claims are affected, and the next command/action recommended by the tool.
 - Report \`narrative_gap\` warnings as story-structure risks such as weak so-what, missing risk/assumption handling, conclusion before support, missing audience framing, or abrupt transition.
 - Do not invent evidence or silently downgrade blockers. Use the tool result as authoritative.
 - Do not convert \`revela-narrative-reviewer\` advisory findings into tool readiness issues. Keep them separate from \`revela-decks review\` blockers and warnings, and preserve the reviewer's stable finding IDs when reporting them.

package/lib/decks-state.ts

@@ -8,7 +8,7 @@ import {
   workspaceStatePath,
   writeWorkspaceState,
 } from "./workspace-state/repository"
-import { ensureActiveHtmlDeckRenderTarget } from "./workspace-state/render-targets"
+import { activeHtmlDeckRenderTarget, ensureActiveHtmlDeckRenderTarget } from "./workspace-state/render-targets"
 import {
   activeReviewTargetId,
   appendReviewSnapshot,
@@ -19,6 +19,7 @@ import {
 import { WORKSPACE_STATE_FILE, type RenderTarget, type ReviewSnapshot, type WorkspaceAction } from "./workspace-state/types"
 import { normalizeCanonicalNarrativeState, normalizeNarrativeState } from "./narrative-state/normalize"
 import { computeNarrativeHash } from "./narrative-state/hash"
+import { getArtifactClaimRefs } from "./narrative-state/queries"
 import type { NarrativeStateV1 } from "./narrative-state/types"
 
 export const DECKS_STATE_FILE = WORKSPACE_STATE_FILE
@@ -107,6 +108,13 @@ export interface DeckPlanReview {
   confirmedAt?: string
   confirmedBy?: "user"
   summary?: string
+  qualityChecks?: DeckPlanQualityCheck[]
+}
+
+export interface DeckPlanQualityCheck {
+  id: string
+  status: "pass" | "warning" | "blocker"
+  message: string
 }
 
 export interface NarrativeBrief {
@@ -206,6 +214,24 @@ export interface DeckStateReadinessResult {
   warnings: string[]
   issues: ReadinessIssue[]
   evidenceCandidates?: EvidenceBindingCandidate[]
+  diagnostics?: DeckReadinessDiagnostics
+}
+
+export interface DeckReadinessDiagnostics {
+  planQuality: DeckPlanQualityCheck[]
+  artifactCoverage?: ArtifactCoverageDiagnostic
+  nextActions: string[]
+}
+
+export interface ArtifactCoverageDiagnostic {
+  artifactId?: string
+  outputPath?: string
+  coverageStatus: "current" | "stale" | "partial" | "missing" | "unknown"
+  requiredClaimIds: string[]
+  coveredClaimIds: string[]
+  missingClaimIds: string[]
+  affectedClaimIds: string[]
+  staleReasons: string[]
 }
 
 export type ReadinessSeverity = "blocker" | "warning"
@@ -214,6 +240,8 @@ export type ReadinessIssueType =
   | "missing_required_input"
   | "missing_slide_spec"
   | "slide_plan_unconfirmed"
+  | "plan_quality"
+  | "artifact_coverage"
   | "research_not_ready"
   | "missing_evidence"
   | "weak_evidence"
@@ -444,6 +472,7 @@ export function confirmDeckPlan(state: DecksState, options: ConfirmDeckPlanOptio
     confirmedAt: options.now ?? new Date().toISOString(),
     confirmedBy: options.approvedBy ?? "user",
     summary: cleanOptionalText(options.note),
+    qualityChecks: pending?.qualityChecks,
   }
   deck.requiredInputs = { ...deck.requiredInputs, slidePlanConfirmed: true }
   deck.writeReadiness = { status: "blocked", blockers: [] }
@@ -579,7 +608,7 @@ export function reviewDeckState(state: DecksState, slug?: string, options: Revie
     }
   }
 
-  const issues = computeDeckReadinessIssues(deck, normalized.workspace, {
+  const issues = computeDeckReadinessIssues(normalized, deck, {
     ...options,
     narrativeHash: options.narrativeHash ?? computeNarrativeHash(normalizeNarrativeState(normalized)),
   })
@@ -604,6 +633,7 @@ export function reviewDeckState(state: DecksState, slug?: string, options: Revie
     warnings,
     issues,
     evidenceCandidates,
+    diagnostics: deckReadinessDiagnostics(normalized, deck, issues),
   }
   appendReviewSnapshot(normalized, createReviewSnapshot(normalized, { slug: deck.slug, result, reviewedAt }))
   return {
@@ -639,7 +669,7 @@ export function evaluateDeckStateWriteReadiness(state: DecksState, filePath: str
     }
   }
 
-  const issues = computeDeckReadinessIssues(deck, normalized.workspace, {
+  const issues = computeDeckReadinessIssues(normalized, deck, {
     narrativeHash: computeNarrativeHash(normalizeNarrativeState(normalized)),
   })
   const blockers = issues.filter((issue) => issue.severity === "blocker").map((issue) => issue.message)
@@ -715,6 +745,7 @@ export function evaluateDeckStateWriteReadiness(state: DecksState, filePath: str
     blockers,
     warnings,
     issues,
+    diagnostics: deckReadinessDiagnostics(normalized, deck, issues),
   }
 }
 
@@ -871,9 +902,23 @@ function normalizeDeckPlanReview(input: DeckPlanReview | undefined): DeckPlanRev
     confirmedAt: cleanOptionalText(input.confirmedAt),
     confirmedBy: input.confirmedBy === "user" ? "user" : undefined,
     summary: cleanOptionalText(input.summary),
+    qualityChecks: normalizeDeckPlanQualityChecks(input.qualityChecks),
   }
 }
 
+function normalizeDeckPlanQualityChecks(input: DeckPlanQualityCheck[] | undefined): DeckPlanQualityCheck[] | undefined {
+  if (!Array.isArray(input)) return undefined
+  const checks = input.flatMap((item): DeckPlanQualityCheck[] => {
+    if (!item || typeof item !== "object") return []
+    const id = cleanOptionalText(item.id)
+    const message = cleanOptionalText(item.message)
+    if (!id || !message) return []
+    const status = item.status === "blocker" || item.status === "warning" ? item.status : "pass"
+    return [{ id, status, message }]
+  })
+  return checks.length > 0 ? checks : undefined
+}
+
 function currentDeckKey(state: DecksState): string | undefined {
   if (state.activeDeck && state.decks[state.activeDeck]) return state.activeDeck
   const keys = Object.keys(state.decks)
@@ -887,8 +932,9 @@ function currentDeckBlocker(state: DecksState): string {
   return `${DECKS_STATE_FILE} contains multiple deck records and no activeDeck. Select one current deck explicitly or move extra decks to separate workspaces.`
 }
 
-function computeDeckReadinessIssues(deck: DeckSpec, workspace: DecksState["workspace"], options: ReviewDeckStateOptions = {}): ReadinessIssue[] {
+function computeDeckReadinessIssues(state: DecksState, deck: DeckSpec, options: ReviewDeckStateOptions = {}): ReadinessIssue[] {
   const issues: ReadinessIssue[] = []
+  const workspace = state.workspace
   if (!deck.goal.trim()) issues.push(blockerIssue("missing_slide_spec", "Deck goal is missing", "Set the deck goal through revela-decks upsertDeck."))
   if (!isDeckHtmlPath(deck.outputPath)) {
     issues.push(blockerIssue(
@@ -919,6 +965,8 @@ function computeDeckReadinessIssues(deck: DeckSpec, workspace: DecksState["works
       ))
     }
   }
+  issues.push(...deckPlanQualityIssues(deck))
+  issues.push(...artifactCoverageIssues(state, deck))
   for (const slide of deck.slides) {
     const slideRef = { slideIndex: slide.index, slideTitle: slide.title }
     if (!slide.title.trim()) issues.push(blockerIssue("missing_slide_spec", `Slide ${slide.index} title is missing`, "Add a slide title to the slide spec.", slideRef))
@@ -985,6 +1033,96 @@ function computeDeckReadinessIssues(deck: DeckSpec, workspace: DecksState["works
   return issues
 }
 
+function deckPlanQualityIssues(deck: DeckSpec): ReadinessIssue[] {
+  const checks = deck.planReview?.qualityChecks ?? []
+  return checks.flatMap((check): ReadinessIssue[] => {
+    if (check.status === "pass") return []
+    const suggestedAction = check.status === "blocker"
+      ? "Re-run compileDeckPlan or revise the deck projection so the deterministic plan includes Cover, TOC, central claim coverage, compatible components, and Closing/Decision Ask before confirming or writing the deck."
+      : "Keep the stated claim boundaries visible in the plan and rendered artifact; do not stretch partial evidence beyond the supported scope."
+    return [{
+      type: "plan_quality",
+      severity: check.status,
+      message: check.message,
+      suggestedAction,
+    }]
+  })
+}
+
+function artifactCoverageIssues(state: DecksState, deck: DeckSpec): ReadinessIssue[] {
+  const coverage = artifactCoverageDiagnostic(state, deck)
+  if (!coverage) return []
+  const issues: ReadinessIssue[] = []
+  if (coverage.missingClaimIds.length > 0) {
+    issues.push(blockerIssue(
+      "artifact_coverage",
+      `Active deck plan is missing required narrative claims: ${coverage.missingClaimIds.join(", ")}`,
+      "Re-run compileDeckPlan or revise the deck projection so every central or evidence-required claim appears in the planned slides before writing the deck.",
+    ))
+  }
+  if (coverage.coverageStatus === "stale") {
+    issues.push(blockerIssue(
+      "artifact_coverage",
+      `Active deck artifact coverage is stale: ${coverage.staleReasons.join("; ") || "narrative or render target changed"}`,
+      "Re-run /revela make --deck so the deck plan and artifact coverage are regenerated from the current approved narrative state.",
+    ))
+  } else if (coverage.coverageStatus === "partial") {
+    issues.push(warningIssue(
+      "artifact_coverage",
+      `Active deck artifact coverage is partial: ${coverage.affectedClaimIds.join(", ") || "some claims are not fully mapped"}`,
+      "Keep the partial coverage visible in the make report and review the affected claims before exporting or presenting the deck.",
+    ))
+  }
+  return issues
+}
+
+function deckReadinessDiagnostics(state: DecksState, deck: DeckSpec, issues: ReadinessIssue[]): DeckReadinessDiagnostics {
+  const planQuality = deck.planReview?.qualityChecks ?? []
+  const artifactCoverage = artifactCoverageDiagnostic(state, deck)
+  return {
+    planQuality,
+    ...(artifactCoverage ? { artifactCoverage } : {}),
+    nextActions: readinessNextActions(issues, artifactCoverage),
+  }
+}
+
+function artifactCoverageDiagnostic(state: DecksState, deck: DeckSpec): ArtifactCoverageDiagnostic | undefined {
+  const target = activeHtmlDeckRenderTarget(state)
+  const artifact = getArtifactClaimRefs(state).find((item) => item.type === "html_deck" && normalizeDeckPath(item.outputPath ?? "") === normalizeDeckPath(deck.outputPath))
+  const data = target?.data ?? {}
+  const requiredClaimIds = stringArray(data.requiredClaimIds)
+  const coveredClaimIds = stringArray(data.coveredClaimIds)
+  const missingClaimIds = [...new Set([...(artifact?.missingClaimIds ?? []), ...stringArray(data.missingClaimIds)])].sort()
+  const affectedClaimIds = [...new Set([...(artifact?.affectedClaimIds ?? []), ...missingClaimIds])].sort()
+  const staleReasons = artifact?.staleReasons ?? []
+  const coverageStatus = artifact?.coverageStatus ?? (target ? (missingClaimIds.length > 0 ? "missing" : "current") : "unknown")
+  if (!target && !artifact && requiredClaimIds.length === 0 && coveredClaimIds.length === 0 && missingClaimIds.length === 0) return undefined
+  return {
+    artifactId: artifact?.artifactId ?? target?.id,
+    outputPath: artifact?.outputPath ?? target?.outputPath ?? deck.outputPath,
+    coverageStatus,
+    requiredClaimIds: [...new Set([...(artifact?.claimIds ?? []), ...requiredClaimIds, ...missingClaimIds])].filter((id) => requiredClaimIds.length === 0 || requiredClaimIds.includes(id) || missingClaimIds.includes(id)).sort(),
+    coveredClaimIds: [...new Set([...(artifact?.claimIds ?? []), ...coveredClaimIds])].filter((id) => missingClaimIds.length === 0 || !missingClaimIds.includes(id)).sort(),
+    missingClaimIds,
+    affectedClaimIds,
+    staleReasons,
+  }
+}
+
+function readinessNextActions(issues: ReadinessIssue[], coverage?: ArtifactCoverageDiagnostic): string[] {
+  const actions = issues
+    .filter((issue) => issue.severity === "blocker" || issue.type === "plan_quality" || issue.type === "artifact_coverage")
+    .map((issue) => issue.suggestedAction)
+  if (coverage?.missingClaimIds.length) actions.unshift("Review missingClaimIds in artifactCoverage and recompile the deterministic deck plan before writing HTML.")
+  if (coverage?.coverageStatus === "stale") actions.unshift("Regenerate the deck plan from the current narrative before writing or exporting artifacts.")
+  return [...new Set(actions)].slice(0, 5)
+}
+
+function stringArray(value: unknown): string[] {
+  if (!Array.isArray(value)) return []
+  return [...new Set(value.filter((item): item is string => typeof item === "string" && item.trim().length > 0).map((item) => item.trim()))].sort()
+}
+
 function findEvidenceBindingCandidates(deck: DeckSpec, slide: SlideSpec, claimText: string, options: ReviewDeckStateOptions): { candidates: EvidenceBindingCandidate[]; search?: EvidenceCandidateSearchDiagnostic } {
   if (!options.workspaceRoot) return { candidates: [] }
   const queryText = slideSearchText(slide)

package/lib/narrative-state/display.ts

@@ -29,6 +29,16 @@ export interface NarrativeDisplayLabels {
   risks: string
   researchGaps: string
   coveredSlides: string
+  storyWorkbench: string
+  workbenchNote: string
+  artifactCoverage: string
+  noRenderTargets: string
+  nextActions: string
+  missingClaims: string
+  affectedClaims: string
+  affectedSlides: string
+  notes: string
+  recommendedNextCommand: string
   noClaims: string
   none: string
 }
@@ -79,6 +89,16 @@ export function defaultNarrativeDisplayLabels(language: NarrativeViewLanguage):
       risks: "风险",
       researchGaps: "研究缺口",
       coveredSlides: "已覆盖页面",
+      storyWorkbench: "Story 工作台",
+      workbenchNote: "按证据缺口、风险、异议和产物覆盖过滤主张；这里只读展示下一步命令，不修改叙事状态。",
+      artifactCoverage: "产物覆盖",
+      noRenderTargets: "未记录 render target",
+      nextActions: "下一步",
+      missingClaims: "缺失主张",
+      affectedClaims: "受影响主张",
+      affectedSlides: "受影响页面",
+      notes: "说明",
+      recommendedNextCommand: "建议命令",
       noClaims: "没有记录主张",
       none: "无",
     }
@@ -101,6 +121,16 @@ export function defaultNarrativeDisplayLabels(language: NarrativeViewLanguage):
       risks: "リスク",
       researchGaps: "調査ギャップ",
       coveredSlides: "対応スライド",
+      storyWorkbench: "Story ワークベンチ",
+      workbenchNote: "根拠ギャップ、リスク、反論、成果物カバレッジでクレームを絞り込みます。ここでは次のコマンドだけを読み取り専用で示し、ナラティブ状態は変更しません。",
+      artifactCoverage: "成果物カバレッジ",
+      noRenderTargets: "render target は記録されていません",
+      nextActions: "次のアクション",
+      missingClaims: "不足クレーム",
+      affectedClaims: "影響クレーム",
+      affectedSlides: "影響スライド",
+      notes: "メモ",
+      recommendedNextCommand: "推奨コマンド",
       noClaims: "クレームは記録されていません",
       none: "なし",
     }
@@ -122,6 +152,16 @@ export function defaultNarrativeDisplayLabels(language: NarrativeViewLanguage):
     risks: "Risks",
     researchGaps: "Research gaps",
     coveredSlides: "Covered slides",
+    storyWorkbench: "Story workbench",
+    workbenchNote: "Filter claims by evidence gaps, risks, objections, and artifact coverage. This view only suggests next commands; it does not mutate narrative state.",
+    artifactCoverage: "Artifact coverage",
+    noRenderTargets: "No render targets recorded",
+    nextActions: "Next actions",
+    missingClaims: "Missing claims",
+    affectedClaims: "Affected claims",
+    affectedSlides: "Affected slides",
+    notes: "Notes",
+    recommendedNextCommand: "Recommended next command",
     noClaims: "No claims recorded",
     none: "None",
   }

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: "背景",