@prismer/runtime 2.2.55 → 2.2.63

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog — @prismer/runtime
 
+## 2.2.62 — 2026-09-23
+
+- **Session recall + grant-aware recall policy**：daemon 新增
+  `recall-policy-provider` / `session-recall`（会话记忆召回并入
+  `[Memory Context]` 的 `[Session Recall]` 段，保留 `via:'grant:<id>'` /
+  `sourceWorkspaceId` 授权来源标注）+ fallback 集成测试。
+- **Skill availability / loader / sync 收紧**：`skill-availability` 独立模块、
+  skill loader/source-resolution/sync 扩展与 sync rejection、slash 平台
+  toolsets 测试加固。
+- **Hermes native skill projection**：`native-skill-projection`（Hermes 原生
+  skill 装载投影）+ 投影测试。
+- **Turn protocol/runner 扩展** 与 pi components manifest
+  （`eaas-pi-components.manifest.json`）。
+- 镜像/载荷对齐：Hermes v2026.9.21（S6 commentary 交付门），
+  `infra/sandbox-image` 与 desktop engine payload 同步（本包不进 image
+  fingerprint，随 OTA bundle 分发）。
+
 ## 2.2.13 — 2026-08-17
 
 - ACS boot recovery fixes (merged via fix/acs-boot-recovery): manifest Pod
@@ -11,6 +28,563 @@
 
 ## Unreleased
 
