Files
SeedPass/docs/tui_v2_large_vault_validation.md
T

49 lines
1.2 KiB
Markdown

# TUI v2 Large-Vault Validation
Status: Added on `beta` (March 1, 2026).
This document defines a deterministic, CI-like validation pass for TUI v2 behavior at large vault sizes.
## What Is Validated
- Pagination behavior across large deterministic datasets.
- Detail preview truncation behavior for large document content.
## Test Module
- `src/tests/test_tui_v2_large_vault_validation.py`
## Deterministic Data Profile
- Standard profile: `10,000` entries.
- Stress profile: `50,000` entries (`--stress`).
- Labels are deterministic (`Entry-000000` style).
## Runtime Thresholds
Pagination scan budget (wall-clock for scan loop):
- `10,000` rows: `<= 2.0s`
- `50,000` rows: `<= 8.0s`
Detail truncation checks:
- Confirms bounded preview behavior at large content sizes.
## Commands
Standard CI-like run:
```bash
.venv/bin/python -m pytest -q src/tests/test_tui_v2_large_vault_validation.py
```
Extended stress run:
```bash
.venv/bin/python -m pytest -q --stress src/tests/test_tui_v2_large_vault_validation.py
```
## Notes
- Stress tests are opt-in in this repository (require `--stress`).
- Thresholds are intentionally conservative to reduce environment flakiness while still catching regressions.