qa360 2.1.7 → 2.2.0

package/docs/README.md

@@ -0,0 +1,50 @@
+# QA360 Documentation
+
+## Quick Start
+
+- [Quickstart (5 minutes)](./quickstart-5min.md) - Get started fast
+- [Project Status](./STATUS.md) - Current completion metrics
+
+## Core Concepts
+
+- [Pack v1 Specification](./pack-v1.md) - Original pack configuration format
+- [Pack v2 Specification](./pack-v2.md) - New format with authentication profiles
+- [Proofs](./proofs.md) - Cryptographic proof bundles
+- [Evidence Vault](./vault.md) - SQLite evidence storage
+- [Secrets Management](./secrets.md) - Encrypted secrets
+
+## Features
+
+- [Hooks](./hooks.md) - Lifecycle hooks (beforeAll, afterAll, etc.)
+- [Budgets](./budgets-advanced.md) - Performance and security budgets
+- [Serve](./serve.md) - Observability server
+
+## Examples
+
+- [Pack v2 Complete](./examples/pack-v2-complete.yaml) - Full-featured pack v2 example
+- [Pack v2 Quickstart](./examples/pack-v2-quickstart.yaml) - Minimal API testing example
+- [Pack v2 UI Login](./examples/pack-v2-ui-login.yaml) - UI-based authentication example
+
+## Adapters
+
+- [Security Adapters](./adapters-security.md) - SAST, DAST, secrets scanning
+- [ZAP DAST](./adapters/zap-dast.md) - OWASP ZAP integration
+
+## Integration
+
+- [MCP Server](./mcp-server.md) - Model Context Protocol server
+- [MCP Tools](./mcp-tools.md) - Available MCP tools
+- [CI/CD Readiness](./readiness-ci.md) - CI/CD integration guide
+
+## Architecture
+
+- [Architecture Overview](./ARCHITECTURE.md) - System design
+- [Development History](./DEVELOPMENT_HISTORY.md) - Phase completion history
+
+## RFCs
+
+- [RFC Index](./rfc/README.md) - Technical specifications
+
+## Archive
+
+Historical documents and phase reports are in [/docs/archive/](./archive/).

package/docs/STATUS.md

