@sema-agent/server 7.52.0 → 7.53.0

package/dist/config-center/apply-effective.d.ts

@@ -10,7 +10,7 @@ import type { EffectiveConfig } from "./types.js";
  *  reference captured at boot, so mutating it (vs reassigning) updates both with no split, no Runner rebuild. */
 export declare function mutateInPlace<V>(target: Record<string, V>, source: Record<string, V>): void;
 /**
- * #233 / A-002.8 —— 无法解读的名单条目的**代表元**。
+ * [ref] / [ref] —— 无法解读的名单条目的**代表元**。
  *
  * 为什么需要它(codex 复审 R1 真 finding):把坏条目**丢掉**会让 `[7, null]` 这种「在场但一条都读不
  * 懂」的名单塌成**空数组**,而空数组在消费端的语义恰恰是「治理关闭 = 全放行」—— 一个表达"我要限制"
@@ -23,14 +23,14 @@ export declare function mutateInPlace<V>(target: Record<string, V>, source: Reco
  * 🔴 只活在内存判定面:不进 wire(`/v1/models` 只发布尔)、不进日志(warn 打的是原始坏值的类型标记)。
  */
 export declare const UNPARSABLE_AT_MODEL_ALLOWLIST_ENTRY = "\0<unparsable-at-model-allowlist-entry>";
-/** 返回值=是否 COMMIT(false 两臂:[2283]③ 世代序 CAS 拒绝 / 5.49 swapPlane 换装拒绝——两臂都在
+/** 返回值=是否 COMMIT(false 两臂:[ref]③ 世代序 CAS 拒绝 / 5.49 swapPlane 换装拒绝——两臂都在
  *  commit 之前,活配置零触碰)。caller 收到 false 必须把**同一世代的旁路消费**(prompts 采用/pricing/
  *  keyResolver/etag 推进/LKG 落盘)一并跳过——否则 applyEffective 拒了主面、旁路却半应用同一个被拒
  *  世代,混合世代从侧门回来。首次 apply(live 未登记)恒 true。 */
