TenantAtlas/app/Support/References/Resolvers/FallbackReferenceResolver.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

52 lines
1.8 KiB
PHP

<?php
declare(strict_types=1);
namespace App\Support\References\Resolvers;
use App\Support\References\Contracts\ReferenceResolver;
use App\Support\References\ReferenceClass;
use App\Support\References\ReferenceDescriptor;
use App\Support\References\ReferenceResolutionState;
use App\Support\References\ReferenceTechnicalDetail;
use App\Support\References\ResolvedReference;
final class FallbackReferenceResolver implements ReferenceResolver
{
public function referenceClass(): ReferenceClass
{
return ReferenceClass::Unsupported;
}
public function resolve(ReferenceDescriptor $descriptor): ResolvedReference
{
$primaryLabel = $descriptor->fallbackLabel;
$primaryLabel = is_string($primaryLabel) && trim($primaryLabel) !== ''
? trim($primaryLabel)
: 'Unresolved reference';
$state = $descriptor->fallbackLabel !== null
? ReferenceResolutionState::PartiallyResolved
: ReferenceResolutionState::Unresolved;
return new ResolvedReference(
referenceClass: $descriptor->referenceClass,
rawIdentifier: $descriptor->rawIdentifier,
primaryLabel: $primaryLabel,
secondaryLabel: $descriptor->contextValue('secondary_label'),
state: $state,
stateLabel: null,
linkTarget: null,
technicalDetail: ReferenceTechnicalDetail::forIdentifier(
fullId: $descriptor->rawIdentifier,
sourceHint: is_string($descriptor->contextValue('source_hint'))
? $descriptor->contextValue('source_hint')
: null,
),
meta: [
'state_description' => $descriptor->contextValue('state_description'),
],
);
}
}