@sema-agent/server 7.132.0 → 7.134.0

package/deploy/sema-up/README.md

@@ -62,7 +62,7 @@ summary 会打印手动接法。
 | `--gateway=URL` | — | 模型网关 baseURL(OpenAI 兼容);带 agent 的档必需 |
 | `--model=ID` | `deepseek-v4-flash` | 模型 id |
 | `--model-key=K` | — | 模型 API key(也可 -f 里 MODEL_API_KEY) |
-| `--sandbox=LANE` | single→`host`;multi→`e2b-cloud` | `host`/`e2b-cloud`(full-single / local-plus)。**执行车道**=agent 的手落在哪里,不点名就是没有手;词表与必需键的单一属主=`lib/lanes.json`。`kata`/`runc`/`e2b-self` 已退役(compose 路径对它们零接线),收到即非零退出并指路。kube 路径(full-cluster)**不选词**:runtime 按 runtimeClass `kata-qemu` 在不在自动定,车道恒 `REMOTE_EXEC=k8s` |
+| `--sandbox=LANE` | 按 `--users` 取表缺省(见下「执行车道」) | **执行车道**=agent 的手落在哪里,不点名就是没有手。词表、缺省、各车道运维自备的键、已退役的词都在下面「执行车道」一节(由车道表生成,单一属主=`lib/lanes.json`)。kube 路径(full-cluster)**不选词**:runtime 按 runtimeClass `kata-qemu` 在不在自动定 |
 | `--registry=true\|false` | `true`(local-plus `false`) | 配置中心网站开关;**只收 `true` / `false`**(`yes` / `1` / `on` 在建任何目录之前拒 —— 7.104.0 之前它们被静默当成关) |
 | `--registry-image=REF` | — | sema-registry 镜像(registry=true 必需) |
 | `--git=MODE` | `none` | `none`/`provision`/`connect` |
@@ -78,6 +78,24 @@ summary 会打印手动接法。
 | `--teardown` / `--teardown-volumes` | — | 卸载(留数据 / 连卷删) |
 | `--skip-preflight` | — | 跳过预检(不建议) |
 
+### 执行车道(`--sandbox`)
+
+<!-- @generated-begin sandbox-lanes -->
+本节由车道表 `lib/lanes.json` 生成(仓内门禁保证与表逐字一致),不要手改。
+
+**执行车道**=agent 的手落在哪里,不点名就是没有手。`--sandbox` 只在 compose 路径(full-single / local-plus)选词;kube 路径(full-cluster)**不选词**。不点名时按 `--users` 取表里第一条允许该租户形的词:`--users=single` → `host`;`--users=multi` → `e2b-cloud`。
+
+- **`host`**(compose 路径) — 可选 `--users`:`single`;落盘 `REMOTE_EXEC=host`;运维自备的键:无;隔离:`unsupported`。server 容器本身就是沙箱:agent 的手落在这只容器里(worktree 隔离在、OS 级隔离不在)。只给单用户 —— 多租户下一个租户的输入会把手指向另一个租户的文件与进程。
+- **`e2b-cloud`**(compose 路径) — 可选 `--users`:`single` / `multi`;落盘 `REMOTE_EXEC=e2b`;运维自备的键:`E2B_API_KEY`;隔离:`supported`。E2B 云沙箱:每任务一只 microVM。E2B_API_KEY 由运维自备(sema-up 只登记键名,绝不写值)。
+- **kube 路径(不选词)** — 可选 `--users`:`single` / `multi`;落盘 `REMOTE_EXEC=k8s`;运维自备的键:`K8S_SANDBOX_IMAGE`;隔离:`supported`。kube 路径**不选词**:runtime 由 kube-up.sh 按 runtimeClass `kata-qemu` 在不在自动定(在 ⇒ kata VM,不在 ⇒ runc 容器),沙箱镜像由 chart/清单给。本行只为对表(能力表 / 必需键 / REQUIRE_EXECUTION_LANE 三面),不进 --sandbox 词表。
+
+已退役的词(收到即非零退出并指路):
+
+- **`kata`** — 已退役。compose 路径对 kata 零接线:选了它 .env 里不会出现任何 REMOTE_EXEC,core 落 StubExecutionEnv ⇒ 起来的 worker 一只手都没有。有 KVM 的机器上它还曾是默认值,所以这是最贵的一个死词。 改用:要 VM 级隔离走 kube 路径:sema-up.sh --profile=full-cluster(runtimeClass kata-qemu 在场即自动用 kata,不在场退 runc);留在单机 compose 上就选 host 或 e2b-cloud。
+- **`runc`** — 已退役。同 kata:compose 路径对它零接线,选了等于没选车道(无手)。 改用:单机 compose 上「容器隔离」的真形就是 host(server 容器自己);要独立沙箱容器走 kube 路径 --profile=full-cluster。
+- **`e2b-self`** — 已退役。自托管 E2B 端点从未接线:它只在 preflight 文案与 machines.yaml 模板里出现过,没有任何一处把它翻成 REMOTE_EXEC。 改用:先用 e2b-cloud(填 E2B_API_KEY);自托管端点的接线尚未排期。
+<!-- @generated-end sandbox-lanes -->
+
 ### 取值旗的形(7.104.0)
 
 一条规则:**每只取值旗都过形判**,不合 ⇒ 在建任何目录、写任何文件之前非零退出,拒句点名旗、收到的值、合法形。
@@ -136,6 +154,22 @@ data-center:2c/2G/20G)以下 BLOCK——确实无法稳定部署,提前警告不
 - **MinIO**:钉死的 tag(`minio/minio:RELEASE.…`,chart / cluster 静态清单 / compose 三份同值;k8s `imagePullPolicy: IfNotPresent`,不再 `:latest` + `Always`)。换源 = 换整条引用:
   compose 与 kube-up 读环境变量 `MINIO_IMAGE`(kube-up 给了才递给 chart),chart 直接 `--set minio.image=<源>/minio/minio:<tag>`(预灌镜像的节点 `--set minio.pullPolicy=Never`)。
 
