Agent Quick Reference

Core CI Gates You Must Not Break

vox ci line-endings: LF only source formats limit. No CRLF allowed except for *.ps1.
vox ci command-compliance: Check CLI compliance updates.
vox stub-check (TOESTUB): Prevent submitting todo!(), unimplemented!(), empty-bodies, or any stubs.
vox ci sync-ignore-files: Ensures AGENTS.md rules and .voxignore exclusions correctly sync to .cursorignore and .aiignore.
vox ci clavis-parity: Requires secret references securely bind to resolve_secret(...). No static env variables allowed! (CI command name retained for backward compat; checks against secrets-ssot.md.)

Do NOT read or modify files within docs/src/archive/ or archive/ for current work streams.
All new documentation requires comprehensive YAML frontmatter: title, description, category, status, last_updated, training_eligible.
Inline code blocks across .md files should be explicitly imported using {{#include}} pointing to examples/golden/ files, OR manually prepended with // vox:skip.

Never read std::env::var("SECRET"); exclusively employ vox_secrets::resolve_secret(...) and declare it in crates/vox-secrets/src/spec.rs.

If vox is explicitly omitted from terminal $PATH, use the dev scripts:

Retired / Deprecated	Canonical Replacement (Use Instead)
Legacy orchestrator packaging	`vox-orchestrator`
Legacy ARS/OpenClaw predecessor crate	`vox-openclaw-runtime`
Legacy gamification crate label	`vox-gamify`
Legacy split compiler crates	`vox-compiler`
Legacy React-interop component decorator	`component Name() {}`
Legacy Turso-prefixed DB env aliases	`VOX_DB_URL` / `VOX_DB_TOKEN`
Sync recall API	`recall_async()`
Persist-fact API	`sync_to_db()`