fix: 统一 HWLAB PaC Pipeline provenance 合同

2026-07-11 08:17:50 +02:00
parent 764ff398c3
commit 2f93a44115
13 changed files with 362 additions and 65 deletions
@@ -0,0 +1,6 @@
+# R1.1 调查报告
+
+- 来源：[UniDesk #1756](https://github.com/pikasTech/unidesk/issues/1756)
+- 结论：旧实现分别在 `hwlab-node/web-probe.ts`、`hwlab-node/render.ts` 和 source-artifact renderer 内硬编码 provenance，target YAML 未声明 owner 合同。
+- 阻塞：source-artifact 的正常 postprocess 使用 `sh -c` 传递大脚本，触发 argv 上限后又因空输出执行 `null.trim()`；已纳入同一闭环修复。
+- 边界：不放宽 verifier，不从 live runtime 反向导出，不手工修改运行面。
@@ -0,0 +1,6 @@
+# R1.2 YAML 与 parser 报告
+
+- 来源：[UniDesk #1756](https://github.com/pikasTech/unidesk/issues/1756)
+- owner：`config/hwlab-node-lanes.yaml#lanes.v03.targets.NC01.pipelineProvenance`。
+- parser：target 必须显式声明合同，并校验精确 `configRef`、`hwlab-runtime-lane` renderer 与 `remote-pipeline-annotation` mode。
+- effective config hash：由共享 helper 对已解析 target spec 做稳定摘要，避免 YAML 静态 hash 的循环依赖。
@@ -0,0 +1,7 @@
+# R1.3 共享渲染报告
+
+- 来源：[UniDesk #1756](https://github.com/pikasTech/unidesk/issues/1756)
+- 共享合同：`scripts/src/pipeline-provenance.ts` 统一持有四个 annotation key、annotations 生成与 manifest 读取。
+- 正常路径：HWLAB overlay 携带 YAML-derived annotations，正常 control-plane postprocess 使用可复用 native 脚本写入最终 Pipeline。
+- source-artifact：复用同一 HWLAB contract，并要求正常 postprocess 已写入一致 provenance；不再二次硬编码或补写 Pipeline。
+- 工具修复：大 postprocess 改走 stdin，失败状态不再对空输出调用 `trim()`。
@@ -0,0 +1,25 @@
+# HWLAB PaC 实时 Pipeline 来源合同
+
+- 来源：[UniDesk #1756](https://github.com/pikasTech/unidesk/issues/1756)
+- 范围：只修 YAML-owned provenance 合同、共享渲染与定向验证；不部署、不手工触发 CI/CD。
+
+
+## R1 [in_progress]
+
+修复 [UniDesk #1756](https://github.com/pikasTech/unidesk/issues/1756) 的 HWLAB PaC live Pipeline provenance 永久漂移，完成任务后将详细报告写入[任务报告](./details/hwlab-pac-live-provenance/R1_Task_Report.md)。
+
+### R1.1 [completed]
+
+调查 [UniDesk #1756](https://github.com/pikasTech/unidesk/issues/1756) 的 YAML owner、parser、正常 renderer 与 source-artifact 复用边界，完成任务后将详细报告写入[任务报告](./details/hwlab-pac-live-provenance/R1.1_Task_Report.md)。
+
+### R1.2 [completed]
+
+在 owning YAML 与 parser 定义四字段 provenance 合同，禁止代码隐藏默认值，完成任务后将详细报告写入[任务报告](./details/hwlab-pac-live-provenance/R1.2_Task_Report.md)。
+
+### R1.3 [completed]
+
+让正常 GitOps/control-plane renderer 与 source-artifact renderer复用共享 provenance overlay/postprocess，完成任务后将详细报告写入[任务报告](./details/hwlab-pac-live-provenance/R1.3_Task_Report.md)。
+
+### R1.4 [in_progress]
+
+补齐正常 render 精确四字段及 source-artifact/live/embedded aligned 验证，提交非 draft PR 并 preflight，完成任务后将详细报告写入[任务报告](./details/hwlab-pac-live-provenance/R1.4_Task_Report.md)。