@minniexcode/codex-switch 0.0.5 → 0.0.7

package/dist/cli/args.js

@@ -1,139 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseArgs = parseArgs;
-exports.hasFlag = hasFlag;
-exports.getSingleOption = getSingleOption;
-const errors_1 = require("../domain/errors");
-const codex_paths_1 = require("../infra/codex-paths");
+exports.parseArgs = exports.hasFlag = exports.getSingleOption = void 0;
 /**
- * Parses argv into command positionals, global flags, and command-scoped options.
+ * Compatibility facade that re-exports shared CLI argument parsing helpers.
  */
-function parseArgs(argv) {
-    let json = false;
-    let codexDir = (0, codex_paths_1.resolveCodexDir)();
-    let codexDirExplicit = false;
-    const remaining = [];
-    for (let index = 0; index < argv.length; index += 1) {
-        const value = argv[index];
-        if (value === "--json") {
-            json = true;
-            continue;
-        }
-        if (value === "--codex-dir") {
-            const next = argv[index + 1];
-            if (!next) {
-                throw (0, errors_1.cliError)("INVALID_ARGUMENT", "--codex-dir requires a path value.");
-            }
-            codexDir = (0, codex_paths_1.resolveCodexDir)(next);
-            codexDirExplicit = true;
-            index += 1;
-            continue;
-        }
-        remaining.push(value);
-    }
-    if (remaining[0] === "help") {
-        const helpTarget = remaining[1] === "backups" && remaining[2] === "list" ? "backups" : remaining[1] ?? null;
-        return {
-            command: null,
-            positionals: [],
-            globalOptions: {
-                json,
-                codexDir,
-                codexDirExplicit,
-            },
-            commandOptions: new Map(),
-            helpRequested: true,
-            helpTarget,
-            versionRequested: false,
-        };
-    }
-    const versionRequested = remaining.includes("--version") || remaining.includes("-v");
-    if (versionRequested) {
-        return defaultParsed(null, {
-            json,
-            codexDir,
-            versionRequested: true,
-        });
-    }
-    const commandToken = remaining[0] ?? null;
-    const command = commandToken === "backups" && remaining[1] === "list"
-        ? "backups-list"
-        : commandToken === "config" && remaining[1] === "show"
-            ? "config-show"
-            : commandToken === "config" && remaining[1] === "list-profiles"
-                ? "config-list-profiles"
-                : commandToken;
-    const positionals = [];
-    const commandOptions = new Map();
-    let helpRequested = false;
-    const startIndex = command === "backups-list" || command === "config-show" || command === "config-list-profiles" ? 2 : 1;
-    for (let index = startIndex; index < remaining.length; index += 1) {
-        const value = remaining[index];
-        if (value === "--help" || value === "-h") {
-            helpRequested = true;
-            continue;
-        }
-        if (value.startsWith("--")) {
-            const optionName = value;
-            const next = remaining[index + 1];
-            if (!next || next.startsWith("--")) {
-                // Boolean flags are stored as "true" so later access uses one uniform map shape.
-                commandOptions.set(optionName, ["true"]);
-                continue;
-            }
-            const existing = commandOptions.get(optionName) ?? [];
-            existing.push(next);
-            commandOptions.set(optionName, existing);
-            index += 1;
-            continue;
-        }
-        positionals.push(value);
-    }
-    return {
-        command,
-        positionals,
-        globalOptions: {
-            json,
-            codexDir,
-            codexDirExplicit,
-        },
-        commandOptions,
-        helpRequested,
-        helpTarget: helpRequested ? (command === "backups-list" ? "backups" : command) : null,
-        versionRequested: false,
-    };
-}
-/**
- * Creates a parsed result for built-in synthetic commands such as help/version.
- */
-function defaultParsed(command, overrides) {
-    return {
-        command,
-        positionals: [],
-        globalOptions: {
-            json: overrides?.json ?? false,
-            codexDir: overrides?.codexDir ?? (0, codex_paths_1.resolveCodexDir)(),
-            codexDirExplicit: false,
-        },
-        commandOptions: new Map(),
-        helpRequested: overrides?.helpRequested ?? false,
-        helpTarget: overrides?.helpTarget ?? null,
-        versionRequested: overrides?.versionRequested ?? false,
-    };
-}
-/**
- * Checks whether a boolean-style option was supplied.
- */
-function hasFlag(options, name) {
-    return options.has(name);
-}
-/**
- * Returns the last supplied value for a single-valued command option.
- */
-function getSingleOption(options, name, required = true) {
-    const values = options.get(name) ?? [];
-    if (values.length === 0) {
-        return required ? null : null;
-    }
-    return values[values.length - 1];
-}
+var args_1 = require("../commands/args");
+Object.defineProperty(exports, "getSingleOption", { enumerable: true, get: function () { return args_1.getSingleOption; } });
+Object.defineProperty(exports, "hasFlag", { enumerable: true, get: function () { return args_1.hasFlag; } });
+Object.defineProperty(exports, "parseArgs", { enumerable: true, get: function () { return args_1.parseArgs; } });

package/dist/cli/help.js