@@ -0,0 +1,198 @@
+# QA360 - Project Status
+
+**Version**: 2.2.0 (Page Object Model released)
+**Last Updated**: January 14, 2026
+**CI Status**: [![CI](https://github.com/xyqotech/qa360/workflows/Tests/badge.svg)](https://github.com/xyqotech/qa360/actions)
+**Tests**: 1915+ passing (Core: 1500+, CLI: 360+, MCP: 46+)
+
+---
+
+## Quick Summary
+
+QA360 est une plateforme de **testing AI-native** qui transforme les tests en preuves cryptographiquement signées.
+
+| Metric | Value |
+|--------|-------|
+| **Overall Completion** | 99% |
+| **Total Tests** | 1915 passing |
+| **CI Platforms** | Node 18, 20, 22 |
+| **TypeScript Files** | 170+ |
+| **Packages** | 3 (cli, core, mcp) |
+
+---
+
+## Current Phase: **Phase 8 COMPLETED - Beta Testing Ready**
+
+We are at **Phase 8** of 9 planned phases.
+
+| Phase | Name | Status | Tests Added |
+|-------|------|--------|-------------|
+| 0-7 | Core Platform | ✅ Complete | 1676 |
+| 8 | TUI & Dashboard | ✅ Complete | 183 |
+| 9 | Parallel CI | ⏳ Next | - |
+
+### Beta Testing Program
+
+A comprehensive beta testing plan is available at [`BETA_TESTING_PLAN.md`](./BETA_TESTING_PLAN.md):
+
+- **E2E Tests**: 27 automated tests covering all major CLI commands
+- **AI Scenarios**: Ollama (local), OpenAI/Anthropic (cloud), `ask` command
+- **Target**: 8-12 testers over 2 weeks
+- **Success Metrics**: >90% installation, >70% first pack completion
+
+---
+
+## Completed Features
+
+### ✅ Phase 0-5: Core Platform
+- **CLI Commands**: run, verify, report, doctor, ask, serve, secrets
+- **Pack System**: v1 and v2 support with auto-migration
+- **9 Auth Providers**: JWT, OAuth2, API Key, Bearer, Basic, TOTP, UI Login, GCP ADC, AWS IAM, Azure AD
+- **7 Adapters**: Playwright API/UI, K6, Semgrep, ZAP, Gitleaks, OSV
+- **Evidence Vault**: SQLite with WAL mode + Content Addressable Storage
+- **Proof System**: Ed25519 cryptographic signatures
+
+### ✅ Phase 6: Test Data Intelligence (TDI)
+- **TestAnalyzer**: Parse tests, detect framework (Jest/Vitest/Mocha/Jasmine)
+- **CoverageEngine**: Coverage analysis integration
+- **DuplicationDetector**: Duplicate detection with Levenshtein algorithm
+- **SuggestionGenerator**: LLM-based test suggestions
+- **HealthCalculator**: Score 0-100 based on coverage, duplication, assertions
+- **CLI**: `qa360 tdi analyze|suggest|health`
+
+### ✅ Phase 7: Auto-Repair Module
+- **ErrorAnalyzer**: Classify test errors (8 types)
+- **SuggestionEngine**: Generate fix suggestions via LLM
+- **CodeFixer**: Apply automatic fixes with backup
+- **TestRepairer**: Orchestrate repair cycles (up to 3 iterations)
+- **CLI**: `qa360 repair analyze|suggest|fix|interactive`
+
+### ✅ Phase 8: TUI & Dashboard
+- **TerminalRenderer**: Pure ANSI/Unicode rendering (no external dependencies)
+- **TUIMonitor**: Real-time test execution monitoring in terminal
+- **DashboardServer**: HTTP server with Server-Sent Events
+- **Web Dashboard**: Embedded HTML/CSS/JS dashboard (no external files)
+- **CLI**: `qa360 monitor`, `qa360 dashboard`
+
+### ✅ v2.2: Unit Test Adapters
+- **VitestAdapter**: Ingest Vitest JSON results and coverage
+- **JestAdapter**: Ingest Jest JSON results and coverage
+- **PytestAdapter**: Ingest Pytest JUnit XML results and coverage
+- **Coverage Thresholds**: Enforce minimum coverage percentages
+- **Test Pyramid**: Track unit/integration/E2E test distribution
+- **Documentation**: [unit-test-adapters.md](./unit-test-adapters.md)
+
+### ✅ v2.2: Page Object Model (POM)
+- **POM Loader**: Dynamic loading of Page Objects from TS/JS files
+- **BasePage**: Framework-agnostic base class
+- **PlaywrightBasePage**: Pre-configured for Playwright
+- **PuppeteerBasePage**: Pre-configured for Puppeteer
+- **Selector Management**: Centralized, type-safe selector access
+- **URL Utilities**: Build, parse, and match URLs
+- **Page Validation**: Ensure pages implement required interface
+- **21 Tests**: Comprehensive POM loader and base page tests
+- **Documentation**: [page-objects.md](./page-objects.md)
+
+---
+
+## Module Coverage
+
+| Module | Coverage | Status |
+|--------|----------|--------|
+| proof/ | 76.8% | ✅ |
+| vault/ | 90.3% | ✅ |
+| secrets/ | 84.8% | ✅ |
+| pack-v2/ | 85%+ | ✅ |
+| auth/ | 80%+ | ✅ |
+| ai/ | 75%+ | ✅ |
+| generation/ | 82.9% | ✅ |
+| tdi/ | 80%+ | ✅ |
+| repair/ | 85%+ | ✅ |
+| tui/ | 85%+ | ✅ |
+| dashboard/ | 85%+ | ✅ |
+| security/ | 52.3% | 🟡 |
+| adapters/ | 6.9% | 🟡 |
+
+---
+
+## CLI Reference
+
+```
+qa360 run [pack]           # Execute test pack
+qa360 verify [proof]       # Verify cryptographic proof
+qa360 report               # Generate signed proof report
+qa360 doctor               # Health check and auto-fix
+qa360 ask [query]          # Natural language → pack.yml
+qa360 pack validate        # Validate pack configuration
+qa360 pack migrate         # Migrate v1 → v2
+qa360 secrets add/list     # Manage encrypted secrets
+qa360 history list/show    # View run history
+qa360 tdi analyze          # Analyze test health
+qa360 repair analyze       # Analyze and fix test failures
+qa360 generate <source>    # Generate tests with AI
+qa360 monitor [pack]       # Run tests with terminal UI (NEW)
+qa360 dashboard [pack]     # Run tests with web dashboard (NEW)
+```
+
+---
+
+## Next Steps
+
+### Phase 9: Parallel CI (Planned)
+- Parallel test execution
+- Consolidated proof generation
+- CI/CD optimization
+
+---
+
+## Technology Stack
+
+| Layer | Technology |
+|-------|------------|
+| Runtime | Node.js 18+ |
+| Language | TypeScript 5+ |
+| Testing | Vitest 1.6.0 |
+| Monorepo | pnpm workspaces |
+| Crypto | Ed25519 (tweetnacl) |
+| Storage | SQLite + CAS |
+| AI | Ollama (local), OpenAI, Anthropic |
+| UI | Pure ANSI/Unicode TUI, Server-Sent Events |
+
+---
+
+## Error Codes
+
+| Code | Meaning | Solution |
+|------|---------|----------|
+| QX001 | Node.js < 18 required | `nvm install 18` |
+| QX002 | .qa360 directories missing | `qa360 doctor --fix` |
+| QX003 | Playwright not installed | `npx playwright install` |
+| QX004 | Puppeteer missing | `npm install puppeteer` |
+| QX005 | Network issues | Check proxy/firewall |
+| QX006 | Secrets missing | `qa360 doctor --fix` |
+| QX007 | Crypto keys missing | `qa360 doctor --fix` |
+
+---
+
+## Version History
+
+| Version | Date | Changes |
+|---------|------|---------|
+| 1.4.8 | Jan 1, 2026 | Phase 8: TUI & Dashboard |
+| 1.4.7 | Jan 1, 2026 | Phase 7: Auto-Repair Module |
+| 1.4.6 | Jan 1, 2026 | Phase 6: Test Data Intelligence |
+| 1.4.5 | Dec 31, 2024 | Phase 5: Multi-provider LLM |
+| 1.4.4 | Dec 31, 2024 | Phase 4: AI Test Generation |
+| 1.4.3 | Dec 31, 2024 | Phase 3: Pack v2 Validation |
+| 1.4.2 | Dec 31, 2024 | Phase 2: Auth Module |
+| 1.4.1 | Dec 31, 2024 | Phase 1: Ollama Integration |
+
+---
+
+## Links
+
+- **Development Guide**: [DEVELOPMENT.md](./DEVELOPMENT.md)
+- **Architecture**: [ARCHITECTURE.md](./ARCHITECTURE.md)
+- **User Guide**: [USER_GUIDE.md](./USER_GUIDE.md)
+- **GitHub**: https://github.com/xyqotech/qa360
+- **npm**: https://www.npmjs.com/package/qa360