Add Truth Mode for Particle Flow

This adds new c++ and corresponding python flag to allow us to turn on truth cheating for particle flow for different steps of the algorithm.

This functionality only works on simulation samples which contain calibration hits.

It is all off by default and won't affect production output.