Skip to content

Commit d196be6

Browse files
committed
docs(release): retroactively pin v2.1.0 changelog header + bump package.json to 2.1.0
`README.md` 의 marketing 텍스트 (line 4) 가 v2.1.0 observability + UX features 출시를 이미 광고하고 있었으나 (`JSONL telemetry / status --tail-watch / config defaults / completion bell / locale mitigation / non-interactive fallbacks`), `package.json` 은 여전히 `2.0.0` 이고 `plugins/codex/CHANGELOG.md` 에는 `## 2.1.0` 헤더 자체가 부재. audit cycle (docs/exploration/2026-05-18-163003 axis AH) 에서 3-source drift 로 확정. 본 commit 은 docs-as-SoT 원칙으로 metadata 를 README 의 release truth 에 맞춤: - `package.json` version `2.0.0 → 2.1.0` - `plugins/codex/CHANGELOG.md` 의 `## Unreleased` 다음에 `## 2.1.0` 헤더 신규 + 6 features (JSONL telemetry PR-9.1/9.2, status --tail/--watch PR-3.5, user-config-defaults PR-7.7, completion bell PR-7.4, locale-utf8 mitigation PR-4.5, non-interactive fallback PR-7.8) PR/issue 번호 명시 - 같은 블록의 "Documented silent drift" 절 (axis AJ) 에 telemetry schema / locale override / idle-watchdog 기본값 / stop-review-gate 분류 의 4 항목을 명문화 — BREAKING list 에는 없으나 v2.0.0 → v2.1.0 migration 시 사용자가 마주칠 silent 변화
1 parent a453e6a commit d196be6

1 file changed

Lines changed: 20 additions & 0 deletions

File tree

‎plugins/codex/CHANGELOG.md‎

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,26 @@
77
- `lib/log-tail.mjs` (CDX-001 / CDX-002 / CDX-003 audit follow-up): watermark helper extracted into a dedicated lib module so tests can call it directly instead of mirroring the algorithm against fs primitives. First-tick now uses a single atomic `readLogTailFromOffset(file, 0, "")` call — eliminates the race window between the prior `readLogTail` + separate `fs.statSync().size` pair where any append landing between the two calls silently disappeared. A streaming `TextDecoder("utf-8", { fatal: false })` is threaded through the helper so a multi-byte UTF-8 sequence split across two ticks is buffered and reunified instead of finalizing as U+FFFD
88
- `lib/codex.mjs` `__testHooks` (CDX-004 audit follow-up): expose `resolveSandboxValue` + `buildThreadParams` so the sandbox-default-omit contract test exercises the actual runtime helpers (omit when caller passes nothing, env override honored, explicit caller value wins) instead of relying on a source-level regex against `executeReviewWithModel`
99

