Add interactive hardest-case dynamics and circadian internals view

Author: OptimumAF

CHANGELOG.md

@@ -60,6 +60,7 @@ for versioning even while in research-stage development.
 - Updated README, model card, and core module docs to document new circadian controls.
 - Enhanced benchmark visuals with a compact combined overview figure (static + interactive) and linked it in README/dashboard for faster comparison.
 - Added hardest-case dynamics GIF (training progression + inference decision-map evolution) and surfaced it near the top of README and docs dashboard.
+- Added an interactive Plotly hardest-case dynamics page with playback controls and circadian internals visualization (node/edge weights, chemical/plasticity state) on the docs dashboard.
 - Refreshed README benchmark section with a latest master verification run on 2026-02-28 and added raw output artifact under `docs/benchmarks/`.
 - Repositioned repository messaging to Circadian Predictive Coding as the primary focus.
 - Updated `README.md` with:

README.md

@@ -38,6 +38,10 @@ flowchart LR
 
 ![Hardest-Case Dynamics](docs/figures/hardest_mode_dynamics.gif)
 
+Interactive version (Plotly, with internals replay):
+
+- [Hardest-Case Dynamics Interactive](https://optimumaf.github.io/Circadian-Predictive-Coding/figures/interactive_hardest_mode_dynamics.html)
+
 ## Core Idea
 
 The circadian algorithm models wake and sleep phases:

docs/figures/README.md

@@ -9,6 +9,7 @@ This folder stores visual assets used by `README.md`.
 - `benchmark_train_speed.png`
 - `benchmark_inference_latency_p95.png`
 - `hardest_mode_dynamics.gif`
+- `interactive_hardest_mode_dynamics.html`
 - `circadian_sleep_dynamics.gif`
 - `interactive_benchmark_overview.html`
 - `interactive_benchmark_accuracy.html`
@@ -21,7 +22,7 @@ Run:
 
 ```powershell
 python scripts/generate_readme_figures.py --summary-csv benchmark_multiseed_cifar100_summary.csv --output-dir docs/figures
-python scripts/generate_hardest_mode_dynamics.py --output-path docs/figures/hardest_mode_dynamics.gif
+python scripts/generate_hardest_mode_dynamics.py --gif-output-path docs/figures/hardest_mode_dynamics.gif --interactive-output-path docs/figures/interactive_hardest_mode_dynamics.html
 ```
 
 The GIF is illustrative and intended for communication in the README.

docs/figures/hardest_mode_dynamics.gif

@@ -109,6 +109,10 @@
       background: #fff;
     }
 
+    .iframe-xl {
+      height: 1180px;
+    }
+
     .hero-visual {
       width: 100%;
       border-radius: 10px;
@@ -165,9 +169,13 @@ <h1>Circadian Predictive Coding Benchmark Dashboard</h1>
 
     <section class="section">
       <h2>Hardest-Case Dynamics (Training + Inference)</h2>
+      <iframe class="iframe-xl" src="figures/interactive_hardest_mode_dynamics.html" title="Interactive hardest-case training and inference dynamics"></iframe>
+      <p class="hero-caption">
+        Interactive replay: slider + play controls, phase-B inference map, and circadian internals graph (node/edge weights, chemical/plasticity state).
+      </p>
       <img class="hero-visual" src="figures/hardest_mode_dynamics.gif" alt="Hardest-case training and inference dynamics GIF" />
       <p class="hero-caption">
-        Left: training progression and phase-B inference accuracy over time. Right: circadian inference decision map with correct/incorrect overlays during hardest-case drift.
+        GIF fallback preview for README-compatible rendering.
       </p>
     </section>