refactor(cli): migrate 64 legacy scripts to CliFramework (#235)

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>

cli/release_notes.php

@@ -14,53 +14,69 @@
 
 declare(strict_types=1);
 
-$path = '.';
-$version = null;
-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];
-}
+require_once __DIR__ . '/../lib/Enterprise/CliFramework.php';
 
-if ($version === null) {
-    // Read from README.md
-    $readme = realpath($path) . '/README.md';
-    if (file_exists($readme)) {
-        $content = file_get_contents($readme);
-        if (preg_match('/^\s*VERSION:\s*(\d{2}\.\d{2}\.\d{2})/m', $content, $m)) {
-            $version = $m[1];
+use MokoEnterprise\CliFramework;
+
+class ReleaseNotesCli extends CliFramework
+{
+    protected function configure(): void
+    {
+        $this->setDescription('Extract release notes from CHANGELOG.md for a given version');
+        $this->addArgument('--path', 'Repository root path', '.');
+        $this->addArgument('--version', 'Version to extract notes for', '');
+    }
+
+    protected function run(): int
+    {
+        $path = $this->getArgument('--path');
+        $version = $this->getArgument('--version') ?: null;
+
+        if ($version === null || $version === '') {
+            // Read from README.md
+            $readme = realpath($path) . '/README.md';
+            if (file_exists($readme)) {
+                $content = file_get_contents($readme);
+                if (preg_match('/^\s*VERSION:\s*(\d{2}\.\d{2}\.\d{2})/m', $content, $m)) {
+                    $version = $m[1];
+                }
+            }
         }
+
+        if ($version === null || $version === '') {
+            $this->log('ERROR', 'Usage: release_notes.php --path . --version XX.YY.ZZ');
+            return 1;
+        }
+
+        $changelog = realpath($path) . '/CHANGELOG.md';
+        if (!file_exists($changelog)) {
+            echo "Release {$version}\n";
+            return 0;
+        }
+
+        $lines = file($changelog, FILE_IGNORE_NEW_LINES);
+        $notes = [];
+        $capturing = false;
+
+        foreach ($lines as $line) {
+            if (preg_match('/^##\s.*' . preg_quote($version, '/') . '/', $line)) {
+                $capturing = true;
+                continue;
+            }
+            if ($capturing && preg_match('/^## /', $line)) {
+                break;
+            }
+            if ($capturing) {
+                $notes[] = $line;
+            }
+        }
+
+        $result = trim(implode("\n", $notes));
+        echo $result ?: "Release {$version}";
+        echo "\n";
+        return 0;
     }
 }
 
-if ($version === null) {
-    fwrite(STDERR, "Usage: release_notes.php --path . --version XX.YY.ZZ\n");
-    exit(1);
-}
-
-$changelog = realpath($path) . '/CHANGELOG.md';
-if (!file_exists($changelog)) {
-    echo "Release {$version}\n";
-    exit(0);
-}
-
-$lines = file($changelog, FILE_IGNORE_NEW_LINES);
-$notes = [];
-$capturing = false;
-
-foreach ($lines as $line) {
-    if (preg_match('/^##\s.*' . preg_quote($version, '/') . '/', $line)) {
-        $capturing = true;
-        continue;
-    }
-    if ($capturing && preg_match('/^## /', $line)) {
-        break; // Next version heading — stop
-    }
-    if ($capturing) {
-        $notes[] = $line;
-    }
-}
-
-$result = trim(implode("\n", $notes));
-echo $result ?: "Release {$version}";
-echo "\n";
-exit(0);
+$app = new ReleaseNotesCli();
+exit($app->execute());