moko-platform/cli/client_health_check.php

#!/usr/bin/env php
<?php
/* Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
 *
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
 * DEFGROUP: moko-platform.CLI
 * INGROUP: moko-platform
 * REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
 * PATH: /cli/client_health_check.php
 * BRIEF: Verify a client site's update server, installed version, and release availability
 *
 * Usage:
 *   php client_health_check.php --update-url URL
 *   php client_health_check.php --path /repo --github-output
 *
 * Options:
 *   --path           Repository root (reads update server URL from manifest)
 *   --update-url     Update server XML URL (overrides manifest)
 *   --site-url       Live site URL for version checking via Joomla API (optional)
 *   --api-token      Joomla API token for site-url (optional)
 *   --github-output  Export results to $GITHUB_OUTPUT
 */

declare(strict_types=1);

$path = '.';
$updateUrl = null;
$siteUrl = null;
$apiToken = null;
$ghOutput = false;

foreach ($argv as $i => $arg) {
	if ($arg === '--path' && isset($argv[$i + 1])) $path = $argv[$i + 1];
	if ($arg === '--update-url' && isset($argv[$i + 1])) $updateUrl = $argv[$i + 1];
	if ($arg === '--site-url' && isset($argv[$i + 1])) $siteUrl = $argv[$i + 1];
	if ($arg === '--api-token' && isset($argv[$i + 1])) $apiToken = $argv[$i + 1];
	if ($arg === '--github-output') $ghOutput = true;
}

$root = realpath($path) ?: $path;
$checks = [];

// ── Resolve update server URL from manifest ─────────────────────────────
if ($updateUrl === null) {
	$searchDirs = ["{$root}/src", $root];
	foreach ($searchDirs as $dir) {
		if (!is_dir($dir)) continue;
		foreach (glob("{$dir}/*.xml") ?: [] as $f) {
			$xml = file_get_contents($f);
			if (preg_match('/<server[^>]*>([^<]+)<\/server>/', $xml, $m)) {
				$updateUrl = trim($m[1]);
				break 2;
			}
		}
	}
}

if ($updateUrl === null) {
	fwrite(STDERR, "No update server URL found. Use --update-url or provide a manifest with <updateservers>.\n");
	exit(1);
}

echo "Update server: {$updateUrl}\n\n";

// ── Check 1: Update server accessible ───────────────────────────────────
echo "--- Update Server ---\n";
$ch = curl_init($updateUrl);
curl_setopt_array($ch, [
	CURLOPT_RETURNTRANSFER => true,
	CURLOPT_TIMEOUT => 15,
	CURLOPT_FOLLOWLOCATION => true,
	CURLOPT_HTTPHEADER => ['User-Agent: MokoHealthCheck/1.0'],
]);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode === 200 && !empty($response)) {
	echo "  PASS: HTTP {$httpCode}, " . strlen($response) . " bytes\n";
	$checks['update_server'] = 'pass';
} else {
	echo "  FAIL: HTTP {$httpCode}\n";
	$checks['update_server'] = 'fail';
}

// ── Check 2: Parse updates.xml for stable version ───────────────────────
$stableVersion = null;
$downloadUrl = null;

if (!empty($response)) {
	$sections = preg_split('/<update>/', $response);
	foreach ($sections as $section) {
		if (strpos($section, '<tag>stable</tag>') !== false) {
			if (preg_match('/<version>([^<]+)<\/version>/', $section, $m)) {
				$stableVersion = $m[1];
			}
			if (preg_match('/<downloadurl[^>]*>([^<]+)<\/downloadurl>/', $section, $m)) {
				$downloadUrl = trim($m[1]);
			}
			break;
		}
	}

	if ($stableVersion === null && preg_match('/<version>([^<]+)<\/version>/', $response, $m)) {
		$stableVersion = $m[1];
	}
}

echo "\n--- Stable Release ---\n";
if ($stableVersion !== null) {
	echo "  Version: {$stableVersion}\n";
	$checks['stable_version'] = $stableVersion;
} else {
	echo "  FAIL: Could not parse stable version\n";
	$checks['stable_version'] = 'fail';
}

// ── Check 3: Download URL accessible ────────────────────────────────────
if ($downloadUrl !== null) {
	echo "\n--- Download URL ---\n";
	$ch = curl_init($downloadUrl);
	curl_setopt_array($ch, [
		CURLOPT_NOBODY => true,
		CURLOPT_TIMEOUT => 15,
		CURLOPT_FOLLOWLOCATION => true,
	]);
	curl_exec($ch);
	$dlCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
	$dlSize = curl_getinfo($ch, CURLINFO_CONTENT_LENGTH_DOWNLOAD);
	curl_close($ch);

	if ($dlCode === 200) {
		$sizeKb = $dlSize > 0 ? round($dlSize / 1024) . 'KB' : 'unknown size';
		echo "  PASS: HTTP {$dlCode}, {$sizeKb}\n";
		$checks['download'] = 'pass';
	} else {
		echo "  FAIL: HTTP {$dlCode}\n";
		$checks['download'] = 'fail';
	}
}

// ── Check 4: Site version (optional) ────────────────────────────────────
if ($siteUrl !== null && $apiToken !== null) {
	echo "\n--- Site Version ---\n";
	$apiUrl = rtrim($siteUrl, '/') . '/api/index.php/v1/extensions?filter[type]=file';
	$ch = curl_init($apiUrl);
	curl_setopt_array($ch, [
		CURLOPT_RETURNTRANSFER => true,
		CURLOPT_TIMEOUT => 15,
		CURLOPT_HTTPHEADER => [
			"X-Joomla-Token: {$apiToken}",
			'Accept: application/json',
		],
	]);
	$siteResponse = curl_exec($ch);
	$siteCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
	curl_close($ch);

	if ($siteCode === 200) {
		echo "  API accessible (HTTP {$siteCode})\n";
		$checks['site_api'] = 'pass';
	} else {
		echo "  WARN: Site API returned HTTP {$siteCode}\n";
		$checks['site_api'] = 'warn';
	}
}

// ── Summary ─────────────────────────────────────────────────────────────
echo "\n=== Health Check Summary ===\n";
$failed = 0;
foreach ($checks as $name => $result) {
	$icon = ($result === 'fail') ? 'FAIL' : (($result === 'warn') ? 'WARN' : 'OK');
	if ($result === 'fail') $failed++;
	echo "  {$icon}: {$name} = {$result}\n";
}

if ($ghOutput) {
	$ghFile = getenv('GITHUB_OUTPUT');
	if ($ghFile) {
		file_put_contents($ghFile, "health_status=" . ($failed > 0 ? 'fail' : 'pass') . "\n", FILE_APPEND);
		file_put_contents($ghFile, "health_version=" . ($stableVersion ?? 'unknown') . "\n", FILE_APPEND);
		file_put_contents($ghFile, "health_failures={$failed}\n", FILE_APPEND);
	}
}

exit($failed > 0 ? 1 : 0);