+- Sandbox manager executes directly when already running as the target non-root
+  user, retaining sudo for cross-user launches. Restricted EaaS carriers use
+  image-prepared workspace, recipe and manager state directories without privilege escalation.
+
+- Add a scoped `asset-ingest` maintenance envelope to the one-shot turn runner:
+  exact task/run/source binding, no chat history or tool grants, and bounded,
+  digest-checked semantic products. Advertise `maintenance.assetIngest: 1` in
+  turn capabilities. Cloud admission/egress and final installed-bundle acceptance
+  remain required; a synthetic engine test is not provider execution evidence.
+
+- EaaS one-shot turns now seed validated conversation history into the real PI session, preserving principal images and assistant text without replaying historical tool calls. Previously the envelope history was ignored.
+- Add `turn capabilities` for explicit Cloud compatibility checks, and enforce shared history/image count and decoded-byte limits. Old bundles must not silently accept history-aware turns.
+- Local Runtime regression is recorded separately from signed-bundle deployment and real two-turn model acceptance; the latter remain required before release.
+
+### EaaS PI core HITL guidance and tool policy
+
+- Preserve the Cloud system prompt and add EaaS-only HITL `eaas-question`
+  guidance and ACL boundary instructions; prompt guidance is not authorization.
+- Add a PI core execution gate for bound tools: deny takes precedence, an empty
+  allow list denies all tools, and an optional trusted-host `authorize` callback
+  permits execution only on `true`, failing closed on errors.
+- Wire EaaS turn tool declarations into the runner's allow/deny policy, including
+  explicitly disabled tools. Absent declarations retain legacy default tools;
+  an explicit empty declaration list allows none.
+- These declarations are a per-turn snapshot, not a dynamic Cloud ACL/HITL
+  bridge. Allowing bash does not enforce a cwd jail or make the environment
+  read-only when write/edit tools are denied.
+
+### Workspace conversation/task overhaul — spec 11 closure
+
+- **Runs dispatch durability**：daemon 派发链完成 spec 11 T3/T4 收口——comment
+  续跑、Phase A 判型闸、一次性 nonce、run 级 dispatch outbox 重投、10 次重试预算与
+  `dispatch-undelivered` 终态可见性，避免 run 已生成但 chat 侧静默丢派发。
+- **Hermes/tool attribution honesty**：缺失 `detail.output` 的工具步骤不再渲染为空白，
+  统一显示 `[output not forwarded]`；有真实 output 的步骤保持原样。
+- **Org collaboration soul carrier**：内置身份上下文新增 `org-collaboration` section，
+  `team-manager` 升级到 2.2.0、`personal-assistant` 升级到 1.1.0，并保持 catalog /
+  runtime role template / source role template 三处 byte-identical。
+- **Task context for OKR execution**：dispatch context 新增 `[Active Key Results]`，
+  与 `[Active Goals]` / `[Active Objectives]` 同源注入，用于长线任务的 KR
+  baseline/target/current 验收依据。
+- **Grant-aware memory recall**：runtime `memory_search` / `memory_load` 接受
+  `sourceWorkspaceId`，session recall 可将授权来源并入 `[Memory Context]` 的
+  `[Session Recall]` 段，并保留 `via:'grant:<id>'` / `sourceWorkspaceId` 标注。
+
+### Hermes — S5 上下文连续性三件（docs/organization/specs/05 Task 1-3，daemon 侧）
+
+- **轮换播种回读（§3.4-1a / Task 1）**：`sessions-dispatcher` 抽出
+  `fetchSessionTranscript`（`GET /api/sessions/{id}/messages`，保留
+  `X-Hermes-Session-Key` + 5s `AbortSignal.timeout`，任何失败 resolve `[]`），
+  由抢救捞回与轮换播种共用。轮换铸新 session 且存在 previousSessionId 时回读老
+  transcript 尾部（`RESEED_TAIL_ROWS=8`），并入 FULL seed：行序**原样透传**——
+  `order=latest` 是「从最新往回取页、按插入序返回」（v2026.9.14
+  `hermes_state_messages.py:779` + `:817-818`），读到的本就是时间序，不得再翻
+  （评审 N-1：此前多翻一次，超帽时反而丢最新、留最老，恰是 A1/A2）。单行截断
+  `RESEED_ROW_CHAR_CAP=1500`、总量 `RESEED_TOTAL_CHAR_CAP=6000`（超帽自最老行起丢）、
+  与 envelope `recent` 去重（normalize 后各取前 120 字符做**相等**比较——评审 I-1：
+  双向前缀匹配会让一条短行吞掉同头的长行，白丢真实交换）。
+  `context-render` 新增可选 `HermesRenderOptions.transcriptTail`，以
+  `sender='transcript_continuity'` / `senderRole='system'` 追加进 `priorMessages`
+  （composer 按 createdAt 排序，天然落在压缩段之后、recent 之前，无需手工
+  unshift）；envelope 路径与 legacy `composeConversationContextXml` 路径均已透传。
+  首 turn（无映射）不回读，不额外发请求。
+- **复用路径周期性对账（§3.4-1b / Task 2）**：新增 `cloud-io.ts` 窄 IO seam
+  （`setHermesCloudIO`/`getHermesCloudIO`，照 `setHermesSessionMapper` 先例，
+  runner.ts 启动接线、shutdown 摘除；未接线时全部降级为静默 no-op）。每个复用
+  turn 终态后 fire-and-forget 对账：`%5` turn 且距上次 ≥30min 双护栏限频，取
+  本会话最后一条**本 agent 发的** `metadata.kind='agent_reply'`（`senderId ===
+  agentImUserId`，评审 I-3：多 agent 会话里锚他 agent 的 turn 会报出本 transcript
+  从未有过的「错位」，白付轮换 + 误导通知）的 `taskId` 作 anchor，要求它出现
+  在 transcript 的某条 user row 中且其后存在非空 assistant row。错位 → 发一条
+  `context_continuity_reconciled` `system_event`（`session:anchor` 键 100 条 LRU
+  保证恰好一次）+ invalidate 映射。**并对账的补种链闭合**：invalidate 会 DELETE
+  映射行、使下一 turn 与「首 turn」不可区分，故错位时先把被弃 session 停靠进
+  `pendingReseedSources`（按 conversation+agent 稳定键），下一 dispatch 一次性消费
+  ——补种回读与可见性事件因此都不断链。
+- **抢救 anchor 校验（§3.4-2 / Task 3）**：`recoverReplyFromSessionTail` 捞回的
+  assistant 行须同时满足三条才采用：归属 anchor（anchorIdx 扫描已保证，显式化）、
+  anchorIdx 与捞回行之间无**其他** per-turn anchor 的 user row（防跨 turn 交叉
+  落盘）、捞回行 timestamp 不早于 anchor 行（唯一能抓「上一轮被杀 attempt 的答案
+  晚落盘在本轮 anchor 行之后」的判别——晚到答案生成于上一轮，timestamp 必然更早）。
+  任一不过 → 返回 null 并 `stderr` 记 `recovery rejected:`，交给既有 loud
+  `empty_reply` 失败路径（宁空失败，不冒充本轮回复）；timestamp 缺失时降级为只查
+  前两条并在 stderr 记 `recovery_anchor_ts_missing`（可观测降级，不因缺证据拒绝）。
+- 三条路径全部 fire-and-forget：失败 log/stderr 留痕后吞掉，绝不向主流程抛错、
+  不阻断派发（负控已固化）。零 DB 迁移、无 wire 协议变更、无
+  daemon↔cloud 版本协商需求（seam 未接线 / 老 cloud + 新 daemon 均安全降级）。
+- 测试：新增 `sessions-dispatcher-transcript-reseed`（轮换播种正例 + 首 turn 不回读
+  + 去重 + caps + 读失败负控 + **envelope 路径正例**——补上生产路径此前无正例的
+  覆盖缺口，删掉 :1270 的透传该用例即红、其余全绿）、`sessions-reconciliation`
+  （错位恰好一次 + 对齐零调用 + N/间隔门 + seam 未接线 + 云调用失败吞错）。
+  `sessions-dispatcher-empty-reply` 追加 recovery anchor 校验组（晚到答案拒绝 /
+  本轮晚落盘照常采用 / 异锚插入拒绝 / 无 timestamp 降级留痕）。
+- 既有 immutable-release 规则下版本号 bump 与否由发版时判定。
+
+### Hermes — S5 压缩可观测 / 轮换可见性 / skill-sync 错峰（docs/organization/specs/05 Task 5-9，daemon 侧）
+
+- **压缩静默失败可观测（§3.4-3b / Task 5）**：`runBackgroundCompaction` 的四处**真
+  失败**——candidate GET 非 2xx / `compactSlice` 返回 `result.error` / projection 空
+  / segment POST 非 2xx——除既有 `traceLog` 外，现在还会 bump
+  `MemoryStageCounters.compactionFailed`（新增计数位，随 `/healthz`
+  `memory.counters` 暴露）。三处**正常门**（`no_conversation_id` / 历史不足
+  `COMPACTION_MIN_HISTORY` / `%N` 轮询门）保持 log-only，不计入失败位——门不是失败。
+  有 run 归属时另经既有 run/task event 通道 fire-and-forget 上云
+  （`type=COMPACTION_FAILED`、`payload.stage`），上报失败只 log 不再造失败。
+  **落点（T1-2b R1 修正）**：首版打的是 `POST /api/im/tasks/:id/event`，而
+  `ctx.taskId` 实际是**本轮派发的 run id**（registry `canonicalTurnId` = 线上
+  run id）——该路由是 task 作用域、拿 id 查 `im_tasks`，对 run id 空间回
+  `400 RUN_ID_ON_TASK_ROUTE`，又被 best-effort 的 catch 吞掉 ⇒ durable 上报在产
+  是**静默 no-op**，只有本地计数位真的动。现改投 run 作用域
+  `POST /api/im/runs/:runId/events`（assignee 经 `checkRunReadAccess`），
+  **仅**在该请求回 404 时重试一次 task 作用域路由——id 空间本就是双义的
+  （release202/09 §3.2：chat 派发带 run id、kanban task 派发带 task id、legacy run
+  保留裸 cuid），404 是它唯一的信号；非 404（403 身份 / 5xx / 不可达）不重试。
+- **轮换可见性 + FULL seed 诚实声明（§3.4-4a / §3.4-7 / Task 6+9）**：凡「铸新
+  session 且存在前一个 session」的轮换面（404 `session_not_found` 重入 / S10 空回复
+  轮换 / interrupt / 对账补种），fire-and-forget 发一条 `system_event`，文案统一为
+  诚实状态声明「上下文窗口已重建：更早的对话内容已按摘要保留，最近的交流已重新
+  载入。如有需要请提醒我补充关键背景。」，metadata 统一
+  `{kind:'context_rebuilt', reason, previousSessionId, reseededRows}`（
+  `reseededRows` 为 Task 1 实际回读注入行数，无回读诚实为 0）。此前轮换完全静默：
+  agent 丢了 transcript、cloud 按摘要重建，用户只看到「回复不再引用上文」。
+  seam 未接线（`setHermesCloudIO(null)`）→ 静默跳过，不向派发抛错。
+- **skill-sync 杀 gateway 错峰（§3.4-4b / Task 6）**：上游 gateway route 表无
+  skill reload/rescan（catalog 只在 spawn 时扫），真热重载属上游改动。新增
+  `HermesService.busy`（`currentRunId !== undefined`，run 终态 `finally` 必清）与
+  `respawnHermesGatewayAfterSkillSync`：空闲照旧 atomic invalidate + 杀 gateway；
+  **有在飞 run 则推迟**——`markSkillDirty` 重新置脏位、交由下次 dispatch
+  （`consumeSkillDirty`）消费，本轮继续用现 gateway（新 skill 本轮不可见，优于杀在飞
+  run 并让该 profile 全部 session 集体失联）。无 `markSkillDirty` seam 时不静默丢
+  改动：stderr 告警后照旧杀（退回 S5 前行为）。`DispatchDeps` 新增
+  `markSkillDirty` / `peekServiceBusy`，runner 两处 dep bag 均已接线。
+
+### Hermes — 空回复轮换阈值 1→2 + 首次空回复可见（spec 11 / T1-3，daemon 侧）
+
+- `session-health`：`EMPTY_ROTATE_THRESHOLD` 默认 **1 → 2**——首次 `empty_reply`
+  不再轮换，连续第二次才在下一 turn 铸新 hermes session。2.2.9 的「一次即轮换」
+  建立在「hermes 只在可恢复但为空时才 EMPTY」这一假设上，生产事实相反：首次
+  EMPTY 常是上游瞬断（provider 流中断、网关冷启动），照旧语义立即轮换会丢掉一个
+  下一轮本可复用的健康 transcript——用户付一次完整 reseed（envelope FULL seed +
+  transcript 回读），agent 也丢掉它已有的上下文。
+- env 覆盖 `HERMES_SESSION_EMPTY_ROTATE_THRESHOLD` 保留为运维逃生口（`1` = 2.2.9
+  语义，事故可回滚）；`Math.max(1, …)` 下界保留（轮换只发生在 turn 起点，0/负数
+  无意义且会静默废掉守卫）；非数字覆盖回退默认值而非 NaN（NaN 会让
+  `streak >= NaN` 恒 false，等于静默永久关掉轮换）。新增 `emptyRotateThreshold()`
+  导出，供调度器读取实际生效值，避免与 `shouldRotate` 的判据漂移。
+- `sessions-dispatcher`：首次（未达阈值）空回复发一条 `empty_reply_observed`
+  `system_event`，其 `reason` 复用轮换事件（`context_rebuilt`）的
+  `empty_reply_streak` 枚举值，并附带 streak / 生效阈值 / sessionId——两次失败因此
+  读成一条故事：「仍在阈值下」→「达阈，窗口已重建」。文案与阈值解耦（不承诺
+  「下一轮即重建」：运维把阈值调到 ≥3 时那是假话）。云侧 IO 未接线或不可达时静默
+  跳过，不计为派发失败。
+- 测试：新增 `sessions-dispatcher-empty-reply-threshold`（oracle 两次空回复 +
+  两条负控 + 边界）；`session-health-persistence` 补阈值判据组（env=3 两次仍不轮换
+  = 真阈值而非「延迟一拍」的假实现、env=1 恢复 2.2.9 语义、非数字覆盖回退 2、
+  0 夹到 1）；`sessions-dispatcher-single-flight-rotation` 按新裁决更新。
+- 既有 immutable-release 规则下版本号 bump 与否由发版时判定。
+
+### infra — Hermes pin v2026.8.3 → v2026.9.14（S1，docs/organization/specs/01）
+
+- **infra 锁**：`engine-lock.json` hermes 块 ref/installerSha256/uv.lock sha256、
+  `build-inputs.lock.yaml` hermes ref/installerUrl/installerSha256 + verifiedAt。
+- **镜像构建探针**：`Dockerfile.base` ARG 默认值随锁同步；探针串换为新 pin 的
+  `if not route and model:` 并追加语义锚 `route_source = "raw_request"`（防探针
+  弱化成空洞匹配）；安装调用加 `--skip-computer-use`（新 install.sh 会 best-effort
+  从 unpinned `trycua/cua@main` 拉 cua-driver，不入 pinned-inputs 镜像）。
+- **桌面 DMG payload**：hermes requirements 闭包按 v2026.9.14 `uv.lock` 重导出
+  （arm64：71 pins，cryptography 48.0.1→50.0.0，+firecrawl-anydoc/pillow-heif/
+  snowballstemmer，nemo-relay 0.6.0→0.8.3）；`engine-payload.manifest.json` 的
+  `engineLockSha256` / `hermesRequirements.*.sha256` / `hermes-source` 重算。
+  ⚠️ **x64 (Intel) 未能重导出**：tag 把 cryptography 钉在 50.0.0，上游自 49.0.0
+  起删除全部 Intel-macOS wheel，wheel-only 链路下无法成闭包；文件头已记录阻塞，
+  x64 当前不是 DMG 目标（`electron-builder.yml` arm64-only），需 owner 裁决。
+- **测试**：新增 `test/sessions-sse-upgrade-compat.test.ts`（6 例）——keepalive 注释
+  帧不干扰正文、注释帧不喂 stall watchdog（负控）、未知/前瞻事件不进 output
+  （含 delta 兜底反例）、终态标志与 transcript 载荷无副作用、无 run.started 的
+  error 事件仍保留 run_id。
+- **daemon 源码变更为注释级**（`sessions-dispatcher.ts` 两处 stale 说明更正：
+  sessions run 在 v2026.9.14 已注册 `_active_run_agents` + owner stamp，stall-abort
+  的 `/v1/runs/{id}/stop` 自新 pin 起真实生效）。既有 immutable-release 规则下
+  版本号 bump 与否由发版时判定。
+
+
+
+### K 空腔闭合 — `prismer chat direct` 202 ACTION_DEFERRED 分支
+
+- `chat direct` 收到 202 deferred（跨台联系人审批）时输出
+  「等待联系人审批（approvalId: …）——审批通过后重新发送」，不再打印
+  "sent"（此前消息 hold 在审批侧却被报成已发送；h-contact-system-refactor
+  §9-SDK）。
+
+### Hermes — session-health 默认路径生效（spec 11 / T1-3b，daemon 侧）
+
+- `session-health`：`HERMES_SESSION_HEALTH_FILE` 未设时 health 文件**默认落盘**于
+  `~/.prismer/hermes-session-health.json`。2.2.9 的
+  `process.env.HERMES_SESSION_HEALTH_FILE ?? null` 让紧随其后的 `=== undefined`
+  默认分支永不成立（`??` 已把 `undefined` 从类型里摘掉，且严格模式下也不报错）：
+  env 未设时 `healthFile` 恒为 null，`persist()` / `load()` 双双 early return——
+  「重启不丢轮换信号」只在运维显式给 env 时才成立。阈值 1→2 之后后果更实：
+  streak 只活在进程内存，重启落在两次 EMPTY 之间即归零，污染会话可永久不轮换
+  （每轮只留一条可见行，无自愈）。语义收敛为 `undefined`（未设）→ 默认文件、
+  `''` → 关闭持久化、其余 → 显式路径。
+- vitest `test/setup`：导入前把 env 钉到 per-file 临时路径。默认路径生效后，任何
+  import hermes dispatcher 的测试文件（实测 10 个里 7 个会写）都会把 fixture 写进
+  开发者真实的 `~/.prismer/hermes-session-health.json`——那正是 09 管理员消费的
+  观察资产；显式导出的 env（含空串 = 关闭）原样尊重。
+- 测试：新增「无 env → 两次 EMPTY → `$HOME/.prismer/…` 出现且 streak=2 → 重载
+  （新 module 实例）后 `shouldRotate` 仍 true」（负控：显式 env 优先且默认位置不被
+  创建）；既有显式路径用例逐字节不变。
+- daemon 源码变更；版本号 bump 与否由发版时（immutable-release 规则）判定。
+
+### Hermes — `prismer` 平台桥接客户端（daemon 侧传输，spec 11 / T4）
+
+新增 `src/adapters/persistence/hermes/bridge-client.ts`：hermes gateway 的
+`prismer` 自定义平台插件（`~/.hermes/profiles/<p>/plugins/prismer/adapter.py`）在
+127.0.0.1 上以换行分隔 JSON 提供一个本地 TCP 桥；本模块是 daemon 侧的客户端传输层。
+
+- 传输语义：`BridgeClient` 连 `127.0.0.1:<port>`，断线按 `reconnectDelayMs` 重连
+  （`close()` 是唯一的停止方式），`waitForConnected()` 超时抛显式错误；
+  `buildInboundFrame()` / `parseOutboundFrame()` 逐字段对齐插件读写契约；
+  `probeBridge()` 做 TCP 可达性探测（协议无 ping 帧，可达性即健康信号）。
+- 失败可见性：桥进程不存在时 `sendInbound()` 返 `{ok:false,error}`、
+  `probeBridge()` 返 `{reachable:false,code:'ECONNREFUSED'|'ETIMEDOUT'}`、
+  超出上限的悬挂行与畸形出站行走 `onMalformed`——无静默丢弃、无 unhandled rejection。
+- 如实透传的 gateway 侧事实（不在本层修补）：突发连发时出站 `reply_to` 可能错锚；
+  无连接时 gateway 的 `send()` 返 `SendResult(success=false, error="no daemon bridge
+  connected")` 给 agent 而非上线（daemon 侧完全观测不到，连接态必须取自 `isConnected`）；
+  首回合配对门回复按普通 `content` 透传；插件对 `t != "in"` 或空 `text` 的入站帧
+  静默丢弃——因此客户端在本地就拒绝空文本，不留「写出去但被吞掉」的窗口。
+- 落地方式：模块为**未接线**的传输原语（谁在 dispatch 里用它不在本波范围）；
+  为使其进入发布产物，`src/index.ts` 追加了对应 re-export（与 `WsClient` 同惯例）。
+  CHANGELOG 之外的版本文件零改动。
+
+### EaaS — bash 解禁（会话级）+ turn 协议 v2 工具事件（events.jsonl / output.tools[]）
+
+设计：`docs/superpowers/specs/2026-09-21-eaas-bash-tool-observability-design.md`（§3.1 修1、
+§3.2、§5 修5/修6）。runtime 侧半边；cloud 侧轮询器与事件类型在 PrismerCloud 仓。
+
+- **pi-core 会话级 shell 开关 `allowShell`（缺省 false）** —— `PiAgentCoreClientOptions` /
+  session options 新增该字段（默认关闭）。true 时：① 工具面在 read/write/edit 之外追加
+  `bash`（`createBashTool()`）；② `CwdJailedExecutionEnv.exec()` 由「恒返 `spawn_error`」
+  改为委托内层 env（异常仍映射回 `ExecutionError` 语义）；③ `createTempDir` / `createTempFile`
+  解除恒拒，但在 `<cwd>/.eaas/tmp/` 内创建（mkdir -p，保留上游 prefix/suffix，仍走 jail
+  检查）——bash 长输出截断依赖 temp 文件，落点必须留在 jail 内。**缺省 false 是刻意的
+  爆炸半径控制**：daemon（dispatch / runner / skill-sync）与 engine registry
+  （`createPiCoreAdapter`）路径的工具面与拒绝面**逐字不变**（缺省时仍是「Tool bash not
+  found」+ exec 原文拒绝），桌面/本地 hosted agent 零影响。
+- **工具事件（只记录不拦截）** —— `Agent` 构造接 `beforeToolCall` / `afterToolCall`：前者发
+  `tool_started`（name + argsSummary），后者发 `tool_finished`（resultSummary + isError +
+  durationMs）。两个 hook 恒返回 `undefined`（策略位留空——deny/HITL 后续可叠加，协议零
+  改动）；sink 抛错被吞掉（否则会被上游换成错误工具结果 = 事件面污染 turn）。摘要清洗在
+  产生侧做一次（剥字面量出口 token + `Bearer …` / `sk-…` 形态），写侧再洗一次（防御纵深）。
+- **turn 协议 v2**（`src/turn/protocol.ts`）—— `TURN_PROTOCOL_VERSION = 2`（唯一合法值，
+  不做兼容推断）。新增 `events.jsonl` 行 schema（`ToolEventV1`：`seq/at/kind/name/argsSummary?/
+  resultSummary?/isError?/durationMs?`）、常量 `TURN_EVENTS_FILENAME` /
+  `TURN_EVENTS_MAX_COUNT = 200` / `TURN_EVENTS_MAX_BYTES = 512KiB` /
+  `TOOL_SUMMARY_MAX_CHARS = 500`、`parseToolEventLine`、以及 `TurnResultV2.tools[]` 终态汇总
+  （`TurnResultV1` → `TurnResultV2`）。v1 `output.json` 被解析器**明确拒绝**（带 skew 说明），
+  v1 envelope / egress 同样拒绝——旧 bundle 收 v2 是可见失败（exit 70），不静默降级。
+- **写侧（`src/turn/runner.ts`）** —— `createToolEventWriter`：**seq / at 由写侧赋值**
+  （1-based 单调，行序 ≡ seq 序，轮询器据此去重），一行一条追加、首行落盘即 0600，达上限
+  **停写**；终态 `tools[]` 在内存无条件折叠（修6：超限只影响流式粒度，不影响终态），孤儿
+  `tool_started`（取消/超时，修5）如实呈现（有 `startedAt` 无 `finishedAt`，不补写）。文件
+  懒创建（本轮无工具调用 ⇒ 不落 events.jsonl）。`runTurnFile` 把终态写进 `output.json.tools[]`；
+  EaaS turn 恒以 `allowShell: true` 建会话（`turnSessionClientOptions`）。
+- 测试：`test/turn-protocol.test.ts`（v2 accept/reject、events 行 schema、摘要截断/剥凭据）、
+  `test/turn-events.test.ts`（seq 单调、上限、终态完整性、写失败不改 turn、turn 目录落点）、
+  `test/pi-core-shell-gate.test.ts`（缺省工具面恰好 read/write/edit、exec/temp 拒绝原文、
+  allowShell 下 bash 真跑与 jail 内 temp、hook 只记录不拦截）。三处均含故障注入负控（缺省
+  翻 true / seq 冻结 → 用例变红）。
+- **无版本号 bump**：本波是 runtime 面新能力（需随下一次 bundle 重签重发才能进 pod），
+  版本对齐按发版轮统一做。
+### S6/M1 Task 6 — 兼容矩阵固化 + 回滚开关（本包零代码改动）
+
+- **本包无源码/测试改动**：Task 6 只做证明 + 开关固化 + 文档同步；唯一的测试补齿
+  落在云侧 `src/im/tests/acp-serial-merge-trigger.test.ts`（M0 合并 vanish-in-tx
+  用例补排队标记断言），不属本包。
+- **四配对兼容矩阵逐条固化**（全部实跑绿；锚点表见 `docs/organization/specs/
+  06-milestone-narration-m1.md` Task 6）：新 daemon × 旧 cloud（能力位缺席 → 单帧
+  I3）、旧 daemon × 新 cloud（帧无 `final` 键 → 走终结分支）、新 daemon × 新 cloud
+  且 relay 关（`HERMES_COMMENTARY_RELAY` off → 单帧）、上游门关（零 commentary →
+  零回调 + output 逐字节不变）。部署顺序任意——承重机制是**请求能力位**（旧 cloud
+  的请求永远不带 `interimReply`），不是帧字段的可选性；帧上 `seq/final` 对旧 cloud
+  是惰性 JSON 多余字段。
+- **回滚开关**：`HERMES_COMMENTARY_RELAY=false|0|off`（本包
+  `src/adapters/persistence/hermes/flag.ts`，每 turn 动态读）→ 下一个 turn 回单帧；
+  对端 cloud 的 `FF_INTERIM_REPLY`（`src/im/ws/v19x-helpers.ts`，每次装配读）→
+  下一次派发回单帧。两者相互独立，任一关即回改动前字节行为；**无 DB 回滚需求**
+  （零迁移）。
+- **无版本号 bump**：本轮无源码变更，版本对齐仍随 S6 发版轮统一做。
+
+### S6/M1 Task 2 — daemon wire：`task.dispatch.reply` 多帧发送
+
+- `src/types/im-events.ts` + 云侧镜像 `src/im/types/im-events.ts`（两份同步）：
+  `TaskDispatchRequestPayload` 新增可选 `interimReply`（capability bit——只有
+  懂多帧的 cloud 才会带；legacy cloud 永远不带 = 它永远只收终结帧，这条不变式
+  由该字段承载而非由帧承载）；`TaskDispatchReplyPayload` 新增可选
+  `seq`（turn 内 1-based 帧位）/ `final`（false = interim 旁白帧；true/缺省 =
+  终结帧）。
+- `src/daemon/dispatch.ts`：双门制——`interimReply === true` **且**
+  `isHermesCommentaryRelayEnabled()`（env `HERMES_COMMENTARY_RELAY` 二道闸）
+  才把 Task 1 的 `TaskInput.onInterimReply` 接到发帧：每段旁白出 I1 帧
+  `{ ok: true, output: <段文本>, seq, final: false }`；终结帧在**所有** reply
+  出口（adapter_unhealthy / workdir_materialize_failed / 主出口）统一经
+  `markTerminalReply` 补标 I2 `{ seq: N+1, final: true }`（失败终结帧同样补
+  标——interim 帧永不失败是 I6，终结帧仍是唯一完成标记）。能力位缺省 / env
+  关 / 零旁白 turn：单帧且 wire 上**无 seq/final 键**（I3，与现状字节一致）。
+  runs-dispatcher / `tool.*` 降级路径 / shell 面一律未动。
+- **deltas 回退残余窗口裁决**（Task 1 交接旗标）：「上游 commentary 不进
+  delta 流」在 daemon 侧**不可保证**——已作为契约注释落在
+  `interimRelayArmed` 声明处；退化 turn（终结 output 与已发 interim 段拼接
+  完全一致 = 上游旁白漏进 output 路径）的 daemon 侧处置 = 主出口 grep 可见
+  的 `interim relay degenerate turn` stderr 标记 + 契约注释，帧计划不偏离
+  I1-I6（interim 帧逐段 fire-and-forget 已出站、不可撤回；cloud handler 只认
+  `final === false` / `seq`，不发明新 wire 语义；渲染侧去重归 cloud 层）。
+- 新增导出纯函数 `buildInterimFrame(taskId, segment)` / 
+  `markTerminalFrame(reply, lastInterimSeq)`。
+- 新测试 `test/dispatch-interim-reply-frames.test.ts`（7 用例，mock WsClient
+  捕帧、不经真实 socket）：多帧序 + 终结补标 + requestId 逐帧回显、能力位缺省
+  负控①（回调不挂载，legacy 恰 1 帧）、env 关负控②、零旁白负控③（I3 字节
+  兼容：`'seq' in frame === false`）、失败终结帧补标、退化签名观测、纯函数
+  shape。兄弟 dispatch 回归 8 文件 99 用例全绿，`tsc --noEmit` 干净。
+- **fix round 1（评审 Important）**：I4 在瞬时重试下被打破——adapter 上报的
+  `seq` 是每条 SSE 流局部（Task 1 `commentarySeq` 每次 `consumeSessionsSse`
+  1-based 重置），而重试循环复用同一 `onInterimReply` 闭包，attempt 2 的旁白
+  会把 wire 打成 `[1, …, 1, terminal N]`（seq 重复 + 终结帧非最大）。修法 =
+  **daemon 侧单派 seq（`++interimSeq`），不信任 adapter 上报值**；新增重试
+  负控测试④（attempt1 旁白后瞬时失败 → attempt2 新流旁白 seq 重置，断言
+  daemon 帧序 `[1,2,3]` 严格递增、终结帧最大；红→绿，修前实测 wire
+  `[1,1,2]`）。评审 Minor #2 一并收：退化标记改走 `traceLog`（带
+  `[trace=…]` 前缀，与 dispatch 全程 trace 一致）。
+- **无版本号 bump**：字段全部 optional-additive，单帧路径字节不变；版本对齐
+  随 S6 发版轮统一做。
+
+### S6/M1 Task 1 — Hermes `assistant.commentary` 多段旁白回流（adapter SSE 消费段）
+
+- `src/adapters/contract.ts`：`TaskInput` 新增可选 `onInterimReply(segment: { text, seq })`
+  —— turn 内每段非空旁白逐段回调（per-turn 1-based `seq`，流序保序）；回调是
+  fire-and-forget，consumer 抛异常不断 SSE 循环；最终 `TaskResult.output` 语义不变
+  （仍= 最后一条 `assistant.completed`）。Task 2 的 daemon 消费面按此契约接。
+- `src/adapters/persistence/hermes/sessions-sse.ts`：新增 `assistant.commentary` case
+  （hermes v2026.9.14）。实测上游契约（2026-09-21 本地 source 真跑）：字段名是 `text`
+  （附 `message_id` / `already_streamed` / `session_id` / `run_id` / `seq` / `ts`），
+  brief 期 fixture 与旧 build 的 `content` 兜底——两者都收，`text` 优先（同文件
+  `reasoning.available` 多字段容忍先例）。旁白与 delta 累加、`finalContent` 保持
+  **完全不相交**：`already_streamed: true`（该段已作为 assistant.delta 流出）的段
+  只走回调，绝不并入最终 output——这就是去重语义。无「值得发否」二次过滤（owner
+  裁决：非空全量上抛，收窄后置）。`SessionsSseResult` 新增必填
+  `commentarySegments: string[]`（测试/诊断用；无旁白 turn 为空数组；approval
+  拆流早退路径同样携带）。`tool.*` / `message.started` 降级路径、
+  `!isAgentReply` 守卫、runs-dispatcher / message.interim 一律未动。
+- `src/adapters/persistence/hermes/flag.ts`：新增 kill-switch
+  `HERMES_COMMENTARY_RELAY`（默认开，显式 `false|0|off` 才关）——与
+  `HERMES_TASK_RUNS_DISPATCH` 反极性是有意的：回流是新默认行为，env 仅作运维逃生门。
+- 新测试 `test/sessions-sse-commentary.test.ts`（6 用例）：多段顺序 + 1-based seq、
+  keepalive 注释帧/空白旁白零回调（负控①）、回调抛异常不断流（负控②）、实测上游
+  shape（text + already_streamed 不并入 output）、kill-switch、无旁白流回归
+  （负控③，commentarySegments 为空 + output 逐字节不变）。兄弟 SSE 回归
+  （upstream-error 9 / stall-watchdog 10 / first-event 3）与 dispatch 面 7 文件
+  109 用例全绿，`tsc --noEmit` 干净。
+- **无版本号 bump**：`onInterimReply` 为可选新增、daemon 消费面属 Task 2，版本
+  对齐随 S6 发版轮统一做。
+
+### memory211/10 R4 — W-1 digest「Verified this turn」段（harness receipt 派生）
+
+- `daemon/memory/digest.ts`：`buildMemoryDigest` 新增可选 `verified.lines` 入参——
+  在 hub spine 之后渲染 `# Verified this turn` 段，内容**逐行 verbatim 来自
+  harness 持有的 receipt**（task 状态机当前态 / 上一 turn terminal receipt 摘要 /
+  已完成产物指针）；builder 是纯渲染器，自己不派生任何事实。稳定性契约原样适用：
+  同 receipts ⇒ 字节一致、version（body 的 sha256 前 16）随之变化使缓存行失效；
+  **无 receipts ⇒ 整段不存在**（与 W-1 之前字节一致，不留空段）。段在极端守卫
+  （32K tokens）之内。新测试 `test/memory-digest-verified.test.ts`（5 用例）。
+- **调用侧接线（digest provider 处传 receipts）与演化 origin 的 daemon 产线贯通**
+  属 runtime 发版轮工作（pack+promote 需 owner 授权）；本波先把 builder 面与
+  契约测试落库。
+- `daemon/memory/envelope.ts` 的 `MemoryPageUpsertEvent` 云侧解析面新增可选
+  `evolutionOrigin`（additive，不 bump schemaVersion，同 encrypted 先例）——
+  携带该字段的 upsert 在云侧改道为 proposal 候选（见 PrismerCloud 仓
+  memory-write.service.ts）。
+
+### memory211/10 R1 — §2.1 演化产物 metadata 闸（daemon 侧镜像）
+
+- `daemon/memory/write-gate.ts`：新增 `checkEvolutionMetadataGate(content)` +
+  导出值域常量 `MEMORY_ROLES`（07 §2.1 的三分角色）。校验页体 frontmatter
+  `extra.memory` 受控块（memoryRole / source 必填，trigger / sections 可选，
+  `sections[]` 按 anchor 索引 —— D-1 (a)），未知键拒绝。
+- **本波不接线**（有意的，非遗漏）：daemon 的演化面是 **proposal**（
+  `memory.proposal` outbox 车道），不是页；daemon 真正写页的那条腿是自动抽取
+  管线，而 write-gate.ts 的文件头已写明新增 422 绝不可落在那条腿（后台腿无法
+  修复 ⇒ 静默丢记忆 = D4 失效模式）。接线 `memory.proposal` 车道属 R2
+  「proposals 扩展」，待候选真的带上块之后。
+- 与云侧 `src/im/services/memory-activation-probe.ts` 是**镜像**（两个包各有自己
+  的 tsconfig 与 staged pkf 拷贝，无法共享代码，先例 `src/im/services/
+  magic-bytes.ts`）。同源性由 `scripts/__tests__/
+  memory211-evolution-metadata-parity.test.ts` 强制：值域相等 + 逐 fixture
+  判定/字段级一致，单边改动即红。
+- `daemon/dispatch.ts`：`MEMORY_CORE_DIRECTIVE` 增一行「演化产物过门 + verdict 回执」
+  （07 §5 维5 的义务）。理由：§2.1 闸现在会**拒**缺块的演化产物，若 brief 不提这
+  件事，被派发的腿会把 422 读成死路并把产物丢掉——正是本车道要杀的 no-fallback
+  失效模式。该行 210 字符，指令此前已在 1292/1300 顶格，故预算 1300 → **1600**
+  重钉（同 memory211/01 W5 轴H 的 1200→1300 先例：mandated content 才重钉，
+  非编辑性膨胀；理由写在 pkf-skill-delivery.test.ts 用例注释里）。
+- 教学：`sdk/cloud/catalog/skills/memory/SKILL.md` 增第 5 条 PKF body invariant
+  （`extra.memory` 块、三分 memoryRole 的路由含义、source 的人类可陈述性、
+  `sections[]` 按 anchor、手写页豁免、被拒后按 verdict 指名字段修复重提）。
+  catalog 是单一来源，runtime 镜像由 `npm run prebuild` 生成（已重跑并核对
+  byte-identical，484 行 ≤ 520 预算）。
+- **无版本号 bump**：本波不加行为到已发布的 daemon 面（纯新增导出、零调用点，
+  指令侧只是把既有闸的存在告知生产者），版本对齐随 memory211 发版轮统一做。
+
+### memory211/08 A4-① — extract.done 观测上行（post-turn 抽取健康进云端活动面板）
+
+- `daemon/memory/envelope.ts`：union 新增 `ExtractDoneEvent`（`eventType:
+  'extract.done'`，TOP-LEVEL ObservabilityCommon 字段；`eventFamily` 归
+  observability）。**Additive，不 bump schemaVersion**（同 traceId /
+  recall_fork 先例：老 daemon 永不发该字面量，旧 envelope 解析不变，
+  memory_outbox 无该形状旧行）。部署顺序：**cloud 先合、SDK 后发**——cloud
+  未加 OBSERVABILITY_TYPES 前，新事件会被判 unknown_event_type 进死信。
+- `adapters/coding/shared/lifecycle/post-turn-worker.ts`：`PostTurnWorker`
+  新增第 4 个可选依赖闭包 `emitObservability`（缺省 no-op，永不断 Blocking
+  post-turn 车道）与 options.deviceId（extract.done 溯源）；每个 outcome
+  迁移（applied / skipped / failed_retryable / failed_terminal）发一条
+  extract.done；idempotencyKey =
+  `obs:extract.done:<jobKey>:<attemptCount>:<outcome>`（attempt 入 key：cloud
+  幂等 hash 全 envelope，payload 可变则 key 必须变，否则 409）。
+  `PostTurnExtractionResult` 增可选诊断字段（skipReason/gatedOut/truncated/
+  latencyMs/promptTokens/completionTokens/errorStatus）。
+- `daemon/memory/hook-server.ts`：`extractDurablePostTurn` 把 skip 原因与
+  抽取诊断透传给 worker（原先只进内存计数器）。
+- `daemon/memory/outbox-worker.ts`：flush tick 后采样
+  `memoryOutboxHealthSnapshot()`（pending/deadLetter，最后样本）。
+- `daemon/runner.ts`：worker 构造注入 emit 闭包（`runtime.resolve(ws).
+  outbox.enqueue`，non-blocking）+ 真实 daemon_id；/healthz 增 `memoryOutbox`
+  投影（零 I/O，首个 tick 前缺省）。
+- 隐私：error 摘要取自 store lastError（`redactSensitiveText` 已跑、≤220
+  截断）；`query`/对话正文永不入 envelope。
+### MUST-1 — turn 的 LLM 出口改走 cloud turn-scoped 端点（`--key-file` → `--egress-file`，2026-09-18）
+
+- **`prismer turn run` CLI 契约破坏性变更**：`--key-file <provider.key>` 移除，改为
+  `--egress-file <egress.json>`（`{protocolVersion, url, token, model, provider}`，
+  0600，**读完即删**）。pod 内从此**没有 provider key**：`token` 是 cloud 铸造的
+  turn 作用域短 TTL 凭据（绑定 envId + turnId，run 终态或到点即死），模型调用打
+  cloud 的 `/api/eaas-turn-egress/v1/chat/completions`（OpenAI chat-completions wire
+  含 SSE 不变），由 cloud 用它自己的 provider 链与计费调上游。
+- **token 原样进 `Authorization: Bearer`**：pi-ai 时代「补 `sk-` 前缀」的 C-1 归一
+  逻辑不再适用于出口凭据——前缀会改变 cloud 出口面的 HMAC 验证输入。旧
+  `provider.key`（owner token 表）不再被接受（收到即 exit 70，不静默）。
+- 协议面：`TurnEnvelopeV1` 删除 `providers[]`（链与有序 fallback 上移到 cloud 出口
+  侧——pod 内换源会重放已落盘工具副作用，cloud 侧换源不会）；收到带 `providers[]`
+  的 envelope = cloud 早于本 bundle，明确拒绝（exit 70）而非静默忽略。新增
+  `TurnEgressV1` + `parseTurnEgress`；移除 `TurnProviderV1` / `TurnApiMode` /
+  `parseProviderKeys`。
+- 结果 `providerSource` 恒为 `cloud-egress`（具体 provider 源在 cloud 侧解析后才
+  确定，runtime 不再冒认源 id）；`PRISMER_PI_API` 固定 `openai-completions`（出口
+  端点 wire），`openai-responses` / `anthropic-messages` 分支保留给 daemon 路径。
+- 测试：`test/turn-cli.test.ts`（假 **egress** 端点全链真进程跑 + 「无 `sk-` 前缀」
+  负控）、`test/turn-protocol.test.ts`（`TurnEgressV1` round-trip / 拒绝面 /
+  legacy providers[] 拒绝）。cloud 侧镜像：`src/tenant/__tests__/agent-turn-runtime.test.ts`。
+
+### `prismer turn run`：环境内一次性 turn 进程（Gate B+ Task 7 协议 v1）
+
+> 2026-09-18 起，本节的 `--key-file` / `providers[]` 语义已被上面的 MUST-1 取代；
+> 以下保留为当时快照。
+
+- 新增 CLI 子命令 `prismer turn run --input <input.json> --output <output.json>
+  --key-file <provider.key> --adapter pi-core [--deadline-ms N]`：cloud 的
+  `EaasSandboxPort` exec 包装器在租户容器内调用它跑**一轮** agent 对话。
+  - 协议 `TurnEnvelopeV1` / `TurnResultV1`（`src/turn/protocol.ts`）：input.json
+    （0600，不含密钥）→ output.json；**stdout 不是数据通道**；exit code 契约
+    0 = 结果已写、70 = 基建失败（cloud 侧映射 `runtime_unavailable`）。
+  - 凭据只从 `--key-file`（0600，JSON map providerId → token）读，**读完即删**；
+    turn 窗口 = 凭据窗口。
+  - 有序 fallback：envelope 的 `providers[]` 按序试；某源在**未落工具副作用**前
+    失败才换下一源（避免重放副作用）。t7/t8 由引擎真上报（首个非空 delta = t8）。
+- pi-core 引擎新增 `openai-completions` wire（`PRISMER_PI_API=openai-completions`）：
+  EaaS turn 的 provider 源走的就是 gateway 形态的 `/v1/chat/completions` 端点，
+  换 wire 即静默行为漂移。原 `openai-responses` / `anthropic-messages` 选择逻辑
+  不变（daemon 路径零影响）。
+- 多模态：envelope 的 image 块（path + dataUrl 双载）原样进 pi-core 的 content-part
+  （`{type:'image', data, mimeType}`），视觉能力门在 cloud 侧（curated 表是单一来源），
+  runtime 侧不复制模型能力表。
+
+### vision 清单：deepseek-v4-flash-vision-exp 进 hermes VISION_CAPABLE_MODELS
+
+- `adapters/persistence/hermes` 的 per-model vision allowlist 新增
+  `deepseek-v4-flash-vision-exp`（2026-09-10 owner 裁决，deepseek 默认模型统一切换）。
+  依据：官方 vision guide + 活体 `image_url` 块往返 HTTP 200（图片 token 计费入账）。
+  注意上游约束：图片仅 `user` 消息可携带；plain `deepseek-v4-flash` /
+  `deepseek-v4-pro` 的 no-vision 判定不变。与 `src/lib` `BUILTIN_VISION_MODELS`
+  的同步由 `model-defaults-chain.test.ts` parity 门保证。
+
+### pkf-writing skill:全文评审门 + 生成器漂移同步
+
+- `built-in-skills/pkf-writing/SKILL.md` 由生成器重新生成(与
+  `sdk/cloud/catalog/skills/pkf-writing/SKILL.md` 逐字节一致,258 行):
+  Report quality floor 升级为「构成底线 + 全文评审门」(plain table 不再计入
+  rich affordance;交付前 5 项内容形状→载体机械审查)。生成器模板此前落后于
+  线上文本,已一并同步。skill 行为变化,无 daemon 源码变化。
+
+### ConfigDelivery env 直达 daemon process.env + 语义 config hash（test-504-storm 止血接线）
+
+- **fix(config-bootstrap): `applyBundle` 把 bundle.env 全量应用进 daemon 自身
+  `process.env`**——此前只有 `PRISMER_API_KEY`（显式）与 `PRISMER_BASE_URL`
+  （providerBase）进 overlay，其余键只写 `~/.hermes/.env`（仅喂 hermes
+  python），daemon 侧 `extract.ts` / `resolveBarrierTimeoutMs` 读到的永远是
+  boot 时的 pod env——Nacos 调优键（`MEMORY_EXTRACT_MAX_TOKENS` /
+  `PRISMER_MEMORY_BARRIER_TIMEOUT_MS`）经 ConfigDelivery 下发后不生效。
+- **fix(config-bootstrap): config.yaml 幂等比较改用语义 hash（剥离 `#` 注释
+  行）**——生成文件嵌有 `configVersion` 注释（曾有 `appliedAt` 时间戳），逐
+  字节 hash 在任何 bundle 变化下都不同，env-only 变化会被误判为 config 变化
+  而触发无谓的 gateway drain/kill（故障窗口里这是自伤）。语义相同 →
+  `applied:false` → 只更新 env 面、不重启 gateway；`appliedAt` 时间戳已删
+  （它同样击穿幂等检查）。备份仍只在真 config 变化时执行（env-only 不再
+  覆写回滚副本里的旧 .env）。
+- **fix(memory): `PreReplyDurabilityBarrier` 每次 `run()` 重新解析
+  `PRISMER_MEMORY_BARRIER_TIMEOUT_MS`**——barrier 是 runner 里的长命单例，
+  构造期快照会把 boot 时的 120s 默认值钉死到进程死亡；ConfigDelivery 是
+  运行时热更新通道，预算必须绑到下一次 run 而不是下一次重启。
+- cloud 侧配套：`src/im/api/runtime-bootstrap.ts` bundle.env 增设
+  `DAEMON_TUNING_ENV_ALLOWLIST`（显式白名单 + 纯整数守卫，防 NaN 毒化
+  extract max_tokens），负控测试
+  `src/im/tests/acp-runtime-bootstrap-tuning-env.test.ts`；daemon 负控测试
+  在 `test/config-bootstrap.test.ts`（env-only apply）与
+  `test/pre-reply-durability.test.ts`（预算热解析，修复前代码上红）。
+
+### ConfigDelivery context_length 存活契约 — configurePrismerProvider 保留/继承 `models`（评审修正）
+
+- **fix(hermes adapter): `applyBootstrap` 整项替换 prismer entry 时保留既有
+  `models` 键，profile doc 从 root doc 继承**——ConfigDelivery 写入 root
+  `~/.hermes/config.yaml` 的 `custom_providers[].models.<id>.context_length`
+  此前会在每次网关拉起时被不含 `models` 的新字面量整体替换剥掉（applyBundle
+  在 configVersion 不变时跳过重写，永不恢复），且 profile 网关（`hermes -p
+  <name>`，HERMES_HOME 被 profile 覆写、无 root 合并）读的 profile config 根本
+  拿不到该块——step-0 override 失效、嗅探风暴复活。修复：root 先应用并捕获其
+  `models`，profile 侧继承；本 doc 旧 entry 的 `models` 一律保留（operator
+  手写值不丢）。双侧写入对齐 commit 673beb3a0（C4）确立的「ConfigDelivery
+  YAML 与 configurePrismerProvider 逐键对齐」不变量。负控测试
+  `test/hermes-provider-context-length.test.ts`（3 条，前两条在修复前代码上红）。
+
+### ConfigDelivery — hermes config.yaml 写入 per-model `context_length`（首响应嗅探风暴根治）
+
+- **feat(config-bootstrap): `generateHermesConfigYaml` 输出
+  `custom_providers[].models.<id>.context_length`**——bundle 新增可选
+  `hermes.modelContextLengths`（model id → 权威 context window，cloud 侧取自
+  curated funnel），落到 Hermes 的 **step-0 config override**
+  （`hermes_cli/config.py:get_custom_provider_context_length`）。此前 Hermes
+  对自定义 base_url 每轮消息跑全量端点嗅探（`detect_local_server_type`×2 +
+  `/models` `/v1/models` `/v1/models/<id>` `/api/show` …≈20 发，对我们只服务
+  chat/completions 的 cloud proxy 全部 404）才能解析 context length，且无可
+  缓存权威值 → 每轮重复，首 token 前白烧秒级。字段缺省时 YAML 与旧版逐字节
+  一致（不产生空 `models:` 键）。
+- `RuntimeConfigBundle.hermes.modelContextLengths?: Record<string, number>`
+  类型同步落 `sdk/prismer` / `sdk/cloud` / `sdk/aip/typescript` 三包
+  （additive optional，向后兼容；进 configVersion 内容 hash → daemon 下轮
+  poll 自动拉新，无需 OTA 即可让 cloud 先行生效；yaml 渲染变更本身随下次
+  runtime bundle 发布）。
+
 ### SDK 边界 Wave2 B2/B3 — daemon 离线改名落库 + CLI rename --handle
 
 - **fix(daemon): `onAgentChanged` 补 local.db `agents` 表持久化**——改名

