v1.5.8¶

Release date: 2026-05-24

v1.5.8 is a physiology calibration patch for the v1.5.7 local-AI research release.

The patch keeps the new Jetson/local-AI workflow intact, but fixes the full CI realism gate by making the Bergman meal model and the bundled reference profiles line up with the empirical daily envelopes again.

Highlights¶

1. Bergman meal bioavailability is now applied¶

The Bergman patient model already exposed a f_bio meal bioavailability parameter, but the meal compartment was not using it. Meals now enter the stomach compartment through the bioavailable fraction, which prevents large meals from creating unrealistically sharp five-minute glucose jumps.

2. Reference T1D profiles are recalibrated¶

The free-living, AZT1D, and HUPA-UCM reference virtual-patient YAMLs were recalibrated after the v1.5.7 truth-output changes. The goal is not to hide excursions; it is to keep the built-in reference days inside the real-data envelopes used by validate_realism_dataset.

3. Realism CI is green again¶

The failing preset realism cases now return likely_realistic for the expected reference-day runs, while still preserving warning-level sensitivity when a trace is near the edge of the empirical meal-response target band.

Validation¶

Checks run before release:

PYTHONPATH=src MPLCONFIGDIR=.mplt pytest tests/ -q

Result: 423 passed, 4 skipped.

Focused physiology and edge checks also passed:

PYTHONPATH=src MPLCONFIGDIR=.mplt pytest \
  tests/test_presets_realism.py \
  tests/test_bergman.py \
  tests/core/test_numeric_guards.py \
  tests/core/test_safety_config.py \
  tests/test_jetson_endurance.py \
  tests/research/test_control_training.py -q

Result: 55 passed.

Additional checks:

PYTHONPATH=src python3 tools/ci/check_mdmp_sync.py
flake8 src/iints/core/patient/bergman_model.py tests/test_bergman.py
mypy src/iints/
python3 -m build

Upgrade¶

For normal SDK and reporting work:

python -m pip install -U "iints-sdk-python35[full,mdmp]==1.5.8"

For local AI training features, include the research extra:

python -m pip install -U "iints-sdk-python35[full,mdmp,research]==1.5.8"

For edge/Jetson installs where disk space matters:

python -m pip install -U "iints-sdk-python35[edge,mdmp]==1.5.8"

Practical takeaway¶

If you installed v1.5.7 for Jetson endurance or local AI research, upgrade to v1.5.8 before collecting comparison runs. The command surface is the same, but the bundled reference physiology is better calibrated.