@minniexcode/codex-switch 0.1.2 → 0.1.4

package/README.AI.md

@@ -6,8 +6,8 @@ This file summarizes the current operational contract for AI agents, automation
 
 - Package: `@minniexcode/codex-switch`
 - CLI name: `codexs`
-- Current repository version: `0.1.1`
-- Version status: stable release line
+- Current repository version: `0.1.4`
+- Version status: development line
 - Runtime contract target: Codex `0.134.0+`
 
 ## Product Role
@@ -133,6 +133,7 @@ Important behavioral constraints:
 - `migrate` remains interactive when provider adoption requires human input.
 - `status` is the main dual-path summary command.
 - `doctor` is the deeper repair-oriented diagnostic command.
+- The current `0.1.4` line focuses on bridge stability, surfaced runtime log metadata, and stricter release-hygiene verification rather than command-surface expansion.
 
 ## Safety Notes
 

package/README.CN.md

@@ -6,9 +6,9 @@
 
 ## 版本定位
 
-当前包版本：`0.1.2`
+当前包版本：`0.1.4`
 
-这是当前稳定发布线。`0.1.2` 是 Copilot runtime 修复版本，包含受管 SDK 固定版本与 Copilot 专用的 `stream_idle_timeout_ms = 300000` 投影，用于避免长 prompt 的空闲超时。
+这是当前仓库开发线。`0.1.4` 聚焦于 bridge 稳定性与可观测性，包括 bridge 复用探测加固、运行态日志元数据外显，以及更严格的 release hygiene 门禁，同时不扩展 provider 命令面。
 
 ## 安装
 
@@ -209,6 +209,8 @@ npm pack --dry-run
 - [Design 0.1.1](./docs/Design/codex-switch-v0.1.1-design.md)
 - [PRD 0.1.2](./docs/PRD/codex-switch-prd-v0.1.2.md)
 - [Design 0.1.2](./docs/Design/codex-switch-v0.1.2-design.md)
+- [PRD 0.1.4](./docs/PRD/codex-switch-prd-v0.1.4.md)
+- [Design 0.1.4](./docs/Design/codex-switch-v0.1.4-design.md)
 
 ## License
 

package/README.md

@@ -8,9 +8,9 @@ Chinese version: [README.CN.md](./README.CN.md)
 
 ## Version
 
-Current package version: `0.1.2`
+Current package version: `0.1.4`
 
-This is the current stable documentation line. `0.1.2` is the Copilot runtime repair release, including the managed SDK pin and the Copilot-only `stream_idle_timeout_ms = 300000` projection used to prevent long prompt idle timeouts.
+This is the current repository development line. `0.1.4` is the bridge stability and observability line, focused on bridge reuse hardening, surfaced runtime log metadata, and a stricter release-hygiene gate while keeping the provider surface unchanged.
 
 ## Install
 
@@ -217,7 +217,11 @@ npm pack --dry-run
 - [PRD 0.1.0](./docs/PRD/codex-switch-prd-v0.1.0.md)
 - [PRD 0.1.1](./docs/PRD/codex-switch-prd-v0.1.1.md)
 - [PRD 0.1.2](./docs/PRD/codex-switch-prd-v0.1.2.md)
+- [PRD 0.1.3](./docs/PRD/codex-switch-prd-v0.1.3.md)
+- [PRD 0.1.4](./docs/PRD/codex-switch-prd-v0.1.4.md)
 - [Design 0.1.2](./docs/Design/codex-switch-v0.1.2-design.md)
+- [Design 0.1.3](./docs/Design/codex-switch-v0.1.3-design.md)
+- [Design 0.1.4](./docs/Design/codex-switch-v0.1.4-design.md)
 
 ## License
 

package/dist/app/bridge.js

@@ -58,6 +58,9 @@ async function startBridge(args) {
             port: bridge.port,
             reused: bridge.reused,
             portChanged: bridge.portChanged,
+            replaced: bridge.replaced,
+            restartReason: bridge.restartReason ?? null,
+            logPath: bridge.logPath,
             defaultPort: DEFAULT_BRIDGE_PORT,
         },
     };
@@ -74,6 +77,8 @@ async function stopBridge(args) {
                 provider: null,
                 stopped: true,
                 hadRuntimeState: false,
+                logPath: null,
+                lastRestartReason: null,
             },
         };
     }
@@ -84,6 +89,8 @@ async function stopBridge(args) {
                 provider: args.providerName,
                 stopped: true,
                 hadRuntimeState: false,
+                logPath: null,
+                lastRestartReason: null,
             },
         };
     }
@@ -109,6 +116,8 @@ async function stopBridge(args) {
             provider: target.providerName,
             stopped: true,
             hadRuntimeState: Boolean(state),
+            logPath: state?.logPath ?? null,
+            lastRestartReason: state?.lastRestartReason ?? null,
         },
     };
 }
@@ -146,6 +155,8 @@ async function statusBridge(args) {
             matches: Boolean(state && state.provider === target.providerName && state.baseUrl === expectedBaseUrl),
             active: runtimeStatus.ok,
             health: runtimeStatus,
+            logPath: state?.logPath ?? null,
+            lastRestartReason: state?.lastRestartReason ?? null,
         },
     };
 }

package/dist/app/get-status.js

@@ -88,6 +88,9 @@ async function getStatus(codexDir, configPath, providersPath, authPath, options)
             runtime: "copilot-bridge",
             reason: "failed",
             cause: runtimeStateInspection.parseError ?? "Failed to parse Copilot bridge runtime state.",
+            details: {
+                logPath: runtimeState?.logPath ?? null,
+            },
         }
         : bridgeProbeTarget
             ? await (0, copilot_bridge_1.probeCopilotBridgeRuntime)(bridgeProbeTarget, runtimeState, options?.runtimeDir)
@@ -97,7 +100,10 @@ async function getStatus(codexDir, configPath, providersPath, authPath, options)
                     runtime: "copilot-bridge",
                     reason: "failed",
                     cause: "Copilot bridge runtime state exists but no matching managed Copilot provider is active.",
-                    details: runtimeState,
+                    details: {
+                        ...runtimeState,
+                        logPath: runtimeState.logPath ?? null,
+                    },
                 }
                 : null;
     const copilotAuth = activeProvider && (0, providers_1.isCopilotBridgeProvider)(activeProvider)
@@ -148,6 +154,8 @@ async function getStatus(codexDir, configPath, providersPath, authPath, options)
             copilotAuth,
             copilotBridge,
             copilotRuntimeState: runtimeState,
+            copilotBridgeLogPath: runtimeState?.logPath ?? null,
+            copilotBridgeRestartReason: runtimeState?.lastRestartReason ?? null,
             liveState,
             auth: authState,
             configProfiles: configViews,

package/dist/app/run-doctor.js

@@ -117,6 +117,7 @@ async function runDoctor(args) {
         issues.push({
             code: "BRIDGE_STATE_STALE",
             message: `Copilot bridge runtime state is unreadable: ${runtimeStateInspection.parseError ?? "unknown parse failure"}`,
+            logPath: runtimeState?.logPath ?? null,
         });
     }
     if (document?.currentModelProvider && providers) {
@@ -209,6 +210,7 @@ async function runDoctor(args) {
             }),
             liveState: drift,
             auth: authState,
