docs(v2.0.0-alpha.4): enrich v2.0 notebooks with FR sandwich + real-world examples

Each of the eight v2.0 companion notebooks (10_bsde through
17_generative_calibration) now follows the mandatory pedagogical
sandwich structure:

  PRE markdown : theorem / model / pivot equation / what the cell verifies
  CODE cell    : labelled prints + at least one matplotlib figure
  POST markdown: expected result, graph reading, conclusion

Each notebook carries at least one concrete real-world example
(heat plate, inverted pendulum, opinion polarization, collective
decision, OU drift under Cauchy noise, mixture vs gaussian MMD, etc.)

Generator script: scripts/enrich_v2_notebooks.py
Doc plots refreshed via scripts/inject_doc_plots.py.

docs/source/algorithms/agent_based.rst

@@ -44,6 +44,8 @@ Generic interacting-agent simulator (`consensus_dynamics`) — linear bounded-co
 
 
 
+
+
 .. AUTO-PLOT-BEGIN
 .. image:: ../_static/auto/algorithms__agent_based/block_03_fig_01.png
    :align: center
@@ -70,6 +72,8 @@ Generic interacting-agent simulator (`consensus_dynamics`) — linear bounded-co
 
 
 
+
+
 .. AUTO-PLOT-BEGIN
 .. image:: ../_static/auto/algorithms__agent_based/block_04_fig_01.png
    :align: center