@openprd/cli 0.1.18 → 0.1.21

package/.openprd/design/active/asset-spec.md

@@ -2,20 +2,25 @@
 
 | 类型 | 资产 | 来源 | 状态 | 备注 |
 | --- | --- | --- | --- | --- |
-| logo | 待填写 | 待确认 | pending |  |
-| 产品图 | 待填写 | 待确认 | pending |  |
-| UI 图 | 待填写 | 待确认 | pending |  |
-| 功能图标 | 新入口/按钮/空态默认配图标 | UI 图标 Phosphor；实现库 Lucide/Tabler/React Icons；AI 品牌 LobeHub；技术栈 Tech Icons | pending | 开发新功能时 Agent 自动找图标并登记，不等用户要求 |
-| 摄影 / 插图 | 待填写 | 待确认 | pending |  |
-| 色板 / 字体 | 待填写 | 待确认 | pending |  |
-| 动效节奏 | 待填写 | 待确认 | pending |  |
-| 背景 / 表面 | 待填写 | 待确认 | pending |  |
-| 构图记忆点 | 待填写 | 待确认 | pending |  |
+| logo | 复用 OpenPrd 现有文字标识 | 当前 Review topbar | reuse | 不重新设计品牌 |
+| 产品图 | Review Studio 三方向接触表 | Image 2 + `visual-prepare` | ready | `.openprd/design/active/review-studio-v020-directions/contact-sheet.jpg` |
+| UI 图 | 业务导览、双轨证据、项目驾驶舱三个候选 | Image 2 裁切 | ready | `crops/01.png`、`02.png`、`03.png` |
+| 功能图标 | 评审、证据、风险、任务、版本、迁移、上下文 | 复用现有内联图标语义；实现期统一为已有 outline 体系 | planned | 不新增装饰性图标 |
+| 摄影 / 插图 | 无 | 不需要 | not-needed | 产品成立不依赖真实图片 |
+| 色板 / 字体 | 复用现有 Review tokens 与系统字体 | 当前 Review CSS | reuse | 保持可访问对比度 |
+| 动效节奏 | 仅视图切换、证据展开、确认反馈 | 产品交互需求 | planned | 120–180ms，尊重 reduced-motion |
+| 背景 / 表面 | 中性灰画布 + 白色内容面 + 轻边框 | 当前 Review CSS | reuse | 避免玻璃拟态与渐变 |
+| 构图记忆点 | 顶部共享决策时间线 + 业务/工程双视图 | 方向 B | selected | 两种视图共享同一 model digest |
 
 ## 冻结变量
 
-- lens: 待填写
-- theme: 待填写
-- layout: 待填写
-- aesthetic: 待填写
-- memory-point: 待填写
+- lens: evidence-first progressive disclosure
+- theme: quiet professional control plane
+- layout: shared timeline + dual projection workbench
+- aesthetic: restrained, dense, calm, explainable
+- memory-point: 一条时间线，两种视角
+
+## 0.1.21 结果画布资产
+
+- 色彩：暖灰画布 `#f4efe6`、纸白表面 `#fffdf8`、陶土强调 `#c65f3f`、通过状态 `#39795c`。
+- 图片：直接复用用户提供的真实截图，不增加装饰图片或默认网格覆盖层。

package/.openprd/design/active/direction-plan.md

@@ -2,6 +2,22 @@
 
 | 方向 | 生成逻辑 | lens | theme | layout | 审美主张 | 记忆点 | 为什么不同 | 适用场景 | 主要风险 |
 | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
