Authoritative, versioned PDF facts contract for Think Neverland tools.
Project description
title: "Overview" description: "Authoritative read-only PDF facts engine for Think Neverland tools. Versioned contract, schema-validated output, and consumer-agnostic extraction." group: "Getting started" order: 1 slug: "overview"
codexPDF
codexPDF is Think Neverland's authoritative, read-only PDF facts reference.
Other engines consult codexPDF for canonical document facts instead of
re-parsing PDFs independently. The contract is versioned and schema-validated.
Status
Current baseline includes:
- Python package (
codex_pdf) with typed models - CLI (
codex-pdf extract|schema|validate|probe|parity) - Versioned schemas in
schemas/v1/ - Golden output harness under
tests/golden/
Quickstart
uv sync
uv run codex-pdf probe input.pdf --json
uv run codex-pdf extract input.pdf --pretty > out.json
uv run codex-pdf validate out.json
uv run codex-pdf parity --fixtures-root tests/fixtures --profile summary --max-files 5
uv run codex-pdf parity --fixtures-root tests/fixtures --profile inventory --max-files 5
uv run codex-pdf parity --fixtures-root tests/fixtures --profile deep --max-files 5
Optional external baseline comparison (consumer-specific adapter provided at runtime):
uv run codex-pdf parity \
--fixtures-root /path/to/pdfs \
--profile summary \
--baseline-command "<your_command_with_{pdf}_placeholder>"
Contract
The public API is the JSON contract rooted at CodexDocument.
- Schema path:
schemas/v1/codex-document.schema.json - Runtime model:
codex_pdf.models.v1.CodexDocument - Stability policy: SemVer (
majorfor breaking contract changes)
Documentation
| Topic | Doc |
|---|---|
| Architecture and boundaries | docs/architecture.md |
| CLI commands and usage patterns | docs/cli.md |
| Contract and schema versioning | docs/contract.md |
| Parity profiles and baselines | docs/parity.md |
| Preflight ingest adapters | docs/preflight-ingest.md |
| Migration sequencing | docs/migration-plan.md |
| Legacy discovery audit | docs/discovery-audit.md |
| Backward compatibility requirements | docs/backward-compatibility.md |
| Cleanup stop-gates policy | docs/cleanup-stop-gates.md |
License
AGPL-3.0-or-later.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file codex_pdf-1.4.1.tar.gz.
File metadata
- Download URL: codex_pdf-1.4.1.tar.gz
- Upload date:
- Size: 639.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.7 {"installer":{"name":"uv","version":"0.11.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
187b10f91cc352387434f616db09e1aaa14cd418f54954dfae9bd5d776d7caef
|
|
| MD5 |
a4e6b871c43b756fc39af43f0d0565e7
|
|
| BLAKE2b-256 |
2eb0d925108bdb52784e69a73cce46b73e9743548fed342efa057b26fbef4a41
|
File details
Details for the file codex_pdf-1.4.1-py3-none-any.whl.
File metadata
- Download URL: codex_pdf-1.4.1-py3-none-any.whl
- Upload date:
- Size: 569.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.7 {"installer":{"name":"uv","version":"0.11.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8e5ee9723d9d26b2af8dc20cc8d1aca3f46602e9d6b96518041c7a03e7da131d
|
|
| MD5 |
cb04106626799bb9716254935d39a973
|
|
| BLAKE2b-256 |
a6f606e7fdc738fae2d06cdf6bf5c04dee8cbecd86f010203e42d69838c00b91
|
