moko-platform/cli/version_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/version_check.php
 * VERSION: 05.00.00
 * BRIEF: Validate version consistency across README, manifests, and sub-packages
 *
 * Usage:
 *   php version_check.php --path /repo
 *   php version_check.php --path /repo --strict    # exit 1 on mismatch
 *   php version_check.php --path /repo --fix       # fix mismatches to highest version
 */

declare(strict_types=1);

$path   = '.';
$strict = false;
$fix    = false;

foreach ($argv as $i => $arg) {
    if ($arg === '--path' && isset($argv[$i + 1])) $path = $argv[$i + 1];
    if ($arg === '--strict') $strict = true;
    if ($arg === '--fix')    $fix = true;
}

$root = realpath($path) ?: $path;
$errors = 0;
$versions = [];

// ── Read .mokogitea/manifest.xml (canonical) ────────────────────────────────
$mokoManifest = "{$root}/.mokogitea/manifest.xml";
if (file_exists($mokoManifest)) {
    $xml = @simplexml_load_file($mokoManifest);
    if ($xml !== false) {
        $v = (string)($xml->identity->version ?? '');
        $base = preg_replace('/(-(dev|alpha|beta|rc))+$/', '', $v);
        if (preg_match('/^\d{2}\.\d{2}\.\d{2}$/', $base)) {
            $versions['.mokogitea/manifest.xml'] = $base;
        }
    }
}

// ── Read README.md version ───────────────────────────────────────────────────
$readme = "{$root}/README.md";
if (file_exists($readme)) {
    $content = file_get_contents($readme);
    if (preg_match('/VERSION:\s*(\d{2}\.\d{2}\.\d{2})/m', $content, $m)) {
        $versions['README.md'] = $m[1];
    }
}

// ── Read CHANGELOG.md version ───────────────────────────────────────────────
$changelog = "{$root}/CHANGELOG.md";
if (file_exists($changelog)) {
    $content = file_get_contents($changelog);
    if (preg_match('/VERSION:\s*(\d{2}\.\d{2}\.\d{2})/m', $content, $m)) {
        $versions['CHANGELOG.md'] = $m[1];
    }
}

// ── Read package.json version ───────────────────────────────────────────────
$packageJson = "{$root}/package.json";
if (file_exists($packageJson)) {
    $pkg = json_decode(file_get_contents($packageJson), true);
    if (isset($pkg['version']) && preg_match('/^\d{2}\.\d{2}\.\d{2}$/', $pkg['version'])) {
        $versions['package.json'] = $pkg['version'];
    }
}

// ── Read pyproject.toml version ─────────────────────────────────────────────
$pyproject = "{$root}/pyproject.toml";
if (file_exists($pyproject)) {
    $content = file_get_contents($pyproject);
    if (preg_match('/^version\s*=\s*"(\d{2}\.\d{2}\.\d{2})"/m', $content, $m)) {
        $versions['pyproject.toml'] = $m[1];
    }
}

// ── Read manifest XML versions ───────────────────────────────────────────────
$xmlGlobs = [
    "{$root}/src/pkg_*.xml",
    "{$root}/src/*.xml",
    "{$root}/src/packages/*/*.xml",
    "{$root}/*.xml",
];

foreach ($xmlGlobs as $glob) {
    foreach (glob($glob) ?: [] as $file) {
        // Skip updates.xml
        if (basename($file) === 'updates.xml') continue;

        $xmlContent = file_get_contents($file);
        if (strpos($xmlContent, '<extension') === false) continue;

        if (preg_match('#<version>(\d{2}\.\d{2}\.\d{2})(?:(?:-(?:dev|alpha|beta|rc))+)?</version>#', $xmlContent, $xm)) {
            $relPath = str_replace($root . '/', '', $file);
            $relPath = str_replace($root . '\\', '', $relPath);
            $versions[$relPath] = $xm[1];
        }
    }
}

if (empty($versions)) {
    fwrite(STDERR, "No version sources found\n");
    exit(1);
}

// ── Compare versions ─────────────────────────────────────────────────────────
$uniqueVersions = array_unique(array_values($versions));
$highestVersion = '00.00.00';
foreach ($versions as $v) {
    if (version_compare($v, $highestVersion, '>')) {
        $highestVersion = $v;
    }
}

