Support for contextual stochastic optimization problems

[BatyLeo]

Summary

• Rename DataSample.context → DataSample.maximizer_kwargs
• Add generate_context hook to the exogenous stochastic interface, enabling contextual information correlated with randomness
• Add SampleAverageApproximation wrapper that converts any ExogenousStochasticBenchmark into a static benchmark with pre-drawn scenarios
• Add ContextualStochasticArgmaxBenchmark as the minimal reference implementation of the new contextual
  interface

[codecov]

Codecov Report

❌ Patch coverage is 91.00000% with 9 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
...hasticVehicleScheduling/solution/algorithms/mip.jl	0.00%	4 Missing ⚠️
src/StochasticVehicleScheduling/policies.jl	75.00%	3 Missing ⚠️
src/Utils/data_sample.jl	91.66%	1 Missing ⚠️
src/Utils/interface.jl	97.61%	1 Missing ⚠️

Files with missing lines	Coverage Δ
ext/DFLBenchmarksPlotsExt.jl	100.00% <ø> (ø)
...tualStochasticArgmax/ContextualStochasticArgmax.jl	100.00% <100.00%> (ø)
src/ContextualStochasticArgmax/policies.jl	100.00% <100.00%> (ø)
src/DecisionFocusedLearningBenchmarks.jl	100.00% <ø> (ø)
...icVehicleScheduling/StochasticVehicleScheduling.jl	100.00% <ø> (ø)
src/Utils/Utils.jl	100.00% <ø> (ø)
src/Utils/maximizers.jl	100.00% <100.00%> (ø)
src/Utils/data_sample.jl	93.10% <91.66%> (ø)
src/Utils/interface.jl	93.61% <97.61%> (+2.23%)	⬆️
src/StochasticVehicleScheduling/policies.jl	81.25% <75.00%> (-18.75%)	⬇️
... and 1 more

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.