## Summary - harden operation-run lifecycle handling with explicit reconciliation policy, stale-run healing, failed-job bridging, and monitoring visibility - refactor audit log event inspection into a Filament slide-over and remove the stale inline detail/header-action coupling - align panel theme asset resolution and supporting Filament UI updates, including the rounded 2xl theme token regression fix ## Testing - ran focused Pest coverage for the affected audit-log inspection flow and related visibility tests - ran formatting with `vendor/bin/sail bin pint --dirty --format agent` - manually verified the updated audit-log slide-over flow in the integrated browser ## Notes - branch includes the Spec 160 artifacts under `specs/160-operation-lifecycle-guarantees/` - the full test suite was not rerun as part of this final commit/PR step Co-authored-by: Ahmed Darrazi <ahmed.darrazi@live.de> Reviewed-on: #190
70 lines
2.0 KiB
PHP
70 lines
2.0 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace App\Support\Operations;
|
|
|
|
use App\Models\OperationRun;
|
|
use App\Support\OperationRunStatus;
|
|
|
|
enum OperationRunFreshnessState: string
|
|
{
|
|
case FreshActive = 'fresh_active';
|
|
case LikelyStale = 'likely_stale';
|
|
case ReconciledFailed = 'reconciled_failed';
|
|
case TerminalNormal = 'terminal_normal';
|
|
case Unknown = 'unknown';
|
|
|
|
public static function forRun(OperationRun $run, ?OperationLifecyclePolicy $policy = null): self
|
|
{
|
|
$policy ??= app(OperationLifecyclePolicy::class);
|
|
|
|
if ((string) $run->status === OperationRunStatus::Completed->value) {
|
|
return $run->isLifecycleReconciled() ? self::ReconciledFailed : self::TerminalNormal;
|
|
}
|
|
|
|
if (! $policy->supports((string) $run->type)) {
|
|
return self::Unknown;
|
|
}
|
|
|
|
if ((string) $run->status === OperationRunStatus::Queued->value) {
|
|
if ($run->started_at !== null || $run->created_at === null) {
|
|
return self::Unknown;
|
|
}
|
|
|
|
return $run->created_at->lte(now()->subSeconds($policy->queuedStaleAfterSeconds((string) $run->type)))
|
|
? self::LikelyStale
|
|
: self::FreshActive;
|
|
}
|
|
|
|
if ((string) $run->status === OperationRunStatus::Running->value) {
|
|
$startedAt = $run->started_at ?? $run->created_at;
|
|
|
|
if ($startedAt === null) {
|
|
return self::Unknown;
|
|
}
|
|
|
|
return $startedAt->lte(now()->subSeconds($policy->runningStaleAfterSeconds((string) $run->type)))
|
|
? self::LikelyStale
|
|
: self::FreshActive;
|
|
}
|
|
|
|
return self::Unknown;
|
|
}
|
|
|
|
public function isFreshActive(): bool
|
|
{
|
|
return $this === self::FreshActive;
|
|
}
|
|
|
|
public function isLikelyStale(): bool
|
|
{
|
|
return $this === self::LikelyStale;
|
|
}
|
|
|
|
public function isReconciledFailed(): bool
|
|
{
|
|
return $this === self::ReconciledFailed;
|
|
}
|
|
}
|