+## 停驻钥匙的持久卷(helm 图表的 `sealedKey` 块)
+
+server 的 `<数据根>/sealed-key/` 存着停驻任务续跑上下文里请求凭据的封签钥匙(子目录 `checkpoint-ctx-keys/`)和模型钥匙 —— 私钥只在这个目录里、不进库。
+图表(`kube-up.sh` 的 `--kube=existing|k3s`、`cluster-up.sh` 的 `STACK_ENGINE=helm`)缺省把整个目录挂成一只 PVC(`sealedKey.persistence.enabled: true`),
+容器内路径 `/root/.ai-agent/sealed-key`,主 worker 与启用的 `serverV4pro` 共用:重启与换副本都不丢钥匙,停驻的任务照常续跑。
+
+- **访问模式缺省随共享这只卷的 pod 数**:`server.replicas`(加上启用的 `serverV4pro.replicas`)为 1 ⇒ `ReadWriteOnce`,多于 1 ⇒ `ReadWriteMany`,**要集群的存储类支持 RWX**
+  (Longhorn 走 NFS 共享管理器、每个节点要装 NFS 客户端;`local-path` 与多数云盘类不支持 ⇒ PVC 一直 Pending、server Pod 起不来)。点名存储类:`--set sealedKey.persistence.storageClass=<支持 RWX 的类>`。
+  单节点多副本(pod 都在同一个节点)用 `--set sealedKey.persistence.accessMode=ReadWriteOnce` 显式盖(随包的 `values-full-single.yaml` 就这么写)。
+  有效访问模式是 `ReadWriteOnce` 时 Deployment 用 `Recreate`(RWO 卷同时只能被一个节点挂,滚动更新的新 Pod 落在别的节点就永远等不到卷;代价是升级窗口内短暂没有副本)。
+- **没有 RWX 的集群**:`--set server.replicas=1`,或单节点多副本盖 RWO(上一条),或关持久 `--set sealedKey.persistence.enabled=false` —— 关掉时图表**显式**给每只 worker 设 `DURABLE_APPROVAL=false`
+  (耐久审批整条关,不产生续不了的停驻行;`helm install` 打印的安装说明里也有这一句),且同时配 `server.durableApproval=true` 渲染即拒。
+- **首装是空卷**:多个 pod 并发首启会各自生成一把钥匙、各持自己那一把;装好后 `kubectl -n <ns> rollout restart deploy/sema-server`(启用 `serverV4pro` 时再加 `deploy/sema-server-v4pro`)一次,之后每个 pod 读到全部钥匙。
+- PVC 的 `accessModes` 建好后不可改:副本数跨过 1 的边界时 `helm upgrade` 会撞「spec is immutable」;卷里是私钥,换卷前先结掉停驻行或备份钥匙文件。
+  PVC 带 `helm.sh/resource-policy: keep`:`helm uninstall` 与把 `enabled` 改成 `false` 的 upgrade 都不删它(确认不要了再 `kubectl -n <ns> delete pvc sema-server-sealed-key`)。
+
 ## 凭据纪律
 
 全部凭据生成一次、落 `~/.sema-up/<project>/.env`(0600),重跑**绝不轮换**;

package/deploy/sema-up/chart/Chart.yaml

@@ -7,5 +7,5 @@ description: >-
   SC、kata-deploy(runtimeclass)、CNPG operator、runner-token 跨 ns 复制、MinIO 建桶、
   imagePullSecret(sema-regcred)。
 type: application
-version: 0.3.0
+version: 0.4.0
 appVersion: "1.156.1"

package/deploy/sema-up/chart/templates/NOTES.txt

@@ -0,0 +1,15 @@
+{{- $persist := eq (include "sema.sealedKey.enabled" .) "true" }}
+{{- if $persist }}
+停驻封签钥匙:server 的 <数据根>/sealed-key/ 在持久卷 {{ include "sema.sealedKey.claimName" . }}(挂在容器内 {{ include "sema.sealedKey.mountPath" . }},{{ include "sema.sealedKey.accessMode" . }}),重启与换副本都不丢钥匙,停驻的任务照常续跑。PVC 带 helm.sh/resource-policy: keep(helm uninstall 与把 sealedKey.persistence.enabled 改成 false 的 upgrade 都不删它)。
+{{- if eq (include "sema.sealedKey.accessMode" .) "ReadWriteOnce" }}
+有效访问模式是 ReadWriteOnce,server / serverV4pro 的 Deployment 用 Recreate 更新策略(RWO 卷同时只能被一个节点挂,滚动更新的新 Pod 落在别的节点会一直等不到卷;代价是升级窗口内短暂没有副本)。
+{{- end }}
+{{- if eq (include "sema.sealedKey.accessMode" .) "ReadWriteMany" }}
+多个 pod 共用这只卷,存储类必须支持 ReadWriteMany(PVC 一直 Pending 就是它不支持:出路 server.replicas=1,或 sealedKey.persistence.enabled=false 并接受耐久审批随之关)。
+{{- end }}
+{{- if gt (int (include "sema.sealedKey.podCount" .)) 1 }}
+首装是空卷:多个副本并发首启会各自生成一把钥匙、各持自己那一把 —— 装好后执行一次 kubectl -n {{ .Release.Namespace }} rollout restart deploy/sema-server{{ if .Values.serverV4pro.enabled }} deploy/sema-server-v4pro{{ end }},此后每个副本读到目录里的全部钥匙。
+{{- end }}
+{{- else }}
+停驻封签钥匙:sealedKey.persistence.enabled=false —— 不建卷,图表已给每只 worker 显式设上 DURABLE_APPROVAL=false(耐久审批整条关,不产生续不了的停驻行;代价见 values.yaml 的 sealedKey 块;要重新打开,把它改回 true)。关持久 + 提交体没声明 settings.approvalFrameFamilies 的客户端 ⇒ 受门工具当场拒(没有耐久店,无处停驻;7.134.0 起审批卡只发给声明认得这一族的客户端)。
+{{- end }}

package/deploy/sema-up/chart/templates/_helpers.tpl

