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

.gitea/workflows/ci.yml

@@ -28,18 +28,30 @@ jobs:
       - name: Install dependencies
         run: npm ci
 
-      - name: Type check
+      # v0.8.0: 源码类型检查
+      - name: Type check (src)
         run: npm run typecheck
 
+      # v0.8.0 新增：**测试代码**类型检查。
+      # 此前 tests/ 既不在 tsconfig include 中，babel-jest 又只剥离类型不做检查，
+      # 于是测试里的类型错误、拼写错误、未 await 的断言全部不可见
+      # （审计实例：v025-fixes 里标题写 indexeddb、实际传 'opfs' 的用例长期存活）。
+      - name: Type check (tests)
+        run: npm run typecheck:tests
+
+      # v0.8.0: lint 不再 continue-on-error —— 此前 lint 失败永远不让 CI 变红，
+      # 形同虚设。现在 src 与 tests 都纳入，0 error 才通过。
       - name: Lint
         run: npm run lint
-        continue-on-error: true
 
       # v0.7.2: Run tests 拆两步 —— 常规套件并行（快），重型套件串行（runInBand）。
       # 此前重型测试（10 万行 kv/opfs、生产矩阵）与常规套件在慢 runner 上并行
       # 争抢 CPU 与 4GB 堆 → 单测超时（120~180s）与 OOM 类假失败。
-      - name: Run tests (regular suites)
-        run: npx jest --forceExit --maxWorkers=1 --no-cache --testPathIgnorePatterns='/node_modules/|/tests/e2e/|/tests/helpers/|aria-prod-load|kvstore-stress|aria-matrix-audit|aria-idx-flush-race'
+      #
+      # v0.8.0: 常规套件**带覆盖率**运行（此前 CI 从不跑 --coverage，且 jest.config
+      # 没有任何 coverageThreshold → 覆盖率掉到 0% 也全绿）。阈值定义在 jest.config.cjs。
+      - name: Run tests (regular suites, with coverage gate)
+        run: npx jest --coverage --forceExit --maxWorkers=1 --no-cache --testPathIgnorePatterns='/node_modules/|/tests/e2e/|aria-prod-load|kvstore-stress|aria-matrix-audit|aria-idx-flush-race'
         env:
           NODE_OPTIONS: --max-old-space-size=4096
 
@@ -56,12 +68,26 @@ jobs:
       - name: Build
         run: npm run build
 
+      # v0.8.0: 校验仓库内 dist/ 与源码同步。
+      # 此前 dist/ 已提交入库（42 个提交都在改 dist），但 CI 只 build 到工作区、
+      # 不校验是否与源码一致 → 发布产物可以静默落后于源码。
+      # 仅在单一 Node 版本上校验（构建结果与 Node 版本无关）。
+      - name: Verify dist is in sync with src
+        if: matrix.node-version == '20.x'
+        run: |
+          if ! git diff --quiet -- dist/; then
+            echo "::error::dist/ 与源码不同步。请在本地运行 npm run build 并提交 dist/。"
+            git diff --stat -- dist/
+            exit 1
+          fi
+          echo "dist/ 与源码同步 ✓"
+
   e2e:
     runs-on: debian-latest
     # 与 MetonaEditor 一致：Playwright 官方镜像（自带 Chromium 与全部系统依赖），
     # 避免 runner 宿主（Debian 11）不被 Playwright 1.62 支持的问题
     container: mcr.microsoft.com/playwright:v1.62.1-noble
-    timeout-minutes: 15
+    timeout-minutes: 20
     steps:
       - uses: actions/checkout@v4
       - name: Use Node.js
@@ -75,5 +101,6 @@ jobs:
         run: npm run build
       - name: Verify Playwright browsers
         run: npx playwright install chromium
-      - name: Run E2E smoke tests
+      # v0.8.0: e2e 覆盖真实崩溃注入（CDP Page.crash）与真实 OPFS 语义
+      - name: Run E2E tests
         run: npm run test:e2e