quchip.engine.solver_hints

Advisory solver-hint heuristics (post-assembly metadata only).

These helpers summarize an already-assembled HamiltonianDescription into advisory hints (max_carrier_freq_ghz, spectral_bound_ghz) that backends may consult to pick a conservative solver step. They live outside stage2_assembly because they assemble no terms and never cross the 2π boundary: the only TWO_PI here divides an already-angular carrier back to ordinary GHz for the advisory dict. None of these values participate in physics — they are pure metadata.