@@ -0,0 +1,129 @@
+{{- /*
+  sealedKey 持久块的助手 —— 卷名 / 挂载路径 / 共享 pod 数 / 访问模式 / 耐久审批的渲值,各一处定义,主 worker(server.yaml)与
+  v4pro 变体(server-v4pro.yaml)同调,不各抄一份。
+
+  这是什么:server 的数据根下 `sealed-key/` 目录存两样东西 —— 模型钥匙(web-admin 贴的 `sealedApiKey` 的解封私钥)与停驻任务续跑上下文里
+  请求凭据的封签钥匙(子目录 `checkpoint-ctx-keys/`)。私钥只在这个目录里(不进库),所以它要**跨重启持久**、**每个副本是同一份**:
+  不持久 ⇒ 每次重启换钥匙,重启前停驻、带请求凭据的任务续跑恒 409 conflict.checkpoint_ctx_unsealable(reason key_not_held);
+  多副本各一份 ⇒ A 副本停驻的任务在 B 副本上同一个结局。
+
+  路径:镜像以 root 跑、本图表不设 LOCAL_DATA_ROOT / CONFIG_LOCAL_DIR / AGENT_DATA_DIR ⇒ 数据根是缺省 ~/.ai-agent = /root/.ai-agent。
+  给部署另设了数据根变量的人:挂载路径要跟着移(本图表不替部署设这几个变量)。
+*/ -}}
+
+{{- /* 卷 / PVC 的名字。 */ -}}
+{{- define "sema.sealedKey.claimName" -}}sema-server-sealed-key{{- end -}}
+
+{{- /* 容器内挂载点 = <数据根>/sealed-key(整个目录:模型钥匙 + checkpoint-ctx-keys/ 同一卷)。 */ -}}
+{{- define "sema.sealedKey.mountPath" -}}/root/.ai-agent/sealed-key{{- end -}}
+
+{{- /*
+  持久开关,且**只收布尔**:`--set-string ...enabled=false` / values 里带引号的 "false" 是字符串,模板里字符串恒为真 ⇒ 会静默保持持久开,
+  与写的人的意思相反,所以非布尔渲染即拒。输出 "true" / "false"。
+*/ -}}
+{{- define "sema.sealedKey.enabled" -}}
+{{- $v := .Values.sealedKey.persistence.enabled -}}
+{{- if not (kindIs "bool" $v) -}}
+{{- fail (printf "sealedKey.persistence.enabled must be a boolean (true or false), got %s %q — a string such as \"false\" is truthy in a template and would silently keep the volume on" (kindOf $v) (toString $v)) -}}
+{{- end -}}
+{{- $v -}}
+{{- end -}}
+
+{{- /* 一只 Deployment 的副本数:缺省(null,k8s 按 1 只起)不当 0 只数;其余按整数。 */ -}}
+{{- define "sema.sealedKey.replicasOf" -}}
+{{- if kindIs "invalid" . -}}1{{- else -}}{{- int . -}}{{- end -}}
+{{- end -}}
+
+{{- /* 共享这只卷的 pod 数:主 worker 的副本数 + 启用的 v4pro 变体的副本数(两者读同一个库里的停驻行,所以挂同一只卷)。 */ -}}
+{{- define "sema.sealedKey.podCount" -}}
+{{- $n := int (include "sema.sealedKey.replicasOf" .Values.server.replicas) -}}
+{{- if .Values.serverV4pro.enabled -}}
+{{- $n = add $n (int (include "sema.sealedKey.replicasOf" .Values.serverV4pro.replicas)) -}}
+{{- end -}}
+{{- $n -}}
+{{- end -}}
+
+{{- /*
+  访问模式:`sealedKey.persistence.accessMode` 留空 = 随共享 pod 数派生(一只 ReadWriteOnce,多只 ReadWriteMany —— 要集群的存储类支持 RWX,见 values.yaml sealedKey 块);
+  写了 ReadWriteOnce / ReadWriteMany = 显式盖。显式盖的用处:单节点、多副本 —— 所有 pod 在同一个节点上,RWO 就够,不必为它给节点装 NFS 客户端;
+  盖成 RWO 而 pod 其实会落在不同节点是写的人的前提(新 Pod 会卡在「卷被别的节点挂着」)。其它词渲染即拒。
+*/ -}}
+{{- define "sema.sealedKey.accessMode" -}}
+{{- $raw := .Values.sealedKey.persistence.accessMode -}}
+{{- $m := "" -}}
+{{- if not (kindIs "invalid" $raw) -}}
+{{- $m = toString $raw -}}
+{{- end -}}
+{{- if not (has $m (list "" "ReadWriteOnce" "ReadWriteMany")) -}}
+{{- fail (printf "sealedKey.persistence.accessMode must be empty (derive from the number of pods sharing the volume), \"ReadWriteOnce\" or \"ReadWriteMany\", got %q" $m) -}}
+{{- end -}}
+{{- if ne $m "" -}}
+{{- $m -}}
+{{- else if gt (int (include "sema.sealedKey.podCount" .)) 1 -}}
+ReadWriteMany
+{{- else -}}
+ReadWriteOnce
+{{- end -}}
+{{- end -}}
+
+{{- /*
+  Deployment 的更新策略:有效访问模式是 ReadWriteOnce ⇒ `Recreate`(`nindent 2` 接在 `replicas:` 之后)。RWO 卷同时只能被一个节点挂,默认的滚动更新先起新 Pod、
+  旧 Pod 要等新 Pod 就绪才放卷 —— 新 Pod 落在别的节点就永远等不到卷。代价:升级窗口内这一只 Deployment 短暂没有副本(只有一只 pod 的形本来就没有别的副本可接)。
+  RWX 与持久关闭不碰策略。
+*/ -}}
+{{- define "sema.sealedKey.strategy" -}}
+{{- /* 访问模式先取(取值即校验):持久关闭时写了非闭集词也拒,「其它词渲染即拒」不看开关。 */ -}}
+{{- $mode := include "sema.sealedKey.accessMode" . -}}
+{{- if and (eq (include "sema.sealedKey.enabled" .) "true") (eq $mode "ReadWriteOnce") -}}
+strategy: { type: Recreate }
+{{- end -}}
+{{- end -}}
+
+{{- /*
+  `server.durableApproval`(耐久审批,env DURABLE_APPROVAL)渲给 worker 的值:"" = 不渲(开关归引擎按姿态定),"true" / "false" = 显式。
+  布尔与字符串写法同义;其它词渲染即拒。持久被关(sealedKey.persistence.enabled=false)⇒ 固定 "false" —— 钥匙跨不过重启,耐久审批铸出来的停驻行
+  就是续不了的行,所以图表替部署**显式**关掉它(不是靠引擎的缺省碰巧关);同一份 values 又把它点名成 true ⇒ 渲染即拒,两个键各说各的就是矛盾。
+  `kindIs "invalid"` 判 nil(`--set server.durableApproval=null` 删键):不能用 `default ""` —— 布尔 false 在 `default` 里算空,会把显式 false 吞成「没表态」。
+*/ -}}
+{{- define "sema.durableApproval" -}}
+{{- $raw := .Values.server.durableApproval -}}
+{{- $want := "" -}}
+{{- if not (kindIs "invalid" $raw) -}}
+{{- $want = lower (trim (toString $raw)) -}}
+{{- end -}}
+{{- if not (has $want (list "" "true" "false")) -}}
+{{- fail (printf "server.durableApproval must be \"true\", \"false\" or empty (empty = the engine decides by posture), got %q" $want) -}}
+{{- end -}}
+{{- if eq (include "sema.sealedKey.enabled" .) "true" -}}
+{{- $want -}}
+{{- else -}}
+{{- if eq $want "true" -}}
+{{- fail "server.durableApproval=true cannot be combined with sealedKey.persistence.enabled=false: durable approvals park tasks whose request credentials are sealed under keys kept in the sealed-key volume, and without that volume every restart replaces the keys so no parked task could resume. Keep sealedKey.persistence.enabled=true (the default), or drop server.durableApproval (with persistence off the chart sets DURABLE_APPROVAL=false itself)" -}}
+{{- end -}}
+false
+{{- end -}}
+{{- end -}}
+
+{{- /* worker 容器 env 里的耐久审批一条(`nindent 12` 之后接在 env 列表里);值为空 ⇒ 什么都不出。 */ -}}
+{{- define "sema.sealedKey.env" -}}
+{{- with (include "sema.durableApproval" .) -}}
+- { name: DURABLE_APPROVAL, value: {{ . | quote }} }
+{{- end -}}
+{{- end -}}
+
+{{- /* worker 容器的 volumeMounts 块(`nindent 10`);持久关 ⇒ 什么都不出。 */ -}}
+{{- define "sema.sealedKey.volumeMounts" -}}
+{{- if eq (include "sema.sealedKey.enabled" .) "true" -}}
+volumeMounts:
+  - { name: sealed-key, mountPath: {{ include "sema.sealedKey.mountPath" . | quote }} }
+{{- end -}}
+{{- end -}}
+
+{{- /* Pod 的 volumes 块(`nindent 6`);持久关 ⇒ 什么都不出。 */ -}}
+{{- define "sema.sealedKey.volumes" -}}
+{{- if eq (include "sema.sealedKey.enabled" .) "true" -}}
+volumes:
+  - name: sealed-key
+    persistentVolumeClaim: { claimName: {{ include "sema.sealedKey.claimName" . }} }
+{{- end -}}
+{{- end -}}

