lark-remote 0.4.4 → 0.5.0

package/dist/card/approval-render.d.ts

@@ -1,7 +1,7 @@
 /**
  * renderApprovalArea: renders the approval request area in a run card.
  *
- * Renders command/file/permissions approval areas with button mappings per §8.3.
+ * Renders command/file/permissions approval areas with button mappings.
  * Uses CardKit 2.0 (no tag:"action" container — 200861 rule).
  */
 import type { ApprovalView } from '../runner/types.js';

package/dist/card/approval-render.js

@@ -1,7 +1,7 @@
 /**
  * renderApprovalArea: renders the approval request area in a run card.
  *
- * Renders command/file/permissions approval areas with button mappings per §8.3.
+ * Renders command/file/permissions approval areas with button mappings.
  * Uses CardKit 2.0 (no tag:"action" container — 200861 rule).
  */
 import { collapsibleMarkdownPanel } from './collapsible.js';
@@ -13,7 +13,7 @@ function mkNonce() {
 }
 /** 计划面板正文字节预算（折叠展示 + 截断保护 28KB 卡片预算）。 */
 const PLAN_PANEL_BYTES = 6000;
-/** reason div（3 处共用）；反引号中和防 lark_md 解析错误（review P2-2）。 */
+/** reason div（3 处共用）；反引号中和防 lark_md 解析错误。 */
 function reasonDiv(approval) {
     if (!approval.reason)
         return null;
@@ -39,7 +39,7 @@ export function renderApprovalArea(approval, opts) {
     if (!approval)
         return [];
     // 终态（done/error/interrupted/idle_timeout）下 run 已结束：coordinator 已
-    // 释放，按钮点击无处响应，隐藏整个审批区避免"点了没反应"（P2-7）。
+    // 释放，按钮点击无处响应，隐藏整个审批区避免"点了没反应"。
     if (opts?.terminal && opts.terminal !== 'running' && opts.terminal !== 'finalizing') {
         return [];
     }
@@ -238,7 +238,7 @@ function renderPlanFeedbackInput(requestId, runId) {
 function renderCommandApproval(approval, expired, runId) {
     const elements = [];
     // Command display
-    // review P2-2：命令里的反引号会提前终止 lark_md 行内代码 span，奇数次
+    // 命令里的反引号会提前终止 lark_md 行内代码 span，奇数次
     // 反引号极易触发 11311 解析错误导致整卡失败（同 renderFileDiff 的中和策略）。
     const neutralizedCommand = (approval.command ?? '').replace(/`/g, '·');
     const cmdContent = neutralizedCommand
@@ -422,7 +422,7 @@ function renderQuestionApproval(approval, expired, runId) {
             elements.push(renderOptionRow(approval.requestId, i, option, isSelected, icon, runId));
         }
         // 自定义答案（Other）的选中态展示：选项按钮无法表示自由文本，单独显示
-        // 已选文本，避免「点了没反应」的困惑（review P3）。
+        // 已选文本，避免「点了没反应」的困惑。
         const customSelected = q.selected?.find((s) => !q.options.some((o) => o.label === s));
         if (customSelected) {
             elements.push({
@@ -430,7 +430,7 @@ function renderQuestionApproval(approval, expired, runId) {
                 text: { tag: 'lark_md', content: `✍️ 自定义答案：${customSelected}` },
             });
         }
-        // review P3-4：单选问题提供自定义答案（Other）输入——输入文本后提交
+        // 单选问题提供自定义答案（Other）输入——输入文本后提交
         // （移动端键盘回车/完成键，桌面端输入框右侧提交图标），input_value 经
         // connector raw 事件回传。
         // 显隐按 isOther !== false：Kimi form 会丢弃非声明选项值，翻译时置

package/dist/card/bash-card-session.d.ts

@@ -1,7 +1,7 @@
 import { CardSession, type CardChannel } from './card-session.js';
 import { type BashState, type BashRenderOptions } from './bash-renderer.js';
 /**
- * Store-time 输出上限（字符，P1-3 层①）。§P1-3 建议「store-time 截断，
+ * Store-time 输出上限（字符，层①）。建议「store-time 截断，
  * 保留尾部，上限如 24~64KB」——取区间下界 24_000 字符（字符上限 ×4 字节最坏
  * ~96KB/字段）。渲染层本就只展示尾部（bash-renderer 截断到 12KB 字节），store 截断
  * 不影响显示内容，只保证内存有界：!yes / !cat 大文件不再把全部输出驻留在 session
@@ -9,7 +9,7 @@ import { type BashState, type BashRenderOptions } from './bash-renderer.js';
  */
 export declare const BASH_OUTPUT_STORE_CAP = 24000;
 /**
- * Store-time 截断入口（P1-3 层①/层④共用）。bridge 本地 output/stderr 与 session
+ * Store-time 截断入口（层①/层④共用）。bridge 本地 output/stderr 与 session
  * state 都走它，保证任意路径驻留的字符串 ≤ BASH_OUTPUT_STORE_CAP 字符。
  * 调用方传入的 value 通常已 ≤ CAP（增量场景 output 恒 ≤ CAP，+chunk 后 ≤ CAP+chunk），
  * slice(-CAP) 成本 O(CAP+chunk)，不会把 O(n²) 截断问题带回桥接循环。
@@ -49,7 +49,7 @@ export declare class BashCardSession extends CardSession<BashState, BashRenderOp
         output?: string;
     }): Promise<void>;
     /**
-     * 合并 patch 并对 output/stderr 做 store-time 截断（P1-3 层①）。
+     * 合并 patch 并对 output/stderr 做 store-time 截断（层①）。
      * 截断发生在入口（store 时），渲染层无需再为大 state 付代价。
      */
     private applyCap;

package/dist/card/bash-card-session.js

@@ -2,7 +2,7 @@ import { CardSession } from './card-session.js';
 import { renderBashCard } from './bash-renderer.js';
 import { keepTail } from '../common/truncate.js';
 /**
- * Store-time 输出上限（字符，P1-3 层①）。§P1-3 建议「store-time 截断，
+ * Store-time 输出上限（字符，层①）。建议「store-time 截断，
  * 保留尾部，上限如 24~64KB」——取区间下界 24_000 字符（字符上限 ×4 字节最坏
  * ~96KB/字段）。渲染层本就只展示尾部（bash-renderer 截断到 12KB 字节），store 截断
  * 不影响显示内容，只保证内存有界：!yes / !cat 大文件不再把全部输出驻留在 session
@@ -10,7 +10,7 @@ import { keepTail } from '../common/truncate.js';
  */
 export const BASH_OUTPUT_STORE_CAP = 24_000;
 /**
- * Store-time 截断入口（P1-3 层①/层④共用）。bridge 本地 output/stderr 与 session
+ * Store-time 截断入口（层①/层④共用）。bridge 本地 output/stderr 与 session
  * state 都走它，保证任意路径驻留的字符串 ≤ BASH_OUTPUT_STORE_CAP 字符。
  * 调用方传入的 value 通常已 ≤ CAP（增量场景 output 恒 ≤ CAP，+chunk 后 ≤ CAP+chunk），
  * slice(-CAP) 成本 O(CAP+chunk)，不会把 O(n²) 截断问题带回桥接循环。
@@ -92,7 +92,7 @@ export class BashCardSession extends CardSession {
         this.release();
     }
     /**
-     * 合并 patch 并对 output/stderr 做 store-time 截断（P1-3 层①）。
+     * 合并 patch 并对 output/stderr 做 store-time 截断（层①）。
      * 截断发生在入口（store 时），渲染层无需再为大 state 付代价。
      */
     applyCap(patch) {

package/dist/card/bash-renderer.js

@@ -71,14 +71,14 @@ function assembleCard(state, elements) {
         schema: '2.0',
         config: { wide_screen_mode: true, update_multi: true },
         header: {
-            template: bashHeaderTemplate2(state.terminal),
-            title: { content: bashHeaderTitle2(state.terminal), tag: 'plain_text' },
+            template: bashHeaderTemplate(state.terminal),
+            title: { content: bashHeaderTitle(state.terminal), tag: 'plain_text' },
         },
         body: { elements },
     };
 }
 /**
- * Build output/stderr elements shared by normal & degraded paths (W2.3 单源）：
+ * Build output/stderr elements shared by normal & degraded paths (单源）：
  * 除截断预算（OUTPUT_MAX_BYTES / DEGRADED_OUTPUT_BYTES）外逐行同构。
  */
 function buildOutputElements(state, maxBytes) {
@@ -161,7 +161,7 @@ function bashStatusTagLabel(terminal, exitCode) {
     return '出错';
 }
 /** CardKit 2.0 header title */
-function bashHeaderTitle2(terminal) {
+function bashHeaderTitle(terminal) {
     if (terminal === 'running')
         return '💻 执行命令...';
     if (terminal === 'error')
@@ -171,7 +171,7 @@ function bashHeaderTitle2(terminal) {
     return '✅ 命令执行完成';
 }
 /** CardKit 2.0 header template */
-function bashHeaderTemplate2(terminal) {
+function bashHeaderTemplate(terminal) {
     return terminalToColor(terminal);
 }
 //# sourceMappingURL=bash-renderer.js.map

package/dist/card/card-session.d.ts

@@ -59,7 +59,7 @@ export declare abstract class CardSession<S, RO = unknown> {
      * 调度一次延迟 flush。已有 pending 调度则复用（合批核心）；否则起一个
      * coalesceMs 定时器。flushInFlight 期间不再起 timer（避免重入叠加），但置
      * pendingReschedule 以便 in-flight flush 完成后重新调度——否则 in-flight 期间
-     * 到达的 push/update 会停留为 stale 中间帧（P2-1）。
+     * 到达的 push/update 会停留为 stale 中间帧。
      */
     protected scheduleFlush(): void;
     /**
@@ -87,14 +87,14 @@ export declare abstract class CardSession<S, RO = unknown> {
     /** The messageId of the streaming card, available after `start()` resolves. */
     get cardMessageId(): string | undefined;
     /**
-     * P1-3 合批窗口（ms）。连续事件各触发一次全卡 render + patch 是流式 CPU 主要
+     * 合批窗口（ms）。连续事件各触发一次全卡 render + patch 是流式 CPU 主要
      * 来源；窗口内多个事件复用同一次延迟 flush。窗口大小可通过 constructor 覆盖
      * （测试用小窗口/0 禁用）。run/bash 子类共用的 flush 骨架（scheduleFlush/flush/
      * cancelPendingFlush/settle）下沉到基类。
      */
     protected readonly coalesceMs: number;
     private flushTimer;
-    private flushInFlight; /** P2-1：in-flight flush 期间到达的 push/update 标记。scheduleFlush 在
+    private flushInFlight; /** in-flight flush 期间到达的 push/update 标记。scheduleFlush 在
      *  flushInFlight 时早退不调度新 timer，但事件已 reduce 进 state；若无此标志，
      *  in-flight flush 完成后该事件无 follow-up render，停留为 stale 中间帧。
      *  finally 检查此标志后重新 scheduleFlush，保证 in-flight 期间累积的事件最终被渲染。 */
@@ -102,7 +102,7 @@ export declare abstract class CardSession<S, RO = unknown> {
     /** 当前 in-flight flush 的 promise（若 flush 正在 await updateCard）。
      *  finish() 在终态 patch 前 await 它，保证 in-flight 的 pre-terminal patch 先落地、
      *  terminal patch 后落地——否则两条 controller.update 并发无 FIFO，
-     *  pre-terminal 可能在 terminal 之后 resolve 留下"思考中"终帧（P2）。 */
+     *  pre-terminal 可能在 terminal 之后 resolve 留下"思考中"终帧。 */
     protected flushP: Promise<void> | undefined;
     start(): Promise<void>;
     settle(): Promise<StreamSettleResult>;

package/dist/card/card-session.js

@@ -46,7 +46,7 @@ export class CardSession {
      * 调度一次延迟 flush。已有 pending 调度则复用（合批核心）；否则起一个
      * coalesceMs 定时器。flushInFlight 期间不再起 timer（避免重入叠加），但置
      * pendingReschedule 以便 in-flight flush 完成后重新调度——否则 in-flight 期间
-     * 到达的 push/update 会停留为 stale 中间帧（P2-1）。
+     * 到达的 push/update 会停留为 stale 中间帧。
      */
     scheduleFlush() {
         if (this.flushTimer)
@@ -82,7 +82,7 @@ export class CardSession {
                 this.flushInFlight = false;
                 // flushInFlight 守卫保证同一时刻只有一个 in-flight flush，故可无条件清空。
                 this.flushP = undefined;
-                // P2-1：in-flight 期间若有 push/update 到达（pendingReschedule），重新调度一次
+                // in-flight 期间若有 push/update 到达（pendingReschedule），重新调度一次
                 // flush 渲染累积事件，避免 stale 中间帧。终态守卫在 flush() 入口已拦截，
                 // 故 finish 后不会误触发。
                 if (this.pendingReschedule) {
@@ -117,14 +117,14 @@ export class CardSession {
         return this.messageId;
     }
     /**
-     * P1-3 合批窗口（ms）。连续事件各触发一次全卡 render + patch 是流式 CPU 主要
+     * 合批窗口（ms）。连续事件各触发一次全卡 render + patch 是流式 CPU 主要
      * 来源；窗口内多个事件复用同一次延迟 flush。窗口大小可通过 constructor 覆盖
      * （测试用小窗口/0 禁用）。run/bash 子类共用的 flush 骨架（scheduleFlush/flush/
      * cancelPendingFlush/settle）下沉到基类。
      */
     coalesceMs;
     flushTimer;
-    flushInFlight = false; /** P2-1：in-flight flush 期间到达的 push/update 标记。scheduleFlush 在
+    flushInFlight = false; /** in-flight flush 期间到达的 push/update 标记。scheduleFlush 在
      *  flushInFlight 时早退不调度新 timer，但事件已 reduce 进 state；若无此标志，
      *  in-flight flush 完成后该事件无 follow-up render，停留为 stale 中间帧。
      *  finally 检查此标志后重新 scheduleFlush，保证 in-flight 期间累积的事件最终被渲染。 */
@@ -132,7 +132,7 @@ export class CardSession {
     /** 当前 in-flight flush 的 promise（若 flush 正在 await updateCard）。
      *  finish() 在终态 patch 前 await 它，保证 in-flight 的 pre-terminal patch 先落地、
      *  terminal patch 后落地——否则两条 controller.update 并发无 FIFO，
-     *  pre-terminal 可能在 terminal 之后 resolve 留下"思考中"终帧（P2）。 */
+     *  pre-terminal 可能在 terminal 之后 resolve 留下"思考中"终帧。 */
     flushP;
     async start() {
         if (this.streamOutcome) {
@@ -158,7 +158,7 @@ export class CardSession {
         // the controller is ready — by which time events pushed before the
         // producer ran (see test_anchor_events_before_controller_ready_...) have
         // already updated `this.state`. Reusing the initial card here would drop
-        // those early events. The P3-7 "reuse first render" optimization was
+        // those early events. The"reuse first render" optimization was
         // rejected for this reason (premise "two renders with identical input"
         // does not hold).
         const stream = this.connector.streamCard(this.chatId, this.safeRenderCard(), async (controller) => {

package/dist/card/card-shared.d.ts

@@ -34,7 +34,7 @@ export declare function newSessionButton(): object;
 /**
  * Create a CardKit 2.0 Compact button for any runCompact-capable runner
  * (codex/kimi/opencode/pi/claude，鸭子类型 `'runCompact' in runner` 探测）。
- * Triggers the compact flow via the codex.compact callback（handler 按
+ * Triggers the compact flow via the compact callback（handler 按
  * runId 解析 agentKind，claude 走 stream-json 内建 /compact）。
  */
 export declare function compactButton(runId: string): object;

package/dist/card/card-shared.js

@@ -84,11 +84,11 @@ export function newSessionButton() {
 /**
  * Create a CardKit 2.0 Compact button for any runCompact-capable runner
  * (codex/kimi/opencode/pi/claude，鸭子类型 `'runCompact' in runner` 探测）。
- * Triggers the compact flow via the codex.compact callback（handler 按
+ * Triggers the compact flow via the compact callback（handler 按
  * runId 解析 agentKind，claude 走 stream-json 内建 /compact）。
  */
 export function compactButton(runId) {
-    return cardButton('🗜 Compact', { cmd: 'codex.compact', runId }, { type: 'primary' });
+    return cardButton('🗜 Compact', { cmd: 'compact', runId }, { type: 'primary' });
 }
 /**
  * Create a CardKit 2.0 Compact button for resume cards (auto-resume / `/resume <id>`).

package/dist/card/run-card-session.js

@@ -36,7 +36,7 @@ export class RunCardSession extends CardSession {
     async push(event) {
         // state 每事件立即 reduce（始终最新），但 updateCard 延迟到合批窗口末尾。
         // 窗口内多次 push 复用同一 flushTimer，只 render + controller.update 一次
-        // （P1-3）。push 立即 resolve（fire-and-forget render）—— bridge 串行
+        // push 立即 resolve（fire-and-forget render）—— bridge 串行
         // await 不被 render 阻塞，循环快速灌入事件，多个事件落进同一窗口被合并。
         //
         // 首 push 也走窗口（无 immediate-first-flush）：start() 已发初始卡（streaming
@@ -55,7 +55,7 @@ export class RunCardSession extends CardSession {
         this.cancelPendingFlush();
         // 若有 in-flight flush 正在 await updateCard，必须等它完成后再发终态 patch。
         // 否则两条并发 controller.update 无 FIFO 保证，in-flight 的 pre-terminal
-        // patch 可能在终态 patch 之后 resolve → 用户看到"思考中"终帧（P2）。
+        // patch 可能在终态 patch 之后 resolve → 用户看到"思考中"终帧。
         // await 保证顺序：pre-terminal 先落地 → terminal 后落地 → terminal 胜出。
         if (this.flushP)
             await this.flushP;

package/dist/card/run-renderer.d.ts

@@ -37,7 +37,7 @@ type BlockGroup = {
     diff?: string;
     timestamp?: string;
 };
-/** 每个块的截断后内容（thinking/plan/text），测量与渲染共用（P1-2 建议项）。 */
+/** 每个块的截断后内容（thinking/plan/text），测量与渲染共用（建议项）。 */
 type GroupContentPrepared = Map<BlockGroup, string>;
 /** 导出供测试断言估算精度（估算 ≈ 实际渲染字节，见 tests/anchor/run-card/run-card.test.ts）。 */
 export declare function estimateCardBytes(state: RunState, options?: RunCardRenderOptions, shared?: {

package/dist/card/run-renderer.js

@@ -3,7 +3,7 @@ import { collapsibleMarkdownPanel, markdownDiv } from './collapsible.js';
 import { toolBodyMd, toolHeaderText } from './tool-render.js';
 import { truncateUtf8, truncateMarkdownTables, CARD_BUDGET_BYTES } from './text-truncate.js';
 import { formatTimestamp } from './time.js';
-import { formatUsageStats } from '../router/utils.js';
+import { formatUsageStats } from '../router/usage-format.js';
 import { renderApprovalArea } from './approval-render.js';
 const REASONING_BYTES = 4_500;
 const TEXT_BYTES = 10_000;
@@ -16,7 +16,7 @@ const EXTREME_TOOL_KEEP = 1; // Extreme: keep last 1 tool panel
 // 影子测量：估算 = 精确复刻 normal 路径将要渲染的 JSON 字节。面板外壳、statusRow、
 // summary、header、按钮全部实测（measureJson），块内容经与渲染相同的变换
 // （truncateUtf8 截断 + markdownDiv 的 escapeMarkdown + JSON.stringify）精确测量，
-// 不依赖任何转义因子或拍脑袋常数（P1-2 第二轮：CJK/ASCII 转义双向精确）。
+// 不依赖任何转义因子或拍脑袋常数（第二轮：CJK/ASCII 转义双向精确）。
 const DEGRADED_THRESHOLD = 24_000; // 估算低于此值走正常路径（留 4KB 裕度，相对 CARD_BUDGET_BYTES=28000）；否则直接 degraded。调整时同步评估裕度是否仍覆盖估算偏差
 /** 精确测量对象经 JSON.stringify 后的 UTF-8 字节数。 */
 function measureJson(obj) {
@@ -275,7 +275,7 @@ function actionButtonList(state, options) {
     actionButtons.push(newSessionButton());
     return actionButtons;
 }
-/** Bottom action row: spacer + column_set of actionButtonList (估算与渲染共用，W2.2）。 */
+/** Bottom action row: spacer + column_set of actionButtonList (估算与渲染共用）。 */
 function actionRow(state, options) {
     const actionButtons = actionButtonList(state, options);
     if (actionButtons.length === 0)
@@ -293,7 +293,7 @@ function actionRow(state, options) {
     ];
 }
 /** 审批区位于 body 最底部（底部操作行之后）：待审批时决策按钮不遮挡内容流。
- *  例外：skeleton 兜底路径中 approvalArea 在 actionRow 之前（信息保真 C4.3），
+ *  例外：skeleton 兜底路径中 approvalArea 在 actionRow 之前（信息保真），
  *  保证极端降级时审批入口与 stop/new-session 按钮同时可见。 */
 function approvalArea(state) {
     const elements = [];
@@ -306,7 +306,7 @@ function approvalArea(state) {
     }
     return elements;
 }
-/** 底部操作行之前的内容区提示：被 MAX_BLOCKS 截掉的早期块计数（信息保真 C4.1）。 */
+/** 底部操作行之前的内容区提示：被 MAX_BLOCKS 截掉的早期块计数（信息保真）。 */
 function omittedBlocksHint(state) {
     return state.omittedBlocks !== undefined && state.omittedBlocks > 0
         ? [markdownDiv(`_💡 已省略 ${state.omittedBlocks} 个早期步骤_`)]
@@ -318,8 +318,8 @@ function assembleRunCard(state, options, elements) {
         schema: '2.0',
         config: { wide_screen_mode: true, update_multi: true },
         header: {
-            template: headerTemplate2(state),
-            title: { content: headerTitle2(state, options), tag: 'plain_text' },
+            template: headerTemplate(state),
+            title: { content: headerTitle(state, options), tag: 'plain_text' },
         },
         body: { elements },
     };
@@ -346,7 +346,7 @@ function buildFallbackElements(state, options, tier) {
     if (toolsOmitted > 0) {
         elements.push(markdownDiv(`_💡 另外 ${toolsOmitted} 个工具调用已省略_`));
     }
-    // P2-6: use object references (like the extreme path) instead of timestamps.
+    // use object references (like the extreme path) instead of timestamps.
     // RunBlock.timestamp has millisecond precision; ≥2 thinking blocks sharing a
     // timestamp collapse to one Set entry, so `has(block.timestamp)` lets ALL
     // same-timestamp blocks (including ones meant to be omitted) pass through —
@@ -364,7 +364,7 @@ function buildFallbackElements(state, options, tier) {
         }
         return true; // keep all non-thinking, non-tool blocks
     });
-    // 信息保真 C4.2：plan/file_change 块在降级路径不渲染内容（正常路径已可见，
+    // 信息保真 plan/file_change 块在降级路径不渲染内容（正常路径已可见，
     // 降级预算紧张），但必须计数留痕，禁止静默丢弃。
     // 计数在渲染前完成，提示与 thinking/tool 省略提示一并置于卡片顶部——不能等
     // 内容循环结束再追加，否则提示会落在最后一条输出之后，打乱「输出收尾」观感。
@@ -467,7 +467,7 @@ function buildSkeletonElements(state, options) {
     elements.push(markdownDiv('_⚠️ 输出过大且含大量转义字符，已省略全部内容以避免超限；完整内容请查日志_'));
     // Summary (token stats etc.) — static, bounded size
     elements.push(...buildSummaryContent(state));
-    // 信息保真 C4.3：skeleton 也渲染审批区——极端兜底不丢审批入口
+    // 信息保真 skeleton 也渲染审批区——极端兜底不丢审批入口
     //（待审批被静默吞掉 = 用户永远看不到审批请求）。
     elements.push(...approvalArea(state));
     // Bottom action row: stop (if running/finalizing) + compact (if applicable) + new session (always).
@@ -514,7 +514,7 @@ function bucketThinkingAndTool(blocks) {
  * 到 degraded（安全网不丢）。
  */
 /**
- * W2.2 镜像对单源：thinking/plan/file_change 三个 collapsible 面板组的
+ * 镜像对单源：thinking/plan/file_change 三个 collapsible 面板组的
  * { title, expanded, border, content } 描述，估算（measurePanelBytes）与渲染
  * （collapsibleMarkdownPanel）共用——此前同一套标题/opIcon/内容模板写两遍。
  * text（renderTextBlock）与 tool（renderTool）形态特殊，由调用方各自处理；
@@ -552,19 +552,19 @@ function describePanelGroup(group, prepared) {
 /** 导出供测试断言估算精度（估算 ≈ 实际渲染字节，见 tests/anchor/run-card/run-card.test.ts）。 */
 export function estimateCardBytes(state, options = {}, shared) {
     const finalized = state.terminal !== 'running';
-    // P1-2：renderRunCard 传入共享 groups/prepared 时直接复用（截断只做一次）；
+    // renderRunCard 传入共享 groups/prepared 时直接复用（截断只做一次）；
     // 独立调用（测试/预算探针）时自建，行为与原先一致。
     const groups = shared?.groups ?? groupBlocks(state.blocks);
     const prepared = shared?.prepared ?? prepareGroupContent(groups);
     // 卡片外壳直接实测 assembleRunCard 空元素产物（schema/config/header/body 结构
-    // 与正式渲染完全一致，W2.2）；status/summary/操作行同样实测渲染结构。
+    // 与正式渲染完全一致）；status/summary/操作行同样实测渲染结构。
     // 注：审批区（approvalArea）不参与估算——待审批通常在途且体积小，超预算由
     // renderRunCard 的 stringify 兜底捕获。
     let total = measureJson(assembleRunCard(state, options, [])) +
         measureJson(statusRow(state)) +
         measureJson(buildSummaryContent(state, { includeNotices: false })) +
         measureJson(actionRow(state, options));
-    // 块内容：与 buildChronologicalContent 同源（describePanelGroup 单源，W2.2）
+    // 块内容：与 buildChronologicalContent 同源（describePanelGroup 单源）
     let renderedAny = false;
     for (const group of groups) {
         if (group.kind === 'tool') {
@@ -620,7 +620,7 @@ function measurePanelBytes(title, expanded, border, content) {
  */
 export function renderRunCard(state, options = {}) {
     // 先估后建：用廉价估算预测是否超 28KB 预算，明显超预算直接跳过完整卡构建走
-    // degraded。P1-2：groups/prepared 只算一次，测量与正式渲染共用同一份截断结果，
+    // degraded。groups/prepared 只算一次，测量与正式渲染共用同一份截断结果，
     // 避免影子测量 + 正式渲染对每个超限块双倍截断。
     const groups = groupBlocks(state.blocks);
     const prepared = prepareGroupContent(groups);
@@ -680,9 +680,9 @@ function buildChronologicalContent(state, prepared, groups) {
     const elements = [];
     // finalized = 非 running（含 finalizing：主结果已出，thinking 折叠）
     const finalized = state.terminal !== 'running';
-    // P1-2：renderRunCard 传入同一 groups 数组时直接复用（prepared 的键是组对象
+    // renderRunCard 传入同一 groups 数组时直接复用（prepared 的键是组对象
     // 引用，重建数组会让 prepared.get 永远 miss，退化为二次截断）。
-    // W2.2：面板组描述经 describePanelGroup 与估算共享同一份模板。
+    // 面板组描述经 describePanelGroup 与估算共享同一份模板。
     // notices 作为普通消息按到达时间插入内容流（有内容时不再沉到 summary）。
     const contentItems = mergeNoticesIntoContent(groups, state.notices);
     for (const item of contentItems) {
@@ -762,7 +762,7 @@ function buildSummaryContent(state, options = {}) {
         // 压缩（operationKind='compaction'）不会返回 agent 正文——引擎只压缩上下文
         // 窗口，空内容属正常，不能沿用普通 run 的「（未返回内容）」异常信号
         // （2026-09 用户反馈）。所有会压缩的 agent（codex/claude/kimi/opencode/pi）
-        // 都经 streamCodexCompact 走这条共享渲染路径，一处覆盖全部。
+        // 都经 streamCompact 走这条共享渲染路径，一处覆盖全部。
         const empty = hasContent
             ? ''
             : state.operationKind === 'compaction'
@@ -802,9 +802,9 @@ function buildDurationInfo(state) {
     // 与标题一致：审批等待期间状态行显示「等待审批中」，而不是「工具调用中」。
     if (hasPendingApproval(state))
         return '✋ 等待审批中';
-    return footerText2(state.footer);
+    return footerText(state.footer);
 }
-function footerText2(footer) {
+function footerText(footer) {
     if (footer === 'tool_running')
         return '🧰 工具调用中';
     if (footer === 'streaming')
@@ -816,7 +816,7 @@ function statusTagLabel(terminal) {
     return terminalToLabel(terminal);
 }
 /** CardKit 2.0 header title — agent-aware via options.agentKind. */
-function headerTitle2(state, options = {}) {
+function headerTitle(state, options = {}) {
     const agent = agentDisplayName(options.agentKind ?? 'claude');
     if (state.terminal === 'done')
         return `✅ ${agent} · 已完成`;
@@ -845,7 +845,7 @@ function hasPendingApproval(state) {
     return (state.approvals ?? []).some((a) => !a.expired);
 }
 /** CardKit 2.0 header template color */
-function headerTemplate2(state) {
+function headerTemplate(state) {
     return terminalToColor(state.terminal);
 }
 //# sourceMappingURL=run-renderer.js.map

package/dist/card/run-state.d.ts

@@ -9,7 +9,7 @@ export interface ToolEntry {
     name: string;
     input: unknown;
     /**
-     * P3-6: cached parse of `input` (the truncated string) into a record, so
+     * cached parse of `input` (the truncated string) into a record, so
      * `tool-render.ts`'s `asRecord` does not re-`JSON.parse` on every render.
      * Computed once at store time in `reduceAssistantEvent` from the SAME
      * truncated string that the old per-render `asRecord` parsed — so a
@@ -121,7 +121,7 @@ export interface RunState {
     /** 压缩前上下文水位（codex compact 卡展示「压缩前 X → 压缩后 Y」）。 */
     compactPreContextLength?: number;
     /**
-     * 待审批请求列表（app-server 模式，review P2-3）。同一 turn 内并发多个审批
+     * 待审批请求列表（app-server 模式）。同一 turn 内并发多个审批
      * 时全部渲染，避免后到者顶掉先到者的按钮（单槽会丢 UI，只能等超时 cancel）。
      */
     approvals?: Array<{

package/dist/card/run-state.js

@@ -382,7 +382,7 @@ function reduceAssistantEvent(state, event) {
             };
         }
         else {
-            // P3-6: parse the truncated stored string ONCE here (not on every render)
+            // parse the truncated stored string ONCE here (not on every render)
             // and cache the result on `parsedInput`. tool-render's asRecord then hits
             // the object branch with zero parsing. The parse uses the SAME truncated
             // string as the old per-render parse, so truncation-broken JSON still
@@ -450,7 +450,7 @@ function mergeToolUse(existing, incoming) {
     };
 }
 /** Handle tool_result content blocks (user message with tool results).
- *  P3-4: rebuild ONLY the block matching `tool_use_id`, copying every other
+ *  rebuild ONLY the block matching `tool_use_id`, copying every other
  *  block by reference. The old `.map()` recreated all block objects per
  *  tool_result (O(N) allocations on the run-card hot path). Footer still
  *  advances to 'streaming' on every content block (parity with old behavior);
@@ -605,7 +605,7 @@ function stringifyUnknown(value) {
     }
 }
 /**
- * P3-6: parse a (possibly truncated) string into a record, mirroring what
+ * parse a (possibly truncated) string into a record, mirroring what
  * `tool-render.ts`'s `asRecord` did on every render. Returns `null` when the
  * string is empty, non-JSON, or parses to a non-object — so a truncation-broken
  * JSON yields `null` exactly as the old per-render parse did. Computed once at

package/dist/card/tool-render.d.ts

@@ -20,7 +20,7 @@ export declare function toolHeaderText(tool: ToolEntry): string;
 /**
  * Structured body markdown for a tool call. Renders input fields by tool name
  * (Bash → command, Read/Edit/Write → file_path, etc.) and output in a code
- * block. An explicit `toolHint` (declared by the runner, 信息保真 C5) selects
+ * block. An explicit `toolHint` (declared by the runner, 信息保真) selects
  * the same rendering by family instead of name. There is no raw-JSON fallback
  * for unknown tools: `default` returns '' and unknown tools only surface their
  * args through the panel header's `summarizeInput` fallback.

package/dist/card/tool-render.js

@@ -29,13 +29,13 @@ const BODY_TOTAL_MAX = 2500;
  */
 export function toolHeaderText(tool) {
     const icon = tool.status === 'ok' ? '✅' : tool.status === 'error' ? '❌' : '⏳';
-    // P3-6: use the cached parsed record when available (avoids per-render parse).
+    // use the cached parsed record when available (avoids per-render parse).
     const input = tool.parsedInput !== undefined ? tool.parsedInput : tool.input;
     const summary = summarizeInput(tool.name, input);
-    // 信息保真 C3.1：ACP kind 映射后 name 与原始 title 不同时，title 以
+    // 信息保真 ACP kind 映射后 name 与原始 title 不同时，title 以
     // ` — {summary}` 追加在标题末尾（截断沿用 HEADER_SUMMARY_MAX）。
     // 用 truncate（suffix 为空）而非裸 slice：裸 slice 按 UTF-16 码元切，
-    // 切点落在 emoji 代理对中间会留下孤立代理项（P2-31 同族）。
+    // 切点落在 emoji 代理对中间会留下孤立代理项（同族）。
     const blockSummary = tool.summary
         ? truncate(tool.summary.replace(/\s+/g, ' ').trim(), HEADER_SUMMARY_MAX, { suffix: '' })
         : '';
@@ -51,7 +51,7 @@ export function toolHeaderText(tool) {
 /**
  * Structured body markdown for a tool call. Renders input fields by tool name
  * (Bash → command, Read/Edit/Write → file_path, etc.) and output in a code
- * block. An explicit `toolHint` (declared by the runner, 信息保真 C5) selects
+ * block. An explicit `toolHint` (declared by the runner, 信息保真) selects
  * the same rendering by family instead of name. There is no raw-JSON fallback
  * for unknown tools: `default` returns '' and unknown tools only surface their
  * args through the panel header's `summarizeInput` fallback.
@@ -156,13 +156,13 @@ function renderWebSearchInput(str) {
     return str('query') ? `**Query** \`${truncate(str('query'), BODY_FIELD_MAX)}\`` : '';
 }
 function renderInput(tool) {
-    // P3-6: use the cached parsed record when available (avoids per-render parse).
+    // use the cached parsed record when available (avoids per-render parse).
     const input = tool.parsedInput !== undefined ? tool.parsedInput : tool.input;
     const rec = asRecord(input);
     if (!rec)
         return '';
     const str = (k) => (typeof rec[k] === 'string' ? rec[k] : '');
-    // 信息保真 C5：hint 优先（runner 自愿声明，只消费不推断）；缺失时与现状
+    // 信息保真 hint 优先（runner 自愿声明，只消费不推断）；缺失时与现状
     // 完全一致。hint 分支与 name case 共用同一渲染函数，无复制粘贴。
     switch (tool.toolHint) {
         case 'shell':

package/dist/cli.js

@@ -2,9 +2,8 @@
 /**
  * CLI 引导层（bootstrap）：在 import 应用模块图之前决定运行时（bun/node）并拉起它。
  *
- * **这是全仓唯一被认可的 spawn 收口例外**（即 AGENTS.md「子进程 spawn 只走
- * platform/spawn.ts」红线的显式豁免）。三个理由缺一不可：
- *   1. 时序：preflight（Node 版本守卫、-v/-h/--advance-help）必须在 import 应用
+ *XX * 缺一不可：
+ *   1. 时序：preflight（Node 版本守卫、-v/-h/--advanced-help）必须在 import 应用
  *      模块图之前跑完——dist/cli.js 刻意不使用 ES2020+ 语法以便在 node 12 上仍
  *      可被解析，而 dist/index.js 是 ES2022；先 import platform/spawn 就等于先把
  *      应用模块图拖进来，守卫当场失效（报错堆栈全落在 Node 内部）。
@@ -20,7 +19,7 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { spawn, spawnSync } from 'node:child_process';
 import { fileURLToPath, pathToFileURL } from 'node:url';
-import { printAdvanceHelp, printHelp, printVersion } from './config/dir.js';
+import { printAdvancedHelp, printHelp, printVersion } from './config/dir.js';
 const entryUrl = new URL('./index.js', import.meta.url);
 const entry = fileURLToPath(entryUrl);
 /**
@@ -49,8 +48,8 @@ export function handlePreflight(args, nodeVersion = process.versions.node) {
             printHelp();
             return 0;
         }
-        if (arg === '--advance-help') {
-            printAdvanceHelp();
+        if (arg === '--advanced-help') {
+            printAdvancedHelp();
             return 0;
         }
     }