3D engine that AI agents drive
CI
test.yml runs on every pull request and is called by publish.yml, so a release runs the same checks as the pull request that produced it.
Jobs
All jobs start at once.
| Job | What it runs |
|---|---|
audit |
npm audit --audit-level=high |
size |
npm run size and npm run tool-cost against the pull request base (pull requests only; a release has no base) |
unit (12 shards balanced by measured time, scripts/shard-test-files.mjs and test-timings.json) |
npm run build:lib, then npm run test:coverage on one twelfth of the test files; uploads its lcov and per-file timings |
coverage |
merges the shard lcov files, writes the summary, compares with coverage-baseline.json, uploads lcov |
package |
prepare:release, check:links:package, smoke:package, smoke:mcp-package |
bun |
smoke:mcp-package with MCP_SERVER_RUNTIME=bun: the packed MCP server runs under bun, the way bunx 67js-mcp starts it |
test |
waits for every job above and fails unless each one succeeded. Branch protection on main requires this name. |
node --test runs each file in its own process (the Node 24 default, --test-isolation=process), so the unit pass is also the isolation check. npm run test:isolated stays as a local tool: it runs the same files four at a time and reruns a failure alone.
Coverage
Coverage comes from Node's built-in --experimental-test-coverage. The coverage job fails when line or function coverage falls more than 0.5 points, or branch coverage more than 1.5 points, below coverage-baseline.json (branch totals move by up to about 0.8 points between runs of the same commit). Raise the baseline by editing that file; lower it only on purpose and say why in the pull request. To reproduce locally: npm run test:coverage -- --test-reporter=lcov --test-reporter-destination=coverage/lcov.info, then npm run coverage:gate -- coverage.
Add a job or a smoke
- Add the job to
test.yml:actions/checkout, then./.github/actions/setup, then your command. Pin any new action by full SHA. - Add its id to
needsof thetestjob. A job left out ofneedsdoes not gatemain. - A smoke that needs the packed archive goes in the
packagejob afterprepare:release.