工作流 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
107 lines
4.6 KiB
YAML
107 lines
4.6 KiB
YAML
name: CI
|
|
|
|
on:
|
|
push:
|
|
branches: [master]
|
|
pull_request:
|
|
branches: [master]
|
|
|
|
jobs:
|
|
test:
|
|
runs-on: debian-latest
|
|
|
|
strategy:
|
|
matrix:
|
|
node-version: [18.x, 20.x, 22.x, 24.x]
|
|
|
|
steps:
|
|
- uses: actions/checkout@v4
|
|
|
|
- name: Use Node.js ${{ matrix.node-version }}
|
|
uses: actions/setup-node@v4
|
|
with:
|
|
node-version: ${{ matrix.node-version }}
|
|
# v0.7.2-fix: 不用 cache —— Gitea act runner 对 setup-node 的 npm 缓存
|
|
# post 步骤(cache-save tar 打包)支持不完善,矩阵 job 并行时打包失败
|
|
# 会把整个 job 标红(即便 Run tests 已通过)。npm ci 每次 1~2 分钟可接受。
|
|
|
|
- name: Install dependencies
|
|
run: npm ci
|
|
|
|
# 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
|
|
|
|
# v0.7.2: Run tests 拆两步 —— 常规套件并行(快),重型套件串行(runInBand)。
|
|
# 此前重型测试(10 万行 kv/opfs、生产矩阵)与常规套件在慢 runner 上并行
|
|
# 争抢 CPU 与 4GB 堆 → 单测超时(120~180s)与 OOM 类假失败。
|
|
#
|
|
# 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
|
|
|
|
# v0.7.3-ci: 重型套件只在单一 Node 版本(20.x LTS)跑一次 ——
|
|
# 压力测试验证存储正确性/性能护栏,不依赖 Node 版本差异;
|
|
# 4 个矩阵 job 并行时重型套件各占 ~1.2GB RSS(实测),
|
|
# 4G 内存 runner 上 4 份并行必被 OOM killer 杀掉(exit 137)。
|
|
- name: Run tests (heavy suites, serial)
|
|
if: matrix.node-version == '20.x'
|
|
run: npx jest --forceExit --runInBand --no-cache tests/engine/aria-prod-load.test.ts tests/engine/kvstore-stress.test.ts tests/engine/aria-matrix-audit.test.ts tests/engine/aria-idx-flush-race.test.ts
|
|
env:
|
|
NODE_OPTIONS: --max-old-space-size=4096
|
|
|
|
- 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: 20
|
|
steps:
|
|
- uses: actions/checkout@v4
|
|
- name: Use Node.js
|
|
uses: actions/setup-node@v4
|
|
with:
|
|
node-version: 22.x
|
|
# v0.7.2-fix: 同上,e2e job 也不用 npm 缓存(cache-save post 失败风险)
|
|
- name: Install dependencies
|
|
run: npm ci
|
|
- name: Build
|
|
run: npm run build
|
|
- name: Verify Playwright browsers
|
|
run: npx playwright install chromium
|
|
# v0.8.0: e2e 覆盖真实崩溃注入(CDP Page.crash)与真实 OPFS 语义
|
|
- name: Run E2E tests
|
|
run: npm run test:e2e
|