Skip to content
CAI
Software that uses CAICheck a score

avajs/ava

55.6

Adequate · 15 November 2026

15.1k

lines of production code

JavaScript

primary language

4

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Features

Add project logo asset

The media directory now includes a new SVG logo file (media/logo.svg) featuring the project's visual identity with animated opacity effects, providing a branded asset for documentation and display purposes.

media · high confidence

Introduce experimental shared workers and improve worker lifecycle stability

The worker subsystem now supports experimental shared workers, allowing test files to register a single worker instance that persists across multiple test files via \registerSharedWorker\ (enabled only when \workerThreads\ is true). To address worker thread termination crashes, the worker lifecycle has been hardened: the worker is kept alive until explicitly freed, \process.exit()\ calls from tests are intercepted and reported rather than causing silent crashes, and unhandled promise rejections are properly surfaced. Additionally, line-number selection now fully supports source maps, correctly handling null maps and missing original values to ensure accurate test selection in transpiled environments.

lib/worker · high confidence

Introduce shared workers for plugin communication

Added shared worker support to the plugin system, allowing plugins to communicate with test workers via a shared worker thread rather than individual ports. This change introduces \lib/plugin-support/shared-workers.js\ and \lib/plugin-support/shared-worker-loader.js\ to manage worker lifecycle, message routing, and deregistration, enabling more efficient inter-process communication for plugins that require persistent state or high-frequency messaging.

lib/plugin-support · high confidence

New StackBlitz examples for AVA features

Added new interactive StackBlitz examples demonstrating endpoint testing, test macros, test timeouts, TypeScript usage (including basic setup and typing t.context), command-line features like matching titles and specific line numbers, and custom TAP reporters. These examples provide ready-to-run templates for users to explore AVA's capabilities directly in the browser.

examples · high confidence

New TypeScript type definitions for assertions, test context, and state events

The package now ships with a comprehensive set of TypeScript declaration files (types/assertions.d.ts, types/test-fn.d.ts, types/state-change-events.d.ts, etc.) that define the shapes of the assertion API (including throws/throwsAsync expectations), the test execution context (ExecutionContext, TeardownFn), and internal state-change events. This enables strict type-checking for test code, ensuring that assertion methods, test hooks, and worker communication interfaces are used correctly.

types · high confidence

Architecture

Complete rewrite of AVA core to a modular, ESM-native architecture

The AVA test runner has been completely rewritten from the ground up, replacing the previous monolithic structure with a modular, ESM-first codebase. This change introduces a new public API (\lib/api.js\) that exposes test execution as an event stream, allowing for better integration and programmatic control. The internal architecture has been split into distinct, focused modules: \lib/assert.js\ now handles all assertion logic and error formatting using Concordance, \lib/create-chain.js\ manages the test and hook chaining syntax (e.g., \test.serial\, \test.skip\), and \lib/globs.js\ handles test file discovery with improved pattern matching. The CLI (\lib/cli.js\) has been rebuilt on Yargs, and worker management (\lib/fork.js\) now supports both Node.js worker threads and child processes with advanced IPC flow control. This refactor removes legacy Babel integration, drops support for older Node.js versions, and establishes a foundation for future features like shared workers and experimental assertions.

lib · high confidence

Behavioural changes

1 commit (0 fixes) modifying (repo-wide)

