docs(ql3): record D-422 console milestone

2026-09-20 16:07:11 +08:00 · 2026-08-29 14:13:03 +08:00
parent f28bf74d1b
commit 951de26ffd
3 changed files with 10 additions and 8 deletions
@@ -11,7 +11,7 @@
 最新增量证据（2026-08-29）：
- D-422/ADR-0517（已实现源码候选，阶段实物待 CI/milestone）：Local Console 不再用隐藏 spec 的 bounded Task read 拼装 update。新增 `POST /api/v3/projects/:projectId/tasks/:taskId/authoring`：User Bearer 先通过 `task.update`，再由 owner-private 两分钟一次性 proof 提升为 `local_console`，同时重跑 `task.read/task.update` 并要求 exact Policy fence 一致；完整定义读取后再次确认 credential，记录独立 durable `task.authoring.read` audit，并签发只保存摘要的 10 分钟一次性 lease。lease 绑定 Project/Task/revision/content digest/credential ID+version/User subject；Edge/Standalone 上限 8/32、请求时惰性清理，无数据库表、migration、timer、watcher、daemon、Pool 或新 package。Task update 必须先以 lease 验证旧快照，再用第二份 exact-content proof 确认保存，并继续由 D-421 的事务 authority 执行 expectedRevision、Policy、credential、RoleBinding 与 audit fence；create 拒绝夹带 lease。Console 只开放可严格识别的内建 argv command 编辑，Task ID 只读，未展示的 environment、Secret bundle、working directory、未来 config 字段与 labels 原样保留。真实 SQLite/loopback 已通过 authoring challenge→完整定义/lease→save challenge→revision 2→bounded read 隐藏 spec→新 fence 启动；真实 Chromium 完成双 proof 更新并验证隐藏 config/labels 不丢失，390×844 无横向溢出。Local API `64/64`，18-package clean build/test `3,038 total / 3,016 pass / 22 conditional skip / 0 fail`；三资产 69,723 bytes，默认 Edge 保持 2,737,205 bytes/329 files/58 modules，opt-in Edge/Standalone Console 为 4,077,890/4,078,034 bytes、473 files/12 packages/95 modules，RSS delta 16,269,312/16,318,464 bytes；package/source、122-module Edge import 与 Cluster dependency audit 均 compatible。默认 headless 与 Cluster 路径不变。远端主 CI 与新同源双架构 Console milestone 未闭合前，本项不得冒充现有 D-421 下载产物。
+- D-422/ADR-0517（已实现并交付同源双架构 Console Alpha Candidate）：Local Console 不再用隐藏 spec 的 bounded Task read 拼装 update。新增 `POST /api/v3/projects/:projectId/tasks/:taskId/authoring`：User Bearer 先通过 `task.update`，再由 owner-private 两分钟一次性 proof 提升为 `local_console`，同时重跑 `task.read/task.update` 并要求 exact Policy fence 一致；完整定义读取后再次确认 credential，记录独立 durable `task.authoring.read` audit，并签发只保存摘要的 10 分钟一次性 lease。lease 绑定 Project/Task/revision/content digest/credential ID+version/User subject；Edge/Standalone 上限 8/32、请求时惰性清理，无数据库表、migration、timer、watcher、daemon、Pool 或新 package。Task update 必须先以 lease 验证旧快照，再用第二份 exact-content proof 确认保存，并继续由 D-421 的事务 authority 执行 expectedRevision、Policy、credential、RoleBinding 与 audit fence；create 拒绝夹带 lease。Console 只开放可严格识别的内建 argv command 编辑，Task ID 只读，未展示的 environment、Secret bundle、working directory、未来 config 字段与 labels 原样保留。真实 SQLite/loopback 已通过 authoring challenge→完整定义/lease→save challenge→revision 2→bounded read 隐藏 spec→新 fence 启动；真实 Chromium 完成双 proof 更新并验证隐藏 config/labels 不丢失，390×844 无横向溢出。Local API `64/64`，18-package clean build/test `3,038 total / 3,016 pass / 22 conditional skip / 0 fail`；三资产 69,723 bytes，默认 Edge 保持 2,737,205 bytes/329 files/58 modules，opt-in Edge/Standalone Console 为 4,077,890/4,078,034 bytes、473 files/12 packages/95 modules，RSS delta 16,269,312/16,318,464 bytes；package/source、122-module Edge import 与 Cluster dependency audit 均 compatible。默认 headless 与 Cluster 路径不变。提交 `f28bf74d1bd29e9b8a8727915de19509f4bda9cf` 的主 CI run `33236204273` 为 41 success/3 expected skip/0 fail，Kubernetes run `33236204254` 为 1/1；显式 Console milestone run `33237026187` 为 42 success/2 scope skip/0 fail，生成 187,834,834-byte amd64、185,066,450-byte arm64 Trial Kit 与 5,623-byte milestone，保留至 2026-09-28。下载索引通过 checksum 与离线 auditor，返回 `compatible=true`。因此 D-422 已是可下载、可验真、可 fresh 试运行并安全编辑内建 command Task 的 `3.0.0-alpha.2` 阶段实物，但仍不是公开 release、2.x 生产升级或长期支持版本。
 - D-421/ADR-0516（已实现并交付同源双架构 Console Alpha Candidate）：Local Web Task mutation 不再受限于短生命周期 CLI 的进程级 active credential。`PUT /api/v3/projects/:projectId/tasks/:taskId` 把 Bearer 限定为 session credential，第一次 exact request 只在 deployment root 内 `0700` 目录发布 `0600`、当前 UID、两分钟、一次性的私有 proof file；HTTP 只返回 authorization ID、canonical request digest、expiry 与 basename，不返回 proof 或宿主绝对路径。proof 绑定 Task 全内容、credential ID/version 与 User subject；Edge/Standalone pending 上限为 8/32，按请求惰性清理，不新增 timer/watcher/daemon。验证后 principal 提升为短期 `local_console`，既有 Task administration service 重跑 Policy；SQLite runtime 为每个请求建立独立 credential-fenced repository，并在 Task append 事务内复验 credential/Identity/pepper、actor、Project/RoleBinding fence，原子提交 allowed audit 与 mutation。并发测试证明两个 User repository 不共享 ambient authority，撤销 A 不影响 B，RoleBinding 漂移仍原子拒绝；真实 loopback HTTP→私有 proof file→SQLite create 与 Chromium 编辑器/proof ticket 已通过。Console 当前完成 command Task 创建；HTTP 与 CLI 支持完整 create/update，Web update 等待强认证 authoring read/lease，避免用不含 spec 的 bounded read 覆盖未知字段。三资产合计 62,632 bytes；Local API 56/56、18-package clean build/test 3,030 total/3,008 pass/22 条件跳过/0 fail，package/source、Local image、122-module Edge import 与 Cluster dependency audit 均 compatible。首个阶段提交 `884912d1` 暴露默认 Edge 静态加载管理 authority 的真实回归：x64 21,229,568-byte RSS 超过 20 MiB 门，failed-only 重跑再次失败；修复没有扩大预算，而是改为 proof 验证后的 request-time dynamic import。默认 Edge 恢复 2,737,205 bytes/329 files/58 modules，opt-in Edge/Standalone Console 为 4,041,294/4,041,438 bytes、472 files/12 packages/94 modules，均保有门禁余量；默认 headless 与 Cluster 路径不变。修复提交 `dc1686bd6fb3505174dd9a14098ae5c2c92a1a7f` 的主 CI run `33229592307` 为 41 success/3 expected skip/0 fail，Kubernetes run `33229592293` 成功；显式 Console milestone run `33230227006` 为 42 success/2 scope skip/0 fail，生成 187,797,970-byte amd64、185,029,586-byte arm64 Trial Kit 与 5,623-byte milestone，保留至 2026-09-28。下载索引通过 checksum 与离线 auditor，返回 `compatible=true`。因此 D-421 已是可下载、可验真、可 fresh 试运行的 `3.0.0-alpha.2` 阶段实物，但仍不是公开 release、生产升级或长期支持版本。
