Skip to content

Rename document format from Codex to CDX#117

Merged
gvonnessi merged 1 commit into
mainfrom
rename/codex-to-cdx
Jun 17, 2026
Merged

Rename document format from Codex to CDX#117
gvonnessi merged 1 commit into
mainfrom
rename/codex-to-cdx

Conversation

@gvonnessi

Copy link
Copy Markdown
Collaborator

Summary

Tracks the upstream codex-file-format-spec rename Codex → CDX ("Content-addressed Document eXchange"). Full-scope rename across functional identifiers, Rust code symbols, docs, and LICENSE. 68 files, +204/−204 (symmetric).

Changes

  • Manifest spec-version field Manifest.codexManifest.cdx (serde-derived wire key is now "cdx"; manifest round-trip tests pass)
  • MIME application/vnd.codex*application/vnd.cdx*
  • Extension IDs codex.*cdx.*
  • cdx-swift-bridge: codex_versioncdx_version
  • Internal Rust identifiers, doc comments, README/CONTRIBUTING/CHANGELOG, and the LICENSE copyright holder line → CDX

Protected (intentionally unchanged)

  • codex-file-format-spec — the upstream spec repo path (incl. the spec/ submodule and .gitmodules URL); to be updated separately if/when that repo is renamed
  • codex-tool/2.0 — a fictional third-party authoring-tool agent name in a collaboration test fixture (not the format brand)

Test plan

  • cargo build --workspace --all-features
  • cargo test --workspace --all-features — 1082 passed, 0 failed (incl. manifest round-trip)
  • cargo fmt --all -- --check
  • cargo clippy --workspace --all-features -- -D warnings (the CI gate) — clean
  • cdx-swift-bridge (workspace-excluded crate) builds + tests clean

Note: a stricter clippy --all-targets surfaces 41 lints in test/bench code — present identically on main, unrelated to this rename, and outside the CI gate.

Track the upstream spec rename of the document format from "Codex" to
"CDX" (Content-addressed Document eXchange). The spec PR is merged; this
makes cdx-core consistent with the new name across functional
identifiers, internal code symbols, and documentation.

Functional / wire-format identifiers:
- Manifest spec-version key: JSON "codex" -> "cdx". The Manifest struct
  field is renamed `codex` -> `cdx`; it carries no serde rename, so the
  serialized key follows the field name and manifests round-trip on the
  new key.
- MIME type: application/vnd.codex+json -> application/vnd.cdx+json.
- Built-in extension IDs: codex.{academic,semantic,forms,security,
  collaboration,presentation,phantoms,legal} -> cdx.<same>, including the
  has_extension/get_extension matchers.

Internal Rust symbols:
- Lowercase field/variable identifiers codex -> cdx (e.g. the swift
  bridge `codex_version` -> `cdx_version`).

Docs / metadata:
- Brand prose Codex -> CDX across README, CHANGELOG, docs, code comments,
  Cargo.toml descriptions/keywords.
- LICENSE copyright lines: "Codex Document Format Contributors" ->
  "CDX Document Format Contributors".

Preserved unchanged: the upstream spec repo path `codex-file-format-spec`
(GitHub URLs and the spec submodule), and the unrelated test fixture
agent name "codex-tool/2.0".

Verified: cargo build, cargo test (1082 passed, incl. manifest
round-trip), and cargo fmt all pass; cdx-swift-bridge builds. clippy
-D warnings has pre-existing failures on main unrelated to this change
(identical diagnostics before and after the rename).
@codecov

codecov Bot commented Jun 17, 2026

Copy link
Copy Markdown

Codecov Report

❌ Patch coverage is 90.00000% with 2 lines in your changes missing coverage. Please review.

Files with missing lines Patch % Lines
cdx-cli/src/commands/metadata.rs 0.00% 1 Missing ⚠️
cdx-core/src/manifest.rs 80.00% 1 Missing ⚠️

📢 Thoughts on this report? Let us know!

@gvonnessi gvonnessi merged commit 081c80a into main Jun 17, 2026
15 of 16 checks passed
@gvonnessi gvonnessi deleted the rename/codex-to-cdx branch June 17, 2026 15:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant