MetonaSqlark

122 Commits 1 Branch 0 Tags

2 Commits

Include renames

Author	SHA1	Message	Date
thzxx	50b1864145	chore(docs): 删除 v0.7.4 审计与 v0.7.5 计划共 4 个 md 文档删除： - AUDIT-aria-lsm-v0.7.4.md（50KB） - AUDIT-query-layer-v0.7.4.md（39KB） - AUDIT-storage-engines-v0.7.4.md（39KB） - PLAN-v0.7.5.md（98KB，含附录 G/H/I）删除前先清除引用面，避免留下断链（共 18 处）： - 源码注释 7 处（change-notifier / kvstore index / column-value / expression / sql-compare / where-matcher / validation）：保留设计意图，引用改为"v0.8.0 审计根因 N" - 测试注释 9 处（opfs.spec / aria-opfs-backend / faulty-backend / storage-harness / v080-b6 / v080-kvstore / v080-query-layer / v080-sql-three-valued / v080-unified-validation / parser）：同上 - CHANGELOG 3 处：改为不依赖已删除文档的自洽表述（B-6 交付物见各条；门禁订正三处按内容重写），并把变异数量同步为 42 - 校验：三个 md 之间无断链；仓库内已无 PLAN-v0.7.5/AUDIT-* 的任何引用（git 历史仍可追溯，需要时可 `git show <commit>:PLAN-v0.7.5.md` 找回）验证：93 套件 / 1985 用例全绿；覆盖率 90.59 / 82.61 / 94.14 / 93.50（阈值 90/82/94/93）； e2e 14/14；lint + 两份 tsc 干净；dist 已重建（注释只影响非压缩产物，min 产物 251,731 B / gzip 63,431 B 不变）。说明：审查记录的核心内容仍在 CHANGELOG.md（"全量回归审查"与"现场失败修复"两节），随 PLAN 一起删除的是附录 G/H/I 的详细表格（门禁逐条验收、交付物清单、未修复项表）。	2026-09-15 17:17:24 +08:00
thzxx	0dba1abf2a	test(P0): v0.8.0 验证基座与工程门禁根治工作流 C-1 / C-3 前半 + 测试代码类型检查。【故障注入基座】新增 tests/helpers/storage-harness.ts + faulty-backend.ts - TransactionalFileStore：忠实 OPFS 提交语义（close 才可见）+ 字节级故障注入（failNextWrite/Append/Delete、truncateAppendTo 撕裂写、crashPending 真崩溃） - 删除旧 opfs-mock：读返回内部引用、keepExistingData:false 不截断、close 空实现导致"提交前可见"等真实缺陷无法被测出（31 个测试文件迁移至新 harness） - 删除 aria-opfs-backend 内的第三份重复 mock（含从未被断言使用的 writeCalls 死代码与 entry.content.subarray 恒等分支） - FaultyBackend：包装任意 IStorageBackend 注入故障；crash() 明确区别于 close() （后者是优雅停机，会刷完写队列 —— 这正是此前所有"崩溃恢复"测试的真相） - 16 条基座自测证明注入真的生效（含 close 不能当崩溃的对照组）【覆盖率口径】jest.config.cjs - 移除 '!src/**/index.ts'（该 glob 把 AriaEngine 主实现等 15 个实现文件整体排除出统计，与 v0.2.6 曾承认过的问题同源），改为只排除纯类型声明文件并附理由 - 新增 coverageThreshold 门禁（此前完全不存在） - 真实基线：语句 90.66% / 分支 82.94% / 函数 94.36% / 行 93.43% - 修正 testMatch 使 tests/helpers 下的测试可被发现【测试代码类型检查】tsconfig.test.json + npm run typecheck:tests - 修复 103 个测试代码类型错误（此前 babel 剥离类型 + tsconfig 排除 tests，全部隐藏） - 新增 tests/helpers/assertions.ts：nonNull/decode/rows/object/engineMethod/expectCode 以断言收窄替代 as any - 消除 21 个 lint warning（含 v043-hardening 中定义后从未调用的 mockOPFS 死代码） - parser.test.ts 12 处 toBeDefined() 空断言升级为结构断言（并新增 AND/OR 优先级用例，当前红灯，对应总账第 11 项，将在工作流 A 修复）【版本契约】新增 tests/version-contract.test.ts - 校验 src VERSION / package.json / dist 三者一致，替代两处硬编码版本字面量【CI 门禁】.gitea/workflows/ci.yml - lint 去掉 continue-on-error（此前永远不让 CI 变红） - 新增 tests 类型检查、--coverage 覆盖率门禁、dist 与源码同步校验 - 版本 0.7.4 升至 0.8.0	2026-09-14 21:03:06 +08:00

Author

SHA1