@@ -1,315 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getKnownCommandNames = getKnownCommandNames;
-exports.isKnownCommandName = isKnownCommandName;
-exports.buildHelpText = buildHelpText;
-const GROUP_TITLES = {
-    read: "Read Commands",
-    write: "Change Commands",
-    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",
-        summary: "List configured providers from providers.json.",
-        usage: ["codexs list [--json] [--codex-dir <path>]"],
-        details: [
-            "Reads providers.json and prints provider-to-profile mappings.",
-            "Use --json for machine-readable automation output.",
-        ],
-        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",
-        summary: "Show the active top-level profile from config.toml.",
-        usage: ["codexs current [--json] [--codex-dir <path>]"],
-        details: [
-            "Reads the currently active top-level profile.",
-            "Fails when config.toml is missing or has no top-level profile.",
-        ],
-        examples: ["codexs current", "codexs current --json"],
-    },
-    {
-        name: "status",
-        group: "read",
-        summary: "Show a quick status summary for the local Codex directory.",
-        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.",
-            "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",
-            "codexs add packycode --profile packycode",
-            "codexs add",
-        ],
-    },
-    {
-        name: "switch",
-        group: "write",
-        summary: "Switch to a provider and optionally refresh Codex login.",
-        usage: ["codexs switch <provider> [--no-login] [--json] [--codex-dir <path>]"],
-        details: [
-            "When <provider> is omitted in a TTY, an interactive provider selector is shown.",
-            "When <provider> is passed explicitly, switch proceeds directly without extra confirmation.",
-            "--no-login remains explicit and is never prompted interactively.",
-            "Backs up config.toml and auth.json, then rolls back on failure.",
-        ],
-        examples: ["codexs switch freemodel", "codexs switch --no-login", "codexs switch freemodel --no-login --json"],
-    },
-    {
-        name: "remove",
-        group: "write",
-        summary: "Remove a provider from providers.json.",
-        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.",
-            "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"],
-    },
-    {
-        name: "import",
-        group: "write",
-        summary: "Replace providers.json with an external JSON file.",
-        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 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 --merge --json"],
-    },
-    {
-        name: "export",
-        group: "write",
-        summary: "Export the current providers.json to another file.",
-        usage: ["codexs export <file> [--force] [--json] [--codex-dir <path>]"],
-        details: [
-            "The file path is always explicit; there is no path wizard in this release.",
-            "TTY mode asks before overwriting an existing target when --force is not supplied.",
-            "Non-TTY and --json automation require --force to overwrite an existing file.",
-        ],
-        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",
-        summary: "Run configuration and environment diagnostics.",
-        usage: ["codexs doctor [--json] [--codex-dir <path>]"],
-        details: [
-            "Checks the expected config files, provider/profile consistency, and Codex CLI availability.",
-            "Returns structured issues so users and AI agents can act on them.",
-        ],
-        examples: ["codexs doctor", "codexs doctor --json"],
-    },
-    {
-        name: "rollback",
-        group: "recovery",
-        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 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 20260511-221457-switch --json"],
-    },
-];
-const COMMAND_NAME_SET = new Set(COMMANDS.map((command) => command.name));
-function getKnownCommandNames() {
-    return COMMANDS.map((command) => command.name);
-}
-function isKnownCommandName(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",
-            "",
-            "Manage and switch local Codex provider/profile configuration safely.",
-            "",
-            "Usage:",
-            "  codexs <command> [options]",
-            "  codexs help <command>",
-            "",
-            ...renderGroupedCommands(),
-            "",
-            "Global options:",
-            "  --json             Output the standard JSON envelope and disable all prompts.",
-            "  --codex-dir <path> Target a specific Codex directory instead of ~/.codex.",
-            "  --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.",
-            "  Automation should pass explicit arguments and prefer --json for stable parsing.",
-            "",
-            "Dangerous commands:",
-            "  remove deletes provider records.",
-            "  import replaces or merges providers.json.",
-            "  export may overwrite a target file.",
-            "  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 === normalizedCommandName);
-    if (!command) {
-        return [
-            `Unknown help topic: ${normalizedCommandName}`,
-            "",
-            "Available commands:",
-            ...getKnownCommandNames().map((name) => `  ${name}`),
-        ].join("\n");
-    }
-    return [
-        `codexs ${command.name}`,
-        "",
-        command.summary,
-        "",
-        "Usage:",
-        ...command.usage.map((usage) => `  ${usage}`),
-        "",
-        "Details:",
-        ...command.details.map((detail) => `  ${detail}`),
-        "",
-        "Examples:",
-        ...command.examples.map((example) => `  ${example}`),
-    ].join("\n");
-}
-function renderGroupedCommands() {
-    const lines = [];
-    for (const group of ["read", "write", "recovery"]) {
-        lines.push(`${GROUP_TITLES[group]}:`);
-        for (const command of COMMANDS.filter((candidate) => candidate.group === group)) {
-            lines.push(`  ${command.name.padEnd(8, " ")} ${command.summary}`);
-        }
-        lines.push("");
-    }
-    lines.pop();
-    return lines;
-}
+exports.isKnownCommandName = exports.getKnownCommandNames = exports.buildHelpText = void 0;
+/**
+ * Compatibility facade that re-exports CLI help helpers from the commands layer.
+ */
+var help_1 = require("../commands/help");
+Object.defineProperty(exports, "buildHelpText", { enumerable: true, get: function () { return help_1.buildHelpText; } });
+Object.defineProperty(exports, "getKnownCommandNames", { enumerable: true, get: function () { return help_1.getKnownCommandNames; } });
+Object.defineProperty(exports, "isKnownCommandName", { enumerable: true, get: function () { return help_1.isKnownCommandNameForHelp; } });