@sema-agent/settings-schema 13.0.1 → 14.1.0

package/llms-full.txt

@@ -1,6 +1,6 @@
 <!--
 llms-full.txt — 自包含全文 · 消费方(使用者)视角 · @sema-agent/settings-schema
-重写日期: 2026-10-16 | 包版本: 13.0.1
+重写日期: 2026-10-18 | 包版本: 14.1.0
 生成方式: 无生成脚本——按当前树 src/*.ts 导出面 + package.json + README/CHANGELOG 手写事实版。
 证据约定: 每条"它怎么工作"的断言附 (文件: 符号) 坐标,刻意不用行号(行号逐版腐烂;符号名由
 typecheck 与 test/package-surface.test.ts、test/docs-hygiene.test.ts 等常驻门钉住)。无证据推断显式标【推断】。
@@ -64,7 +64,8 @@ registry:公网 npmjs,无需私有 registry 配置。
 - `EffectiveConfig`:全 16 域,skills 带全文 content 内联,rosters/entitlement 不清空。本地
   `loadLocalConfig().effective` 就是它。(src/types.ts: `EffectiveConfig`)
 - `EffectiveWire = Omit<EffectiveConfig,"skills"|"prompts"> & { skills: SkillsManifest; prompts?: unknown }`:
-  skills 的 content 换成 contentHash(manifest);wire 整形时 rosters/entitlement 被清空(隐私/收窄)。这是
+  skills 的 content 换成 contentHash(manifest);wire 整形时 rosters/entitlement 被清空(隐私/收窄);`prompts` 在 wire 上是
+  `EffectivePromptsWire`(`{schemaVersion: 2, artifact}`,中心为拉取方选出的那一份、盖上发布出处),读腿按在场性原样承运、由消费方判。这是
   远程 worker 真正收到的。(src/types.ts: `EffectiveWire`;src/resolve-roster.ts)
 - 转换发生在 `resolveEffectiveForWorker`(纯函数);本地路径不经过它,拿到的是全文 EffectiveConfig。
 
@@ -134,9 +135,12 @@ registry:公网 npmjs,无需私有 registry 配置。
   · execution:执行车道策略 —— `sessionMirror`(org 默认镜像目标)+ `publicKeys`(`ExecutionPublicKey`
     sealed-box 公钥登记,`workerId?` 多 worker 选钥)。
   · projects:项目身份登记簿(`ProjectRegistration`,`PROJECT_ID_REGEX` 宽读严写;租户身份数据,不便携)。
-  · prompts:声明轴(`PromptTextDeclaration` + 三维 `PromptBinding` global/worker/scenario,covering 语义)+
-    catalog 轴(immutable by-digest `PublishedPromptArtifactEnvelope`,`PROMPT_ARTIFACT_LIMITS` 镜像常量);
-    下发形 `EffectivePrompts` / `EffectivePromptsWire`。
+  · prompts(14.0.0 单轴):只装引擎当期 schema 的中心 artifact。存储 `PromptsConfig = { artifact?, workers? }`(artifact 的身份
+    `{payload, artifactDigest}`,`workers.<名>` 整份取代 scope 那份;`bindings` / `catalog` 是墓碑,存量经 SS-M10);下发 `EffectivePromptsWire =
+    { schemaVersion: 2, artifact }`;唯一选择读法 `promptArtifactFor(prompts, worker | null)`。v3 结构镜像 `PromptArtifact` / `PublishedPromptArtifact` /
+    `PromptArtifactPayload`(schemaVersion 3)/ `PromptOverlay`(无 `scope`)/ `PromptOverlayWhen` / `PromptBindingCondition`(`{anyOf}` 或 `{noneOf}` 恰一表)/
+    `PromptArtifactRequires` / `PromptArtifactEvidence`;上界镜像 `PROMPT_ARTIFACT_LIMITS`(引擎七键)、`PROMPT_BINDING_MAX_CHARS` / `PROMPT_BINDING_LIST_MAX`。
+    引擎词表不镜像(语义只有引擎 verify);逐条抢救 none(digest 约束)。
   · limits:cost/限流族 14 键的热更新发布位;**open-world `.passthrough()`**(未知键原样承运 +
     `"unknown-keys-carried"` 点名;1.x 论证见源头注,行为钉在 test/limits-domain-0.19.test.ts)。
 - 边界 schema(可直接复用):`ENV_NAME`(/^[A-Z_][A-Z0-9_]*$/ 且拒 AKIA 形)、`NON_SECRET_URL`(存量文档里的 URL 座位 —— 域文档与 `config.d/remote-exec.json`
@@ -405,8 +409,7 @@ entitlement/execution/limits = `none`;`projects` = `salvage`,整域档位仍 `"t
   (durable 行 `scope` 被兼容臂重铸,带 `from`/`to`)。行为一字未变 —— 2.0.0 只是把这次重写从静默改成出声。
 - node 绑定(`./node`):`loadSchedulerStore`/`saveSchedulerStore`/`createFileSchedulerStore`(4.0.0 改名,
   旧名 `fileSchedulerStore` 已删、零别名)、跨进程原子变更
-  `mutateSchedulerStore`。(prompts 对账锚 `promptsContentDigest`/`sectionContentHash` 4.0.0 起住在自己的
-  模块 `./prompts-digest`,仍从 `./node` 这条 subpath 出门 —— 消费方的 import 一字未改。)
+  `mutateSchedulerStore`。
 
 --- 4.10 api 契约(主 barrel;细分 `./api/auth` / `./api/auth-bridge` / `./api/scopes`) ---
 - `api/auth`:RFC 8628 设备流 + 旋转 refresh + logout 的 wire 形(snake_case 刻意保留);
@@ -454,7 +457,7 @@ entitlement/execution/limits = `none`;`projects` = `salvage`,整域档位仍 `"t
   `retiredEnvRefusal(env)`(纯,读传入的 env;码 `RETIRED_ENV_REFUSAL_CODE` = `config.env_key_retired`;只点名键不回显值);
   目录 wire 投影 `buildRetiredEnvWire()`。引擎起服 / 壳起本机引擎 / web-admin 渲染 worker env 判同一张表。
 
---- 4.11 Node-only(`./node`:file-store / file-edit / bundle / local-load / scheduler-store-node / prompts-digest) ---
+--- 4.11 Node-only(`./node`:file-store / file-edit / bundle / local-load / scheduler-store-node / 目录迁移) ---
 - `loadLocalConfig(root, {onWarning}?)` → `LocalConfig { effective, remoteExec, env, requiredEnv, warnings }`。
 - `loadRemoteExec(root)`(三态,§8 T3)、`writeRemoteExec`(校验+原子写)、`remoteExecPath`、`loadEnvFile`
   (`.env` merge over process.env,file 赢,支持 `KEY=file:<path>`)。
@@ -520,8 +523,8 @@ entitlement/execution/limits = `none`;`projects` = `salvage`,整域档位仍 `"t
 - `./one-time-migrations`(11.0.0,不进主 barrel):一次性迁移族 —— `migrateStoredDocuments(docs, { coverage })` / `migrateEffectiveSnapshot` /
   `migrateSchedulerRecords`、登记表 `ONE_TIME_MIGRATIONS`(每条的窗、删法、删后由谁接住)、收据形 `MigrationReceipt`(闭集 `appliedAs`)。
   纯函数,不抬任何版本号;按登记表的窗整族删。(src/one-time-migrations.ts)
-- `./node`(Node-only,拉 node:fs):file-store / file-edit / bundle / local-load / scheduler-store-node /
-  prompts-digest(prompts 下发包的内容摘要,4.0.0 从 scheduler-store-node 搬出、两个 sha256 铸点合成一只)。
+- `./node`(Node-only,拉 node:fs):file-store / file-edit / bundle / local-load / scheduler-store-node / 目录形一次性迁移
+  (`migrateConfigDirectory` + `nodeConfigDirectoryIo`)。(prompts 内容摘要 `promptsContentDigest` / `sectionContentHash` 14.0.0 随声明轴删除。)
   浏览器 bundle 绝不从这里 import。(src/node.ts)
 - `./conformance`(3.0.0,Node-only):跨仓一致性门 kit —— `runConformance(adapter, {mode})` 让消费方把
   **自己的生产入口**塞进来跑随包发的金样语料(`conformance/cases/**`),证同一份 settings 在几方读出的
@@ -610,7 +613,7 @@ R4. doctor 面板列缺失 secret:`loadLocalConfig(root).requiredEnv` 渲染 `pr
 R5. fleet 配置种到本地/反向:`exportBundle`/`writeBundle`/`readBundle`(remote-exec 不进 bundle,用
     `writeRemoteExec`)。
 R6. 复用 secret 边界:直接用 `ENV_NAME`/`NON_SECRET_URL`/`containsSecretToken`,别自写正则。
-R7. ETag/漂移检测:`stableHash`;skills/prompts 内容寻址:`skillContentHash`/`sha256Hex`。
+R7. ETag/漂移检测:`stableHash`;skills 内容寻址:`skillContentHash`/`sha256Hex`(prompts 的身份是引擎铸的 `artifactDigest`,本包不铸)。
 R8. 消费端读 wire:`readEffectiveWire(raw, onWarning)`(容错极性是裁定过的语义,别自己 parse 全量域)。
 R9. settings resolver:类别合并律读 `SAFETY_MERGE_SPEC` + `trustRank`/`isAtLeast`/`memberAdmission`,层准入读 `layerAdmission` +
     `SETTINGS_SOURCE_CONTRACT`(查口 `settingsSourceContract`),禁自铸 rank/成员/层档表;hooks 坏形读 `classifyHooksConfig`,禁自铸判官。

package/llms.txt

@@ -1,6 +1,6 @@
 <!--
 llms.txt — 消费方(使用者)视角索引 · @sema-agent/settings-schema
-重写日期: 2026-10-16 | 包版本: 13.0.1
+重写日期: 2026-10-18 | 包版本: 14.1.0
 生成方式: 无生成脚本——按当前树的 src/*.ts 导出面 + package.json + README/CHANGELOG 手写事实版;
 每条断言附证据坐标(文件:符号),刻意不用行号(行号随每版腐烂,符号名由 typecheck/test 钉住)。
 刷新触发: package.json 版号变更(test/docs-hygiene.test.ts D 组钉「包版本:」与 package.json 相等、
@@ -109,6 +109,12 @@ llms.txt — 消费方(使用者)视角索引 · @sema-agent/settings-schema
   (src/http-hook-allowlists.ts)
 - **MCP 名单判决**(13.0.0):`mcpServerPolicyVerdict(server, layers)` → `McpPolicyBlock{name, list, rule, target, written, sources}` 或 `undefined`;
   判按展开后目标、回显只按展开前写法(stdio 只给可执行名 + 参数个数);托管层 = 源表档 `managed` 的源(层只带源名)。(src/mcp-server-policy.ts)
+- **请求面 MCP 条目判官**(14.0.0,`src/mcp-request-entry.ts`):`isUsableWireName` / `describeBadWireName`(引擎线上名长界 `TOOL_WIRE_NAME_MAX_CHARS` 的镜像;首尾空白 = 坏名,不 trim 不规范化,内部空白合法)·
+  `isContentOriginWord` / `describeBadContentOrigin`(回显剥控制与双向字符、截 64 字、引号形)· `readMcpIdentityHeaders` · `readRequestMcpTransport`(硬坏形 `ok:false` 点名键路径;软坏形读器丢键并记进 `lost`;
+  `env` / `headers` 只收纯数据的「名 → 串」记录,`Map` / 类实例 / 自有 `__proto__` 成员不收、交副本,`lost` 条目带 `member` / `fault` 机读位)
+  + 值种类描述件 —— 服务端请求腿与壳的发送前预检同读一份(判据与原因句逐字同)。`toolFaces` 声明在本包解析透明,形归引擎摄入侧判,本包不镜像工具面词表。
+- **prompts 域单轴**(14.0.0):只装中心 artifact(存储 `PromptsConfig = { artifact?, workers? }` / 下发 `EffectivePromptsWire = { schemaVersion: 2, artifact }` /
+  唯一选择读法 `promptArtifactFor`);本包镜像 artifact v3 的结构与上界,语义交引擎 verify;13.x 两轴是墓碑,存量经一次性迁移 SS-M10。
 - **界面语言设置片段**(13.0.0):`UI_LANGUAGE_SETTING`(`semaUiLanguage`,`en` / `zh`,类 `ui`,用户设置)+ `readUiLanguage`(词表外 `ok:false`,不猜)。
   (src/ui-language.ts)
 - **fleet 契约**(drain / 实例发现 / 派发策略 / 配额租约 / 用量上报;S-741 重启信号 `RestartSignal` 定义一次,
@@ -170,5 +176,5 @@ llms.txt — 消费方(使用者)视角索引 · @sema-agent/settings-schema
 - 例子:`examples/toc-e2e.mjs`(可独立复跑的本地消费闭环,`npm run e2e`,须先 build)。
 - 消费方接入答疑:`docs/CONSUMER-INTEGRATION.md`;auth/scopes 的 OpenAPI 镜像:`docs/openapi-auth.yaml` /
   `docs/openapi-scopes.yaml`。
-- 内容寻址 sha256(skills body 懒拉、prompts 段落对账)、FNV-1a 64 `stableHash`(ETag/漂移检测)。
+- 内容寻址 sha256(skills body 懒拉)、FNV-1a 64 `stableHash`(ETag/漂移检测)。
   (src/sha256.ts;src/hash.ts;src/skills-manifest.ts)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sema-agent/settings-schema",
-  "version": "13.0.1",
+  "version": "14.1.0",
   "description": "Sema settings schema — pure config contract (zod domains + effective-config + roster resolution + ref-integrity + remoteExec) shared by sema-web-admin, sema-server, and the TOC desktop/CLI. One source of truth. (Renamed at 1.0.0 from @sema-agent/registry-core — name and docs only, no behavior change; note the range moves 0.19.0 -> 1.0.0, so a dependency must become ^1.0.0. The old names @sema-agent/registry-core <=0.19.0 and @sema-ai/registry-core remain published, frozen, for migration.)",
   "type": "module",
   "license": "BUSL-1.1",
@@ -149,7 +149,7 @@
     "publish:npm": "npm publish --access public --@sema-agent:registry=https://registry.npmjs.org/ --\"//registry.npmjs.org/:_authToken=${NPM_TOKEN}\""
   },
   "devDependencies": {
-    "@sema-agent/core": "7.47.0",
+    "@sema-agent/core": "7.53.0",
     "@types/node": "^22.10.0",
     "esbuild": "^0.21.5",
     "typescript": "^5.7.0",

package/dist/prompts-digest.d.ts

@@ -1,16 +0,0 @@
-/** [1057]① prompts contentDigest:canonical JSON(stableStringify 同姿势:键序稳定+深度护栏)全量 sha256,
- *  **非盐化**(三方可独立复算)。入参=下发形的 `{sections, scenarioOverrides?}`(packId/contentDigest
- *  自身不入 hash)。 */
-export declare function promptsContentDigest(payload: {
-    sections: unknown;
-    scenarioOverrides?: unknown;
-}): {
-    contentDigest: string;
-    packId: string;
-    /** [1062]③ 顺带:逐 section 对 `text` 铸的 contentHash(与 core 1.315 校验语义同刻度=
-     *  sha256(text));元素无 string text 位=undefined。web-admin 物化流程=先把这些写回
-     *  declaration.contentHash,再对含 hash 的终形铸整包 digest(本函数对入参原样铸,两步自洽)。 */
-    sectionHashes: Array<string | undefined>;
-};
-/** 逐 section 对账锚(core 1.315 `PromptTextDeclaration.contentHash` 同刻度):sha256(text)。 */
-export declare function sectionContentHash(text: string): string;

