feat(ql3): compose cluster copilot diagnosis

docs/QINGLONG_3_0_ARCHITECTURE_RFC.md

@@ -11,6 +11,7 @@
 
 最新增量证据（2026-08-15）：
 
+- D-319/ADR-0411（已接受）：Cluster Copilot failure diagnosis 已在既有 `ql3-cluster-control-ai` 进程内完成默认关闭的 production composition。Prompt 与 Copilot 共享同一个 PostgreSQL AI Pool、Model Gateway、Provider client、恢复扫描、quota/pricing ledger 与 `maxConcurrent` 预算；有界 successful-completion router 只向声明 exact invocation 的 durable sink 分发，不复制 Gateway、连接或隐藏队列。application service 只接受 source Run/request identity，从数据库当前 Run、latest Attempt、Project Tool snapshot、Policy 和 canonical read-only egress config 派生计划，先 admission，再以 durable plan、historical key 与确定性 nonce 修复 admission→Artifact crash window，随后复用 Trusted Tool、Worker Artifact range reader、Model Gateway 及独立的 invocation/result/model-output 三域 keyring。能力保持 caller-driven，不增加 timer、watcher、队列、HTTP/CLI/UI/MCP route 或 Kubernetes API 权限；Kubernetes 独立可选 component 仅投影 config 与三个 0440 keyring。最终 AI 238 pass/3 条件 skip、Cluster Control 240 pass/2 条件 skip、18-package clean build/test 与 backend 1,207 pass/2 条件 skip/0 fail，四项架构审计、14 档 Local artifact 全部通过；workspace 仍为 18 package、无单文件/浅平 package，AI 187 个源码中 186 个、Cluster Control 59 个中 57 个位于嵌套领域目录。默认 Edge/Standalone 保持 2,589,890/2,589,968 bytes，Edge/Standalone AI 为 3,064,454/3,064,544 bytes，证明 Cluster-only composition 未进入小设备闭包。PostgreSQL 18.6 arm64 HA 130/130、timeline `1→2`，报告 SHA-256 为 `981299b454dce5541e9596450b85816dc40559cba8dc42adf3d5fea571c3d3a6`；本 Gate 不改 migration/schema/role/SQL/HA 拓扑。下一 Gate 是 Tool failure、日志 missing/retired/pending、deadline/cancel 与 Model outcome-unknown 的 durable terminalization/recovery，完成前不开放产品入口。
 - D-318/ADR-0410（已接受）：Cluster Copilot diagnosis Model output 获得独立的只读 projected key authority。canonical `qinglong/copilot-failure-diagnosis-output-projected-keyring@v1` manifest 只允许一个 active key 与最多 16 个 historical 32-byte key；每次 `active()`/`resolve()` 都重新执行 Cluster 私有投影文件的 direct-root、根内 atomic symlink、single-link、mode、dev/inode/size/mtime 与双 realpath fence，不使用 cache、watcher、timer 或 Kubernetes API。该 authority 以结构兼容的本地窄端口位于既有 `cluster-control/copilot/failure-diagnosis/`，只通过 `failure-diagnosis-output-keyring` subpath 发布，避免 Cluster Control 默认源码反向依赖 AI；它不复用 Prompt output、Tool invocation/result 或 Provider credential key domain，也不提前声称 Copilot 产品入口已可达。定向回归 13/13、Cluster Control 239 pass/2 条件 skip、backend 1,207 pass/2 条件 skip、18-package clean build/test、四项架构审计与 14 档 Local artifact 全部通过；workspace 仍无单文件/浅平 package，Cluster Control 58 个源码中 56 个位于嵌套领域目录。默认 Edge/Standalone 保持 2,589,890/2,589,968 bytes，Edge/Standalone AI 保持 3,061,009/3,061,099 bytes，证明 Cluster-only subpath 被裁掉。本 Gate 不改 migration/schema/role/SQL/连接/HA 拓扑，因此数据库基线继续引用 ADR-0409 的 PostgreSQL 18.6 arm64 HA 130/130、timeline `1→2`；下一 Gate 是默认关闭的完整 Cluster Copilot composition，随后补齐 Tool failure、日志 missing/retired、Model admission 前 deadline/cancel 与 outcome-unknown 的 durable terminalization/recovery。
 - D-316/ADR-0408（已接受）：Cluster Copilot 现在能够从 ADR-0407 的 durable admission 恢复 exact `qinglong.run.log.excerpt@1.0.0` authority，复用通用 Trusted Tool start barrier、加密 success/failure completion、result catalog/rekey 和内建日志 adapter；确定性 start/completion identity 让 response-loss replay 直接打开既有证据，不重复读取日志或执行 adapter。Cluster invocation Artifact 使用独立 projected keyring，提供 active+historical material，但每次读取均重新执行 canonical path/symlink/mode/inode/realpath fence，且不取得 PostgreSQL Tool result generation authority。只有 exact `succeeded` completion 才能通过 `pg-9019` 的 SERIALIZABLE 事务把 Model Step 从 `pending` 原子推进到 `ready`，同时写 RunEvent、StepRunMutation 和 append-only unlock receipt；`failed|timed_out` 不解锁。本 Gate 不执行模型、不终态化 diagnosis Run，下一 Gate 是 ADR-0405 builder + Model Gateway + Copilot encrypted model completion/terminalization。实现仍为 18 个 package，无单文件/浅平 package；AI 175 个源码中 174 个、Cluster Control 56 个中 54 个位于嵌套目录，不新增依赖、进程、连接、timer/watcher/cache 或默认 Edge 成本。18-package clean build/test 全绿，AI 229 pass/3 条件 skip、backend 1,207 pass/2 条件 skip，四项架构审计零 finding；14 档 Local artifact 全通过，默认 Edge/Standalone 为 2,589,890/2,589,968 bytes。PostgreSQL 18.4 arm64 HA 130/130、timeline `1→2`，首次执行只读两次日志、密文不含敏感 fixture，提升后 exact replay 零日志读取；报告 SHA-256 为 `d525a303696e178d777b021b376729bd2c5382fb5eb7bc98466a2b79d3940517`，独立审计与 Docker 清理通过。
 - D-317/ADR-0409（已接受）：已解锁的 Cluster failure-diagnosis Model Step 现在从 durable encrypted Tool completion 重开受信日志投影，经 ADR-0405 builder 和既有 Model Gateway 执行；只有显式安装的 Copilot success sink 可以接管成功返回。Copilot `GenerateResult` 使用独立 AES-256-GCM Artifact，绑定 plan、Tool completion、egress evidence 与 Model identity，公开 reference、ModelInvocation completion、RunEvent 和审计均不含明文。通用 `DurableModelInvocationCoordinator` 已改为领域无关的 `ModelInvocationAtomicSuccess<TReference>`，消除对 Plugin Prompt Artifact 的反向依赖；Plugin Prompt 通过 adapter 保持兼容。`pg-9020` 在一个 SERIALIZABLE 事务中原子提交 ciphertext、Model completion、StepRun/Event 与 usage/pricing/quota settlement，再由可重放 finalization 事务把 diagnosis Run 推进为 `succeeded|failed|timed_out`；两事务间崩溃只补 finalization，existing start/completion/finalization replay 均不重复调用 Provider。当前仍不自动终态化 Tool failure、日志 missing/retired、Model admission 前 deadline/cancel，也不把 `outcome_unknown` 冒充失败；Cluster 专用 output projected keyring 与产品 composition 完成前该入口保持不可达。实现仍在既有 18 个 package 的嵌套领域目录内，不新增进程、队列、timer/watcher/cache 或默认 Edge 成本。最终 AI 233 pass/3 条件 skip、18-package clean build/test 与 backend 1,207 pass/2 条件 skip/0 fail，四项架构审计零 finding；workspace 无单文件或浅平 package，AI 183 个源码中 182 个位于嵌套目录。14 档 Local Profile artifact 全部通过，默认 Edge/Standalone 为 2,589,890/2,589,968 bytes，Edge/Standalone AI 为 3,061,009/3,061,099 bytes。PostgreSQL 18.6 arm64 HA 130/130、timeline `1→2`，报告 SHA-256 为 `8401634f30635b45bfb583b02e94ac41f023bf8a0bdbcfd9744ebf459ab0d8f8`，独立证据审计与 Docker 零残留。