package/apc/skills/releasing-test/SKILL.md

@@ -122,6 +122,15 @@ description: Use when 把任何批次的改动发到 Prismer 测试环境（test
 - **并行写入震荡**：修复期间文件可能被并行会话覆盖（未提交的修复被 commit 覆盖丢失）——**修完立即原子提交**，提交前 `git status` 逐文件核对。
 - **lint-staged 会动文件**：commit 钩子跑 eslint --fix/prettier——提交后需重验关键测试再 merge。
 
+## 2026-09-08 增补（mention-bugfix 发版实录）
+
+- **merge 前必须跑完本地四件套**（本次违例：合了才补跑，CI check 成了第一道门而非最后防线）。四件套 = `npx eslint . --max-warnings <ratchet>` + `npx tsc --noEmit` + `npm run test:sandbox:node` + `npm run acs:e2e-smoke:dry-run` + `npm run test:unit`。**第五件（按改动面）**：动了 `sdk/cloud/catalog/**` 或 skill 内容/ops 脚本，必须加跑 `npx vitest run scripts/__tests__/`（catalog-source-contract 等钉 sha256 清单的 T0 合同面在 vitest 根套件之外——2026-09-08 实证：pkf-writing 内容变更漏跑，check_t0 拦下重走一轮）。
+- **宿主树拓扑漂移陷阱**：跑「宿主 ff develop」前先 `git -C <宿主> branch --show-current`。2026-09-08 实况：宿主检出的是 `release/v2.2.55`，本地 **已无 develop 分支引用**（`git rev-parse develop` 未知修订）——盲跑 runbook 的 `merge --ff-only origin/develop` 把 release 分支快进了（已 `reset --keep <原值>` 复位，untracked 无损）。本地无 develop 引用时该义务即作废：origin/develop 是唯一真相，**绝不 ff 当前碰巧检出的分支**。
+- **glab 实操定案**：`glab mr create --source-branch X --target-branch develop --title … --description …`；merge 必须 `glab mr merge <n> --sha "$(glab api projects/:id/merge_requests/<n> | jq -r .sha)" --yes`（防漂移校验）；节流 `glab api -X POST projects/:id/pipelines/<id>/cancel`；cli 在 `/opt/homebrew/bin/glab`。
+- **搭载提交归属**：长期分支上并行会话的 commit（如 config-delivery d58899f59）不 reset 不另立分支，随 MR 搭载，但 MR 描述必须按 SHA 显式归属+标注其后续在飞；断言 C 的「预期 commit 数」按分支实际数声明。
+- **搭载 daemon 源 = runtime 四问必答**：cloud MR 若搭载 `sdk/prismer/src` 变更，cloud deploy 后 daemon fleet 仍旧 bundle（无 protocolVersion 协商的版本倾斜加深的既有状态）——pack+promote 是 HUMAN 门，无 owner 原话授权不得代点，只能在汇报里显式提问。
+- **⚠️ 2026-09-08 违例记录（断言 C 被披露代替）**：mention-bugfix 发版时数出 2 commit（预期 1），没有停下核对/等并行会话确认，而是把搭载 commit（config-delivery d58899f59，含 daemon 源）写进 MR 描述就合了——owner 质询「工作树还有改动在飞你发了个什么版」定性违规。**规则钉死：count 不符 = 红灯，唯一正确动作是停 + 核对每个非本批 commit 的完成度（其会话是否声明 done、其自带测试是否在 CI 覆盖面内）；「在 MR 里披露归属」是违规后的补救记录，不是放行条件。**事後补验证（sdk 85/85 + acp 5/5 绿、在飞文件未进镜像）只说明侥幸无害，不改变违规本身。
+
 ## 红旗（出现即停，回到门槛顺序）
 
 - 想不经过 develop merge 就上 test