-| 方向 1 | contrast | 待填写 | 待填写 | 待填写 | 待填写 | 待填写 | 待填写 | 待填写 | 待填写 |
-| 方向 2 | reference-transfer | 待填写 | 待填写 | 待填写 | 待填写 | 待填写 | 待填写 | 待填写 | 待填写 |
-| 方向 3 | design-lens | 待填写 | 待填写 | 待填写 | 待填写 | 待填写 | 待填写 | 待填写 | 待填写 |
+| A 业务评审导览 | contrast | progressive disclosure | guided review | 左侧议程 + 中央业务故事图 + 底部确认 | 最低认知负担 | 一步一块完成评审 | 从业务阅读顺序出发，隐藏工程细节 | 非技术用户首次评审 | 工程追溯需要另开入口 |
+| B 双轨证据工作台 | reference-transfer | evidence-first | dual projection | 共享时间线 + 业务/工程 Tab + 证据工作区 | 同一事实，多种读法 | 一条时间线，两种视角 | 把现有 Review 与证据链整合为同一模型双投影 | 产品与工程共同评审 | 信息密度较高，需要默认收起细节 |
+| C 项目驾驶舱 | design-lens | operational overview | control room | 健康总览 + 并行任务 + 迁移/上下文侧栏 | 全局态势一屏掌握 | 项目健康与资源雷达 | 把评审放进项目级控制平面 | 多线程项目负责人 | 容易把 0.1.20 范围扩大成完整项目管理器 |
+
+## 内部评估
+
+| 维度 | A | B | C |
+| --- | ---: | ---: | ---: |
+| 小白可理解性 | 5 | 4 | 3 |
+| 工程可追溯性 | 2 | 5 | 4 |
+| 与现有 Review 兼容 | 4 | 5 | 3 |
+| 控制平面定位 | 3 | 5 | 5 |
+| 0.1.20 可落地性 | 5 | 4 | 2 |
+| 合计 | 19 | 23 | 17 |
+
+- 选 B 为主方向。
+- 吸收 A 的左侧议程与逐步确认，避免双轨变成工程后台。
+- C 保留为后续 Project Cockpit 投影，不塞进本轮 Review 主页面。
+

package/.openprd/design/active/facts-sheet.md

@@ -2,12 +2,21 @@
 
 | 字段 | 当前值 | 来源 | verifiedAt | 状态 |
 | --- | --- | --- | --- | --- |
-| 产品 / 项目名 | 待填写 | 待确认 | - | pending |
-| 版本 / 发布状态 | 待填写 | 待确认 | - | pending |
-| 关键事实 1 | 待填写 | 待确认 | - | pending |
-| 关键事实 2 | 待填写 | 待确认 | - | pending |
+| 产品 / 项目名 | OpenPrd Review Studio | 当前仓库 `src/html-artifacts.js` | 2026-07-10 | verified |
+| 目标版本 | 0.1.21 | 用户确认的版本自增目标 | 2026-07-11 | verified |
+| 主要受众 | 非技术业务用户、产品负责人、工程执行者 | v0018 用户与场景 | 2026-07-10 | verified |
+| 现有视觉语言 | 中性灰背景、白色表面、深色正文、蓝/靛当前态、青色健康态、琥珀风险态 | 当前 Review HTML/CSS | 2026-07-10 | verified |
+| 现有交互 | 阶段轨道、评审清单、需求关系图、四类内容卡、方向卡、底部确认栏 | `src/html-artifacts.js` | 2026-07-10 | verified |
+| 核心问题 | 同一评审里业务结论和工程细节缺少清晰分层，复杂项目不易快速理解 | 用户目标与线程审计 | 2026-07-10 | verified |
+| 技术事实 | v0018 使用稳定 snapshot digest 与 work unit；评审文案由 `review-presentation` 校验 | 当前 CLI 与快照 | 2026-07-10 | verified |
 
-## 备注
+## 设计意图
 
-- 没核实到就保留 `pending`
-- 不要把记忆当来源
+- 让不懂内部实现的人先看懂“为什么做、会发生什么、风险是什么、怎样算完成”。
+- 让工程执行者从同一决策模型切换到任务、证据、版本与追溯信息，不再维护第二套结论。
+- 记忆点是“一条共享决策时间线，两种阅读视角”，而不是再堆一个通用仪表盘。
+
+## 0.1.21 视觉证据画布
+
+- 普通结果画布采用暖色、紧凑双卡结构，截图和结论优先。
+- 网格、基线和辅助线只属于布局类 `alignment-board`，不默认覆盖普通截图。

package/.openprd/design/active/image-preflight.md

@@ -2,8 +2,9 @@
 
 | 问题 | 回答 |
 | --- | --- |
-| 真实图片是不是页面成立前提 | 待填写 |
-| 必需图片类型 | 待填写 |
-| 计划来源 | 待填写 |
-| 缺失风险 | 待填写 |
-| 降级方案 | 待填写 |
+| 真实图片是不是页面成立前提 | 否。Review Studio 是信息与决策产品，依赖真实项目数据而不是摄影素材。 |
+| 必需图片类型 | 只需要三方向交互候选图作为评审证据。 |
+| 计划来源 | 使用 Codex 原生 Image 2 生成，并用 `openprd visual-prepare` 拆分成 reference set。 |
+| 缺失风险 | 候选图只表达信息架构，不作为像素级实现稿；生成文字可能失真。 |
+| 降级方案 | 实现以现有 Review DOM、tokens 和真实 v0018 数据为准，候选图只约束布局、层级和阅读路径。 |
+

package/.openprd/design/active/review-studio-v020-directions/compare-plan.json

@@ -0,0 +1,34 @@
+{
+  "version": 1,
+  "schema": "openprd.visual-prepare.plan.v1",
+  "generatedAt": "2026-07-10 23:10:01",
+  "title": "OpenPrd Review Studio 0.1.20 三方向 对比计划",
+  "referenceSet": ".openprd/design/active/review-studio-v020-directions/reference-set.json",
+  "artifacts": {
+    "focusBoardTemplate": ".openprd/design/active/review-studio-v020-directions/focus-board.template.json",
+    "parallelBoardTemplate": ".openprd/design/active/review-studio-v020-directions/parallel-board.template.json"
+  },
+  "items": [
+    {
+      "id": "01",
+      "label": "对象 01",
+      "reference": ".openprd/design/active/review-studio-v020-directions/crops/01.png",
+      "suggestedActual": "__REPLACE_WITH_IMPLEMENTATION_SCREENSHOT__",
+      "suggestedCommand": "openprd visual-compare . --reference .openprd/design/active/review-studio-v020-directions/crops/01.png --actual __REPLACE_WITH_IMPLEMENTATION_SCREENSHOT__"
+    },
+    {
+      "id": "02",
+      "label": "对象 02",
+      "reference": ".openprd/design/active/review-studio-v020-directions/crops/02.png",
+      "suggestedActual": "__REPLACE_WITH_IMPLEMENTATION_SCREENSHOT__",
+      "suggestedCommand": "openprd visual-compare . --reference .openprd/design/active/review-studio-v020-directions/crops/02.png --actual __REPLACE_WITH_IMPLEMENTATION_SCREENSHOT__"
+    },
+    {
+      "id": "03",
+      "label": "对象 03",
+      "reference": ".openprd/design/active/review-studio-v020-directions/crops/03.png",
+      "suggestedActual": "__REPLACE_WITH_IMPLEMENTATION_SCREENSHOT__",
+      "suggestedCommand": "openprd visual-compare . --reference .openprd/design/active/review-studio-v020-directions/crops/03.png --actual __REPLACE_WITH_IMPLEMENTATION_SCREENSHOT__"
+    }
+  ]
+}

package/.openprd/design/active/review-studio-v020-directions/focus-board.template.json

