@minniexcode/codex-switch 0.0.3 → 0.0.5

package/dist/cli/help.js

@@ -9,6 +9,40 @@ const GROUP_TITLES = {
     recovery: "Diagnostics And Recovery",
 };
 const COMMANDS = [
+    {
+        name: "config-show",
+        group: "read",
+        summary: "Show the structured config profile view.",
+        usage: ["codexs config show [profile] [--json] [--codex-dir <path>]"],
+        details: [
+            "Returns all recognizable config profiles by default, including unmanaged and orphaned references.",
+            "Passing [profile] narrows the response to one profile while preserving the same shape.",
+        ],
+        examples: ["codexs config show", "codexs config show packycode --json"],
+    },
+    {
+        name: "config-list-profiles",
+        group: "read",
+        summary: "List recognizable config profiles with managed-state hints.",
+        usage: ["codexs config list-profiles [--json] [--codex-dir <path>]"],
+        details: [
+            "Lists managed, unmanaged, and orphaned config profiles in one stable view.",
+            "Use config show for richer single-profile details.",
+        ],
+        examples: ["codexs config list-profiles", "codexs config list-profiles --json"],
+    },
+    {
+        name: "setup",
+        group: "write",
+        summary: "Initialize providers.json from an existing Codex directory.",
+        usage: ["codexs setup [--json] [--codex-dir <path>] [--merge|--overwrite]"],
+        details: [
+            "Reads config.toml profiles, collects complete provider records, then writes providers.json under managed backup flow.",
+            "TTY mode can collect missing provider details and choose merge or overwrite when providers.json already exists.",
+            "Non-TTY and --json runs stay non-interactive and require explicit strategy when providers.json already exists.",
+        ],
+        examples: ["codexs setup", "codexs setup --overwrite --json --codex-dir ~/.codex"],
+    },
     {
         name: "list",
         group: "read",
@@ -20,6 +54,18 @@ const COMMANDS = [
         ],
         examples: ["codexs list", "codexs list --json"],
     },
+    {
+        name: "show",
+        group: "read",
+        summary: "Show one provider record from providers.json.",
+        usage: ["codexs show <provider> [--json] [--codex-dir <path>]"],
+        details: [
+            "Human-readable output masks apiKey by default.",
+            "TTY mode can select a missing provider interactively before showing its record.",
+            "JSON mode returns the full provider payload for local automation.",
+        ],
+        examples: ["codexs show packycode", "codexs show packycode --json"],
+    },
     {
         name: "current",
         group: "read",
@@ -38,23 +84,44 @@ const COMMANDS = [
         usage: ["codexs status [--json] [--codex-dir <path>]"],
         details: [
             "Reports file presence, current profile, and whether the live profile is mapped.",
+            "Surfaces config consistency signals without mutating any files.",
             "Use doctor for deeper diagnostics.",
         ],
         examples: ["codexs status", "codexs status --json --codex-dir ./.tmp-codex"],
     },
+    {
+        name: "edit",
+        group: "write",
+        summary: "Update fields on a single provider record.",
+        usage: [
+            "codexs edit <provider> [--profile <name>] [--api-key <key>] [--base-url <url>] [--note <text>] [--tag <tag> ...] [--json] [--codex-dir <path>]",
+            "codexs edit <provider> --profile <name> --create-profile --model <name> --base-url <url>",
+        ],
+        details: [
+            "Passed flags replace only the selected fields and keep the rest unchanged.",
+            "TTY mode can first select a provider, then prompt for fields when no editable options were provided.",
+            "Interactive tags use preset multi-select plus optional custom comma-separated input.",
+            "When rebinding to a missing profile, --create-profile requires both --model and --base-url.",
+            "Backs up providers.json and config.toml before writing.",
+        ],
+        examples: ["codexs edit packycode --note primary", "codexs edit packycode --tag daily --tag paid --json"],
+    },
     {
         name: "add",
         group: "write",
         summary: "Add a provider with explicit flags or progressive TTY prompts.",
         usage: [
             "codexs add <provider> --profile <name> --api-key <key> [--base-url <url>] [--note <text>] [--tag <tag> ...]",
+            "codexs add <provider> --profile <name> --api-key <key> --create-profile --model <name> --base-url <url>",
             "codexs add [--profile <name>] [--api-key <key>] [--base-url <url>] [--note <text>] [--tag <tag> ...]",
         ],
         details: [
             "Prompts only for missing required values when stdin/stdout are TTYs and --json is not set.",
-            "Profile selection prefers existing config.toml profiles, then falls back to free-text input.",
+            "Interactive add collects provider name, profile, and apiKey progressively as plain text inputs.",
             "Confirm API key when prompted interactively because the hidden prompt asks twice before writing.",
+            "Interactive tags use preset multi-select plus optional custom comma-separated input.",
             "Automation and non-TTY environments must pass all required values explicitly.",
+            "Creating a missing profile section requires --create-profile together with --model and --base-url.",
         ],
         examples: [
             "codexs add packycode --profile packycode --api-key sk-xxx",
@@ -79,12 +146,13 @@ const COMMANDS = [
         name: "remove",
         group: "write",
         summary: "Remove a provider from providers.json.",
-        usage: ["codexs remove <provider> [--force] [--json] [--codex-dir <path>]"],
+        usage: ["codexs remove <provider> [--force] [--switch-to <profile>] [--json] [--codex-dir <path>]"],
         details: [
             "TTY mode can select a missing provider interactively and always asks for deletion confirmation.",
             "Non-TTY and --json automation still require both <provider> and --force.",
             "The confirmation prompt includes the provider name and cancels without writing when declined.",
-            "Backs up providers.json before removing the record.",
+            "When removing the last provider linked to the active profile, pass --switch-to first.",
+            "Backs up providers.json and config.toml before removing the record.",
         ],
         examples: ["codexs remove freemodel", "codexs remove freemodel --force --json"],
     },
@@ -95,10 +163,10 @@ const COMMANDS = [
         usage: ["codexs import <file> [--json] [--codex-dir <path>]"],
         details: [
             "The file path is always explicit; there is no path wizard in this release.",
-            "TTY mode asks for confirmation before replacing the current providers registry.",
+            "TTY mode asks for confirmation before replacing or merging into the current providers registry.",
             "Non-TTY and --json runs stay non-interactive and validate the file before writing.",
         ],
-        examples: ["codexs import ./providers.json", "codexs import ./providers.json --json"],
+        examples: ["codexs import ./providers.json", "codexs import ./providers.json --merge --json"],
     },
     {
         name: "export",
@@ -112,6 +180,17 @@ const COMMANDS = [
         ],
         examples: ["codexs export ./providers-backup.json", "codexs export ./providers-backup.json --force"],
     },
+    {
+        name: "backups",
+        group: "recovery",
+        summary: "List historical backup entries.",
+        usage: ["codexs backups list [--json] [--codex-dir <path>]"],
+        details: [
+            "Enumerates backups/ manifests and returns them newest first.",
+            "Corrupt backup manifests are skipped with warnings instead of failing the whole command.",
+        ],
+        examples: ["codexs backups list", "codexs backups list --json"],
+    },
     {
         name: "doctor",
         group: "recovery",
@@ -126,14 +205,14 @@ const COMMANDS = [
     {
         name: "rollback",
         group: "recovery",
-        summary: "Restore the latest managed backup.",
-        usage: ["codexs rollback [--json] [--codex-dir <path>]"],
+        summary: "Restore the latest managed backup or a specific backup id.",
+        usage: ["codexs rollback [<backup-id>] [--json] [--codex-dir <path>]"],
         details: [
-            "TTY mode previews the latest backup path and affected files, then asks for confirmation.",
+            "TTY mode previews the target backup path and affected files, then asks for confirmation.",
             "Non-TTY and --json runs stay non-interactive and execute immediately.",
             "Use after a failed or undesired managed mutation.",
         ],
-        examples: ["codexs rollback", "codexs rollback --json"],
+        examples: ["codexs rollback", "codexs rollback 20260511-221457-switch --json"],
     },
 ];
 const COMMAND_NAME_SET = new Set(COMMANDS.map((command) => command.name));
@@ -141,9 +220,18 @@ function getKnownCommandNames() {
     return COMMANDS.map((command) => command.name);
 }
 function isKnownCommandName(commandName) {
-    return COMMAND_NAME_SET.has(commandName);
+    return COMMAND_NAME_SET.has(commandName) || commandName === "backups-list";
 }
 function buildHelpText(commandName) {
+    const normalizedCommandName = commandName === "backups-list"
+        ? "backups"
+        : commandName === "config-show"
+            ? "config-show"
+            : commandName === "config-list-profiles"
+                ? "config-list-profiles"
+                : commandName === "config"
+                    ? "config-show"
+                    : commandName;
     if (!commandName) {
         return [
             "codex-switch",
@@ -162,6 +250,10 @@ function buildHelpText(commandName) {
             "  --help             Show top-level or command-specific help.",
             "  --version          Print the current CLI version.",
             "",
+            "Environment:",
+            "  CODEXS_CODEX_DIR   Default Codex directory when --codex-dir is not passed.",
+            "  NODE_ENV=development defaults to ./dev-codex/local-sandbox when no override is set.",
+            "",
             "Interactive rules:",
             "  Progressive prompts only run in a real TTY and never run under --json.",
             "  Human write commands may guide missing inputs or ask for dangerous-action confirmation.",
@@ -169,23 +261,26 @@ function buildHelpText(commandName) {
             "",
             "Dangerous commands:",
             "  remove deletes provider records.",
-            "  import replaces providers.json.",
+            "  import replaces or merges providers.json.",
             "  export may overwrite a target file.",
-            "  rollback restores files from the latest backup.",
+            "  rollback restores files from a managed backup.",
             "",
             "Examples:",
+            "  codexs setup",
             "  codexs list",
             "  codexs switch",
             "  codexs add packycode --profile packycode --api-key sk-xxx",
+            "  codexs config show",
             "  codexs remove freemodel",
+            "  codexs backups list",
             "  codexs rollback",
             "  codexs help add",
         ].join("\n");
     }
-    const command = COMMANDS.find((candidate) => candidate.name === commandName);
+    const command = COMMANDS.find((candidate) => candidate.name === normalizedCommandName);
     if (!command) {
         return [
-            `Unknown help topic: ${commandName}`,
+            `Unknown help topic: ${normalizedCommandName}`,
             "",
             "Available commands:",
             ...getKnownCommandNames().map((name) => `  ${name}`),

package/dist/cli/interactive.js

@@ -40,12 +40,22 @@ exports.confirmImport = confirmImport;
 exports.confirmExportOverwrite = confirmExportOverwrite;
 exports.exportTargetExists = exportTargetExists;
 exports.getRollbackSummary = getRollbackSummary;
+exports.getRollbackSummaryById = getRollbackSummaryById;
 exports.confirmRollback = confirmRollback;
+exports.chooseSetupStrategy = chooseSetupStrategy;
+exports.chooseCodexDir = chooseCodexDir;
+exports.chooseSetupProfiles = chooseSetupProfiles;
+exports.collectSetupProviderDetails = collectSetupProviderDetails;
+exports.collectImportRepairDetails = collectImportRepairDetails;
+exports.collectEditInput = collectEditInput;
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
 const errors_1 = require("../domain/errors");
+const backups_1 = require("../domain/backups");
+const codex_paths_1 = require("../infra/codex-paths");
 const providers_repo_1 = require("../infra/providers-repo");
 const backup_repo_1 = require("../infra/backup-repo");
+const add_interactive_1 = require("./add-interactive");
 /**
  * Keeps CLI-side interactivity rules in one place so automation paths remain explicit.
  */
@@ -71,13 +81,15 @@ async function confirmProviderRemoval(runtime, providerName) {
         defaultValue: false,
     });
     if (!confirmed) {
-        throw (0, errors_1.cliError)("INVALID_IMPORT_FILE", `Removal cancelled for provider "${providerName}".`);
+        throw (0, errors_1.cliError)("PROMPT_CANCELLED", `Removal cancelled for provider "${providerName}".`);
     }
 }
-async function confirmImport(runtime, sourceFile) {
-    const confirmed = await runtime.confirmAction(`Import providers from ${path.resolve(sourceFile)} and replace the current registry?`, { defaultValue: false });
+async function confirmImport(runtime, sourceFile, merge = false) {
+    const confirmed = await runtime.confirmAction(merge
+        ? `Import providers from ${path.resolve(sourceFile)} and merge into the current registry?`
+        : `Import providers from ${path.resolve(sourceFile)} and replace the current registry?`, { defaultValue: false });
     if (!confirmed) {
-        throw (0, errors_1.cliError)("INVALID_IMPORT_FILE", "Import cancelled.");
+        throw (0, errors_1.cliError)("PROMPT_CANCELLED", "Import cancelled.");
     }
 }
 async function confirmExportOverwrite(runtime, targetFile) {
@@ -90,8 +102,16 @@ function exportTargetExists(targetFile) {
 }
 function getRollbackSummary(latestBackupPath) {
     const manifest = (0, backup_repo_1.loadLatestManifest)(latestBackupPath);
+    return buildRollbackSummary(manifest);
+}
+function getRollbackSummaryById(backupsDir, backupId) {
+    const manifest = (0, backup_repo_1.loadManifestById)(backupsDir, backupId);
+    return buildRollbackSummary(manifest);
+}
+function buildRollbackSummary(manifest) {
     const previewLines = [
         "Rollback preview",
+        `Backup ID: ${(0, backups_1.getBackupId)(manifest.backupDir)}`,
         `Backup: ${manifest.backupDir}`,
         ...manifest.files.map((file) => {
             const suffix = file.existed ? "restore" : "remove";
@@ -100,15 +120,110 @@ function getRollbackSummary(latestBackupPath) {
     ];
     return { manifest, previewLines };
 }
-async function confirmRollback(runtime, latestBackupPath) {
-    const { previewLines } = getRollbackSummary(latestBackupPath);
+async function confirmRollback(runtime, latestBackupPath, backupsDir, backupId) {
+    const { previewLines } = backupId && backupsDir
+        ? getRollbackSummaryById(backupsDir, backupId)
+        : getRollbackSummary(latestBackupPath);
     for (const line of previewLines) {
         runtime.writeLine(line);
     }
-    const confirmed = await runtime.confirmAction("Restore files from the latest backup?", {
+    const confirmed = await runtime.confirmAction(backupId ? `Restore files from backup "${backupId}"?` : "Restore files from the latest backup?", {
         defaultValue: false,
     });
     if (!confirmed) {
-        throw (0, errors_1.cliError)("INVALID_IMPORT_FILE", "Rollback cancelled.");
+        throw (0, errors_1.cliError)("PROMPT_CANCELLED", "Rollback cancelled.");
+    }
+}
+async function chooseSetupStrategy(runtime) {
+    return runtime.selectOne("providers.json already exists. Choose a setup strategy.", [
+        { value: "merge", label: "merge", hint: "keep existing providers and override by imported names" },
+        { value: "overwrite", label: "overwrite", hint: "replace the existing registry" },
+        { value: "cancel", label: "cancel", hint: "abort setup without writing" },
+    ]);
+}
+async function chooseCodexDir(runtime, candidates) {
+    if (candidates.length === 0) {
+        const manual = (await runtime.inputText("Codex directory path")).trim();
+        if (!manual) {
+            throw (0, errors_1.cliError)("CODEX_DIR_NOT_FOUND", "No Codex directory was provided.");
+        }
+        return (0, codex_paths_1.resolveCodexDir)(manual);
+    }
+    if (candidates.length === 1) {
+        return candidates[0];
+    }
+    const selected = await runtime.selectOne("Choose a Codex directory", [
+        ...candidates.map((candidate) => ({
+            value: candidate,
+            label: candidate,
+        })),
+        {
+            value: "__manual__",
+            label: "Enter manually",
+        },
+    ]);
+    if (selected !== "__manual__") {
+        return selected;
+    }
+    const manual = (await runtime.inputText("Codex directory path")).trim();
+    if (!manual) {
+        throw (0, errors_1.cliError)("CODEX_DIR_NOT_FOUND", "No Codex directory was provided.");
+    }
+    return (0, codex_paths_1.resolveCodexDir)(manual);
+}
+async function chooseSetupProfiles(runtime, profiles) {
+    if (profiles.length === 0) {
+        return [];
     }
+    return runtime.selectMany("Choose unmanaged config profiles to adopt into providers.json.", profiles.map((profile) => ({
+        value: profile.name,
+        label: profile.name,
+        hint: `${profile.model} | ${profile.baseUrl}`,
+    })));
+}
+async function collectSetupProviderDetails(runtime, profiles) {
+    const result = {};
+    for (const profile of profiles) {
+        const providerName = (await runtime.inputText(`Provider name for profile "${profile}"`, {
+            defaultValue: profile,
+        })).trim();
+        const apiKey = (await runtime.inputSecret(`API key for profile "${profile}"`)).trim();
+        const baseUrl = (await runtime.inputText(`Base URL for profile "${profile}" (optional)`)).trim();
+        const note = (await runtime.inputText(`Note for profile "${profile}" (optional)`)).trim();
+        const tags = await (0, add_interactive_1.promptTags)(runtime);
+        result[profile] = {
+            providerName: providerName || profile,
+            apiKey,
+            baseUrl: baseUrl || undefined,
+            note: note || undefined,
+            tags: tags.length > 0 ? tags : undefined,
+        };
+    }
+    return result;
+}
+async function collectImportRepairDetails(runtime, profiles) {
+    const repairs = {};
+    for (const profile of profiles) {
+        const model = (await runtime.inputText(`Model for missing profile "${profile}"`)).trim();
+        const baseUrl = (await runtime.inputText(`Base URL for missing profile "${profile}"`)).trim();
+        repairs[profile] = {
+            model: model || undefined,
+            baseUrl: baseUrl || undefined,
+        };
+    }
+    return repairs;
+}
+async function collectEditInput(runtime, current) {
+    const profile = (await runtime.inputText("Profile", { defaultValue: current.profile })).trim();
+    const apiKey = (await runtime.inputSecret("API key")).trim() || current.apiKey;
+    const baseUrl = (await runtime.inputText("Base URL (optional)", { defaultValue: current.baseUrl ?? "" })).trim();
+    const note = (await runtime.inputText("Note (optional)", { defaultValue: current.note ?? "" })).trim();
+    const tags = await (0, add_interactive_1.promptTags)(runtime, current.tags ?? []);
+    return {
+        profile,
+        apiKey,
+        baseUrl: baseUrl || undefined,
+        note: note || undefined,
+        tags,
+    };
 }

package/dist/cli/output.js

@@ -95,6 +95,22 @@ function renderHumanSuccess(command, data, warnings) {
             }
             break;
         }
+        case "show": {
+            const provider = data?.provider ?? {};
+            lines.push(`Provider: ${String(data?.providerName ?? "")}`);
+            lines.push(`profile: ${String(provider.profile ?? "")}`);
+            lines.push(`apiKey: ${String(provider.apiKey ?? "")}`);
+            if (provider.baseUrl) {
+                lines.push(`baseUrl: ${String(provider.baseUrl)}`);
+            }
+            if (provider.note) {
+                lines.push(`note: ${String(provider.note)}`);
+            }
+            if (Array.isArray(provider.tags) && provider.tags.length > 0) {
+                lines.push(`tags: ${provider.tags.join(", ")}`);
+            }
+            break;
+        }
         case "current":
             lines.push(`Current profile: ${String(data?.profile ?? "")}`);
             break;
@@ -104,23 +120,55 @@ function renderHumanSuccess(command, data, warnings) {
             lines.push(`providersExists: ${String(data?.providersExists ?? false)}`);
             lines.push(`currentProfile: ${String(data?.currentProfile ?? "")}`);
             lines.push(`mappedProvider: ${String(data?.provider ?? "")}`);
+            lines.push(`issues: ${Array.isArray(data?.issues) ? (data?.issues).length : 0}`);
+            break;
+        case "config-show": {
+            lines.push(`activeProfile: ${String(data?.activeProfile ?? "")}`);
+            const profiles = data?.profiles ?? [];
+            for (const profile of profiles) {
+                lines.push(`${String(profile.name)} managed=${String(profile.managed)} active=${String(profile.isActive)} source=${String(profile.source)} model=${String(profile.model ?? "")} baseUrl=${String(profile.baseUrl ?? "")}`);
+            }
+            break;
+        }
+        case "config-list-profiles": {
+            const profiles = data?.profiles ?? [];
+            for (const profile of profiles) {
+                lines.push(`${String(profile.name)} managed=${String(profile.managed)} active=${String(profile.isActive)} source=${String(profile.source)}`);
+            }
             break;
+        }
         case "switch":
             lines.push(`Switched to provider ${String(data?.provider ?? "")} using profile ${String(data?.profile ?? "")}.`);
             lines.push(`Backup: ${String(data?.backupPath ?? "")}`);
             lines.push(`Login performed: ${String(data?.loginPerformed ?? false)}`);
             break;
         case "import":
-            lines.push(`Imported providers from file. Backup: ${String(data?.backupPath ?? "")}`);
+            lines.push(`Imported providers from file using mode ${String(data?.mode ?? "replace")}. Backup: ${String(data?.backupPath ?? "")}`);
             break;
         case "export":
             lines.push(`Exported providers to ${String(data?.exportedTo ?? "")}.`);
             break;
+        case "setup":
+            lines.push(`Initialized providers in ${String(data?.codexDir ?? "")} using ${String(data?.strategy ?? "")}.`);
+            lines.push(`Providers initialized: ${String(data?.providersInitialized ?? 0)}`);
+            lines.push(`Doctor healthy: ${String(data?.doctor?.healthy ?? false)}`);
+            lines.push(`Backup: ${String(data?.backupPath ?? "")}`);
+            break;
+        case "edit":
+            lines.push(`Updated provider ${String(data?.provider ?? "")}. Backup: ${String(data?.backupPath ?? "")}`);
+            lines.push(`Updated fields: ${Array.isArray(data?.updatedFields) ? (data?.updatedFields).join(", ") : ""}`);
+            break;
         case "add":
             lines.push(`Added provider ${String(data?.provider ?? "")}. Backup: ${String(data?.backupPath ?? "")}`);
+            if (Array.isArray(data?.createdProfileSections) && (data?.createdProfileSections).length > 0) {
+                lines.push(`Created profiles: ${(data?.createdProfileSections).join(", ")}`);
+            }
             break;
         case "remove":
             lines.push(`Removed provider ${String(data?.provider ?? "")}. Backup: ${String(data?.backupPath ?? "")}`);
+            if (Array.isArray(data?.deletedProfileSections) && (data?.deletedProfileSections).length > 0) {
+                lines.push(`Deleted profiles: ${(data?.deletedProfileSections).join(", ")}`);
+            }
             break;
         case "doctor": {
             const healthy = Boolean(data?.healthy);
@@ -131,6 +179,13 @@ function renderHumanSuccess(command, data, warnings) {
             }
             break;
         }
+        case "backups-list": {
+            const backups = data?.backups ?? [];
+            for (const backup of backups) {
+                lines.push(`${backup.backupId} ${backup.reason} ${backup.createdAt}`);
+            }
+            break;
+        }
         case "rollback":
             lines.push(`Rollback restored files from ${String(data?.backupPath ?? "")}.`);
             break;

package/dist/cli/prompt.js

@@ -54,6 +54,23 @@ function createPromptRuntime() {
                 return answer.value;
             });
         },
+        selectMany: async (message, choices, options) => {
+            return handlePromptCancellation(async () => {
+                const answer = await inquirer_1.default.prompt([
+                    {
+                        type: "checkbox",
+                        name: "value",
+                        message,
+                        choices: choices.map((choice) => ({
+                            value: choice.value,
+                            name: choice.hint ? `${choice.label} (${choice.hint})` : choice.label,
+                            checked: Boolean(options?.defaultValues?.includes(choice.value)),
+                        })),
+                    },
+                ]);
+                return (Array.isArray(answer.value) ? answer.value : []);
+            });
+        },
         confirmAction: async (message, options) => {
             return handlePromptCancellation(async () => {
                 const answer = await inquirer_1.default.prompt([
@@ -78,9 +95,9 @@ async function handlePromptCancellation(run) {
     }
     catch (error) {
         if (isPromptCancellation(error)) {
-            throw (0, errors_1.cliError)("INVALID_IMPORT_FILE", "Interactive prompt was cancelled.");
+            throw (0, errors_1.cliError)("PROMPT_CANCELLED", "Interactive prompt was cancelled.");
         }
-        throw (0, errors_1.cliError)("INVALID_IMPORT_FILE", "Interactive prompt failed.", {
+        throw (0, errors_1.cliError)("INVALID_ARGUMENT", "Interactive prompt failed.", {
             cause: error instanceof Error ? error.message : String(error),
         });
     }