Introduction

Suitener is a Bun-native TypeScript CLI and core library for backend test discovery, execution, stub generation, and structured JSON reporting.

It does four things:

1. Scans a backend project.
2. Detects the project shape and existing test setup.
3. Runs existing tests, or generates minimal test stubs when tests are missing.
4. Writes stable JSON results to suitener-results/latest.json.

It is built for agentic backend development where the useful output is a small, stable JSON file instead of a pile of terminal logs.

Packages

Package	Purpose
suitener	CLI package. Provides the suitener command.
suitener-core	Programmatic library used by the CLI.

Scope

In scope:

• Bun-native TypeScript CLI
• core library for programmatic use
• backend type detection
• test suite detection
• test execution through detected commands
• generated Bun test stubs
• structured JSON reports
• stable latest.json
• dev command wrapping
• minimal ANSI terminal output

Out of scope:

• auto-fixes
• suggested fixes
• agent orchestration
• plugin system
• web dashboard
• CI/CD integration layer
• secrets or env management
• replacing Jest, Vitest, Bun test, Go test, Cargo test, or other real test runners