@sema-agent/server 7.52.0 → 7.53.0

package/dist/plugins/tidb-session-store.d.ts

@@ -17,12 +17,12 @@ import { type PlacementAcquireOpts } from "./session-placement.js";
 import { type StagingHandle } from "../session-sync-kernel.js";
 export declare class TiDBSessionStore implements SessionStore {
     private readonly pool;
-    /** #270 车1:托管留存声明。读法与「为什么 SQL 店答 managed 而实现体在别处」逐字见
+    /** [ref] 车1:托管留存声明。读法与「为什么 SQL 店答 managed 而实现体在别处」逐字见
      *  `retention-store-sql.ts` 的 {@link MANAGED_RETENTION}。 */
     readonly retention: import("@sema-agent/core").RetentionDeclaration;
-    /** #292 C18(core 5.48.0 design/323):placement **声明**。六条义务的实装点逐条见
+    /** [ref] C18(core 5.48.0 [ref]):placement **声明**。六条义务的实装点逐条见
      *  {@link SQL_SESSION_PLACEMENTS} 顶注与本类的 acquire / listSessions / release / listPlaced /
-     *  placementOf 各处的 `#292` 注。 */
+     *  placementOf 各处的 `[ref]` 注。 */
     readonly placements: {
         readonly subagent: {
             readonly durability: "durable";
@@ -34,16 +34,16 @@ export declare class TiDBSessionStore implements SessionStore {
     acquire(sessionId?: string, opts?: PlacementAcquireOpts): Promise<AcquiredSession>;
     private load;
     /** Idempotently create a session_meta row with an owner. Existing owner is never overwritten.
-     *  #292:`placement` 在场时与行同一条 INSERT 落六列;ON DUPLICATE 臂是 no-op ⇒ 已存在的行的元组
+     *  [ref]:`placement` 在场时与行同一条 INSERT 落六列;ON DUPLICATE 臂是 no-op ⇒ 已存在的行的元组
      *  **永不被重写**(first-write 不可变,义务 5 的写侧半场)。 */
     register(sessionId: string, owner: string | null, placement?: SessionPlacement): Promise<void>;
     /**
-     * #292 义务 6 的廉价探针 —— 一行 PK SELECT:`undefined` = 普通会话或无此行。
+     * [ref] 义务 6 的廉价探针 —— 一行 PK SELECT:`undefined` = 普通会话或无此行。
      * (release 的冷缓存腿、包装店的暖命中准入判、诊断面共用这一只。)
      */
     placementOf(sessionId: string): Promise<SessionPlacementRecord | undefined>;
     /**
-     * #292 义务 5 —— placed 分区的**自有枚举**(联合 reap 的分区腿输入)。
+     * [ref] 义务 5 —— placed 分区的**自有枚举**(联合 reap 的分区腿输入)。
      *
      * 年龄锚 = `COALESCE(updated_at, placed_at)`:`updated_at` 是本店的「最后活动」标记(register 时置、
      * 每次 append/touch 推进),取不到才回落 `placed_at` —— 与 core File 店「mtime 优先、placedAt 回落」
@@ -62,7 +62,7 @@ export declare class TiDBSessionStore implements SessionStore {
      *  an acquire lease) and cache-bypassing (the resume-at turn-capture reads it without touching the warm session).
      *  Returns the leaf id, or null when the session has none / no such session. */
     getLeafId(sessionId: string): Promise<string | null>;
-    /** [1196] 六轮复审:owner+leafId **单行原子快照**(SSE watch 探针的租户围栏读)——两独立 SELECT 在
+    /** [ref] 六轮复审:owner+leafId **单行原子快照**(SSE watch 探针的租户围栏读)——两独立 SELECT 在
      *  delete/reclaim 缝里可拼出「旧 owner+新 leaf」混世代组合;单 SELECT 单行=天然一致。undefined=无此会话。 */
     getHead(sessionId: string): Promise<{
         owner: string | null;
@@ -71,7 +71,7 @@ export declare class TiDBSessionStore implements SessionStore {
     /**
      * Durable history is retained; just drop any in-flight cache entry.
      *
-     * 🔴 #292 义务 4 —— **placed 会话例外:release 是真删除**(durable 史一并)。联合 reap 先按 rev 条件删
+     * 🔴 [ref] 义务 4 —— **placed 会话例外:release 是真删除**(durable 史一并)。联合 reap 先按 rev 条件删
      * 掉 agent 行、赢了才调本方法终结转录;若这里还按「归还租约」走,一条 30 天的转录就会失去属主行地
      * 悬着(正是这条义务要关死的 strand)。判据取**持久化元组**(冷缓存/重启后照样成立,不依赖任何进程
      * 内状态);删除本身是 ABA 安全的**条件删**(`placement_kind IS NOT NULL`)——探针与删除之间若真有
@@ -82,9 +82,9 @@ export declare class TiDBSessionStore implements SessionStore {
     release(sessionId: string): Promise<void>;
     /**
      * core B-17 的 `forget` 面 —— **丢引用,不动 durable 史**(与 {@link release} 的分工:release 是
-     * 生命周期终结口,forget 是「我用完了这只句柄」)。#292 之后这条分工是承重的:release 对 placed
+     * 生命周期终结口,forget 是「我用完了这只句柄」)。[ref] 之后这条分工是承重的:release 对 placed
      * 会话已是真删除,于是每一处「只为验存在 / 写完收工」的收尾都必须落在 forget 上(preflight 纪律,
-     * [4743] 义务①)。本店的进程内状态只有 in-flight 去重表,故实现就是丢那一格。
+     * [ref] 义务①)。本店的进程内状态只有 in-flight 去重表,故实现就是丢那一格。
      */
     forget(sessionId: string): void;
     /** 真删除一只 placed 会话的两张表(条件删门在 `placement_kind IS NOT NULL`;事务内 meta 先删=提交点,
@@ -205,7 +205,7 @@ export declare class TiDBSessionStore implements SessionStore {
      * atomic swap) or aborts. No row is touched here — the handle is a stateless cursor over this pool.
      */
     beginImportStaging(realSessionId: string, token: string): StagingHandle;
-    /** #292:「这个 id 是 placed ⇒ 该写路径不适用」的共用拒绝(session-sync 的两条换装腿共用)。 */
+    /** [ref]:「这个 id 是 placed ⇒ 该写路径不适用」的共用拒绝(session-sync 的两条换装腿共用)。 */
     private assertNotPlaced;
     /**
      * 2c session-sync P1d-β (staged-row inspection) — read the rows STAGED under `stagingId` (NO session_meta probe — a

package/dist/plugins/tool-result-store-sql.d.ts

@@ -9,7 +9,7 @@ export declare const PG_TOOL_RESULT_SCHEMA: string[];
 /** Idempotent schema apply for the tool_result table (for the integration test to call). */
 export declare function ensureSchema(pool: PgPool | PgPoolClient): Promise<void>;
 /**
- * #119 升级前置断言 —— **拒启**,不是 warn(codex 复审 [high],已核真)。
+ * [ref] 升级前置断言 —— **拒启**,不是 warn(codex 复审 [high],已核真)。
  *
  * 病:本仓不发 `ALTER TABLE` 迁移(标准裁定:改列就改 CREATE + 删库重建)。于是一台**没删表**就升上来的
  * 部署,`CREATE TABLE IF NOT EXISTS` 对它是空操作,旧表既没有出处两列也只有 `VARCHAR(190)` 的 ref 列。
@@ -26,25 +26,25 @@ export declare function assertToolResultProvenanceSchema(query: (sql: string) =>
 /** Dual-dialect durable ToolResultStore. See the file header for the dialect-delta ledger. */
 export declare class SqlToolResultStore implements ToolResultStore {
     protected readonly db: SqlDriver;
-    /** #270 车1:托管留存声明。读法与「为什么 SQL 店答 managed 而三方法的实现体在 `retention-store-sql.ts`」
+    /** [ref] 车1:托管留存声明。读法与「为什么 SQL 店答 managed 而三方法的实现体在 `retention-store-sql.ts`」
      *  逐字见 {@link MANAGED_RETENTION}(本店的 `tool_result` 行由那只聚合店按期清:随会话树删 + 孤儿腿)。 */
     readonly retention: import("@sema-agent/core").RetentionDeclaration;
     constructor(db: SqlDriver);
     /** Pick the dialect's SQL text. Both statements stay written out at the call site ON PURPOSE. */
     private q;
-    /** D1(试剂盒揪出,RB-266 语义):ref 是主键,而 `deleteBySession` 只认**记录下来的出处**与单射的
+    /** D1(试剂盒揪出,[ref] 语义):ref 是主键,而 `deleteBySession` 只认**记录下来的出处**与单射的
      *  `tr_<sid>~` 前缀(重扫二轮起;旧注写的 `tr_<sid>_%` 前缀清理已作废,理由见该方法顶注)——
      *  不合规 ref 的行既进不来、也就谈不上被 session 删除清掉,只能等 TTL。
      *
      *  🔴 判定**单源**:直调 core 的 `assertSafeToolResultRef`(core 2.8.0 起入公共面)。
-     *  在此之前这里是那 6 个判别条件的**本地镜像** —— 我在 [2159] 主动交出过这条裂缝:镜像是第二真源,
+     *  在此之前这里是那 6 个判别条件的**本地镜像** —— 我在 [ref] 主动交出过这条裂缝:镜像是第二真源,
      *  core 哪天收紧一格(加 Windows 保留名、长度上限……)我方不会跟着动,而**试剂盒会继续绿**
      *  (它测的是「拒不拒」,不是「按同一张表拒」)。core 按请求追加了导出,镜像随之删除,裂缝闭合。
      *  抛错文案与 core 逐字相同,所以 wire 与既有钉都不变。 */
     private isUnsafeRef;
     private assertSafeRef;
     /**
-     * #119(core 5.26.0)—— 出处的**写面**。语义一律取 core 单源(`assertToolResultProvenanceMatch`),
+     * [ref](core 5.26.0)—— 出处的**写面**。语义一律取 core 单源(`assertToolResultProvenanceMatch`),
      * 本方法只负责把它落到 SQL 上:
      *  · **写一次选举同时定属主** —— 内容与属主是同一条 INSERT,不存在「内容写进去了属主还没跟上」的窗口
      *    (core 头注允许 file 双对象后端出现这个窗口,单行后端没有,别自造);
@@ -58,7 +58,7 @@ export declare class SqlToolResultStore implements ToolResultStore {
      *  条 SELECT —— 分两次问会重新引入它要消灭的那个窗口。 */
     private readOwner;
     /**
-     * #119 —— 出处的**读面**。未知 ref 与「存了但无属主」两种情况都答 `undefined`:读面对二者一视同仁
+     * [ref] —— 出处的**读面**。未知 ref 与「存了但无属主」两种情况都答 `undefined`:读面对二者一视同仁
      * (fail-closed,谁都没被授权),所以这里也不必把它们分开报。
      */
     ownerOf(ref: string): Promise<ToolResultProvenance | undefined>;
@@ -76,14 +76,14 @@ export declare class SqlToolResultStore implements ToolResultStore {
     reapOlderThan(cutoffMs: number): Promise<number>;
     /**
      * E21 (§0.5 session delete) — purge offloaded tool results for one session. Selection is by the row's
-     * **recorded provenance** (`owner_session_id`, the #119 column `put` writes in the same statement as the
+     * **recorded provenance** (`owner_session_id`, the [ref] column `put` writes in the same statement as the
      * content) and by NOTHING else — **zero ref-derived arms**(codex R1-[high] 收窄:连单射新前缀也不作
      * 属主证据,理由在方法体内逐字引 core 顶注)。Returns `{deleted, unattributable}`; why NO prefix
      * (legacy `_` or injective `~`) is a deletion selector is inline below.
      *
      * ⚠️ 旧注两处已作废(重扫二轮更正,留档防复辟):① 「core namespaces every ref as `tr_<sid>_<callId>`」——
      * 5.26.0 起是 `~` 分隔的单射四段形,`_` 形只剩存量;② 「there is no `session_id` (or `owner`) column to
-     * guard on」—— #119 起**有**(`owner_session_id` / `owner_task_id`,boot 期还有拒启断言把没升级的表挡在
+     * guard on」—— [ref] 起**有**(`owner_session_id` / `owner_task_id`,boot 期还有拒启断言把没升级的表挡在
      * 外面),所以「按出处选行」不再是「awkward ref-correlated EXISTS」,它就是本方法现在的主选择器。
      *
      * 路由侧的 owner 门照旧在(DELETE 路由先 `ownerOf` 对属主、同一协调器里先跑 owner-guarded 的 run 账本

package/dist/plugins/usage-window-store-sql.d.ts

@@ -1,5 +1,5 @@
 /**
- * UsageWindowStore SQL twins(design/166-T1)——core 5.8.0 部署级 token 治理窗
+ * UsageWindowStore SQL twins([ref]-T1)——core 5.8.0 部署级 token 治理窗
  * (`RunnerDeps.usageWindows` + `usageWindowStore`)的 TiDB/PG 双方言实现。
  *
  * 语义单源 = core 纯函数(`chargeUsageRecord`/`readUsageRecord`,dist/core/usage-window-store.js):
@@ -7,7 +7,7 @@
  * first-use bucket lapsed 即弃)完全由 core 纯函数执行——SQL 层零窗语义。
  *
  * 并发正确性(本 store 的靶心;两副本同 key 并发 charge 绝不能丢账——丢账方向=治理窗漏放):
- *  - **ensure-first + 行锁**(mailbox twin 正字先例,design/166 复审靶1):事务内先幂等
+ *  - **ensure-first + 行锁**(mailbox twin 正字先例,[ref] 复审靶1):事务内先幂等
  *    INSERT IGNORE / ON CONFLICT DO NOTHING 建空行 ⇒ SELECT ... FOR UPDATE 时行恒在,
  *    「无行 FOR UPDATE + INSERT」的并发死锁(InnoDB gap-lock)/dup 撞车形整个消掉。
  *  - charge 频率低(core 只在任务进场/turn 边界/收尾 delta 提交),悲观锁简单正确,不用乐观 CAS。
@@ -18,7 +18,7 @@
  * background-agent LONGTEXT 同案);PG TEXT 不限长。key 列 VARCHAR(190)(principal 或
  * GLOBAL_USAGE_KEY,均为受控标识,无字节等价诉求——不是用户可写身份键)。
  *
- * residue(design/166 04 §复审处置在档):不再被 charge 的 key 行永存(单行成本可忽略);
+ * residue([ref] 04 §复审处置在档):不再被 charge 的 key 行永存(单行成本可忽略);
  * GLOBAL 单行=并发 charge 串一把行锁的吞吐热点(出现瓶颈再分片)。
  */
 import type { Pool as MySqlPool } from "mysql2/promise";

package/dist/plugins/web-search.d.ts

@@ -1,5 +1,5 @@
 /**
- * design/102 (K-8 CC full-body) — the WebSearch BACKEND (BRAIN / model-service leg) that core leaves
+ * [ref] (K-8 CC full-body) — the WebSearch BACKEND (BRAIN / model-service leg) that core leaves
  * deployment-injected (`WebSearchConfig.search`; core ships NONE, the same boundary as the model gateway). Wiring a
  * backend here is what makes `assembleFullBodyTools({ webSearch })` actually mount the WebSearch tool.
  *
@@ -13,7 +13,7 @@
  * not a correctness requirement (a backend MAY ignore it). The API key comes from deployment env — it never enters
  * the model prompt or the tool args. `effect:"read"` (idempotent) is core's concern; this is just the transport.
  *
- * ── 立案:装配层四条缺口([2176] 我方认领,2026-08-01 调研,**尚未实施**)────────────────────
+ * ── 立案:装配层四条缺口([ref] 我方认领,2026-08-01 调研,**尚未实施**)────────────────────
  *
  * ① **`opts` 仍有 brave 腿不消费**(只剩 `brave` 的 switch 分支不传 `opts`;`searxng` 腿已随 ② 的
  *    还债改动接住 `opts` 并透传给 core 的 adapter,由它把 `allowedDomains` 原生下推成 `site:` 前缀。
@@ -26,7 +26,7 @@
  *    ⚠️ 判据留痕:我第一轮把这条判成了「约束被静默丢弃」的安全缺口,是**亲读 core 结果侧代码**
  *    才推翻的。「别处已经处理了」这种声明必须验证 —— 这次它是真的,但真假只能靠读。
  *
- * ② ~~**searxng 腿是自铸的第二真源**~~ —— ✅ **已还(2026-08-01,[2229] 裁定 searxng 为国内可达性
+ * ② ~~**searxng 腿是自铸的第二真源**~~ —— ✅ **已还(2026-08-01,[ref] 裁定 searxng 为国内可达性
  *    主路线之后)**:本腿改为消费 core 的 `createSearxngSearchBackend`,外层保住 maxResults 截断 /
  *    统一形状 / 坏 payload 观测器三样(各有红先钉 + 变异实测),白得 `site:` 原生下推、`extraParams`、
  *    自带 timeout。以下为原始立案文本,留档:
@@ -34,7 +34,7 @@
  *    (+`SearxngBackendOptions`),而且比本文件的实现多三样:`allowedDomains` 拼 `site:` 原生下推、
  *    `extraParams`(实例特定的 `engines=`/`language=` 等)、**自带 timeout**
  *    (`AbortSignal.any([signal, timeout])`;本文件的 searxng 腿只吃外部 signal)。
- *    我在黑板 [2190] 已公开表态「按 core 的接、不再自铸第二真源」—— 这条是待兑现的债。
+ *    我在黑板 [ref] 已公开表态「按 core 的接、不再自铸第二真源」—— 这条是待兑现的债。
  *    换的时候要核对的等价点:本文件的 `normalize()` 统一形状 + `max` 截断 +
  *    `setWebSearchBadPayloadObserver` 观测器,core 的 adapter 都没有,得在外层补回来。
  *
@@ -96,8 +96,8 @@ export declare function createWebSearchBackend(cfg: WebSearchBackendConfig): Web
  * `WEB_SEARCH_SEARXNG_PARAMS` / `settings.webSearch.searxngParams` 的解析 —— SearXNG 实例侧参数
  * (`engines=` / `language=` 等)。
  *
- * 🔴 [2240] cli 逐串直证:3.18.0 我加了 `searxngParams` 字段和消费点,**却没开任何配置入口** ——
- * 两条门都没有位置填它,于是我在 [2239] 说的「这条是给你们的」是句空话。单测直接构造
+ * 🔴 [ref] cli 逐串直证:3.18.0 我加了 `searxngParams` 字段和消费点,**却没开任何配置入口** ——
+ * 两条门都没有位置填它,于是我在 [ref] 说的「这条是给你们的」是句空话。单测直接构造
  * `WebSearchBackendConfig` 传进去,**天然跳过了配置入口这一层**,于是「能力在」与「配得进」之间
  * 断开,而两边的绿都是真的。判据:**按消费端实际能填的那个入口验,不是按自己构造的对象验。**
  *
@@ -124,7 +124,7 @@ export declare function webSearchConfigFromEnv(env?: NodeJS.ProcessEnv): WebSear
  * maxResults?}`) into a backend config. Returns `undefined` for a missing/invalid provider — NEVER throws, so a bad
  * per-request config falls back to the deployment-env backend rather than failing the task. 🔒 The CALLER gates this to
  * the single-user host lane (a per-request `endpoint`/`apiKey` is a capability config; on multi-tenant a tenant could
- * point `searxng` at an internal URL = SSRF, so multi-tenant uses ONLY the deployment-env backend — design/107 axis).
+ * point `searxng` at an internal URL = SSRF, so multi-tenant uses ONLY the deployment-env backend — [ref] axis).
  */
 export declare function webSearchConfigFromSettings(raw: unknown): WebSearchBackendConfig | undefined;
 //# sourceMappingURL=web-search.d.ts.map

package/dist/plugins/workflow-journal-store-sql.d.ts

@@ -1,5 +1,5 @@
 /**
- * Durable {@link WorkflowJournalStore} (SVC-2, core CORE-7) — SINGLE-FILE DUAL-DIALECT (design/158 A12
+ * Durable {@link WorkflowJournalStore} (SVC-2, core CORE-7) — SINGLE-FILE DUAL-DIALECT ([ref] A12
  * 定型半场). ONE implementation, TWO dialects; the historical `TiDBWorkflowJournalStore` / `PgWorkflowJournalStore`
  * class names survive as thin ctor subclasses so every consumer (store-backend.ts, the extreme/integration/
  * resume-fork-probe suites) is untouched.
@@ -39,9 +39,9 @@ import type { Pool as PgPool } from "pg";
 import { type WorkflowJournalEntry, type WorkflowJournalStore } from "@sema-agent/core";
 import { type SqlDriver } from "./sql-driver.js";
 /** Dual-dialect durable WorkflowJournalStore. See the file header for the dialect-delta ledger. */
-/** RB-242 租约旋钮。TTL 只是**崩溃兜底**(engine 终态 finally 显式释放;[1981]/[1984] 两层分工:
+/** [ref] 租约旋钮。TTL 只是**崩溃兜底**(engine 终态 finally 显式释放;[ref]/[ref] 两层分工:
  *  engine 崩了没释放 ⇒ 陈旧 claim 可被接管)。
- *  🔴 缺省 1h,与 core file 参考实现同值([1984] :284)——**租约无心跳**(claimed_at_ms 在授予时刻定格,
+ *  🔴 缺省 1h,与 core file 参考实现同值([ref] :284)——**租约无心跳**(claimed_at_ms 在授予时刻定格,
  *  运行期间不刷新),所以 TTL 必须盖过最长合法 run 时长:取小了(我初版 15min)会在一次 >TTL 的活跑
  *  中把 claim 判陈旧、放另一副本进来接管——恰是本缝要防的双跑。要更短的接管等待,先给 engine 半场
  *  加心跳刷新,再谈调小。 */
@@ -64,8 +64,8 @@ export declare class SqlWorkflowJournalStore implements WorkflowJournalStore {
      *  runId resolves to an empty journal (resume safely diverges to live, never discloses another tenant's results).
      *  Each row's `result` is the persisted JSON.stringify(TaskResult) → JSON.parse back. Throws on failure (LOAD-BEARING). */
     load(runId: string, scope: string): Promise<WorkflowJournalEntry[]>;
-    /** [1412] locator 云形(core 1.353 WorkflowJournalStore.locator additive):SQL 店的 journal 坐标=
-     *  [1402] HTTP 读面路由(file 店返 jsonl 路径=CC 本地形;此处返云形,core 铸 diagnostics 教句时单源引用)。 */
+    /** [ref] locator 云形(core 1.353 WorkflowJournalStore.locator additive):SQL 店的 journal 坐标=
+     *  [ref] HTTP 读面路由(file 店返 jsonl 路径=CC 本地形;此处返云形,core 铸 diagnostics 教句时单源引用)。 */
     locator(runId: string, _scope: string): string;
     /** codex R1-H2:分页投影读——LIMIT/OFFSET 界行数,字节门界单行字节(超限行不取 result 全文,只回字节数;
      *  读面标 truncated)。ORDER BY ordinal 与 load 同轴。
@@ -84,7 +84,7 @@ export declare class SqlWorkflowJournalStore implements WorkflowJournalStore {
     /** GC — purge ALL journal entries for a run (the run reaper calls this once the run is terminal + retained). Scoped
      *  by run_id alone; idempotent (affected-row count). Mirrors the resume-anchor store's deleteBySession. */
     deleteByRun(runId: string): Promise<number>;
-    /** RB-242 / WF2([1981] core 拍板 a 形,签名逐字)—— cross-replica resume admission lease。
+    /** [ref] / WF2([ref] core 拍板 a 形,签名逐字)—— cross-replica resume admission lease。
      *
      *  语义(bake-store `idem_key UNIQUE` 先例):PK (source_run_id, scope) 上的原子赢或观察。四步,每步
      *  单语句原子,并发交叉在任一步都收敛到「恰一个持有者」:

package/dist/plugins/workflow-run-store-sql.d.ts

@@ -1,5 +1,5 @@
 /**
- * P1 (fleet failover correctness, clay 2026-07-05) — SINGLE-FILE DUAL-DIALECT (design/158 A12 定型半场).
+ * P1 (fleet failover correctness, clay 2026-07-05) — SINGLE-FILE DUAL-DIALECT ([ref] A12 定型半场).
  * ONE implementation, TWO dialects; the historical `TiDBWorkflowRunStore`/`PgWorkflowRunStore`,
  * `TiDBWorkflowCompletionInbox`/`PgWorkflowCompletionInbox`, `TiDBWorkflowNotifyJournalStore`/
  * `PgWorkflowNotifyJournalStore` class names survive as thin ctor subclasses so every consumer

package/dist/plugins/write-behind-counter.d.ts

@@ -3,7 +3,7 @@
  * and the rate limiter (P0-2), on BOTH dialects. Both are additive per-key counters over an aligned fixed
  * window, so the shared store uses an ATOMIC INCREMENT (`val = val + delta`), never last-writer-wins.
  *
- * design/158 A12 C1b: this file used to be MySQL-hardwired and the PG lane carried TWO inline copies of the
+ * [ref] A12 C1b: this file used to be MySQL-hardwired and the PG lane carried TWO inline copies of the
  * same 150-line class (pg-cost-quota.ts's private `PgWriteBehindCounter` + pg-rate-limiter.ts's exported one).
  * They are now ONE dialect-parameterized implementation; `WriteBehindCounter` (mysql2) and
  * `PgWriteBehindCounter` (node-pg) remain as ctor subclasses so every call site and test keeps its shape.
@@ -60,7 +60,7 @@ export declare class SqlWriteBehindCounter {
     private readonly dialect;
     private readonly pool;
     private readonly t;
-    /** 🔴 不再 `readonly`(#322):`costQuotaWindowSec` 热更新经 {@link setWindowMs} 换代,语义见那里。 */
+    /** 🔴 不再 `readonly`([ref]):`costQuotaWindowSec` 热更新经 {@link setWindowMs} 换代,语义见那里。 */
     private windowMs;
     private readonly now;
     private readonly onDegraded?;
@@ -72,7 +72,7 @@ export declare class SqlWriteBehindCounter {
     private flushStartedAt;
     private failStreak;
     constructor(dialect: CounterDialect, pool: MySqlPool | PgPool, t: CounterTable, 
-    /** 🔴 不再 `readonly`(#322):`costQuotaWindowSec` 热更新经 {@link setWindowMs} 换代,语义见那里。 */
+    /** 🔴 不再 `readonly`([ref]):`costQuotaWindowSec` 热更新经 {@link setWindowMs} 换代,语义见那里。 */
     windowMs: number, now?: () => number, onDegraded?: CounterDegradeHook | undefined, // S9: observability tap — never affects counting
     queryTimeoutMs?: number);
     /** The ONLY place the two drivers' query shapes diverge. Returns {rows, affected}. */
@@ -97,7 +97,7 @@ export declare class SqlWriteBehindCounter {
     /**
      * Delete expired window buckets to bound the table.
      *
-     * 🔴 失败**必须留痕**(#192 codex 复审 round2 修):这里原先是裸 `catch { return 0 }` —— 一个只影响
+     * 🔴 失败**必须留痕**([ref] codex 复审 round2 修):这里原先是裸 `catch { return 0 }` —— 一个只影响
      * DELETE 的故障(权限被收回、引擎单独拒 DELETE)会被吞成"删了 0 行",而 flush/refresh 两条腿照常成功
      * ⇒ 健康遥测全绿,同时 rate_limit / cost_quota 的历史桶无界增长。那正是本仓禁止的静默 fail-open。
      * 处置是**留痕不改失败方向**:清理是 best-effort,失败仍返回 0(把一次运维层面的清理失败升级成业务
@@ -106,10 +106,10 @@ export declare class SqlWriteBehindCounter {
     reap(): Promise<number>;
     startRefresh(intervalMs?: number): this;
     stop(): void;
-    /** #322:刷新环是否在跑(关断哨兵的判据:off 态必须**零 SQL**,含这条后台环)。 */
+    /** [ref]:刷新环是否在跑(关断哨兵的判据:off 态必须**零 SQL**,含这条后台环)。 */
     refreshRunning(): boolean;
     /**
-     * #322 批1:窗长换代(`costQuotaWindowSec` 热更新)。
+     * [ref] 批1:窗长换代(`costQuotaWindowSec` 热更新)。
      *
      * 🔴 如实语义:窗长是**桶键的一部分**(`floor(now/windowMs)`),不是行里的一个可改字段。换窗长 ⇒ 当代
      * 桶重算 ⇒ 本副本对「当前窗已用多少」的读数从新桶起算(旧桶的行还在库里,按它自己的窗长归属)。

package/dist/principal-jwt.d.ts

@@ -1,6 +1,6 @@
 import type { ApprovalHmacKey, PrincipalJwtKey } from "./auth-keys.js";
 /**
- * design/80 D-G: verify a compact JWS principal token. Returns the crypto-verified principal (`sub`) + the
+ * [ref] D-G: verify a compact JWS principal token. Returns the crypto-verified principal (`sub`) + the
  * channel-binding (`bnd`) on success, or `null` on ANY failure (caller fail-closes — NEVER falls back to a header).
  * 🔴 Hardening: the JWS header `alg` MUST equal the kid's PINNED alg (rejects `alg:none`, symmetric, downgrade);
  * the kid MUST resolve to a configured key; iss/aud/exp/nbf (with a small skew) are enforced; `sub` MUST be present.
@@ -24,7 +24,7 @@ export declare function approvalBnd(env: {
     boundInputHash?: string | null;
 }): string;
 /**
- * design/80 D-G: verify the WHOLE direct-door proof for one /decide — the signed principal JWT (identity) + its
+ * [ref] D-G: verify the WHOLE direct-door proof for one /decide — the signed principal JWT (identity) + its
  * cnf.bnd channel-binding + the HMAC envelope (integrity) — and return the CRYPTO-VERIFIED principal, or a typed
  * reject. 🔴 Fail-closed: every failure rejects (the caller must NOT fall back to the trusted header). Order:
  * verify principal → bind → mac-present → mac-valid (so a non-operator never gets a MAC oracle, an unverified

package/dist/project-memory.d.ts

@@ -18,7 +18,7 @@ interface ProjectMemoryCtx {
  * Session snapshot cache (S-2): keyed on ctx.sessionId — a session keeps ONE stable instruction snapshot
  * (mid-run file edits surface via the probe as tail attachments, never a silently re-rendered prefix).
  * `phase: "post-compact"` forces a re-read (core re-renders the prefix there anyway). No entry for
- * sessionless one-shot runs. (post-clear never arrives from core — RB-9 — so it is not a cache key here.)
+ * sessionless one-shot runs. (post-clear never arrives from core — [ref] — so it is not a cache key here.)
  */
 export declare function makeLoadProjectMemory(opts: {
     logger?: {

package/dist/prompts-domain-validate.d.ts

@@ -1,10 +1,10 @@
 import { type PromptTextDeclaration, type PublishedPromptArtifactEnvelope } from "@sema-agent/core";
-/** [1057]⓪ 下发形(remote effective 的 additive key,JSON verbatim 面——不经 registry-core parse,所以
+/** [ref]⓪ 下发形(remote effective 的 additive key,JSON verbatim 面——不经 registry-core parse,所以
  *  cli 补位前 center 发的 `contentHash` 也原样到达)。 */
 export interface EffectiveCenterPrompts {
     /** `center:<contentDigest 前 12>` — 纯内容寻址(同内容重发布=同 packId,epoch 不误重 pin)。 */
     packId: string;
-    /** canonical JSON 全量 sha256(非盐化,operator 对账位 [1050]②)。 */
+    /** canonical JSON 全量 sha256(非盐化,operator 对账位 [ref]②)。 */
     contentDigest: string;
     /** covering 已在 center 走完的基线终形(层信息不下发,worker 零解析义务)。 */
     sections: PromptTextDeclaration[];
@@ -36,17 +36,17 @@ export interface PromptsDomainFaces {
     catalog?: PublishedPromptArtifactEnvelope;
     /** 采用去重键:两轴 digest 拼接(轴缺席记 "-")。 */
     identity: string;
-    /** 观测面([985]a §3:`center_prompts_adopted` 增 axes,看两轴共存窗)。 */
+    /** 观测面([ref]a §3:`center_prompts_adopted` 增 axes,看两轴共存窗)。 */
     axes: Array<"declarations" | "catalog">;
 }
 /**
  * prompts 域候选门 v2(validateCenterPrompts 的双轴升级;整拒语义不变=任一在场轴坏形 ⇒ 整个 prompts
  * 面拒绝采用,LKG/内置继续服务)。唯一认可形=`{schemaVersion:1, declarations?, catalog?}`
- * (registry-core `EffectivePromptsWire`)至少一轴。[2373]B-9(5.0.0):legacy 平铺兼容窗到期删——
+ * (registry-core `EffectivePromptsWire`)至少一轴。[ref]B-9(5.0.0):legacy 平铺兼容窗到期删——
  * 0.13.0 起 EffectivePromptsWire 首字段是 `schemaVersion: z.ZodLiteral<1>`,与 server 共用 ^0.13.0 的
  * 合规 center 不可能再发平铺;非合规体=响亮拒绝(整拒落 LKG/内置),不再静默吸收。
  * catalog 轴的语义权威=core `verifyPromptArtifact`(形/digest 逐位复算/ARTIFACT_LIMITS/compatibleCore
- * range 全在 core 一处——[1242]③ a 解,上限单真源永不漂)。
+ * range 全在 core 一处——[ref]③ a 解,上限单真源永不漂)。
  */
 export declare function validatePromptsDomain(raw: unknown): {
     ok: true;
@@ -55,11 +55,11 @@ export declare function validatePromptsDomain(raw: unknown): {
     ok: false;
     error: string;
 };
-/** #100(docs/R100-PROMPTS-LANE-FIX.md §V2-B)worker 腿 effective 上 `prompts` 键的**形-肯定**判别:
+/** [ref](docs/R100-PROMPTS-LANE-FIX.md §V2-B)worker 腿 effective 上 `prompts` 键的**形-肯定**判别:
  *  消费形特征(v2 `schemaVersion` 键,或 legacy 三键 packId/contentDigest/sections)⇒ 原样返回交
- *  {@link validatePromptsDomain}(收或拒,方向不变);其余=center 存储原文(global lane [1057]①e 下发
+ *  {@link validatePromptsDomain}(收或拒,方向不变);其余=center 存储原文(global lane [ref]①e 下发
  *  存储形是合法输入)——catalog 在场则投影 `{schemaVersion:1, catalog}`(config-provider 本地腿先例),
- *  否则视为「center 未发」⇒ undefined。null=有意 cleared 语义(#100 前 null 走拒,方向为宽是设计变更,
+ *  否则视为「center 未发」⇒ undefined。null=有意 cleared 语义([ref] 前 null 走拒,方向为宽是设计变更,
  *  留痕于设计档)。垃圾标量原样返回(fail-loud 归 validate)。
  *  属主放本中立叶:config-lkg 与 boot/refresh 同吃,capabilities 层会重开 S6 刚消的反向依赖边。 */
 export declare function centerPromptsFromEffective(eff: unknown): unknown | undefined;

package/dist/question.d.ts

@@ -11,10 +11,10 @@ export interface QuestionFrame {
     /** "question_complete" only: whether the human answered (`answered`) or the ask was released unanswered
      *  (`unanswered` — ttl/abort → core was told nobody was reachable). Cosmetic dialog-dismiss. */
     outcome?: "answered" | "unanswered";
-    /** Server-signed emit timestamp (additive, [2805]§五→[2806]). Server-minted side-frame ⇒ no core-stream
+    /** Server-signed emit timestamp (additive, [ref]§五→[ref]). Server-minted side-frame ⇒ no core-stream
      *  `eventId` to carry (absence is honest); this is the frame's own time coordinate. */
     serverNowMs?: number;
-    /** "question" only ([4851]③, additive, the `tool_approval` window-trio precedent from #288): the
+    /** "question" only ([ref]③, additive, the `tool_approval` window-trio precedent from [ref]): the
      *  coordinator's OWN answer window (`QUESTION_TTL_MS`, default 5min) — at expiry the ask releases
      *  UNAVAILABLE ("unanswered") and core adjudicates park-vs-continue. Minted from the SAME `ttlMs` the
      *  `setTimeout` below actually arms (single source; a shell countdown rendered from these can never
@@ -89,7 +89,7 @@ export declare class QuestionCoordinator {
     };
     /** Test/observability hook: number of currently-parked questions. */
     pendingCount(): number;
-    /** #152 ([2703] 案二):durable 部署上的 AskUserQuestion 判决探针——本调用点是否处在某条**投递得到人的**
+    /** [ref] ([ref] 案二):durable 部署上的 AskUserQuestion 判决探针——本调用点是否处在某条**投递得到人的**
      *  活流腿上(runWithContext 包裹的 bg/SSE 腿=true;sync /v1/tasks、verify/cascade、durable resume 驱动=false)。
      *  resolve-spec 的 durable question policy 用它在**判决时**分腿:有活流 ⇒ allow(问活人),无 ⇒
      *  ask(durable park)。ALS 让这个判断天然 per-leg,policy 组装期不必预知腿别。

package/dist/resource-suspend.d.ts

@@ -1,5 +1,5 @@
 /**
- * design/80 seam #2 — the resource/preempt durable-suspend opt-in decision (design/74 "失败≠没做完" third state).
+ * [ref] seam #2 — the resource/preempt durable-suspend opt-in decision ([ref] "失败≠没做完" third state).
  *
  * Pure so it is unit-testable in isolation (the spec is otherwise assembled inside main.ts's bootstrap). When a
  * task opts in, a budget/turns/walltime limit OR a scheduler preempt durably SUSPENDS the task (resumable via
@@ -27,11 +27,11 @@ export declare function resourceSuspendOptIn(opts: {
     isCascade: boolean;
     /** Multi-tenant isolation key — the SAME key durableApproval uses (the principal; "_" when auth is off). */
     scope: string;
-    /** [3833] S-3:`RESOURCE_SUSPEND_TOTAL_TOKENS`(跨片 token 总额)。0/缺省 ⇒ 不铸键。 */
+    /** [ref] S-3:`RESOURCE_SUSPEND_TOTAL_TOKENS`(跨片 token 总额)。0/缺省 ⇒ 不铸键。 */
     totalTokens?: number;
-    /** [3833] S-3:`RESOURCE_SUSPEND_TOTAL_BUDGET_USD`(跨片 $ 总额)。0/缺省 ⇒ 不铸键。 */
+    /** [ref] S-3:`RESOURCE_SUSPEND_TOTAL_BUDGET_USD`(跨片 $ 总额)。0/缺省 ⇒ 不铸键。 */
     totalBudgetUsd?: number;
-    /** [3833] S-3:`RESOURCE_SUSPEND_MAX_SLICES`(跨片 slice 数上限)。0/缺省 ⇒ 不铸键。 */
+    /** [ref] S-3:`RESOURCE_SUSPEND_MAX_SLICES`(跨片 slice 数上限)。0/缺省 ⇒ 不铸键。 */
     maxSlices?: number;
 }): {
     scope: string;

package/dist/resource-window.d.ts

@@ -1,10 +1,10 @@
 /**
- * [3833] 件 S-4 —— **running 态跨片用量投影**的数据面(`GET /v1/runs/:id` 的 `crossSliceUsage`)。
+ * [ref] 件 S-4 —— **running 态跨片用量投影**的数据面(`GET /v1/runs/:id` 的 `crossSliceUsage`)。
  *
  * 【为什么需要它】S-3 把三条跨片总额旋钮(`RESOURCE_SUSPEND_TOTAL_TOKENS` / `_BUDGET_USD` /
  * `_MAX_SLICES`)供到了 `TaskSpec.resourceSuspend`,core 那本跨片账(`ResourceLedger`)也确实在记 ——
  * 但**跑的过程中 wire 上一个数都读不到**。运维第一次知道「这条 run 逼近过上限」是在**爆窗那一刻**
- * (行翻 `suspended` + `resource_limit` gate),想提前介入无读面。[3833] 的 75 万 token 就是这样烧完的。
+ * (行翻 `suspended` + `resource_limit` gate),想提前介入无读面。[ref] 的 75 万 token 就是这样烧完的。
  *
  * 【两半各自的真源(刻意不自建第三本账)】
  *  · **上限半**:本模块的进程内登记册 —— 记的是**这条 run 真正铸给 core 的那只 `resourceSuspend`**
@@ -53,7 +53,7 @@ export interface ResourceWindowTotals {
 }
 /** wire 上的投影体(`GET /v1/runs/:id` 顶层 `crossSliceUsage`)。**三轴各自成对**:上限键不在 ⇒ 它那根
  *  的已耗键也不在(没有天花板就没有「逼近天花板」这件事可读)。`spentMicroUsd` 另有一条缺席理由 ——
- *  unpriced 部署下用量行不带 `costMicroUsd` = **未知**,折 0 会谎报「还没花钱」(RB-368 未知传染)。 */
+ *  unpriced 部署下用量行不带 `costMicroUsd` = **未知**,折 0 会谎报「还没花钱」([ref] 未知传染)。 */
 export interface CrossSliceUsage {
     totalTokens?: number;
     spentTokens?: number;

package/dist/router/route-orchestration.d.ts

@@ -12,7 +12,7 @@
  *     caller-explicit — a deliberate `council`/`debate`/`team` request, or the `/v1/leader` endpoint).
  *
  * 🔴 ALL signals are DETERMINISTIC (config / mounted tools / exec-env isolation / autonomy / delegation). There is
- * NO LLM "difficulty" judge in the routing decision — the verdict's measurement-integrity rule (design/89 §2.2.1):
+ * NO LLM "difficulty" judge in the routing decision — the verdict's measurement-integrity rule ([ref] §2.2.1):
  * an LLM judge is a GATE inside an arm, NEVER the routing metric (it would make the router un-auditable + gameable).
  *
  * Pure + unit-testable. The decision is VALIDATED empirically against the S1 harness (a ROUTER arm that runs the