docs(B-6): 附录 H(B-6 完整实施记录)+ README/CHANGELOG/site/CONTRIBUTING 同步

- PLAN 附录 H:交付物清单、提交顺序不变量、**实施中新发现的 10 个缺陷**(含分片号复用、
  读快照与并发 flush 的窗口、checkpoint 仍等 compaction、takeover 世代竞争、提交中冻结表
  误报 WRITE_LOST、底部层只剩墓碑的 TypeError、介质读故障被当缺失、元数据损坏静默空库等),
  以及可复现的验收命令与实测数字。
- PLAN 待办表:B-6 行改为"完整实施(非降级选项)";原"B-1 遗留"给出结论
  (compaction/merge 输入只来自已校验数据,补校验反而有害;触发条件写明)。
- README:架构图/核心机制加入单一提交点;新增"存储布局在 v0.8.0 变更"的已知限制与迁移说明;
  测试 1935 / 覆盖率 90.34 · 82.16 · 94.06 · 93.23;新增变异验证命令。
- CHANGELOG:0.8.0 条目补齐 B-6 完整实现(含 9 个新错误码与恢复报告)。
- site:错误码表补 7 个新码;AriaEngine 与崩溃恢复卡片按实现改写(不再宣称"空洞截断");
  首页徽章数字同步。
- CONTRIBUTING:新增"变异验证"一节(修复类提交必须能回答"回退后用例会不会失败")。
This commit is contained in:
thzxx
2026-09-15 10:29:09 +08:00
parent c5694b1d23
commit 81c46eb6f2
6 changed files with 182 additions and 22 deletions
+18
View File
@@ -228,3 +228,21 @@ const db = await MetonaSqlark.create({
## Questions?
Open an issue at [git.metona.cn/MetonaTeam/MetonaSqlark/issues](https://git.metona.cn/MetonaTeam/MetonaSqlark/issues).
---
## 变异验证(回归套件的"是否只是陪跑"检查)
修复类提交必须能回答一个问题:**把修复回退到修复前的行为,对应用例会不会失败?**
不会失败的用例等于没有保护。
```bash
# B-6(存储单一提交点 / LSM 结构根治)17 项变异验证
python3 scripts/mutation-b6.py
# 只跑其中一条(按名字子串匹配)
python3 scripts/mutation-b6.py "WAL 分片号复用"
```
脚本会临时改写 `src/`、运行对应用例、再恢复源码(收到 SIGINT/SIGTERM 也会恢复),
最后打印每一条是"被拦住"还是"仍然通过"。**出现任何一条"仍然通过",本次提交不算完成。**