Skip to content

IINTS-AF SDK v1.5.28

Release date: 2026-07-15

Summary

This patch fixes a scientific coupling bug in the experimental Hovorka-style patient model.

molecular_affinity_scalar was exposed through the patient interface and used by the genomics/multi-scale engine, but it did not actually scale the Hovorka insulin action channels inside the ODE. As a result, healthy and INSR-resistant simulations could produce identical glucose trajectories while being labeled differently.

The scalar now participates directly in k_b1, k_b2, and k_b3, and the initial insulin-action states are initialized with the same scalar. This makes the genomics bridge deterministic and observable in patient-level glucose traces.

Fixed

  • Applied molecular_affinity_scalar to Hovorka insulin action gains.
  • Added regression coverage proving that low molecular affinity changes the meal/bolus glucose curve.
  • Updated the formula registry so local AI explanations use the deterministic formula source of truth.
  • Updated the physiology reference to describe global molecular affinity plus tissue-specific muscle/liver scalars.

Verified

  • python3 -m pytest tests/core/test_hovorka_model.py tests/core/test_patient_physiology_regression.py tests/research/test_genomics_engine.py -q
  • python3 -m pytest tests/ -q
  • python3 -m mypy src/iints/
  • Formula registry smoke: formula_count 15, ai_numeric_authority False

Safety

The molecular/genomics features are educational and pre-clinical research abstractions. They are not clinically validated genotype-to-dose models and must not be used for diagnosis, insulin dosing, glucagon dosing, or treatment decisions.