breadcrumb-the-shire/lib/Console/Commands/DoctorCommand.php

<?php

namespace MintyPHP\Console\Commands;

use MintyPHP\Console\Command;

final class DoctorCommand extends Command
{
    public function name(): string
    {
        return 'doctor';
    }

    public function description(): string
    {
        return 'Run system health checks';
    }

    public function execute(array $args, array $options): int
    {
        // doctor.php calls exit() internally — run as subprocess
        // to avoid terminating the console process.
        $scriptPath = $this->projectRoot() . '/bin/doctor.php';
        $command = PHP_BINARY . ' ' . escapeshellarg($scriptPath);
        passthru($command, $exitCode);

        return $exitCode;
    }
}