test-fortress
v1.1.0
Published
Test Fortress — 23-agent multi-agent testing orchestration framework
Downloads
236
Readme
Autonomous multi-phase testing pipeline with 23 specialized agents. Runs Alpha through Release with quality gates, self-healing fix loops, and zero manual intervention.
Quick Start
# 1. Initialize in your project
npx test-fortress init
# 2. Configure (edit the generated config)
vi test-fortress.config.ts
# 3. Run
npx test-fortress --phase alphaThe init wizard auto-detects your framework, test runner, and scaffolds configuration.
Why Test Fortress
- 4-phase pipeline -- Alpha, Beta, UAT, Release with quality gates that block promotion on failure
- 23 specialized agents -- each owns a single testing concern (a11y, security, perf, visual regression, chaos, and more)
- Self-healing fix loop -- Healer and Fixer agents attempt automatic remediation before gate evaluation
- Visual regression -- pixel-level screenshot diffing with baseline management
- Cost-controlled -- per-run and per-agent budget limits with configurable abort/alert policies
- Framework-agnostic -- React, Next.js, Vue, Angular, NestJS, Express, or any project
Agent Roster
| # | Agent | Phase(s) | Tier | |---|-------|----------|------| | 1 | Analyst | Alpha | Free | | 2 | Seed Architect | Alpha | Free | | 3 | Test Generator | Alpha | Free | | 4 | Unit Runner | Alpha | Free | | 5 | Browser Crawler | Alpha, Beta, UAT | Free | | 6 | API Exerciser | Beta, UAT | Free | | 7 | Security Scout | Beta | Free | | 8 | A11y Guardian | Beta | Free | | 9 | Healer | Fix Loop | Pro | | 10 | Reporter | Release | Pro | | 11 | Fixer | Fix Loop | Pro | | 12 | UX Inspector | Beta, UAT | Pro | | 13 | Performance Profiler | Beta, UAT | Pro | | 14 | Data Integrity Auditor | Beta, UAT | Pro | | 15 | Regression Sentinel | Beta, UAT | Pro | | 16 | Chaos Agent | Beta | Enterprise | | 17 | Documentation Validator | UAT | Enterprise | | 18 | Integration Watchdog | Beta, UAT | Enterprise | | 19 | Tenant Isolation Auditor | Beta, UAT | Enterprise | | 20 | Workflow Completion Tester | UAT | Enterprise | | 21 | State/Session Tester | Beta, UAT | Enterprise | | 22 | Email/Notification Verifier | Beta, UAT | Enterprise | | 23 | Migration Tester | Alpha | Enterprise |
Architecture
Alpha --> [gate] --> Beta --> [gate] --> UAT --> [gate] --> Release
| | |
+------- Fix Loop (Healer + Fixer) ---+Each phase dispatches its agents, evaluates findings against blocking/advisory classification, and promotes to the next phase only if the gate passes. The fix loop runs automatically when agents detect issues.
Pricing
| Plan | Price | Agents | Support | |------|-------|--------|---------| | Free | $0 | 8 agents (1--8) | Community | | Pro | $49/mo | 17 agents (1--15) | Priority email | | Enterprise | $199/mo | All 23 agents + custom | Dedicated support, SLA |
All plans include the CLI, init wizard, and config validation. Pro and Enterprise unlock the fix loop, Reporter, and advanced agents.
CI Integration
GitHub Actions
name: Test Fortress
on: [push, pull_request]
jobs:
test-fortress:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: 20
- run: npm ci
- run: npx playwright install --with-deps
- run: npx test-fortress --phase all
env:
TF_ADMIN_EMAIL: ${{ secrets.TF_ADMIN_EMAIL }}
TF_ADMIN_PASSWORD: ${{ secrets.TF_ADMIN_PASSWORD }}CLI Reference
Usage: test-fortress [options]
Commands:
init Initialize Test Fortress
Options:
--phase <alpha|beta|uat|release|all> Phase to run
--dry-run Show dispatch plan without executing
--agent <id> Run a single agent by ID
--config <path> Path to config file
--help Show helpConfiguration
import type { TestFortressConfig } from 'test-fortress/config';
const config: TestFortressConfig = {
schemaVersion: 1,
name: 'my-app',
modules: [
{ id: 'dashboard', route: '/dashboard', sidebarIcon: true },
],
environments: {
alpha: { baseUrl: 'http://localhost:3000', seed: true },
beta: { baseUrl: 'https://staging.example.com', seed: false },
},
};
export default config;See the full configuration reference for all options including auth, breakpoints, cost budgets, thresholds, and agent classification.
Contributing
See CONTRIBUTING.md for setup instructions, how to create custom agents, code style, and PR workflow.
Documentation
Full docs: docs.test-fortress.dev
License
MIT -- Copyright 2026 BAS & More Pty Ltd