@@ -0,0 +1,69 @@
+{
+  "mode": "focus-board",
+  "title": "OpenPrd Review Studio 0.1.20 三方向 局部焦点模板",
+  "summary": "把 right.path 替换成实现截图；如果实现截图布局与参考图不同，再分别调整 rightBox。",
+  "left": {
+    "path": ".openprd/design/active/review-studio-v020-directions/source.png",
+    "label": "参考整板"
+  },
+  "right": {
+    "path": "__REPLACE_WITH_IMPLEMENTATION_SCREENSHOT__",
+    "label": "实现截图"
+  },
+  "focusRegions": [
+    {
+      "label": "对象 01",
+      "reason": "1/3 列 · 1/1 行",
+      "leftBox": {
+        "unit": "ratio",
+        "x": 0,
+        "y": 0,
+        "width": 0.333333,
+        "height": 1
+      },
+      "rightBox": {
+        "unit": "ratio",
+        "x": 0,
+        "y": 0,
+        "width": 0.333333,
+        "height": 1
+      }
+    },
+    {
+      "label": "对象 02",
+      "reason": "2/3 列 · 1/1 行",
+      "leftBox": {
+        "unit": "ratio",
+        "x": 0.333333,
+        "y": 0,
+        "width": 0.333333,
+        "height": 1
+      },
+      "rightBox": {
+        "unit": "ratio",
+        "x": 0.333333,
+        "y": 0,
+        "width": 0.333333,
+        "height": 1
+      }
+    },
+    {
+      "label": "对象 03",
+      "reason": "3/3 列 · 1/1 行",
+      "leftBox": {
+        "unit": "ratio",
+        "x": 0.666667,
+        "y": 0,
+        "width": 0.333333,
+        "height": 1
+      },
+      "rightBox": {
+        "unit": "ratio",
+        "x": 0.666667,
+        "y": 0,
+        "width": 0.333333,
+        "height": 1
+      }
+    }
+  ]
+}

package/.openprd/design/active/review-studio-v020-directions/parallel-board.template.json

@@ -0,0 +1,45 @@
+{
+  "mode": "parallel-board",
+  "title": "OpenPrd Review Studio 0.1.20 三方向 参考映射模板",
+  "summary": "每张卡先挂参考 crop。要做多对象、多方向或多页面统一验收时，在对应卡片里继续补实现截图、指标或备注。",
+  "columns": 3,
+  "cardWidth": 360,
+  "items": [
+    {
+      "label": "对象 01",
+      "subtitle": "参考对象 01",
+      "verdict": "待补实现截图",
+      "media": [
+        {
+          "path": ".openprd/design/active/review-studio-v020-directions/crops/01.png",
+          "label": "参考 crop"
+        }
+      ],
+      "notes": "需要时可继续补实现截图、指标或阶段性结论。"
+    },
+    {
+      "label": "对象 02",
+      "subtitle": "参考对象 02",
+      "verdict": "待补实现截图",
+      "media": [
+        {
+          "path": ".openprd/design/active/review-studio-v020-directions/crops/02.png",
+          "label": "参考 crop"
+        }
+      ],
+      "notes": "需要时可继续补实现截图、指标或阶段性结论。"
+    },
+    {
+      "label": "对象 03",
+      "subtitle": "参考对象 03",
+      "verdict": "待补实现截图",
+      "media": [
+        {
+          "path": ".openprd/design/active/review-studio-v020-directions/crops/03.png",
+          "label": "参考 crop"
+        }
+      ],
+      "notes": "需要时可继续补实现截图、指标或阶段性结论。"
+    }
+  ]
+}

package/.openprd/design/active/review-studio-v020-directions/reference-set.json