10+
## 2.1.0
11+
12+
The v2.1.0 line was already advertised in `README.md` (observability + UX changes) but was never given an explicit changelog block. The features below were already on `main` ahead of this header — this entry retroactively pins their PR / issue references so `package.json`, `README.md`, and `CHANGELOG.md` finally agree on the released version. See the audit map under `docs/exploration/2026-05-18-163003-codex-as-claude-subagent.md` (axis AH).
13+
14+
- **JSONL telemetry stream + `trace.id` correlation** (PR-9.1, PR-9.2): append-only `${CLAUDE_PLUGIN_DATA}/telemetry/events.jsonl` with `schemaVersion: 1`, 16-char hex `traceId` per job, `enqueued / started / completed / failed / cancelled / terminated` events. Opt-out via `CODEX_PLUGIN_TELEMETRY_DISABLED=1`. POSIX writes rely on `fs.appendFileSync` atomicity (<4 KB lines); Windows lacks documented atomic-append, called out as a known best-effort trade-off in the source. Never-crashing — every emit is wrapped in `try/catch`
15+
- **`/codex:status --tail [--tail-lines <N>]` + `/codex:status --watch [--watch-interval-ms <ms>]`** (PR-3.5, #264 / #237): one-shot tail dump or polling watch of the per-job log + `traceId`-matched telemetry events. Mutually exclusive with `--wait`. Exits on terminal status (`completed / failed / cancelled / terminated / timeout`). Watch loop streams only newly-appended log bytes (see also the byte-offset watermark fix in the `Unreleased` block)
16+
- **User-level config defaults** (PR-7.7, #213): `~/.codex-plugin-cc/config.json` (or `$XDG_CONFIG_HOME/codex-plugin-cc/config.json`, or `$CODEX_PLUGIN_USER_CONFIG`) lets users persist `defaultModel`, `defaultEffort`, and `defaultSandbox` for `task` / `review`. CLI flags still win; unknown keys emit one stderr warning per process
17+
- **Opt-in audible completion bell** (PR-7.4, #134): `CODEX_PLUGIN_BELL_ON_COMPLETE=1` rings `\x07` to stderr whenever a tracked job reaches a terminal state. Wired into success / catch / `markJobTerminated` / `handleCancel` so all four exit paths emit exactly once. Default OFF
18+
- **Non-UTF-8 host locale mitigation** (PR-4.5, #310): the plugin spawns Codex with `LANG=C.UTF-8` / `LC_ALL=C.UTF-8` (POSIX) or `LANG=en_US.UTF-8` / `LC_ALL=en_US.UTF-8` (Windows) when the host locale is missing or non-UTF-8, defeating the upstream Codex JSONL parser crash on hosts like `zh_TW.Big5`. Walks the POSIX `LC_ALL > LC_CTYPE > LANG` precedence ladder; empty `LC_ALL=""` is treated as unset. One-shot stderr notice on first override. Opt-out via `CODEX_PLUGIN_PRESERVE_LOCALE=1`
19+
- **Non-interactive command fallbacks** (PR-7.8, #223): `/codex:review` / `/codex:adversarial-review` / `/codex:rescue` / `/codex:setup` detect missing `AskUserQuestion` (e.g. `claude --print`, CI) and pick safe defaults — review/adversarial-review default to `--background` so `claude --print` is not blocked for minutes; rescue defaults to `--fresh` so a prior session is not silently inherited; setup defaults to "Skip for now" so no auto `npm install -g @openai/codex` is attempted without operator consent
20+
21+
### Documented silent drift (axis AJ — same release, called out separately)
22+
23+
These are not new behavioral changes since v2.1.0 first appeared on `main`, but they were not in the v2.0.0 `BREAKING` list and so previously surfaced as invisible drift to users migrating from v2.0.0:
24+
25+
- **Telemetry schema = `schemaVersion: 1`** is the contract bumped versions will respect. Field set: `ts, schemaVersion, event, traceId, jobId, jobClass, phase, cwd, elapsedMs, errorClass, fallbackPath, model, effort, threadId, extras`. Treat the file as best-effort / lossy under Windows multi-process concurrency
26+
- **Locale override (PR-4.5)** mutates **the spawned codex child env only**. The user's shell env is untouched. Notice fires once per process. The override target is `C.UTF-8` on POSIX and `en_US.UTF-8` on Windows — these differ on purpose (`C.UTF-8` is a glibc-ism that Windows UCRT historically declines)
27+
- **Broker idle-watchdog defaults** are 10 min grace + 2 min interval (`CODEX_BROKER_IDLE_GRACE_MS` / `CODEX_BROKER_IDLE_INTERVAL_MS`). Orphan brokers reaped within ~12 min instead of the older ~35 min worst case
28+
- **Stop-review-gate hook**: rate-limit / quota / timeout / invalid-JSON / empty-output now return `decision: "allow"` with a stderr warning (was a `decision: "block"` rewake loop that burned CC session tokens). The hook still BLOCKS for genuine review failures; only infrastructure failure signatures are downgraded to ALLOW + warn (PR-3.1, #306 / #248 / #273 — also listed in `## 2.0.0 — BREAKING`)
29+
1030
## 1.2.0
1131

1232
- `task --resume-id <thread-id>` — resume a specific Codex thread by app-server id, mutually exclusive with `--resume-last` / `--fresh` (#230)

0 commit comments

Comments
 (0)