Define Planning Output Metrics

[ethancoon]

Description

Document the output metrics needed for pre-race strategy planning.

Include:

• Finish SOC
• Minimum SOC
• Target SOC
• Laps completed
• Distance completed
• Average speed
• Whether the full race window was completed
• Whether minimum SOC was reached
• Energy margin relative to target SOC
• Feasibility status
• Planning warnings

Explain what each metric means and why it matters for race planning.

Acceptance Criteria

• A planning metrics document exists.
• The document defines each required planning metric.
• The document explains how energy margin should be interpreted.
• The document explains the difference between target SOC and minimum SOC.
• The document identifies which metrics are already available.
• The document identifies which metrics still need implementation.

Notes

Some planning metrics already exist in build_comparison_row(). This issue should document the expected final output before improving the report behavior.

References

• sim/planning/comparison.py
• sim/planning/sweep.py
• sim/planning/report.py
• sim/config.py