SeedPass/docs/tui_v2_large_vault_validation.md

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:

.venv/bin/python -m pytest -q src/tests/test_tui_v2_large_vault_validation.py

Extended stress run:

.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.