feat(ql3): add read-only cluster context readiness

docs/QINGLONG_3_0_ARCHITECTURE_RFC.md

@@ -11,6 +11,19 @@
 
 最新增量证据（2026-08-13）：
 
+- D-303/ADR-0391（已接受）
+  Cluster operator context 在离线 `validate` 之后增加显式、只读的 `ql3-cluster-admin context probe`。probe 先完整预检全部
+  context entry，任何晚出现的配置错误都会在首个网络请求前失败关闭；随后才按固定 catalog 顺序，以 production TLS 1.3、CA、
+  servername、mTLS client certificate 或 Kubernetes PortForward 配置逐项 `GET /readyz`。探针不读取 command/assertion，不发送
+  Authorization、body 或业务 management POST，不重试、不切换 Pod，响应限 1 KiB，只接受精确 `200/ready` 或 `503/not_ready`。
+  输出仅含 command、transport、ready 状态及 `mutation:false`；配置错误退出 78，不可达/协议错误或任一 not-ready 退出 69。
+  TLS preparation 与六类 management route/client-certificate policy 收敛为一个 package-private 真源，既有 mutation client 的公开
+  subpath 与请求语义不变。能力仍只存在于短生命周期 Cluster Admin，不新增 package、依赖、binary、listener、timer、controller、
+  workload 或 sidecar；Local/Edge、Cluster Control 与 Worker 零导入。Cluster Admin 完整 302 pass/2 条件 skip，18-package clean
+  build/test 退出 0，backend 1,188 pass/2 skip；五项边界审计零 finding。真实 arm64 Admin image 为 330,487,296 bytes，并在
+  `10001:10001`、network none、read-only root、drop ALL、128 MiB/32 PIDs 下完成本地 TLS readiness 契约。14 个 Local Profile
+  artifact 与 D-302 对应字节数一致；PostgreSQL 18.4 arm64 HA 123 项 gate 全绿、timeline `1→2`，证据 SHA-256 为
+  `e7c1743e932f2d7c35dc9153cdf5bc4a03356a38d93fce5507354652aa207a05`，独立审计与 Docker 清理通过。完整验证证据见 ADR-0391。
 - D-302/ADR-0390（已接受）
   Cluster operator context 增加无网络、无 mutation 的内建 `ql3-cluster-admin context validate` 预检。它先复用 owner-private context
   reader，再让每个 entry 经过与真实请求相同的 production HTTPS/Kubernetes configuration preparation，验证精确 route、hostname、CA、

docs/adr/ADR-0391-read-only-cluster-operator-context-readiness.md