package/deploy/sema-up/chart/templates/sealed-key.yaml

@@ -0,0 +1,24 @@
+# ── 停驻封签钥匙的持久卷(sealedKey.persistence.enabled,缺省开)──────────────────────────
+#    server 的 <数据根>/sealed-key/ 整个目录(模型钥匙 + 子目录 checkpoint-ctx-keys/ 的停驻行封签钥匙)挂这一只 PVC,
+#    主 worker 与启用的 v4pro 变体共用。私钥只在这里(不进库):卷丢了,封在停驻行里的请求凭据就开不开。
+#    访问模式随共享这只卷的 pod 数(助手 sema.sealedKey.accessMode):一只 ReadWriteOnce,多只 ReadWriteMany(要集群的存储类支持 RWX)。
+#    ⚠ PVC 的 accessModes 建好后不可改:副本数跨过 1 的边界(1 ⇄ 多)会让升级撞「spec is immutable」—— 响亮,不静默;见 values.yaml sealedKey 块。
+#    有效访问模式是 ReadWriteOnce 时 server / v4pro 两只 Deployment 用 Recreate(助手 sema.sealedKey.strategy)。
+{{- if eq (include "sema.sealedKey.enabled" .) "true" }}
+apiVersion: v1
+kind: PersistentVolumeClaim
+metadata:
+  name: {{ include "sema.sealedKey.claimName" . }}
+  namespace: {{ .Release.Namespace }}
+  annotations:
+    # 卷里是私钥:丢了,库里停驻行的请求凭据就开不开。`helm uninstall` 与「关持久」的 upgrade 都不顺手删它(确认不要了再 kubectl delete pvc)。
+    helm.sh/resource-policy: keep
+spec:
+  accessModes: [{{ include "sema.sealedKey.accessMode" . }}]
+{{- if .Values.sealedKey.persistence.storageClass }}
+  storageClassName: {{ .Values.sealedKey.persistence.storageClass | quote }}
+{{- end }}
+  resources:
+    requests:
+      storage: {{ .Values.sealedKey.persistence.size | quote }}
+{{- end }}

package/deploy/sema-up/chart/templates/server-v4pro.yaml

@@ -11,6 +11,9 @@ metadata:
   labels: { app: sema-server-v4pro }
 spec:
   replicas: {{ .Values.serverV4pro.replicas }}
+{{- with (include "sema.sealedKey.strategy" .) }}
+{{ . | indent 2 }}
+{{- end }}
   selector:
     matchLabels: { app: sema-server-v4pro }
   template:
@@ -59,10 +62,13 @@ spec:
             {{/* 租户姿态与主 worker 同值(文件头「同 env 面」的承诺;修前缺席 ⇒ 主 worker 多租时本只仍单用户)。 */}}
             - { name: REQUIRE_PRINCIPAL, value: {{ .Values.server.requirePrincipal | default "false" | quote }} }
             - { name: SANDBOX_PKG_SOURCE, value: {{ .Values.server.sandboxPkgSource | quote }} }
-            - { name: REMOTE_EXEC, value: k8s }
             {{/* 车道点名了就显式表态「这台有手」——REQUIRE_EXECUTION_LANE 让「车道被谁改没了」
-                 变成拒启而不是安静的无手 worker。server 侧默认仍 off,sema-up 产物一律写 true。 */}}
+                 变成拒启而不是安静的无手 worker。server 侧默认仍 off,sema-up 产物一律写 true。
+                 下面圈起来的两行取自车道表(lanes.json 的 kube 行),由生成器渲出,不要手改。 */}}
+            {{/* @generated-begin kube-lane-env */}}
+            - { name: REMOTE_EXEC, value: "k8s" }
             - { name: REQUIRE_EXECUTION_LANE, value: "true" }
+            {{/* @generated-end kube-lane-env */}}
             - { name: K8S_API_URL, value: "https://kubernetes.default.svc" }
 {{- if .Values.server.k8sInsecureTls }}
             - { name: K8S_INSECURE_TLS, value: "true" }
@@ -72,10 +78,21 @@ spec:
             - { name: K8S_SANDBOX_IMAGE, value: {{ .Values.sandbox.image | quote }} }
             - { name: K8S_SANDBOX_IPV6, value: {{ .Values.sandbox.ipv6 | quote }} }
             - { name: K8S_TOKEN, valueFrom: { secretKeyRef: { name: sema-runner-token-copy, key: token } } }
+{{- /* 耐久审批的显式表态与停驻封签钥匙卷同源(助手 sema.durableApproval / sema.sealedKey.*,见 _helpers.tpl):关持久 ⇒ 显式 false;留空 ⇒ 不渲。 */}}
+{{- with (include "sema.sealedKey.env" .) }}
+{{ . | indent 12 }}
+{{- end }}
           readinessProbe:  # the only probe path is /readyz (/health is diagnostic, always 200)
             httpGet: { path: /readyz, port: 8090 }
             initialDelaySeconds: 5
             periodSeconds: 5
+{{- /* <数据根>/sealed-key 的持久卷(整个目录:模型钥匙 + 停驻封签钥匙);关持久时两块都不出。 */}}
+{{- with (include "sema.sealedKey.volumeMounts" .) }}
+{{ . | indent 10 }}
+{{- end }}
+{{- with (include "sema.sealedKey.volumes" .) }}
+{{ . | indent 6 }}
+{{- end }}
 ---
 apiVersion: v1
 kind: Service

