@minniexcode/codex-switch 0.0.5 → 0.0.6

package/README.md

@@ -1,14 +1,12 @@
-# @minniexcode/codex-switch
+## @minniexcode/codex-switch
 
 `codex-switch` is a local-first CLI for managing and switching Codex provider/profile configuration safely.
 
-`codex-switch` 是一个本地优先的 CLI，用来安全地管理和切换 Codex 的 provider/profile 配置。
-
 It is designed for users who work with multiple Codex providers, API keys, or profiles and want a repeatable, backup-first workflow instead of manually editing files under `~/.codex/`.
 
-它面向同时维护多个 Codex provider、API key 或 profile 的用户，目标是用可重复、先备份再写入的方式替代手动修改 `~/.codex/` 下的文件。
+中文版: [README.CN.md](./README.CN.md)
 
-## Overview | 简介
+## Overview
 
 What it does:
 
@@ -17,22 +15,11 @@ What it does:
 - Switch the active provider/profile safely
 - Import and export provider definitions
 - Run diagnostics and detect local drift
-- List backups and rollback to a previous managed state
-
-它可以完成的事情：
-
-- 从现有 Codex 目录初始化 `providers.json`
-- 查看、新增、编辑、删除 provider 记录
-- 安全切换当前激活的 provider/profile
-- 导入和导出 provider 配置
-- 运行诊断并识别本地配置漂移
-- 查看备份并回滚到之前的受管状态
-
-Current version: `0.0.4`
+- List backups and roll back to a previous managed state
 
-当前版本：`0.0.4`
+Current version: `0.0.6`
 
-## Install | 安装
+## Install
 
 Install globally:
 
@@ -46,31 +33,13 @@ Or run directly:
 npx @minniexcode/codex-switch --help
 ```
 
-全局安装：
-
-```bash
-npm install -g @minniexcode/codex-switch
-```
-
-或者直接运行：
-
-```bash
-npx @minniexcode/codex-switch --help
-```
-
 CLI entry:
 
 ```bash
 codexs --help
 ```
 
-命令入口：
-
-```bash
-codexs --help
-```
-
-## Quick Start | 快速开始
+## Quick Start
 
 Take over an existing Codex directory:
 
@@ -78,12 +47,6 @@ Take over an existing Codex directory:
 codexs setup
 ```
 
-接管当前已有的 Codex 目录：
-
-```bash
-codexs setup
-```
-
 Inspect managed providers:
 
 ```bash
@@ -91,13 +54,6 @@ codexs list
 codexs show my-provider
 ```
 
-查看已管理的 provider：
-
-```bash
-codexs list
-codexs show my-provider
-```
-
 Add and switch:
 
 ```bash
@@ -105,13 +61,6 @@ codexs add my-provider --profile my-provider --api-key sk-xxx
 codexs switch my-provider
 ```
 
-新增并切换：
-
-```bash
-codexs add my-provider --profile my-provider --api-key sk-xxx
-codexs switch my-provider
-```
-
 Check runtime state:
 
 ```bash
@@ -120,15 +69,7 @@ codexs status
 codexs doctor
 ```
 
-检查当前运行状态：
-
-```bash
-codexs current
-codexs status
-codexs doctor
-```
-
-## Common Commands | 常用命令
+## Common Commands
 
 ```bash
 codexs setup
@@ -154,19 +95,10 @@ codexs help switch
 codexs help setup
 ```
 
-命令帮助：
-
-```bash
-codexs help switch
-codexs help setup
-```
-
-## How It Works | 工作方式
+## How It Works
 
 By default, `codex-switch` operates on `~/.codex/`, and you can override the target with `--codex-dir`.
 
-`codex-switch` 默认围绕 `~/.codex/` 工作，也可以通过 `--codex-dir` 指向其他目录。
-
 Managed files:
 
 ```text
@@ -177,23 +109,19 @@ Managed files:
   backups/
 ```
 
-说明：
+Notes:
 
 - `providers.json` is the managed provider registry
 - `config.toml` and `auth.json` represent runtime state
 - mutating commands back up before writing
 - rollback is available after failed or undesired changes
 
-- `providers.json` 是受管理的 provider 注册表
-- `config.toml` 和 `auth.json` 代表当前运行态
-- 所有写操作都会先备份再写入
-- 变更失败或结果不符合预期时可以回滚
-
-## Automation | 自动化
+## Automation
 
 This CLI supports both human TTY use and non-interactive automation.
 
-这个 CLI 同时支持人工交互和非交互自动化。
+Current exception:
+- `setup` in `0.0.6` is intentionally TTY-only for adopt initialization. It requires interactive profile selection and provider detail collection, and non-interactive/`--json` runs fail fast with a structured error.
 
 Recommended global flags:
 
