@sema-agent/client-core 0.77.1 → 0.77.2

package/dist/fleet/fleetProjection.d.ts

@@ -1,98 +1,27 @@
-/**
- * ⇄ B6 批搬迁(2026-07-27,设计稿 §3 B6 + §2.5 拆缝表):cli `src/sema/fleetClient.ts` 的
- *    **投影半场** —— `coerceTaskStatus` / `coerceWorkflowStatus` / `deriveAgentLabel` /
- *    `projectDescription` / `CONTROL_TOOL_VERBS` / `projectTasks` / `projectWorkflows` /
- *    四个 `wire*` 读取器 + `TERMINAL_FLEET_TASK_STATUSES`。
- *
- * 留在 TUI 的(设计稿 §2.4.2-B「看着像库、其实是端」):`main` 合成行 / `selection` 游标 /
- * `viewed` 的**所有者**(AppState.viewingAgentTaskId)/ `footerRowBelt.isFooterTaskRow` 的
- * 「丢弃所有无 parentId 顶层行」—— 后者是端专属决策(主 run 由壳自己合成头部行渲染),
- * 所以本文件的 `projectTasks` 把它做成**必填**的 `rowFilter`,不是可选钩子:
- * 🔴 做成可选 = 端漏传时主 run 行会与端自己的头部行**双渲**,而两张都长得像对的
- *    ([paired-mechanisms-must-share-premise] 的同族失败形)。必填 ⇒ 编译期就逼端表态。
- *
- * 🔴 SDK 0.0.117 提货(B6):`toolUses` / `transcriptId` / `currentTool` / `startedCount` /
- *    `parentToolCallId` / `stoppedBy` / `usage` / `resumable` / `editedFiles` **全部已进
- *    `FleetTaskRow`/`FleetWorkflowRow` 类型面** ⇒ 壳里那四个 "permissive read"(注释自述
- *    「SDK 类型面滞后,bump 后可改直读」)本批**兑现成 typed 直读**;保留的只有**值域校验**
- *    (`Number.isFinite`/`>=0`/非空串),那不是防御读,是 wire 脏值的诚实过滤。
- */
 import type { FleetTaskRow, FleetWorkflowRow } from '@sema-agent/sdk';
-/** 渲染面的 fleet 状态词汇(cli `overrides/fleet-tree.tsx` 的 `FleetTaskStatus` 同集同序)。 */
 export type FleetTaskStatus = 'queued' | 'running' | 'waiting' | 'stopping' | 'awaiting approval' | 'idle' | 'completed' | 'failed' | 'killed';
