moko-platform/cli/archive_repo.php

#!/usr/bin/env php
<?php

/* Copyright (C) 2026 Moko Consulting <hello@mokoconsulting.tech>
 *
 * This file is part of a Moko Consulting project.
 *
 * 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/archive_repo.php
 * BRIEF: Gracefully retire a governed repository — archive, close issues/PRs, remove sync def
 */

declare(strict_types=1);

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

use MokoEnterprise\CliFramework;
use MokoEnterprise\Config;
use MokoEnterprise\PlatformAdapterFactory;

class ArchiveRepoCli extends CliFramework
{
    protected function configure(): void
    {
        $this->setDescription('Gracefully retire a governed repository — archive, close issues/PRs, remove sync def');
        $this->addArgument('--repo', 'Repository name to archive', '');
        $this->addArgument('--skip-close', 'Archive only, keep issues open', false);
    }

    protected function run(): int
    {
        $repoName  = $this->getArgument('--repo');
        $skipClose = $this->getArgument('--skip-close');

        if (empty($repoName)) {
            $this->log('ERROR', 'Usage: php archive_repo.php --repo <RepoName> [--skip-close] [--dry-run]');
            return 2;
        }

        $config  = Config::load();
        $adapter = PlatformAdapterFactory::create($config);
        $org     = $config->getString(
            $adapter->getPlatformName() . '.organization',
            'mokoconsulting-tech'
        );

        $platformName = $adapter->getPlatformName();

        echo "Archiving repository: {$org}/{$repoName} (on {$platformName})\n\n";

        // -- Step 1: Verify repo exists --
        echo "Step 1: Verifying repository...\n";
        try {
            $repoData = $adapter->getRepo($org, $repoName);
        } catch (\Exception $e) {
            $this->log('ERROR', "Repository {$org}/{$repoName} not found: " . $e->getMessage());
            return 1;
        }
        if ($repoData['archived'] ?? false) {
            echo "  Already archived — nothing to do\n";
            return 0;
        }
        echo "  Found: " . ($repoData['html_url'] ?? "{$org}/{$repoName}") . "\n";

        // -- Step 2: Close all open PRs --
        if (!$skipClose) {
            echo "Step 2: Closing open pull requests...\n";
            $prs = $adapter->listPullRequests($org, $repoName, ['state' => 'open']);
            $prCount = count($prs);
            echo "  Found {$prCount} open PRs\n";

            foreach ($prs as $pr) {
                $num = $pr['number'];
                if (!$this->dryRun) {
                    $adapter->updatePullRequest($org, $repoName, $num, ['state' => 'closed']);
                    $adapter->addIssueComment(
                        $org,
                        $repoName,
                        $num,
                        "Closed as part of repository archival. This repository is being retired.\n\n*Auto-closed by `archive_repo.php`*"
                    );
                }
                echo "  Closed PR #{$num}: {$pr['title']}\n";
            }

            // -- Step 3: Close all open issues --
            echo "Step 3: Closing open issues...\n";
            $issues = $adapter->listIssues($org, $repoName, ['state' => 'open']);
            $issues = array_filter($issues, fn($i) => !isset($i['pull_request']));
            $issueCount = count($issues);
            echo "  Found {$issueCount} open issues\n";

            foreach ($issues as $issue) {
                $num = $issue['number'];
                if (!$this->dryRun) {
                    $adapter->closeIssue($org, $repoName, $num);
                    $adapter->addIssueComment(
                        $org,
                        $repoName,
                        $num,
                        "Closed as part of repository archival.\n\n*Auto-closed by `archive_repo.php`*"
                    );
                }
                echo "  Closed issue #{$num}: {$issue['title']}\n";
            }
        } else {
            echo "Step 2-3: Skipping issue/PR closure (--skip-close)\n";
        }

        // -- Step 4: Archive the repository --
        echo "Step 4: Archiving repository...\n";
        if (!$this->dryRun) {
            try {
                $adapter->archiveRepo($org, $repoName);
                echo "  Repository archived\n";
            } catch (\Exception $e) {
                echo "  Failed to archive: " . $e->getMessage() . "\n";
            }
        } else {
            echo "  (dry-run) would archive {$org}/{$repoName}\n";
        }

        // -- Step 5: (removed — sync definitions no longer used) --

        // -- Step 6: Create archival record --
        echo "Step 6: Creating archival record...\n";
        if (!$this->dryRun) {
            $now = gmdate('Y-m-d H:i:s') . ' UTC';
            try {
                $issue = $adapter->createIssue(
                    $org,
                    'moko-platform',
                    "chore: archived repository {$repoName}",
                    "## Repository Archived\n\n"
                    . "**Repository:** `{$org}/{$repoName}`\n"
                    . "**Archived:** {$now}\n"
                    . "**Platform:** {$platformName}\n"
                    . "**Sync definition removed:** yes\n\n"
                    . "---\n"
                    . "*Auto-created by `archive_repo.php`*\n",
                    [
                        'labels'    => ['type: chore', 'automation', 'archived'],
                        'assignees' => ['jmiller'],
                    ]
                );
                if (isset($issue['number'])) {
                    echo "  Archival record: moko-platform#{$issue['number']}\n";
                }
            } catch (\Exception $e) {
                echo "  Warning: could not create archival record: " . $e->getMessage() . "\n";
            }
        } else {
            echo "  (dry-run) would create archival record issue\n";
        }

        echo "\n" . str_repeat('-', 50) . "\n";
        echo "Repository {$org}/{$repoName} archived successfully\n";
        return 0;
    }
}

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