@sema-agent/server 7.52.0 → 7.53.0

package/dist/boot/webfetch-summarize-lane.d.ts

@@ -1,10 +1,10 @@
 /**
- * A-057.5 [CONFIRMED high](2026-08-19 三轴组复审,真机探针复现)—— WebFetch 摘要面的
+ * [ref] [CONFIRMED high](2026-08-19 三轴组复审,真机探针复现)—— WebFetch 摘要面的
  * **per-model key plane**,与 `boot/side-query-lane.ts` 同一只 wrapper、同一条纪律。
  *
- * ## 病灶(#303 的第四面,逐字同形)
+ * ## 病灶([ref] 的第四面,逐字同形)
  *
- * #303 的头注写「side-query 是 key plane 三面里**唯一**缺席的那一面」—— 那句话是假的。
+ * [ref] 的头注写「side-query 是 key plane 三面里**唯一**缺席的那一面」—— 那句话是假的。
  * `createWebFetchSummarizer(brain, model)` 的 `brain` 是 `RunnerDeps.brain` 那只**裸网关 brain**
  * (`boot/budget-tracing.ts` 的 `createBrain(config, …)`,`get apiKey()` 恒回 `config.gatewayApiKey`),
  * 而 core 的摘要腿(`dist/tools/web.js`)铸 options 只放 `{ signal }`——`WebFetchSummarizerOptions`
@@ -12,31 +12,31 @@
  *   `const apiKey = options?.apiKey ?? config.apiKey;`   ← 缺席即回落**主网关 key**
  *   `const root = (model.baseUrl || config.baseUrl || "")` ← 却**按模型**选路
  * ⇒ summarize 角色解析到一只带自有 `baseUrl` + `apiKeyEnv/sealedApiKey` 的模型时,**主网关 key 被发到
- * 那只模型自己的外部 URL**;而且这不落在 #303 已具名接受的那条残余里(那条说的是「**没有** per-model
+ * 那只模型自己的外部 URL**;而且这不落在 [ref] 已具名接受的那条残余里(那条说的是「**没有** per-model
  * key 的 off-route 模型仍收网关 key」)—— 这只模型**有**自己的 key,却拿不到。
  *
  * 第二半同样成立:毒丸(sealed key 解不开)在本面**静默回落网关账号** —— 本面根本不经
  * `resolveModelApiKey`,`key-resolver.ts` 顶注那句「a broken sealed key must NEVER silently burn the
  * shared gateway account」在这条路上不成立。
  *
- * ## 修形 = 照 #303 的配方接第四面(不是新造语义)
+ * ## 修形 = 照 [ref] 的配方接第四面(不是新造语义)
  *
  * brain 换成 `createPerModelKeyBrain(brain, getKeyResolver)`:
  *  · 有 per-model key ⇒ 注入 `options.apiKey`,请求带模型自己的凭据;
  *  · 无 ⇒ 不注入 ⇒ 交回 core 按它自己的 key↔URL 配对法判(core 5.57.0 起:部署根声明了而 entry URL
  *    不在那个根上 ⇒ `route.credential_mismatch` 响亮拒;未声明部署根 = `"unpinned"` 快速起步姿态 ⇒
- *    照旧回落网关 key。A-057.59 的具名残余与其 P-DEBT 腿已在源头清偿,见 side-query-lane.ts 顶注);
- *  · 毒丸 ⇒ **上抛**,一个字节都不发(CLAUDE.md #157 安全轴 fail-closed)。
+ *    照旧回落网关 key。[ref] 的具名残余与其 P-DEBT 腿已在源头清偿,见 side-query-lane.ts 顶注);
+ *  · 毒丸 ⇒ **上抛**,一个字节都不发(CLAUDE.md [ref] 安全轴 fail-closed)。
  * wrapper 只包本席这一只引用,`RunnerDeps.brain` 零扰动(与 side-query 席同形)。
  *
  * ## 为什么住在 `boot/` 而不是继续躺在 `main()` 的闭包里
  *
  * ① 这是一条**可发射的 LLM 面**,必须能被黑盒探针(真 fetchImpl 捕 Authorization)直接驱动 —— 躺在
- *    `main()` 里只能靠源码字面锚,而本仓已成文「源码字面锚有致命假绿形」(A-057.4/.11 那一族);
+ *    `main()` 里只能靠源码字面锚,而本仓已成文「源码字面锚有致命假绿形」([ref]/.11 那一族);
  * ② 发射面枚举门(`test/per-model-key.test.ts` 的 `DIRECT_EMISSION_FACES`)按**文件**登记在册,第四面
  *    有自己的文件才登记得住。
  *
- * 原地保留的两条既有语义(E-MED-2/E-MED-3,[1900]/[1904] 复审批):
+ * 原地保留的两条既有语义(E-MED-2/E-MED-3,[ref]/[ref] 复审批):
  *  · **惰性解析**:模型每次调用现取 —— `config.models`/`config.roles` 会被 center 的 effective 热应用
  *    `mutateInPlace` 整表替换,boot 期急求值会把摘要器永久 pin 在占位/旧模型上;
  *  · **fail-soft**:`resolveTaskModel` 在无可解析角色时 throw,这是全仓唯一 boot 期裸调用点;解析失败

package/dist/boot/workflow-orchestration.d.ts

@@ -1,5 +1,5 @@
 /**
- * design/158 A10:composition root 分段 —— workflow 编排面(run store / notify 门 / completion inbox /
+ * [ref] A10:composition root 分段 —— workflow 编排面(run store / notify 门 / completion inbox /
  * fleet 总线 / 可 steer 句柄注册表)。
  *
  * 纯搬运:函数体逐字来自 `main.ts`(原 1315-1441 行),缩进不变;新增的只有 import 与包壳。

package/dist/bounded-session-map.d.ts

@@ -21,7 +21,7 @@ export declare class BoundedSessionMap<V> {
     set(sessionId: string, value: V): void;
     /** `undefined` sessionId or an unregistered session both → `undefined` (non-removing read). */
     get(sessionId: string | undefined): V | undefined;
-    /** #318:显式逐出(会话删除级联要它 —— 会话没了,它的进程内缓存条目也必须跟着没)。
+    /** [ref]:显式逐出(会话删除级联要它 —— 会话没了,它的进程内缓存条目也必须跟着没)。
      *  返回是否真删掉了一条(幂等:未登记的 session 返回 false)。 */
     delete(sessionId: string): boolean;
 }

