fix(cdb): preserve tests/ entries across mcpp build (v0.0.63)

[Sunrisepeak]

问题

clangd 在 tests/ 目录下对 gtest::InitGoogleTest()、import std、import mcpplibs.* 全无代码提示。

根因:compile_commands.json 是当次构建 plan 的镜像。mcpp build 的 plan 不含 tests/**/*.cpp 与 dev-deps,而它与 mcpp test 写同一个 cdb——后写覆盖前写。日常「编辑→mcpp build」循环里,测试条目几乎总被擦掉(P0 fast-path 全缓存时不重写,故偶尔残留;一旦真实重建即回退)。

完整分析见 .agents/docs/2026-06-25-cdb-test-coverage-design.md。

方案:offline-first 的 cdb「合并保留」

mcpp test 本就能写出完整正确的 cdb(测试条目 flag 有效、其 BMI 因 build/test 共用输出目录而真实存在)。bug 本质是 mcpp build 摧毁它。修复 = 让 build 停止摧毁:

write_compile_commands 由「全量覆盖」改为「合并」:

• 当前 plan 覆盖的文件 → 用本次条目(权威);
• 当前 plan 未覆盖、但文件仍存在的旧条目(上次 mcpp test 写的测试条目)→ 保留;
• 文件已删 → 剪除;坏 JSON → 回退纯 fresh。

mcpp build 自身零改动:不解析、不下载任何 dev-deps,build-only 用户与构建图均不受影响(严守 offline-first)。跑一次 mcpp test 后,测试补全在后续所有 mcpp build 中持久生效。

为何不让 mcpp build 主动生成测试 cdb:会触发 dev-deps 下载、违背 offline-first、坑「只想 build」的用户;且测试补全本就必须先装 gtest+构建 BMI(只能由 mcpp test/install 完成),纯 B 收益为零。决策理由见设计文档 §7/§8。

改动

• src/build/compile_commands.cppm:新增纯函数 merge_compile_commands(fresh, existing, fileExists) + write_compile_commands 走合并。其余构建相关文件(plan/prepare/ninja_backend/execute)均无改动。
• 单测 tests/unit/test_compile_commands.cpp:合并保留 / 剪除已删 / fresh 胜出去重 / 坏 JSON 回退(TDD,先 RED 后 GREEN)。
• e2e tests/e2e/77_cdb_preserves_test_entries.sh:mcpp test 后真实重建 mcpp build 仍保留测试条目 + 删测试文件后剪除(三平台)。
• bump 0.0.62 → 0.0.63。

验证(本机)

• 全量单测 24/24 通过(含新 test_compile_commands 4/4)。
• e2e 47 / 76 / 77 通过。
• e2e 59 本机 llvm 环境性失败(基线 0.0.56 同样失败,与本改动无关)。

🤖 Generated with Claude Code