-/**
- * 投影后的一条 task 行。渲染器类型(cli `overrides/fleet-tree.tsx` 的 `FleetTask`)留在端上——
- * 它是**渲染契约**,本接口是**产出侧**类型,两者同族但不是同一个物。
- *
- * ⚠️ **两侧漂移到底被什么看住 —— 精确版(2026-07-31 更正)**:此处原写「两侧漂移由 pure 门的
- * 键集断言钉死」,那是**假话**:pure 门里从来没有键集断言(只有逐字段的取值断言,
- * `run-client-core-pure-test.mjs:2411-2452`)。当时真正在跑的看守只有一条 ——
- *   · **编译期、壳侧、单向**:cli `src/sema/fleetClient.ts` 的 `projectTasksForTest` 把
- *     `projectTasks(...)`(`FleetTaskView[]`)当 `FleetTask[]` 返回,于是 tsc 校
- *     `FleetTaskView` **可赋给** `FleetTask`。它只拦一件事:渲染契约要一个**必填**键而投影没产。
- *     它拦不住的两个方向:①「投影多产一个渲染契约没声明的键」(非字面量赋值不做多余属性检查)、
- *     ②「渲染契约多声明一个**可选**键而投影永不产」。而本接口的键**几乎全是可选的** ⇒ 那道
- *     检查对本接口绝大多数键零判别力。`startedAt` 就是从这个缝里漏出去的(见该键的注)。
- * 现在补上的是运行期、本仓、**双向**的那半边:`scripts/run-fleet-view-keys-test.mjs` ——
- * 本接口 ⇄ `FLEET_TASK_VIEW_KEYS`(文件末 `_fleetViewKeyPins`,编译期两个方向)⇄ 最大行/最小行
- * 的**真产出键集**(运行期逐元素相等),外加 wire 键投影覆盖账 + 壳渲染契约漂移账。
- */
 export interface FleetTaskView {
     id: string;
-    /** agent 身份名(187 `tjl`:agentName ?? agentType;都缺才退 objective 派生的单行 label)。 */
     name: string;
-    /** 行正文 = 进度摘要,绝不是控制面工具动词。 */
     description: string;
     depth: number;
     parentId?: string;
     status: FleetTaskStatus;
-    /**
-     * 🔴 0.73.0(BREAKING):三个数值键由必填改**可选** —— 有键 ⇒ 真值(含真 0);缺键 ⇒ 「不知道」。此前 `?? 0` 把 wire
-     * 缺席编成 0(「0 秒」「0 tokens」「0 个排队」都是本包替引擎编的话)。坏形(负数 / NaN / 非数)同样缺席。
-     *   · `elapsedMs` 缺席 = 这一行既没有 launch 锚也没有引擎快照(极早期的首帧 / 很老的引擎);渲「—」,不渲 0s。
-     *   · `tokens` 缺席 = 引擎还没为这一行报过用量(排队中 / 刚起 / 该车道不报);渲「—」,不渲 0。
-     *   · `queuedCount` 缺席 = 引擎没报这一位(本包不保证任何引擎版本上报它);不渲排队徽标,不渲「0 queued」。
-     */
     elapsedMs?: number;
     tokens?: number;
     tokenDir: 'down' | 'up';
     queuedCount?: number;
-    /** REF-CC-050(fleet2-12):投影器无条件赋值(`?? false`),门 `ALWAYS_EMITTED_TASK_VIEW_KEYS`
-     *  已把它钉成「恒发」——类型必填而不是留一条测不到的缺席分支。 */
     awaitingPlanApproval: boolean;
-    /** REF-CC-050:同上,`childCount.get(r.id) ?? 0` 恒赋值。 */
     descendantCount: number;
-    /** REF-CC-050:同上,`viewingTaskId !== undefined && …` 恒赋值(布尔运算永不产 undefined)。 */
     viewed: boolean;
-    /** 🔴 三态:有键 ⇒ 真值(含真 0);缺键 ⇒ 「不知道」。绝不 `?? 0`。 */
     toolUses?: number;
     transcriptId?: string;
     currentTool?: {
         toolName: string;
         target?: string;
     };
-    /**
-     * server ≥1.250 的 launch 真锚(epoch ms;ADDITIVE / tolerate-absent)。
-     *
-     * 🔴 **本键此前在这一层被丢弃** —— wire 有、`fleetLedger` 也读到了(只拿它算 `elapsedMs`,
-     * `fleetLedger.ts:447-448`),但投影视图不带它出去 ⇒ 下游拿不到 launch 时刻,只能锚「自己建行的
-     * 那一刻」,遗留/重挂的行就渲出 1h+ 的假时长(2026-07-31 用户实拍,五报清查报④)。
-     * 这是同一个 wire 键的**第四个投影面**:`fleetAgentPanelProjection`(面板事件)、
-     * `backgroundView`(web/桌面跨端视图)、本视图(fleet 树)、以及 ledger 内部的 elapsed 自算 ——
-     * 前两个先后补过,本层是最后一处([[new-data-source-systemic-checks]] ④:补一处不等于补齐)。
-     * 缺席 = 旧引擎/排队中的行,消费端必须容忍(禁 `?? 0`,0 不是「1970 年启动」)。
-     */
     startedAt?: number;
-    /**
-     * [1832] P1-2(server ≥1.290 / engine 1.432):发起本子代的父 tool_use id **原值**。
-     * B6 新落键 —— 归属不再靠猜,按 tool_use id 建卡树的消费端直接绑定。缺席 = 旧端。
-     */
     parentToolCallId?: string;
-    /**
-     * [1839]①(server ≥1.291)**终态行帧四键**,只在终态帧出现、全部 tolerate-absent:
-     * 看行卡(不订通知帧)的 idle 观察者此前拿不到终局,现在拿得到。
-     * `resumable`/`editedFiles` **仅 bg 子代有源**(顶层 run 的 TaskResult 无这两位,永缺席、不造)。
-     */
     stoppedBy?: string;
     usage?: FleetRowUsage;
     resumable?: boolean;
@@ -100,20 +29,9 @@ export interface FleetTaskView {
         path: string;
         edits: number;
     }>;
-    /**
-     * #261 §2① 代际号(0.38.0 提货补投;取值规则见 {@link wireCycleSeq})。
-     * 同 id 帧 `cycleSeq` 更大 ⇒ **复活**(新代际,行内累计量重置);更小 ⇒ 前代迟到帧,忽略;
-     * **缺席 ⇒ 这条行没有代际概念**(不是第一代)。
-     */
     cycleSeq?: number;
-    /**
-     * #261 §2② 非亲报终态的投影者(0.38.0 提货补投;取值规则见 {@link wireRetiredBy})。
-     * **在场 = 这条终态是对账腿从 durable run 行读出来的**(发布方死了),缺席 = 发布方亲报。
-     * 读侧开集,未知词通渲。
-     */
     retiredBy?: string;
 }
