ahmido
8ee1174c8d
## 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
40 lines
1.6 KiB
PHP
40 lines
1.6 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace App\Support\References;
|
|
|
|
use App\Support\Badges\BadgeDomain;
|
|
use App\Support\Badges\BadgeRenderer;
|
|
use App\Support\Badges\BadgeSpec;
|
|
|
|
final class ReferenceStatePresenter
|
|
{
|
|
public function badgeSpec(ReferenceResolutionState|string $state): BadgeSpec
|
|
{
|
|
$normalized = $state instanceof ReferenceResolutionState ? $state->value : $state;
|
|
|
|
return BadgeRenderer::spec(BadgeDomain::ReferenceResolutionState, $normalized);
|
|
}
|
|
|
|
public function description(ResolvedReference $reference, string $typeLabel): ?string
|
|
{
|
|
$description = $reference->meta['state_description'] ?? null;
|
|
|
|
if (is_string($description) && trim($description) !== '') {
|
|
return trim($description);
|
|
}
|
|
|
|
$subject = mb_strtolower($typeLabel);
|
|
|
|
return match ($reference->state) {
|
|
ReferenceResolutionState::Resolved => null,
|
|
ReferenceResolutionState::PartiallyResolved => "Showing the best {$subject} label available from local context.",
|
|
ReferenceResolutionState::Unresolved => "Only the preserved technical identifier is available for this {$subject}.",
|
|
ReferenceResolutionState::DeletedOrMissing => "The referenced {$subject} is no longer available locally.",
|
|
ReferenceResolutionState::Inaccessible => "The referenced {$subject} is not available in the current scope.",
|
|
ReferenceResolutionState::ExternalLimitedContext => "This {$subject} comes from provider evidence and only limited cached context is available.",
|
|
};
|
|
}
|
|
}
|