package/deploy/sema-up/chart/templates/server.yaml

@@ -16,6 +16,9 @@ metadata:
   namespace: {{ .Release.Namespace }}
 spec:
   replicas: {{ .Values.server.replicas }}
+{{- with (include "sema.sealedKey.strategy" .) }}
+{{ . | indent 2 }}
+{{- end }}
   selector:
     matchLabels: { app: sema-server }
   template:
@@ -70,10 +73,13 @@ spec:
             - { name: MODEL_VISION, value: {{ .Values.server.modelVision | quote }} }
             - { name: REQUIRE_PRINCIPAL, value: {{ .Values.server.requirePrincipal | default "false" | quote }} }
             - { name: SANDBOX_PKG_SOURCE, value: {{ .Values.server.sandboxPkgSource | quote }} }
-            - { name: REMOTE_EXEC, value: k8s }
             {{/* 车道点名了就显式表态「这台有手」——REQUIRE_EXECUTION_LANE 让「车道被谁改没了」
-                 变成拒启而不是安静的无手 worker。server 侧默认仍 off,sema-up 产物一律写 true。 */}}
+                 变成拒启而不是安静的无手 worker。server 侧默认仍 off,sema-up 产物一律写 true。
+                 下面圈起来的两行取自车道表(lanes.json 的 kube 行),由生成器渲出,不要手改。 */}}
+            {{/* @generated-begin kube-lane-env */}}
+            - { name: REMOTE_EXEC, value: "k8s" }
             - { name: REQUIRE_EXECUTION_LANE, value: "true" }
+            {{/* @generated-end kube-lane-env */}}
             - { name: K8S_API_URL, value: "https://kubernetes.default.svc" }
 {{- if .Values.server.k8sInsecureTls }}
             - { name: K8S_INSECURE_TLS, value: "true" }
@@ -85,10 +91,21 @@ spec:
             - { name: K8S_SANDBOX_IMAGE, value: {{ .Values.sandbox.image | quote }} }
             - { name: K8S_SANDBOX_IPV6, value: {{ .Values.sandbox.ipv6 | quote }} }
             - { name: K8S_TOKEN, valueFrom: { secretKeyRef: { name: sema-runner-token-copy, key: token } } }
+{{- /* 耐久审批的显式表态与停驻封签钥匙卷同源(助手 sema.durableApproval / sema.sealedKey.*,见 _helpers.tpl):关持久 ⇒ 显式 false;留空 ⇒ 不渲。 */}}
+{{- with (include "sema.sealedKey.env" .) }}
+{{ . | indent 12 }}
+{{- end }}
           readinessProbe:  # the only probe path is /readyz (/health is diagnostic, always 200)
             httpGet: { path: /readyz, port: 8090 }
             initialDelaySeconds: 5
             periodSeconds: 5
+{{- /* <数据根>/sealed-key 的持久卷(整个目录:模型钥匙 + 停驻封签钥匙);关持久时两块都不出。 */}}
+{{- with (include "sema.sealedKey.volumeMounts" .) }}
+{{ . | indent 10 }}
+{{- end }}
+{{- with (include "sema.sealedKey.volumes" .) }}
+{{ . | indent 6 }}
+{{- end }}
 ---
 apiVersion: v1
 kind: Service

package/deploy/sema-up/chart/values-full-single.yaml

@@ -1,5 +1,5 @@
 # full-single(单节点 k3s dev/测试)覆盖:1 实例 PG、preferred 反亲和(required 在单机=永久
-# Pending——真踩)、2 副本 server。用法:
+# Pending——真踩)、2 副本 server(钥匙卷 RWO,见文末)。用法:
 #   helm upgrade --install sema-stack ./chart -n sema --create-namespace \
 #     -f chart/values-full-single.yaml --set server.image=… --set …(凭据)
 pg:
@@ -7,3 +7,7 @@ pg:
   antiAffinity: preferred
 server:
   replicas: 2
+# 钥匙卷:单节点上的 2 个副本在同一个节点,ReadWriteOnce 的卷同节点可共用 —— 不必为它给节点装 NFS 客户端(缺省的 ReadWriteMany 要 RWX 存储类)。
+sealedKey:
+  persistence:
+    accessMode: ReadWriteOnce

package/deploy/sema-up/chart/values.yaml

@@ -49,6 +49,10 @@ server:
   modelApiKey: ""          # REQUIRED
   modelVision: "false"
   requirePrincipal: "false"   # users=multi 时 true(身份隔离;compose 路径同名 env)
+  # 耐久审批(env DURABLE_APPROVAL;停驻 / 续跑 / /v1/approvals 整条路由)。留空 = 图表不渲这个 env,开关归引擎按姿态定
+  # (单用户 + 有耐久店 ⇒ 开;requirePrincipal=true 的多用户形 ⇒ 关);"true" / "false" = 显式表态,原样渲给每只 worker。
+  # sealedKey.persistence.enabled=false 时图表固定渲 "false"(钥匙跨不过重启,停驻行就续不了);此处再写 "true" ⇒ 渲染即拒。
+  durableApproval: ""
   # region=global 时置 "global"(B5 env-first);cn 留空 = 域内默认
   sandboxPkgSource: ""
   # k8s exec lane 的 TLS 姿势:true=渲染 K8S_INSECURE_TLS=true(chart 0.1.0 as-built);
@@ -66,6 +70,36 @@ server:
   s3PublicBucket: ""
   sendUserFileSandboxPutEndpoint: ""
 
