Skip to content

Codex Radar 0.4.12 Public Beta

Pre-release
Pre-release

Choose a tag to compare

View all tags
@plaonn plaonn released this 20 Jul 06:50
v0.4.12
a801a4f

Codex Radar 0.4.12 Public Beta Candidate

Codex Radar 0.4.12 packages the post-0.4.4 reliability and host-integration work as the next GitHub Release candidate. The candidate pairs VSIX 0.4.12 with helper runtime 0.4.7; the two versions remain intentionally independent.

Highlights

  • Add a reusable Codex App Server Controller for read-only thread catalog and supported account/rateLimits/read usage access.
  • Preserve the rollout usage adapter as a local fallback and parity observation source.
  • Add the Native Windows helper foundation, Windows state and locking semantics, stable .cmd shims, atomic runtime selection, and windows-latest CI coverage.
  • Add the opt-in foreground codex-radar thread rpc host and one-shot thread doctor, start, list, read, and send commands.
  • Add bounded persisted terminal-state reconciliation for missed Stop hooks and run it before foreground watch polling.
  • Stabilize sidebar interaction identity across asynchronous refreshes.
  • Classify Codex memory-maintenance sessions as Codex internal across CLI, TUI, shared export, and the VS Code direct reader without rewriting the session cache.

Candidate Assets

  • codex-radar-helper-0.4.7.zip
  • codex-radar-helper-0.4.7.zip.sha256
  • codex-radar-vscode-0.4.12.vsix

The helper bundle includes a pure-Python 0.4.7 wheel and compatibility metadata for VS Code extension versions from 0.4.3 up to, but not including, 0.5.0.

Install

After the candidate is explicitly approved and published as a GitHub Release:

  1. Download the helper bundle, adjacent checksum, and VSIX from the release.

  2. Verify the helper bundle:

    sha256sum --check codex-radar-helper-0.4.7.zip.sha256

  3. Install or upgrade the helper runtime:

    unzip codex-radar-helper-0.4.7.zip
cd codex-radar-helper-0.4.7
python3 install-helper.py install .

  4. Review the hook configuration without modifying it automatically:

    ~/.local/bin/codex-radar-helper hook-config --hooks-file ~/.codex/hooks.json

  5. Install the VSIX on the same local or Remote SSH extension host:

    code --install-extension codex-radar-vscode-0.4.12.vsix --force

Privacy and Automation Boundaries

  • Codex Radar does not edit ~/.codex/hooks.json, install hooks automatically, or send transcript/session data externally.
  • The VS Code GUI remains read-only for Codex and Radar runtime state. App-server GUI access is limited to thread metadata and rate-limit reads.
  • codex-radar thread rpc is an explicit foreground stdio surface. It does not open a network listener, install a daemon, or auto-approve command, file, or permission requests.
  • Display-state export omits raw working directories, transcript paths, transcript text, hook payloads, and private runtime paths.
  • Shared display-state export remains in observation mode by default. Export failure or schema mismatch retains the direct adapter fallback.

Current Limitations

  • The supported public-beta distribution path remains GitHub Releases, not the VS Code Marketplace or PyPI.
  • Native Windows foundation and CI are present, but Windows support is not complete until a real Codex hook updates %LOCALAPPDATA%\codex-radar\state\sessions.json and the VS Code sidebar displays the same session.
  • The published helper asset remains a POSIX public-beta path until that Native Windows smoke and a separate Windows release decision are complete.
  • Abrupt extension-host loss can leave a directly owned app-server child alive. Radar does not use process-name/PPID sweeps or an undocumented daemon/proxy to hide that boundary.
  • Same-workspace Codex handoff still uses an experimental local URI route.

Release Gate

Before publication:

  • Run the full Python unit suite and compileall.
  • Run the full VS Code extension test suite.
  • Build and inspect the 0.4.7 wheel and helper bundle.
  • Build and inspect the 0.4.12 VSIX.
  • Confirm artifact filenames and embedded manifest versions.
  • Complete an extension-host smoke with the current helper and VSIX.
  • Obtain explicit approval before creating the GitHub Release.

한국어

Codex Radar 0.4.12는 0.4.4 이후의 안정성 개선과 host 통합 작업을 다음 GitHub Release 후보로 묶습니다. 이 후보는 VSIX 0.4.12와 helper runtime 0.4.7을 함께 제공하며, 두 버전은 의도적으로 독립적으로 관리됩니다.

