Rename format from Codex to CDX (Content-addressed Document eXchange)

The format shared the name "Codex" with OpenAI's coding-agent platform,
which now dominates developer/AI search and is broadening toward document
workflows. Rename to CDX to restore discoverability and a distinct identity.

Changes:
- Brand/prose: Codex -> CDX; introduce the expansion "Content-addressed
  Document eXchange" at first mention; drop redundant "CDX Document Format"
- Manifest spec-version key: "codex" -> "cdx"
- MIME types: application/vnd.codex* -> application/vnd.cdx*
- Extension namespace IDs: codex.* -> cdx.* (8 extensions)
- Schema $id and $ref host: https://codex.document -> https://cdx.dev
- Tooling: generate-template.ts (emits cdx key/IDs) and
  check-example-coverage.ts (extension-id matcher) updated

Intentionally unchanged: the .cdx file extension (already name-independent);
the GitHub repo/org name and repo-path URLs (separate admin action; GitHub
auto-redirects); package.json name; docs/archive/** (historical record).

Validation: schemas compile, all 11 example documents validate, 71/71
cross-references resolve, 8/8 extensions and 15/15 schemas covered.

Note: https://cdx.dev is a placeholder schema namespace (JSON Schema $id
URIs need not resolve); repoint at a controlled domain if desired.

Author: gvonnessi

CHANGELOG.md

@@ -1,6 +1,6 @@
 # Changelog
 
-All notable changes to the Codex file format specification.
+All notable changes to the CDX file format specification.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
@@ -19,14 +19,14 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 - Highlight annotation documentation in collaboration extension (Section 4.7)
 
 #### Extensions
-- **Academic** (`codex.academic`) - Theorems, proofs, exercises, algorithms, equation groups
-- **Collaboration** (`codex.collaboration` v0.2) - CRDT integration, comments, change tracking, presence
-- **Forms** (`codex.forms`) - Interactive form fields with validation
-- **Legal** (`codex.legal`) - Citations, Table of Authorities, court captions, signature blocks
-- **Phantoms** (`codex.phantoms`) - Invisible structural elements for complex layouts
-- **Presentation** (`codex.presentation`) - Advanced typography, master pages, print features
-- **Security** (`codex.security`) - Digital signatures, encryption, redaction, scoped signatures
-- **Semantic** (`codex.semantic`) - Bibliography, footnotes, glossary, entity markup, JSON-LD
+- **Academic** (`cdx.academic`) - Theorems, proofs, exercises, algorithms, equation groups
+- **Collaboration** (`cdx.collaboration` v0.2) - CRDT integration, comments, change tracking, presence
+- **Forms** (`cdx.forms`) - Interactive form fields with validation
+- **Legal** (`cdx.legal`) - Citations, Table of Authorities, court captions, signature blocks
+- **Phantoms** (`cdx.phantoms`) - Invisible structural elements for complex layouts
+- **Presentation** (`cdx.presentation`) - Advanced typography, master pages, print features
+- **Security** (`cdx.security`) - Digital signatures, encryption, redaction, scoped signatures
+- **Semantic** (`cdx.semantic`) - Bibliography, footnotes, glossary, entity markup, JSON-LD
 
 #### Profiles
 - Simple Documents profile for recreational reading

CONTRIBUTING.md

@@ -1,6 +1,6 @@
-# Contributing to Codex Document Format
+# Contributing to CDX
 
-Thank you for your interest in contributing to the Codex Document Format specification.
+Thank you for your interest in contributing to the CDX specification.
 
 ## How to Contribute
 

README.md

@@ -1,9 +1,9 @@
-# Codex Document Format
+# CDX
 
 [![Validate Schemas](https://github.com/Entrolution/codex-file-format-spec/actions/workflows/validate-schemas.yml/badge.svg)](https://github.com/Entrolution/codex-file-format-spec/actions/workflows/validate-schemas.yml)
 [![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)
 
-**An open specification for documents that unify viewing and editing, with modern security and machine readability.**
+**CDX — Content-addressed Document eXchange.** An open specification for documents that unify viewing and editing, with modern security and machine readability.
 
 > Status: Draft Specification (v0.1)
 
@@ -85,7 +85,7 @@ This divide creates workflow friction, format conversion overhead, and lost fide
 
 ## Key Feature: Verifiable Provenance
 
-Codex documents form a **cryptographic hash chain** — each document's identity IS its content hash, and each document can reference its parent by hash:
+CDX documents form a **cryptographic hash chain** — each document's identity IS its content hash, and each document can reference its parent by hash:
 
 ```
 doc-v1 (sha256:aaa)  ←──  doc-v2 (sha256:bbb)  ←──  doc-v3 (sha256:ccc)
@@ -103,7 +103,7 @@ This enables:
 
 ## Key Feature: State-Aware Presentation
 
-Codex uses **progressive enhancement** for presentation — the level of layout precision evolves with document maturity:
+CDX uses **progressive enhancement** for presentation — the level of layout precision evolves with document maturity:
 
 | Document State | Presentation Requirement | What's Frozen |
 |----------------|-------------------------|---------------|
@@ -164,7 +164,7 @@ The specification is modular:
 
 ### Document Structure
 
-A Codex document is a ZIP archive with this structure:
+A CDX document is a ZIP archive with this structure:
 
 ```
 document.cdx
@@ -195,7 +195,7 @@ document.cdx
 
 ```json
 {
-  "codex": "0.1",
+  "cdx": "0.1",
   "id": "sha256:a1b2c3...",
   "state": "draft",
   "content": {
@@ -209,7 +209,7 @@ document.cdx
         "type": "paragraph",
         "children": [
           { "type": "text", "value": "This is a " },
-          { "type": "text", "value": "Codex", "marks": ["bold"] },
+          { "type": "text", "value": "CDX", "marks": ["bold"] },
           { "type": "text", "value": " document." }
         ]
       }
@@ -221,8 +221,8 @@ document.cdx
 ## File Extension and MIME Type
 
 - **Extension**: `.cdx`
-- **MIME Type**: `application/vnd.codex+json` (canonical JSON form)
-- **Alternative**: `application/vnd.codex` (binary/packed form)
+- **MIME Type**: `application/vnd.cdx+json` (canonical JSON form)
+- **Alternative**: `application/vnd.cdx` (binary/packed form)
 
 ## Roadmap
 

SECURITY.md

@@ -20,7 +20,7 @@ If you find a security issue in the reference implementation ([cdx-core](https:/
 
 This security policy covers:
 
-- The Codex Document Format specification
+- The CDX specification
 - JSON schemas in this repository
 - Example documents in this repository
 

docs/design-decisions.md

@@ -1,6 +1,6 @@
 # Design Decisions
 
-This document records key design decisions made during the Codex format specification development.
+This document records key design decisions made during the CDX format specification development.
 
 ## DD-001: ZIP Container Format
 
@@ -559,7 +559,7 @@ This section captures key strategic insights from early design discussions that
 **Build Order**:
 1. **cdx-core** (Rust library) — Foundation everything else builds on
 2. **cdx-cli** — Dogfoods the core library, essential for tooling development
-3. **Pandoc writer** — Markdown → Codex (the academia unlock)
+3. **Pandoc writer** — Markdown → CDX (the academia unlock)
 4. **Web viewer** — cdx-core compiled to WASM (zero-install demonstration)
 
 **Why Pandoc**: Academics don't adopt new editors, they adopt new export targets. A Pandoc writer fits existing workflows with zero friction for authors.

examples/academic-document/manifest.json

@@ -1,12 +1,12 @@
 {
-  "codex": "0.1",
+  "cdx": "0.1",
   "id": "pending",
   "state": "draft",
   "created": "2025-01-28T14:00:00Z",
   "modified": "2025-01-28T14:00:00Z",
   "extensions": [
     {
-      "id": "codex.academic",
+      "id": "cdx.academic",
       "version": "0.1",
       "required": false
     }

examples/academic-document/metadata/dublin-core.json

@@ -7,7 +7,7 @@
     "description": "A demonstration of academic extension features including theorems, proofs, exercises, and algorithms.",
     "date": "2025-01-28",
     "type": "Text",
-    "format": "application/vnd.codex+zip",
+    "format": "application/vnd.cdx+zip",
     "language": "en",
     "rights": "CC BY 4.0"
   }

examples/collaboration-document/manifest.json

@@ -1,12 +1,12 @@
 {
-  "codex": "0.1",
+  "cdx": "0.1",
   "id": "pending",
   "state": "draft",
   "created": "2025-01-28T14:00:00Z",
   "modified": "2025-01-28T14:00:00Z",
   "extensions": [
     {
-      "id": "codex.collaboration",
+      "id": "cdx.collaboration",
       "version": "0.2",
       "required": false
     }

examples/collaboration-document/metadata/dublin-core.json

@@ -7,7 +7,7 @@
     "description": "A demonstration of collaboration extension features including comments, suggestions, reactions, and tracked changes with multiple authors.",
     "date": "2025-01-28",
     "type": "Text",
-    "format": "application/vnd.codex+zip",
+    "format": "application/vnd.cdx+zip",
     "language": "en",
     "rights": "Confidential"
   }

examples/comprehensive-document/content/document.json

@@ -15,7 +15,7 @@
       "children": [
         { "type": "text", "value": "This document demonstrates " },
         { "type": "text", "value": "all block types", "marks": ["bold"] },
-        { "type": "text", "value": " supported by the Codex format. It serves as both documentation and a validation test case." }
+        { "type": "text", "value": " supported by the CDX format. It serves as both documentation and a validation test case." }
       ]
     },
     {
@@ -273,7 +273,7 @@
             {
               "type": "definitionTerm",
               "children": [
-                { "type": "text", "value": "Codex" }
+                { "type": "text", "value": "CDX" }
               ]
             },
             {
@@ -332,7 +332,7 @@
       "children": [
         {
           "type": "text",
-          "value": "interface CodexDocument {\n  version: string;\n  blocks: Block[];\n}\n\nfunction validate(doc: CodexDocument): boolean {\n  return doc.blocks.every(block => block.type !== undefined);\n}"
+          "value": "interface CdxDocument {\n  version: string;\n  blocks: Block[];\n}\n\nfunction validate(doc: CdxDocument): boolean {\n  return doc.blocks.every(block => block.type !== undefined);\n}"
         }
       ]
     },
@@ -607,7 +607,7 @@
         {
           "type": "figcaption",
           "children": [
-            { "type": "text", "value": "Figure: Codex document architecture showing the relationship between content, presentation, and metadata layers." }
+            { "type": "text", "value": "Figure: CDX document architecture showing the relationship between content, presentation, and metadata layers." }
           ]
         }
       ]
@@ -624,8 +624,8 @@
       "type": "barcode",
       "id": "qr-demo",
       "format": "qr",
-      "data": "https://codex.document/spec",
-      "alt": "QR code linking to Codex specification",
+      "data": "https://cdx.dev/spec",
+      "alt": "QR code linking to CDX specification",
       "errorCorrection": "M",
       "size": 150
     },
@@ -701,7 +701,7 @@
       "signer": {
         "name": "Jane Smith",
         "title": "Technical Lead",
-        "organization": "Codex Foundation",
+        "organization": "CDX Foundation",
         "email": "jane.smith@example.com"
       },
       "timestamp": "2025-01-28T14:00:00Z",
@@ -905,7 +905,7 @@
       "type": "paragraph",
       "id": "conclusion",
       "children": [
-        { "type": "text", "value": "This document demonstrates all block types defined in the Codex content schema. Each block type serves a specific semantic purpose, enabling reliable machine processing and consistent rendering across implementations." }
+        { "type": "text", "value": "This document demonstrates all block types defined in the CDX content schema. Each block type serves a specific semantic purpose, enabling reliable machine processing and consistent rendering across implementations." }
       ]
     }
   ]