@minniexcode/codex-switch 0.0.5 → 0.0.7

package/README.AI.md

@@ -17,7 +17,8 @@ Primary goals:
 ## Main Command Surface
 
 ```bash
-codexs setup
+codexs init
+codexs migrate
 codexs list
 codexs show <provider>
 codexs current
@@ -92,11 +93,12 @@ codexs status --json
 Current package version in this repository:
 
 ```text
-0.0.4
+0.0.7
 ```
 
 Recent version summary:
 
+- `0.0.7`: command-surface refactor, env_key/auth-mirror model corrections, and the `setup` split into `init` plus `migrate`
 - `0.0.4`: setup/show/edit/backups list/specific rollback/import merge and clearer CLI semantics
 - `0.0.3`: interactive TTY flows and improved help
 - `0.0.2`: mutation orchestration, backups, rollback, locks, drift detection improvements
@@ -107,4 +109,5 @@ Recent version summary:
 - Prefer `--json` when invoking commands programmatically
 - Treat `providers.json` as sensitive because it may contain API keys
 - Do not assume silent write-back from runtime files into `providers.json`
+- Prefer `init` for repeatable machine setup and `migrate` for human-led adopt flows
 - Use `docs/` for deeper product and architecture context

package/README.md

@@ -1,38 +1,26 @@
-# @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:
 
-- Initialize `providers.json` from an existing Codex directory
+- Initialize an empty managed `providers.json`
+- Migrate unmanaged runtime profiles from an existing Codex directory
 - List, show, add, edit, and remove provider records
 - 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.7`
 
-## Install | 安装
+## Install
 
 Install globally:
 
@@ -46,42 +34,19 @@ 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:
 
 ```bash
-codexs setup
-```
-
-接管当前已有的 Codex 目录：
-
-```bash
-codexs setup
+codexs init
+codexs migrate
 ```
 
 Inspect managed providers:
@@ -91,13 +56,6 @@ codexs list
 codexs show my-provider
 ```
 
-查看已管理的 provider：
-
-```bash
-codexs list
-codexs show my-provider
-```
-
 Add and switch:
 
 ```bash
@@ -105,13 +63,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,18 +71,11 @@ codexs status
 codexs doctor
 ```
 
-检查当前运行状态：
+## Common Commands
 
 ```bash
-codexs current
-codexs status
-codexs doctor
-```
-
-## Common Commands | 常用命令
-
-```bash
-codexs setup
+codexs init
+codexs migrate
 codexs list
 codexs show <provider>
 codexs current
