@minniexcode/codex-switch 0.0.5 → 0.0.6

package/dist/cli.js

@@ -1,73 +1,15 @@
 #!/usr/bin/env node
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.printHelp = printHelp;
 exports.printVersion = printVersion;
-exports.executeCommand = executeCommand;
-const fs = __importStar(require("node:fs"));
-const add_provider_1 = require("./app/add-provider");
-const edit_provider_1 = require("./app/edit-provider");
-const export_providers_1 = require("./app/export-providers");
-const get_current_profile_1 = require("./app/get-current-profile");
-const get_status_1 = require("./app/get-status");
-const import_providers_1 = require("./app/import-providers");
-const list_config_profiles_1 = require("./app/list-config-profiles");
-const list_backups_1 = require("./app/list-backups");
-const list_providers_1 = require("./app/list-providers");
-const remove_provider_1 = require("./app/remove-provider");
-const rollback_backup_1 = require("./app/rollback-backup");
-const run_doctor_1 = require("./app/run-doctor");
-const setup_codex_1 = require("./app/setup-codex");
-const show_config_1 = require("./app/show-config");
-const show_provider_1 = require("./app/show-provider");
-const switch_provider_1 = require("./app/switch-provider");
-const config_1 = require("./domain/config");
+exports.main = main;
+const dispatch_1 = require("./commands/dispatch");
+const args_1 = require("./commands/args");
+const help_1 = require("./commands/help");
 const errors_1 = require("./domain/errors");
-const providers_1 = require("./domain/providers");
-const config_repo_1 = require("./infra/config-repo");
-const config_repo_2 = require("./infra/config-repo");
-const providers_repo_1 = require("./infra/providers-repo");
-const codex_paths_1 = require("./infra/codex-paths");
-const args_1 = require("./cli/args");
-const add_interactive_1 = require("./cli/add-interactive");
-const help_1 = require("./cli/help");
-const interactive_1 = require("./cli/interactive");
 const output_1 = require("./cli/output");
-const prompt_1 = require("./cli/prompt");
-const VERSION = "0.0.5";
+const VERSION = "0.0.6";
 /**
  * Prints the command help text to stdout.
  */
@@ -90,10 +32,10 @@ function main() {
         process.exit(0);
     }
     if (parsed.helpRequested) {
-        if (parsed.helpTarget && !(0, help_1.isKnownCommandName)(parsed.helpTarget)) {
-            (0, output_1.outputFailure)({ command: "help", options: parsed.globalOptions }, (0, errors_1.cliError)("INVALID_ARGUMENT", `Unknown help topic: ${parsed.helpTarget}`, {
-                availableCommands: (0, help_1.buildHelpText)(parsed.helpTarget).split("\n").slice(2),
-            }));
+        if (parsed.helpTarget && !(0, help_1.isKnownCommandNameForHelp)(parsed.helpTarget)) {
+            (0, output_1.outputFailure)({ command: "help", options: parsed.globalOptions }, (0, errors_1.normalizeError)((0, errors_1.cliError)("INVALID_ARGUMENT", `Unknown help topic: ${parsed.helpTarget}`, {
+                availableCommands: (0, help_1.getKnownCommandNames)(),
+            })));
             return;
         }
         printHelp(parsed.helpTarget);
@@ -107,7 +49,7 @@ function main() {
         command: parsed.command,
         options: parsed.globalOptions,
     };
-    executeCommand(ctx, parsed)
+    (0, dispatch_1.executeCommand)(ctx, parsed)
         .then((result) => {
         (0, output_1.outputSuccess)(ctx, result);
     })
@@ -115,342 +57,6 @@ function main() {
         (0, output_1.outputFailure)(ctx, (0, errors_1.normalizeError)(error));
     });
 }