+# 停驻封签钥匙的持久卷:server 的 <数据根>/sealed-key/ 整个目录挂一只 PVC(缺省开)。
+#   为什么:耐久审批(单用户 + 有耐久店时引擎缺省就开)停驻的任务,续跑上下文里请求自带的凭据只以封签落盘,封签的私钥只在这个目录里
+#   (子目录 checkpoint-ctx-keys/;同目录还有模型钥匙)——钥匙不进库。目录不持久 ⇒ 每次重启换一把钥匙;多副本各一份 ⇒ 换副本就换了钥匙。
+#   两种结局相同:重启 / 换副本之前停驻、带请求凭据的任务续跑恒答 409 conflict.checkpoint_ctx_unsealable(reason key_not_held),只能作为新任务重提。
+#   挂在哪:容器内 /root/.ai-agent/sealed-key(镜像以 root 跑、本图表不设数据根变量 ⇒ 数据根是缺省 /root/.ai-agent)。
+#   主 worker 与启用的 serverV4pro 变体共用同一只 PVC(它们读同一个库里的停驻行)。
+#   访问模式缺省随共享这只卷的 pod 数(server.replicas + 启用的 serverV4pro.replicas):1 只 ⇒ ReadWriteOnce;多只 ⇒ ReadWriteMany;`accessMode` 可显式盖(见下)。
+#   有效访问模式是 ReadWriteOnce 时,server / serverV4pro 两只 Deployment 用 Recreate 更新策略(RWO 卷同时只能被一个节点挂,滚动更新的新 Pod 落在别的节点就永远等不到卷;
+#   代价:升级窗口内这一只 Deployment 短暂没有副本)。
+#   ⚠ ReadWriteMany 要集群的存储类支持 RWX(Longhorn 的 RWX 走 NFS 共享管理器,每个节点要装 NFS 客户端 —— cluster-up.sh 不替你装;NFS / CephFS 类存储本就支持;
+#   local-path 与多数云盘类不支持,PVC 会一直 Pending、server Pod 起不来)。没有 RWX 的集群出路有三:server.replicas=1(RWO 即可);
+#   单节点多副本(所有 pod 在同一个节点)显式 accessMode: ReadWriteOnce(随包的 values-full-single.yaml 就是这么写的);或关掉持久(下面 enabled: false,耐久审批随之关 —— 代价见下)。
+#   ⚠ PVC 的 accessModes 建好后不可改:副本数跨过 1 的边界(1 ⇄ 多;启用 v4pro 也算一只)时 helm upgrade 会撞 PVC「spec is immutable」—— 响亮失败,不静默;
+#   这只卷里是私钥,不要为了过这个错直接删 PVC:先把停驻行结掉(随包排空检查脚本数一数)或备份钥匙文件,再换卷。
+#   PVC 带 helm.sh/resource-policy: keep:`helm uninstall` 与把 enabled 改成 false 的 upgrade 都不删它(钥匙留着;确认不要了再 `kubectl -n <ns> delete pvc sema-server-sealed-key`);
+#   同名 release 重装会接管这只留下的 PVC。
+#   ⚠ 空卷上多副本并发首启:每个副本看到空目录各自生成一把钥匙,各副本只持有自己那一把,直到下次重启 —— 首装后 `kubectl -n <ns> rollout restart deploy/sema-server`
+#   一次(启用 serverV4pro 时再加 deploy/sema-server-v4pro;NOTES 也说这句),重启之后每个副本读到目录里的全部钥匙,从此一致。
+sealedKey:
+  persistence:
+    # true(缺省)= 建 PVC 并挂到上面的路径。
+    # false = 不建卷、不挂载,图表**显式**给每只 worker 设 DURABLE_APPROVAL=false(不产生续不了的停驻行;NOTES 也打印这一句);
+    #   此时 server.durableApproval 再写 "true" ⇒ 渲染即拒。代价:耐久审批整条关(审批卡停驻 / 续跑、/v1/approvals 路由、/v1/capabilities 的 approvals 位);
+    #   web-admin 贴的模型钥匙 sealedApiKey 的私钥也跨不过重启(重启后那些条目答 stale_ciphertext,要对着新公钥重封)。
+    #   只收布尔:字符串 "false" 在模板里恒为真,会静默保持开着,所以渲染即拒。
+    enabled: true
+    size: 64Mi         # 只放几个几百字节的钥匙文件;留余量给文件系统开销
+    storageClass: ""   # 空 = 集群默认 SC;访问模式是 ReadWriteMany 时要点名一个支持它的类
+    accessMode: ""     # 空 = 随共享 pod 数派生(1 只 RWO,多只 RWX);"ReadWriteOnce" / "ReadWriteMany" = 显式盖,其它词渲染即拒
+
 # v4-pro 变体 worker(2026-07-11 手工 kubectl 资源收编进 chart;同镜像/同 env 面,仅 MODEL_ID 不同;
 # 公网入口=Gcore LB listener 8091 → nodePort,LB 面不归 chart 管)
 serverV4pro:

package/deploy/sema-up/stack/compose.yaml

@@ -97,9 +97,12 @@ services:
       # 执行车道:值由 sema-up.sh 从 lib/lanes.json 渲进 .env(resetk,每次重写)。
       # `REQUIRE_EXECUTION_LANE` 缺省 true —— 手工起这份 compose 而没点名车道时,server 拒启
       # 并说「没有手」,而不是安静地起成一个什么都干不了的 worker。
+      # 下面圈起来的几行(车道键、缺省、compose 路径上各车道运维自备的键)由车道表生成,不要手改。
+      # @generated-begin lane-env
       REMOTE_EXEC: ${REMOTE_EXEC:-}
       REQUIRE_EXECUTION_LANE: ${REQUIRE_EXECUTION_LANE:-true}
       E2B_API_KEY: ${E2B_API_KEY:-}
+      # @generated-end lane-env
     ports:
       - "${SERVER_BIND:-0.0.0.0}:${SERVER_PORT:-8090}:8090"
 

package/deploy/sema-up/stack/sema-stack-cluster.yaml

@@ -198,9 +198,11 @@ spec:
             # 租户姿态与 chart 主 worker 同值(cluster-up 由 --users 渲:multi ⇒ true,否则 false);修前整块缺席 ⇒ 恒单用户
             - { name: REQUIRE_PRINCIPAL, value: "__REQUIRE_PRINCIPAL__" }
             - { name: SANDBOX_PKG_SOURCE, value: "__PKG_SOURCE__" }
-            - { name: REMOTE_EXEC, value: k8s }
-            # 显式表态「这台有手」(车道被改没了 ⇒ 拒启,不是安静的无手 worker)
+            # 显式表态「这台有手」(车道被改没了 ⇒ 拒启,不是安静的无手 worker);下面圈起来的两行取自车道表(lanes.json 的 kube 行),由生成器渲出,不要手改
+            # @generated-begin kube-lane-env
+            - { name: REMOTE_EXEC, value: "k8s" }
             - { name: REQUIRE_EXECUTION_LANE, value: "true" }
+            # @generated-end kube-lane-env
             - { name: K8S_API_URL, value: "https://kubernetes.default.svc" }
             - { name: K8S_INSECURE_TLS, value: "true" }
             - { name: K8S_NAMESPACE, value: sema-sandbox }

package/dist/adoption/plan.d.ts

