test 模式统一外部命令 mock(fkst.test.mock_command/command_calls)

[loning]

动机

引擎对外部 CLI 的调用——exec_sync(/bin/sh)、spawn_codex_sync(codex)、git_* 原语(git)——此前在包测试里只能靠每包自写 fake 二进制 on PATH(per-tool、per-package、模拟 CLI)。统一在 test 模式劫持这些外部进程调用,让包零样板、确定性地测"调用外部 CLI 的逻辑"。

改了什么

• 新增 external_command.rs:MockCommandState(FIFO mock 队列 + call 记录)+ 渲染命令行(exec_sync=shell 串;codex=codex exec … -;git=git -C <root> …)。
• 三执行点(sdk_basic/sdk_git/sdk_codex)在真进程前检查注入的 mock runner:test 命中返回 {stdout,stderr,exit_code}(exec 直接返回 / git 照常解析 mocked stdout / codex 短路返回);未命中 → fail-closed(unmocked external command: <rendered>,绝不 Command::new)。
• codex 仅加 test-mode 短路分支,未重构 streaming/permit/stall/log 真路径。setup_worktree 的 git 调用经同一 runner(test 未 mock fail-closed),不合成 worktree 副作用。
• fkst.test.mock_command(pattern, result)(前缀/子串匹配渲染命令行、FIFO 一次性、多注册按序)+ fkst.test.command_calls()(记录含 codex prompt/stdin,供断言)。
• 注入:register_test_sdk 建共享 Arc;run_department dept_lua 共享同一 Arc;每 test 前 reset。生产 register_framework_sdk 传 None、行为不变;supervise/run/self-test/conformance 无 mock。
• primitive 自测(sdk_basic/sdk_codex/sdk_git)保留真工具/fake-PATH 不迁 mock。

为什么这样

codex/git/gh 本质都是引擎在边界 spawn 外部进程。统一 mock 在那个边界劫持,比 per-tool fake 二进制 / per-package 函数注入 seam 更一致、可复用、fail-closed。gh 经 exec_sync 跑 → 匹配 shell 串;git 读原语照常解析 mocked stdout。下游 fkst-packages 将据此把 github-proxy 的 fake gh、autochrono 的 spawner seam 迁到 mock_command,并取回 run_department 端到端覆盖。

测试

test_runner_cli 含 14 个 mock 场景(exec / codex sync+async / git 读原语 mocked-stdout 解析 / fail-closed 各类 / per-test 隔离 / FIFO 序列消费 / command_calls stdin / setup_worktree fail-closed);本地 bin 116、self_test_cli 6、sdk_git serial 26、supervise_smoke 5 全绿;sdk_codex 22(生产真路径不受影响)。

sdk_git 并行有 pre-existing 本机 env-race(serial 全过、CI 绿),与本改无关。

🤖 Generated with Claude Code