TenantAtlas/specs/388-resolution-proof-currentness-contract-v1/artifacts/screenshots/proof-state-evidence.md
ahmido 83c679cf85 feat: add review publication proof currentness contract (#459)
Automated PR created by Codex via Gitea API.

Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de>
Reviewed-on: #459
2026-06-19 19:10:35 +00:00

26 lines
2.2 KiB
Markdown

# Spec 388 Proof-State Evidence
Spec 388 changes proof-state labels inside the existing Review Publication Resolution technical disclosure. It does not add a route, navigation entry, panel provider, primary action, or customer-facing proof surface.
## Browser Smoke Decision
- No dedicated `tests/Browser/Spec388ReviewPublicationProofCurrentnessSmokeTest.php` was added.
- The existing page-family smoke `tests/Browser/Spec387ReviewPublicationResolutionDecisionUxTest.php` was reused for real-browser coverage of the resolution page shell, decision-first layout, technical disclosure family, and readonly inspection mode.
- Proof-state permutations are covered by deterministic Livewire/feature tests in `tests/Feature/EnvironmentReview/Spec388ReviewPublicationProofCurrentnessTest.php`.
## Covered States
- Current proof: Livewire assertion sees `Current proof` on the resolution page.
- Superseded failed proof: Livewire assertion sees `Superseded by newer result` after a newer `StoredReport` supersedes an old failed operation.
- Stale evidence proof: feature assertion keeps `collect_evidence_snapshot` actionable with `proof.evidence_stale`.
- Stale review-pack proof: feature assertion keeps `generate_review_pack` actionable with `proof.review_pack_stale`.
- Successful operation without artifact: feature assertion keeps the proof `inspection_only`.
- Customer boundary: customer workspace regression asserts no proof reason codes, step keys, OperationRun internals, or `proof_currentness` leak.
- Readonly/browser boundary: existing Spec 387 browser smoke passed readonly inspection copy on the same resolution page family.
## Validation Commands
- `cd apps/platform && ./vendor/bin/sail artisan test --compact tests/Unit/Support/ReviewPublicationResolution tests/Feature/EnvironmentReview/Spec388ReviewPublicationProofCurrentnessTest.php`
- `cd apps/platform && ./vendor/bin/sail artisan test --compact tests/Feature/EnvironmentReview/Spec386ReviewPublicationResolutionWorkflowTest.php tests/Feature/EnvironmentReview/Spec387ReviewPublicationResolutionDecisionUxTest.php`
- `cd apps/platform && ./vendor/bin/sail php vendor/bin/pest tests/Browser/Spec387ReviewPublicationResolutionDecisionUxTest.php`