@@ -0,0 +1,53 @@
+# ADR-0391：Read-only Cluster Operator Context Readiness
+
+- 状态：Accepted
+- 日期：2026-08-13
+- 关联 RFC：QL-RFC-0001 D-303
+- 前置决策：ADR-0247、ADR-0250、ADR-0388、ADR-0389、ADR-0390
+
+## 上下文
+
+ADR-0390 的 `context validate` 能在完全离线状态证明 context、TLS、mTLS 与 Kubernetes 配置可解析，但不能证明发布窗口中的目标进程已就绪、证书链仍被线上端点接受或 Kubernetes tunnel 可建立。用任一 management POST 试探会读取短生命周期 assertion 和 command，并可能进入认证、审计、quota 或 mutation 路径；在工作站另写 curl/kubectl 流程则会绕过生产 client 的 hostname、TLS 1.3、mTLS 与 PortForward 约束。
+
+## 决策
+
+1. 在既有 Cluster Admin facade 内增加 `context probe --context=/absolute/operator-context.json`。它不是第八个远程业务命令，不新增 binary、package、依赖、常驻进程或部署 authority。
+2. probe 必须先调用完整离线 `context validate`。所有 entry 均通过后才能产生第一个网络请求，避免前项已访问而后项配置错误的部分探测。
+3. 每项只使用与 production client 相同的 config preparation、CA、servername、TLS 1.3 和 mTLS client certificate。Kubernetes 项复用受审 kubeconfig preparation、单个 ready Pod 选择与 PortForward tunnel；不得读取 ambient kubeconfig。
+4. 唯一请求为 `GET /readyz`，无 Authorization、Content-Type 或 body。它不读取 command/assertion，不调用 management route，不查询数据库，不产生 mutation，不重试，也不在连接失败后切换 Pod。
+5. 响应硬限 1 KiB、identity encoding、精确 JSON content type/schema；只接受 `200 {schemaVersion:1,status:"ready"}` 或 `503 {schemaVersion:1,status:"not_ready"}`，拒绝 redirect、额外字段、重复/错误长度、压缩、畸形 UTF-8/JSON 和其他状态。
+6. 输出只包含固定 command 名、`https|kubernetes-port-forward`、`ready|not_ready`、固定 method/path 与 `mutation:false`。不得输出 endpoint、port、namespace、Pod、路径、证书主体或错误对象。全部 ready 退出 0；任一 not-ready、连接或协议失败退出 69；离线配置错误仍退出 78；语法错误退出 64。
+7. management route 与 client-certificate class 只有一个 package-private policy 真源。配置 preparation 和 readiness 实现不从 package manifest 导出；既有公开 client subpath、POST 语义、错误码与调用方保持不变。
+8. 能力只存在于短生命周期 Cluster Admin image。Local/Edge、Cluster Control、Worker 的依赖闭包、文件、RSS、listener、timer、数据库与制品不得变化。
+
+## 不采用方案
+
+- **直接执行一条 inspect 命令**：仍需 assertion/command，会留下认证或审计事实，且把 readiness 与业务授权混为一体。
+- **通用 URL/方法探针**：扩大 SSRF 与 authority 面，无法约束到受审 endpoint 和固定路径。
+- **自动重试或多 Pod failover**：隐藏单次现场状态、增加窗口时间，并把短生命周期诊断工具变成控制器。
+- **把 probe 放进 Cluster Control 或 sidecar**：会给常驻运行时增加网络、定时器和依赖成本，低配 Local/Edge 也没有该需求。
+- **为 readiness 新建 package**：只有 Cluster Admin 一个制品消费者，拆包会复制 manifest、发布和供应链表面。
+
+## 操作顺序
+
+1. `ql3-cluster-admin context validate --context=/absolute/operator-context.json`
+2. `ql3-cluster-admin context probe --context=/absolute/operator-context.json`
+3. 只有前两步符合维护计划，操作者才另行提供精确 command 与短生命周期 assertion 执行业务命令。
+
+probe 不是持续监控、负载均衡健康检查或 mutation 成功保证；退出 0 只表示这一时刻全部受审 readiness 端点返回 ready。
+
+## 验收门
+
+- 无证书 TLS 与 mTLS 真实握手、ready/not-ready、不可达、redirect、畸形与超限响应；
+- Kubernetes 单 Pod tunnel、连接丢失时无重试/切换，以及低敏错误映射；
+- context 全量离线先验、固定顺序、无 command/assertion/Authorization/body 与输出 secret scan；
+- 真实 Admin image 在 non-root、read-only root、network none 容器内启动本地 TLS fixture，证明固定 GET 契约及资源上限；
+- Cluster Admin、18-package clean build/test、backend、package/dependency/deployment/image/Local image、14 Local Profile artifact 与 PostgreSQL HA 全量不回归。
+
+## 当前证据
+
+- readiness/TLS/mTLS/Kubernetes tunnel、context product 与 release 定向契约 93/93。Cluster Admin 完整 304 tests、302 pass/2 条外部服务条件 skip/0 fail；18-package clean build/test 退出 0；backend 1,190 tests、1,188 pass/2 skip/0 fail。
+- workspace 保持 18 package；Cluster Admin 99 source 中 98 nested/1 个既有 root binary，无 single-source/shallow package且未增加依赖或公开 subpath。package/dependency/deployment/image release/Local image 五项边界审计均 compatible、零 finding。
+- 当前源码真实 arm64 Admin image 为 330,487,296 bytes，较 D-302 增加 23,768 bytes；在 `10001:10001`、read-only root、network none、drop ALL、no-new-privileges、0.25 CPU、128 MiB/32 PIDs 下启动同容器 loopback TLS fixture，报告 `contextReadiness=true`，并证明精确 `GET /readyz`、无 Authorization、0-byte body。
+- 14 个 Local Profile artifact 全部 compatible 且与 D-302 字节数一致：最小 Edge 为 2,467,343 bytes/295 files/53 modules，最大 Standalone MCP 为 7,168,978 bytes/778 files/213 modules，证明 Router/Edge 闭包零增量。
+- PostgreSQL 18.4 arm64 HA 123 项 gate 全绿，timeline `1→2`；私有报告 SHA-256 为 `e7c1743e932f2d7c35dc9153cdf5bc4a03356a38d93fce5507354652aa207a05`，独立 evidence audit `compatible=true`、零 finding，测试容器、网络与卷均零残留。

