ahmido
a107e7e41b
## Summary - add the Spec 181 restore-safety layer with scope fingerprinting, preview/check integrity states, execution safety snapshots, result attention, and operator-facing copy across the wizard, restore detail, and canonical operation detail - add focused unit and feature coverage for restore-safety assessment, result attention, and restore-linked operation detail - switch the finding exceptions queue `Inspect exception` action to a native Filament slide-over while preserving query-param-backed inline summary behavior ## Testing - `vendor/bin/sail artisan test --compact tests/Feature/Monitoring/FindingExceptionsQueueTest.php tests/Feature/Filament/RestoreSafetyIntegrityWizardTest.php tests/Feature/Filament/RestoreResultAttentionSurfaceTest.php tests/Feature/Operations/RestoreLinkedOperationDetailTest.php tests/Unit/Support/RestoreSafety` ## Notes - Spec 181 checklist is complete (`specs/181-restore-safety-integrity/checklists/requirements.md`) - the branch still has unchecked follow-up tasks in `specs/181-restore-safety-integrity/tasks.md`: `T012`, `T018`, `T019`, `T023`, `T025`, `T029`, `T032`, `T033`, `T041`, `T042`, `T043`, `T044` - Filament v5 / Livewire v4 compliance is preserved, no panel provider registration changes were made, no global-search behavior was added, destructive actions remain confirmation-gated, and no new Filament assets were introduced Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de> Reviewed-on: #210
94 lines
2.9 KiB
PHP
94 lines
2.9 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace App\Support\RestoreSafety;
|
|
|
|
use InvalidArgumentException;
|
|
|
|
final readonly class RestoreSafetyAssessment
|
|
{
|
|
public const string STATE_BLOCKED = 'blocked';
|
|
|
|
public const string STATE_RISKY = 'risky';
|
|
|
|
public const string STATE_READY_WITH_CAUTION = 'ready_with_caution';
|
|
|
|
public const string STATE_READY = 'ready';
|
|
|
|
public function __construct(
|
|
public string $state,
|
|
public ExecutionReadinessState $executionReadiness,
|
|
public PreviewIntegrityState $previewIntegrity,
|
|
public ChecksIntegrityState $checksIntegrity,
|
|
public bool $positiveClaimSuppressed,
|
|
public ?string $primaryIssueCode,
|
|
public string $primaryNextAction,
|
|
public string $summary,
|
|
) {
|
|
if (! in_array($this->state, [
|
|
self::STATE_BLOCKED,
|
|
self::STATE_RISKY,
|
|
self::STATE_READY_WITH_CAUTION,
|
|
self::STATE_READY,
|
|
], true)) {
|
|
throw new InvalidArgumentException('Unsupported restore safety assessment state.');
|
|
}
|
|
}
|
|
|
|
public function canSignalReady(): bool
|
|
{
|
|
return in_array($this->state, [self::STATE_READY, self::STATE_READY_WITH_CAUTION], true);
|
|
}
|
|
|
|
/**
|
|
* @return array{
|
|
* state: string,
|
|
* execution_readiness: array{
|
|
* allowed: bool,
|
|
* blocking_reasons: list<string>,
|
|
* mutation_scope: string,
|
|
* required_capability: string,
|
|
* display_summary: string
|
|
* },
|
|
* preview_integrity: array{
|
|
* state: string,
|
|
* freshness_policy: string,
|
|
* fingerprint: ?string,
|
|
* generated_at: ?string,
|
|
* invalidation_reasons: list<string>,
|
|
* rerun_required: bool,
|
|
* display_summary: string
|
|
* },
|
|
* checks_integrity: array{
|
|
* state: string,
|
|
* freshness_policy: string,
|
|
* fingerprint: ?string,
|
|
* ran_at: ?string,
|
|
* blocking_count: int,
|
|
* warning_count: int,
|
|
* invalidation_reasons: list<string>,
|
|
* rerun_required: bool,
|
|
* display_summary: string
|
|
* },
|
|
* positive_claim_suppressed: bool,
|
|
* primary_issue_code: ?string,
|
|
* primary_next_action: string,
|
|
* summary: string
|
|
* }
|
|
*/
|
|
public function toArray(): array
|
|
{
|
|
return [
|
|
'state' => $this->state,
|
|
'execution_readiness' => $this->executionReadiness->toArray(),
|
|
'preview_integrity' => $this->previewIntegrity->toArray(),
|
|
'checks_integrity' => $this->checksIntegrity->toArray(),
|
|
'positive_claim_suppressed' => $this->positiveClaimSuppressed,
|
|
'primary_issue_code' => $this->primaryIssueCode,
|
|
'primary_next_action' => $this->primaryNextAction,
|
|
'summary' => $this->summary,
|
|
];
|
|
}
|
|
}
|