"Nomenclature migration map (SSOT)"

Nomenclature migration map (SSOT)

Policy: Documentation and storage use English-first names. Latin names remain valid CLI routes and aliases where they add identity (see CLI reference).

Concept dictionary

Canonical (English)MeaningLatin / product aliasLegacy / internal tokens
meshDistributed coordination: Populi registry, HTTP control plane, VOX_MESH_*Populi (mesh layer)mens in some TOML keys and paths (deprecated; prefer [mesh])
modelNative ML stack: weights, LoRA/QLoRA, vox mens commandsMensModule path vox_populi::mens::*; data dir mens/
secretsCredential resolution (Clavis)Clavisvox clavis
speechSTT / audioOratiovox oratio / vox speech
trainingCurriculum / fine-tuning workflowsScholavox schola

Crate and path truth (2026-03)

Incorrect / phantomCorrect
Crate vox-mens (removed)vox-populi with mens module: crates/vox-populi/src/mens/tensor/...
Crate vox-codex-apiCodex HTTP surface in vox-db (and vox CLI); no separate vox-codex-api package
Split compiler crates (vox-lexer, vox-parser, …) as workspace membersvox-compiler monolith: lexer, parser, hir, typeck, codegen_* modules

latin_ns (command-registry group labels)

Values come from contracts/cli/command-registry.yaml. They are telemetry / grouping buckets, not extra argv you must type. Optional Latin routes are vox fabrica, vox diag, vox ars, vox mens, vox recensio (see CLI reference); English paths remain canonical.

latin_nsTheme (mnemonic)Example English commands
fabricaWorkshop / compiler lanebuild, check, run, fmt, lsp, completions, oratio (speech), script (feature-gated)
diagDiagnostics lanedoctor, architect, stub-check — Latin: vox diag …
arsCraft / integrations laneclavis, snippet, share, openclaw, skill, ludus (and subcommands)
codexDatabase & Codex-shaped workflowscodex, db, scientia (publication pipeline)
ciRepository guard suitevox ci <subcommand>
mensModel / native ML (vox mens …)train, corpus, merge-qlora, …
recensioReview / audit (feature-gated)review
deiDEI daemon control planevox dei …

No latin_ns: Some operations omit the field (e.g. populi, island in the registry). That means they are grouped under English top-level names only; add latin_ns only if you introduce a documented Latin umbrella for them.

product_lane (bell-curve grouping metadata)

product_lane is distinct from latin_ns. It groups commands and docs by the kind of software Vox is optimizing for, not by CLI theme.

product_laneMeaningTypical examples
appfull-stack app constructionbuild, run, island, fabrica
workflowautomation and background executionscript, populi
aigeneration, review, eval, orchestration, speechmens, review, dei, oratio
interopapproved bindings and remote capability bridgesopenclaw, skill, snippet, share
datadatabase and publication workflowsdb, codex, scientia
platformpackaging, compliance, diagnostics, and secretspm, ci, doctor, clavis

CLI command migrations

OldNewNotes
vox ci no-vox-orchestrator-importvox ci no-dei-importAlias: no-vox-orchestrator-import
vox ci mens-gatevox ci mesh-gateAlias: mens-gate
vox share reviewvox share feedbackAlias: review
vox populi local-statusvox populi registry-snapshotAlias: local-status
vox clavis doctorvox clavis statusAlias: doctor

Skill bundle ids

LegacyCanonical
vox.mens (bundled populi.skill.md)vox.populi — SkillRegistry::get and uninstall treat vox.mens as an alias for vox.populi.
Broken / misleadingUse instead
reference/populi.md (mesh SSOT)reference/populi.md
architecture/mens-ssot.mdreference/populi.md

Rust symbols (internal disambiguation)

PreviousCurrentNotes
vox_compiler::typeck::SeverityTypeckSeverityDistinct from TOESTUB / lint severities
Duplicated vox_compiler::evalpub use vox_eval::*Single SSOT crate: vox-eval
vox_cli::training::native::VoxTransformerCliDogfoodTransformerAvoids clashing with Populi VoxTransformer
vox_repository::VoxMeshTomlMeshTomlType alias (same struct); prefer MeshToml in new Rust code

Workspace / experimental

ItemStatus
crates/vox-pyExcluded from the root workspace (Cargo.toml [workspace.exclude]); docs/src/reference/cli.md is a bindings guide for when the tree is enabled.

See also