"Codex, Arca, and Rust import policy"

Codex, Arca, and Rust import policy

Names

NameMeaning
CodexProduct name for the persisted data API.
VoxDbStable Rust type for the database facade (crates/vox-db).
Codex (Rust)Type alias for VoxDb in vox_db — same type.
ArcaInternal schema / CAS ownership in vox-pm (CodeStore). There is no vox_arca crate in this workspace.
vox-codexCompatibility crate: pub use vox_db::*. New code should depend on vox-db directly.

Rules

  1. Prefer vox_db::VoxDb (or vox_db::Codex alias) in signatures and new modules.
  2. Do not introduce new dependencies on the vox-codex crate path unless bridging legacy tooling; migrate call sites to vox-db when touched.
  3. Unwired CLI modules should import vox_pm:: / vox_db:: / vox_codex (shim) only — the historical vox_arca* crate names are not used in-tree. Staging crates (e.g. minimal vox-orchestrator) follow the same rule: do not link them from vox-cli until explicitly decided.

See ADR 004.