Skip to content

Canonical runtime names (daemon, MCP, env)

Machine registry for env keys: contracts/config/env-vars.v1.yaml.
Human prose tables: docs/src/reference/env-vars.md.
CI enforces that prose cites only registered names (vox ci command-compliance).

CanonicalRole
vox-orchestrator-dShipped daemon binary (workspace crate vox-orchestrator-d).

Deprecated path names (vox-dei-d, prose-only “DEI daemon”) may appear in logs or legacy docs — treat them as aliases of the same IPC peer; new code should prefer vox-orchestrator-d / orchestrator wording.

SurfaceCanonicalDeprecated alias (compat)
Cratevox-gamifyvox-ludus (retired crate name)
MCP tool prefixvox_gamify_*vox_ludus_* (alias layer in MCP dispatch)
Env familyPrefer documented VOX_GAMIFY_* where introducedVOX_LUDUS_* still read for backward compatibility in vox-gamify

Do not introduce new VOX_LUDUS_* keys without an explicit migration note in env-vars.v1.yaml.

CanonicalDeprecated (compat only)
VOX_DB_URL, VOX_DB_TOKEN, VOX_DB_PATHVOX_TURSO_*, TURSO_*

See AGENTS.md retired surfaces table and vox-db DbConfig resolution.

RetiredCanonical
vox-ars cratevox-openclaw-runtime

JSON Schema SSOT lives under contracts/scientia/*.schema.json. Rust mirrors in vox-research-events must stay aligned (prefer codegen when touching schemas).