lark-remote 0.1.2 → 0.1.4

package/CHANGELOG.md

@@ -5,6 +5,67 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.1.4] - 2026-08-13
+
+### 新增
+
+- 工作区列表支持 `lastUsedAt` 排序，最近使用的 workspace 排在前面；排序切换 UI 移至卡片上方，明确显示当前模式与切换目标
+- `/config` 卡片：未安装的 Coding Agent 沉底排序，已安装 agent 保持注册顺序；探测结果过期（`undefined`）时保持原位不误沉底
+
+### 修复
+
+- `/ws`、`/order` 卡片分页降为 15 条/页，修复飞书 ErrCode 11310 元素超限
+- workspace 排序相关 P2/P3 review findings 修复
+
+## [0.1.3] - 2026-08-12
+
+### 新增
+
+- Agent 可用性探测：启动时自动检测本机已安装/可用的 Agent CLI（`which` 探测），不可用的 Agent 会在 `/config` 卡片中标注；探测失败不阻塞启动，打开 `/config` 时会重试
+- 首次运行引导：PIN 绑定成功后自动设置默认工作目录，并发送欢迎卡片 + 帮助卡片
+- `message.patch` 业务码可观测性探针
+- Context 统计支持显示占比：codex 上报 `context window` 上限时，卡片按百分比展示上下文用量
+
+### 修复
+
+- `displayTitle`/`summary` 跳过 task-notification 注入
+- 修复 `scanClaudeSessions` 对迁移到其他目录的会话的遗漏（S2）
+- 修复 probe 生命周期、工厂回退、卡片回调等评审发现的问题（F1-F8）
+- 清理引用已删除文档（lessons-redlines、resume-card-budget-failure-analysis）导致的失效链接
+
+### 变更
+
+- 提取 `createAgentRegistries` 工厂，统一各 Agent 注册逻辑
+- 移除 Agent 二进制路径配置，CLI 名称改为硬编码
+- 移除 `pnpm-lock.yaml`，统一使用 `bun.lock` 管理依赖
+- 新增 husky lint-staged pre-commit / pre-push 钩子（提交前 lint + typecheck）
+- 启用 npm provenance（构建产物可溯源）
+- 移除 watchdog 相关用户文档及 `open-source-playbook` 等临时文档
+
+### 测试
+
+- 合并 stub 工厂、净化 fixtures、移除冗余测试
+- 新增 P1-15 configContainer 锚点测试（含 codex 负向断言）
+
+## [0.1.2] - 2026-08-10
+
+### 修复
+
+- claude / opencode / kimi 的 Agent 工厂改为从 `configContainer` 读取配置，避免使用过期闭包导致配置不生效（P1-15）
+- codex / kimi 的 `readSessionContent` 增加 cwd 校验，防止越界读取会话
+- `listClaudeSessions` / `isClaudeSessionActive` 支持跨目录回退，处理会话迁移后的定位
+- 修复 `handleQueueInput` 竞态：替换任务在 await 之前注册
+- 完成卡片 `resume.use` 携带 agent 字段，确保会话 reader 路由正确
+
+### 维护
+
+- 升级 `@vitest/coverage-v8` 至 4.1.10
+- 移除 CLI 子进程 smoke test，清理测试套件
+
+## [0.1.1] - 2026-08-09
+
+版本号 0.1.0 → 0.1.1，无用户可见功能变更。
+
 ## [0.1.0] - 2026-08-06
 
 Initial release.
@@ -50,3 +111,7 @@ Initial release.
 - Live Feishu API tests gated behind `FEISHU_LIVE_TEST=1` (external contributors can run full test suite without credentials)
 
 [0.1.0]: https://github.com/bungabungawoda/lark-remote/releases/tag/v0.1.0
+[0.1.1]: https://github.com/bungabungawoda/lark-remote/releases/tag/v0.1.1
+[0.1.2]: https://github.com/bungabungawoda/lark-remote/releases/tag/v0.1.2
+[0.1.3]: https://github.com/bungabungawoda/lark-remote/releases/tag/v0.1.3
+[0.1.4]: https://github.com/bungabungawoda/lark-remote/releases/tag/v0.1.4

