Developer Guide# Guides for extending and maintaining the calibration engine. Adding an Observation Mode Architecture Note Step 1: Add ObsMode Variant Step 2: Implement Preparation Step 3: Wire into the Dispatcher Step 4: Add Detection Logic Step 5: Add CLI/Python Parsing Step 6: Add Parity Test Step 7: Update Documentation Checklist Flag System Bit Layout Flag Operations Adding a New Flag Downstream Contract Telescope Profiles Profile Format Scan Metadata Passthrough Per-Pixel Focal-Plane Offsets Profile Auto-Detection Embedded Profiles Adding a New Telescope Python Bindings Module: _cal_rs Exported Functions Calibration Path Configuration Dict Dask Integration Design: Zero Logic in cal-py Testing Running Tests Test Categories Parity Methodology External Parity Suite Test Data Performance Key Optimisations Benchmarking
