Skip to content

Commit d84d98a

Browse files
committed
test(tui): make the doctor issue-count test independent of the host's microphone
fake_standalone_facts_compose_through_shared_view asserts issue_count() == 1, but collect_report_with also runs apply_voice_probe, which on Linux looks for pw-record, parec or arecord on PATH. A host without one, as the CI runner is, gets a voice.no-input-device issue on top: 2 instead of 1. The first TUI CI run of PR #9 failed on exactly that; WSL2 has all three recorders, which is why it passed there. The test now leaves that finding out of the count (it checks the facts it composes, not the machine it runs on). Verified by running the test binary directly with PATH=/nonexistent: before the change 11 passed and 1 failed with left: 2, right: 1; after it 12/12, and 12/12 with the recorders on PATH as well. The docs said doctor_cmd:: needs no audio device and that r5 had removed apply_voice_probe. Neither is true (the function is still there and is called on every report), so the manifest comment, the baselines page and plan section 10.10 are corrected and now carry the numbers of that CI run: 8,633 passed, every suite equal to the WSL2 count except this one test.
1 parent 4cf989f commit d84d98a

4 files changed

Lines changed: 23 additions & 14 deletions

File tree

‎docs/PLAN/PLAN-RUST-AGENT-RUNTIME-REMOVAL.md‎

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -583,7 +583,7 @@ r3 执行了「拆除 Rust runtime + 恢复 `/model`」;r4 在其上补了阶
583583
| debug `zypi` 构建 | ✓ 0 告警;冷构建 4 m 53 s(机器 12 核 / 24 GB,`CARGO_BUILD_JOBS=8`) |
584584
| 8 个 suite,`doctor_cmd::` 不再被跳过(基线执行器,清环境;第一轮) | ✓ **7,456 通过 / 0 失败 / 20 忽略**:`pi-shell` 1,056、`pi-pager` 5,571、`pi-pager-bin` 20、`pi-acp-lib` 21、`pi-http` 13、`pi-telemetry` 239、`pi-file-utils` 216、`pi-sampling-types` 320。与 CI(`33374a3`,7,444)对账:多出的 12 个正是 `doctor_cmd::`,其余 7 个 suite 与 CI 逐项相同 |
585585
| 10 个 suite(同上;做了六件事之后的清单,含 `pi-pager-render`、`pi-pager-minimal`) | ✓ 执行器退出码 0,1,469 s:**8,633 通过 / 1 个已知失败 / 22 忽略**。`pi-shell` 1,056、`pi-pager` 5,577(再 +6 个 `agent_stderr` 用例)、`pi-pager-render` 1,091(另有 1 个已知失败,见发现 8)、`pi-pager-minimal` 79、`pi-pager-bin` 21(+1 个 `-p` 用例)、`pi-acp-lib` 21、`pi-http` 13、`pi-telemetry` 239、`pi-file-utils` 216、`pi-sampling-types` 320 |
586-
| `doctor_cmd::`(12 个,r5 起 CI 一直跳过) | ✓ 12 通过,不需要音频设备 |
586+
| `doctor_cmd::`(12 个,r5 起 CI 一直跳过) | ✓ 12 通过——**但只在装着 `pw-record` / `parec` / `arecord` 的 WSL2 上**;「不需要音频设备」不对:PR #9 的第一次 CI 运行里 runner 没有这些程序,`fake_standalone_facts_compose_through_shared_view` 失败(`voice.no-input-device` 多出一个 issue),已修,见本节末尾的「CI 结果」 |
587587
| `pi-pager-render`、`pi-pager-minimal`(当时不在清单里,现在在)整个 crate | ✓ `pi-pager-render` 1,092 通过 / 0 失败 / 2 忽略;`pi-pager-minimal` 79 通过(其中一个用例缺锁、整个 crate 默认线程数下 30 次失败 25 次,已修,见发现 8) |
588588
| 其余 crate 逐个 `--lib --tests`(含 `pi-fast-worktree`) | 74 个:68 个全过(其中 5 个没有测试),5 个有失败用例(共 13 个),1 个编译不过;11,807 通过 / 13 失败 / 23 忽略;见发现 8 |
589589
| Python 全量 pytest(Linux,3.12.3,`main` 的 `eafc578`) | ✓ 2,135 通过 / 0 失败 / 30 跳过(缺 `langchain_deepseek`、Windows 专属)/ 31 取消选择(`real_llm`),123.9 s。r7 记的 6 个 macOS 专属失败在 Linux 上都通过 |
@@ -675,14 +675,16 @@ r3 执行了「拆除 Rust runtime + 恢复 `/model`」;r4 在其上补了阶
675675
| `AGENTS.md`、`packages/pi-agent-cli/AGENTS.md`、`CHANGELOG.md`、`docs/TUI-AND-CODE-AGENT.md` | 新行为的说明(stderr 日志、`PI_AGENT_PARENT_PID`、没生效的提示)、基线执行器与 `PI_HOME` 的提醒、PTY 脚本的位置 |
676676
| 本文件、`docs/baselines/tui.md` | r8 的记录;基线页加了 `doctor_cmd::` 的 Linux 结果、新 suite、未选入 suite 的 crate 的分诊、PTY 载体(§3.3)、WSL 的 `PI_HOME` 提醒 |
677677