A change to existing behaviour in (repo-wide) — 1 commit, 21 files: “Update TypeScript documentation (\#3489)” (refs \#3489).

examples/typescript-build, examples/typescript-loader, examples/typescript-native · low confidence · unverified

Introduce ESM entrypoints and dedicated CLI module

The project now exposes explicit ESM entrypoints for its public API and tooling. The CLI is now invoked via a dedicated \entrypoints/cli.js\ module that imports and runs the core logic, replacing previous entry mechanisms. The main test API (\entrypoints/main.js\) and its TypeScript definitions (\entrypoints/main.d.ts\) are re-exported from internal worker modules, maintaining the \test\ function and adding a \registerCompletionHandler\ for run-completion callbacks. Additionally, a new \entrypoints/eslint-plugin-helper.js\ provides a synchronous, worker-based helper for classifying files and imports for ESLint integration, and \entrypoints/plugin.js\ exposes the \registerSharedWorker\ API for plugin development.

entrypoints · high confidence

Introduce dedicated CI and local test execution scripts

Added \scripts/ci.sh\ and \scripts/test.sh\ to standardize test execution. The CI script configures AVA to skip watch-mode tests in the main run and executes them serially to reduce flakiness, while also restricting reporter tests to Linux environments. The local test script runs the linter, TypeScript checks, and all test suites.

scripts · high confidence

Migrate to ESM and modernize project configuration

The project has switched its internal implementation to ES Modules, replacing the previous CommonJS entry points (cli.js, index.js) with new ESM entrypoints and configuration files (ava.config.js, xo.config.js). This change introduces a new \.c8rc.json\ for code coverage settings, a \.taprc\ for TAP test isolation, and a \pnpm-workspace.yaml\ to manage build dependencies. Additionally, legacy tooling and CI configurations such as \.jshintrc\ and \.travis.yml\ have been removed in favor of modern standards like XO for linting and GitHub Actions for CI.

(repo-wide) · high confidence

New default and TAP reporters with improved error formatting and stack trace cleaning

The \lib/reporters\ directory has been rewritten to introduce a new default reporter and an updated TAP reporter. The default reporter now uses a dedicated \colors.js\ module for consistent styling and a new \beautify-stack.js\ utility that filters out AVA internals and Node.js internal frames from stack traces, making error output more readable. The TAP reporter has been refactored to use the \supertap\ library, which enables reporting hook failures as test failures, including logs from successful hooks, and properly handling process exits and timeouts. Additionally, ANSI escape codes are now stripped from TAP output using \node:util.stripVTControlCharacters\, and the TAP reporter correctly restores original error names when possible.

lib/reporters · high confidence

Test coverage

1 commit adding/updating tests in test; Added AVA snapshot tests for the snapshot workflow; Added AVA test fixtures for assertion validation; Added AVA-based integration tests for assertion behavior; Added TypeScript test fixtures for watch mode; Added comprehensive test suite for the test runner API; Added new test fixtures for reporter and assertion output; Added snapshot and stdout test fixtures for normalized test titles; Added snapshot reports for environment variables and line number selection tests; Added snapshot test fixtures for sourcemap verification; Added snapshot test for AVA timeout assertion validation; Added snapshot test for deterministic ordering of random test cases; Added snapshot test reports for corruption handling and formatting; Added snapshot tests for AVA snapshot removal logic; Added snapshot tests for configuration loading and validation; Added snapshot tests for extensions validation errors; Added snapshot tests for globs configuration validation; Added snapshot tests for shared worker plugin behavior; Added snapshot tests for the feature module; Added snapshot tests for unsupported shared worker protocols; Added test coverage for child process execution stability; Added test coverage for shared worker timeout behavior; Added test fixture for Node.js assert failure; Added test fixture for environment variable handling; Added test fixture for large binary snapshot data; Added test fixture for snapshot corruption detection; Added test fixtures for AVA runner behavior and configuration; Added test fixtures for assertion failure scenarios; Added test fixtures for configuration loading and error handling; Added test fixtures for deterministic snapshot ordering; Added test fixtures for globs directory and file filtering; Added test fixtures for line-number selection with source map support; Added test fixtures for snapshot location verification; Added test fixtures for snapshot removal scenarios; Added test fixtures for t.timeout() message validation; Added test for multiline snapshot labels; Added test helper for snapshot pruning verification; Added test helper for watch mode assertions; Added test helper macros for snapshot workflow assertions; Added test helpers and fixtures for process exit interception; Added tests for AVA macro functionality; Added tests for AVA meta properties in ESM contexts; Added tests for Node.js assertion failure reporting; Added tests for concurrency flag validation and line-number test selection; Added tests for conditional chain modifiers; Added tests for environment variable handling and extension configuration validation; Added tests for external assertion error snapshots; Added tests for globs configuration validation and file filtering; Added tests for hook restrictions on t.snapshot() and t.try(); Added tests for idle timeout behavior with console output; Added tests for internal event emission; Added tests for loading multiple shared workers; Added tests for multiple implementation validation; Added tests for node argument filtering in worker threads; Added tests for node argument handling in worker threads; Added tests for shared worker error handling and lifecycle; Added tests for shared worker lifecycle; Added tests for shared worker lifecycle and teardown; Added tests for shared worker loading behavior; Added tests for shared worker plugin error handling and protocol negotiation; Added tests for shared worker protocol fixtures; Added tests for shared worker thread restriction; Added tests for snapshot corruption handling, multiline labels, and large data encoding; Added tests for snapshot pruning behavior; Added tests for snapshot report regeneration; Added tests for snapshot workflow behaviors; Added tests for t.timeout() assertion message support; Added tests for the config require feature; Added tests for the new ESM-based configuration loading system; Added tests for the new watch mode implementation; Added tests for the test scheduler behavior; Added tests for worker thread execution behavior; Comprehensive TypeScript type tests for assertions, macros, and control flow; New integration tests for AVA CLI behavior and snapshot management; New test infrastructure helpers for reporter and CLI testing; Self-hosted test suite for AVA; Tests for deterministic snapshot ordering and report sorting; Updated reporter test snapshots for Node.js 22, 24, and 26; Updated test snapshots for AVA assertion behavior; Updated test snapshots for Node.js 22, 24, and 26 assertion outputs.

Dependencies

AVA 8.0.1 release with Node.js 26 support and pnpm 12 tooling

This release updates the AVA test runner to version 8.0.1, raising the minimum supported Node.js versions to 22.20, 24.12, and 26. It introduces official support for Node.js 26 in the test matrix and engine requirements. The project has migrated its development tooling to pnpm 12, which is now enforced via devEngines and reflected in the new pnpm-lock.yaml. Additionally, the package structure has been modernized with explicit CJS/ESM entrypoints, and the TypeScript provider dependency has been bumped to @ava/typescript 7.

(dependencies) · high confidence

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

How this codebase got here

Score

  • CAI 55 → 56 (+0.1)
  • Rubric changed (rubric-2026.10.5 → rubric-2026.11.4) — scores are not directly comparable.

Lenses

  • Code Health 51 → 50 (-0.9)
  • Architecture 98 → 98 (-0.3)
  • Maturity 55 → 62 (+7.1)
  • Readiness 55 → 54 (-0.2)
  • Security 81 → 74 (-6.8)
  • Performance 60 → 60 (+0.0)

Resolved (5)

  • High secret: WD-SECRET-0005 (package-lock.json)
  • No ADRs found
  • Off-boarding risk: anonymized user #1
  • Rotate the exposed credentials — git history can't be un-committed
  • Test project verifies nothing: test/test-timeouts/fixtures (test/test-timeouts/fixtures/custom-message.js)

New (11)

  • Further sole-owners (lower concentration)
  • Hotspot: lib/reporters/default.js (lib/reporters/default.js)
  • Hotspot: lib/run-status.js (lib/run-status.js)
  • Medium CVE: [GHSA redacted] (pnpm-lock.yaml)
  • Medium CVE: [GHSA redacted] (pnpm-lock.yaml)
  • No ADRs found (package.json)
  • Off-boarding risk: anonymized user #1
  • Outdated (npm): @vercel/nft
  • Outdated (npm): ci-info
  • Outdated (npm): cli-truncate
  • RunStatus.emitStateChange (cognitive 18) (lib/run-status.js)

Changes since last survey

  • 9 commits — 9 feature/other, 0 fixes

By area

  • (root) — 2 commits
  • docs/04-snapshot-testing.md — 1 commit
  • examples/typescript-build — 1 commit
  • lib/load-config.js — 1 commit
  • lib/reporters — 1 commit
  • test-tap/reporters — 1 commit
  • test/meta — 1 commit
  • test/test-duration — 1 commit

Notable commits

  • change: Avoid finish retry, ensuring teardowns run only once (#3488)
  • change: Don't confuse ENOENT thrown by config code with the config file not existing
  • change: Expose debugging state in test.meta.debugMode
  • change: Make timeout work for synchronous tests (#3495)
  • change: Only strip a leading test- from file names in test title prefixes (#3494)
  • change: Report how many snapshots were updated or removed
  • change: Update TypeScript documentation (#3489)
  • change: v8.3.0
  • change: v8.4.0

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

Survey your own repository

avajs/ava was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.

About this page

  • The score is its most recent published measurement, taken on 15 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
  • Measured at commit a4fb2094052078faca5094fbe8cab7cbf18c785b — the exact code this score is about.
  • Scored under rubric-2026.11.4 — the same rubric and the same method as every other entry in this index.
  • Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.65+preprod-3c33c1882dc1.