-/**
- * Dispatches a parsed CLI command into the application layer.
- */
-async function executeCommand(ctx, parsed, runtime = (0, prompt_1.createPromptRuntime)()) {
-    let setupPaths = (0, codex_paths_1.createCodexPaths)(ctx.options.codexDir);
-    const paths = setupPaths;
-    switch (ctx.command) {
-        case "list":
-            return (0, list_providers_1.listProviders)(paths.providersPath);
-        case "show": {
-            let providerName = parsed.positionals[0] ?? null;
-            if (!providerName && (0, interactive_1.canPrompt)(runtime, ctx.options.json)) {
-                providerName = await (0, interactive_1.promptForProviderSelection)(runtime, paths.providersPath, "Choose a provider to show");
-            }
-            if (!providerName) {
-                throw (0, errors_1.cliError)("INVALID_ARGUMENT", "Missing provider name for show command.");
-            }
-            return (0, show_provider_1.showProvider)({
-                providersPath: paths.providersPath,
-                providerName,
-                includeSecret: ctx.options.json,
-            });
-        }
-        case "current":
-            return (0, get_current_profile_1.getCurrentProfile)(paths.configPath);
-        case "status":
-            return (0, get_status_1.getStatus)(paths.codexDir, paths.configPath, paths.providersPath);
-        case "config-show":
-            return (0, show_config_1.showConfig)({
-                configPath: paths.configPath,
-                providersPath: paths.providersPath,
-                profileName: parsed.positionals[0] ?? null,
-            });
-        case "config-list-profiles":
-            return (0, list_config_profiles_1.listConfigProfilesView)({
-                configPath: paths.configPath,
-                providersPath: paths.providersPath,
-            });
-        case "switch": {
-            let providerName = parsed.positionals[0] ?? null;
-            if (!providerName && (0, interactive_1.canPrompt)(runtime, ctx.options.json)) {
-                providerName = await (0, interactive_1.promptForProviderSelection)(runtime, paths.providersPath, "Choose a provider to switch to");
-            }
-            if (!providerName) {
-                throw (0, errors_1.cliError)("PROVIDER_NOT_FOUND", "Missing provider name for switch command.");
-            }
-            return (0, switch_provider_1.switchProvider)({
-                codexDir: paths.codexDir,
-                backupsDir: paths.backupsDir,
-                latestBackupPath: paths.latestBackupPath,
-                configPath: paths.configPath,
-                providersPath: paths.providersPath,
-                authPath: paths.authPath,
-                providerName,
-                noLogin: (0, args_1.hasFlag)(parsed.commandOptions, "--no-login"),
-            });
-        }
-        case "import": {
-            const sourceFile = parsed.positionals[0];
-            if (!sourceFile) {
-                throw (0, errors_1.cliError)("INVALID_ARGUMENT", "Missing import file path.");
-            }
-            const merge = (0, args_1.hasFlag)(parsed.commandOptions, "--merge");
-            let repairProfiles;
-            if ((0, interactive_1.canPrompt)(runtime, ctx.options.json)) {
-                await (0, interactive_1.confirmImport)(runtime, sourceFile, merge);
-                const document = (0, config_repo_2.readStructuredConfig)(paths.configPath);
-                const imported = (0, providers_1.validateProvidersShape)(JSON.parse(fs.readFileSync(sourceFile, "utf8")));
-                const current = (0, providers_repo_1.readProvidersFileIfExists)(paths.providersPath);
-                const next = merge ? (0, providers_repo_1.mergeProviders)(current, imported) : imported;
-                const missingProfiles = (0, config_1.buildManagedProfileViews)(document, next)
-                    .filter((view) => view.source === "orphaned-reference")
-                    .map((view) => view.name)
-                    .sort();
-                if (missingProfiles.length > 0) {
-                    repairProfiles = await (0, interactive_1.collectImportRepairDetails)(runtime, missingProfiles);
-                }
-            }
-            return (0, import_providers_1.importProviders)({
-                codexDir: paths.codexDir,
-                backupsDir: paths.backupsDir,
-                latestBackupPath: paths.latestBackupPath,
-                providersPath: paths.providersPath,
-                configPath: paths.configPath,
-                sourceFile,
-                merge,
-                repairProfiles,
-            });
-        }
-        case "export": {
-            const targetFile = parsed.positionals[0];
-            if (!targetFile) {
-                throw (0, errors_1.cliError)("INVALID_ARGUMENT", "Missing export file path.");
-            }
-            let force = (0, args_1.hasFlag)(parsed.commandOptions, "--force");
-            if (!force && (0, interactive_1.canPrompt)(runtime, ctx.options.json) && (0, interactive_1.exportTargetExists)(targetFile)) {
-                const confirmed = await (0, interactive_1.confirmExportOverwrite)(runtime, targetFile);
-                if (!confirmed) {
-                    throw (0, errors_1.cliError)("PROMPT_CANCELLED", "Export cancelled.");
-                }
-                force = true;
-            }
-            return (0, export_providers_1.exportProviders)({
-                providersPath: paths.providersPath,
-                targetFile,
-                force,
-            });
-        }
-        case "add": {
-            let providerName = parsed.positionals[0] ?? null;
-            let profile = (0, args_1.getSingleOption)(parsed.commandOptions, "--profile");
-            let apiKey = (0, args_1.getSingleOption)(parsed.commandOptions, "--api-key");
-            let baseUrl = (0, args_1.getSingleOption)(parsed.commandOptions, "--base-url", false);
-            let model = (0, args_1.getSingleOption)(parsed.commandOptions, "--model", false);
-            let note = (0, args_1.getSingleOption)(parsed.commandOptions, "--note", false);
-            let tags = parsed.commandOptions.get("--tag") ?? [];
-            const createProfile = (0, args_1.hasFlag)(parsed.commandOptions, "--create-profile");
-            if (!providerName || !profile || !apiKey) {
-                if (ctx.options.json || !runtime.isInteractive()) {
-                    throw (0, add_interactive_1.createNonInteractiveAddError)();
-                }
-                const prompted = await (0, add_interactive_1.collectAddInput)(runtime, {
-                    providerName,
-                    profile,
-                    apiKey,
-                    baseUrl,
-                    note,
-                    tags,
-                }, (candidate) => Boolean((0, providers_repo_1.readProvidersFileIfExists)(paths.providersPath).providers[candidate]));
-                providerName = prompted.providerName;
-                profile = prompted.profile;
-                apiKey = prompted.apiKey;
-                baseUrl = prompted.baseUrl ?? null;
-                note = prompted.note ?? null;
-                tags = prompted.tags;
-            }
-            return (0, add_provider_1.addProvider)({
-                codexDir: paths.codexDir,
-                backupsDir: paths.backupsDir,
-                latestBackupPath: paths.latestBackupPath,
-                providersPath: paths.providersPath,
-                configPath: paths.configPath,
-                providerName,
-                profile,
-                apiKey,
-                baseUrl,
-                model,
-                note,
-                tags,
-                createProfile,
-            });
-        }
-        case "edit": {
-            let providerName = parsed.positionals[0] ?? null;
-            if (!providerName && (0, interactive_1.canPrompt)(runtime, ctx.options.json)) {
-                providerName = await (0, interactive_1.promptForProviderSelection)(runtime, paths.providersPath, "Choose a provider to edit");
-            }
-            if (!providerName) {
-                throw (0, errors_1.cliError)("INVALID_ARGUMENT", "Missing provider name for edit command.");
-            }
-            let profile = (0, args_1.getSingleOption)(parsed.commandOptions, "--profile", false) ?? undefined;
-            let apiKey = (0, args_1.getSingleOption)(parsed.commandOptions, "--api-key", false) ?? undefined;
-            let baseUrl = (0, args_1.getSingleOption)(parsed.commandOptions, "--base-url", false) ?? undefined;
-            let model = (0, args_1.getSingleOption)(parsed.commandOptions, "--model", false) ?? undefined;
-            let note = (0, args_1.getSingleOption)(parsed.commandOptions, "--note", false) ?? undefined;
-            let tags = parsed.commandOptions.has("--tag")
-                ? parsed.commandOptions.get("--tag") ?? []
-                : undefined;
-            const createProfile = (0, args_1.hasFlag)(parsed.commandOptions, "--create-profile");
-            const switchToProfile = (0, args_1.getSingleOption)(parsed.commandOptions, "--switch-to", false) ?? undefined;
-            if (profile === undefined &&
-                apiKey === undefined &&
-                baseUrl === undefined &&
-                model === undefined &&
-                note === undefined &&
-                tags === undefined &&
-                (0, interactive_1.canPrompt)(runtime, ctx.options.json)) {
-                const provider = (0, providers_repo_1.readProvidersFileIfExists)(paths.providersPath).providers[providerName];
-                if (!provider) {
-                    throw (0, errors_1.cliError)("PROVIDER_NOT_FOUND", `Provider "${providerName}" was not found.`);
-                }
-                const prompted = await (0, interactive_1.collectEditInput)(runtime, provider);
-                profile = prompted.profile;
-                apiKey = prompted.apiKey;
-                baseUrl = prompted.baseUrl;
-                note = prompted.note;
-                tags = prompted.tags;
-            }
-            if (profile === undefined &&
-                apiKey === undefined &&
-                baseUrl === undefined &&
-                model === undefined &&
-                note === undefined &&
-                tags === undefined) {
-                throw (0, errors_1.cliError)("INVALID_ARGUMENT", "edit requires at least one field to update.");
-            }
-            return (0, edit_provider_1.editProvider)({
-                codexDir: paths.codexDir,
-                backupsDir: paths.backupsDir,
-                latestBackupPath: paths.latestBackupPath,
-                providersPath: paths.providersPath,
-                configPath: paths.configPath,
-                providerName,
-                profile,
-                apiKey,
-                baseUrl,
-                model,
-                note,
-                tags,
-                createProfile,
-                switchToProfile,
-            });
-        }
-        case "remove": {
-            let providerName = parsed.positionals[0] ?? null;
-            const force = (0, args_1.hasFlag)(parsed.commandOptions, "--force");
-            const switchToProfile = (0, args_1.getSingleOption)(parsed.commandOptions, "--switch-to", false) ?? undefined;
-            if (!providerName && (0, interactive_1.canPrompt)(runtime, ctx.options.json)) {
-                providerName = await (0, interactive_1.promptForProviderSelection)(runtime, paths.providersPath, "Choose a provider to remove");
-            }
-            if (!providerName) {
-                throw (0, errors_1.cliError)("PROVIDER_NOT_FOUND", "Missing provider name for remove command.");
-            }
-            if (!force && !(0, interactive_1.canPrompt)(runtime, ctx.options.json)) {
-                throw (0, errors_1.cliError)("INVALID_ARGUMENT", "remove requires --force.");
-            }
-            if ((0, interactive_1.canPrompt)(runtime, ctx.options.json)) {
-                await (0, interactive_1.confirmProviderRemoval)(runtime, providerName);
-            }
-            return (0, remove_provider_1.removeProvider)({
-                codexDir: paths.codexDir,
-                backupsDir: paths.backupsDir,
-                latestBackupPath: paths.latestBackupPath,
-                providersPath: paths.providersPath,
-                configPath: paths.configPath,
-                providerName,
-                switchToProfile,
-            });
-        }
-        case "doctor":
-            return (0, run_doctor_1.runDoctor)({
-                codexDir: paths.codexDir,
-                configPath: paths.configPath,
-                providersPath: paths.providersPath,
-            });
-        case "setup": {
-            let codexDir = ctx.options.codexDir;
-            const candidates = (0, config_repo_1.findCodexDirCandidates)(ctx.options.codexDirExplicit ? ctx.options.codexDir : null);
-            if (!ctx.options.codexDirExplicit) {
-                if (candidates.length > 1) {
-                    if (!(0, interactive_1.canPrompt)(runtime, ctx.options.json)) {
-                        throw (0, errors_1.cliError)("CODEX_DIR_AMBIGUOUS", "Multiple Codex directories were found.", {
-                            candidates,
-                        });
-                    }
-                    codexDir = await (0, interactive_1.chooseCodexDir)(runtime, candidates);
-                }
-                else if (candidates.length === 0) {
-                    if (!(0, interactive_1.canPrompt)(runtime, ctx.options.json)) {
-                        throw (0, errors_1.cliError)("CODEX_DIR_NOT_FOUND", "No Codex directory could be found.");
-                    }
-                    codexDir = await (0, interactive_1.chooseCodexDir)(runtime, candidates);
-                }
-                else {
-                    codexDir = candidates[0];
-                }
-            }
-            setupPaths = (0, codex_paths_1.createCodexPaths)(codexDir);
-            const overwrite = (0, args_1.hasFlag)(parsed.commandOptions, "--overwrite");
-            const merge = (0, args_1.hasFlag)(parsed.commandOptions, "--merge");
-            if (overwrite && merge) {
-                throw (0, errors_1.cliError)("INVALID_ARGUMENT", "setup does not allow both --merge and --overwrite.");
-            }
-            let strategy = overwrite ? "overwrite" : merge ? "merge" : null;
-            const providersExists = fs.existsSync(setupPaths.providersPath);
-            if (providersExists && strategy === null) {
-                if (!(0, interactive_1.canPrompt)(runtime, ctx.options.json)) {
-                    throw (0, errors_1.cliError)("PROVIDERS_ALREADY_EXISTS", "providers.json already exists. Pass --merge or --overwrite.", {
-                        file: setupPaths.providersPath,
-                    });
-                }
-                const selected = await (0, interactive_1.chooseSetupStrategy)(runtime);
-                if (selected === "cancel") {
-                    throw (0, errors_1.cliError)("PROMPT_CANCELLED", "Setup cancelled.");
-                }
-                strategy = selected;
-            }
-            const document = (0, config_repo_2.readStructuredConfig)(setupPaths.configPath);
-            const adoptableProfiles = (0, config_1.buildManagedProfileViews)(document, null)
-                .filter((view) => view.source === "unmanaged" && view.model && view.baseUrl)
-                .map((view) => ({
-                name: view.name,
-                model: view.model,
-                baseUrl: view.baseUrl,
-            }))
-                .sort((left, right) => left.name.localeCompare(right.name));
-            const selectedProfiles = Array.from((0, config_repo_1.listConfigProfiles)(setupPaths.configPath)).sort();
-            let adoptProfiles = [];
-            let providerDetailsByProfile = {};
-            if ((0, interactive_1.canPrompt)(runtime, ctx.options.json)) {
-                adoptProfiles = await (0, interactive_1.chooseSetupProfiles)(runtime, adoptableProfiles);
-                providerDetailsByProfile = await (0, interactive_1.collectSetupProviderDetails)(runtime, adoptProfiles);
-            }
-            else {
-                adoptProfiles = selectedProfiles.filter((profile) => Object.prototype.hasOwnProperty.call(providerDetailsByProfile, profile));
-            }
-            return (0, setup_codex_1.setupCodex)({
-                codexDirOption: ctx.options.codexDir,
-                codexDir: setupPaths.codexDir,
-                configPath: setupPaths.configPath,
-                providersPath: setupPaths.providersPath,
-                backupsDir: setupPaths.backupsDir,
-                latestBackupPath: setupPaths.latestBackupPath,
-                strategy: strategy ?? "overwrite",
-                adoptProfiles,
-                providerDetailsByProfile,
-            });
-        }
-        case "backups-list":
-            return (0, list_backups_1.listBackupEntries)(paths.backupsDir);
-        case "rollback":
-            if (parsed.positionals.length > 1) {
-                throw (0, errors_1.cliError)("INVALID_ARGUMENT", "rollback accepts at most one backup id.");
-            }
-            if ((0, interactive_1.canPrompt)(runtime, ctx.options.json)) {
-                await (0, interactive_1.confirmRollback)(runtime, paths.latestBackupPath, paths.backupsDir, parsed.positionals[0] ?? null);
-            }
-            return (0, rollback_backup_1.rollbackBackup)({
-                latestBackupPath: paths.latestBackupPath,
-                backupsDir: paths.backupsDir,
-                backupId: parsed.positionals[0] ?? null,
-            });
-        default:
-            throw (0, errors_1.cliError)("UNKNOWN_COMMAND", `Unknown command: ${ctx.command}`);
-    }
-}
 if (require.main === module) {
     main();
 }

