theclawbay 0.3.28 → 0.3.30

package/dist/commands/logout.d.ts

@@ -1,5 +1,8 @@
 import { BaseCommand } from "../lib/base-command";
 export default class LogoutCommand extends BaseCommand {
     static description: string;
+    static flags: {
+        "debug-output": import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
     run(): Promise<void>;
 }

package/dist/commands/logout.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const promises_1 = __importDefault(require("node:fs/promises"));
 const node_os_1 = __importDefault(require("node:os"));
 const node_path_1 = __importDefault(require("node:path"));
+const core_1 = require("@oclif/core");
 const yaml_1 = require("yaml");
 const base_command_1 = require("../lib/base-command");
 const codex_auth_seeding_1 = require("../lib/codex-auth-seeding");
@@ -41,6 +42,27 @@ const THECLAWBAY_OPENAI_PROXY_SUFFIX = "/api/codex-auth/v1/proxy/v1";
 const CONTINUE_MODEL_NAME = "The Claw Bay";
 const TRAE_PATCH_MARKER = "theclawbay-trae-patch";
 const TRAE_BUNDLE_BACKUP_SUFFIX = ".theclawbay-managed-backup";
+function formatSummaryList(items) {
+    return items.join(", ");
+}
+function logLogoutCompactSummary(params) {
+    if (params.revertedTargets.length > 0) {
+        params.log(`Reverted: ${formatSummaryList(params.revertedTargets)}`);
+    }
+    else {
+        params.log("Reverted: no local tool changes were found.");
+    }
+    if (params.sharedConfigChanged) {
+        params.log("Shared config: removed your API key env and managed machine setup.");
+    }
+    else {
+        params.log("Shared config: nothing managed needed cleanup.");
+    }
+    for (const note of params.notes) {
+        params.log(`Note: ${note}`);
+    }
+    params.log("Restart any open terminals or editor windows to clear already-loaded environment.");
+}
 function removeManagedBlock(source, start, end) {
     const markerStart = source.indexOf(start);
     if (markerStart < 0)
@@ -496,41 +518,127 @@ async function cleanupTraeBundle() {
 class LogoutCommand extends base_command_1.BaseCommand {
     async run() {
         await this.runSafe(async () => {
-            const deletedManagedPaths = (await Promise.all([
-                removeFileIfExists(paths_1.managedConfigPath),
-                removeFileIfExists(paths_1.legacyManagedConfigPathClayBay),
-                removeFileIfExists(paths_1.legacyManagedConfigPathCodexAuth),
-            ])).filter(Boolean).length;
-            const removedEnvFile = await removeFileIfExists(ENV_FILE);
-            const updatedShellFiles = await cleanupShellFiles();
-            const updatedVsCodeHooks = await cleanupVsCodeHooks();
-            const updatedCodexConfig = await cleanupCodexConfig();
-            const updatedContinueConfig = await cleanupContinueConfig();
-            const updatedClineConfig = await cleanupClineConfig();
-            const updatedOpenClawConfig = await cleanupOpenClawConfig();
-            const updatedOpenCodeConfig = await cleanupOpenCodeConfig();
-            const updatedKiloConfig = await cleanupKiloConfig();
-            const updatedRooConfig = await cleanupRooConfig();
-            const updatedTraeBundle = await cleanupTraeBundle();
-            const updatedAiderConfig = await cleanupAiderConfig();
-            const sessionMigration = await (0, codex_history_migration_1.migrateSessionProviders)({
-                codexHome: paths_1.codexDir,
-                migrationStateFile: MIGRATION_STATE_FILE,
-                neutralizeSources: HISTORY_PROVIDER_NEUTRALIZE_SOURCES,
-            });
-            const stateDbMigration = await (0, codex_history_migration_1.migrateStateDbProviders)({
-                codexHome: paths_1.codexDir,
-                targetProvider: OPENAI_PROVIDER_ID,
-                sourceProviders: HISTORY_PROVIDER_DB_MIGRATE_SOURCES,
-            });
-            const authSeedCleanup = await (0, codex_auth_seeding_1.cleanupSeededCodexApiKeyAuth)({
-                codexHome: paths_1.codexDir,
-            });
-            const modelCacheCleanup = await (0, codex_model_cache_migration_1.cleanupSeededCodexModelCache)({
-                codexHome: paths_1.codexDir,
-            });
+            const { flags } = await this.parse(LogoutCommand);
+            const debugOutput = flags["debug-output"];
+            const progress = this.createProgressHandle(!debugOutput);
+            let deletedManagedPaths = 0;
+            let removedEnvFile = false;
+            let updatedShellFiles = [];
+            let updatedVsCodeHooks = [];
+            let updatedCodexConfig = false;
+            let updatedContinueConfig = false;
+            let updatedClineConfig = false;
+            let updatedOpenClawConfig = false;
+            let updatedOpenCodeConfig = false;
+            let updatedKiloConfig = false;
+            let updatedRooConfig = false;
+            let updatedTraeBundle = false;
+            let updatedAiderConfig = false;
+            let sessionMigration;
+            let stateDbMigration;
+            let authSeedCleanup;
+            let modelCacheCleanup;
+            try {
+                progress.update("Removing shared machine config");
+                deletedManagedPaths = (await Promise.all([
+                    removeFileIfExists(paths_1.managedConfigPath),
+                    removeFileIfExists(paths_1.legacyManagedConfigPathClayBay),
+                    removeFileIfExists(paths_1.legacyManagedConfigPathCodexAuth),
+                ])).filter(Boolean).length;
+                removedEnvFile = await removeFileIfExists(ENV_FILE);
+                updatedShellFiles = await cleanupShellFiles();
+                updatedVsCodeHooks = await cleanupVsCodeHooks();
+                progress.update("Reverting Codex");
+                updatedCodexConfig = await cleanupCodexConfig();
+                sessionMigration = await (0, codex_history_migration_1.migrateSessionProviders)({
+                    codexHome: paths_1.codexDir,
+                    migrationStateFile: MIGRATION_STATE_FILE,
+                    neutralizeSources: HISTORY_PROVIDER_NEUTRALIZE_SOURCES,
+                });
+                stateDbMigration = await (0, codex_history_migration_1.migrateStateDbProviders)({
+                    codexHome: paths_1.codexDir,
+                    targetProvider: OPENAI_PROVIDER_ID,
+                    sourceProviders: HISTORY_PROVIDER_DB_MIGRATE_SOURCES,
+                });
+                authSeedCleanup = await (0, codex_auth_seeding_1.cleanupSeededCodexApiKeyAuth)({
+                    codexHome: paths_1.codexDir,
+                });
+                modelCacheCleanup = await (0, codex_model_cache_migration_1.cleanupSeededCodexModelCache)({
+                    codexHome: paths_1.codexDir,
+                });
+                progress.update("Reverting Continue");
+                updatedContinueConfig = await cleanupContinueConfig();
+                progress.update("Reverting Cline");
+                updatedClineConfig = await cleanupClineConfig();
+                progress.update("Reverting OpenClaw");
+                updatedOpenClawConfig = await cleanupOpenClawConfig();
+                progress.update("Reverting OpenCode");
+                updatedOpenCodeConfig = await cleanupOpenCodeConfig();
+                progress.update("Reverting Kilo Code");
+                updatedKiloConfig = await cleanupKiloConfig();
+                progress.update("Reverting Roo Code");
+                updatedRooConfig = await cleanupRooConfig();
+                progress.update("Reverting Trae");
+                updatedTraeBundle = await cleanupTraeBundle();
+                progress.update("Reverting Aider");
+                updatedAiderConfig = await cleanupAiderConfig();
+            }
+            catch (error) {
+                progress.fail("Logout failed");
+                throw error;
+            }
             delete process.env[ENV_KEY_NAME];
-            this.log("Logout complete");
+            if (!debugOutput && process.stdout.isTTY) {
+                progress.succeed("Logout complete");
+            }
+            else {
+                this.log("Logout complete");
+            }
+            const revertedTargets = [];
+            const codexChanged = updatedCodexConfig ||
+                updatedVsCodeHooks.length > 0 ||
+                sessionMigration.rewritten > 0 ||
+                sessionMigration.retimed > 0 ||
+                stateDbMigration.updated > 0 ||
+                authSeedCleanup.action === "removed" ||
+                modelCacheCleanup.action === "removed";
+            if (codexChanged)
+                revertedTargets.push("Codex");
+            if (updatedContinueConfig)
+                revertedTargets.push("Continue");
+            if (updatedClineConfig)
+                revertedTargets.push("Cline");
+            if (updatedOpenClawConfig)
+                revertedTargets.push("OpenClaw");
+            if (updatedOpenCodeConfig)
+                revertedTargets.push("OpenCode");
+            if (updatedKiloConfig)
+                revertedTargets.push("Kilo Code");
+            if (updatedRooConfig)
+                revertedTargets.push("Roo Code");
+            if (updatedTraeBundle)
+                revertedTargets.push("Trae");
+            if (updatedAiderConfig)
+                revertedTargets.push("Aider");
+            const summaryNotes = new Set();
+            if (stateDbMigration.failed.length > 0) {
+                summaryNotes.add(stateDbMigration.warning
+                    ? `Codex history cache could not be fully restored. ${stateDbMigration.warning}`
+                    : "Codex history cache could not be fully restored.");
+            }
+            if (authSeedCleanup.warning)
+                summaryNotes.add(authSeedCleanup.warning);
+            if (modelCacheCleanup.warning)
+                summaryNotes.add(modelCacheCleanup.warning);
+            if (!debugOutput) {
+                logLogoutCompactSummary({
+                    log: (message) => this.log(message),
+                    revertedTargets,
+                    sharedConfigChanged: deletedManagedPaths > 0 || removedEnvFile || updatedShellFiles.length > 0 || updatedVsCodeHooks.length > 0,
+                    notes: Array.from(summaryNotes),
+                });
+                return;
+            }
             this.log(`- Managed configs removed: ${deletedManagedPaths}`);
             this.log(`- API key env file removed: ${removedEnvFile ? "yes" : "no"}`);
             this.log(`- Shell profiles updated: ${updatedShellFiles.length ? updatedShellFiles.join(", ") : "none"}`);
@@ -594,4 +702,11 @@ class LogoutCommand extends base_command_1.BaseCommand {
     }
 }
 LogoutCommand.description = "Log out from local The Claw Bay API-key auth on this machine";
+LogoutCommand.flags = {
+    "debug-output": core_1.Flags.boolean({
+        required: false,
+        default: false,
+        description: "Show verbose logout details, file paths, and migration notes",
+    }),
+};
 exports.default = LogoutCommand;

package/dist/commands/setup.d.ts

@@ -6,6 +6,7 @@ export default class SetupCommand extends BaseCommand {
         "api-key": import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         clients: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         yes: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        "debug-output": import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
 }

package/dist/commands/setup.js

@@ -124,6 +124,30 @@ function formatSetupClientLabel(client, hyperlinksEnabled) {
     }
     return `${iconAndLabel} - ${client.siteUrl}`;
 }
+function formatSummaryList(items) {
+    return items.join(", ");
+}
+function logSetupCompactSummary(params) {
+    const configured = params.setupClients
+        .filter((client) => params.selectedSetupClients.has(client.id))
+        .map((client) => client.summaryLabel);
+    const restartTargets = params.setupClients
+        .filter((client) => params.selectedSetupClients.has(client.id) && ["continue", "cline", "roo", "trae"].includes(client.id))
+        .map((client) => client.summaryLabel);
+    if (configured.length > 0) {
+        params.log(`Configured: ${formatSummaryList(configured)}`);
+    }
+    else {
+        params.log("Configured: no local tools selected.");
+    }
+    params.log("Shared config: saved your API key and managed machine setup.");
+    if (restartTargets.length > 0) {
+        params.log(`Restart if already open: ${formatSummaryList(restartTargets)}`);
+    }
+    for (const note of params.notes) {
+        params.log(`Note: ${note}`);
+    }
+}
 function localAppDataDir() {
     if (process.env.LOCALAPPDATA?.trim())
         return process.env.LOCALAPPDATA;
@@ -1143,6 +1167,7 @@ class SetupCommand extends base_command_1.BaseCommand {
     async run() {
         await this.runSafe(async () => {
             const { flags } = await this.parse(SetupCommand);
+            const debugOutput = flags["debug-output"];
             let managed = null;
             try {
                 managed = await (0, config_1.readManagedConfig)();
@@ -1169,6 +1194,7 @@ class SetupCommand extends base_command_1.BaseCommand {
                 {
                     id: "codex",
                     label: "Codex CLI, VS Code extension, and Codex app",
+                    summaryLabel: "Codex",
                     detected: codexDetected,
                     recommended: true,
                     icon: "◎",
@@ -1177,6 +1203,7 @@ class SetupCommand extends base_command_1.BaseCommand {
                 {
                     id: "continue",
                     label: "Continue",
+                    summaryLabel: "Continue",
                     detected: continueDetected,
                     recommended: true,
                     icon: "▶",
@@ -1185,6 +1212,7 @@ class SetupCommand extends base_command_1.BaseCommand {
                 {
                     id: "cline",
                     label: "Cline",
+                    summaryLabel: "Cline",
                     detected: clineDetected,
                     recommended: true,
                     icon: "◈",
@@ -1193,6 +1221,7 @@ class SetupCommand extends base_command_1.BaseCommand {
                 {
                     id: "openclaw",
                     label: "OpenClaw",
+                    summaryLabel: "OpenClaw",
                     detected: hasCommand("openclaw"),
                     recommended: true,
                     icon: "🦞",
@@ -1201,6 +1230,7 @@ class SetupCommand extends base_command_1.BaseCommand {
                 {
                     id: "opencode",
                     label: "OpenCode",
+                    summaryLabel: "OpenCode",
                     detected: hasCommand("opencode"),
                     recommended: true,
                     icon: "⌘",
@@ -1209,6 +1239,7 @@ class SetupCommand extends base_command_1.BaseCommand {
                 {
                     id: "kilo",
                     label: "Kilo Code",
+                    summaryLabel: "Kilo Code",
                     detected: kiloDetected,
                     recommended: true,
                     icon: "⚡",
@@ -1217,6 +1248,7 @@ class SetupCommand extends base_command_1.BaseCommand {
                 {
                     id: "roo",
                     label: "Roo Code",
+                    summaryLabel: "Roo Code",
                     detected: rooDetected,
                     recommended: true,
                     icon: "🦘",
@@ -1225,6 +1257,7 @@ class SetupCommand extends base_command_1.BaseCommand {
                 {
                     id: "trae",
                     label: "Trae (experimental)",
+                    summaryLabel: "Trae",
                     detected: traeDetected,
                     recommended: false,
                     icon: "△",
@@ -1233,6 +1266,7 @@ class SetupCommand extends base_command_1.BaseCommand {
                 {
                     id: "aider",
                     label: "Aider",
+                    summaryLabel: "Aider",
                     detected: aiderDetected,
                     recommended: true,
                     icon: "✦",
@@ -1244,12 +1278,9 @@ class SetupCommand extends base_command_1.BaseCommand {
                 flagSelection: parseSetupClientFlags(flags.clients),
                 skipPrompt: flags.yes,
             });
+            const progress = this.createProgressHandle(!debugOutput);
             let resolved = null;
-            if (selectedSetupClients.size > 0) {
-                resolved = await resolveModels(backendUrl, apiKey);
-            }
-            await (0, config_1.writeManagedConfig)({ backendUrl, apiKey });
-            const updatedShellFiles = await persistApiKeyEnv(apiKey);
+            let updatedShellFiles = [];
             let codexConfigPath = null;
             let updatedVsCodeEnvFiles = [];
             let sessionMigration = null;
@@ -1265,90 +1296,143 @@ class SetupCommand extends base_command_1.BaseCommand {
             let rooConfigPaths = [];
             let traeBundlePathPatched = null;
             let aiderConfigPath = null;
-            if (selectedSetupClients.has("codex")) {
-                codexConfigPath = await writeCodexConfig({ backendUrl, model: resolved?.model ?? DEFAULT_CODEX_MODEL, apiKey });
-                updatedVsCodeEnvFiles = await persistVsCodeServerEnvSource();
-                sessionMigration = await (0, codex_history_migration_1.migrateSessionProviders)({
-                    codexHome: paths_1.codexDir,
-                    migrationStateFile: MIGRATION_STATE_FILE,
-                    neutralizeSources: HISTORY_PROVIDER_NEUTRALIZE_SOURCES,
-                });
-                authSeed = await (0, codex_auth_seeding_1.ensureCodexApiKeyAuth)({
-                    codexHome: paths_1.codexDir,
-                    apiKey,
-                });
-                stateDbMigration = await (0, codex_history_migration_1.migrateStateDbProviders)({
-                    codexHome: paths_1.codexDir,
-                    targetProvider: DEFAULT_PROVIDER_ID,
-                    sourceProviders: HISTORY_PROVIDER_DB_MIGRATE_SOURCES,
-                });
-                modelCacheMigration = await (0, codex_model_cache_migration_1.ensureCodexModelCacheHasGpt54)({
-                    codexHome: paths_1.codexDir,
-                });
-            }
-            if (selectedSetupClients.has("continue")) {
-                continueConfigPath = await writeContinueConfig({
-                    backendUrl,
-                    model: resolved?.model ?? DEFAULT_CONTINUE_MODEL,
-                    apiKey,
-                });
-            }
-            if (selectedSetupClients.has("cline")) {
-                clineConfigPaths = await writeClineConfig({
-                    backendUrl,
-                    model: resolved?.model ?? DEFAULT_CLINE_MODEL,
-                    apiKey,
-                });
-            }
-            if (selectedSetupClients.has("openclaw")) {
-                const openClawResult = await setupOpenClaw({
-                    backendUrl,
-                    model: resolved?.model ?? DEFAULT_CODEX_MODEL,
-                    models: resolved?.models ?? [{ id: DEFAULT_CODEX_MODEL, name: modelDisplayName(DEFAULT_CODEX_MODEL) }],
-                    apiKey,
-                });
-                openClawConfigPath = openClawResult.configPath;
-                openClawCliWarning = openClawResult.cliWarning ?? null;
+            try {
+                if (selectedSetupClients.size > 0) {
+                    progress.update("Resolving supported models");
+                    resolved = await resolveModels(backendUrl, apiKey);
+                }
+                progress.update("Saving shared machine config");
+                await (0, config_1.writeManagedConfig)({ backendUrl, apiKey });
+                updatedShellFiles = await persistApiKeyEnv(apiKey);
+                if (selectedSetupClients.has("codex")) {
+                    progress.update("Configuring Codex");
+                    codexConfigPath = await writeCodexConfig({ backendUrl, model: resolved?.model ?? DEFAULT_CODEX_MODEL, apiKey });
+                    updatedVsCodeEnvFiles = await persistVsCodeServerEnvSource();
+                    sessionMigration = await (0, codex_history_migration_1.migrateSessionProviders)({
+                        codexHome: paths_1.codexDir,
+                        migrationStateFile: MIGRATION_STATE_FILE,
+                        neutralizeSources: HISTORY_PROVIDER_NEUTRALIZE_SOURCES,
+                    });
+                    authSeed = await (0, codex_auth_seeding_1.ensureCodexApiKeyAuth)({
+                        codexHome: paths_1.codexDir,
+                        apiKey,
+                    });
+                    stateDbMigration = await (0, codex_history_migration_1.migrateStateDbProviders)({
+                        codexHome: paths_1.codexDir,
+                        targetProvider: DEFAULT_PROVIDER_ID,
+                        sourceProviders: HISTORY_PROVIDER_DB_MIGRATE_SOURCES,
+                    });
+                    modelCacheMigration = await (0, codex_model_cache_migration_1.ensureCodexModelCacheHasGpt54)({
+                        codexHome: paths_1.codexDir,
+                    });
+                }
+                if (selectedSetupClients.has("continue")) {
+                    progress.update("Configuring Continue");
+                    continueConfigPath = await writeContinueConfig({
+                        backendUrl,
+                        model: resolved?.model ?? DEFAULT_CONTINUE_MODEL,
+                        apiKey,
+                    });
+                }
+                if (selectedSetupClients.has("cline")) {
+                    progress.update("Configuring Cline");
+                    clineConfigPaths = await writeClineConfig({
+                        backendUrl,
+                        model: resolved?.model ?? DEFAULT_CLINE_MODEL,
+                        apiKey,
+                    });
+                }
+                if (selectedSetupClients.has("openclaw")) {
+                    progress.update("Configuring OpenClaw");
+                    const openClawResult = await setupOpenClaw({
+                        backendUrl,
+                        model: resolved?.model ?? DEFAULT_CODEX_MODEL,
+                        models: resolved?.models ?? [{ id: DEFAULT_CODEX_MODEL, name: modelDisplayName(DEFAULT_CODEX_MODEL) }],
+                        apiKey,
+                    });
+                    openClawConfigPath = openClawResult.configPath;
+                    openClawCliWarning = openClawResult.cliWarning ?? null;
+                }
+                if (selectedSetupClients.has("opencode")) {
+                    progress.update("Configuring OpenCode");
+                    openCodePath = await writeOpenCodeConfig({
+                        backendUrl,
+                        model: resolved?.model ?? DEFAULT_CODEX_MODEL,
+                        models: resolved?.models ?? [{ id: DEFAULT_CODEX_MODEL, name: modelDisplayName(DEFAULT_CODEX_MODEL) }],
+                        apiKey,
+                    });
+                }
+                if (selectedSetupClients.has("kilo")) {
+                    progress.update("Configuring Kilo Code");
+                    kiloConfigPath = await writeKiloConfig({
+                        backendUrl,
+                        model: resolved?.model ?? DEFAULT_CODEX_MODEL,
+                        models: resolved?.models ?? [{ id: DEFAULT_CODEX_MODEL, name: modelDisplayName(DEFAULT_CODEX_MODEL) }],
+                        apiKey,
+                    });
+                }
+                if (selectedSetupClients.has("roo")) {
+                    progress.update("Configuring Roo Code");
+                    rooConfigPaths = await writeRooConfig({
+                        backendUrl,
+                        model: resolved?.model ?? DEFAULT_ROO_MODEL,
+                        apiKey,
+                    });
+                }
+                if (selectedSetupClients.has("trae")) {
+                    progress.update("Configuring Trae");
+                    traeBundlePathPatched = await patchTraeBundle({
+                        backendUrl,
+                        model: resolved?.model ?? DEFAULT_CODEX_MODEL,
+                        apiKey,
+                        models: resolved?.models ?? [{ id: DEFAULT_CODEX_MODEL, name: modelDisplayName(DEFAULT_CODEX_MODEL) }],
+                    });
+                }
+                if (selectedSetupClients.has("aider")) {
+                    progress.update("Configuring Aider");
+                    aiderConfigPath = await writeAiderConfig({
+                        backendUrl,
+                        model: resolved?.model ?? DEFAULT_AIDER_MODEL,
+                        apiKey,
+                    });
+                }
             }
-            if (selectedSetupClients.has("opencode")) {
-                openCodePath = await writeOpenCodeConfig({
-                    backendUrl,
-                    model: resolved?.model ?? DEFAULT_CODEX_MODEL,
-                    models: resolved?.models ?? [{ id: DEFAULT_CODEX_MODEL, name: modelDisplayName(DEFAULT_CODEX_MODEL) }],
-                    apiKey,
-                });
+            catch (error) {
+                progress.fail("Setup failed");
+                throw error;
             }
-            if (selectedSetupClients.has("kilo")) {
-                kiloConfigPath = await writeKiloConfig({
-                    backendUrl,
-                    model: resolved?.model ?? DEFAULT_CODEX_MODEL,
-                    models: resolved?.models ?? [{ id: DEFAULT_CODEX_MODEL, name: modelDisplayName(DEFAULT_CODEX_MODEL) }],
-                    apiKey,
-                });
+            if (!debugOutput && process.stdout.isTTY) {
+                progress.succeed("Setup complete");
             }
-            if (selectedSetupClients.has("roo")) {
-                rooConfigPaths = await writeRooConfig({
-                    backendUrl,
-                    model: resolved?.model ?? DEFAULT_ROO_MODEL,
-                    apiKey,
-                });
+            else {
+                this.log("Setup complete");
             }
+            const summaryNotes = new Set();
+            if (resolved?.note)
+                summaryNotes.add(resolved.note);
             if (selectedSetupClients.has("trae")) {
-                traeBundlePathPatched = await patchTraeBundle({
-                    backendUrl,
-                    model: resolved?.model ?? DEFAULT_CODEX_MODEL,
-                    apiKey,
-                    models: resolved?.models ?? [{ id: DEFAULT_CODEX_MODEL, name: modelDisplayName(DEFAULT_CODEX_MODEL) }],
-                });
+                summaryNotes.add("Trae uses an experimental patch. Restart Trae and pick a The Claw Bay model to test it.");
             }
-            if (selectedSetupClients.has("aider")) {
-                aiderConfigPath = await writeAiderConfig({
-                    backendUrl,
-                    model: resolved?.model ?? DEFAULT_AIDER_MODEL,
-                    apiKey,
+            if (openClawCliWarning)
+                summaryNotes.add(openClawCliWarning);
+            if ((stateDbMigration?.failed.length ?? 0) > 0) {
+                summaryNotes.add(stateDbMigration?.warning
+                    ? `Codex history cache could not be fully updated. ${stateDbMigration.warning}`
+                    : "Codex history cache could not be fully updated.");
+            }
+            if (modelCacheMigration?.warning)
+                summaryNotes.add(modelCacheMigration.warning);
+            if (authSeed?.warning)
+                summaryNotes.add(authSeed.warning);
+            if (!debugOutput) {
+                logSetupCompactSummary({
+                    log: (message) => this.log(message),
+                    setupClients,
+                    selectedSetupClients,
+                    notes: Array.from(summaryNotes),
                 });
+                return;
             }
-            this.log("Setup complete");
             this.log(`- Managed config: ${paths_1.managedConfigPath}`);
             this.log(`- Backend: ${backendUrl}`);
             if (selectedSetupClients.size === 0) {
@@ -1536,5 +1620,10 @@ SetupCommand.flags = {
         default: false,
         description: "Accept the recommended detected setup targets without prompting",
     }),
+    "debug-output": core_1.Flags.boolean({
+        required: false,
+        default: false,
+        description: "Show verbose setup details, file paths, and migration notes",
+    }),
 };
 exports.default = SetupCommand;

package/dist/lib/base-command.d.ts

@@ -1,5 +1,13 @@
 import { Command } from "@oclif/core";
+type ProgressHandle = {
+    update(message: string): void;
+    succeed(message?: string): void;
+    fail(message?: string): void;
+    stop(): void;
+};
 export declare abstract class BaseCommand extends Command {
     protected runSafe(action: () => Promise<void>): Promise<void>;
     private handleError;
+    protected createProgressHandle(enabled: boolean): ProgressHandle;
 }
+export {};

package/dist/lib/base-command.js

@@ -27,5 +27,63 @@ class BaseCommand extends core_1.Command {
         }
         this.error(String(error));
     }
+    createProgressHandle(enabled) {
+        if (!enabled || !process.stdout.isTTY) {
+            return {
+                update() { },
+                succeed() { },
+                fail() { },
+                stop() { },
+            };
+        }
+        const frames = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+        let message = "";
+        let frameIndex = 0;
+        let timer = null;
+        const render = (prefix) => {
+            process.stdout.write(`\r\x1b[2K${prefix} ${message}`);
+        };
+        const ensureTimer = () => {
+            if (timer)
+                return;
+            timer = setInterval(() => {
+                frameIndex = (frameIndex + 1) % frames.length;
+                render(frames[frameIndex] ?? frames[0] ?? "•");
+            }, 80);
+            if (typeof timer.unref === "function")
+                timer.unref();
+        };
+        const clearTimer = () => {
+            if (!timer)
+                return;
+            clearInterval(timer);
+            timer = null;
+        };
+        return {
+            update(nextMessage) {
+                message = nextMessage;
+                ensureTimer();
+                render(frames[frameIndex] ?? frames[0] ?? "•");
+            },
+            succeed(nextMessage) {
+                if (nextMessage)
+                    message = nextMessage;
+                clearTimer();
+                render("✓");
+                process.stdout.write("\n");
+            },
+            fail(nextMessage) {
+                if (nextMessage)
+                    message = nextMessage;
+                clearTimer();
+                render("✕");
+                process.stdout.write("\n");
+            },
+            stop() {
+                clearTimer();
+                process.stdout.write("\r\x1b[2K");
+            },
+        };
+    }
 }
 exports.BaseCommand = BaseCommand;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "theclawbay",
-  "version": "0.3.28",
+  "version": "0.3.30",
   "description": "CLI for connecting Codex, Continue, Cline, OpenClaw, OpenCode, Kilo, Roo Code, Aider, and experimental Trae to The Claw Bay.",
   "license": "MIT",
   "bin": {