@@ -68,4 +68,4 @@ Console 对内建 `command + qinglong/command@v1 + argv` 提供“编辑任务
 本地 Local API 为 `64/64`；18-package clean build/test 为 `3,038 total / 3,016 pass / 22 conditional、platform 或 external-service skip / 0 fail`。package boundary 保持 18 packages 且无 single-source/shallow package，Cluster dependency 与 122-module Edge import audit 均 compatible。默认 Edge 为 2,737,205 bytes/329 files/58 modules；opt-in Edge/Standalone Console 为 4,077,890/4,078,034 bytes、473 files、12 packages、95 modules，RSS delta 16,269,312/16,318,464 bytes，均低于既有门。三资产合计 69,723 bytes。真实 Chromium 已完成双 proof 更新到 revision 2，并以 409 模拟断言验证未展示 config/labels 与 lease header 不得丢失；390×844 无横向溢出。
-本 ADR 被合入、远端主 CI 及对应 Profile 门通过前只算源码候选；同源 amd64/arm64 Console Trial Kit 与 milestone index 重新生成并离线验真后，才升级为新的可下载阶段产物。既有 D-421 Console v5 milestone 仍是当前可下载实物，不能改名冒充 D-422。
+本 ADR 已由提交 `f28bf74d1bd29e9b8a8727915de19509f4bda9cf` 的远端主 CI `33236204273`、Kubernetes deployment `33236204254` 与显式 Local Console milestone `33237026187` 闭合。新 run 生成独立的 amd64/arm64 Console Trial Kit 与 milestone index；下载索引通过 `SHA256SUMS` 和仓库离线 auditor，返回 `compatible=true`。因此 D-422 已升级为新的可下载阶段产物；D-421 archive 仅保留为不含 Web 编辑能力的历史实物，没有被改名复用。该结论不把 Alpha 扩大为公开 release、2.x 生产升级或长期支持版本。
@@ -26,22 +26,24 @@
 | D-419 Console 首自动化闭环 | quickstart 创建无网络/SecretRef/Trigger 的示例 Task；原生 CI 使用真实 Owner credential 完成 read、fenced start、`succeeded` 与 bounded log marker | 仍不提供 Web Task 编辑、2.x 升级或生产远程管理 |
 | D-420 Console Run 日志观察面 | 选择 Run 后经既有认证/Policy/Audit 链读取 latest Attempt 首个 32 KiB，展示 range、truncation、pending/retired 等明确状态 | 不自动轮询、不提供整文件下载；Web Task 创建/修订仍待独立强认证事务切片 |
 | D-421 Console Task 创建切片 | request-scoped credential fence、两分钟一次性本机 proof、同事务 Policy/Audit/Task mutation 已完成；Console 可创建 command Task；同源双架构 Console v5 Trial Kit 与 milestone 已生成并验真 | Web update 等待 authoring read/lease；Cluster 不复用 Local proof；仍不是生产或公开发布 |
