TenantAtlas/tests/Unit/Support/GovernanceArtifactTruth/BaselineSnapshotArtifactTruthTest.php
ahmido 8426741068 feat: add baseline snapshot truth guards (#189)
## Summary
- add explicit BaselineSnapshot lifecycle truth with conservative backfill and a shared truth resolver
- block baseline compare from building, incomplete, or superseded snapshots and align workspace/tenant UI truth surfaces with effective snapshot state
- surface artifact truth separately from operation outcome across baseline profile, snapshot, compare, and operation run pages

## Testing
- integrated browser smoke test on the active feature surfaces
- `vendor/bin/sail artisan test --compact tests/Feature/Filament/BaselineSnapshotTruthSurfaceTest.php tests/Feature/Filament/BaselineProfileCompareStartSurfaceTest.php`
- targeted baseline lifecycle and compare guard coverage added in Pest
- `vendor/bin/sail bin pint --dirty --format agent`

## Notes
- Livewire v4 compliance preserved
- no panel provider registration changes were needed; Laravel 12 providers remain in `bootstrap/providers.php`
- global search remains disabled for the affected baseline resources by design
- destructive actions remain confirmation-gated; capture and compare actions keep their existing authorization and confirmation behavior
- no new panel assets were added; existing deploy flow for `filament:assets` is unchanged

Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de>
Reviewed-on: #189
2026-03-23 11:32:00 +00:00

91 lines
3.6 KiB
PHP

<?php
declare(strict_types=1);
use App\Models\BaselineProfile;
use App\Models\BaselineSnapshot;
use App\Models\Workspace;
use App\Support\Baselines\BaselineReasonCodes;
use App\Support\Ui\GovernanceArtifactTruth\ArtifactTruthPresenter;
use Illuminate\Foundation\Testing\RefreshDatabase;
uses(RefreshDatabase::class);
it('marks complete snapshots as trustworthy current baseline truth', function (): void {
$workspace = Workspace::factory()->create();
$profile = BaselineProfile::factory()->active()->create([
'workspace_id' => (int) $workspace->getKey(),
]);
$snapshot = BaselineSnapshot::factory()->complete()->create([
'workspace_id' => (int) $workspace->getKey(),
'baseline_profile_id' => (int) $profile->getKey(),
'summary_jsonb' => [
'total_items' => 0,
'fidelity_counts' => ['content' => 0, 'meta' => 0],
'gaps' => ['count' => 0, 'by_reason' => []],
],
]);
$profile->update(['active_snapshot_id' => (int) $snapshot->getKey()]);
$truth = app(ArtifactTruthPresenter::class)->forBaselineSnapshot($snapshot->fresh());
expect($truth->primaryLabel)->toBe('Trustworthy artifact')
->and($truth->artifactExistence)->toBe('created')
->and($truth->freshnessState)->toBe('current')
->and($truth->diagnosticLabel)->toBe('Complete')
->and($truth->nextStepText())->toBe('No action needed');
});
it('marks incomplete snapshots as unusable and preserves the stored reason code', function (): void {
$workspace = Workspace::factory()->create();
$profile = BaselineProfile::factory()->active()->create([
'workspace_id' => (int) $workspace->getKey(),
]);
$snapshot = BaselineSnapshot::factory()->incomplete(BaselineReasonCodes::SNAPSHOT_CAPTURE_FAILED)->create([
'workspace_id' => (int) $workspace->getKey(),
'baseline_profile_id' => (int) $profile->getKey(),
]);
$truth = app(ArtifactTruthPresenter::class)->forBaselineSnapshot($snapshot);
expect($truth->primaryLabel)->toBe('Artifact not usable')
->and($truth->artifactExistence)->toBe('created_but_not_usable')
->and($truth->contentState)->toBe('missing_input')
->and($truth->diagnosticLabel)->toBe('Incomplete')
->and($truth->reason?->reasonCode)->toBe(BaselineReasonCodes::SNAPSHOT_CAPTURE_FAILED);
});
it('marks older complete snapshots as historical after a newer complete snapshot becomes current', function (): void {
$workspace = Workspace::factory()->create();
$profile = BaselineProfile::factory()->active()->create([
'workspace_id' => (int) $workspace->getKey(),
]);
$historicalSnapshot = BaselineSnapshot::factory()->complete()->create([
'workspace_id' => (int) $workspace->getKey(),
'baseline_profile_id' => (int) $profile->getKey(),
'captured_at' => now()->subDay(),
'completed_at' => now()->subDay(),
]);
$currentSnapshot = BaselineSnapshot::factory()->complete()->create([
'workspace_id' => (int) $workspace->getKey(),
'baseline_profile_id' => (int) $profile->getKey(),
'captured_at' => now(),
'completed_at' => now(),
]);
$profile->update(['active_snapshot_id' => (int) $currentSnapshot->getKey()]);
$truth = app(ArtifactTruthPresenter::class)->forBaselineSnapshot($historicalSnapshot->fresh());
expect($truth->primaryLabel)->toBe('Historical artifact')
->and($truth->artifactExistence)->toBe('historical_only')
->and($truth->freshnessState)->toBe('stale')
->and($truth->diagnosticLabel)->toBe('Superseded')
->and($truth->reason?->reasonCode)->toBe(BaselineReasonCodes::SNAPSHOT_SUPERSEDED);
});