<?php
/**
 * agent-toolbelt/check-site-response (v1.4 plan §3.1, readonly).
 *
 * The shared loopback probe as a first-class diagnostic: fetches the home
 * page and the REST index as an anonymous visitor (cache-busted) and reports
 * per-check HTTP status, response time and fatal-marker verdicts. This is the
 * "did the site survive?" step every recover operation runs internally —
 * exposed standalone so agents can verify after ANY risky change (their own
 * or someone else's), and owners can run it from the admin Run panel.
 *
 * Also reports whether the plugin's own maintenance window is currently
 * active: the probe itself bypasses the maintenance page (it must see the
 * real site), but visitors are getting a 503 — an agent reading "passed"
 * while the window is open needs that context.
 */

// Exit if accessed directly.
if ( ! defined( 'ABSPATH' ) ) {
    exit;
}

if ( ! class_exists( 'ATB_Operation_Check_Site_Response' ) ) {
    class ATB_Operation_Check_Site_Response extends ATB_Operation
    {
        public function slug()
        {
            return 'check-site-response';
        }

        public function describe()
        {
            return array(
                'slug'        => $this->slug(),
                'risk'        => 'none',
                'summary'     => 'Checks that the site is up, from the outside: fetches the home page and the '
                    . 'REST index as an anonymous visitor (cache-busted) and reports HTTP status, response '
                    . 'time, and whether a fatal-error marker is visible. Call after any risky change to '
                    . 'verify the site still responds. Also reports whether the Agent Toolbelt maintenance '
                    . 'window is active (visitors would be seeing a 503 that is not an outage). Read-only.',
                'annotations' => array(
                    'readonly' => true,
                ),
                'input_schema' => array(
                    // 'null' tolerated: a parameterless REST GET run sends input=null (M6).
                    'type'       => array( 'object', 'null' ),
                    'properties' => array(),
                ),
            );
        }

        public function dry_run( $atb_input )
        {
            return $this->output( true, true, $this->gather() );
        }

        public function run( $atb_input )
        {
            return $this->output( true, false, $this->gather() );
        }

        /**
         * @return array details: passed, checks (per-URL), failures,
         *               maintenance_window_active.
         */
        protected function gather()
        {
            $atb_probe = ATB_Site_Probe::run();

            $atb_maintenance = false;
            if ( class_exists( 'ATB_Operation_Maintenance_Mode' ) ) {
                $atb_stored      = get_option( ATB_Operation_Maintenance_Mode::OPTION_NAME, false );
                $atb_maintenance = ATB_Operation_Maintenance_Mode::seconds_remaining( $atb_stored, time() ) > 0;
            }

            return array(
                'passed'                    => $atb_probe['passed'],
                'checks'                    => $atb_probe['checks'],
                'failures'                  => $atb_probe['failures'],
                'maintenance_window_active' => $atb_maintenance,
            );
        }
    }
}