-/** #322:一次 apply 的**世代账载荷**(post-commit 发,[2283]② —— commit 段仍是零回调零发射)。 */
+/** [ref]:一次 apply 的**世代账载荷**(post-commit 发,[ref]② —— commit 段仍是零回调零发射)。 */
 export interface ApplyReport {
     readonly version: number;
-    /** #325:本候选的收货序数(= opts.generation 原样带回;世代账按它记拒收,身份标仍是 version)。 */
+    /** [ref]:本候选的收货序数(= opts.generation 原样带回;世代账按它记拒收,身份标仍是 version)。 */
     readonly ordinal?: number;
     readonly limits: {
         /** 本世代真正换了值的键。 */
@@ -87,7 +87,7 @@ export declare function applyEffective(config: ServiceConfig, eff: EffectiveConf
 export declare const RUNTIME_GATE_KEYS: readonly ["rateLimitPerMin", "approvalRequire", "maxTaskCostUsd", "maxTaskTokens", "maxPrincipalCostUsd", "costQuotaWindowSec"];
 export type RuntimeGateKey = (typeof RUNTIME_GATE_KEYS)[number];
 /**
- * #322 批1:六闸里**已转热**的五个(限额族)——它们的属主是 `stage-limits.ts`(boot+refresh 双腿),
+ * [ref] 批1:六闸里**已转热**的五个(限额族)——它们的属主是 `stage-limits.ts`(boot+refresh 双腿),
  * 所以 boot-only 的闸车道不再写它们,`runtime-gates` 重启片也不再为它们铸重启理由(键是热的却还要求重启
  * = 白白滚动重启整片 fleet)。剩下的 `approvalRequire` 仍是 restart-to-apply,归批2。
  */
@@ -95,13 +95,26 @@ export declare const HOT_RUNTIME_GATE_KEYS: ReadonlySet<string>;
 /** Uniform presence rule (center f95438a): a gate is "managed" when the field is present — any number (incl. 0),
  *  or an array for approvalRequire. Sole guard: costQuotaWindowSec must be > 0 (a 0 window is nonsensical — core
  *  divides by it; center's `.positive()` already enforces, belt-and-suspenders here). */
+/**
+ * DESIGN-278 §5 S2([ref])—— center 这份 effective **当前在管**哪些 `ServiceConfig` 键(配置目录端点
+ * `GET /v1/config/catalog` 判 `effectiveLane` 的 center 半场)。
+ *
+ * 判据与各消费腿**同源**,不自铸第二份:
+ *  · limits 域 = `hasOwnProperty`(stage-limits 的 published 判据逐字——present 含显式 0);
+ *  · 六闸 legacy 位 = {@link runtimeGatePresent}(旧位 presence 规则的唯一属主);
+ *  · governance/runtime 热二件 + approvalRequire = 键在场(applyRuntimeHot 的 non-sticky 判据同门);
+ *  · readFace 域成员 = 键在场(read-face.ts 的逐键 env-wins 合成看的就是成员在场性);
+ *  · models 面 = 有启用行(markRosterLanded 同判据);atModelAllowlist 单列(整表重算键)。
+ * 纯投影零副作用;`undefined` eff(还没拉到 / 纯 env 形)⇒ 空集。
+ */
+export declare function centerManagedConfigKeys(eff: EffectiveConfig | undefined): ReadonlySet<string>;
 export declare function runtimeGatePresent(rt: NonNullable<EffectiveConfig["runtime"]>, key: RuntimeGateKey): boolean;
 export declare function applyRuntimeGates(config: ServiceConfig, rt: EffectiveConfig["runtime"], logger?: Logger): void;
 export declare function applyRuntimeHot(config: ServiceConfig, rt: EffectiveConfig["runtime"], logger?: Logger): void;
 /**
- * [865]① 显式默认解析——applyEffective 与 dry-run(logEffectiveDiff.wouldDefaultModel)共用的单源。优先级
+ * [ref]① 显式默认解析——applyEffective 与 dry-run(logEffectiveDiff.wouldDefaultModel)共用的单源。优先级
  * (显式源指向不在目录/未启用的名 ⇒ onDangling 回调后落下一级,绝不静默指错模型):
- *   1) eff.models.default 结构键 —— ✅ 既得路径([874] registry-core 0.10.11 落 `default?: string` schema
+ *   1) eff.models.default 结构键 —— ✅ 既得路径([ref] registry-core 0.10.11 落 `default?: string` schema
  *      键+per-worker /effective 直通;本地 lane 由 config-provider mapToServiceEffective 直通)。写面悬空 ref
  *      由 registry-core superRefine fail-loud;存量/未经 schema 路径仍走本函数的 warn 降级(双层姿势与
  *      activeTierGroup 同构)。(1.200-1.202 期间此级恒空=当时如实的前行 seam,codex H2 注记已兑现。)

package/dist/config-center/apply-effective.js

@@ -322,6 +322,51 @@ function stageEffective(config, eff, logger, opts) {
 }
 export const RUNTIME_GATE_KEYS = ["rateLimitPerMin", "approvalRequire", "maxTaskCostUsd", "maxTaskTokens", "maxPrincipalCostUsd", "costQuotaWindowSec"];
 export const HOT_RUNTIME_GATE_KEYS = new Set(BATCH1_LIMIT_KEYS);
+export function centerManagedConfigKeys(eff) {
+    const out = new Set();
+    if (!eff)
+        return out;
+    const limits = eff.limits;
+    if (limits) {
+        for (const k of BATCH1_LIMIT_KEYS)
+            if (Object.prototype.hasOwnProperty.call(limits, k))
+                out.add(k);
+    }
+    const rt = eff.runtime;
+    if (rt) {
+        for (const k of RUNTIME_GATE_KEYS)
+            if (runtimeGatePresent(rt, k))
+                out.add(k);
+        if (rt.autonomy !== undefined)
+            out.add("autonomy");
+        if (rt.commandPolicy !== undefined)
+            out.add("commandPolicy");
+    }
+    if (eff.governance) {
+        if (eff.governance.autonomy !== undefined)
+            out.add("autonomy");
+        if (eff.governance.commandPolicy !== undefined)
+            out.add("commandPolicy");
+        if (eff.governance.approvalRequire !== undefined)
+            out.add("approvalRequire");
+    }
+    const rf = eff.readFace;
+    if (rf !== undefined && rf !== null && typeof rf === "object") {
+        if (rf.face !== undefined)
+            out.add("readFace");
+        if (rf.denyPatterns !== undefined)
+            out.add("readDenyPatterns");
+        if (rf.denyBuiltinTiers !== undefined)
+            out.add("readDenyBuiltinTiers");
+        if (rf.denyBuiltinExclude !== undefined)
+            out.add("readDenyBuiltinExclude");
+    }
+    if ((eff.models?.models ?? []).some((m) => m.enabled !== false))
+        out.add("models");
+    if (eff.models?.atModelAllowlist !== undefined)
+        out.add("atModelAllowlist");
+    return out;
+}
 export function runtimeGatePresent(rt, key) {
     const v = rt[key];
     if (key === "approvalRequire")

package/dist/config-center/apply-ledger.d.ts

@@ -1,11 +1,11 @@
 /**
- * #322 —— **世代账**(design/322 §2 世代账,codex 设计审 F4)。
+ * [ref] —— **世代账**([ref] §2 世代账,codex 设计审 F4)。
  *
  * 身份标 = 上游 `EffectiveConfig.version`,**刻意不造跨进程 epoch**(codex F4 语义不变):
  *  · 同版本幂等重放(etag 未推进的下一拍)不该伪增世代;
  *  · 双副本对账「是不是同一代」必须能跨进程判 —— 同 source version = 同一代。
  *
- * 🔴 #325(test [4809],[4810] 阻断裁定):**序轴与身份标分离**。source version 在
+ * 🔴 [ref](test [ref],[ref] 阻断裁定):**序轴与身份标分离**。source version 在
  * `CONFIG_PROVIDER=local` 下是 registry-core file-store 的内容哈希(u53,上游契约只承诺
  * 「同 files ⇒ 同 number」,从未承诺序)——把它当序数消费,哈希更小的合法新代会被永久
  * 静默忽略且本账双盲(target/applied 都不动)。修后:**推进判断吃收货处铸的进程内单调
@@ -13,7 +13,7 @@
  * `version` 只做对账身份标——configTargetVersion 语义从「max(见过)」变为「**最后**见过的
  * 源代」(remote 单调腿二者等价;local 腿这才是真相)。
  *
- * 读面两个:`/health` 的三键(target / applied / 失败持续时长;#325 起 additive 补
+ * 读面两个:`/health` 的三键(target / applied / 失败持续时长;[ref] 起 additive 补
  * targetOrdinal/appliedOrdinal 两键=推进/停滞的机器判据)给编排器判「这个副本要不要摘」;
  * 诊断端点的 `configApply` 段给运维看**按组**的细节(哪一组停在哪一代、上一次为什么被拒)。
  *
@@ -42,9 +42,9 @@ export interface ConfigApplyLedgerView {
     readonly configTargetVersion: number;
     /** 最后一次成功 commit 的源版本(身份标)。 */
     readonly configAppliedVersion: number;
-    /** #325:target 的收货序数(进程内单调)——「见过多少代」的推进判据,哈希方向免疫。 */
+    /** [ref]:target 的收货序数(进程内单调)——「见过多少代」的推进判据,哈希方向免疫。 */
     readonly configTargetOrdinal: number;
-    /** #325:applied 的收货序数。targetOrdinal 推进而这里停滞 = 「改了没生效」的机器判据。 */
+    /** [ref]:applied 的收货序数。targetOrdinal 推进而这里停滞 = 「改了没生效」的机器判据。 */
     readonly configAppliedOrdinal: number;
     /** target≠applied 的**持续**时长(ms);收敛时键缺席(健康面不制造噪音)。 */
     readonly configApplyStaleMs?: number;
@@ -53,7 +53,7 @@ export interface ConfigApplyLedgerView {
 /** applyEffective 的 post-commit 报告(见 apply-effective.ts `ApplyReport`)。 */
 export interface ConfigApplyReport {
     readonly version: number;
-    /** #325:本候选的收货序数(applyEffective opts.generation 原样带回;缺席=version 兼容臂)。 */
+    /** [ref]:本候选的收货序数(applyEffective opts.generation 原样带回;缺席=version 兼容臂)。 */
     readonly ordinal?: number;
     readonly limits: {
         readonly applied: readonly string[];

package/dist/config-center/facade.d.ts

@@ -4,7 +4,8 @@
  * "universal internal schema → translate at the boundary" pattern, with our security boundary kept:
  *
  * (name history: this module tracks the control plane's product name, which has changed over time
- * — registry → sema-web → planned sema-admin. The module itself keeps a neutral, product-name-free
+ * — registry → sema-web → sema-web-admin (2026-08-26 repo/product rename; an earlier revision of
+ * this note listed "planned sema-admin" as the next step). The module itself keeps a neutral, product-name-free
  * identifier ("config-center") and does not chase the rename.)
  *
  *   - the CENTER owns the LOGICAL config: the model roster (names/capabilities/tier), the role map,
@@ -32,7 +33,7 @@
  *     gateway silently on the rate-limit path.
  *   - skills/mcp/scenarios/runtime-gates — restart-to-apply by construction (baked into the boot wiring).
  *
- * (design/158 A13, internal-lossless) This module is now a FACADE: the implementation lives
+ * ([ref] A13, internal-lossless) This module is now a FACADE: the implementation lives
  * alongside it in `src/config-center/` split by responsibility group (HTTP client / EffectiveConfig
  * application / restart-signal detection / skills+MCP consumption). Every symbol below is
  * re-exported UNCHANGED — existing `from ".../config-center/facade.js"` imports need zero changes

package/dist/config-center/hot-keys-registry.d.ts

@@ -1,5 +1,5 @@
 /**
- * #322 —— **热键登记表**(design/322 §4 机器门)。
+ * [ref] —— **热键登记表**([ref] §4 机器门)。
  *
  * 一个键「是不是热的」在本仓有三个互相独立的说法:①代码里真的接了写入面;②测试里真的有黑盒断言;
  * ③文档里对运维的承诺。三者任一漂了,受害者都是运维(改了配置,不知道该不该重启)。本表是**闭集单源**:
@@ -12,7 +12,7 @@
  * 但没接线」的条目正是本表要消灭的那种谎。
  */
 import type { ServiceConfigFlat, ServiceConfigGroups } from "../config-types.js";
-/** 换代手法(design/322 §2):A′=写入面接线(消费侧本就现读);B=值换代座位(对象已建、值被冻住)。 */
+/** 换代手法([ref] §2):A′=写入面接线(消费侧本就现读);B=值换代座位(对象已建、值被冻住)。 */
 export type HotKeyForm = "A-prime" | "B-setter";
 /** 三断言的用例 ID —— 与 test/config-hot 的参数化生成规则(`HK-<key>-<kind>`)逐字一致。 */
 export interface HotKeyCases {

package/dist/config-center/http-client.d.ts

@@ -2,7 +2,7 @@ import { type EntitlementRuntimeCaps } from "@sema-agent/settings-schema";
 import type { ScenarioRuling } from "../capabilities/scenarios.js";
 import type { EffectiveConfig, ExecutionRuling } from "./types.js";
 /** GET the effective config (Bearer + ETag). null = 304 (unchanged). Throws on transport/HTTP error, and on a
- *  payload that is not an effective config at all(非对象 / version 非有限数 / gate 域坏形——[2281] 裁B)。
+ *  payload that is not an effective config at all(非对象 / version 非有限数 / gate 域坏形——[ref] 裁B)。
  *  `domainErrors`:坏 catalog 域(schema default 已落)逐域单列——与本地腿 `FetchEffectiveResult` 同键同义,
  *  boot/refresh 的候选门直接消费。 */
 export declare function fetchEffective(baseUrl: string, token: string, etag: string | undefined, fetchImpl?: typeof fetch, worker?: string): Promise<{
@@ -14,7 +14,7 @@ export declare function fetchEffective(baseUrl: string, token: string, etag: str
     }>;
 } | null>;
 /**
- * design/99 §K (core 1.157 `RunnerDeps.runtimeCapsResolver`) — GET the PER-PRINCIPAL runtime
+ * [ref] §K (core 1.157 `RunnerDeps.runtimeCapsResolver`) — GET the PER-PRINCIPAL runtime
  * ENTITLEMENTS the engine enforces server-side, from center's `GET /api/config/effective?principal=&worker=`.
  * Center pre-resolves the tighten-only intersection (fleet defaults ∩ tier ⊕ roles + overrides) and returns a
  * `runtimeCaps` block — the service passes it through verbatim (no further tightening, per center's ruling).
@@ -42,7 +42,7 @@ export declare function fetchPrincipalCaps(baseUrl: string, token: string, princ
     etag?: string;
 } | null>;
 /**
- * design/170 件A —— 读 `?principal=` 响应里的 org 记忆解析段(org 目录腿的取数口)。
+ * [ref] 件A —— 读 `?principal=` 响应里的 org 记忆解析段(org 目录腿的取数口)。
  *
  * 🔬 **为什么不复用 {@link fetchPrincipalCaps}**(复审车 D-2 修):C3「两张表失败域互不干扰」是在档
  * 裁定,registry-core 的 `PrincipalCapsWire` 也正是为此把 org 段留成 `unknown`(「在本 schema 里校验
@@ -75,10 +75,10 @@ export declare class ConfigCenterHttpError extends Error {
  * the legacy `applyCenterSkills` path keeps treating every throw as "skip this skill, keep baseline".
  */
 export declare function fetchSkillContent(baseUrl: string, token: string, contentHash: string, fetchImpl?: typeof fetch): Promise<string>;
-/** [985]b / [1285]① — §9.4 by-digest 补拉二函(fetchSkillContent 同姿势:HTTP+Bearer+8s 超时+
+/** [ref]b / [ref]① — §9.4 by-digest 补拉二函(fetchSkillContent 同姿势:HTTP+Bearer+8s 超时+
  *  消费侧自证)。artifact=envelope JSON(验真=调用方过 core verifyPromptArtifact,canonical 重算——
  *  本函数只做传输与形读,不超范围解释);blob=段文本 raw-byte(sha256 逐位自证,fetchSkillContent 同款)。
- *  digest 参数收带前缀/裸 hex 两形([1285] 参数口径)。 */
+ *  digest 参数收带前缀/裸 hex 两形([ref] 参数口径)。 */
 export declare function fetchPromptArtifact(baseUrl: string, token: string, artifactDigest: string, fetchImpl?: typeof fetch): Promise<unknown>;
 export declare function fetchPromptBlob(baseUrl: string, token: string, contentDigest: string, fetchImpl?: typeof fetch): Promise<string>;
 //# sourceMappingURL=http-client.d.ts.map

package/dist/config-center/mcp-revocation.d.ts

@@ -1,11 +1,11 @@
 /**
- * #324(core 5.50 design/338 提货件)—— mid-turn MCP 撤销台账:`RunnerDeps.mcpRevocations` 席的宿主实现。
+ * [ref](core 5.50 [ref] 提货件)—— mid-turn MCP 撤销台账:`RunnerDeps.mcpRevocations` 席的宿主实现。
  *
  * 语义(与 core 契约对表,types.d.ts `RunnerDeps.mcpRevocations` 注):
  *  · 权威单点在宿主 —— core 每次 MCP dispatch 前**同步**探 `isRevoked(serverName)`,从不缓存答案。
  *  · 本台账记「中心**曾发布为 enabled、后从 enabled 集移除**」的服务器名。MCP mount 是 boot-baked
  *    (`resolveMcpServers` 只在启动期跑),所以**删除向**在 5.50 前只能等 restart 才生效——这正是
- *    design/338 要消的窗:治理面最要紧的动作(撤销一条对外通道)现在即时生效,restart 信号的
+ *    [ref] 要消的窗:治理面最要紧的动作(撤销一条对外通道)现在即时生效,restart 信号的
  *    删除向豁免见 `restart-signal.ts` 的 mcp 特判(`mcpRevocationLive` 前提,fail-closed:席没接线
  *    的部署保持旧的 restart 语义)。
  *  · **重现恢复是指纹判,不是名字判**(codex F1,confirmed):被撤的名字回到 enabled 集时,只有当
@@ -46,8 +46,10 @@ export declare function createMcpRevocationLedger(onChange?: (ev: {
 }) => void): McpRevocationLedger;
 /** 一拍 EffectiveConfig 的 ENABLED MCP 服务器条目表(`resolveMcpServers` 同判据:`enabled !== false`;
  *  值=整条目的 key 排序 JSON 指纹,Map 插入序=发布序);mcp 域缺席 ⇒ `null`(台账不动)。
- *  指纹口径与 restart-signal 的 stableStringify 同精神(key 序归一),但**刻意独立实现**:两处指纹
- *  只在各自域内自比,不跨域比对,无同源约束。 */
+ *  指纹序列化器 = restart-signal 的 `stableStringify`([ref] 2026-08-31 起同源:此前本文件持一份**逐字相同**的
+ *  私有复刻 `fingerprintOf`,两份在全部输入上字节恒等,合并零行为差,golden 钉 test/canonical-json-golden.test.ts)。
+ *  两处指纹仍只在各自域内自比、不跨域比对——同源只是去掉一份多余的复刻,不引入跨域约束;也**不**改用
+ *  `src/canonical-json.ts`(undefined 值键语义不同,见 restart-signal.ts 该函数顶注)。 */
 export declare function enabledMcpEntries(mcp: {
     servers: Array<{
         name: string;

package/dist/config-center/mcp-revocation.js

@@ -1,3 +1,4 @@
+import { stableStringify } from "./restart-signal.js";
 export function createMcpRevocationLedger(onChange) {
     let baseline;
     let seen;
@@ -40,19 +41,8 @@ export function enabledMcpEntries(mcp) {
     const out = new Map();
     for (const s of mcp.servers) {
         if (s.enabled !== false)
-            out.set(s.name, fingerprintOf(s));
+            out.set(s.name, stableStringify(s));
     }
     return out;
 }
-function fingerprintOf(v) {
-    if (v === null || typeof v !== "object")
-        return JSON.stringify(v) ?? "null";
-    if (Array.isArray(v))
-        return `[${v.map(fingerprintOf).join(",")}]`;
-    const obj = v;
-    return `{${Object.keys(obj)
-        .sort()
-        .map((k) => `${JSON.stringify(k)}:${fingerprintOf(obj[k])}`)
-        .join(",")}}`;
-}
 //# sourceMappingURL=mcp-revocation.js.map

package/dist/config-center/restart-signal.d.ts

@@ -12,7 +12,7 @@ export interface RestartSliceCtx {
      *  所以它们的变化不该产生 restart 理由 —— 否则 center 改一个本机用不上的键,整片 fleet 会为一次
      *  对自己毫无影响的发布滚动重启一遍。缺席 = 没有 env 覆盖 ⇒ 整域都算数(与旧行为一致)。 */
     readFaceEnvHeld?: readonly ("face" | "denyPatterns" | "denyBuiltinTiers" | "denyBuiltinExclude")[];
-    /** #324(core 5.50 design/338):撤销台账腿已接线(`RunnerDeps.mcpRevocations` 席在场且 refresh 拍在喂)。
+    /** [ref](core 5.50 [ref]):撤销台账腿已接线(`RunnerDeps.mcpRevocations` 席在场且 refresh 拍在喂)。
      *  true ⇒ mcp 片的**纯删除向**(current 的 enabled 集是 boot 集的逐字子集)不再签 restart —— 删除已被
      *  台账即时承接(core 每次 dispatch 前探 isRevoked),再签就是为一个已生效的变更滚动重启 fleet。
      *  新增/改址/域整体出现或消失仍签(新 mount / 改址只能 restart 才生效)。缺席/false = 旧语义照签
@@ -31,6 +31,16 @@ export interface RestartSignal {
     /** Epoch ms when this restart first became required (stable across refreshes while `reasons` is unchanged). */
     since: number;
 }
+/** Canonical, key-sorted JSON (array order preserved) so two semantically-equal effective slices fingerprint
+ *  identically regardless of object key order from the center serializer.
+ *
+ *  ⚠️ [ref](2026-08-31)如实登记:这**不是** `src/canonical-json.ts#canonicalJson`(core 逐字港,全仓单源)——
+ *  两者在 JSON 形输入上逐字节相同(golden 交叉读数已证),但本函数把 `undefined` 值键**保留为 `"k":null`**,
+ *  共享件按 `JSON.stringify` 语义**省略**。restart 指纹的输入是进程内构造的切片对象(zod 解析产物 + rest 展开/
+ *  挑字段),`{k: undefined}` 形原则上可达,而它与 `{}` 是否同指纹 = 本轴上的**行为**(多签/少签一次 fleet 滚动
+ *  重启),不是序列化器的私事 ⇒ 语义不恒等不合并;字节钉 test/canonical-json-golden.test.ts,K→O 统一另立件
+ *  走三问。导出只为 mcp-revocation 同源改调(两处此前各持一份逐字相同的复刻)与 golden 直钉,不是公共 API。 */
+export declare function stableStringify(v: unknown): string;
 /** Restart-to-apply slices that DIFFER between this process's BOOT config and a freshly-pulled one. Empty =
  *  nothing baked-at-boot changed (only hot-apply slices moved, or nothing) → no restart needed. An orchestrator
  *  can auto rolling-restart on a non-empty result WITHOUT a restart loop, because the comparison is always

package/dist/config-center/restart-signal.js

@@ -1,7 +1,7 @@
 import { resolveActiveTiers } from "@sema-agent/settings-schema";
 import { RUNTIME_GATE_KEYS, HOT_RUNTIME_GATE_KEYS, runtimeGatePresent, resolveDefaultModelName } from "./apply-effective.js";
 const RESTART_SLICES = ["skills", "mcp", "a2a", "scenarios", "runtime-gates", "models-tiers", "degrade-route", "read-face"];
-function stableStringify(v) {
+export function stableStringify(v) {
     if (v === null || typeof v !== "object")
         return JSON.stringify(v) ?? "null";
     if (Array.isArray(v))

package/dist/config-center/skills-mcp.d.ts

@@ -4,7 +4,7 @@ import type { Logger } from "../observability/logger.js";
 import type { LoadedSkill } from "../capabilities/skills.js";
 import type { CenterA2aPeer, CenterMcpServer, CenterSkillManifest } from "./types.js";
 /**
- * Merge center skills OVER the image baseline (design/41-sibling B1; `sema-registry docs/MCP-SKILLS.md`). Load order =
+ * Merge center skills OVER the image baseline ([ref]-sibling B1; `sema-registry docs/MCP-SKILLS.md`). Load order =
  * `loadSkills(SKILLS_DIR)` baseline → center skills lazily fetched by hash and overlaid BY NAME (center
  * wins on a clash → can override a built-in; guarded center-side by publisher RBAC + the publish gate).
  * `enabled:false` is skipped. Content is verified + cached by hash (same hash fetched once). A skill whose
@@ -28,7 +28,7 @@ export declare function resolveMcpServers(mcp: {
     servers: CenterMcpServer[];
 }, logger?: Logger): ScopedMcpServer[];
 /** The MCP servers applicable to a scenario: tagged with it, or untagged (global). undefined when none.
- *  #342:alias 窗撤销,单键命中(同 `skillsForScenario`)。 */
+ *  [ref]:alias 窗撤销,单键命中(同 `skillsForScenario`)。 */
 export declare function mcpForScenario(servers: ScopedMcpServer[] | undefined, scenario: string): McpServerSpec[] | undefined;
 /**
  * DESIGN-269 §2.1 —— resolve center A2A peers (`/effective.a2a`) into core `A2aServerSpec`s + the scenarios

package/dist/config-center/stage-limits.d.ts

@@ -1,12 +1,12 @@
 /**
- * #322 批1 —— limitsHttp 组的 **stage 半场**(design/322 手法 A′ + B 簇1)。
+ * [ref] 批1 —— limitsHttp 组的 **stage 半场**([ref] 手法 A′ + B 簇1)。
  *
  * 形与 `stageApprovalRequire` 同族:一切可抛/可判的事在 stage 做,commit 段只剩纯赋值。三条本域纪律:
  *
  *  1. **非粘**(applyRuntimeHot 的 NON-STICKY 同源):每次 apply 都从 **env 基线**重算 `present ? center : baseline`
  *     ——center 撤键 ⇒ 回 env 底。「缺席=保上一个 center 值」会把一次已经撤回的限额永久冻在进程里。
- *  2. **整批原子**(design/322 §0③ + §4 混批零变异):本域任一键坏值/任一跨键不变量不过 ⇒ **整批拒**,
- *     合法键也不落地,旧值继续服务,拒因响亮点名键(#123 法)。半应用一个限额面 = 运营看到的数字与真门
+ *  2. **整批原子**([ref] §0③ + §4 混批零变异):本域任一键坏值/任一跨键不变量不过 ⇒ **整批拒**,
+ *     合法键也不落地,旧值继续服务,拒因响亮点名键([ref] 法)。半应用一个限额面 = 运营看到的数字与真门
  *     不是同一代,比整批拒糟得多。
  *  3. **判据单源**:跨键不变量走 `config-invariants.ts` 的同一张表(boot 与 stage 同表);数值下限走
  *     config.ts 导出的同一组 floor 常量(env 腿夹取、center 腿拒——**判据阈值同源,处置刻意不同**:

package/dist/config-center/types.d.ts

@@ -2,7 +2,7 @@
  * config-center wire types — the config-center `/api/config/effective` payload shapes (`CenterModel`,
  * `CenterTeam`, `CenterSkillManifest`, `CenterMcpServer`, `EffectiveConfig`) plus the per-principal
  * execution/session-mirror ruling shapes riding the caps view (`ExecutionRuling`/`SessionMirrorRuling`).
- * Pure type/interface declarations — no runtime logic. Split out of `facade.ts` (design/158 A13,
+ * Pure type/interface declarations — no runtime logic. Split out of `facade.ts` ([ref] A13,
  * internal-lossless: the facade re-exports every symbol below unchanged).
  */
 import type { ToolContentOrigin } from "@sema-agent/core";
@@ -30,11 +30,11 @@ export interface CenterModel {
     vision?: boolean;
     contextWindow?: number;
     maxTokens?: number;
-    /** [818]① 1M dual-window (core 1.289 `Model.autoCompactTokens`): an EXPLICIT roster value wins the
+    /** [ref]① 1M dual-window (core 1.289 `Model.autoCompactTokens`): an EXPLICIT roster value wins the
      *  contextWindow derivation in toModel (applyAutoCompactWindow). Declared on the type face (codex F5) so the
      *  config-provider local-lane projection carries it — toModel keeps its structural read for older shapes. */
     autoCompactTokens?: number;
-    /** design/123 D2 (core 1.226): chars ≈ 1 token for this model's tokenizer, feeding every structural
+    /** [ref] D2 (core 1.226): chars ≈ 1 token for this model's tokenizer, feeding every structural
      *  (non-usage-anchored) token estimate. CJK-heavy models should declare 2–3; absent → env default → core 4. */
     charsPerToken?: number;
     cost?: {
@@ -47,7 +47,7 @@ export interface CenterModel {
      *  记账时固化进 UsageEntry.{weightedTokens,quotaWeightAtUse} 与 lease weightedTokens 轴;改倍率只影响
      *  此后记账,不回算窗口内历史(registry types.d.ts 同句契约)。 */
     quotaWeight?: number;
-    /** design/111 L2②: per-model declarative thinking config (center roster). defaultThinking = this model's DEFAULT
+    /** [ref] L2②: per-model declarative thinking config (center roster). defaultThinking = this model's DEFAULT
      *  tier (resolution chain spec.thinking ?? role.thinking ?? model.defaultThinking); reasoningEffortLevels (openai
      *  endpoints) = tiers the endpoint accepts. Validated against core's ThinkingLevel in toModel; "off" is dropped. */
     defaultThinking?: string;
@@ -58,10 +58,10 @@ export interface CenterModel {
      *  the ONLY way to keep per-model tuning that lived in env (`MODEL_FREQUENCY_PENALTY` etc.) — see the
      *  review-gw heterogeneous-roster migration. MUST be static per published version (prompt-cache prefix). */
     extraBody?: Record<string, unknown>;
-    /** registry-core 0.10.13 ([1002]/[998]⑤c): per-model behavior-slot mitigation sentences, mirrors core
+    /** registry-core 0.10.13 ([ref]/[ref]⑤c): per-model behavior-slot mitigation sentences, mirrors core
      *  `Model.promptGuidance` (core 1.303+ assembles them into the volatile tail's per-model position).
      *  Same category as `extraBody`: logical model metadata, carried verbatim — without this projection the
-     *  configured sentences parse fine in registry-core but never reach the assembly face ([1028]① 排雷:
+     *  configured sentences parse fine in registry-core but never reach the assembly face ([ref]① 排雷:
      *  the missing leg made every promptGuidance pilot a false control). */
     promptGuidance?: string[];
     enabled?: boolean;
@@ -109,7 +109,7 @@ export interface CenterMcpServer {
      *  loop unless an operator explicitly opts it in. */
     elicitation?: boolean;
     /**
-     * design/378(core 5.60.0)—— 声明**这台 server 的整套工具**带回来的内容属于哪一类,映射到
+     * [ref](core 5.60.0)—— 声明**这台 server 的整套工具**带回来的内容属于哪一类,映射到
      * `McpServerSpec.contentOrigin`。`"local"` / `"execution"` ⇒ 这台 server 的调用不再给本会话记忆打
      * 「已接触外来内容」标(`execution` 仍留在 `execIsExternalContent` 那只旋钮的射程内);`"external"` 是
      * 显式 PIN,而**PIN 不是空操作** —— 它会取消 `trustedTools` 对这台 server 的按名豁免。
@@ -121,9 +121,13 @@ export interface CenterMcpServer {
      * 所以它的家在 center 下发这条腿;请求腿那半场的门与结构性兑现见 `task-mcp.ts`
      * 的 `assertRequestMcpContentOrigin` 顶注。
      *
-     * ⚠️ **本地 `config.d` 腿今天到不了这里**(如实登记,别读成「两条腿都通」):那条腿的原料形是
-     * registry-core 的 zod schema,未知键被 strip;等 registry-core 补上同名可选键,
-     * `config-provider.ts` 的映射再加一行即可(远端 `/effective.mcp` 腿是直读 JSON,今天就通)。
+     * ⚠️ **两条腿今天都到不了这里**([ref]③ / [ref]③ / [ref],2026-08-31 双绊线实测更正 —— 本注旧版那句
+     * 「远端 /effective.mcp 腿是直读 JSON,今天就通」**不成立**,doc-rot):settings-schema(原 registry-core)
+     * 的 `McpServerSpec` 是默认 strip 的 zod object 且没有 `contentOrigin` 可选键,本地腿在 FileConfigStore 的
+     * `parseDomainLoud(DOMAIN_SCHEMAS.mcp)`、远端腿在消费端边界 `readEffectiveWire`([ref] 裁B)**各被剥一次**。
+     * 修在 sema-settings-schema(补同名可选枚举键 + 发包),本仓提货后 `config-provider.ts` 的映射加一行即通;
+     * 两条 `it.fails` 绊线(test/config-center-wire-read.test.ts + test/config-provider.test.ts)在上游到货时
+     * 自动翻红逼销账。
      */
     contentOrigin?: ToolContentOrigin;
     transport: {
@@ -132,7 +136,7 @@ export interface CenterMcpServer {
         args?: string[];
         envRefs?: Record<string, string>;
     }
-    /** `principalHeader` (design/62): the header name into which the runner injects the task's authenticated
+    /** `principalHeader` ([ref]): the header name into which the runner injects the task's authenticated
      *  end-user principal per-task, so a consumer MCP (e.g. oa-mcp) can enforce per-user RBAC. Not a ref — a
      *  literal header name. The runner fills the value (never the model). */
      | {
@@ -159,14 +163,14 @@ export interface CenterA2aPeer {
     /** env-NAME refs (header-name → ENV_NAME) resolved from THIS service's env at boot. A peer with ANY
      *  unset ref is SKIPPED wholesale (fail-safe — never dial a peer half-credentialed). */
     headerRefs?: Record<string, string>;
-    /** design/62, same contract as the MCP side: the header name the runner injects the task's authenticated
+    /** [ref], same contract as the MCP side: the header name the runner injects the task's authenticated
      *  end-user principal into. Not a ref — a literal header NAME (the runner fills the value, never the model). */
     principalHeader?: string;
     /** Optional allowlist of the peer's skill ids to mount (others are not mounted). */
     allowSkills?: string[];
 }
 /**
- * #A4([4147] 窗三件批 件1;[4073]/[4083] 承诺件)—— READ 容纳面的 center 下发形(`CenterA2aPeer` 的
+ * #A4([ref] 窗三件批 件1;[ref]/[ref] 承诺件)—— READ 容纳面的 center 下发形(`CenterA2aPeer` 的
  * 同族:一个 additive 顶层域,server 声明它才不会被静默丢弃)。四个成员逐一对应部署 env 的四键
  * (`READ_FACE` / `READ_DENY_PATTERNS` / `READ_DENY_BUILTIN_TIERS` / `READ_DENY_BUILTIN_EXCLUDE`),
  * 消费半场 = `config-center/read-face.ts` `applyCenterReadFace`。
@@ -192,11 +196,11 @@ export interface CenterReadFace {
     denyBuiltinExclude?: string[];
 }
 /**
- * #322 批1 的 wire 面(`EffectiveConfig.limits`)。**全 optional**:缺席 = 本域不管这一键 ⇒ 该键回 env
+ * [ref] 批1 的 wire 面(`EffectiveConfig.limits`)。**全 optional**:缺席 = 本域不管这一键 ⇒ 该键回 env
  * 基线(非粘,applyRuntimeHot 的 NON-STICKY 同族纪律 —— 「缺席=保上一个 center 值」会把撤回的治理永久冻住)。
  *
  * 🔴 类型是**到货 JSON 的声明**,不是运行时保证(local 腿的 eff 来自原始 JSON):每个键在 stage 侧都
- * 逐个验型验域,坏值 ⇒ 整批拒 + 旧值继续服务(#123 响亮拒)。
+ * 逐个验型验域,坏值 ⇒ 整批拒 + 旧值继续服务([ref] 响亮拒)。
  */
 export interface EffectiveLimits {
     /** 每 principal 每分钟请求上限;**0 = 关**(关断哨兵,不是缺席)。 */
@@ -234,7 +238,7 @@ export interface EffectiveLimits {
 export interface EffectiveConfig {
     version: number;
     updatedAt: string;
-    /** [2373]B-6:default/tierGroups/activeTierGroup 收进类型面(registry-core 0.13.0 已声明,
+    /** [ref]B-6:default/tierGroups/activeTierGroup 收进类型面(registry-core 0.13.0 已声明,
      *  types.d.ts:641/679/724)——此前 wire 面靠「JSON verbatim + 消费方结构读」逃逸,投影/消费两侧
      *  各自 as 宽铸。tierGroups 上游是 ZodDefault(合规 center 恒发),但本类型描述的是**到货 JSON**
      *  (含非合规/旧存量 center),故仍标 optional——消费方 resolveActiveTiers 自身容缺。 */
@@ -299,7 +303,7 @@ export interface EffectiveConfig {
         commandPolicy?: CommandRule[];
     };
     /**
-     * #322 批1 —— **limitsHttp 组的热更新发布域**(design/322 §6 批1)。
+     * [ref] 批1 —— **limitsHttp 组的热更新发布域**([ref] §6 批1)。
      *
      * 🔴 为什么是**新顶层域**而不是往 `runtime` 里加键(亲验,不是推测):registry-core 的 `RuntimeConfig`
      * 是 zod `"strip"` 对象,`runtime` 里的未知键在**两条腿上都会被静默剥掉**(local 腿实测
@@ -320,7 +324,7 @@ export interface EffectiveConfig {
     limits?: EffectiveLimits;
     /** 142-S4(registry-core 0.10.0 第 15 域):center 项目登记簿。wire 面 verbatim JSON —
      *  registry-core `ProjectsConfig` 的形状是 `{projects: Record<projectId, ProjectRegistration>}`(skills/mcp
-     *  同款域包裹)。[2373]B-8:裸 Record 联合臂随 apply-effective 的宽读一起删(0.13.0 只有包裹形,
+     *  同款域包裹)。[ref]B-8:裸 Record 联合臂随 apply-effective 的宽读一起删(0.13.0 只有包裹形,
      *  裸形无 producer)。消费=applyEffective → config.projects(displayName/gitRemotes/defaultScopes
      *  三个 runtime 字段;审计字段不进 ServiceConfig)。 */
     projects?: {
@@ -334,7 +338,7 @@ export interface EffectiveConfig {
         commandPolicy?: CommandRule[];
         approvalRequire?: string[];
     };
-    /** plugins 域(registry-core 0.5 additive;契约冻结 [1361]②/[1362]/[1366]①,消费半场 2026-07-28
+    /** plugins 域(registry-core 0.5 additive;契约冻结 [ref]②/[ref]/[ref]①,消费半场 2026-07-28
      *  开工车):center 只存"插件从哪来"(PluginSpec 引用,永不承载可执行字节);worker 半场在
      *  capabilities/center-plugins.ts `applyCenterPlugins`(https-only+ALLOW_HOSTS 纵深复验/sha 钉扎/
      *  隔离 clone/LKG/撞名让位)。此前本 interface 无此键 ⇒ wire 上的 plugins 被 server 静默丢弃。 */

package/dist/config-invariants.d.ts

@@ -1,5 +1,5 @@
 /**
- * #322 —— **跨键不变量的单源表**(design/322 §2 A′,codex 设计审 F2)。
+ * [ref] —— **跨键不变量的单源表**([ref] §2 A′,codex 设计审 F2)。
  *
  * 病灶:boot 期的跨域不变量(拒启 throw)散在 `config.ts` 的装配尾与 `main.ts` 的开头。把配置改热之后,
  * 每一条都变成一个**热路径上的漏检**:一次发布可以在运行期造出 boot 期会当场拒启的姿态(无鉴权写面被

package/dist/config-provider.d.ts

@@ -3,7 +3,7 @@ import { type EffectiveConfig as AgentConfigEffective } from "@sema-agent/settin
 import { fetchEffective as remoteFetchEffective, fetchSkillContent as remoteFetchSkillContent, type EffectiveConfig } from "./config-center/facade.js";
 /** Result of a `fetchEffective` — EXACTLY the config-center's return: the effective config + its etag, or
  *  `null` for "unchanged" (remote 304; local: the version matched the caller's prior etag).
- *  `domainErrors`([898] registry-core 0.10.12 tolerant seam,local lane only):catalog 域坏文件不再
+ *  `domainErrors`([ref] registry-core 0.10.12 tolerant seam,local lane only):catalog 域坏文件不再
  *  连坐全包回落 env——坏域按该域 schema default 落+错误单列,好域照常生效;caller(main.ts)对每条打
  *  per-domain warn 点名坏域。gate 域(governance/rosters/…)坏文件 tolerant 仍 throw(READ 容错不放宽
  *  gate fail-loud,registry-core 半场精化)——那条路走既有的整包 catch。 */
@@ -101,7 +101,7 @@ export declare class LocalConfigProvider implements ConfigProvider {
     #private;
     readonly kind: "local";
     private readonly store;
-    /** [875]b 可观测性:config_loaded 日志要能回答「到底读的哪个目录」——复验实录:只设 LOCAL_DATA_ROOT 时
+    /** [ref]b 可观测性:config_loaded 日志要能回答「到底读的哪个目录」——复验实录:只设 LOCAL_DATA_ROOT 时
      *  config.d 静默读不到且 0 模型无告警(CONFIG_LOCAL_DIR 才是本 lane 的选目录旋钮)。 */
     readonly root: string;
     constructor(root: string, store?: FileConfigStore);