Jonathan Miller
b3d9ee8255
Platform: moko-platform CI / Gate 2: Unit Tests (8.1) (push) Blocked by required conditions
Platform: moko-platform CI / Gate 2: Unit Tests (8.2) (push) Blocked by required conditions
Platform: moko-platform CI / Gate 2: Unit Tests (8.3) (push) Blocked by required conditions
Platform: moko-platform CI / Gate 3: Self-Health Check (push) Blocked by required conditions
Platform: moko-platform CI / Gate 4: Governance (push) Blocked by required conditions
Platform: moko-platform CI / Gate 5: Template Integrity (push) Blocked by required conditions
Platform: moko-platform CI / CI Summary (push) Blocked by required conditions
Generic: Repo Health / Release configuration (push) Blocked by required conditions
Generic: Repo Health / Scripts governance (push) Blocked by required conditions
Generic: Repo Health / Repository health (push) Blocked by required conditions
Generic: Repo Health / Site Health (push) Has been skipped
Generic: Repo Health / Access control (push) Successful in 2s
Platform: moko-platform CI / Gate 1: Code Quality (push) Failing after 36s
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>
457 lines
17 KiB
PHP
457 lines
17 KiB
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/updates_xml_build.php
|
|
* BRIEF: Generate Joomla updates.xml from extension manifest metadata
|
|
*/
|
|
|
|
declare(strict_types=1);
|
|
|
|
require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
|
|
|
|
use MokoEnterprise\CliFramework;
|
|
|
|
class UpdatesXmlBuildCli extends CliFramework
|
|
{
|
|
protected function configure(): void
|
|
{
|
|
$this->setDescription('Generate Joomla updates.xml from extension manifest metadata');
|
|
$this->addArgument('--path', 'Repository root (default: .)', '.');
|
|
$this->addArgument('--version', 'Version string (required)', '');
|
|
$this->addArgument('--stability', 'One of: stable, rc, beta, alpha, development (default: stable)', 'stable');
|
|
$this->addArgument('--sha', 'SHA-256 hash of the ZIP package', '');
|
|
$this->addArgument('--gitea-url', 'Gitea instance URL', '');
|
|
$this->addArgument('--org', 'Organization', '');
|
|
$this->addArgument('--repo', 'Repository name', '');
|
|
$this->addArgument('--output', 'Output file path (default: updates.xml in --path)', '');
|
|
$this->addArgument('--github-output', 'Export ext_element, ext_name, ext_type, ext_folder to $GITHUB_OUTPUT', false);
|
|
}
|
|
|
|
protected function run(): int
|
|
{
|
|
$path = $this->getArgument('--path');
|
|
$version = $this->getArgument('--version');
|
|
$stability = $this->getArgument('--stability');
|
|
$sha = $this->getArgument('--sha') ?: null;
|
|
$giteaUrl = $this->getArgument('--gitea-url') ?: (getenv('GITEA_URL') ?: 'https://git.mokoconsulting.tech');
|
|
$org = $this->getArgument('--org') ?: (getenv('GITEA_ORG') ?: '');
|
|
$repo = $this->getArgument('--repo') ?: (getenv('GITEA_REPO') ?: '');
|
|
$outputFile = $this->getArgument('--output') ?: null;
|
|
$githubOutput = $this->getArgument('--github-output');
|
|
|
|
if ($version === '') {
|
|
$this->log('ERROR', 'Usage: updates_xml_build.php --path . --version XX.YY.ZZ [--stability stable] [--sha SHA]');
|
|
return 1;
|
|
}
|
|
|
|
// Strip any existing stability suffix from version
|
|
$version = preg_replace('/-(dev|alpha|beta|rc)$/', '', $version);
|
|
|
|
$root = realpath($path) ?: $path;
|
|
|
|
// -- Read platform from .mokogitea/manifest.xml --------------------------------
|
|
$detectedPlatform = 'joomla';
|
|
$detectedName = $repo;
|
|
$detectedPackageType = '';
|
|
$detectedDisplayName = '';
|
|
$mokoManifest = "{$root}/.mokogitea/manifest.xml";
|
|
if (file_exists($mokoManifest)) {
|
|
$mokoXml = @simplexml_load_file($mokoManifest);
|
|
if ($mokoXml !== false) {
|
|
$rawPlatform = (string)($mokoXml->governance->platform ?? '');
|
|
if ($rawPlatform !== '') {
|
|
$detectedPlatform = match ($rawPlatform) {
|
|
'waas-component' => 'joomla',
|
|
'crm-module' => 'dolibarr',
|
|
default => $rawPlatform,
|
|
};
|
|
}
|
|
$detectedName = (string)($mokoXml->identity->name ?? $repo);
|
|
$detectedDisplayName = (string)($mokoXml->identity->{"display-name"} ?? '');
|
|
$detectedPackageType = (string)($mokoXml->build->{"package-type"} ?? '');
|
|
|
|
if (empty($org)) {
|
|
$manifestOrg = (string)($mokoXml->identity->org ?? '');
|
|
if ($manifestOrg !== '') {
|
|
$org = $manifestOrg;
|
|
}
|
|
}
|
|
if (empty($repo)) {
|
|
$manifestName = (string)($mokoXml->identity->name ?? '');
|
|
if ($manifestName !== '') {
|
|
$repo = $manifestName;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
// -- Fallback: detect org/repo from git remote --------------------------------
|
|
if (empty($org) || empty($repo)) {
|
|
$remoteUrl = trim(shell_exec("git -C " . escapeshellarg($root) . " remote get-url origin 2>/dev/null") ?? '');
|
|
if (preg_match('#[/:]([^/:]+)/([^/]+?)(?:\.git)?$#', $remoteUrl, $m)) {
|
|
if (empty($org)) {
|
|
$org = $m[1];
|
|
}
|
|
if (empty($repo)) {
|
|
$repo = $m[2];
|
|
}
|
|
}
|
|
}
|
|
|
|
// -- Locate Joomla manifest ---------------------------------------------------
|
|
$manifest = null;
|
|
|
|
$candidates = glob("{$root}/src/pkg_*.xml") ?: [];
|
|
foreach ($candidates as $f) {
|
|
if (strpos(file_get_contents($f), '<extension') !== false) {
|
|
$manifest = $f;
|
|
break;
|
|
}
|
|
}
|
|
|
|
if ($manifest === null) {
|
|
$searchDirs = ["{$root}/src", "{$root}"];
|
|
foreach ($searchDirs as $dir) {
|
|
if (!is_dir($dir)) {
|
|
continue;
|
|
}
|
|
foreach (glob("{$dir}/*.xml") ?: [] as $f) {
|
|
if (strpos(file_get_contents($f), '<extension') !== false) {
|
|
$manifest = $f;
|
|
break 2;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
if ($manifest === null && $detectedPlatform === 'joomla') {
|
|
$this->log('ERROR', "No Joomla XML manifest found in {$root}");
|
|
return 1;
|
|
}
|
|
|
|
// -- Parse extension metadata -------------------------------------------------
|
|
$extName = '';
|
|
$extType = '';
|
|
$extElement = '';
|
|
$extClient = '';
|
|
$extFolder = '';
|
|
$targetPlatform = '';
|
|
$phpMinimum = '';
|
|
|
|
if ($manifest !== null) {
|
|
$xml = file_get_contents($manifest);
|
|
|
|
if (preg_match('/<name>([^<]+)<\/name>/', $xml, $m)) {
|
|
$extName = $m[1];
|
|
}
|
|
if (preg_match('/<extension[^>]*type="([^"]+)"/', $xml, $m)) {
|
|
$extType = $m[1];
|
|
}
|
|
if (preg_match('/<element>([^<]+)<\/element>/', $xml, $m)) {
|
|
$extElement = $m[1];
|
|
}
|
|
if (empty($extElement) && preg_match('/<packagename>([^<]+)<\/packagename>/', $xml, $m)) {
|
|
$extElement = $m[1];
|
|
}
|
|
if (empty($extElement) && preg_match('/plugin="([^"]+)"/', $xml, $m)) {
|
|
$extElement = $m[1];
|
|
}
|
|
if (empty($extElement) && preg_match('/module="([^"]+)"/', $xml, $m)) {
|
|
$extElement = $m[1];
|
|
}
|
|
if (empty($extElement)) {
|
|
$fname = strtolower(pathinfo($manifest, PATHINFO_FILENAME));
|
|
if (in_array($fname, ['templatedetails', 'manifest'])) {
|
|
$extElement = strtolower(str_replace([' ', '-'], '', $repo ?: basename($root)));
|
|
} else {
|
|
$extElement = $fname;
|
|
}
|
|
}
|
|
$extElement = preg_replace('/^(pkg_|com_|mod_|plg_\w+_|tpl_|lib_)/', '', $extElement);
|
|
|
|
if (preg_match('/<extension[^>]*client="([^"]+)"/', $xml, $m)) {
|
|
$extClient = $m[1];
|
|
}
|
|
if (preg_match('/<extension[^>]*group="([^"]+)"/', $xml, $m)) {
|
|
$extFolder = $m[1];
|
|
}
|
|
if (preg_match('/(<targetplatform[^\/]*\/>)/', $xml, $m)) {
|
|
$targetPlatform = $m[1];
|
|
}
|
|
if (empty($targetPlatform)) {
|
|
$targetPlatform = '<targetplatform name="joomla" version="(5|6)\..*" />';
|
|
}
|
|
if (preg_match('/<php_minimum>([^<]+)<\/php_minimum>/', $xml, $m)) {
|
|
$phpMinimum = $m[1];
|
|
}
|
|
} else {
|
|
$extName = $detectedName ?: ($repo ?: basename($root));
|
|
$extElement = strtolower(str_replace([' ', '-'], '', $extName));
|
|
$extType = $detectedPackageType ?: 'generic';
|
|
$targetPlatform = "<targetplatform name=\"{$detectedPlatform}\" version=\".*\" />";
|
|
}
|
|
|
|
if (empty($extName)) {
|
|
$extName = $repo ?: basename($root);
|
|
}
|
|
if (empty($extType)) {
|
|
$extType = 'component';
|
|
}
|
|
|
|
if (!empty($detectedDisplayName)) {
|
|
$displayName = $detectedDisplayName;
|
|
} elseif (!empty($detectedName)) {
|
|
$displayName = $detectedName;
|
|
} else {
|
|
$displayName = $extName;
|
|
}
|
|
|
|
// -- Build type prefix --------------------------------------------------------
|
|
$typePrefix = '';
|
|
switch ($extType) {
|
|
case 'plugin':
|
|
$typePrefix = "plg_{$extFolder}_";
|
|
break;
|
|
case 'module':
|
|
$typePrefix = 'mod_';
|
|
break;
|
|
case 'component':
|
|
$typePrefix = 'com_';
|
|
break;
|
|
case 'template':
|
|
$typePrefix = 'tpl_';
|
|
break;
|
|
case 'library':
|
|
$typePrefix = 'lib_';
|
|
break;
|
|
case 'package':
|
|
$typePrefix = 'pkg_';
|
|
break;
|
|
}
|
|
|
|
// -- Export to GITHUB_OUTPUT if requested -------------------------------------
|
|
if ($githubOutput) {
|
|
$ghOutput = getenv('GITHUB_OUTPUT');
|
|
$lines = [
|
|
"ext_element={$extElement}",
|
|
"ext_name={$extName}",
|
|
"ext_type={$extType}",
|
|
"ext_folder={$extFolder}",
|
|
"type_prefix={$typePrefix}",
|
|
];
|
|
if ($ghOutput) {
|
|
file_put_contents($ghOutput, implode("\n", $lines) . "\n", FILE_APPEND);
|
|
$this->log('INFO', "Exported " . count($lines) . " fields to GITHUB_OUTPUT");
|
|
} else {
|
|
foreach ($lines as $line) {
|
|
echo "{$line}\n";
|
|
}
|
|
}
|
|
}
|
|
|
|
// -- Stability suffix map -----------------------------------------------------
|
|
$stabilitySuffixMap = [
|
|
'stable' => '',
|
|
'rc' => '-rc',
|
|
'beta' => '-beta',
|
|
'alpha' => '-alpha',
|
|
'development' => '-dev',
|
|
'dev' => '-dev',
|
|
];
|
|
|
|
$stabilityTagMap = [
|
|
'stable' => 'stable',
|
|
'rc' => 'rc',
|
|
'beta' => 'beta',
|
|
'alpha' => 'alpha',
|
|
'development' => 'dev',
|
|
'dev' => 'dev',
|
|
];
|
|
|
|
$releaseTagMap = [
|
|
'stable' => 'stable',
|
|
'rc' => 'release-candidate',
|
|
'beta' => 'beta',
|
|
'alpha' => 'alpha',
|
|
'development' => 'development',
|
|
'dev' => 'development',
|
|
];
|
|
|
|
$primarySuffix = $stabilitySuffixMap[$stability] ?? '';
|
|
$primaryVersion = $version . $primarySuffix;
|
|
|
|
$clientTag = '';
|
|
if (!empty($extClient)) {
|
|
$clientTag = " <client>{$extClient}</client>";
|
|
} else {
|
|
$clientTag = ' <client>site</client>';
|
|
}
|
|
|
|
$folderTag = '';
|
|
if (!empty($extFolder) && $extType === 'plugin') {
|
|
$folderTag = " <folder>{$extFolder}</folder>";
|
|
}
|
|
|
|
$phpTag = '';
|
|
if (!empty($phpMinimum)) {
|
|
$phpTag = " <php_minimum>{$phpMinimum}</php_minimum>";
|
|
}
|
|
|
|
$shaTag = '';
|
|
if (!empty($sha)) {
|
|
$shaTag = " <sha256>{$sha}</sha256>";
|
|
}
|
|
|
|
// -- Write ONLY the single channel being released --------------------------------
|
|
$entries = [];
|
|
$giteaTag = $releaseTagMap[$stability] ?? $stability;
|
|
$channelVersion = $version . ($stabilitySuffixMap[$stability] ?? '');
|
|
$channelDownloadUrl = "{$giteaUrl}/{$org}/{$repo}/releases/download/{$giteaTag}/{$typePrefix}{$extElement}-{$channelVersion}.zip";
|
|
$channelInfoUrl = "{$giteaUrl}/{$org}/{$repo}/releases/tag/{$giteaTag}";
|
|
$joomlaTag = $stabilityTagMap[$stability] ?? $stability;
|
|
$changelogUrl = "{$giteaUrl}/{$org}/{$repo}/raw/branch/main/CHANGELOG.md";
|
|
|
|
$entries[] = $this->buildEntry(
|
|
$joomlaTag,
|
|
$channelVersion,
|
|
$channelDownloadUrl,
|
|
$displayName,
|
|
$stability,
|
|
$extElement,
|
|
$extType,
|
|
$clientTag,
|
|
$folderTag,
|
|
$channelInfoUrl,
|
|
$targetPlatform,
|
|
$phpTag,
|
|
$shaTag,
|
|
$changelogUrl
|
|
);
|
|
|
|
// -- Preserve existing entries for channels not being updated -----------------
|
|
$dest = $outputFile ?? "{$root}/updates.xml";
|
|
$preservedEntries = [];
|
|
|
|
if (file_exists($dest)) {
|
|
$existingXml = @simplexml_load_file($dest);
|
|
if ($existingXml) {
|
|
$writtenTag = $joomlaTag;
|
|
$writtenAliases = [$writtenTag];
|
|
if ($writtenTag === 'dev') {
|
|
$writtenAliases[] = 'development';
|
|
}
|
|
if ($writtenTag === 'development') {
|
|
$writtenAliases[] = 'dev';
|
|
}
|
|
|
|
foreach ($existingXml->update as $existingUpdate) {
|
|
$existingTag = '';
|
|
if (isset($existingUpdate->tags->tag)) {
|
|
$existingTag = (string) $existingUpdate->tags->tag;
|
|
}
|
|
if (!empty($existingTag) && !in_array($existingTag, $writtenAliases, true)) {
|
|
$preservedEntries[] = ' ' . trim($existingUpdate->asXML());
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
// -- Write updates.xml --------------------------------------------------------
|
|
$year = date('Y');
|
|
$output = <<<XML
|
|
<?xml version='1.0' encoding='UTF-8'?>
|
|
<!-- Copyright (C) {$year} Moko Consulting <hello@mokoconsulting.tech>
|
|
SPDX-License-Identifier: GPL-3.0-or-later
|
|
VERSION: {$primaryVersion}
|
|
-->
|
|
|
|
<updates>
|
|
XML;
|
|
$allEntries = array_merge($preservedEntries, $entries);
|
|
|
|
$stabilityOrder = ['dev' => 0, 'development' => 0, 'alpha' => 1, 'beta' => 2, 'rc' => 3, 'stable' => 4];
|
|
usort($allEntries, function ($a, $b) use ($stabilityOrder) {
|
|
preg_match('/<tag>([^<]+)<\/tag>/', $a, $ma);
|
|
preg_match('/<tag>([^<]+)<\/tag>/', $b, $mb);
|
|
return ($stabilityOrder[$ma[1] ?? ''] ?? 99) - ($stabilityOrder[$mb[1] ?? ''] ?? 99);
|
|
});
|
|
|
|
$output .= "\n" . implode("\n", $allEntries) . "\n</updates>\n";
|
|
|
|
$dest = $outputFile ?? "{$root}/updates.xml";
|
|
file_put_contents($dest, $output);
|
|
|
|
$channelCount = count($entries);
|
|
echo "updates.xml: {$primaryVersion} ({$channelCount} channel(s), stability={$stability})\n";
|
|
echo "Output: {$dest}\n";
|
|
return 0;
|
|
}
|
|
|
|
private function buildEntry(
|
|
string $tagName,
|
|
string $entryVersion,
|
|
string $entryDownloadUrl,
|
|
string $displayName,
|
|
string $stabilityLabel,
|
|
string $extElement,
|
|
string $extType,
|
|
string $clientTag,
|
|
string $folderTag,
|
|
string $infoUrl,
|
|
string $targetPlatform,
|
|
string $phpTag,
|
|
string $shaTag,
|
|
string $changelogUrl = ''
|
|
): string {
|
|
$lines = [];
|
|
$lines[] = ' <update>';
|
|
$lines[] = " <name>{$displayName}</name>";
|
|
$lines[] = " <description>{$displayName} {$stabilityLabel} build.</description>";
|
|
$prefixMap = [
|
|
'package' => 'pkg_',
|
|
'module' => 'mod_',
|
|
'component' => 'com_',
|
|
'library' => 'lib_',
|
|
];
|
|
$dbElement = isset($prefixMap[$extType]) ? $prefixMap[$extType] . $extElement : $extElement;
|
|
$lines[] = " <element>{$dbElement}</element>";
|
|
$lines[] = " <type>{$extType}</type>";
|
|
$lines[] = $clientTag;
|
|
$lines[] = " <version>{$entryVersion}</version>";
|
|
$lines[] = " <creationDate>" . date('Y-m-d') . "</creationDate>";
|
|
if (!empty($folderTag)) {
|
|
$lines[] = $folderTag;
|
|
}
|
|
$lines[] = " <infourl title='{$displayName}'>{$infoUrl}</infourl>";
|
|
$lines[] = ' <downloads>';
|
|
$lines[] = " <downloadurl type='full' format='zip'>{$entryDownloadUrl}</downloadurl>";
|
|
$lines[] = ' </downloads>';
|
|
if (!empty($shaTag)) {
|
|
$lines[] = $shaTag;
|
|
}
|
|
$lines[] = " <tags><tag>{$tagName}</tag></tags>";
|
|
if (!empty($changelogUrl)) {
|
|
$lines[] = " <changelogurl>{$changelogUrl}</changelogurl>";
|
|
}
|
|
$lines[] = ' <maintainer>Moko Consulting</maintainer>';
|
|
$lines[] = ' <maintainerurl>https://mokoconsulting.tech</maintainerurl>';
|
|
$lines[] = " {$targetPlatform}";
|
|
if (!empty($phpTag)) {
|
|
$lines[] = $phpTag;
|
|
}
|
|
$lines[] = ' </update>';
|
|
return implode("\n", $lines);
|
|
}
|
|
}
|
|
|
|
$app = new UpdatesXmlBuildCli();
|
|
exit($app->execute());
|