678-
「仓库里的改动」里的 Rust 与 Python 改动都在 `main` 的 `eafc578` 之上,拆成 8 个提交(分支 `codex/linux-wsl-r8`)。`docs/baselines/tui.md` 里的数是 WSL2 量的,不是 CI 的;清单里 `doctor_cmd::`、`pi-pager-render`、`pi-pager-minimal` 的结果要等第一次 CI 运行证实。
678+
「仓库里的改动」里的 Rust 与 Python 改动都在 `main` 的 `eafc578` 之上,拆成 8 个提交(分支 `codex/linux-wsl-r8`)。`docs/baselines/tui.md` 里的数是 WSL2 量的,不是 CI 的;清单里 `doctor_cmd::`、`pi-pager-render`、`pi-pager-minimal` 的结果要等第一次 CI 运行证实——**现在有了,见下一段「CI 结果」**。
679679

680-
**没有验证的。** Landlock 那一层(内核 ≥ 5.13;见发现 5);GitHub 的 `ubuntu-24.04` runner 默认限制非特权 user namespace,bwrap 要先放开 `kernel.apparmor_restrict_unprivileged_userns`(凭文档,没试);bwrap 缺失或被禁用时的行为;Windows;MCP 子进程;用真实模型跑 PTY(只用了 mock);`/bin/sh` 不是 dash 的发行版、musl;`-p` 模式下给整个进程组发信号;`PI_AGENT_COMMAND` 指向包装脚本时的 `-p`(agent 的父进程不是 zypi,监视不启用,只杀 zypi 仍会留下 agent)。「内核支持 Landlock 时不出现没生效的提示」只有单测,没在真机上看过。Windows 上的 `PI_AGENT_PARENT_PID`(监视只在 POSIX 上启用)与 `agent.stderr.log` 的轮转(`rename` 的语义不同)都没跑过。CI:去掉 `skip` 的 `doctor_cmd::` 与两个新 suite 在 GitHub runner 上的结果。macOS 一侧没有重测:r8 的 Rust 改动都是平台无关或 Unix 通用的代码,只在 Linux 上编译、测过,Python 的父进程监视在 macOS 上应当同样可用(`os.getppid()`),也没跑过;`--die-with-parent` 只在 Linux 上存在。
680+
**CI 结果(PR [#9](https://github.com/zy1233/pi-python/pull/9) 的第一次运行,`cargo test (Linux x86_64)`,24 m 44 s)。** 10 个 suite:`pi-shell` 1,056、`pi-pager` 5,576(另有 1 个失败、13 个忽略)、`pi-pager-render` 1,092(2 个忽略;`known_failures` 里的 tmux 用例在 runner 上没有失败)、`pi-pager-minimal` 79、`pi-pager-bin` 21、`pi-acp-lib` 21、`pi-http` 13、`pi-telemetry` 239、`pi-file-utils` 216(6 个忽略)、`pi-sampling-types` 320,合计 8,633 通过 / 1 失败 / 22 忽略。除了那 1 个失败,每个 suite 都等于 WSL2 的数(`reference_passed` 不用改);门禁与 `cargo check`、Ruff、三个版本的 pytest 都通过。**失败的那个**是 `doctor_cmd::tests::fake_standalone_facts_compose_through_shared_view`:它断言 `issue_count() == 1`,runner 上是 2。原因:`collect_report_with` 每次都调 `apply_voice_probe`;`pi_voice::AUDIO_SUPPORTED` 在 Linux 上表示「编进了子进程录音后端」(默认开),该后端在 `PATH` 里找 `pw-record`、`parec`、`arecord`,找不到就多出一条 `voice.no-input-device` 的 issue。WSL2(WSLg)三个都装了,所以 r8 里的 12 个全过——r8 写的「不需要音频设备」是错的,它只对有录音程序的机器成立;`docs/baselines/tui.md` 里「r5 删掉了 `apply_voice_probe`」也不对(函数还在,`doctor_cmd` 每次都调)。复现:把测试二进制用 `PATH=/nonexistent` 直接运行,修前 11 通过 / 1 失败,报同样的 `left: 2, right: 1`。修法:这个用例把 `voice.no-input-device` 排除出计数(它测的是自己合成的那些事实,与宿主机有没有麦克风无关);修后 `PATH=/nonexistent` 与正常 `PATH` 下都是 12/12。其余 11 个用例不受影响(它们不数 issue,只查某条 finding 不存在)。`skip` 不用放回清单。
681+
682+
**没有验证的。** Landlock 那一层(内核 ≥ 5.13;见发现 5);GitHub 的 `ubuntu-24.04` runner 默认限制非特权 user namespace,bwrap 要先放开 `kernel.apparmor_restrict_unprivileged_userns`(凭文档,没试);bwrap 缺失或被禁用时的行为;Windows;MCP 子进程;用真实模型跑 PTY(只用了 mock);`/bin/sh` 不是 dash 的发行版、musl;`-p` 模式下给整个进程组发信号;`PI_AGENT_COMMAND` 指向包装脚本时的 `-p`(agent 的父进程不是 zypi,监视不启用,只杀 zypi 仍会留下 agent)。「内核支持 Landlock 时不出现没生效的提示」只有单测,没在真机上看过。Windows 上的 `PI_AGENT_PARENT_PID`(监视只在 POSIX 上启用)与 `agent.stderr.log` 的轮转(`rename` 的语义不同)都没跑过。CI 里去掉 `skip` 的 `doctor_cmd::` 与两个新 suite 在 GitHub runner 上的结果——已有,见「CI 结果」(两个新 suite 与 WSL2 的数一致;`doctor_cmd::` 一个用例失败,已修)。macOS 一侧没有重测:r8 的 Rust 改动都是平台无关或 Unix 通用的代码,只在 Linux 上编译、测过,Python 的父进程监视在 macOS 上应当同样可用(`os.getppid()`),也没跑过;`--die-with-parent` 只在 Linux 上存在。
681683

682684
**留给用户决定的。**
683685

684686
1. `zypi export` 要不要读 Python 的会话(ADR1,发现 4)。第一轮之后用户选了不动它,仍是 `Session '…' not found.`。
685-
2. CI:`pi-sandbox` 的端到端用例要在带 Landlock 的 runner(内核 ≥ 5.13)上并设 `SANDBOX_E2E_REQUIRE_ENFORCEMENT=1` 才有意义——这要换 runner 或加一个 job。去掉 `skip` 的 `doctor_cmd::` 与两个新 suite 先看第一次 CI 运行,不过就按 `docs/baselines/tui.md` 的办法分诊。
687+
2. CI:`pi-sandbox` 的端到端用例要在带 Landlock 的 runner(内核 ≥ 5.13)上并设 `SANDBOX_E2E_REQUIRE_ENFORCEMENT=1` 才有意义——这要换 runner 或加一个 job。去掉 `skip` 的 `doctor_cmd::` 与两个新 suite:第一次 CI 运行已经看过(见「CI 结果」),不需要把 `skip` 放回去。
686688
3. 发现 1 的代价要不要接受:给外层 bwrap 发 SIGTERM / SIGHUP 时,zypi 收到的是 SIGKILL,来不及恢复终端;补丁前则是整棵树留在终端上继续跑。
687689
4. 提交与推送:已拆成 8 个提交,推到分支 `codex/linux-wsl-r8` 并开了 PR。`main` 上的 `eafc578`(phase7 的修复)原本也没推,PR 会一并带上;`--die-with-parent` 单独是一个提交(发现 1),不想要这个代价时可以单独 revert,但 CHANGELOG 与本节里对它的描述要一起改。
688690
5. WSL 的清理:r8 在最后一步清掉了自己留下的东西——`~/pi-linux`(克隆加构建产物,34 GB)、`~/zypi-bin`、`~/pi-linux-logs`、`~/pi-test-home`,以及 `/tmp` 下这次任务期间创建的 182 个条目(测试留下的临时目录与输出、下载的压缩包、临时脚本)和 pytest 的基础目录。**留着没删**的:`~/.local/protoc` 与 `~/.local/bin/{protoc,rg}`(为构建装的,要删就删这三个)、`~/.cargo/registry` 里新下载的约 27 MB crate 与 `~/.cache/uv` 里的几个条目(共享缓存,删了只会让下次构建重新下载);用户自己的 `CARGO_TARGET_DIR`(`/mnt/d/work/cargo-target`)没有碰过。`~/.profile` / `~/.bashrc` 里对 `PI_HOME` 的导出是用户自己的配置,没有动——建议删掉,免得再有人直接跑 `zypi` 时读写 Windows 一侧的配置目录。
@@ -951,4 +953,4 @@ LoC 用 `python3` 递归统计 `*.rs` 行数(沙箱内 `xargs wc -l` 可能失
951953
- r5:推送分支、开 draft PR [#7](https://github.com/zy1233/pi-python/pull/7),并完成阶段 A 与阶段 0 的 0.1 / 0.6。① 第一次 Linux `TUI CI` 全绿后把基线转为阻塞,依赖图上限 995 → 980、告警上限 20 → 0、各 suite 设 `min_passed`;② 入口审计(0.6)按附录 A 的默认执行,A.3 删除 dashboard、白名单外的斜杠命令、agents / extensions / persona 模态、tasks / 后台 / 定时任务、subagents / workflows / goals、共享 prompt 队列、MCP / hooks / plugins / marketplace 入口、rewind / fork / jump、recap / feedback / consent、changelog、`--chat` 世界、session rename 的死链路;③ A.4 去掉各 crate 根的 `#![allow]`(消费者构建 0 告警)、`pi-shell` 的 `pub mod` 降级、删未用依赖与 8 个无人依赖的 crate、删 `cfg(feature = "local-workspace")` 代码;④ `-p` 无沙箱时拒绝运行(ADR7 的最小版本)。净效果:`tui/crates` 的 `.rs` 从 1,252,374 行降到 1,019,041 行,`Cargo.lock` 1,285 → 1,257 个包,Linux 依赖图 995 → 980。新增 §10.7 与附录 A 的 r5 结果。⑤ 收尾:PTY 烟测发现并删掉欢迎页与选择器里的死 worktree 入口(`ac1d3ff`);手动 `release_baseline` 回填了 release 数(`zypi` 422,034,120 B,−10.3 %;冷缓存构建 1,155 s,−29.9 %;0.2 勾选);阶段 1 开了头——`session/list` 的标题与 `updated_at`(1.P1 一半)、stdio 契约套件并修了 `session/close` / `resume` 的路由(0.3 / 1.P7 的 Python 一侧、1.P5 的一个 bug)、优雅退出(1.P2 完成,1.R3 ② 完成:退出 zypi 时 bash 工具进程不再残留——双击 Ctrl+Q、`kill -9 zypi`、SIGTERM、关终端都量过,前因后果见 §10.7)。验证:Linux CI(`0e71894`、`cca48b0`、`ac1d3ff`)、macOS 本机、PTY。阶段 1 的其余部分和 0.5 / 0.7–0.9 未做,见 §10.7 的遗留。
952954
- r6:清理品牌残留(用户选了「清理 Grok 品牌残留」,没给新名字,沿用 zypi),分支 `codex/branding-cleanup`,叠在 PR #7 之上;PR #7 同时转为 ready for review。改动:主题改名为 `zypi Night` / `zypi Day`(落盘 id `zypinight` / `zypiday`,旧 id 与别名仍可解析)、桌面通知标题、`zypi doctor` 的标题与全部提示、启动 / SSH 提示、设置页描述、复制提示、`--minimal` 欢迎页与信任提示、`zypi wrap` 报错前缀。顺带修了三处「提示指向不存在的东西」:`zypi doctor fix ssh-wrap` 写进 shell rc 的是 `alias ssh='grok wrap ssh'`(`grok` 不存在);配置目录在消息里叫 `~/.grok` / `$GROK_HOME`(实际是 `~/.pi-python` / `$PI_HOME`);`/doctor`、`/minimal`、`/copy`、`grok worktree gc|rm|db rebuild` 都不存在。有意没动的见 §10.8。验证见 §10.8。
953955
- r7:合并 `main` 上另一台机器推的 7 个提交(Phase 6 / 7 审计的实现,没有一个文件在 `tui/` 下)。6 个文件、17 处冲突,都在 `packages/pi-agent-cli` 与 `pyproject.toml`;接缝处的三个决定:`api_key_getter(env_name, provider)`(key 只给自己的 provider,`/model` 里的每个模型都适用)、`model_for_choice(choice, reasoning=…)`(切换模型不丢 `Model.reasoning`)、`_bind_session` 先决定信任再恢复模型选择。纯 `origin/main` 上就失败的 6 个 macOS 专属测试里,一个是真 bug(macOS 上项目的 `AGENTS.md` 会被读两遍),已按文件身份去重修掉;其余 5 个没有动。见 §10.9。
954-
- r8:在 WSL2(Ubuntu 24.04,内核 5.10,没有 Landlock)上补 Linux 一侧的实测,拆成 8 个提交(分支 `codex/linux-wsl-r8`,走 PR 合入)。做了:退出矩阵(会话首进程 / shell 作业 × 双击 Ctrl+Q、`kill -9`、SIGTERM、SIGHUP、关终端、Ctrl-C,含沙箱下;空闲、CPU 占满、cargo 构建三种负载;1.R3 ③ 的 Linux 部分)、0.9 的六项、PTY 烟测 18/18、`doctor_cmd::` 去掉 `skip`(12 个通过;8 个 suite 7,456 通过,等于 CI 的 7,444 加这 12 个)、Python 全量 pytest(第一轮 Linux 2,135 通过;六件事做完之后 Linux 2,160、Windows 2,156)、74 个未选入 suite 的 crate 的分诊。修了三处:沙箱的 bwrap re-exec 缺 `--die-with-parent`(只杀 bwrap 会把 zypi、agent 与工具整棵树留下);`media` 用例对 10 ms 时钟刻度的时间假设(`CONFIG_HZ=100` 上 30 次失败 26 次);`pi-pager-minimal` 的一个用例缺 `test_lock()`(默认线程数下 30 次失败 25 次)。更正了 1.R3 ① 的前提:agent 的 `stderr` 在 TUI 里是 `/dev/null`,不是继承终端。第一轮留下了几处(`-p` 孤儿、沙箱静默降级、`stderr` 去向、`zypi export`),用户随后选了前三处,加上 CI 清单、PTY 脚本入库、清理 WSL,都做了:`-p` 只杀 zypi 时 agent 与工具不再残留(`PI_AGENT_PARENT_PID` + Python 一侧监视父进程,`-p` 也处理 SIGTERM / SIGHUP;`print_exit.py` 4/4);Landlock 缺失时沙箱不再静默降级(启动时 `stderr` 一行警告,欢迎页与状态栏标 `sandbox:<profile> (not enforced)`);agent 的 `stderr` 落到 `<home>/logs/agent.stderr.log`(0600、追加、超过 1 MiB 轮转);CI 清单去掉 `doctor_cmd::` 的 `skip` 并加 `pi-pager-render`、`pi-pager-minimal`(10 个 suite,8,633 通过 / 1 个已知失败);PTY 驱动脚本入库为 `scripts/tui_pty/`(`smoke.py` 23/23,沙箱下 26/26,退出矩阵 12/12 与 14/14);WSL 里的克隆、构建产物与日志清掉了。没做:`zypi export` 读不到 Python 会话(用户选了不动);Landlock 层、Windows 与 MCP 子进程未验证;清单的新内容要等第一次 CI 运行证实。见 §10.10。
956+
- r8:在 WSL2(Ubuntu 24.04,内核 5.10,没有 Landlock)上补 Linux 一侧的实测,拆成 8 个提交(分支 `codex/linux-wsl-r8`,走 PR 合入)。做了:退出矩阵(会话首进程 / shell 作业 × 双击 Ctrl+Q、`kill -9`、SIGTERM、SIGHUP、关终端、Ctrl-C,含沙箱下;空闲、CPU 占满、cargo 构建三种负载;1.R3 ③ 的 Linux 部分)、0.9 的六项、PTY 烟测 18/18、`doctor_cmd::` 去掉 `skip`(12 个通过;8 个 suite 7,456 通过,等于 CI 的 7,444 加这 12 个)、Python 全量 pytest(第一轮 Linux 2,135 通过;六件事做完之后 Linux 2,160、Windows 2,156)、74 个未选入 suite 的 crate 的分诊。修了三处:沙箱的 bwrap re-exec 缺 `--die-with-parent`(只杀 bwrap 会把 zypi、agent 与工具整棵树留下);`media` 用例对 10 ms 时钟刻度的时间假设(`CONFIG_HZ=100` 上 30 次失败 26 次);`pi-pager-minimal` 的一个用例缺 `test_lock()`(默认线程数下 30 次失败 25 次)。更正了 1.R3 ① 的前提:agent 的 `stderr` 在 TUI 里是 `/dev/null`,不是继承终端。第一轮留下了几处(`-p` 孤儿、沙箱静默降级、`stderr` 去向、`zypi export`),用户随后选了前三处,加上 CI 清单、PTY 脚本入库、清理 WSL,都做了:`-p` 只杀 zypi 时 agent 与工具不再残留(`PI_AGENT_PARENT_PID` + Python 一侧监视父进程,`-p` 也处理 SIGTERM / SIGHUP;`print_exit.py` 4/4);Landlock 缺失时沙箱不再静默降级(启动时 `stderr` 一行警告,欢迎页与状态栏标 `sandbox:<profile> (not enforced)`);agent 的 `stderr` 落到 `<home>/logs/agent.stderr.log`(0600、追加、超过 1 MiB 轮转);CI 清单去掉 `doctor_cmd::` 的 `skip` 并加 `pi-pager-render`、`pi-pager-minimal`(10 个 suite,8,633 通过 / 1 个已知失败);PTY 驱动脚本入库为 `scripts/tui_pty/`(`smoke.py` 23/23,沙箱下 26/26,退出矩阵 12/12 与 14/14);WSL 里的克隆、构建产物与日志清掉了。没做:`zypi export` 读不到 Python 会话(用户选了不动);Landlock 层、Windows 与 MCP 子进程未验证;清单的新内容要等第一次 CI 运行证实;PR #9 的第一次运行已证实:8,633 通过,两个新 suite 的数与 WSL2 一致,只有 `doctor_cmd::` 的一个用例在没有录音程序的 runner 上失败(已修,r8 写的「`doctor_cmd::` 不需要音频设备」不对)。见 §10.10 的「CI 结果」。

0 commit comments

Comments
 (0)