@codextheme/cli 0.2.9 → 0.2.10

package/README.md

@@ -5,13 +5,13 @@ Fixed-version, one-command curated and private custom skins for Codex Desktop on
 Apply a catalog skin:
 
 ```sh
-npx --yes @codextheme/cli@0.2.9 apply cathedral-nocturne
+npx --yes @codextheme/cli@0.2.10 apply cathedral-nocturne
 ```
 
 The custom skin studio at [codextheme.tech](https://codextheme.tech) creates an expiring private command:
 
 ```sh
-npx --yes @codextheme/cli@0.2.9 apply-private <private-id>
+npx --yes @codextheme/cli@0.2.10 apply-private <private-id>
 ```
 
 Private packages are downloaded only from the fixed `https://codextheme.tech` origin, bounded, integrity-checked, schema-validated, safety-linted, and cached locally with owner-only permissions. The temporary server link expires after 24 hours; `reapply` uses the validated local cache and works after that link expires.
@@ -19,10 +19,10 @@ Private packages are downloaded only from the fixed `https://codextheme.tech` or
 The CLI emits and applies only CodexTheme-owned package and renderer names. Historical cached packages are normalized by the runtime compatibility layer without exposing the former namespace in normal command output.
 
 ```sh
-npx --yes @codextheme/cli@0.2.9 reapply
-npx --yes @codextheme/cli@0.2.9 restore
+npx --yes @codextheme/cli@0.2.10 reapply
+npx --yes @codextheme/cli@0.2.10 restore
 ```
 
-The CLI has no install scripts, does not use `sudo`, and does not modify the Codex application bundle. Requirements: macOS, Node.js 22.4+, and Codex Desktop. A running Codex process is never closed or reopened without an explicit `y` confirmation. After confirmation, version 0.2.9 uses an owner-only detached one-shot worker so an apply started inside Codex survives that restart; it does not install a persistent service.
+The CLI has no install scripts, does not use `sudo`, and does not modify the Codex application bundle. Requirements: macOS, Node.js 22.4+, and Codex Desktop. A running Codex process is never closed or reopened without an explicit `y` confirmation. After confirmation, version 0.2.10 uses an owner-only detached one-shot worker so an apply started inside Codex survives that restart; it does not install a persistent service.
 
 CodexTheme is an independent project and is not affiliated with or endorsed by OpenAI.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codextheme/cli",
-  "version": "0.2.9",
+  "version": "0.2.10",
   "description": "One-command curated and private custom skins for Codex Desktop on macOS.",
   "type": "module",
   "license": "Apache-2.0",
@@ -18,7 +18,7 @@
     "test": "node --test"
   },
   "dependencies": {
-    "@codextheme/runtime": "0.1.3"
+    "@codextheme/runtime": "0.1.4"
   },
   "engines": {
     "node": ">=22.4"

package/src/handoff-runner.mjs

@@ -3,8 +3,10 @@ import { applyPrivateTheme, applyTheme } from "./lifecycle.mjs";
 
 const PUBLIC_FAILURES = new Map([
   ["E_CODEX_NOT_FOUND", "没有找到已安装的 Codex Desktop。"],
+  ["E_RESTART_FAILED", "重新打开 Codex 时，旧进程或本机调试端口未能及时释放。"],
   ["E_DOM_INCOMPATIBLE", "当前 Codex 界面结构与该主题暂不兼容。"],
   ["E_CORE_VERIFY", "主题应用后的完整性验证失败。"],
+  ["E_RUNTIME_FAILED", "Codex 主题运行时未能完成本次操作。"],
   ["E_PRIVATE_CACHE", "无法安全读取本地私有主题缓存。"],
   ["E_RESTORE_FAILED", "主题应用失败，且未能完整恢复 Codex 官方外观。"],
   ["E_HANDOFF_BUSY", "已有一个 Codex 重启任务正在处理。"],

package/src/lifecycle.mjs

@@ -11,12 +11,16 @@ function mappedError(error) {
   switch (error?.code) {
     case "CODEXTHEME_RESTART_REQUIRED":
       return new CliError("E_RESTART_REQUIRED", "需要得到你的确认后才能重新打开 Codex。");
+    case "CODEXTHEME_SHUTDOWN_TIMEOUT":
+    case "CODEXTHEME_PORT_OCCUPIED":
+    case "CODEXTHEME_TARGET_TIMEOUT":
+      return new CliError("E_RESTART_FAILED", "重新打开 Codex 时，旧进程或本机调试端口未能及时释放。");
     case "CODEXTHEME_DOM_INCOMPATIBLE":
       return new CliError("E_DOM_INCOMPATIBLE", "当前 Codex 界面结构与该主题暂不兼容。");
     case "CODEXTHEME_VERIFY_FAILED":
       return new CliError("E_CORE_VERIFY", "主题应用后的完整性验证失败，已尝试回滚。");
     default:
-      return new CliError("E_DOM_INCOMPATIBLE", "Codex 主题运行时未能完成本次操作。");
+      return new CliError("E_RUNTIME_FAILED", "Codex 主题运行时未能完成本次操作。");
   }
 }
 

package/src/main.mjs

@@ -7,9 +7,9 @@ import { confirmRestart } from "./prompt.mjs";
 import { runtime as productionRuntime } from "./runtime.mjs";
 import { createStateStore } from "./state.mjs";
 
-export const VERSION = "0.2.9";
-const REAPPLY = "npx --yes @codextheme/cli@0.2.9 reapply";
-const RESTORE = "npx --yes @codextheme/cli@0.2.9 restore";
+export const VERSION = "0.2.10";
+const REAPPLY = "npx --yes @codextheme/cli@0.2.10 reapply";
+const RESTORE = "npx --yes @codextheme/cli@0.2.10 restore";
 
 const HELP = `CodexTheme ${VERSION}
 
@@ -33,8 +33,10 @@ function safePublicError(error) {
     "E_PLATFORM",
     "E_CODEX_NOT_FOUND",
     "E_RESTART_REQUIRED",
+    "E_RESTART_FAILED",
     "E_DOM_INCOMPATIBLE",
     "E_CORE_VERIFY",
+    "E_RUNTIME_FAILED",
     "E_RESTORE_FAILED",
     "E_PRIVATE_NOT_FOUND",
     "E_PRIVATE_EXPIRED",
@@ -45,7 +47,7 @@ function safePublicError(error) {
     "E_HANDOFF_FAILED",
   ]);
   if (allowed.has(error?.code)) return { code: error.code, message: error.message, exitCode: 1 };
-  return { code: "E_DOM_INCOMPATIBLE", message: "CodexTheme 未能完成本次操作。", exitCode: 1 };
+  return { code: "E_RUNTIME_FAILED", message: "CodexTheme 未能完成本次操作。", exitCode: 1 };
 }
 
 function writeApplyResult(stdout, result, name, successMessage, { showReapply = true } = {}) {