lark-remote 0.4.5 → 0.5.0

package/dist/runner/kimi/acp/runner.js

@@ -163,7 +163,7 @@ export class KimiAcpRunner extends BaseAcpRunner {
      */
     terminator = createTerminator({ graceMs: 2_000, agent: 'kimi' });
     /**
-     * shell seam：terminal/create 的可执行解析走这里（design.md §7.2）。kimi 的
+     * shell seam：terminal/create 的可执行解析走这里。kimi 的
      * ACP 服务端固定要 `bash -c`，win32 上没有 Git Bash 时必须在 seam 里变成
      * 明确错误，而不是一个语焉不详的 spawn ENOENT。
      */
@@ -224,7 +224,7 @@ export class KimiAcpRunner extends BaseAcpRunner {
         return new KimiAcpTranslator();
     }
     async applyTurnSettings(client, sessionId) {
-        // CC-07: 下发配置的模型（provider/model）。session/new|resume 只带 cwd/mcpServers，
+        // 下发配置的模型（provider/model）。session/new|resume 只带 cwd/mcpServers，
         // 不带 model；不主动下发则实际跑 kimi 服务端默认模型。
         // 仿 opencode 用 session/set_config_option。失败仅告警不阻断。
         if (this.model) {
@@ -239,7 +239,7 @@ export class KimiAcpRunner extends BaseAcpRunner {
                 getLogger().warn(`[${this.logTag}] set_config_option model failed (non-fatal): ${err.message}`);
             }
         }
-        // A5: 下发配置的思考强度。configId 与取值不是猜的——kimi 真机（0.43.1）
+        // 下发配置的思考强度。configId 与取值不是猜的——kimi 真机（0.43.1）
         // `session/new` 就通告 `{id:'thinking', category:'thought_level',
         // options:[low|high|max]}`，set 成功后响应里 `currentValue` 变成新值；
         // 未知 configId / 非法取值回 -32602（不静默接受），所以失败告警即可判定。
@@ -283,7 +283,7 @@ export class KimiAcpRunner extends BaseAcpRunner {
      * before producing the result. There is NO total timeout — silence beyond
      * compactIdleTimeoutMs yields 'unknown' (never a fake success). Keeps the
      * connection alive while the background compaction finishes — otherwise
-     * dispose/exit kills it and the record never lands (S5/S6 打回复现 /
+     * dispose/exit kills it and the record never lands (打回复现 /
      * 2026-08-31 事故).
      */
     compactBaseline(sessionId, opts) {
@@ -300,7 +300,7 @@ export class KimiAcpRunner extends BaseAcpRunner {
         const baselineTerminalCount = this.compactBaselineRecords.filter(isCompactionTerminalLike).length;
         let promptRejected = false;
         // prompt 结算只供两样东西：成功 result 的翻译素材（stopReason/usage）与 §5.4
-        // 探针。终态判定不再挂在它后面（A7）。
+        // 探针。终态判定不再挂在它后面。
         const promptSettled = promptPromise.then((result) => {
             this.promptSettled = true;
             if (compactionReader) {
@@ -326,7 +326,7 @@ export class KimiAcpRunner extends BaseAcpRunner {
             });
             return;
         }
-        // A7：语义等待在 prompt 触发的那一刻武装。引擎静默超过 compactIdleTimeoutMs
+        // 语义等待在 prompt 触发的那一刻武装。引擎静默超过 compactIdleTimeoutMs
         // 就给出 compact 语义终态，不等 session/prompt 结算——否则挂住的 prompt 会把
         // 用户拖到通用 turnIdleTimeout（默认 30min），拿到的还是一个语义泛化的 turn
         // 超时，而不是「压缩状态未知 / 可重试」。
@@ -372,7 +372,7 @@ export class KimiAcpRunner extends BaseAcpRunner {
         };
     }
     /**
-     * Hot-apply a permission-mode change to the live ACP session (§P5).
+     * Hot-apply a permission-mode change to the live ACP session.
      *
      * The local cache is always updated so `getStatusInfo()` (and therefore
      * `/s`) reflects the new mode immediately. When a session is connected,
@@ -553,14 +553,14 @@ export class KimiAcpRunner extends BaseAcpRunner {
             : undefined;
         const cwd = params.cwd ?? this.activeCwd ?? undefined;
         const outputLimit = params.outputByteLimit ?? TERMINAL_DEFAULT_OUTPUT_LIMIT;
-        // 走 shell seam（design.md §7.2）：argv 逐 token 保留，只把「可执行文件在哪」
+        // 走 shell seam：argv 逐 token 保留，只把「可执行文件在哪」
         // 收口——win32 上 Git Bash 缺失时在这里抛 ShellUnavailableError，由
         // handleTerminalRequest 转成明确的 Terminal request failed 回执，而不是一个
         // 语焉不详的 spawn ENOENT。
         const proc = this.shell.spawnArgv(params.command, params.args ?? [], {
             cwd,
             options: {
-                // env 覆盖大小写不敏感合并（win32 PATH/Path 双键防护，v2 §8.3）
+                // env 覆盖大小写不敏感合并（win32 PATH/Path 双键防护）
                 env: env ? mergeProcessEnv(process.env, env) : undefined,
                 stdio: ['ignore', 'pipe', 'pipe'],
                 // Terminator 用负 PID 杀进程组（kill(-pgid)）；子进程必须是组长

package/dist/runner/kimi/acp/translator.d.ts

@@ -8,12 +8,12 @@
  * accumulates text/thinking deltas and emits turn_diff snapshots (NOT
  * assistant deltas — see handleAgentMessageChunk), plus question elicitation.
  *
- * Wire envelope (R1, source: kimi-code packages/acp-server/src/events-map.ts,
+ * Wire envelope (source: kimi-code packages/acp-server/src/events-map.ts,
  * verified live 2026-08-15/16 against kimi 0.36.0):
  *   session/update params = {sessionId, update: {sessionUpdate: '<kind>', ...}}
  *   — the discriminator is `update.sessionUpdate`, NOT a nested `event.type`.
  *
- * Event mapping (design doc §4.2):
+ * Event mapping:
  *   agent_message_chunk   → turn_diff text snapshot (content.text accumulation)
  *   agent_thought_chunk   → turn_diff reasoning snapshot (content.text accumulation)
  *   tool_call / tool_call_update / usage_update / plan / control-plane noise →

package/dist/runner/kimi/acp/translator.js

@@ -8,12 +8,12 @@
  * accumulates text/thinking deltas and emits turn_diff snapshots (NOT
  * assistant deltas — see handleAgentMessageChunk), plus question elicitation.
  *
- * Wire envelope (R1, source: kimi-code packages/acp-server/src/events-map.ts,
+ * Wire envelope (source: kimi-code packages/acp-server/src/events-map.ts,
  * verified live 2026-08-15/16 against kimi 0.36.0):
  *   session/update params = {sessionId, update: {sessionUpdate: '<kind>', ...}}
  *   — the discriminator is `update.sessionUpdate`, NOT a nested `event.type`.
  *
- * Event mapping (design doc §4.2):
+ * Event mapping:
  *   agent_message_chunk   → turn_diff text snapshot (content.text accumulation)
  *   agent_thought_chunk   → turn_diff reasoning snapshot (content.text accumulation)
  *   tool_call / tool_call_update / usage_update / plan / control-plane noise →
@@ -53,7 +53,7 @@ export class KimiAcpTranslator extends BaseAcpTranslator {
         // Use a stable key for the current text stream. Kimi ACP doesn't
         // provide an itemId in agent_message_chunk; we use 'text' as the
         // single logical text accumulator (one text stream per turn).
-        // R1: wire chunk text lives at content.text and is a DELTA
+        // wire chunk text lives at content.text and is a DELTA
         // (kimi-code events-map.ts assistantDeltaToSessionUpdate:
         // content.text = event.delta), so we accumulate here into a full-text
         // snapshot and emit it as turn_diff. The card reducer's turn_diff path
@@ -145,7 +145,7 @@ export class KimiAcpTranslator extends BaseAcpTranslator {
                     : summary
                         ? truncateWithEllipsis(summary, 200)
                         : undefined,
-            // §P4: 从服务端 options kind 派生——带 approve_always（或 allow_always）
+            // 从服务端 options kind 派生——带 approve_always（或 allow_always）
             // 才提供「本会话总是允许」（acceptForSession）；否则与旧行为一致。
             availableDecisions: deriveAcpAvailableDecisions(params.options ?? []),
         };

package/dist/runner/opencode/acp/runner.d.ts

@@ -51,7 +51,7 @@ export interface OpencodeAcpRunnerOptions {
     errorMonitorPollIntervalMs?: number;
 }
 export declare class OpencodeAcpRunner extends BaseAcpRunner<OpencodeAcpTranslator> {
-    /** Configured session mode applied via session/set_mode (§P5). */
+    /** Configured session mode applied via session/set_mode. */
     private configuredMode;
     /** Current session mode id, parsed from session/new|resume configOptions. */
     private currentModeId?;
@@ -86,7 +86,7 @@ export declare class OpencodeAcpRunner extends BaseAcpRunner<OpencodeAcpTranslat
     protected buildApprovalOutcome(action: string, pending: AcpPendingApproval, _response: unknown): unknown;
     getStatusInfo(): AgentStatusInfo;
     /**
-     * Hot-apply a mode change to the live ACP session (§P5).
+     * Hot-apply a mode change to the live ACP session.
      *
      * opencode's session/set_mode sends no notification — the client refreshes
      * the local mode view itself. The local mode is always updated so

package/dist/runner/opencode/acp/runner.js

@@ -30,7 +30,7 @@ import { OpencodeLogErrorMonitor, resolveOpencodeLogPath } from './error-monitor
 // Runner
 // =============================================================================
 export class OpencodeAcpRunner extends BaseAcpRunner {
-    /** Configured session mode applied via session/set_mode (§P5). */
+    /** Configured session mode applied via session/set_mode. */
     configuredMode;
     /** Current session mode id, parsed from session/new|resume configOptions. */
     currentModeId;
@@ -103,7 +103,7 @@ export class OpencodeAcpRunner extends BaseAcpRunner {
         return new OpencodeAcpTranslator();
     }
     async applyTurnSettings(client, sessionId) {
-        // §P5: apply the configured mode (build/plan). If the session already
+        // apply the configured mode (build/plan). If the session already
         // runs it (from session/new|resume configOptions), skip the wire call;
         // otherwise send session/set_mode and refresh the local view (opencode
         // sends no notification for set_mode).
@@ -160,7 +160,7 @@ export class OpencodeAcpRunner extends BaseAcpRunner {
         };
     }
     /**
-     * Hot-apply a mode change to the live ACP session (§P5).
+     * Hot-apply a mode change to the live ACP session.
      *
      * opencode's session/set_mode sends no notification — the client refreshes
      * the local mode view itself. The local mode is always updated so

package/dist/runner/opencode/acp/translator.js

@@ -176,7 +176,7 @@ export class OpencodeAcpTranslator extends BaseAcpTranslator {
             kind: 'command',
             command: params.toolCall.title ?? undefined,
             reason: rawInput ? truncateWithEllipsis(stringify(rawInput), 200) : undefined,
-            // §P4: 从服务端 options kind 派生——带 allow_always（或 approve_always）
+            // 从服务端 options kind 派生——带 allow_always（或 approve_always）
             // 才提供「本会话总是允许」（acceptForSession）。
             availableDecisions: deriveAcpAvailableDecisions(params.options ?? []),
         };

package/dist/runner/pi/rpc/runner.js

@@ -53,7 +53,7 @@ export class PiRpcRunner extends ConnectionBasedRunner {
             idleTtlMs: opts.idleTtlMs,
             logTag: 'pi-rpc-connection-manager',
         });
-        // 协议停止通道（design §3.3）：pi 的 cancel 是 `{type:'abort'}` 通知，已由
+        // 协议停止通道：pi 的 cancel 是 `{type:'abort'}` 通知，已由
         // cancelCurrentTurn 实现；登记后 win32 优雅停止才有通道可用（否则一路树杀）。
         this.manager.stopper = ({ client }) => this.buildCooperativeStop(client);
     }
@@ -139,7 +139,7 @@ export class PiRpcRunner extends ConnectionBasedRunner {
         this.promptSettled = false;
         const response = await client.request({ type: 'prompt', message });
         if (!response.success) {
-            // CC-08: pi 返回 success:false（无效模型/provider 错误/忙）时立即失败，
+            // pi 返回 success:false（无效模型/provider 错误/忙）时立即失败，
             // 不能当成成功 ACK 继续等 agent_settled（否则最长 turn idle timeout）。
             throw new Error(`pi prompt failed: ${response.error ?? 'unknown error'}`);
         }

package/dist/runner/pi/rpc/translator.d.ts

@@ -32,7 +32,7 @@ export declare class PiRpcTranslator {
     private accReasoning;
     private lastTotalTokens;
     private hasUsage;
-    /** toolcall_start bookkeeping：占位不发事件，end 时补发完整 tool_use（C3.4）。 */
+    /** toolcall_start bookkeeping：占位不发事件，end 时补发完整 tool_use。 */
     private pendingToolCall;
     /** Provider failure (stopReason="error") on the final assistant message. */
     private lastAssistantStopReason;

package/dist/runner/pi/rpc/translator.js

@@ -23,7 +23,7 @@ export class PiRpcTranslator {
     accReasoning = 0;
     lastTotalTokens;
     hasUsage = false;
-    /** toolcall_start bookkeeping：占位不发事件，end 时补发完整 tool_use（C3.4）。 */
+    /** toolcall_start bookkeeping：占位不发事件，end 时补发完整 tool_use。 */
     pendingToolCall = false;
     /** Provider failure (stopReason="error") on the final assistant message. */
     lastAssistantStopReason;
@@ -98,7 +98,7 @@ export class PiRpcTranslator {
                 return [];
             }
             case 'compaction_start': {
-                // 信息保真 C3.4：压缩过程用户可见（info 通知），不再静默。
+                // 信息保真 压缩过程用户可见（info 通知），不再静默。
                 const c = evt;
                 return [
                     {
@@ -125,7 +125,7 @@ export class PiRpcTranslator {
             }
             default:
                 // turn_start/turn_end, agent_start/agent_end, tool_execution_*, and
-                // unknown types are ignored. (compaction_start/end 自 C3.4 起映射为
+                // unknown types are ignored. (compaction_start/end 映射为
                 // notice 事件，不再静默。)
                 return [];
         }
@@ -269,7 +269,7 @@ export class PiRpcTranslator {
                 }
                 break;
             case 'toolcall_start':
-                // 信息保真 C3.4：不再 push 空壳 tool_use（空 id/name 会被渲染成
+                // 信息保真 不再 push 空壳 tool_use（空 id/name 会被渲染成
                 // 无意义工具块）。只保留 bookkeeping，toolcall_end 补发完整事件。
                 this.pendingToolCall = true;
                 break;

package/dist/runner/types.d.ts

@@ -395,7 +395,7 @@ export interface Runner {
     killOrphan(): void;
     registerExitHandlers(): void;
     /**
-     * Remove the runner from the process-level exit dispatcher (P1-1). Called by
+     * Remove the runner from the process-level exit dispatcher. Called by
      * the bridge when the (cwd, kind) cache slot is evicted so the instance is
      * not retained by the singleton dispatcher. Optional so test stubs that only
      * satisfy `registerExitHandlers` remain structurally valid.

package/dist/session/claude/session-index.d.ts

@@ -5,11 +5,22 @@ export interface SessionIndexEntry {
     fingerprint: string;
     mtimeMs: number;
     summary: string;
+    /**
+     * cwd 判等键集合（PathKit.pathKey 归一形态，win32/darwin 大小写+分隔符
+     * 不敏感）：索引的 byCwd 倒排与 cwdSet.has 查询都按这个形态比对。注意与
+     * {@link parseSessionJsonl} 返回的 raw cwdSet 区分——后者保持 JSONL 原样，
+     * 归一只发生在索引边界（见 normalizeCwdSet）。
+     */
     cwdSet: Set<string>;
 }
 export interface SessionIndexOptions {
     /** Minimum interval between refresh scans (ms). Default 5000. */
     refreshIntervalMs?: number;
+    /**
+     * 平台注入（测试用）；默认当前宿主。cwd 判等键（pathKey）按它取归一口径，
+     * win32 语义（大小写 + `\`/`/` 分隔符不敏感）可在任意宿主上单测。
+     */
+    platform?: NodeJS.Platform;
 }
 /** Claude-specific field-name mapping for content block extraction. */
 export declare const CLAUDE_MAPPING: ContentBlockMapping;
@@ -57,6 +68,7 @@ export declare function buildFingerprint(filePath: string): string;
 export declare class SessionIndex {
     private readonly projectsDir;
     private readonly refreshIntervalMs;
+    private readonly platform;
     private readonly byPath;
     private readonly bySessionId;
     private readonly byCwd;

package/dist/session/claude/session-index.js

@@ -3,6 +3,8 @@ import path from 'node:path';
 import { scanJsonlLines } from '../common/jsonl.js';
 import { sortByRecencyDesc } from '../common/recency.js';
 import { extractContentBlocks } from '../common/content-blocks.js';
+import { pathKey } from '../../platform/path.js';
+import { currentPlatform } from '../../platform/select.js';
 import { getLogger } from '../../logger/index.js';
 // ─── Claude content block mapping (shared with sessions.ts) ─
 /** Claude-specific field-name mapping for content block extraction. */
@@ -115,6 +117,17 @@ export function buildFingerprint(filePath) {
     return parts.join('|');
 }
 // ─── SessionIndex ───────────────────────────────────────────
+/**
+ * raw cwd → pathKey 判等键。只允许在「解析结果进入索引」的边界调用：
+ * JSONL 里的 cwd 形态（大小写/分隔符/尾斜杠）由写方决定，与查询侧
+ * pathKey(cwd) 不保证逐字符一致（win32 尤甚），索引键控必须两侧同口径归一。
+ */
+function normalizeCwdSet(raw, platform) {
+    const out = new Set();
+    for (const cwd of raw)
+        out.add(pathKey(cwd, { platform }));
+    return out;
+}
 /**
  * In-memory session index with three query views:
  *   byPath:      path → entry
@@ -127,6 +140,7 @@ export function buildFingerprint(filePath) {
 export class SessionIndex {
     projectsDir;
     refreshIntervalMs;
+    platform;
     byPath = new Map();
     bySessionId = new Map();
     byCwd = new Map();
@@ -139,6 +153,7 @@ export class SessionIndex {
     constructor(projectsDir, opts = {}) {
         this.projectsDir = projectsDir;
         this.refreshIntervalMs = opts.refreshIntervalMs ?? 5000;
+        this.platform = opts.platform ?? currentPlatform;
     }
     /** Whether a full scan has ever completed successfully (readdir succeeded). */
     get isBuilt() {
@@ -162,7 +177,7 @@ export class SessionIndex {
     }
     // ── Query: listByCwd ────────────────────────────────────
     listByCwd(cwd, opts = {}) {
-        const paths = this.byCwd.get(cwd);
+        const paths = this.byCwd.get(pathKey(cwd, { platform: this.platform }));
         if (!paths || paths.size === 0)
             return [];
         // Gather entries, deduplicate by sessionId (keep mtime newest)
@@ -211,7 +226,7 @@ export class SessionIndex {
             }
             if (currentFp === entry.fingerprint) {
                 // Fingerprint matches → trust index
-                if (entry.cwdSet.has(cwd))
+                if (entry.cwdSet.has(pathKey(cwd, { platform: this.platform })))
                     return entry;
                 continue;
             }
@@ -226,11 +241,11 @@ export class SessionIndex {
                     fingerprint: currentFp,
                     mtimeMs: Number(st.mtimeMs),
                     summary: parsed.summary.replace(/\s+/g, ' ').trim(),
-                    cwdSet: parsed.cwdSet,
+                    cwdSet: normalizeCwdSet(parsed.cwdSet, this.platform),
                 };
                 this.updateEntry(p, updated);
                 // Re-check cwd after update
-                if (updated.cwdSet.has(cwd))
+                if (updated.cwdSet.has(pathKey(cwd, { platform: this.platform })))
                     return updated;
             }
             catch {
@@ -304,7 +319,7 @@ export class SessionIndex {
                         fingerprint: fpAfter,
                         mtimeMs: Number(fileStat.mtimeMs),
                         summary: parsed.summary.replace(/\s+/g, ' ').trim(),
-                        cwdSet: parsed.cwdSet,
+                        cwdSet: normalizeCwdSet(parsed.cwdSet, this.platform),
                     };
                     this.updateEntry(fullPath, newEntry);
                 }

package/dist/session/claude/sessions.js

@@ -30,7 +30,7 @@ function projectDirForCwd(cwd, projectsDir) {
  * to actually belong to the requested cwd. A relocated session contains
  * MULTIPLE cwd values (pre- and post-relocate) — accept when ANY `cwd` field
  * matches. Early-stops on the first match (findJsonlLine), keeping the
- * P2-2 single-pass parse-count anchors intact on the fallback path.
+ * single-pass parse-count anchors intact on the fallback path.
  * Regression 2026-08-04 EnterWorktree relocate.
  */
 function fileContainsCwd(filePath, cwd) {
@@ -109,8 +109,8 @@ function ensureSessionIndex(projectsDir) {
  * the project directory doesn't exist or no jsonl has a matching cwd field.
  */
 export function listClaudeSessions(cwd, opts = {}) {
-    // 不传 limit = 返回全集不切片；仅显式传值才 slice（契约迁移 plan §2.1，
-    // reader 拿全集算 total 后再自己按 offset/limit 切片）。
+    // 不传 limit = 返回全集不切片；仅显式传值才 slice
+    // reader 拿全集算 total 后再自己按 offset/limit 切片。
     const limit = opts.limit;
     const projectsDir = opts.projectsDir ?? defaultProjectsDir();
     const index = ensureSessionIndex(projectsDir);
@@ -218,7 +218,7 @@ export function isClaudeSessionActive(sessionId, cwd, opts = {}) {
     }
 }
 /**
- * P2-2 + P2-5 first-pass scan: stream the file once via `scanJsonlLines`
+ * first-pass scan: stream the file once via `scanJsonlLines`
  * (no `string[]` materialized), parse each line exactly once, and collect
  * all metadata needed by readSessionContent (usage, tailOffset, aiTitle,
  * recap, lastUserMessage). Does NOT retain parsed objects — the events tail
@@ -320,7 +320,7 @@ function scalarScan(filePath) {
     const l = acc.last;
     // contextLength = current context-window occupancy. Prefer compact_boundary
     // postTokens (the precise post-compact size); otherwise fall back to the
-    // last turn's input + cacheRead + cacheCreation (review P2-8 unified
+    // last turn's input + cacheRead + cacheCreation (unified
     // contract — excludes output/reasoning, which are generated, not part of
     // the input window). Take the max so a pre-compact turn larger than the
     // post-compact size is not under-reported.
@@ -353,12 +353,12 @@ function scalarScan(filePath) {
     };
 }
 /**
- * P2-2 + P2-5 second-pass tail mapper: expand one parsed tail line into
+ * second-pass tail mapper: expand one parsed tail line into
  * content-block events. Re-parses only tail lines (scanTailEvents does the
  * offset re-read + line filtering), so both raw line-string memory and
- * parsed-object memory are O(tail), not O(whole file) — P3-1 + P2-5.
+ * parsed-object memory are O(tail), not O(whole file) —.
  *
- * `maxEvents` capping (review P2-7 — unified "last N events" contract across
+ * `maxEvents` capping (unified "last N events" contract across
  * all readers) is applied by scanTailEvents.
  */
 function mapClaudeTailLine(obj) {
@@ -411,7 +411,7 @@ export function readSessionContent(sessionId, cwd, opts = {}) {
             return { events: [] };
         }
     }
-    // P2-2 + P3-1 + P2-5: First pass STREAMS the file once via
+    // First pass STREAMS the file once via
     // `scanJsonlLines` (no `string[]` materialized), parsing each line once to
     // collect scalars (usage, tailOffset, aiTitle, recap, lastUserMessage)
     // while retaining NO parsed objects and NO whole-file line array. The
@@ -425,7 +425,7 @@ export function readSessionContent(sessionId, cwd, opts = {}) {
     // full-file scan + tail re-parse of the usually-short post-user lines).
     // When the session has NO user message, tailOffset stays -1 and the tail
     // IS the whole file → scan(N) + tail(N) = 2.0× — the known asymptotic
-    // upper bound of the body's two-phase design (still better than pre-P2-2's
+    // upper bound of the body's two-phase design (still better than pre-'s
     // ~3×). Total parse count adds the index-miss fallback guard's fixed
     // early-stop overhead (~2 parses, independent of line count).
     const scan = scalarScan(filePath);

package/dist/session/codex/rollout-reader.d.ts

@@ -53,10 +53,10 @@ export declare function readCodexRollout(filePath: string): CodexRolloutEntry |
  * Returns `{ entries, total }`: `total` is the size of the full cwd-matched
  * set before pagination; `entries` are the newest `limit` entries by mtime.
  *
- * A global order over the full set is established first (plan §1.4: no early
+ * A global order over the full set is established first (no early
  * termination before ordering) using the lightweight session index — full
  * walk + first-line session_meta parse + stat mtime, 5s TTL cache. Only the
- * returned page is fully parsed for summary/usage (plan §2.2).
+ * returned page is fully parsed for summary/usage.
  */
 export declare function listCodexRollouts(opts?: ListCodexRolloutsOptions): {
     entries: CodexRolloutEntry[];
@@ -65,7 +65,7 @@ export declare function listCodexRollouts(opts?: ListCodexRolloutsOptions): {
 /**
  * Read the full content of a specific session by its threadId.
  *
- * P2-4: Uses session index for O(1) file lookup instead of walking the
+ * Uses session index for O(1) file lookup instead of walking the
  * entire directory tree and fully parsing every file. Only the matching
  * file is fully parsed.
  *
@@ -94,7 +94,7 @@ export declare function readCodexSessionSummary(sessionId: string, opts?: {
 /**
  * Check if a session is still active (recently updated).
  *
- * P2-4: Uses session index for direct file lookup, then checks mtime
+ * Uses session index for direct file lookup, then checks mtime
  * via statSync — no full rollout parse required. This reduces the
  * cost from "walk entire directory + full-parse every file" to a single
  * statSync call for the matching file.

package/dist/session/codex/rollout-reader.js

@@ -148,7 +148,7 @@ function scanCodexRollout(filePath, includeEvents) {
     // token_count 增量是 input/cached/output 全 0、只有 total_tokens 有值
     // （窗口被摘要+replacement history 占据），现有 zero-filter 会跳过它，
     // 因此这里必须单独捕获，不能复用 lastRawUsage。
-    // 单位口径（review P3-9）：前后两侧统一用 total_tokens —— 压缩前取最近一次
+    // 单位口径：前后两侧统一用 total_tokens —— 压缩前取最近一次
     // 非零 token_count 的 total_tokens（input+output，即该 turn 在窗口内的全部
     // token），压缩后取收尾事件的 total_tokens（压缩后窗口）。不得一边 input
     // 一边 total，否则「压缩前 X → 压缩后 Y」两边单位不一致。
@@ -279,7 +279,7 @@ function scanCodexRollout(filePath, includeEvents) {
  * (display-only, never added to total).
  * contextLength = input_tokens (= (input_tokens-cached) + cached + 0),
  * i.e. input + cacheRead + cacheCreation — the unified context-window
- * occupancy contract across all five readers (review P2-8, excludes
+ * occupancy contract across all five readers (excludes
  * output/reasoning).
  */
 function buildUsageFromScan(scan) {
@@ -325,10 +325,10 @@ function buildUsageFromScan(scan) {
  * Returns `{ entries, total }`: `total` is the size of the full cwd-matched
  * set before pagination; `entries` are the newest `limit` entries by mtime.
  *
- * A global order over the full set is established first (plan §1.4: no early
+ * A global order over the full set is established first (no early
  * termination before ordering) using the lightweight session index — full
  * walk + first-line session_meta parse + stat mtime, 5s TTL cache. Only the
- * returned page is fully parsed for summary/usage (plan §2.2).
+ * returned page is fully parsed for summary/usage.
  */
 export function listCodexRollouts(opts = {}) {
     const codexHome = resolveCodexHome(opts.codexHome);
@@ -338,7 +338,7 @@ export function listCodexRollouts(opts = {}) {
     const matched = [];
     for (const entry of index.values()) {
         // Subagent thread rollouts are part of a thread tree, not standalone
-        // sessions: exclude them explicitly (plan §2.1) so a pure-subagent
+        // sessions: exclude them explicitly so a pure-subagent
         // session (main file missing) never pollutes the list or total.
         if (entry.isSubagent)
             continue;
@@ -361,15 +361,15 @@ export function listCodexRollouts(opts = {}) {
     return { entries, total };
 }
 /**
- * W2.6 单源：三处（readCodexSessionContent / readCodexSessionSummary /
+ * 单源：三处（readCodexSessionContent / readCodexSessionSummary /
  * isCodexSessionActive）共用的「索引查找 + miss 强制刷新重查」。
  * cwd 守卫与 subagent 过滤语义各异，留在调用方。
  */
 function resolveRolloutEntry(sessionId, codexHome) {
-    // P2-4: Use session index for direct file lookup
+    // Use session index for direct file lookup
     let index = getSessionIndex(codexHome);
     let entry = index.get(sessionId);
-    // P3-2: On miss, the index may be stale (a rollout file created after the
+    // On miss, the index may be stale (a rollout file created after the
     // cache was built but within the 5s TTL). Force a refresh and recheck so a
     // brand-new session is found without waiting for TTL expiry.
     if (!entry) {
@@ -381,7 +381,7 @@ function resolveRolloutEntry(sessionId, codexHome) {
 /**
  * Read the full content of a specific session by its threadId.
  *
- * P2-4: Uses session index for O(1) file lookup instead of walking the
+ * Uses session index for O(1) file lookup instead of walking the
  * entire directory tree and fully parsing every file. Only the matching
  * file is fully parsed.
  *
@@ -457,7 +457,7 @@ export function readCodexSessionSummary(sessionId, opts = {}) {
 /**
  * Check if a session is still active (recently updated).
  *
- * P2-4: Uses session index for direct file lookup, then checks mtime
+ * Uses session index for direct file lookup, then checks mtime
  * via statSync — no full rollout parse required. This reduces the
  * cost from "walk entire directory + full-parse every file" to a single
  * statSync call for the matching file.
@@ -467,14 +467,14 @@ export function isCodexSessionActive(sessionId, opts = {}) {
     // Unify with the other readers' 1-hour stale window (claude/pi/opencode/kimi
     // all use STALE_MS). Previously codex used a divergent 10-minute default.
     const threshold = opts.activeThresholdMs ?? STALE_MS;
-    // P2-4: Use session index for direct file lookup + mtime check
+    // Use session index for direct file lookup + mtime check
     const entry = resolveRolloutEntry(sessionId, codexHome);
     if (!entry) {
         return false;
     }
     // Subagent thread rollouts are never "active sessions": their mtime
     // reflects thread-tree activity, not the parent session's liveness
-    // (plan §2.1). A pure-subagent session must report inactive.
+    // A pure-subagent session must report inactive.
     if (entry.isSubagent) {
         return false;
     }

package/dist/session/common/two-pass.js

@@ -1,6 +1,6 @@
 /**
- * Two-pass scan skeleton shared by the claude / pi session readers (P2-2 +
- * P2-5/P2-6 lineage): pass 1 STREAMS the whole file once via `scanJsonlLines`
+ * Two-pass scan skeleton shared by the claude / pi session readers (
+ * lineage): pass 1 STREAMS the whole file once via `scanJsonlLines`
  * (no `string[]` materialized), parsing each line exactly once to collect
  * scalars (usage, tail offset, title) while retaining NO parsed objects; pass
  * 2 re-reads ONLY the tail from the recorded offset and re-parses it for

package/dist/session/common/usage-accumulator.d.ts

@@ -55,13 +55,13 @@ export declare class UsageAccumulator {
      */
     bumpCompact(): void;
 }
-/** P2-8 统一契约：上下文窗口占用 = 末轮 input + cacheRead + cacheCreation（不含 output/reasoning）。 */
+/** 统一契约：上下文窗口占用 = 末轮 input + cacheRead + cacheCreation（不含 output/reasoning）。 */
 export declare function contextWindowOccupancy(l: {
     input: number;
     cacheRead: number;
     cacheCreation: number;
 }): number;
-/** P2-8 统一契约：session 全量累计字段组装（4 个 reader 共用：claude/dsh/kimi/pi；
+/** 统一契约：session 全量累计字段组装（4 个 reader 共用：claude/dsh/kimi/pi；
  * codex 走 last_token_usage 口径、opencode 保留自己的条件赋值，原为逐字段复制的 4 连拷贝）。 */
 export declare function cumulativeUsageFields(t: {
     input: number;

package/dist/session/common/usage-accumulator.js

@@ -69,11 +69,11 @@ export class UsageAccumulator {
         this._compactCount++;
     }
 }
-/** P2-8 统一契约：上下文窗口占用 = 末轮 input + cacheRead + cacheCreation（不含 output/reasoning）。 */
+/** 统一契约：上下文窗口占用 = 末轮 input + cacheRead + cacheCreation（不含 output/reasoning）。 */
 export function contextWindowOccupancy(l) {
     return l.input + l.cacheRead + l.cacheCreation;
 }
-/** P2-8 统一契约：session 全量累计字段组装（4 个 reader 共用：claude/dsh/kimi/pi；
+/** 统一契约：session 全量累计字段组装（4 个 reader 共用：claude/dsh/kimi/pi；
  * codex 走 last_token_usage 口径、opencode 保留自己的条件赋值，原为逐字段复制的 4 连拷贝）。 */
 export function cumulativeUsageFields(t) {
     return {

package/dist/session/dsh/sessions.js

@@ -21,7 +21,7 @@ import { samePath } from '../../platform/path.js';
 import { capEvents, paginate } from '../common/pagination.js';
 import { truncateUtf8, TOOL_RESULT_MAX_BYTES } from '../../common/truncate.js';
 /**
- * CC-05: history 拉取上限。DSH session.history 的 maxMessages 同时限制返回条数，
+ * history 拉取上限。DSH session.history 的 maxMessages 同时限制返回条数，
  * 若用它同时充当展示截断，>50 事件的会话累计 usage 会少算。这里拉取一个足够大的
  * 上限保证 usage 累加覆盖整个会话；展示仍由 capEvents(opts?.maxEvents ?? 50) 截断。
  * （若 DSH 支持分页 cursor 可改成分页，当前用有界大拉取）
@@ -159,7 +159,7 @@ export class DshSessionReader {
                 };
             }
             return {
-                // CC-05: 展示仍按 maxEvents 尾截断（默认 50，保持原行为），usage 已在上面基于
+                // 展示仍按 maxEvents 尾截断（默认 50，保持原行为），usage 已在上面基于
                 // 完整 history 累加。
                 events: capEvents(events, opts?.maxEvents ?? 50),
                 ...(sessionUsage ? { usage: sessionUsage } : {}),