iints-sdk-python35 1.1.3__tar.gz → 1.3.0__tar.gz

{iints_sdk_python35-1.1.3/src/iints_sdk_python35.egg-info → iints_sdk_python35-1.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: iints-sdk-python35
-Version: 1.1.3
+Version: 1.3.0
 Summary: A pre-clinical Edge-AI SDK for diabetes management validation.
 Author-email: Rune Bobbaers <rune.bobbaers@gmail.com>
 Project-URL: Homepage, https://github.com/python35/IINTS-SDK
@@ -81,6 +81,47 @@ cd iints_quickstart
 iints presets run --name baseline_t1d --algo algorithms/example_algorithm.py
 ```
 
+## CareLink Import
+
+The SDK can now ingest Medtronic CareLink / MiniMed CSV exports and convert them into the standard IINTS schema:
+
+```bash
+iints import-carelink \
+  --input-csv "/path/to/CareLink export.csv" \
+  --output-dir results/imported_carelink
+```
+
+This writes:
+- `cgm_standard.csv`
+- `scenario.json`
+- `carelink_summary.json`
+
+It extracts glucose, carb, and insulin events from the CareLink event log and aligns them onto an IINTS-ready timeline.
+
+If you want a reusable personal-data workspace in one command, build a CareLink workbench:
+
+```bash
+iints carelink-workbench \
+  --input-csv "/path/to/CareLink export.csv" \
+  --output-dir results/personal_carelink
+```
+
+This adds:
+- `carelink_timeline.csv`
+- `carelink_metrics.json`
+- `carelink_dashboard.png`
+- `carelink_poster.png`
+- `carelink_dashboard.html`
+- `ai/report_payload.json`
+- `ai/trends_payload.json`
+- `ai/anomalies_payload.json`
+- `ai/step_riskiest.json`
+
+That workbench is designed for three things:
+- inspect your own data visually
+- reuse the generated `scenario.json` inside IINTS experiments
+- let the local AI assistant explain what the imported patterns mean
+
 ## AI Assistant (Ministral 3 Open-Weight via Ollama)
 
 The SDK now includes a research-only AI assistant layer for explanations and run summaries.
@@ -122,6 +163,18 @@ iints ai prepare results/<run_id>
 iints ai report results/<run_id>
 ```
 
+For imported CareLink data, the matching flow is:
+
+```bash
+iints carelink-workbench \
+  --input-csv "/path/to/CareLink export.csv" \
+  --output-dir results/personal_carelink
+
+iints ai report results/personal_carelink --model ministral-3:3b
+iints ai trends results/personal_carelink --model ministral-3:3b
+iints ai explain results/personal_carelink --model ministral-3:3b
+```
+
 Direct JSON mode still works if you already have your own payloads and signed MDMP artifact:
 
 ```bash
@@ -136,10 +189,77 @@ Notes:
 - Users can choose a larger or smaller local Mistral-family model with `--model ...`.
 - Large JSON payloads are clipped automatically before prompt generation to keep local inference stable.
 - `iints ai prepare <run_dir>` now creates AI-ready JSON payloads and, when MDMP is installed, a local development certificate plus keypair in `<run_dir>/ai/`.
+- `iints carelink-workbench` now does the same kind of AI preparation for imported personal CareLink data and also generates a dashboard PNG/HTML pair.
 - If Ollama closes the connection during generation, the SDK now surfaces an explicit recovery hint and points users toward `ministral-3:3b` for lower-memory systems.
 - After `iints ai prepare`, you can point `iints ai explain|trends|anomalies|report` directly at the run directory.
+- After `iints carelink-workbench`, you can point those same AI commands directly at the generated CareLink workspace directory.
 - Output is research-only and not medical advice.
 
+## Jury Poster / Demo Graphic
+
+You can now generate a poster-style PNG directly from one to three real run bundles:
+
+```bash
+iints poster \
+  --run-dir results/normal_run \
+  --run-dir results/meal_stress \
+  --run-dir results/supervisor_override \
+  --label "Normal Run" \
+  --label "Meal Stress Test" \
+  --label "Supervisor Override" \
+  --output-path results/posters/iints_results_poster.png
+```
+
+The poster shows:
+- glucose curves with the target range highlighted
+- meal events
+- supervisor interventions
+- panel summaries with TIR, hypo time, meal count, and intervention count
+
+If you omit `--run-dir`, the CLI auto-discovers the latest run bundles under `./results`.
+
+## Fair / Jury Demo
+
+If you want one clean live demo for a booth, jury, or pitch session, use the built-in booth flow:
+
+```bash
+./scripts/run_booth_demo.sh
+```
+
+This generates:
+- three run bundles (`Normal Run`, `Meal Stress Test`, `Supervisor Override`)
+- a ready-to-show poster PNG
+- a markdown jury talk track
+- a plain-text live demo script for the stand
+- optional AI-ready artifacts for the safety case
+
+You can also run it through the CLI:
+
+```bash
+iints demo-booth --output-dir results/booth_demo
+```
+
+## Updating The SDK
+
+If another machine is missing newer commands like `iints ai ...` or `iints demo-booth`, upgrade inside the active virtual environment:
+
+```bash
+source .venv/bin/activate
+python -m pip install -U pip
+python -m pip install -U "iints-sdk-python35[mdmp]==1.3.0"
+hash -r
+python -c "import iints; print(iints.__version__)"
+```
+
+If that machine still behaves like an old install, run:
+
+```bash
+iints-sdk-doctor
+```
+
+Full guide:
+- `docs/UPDATING.md`
+
 Troubleshooting:
 - If `iints ai ...` says `No such command 'ai'`, your environment usually still has a legacy `iints` package installed alongside `iints-sdk-python35`.
 - Run `iints-sdk-doctor` first.
@@ -147,7 +267,7 @@ Troubleshooting:
 
 ```bash
 python -m pip uninstall -y iints iints-sdk-python35
-python -m pip install -U "iints-sdk-python35[mdmp]==1.1.3"
+python -m pip install -U "iints-sdk-python35[mdmp]==1.3.0"
 hash -r
 ```
 

{iints_sdk_python35-1.1.3 → iints_sdk_python35-1.3.0}/README.md

@@ -30,6 +30,47 @@ cd iints_quickstart
 iints presets run --name baseline_t1d --algo algorithms/example_algorithm.py
 ```
 
+## CareLink Import
+
+The SDK can now ingest Medtronic CareLink / MiniMed CSV exports and convert them into the standard IINTS schema:
+
+```bash
+iints import-carelink \
+  --input-csv "/path/to/CareLink export.csv" \
+  --output-dir results/imported_carelink
+```
+
+This writes:
+- `cgm_standard.csv`
+- `scenario.json`
+- `carelink_summary.json`
+
+It extracts glucose, carb, and insulin events from the CareLink event log and aligns them onto an IINTS-ready timeline.
+
+If you want a reusable personal-data workspace in one command, build a CareLink workbench:
+
+```bash
+iints carelink-workbench \
+  --input-csv "/path/to/CareLink export.csv" \
+  --output-dir results/personal_carelink
+```
+
+This adds:
+- `carelink_timeline.csv`
+- `carelink_metrics.json`
+- `carelink_dashboard.png`
+- `carelink_poster.png`
+- `carelink_dashboard.html`
+- `ai/report_payload.json`
+- `ai/trends_payload.json`
+- `ai/anomalies_payload.json`
+- `ai/step_riskiest.json`
+
+That workbench is designed for three things:
+- inspect your own data visually
+- reuse the generated `scenario.json` inside IINTS experiments
+- let the local AI assistant explain what the imported patterns mean
+
 ## AI Assistant (Ministral 3 Open-Weight via Ollama)
 
 The SDK now includes a research-only AI assistant layer for explanations and run summaries.
@@ -71,6 +112,18 @@ iints ai prepare results/<run_id>
 iints ai report results/<run_id>
 ```
 
+For imported CareLink data, the matching flow is:
+
+```bash
+iints carelink-workbench \
+  --input-csv "/path/to/CareLink export.csv" \
+  --output-dir results/personal_carelink
+
+iints ai report results/personal_carelink --model ministral-3:3b
+iints ai trends results/personal_carelink --model ministral-3:3b
+iints ai explain results/personal_carelink --model ministral-3:3b
+```
+
 Direct JSON mode still works if you already have your own payloads and signed MDMP artifact:
 
 ```bash
@@ -85,10 +138,77 @@ Notes:
 - Users can choose a larger or smaller local Mistral-family model with `--model ...`.
 - Large JSON payloads are clipped automatically before prompt generation to keep local inference stable.
 - `iints ai prepare <run_dir>` now creates AI-ready JSON payloads and, when MDMP is installed, a local development certificate plus keypair in `<run_dir>/ai/`.
+- `iints carelink-workbench` now does the same kind of AI preparation for imported personal CareLink data and also generates a dashboard PNG/HTML pair.
 - If Ollama closes the connection during generation, the SDK now surfaces an explicit recovery hint and points users toward `ministral-3:3b` for lower-memory systems.
 - After `iints ai prepare`, you can point `iints ai explain|trends|anomalies|report` directly at the run directory.
+- After `iints carelink-workbench`, you can point those same AI commands directly at the generated CareLink workspace directory.
 - Output is research-only and not medical advice.
 
+## Jury Poster / Demo Graphic
+
+You can now generate a poster-style PNG directly from one to three real run bundles:
+
+```bash
+iints poster \
+  --run-dir results/normal_run \
+  --run-dir results/meal_stress \
+  --run-dir results/supervisor_override \
+  --label "Normal Run" \
+  --label "Meal Stress Test" \
+  --label "Supervisor Override" \
+  --output-path results/posters/iints_results_poster.png
+```
+
+The poster shows:
+- glucose curves with the target range highlighted
+- meal events
+- supervisor interventions
+- panel summaries with TIR, hypo time, meal count, and intervention count
+
+If you omit `--run-dir`, the CLI auto-discovers the latest run bundles under `./results`.
+
+## Fair / Jury Demo
+
+If you want one clean live demo for a booth, jury, or pitch session, use the built-in booth flow:
+
+```bash
+./scripts/run_booth_demo.sh
+```
+
+This generates:
+- three run bundles (`Normal Run`, `Meal Stress Test`, `Supervisor Override`)
+- a ready-to-show poster PNG
+- a markdown jury talk track
+- a plain-text live demo script for the stand
+- optional AI-ready artifacts for the safety case
+
+You can also run it through the CLI:
+
+```bash
+iints demo-booth --output-dir results/booth_demo
+```
+
+## Updating The SDK
+
+If another machine is missing newer commands like `iints ai ...` or `iints demo-booth`, upgrade inside the active virtual environment:
+
+```bash
+source .venv/bin/activate
+python -m pip install -U pip
+python -m pip install -U "iints-sdk-python35[mdmp]==1.3.0"
+hash -r
+python -c "import iints; print(iints.__version__)"
+```
+
+If that machine still behaves like an old install, run:
+
+```bash
+iints-sdk-doctor
+```
+
+Full guide:
+- `docs/UPDATING.md`
+
 Troubleshooting:
 - If `iints ai ...` says `No such command 'ai'`, your environment usually still has a legacy `iints` package installed alongside `iints-sdk-python35`.
 - Run `iints-sdk-doctor` first.
@@ -96,7 +216,7 @@ Troubleshooting:
 
 ```bash
 python -m pip uninstall -y iints iints-sdk-python35
-python -m pip install -U "iints-sdk-python35[mdmp]==1.1.3"
+python -m pip install -U "iints-sdk-python35[mdmp]==1.3.0"
 hash -r
 ```
 

{iints_sdk_python35-1.1.3 → iints_sdk_python35-1.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "iints-sdk-python35" 
-version = "1.1.3"
+version = "1.3.0"
 authors = [
   { name="Rune Bobbaers", email="rune.bobbaers@gmail.com" },
 ]

{iints_sdk_python35-1.1.3 → iints_sdk_python35-1.3.0}/src/iints/__init__.py

@@ -11,7 +11,7 @@ except ImportError:  # pragma: no cover - Python < 3.8 fallback
 try:
     __version__ = version("iints-sdk-python35")
 except PackageNotFoundError:  # pragma: no cover - source tree fallback
-    __version__ = "1.1.3"
+    __version__ = "1.3.0"
 
 # Note to developers: this SDK is currently maintained by a single author.
 # Please report bugs via GitHub issues and feel free to contribute fixes via PRs.
@@ -56,17 +56,24 @@ from .data.importer import (
     export_demo_csv,
     export_standard_csv,
     guess_column_mapping,
+    import_carelink_csv,
+    import_carelink_timeline,
     import_cgm_csv,
     import_cgm_dataframe,
+    load_carelink_event_log,
     load_demo_dataframe,
     scenario_from_csv,
     scenario_from_dataframe,
+    summarize_carelink_csv,
 )
 from .data.nightscout import NightscoutConfig, import_nightscout
 from .data.tidepool import TidepoolClient, load_openapi_spec
 from .data.guardians import mdmp_gate, MDMPGateError
 from .data.synthetic_mirror import generate_synthetic_mirror, SyntheticMirrorArtifact
 from .analysis.metrics import generate_benchmark_metrics # Added for benchmark
+from .analysis.booth_demo import build_booth_demo
+from .analysis.carelink_workbench import build_carelink_workbench
+from .analysis.poster import generate_results_poster
 from .analysis.reporting import ClinicalReportGenerator
 from .analysis.edge_efficiency import EnergyEstimate, estimate_energy_per_decision
 from .ai import AIResponse, IINTSAssistant, MDMPGuard
@@ -160,11 +167,15 @@ __all__ = [
     "export_demo_csv",
     "export_standard_csv",
     "guess_column_mapping",
+    "import_carelink_csv",
+    "import_carelink_timeline",
     "import_cgm_csv",
     "import_cgm_dataframe",
+    "load_carelink_event_log",
     "load_demo_dataframe",
     "scenario_from_csv",
     "scenario_from_dataframe",
+    "summarize_carelink_csv",
     "NightscoutConfig",
     "import_nightscout",
     "TidepoolClient",
@@ -175,6 +186,8 @@ __all__ = [
     "SyntheticMirrorArtifact",
     # Analysis Metrics
     "generate_benchmark_metrics",
+    "build_booth_demo",
+    "build_carelink_workbench",
     "ClinicalReportGenerator",
     "EnergyEstimate",
     "estimate_energy_per_decision",
@@ -185,6 +198,7 @@ __all__ = [
     "generate_report",
     "generate_quickstart_report",
     "generate_demo_report",
+    "generate_results_poster",
     # High-level API
     "run_simulation",
     "run_full",

{iints_sdk_python35-1.1.3 → iints_sdk_python35-1.3.0}/src/iints/ai/prompts.py

@@ -8,8 +8,9 @@ TaskName = Literal["explain_decision", "analyze_trends", "detect_anomalies", "ge
 MAX_PROMPT_PAYLOAD_CHARS = 12000
 
 SYSTEM_PROMPT = (
-    "You are the IINTS-AF research assistant for closed-loop insulin delivery simulations. "
-    "Explain simulation behavior clearly, conservatively, and in plain language. "
+    "You are the IINTS-AF research assistant for closed-loop insulin delivery simulations "
+    "and imported glucose datasets. "
+    "Explain glycemic behavior clearly, conservatively, and in plain language. "
     "Do not give medical advice, treatment instructions, or patient-specific recommendations. "
     "State uncertainty when the input is incomplete. "
     "For research use only."
@@ -17,39 +18,39 @@ SYSTEM_PROMPT = (
 
 TASK_TEMPLATES: dict[TaskName, str] = {
     "explain_decision": (
-        "Given this single simulation step, explain:\n"
-        "1. What the algorithm decided and why\n"
-        "2. Whether the independent safety supervisor likely intervened\n"
-        "3. Whether the decision appears safe in context\n\n"
+        "Given this single decision step or noteworthy glucose snapshot, explain:\n"
+        "1. What is happening in the data and why it stands out\n"
+        "2. Whether there are safety signals, supervision, or notable context clues\n"
+        "3. What a research user should pay attention to next\n\n"
         "Respond in 3 short paragraphs.\n\n"
-        "Simulation step JSON:\n{data}"
+        "Input JSON:\n{data}"
     ),
     "analyze_trends": (
-        "Review this glucose-oriented simulation payload and summarize the main glycemic trends.\n"
+        "Review this glucose-oriented payload and summarize the main glycemic trends.\n"
         "Focus on direction, stability, excursions, and likely triggers.\n"
         "Respond with:\n"
         "- Trend summary\n"
         "- Main risk signals\n"
         "- Short operational takeaway\n\n"
-        "Simulation payload JSON:\n{data}"
+        "Payload JSON:\n{data}"
     ),
     "detect_anomalies": (
-        "Inspect this run summary and identify unusual patterns, inconsistent values, or clinically relevant anomalies.\n"
+        "Inspect this run or imported-data summary and identify unusual patterns, inconsistent values, or clinically relevant anomalies.\n"
         "Respond with:\n"
         "- Detected anomalies\n"
         "- Why each anomaly matters\n"
         "- Whether follow-up validation is recommended\n\n"
-        "Run summary JSON:\n{data}"
+        "Summary JSON:\n{data}"
     ),
     "generate_report": (
-        "Write a concise markdown report for this IINTS-AF simulation run.\n"
+        "Write a concise markdown report for this IINTS-AF simulation run or imported personal glucose dataset.\n"
         "Include sections:\n"
         "1. Executive summary\n"
         "2. Glycemic behavior\n"
-        "3. Safety and supervisor behavior\n"
-        "4. Notable events or anomalies\n"
+        "3. Safety, supervision, or device behavior\n"
+        "4. Notable events, patterns, or anomalies\n"
         "5. Research-only conclusion\n\n"
-        "Simulation run JSON:\n{data}"
+        "Input JSON:\n{data}"
     ),
 }
 

{iints_sdk_python35-1.1.3 → iints_sdk_python35-1.3.0}/src/iints/analysis/__init__.py

@@ -1,12 +1,18 @@
 from .clinical_metrics import ClinicalMetricsCalculator, ClinicalMetricsResult
 from .baseline import compute_metrics, run_baseline_comparison, write_baseline_comparison
+from .booth_demo import build_booth_demo
+from .carelink_workbench import build_carelink_workbench
+from .poster import generate_results_poster
 from .reporting import ClinicalReportGenerator
 
 __all__ = [
+    "build_booth_demo",
+    "build_carelink_workbench",
     "ClinicalMetricsCalculator",
     "ClinicalMetricsResult",
     "ClinicalReportGenerator",
     "compute_metrics",
+    "generate_results_poster",
     "run_baseline_comparison",
     "write_baseline_comparison",
 ]