주요 변경 사항

  • Read-only thread catalog와 지원되는 account/rateLimits/read usage 조회를 위한 재사용 가능한 Codex App Server Controller를 추가합니다.
  • Rollout usage adapter는 로컬 fallback과 parity 관찰 source로 유지합니다.
  • Native Windows helper foundation, Windows state/locking 동작, stable .cmd shim, atomic runtime 선택, windows-latest CI 검증을 추가합니다.
  • 명시적으로 실행하는 foreground codex-radar thread rpc host와 one-shot thread doctor, start, list, read, send command를 추가합니다.
  • 누락된 Stop hook을 보정하기 위한 bounded persisted terminal-state reconciliation을 추가하고 foreground watch polling 전에 실행합니다.
  • 비동기 refresh 중에도 sidebar interaction이 같은 session identity를 유지하도록 안정화합니다.
  • Codex 메모리 관리 session을 cache rewrite 없이 CLI, TUI, shared export, VS Code direct reader에서 Codex internal로 분류합니다.

후보 산출물

  • codex-radar-helper-0.4.7.zip
  • codex-radar-helper-0.4.7.zip.sha256
  • codex-radar-vscode-0.4.12.vsix

Helper bundle에는 pure-Python 0.4.7 wheel과 VS Code extension 0.4.3 이상 0.5.0 미만을 대상으로 하는 compatibility metadata가 포함됩니다.

설치

후보가 명시적으로 승인되어 GitHub Release로 게시된 뒤 다음 순서로 설치합니다.

  1. Release에서 helper bundle, checksum, VSIX를 다운로드합니다.

  2. Helper bundle을 검증합니다.

    sha256sum --check codex-radar-helper-0.4.7.zip.sha256

  3. Helper runtime을 설치하거나 업그레이드합니다.

    unzip codex-radar-helper-0.4.7.zip
cd codex-radar-helper-0.4.7
python3 install-helper.py install .

  4. Hook 설정을 자동 변경하지 않고 필요한 차이를 검토합니다.

    ~/.local/bin/codex-radar-helper hook-config --hooks-file ~/.codex/hooks.json

  5. 같은 local 또는 Remote SSH extension host에 VSIX를 설치합니다.

    code --install-extension codex-radar-vscode-0.4.12.vsix --force

개인정보 보호와 자동화 경계

  • Codex Radar는 ~/.codex/hooks.json을 편집하거나 hook을 자동 설치하지 않으며 transcript/session 데이터를 외부로 전송하지 않습니다.
  • VS Code GUI는 Codex와 Radar runtime state에 대해 read-only로 유지됩니다. GUI의 app-server 접근은 thread metadata와 rate-limit 조회로 제한됩니다.
  • codex-radar thread rpc는 명시적으로 실행하는 foreground stdio surface입니다. Network listener나 daemon을 설치하지 않으며 command, file, permission request를 자동 승인하지 않습니다.
  • Display-state export에는 raw working directory, transcript path/text, hook payload, private runtime path가 포함되지 않습니다.
  • Shared display-state export는 기본 observe 모드를 유지합니다. Export 실패 또는 schema mismatch가 발생하면 direct adapter fallback을 유지합니다.

현재 제한 사항

  • 지원되는 공개 베타 배포 경로는 GitHub Releases이며 VS Code Marketplace와 PyPI에는 게시하지 않습니다.
  • Native Windows foundation과 CI는 준비되어 있지만, 실제 Codex hook이 %LOCALAPPDATA%\codex-radar\state\sessions.json을 갱신하고 VS Code sidebar가 같은 session을 표시하는 smoke 전에는 Windows 지원 완료로 선언하지 않습니다.
  • 해당 Native Windows smoke와 별도 release 결정 전까지 게시되는 helper asset은 POSIX 공개 베타 경로로 취급합니다.
  • Extension host가 비정상 종료되면 직접 소유한 app-server child가 남을 수 있습니다. Radar는 이 경계를 숨기기 위해 process-name/PPID sweep이나 undocumented daemon/proxy를 사용하지 않습니다.
  • Same-workspace Codex handoff는 계속 experimental local URI route를 사용합니다.

Release 전 확인

  • 전체 Python unit test와 compileall을 실행합니다.
  • 전체 VS Code extension test를 실행합니다.
  • 0.4.7 wheel과 helper bundle을 생성하고 검사합니다.
  • 0.4.12 VSIX를 생성하고 검사합니다.
  • 산출물 파일명과 embedded manifest version을 확인합니다.
  • Current helper와 VSIX로 extension-host smoke를 완료합니다.
  • GitHub Release를 만들기 전에 명시적 승인을 받습니다.
Assets 5
Loading