breadcrumb-the-shire/core/Console/Commands/Tenant/MigrateLogoAvatarsCommand.php

<?php

namespace MintyPHP\Console\Commands\Tenant;

use MintyPHP\Console\Command;

/**
 * One-time filesystem migration from the legacy tenant avatar layout to the
 * new per-theme logo layout.
 *
 *   storage/tenants/{uuid}/avatar/  →  storage/tenants/{uuid}/logo/light/
 *
 * Idempotent: reruns are a no-op because the source directory no longer
 * exists (or the target is already populated).
 */
final class MigrateLogoAvatarsCommand extends Command
{
    public function name(): string
    {
        return 'tenant:logo-migrate-avatars';
    }

    public function description(): string
    {
        return 'Migrate legacy tenant avatar folders to the light-logo slot';
    }

    public function usage(): string
    {
        return <<<'USAGE'
        Usage: php bin/console tenant:logo-migrate-avatars [options]

        Options:
          --dry-run    List tenants that would be migrated without moving files
          --yes        Execute the migration (required unless --dry-run)
          --cleanup    After migration, remove empty legacy avatar folders

        The command scans storage/tenants/ and for every tenant with an
        avatar/ subfolder moves its contents into logo/light/. Tenants that
        already have logo/light/ are skipped.
        USAGE;
    }

    public function execute(array $args, array $options): int
    {
        $dryRun = (bool) ($options['dry-run'] ?? false);
        $confirm = (bool) ($options['yes'] ?? false);
        $cleanup = (bool) ($options['cleanup'] ?? false);

        if (!$dryRun && !$confirm) {
            fwrite(STDERR, "Pass --dry-run to preview or --yes to execute.\n");
            return 1;
        }

        $storageBase = $this->projectRoot() . '/storage/tenants';
        if (!is_dir($storageBase)) {
            fwrite(STDOUT, "No storage/tenants directory — nothing to migrate.\n");
            return 0;
        }

        $entries = scandir($storageBase) ?: [];
        $migrated = 0;
        $skipped = 0;
        $errors = 0;

        foreach ($entries as $entry) {
            if ($entry === '.' || $entry === '..') {
                continue;
            }
            $tenantDir = $storageBase . '/' . $entry;
            if (!is_dir($tenantDir)) {
                continue;
            }
            $avatarDir = $tenantDir . '/avatar';
            $logoLightDir = $tenantDir . '/logo/light';

            if (!is_dir($avatarDir)) {
                continue;
            }

            if (is_dir($logoLightDir)) {
                fwrite(STDOUT, sprintf("skip   %s (logo/light already exists)\n", $entry));
                $skipped++;
                continue;
            }

            if ($dryRun) {
                fwrite(STDOUT, sprintf("would  %s → logo/light\n", $entry));
                $migrated++;
                continue;
            }

            $logoParent = $tenantDir . '/logo';
            if (!is_dir($logoParent) && !mkdir($logoParent, 0755, true) && !is_dir($logoParent)) {
                fwrite(STDERR, sprintf("error  %s (could not create logo/)\n", $entry));
                $errors++;
                continue;
            }

            if (!rename($avatarDir, $logoLightDir)) {
                fwrite(STDERR, sprintf("error  %s (rename failed)\n", $entry));
                $errors++;
                continue;
            }

            // Variant files are named 'avatar-{size}.{ext}' — rename them to 'logo-{size}.{ext}'.
            $variants = glob($logoLightDir . '/avatar-*.*') ?: [];
            foreach ($variants as $variantPath) {
                $newName = preg_replace('/\/avatar-/', '/logo-', $variantPath, 1);
                if ($newName && $newName !== $variantPath) {
                    @rename($variantPath, $newName);
                }
            }

            fwrite(STDOUT, sprintf("done   %s\n", $entry));
            $migrated++;

            if ($cleanup) {
                // rename moved the directory; nothing to clean up. Listed for clarity.
            }
        }

        fwrite(STDOUT, sprintf(
            "\n%s — migrated=%d skipped=%d errors=%d\n",
            $dryRun ? 'Dry-run complete' : 'Migration complete',
            $migrated,
            $skipped,
            $errors
        ));

        return $errors > 0 ? 1 : 0;
    }
}