npm - @cyber-dash-tech/revela - Versions diffs - 0.12.0 → 0.14.0 - Mend

@cyber-dash-tech/revela 0.12.0 → 0.14.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (37) hide show

package/README.md +16 -16
package/README.zh-CN.md +16 -16
package/lib/commands/brief.ts +63 -0
package/lib/commands/edit.ts +7 -5
package/lib/commands/help.ts +5 -3
package/lib/commands/inspect.ts +7 -5
package/lib/commands/narrative.ts +160 -0
package/lib/decks-state.ts +33 -0
package/lib/edit/prompt.ts +3 -0
package/lib/inspect/prompt.ts +15 -2
package/lib/inspect/requests.ts +21 -2
package/lib/inspection-context/compile.ts +230 -10
package/lib/inspection-context/match.ts +71 -1
package/lib/inspection-context/project.ts +131 -8
package/lib/inspection-context/result.ts +183 -0
package/lib/narrative-state/coverage.ts +100 -0
package/lib/narrative-state/display.ts +219 -0
package/lib/narrative-state/executive-brief.ts +246 -0
package/lib/narrative-state/hash.ts +9 -0
package/lib/narrative-state/map-html.ts +348 -0
package/lib/narrative-state/map.ts +282 -0
package/lib/narrative-state/normalize.ts +54 -0
package/lib/narrative-state/queries.ts +434 -0
package/lib/narrative-state/readiness.ts +71 -1
package/lib/narrative-state/render-plan.ts +44 -1
package/lib/narrative-state/research-gaps.ts +191 -0
package/lib/narrative-state/types.ts +33 -0
package/lib/refine/server.ts +91 -13
package/lib/workspace-state/evidence-status.ts +21 -1
package/lib/workspace-state/graph.ts +56 -2
package/lib/workspace-state/types.ts +10 -1
package/package.json +1 -1
package/plugin.ts +33 -2
package/tools/decks.ts +86 -1
package/tools/edit.ts +10 -8
package/tools/inspection-result.ts +37 -0
package/tools/narrative-view.ts +84 -0

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

