Codex, Arca, and Rust import policy
Names
| Name | Meaning |
|---|---|
| Codex | Product name for the persisted data API. |
VoxDb | Stable Rust type for the database facade (crates/vox-db). |
Codex (Rust) | Type alias for VoxDb in vox_db — same type. |
| Arca | Internal schema / CAS ownership in vox-pm (CodeStore). There is no vox_arca crate in this workspace. |
vox-codex | Compatibility crate: pub use vox_db::*. New code should depend on vox-db directly. |
Rules
- Prefer
vox_db::VoxDb(orvox_db::Codexalias) in signatures and new modules. - Do not introduce new dependencies on the
vox-codexcrate path unless bridging legacy tooling; migrate call sites tovox-dbwhen touched. - Unwired CLI modules should import
vox_pm::/vox_db::/vox_codex(shim) only — the historicalvox_arca*crate names are not used in-tree. Staging crates (e.g. minimalvox-orchestrator) follow the same rule: do not link them fromvox-cliuntil explicitly decided.
See ADR 004.