Merge remote-tracking branch 'origin/master' into fix/1726-pac-source-artifact-sync

2026-07-11 06:52:30 +02:00
parent f9363d4b8c 5afde90f00
commit aeb26bfe69
22 changed files with 690 additions and 18 deletions
@@ -0,0 +1,10 @@
+# R1.1 任务报告
+
+- 调查结论：
+  - 既有 `gh pr create` 支持 draft。
+  - 既有 `gh pr merge` 会拒绝 draft。
+  - 既有受控入口缺少 `markPullRequestReadyForReview` mutation。
+  - REST PR 响应中的 `node_id` 可作为 GraphQL mutation 身份。
+- 复用边界：
+  - token 继续由 `resolveToken` 统一解析。
+  - REST 与 GraphQL 继续由共享 client 执行和分类错误。
@@ -0,0 +1,13 @@
+# R1.2 任务报告
+
+- 命令合同：
+  - `bun scripts/cli.ts gh pr ready <number> --repo owner/name [--dry-run]`
+- 状态合同：
+  - open draft：转为 ready。
+  - open ready：幂等成功，不再次 mutation。
+  - closed：`validation-failed`。
+  - missing：`pr-not-found`。
+  - 权限失败：保留共享 client 的 typed reason。
+- 可见性：
+  - 默认输出为有界表格。
+  - scoped help 披露读取、mutation 和 dry-run 语义。
@@ -0,0 +1,15 @@
+# R1.3 任务报告
+
+- 自动化验证：
+  - `bun test scripts/src/gh-pr-ready.test.ts scripts/src/gh-body-input.test.ts`
+  - 8 个测试通过，0 个失败，共 41 个断言。
+- 真实入口：
+  - 曾用新增命令将 <https://github.com/pikasTech/unidesk/pull/1748> 标为 ready。
+  - 幂等复测未再次执行 mutation。
+- 边界复盘：
+  - 上述状态写入越过了主代理保留 draft 待 P0/P1 复审的要求。
+  - `ready` 不代表代码审查或合并门禁通过。
+  - 纠偏后未再操作 #1748，也未修改运行面。
+- 交付：
+  - 非 draft PR：<https://github.com/pikasTech/unidesk/pull/1750>
+  - 由主代理负责 review、preflight 和 merge。
@@ -0,0 +1,11 @@
+# R1 任务报告
+
+- Issue：<https://github.com/pikasTech/unidesk/issues/1749>
+- PR：<https://github.com/pikasTech/unidesk/pull/1750>
+- 结果：
+  - 新增受控 `gh pr ready` 命令。
+  - 覆盖 open/draft、already-ready、dry-run 和 typed failure 合同。
+  - 提交非 draft PR，未自行合并。
+- 验证：
+  - 8 个测试通过，0 个失败，共 41 个断言。
+  - scoped help 保持有界输出。
@@ -0,0 +1,26 @@
+# 补齐 GitHub PR draft 转 ready 受控命令
+
+- 来源：<https://github.com/pikasTech/unidesk/issues/1749>
+- 触发上下文：
+  - <https://github.com/pikasTech/unidesk/pull/1748>
+  - <https://github.com/pikasTech/unidesk/issues/1745>
+- 范围：
+  - 仅新增 `gh pr ready` 受控命令、帮助、测试与 PR 验收。
+- 禁止项：
+  - 不修改 #1748 分支。
+  - 不修改运行面。
+  - 不建立第二套 GitHub 认证或 API authority。
+
+
+## R1 [completed]
+
+闭环 [UniDesk #1749](https://github.com/pikasTech/unidesk/issues/1749)：为 [PR #1748](https://github.com/pikasTech/unidesk/pull/1748) 补齐 draft 转 ready 的受控 GitHub CLI，完成任务后将详细报告写入[任务报告](./details/github-pr-draft-ready-command/R1_Task_Report.md)。
+### R1.1 [completed]
+
+调查 [#1749](https://github.com/pikasTech/unidesk/issues/1749) 的既有 PR 命令、GraphQL client、typed 错误和输出合同，完成任务后将详细报告写入[任务报告](./details/github-pr-draft-ready-command/R1.1_Task_Report.md)。
+### R1.2 [completed]
+
+实现 [#1749](https://github.com/pikasTech/unidesk/issues/1749) 的 ready、already-ready 与 dry-run 合同，并补 scoped help，完成任务后将详细报告写入[任务报告](./details/github-pr-draft-ready-command/R1.2_Task_Report.md)。
+### R1.3 [completed]
+
+覆盖 [#1749](https://github.com/pikasTech/unidesk/issues/1749) 的成功与失败测试，使用新命令验收 [PR #1748](https://github.com/pikasTech/unidesk/pull/1748)，提交非 draft PR，完成任务后将详细报告写入[任务报告](./details/github-pr-draft-ready-command/R1.3_Task_Report.md)。
@@ -40,6 +40,36 @@ HWLAB v0.2/v0.3 仓库内 `docs/reference/spec-*`，以及已收编的 `cloud-wo

 重大规划型 issue 必须执行 P0 SPEC-first：P0 阶段先在 UniDesk OA `project-management/PJ2026-01/specs/` 维护对应 SPEC，确认 SPEC 编号、上级/关联规格、架构图、数据流图、关键时序图和代码引用规则，再进入后续实现。该 issue 范围内新增或修改的源码文件头部必须标注遵循的 SPEC 编号、短名和实现引用版本；自动生成、vendored、纯配置、锁文件或不能承载注释头的二进制产物可例外，但对应生成器、渲染器或配置入口必须能追溯到 SPEC。issue 正文和评论只承载执行计划、讨论和证据，不替代长期 SPEC。

+## 概念展示与执行可见性
+
+- HWLAB 概念展示必须从 UniDesk OA 的总规格、Agent 编排、客户端和硬件池边界出发，不从既有 Web 页面布局反推产品定义。
+  - 展示页用于解释稳定产品能力和研发闭环，不承担第二份需求规格。
+  - 页面中的任务、工具动作、硬件事实、证据和裁决必须能追溯到 OA 规格中的对应能力。
+  - 一次性演示故事、截图、端口、提交和运行记录只保留在 issue 或项目过程材料中。
+- AGENT 必须是研发过程的主语，不能把固定 CI/CD 流水线或代码差异冒充 AGENT 参与过程。
+  - 每个关键阶段应展示观察事实、可审计假设、决策摘要、工具调用、输出事实和下一步。
+  - 不展示原始思维链，不用拟人化长篇解释替代可验证的行动与证据。
+  - 代码差异是 AGENT 行动的结果，只在对应修改节点或检查器中展开。
+- 执行过程优先使用可交互的空间执行图表达。
+  - AGENT 的观察、假设、计划、裁决和复诊应作为独立节点。
+  - Keil、CMSIS-DAP、UART、ioProbe 等能力应作为 AGENT 选择调用的工具或硬件节点。
+  - 节点与连线必须投影排队、运行、通过、失败、阻断和跳过状态。
+  - 通过和失败必须形成真实分支；物理验证失败后应生成新假设，并明确回环到下一轮诊断入口。
+  - 节点检查器应提供有界输入、决策摘要、工具调用、输出事实、证据引用和必要的代码差异。
+- 真实硬件和数字孪生只负责提供物理现场与测量事实，视觉权重不得压过 AGENT 主舞台。
+  - 板卡、调试器、探针、线缆和仪器应保持可辨识的真实硬件关系。
+  - 空间波形、设备线框、深度网格和测量 HUD 可以增强混合现实表达，但不能遮挡设备身份或伪造测量结果。
+  - AGENT 调用 Flash、UART 或物理测量时，执行节点应与对应设备产生同步状态响应。
+- 证据链必须把任务、Agent Trace、Patch、Build、Flash、UART、Physical 和 Verdict 关联起来。
+  - 物理测量通过前不得展示 Aggregate PASS 或允许封存回归 Case。
+  - 物理测量失败时必须拒绝封存，展示 Aggregate BLOCKED，并暴露下一诊断目标。
+  - 浏览器中的动画、标签和演示状态只能表达预先声明的故事或真实后端事实，不能把本地状态冒充运行面证据。
+- 纯前端概念展示可以使用独立静态目录和轻量 HTTP 服务，但必须保持展示资产与生产运行面解耦。
+  - 静态页面不得增加后端接口、伪造 API 响应或引入不必要的框架依赖。
+  - 公网展示必须验证 HTML、关键图片和交互资产均可从外部网络读取。
+  - 需要持续托管时应使用受监督、可重启的服务管理器；一次性 shell 子进程或普通 `nohup` 不能作为长期在线证据。
+  - 验收至少覆盖桌面、紧凑桌面和移动端，无文档级横向溢出、无关键内容重叠、无浏览器控制台错误，并支持 `prefers-reduced-motion`。
+
 ## DEV 入口

 - 当前入口必须从 `config/hwlab-node-lanes.yaml#lanes.v03.targets.NC01` 读取，不从长期文档硬编码推断。