QA360 Core Engine

The heart of QA360 - handles proof generation, cryptographic signatures, and evidence vault.

Modules

Proof System

• ProofGenerator - Creates verifiable quality proofs
• SignatureManager - Ed25519 cryptographic signatures
• TrustScoreCalculator - Quantifies test confidence

Evidence Vault

• EvidenceVault - SQLite WAL storage for test history
• HistoryManager - Track changes and trends over time
• AuditTrail - Immutable record of all operations

Crypto & Security

• KeyManager - Secure key generation and storage
• EncryptionService - AES-256-GCM for sensitive data
• IntegrityChecker - Verify data hasn't been tampered

Adapters

| Adapter | Description | Status | |---------|-------------|--------| | playwright-api | REST/GraphQL API testing | ✅ Production | | playwright-ui | UI + Accessibility testing | ✅ Production | | k6-perf | Load & performance testing | ✅ Production | | semgrep-sast | Static security analysis | ✅ Production | | zap-dast | Dynamic security scanning (Docker/local) | ✅ Production | | gitleaks-secrets | Secret detection in code | ✅ Production | | osv-deps | Dependency vulnerability scanning | ✅ Production |

Phase3Runner

The orchestration engine for quality gates:

import { Phase3Runner } from 'qa360-core';

const runner = new Phase3Runner({
  workingDir: process.cwd(),
  pack: packConfig,
});

const result = await runner.run();
// Result includes: gates, trustScore, proofPath, duration

Architecture Principles

• Local-first: No cloud dependencies required
• Cryptographically verifiable: All proofs are signed
• Immutable audit trail: Evidence cannot be altered
• Performance optimized: SQLite WAL for concurrent access

Development

cd core/
npm install
npm run build
npm test

Browser Management

QA360 uses Playwright for browser automation. By default, Chromium is bundled and ready to use.

Check Browser Availability

pnpm browsers:check

Install Browsers

# Install Chromium (usually pre-installed)
pnpm browsers:install:chromium

# Install Firefox
pnpm browsers:install:firefox

# Install WebKit
pnpm browsers:install:webkit

# Install all browsers
pnpm browsers:install:all

Graceful Test Skipping

Tests automatically skip if a required browser is not installed:

⚠️  firefox is optional and not installed. Install with: npx playwright install firefox
⊘ Firefox Browser E2E > should launch Firefox browser ... Skipped

Documentation

• Browser Support - Complete browser management guide
• Multi-Browser Strategy - Cross-browser testing approach
• CHECKLIST_VALIDATION - Feature coverage matrix