@minniexcode/codex-switch 0.0.12 → 0.1.1

package/dist/commands/registry.js

@@ -20,11 +20,11 @@ exports.COMMANDS = [
         tokens: ["config", "show"],
         handler: handlers_1.handleRegisteredCommand,
         group: "read",
-        summary: "Show the structured config profile view.",
+        summary: "Show the current route summary and legacy 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.",
+            "Returns current top-level model/model_provider together with recognizable legacy profile sections.",
+            "Passing [profile] narrows the legacy profile view to one section while preserving the same shape.",
         ],
         examples: ["codexs config show", "codexs config show packycode --json"],
     },
@@ -33,11 +33,11 @@ exports.COMMANDS = [
         tokens: ["config", "list-profiles"],
         handler: handlers_1.handleRegisteredCommand,
         group: "read",
-        summary: "List recognizable config profiles with managed-state hints.",
+        summary: "List recognizable legacy 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.",
+            "Lists managed, unmanaged, and orphaned legacy profile sections in one stable view.",
+            "Use config show for the current route summary and richer single-profile details.",
         ],
         examples: ["codexs config list-profiles", "codexs config list-profiles --json"],
     },
@@ -123,7 +123,7 @@ exports.COMMANDS = [
         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.",
+            "Reads legacy 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.",
@@ -141,7 +141,7 @@ exports.COMMANDS = [
         details: [
             "setup no longer performs initialization or migration work.",
             "Use init for the primary fresh-install workflow.",
-            "Use migrate only when adopting from existing config.toml profiles.",
+            "Use migrate only when adopting from existing legacy config.toml profiles.",
         ],
         examples: ["codexs help init", "codexs help migrate"],
     },
@@ -150,9 +150,13 @@ exports.COMMANDS = [
         tokens: ["list"],
         handler: handlers_1.handleRegisteredCommand,
         group: "read",
-        summary: "List configured providers from providers.json.",
+        summary: "List managed providers with model-provider routing and current-state hints.",
         usage: ["codexs list [--json] [--codex-dir <path>]"],
-        details: ["Reads providers.json and prints provider-to-profile mappings.", "Use --json for machine-readable automation output."],
+        details: [
+            "Reads providers.json and prints provider-to-model-provider mappings together with provider type.",
+            "When the active model_provider is shared by multiple providers, list surfaces the ambiguity instead of inventing one current provider.",
+            "Use --json for machine-readable automation output.",
+        ],
         examples: ["codexs list", "codexs list --json"],
     },
     {
@@ -174,9 +178,9 @@ exports.COMMANDS = [
         tokens: ["current"],
         handler: handlers_1.handleRegisteredCommand,
         group: "read",
-        summary: "Show the active top-level profile from config.toml.",
+        summary: "Show the active top-level model/model_provider route 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."],
+        details: ["Reads the currently active top-level model and model_provider.", "Fails when config.toml is missing or has no top-level model_provider."],
         examples: ["codexs current", "codexs current --json"],
     },
     {
@@ -184,12 +188,13 @@ exports.COMMANDS = [
         tokens: ["status"],
         handler: handlers_1.handleRegisteredCommand,
         group: "read",
-        summary: "Show tool-home, target-runtime, provider, and runtime-health status.",
+        summary: "Show tool-home, target-runtime, provider-path, and runtime-health status.",
         usage: ["codexs status [--json] [--codex-dir <path>]"],
         details: [
-            "Reports the target Codex runtime, tool-home storage roles, current profile, and whether the live profile is mapped.",
+            "Reports the target Codex runtime, tool-home storage roles, current model, current model_provider, and whether the live route 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.",
+            "Organizes the human-readable view around current state, health impact, and next step.",
             "Use doctor for deeper diagnostics.",
         ],
         examples: ["codexs status", "codexs status --json --codex-dir ./.tmp-codex"],
@@ -201,14 +206,15 @@ exports.COMMANDS = [
         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>",
+            "codexs edit <provider> [--profile <model-provider-id>] [--api-key <key>] [--base-url <url>] [--model <name>] [--note <text>] [--tag <tag> ...] [--json] [--codex-dir <path>]",
+            "codexs edit <provider> --profile <model-provider-id> --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 only.",
-            "When rebinding to a missing profile, --create-profile requires both --model and --base-url.",
+            "--profile is a CLI alias for the stored model_provider id.",
+            "When rebinding to a new direct model_provider id, the command must be able to project base_url from --base-url, the provider record, or an existing model_providers section.",
             "Backs up providers.json and config.toml before writing.",
         ],
         examples: ["codexs edit packycode --note primary", "codexs edit packycode --tag daily --tag paid --json"],
@@ -220,27 +226,26 @@ exports.COMMANDS = [
         group: "write",
         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]",
-            "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> ...]",
+            "codexs add <provider> --profile <model-provider-id> --model <name> --api-key <key> [--base-url <url>] [--note <text>] [--tag <tag> ...]",
+            "codexs add <provider> --copilot --profile <model-provider-id> --model <name> [--bridge-host <host>] [--bridge-port <port>] [--bridge-api-key <secret>]",
+            "codexs add [--profile <model-provider-id>] [--model <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.",
+            "Interactive add collects provider name, model_provider id, model, 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 only.",
             "Automation and non-TTY environments must pass all required values explicitly.",
-            "Creating a missing direct-provider profile section requires --create-profile together with --model and --base-url.",
-            "Creating a missing Copilot profile section requires --create-profile together with --model; the local bridge base_url is derived automatically.",
+            "--profile is a CLI alias for the stored model_provider id.",
+            "The command projects only model_providers sections and does not create legacy profiles sections.",
             "Use --copilot to create a GitHub Copilot bridge provider backed by the official SDK.",
             "Copilot providers require SDK install and login readiness to already be satisfied via codexs login copilot.",
             "For Copilot providers, provider apiKey stores only the local bridge secret; upstream GitHub Copilot auth stays shared in the official runtime login.",
             "--install-copilot-sdk is kept only as a rejected compatibility flag that points to codexs login copilot.",
         ],
         examples: [
-            "codexs add packycode --profile packycode --api-key sk-xxx",
-            "codexs add copilot-main --copilot --profile copilot-main",
+            "codexs add packycode --profile packycode --model gpt-5 --api-key sk-xxx --base-url https://api.example/v1",
+            "codexs add copilot-main --copilot --profile copilot-main --model gpt-5",
             "codexs add",
         ],
     },
@@ -268,12 +273,12 @@ exports.COMMANDS = [
         handler: handlers_1.handleRegisteredCommand,
         group: "write",
         summary: "Remove a provider from providers.json.",
-        usage: ["codexs remove <provider> [--force] [--switch-to <profile>] [--json] [--codex-dir <path>]"],
+        usage: ["codexs remove <provider> [--force] [--switch-to <provider>] [--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.",
+            "When removing the only provider linked to the active model_provider route, pass --switch-to <provider-name> first.",
             "Backs up providers.json and config.toml before removing the record.",
         ],
         examples: ["codexs remove freemodel", "codexs remove freemodel --force --json"],
@@ -324,10 +329,10 @@ exports.COMMANDS = [
         tokens: ["doctor"],
         handler: handlers_1.handleRegisteredCommand,
         group: "recovery",
-        summary: "Run repair-oriented diagnostics across tool-home and target-runtime state.",
+        summary: "Run issue-first 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.",
+            "Checks the expected config files, provider/model-provider consistency, and Codex CLI availability.",
             "Copilot bridge providers add runtime dependency, auth, and bridge health diagnostics.",
             "Returns structured issues so users and AI agents can act on them.",
         ],