Running tests

lastcall uses Vitest with 100% line, function, and statement coverage (98% branch threshold).

Commands

Command	Purpose
npm test	Run all tests (silent)
npm run test:coverage	Run with coverage report
npm run test:log	Run with verbose proof logging
npm run test:coverage:log	Coverage + verbose logging
npm run test:watch	Watch mode
npm run bench	Shutdown micro-benchmark
npm run ci	Pre-commit gate (lint, format, coverage, audit)

Verbose test logging

By default tests run silently. To log every step and proof of behavior:

npm run test:log

Or:

LASTCALL_TEST_LOG=1 npm test
# alias:
TEST_VERBOSE=1 npm test

Output format:

[lastcall:test 2026-06-19T...] START createLastcall > runs handlers on shutdown
[lastcall:proof] ✓ handler invoked on shutdown 1
[lastcall:test 2026-06-19T...] END createLastcall > runs handlers on shutdown

Use verbose mode to demonstrate that the package works — ideal for demos, debugging, and onboarding.

Test layout

test/
├── helpers/
│   ├── test-logger.ts    # LASTCALL_TEST_LOG gate
│   └── setup.ts          # per-test START/END logging
├── unit/                 # per-module unit tests
├── integration/          # child_process IPC tests
└── verification-matrix.test.ts

CI

GitHub Actions (.github/workflows/ci.yml):

• Node 22 — npm run ci, build, docs:build, npm pack --dry-run, bundle size check
• Bun — npm test + npm run build (compatibility job)

Full local acceptance matching the workflow:

npm run ci && npm run build && npm run docs:build && npm pack --dry-run

See Coverage audit and Verification matrix.