+            copilotRuntimeState: runtimeState,
         },
         warnings: issues.length === 0 ? [] : [`doctor found ${issues.length} issue(s)`],
     };

package/dist/app/switch-provider.js

@@ -22,7 +22,9 @@ async function switchProvider(args) {
         });
     }
     const document = (0, config_repo_1.readStructuredConfig)(args.configPath);
-    const resolvedModel = provider.model ?? document.currentModel;
+    const providerProfileSection = document.profiles.find((entry) => entry.name === provider.profile) ?? null;
+    const providerModelProviderSection = document.modelProviders.find((entry) => entry.name === provider.profile) ?? null;
+    const resolvedModel = provider.model ?? providerProfileSection?.model ?? document.currentModel;
     if (!resolvedModel) {
         throw (0, errors_1.cliError)("MANAGED_PROFILE_FIELDS_MISSING", `Provider "${args.providerName}" has no model to switch with.`, {
             provider: args.providerName,
@@ -90,6 +92,10 @@ async function switchProvider(args) {
                         profile: nextProvider.profile,
                         portChanged: bridge.portChanged,
                         bridgePort: bridge.port,
+                        bridgeReused: bridge.reused,
+                        bridgeReplaced: bridge.replaced,
+                        bridgeRestartReason: bridge.restartReason ?? null,
+                        bridgeLogPath: bridge.logPath,
                     };
                 },
             });
