 thzxx
|
0b44620721
|
fix(v0.8.0): 全量回归审查 —— 1 处 P0 数据丢失 + 4 处 P1 + 9 处 P2 根因修复
方法：四个对抗性子代理分头审查（数据正确性 / 文档宣称 vs 实现 / 公共 API 契约 /
测试质量），每条结论要求可复现证据；逐条复核 + 探针确认 + 变异验证（40 项全部
被对应用例拦住）。
P0：事务活跃期间 repair()/close()/周期 checkpoint 推进 WAL 水位 → 已 COMMIT 的
事务整批消失且恢复报告"干净"。根因 hasPendingFlushData()/computeDurableLsn()
不看 txnSnapshot；守卫此前只在 CheckpointManager 两个回调里。修复：守卫下沉到
computeDurableLsn() 与 advanceWalCheckpoint() 入口（唯一实现）。
P1：
- WAL 前缀缺失丢弃整段活分片（回退上一代 manifest 时 kept 为空）→ 前缀缺失单独
记录，后缀照常重放；仅 fromLsn === 0 时才算真异常
- 孤儿回收门槛只看引擎层 dataLossSuspected，漏掉 LSM 层被丢的 SSTable →
统一 describeRecoveryDamage() 聚合判定（损坏时绝不删"引用不到"的文件）
- vacuum() 逐层压缩绕过维护链 → vacuumLevels() 每层作为维护链任务执行
- reclaimRetiredNow() 无视在途读者（读者把"已退休"读成"文件损坏"）→ 有读者时
退化为延迟回收
P2：WAL 记录级 CRC 损坏不计数不上报；旧格式表结构记录形状损坏静默当空库；
bloomFilterBitsPerKey 配置被接受却完全不生效（构建器写死默认值，实现缺陷）；
幽灵 meta；介质读故障等于文件损坏的语义无用例；manifest 回读校验两条守卫无用例；
文件名≠载荷世代判定无用例；pageIdWatermark 单调性无用例；分片号两条真实不变量
无用例。
覆盖率口径（第二处漏洞）：interface.ts 混着三个运行时函数（cloneRow 等）却被
描述为"纯类型、不纳入统计" → 实现搬到 src/engine/row_clone.ts；搬完门禁真的
失败（functions 93.84% < 94%），补测退化路径后通过。
测试质量：3 条空壳用例改值级断言；1 条"全损坏"用例实际只走缓存 → 拆成两条真
用例；5 秒墙钟 race 改门控 + 失败上限；setTimeout 改 whenIdle()；<= 收紧为 <。
变异脚本加固：正控（干净基线必须全绿）、编译失败/0 用例单独归类、300s 超时、
逐字节 sha256 恢复校验、O_EXCL 进程锁、锚点唯一性；变异 22 → 40 项。
文档两轮订正（16 + 11 条不成立宣称）：MVCC 快照隔离、backup 一致性快照、
"空洞检测截断"、体积（251,109 B / gzip 63,145 B）、测试与覆盖率数字、
"5 种存储引擎"、Tree-shakable、错误码表补 16 个码、恢复报告字段、已知限制
（回退单向 / 多实例依赖 Web Locks / manifest 体积 / 尾部 WAL 分片不可识别）。
验证：常规套件 92 套件 / 1980 用例全绿；覆盖率 90.59 / 82.59 / 94.14 / 93.50
（阈值 90/82/94/93）；e2e 14/14（真实 Chromium + OPFS + CDP 崩溃）；
重型套件 4 套件 / 27 用例；变异 40/40；lint + 两份 tsc 干净；dist 已重建。
|
2026-09-15 16:33:40 +08:00 |
|
|
thzxx
|
799560ea05
|
docs(G6): 宣称与实现一致性收口 —— priority 真正生效、MVCC/backup/引擎数/打包 全部对齐
独立核验（12 条宣称逐条对源码验证）发现 5 处**硬伤**与 2 处**数字过期**，
本提交按"能改代码就让宣称成立、改不动就如实描述"的原则全部收口。
让实现符合文档（2 处）：
1. **插件 priority 此前不生效** — `register()` 虽按 priority 插入数组，但
`install()` 在 register 内**立即**执行，因此 install 与钩子顺序 = config 数组
顺序（实测 priority low=1/high=100/mid=50 时钩子按 low→high→mid 触发，
只有 `getPlugins()` 是 high,mid,low）。而 README/CONTRIBUTING/constants
一直宣称"越大越先执行"。
现在 Core 注册前按 priority **稳定降序**排序（同优先级保持数组顺序），
install 与钩子都按优先级执行 → 宣称成立。新增
`tests/v080-plugin-priority.test.ts` 锁定 install 顺序、钩子顺序、稳定性、缺省值。
2. **连接池静态方法不在类型系统里** — `MetonaSqlark.connect/disconnect/
disconnectAll/getActiveConnections` 由 connection-manager 用
`as unknown as Record<string, unknown>` 注入，README 的连接池表格在
TypeScript 下全部 TS2339。现在在类上声明为可选静态成员，注入处去掉断言。
如实描述（3 处）：
3. **MVCC 快照隔离**（README 三处 + 实现对照）— `snapshotLsn` / `prevVersion`
只写不读，事务读走 `txnSnapshot`+LSM，commit 即清理版本链，并发
`beginTransaction` 抛 `TX_ACTIVE`。改为"快照回滚（事务串行，非 MVCC 隔离）"，
并在 README 架构图与维护语句表里同步措辞。
4. **"存储引擎（5 种）"** — 实际是 4 种模式 + 3 种后端，引擎类只有 4 个
（Memory / KVStore / Hybrid / Aria），OPFS 是后端而非引擎。标题与条目已改写，
并写明"`disk`/`hybrid` 恒用 KVStore"。
5. **`diskEngine` 生效范围** — 仅 `mode:'aria'` 生效；`constants.ts` 的注释
此前写成"仅 mode='disk'|'hybrid' 时生效"（正好写反），已改正；README 配置表、
快速开始示例与 Aria 示例同步标注。
数字口径统一（可复现）：
- 测试 1872（90 套件）+ 14 e2e，另 4 个重型套件在独立 CI job 串行运行；
- 覆盖率 语句 90.43% / 分支 82.21% / 函数 94.27% / 行 93.44%；
- README 明确写出**产出这些数字的完整命令**（与 CI 常规 job 一致），
并要求改动覆盖范围/阈值时同步更新表格（G5）。
- CHANGELOG 0.8.0 条目与 site 首页/文档页同步。
另修 **CONTRIBUTING 的钩子契约**：明确写出"返回值被忽略（不能取消/改写）、
就地改参数在 Table API 生效、抛异常可取消、SQL 路径的 beforeInsert 收到副本"
—— 此前只写 "allow intercepting"，容易被理解为返回值可改变行为。
验证：全量 90 套件 / 1872 测试通过（+4 重型套件）；覆盖率四项均高于阈值；
typecheck(src+tests)、lint、build 零错误零告警；e2e 14 项通过；dist 已重建。
|
2026-09-15 08:06:23 +08:00 |
|