moko-platform/cli/release_body_update.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/release_body_update.php
 * BRIEF: Update Gitea release body with changelog extract and checksums
 *
 * Usage:
 *   php release_body_update.php --version 04.01.00 --release-tag stable --token TOKEN --api-base URL
 *   php release_body_update.php --version 04.01.00 --release-tag stable --token TOKEN --api-base URL --zip-name pkg.zip --zip-sha abc123
 *
 * Options:
 *   --path           Repo root for CHANGELOG.md (default: .)
 *   --version        Version string (required)
 *   --release-tag    Gitea release tag (required)
 *   --token          Gitea API token (required)
 *   --api-base       Gitea API base URL (required)
 *   --zip-name       ZIP filename for checksum table
 *   --tar-name       tar.gz filename for checksum table
 *   --zip-sha        SHA256 of ZIP
 *   --tar-sha        SHA256 of tar.gz
 *   --output-summary Write to $GITHUB_STEP_SUMMARY
 */

declare(strict_types=1);

$path = '.';
$version = null;
$releaseTag = null;
$token = null;
$apiBase = null;
$zipName = null;
$tarName = null;
$zipSha = null;
$tarSha = null;
$outputSummary = false;

foreach ($argv as $i => $arg) {
	if ($arg === '--path' && isset($argv[$i + 1])) $path = $argv[$i + 1];
	if ($arg === '--version' && isset($argv[$i + 1])) $version = $argv[$i + 1];
	if ($arg === '--release-tag' && isset($argv[$i + 1])) $releaseTag = $argv[$i + 1];
	if ($arg === '--token' && isset($argv[$i + 1])) $token = $argv[$i + 1];
	if ($arg === '--api-base' && isset($argv[$i + 1])) $apiBase = $argv[$i + 1];
	if ($arg === '--zip-name' && isset($argv[$i + 1])) $zipName = $argv[$i + 1];
	if ($arg === '--tar-name' && isset($argv[$i + 1])) $tarName = $argv[$i + 1];
	if ($arg === '--zip-sha' && isset($argv[$i + 1])) $zipSha = $argv[$i + 1];
	if ($arg === '--tar-sha' && isset($argv[$i + 1])) $tarSha = $argv[$i + 1];
	if ($arg === '--output-summary') $outputSummary = true;
}

if ($token === null) $token = getenv('MOKOGITEA_TOKEN') ?: getenv('GITEA_TOKEN') ?: null;

if ($version === null || $releaseTag === null || $token === null || $apiBase === null) {
	fwrite(STDERR, "Usage: release_body_update.php --version VER --release-tag TAG --token TOKEN --api-base URL\n");
	exit(1);
}

$root = realpath($path) ?: $path;

// Extract changelog section for this version
$changelog = '';
$clFile = "{$root}/CHANGELOG.md";
if (file_exists($clFile)) {
	$lines = file($clFile, FILE_IGNORE_NEW_LINES);
	$capturing = false;
	$clLines = [];
	foreach ($lines as $line) {
		if (preg_match('/^##\s.*' . preg_quote($version, '/') . '/', $line)) {
			$capturing = true;
			continue;
		}
		if ($capturing && preg_match('/^## /', $line)) break;
		if ($capturing) $clLines[] = $line;
	}
	$changelog = trim(implode("\n", $clLines));
}

// Build release body
$body = "## {$version} (" . date('Y-m-d') . ")\n\n";
if (!empty($changelog)) {
	$body .= "{$changelog}\n\n";
}

if ($zipSha !== null || $tarSha !== null) {
	$body .= "---\n\n### Checksums\n\n| File | SHA-256 |\n|------|--------|\n";
	if ($zipName !== null && $zipSha !== null) {
		$body .= "| `{$zipName}` | `{$zipSha}` |\n";
	}
	if ($tarName !== null && $tarSha !== null) {
		$body .= "| `{$tarName}` | `{$tarSha}` |\n";
	}
}

// Get release ID by tag
$ch = curl_init("{$apiBase}/releases/tags/{$releaseTag}");
curl_setopt_array($ch, [
	CURLOPT_RETURNTRANSFER => true,
	CURLOPT_HTTPHEADER => ["Authorization: token {$token}"],
	CURLOPT_TIMEOUT => 30,
]);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode !== 200 || empty($response)) {
	fwrite(STDERR, "Failed to get release for tag '{$releaseTag}' (HTTP {$httpCode})\n");
	exit(1);
}

$release = json_decode($response, true);
$releaseId = $release['id'] ?? null;

if ($releaseId === null) {
	fwrite(STDERR, "No release ID found for tag '{$releaseTag}'\n");
	exit(1);
}

// PATCH release body
$payload = json_encode(['body' => $body]);
$ch = curl_init("{$apiBase}/releases/{$releaseId}");
curl_setopt_array($ch, [
	CURLOPT_CUSTOMREQUEST => 'PATCH',
	CURLOPT_RETURNTRANSFER => true,
	CURLOPT_HTTPHEADER => ["Authorization: token {$token}", "Content-Type: application/json"],
	CURLOPT_POSTFIELDS => $payload,
	CURLOPT_TIMEOUT => 30,
]);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode !== 200) {
	fwrite(STDERR, "Failed to update release body (HTTP {$httpCode})\n");
	exit(1);
}

echo "Release body updated for {$releaseTag} (release #{$releaseId})\n";

if ($outputSummary) {
	$summaryFile = getenv('GITHUB_STEP_SUMMARY');
	if ($summaryFile) {
		file_put_contents($summaryFile, "Release body updated with changelog + checksums\n", FILE_APPEND);
	}
}

exit(0);