@sema-agent/server 7.146.0 → 7.147.0

package/MIGRATION.md

@@ -7,6 +7,390 @@
 > ⚠️ 完整清单在仓库根 `CHANGELOG.md`——它**不随 npm tarball 出包**(本文件随包)。看完整迁移窗的
 > 权威姿势是源码 tag diff:`git diff v<旧>..v<新>`(每版都推 `v<版本>` tag);npm 包页也镜像 CHANGELOG。
 
+## 7.147.0 —— 1–30 条见下
+
+1. **硬断预告 —— 本版兑现:每个部署都要显式声明执行车道,未声明拒启;车道词 `none` 取代词表外的状态名 `in-process`;`REQUIRE_EXECUTION_LANE` 退役(设了即拒启)(行为 BREAKING;wire 值形 BREAKING;部署动作:写明 `REMOTE_EXEC`、去掉 `REQUIRE_EXECUTION_LANE`,有 `in-process` 存量行的部署停机迁移、不可滚动;全部细节与回滚见本节「执行车道恒点名」一条)**:
+    旧形(7.146.0 及以前):`REMOTE_EXEC` 不设时有两条隐式臂 —— `CONFIG_PROVIDER=local` 隐含 `host`(手带在,宿主真机);其余(`remote` 或不设)落 core 的进程内桩(手带整族不挂,任务照跑、回执 `status=completed`)。
+    后一条在 `GET /v1/capabilities` 的 `executionLane.provider` 上叫 `in-process` —— 一个不在车道词表里的状态名。想对「没点名」拒启,要自己开 `REQUIRE_EXECUTION_LANE=true`(缺省关;本仓自带的部署产物都写着它)。
+    新形(自 7.147.0 起,即本版):
+    **硬断(自 7.147.0 起)**:每个部署都要显式声明自己最终生效的执行车道 —— env `REMOTE_EXEC`(`CONFIG_PROVIDER=local` 形下 `config.d/remote-exec.json` 也算);没有声明 ⇒ 拒启,拒句以 `No execution lane is declared` 起、一行给出照旧行为的修法(`CONFIG_PROVIDER=local` 不再隐含 `host`,非 local 未设也不再静默落进「不挂手」的进程内桩)。「不给智能体的工具提供执行环境」写成车道词 `none`,取代词表外的状态名 `in-process`(wire 五处换值,零别名:`GET /v1/capabilities` 的 `executionLane.provider`、`GET /v1/sessions/:id/execution-placement` 的 `lane`、409 `execution_lane.not_served` 与 409 `execution_lane.tree_bound` 的 `boundLane`、403 `execution_lane_not_allowed` 的 `extra.lane`);`REQUIRE_EXECUTION_LANE` 已退役(设了任何非空值 ⇒ 拒启,拒句指向 `REMOTE_EXEC`),自己拼的清单或拷过随包部署产物的 env 里写着它的,升级前要去掉。库里或数据根里记着 `in-process` 的会话 / 审批行由一次性迁移 M40 在起服时改成 `none`:停全部旧副本、再起 7.147.0,不可滚动混跑;SQL 后端上判活窗(`REAP_RUN_STALE_SEC`)内还有 run 在心跳 ⇒ 起服拒 `config.execution_lane_rename_refused`,拒句给出可再起的时刻;守卫只看心跳,没有在跑的 run 的空闲旧副本它看不见 —— 停全部旧副本是运维的动作(细节与回滚见 MIGRATION 7.147.0 节「执行车道恒点名」一条)。web-admin 渲染 env 的中心 worker,须先停渲 `REQUIRE_EXECUTION_LANE`、同时让每个 worker 的 env 带 `REMOTE_EXEC`,再升到 7.147.0。照旧行为的一行修法:7.146.0 里非 local 且未设车道的 ⇒ 7.147.0 写 `REMOTE_EXEC=none`,`CONFIG_PROVIDER=local` 且未设的 ⇒ 写 `REMOTE_EXEC=host`(7.146.0 及以前不认 `none` 这个词,别提前写)。
+    **谁需要**:所有部署方 —— 尤其是 `CONFIG_PROVIDER=local` 的单机形、手写 `.env`、没写 `REMOTE_EXEC` 的托管 worker,以及给 worker 渲染 env 的编排方;读 `executionLane.provider` / 放置读面 `lane` / 409 `boundLane` / 403 `extra.lane` 的壳与客户端(按 `in-process` 字面分支的,要在 7.147.0 同波认 `none`)。
+    **谁受伤**:7.147.0 起 ① 没声明车道的部署拒启;② env 里还写着 `REQUIRE_EXECUTION_LANE` 的(拷过旧版随包部署产物的清单、自己拼的清单、编排方渲染的 worker env)拒启;③ 库里或数据根里有 `in-process` 存量行的部署要停机迁移、不可滚动(旧副本不认 `none`、新副本不认 `in-process`,混跑两头都会拒);④ 按旧词字面读 wire 的消费端。
+    **补偿**:7.146.0 上就能先显式点名 —— 单机用 `REMOTE_EXEC=host`,隔离用 `e2b` / `k8s` / `local-docker`(`none` 是本版才有的车道词,7.146.0 及以前写会被拒,别提前写);要继续「不给手」的部署,本版写 `REMOTE_EXEC=none`(逐字复现 7.146.0 非 local 未设的行为)。
+    编排方停渲 `REQUIRE_EXECUTION_LANE` 的同时,必须让每个 worker 的 env 带 `REMOTE_EXEC` —— 7.146.0 上只停渲这根旋钮而不点名车道,worker 会静默落进无手的进程内桩。
+    **升级前做**:盘点哪些部署没写 `REMOTE_EXEC`(7.146.0 上非 local 而未设的 ⇒ 写 `REMOTE_EXEC=none`,`CONFIG_PROVIDER=local` 而未设的 ⇒ 写 `REMOTE_EXEC=host`);盘点 env 里的 `REQUIRE_EXECUTION_LANE`(去掉);有 `in-process` 存量行的部署排一次停机窗(停全部旧副本、再起本版,不可滚动)。步骤见本节「执行车道恒点名」一条。**回滚**:见本节「执行车道恒点名」一条(含 M40 改写过的行的回写语句),本条不另给第二份。
+
+2. **`task_notification` 帧的会话箱车道上 wire:三只载体 `crossSessionMessage` / `crossSessionNotice` / `inboxNotice` 与侧记 `_sema_provenance` 的三个 lane 词(`cross_session_message` / `cross_session_notice` / `inbox_notice`)及 `peerMeta`(含 typed 通告 `peerMeta.notice`)逐成员投(wire 加性;部署零动作)**:
+    旧形:接了会话席的部署上,引擎的会话箱 drain 交来的帧(一条对端会话的信 / 本会话发出那条信的投递回执与对端空闲通告 / 一行收件箱计数)在本服务 wire 上只有经典键(`task_id` / `summary` / `result` …);三只载体与它们的侧记恒缺席,消费端只能渲通用通知卡;`inboxNotice.resupplied` 恒缺席。
+    新形:三条腿(同步 live SSE / bg·resume 两条 durable 账本行 / 空闲态 park → drain 的补投帧)同形加键 ——
+    `crossSessionMessage { from, fromSession?, fromName?, fromMode?, fromScope?, body }`(`from` = 发信方规范编码地址,身份逐字;`fromName` / `body` 过脱敏);
+    `crossSessionNotice { kind: "delivery_notice" | "idle_notice", text }`(`text` 是引擎渲给模型的那一句,过脱敏);
+    `inboxNotice { pending, delivered, urgent?, resupplied? }`(非负整数;`seq` 每个 run 从 1 起);
+    `_sema_provenance.kind` 放行 core 词表四员,两种箱记录 lane 带 `peerMeta { fromSession?, fromRoot?, fromMode?, kind?, fromScope?, notice?, urgent? }`,
+    回执 / 空闲帧的卡从 `peerMeta.notice { state, refSeq?, recipient?, dropReason?, finishedAt?, detail?, target? }` 渲(`state` 开集串逐字,新词原样过境;`recipient` / `target` / `detail` / `dropReason` 过脱敏)。
+    仍不投:`peer`、`received`、`peerMeta.senderKey`、`peerMeta.gateReceiptId`、`peerMeta.occupant`、`peerMeta.fromOccupant`(凭据 / 身份令牌类:准入键、投递回执号、会话化身令牌)、`inboxNotice.box`(同帧 `task_id` = `inbox:<box>` 与 `_sema_provenance.from` 已带)。
+    在场却读不出(容器不是纯数据记录(类实例 / `Date` / `Map` 也算坏)/ 必需成员缺席 / 成员形坏 / 闭集词出词表)⇒ 那一只键整键缺席,运维计数 `server.trace.projection-input-malformed` +1;缺席不计。`_sema_provenance` 词表外 lane 词此前静默丢,现同样计一次。
+    park 补投帧上这些文本位与本服务其余 park 文本位同一个 4000 字界。
+    **谁需要**:接了会话席的多会话部署上的三端渲染 —— 对端信的转录行、投递回执 / 空闲通告的卡、收件箱计数行;按 `inboxNotice.resupplied` 标注补投的壳。
+    **谁受伤**:按「帧上未知键」报错或整帧比对的消费端与金样(要补键);对端信的帧变大(`body` 与经典 `result` 同一串,live 帧上两份);按 `taskId:status:seq` 跨 run 去重收件箱通告的消费端会吞同会话第二个 run 的第一条通告(请把 run 身份并进键)。
+    **补偿**:新键全部可缺席、缺席 = 上一版形,不读这些键的消费端逐字不变;坏形整键缺席并有运维计数;凭据类身份键不上 wire;文本位经与 `summary` / `result` 同一读法的脱敏。
+    **升级前做**:部署零动作。消费端:按载体在场分派渲染(优先序 `agentMessage` → `crossSessionMessage` → `crossSessionNotice` → `inboxNotice`),回执 / 空闲卡读 `_sema_provenance.peerMeta.notice`(不解析 `text`),`notice.state` 按开集读。**回滚**:回到上一版即恢复旧形;零持久面、零 DDL、零一次性迁移(park 已入箱的补投帧带着新键,上一版 drain 原样带出,老消费端忽略)。
+
+3. **🔴 单用户部署必须声明「谁是运维」:`REQUIRE_PRINCIPAL` 未开、`OPERATOR_PRINCIPALS` 为空、`OPERATOR_SINGLE_USER` 不是 `true` ⇒ 装配运维面时拒(服务进程起服拒,直接调 `createHttpServer` 的嵌入方同拒;不变量 `operator-declaration-required`);起服日志 `operator_undeclared_single_user` 与 `memory_consolidation_valve_unreachable` 退役(行为 BREAKING;安全轴;没写声明的单用户部署升级前补一行)**:
+    旧形:单用户部署不写声明照常起服,起服一行 warn `operator_undeclared_single_user`;这台部署上没有运维 —— 审批队列的跨属主列表与决议对谁都不开(每个调用方只看自己的卡),`GET /v1/diagnostics/wiring`、`GET /v1/outcomes`、管理与记忆治理口对谁都答 501 `capability.operator_principals_required`。
+    新形:多一条跨域不变量 `operator-declaration-required`(服务进程在起服第 1 段判;所有装运维面者在 `createHttpServer` 装路由之前再判同一句,直接调工厂的嵌入方只过这一处):单用户形(`REQUIRE_PRINCIPAL` 不是 `true`)必须二选一 —— `OPERATOR_SINGLE_USER=true`(这台单用户部署的每个调用方都是运维)或 `OPERATOR_PRINCIPALS=<主体,…>`(只有点名的主体是运维);
+    两样都没有 ⇒ 进程在起服第 1 段退出(先于任何起服日志、店连接与中心拉取;嵌入方:`createHttpServer` 抛同一句),stderr 一行拒句点名这两条出路,并说明不止一个人调用的 worker 是多租、该设 `REQUIRE_PRINCIPAL=true`。`OPERATOR_SINGLE_USER=false` 与没写同判。多租形不归本条(空名单 = 没人是运维,合法;开了 `DURABLE_APPROVAL` 的多租形照旧由 `operator-principals-required` 管)。
+    `operator-single-user`(单用户声明与多租 / 非空名单互斥)与 `operator-principals-required` 两条的拒启集不变。三根键都只在 env、起服冻结;配置热改路径只对「把声明改成被拒形」的候选判本条(三键没动 ⇒ 不判,不装运维面的 `run-local` 的限额照落)。
+    不装路由的 `run-local` 不判本条(它不跑起服第 1 段、不调 `createHttpServer`,`loadConfig()` 本身不拒)。运维面的 501 `capability.operator_principals_required` 从此只在「多租 + 空名单」上出现。
+    两条起服日志退役:`operator_undeclared_single_user`(在场条件与本条拒启条件同一);`memory_consolidation_valve_unreachable`(显式开得起来的记忆整理阀门只在单用户 + file 记忆后端上,过了第 1 段就有运维)。`memory_consolidation_run_credential_gated` 不变。
+    本包的一键部署渲这一行:`sema-up --users=single`(缺省)写 `OPERATOR_SINGLE_USER=true`、`--users=multi` 写 `false`(compose `.env` 每次重跑按租户词重写;cluster 清单同值);chart 两只 worker 从 `server.requirePrincipal` 派生(未开 ⇒ `"true"`,开 ⇒ `"false"`);`server.requirePrincipal` 从此只认 `"true"` / `"false"`(大小写不论),别的词 `helm template` / `helm upgrade` 渲染即拒并点名那个值。具名运维名单这几份模板不渲。
+    **谁需要**:单用户部署的运维 —— 旧形下这些运维面静默对谁都 501,起服只有一行 warn,运维不知道自己丢了它们。
+    **谁受伤**:① 没写声明的单用户 / 本机部署(手写 env、自己的 compose 或编排):升级即拒启;② 读起服日志 `operator_undeclared_single_user` / `memory_consolidation_valve_unreachable` 的告警规则从此读不到这两行;
+    ③ 一台忘设 `REQUIRE_PRINCIPAL` 的团队机器若照出路写 `OPERATOR_SINGLE_USER=true`,每个调用方都成运维 —— 拒句因此把这条出路限定在单用户部署,并点名「不止一个人调用 ⇒ 设 `REQUIRE_PRINCIPAL=true`」;
+    ④ chart 部署把 `server.requirePrincipal` 写成 `yes` / `1` / `on` 之类的:渲染即拒(改写成 `"true"` / `"false"`);⑤ 直接调 `createHttpServer` 的嵌入方:无声明的单用户 config 装配即抛(同一句),此前装得起来、运维口对谁都 501。
+    **补偿**:拒句就是出路 —— 一行声明二选一;没有旋钮、没有宽限、没有缺省。一键部署:重跑 `sema-up`(不带旗即沿用上一次的租户词)或 `helm upgrade` 即落新模板。
+    **升级前做**:单用户部署在 env 里补一行 `OPERATOR_SINGLE_USER=true`(或 `OPERATOR_PRINCIPALS=<主体,…>`);团队机器确认 `REQUIRE_PRINCIPAL=true` 已设。**回滚**:回到上一版 ⇒ 不写声明照常起服(起服 warn 回来);补的那一行上一版照读(同一根键、同一个判法);无持久数据。
+
+4. **🔴 `DB_BACKEND=local`:数据根记引擎版本高水位 —— 比记录旧的引擎(本版及以后)开这只根起服拒 `config.schema_mismatch`;marker 读不出同拒;嵌入方类型 `LocalSidecarMismatch` 改名 `LocalDataRootMismatch`(行为变更;持久面;无迁移;部署零动作)**:
+    旧形:7.144.0 起数据根比代码新只靠**格式**围栏判 —— 会话元数据边档 `session-incarnations.json` 本构建读不出 ⇒ 拒;只盖格形变过的那一跳,格形没变的相邻版本,旧引擎开新引擎服务过的根照常起服(版本降级无人守)。
+    新形:数据根顶层多一只 `engine-high-water.json`,恰一键 `{"highWater":"x.y.z"}` = 打开过这只根的最高引擎版本(契约见 USAGE「嵌入形契约」同名一条)。local 后端**打开数据根的那一刻**(取锁之后、本仓任何一只店建起之前)先判、后抬:
+    判 —— 高水位高于本构建 ⇒ 拒;marker 在而读不出(I/O 错 / 悬空符号链接 / 不是 JSON / 缺键 / 多键 / 版本串不是纯 `x.y.z`)⇒ 拒,**不当缺席**;本构建版本按发布线读(`x.y.z`,可带 `-预发布` / `+构建` 后缀,后缀只剥不比:`7.147.0-rc.1` 按 `7.147.0` 判与抬,marker 恒写纯三段),读不出(例 `unknown`)⇒ 拒,先于读 marker;判拒 = 本仓零字节写(店一只没建,收尾不落盘);
+    拒与格式围栏同一只具名类 `LocalDataRootSchemaMismatchError`、同码、同一张三条出路(本构建版本读不出那一形是确定的拒启族里的一句普通拒),由公开序列的 `ensureSchema()` 交出;`findings` 多一种 `problem: "newer-engine"`(同一段必带 `engineHighWater: { highWater, engine }`),拒句点名 marker、高水位与本构建版本。
+    抬 —— 判过即抬,先于店构造里的自修、起服对账、一次性迁移与任何服务写:本构建高于记录(或缺席)⇒ 原子替换成本构建(`0600`,目录项证不了落盘也算没写成),相等不写(只证它在盘上);写到一半进程死了,水位已是本构建(比它旧的引擎重开被拒,本构建重开续跑);
+    对账或迁移在抬之后被拒 ⇒ 水位留在本构建;写不进 ⇒ 不以这只根服务(起服拒;缺省推导的 local 在起服时为空的根上按既有降级臂退内存)。SQL 后端不读不写它。
+    同一只字节一读也管会话元数据等边档:路径上是一条悬空符号链接 ⇒ 读不出(严格边档拒启、装饰性边档隔离留证后按空表继续),不再当「还没有」。
+    包根导出的读数类型 `LocalSidecarMismatch` 改名 `LocalDataRootMismatch`(它现在也装 marker 的读数),零别名 —— 按名字 import 它的嵌入方 tsc 红,改名即可;它是以 `problem` 为判别位的联合:`"newer-engine"` 那一支必带 `engineHighWater`,别的种别那一支没有它(字段 `path` / `label` / `unknownFields` 不变)。
+    **无迁移**:marker 由本版第一次打开数据根时写下,升级即生效;升级前不用做任何事。缺席 = 还没有本版及以后的引擎打开过这只根。
+    **谁需要**:`DB_BACKEND=local` 的单机部署与本机壳 —— 新引擎服务过数据根之后,换回旧二进制(或旧壳冷起自己钉的旧引擎)不恢复备份就照起,旧引擎在新引擎写过的数据上跑。
+    **谁受伤**:① 在同一只数据根上交替跑不同版本引擎的开发 / 测试(源码树的 `package.json` 版本落后于代码时同理);② 为躲一个问题降级又没有升级前备份的用户;③ 起服在对账或一次性迁移段被拒之后不恢复备份就换回旧版的部署(水位在打开那一刻已抬),含按跳版拒句的「先过一次带某条迁移的版本」去做、而那一版也是本版及以后的情形 —— 先恢复升级前备份;
+    ④ 按名字 import `LocalSidecarMismatch` 的嵌入方。
+    **补偿**:拒句点名 marker、高水位与出路 —— 部署不低于高水位的 server;回滚 = 恢复升级前的数据根备份(marker 随备份回到旧值);同一台机器要并行跑多个版本 ⇒ 各给一个数据根(`LOCAL_DATA_ROOT`)。不设绕过旋钮;格式围栏照旧在下面兜。
+    **保护起点(如实)**:只有旧的那一端是本版及以后才守得住;更早的引擎不读这只文件,换回它们照旧只有格式围栏。
+    **回滚**:唯一支持形 = 恢复升级前的数据根备份。不恢复备份换回上一版(7.146.x 及更早):上一版不读 marker,照旧起服(格式围栏照旧判);换回本版及以后、但低于记录的版本 ⇒ 拒。不要手删 / 手改 marker 来绕过 —— 删了就是把一只服务过的根当成没人服务过。
+
+5. **🔴 SQL 后端:会话上本服务记的十二格搬出引擎座表 `session_meta`,住旁表 `session_ext`;一次性迁移 M41(停-迁-起,不可滚动);外键级联是起服前提(持久面一次性迁移;行为变更;wire 零变化;部署动作:停全部旧副本再起本版)**:
+    ① **表形**:
+    旧形:`session_meta` 一行同时带引擎的列(身份 / 属主 / 化身 / 叶子 / 时刻 / 委派分区元组)与本服务的十二格 —— `title` · `pinned` · `instruction_source` · `workspace` · `execution_role` · `execution_lane` · `execution_device_id` · `execution_device_owner_tenant` · `execution_device_owner_subject` · `execution_placed_at` · `execution_rev` · `fork_key`。
+    新形:`session_meta` 只剩引擎的列;十二格住 `session_ext`(主键 `session_id`,外键 `fk_session_ext_session` 引 `session_meta(session_id)` `ON DELETE CASCADE`,各列定义与宽度同前)。一会话一行;行不在 = 每一格缺省(未命名、未置顶、没记过基线 / 位置、没有执行格、非键控 fork)—— 写者锁住会话行之后按需补行。删一只会话(属主删除、委派真删、留存删除)在同一条语句里带走它的旁表行,同一 id 重新登记的新住客从空行起步。
+    ② **一次性迁移 M41(SQL 两方言;local 零动作)**:起服时 ① 把 `session_meta` 上仍在的这几列按会话 id 分页、每一行都搬,upsert 进 `session_ext`(旁表那一行的这几格 = 会话行上的值;上一次没跑完留下的旁表行也改回会话行上的值);② 逐行核对两边相等(有一行不等 ⇒ 起服拒 `config.session_ext_move_refused`(`copy_mismatch`),一列不删,下一次起服重搬);③ 一句 `ALTER TABLE session_meta DROP COLUMN …` 删掉在场的这几列。中断 ⇒ 下一次起服从头重跑,结果相同。窗 = 发布日 + 30 天,窗内每次起服都跑(之后零动作),窗关之后的第一个 minor 删码。起服读数 `sessionExtRowsMoved` / `sessionMetaColumnsDropped`。
+    **停-迁-起**:删列之后,旧副本对这十二格的每一笔读写都撞未知列;搬与删之间旧副本落下的写会丢 ⇒ 停掉全部旧版本副本 → 起本版(起服时迁移)→ 再起其余副本。**守卫**:还有列要搬,而判活窗(`REAP_RUN_STALE_SEC`)内还有 `running` run 在心跳 ⇒ 起服拒 `config.session_ext_move_refused`(`live_runs`),一个字节不写;拒句给出可以再起的时刻。守卫只看心跳 —— 空闲的旧副本它看不见,停全部旧副本是运维的动作。
+    ③ **外键级联是起服前提**:建表之后、一次性迁移之前,起服在一只事务里插一对行、删会话行、读旁表行、回滚(库零写);旁表行还在 ⇒ 拒 `config.session_ext_cascade_absent`。PostgreSQL 恒执行外键;TiDB 要执行外键的版本且会话变量 `foreign_key_checks` 为 `ON`(DSN 或全局设置可能关掉它);MySQL 要 InnoDB。表是在外键不执行时建的(约束没记下)⇒ 删掉那只(空的)`session_ext` 再起。
+    外键两侧的字符列在 MySQL 协议方言上必须同字符集、同排序规则,而存量库的 `session_meta` 可能随建库时的库缺省(`session_meta` 建表句给表尾写上 `COLLATE utf8mb4_bin` 之前建的库;stock MySQL 8 / 9 的缺省是 `utf8mb4_0900_ai_ci`)⇒ 建 `session_ext` 之前起服读一次 `information_schema.COLUMNS` 里 `session_meta.session_id` 的字符集与排序规则,外键列逐字照写(其余列仍是表级 `utf8mb4_bin`;PostgreSQL 腿照旧 `COLLATE "C"`)。读不出被引列,或库以**确定拒**(闭集:外键两侧列不相容 3780 / 加不上外键 1215 / 被引列缺索引 1822 / 存储引擎拒建表 1005 / 表级权限拒 1142 / 缺表 1146 —— `sql-errors.ts` 的部署错配类一张表)拒了建表句 ⇒ 起服拒 `config.schema_mismatch`,拒句点名 `session_ext`、写下的字符集 / 排序规则与库的原句(不是「库打不开」,开库等待窗不重试它);闭集之外的语句级错(TiDB 8028 / 9005、锁等待 1205 …)原样上抛,等待窗重试;连接类故障(断连、服务端关停、连接被杀)照旧原样上抛,等待窗重试。
+    ④ **整段换装就地改写(行为变更)**:`replaceEntries`(会话同步的整段换装)此前删掉会话行再新建(标题、置顶、换源通告基线、位置与项目随之清空,化身与 fork 键沿用);本版就地改写导入者自己的那一行(属主门 ∧ 不是委派转录;化身与旁表行不动),与暂存提交同一读法 —— 换装之后标题 / 置顶照旧由同步的行重放写,换源通告基线与位置与项目保留服务端上一次记下的值。导入的拒判次序:有 run 认领 ⇒ 409 `session_active`,本处是该会话的写者 ⇒ 409 `conflict.session_writer`,都在写任何字节之前判(两者同在时,整段换装此前先答写者,现与暂存提交同序先答认领)。
+    **谁需要**:SQL 后端的每个部署(引擎的会话行只带引擎的列,本服务的格有自己的表与删除语义)。**谁受伤**:滚动升级的部署(守卫拒,或空闲旧副本漏网后撞未知列);外键不执行的库(起服拒);直接读 `session_meta` 这十二列的运维查询 / 报表(改读 `session_ext`);依赖「整段换装清空标题 / 基线」的脚本。
+    **补偿**:拒句给出可以再起的时刻与库端设置;迁移中断可重跑;读旧列的查询改成 `SELECT … FROM session_meta sm LEFT JOIN session_ext se ON se.session_id = sm.session_id`(行不在 = 缺省)。
+    **升级前做**:① 确认库执行外键(TiDB:`SELECT @@foreign_key_checks` 答 `1`);② 停全部旧副本,再起本版;③ 把直接读这十二列的查询改读 `session_ext`。
+    **回滚**:换回 7.146.x 之前停全部本版副本,把列加回并回写(本版的 `session_ext` 就是数据源):逐列 `ALTER TABLE session_meta ADD COLUMN <7.146.x 建表句里的列定义>`,再 `UPDATE session_meta sm JOIN session_ext se ON se.session_id = sm.session_id SET sm.title = se.title, …`(PostgreSQL:`UPDATE session_meta sm SET title = se.title, … FROM session_ext se WHERE se.session_id = sm.session_id`);`session_ext` 留着不影响 7.146.x(它不读这张表)。
+    回到 7.146.x 还要撤第 16 条的 M40 改写,次序固定:① 停全部本版副本 → ② 本条的加列与回写(`execution_lane` 由此回到 `session_meta`)→ ③ 第 16 条回滚里的两条反向 `UPDATE`(第二条写的正是 ② 加回来的 `session_meta.execution_lane`;先跑它会撞未知列)→ ④ 起 7.146.x。
+
+6. **🔴 pg 记忆向量面:embedder 指纹对不上缺省拒启、一行不清;清列重嵌只经显式确认口令 `MEMORY_EMBEDDER_REEMBED=<model>/<dimensions>`(行为反转;新旋钮;部署动作:换 embedder 时给口令)**:
+    旧形:配了 `MEMORY_EMBEDDER_*` 的 pg 记忆部署,起服时 `agent_memory_engine_meta` 记下的 `{model, dimensions}` 与配置对不上 —— `changed`(不等)/ `unattributed`(元表无行而库里有向量)/ `unreadable`(那一行读不出)——
+    ⇒ 先把 `agent_memory_engine_entry.embedding` 整列清成 NULL、再写新身份,服务照常起(检索在重嵌之前退词面档)。
+    新形:这三态缺省**拒启**,一行不清、元表不写;拒句点名所处的态、记下的与配置的身份和出路:① 只有 `changed` 才有 —— 把 `MEMORY_EMBEDDER_MODEL` / `MEMORY_EMBEDDER_DIM` 改回记下的身份;
+    ② 确认重嵌 —— 设 `MEMORY_EMBEDDER_REEMBED=<本次配置的 model>/<dim>`(拒句给出的是 shell 赋值形 `MEMORY_EMBEDDER_REEMBED='<model>/<dim>'`,值带 POSIX 单引号,模型名含空格 / `$` / 引号也能原样粘进 shell;引号只是 shell 的写法,env 里的值不带引号 —— 写进 YAML / `.env` 文件 / 编排器 env 列表时只写引号里那一段),停机后再起:清列一次、记下新身份,`memory_embedder_identity_changed` 照旧响亮;
+    ③ 撤掉 `MEMORY_EMBEDDER_*`,以词面档起、存量向量原样留。口令形:维度在最后一个 `/` 之后(`BAAI/bge-m3/1024`);必须恰好点名本次配置的身份,形不对(`true` / `1` 这类开关形)或对不上 ⇒ 拒启;
+    embedder 三键不全时单独在场 ⇒ 与 `MEMORY_EMBEDDER_TIMEOUT_MS` / `MEMORY_EMBEDDER_API_KEY` 同一条半配拒。口令绑定身份:新身份记下之后下一次起服判「相等」,口令留着无害;再换模型,旧口令对不上新配置 ⇒ 拒启。
+    相等 / 无记录且零向量两态照旧(零写 / 只记身份)。元表的写改成条件写:多副本同时起服而配置不一致时,判与写之间另一副本抢先记下的身份不再被盖掉 ——
+    本副本回读看见它、按它重判(未确认 ⇒ 拒启)。`MEMORY_ENGINE_BACKEND=mysql|file` 无向量面,零变化。
+    **谁需要**:任何配了 `MEMORY_EMBEDDER_*` 的 pg 部署 —— 换模型 / 改维度 / 回滚残留 / 手改元表的一次手滑不再在起服时不可逆地丢掉全部向量。
+    **谁受伤**:靠「换模型、下次起服自动清列」的部署 —— 升级后换模型起服即拒;运维脚本里「删 `agent_memory_engine_meta` 那一行让下次起服保守清一次」的做法现在也拒,要带口令起一次。
+    **补偿**:拒句给出口令与三条出路;撤掉 embedder 即可先以词面档起来。
+    **升级前做**:不换 embedder 的部署零动作(记下的身份与配置相等 ⇒ 照常起)。正在换、或升级同一拍要换的:在这一次起服的 env 里加 `MEMORY_EMBEDDER_REEMBED=<新 model>/<新 dim>`,停全部副本后再起(停机纪律不变)。
+    **回滚**:换回上一版无须动作(上一版不读这一键;多出来的 env 键它不认,照旧按自动清列处置)。
+
+7. **🔴 场景面:部署接了配置中心而中心答不出这位主体的场景裁定(不可达 / 超时 / 答复读不出 / 指派两键形不对)⇒ 该 run `503 state.scenario_assignment_unavailable`,不再落部署缺省场景、不再放行点名的场景;没接中心 / 匿名运行 / 旧中心照旧(安全轴,fail-closed;wire 新码;行为变更;部署零动作)**:
+    **旧形**:部署接了中心(设了 `SEMA_WEB_ADMIN_URL`、非干跑)、请求带 principal,而中心这一问答不出来(不可达 / 超时 / 非 2xx / 体判坏 / 回声不符)⇒ 这位主体的 run 照跑:请求不点名 ⇒ 部署缺省场景,点名 ⇒ 白名单读成空、照放;
+    中心答了而指派两键形不对 ⇒ 非串元素逐个丢、非数组折成空、非串指派折成「无指派」,只发一键时另一键补空值,照用。受限主体在这一拍可能被放进比他的指派更宽的工具面。
+    **新形**:同一构造 ⇒ `503 state.scenario_assignment_unavailable`(体 `error` / `errorCode` / `permanence: "transient"`;码族 `transient`;不带 `Retry-After`),拒在一切副作用与计费之前,零 run;点名与不点名同拒。
+    两键的读法:都缺席 = 旧中心(无治理);都在场且形对 = 裁定;其余一切(形不对、只发一键)= 读不出 ⇒ 同拒。
+    读面同一只门:`GET /v1/capabilities/mcp`、`GET /v1/sessions/:id/a2a` 整面 503;`GET /v1/sessions/:id/mcp` 答 200,`servers` 缺席,拒因在 `scenarioRefusal`(该码下无 `detail`)。
+    续跑家族(审批决断后的续跑、`POST /v1/sessions/:id/wake`、`/v1/assistant/tasks/:id/resume` · `/plan_review`)同码同状态 503 + `retriable: true`,**不折** `409 resume_blocked_by_policy`(认领之前,卡仍待决;SLA 到期的自动拒不把这张卡过期,逐拍重试,中心恢复后再决即可)。
+    `/plan_review` 的直连门证明:一次性 nonce 在这一判之前已经用掉 —— 中心恢复后重铸 nonce 重签再发。停驻的后台子代赎回不问场景门,中心答不出时照常赎回。
+    **不变**:没接中心(没设 `SEMA_WEB_ADMIN_URL`,或 `SEMA_WEB_ADMIN_DRY_RUN=true`;`run-local`)、匿名运行(无 principal,中心不被问)、中心答了但两键都不发、中心答了「无指派」—— 照旧走请求名或部署缺省场景;
+    指派悬空仍是 `503 state.scenario_assignment_unknown`;请求体点名的未知名仍先答 `400 scenario_unknown`。
+    **嵌入方**(自建 `ScenarioGateSources.principalCaps`,包根 `createScenarioGate` 的入参):读数方法的答成三态 —— 裁定 / `undefined`(缺席 = 无治理)/ `"unavailable"`(故障 ⇒ 门拒);中心答不出时要答 `"unavailable"`,仍答 `undefined` 就是放行;读数方法抛错 ⇒ 门不接,读面答 500。
+    **谁需要**:接了配置中心的多租户 / 受限主体部署(中心答不出时受限主体不越界)。
+    **谁受伤**:接了中心的部署在中心答不出期间,每一个带 principal 的新提交与续跑都被拒(此刻分不出谁受限)—— 此前照跑、只拒放大位;单用户而接了中心的部署同受;中心发出形不对的两键 ⇒ 受影响主体全拒,直到中心改好。
+    **补偿**:码族 `transient`,按码重试;取数失败只复用一个短窗(缺省 10 秒),中心恢复后至多这么久即恢复;刚取到的正常裁定在缓存窗(缺省一分钟)内不再问中心;拒句点名出路(恢复本部署到配置中心的链路)。安全轴不设放行旋钮。
+    **升级前做**:壳 / SDK / 控制台:把 `state.scenario_assignment_unavailable` 当可重试的拒渲染(用 `error` 原句;续跑口上同码,不是 `resume_blocked_by_policy`,别给「取消任务」当出路);渲会话 mcp 面板的 `scenarioRefusal` 时不假定 `detail` 在场。
+    运维:看 `runtime_caps_resolve_failed` 是否常响 —— 常响的部署升级后那些时刻会变成拒,先修本部署到中心的链路;确认中心对 `?principal=` 视图两键要么都发、要么都不发。嵌入方:按上一段改读数方法。
+    **回滚**:无持久面;换回上一版即回到旧形。
+
+8. **宿主车道模型 shell「被扣了哪些变量名」只有引擎通告一只读法:`secret_env_scrubbed` 日志行的 `site:"server.remote-env-host.spawn-env"` 一支退役(日志面;wire 零变化;部署零动作)**:
+    旧形:默认清洗环境(`inheritEnv:"scrub"`)的宿主车道模型 shell,被扣的变量名有两处日志:引擎通告 `inherit_env.names_withheld`(服务日志里的 `engine_notice` 行,`detail.names` / `detail.ownCredentials`;每会话每名字集一次),
+    与本服务宿主腿 spawn 时写的 `secret_env_scrubbed { site: "server.remote-env-host.spawn-env", keys, … }`(每进程 × 键一次)—— 同一批名字,两种读法。
+    新形:后一行不再写;名字只读 `engine_notice` 行(日志不封条数;会话流的同码帧每个数组至多 32 项;引擎的去重记录有界,每会话至多 200 份名字集摘要,尽力而为)。通告只在**根腿**调引擎自己的 shell 工具时出:委派子代调 shell 不出 —— 根腿自己从不调 shell、只把活派给子代跑 shell 的会话,服务日志里不再有这批名字(计数器照记)。`secret_env_scrubbed_total{site="server.remote-env-host.spawn-env",kind,confidence}` 计数器照记,读数不变。
+    **不变**:其余九个 `site` 值(project-memory / center-plugins / leader 的 git 腿、语言服务器、bake-runner、local-docker 与 adb 的 CLI 腿、settings hooks 命令腿,以及 git worktree 基环境)的 `secret_env_scrubbed` 行照旧 —— 引擎没有这些腿的读者,那一行仍是它们的唯一读法;git worktree 基环境(`WORKTREE_ISOLATION_ENABLED` 的 host 车道上本服务自己跑 `git worktree add / remove / prune` 的环境,从不交给引擎)此前记在 host shell 的现场名下,本版起记在新现场 `server.remote-env-host.git-base` 名下(行的字节除 `site` 与 `note` 外不变);模型面不变(被扣的变量在模型 shell 里读「未设置」)。
+    **谁需要**:读「这台部署的模型 shell 收不到哪些变量」的运维 —— 一处可读。
+    **谁受伤**:按 `secret_env_scrubbed` 行(`site` 为 `server.remote-env-host.spawn-env`)告警 / 过滤 / 做看板的运维脚本(开了 worktree 隔离的部署:基环境的行改到 `git-base` 名下,计数器标签同改);只靠委派子代跑 shell 的会话(见新形末句);用本包 host 车道适配器、不接 `RunnerDeps.onNotice` 的嵌入方(此前有这一行日志;现在名字只经引擎通告到达,没有通告席时引擎把句子落 `console.warn`,结构化日志行没有)。
+    **补偿**:`engine_notice` 行带同样的名字(并分出自有凭据一半);计数器不变;接 `onNotice` 的嵌入方读同一条通告。
+    **升级前做**:有上述告警 / 过滤规则的,改读 `engine_notice` 行(`code` = `inherit_env.names_withheld`,字段 `detail.names`);按 `site="server.remote-env-host.spawn-env"` 数 worktree 基环境剥除次数的看板,把基环境那份改看 `site="server.remote-env-host.git-base"`;其余零动作。
+    **回滚**:无持久面;换回上一版即恢复这一行。
+
+9. **远端车道(ssh / adb / local-docker / k8s / e2b)写文件的「不暂存、直接写目标」退路:取消的读法只看落在哪一段,订正 7.139.0 节第 23 条 ⑧ 的一句;准备 / 提交脚本去掉 `readlink -n` 与 `stat`(行为修复 + 文字订正;wire 零变化;部署零动作)**:
+    订正(7.139.0 节原文不动):第 23 条 ⑧ 写「写目标那一步因取消中断 ⇒ `unknown`……(那一步自己的通道准备也算在内,保守)」与「核不过 —— ……目标机上没有 `stat` —— 这一次写不暂存」。两处在本版都不成立:
+    ① 一次传输分两段 —— 备件阶段(第一个字节发往目标机之前:adb 在本机落的临时件、ssh 开 sftp 通道含懒重连、k8s 建连、追加退路里 adb / e2b 的读旧 + 拼)与传输阶段(字节真发出的那一段)。取消落在备件阶段 ⇒ `aborted`、目标未碰、一个字节没发(修前读数:`unknown`「目标可能只写了一半」;ssh 另有 `ok:true`,取消落在拿通道的那一刻时 sftp 照样把整份写到目标);
+    只有传输阶段被取消打断才答 `unknown`;传输阶段不收取消(ssh 的 sftp)⇒ 照样写完、答成功,不变。local-docker 的 `docker exec -i` 起进程与 e2b 的 `files.write` 没有可单列的备件,取消落在其中仍答 `unknown`。
+    ② 脚本只用 POSIX sh 的形:`readlink` 不带 `-n`(读到的一跳核过是同一只文件才信,核不上经链接就地写)、不用 `stat`(模式串与数字属主一律读 `ls -ldn`)。目标机上**没有 `stat` 不再是退回就地写的原因**,权限位照样带到换上去的新件上;
+    带不过去(目标的模式串读不出 / 读不懂、或目标机拒了那一次 `chmod`)而新件照样换上去 ⇒ 写照样答成功,五条车道同一行运维 warn `remote_env_file_mode_failed`(带车道名、目标路径的显示形与目标原来的模式串;升级前这一形无声,目标的模式位悄悄换成新件落下时的位);
+    `mv` 没成、落到就地拷入时不报(写进原 inode,模式本就不变);
+    收紧之后读不出模式串(`ls` 不可用 / 输出读不懂)才是 —— 与修前同一出路(直写退路 + `stage-seal-fallback` 计数)。悬空的单跳链接现在经链接就地写建出目标(修前 rename 原子建出;只在写的过程中崩溃时有可见差别)。
+    toybox(Android)上这些形按文档 / 源码**推断**可用,未上真机。
+    ③ adb 的本机备件临时件带 0600(内容可能含凭据);adb push 把本机件的模式带上设备,所以设备目标的模式不再靠本机 umask,而是 push 之后显式 `chmod 0644`(adb 的每次 push 多一次设备命令往返)。设模式是**尽力而为**:字节已经落地,`chmod` 失败(设备文件系统不认改模式,如 Android 共享存储;设备掉线)⇒ 写照样答成功,运维日志一行 warn `remote_env_file_mode_failed`(带 push 目的地的显示形与设备回话首行),文件保留 push 落下的模式。
+    **取消落在这一步上,分两路**:直写退路(push 直落目标)⇒ 字节已在目标上,写答成功 + 同一行 warn;暂存路(push 进私有目录)⇒ 编排在提交之前复核取消 ⇒ `aborted`、目标一个字节没动(从未提交)、暂存件清掉 —— 与其余车道「提交前取消」同一读法。
+    文件保留 push 落下的模式时 —— 认模式的文件系统上是本机件的 0600,不认模式的文件系统上是它给的固定模式。升级前 push 成功即答成功、不设模式,模式随本机 umask(常见 0644)。
+    **谁需要**:adb 车道(Android)与精简镜像上的远端写;取消后要重试写的调用方(`aborted` 可直接重试)。**谁受伤**:依赖「备件窗口取消也答 `unknown`」的调用方读到更窄的 `unknown` 集合;写进不认改模式的设备路径(如 `/sdcard`)的部署每次写多一行 warn(写本身成功);五条车道上已有目标的权限位带不过去的那一次写多一行 warn(此前无声);`chmod` 失败而文件系统认模式的那一次,设备上的文件是 0600 而不是升级前的 0644(同一用户之外的设备进程读不到)。**补偿**:无需旋钮;传输中途的取消仍答 `unknown`,先重读目标;warn 带路径,模式不对的那只文件可在设备上补一次 `chmod`。
+    **升级前做**:无。**回滚**:无持久面;换回上一版即回到旧形。
+
+10. **org scope 键的文法判只有引擎一只:静态目录、中心下发的目录里有引擎文法之外的 org 键 ⇒ 起服拒 / 该代目录不采用;共享记忆店的铸键点同判(行为面收紧;wire 零新键;部署动作:核键)**:
+    旧形:「这是不是一把 org scope 键」几处各判各的 —— 共享记忆店写侧收 `org:` 加至多 185 个非空白字符,`MEMORY_ORG_DIRECTORY_JSON` 装载收 `org:` 加任意非空白串,中心下发的 `orgMemory` 段只过契约包的类别门(`org:` 加非空白);引擎的记忆准入另按 v2 文法判(`org:` 加一段 `[A-Za-z0-9._-]` 或大写 `%XX` 的名,段至多 64 个编码字符)。名里有 `@` / `/` / `:` / 非 ASCII 的 org 键(例 `org:team@acme`)在目录与店里合法、到引擎的记忆准入里整请求拒(`config.memory_scope_key`),共享库读面却能用。
+    新形:三处判官都是引擎导出的 `isOrgScopeKey`,本仓不再存任何一份文法。① 静态目录:有键不过 ⇒ 起服拒,拒句点名主体与键(`MEMORY_ORG_DIRECTORY_JSON[…] has an invalid org scope key …`)。② 中心下发的远程目录:一代 `orgMemory` 里只要有一把键不过 ⇒ 这一代整代不采用(不丢单键放行其余;旧授予的时间戳不续、gen 高水位不动,中心改发好的一代即采用),该主体的目录答「坏形」:org 记忆准入判瞬时 `memory.admission_required`(503,带重试提示),共享库读面答连接不可用(可重试);服务日志一条 `org_directory_generation_refused`(`gen` / `badKeyCount` / 至多 5 把净化后的坏键),退避窗内不重复。③ 共享记忆店的铸键点(嵌入方 / 管理面调 `putScopeState` / `putStore`):键不过 ⇒ 在落任何语句之前抛 `shared-memory scope key … is not usable`;店的另三个写方法(`putDocument` / `deleteDocument` / `deleteStore`)的 `scopeKey` 是对登记行属主的围栏 —— 逐字比对(含 MySQL 尾随空格的拼法一律不当同一把键),不判键形,所以**店里已有的存量键行不受影响**:仍可写文档、可删,删后在引擎认的键下重建即可(无迁移代码)。
+    **谁需要**:要「目录 / 店 / 引擎对同一把键答同一个话」的运维 —— 此前用时才响。
+    **谁受伤**:静态目录里、中心目录里或店行里用了引擎文法之外 org 键的部署:静态目录起服拒;中心目录含这类键 ⇒ 该主体的整代目录不采用,所有读目录的面在中心改好键之前一直按「目录不可用」处理(与目录取数失败同映射):org 记忆准入瞬时拒;共享库读面对带 principal 的请求连其部署自证的库也不可读;principal 收件箱投递对收发任一方答不上来答 404 `org_delivery.not_member`(这一口不带重试提示)。此前这一代照常采用。一把陈旧的坏键出现在很多主体的表里时,这些主体同受;店的铸键点拒这类键。这类键本来就过不了引擎的记忆准入。
+    **补偿**:服务日志与拒句点名坏键(净化、有界);把名写成引擎文法的规范形 `org:…%XX`(引擎的 `formatOrgScope(<名>)` 即铸,例 `org:team@acme` → `org:team%40acme`)即恢复;存量店行无需动。
+    **升级前做**:核一遍三处的 org 键 —— 静态目录 JSON 里的 scope 键、中心(web-admin)里各主体的 org 记忆授权键、共享记忆店 `shared_memory_scope` / `shared_memory_store` 两表的 `scope_key` 列(只读 `SELECT`):全是 `org:` 加 `[A-Za-z0-9._-]`(段至多 64 字符)的 ⇒ 零动作;有别的字符的 ⇒ 先把目录与登记里的键改成 `%XX` 形,店里存量行无需动(围栏方法仍按旧键寻址可改可删);要迁到新键的,由导入方按新键重新导入后再用既有删除口逐行删旧键的行,不做任何整库 / 整表操作。中心一侧:同一代里好键坏键并存时整代不采用,改键要一次改齐。
+    **回滚**:无持久面;换回上一版即恢复旧收法。
+
+11. **`inheritEnv` 的 `400 request.field_invalid` 机读位 `reason` 闭集四词 → 三词:`no_authorizer_session` 退出(装配器的根会话只剩一个读法 = 执行上下文交进来的根;「没有 authorizer 会话」这一拒因在 HTTP 面上不可达)**:
+    旧形:`inheritEnv:"all"` 在装配器读不到 `auth.sessionId` 时答 `400 request.field_invalid`、`reason:"no_authorizer_session"`。
+    新形:装配器只读执行上下文交进的根会话(受理漏斗与续跑腿恒交接),该拒因臂删除;`reason` 闭集 = `unknown_word` · `not_a_string` · `lane_not_host`(其余不变)。
+    **谁受伤**:按 `reason === "no_authorizer_session"` 分支的消费方(已知:sdk `openapi.yaml` / README 词表、client-core `inheritEnvWire.ts` 词表)—— 该词不再出现,分支变死码;改读 = 从词表删它。**补偿**:HTTP 面上两者本就恒等,线上零行为差;只是词表收窄。
+
+12. **送话口的正文以用户输入到达模型,与调用方是不是运维无关:steer / interrupt 带 `text` 形 / wake 的正文与它们的停驻条目恒以用户源交给引擎;服务自己铸的 workflow 决定投递文本(宿主仍停驻时)恒以系统源投递(行为修复;授权面零变;wire 零新键;部署零动作)**:
+    旧形:三口的正文按调用方身份定框架 —— 运维(具名 `OPERATOR_PRINCIPALS`,或 `OPERATOR_SINGLE_USER=true` 下的每个调用方)的话被引擎铸成带 mark 的 `<system-reminder>`;workflow 决定投递文本跟着决定者身份走。
+    新形:调用方的话恒为用户源(live 腿 = 用户在工作中发来的新消息;停驻 / 唤醒腿续跑首轮 = 引擎的围栏数据段);服务自己铸的决定投递文本在唤醒腿上恒为系统源(与决定者身份无关)。运维身份只管越过属主门,判据不变。
+    **谁受伤**:靠「运维 steer 以系统提醒到模型」的部署(已知消费方零读点);单用户部署里回合停驻期间送达的插话,升级后以引擎的围栏数据段到达(段头「仅为数据」)。**补偿**:要以系统源注入的部署用引擎的 hook 反馈 / 部署提示座。**已知限制**:升级前已停在卡上的运维条目带着冻结的框架续跑;同一把 `Idempotency-Key` 跨升级重发同一句运维 steer ⇒ `409 steering.duplicate_input_id`(`detail.differs` 含 `"trusted"`,别换 key 重发)。
+
+13. **应答口命中停驻行时点的「本会话放行」(`allow_session`)与 `/decide` 的 `remember:"session"` 同一只请求、同一个铸点:可记的停驻行由不记变记,`POST /v1/tool-approvals/:id/respond` 的 `parked_redeemed` 体上 `rememberApplied` 由恒 `false` 变真答;同口两条幂等回放(`idempotent:true`)不再挂 `rememberApplied`(行为修复;wire 值变化;部署零动作)**:
+    按 `rememberApplied === false` 断言「停驻支恒不记」或回放体带该键的消费方改读:`true` = 记住了,`false` = 只放行这一次,缺席(回放)= 本次没有授予判定(看首次回执或 `GET /v1/approvals/:sessionId/exemptions`)。workflow 出身 / 无会话锚的停驻行上 `allow_session` 不新增 400(与 `/decide` 的 `remember` 400 是唯一允许的两口差)。已知限制:耐久 ask 决定口 `POST /v1/tasks/:taskId/asks/:askId/decision` 的体不收 `remember`(只答未转停驻的活问;活问的「本会话放行」走 live 应答口的 `allow_session`)。
+
+14. **`POST /v1/tasks/stream` 的账本落 `prompt_assembled` / `config_assembled` / `cross_boundary_taint` 三种既有行(此前这条腿恒缺,`POST /v1/runs` 与续跑腿一直有;wire 加性:零新键、零新事件名;部署零动作)**:
+    按事件序号逐字比对这条腿账本的消费方多见三种行(清单行先于首帧、污染行先于它被发出之后的下一帧,都先于终局行);按事件名分派的消费方零改动。非流式 `POST /v1/tasks` 结构上没有账本,不变。
+
+15. **执行车道的声明座只有 `REMOTE_EXEC`:`REQUIRE_EXECUTION_LANE` 退役(设了任何非空值 ⇒ 起服拒,`config.env_key_retired`,拒句点名替代名 `REMOTE_EXEC`;随包部署产物不再渲它;部署面 BREAKING;7.146.0 已预告),车道词 `none` 落地(`REMOTE_EXEC=none` / `config.d/remote-exec.json` 的 `{"provider":"none"}`;`executionLane.provider` 的 `in-process` 换成 `none`(wire 值形 BREAKING,见第 16 条);部署零动作)**:
+    ① **`REQUIRE_EXECUTION_LANE` 退役**:
+    旧形:`REQUIRE_EXECUTION_LANE=true` 让「没点名车道」拒启,随包部署产物(车道表 · 两份根 compose · 栈 compose · 两份 chart · 集群清单)一律写着这一键。
+    新形:它在契约包的退役 env 表里(替代名 `REMOTE_EXEC`),在场即拒启,写 `false` 也拒;空串 = 未设。随包产物不再渲该键;配置目录的退役投影 `retired[]` 列它。
+    ② **车道词 `none`**:
+    旧形:`none` 不是车道词(写了拒启);「无手」只有 `REMOTE_EXEC` 未设一种写法,`executionLane.provider` 答 `in-process`。车道表(逗号串)遇第一处坏段即停、拒句列一份手抄的词表。
+    新形:声明了 `none` ⇒ 与 7.146.0 上非 local 形(`CONFIG_PROVIDER` 不是 `local`)的未设同一个运行期状态(无手、能力行同、执行环境块同;本版未设本身拒启,见第 16 条),`executionLane` 答 `{ provider: "none", toolsOnThisHost: false }`。车道表的拒因全部交回(坏词与重复同表两条都报),
+    `none` 与别的车道同表 ⇒ 拒(`must be the only entry`),只含空白的段报空段,拒句以契约规则句收尾;结论(拒启)与多车道「一进程一条」拒启不变。
+    **硬断预告的另两件本版同样兑现**:本文件「硬断预告」一条(7.146.0 期登记,见上)里的「未声明车道即拒启」与「`in-process` 改写成 `none`(含一次性迁移)」见本节「执行车道恒点名」一条 —— 预告的四件在 7.147.0 全部落地。
+    **谁需要**:每个部署(车道只有一个声明座 `REMOTE_EXEC`);要把「不给工具执行环境」写成声明的部署。**谁受伤**:自己写的 env、自己拼的清单、或从 7.146.x 及以前的随包产物拷过 env 的部署 —— 起服拒;对 `executionLane.provider` 八词穷举的客户端;按车道表旧拒句措辞匹配的脚本;
+    记着 `in-process` 的存量会话 / 审批行 —— 由一次性迁移 M40 改写成 `none`(见本节「执行车道恒点名」一条)。
+    **补偿**:自写 env 删一行(随包 compose 不带 `env_file`,旧 `.env` 里的残行不进容器);要表态「不给工具执行环境」写 `REMOTE_EXEC=none`。
+    **升级前做**:在部署的 env / 清单 / `.env` 里查 `REQUIRE_EXECUTION_LANE`,删掉;由中心(web-admin)编排器起的 worker,先把编排器换成已停渲该键的发行、再升 worker(DEPLOY-PREREQS 本版节)。
+    **回滚**:回到 7.146.x 时 `REQUIRE_EXECUTION_LANE` 缺席 = 旧缺省(不拒),无需加回;回到 7.146.x 之前先把 `REMOTE_EXEC=none` 撤掉(旧版拒启这一词)。
+
+16. **🔴 执行车道恒点名:每个部署都要声明自己最终生效的执行车道(env `REMOTE_EXEC`;`CONFIG_PROVIDER=local` 形下 `config.d/remote-exec.json` 也算),未声明 ⇒ 拒启;状态名 `in-process` 改名车道词 `none`(wire 五处换值,零别名);存量 `in-process` 行由一次性迁移 M40 改写(停-迁-起,不可滚动);起服行 `exec_lane_selected` 只带 `{lane}`(行为 BREAKING;wire 值形 BREAKING;嵌入方类型面 BREAKING;持久面一次性迁移;部署动作:写明 `REMOTE_EXEC`,有存量行的部署停全部旧副本)**:
+    ① **未声明即拒启**:
+    旧形:`REMOTE_EXEC` 未设 / 空串时,`CONFIG_PROVIDER=local` 隐含 `host`(工具直接跑在这台机器上,无 OS 沙箱),其余形静默落进不挂手的进程内桩(手带整族不挂、任务照跑、回执 `completed`)—— 同一个「没写」,两种结局靠第三个变量分。
+    新形:判点在执行车道合成步的尾部(本地配置文件覆写之后、中心拉取之前):最终车道不来自显式声明 ⇒ 拒启,拒句以 `No execution lane is declared — every deployment names its execution lane: set REMOTE_EXEC (with CONFIG_PROVIDER=local, config.d/remote-exec.json also declares it). To keep what this deployment did before 7.147.0: REMOTE_EXEC=none when CONFIG_PROVIDER is not "local" (…), REMOTE_EXEC=host when CONFIG_PROVIDER=local (…). …` 起,一行给出照旧行为的两条修法;`CONFIG_PROVIDER` 只回答「配置从哪来」,不选车道。
+    `REMOTE_EXEC=""`(空串)与未设同判。`run-local` 入口自身声明 `host` 车道(入口 = 部署者;声明的先后 = `config.d/remote-exec.json` > `REMOTE_EXEC` > 入口,在场的最高者终结选择,入口只填缺席位,不写进程 env)。`config.d/remote-exec.json` 点了隔离车道(`e2b` / `k8s` / `ssh` / `adb`:坐标此版只从 env 取)而 `REMOTE_EXEC` 没有声明同一条 ⇒ 拒启(修前:一行 `remote_exec_file_isolated_lane_unwired` 告警后照跑 env 的车道,或判点拒);出路是 `REMOTE_EXEC=<同一条>` 带齐坐标 env,或把文件改成要的车道;它只跑 `host` / `none`,部署声明了别的车道 ⇒ 起任何任务之前拒(换跑 HTTP 服务,或声明 `host` / `none`)。自建装配的嵌入方:`composeExecutionLane` 的 `ctx.drivesFromFile` 换成必填的 `ctx.entry`(HTTP 形递包根导出的 `HTTP_SERVICE_LANE_ENTRY`)。
+    ② **`none` 两座皆无**:`REMOTE_EXEC=none`(或文件 `{"provider":"none"}`)⇒ 执行环境工厂与执行环境座都不给,每个 run 的 `wiring_manifest.hands = {mounted:false, reason:"no_execution_env"}`;手带之外的工具照常执行;请求体 hooks 与 stdio MCP 不归车道管(各自的开关照旧)。
+    ③ **wire 五处换值(对象形不变,`in-process` → `none`)**:`GET /v1/capabilities` 的 `executionLane.provider` · `GET /v1/sessions/:id/execution-placement` 的 `lane` · 409 `execution_lane.not_served` 的 `boundLane` · 409 `execution_lane.tree_bound` 的 `boundLane` · 403 `execution_lane_not_allowed` 的 `extra.lane`。
+    车道全集仍是八个词(`host` `e2b` `k8s` `ssh` `adb` `local-docker` `device` `none`),`in-process` 不在其中;`REMOTE_EXEC=in-process` 起服拒(拒句列合法词)。嵌入方类型 `ExecutionLane` / `ALL_EXECUTION_LANES` 删旧词,零别名。
+    ④ **起服行**:`exec_lane_selected` 由合成步在判点与不变量都过了之后发恰一行,字段只有 `{ lane }`(最终车道);此前多带的 `source` 退役;`remote_exec_real_system` 的「单机缺省落了 host」那一形随隐式 `host` 退役(显式 `host` / 非隔离车道照旧有这一行)。
+    ⑤ **一次性迁移 M40(SQL 两方言 + local)**:`approval_ask.execution_lane` 与 `session_meta.execution_lane` 里的 `in-process` 改写成 `none`;local 数据根里会话元数据边档与审批问账日志里的同一词同改。改值不丢信息;窗 = 发布日 + 30 天,窗内每次起服都跑(之后无行可改即零动作),窗关之后的第一个 minor 删码。
+    **停-迁-起**:有 `in-process` 存量行的部署,停掉全部旧版本副本 → 起本版(起服时迁移)→ 再起其余副本;两版副本不可混跑(旧副本会在改写之后接着写旧词)。
+    **守卫**:SQL 后端上若库里有带旧词的行,而判活窗(`REAP_RUN_STALE_SEC`,收割器判「持有者还活着」用的同一个窗)内还有 `running` run 在心跳 ⇒ 起服拒 `config.execution_lane_rename_refused`,一行不改;拒句给出可以再起的时刻(最新心跳 + 判活窗,ISO 时刻与「N 秒之后」两种写法)—— 旧副本确已全停时,那些心跳是它们留下的 run,过了那个时刻收割谓词也判它们为死,再起即过。
+    **守卫看不见的一形(如实)**:守卫只看心跳,**空闲的旧副本**(没有在跑的 run)不留心跳 ⇒ 守卫放行;改写之后它若接新活,会再写下旧词,本版读到旧词的行时按「这一词已改名」响亮拒(不静默当作别的车道)。出路:停掉它,再起一次本版(窗内每次起服都跑 M40,漏网的旧词再改一遍)。所以「停全部旧副本」是运维的动作,守卫只兜住有 run 在跑的那一种。
+    local 数据根由数据根锁保证同一时刻只有一个进程,无需守卫。local 两腿读得出旧词而改写落不了盘(不可变文件 / 只读挂载 / 盘满)⇒ 起服拒 `config.execution_lane_rename_refused`,拒句点名文件与原错码,文件一个字节不动;恢复那只文件与所在目录的写权限再起,改名在下一次起服重跑。
+    **谁需要**:每个部署(车道只有一个声明座,「没写」不再有两种结局);按 `executionLane.provider` 判无手的面板与客户端(词表内的词,不再是表外状态名)。
+    **谁受伤**:没写 `REMOTE_EXEC` 的部署 —— 起服拒;按 `in-process` 字面分支的客户端(读到 `none`);有存量行又想滚动升级的部署(守卫拒,或空闲旧副本漏网后的响亮拒);依赖 `exec_lane_selected.source` 的日志规则。
+    **补偿**:拒句里就是一行修法;`none` 逐字复现 7.146.0 非 local 未设的运行期行为,`host` 逐字复现 local 未设的行为;守卫的拒句给出可以再起的时刻;M40 窗内每次起服都跑。
+    **升级前做**:① 在 env / 清单 / `.env` 里写明 `REMOTE_EXEC`:7.146.0 上非 local 而未设的 ⇒ `REMOTE_EXEC=none`,`CONFIG_PROVIDER=local` 而未设的 ⇒ `REMOTE_EXEC=host`(或在 `config.d/remote-exec.json` 里写);② 跑过未点名车道的部署(库里或数据根里可能有 `in-process` 行):停全部旧副本,再起本版;③ 客户端把 `executionLane.provider` / 放置读面 `lane` / `boundLane` / `extra.lane` 的 `in-process` 分支改读 `none`;④ 中心按 `allowedLanes` 写的车道准入策略里列 `none`(过渡期两个词都列,升级完删旧词 —— 那是策略数据,不是代码里的双读)。
+    **回滚**:回到 7.146.x 之前停全部本版副本,并把 `REMOTE_EXEC=none` 撤掉(7.146.x 不认这一词);M40 改写过的 SQL 行要回写才能被 7.146.x 读成它认得的词 —— **前提**:`session_meta.execution_lane` 在本版已被 M41 搬进 `session_ext`(第 5 条),先按第 5 条回滚把列加回 `session_meta` 并从 `session_ext` 回写,再跑下面两条(次序见第 5 条回滚):`UPDATE approval_ask SET execution_lane = 'in-process' WHERE execution_lane = 'none';` 与 `UPDATE session_meta SET execution_lane = 'in-process' WHERE execution_lane = 'none';`(在本版上声明过 `none` 之后新建的行同样会被改回,这正是 7.146.x 对「无手」的叫法);local 数据根没有反向工具 —— 升级前备份数据根,回滚 = 用备份。
+
+17. **🔴 缺省推导的 local 只在数据根不存在 / 为空时退回内存;数据根上已有东西而开不了 ⇒ 拒启,与显式 `DB_BACKEND=local` 同形(行为变更)**
+    旧形:没写 `DB_BACKEND` 的部署开数据根失败 ⇒ 退回内存 + 一行 `store_db_unreachable_fallback_memory`(adoption 在飞与店的确定拒启除外),数据根里已有会话 / run 账本的那一形也一样;另一实例持锁时,第二只裸 boot 等满 `STORE_LOCK_WAIT_MS` 窗后退内存。
+    新形:开店之前读一次数据根:不存在 / 空目录 ⇒ 照旧退内存(`/health.storeDegraded`、gauge `store_backend_degraded` = 1、`store.degradedReason: "local_unwritable"`);有任何条目或列不出 ⇒ 开它时的任何失败原样拒启;持锁那一形等满窗后拒,拒句点名持锁 pid。
+    **升级前做**:`store_backend_degraded` 现为 1 的副本升级后可能拒启 —— 先读启动日志里 `store_db_unreachable_fallback_memory` 的 `error`,修好数据根的权限 / 挂载;本来就要内存形的写 `DB_BACKEND=memory`;要另起一个空根就把 `LOCAL_DATA_ROOT` 指到空目录。同机两只裸 boot 共用一个数据根的,给第二只单独的 `LOCAL_DATA_ROOT`。
+    **回滚**:回到上一版即回到按错误种类判的降级臂;数据零改动。
+
+18. **引擎 7.64.0 → 7.65.0(`@sema-agent/core` 精确钉;`@sema-agent/primitives` 随 core 的同版精确依赖到 7.65.0):① 🔴 记忆控制面要在能建硬链接的卷上 —— 不能 ⇒ File 记忆后端起服拒 `memory.control_plane_links_unsupported`;② 兑付与导入的引擎拒按「可不可重试」一读,兑付后被撤的放行读 `refused` / `dot_removed`;③ 规则导入 prepare 的审批记录建不成 ⇒ `503 state.rule_write_failed`;④ 住客比较一读律;⑤ 起服日志 `session_box_mount` 取代 `mailbox_store_enabled` 上两格;⑥ 一次性迁移 local 腿报叫不出名字的桶数;⑦ 限制表上退役且没有后继的工具名 = 这一行跳过 + 说一句(会话流多一码 `config.legacy_tool_name`;请求体 / 部署名单 / 中心下发的审批名单不再拒)(行为变更 + 硬破坏一条;部署动作只在 ①)**:
+    换钉:`@sema-agent/core` 7.64.0 → 7.65.0 精确(`package.json` 只钉 core),`@sema-agent/primitives` 随 core 的精确依赖到 7.65.0。下列各项按「谁看得见」排。
+    ① **记忆控制面的硬链接(硬破坏)**:
+    旧形:File 记忆店在任何文件系统上都打开;控制面所在的卷不能建硬链接时,每个控制对象写失败 —— 一次收留把可疑文件从模型可见面拿下、副本却一份都没存下(报告 `quarantine copy FAILED`)。
+    新形:引擎每次开店先在控制面顶层试建一枚硬链接(`.link-probe-<uuid>`,试完即删);不能 ⇒ 店在打开处被拒,码 `memory.control_plane_links_unsupported`(店形拒一族的第三码;拒句点名 errno、不带路径),店里的文件一个字节不动。
+    本服务:`MEMORY_ENGINE_BACKEND=file`(缺省)的 File 记忆后端构造期抛 ⇒ **起服拒**;`MEMORY_ENGINE_BACKEND=pg|mysql` 的引擎 mount 时在自己的控制面上开 File 店被拒 ⇒ 这一跑没有记忆、会话照跑
+    (`effectiveMemoryScopes` = `{ state: "memoryless", reason: "mount-failed" }`;运维行 `memory_engine_incident` 带码,fail-open 计数 `server.memory.store-form-refused-step-skipped`);运维面经引擎开店撞上它 ⇒ `409` 原码。
+    **谁需要**:每一次收留都要真存下副本的部署(上一版在这种卷上静默丢副本)。**谁受伤**:记忆控制面(记忆根 —— `MEMORY_ENGINE_DIR`,缺席时数据根 —— 下面那只 `<slug>/.engine` 目录;目录钉住的部署另有个人平面的 `personal/.engine`,运维面第一次用到个人平面时开)在不能建硬链接的卷上 —— 有的网络共享、FAT / exFAT 卷、有的容器 overlay 配置。
+    **补偿**:把控制面挪到支持硬链接的卷上;店的文件不受拒动,无需迁移。支持形:docker `-v` 绑定挂载、k8s PVC 块存储、`hostPath`、`emptyDir`(本地文件系统)都能建硬链接;NFS 不可靠(见 DEPLOY-PREREQS 的 `DB_BACKEND=local` 数据目录一节);SMB / Azure Files / FUSE 类卷不在支持形(不能建硬链接 ⇒ File 记忆后端起服拒)。本服务的工具结果、文件历史与邮箱锁本来就要硬链接,但那是数据根所在的卷;记忆根在另一只卷上时,那只卷要自己试。进程崩在试建与删除之间会留一枚 `.link-probe-*`(不当记录读,可手删)。
+    ② **兑付 / 导入的引擎拒**:赎回拒臂与批成员拒臂多一位 `retriable`。卡道:`retriable` 真且是店故障 ⇒ 可重试的 `rule_store_error`(批:全员被拒且全员可重试才重兑);其余 `redeem-refused`。
+    导入两只 redeem 口:成员可重试或引擎说不知落没落 ⇒ `503 state.rule_import_retry` 同票重走;其余拒是确定结局(200 回执里 `refused`)。相对上一条(7.146.0 节第 23 条「引擎 7.63.0 → 7.64.0」⑥):
+    记 dot 的 CAS / dot 分配失败卡道改回可重试;同票重走时其间被属主撤掉的放行在回执里读 `refused` + `reason: "dot_removed"`(此前仍读 `persisted`;那一条的已知限制只对引擎 ≤ 7.64.0 成立)。
+    ③ **规则导入 prepare**:引擎的审批记录店建不成这次导入的记录 ⇒ `POST /v1/rules/cc-import/prepare` / `POST /v1/rules/local-import/prepare` 答 `503 state.rule_write_failed`(带 `committed: "no"`;没有票、没有放行落店;
+    local-import 这一批收下的 deny / ask 可能已落店)—— 原样重发即重铸。此前两口落未分类 500。确认口的记录店故障:卡道可重试、导入道同票重走。
+    ④ **住客比较**:两侧都没有化身令牌的住客比较由「说不准」改答「同一位」,一侧有一侧没有答「不是同一位」。本服务会话缓存的新鲜判随之命中两侧都没戳的会话头(本服务的店建行即铸化身;写面照旧拒)。
+    ⑤ **起服日志**:`session_box_mount { peerLaneMountable, peerLaneRefusal?, reason? }`(邮箱店 × 会话店一只判;不拒起服);`mailbox_store_enabled` 去掉 `peerLaneMountable` / `peerLaneRefusal` 两格。
+    ⑥ **一次性迁移(导入层根的全局放行退役)local 腿**:引擎一次答出桶在场的属主(导入记录点名的身份交给它)与叫不出名字的桶数;报告新键 `importedLayerRootBucketsUnnamed`(SQL 恒 0),
+    非零每次起服 warn `imported_layer_root_buckets_unnamed`(带个数)—— 那几只桶本步没读,其中这种放行照旧生效,按属主列规则(`GET /v1/rules`)处置。
+    ⑦ **限制表上退役且没有后继的工具名**(引擎退役表里那一行是 `removed` / `folded into`:`TeamCreate` · `TaskOutput` · `MultiEdit` …)—— 这一行跳过 + 说一句(不审、不拒),整表不拒(只在有人说那一句的三道门,见下);改名了的旧名(有后继:`Task` ⇒ `Agent`、`KillShell` ⇒ `TaskStop`)照旧拒。
+    行原样留着(表谁都不改;嵌入方自挂同名工具时它照管那只工具)。谁读这张表,谁说:
+    请求体 `settings.permissions.deny` / `ask` 与会话存下 / 祖先交下来的规则 —— 引擎读:请求照收(此前 `422 request.unprocessable`、`reason: "retired"`;存量会话规则上此前整跑被拒),会话流通告 `config.legacy_tool_name`(受众 user);
+    部署 `APPROVAL_REQUIRE` / `APPROVAL_DENY` / `APPROVAL_NEVER_AUTO` —— 本服务读:照常起服(此前拒启),起服 warn `approval_list_legacy_tool_name`(一张表一行,点名 env 与条目);只剩这种行的表仍算审批意图(没有 checkpoint 店的部署照「名单在场要 durable 门」拒启,与写任何名字同一判 —— 删掉那一行即可);
+    中心下发 `governance.approvalRequire` —— 本服务读:整组照落(此前整组拒、保前值),组受理之后 warn `web_admin_approval_require_legacy_tool_name`。
+    放行只在有人说那一句的这三道门;没有人说话的面照拒(不拒就是静默受理),候引擎下一版在选择器表 / 技能表发退役名通告、并导出通告句源后同形放行:请求体 `settings.permissions.neverAuto`(`422`,与上一版同码同句)·
+    请求的 `excludeTools`(`400 config.tool_face_control`)/ 子代 `denyTools`(`400 config.agent.unknown_tool`)/ 技能 `disallowedTools`(`400 request.field_invalid`)。
+    **谁需要**:写着这种名字的限制表(壳从 CC 用户 settings 转投的 deny 表常带)—— 不再因一行死项整份被拒。**谁受伤**:按 422 `reason: "retired"` / 拒启 / 整组拒找这种名字的调用方与运维 —— 改读通告与两条 warn。**补偿**:按通告 / warn 点名的条目把它从表里删掉。
+    **引擎已知限度(随版发)**:多只副本共一只记忆控制面时,扣留账的对账与收留写可能交错、把行记成 `capture_lost` 而保管字节成孤(KL-3485-a,引擎下一版收);
+    采集退出记录与污染标记对同一只坏槽两读(KL-3466-b,过渡双读);引擎面百分号只解一层(KL-3487-a)—— 本服务出口脱敏器解到定点,覆盖它。
+    **谁需要 / 谁受伤 / 补偿**:见各项。**升级前做**:① 核记忆控制面所在的卷能建硬链接(在那个目录里 `ln a b` 试一次);不能就先挪;② 按 `mailbox_store_enabled.peerLaneMountable` 告警的规则改读 `session_box_mount`;
+    其余零动作。**回滚**:回到上一版 ⇒ 不能建硬链接的卷上 File 记忆店照旧打开(并照旧丢收留副本);其余各项无持久面(零 DDL、零一次性迁移)。
+
+19. **本服务自己要的目录一律 `0700`:新建的目录创建即 `0700`,升级前由裸 `mkdir` 铸成 `0755` 的 `DB_BACKEND=local` 数据根下 `runs/<taskId>` · `space-commits` · `checkpoint-ctx` · `.tmp` · `attachments` · 会话 scratchpad · 中心 plugin 缓存 · 记忆同步游标目录起服时一次性收紧(一次性迁移 M39);本服务自己落的文件一律 `0600`、原子写的 tmp 每次独占新建(安全面;持久面;日志面加性;部署零动作,外部读者见「升级前做」)**:
+    旧形:本服务自己铸的目录有几种做法 —— 一部分店走 core 的 `ensureDir`(`0700`),run 店(`runs/<taskId>` · `space-commits`)· checkpoint 店(`checkpoint-ctx` · `.tmp`)· 附件店(`attachments`)· 会话 scratchpad · 中心 plugin 缓存 · 记忆同步游标目录 · 配置根下的 LKG 父目录与技能正文缓存直接 `mkdir -p`(进程 umask 之下的 `0755`)。
+    目录 `0755` 而里面的文件多半 `0600`:组 / 他人读不了文件,但列得出文件名(run 的 taskId、附件 id、checkpoint token 文件名);附件店的文件与会话边档(`session-titles.json` 等)是默认的 `0644`,`0755` 的 `attachments` 目录连附件字节都对别的本机用户开着。
+    新形:这些写口也走 `ensureDir`,新建的目录一律 `0700`(`src/**` 没有第二种建目录的写法、没有手写的 `0o700`,有普查钉);本服务自己落的文件(附件 · 会话边档 · 记忆同步游标 · LKG · 技能正文缓存 · 凭证续签 · 钥匙文件 · 完成收件箱 · spool · 数据根顶层的 `exit-last.json` / `crash-last.json`)只读一个模式值 `0600`;
+    原子写的 tmp 每次独占新建(pid + 随机名、`O_EXCL`;同步写口 —— 完成收件箱账本的压实、续租被拒的粘性位 —— 也一样,它们原先经引擎的原子写,那一只以截断方式打开 tmp):此前固定 / 可复用的 tmp 名(附件的 `<id>.bin.tmp` / `<id>.json.tmp`、最近活动边档的 `<path>.<pid>.<n>.tmp`)在崩溃后留下的升级前 `0644` tmp 会被下一次写截断后原样改名上位、把 `0644` 带上正式文件,现在不会。升级前已有的 `0755` 目录,`ensureDir` 对已存在的目录什么也不做 —— 所以起服时(`DB_BACKEND=local`,任何读者之前)一次性收紧:
+    对 `runs` 与它下面的每一只子目录 · `tmp` · `space-commits` · `checkpoint-ctx` · `.tmp` · `attachments` · `scratchpad`(与每个会话段)· `plugin-cache`(往下三层)· `<记忆引擎根>/sync-cursors`(缺省 = `<数据根>/sync-cursors`;引擎根在数据根之外则不在其内)从数据根(持锁的那只物理路径;起服途中它自身被换成链接 ⇒ 一行 warn 点名数据根(`.`),整步不走)逐段往下看:
+    路径上任一段是符号链接 ⇒ 这一条整条不走、进 warn(码 `SYMLINK_IN_PATH`,链接指向根内根外一样);是真目录且带组 / 他人位的 ⇒ 先以 `O_NOFOLLOW` 打开取 fd,再核这只 fd 就是根内那条路径上的目录
+    (物理路径按段在数据根之下、那条路径此刻的 inode 等于 fd 的、路上每一段此刻仍不是链接),三者皆过才对这只 fd 收紧成 `0700`(已有文件的模式一字不动;普通文件不碰;不在的不建;数据根自身与名册外的目录不碰)。
+    收紧了至少一只 ⇒ 一行起服提示 `local_data_dir_modes_tightened`(`count` + 至多五个 `examples`,相对数据根);第二次起服零命中零写、不再有这一行。win32 没有 POSIX 模式位,整段不动。
+    **收紧失败不拒启,但响亮**:目录不属于服务进程的用户(只能写、不能改模式)、路径上有符号链接、检查之后被换走(`ESTALE`)等 ⇒ 逐目录点名(路径 + 码)进 warn `local_data_dir_mode_refused`(`entries` 至多十条,带出路),窗内每次起服再报,其余目录照收,服务照起。
+    把店目录链到别的盘的部署:链接那头的真目录不被跟、不被改,由属主自己 `chmod 700`(这一行窗内每次起服都在 —— 迁移看不见链接那头是否已改)。
+    新写下的文件在这样的目录里仍是 `0600`(含附件店与会话边档);留着的缺口只有一格:升级前写下的附件字节(`0644`)在一只收不紧的 `attachments` 目录里仍可被他人读到 —— 看到这一行 warn 点名 `attachments` 的部署要当天处理。
+    **不在迁移里的(披露)**:SQL 后端的 host 车道在同一个数据根下铸的 `scratchpad` / `plugin-cache`、配置根(`SEMA_CONFIG_DIR`,缺省 `~/.sema`)下的 LKG 父目录与 `skill-cache`、`MEMORY_ENGINE_DIR` 指到数据根之外的 `sync-cursors`,升级前若是 `0755` 原样留着(新建的一律 `0700`);升级前已落盘的边档文件(`session-*.json`)与记忆同步游标不扫 —— 下一次重写即换成 `0600`;崩溃留下的旧固定名 tmp(`attachments/<id>.bin.tmp` 等)不再被复用、也不清扫;数据根顶层的 `exit-last.json` / `crash-last.json` 是原地覆盖,升级前已在的那两只模式不动(新建的是 `0600`)。
+    要收这些:`chmod 700` 它们(目录),或 `chmod -R go-rwx <配置根>`。工作树类目录(宿主执行环境替工具建的目录)、spool、壳 / 请求 / 运维点名的目录不在其内,模式不变。
+    **谁需要**:每个 `DB_BACKEND=local` 部署(自动,无配置);配置根与缓存目录的收紧只对新建生效。**谁受伤**:靠组 / 他人读权限读数据根的外部进程 —— 另一个用户身份的备份 / 监控 / 同步任务升级后列不出、读不进这些目录;数据根的目录属主不是服务进程用户的部署,收紧被拒、每次起服一行 warn。
+    **补偿**:外部读者换成服务进程的用户身份,或给数据根加 ACL(`setfacl`);被拒的目录由属主 `chmod 700 <目录>`(或 `chown` 给服务用户)后重启,那一行 warn 即消失。无放宽旋钮(只收不放)。
+    **升级前做**:`find <数据根> -maxdepth 3 -type d -perm /077` 看一眼会被收紧的目录(信息性);有别的用户身份在读数据根的部署(备份 / 监控),升级前把读者换成服务身份或配 ACL。
+    **将来变化**:这一步是一次性迁移,窗内(发布日 + 30 天,日期见 `plugins/one-time-migrations.ts` 登记表 M39 行)每次起服都跑,窗关之后的第一个 minor 删码 —— 此后从更早的版本直升的数据根,升级前铸成的 `0755` 目录原样留着(新建的一律 `0700`,不受影响),本服务不再点名;
+    出路 = 运维一次 `chmod 700` 数据根下 `runs`(及其子目录)· `space-commits` · `checkpoint-ctx` · `.tmp` · `attachments` · `scratchpad`(及其子目录)· `plugin-cache`(及其子目录)· `<记忆引擎根>/sync-cursors`,或升级时先过一次带本条的版本并起服。**回滚**:回到 7.146.x 时已收紧的目录保持 `0700`(旧版对已存在的目录不 chmod),旧版新建的目录又是 `0755`。
+
+20. **hook 条目的 `onFailure: "block"` 自本版起执行:同步的 command / http 条目被选中却没给出裁决 ⇒ 按退出码 2 算,它守的动作被拦下;续跑重放读出存量请求里的 `onFailure`(安全轴,失效关闭;行为变更;部署零动作);同批:续跑存量体里有本版读者读不出、而本部署本会采纳的成员 ⇒ `409 resume_blocked_by_policy`(安全轴,不再去掉照跑);新提交 `settings.env` 有成员不是串 ⇒ `400 request.field_invalid`(采纳 env 的车道);坏 `args` 的 400 判决改由契约分类器出(`detail.reason` 由 `wire_key_invalid` 变为 `entry-invalid` / `guard-entry-invalid`;wire 值变,BREAKING)**:
+    旧形:7.135.0–7.146.x 新提交里 command / http 条目上的 `onFailure` ⇒ `400 request.body_shape`(读者不携带);续跑重放的存量请求里它被读者剥掉 —— 写了 `"block"` 的守卫起不来时照放行。
+    新形:读者携带它(契约包 19.0.0),本服务执行 `block`:起不来 / 超时 / 退出码非 0 非 2(http 非 2xx)/ 输出读不成判词 / `PreToolUse` 判词在闭集外,以及本服务自己的门让它没跑成(URL 名单拦下、
+    shell 形 powershell、`if` 评不出、组的 matcher 编不过、事件墙钟耗尽)⇒ 交给事件的是一次退出码 2(`PreToolUse` deny · `UserPromptSubmit` / `PreCompact` block · Post* 三站一段反馈上下文),
+    句子 `<事件> hook did not reach a verdict (<成因>); blocking because onFailure is "block"`。`async` / `asyncRewake`、`Stop`、`StopFailure` / `PostCompact` 上不生效;`continue` 与缺席同 7.146.0。
+    `onFailure` 写在 prompt / agent / mcp_tool 条目上照旧是读者不携带的键(新提交 400)。7.135.0 节第 13 条「投影前剥掉 `onFailure`」的建议对 command / http 条目不再适用。
+    **谁需要**:要守卫起不来时拦下的调用方。**谁受伤**:① 写了 `block` 的条目因本服务自己的门没跑成 —— 此前放行,现在拦下;② 升级前停驻的任务:存量请求(只可能来自 7.134.x 及更早:7.135.0 起新提交带这个键就 400)
+    里写了 `block` 的守卫续跑时开始按 block 执行;存量里写的是两词之外的值 ⇒ 读者判坏块,续跑**拒**:这条车道本会采纳请求体 hooks(单用户车道)⇒ `409 resume_blocked_by_policy`(`blockedBy: "request.field_invalid"`,`field: "settings.hooks"`;句子只点名成员键,不回显值),卡 / 任务仍待决、行不动;不采纳请求体 hooks 的车道(多租户)零变化 —— 续跑重读的一次性迁移不接这一形(坏值没有可猜的正确值)。
+    同一条律覆盖存量体里本版读者读不出、而这条车道本会采纳的每一个成员:`settings` 的其它键(如 `env` —— 有成员不是帽内的串;空记录 `{}` 不算 —— 车道采纳调用方 cwd,或采纳请求体 hooks 且请求带着 hooks 时)、`mcpServers[i]` 的传输成员(部署注入请求 MCP、条目名不被部署占住时)、`a2aPeers[i].headers` 的成员(部署注入请求 A2A 时)——
+    升级前这些成员被去掉、任务照跑(运维日志 `task_settings_deferred` / `mcp_transport_members_dropped` / `a2a_peer_headers_members_dropped`,外加 hooks 的 fail-open 计数 `server.hooks.resume-reader-refused`),这三行日志与该计数本版一并退役;新提交带同样的成员 ⇒ `400 request.field_invalid`(同一只判;新提交面唯一的新拒是 `settings.env` 里值不是串的成员 —— 受理门收下了它们,此前装配静默不交;只在采纳 env 的车道上拒:单用户 host / device,或采纳请求体 hooks 的车道上请求带着 hooks,其余车道 env 没有读者、零变)。
+    判的是**续跑将要跑的那一份体**:续跑请求带了重述键 `mcpServers` / `a2aPeers`(四道续跑门都收)⇒ 按盖过重述之后的体判,读不出的 MCP / A2A 成员可由一张合形的整表(空表也算)换掉、照常续跑;不带 ⇒ 存量体原样判。
+    拒体形(如实):复用 `409 resume_blocked_by_policy` + `blockedBy: "request.field_invalid"`(不铸新码);句子只列成员键路径(不回显值、不带会话坐标 —— 会话坐标在运维行 `resume_refused_stored_body` 上);A2A 对端不看场景同名占位(存体预判在认领之前答、不知道场景)⇒ 会输给同场景部署同名对端的那条请求对端照样算,方向是多拒一次。
+    **补偿**:拦下的那句点名成因,故障帧点名是哪一条;改条目 / 改 URL 名单,或改回 `continue`。不加窗、不加旋钮。续跑被拒的停驻任务:拒句点名哪些成员读不出;出路 = 读不出的是 MCP / A2A 成员 ⇒ 续跑请求带这一键的合形整表;其余 ⇒ 取消那只任务、按本版的形重提(一次性迁移 M20 窗内,两类此前受理的 hooks 存量形照旧由剥键重读接住,不拒)。新提交的 `settings.env` 值写成串即过。
+    **同批:坏 `args` 的 400 判决改由契约分类器出**:
+    旧形:7.133.0 起本服务在契约分类器装上的同一坐标上读原值 `args`,形错 ⇒ `400 request.field_invalid`,`detail: { reason: "wire_key_invalid", key: "args", path: [..., "args"] }`。
+    新形:契约包 19.0.0 承运 `args`(串数组、元素无 NUL;`[]` 与空串元素合法 —— 与本服务旧读法同形),坏值是分类器的坏块;本服务不再读第二遍原值:`detail.reason` 变为 `entry-invalid`(非守卫事件)/ `guard-entry-invalid`(守卫事件),
+    `key` 仍是 `"args"`,`path` 指那一条而不是那只键;句子换成块码释义。受理与执行的形不变。
+    **谁受伤**:按 `reason === "wire_key_invalid"` ∧ `key === "args"` 匹配的客户端 / 脚本。**补偿**:按 `detail.key === "args"` 读。
+    **升级前做**:原样投影宿主设置文件的调用方,确认守卫条目上 `block` 是本意;有 7.134.x 及更早停驻、hooks 里写着 `onFailure` 的任务,升级前把它们跑完或取消。**回滚**:回到 7.146.x 即回到「新提交 400、续跑剥掉」,`args` 的 400 判决回到旧坐标与旧 `reason`。
+
+21. **日志脱敏认复合凭据名(`DB_PASSWORD` / `PGPASSWORD` / `SECRET_KEY` / `AWS_SECRET_ACCESS_KEY` …,名字末尾收在强档词上);请求面 URL 凭据判官随包认同一批名字(行为变更:遮得更多、新提交拒得更多;部署零动作)**:
+    旧形:脱敏器只认整名表上的名字,复合名后面的值原样出门;请求面 URL 只拒整名在表上的参数。
+    新形:名字判定读契约包的判官(整名在表上,或末段尾部是 `password` / `passwd` / `pwd` / `secret` / `apikey`,或末尾是 `secret_key` / `secret_access_key` / `api_key` / `access_token`;只看末尾,`password_hash` / `tokens` 不算);日志四个名字读者同读,名长不封顶。
+    请求面 URL 带这类参数(`?db_password=…`)⇒ 新提交 `400 request.field_invalid`(`reason: "url_credential_param"`);续跑重放存量体照旧不判。
+    **谁需要**:日志 / trace 里出现复合凭据名的部署。**谁受伤**:读日志的人(末尾收在强档词上的非凭据名也被遮,如 `show_password=1`;单行出门形里凭据值后紧贴的下一行首词随值遮);URL 里带复合凭据名参数的调用方。
+    **补偿**:无放宽旋钮(脱敏只收不放);非凭据的名字改名让末段不落在强档词上;URL 凭据改走同一条目的头位(MCP `transport.headers` · A2A `headers` · hook `headers` · 搜索 `apiKey`)。**升级前做**:无。**回滚**:回到 7.146.x 即回到整名判定。
+
+22. **本地配置源开始读 `config.d/a2a.json`(行为变更);中心发的 `a2a` 域过契约读口(坏条目点名丢);内部型 `EffectiveConfig.a2a` 改契约型 `A2aConfig`、`CenterA2aPeer` 删(包导出面零变化);同批披露:对端 `allowSkills: []` 的读法将变(本版零行为变化)**:
+    旧形:`EffectiveConfig.a2a?: { peers: CenterA2aPeer[] }`(本仓自持的对端型,`enabled` / `scenarios` 可缺席);本地腿不读 `config.d/a2a.json`(读腿点名为没人读的文件);中心 `/effective.a2a` 原样透传给解析器。
+    新形:`EffectiveConfig.a2a?: A2aConfig`(`@sema-agent/settings-schema` 的型;条目 `A2aPeerSpec`,`enabled` / `scenarios` 由读口补缺省、型上必填),`CenterA2aPeer` 删去(两者都不在包根 / 子路径的导出面上);两腿读成同一个声明;
+    本地腿没写 = `{ peers: [] }`,中心没发这一域 = 缺席(契约包 20.0.0 起线上读口不替中心编造它没发的域),两者与空名册是同一个运行期状态(不拨对端)。写法见 USAGE 9.5i-bis。
+    **谁需要**:本地配置源要声明常驻 A2A 对端的部署。
+    **谁受伤**:① 越过包的 `exports` 深引 `dist/web-admin-client/*` 的代码(不受支持的面):`CenterA2aPeer` 不在了、`EffectiveConfig.a2a` 的条目要带 `enabled` / `scenarios`;② 本地配置根里早就有 `config.d/a2a.json` 的部署,升级后这些对端在首次被用到时被拨号(任务准备取卡 / 会话 A2A 面板读缓存缺失或过期;起服本身只解析配置、不取卡);③ 中心发的对端 url 带 userinfo / fragment / 像密钥的 query 值、名字越界、`headerRefs` 有坏成员 ⇒ 这一条不再拨(此前原样交给引擎)。
+    **补偿**:① 改从 `@sema-agent/settings-schema` 取 `A2aConfig` / `A2aPeerSpec`;② 不要的文件删掉;③ 按读口告警改对那一条,凭据走 `headerRefs`。
+    **披露:对端 `allowSkills: []` 的读法将变(本版零行为变化、零 wire)**:今天配置腿(`config.d/a2a.json` / 配置中心)上 `allowSkills` 写空表与不写同读 = 挂对端发布的**全部**技能(契约包 20.0.0 的字段定义,本服务照它读);请求腿 `a2aPeers[].allowSkills: []` 原样交引擎 = 零技能。
+    契约包下一个 major 起配置腿上空表 = **零技能**(与请求腿同读),本服务随那一版提货。**谁受伤**:配置腿上写了 `allowSkills: []` 本意是「全部」的部署 —— 提货那一版起这个对端一只技能都不挂。**升级前做**:要全部就删掉这个键,要不拨这个对端就写 `enabled: false`;本版无需动作。
+    **披露:对端拨号面今天没有主机底线(已知限制)**:启用的对端按 `url` / `cardUrl` 取卡、按卡里写的服务端点发送,不过任何部署主机底线(本服务今天不给引擎接它);`url` / `cardUrl` 是运维写的,可指向任意主机(含内网与回环),不带头的对端(这次发送不带任何声明的头)的服务端点由它的卡写、可指向任意主机、遇重定向照跟(带头的对端另受引擎的端点绑定:服务端点须落在声明的 `url` / `cardUrl` 所在的源上,且不跟重定向);取卡发生在每次任务准备与会话 A2A 面板缓存缺失 / 过期时,起服本身不取卡;多租户部署同样挂(多租户闸只关请求体自带的 `a2aPeers`,部署基线照挂)。**谁受伤**:在多租户 / 公共部署里写了 `config.d/a2a.json` 对端的运维 —— 不带头的对端,它的卡能让引擎去敲内网地址。**补偿**:只写可信对端、自审 `config.d/a2a.json`;出路 = 部署主机底线接线(尚未到货)。
+    **升级前做**:本地配置根 `ls config.d/a2a.json`;留下的对端逐个确认可信(见上一条披露)。**回滚**:回到 7.146.x 后 `config.d/a2a.json` 又不被读(读腿点名),中心腿回到透传。
+
+23. **目录条目的 `thinkingLevelMap` 开始生效(坏形整条丢);anthropic 条目的 `compat` 按线路生效;`GET /v1/models` 行加 `thinkingLevelMap`(行为变更 + wire 加性;部署零动作,升级前自查目录)**:
+    旧形(7.146.x):条目带 `thinkingLevelMap`(合形也算)⇒ 契约包读腿把它当未知键剥掉并告警(`unknown-keys-dropped`),**本服务把该告警判成域失败 ⇒ 整份候选拒**(本地 `config.d` 起服回落 env,env 也没配模型即零模型 `config_local_no_models`;中心腿停在上一份好配置),声明到不了引擎;anthropic-messages 条目的 `compat` 一律整只丢 + 一条 `model_compat_dropped`。
+    新形:契约包 20.0.0 判 `thinkingLevelMap` 的形(键 `off` / `minimal` / `low` / `medium` / `high` / `xhigh` / `max`,值非空串或 `null`),合形原样交引擎(串 = 那一档发的值,`null` = 那一档不支持;当前引擎只在 openai-completions / responses 条目上读它,anthropic-messages 条目上原样带、零效果),
+    坏形(未知键 / 非对象 / 空串 / 非串非 `null`)⇒ 那一条被读腿丢(`entry-dropped`);被 `roles` / `atMention.only` / `tierGroups` 引用的条目坏了 ⇒ 契约包把整个 `models` 域读成缺省(`domain-defaulted`),本服务把它判成域失败 ⇒ 整份候选拒(本地 `config.d` 起服回落 env、中心腿停在上一份好配置)。env 腿没有这一席。
+    条目里写了本契约版本不认识的键(`thinkingLevelMap` 自己的键是闭集,那是上一句的坏形,不是这里):7.147.0 仍整份候选拒(读腿剥键告警,本服务判成域失败);自 7.148.0 随 settings-schema 22.0.0 起,允许逐条丢弃的域里持键层为数组元素的未知键 ⇒ 该条目丢弃(点名),其余域不变。
+    anthropic-messages 条目的 `compat` 读 `thinkingMode`(`budget` | `adaptive`)/ `effortLevels` / `supportsTemperature` / `contextManagement` / `interleavedThinking`;写了 openai 线路的键(`thinkingFormat` 等)照旧整只丢 + warn。
+    `GET /v1/models` 行加可选键 `thinkingLevelMap`,anthropic 行可带 `compat`;声明了的行上 `supportsThinkingOff` / `supportedEffortLevels` 随声明变。
+    **谁需要**:端点某档关不掉 / 换名的部署,adaptive / effort 族 anthropic 端点。**谁受伤**:① 目录里写过 `thinkingLevelMap` 的(此前整份候选被拒、没有装上,见旧形)—— 坏形的那一条升级后被丢,被引用时整份候选被拒(停在上一份好配置 / env);合形的见 ②;
+    ② 写过合形的 / anthropic 条目写过 anthropic 键 `compat` 的 —— 升级后请求形变(该档的值换成声明的拼写、`adaptive` 不再带 `budget_tokens`、`supportsTemperature: false` 丢调用方 temperature);
+    ③ 按封闭 schema 严格校验 `/v1/models` 行的消费方。**补偿**:读腿告警 / `model_compat_dropped` 点名条目;删掉那个键即回到 7.146.x 的读数。
+    **升级前做**:在 `config.d/models.json` 与配置中心目录里查 `thinkingLevelMap` 与 anthropic 条目的 `compat`;坏形改合形或删掉,不想升级后生效的删掉。**回滚**:回到 7.146.x ⇒ 带 `thinkingLevelMap` 的目录整份候选被拒(本地 `config.d` 回落 env、中心腿停在上一份好配置),回滚前先删这个键;anthropic 条目的 `compat` 回到「整只丢」。
+
+24. **hook 条目的 `rewakeMessage` / `rewakeSummary` / `cloud`(command;`cloud` 也在 http)与 `continueOnBlock`(prompt)由新提交 400 变受理,本服务如实带、不执行;续跑重放读出存量里的这几键(行为变更;部署零动作)**:
+    旧形:7.135.0–7.146.x 新提交带这几键 ⇒ `400 request.body_shape`(`unknownKeys` 点名);续跑重放的存量请求里它们被读者剥掉。
+    新形:契约包 20.0.0 承运并判形(`rewakeMessage` / `rewakeSummary` 非空串、`continueOnBlock` 布尔、`cloud` 任意值),在各自的归属型上受理;本服务的执行器不读它们(唤醒文本不加前缀、`cloud` 写什么都照跑、`continueOnBlock` 不改阻断结局)。
+    写在别的条目类型上照旧 400。能力位 `settingsContract.hookEntryFields` 的列随之多这四键。
+    **谁需要**:原样投影宿主设置文件的调用方。**谁受伤**:① 以为写了就生效的调用方;② 升级前停驻的任务:存量请求(只可能来自 7.134.x 及更早)里三键写了坏值(空串 / 非串 / 非布尔)⇒ 读者判坏块,
+    续跑**拒**:这条车道本会采纳请求体 hooks(单用户车道)⇒ `409 resume_blocked_by_policy`(`blockedBy: "request.field_invalid"`,`field: "settings.hooks"`;句子只点名成员键,不回显值),卡 / 任务仍待决、行不动;不采纳请求体 hooks 的车道(多租户)零变化(同第 20 条)—— 续跑重读的一次性迁移不接这一形。
+    `cloud` 不同:它没有坏值,读者不读它的值;存量里 `cloud` 的值藏着守卫迹象(契约包分类器的判法:以 `PreToolUse` / `PermissionRequest` 为键的成员、匹配器形的对象,嵌多深都算)时读者整份拒,
+    续跑重读的一次性迁移在窗内把这只 `cloud` 剥掉、同一份 hooks 照采纳(运维日志 `hooks_read_as_before_upgrade` 点名被剥坐标)—— 与升级前同读。
+    **补偿**:能力位与契约附录明写不执行;不加窗、不加旋钮。
+    **升级前做**:有 7.134.x 及更早停驻、hooks 里写着这几键的任务,升级前把它们跑完或取消(否则续跑被拒,见上)。**回滚**:回到 7.146.x 即回到「新提交 400、续跑剥掉」。
+
+25. **`DB_BACKEND=local`:会话同步干跑 `POST /v1/sessions/:id/sync/plan` 对仍带属主戳的存档,按 id 分类出 fork / stale 时直接答 `409 conflict.session_archive_stamped` + 固定句,不再答 `200` + `relation`(wire 加性:干跑多一口答该码;行为修复;部署零动作)**:
+    旧形:干跑只读两边的 id 集合并分类、不问存档带不带戳 —— 带戳存档上 fork / stale 答 `200` + `relation`,而同一份 id 集合的真推送在第一阶段就被 `409 conflict.session_archive_stamped` 早拒(7.145.0 节第 1 条):干跑说「分叉了,可带同意去推」,推送说「删掉会话再推」。
+    新形:干跑问第一阶段同一只早拒判官(按没带同意问;体里没有「同意」位),带戳 ⇒ 同码同体(体只有 `error` / `errorCode`,不带 `relation`);不开暂存、不拿租约、不写存档。`fast_forward` / `identical` / `fresh`、匿名存档与 SQL 后端上的 fork / stale、分区会话(委派子代的转录),干跑照旧 `200` + 关系体。
+    干跑这一读是「此刻读」(不持锁):提交里持锁的那一问仍是权威。带同意的同一推送第一阶段受理、提交里被同一只带戳判以同码拒,所以带戳存档上干跑答这个码对两种推法都是实话。
+    **谁需要**:先调干跑再决定推不推的壳 / SDK 在 local 部署的带戳存档上(起服 warn `local_archive_kept_stamped` 点名过的会话):当场读到出路,不再先问用户保留哪边。
+    **谁受伤**:把干跑当「永不 409 的纯读分类」的客户端(已装 SDK 24.0.0 的 spec 与注释这样写)—— 这两形它们读到 409 而不是 `200` 关系体;把非 2xx 一律当「服务不可用」重试的逻辑会白重试(确定性拒,重发同答)。
+    **补偿**:按码 `conflict.session_archive_stamped` 分支,体的 `error` 即出路(`DELETE /v1/sessions/:id` 后重推);按状态 409 分支的不受影响。
+    **SDK 锁步前的读法**:已装 SDK 的 spec 与注释仍写「plan 永不 409」(锁步版本改注与 spec);在 SDK 锁步版本之前,`pushSessionBundle` 的第一步是干跑 —— 对 local 部署上带戳的目标,它第一步就读到这个 409(SDK 映射为抛错,此前返回 conflict 结果,用户当时拿到的是「保留哪边」的问题,带同意重推后才在提交里读到同一个码)。
+    **升级前做**:无。**回滚**:回到 7.146.x 即回到「干跑只读 id 集合」。
+
+26. **停驻补投帧的整条字节预算:收件条目的扩展键按 UTF-8 字节量,越过最窄后端的 `payload` 列宽(65,535 字节)⇒ 补投帧是最小形并带 `payloadTruncated { droppedKeys, bytes }`(行为修复 + wire 加性;部署零动作)**:
+    旧形:停驻收件条目(下一次开流 drain 出的 `task_notification` / `workflow_complete` 补投帧)的扩展键只有逐成员的界;多枚满界文本位、多字节文字或控制字符转义一放大,MySQL 协议后端上那一条入箱失败(通知丢,只剩一行服务端日志),PostgreSQL / File 照存全形。
+    新形:三种后端同一个预算(最窄后端的 `payload` 列容量;按 UTF-8 字节量)。装得下 ⇒ 帧形逐字同上一版;装不下 ⇒ 补投帧只带去重键位(`task_id` / `task_type` / `status` / `seq` / `attempt` 里带着的那几位)、归因侧记 `_sema_provenance`(带着且装得下就留)、`summary`、
+    `payloadTruncated { droppedKeys(被丢的键名,全形键序), bytes(全形扩展键的 UTF-8 字节数) }`,其余键缺席(`workflow_complete` 的去重键是 `runId`,只多 `payloadTruncated`)。
+    侧记自身也装不下 ⇒ 侧记也丢,且全形带归因成员(`_sema_provenance` / `agentMessage` / `crossSessionMessage`)时 `summary` 换成 `[payload over budget: summary withheld; see payloadTruncated]`、`droppedKeys` 末尾多一个 `summary`。live 腿(活流帧 / bg·resume 账本行)不变。
+    **谁需要**:park 的耐久投递 —— 停驻的完成在任何后端上都在下一次开流时到达。**谁受伤**:越界的停驻通知在所有后端上收最小形(侧记也越界的那一形连摘要原句也扣下);PostgreSQL / File 部署在这一尺寸段此前收全形。按帧上未知键报错的消费端要认这一键。
+    **补偿**:帧上点名丢了什么;去重键位全在;同一次完成的活腿帧照旧全形;运维计数 `server.workflow-completion-inbox.payload-over-budget`。
+    **升级前做**:部署零动作。消费端:`payloadTruncated` 在场 ⇒ 按「这一帧的扩展键被裁」渲(`summary` 照渲、点名缺了哪些)。**回滚**:回到上一版即回到「无整条预算」;已入箱的最小形条目两个家族不同:
+    `task_notification` —— 上一版 drain 把 payload 整只铺回帧上,`payloadTruncated` 与侧记照带(老消费端忽略未知键;已换成受信句的 `summary` 在列里,照出);
+    `workflow_complete` —— 上一版 drain 只读 `completionId` / `diagnostics` 两键,`payloadTruncated` 回滚即消失,帧上只剩 `runId` / `status` / `summary`,披露丢失(通知本身照到)。零 DDL、零一次性迁移。
+
+27. **缺省模型检查的拒启句(`MODEL_ID is required when no catalog default resolves [config.default_model_missing] …`)在「本地候选整份被判官拒、回落 env、又没有 `MODEL_ID`」时,同一行多一段回落原因:被拒的文档名、拒码、原因类词与文档路径;句首的 grep 锚不变(拒启句 / 日志加性;部署零动作)**:
+    旧形:这一句只说「这张表没有缺省模型」+ 二选一的出路,不说这次为什么走的是 env 腿 —— 点名被拒文档与悬空符号链接的只有先出的 `config_candidate_rejected` warn 行。
+    新形:判官整拒了候选(`config.d` 里某份文档悬空链接 / 坏 JSON / 空 / 不是对象 / 太深 / 读不出,或某个域判形失败,或退役域文件)时,句子在 `(every enabled catalog entry …)` 那一段之后多 `(the config candidate was rejected whole … — rejected: "<文档名>" [<拒码>] <原因类词>: <文档路径> | …)`。
+    只带机读字段:原因类词是闭集常量(`dangling symbolic link` · `unreadable` · `parse error` · `empty file` · `not a JSON object` · `nested too deep` · `retired domain file` · `the domain failed its schema`),文档路径是 `<配置根>/config.d/<域>.json`(本地配置源才有)。
+    **不带**链接指向的目标路径、不带配置值、不抄契约 / 读腿的原句 —— 那些只留在 `config_candidate_rejected` 行。`config_candidate_rejected` 行的 `errors` 每条多一个键 `kind`(闭集词 `schema_invalid` · `empty` · `parse_error` · `not_object` · `too_deep` · `retired_domain` · `dangling_symlink` · `unreadable`,即上面各短语的机读形;日志加性)。没有被拒候选的拒启(纯 env、候选被收下)整句逐字不变。
+    **谁需要**:模型只配在 `config.d/models.json`、没设 `MODEL_ID` 的部署碰上候选被整拒,和只渲引擎原句的壳。**谁受伤**:对拒启句整句做精确相等匹配的脚本(只在候选被整拒这一形上变长)。
+    **补偿**:按句首锚 `MODEL_ID is required when no catalog default resolves [config.default_model_missing]` 前缀匹配,或读 `config_candidate_rejected` 行。**升级前做**:无。**回滚**:回到 7.146.x 即回到不带回落原因的句子。
+
+28. **嵌入方类型面:`StoreBackend.retention` 改形 —— 入参 `{ taskAttachmentTable, taskListTables, logger? }` 不变,返回从 SQL 留存店类改为执行器面(破坏性三方法的 `audit` 必填);服务内的字节口 `BlobBackend` 四方法收成三只字节方法(包根不导出;零 wire、零表、零存储格式;部署零动作)**:
+    旧形:`retention?(opts): SqlRetentionStore` —— 三只破坏性方法收 `{ domain, cutoffMs, audit? }`,`audit` 类型上可选、缺席时运行期抛;`BlobBackend` = `putBlob` / `getBlob` / `hasBlobs` / `deleteBlobs`,后两只带索引语义。
+    新形:`retention?(opts): RetentionExecutor` —— `listRetentionDomains()` / `previewRetention({ domain, cutoffMs })` / `expireCheckpoints` · `deleteExpiredSessions` · `deleteOrphanToolResults`(各收 `{ domain, cutoffMs, audit }`,`audit` 必填,
+    `{ mode, policyDays, fencingToken }`)/ `retention`;`deleteExpiredSessions` 的回执照旧在有结束了的空间时多 `endedSpaces`。`BlobBackend` = `put(key, bytes)` / `get(key)` / `delete(keys)`(只搬字节;在不在、孤儿、宽限窗、内容寻址校验在索引的属主)。
+    **谁需要**:把 SQL 店目录逐字搬进引擎侧包的那一步(执行器入参与引擎的 `{ domain, cutoffMs }` 同形;部署的表经事务内钩参与)。**谁受伤**:自己实现 `StoreBackend`(带 `retention`)或直接调 `backend.retention(opts)` 的嵌入方 ——
+    返回型与入参型的名字变了,经执行器类型漏传 `audit` 是编译错;经引擎契约类型调用照旧在运行期当场拒(与修前同);改本仓源码、自带 `BlobBackend` 实现的人。
+    **补偿**:实现方让 `retention` 返回一只带上面六个成员的对象(与本仓 SQL 后端的组合同形);调用方每次破坏性调用带上本轮的 `audit`。字节口实现只剩三只方法:`hasBlobs` / `deleteBlobs` 的索引语义交给索引属主。
+    **升级前做**:无(零表、零存储格式、零 wire)。**回滚**:回到上一版即回到旧形(代码面,无数据面)。
+
+29. **决断类续跑入口上这一行自己的拒答行上 `rowVerdict.code`:任何门同一个码 `checkpoint.invalid_outcome`;`approval_binding_mismatch` / `resume_outcome_invalid` 只给真有成因的拒;订正 7.124.0 节第 14 条「没有 `field` 的拒逐字维持 `approval_binding_mismatch`」半句(wire 码变;按码分支的客户端改读法;部署零动作)**:
+    旧形:一张停驻行被引擎的行判官判续不了(例 `reason: "requirements_damaged"`)时,运维队列 / 收件箱行上 `rowVerdict.code` 是 `checkpoint.invalid_outcome`,决断类入口却按门借码 ——
+    `POST /v1/approvals/:id/decide` 上答 `409 approval_binding_mismatch`(没有 `field`)、`/v1/assistant/tasks/:id/plan_review` 与 `/resume` / `/v1/sessions/:id/wake` 上答 `409 resume_outcome_invalid`;
+    决断口上存储体读不成检查点答 `409 conflict.checkpoint_unreadable`,存储体 `{}` 等门类读不出 / 别的门上的坏行答 `409 gate_not_tool_approval`。引擎在 `policy_ask` 门上不带判别位的拒也借 `approval_binding_mismatch`。
+    新形:有决断成因的拒照旧(引擎点名绑定席 ⇒ `approval_binding_mismatch`;点名决定体的别的格、或审阅门上不带判别位的内容拒 ⇒ `resume_outcome_invalid`);其余一律 `409 checkpoint.invalid_outcome` ——
+    这一行自己的拒(体顶层 `reason` 在场,码与行上 `rowVerdict.code` 同一只判官、同一个判决,`error` 以行上 `rowVerdict.sentence` 开头)与引擎不带判别位 / 带本服务不认得的 `field` 的拒。决断口在门型守卫之前先问这一行:行坏了就答行的拒,行好才指门;
+    存储体读不成检查点的那一形同答行的拒(店的别的失败仍 `conflict.checkpoint_unreadable`)。更新引擎停驻、门类本版不认的行在决断口答 `409 checkpoint.unsupported_version` + 两版本键(此前 `gate_not_tool_approval` 指错门)。
+    `retriable: true`(卡仍 pending、行字节不动)、`reason` / `thrownName` / `field` 原样:续跑腿上与修前同;决断口两早退臂此前不带 `reason` / `retriable`,本版带上。
+    **订正 7.124.0 节第 14 条**:那一条「决断口的 409 不再借名」子条里的「没有 `field` 的拒(含 core 的行完整性拒,例 `read_face_damaged`)逐字维持 `approval_binding_mismatch`」自本版起不成立 —— 那些拒答 `checkpoint.invalid_outcome`;
+    同一子条前半句「`approval_binding_mismatch` 只说绑定变了(重取坐标再决)」自本版起才名副其实。已发段原样留着。
+    **谁需要**:按码分支的客户端 —— 「这一行续不了」与「绑定变了 / 改那一格」按码就分得开。**谁受伤**:对 `approval_binding_mismatch` 一律重取坐标再决、对 `resume_outcome_invalid` 一律提示改那一格、按 `gate_not_tool_approval` / `conflict.checkpoint_unreadable` 处置坏卡的客户端:坏行上拿到新码。已把 `checkpoint.invalid_outcome` 与 `approval_binding_mismatch` 并成一臂的客户端码面零变化、行为照旧 —— 本版的分因要它们拆开那一臂才看得见。
+    **补偿 / 升级前做**:客户端加一臂 `checkpoint.invalid_outcome`(已与 `approval_binding_mismatch` 并成一臂的拆出来),按体顶层 `reason` 在不在分两形 —— 在场 = 这一行自己的拒:按 `reason` 与 `error`(= 行上 `rowVerdict.sentence`,出路是作为新任务重提;停它的那一版 worker 也许还能续)呈「这张卡续不了」,不再重取坐标;
+    缺席 = 引擎没点名哪一格的拒(带本服务不认得的 `field`〔原样上 wire,引擎新加的格〕,或与决定体无关的引擎内部拒):卡仍待决,出路读 `error` 句,同样不重取坐标;
+    行上 `rowVerdict` 非 `ok` 的卡本就不该呈批准。按前缀 `checkpoint.*` 兜底的客户端零改。**回滚**:回到上一版即回到按门借码;数据零改动。
+
+30. **一次性迁移 M9 退役:park 指针索引改主键的启动期迁移连同它的读侧半场删码;随包排空判据 `workflow-park-holder` 少一条(持久数据面;行为变更;同一批存量卡的 409 码换了;运维日志形变更;嵌入方 BREAKING,类型面)**:
+   7.118.0 引入的一条一次性迁移,窗(发布日 2026-10-07 + 30 天)于 2026-11-06 关,本版删了它的码 —— 写半场与读侧半场(同一件事「引擎 7.43 及以前写下的 workflow 子代停驻记录」)同窗同删。M10–M12 的窗 2026-11-07 … 11-08 关,本版不动,随后续版本窗关即删。逐处删了什么、删后存量形由谁接住:
+   - **写半场**:SQL 起服不再把 `workflow_agent_session`(workflow park 指针索引,派生投影)的主键由 `(session_id)` 改成 `(session_id, run_id)`(暂存表复制 + 原子换名那一整套连同暂存表 `workflow_agent_session_m9` / 待删旧表 `workflow_agent_session_m9_old` 的收尾删除)。
+     删后仍是旧主键的库(从 ≤ 7.117.x 直接升到本版、中间没在 7.118.0–7.146.x 任一版起过服),指针写口(冲突目标 `(session_id, run_id)`)两方言各自落败:TiDB / MySQL 的 `REPLACE INTO` 按单列主键整行替换 —— 同一个子会话只剩后写的一枚指针,续跑链 / 分叉里后写的记录覆盖先写的,判决只看得到一条记录(分叉判不出、链尾可能被更早的记录盖掉);
+     PostgreSQL 的冲突目标没有可仲裁的唯一约束 ⇒ 指针写失败(响亮)。没有响亮的起服臂。
+     出路:运维手工照中央 DDL 重建这张表(派生投影,丢了只丢升级那一刻还停驻着的旧卡的指针),或先在一只 7.118.0–7.146.x 的版本上起服一次再升本版。`DB_BACKEND=local` 的索引是账本、没有主键,这一半对它本来就是空转。
+   - **读侧半场**:路由里「点名子会话的条目没有持有者位(引擎 7.43 及以前写下)」的专读臂删除。删后这样的存量卡路由判 `none`、落 legacy 腿,答 `409 conflict.resume_context_unavailable`(响亮;成因是子会话没有续跑上下文)—— 不再答 `409 decide.workflow_parks_unreadable`、句子里「更早的引擎版本」那一说随之没了;出路不变:续跑发起它的那条 workflow run。
+     `decide.workflow_parks_unreadable` 自此只有一种成因:某一条点名这张卡的记录的停驻列表读不出(条目形坏 / 这一份在场却不是列表),一句拒文,体键不变(`runId`、在场才带的 `readableHolderRunId`)。`DB_BACKEND=local` 同样适用(路由是同一只)。
+   - **随包排空判据**:两份 SQL 与 `drain-check-local.mjs` 去掉 `workflow-park-holder`(local 脚本的判据表少一条,末行 `WORKFLOW-PARK-HOLDER` 与命中行 `WORKFLOW-PARK-ROW` 不再出)。要在 7.118.0 那条边界上数这些卡,用 7.118.0–7.146.x 任一版包里的同名判据。
+   - **运维日志**:起服行 `one_time_migrations_applied` 与被打断时的 `one_time_migrations_interrupted` 去掉 `workflowParkIndexKey` / `workflowParkIndexRowsCarried` 两个读数字段(`removableAfter` 读数去掉 `M9` 一个键,`note` 不再叙述它)。按这些字段做告警或看板的规则要改。
+   - **嵌入方(类型面)BREAKING**:`StoreBackend.runOneTimeMigrations()` 的返回型 `OneTimeMigrationReport`(经包根导出的 `StoreBackend` 可达)去掉 `workflowParkIndexKey` / `workflowParkIndexRowsCarried`;读它们的代码、把值标成 `OneTimeMigrationReport` 再写这些键的对象字面量 tsc 红;
+     自实现该方法、未标注类型就直接返回含这些键的字面量的代码 tsc 不报(多出的键没有人读),也请一并删掉。
+   - **谁需要**:所有部署 —— 起服少走一步、排空判据少一条。
+   - **谁受伤**:① **跳版升级**:从 ≤ 7.117.x 直接跳到本版的 SQL 库 —— 仍是旧主键(TiDB / MySQL 上指针被整行替换、PostgreSQL 上指针写失败;上面写半场一条);② **升级那一刻还停驻着、由引擎 7.43 及以前写下的 workflow 子代卡**(7.118.0 起新写的记录恒带持有者位;`APPROVAL_TERMINAL_BACKSTOP_MS` 调长的部署或从 ≤ 7.117.x 直跳的部署才可能还有)——
+     决定口的 409 码由 `decide.workflow_parks_unreadable` 换成 `conflict.resume_context_unavailable`,按那一码做分支或按「更早的引擎版本」那句话匹配的客户端 / 告警要改;两者都是响亮的 409、卡仍 pending、什么都没投递;③ 按上面日志字段做告警的运维。
+   - **补偿 / 做法**:**表形**(① 那一类):跳版升级的库先在 7.118.0–7.146.x 任一版上起服一次再升本版,或升级后运维手工照中央 DDL 重建 `workflow_agent_session`(排空卡改不了主键)。**存量卡**(② 那一类):升级前把它们决掉或取消(数法见旧包判据 `workflow-park-holder`),或升级后续跑发起它的那条 workflow run 再决。**升级前做**:常规从 7.146.x 升级、没有 ② 那批卡的部署无须动作;**回滚**:回到 7.146.x 即恢复旧读法与旧判据,本版没有写任何新的存储形。
+
 ## 7.146.0 —— ① 引擎首次附着前的宽限 `ENGINE_FIRST_ATTACH_MS`(缺省 180 s):从没被非探针请求碰过的引擎要等 `max(ENGINE_LINGER_MS, 本值)` 才自退;`/health.engineLease` 多一格 `firstAttach`(行为变更 + wire 加性;部署零动作) ② 设备 WS 未鉴权握手的 per-remote 帽可按真实对端计:新旋钮 `DEVICE_TRUSTED_PROXY_CIDRS`(可信代理名单,缺省空 = 今日行为);帽键统一为地址规范形;提货 settings-schema 17.1.0(安全轴,fail-closed;新旋钮 + 日志 / 指标加性;部署零动作) ③ SQL 记忆腿(`MEMORY_ENGINE_BACKEND=pg|mysql`)兑现 core 的落点问询协议(`admitsLandings` / `opts.admit` / `opts.confirm`):在这两条腿上驱动 core 记忆整合时,写闸判的是真正落下的拼写,此前传进来的第二参被静默丢掉(行为变更;部署零动作) ④ TiDB 记忆腿(`MEMORY_ENGINE_BACKEND=mysql`)上 stale `baseRev` 的 update 改按契约报冲突:对手恰好把行写成与本次 update 逐字节相同的目标态时,此前报 applied,现与 PG 腿同答冲突并带 `currentRev`(行为修复;部署零动作) ⑤ 随包文书补全与订正:停机上界契约句、`blocked` 终局的用户面是 `terminal.detail`(点名 cli · web-admin · client-core 渲染层)、hooks 托管标签由调用方自报且失败方向只收紧、server-as-peer 启动日志行、场景面收窄写法、坏行降级形的键集(文字订正;零行为变更;部署零动作) ⑥ `local_roots_split` 起服告警只报「一声不响的分家」:显式给了 `CONFIG_LOCAL_DIR`(等于数据根 = 合一,不等 = 有意分家)即视作运维已表态,不再每次起服响;推导的配置根 ≠ 数据根照报(行为修复;日志面;部署零动作) ⑦ 在飞 run 并发帽:新旋钮 `RUN_MAX_CONCURRENT`(本副本全局)与 `RUN_MAX_CONCURRENT_PER_PRINCIPAL`(同一已验提交主体),缺省 `0` = 关;新提交超帽 ⇒ 429 `limit.rate_exceeded` + `reason: "run_concurrency_cap"` + `Retry-After: 5`(行为加性,缺省关;wire 加性;部署零动作) ⑧ 硬断预告:自 7.147.0 起每个部署都要显式声明执行车道(`REMOTE_EXEC`;`CONFIG_PROVIDER=local` 形下 `config.d/remote-exec.json` 也算),未声明拒启;车道词 `none` 取代词表外的状态名 `in-process`;`REQUIRE_EXECUTION_LANE` 退役(预告;本版零行为变化、零 wire 变化;部署零动作,但 7.147.0 的升级路径上有三件事要提前排) ⑨ 更正 7.144.0 节第 1 条与 7.137.0 节第 15 条的出路句:`corrupt_session` / `invalid_session` 的出路里没有「从断点之上的条目分叉」—— `POST /v1/sessions/:id/fork` 不选条目,对结构坏的会话也不是出路(文字订正;零行为变化;部署零动作) ⑩ 起服告警 `memory_engine_dir_defaulted` 改名 `memory_engine_dir_outside_data_root` 并改按路径包含判:file 形记忆引擎的已解析根不在本机数据根(`config.localDataRoot`)之下才报,句子带两条真路径;`MEMORY_ENGINE_DIR` 缺席不再是判据(行为修复;日志面,日志事件改名(旧名退役;壳 / 编排脚本按新名读)) ⑪ 单用户部署上 `GET /v1/diagnostics/wiring` 与 `GET /v1/outcomes` 也先问运维名册:名单为空且没写 `OPERATOR_SINGLE_USER=true` ⇒ 两口答 501;单用户部署的具名名单对 `GET /v1/outcomes` 也生效(安全轴,fail-closed;行为变更;名单为空的单用户部署要这两口写一行 `OPERATOR_SINGLE_USER=true`) ⑫ 后台子代状态 `agentState` 过 wire 的读法成文并钉死,订正 7.116.0 节「未核」一句:哪些应答带它、哪些不带(缺席是引擎的选择);持久子代行读口的状态是 core 同一只读器的产物,停驻行的审批卡读作 `unreadable`(文字订正;零行为变更;wire 零变化;部署零动作) ⑬ 收编批量导入:源主体把本机会话导进收编目的地 `POST /v1/adoption/:id/sessions`,能力位 `adoptionImport`(按调用方 present-iff)给出 `:id` 与两只帽;两根新旋钮 `ADOPTION_IMPORT_MAX_SESSIONS` / `ADOPTION_IMPORT_MAX_SESSION_BYTES`(新面;wire 加性;部署零动作) ⑭ hooks 托管车道成为任务座上自己的一张引擎注册 `settings.hooks.managed`:引擎 handler 预算(`HOOKS_TIMEOUT_MS`)每车道一份,非托管钩子吃光自己那份挤不掉托管钩子;托管车道被自己的预算叫停记 `hook_managed_unrun{budget_exhausted}`;`Stop` 上 `continue:false` 只撤本车道的推回(安全轴,失效关闭;行为修复 + wire 加性:新注册名;部署零动作,按注册名字面读的读者见本条「升级前做」) ⑮ 请求面压缩开关:`settings.autoCompactEnabled`(布尔)逐字交给引擎的自动压缩座 `compaction.autoCompact`,能力位 `taskSettings.autoCompactEnabled`;键缺席时与旧形逐字相同(wire 加性;部署零动作) ⑯ 请求的 `settings.env` 不收凭据:名字是本引擎的凭据变量或值是秘密形 ⇒ 新提交 400 `request.env_credential_refused`;升级前停驻的任务窗内续跑时剥掉照续(安全轴,fail-closed;wire 新码;调用方动作:凭据挪进引擎进程的环境;部署零动作) ⑰ 错误码目录加「码族」列:契约附录 A 每个码恰属五族之一,消费端按列读、不再各抄码表;`wire-changes` 清单多一集 `errorCodeFamily`(契约列加性;应答体零变化;部署零动作) ⑱ 会话记忆状态报出引擎记忆写家:带层座(`?scope=`)时多一个可选键 `writeHome`(那只店的引擎答案,绝对目录,字节原样),不带层座时多一个可选键 `planes`(逐店明细里引擎答的 `writeHome` 原样透出),单用户 `host` 车道在场、其余车道缺席,与能力位 `projectContext` 同一只射程谓词(wire 加性;部署零动作) ⑲ 🔴 引擎 7.62.0 → 7.63.0:升级前停驻的工具审批行在本版上续跑不了(`409 approval_binding_mismatch` + `reason: "requirements_damaged"`,升级前先排空;混跑期两版互拒对方停驻的行)· 规则导入回执的引擎拒成员按落没落分 `refused` / `indeterminate`、`reason` = 引擎拒因码(`store_refused` 退出)· 记忆收紧(`userlocal:` 族不复制、v2 下保留前缀的折叠拼写拒、hipaa / zdr 否决记忆整理、店集只算写过的个人店、公告队列文件坏了响亮拒)· 停驻行成员形不对即判坏、`DB_BACKEND=local` 的审批列表不再因一行坏字节整张 503 · 后台 fork 子代进委派分区 · 本进程停驻的赎回完成回停驻车道 · 用户面通告加两码(行为变更 + 硬破坏两条;wire:两通告码加性、一回执词退出;升级前先排空待决工具审批卡) ⑳ 🔴 本进程删过的会话 id 只再执行给删前的属主:另一位属主在本进程用同一个 id 起执行(新提交、续跑、唤醒、停驻赎回)⇒ `409 conflict.session_id_retired`(续跑家族 `409 resume_blocked_by_policy`),什么都不跑(安全轴,fail-closed;wire 新码;行为变更;部署零动作) ㉑ 嵌入方类型面:服务型 `ServiceWorkflowJournalStore` 的可选成员 `deleteByRun?` 删(journal 只剩按龄清扫一条删路);`ServiceConfig` 多七个必填席(各由 `loadConfig` 从本版新旋钮铸出);检查点店与 workflow journal 店的源文件换了目录,包外本来就 import 不到(嵌入方类型面 BREAKING 两处;零 wire、零表、零存储格式;部署零动作) ㉒ k8s 沙箱 Role 的 `persistentvolumeclaims` 四动词与 `secrets` `create` 改按特性开关授:随包 chart 缺省不再渲这两条规则,设了 `WORKSPACE_CACHE=volume` / `K8S_SANDBOX_ENV` 的存量部署要在 values 里开对应开关(或手写 RBAC 补规则)(部署面;行为收紧;两个旋钮都没设的部署零动作) ㉓ 🔴 引擎 7.63.0 → 7.64.0:会话帧与会话盒按住客投 —— 删后同 id 重建的后任不再收前任后台工作的完成、信与回执(弃一条在运维席说一次 `delegation.delivery_discarded`),升级前让旧副本排空会话盒、混版副本共一只信箱时旧副本领不动装着本版记录的盒、本版副本弃掉旧副本写下的记录 · File 记忆店的「绑定之前」账本形退役(先用上一版引擎开一次)· 共用一只记忆控制面的副本一起升级 · 停驻行三处判坏 · 规则提议里无 kind 的批成员整批丢 · 兑付腿店故障只在店没变时可重试 · 规则导入成员结局不知 ⇒ 503 同票重走 · 一次性迁移 local 腿读得更全 · 拒绝回显上帧(行为变更 + 硬破坏三条;wire:一帧键加性;升级前先排空会话盒) ㉔ 不报主体的 service 凭据可声明为无身份调用方:新旋钮 `SERVICE_TOKEN_ACTS_FOR_DEPLOYMENT`(缺省 `true` = 授权判定不变;`false` ⇒ fleet 读面 / 运维聚合口 / 写档对它收窄);`GET /health` 的 `auth` 加一键、运维口 401 operator 句改写(安全轴,opt-in;wire 加性 + 一句改写;零迁移;缺省部署零动作) ㉕ 🔴 自由文本脱敏:行首键形(YAML / INI / compose 的配置行 `password: <值>` / `PASSWORD = <值>`)是声明形的第四种 —— 值成记号;值是类型名(`str` / `string` / `SecretStr` …)时不是值(行为面;安全;脱敏产物变;部署零动作) ㉖ 引擎交接车道:壳退出的「Move to background and exit」—— 新口 `POST /v1/engine/handover` / `POST /v1/engine/attach`、能力位 `engine.handover`、新旋钮 `ENGINE_HANDOVER_LINGER_MS`(缺省 30 min);`/health.engineLease` 多 `lane` / `handover`;`exit-last.json` 用格式 3(`lane` 取代上一版的 `orphan`;第 1 条的首附着窗到期同由 `lane` 说)(新面 + wire 加性;留痕文件与日志键 BREAKING;部署零动作) ㉗ 一次性迁移 M6–M8 退役;M7 的拒臂留为按写者版本的永久门(持久数据面;行为变更;运维日志形变更;随包排空判据少一条;嵌入方 `OneTimeMigrationReport` 去三键〔BREAKING,类型面〕;没在 7.117.0–7.145.x 任一版起过服的 SQL 库先在其中一版起服一次)
 
 1. **引擎首次附着前的宽限:装了自退腿(`ENGINE_AUTO_EXIT` 开,或 `SEMA_PARENT_PID` 在场)的引擎,在起服以来还没有过任何非探针 HTTP 请求时,按 `max(ENGINE_LINGER_MS, ENGINE_FIRST_ATTACH_MS)`(缺省 180 s)判自退;`GET /health` 的 `engineLease` 加性多一格 `firstAttach { windowMs, since, attachedAt }`(行为变更 + wire 加性;部署零动作)**: