MokoConsulting/moko-platform
1
0
Fork 0
Code Issues 6 Pull Requests 1 Actions 25 Packages Licenses 2 Releases 8 Wiki Activity

refactor(cli): migrate 64 legacy scripts to CliFramework (#235)
Platform: moko-platform CI / Gate 2: Unit Tests (8.1) (push) Blocked by required conditions
Details
Platform: moko-platform CI / Gate 2: Unit Tests (8.2) (push) Blocked by required conditions
Details
Platform: moko-platform CI / Gate 2: Unit Tests (8.3) (push) Blocked by required conditions
Details
Platform: moko-platform CI / Gate 3: Self-Health Check (push) Blocked by required conditions
Details
Platform: moko-platform CI / Gate 4: Governance (push) Blocked by required conditions
Details
Platform: moko-platform CI / Gate 5: Template Integrity (push) Blocked by required conditions
Details
Platform: moko-platform CI / CI Summary (push) Blocked by required conditions
Details
Generic: Repo Health / Release configuration (push) Blocked by required conditions
Details
Generic: Repo Health / Scripts governance (push) Blocked by required conditions
Details
Generic: Repo Health / Repository health (push) Blocked by required conditions
Details
Generic: Repo Health / Site Health (push) Has been skipped
Details
Generic: Repo Health / Access control (push) Successful in 2s
Details
Platform: moko-platform CI / Gate 1: Code Quality (push) Failing after 36s
Details

Browse Source 
Wrap all CLI tools in cli/, automation/, maintenance/, deploy/, and
release/ in classes extending CliFramework. Replaces manual $argv
parsing with configure()/addArgument(), moves logic into run(): int,
and converts fwrite(STDERR,...) to $this->log(). Two CLIApp subclasses
(generate_dolibarr_version_txt, generate_joomla_update_xml) converted
to extend CliFramework directly.

Every script now gets free --help, --verbose, --quiet, --dry-run,
--json, --no-color, banners, coloured logging, and progress bars.

Authored-by: Moko Consulting
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
Jonathan Miller
2026-05-31 11:39:10 -05:00
parent af77e9d361
commit b3d9ee8255
64 changed files with 9792 additions and 11200 deletions
Download Patch File Download Diff File Expand all files Collapse all files
cli/updates_xml_sync.php
+188 -177
View File
@@ -9,193 +9,204 @@
* INGROUP: moko-platform
* REPO: https://git.mokoconsulting.tech/MokoConsulting/moko-platform
* PATH: /cli/updates_xml_sync.php
* VERSION: 09.21.00
* VERSION: 09.21.07
* BRIEF: Sync updates.xml to target branches via Gitea API
* NOTE: Called by pre-release and auto-release workflows after updates.xml
* is modified on the current branch. Pushes the file to other branches
* without requiring a git checkout (avoids merge conflicts).
*
* Usage:
* php updates_xml_sync.php --path /repo --branches main,dev --current dev
* php updates_xml_sync.php --path /repo --all --current dev --version 02.01.27
*
* Options:
* --path Repository root containing updates.xml (default: .)
* --branches Comma-separated target branches to sync to (default: main,dev)
* --all Auto-discover all branches via Gitea API (overrides --branches)
* --current Current branch to skip (required)
* --version Version string for commit message (optional)
* --token Gitea API token (default: env MOKOGITEA_TOKEN)
* --gitea-url Gitea instance URL (default: env GITEA_URL or https://git.mokoconsulting.tech)
* --org Organization (default: env GITEA_ORG)
* --repo Repository name (default: env GITEA_REPO)
*/
declare(strict_types=1);
// ── Argument parsing ────────────────────────────────────────────────────
$path = '.';
$branches = 'main,dev';
$current = '';
$version = '';
$token = getenv('MOKOGITEA_TOKEN') ?: '';
$giteaUrl = getenv('GITEA_URL') ?: 'https://git.mokoconsulting.tech';
$org = getenv('GITEA_ORG') ?: '';
$repo = getenv('GITEA_REPO') ?: '';
$discoverAll = false;
require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
foreach ($argv as $i => $arg) {
if ($arg === '--path' && isset($argv[$i + 1])) $path = $argv[$i + 1];
if ($arg === '--branches' && isset($argv[$i + 1])) $branches = $argv[$i + 1];
if ($arg === '--all') $discoverAll = true;
if ($arg === '--current' && isset($argv[$i + 1])) $current = $argv[$i + 1];
if ($arg === '--version' && isset($argv[$i + 1])) $version = $argv[$i + 1];
if ($arg === '--token' && isset($argv[$i + 1])) $token = $argv[$i + 1];
if ($arg === '--gitea-url' && isset($argv[$i + 1])) $giteaUrl = $argv[$i + 1];
if ($arg === '--org' && isset($argv[$i + 1])) $org = $argv[$i + 1];
if ($arg === '--repo' && isset($argv[$i + 1])) $repo = $argv[$i + 1];
}
use MokoEnterprise\CliFramework;
if ($current === '') {
fwrite(STDERR, "Error: --current is required\n");
exit(1);
}
if ($token === '') {
fwrite(STDERR, "Error: --token or MOKOGITEA_TOKEN env is required\n");
exit(1);
}
if ($org === '' || $repo === '') {
fwrite(STDERR, "Error: --org and --repo (or GITEA_ORG/GITEA_REPO env) are required\n");
exit(1);
}
// Auto-discover branches if --all flag is set
if ($discoverAll) {
$apiUrl = "{$giteaUrl}/api/v1/repos/{$org}/{$repo}/branches?limit=50";
$ch = curl_init($apiUrl);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ["Authorization: token {$token}", 'Accept: application/json'],
CURLOPT_TIMEOUT => 15,
]);
$response = curl_exec($ch);
curl_close($ch);
$branchList = json_decode($response ?: '[]', true) ?: [];
$discovered = [];
foreach ($branchList as $b) {
$name = $b['name'] ?? '';
if ($name !== '' && $name !== $current
&& !str_starts_with($name, 'version/')
&& !str_starts_with($name, 'feature/')
&& !str_starts_with($name, 'patch/')
) {
$discovered[] = $name;
}
}
if (!empty($discovered)) {
$branches = implode(',', $discovered);
echo "Discovered branches: {$branches}\n";
}
}
$updatesFile = rtrim($path, '/') . '/updates.xml';
if (!file_exists($updatesFile)) {
fwrite(STDERR, "No updates.xml found at {$updatesFile}\n");
exit(0);
}
$content = file_get_contents($updatesFile);
$encoded = base64_encode($content);
$giteaUrl = rtrim($giteaUrl, '/');
$apiBase = "{$giteaUrl}/api/v1/repos/{$org}/{$repo}";
$vLabel = $version !== '' ? " {$version}" : '';
$targets = array_filter(
array_map('trim', explode(',', $branches)),
fn($b) => $b !== '' && $b !== $current
);
if (empty($targets)) {
fwrite(STDERR, "No target branches to sync to (current: {$current})\n");
exit(0);
}
$synced = 0;
$failed = 0;
foreach ($targets as $branch) {
fwrite(STDERR, "Syncing updates.xml -> {$branch}...\n");
$sha = getFileSha($apiBase, $token, $branch);
if ($sha === null) {
fwrite(STDERR, " WARNING: could not get SHA from {$branch}\n");
$failed++;
continue;
}
$ok = putFile($apiBase, $token, $branch, $encoded, $sha,
"chore: sync updates.xml{$vLabel} from {$current} [skip ci]");
if ($ok) {
fwrite(STDERR, " Synced to {$branch}\n");
$synced++;
} else {
fwrite(STDERR, " WARNING: push to {$branch} failed\n");
$failed++;
}
}
fwrite(STDERR, "Done: {$synced} synced, {$failed} failed\n");
exit($failed > 0 ? 1 : 0);
// ═══════════════════════════════════════════════════════════════════════
function getFileSha(string $apiBase, string $token, string $branch): ?string
class UpdatesXmlSyncCli extends CliFramework
{
$resp = apiCall('GET', "{$apiBase}/contents/updates.xml?ref={$branch}", $token);
return $resp['sha'] ?? null;
protected function configure(): void
{
$this->setDescription('Sync updates.xml to target branches via Gitea API');
$this->addArgument('--path', 'Repository root containing updates.xml', '.');
$this->addArgument('--branches', 'Comma-separated target branches to sync to', 'main,dev');
$this->addArgument('--all', 'Auto-discover all branches via Gitea API', false);
$this->addArgument('--current', 'Current branch to skip (required)', '');
$this->addArgument('--version', 'Version string for commit message', '');
$this->addArgument('--token', 'Gitea API token', '');
$this->addArgument('--gitea-url', 'Gitea instance URL', '');
$this->addArgument('--org', 'Organization', '');
$this->addArgument('--repo', 'Repository name', '');
}
protected function run(): int
{
$path = $this->getArgument('--path');
$branches = $this->getArgument('--branches');
$discoverAll = $this->getArgument('--all');
$current = $this->getArgument('--current');
$version = $this->getArgument('--version');
$token = $this->getArgument('--token');
$giteaUrl = $this->getArgument('--gitea-url');
$org = $this->getArgument('--org');
$repo = $this->getArgument('--repo');
// Fall back to environment variables
if ($token === '') {
$token = getenv('MOKOGITEA_TOKEN') ?: '';
}
if ($giteaUrl === '') {
$giteaUrl = getenv('GITEA_URL') ?: 'https://git.mokoconsulting.tech';
}
if ($org === '') {
$org = getenv('GITEA_ORG') ?: '';
}
if ($repo === '') {
$repo = getenv('GITEA_REPO') ?: '';
}
if ($current === '') {
$this->log('ERROR', '--current is required');
return 1;
}
if ($token === '') {
$this->log('ERROR', '--token or MOKOGITEA_TOKEN env is required');
return 1;
}
if ($org === '' || $repo === '') {
$this->log('ERROR', '--org and --repo (or GITEA_ORG/GITEA_REPO env) are required');
return 1;
}
// Auto-discover branches if --all flag is set
if ($discoverAll) {
$apiUrl = "{$giteaUrl}/api/v1/repos/{$org}/{$repo}/branches?limit=50";
$ch = curl_init($apiUrl);
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ["Authorization: token {$token}", 'Accept: application/json'],
CURLOPT_TIMEOUT => 15,
]);
$response = curl_exec($ch);
curl_close($ch);
$branchList = json_decode($response ?: '[]', true) ?: [];
$discovered = [];
foreach ($branchList as $b) {
$name = $b['name'] ?? '';
if ($name !== '' && $name !== $current
&& !str_starts_with($name, 'version/')
&& !str_starts_with($name, 'feature/')
&& !str_starts_with($name, 'patch/')
) {
$discovered[] = $name;
}
}
if (!empty($discovered)) {
$branches = implode(',', $discovered);
echo "Discovered branches: {$branches}\n";
}
}
$updatesFile = rtrim($path, '/') . '/updates.xml';
if (!file_exists($updatesFile)) {
$this->log('ERROR', "No updates.xml found at {$updatesFile}");
return 0;
}
$content = file_get_contents($updatesFile);
$encoded = base64_encode($content);
$giteaUrl = rtrim($giteaUrl, '/');
$apiBase = "{$giteaUrl}/api/v1/repos/{$org}/{$repo}";
$vLabel = $version !== '' ? " {$version}" : '';
$targets = array_filter(
array_map('trim', explode(',', $branches)),
fn($b) => $b !== '' && $b !== $current
);
if (empty($targets)) {
$this->log('ERROR', "No target branches to sync to (current: {$current})");
return 0;
}
$synced = 0;
$failed = 0;
foreach ($targets as $branch) {
$this->log('INFO', "Syncing updates.xml -> {$branch}...");
$sha = $this->getFileSha($apiBase, $token, $branch);
if ($sha === null) {
$this->warning("could not get SHA from {$branch}");
$failed++;
continue;
}
$ok = $this->putFile($apiBase, $token, $branch, $encoded, $sha,
"chore: sync updates.xml{$vLabel} from {$current} [skip ci]");
if ($ok) {
$this->log('INFO', "Synced to {$branch}");
$synced++;
} else {
$this->warning("push to {$branch} failed");
$failed++;
}
}
$this->log('INFO', "Done: {$synced} synced, {$failed} failed");
return $failed > 0 ? 1 : 0;
}
private function getFileSha(string $apiBase, string $token, string $branch): ?string
{
$resp = $this->apiCall('GET', "{$apiBase}/contents/updates.xml?ref={$branch}", $token);
return $resp['sha'] ?? null;
}
private function putFile(string $apiBase, string $token, string $branch,
string $encoded, string $sha, string $msg): bool
{
$resp = $this->apiCall('PUT', "{$apiBase}/contents/updates.xml", $token, [
'content' => $encoded,
'sha' => $sha,
'message' => $msg,
'branch' => $branch,
]);
return $resp !== null;
}
private function apiCall(string $method, string $url, string $token, ?array $data = null): ?array
{
$headers = [
"Authorization: token {$token}",
'Content-Type: application/json',
'Accept: application/json',
];
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, $method);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 30);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
if ($data !== null) {
curl_setopt($ch, CURLOPT_POSTFIELDS,
json_encode($data, JSON_UNESCAPED_SLASHES));
}
$body = curl_exec($ch);
$code = (int) curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
return ($code >= 200 && $code < 300)
? (json_decode($body, true) ?: [])
: null;
}
}
function putFile(string $apiBase, string $token, string $branch,
string $encoded, string $sha, string $msg): bool
{
$resp = apiCall('PUT', "{$apiBase}/contents/updates.xml", $token, [
'content' => $encoded,
'sha' => $sha,
'message' => $msg,
'branch' => $branch,
]);
return $resp !== null;
}
function apiCall(string $method, string $url, string $token, ?array $data = null): ?array
{
$headers = [
"Authorization: token {$token}",
'Content-Type: application/json',
'Accept: application/json',
];
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, $method);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 30);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
if ($data !== null) {
curl_setopt($ch, CURLOPT_POSTFIELDS,
json_encode($data, JSON_UNESCAPED_SLASHES));
}
$body = curl_exec($ch);
$code = (int) curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
return ($code >= 200 && $code < 300)
? (json_decode($body, true) ?: [])
: null;
}
$app = new UpdatesXmlSyncCli();
exit($app->execute());