MokoCLI/cli/branch_rename.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: mokocli.CLI
 * INGROUP: mokocli
 * REPO: https://git.mokoconsulting.tech/MokoConsulting/mokocli
 * PATH: /cli/branch_rename.php
 * VERSION: 09.41.00
 * BRIEF: Rename a git branch via Gitea API (create new, update PR, delete old)
 */

declare(strict_types=1);

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

use MokoCli\CliFramework;

class BranchRenameCli extends CliFramework
{
    protected function configure(): void
    {
        $this->setDescription('Rename a git branch via Gitea API (create new, update PR, delete old)');
        $this->addArgument('--from', 'Source branch name', '');
        $this->addArgument('--to', 'Target branch name', '');
        $this->addArgument('--token', 'API token', '');
        $this->addArgument('--api-base', 'API base URL', '');
        $this->addArgument('--pr', 'PR number to update head branch', '');
    }

    protected function run(): int
    {
        $from    = $this->getArgument('--from');
        $to      = $this->getArgument('--to');
        $token   = $this->getArgument('--token');
        $apiBase = $this->getArgument('--api-base');
        $prNum   = $this->getArgument('--pr');

        if (empty($from) || empty($to) || empty($token) || empty($apiBase)) {
            $this->log('ERROR', 'Usage: branch_rename.php --from BRANCH --to BRANCH --token TOKEN --api-base URL [--pr NUM] [--dry-run]');
            return 1;
        }

        if ($from === $to) {
            echo "Source and target are the same ({$from}) — nothing to do\n";
            return 0;
        }

        $headers = [
            "Authorization: token {$token}",
            'Content-Type: application/json',
            'Accept: application/json',
        ];

        // Step 1: Verify source branch exists
        echo "Checking source branch: {$from}\n";
        $check = $this->apiRequest('GET', "{$apiBase}/branches/{$from}", $headers);
        if ($check['code'] !== 200) {
            $this->log('ERROR', "Source branch '{$from}' not found (HTTP {$check['code']})");
            return 1;
        }

        // Step 2: Point the target branch at the source commit.
        // If the target already exists (e.g. a protected `rc` branch that cannot be
        // deleted), force-update its ref in place instead of delete+recreate: deleting a
        // protected branch fails, which then makes the recreate return HTTP 409.
        $sourceSha = '';
        if (isset($check['body']['commit']['id']) && is_string($check['body']['commit']['id'])) {
            $sourceSha = $check['body']['commit']['id'];
        }
        $targetCheck = $this->apiRequest('GET', "{$apiBase}/branches/{$to}", $headers);
        if ($targetCheck['code'] === 200) {
            echo "Target branch '{$to}' already exists - force-updating to {$from}
";
            if (!$this->dryRun) {
                if ($sourceSha === '') {
                    $this->log('ERROR', "Cannot resolve HEAD commit of source '{$from}'");
                    return 1;
                }
                $ref = $this->apiRequest('PATCH', "{$apiBase}/git/refs/heads/{$to}", $headers, [
                    'sha'   => $sourceSha,
                    'force' => true,
                ]);
                if ($ref['code'] < 200 || $ref['code'] >= 300) {
                    $this->log('ERROR', "Failed to force-update '{$to}': HTTP {$ref['code']} (needs force-push perm)");
                    $this->log('ERROR', json_encode($ref['body']));
                    return 1;
                }
            }
        } else {
            echo "Creating branch: {$to} (from {$from})
";
            if (!$this->dryRun) {
                $create = $this->apiRequest('POST', "{$apiBase}/branches", $headers, [
                    'new_branch_name' => $to,
                    'old_branch_name' => $from,
                ]);
                if ($create['code'] < 200 || $create['code'] >= 300) {
                    $this->log('ERROR', "Failed to create branch '{$to}': HTTP {$create['code']}");
                    $this->log('ERROR', json_encode($create['body']));
                    return 1;
                }
            }
        }

        // Step 4: Update PR head branch if PR number provided
        if (!empty($prNum)) {
            echo "Updating PR #{$prNum} head branch: {$from} -> {$to}\n";
            if (!$this->dryRun) {
                $update = $this->apiRequest('PATCH', "{$apiBase}/pulls/{$prNum}", $headers, [
                    'head' => $to,
                ]);
                if ($update['code'] < 200 || $update['code'] >= 300) {
                    $this->log('ERROR', "Warning: Could not update PR head branch (HTTP {$update['code']})");
                    // Non-fatal — the PR may need manual update
                }
            }
        }

        // Step 5: Delete old source branch
        echo "Deleting old branch: {$from}\n";
        if (!$this->dryRun) {
            $delete = $this->apiRequest('DELETE', "{$apiBase}/branches/{$from}", $headers);
            if ($delete['code'] !== 204 && $delete['code'] !== 200) {
                $this->log('ERROR', "Warning: Could not delete old branch '{$from}' (HTTP {$delete['code']})");
                // Non-fatal — branch protection may prevent deletion
            }
        }

        echo "Renamed: {$from} -> {$to}\n";
        return 0;
    }

    /**
     * Make an API request.
     */
    private function apiRequest(string $method, string $url, array $headers, ?array $body = null): array
    {
        $ch = curl_init();
        curl_setopt_array($ch, [
            CURLOPT_URL            => $url,
            CURLOPT_CUSTOMREQUEST  => $method,
            CURLOPT_RETURNTRANSFER => true,
            CURLOPT_HTTPHEADER     => $headers,
            CURLOPT_TIMEOUT        => 30,
        ]);

        if ($body !== null) {
            curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));
        }

        $response = curl_exec($ch);
        $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
        curl_close($ch);

        return [
            'code' => $httpCode,
            'body' => json_decode($response ?: '{}', true) ?: [],
        ];
    }
}

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