@sema-agent/client-core 0.77.1 → 0.78.0

package/dist/workflowMonitor.d.ts

@@ -1,27 +1,6 @@
-/**
- * ⇄ B6 批搬迁(2026-07-27,设计稿 §3 B6):workflow 监视器的**状态契约**(MF-W ·
- *    contract/MF-W-workflow-monitor.md)从 cli `src/sema/overrides/workflow-detail-dialog.tsx:118-200`
- *    搬入 —— 逐字,一个字段都没动。
- *
- * 🔴 **为什么类型必须先过来**:`workflowClient.projectWorkflowRun()`(同批搬入)的**产物**就是这套
- *    形状。类型留在一个 `.tsx` 渲染文件里,等于「库产出的东西,它的契约住在 TUI 里」——
- *    web/桌面要消费同一份投影就得手抄一遍 shape,而手抄的那份**没有任何东西**会在它漂移时报红。
- *    定位公理([1832])说的「CC 皮肤形状全收本包」,指的正是这种东西。
- *
- * 🔴 **拆缝**:`workflow-detail-dialog.tsx` 本身是 Ink 渲染件(设计稿 §2 分类表「Ink 渲染」),
- *    **留 TUI**;搬过来的只有 ① 六个契约类型 ② `agentDisplayStatus`(WPe —— 从 wire 输入词表
- *    派生显示态的那条**纯**规则,是本契约的消费侧半场,端端都要用)。
- *    留在 TUI 的:`computeVisibleWindow`(滚动窗口数学 = 视口概念,端专属)、glyph/color 映射、
- *    以及整棵 JSX。壳侧 shim = 那个 tsx 改成从本包 re-export 这两样,自己不再定义。
- */
 import type { WorkflowParkRowView } from './workflowClient.js';
