Repo brief: avajs/ava

Generated by RepoPilot · document generated 2026-09-13 · concise human review Evidence snapshot · analyzed 2026-09-13T17:19:12.781Z · commit bbfd946322fd

Verdict

Healthy — Healthy across all four use cases

• Last commit 2mo ago
• 22+ active contributors
• MIT licensed
• CI configured
• 1 more receipt on the live page

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests, cross-checked against dependency CVEs from deps.dev and OpenSSF Scorecard

What it is

AVA is a Node.js test runner that executes tests concurrently with thread isolation (each test file runs in its own worker process). It provides a minimal API with detailed error output, magic assert messages, and first-class support for async/await, Promises, and Observables—designed to let developers write atomic, isolated tests that catch real bugs. Single-package architecture: lib/ contains the core engine split into functional modules (runner.js for orchestration, worker/ subdirectory for worker process logic, reporters/ for output formatters, assertions in assert.js). entrypoints/ exposes CLI (cli.js) and programmatic APIs (main.d.ts, internal.d.ts). Configuration flows through…

Start here

Open these first:

• lib/cli.js — Entry point for command-line interface; orchestrates test discovery, configuration loading, and runner initialization.
• lib/runner.js — Core test execution engine; manages test lifecycle, scheduling, and result aggregation across worker processes.
• lib/worker/main.js — Worker process bootstrap; loads test files and executes individual test functions in isolated context.
• lib/load-config.js — Configuration resolution system; parses ava.config.js and package.json settings that control all runner behavior.
• lib/api.js — Public test API surface (test(), serial, hooks); exposes assertion and test-registration functions to user code.

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

To clone and set up locally: git clone https://github.com/avajs/ava.git && cd ava && npm install. The repository itself does not declare a test script in the shown package.json snippet (it says 'no test specified'), s…

Daily commands:

As a test runner, AVA itself is invoked via npm test (which calls ava per the README usage example) or npx ava. Run with npx ava --watch for watch mode. For the AVA repository itself, check the root package.json…

…shortened for this brief.

Key cautions & unknowns

• Concentrated ownership — top contributor handles 69% of recent commits
• Scorecard: marked unmaintained (0/10)
• AVA requires ES modules (type: 'module' in package.json) by default, which can surprise developers migrating from CommonJS projects. Worker isolation means global state is not shared across test files—this is a…
• Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

• Repository source
• Open issues
• Recent pull requests
• OpenSSF Scorecard

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

---

For the complete agent context, use the CLAUDE.md or Cursor rules export.