@sema-agent/server 7.52.0 → 7.53.0

package/dist/runtime-governance.d.ts

@@ -31,7 +31,7 @@ export type CommandRule = {
     decision: "allow" | "ask" | "deny";
 };
 /** True when `name` names a DELEGATION tool — the subagent tool(CC-187 canonical `"Agent"`,core
- *  `DEFAULT_SUBAGENT_TOOL_NAME`)。5.0.0 RB-476:折叠面退役,RAW 比对 core 单源常量——旧名("Task")
+ *  `DEFAULT_SUBAGENT_TOOL_NAME`)。5.0.0 [ref]:折叠面退役,RAW 比对 core 单源常量——旧名("Task")
  *  在 core roster 层响亮 miss,不再需要归一;单源常量本身就防了当年 1.202 改名时裸字符串失配的
  *  fail-open(那个教训的解=引用常量,不是折叠)。 */
 export declare function isDelegationToolName(name: string): boolean;
@@ -94,7 +94,7 @@ export declare function compileCommandPolicy(rules: CommandRule[] | undefined):
  */
 export declare function autonomyOverrides(autonomy: Autonomy | undefined): Partial<TaskSpec>;
 /**
- * #220:**部署级**判据 —— 本部署的治理层自己是否把 shellGate 抬到 `"always"`。
+ * [ref]:**部署级**判据 —— 本部署的治理层自己是否把 shellGate 抬到 `"always"`。
  *
  * 用途 = 持久门(park 行)的出身归因。活卡腿判「这只 ask 是治理层产的」靠 ALS 标记表(见本文件
  * `createGovernanceAskMarkingPolicy` / `createGovernanceShellGateMarkPolicy`),而 park 腿天然跨副本、
@@ -134,23 +134,23 @@ export declare function governanceMandatesShellGateAlways(governance: {
  * override would LOOSEN a stricter base safety field — surfacing a misconfiguration loudly instead of silently
  * weakening the gate. Returns `base` untouched when there is nothing to apply.
  *
- * #153([2713] server 分单②):`MANUAL_MODE_SHELL_GATE` 从 settings 折叠搬到这里**无条件施加**。旧家
+ * [ref]([ref] server 分单②):`MANUAL_MODE_SHELL_GATE` 从 settings 折叠搬到这里**无条件施加**。旧家
  * (task-settings deriveSettingsPolicy 的 default/auto/acceptEdits 三臂)让一个**部署级 tighten-only 旋钮
  * 的生死由客户端表态在场性决定**:body 无 settings/permissionMode(cli print/headless 腿按设计不 stamp)
  * ⇒ 旋钮静默失效(clay 实机 Monitor 案「门根本没铸」);bypassPermissions 一句话掀掉部署闸;非 host lane
  * fsWriteGate wiring 不建 ⇒ 沙箱 lane 全失效。governance 层与 autonomy 同拍施加后三者全闭。rank 合成:
  * autonomy 派生值与旋钮取大(ask→"always" 压过 "classify"),再对 base 只升不降(防 tightenTaskSpec throw)。
  *
- * #177([2951] issue #29,**邻仓 test AI 的 46 格真机矩阵**实证——不是本仓的钉,别到本仓文件里数 46;
+ * [ref]([ref] issue #29,**邻仓 test AI 的 46 格真机矩阵**实证——不是本仓的钉,别到本仓文件里数 46;
  * 本仓的类级门是 test/operator-knob-client-posture-matrix.test.ts 的 旋钮×表态×lane 矩阵):
- * `SENSITIVE_WRITE_PATTERNS` 是 #153 那次搬家漏下的兄弟旋钮——同一个病灶原样复发在 sensitive-path
+ * `SENSITIVE_WRITE_PATTERNS` 是 [ref] 那次搬家漏下的兄弟旋钮——同一个病灶原样复发在 sensitive-path
  * DENY 腿上(唯一合成点在 deriveSettingsPolicy 的 fsWriteGate 闭包,bypassPermissions/键缺席/settings
  * 整缺席三形整条腿不建)。同方修:调用方(resolve-spec)把 operator 守卫集预铸成 `sensitivePathPolicy`
  * 从这里**无条件施加**——它只在守卫段上产 deny(core 语义 deny/"safety"),对其余目标返回的是
  * `action:"allow"`(**不是**「无意见」这种第三态:core 的 ToolPolicy 没有弃权值。它在
  * `combinePolicies` 的 deny/ask 优先折叠里不构成一票,所以在**折叠语境**下等价于弃权;若日后有人把
  * 这条策略单独当成唯一 policy 用,那个 allow 就是真放行——别照抄这句话去别的语境)。于是对 bypass
- * 只挡守卫段、不给普通目标加 ask 门([820] 表第四行「bypass=不加门非开门」保持逐字)。策略在这里
+ * 只挡守卫段、不给普通目标加 ask 门([ref] 表第四行「bypass=不加门非开门」保持逐字)。策略在这里
  * 只组合不构造:裁决 env 的 lane 分形(host 真 fs / 沙箱 deferred 代理)是 resolve-spec 的属主知识,
  * governance 层不重复它。
  */
@@ -159,7 +159,7 @@ export declare function applyRuntimeGovernance(base: TaskSpec, governance: {
     commandPolicy?: CommandRule[];
     manualModeShellGate?: "always" | "classify";
     sensitivePathPolicy?: ToolPolicy;
-    /** [2942]/[2943] `governanceForced` 的标记表(缺省 = **当前 run 腿的 ALS 表**,见
+    /** [ref]/[ref] `governanceForced` 的标记表(缺省 = **当前 run 腿的 ALS 表**,见
      *  `governance-ask-marks.ts` 顶注「作用域」段)。注入口只为测试与将来的多实例形。 */
     askMarks?: GovernanceAskMarks;
 }): TaskSpec;

package/dist/security.d.ts

