TenantAtlas/tests/Unit/Support/References/RelatedContextReferenceAdapterTest.php
ahmido 8ee1174c8d feat: add resolved reference presentation layer (#161)
## Summary
- add the shared resolved-reference foundation with registry, resolvers, presenters, and badge semantics
- refactor related context, assignment evidence, and policy-version assignment rendering toward label-first reference presentation
- add Spec 132 artifacts and focused Pest coverage for reference resolution, degraded states, canonical linking, and tenant-context carryover

## Verification
- `vendor/bin/sail bin pint --dirty --format agent`
- focused Pest verification was marked complete in the task artifact

## Notes
- this PR is opened from the current session branch
- `specs/132-guid-context-resolver/tasks.md` reflects in-progress completion state for the implemented tasks

Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de>
Reviewed-on: #161
2026-03-10 18:52:52 +00:00

71 lines
2.8 KiB
PHP

<?php
declare(strict_types=1);
use App\Support\Navigation\NavigationMatrixRule;
use App\Support\Navigation\RelatedActionLabelCatalog;
use App\Support\References\ReferenceClass;
use App\Support\References\ReferenceLinkTarget;
use App\Support\References\ReferenceResolutionState;
use App\Support\References\ReferenceStatePresenter;
use App\Support\References\ReferenceTechnicalDetail;
use App\Support\References\ReferenceTypeLabelCatalog;
use App\Support\References\RelatedContextReferenceAdapter;
use App\Support\References\ResolvedReference;
use App\Support\References\ResolvedReferencePresenter;
it('adapts a resolved reference into a related context entry payload', function (): void {
$adapter = new RelatedContextReferenceAdapter(
new RelatedActionLabelCatalog,
new ResolvedReferencePresenter(new ReferenceTypeLabelCatalog, new ReferenceStatePresenter),
);
$entry = $adapter->adapt(
new NavigationMatrixRule('finding', 'detail_section', 'source_run', 'operation_run', 'canonical_page', 10),
new ResolvedReference(
referenceClass: ReferenceClass::OperationRun,
rawIdentifier: '44',
primaryLabel: 'Baseline compare',
secondaryLabel: 'Run #44',
state: ReferenceResolutionState::Resolved,
stateLabel: null,
linkTarget: new ReferenceLinkTarget(
targetKind: ReferenceClass::OperationRun->value,
url: '/admin/operations/44',
actionLabel: 'View run',
contextBadge: 'Tenant context',
),
technicalDetail: ReferenceTechnicalDetail::forIdentifier('44'),
),
);
expect($entry)->not->toBeNull()
->and($entry?->targetUrl)->toBe('/admin/operations/44')
->and($entry?->reference)->not->toBeNull()
->and($entry?->reference['stateLabel'])->toBe('Resolved')
->and($entry?->reference['showStateBadge'])->toBeFalse();
});
it('respects hide policies for degraded references', function (): void {
$adapter = new RelatedContextReferenceAdapter(
new RelatedActionLabelCatalog,
new ResolvedReferencePresenter(new ReferenceTypeLabelCatalog, new ReferenceStatePresenter),
);
$entry = $adapter->adapt(
new NavigationMatrixRule('finding', 'list_row', 'baseline_snapshot', 'baseline_snapshot', 'direct_record', 10, missingStatePolicy: 'hide'),
new ResolvedReference(
referenceClass: ReferenceClass::BaselineSnapshot,
rawIdentifier: '88',
primaryLabel: 'Baseline snapshot',
secondaryLabel: null,
state: ReferenceResolutionState::Inaccessible,
stateLabel: null,
linkTarget: null,
technicalDetail: ReferenceTechnicalDetail::forIdentifier('88'),
),
);
expect($entry)->toBeNull();
});