Initial state from `cargo new --lib` plus the technical design spec at docs/heuropt_tech_design_spec.md, which is the source of truth for the crate's public API and v1 acceptance criteria.
