#!/usr/bin/env php
<?php

/**
 * XL Vask automation schema migration script.
 *
 * Mirrors the scripts/account-deletion-schema.php and
 * scripts/bird-control-plane-schema.php patterns so ops can run an explicit,
 * non-cron, non-HTTP migration from the API container.
 *
 * Usage (from the api repo root, against the configured DB):
 *   php scripts/xlvask-automation-migrate.php check
 *   php scripts/xlvask-automation-migrate.php apply --yes
 *
 * "check" never mutates state and always exits 0 when ready / 1 when not.
 * "apply" requires an explicit --yes flag before calling the gated
 * migration_20260804_xlvask_ai_auto_policy_v2::apply() entry point, which
 * itself is operator-only by design (see AUTOMATION_RUNBOOK §2).
 */

if (PHP_SAPI !== 'cli') {
    fwrite(STDERR, "This command is CLI-only.\n");
    exit(2);
}

const WD = __DIR__ . '/../services/nginx/app';
require_once WD . '/vendor/autoload.php';
require_once WD . '/config.php';
require_once WD . '/classes/db.php';
require_once WD . '/classes/xlvask_usage_logs_schema_bootstrap.php';
require_once WD . '/modules/xlvask/migrations/20260804_xlvask_ai_auto_policy_v2.php';

$command = $argv[1] ?? 'check';

if (!in_array($command, ['check', 'apply'], true)) {
    fwrite(STDERR, "Usage: scripts/xlvask-automation-migrate.php check|apply --yes\n");
    exit(2);
}

$db = new \classes\db($CONFIG_DB);
$db->connect();

if ($command === 'apply') {
    if (($argv[2] ?? '') !== '--yes') {
        fwrite(STDERR, "Refusing schema mutation without: apply --yes\n");
        exit(2);
    }
    $status = \classes\xlvask_usage_logs_schema_bootstrap::applyExplicitMigration();
} else {
    $status = \classes\xlvask_usage_logs_schema_bootstrap::migrationStatus();
}

fwrite(STDOUT, json_encode($status, JSON_UNESCAPED_SLASHES | JSON_PRETTY_PRINT) . PHP_EOL);
exit((bool)($status['ready'] ?? false) ? 0 : 1);