@@ -0,0 +1,348 @@
+import type { NarrativeMap, NarrativeMapClaim, NarrativeMapClaimRelation } from "./map"
+import { emptyDisplayModel, isChineseLanguage, isJapaneseLanguage, relationKey, type ValidatedNarrativeDisplayModel } from "./display"
+interface FlowNode {
+  id: string
+  claim: NarrativeMapClaim
+  title: string
+  displayCard?: ReturnType<ValidatedNarrativeDisplayModel["claimCards"]["get"]>
+  detailHtml: string
+}
+export function renderNarrativeMapHtml(map: NarrativeMap, display?: ValidatedNarrativeDisplayModel): string {
+  return renderNarrativeMapHtmlWithDisplay(map, display)
+}
+export function renderNarrativeMapHtmlWithDisplay(map: NarrativeMap, display: ValidatedNarrativeDisplayModel = emptyDisplayModel("en")): string {
+  const title = `Revela Claim Flow - ${map.snapshot.narrativeHash}`
+  const nodes = buildFlowNodes(map, display)
+  const initial = nodes[0]
+  const inferredCount = map.claimRelations.filter((relation) => relation.inferred).length
+  const pageTitle = display.pageTitle ?? valueOrFallback(map.snapshot.thesis, map.snapshot.decisionAction || "Narrative claim flow")
+  const summaryLine = display.summaryLine ?? "Claims are the main path. Evidence, risks, gaps, objections, and artifact coverage stay in the selected-claim panel."
+  const nonCurrentArtifacts = map.artifactCoverage.filter((artifact) => artifact.coverageStatus !== "current").length
+  return `<!doctype html>
+<html lang="${escapeAttr(display.language)}">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <title>${escapeHtml(title)}</title>
+  <style>
+    :root { color-scheme:light; --bg:#f5f1e9; --paper:#fffdf8; --ink:#1c1917; --muted:#766d63; --line:#ded4c7; --accent:#d8612b; --good:#177044; --warn:#a56015; --bad:#a33434; --soft:#f7f0e7; --shadow:0 20px 54px rgba(54,43,31,.13); font-family:Inter,ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif; }
+    * { box-sizing:border-box; }
+    body { margin:0; min-height:100vh; background:radial-gradient(circle at 12% 0,#fff7ed 0,transparent 26rem),radial-gradient(circle at 85% 10%,#edf4f0 0,transparent 24rem),var(--bg); color:var(--ink); }
+    .shell { max-width:1440px; margin:0 auto; padding:22px; }
+    .topbar { background:rgba(255,253,248,.9); border:1px solid var(--line); border-radius:24px; box-shadow:var(--shadow); padding:20px 22px; display:grid; grid-template-columns:minmax(0,1fr) auto; gap:18px; align-items:start; }
+    .eyebrow { margin:0; color:var(--accent); font-size:12px; font-weight:850; letter-spacing:.15em; text-transform:uppercase; }
+    h1 { margin:7px 0 0; max-width:860px; font-size:clamp(24px,3.2vw,42px); line-height:1.02; letter-spacing:-.05em; }
+    .summary { margin:10px 0 0; color:var(--muted); font-size:14px; line-height:1.45; max-width:920px; }
+    .pills { display:flex; flex-wrap:wrap; justify-content:flex-end; gap:8px; }
+    .pill { display:inline-flex; border-radius:999px; padding:7px 10px; font-size:12px; font-weight:780; border:1px solid var(--line); background:#fff; color:var(--muted); white-space:nowrap; }
+    .pill.current,.pill.supported { color:var(--good); background:#e8f4ed; border-color:#b9dcc8; }
+    .pill.stale,.pill.missing { color:var(--bad); background:#fbe7e7; border-color:#efb9b9; }
+    .pill.partial,.pill.weak,.pill.open { color:var(--warn); background:#fff1dc; border-color:#edd0a5; }
+    .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; }
+    .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; }
+    .claim-list { display:flex; flex-direction:column; gap:0; }
+    .claim-step { display:grid; grid-template-columns:42px minmax(0,1fr); gap:14px; }
+    .step-rail { display:flex; flex-direction:column; align-items:center; }
+    .step-dot { width:32px; height:32px; border-radius:999px; display:grid; place-items:center; background:#fff; border:1px solid var(--line); color:var(--muted); font-size:12px; font-weight:850; }
+    .step-line { flex:1; width:2px; min-height:30px; background:linear-gradient(var(--line),rgba(222,212,199,.25)); margin:8px 0; }
+    .claim-step:last-child .step-line { display:none; }
+    .claim-card { width:100%; text-align:left; cursor:pointer; border:1px solid var(--line); border-left:6px solid var(--good); background:#fff; color:var(--ink); border-radius:18px; padding:15px 16px; margin-bottom:16px; box-shadow:0 10px 26px rgba(67,49,31,.08); transition:border-color .15s ease,box-shadow .15s ease,transform .15s ease; }
+    .claim-card:hover,.claim-card.active { border-color:var(--accent); box-shadow:0 14px 32px rgba(143,62,24,.15); transform:translateY(-1px); }
+    .claim-card.partial,.claim-card.weak { border-left-color:var(--warn); }
+    .claim-card.missing { border-left-color:var(--bad); }
+    .claim-title { display:block; font-size:18px; font-weight:850; line-height:1.2; letter-spacing:-.018em; }
+    .claim-meta { display:flex; flex-wrap:wrap; gap:6px; margin-top:10px; }
+    .tag { display:inline-flex; border-radius:999px; padding:4px 8px; background:var(--soft); color:var(--muted); font-size:11px; font-weight:800; }
+    .claim-sections { margin-top:13px; display:grid; gap:9px; }
+    .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; }
+    .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; }
+    .relation-target { display:block; color:#51483f; font-weight:720; }
+    .relation-note { display:block; margin-top:3px; color:var(--muted); }
+    .relation.inferred .relation-badge { background:#f4f0ea; border-color:var(--line); color:var(--muted); }
+    .detail-panel { position:sticky; top:18px; max-height:calc(100vh - 36px); overflow:hidden; display:flex; flex-direction:column; }
+    .detail-head { padding:20px 20px 14px; border-bottom:1px solid var(--line); }
+    .detail-title { margin:7px 0 0; font-size:22px; line-height:1.12; letter-spacing:-.035em; }
+    .detail-sub { margin-top:8px; color:var(--muted); font-size:13px; line-height:1.4; }
+    .detail-body { padding:16px 20px 22px; overflow:auto; }
+    .detail-card { border:1px solid var(--line); border-radius:16px; padding:13px; background:#fff; margin-bottom:10px; }
+    .detail-card h3 { margin:0 0 8px; font-size:13px; letter-spacing:-.01em; }
+    .detail-card p { margin:0; color:var(--muted); line-height:1.45; font-size:13px; }
+    .empty { color:var(--muted); font-style:italic; }
+    .hidden-detail { display:none; }
+    @media (max-width:1100px) { .layout { grid-template-columns:1fr; } .detail-panel { position:static; max-height:none; } .topbar { grid-template-columns:1fr; } .pills { justify-content:flex-start; } }
+    @media (max-width:680px) { .shell { padding:12px; } .topbar,.flow,.detail-panel { border-radius:18px; } .claim-step { grid-template-columns:30px minmax(0,1fr); gap:10px; } .step-dot { width:26px; height:26px; font-size:11px; } .claim-title { font-size:16px; } }
+  </style>
+</head>
+<body>
+  <main class="shell">
+    <header class="topbar">
+      <div>
+        <p class="eyebrow">${escapeHtml(display.labels.eyebrow)}</p>
+        <h1>${escapeHtml(pageTitle)}</h1>
+        <p class="summary">${escapeHtml(summaryLine)}</p>
+      </div>
+      <div class="pills">
+        <span class="pill ${escapeAttr(map.snapshot.approval)}">${escapeHtml(systemTerm("approval", display))}: ${escapeHtml(localizeValue(map.snapshot.approval, display))}</span>
+        <span class="pill">${escapeHtml(display.labels.status)}: ${escapeHtml(localizeValue(map.snapshot.status, display))}</span>
+        <span class="pill supported">${escapeHtml(systemTerm("claims", display))}: ${nodes.length}</span>
+        <span class="pill ${inferredCount > 0 ? "open" : "current"}">${escapeHtml(systemTerm("relations", display))}: ${map.claimRelations.length}${inferredCount > 0 ? ` (${inferredCount} ${escapeHtml(systemTerm("inferred", display))})` : ""}</span>
+        <span class="pill ${nonCurrentArtifacts > 0 ? "partial" : "current"}">${escapeHtml(systemTerm("artifacts", display))}: ${map.artifactCoverage.length}${nonCurrentArtifacts > 0 ? ` (${nonCurrentArtifacts} ${escapeHtml(systemTerm("attention", display))})` : ""}</span>
+      </div>
+    </header>
+    <div class="layout">
+      <section class="flow" aria-label="Narrative claim flow board">
+        <div class="flow-head">
+          <div>
+            <h2>${escapeHtml(display.labels.claimFlow)}</h2>
+            <p class="flow-note">${escapeHtml(display.labels.flowNote)}</p>
+          </div>
+        </div>
+        <div class="claim-list">
+          ${nodes.length ? nodes.map((node, index) => renderStep(node, map, display, index, index === 0)).join("") : emptyCard(display.labels.claimFlow, display.labels.noClaims)}
+        </div>
+      </section>
+      <aside class="detail-panel">
+        <div class="detail-head">
+          <p class="eyebrow">${escapeHtml(display.labels.selectedClaim)}</p>
+          <h2 class="detail-title" id="detail-title">${escapeHtml(initial?.title ?? display.labels.noClaims)}</h2>
+          <div class="detail-sub" id="detail-sub">${escapeHtml(initial ? claimSubtitle(initial.claim, display) : "Run /revela init to create narrative claims.")}</div>
+        </div>
+        <div class="detail-body" id="detail-body">${initial?.detailHtml ?? emptyCard(display.labels.claimFlow, display.labels.noClaims)}</div>
+      </aside>
+    </div>
+  </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 title = document.getElementById('detail-title');
+    const sub = document.getElementById('detail-sub');
+    const body = document.getElementById('detail-body');
+    function selectClaim(id) {
+      const template = document.getElementById('detail-' + CSS.escape(id));
+      if (!template) return;
+      title.textContent = template.dataset.title || '';
+      sub.textContent = template.dataset.subtitle || '';
+      body.innerHTML = template.innerHTML;
+      buttons.forEach((button) => button.classList.toggle('active', button.dataset.nodeId === id));
+    }
+    buttons.forEach((button) => button.addEventListener('click', () => selectClaim(button.dataset.nodeId)));
+  </script>
+</body>
+</html>`
+}
+function buildFlowNodes(map: NarrativeMap, display: ValidatedNarrativeDisplayModel): FlowNode[] {
+  return allClaims(map).map((claim) => ({
+    id: nodeId(claim.id),
+    claim,
+    title: display.claimCards.get(claim.id)?.displayTitle ?? claim.text,
+    displayCard: display.claimCards.get(claim.id),
+    detailHtml: claimDetail(claim, map, display),
+  }))
+}
+function renderStep(node: FlowNode, map: NarrativeMap, display: ValidatedNarrativeDisplayModel, index: number, active: boolean): string {
+  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">
+      <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)}
+      ${outgoing.length ? `<span class="relation-strip">${outgoing.map((relation) => renderOutgoingRelation(relation, display)).join("")}</span>` : ""}
+    </button>
+  </div>`
+}
+function renderDisplayCardSummary(card: FlowNode["displayCard"], display: ValidatedNarrativeDisplayModel): string {
+  if (!card) return ""
+  const labels = sectionLabels(display)
+  const rows: Array<[string, string | undefined]> = [
+    [labels.role, card.roleLabel],
+    [labels.narrativeJob, card.narrativeJob],
+    [labels.evidenceSummary, card.evidenceSummary],
+    [labels.riskOrGapSummary, card.riskOrGapSummary],
+  ]
+  if (rows.length === 0) return ""
+  return `<span class="claim-sections">${rows.filter(([, value]) => Boolean(value)).map(([label, value]) => `<span class="claim-section"><span class="section-label">${escapeHtml(label)}</span><span class="section-text">${escapeHtml(value)}</span></span>`).join("")}</span>`
+}
+function renderOutgoingRelation(relation: NarrativeMapClaimRelation, display: ValidatedNarrativeDisplayModel): string {
+  const label = relationDisplayLabel(relation, display, true)
+  const target = displayClaimText(relation.toClaimId, relation.toClaimText, display)
+  const rationale = relationDisplayRationale(relation, display)
+  return `<span class="relation${relation.inferred ? " inferred" : ""}"><span class="relation-badge">${escapeHtml(label)}</span><span><span class="relation-target">${escapeHtml(systemTerm("to", display))}: ${escapeHtml(shorten(target, 120))}</span>${rationale ? `<span class="relation-note">${escapeHtml(systemTerm("rationale", display))}: ${escapeHtml(rationale)}</span>` : ""}</span></span>`
+}
+function claimDetail(claim: NarrativeMapClaim, map: NarrativeMap, display: ValidatedNarrativeDisplayModel): string {
+  const incoming = map.claimRelations.filter((relation) => relation.toClaimId === claim.id)
+  const outgoing = map.claimRelations.filter((relation) => relation.fromClaimId === claim.id)
+  const objections = map.objections.filter((item) => item.claimId === claim.id)
+  const risks = map.risks.filter((item) => item.claimId === claim.id)
+  const gaps = map.researchGaps.filter((item) => item.targetType === "claim" && item.targetId === claim.id)
+  const slideRefs = map.artifactCoverage.flatMap((artifact) => artifact.slideRefs.filter((ref) => ref.claimId === claim.id).map((ref) => `${artifact.type} slide ${ref.slideIndex} (${ref.role}, ${ref.match}/${ref.location}, coverage:${artifact.coverageStatus})`))
+  const coverageGaps = map.artifactCoverage.filter((artifact) => artifact.missingClaimIds.includes(claim.id) || artifact.affectedClaimIds.includes(claim.id))
+  const card = display.claimCards.get(claim.id)
+  return detailCards([
+    [display.labels.claim, claim.text],
+    ...(card?.narrativeJob ? [[card.roleLabel || display.labels.claim, card.narrativeJob] as [string, string]] : []),
+    ...(card?.evidenceSummary ? [[display.labels.evidence, card.evidenceSummary] as [string, string]] : []),
+    ...(card?.riskOrGapSummary ? [[display.labels.researchGaps, card.riskOrGapSummary] as [string, string]] : []),
+    [display.labels.claimId, claim.id],
+    [display.labels.status, `${localizeValue(claim.evidenceStatus, display)} / ${localizeValue(claim.importance, display)} / ${localizeValue(claim.kind, display)}`],
+    ...(claim.supportedScope ? [[display.labels.supportedScope, claim.supportedScope] as [string, string]] : []),
+    ...(claim.unsupportedScope ? [[display.labels.unsupportedScope, claim.unsupportedScope] as [string, string]] : []),
+    [display.labels.incomingRelations, incoming.length ? incoming.map((relation) => relationText(relation, display)).join("<br><br>") : display.labels.none],
+    [display.labels.outgoingRelations, outgoing.length ? outgoing.map((relation) => relationText(relation, display)).join("<br><br>") : display.labels.none],
+    ...(claim.evidence.length ? claim.evidence.map((evidence) => [`${display.labels.evidence}: ${evidence.source}`, evidenceDetailText(evidence, display)] as [string, string]) : [[display.labels.evidence, display.labels.none] as [string, string]]),
+    ...(objections.length ? [[display.labels.objections, objections.map((item) => `${item.text}${item.response ? ` -> ${item.response}` : ""}`).join("<br>")] as [string, string]] : []),
+    ...(risks.length ? [[display.labels.risks, risks.map((item) => `${item.text}${item.mitigation ? ` -> ${item.mitigation}` : ""}`).join("<br>")] as [string, string]] : []),
+    ...(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]] : []),
+  ])
+}
+function relationText(relation: NarrativeMapClaimRelation, display: ValidatedNarrativeDisplayModel): string {
+  const from = displayClaimText(relation.fromClaimId, relation.fromClaimText, display)
+  const to = displayClaimText(relation.toClaimId, relation.toClaimText, display)
+  const label = relationDisplayLabel(relation, display, false)
+  const rationale = relationDisplayRationale(relation, display)
+  return `${systemTerm("relation", display)}: ${label}${relation.inferred ? ` (${systemTerm("inferred", display)})` : ""}<br>${systemTerm("from", display)}: ${from}<br>${systemTerm("to", display)}: ${to}${rationale ? `<br>${systemTerm("rationale", display)}: ${rationale}` : ""}`
+}
+function displayClaimText(claimId: string, fallback: string | undefined, display: ValidatedNarrativeDisplayModel): string {
+  return display.claimCards.get(claimId)?.displayTitle ?? fallback ?? claimId
+}
+function relationDisplayLabel(relation: NarrativeMapClaimRelation, display: ValidatedNarrativeDisplayModel, _includeInferred: boolean): string {
+  if (relation.inferred) return inferredRelationLabel(display)
+  const label = display.relations.get(relationKey(relation))?.displayLabel ?? localizeValue(relation.relation, display)
+  return label
+}
+function relationDisplayRationale(relation: NarrativeMapClaimRelation, display: ValidatedNarrativeDisplayModel): string | undefined {
+  const displayRationale = display.relations.get(relationKey(relation))?.displayRationale
+  if (displayRationale) return displayRationale
+  if (relation.inferred) return inferredRationale(display)
+  return relation.rationale ?? missingRationale(display)
+}
+function inferredRationale(display: ValidatedNarrativeDisplayModel): string {
+  if (isChineseLanguage(display.language)) return "仅表示两个主张在当前叙事顺序中相邻；系统未判断因果、支撑或依赖关系。需要在 claimRelations 中写入客观 rationale 后才算确认。"
+  if (isJapaneseLanguage(display.language)) return "現在のナラティブ順序で隣接していることだけを示します。因果、裏付け、依存関係は判断していません。確認するには claimRelations に客観的な rationale を記録してください。"
+  return "Only indicates that the two claims are adjacent in the current narrative order; the system has not judged causality, support, or dependency. Record objective rationale in claimRelations to confirm it."
+}
+function inferredRelationLabel(display: ValidatedNarrativeDisplayModel): string {
+  if (isChineseLanguage(display.language)) return "未确认顺序提示"
+  if (isJapaneseLanguage(display.language)) return "未確認の順序メモ"
+  return "unconfirmed order note"
+}
+function missingRationale(display: ValidatedNarrativeDisplayModel): string {
+  if (isChineseLanguage(display.language)) return "因果依据未记录。"
+  if (isJapaneseLanguage(display.language)) return "因果関係の根拠は記録されていません。"
+  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 emptyCard(label: string, value: string): string {
+  return `<div class="detail-card"><h3>${escapeHtml(label)}</h3><p class="empty">${escapeHtml(value)}</p></div>`
+}
+function evidenceDetailText(evidence: NarrativeMapClaim["evidence"][number], display: ValidatedNarrativeDisplayModel): string {
+  return [
+    `${systemTerm("strength", display)}: ${localizeValue(evidence.strength, display)}`,
+    evidence.findingsFile ? `${systemTerm("findingsFile", display)}: ${evidence.findingsFile}` : "",
+    evidence.location ? `${systemTerm("location", display)}: ${evidence.location}` : "",
+    evidence.quote ? `${systemTerm("quote", display)}: ${evidence.quote}` : "",
+    evidence.unsupportedScope ? `${display.labels.unsupportedScope}: ${evidence.unsupportedScope}` : "",
+    evidence.caveat ? `${systemTerm("caveat", display)}: ${evidence.caveat}` : "",
+  ].filter(Boolean).join(" | ")
+}
+function allClaims(map: NarrativeMap): NarrativeMapClaim[] {
+  return map.claimFlow.length > 0 ? map.claimFlow : map.claims.supported.concat(map.claims.partial, map.claims.weak, map.claims.missing, map.claims.not_required)
+}
+function claimSubtitle(claim: NarrativeMapClaim, display: ValidatedNarrativeDisplayModel): string {
+  return `${localizeValue(claim.kind, display)} / ${localizeValue(claim.importance, display)} / ${localizeValue(claim.evidenceStatus, display)}`
+}
+function sectionLabels(display: ValidatedNarrativeDisplayModel): Record<string, string> {
+  if (isChineseLanguage(display.language)) return { role: "角色", narrativeJob: "叙事任务", evidenceSummary: "证据摘要", riskOrGapSummary: "风险/缺口" }
+  if (isJapaneseLanguage(display.language)) return { role: "役割", narrativeJob: "ナラティブ上の役割", evidenceSummary: "根拠の要約", riskOrGapSummary: "リスク/ギャップ" }
+  return { role: "Role", narrativeJob: "Narrative job", evidenceSummary: "Evidence summary", riskOrGapSummary: "Risk / gap" }
+}
+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" }
+  return (isChineseLanguage(display.language) ? zh : isJapaneseLanguage(display.language) ? ja : en)[term] ?? term
+}
+function localizeValue(value: string, display: ValidatedNarrativeDisplayModel): string {
+  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: "背景",
+    context: "背景", problem: "问题", opportunity: "机会", evidence: "证据", recommendation: "建议", risk: "风险", assumption: "假设", ask: "请求",
+    leads_to: "推进到", supports: "支持", depends_on: "依赖", contrasts_with: "对比", constrains: "约束", answers: "回应", strong: "强", medium: "中", low: "低",
+  }
+  const ja: 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: "背景",
+    context: "文脈", problem: "課題", opportunity: "機会", evidence: "根拠", recommendation: "提案", risk: "リスク", assumption: "仮定", ask: "依頼",
+    leads_to: "つながる", supports: "支える", depends_on: "依存", contrasts_with: "対比", constrains: "制約", answers: "答える", strong: "強", medium: "中", low: "低",
+  }
+  const table = isChineseLanguage(display.language) ? zh : isJapaneseLanguage(display.language) ? ja : {}
+  return table[value] ?? value
+}
+function localizeSlideRef(value: string, display: ValidatedNarrativeDisplayModel): string {
+  if (isChineseLanguage(display.language)) return value.replace(/slide/g, "页面")
+  if (isJapaneseLanguage(display.language)) return value.replace(/slide/g, "スライド")
+  return value
+}
+function nodeId(id: string): string {
+  return `claim-${id}`.replace(/[^a-zA-Z0-9._-]+/g, "-")
+}
+function shorten(value: string | undefined, max: number): string {
+  const text = valueOrFallback(value, "-")
+  return text.length > max ? `${text.slice(0, max - 1)}...` : text
+}
+function valueOrFallback(value: string | undefined, fallback: string): string {
+  return value?.trim() || fallback
+}
+function allowBreaks(value: string): string {
+  return escapeHtml(value).replace(/&lt;br&gt;/g, "<br>")
+}
+function escapeHtml(value: string | undefined): string {
+  return (value ?? "").replace(/[&<>"]/g, (ch) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", "\"": "&quot;" }[ch] ?? ch))
+}
+function escapeAttr(value: string | undefined): string {
+  return escapeHtml(value).replace(/[^a-zA-Z0-9_-]/g, "_")
+}

package/lib/narrative-state/map.ts ADDED Viewed

@@ -0,0 +1,282 @@
+import type { DecksState } from "../decks-state"
+import type { RenderTarget } from "../workspace-state/types"
+import { computeNarrativeHash } from "./hash"
+import { normalizeNarrativeState } from "./normalize"
+import {
+  getArtifactClaimRefs,
+  getClaimEvidenceBoard,
+  getObjectionRiskClaimIndex,
+  type ClaimEvidenceRecord,
+  type ClaimEvidenceBindingRecord,
+  type ClaimSlideRef,
+} from "./queries"
+import { reviewNarrativeState } from "./readiness"
+import type { NarrativeClaim, NarrativeClaimRelation, NarrativeResearchGap, NarrativeStateV1 } from "./types"
+export interface NarrativeMap {
+  version: 1
+  snapshot: NarrativeMapSnapshot
+  claims: Record<NarrativeClaim["evidenceStatus"], NarrativeMapClaim[]>
+  claimFlow: NarrativeMapClaim[]
+  claimRelations: NarrativeMapClaimRelation[]
+  objections: NarrativeMapObjection[]
+  risks: NarrativeMapRisk[]
+  researchGaps: NarrativeMapResearchGap[]
+  artifactCoverage: NarrativeMapArtifact[]
+  nextActions: string[]
+}
+export interface NarrativeMapSnapshot {
+  narrativeId: string
+  narrativeHash: string
+  status: NarrativeStateV1["status"]
+  primaryAudience: string
+  beliefBefore: string
+  beliefAfter: string
+  decisionAction: string
+  thesis?: string
+  approval: "current" | "stale" | "missing"
+}
+export type NarrativeMapClaim = ClaimEvidenceRecord
+export type NarrativeMapEvidence = ClaimEvidenceBindingRecord
+export interface NarrativeMapClaimRelation extends NarrativeClaimRelation {
+  fromClaimText?: string
+  toClaimText?: string
+  inferred?: boolean
+}
+export interface NarrativeMapObjection {
+  id: string
+  text: string
+  claimId?: string
+  claimText?: string
+  priority: "high" | "medium" | "low"
+  response?: string
+}
+export interface NarrativeMapRisk {
+  id: string
+  text: string
+  claimId?: string
+  claimText?: string
+  severity: "high" | "medium" | "low"
+  mitigation?: string
+}
+export type NarrativeMapResearchGap = NarrativeResearchGap & { targetText?: string }
+export interface NarrativeMapArtifact {
+  id: string
+  type: RenderTarget["type"]
+  outputPath?: string
+  contractStatus?: RenderTarget["contractStatus"]
+  sourceNodeIds: string[]
+  claimIds: string[]
+  narrativeIds: string[]
+  slideRefs: ClaimSlideRef[]
+  coverageStatus: "current" | "stale" | "partial" | "missing"
+  affectedClaimIds: string[]
+  missingClaimIds: string[]
+  staleReasons: string[]
+  stale: boolean
+  staleReason?: string
+  note?: string
+}
+export function buildNarrativeMap(state: DecksState): NarrativeMap {
+  const narrative = state.narrative ?? normalizeNarrativeState(state)
+  const reviewed = reviewNarrativeState({ ...state, narrative })
+  const readiness = reviewed.result
+  const narrativeHash = computeNarrativeHash(narrative)
+  const board = getClaimEvidenceBoard({ ...state, narrative })
+  const objectionRisk = getObjectionRiskClaimIndex({ ...state, narrative })
+  return {
+    version: 1,
+    snapshot: {
+      narrativeId: narrative.id,
+      narrativeHash,
+      status: readiness.status === "approved" ? "approved" : narrative.status,
+      primaryAudience: narrative.audience.primary,
+      beliefBefore: narrative.audience.beliefBefore,
+      beliefAfter: narrative.audience.beliefAfter,
+      decisionAction: narrative.decision.action,
+      thesis: narrative.thesis?.statement,
+      approval: readiness.approval?.current ? "current" : readiness.approval?.stale ? "stale" : "missing",
+    },
+    claims: board.claims,
+    claimFlow: claimRecordsInNarrativeOrder(narrative, board.claims),
+    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,
+      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,
+    })),
+    nextActions: readiness.nextActions,
+  }
+}
+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))
+}
+function mapClaimRelations(narrative: NarrativeStateV1): NarrativeMapClaimRelation[] {
+  const explicit = (narrative.claimRelations ?? []).map((relation) => withClaimRelationText(narrative, relation, false))
+  if (explicit.length > 0) return explicit
+  const flowClaims = narrative.claims.filter((claim) => claim.importance === "central" || claim.kind === "recommendation" || claim.kind === "ask" || claim.kind === "problem" || claim.kind === "evidence")
+  return flowClaims.slice(0, -1).map((claim, index) => withClaimRelationText(narrative, {
+    id: `inferred:${claim.id}:${flowClaims[index + 1].id}`,
+    fromClaimId: claim.id,
+    toClaimId: flowClaims[index + 1].id,
+    relation: inferredRelation(claim.kind, flowClaims[index + 1].kind),
+    rationale: "Inferred from claim order and claim kind for display only.",
+  }, true))
+}
+function withClaimRelationText(narrative: NarrativeStateV1, relation: NarrativeClaimRelation, inferred: boolean): NarrativeMapClaimRelation {
+  return {
+    ...relation,
+    fromClaimText: narrative.claims.find((claim) => claim.id === relation.fromClaimId)?.text,
+    toClaimText: narrative.claims.find((claim) => claim.id === relation.toClaimId)?.text,
+    inferred,
+  }
+}
+function inferredRelation(fromKind: NarrativeClaim["kind"], toKind: NarrativeClaim["kind"]): NarrativeClaimRelation["relation"] {
+  if (toKind === "risk") return "constrains"
+  if (toKind === "ask" || toKind === "recommendation") return "leads_to"
+  if (fromKind === "problem" && toKind === "evidence") return "supports"
+  return "leads_to"
+}
+export function formatNarrativeMap(map: NarrativeMap): string {
+  const lines: string[] = []
+  lines.push("## Narrative Snapshot")
+  lines.push(`- Status: ${map.snapshot.status}`)
+  lines.push(`- Approval: ${map.snapshot.approval}`)
+  lines.push(`- Narrative hash: ${map.snapshot.narrativeHash}`)
+  lines.push(`- Audience: ${valueOrDash(map.snapshot.primaryAudience)}`)
+  lines.push(`- Belief before: ${valueOrDash(map.snapshot.beliefBefore)}`)
+  lines.push(`- Belief after: ${valueOrDash(map.snapshot.beliefAfter)}`)
+  lines.push(`- Decision/action: ${valueOrDash(map.snapshot.decisionAction)}`)
+  lines.push(`- Thesis: ${valueOrDash(map.snapshot.thesis)}`)
+  lines.push("", "## Claim Evidence Board")
+  for (const status of ["supported", "partial", "weak", "missing", "not_required"] as const) {
+    const claims = map.claims[status]
+    lines.push(`### ${status} (${claims.length})`)
+    if (claims.length === 0) {
+      lines.push("- None")
+      continue
+    }
+    for (const claim of claims) {
+      lines.push(`- ${claim.text} [${claim.importance}/${claim.kind}]`)
+      if (claim.supportedScope) lines.push(`  Supported scope: ${claim.supportedScope}`)
+      if (claim.unsupportedScope) lines.push(`  Unsupported scope: ${claim.unsupportedScope}`)
+      for (const caveat of claim.caveats) lines.push(`  Caveat: ${caveat}`)
+      if (claim.evidence.length === 0) lines.push("  Evidence: none")
+      for (const evidence of claim.evidence) {
+        lines.push(`  Evidence: ${evidenceLine(evidence)}`)
+      }
+    }
+  }
+  lines.push("", "## Claim Flow")
+  if (map.claimRelations.length === 0) lines.push("- No claim relations recorded")
+  for (const relation of map.claimRelations) {
+    lines.push(`- ${valueOrDash(relation.fromClaimText ?? relation.fromClaimId)} --${relationLabel(relation)}--> ${valueOrDash(relation.toClaimText ?? relation.toClaimId)}`)
+    if (relation.inferred) lines.push("  Rationale: unconfirmed order note only; no causal, support, or dependency relation has been judged")
+    else if (relation.rationale) lines.push(`  Rationale: ${relation.rationale}`)
+    else if (!relation.inferred) lines.push("  Rationale: causal rationale is not recorded")
+  }
+  lines.push("", "## Objections & Risks")
+  if (map.objections.length === 0 && map.risks.length === 0) lines.push("- None recorded")
+  for (const objection of map.objections) {
+    lines.push(`- Objection (${objection.priority}): ${objection.text}`)
+    if (objection.claimText) lines.push(`  Challenges: ${objection.claimText}`)
+    if (objection.response) lines.push(`  Response: ${objection.response}`)
+  }
+  for (const risk of map.risks) {
+    lines.push(`- Risk (${risk.severity}): ${risk.text}`)
+    if (risk.claimText) lines.push(`  Constrains: ${risk.claimText}`)
+    if (risk.mitigation) lines.push(`  Mitigation: ${risk.mitigation}`)
+  }
+  lines.push("", "## Research Gaps")
+  if (map.researchGaps.length === 0) lines.push("- None recorded")
+  for (const gap of map.researchGaps) {
+    lines.push(`- ${gap.question} [${gap.status}/${gap.priority}]`)
+    lines.push(`  Target: ${gap.targetType}${gap.targetText ? ` - ${gap.targetText}` : ""}`)
+    if (gap.findingsFile) lines.push(`  Findings: ${gap.findingsFile}`)
+    if (gap.evidenceBindingIds?.length) lines.push(`  Evidence bindings: ${gap.evidenceBindingIds.join(", ")}`)
+    if (gap.notes) lines.push(`  Notes: ${gap.notes}`)
+  }
+  lines.push("", "## Render Target Coverage")
+  if (map.artifactCoverage.length === 0) lines.push("- No render targets recorded")
+  for (const artifact of map.artifactCoverage) {
+    lines.push(`- ${artifact.type}: ${artifact.outputPath ?? artifact.id} [${artifact.contractStatus ?? "unknown"}, coverage: ${artifact.coverageStatus}]`)
+    if (artifact.narrativeIds.length > 0) lines.push(`  Narrative refs: ${artifact.narrativeIds.join(", ")}`)
+    if (artifact.claimIds.length > 0) lines.push(`  Claim refs: ${artifact.claimIds.join(", ")}`)
+    if (artifact.missingClaimIds.length > 0) lines.push(`  Missing claim refs: ${artifact.missingClaimIds.join(", ")}`)
+    if (artifact.affectedClaimIds.length > 0) lines.push(`  Affected claim refs: ${artifact.affectedClaimIds.join(", ")}`)
+    for (const ref of artifact.slideRefs) lines.push(`  Slide ${ref.slideIndex}: ${ref.claimId} [${ref.role}] (${ref.match}/${ref.location})`)
+    for (const reason of artifact.staleReasons) lines.push(`  Coverage note: ${reason}`)
+    if (artifact.note) lines.push(`  Note: ${artifact.note}`)
+  }
+  lines.push("", "## Next Actions")
+  if (map.nextActions.length === 0) lines.push("- None")
+  else for (const action of map.nextActions) lines.push(`- ${action}`)
+  return lines.join("\n")
+}
+function relationLabel(relation: NarrativeMapClaimRelation): string {
+  return relation.inferred ? "unconfirmed_order" : relation.relation
+}
+function evidenceLine(evidence: NarrativeMapEvidence): string {
+  return [
+    evidence.source,
+    `strength: ${evidence.strength}`,
+    evidence.findingsFile ? `findings: ${evidence.findingsFile}` : "",
+    evidence.location ? `location: ${evidence.location}` : "",
+    evidence.quote ? `quote: ${evidence.quote}` : "",
+    evidence.unsupportedScope ? `unsupported scope: ${evidence.unsupportedScope}` : "",
+    evidence.caveat ? `caveat: ${evidence.caveat}` : "",
+  ].filter(Boolean).join(" | ")
+}
+function valueOrDash(value: string | undefined): string {
+  return value?.trim() || "-"
+}
+function targetText(narrative: NarrativeStateV1, gap: NarrativeResearchGap): string | undefined {
+  if (!gap.targetId) return undefined
+  if (gap.targetType === "claim") return narrative.claims.find((claim) => claim.id === gap.targetId)?.text
+  if (gap.targetType === "objection") return narrative.objections.find((objection) => objection.id === gap.targetId)?.text
+  if (gap.targetType === "risk") return narrative.risks.find((risk) => risk.id === gap.targetId)?.text
+  if (gap.targetType === "decision") return narrative.decision.action
+  if (gap.targetType === "narrative") return narrative.thesis?.statement
+  return undefined
+}