moko-platform/validate/check_version_consistency.php

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

/**
 * Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
 *
 * This file is part of a Moko Consulting project.
 *
 * SPDX-License-Identifier: GPL-3.0-or-later
 *
 * FILE INFORMATION
 * DEFGROUP: MokoStandards.Scripts.Validate
 * INGROUP: MokoStandards
 * REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
 * PATH: /validate/check_version_consistency.php
 * BRIEF: Validates that version numbers are consistent across all critical repository files
 */

declare(strict_types=1);

require_once __DIR__ . '/../../vendor/autoload.php';

use MokoEnterprise\CliFramework;

/**
 * Checks that the version recorded in composer.json matches VERSION headers
 * and badges in README.md, CHANGELOG.md, CONTRIBUTING.md, workflow files,
 * and PHP Enterprise library files.
 */
class CheckVersionConsistency extends CliFramework
{
    protected function configure(): void
    {
        $this->setDescription('Validates version consistency across all critical repository files');
        $this->addArgument('--path', 'Repository root path to check', '.');
    }

    protected function run(): int
    {
        $path         = rtrim((string) $this->getArgument('--path'), '/\\');
        $composerFile = $path . '/composer.json';

        // ── Resolve expected version ──────────────────────────────────────────
        $this->section('Resolving expected version');

        $expected = null;

        if (is_file($composerFile)) {
            $data = json_decode((string) file_get_contents($composerFile), true);
            if (isset($data['version'])) {
                $expected = (string) $data['version'];
                $this->status(true, "Expected version (composer.json): {$expected}");
            } else {
                $this->status(false, 'composer.json', 'missing "version" key');
            }
        } else {
            $this->status(false, 'composer.json', 'file not found — falling back to README.md');
        }

        // Fallback: extract version from README.md VERSION header
        if ($expected === null) {
            $readmeFile = $path . '/README.md';
            if (is_file($readmeFile)) {
                $readme = (string) file_get_contents($readmeFile);
                if (preg_match('/VERSION:\s*(\d{2}\.\d{2}\.\d{2})/', $readme, $m)) {
                    $expected = $m[1];
                    $this->status(true, "Expected version (README.md): {$expected}");
                } else {
                    $this->status(false, 'README.md', 'no VERSION header found');
                    return 2;
                }
            } else {
                $this->status(false, 'README.md', 'file not found');
                return 2;
            }
        }

        // ── Check critical root files ─────────────────────────────────────────
        $this->section('Checking critical files');

        $criticalChecks = [
            'README.md'       => ['/VERSION:\s*(\d{2}\.\d{2}\.\d{2})/', '/MokoStandards-(\d{2}\.\d{2}\.\d{2})/'],
            'CHANGELOG.md'    => ['/VERSION:\s*(\d{2}\.\d{2}\.\d{2})/'],
            'CONTRIBUTING.md' => ['/VERSION:\s*(\d{2}\.\d{2}\.\d{2})/'],
        ];

        $issues = [];

        foreach ($criticalChecks as $filename => $patterns) {
            $file = $path . '/' . $filename;
            if (!is_file($file)) {
                $this->status(false, $filename, 'file not found');
                $issues[] = $filename;
                continue;
            }
            $content    = (string) file_get_contents($file);
            $filePassed = true;
            foreach ($patterns as $pattern) {
                preg_match_all($pattern, $content, $matches, PREG_OFFSET_CAPTURE);
                foreach ($matches[1] as $match) {
                    if ($match[0] !== $expected) {
                        $line = substr_count(substr($content, 0, (int) $match[1]), "\n") + 1;
                        $this->status(false, $filename, "line {$line}: found {$match[0]}, expected {$expected}");
                        $issues[] = $filename;
                        $filePassed = false;
                    }
                }
            }
            if ($filePassed) {
                $this->status(true, $filename);
            }
        }

        // ── Check workflow files ──────────────────────────────────────────────
        $this->section('Checking workflow files');

        // Check both .github/workflows and .gitea/workflows
        $workflowFiles = [];
        foreach (['.github/workflows', '.mokogitea/workflows'] as $wfDir) {
            $dir = $path . '/' . $wfDir;
            if (is_dir($dir)) {
                $workflowFiles = array_merge($workflowFiles, glob($dir . '/*.yml') ?: []);
            }
        }
        $total         = count($workflowFiles);

        foreach ($workflowFiles as $i => $file) {
            $this->progress($i + 1, $total, basename($file));
            $content    = (string) file_get_contents($file);
            $filePassed = true;
            preg_match_all('/#\s*VERSION:\s*(\d{2}\.\d{2}\.\d{2})/', $content, $matches, PREG_OFFSET_CAPTURE);
            foreach ($matches[1] as $match) {
                if ($match[0] !== $expected) {
                    $this->progress($i + 1, $total, '', true);
                    $rel = str_replace($path . '/', '', $file);
                    $this->status(false, $rel, "found {$match[0]}, expected {$expected}");
                    $issues[] = $rel;
                    $filePassed = false;
                }
            }
        }
        $this->progress($total, $total, '', true);

        // ── Check PHP Enterprise library files ────────────────────────────────
        $this->section('Checking PHP source files');

        $phpFiles  = $this->findPhpFiles($path . '/lib/Enterprise');
        $phpTotal  = count($phpFiles);

        foreach ($phpFiles as $i => $file) {
            $this->progress($i + 1, $phpTotal, basename($file));
            $content    = (string) file_get_contents($file);
            $filePassed = true;
            preg_match_all('/\* VERSION:\s*(\d{2}\.\d{2}\.\d{2})/', $content, $matches, PREG_OFFSET_CAPTURE);
            foreach ($matches[1] as $match) {
                if ($match[0] !== $expected) {
                    $this->progress($i + 1, $phpTotal, '', true);
                    $rel = str_replace($path . '/', '', $file);
                    $this->status(false, $rel, "found {$match[0]}, expected {$expected}");
                    $issues[] = $rel;
                    $filePassed = false;
                }
            }
        }
        $this->progress($phpTotal, $phpTotal, '', true);

        // ── Check Terraform definition files ─────────────────────────────────
        // Each .tf file has TWO version locations that must both match:
        //   - Block-comment header:  * Version: XX.XX.XX
        //   - HCL metadata field:    version = "XX.XX.XX"
        $this->section('Checking Terraform definition files');

        $defFiles = glob($path . '/definitions/default/*.tf') ?: [];
        $defTotal = count($defFiles);

        foreach ($defFiles as $i => $file) {
            $this->progress($i + 1, $defTotal, basename($file));
            $content    = (string) file_get_contents($file);
            $filePassed = true;
            $rel        = str_replace($path . '/', '', $file);

            // Block-comment header version
            preg_match_all('/\*\s*Version:\s*(\d{2}\.\d{2}\.\d{2})/', $content, $headerMatches, PREG_OFFSET_CAPTURE);
            foreach ($headerMatches[1] as $match) {
                if ($match[0] !== $expected) {
                    $this->progress($i + 1, $defTotal, '', true);
                    $this->status(false, $rel, "header Version: found {$match[0]}, expected {$expected}");
                    $issues[]   = $rel;
                    $filePassed = false;
                }
            }

            // HCL metadata version field
            preg_match_all('/^\s*version\s*=\s*"(\d{2}\.\d{2}\.\d{2})"/m', $content, $hclMatches, PREG_OFFSET_CAPTURE);
            foreach ($hclMatches[1] as $match) {
                if ($match[0] !== $expected) {
                    $this->progress($i + 1, $defTotal, '', true);
                    $this->status(false, $rel, "HCL version = found {$match[0]}, expected {$expected}");
                    $issues[]   = $rel;
                    $filePassed = false;
                }
            }

            if ($filePassed) {
                $this->status(true, $rel);
            }
        }
        $this->progress($defTotal, $defTotal, '', true);

        // ── Summary ───────────────────────────────────────────────────────────
        $totalChecked = count($criticalChecks) + $total + $phpTotal + $defTotal;
        $totalFailed  = count(array_unique($issues));
        $this->printSummary($totalChecked - $totalFailed, $totalFailed, $this->elapsed());

        return $totalFailed === 0 ? 0 : 1;
    }

    /**
     * Recursively find all PHP files under a directory.
     *
     * @return list<string>
     */
    private function findPhpFiles(string $dir): array
    {
        if (!is_dir($dir)) {
            return [];
        }
        $files    = [];
        $iterator = new \RecursiveIteratorIterator(
            new \RecursiveDirectoryIterator($dir, \RecursiveDirectoryIterator::SKIP_DOTS)
        );
        foreach ($iterator as $file) {
            if ($file->isFile() && $file->getExtension() === 'php') {
                $files[] = $file->getPathname();
            }
        }
        return $files;
    }
}

$script = new CheckVersionConsistency('check_version_consistency', 'Validates version consistency across repository files');
exit($script->execute());