-/** 终态行帧 / bg 通知帧共用的 usage 形(SDK `FleetTaskRow.usage` ≡ `FleetBgNotification.usage`)。 */
 export interface FleetRowUsage {
     totalTokens?: number;
     toolUses?: number;
@@ -122,201 +40,43 @@ export interface FleetRowUsage {
     turns?: number;
     costMicroUsd?: number;
 }
-/** 投影后的一条 workflow 行(与 cli `FleetWorkflow` 结构等同)。 */
 export interface FleetWorkflowView {
     id: string;
     name: string;
     description: string;
     status: FleetTaskStatus;
-    /**
-     * 🔴 0.73.0(BREAKING):五个数值键由必填改**可选**(读法同 {@link FleetTaskView.elapsedMs})。现役引擎的 workflow 行
-     * 铸点五键**恒发**,缺席只出现在更老的引擎 / 乱序的部分增量上 —— 那时渲「—」,**不互相推导**
-     * (`failedCount` 缺席不读作 0;`totalCount` 缺席不拿 `doneCount` 顶)。
-     */
     doneCount?: number;
     totalCount?: number;
     elapsedMs?: number;
     tokens?: number;
     failedCount?: number;
-    /** 🔴 缺席 ≠ 0:0 = 引擎说「一个都没起」,undefined = 老引擎「不知道」(退 done+failed 下界)。 */
     startedCount?: number;
-    /**
-     * 0.74.3 CC-72(core 7.23.5 #932;cli L-235 ②):run 级 errorCode **原词逐字**(开集,不枚举)。缺席 = 无码 ——
-     * **不是成功也不是失败**,终态仍看 `status`;server 透传 / sdk 声明之前按结构读(sdk 9.7.1 `FleetWorkflowRow` 未声明)。
-     */
     errorCode?: string;
 }
-/**
- * SDK `FleetTaskStatus` 的终态词汇 —— 非终态即在飞(未知未来值按在飞算,保守)。
- * cli 侧 `engineBgGate.TERMINAL_STATUSES` 是**刻意的第二份**(零模块图污染),drift 由壳的
- * `terminalStatuses.test.ts` 锁定 —— 本批不动那份。
- */
 export declare const TERMINAL_FLEET_TASK_STATUSES: ReadonlySet<string>;
-/**
- * 未来/未知 wire 状态 → 渲染词汇(闭集但读侧开集)。
- *
- * ⚠️ **B6 未删 `parked`,与任务书的 G11 指令相反 —— 理由与直证写在这里**:
- *  · 直证(server 1.291.0 dist,`fleet/fleet-bus.d.ts` + `fleet-bus.js` 12 处 publishTask):
- *    `FleetTaskStatus` 闭集**不含** `parked`,且每处 publishTask 的 status 都出自
- *    `completed|failed|killed|running` 四值三元链 ⇒ 今天 `'parked'` 在 fleet 行 wire 上**不可达**,
- *    这一支确实是死分支。
- *  · 但**后果方向不对称**([anchor-on-the-deciding-quantity]「先定这个量门控动作的正负号」):
- *    本支是**保护型**映射(把非活非终态的 parked 映到 'awaiting approval');删掉之后
- *    它落 `default`(⚠️ [2393] notif-F5 纠:`default` 已由 REF-CC-043 改渲 `'idle'`,下面那段
- *    是权威;本行原写「渲成 `running` = 谎报活跃」是**退役后没跟的旧行为描述**)。core 1.382 已有该状态([1561],
- *    design/153 §7.1),server 只是尚未投影 ⇒ 这不是「猜测层」,是**预挂**。
- *    删的收益 = 一行;删的代价 = server 补上透传那天静默说谎。
- *  ⇒ 保留 + 把「候 server 预挂」的注释换成上面这条可复核的直证。定谳权交回 PM。
- *
- * 🔴 REF-CC-043(fleet2-05,P2 裁 GO,宪法三问已过):`default` 分支此前渲 `'running'` ——
- *  未知未来状态被谎报成「活跃」,后果方向是**伤害型**(用户会以为一个已经僵住/退场的子代还在跑)。
- *  改渲 `'idle'`(闭集里本就存在的「非活跃」词,187 用它表示「非活跃、非终态、非阻塞」)—— 门
- *  `ALWAYS_EMITTED_TASK_VIEW_KEYS` 不受影响,只是同一个已知渲染词的语义更诚实。
- *  🔴 [2393] notif-F5(2026-08-03 全窗复审)**补记宿主后果**(上一版裁决注只写到「同一个已知
- *  渲染词」,而下游语义比这句话大 —— 宪法三问的「谁受害」那一栏漏了这两处,补在这里以免下一棒
- *  照着「只是换个词」去判断):
- *    · 壳 `overrides/fleet-tree.tsx`:`idle` 分支**短路 elapsed 与 token 两列**(返回
- *      `elapsed:'idle'`、`tokenText:''`),`running` 则渲真 elapsed/tokens;
- *    · 壳 `overrides/fleet-view-screen.tsx`:`deriveBands` 把 `idle` 计进 **awaiting**(「等你处理」)
- *      档,`running` 计进 **working** 档。
- *  ⇒ status 缺席/脏的行现在会:丢掉 elapsed/tokens + 在表头被数成「awaiting」。方向仍然对
- *  (谎报活跃 = 伤害型,谎报不活跃 = 保护型),但它是一次**跨仓渲染语义**改动;三端提货单已点名
- *  (`docs/refactor/README.md`「提货单 / 破坏性变更清单」B 组),宿主侧另有一条陈述漂移待改
- *  (同表「宿主侧待办」:壳 engineBgShellPanelStore 的兜底方向陈述已成假话)。
- *  `s` 的参数类型同批收窄:`| undefined` 半支从未被真实调用点使用过(唯一生产调用点
- *  `projectTasks` 传的是 SDK 必填闭集 `FleetTaskRow['status']`),继续留着是死分支。
- */
 export declare function coerceTaskStatus(s: string): FleetTaskStatus;
-/**
- * 中性 workflow 状态(run 席 `running|completed|failed`;item 席多一个 `parked`)→ 渲染词汇。
- *
- * 🔴 **0.65.0 加 `parked`(L-215① / B-079②)**:sdk 9.0.0 把 item 席具名成 `WorkflowItemStatus`
- * 并加了 `parked`(「这一序数停在耐久审批门上等一次决定」),core 7.10.0 #642 是它的出处。
- * 修前这里**没有这个 case**,于是它落进 `default` 被折成 `running` —— fleet 车道上一条**停着等人**
- * 的工作流被渲成「在跑」,而那正是「等你」与「不需要你动」的分界。折成 `running` 之后用户没有任何
- * 线索去按 ctrl+t 找那张卡,run 就一直停在那里。
- * ⇒ 与 {@link coerceTaskStatus} 的 `parked` 臂**同一个落点** `awaiting approval`:同一件事在两条
- *   车道上必须渲同一个词(两处各渲各的正是同名不同义的来源)。
- *
- * 🔴 **为什么直接加词、而不是铸一个 `_sema_parked: true` 超集键**(任务书要求写明选形理由):
- * 判据是 sdk 那一位**在型面上开不开**,不是「它今天有几个已知值」——
- * `FleetWorkflowRow.status` 在 sdk 8.8.0 与 9.0.0 上都声明成裸 `string`(`dist/resources/fleet.d.ts`
- * 的 `status: string`,头注逐字「the NEUTRAL workflow run status (`running`|`completed`|`failed`),
- * **open on read**」)。**它不是闭集** ⇒ 一个新词在 wire 上、在型面上都合法,消费端要做的就是
- * 认它;此时再加一个 `_sema_` 前缀的孪生布尔,等于替一件上游已经能说清楚的事**另铸第二个真源**,
- * 而两个真源迟早分叉(本包一贯要根治的形)。超集键留给「上游那一位真是闭集、加词会让严格消费端
- * 判违约」的那一类,这里不是。
- *
- * ⚠️ **本函数仍收 run 席与 item 席两处**(调用点见 `projectWorkflows`):core 的两张词表里
- * `parked` 只在 item 席,所以 run 席读到它属于上游异常 —— 但**渲染面的处置相同**(都是「等人」),
- * 在这里为「哪一席」分叉只会长出一条没有用户面差别的分支。
- */
 export declare function coerceWorkflowStatus(s: string | undefined): FleetTaskStatus;
-/**
- * 引擎把 fleet 行的 `description` 设成 agent 的**最后一个工具名**(service fleet-bus
- * `description = ev.toolName`)。187 的行正文是进度摘要、从不是工具动词,所以控制面/合成动词
- * 泄漏进行(clay 见过的 `report_blocked`)是纯分歧。这里压掉**已知**的控制面动词(保守集合),
- * 真实工作工具(Read/Bash/Edit…)原样放行。
- *
- * 集合 = core `RESERVED_AGENT_NAMES`(subagent.ts)的 CC-parity PascalCase 形 + goal 模式的
- * `DeclareDone`。引擎 ≥ core 1.176 经 `canonicalToolName` 发 PascalCase。
- *
- * 🔴 [2006] A-CC-4(2026-07-29):此表此前**零门看守**,而 core 早已把子代委派工具改名成
- *    `Agent`(`DEFAULT_SUBAGENT_TOOL_NAME`;`Task`/`Fork` 退成 `OLD_TO_NEW` 旧名,`Fork` 还进了
- *    `TOMBSTONED_TOOLS`)。表里缺 `Agent` ⇒ 今天绝大多数 fleet 行的 description(引擎发的正是
- *    canonical 形 `Agent`)**压制不掉**,控制面动词照样泄漏进行正文 —— 正是本函数存在的理由被
- *    静默架空。看守从此是 engine-vocab 门对**实装 core** `RESERVED_AGENT_NAMES` 的等值门;
- *    `Fork` 作为**登记旧名**保留(老引擎仍可能发;压制集多一个只多压制、不误伤真工具),
- *    而"登记"本身要过门 —— 登记项必须是 core 认过的改名/墓碑词。
- */
 export declare const CONTROL_TOOL_VERBS: ReadonlySet<string>;
-/**
- * 行的活动正文:控制面动词 ⇒ 空(187 从不显示它),否则按单行呈现载体规整后放行。
- *
- * #307:本函数是描述列的**主臂**(`projectDescription(...) || taskDescFromName(...)`),
- * 修前它把 wire 原串原样返回 —— 描述列的规整只落在 fallback 臂的 `collapseLabel` 上,
- * 主臂给值时那道规整根本不经过([assert-absence-check-fallback-layers] 同族形)。
- * 🔴 压制判定仍按**原值** trim(判据集是 ASCII 动词名,规整不参与放行判定);规整只加在
- *    返回的呈现串上。空/非空面不变:可见转义不产生空白,`|| fallback` 的真假面照旧。
- */
 export declare function projectDescription(description: string | undefined): string;
-/**
- * `parentId` —— 悬空父的存在性判定唯一铸点(REF-CC-049,fleet2-11)。B10 禁真值判定当存在性判定:
- * 空串是脏值形(SDK 只承诺「悬空不发」,那是 server 当下行为不是类型保证),按缺席处理。
- * `fleetLedger.ts` 与本文件的 `projectTasks` 都调它 —— 一个谓词一个铸点,防止 `!== undefined`
- * 与真值判定两种写法在同一字段上判读相反(悬空父脏值 `""` 时曾经真的翻过面)。
- */
 export declare function wireParentId(r: Pick<FleetTaskRow, 'parentId'>): string | undefined;
-/** 终态四键之 `usage`(数值 verbatim,只挑数字位;全脏 ⇒ 整键缺席,不造空对象)。 */
 export declare function wireRowUsage(r: Pick<FleetTaskRow, 'usage'>): FleetRowUsage | undefined;
-/**
- * #261 §2① `cycleSeq`(server ≥7.25.0 / core 5.36.0 #258;SDK **7.2.0** 才把它声明进
- * `FleetTaskRow` ⇒ 本包 0.38.0 提货补投)—— 这一行的**代际号**,与 `FleetBgNotification.seq` /
- * `task_progress.seq` **同域同轴**(fresh spawn 就是 cycle 1,每次 SendMessage 复活翻 +1)。
- *
- * 🔴 **缺席 = 「无此概念」,不是「第一代」**(SDK 头注逐字):没有 `a*` registry 行的 run ——
- * 同步委派子代 / workflow `wa*` agent / **顶层 run 行** —— 根本没有代际。把缺席读成 1 的消费端
- * 会把「首帧迟到」误判成「复活」。所以这里对**非正整数**一律整键缺席(0 / 负数 / 非有限数 /
- * 非整数都不是合法代际号),绝不 `?? 0`、绝不 `?? 1`。
- */
 export declare function wireCycleSeq(r: Pick<FleetTaskRow, 'cycleSeq'>): number | undefined;
-/** 终态四键之 `resumable`(仅 bg 子代有源;非 boolean ⇒ 缺席,**不当 false**)。 */
 export declare function wireResumable(r: Pick<FleetTaskRow, 'resumable'>): boolean | undefined;
 export interface ProjectTasksOptions {
-    /**
-     * 🔴 **必填的端专属过滤器**(设计稿 §2.4.2-B):壳传 `filterFooterTaskRows`
-     * (丢无 parentId 顶层行 + workflow 双生行四判据);别的端按自己的树形状给。
-     * 想要「全都要」显式传 `rows => [...rows]` —— 必须写出来,不给缺省。
-     */
     rowFilter(rows: readonly FleetTaskRow[]): FleetTaskRow[];
-    /** 正在被查看的 agent taskId(端的 `viewingAgentTaskId`);行 id 尾段等于它 ⇒ `viewed:true`。 */
     viewingTaskId?: string | undefined;
 }
-/**
- * wire task 行(Map values)→ 渲染行。树 depth/parentId 来自 wire:无 parentId = 顶层(depth 0),
- * 子行挂在父下面,depth 沿 parent 链算(自引用/环由 `seen` 断)。
- */
 export declare function projectTasks(allRows: readonly FleetTaskRow[], opts: ProjectTasksOptions): FleetTaskView[];
-/** wire workflow 行 → 渲染行。 */
 export declare function projectWorkflows(rows: readonly FleetWorkflowRow[]): FleetWorkflowView[];
-/** `FleetTaskView` 的键名清单(运行期物;编译期与 `keyof FleetTaskView` 双向等值)。 */
 export declare const FLEET_TASK_VIEW_KEYS: readonly string[];
-/** `FleetWorkflowView` 的键名清单(同上)。 */
 export declare const FLEET_WORKFLOW_VIEW_KEYS: readonly string[];
-/** SDK `FleetTaskRow` 的**入口**键名清单(编译期与 `keyof FleetTaskRow` 双向等值 ⇒ SDK 加一个
- *  wire 键,本元组不跟就编译红;跟了之后覆盖账那条腿再逼你表态「投不投」)。 */
 export declare const FLEET_TASK_ROW_WIRE_KEYS: readonly string[];
-/** SDK `FleetWorkflowRow` 的入口键名清单(同上)。 */
 export declare const FLEET_WORKFLOW_ROW_WIRE_KEYS: readonly string[];
-/**
- * 不投影登记表的一条条目(REF-CC-053,fleet2-15,P2 裁 GO)。
- *
- * 🔴 表原先只要求「写够 20 字理由」,而一条自认的**已知缺口**(`currentAction`,补它=真行为改动)
- * 与三条**设计取舍**(折进别的键 / 归属权威在别处)共用同一条放行通道 —— 门只能证明「有人表过态」,
- * 证明不了这态是「已裁定不做」还是「欠着没人管」。`kind` 把两者拆成两条不同的路:
- *   · `by-design`:裁定不投影,不需要到期日(它不会自己变成待办)。
- *   · `known-gap`:真缺口,`dueDate` 到期未清 ⇒ 门红(与规范「具名豁免带属主与到期日,过期即红」
- *     同款,`run-fleet-view-keys-test.mjs` 的 D 段做校验)。
- */
 export interface NotProjectedEntry {
-    /** 为什么不投影(≥20 字,原「理由」字段原样保留)。 */
     reason: string;
-    /** `by-design` = 裁定的架构取舍;`known-gap` = 自认的缺口,不是取舍。 */
     kind: 'by-design' | 'known-gap';
-    /** 谁负责这条判定 / 谁负责把 known-gap 补上。 */
     owner: string;
-    /** 仅 `known-gap` 必填:ISO 日期,过期未清 = 门红(禁无期限豁免)。 */
     dueDate?: string;
 }
-/**
- * **不投影登记表**:wire 上有、`FleetTaskView` 上**故意没有**的键,每条必须写清理由。
- *
- * 🔴 这张表是 `startedAt` 那类事故的正面看守:那次不是「谁反对投影它」,是**没有人被逼着表态**——
- * wire 有、ledger 读到了、另外两个投影面都补过,唯独这一层静默丢弃,编译期一声不吭。有了本表,
- * 每个 wire 键只有两条出路:**要么投影出去,要么在这里写下不投的理由**;新 wire 键在覆盖账那条
- * 腿上当场红,不给「悄悄没人管」留位置。
- */
 export declare const FLEET_TASK_ROW_KEYS_NOT_PROJECTED: Readonly<Record<string, NotProjectedEntry>>;
-/** workflow 行:wire 十键与视图十键一一同名同义 ⇒ 本表**空**(空不是「忘了填」,是覆盖账那条腿
- *  每跑一次都在证明它该空:少投一个键就红)。 */
 export declare const FLEET_WORKFLOW_ROW_KEYS_NOT_PROJECTED: Readonly<Record<string, NotProjectedEntry>>;