@sema-agent/client-core 0.9.0 → 0.10.0

package/README.md

@@ -23,17 +23,19 @@ Renamed from **`@sema-agent/wire-cc-adapter`** (0.1.x, deprecated — see *Migra
 
 ## Scope
 
-- **Today (0.9.0)** — the adapter seam, the whole `adapt()` pipeline (all 14 A-layer arms plus the
+- **Today (0.10.0)** — the adapter seam, the whole `adapt()` pipeline (all 14 A-layer arms plus the
   B/D/E tool-card layers), the notification/caps/model families, the adapter kernel (stream driver
-  + downstream projectors), the request-shaping surface, the fleet/panel projections and the
-  subagent wire family, the workflow monitor contract + live source, the model catalog tables, and
-  the **HITL family** (`hitl/`: the D-1 approval bridge, the ask-gate stream bridge, the
-  tool-approval wire, plan review, and the pending-approvals push feed).
-- **Planned** — what is still in the shell: the print lane tail (batch B8) and the registry
-  user-plane hand-copies (they retire onto `@sema-agent/sdk/registry`, not into this package);
-  plus everything that is genuinely host-specific — Ink rendering and keyboard interaction,
-  filesystem persistence, pty/terminal, and the signal-path teardown. The web session view
-  (first target consumer) and the desktop client (second) consume the same package.
+  + downstream projectors), the request-shaping surface **for both lanes** (interactive and the
+  headless `-p` print lane), the fleet/panel projections and the subagent wire family, the workflow
+  monitor contract + live source, the model catalog tables, and the **HITL family** (`hitl/`: the
+  D-1 approval bridge, the ask-gate stream bridge, the tool-approval wire, plan review, and the
+  pending-approvals push feed).
+- **Planned** — what is still in the shell: the registry user-plane hand-copies (they retire onto
+  `@sema-agent/sdk/registry`, not into this package); plus everything that is genuinely
+  host-specific — Ink rendering and keyboard interaction, the print lane's stream-json projector
+  and stderr triage copy, filesystem persistence, pty/terminal, and the signal-path teardown.
+  The web session view (first target consumer) and the desktop client (second) consume the same
+  package.
 
 ## Dependencies
 
@@ -131,7 +133,7 @@ grew the host context to carry what a non-Node host must supply:
   desktop host coalesces single-frame deltas at 16 ms; the 2.1.207 CLI line we track uses 100 ms),
   so the cadence is host render policy while the merge *semantics* stay here, in one place.
 
-0.6.0 – 0.9.0 (batches B4 – B7) completed the frame dispatch and moved in everything that is not
+0.6.0 – 0.10.0 (batches B4 – B8) completed the frame dispatch and moved in everything that is not
 host-specific. The blow-by-blow lives in the `src/index.ts` head comment (the source of truth); the
 short version:
 
@@ -157,6 +159,20 @@ short version:
   push channel over `approvals.stream()` that falls back to polling and periodically retries the
   push leg — it deliberately does **not** take over the D-1 fetch, which must stay authoritative.
 
+- **0.10.0** — the print lane (`-p`), the last batch on the migration bus. The request builder is
+  now the *only* construction point for both lanes: the shell's headless path used to assemble its
+  own `TaskRequest` literal, so the two lanes had silently drifted apart (`REQUEST_FIELD_MATRIX`
+  records every remaining difference field-by-field with its reason, plus a `gap` flag where the
+  difference is an omission rather than a decision). `unregisteredRequestKeys` makes that matrix
+  executable: the request that actually goes on the wire must account for every key it carries.
+  `request/printNotification` unifies the `task_notification` field set — the print exit now shares
+  the interactive lane's single judgement (`normalizeTaskNotification`) and carries the **residual
+  attribution** it used to drop (`stoppedBy`, `resumable`, `partial`, `exitCode`, `diagnostics`,
+  `result`, `lines`, `recentSteps`, `editedFiles`, `task_type`, `source`, `seq`, `injected`), which
+  matters most on the one lane with no human watching. Exactly one lane difference survives, and
+  it is CC's own: `status: killed` becomes `stopped` on the print exit. The stream-json projector
+  and the stderr triage copy deliberately stay in the shell.
+
 Known intentional deltas from the CLI are enumerated in `ADAPTER_DIVERGENCES`. The *compensation*
 ledger is a different table (`MIGRATED_COMPENSATIONS`): the entries there behave identically on
 both sides — what it records is why a compensation exists and when it can be deleted.
