oh-my-customcodex 0.5.16 → 0.5.17

package/README.md

@@ -229,9 +229,9 @@ Key rules: R010 (orchestrator never writes files), R009 (parallel execution mand
 
 ---
 
-### Guides (51)
+### Guides (52)
 
-Reference documentation covering best practices, architecture decisions, and integration patterns. Located in `guides/` at project root, covering topics from agent design to CI/CD to observability.
+Reference documentation covering best practices, architecture decisions, release compatibility, and integration patterns. Located in `guides/` at project root, covering topics from agent design to CI/CD to observability.
 
 ---
 
@@ -289,7 +289,7 @@ your-project/
 │   └── ontology/               # Knowledge graph for RAG
 ├── .agents/
 │   └── skills/                 # 121 installed skill modules
-└── guides/                     # 51 reference documents
+└── guides/                     # 52 reference documents
 ```
 
 ### Source Repository And Compatibility Surfaces

package/dist/cli/index.js

@@ -3091,7 +3091,7 @@ var init_package = __esm(() => {
     workspaces: [
       "packages/*"
     ],
-    version: "0.5.16",
+    version: "0.5.17",
     requiresCC: ">=2.1.121",
     claudeCode: {
       minimumVersion: "2.1.121",

package/dist/index.js

@@ -2316,7 +2316,7 @@ var package_default = {
   workspaces: [
     "packages/*"
   ],
-  version: "0.5.16",
+  version: "0.5.17",
   requiresCC: ">=2.1.121",
   claudeCode: {
     minimumVersion: "2.1.121",

package/package.json

@@ -3,7 +3,7 @@
   "workspaces": [
     "packages/*"
   ],
-  "version": "0.5.16",
+  "version": "0.5.17",
   "requiresCC": ">=2.1.121",
   "claudeCode": {
     "minimumVersion": "2.1.121",

package/templates/AGENTS.md.en

@@ -134,7 +134,7 @@ project/
 |   +-- contexts/                # Context files (ecomode)
 +-- .agents/
 |   +-- skills/                  # Installed skills (120 directories)
-+-- guides/                      # Reference docs (51 topics)
++-- guides/                      # Reference docs (52 topics)
 ```
 
 ## OMX Command Routing

package/templates/AGENTS.md.ko

@@ -134,7 +134,7 @@ project/
 |   +-- contexts/                # 컨텍스트 파일 (ecomode)
 +-- .agents/
 |   +-- skills/                  # 설치된 스킬 (120 디렉토리)
-+-- guides/                      # 레퍼런스 문서 (51 토픽)
++-- guides/                      # 레퍼런스 문서 (52 토픽)
 ```
 
 ## OMX 명령 라우팅

package/templates/CLAUDE.md

@@ -120,7 +120,7 @@ project/
 |   +-- contexts/                # 컨텍스트 파일 (ecomode)
 +-- .agents/
 |   +-- skills/                  # 스킬 (120 디렉토리)
-+-- guides/                      # 레퍼런스 문서 (51 토픽)
++-- guides/                      # 레퍼런스 문서 (52 토픽)
 ```
 
 ## 오케스트레이션

package/templates/CLAUDE.md.en

@@ -136,7 +136,7 @@ project/
 |   +-- rules/                   # Global rules (22 files)
 |   +-- hooks/                   # Hook scripts (security, validation, HUD)
 |   +-- contexts/                # Context files (4 files)
-+-- guides/                      # Reference docs (51 topics)
++-- guides/                      # Reference docs (52 topics)
 ```
 
 ## Orchestration

package/templates/CLAUDE.md.ko

@@ -136,7 +136,7 @@ project/
 |   +-- rules/                   # 전역 규칙 (22 파일)
 |   +-- hooks/                   # 훅 스크립트 (보안, 검증, HUD)
 |   +-- contexts/                # 컨텍스트 파일 (4 파일)
-+-- guides/                      # 레퍼런스 문서 (51 토픽)
++-- guides/                      # 레퍼런스 문서 (52 토픽)
 ```
 
 ## 오케스트레이션

package/templates/README.md

@@ -52,7 +52,7 @@ templates/
 |   +-- contexts/                     # context files
 |   +-- ontology/                     # ontology and routing metadata
 |   +-- schemas/                      # tool input schemas
-+-- guides/                           # reference docs (51 topics)
++-- guides/                           # reference docs (52 topics)
 ```
 
 ## Components
@@ -77,7 +77,7 @@ Reusable workflow and reference skill modules. During Codex installation these l
 
 Global agent behavior rules. During Codex installation these land under `.codex/rules/`.
 
-### Guides (51)
+### Guides (52)
 
 `templates/guides/*/`
 

package/templates/guides/index.yaml

@@ -20,6 +20,12 @@ guides:
     source:
       type: internal
 
+  - name: openai-codex
+    description: OpenAI Codex release compatibility decisions for Codex/OMX sessions
+    path: ./openai-codex/
+    source:
+      type: internal
+
   # Frontend
   - name: claude-design
     description: Claude Design artifact handoff workflow — connecting Anthropic's conversational design tool outputs to Claude Code's fe-design-expert implementation pipeline

package/templates/guides/openai-codex/01-version-compatibility.md

@@ -0,0 +1,21 @@
+# OpenAI Codex Version Compatibility
+
+This guide records OpenAI Codex release-note impact decisions for oh-my-customcodex. Use it for Codex/OMX runtime compatibility notes; keep Claude-only release notes in `guides/claude-code/15-version-compatibility.md`.
+
+## rust-v0.138.0 / CLI 0.138.0
+
+Source: upstream OpenAI Codex release `rust-v0.138.0`, Codex-port issue #1481.
+
+| Change | Impact on oh-my-customcodex | Action |
+| --- | --- | --- |
+| `/app` can hand off the current CLI thread into Codex Desktop on macOS and native Windows | Useful operator workflow, but not a packaged template contract. | No runtime change. Mention only when documenting Desktop handoff troubleshooting. |
+| Local image attachments and generated images expose saved file paths to the model | Helps visual iteration and image-edit follow-up references. | Keep visual workflows file-path aware; do not store generated image paths as durable release evidence unless explicitly requested. |
+| Reasoning effort shortcuts and model-advertised effort ordering improved | Aligns with OMX guidance to prefer `reasoning_effort` over hardcoded model overrides for child agents. | Preserve repo model-routing guidance; avoid stale frontier model names. |
+| App-server integrations can read account token usage and auth supports v2 personal access tokens | Useful observability/auth signal for app-server deployments, not required by this package. | Track as external runtime capability; no dependency or config change. |
+| Plugin commands gained richer `--json` output and marketplace/source metadata | Can improve future automation around plugin inventory. | Prefer JSON output when automating plugin add/remove/list/detail; keep `omcustomcodex list` as package inventory source. |
+| Workspace instruction loading is more accurate for remote and symlinked workspaces | Reduces false AGENTS.md discovery issues in Codex itself. | Keep nested AGENTS.md guidance intact and continue verifying repo-local instructions directly. |
+| Startup, MCP credential refresh, large stream processing, and TUI/goal fixes are additive stability improvements | Lower operational friction for Codex sessions. | No package change beyond this compatibility record. |
+
+## Compatibility rule
+
+OpenAI Codex release-monitor issues should be closed as no-op only when there is no repo-owned surface to update. If a release changes workflow vocabulary, diagnostics, plugin automation, AGENTS.md loading, or visual iteration evidence, record the decision here and mirror it into templates.

package/templates/guides/openai-codex/index.yaml

@@ -0,0 +1,7 @@
+# OpenAI Codex Guide Index
+
+documents:
+  - name: version-compatibility
+    title: Version compatibility
+    description: OpenAI Codex release-note impact decisions for oh-my-customcodex
+    path: ./01-version-compatibility.md

package/templates/manifest.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.5.16",
+  "version": "0.5.17",
   "requiresCC": ">=2.1.121",
   "claudeCode": {
     "minimumVersion": "2.1.121",
@@ -29,7 +29,7 @@
       "name": "guides",
       "path": "guides",
       "description": "Reference documentation",
-      "files": 51
+      "files": 52
     },
     {
       "name": "hooks",

package/templates/workflows/auto-dev.yaml

@@ -151,9 +151,11 @@ steps:
       Required version preflight for npm package releases:
       - Determine NEW_VERSION before creating a release branch, PR, or tag.
       - Update `package.json` and `templates/manifest.json` to NEW_VERSION in the same commit.
+      - Promote `CHANGELOG.md` before the release PR/tag: move non-empty `## [Unreleased]` entries into `## [NEW_VERSION] - YYYY-MM-DD`, then re-create an empty `## [Unreleased]` section above it.
+      - If `CHANGELOG.md` has no user/package-visible entry for NEW_VERSION, add a concise release summary before continuing instead of relying on GitHub auto-generated release notes.
       - Use same-directory temporary files for generated JSON writes; do not write through `/tmp`.
       - Run `bash .github/scripts/verify-version-sync.sh` after the bump and before tag or PR creation.
-      - Commit the bump with `chore(release): bump to v{NEW_VERSION}` before any release tag is created.
+      - Commit the bump and changelog promotion with `chore(release): bump to v{NEW_VERSION}` before any release tag is created.
 
       Before creating `release/v*`, check whether a local branch named exactly
       `release` exists. Git stores refs as files/directories, so