@@ -0,0 +1,143 @@
+{
+  "version": 1,
+  "schema": "openprd.reference-set.v1",
+  "generatedAt": "2026-07-10 23:10:01",
+  "id": "review-studio-v020-directions",
+  "title": "OpenPrd Review Studio 0.1.20 三方向",
+  "mode": "grid",
+  "summary": "3x1 网格切片，共 3 个参考对象。",
+  "source": {
+    "originalPath": "/Users/chaojifeng/.codex/generated_images/019f4c66-86fb-74d1-8ae8-ec1ce9064e59/exec-6739c328-3559-4bcf-8689-fe9596c42b0b.png",
+    "originalSha256": "571f2b74c32dc4f0e1a8a1a08a6fd14b65243226c401a8a6f684b6f1de223ead",
+    "originalMetadata": {
+      "width": 1716,
+      "height": 917,
+      "format": "png"
+    },
+    "stagedPath": ".openprd/design/active/review-studio-v020-directions/source.png",
+    "stagedSha256": "37ecd4c9ef7853c1fd9f1d237f7bacfe174986b8cd274a7809431a00b444e590",
+    "stagedMetadata": {
+      "width": 1716,
+      "height": 917,
+      "format": "png"
+    }
+  },
+  "selection": {
+    "mode": "grid",
+    "grid": {
+      "columns": 3,
+      "rows": 1
+    },
+    "include": null
+  },
+  "artifacts": {
+    "contactSheet": ".openprd/design/active/review-studio-v020-directions/contact-sheet.jpg",
+    "focusBoardTemplate": ".openprd/design/active/review-studio-v020-directions/focus-board.template.json",
+    "parallelBoardTemplate": ".openprd/design/active/review-studio-v020-directions/parallel-board.template.json",
+    "comparePlan": ".openprd/design/active/review-studio-v020-directions/compare-plan.json"
+  },
+  "items": [
+    {
+      "order": 1,
+      "id": "01",
+      "label": "对象 01",
+      "note": "1/3 列 · 1/1 行",
+      "cropPath": ".openprd/design/active/review-studio-v020-directions/crops/01.png",
+      "cropSha256": "861f3bcc79ca56cb8cad5eda6b7280d9748c555a845933ac045403ed8a36c8a6",
+      "cropMetadata": {
+        "width": 572,
+        "height": 917,
+        "format": "png"
+      },
+      "cropBox": {
+        "unit": "ratio",
+        "x": 0,
+        "y": 0,
+        "width": 0.333333,
+        "height": 1
+      },
+      "absoluteBox": {
+        "x": 0,
+        "y": 0,
+        "width": 572,
+        "height": 917
+      },
+      "requestedUnit": "ratio",
+      "requestedBox": {
+        "unit": "ratio",
+        "x": 0,
+        "y": 0,
+        "width": 0.333333,
+        "height": 1
+      }
+    },
+    {
+      "order": 2,
+      "id": "02",
+      "label": "对象 02",
+      "note": "2/3 列 · 1/1 行",
+      "cropPath": ".openprd/design/active/review-studio-v020-directions/crops/02.png",
+      "cropSha256": "7f1927369d514079615b0f475856ad6481645822e8a14ef390bbf9a3633c3091",
+      "cropMetadata": {
+        "width": 572,
+        "height": 917,
+        "format": "png"
+      },
+      "cropBox": {
+        "unit": "ratio",
+        "x": 0.333333,
+        "y": 0,
+        "width": 0.333333,
+        "height": 1
+      },
+      "absoluteBox": {
+        "x": 572,
+        "y": 0,
+        "width": 572,
+        "height": 917
+      },
+      "requestedUnit": "ratio",
+      "requestedBox": {
+        "unit": "ratio",
+        "x": 0.333333,
+        "y": 0,
+        "width": 0.333333,
+        "height": 1
+      }
+    },
+    {
+      "order": 3,
+      "id": "03",
+      "label": "对象 03",
+      "note": "3/3 列 · 1/1 行",
+      "cropPath": ".openprd/design/active/review-studio-v020-directions/crops/03.png",
+      "cropSha256": "295ee41a5fd24ba080fcd7a695fd6fa7d4252cdf71f4f29c04cc3d285227cb0b",
+      "cropMetadata": {
+        "width": 572,
+        "height": 917,
+        "format": "png"
+      },
+      "cropBox": {
+        "unit": "ratio",
+        "x": 0.666667,
+        "y": 0,
+        "width": 0.333333,
+        "height": 1
+      },
+      "absoluteBox": {
+        "x": 1144,
+        "y": 0,
+        "width": 572,
+        "height": 917
+      },
+      "requestedUnit": "ratio",
+      "requestedBox": {
+        "unit": "ratio",
+        "x": 0.666667,
+        "y": 0,
+        "width": 0.333333,
+        "height": 1
+      }
+    }
+  ]
+}

package/.openprd/design/active/selected-direction.md

@@ -1,13 +1,27 @@
 # Selected Direction
 
-- selected: 待填写
-- reason: 待填写
-- lens: 待填写
-- theme: 待填写
-- layout: 待填写
-- aesthetic: 待填写
-- memory-point: 待填写
+- selected: B 双轨证据工作台
+- reason: 在小白可理解、工程可追溯、现有实现兼容和控制平面定位之间得分最高；同一 ReviewModel 可直接支撑两种投影，避免形成两套真相。
+- lens: evidence-first progressive disclosure
+- theme: quiet professional control plane
+- layout: 共享决策时间线 + 业务/工程双视图 + 可展开证据区
+- aesthetic: 克制、清晰、可信、信息密度可控
+- memory-point: 一条时间线，两种视角
 - components:
-  - 待填写
+  - 共享决策时间线
+  - 业务视角 / 工程视角切换
+  - 左侧评审议程
+  - 业务故事与风险卡
+  - 工程证据、任务与版本追溯
+  - 固定确认与修订动作栏
 - follow-up risks:
-  - 待填写
+  - 默认必须打开业务视角，工程信息按需展开。
+  - 两种视图必须共享同一 model digest，样式重渲染不能使业务确认失效。
+  - 实现后需要业务词泄漏检查、同构卡片对齐板和真实浏览器截图证据。
+
+## 0.1.21 补充方向：紧凑结果画布
+
+- scope: `visual-compare` 最终结果展示。
+- aesthetic: 温暖、直接、低装饰，截图占主要面积。
+- memory-point: 用户一眼看到“比了什么、是否通过”。
+- routing: 普通结果无网格；只有布局、间距、对齐或同构结构进入 `alignment-board`。

package/.openprd/engagements/active/control-plane-architecture.json

@@ -0,0 +1,203 @@
+{
+  "type": "architecture",
+  "locale": "zh-CN",
+  "title": "OpenPrd 0.1.20 可解释项目控制平面",
+  "subtitle": "一份项目事实、一个并发协调层、按需编译上下文，并向业务与工程生成不同读法。",
+  "components": [
+    {
+      "id": "people-agents",
+      "name": "用户与 Agent",
+      "type": "external",
+      "subtitle": "业务用户负责目标与决策，Codex、Cursor、Claude Code 在授权范围内执行。",
+      "details": [
+        "显式任务、会话和工作单元标识始终优先",
+        "高风险动作绑定当前操作的明确授权"
+      ]
+    },
+    {
+      "id": "review-studio",
+      "name": "业务与工程双视图",
+      "type": "frontend",
+      "subtitle": "同一 ReviewModel 生成小白可懂的业务视图和工程可追溯视图。",
+      "details": [
+        "共享决策时间线与 model digest",
+        "默认业务视角，工程证据按需展开"
+      ]
+    },
+    {
+      "id": "adapter-spi",
+      "name": "跨工具适配层",
+      "type": "cloud",
+      "subtitle": "归一生命周期事件，协商能力并渲染各工具需要的上下文与决定。",
+      "details": [
+        "Codex、Cursor、Claude Code 使用同一合同",
+        "能力缺口明确返回，不模拟支持"
+      ]
+    },
+    {
+      "id": "context-compiler",
+      "name": "上下文编译器",
+      "type": "backend",
+      "subtitle": "按任务、风险、权限与 token 预算生成稳定 Capsule 或 Delta。",
+      "details": [
+        "完整摘要 800 tokens，增量 250 tokens",
+        "同 revision 同输入产生同 digest",
+        "默认只读，telemetry 与事实分离"
+      ]
+    },
+    {
+      "id": "gate-engine",
+      "name": "分级门禁与证据",
+      "type": "security",
+      "subtitle": "项目、变更、工作单元、任务、会话和单次操作各自判断。",
+      "details": [
+        "局部任务不被无关项目债务阻断",
+        "发布与真实迁移继续执行项目级门禁"
+      ]
+    },
+    {
+      "id": "task-runtime",
+      "name": "并发任务运行态",
+      "type": "backend",
+      "subtitle": "Lane、claim、lease、heartbeat、write-set 与 CAS 协调多线程执行。",
+      "details": [
+        "同一任务只能被一个有效 claim 持有",
+        "不相交文件范围可以并行",
+        "崩溃后安全回收过期 lease"
+      ]
+    },
+    {
+      "id": "domain-services",
+      "name": "需求与项目服务",
+      "type": "backend",
+      "subtitle": "Change、Task、Review、Quality、Knowledge 与 Migration 只通过控制平面变更事实。",
+      "details": [
+        "保持现有 CLI 兼容入口",
+        "Knowledge 有证据、作用域、有效期与替代链"
+      ]
+    },
+    {
+      "id": "project-ledger",
+      "name": "Project Ledger",
+      "type": "database",
+      "subtitle": "事件信封、连续 revision、幂等键和可重建投影构成唯一业务真相。",
+      "details": [
+        "current、task graph、review、knowledge index 都是投影",
+        "支持 verify、replay 与损坏恢复"
+      ]
+    },
+    {
+      "id": "atomic-store",
+      "name": "原子存储与版本清单",
+      "type": "database",
+      "subtitle": "原子写入、锁、checksum、reader/writer 版本和迁移记录保护旧项目。",
+      "details": [
+        "legacy、dual、ledger 三种兼容模式",
+        "真实升级前备份，失败按项目回滚",
+        "symlink 与过新 schema 安全拒绝写入"
+      ]
+    }
+  ],
+  "flows": [
+    {
+      "source": "people-agents",
+      "target": "review-studio",
+      "label": "理解范围、风险与决定",
+      "type": "standard"
+    },
+    {
+      "source": "people-agents",
+      "target": "adapter-spi",
+      "label": "提交任务与运行事件",
+      "type": "standard"
+    },
+    {
+      "source": "adapter-spi",
+      "target": "context-compiler",
+      "label": "协商能力与上下文格式",
+      "type": "standard"
+    },
+    {
+      "source": "context-compiler",
+      "target": "gate-engine",
+      "label": "附带适用门禁与权限",
+      "type": "security"
+    },
+    {
+      "source": "gate-engine",
+      "target": "task-runtime",
+      "label": "允许后领取任务范围",
+      "type": "security"
+    },
+    {
+      "source": "task-runtime",
+      "target": "domain-services",
+      "label": "在 claim 与 write-set 内执行",
+      "type": "standard"
+    },
+    {
+      "source": "domain-services",
+      "target": "project-ledger",
+      "label": "追加事实事件",
+      "type": "standard"
+    },
+    {
+      "source": "project-ledger",
+      "target": "context-compiler",
+      "label": "提供最新权威事实",
+      "type": "standard"
+    },
+    {
+      "source": "project-ledger",
+      "target": "review-studio",
+      "label": "生成双投影",
+      "type": "standard"
+    },
+    {
+      "source": "atomic-store",
+      "target": "project-ledger",
+      "label": "原子持久化与版本保护",
+      "type": "security"
+    }
+  ],
+  "summaryCards": [
+    {
+      "title": "用户得到什么",
+      "color": "frontend",
+      "items": [
+        "进入项目后直接看到本次任务需要的最少上下文",
+        "多线程并行不会互相覆盖，冲突会说清原因和下一步",
+        "业务评审先看结果，工程细节仍能从同一结论追溯"
+      ]
+    },
+    {
+      "title": "系统如何可靠",
+      "color": "backend",
+      "items": [
+        "唯一项目账本 + 可重建投影，运行态不再冒充业务真相",
+        "revision、幂等键、claim、lease、write-set 与 CAS 防止丢失更新",
+        "上下文编译默认只读、可缓存、可增量、可解释"
+      ]
+    },
+    {
+      "title": "如何安全升级",
+      "color": "cloud",
+      "items": [
+        "0.1.20 先以 dual 模式和旧状态对账",
+        "每个真实项目都先预检、备份、校验，再原子替换",
+        "归档保持不变，失败只回滚当前项目"
+      ]
+    }
+  ],
+  "reviewInstructions": [
+    "用户已明确授权按此架构继续实现，无需中途停顿。",
+    "任何 lost update、错误项目写入、归档变化、敏感信息泄漏或无法回滚都阻断真实刷新。",
+    "版本升级和 fleet 刷新只能在全量测试与项目级门禁健康后执行。"
+  ],
+  "metadata": {
+    "versionId": "v0018",
+    "owner": "OpenPrd",
+    "targetSystem": "OpenPrd CLI 与本地项目生态",
+    "reviewStatus": "confirmed"
+  }
+}