@sema-agent/server 7.52.1 → 7.53.0

package/dist/fleet/fleet-bus.d.ts

@@ -1,12 +1,12 @@
 import type { TaskNotificationPayload, WorkflowRun } from "@sema-agent/core";
 import type { RunRecord } from "../plugins/store-contracts.js";
-/** [2687-cli] 幽灵行案的单源判别:一条 `task_notification` 只有在 **agent 族 × 终态** 时才允许打
+/** [ref] 幽灵行案的单源判别:一条 `task_notification` 只有在 **agent 族 × 终态** 时才允许打
  *  `onChildTerminal`(fleet「subagent 树」只渲 agent 子代)。`background_bash`/`monitor`/`external`
  *  不属 agent fleet 树——它们此前每条都打,fleet-bus 的「无 tick 无 claim」臂给 b\* 与 m\* handle 合成
  *  agent 形瞬态终帧,壳终态留存池把这帧渲 60s = footer 幽灵子行;monitor 的 `status:"event"` 还被
  *  终态映射折成 `failed`。
  *
- *  🔴 A-033.1(#256):判别**本体已换 core 的 {@link isDelegatedAgentTerminal}**。此前这里是一份手写语义
+ *  🔴 [ref]([ref]):判别**本体已换 core 的 {@link isDelegatedAgentTerminal}**。此前这里是一份手写语义
  *  孪生(自己枚举 `completed|failed|killed|cancelled`),头注自陈「与 core 语义同源——core 根导出后换装
  *  import 删本镜像」。core 现已从包根导出(`index.d.ts:109`),且它的终态集与 pending 店的驱逐偏好共用
  *  同一份 `TERMINAL_STATUSES`(core 原话:「so "terminal" can never mean two things in this module」)——
@@ -31,11 +31,11 @@ export type FleetTaskStatus = "queued" | "running" | "waiting" | "stopping" | "a
  *  shell-local render state the renderer composes; the wire carries the data that TRANSITIONS). */
 export interface FleetTaskRow {
     id: string;
-    /** 显示名。**缺席不铸**([2070]③ cli 定谳,server 3.5.1):没有真名时本键**不发**。
+    /** 显示名。**缺席不铸**([ref]③ cli 定谳,server 3.5.1):没有真名时本键**不发**。
      *  ⚠️ 两代语义留档 —— 3.5.0 及以前,三处在无真名时把**行 id** 顶到本位(匿名子代 tick 铸子代 uuid、
      *  `onChildTerminal` 合成终帧铸 a\* handle、`publishTask` 懒铸底座铸行 id),于是人眼看到一串乱码
      *  (clay 亲报的「子代名乱码」形),消费端也**分不清**「它就叫这个」与「我们不知道它叫什么」。
-     *  3.5.1 起后者 = 键缺席,显示占位归客户端渲(cli 已收敛 `'(unnamed)'`)。同一条纪律见 [2053]
+     *  3.5.1 起后者 = 键缺席,显示占位归客户端渲(cli 已收敛 `'(unnamed)'`)。同一条纪律见 [ref]
      *  costUSD:诚实缺席 > 编造。(SDK `FleetTaskRow.name` 同步放宽 —— 见发车工单。) */
     name?: string;
     description?: string;
@@ -58,18 +58,18 @@ export interface FleetTaskRow {
      *  scoping field like `scope`. Absent ⇒ the row is visible to any same-principal caller (back-compat, unscoped). */
     sessionId?: string;
     parentId?: string;
-    /** [1832] P1-2(core 1.432 BackgroundChildEvent.parentToolCallId,「出生就在场」语义):发起本子代的
+    /** [ref] P1-2(core 1.432 BackgroundChildEvent.parentToolCallId,「出生就在场」语义):发起本子代的
      *  父 tool_use id **原值**(E2 域,core-mint 不含用户内容)——与 `parentId`(解析后的行链接)是两个域:
      *  本键给按 tool_use id 建卡树的消费端(cli 卡片树)直接绑定,无需 FIFO 猜/形状嗅探。
      *  ADDITIVE / tolerate-absent(旧 core 不发)。 */
     parentToolCallId?: string;
-    /** [1440] design/149:wa\* 行的 workflow 归属附注位(w\* runId)——面板按此分组;footer 树不按此嵌套
-     *  ([1433] CC 锚:wa\* 不进 footer,壳按 taskId 前缀过滤)。ADDITIVE / tolerate-absent。 */
+    /** [ref] [ref]:wa\* 行的 workflow 归属附注位(w\* runId)——面板按此分组;footer 树不按此嵌套
+     *  ([ref] CC 锚:wa\* 不进 footer,壳按 taskId 前缀过滤)。ADDITIVE / tolerate-absent。 */
     workflowRunId?: string;
     status: FleetTaskStatus;
-    /** core 1.367 δ([1514]/[1515]④):launch 时刻 epoch ms(revive 行=本 revive 周期 wake 时刻)——
+    /** core 1.367 δ([ref]/[ref]④):launch 时刻 epoch ms(revive 行=本 revive 周期 wake 时刻)——
      *  cli 的 elapsed 锚直出(比 server 端 elapsedMs 快照更稳,消费方自算不漂)。ADDITIVE / tolerate-absent
-     *  (a* 车道 spawn 即带;诚实缺席——回落 server 收帧时刻的臂已随 [2354] 删,floor ^4.0.0 下 startedAt 恒在)。 */
+     *  (a* 车道 spawn 即带;诚实缺席——回落 server 收帧时刻的臂已随 [ref] 删,floor ^4.0.0 下 startedAt 恒在)。 */
     startedAt?: number;
     elapsedMs?: number;
     tokens?: number;
@@ -80,7 +80,7 @@ export interface FleetTaskRow {
      *  today). UNTRUSTED (tool argument head) → redacted before publish, same discipline as `name`.
      *  ADDITIVE / tolerate-absent. */
     currentAction?: string;
-    /** cli [1827]②(core 1.429 `currentTool`):`currentAction` 的**结构化**同源体 —— CC220 详情页
+    /** cli [ref]②(core 1.429 `currentTool`):`currentAction` 的**结构化**同源体 —— CC220 详情页
      *  Progress 段消费 `{toolName, target}` 结构(toolName 查工具注册表,自由文本塞不进去)。
      *  `toolName` = core 工具名 verbatim;`target` = UNTRUSTED 自由文本(命令行/路径可能秘密形)→
      *  redactSecrets + bound,与 `currentAction` 同信任边界。与 currentAction 同生命周期(未跑过工具前
@@ -89,27 +89,27 @@ export interface FleetTaskRow {
         toolName: string;
         target?: string;
     };
-    /** cli [1748]①:该子代**累计**的工具调用次数(bg sink tick 的 `usage.toolUses`)——面板行与详情页的
+    /** cli [ref]①:该子代**累计**的工具调用次数(bg sink tick 的 `usage.toolUses`)——面板行与详情页的
      *  tool 计数。⚠️ **累计值,直接上行不累加**(与 `turn_end` 的每轮增量相反);⚠️ **缺席 ≠ 0** ——
      *  老 core 不发这个数时本位缺席,消费方不得当 0 渲染(那会把「不知道」伪装成「跑了 0 个工具」)。
      *  ADDITIVE / tolerate-absent。 */
     toolUses?: number;
-    /** cli [1748]②:该子代的转录 id —— 壳侧据此去转录里取**委派 prompt**(详情页 `Prompt` 段)。
+    /** cli [ref]②:该子代的转录 id —— 壳侧据此去转录里取**委派 prompt**(详情页 `Prompt` 段)。
      *  ⚠️ 为什么给的是映射而不是 prompt 本身:`BackgroundChildEvent` 上**没有 prompt**(core `types.d.ts`),
      *  server 收不到的东西不能凭空造 —— 要 prompt 直出需要 core 先发。(旧注还说「也无 parentToolCallId」,
      *  core 1.432 已补该键,见 FleetTaskRow.parentToolCallId——本键的理由只剩 prompt 一半。)
      *  ADDITIVE / tolerate-absent。 */
     transcriptId?: string;
-    /** [1839]①/(a) 案:**终态行帧的残局键**——cli 实测裸 durable-run 完成时终态 task 帧键集只有
+    /** [ref]①/(a) 案:**终态行帧的残局键**——cli 实测裸 durable-run 完成时终态 task 帧键集只有
      *  [id,name,status,tokens,elapsedMs,description],idle 观察者(web 首屏形)从行卡拿不到终局。
      *  (b) 案(为顶层 run 造 bg_notification)被否:那族语义=观察者眼里的**子代**,自造事件族比丰富行帧
-     *  更伤([1840]§二)。四键全部 ADDITIVE / tolerate-absent、**只在终态帧出现**:
+     *  更伤([ref]§二)。四键全部 ADDITIVE / tolerate-absent、**只在终态帧出现**:
      *  - `stoppedBy`:core open enum verbatim(与 BgNotification 同姿势);顶层 run 仅 cancel 路径有源
      *    (= "user",与 markStopSource 同源值),其余终态诚实缺席。
      *  - `usage`:与 {@link BgNotification.usage} **同形**(消费端一个形状)——bg 子代=terminal 事件的
      *    usage 逐键挑;顶层 run=TaskResult.stats 映射(tokens→totalTokens、toolCalls→toolUses)。
      *  - `resumable`/`editedFiles`:**仅 bg 子代有源**(BackgroundChildEvent.terminal);顶层 TaskResult
-     *    上没有这两位 ⇒ 顶层行帧永缺席,不造([1840]§二「没有就诚实缺席」)。 */
+     *    上没有这两位 ⇒ 顶层行帧永缺席,不造([ref]§二「没有就诚实缺席」)。 */
     stoppedBy?: string;
     usage?: {
         totalTokens?: number;
@@ -124,7 +124,7 @@ export interface FleetTaskRow {
         path: string;
         edits: number;
     }>;
-    /** [2070]①/[2080] 裁定(server 半场,3.6.0):**产出这一行的车道**。
+    /** [ref]①/[ref] 裁定(server 半场,3.6.0):**产出这一行的车道**。
      *  - 缺席 = BCE 车道(`fleetBackgroundChildPublisher`)的 a\* 与 wa\* 真行,或顶层 run 行 —— 单源,常态。
      *  - `"run-leg"` = 由每腿的 `fleetRunPublisher` 从 `task_progress` tick 铸的**复合 id 行**
      *    (`${runId} ${childTaskId}`)。此形只在**没有 BCE 真行**的前台 delegation 上保留(同步腿委派的
@@ -135,7 +135,7 @@ export interface FleetTaskRow {
      *  ADDITIVE / tolerate-absent。 */
     sourceLane?: "run-leg";
     /**
-     * #261 §2①(core 5.36.0 #258 供给,server 白名单透传):这一行的**代际号**。语义 = core 的
+     * [ref] §2①(core 5.36.0 [ref] 供给,server 白名单透传):这一行的**代际号**。语义 = core 的
      * stop-cycle 计数(fresh spawn IS cycle 1,每次复活翻转 +1),与 `bg_notification.seq` /
      * `task_progress.seq` / `BackgroundChildEvent.seq` **同域同轴**(core 原话:一条轴,不是第三种拼法)。
      *
@@ -143,14 +143,14 @@ export interface FleetTaskRow {
      * **更小 ⇒ 前代迟到帧,忽略**(不回退——本仓在 {@link FleetEventBus.publishTask} 里 merge 前就判掉了,
      * 消费端拿到的流已经是单调的);**缺席 ⇒ 回落现行为**(tolerate-absent)。
      *
-     * 🔴 缺席是**事实**不是缺口(core [4043] 逐字定谳,以其措辞为准):没有 `a*` registry 行的 run
+     * 🔴 缺席是**事实**不是缺口(core [ref] 逐字定谳,以其措辞为准):没有 `a*` registry 行的 run
      * ——同步委派子代、workflow `wa*` agent、**顶层 run 行**——根本没有代际概念,「缺席即『无此概念』,
      * 非『第一代』」。任何把缺席读成 1 的消费端都会把「首帧迟到」误判成「复活」。
      * ADDITIVE / tolerate-absent。
      */
     cycleSeq?: number;
     /**
-     * #261 §2②:这一帧的终态**不是发布方亲报**,而是对账腿({@link ../fleet/fleet-reconciler.js})
+     * [ref] §2②:这一帧的终态**不是发布方亲报**,而是对账腿({@link ../fleet/fleet-reconciler.js})
      * 从 durable run 行**投影**出来的 —— 发布方死了(事件环异常中断 / 引擎被壳 reuse 而旧 run 对象已死 /
      * BCE 终态通知丢失),行本会永久僵在 `tasks` Map 里当幽灵。
      *
@@ -164,7 +164,7 @@ export interface FleetTaskRow {
 /** One workflow row (wire subset of contract `FleetWorkflow`). */
 export interface FleetWorkflowRow {
     id: string;
-    /** [2400] FLEET-WORKFLOWS-1([2070]③ 同款,workflow 行此前漏网):缺席=诚实缺席,**不铸 id 冒充名**。
+    /** [ref] FLEET-WORKFLOWS-1([ref]③ 同款,workflow 行此前漏网):缺席=诚实缺席,**不铸 id 冒充名**。
      *  现役唯一发布者(workflow-notify-journal)恒带 redact 后的真名;此可选位只为乱序/部分 delta 诚实。 */
     name?: string;
     description?: string;
@@ -177,11 +177,11 @@ export interface FleetWorkflowRow {
     /** 计划总数(= `run.agents.length`,**含排队中**)—— 注意它**不是**"已启动数",见 {@link FleetWorkflowRow.startedCount}。 */
     totalCount?: number;
     failedCount?: number;
-    /** MF-Fleet additive(cli [1726] 二①):**已启动**(非排队中)的 agent 数 —— CC 2.1.220 `⚠ Large workflow`
+    /** MF-Fleet additive(cli [ref] 二①):**已启动**(非排队中)的 agent 数 —— CC 2.1.220 `⚠ Large workflow`
      *  规模告警的分母。判别用 core 导出的 `deriveAgentDisplayStatus`(`startedAt` 未置 ⇒ 显示态 `queued`),
      *  **不自己重写谓词**:两端各写一遍必然漂移(本仓刚在治理面镜像上吃过同款)。
      *  ADDITIVE / tolerate-absent:缺席时消费方可退回 `doneCount + failedCount` 这个**诚实下界**(告警偏早)。
-     *  2.1.250 复核(S-11,语料=cc-decoded/cli250.js):告警函数 220↔250 逐字同形——agents 轴比的是
+     *  2.1.250 复核([ref],语料=cc-decoded/cli250.js):告警函数 220↔250 逐字同形——agents 轴比的是
      *  `scheduledAgents`,`started` 是 token/agent **投影的分母**(`started>0 ? totalTokens/started : 70k`);
      *  阈值 25/1.5e6/70k 与 `CLAUDE_CODE_WORKFLOW_SIZE_WARNING_*` 覆盖名两版一致。 */
     startedCount?: number;
@@ -194,7 +194,7 @@ export interface FleetWorkflowRow {
  * 从 `JournalingWorkflowRunStore.publishFleet` **原样**抽出,因为它现在有两个调用点,而两处各写一遍
  * 必然漂移(本仓在 startedCount 口径上已吃过同款):
  *  ① 活写路径 —— put/update 的写观察点(行的唯一写者,见该类注);
- *  ② `/v1/fleet/stream` 连接时快照的**有界终态行窗**(#189 修方向 1)—— 引擎重启后 boot 扫描把前世
+ *  ② `/v1/fleet/stream` 连接时快照的**有界终态行窗**([ref] 修方向 1)—— 引擎重启后 boot 扫描把前世
  *     running run 判死,终帧与撤行在同一同步栈内背靠背发出,之后才连上的客户端连快照都看不见那一行。
  */
 export declare function buildFleetWorkflowRow(id: string, run: WorkflowRun): FleetWorkflowRow;
@@ -215,17 +215,17 @@ export type FleetFrame = {
     id: string;
     ts: number;
     /**
-     * #261 §2③:**陈述级退场** —— 行没了,但**没有**结算语义。对照:无此键的 remove = 终态之后的
+     * [ref] §2③:**陈述级退场** —— 行没了,但**没有**结算语义。对照:无此键的 remove = 终态之后的
      * 常规清场(发布方亲报终态、或 `retiredBy:"reconcile"` 的投影退休,两者都先发过终态 `task` 帧)。
      *
      * 铸点只有对账腿:durable 说这条 run 还 `running`(reaper 宽限窗内)、或 claim 在他副本、或
      * durable 行压根不存在 —— 三形共同点是**没有终局可投影**,而本副本的行必然陈旧。此时造一个终态
      * 就是编:判死的属主始终是 durable 侧的 reaper。所以只陈述「这条行离场了」,不逼消费端结算。
-     * (cli 侧裁量 [4044]:渲「离场」**不清行** —— 行保留、中性离场形、active 扣除、折叠排后。)
+     * (cli 侧裁量 [ref]:渲「离场」**不清行** —— 行保留、中性离场形、active 扣除、折叠排后。)
      * ADDITIVE / tolerate-absent。
      */
     removeReason?: "orphaned";
-    /** #261 §2 判死×判代合成规则:退场帧带**被退那一代**的 {@link FleetTaskRow.cycleSeq}。
+    /** [ref] §2 判死×判代合成规则:退场帧带**被退那一代**的 {@link FleetTaskRow.cycleSeq}。
      *  消费端因此能把 `retire(gen=N)` 之后的 `frame(gen=N+1)` 读成**复活**(行重生,退休不粘住新代),
      *  而 `retire(gen=N)` 之后的 `frame(gen=N)` 读成**前代迟到帧,忽略**。缺席同 {@link FleetTaskRow.cycleSeq}
      *  ——「无此概念」,不是「第一代」。 */
@@ -248,7 +248,7 @@ export type FleetFrame = {
     ts: number;
 };
 /**
- * **一次 hook 判定「未能完成」**的观测帧(cli 黑板 [1786] 点名的需求;字段名由本仓定)。
+ * **一次 hook 判定「未能完成」**的观测帧(cli 黑板 [ref] 点名的需求;字段名由本仓定)。
  *
  * ── 它解决什么 ────────────────────────────────────────────────────────────────────────────────
  * 用户设了 `/goal enforced`,产品对模型承诺「没达成不许停」。某一轮评估者没能给出判词
@@ -267,7 +267,7 @@ export type FleetFrame = {
  * 的帧只投给能证明是自己的订阅方(`undefined` ⇒ 对 scoped 订阅方**丢弃**)。理由同源:一条关于别人
  * 会话的通知落到这个壳上,会让用户以为是自己这轮出了问题。
  *
- * ⚠️ `kind` 是**闭集**:第二族(`hook_non_blocking_failure`,#281)见下。加族必须同时在
+ * ⚠️ `kind` 是**闭集**:第二族(`hook_non_blocking_failure`,[ref])见下。加族必须同时在
  * {@link hookNoticeWire} 表态(穷举 switch ⇒ 漏表态=编译红)。
  */
 export interface HookDecisionUnavailable {
@@ -280,17 +280,17 @@ export interface HookDecisionUnavailable {
     detail?: string;
 }
 /**
- * **一次 hook 自己坏了**(非阻断故障)的观测帧 —— #281,黑板 [4250](test 实测立案)/ [4261](core 定性:
- * 翻译层全在 server)/ [4263](CC 锚源码核实)/ [4381](server 裁量②)。
+ * **一次 hook 自己坏了**(非阻断故障)的观测帧 —— [ref],黑板 [ref](test 实测立案)/ [ref](core 定性:
+ * 翻译层全在 server)/ [ref](CC 锚源码核实)/ [ref](server 裁量②)。
  *
  * ── 它解决什么(与上面那族是两件事)──────────────────────────────────────────────────────────
  * 上面那族说的是「判定没做成」;这一族说的是「**你配的这个 hook 自己坏了**」:退出码非 0 且非 2、
- * 超时、起不来、吐了坏 JSON。方向按 [4381] 裁量① **维持 CC parity 不动**(非阻断,绝不误伤任务),
+ * 超时、起不来、吐了坏 JSON。方向按 [ref] 裁量① **维持 CC parity 不动**(非阻断,绝不误伤任务),
  * 但此前故障只进服务端结构化日志 ⇒ **任务视角零可见**:用户以为自己的守卫在跑,其实每次都在坏。
  * 而 registry-core `hooks.ts:536` 对这一格逐字承诺过 "any other exit = non-blocking error
  * (**stderr shown to the user**)" —— 承诺与实装的落差,正是本帧要补的那一格。
  *
- * ── CC 锚(cc-decoded/pretty223.js 亲读,[4263] 已独立核实同一段)────────────────────────────
+ * ── CC 锚(cc-decoded/pretty223.js 亲读,[ref] 已独立核实同一段)────────────────────────────
  * CC 的 `hook_non_blocking_error` 附件带 `hookName` / `hookEvent` / `stderr` / `stdout` / `exitCode`,
  * UI 层对非 `Stop`/`SubagentStop` 事件真实渲染「`<hookName>` hook error」+ stderr(优先 stderr)。
  * 本帧的键就是照这份形状取的(`hookName` 的取法同 CC 的 `OG`/`AEe`:`statusMessage ?? 命令/URL/提示`)。
@@ -304,13 +304,13 @@ export interface HookNonBlockingFailure {
     event: string;
     /**
      * 机器可判的故障形(闭集,与 server 日志同源):
-     *  · `exit_nonzero` —— 退出码非 0。**exit 2 的归属按「这个位置有没有兑现面」判**(#281 codex R1-F2):
+     *  · `exit_nonzero` —— 退出码非 0。**exit 2 的归属按「这个位置有没有兑现面」判**([ref] codex R1-F2):
      *    - 有兑现面 —— 阻断面(PreToolUse ⇒ deny / Stop / UserPromptSubmit / PreCompact ⇒ block)或
      *      反馈面(PostToolUse 族 ⇒ stderr 喂模型)—— ⇒ exit 2 是**表过态的裁决/反馈**,不是故障,
      *      **绝不进本族**;
      *    - 没有兑现面(observe-only 的 StopFailure/PostCompact、以及 fire-and-forget 的纯 async 条目)
      *      ⇒ 作者的 exit 2 无处兑现,**进本族**并由 `detail` 逐字说清那里没有阻断面 —— 静默丢弃正是
-     *      #281 要根除的形,而不说清则会让一次有意表态被渲染成「坏 hook」;
+     *      [ref] 要根除的形,而不说清则会让一次有意表态被渲染成「坏 hook」;
      *    - `asyncRewake` 的 exit 2 是**契约动作**(唤醒模型),不是故障,不进本族;
      *  · `timeout` —— 条目超时被击杀(无退出码);
      *  · `spawn_failed` —— 起不来 / http 连不上 / LLM 载体失败(无退出码);
@@ -318,7 +318,7 @@ export interface HookNonBlockingFailure {
      */
     reason: "exit_nonzero" | "timeout" | "spawn_failed" | "bad_json";
     /** hook 身份(CC `OG`/`AEe` 锚:`statusMessage` 优先,否则 command / url / prompt),已脱敏+有界。
-     *  ⚠️ http 条目取 URL 时**剥掉 query 与 fragment**(#281 codex R1-F1:端点凭据最常见的挂法是
+     *  ⚠️ http 条目取 URL 时**剥掉 query 与 fragment**([ref] codex R1-F1:端点凭据最常见的挂法是
      *  `?token=…`,而通用脱敏器只认 `user:pass@` 形)。要更友好的名字,作者有 `statusMessage`。 */
     hookName: string;
     /** 条目类型 —— 没有它,`hookName` 是命令还是 URL 还是提示词全靠猜。 */
@@ -358,11 +358,11 @@ export declare function boundedNoticeText(s: string): string;
 /**
  * 上 wire 的载荷(归属位**逐 kind 穷举剥离**,不是 rest-spread)。
  *
- * 🔴 穷举 `switch` 而不是 `{...n}`:#157 闭集纪律 —— 新增一个 kind 而不在这里表态 = **编译红**,
+ * 🔴 穷举 `switch` 而不是 `{...n}`:[ref] 闭集纪律 —— 新增一个 kind 而不在这里表态 = **编译红**,
  * 而 spread 会把新 kind 的任意新键(可能带内部归属/密钥)静默推上 wire。
  */
 export declare function hookNoticeWire(n: HookNotice): HookNoticeObservation;
-/** design/129-B 缺口② (帧契约): a background child's COMPLETION notification pushed on the
+/** [ref]-B 缺口② (帧契约): a background child's COMPLETION notification pushed on the
  *  ALWAYS-OPEN fleet stream — the only server-push lane an idle shell keeps subscribed, so a session-scoped bg
  *  child finishing while the host sits idle notifies IMMEDIATELY (no more "late by one input cycle" durable-drain).
  *  EVENT semantics, not state: never in the snapshot, no dedup key held here (the shell's task_notification
@@ -377,7 +377,7 @@ export interface BgNotification {
     seq?: number;
     status: "completed" | "failed" | "killed";
     summary?: string;
-    /** Background lifetime scope (design/129), NOT the tenant scope. */
+    /** Background lifetime scope ([ref]), NOT the tenant scope. */
     scope: "task" | "session";
     parentTaskId?: string;
     stoppedBy?: string;
@@ -391,7 +391,7 @@ export interface BgNotification {
         path: string;
         edits: number;
     }>;
-    /** [1543]§二 LOW 补:完成通知的花费/转录锚(core BackgroundChildEvent.terminal 携带,此前被剥——
+    /** [ref]§二 LOW 补:完成通知的花费/转录锚(core BackgroundChildEvent.terminal 携带,此前被剥——
      *  完成卡无花费显示、转录跳转无锚)。数值/id verbatim。 */
     usage?: {
         totalTokens?: number;
@@ -402,11 +402,11 @@ export interface BgNotification {
         costMicroUsd?: number;
     };
     transcriptId?: string;
-    /** P1-3(core 1.452,[1925] 一轮批):子代完成的**幂等锚**——同一完成的多路通知(bg_notification/
+    /** P1-3(core 1.452,[ref] 一轮批):子代完成的**幂等锚**——同一完成的多路通知(bg_notification/
      *  task_notification/inbox 重放)带同一 id,消费端按它去重。verbatim;ADDITIVE/tolerate-absent。 */
     completionId?: string;
-    /** core 1.367 δ([1514]/[1515]④):委托树 root 宿主会话(固定点语义,嵌套孙代恒锚 root shell)——
-     *  cli 跨壳重启按宿主会话归组([1500]② 台账判别 F2 残余闭环)。ADDITIVE / tolerate-absent。 */
+    /** core 1.367 δ([ref]/[ref]④):委托树 root 宿主会话(固定点语义,嵌套孙代恒锚 root shell)——
+     *  cli 跨壳重启按宿主会话归组([ref]② 台账判别 F2 残余闭环)。ADDITIVE / tolerate-absent。 */
     rootSessionId?: string;
     /** Tenant/principal isolation key (same filter as FleetTaskRow.scope). STRIPPED before send. */
     ownerScope?: string;
@@ -425,7 +425,7 @@ export declare class FleetEventBus {
     private readonly emitter;
     private readonly tasks;
     private readonly workflows;
-    /** #261 / codex R1-F2:**代际墓碑** —— 已离场行的最后已知 `cycleSeq`(行本身已从 `tasks` 删掉,
+    /** [ref] / codex R1-F2:**代际墓碑** —— 已离场行的最后已知 `cycleSeq`(行本身已从 `tasks` 删掉,
      *  代际状态却必须活得比行久一点,否则前代迟到帧会在空 Map 上把幽灵行重铸出来)。有界 LRU。 */
     private readonly retiredGen;
     private static readonly RETIRED_GEN_MAX;
@@ -445,7 +445,7 @@ export declare class FleetEventBus {
     publishHookNotice(notice: HookNotice): void;
     /** Drop a task row (terminal + swept) + fan out the removal. Idempotent (a no-op if already gone).
      *
-     *  `opts`(#261,两键均 ADDITIVE):`removeReason:"orphaned"` = **陈述级退场**(没有结算语义,见
+     *  `opts`([ref],两键均 ADDITIVE):`removeReason:"orphaned"` = **陈述级退场**(没有结算语义,见
      *  {@link FleetFrame} 的 `task_remove` 臂);`cycleSeq` = 被退那一代的代际号。发布方的常规清场
      *  (`onTerminal`/`onChildTerminal`)不传 opts ⇒ 帧逐字节与本改动之前相同。 */
     removeTask(id: string, opts?: {
@@ -461,7 +461,7 @@ export declare class FleetEventBus {
     releaseBackgroundChildLane(scope: string | undefined, childUuid: string): void;
     /** run-leg 车道:该子代是否已有 BCE 真行(有 ⇒ 让位,不铸复合 id 行)。 */
     backgroundChildLaneRow(scope: string | undefined, childUuid: string): string | undefined;
-    /** [2268] 让位迁移料的读面:迁移「只补缺席位」需要看得见存活行现有什么(BCE 是权威车道,不覆盖)。 */
+    /** [ref] 让位迁移料的读面:迁移「只补缺席位」需要看得见存活行现有什么(BCE 是权威车道,不覆盖)。 */
     taskRow(id: string): Readonly<FleetTaskRow> | undefined;
     /** Upsert a workflow row (MERGE by `id`) + fan out. */
     publishWorkflow(delta: Partial<FleetWorkflowRow> & {
@@ -469,7 +469,7 @@ export declare class FleetEventBus {
     }): void;
     /** Drop a workflow row + fan out the removal. Idempotent. */
     removeWorkflow(id: string): void;
-    /** design/129-B 缺口②: fan out a background-child completion notification (EVENT — not stored, never in the
+    /** [ref]-B 缺口②: fan out a background-child completion notification (EVENT — not stored, never in the
      *  snapshot; a subscriber that connects later reads the durable inbox instead). */
     publishBgNotification(notification: BgNotification): void;
     /** The current full state (the connect-time snapshot frame). */
@@ -479,7 +479,7 @@ export declare class FleetEventBus {
     /** Subscribe to deltas. Returns an unsubscribe thunk. The caller typically sends `snapshot()` first, then every
      *  delta this delivers — the snapshot+delta sequence is the live fleet view.
      *
-     *  每个回调各自隔离(#183 复审 R3 HIGH):扇出是同步的,修前一个抛错的订阅方会把异常传回**发布方**——
+     *  每个回调各自隔离([ref] 复审 R3 HIGH):扇出是同步的,修前一个抛错的订阅方会把异常传回**发布方**——
      *  而发布方是 JournalingWorkflowRunStore.put/update 的投影点,core 持久化对 put 抛错 catch{} 且不推进
      *  storeRev ⇒ durable 行冻在 running 而 notify 已 ack,无恢复路径。投影消费方永远不该能楔死 durable
      *  写路;抛错记 {@link recordFailOpen}(F 类,登记闸),不上抛、不影响其余订阅方。 */
@@ -532,7 +532,7 @@ export declare function fleetRunPublisher(bus: FleetEventBus | undefined, run: {
      *  release condition watches the viewed cid's terminal) never saw a terminal transition. Returns whether the
      *  row EXISTED (hadRow — the observer logs it; false = the frame was synthesized flip-through). */
     onChildTerminal: (taskId: string, status: string, altId?: string, toolUseId?: string) => boolean;
-    /** [1839]①/(a) 案:`residuals` = 顶层 run 的终局残局键(有源才传,见 FleetTaskRow 上的键注)。
+    /** [ref]①/(a) 案:`residuals` = 顶层 run 的终局残局键(有源才传,见 FleetTaskRow 上的键注)。
      *  只有**真终态**(completed/failed/killed)帧带残局——parked(suspended/needs_review)的行还活着,
      *  没有「终局」可言,误传也不上帧。 */
     onTerminal: (status: RunStatusForFleet, residuals?: {
@@ -544,10 +544,10 @@ export declare function fleetRunPublisher(bus: FleetEventBus | undefined, run: {
 /** The run-scoped publisher handle (returned by `fleetRunPublisher`). Threaded into `runInBackground` so a
  *  background run TRANSITIONS its fleet row exactly like the sync POST /v1/runs leg does. */
 export type FleetRunPublisher = ReturnType<typeof fleetRunPublisher>;
-/** [1839]①/(a) 案:TaskResult → 终态行帧残局键映射(sync/background/resume 三条腿各自 settle,共用一处
+/** [ref]①/(a) 案:TaskResult → 终态行帧残局键映射(sync/background/resume 三条腿各自 settle,共用一处
  *  映射——键名映射写三遍必漂移)。usage 与 {@link BgNotification.usage} 同形:stats.tokens→totalTokens、
  *  stats.toolCalls→toolUses(名对齐,消费端一个形状)。errorCode "cancelled" ⇒ stoppedBy:"user"(与
- *  markStopSource 的归因值同源);transcriptId 顶层 = run 的 sessionId([1840]§二拍)。缺源的键不铸。 */
+ *  markStopSource 的归因值同源);transcriptId 顶层 = run 的 sessionId([ref]§二拍)。缺源的键不铸。 */
 export declare function fleetRunResiduals(result: {
     sessionId?: string;
     errorCode?: string;
@@ -563,7 +563,7 @@ export declare function fleetRunResiduals(result: {
     transcriptId?: string;
 };
 /**
- * design/129-B (core 1.240.0) — the PROCESS-LEVEL background-child fleet publisher, wired once
+ * [ref]-B (core 1.240.0) — the PROCESS-LEVEL background-child fleet publisher, wired once
  * onto `RunnerDeps.onBackgroundChildEvent`. Unlike {@link fleetRunPublisher} (per-leg: dies at leg settle —
  * the root cause: a session-scoped bg child outliving its turn had NO forward path, fleet showed zero
  * child frames), this observer lives as long as the process and covers the child's WHOLE lifecycle:
@@ -590,7 +590,7 @@ export declare function fleetRunLabels(objective: string | undefined): {
     name: string;
 };
 /**
- * `runStatusToFleet` 的入参**闭集**(A-032 P1-④)。两段:
+ * `runStatusToFleet` 的入参**闭集**([ref] P1-④)。两段:
  *  · `RunRecord["status"]` = `"running" | core.TaskStatus` —— run **行**状态词表,属主
  *    `plugins/store-contracts.ts`(core 加成员 ⇒ 下面那条 switch 的 `never` 臂收不敛 ⇒ tsc 红);
  *  · 四个**非行状态**的结算词:`queued`(未落行的排队态)、`error`(历史别名)、`killed`/`cancelled`
@@ -604,7 +604,7 @@ export type RunStatusForFleet = RunRecord["status"] | "queued" | "killed" | "can
 /**
  * fleet 行的**离场**判据(`onTerminal` 的 removal 集)—— `FleetTaskStatus` 的穷举 switch。
  *
- * 与 {@link runStatusToFleet} 同族(A-032 P1-④ 证据段点名):此前是消费点手抄的
+ * 与 {@link runStatusToFleet} 同族([ref] P1-④ 证据段点名):此前是消费点手抄的
  * `=== "completed" || === "failed" || === "killed"` 三词字面比对,fleet 词表加成员时同样没有编译期钉。
  * park 态(`waiting` / `awaiting approval`)判 false 是承重的:行还活着,必须留在 fleet 上。
  */

package/dist/fleet/fleet-reconciler.d.ts

@@ -1,5 +1,5 @@
 /**
- * #261(docs/DESIGN-261-fleet-liveness-reconcile.md v1.2,四方零驳定稿)—— fleet 总线**存活对账腿**。
+ * [ref](docs/DESIGN-261-fleet-liveness-reconcile.md v1.2,四方零驳定稿)—— fleet 总线**存活对账腿**。
  *
  * ## 它修什么(§0 病灶机制链)
  * fleet 总线是进程内纯内存聚合(`fleet-bus.ts` 头注自陈 NOT durable / NOT cross-replica),行的**唯一**
@@ -39,7 +39,7 @@
  * 按「bus 内滞留超一个对账周期且无新帧」陈述级退场。
  *
  * ## workflow 行(§1)
- * 只做同款「durable 终局投影」(#189 的 snapshot pull 腿 + reapers 的 workflow recover 腿已在场),
+ * 只做同款「durable 终局投影」([ref] 的 snapshot pull 腿 + reapers 的 workflow recover 腿已在场),
  * **不加新判据**:活行恒不动,没有陈述级退场这一形。
  *
  * ## 五条界(任何一条失手都只是幽灵行多活一个周期 ⇒ 整体 F 类 fail-open,登记 tag,不静默)

package/dist/fleet/fleet-terminal-window.d.ts

@@ -1,5 +1,5 @@
 /**
- * #189 修方向 1(黑板 [3112] 定谳)—— `/v1/fleet/stream` 连接时快照要并入的**近期终态 workflow 行窗**。
+ * [ref] 修方向 1(黑板 [ref] 定谳)—— `/v1/fleet/stream` 连接时快照要并入的**近期终态 workflow 行窗**。
  *
  * ## 它修什么
  * 引擎重启后 boot 扫描判死前世 `running` run,`publishWorkflow`(终帧)与 `removeWorkflow` 在**同一同步

package/dist/fleet/subagent-tail-bus.d.ts

@@ -12,7 +12,7 @@ export declare function projectTailFrame(e: Record<string, unknown> & {
     type?: string;
 }): SubagentTailFrame | null;
 /**
- * 宿主腿的 **content 供给形**(#252 / [3911] 定谳)——本面能不能拿到内容帧,由**宿主 run 的 spec**
+ * 宿主腿的 **content 供给形**([ref] / [ref] 定谳)——本面能不能拿到内容帧,由**宿主 run 的 spec**
  * `forwardSubagentEvents` 决定,而不是由订阅者决定:
  *
  *  · `"on"`            = 宿主 run 提交时带了 `forwardSubagentEvents:true` ⇒ core 的 forward 门
@@ -20,11 +20,11 @@ export declare function projectTailFrame(e: Record<string, unknown> & {
  *                        text_delta/reasoning_delta/tool_start/tool_end ⇒ 本面有内容帧;
  *  · `"progress_only"` = 宿主 run 没带 ⇒ 那道门**只**放 task_progress ⇒ 本面恒只有 rollup 帧。
  *
- * 🔴 为什么必须上 wire(#157「不许静默 fail-open」在本接缝的落实):`progress_only` 形下本端点
+ * 🔴 为什么必须上 wire([ref]「不许静默 fail-open」在本接缝的落实):`progress_only` 形下本端点
  * **一切正常**——200、meta 说 running、心跳照发、task_progress 照来——就是永远没有内容帧。消费端
  * (cli engineSubagentTail 明文「task_progress 不重复消费」)看到的是一个永远空的转录面,与「子代此刻
  * 恰好没说话」在 wire 上**不可区分**;而订阅方在查看态**没有任何办法**把它打开(那是 run 提交时的
- * 一次性表态)。[3911] cli 一手取证的指纹(建连成功 / 75s 零内容帧 / 同期 fleet token 在涨)与本形
+ * 一次性表态)。[ref] cli 一手取证的指纹(建连成功 / 75s 零内容帧 / 同期 fleet token 在涨)与本形
  * 逐条吻合。所以 meta 帧如实声明供给形,让「空」有诚实的来路。
  *
  * 缺席(`undefined` ⇒ meta 出 `"unknown"`)= **还不知道**:子代还没产出第一帧,或宿主腿在别的副本

package/dist/fleet-client.d.ts

@@ -29,14 +29,14 @@ export declare class FleetUsageAccumulator {
     private cells;
     private runsSeen;
     /**
-     * 🔴 RB-368(core 2.3.0;registry-core 0.11.0 收口,[2103]):`d.costMicroUsd` **可缺席 = 未知**
+     * 🔴 [ref](core 2.3.0;registry-core 0.11.0 收口,[ref]):`d.costMicroUsd` **可缺席 = 未知**
      * (unpriced 部署,budget.ts 如实不带键)。wire 自 0.11.0 起有缺席位(UsageEntry.costMicroUsd
      * optional)⇒ 本处**整键透传缺席**,不再折 0 低估。cell 级累加语义与 budget.ts ModelUsageTracker
      * 同款=**传染**(同为单 producer 累加器:已知+未知=未知);center 聚合面的「下界 + costUnknown
-     * 标记」语义在 registry-core aggregateUsage(跨 worker 审计总账层,两层判据见 [2103])。
+     * 标记」语义在 registry-core aggregateUsage(跨 worker 审计总账层,两层判据见 [ref])。
      * 配额轴(weightedTokens)不受影响,仍逐笔精确。
      *
-     * core 3.0.0([2296] 装车单 S4c)语义注:`d.inputTokens` 在唯一调用点(budget.ts 的
+     * core 3.0.0([ref] 装车单 S4c)语义注:`d.inputTokens` 在唯一调用点(budget.ts 的
      * `fleetUsage.record(...)`,S1 已迁)传的是 `e.totalInputTokens`(归一化总输入含 cache),不是
      * `e.promptTokens`(3.0.0 起恒 cache-MISS)——上游已切换口径,本函数只是照收不重算,值域/签名零改动。
      */

package/dist/fleet-lease.d.ts

@@ -97,7 +97,7 @@ export declare class FleetLeaseManager {
      *  registry-core 0.6.1 双轴:weightedTokens(加权 tokens 配额轴,weight-at-burn 已在调用方固化)
      *  + costMicroUsd($ 轴,轴名沿用 0.5 既定)。任一轴耗尽=leaseExhausted 拒(deny-wins,registry 类型层定死)。
      *
-     *  🔴 RB-368(core 2.3.0)已核 undefined 安全:两轴都是 `?? 0`,unpriced 部署下 budget.ts 不带
+     *  🔴 [ref](core 2.3.0)已核 undefined 安全:两轴都是 `?? 0`,unpriced 部署下 budget.ts 不带
      *  costMicroUsd 键调进来 ⇒ $ 轴不扣、不产 NaN。**这是有意的 fail-open**:租约是**执行面**,把"未知"
      *  当"扣满"会让没配价目表的部署一上来就被 leaseExhausted 拒掉所有请求(deny-wins),那是把可观测性
      *  缺口升级成可用性事故。补偿=配额轴(weightedTokens)不依赖价目表、逐笔精确,治理在 unpriced 部署下

package/dist/hooks/branch-transcript.d.ts

@@ -1,6 +1,6 @@
 import type { SessionTreeEntry } from "@sema-agent/core";
 /**
- * ── [2092] 渲染臂的判据:**证据面与模型所见同进同出** ─────────────────────────────────────────────
+ * ── [ref] 渲染臂的判据:**证据面与模型所见同进同出** ─────────────────────────────────────────────
  * core 的 `SessionTreeEntry` 是 12 型联合,曾经这里只渲 message/compaction 两支 ⇒ 10 型静默丢弃。
  * 其中 `custom_message` 正是非标准入口用户内容(steering)的落点:core `convertToLlm` 把它按
  * `role:"user"` 送模型,而证据面渲没了 ⇒ 评估者如实判「证据不足」⇒ 拦停死循环直到 CAP(cli 带
@@ -17,7 +17,7 @@ export declare const RENDERED_ENTRY_TYPES: readonly ["message", "compaction", "c
  * announced_listing / workspace_state / git_announcement / reminder_mark —— 控制面元数据,core 折
  * messages 时不产出内容;
  * custom —— data-only(session.js 折 messages 只认 message/custom_message 两型),模型看不见它的
- * data;把它渲出来反而是把模型没见过的东西冒充成证据,与 [2092] 是同一判据的反方向。
+ * data;把它渲出来反而是把模型没见过的东西冒充成证据,与 [ref] 是同一判据的反方向。
  */
 export declare const SKIPPED_ENTRY_TYPES: readonly ["thinking_level_change", "model_change", "label", "session_info", "leaf", "prompt_epoch", "announced_listing", "workspace_state", "git_announcement", "reminder_mark", "custom"];
 /** 渲染结果。**判别式**:证据不足时调用方拿不到 `text`,想用也用不了(见顶注)。 */

package/dist/hooks/cc-agent-hook-prompt.d.ts

@@ -1,5 +1,5 @@
 /**
- * CC `hook_agent` 臂(`type:"agent"` 钩子条目)的评估者系统提示 —— **CC 逐字移植**(A-065 P2-5 修:
+ * CC `hook_agent` 臂(`type:"agent"` 钩子条目)的评估者系统提示 —— **CC 逐字移植**([ref] P2-5 修:
  * 此前 agent 臂一个字的系统提示都不发,评估者拿不到「你在判什么/可以用工具去查/少走几步」任何一条,
  * 判词质量静默劣化且黑盒极难察觉;`cc-stop-prompt.ts` 把孪生的 prompt 臂做到字节级 ALIGNED,本臂却整块
  * 漏在考据之外=UNANCHORED)。
@@ -9,7 +9,7 @@
  * CC 该臂与 prompt 臂(`cc-stop-prompt.ts`)**不是同一批文本**:两档头句按事件名选
  * (`r === "Stop" || r === "SubagentStop"` ⇒ verify 档,其余 ⇒ evaluate 档),尾段共用。
  *
- * ── 登记偏离(载体差异,[1134] 锚定纪律:能逐字的逐字,搬不动的显式登记而非静默改写)──────────
+ * ── 登记偏离(载体差异,[ref] 锚定纪律:能逐字的逐字,搬不动的显式登记而非静默改写)──────────
  * CC 的完整模板还有两段本仓**刻意不搬**:
  *  1. transcript 文件句("The conversation transcript is available at: ${路径}\nYou can read this
  *     file to analyze the conversation history if needed.")——CC 给评估者落一个转录**文件**并往

package/dist/hooks/cc-stop-prompt.d.ts

@@ -9,12 +9,12 @@
  * `sema-agent/cc-decoded` 的 `pretty220.js:609309` 起(219/218 同构)。逐字核实的四件:
  *  · 两档判据是 **hook 事件名**:`c = r === "Stop" || r === "SubagentStop"` ⇒ 这两个事件用**完整版**,其余用简版;
  *  · user 消息也被包装(见 {@link wrapCondition}),原文预设**会话就在上文**("transcript **above**");
- *  · 评估者 `thinkingConfig: { type: "disabled", mechanical: !0 }`(A-065 P4-2:引文补 `mechanical` 键)+
+ *  · 评估者 `thinkingConfig: { type: "disabled", mechanical: !0 }`([ref] P4-2:引文补 `mechanical` 键)+
  *    **`tools: []`** —— 它是**纯判官**,不能自己去查;
  *  · 会话消息**整段前置**(`s && s.length > 0 ? [...prepend(s), p] : [p]`),不是摘要。
  * ⚠️ 语料把**正文/标点**非 ASCII 存成 `\uXXXX` 六字符字面量(正文里那两个破折号是 `\u2014`)——**grep 真字符会全假阴**。
  *    所以下面也用 `\u2014` 转义:源码保持 ASCII,运行时是同一个字符。
- *    (A-065 P4-5 量词修:locale/语言名表是例外——`日本語`/`русский` 等 127 个字面非 ASCII 字节在语料里
+ *    ([ref] P4-5 量词修:locale/语言名表是例外——`日本語`/`русский` 等 127 个字面非 ASCII 字节在语料里
  *    存活;另注 `grep -c` 数行不数次,计数用它会低估。)
  * ⚠️ **为什么必须自己核**:cli 报过他们移植的那段是**第三种措辞**(与 CC 220 的两个分支都不逐字相同,
  *    应是从更早版本移植后 CC 改过而没跟)。转述会漂,语料不会。

package/dist/hooks/hook-llm.d.ts

@@ -5,7 +5,7 @@ import type { HookLlmCall } from "./hook-runner.js";
  * hookLlm(prompt 条目/session titler 的模型载体)= 直连一次非流式 completion,从 main.ts 抽出成可注入
  * 单元(fetchImpl/keyResolver 可假),因为这条 wire 在每个默认部署上都活(titler),必须可单测。
  *
- * api 形分派(2026-07-15,黑板 [851]③b 真缺陷修):被选模型按 `Model.api` 分家 ——
+ * api 形分派(2026-07-15,黑板 [ref]③b 真缺陷修):被选模型按 `Model.api` 分家 ——
  *  - `openai-completions` ⇒ POST {base}/chat/completions(现状,字节不变);
  *  - `anthropic-messages` ⇒ POST {base}/v1/messages(x-api-key / Authorization: Bearer + anthropic-version
  *    头,messages 数组,回包取 content[].text)。此前 hookLlm 只会说 openai 形且缺省 baseUrl 恒落

package/dist/hooks/hook-runner.d.ts

@@ -25,7 +25,7 @@ export declare const MAX_HOOK_OUTPUT_BYTES: number;
  * 的 tool_result 追加 / `runtask.js` 的 Stop follow-up),不是日志。
  *
  * 帽值取 10_000 的依据:模型可见文本在本栈的既有预算量纲就是 10k —— core `truncateError`
- * (`src/core/tool-errors.ts`)的 10k 中截,逐字锚 CC 序列化器 `A7e` 的 `1e4`;#181 战役里 core 还要给
+ * (`src/core/tool-errors.ts`)的 10k 中截,逐字锚 CC 序列化器 `A7e` 的 `1e4`;[ref] 战役里 core 还要给
  * `beforeToolCall` block reason 补一道同值兜底闸。取同一量级 = 「一次 hook 注入 ≤ 一份错误文本预算」,
  * 且 4096 的单条帽保证**前两条**钩子的话仍整段进得去(截断是配置广度的代价,不是常态)。
  */
@@ -50,7 +50,7 @@ export declare function hookMatcherMatches(matcher: string | undefined, value: s
  *  非工具事件(payload 无 tool_name)→ "cannot be evaluated" 跳过;解析失败 → 跳过。返回:
  *  true=跑 / "not_matched" / "unevaluable"(调用方分别记账;跳过永不静默)。
  *
- *  2.1.250 复核(S-11,2026-08-30;语料=sema-internal `blueprints/cc-decoded/cli250.js`):求值器与 220
+ *  2.1.250 复核([ref],2026-08-30;语料=sema-internal `blueprints/cc-decoded/cli250.js`):求值器与 220
  *  逐字同构——五种工具事件之外「cannot be evaluated for non-tool event」跳过、「Skipping hook due to if
  *  condition … not matching」跳过,两串日志逐字在场;括号内容经工具 `preparePermissionMatcher` 求值,与
  *  本实现同向。差异登记(不改行为):①250 证据里名部=**规范化后等值比对**(`vd(toolName)!==o`),
@@ -75,8 +75,8 @@ export interface HookRunnerContext {
      *  · `hook_decision_unavailable` —— 一次判定**未能完成**。方向可以 fail-open,但**不能连
      *    「我这轮没看住」都不说** —— 否则模型拿到的放行与「已达成」无法区分,而产品刚对它承诺过
      *    「没达成不许停」;
-     *  · `hook_non_blocking_failure`(#281)—— **hook 自己坏了**(exit≠0∧≠2 / 超时 / 起不来 / 坏 JSON)。
-     *    裁决面按 [4381] 裁量① 维持 CC parity 不动,坏掉这件事本身必须让人看得见。
+     *  · `hook_non_blocking_failure`([ref])—— **hook 自己坏了**(exit≠0∧≠2 / 超时 / 起不来 / 坏 JSON)。
+     *    裁决面按 [ref] 裁量① 维持 CC parity 不动,坏掉这件事本身必须让人看得见。
      *  ⚠️ 它**必须**是不改变运行的通道:`additionalContext` 不行(那个会让这一轮不结束)。缺席 ⇒ 只进日志。
      *  ⚠️ 回调**抛错不许误伤任务**(见 {@link emitHookNotice}):观察面绝不成为新的失败源。 */
     onHookNotice?: (n: HookNoticeObservation) => void;
@@ -154,7 +154,7 @@ export declare function buildHookContext(parts: readonly string[]): string | und
  * 不装 hooks——结构性,见 main.ts);hook-runner 自身不发模型调用,fake 载体即可单测。
  */
 /** CC 评估者的额外输入(prompt 臂=Stop×prompt,见 `cc-stop-prompt.ts` / `branch-transcript.ts`;
- *  agent 臂=每事件,见 `cc-agent-hook-prompt.ts`,A-065 P2-5)。 */
+ *  agent 臂=每事件,见 `cc-agent-hook-prompt.ts`,[ref] P2-5)。 */
 export interface LlmHookExtra {
     /** CC 逐字的系统提示。 */
     system: string;