echo "=== Version Consistency Check ===\n";
foreach ($versions as $source => $ver) {
    $status = ($ver === $highestVersion) ? 'OK' : 'MISMATCH';
    if ($status === 'MISMATCH') $errors++;
    echo sprintf("  %-50s %s  %s\n", $source, $ver, $status === 'OK' ? '' : "** MISMATCH (expected {$highestVersion})");
}

if (count($uniqueVersions) === 1) {
    echo "\nAll {$ver} — consistent.\n";
} else {
    echo "\n** {$errors} mismatch(es) found. Highest version: {$highestVersion}\n";

    if ($fix) {
        echo "\n=== Fixing mismatches to {$highestVersion} ===\n";

        // Fix README.md
        if (isset($versions['README.md']) && $versions['README.md'] !== $highestVersion) {
            $content = file_get_contents($readme);
            $updated = preg_replace(
                '/(VERSION:\s*)\d{2}\.\d{2}\.\d{2}/m',
                '${1}' . $highestVersion,
                $content,
                1
            );
            if ($updated !== null) {
                file_put_contents($readme, $updated);
            }
            echo "  Fixed: README.md -> {$highestVersion}\n";
        }

        // Fix .mokogitea/manifest.xml
        if (isset($versions['.mokogitea/manifest.xml']) && $versions['.mokogitea/manifest.xml'] !== $highestVersion) {
            $content = file_get_contents($mokoManifest);
            $updated = preg_replace(
                '#<version>\d{2}\.\d{2}\.\d{2}(?:(?:-(?:dev|alpha|beta|rc))+)?</version>#',
                "<version>{$highestVersion}</version>",
                $content
            );
            if ($updated !== null) {
                file_put_contents($mokoManifest, $updated);
            }
            echo "  Fixed: .mokogitea/manifest.xml -> {$highestVersion}\n";
        }

        // Fix CHANGELOG.md
        if (isset($versions['CHANGELOG.md']) && $versions['CHANGELOG.md'] !== $highestVersion) {
            $content = file_get_contents($changelog);
            $updated = preg_replace(
                '/(VERSION:\s*)\d{2}\.\d{2}\.\d{2}(?:(?:-(?:dev|alpha|beta|rc))+)?/m',
                '${1}' . $highestVersion,
                $content
            );
            if ($updated !== null) {
                file_put_contents($changelog, $updated);
            }
            echo "  Fixed: CHANGELOG.md -> {$highestVersion}\n";
        }

        // Fix package.json
        if (isset($versions['package.json']) && $versions['package.json'] !== $highestVersion) {
            $content = file_get_contents($packageJson);
            $updated = preg_replace(
                '/("version"\s*:\s*")\d{2}\.\d{2}\.\d{2}(?:(?:-(?:dev|alpha|beta|rc))+)?(")/m',
                '${1}' . $highestVersion . '${2}',
                $content
            );
            if ($updated !== null) {
                file_put_contents($packageJson, $updated);
            }
            echo "  Fixed: package.json -> {$highestVersion}\n";
        }

        // Fix pyproject.toml
        if (isset($versions['pyproject.toml']) && $versions['pyproject.toml'] !== $highestVersion) {
            $content = file_get_contents($pyproject);
            $updated = preg_replace(
                '/^(version\s*=\s*")\d{2}\.\d{2}\.\d{2}(?:(?:-(?:dev|alpha|beta|rc))+)?(")/m',
                '${1}' . $highestVersion . '${2}',
                $content
            );
            if ($updated !== null) {
                file_put_contents($pyproject, $updated);
            }
            echo "  Fixed: pyproject.toml -> {$highestVersion}\n";
        }

        // Fix XML manifests
        foreach ($versions as $source => $ver) {
            if (in_array($source, ['README.md', 'CHANGELOG.md', '.mokogitea/manifest.xml', 'package.json', 'pyproject.toml'], true)) continue;
            if ($ver === $highestVersion) continue;

            $file = "{$root}/{$source}";
            if (!file_exists($file)) continue;

            $content = file_get_contents($file);
            $updated = preg_replace(
                '#<version>[^<]*</version>#',
                "<version>{$highestVersion}</version>",
                $content
            );
            if ($updated !== null) {
                file_put_contents($file, $updated);
            }
            echo "  Fixed: {$source} -> {$highestVersion}\n";
        }

        echo "Done.\n";
    }
}

if ($strict && $errors > 0) {
    exit(1);
}

exit(0);