Message

Date

thzxx

50b1864145

chore(docs): 删除 v0.7.4 审计与 v0.7.5 计划共 4 个 md 文档

删除：
- AUDIT-aria-lsm-v0.7.4.md（50KB）
- AUDIT-query-layer-v0.7.4.md（39KB）
- AUDIT-storage-engines-v0.7.4.md（39KB）
- PLAN-v0.7.5.md（98KB，含附录 G/H/I）

删除前先清除引用面，避免留下断链（共 18 处）：
- 源码注释 7 处（change-notifier / kvstore index / column-value / expression /
  sql-compare / where-matcher / validation）：保留设计意图，引用改为"v0.8.0 审计根因 N"
- 测试注释 9 处（opfs.spec / aria-opfs-backend / faulty-backend / storage-harness /
  v080-b6 / v080-kvstore / v080-query-layer / v080-sql-three-valued /
  v080-unified-validation / parser）：同上
- CHANGELOG 3 处：改为不依赖已删除文档的自洽表述（B-6 交付物见各条；门禁订正三处
  按内容重写），并把变异数量同步为 42
- 校验：三个 md 之间无断链；仓库内已无 PLAN-v0.7.5/AUDIT-* 的任何引用
  （git 历史仍可追溯，需要时可 `git show <commit>:PLAN-v0.7.5.md` 找回）

验证：93 套件 / 1985 用例全绿；覆盖率 90.59 / 82.61 / 94.14 / 93.50（阈值 90/82/94/93）；
e2e 14/14；lint + 两份 tsc 干净；dist 已重建（注释只影响非压缩产物，min 产物
251,731 B / gzip 63,431 B 不变）。

说明：审查记录的核心内容仍在 CHANGELOG.md（"全量回归审查"与"现场失败修复"两节），
随 PLAN 一起删除的是附录 G/H/I 的详细表格（门禁逐条验收、交付物清单、未修复项表）。

2026-09-15 17:17:24 +08:00

thzxx

0dba1abf2a

test(P0): v0.8.0 验证基座与工程门禁根治

工作流 C-1 / C-3 前半 + 测试代码类型检查。

【故障注入基座】新增 tests/helpers/storage-harness.ts + faulty-backend.ts
- TransactionalFileStore：忠实 OPFS 提交语义（close 才可见）+ 字节级故障注入
  （failNextWrite/Append/Delete、truncateAppendTo 撕裂写、crashPending 真崩溃）
- 删除旧 opfs-mock：读返回内部引用、keepExistingData:false 不截断、close 空实现
  导致"提交前可见"等真实缺陷无法被测出（31 个测试文件迁移至新 harness）
- 删除 aria-opfs-backend 内的第三份重复 mock（含从未被断言使用的 writeCalls 死代码
  与 entry.content.subarray 恒等分支）
- FaultyBackend：包装任意 IStorageBackend 注入故障；crash() 明确区别于 close()
  （后者是优雅停机，会刷完写队列 —— 这正是此前所有"崩溃恢复"测试的真相）
- 16 条基座自测证明注入真的生效（含 close 不能当崩溃的对照组）

【覆盖率口径】jest.config.cjs
- 移除 '!src/**/index.ts'（该 glob 把 AriaEngine 主实现等 15 个实现文件整体
  排除出统计，与 v0.2.6 曾承认过的问题同源），改为只排除纯类型声明文件并附理由
- 新增 coverageThreshold 门禁（此前完全不存在）
- 真实基线：语句 90.66% / 分支 82.94% / 函数 94.36% / 行 93.43%
- 修正 testMatch 使 tests/helpers 下的测试可被发现

【测试代码类型检查】tsconfig.test.json + npm run typecheck:tests
- 修复 103 个测试代码类型错误（此前 babel 剥离类型 + tsconfig 排除 tests，全部隐藏）
- 新增 tests/helpers/assertions.ts：nonNull/decode/rows/object/engineMethod/expectCode
  以断言收窄替代 as any
- 消除 21 个 lint warning（含 v043-hardening 中定义后从未调用的 mockOPFS 死代码）
- parser.test.ts 12 处 toBeDefined() 空断言升级为结构断言（并新增 AND/OR 优先级用例，
  当前红灯，对应总账第 11 项，将在工作流 A 修复）

【版本契约】新增 tests/version-contract.test.ts
- 校验 src VERSION / package.json / dist 三者一致，替代两处硬编码版本字面量

【CI 门禁】.gitea/workflows/ci.yml
- lint 去掉 continue-on-error（此前永远不让 CI 变红）
- 新增 tests 类型检查、--coverage 覆盖率门禁、dist 与源码同步校验
- 版本 0.7.4 升至 0.8.0

2026-09-14 21:03:06 +08:00