crewli/api/app/Console/Commands/ResolveFormSubmissionActionFailures.php

<?php

declare(strict_types=1);

namespace App\Console\Commands;

use App\Models\FormBuilder\FormSubmissionActionFailure;
use Illuminate\Console\Command;

/**
 * RFC-WS-6 §3 (Q5) + §4 (V2) — single-id resolve action.
 * Bulk resolve via API only (audit-trail concern).
 */
final class ResolveFormSubmissionActionFailures extends Command
{
    protected $signature = 'form-failures:resolve
        {id        : FormSubmissionActionFailure ULID}
        {--note=   : Optional resolution note}';

    protected $description = 'Mark a single FormSubmissionActionFailure as resolved';

    public function handle(): int
    {
        $id = (string) $this->argument('id');
        $note = $this->option('note');

        $failure = FormSubmissionActionFailure::query()->withoutGlobalScopes()->find($id);
        if ($failure === null) {
            $this->error("Failure {$id} not found.");

            return self::FAILURE;
        }

        if ($failure->resolved_at !== null) {
            $this->warn("Failure {$id} already resolved at {$failure->resolved_at}; no-op.");

            return self::SUCCESS;
        }

        if ($failure->dismissed_at !== null) {
            $this->warn("Failure {$id} already dismissed at {$failure->dismissed_at}; cannot resolve.");

            return self::SUCCESS;
        }

        if (! $this->confirm("Resolve failure {$id}?", true)) {
            return self::SUCCESS;
        }

        $failure->resolved_at = now();
        $failure->resolved_note = $note !== null ? (string) $note : null;
        $failure->save();

        $this->info("Resolved failure {$id}.");

        return self::SUCCESS;
    }
}