moko-platform/cli/version_bump_remote.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_bump_remote.php
 * BRIEF: Bump version in manifest XML and CHANGELOG.md on a remote branch via Gitea API
 */

declare(strict_types=1);

require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';

use MokoEnterprise\CliFramework;

class VersionBumpRemoteCli extends CliFramework
{
	protected function configure(): void
	{
		$this->setDescription('Bump version in manifest XML and CHANGELOG.md on a remote branch via Gitea API');
		$this->addArgument('--path', 'Repository root', '.');
		$this->addArgument('--branch', 'Target branch to bump (required)', null);
		$this->addArgument('--bump', 'Bump type: patch | minor | major', 'minor');
		$this->addArgument('--token', 'Gitea API token (or MOKOGITEA_TOKEN env var)', null);
		$this->addArgument('--api-base', 'Gitea API base URL for the repo', null);
		$this->addArgument('--no-changelog', 'Skip CHANGELOG.md bump', false);
		$this->addArgument('--repo', 'Repository path (owner/repo)', null);
		$this->addArgument('--gitea-url', 'Gitea instance URL', null);
	}

	protected function run(): int
	{
		$path = $this->getArgument('--path'); $branch = $this->getArgument('--branch');
		$bumpType = $this->getArgument('--bump'); $token = $this->getArgument('--token');
		$apiBase = $this->getArgument('--api-base'); $noChangelog = (bool) $this->getArgument('--no-changelog');
		$repo = $this->getArgument('--repo'); $giteaUrl = $this->getArgument('--gitea-url');
		if ($token === null) $token = getenv('MOKOGITEA_TOKEN') ?: getenv('GITEA_TOKEN') ?: null;
		if ($giteaUrl === null) $giteaUrl = getenv('GITEA_URL') ?: 'https://git.mokoconsulting.tech';
		if ($apiBase === null && $repo !== null) { $apiBase = rtrim($giteaUrl, '/') . '/api/v1/repos/' . $repo; }
		if ($branch === null || $token === null || $apiBase === null) {
			$this->log('ERROR', "Usage: version_bump_remote.php --branch BRANCH --token TOKEN --api-base URL [--bump minor|patch|major]");
			return 1;
		}
		$root = realpath($path) ?: $path;
		$version = null; $manifestFile = null;
		foreach (["{$root}/src", $root] as $dir) {
			if (!is_dir($dir)) continue;
			foreach (glob("{$dir}/*.xml") ?: [] as $f) {
				$xml = file_get_contents($f);
				if (strpos($xml, '<extension') !== false || strpos($xml, '<version>') !== false) {
					if (preg_match('|<version>(\d{2}\.\d{2}\.\d{2})</version>|', $xml, $m)) {
						if ($version === null || version_compare($m[1], $version, '>')) { $version = $m[1]; $manifestFile = basename($f); }
					}
				}
			}
		}
		if ($version === null) { $this->log('ERROR', "No version found in manifest XML"); return 1; }
		if (!preg_match('/^(\d{2})\.(\d{2})\.(\d{2})$/', $version, $parts)) { $this->log('ERROR', "Invalid version format: {$version}"); return 1; }
		$major = (int)$parts[1]; $minor = (int)$parts[2]; $patch = (int)$parts[3];
		switch ($bumpType) { case 'major': $major++; $minor = 0; $patch = 0; break; case 'minor': $minor++; $patch = 0; break; default: $patch++; break; }
		$nextVersion = sprintf('%02d.%02d.%02d', $major, $minor, $patch);
		echo "{$version} -> {$nextVersion} ({$branch})\n";

		$manifestPaths = [];
		if ($manifestFile !== null) { $manifestPaths[] = "src/{$manifestFile}"; }
		$manifestPaths = array_merge($manifestPaths, ['src/templateDetails.xml', 'src/manifest.xml']);
		$manifestUpdated = false;
		foreach ($manifestPaths as $mPath) {
			$result = $this->updateRemoteFile($apiBase, $token, $mPath, $branch, function (string $content) use ($version, $nextVersion): string { return str_replace("<version>{$version}</version>", "<version>{$nextVersion}</version>", $content); }, "chore(version): bump {$version} -> {$nextVersion} [skip ci]");
			if ($result) { $manifestUpdated = true; break; }
		}
		if (!$manifestUpdated) { $this->log('WARN', "could not update manifest on {$branch}"); }
		if (!$noChangelog) {
			$this->updateRemoteFile($apiBase, $token, 'CHANGELOG.md', $branch, function (string $content) use ($version, $nextVersion): string {
				$content = str_replace("VERSION: {$version}", "VERSION: {$nextVersion}", $content);
				if (strpos($content, '[Unreleased]') === false && strpos($content, "## [{$nextVersion}]") === false) {
					$marker = "## [{$version}]";
					if (strpos($content, $marker) !== false) { $content = str_replace($marker, "## [{$nextVersion}] - Unreleased\n\n### Added\n\n### Changed\n\n### Fixed\n\n" . $marker, $content); }
				}
				return $content;
			}, "chore(version): bump CHANGELOG {$version} -> {$nextVersion} [skip ci]");
		}
		return 0;
	}

	private function giteaApi(string $method, string $url, string $token, ?string $body = null): ?array
	{
		$ch = curl_init($url);
		curl_setopt_array($ch, [CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ["Authorization: token {$token}", 'Content-Type: application/json'], CURLOPT_CUSTOMREQUEST => $method, CURLOPT_TIMEOUT => 30]);
		if ($body !== null) { curl_setopt($ch, CURLOPT_POSTFIELDS, $body); }
		$response = curl_exec($ch); $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch);
		if ($httpCode >= 400 || $response === false) { return null; }
		return json_decode($response, true) ?: [];
	}

	private function updateRemoteFile(string $apiBase, string $token, string $filePath, string $branch, callable $transform, string $commitMessage): bool
	{
		$file = $this->giteaApi('GET', "{$apiBase}/contents/{$filePath}?ref={$branch}", $token);
		if ($file === null || !isset($file['sha']) || !isset($file['content'])) { return false; }
		$content = base64_decode($file['content']); $newContent = $transform($content);
		if ($newContent === $content) { $this->log('INFO', "{$filePath}: no changes needed"); return true; }
		$payload = json_encode(['content' => base64_encode($newContent), 'sha' => $file['sha'], 'message' => $commitMessage, 'branch' => $branch]);
		$result = $this->giteaApi('PUT', "{$apiBase}/contents/{$filePath}", $token, $payload);
		if ($result === null) { $this->log('ERROR', "{$filePath}: failed to update"); return false; }
		echo "  {$filePath}: updated on {$branch}\n"; return true;
	}
}

$app = new VersionBumpRemoteCli();
exit($app->execute());