@@ -204,28 +132,38 @@ Recommended global flags:
 --version
 ```
 
-建议：
+Recommendations:
 
 - use `--json` for stable machine-readable output
 - pass all required arguments explicitly in scripts or CI
 - use `--codex-dir <path>` for sandbox or test environments
 
-- 在脚本或 CI 中使用 `--json` 获取稳定输出
-- 在非交互环境中显式传入所有必需参数
-- 在测试环境中优先配合 `--codex-dir <path>` 使用
+## Testing
 
-## Documentation | 文档
+Build and test locally:
 
-- [Detailed CLI Usage](./docs/cli-usage.md)
-- [详细 CLI 使用文档](./docs/cli-usage.md)
-- [Changelog](./CHANGELOG.md)
-- [更新日志](./CHANGELOG.md)
+```bash
+npm run build
+npm test
+```
+
+The repository includes a development fixture under `dev-codex/local-sandbox` plus dedicated test docs:
+
+- [Testing Guide](./docs/testing.md)
+- [Test Report for 0.0.5](./docs/test-report-0.0.5.md)
+
+## Documentation
+
+- [Chinese README](./README.CN.md)
 - [AI README](./README.AI.md)
-- [中文 README（历史版）](./README.CN.md)
+- [Detailed CLI Usage](./docs/cli-usage.md)
+- [Testing Guide](./docs/testing.md)
+- [Test Report for 0.0.5](./docs/test-report-0.0.5.md)
 - [Product Overview](./docs/codex-switch-product-overview.md)
 - [Technical Architecture](./docs/codex-switch-technical-architecture.md)
-- [0.0.4 Design Doc](./docs/codex-switch-v0.0.4-design.md)
+- [Design Doc 0.0.5](./docs/Design/codex-switch-v0.0.5-design.md)
+- [Design Doc 0.0.4](./docs/Design/codex-switch-v0.0.4-design.md)
 
-## License | 许可证
+## License
 
 MIT

package/dist/app/add-provider.js

@@ -4,9 +4,9 @@ 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 config_repo_1 = require("../storage/config-repo");
+const fs_utils_1 = require("../storage/fs-utils");
+const providers_repo_1 = require("../storage/providers-repo");
 const run_mutation_1 = require("./run-mutation");
 /**
  * Adds a new provider record to the managed providers registry.
@@ -29,10 +29,16 @@ function addProvider(args) {
         ? {
             [args.profile]: (0, config_1.validateManagedProfileCreation)(args.profile, {
                 model: args.model ?? undefined,
-                baseUrl: args.baseUrl ?? undefined,
+                modelProvider: args.profile,
             }),
         }
         : undefined;
+    if (!existingProfile && args.createProfile) {
+        (0, config_repo_1.requireModelProviderRuntimeSection)(document, args.profile);
+    }
+    if (existingProfile) {
+        (0, config_repo_1.requireManagedProfileRuntime)(document, providers, args.profile);
+    }
     const next = {
         providers: {
             ...providers.providers,

package/dist/app/edit-provider.js

@@ -4,9 +4,9 @@ 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 config_repo_1 = require("../storage/config-repo");
+const fs_utils_1 = require("../storage/fs-utils");
+const providers_repo_1 = require("../storage/providers-repo");
 const run_mutation_1 = require("./run-mutation");
 /**
  * Updates selected fields on a single managed provider.
@@ -60,23 +60,23 @@ function editProvider(args) {
         upsertProfiles = {
             [newProfile]: (0, config_1.validateManagedProfileCreation)(newProfile, {
                 model: args.model ?? undefined,
-                baseUrl: args.baseUrl ?? undefined,
+                modelProvider: newProfile,
             }),
         };
+        (0, config_repo_1.requireModelProviderRuntimeSection)(document, newProfile);
     }
-    else if (args.model !== undefined || args.baseUrl !== undefined) {
+    else {
+        (0, config_repo_1.requireManagedProfileRuntime)(document, providers, newProfile);
+    }
+    if (targetProfileExists && args.model !== 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)) {

package/dist/app/export-providers.js

@@ -37,8 +37,8 @@ exports.exportProviders = exportProviders;
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
 const errors_1 = require("../domain/errors");
-const fs_utils_1 = require("../infra/fs-utils");
-const providers_repo_1 = require("../infra/providers-repo");
+const fs_utils_1 = require("../storage/fs-utils");
+const providers_repo_1 = require("../storage/providers-repo");
 /**
  * Exports the current providers registry to a user-specified file.
  */

package/dist/app/get-current-profile.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getCurrentProfile = getCurrentProfile;
-const config_repo_1 = require("../infra/config-repo");
+const config_repo_1 = require("../storage/config-repo");
 /**
  * Returns the currently active top-level Codex profile.
  */

package/dist/app/get-status.js

@@ -37,8 +37,8 @@ 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");
+const config_repo_1 = require("../storage/config-repo");
+const providers_repo_1 = require("../storage/providers-repo");
 /**
  * Reports the current on-disk runtime state and how it maps back to managed providers.
  */

package/dist/app/import-providers.js

@@ -39,9 +39,9 @@ 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 config_repo_1 = require("../storage/config-repo");
+const fs_utils_1 = require("../storage/fs-utils");
+const providers_repo_1 = require("../storage/providers-repo");
 const run_mutation_1 = require("./run-mutation");
 /**
  * Imports provider definitions from an external JSON file into the managed registry.
@@ -83,13 +83,21 @@ function importProviders(args) {
             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.", {
+                const sourceView = currentViews.find((entry) => entry.name === view.name) ?? null;
+                if (!sourceView?.model) {
+                    throw (0, errors_1.cliError)("MANAGED_PROFILE_FIELDS_MISSING", "Import would create provider references to missing config profiles that need model and matching model_provider sections.", {
                         profilesNeedingRepair: missingViews.map((entry) => entry.name).sort(),
                     });
                 }
-                accumulator[view.name] = (0, config_1.validateManagedProfileCreation)(view.name, repair);
+                if (sourceView.modelProvider !== view.name || !sourceView.baseUrl) {
+                    throw (0, errors_1.cliError)("MANAGED_PROFILE_FIELDS_MISSING", "Import would create provider references to missing config profiles without matching model_provider runtime sections.", {
+                        profilesNeedingRepair: missingViews.map((entry) => entry.name).sort(),
+                    });
+                }
+                accumulator[view.name] = (0, config_1.validateManagedProfileCreation)(view.name, {
+                    model: sourceView.model,
+                    modelProvider: view.name,
+                });
                 repairedProfiles.push(view.name);
                 return accumulator;
             }, {});

package/dist/app/list-backups.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.listBackupEntries = listBackupEntries;
-const backup_repo_1 = require("../infra/backup-repo");
+const backup_repo_1 = require("../storage/backup-repo");
 /**
  * Lists backup manifests available under the managed Codex backups directory.
  */

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

@@ -2,8 +2,8 @@
 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");
+const config_repo_1 = require("../storage/config-repo");
+const providers_repo_1 = require("../storage/providers-repo");
 /**
  * Returns the lightweight config profile listing.
  */
@@ -16,6 +16,7 @@ function listConfigProfilesView(args) {
         isActive: profile.isActive,
         linkedProviders: profile.linkedProviders,
         model: profile.model,
+        modelProvider: profile.modelProvider,
         baseUrl: profile.baseUrl,
         source: profile.source,
     }));

package/dist/app/list-providers.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.listProviders = listProviders;
-const providers_repo_1 = require("../infra/providers-repo");
+const providers_repo_1 = require("../storage/providers-repo");
 /**
  * Returns the sorted list of configured providers for display.
  */

package/dist/app/remove-provider.js

@@ -3,8 +3,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 config_repo_1 = require("../storage/config-repo");
+const providers_repo_1 = require("../storage/providers-repo");
 const run_mutation_1 = require("./run-mutation");
 /**
  * Removes a provider from the managed providers registry.

package/dist/app/rollback-backup.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.rollbackBackup = rollbackBackup;
 const errors_1 = require("../domain/errors");
-const backup_repo_1 = require("../infra/backup-repo");
+const backup_repo_1 = require("../storage/backup-repo");
 /**
  * Restores either the latest backup or a specific historical backup by id.
  */

package/dist/app/rollback-latest.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.rollbackLatest = rollbackLatest;
 const errors_1 = require("../domain/errors");
-const backup_repo_1 = require("../infra/backup-repo");
+const backup_repo_1 = require("../storage/backup-repo");
 /**
  * Restores the most recent mutation backup recorded by codex-switch.
  */

package/dist/app/run-doctor.js

@@ -37,10 +37,10 @@ exports.runDoctor = runDoctor;
 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 config_repo_1 = require("../storage/config-repo");
+const providers_repo_1 = require("../storage/providers-repo");
 const errors_1 = require("../domain/errors");
+const codex_probe_1 = require("../runtime/codex-probe");
 /**
  * Performs consistency checks across config.toml, providers.json, and the local Codex CLI.
  */
@@ -96,11 +96,20 @@ function runDoctor(args) {
         }
     }
     const drift = (0, runtime_state_1.inspectLiveStateDrift)(currentProfile, providers);
-    const codexCheck = (0, codex_cli_1.checkCodexAvailable)();
+    const codexCheck = (0, codex_probe_1.probeCodexRuntime)();
     if (!codexCheck.ok) {
+        const message = codexCheck.reason === "missing"
+            ? "codex CLI is not available on PATH."
+            : codexCheck.reason === "unsupported"
+                ? "codex CLI version is below the supported minimum."
+                : "codex CLI probe failed.";
         issues.push({
-            code: "CODEX_LOGIN_FAILED",
-            message: "codex CLI is not available.",
+            code: codexCheck.reason === "unsupported"
+                ? "CODEX_VERSION_UNSUPPORTED"
+                : codexCheck.reason === "missing"
+                    ? "CODEX_NOT_INSTALLED"
+                    : "CODEX_LOGIN_FAILED",
+            message,
             cause: codexCheck.cause,
         });
     }
@@ -125,6 +134,14 @@ function renderConfigIssueMessage(issue) {
             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 "MODEL_PROVIDER_MISSING":
+            return `Profile "${issue.profile}" is missing model_provider.`;
+        case "MODEL_PROVIDER_NAME_MISMATCH":
+            return `Profile "${issue.profile}" must use matching model_provider name "${issue.profile}", found "${issue.modelProvider}".`;
+        case "MODEL_PROVIDER_SECTION_MISSING":
+            return `Model provider section "${issue.modelProvider}" for profile "${issue.profile}" is missing from config.toml.`;
+        case "MODEL_PROVIDER_BASE_URL_MISSING":
+            return `Model provider section "${issue.modelProvider}" for profile "${issue.profile}" is missing base_url.`;
         case "DESTRUCTIVE_REMOVE_BLOCKED":
             return `Provider "${issue.provider}" cannot be removed while "${issue.activeProfile}" remains active.`;
     }

package/dist/app/run-mutation.js

@@ -2,8 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.runMutation = runMutation;
 const errors_1 = require("../domain/errors");
-const backup_repo_1 = require("../infra/backup-repo");
-const lock_repo_1 = require("../infra/lock-repo");
+const backup_repo_1 = require("../storage/backup-repo");
+const lock_repo_1 = require("../storage/lock-repo");
 /**
  * Runs a write operation under a lock with automatic backup and rollback handling.
  */

package/dist/app/setup-codex.js

@@ -38,10 +38,10 @@ const fs = __importStar(require("node:fs"));
 const setup_1 = require("../domain/setup");
 const errors_1 = require("../domain/errors");
 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");
-const providers_repo_1 = require("../infra/providers-repo");
+const codex_cli_1 = require("../runtime/codex-cli");
+const config_repo_1 = require("../storage/config-repo");
+const fs_utils_1 = require("../storage/fs-utils");
+const providers_repo_1 = require("../storage/providers-repo");
 const run_doctor_1 = require("./run-doctor");
 const run_mutation_1 = require("./run-mutation");
 const MIN_CODEX_VERSION = "0.0.1";
@@ -71,7 +71,7 @@ function setupCodex(args) {
     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)
+        .filter((view) => view.source === "unmanaged" && view.model && view.modelProvider === view.name && view.baseUrl)
         .map((view) => view.name)
         .sort();
     if (profileViews.length === 0) {
@@ -81,7 +81,7 @@ function setupCodex(args) {
     }
     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.", {
+        throw (0, errors_1.cliError)("INVALID_ARGUMENT", "setup only adopts unmanaged profiles that already contain model, model_provider, and a matching model_providers base_url.", {
             invalidProfiles: invalidAdoptProfiles.sort(),
             adoptableProfiles,
         });

package/dist/app/show-config.js

@@ -3,8 +3,8 @@ 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");
+const config_repo_1 = require("../storage/config-repo");
+const providers_repo_1 = require("../storage/providers-repo");
 /**
  * Returns the structured config view, optionally filtered to one profile.
  */

package/dist/app/show-provider.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.showProvider = showProvider;
 const providers_1 = require("../domain/providers");
-const providers_repo_1 = require("../infra/providers-repo");
+const providers_repo_1 = require("../storage/providers-repo");
 /**
  * Returns a single provider record, with text-mode callers able to use a masked preview.
  */

package/dist/app/switch-provider.js

@@ -2,10 +2,10 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.switchProvider = switchProvider;
 const errors_1 = require("../domain/errors");
-const config_repo_1 = require("../infra/config-repo");
-const codex_cli_1 = require("../infra/codex-cli");
-const providers_repo_1 = require("../infra/providers-repo");
+const config_repo_1 = require("../storage/config-repo");
+const providers_repo_1 = require("../storage/providers-repo");
 const run_mutation_1 = require("./run-mutation");
+const codex_cli_1 = require("../runtime/codex-cli");
 /**
  * Switches the active Codex profile and optionally refreshes the CLI login session.
  */