🎛️ MixBox SSOT

Canonical knowledge base for the MixBox audio engine, its workspace packages, and its operational procedures.

Source of Truth

Repository source code and executable configuration files are the ultimate authority; verify every page here against the code.

Sections

Section	Contents
Engineering	Architecture, analysis layer, planning, mixing
Operations	Configuration validation, deployment, review server
Domain Concepts	Music theory, transition patterns, audio processing structures
Integrations	External surfaces and design research
History & Logs	Historical documentation and session logs
Changelog	Recent changes, findings, pending fixes

Ecosystem

flowchart LR
  subgraph uv["uv workspace"]
    AC["audio-core"]
    DJ["dj-engine (mixbox)"]
    AN["analyzer (hitscan)"]
    VG["video-gen (hitvid)"]
    EM["emotion (valaro)"]
  end
  DJ --> AC
  AN --> AC
  VG --> AC

DJ path: entry → validated config → analysis/services → planning/transitions → mixer → audio + reports.

Mastering is separate

The mastering/ pipeline is completely separate from this root uv workspace and operates independently.