package/dist/brain.d.ts

@@ -15,11 +15,11 @@ export declare const FAST_FAIL_MAX_RETRIES = 2;
  *   - **Tiered timeouts** (1.38, `connectTimeoutMs`/`firstTokenTimeoutMs`) are passed into each
  *     openai-compatible brain at creation — they bound "gateway never accepts the connection" and
  *     "stream opened but hangs without a token" as retryable `[network]` failures. Default ON
- *     (30s/120s, [880] fleet audit; env =0 disables).
+ *     (30s/120s, [ref] fleet audit; env =0 disables).
  *   - **Circuit breaker** (`createCircuitBreakerBrain`) wraps the *primary* gateway route(s) when
  *     `MODEL_CIRCUIT_BREAKER=true`: after N transient failures it opens and fast-fails, so failover
  *     switches to the bare backup immediately instead of waiting out each timeout. The last gateway
- *     route stays bare (last-resort) — matching core design/20. State is core's in-process Map (each
+ *     route stays bare (last-resort) — matching core [ref]. State is core's in-process Map (each
  *     replica trips independently; cross-replica shared state via a TiDB adapter is a follow-up).
  *   - **Failover** (`createFailoverBrain`) stacks the primary gateway with optional
  *     `MODEL_GATEWAY_FALLBACK_URLS` — same protocol, same model id, tried in order.