@@ -151,22 +95,15 @@ Command help:
 
 ```bash
 codexs help switch
+codexs help init
+codexs help migrate
 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 +114,20 @@ 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 exceptions:
+- `init` is automation-friendly and idempotent, but still returns a structured error in non-interactive or `--json` mode when the resolved target directory does not exist.
+- `migrate` remains 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 +138,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,10 @@ 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 auth_repo_1 = require("../storage/auth-repo");
 const run_mutation_1 = require("./run-mutation");
 /**
  * Adds a new provider record to the managed providers registry.
@@ -19,6 +20,7 @@ function addProvider(args) {
     }
     const document = (0, config_repo_1.readStructuredConfig)(args.configPath);
     const existingProfile = document.profiles.find((profile) => profile.name === args.profile);
+    const existingModelProvider = document.modelProviders.find((entry) => entry.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,
@@ -29,16 +31,29 @@ function addProvider(args) {
         ? {
             [args.profile]: (0, config_1.validateManagedProfileCreation)(args.profile, {
                 model: args.model ?? undefined,
-                baseUrl: args.baseUrl ?? undefined,
+                modelProvider: args.profile,
             }),
         }
         : undefined;
+    const upsertModelProviders = !existingModelProvider && args.createProfile
+        ? {
+            [args.profile]: {
+                baseUrl: args.baseUrl ?? undefined,
+                envKey: (0, config_1.buildManagedProfileEnvKey)(args.profile),
+            },
+        }
+        : undefined;
+    if (existingProfile) {
+        (0, config_repo_1.requireManagedProfileRuntime)(document, providers, args.profile);
+    }
+    const envKey = existingModelProvider?.envKey ?? (0, config_1.buildManagedProfileEnvKey)(args.profile);
     const next = {
         providers: {
             ...providers.providers,
             [args.providerName]: (0, providers_1.cleanProviderRecord)({
                 profile: args.profile,
                 apiKey: args.apiKey,
+                envKey,
                 baseUrl: args.baseUrl ?? undefined,
                 note: args.note ?? undefined,
                 tags: args.tags,
@@ -53,18 +68,27 @@ function addProvider(args) {
         files: [
             { absolutePath: args.providersPath, relativePath: "providers.json" },
             { absolutePath: args.configPath, relativePath: "config.toml" },
+            { absolutePath: args.authPath, relativePath: "auth.json" },
         ],
         mutate: () => {
             const configPlan = (0, config_repo_1.createConfigMutationPlan)(document, {
                 upsertProfiles,
+                upsertModelProviders,
             });
             // 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);
+            if (document.activeProfile === args.profile) {
+                const activeProviderName = (0, config_repo_1.resolveActiveProviderName)(document, next);
+                const existingAuth = (0, auth_repo_1.readAuthFileIfExists)(args.authPath);
+                (0, auth_repo_1.writeAuthFile)(args.authPath, next.providers[activeProviderName], existingAuth ?? undefined);
+            }
             return {
                 provider: args.providerName,
                 profile: args.profile,
+                envKey,
                 createdProfileSections: configPlan.createdProfileSections,
+                createdModelProviderSections: configPlan.createdModelProviderSections,
                 deletedProfileSections: configPlan.deletedProfileSections,
                 keptSharedProfiles: [],
                 switchedActiveProfile: configPlan.switchedActiveProfile,

package/dist/app/edit-provider.js

@@ -4,9 +4,10 @@ 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 auth_repo_1 = require("../storage/auth-repo");
 const run_mutation_1 = require("./run-mutation");
 /**
  * Updates selected fields on a single managed provider.
@@ -23,13 +24,7 @@ function editProvider(args) {
         });
     }
     const updatedFields = [];
-    const nextRecord = (0, providers_1.cleanProviderRecord)({
-        profile: args.profile ?? current.profile,
-        apiKey: args.apiKey ?? current.apiKey,
-        baseUrl: args.baseUrl === null ? undefined : args.baseUrl ?? current.baseUrl,
-        note: args.note === null ? undefined : args.note ?? current.note,
-        tags: args.tags ?? current.tags,
-    });
+    const nextProfile = args.profile ?? current.profile;
     if (args.profile !== undefined && args.profile !== current.profile) {
         updatedFields.push("profile");
     }
@@ -46,10 +41,12 @@ function editProvider(args) {
         updatedFields.push("tags");
     }
     const oldProfile = current.profile;
-    const newProfile = nextRecord.profile;
+    const newProfile = nextProfile;
     const targetSection = document.profiles.find((profile) => profile.name === newProfile) ?? null;
+    const targetModelProviderSection = document.modelProviders.find((entry) => entry.name === newProfile) ?? null;
     const targetProfileExists = Boolean(targetSection);
     let upsertProfiles;
+    let upsertModelProviders;
     if (!targetProfileExists) {
         if (!args.createProfile) {
             throw (0, errors_1.cliError)("PROFILE_NOT_FOUND", `Profile "${newProfile}" does not exist in config.toml.`, {
@@ -60,24 +57,44 @@ function editProvider(args) {
         upsertProfiles = {
             [newProfile]: (0, config_1.validateManagedProfileCreation)(newProfile, {
                 model: args.model ?? undefined,
-                baseUrl: args.baseUrl ?? undefined,
+                modelProvider: newProfile,
             }),
         };
+        upsertModelProviders = {
+            [newProfile]: {
+                baseUrl: args.baseUrl ?? undefined,
+                envKey: (0, config_1.buildManagedProfileEnvKey)(newProfile),
+            },
+        };
     }
-    else if (args.model !== undefined || args.baseUrl !== undefined) {
+    else {
+        (0, config_repo_1.requireManagedProfileRuntime)(document, providers, newProfile);
+    }
+    const nextEnvKey = args.profile !== undefined && args.profile !== current.profile
+        ? targetModelProviderSection?.envKey ?? (0, config_1.buildManagedProfileEnvKey)(newProfile)
+        : current.envKey;
+    if (nextEnvKey !== current.envKey) {
+        updatedFields.push("envKey");
+    }
+    const nextRecord = (0, providers_1.cleanProviderRecord)({
+        profile: newProfile,
+        apiKey: args.apiKey ?? current.apiKey,
+        envKey: nextEnvKey,
+        baseUrl: args.baseUrl === null ? undefined : args.baseUrl ?? current.baseUrl,
+        note: args.note === null ? undefined : args.note ?? current.note,
+        tags: args.tags ?? current.tags,
+    });
+    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");
-        }
     }
+    // Compute profile link ownership after the edit so lifecycle planning can decide whether sections stay, move, or delete.
     const remainingLinksByProfile = new Map();
     for (const [name, provider] of Object.entries(providers.providers)) {
         if (name === args.providerName) {
@@ -108,24 +125,35 @@ function editProvider(args) {
         files: [
             { absolutePath: args.providersPath, relativePath: "providers.json" },
             { absolutePath: args.configPath, relativePath: "config.toml" },
+            { absolutePath: args.authPath, relativePath: "auth.json" },
         ],
         mutate: () => {
             const configPlan = (0, config_repo_1.createConfigMutationPlan)(document, {
                 upsertProfiles,
+                upsertModelProviders,
                 deleteProfiles: lifecycle.deletedProfileSections,
                 setActiveProfile: lifecycle.nextActiveProfile,
             });
-            (0, providers_repo_1.writeProvidersFile)(args.providersPath, {
+            const nextProviders = {
                 providers: {
                     ...providers.providers,
                     [args.providerName]: nextRecord,
                 },
-            });
+            };
+            // Write providers first so the registry and config move together inside the managed backup boundary.
+            (0, providers_repo_1.writeProvidersFile)(args.providersPath, nextProviders);
             (0, config_repo_1.applyConfigMutation)(args.configPath, document, configPlan);
+            const updatedDocument = (0, config_repo_1.readStructuredConfig)(args.configPath);
+            if (updatedDocument.activeProfile) {
+                const activeProviderName = (0, config_repo_1.resolveActiveProviderName)(updatedDocument, nextProviders);
+                const existingAuth = (0, auth_repo_1.readAuthFileIfExists)(args.authPath);
+                (0, auth_repo_1.writeAuthFile)(args.authPath, nextProviders.providers[activeProviderName], existingAuth ?? undefined);
+            }
             return {
                 provider: args.providerName,
                 updatedFields,
                 createdProfileSections: configPlan.createdProfileSections,
+                createdModelProviderSections: configPlan.createdModelProviderSections,
                 deletedProfileSections: configPlan.deletedProfileSections,
                 keptSharedProfiles: lifecycle.keptSharedProfiles,
                 switchedActiveProfile: lifecycle.switchedActiveProfile,

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,12 +37,14 @@ 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 providers_1 = require("../domain/providers");
+const config_repo_1 = require("../storage/config-repo");
+const providers_repo_1 = require("../storage/providers-repo");
+const auth_repo_1 = require("../storage/auth-repo");
 /**
  * Reports the current on-disk runtime state and how it maps back to managed providers.
  */
-function getStatus(codexDir, configPath, providersPath) {
+function getStatus(codexDir, configPath, providersPath, authPath) {
     const configExists = fs.existsSync(configPath);
     const providersExists = fs.existsSync(providersPath);
     let currentProfile = null;
@@ -50,6 +52,7 @@ function getStatus(codexDir, configPath, providersPath) {
     const providers = providersExists ? (0, providers_repo_1.readProvidersFile)(providersPath) : null;
     let configViews = [];
     let consistencyIssues = [];
+    const authState = (0, auth_repo_1.readManagedAuthState)(authPath);
     if (configExists) {
         const document = (0, config_repo_1.readStructuredConfig)(configPath);
         currentProfile = document.activeProfile;
@@ -60,6 +63,7 @@ function getStatus(codexDir, configPath, providersPath) {
         }
     }
     const liveState = (0, runtime_state_1.inspectLiveStateDrift)(currentProfile, providers);
+    const activeProviderCandidates = currentProfile && providers ? (0, providers_1.findProvidersByProfile)(providers, currentProfile) : [];
     if (liveState.canBackfillActiveProvider) {
         // Surface unmanaged live state without mutating anything during a read-only status call.
         warnings.push("Current config profile is not mapped in providers.json. Backfill would be required before treating live state as managed.");
@@ -74,7 +78,10 @@ function getStatus(codexDir, configPath, providersPath) {
             currentProfile,
             currentProfileMapped: liveState.profileMapped,
             provider: liveState.mappedProvider,
+            activeProviderResolvable: activeProviderCandidates.length === 1,
+            activeProviderCandidates,
             liveState,
+            auth: authState,
             configProfiles: configViews,
             issues: consistencyIssues,
         },

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/init-codex.js

@@ -0,0 +1,68 @@
+"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.initCodex = initCodex;
+const fs = __importStar(require("node:fs"));
+const errors_1 = require("../domain/errors");
+const fs_utils_1 = require("../storage/fs-utils");
+const providers_repo_1 = require("../storage/providers-repo");
+/**
+ * Initializes a Codex directory for managed providers.json usage without requiring live Codex state.
+ */
+function initCodex(args) {
+    const codexDirExists = fs.existsSync(args.codexDir);
+    if (!codexDirExists && !args.createCodexDir) {
+        throw (0, errors_1.cliError)("CODEX_DIR_NOT_FOUND", "The requested Codex directory does not exist.", {
+            codexDir: args.codexDir,
+        });
+    }
+    if (!codexDirExists) {
+        (0, fs_utils_1.ensureDir)(args.codexDir);
+    }
+    const providersExists = fs.existsSync(args.providersPath);
+    if (!providersExists) {
+        (0, providers_repo_1.writeProvidersFile)(args.providersPath, { providers: {} });
+    }
+    return {
+        data: {
+            codexDir: args.codexDir,
+            createdCodexDir: !codexDirExists,
+            createdProvidersFile: !providersExists,
+            providersAlreadyExisted: providersExists,
+            configExists: fs.existsSync(args.configPath),
+            authExists: fs.existsSync(args.authPath),
+        },
+    };
+}

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.
  */