@sema-agent/server 7.52.1 → 7.53.0

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. */

package/dist/config-catalog.d.ts

@@ -0,0 +1,139 @@
+/**
+ * DESIGN-278 §5 S2([ref])—— 配置目录本体:`GET /v1/config/catalog` 的数据层。
+ *
+ * ## 形
+ * 目录 = **逐 env 键**一行(分母 = 全 `src/` 生产运行时的 env 读取点;完备性由
+ * `test/config-catalog.test.ts` 的 D1 双向 AST 对账门执法 —— 多一行是幽灵键、少一行是漏登记,两个方向
+ * 都当场红)。每行静态登记 `{域、类型、一句话语义、staticDefault?/derivedDefaultNote?、危险轴、center
+ * 联接(domain/path/优先序/时机)}`,运行期由 {@link buildConfigCatalog} 补上**本进程实算**的
+ * `{envHeld、effectiveLane、effectiveValue、center.managedNow/effectiveNow/domainExists}`。
+ *
+ * ## 词表纪律([ref]:闭集,未知词=编译红)
+ *  · 类型 {@link CATALOG_VALUE_TYPES} / 时机 {@link CATALOG_TIMINGS} / 危险轴 {@link CATALOG_DANGER_AXES}
+ *    全是 `as const` 闭集;restart 片集 {@link CATALOG_RESTART_SLICES} 用 `Record<RestartSlice, true>`
+ *    锁步 —— core/config-center 的片集变了,这里不改就 tsc 红。
+ *  · 域 = `ServiceConfigGroups` 的九组键(类型锁步,不自铸第二份分组)。
+ *
+ * ## secret 纪律(设计稿 §0.5 补偿条款)
+ *  `secret` 类值**永不出本模块**(只回 `{present}`);`opaque` 类(策略 JSON/公钥表/证书)回
+ *  `{present, length}`;`url` 类剥 userinfo(config 实算腿与 env 原文腿同裁)。机器钉 =
+ *  test/config-catalog.test.ts 的响应体 canary 扫描格 + 名字启发式兜底格。
+ *
+ * ## 生效时机模型(设计稿 §3:标注是「键 × 写入通道」的属性)
+ *  env 腿恒 `deploy`(env 在运行期不可变;retired/无消费键标 `inert`);center 腿按域:limits 热
+ *  (costQuotaWindowSec 除外 —— 显式 deferred,铸因 `cost-quota-window`)、governance 热二件、
+ *  approvalRequire 走 `runtime-gates` 重启片、readFace 族 `read-face` 片且 **env-wins**(⚪ 成因 a)、
+ *  models 面 **本进程实算**(tier 表在场 ⇒ restart/models-tiers,tier-less ⇒ hot)。
+ *  readFace 在 settings-schema 现行 DOMAINS 里**没有域**(R-15:暂不开)⇒ `domainExists:false`,
+ *  writeLanes 不含 center(⚪ 成因 b 的诚实呈现)。
+ */
+import type { ServiceConfig, ServiceConfigGroups } from "./config-types.js";
+import type { ConfigKnobRecord } from "./config.js";
+import type { RestartSlice } from "./config-center/restart-signal.js";
+export declare const CATALOG_VALUE_TYPES: readonly ["boolean", "number", "string", "enum", "csv", "json", "path", "url", "secret", "opaque"];
+export type CatalogValueType = (typeof CATALOG_VALUE_TYPES)[number];
+export declare const CATALOG_TIMINGS: readonly ["hot", "restart", "deploy", "inert"];
+export type CatalogTiming = (typeof CATALOG_TIMINGS)[number];
+export declare const CATALOG_DANGER_AXES: readonly ["security", "billing", "data"];
+export type CatalogDangerAxis = (typeof CATALOG_DANGER_AXES)[number];
+/** 域 = 配置九组(类型锁步:组集变了这里跟着红)。 */
+export type CatalogDomain = keyof ServiceConfigGroups;
+export declare const CATALOG_RESTART_SLICES: readonly RestartSlice[];
+/** center 联接座(spec 层)。`models-plane` 是内部时机词:build 时按 tier 表在场性实算成 hot/restart。 */
+export interface CatalogCenterSeatSpec {
+    readonly domain: string;
+    readonly path: string;
+    /** `centerManagedKeys`(config-center 在管键集)里查「在管」用的键;models 面统一 "models"。 */
+    readonly centerKey: string;
+    readonly precedence: "center-wins" | "env-wins";
+    readonly timing: "hot" | "restart" | "inert" | "models-plane";
+    readonly restartSlice?: RestartSlice;
+    readonly restartReason?: string;
+}
+export type CatalogValue = string | number | boolean | readonly string[] | null | {
+    readonly present: boolean;
+    readonly length?: number;
+};
+export interface ConfigCatalogSpec {
+    readonly name: string;
+    readonly domain: CatalogDomain;
+    readonly type: CatalogValueType;
+    readonly semantics: string;
+    readonly staticDefault?: string;
+    readonly derivedDefaultNote?: string;
+    readonly danger?: readonly CatalogDangerAxis[];
+    readonly enumValues?: readonly string[];
+    /** `ServiceConfig` 的平铺键(实算兜底 + center managedNow 判据对表用;嵌套块不填,走 resolve)。 */
+    readonly configKey?: string;
+    /** 本进程实算(非 secret/opaque 行才可用;返回 undefined = 本行没有实算腿,落 env 原文/staticDefault)。 */
+    readonly resolve?: (config: ServiceConfig) => CatalogValue | undefined;
+    readonly center?: CatalogCenterSeatSpec;
+    /** 缺省 "deploy";retired/零消费键标 "inert"(设计稿 ⚪ 的 env 腿投影)。 */
+    readonly envTiming?: "inert";
+    readonly scope?: "bootstrap-only";
+}
+export interface ConfigCatalogRowCenter {
+    readonly domain: string;
+    readonly path: string;
+    readonly precedence: "center-wins" | "env-wins";
+    readonly timing: Exclude<CatalogTiming, "deploy">;
+    readonly restartSlice?: RestartSlice;
+    readonly restartReason?: string;
+    /** settings-schema 现行 DOMAINS 里真有这个域(false = 设计稿 ⚪ 成因 b「该片暂无配置中心写腿」)。 */
+    readonly domainExists: boolean;
+    /** center 的最近一份 effective **当前在管**本键(没有配置管道 ⇒ 恒 false)。 */
+    readonly managedNow: boolean;
+    /** center 写**现在真的在生效**(在管 ∧ 未被 env 占位压住;env-wins 族 env 占位 ⇒ false = ⚪ 成因 a)。 */
+    readonly effectiveNow: boolean;
+}
+export interface ConfigCatalogRow {
+    readonly name: string;
+    readonly domain: CatalogDomain;
+    readonly type: CatalogValueType;
+    readonly semantics: string;
+    readonly writeLanes: readonly ("env" | "center")[];
+    readonly effectiveLane: "env" | "center" | "default";
+    readonly envHeld: boolean;
+    readonly envTiming: "deploy" | "inert";
+    readonly staticDefault?: string;
+    readonly derivedDefaultNote?: string;
+    readonly effectiveValue: CatalogValue;
+    readonly valueClass: "plain" | "secret" | "opaque";
+    readonly danger: readonly CatalogDangerAxis[];
+    readonly center?: ConfigCatalogRowCenter;
+    readonly centerDomain?: string;
+    readonly centerPath?: string;
+    readonly scope?: "bootstrap-only";
+    readonly enumValues?: readonly string[];
+}
+export interface ConfigCatalogInputs {
+    readonly config: ServiceConfig;
+    readonly env: NodeJS.ProcessEnv;
+    readonly knobs: readonly ConfigKnobRecord[];
+    /** settings-schema 现行 DOMAINS(调用方传入 —— 本模块保持纯数据层,零包依赖)。 */
+    readonly centerDomains: readonly string[];
+    /** config-center 当前在管的 ServiceConfig 键集(缺席 = 没有配置管道)。 */
+    readonly centerManagedKeys?: ReadonlySet<string> | undefined;
+}
+export interface ConfigCatalogWire {
+    readonly catalogVersion: 1;
+    /** env 腿的统一时机(env 运行期不可变 ⇒ 改 env=改部署面;行级 `envTiming:"inert"` 覆写)。 */
+    readonly envLaneTiming: "deploy";
+    readonly restartSlices: readonly RestartSlice[];
+    readonly centerDomains: readonly string[];
+    readonly summary: {
+        readonly total: number;
+        readonly envHeld: number;
+        readonly secret: number;
+        readonly centerManaged: number;
+    };
+    readonly rows: readonly ConfigCatalogRow[];
+}
+/**
+ * 目录表(按名排序 —— 卫生格执法)。语义句以读取点实现为准(不信注释纪律:本表成文时逐键对过
+ * config.ts / boot / plugins 的真实读取臂;后续漂移由 D1 对账门逼着回到这里补行)。
+ */
+export declare const CONFIG_CATALOG: readonly ConfigCatalogSpec[];
+/** `build*` 命名(工厂纪律):产物是纯数据(wire 投影),零方法零捕获行为。 */
+export declare function buildConfigCatalog(inputs: ConfigCatalogInputs): ConfigCatalogWire;
+//# sourceMappingURL=config-catalog.d.ts.map