@minniexcode/codex-switch 0.0.4 → 0.0.5

package/dist/app/add-provider.js

@@ -1,8 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.addProvider = addProvider;
+const config_1 = require("../domain/config");
 const providers_1 = require("../domain/providers");
 const errors_1 = require("../domain/errors");
+const config_repo_1 = require("../infra/config-repo");
 const fs_utils_1 = require("../infra/fs-utils");
 const providers_repo_1 = require("../infra/providers-repo");
 const run_mutation_1 = require("./run-mutation");
@@ -15,6 +17,22 @@ function addProvider(args) {
     if (providers.providers[args.providerName]) {
         throw (0, errors_1.cliError)("INVALID_IMPORT_FILE", `Provider "${args.providerName}" already exists.`);
     }
+    const document = (0, config_repo_1.readStructuredConfig)(args.configPath);
+    const existingProfile = document.profiles.find((profile) => profile.name === args.profile);
+    if (!existingProfile && !args.createProfile) {
+        throw (0, errors_1.cliError)("PROFILE_NOT_FOUND", `Profile "${args.profile}" does not exist in config.toml.`, {
+            profile: args.profile,
+            provider: args.providerName,
+        });
+    }
+    const upsertProfiles = !existingProfile && args.createProfile
+        ? {
+            [args.profile]: (0, config_1.validateManagedProfileCreation)(args.profile, {
+                model: args.model ?? undefined,
+                baseUrl: args.baseUrl ?? undefined,
+            }),
+        }
+        : undefined;
     const next = {
         providers: {
             ...providers.providers,
@@ -32,13 +50,26 @@ function addProvider(args) {
         backupsDir: args.backupsDir,
         latestBackupPath: args.latestBackupPath,
         operation: "add",
-        files: [{ absolutePath: args.providersPath, relativePath: "providers.json" }],
+        files: [
+            { absolutePath: args.providersPath, relativePath: "providers.json" },
+            { absolutePath: args.configPath, relativePath: "config.toml" },
+        ],
         mutate: () => {
+            const configPlan = (0, config_repo_1.createConfigMutationPlan)(document, {
+                upsertProfiles,
+            });
             // Persist only the normalized provider payload so later reads are deterministic.
             (0, providers_repo_1.writeProvidersFile)(args.providersPath, next);
+            (0, config_repo_1.applyConfigMutation)(args.configPath, document, configPlan);
             return {
                 provider: args.providerName,
                 profile: args.profile,
+                createdProfileSections: configPlan.createdProfileSections,
+                deletedProfileSections: configPlan.deletedProfileSections,
+                keptSharedProfiles: [],
+                switchedActiveProfile: configPlan.switchedActiveProfile,
+                adoptedProfiles: [],
+                repairedProfiles: [],
             };
         },
     });

package/dist/app/edit-provider.js

@@ -2,7 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.editProvider = editProvider;
 const errors_1 = require("../domain/errors");
+const config_1 = require("../domain/config");
 const providers_1 = require("../domain/providers");
+const config_repo_1 = require("../infra/config-repo");
 const fs_utils_1 = require("../infra/fs-utils");
 const providers_repo_1 = require("../infra/providers-repo");
 const run_mutation_1 = require("./run-mutation");
@@ -12,6 +14,7 @@ const run_mutation_1 = require("./run-mutation");
 function editProvider(args) {
     (0, fs_utils_1.ensureDir)(args.codexDir);
     const providers = (0, providers_repo_1.readProvidersFile)(args.providersPath);
+    const document = (0, config_repo_1.readStructuredConfig)(args.configPath);
     const current = providers.providers[args.providerName];
     if (!current) {
         throw (0, errors_1.cliError)("PROVIDER_NOT_FOUND", `Provider "${args.providerName}" was not found.`, {
@@ -42,22 +45,92 @@ function editProvider(args) {
     if (args.tags !== undefined) {
         updatedFields.push("tags");
     }
+    const oldProfile = current.profile;
+    const newProfile = nextRecord.profile;
+    const targetSection = document.profiles.find((profile) => profile.name === newProfile) ?? null;
+    const targetProfileExists = Boolean(targetSection);
+    let upsertProfiles;
+    if (!targetProfileExists) {
+        if (!args.createProfile) {
+            throw (0, errors_1.cliError)("PROFILE_NOT_FOUND", `Profile "${newProfile}" does not exist in config.toml.`, {
+                profile: newProfile,
+                provider: args.providerName,
+            });
+        }
+        upsertProfiles = {
+            [newProfile]: (0, config_1.validateManagedProfileCreation)(newProfile, {
+                model: args.model ?? undefined,
+                baseUrl: args.baseUrl ?? undefined,
+            }),
+        };
+    }
+    else if (args.model !== undefined || args.baseUrl !== undefined) {
+        upsertProfiles = {
+            [newProfile]: {
+                ...(args.model !== undefined && args.model !== null ? { model: args.model } : {}),
+                ...(args.baseUrl !== undefined && args.baseUrl !== null ? { baseUrl: args.baseUrl } : {}),
+            },
+        };
+        if (args.model !== undefined && (targetSection?.model !== args.model) && !updatedFields.includes("model")) {
+            updatedFields.push("model");
+        }
+        if (args.baseUrl !== undefined && targetSection?.baseUrl !== args.baseUrl && !updatedFields.includes("baseUrl")) {
+            updatedFields.push("baseUrl");
+        }
+    }
+    const remainingLinksByProfile = new Map();
+    for (const [name, provider] of Object.entries(providers.providers)) {
+        if (name === args.providerName) {
+            continue;
+        }
+        const list = remainingLinksByProfile.get(provider.profile) ?? [];
+        list.push(name);
+        remainingLinksByProfile.set(provider.profile, list);
+    }
+    if (newProfile !== oldProfile) {
+        const list = remainingLinksByProfile.get(newProfile) ?? [];
+        list.push(args.providerName);
+        remainingLinksByProfile.set(newProfile, list);
+    }
+    const lifecycle = (0, config_1.planProfileLifecycleOutcome)({
+        providerName: args.providerName,
+        oldProfile,
+        newProfile,
+        activeProfile: document.activeProfile,
+        remainingLinksByProfile,
+        switchToProfile: args.switchToProfile ?? null,
+    });
     return (0, run_mutation_1.runMutation)({
         codexDir: args.codexDir,
         backupsDir: args.backupsDir,
         latestBackupPath: args.latestBackupPath,
         operation: "edit",
-        files: [{ absolutePath: args.providersPath, relativePath: "providers.json" }],
+        files: [
+            { absolutePath: args.providersPath, relativePath: "providers.json" },
+            { absolutePath: args.configPath, relativePath: "config.toml" },
+        ],
         mutate: () => {
+            const configPlan = (0, config_repo_1.createConfigMutationPlan)(document, {
+                upsertProfiles,
+                deleteProfiles: lifecycle.deletedProfileSections,
+                setActiveProfile: lifecycle.nextActiveProfile,
+            });
             (0, providers_repo_1.writeProvidersFile)(args.providersPath, {
                 providers: {
                     ...providers.providers,
                     [args.providerName]: nextRecord,
                 },
             });
+            (0, config_repo_1.applyConfigMutation)(args.configPath, document, configPlan);
             return {
                 provider: args.providerName,
                 updatedFields,
+                createdProfileSections: configPlan.createdProfileSections,
+                deletedProfileSections: configPlan.deletedProfileSections,
+                keptSharedProfiles: lifecycle.keptSharedProfiles,
+                switchedActiveProfile: lifecycle.switchedActiveProfile,
+                adoptedProfiles: [],
+                repairedProfiles: [],
             };
         },
     });

package/dist/app/get-status.js

@@ -37,6 +37,7 @@ exports.getStatus = getStatus;
 const fs = __importStar(require("node:fs"));
 const config_1 = require("../domain/config");
 const runtime_state_1 = require("../domain/runtime-state");
+const config_repo_1 = require("../infra/config-repo");
 const providers_repo_1 = require("../infra/providers-repo");
 /**
  * Reports the current on-disk runtime state and how it maps back to managed providers.
@@ -47,9 +48,13 @@ function getStatus(codexDir, configPath, providersPath) {
     let currentProfile = null;
     const warnings = [];
     const providers = providersExists ? (0, providers_repo_1.readProvidersFile)(providersPath) : null;
+    let configViews = [];
+    let consistencyIssues = [];
     if (configExists) {
-        const configContent = fs.readFileSync(configPath, "utf8");
-        currentProfile = (0, config_1.parseTopLevelProfile)(configContent);
+        const document = (0, config_repo_1.readStructuredConfig)(configPath);
+        currentProfile = document.activeProfile;
+        configViews = (0, config_1.buildManagedProfileViews)(document, providers);
+        consistencyIssues = (0, config_1.collectConfigConsistencyIssues)(document, providers);
         if (!currentProfile) {
             warnings.push("config.toml exists but has no top-level profile.");
         }
@@ -70,6 +75,8 @@ function getStatus(codexDir, configPath, providersPath) {
             currentProfileMapped: liveState.profileMapped,
             provider: liveState.mappedProvider,
             liveState,
+            configProfiles: configViews,
+            issues: consistencyIssues,
         },
     };
 }

package/dist/app/import-providers.js

@@ -36,8 +36,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.importProviders = importProviders;
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
+const config_1 = require("../domain/config");
 const providers_1 = require("../domain/providers");
 const errors_1 = require("../domain/errors");
+const config_repo_1 = require("../infra/config-repo");
 const fs_utils_1 = require("../infra/fs-utils");
 const providers_repo_1 = require("../infra/providers-repo");
 const run_mutation_1 = require("./run-mutation");
@@ -58,16 +60,44 @@ function importProviders(args) {
         });
     }
     (0, fs_utils_1.ensureDir)(args.codexDir);
+    const document = (0, config_repo_1.readStructuredConfig)(args.configPath);
     return (0, run_mutation_1.runMutation)({
         codexDir: args.codexDir,
         backupsDir: args.backupsDir,
         latestBackupPath: args.latestBackupPath,
         operation: "import",
-        files: [{ absolutePath: args.providersPath, relativePath: "providers.json" }],
+        files: [
+            { absolutePath: args.providersPath, relativePath: "providers.json" },
+            { absolutePath: args.configPath, relativePath: "config.toml" },
+        ],
         mutate: () => {
             const current = (0, providers_repo_1.readProvidersFileIfExists)(args.providersPath);
             const next = args.merge ? (0, providers_repo_1.mergeProviders)(current, imported) : imported;
+            const currentViews = (0, config_1.buildManagedProfileViews)(document, current);
+            const nextViews = (0, config_1.buildManagedProfileViews)(document, next);
+            const adoptedProfiles = currentViews
+                .filter((view) => view.source === "unmanaged" && view.linkedProviders.length === 0)
+                .filter((view) => nextViews.some((nextView) => nextView.name === view.name && nextView.managed))
+                .map((view) => view.name)
+                .sort();
+            const missingViews = nextViews.filter((view) => view.source === "orphaned-reference");
+            const repairedProfiles = [];
+            const upsertProfiles = missingViews.reduce((accumulator, view) => {
+                const repair = args.repairProfiles?.[view.name];
+                if (!repair) {
+                    throw (0, errors_1.cliError)("MANAGED_PROFILE_FIELDS_MISSING", "Import would create provider references to missing config profiles that need model and base_url.", {
+                        profilesNeedingRepair: missingViews.map((entry) => entry.name).sort(),
+                    });
+                }
+                accumulator[view.name] = (0, config_1.validateManagedProfileCreation)(view.name, repair);
+                repairedProfiles.push(view.name);
+                return accumulator;
+            }, {});
+            const configPlan = (0, config_repo_1.createConfigMutationPlan)(document, {
+                upsertProfiles,
+            });
             (0, providers_repo_1.writeProvidersFile)(args.providersPath, next);
+            (0, config_repo_1.applyConfigMutation)(args.configPath, document, configPlan);
             const replacedProviders = args.merge
                 ? Object.keys(imported.providers).filter((name) => current.providers[name]).sort()
                 : [];
@@ -77,6 +107,12 @@ function importProviders(args) {
                 importedCount: Object.keys(imported.providers).length,
                 mergedCount: Object.keys(next.providers).length,
                 replacedProviders,
+                createdProfileSections: configPlan.createdProfileSections,
+                deletedProfileSections: [],
+                keptSharedProfiles: nextViews.filter((view) => view.linkedProviders.length > 1).map((view) => view.name),
+                switchedActiveProfile: false,
+                adoptedProfiles,
+                repairedProfiles: repairedProfiles.sort(),
             };
         },
     });

package/dist/app/list-config-profiles.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listConfigProfilesView = listConfigProfilesView;
+const config_1 = require("../domain/config");
+const config_repo_1 = require("../infra/config-repo");
+const providers_repo_1 = require("../infra/providers-repo");
+/**
+ * Returns the lightweight config profile listing.
+ */
+function listConfigProfilesView(args) {
+    const document = (0, config_repo_1.readStructuredConfig)(args.configPath);
+    const providers = (0, providers_repo_1.readProvidersFileIfExists)(args.providersPath);
+    const profiles = (0, config_1.buildManagedProfileViews)(document, providers).map((profile) => ({
+        name: profile.name,
+        managed: profile.managed,
+        isActive: profile.isActive,
+        linkedProviders: profile.linkedProviders,
+        model: profile.model,
+        baseUrl: profile.baseUrl,
+        source: profile.source,
+    }));
+    return {
+        data: {
+            activeProfile: document.activeProfile,
+            profiles,
+            count: profiles.length,
+        },
+    };
+}

package/dist/app/remove-provider.js

@@ -2,6 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.removeProvider = removeProvider;
 const errors_1 = require("../domain/errors");
+const config_1 = require("../domain/config");
+const config_repo_1 = require("../infra/config-repo");
 const providers_repo_1 = require("../infra/providers-repo");
 const run_mutation_1 = require("./run-mutation");
 /**
@@ -9,22 +11,52 @@ const run_mutation_1 = require("./run-mutation");
  */
 function removeProvider(args) {
     const providers = (0, providers_repo_1.readProvidersFile)(args.providersPath);
-    if (!providers.providers[args.providerName]) {
+    const document = (0, config_repo_1.readStructuredConfig)(args.configPath);
+    const current = providers.providers[args.providerName];
+    if (!current) {
         throw (0, errors_1.cliError)("PROVIDER_NOT_FOUND", `Provider "${args.providerName}" was not found.`);
     }
     const nextProviders = { ...providers.providers };
     // Delete against a copied object so the original parsed state stays untouched.
     delete nextProviders[args.providerName];
+    const remainingLinksByProfile = new Map();
+    for (const [name, provider] of Object.entries(nextProviders)) {
+        const list = remainingLinksByProfile.get(provider.profile) ?? [];
+        list.push(name);
+        remainingLinksByProfile.set(provider.profile, list);
+    }
+    const lifecycle = (0, config_1.planProfileLifecycleOutcome)({
+        providerName: args.providerName,
+        oldProfile: current.profile,
+        newProfile: null,
+        activeProfile: document.activeProfile,
+        remainingLinksByProfile,
+        switchToProfile: args.switchToProfile ?? null,
+    });
     return (0, run_mutation_1.runMutation)({
         codexDir: args.codexDir,
         backupsDir: args.backupsDir,
         latestBackupPath: args.latestBackupPath,
         operation: "remove",
-        files: [{ absolutePath: args.providersPath, relativePath: "providers.json" }],
+        files: [
+            { absolutePath: args.providersPath, relativePath: "providers.json" },
+            { absolutePath: args.configPath, relativePath: "config.toml" },
+        ],
         mutate: () => {
+            const configPlan = (0, config_repo_1.createConfigMutationPlan)(document, {
+                deleteProfiles: lifecycle.deletedProfileSections,
+                setActiveProfile: lifecycle.nextActiveProfile,
+            });
             (0, providers_repo_1.writeProvidersFile)(args.providersPath, { providers: nextProviders });
+            (0, config_repo_1.applyConfigMutation)(args.configPath, document, configPlan);
             return {
                 provider: args.providerName,
+                createdProfileSections: configPlan.createdProfileSections,
+                deletedProfileSections: configPlan.deletedProfileSections,
+                keptSharedProfiles: lifecycle.keptSharedProfiles,
+                switchedActiveProfile: lifecycle.switchedActiveProfile,
+                adoptedProfiles: [],
+                repairedProfiles: [],
             };
         },
     });

package/dist/app/run-doctor.js

@@ -38,6 +38,7 @@ const fs = __importStar(require("node:fs"));
 const config_1 = require("../domain/config");
 const runtime_state_1 = require("../domain/runtime-state");
 const codex_cli_1 = require("../infra/codex-cli");
+const config_repo_1 = require("../infra/config-repo");
 const providers_repo_1 = require("../infra/providers-repo");
 const errors_1 = require("../domain/errors");
 /**
@@ -45,9 +46,9 @@ const errors_1 = require("../domain/errors");
  */
 function runDoctor(args) {
     const issues = [];
-    let configProfiles = new Set();
     let currentProfile = null;
     let providers = null;
+    let document = null;
     if (!fs.existsSync(args.configPath)) {
         issues.push({
             code: "CONFIG_NOT_FOUND",
@@ -56,9 +57,8 @@ function runDoctor(args) {
         });
     }
     else {
-        const configContent = fs.readFileSync(args.configPath, "utf8");
-        configProfiles = (0, config_1.parseProfileNames)(configContent);
-        currentProfile = (0, config_1.parseTopLevelProfile)(configContent);
+        document = (0, config_repo_1.readStructuredConfig)(args.configPath);
+        currentProfile = document.activeProfile;
         if (!currentProfile) {
             issues.push({
                 code: "PROFILE_NOT_FOUND",
@@ -77,14 +77,11 @@ function runDoctor(args) {
     else {
         try {
             providers = (0, providers_repo_1.readProvidersFile)(args.providersPath);
-            // Every managed provider must map to a profile that still exists in config.toml.
-            for (const [name, provider] of Object.entries(providers.providers)) {
-                if (!configProfiles.has(provider.profile)) {
+            if (document) {
+                for (const issue of (0, config_1.collectConfigConsistencyIssues)(document, providers)) {
                     issues.push({
-                        code: "PROFILE_NOT_FOUND",
-                        message: `Provider "${name}" maps to missing profile "${provider.profile}".`,
-                        provider: name,
-                        profile: provider.profile,
+                        ...issue,
+                        message: renderConfigIssueMessage(issue),
                     });
                 }
             }
@@ -99,16 +96,6 @@ function runDoctor(args) {
         }
     }
     const drift = (0, runtime_state_1.inspectLiveStateDrift)(currentProfile, providers);
-    if (drift.canBackfillActiveProvider) {
-        // Distinguish unmanaged live state from hard parse/configuration errors.
-        issues.push({
-            code: "LIVE_STATE_DRIFT",
-            message: `Active profile "${drift.currentProfile}" is present in config.toml but not mapped by providers.json.`,
-            currentProfile: drift.currentProfile,
-            suggestedAction: "backfill-active-provider",
-            storage: (0, runtime_state_1.getStorageRoles)(),
-        });
-    }
     const codexCheck = (0, codex_cli_1.checkCodexAvailable)();
     if (!codexCheck.ok) {
         issues.push({
@@ -128,3 +115,17 @@ function runDoctor(args) {
         warnings: issues.length === 0 ? [] : [`doctor found ${issues.length} issue(s)`],
     };
 }
+function renderConfigIssueMessage(issue) {
+    switch (issue.code) {
+        case "ORPHANED_PROFILE_REFERENCE":
+            return `Profile "${issue.profile}" is referenced by providers but missing from config.toml.`;
+        case "UNMANAGED_ACTIVE_PROFILE":
+            return `Active profile "${issue.profile}" is not mapped by providers.json.`;
+        case "SHARED_PROFILE_REFERENCE":
+            return `Profile "${issue.profile}" is shared by multiple providers.`;
+        case "ORPHANED_PROFILE_SECTION":
+            return `Profile section "${issue.profile}" is not linked to any provider.`;
+        case "DESTRUCTIVE_REMOVE_BLOCKED":
+            return `Provider "${issue.provider}" cannot be removed while "${issue.activeProfile}" remains active.`;
+    }
+}

package/dist/app/setup-codex.js

@@ -37,7 +37,7 @@ exports.setupCodex = setupCodex;
 const fs = __importStar(require("node:fs"));
 const setup_1 = require("../domain/setup");
 const errors_1 = require("../domain/errors");
-const codex_discovery_1 = require("../infra/codex-discovery");
+const config_1 = require("../domain/config");
 const codex_cli_1 = require("../infra/codex-cli");
 const config_repo_1 = require("../infra/config-repo");
 const fs_utils_1 = require("../infra/fs-utils");
@@ -63,29 +63,35 @@ function setupCodex(args) {
             cause: version.cause,
         });
     }
-    const candidates = (0, codex_discovery_1.findCodexDirCandidates)(args.codexDirOption);
-    if (candidates.length === 0) {
-        throw (0, errors_1.cliError)("CODEX_DIR_NOT_FOUND", "No Codex directory could be found.", {
-            codexDir: args.codexDir,
-        });
-    }
-    if (candidates.length > 1) {
-        throw (0, errors_1.cliError)("CODEX_DIR_AMBIGUOUS", "Multiple Codex directories were found.", {
-            candidates,
-        });
-    }
     if (!fs.existsSync(args.codexDir)) {
         throw (0, errors_1.cliError)("CODEX_DIR_NOT_FOUND", "The requested Codex directory does not exist.", {
             codexDir: args.codexDir,
         });
     }
-    const profiles = Array.from((0, config_repo_1.listConfigProfiles)(args.configPath)).sort();
-    if (profiles.length === 0) {
+    const document = (0, config_repo_1.readStructuredConfig)(args.configPath);
+    const profileViews = (0, config_1.buildManagedProfileViews)(document, null);
+    const adoptableProfiles = profileViews
+        .filter((view) => view.source === "unmanaged" && view.model && view.baseUrl)
+        .map((view) => view.name)
+        .sort();
+    if (profileViews.length === 0) {
         throw (0, errors_1.cliError)("PROFILE_NOT_FOUND", "No profiles were found in config.toml.", {
             file: args.configPath,
         });
     }
-    const drafts = (0, setup_1.buildSetupDrafts)(profiles, args.providerDetailsByProfile);
+    const invalidAdoptProfiles = args.adoptProfiles.filter((profile) => !adoptableProfiles.includes(profile));
+    if (invalidAdoptProfiles.length > 0) {
+        throw (0, errors_1.cliError)("INVALID_ARGUMENT", "setup only adopts unmanaged profiles that already contain model and base_url.", {
+            invalidProfiles: invalidAdoptProfiles.sort(),
+            adoptableProfiles,
+        });
+    }
+    if (args.adoptProfiles.length === 0) {
+        throw (0, errors_1.cliError)("INVALID_ARGUMENT", "setup requires at least one explicit profile to adopt.", {
+            adoptableProfiles,
+        });
+    }
+    const drafts = (0, setup_1.buildSetupDrafts)(args.adoptProfiles, args.providerDetailsByProfile);
     const incompleteProfiles = (0, setup_1.findIncompleteSetupProfiles)(drafts);
     if (incompleteProfiles.length > 0) {
         throw (0, errors_1.cliError)("INVALID_ARGUMENT", "setup requires complete provider data for every selected profile.", {
@@ -112,14 +118,25 @@ function setupCodex(args) {
         backupsDir: args.backupsDir,
         latestBackupPath: args.latestBackupPath,
         operation: "setup",
-        files: [{ absolutePath: args.providersPath, relativePath: "providers.json" }],
+        files: [
+            { absolutePath: args.providersPath, relativePath: "providers.json" },
+            { absolutePath: args.configPath, relativePath: "config.toml" },
+        ],
         mutate: () => {
+            const configPlan = (0, config_repo_1.createConfigMutationPlan)(document, {});
             (0, providers_repo_1.writeProvidersFile)(args.providersPath, finalProviders);
+            (0, config_repo_1.applyConfigMutation)(args.configPath, document, configPlan);
             return {
                 codexDir: args.codexDir,
                 strategy: args.strategy,
                 providersInitialized: Object.keys(nextProviders.providers).length,
                 providerNames: Object.keys(finalProviders.providers).sort(),
+                createdProfileSections: configPlan.createdProfileSections,
+                deletedProfileSections: configPlan.deletedProfileSections,
+                keptSharedProfiles: [],
+                switchedActiveProfile: false,
+                adoptedProfiles: [...args.adoptProfiles].sort(),
+                repairedProfiles: [],
             };
         },
     });

package/dist/app/show-config.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.showConfig = showConfig;
+const config_1 = require("../domain/config");
+const errors_1 = require("../domain/errors");
+const config_repo_1 = require("../infra/config-repo");
+const providers_repo_1 = require("../infra/providers-repo");
+/**
+ * Returns the structured config view, optionally filtered to one profile.
+ */
+function showConfig(args) {
+    const document = (0, config_repo_1.readStructuredConfig)(args.configPath);
+    const providers = (0, providers_repo_1.readProvidersFileIfExists)(args.providersPath);
+    const views = (0, config_1.buildManagedProfileViews)(document, providers);
+    let selectedProfile = null;
+    let profiles = views;
+    if (args.profileName) {
+        const found = views.find((view) => view.name === args.profileName);
+        if (!found) {
+            throw (0, errors_1.cliError)("PROFILE_NOT_FOUND", `Profile "${args.profileName}" was not found.`, {
+                profile: args.profileName,
+            });
+        }
+        selectedProfile = args.profileName;
+        profiles = [found];
+    }
+    return {
+        data: {
+            activeProfile: document.activeProfile,
+            selectedProfile,
+            profiles,
+        },
+    };
+}

package/dist/app/switch-provider.js

@@ -17,7 +17,7 @@ function switchProvider(args) {
             availableProviders: Object.keys(providers.providers).sort(),
         });
     }
-    const configContent = (0, config_repo_1.ensureProfileExists)(args.configPath, provider.profile, args.providerName);
+    const document = (0, config_repo_1.ensureProfileExists)(args.configPath, provider.profile, args.providerName);
     return (0, run_mutation_1.runMutation)({
         codexDir: args.codexDir,
         backupsDir: args.backupsDir,
@@ -28,8 +28,11 @@ function switchProvider(args) {
             { absolutePath: args.authPath, relativePath: "auth.json" },
         ],
         mutate: () => {
+            const configPlan = (0, config_repo_1.createConfigMutationPlan)(document, {
+                setActiveProfile: provider.profile,
+            });
             // Update the runtime profile first so any subsequent login is associated with the new target.
-            (0, config_repo_1.updateTopLevelProfile)(args.configPath, configContent, provider.profile);
+            (0, config_repo_1.applyConfigMutation)(args.configPath, document, configPlan);
             if (!args.noLogin) {
                 (0, codex_cli_1.runCodexLogin)(provider.apiKey, args.codexDir);
             }

package/dist/cli/args.js

@@ -11,6 +11,7 @@ const codex_paths_1 = require("../infra/codex-paths");
 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];
@@ -24,6 +25,7 @@ function parseArgs(argv) {
                 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;
         }
@@ -37,6 +39,7 @@ function parseArgs(argv) {
             globalOptions: {
                 json,
                 codexDir,
+                codexDirExplicit,
             },
             commandOptions: new Map(),
             helpRequested: true,
@@ -53,11 +56,17 @@ function parseArgs(argv) {
         });
     }
     const commandToken = remaining[0] ?? null;
-    const command = commandToken === "backups" && remaining[1] === "list" ? "backups-list" : commandToken;
+    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" ? 2 : 1;
+    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") {
@@ -86,6 +95,7 @@ function parseArgs(argv) {
         globalOptions: {
             json,
             codexDir,
+            codexDirExplicit,
         },
         commandOptions,
         helpRequested,
@@ -103,6 +113,7 @@ function defaultParsed(command, overrides) {
         globalOptions: {
             json: overrides?.json ?? false,
             codexDir: overrides?.codexDir ?? (0, codex_paths_1.resolveCodexDir)(),
+            codexDirExplicit: false,
         },
         commandOptions: new Map(),
         helpRequested: overrides?.helpRequested ?? false,