Files
SeedPass/docs/TEST_INVENTORY.md
T
thePR0M3TH3AN 4eeb936e6d docs(test): centralize test infrastructure and add interactive agent harness
Added docs/TEST_INVENTORY.md as a central index for all tests and runners.
Created scripts/interactive_agent_tui_test.py for password-free TUI v2
exploratory testing. Integrated standalone permission tests into main
suite and fixed TUI v2 parity regression tests broken by auto-selection
removal. Updated AGENTS.md and CLAUDE.md with strategic plan references.
2026-03-02 22:26:35 -05:00

37 lines
1.7 KiB
Markdown

# Test Infrastructure Inventory
This document provides a central index of all SeedPass tests, runners, and automation scripts.
## Core Test Runners
| Script / Command | Target | Coverage |
|-----------------|--------|----------|
| `bash scripts/run_ci_tests.sh` | **Full Suite** | Pytest (CLI, API, TUI v2), Determinism, Coverage |
| `pytest src/tests/` | **Unit/Integration** | Core logic, API, CLI, Encryption |
| `bash scripts/run_gui_tests.sh` | **GUI (BeeWare)** | Headless & Desktop GUI behavioral tests |
| `bash run_flake_tests.sh` | **Stability** | Runs suite multiple times to catch flakes |
| `.venv/bin/python scripts/interactive_agent_tui_test.py` | **Interactive TUI v2** | Mock-service based exploratory walkthrough |
## Specialized Automation
### Determinism
- `bash scripts/run_determinism_tests.sh`: Validates BIP85 compliance and cross-platform artifact consistency.
### TUI v2 Specific
- `src/tests/test_tui_v2_*`: Textual-based unit tests for the v2 interface.
- `scripts/ai_tui2_agent_test.py`: Legacy agent harness for TUI v2.
- `docs/INTERACTIVE_AGENT_TESTING.md`: Guide for manual/agent exploratory testing.
### API & CLI
- `src/tests/test_api*.py`: FastAPI-based backend endpoints.
- `src/tests/test_typer_cli.py`: Typer-based command line interface.
## Test Data & Artifacts
- `artifacts/coverage/`: Generated HTML/JSON coverage reports.
- `artifacts/ci-flakes-*.md`: Logs from flaky test detection runs.
## Guidelines for Agents
1. **Always run CI tests** before proposing changes: `bash scripts/run_ci_tests.sh`.
2. **Add regression tests** in `src/tests/` for every bug fix.
3. **Use Mock Services** for TUI testing to avoid credential requirements (see `scripts/interactive_agent_tui_test.py`).