package/README.en.md

@@ -64,7 +64,6 @@ feishu:
 defaultAgent: claude
 
 claude:
-  binary: claude
   model: claude-opus-4-8
   effort: medium            # low | medium | high | xhigh | max
   # permissionMode is hardcoded to bypassPermissions (inside the runner)
@@ -79,7 +78,7 @@ logging:
   level: info               # debug | info | warn | error
 
 idle:
-  watchdogMinutes: 15       # 0 disables the idle watchdog
+  watchdogMinutes: 15       # 0 disables the idle timeout auto-stop
 ```
 
 Override the config directory with `--config-dir <path>`; override the Claude settings path with `--settings <path>` or the `CLAUDE_SETTINGS_PATH` environment variable.
@@ -98,8 +97,6 @@ lark-remote --settings ~/.claude/settings.json  # specify Claude settings file
 
 The bridge prints nothing to the terminal after startup; logs go to `~/.lark-remote/logs/YYYY-MM-DD/lark-remote-<pid>.log` (rotated daily, one subdirectory per day). Only one `lark-remote` instance is allowed per `configDir` — a duplicate start fails with the existing pid. After connecting to Feishu, a startup notification (with start time and pid) is sent to the most recent private chat.
 
-For automatic process restart, set up your own supervisor such as systemd, launchd, or pm2.
-
 Each agent run creates one CardKit 2.0 card that updates in place with thinking, body text, and tool summaries in real time.
 Timestamps are read from the JSONL and shown in local time as `YYYY-MM-DD HH:mm` for thinking, body, tool call/result, and session history events.
 The card clearly shows completion, error, interruption, or idle timeout at the end; the in-card "⏹ Stop" button is equivalent to `/stop`.
@@ -152,7 +149,7 @@ Full docs under [`docs/`](docs/):
 - Single-card streaming architecture and Feishu acceptance: [`docs/en/architecture/streaming-card.md`](docs/en/architecture/streaming-card.md)
 - Template for adding a new agent: [`docs/en/guides/add-new-agent.md`](docs/en/guides/add-new-agent.md)
 - Codex config card guide: [`docs/en/guides/codex-config.md`](docs/en/guides/codex-config.md)
-- Feishu CardKit 2.0 component reference: [Feishu Open Platform official docs](https://open.feishu.cn/document/feishu-cards/card-json-v2-components/component-json-v2-overview)
+- Feishu CardKit 2.0 component reference: [Official Feishu docs](https://open.feishu.cn/document/feishu-cards/card-json-v2-components/component-json-v2-overview)
 - AI collaboration rules and red lines: [`CLAUDE.md`](CLAUDE.md)
 
 > This package is a CLI tool only — no programmatic API is exposed.

package/README.md

@@ -64,7 +64,6 @@ feishu:
 defaultAgent: claude
 
 claude:
-  binary: claude
   model: claude-opus-4-8
   effort: medium            # low | medium | high | xhigh | max
   # permissionMode 硬编码为 bypassPermissions（runner 内部）
@@ -79,7 +78,7 @@ logging:
   level: info               # debug | info | warn | error
 
 idle:
-  watchdogMinutes: 15       # 0 关闭空闲看门狗
+  watchdogMinutes: 15       # 0 关闭空闲超时自动停止
 ```
 
 配置目录可用 `--config-dir <path>` 覆盖；Claude settings 路径可用 `--settings <path>` 或 `CLAUDE_SETTINGS_PATH` 环境变量覆盖。
@@ -98,8 +97,6 @@ lark-remote --settings ~/.claude/settings.json  # 指定 Claude 配置文件
 
 bridge 启动后不在终端输出，运行日志写入 `~/.lark-remote/logs/YYYY-MM-DD/lark-remote-<pid>.log`（按日期轮转，每天一个子目录）。同一 `configDir` 只允许一个 `lark-remote` 实例，重复启动会直接报错并提示已有 pid。连接飞书成功后会向最近私聊用户发送启动通知，包含启动时间和进程号。
 