docs/adr/README.md

@@ -394,6 +394,7 @@
 | [ADR-0388](./ADR-0388-bounded-unified-cluster-product-cli.md)                                                  | 有界统一 Cluster Operator 产品 CLI                                                                                                  | Accepted |
 | [ADR-0389](./ADR-0389-owner-private-cluster-operator-context.md)                                               | Owner-private Cluster Operator Context                                                                                               | Accepted |
 | [ADR-0390](./ADR-0390-offline-cluster-operator-context-preflight.md)                                          | Offline Cluster Operator Context Preflight                                                                                           | Accepted |
+| [ADR-0391](./ADR-0391-read-only-cluster-operator-context-readiness.md)                                        | Read-only Cluster Operator Context Readiness                                                                                         | Accepted |
 
 ## 规则
 

docs/operations/ql3-cluster-operator-context.md

@@ -0,0 +1,21 @@
+# QingLong 3.0 Cluster Operator Context
+
+Cluster operator context 只为短生命周期 `ql3-cluster-admin` 复用受审 client 与 Kubernetes 配置路径。它不是 credential store，不得包含 assertion、command、token、private key、endpoint 内容或默认业务操作；context 及引用的私有文件必须是 absolute、canonical、当前 UID 所有、非 symlink 的 `0600` regular file。
+
+维护窗口按固定顺序执行：
+
+```sh
+ql3-cluster-admin context validate \
+  --context=/secure/qinglong3/operator-context.json
+
+ql3-cluster-admin context probe \
+  --context=/secure/qinglong3/operator-context.json
+```
+
+`validate` 完全离线，验证所有 context entry、TLS/mTLS 与 Kubernetes 配置，不建立连接。`probe` 会再次先完成全量离线验证，然后按固定 catalog 顺序使用 production TLS 1.3 或 Kubernetes PortForward 发送无 Authorization、无 body 的 `GET /readyz`；它不会执行 management POST、读取 assertion/command、重试或切换 Pod。
+
+- `validate` 成功退出 0；配置错误输出低敏 `QL3_CLUSTER_PRODUCT_CONTEXT_INVALID` 并退出 78。
+- `probe` 全部 ready 退出 0；明确 not-ready、不可达或响应协议错误退出 69。not-ready 会输出各 command 的低敏状态；连接/协议失败只输出 `QL3_CLUSTER_PRODUCT_CONTEXT_PROBE_FAILED`。
+- 退出 0 只证明探测时刻 readiness，不代表后续 mutation 一定成功。业务命令仍需单独、显式提供精确 command 与短生命周期 assertion。
+
+不要把 probe 放进 cron、sidecar、router/Edge Profile 或 Cluster Control。持续监控应使用独立、最小权限的可观测性面；该命令保留为人工发布/维护窗口的有界诊断工具。