|
7 | 7 | - `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 |
8 | 8 | - `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` |
9 | 9 |
|
| 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 | + |
10 | 30 | ## 1.2.0 |
11 | 31 |
|
12 | 32 | - `task --resume-id <thread-id>` — resume a specific Codex thread by app-server id, mutually exclusive with `--resume-last` / `--fresh` (#230) |
|
0 commit comments