package/dist/prompts-digest.js

@@ -1,49 +0,0 @@
-/**
- * @sema-agent/settings-schema/node — prompts 下发包的**内容摘要**([1057]①/[1062]③)。
- *
- * 这两只是跨仓**对账锚**:web-admin 铸、server 透传、core 的 manifest 归因**独立复算**,三方算出同一个值才
- * 对得上账([1050]② operator 对账位)。所以它们只有一件事要守:**一个刻度**。
- *
- * 4.0.0 从 `scheduler-store-node.ts` 搬到这里(不 breaking —— 仍挂在 `./node` 这条 subpath 上,消费方的
- * import 一个字不用改)。两条理由:①它与调度存储(`scheduled_tasks.json` 的原子读写 + 跨进程变更原语)
- * 零关系,住在一起只是历史;②搬家顺手把**两个** sha256 铸点合成一只 —— 此前整包 digest 与逐 section
- * contentHash 各自 `createHash('sha256')` 一次、各自拼一次 `sha256:` 前缀,哪天有人只改一处就成了两个刻度,
- * 而没有一格会红(门:`test/prompts-digest-4.0.0.test.ts` 逐条看着铸点数与出门前缀数)。
- *
- * 摘要用本包**纯实现**的 sha256(`./sha256.ts`),不是 `node:crypto` —— 那份实现与
- * `createHash("sha256").update(s,"utf8").digest("hex")` 逐字节相同(`test/sha256.test.ts` 逐例压着,
- * 本模块的门再压一遍摘要值本身),于是整个包的 sha256 只有**一份实现**。
- */
-import { stableStringify } from './hash.js';
-import { sha256Hex } from './sha256.js';
-import { PROMPT_PACK_ID_PREFIX } from './types.js';
-/**
- * 本模块**唯一**的 sha256 铸点:一段 utf8 文本 → `{ hex, anchor }`。`anchor` = 出门形 `sha256:<hex>`
- * (自描述算法,与 skills 的内容地址同形),`hex` 给需要裸 hex 的那一处(packId 取前 12 位)。
- * 两个出门形从**同一次**摘要派生 —— 这正是本模块存在的理由。
- */
-function contentAnchor(text) {
-    const hex = sha256Hex(text);
-    return { hex, anchor: `sha256:${hex}` };
-}
-/** [1057]① prompts contentDigest:canonical JSON(stableStringify 同姿势:键序稳定+深度护栏)全量 sha256,
- *  **非盐化**(三方可独立复算)。入参=下发形的 `{sections, scenarioOverrides?}`(packId/contentDigest
- *  自身不入 hash)。 */
-export function promptsContentDigest(payload) {
-    const canonical = stableStringify({
-        sections: payload.sections,
-        ...(payload.scenarioOverrides !== undefined ? { scenarioOverrides: payload.scenarioOverrides } : {}),
-    });
-    const { hex, anchor } = contentAnchor(canonical);
-    const sectionHashes = Array.isArray(payload.sections)
-        ? payload.sections.map((s) => {
-            const t = s?.text;
-            return typeof t === 'string' ? sectionContentHash(t) : undefined;
-        })
-        : [];
-    return { contentDigest: anchor, packId: `${PROMPT_PACK_ID_PREFIX}${hex.slice(0, 12)}`, sectionHashes };
-}
-/** 逐 section 对账锚(core 1.315 `PromptTextDeclaration.contentHash` 同刻度):sha256(text)。 */
-export function sectionContentHash(text) {
-    return contentAnchor(text).anchor;
-}