@@ -38,17 +38,17 @@ export interface SessionListItem {
  * 不含读面,也不含 `POST /v1/tasks` 那条提交腿 —— 它有自己的同族门(别重复拦,双拦会让错误归因变糊)。
  */
 export declare function isDestructiveSessionWrite(method: string, url: string): boolean;
-/** [4198] 窄互认第二臂的租户键字面量 —— 单机形下 core 写侧 `spec.principal ?? "default"` 铸出的那一个,
- *  也是壳 [4195]G1 翻面后随请求带的那一个。**不是哨兵**([4183] 措辞):它是单机形的真租户键。 */
+/** [ref] 窄互认第二臂的租户键字面量 —— 单机形下 core 写侧 `spec.principal ?? "default"` 铸出的那一个,
+ *  也是壳 [ref]G1 翻面后随请求带的那一个。**不是哨兵**([ref] 措辞):它是单机形的真租户键。 */
 export declare const LEGACY_UNOWNED_AMNESTY_TENANT = "default";
 /**
- * [4198] 窄互认**第二臂**(clay 裁 A / [4225] 下达;cli [4238] 表态即发)—— `legacyShellOwner`
+ * [ref] 窄互认**第二臂**(clay 裁 A / [ref] 下达;cli [ref] 表态即发)—— `legacyShellOwner`
  * (本文件 createAuthorizer 内 + http/server.ts `runOwnerOk`)的对称孪生。
  *
  * 病灶:7.8.0 第一臂承接的是 `owner === "anon:shell-live"` 哨兵行;此后壳把无主表示法归一为
  * **缺席**,于是 1.0.82 及更早留下的存量会话 owner 列是 **null**。壳 1.0.83 起随请求带
- * `default` 主([4195] G1 闸口),`null !== "default"` ⇒ 存量会话在 session 面
- * **列表不出现 / fork 404 / delete 静默 {deleted:false} / workspace 404**(三面矩阵 [4198] 面3;
+ * `default` 主([ref] G1 闸口),`null !== "default"` ⇒ 存量会话在 session 面
+ * **列表不出现 / fork 404 / delete 静默 {deleted:false} / workspace 404**(三面矩阵 [ref] 面3;
  * fleet 面与 run 读面天然连续,面1/面2 零施工)。
  *
  * 🔒 **三条件缺一不放行**(与第一臂同源,不是兼容臂):
@@ -62,13 +62,13 @@ export declare const LEGACY_UNOWNED_AMNESTY_TENANT = "default";
  *
  * ── 逐面判过、**刻意不放行**的三处(免得后人当遗漏再补一次)────────────────────────────────
  *  · `runOwnerOk` 三读面(head / audit 单读 / events):`owner === null` 那一支**本来就放行**
- *    (判据是 `owner !== null && principal !== owner`),不需要本臂。[4198] 帖文里「单读 404」一句
+ *    (判据是 `owner !== null && principal !== owner`),不需要本臂。[ref] 帖文里「单读 404」一句
  *    经亲读实现行**不成立**,已加现状钉(session-head-probe.test.ts)锁住这个事实。
  *  · `PUT /v1/sessions/:id/policy` 的 `owner === null ⇒ 409 conflict.session_ownerless`:那是**有意的
  *    fail-closed** —— 无主会话没有稳定的 run-principal,存下去的规则读不到、静默失效。放宽它等于制造
  *    一条 fail-open,不在本臂辖域。
  *  · `…/sync/*`(PULL/PUSH/import):PULL 虽是只读、形同 workspace,但这一族**带一条破坏性 import 腿**
- *    (`isDestructiveSessionWrite` 明列),而 [4198]/[4225] 裁的是会话**读面与生命周期**四门。放宽一个
+ *    (`isDestructiveSessionWrite` 明列),而 [ref]/[ref] 裁的是会话**读面与生命周期**四门。放宽一个
  *    写面族超出裁定射程 —— 要做另立一次表态,不在本臂里顺手带过。
  *
  * @param requirePrincipal `config.requirePrincipal`(条件①)
@@ -89,7 +89,7 @@ export type OwnerAwareSessionStore = SessionStore & {
     ownerOf?: (sessionId: string) => Promise<string | null | undefined>;
     register?: (sessionId: string, owner: string | null) => Promise<void>;
     /** E16 — enumerate the caller's sessions (owner-filtered on the session store's OWN owner column).
-     *  `includeUnowned` = [4198] 窄互认第二臂的**第三条件**(`owner IS NULL`)的 SQL 承载位:置真时
+     *  `includeUnowned` = [ref] 窄互认第二臂的**第三条件**(`owner IS NULL`)的 SQL 承载位:置真时
      *  谓词放宽为 `owner = ? OR owner IS NULL`。只在 `owner` 在场时有意义(路由已判①③);`owner` 缺席
      *  (fleet-wide)时本位无效——那一面本来就不钉 owner。 */
     listSessions?: (opts: {
@@ -107,7 +107,7 @@ export type OwnerAwareSessionStore = SessionStore & {
     /** E18 — the session's current leaf `SessionTreeEntry.id` (a cache-bypassing single read), so the resume-at
      *  turn-capture can pair it with the turn's message eventId. null when the session has no leaf / does not exist. */
     getLeafId?: (sessionId: string) => Promise<string | null>;
-    /** [1196] 六轮复审:owner+leafId 单行原子快照(SSE watch 探针租户围栏读;两独立读在 delete/reclaim
+    /** [ref] 六轮复审:owner+leafId 单行原子快照(SSE watch 探针租户围栏读;两独立读在 delete/reclaim
      *  缝里可拼出混世代组合)。undefined=无此会话。 */
     getHead?: (sessionId: string) => Promise<{
         owner: string | null;
@@ -190,7 +190,7 @@ export interface AuthContext {
     /** Long-term memory scope, derived from the principal (not the body). Undefined disables memory. */
     memoryScope?: string;
     /** 142-S4:the request's SHAPE-VALIDATED **且已归一(小写)** 的 projectId(body.projectId 过 core
-     *  `PROJECT_ID_REGEX` 门后折小写回传;A-033.1/#256 宽读严写 —— 词法带 /i 收下大写形,但派生 scope 键
+     *  `PROJECT_ID_REGEX` 门后折小写回传;[ref]/[ref] 宽读严写 —— 词法带 /i 收下大写形,但派生 scope 键
      *  与 config.projects 查表都只认这一个归一形,否则同一个项目会按大小写分成两只记忆盘)。
      *  身份半场(scope 的 tenant 段)永远来自 verified principal — projectId 只选「哪个项目盘/哪条登记」
      *  (config.projects 查表键 + proj: 键的 projectId 段),不是 capability。main.ts 拿它查 defaultScopes。 */
@@ -252,7 +252,7 @@ export declare function assertPrincipalShape(principal: string): void;
  *  each call site re-deriving the "_" ⇄ no-principal mapping inline. */
 export declare const CHECKPOINT_PUBLIC_SCOPE: "_";
 /**
- * 🔴 A-057.44(2026-08-19)—— **后台子代注册簿的匿名租户键**,与上面那只 checkpoint 哨兵是
+ * 🔴 [ref](2026-08-19)—— **后台子代注册簿的匿名租户键**,与上面那只 checkpoint 哨兵是
  * 「同一件事(没有 principal)的两套写法」。
  *
  * 写侧不是本仓能单方面改的:core 的 `treeScope = reviveClaim?.row.scope ?? ctx.principal ??
@@ -265,7 +265,7 @@ export declare const CHECKPOINT_PUBLIC_SCOPE: "_";
  */
 export declare const BACKGROUND_REGISTRY_ANON_SCOPE: "default";
 /**
- * checkpoint 的 scope → 该在哪些 **bg 注册簿分区**里找它的 parked 子代(A-057.44)。
+ * checkpoint 的 scope → 该在哪些 **bg 注册簿分区**里找它的 parked 子代([ref])。
  *
  * 匿名(`"_"`)⇒ 两个都查:`"_"`(将来若统一了写侧)与 `"default"`(今天 core 真写下去的那个)。
  * 其余 ⇒ 原样单查:有 principal 时两套约定折出**同一个**串(`encodeCheckpointScope` 只在 null/undefined
@@ -286,7 +286,7 @@ export declare const PRINCIPAL_TOKEN_HEADER = "x-approval-principal-token";
 /**
  * direct-door 决策证明三件套的另外两个头名(JWT 在上面那个常量里)。
  *
- * 为什么也具名(2026-08-08,#176 二轮扫描 finding):这三个头名此前在
+ * 为什么也具名(2026-08-08,[ref] 二轮扫描 finding):这三个头名此前在
  * `http/routes/approvals-assistant.ts` 的两个 `verifyDirectDoorProof` 调用点、以及 `http/server.ts` 的
  * CORS `access-control-allow-headers` 串里**各手抄一份**——而 CORS 那一行同一句里已经在用
  * `${principalHeader}` 插值另一个头名,证明具名写法在该处本就可用。改任一头名时漏改 CORS 串的后果

package/dist/session-leaf-bus.d.ts

@@ -1,6 +1,6 @@
 /**
  * Session leaf-advance bus — the S2 fast path of the session-level SSE subscription
- * ([1196]/[1208]③: an append that lands on THIS replica fans out to watchers synchronously,
+ * ([ref]/[ref]③: an append that lands on THIS replica fans out to watchers synchronously,
  * zero latency on single-replica deployments; cross-replica watchers still ride the probe lane).
  *
  * Deliberately a REPLICA-LOCAL singleton (module state), not a constructor-threaded dependency:

package/dist/session-sync-content.d.ts

@@ -7,7 +7,7 @@
  * 「同 id、异载荷」结构上完全可能(wire 本身就收调用方给的 entries)。第一半的后果已知:Phase A 判 `identical`
  * ⇒ 整段跳过、调用方拿 200 而目的端仍是自己那份内容(真 HTTP 复现过)。
  *
- * 🔴 **第二半是我一开始判错的地方**:我在黑板 [1701] 说「server 单方面修不了」。那句只对 **Phase A** 成立
+ * 🔴 **第二半是我一开始判错的地方**:我在黑板 [ref] 说「server 单方面修不了」。那句只对 **Phase A** 成立
  * (那时 server 手上没有源端内容,必须靠调用方送摘要)。但 **commit 时 server 同时握着两份日志**
  * (staged + dst),所以内容比较**根本不需要调用方配合** —— 而 4 处 commit/import 路径当时都写着
  * 「`relation === "identical"` ⇒ 跳过 entries 写入」,把「id 集合相等」当成了「内容相同」。
@@ -20,7 +20,7 @@
  * 因为这里**分叉的代价是多同步一趟,不是错答案、也不是拒绝**(审批路径上分叉会拒掉一个合法的人类决定,
  * 方向相反)。
  *
- * ── ⚠️ v1 摘要下本判据的**退化行为**(core 黑板 [1709];1.415.0 已修,现行下限已远高于此 ——
+ * ── ⚠️ v1 摘要下本判据的**退化行为**(core 黑板 [ref];1.415.0 已修,现行下限已远高于此 ——
  *     承重下限与理由见 `test/core-dependency-floor.test.ts`,别在这里记版本号)────────────────
  * v1 的摘要区分 `{a: undefined}` 与 `{}`,而 core 自己成规模产 own-key=undefined 的 entry ⇒ 同一份日志的
  * 内存形与 JSON 往返形摘要必然不同。本函数在 commit 处比的是 **staged**(刚从 wire 解析,JSON 形)与 **dst**
@@ -32,7 +32,7 @@
  *   换成「依赖下限 + 行为门」—— 名字门只认识旧名字,守不住这条性质;见 server.ts Phase A 段注释与
  *   `test/sync-content-digest.test.ts`。)
  *
- * ⚠️ 抽成共享函数而不是在 4 处各写一遍:core [1689] RB-74 的教训(宣布"同族类修完成"而三个实现只落了一个),
+ * ⚠️ 抽成共享函数而不是在 4 处各写一遍:core [ref] [ref] 的教训(宣布"同族类修完成"而三个实现只落了一个),
  * 本仓今天也刚在 33 处 exec→FileError 包装上吃过同款。判据收成一处,才谈得上机器看守。
  */
 import { type SessionTreeEntry } from "@sema-agent/core";
@@ -47,7 +47,7 @@ import { type SessionTreeEntry } from "@sema-agent/core";
  */
 export declare function identicalIdsAlsoIdenticalContent(staged: readonly SessionTreeEntry[], dst: readonly SessionTreeEntry[] | null): boolean;
 /**
- * `fast_forward` 的**内容判据**([2557] 审计 A5/F2,2-i)——id 分类器的另一格盲区:
+ * `fast_forward` 的**内容判据**([ref] 审计 A5/F2,2-i)——id 分类器的另一格盲区:
  * `dst ⊆ src` 只说明 **id 集合**是子集,共享 id 的**载荷**可能已分叉(目的端把某条 entry
  * 补写/纠正过、id 不变,源端拿着旧版本 + 新追加)。此时按「clean append」整段换装,
  * 目的端那几条纠正会被**静默销毁** —— §7「会丢目的端历史必须 409(除非显式 overwrite-dst)」

package/dist/session-sync-kernel.d.ts

@@ -1,5 +1,5 @@
 /**
- * 2c session-sync KERNEL (design/158 A2) — the PURE half of session-sync: the §7 relation classifier, the staging-id
+ * 2c session-sync KERNEL ([ref] A2) — the PURE half of session-sync: the §7 relation classifier, the staging-id
  * scheme, the {@link StagingHandle}/{@link ImportStagingStore} contracts and the {@link SyncConflictError} type.
  * Moved VERBATIM out of session-sync.ts (which keeps the StoreBackend-coupled ORCHESTRATION: exportSession/
  * importSession/planSync) so the three DB session adapters (local/pg/tidb) and security.ts can depend on these
@@ -72,7 +72,7 @@ export declare function realIdOfStaging(stagingId: string): string | null;
  * Mirrors the file-snapshot store's `BLOB_GC_GRACE_MS` discipline (an in-flight import must never be reaped
  * mid-stream).
  *
- * 🔴 住在 kernel 里而不是任一个店里(2026-08-08,#176 二轮扫描 finding):TiDB 与 PG 两个孪生店原先**各
+ * 🔴 住在 kernel 里而不是任一个店里(2026-08-08,[ref] 二轮扫描 finding):TiDB 与 PG 两个孪生店原先**各
  * 抄一份**同值常量,PG 那份的注释甚至自称「twin of the TiDB store's STAGING_GC_GRACE_MS」——明知孪生却
  * 不共享。单边改值的后果是两个后端对「同一个中断的导入还能不能收」判定分家,而两边都按自己的常量静默
  * 正确工作。这里是两个店**本就都 import** 的那个叶子模块(店契约纪律:适配器不许 import 自己的孪生,

package/dist/session-sync.d.ts

@@ -3,7 +3,7 @@
  * `StoreBackend` (sema-internal server/docs/DESIGN-session-sync.md §5–§10, §15). The PUSH half is the two-phase
  * staged streamed import in `src/http/routes/session-sync.ts` (§8 fanout re-implemented there, entries-off-the-wire).
  *
- * 🪦 **TOMBSTONE (2026-08-06, mechanical removal car, [2557] 2-i precondition + #51 死码判定)**: this module used to
+ * 🪦 **TOMBSTONE (2026-08-06, mechanical removal car, [ref] 2-i precondition + #51 死码判定)**: this module used to
  * ALSO export a whole-bundle `exportSession`/`importSession` orchestrator pair (the P1b one-shot in-memory move:
  * read entries+snapshots+policy+anchors into one {@link SessionBundle}, replay them across backends in the §8
  * atomic order). #51's audit (src git history around this date; see `test/session-sync-routes.test.ts`'s former
@@ -11,7 +11,7 @@
  * call sites** — PULL uses `exportSessionManifest` below + the keyset-paged NDJSON `/sync/entries` stream; PUSH uses
  * the two-phase staging route, which reimplements the §8 fanout itself (`handle.commit` / `importManifest` /
  * `putRules` / `resumeAnchorStore().put`) and never called `importSession`. The only consumers were three test
- * files. [2557] 2-i's precondition for removal (B4/G1 re-anchored to the live streaming path) was met, so this car
+ * files. [ref] 2-i's precondition for removal (B4/G1 re-anchored to the live streaming path) was met, so this car
  * deleted both functions + the tests that existed solely to exercise them.
  *
  * ⚠️ **Two invariants the deleted `importSession` uniquely protected have NO live-route equivalent** (verified by
@@ -32,14 +32,14 @@
  *      bundle carries, never deletes a dst-only row. A dangling anchor pointing at a purged entry, or a
  *      dst-only-principal policy row from the abandoned branch, can survive an overwrite-dst PUSH on the live
  *      route. The deleted tests (fanout-characterization §C C1/C1b, `session-sync-routes.test.ts`'s deleted
- *      "[2195] 同族: overwrite-dst wipe" describe) pinned this ONLY on the dead function.
+ *      "[ref] 同族: overwrite-dst wipe" describe) pinned this ONLY on the dead function.
  * Neither gap is fixed by this car (mechanical removal, no behavior changes) — they are reported here + in the
  * removal's final report for separate triage (port the fix to the live route, or explicitly accept the regression).
  *
- * ✅ **STATUS UPDATE (2026-08-06 同日,#137 红先修绿)**:上面两条「NO live-route equivalent」已作废——
- * 两个保护都已移植到活路由(本文件尾部 #137 段:`sameRulesContent`/`replayPolicyRecords`/
+ * ✅ **STATUS UPDATE (2026-08-06 同日,[ref] 红先修绿)**:上面两条「NO live-route equivalent」已作废——
+ * 两个保护都已移植到活路由(本文件尾部 [ref] 段:`sameRulesContent`/`replayPolicyRecords`/
  * `overwriteWipeIncapable`/`wipeSessionAttendants`;路由接线=src/http/routes/session-sync.ts 的两条重放腿
- * + commit 后擦除步 + commit 前能力预检 501)。判据钉=fanout-characterization「#137 live 路由无等价物
+ * + commit 后擦除步 + commit 前能力预检 501)。判据钉=fanout-characterization「[ref] live 路由无等价物
  * 缺口」describe(L1 rev 零漂移+反向臂 / L2 三子系统擦除+共享 key 换源端字节 / L3 缺 seam fail-loud),
  * L1/L2 先红后绿,两处变异抽验(擦除步禁用⇒L2 红、等值跳过禁用⇒L1 红)。原文保留供考古。
  */
@@ -56,7 +56,7 @@ export type BlobGetter = (hash: string) => Promise<Uint8Array | undefined>;
 export interface FileHistoryImportFace {
     importHistory(scope: string, data: FileHistoryExport, srcGetBlob: BlobGetter): Promise<FileHistoryResult>;
 }
-/** Single-point capability probe (design/158 R7): does `fs` carry the optional `importHistory` seam?
+/** Single-point capability probe ([ref] R7): does `fs` carry the optional `importHistory` seam?
  *  Returns the bound method (never a naked function reference — `this` inside must resolve to `fs`) or
  *  `undefined` when absent. Callers gate on the RETURN VALUE, not a separate `typeof` check, so there is
  *  exactly one place that knows the shape of the probe. */
@@ -90,7 +90,7 @@ export interface SessionBundle {
     entries: SessionTreeEntry[];
     /** The session's per-edited-file rewind history graph (core's versioned `FileHistoryExport` envelope —
      *  tracked set + version chains + boundaries; blob BYTES travel separately, content-addressed). `null` =
-     *  no history / the source store cannot export. Replaces the retired E19 `snapshots` manifests (S-15). */
+     *  no history / the source store cannot export. Replaces the retired E19 `snapshots` manifests ([ref]). */
     fileHistory: FileHistoryExport | null;
     /** Every (principal, rules) record for the session, across ALL principals (E6 `listBySession`). */
     policy: SessionRulesRecord[];
@@ -117,7 +117,7 @@ export interface SessionManifest {
     entryCount: number;
     /** The session's current leaf `SessionTreeEntry.id` (session_meta.leaf_id), or null if it has none. */
     leafId: string | null;
-    /** The per-edited-file rewind history envelope (S-15; see {@link SessionBundle.fileHistory}). EXACTLY as the bundle. */
+    /** The per-edited-file rewind history envelope ([ref]; see {@link SessionBundle.fileHistory}). EXACTLY as the bundle. */
     fileHistory: FileHistoryExport | null;
     /** Every (principal, rules) record across ALL principals (E6 `listBySession`). EXACTLY as the bundle. */
     policy: SessionRulesRecord[];
@@ -152,24 +152,24 @@ export declare function exportSessionManifest(sessionId: string, srcBackend: Sto
  * between the source's full durable log and the destination's current log (a `null` dst log ⇒ `fresh`). No writes.
  */
 export declare function planSync(sessionId: string, srcBackend: StoreBackend, dstBackend: StoreBackend): Promise<SyncRelation | null>;
-/** #137 ①(死码 A6 修的移植):同内容判据 —— 比较「归一化、去 rev」后的字节形。putRules 每次
+/** [ref] ①(死码 A6 修的移植):同内容判据 —— 比较「归一化、去 rev」后的字节形。putRules 每次
  *  无条件写都 rev+1,而 rev 是 operator 乐观锁的 CAS 令牌(`PutRulesOptions.expectedRev`),
  *  幂等重试/无害重复同步不该把在途 CAS 打失败。归一化用 core 的 `normalizeRules`(store 落盘
  *  前走同一函数 ⇒ 两侧同坐标);`stripRev` 去掉记录内嵌的 rev(`listBySession` 的 rules 含 rev,
  *  它不是内容)。 */
 export declare function sameRulesContent(stored: StoredSessionRules | null, incoming: SessionPermissionRules): boolean;
-/** #137 ① 的重放腿共享实现:PUSH 路由的两条 policy 重放腿(Phase A identical 短路支 / Phase B
+/** [ref] ① 的重放腿共享实现:PUSH 路由的两条 policy 重放腿(Phase A identical 短路支 / Phase B
  *  commit 后支)都从这里走 —— 等内容跳过(rev 零漂移),真变更照常落地(E6 tighten-only 门在
  *  putRules 内部,此处不重述)。 */
 export declare function replayPolicyRecords(store: Pick<SessionPolicyStore, "getRules" | "putRules">, sessionId: string, records: readonly SessionRulesRecord[], operatorOk: boolean): Promise<void>;
-/** #137 ② 能力预检(fail-loud 方向,[2195] 判据:保护型能力缺席=fail-closed):consented
+/** [ref] ② 能力预检(fail-loud 方向,[ref] 判据:保护型能力缺席=fail-closed):consented
  *  overwrite-dst 需要 policy 店的 `deleteBySession` purge seam 才能不留混合态;缺席=true,路由在
  *  commit **之前**用它干净中止(此时零写入落地),wire 拒因字面量归路由所有(api-error-text-freeze
  *  锚字面站点)。anchor 店的 deleteBySession 是类型必填、history 店有 core 必填的 `reap` 兜底(+
  *  {@link replayFileHistory} 的 conflict 收敛臂),都不构成缺席面;唯一可缺的就是 policy 这条
  *  (core 接口上是可选方法)。 */
 export declare function overwriteWipeIncapable(policyStore: ServiceSessionPolicyStore | undefined): boolean;
-/** #137 ②(死码 ⓪ 擦除步的移植):consented overwrite-dst = keep-source,结果必须是**源端那
+/** [ref] ②(死码 ⓪ 擦除步的移植):consented overwrite-dst = keep-source,结果必须是**源端那
  *  一份**,不得混成「源端对话 + 目的端遗留 policy/anchor/历史」(混合态比丢历史更危险:悬空
  *  anchor 指向已 purge 的 entry、被放弃分支的 policy 行继续 gating、目的端旧历史图挡住源端图的
  *  importHistory 空目标法则)。调用时点=commit(原子 swap)成功**之后**、附随物重放**之前**:

package/dist/session-titler.d.ts

@@ -48,7 +48,7 @@ export interface SessionTitlerDeps {
 }
 export interface SessionTitler {
     /** Fire-and-forget: maybe generate + persist a title for this session. Never throws, never blocks the caller. */
-    /** `model`([1992]②)= 本 turn 真实驱动的模型——带上则标题 hook 同链路,不再裸落 env 缺省。 */
+    /** `model`([ref]②)= 本 turn 真实驱动的模型——带上则标题 hook 同链路,不再裸落 env 缺省。 */
     maybeTitle(sessionId: string, objective: string, model?: string): void;
 }
 export declare const TITLE_MAX_CHARS = 80;

package/dist/session-watch.d.ts

@@ -1,6 +1,6 @@
 /**
  * Session-watch registry — the server half of the session-level SSE subscription
- * (design: sema-internal `server/docs/SESSION-SSE-DESIGN.md`, 黑板 [1164]①/[1196]).
+ * (design: sema-internal `server/docs/SESSION-SSE-DESIGN.md`, 黑板 [ref]①/[ref]).
  *
  * One entry per watched session; N subscribers SHARE one probe loop (this is the whole point:
  * it converts web-side per-client polling into one per-replica probe). Two change channels:
@@ -20,7 +20,7 @@
  * invariant): no PG LISTEN/NOTIFY specialization, no shared bus. Latest-wins semantics: subscribers
  * converge on the newest leafId; intermediate hops may be dropped (content still comes from tail faces).
  */
-/** [1196] 二轮复审:SSE 资源旋钮的 env 解析——有界正整数,坏形(NaN/0/负/超界)一律回缺省并可观测
+/** [ref] 二轮复审:SSE 资源旋钮的 env 解析——有界正整数,坏形(NaN/0/负/超界)一律回缺省并可观测
  *  (坏 `SESSION_EVENTS_MAX_PROBES=foo` 若直进 Number() 会把帽谓词变恒假=无帽,拍距 NaN 进 setTimeout
  *  =0ms 紧循环打爆存储)。 */
 export declare function posIntEnv(raw: string | undefined, fallback: number, max?: number): number;
@@ -62,7 +62,7 @@ export declare class SessionWatchRegistry {
      * newest value (connection-level dedupe absorbs any overlap with the caller's own read).
      */
     subscribe(sessionId: string, owner: string | null, onHead: (leafId: string | null) => void, onEnd?: () => void): (() => void) | undefined;
-    /** [1196] 三轮复审(租户轮转围栏,同副本半场):session 删除即终结条目——通知全部订阅者(onEnd,
+    /** [ref] 三轮复审(租户轮转围栏,同副本半场):session 删除即终结条目——通知全部订阅者(onEnd,
      *  路由据此断流)+ 停探针 + 弃缓存 head(新租户同键重订阅=全新世代,旧 replay 不可能渗入)。 */
     dropSession(sessionId: string): void;
     /** S2 fast path: an append that landed on THIS replica. Safe to call for unwatched sessions (no-op).

package/dist/shared-memory-scope-authorizer.d.ts

@@ -1,10 +1,10 @@
 /**
- * design/177 v2/F4 —— shared-memory 读面的**授权折叠**:principal → 可读 org scope 集。
+ * [ref] v2/F4 —— shared-memory 读面的**授权折叠**:principal → 可读 org scope 集。
  *
  * 为什么复用 {@link OrgMemoryDirectory} 而不是另立一张表:「谁属于 org:acme」在一个进程里必须只有一个
  * 答案。core 的记忆准入 seam、`/v1/memory/*` 的属主门、以及这里的共享库读面读的是**同一个目录实例**
  * (`createOrgMemoryAdmissionWiring` 的产物),因此共享同一份 TTL 缓存 / 退避窗 / gen 高水位——吊销窗内
- * 三面不会公开分歧。各建各的目录 = 三个答案,那正是 design/170 §7 收编要消灭的东西。
+ * 三面不会公开分歧。各建各的目录 = 三个答案,那正是 [ref] §7 收编要消灭的东西。
  *
  * 🔴 判别联合原样透传(N3/C5 裁定的下游一致性):目录说 `unavailable` 时**绝不**折成「你不属于任何
  * org」。前者在模型面渲染成「连接不可用,恢复前拒读」(可重试),后者渲染成「本会话没有连接任何记忆库」
@@ -22,7 +22,7 @@ export interface SharedMemoryScopeAuthorizerOptions {
     /** 目录实例。**必须**与 core 准入 seam / memory-policy 面同一只(见头注)。 */
     directory: OrgMemoryDirectory;
     /**
-     * 部署自证的 org scope —— **取值口而非值**(A-057.40)。
+     * 部署自证的 org scope —— **取值口而非值**([ref])。
      *
      * 🔴 类型上是函数是刻意的,不是风格:这组 scope 的真源是 `config.projects` 的 `defaultScopes`,
      * 而 `config.projects` 被 config-center **就地热应用**(`mutateInPlace`,整表替换),env 腿恒空
@@ -32,7 +32,7 @@ export interface SharedMemoryScopeAuthorizerOptions {
      *    stores:[]}`,对模型面是「本会话没有连接任何记忆库」这种**终局式**空集(不是可重试的
      *    unavailable),运维以为配好了;
      *  · **撤销**方向更糟:项目/scope 下架后,principal-less 的单用户请求仍按旧快照继续被放行 ——
-     *    一次运维撤销动作**静默不生效**(#157 点名的静默类型),方向是 fail-OPEN。
+     *    一次运维撤销动作**静默不生效**([ref] 点名的静默类型),方向是 fail-OPEN。
      * 而且它没被登进 `config-center/restart-signal.ts` 的 `RESTART_SLICES` ⇒ `/health` 连一句
      * 「该重启了」都不会说。⇒ 收口是把读取时机对齐消费时机:每次 `resolve` 现取。
      * (缺席 = 部署没有任何自证 scope,与传 `() => []` 等价。)

package/dist/sighup-idle.d.ts

@@ -1,5 +1,5 @@
 /**
- * B3(壳侧 [771]② 取证):SIGHUP 的 hup-pending 空闲窗。
+ * B3(壳侧 [ref]② 取证):SIGHUP 的 hup-pending 空闲窗。
  *
  * SIGHUP(壳窗口关闭打到整个进程组)≠「没人在用这只引擎」:共享引擎形态(同 config 多壳会话,引擎按
  * T11 防孤儿拍骑在首壳进程组里)下 peer 会话还活着——无条件 drain 会把 peer mid-turn 斩掉(499)且窗内

package/dist/spec-fields.d.ts

@@ -11,7 +11,7 @@ import { type AgentDefinition, type TaskSpec } from "@sema-agent/core";
  */
 export declare function normalizeSuggestNextPrompts(v: unknown): TaskSpec["suggestNextPrompts"];
 /**
- * design/131 (core 1.246) — normalize `body.resilience` → `TaskSpec.resilience`. INTENT flags only:
+ * [ref] (core 1.246) — normalize `body.resilience` → `TaskSpec.resilience`. INTENT flags only:
  * `allowDegrade:false` / `allowFailover:false` let a bench/eval or critical task say "fail rather than fall back".
  * `bypassBreaker` is OPERATOR-FACING (不给 wire 用户直开 — it punches through a shared circuit breaker,
  * which exists to protect the provider): honored only when the request principal is an explicit operator; silently
@@ -21,7 +21,7 @@ export declare function normalizeSuggestNextPrompts(v: unknown): TaskSpec["sugge
  */
 export declare function normalizeResilience(v: unknown, operator: boolean): TaskSpec["resilience"];
 /**
- * design/133 (core 1.251) — normalize `body.attachments` → `TaskSpec.attachments`. Core's contract is
+ * [ref] (core 1.251) — normalize `body.attachments` → `TaskSpec.attachments`. Core's contract is
  * literal-true unions ("关闭=删 key,勿传 false"): only `true` (or, for changedFiles, an object with a sane
  * `maxFiles`) survives; `false`/garbage per key is DROPPED, not forwarded. maxFiles clamped 1..100 (core caps its
  * own stat cost at 20 by default; the clamp only guards against a resume replaying a wild persisted value).
@@ -30,29 +30,29 @@ export declare function normalizeResilience(v: unknown, operator: boolean): Task
  */
 export declare function normalizeAttachments(v: unknown): TaskSpec["attachments"];
 /**
- * [833] rewind exclusive mode (core 1.292) — normalize `body.resumeAtMode` → `TaskSpec.resumeAtMode`. DEFENSIVE
+ * [ref] rewind exclusive mode (core 1.292) — normalize `body.resumeAtMode` → `TaskSpec.resumeAtMode`. DEFENSIVE
  * (the resume path re-runs resolveSpec WITHOUT the HTTP 400 gate): only the two enum values survive, and only when
  * the resume-at handle actually RESOLVED (core ignores the field without `resumeAt`; keep the spec tight instead of
  * shipping a dangling qualifier). Absent/garbage ⇒ undefined = core default "at" (zero regression).
  */
 export declare function normalizeResumeAtMode(v: unknown, resumeAtResolved: boolean): "at" | "before" | undefined;
-/** [876] 防御上限:一份请求最多带多少个 agent 定义。core 侧无上限;这里封一个防御值 —— 每个定义都进
+/** [ref] 防御上限:一份请求最多带多少个 agent 定义。core 侧无上限;这里封一个防御值 —— 每个定义都进
  *  系统提示(whenToUse/skills/systemPrompt 全是 prompt 载荷),不设界就是 per-turn token 成本洞(与
  *  MAX_USER_SKILLS 同轴)。32 足够覆盖 CC 式 `.claude/agents/` 全家桶还有余量。 */
 export declare const MAX_TASK_AGENTS = 32;
-/** [876] 单条 agent 定义的形状裁决:null=合法;否则一句可 400 的英文错误(不带索引,调用方自己加)。
+/** [ref] 单条 agent 定义的形状裁决:null=合法;否则一句可 400 的英文错误(不带索引,调用方自己加)。
  *  白名单外键 fail-loud —— 与 resilience/limits 的「容忍未知键」相反:agents 是能力定义,静默丢字段 =
  *  定义被悄悄削(一个丢掉的 isolation 就是放宽),比 400 更危险,故整条拒。⚠️ 已知残账(core 半场):
  *  core 只对 allowTools 未知项 fail-loud,denyTools 未知项(如 typo)静默失效 —— 已上板请 core 镜像。
  *  ⚠️ 键判断必须 Object.hasOwn:`in` 走原型链,JSON 里的 "toString"/"constructor"/"__proto__" 键会被
  *  误判为白名单字段,随后 SHAPES[k].ok 不是函数 ⇒ TypeError(fresh 500 / resume 砖;cross-review 复现)。 */
 export declare function taskAgentIssue(item: unknown): string | null;
-/** [876] HTTP 门(fresh submit,server.ts prepareSpec):body.agents 在场必须是非空数组、每条过
+/** [ref] HTTP 门(fresh submit,server.ts prepareSpec):body.agents 在场必须是非空数组、每条过
  *  {@link taskAgentIssue}、name 数组内唯一、条数 ≤ {@link MAX_TASK_AGENTS}。返回 400 错误串或 null。
  *  RESUME 重放不过这道门 —— {@link taskAgentsFromBody} defensive(按条 DROP+warn,不砖 resume)。 */
 export declare function validateTaskAgents(v: unknown): string | null;
-/** [876] body.agents → `TaskSpec.agents`(resolveSpec 的唯一装配点;main.ts 只 spread)。两层门:
- *   - 🔒 TOB 租户门:多租户(requirePrincipal===true)暂不放行 —— [876] 原文「TOB 面按租户 caps 门」,
+/** [ref] body.agents → `TaskSpec.agents`(resolveSpec 的唯一装配点;main.ts 只 spread)。两层门:
+ *   - 🔒 TOB 租户门:多租户(requirePrincipal===true)暂不放行 —— [ref] 原文「TOB 面按租户 caps 门」,
  *     当前没有 per-tenant caps 面可挂,先 fail-closed 关多租(warn `task_agents_ignored`,capabilities
  *     的 `taskAgents` 同步 advertise false);单机/单用户直通(caller 是自己 worker 的 super-admin,
  *     与 mcpInjection/hooks 同一姿势)。
@@ -60,14 +60,14 @@ export declare function validateTaskAgents(v: unknown): string | null;
  *     `task_agent_dropped`(绝不 throw 砖 resume);重名后到者 DROP;超上限截断。幸存字段按白名单拷贝
  *     (不透传未知键 —— 非法项已整条 drop,这里只是让持久化 body 的杂键不上 spec)。全空 ⇒ undefined。 */
 export declare function taskAgentsFromBody(raw: unknown, requirePrincipal: boolean | undefined, warn: (event: string, fields: Record<string, unknown>) => void): AgentDefinition[] | undefined;
-/** [5673]②/[5697](cli 认领消费)—— fresh-submit 的 agents[].model **目录成员资格**门(形状门
+/** [ref]②/[ref](cli 认领消费)—— fresh-submit 的 agents[].model **目录成员资格**门(形状门
  *  {@link validateTaskAgents} 通过之后跑;调用方铸 400 `request.unknown_reference` + `available` 枚举)。
  *  病灶=报错太晚太远:server 持目录却不查,错到 core prepare 才炸 `config.agent.unknown_model`
  *  (dist/agents/subagent.js:1258),以「run failed」形出现而非 400;cli resolver 只挡词法形,目录
  *  成员资格只有 server 持有。
  *  三条判定纪律(全部 core dist 亲读):
  *   - **只查 string 形**:core 只对 `typeof a.model === "string"` 走 `resolveModel`(subagent.js:1253);
- *     Model 对象形 core 原样信任不查目录([879]④ 契约:自带完整 Model 配置,其 id 本就不必在目录)——
+ *     Model 对象形 core 原样信任不查目录([ref]④ 契约:自带完整 Model 配置,其 id 本就不必在目录)——
  *     对象形没有「晚失败」病灶,这里同拒会是射程外的行为收紧,不做。
  *   - **`catalog` 必须是 tier 展开形**(调用方传 `expandTiers(config.models, config.tiers) ?? config.models`,
  *     resolve-spec.ts wireCatalog 同源纪律):core Runner 构造期把 deps.models 换成展开目录
@@ -81,31 +81,31 @@ export declare function unknownTaskAgentModelRef(agents: readonly unknown[], cat
     index: number;
     ref: string;
 } | undefined;
-/** [876] main.ts resolveSpec 的 agents 装配片段(可 import 真 fold,[1.211 codex L]:此前 main.ts 用内联
+/** [ref] main.ts resolveSpec 的 agents 装配片段(可 import 真 fold,[1.211 codex L]:此前 main.ts 用内联
  *  闭包,测试只能 SOURCE PIN 文本+重写同构表达式——文本锚可被「移出 resolveSpec 但保留同文」静默骗过;
  *  现在行为测试直接调这个真出口,main.ts 只剩一次调用点可锚)。语义=taskAgentsFromBody 的条件 spread:
  *  有幸存 agents 才挂键(absent/全 drop ⇒ 空对象,spec byte-compat)。 */
 export declare function taskAgentsSpecFragment(raw: unknown, requirePrincipal: boolean | undefined, warn: (event: string, fields: Record<string, unknown>) => void): {
     agents?: AgentDefinition[];
 };
-/** [854]② — body.retainBackgroundProcesses → `TaskSpec.retainBackgroundProcesses`。core 语义(1.295
+/** [ref]② — body.retainBackgroundProcesses → `TaskSpec.retainBackgroundProcesses`。core 语义(1.295
  *  runtask/task-registry dist 亲读):`=== true` 时任务收尾不主动收割 session 后台进程 —— host lane 上是
  *  资源驻留授予,与 backgroundShell 同款单用户闸:多租户 warn 忽略(`task_retain_bg_ignored`,capability
  *  同步 advertise false)。只 literal `true` 上 spec(false=core 缺省,不挂键保持 byte-compat);非 boolean
  *  由 HTTP 门 400,resume 重放这里 defensive DROP(不 throw)。 */
 export declare function retainBackgroundProcessesFromBody(raw: unknown, requirePrincipal: boolean | undefined, warn: (event: string, fields: Record<string, unknown>) => void): true | undefined;
-/** [1052]② — body.{excludeTools,deferTools} → `TaskSpec.{excludeTools,deferTools}`(core 1.314 工具面
+/** [ref]② — body.{excludeTools,deferTools} → `TaskSpec.{excludeTools,deferTools}`(core 1.314 工具面
  *  控制批)。语义:excludeTools=roster 真卸载(schema 字节不上 wire,manifest 如实收窄);deferTools=
- *  design/36 延迟披露(占位上 wire,ToolSearch 激活 materialize)。两位 tighten-only(core 继承不变量:
+ *  [ref] 延迟披露(占位上 wire,ToolSearch 激活 materialize)。两位 tighten-only(core 继承不变量:
  *  union 进全部子 spawn 路径),per-run 工具面收窄无跨租户面 ⇒ 无租户门(interactiveTools 同姿势)。
  *  DEFENSIVE(resume 重放不过 HTTP 400 门):非数组 ⇒ undefined;项非非空字符串 ⇒ 逐项 DROP;空数组 ⇒
  *  undefined(不挂键=core 缺省,byte-compat)。HTTP 门另有 fail-loud 400(提交面邻居姿势)。 */
 export declare function toolNameListFromBody(raw: unknown): string[] | undefined;
-/** [1144]/[1146] — body.promptProfile → `TaskSpec.promptProfile`(core 1.328 R2 主件,CC LT(model_id)
+/** [ref]/[ref] — body.promptProfile → `TaskSpec.promptProfile`(core 1.328 R2 主件,CC LT(model_id)
  *  同构双形轴)。语义:纯呈现轴不碰策略(simple=CC 212 短形面缺省;classic=长形面,可按任务/模型试分)
  *  ⇒ 无租户门(deferTools 同姿势);全委托树继承由 core 管。缺省不挂键(引擎缺省 simple,byte-compat)。
  *
- *  ⚠️ **这不是一条 defer 注**(#277 件⑤ 对表结论,core [4352] 同判):本段说的是 `promptProfile` 这根
+ *  ⚠️ **这不是一条 defer 注**([ref] 件⑤ 对表结论,core [ref] 同判):本段说的是 `promptProfile` 这根
  *  **呈现**轴,它与 `deferMode` / `deferTools` 的延迟披露轴**无耦合** —— 上一行提 deferTools 只是在借它
  *  的「无租户门」姿势作类比。「引擎缺省 simple」这句本身在 core 5.40.0 上仍逐字为真
  *  (`core/types.d.ts:133`:default "simple"),本批亲验未变。
@@ -113,11 +113,11 @@ export declare function toolNameListFromBody(raw: unknown): string[] | undefined
  *  `src/capabilities/tool-defer.ts` 的头注 —— 别把两根轴的结论写到一处。
  *  DEFENSIVE(resume 重放不过 HTTP 400 门):非法值 ⇒ undefined;提交面另有 fail-loud 400(邻居姿势)。 */
 export declare function promptProfileFromBody(raw: unknown): "simple" | "classic" | undefined;
-/** [2856]②(core 5.14.0 `TaskSpec.toolMaterializeStrategy`):deferred 工具激活后的 schema 供给策略。
+/** [ref]②(core 5.14.0 `TaskSpec.toolMaterializeStrategy`):deferred 工具激活后的 schema 供给策略。
  *  与 {@link promptProfileFromBody} 同姿势的**防御性归一**——提交面的 fail-loud 400 在 HTTP 门,这里
  *  只负责 resume 重放存量 body 时把不认识的值静默 DROP(回落 core 的 env/缺省链),而不是把它带上 spec。 */
 export declare function toolMaterializeStrategyFromBody(raw: unknown): "static" | "swap" | undefined;
-/** [854]④ — 每键的运营方上限旋钮(env,缺省不设=不封顶)。 */
+/** [ref]④ — 每键的运营方上限旋钮(env,缺省不设=不封顶)。 */
 export interface TaskLimitCaps {
     /** TASK_TIMEOUT_MAX_SEC(env 名不动,仍按**秒**配置;core 5.8.0 起封顶对象是 limits.maxWalltimeMs,
      *  封顶比较时 ×1000 换算——运维面零迁移)。 */ timeoutSec?: number;
@@ -125,7 +125,7 @@ export interface TaskLimitCaps {
     /** TASK_MAX_TURNS_MAX */ maxTurns?: number;
 }
 /**
- * [854]④ — normalize `body.limits` → 请求方配速意图 {maxWalltimeMs?, maxOutputTokens?, maxTurns?}。DEFENSIVE
+ * [ref]④ — normalize `body.limits` → 请求方配速意图 {maxWalltimeMs?, maxOutputTokens?, maxTurns?}。DEFENSIVE
  * (resume 重放持久化 body 不过 HTTP 400 门):仅正的有限数字存活(floor 取整),0/负/垃圾按键 DROP —— core 侧
  * 墙钟 > 0 才生效(0=不设墙,会跳过运营方封顶)、maxTurns/maxOutputTokens 的 0 无意义。每键各自被
  * 运营方上限旋钮 clamp(Math.min;旋钮缺省不设=不封顶)。全空 ⇒ undefined。
@@ -144,7 +144,7 @@ export declare function normalizeApproachNotice(raw: unknown): false | {
     at?: [number, number];
 } | undefined;
 /**
- * [854]④ — body.limits 与 env 墙钟的合成规则(resolveSpec 的唯一 limits 装配点;run-local 无 body 车道不经此):
+ * [ref]④ — body.limits 与 env 墙钟的合成规则(resolveSpec 的唯一 limits 装配点;run-local 无 body 车道不经此):
  *  - `timeoutSec`:body 给了就用 body(caller 明确配速;已在 normalizeLimits 里被 TASK_TIMEOUT_MAX_SEC 封顶)。
  *    body 缺席保持既有姿势 = tenancy 墙钟 + env `TASK_TIMEOUT_SEC` 只抬不降(taskWallClockSec 内 Math.max,
  *    误配低值不能砍 council 预算)。注意两条纪律不叠加:「只抬不降」是 env 对内建缺省墙的规则,body 是

package/dist/ssh-host-key.d.ts

@@ -1,18 +1,18 @@
 /**
- * #296(A-052.2;clay 裁定 **C-R21** 形:「响亮警告继续连」)—— SSH lane 的**主机密钥校验**两旋钮。
+ * [ref]([ref];clay 裁定 **[ref]** 形:「响亮警告继续连」)—— SSH lane 的**主机密钥校验**两旋钮。
  *
  * ## 病灶(修前逐字形)
  * `connectOnce` 的 `ConnectConfig` 从来不设 `hostVerifier`,而 ssh2 在缺席时**不做任何主机密钥校验** ——
  * 这条 lane 于是恒等于 `ssh -o StrictHostKeyChecking=no`:握手对面是谁都照连、照把 agent 的命令与
- * sftp 写入交出去。适配器持有的是控制面注入的私钥(design/61 §5 #2),中间人拿不到私钥,但**拿得到
+ * sftp 写入交出去。适配器持有的是控制面注入的私钥([ref] §5 #2),中间人拿不到私钥,但**拿得到
  * 这次会话的全部命令、全部产物、以及 agent 在那台机器上的全部动作**。
  *
  * ## 为什么不是「一律拒连」(裁定形)
  * 本 lane 的既有部署形是「AI 编排批量部署到一批 SSH 可达的机器」,那些机器的密钥指纹通常不在任何
- * known_hosts 里。默认拒连 = 一次静默的**可用性**断裂,而 C-R21 裁的是:**在场即严格,缺席即响亮**。
+ * known_hosts 里。默认拒连 = 一次静默的**可用性**断裂,而 [ref] 裁的是:**在场即严格,缺席即响亮**。
  * 缺席那一格是登记在案的 fail-open(`server.exec-lane.ssh-host-key-unverified`,census §1),不是遗漏。
  *
- * ## 两旋钮(config 面 `SSH_HOST_FINGERPRINT` / `SSH_KNOWN_HOSTS`,坏值拒启 —— #210 律)
+ * ## 两旋钮(config 面 `SSH_HOST_FINGERPRINT` / `SSH_KNOWN_HOSTS`,坏值拒启 —— [ref] 律)
  *  · `fingerprintSha256` —— 主机公钥的 **SHA256 base64** 指纹(`ssh-keyscan` + `ssh-keygen -lf` 打印的
  *    那一串)。归一后存**裸 base64**(无 `SHA256:` 前缀、无 `=` 填充);
  *  · `knownHostsPath` —— known_hosts 文件路径,按 `host` / `[host]:port` **逐字**匹配行。
@@ -48,7 +48,7 @@ export declare function normalizeSshFingerprint(raw: string): string;
 /** ssh2 交来的**主机公钥 wire blob** → `SHA256:<base64>`(OpenSSH 打印的同一形,无 `=` 填充)。 */
 export declare function sshHostKeyFingerprint(key: Buffer): string;
 /**
- * 主机密钥判官(#296 / C-R21)。返回一个**收 ssh2 的公钥 blob、给判词**的闭包(有捕获行为 ⇒ `create*`)。
+ * 主机密钥判官([ref] / [ref])。返回一个**收 ssh2 的公钥 blob、给判词**的闭包(有捕获行为 ⇒ `create*`)。
  *
  * 缺席那一格调用 `onUnverified` —— **每连接一次**,不是每进程一次:一台长期未配旋钮的机器上,
  * 「这条 lane 一直在裸连」必须在每一条连接上都看得见,否则它会随第一条日志滚出视野。

package/dist/store-live-probe.d.ts

@@ -11,7 +11,7 @@
  * - 翻转披露(§M):live→dead warn `store_probe_dead`、dead→live info `store_probe_recovered`,
  *   只在翻转拍记(连续死不逐拍刷日志——down 的 DB 不该制造日志风暴);
  * - 诚实缺席:首拍落地前 state() = undefined(/health 键缺席=「还没探过」,不冒充「活」)。
- * - 面分级(#305):`state().error` 是**原始** message —— 它只喂给凭证后/本机的消费面;免鉴权的
+ * - 面分级([ref]):`state().error` 是**原始** message —— 它只喂给凭证后/本机的消费面;免鉴权的
  *   `/health` 一格由 wire 装配点过 {@link publicStoreProbeError} 换成闭集词(理由见该常量头注)。
  *
  * 探针原语:调用方给 `probe`(main.ts 传 `() => backend.dbNowMs!()`——既有 S10 时钟探针的真 DB
@@ -31,7 +31,7 @@ export interface StoreLiveProbe {
     stop: () => void;
 }
 /**
- * #305(安全轴):`/health` 免鉴权面上 `storeProbe.error` 可披露的**闭集词表**。
+ * [ref](安全轴):`/health` 免鉴权面上 `storeProbe.error` 可披露的**闭集词表**。
  *
  * 为什么必须是闭集而不是「脱敏后的原文」:`/health` 排在 `http/server.ts` 的鉴权门**之前**、缺省全网卡
  * 监听 ⇒ 任何能连到这个端口的人都读得到这一格;而它此前装的是**驱动原始异常 message 逐字**,DB 驱动