@@ -160,7 +160,8 @@ export declare function checkAdoptionPrincipalShape(fromPrincipal: string, toPri
  * 纯函数(零 I/O),所以校验发生在任何库动作之前。
  */
 export declare function checkAdoptionWidths(fromPrincipal: string, toPrincipal: string): string | undefined;
-/** `proj:` / `userproj:` 键的 tenant 段前缀(值对由 DISTINCT 扫描按前缀解出)。 */
+/** 两段键的 tenant / 属主段前缀(值对由 DISTINCT 扫描按前缀解出;扫描 SQL 的前缀臂由本表生成,一处):`proj:` / `userproj:`(core 文法)
+ *  与单用户项目层 `userrepo:`(S-640,文法 `project-layer-key.ts`:属主段 = principal 的段编码)。 */
 export declare const MEMORY_PROJECT_SCOPE_PREFIXES: readonly string[];
 /**
  * 一根身份轴上,「旧值 → 新值」的**值对**。`verbatim` 轴恒只有一对;`memory-scope` 轴的对数 =
@@ -175,7 +176,7 @@ export declare function buildVerbatimPair(fromPrincipal: string, toPrincipal: st
 /**
  * memory scope 键的重写(纯函数,给扫描出来的每个 scope 值算新值)。
  *  · `user:<enc(from)>` ⇒ `user:<enc(to)>`(逐字等值);
- *  · `proj:<enc(from)>/…` / `userproj:<enc(from)>/…` ⇒ 只换 tenant 段,项目段原样;
+ *  · `proj:<enc(from)>/…` / `userproj:<enc(from)>/…` / `userrepo:<enc(from)>/…` ⇒ 只换 tenant / 属主段,项目段原样;
  *  · 其它(`org:` 组织盘、无前缀的旧不透明键)⇒ `undefined` = **不属这个 principal,不动**。
  *
  * 🔴 为什么不用 `LIKE '<prefix>%'`:段是**百分号编码**的(`user%3Aweb-demo`),`%` 在 LIKE 里是通配符,

package/dist/adoption/plan.js

@@ -1,4 +1,5 @@
 import { formatUserScope, encodeScopeSegment, SCOPE_SEGMENT_MAX_ENCODED } from "@sema-agent/core";
+import { PROJECT_LAYER_KEY_PREFIX } from "../project-layer-key.js";
 export const REBIND_LEGS = [
     {
         leg: "session_meta#owner",
@@ -213,15 +214,15 @@ export const REBIND_LEGS = [
         why: "workflow run 行的 scope 分区(scope = `principal ?? \"default\"`)。183 §4.2 D4:不变量属 update 动词面,存储层迁移豁免",
     },
     {
-        leg: "workflow_journal#scope",
-        table: "workflow_journal",
+        leg: "workflow_journal_owner#scope",
+        table: "workflow_journal_owner",
         kind: "bulk-rebind",
         action: "bucket-rebind",
         columns: ["scope"],
         matchColumn: "scope",
         encoding: "verbatim",
         residualKey: undefined,
-        why: "resume 重放日志的 scope 守卫列 —— 与 run 行**同事务**(错配会让 load 守卫拒掉整条 resume)",
+        why: "resume 重放日志的属主 scope(S-197 起一条 run 只记在这一行,journal 行上不再有 scope 列;读写两面都经它判)—— 与 run 行**同事务**(错配会让 load 的墙拒掉整条 resume、append 的墙拒掉续写)",
     },
     {
         leg: "workflow_agent_session#scope",
@@ -320,7 +321,7 @@ export const REBIND_LEGS = [
         matchColumn: "scope",
         encoding: "memory-scope",
         residualKey: ["slug"],
-        why: "记忆条目盘(user:/proj:/userproj: 三形键的 tenant 段 = principal)",
+        why: "记忆条目盘(user:/proj:/userproj:/userrepo: 四形键的 tenant / 属主段 = principal)",
     },
     {
         leg: "agent_memory_engine_cursor#scope",
@@ -406,6 +407,7 @@ export const NOT_MIGRATED_BY_DESIGN = [
     { face: "usage-window", ruling: "D1", reason: "deployment token-governance window (usage_window): a windowed governance transient — not carried, recounted from zero" },
     { face: "cost-quota", ruling: "D1", reason: "per-window cumulative spend counter (cost_quota.scope_key) — same windowed-transient class as usage-window" },
     { face: "rate-limit", ruling: "D1", reason: "per-window request counter (rate_limit.limit_key) — same windowed-transient class as usage-window" },
+    { face: "org-delivery-quota", ruling: "D1", reason: "per-hour cross-principal delivery counters (org_delivery_sender_quota.from_scope / org_delivery_pair_quota.from_scope,to_scope / org_delivery_recipient_quota.to_scope) — same windowed-transient class as usage-window; carrying them would hand the new identity the old window's remaining budget" },
     { face: "approval-exemption-grantor", ruling: "D2", reason: "approval_exemption.granted_by is a historical fact (who granted this exemption), not a live authorization axis" },
     { face: "approval-ask-decision-actor", ruling: "D2", reason: "approval_ask.decision_actor / decision_note record who decided — historical audit fields, never rewritten" },
     { face: "image-bake-requested-by", ruling: "D2", reason: "image_bake.requested_by records who requested the build — historical audit field" },
@@ -471,7 +473,7 @@ export function checkAdoptionWidths(fromPrincipal, toPrincipal) {
     }
     return undefined;
 }
-export const MEMORY_PROJECT_SCOPE_PREFIXES = ["proj:", "userproj:"];
+export const MEMORY_PROJECT_SCOPE_PREFIXES = ["proj:", "userproj:", PROJECT_LAYER_KEY_PREFIX];
 export function buildVerbatimPair(fromPrincipal, toPrincipal) {
     return { from: fromPrincipal, to: toPrincipal };
 }

package/dist/adoption/runner.js

@@ -3,7 +3,7 @@ import { ADOPTION_PHASE, adoptionLockName, } from "../plugins/adoption-log-sql.j
 import { policyKeyFor } from "../plugins/session-policy-store-sql.js";
 import { buildRuleOwnerKey } from "../plugins/permission-rule-store-sql.js";
 import { withAdoptionQuiesce } from "./quiesce.js";
-import { AFFECTED_CONFIG_TEMPLATES, MEMORY_SCOPE_MAX_CHARS, NOT_MIGRATED_BY_DESIGN, REBIND_LEGS, buildVerbatimPair, rewriteMemoryScope, } from "./plan.js";
+import { AFFECTED_CONFIG_TEMPLATES, MEMORY_PROJECT_SCOPE_PREFIXES, MEMORY_SCOPE_MAX_CHARS, NOT_MIGRATED_BY_DESIGN, REBIND_LEGS, buildVerbatimPair, rewriteMemoryScope, } from "./plan.js";
 import { buildBlobScanSql, buildBlobWriteSql, buildConflictProbeSql, buildMemoryScopeScanSql, buildResidualCountSql, buildRebindSql, buildRuleOwnerRekeySql, buildSessionPolicyRewriteSql, buildSessionPolicyScanSql, } from "./sql.js";
 import { AdoptionConfigsSchema, AdoptionLegsSchema, AdoptionReceiptSchema, AdoptionRejectDetailSchema, AdoptionReportSchema, } from "./wire.js";
 import { formatUserScope, encodeScopeSegment } from "@sema-agent/core";
@@ -24,15 +24,8 @@ async function resolveValuePairs(exec, dialect, leg, fromPrincipal, toPrincipal)
         ];
     }
     const seg = encodeScopeSegment(fromPrincipal);
-    const projHead = `proj:${seg}/`;
-    const userProjHead = `userproj:${seg}/`;
-    const res = await exec.query(buildMemoryScopeScanSql(dialect, leg.table), [
-        formatUserScope(fromPrincipal),
-        projHead.length,
-        projHead,
-        userProjHead.length,
-        userProjHead,
-    ]);
+    const heads = MEMORY_PROJECT_SCOPE_PREFIXES.map((prefix) => `${prefix}${seg}/`);
+    const res = await exec.query(buildMemoryScopeScanSql(dialect, leg.table, heads.length), [formatUserScope(fromPrincipal), ...heads.flatMap((head) => [head.length, head])]);
     const pairs = [];
     for (const row of res.rows) {
         const scope = String(row.scope);

package/dist/adoption/sql.d.ts

@@ -42,9 +42,10 @@ export declare function buildRebindSql(dialect: SqlDialect, leg: RebindLegSpec):
  * LIKE 里是通配符 —— 不逐字符转义就会误命中别的租户的盘(**跨租户误迁**,不是性能问题)。`LEFT(col, n) = ?`
  * 是纯等值比较,没有元字符面,两方言同形。
  *
- * 参数序:`[userScope, projHead.length, projHead, userProjHead.length, userProjHead]`。
+ * 前缀臂数 = `prefixCount`(调用方传 `MEMORY_PROJECT_SCOPE_PREFIXES.length` —— 臂由词表生成,词表长一员 SQL 跟着长一臂,不手写第二份)。
+ * 参数序:`[userScope, head₁.length, head₁, head₂.length, head₂, …]`。
  */
-export declare function buildMemoryScopeScanSql(dialect: SqlDialect, table: string): string;
+export declare function buildMemoryScopeScanSql(dialect: SqlDialect, table: string, prefixCount: number): string;
 /**
  * 残留计数:某条腿上**仍挂在旧身份名下**的行数。参数序:`[fromValue]`。
  *

package/dist/adoption/sql.js

@@ -10,11 +10,9 @@ export function buildRebindSql(dialect, leg) {
     const sets = leg.columns.map((c, i) => `${c} = ${ph(dialect, i + 1)}`).join(", ");
     return `UPDATE ${leg.table} SET ${sets} WHERE ${leg.matchColumn} = ${ph(dialect, leg.columns.length + 1)}`;
 }
-export function buildMemoryScopeScanSql(dialect, table) {
-    return (`SELECT DISTINCT scope FROM ${table}` +
-        ` WHERE scope = ${ph(dialect, 1)}` +
-        ` OR LEFT(scope, ${ph(dialect, 2)}) = ${ph(dialect, 3)}` +
-        ` OR LEFT(scope, ${ph(dialect, 4)}) = ${ph(dialect, 5)}`);
+export function buildMemoryScopeScanSql(dialect, table, prefixCount) {
+    const arms = Array.from({ length: prefixCount }, (_, i) => ` OR LEFT(scope, ${ph(dialect, 2 + 2 * i)}) = ${ph(dialect, 3 + 2 * i)}`).join("");
+    return `SELECT DISTINCT scope FROM ${table} WHERE scope = ${ph(dialect, 1)}${arms}`;
 }
 export function buildResidualCountSql(dialect, table, matchColumns) {
     const where = matchColumns.map((c, i) => `${c} = ${ph(dialect, i + 1)}`).join(" OR ");

package/dist/adoption/wire.d.ts

@@ -67,13 +67,14 @@ export type AdoptionConfigEntry = z.infer<typeof AdoptionConfigEntrySchema>;
  * 🔴 这是**冻结的闭集**(下游按成员名写正向断言)。改名/删员 = wire 破坏;新增 = 新行为面,要先过三问。
  * 判据形见 183 §10.5:「按设计不迁」与「漏了没迁」在黑盒上必须可分,所以它是**正向声明**而不是沉默。
  */
-export declare const NOT_MIGRATED_FACES: readonly ["usage-window", "cost-quota", "rate-limit", "approval-exemption-grantor", "approval-ask-decision-actor", "image-bake-requested-by", "permission-rule-approval-history", "permission-rule-import-ticket"];
+export declare const NOT_MIGRATED_FACES: readonly ["usage-window", "cost-quota", "rate-limit", "org-delivery-quota", "approval-exemption-grantor", "approval-ask-decision-actor", "image-bake-requested-by", "permission-rule-approval-history", "permission-rule-import-ticket"];
 export type NotMigratedFace = (typeof NOT_MIGRATED_FACES)[number];
 export declare const AdoptionNotMigratedSchema: z.ZodObject<{
     face: z.ZodEnum<{
         "usage-window": "usage-window";
         "cost-quota": "cost-quota";
         "rate-limit": "rate-limit";
+        "org-delivery-quota": "org-delivery-quota";
         "approval-exemption-grantor": "approval-exemption-grantor";
         "approval-ask-decision-actor": "approval-ask-decision-actor";
         "image-bake-requested-by": "image-bake-requested-by";
@@ -122,6 +123,7 @@ export declare const AdoptionReportSchema: z.ZodObject<{
             "usage-window": "usage-window";
             "cost-quota": "cost-quota";
             "rate-limit": "rate-limit";
+            "org-delivery-quota": "org-delivery-quota";
             "approval-exemption-grantor": "approval-exemption-grantor";
             "approval-ask-decision-actor": "approval-ask-decision-actor";
             "image-bake-requested-by": "image-bake-requested-by";
@@ -183,6 +185,7 @@ export declare const AdoptionReceiptSchema: z.ZodObject<{
                 "usage-window": "usage-window";
                 "cost-quota": "cost-quota";
                 "rate-limit": "rate-limit";
+                "org-delivery-quota": "org-delivery-quota";
                 "approval-exemption-grantor": "approval-exemption-grantor";
                 "approval-ask-decision-actor": "approval-ask-decision-actor";
                 "image-bake-requested-by": "image-bake-requested-by";

package/dist/adoption/wire.js

@@ -23,6 +23,7 @@ export const NOT_MIGRATED_FACES = [
     "usage-window",
     "cost-quota",
     "rate-limit",
+    "org-delivery-quota",
     "approval-exemption-grantor",
     "approval-ask-decision-actor",
     "image-bake-requested-by",