@@ -165,7 +181,7 @@ both sides — what it records is why a compensation exists and when it can be d
 
 ```bash
 npm install
-node scripts/run-client-core-pure-test.mjs         # 1030 consumer-view checks (22 + 140 + 208 + 59 + 101 + 96 + 241 + 163); no CLI tree needed
+node scripts/run-client-core-pure-test.mjs         # 1058 consumer-view checks (22 + 140 + 208 + 59 + 101 + 96 + 241 + 163 + 28); no CLI tree needed
 node scripts/run-client-core-portability-test.mjs  # 39 checks: kernel + A-layer + index closures, browser bundle
 node scripts/run-client-core-diff-test.mjs         # 1397 checks: differential + replay-id + ledger
 ```

package/dist/index.d.ts

@@ -5,6 +5,21 @@
  * 沿革:@sema-agent/wire-cc-adapter 0.1.0 = seam 类型 + id 确定性派生 + 首批踩坑纯函数;
  * 0.1.2(#52a)= adapt() 管线首批(纯投影臂全落 + 壳态耦合臂投影成 ChromeEvent + 差分守卫);
  * 0.2.0 = 迁入 sema-client-core 独立仓并改名(旧 npm 名 deprecate 指本包);
+ * 0.10.0 = **B8 批**(搬迁总线**末批**,设计稿 §8-5「print lane 收编」):
+ *   ① **请求拼装合一收官**:B4 建的 `buildTaskRequest(input, lane)` 从此是 print lane
+ *      (`seamQueryEngine.ask`)的**唯一**构造口 —— 壳里那份「`-p` 自己另拼一份」的字面量废除;
+ *      车道差异全在 `REQUEST_FIELD_MATRIX`(print 独有 finalVerification/limits/interactiveTools、
+ *      TUI 独有 ultracode 等,逐条带理由与 `gap` 判断)。新增可执行判据 `unregisteredRequestKeys`
+ *      —— **真上 wire 的那份**请求也要过表,再漏一个键就当场红(表以前只管得住构造器自己)。
+ *   ② **`task_notification` 字段集合一**(`request/printNotification.ts`):print 出口帧与交互面
+ *      共用 `normalizeTaskNotification` 这**一把闸**(空 task_id 丢帧 / summary 兜底 / status 回落),
+ *      并补上**残局归因**(stoppedBy / resumable / partial / exitCode / diagnostics / result /
+ *      lines / recentSteps / editedFiles / task_type / source / seq / injected)—— 修前这些位在
+ *      `-p` 出口整段丢失,而 `-p` 恰恰是唯一没有人当场看着的车道。🔴 车道差异只剩 `status` 的
+ *      killed⇒stopped 一条(CC 187 print 出口形,表里留注);去重键不出第二个名字,print 侧那份
+ *      手写算法废除,直接用 `taskNotificationDedupKeyFromWire`。
+ *   ③ **留壳**(§8-5 明写,本批一行没动):`PrintStreamProjector`(stream-json 帧序/SSE 重铸)与
+ *      全部 stderr 分诊文案 —— 渲染面与人话面属端。
  * 0.9.0 = **B7 批**(设计稿 §3 B7「完成事件单一权威 + HITL」):
  *   ① **HITL 族四件**(新目录 `hitl/`):`hitlBridge`(整搬,🔴 **D-1 两元组 verbatim 回显**
  *      与「409 绝不自动重试」两段**逐字节**搬,pure 门 B7 段用冻结字面量 + 壳树双向对拍 +
@@ -200,3 +215,4 @@ export * from './hitl/askGateWire.js';
 export * from './hitl/planReviewWire.js';
 export * from './hitl/approvalsFeed.js';
 export * from './compensations.js';
+export * from './request/printNotification.js';

package/dist/index.js

@@ -5,6 +5,21 @@
  * 沿革:@sema-agent/wire-cc-adapter 0.1.0 = seam 类型 + id 确定性派生 + 首批踩坑纯函数;
  * 0.1.2(#52a)= adapt() 管线首批(纯投影臂全落 + 壳态耦合臂投影成 ChromeEvent + 差分守卫);
  * 0.2.0 = 迁入 sema-client-core 独立仓并改名(旧 npm 名 deprecate 指本包);
+ * 0.10.0 = **B8 批**(搬迁总线**末批**,设计稿 §8-5「print lane 收编」):
+ *   ① **请求拼装合一收官**:B4 建的 `buildTaskRequest(input, lane)` 从此是 print lane
+ *      (`seamQueryEngine.ask`)的**唯一**构造口 —— 壳里那份「`-p` 自己另拼一份」的字面量废除;
+ *      车道差异全在 `REQUEST_FIELD_MATRIX`(print 独有 finalVerification/limits/interactiveTools、
+ *      TUI 独有 ultracode 等,逐条带理由与 `gap` 判断)。新增可执行判据 `unregisteredRequestKeys`
+ *      —— **真上 wire 的那份**请求也要过表,再漏一个键就当场红(表以前只管得住构造器自己)。
+ *   ② **`task_notification` 字段集合一**(`request/printNotification.ts`):print 出口帧与交互面
+ *      共用 `normalizeTaskNotification` 这**一把闸**(空 task_id 丢帧 / summary 兜底 / status 回落),
+ *      并补上**残局归因**(stoppedBy / resumable / partial / exitCode / diagnostics / result /
+ *      lines / recentSteps / editedFiles / task_type / source / seq / injected)—— 修前这些位在
+ *      `-p` 出口整段丢失,而 `-p` 恰恰是唯一没有人当场看着的车道。🔴 车道差异只剩 `status` 的
+ *      killed⇒stopped 一条(CC 187 print 出口形,表里留注);去重键不出第二个名字,print 侧那份
+ *      手写算法废除,直接用 `taskNotificationDedupKeyFromWire`。
+ *   ③ **留壳**(§8-5 明写,本批一行没动):`PrintStreamProjector`(stream-json 帧序/SSE 重铸)与
+ *      全部 stderr 分诊文案 —— 渲染面与人话面属端。
  * 0.9.0 = **B7 批**(设计稿 §3 B7「完成事件单一权威 + HITL」):
  *   ① **HITL 族四件**(新目录 `hitl/`):`hitlBridge`(整搬,🔴 **D-1 两元组 verbatim 回显**
  *      与「409 绝不自动重试」两段**逐字节**搬,pure 门 B7 段用冻结字面量 + 壳树双向对拍 +
@@ -257,3 +272,10 @@ export * from './hitl/approvalsFeed.js';
 // 🔴 它**不是** `ADAPTER_DIVERGENCES`(那张表说的是 adapt 与 cli 行为不同的地方;本表里的东西
 //    两侧行为相同)。自检口 `compensationSplitViolations()` 恒应为空。
 export * from './compensations.js';
+// ── B8 批:print lane 收编(2026-07-27,设计稿 §8-5 裁决 —— 总线末批)──────────────────────────
+// `task_notification` 字段集合一:`-p` 的 SDK 出口帧从 6 位手写字面量换成与交互面**同一把闸**
+// (normalizeTaskNotification)+ 一张逐字段对照表;残局归因(stoppedBy/resumable/partial/
+// exitCode/…)从此不在 print 出口丢失。🔴 车道差异只剩 `status` 的 killed⇒stopped 一条(表里留注)。
+// 去重键**不出第二个名字**:print 侧那份手写算法废除,直接用 `taskNotificationDedupKeyFromWire`。
+// 请求面同批补上可执行判据 `unregisteredRequestKeys`(见 request/taskRequest.ts 文件末)。
+export * from './request/printNotification.js';

package/dist/request/printNotification.d.ts

@@ -0,0 +1,33 @@
+/** 帧身份位(壳侧从被投影的那条 SDK 消息上取,包内不铸号)。 */
+export interface PrintFrameIdentity {
+    uuid?: unknown;
+    session_id?: unknown;
+}
+/**
+ * print 出口帧的**逐字段对照表** —— 与 `REQUEST_FIELD_MATRIX` 同一纪律:
+ * `cc:true` = CC 自己命名过的位,**改名即偏离 parity**;`cc:false` = 本次收编补上的归因位
+ * (wire 原名 = SDK `AgentEvent.task_notification` 词汇)。`from` 写明它从 wire 的哪一位来。
+ */
+export interface PrintNotificationFieldSpec {
+    /** print 出口帧上的键名。 */
+    field: string;
+    /** wire 侧来源键(`—` = 信封位/由归一层派生)。 */
+    from: string;
+    /** CC 逐字位(改名即偏离 parity)。 */
+    cc: boolean;
+    why: string;
+}
+export declare const PRINT_NOTIFICATION_FIELD_MATRIX: readonly PrintNotificationFieldSpec[];
+/**
+ * 引擎 `task_notification` 帧载荷 → CC `system/task_notification` 出口帧(print lane 唯一构造口)。
+ *
+ * 判定全部委托 `normalizeTaskNotification`(交互面同一把闸);缺席位一律**不铸空键**
+ * (tolerate-absent —— 老引擎不发的字段不该在出口变成 `undefined` 值键)。
+ * 返回 `null` = 该帧不该出口(task_id 空/缺)。
+ */
+export declare function taskNotificationToPrintFrame(n: Record<string, unknown>, identity?: PrintFrameIdentity): Record<string, unknown> | null;
+/**
+ * 出口帧里出现了**没进上表**的键就点名它(与 `unregisteredRequestKeys` 同纪律):
+ * 顺手加一位很容易,加了之后「字段集合一」就又退化成一句注释 —— 加位必须先改表(带理由)。
+ */
+export declare function unregisteredPrintNotificationKeys(frame: Record<string, unknown>): string[];

package/dist/request/printNotification.js

@@ -0,0 +1,116 @@
+/**
+ * request/printNotification.ts — **`task_notification` 字段集合一**(B8,多端改造设计稿 §8-5 裁决
+ * 第二件;§2.5 拆缝表 `seamQueryEngine.ts:690-708` 那一格)。
+ *
+ * ## 它解决的是什么
+ *
+ * 同一条引擎 `task_notification` 帧,壳里有**两个**消费者,各自决定「哪些字段算数」:
+ *   · 交互 lane:`notifications.normalizeTaskNotification` → `renderTaskNotificationXml`
+ *     (模型面 XML + 转录面),字段集 = `TaskNotificationFields` 15 位;
+ *   · print lane(`-p` 的 SDK 出口):`seamQueryEngine.ask` 里**手写的一段对象字面量**,
+ *     只挑了 6 位(task_id / tool_use_id / status / output_file / summary / usage)。
+ *
+ * 后果是**残局归因在 `-p` 出口整段丢失**:引擎明明发了 `stoppedBy`(谁停的)/`resumable`
+ * (还能不能续)/`partial`(残果)/`exitCode` / `diagnostics` / `result` / `lines` /
+ * `recentSteps` / `editedFiles`,交互面 XML 里逐条都在,而**唯一没有人类当场看着的那条车道**
+ * ——集成/自动化用的 `-p --output-format stream-json`——拿不到任何归因位。
+ * (设计稿 §7.3(b) 记的是 fleet `bg_notification` lane 的同款不对称;print 出口这一处是
+ * B8 落码时逐行核出来的第二处,同族。)
+ *
+ * ## 合一的口径(逐字段留注 = `PRINT_NOTIFICATION_FIELD_MATRIX`)
+ *
+ * 🔴 **判据同源**:本模块**不重新判**任何一位 —— 先过交互面那把闸
+ * `normalizeTaskNotification`(空 task_id 丢帧 = RB-75 同族;summary 缺省兜底句;status 非串
+ * 回落 `completed`),再把归一结果映到 CC 的 print 帧信封上。两面从此只有**一份**判据。
+ *
+ * 🔴 **车道差异只剩一条**:`status` 的 `killed ⇒ stopped` 归一 —— 那是 CC 自己 print/SDK 出口的
+ * 形(FULL-SOURCE-187 line ~32320),XML 面按引擎原词渲染。这一条差异是**有理由的**,写在表里。
+ *
+ * **命名口径**:CC 已经命名过的 6 位保持 CC 逐字(`task_id` / `tool_use_id` / `output_file` /
+ * `status` / `summary` / `usage`);新增的归因位用 **wire 原名**(`stoppedBy` / `resumable` / …)
+ * —— 也就是 SDK `AgentEvent.task_notification` 的词汇表,`-p` 的 SDK 消费方与直连 SDK 的消费方
+ * 因此看到同一套键名,不必再学第三套。additive:老消费方按 key 取值,多出来的键不碍事。
+ *
+ * ## 留壳的部分(§8-5 明写)
+ *
+ * `PrintStreamProjector`(stream-json 帧序/SSE 重铸)与全部 stderr 分诊文案**留壳**:那是
+ * 渲染面与人话面,不是数据面。本模块只做「wire 帧 → CC 帧」这一跳。
+ */
+import { normalizeTaskNotification } from '../notifications.js';
+export const PRINT_NOTIFICATION_FIELD_MATRIX = [
+    // ── 信封(CC system 帧形)────────────────────────────────────────────────────────────────────
+    { field: 'type', from: '—', cc: true, why: "CC system 帧信封:{type:'system'}" },
+    { field: 'subtype', from: '—', cc: true, why: "CC 完成通知的 subtype:'task_notification'(187 print/SDK 出口形)" },
+    { field: 'uuid', from: '—', cc: true, why: '帧身份:壳侧从被投影的 SDK 消息取(包内不铸号)' },
+    { field: 'session_id', from: '—', cc: true, why: 'CC 每帧带会话 id;壳侧透传' },
+    // ── CC 已命名的 6 位(逐字,改名即偏离 parity)──────────────────────────────────────────────
+    { field: 'task_id', from: 'task_id', cc: true, why: 'CC 逐字 snake 名;空/缺 ⇒ 整帧丢弃(RB-75:空 id 会塌成共享桶互吞)' },
+    { field: 'status', from: 'status', cc: true, why: "CC 逐字;**唯一车道差异** killed ⇒ stopped(187 print 出口形;XML 面按引擎原词渲染)" },
+    { field: 'summary', from: 'summary', cc: true, why: '缺省走交互面同一句兜底(`Background task "<id>" <status>`)—— 修前 print 出口发空串' },
+    { field: 'tool_use_id', from: 'toolUseId', cc: true, why: 'CC 逐字 snake 名(wire 是 camel);把通知钉回发起它的那次工具调用' },
+    { field: 'output_file', from: 'output_file', cc: true, why: 'CC 逐字;后台输出落盘路径' },
+    { field: 'usage', from: 'usage', cc: true, why: 'CC 逐字 optional;计量面(交互面 XML 反而不读它 —— 那是渲染面口径)' },
+    // ── B8 补上的残局归因位(wire 原名 = SDK task_notification 词汇)────────────────────────────
+    { field: 'stoppedBy', from: 'stoppedBy', cc: false, why: '🔴 残局归因核心位:谁停的(用户/上限/引擎)。修前 `-p` 出口零携带' },
+    { field: 'resumable', from: 'resumable', cc: false, why: '🔴 残局归因:还能不能 resume —— 自动化要靠它决定重试还是放弃' },
+    { field: 'partial', from: 'partial', cc: false, why: 'server 1.258:被终止子代的残果(消费方须渲成不完整,不得当完整结果)' },
+    { field: 'exitCode', from: 'exitCode', cc: false, why: '后台 bash 退出码(137=OOM 这类归因只在这一位上)' },
+    { field: 'diagnostics', from: 'diagnostics', cc: false, why: '引擎侧诊断串(UNTRUSTED,service 已 redact)' },
+    { field: 'result', from: 'result', cc: false, why: '完成结果正文(#49 C1:帧带 result 必入 XML,print 出口同理不得独漏)' },
+    { field: 'lines', from: 'lines', cc: false, why: '尾部输出行(UNTRUSTED);交互面折进 <output-lines>' },
+    { field: 'recentSteps', from: 'recentSteps', cc: false, why: '结构化残局步骤 {tool,target,outcome}[] —— **原样透传**,不降级成交互面那份显示串(SDK 消费方要结构)' },
+    { field: 'editedFiles', from: 'editedFiles', cc: false, why: '结构化改档清单 {path,edits}[];同上原样透传' },
+    { field: 'task_type', from: 'task_type', cc: false, why: 'lane 位(external/background_agent/…)—— 去重键的分域依据,消费方要能自己算同一把键' },
+    { field: 'source', from: 'source', cc: false, why: 'external lane 的来源标识(交互面渲成开标签 from= 属性)' },
+    { field: 'seq', from: 'seq', cc: false, why: '停机周期/批次计数([508]②)—— 与 task_id+status 一起构成去重键' },
+    { field: 'injected', from: 'injected', cc: false, why: '[1818]§四:本帧**不**证明 XML 已进模型上下文;消费方须按此位判,不得按帧到达判' },
+];
+const PRINT_FRAME_KEYS = new Set(PRINT_NOTIFICATION_FIELD_MATRIX.map(r => r.field));
+/**
+ * 引擎 `task_notification` 帧载荷 → CC `system/task_notification` 出口帧(print lane 唯一构造口)。
+ *
+ * 判定全部委托 `normalizeTaskNotification`(交互面同一把闸);缺席位一律**不铸空键**
+ * (tolerate-absent —— 老引擎不发的字段不该在出口变成 `undefined` 值键)。
+ * 返回 `null` = 该帧不该出口(task_id 空/缺)。
+ */
+export function taskNotificationToPrintFrame(n, identity = {}) {
+    const f = normalizeTaskNotification(n);
+    if (f === null)
+        return null;
+    const structured = (key) => Array.isArray(n[key]) && n[key].length > 0 ? { [key]: n[key] } : {};
+    return {
+        type: 'system',
+        subtype: 'task_notification',
+        task_id: f.taskId,
+        // CC 逐字:killed ⇒ stopped(唯一车道差异,表里有理由)。
+        status: f.status === 'killed' ? 'stopped' : f.status,
+        summary: f.summary,
+        ...(f.toolUseId !== undefined ? { tool_use_id: f.toolUseId } : {}),
+        ...(f.outputFile !== undefined ? { output_file: f.outputFile } : {}),
+        ...(n.usage !== undefined ? { usage: n.usage } : {}),
+        // ── 残局归因(B8 补;归一层已做过类型与空值判定)──────────────────────────────────────
+        ...(f.stoppedBy !== undefined ? { stoppedBy: f.stoppedBy } : {}),
+        ...(f.resumable !== undefined ? { resumable: f.resumable } : {}),
+        ...(f.partial !== undefined ? { partial: f.partial } : {}),
+        ...(f.exitCode !== undefined ? { exitCode: f.exitCode } : {}),
+        ...(f.diagnostics !== undefined ? { diagnostics: f.diagnostics } : {}),
+        ...(f.result !== undefined ? { result: f.result } : {}),
+        ...(f.lines !== undefined ? { lines: f.lines } : {}),
+        // 结构化两位取**裸 wire**(归一层把 recentSteps 折成了交互面的显示串,那是渲染口径)。
+        ...structured('recentSteps'),
+        ...structured('editedFiles'),
+        ...(f.taskType !== undefined ? { task_type: f.taskType } : {}),
+        ...(f.externalSource !== undefined ? { source: f.externalSource } : {}),
+        ...(typeof n.seq === 'number' || typeof n.seq === 'string' ? { seq: n.seq } : {}),
+        ...(typeof n.injected === 'boolean' ? { injected: n.injected } : {}),
+        ...(identity.uuid !== undefined ? { uuid: identity.uuid } : {}),
+        ...(identity.session_id !== undefined ? { session_id: identity.session_id } : {}),
+    };
+}
+/**
+ * 出口帧里出现了**没进上表**的键就点名它(与 `unregisteredRequestKeys` 同纪律):
+ * 顺手加一位很容易,加了之后「字段集合一」就又退化成一句注释 —— 加位必须先改表(带理由)。
+ */
+export function unregisteredPrintNotificationKeys(frame) {
+    return Object.keys(frame).filter(k => !PRINT_FRAME_KEYS.has(k));
+}

package/dist/request/taskRequest.d.ts

@@ -133,3 +133,20 @@ export interface LiveDefaultsInput {
 export declare function applyLiveRequestDefaults(req: TaskRequestLike, host: LiveDefaultsInput): TaskRequestLike;
 /** 出口约束:构造结果确实是一个 `TaskRequest`(型只在这里碰 SDK,运行时零依赖)。 */
 export type BuiltTaskRequest = TaskRequest;
+/**
+ * ⇄ B8(§8-5 请求拼装合一的**可执行判据**)—— 一份请求体里出现了**没进车道表**的键就点名它。
+ *
+ * 为什么要有:B4 把字段集做成了 `REQUEST_FIELD_MATRIX` 这张表,但表当时只管住了
+ * `buildTaskRequest` 自己;端上真正上 wire 的那份请求仍可以在构造器之外多塞一个键(print lane
+ * 修前正是「自己另拼一份」),于是「表说了算」就退化成一句注释。本函数让**真上 wire 的那份**
+ * 也过一遍表:print lane 收编之后,`-p` 的请求体逐键都能报出登记出处,再漏就当场红。
+ *
+ * 判据口径(三类不点名):
+ *   ① 车道表里的字段(`lanes` 含本车道);② `LIVE_DEFAULT_FIELDS` —— live 兜底层追加、两条车道
+ *   都经过,故本就不进车道表;③ `settings` 的子键按表认(`settings.<sub>`),但**交互车道**的
+ *   `settings.<resolved>` 是 resolver 的 effective 快照 = **开放集**,子键不可枚举 ⇒ 整体放行。
+ *
+ * 🔴 它**不判**「该不该有」——只判「有没有登记」。补齐一条真实差异要改表(带理由),
+ * 而不是绕过本函数:改表这个动作本身就会在 diff 里显形,这正是本判据存在的意义。
+ */
+export declare function unregisteredRequestKeys(req: TaskRequestLike, lane: RequestLane): string[];

package/dist/request/taskRequest.js

@@ -17,7 +17,10 @@ export const REQUEST_FIELD_MATRIX = [
     { field: 'promptProfile', lanes: ['interactive', 'print'], live: true, why: 'core 1.328 呈现轴 A/B 口,缺省不 stamp = 引擎缺省 simple' },
     { field: 'enableFork', lanes: ['interactive', 'print'], live: true, why: '显式布尔才 stamp([503]② fail-OPEN 教训:off 必须显式)' },
     { field: 'attachments', lanes: ['interactive', 'print'], live: true, why: 'design/133 + G1 缺省开的 turn 边界 attachment' },
-    { field: 'skills', lanes: ['interactive', 'print'], live: true, why: '本地 .claude/skills 投影;两条车道都由 launchRepl 载入面注入' },
+    // ⚠️ 这条 why 原文写的是本地技能目录的**字面路径**,B8 把本模块拉进壳的生产闭包之后,那串
+    //    字面量随 bundle 进了 `dist/sema.js` 并被壳的品牌门当场逮住(壳的 R11 codemod 只走自己
+    //    的 src,走不到 node_modules ⇒ 包里的 CC 路径字面 = 品牌面泄漏)。见本文件末的包内纪律。
+    { field: 'skills', lanes: ['interactive', 'print'], live: true, why: '本地技能目录投影(布局取 CC 同款);两条车道都由 launchRepl 载入面注入' },
     { field: 'mcpServers', lanes: ['interactive', 'print'], live: true, why: '本地 .mcp.json 投影;service 单用户门决定是否兑现' },
     { field: 'settings.webSearch', lanes: ['interactive', 'print'], live: true, why: 'SEMA_WEBSEARCH_* / settings.json;per-request 配置赢过部署 env' },
     { field: 'settings.hooks', lanes: ['interactive', 'print'], live: true, why: '[495]① 用户 settings 文件 hooks 逐字上 wire' },
@@ -174,3 +177,56 @@ export function applyLiveRequestDefaults(req, host) {
     }
     return out;
 }
+/**
+ * ⇄ B8(§8-5 请求拼装合一的**可执行判据**)—— 一份请求体里出现了**没进车道表**的键就点名它。
+ *
+ * 为什么要有:B4 把字段集做成了 `REQUEST_FIELD_MATRIX` 这张表,但表当时只管住了
+ * `buildTaskRequest` 自己;端上真正上 wire 的那份请求仍可以在构造器之外多塞一个键(print lane
+ * 修前正是「自己另拼一份」),于是「表说了算」就退化成一句注释。本函数让**真上 wire 的那份**
+ * 也过一遍表:print lane 收编之后,`-p` 的请求体逐键都能报出登记出处,再漏就当场红。
+ *
+ * 判据口径(三类不点名):
+ *   ① 车道表里的字段(`lanes` 含本车道);② `LIVE_DEFAULT_FIELDS` —— live 兜底层追加、两条车道
+ *   都经过,故本就不进车道表;③ `settings` 的子键按表认(`settings.<sub>`),但**交互车道**的
+ *   `settings.<resolved>` 是 resolver 的 effective 快照 = **开放集**,子键不可枚举 ⇒ 整体放行。
+ *
+ * 🔴 它**不判**「该不该有」——只判「有没有登记」。补齐一条真实差异要改表(带理由),
+ * 而不是绕过本函数:改表这个动作本身就会在 diff 里显形,这正是本判据存在的意义。
+ */
+export function unregisteredRequestKeys(req, lane) {
+    /** live 兜底层的键名(表项写法含 `|` 备选位与括号说明,取裸键名)。 */
+    const liveDefaults = new Set(LIVE_DEFAULT_FIELDS.flatMap(row => row.split('|')).map(name => name.replace(/\(.*\)$/, '').trim()));
+    const laneRows = REQUEST_FIELD_MATRIX.filter(f => f.lanes.includes(lane));
+    /** 顶层键 → 表项(`resumeAt/rewindFiles/rewindFilesTo` 这类斜杠合写项逐键展开)。 */
+    const laneTopKeys = new Set();
+    for (const row of laneRows) {
+        if (row.field.startsWith('settings.'))
+            continue;
+        for (const key of row.field.split('/'))
+            laneTopKeys.add(key);
+    }
+    const laneSettingsKeys = new Set(laneRows
+        .filter(f => f.field.startsWith('settings.') && f.field !== 'settings.<resolved>')
+        .map(f => f.field.slice('settings.'.length)));
+    const settingsIsOpenSet = laneRows.some(f => f.field === 'settings.<resolved>');
+    const out = [];
+    for (const key of Object.keys(req)) {
+        if (key === 'settings') {
+            if (settingsIsOpenSet)
+                continue;
+            const settings = req.settings;
+            if (settings === null || typeof settings !== 'object')
+                continue;
+            for (const sub of Object.keys(settings)) {
+                if (laneSettingsKeys.has(sub) || liveDefaults.has(`settings.${sub}`))
+                    continue;
+                out.push(`settings.${sub}`);
+            }
+            continue;
+        }
+        if (laneTopKeys.has(key) || liveDefaults.has(key))
+            continue;
+        out.push(key);
+    }
+    return out;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sema-agent/client-core",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "Client-side session runtime shared by every sema human client (TUI / web / desktop): sema wire frames (AgentEvent) -> CC session vocabulary (SDKMessage) with dual-plane output (transcript/chrome), deterministic transcript ids, lane discipline as a type, and the notification/dedup ledgers. Every CC-skin shape is collected here so the wire itself stays neutral. Blackboard [1832] design axioms; [1651]/[1652]/[1653] signed seam design. Renamed from @sema-agent/wire-cc-adapter (0.1.x).",
   "license": "MIT",
   "type": "module",