Package Exports

@devness/coverit

Readme

coverit

Your code, covered. AI-powered test quality.

What is coverit?

coverit is an AI-powered test quality platform. It scans and analyzes your entire codebase, identifies coverage gaps across 5 quality dimensions, generates tests to fill them, and tracks your score over time — all through a single persistent manifest: coverit.json.

Four commands. That's it.

Quick Start

# Set up coverit (auto-detects your AI tools)
npx @devness/coverit

# Then use via CLI
npx @devness/coverit scan      # AI scans & analyzes your codebase → creates coverit.json
npx @devness/coverit cover     # AI writes tests for gaps → updates your score
npx @devness/coverit run       # Run existing tests, fix failures → updates your score
npx @devness/coverit status    # Show your quality dashboard

How It Works

scan → coverit.json → cover/run → updated coverit.json → status

Command	What happens
scan	AI scans and analyzes your codebase with tool access (read files, search code, run commands). Discovers modules, maps existing tests, classifies complexity, identifies user journeys and API contracts. Produces `coverit.json`.
cover	AI reads gaps from `coverit.json`, writes test files for each module, runs them, fixes failures, and updates the quality score.
run	Runs existing tests, sends failures to AI for fixing, rescans and updates the quality score. Unlike `cover`, doesn't write new tests.
status	Instantly displays your quality dashboard from `coverit.json`. No AI, no scanning.

The Manifest: `coverit.json`

coverit.json is the single source of truth. It's git-tracked, persistent, and contains:

Project info — framework, language, test runner, file/line counts
Modules — each source directory with complexity, file counts, and test coverage (current vs expected)
Quality score — 0-100, weighted across 5 dimensions (ISO 25010)
Gaps — what's missing, ranked by severity
Journeys — user flows that need E2E coverage
Contracts — API endpoints that need contract tests

CLI Reference

Command	Description
`coverit scan [path]`	AI scans and analyzes codebase → creates `coverit.json`
`coverit cover [path]`	AI generates tests from gaps and updates score
`coverit run [path]`	Run existing tests, fix failures, update score
`coverit status [path]`	Show quality dashboard from `coverit.json`
`coverit clear [path]`	Delete `coverit.json` and `.coverit/` for a fresh start

Cover Options

Option	Description
`--modules <paths>`	Only cover specific modules (comma-separated)

Run Options

Option	Description
`--modules <paths>`	Only run tests for specific modules (comma-separated)

Claude Code Integration

npx @devness/coverit handles setup automatically — it configures the MCP server so Claude Code can use coverit's tools directly.

Optionally, install the plugin for slash command shortcuts:

/plugin marketplace add devness-com/coverit
/plugin install coverit@coverit

Slash Command	Description
`/coverit:scan`	AI scans and analyzes codebase → creates `coverit.json`
`/coverit:cover`	AI generates tests from gaps and updates score
`/coverit:run`	Run existing tests, fix failures, update score
`/coverit:status`	Show quality dashboard

MCP Tools

Tool	Description
`coverit_scan`	AI scans and analyzes codebase → `coverit.json`
`coverit_cover`	AI generates tests from gaps → updates score
`coverit_run`	Run existing tests → fix failures → update score
`coverit_status`	Show quality dashboard (instant, no AI)
`coverit_clear`	Delete `coverit.json` and `.coverit/`
`coverit_backup`	Export `coverit.json` as JSON
`coverit_restore`	Import `coverit.json` from backup

Quality Dimensions

coverit measures quality across 5 dimensions mapped to ISO 25010:

Dimension	What it checks
Functionality	Unit, integration, API, E2E, and contract test coverage
Security	OWASP Top 10, injection, auth bypass, data exposure
Stability	Error handling, edge cases, resource cleanup
Conformance	Naming conventions, patterns, architectural rules
Regression	Baseline test results, breaking changes

Testing Diamond

coverit follows the Testing Diamond strategy (not the outdated Testing Pyramid):

Test Type	Target %	Purpose
Integration	~50%	Module boundaries, real dependencies
Unit	~20%	Pure functions, algorithms, edge cases
API	~15%	HTTP endpoints, request/response contracts
E2E	~10%	Critical user journeys
Contract	~5%	API schema validation

Supported Frameworks

Category	Frameworks
API	Hono, Express, NestJS, Fastify
Frontend	React, Next.js
Mobile	React Native, Expo
Desktop	Tauri, Electron
Test Runners	Vitest, Jest, Playwright, Detox, Pytest
Package Managers	Bun, pnpm, npm, yarn

Architecture

┌──────────────┐
│  CLI / MCP   │  ← Entry points (4 commands)
└──────┬───────┘
       │
       ├── scan ────→ AI scans & analyzes ──→ coverit.json
       │
       ├── cover ───→ AI reads gaps ──→ writes tests ──→ runs ──→ updates coverit.json
       │
       ├── run ─────→ runs tests ──→ AI fixes failures ──→ updates coverit.json
       │
       └── status ──→ reads coverit.json ──→ dashboard

src/
├── ai/           AI providers (Claude, Gemini, Codex, Anthropic, OpenAI, Ollama)
├── scale/        Codebase scanner + manifest writer
├── cover/        Test generation pipeline
├── run/          Test run + fix pipeline
├── measure/      Test scanner, scorer, dashboard
├── scoring/      Score engine, weights, thresholds
├── schema/       coverit.json types + defaults
├── types/        Core type definitions
├── utils/        Logger, framework detector
├── mcp/          MCP server (7 tools)
└── cli/          CLI (5 commands)

See docs/architecture.md for details.

Contributing

Contributing guide · Report an issue

License

AGPL-3.0 · devness-com/coverit

@devness/coverit