package/dist/commands/args.js

@@ -0,0 +1,132 @@
+"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("../storage/codex-paths");
+const registry_1 = require("./registry");
+/**
+ * Parses argv into command positionals, global flags, and command-scoped options.
+ */
+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") {
+        return {
+            command: null,
+            positionals: [],
+            globalOptions: {
+                json,
+                codexDir,
+                codexDirExplicit,
+            },
+            commandOptions: new Map(),
+            helpRequested: true,
+            helpTarget: remaining.slice(1).join(" ") || null,
+            versionRequested: false,
+        };
+    }
+    const versionRequested = remaining.includes("--version") || remaining.includes("-v");
+    if (versionRequested) {
+        return defaultParsed(null, {
+            json,
+            codexDir,
+            versionRequested: true,
+        });
+    }
+    const { definition, consumedTokens } = (0, registry_1.resolveCommandFromArgv)(remaining);
+    const command = definition?.id ?? null;
+    const positionals = [];
+    const commandOptions = new Map();
+    let helpRequested = false;
+    const startIndex = consumedTokens > 0 ? consumedTokens : Math.min(remaining.length, 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("--")) {
+                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 && definition ? definition.tokens.join(" ") : 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];
+}

package/dist/commands/dispatch.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeCommand = executeCommand;
+const errors_1 = require("../domain/errors");
+const prompt_1 = require("../interaction/prompt");
+const registry_1 = require("./registry");
+/**
+ * Resolves the shared command definition and executes its registered handler.
+ */
+async function executeCommand(ctx, parsed, runtime = (0, prompt_1.createPromptRuntime)()) {
+    const definition = (0, registry_1.findCommandDefinition)(ctx.command);
+    if (!definition) {
+        throw (0, errors_1.cliError)("UNKNOWN_COMMAND", `Unknown command: ${ctx.command}`);
+    }
+    return definition.handler(ctx, parsed, runtime);
+}