@@ -112,7 +118,8 @@ async function switchProvider(args) {
         ],
         mutate: () => {
             const directBaseUrl = provider.baseUrl?.trim() ?? "";
-            if (!directBaseUrl) {
+            const resolvedBaseUrl = directBaseUrl || providerModelProviderSection?.baseUrl?.trim() || "";
+            if (!resolvedBaseUrl) {
                 throw (0, errors_1.cliError)("MANAGED_PROFILE_FIELDS_MISSING", `Provider "${args.providerName}" requires base_url before switching.`, {
                     provider: args.providerName,
                     modelProvider: provider.profile,
@@ -123,7 +130,7 @@ async function switchProvider(args) {
                 setCurrentModel: resolvedModel,
                 setCurrentModelProvider: provider.profile,
                 upsertModelProviders: {
-                    [provider.profile]: (0, providers_1.buildDirectModelProviderProjection)(provider.profile, directBaseUrl),
+                    [provider.profile]: (0, providers_1.buildDirectModelProviderProjection)(provider.profile, resolvedBaseUrl),
                 },
                 deleteLegacyProfile: true,
                 deleteLegacyProfilesByName: [provider.profile],

package/dist/cli/output.js

@@ -144,6 +144,12 @@ function renderHumanSuccess(command, data, warnings) {
             lines.push(`  mapped provider: ${renderStatusMappedProvider(data)}`);
             lines.push(`  provider path: ${renderStatusProviderPath(data)}`);
             lines.push(`  runtime health: ${renderStatusHealth(data)}`);
+            if (data?.copilotBridgeLogPath) {
+                lines.push(`  bridge log: ${String(data.copilotBridgeLogPath)}`);
+            }
+            if (data?.copilotBridgeRestartReason) {
+                lines.push(`  bridge restart reason: ${String(data.copilotBridgeRestartReason)}`);
+            }
             lines.push(`  warnings: ${warnings.length}`);
             lines.push(`  next step: ${renderStatusNextStep(data, warnings)}`);
             break;
@@ -167,6 +173,15 @@ function renderHumanSuccess(command, data, warnings) {
         case "switch":
             lines.push(`Switched to provider ${String(data?.provider ?? "")} using model provider ${String(data?.modelProvider ?? data?.profile ?? "")}.`);
             lines.push(`Model: ${String(data?.model ?? "")}`);
+            if (data?.bridgeReplaced) {
+                lines.push(`Bridge replaced: true`);
+            }
+            if (data?.bridgeRestartReason) {
+                lines.push(`Bridge restart reason: ${String(data?.bridgeRestartReason)}`);
+            }
+            if (data?.bridgeLogPath) {
+                lines.push(`Bridge log: ${String(data?.bridgeLogPath)}`);
+            }
             lines.push(`Backup: ${String(data?.backupPath ?? "")}`);
             break;
         case "import":
@@ -227,12 +242,49 @@ function renderHumanSuccess(command, data, warnings) {
             const issues = data?.issues ?? [];
             lines.push(healthy ? "Doctor summary: healthy. No action required." : `Doctor summary: ${issues.length} issue(s) need attention.`);
             lines.push(`target runtime: ${String(data?.codexDir ?? "")}`);
+            if (data?.copilotRuntimeState && data.copilotRuntimeState.logPath) {
+                lines.push(`bridge log: ${String(data.copilotRuntimeState.logPath)}`);
+            }
             for (const issue of issues) {
                 lines.push(`- ${String(issue.code)}: ${String(issue.message)}`);
                 lines.push(`  next step: ${renderDoctorIssueNextStep(issue)}`);
             }
             break;
         }
+        case "bridge-start":
+            lines.push(`Bridge ready for provider ${String(data?.provider ?? "")}.`);
+            lines.push(`Endpoint: ${String(data?.baseUrl ?? "")}`);
+            lines.push(`Reused: ${String(data?.reused ?? false)}`);
+            lines.push(`Replaced existing: ${String(data?.replaced ?? false)}`);
+            if (data?.restartReason) {
+                lines.push(`Restart reason: ${String(data?.restartReason)}`);
+            }
+            if (data?.logPath) {
+                lines.push(`Bridge log: ${String(data?.logPath)}`);
+            }
+            break;
+        case "bridge-status":
+            lines.push(`Bridge provider: ${String(data?.provider ?? "")}`);
+            lines.push(`Active: ${String(data?.active ?? false)}`);
+            lines.push(`Expected base URL: ${String(data?.expectedBaseUrl ?? "")}`);
+            lines.push(`Matches runtime state: ${String(data?.matches ?? false)}`);
+            if (data?.lastRestartReason) {
+                lines.push(`Last restart reason: ${String(data?.lastRestartReason)}`);
+            }
+            if (data?.logPath) {
+                lines.push(`Bridge log: ${String(data?.logPath)}`);
+            }
+            break;
+        case "bridge-stop":
+            lines.push(`Bridge stopped for provider ${String(data?.provider ?? "(none)")}.`);
+            lines.push(`Had runtime state: ${String(data?.hadRuntimeState ?? false)}`);
+            if (data?.lastRestartReason) {
+                lines.push(`Last restart reason: ${String(data?.lastRestartReason)}`);
+            }
+            if (data?.logPath) {
+                lines.push(`Bridge log: ${String(data?.logPath)}`);
+            }
+            break;
         case "backups-list": {
             const backups = data?.backups ?? [];
             for (const backup of backups) {
@@ -344,7 +396,7 @@ function renderDoctorIssueNextStep(issue) {
         case "BRIDGE_STATE_STALE":
         case "BRIDGE_STATE_MISSING":
         case "BRIDGE_HEALTHCHECK_FAILED":
-            return "reselect the provider with `codexs switch <provider>` or inspect bridge state";
+            return "reselect the provider with `codexs switch <provider>` or inspect the bridge log/state";
         case "UNMANAGED_ACTIVE_PROFILE":
             return "switch to a managed provider or adopt the active route with `codexs migrate`";
         case "LEGACY_PROFILE_SELECTOR":

package/dist/interaction/interactive.js

@@ -70,18 +70,25 @@ function canPrompt(runtime, jsonMode) {
  */
 async function promptForProviderSelection(runtime, providersPath, configPath, message) {
     const providers = (0, providers_repo_1.readProvidersFile)(providersPath);
-    const currentModelProvider = fs.existsSync(configPath) ? (0, config_repo_1.readStructuredConfig)(configPath).currentModelProvider : null;
+    const document = fs.existsSync(configPath) ? (0, config_repo_1.readStructuredConfig)(configPath) : null;
+    const currentModelProvider = document?.currentModelProvider ?? null;
     const liveState = (0, runtime_state_1.inspectLiveStateDrift)(currentModelProvider, providers);
+    const legacyCurrentProvider = !liveState.providerResolvable &&
+        document?.legacyProfile &&
+        providers.providers[document.legacyProfile]
+        ? document.legacyProfile
+        : null;
     const choices = Object.entries(providers.providers)
         .sort(([left], [right]) => left.localeCompare(right))
         .map(([providerName, provider]) => {
         const providerType = (0, providers_1.isCopilotBridgeProvider)(provider) ? "copilot" : "direct";
         const currentMarker = liveState.providerResolvable && liveState.mappedProvider === providerName ? " | current" : "";
+        const legacyMarker = !currentMarker && legacyCurrentProvider === 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}`,
+            hint: `profile=${provider.profile} | type=${providerType}${currentMarker}${legacyMarker}${ambiguousMarker}`,
         };
     });
     if (choices.length === 0) {

package/dist/runtime/copilot-adapter.js

@@ -265,14 +265,23 @@ function createCopilotClient(sdk, runtimesDir) {
     if (!ClientCtor) {
         throw (0, errors_1.cliError)("COPILOT_SDK_API_UNSUPPORTED", "The installed Copilot SDK does not expose CopilotClient.", {});
     }
-    const invocation = (0, copilot_cli_1.resolveCopilotCliInvocation)([], runtimesDir);
-    const clientOptions = {
-        copilotCommand: invocation.command,
-        command: invocation.command,
-        executable: invocation.command,
-    };
+    const runtimeConnection = resolveRuntimeConnectionFactory(sdk);
+    if (!runtimeConnection?.forStdio) {
+        throw (0, errors_1.cliError)("COPILOT_SDK_API_UNSUPPORTED", "The installed Copilot SDK does not expose RuntimeConnection.forStdio().", {});
+    }
+    const runtimeInvocation = (0, copilot_cli_1.resolveCopilotSdkRuntimeInvocation)(runtimesDir);
+    if (!runtimeInvocation) {
+        throw (0, errors_1.cliError)("COPILOT_SDK_API_UNSUPPORTED", "The installed Copilot runtime is missing the @github/copilot npm loader required by the SDK.", {
+            expectedRuntimeFile: "node_modules/@github/copilot/npm-loader.js",
+        });
+    }
     try {
-        return new ClientCtor(clientOptions);
+        return new ClientCtor({
+            connection: runtimeConnection.forStdio({
+                path: runtimeInvocation.path,
+                args: runtimeInvocation.args,
+            }),
+        });
     }
     catch (error) {
         throw (0, errors_1.cliError)("COPILOT_SDK_API_UNSUPPORTED", "The installed Copilot SDK CopilotClient could not be constructed.", {
@@ -434,6 +443,17 @@ function resolveConstructor(target, name) {
     }
     return null;
 }
+function resolveRuntimeConnectionFactory(target) {
+    const direct = target.RuntimeConnection;
+    if (direct && typeof direct === "object") {
+        return direct;
+    }
+    const nestedDefault = target.default;
+    if (nestedDefault) {
+        return resolveRuntimeConnectionFactory(nestedDefault);
+    }
+    return null;
+}
 function resolveApproveAll(target) {
     const direct = target.approveAll;
     if (typeof direct === "function") {

package/dist/runtime/copilot-bridge-worker.js

@@ -3,6 +3,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const copilot_bridge_1 = require("./copilot-bridge");
 const copilot_adapter_1 = require("./copilot-adapter");
 let requestQueue = Promise.resolve();
+/**
+ * Writes one worker lifecycle entry to stderr so the detached parent log capture persists it.
+ */
+function logWorkerEvent(message) {
+    process.stderr.write(`[${new Date().toISOString()}] ${message}\n`);
+}
 function enqueueRequest(task) {
     const run = requestQueue.then(task, task);
     requestQueue = run.catch(() => undefined);
@@ -14,9 +20,11 @@ async function main() {
     const port = Number(process.env.CODEX_SWITCH_BRIDGE_PORT ?? "41415");
     const apiKey = process.env.CODEX_SWITCH_BRIDGE_API_KEY ?? "";
     const runtimesDir = process.env.CODEX_SWITCH_RUNTIMES_DIR || undefined;
+    logWorkerEvent(`worker startup provider=${provider} host=${host} port=${String(port)}`);
     const runtimeClient = await (0, copilot_adapter_1.createCopilotRuntimeClient)(runtimesDir);
     await (0, copilot_adapter_1.startCopilotRuntimeClient)(runtimeClient);
     const stopRuntime = () => {
+        logWorkerEvent(`worker shutdown provider=${provider}`);
         void (0, copilot_adapter_1.stopCopilotRuntimeClient)(runtimeClient).finally(() => process.exit(0));
     };
     process.once("SIGINT", stopRuntime);
@@ -41,9 +49,17 @@ async function main() {
             },
         })),
     });
+    logWorkerEvent(`worker ready provider=${provider} host=${host} port=${String(port)}`);
 }
 if (require.main === module) {
+    process.on("uncaughtException", (error) => {
+        logWorkerEvent(`worker uncaught exception: ${error.message}`);
+    });
+    process.on("unhandledRejection", (reason) => {
+        logWorkerEvent(`worker unhandled rejection: ${reason instanceof Error ? reason.message : String(reason)}`);
+    });
     void main().catch((error) => {
+        logWorkerEvent(`worker startup failure: ${error instanceof Error ? error.message : String(error)}`);
         process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
         process.exit(1);
     });

package/dist/runtime/copilot-bridge.js

@@ -50,6 +50,9 @@ const path = __importStar(require("node:path"));
 const providers_1 = require("../domain/providers");
 const errors_1 = require("../domain/errors");
 const runtime_state_repo_1 = require("../storage/runtime-state-repo");
+const BRIDGE_REUSE_ATTEMPTS = 2;
+const BRIDGE_REUSE_TIMEOUT_MS = 2500;
+const BRIDGE_REUSE_DELAY_MS = 250;
 let spawnImplementation = node_child_process_1.spawn;
 let cachedBridgeWorkerBuildId = null;
 /**
@@ -69,13 +72,17 @@ function resetCopilotBridgeSpawnImplementation() {
  */
 async function probeCopilotBridgeRuntime(provider, persistedState, runtimeDir) {
     const state = persistedState === undefined ? (0, runtime_state_repo_1.readCopilotBridgeState)(runtimeDir) : persistedState;
+    const logPath = state?.logPath ?? (0, runtime_state_repo_1.getCopilotBridgeLogPath)(runtimeDir);
     if (state && (!provider || !(0, providers_1.isCopilotBridgeProvider)(provider))) {
         return {
             ok: false,
             runtime: "copilot-bridge",
             reason: "failed",
             cause: "Copilot bridge runtime state exists but no active Copilot bridge provider is selected.",
-            details: state,
+            details: {
+                ...state,
+                logPath,
+            },
         };
     }
     if (!provider || !(0, providers_1.isCopilotBridgeProvider)(provider)) {
@@ -100,6 +107,7 @@ async function probeCopilotBridgeRuntime(provider, persistedState, runtimeDir) {
             cause: "Copilot bridge state manifest is missing.",
             details: {
                 expectedBaseUrl: (0, providers_1.buildCopilotBridgeBaseUrl)(runtime),
+                logPath,
             },
         };
     }
@@ -112,27 +120,44 @@ async function probeCopilotBridgeRuntime(provider, persistedState, runtimeDir) {
             details: {
                 stateBaseUrl: state.baseUrl,
                 providerBaseUrl: (0, providers_1.buildCopilotBridgeBaseUrl)(runtime),
+                logPath,
             },
         };
     }
-    const healthy = await healthcheckCopilotBridge(state.host, state.port);
+    const healthy = await probeBridgeEndpoint({
+        host: state.host,
+        port: state.port,
+        stage: "health",
+    });
     if (!healthy.ok) {
         return {
             ok: false,
             runtime: "copilot-bridge",
             reason: "failed",
-            cause: healthy.cause,
-            details: state,
+            cause: healthy.message,
+            details: {
+                ...state,
+                logPath,
+                probeStage: healthy.stage,
+                probeCause: healthy.cause,
+                retryable: healthy.retryable,
+            },
         };
     }
     (0, runtime_state_repo_1.writeCopilotBridgeState)({
         ...state,
         lastHealthcheckAt: new Date().toISOString(),
+        lastProbeAt: new Date().toISOString(),
+        logPath,
     }, runtimeDir);
     return {
         ok: true,
         runtime: "copilot-bridge",
-        details: state,
+        details: {
+            ...state,
+            logPath,
+            lastProbeAt: new Date().toISOString(),
+        },
     };
 }
 /**
@@ -160,47 +185,50 @@ async function startOrReuseCopilotBridge(providerName, provider, runtimeDir, run
     const current = (0, runtime_state_repo_1.readCopilotBridgeState)(runtimeDir);
     const workerBuildId = getCopilotBridgeWorkerBuildId();
     let replaced = false;
-    if (current && current.provider === providerName && current.baseUrl === expectedBaseUrl) {
-        if (current.workerBuildId === workerBuildId) {
-            const healthy = await healthcheckCopilotBridge(current.host, current.port);
-            if (healthy.ok) {
-                const compatible = await verifyCopilotBridgeAuthorization(current.host, current.port, provider.apiKey);
-                if (compatible.ok) {
-                    (0, runtime_state_repo_1.writeCopilotBridgeState)({
-                        ...current,
-                        lastHealthcheckAt: new Date().toISOString(),
-                        workerBuildId,
-                    }, runtimeDir);
-                    return {
-                        baseUrl: expectedBaseUrl,
-                        host: current.host,
-                        port: current.port,
-                        reused: true,
-                        portChanged: false,
-                        replaced: false,
-                    };
-                }
-            }
-            stopCopilotBridge(runtimeDir);
-            replaced = true;
-        }
-        else {
-            stopCopilotBridge(runtimeDir);
-            replaced = true;
-        }
+    const logPath = current?.logPath ?? (0, runtime_state_repo_1.getCopilotBridgeLogPath)(runtimeDir);
+    const reuseDecision = await evaluateBridgeReuse({
+        current,
+        providerName,
+        expectedBaseUrl,
+        expectedApiKey: provider.apiKey,
+        workerBuildId,
+        runtimeDir,
+        logPath,
+    });
+    if (reuseDecision.reuse) {
+        (0, runtime_state_repo_1.writeCopilotBridgeState)({
+            ...current,
+            lastHealthcheckAt: new Date().toISOString(),
+            lastProbeAt: reuseDecision.probeAt,
+            workerBuildId,
+            logPath: reuseDecision.logPath,
+        }, runtimeDir);
+        appendBridgeLifecycleLog(logPath, `startup success reused provider=${providerName} host=${current.host} port=${String(current.port)}`);
+        return {
+            baseUrl: expectedBaseUrl,
+            host: current.host,
+            port: current.port,
+            reused: true,
+            portChanged: false,
+            replaced: false,
+            logPath: reuseDecision.logPath,
+        };
     }
-    if (current && current.provider !== providerName) {
+    if (reuseDecision.replacedExisting) {
         stopCopilotBridge(runtimeDir);
         replaced = true;
+        appendBridgeLifecycleLog(logPath, `replacement reason=${reuseDecision.reason}`);
     }
     const selectedPort = await selectBridgePort(runtime.bridgeHost, runtime.bridgePort);
     const selectedBaseUrl = `http://${runtime.bridgeHost}:${selectedPort}${runtime.bridgePath}`;
     const workerPath = path.join(__dirname, "copilot-bridge-worker.js");
+    ensureBridgeLogFile(logPath);
+    appendBridgeLifecycleLog(logPath, `worker start provider=${providerName} host=${runtime.bridgeHost} port=${String(selectedPort)} replaced=${String(replaced)}`);
     let child;
     try {
         child = spawnImplementation(process.execPath, [workerPath], {
             detached: true,
-            stdio: "ignore",
+            stdio: ["ignore", openBridgeLogFd(logPath), openBridgeLogFd(logPath)],
             env: {
                 ...process.env,
                 CODEX_SWITCH_BRIDGE_PROVIDER: providerName,
@@ -210,6 +238,7 @@ async function startOrReuseCopilotBridge(providerName, provider, runtimeDir, run
                 CODEX_SWITCH_BRIDGE_BASE_URL: selectedBaseUrl,
                 CODEX_SWITCH_RUNTIME_DIR: runtimeDir ?? "",
                 CODEX_SWITCH_RUNTIMES_DIR: runtimesDir ?? "",
+                CODEX_SWITCH_BRIDGE_LOG_PATH: logPath,
             },
         });
     }
@@ -218,6 +247,12 @@ async function startOrReuseCopilotBridge(providerName, provider, runtimeDir, run
             provider: providerName,
             host: runtime.bridgeHost,
             port: selectedPort,
+            logPath,
+            probeStage: "startup",
+            probeCause: "startup-failed",
+            retryable: false,
+            replacedExisting: replaced,
+            providerName,
             cause: error instanceof Error ? error.message : String(error),
         });
     }
@@ -228,17 +263,29 @@ async function startOrReuseCopilotBridge(providerName, provider, runtimeDir, run
     if (!healthy.ok) {
         (0, runtime_state_repo_1.clearCopilotBridgeState)(runtimeDir);
         if (healthy.reason === "start-failed") {
+            appendBridgeLifecycleLog(logPath, `startup failure provider=${providerName} cause=${healthy.cause}`);
             throw (0, errors_1.cliError)("BRIDGE_START_FAILED", "Copilot bridge worker exited before becoming healthy.", {
                 provider: providerName,
                 host: runtime.bridgeHost,
                 port: selectedPort,
+                logPath,
+                probeStage: "startup",
+                probeCause: "startup-failed",
+                retryable: false,
+                replacedExisting: replaced,
                 cause: healthy.cause,
             });
         }
+        appendBridgeLifecycleLog(logPath, `startup timeout provider=${providerName} host=${runtime.bridgeHost} port=${String(selectedPort)}`);
         throw (0, errors_1.cliError)("BRIDGE_HEALTHCHECK_FAILED", "Copilot bridge did not become healthy after startup.", {
             provider: providerName,
             host: runtime.bridgeHost,
             port: selectedPort,
+            logPath,
+            probeStage: "startup",
+            probeCause: "startup-timeout",
+            retryable: true,
+            replacedExisting: replaced,
             cause: healthy.cause,
         });
     }
@@ -251,8 +298,12 @@ async function startOrReuseCopilotBridge(providerName, provider, runtimeDir, run
         startedAt,
         lastHealthcheckAt: new Date().toISOString(),
         workerBuildId,
+        logPath,
+        lastProbeAt: new Date().toISOString(),
+        lastRestartReason: reuseDecision.reuse ? undefined : reuseDecision.reason,
     };
     (0, runtime_state_repo_1.writeCopilotBridgeState)(state, runtimeDir);
+    appendBridgeLifecycleLog(logPath, `startup success provider=${providerName} host=${runtime.bridgeHost} port=${String(selectedPort)}`);
     return {
         baseUrl: selectedBaseUrl,
         host: runtime.bridgeHost,
@@ -260,6 +311,8 @@ async function startOrReuseCopilotBridge(providerName, provider, runtimeDir, run
         reused: false,
         portChanged: selectedPort !== runtime.bridgePort,
         replaced,
+        logPath,
+        restartReason: replaced ? reuseDecision.reason : undefined,
     };
 }
 /**
@@ -353,6 +406,9 @@ function createCopilotBridgeRequestHandler(context) {
                     });
                     clearInterval(heartbeat);
                     const outputText = text || getChatCompletionText(payload);
+                    if (text.length === 0 && outputText.length > 0) {
+                        writeResponsesTextDelta(response, messageId, outputText);
+                    }
                     writeResponsesStreamDone(response, responseId, normalized.model, messageId, outputText);
                     response.end();
                     return;
@@ -809,9 +865,9 @@ function startCopilotBridgeServer(args) {
  */
 async function waitForCopilotBridgeHealth(host, port, attempts = 10, delayMs = 150) {
     for (let index = 0; index < attempts; index += 1) {
-        const result = await healthcheckCopilotBridge(host, port);
+        const result = await probeBridgeEndpoint({ host, port, stage: "health" });
         if (result.ok) {
-            return result;
+            return { ok: true };
         }
         await new Promise((resolve) => setTimeout(resolve, delayMs));
     }
@@ -896,9 +952,9 @@ async function waitForCopilotBridgeStartup(child, host, port, attempts, delayMs)
                     cause: startupFailure,
                 };
             }
-            const result = await healthcheckCopilotBridge(host, port);
+            const result = await probeBridgeEndpoint({ host, port, stage: "health" });
             if (result.ok) {
-                return result;
+                return { ok: true };
             }
             await new Promise((resolve) => setTimeout(resolve, delayMs));
         }
@@ -920,74 +976,222 @@ async function waitForCopilotBridgeStartup(child, host, port, attempts, delayMs)
         child.off("exit", onExit);
     }
 }
-async function healthcheckCopilotBridge(host, port) {
-    return new Promise((resolve) => {
-        const request = http.request({
-            host,
-            port,
-            method: "GET",
-            path: "/healthz",
-            timeout: 1000,
-        }, (response) => {
-            response.resume();
-            if (response.statusCode === 200) {
-                resolve({ ok: true });
-                return;
-            }
-            resolve({
+async function evaluateBridgeReuse(args) {
+    const probeAt = new Date().toISOString();
+    if (!args.current) {
+        return {
+            reuse: false,
+            reason: "no persisted bridge state",
+            replacedExisting: false,
+            probeAt,
+            logPath: args.logPath,
+        };
+    }
+    if (args.current.provider !== args.providerName) {
+        return {
+            reuse: false,
+            reason: `provider mismatch: ${args.current.provider} -> ${args.providerName}`,
+            replacedExisting: true,
+            probeAt,
+            logPath: args.logPath,
+            probe: {
                 ok: false,
-                cause: `Health endpoint returned status ${String(response.statusCode ?? 0)}.`,
-            });
-        });
-        request.on("error", (error) => {
-            resolve({
+                stage: "health",
+                attempts: 0,
+                cause: "provider-mismatch",
+                retryable: false,
+                message: "Persisted bridge provider does not match the requested provider.",
+            },
+        };
+    }
+    if (args.current.baseUrl !== args.expectedBaseUrl) {
+        return {
+            reuse: false,
+            reason: `base URL mismatch: ${args.current.baseUrl} -> ${args.expectedBaseUrl}`,
+            replacedExisting: true,
+            probeAt,
+            logPath: args.logPath,
+            probe: {
                 ok: false,
-                cause: error.message,
-            });
-        });
-        request.on("timeout", () => {
-            request.destroy(new Error("Health endpoint timed out."));
-        });
-        request.end();
+                stage: "health",
+                attempts: 0,
+                cause: "base-url-mismatch",
+                retryable: false,
+                message: "Persisted bridge base URL does not match the requested provider runtime base URL.",
+            },
+        };
+    }
+    if (args.current.workerBuildId !== args.workerBuildId) {
+        return {
+            reuse: false,
+            reason: "worker build changed",
+            replacedExisting: true,
+            probeAt,
+            logPath: args.logPath,
+            probe: {
+                ok: false,
+                stage: "health",
+                attempts: 0,
+                cause: "worker-build-stale",
+                retryable: false,
+                message: "Persisted bridge worker build is stale.",
+            },
+        };
+    }
+    const health = await probeBridgeEndpoint({
+        host: args.current.host,
+        port: args.current.port,
+        stage: "health",
+    });
+    appendBridgeLifecycleLog(args.logPath, `probe stage=health attempts=${String(health.attempts)} ok=${String(health.ok)}${health.ok ? "" : ` retryable=${String(health.retryable)} cause=${health.cause}`}`);
+    if (!health.ok) {
+        return {
+            reuse: false,
+            reason: `health probe failed: ${health.message}`,
+            replacedExisting: true,
+            probeAt,
+            logPath: args.logPath,
+            probe: health,
+        };
+    }
+    const auth = await probeBridgeEndpoint({
+        host: args.current.host,
+        port: args.current.port,
+        stage: "auth",
+        apiKey: args.expectedApiKey,
     });
+    appendBridgeLifecycleLog(args.logPath, `probe stage=auth attempts=${String(auth.attempts)} ok=${String(auth.ok)}${auth.ok ? "" : ` retryable=${String(auth.retryable)} cause=${auth.cause}`}`);
+    if (!auth.ok) {
+        return {
+            reuse: false,
+            reason: `auth probe failed: ${auth.message}`,
+            replacedExisting: true,
+            probeAt,
+            logPath: args.logPath,
+            probe: auth,
+        };
+    }
+    return {
+        reuse: true,
+        health,
+        auth,
+        probeAt,
+        logPath: args.logPath,
+    };
 }
-/**
- * Checks whether a healthy bridge still accepts the provider's current bearer secret.
- */
-async function verifyCopilotBridgeAuthorization(host, port, apiKey) {
+async function probeBridgeEndpoint(args) {
+    for (let attempt = 1; attempt <= BRIDGE_REUSE_ATTEMPTS; attempt += 1) {
+        const result = await requestBridgeProbe(args);
+        if (result.ok) {
+            return {
+                ok: true,
+                stage: args.stage,
+                attempts: attempt,
+            };
+        }
+        if (!result.retryable || attempt === BRIDGE_REUSE_ATTEMPTS) {
+            return {
+                ...result,
+                stage: args.stage,
+                attempts: attempt,
+            };
+        }
+        await new Promise((resolve) => setTimeout(resolve, BRIDGE_REUSE_DELAY_MS));
+    }
+    return {
+        ok: false,
+        stage: args.stage,
+        attempts: BRIDGE_REUSE_ATTEMPTS,
+        cause: "transport-timeout",
+        retryable: true,
+        message: "Bridge probe timed out.",
+    };
+}
+async function requestBridgeProbe(args) {
     return new Promise((resolve) => {
         const request = http.request({
-            host,
-            port,
+            host: args.host,
+            port: args.port,
             method: "GET",
-            path: "/v1/models",
-            timeout: 1000,
-            headers: {
-                authorization: `Bearer ${apiKey}`,
-            },
+            path: args.stage === "health" ? "/healthz" : "/v1/models",
+            timeout: BRIDGE_REUSE_TIMEOUT_MS,
+            headers: args.stage === "auth"
+                ? {
+                    authorization: `Bearer ${args.apiKey ?? ""}`,
+                }
+                : undefined,
         }, (response) => {
             response.resume();
             if (response.statusCode === 200) {
                 resolve({ ok: true });
                 return;
             }
+            if (args.stage === "auth" && (response.statusCode === 401 || response.statusCode === 403)) {
+                resolve({
+                    ok: false,
+                    cause: "auth-rejected",
+                    retryable: false,
+                    statusCode: response.statusCode,
+                    message: `Authorization probe returned status ${String(response.statusCode)}.`,
+                });
+                return;
+            }
             resolve({
                 ok: false,
-                cause: `Authorization probe returned status ${String(response.statusCode ?? 0)}.`,
+                cause: args.stage === "health" ? "health-non-200" : "transport-error",
+                retryable: false,
+                statusCode: response.statusCode,
+                message: args.stage === "health"
+                    ? `Health endpoint returned status ${String(response.statusCode ?? 0)}.`
+                    : `Authorization probe returned status ${String(response.statusCode ?? 0)}.`,
             });
         });
         request.on("error", (error) => {
+            const classified = classifyProbeTransportError(error);
             resolve({
                 ok: false,
-                cause: error.message,
+                cause: classified.cause,
+                retryable: classified.retryable,
+                message: error.message,
             });
         });
         request.on("timeout", () => {
-            request.destroy(new Error("Authorization probe timed out."));
+            request.destroy(new Error(args.stage === "health" ? "Health endpoint timed out." : "Authorization probe timed out."));
         });
         request.end();
     });
 }
+function classifyProbeTransportError(error) {
+    const message = error.message.toLowerCase();
+    if (message.includes("timed out") ||
+        message.includes("econnrefused") ||
+        message.includes("econnreset") ||
+        message.includes("socket hang up") ||
+        message.includes("epipe")) {
+        return {
+            cause: message.includes("timed out") ? "transport-timeout" : "transport-error",
+            retryable: true,
+        };
+    }
+    return {
+        cause: "transport-error",
+        retryable: false,
+    };
+}
+function ensureBridgeLogFile(logPath) {
+    fs.mkdirSync(path.dirname(logPath), { recursive: true });
+    if (!fs.existsSync(logPath)) {
+        fs.writeFileSync(logPath, "", "utf8");
+    }
+}
+function openBridgeLogFd(logPath) {
+    ensureBridgeLogFile(logPath);
+    return fs.openSync(logPath, "a");
+}
+function appendBridgeLifecycleLog(logPath, message) {
+    ensureBridgeLogFile(logPath);
+    fs.appendFileSync(logPath, `[${new Date().toISOString()}] ${message}\n`, "utf8");
+}
 async function readJsonBody(request) {
     const chunks = [];
     for await (const chunk of request) {

package/dist/runtime/copilot-cli.js

@@ -37,6 +37,7 @@ exports.setCopilotCliSpawnImplementation = setCopilotCliSpawnImplementation;
 exports.resetCopilotCliSpawnImplementation = resetCopilotCliSpawnImplementation;
 exports.checkCopilotCliAvailable = checkCopilotCliAvailable;
 exports.resolveCopilotCliInvocation = resolveCopilotCliInvocation;
+exports.resolveCopilotSdkRuntimeInvocation = resolveCopilotSdkRuntimeInvocation;
 exports.runCopilotLogin = runCopilotLogin;
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
@@ -85,6 +86,20 @@ function checkCopilotCliAvailable(runtimesDir) {
 function resolveCopilotCliInvocation(args = [], runtimesDir) {
     return getCopilotInvocation(args, runtimesDir);
 }
+/**
+ * Resolves the explicit runtime entrypoint required by the Copilot SDK.
+ */
+function resolveCopilotSdkRuntimeInvocation(runtimesDir) {
+    const installDir = (0, copilot_installer_1.getCopilotRuntimeInstallDir)(runtimesDir);
+    const loaderPath = path.join(installDir, "node_modules", "@github", "copilot", "npm-loader.js");
+    if (!fs.existsSync(loaderPath)) {
+        return null;
+    }
+    return {
+        path: loaderPath,
+        args: [],
+    };
+}
 /**
  * Launches the official `copilot login` flow in the current terminal.
  */

package/dist/storage/runtime-state-repo.js

@@ -34,6 +34,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getCopilotBridgeStatePath = getCopilotBridgeStatePath;
+exports.getCopilotBridgeLogPath = getCopilotBridgeLogPath;
 exports.readCopilotBridgeState = readCopilotBridgeState;
 exports.inspectCopilotBridgeState = inspectCopilotBridgeState;
 exports.writeCopilotBridgeState = writeCopilotBridgeState;
@@ -54,6 +55,13 @@ function getCopilotBridgeStatePath(runtimeDir) {
     const baseRuntimeDir = runtimeDir ? path.resolve(runtimeDir) : path.join((0, codex_paths_1.resolveCodexSwitchHome)(), "runtime");
     return path.join(baseRuntimeDir, "copilot-bridge-state.json");
 }
+/**
+ * Returns the persisted bridge runtime log path colocated with the bridge state manifest.
+ */
+function getCopilotBridgeLogPath(runtimeDir) {
+    const statePath = getCopilotBridgeStatePath(runtimeDir);
+    return path.join(path.dirname(statePath), "copilot-bridge.log");
+}
 /**
  * Reads the Copilot bridge state manifest when present.
  */

package/docs/Design/codex-switch-v0.1.3-design.md

@@ -0,0 +1,10 @@
+# codex-switch v0.1.3 Design
+
+`0.1.3` is a targeted Copilot login compatibility repair release.
+
+## Design Notes
+
+- The SDK adapter constructs `CopilotClient` through `RuntimeConnection.forStdio({ path })`.
+- The runtime path passed to the SDK resolves to the managed `@github/copilot/npm-loader.js` entrypoint.
+- Human terminal commands such as `copilot --help` and `copilot login` continue to use the bundled `.bin` shim so interactive onboarding behavior remains unchanged.
+- The release adds regression coverage for the constructor compatibility path and runtime loader resolution.

package/docs/Design/codex-switch-v0.1.4-design.md

@@ -0,0 +1,18 @@
+# codex-switch v0.1.4 Design
+
+`0.1.4` is a bridge reliability and observability repair release.
+
+## Design Notes
+
+- Bridge reuse probing is refactored into a structured probe helper that distinguishes transient transport failures from deterministic mismatches.
+- Health and auth reuse probes use 2 attempts, a 2500 ms per-request timeout, and a 250 ms delay between attempts.
+- Existing bridge workers are retried before replacement only for transient timeout and transport failures. Deterministic mismatches still replace immediately: different provider, different base URL, stale worker build, or explicit `401`/`403` auth rejection.
+- Bridge worker stdout/stderr are appended to a persisted runtime log file under the managed runtime-state directory, and that log path is surfaced in bridge results and bridge-related errors.
+- Parent-side lifecycle logging records probe attempts, transient failures, replacement reasons, worker start, startup timeout, startup failure, and startup success without logging secrets.
+- Worker-side stderr logging records startup, shutdown, uncaught exception, and unhandled rejection.
+- The shared test runner discovers `tests/*.spec.js` in sorted order, excludes helper files, and supports both suite export styles already present in the repository: `{ run }` and `{ name, tests: [...] }`.
+- Interactive provider selection uses the structured config once and resolves the visible current hint in this order:
+  1. unique managed mapping from top-level `model_provider`
+  2. fallback to legacy top-level `profile` when top-level `model_provider` is missing or unresolved and the legacy value exactly matches one provider name
+  3. ambiguous marker when multiple providers share the active `model_provider`
+  4. no marker otherwise

package/docs/PRD/codex-switch-prd-v0.1.3.md

@@ -0,0 +1,22 @@
+# codex-switch v0.1.3 PRD
+
+## Version
+
+- Version line: `0.1.3`
+- Current repository package version: `0.1.3`
+
+## Summary
+
+`0.1.3` is a narrow hotfix release for the broken `login copilot` path. The goal is to restore compatibility with the currently supported official Copilot SDK/runtime pairing without expanding the command surface or the experimental Copilot bridge scope.
+
+## Required Outcome
+
+- `codexs login copilot` must no longer fail during `CopilotClient` construction when the managed SDK/runtime is installed.
+- The SDK integration must explicitly point at the managed Copilot runtime loader instead of relying on implicit package discovery.
+- Existing direct-provider behavior and Copilot bridge behavior remain unchanged outside the constructor compatibility fix.
+
+## Non-Goals
+
+- No new Copilot features or new upstream families.
+- No migration shims or backward-compatibility preservation for older local experimental runtime state.
+- No changes to the managed SDK pin or Node version requirements.

package/docs/PRD/codex-switch-prd-v0.1.4.md

@@ -0,0 +1,37 @@
+# codex-switch v0.1.4 PRD
+
+## Version
+
+- Version line: `0.1.4`
+- Target repository package version: `0.1.4`
+
+## Summary
+
+`0.1.4` is a bridge stability and observability release. It is a narrow reliability bridge between the existing Copilot bridge experiment and a stricter release gate, with no new provider families or migration behavior.
+
+## Required Outcome
+
+- Copilot bridge reuse must survive one transient health or auth probe failure before the existing worker is replaced.
+- Bridge failures must expose actionable evidence, including the persisted runtime log path and the restart reason when an old worker is recycled.
+- `npm test` must become the widened real release gate by discovering and running the broader repository suite set already present under `tests/`.
+- Interactive provider selection must restore the visible `current` hint for legacy state where only the top-level `profile` is present and `model_provider` is absent.
+
+## Release Scope
+
+- Bridge reuse probe hardening for transient transport and timeout failures.
+- Bridge log persistence and surfaced restart metadata across command results and diagnostics.
+- Widened test-runner coverage plus any pre-existing red paths that block the widened suite from becoming the real ship gate.
+- Interactive current-marker repair for legacy top-level `profile` fallback.
+
+## Non-Goals
+
+- No new provider families.
+- No migration or backward-compatibility shims beyond the prompt-only legacy `profile` hint fallback.
+- No command-surface expansion outside the new bridge diagnostics and status fields.
+
+## Release Acceptance
+
+- `switch` no longer flaps on one transient bridge probe failure.
+- Bridge startup or reuse failures surface the log path and the worker replacement reason when applicable.
+- `npm test` executes the widened deterministic suite set and passes.
+- Interactive provider selection correctly marks the current provider from legacy top-level `profile` state when top-level `model_provider` is absent or unresolved.

package/docs/Tests/testing.md

@@ -1,6 +1,8 @@
 # codex-switch Testing Guide
 
 This guide records the current `0.1.x` verification contract for release and review work.
+
+The current repository line is `0.1.4` and remains an unreleased development line until an explicit release task says otherwise.
 
 ## Required checks
 
@@ -22,7 +24,8 @@ node dist/cli.js --version
 - Ambiguous active profile: `list`, `status`, and provider pickers must surface ambiguity instead of inventing a unique current provider
 - `--json` envelope: top-level `ok`, `command`, `data`, `warnings`, and `error` must remain stable
 - `migrate`: advanced adopt helper only
-- `setup`: deprecated entry only
+- `setup`: deprecated entry only
+- Release hygiene: `package.json`, `package-lock.json`, current-line docs, changelog top entry, and current PRD/Design fact sources must agree on the `0.1.4` development line
 
 ## Fixture guidance
 

package/docs/cli-usage.md

@@ -1,6 +1,6 @@
 # codex-switch CLI Usage
 
-This document describes the current `0.1.2` CLI contract for `@minniexcode/codex-switch`, including the Copilot runtime repair boundary.
+This document describes the current `0.1.4` repository development-line CLI contract for `@minniexcode/codex-switch`, including the bridge stability and observability boundary.
 
 Executable command name:
 
@@ -10,9 +10,9 @@ codexs
 
 ## 1. Version Context
 
-The current package version in this repository is `0.1.2`.
+The current package version in this repository is `0.1.4`.
 
-This release line targets Codex `0.134.0+`. The public contract assumes runtime routing is selected by top-level `model` plus `model_provider`, while legacy `profile` and `[profiles.*]` remain inspect-and-adopt inputs instead of the recommended runtime path.
+This release line targets Codex `0.134.0+`. The public contract assumes runtime routing is selected by top-level `model` plus `model_provider`, while legacy `profile` and `[profiles.*]` remain inspect-and-adopt inputs instead of the recommended runtime path. The current `0.1.4` development line tightens bridge reliability and release-hygiene verification without expanding the provider command surface.
 
 ## 2. Primary Workflows
 
@@ -287,4 +287,8 @@ codexs rollback [backup-id]
 - [PRD 0.1.0](./PRD/codex-switch-prd-v0.1.0.md)
 - [PRD 0.1.1](./PRD/codex-switch-prd-v0.1.1.md)
 - [PRD 0.1.2](./PRD/codex-switch-prd-v0.1.2.md)
+- [PRD 0.1.3](./PRD/codex-switch-prd-v0.1.3.md)
+- [PRD 0.1.4](./PRD/codex-switch-prd-v0.1.4.md)
 - [Design 0.1.2](./Design/codex-switch-v0.1.2-design.md)
+- [Design 0.1.3](./Design/codex-switch-v0.1.3-design.md)
+- [Design 0.1.4](./Design/codex-switch-v0.1.4-design.md)

package/docs/codex-switch-product-overview.md

@@ -4,13 +4,17 @@
 
 这份文档介绍当前活跃产品事实源下的 `codex-switch` 产品定位。
 
-当前稳定 release contract 以这些文档为准：
+当前仓库开发线 fact source 以这些文档为准：
 
 - [`cli-usage.md`](./cli-usage.md)
 - [`PRD/codex-switch-prd-v0.1.0.md`](./PRD/codex-switch-prd-v0.1.0.md)
 - [`PRD/codex-switch-prd-v0.1.1.md`](./PRD/codex-switch-prd-v0.1.1.md)
-- [`PRD/codex-switch-prd-v0.1.2.md`](./PRD/codex-switch-prd-v0.1.2.md)（规划中）
-- [`Design/codex-switch-v0.1.2-design.md`](./Design/codex-switch-v0.1.2-design.md)（规划中）
+- [`PRD/codex-switch-prd-v0.1.2.md`](./PRD/codex-switch-prd-v0.1.2.md)
+- [`PRD/codex-switch-prd-v0.1.3.md`](./PRD/codex-switch-prd-v0.1.3.md)
+- [`PRD/codex-switch-prd-v0.1.4.md`](./PRD/codex-switch-prd-v0.1.4.md)
+- [`Design/codex-switch-v0.1.2-design.md`](./Design/codex-switch-v0.1.2-design.md)
+- [`Design/codex-switch-v0.1.3-design.md`](./Design/codex-switch-v0.1.3-design.md)
+- [`Design/codex-switch-v0.1.4-design.md`](./Design/codex-switch-v0.1.4-design.md)
 
 ## 产品概述
 
@@ -88,4 +92,4 @@ codexs migrate
 - `status` / `doctor` 如何帮助定位下一步
 - 当前运行态是用顶层 `model` 与 `model_provider` 选择活动路由
 
-`0.1.2` 是规划中的 Copilot runtime 修复线，不是当前已发布包版本。当前实现边界是：Copilot 路径要求 Node.js `>=20`，受管安装默认固定到 `@github/copilot-sdk@1.0.2`，运行时会额外拒绝过旧版本和 prerelease 版本，并在真正创建 client 或 session 时验证 SDK API shape；本地 bridge 仍然只是面向 simple text-oriented turns 的 experimental bridge。Direct provider 路径继续支持 Node.js `>=18`。
+`0.1.4` 是当前仓库开发线，重点不是扩展 provider 面，而是把已有 Copilot bridge 实验路径变得更稳、更可诊断，并把 release hygiene 拉进真实门禁。当前实现边界仍然是：Copilot 路径要求 Node.js `>=20`，受管安装默认固定到 `@github/copilot-sdk@1.0.2`，本地 bridge 仍然只是面向 simple text-oriented turns 的 experimental bridge；Direct provider 路径继续支持 Node.js `>=18`。

package/docs/codex-switch-technical-architecture.md

@@ -5,10 +5,14 @@
 - [`cli-usage.md`](./cli-usage.md)
 - [`PRD/codex-switch-prd-v0.1.0.md`](./PRD/codex-switch-prd-v0.1.0.md)
 - [`PRD/codex-switch-prd-v0.1.1.md`](./PRD/codex-switch-prd-v0.1.1.md)
-- [`PRD/codex-switch-prd-v0.1.2.md`](./PRD/codex-switch-prd-v0.1.2.md) (planned)
+- [`PRD/codex-switch-prd-v0.1.2.md`](./PRD/codex-switch-prd-v0.1.2.md)
+- [`PRD/codex-switch-prd-v0.1.3.md`](./PRD/codex-switch-prd-v0.1.3.md)
+- [`PRD/codex-switch-prd-v0.1.4.md`](./PRD/codex-switch-prd-v0.1.4.md)
 - [`Design/codex-switch-v0.1.0-design.md`](./Design/codex-switch-v0.1.0-design.md)
 - [`Design/codex-switch-v0.1.1-design.md`](./Design/codex-switch-v0.1.1-design.md)
-- [`Design/codex-switch-v0.1.2-design.md`](./Design/codex-switch-v0.1.2-design.md) (planned)
+- [`Design/codex-switch-v0.1.2-design.md`](./Design/codex-switch-v0.1.2-design.md)
+- [`Design/codex-switch-v0.1.3-design.md`](./Design/codex-switch-v0.1.3-design.md)
+- [`Design/codex-switch-v0.1.4-design.md`](./Design/codex-switch-v0.1.4-design.md)
 
 ## Layers
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@minniexcode/codex-switch",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Local-first CLI for managing and switching Codex provider/model-provider routing.",
   "license": "MIT",
   "type": "commonjs",