-export type AgentState = 'start' | 'progress' | 'queued' | 'done' | 'error' | 'inactive'
-/** sema 超集:这条腿耐久挂在一张审批卡上(engine core 7.10.0 #642)。见上方头注。 */
- | 'parked';
-export type DisplayStatus = 'queued' | 'running' | 'done' | 'failed' | 'skipped' | 'interrupted'
-/** sema 超集:同上。🔴 端的 glyph/颜色映射是**穷尽形**,加这一词就必须同批加一条 case
- *  (措辞按「waiting for approval」一类,别复用 running 的字与色)。 */
- | 'parked';
+export type AgentState = 'start' | 'progress' | 'queued' | 'done' | 'error' | 'inactive' | 'parked';
+export type DisplayStatus = 'queued' | 'running' | 'done' | 'failed' | 'skipped' | 'interrupted' | 'parked';
 export interface WorkflowToolCall {
     name: string;
     summary?: string;
@@ -36,40 +15,26 @@ export interface WorkflowAgent {
     remoteSessionId?: string;
     cached?: boolean;
     state: AgentState;
-    /** WPe maps state→display; `skipped` distinguishes an error that was a user-skip. */
     skipped?: boolean;
     tokens?: number;
     toolCalls?: number;
     durationMs?: number;
     queuedAt?: number;
     startedAt?: number;
-    /** ofm/C0l: `idle <t>` when running and lastProgressAt is ≥30s ago. (contract: idleSince) */
     lastProgressAt?: number;
     attempt?: number;
     lastAttemptReason?: 'throttled' | 'user-retry' | 'stalled';
     error?: string;
     agentId?: string;
-    /**
-     * #242 批 1(A-028.8):`ctx.agent` 调用的**稳定确定性身份**(resume-journal key,
-     * SDK `WorkflowAgentRow.callKey`)。运行期 activity 台账的 SSE 帧(`agent_activity`)以它为键,
-     * 而此前投影把它丢了 —— 于是 label 成了合并层唯一的钥匙,同名 agent 只能整组跳过。
-     * 投影带出它之后,重名 label 也能精确归属;缺席(老引擎/老 run)时才回落到 label。
-     */
     callKey?: string;
-    /** detail "Prompt" body; promptPreview is the fallback when no transcript is loaded. */
     promptPreview?: string;
-    /** detail "Activity" rows. */
     activity?: WorkflowToolCall[];
     lastToolName?: string;
     lastToolSummary?: string;
-    /** detail "Outcome" body for done agents (the StructuredOutput JSON / final text). */
     resultPreview?: string;
 }
 export interface WorkflowPhase {
     title: string;
-    /** 🔴 `parked` = 这一格里没有一条腿能自己往前走(全员不是完成就是停在审批门上)。见 `AgentState`
-     *  的同名头注;上游今天不给 phase 铸这个词(core:「a phase or group never parks」),本包这一位有两个
-     *  来路:①上游哪天真铸了 ⇒ 原词透出而不是折成 running;②本包从桶里的腿**推**出来。 */
     status: 'not-started' | 'running' | 'done' | 'failed' | 'parked' | 'unknown';
     doneCount: number;
     totalCount: number;
@@ -82,48 +47,13 @@ export interface WorkflowRunState {
     summary?: string;
     script: string;
     scriptPath?: string;
-    /** 🔴 `parked`(0.63.1,additive):**前向预挂** —— engine core 7.10.0 的 run 级词表仍闭在
-     *  running|completed|failed(一条腿 park ⇒ 整只 run 按 `WorkflowAgentParkedError` 收在 `failed`),
-     *  所以今天没有任何受支持的引擎在这一位上发 `parked`。留这条臂是为了「词真到了就原样透出」,
-     *  绝不是说它现在会到 —— 判「这条 run 停着等人批」今天要看**腿**那一级(见 `AgentState.parked`)。 */
-    /** 0.72.12 CC-51:`unknown`(additive)= wire 上认不出的 run 状态词;绝不再折成 running(端要渲原串请读 wire `run.status`)。 */
     status: 'running' | 'done' | 'failed' | 'stopped' | 'paused' | 'parked' | 'unknown';
     cloud?: boolean;
     agentCount: number;
-    /** 🔴 0.73.0(BREAKING):可选。有键 ⇒ 总用量(含真 0);缺键 ⇒ 没有权威总数且有腿未报(或零条腿)—— 渲「—」,不渲 0。 */
     totalTokens?: number;
-    /** phases as authored; the component derives the active/clamped windows itself. */
     phases: WorkflowPhase[];
-    /**
-     * CC-12(0.69.1;core 7.18.0 #755 / server ≥7.78.0):这条 run **负责**的 park 行(自己的 + 从被 resume 的 run 继承的),
-     * 由 `readWorkflowParks` 铸(三键行 + never-false 第四键 `originUnconfirmed`)。🔴 缺席两义(与读器同):整键缺席 =
-     * 旧引擎记录 / 读不出(证不出有没有 park);`[]` = 本引擎记录且一个 park 都没有。端渲 resume 候选时按这一位,
-     * 不再各自 `run.parks.map(...)`(修前本视图丢了它,端结构性造不出 —— cli 接入回执 ④)。
-     */
     parks?: readonly WorkflowParkRowView[];
-    /** CC-12:在场 = 这条 resume run 的准入没完成 = **不是 resume 基**(core 逐字);缺席 = 常态。never false。 */
     resumeAdmissionIncomplete?: true;
-    /** the 187 reads e.workflowProgress to recompute phases; the mock pre-builds them. */
     workflowProgress?: unknown;
 }
-/**
- * WPe — agentDisplayStatus: agent.state (+ workflowActive) → display status.
- *
- * FAITHFUL to the atlas state SET (atlas 0476_076:30-34). The atlas `WPe` reads ONLY these inputs:
- *   if(state==="done") → "done"
- *   if(state==="error") → skipped?"skipped":"failed"
- *   if(!workflowActive) → "interrupted"          // the inactive/non-active fallback
- *   else → (queuedAt!=null && startedAt==null) ? "queued" : "running"
- * The atlas runner's agent-state enum the monitor sees is {start, progress, queued, done, error,
- * inactive} — there is NO `failed`/`skipped`/`interrupted`/`stopped`/`running` INPUT state; those are
- * DISPLAY statuses derived here: `failed`/`skipped` from `error` (+ the `skipped` flag), `interrupted` from
- * `!workflowActive` (the `inactive`/non-active fallback), and `queued`/`running` from the queuedAt/startedAt
- * fields on the active path. The AgentState type carries exactly this input set, so the type contract now
- * matches the atlas vocabulary 1:1 — the branches below consume only atlas input states and the output
- * DisplayStatus set + glyph/color mapping ($jn) is identical.
- *
- * 🔴 **`parked` 是这条规则上唯一的 sema 超集臂**(0.63.1):atlas 没有它,因为 CC 的编排里没有耐久
- * 审批这一层。它**不派生**——上游直接铸这个词(engine core 7.10.0 #642 的 agent 行 `status` 与
- * `deriveAgentDisplayStatus` 产物),这里只是不许把它折掉。臂的**位置**是承重的,理由写在分支处。
- */
 export declare function agentDisplayStatus(a: WorkflowAgent, workflowActive: boolean): DisplayStatus;

package/dist/workflowMonitor.js

@@ -1,36 +1,10 @@
-/**
- * WPe — agentDisplayStatus: agent.state (+ workflowActive) → display status.
- *
- * FAITHFUL to the atlas state SET (atlas 0476_076:30-34). The atlas `WPe` reads ONLY these inputs:
- *   if(state==="done") → "done"
- *   if(state==="error") → skipped?"skipped":"failed"
- *   if(!workflowActive) → "interrupted"          // the inactive/non-active fallback
- *   else → (queuedAt!=null && startedAt==null) ? "queued" : "running"
- * The atlas runner's agent-state enum the monitor sees is {start, progress, queued, done, error,
- * inactive} — there is NO `failed`/`skipped`/`interrupted`/`stopped`/`running` INPUT state; those are
- * DISPLAY statuses derived here: `failed`/`skipped` from `error` (+ the `skipped` flag), `interrupted` from
- * `!workflowActive` (the `inactive`/non-active fallback), and `queued`/`running` from the queuedAt/startedAt
- * fields on the active path. The AgentState type carries exactly this input set, so the type contract now
- * matches the atlas vocabulary 1:1 — the branches below consume only atlas input states and the output
- * DisplayStatus set + glyph/color mapping ($jn) is identical.
- *
- * 🔴 **`parked` 是这条规则上唯一的 sema 超集臂**(0.63.1):atlas 没有它,因为 CC 的编排里没有耐久
- * 审批这一层。它**不派生**——上游直接铸这个词(engine core 7.10.0 #642 的 agent 行 `status` 与
- * `deriveAgentDisplayStatus` 产物),这里只是不许把它折掉。臂的**位置**是承重的,理由写在分支处。
- */
 export function agentDisplayStatus(a, workflowActive) {
     if (a.state === 'done')
         return 'done';
-    // atlas: `state==="error"` → skipped?"skipped":"failed".
     if (a.state === 'error')
         return a.skipped ? 'skipped' : 'failed';
-    // 🔴 sema 超集臂,**位置承重**:必须在 `!workflowActive` 之前判。一条腿 park 之后 run 自己收在
-    //    `failed`(core `WorkflowAgentParkedError`)⇒ `workflowActive` 恒假 ⇒ 放到后面就永远被
-    //    `interrupted` 吃掉,而 interrupted 说的是「run 结束时它还没跑完」——那是一件**已经过去**的事,
-    //    parked 说的是「它还挂在那儿,等一个人做决定」,是一件**还能动手**的事。两句下一步不同。
     if (a.state === 'parked')
         return 'parked';
-    // atlas `!t` (workflow not active) → interrupted (also the `inactive`-state landing).
     if (!workflowActive)
         return 'interrupted';
     return a.queuedAt != null && a.startedAt == null ? 'queued' : 'running';

package/dist/writeProtectionCapability.d.ts

@@ -1,44 +1,8 @@
-/**
- * writeProtectionCapability — **写保护名表**姿态的三端共用读面(0.60.0)。
- *
- * 引擎带一张**字面名表**,落在表行上的可定路径写(Write / Edit / NotebookEdit)从 `allow` 降级成
- * `ask` —— 所以端可以**事先**告诉人「这些路径会弹卡」。两个读面同源同一份 boot 产物:
- *   · **租户面** `GET /v1/capabilities` 的 `writeProtection`(engine ≥7.63.0 / S-138;sdk 8.4.0
- *     `Capabilities.writeProtection`)—— 只有三位计数/开关,**不含行内容**;
- *   · **operator 面** `GET /v1/diagnostics/wiring` 的 `writeProtection` —— 多出**行内容**与来源词。
- *
- * ── 🔴 四态,不是两态([honest-absence-not-fabricated-zero])──────────────────────────────────
- * 与 `sqlEngineCapability` 逐字同一套词汇(通用读口答「这一格上有没有值」,窄读器答「值成不成形」):
- *   ① `unobserved`   —— **本进程一次 caps 响应都没观测到**(一次性 doctor 就是这一档)。
- *   ② `not_reported` —— caps 观测到了,而回体上**没有**这个键 ⇒ 老引擎(<7.63.0)。
- *      🔴 它**不是**「这台部署没有写保护表」—— 恰恰相反:引擎侧**座位缺席时缺省表在岗**
- *         (按键名 grep 推断「没装」会推错,上游把这一条写进了本位的顶注)。
- *   ③ `none`         —— 引擎**明确说** `null`:这个进程说不出来(非 composition root 装配的夹具形)。
- *      同样**不是**「没有表」。
- *   ④ `present`      —— 三位俱全,原样渲。
- *
- * ── 🔴 三位刻意不合成一个布尔(上游顶注逐字)────────────────────────────────────────────────
- * `armed`(生效表非空 ⇒ 真会弹卡)/ `rows`(生效表行数)/ `replaced`(整表替换旋钮被写过)——
- * 合成之后「引擎缺省表在岗」与「运维换了一张自己的表」同为 true,而两者对运维说的是两件事。
- * ⚠️ `replaced` 把「整表替换成**空**表」也算 true:报 false 会把「运维亲手关掉了表」说成
- * 「缺省表没被动过」。
- *
- * ── 🔴 最小披露:逐行 name/kind 不上租户面 ──────────────────────────────────────────────────
- * 部署自定义行可能含内部路径名,列出来等于告诉想绕过的人「哪些名字不受保护」。行内容只在
- * operator 面({@link projectWriteProtectionPosture}),而那个端点本身是 operator-gated。
- * 🔴 与**模式型** write deny(`SENSITIVE_WRITE_PATTERNS`)是**并列机制**,两个读面分开报、
- * 绝不合成一位:两者的解法不同(一套改模式,一套改名表)。
- */
-/** 租户面三位(server `WriteProtectionCapability` 逐字同形)。 */
 export interface WriteProtectionCapabilityView {
-    /** 生效表非空 ⇒ 引擎真会对表行弹卡。 */
     armed: boolean;
-    /** 生效表的**行数**(内容只上 operator 面)。 */
     rows: number;
-    /** 整表替换旋钮被写过 ⇒ 缺省表不再原样在岗。与 {@link armed} 刻意不合成。 */
     replaced: boolean;
 }
-/** 四态读数(见文件头)。`unobserved` 由**读口**在这一格空缺时铸,不由投影铸。 */
 export type WriteProtectionReading = {
     kind: 'unobserved';
 } | {
@@ -49,98 +13,22 @@ export type WriteProtectionReading = {
     kind: 'present';
     view: WriteProtectionCapabilityView;
 };
-/**
- * caps 回体 → 本格读数;**畸形一律 `undefined`**(= 这一格不写 ⇒ 读口答 `unobserved`)。
- *
- * 🔴 `undefined`(键不在)与 `null`(引擎说不出来)**是两件事**:前者 ⇒ `not_reported`(老引擎),
- *    后者 ⇒ `none`(夹具形进程)。用 `??` / falsy 判会把两者压成一件。
- * 🔴 三位**任一**形不合 ⇒ 整条判畸形。绝不留一个缺位的对象:一行写着「rows: 」的诊断比不渲这一行
- *    更坏(它看起来像一个答案)。
- * ⚠️ `rows` 按**非负有限整数**判,不按真值判:`0` 是合法读数(表在、但生效行为零),折成缺席会让
- *    「表空了」与「没报」在消费端同形。
- */
 export declare function projectWriteProtectionCapability(caps: unknown): WriteProtectionReading | undefined;
-/** operator 面的一行:一个**字面**名字 + 它怎么匹配。`name` 同时是这一行的稳定身份。 */
 export interface WriteProtectedRowView {
     name: string;
-    /** `basename`(目标最后一段)/ `segment`(任意一段)/ `segment-run`(连续若干段);**开集读**。 */
     kind: string;
 }
-/** operator 面读数(`GET /v1/diagnostics/wiring` 的 `writeProtection`)。 */
 export interface WriteProtectionPostureView {
-    /** 生效表逐行,逐字来自引擎自己的编译产物。**空数组 = 显式无表**(不是缺席)。 */
     rows: readonly WriteProtectedRowView[];
-    /** `default`(两根旋钮都没写)/ `extra`(缺省表 + 增量)/ `replace`(整表替换)/ `off`
-     *  (整表替换成空表,合法且响亮);**开集读**。 */
     source: string;
-    /** 整表替换**丢掉**的缺省行名;只在替换族在场。 */
     droppedDefaultRows?: readonly string[];
 }
-/**
- * operator 面回体的 `writeProtection` 段 → 读数;不成形 ⇒ `undefined`。
- *
- * 🔴 **空 `rows` 数组是正面事实**(「显式无表」),照铸 `[]` —— 与 `wiring_manifest.mcp[]` 同一条
- *    已定谳的纪律;把它折成缺席等于把引擎明说的一句话读成「不知道」。
- * 🔴 **坏行只丢那一行**(与 mcp 行同判据),但 `source` 读不出 ⇒ **整段缺席**:没有来源词的行表
- *    答不了运维真正要问的那一问(「这是缺省表还是你换过的表」),而半段会被当成完整答案。
- * 🔴 **不校「`droppedDefaultRows` 只在替换族在场」**:那是引擎的段内规矩,server 已按它铸;
- *    包再校一遍只会在上游合法演进的当天把一个真读数判没(与开集词表同规)。
- */
 export declare function projectWriteProtectionPosture(wiring: unknown): WriteProtectionPostureView | undefined;
-/**
- * 宿主 caps probe 的**读面 tee** 落点(与 `noteEngineCapsForSqlEngine` 并列)。绝不 throw ——
- * 读面腿不许反噬 caps 探测链。
- *
- * 🔴 投影 `undefined`(caps 畸形)⇒ 这一格**被删**而不是留着上一台引擎的旧值。
- * ⚠️ 「同端口 respawn / 版本回滚之后新探测失败或还在飞」是**另一条路**(本 tee 一次都不触发),
- *    由 {@link forgetWriteProtectionReading} 在装配口上收 —— 与 SQL 那一格逐字同形。
- * 🔴 **不按 principal 分域**:写保护表是**这台 worker 的 boot 产物**,与调用者是谁无关。
- *
- * 🔴 **`opts.generation` = 关掉「旧探测覆盖新读数」那条竞态的唯一正确供给**(0.60.0;异源对抗复审
- *    [medium] 采纳,真病):`kickEngineCapsProbe` 的代际闸在 **probe 返回之后**才跑,而本 tee 是在
- *    probe **内部**落地的 ⇒ 一次慢的旧探测能在 `invalidateEngineCaps` + 新探测都走完之后才返回,
- *    把**上一台引擎**的读数重新写回来。宿主在**起探测那一刻**调 `engineCapsGeneration(baseUrl)` 抓号、
- *    在这里原样交回,陈旧那一发就会被整只丢掉。
- *    ⚠️ **不传 = 与本位到货之前逐字节同行为**(照写)—— additive 供给,不是强制门;端没跟上之前不会
- *    有任何东西变坏。🔴 **tee 自己抓号是假判据**(陈旧那一发在这里读到的是新代号,永远像当代的)。
- */
 export declare function noteEngineCapsForWriteProtection(baseUrl: string, caps: unknown, opts?: {
     generation?: number;
 }): void;
-/** 本进程观测到的写保护姿态;这一格空缺 ⇒ `{kind:'unobserved'}`(**绝不**折成 `none`)。 */
 export declare function observedWriteProtection(baseUrl?: string | undefined): WriteProtectionReading;
-/**
- * 四态 → doctor 那一行的 detail 串。**唯一措辞真源**(三端共用一句话;别在各端的行装配里另写一遍
- * —— 与 `sqlEngineDoctorDetail` / `autoModeDoctorDetail` 同一条纪律)。
- *
- * 🔴 四句话刻意**互不相同、也互不蕴含**:「未观测」「老引擎不报」「进程说不出来」三种「读不出」
- *    对运维是三条不同的下一步,而**没有一条**等于「这台部署没有写保护」。
- * 🔴 `present` 那一句把三位**分开说**(见文件头「刻意不合成」):`armed` 说会不会弹卡,`rows` 说
- *    几行,`replaced` 说缺省表还在不在岗。
- * 🔴 行内容一个字都不渲(最小披露);`source` 是 operator 面的位,不上这一行。
- */
 export declare function writeProtectionDoctorDetail(reading: WriteProtectionReading): string;
-/**
- * operator 面读数 → 一行 detail(行名是 UNTRUSTED 自由文本 ⇒ 呈前**逐条**消毒 + 封长)。
- *
- * 🔴 消毒与封长的顺序 = **先转义、后按转义结果封长**({@link capForDisplay},0.62.0 起本包该族的
- *    唯一实现)。此前这三处是反的(先按原文 `slice` 再转义),一段纯控制字符的 40 字符原文转义后
- *    能占 240 个显示字符 —— 承诺的列宽预算成了名义值的六倍。同形存量另有 SQL 姿态行一处,同批同改。
- *
- * 🔴 只给**行数与来源**加上「头几行的名字」,不整表倾泻:一行诊断不是一个表格,而 operator 面的
- *    真表读法是那个端点本身。
- * 🔴 `rows: []` 渲的是**显式无表**这句正面事实,不是「读不出」。
- */
 export declare function writeProtectionPostureDetail(posture: WriteProtectionPostureView): string;
-/**
- * **换代失效口**(与 `forgetSqlEngineReading` 并列,由宿主在引擎温切成功后调)。
- *
- * 🔴 代际闸挡不住这一形:那道闸挡的是「旧响应写脏新一代」,而本格的病是反过来的 —— 新一代的探测
- *    **根本没成功**,tee 一次都没触发,上一台引擎留在同一端口上的读数继续被当成当代事实答出去。
- *    在 doctor 上它的形态最坏:一句**肯定句**(「这台部署有 12 行写保护」),说的却是一台已经不在
- *    的引擎。处置是**清成未观测**,不是留旧值也不是铸一个 `none`。
- * 空串 ⇒ no-op;绝不 throw(它跑在引擎温切路径上)。
- */
 export declare function forgetWriteProtectionReading(baseUrl: string | undefined): void;
-/** 测试钩子。 */
 export declare function __resetWriteProtectionReadingsForTests(): void;

package/dist/writeProtectionCapability.js

@@ -1,52 +1,9 @@
-/**
- * writeProtectionCapability — **写保护名表**姿态的三端共用读面(0.60.0)。
- *
- * 引擎带一张**字面名表**,落在表行上的可定路径写(Write / Edit / NotebookEdit)从 `allow` 降级成
- * `ask` —— 所以端可以**事先**告诉人「这些路径会弹卡」。两个读面同源同一份 boot 产物:
- *   · **租户面** `GET /v1/capabilities` 的 `writeProtection`(engine ≥7.63.0 / S-138;sdk 8.4.0
- *     `Capabilities.writeProtection`)—— 只有三位计数/开关,**不含行内容**;
- *   · **operator 面** `GET /v1/diagnostics/wiring` 的 `writeProtection` —— 多出**行内容**与来源词。
- *
- * ── 🔴 四态,不是两态([honest-absence-not-fabricated-zero])──────────────────────────────────
- * 与 `sqlEngineCapability` 逐字同一套词汇(通用读口答「这一格上有没有值」,窄读器答「值成不成形」):
- *   ① `unobserved`   —— **本进程一次 caps 响应都没观测到**(一次性 doctor 就是这一档)。
- *   ② `not_reported` —— caps 观测到了,而回体上**没有**这个键 ⇒ 老引擎(<7.63.0)。
- *      🔴 它**不是**「这台部署没有写保护表」—— 恰恰相反:引擎侧**座位缺席时缺省表在岗**
- *         (按键名 grep 推断「没装」会推错,上游把这一条写进了本位的顶注)。
- *   ③ `none`         —— 引擎**明确说** `null`:这个进程说不出来(非 composition root 装配的夹具形)。
- *      同样**不是**「没有表」。
- *   ④ `present`      —— 三位俱全,原样渲。
- *
- * ── 🔴 三位刻意不合成一个布尔(上游顶注逐字)────────────────────────────────────────────────
- * `armed`(生效表非空 ⇒ 真会弹卡)/ `rows`(生效表行数)/ `replaced`(整表替换旋钮被写过)——
- * 合成之后「引擎缺省表在岗」与「运维换了一张自己的表」同为 true,而两者对运维说的是两件事。
- * ⚠️ `replaced` 把「整表替换成**空**表」也算 true:报 false 会把「运维亲手关掉了表」说成
- * 「缺省表没被动过」。
- *
- * ── 🔴 最小披露:逐行 name/kind 不上租户面 ──────────────────────────────────────────────────
- * 部署自定义行可能含内部路径名,列出来等于告诉想绕过的人「哪些名字不受保护」。行内容只在
- * operator 面({@link projectWriteProtectionPosture}),而那个端点本身是 operator-gated。
- * 🔴 与**模式型** write deny(`SENSITIVE_WRITE_PATTERNS`)是**并列机制**,两个读面分开报、
- * 绝不合成一位:两者的解法不同(一套改模式,一套改名表)。
- */
 import { capForDisplay } from './fleetTaskDesc.js';
 import { engineWireTarget } from './engineWireTarget.js';
 import { createEngineCapReader } from './engineCapReader.js';
-/**
- * caps 回体 → 本格读数;**畸形一律 `undefined`**(= 这一格不写 ⇒ 读口答 `unobserved`)。
- *
- * 🔴 `undefined`(键不在)与 `null`(引擎说不出来)**是两件事**:前者 ⇒ `not_reported`(老引擎),
- *    后者 ⇒ `none`(夹具形进程)。用 `??` / falsy 判会把两者压成一件。
- * 🔴 三位**任一**形不合 ⇒ 整条判畸形。绝不留一个缺位的对象:一行写着「rows: 」的诊断比不渲这一行
- *    更坏(它看起来像一个答案)。
- * ⚠️ `rows` 按**非负有限整数**判,不按真值判:`0` 是合法读数(表在、但生效行为零),折成缺席会让
- *    「表空了」与「没报」在消费端同形。
- */
 export function projectWriteProtectionCapability(caps) {
     if (caps === null || typeof caps !== 'object')
         return undefined;
-    // 0.77.0 整族改齐:① 非对象 / 数组 caps 不是能力表 ⇒ 畸形(投影答 undefined ⇒ 删格 ⇒ 读口答 unobserved),不再答 not_reported
-    //    (那是把「取不到」冒充「报了但没提」);② 在场判据改 hasOwn —— 原型链上的同名键永远不会被序列化上 wire,读成在场 = 凭空造一格。
     if (caps === null || typeof caps !== 'object' || Array.isArray(caps))
         return undefined;
     if (!Object.hasOwn(caps, 'writeProtection'))
@@ -59,7 +16,6 @@ export function projectWriteProtectionCapability(caps) {
     if (typeof wp !== 'object' || Array.isArray(wp))
         return undefined;
     const w = wp;
-    // 🔴 只读一次(0.74.2 CC-69 复审 R1 族扫):校验与返回各读一次,变化的 getter 会让校验读到合形、返回读到别的。
     const armed = w.armed;
     const replaced = w.replaced;
     const rows = w.rows;
@@ -71,16 +27,6 @@ export function projectWriteProtectionCapability(caps) {
         return undefined;
     return { kind: 'present', view: { armed, rows, replaced } };
 }
-/**
- * operator 面回体的 `writeProtection` 段 → 读数;不成形 ⇒ `undefined`。
- *
- * 🔴 **空 `rows` 数组是正面事实**(「显式无表」),照铸 `[]` —— 与 `wiring_manifest.mcp[]` 同一条
- *    已定谳的纪律;把它折成缺席等于把引擎明说的一句话读成「不知道」。
- * 🔴 **坏行只丢那一行**(与 mcp 行同判据),但 `source` 读不出 ⇒ **整段缺席**:没有来源词的行表
- *    答不了运维真正要问的那一问(「这是缺省表还是你换过的表」),而半段会被当成完整答案。
- * 🔴 **不校「`droppedDefaultRows` 只在替换族在场」**:那是引擎的段内规矩,server 已按它铸;
- *    包再校一遍只会在上游合法演进的当天把一个真读数判没(与开集词表同规)。
- */
 export function projectWriteProtectionPosture(wiring) {
     if (wiring === null || typeof wiring !== 'object')
         return undefined;
@@ -113,52 +59,18 @@ export function projectWriteProtectionPosture(wiring) {
         ...(dropped !== undefined ? { droppedDefaultRows: dropped } : {}),
     };
 }
-/**
- * 本格的 per-baseUrl 读账 + tee / 读口 / 失效口 / 测试钩四口 —— 各只能力位读器**共用同一份实现**
- * ({@link createEngineCapReader});本文件只留这一格真正不同的部分:投影函数 {@link projectWriteProtectionCapability}、doctor 措辞表,以及本位自己的判据助手(如有)。
- * 🔴 Map 在工厂闭包里,**一只读器一张**:收到读不懂的回体只删自己这一格,绝不连坐别的能力面。
- */
 const reader = createEngineCapReader({
     name: 'writeProtection',
     project: projectWriteProtectionCapability,
     makeUnobserved: () => ({ kind: 'unobserved' }),
 });
-/**
- * 宿主 caps probe 的**读面 tee** 落点(与 `noteEngineCapsForSqlEngine` 并列)。绝不 throw ——
- * 读面腿不许反噬 caps 探测链。
- *
- * 🔴 投影 `undefined`(caps 畸形)⇒ 这一格**被删**而不是留着上一台引擎的旧值。
- * ⚠️ 「同端口 respawn / 版本回滚之后新探测失败或还在飞」是**另一条路**(本 tee 一次都不触发),
- *    由 {@link forgetWriteProtectionReading} 在装配口上收 —— 与 SQL 那一格逐字同形。
- * 🔴 **不按 principal 分域**:写保护表是**这台 worker 的 boot 产物**,与调用者是谁无关。
- *
- * 🔴 **`opts.generation` = 关掉「旧探测覆盖新读数」那条竞态的唯一正确供给**(0.60.0;异源对抗复审
- *    [medium] 采纳,真病):`kickEngineCapsProbe` 的代际闸在 **probe 返回之后**才跑,而本 tee 是在
- *    probe **内部**落地的 ⇒ 一次慢的旧探测能在 `invalidateEngineCaps` + 新探测都走完之后才返回,
- *    把**上一台引擎**的读数重新写回来。宿主在**起探测那一刻**调 `engineCapsGeneration(baseUrl)` 抓号、
- *    在这里原样交回,陈旧那一发就会被整只丢掉。
- *    ⚠️ **不传 = 与本位到货之前逐字节同行为**(照写)—— additive 供给,不是强制门;端没跟上之前不会
- *    有任何东西变坏。🔴 **tee 自己抓号是假判据**(陈旧那一发在这里读到的是新代号,永远像当代的)。
- */
 export function noteEngineCapsForWriteProtection(baseUrl, caps, opts) {
     reader.note(baseUrl, caps, opts);
 }
-/** 本进程观测到的写保护姿态;这一格空缺 ⇒ `{kind:'unobserved'}`(**绝不**折成 `none`)。 */
 export function observedWriteProtection(baseUrl = engineWireTarget()?.baseUrl) {
     return reader.observed(baseUrl);
 }
-/** 单行 UNTRUSTED 座的展示上限(UTF-16 单元;与 SQL 那一格同值同理由)。 */
 const WP_DETAIL_MAX = 40;
-/**
- * 四态 → doctor 那一行的 detail 串。**唯一措辞真源**(三端共用一句话;别在各端的行装配里另写一遍
- * —— 与 `sqlEngineDoctorDetail` / `autoModeDoctorDetail` 同一条纪律)。
- *
- * 🔴 四句话刻意**互不相同、也互不蕴含**:「未观测」「老引擎不报」「进程说不出来」三种「读不出」
- *    对运维是三条不同的下一步,而**没有一条**等于「这台部署没有写保护」。
- * 🔴 `present` 那一句把三位**分开说**(见文件头「刻意不合成」):`armed` 说会不会弹卡,`rows` 说
- *    几行,`replaced` 说缺省表还在不在岗。
- * 🔴 行内容一个字都不渲(最小披露);`source` 是 operator 面的位,不上这一行。
- */
 export function writeProtectionDoctorDetail(reading) {
     switch (reading.kind) {
         case 'unobserved':
@@ -183,17 +95,6 @@ export function writeProtectionDoctorDetail(reading) {
         }
     }
 }
-/**
- * operator 面读数 → 一行 detail(行名是 UNTRUSTED 自由文本 ⇒ 呈前**逐条**消毒 + 封长)。
- *
- * 🔴 消毒与封长的顺序 = **先转义、后按转义结果封长**({@link capForDisplay},0.62.0 起本包该族的
- *    唯一实现)。此前这三处是反的(先按原文 `slice` 再转义),一段纯控制字符的 40 字符原文转义后
- *    能占 240 个显示字符 —— 承诺的列宽预算成了名义值的六倍。同形存量另有 SQL 姿态行一处,同批同改。
- *
- * 🔴 只给**行数与来源**加上「头几行的名字」,不整表倾泻:一行诊断不是一个表格,而 operator 面的
- *    真表读法是那个端点本身。
- * 🔴 `rows: []` 渲的是**显式无表**这句正面事实,不是「读不出」。
- */
 export function writeProtectionPostureDetail(posture) {
     const source = capForDisplay(posture.source, WP_DETAIL_MAX);
     if (posture.rows.length === 0)
@@ -208,19 +109,9 @@ export function writeProtectionPostureDetail(posture) {
         : '';
     return `source ${source} · ${String(posture.rows.length)} ${posture.rows.length === 1 ? 'name' : 'names'}: ${shown}${more}${dropped}`;
 }
-/**
- * **换代失效口**(与 `forgetSqlEngineReading` 并列,由宿主在引擎温切成功后调)。
- *
- * 🔴 代际闸挡不住这一形:那道闸挡的是「旧响应写脏新一代」,而本格的病是反过来的 —— 新一代的探测
- *    **根本没成功**,tee 一次都没触发,上一台引擎留在同一端口上的读数继续被当成当代事实答出去。
- *    在 doctor 上它的形态最坏:一句**肯定句**(「这台部署有 12 行写保护」),说的却是一台已经不在
- *    的引擎。处置是**清成未观测**,不是留旧值也不是铸一个 `none`。
- * 空串 ⇒ no-op;绝不 throw(它跑在引擎温切路径上)。
- */
 export function forgetWriteProtectionReading(baseUrl) {
     reader.forget(baseUrl);
 }
-/** 测试钩子。 */
 export function __resetWriteProtectionReadingsForTests() {
     reader.__resetForTests();
 }