@cyber-dash-tech/revela 0.17.6 → 0.17.8

package/README.md

@@ -2,19 +2,21 @@
 
 **English** | [中文](README.zh-CN.md)
 
-[![npm version](https://img.shields.io/npm/v/@cyber-dash-tech/revela)](https://www.npmjs.com/package/@cyber-dash-tech/revela) [![license](https://img.shields.io/npm/l/@cyber-dash-tech/revela)](LICENSE) [![tests](https://img.shields.io/badge/tests-546%20passing-brightgreen)](tests/) [![OpenCode plugin](https://img.shields.io/badge/OpenCode-plugin-blue)](https://opencode.ai) [![Bun](https://img.shields.io/badge/Bun-%E2%89%A51.0-orange)](https://bun.sh)
+[![npm version](https://img.shields.io/npm/v/@cyber-dash-tech/revela)](https://www.npmjs.com/package/@cyber-dash-tech/revela) [![license](https://img.shields.io/npm/l/@cyber-dash-tech/revela)](LICENSE) [![tests](https://img.shields.io/badge/tests-611%20passing-brightgreen)](tests/) [![OpenCode plugin](https://img.shields.io/badge/OpenCode-plugin-blue)](https://opencode.ai) [![Bun](https://img.shields.io/badge/Bun-%E2%89%A51.0-orange)](https://bun.sh)
 
 <p align="center">
   <img src="assets/img/logo.png" alt="Revela" width="560" />
 </p>
 
-Revela is an [OpenCode](https://opencode.ai) plugin that turns local sources and research into a traceable narrative graph, then renders that graph into briefs and presentation decks.
+Revela works from [OpenCode](https://opencode.ai) and Codex to turn source materials, research, data, and intent into trusted, traceable, presentation-ready decision artifacts.
 
-The narrative graph records the core elements needed to generate a brief or deck: audience, decision, claims, evidence, sources, risks, objections, and open gaps.
+Its narrative workspace records the core elements needed to generate a brief or deck: audience, decision, claims, evidence, sources, risks, objections, and open gaps.
 
 ## Install
 
-Add Revela to your `opencode.json`:
+### OpenCode
+
+Install Revela through `opencode.json` with the npm package `@cyber-dash-tech/revela`:
 
 ```json
 {
@@ -27,6 +29,19 @@ Restart OpenCode.
 
 To install globally, add the same entry to `~/.config/opencode/opencode.json`.
 
+### Codex
+
+Install Revela through the Codex Git marketplace:
+
+```bash
+codex plugin marketplace add https://github.com/cyber-dash-tech/revela --ref v0.17.8
+codex plugin add revela@revela
+```
+
+Install from the full repository ref. Do not use a sparse checkout limited to `plugins/revela`; the Codex plugin resolves the shared runtime, built-in designs, and domains from the repository snapshot.
+
+Start a new Codex thread after installing so Codex loads the Revela skills, MCP tools, and hooks.
+
 ## Built-In Designs
 
 Revela includes built-in deck designs:
@@ -55,6 +70,8 @@ Switch designs with:
 /revela design --use summit
 ```
 
+In Codex, ask Revela to list or switch designs; the plugin uses the active design when making decks.
+
 ## Domains
 
 Domains add topic-specific narrative guidance, such as consulting, product, or investor communication. Use them when you want Revela to adapt story framing to a specific context.
@@ -63,51 +80,64 @@ Domains add topic-specific narrative guidance, such as consulting, product, or i
 /revela domain
 ```
 
-## Quick Start: Make An HTML Deck
+In Codex, ask Revela to list or switch domains; the active domain guides narrative framing during init, research, and story work.
+
+## Quick Start
 
-1. Initialize the narrative workspace from your local source materials.
+Use these prompts in Codex from the workspace that contains your source materials.
+
+1. Choose the narrative domain before authoring so Revela frames the audience, decision, risks, and objections for your context.
 
 ```text
-/revela init
+Use Revela to list available domains, switch to the consulting domain, and use that framing for the narrative workflow.
 ```
 
-2. Research missing evidence and bind useful findings to claims.
+2. Choose the deck design before rendering so generated artifacts use the intended visual language.
 
 ```text
-/revela research
+Use Revela to list available designs, switch to the summit design, and use it for the next deck.
 ```
 
-Skip this step if your local materials already provide enough support.
-
-3. Inspect the claim flow before rendering.
+3. Initialize the narrative from local materials. Init grounds the narrative in the workspace and surfaces gaps; it does not replace the research step.
 
 ```text
-/revela story
+Use Revela to initialize this workspace. Read the local materials, identify the audience, decision, thesis, claims, existing evidence, risks, objections, and gaps, then create or update the narrative vault.
 ```
 
-Use this to check the audience, decision, claims, evidence, gaps, risks, and objections.
+4. Research the gaps and bind only source-supported evidence into the narrative.
 
-4. Generate the HTML deck.
+```text
+Use Revela research to inspect the current narrative gaps, derive research targets, gather or evaluate findings, save research under researches/, and bind only source-supported evidence back into the narrative vault.
+```
+
+5. Read Story before rendering to inspect the claim flow, evidence support, caveats, unsupported scope, and open gaps.
 
 ```text
-/revela make --deck
+Use Revela Story to show the current claim flow, evidence support, caveats, unsupported scope, and open gaps.
 ```
 
-Revela writes the deck under `decks/` and uses the current narrative, deck plan, and active design.
+6. Make an HTML deck from the canonical narrative and deck plan.
+
+```text
+Use Revela to make a deck from the current narrative. Create or update the deck plan, generate an HTML deck under decks/, run deck QA, and repair hard QA errors.
+```
 
-5. Review or revise the deck.
+7. Review the generated deck for traceability, diagnostics, and targeted edits.
 
 ```text
-/revela review --deck
+Use Revela to review the generated deck. Open the Review UI for the HTML deck and also summarize diagnostics.
 ```
 
-See [Review A Deck](#review-a-deck) for Insight and Comment.
+8. Export a PDF after deck QA passes.
+
+```text
+Use Revela to export the deck to PDF.
+```
 
-6. Export if needed.
+9. Export an editable PPTX after deck QA passes.
 
 ```text
-/revela export --deck pdf decks/example.html
-/revela export --deck pptx decks/example.html
+Use Revela to export the deck to PPTX.
 ```
 
 ## Review A Deck

package/README.zh-CN.md

@@ -2,19 +2,21 @@
 
 [English](README.md) | **中文**
 
-[![npm version](https://img.shields.io/npm/v/@cyber-dash-tech/revela)](https://www.npmjs.com/package/@cyber-dash-tech/revela) [![license](https://img.shields.io/npm/l/@cyber-dash-tech/revela)](LICENSE) [![tests](https://img.shields.io/badge/tests-546%20passing-brightgreen)](tests/) [![OpenCode plugin](https://img.shields.io/badge/OpenCode-plugin-blue)](https://opencode.ai) [![Bun](https://img.shields.io/badge/Bun-%E2%89%A51.0-orange)](https://bun.sh)
+[![npm version](https://img.shields.io/npm/v/@cyber-dash-tech/revela)](https://www.npmjs.com/package/@cyber-dash-tech/revela) [![license](https://img.shields.io/npm/l/@cyber-dash-tech/revela)](LICENSE) [![tests](https://img.shields.io/badge/tests-611%20passing-brightgreen)](tests/) [![OpenCode plugin](https://img.shields.io/badge/OpenCode-plugin-blue)](https://opencode.ai) [![Bun](https://img.shields.io/badge/Bun-%E2%89%A51.0-orange)](https://bun.sh)
 
 <p align="center">
   <img src="assets/img/logo.png" alt="Revela" width="560" />
 </p>
 
-Revela 是一个 [OpenCode](https://opencode.ai) 插件，用来把本地材料和调研结果转成可追踪的叙事图谱，再基于这个图谱生成 brief 和 presentation deck。
+Revela 可在 [OpenCode](https://opencode.ai) 和 Codex 中使用，把来源材料、调研、数据和用户意图转成可信、可追踪、可直接用于决策沟通的 narrative artifact。
 
-叙事图谱用 graph 方式记录生成 brief 或 deck 所需的关键要素：受众、决策目标、论点、论据、资料来源、风险、潜在质疑和待补齐的信息。
+它的 narrative workspace 会记录生成 brief 或 deck 所需的关键要素：受众、决策目标、论点、论据、资料来源、风险、潜在质疑和待补齐的信息。
 
 ## 安装
 
-在 `opencode.json` 中加入 Revela：
+### OpenCode
+
+通过 `opencode.json` 安装 npm package `@cyber-dash-tech/revela`：
 
 ```json
 {
@@ -27,6 +29,19 @@ Revela 是一个 [OpenCode](https://opencode.ai) 插件，用来把本地材料
 
 如果想全局安装，把同样配置写到 `~/.config/opencode/opencode.json`。
 
+### Codex
+
+通过 Codex Git marketplace 安装 Revela：
+
+```bash
+codex plugin marketplace add https://github.com/cyber-dash-tech/revela --ref v0.17.8
+codex plugin add revela@revela
+```
+
+请从完整仓库 ref 安装。不要使用仅包含 `plugins/revela` 的 sparse checkout；Codex plugin 会从仓库快照中解析 shared runtime、内置 designs 和 domains。
+
+安装后开启一个新的 Codex thread，让 Codex 加载 Revela 的 skills、MCP tools 和 hooks。
+
 ## 内置设计
 
 Revela 内置多个 deck design：
@@ -55,6 +70,8 @@ Revela 内置多个 deck design：
 /revela design --use summit
 ```
 
+在 Codex 中，可以直接让 Revela 列出或切换 design；生成 deck 时会使用 active design。
+
 ## Domains
 
 Domain 提供特定场景的叙事 guidance，例如 consulting、product 或 investor communication。需要让 Revela 按具体沟通场景调整 story framing 时使用。
@@ -63,51 +80,64 @@ Domain 提供特定场景的叙事 guidance，例如 consulting、product 或 in
 /revela domain
 ```
 
-## Quick Start：生成 HTML Deck
+在 Codex 中，可以直接让 Revela 列出或切换 domain；active domain 会用于 init、research 和 story 阶段的叙事 framing。
+
+## Quick Start
 
-1. 从本地来源材料初始化 narrative workspace。
+在包含来源材料的 workspace 中打开 Codex，然后按下面步骤逐条发送 prompt。
+
+1. 先选择 domain，让 Revela 按你的沟通场景 framing 受众、决策、风险和潜在质疑。
 
 ```text
-/revela init
+用 Revela 列出可用 domains，切换到 consulting domain，并把这个 framing 用在后续 narrative workflow 中。
 ```
 
-2. 补充缺失证据，并把有效 findings 绑定到 claims。
+2. 再选择 design，让后续生成的 deck 使用指定视觉风格。
 
 ```text
-/revela research
+用 Revela 列出可用 designs，切换到 summit design，并把它用于下一次 deck 生成。
 ```
 
-如果本地材料已经足够支撑 story，可以跳过这一步。
-
-3. 在生成 deck 前检查 claim flow。
+3. 从本地材料初始化 narrative。Init 负责基于 workspace 做 grounding 并暴露 gap；它不替代 research 步骤。
 
 ```text
-/revela story
+用 Revela 初始化这个 workspace。读取本地材料，识别受众、决策目标、thesis、claims、已有 evidence、risks、objections 和 gaps，然后创建或更新 narrative vault。
 ```
 
-用它检查 audience、decision、claims、evidence、gaps、risks 和 objections。
+4. 针对 gap 做 research，并且只把来源明确支持的 evidence 绑定回 narrative。
 
-4. 生成 HTML deck。
+```text
+用 Revela research 检查当前 narrative gaps，生成 research targets，收集或评估 findings，把 research 保存到 researches/，并且只把有来源支撑的 evidence 绑定回 narrative vault。
+```
+
+5. 生成 deck 前先读 Story，检查 claim flow、证据支撑、caveats、unsupported scope 和 open gaps。
 
 ```text
-/revela make --deck
+用 Revela Story 展示当前 claim flow、evidence support、caveats、unsupported scope 和 open gaps。
 ```
 
-Revela 会把 deck 写到 `decks/`，并使用当前 narrative、deck plan 和 active design。
+6. 从 canonical narrative 和 deck plan 生成 HTML deck。
+
+```text
+用 Revela 基于当前 narrative 制作 deck。创建或更新 deck plan，在 decks/ 下生成 HTML deck，运行 deck QA，并修复 hard QA errors。
+```
 
-5. Review 或修改 deck。
+7. Review 生成后的 deck，检查 traceability、diagnostics，并做定向修改。
 
 ```text
-/revela review --deck
+用 Revela review 生成好的 deck。打开这个 HTML deck 的 Review UI，并总结 diagnostics。
 ```
 
-详见 [Review Deck](#review-deck)。
+8. QA 通过后导出 PDF。
+
+```text
+用 Revela 把 deck 导出为 PDF。
+```
 
-6. 按需导出。
+9. QA 通过后导出可编辑 PPTX。
 
 ```text
-/revela export --deck pdf decks/example.html
-/revela export --deck pptx decks/example.html
+用 Revela 把 deck 导出为 PPTX。
 ```
 
 ## Review Deck

package/bin/revela.ts

@@ -0,0 +1,98 @@
+#!/usr/bin/env bun
+
+type CommandResult = unknown | Promise<unknown>
+
+const [argvCommand, ...args] = process.argv.slice(2)
+const command = process.env.REVELA_CLI_COMMAND || argvCommand
+
+if (!command || command === "help" || command === "--help" || command === "-h") {
+  printHelp()
+  process.exit(0)
+}
+
+if (command === "mcp") {
+  await import("../plugins/revela/mcp/revela-server")
+}
+else {
+  const runtime = await import("../lib/runtime/index")
+  const options = parseArgs(args)
+
+  try {
+    let result: CommandResult
+    if (command === "doctor") result = runtime.doctor(options)
+    else if (command === "compile") result = runtime.compileNarrative(options)
+    else if (command === "markdown-qa") result = runtime.markdownQa(options)
+    else if (command === "deck-plan") result = runtime.readDeckPlan(options)
+    else if (command === "deck-foundation") result = runtime.createDeckFoundation(required(options, ["outputPath", "title", "language"]))
+    else if (command === "qa") result = runtime.runDeckQa(required(options, ["file"]))
+    else if (command === "review-read") result = runtime.reviewDeckRead(required(options, ["file"]))
+    else if (command === "export-pdf") result = runtime.exportPdf(required(options, ["file"]))
+    else if (command === "export-pptx") result = runtime.exportPptx(required(options, ["file"]))
+    else if (command === "design-list") result = runtime.designList()
+    else if (command === "design-read") result = runtime.designRead(options)
+    else if (command === "design-use") result = runtime.designActivate(required(options, ["name"]))
+    else if (command === "domain-list") result = runtime.domainList()
+    else if (command === "domain-read") result = runtime.domainRead(options)
+    else if (command === "domain-use") result = runtime.domainActivate(required(options, ["name"]))
+    else {
+      throw new Error(`Unknown command: ${command}`)
+    }
+
+    process.stdout.write(`${JSON.stringify(await result, null, 2)}\n`)
+  } catch (e) {
+    process.stderr.write(`${e instanceof Error ? e.message : String(e)}\n`)
+    process.exit(1)
+  }
+}
+
+function parseArgs(values: string[]): Record<string, any> {
+  const result: Record<string, any> = {}
+  for (let i = 0; i < values.length; i++) {
+    const arg = values[i]
+    if (!arg.startsWith("--")) throw new Error(`Unexpected argument: ${arg}`)
+    const key = arg.slice(2)
+    const next = values[i + 1]
+    if (next === undefined || next.startsWith("--")) {
+      result[key] = true
+      continue
+    }
+    result[key] = parseValue(next)
+    i++
+  }
+  return result
+}
+
+function parseValue(value: string): unknown {
+  if (value === "true") return true
+  if (value === "false") return false
+  return value
+}
+
+function required(input: Record<string, any>, keys: string[]): Record<string, any> {
+  const missing = keys.filter((key) => input[key] === undefined || input[key] === "")
+  if (missing.length > 0) throw new Error(`Missing required option(s): ${missing.map((key) => `--${key}`).join(", ")}`)
+  return input
+}
+
+function printHelp(): void {
+  process.stdout.write(`Revela CLI
+
+Usage:
+  revela mcp
+  revela doctor [--workspaceRoot <path>]
+  revela compile [--workspaceRoot <path>]
+  revela markdown-qa [--workspaceRoot <path>] [--scope touched|affected|full] [--strictness authoring|readiness|render]
+  revela deck-plan [--workspaceRoot <path>]
+  revela deck-foundation --outputPath <path> --title <title> --language <tag> [--workspaceRoot <path>] [--designName <name>] [--mode create|repair] [--overwrite true]
+  revela qa --file <path> [--workspaceRoot <path>]
+  revela review-read --file <path> [--workspaceRoot <path>] [--format json|markdown]
+  revela export-pdf --file <path> [--workspaceRoot <path>]
+  revela export-pptx --file <path> [--workspaceRoot <path>]
+  revela design-list
+  revela design-read [--name <design>]
+  revela design-use --name <design>
+  revela domain-list
+  revela domain-read [--name <domain>]
+  revela domain-use --name <domain>
+`)
+}

package/lib/edit/prompt.ts

@@ -26,6 +26,7 @@ export interface EditCommentPayload extends EditSelectedElementPayload {
   comments?: EditCommentDraftPayload[]
   asset?: Record<string, unknown>
   drop?: Record<string, unknown>
+  suppressAutomaticArtifactQa?: boolean
 }
 
 export function buildEditPrompt(payload: EditCommentPayload): string {
@@ -59,6 +60,10 @@ export function buildEditPrompt(payload: EditCommentPayload): string {
     asset: payload.asset,
     drop: payload.drop,
   }
+  const qaInstruction = payload.suppressAutomaticArtifactQa
+    ? `- Do not run artifact QA after this edit and do not keep editing just to satisfy post-write QA. The Review UI will refresh from the deck file version change; QA can be run later through an explicit Review, QA, or export workflow.`
+    : `- Artifact QA runs automatically after deck writes/patches/edits. It checks deck HTML contract, design component compliance, exact 1920x1080 slide geometry, scrollbars, element overflow, text clipping, and claim/evidence content-density warnings.
+- If the tool result reports hard QA errors, fix them with the smallest targeted patch and let the post-write QA run again. Refine opens automatically only after hard errors pass; warnings such as thin claim/evidence substance do not block opening.`
 
   return `The user left a visual edit comment on a Revela slide deck.
 
@@ -95,7 +100,6 @@ Instructions:
 - For targeted artifact-level edits, patch ${"`decks/*.html`"} directly. Do not call ${"`revela-decks`"} action ${"`review`"} as a precondition, and do not let ${"`writeReadiness`"}, ${"`planReview`"}, or ${"`slide_plan_unconfirmed`"} block the patch.
 - Do not patch or write ${"`DECKS.json`"} directly. If state must change, use the ${"`revela-decks`"} tool.
 - Apply the edit to ${payload.file} with the smallest targeted HTML patch that satisfies the comment.
-- Artifact QA runs automatically after deck writes/patches/edits. It checks deck HTML contract, design component compliance, exact 1920x1080 slide geometry, scrollbars, element overflow, text clipping, and claim/evidence content-density warnings.
-- If the tool result reports hard QA errors, fix them with the smallest targeted patch and let the post-write QA run again. Refine opens automatically only after hard errors pass; warnings such as thin claim/evidence substance do not block opening.
+${qaInstruction}
 - If the comment is ambiguous, ask one concise clarification question instead of guessing.`
 }

package/lib/edit/server.ts

@@ -1003,8 +1003,8 @@ export function renderEditorShell(token: string): string {
         if (status === 'updated') return 'Deck file updated';
         if (status === 'stale') return 'Still waiting for deck file update';
         if (status === 'failed') return 'Failed to send';
-        if (status === 'sending') return 'Sending to OpenCode...';
-        return '⏳ Sent to OpenCode';
+        if (status === 'sending') return 'Sending to Review agent...';
+        return 'Sent to Review agent';
       }
 
       function targetFromPointer(event) {

package/lib/inspect/prompt.ts

@@ -6,9 +6,11 @@ export function buildInspectionPrompt(input: {
   projection: InspectionPromptProjection
   language?: string
   comment?: string
+  delivery?: "tool" | "json"
 }): string {
   const language = normalizeInspectLanguage(input.language)
   const comment = typeof input.comment === "string" && input.comment.trim() ? input.comment.trim() : ""
+  const delivery = input.delivery ?? "tool"
   return `A user selected slide content in Revela Evidence Inspector. The selection may contain one referenced element, a whole slide, or multiple referenced elements selected with Cmd/Ctrl-click.
 
 Target file: ${input.file}
@@ -20,7 +22,9 @@ Use the structured projection below to produce the final inspector cards. This i
 
 Language boundary: the selected display language affects only human-readable card copy. Preserve all claim ids, canonical claim ids, evidence binding ids, source paths, findings files, URLs, numbers, quoted/source facts, caveats, artifact ids, and coverage statuses exactly as grounded in the projection. If the display language is Auto, use projection.deck.language when available; otherwise follow the user's/browser context or default to English.
 
-Return the result only by calling the \`revela-inspection-result\` tool with this request id. Do not answer in chat.
+${delivery === "json"
+    ? "Return only a single JSON object that matches the final inspector result schema. Do not wrap it in Markdown. Do not call tools. Do not edit files."
+    : "Return the result only by calling the `revela-inspection-result` tool with this request id. Do not answer in chat."}
 
 Required card model:
 - User inspect comment: if present, answer it through the Purpose and Source cards first. If it asks about trust, provenance, evidence, factuality, or where a number came from, prioritize Source. If it asks why something is on the slide or what it is doing, prioritize Purpose.

package/lib/refine/comment-requests.ts

@@ -0,0 +1,77 @@
+export type CommentRequestStatus = "pending" | "completed" | "failed" | "expired"
+
+export interface PendingCommentRequest {
+  requestId: string
+  status: CommentRequestStatus
+  deckVersion: string
+  createdAt: number
+  updatedAt: number
+  error?: string
+}
+
+const REQUEST_TTL_MS = 120 * 1000
+const requests = new Map<string, PendingCommentRequest>()
+
+export function createCommentRequest(input: {
+  requestId: string
+  deckVersion: string
+}): PendingCommentRequest {
+  cleanupCommentRequests()
+  const now = Date.now()
+  const request: PendingCommentRequest = {
+    requestId: input.requestId,
+    status: "pending",
+    deckVersion: input.deckVersion,
+    createdAt: now,
+    updatedAt: now,
+  }
+  requests.set(input.requestId, request)
+  return request
+}
+
+export function getCommentRequest(requestId: string): PendingCommentRequest | undefined {
+  cleanupCommentRequests()
+  const request = requests.get(requestId)
+  if (!request) return undefined
+  if (request.status === "pending" && Date.now() - request.createdAt > REQUEST_TTL_MS) {
+    request.status = "expired"
+    request.error = "Review agent timed out before completing the comment request."
+    request.updatedAt = Date.now()
+  }
+  return request
+}
+
+export function completeCommentRequest(requestId: string): PendingCommentRequest | undefined {
+  const request = getCommentRequest(requestId)
+  if (!request || request.status !== "pending") return request
+  request.status = "completed"
+  request.updatedAt = Date.now()
+  return request
+}
+
+export function failCommentRequest(requestId: string, error: string): PendingCommentRequest | undefined {
+  const request = getCommentRequest(requestId)
+  if (!request || request.status !== "pending") return request
+  request.status = "failed"
+  request.error = error
+  request.updatedAt = Date.now()
+  return request
+}
+
+export function cleanupCommentRequests(now = Date.now()): void {
+  for (const [requestId, request] of requests) {
+    if (request.status === "pending" && now - request.createdAt > REQUEST_TTL_MS) {
+      request.status = "expired"
+      request.error = "Review agent timed out before completing the comment request."
+      request.updatedAt = now
+      continue
+    }
+    if (request.status !== "pending" && now - request.updatedAt > REQUEST_TTL_MS) {
+      requests.delete(requestId)
+    }
+  }
+}
+
+export function clearCommentRequestsForTests(): void {
+  requests.clear()
+}

package/lib/refine/open.ts

@@ -8,6 +8,7 @@ import { ensureEditableDeckState } from "../edit/deck-state"
 import { openUrl } from "../edit/open"
 import { resolveEditableDeck, type EditableDeck } from "../edit/resolve-deck"
 import { buildPrompt } from "../prompt-builder"
+import type { ReviewPromptBridge } from "./prompt-bridge"
 import { startRefineServer, type RefineMode } from "./server"
 
 export interface OpenRefineDeckResult {
@@ -27,12 +28,13 @@ export interface EnsureRefineDeckOpenResult extends OpenRefineDeckResult {
 }
 
 export interface OpenRefineDeckOptions {
-  client: any
-  sessionID: string
+  client?: any
+  sessionID?: string
   workspaceRoot: string
   mode?: RefineMode
   openBrowser?: boolean
   openUrl?: (url: string) => void
+  promptBridge?: ReviewPromptBridge
 }
 
 export function openRefineDeck(target: string, options: OpenRefineDeckOptions): OpenRefineDeckResult {
@@ -70,6 +72,7 @@ function openRefineDeckInternal(
     workspaceRoot: options.workspaceRoot,
     deck,
     mode,
+    promptBridge: options.promptBridge,
   })
   const url = `${refineServer.baseUrl}/refine?token=${encodeURIComponent(session.token)}`
   const shouldOpen = options.openBrowser !== false && !(behavior.skipLiveSession && session.live)