Snapshot WIP: solver HP epic progress, BPHX/HX physics, BMAD skill refresh.

Capture uncommitted solver robustness work (regularization, domain errors, linear solver lifecycle, tube DP/MSH), web workbench updates, and synced BMAD skills across IDE agent folders before starting BPHX pressure-drop.

Co-authored-by: Cursor <cursoragent@cursor.com>

docs/components/bypass-valve.md

@@ -0,0 +1,53 @@
+# BypassValve
+
+Config type: `"BypassValve"`  
+Source: `crates/components/src/bypass_valve.rs` (or valve module)
+
+---
+
+## EN
+
+### Purpose & model
+
+Bypass leg valve with opening characteristic (linear / equal-percentage / custom). Parallel path around a component (compressor, HX, etc.).
+
+```
+ṁ = f(opening, ΔP, kv, characteristic)
+h_out ≈ h_in
+```
+
+### Residuals
+
+Flow residual + energy (isenthalpic or low Δh).
+
+### Ports
+
+`inlet` / `outlet`.
+
+### Actuator
+
+`opening` ∈ [0, 1] — free when under control.
+
+### JSON (main)
+
+| Key | Meaning | Default |
+|-----|---------|---------|
+| `opening` | 0–1 | 0–1 |
+| `kv` | capacity | – |
+| characteristic | linear / … | linear |
+
+---
+
+## FR
+
+### But
+
+**Vanne de by-pass** sur une branche parallèle.
+
+### Actionneur
+
+Ouverture 0–1.
+
+### JSON
+
+Voir EN.