TenantAtlas/tests/Feature/Baselines/Support/AssertsStructuredBaselineGaps.php
ahmido c17255f854 feat: implement baseline subject resolution semantics (#193)
## Summary
- add the structured subject-resolution foundation for baseline compare and baseline capture, including capability guards, subject descriptors, resolution outcomes, and operator action categories
- persist structured evidence-gap subject records and update compare/capture surfaces, landing projections, and cleanup tooling to use the new contract
- add Spec 163 artifacts and focused Pest coverage for classification, determinism, cleanup, and DB-only rendering

## Validation
- `vendor/bin/sail bin pint --dirty --format agent`
- `vendor/bin/sail artisan test --compact tests/Unit/Support/Baselines tests/Feature/Baselines tests/Feature/Filament/OperationRunEnterpriseDetailPageTest.php`

## Notes
- verified locally that a fresh post-restart baseline compare run now writes structured `baseline_compare.evidence_gaps.subjects` records instead of the legacy broad payload shape
- excluded the separate `docs/product/spec-candidates.md` worktree change from this branch commit and PR

Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de>
Reviewed-on: #193
2026-03-25 12:40:45 +00:00

44 lines
1023 B
PHP

<?php
declare(strict_types=1);
namespace Tests\Feature\Baselines\Support;
use PHPUnit\Framework\Assert;
final class AssertsStructuredBaselineGaps
{
/**
* @param array<string, mixed> $subject
*/
public static function assertStructuredSubject(array $subject): void
{
foreach ([
'policy_type',
'subject_key',
'subject_class',
'resolution_path',
'resolution_outcome',
'reason_code',
'operator_action_category',
'structural',
'retryable',
] as $key) {
Assert::assertArrayHasKey($key, $subject);
}
}
/**
* @param list<array<string, mixed>> $subjects
*/
public static function assertStructuredSubjects(array $subjects): void
{
Assert::assertNotEmpty($subjects);
foreach ($subjects as $subject) {
Assert::assertIsArray($subject);
self::assertStructuredSubject($subject);
}
}
}