-如需进程自动重启，可自行配置 systemd / launchd / pm2 等守护方案。
-
 每次 agent 运行会创建一张 CardKit 2.0 卡片，并在原地实时更新 thinking、正文和工具摘要。
 卡片会读取 JSONL 的 `timestamp`，以本地时间 `YYYY-MM-DD HH:mm` 显示 thinking、正文、tool call/result 和会话历史事件。
 结束时卡片明确显示完成、出错、中断或空闲超时；运行中的「⏹ 终止」按钮与 `/stop` 等价。

package/dist/bridge/index.d.ts

@@ -57,7 +57,11 @@ interface BridgeDeps {
     /** Workspace store for fallback when sessionStore has no cwd */
     workspaceStore?: {
         get(name: string): string | undefined;
-        list(): [string, string][];
+        list(): Array<{
+            name: string;
+            path: string;
+            lastUsedAt: number;
+        }>;
     };
     /** Override the idle watchdog timeout (default 15 min). Tests use a small value. */
     idleTimeoutMs?: number;

package/dist/bridge/index.js

@@ -542,7 +542,9 @@ export class Bridge {
         if (!cwd && this.workspaceStore) {
             const workspaces = this.workspaceStore.list();
             if (workspaces.length > 0) {
-                cwd = workspaces[0][1];
+                // NOTE: fallback uses insertion order, not sort preference — by design
+                // (workspace-sorting.md §9: cwd fallback stays insertion-order for now)
+                cwd = workspaces[0].path;
                 getLogger().info(`[bridge] resolveCwd fallback cwd=${cwd} (first saved workspace)`);
             }
         }
@@ -652,6 +654,7 @@ export class Bridge {
         // Final usage read from jsonl after the run completes. live stream-json does
         // not emit compact_boundary, so the live contextLength is unreliable.
         let finalContextLength;
+        let finalContextLimit;
         let finalCompactCount;
         let finalCacheReadTokens;
         let finalCacheCreationTokens;
@@ -825,6 +828,7 @@ export class Bridge {
                 ? undefined
                 : this.resolveFinalUsage(finalSessionId, cwd, agentKind);
             finalContextLength = finalUsage?.contextLength ?? contextLength;
+            finalContextLimit = finalUsage?.contextLimit;
             finalCompactCount = finalUsage?.compactCount;
             finalCumulativeTotalTokens = finalUsage?.cumulativeTotalTokens;
             finalCumulativeInputTokens = finalUsage?.cumulativeInputTokens;
@@ -858,7 +862,7 @@ export class Bridge {
                 finalCacheCreationTokens = finalUsage?.cacheCreationTokens ?? finalCacheCreationTokens;
                 finalTotalTokens = finalUsage?.totalTokens ?? finalTotalTokens;
             }
-            getLogger().info(`[bridge] final usage runId=${runId} contextLength=${finalContextLength} compactCount=${finalCompactCount ?? 'undefined'} cacheRead=${finalCacheReadTokens ?? 'undefined'} cacheCreate=${finalCacheCreationTokens ?? 'undefined'}`);
+            getLogger().info(`[bridge] final usage runId=${runId} contextLength=${finalContextLength} contextLimit=${finalContextLimit ?? 'undefined'} compactCount=${finalCompactCount ?? 'undefined'} cacheRead=${finalCacheReadTokens ?? 'undefined'} cacheCreate=${finalCacheCreationTokens ?? 'undefined'}`);
             // for-await 自然结束 = stream 关闭 = CLI 进程退出。
             // 进程退出（for-await end）= 唯一终态触发源。
             // 1) finalizing（result 已收到）-> 转 done/error + usage meta
@@ -871,6 +875,7 @@ export class Bridge {
                     resultSubtype: finalState.resultSubtype,
                     errorMsg: finalState.errorMsg,
                     contextLength: finalContextLength,
+                    contextLimit: finalContextLimit,
                     compactCount: finalCompactCount,
                     cacheReadTokens: finalCacheReadTokens,
                     cacheCreationTokens: finalCacheCreationTokens,
@@ -887,6 +892,7 @@ export class Bridge {
             else if (finalState.terminal === 'running') {
                 await cardSession.finish('error', {
                     contextLength: finalContextLength,
+                    contextLimit: finalContextLimit,
                     compactCount: finalCompactCount,
                     cacheReadTokens: finalCacheReadTokens,
                     cacheCreationTokens: finalCacheCreationTokens,
@@ -906,6 +912,7 @@ export class Bridge {
                 // 仅补充 usage meta（finalizing 期间被 /stop 或 idle 超时也展示 token 统计）
                 await cardSession.finish(finalState.terminal, {
                     contextLength: finalContextLength,
+                    contextLimit: finalContextLimit,
                     compactCount: finalCompactCount,
                     cacheReadTokens: finalCacheReadTokens,
                     cacheCreationTokens: finalCacheCreationTokens,
@@ -937,6 +944,7 @@ export class Bridge {
             if (catchTerminal === 'running' || catchTerminal === 'finalizing') {
                 await cardSession.finish('error', {
                     contextLength: finalContextLength,
+                    contextLimit: finalContextLimit,
                     compactCount: finalCompactCount,
                     cacheReadTokens: finalCacheReadTokens,
                     cacheCreationTokens: finalCacheCreationTokens,
@@ -954,6 +962,7 @@ export class Bridge {
                 if (sawResult) {
                     await cardSession.finish(catchTerminal, {
                         contextLength: finalContextLength,
+                        contextLimit: finalContextLimit,
                         compactCount: finalCompactCount,
                         cacheReadTokens: finalCacheReadTokens,
                         cacheCreationTokens: finalCacheCreationTokens,
@@ -1048,6 +1057,7 @@ export class Bridge {
             return content.usage
                 ? {
                     contextLength: content.usage.contextLength,
+                    contextLimit: content.usage.contextLimit,
                     compactCount: content.usage.compactCount,
                     cacheReadTokens: content.usage.cacheReadTokens,
                     cacheCreationTokens: content.usage.cacheCreationTokens,

package/dist/card/card-budget.js

@@ -46,8 +46,7 @@ export function enforceCardBudget(card, opts = {}) {
  * when table truncation alone doesn't bring the card under the byte limit.
  *
  * 裁剪判定是**结构化**的：所有 collapsible_panel 都是待裁剪对象，不看面板
- * 标题文本。历史教训（2026-08-08，详见
- * docs/zh/architecture/resume-card-budget-failure-analysis.md）：旧实现用
+ * 标题文本。历史教训（2026-08-08）：旧实现用
  * emoji 标题模式（🤖👤💭🔧🟢🔴）识别「会话事件面板」，但真实
  * sessionEventPanel 产出的标题是裸英文 type 名（emoji 在事件正文而非标题），
  * 导致裁剪阶段对真实 resume 卡零命中，任何 >28KB 的卡片无裁剪直通极端降级，

package/dist/card/run-renderer.js

@@ -776,6 +776,7 @@ function buildSummaryContent(state) {
         const empty = !hasContent ? '\n\n（未返回内容）' : '';
         const usageStatsStr = formatUsageStats({
             contextLength: state.contextLength,
+            contextLimit: state.contextLimit,
             compactCount: state.compactCount,
             cacheReadTokens: state.cacheReadTokens,
             cacheCreationTokens: state.cacheCreationTokens,

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

@@ -53,6 +53,8 @@ export interface RunState {
     sessionId?: string;
     resultSubtype?: 'success' | 'error';
     contextLength?: number;
+    /** 当前模型 context window 上限（codex jsonl 提供）；卡片据此渲染百分比。 */
+    contextLimit?: number;
     errorMsg?: string;
     idleTimeoutMinutes?: number;
     compactCount?: number;
@@ -79,6 +81,8 @@ export interface RunState {
 export interface FinishMeta {
     resultSubtype?: 'success' | 'error';
     contextLength?: number;
+    /** 当前模型 context window 上限；透传到 RunState 供 done 卡片显示百分比。 */
+    contextLimit?: number;
     errorMsg?: string;
     idleTimeoutMinutes?: number;
     compactCount?: number;

package/dist/config/codex-config.d.ts

@@ -76,7 +76,7 @@ export declare function parseCodexModelsOutput(stdout: string): BundledModelInfo
  * （P3-4/P3-15/P3-5）；成功结果 TTL 1h，失败/空结果短 TTL 负缓存；stat 异常时
  * 指纹为空（P1-1/P3-10）。
  */
-export declare function getCodexCatalogModels(binary: string, codexHome?: string): BundledModelInfo[];
+export declare function getCodexCatalogModels(codexHome?: string): BundledModelInfo[];
 /**
  * Test utility: clear the catalog cache. Tests that exercise the bundled
  * command path (`--bundled`) directly use `invalidateCodexBundledTestCache`
@@ -88,18 +88,16 @@ export declare function invalidateCodexBundledCache(): void;
  * @param codexHome 可选 codex 配置目录覆盖（与 loadCodexConfig 的 codexHome 对齐，
  *   与 loadCodexConfig 的 codexHome 对齐）；省略时走 $CODEX_HOME → ~/.codex。
  */
-export declare function getReasoningEffortOptions(model: string, binary?: string, codexHome?: string): readonly string[];
+export declare function getReasoningEffortOptions(model: string, codexHome?: string): readonly string[];
 /**
  * Get default reasoning effort for a model.
  * 未声明/未知模型 → undefined（codex 语义：ModelPreset.default_reasoning_effort
  * unwrap_or(ReasoningEffort::None)，即不传 effort；P3-12）。
  */
-export declare function getDefaultReasoningEffort(model: string, binary?: string, codexHome?: string): string | undefined;
+export declare function getDefaultReasoningEffort(model: string, codexHome?: string): string | undefined;
 interface LoadCodexConfigOpts {
     /** Explicit codex home override. Default: $CODEX_HOME -> ~/.codex */
     codexHome?: string;
-    /** codex binary path, for `debug models --bundled`. Default: 'codex' */
-    binary?: string;
 }
 /**
  * Read codex config.toml, extract provider and model info

package/dist/config/codex-config.js

@@ -154,7 +154,8 @@ export function parseCodexModelsOutput(stdout) {
  * （P3-4/P3-15/P3-5）；成功结果 TTL 1h，失败/空结果短 TTL 负缓存；stat 异常时
  * 指纹为空（P1-1/P3-10）。
  */
-export function getCodexCatalogModels(binary, codexHome) {
+export function getCodexCatalogModels(codexHome) {
+    const binary = 'codex';
     const home = resolveCodexHome(codexHome);
     const catalogPath = readModelCatalogJsonPath(home);
     const bundled = catalogPath === undefined || catalogPath === TOML_PARSE_FAILED_SENTINEL;
@@ -217,8 +218,8 @@ export function invalidateCodexBundledCache() {
  * @param codexHome 可选 codex 配置目录覆盖（与 loadCodexConfig 的 codexHome 对齐，
  *   与 loadCodexConfig 的 codexHome 对齐）；省略时走 $CODEX_HOME → ~/.codex。
  */
-export function getReasoningEffortOptions(model, binary = 'codex', codexHome) {
-    const models = getCodexCatalogModels(binary, codexHome);
+export function getReasoningEffortOptions(model, codexHome) {
+    const models = getCodexCatalogModels(codexHome);
     const found = models.find((m) => m.slug === model);
     // 未命中（含未知模型，codex fallback 元数据 supported 为空）→ []，不虚构档位（P1）
     return found?.supportedReasoningLevels ?? [];
@@ -228,8 +229,8 @@ export function getReasoningEffortOptions(model, binary = 'codex', codexHome) {
  * 未声明/未知模型 → undefined（codex 语义：ModelPreset.default_reasoning_effort
  * unwrap_or(ReasoningEffort::None)，即不传 effort；P3-12）。
  */
-export function getDefaultReasoningEffort(model, binary = 'codex', codexHome) {
-    const models = getCodexCatalogModels(binary, codexHome);
+export function getDefaultReasoningEffort(model, codexHome) {
+    const models = getCodexCatalogModels(codexHome);
     return models.find((m) => m.slug === model)?.defaultReasoningLevel;
 }
 /**
@@ -249,13 +250,12 @@ function extractCustomProvider(providers) {
  * - anthropic: bundled models with 'claude-*' prefix
  */
 export function loadCodexConfig(opts = {}) {
-    const binary = opts.binary ?? 'codex';
     const codexHome = resolveCodexHome(opts.codexHome);
     const configFile = path.join(codexHome, 'config.toml');
     const catalogMode = isCodexCatalogMode(codexHome);
     // 统一目录来源：catalog 模式 = 活动目录（model_catalog_json 整体替换内置目录）；
     // 否则 = bundled（与原行为一致）
-    const catalogSlugs = getCodexCatalogModels(binary, codexHome).map((m) => m.slug);
+    const catalogSlugs = getCodexCatalogModels(codexHome).map((m) => m.slug);
     const allModels = catalogSlugs.length > 0 ? catalogSlugs : FALLBACK_MODELS;
     const anthropicModels = allModels.filter((m) => m.startsWith('claude-'));
     if (!fs.existsSync(configFile)) {

package/dist/config/dir.d.ts

@@ -1,6 +1,7 @@
 interface CliArgs {
     configDir?: string;
     settings?: string;
+    dev?: boolean;
     help?: boolean;
     version?: boolean;
 }

package/dist/config/dir.js

@@ -49,6 +49,9 @@ export function parseCliArgs(args = process.argv.slice(2)) {
                 result.settings = args[++i];
             }
         }
+        else if (arg === '--dev') {
+            result.dev = true;
+        }
     }
     return result;
 }
@@ -73,6 +76,7 @@ export function printHelp() {
         'Options:',
         '  --config-dir <path>   自定义配置目录（默认 ~/.lark-remote，可用于同机多实例）',
         '  --settings <path>     指定 Claude 配置文件路径',
+        '  --dev                 开发模式：标记从源码 bun src/index.ts 启动（看门狗据此选择拉起方式）',
         '  -h, --help            显示本帮助信息',
         '  -v, --version         显示版本号',
     ];

package/dist/config/index.d.ts

@@ -15,7 +15,6 @@ export declare const MODEL_ID_TO_ALIAS: Record<string, string>;
 /** alias → model ID 反向映射。 */
 export declare const MODEL_ALIAS_TO_ID: Record<string, string>;
 declare const ClaudeConfigSchema: z.ZodObject<{
-    binary: z.ZodDefault<z.ZodString>;
     model: z.ZodDefault<z.ZodString>;
     effort: z.ZodDefault<z.ZodEnum<{
         medium: "medium";
@@ -28,7 +27,6 @@ declare const ClaudeConfigSchema: z.ZodObject<{
 }, z.core.$strip>;
 /** Codex-specific configuration. */
 export declare const CodexConfigSchema: z.ZodObject<{
-    binary: z.ZodDefault<z.ZodString>;
     model: z.ZodOptional<z.ZodString>;
     modelProvider: z.ZodOptional<z.ZodString>;
     reasoningEffort: z.ZodOptional<z.ZodString>;
@@ -36,13 +34,11 @@ export declare const CodexConfigSchema: z.ZodObject<{
 }, z.core.$strip>;
 /** OpenCode-specific configuration (run mode: opencode run --format json --auto). */
 declare const OpencodeConfigSchema: z.ZodObject<{
-    binary: z.ZodDefault<z.ZodString>;
     providerID: z.ZodDefault<z.ZodString>;
     modelID: z.ZodDefault<z.ZodString>;
 }, z.core.$strip>;
 /** Pi-specific configuration. pi is a spawn-per-message CLI like Claude. */
 declare const PiConfigSchema: z.ZodObject<{
-    binary: z.ZodDefault<z.ZodString>;
     provider: z.ZodDefault<z.ZodString>;
     model: z.ZodDefault<z.ZodString>;
     thinking: z.ZodDefault<z.ZodEnum<{
@@ -57,7 +53,6 @@ declare const PiConfigSchema: z.ZodObject<{
 }, z.core.$strip>;
 /** Kimi-specific configuration. kimi is a spawn-per-message CLI. */
 declare const KimiConfigSchema: z.ZodObject<{
-    binary: z.ZodDefault<z.ZodString>;
     model: z.ZodDefault<z.ZodString>;
     thinkingEffort: z.ZodDefault<z.ZodEnum<{
         max: "max";
@@ -71,7 +66,6 @@ export declare const AppConfigSchema: z.ZodObject<{
         appSecret: z.ZodString;
     }, z.core.$strip>;
     claude: z.ZodDefault<z.ZodObject<{
-        binary: z.ZodDefault<z.ZodString>;
         model: z.ZodDefault<z.ZodString>;
         effort: z.ZodDefault<z.ZodEnum<{
             medium: "medium";
@@ -84,19 +78,16 @@ export declare const AppConfigSchema: z.ZodObject<{
     }, z.core.$strip>>;
     agents: z.ZodOptional<z.ZodObject<{
         codex: z.ZodOptional<z.ZodObject<{
-            binary: z.ZodDefault<z.ZodString>;
             model: z.ZodOptional<z.ZodString>;
             modelProvider: z.ZodOptional<z.ZodString>;
             reasoningEffort: z.ZodOptional<z.ZodString>;
             stopGraceMs: z.ZodDefault<z.ZodNumber>;
         }, z.core.$strip>>;
         opencode: z.ZodOptional<z.ZodObject<{
-            binary: z.ZodDefault<z.ZodString>;
             providerID: z.ZodDefault<z.ZodString>;
             modelID: z.ZodDefault<z.ZodString>;
         }, z.core.$strip>>;
         pi: z.ZodOptional<z.ZodObject<{
-            binary: z.ZodDefault<z.ZodString>;
             provider: z.ZodDefault<z.ZodString>;
             model: z.ZodDefault<z.ZodString>;
             thinking: z.ZodDefault<z.ZodEnum<{
@@ -110,7 +101,6 @@ export declare const AppConfigSchema: z.ZodObject<{
             tools: z.ZodDefault<z.ZodString>;
         }, z.core.$strip>>;
         kimi: z.ZodOptional<z.ZodObject<{
-            binary: z.ZodDefault<z.ZodString>;
             model: z.ZodDefault<z.ZodString>;
             thinkingEffort: z.ZodDefault<z.ZodEnum<{
                 max: "max";

package/dist/config/index.js

@@ -13,7 +13,6 @@ export const CLAUDE_EFFORTS = ['low', 'medium', 'high', 'xhigh', 'max'];
 export const PI_THINKING_LEVELS = ['off', 'minimal', 'low', 'medium', 'high', 'xhigh'];
 /** 默认值常量：schema 与 template 共享，避免双源不一致（G25 Magic Numbers）。 */
 const DEFAULTS = {
-    CLAUDE_BINARY: 'claude',
     CLAUDE_MODEL: 'claude-opus-4-8',
     STOP_GRACE_MS: 5000,
     IDLE_WATCHDOG_MINUTES: 15,
@@ -43,7 +42,6 @@ const FeishuConfigSchema = z.object({
     appSecret: z.string().min(1),
 });
 const ClaudeConfigSchema = z.object({
-    binary: z.string().default(DEFAULTS.CLAUDE_BINARY),
     model: z.string().default(DEFAULTS.CLAUDE_MODEL),
     effort: z.enum(CLAUDE_EFFORTS).default('medium'),
     // permissionMode 硬编码为 bypassPermissions（runner 内部），不通过 config 配置
@@ -51,8 +49,6 @@ const ClaudeConfigSchema = z.object({
 });
 /** Codex-specific configuration. */
 export const CodexConfigSchema = z.object({
-    /** Path to codex binary. Default: 'codex' (in PATH). */
-    binary: z.string().default('codex'),
     /** model to use. Undefined → codex reads from its config.toml. */
     model: z.string().optional(),
     /** model provider, e.g. 'volcengine-coding-plan'. Undefined → codex reads from its config.toml. */
@@ -70,8 +66,6 @@ export const CodexConfigSchema = z.object({
 });
 /** OpenCode-specific configuration (run mode: opencode run --format json --auto). */
 const OpencodeConfigSchema = z.object({
-    /** Path to opencode binary. Default: 'opencode' (in PATH). */
-    binary: z.string().default('opencode'),
     /** Provider ID for the LLM backend (e.g. 'anthropic'). */
     providerID: z.string().default('anthropic'),
     /** Model ID for the LLM backend (e.g. 'claude-sonnet-4-20250514'). */
@@ -79,8 +73,6 @@ const OpencodeConfigSchema = z.object({
 });
 /** Pi-specific configuration. pi is a spawn-per-message CLI like Claude. */
 const PiConfigSchema = z.object({
-    /** Path to pi binary. Default: 'pi' (in PATH). */
-    binary: z.string().default('pi'),
     /** LLM provider, e.g. 'Volcano', 'anthropic', 'openai'. */
     provider: z.string().default('Volcano'),
     /** Model ID or alias, e.g. 'glm-5.2'. */
@@ -92,8 +84,6 @@ const PiConfigSchema = z.object({
 });
 /** Kimi-specific configuration. kimi is a spawn-per-message CLI. */
 const KimiConfigSchema = z.object({
-    /** Path to kimi binary. Default: 'kimi' (in PATH). */
-    binary: z.string().default('kimi'),
     /** Model ID or alias, e.g. 'kimi-code/k3'. */
     model: z.string().default('kimi-code/k3'),
     /** Thinking effort: 'on', 'max'. */
@@ -169,7 +159,6 @@ const TEMPLATE = `feishu:
   appSecret: ""
 
 claude:
-  binary: ${DEFAULTS.CLAUDE_BINARY}
   model: ${DEFAULTS.CLAUDE_MODEL}
   effort: medium
   stopGraceMs: ${DEFAULTS.STOP_GRACE_MS}

package/dist/connector/index.js

@@ -53,6 +53,14 @@ function shouldRetrySendError(err) {
         return true;
     return false;
 }
+/**
+ * Safely extract the im.v1.message.patch service from a LarkChannel.
+ * Returns undefined when the channel mock omits rawClient (unit tests).
+ */
+function tryGetPatchService(channel) {
+    const c = channel.rawClient;
+    return c?.im?.v1?.message;
+}
 export class FeishuConnector {
     channel;
     onMessage;
@@ -81,6 +89,26 @@ export class FeishuConnector {
                 },
             },
         });
+        // 观测探针（2026-08-11 run 卡定格事故）：飞书业务码错误以 HTTP 200 + {code!=0}
+        // 返回时，lark SDK 正常 resolve、@larksuite/channel 的 patchCard 丢弃返回值，
+        // 导致终态卡 patch 被业务层拒绝时全链路无日志无兜底。这里只观测不改行为——
+        // 不 throw、不重试，返回值原样透传。
+        // 详见 .adversarial-tdd/prompt-patchcard-business-code-observability.md
+        // Guard: unit-test mocks may omit rawClient; skip probe installation in that case.
+        const messageService = tryGetPatchService(this.channel);
+        if (messageService?.patch) {
+            const origPatch = messageService.patch.bind(messageService);
+            messageService.patch = (async (request, options) => {
+                const res = await origPatch(request, options);
+                if (typeof res?.code === 'number' && res.code !== 0) {
+                    const content = request?.data?.content;
+                    const bytes = typeof content === 'string' ? Buffer.byteLength(content, 'utf8') : undefined;
+                    getLogger().warn(`[feishu] message.patch business error code=${res.code} msg=${String(res.msg)} ` +
+                        `messageId=${String(request?.path?.message_id)} bytes=${bytes ?? 'unknown'}`);
+                }
+                return res;
+            });
+        }
         this.channel.on('message', (msg) => {
             if (msg.chatType !== 'p2p')
                 return;