-| D-422 Console Task 安全编辑切片 | 源码候选已实现强认证完整定义读取、10 分钟一次性 authoring lease、第二份 exact save proof 与 revision/content/credential fence；Console 可无损编辑内建 argv command Task；本地完整 package/Profile/浏览器门已通过 | 待远端主 CI 和新同源双架构 Console milestone；现有 D-421 archive 不包含本能力 |
+| D-422 Console Task 安全编辑切片 | 强认证完整定义读取、10 分钟一次性 authoring lease、第二份 exact save proof 与 revision/content/credential fence 已完成；Console 可无损编辑内建 argv command Task；同源双架构 Console v5 Trial Kit 与 milestone 已生成并验真 | Cluster 不复用 Local proof；尚无通用 workflow 编辑器、2.x 升级或生产远程管理；仍不是正式发布 |
 D-421 已关闭 D-420 记录的“Web Task mutation 必须独立设计”缺口，而且没有改名复用 run `33173769047` 的旧 archive。修复提交 `dc1686bd6fb3505174dd9a14098ae5c2c92a1a7f` 的普通主 CI [run 33229592307](https://github.com/whyour/qinglong/actions/runs/33229592307) 为 41 success/3 expected artifact-finalizer skip/0 fail，同源 Kubernetes deployment [run 33229592293](https://github.com/whyour/qinglong/actions/runs/33229592293) 成功；随后显式 Local Console milestone [run 33230227006](https://github.com/whyour/qinglong/actions/runs/33230227006) 为 42 success/2 scope skip/0 fail。由此 Web 创建能力已进入新的阶段实物，而不再只是候选源码。
-D-422 当前仍按“源码候选”登记：本地真实 SQLite/loopback 已证明读取、租约、第二次 proof、更新与新围栏启动闭环；18-package clean build/test 为 `3,038 total / 3,016 pass / 22 conditional skip / 0 fail`，Local API `64/64`，默认 Edge 与 opt-in Edge/Standalone Console 资源门及真实 Chromium 双证明编辑均通过。但在远端主 CI 和新的显式双架构 milestone 闭合前，不声称现有下载物已经包含 Web 编辑。阶段产物必须绑定新的 exact commit/run/artifact digest，禁止沿用 D-421 的 archive 名称或证据。
+D-422 已从“源码候选”升级为阶段实物：本地真实 SQLite/loopback 已证明读取、租约、第二次 proof、更新与新围栏启动闭环；18-package clean build/test 为 `3,038 total / 3,016 pass / 22 conditional skip / 0 fail`，Local API `64/64`，默认 Edge 与 opt-in Edge/Standalone Console 资源门及真实 Chromium 双证明编辑均通过。修复提交 `f28bf74d1bd29e9b8a8727915de19509f4bda9cf` 的普通主 CI [run 33236204273](https://github.com/whyour/qinglong/actions/runs/33236204273) 为 41 success/3 expected artifact-finalizer skip/0 fail，同源 Kubernetes deployment [run 33236204254](https://github.com/whyour/qinglong/actions/runs/33236204254) 为 1/1；随后显式 Local Console milestone [run 33237026187](https://github.com/whyour/qinglong/actions/runs/33237026187) 为 42 success/2 scope skip/0 fail。阶段产物绑定新的 exact commit/run/artifact digest，没有沿用或改名复用 D-421 archive。
 D-418 防止把“20 天代码和测试”冒充“用户已经能下载并完整操作”：源码与普通 CI 已具备生成、审计和实跑两种 Trial Kit 的能力，但只有显式 artifact run 生成且被同 run 的双架构 milestone 收录后，才是可下载阶段产物。操作说明见 [Local Alpha Trial Kit](./ql3-local-alpha-trial-kit.md) 与 [Local Web Console](./ql3-local-web-console.md)。
-当前最新可交付 Local Console v5 绑定提交 `dc1686bd6fb3505174dd9a14098ae5c2c92a1a7f` 与 [GitHub Actions run 33230227006](https://github.com/whyour/qinglong/actions/runs/33230227006)，保留至 2026-09-28：
+当前最新可交付 Local Console v5 绑定提交 `f28bf74d1bd29e9b8a8727915de19509f4bda9cf` 与 [GitHub Actions run 33237026187](https://github.com/whyour/qinglong/actions/runs/33237026187)，保留至 2026-09-28：
- `ql3-alpha-dc1686bd6fb3505174dd9a14098ae5c2c92a1a7f-local-console-amd64`：187,797,970 bytes，GitHub artifact SHA-256 `5b51547d98d56f0e6997a922ef2da853f2355115c1f3d22a7cd31dad916516cb`，内部 Docker archive SHA-256 `877e899d8379a3834ed6d89138dd4b0209725cfea3621f542c7bc4825b249cf4`；
+- `ql3-alpha-f28bf74d1bd29e9b8a8727915de19509f4bda9cf-local-console-amd64`：187,834,834 bytes，GitHub artifact SHA-256 `60cfb88c783f0d5bf1ce78819868ddb7a0d28dcbdb3841f00545a7178ff9419a`，内部 Docker archive SHA-256 `da74659043687dddd1cf33c8079ea343a4290107d59ae9f7a1dd83d668937d5a`；
- `ql3-alpha-dc1686bd6fb3505174dd9a14098ae5c2c92a1a7f-local-console-arm64`：185,029,586 bytes，GitHub artifact SHA-256 `1b5b30acbd9f31d7c96b710f1b929cbec25996a13c8600f088343f884c4c9ca6`，内部 Docker archive SHA-256 `82cce3524355957eb5166adf146e3a1dcbcad7b8f53935fe3a15403b865c7b0b`；
+- `ql3-alpha-f28bf74d1bd29e9b8a8727915de19509f4bda9cf-local-console-arm64`：185,066,450 bytes，GitHub artifact SHA-256 `b5381deec99d1418d52155ce11b7d7c1006a9bc0b456091f4e437a1bbb6b8439`，内部 Docker archive SHA-256 `6b05e8d75e10f884c55173808a48a2baf3b2cb3154c722b6d3d2775322964225`；
- `ql3-alpha-dc1686bd6fb3505174dd9a14098ae5c2c92a1a7f-local-console-milestone`：5,623 bytes，GitHub artifact SHA-256 `70a49da1e9466322c9b198567559eb313a51171ea0609875d1419a83de407813`。
+- `ql3-alpha-f28bf74d1bd29e9b8a8727915de19509f4bda9cf-local-console-milestone`：5,623 bytes，GitHub artifact SHA-256 `02026bdf665573097977e6d895e01a758d664b98a55054330937e107dbc2851f`。
 > 注：GitHub 返回的 artifact digest 绑定其下载 ZIP，milestone 内的 `archiveSha256` 绑定 Trial Kit 中的 Docker archive，二者不是同一个文件。下载后的 milestone `SHA256SUMS` 已复核，仓库 auditor 返回 `schema=qinglong/alpha-local-milestone-audit@v2`、`compatible=true`，并确认 `3.0.0-alpha.2`、`console`、amd64/arm64、run/attempt/sourceRevision 全部闭合。
 上一份仅包含 D-421 Web 创建能力的 Local Console v5 绑定提交 `dc1686bd6fb3505174dd9a14098ae5c2c92a1a7f` 与 [GitHub Actions run 33230227006](https://github.com/whyour/qinglong/actions/runs/33230227006)，不包含 D-422 Web 编辑能力。
 前一份首自动化/日志观察阶段的 Local Console v5 绑定提交 `37abfa160da7669b2628c0a70dbd52f50f7dcec1` 与 [GitHub Actions run 33173769047](https://github.com/whyour/qinglong/actions/runs/33173769047)，保留至 2026-09-27：
 - `ql3-alpha-37abfa160da7669b2628c0a70dbd52f50f7dcec1-local-console-amd64`：187,712,409 bytes，GitHub artifact SHA-256 `baf9861b70ebaccccab45fb49714589dc2d2083da4dc122a4393052285890b2f`，内部 Docker archive SHA-256 `5a7ccda8d50bb902077faa021cf9481631ff9331fc513352fc874a93bffbf5be`；
@@ -68,4 +68,4 @@ Console 对内建 `command + qinglong/command@v1 + argv` 提供“编辑任务

	本地 Local API 为 `64/64`；18-package clean build/test 为 `3,038 total / 3,016 pass / 22 conditional、platform 或 external-service skip / 0 fail`。package boundary 保持 18 packages 且无 single-source/shallow package，Cluster dependency 与 122-module Edge import audit 均 compatible。默认 Edge 为 2,737,205 bytes/329 files/58 modules；opt-in Edge/Standalone Console 为 4,077,890/4,078,034 bytes、473 files、12 packages、95 modules，RSS delta 16,269,312/16,318,464 bytes，均低于既有门。三资产合计 69,723 bytes。真实 Chromium 已完成双 proof 更新到 revision 2，并以 409 模拟断言验证未展示 config/labels 与 lease header 不得丢失；390×844 无横向溢出。	本地 Local API 为 `64/64`；18-package clean build/test 为 `3,038 total / 3,016 pass / 22 conditional、platform 或 external-service skip / 0 fail`。package boundary 保持 18 packages 且无 single-source/shallow package，Cluster dependency 与 122-module Edge import audit 均 compatible。默认 Edge 为 2,737,205 bytes/329 files/58 modules；opt-in Edge/Standalone Console 为 4,077,890/4,078,034 bytes、473 files、12 packages、95 modules，RSS delta 16,269,312/16,318,464 bytes，均低于既有门。三资产合计 69,723 bytes。真实 Chromium 已完成双 proof 更新到 revision 2，并以 409 模拟断言验证未展示 config/labels 与 lease header 不得丢失；390×844 无横向溢出。

	`本 ADR 被合入、远端主 CI 及对应 Profile 门通过前只算源码候选；同源 amd64/arm64 Console Trial Kit 与 milestone index 重新生成并离线验真后，才升级为新的可下载阶段产物。既有 D-421 Console v5 milestone 仍是当前可下载实物，不能改名冒充 D-422。`	本 ADR 已由提交 `f28bf74d1bd29e9b8a8727915de19509f4bda9cf` 的远端主 CI `33236204273`、Kubernetes deployment `33236204254` 与显式 Local Console milestone `33237026187` 闭合。新 run 生成独立的 amd64/arm64 Console Trial Kit 与 milestone index；下载索引通过 `SHA256SUMS` 和仓库离线 auditor，返回 `compatible=true`。因此 D-422 已升级为新的可下载阶段产物；D-421 archive 仅保留为不含 Web 编辑能力的历史实物，没有被改名复用。该结论不把 Alpha 扩大为公开 release、2.x 生产升级或长期支持版本。