@@ -29,7 +29,7 @@ export declare const FAST_FAIL_MAX_RETRIES = 2;
  *
  * When no fallback URL, no Anthropic key, and no resilience thresholds are configured, this returns the
  * bare openai brain (carrying the default-on watchdog timeouts — set the three env knobs to 0 for the
- * pre-[880] fully-bare shape). The Model itself (id / contextWindow / maxTokens / provider) flows
+ * pre-[ref] fully-bare shape). The Model itself (id / contextWindow / maxTokens / provider) flows
  * per-request through `Runner({ models })`.
  */
 export declare function createBrain(config: ServiceConfig, deps?: {

package/dist/budget.d.ts

@@ -41,12 +41,12 @@ export interface ModelUsageDelta {
     outputTokens: number;
     cacheReadTokens: number;
     cacheWriteTokens: number;
-    /** 🔴 RB-368(core 2.3.0 起)**可选 = 缺席表示「未知」,不是 0**。unpriced 部署(目录里该模型没配
+    /** 🔴 [ref](core 2.3.0 起)**可选 = 缺席表示「未知」,不是 0**。unpriced 部署(目录里该模型没配
      *  `cost`、也没注 `pricing`)下 core 在 `brain.call` 帧上**整键缺席**,我们如实透传;显式全零 `cost`
      *  = 运营者声明免费 ⇒ 键在场且为 0。两者可区分,这正是 #59 折零案的源头修复。
      *  与 SDK `ModelUsageDelta`(五键全可选)/ `usage-analytics.UsageModelEntry` 同轨。 */
     costMicroUsd?: number;
-    /** core 3.0.0([2296] 装车单 S10,§DESIGN-V2 V2-⑤)可选口径标记:标出这一行的 token 分量是在哪套记账
+    /** core 3.0.0([ref] 装车单 S10,§DESIGN-V2 V2-⑤)可选口径标记:标出这一行的 token 分量是在哪套记账
      *  基准下写的(当前唯一值 = `"uncached-components-v1"`:`inputTokens` = cache-MISS 分量,`cacheRead`/
      *  `cacheWrite` 分列)。**写点在 `trace/project.ts` 的 durable 行构造处**(`appendModelUsageDelta`),
      *  不在这里 —— {@link ModelUsageTracker.record} 的累加逻辑本身零改动,永远不设置这个键(它只在 drain
@@ -91,7 +91,7 @@ export { type PromptManifestRecord, promptManifestRecordOf, configAssembledRecor
  */
 export declare function createTracer(metrics: Pick<Metrics, "inc" | "observe">, costQuota?: QuotaTracker, modelUsage?: ModelUsageTracker, fleetUsage?: Pick<FleetUsageAccumulator, "record">, fleetLease?: Pick<FleetLeaseManager, "recordSpend">, quotaWeightFor?: (model: string) => number, promptManifests?: PromptManifestTracker): TracerHook;
 /**
- * [1469] side-query 记账 seam(codex R3 high:sideQuery 不走 core tracer——brain.stream 直调不发
+ * [ref] side-query 记账 seam(codex R3 high:sideQuery 不走 core tracer——brain.stream 直调不发
  * brain.call——createTracer 的四路 sink(costQuota/model_cost 指标/fleetUsage 批报/fleetLease 本地扣减)
  * 全部旁路)。本 seam 与 createTracer 的 brain.call 臂**同语义**喂同一组 sink:weightedTokens 同式
  * (tokens×quotaWeight,weight-at-burn 固化)、micro-USD 同轴。装配点与 createTracer 同一处(main.ts),

package/dist/canonical-json.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Canonical JSON(键递归排序、零空白、数组保序)—— 本仓所有「先序列化再 sha256 / 指纹自比」站点的**单一序列化器**
+ * ([ref] / [ref],2026-08-31 合并批)。
+ *
+ * ## 为什么只能有一个
+ * 合并前本仓有 **5 处**手写复刻(memory-origin-fence / permission-rule-store-sql / bench-l8 artifact /
+ * config-center restart-signal / mcp-revocation),每处一份「排 key、递归、拼串」——同一个算法五份实现,
+ * 语义在边缘(undefined 值键、函数成员、非有限数)各自漂了一点。指纹型代码的病灶恰恰在边缘:同一份内容算出
+ * 两个指纹 = 落库 checksum 失配 / 误签 restart / 包完整性自校验对不上。
+ *
+ * ## 语义 = core `canonicalJsonStringify` 的**逐字港**(fidelity 高于「更漂亮」)
+ * 治理携出包(`POST /v1/memory/export`)的 `integrity.sectionHashes.entries` 必须与 core 铸包/校验时算的
+ * 哈希**逐字节相同**(core `memoryBundleInvalid` 三向对账),而 core 公共面只出口 `computeMemoryBundleHash`
+ * (Record 特化),不出口这只序列化器(`dist/core/memory-engine/file-backend.js#canonicalJsonStringify`,
+ * exports 封死)——所以本仓必须持有一份逐字港,且**不得**在下游「修」它的边缘行为(源头修复纪律:
+ * core 若改形,港随之改;本仓不做第二个写者)。防漂移钉 = `test/memory-origin-fence.test.ts` §④(期望哈希全
+ * 经 core 出口独立算出)。
+ *
+ * 语义表(与 core 逐字同;`test/canonical-json.test.ts` 逐行钉):
+ *  · 对象:own 可枚举键,**值为 `undefined` 的键省略**(与 `JSON.stringify` 同),其余按 UTF-16 码元序排序
+ *    (`Object.keys().sort()`,数字形键同样按字符串序:`"10" < "2"`);键经 `JSON.stringify` 转义。
+ *  · 数组:保序;元素 `undefined` / 函数 / symbol ⇒ `null`(与 `JSON.stringify` 同)。
+ *  · 标量:`JSON.stringify`(`NaN`/`±Infinity` ⇒ `null`、`-0` ⇒ `0`、字符串转义与 `JSON.stringify` 同)。
+ *  · **非 JSON 输入的港继承形(不是本仓的设计,是 core 的形,如实记)**:对象成员为函数/symbol 时,键**保留**
+ *    而值经 `JSON.stringify` 得 `undefined` ⇒ 拼出字面 `undefined`(非法 JSON 文本);顶层 `undefined`/函数/symbol
+ *    ⇒ 返回 `undefined`(非字符串)。五个站点的真实输入全是 JSON 形(JSON.parse 产物 / DB 行 / zod 解析产物),
+ *    这两条**不可达**;需要「非法输入响亮拒」的站点用 {@link canonicalJsonStrict}。
+ *  · `Date`/`Map`/`Set`/类实例:按普通对象处理(own 可枚举键 ⇒ `Date` 成 `{}`),**不调 `toJSON`**——与 core 同。
+ *  · `bigint`:`JSON.stringify` 抛 TypeError,原样上抛。
+ *
+ * ## 不在本文件里的第二形(如实登记)
+ * `src/config-center/restart-signal.ts#stableStringify`(mcp-revocation 同源改调)是**另一个语义**:undefined 值键
+ * **保留为 `"k":null`**。两族在 JSON 形输入上逐字节相同(golden 交叉读数已证),分歧只在进程内构造的
+ * `{k: undefined}` 形——restart 指纹的输入正是进程内切片对象,该形原则上可达,而 `{k:undefined}` 与 `{}` 是否
+ * 同指纹是 restart-signal 轴上的**行为**(多签/少签一次 fleet 滚动重启),不是序列化器的私事 ⇒ 本批不并
+ * (语义恒等才可合并),golden 各自钉,K→O 统一另立件走三问。
+ */
+/** core `canonicalJsonStringify` 的逐字港(语义表见文件头)。 */
+export declare function canonicalJson(value: unknown): string;
+/**
+ * 严格形:先按**同一遍历序**校验,再交 {@link canonicalJson} 序列化 —— 被签名/被内容哈希的载荷(bench/l8 部署
+ * 真实性 artifact)不许把 `NaN`/`Infinity` 静默写成 `null`(签名盖在坏字节上),也不许把函数/bigint/顶层
+ * `undefined` 当作可序列化。校验通过的输入域上,输出与 {@link canonicalJson} **逐字节相同**(golden 钉);
+ * 拒绝集与错误文案 = 合并前 `src/bench/l8/artifact.ts#serialize` 逐字(`test/l8-deploy-contract.test.ts` 钉
+ * `/non-finite/`):
+ *  · 非有限数(任意深度)⇒ `canonicalJson: non-finite number is not serializable`
+ *  · `undefined`(顶层)/ 函数(任意深度,数组元素亦然)⇒ `canonicalJson: <typeof> is not serializable`
+ *  · `bigint` ⇒ `canonicalJson: bigint is not serializable`;symbol ⇒ `canonicalJson: unsupported type symbol`
+ *  · 数组元素 `undefined` ⇒ `null`(放行);对象成员 `undefined` ⇒ 省略(放行)。
+ * 遍历序 = 数组下标序、对象**排序后**键序(多处坏值时抛出的是遍历序上第一处——与合并前行为同)。
+ */
+export declare function canonicalJsonStrict(value: unknown): string;
+//# sourceMappingURL=canonical-json.d.ts.map

package/dist/canonical-json.js

@@ -0,0 +1,48 @@
+export function canonicalJson(value) {
+    if (Array.isArray(value))
+        return `[${value.map((v) => (v === undefined || typeof v === "function" || typeof v === "symbol" ? "null" : canonicalJson(v))).join(",")}]`;
+    if (value !== null && typeof value === "object") {
+        const rec = value;
+        const keys = Object.keys(rec)
+            .filter((k) => rec[k] !== undefined)
+            .sort();
+        return `{${keys.map((k) => `${JSON.stringify(k)}:${canonicalJson(rec[k])}`).join(",")}}`;
+    }
+    return JSON.stringify(value);
+}
+export function canonicalJsonStrict(value) {
+    assertCanonicalJsonSerializable(value);
+    return canonicalJson(value);
+}
+function assertCanonicalJsonSerializable(v) {
+    if (v === null)
+        return;
+    const t = typeof v;
+    if (t === "number") {
+        if (!Number.isFinite(v))
+            throw new Error("canonicalJson: non-finite number is not serializable");
+        return;
+    }
+    if (t === "boolean" || t === "string")
+        return;
+    if (t === "undefined" || t === "function")
+        throw new Error(`canonicalJson: ${t} is not serializable`);
+    if (Array.isArray(v)) {
+        for (const x of v)
+            assertCanonicalJsonSerializable(x === undefined ? null : x);
+        return;
+    }
+    if (t === "object") {
+        const obj = v;
+        const keys = Object.keys(obj)
+            .filter((k) => obj[k] !== undefined)
+            .sort();
+        for (const k of keys)
+            assertCanonicalJsonSerializable(obj[k]);
+        return;
+    }
+    if (t === "bigint")
+        throw new Error("canonicalJson: bigint is not serializable");
+    throw new Error(`canonicalJson: unsupported type ${t}`);
+}
+//# sourceMappingURL=canonical-json.js.map

package/dist/capabilities/center-prompts.d.ts

@@ -1,30 +1,30 @@
 /**
- * center prompts 消费投影腿([1043]④/[1050]③ 分工:web 承存储+covering 解析+下发,server 承本模块;
- * [1057] 下发形定稿 / [1061] registry-core 0.10.16 schema / [1062]⑤「server 零新义务=逐字透传」)。
+ * center prompts 消费投影腿([ref]④/[ref]③ 分工:web 承存储+covering 解析+下发,server 承本模块;
+ * [ref] 下发形定稿 / [ref] registry-core 0.10.16 schema / [ref]⑤「server 零新义务=逐字透传」)。
  *
- * 链路:center(sema-web)把 covering 走完的**基线终形**经 `GET /api/config/effective` 的 additive
+ * 链路:center(sema-web-admin,2026-08-26 由 sema-web 改名)把 covering 走完的**基线终形**经 `GET /api/config/effective` 的 additive
  * `prompts` key 下发 → 本模块按任务 scenario 选包(`scenarioOverrides[s] ?? sections`,整包替换非增量,
- * [1057]①c)→ 声明数组**逐字**(含 opt-in `contentHash`,core 1.315 校验+manifest 透传)喂 core 既有
+ * [ref]①c)→ 声明数组**逐字**(含 opt-in `contentHash`,core 1.315 校验+manifest 透传)喂 core 既有
  * typed `stableBlocks` 钩子。守卫全在 core(id 规范/slot 闭集/core/ 命名空间拒绝/identity 三锚
- * pass-through/锁定槽不可写)——server 不做语义复检([1057]①f:identity 完整角色层由 center 编辑面把关)。
+ * pass-through/锁定槽不可写)——server 不做语义复检([ref]①f:identity 完整角色层由 center 编辑面把关)。
  *
  * 仅有的一层「形校验」不是语义复检,是**防炸底线**(详见其现居所 `src/prompts-domain-validate.ts`——
- * 判形半场已下沉到该中立叶子,本文件 re-export 保兼容;design/158 S6,lens2 §G):core 对坏形声明的
+ * 判形半场已下沉到该中立叶子,本文件 re-export 保兼容;[ref] S6,lens2 §G):core 对坏形声明的
  * 守卫是 THROW(assemble 期),server 在采用前做结构判形,坏形=拒绝采用该候选的 prompts 面。
  *
  * 生效语义(两段史):1.222 时 core 1.315 的 epoch 是 bundled-only(声明不进 descriptor),热换=resume
- * 三失真,故临时 restart-to-apply;core 1.316([1068] 裁 a/[1070]d)把声明以 (id,slot,chars,contentHash?)
+ * 三失真,故临时 restart-to-apply;core 1.316([ref] 裁 a/[ref]d)把声明以 (id,slot,chars,contentHash?)
  * 纳入 artifactDigest——声明变=digest 变=**下任务边界自动重 pin**(既有 legacy_migration 机制接手),
  * 进行中会话 epoch pin 保稳。自此恢复**热采用**(main.ts boot+refresh 双点 adopt),与 center
- * 「发布=新任务生效」产品语义对齐([1051]②b)。字节级检测只认 opt-in contentHash(文本不进 digest,
- * 防会话可导出面字典预映)——center 链路恒逐 section 铸([1065]),本投影逐字透传即全强度。
+ * 「发布=新任务生效」产品语义对齐([ref]②b)。字节级检测只认 opt-in contentHash(文本不进 digest,
+ * 防会话可导出面字典预映)——center 链路恒逐 section 铸([ref]),本投影逐字透传即全强度。
  */
 import { type PromptProvider, type PublishedPromptArtifactEnvelope } from "@sema-agent/core";
 import { type EffectiveCenterPrompts, type PromptsDomainFaces } from "../prompts-domain-validate.js";
 /** 判形半场(validateCenterPrompts/validatePromptsDomain/CORE_ENGINE_VERSION 及两 interface)已下沉到
- *  中立叶子 `src/prompts-domain-validate.ts`(design/158 S6);消费者直引真源([2354] 兼容面全清,
+ *  中立叶子 `src/prompts-domain-validate.ts`([ref] S6);消费者直引真源([ref] 兼容面全清,
  *  此处兼容 re-export 已删)。 */
-/** [985]b / [1285] — §9.4 by-digest 补拉组合店:local miss ⇒ fetchRaw(digest) 从 center 拉 envelope ⇒
+/** [ref]b / [ref] — §9.4 by-digest 补拉组合店:local miss ⇒ fetchRaw(digest) 从 center 拉 envelope ⇒
  *  core verifyPromptArtifact 全管线 + **回验「拿到的=要的」digest 逐位**(center 答非所问=丢弃)⇒
  *  best-effort 回写 inner(下次直命中)。任何失败=undefined(诚实缺席,fail-loud 归 core 的
  *  prompt_snapshot_unavailable——绝不拼杂交)。 */
@@ -37,7 +37,7 @@ export declare function withPromptArtifactBackfill(inner: {
     info: (msg: string, meta?: Record<string, unknown>) => void;
     warn: (msg: string, meta?: Record<string, unknown>) => void;
 }): typeof inner;
-/** e/b 接线([1236]① seam/[985]e):catalog 轴的两态过渡推进 core 的 CenterPromptSource——
+/** e/b 接线([ref]① seam/[ref]e):catalog 轴的两态过渡推进 core 的 CenterPromptSource——
  *  present(且身份变)⇒ applySnapshot(core 重验+落盘+原子换 candidate;validate 已过 core verify,
  *  此处失败=磁盘/状态写问题,warn 不挡 declaration 轴);absent-after-present / prompts 键整体消失
  *  ⇒ applyDisabled(闸关=显式撤下语义的 catalog 轴半场,离线重启不复活)。幂等安全:同 envelope
@@ -69,7 +69,7 @@ export declare function centerPromptProvider(prompts: EffectiveCenterPrompts, sc
  *  M9 迁移卫在 provider.stableBlocks 的 identity 声明上探同三锚,命中即走 pass-through 臂(其保留集无
  *  `core/role.append`,任何 append rider/outputStyle 会被静默丢)。选包与 {@link centerPromptProvider}
  *  同式(`overrides[s] ?? sections`);锚谓词由调用方注入(task-settings `hasConstitutionAnchors` 单真源)。
- *  [1057]①f 的「server 不做语义复检」不动:这不是复检语义,是为 capabilities.appendSystemPrompt 的诚实面
+ *  [ref]①f 的「server 不做语义复检」不动:这不是复检语义,是为 capabilities.appendSystemPrompt 的诚实面
  *  探 core 会走哪条臂。 */
 export declare function centerIdentityAssembled(prompts: EffectiveCenterPrompts, scenarioName: string, isAssembled: (text: unknown) => boolean): boolean;
 //# sourceMappingURL=center-prompts.d.ts.map

package/dist/capabilities/collab-workflows.d.ts

@@ -35,7 +35,7 @@ export interface CollabWorkflowProjection {
 export declare function projectCollabToWorkflows(templates: readonly CollabTemplateWire[] | undefined): CollabWorkflowProjection;
 export declare function registerCollabWorkflows(workflows: Record<string, CollabWorkflowEntry>): void;
 /** composite WorkflowScriptStore 的 resolveName 前段:collab 命中 ⇒ 内置 team-discussion 脚本+本模板
- *  defaultArgs(同名 SHADOW core 内置,design/140 §6 1c)。🔴 Object.hasOwn — `name` 是模型供给的
+ *  defaultArgs(同名 SHADOW core 内置,[ref] §6 1c)。🔴 Object.hasOwn — `name` 是模型供给的
  *  (run-workflow-tool 原样传 rawName):裸索引会让 Object.prototype 成员名("constructor"/"toString"/
  *  "__proto__"…)假命中 ⇒ 零模板注册也能烧真讨论、且同名文件 store 条目被遮蔽(交叉评审 2026-07-11 MED)。 */
 export declare function resolveCollabWorkflow(name: string): {

package/dist/capabilities/hands-lane.d.ts

@@ -1,7 +1,7 @@
 /**
- * #196 场景 hands lane —— 「要手的场景」与「无手的场景」在装配层分家。
+ * [ref] 场景 hands lane —— 「要手的场景」与「无手的场景」在装配层分家。
  *
- * 根本问题(设计小票 §1,案源 [3208]/[3209]/[3212]):core 的手带工具面是 **per-Runner 表态**
+ * 根本问题(设计小票 §1,案源 [ref]/[ref]/[ref]):core 的手带工具面是 **per-Runner 表态**
  * (`prepare-task`:`handsEnabled = ownedEnv || deps.executionEnv`,ownedEnv 只要挂了
  * `executionEnvFactory` 就每任务必铸)。server 此前全场景共享一只 runner + 一只 subRunner,
  * 于是任何 REMOTE_EXEC 部署里,声明 clone-free 的 `scan`、只有 `run_council` 的评审团、
@@ -44,11 +44,11 @@ export declare function pickHandsRunner(hands: ScenarioHands, pair: HandsRunnerP
  * ⚠️ 本全集是**观测口径**(用于防漂移对账),**不是** deny 名单 —— deny 用下面的
  * {@link HANDS_EXCLUSIVE_TOOL_NAMES},理由见那里。
  *
- * 🚨 [3248] P0(2026-08-09):派生时必须过滤 core 的 `RETIRED_TOOL_NAMES` —— core 5.21.0 的
+ * 🚨 [ref] P0(2026-08-09):派生时必须过滤 core 的 `RETIRED_TOOL_NAMES` —— core 5.21.0 的
  * `HAND_TOOL_EFFECTS` 里残留已退役的 `MultiEdit`,而 core `prepare-task` 的策略名审计见退役名
  * **无条件 throw**(`config.legacy_tool_name`);不过滤,deny 名单一进 `spec.toolPolicy`,
  * `hands: none` 三场景(scan/code-review/team)在**所有部署**上零 turn 全灭。core 5.21.1 已删
- * 那条死条目([3249]),这道 filter 是结构性防御:将来 core 再退役任何 band 名都不会重演
+ * 那条死条目([ref]),这道 filter 是结构性防御:将来 core 再退役任何 band 名都不会重演
  * (test/scenario-hands-lane.test.ts 格7/格8 双钉:真 Runner 过审计 + 零交集门)。
  * filter 打在**整表**(effect 表 + 锚定补集)之后 —— caret floor 下装置会解析到更新的 core,
  * 补集名哪天被退役,只滤前半就是同一次故障换个名字(codex 复审 finding,2026-08-09)。

package/dist/capabilities/memory-notice.d.ts

@@ -1,7 +1,7 @@
 /**
- * #217(板 [3499]②/[3521]④ 两次点名的 server 接线半场)—— 零记忆面部署形的**持久记忆披露**。
+ * [ref](板 [ref]②/[ref]④ 两次点名的 server 接线半场)—— 零记忆面部署形的**持久记忆披露**。
  *
- * 病(core [3479] 实测,#148 立案):一台没有任何持久记忆面的部署,用户说「请记住 X」,模型回一句
+ * 病(core [ref] 实测,[ref] 立案):一台没有任何持久记忆面的部署,用户说「请记住 X」,模型回一句
  * 「已经记住了」——落盘处并不存在。用户带着「这条事实已入库」的信念离开,下一次会话才发现是空的。
  *
  * core 5.26.0 的分工:引擎**能自证**只读的两态(engine 侧 `writeScope:null` / runner 侧 `handsReadOnly`)
@@ -41,7 +41,7 @@ export interface MemoryFaceFacts {
     /** 部署声明 `MEMORY_PERSISTENCE_CAPABLE`(三态)。`true` = operator 自证有推断看不见的持久通道
      *  (自定义 writer / MCP 记忆服务)⇒ 披露会变成假话,撤回;`false` = 强制披露;缺席 ⇒ 走推断。 */
     declaredCapable: boolean | undefined;
-    /** 本请求命中场景的手带表态(#196 判别位)。`none` = 该场景跑在不挂 `executionEnvFactory` 的 Runner 上,
+    /** 本请求命中场景的手带表态([ref] 判别位)。`none` = 该场景跑在不挂 `executionEnvFactory` 的 Runner 上,
      *  core 的手带 band(Bash/Edit/Write/…)整批不 mount。 */
     hands: ScenarioHands;
     /** 折完 governance+settings 后的最终 `handsReadOnly`(plan 模式 / autonomy 收窄)。手带只剩读腿。 */
@@ -56,7 +56,7 @@ export interface MemoryFaceFacts {
      *  `handsEnabled && isRemoteExecutionEnv` 时把 Write/Edit/NotebookEdit/Bash **全部不算**落盘路(沙箱盘
      *  每任务即焚,够不着 host 记忆根)。而 server 在任何 remote 车道上默认让记忆引擎 dark —— 两件事合起来
      *  正是**最常见的云部署形**:引擎不在、手带在,却一份持久面都没有。漏了这一位,那台机器就继续给
-     *  「已经记住了」的幻觉式回执 —— 恰恰是 #148 立案要消灭的形态。 */
+     *  「已经记住了」的幻觉式回执 —— 恰恰是 [ref] 立案要消灭的形态。 */
     remoteExecutionEnv: boolean;
 }
 /**

package/dist/capabilities/prompt.d.ts

@@ -4,12 +4,12 @@ import type { PromptProvider } from "@sema-agent/core";
  * `stableSystem` returns ONLY the role layer (base + the task's own systemPrompt) and **core appends
  * the constitution structurally** — harness/safety blocks (Truth/CYBER_RISK/URL_SAFETY), mode blocks,
  * AND the memory safety/hygiene guidance (`constitutionBlocks`), plus the volatile `<user_memory>`
- * tail LAST (design/12 prefix-cache discipline; guarded in CI by `assertPromptCacheFriendly`).
+ * tail LAST ([ref] prefix-cache discipline; guarded in CI by `assertPromptCacheFriendly`).
  *
  * History: the pre-1.243 seam made this helper's whole-prompt replacement silently DROP
  * core's constitution — oa/code-review/team ran with zero safety blocks. Same batch also moved
  * MEMORY_SAFETY/MEMORY_HYGIENE into the constitution layer, so the hand-composition this helper used
- * to do (core 1.62, design/41) would now DOUBLE-inject them — both removed; core owns the discipline
+ * to do (core 1.62, [ref]) would now DOUBLE-inject them — both removed; core owns the discipline
  * (consolidation mutual-exclusion included). This stays a thin role-layer join so scenarios don't
  * re-implement the same two-line body five times.
  */

package/dist/capabilities/sandbox-file-send.d.ts

@@ -8,7 +8,7 @@
  * when core destroys the env. No core change, no parallel abstraction — pure deployment glue on a seam
  * the deployment already owns.
  *
- * The send itself is the anti-relay shape ([747]; k8s workspace-snapshot posture): the server presigns a
+ * The send itself is the anti-relay shape ([ref]; k8s workspace-snapshot posture): the server presigns a
  * single-object PUT (120s, method-bound, STAGING key — 修3), the SANDBOX `curl -T`s the file straight to S3 — bytes never
  * relay through the server, S3 credentials never enter the sandbox. Tenant isolation = the sandbox can
  * only read its own filesystem, which is exactly the tenant's task workspace; that is why this lane is
@@ -85,7 +85,7 @@ export declare class TaskEnvRegistry {
  *    residue of tenant B's task → the isolation premise FAILS. Multi-tenant here would be an
  *    arbitrary-host-path-read → public-URL exfil face, so the lane opens ONLY single-user
  *    (`requirePrincipal !== true`), the exact gate the host lane uses. NOT a lane to "fix later with a
- *    per-task workspace": tasks legitimately operate outside any workspace on a real host (design/61 —
+ *    per-task workspace": tasks legitimately operate outside any workspace on a real host ([ref] —
  *    batch deployment), so per-task dirs would not restore the boundary anyway.
  *  - adb / local-docker / host / unset: no registry (host+unset use the local-fs source in main.ts;
  *    adb/local-docker remain a follow-on).

package/dist/capabilities/scenarios.d.ts

@@ -19,21 +19,21 @@ export interface ScenarioBundle {
     tools: ToolSpec[];
     skills: SkillSpec[];
     /**
-     * #196:本场景对 core 手带工具面(Bash/Edit/Write/Read/Grep/…)的表态 —— **必填闭集**。
+     * [ref]:本场景对 core 手带工具面(Bash/Edit/Write/Read/Grep/…)的表态 —— **必填闭集**。
      * `full` = 任务跑在挂了 `executionEnvFactory` 的 Runner 上(core 把 band 并集进 roster);
      * `none` = 跑在不挂 factory 的 Runner 上(band 根本不 mount,工具 schema 对模型不可见)。
-     * 必填是设计的一半:新场景不表态 = 编译红,而不是静默继承 full(那正是 [3208] 的病灶——
+     * 必填是设计的一半:新场景不表态 = 编译红,而不是静默继承 full(那正是 [ref] 的病灶——
      * `scan` 声明 clone-free 四件、实际拿到全量可写手)。
      */
     hands: ScenarioHands;
     promptProvider?: PromptProvider;
-    /** [849] 场景解释层定死的终验开关(core TaskSpec.finalVerification):bench 实测产品默认请求与
-     *  bench 态差距三件之一。[2400] 起无场景定死(autonomous 退役)——纯 caller 显式旋钮;spec 组装处 OR 折入(场景只会
+    /** [ref] 场景解释层定死的终验开关(core TaskSpec.finalVerification):bench 实测产品默认请求与
+     *  bench 态差距三件之一。[ref] 起无场景定死(autonomous 退役)——纯 caller 显式旋钮;spec 组装处 OR 折入(场景只会
      *  多加一轮收官验证,绝不收窄 caller 意图),壳/caller 不感知。 */
     finalVerification?: true;
 }
 /**
- * #318:场景工厂的**服务端事实**上下文 —— 与 `req`(= 调用方请求体,不可信)分开的第三个入参。
+ * [ref]:场景工厂的**服务端事实**上下文 —— 与 `req`(= 调用方请求体,不可信)分开的第三个入参。
  * 这里的每一位都由鉴权信道解析,调用方无法自报;新增位一律走本接口,绝不往 `req` 上加。
  */
 export interface ScenarioContext {
@@ -55,9 +55,9 @@ export interface ScenarioDeps {
     /** In-memory runner for ephemeral sub-tasks (council lenses/arbiter) — keeps them out of TiDB. */
     subRunner: Runner;
     /**
-     * #196:`subRunner` 的无手孪生 —— 同 deps,唯独不挂 `executionEnvFactory`。hands=none 的场景把它交给
+     * [ref]:`subRunner` 的无手孪生 —— 同 deps,唯独不挂 `executionEnvFactory`。hands=none 的场景把它交给
      * 自己造的子任务工具(council 的 lens/arbiter、discuss 的成员/synthesizer):那些子任务只该读仓库/讨论,
-     * 拿全量可写手是 [3208] 病灶里最意外的一支(零工具人格照拿 Bash)。取用一律走 {@link pickHandsRunner},
+     * 拿全量可写手是 [ref] 病灶里最意外的一支(零工具人格照拿 Bash)。取用一律走 {@link pickHandsRunner},
      * 不在场景体内手挑 —— 判别位是唯一开关。
      */
     handslessSubRunner: Runner;
@@ -71,9 +71,9 @@ export interface ScenarioDeps {
     /** Deployment-injected WebSearch backend (Brave/Tavily/SearXNG via `WEB_SEARCH_PROVIDER`). When set,
      *  `assembleCodeTools` mounts the WebSearch tool; absent ⇒ not assembled (core ships no search backend). */
     webSearch?: WebSearchConfig;
-    /** [1900]/[1904] WebFetch 摘要器(core `makeWebFetchSummarizer(brain, summarize 角色模型)` 的产物,
+    /** [ref]/[ref] WebFetch 摘要器(core `makeWebFetchSummarizer(brain, summarize 角色模型)` 的产物,
      *  main.ts 构造一次注入)。在场 ⇒ 装配实参携 `webFetch.summarize`——带 prompt 的 WebFetch 走 cheap
-     *  模型摘要而非整页灌上下文([1870] L1 的 ~660× 放大就是这缝);缺席 ⇒ `webFetch` 键不铸(修前
+     *  模型摘要而非整页灌上下文([ref] L1 的 ~660× 放大就是这缝);缺席 ⇒ `webFetch` 键不铸(修前
      *  字节形,core 落「summarization unavailable」诚实兜底)。 */
     webFetchSummarize?: NonNullable<NonNullable<WebFetchConfig["summarize"]>>;
     metrics?: Metrics;
@@ -97,14 +97,14 @@ export interface ScenarioDeps {
      */
     subagentExtraTools?: (ctx: SubagentSpawnContext) => ToolSpec[];
     /**
-     * core 1.364 durable background agents(design/151 S1,[1503] 提货单②写半场):后台子代 `a*` 行的
+     * core 1.364 durable background agents([ref] S1,[ref] 提货单②写半场):后台子代 `a*` 行的
      * durable 执行记录 store。**必须与 `RunnerDeps.backgroundAgentStore` 同实例**(读写双点配对,engine
-     * 无法核对——半接=静默死特性,RB-37①)。绝不在这里另起实例。absent ⇒ pre-151 行为(settle 后
+     * 无法核对——半接=静默死特性,[ref]①)。绝不在这里另起实例。absent ⇒ pre-151 行为(settle 后
      * eager release,读面纯 live)。
      */
     backgroundAgentStore?: BackgroundAgentStore;
     /**
-     * core 1.382(design/153 二拍B 件1+件2,parked 状态机)[1561] 提货单①②:「同车必接」的一对——core
+     * core 1.382([ref] 二拍B 件1+件2,parked 状态机)[ref] 提货单①②:「同车必接」的一对——core
      * `parkEligible` 门要求 checkpointStore 与 ensureChildSessionDurable **全在场**才成立,任一缺席 = 净是
      * pre-153 行为(子代 SAFETY ask 照旧 deny+continue,零回归)。
      *  - `checkpointStore` 必须与 `RunnerDeps.checkpointStore`(主 runner 的 per-task spec 面)**同实例**
@@ -121,7 +121,7 @@ export interface ScenarioDeps {
     checkpointStore?: CheckpointStore;
     ensureChildSessionDurable?: (sessionId: string) => Promise<void>;
     /**
-     * #318([4659] F2 症状 → [4692] 定谳):**会话级**任务清单店解析器,属主 =
+     * [ref]([ref] F2 症状 → [ref] 定谳):**会话级**任务清单店解析器,属主 =
      * `boot/task-list-lane.ts` 的 {@link import("../boot/task-list-lane.js").createTaskListLane}
      * (boot 期构造一次,SQL 后端在场接对应 twin、否则进程级 per-session 内存店)。
      *
@@ -161,10 +161,10 @@ export { SEMA_IDENTITY } from "./prompts/identity.js";
  */
 export declare function semaIdentityProvider(): PromptProvider;
 /**
- * `code` 场景的提示词提供者([849] 造,[891] clay 裁定改名 autonomous→code):role 基底 = core
- * {@link CODE_SYSTEM_PROMPT}(core 1.298 [891] 改名批正名,旧名 FULL_BODY_SYSTEM_PROMPT=恒等
+ * `code` 场景的提示词提供者([ref] 造,[ref] clay 裁定改名 autonomous→code):role 基底 = core
+ * {@link CODE_SYSTEM_PROMPT}(core 1.298 [ref] 改名批正名,旧名 FULL_BODY_SYSTEM_PROMPT=恒等
  * 别名过渡窗;CODE_AGENT persona + AUTONOMY_SELF_AUDIT + ANTI_VERBOSITY +
- * TOOL_PARAM_JSON;[891] 谱系定论 = CC 生产编码提示词的蒸馏去牌版,底本随 CC 版本对表 cc-anchors,
+ * TOOL_PARAM_JSON;[ref] 谱系定论 = CC 生产编码提示词的蒸馏去牌版,底本随 CC 版本对表 cc-anchors,
  * 非自研)——与 bench 的请求组装完全同源,引用 core 常量随版本走,绝不复制字符串(tb bench 实测:
  * 产品默认请求与同引擎 bench 态的差距根因就在这三件 persona/自检/终验)。品牌层与
  * {@link semaIdentityProvider} 同构:brandIdentity 开时 SEMA_IDENTITY 叠在 role 基底之上;任务自带

package/dist/capabilities/skills.d.ts

@@ -48,7 +48,7 @@ export interface LoadSkillsOptions {
 export declare function assertConfined(p: string, rootReal: string, label?: string): void;
 export declare function loadSkills(dir: string, opts?: LoadSkillsOptions): LoadedSkill[];
 /** Skills applicable to a scenario: those tagged with it, plus untagged (global) ones.
- *  #342:alias 窗撤销,单键查询——退役旧名标签不再命中(迁移面在 7.44 发车帖/MIGRATION 记载)。 */
+ *  [ref]:alias 窗撤销,单键查询——退役旧名标签不再命中(迁移面在 7.44 发车帖/MIGRATION 记载)。 */
 export declare function skillsForScenario(loaded: LoadedSkill[], scenario: string): SkillSpec[];
 export declare function parseFrontmatter(raw: string): {
     meta: Record<string, string>;

package/dist/capabilities/team.d.ts

@@ -5,7 +5,7 @@ import type { Logger } from "../observability/logger.js";
  * Packaged as ONE tool the lead calls once (same shape as the code-review council), so the run model is
  * unchanged.
  *
- * ── 词汇(#273 / C-R14,clay 直裁 [4123])──────────────────────────────────────────────────────
+ * ── 词汇([ref] / [ref],clay 直裁 [ref])──────────────────────────────────────────────────────
  * 「team」= agent-teams(持久具名团队)专用词;一次性多 agent 讨论叫「discuss」。所以**面向调用方/
  * 模型的名字**全部是 discussion:场景 `discuss`、工具 `run_discussion`、协调者提示词。
  * 而**模板注册面**(`BUILTIN_TEAMS` / `registerTeams` / `getTeam` / center 的 `teams` 键)保留 team
@@ -54,8 +54,8 @@ export declare function teamNames(): string[];
 export declare const DISCUSSION_TOOL_NAME = "run_discussion";
 /**
  * Build the discussion tool bound to a template + the consumer's per-call business injection.
- * #342:#273 过渡窗的 `run_team` 同款别名已随 `SCENARIO_ALIASES` 同批删(prompts 写死旧名的
- * 部署=「工具不存在」,[5064]/7.44 发车帖点名的预告语义)。
+ * [ref]:[ref] 过渡窗的 `run_team` 同款别名已随 `SCENARIO_ALIASES` 同批删(prompts 写死旧名的
+ * 部署=「工具不存在」,[ref]/7.44 发车帖点名的预告语义)。
  */
 export declare function createDiscussionTools(subRunner: Runner, template: TeamTemplate, opts: {
     objective: string;

package/dist/capabilities/tool-defer.d.ts

@@ -1,23 +1,23 @@
 /**
- * [803]④ defer face — EXPERIMENTAL long-tail per-tool defer (default OFF, `TOOL_DEFER_LONGTAIL=true`).
+ * [ref]④ defer face — EXPERIMENTAL long-tail per-tool defer (default OFF, `TOOL_DEFER_LONGTAIL=true`).
  *
  * Mechanics recap (core 1.287+ `tool-disclosure.js`, read for this assessment):
  *  - candidates for deferral are ONLY `spec.tools` (scenario/user tools) + MCP tools — core's first-party
  *    roster (Bash/Read/Edit/Grep/Glob/Write/…) is structurally NEVER deferred, so the CC "12 core tools
  *    inline" posture holds without any server action;
- *    ⚠️ **这句在中间那些世代上一度不成立**(#277 件⑤ 对表):`deferMode:"auto"` 的压力阀曾把内建 fs 族
- *    也卷进候选,小窗模型上首用即激活错;core 5.40.0(#308 a 案,判据帖 [4315] 翻面清单 #3)把阀候选
+ *    ⚠️ **这句在中间那些世代上一度不成立**([ref] 件⑤ 对表):`deferMode:"auto"` 的压力阀曾把内建 fs 族
+ *    也卷进候选,小窗模型上首用即激活错;core 5.40.0([ref] a 案,判据帖 [ref] 翻面清单 #3)把阀候选
  *    收回 caller specs,**内建恒 inline**,于是这句话重新为真。**对本仓零行为影响**——理由是下一条:
  *    我们从不开 auto。这一段留着是因为它是那次漂移的出处(数字对了而理由没对,是最难查的一类)。
  *  - MCP tool names are ALWAYS deferred (unconditional in `classifyDeferred`) — no server knob needed;
  *  - `RunnerDeps.deferMode:"auto"` is ALL-OR-NOTHING over the candidates (defers every spec tool once their
  *    combined inline chars exceed 10% of the window) — on our default scenario that would defer Agent and the
  *    Task quartet too, the OPPOSITE of the CC posture, so we deliberately do NOT enable it;
- *    🔴 该判断在 core 5.40.0 上**逐字仍成立**(#277 件⑤ 亲验):5.40 收窄的是「内建卷不卷进来」,而
+ *    🔴 该判断在 core 5.40.0 上**逐字仍成立**([ref] 件⑤ 亲验):5.40 收窄的是「内建卷不卷进来」,而
  *    Agent / Task 四件是 **caller spec 工具**,收窄后照样在候选池里 —— 所以「开了 auto 就会 defer 掉
  *    CC 姿势工具」这条不开 auto 的理由没有被这次收窄消解。
  *    我方**从不接线**这个座:全树零 `RunnerDeps.deferMode` 赋值(`deferModelPlane` 是 config-center 的
- *    同形近名,与本轴无关)。机器钉见 test/tool-defer.test.ts 的 #277 件⑤ 格 —— 这条「零接线」正是本仓
+ *    同形近名,与本轴无关)。机器钉见 test/tool-defer.test.ts 的 [ref] 件⑤ 格 —— 这条「零接线」正是本仓
  *    在两个 core 世代之间行为逐字不变的**全部**依据,所以它值一根钉而不只是一句注。
  *  - per-tool `ToolSpec.defer:true` is the precise instrument — that is what this helper applies.
  *
@@ -29,7 +29,7 @@
  * spontaneous "send the user the artifact" behavior it exists for → NOT in the defer set. That leaves
  * SelectEnvironment (~210 tokens; a discover-then-bind verb whose trigger scenario plausibly drives a
  * ToolSearch query) as the only honest candidate — a marginal win, hence experimental + default off, with the
- * final call left on the board ([806]③ honesty-over-preemption).
+ * final call left on the board ([ref]③ honesty-over-preemption).
  */
 import type { ToolSpec } from "@sema-agent/core";
 /** The long-tail set (names). Deliberately tiny — see the module header for why each other tool is excluded. */