Testing

Audience: Developer, Support Related: Regression Testing · Application Updates · Documentation Standards

Use focused unit and contract tests for services, routes, provider adapters, rendering, and documentation structure, then use the Blackcap regression harness for end-to-end verification. Tests that assert documentation content should reference canonical paths rather than dated implementation reports.

Provider-aware database tests should cover SQLite and PostgreSQL behavior where practical. Deployment validation should check service health, migrations, target-specific infrastructure, and the affected feature.

Focused validation

python -m pytest tests/test_documentation_structure.py
python tools/validate_documentation.py

Run feature-specific tests and then the administrative regression suite appropriate to the change.