@minniexcode/codex-switch 0.0.11 → 0.0.12

package/dist/commands/help.js

@@ -30,6 +30,10 @@ function buildHelpText(commandName) {
             "codex-switch",
             "",
             "Manage and switch local Codex provider/profile configuration safely.",
+            "Primary workflows: direct providers use init -> add -> switch -> status -> doctor.",
+            "Primary workflows: Copilot providers use init -> login copilot -> add --copilot -> switch -> status -> doctor.",
+            "Advanced adopt flows use migrate only when you already have Codex runtime state to import.",
+            "Deprecated entry: setup still exists only to point callers to init or migrate.",
             "",
             "Usage:",
             "  codexs <command> [options]",
@@ -61,14 +65,14 @@ function buildHelpText(commandName) {
             "",
             "Examples:",
             "  codexs init",
+            "  codexs add packycode --profile packycode --api-key sk-xxx",
+            "  codexs switch packycode",
+            "  codexs status",
+            "  codexs doctor",
             "  codexs login copilot",
+            "  codexs add copilot-main --copilot --profile copilot-main",
             "  codexs migrate",
-            "  codexs list",
-            "  codexs switch",
-            "  codexs bridge start",
-            "  codexs add packycode --profile packycode --api-key sk-xxx",
             "  codexs config show",
-            "  codexs remove freemodel",
             "  codexs backups list",
             "  codexs rollback",
             "  codexs help add",

package/dist/commands/registry.js

@@ -88,13 +88,14 @@ exports.COMMANDS = [
         tokens: ["init"],
         handler: handlers_1.handleRegisteredCommand,
         group: "write",
-        summary: "Initialize the codex-switch tool home and registry files.",
+        summary: "Initialize the codex-switch tool home for the primary workflow.",
         usage: ["codexs init [--json] [--codex-dir <path>]"],
         details: [
             "Creates codex-switch.json and providers.json under the tool home when they do not exist yet.",
             "Does not create or validate config.toml, auth.json, or the target Codex directory.",
             "When --codex-dir is passed explicitly and codex-switch.json does not exist yet, init persists it as defaultCodexDir.",
             "Otherwise init stays scoped to tool-home state and does not persist fallback Codex directory resolution.",
+            "Use init first for fresh direct-provider or Copilot setups.",
         ],
         examples: ["codexs init", "codexs init --json --codex-dir ~/.codex"],
     },
@@ -119,13 +120,14 @@ exports.COMMANDS = [
         tokens: ["migrate"],
         handler: handlers_1.handleRegisteredCommand,
         group: "write",
-        summary: "Adopt unmanaged Codex config profiles into providers.json.",
+        summary: "Adopt existing Codex runtime profiles into managed providers.json state.",
         usage: ["codexs migrate [--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.",
             "Migrate adopts only runtime profiles that already expose model, model_provider, and matching base_url.",
             "Non-TTY and --json runs still fail fast because migrate profile selection and provider details remain interactive in this release.",
+            "Treat migrate as an advanced adopt helper for existing runtime state, not the default first step for fresh installs.",
         ],
         examples: ["codexs migrate", "codexs migrate --overwrite --json --codex-dir ~/.codex"],
     },
@@ -134,12 +136,12 @@ exports.COMMANDS = [
         tokens: ["setup"],
         handler: handlers_1.handleRegisteredCommand,
         group: "write",
-        summary: "Deprecated. Use init or migrate instead.",
+        summary: "Deprecated. Kept only to point callers to init or migrate.",
         usage: ["codexs setup"],
         details: [
             "setup no longer performs initialization or migration work.",
-            "Use init for AI-friendly idempotent providers.json initialization.",
-            "Use migrate for interactive adoption from existing config.toml profiles.",
+            "Use init for the primary fresh-install workflow.",
+            "Use migrate only when adopting from existing config.toml profiles.",
         ],
         examples: ["codexs help init", "codexs help migrate"],
     },
@@ -182,12 +184,12 @@ exports.COMMANDS = [
         tokens: ["status"],
         handler: handlers_1.handleRegisteredCommand,
         group: "read",
-        summary: "Show a quick status summary for the local Codex directory.",
+        summary: "Show tool-home, target-runtime, provider, and runtime-health status.",
         usage: ["codexs status [--json] [--codex-dir <path>]"],
         details: [
-            "Reports file presence, current profile, and whether the live profile is mapped.",
-            "When the active provider uses a local runtime bridge, status also reports bridge and SDK state.",
-            "Surfaces config consistency signals without mutating any files.",
+            "Reports the target Codex runtime, tool-home storage roles, current profile, and whether the live profile is mapped.",
+            "When the active provider uses a local runtime bridge, status also reports bridge, Copilot SDK, and upstream auth state.",
+            "Surfaces dual-path config consistency signals without mutating any files.",
             "Use doctor for deeper diagnostics.",
         ],
         examples: ["codexs status", "codexs status --json --codex-dir ./.tmp-codex"],
@@ -216,7 +218,7 @@ exports.COMMANDS = [
         tokens: ["add"],
         handler: handlers_1.handleRegisteredCommand,
         group: "write",
-        summary: "Add a provider with explicit flags or progressive TTY prompts.",
+        summary: "Add a managed provider for the primary direct or Copilot workflows.",
         usage: [
             "codexs add <provider> --profile <name> --api-key <key> [--base-url <url>] [--note <text>] [--tag <tag> ...]",
             "codexs add <provider> --copilot --profile <name> [--bridge-host <host>] [--bridge-port <port>] [--bridge-api-key <secret>] [--install-copilot-sdk]",
@@ -247,7 +249,7 @@ exports.COMMANDS = [
         tokens: ["switch"],
         handler: handlers_1.handleRegisteredCommand,
         group: "write",
-        summary: "Switch the active config profile to a provider.",
+        summary: "Switch the active runtime to a managed provider.",
         usage: ["codexs switch <provider> [--json] [--codex-dir <path>]"],
         details: [
             "When <provider> is omitted in a TTY, an interactive provider selector is shown.",
@@ -255,6 +257,7 @@ exports.COMMANDS = [
             "Direct providers update the active config profile and rewrite auth.json with auth_mode=apikey plus OPENAI_API_KEY.",
             "Copilot bridge providers also rewrite OPENAI_API_KEY to the local bridge secret while managing runtime routing and bridge state.",
             "Copilot bridge providers probe the optional official SDK before switching and fail fast if it is missing.",
+            "Switch succeeds only after the managed profile projection is written to the target runtime.",
             "Backs up config.toml and auth.json and rolls back on failure.",
         ],
         examples: ["codexs switch freemodel", "codexs switch packycode --json"],
@@ -321,7 +324,7 @@ exports.COMMANDS = [
         tokens: ["doctor"],
         handler: handlers_1.handleRegisteredCommand,
         group: "recovery",
-        summary: "Run configuration and environment diagnostics.",
+        summary: "Run repair-oriented diagnostics across tool-home and target-runtime state.",
         usage: ["codexs doctor [--json] [--codex-dir <path>]"],
         details: [
             "Checks the expected config files, provider/profile consistency, and Codex CLI availability.",

package/dist/domain/runtime-state.js

@@ -97,7 +97,9 @@ function inspectLiveStateDrift(currentProfile, providers) {
         return {
             currentProfile,
             mappedProvider: null,
+            mappedProviders: [],
             profileMapped: false,
+            providerResolvable: false,
             canBackfillActiveProvider: false,
             reason: providers ? "profile-missing" : "config-missing",
         };
@@ -106,27 +108,47 @@ function inspectLiveStateDrift(currentProfile, providers) {
         return {
             currentProfile,
             mappedProvider: null,
+            mappedProviders: [],
             profileMapped: false,
+            providerResolvable: false,
             canBackfillActiveProvider: false,
             reason: "providers-missing",
         };
     }
+    const mappedProviders = [];
     for (const [name, provider] of Object.entries(providers.providers)) {
-        // A direct profile match means the runtime state is still managed.
         if (provider.profile === currentProfile) {
-            return {
-                currentProfile,
-                mappedProvider: name,
-                profileMapped: true,
-                canBackfillActiveProvider: false,
-                reason: "ok",
-            };
+            mappedProviders.push(name);
         }
     }
+    if (mappedProviders.length === 1) {
+        return {
+            currentProfile,
+            mappedProvider: mappedProviders[0],
+            mappedProviders,
+            profileMapped: true,
+            providerResolvable: true,
+            canBackfillActiveProvider: false,
+            reason: "ok",
+        };
+    }
+    if (mappedProviders.length > 1) {
+        return {
+            currentProfile,
+            mappedProvider: null,
+            mappedProviders,
+            profileMapped: true,
+            providerResolvable: false,
+            canBackfillActiveProvider: false,
+            reason: "shared-profile",
+        };
+    }
     return {
         currentProfile,
         mappedProvider: null,
+        mappedProviders: [],
         profileMapped: false,
+        providerResolvable: false,
         canBackfillActiveProvider: true,
         reason: "provider-unmapped",
     };

package/dist/infra/config-repo.js

@@ -1,208 +1,18 @@
 "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.readConfigFile = readConfigFile;
-exports.readStructuredConfig = readStructuredConfig;
-exports.readCurrentProfile = readCurrentProfile;
-exports.listConfigProfiles = listConfigProfiles;
-exports.ensureProfileExists = ensureProfileExists;
-exports.requireManagedProfileRuntime = requireManagedProfileRuntime;
-exports.requireModelProviderRuntimeSection = requireModelProviderRuntimeSection;
-exports.updateTopLevelProfile = updateTopLevelProfile;
-exports.createConfigMutationPlan = createConfigMutationPlan;
-exports.applyConfigMutation = applyConfigMutation;
-exports.findCodexDirCandidates = findCodexDirCandidates;
-const fs = __importStar(require("node:fs"));
-const os = __importStar(require("node:os"));
-const path = __importStar(require("node:path"));
-const config_1 = require("../domain/config");
-const errors_1 = require("../domain/errors");
-const codex_paths_1 = require("./codex-paths");
-const fs_utils_1 = require("./fs-utils");
-/**
- * Reads config.toml and throws a typed error when the file is missing.
- */
-function readConfigFile(configPath) {
-    return (0, fs_utils_1.readRequiredFile)(configPath, "CONFIG_NOT_FOUND", "config.toml");
-}
-/**
- * Reads and parses config.toml into the managed structured document shape.
- */
-function readStructuredConfig(configPath) {
-    const content = readConfigFile(configPath);
-    try {
-        return (0, config_1.parseStructuredConfig)(content);
-    }
-    catch (error) {
-        throw (0, errors_1.cliError)("CONFIG_PARSE_ERROR", "Failed to parse config.toml.", {
-            file: configPath,
-            cause: (0, errors_1.normalizeError)(error).message,
-        });
-    }
-}
-/**
- * Reads the active top-level profile from config.toml.
- */
-function readCurrentProfile(configPath) {
-    const profile = readStructuredConfig(configPath).activeProfile ?? (0, config_1.parseTopLevelProfile)(readConfigFile(configPath));
-    if (!profile) {
-        throw (0, errors_1.cliError)("PROFILE_NOT_FOUND", "No top-level profile is set in config.toml.", {
-            file: configPath,
-        });
-    }
-    return profile;
-}
-/**
- * Lists all named profile sections declared in config.toml.
- */
-function listConfigProfiles(configPath) {
-    return new Set(readStructuredConfig(configPath).profiles.map((profile) => profile.name));
-}
-/**
- * Verifies that a provider's target profile exists before a switch operation proceeds.
- */
-function ensureProfileExists(configPath, profile, provider) {
-    const document = readStructuredConfig(configPath);
-    if (!document.profiles.some((entry) => entry.name === profile)) {
-        throw (0, errors_1.cliError)("PROFILE_NOT_FOUND", `Profile "${profile}" does not exist in config.toml.`, {
-            file: configPath,
-            provider,
-            profile,
-        });
-    }
-    return document;
-}
-/**
- * Resolves one profile view and enforces the managed model_provider contract.
- */
-function requireManagedProfileRuntime(document, providers, profile) {
-    const view = (0, config_1.buildManagedProfileViews)(document, providers).find((entry) => entry.name === profile);
-    if (!view) {
-        throw (0, errors_1.cliError)("PROFILE_NOT_FOUND", `Profile "${profile}" does not exist in config.toml.`, {
-            profile,
-        });
-    }
-    if (!view.modelProvider) {
-        throw (0, errors_1.cliError)("MANAGED_PROFILE_FIELDS_MISSING", `Managed profile "${profile}" requires model_provider.`, {
-            profile,
-            missingFields: ["model_provider"],
-        });
-    }
-    if (view.modelProvider !== profile) {
-        throw (0, errors_1.cliError)("INVALID_ARGUMENT", `Managed profile "${profile}" must use the same model_provider name.`, {
-            profile,
-            modelProvider: view.modelProvider,
-        });
-    }
-    const modelProviderSection = document.modelProviders.find((entry) => entry.name === view.modelProvider);
-    if (!modelProviderSection) {
-        throw (0, errors_1.cliError)("PROFILE_NOT_FOUND", `Model provider "${view.modelProvider}" does not exist in config.toml.`, {
-            profile,
-            modelProvider: view.modelProvider,
-        });
-    }
-    if (!modelProviderSection.baseUrl) {
-        throw (0, errors_1.cliError)("MANAGED_PROFILE_FIELDS_MISSING", `Model provider "${view.modelProvider}" requires base_url.`, {
-            profile,
-            modelProvider: view.modelProvider,
-            missingFields: ["base_url"],
-        });
-    }
-    return view;
-}
-/**
- * Verifies that a same-named model_provider runtime section exists and has base_url.
- */
-function requireModelProviderRuntimeSection(document, profile) {
-    const modelProviderSection = document.modelProviders.find((entry) => entry.name === profile);
-    if (!modelProviderSection) {
-        throw (0, errors_1.cliError)("PROFILE_NOT_FOUND", `Model provider "${profile}" does not exist in config.toml.`, {
-            profile,
-            modelProvider: profile,
-        });
-    }
-    if (!modelProviderSection.baseUrl) {
-        throw (0, errors_1.cliError)("MANAGED_PROFILE_FIELDS_MISSING", `Model provider "${profile}" requires base_url.`, {
-            profile,
-            modelProvider: profile,
-            missingFields: ["base_url"],
-        });
-    }
-}
-/**
- * Rewrites config.toml so the requested profile becomes the active top-level profile.
- */
-function updateTopLevelProfile(configPath, configContent, profile) {
-    (0, fs_utils_1.writeTextFileAtomic)(configPath, (0, config_1.applyPatchOperations)(configContent, (0, config_1.planConfigMutation)((0, config_1.parseStructuredConfig)(configContent), {
-        setActiveProfile: profile,
-    }).operations));
-}
-/**
- * Exposes the config mutation planner to application services.
- */
-function createConfigMutationPlan(document, args) {
-    return (0, config_1.planConfigMutation)(document, args);
-}
-/**
- * Applies a previously generated mutation plan to config.toml in one write.
- */
-function applyConfigMutation(configPath, document, plan) {
-    (0, fs_utils_1.writeTextFileAtomic)(configPath, (0, config_1.applyPatchOperations)(document.rawText, plan.operations));
-}
-/**
- * Finds candidate Codex directories in a stable, non-recursive order.
- */
-function findCodexDirCandidates(explicitCodexDir) {
-    if (explicitCodexDir) {
-        return [(0, codex_paths_1.resolveCodexDir)(explicitCodexDir)];
-    }
-    const candidates = new Set();
-    const ordered = [];
-    const envCandidate = process.env[codex_paths_1.CODEX_DIR_ENV_NAME];
-    if (envCandidate) {
-        ordered.push((0, codex_paths_1.resolveCodexDir)(envCandidate));
-    }
-    if (process.env.NODE_ENV === "development") {
-        ordered.push(path.resolve(process.cwd(), "dev-codex", "local-sandbox"));
-    }
-    ordered.push(path.join(os.homedir(), ".codex"));
-    for (const candidate of ordered) {
-        if (!candidate || candidates.has(candidate) || !fs.existsSync(candidate)) {
-            continue;
-        }
-        candidates.add(candidate);
-    }
-    return [...candidates];
-}
+exports.updateTopLevelProfile = exports.requireModelProviderRuntimeSection = exports.requireManagedProfileRuntime = exports.readStructuredConfig = exports.readCurrentProfile = exports.readConfigFile = exports.listConfigProfiles = exports.findCodexDirCandidates = exports.ensureProfileExists = exports.createConfigMutationPlan = exports.applyConfigMutation = void 0;
+/**
+ * Compatibility facade that re-exports config repository helpers from storage.
+ */
+var config_repo_1 = require("../storage/config-repo");
+Object.defineProperty(exports, "applyConfigMutation", { enumerable: true, get: function () { return config_repo_1.applyConfigMutation; } });
+Object.defineProperty(exports, "createConfigMutationPlan", { enumerable: true, get: function () { return config_repo_1.createConfigMutationPlan; } });
+Object.defineProperty(exports, "ensureProfileExists", { enumerable: true, get: function () { return config_repo_1.ensureProfileExists; } });
+Object.defineProperty(exports, "findCodexDirCandidates", { enumerable: true, get: function () { return config_repo_1.findCodexDirCandidates; } });
+Object.defineProperty(exports, "listConfigProfiles", { enumerable: true, get: function () { return config_repo_1.listConfigProfiles; } });
+Object.defineProperty(exports, "readConfigFile", { enumerable: true, get: function () { return config_repo_1.readConfigFile; } });
+Object.defineProperty(exports, "readCurrentProfile", { enumerable: true, get: function () { return config_repo_1.readCurrentProfile; } });
+Object.defineProperty(exports, "readStructuredConfig", { enumerable: true, get: function () { return config_repo_1.readStructuredConfig; } });
+Object.defineProperty(exports, "requireManagedProfileRuntime", { enumerable: true, get: function () { return config_repo_1.requireManagedProfileRuntime; } });
+Object.defineProperty(exports, "requireModelProviderRuntimeSection", { enumerable: true, get: function () { return config_repo_1.requireModelProviderRuntimeSection; } });
+Object.defineProperty(exports, "updateTopLevelProfile", { enumerable: true, get: function () { return config_repo_1.updateTopLevelProfile; } });

package/dist/interaction/interactive.js

@@ -52,7 +52,10 @@ 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 providers_1 = require("../domain/providers");
+const runtime_state_1 = require("../domain/runtime-state");
 const codex_paths_1 = require("../storage/codex-paths");
+const config_repo_1 = require("../storage/config-repo");
 const providers_repo_1 = require("../storage/providers-repo");
 const backup_repo_1 = require("../storage/backup-repo");
 const add_interactive_1 = require("./add-interactive");
@@ -65,15 +68,22 @@ function canPrompt(runtime, jsonMode) {
 /**
  * Prompts the user to choose one configured provider when a command omitted its target.
  */
-async function promptForProviderSelection(runtime, providersPath, message) {
+async function promptForProviderSelection(runtime, providersPath, configPath, message) {
     const providers = (0, providers_repo_1.readProvidersFile)(providersPath);
+    const currentProfile = fs.existsSync(configPath) ? (0, config_repo_1.readStructuredConfig)(configPath).activeProfile : null;
+    const liveState = (0, runtime_state_1.inspectLiveStateDrift)(currentProfile, providers);
     const choices = Object.entries(providers.providers)
         .sort(([left], [right]) => left.localeCompare(right))
-        .map(([providerName, provider]) => ({
-        value: providerName,
-        label: providerName,
-        hint: provider.profile,
-    }));
+        .map(([providerName, provider]) => {
+        const providerType = (0, providers_1.isCopilotBridgeProvider)(provider) ? "copilot" : "direct";
+        const currentMarker = liveState.providerResolvable && liveState.mappedProvider === providerName ? " | current" : "";
+        const ambiguousMarker = !liveState.providerResolvable && liveState.mappedProviders.includes(providerName) ? " | current=ambiguous" : "";
+        return {
+            value: providerName,
+            label: providerName,
+            hint: `profile=${provider.profile} | type=${providerType}${currentMarker}${ambiguousMarker}`,
+        };
+    });
     if (choices.length === 0) {
         throw (0, errors_1.cliError)("PROVIDER_NOT_FOUND", "No providers are configured.");
     }

package/dist/runtime/copilot-bridge.js

@@ -221,7 +221,8 @@ async function startOrReuseCopilotBridge(providerName, provider, runtimeDir) {
     }
     child.unref();
     const startedAt = new Date().toISOString();
-    const healthy = await waitForCopilotBridgeStartup(child, runtime.bridgeHost, selectedPort, 15, 200);
+    // The worker can take a little longer to become healthy on Windows or under loaded test runs.
+    const healthy = await waitForCopilotBridgeStartup(child, runtime.bridgeHost, selectedPort, 25, 200);
     if (!healthy.ok) {
         (0, runtime_state_repo_1.clearCopilotBridgeState)(runtimeDir);
         if (healthy.reason === "start-failed") {

package/dist/storage/config-repo.js

@@ -40,7 +40,6 @@ exports.listConfigProfiles = listConfigProfiles;
 exports.ensureProfileExists = ensureProfileExists;
 exports.requireManagedProfileRuntime = requireManagedProfileRuntime;
 exports.requireModelProviderRuntimeSection = requireModelProviderRuntimeSection;
-exports.resolveActiveProviderName = resolveActiveProviderName;
 exports.updateTopLevelProfile = updateTopLevelProfile;
 exports.createConfigMutationPlan = createConfigMutationPlan;
 exports.applyConfigMutation = applyConfigMutation;
@@ -50,7 +49,6 @@ const os = __importStar(require("node:os"));
 const path = __importStar(require("node:path"));
 const config_1 = require("../domain/config");
 const errors_1 = require("../domain/errors");
-const providers_1 = require("../domain/providers");
 const codex_paths_1 = require("./codex-paths");
 const fs_utils_1 = require("./fs-utils");
 /**
@@ -163,27 +161,6 @@ function requireModelProviderRuntimeSection(document, profile) {
         });
     }
 }
-/**
- * Resolves the current active provider and requires the mapping to be unique.
- */
-function resolveActiveProviderName(document, providers) {
-    if (!document.activeProfile) {
-        throw (0, errors_1.cliError)("PROFILE_NOT_FOUND", "No top-level profile is set in config.toml.");
-    }
-    const matches = (0, providers_1.findProvidersByProfile)(providers, document.activeProfile);
-    if (matches.length === 0) {
-        throw (0, errors_1.cliError)("UNMANAGED_ACTIVE_PROFILE", `Active profile "${document.activeProfile}" is not mapped by providers.json.`, {
-            profile: document.activeProfile,
-        });
-    }
-    if (matches.length > 1) {
-        throw (0, errors_1.cliError)("ACTIVE_PROVIDER_UNRESOLVED", `Active profile "${document.activeProfile}" maps to multiple providers, so the active managed provider is ambiguous.`, {
-            profile: document.activeProfile,
-            providers: matches,
-        });
-    }
-    return matches[0];
-}
 /**
  * Rewrites config.toml so the requested profile becomes the active top-level profile.
  */