@openprd/cli 0.1.11 → 0.1.19

package/.openprd/changes/openprd-generated-change/tasks.md

@@ -0,0 +1,357 @@
+# 任务
+
+- [x] T001.01 评审生成的 spec 覆盖
+  - type: governance
+  - done: 生成的 agent-requirements spec 符合 PRD 意图
+  - verify: openprd change . --validate --change openprd-generated-change
+  - test-layer: manual
+  - test-size: manual
+  - test-scope: governance
+  - evidence-plan: openprd change . --validate --change openprd-generated-change
+  - upgrade-reason: 治理任务以结构校验、评审确认和变更状态证据为主
+  - execution-mode: serial
+  - parallel-group: governance
+  - write-scope: .openprd/changes/**, .openprd/**
+  - owner-role: main-agent
+  - local-verify: openprd change . --validate --change openprd-generated-change
+  - integration-owner: main-agent
+
+- [x] T001.02 对齐共享契约与 Host API 调用边界
+  - type: implementation
+  - deps: T001.01
+  - done: 共享契约、Host API 和上下游调用边界已经对齐，后续功能可以直接接线。 涉及: 依赖 0.1.18 生图路由协议。
+  - verify: openprd tasks . --change openprd-generated-change --item T001.02 --evidence-required
+  - test-layer: integration, e2e
+  - test-size: large
+  - test-scope: visual-flow
+  - evidence-plan: 主流程自动化、截图或 visual-compare 证据 + 本任务 verify 命令；轻量 UI 可视优化也需要 before/after、verification-board 或 alignment-board 证据，同构卡片/列表要覆盖内部内容槽位
+  - upgrade-reason: 触达用户可见路径，需要端到端或视觉级证据；轻量 UI 可视优化不能只用构建或 dev-check 收口
+  - execution-mode: parallel-workers
+  - parallel-group: contracts
+  - write-scope: src/**, test/**, docs/basic/backend-structure.md
+  - owner-role: worker
+  - local-verify: openprd tasks . --change openprd-generated-change --item T001.02 --evidence-required
+  - integration-owner: main-agent
+
+- [x] T001.03 接通界面入口、导航与页面挂载
+  - type: implementation
+  - deps: T001.02
+  - done: 用户可以从正确入口进入对应界面，页面挂载与状态收尾已经接通。 涉及: 依赖 0.1.18 生图路由协议。
+  - verify: openprd tasks . --change openprd-generated-change --item T001.03 --evidence-required
+  - test-layer: integration, e2e
+  - test-size: large
+  - test-scope: visual-flow
+  - evidence-plan: 主流程自动化、截图或 visual-compare 证据 + 本任务 verify 命令；轻量 UI 可视优化也需要 before/after、verification-board 或 alignment-board 证据，同构卡片/列表要覆盖内部内容槽位
+  - upgrade-reason: 触达用户可见路径，需要端到端或视觉级证据；轻量 UI 可视优化不能只用构建或 dev-check 收口
+  - execution-mode: parallel-workers
+  - parallel-group: contracts
+  - write-scope: src/**, test/**, docs/basic/backend-structure.md
+  - owner-role: worker
+  - local-verify: openprd tasks . --change openprd-generated-change --item T001.03 --evidence-required
+  - integration-owner: main-agent
+
+- [x] T001.04 实现选区状态随画布保存并可查询
+  - type: implementation
+  - deps: T001.03
+  - done: 已完成：选区状态随画布保存并可查询
+  - verify: openprd tasks . --change openprd-generated-change --item T001.04 --evidence-required
+  - test-layer: integration, e2e
+  - test-size: large
+  - test-scope: visual-flow
+  - evidence-plan: 主流程自动化、截图或 visual-compare 证据 + 本任务 verify 命令；轻量 UI 可视优化也需要 before/after、verification-board 或 alignment-board 证据，同构卡片/列表要覆盖内部内容槽位
+  - upgrade-reason: 触达用户可见路径，需要端到端或视觉级证据；轻量 UI 可视优化不能只用构建或 dev-check 收口
+  - execution-mode: parallel-workers
+  - parallel-group: domain
+  - write-scope: src/**, test/**
+  - owner-role: worker
+  - local-verify: openprd tasks . --change openprd-generated-change --item T001.04 --evidence-required
+  - integration-owner: main-agent
+
+- [x] T001.05 实现插图 API 支持 left/right/below 摆放与 holder 替换
+  - type: implementation
+  - deps: T001.04
+  - done: 已完成：插图 API 支持 left/right/below 摆放与 holder 替换
+  - verify: openprd tasks . --change openprd-generated-change --item T001.05 --evidence-required
+  - test-layer: unit, integration
+  - test-size: medium
+  - test-scope: api-contract
+  - evidence-plan: 单元测试锁定规则 + 集成或命令行契约验证
+  - upgrade-reason: 触达 CLI/API/Agent 契约或生成物，需要中间层验证
+  - execution-mode: parallel-workers
+  - parallel-group: contracts
+  - write-scope: src/**, test/**, docs/basic/backend-structure.md
+  - owner-role: worker
+  - local-verify: openprd tasks . --change openprd-generated-change --item T001.05 --evidence-required
+  - integration-owner: main-agent
+
+- [x] T001.06 实现标注导出携带 annotationEdit 与源图形 ID 元数据
+  - type: implementation
+  - deps: T001.05
+  - done: 已完成：标注导出携带 annotationEdit 与源图形 ID 元数据
+  - verify: openprd tasks . --change openprd-generated-change --item T001.06 --evidence-required
+  - test-layer: unit, integration
+  - test-size: medium
+  - test-scope: cli-contract
+  - evidence-plan: 单元测试锁定规则 + 集成或命令行契约验证
+  - upgrade-reason: 触达 CLI/API/Agent 契约或生成物，需要中间层验证
+  - execution-mode: parallel-workers
+  - parallel-group: domain
+  - write-scope: src/**, test/**
+  - owner-role: worker
+  - local-verify: openprd tasks . --change openprd-generated-change --item T001.06 --evidence-required
+  - integration-owner: main-agent
+
+- [x] T001.07 实现生图占位卡 handoff 记录携带宽高与比例契约
+  - type: implementation
+  - deps: T001.06
+  - done: 已完成：生图占位卡 handoff 记录携带宽高与比例契约
+  - verify: openprd tasks . --change openprd-generated-change --item T001.07 --evidence-required
+  - test-layer: unit, integration
+  - test-size: medium
+  - test-scope: cli-contract
+  - evidence-plan: 单元测试锁定规则 + 集成或命令行契约验证
+  - upgrade-reason: 触达 CLI/API/Agent 契约或生成物，需要中间层验证
+  - execution-mode: parallel-workers
+  - parallel-group: contracts
+  - write-scope: src/**, test/**, docs/basic/backend-structure.md
+  - owner-role: worker
+  - local-verify: openprd tasks . --change openprd-generated-change --item T001.07 --evidence-required
+  - integration-owner: main-agent
+
+- [x] T001.08 实现hook 识别画布协同意图并注入闭环指引
+  - type: implementation
+  - deps: T001.07
+  - done: 已完成：hook 识别画布协同意图并注入闭环指引
+  - verify: openprd tasks . --change openprd-generated-change --item T001.08 --evidence-required
+  - test-layer: unit, integration
+  - test-size: medium
+  - test-scope: cli-contract
+  - evidence-plan: 单元测试锁定规则 + 集成或命令行契约验证
+  - upgrade-reason: 触达 CLI/API/Agent 契约或生成物，需要中间层验证
+  - execution-mode: serial
+  - parallel-group: integration
+  - write-scope: src/**, test/**, docs/basic/**
+  - owner-role: main-agent
+  - local-verify: openprd tasks . --change openprd-generated-change --item T001.08 --evidence-required
+  - integration-owner: main-agent
+
+- [x] T001.09 打通主流程闭环：用户在画布圈选原图并批注，点“标注修改请求”，Agent 读标注生成修订图并放回原图右侧 等 4 项
+  - type: implementation
+  - deps: T001.08
+  - done: 主流程关键节点已经打通，用户可以按预期从入口走到结果收尾。 涉及: 用户在画布圈选原图并批注，点“标注修改请求”，Agent 读标注生成修订图并放回原图右侧 等 4 项。
+  - verify: openprd tasks . --change openprd-generated-change --item T001.09 --evidence-required
+  - test-layer: integration, e2e
+  - test-size: large
+  - test-scope: user-flow
+  - evidence-plan: 主流程自动化、截图或 visual-compare 证据 + 本任务 verify 命令；轻量 UI 可视优化也需要 before/after、verification-board 或 alignment-board 证据，同构卡片/列表要覆盖内部内容槽位
+  - upgrade-reason: 触达用户可见路径，需要端到端或视觉级证据；轻量 UI 可视优化不能只用构建或 dev-check 收口
+  - execution-mode: serial
+  - parallel-group: integration
+  - write-scope: src/**, test/**, docs/basic/**
+  - owner-role: main-agent
+  - local-verify: openprd tasks . --change openprd-generated-change --item T001.09 --evidence-required
+  - integration-owner: main-agent
+
+- [x] T001.10 验证canvas 服务新增 GET /api/selection 与 POST /api/insert-image 且测试通过
+  - type: verification
+  - deps: T001.09
+  - done: 已验证：canvas 服务新增 GET /api/selection 与 POST /api/insert-image 且测试通过
+  - verify: openprd tasks . --change openprd-generated-change --item T001.10 --evidence-required
+  - test-layer: unit, integration
+  - test-size: medium
+  - test-scope: api-contract
+  - evidence-plan: 单元测试锁定规则 + 集成或命令行契约验证
+  - upgrade-reason: 触达 CLI/API/Agent 契约或生成物，需要中间层验证
+  - execution-mode: parallel-workers
+  - parallel-group: verification
+  - write-scope: test/**, .openprd/harness/test-reports/**
+  - owner-role: worker
+  - local-verify: openprd tasks . --change openprd-generated-change --item T001.10 --evidence-required
+  - integration-owner: main-agent
+
+- [x] T001.11 验证标注导出带 annotationEdit 元数据并能被 hook 指引消费
+  - type: verification
+  - deps: T001.10
+  - done: 已验证：标注导出带 annotationEdit 元数据并能被 hook 指引消费
+  - verify: openprd tasks . --change openprd-generated-change --item T001.11 --evidence-required
+  - test-layer: unit, integration
+  - test-size: medium
+  - test-scope: cli-contract
+  - evidence-plan: 单元测试锁定规则 + 集成或命令行契约验证
+  - upgrade-reason: 触达 CLI/API/Agent 契约或生成物，需要中间层验证
+  - execution-mode: parallel-workers
+  - parallel-group: verification
+  - write-scope: test/**, .openprd/harness/test-reports/**
+  - owner-role: worker
+  - local-verify: openprd tasks . --change openprd-generated-change --item T001.11 --evidence-required
+  - integration-owner: main-agent
+
+- [x] T001.12 验证hook 对画布协同意图注入引导语
+  - type: verification
+  - deps: T001.11
+  - done: 已验证：hook 对画布协同意图注入引导语
+  - verify: openprd tasks . --change openprd-generated-change --item T001.12 --evidence-required
+  - test-layer: unit, integration
+  - test-size: medium
+  - test-scope: cli-contract
+  - evidence-plan: 单元测试锁定规则 + 集成或命令行契约验证
+  - upgrade-reason: 触达 CLI/API/Agent 契约或生成物，需要中间层验证
+  - execution-mode: parallel-workers
+  - parallel-group: verification
+  - write-scope: test/**, .openprd/harness/test-reports/**
+  - owner-role: worker
+  - local-verify: openprd tasks . --change openprd-generated-change --item T001.12 --evidence-required
+  - integration-owner: main-agent
+
+- [x] T001.13 回归非功能约束：界面文案面向普通用户 / API 只监听本地回环地址
+  - type: verification
+  - deps: T001.12
+  - done: 非功能约束已经回归确认。 涉及: 界面文案面向普通用户 / API 只监听本地回环地址。
+  - verify: openprd tasks . --change openprd-generated-change --item T001.13 --evidence-required
+  - test-layer: integration, e2e
+  - test-size: large
+  - test-scope: user-flow
+  - evidence-plan: 主流程自动化、截图或 visual-compare 证据 + 本任务 verify 命令；轻量 UI 可视优化也需要 before/after、verification-board 或 alignment-board 证据，同构卡片/列表要覆盖内部内容槽位
+  - upgrade-reason: 触达用户可见路径，需要端到端或视觉级证据；轻量 UI 可视优化不能只用构建或 dev-check 收口
+  - execution-mode: parallel-workers
+  - parallel-group: verification
+  - write-scope: test/**, .openprd/harness/test-reports/**
+  - owner-role: worker
+  - local-verify: openprd tasks . --change openprd-generated-change --item T001.13 --evidence-required
+  - integration-owner: main-agent
+
+- [x] T001.14 回归非功能约束：新增代码有集成测试覆盖
+  - type: verification
+  - deps: T001.13
+  - done: 非功能约束已经回归确认。 涉及: 新增代码有集成测试覆盖。
+  - verify: openprd tasks . --change openprd-generated-change --item T001.14 --evidence-required
+  - test-layer: unit, integration
+  - test-size: medium
+  - test-scope: cli-contract
+  - evidence-plan: 单元测试锁定规则 + 集成或命令行契约验证
+  - upgrade-reason: 触达 CLI/API/Agent 契约或生成物，需要中间层验证
+  - execution-mode: parallel-workers
+  - parallel-group: verification
+  - write-scope: test/**, .openprd/harness/test-reports/**
+  - owner-role: worker
+  - local-verify: openprd tasks . --change openprd-generated-change --item T001.14 --evidence-required
+  - integration-owner: main-agent
+
+- [x] T001.15 回归边界条件与失败处理：边界情况：无选区时 selection API 返回空且 Agent 收到明确提示 等 5 项
+  - type: verification
+  - deps: T001.14
+  - done: 边界条件与失败处理已经回归确认。 涉及: 边界情况：无选区时 selection API 返回空且 Agent 收到明确提示 等 5 项。
+  - verify: openprd tasks . --change openprd-generated-change --item T001.15 --evidence-required
+  - test-layer: unit, integration
+  - test-size: medium
+  - test-scope: api-contract
+  - evidence-plan: 单元测试锁定规则 + 集成或命令行契约验证
+  - upgrade-reason: 触达 CLI/API/Agent 契约或生成物，需要中间层验证
+  - execution-mode: parallel-workers
+  - parallel-group: verification
+  - write-scope: test/**, .openprd/harness/test-reports/**
+  - owner-role: worker
+  - local-verify: openprd tasks . --change openprd-generated-change --item T001.15 --evidence-required
+  - integration-owner: main-agent
+
+- [x] T001.16 验证成本与额度护栏
+  - type: verification
+  - deps: T001.15
+  - done: 已验证免费、试用或低权限用户不能绕过额度、并发、频率或总量限制
+  - verify: openprd tasks . --change openprd-generated-change --item T001.16 --evidence-required
+  - test-layer: integration, security
+  - test-size: medium
+  - test-scope: security
+  - evidence-plan: 正向路径 + 越权、额度、并发或敏感信息负向验证
+  - upgrade-reason: 触达权限、安全、成本或滥用边界，需要至少集成级证据
+  - execution-mode: parallel-workers
+  - parallel-group: verification
+  - write-scope: test/**, .openprd/harness/test-reports/**
+  - owner-role: worker
+  - local-verify: openprd tasks . --change openprd-generated-change --item T001.16 --evidence-required
+  - integration-owner: main-agent
+
+- [x] T001.17 验证滥用与越权路径
+  - type: verification
+  - deps: T001.16
+  - done: 已覆盖重复请求、并发请求、越权身份和异常恢复等负向场景
+  - verify: openprd tasks . --change openprd-generated-change --item T001.17 --evidence-required
+  - test-layer: integration, security
+  - test-size: medium
+  - test-scope: security
+  - evidence-plan: 正向路径 + 越权、额度、并发或敏感信息负向验证
+  - upgrade-reason: 触达权限、安全、成本或滥用边界，需要至少集成级证据
+  - execution-mode: parallel-workers
+  - parallel-group: verification
+  - write-scope: test/**, .openprd/harness/test-reports/**
+  - owner-role: worker
+  - local-verify: openprd tasks . --change openprd-generated-change --item T001.17 --evidence-required
+  - integration-owner: main-agent
+
+- [x] T001.18 验证成本监控、报警和止损
+  - type: verification
+  - deps: T001.17
+  - done: 已确认用量或成本信号、报警阈值和人工/自动止损动作可执行
+  - verify: openprd tasks . --change openprd-generated-change --item T001.18 --evidence-required
+  - test-layer: integration, security
+  - test-size: medium
+  - test-scope: security
+  - evidence-plan: 正向路径 + 越权、额度、并发或敏感信息负向验证
+  - upgrade-reason: 触达权限、安全、成本或滥用边界，需要至少集成级证据
+  - execution-mode: parallel-workers
+  - parallel-group: verification
+  - write-scope: test/**, .openprd/harness/test-reports/**
+  - owner-role: worker
+  - local-verify: openprd tasks . --change openprd-generated-change --item T001.18 --evidence-required
+  - integration-owner: main-agent
+
+- [x] T001.19 维护 docs/basic 项目基础文档
+  - type: documentation
+  - deps: T001.18
+  - done: 已检查 docs/basic 是否缺失或因本次需求、流程、结构、依赖、产品行为变化而过期；若涉及后端、脚本、Agent 或工具链变更，已同步评估 CLI 与 API 接入面，并在 backend-structure.md 中记录事实或不适用原因；需要更新的基础文档已同步
+  - verify: openprd standards . --verify
+  - test-layer: manual
+  - test-size: manual
+  - test-scope: docs
+  - evidence-plan: openprd standards . --verify
+  - upgrade-reason: 文档任务以标准校验和人工审查证据为主
+  - execution-mode: parallel-workers
+  - parallel-group: docs
+  - write-scope: docs/basic/**, README*.md
+  - owner-role: worker
+  - local-verify: openprd standards . --verify
+  - integration-owner: main-agent
+
+- [x] T001.20 更新文件说明书和文件夹 README
+  - type: documentation
+  - deps: T001.19
+  - done: 本次变更涉及的文件说明书和文件夹 README 已检查；缺失的已补齐，过期的已更新
+  - verify: openprd standards . --verify
+  - test-layer: manual
+  - test-size: manual
+  - test-scope: docs
+  - evidence-plan: openprd standards . --verify
+  - upgrade-reason: 文档任务以标准校验和人工审查证据为主
+  - execution-mode: parallel-workers
+  - parallel-group: docs
+  - write-scope: docs/basic/**, README*.md
+  - owner-role: worker
+  - local-verify: openprd standards . --verify
+  - integration-owner: main-agent
+
+- [x] T001.21 运行 OpenPrd spec 校验
+  - type: governance
+  - deps: T001.20
+  - done: 生成的 change 通过 OpenPrd 校验
+  - verify: openprd change . --validate --change openprd-generated-change
+  - test-layer: manual
+  - test-size: manual
+  - test-scope: governance
+  - evidence-plan: openprd change . --validate --change openprd-generated-change
+  - upgrade-reason: 治理任务以结构校验、评审确认和变更状态证据为主
+  - execution-mode: serial
+  - parallel-group: governance
+  - write-scope: .openprd/changes/**, .openprd/**
+  - owner-role: main-agent
+  - local-verify: openprd change . --validate --change openprd-generated-change
+  - integration-owner: main-agent

package/.openprd/changes/pm-human-in-the-loop/.openprd.yaml

@@ -0,0 +1,2 @@
+schema: openprd.change.v1
+generatedFrom: v0008

package/.openprd/changes/pm-human-in-the-loop/design.md

@@ -0,0 +1,38 @@
+# 设计
+
+## 背景
+
+用户明确反馈不少人用了 OpenPrd 觉得疑惑它到底是干嘛的，希望有一套软件工程视角的标准流程引导；画布做了一半，需要继续对标白板工具补齐人机协同能力。
+
+## 目标
+
+- 产品经理任何时刻都能一眼看到自己处在 7 步标准流程的哪一步和下一步动作
+- 画布接入评审方向导入与流程位置提示，让 PM 在白板上完成方向标注并把结论发回 Agent
+
+## 范围
+
+- 新增 openprd guide 命令：7 步标准流程 + 当前位置 + 下一步动作（PM 语言，支持 --json）
+- review.html 顶部新增流程位置条（stepper）
+- 画布服务端新增 /api/review-directions 与 /api/guide
+- 画布前端新增导入评审方向按钮与流程位置条
+
+## 约束
+
+- 改动集中在 src/standards.js、src/quality.js、src/openspec/change-lifecycle.js、src/review-presentation.js、src/html-artifacts.js，新增 src/docs-compact.js；skills 生成源同步 openprd-shared / openprd-frontend-design / command-catalog。
+- 提交与状态写回不能泄露用户本地无关改动或敏感信息。
+- Codex 原生 imagegen（生成 3 方向交互稿图片）；现有 review artifact 渲染与 hash 校验管线。
+
+## 业务护栏
+
+- 成本来源: imagegen 每方向一次调用，共 3 次；报告清理为本地文件操作无外部成本。
+- 额度限制: docs-compact 单次只处理 docs/basic 下的标准文档；retention 默认保留最近 30 份报告可配置。
+- 滥用防护: docs-compact 重写稿默认写到 sibling draft 待确认，不直接覆盖原文档；retention 不触碰 evidence 目录中被 latest 报告引用的文件。
+- 监控信号: standards verify 输出 docsQuality 结果；doctor 输出 .openprd 体积与报告数量提示。
+- 报警阈值: 单行超 300 字符 warning；prd.md 落后最新版本超过 20 个版本 warning；quality/reports 超过 200 份提示清理。
+- 止损动作: 任一清理动作失败即中止并保留原状；归档失败回退为仅提示不移动。
+
+## 风险与开放问题
+
+- 假设: imagegen 由 Codex 原生 Image 2 提供，OpenPrd 只消费图片路径；review.html 静态打开，选择结果通过现有 canvas/browser handoff 或 review --mark 通道回传；巨行阈值默认 300 字符可配置。
+- 风险: 流程步骤定义与既有 lane/gate 概念不完全一一对应，guide 只做展示层推断，不改门禁行为
+- 问题: 画布方向卡片是否需要内置投票/评分组件，留到下一轮看使用反馈

package/.openprd/changes/pm-human-in-the-loop/proposal.md

@@ -0,0 +1,29 @@
+# PM 流程引导与画布评审协同（Human-in-the-loop 升级）
+
+## 背景与原因
+
+产品经理使用 OpenPrd 时缺少一条看得懂的标准流程指引，经常不知道自己处在需求到收口的哪一步、下一步该做什么；对话协同画布目前是通用白板，没有接入评审方向选择等 OpenPrd 流程环节，Human-in-the-loop 在工具之间断开。
+
+## 变更内容
+
+- 新增 openprd guide 命令：7 步标准流程 + 当前位置 + 下一步动作（PM 语言，支持 --json）
+- review.html 顶部新增流程位置条（stepper）
+- 画布服务端新增 /api/review-directions 与 /api/guide
+- 画布前端新增导入评审方向按钮与流程位置条
+- guide 命令基于工作区状态推断 7 步流程位置
+- review.html 渲染 stepper
+- canvas /api/review-directions 返回方向元数据与图片
+- canvas 前端导入方向卡片组
+- 在 openprd 自身仓库通过单元测试与 standards/quality/run verify；用 Codex CLI 在本地跑一个桌面任务实测新流程效果并留下证据。
+
+## 能力范围
+
+- `agent-requirements`: PM 流程引导与画布评审协同（Human-in-the-loop 升级） 需求。
+
+## 影响范围
+
+- 主要用户: 用 Vibe Coding 方式做产品的产品经理
+- 成本来源: imagegen 每方向一次调用，共 3 次；报告清理为本地文件操作无外部成本。
+- 额度限制: docs-compact 单次只处理 docs/basic 下的标准文档；retention 默认保留最近 30 份报告可配置。
+- 依赖: Codex 原生 imagegen（生成 3 方向交互稿图片）；现有 review artifact 渲染与 hash 校验管线。
+- 风险: 流程步骤定义与既有 lane/gate 概念不完全一一对应，guide 只做展示层推断，不改门禁行为

package/.openprd/changes/pm-human-in-the-loop/specs/agent-requirements/spec.md

@@ -0,0 +1,16 @@
+## 新增需求
+
+### 需求：PM 流程引导与画布评审协同（Human-in-the-loop 升级）
+产品经理使用 OpenPrd 时缺少一条看得懂的标准流程指引，经常不知道自己处在需求到收口的哪一步、下一步该做什么；对话协同画布目前是通用白板，没有接入评审方向选择等 OpenPrd 流程环节，Human-in-the-loop 在工具之间断开。
+
+#### 场景：主流程成功
+- **当** PM 打开终端或让 Agent 运行 openprd guide，看到 7 步流程和当前位置，按提示进入下一步
+- **则** 在 openprd 自身仓库通过单元测试与 standards/quality/run verify；用 Codex CLI 在本地跑一个桌面任务实测新流程效果并留下证据。
+
+#### 场景：边界情况保持可见
+- **当** 工作区还没有任何需求版本时 guide 显示第 1 步并给出起步动作
+- **则** 产品应保持该情况明确可见，以支持实现和验证
+
+#### 场景：失败模式得到处理
+- **当** 方向图片文件缺失时导入跳过该方向并提示，不中断其他方向导入
+- **则** 产品应提供有边界且可评审的结果

package/.openprd/changes/pm-human-in-the-loop/task-events.jsonl

@@ -0,0 +1,18 @@
+{"version":1,"at":"2026-07-03 17:36:34","changeId":"pm-human-in-the-loop","action":"advance","taskId":"T001.01","taskTitle":"评审生成的 spec 覆盖","ok":true,"verify":null,"evidence":"openprd change --validate 通过；spec 覆盖 guide/stepper/canvas 三个能力块","notes":null}
+{"version":1,"at":"2026-07-03 17:36:47","changeId":"pm-human-in-the-loop","action":"advance","taskId":"T001.02","taskTitle":"接通界面入口、导航与页面挂载","ok":true,"verify":null,"evidence":"画布右栏新增评审协同区，guide 进度与导入按钮已挂载；review.html 顶部阶段条已接入 renderReviewPage","notes":null}
+{"version":1,"at":"2026-07-03 17:36:47","changeId":"pm-human-in-the-loop","action":"advance","taskId":"T001.03","taskTitle":"补齐日志、诊断与可观测性信号","ok":true,"verify":null,"evidence":"guide/canvas API 失败路径返回结构化 ok:false+error；画布导入失败有用户可读状态提示","notes":null}
+{"version":1,"at":"2026-07-03 17:36:47","changeId":"pm-human-in-the-loop","action":"advance","taskId":"T001.04","taskTitle":"实现guide 命令基于工作区状态推断 7 步流程位置","ok":true,"verify":null,"evidence":"src/guide.js 实现 7 步推断；test/openprd-guide-canvas.test.js 前 2 个用例覆盖 fresh/review/direction/tasks 阶段流转","notes":null}
+{"version":1,"at":"2026-07-03 17:36:47","changeId":"pm-human-in-the-loop","action":"advance","taskId":"T001.05","taskTitle":"实现review.html 渲染 stepper","ok":true,"verify":null,"evidence":"renderReviewStageRail 渲染阶段条，方向步按 designDirections 动态出现；测试用例 5 覆盖有/无方向两种渲染","notes":null}
+{"version":1,"at":"2026-07-03 17:36:47","changeId":"pm-human-in-the-loop","action":"advance","taskId":"T001.06","taskTitle":"实现canvas /api/review-directions 返回方向元数据与图片","ok":true,"verify":null,"evidence":"canvas-workspace buildReviewDirectionsPayload + GET /api/review-directions 返回方向元数据与 dataURL 图片；测试用例 3/4 覆盖","notes":null}
+{"version":1,"at":"2026-07-03 17:36:47","changeId":"pm-human-in-the-loop","action":"advance","taskId":"T001.07","taskTitle":"实现canvas 前端导入方向卡片组","ok":true,"verify":null,"evidence":"canvas-app importReviewDirectionsToCanvas 导入方向卡片组（框+标题+说明+图片，选中高亮），渲染冒烟通过","notes":null}
+{"version":1,"at":"2026-07-03 17:41:31","changeId":"pm-human-in-the-loop","action":"advance","taskId":"T001.08","taskTitle":"打通主流程闭环：PM 打开终端或让 Agent 运行 openprd guide，看到 7 步流程和当前位置，按提示进入下一步 等 3 项","ok":true,"verify":null,"evidence":"/tmp/openprd-desktop-demo 端到端演示：guide 从第 1 步走到第 3 步；review.html 阶段条+3 方向卡浏览器截图；画布导入 3 方向卡成功（截图证据见本轮对话）","notes":null}
+{"version":1,"at":"2026-07-03 17:41:31","changeId":"pm-human-in-the-loop","action":"advance","taskId":"T001.09","taskTitle":"验证在 openprd 自身仓库通过单元测试与 standards/quality/run verify；用 Codex CLI 在本地跑一个桌面任务实测新流程效果并留下证据","ok":true,"verify":null,"evidence":"npm test 241/241 通过（含 test/openprd-guide-canvas.test.js 5 例）；桌面任务在 /tmp/openprd-desktop-demo 实测 guide/review/canvas 全链路","notes":null}
+{"version":1,"at":"2026-07-03 17:41:32","changeId":"pm-human-in-the-loop","action":"advance","taskId":"T001.10","taskTitle":"回归非功能约束：不新增外部依赖 / guide 与画布 API 只读工作区状态，不写状态","ok":true,"verify":null,"evidence":"无新增外部依赖；guide 与 /api/guide、/api/review-directions 全部只读，不写工作区状态","notes":null}
+{"version":1,"at":"2026-07-03 17:41:32","changeId":"pm-human-in-the-loop","action":"advance","taskId":"T001.11","taskTitle":"回归非功能约束：全部文案用 PM 能看懂的普通语言","ok":true,"verify":null,"evidence":"guide 输出、阶段条、画布评审协同区文案均为 PM 可读普通语言，无内部术语","notes":null}
+{"version":1,"at":"2026-07-03 17:41:32","changeId":"pm-human-in-the-loop","action":"advance","taskId":"T001.12","taskTitle":"回归边界条件与失败处理：边界情况：工作区还没有任何需求版本时 guide 显示第 1 步并给出起步动作 等 3 项","ok":true,"verify":null,"evidence":"空工作区 guide 显示第 1 步并给起步动作（测试用例 1）；无方向时 /api/review-directions 返回 ok:false（测试用例 4）；无版本时 reason=no-version","notes":null}
+{"version":1,"at":"2026-07-03 17:41:32","changeId":"pm-human-in-the-loop","action":"advance","taskId":"T001.13","taskTitle":"验证成本与额度护栏","ok":true,"verify":null,"evidence":"本能力零外部成本：无模型调用、无第三方 API，纯本地文件读取","notes":null}
+{"version":1,"at":"2026-07-03 17:41:32","changeId":"pm-human-in-the-loop","action":"advance","taskId":"T001.14","taskTitle":"验证滥用与越权路径","ok":true,"verify":null,"evidence":"canvas API 仅绑定 127.0.0.1 本地服务；图片路径解析强制限制在项目根内，杜绝路径穿越","notes":null}
+{"version":1,"at":"2026-07-03 17:41:32","changeId":"pm-human-in-the-loop","action":"advance","taskId":"T001.15","taskTitle":"验证成本监控、报警和止损","ok":true,"verify":null,"evidence":"无消耗型成本，无需报警与止损；质量报告 retention 沿用上轮机制","notes":null}
+{"version":1,"at":"2026-07-03 17:41:32","changeId":"pm-human-in-the-loop","action":"advance","taskId":"T001.16","taskTitle":"维护 docs/basic 项目基础文档","ok":true,"verify":null,"evidence":"docs/basic prd/app-flow/backend-structure/file-structure/tech-stack 已补 guide 与画布评审协同","notes":null}
+{"version":1,"at":"2026-07-03 17:41:32","changeId":"pm-human-in-the-loop","action":"advance","taskId":"T001.17","taskTitle":"更新文件说明书和文件夹 README","ok":true,"verify":null,"evidence":"file-structure.md 已加 src/guide.js 条目；命令目录 agent-integration.js 已补 guide 与画布评审协同","notes":null}
+{"version":1,"at":"2026-07-03 17:41:32","changeId":"pm-human-in-the-loop","action":"advance","taskId":"T001.18","taskTitle":"运行 OpenPrd spec 校验","ok":true,"verify":null,"evidence":"openprd change --validate 通过","notes":null}