docs/adr/ADR-0411-default-off-cluster-copilot-composition.md

@@ -0,0 +1,83 @@
+# ADR-0411：默认关闭的 Cluster Copilot Failure Diagnosis Composition
+
+- 状态：Accepted
+- 日期：2026-08-15
+- 关联 RFC：QL-RFC-0001 D-319、Phase 2
+- 关联 ADR：ADR-0407、ADR-0408、ADR-0409、ADR-0410
+
+## 问题
+
+ADR-0407 至 ADR-0410 已分别建立 diagnosis admission、Trusted Tool execution、Model execution
+和独立 output key authority，但它们仍只在测试与 HA ceremony 中手工组装。若直接再启动一套 Model
+Gateway，会为每个 replica 复制 PostgreSQL Pool、Provider client、恢复扫描和并发预算；这对小型集群
+不合理，也会让 Prompt 与 Copilot 绕过同一模型出口限额。若直接开放 HTTP route，则 Tool failure、日志
+missing/retired、Model admission 前取消以及 outcome-unknown 尚未终态化，产品会暴露无法收敛的 Run。
+
+## 决策
+
+1. Copilot 只在既有显式 `ql3-cluster-control-ai` 进程中装配，并由独立
+   `QL3_CLUSTER_AI_COPILOT_ENABLED=true` 开关启用。默认 Cluster、Edge、Standalone 和仅 Prompt 的
+   Cluster AI 均不读取 Copilot 配置、keyring 或 Artifact authority。
+2. Prompt 与 Copilot 共享一个 PostgreSQL runtime Pool、一个 Model Gateway、同一 Provider authority、
+   recovery pass、pricing/quota ledger 和 `maxConcurrent` 预算。新增有界 successful-completion router，
+   只把一次已开始的 invocation 交给声明该 invocation 的 durable sink；不得复制 Gateway 或隐藏队列。
+3. Copilot Model execution 依赖 `generate()` 与 `supportsSuccessfulCompletionSink()` 的窄结构端口，不依赖
+   `BoundedModelGateway` 具体类，使 production Profile 的 drain/active-operation capability 可以直接注入，
+   同时保留 exact sink identity 检查。
+4. Cluster Copilot application service 从当前 PostgreSQL Run、latest Attempt、Project Tool snapshot 和
+   Policy 派生计划；调用者不能提供 Attempt、Artifact、Tool binding、Policy fence、key ID、nonce、
+   `plannedAtMs` 或内部 Run/Step/ModelInvocation identity。模型与 egress policy 来自部署者的 canonical
+   read-only配置，而不是请求体。
+5. diagnosis admission 先持久化 exact plan/Run/Step ledger，再物化可重建的加密 Tool invocation Artifact。
+   replay 使用 durable plan、historical invocation key 和域分离确定性 nonce 修复 admission→Artifact
+   crash window；只有 Artifact exact replay 成功后才允许 Tool execution。密钥副本使用后必须清零。
+6. Tool execution 复用同一 PostgreSQL repository、current snapshot、Project Policy 与 Worker Artifact
+   range reader；Model execution复用同一 Gateway，并由 ADR-0410 output keyring 原子落盘 ciphertext。
+   invocation、Tool result 与 Model output keyring 继续是三个不可互换的域。
+7. composition 能力在进程内保持 caller-driven、无 timer、watcher、队列或后台扫描。当前 Gate 不注册
+   HTTP/CLI/UI/MCP route；只有下一 Gate 完成所有非成功路径的 durable terminalization/recovery 后，
+   才能把该能力接入认证产品面。
+8. Kubernetes 以独立可选 component 投影 canonical Copilot 配置和三个 read-only keyring；它必须与
+   `cluster-ai` 以及可读 Worker Artifact storage 一起使用，不新增 Pod、ServiceAccount 权限或 sidecar。
+
+## 被否决方案
+
+1. **为 Copilot 再启动 Gateway/Pool**：资源翻倍并拆散全局并发、quota 和 Provider 出口约束。
+2. **让 Gateway 依赖具体业务 sink**：把通用模型边界反向耦合到 Prompt/Copilot 产品域。
+3. **由请求提交完整执行计划**：把 source fence、Tool binding、egress policy 和内部 identity 交给不可信边界。
+4. **先开放 route、以后补失败收敛**：会产生用户可见但永久 running/pending 的 diagnosis Run。
+5. **把三个 keyring 合并**：轮换、退役与泄漏半径跨越 Tool 输入、Tool 输出和模型输出域。
+6. **新增 workspace package**：composition 没有独立进程或依赖闭包，薄包会恶化已有 package 粒度。
+
+## 验证标准
+
+1. completion router 证明 Prompt/Copilot 精确分发、未知 invocation 不落盘、重复/扩展 sink 拒绝。
+2. 默认关闭时不读取 Copilot config、keyring、Worker Artifact 或新增 PostgreSQL authority。
+3. composition 测试覆盖 server-derived source/snapshot/Policy、admission→Artifact crash repair、Tool→Model
+   成功链、exact replay、key rotation、配置/authority 缺失和有序 drain。
+4. AI、Cluster Control、18-package clean build/test、backend、四项架构审计和 14 档 Local artifact 全通过。
+5. PostgreSQL 组合证据覆盖真实 repository 上的 admission、Tool completion、Model ciphertext、finalization
+   与 exact replay；本 Gate 不新增 migration、schema、role 或 SQL privilege。
+
+## 当前验证
+
+1. successful-completion router 与 Cluster Copilot application/composition 定向测试全部通过；AI 完整测试
+   238 pass/3 条件 skip，Cluster Control 完整测试 240 pass/2 条件 skip。
+2. 18-package clean build/test 全部通过；backend 1,207 pass/2 条件 skip/0 fail。package boundary、
+   dependency、Edge import 与 Cluster deployment 四项审计均为 compatible、零 finding。
+3. workspace 仍为 18 个 package，无 single-source 或 shallow-source package；AI 187 个源码中 186 个、
+   Cluster Control 59 个源码中 57 个位于嵌套领域目录。新增 composition 没有制造薄 package 或根层平铺。
+4. 14 档 Local Profile artifact 全部通过。默认 Edge/Standalone 保持
+   2,589,890/2,589,968 bytes；Edge/Standalone AI 为 3,064,454/3,064,544 bytes，均未引入 Cluster-only
+   composition，且分别保有 1,604,414/1,604,336 与 2,178,426/2,178,336 bytes 体积余量。
+5. PostgreSQL 18.6 arm64 HA 130/130、timeline `1→2`，报告 SHA-256 为
+   `981299b454dce5541e9596450b85816dc40559cba8dc42adf3d5fea571c3d3a6`。本 Gate 不新增
+   migration、schema、role、SQL privilege 或 HA 拓扑；真实 repository 的 admission、Tool completion、
+   Model ciphertext、finalization 与 exact replay 沿用同一受审 authority，Docker 门禁与清理均通过。
+
+## 后续门禁
+
+1. 为 Tool `failed|timed_out`、日志 `missing|retired|pending`、deadline/cancel 和 Model
+   `outcome_unknown` 建立有界 durable terminalization/recovery。
+2. 完成后再增加经 authentication、Policy、audit、request identity 和 source fence 保护的 Cluster API，
+   随后复用该 capability 提供 CLI/UI/MCP，而不是建立旁路执行器。

docs/adr/README.md

@@ -414,6 +414,7 @@
 | [ADR-0408](./ADR-0408-cluster-copilot-failure-diagnosis-tool-execution.md)                         | Cluster Copilot Failure Diagnosis Tool Execution 与原子 Model 解锁                                                                                    | Accepted |
 | [ADR-0409](./ADR-0409-cluster-copilot-failure-diagnosis-model-execution.md)                        | Cluster Copilot Failure Diagnosis Model Execution、密文输出与 Run 终态化                                                                               | Accepted |
 | [ADR-0410](./ADR-0410-cluster-copilot-failure-diagnosis-output-key-authority.md)                   | Cluster Copilot Failure Diagnosis Output Projected Key Authority                                                                                        | Accepted |
+| [ADR-0411](./ADR-0411-default-off-cluster-copilot-composition.md)                                  | 默认关闭的 Cluster Copilot Failure Diagnosis Composition                                                                                                  | Accepted |
 
 ## 规则