iints-sdk-python35 1.4.0__tar.gz → 1.5.0__tar.gz

{iints_sdk_python35-1.4.0/src/iints_sdk_python35.egg-info → iints_sdk_python35-1.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: iints-sdk-python35
-Version: 1.4.0
+Version: 1.5.0
 Summary: A pre-clinical Edge-AI SDK for diabetes management validation.
 Author-email: Rune Bobbaers <rune.bobbaers@gmail.com>
 License-Expression: Apache-2.0
@@ -187,6 +187,7 @@ cd iints_quickstart
 iints presets run --name baseline_t1d --algo algorithms/example_algorithm.py
 iints ai prepare results/<run_id>
 iints ai report results/<run_id>
+iints ai review results/<run_id>
 ```
 
 For imported CareLink data, the matching flow is:
@@ -197,6 +198,7 @@ iints carelink-workbench \
   --output-dir results/personal_carelink
 
 iints ai report results/personal_carelink --model ministral-3:3b
+iints ai review 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
 ```
@@ -217,7 +219,7 @@ Notes:
 - `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 ai prepare`, you can point `iints ai explain|trends|anomalies|report|review` 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.
 

{iints_sdk_python35-1.4.0 → iints_sdk_python35-1.5.0}/README.md

@@ -134,6 +134,7 @@ cd iints_quickstart
 iints presets run --name baseline_t1d --algo algorithms/example_algorithm.py
 iints ai prepare results/<run_id>
 iints ai report results/<run_id>
+iints ai review results/<run_id>
 ```
 
 For imported CareLink data, the matching flow is:
@@ -144,6 +145,7 @@ iints carelink-workbench \
   --output-dir results/personal_carelink
 
 iints ai report results/personal_carelink --model ministral-3:3b
+iints ai review 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
 ```
@@ -164,7 +166,7 @@ Notes:
 - `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 ai prepare`, you can point `iints ai explain|trends|anomalies|report|review` 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.
 

{iints_sdk_python35-1.4.0 → iints_sdk_python35-1.5.0}/pyproject.toml

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

{iints_sdk_python35-1.4.0 → iints_sdk_python35-1.5.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.4.0"
+    __version__ = "1.5.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.

{iints_sdk_python35-1.4.0 → iints_sdk_python35-1.5.0}/src/iints/ai/assistant.py

@@ -122,3 +122,6 @@ class IINTSAssistant:
 
     def generate_report(self, run: dict[str, Any]) -> AIResponse:
         return self._run_task("generate_report", run)
+
+    def review_realism(self, run: dict[str, Any]) -> AIResponse:
+        return self._run_task("review_realism", run)

{iints_sdk_python35-1.4.0 → iints_sdk_python35-1.5.0}/src/iints/ai/cli.py

@@ -43,6 +43,7 @@ def _default_prepared_payload(task: str, ai_dir: Path) -> Path:
         "trends": ["trends_payload.json"],
         "anomalies": ["anomalies_payload.json"],
         "report": ["report_payload.json"],
+        "review": ["review_payload.json", "report_payload.json"],
     }.get(task, [])
     for filename in candidates:
         candidate = ai_dir / filename
@@ -95,6 +96,14 @@ def _write_output(path: Path | None, response: AIResponse) -> None:
     path.write_text(response.text + "\n", encoding="utf-8")
 
 
+def _default_output_for_review(input_path: Path, output: Path | None) -> Path | None:
+    if output is not None:
+        return output
+    if input_path.is_dir():
+        return input_path / "ai" / "realism_review.md"
+    return None
+
+
 def _render_response(console: Console, title: str, response: AIResponse, output: Path | None) -> None:
     console.print(Panel(response.text, title=title, border_style="cyan"))
     console.print(
@@ -438,3 +447,45 @@ def report(
     except Exception as exc:
         console.print(f"[bold red]Error:[/bold red] {exc}")
         raise typer.Exit(code=1)
+
+
+@app.command("review")
+def review(
+    input_json: Annotated[Path, typer.Argument(help="Prepared run directory or JSON file with run-level simulation outputs.")],
+    mdmp_cert: Annotated[Optional[Path], typer.Option(help="Signed MDMP artifact required before AI analysis can run.")] = None,
+    mode: Annotated[str, typer.Option(help="AI backend mode. Use 'local' for Ollama/Ministral.")] = "auto",
+    model: Annotated[str, typer.Option(help="Ollama model name to use.")] = DEFAULT_MINISTRAL_MODEL,
+    minimum_grade: Annotated[str, typer.Option(help="Minimum MDMP grade required to allow analysis.")] = "research_grade",
+    public_key: Annotated[Optional[Path], typer.Option(help="Explicit MDMP public key for verification.")] = None,
+    trust_store: Annotated[Optional[Path], typer.Option(help="MDMP trust store for verification.")] = None,
+    ollama_host: Annotated[Optional[str], typer.Option(help="Override the Ollama base URL.")] = None,
+    timeout_seconds: Annotated[float, typer.Option(help="HTTP timeout for Ollama generation requests.")] = 120.0,
+    output: Annotated[Optional[Path], typer.Option(help="Optional file path to save the realism review.")] = None,
+) -> None:
+    console = Console()
+    try:
+        resolved_input, resolved_cert, resolved_public_key = _resolve_cli_inputs(
+            task="review",
+            input_path=input_json,
+            mdmp_cert=mdmp_cert,
+            public_key=public_key,
+            trust_store=trust_store,
+        )
+        payload = _load_json_payload(resolved_input, "Input JSON")
+        assistant = _build_assistant(
+            mdmp_cert=resolved_cert,
+            mode=mode,
+            model=model,
+            minimum_grade=minimum_grade,
+            public_key=resolved_public_key,
+            trust_store=trust_store,
+            ollama_host=ollama_host,
+            timeout_seconds=timeout_seconds,
+        )
+        resolved_output = _default_output_for_review(input_json, output)
+        response = assistant.review_realism(payload)
+        _write_output(resolved_output, response)
+        _render_response(console, "IINTS AI Realism Review", response, resolved_output)
+    except Exception as exc:
+        console.print(f"[bold red]Error:[/bold red] {exc}")
+        raise typer.Exit(code=1)

{iints_sdk_python35-1.4.0 → iints_sdk_python35-1.5.0}/src/iints/ai/prepare.py

@@ -97,6 +97,13 @@ def _sample_trace(df: pd.DataFrame, *, max_rows: int = 48) -> list[dict[str, Any
     return [_normalize_series_record(record) for record in sampled.to_dict(orient="records")]
 
 
+def _max_glucose_delta_per_step(df: pd.DataFrame, glucose_column: str) -> float:
+    clean = pd.to_numeric(df[glucose_column], errors="coerce").dropna()
+    if clean.empty or len(clean) < 2:
+        return 0.0
+    return float(clean.diff().abs().dropna().max())
+
+
 def _position_for_label(df: pd.DataFrame, label: Any) -> int:
     location = df.index.get_loc(label)
     if isinstance(location, int):
@@ -166,9 +173,12 @@ def _build_summary(df: pd.DataFrame, run_metadata: dict[str, Any], audit_summary
         "mean_glucose_mgdl": _normalize_value(float(glucose.mean())),
         "min_glucose_mgdl": _normalize_value(float(glucose.min())),
         "max_glucose_mgdl": _normalize_value(float(glucose.max())),
+        "max_glucose_delta_per_step_mgdl": _normalize_value(_max_glucose_delta_per_step(df, glucose_column)),
         "time_in_range_70_180_pct": _normalize_value(_time_in_band_pct(glucose, 70.0, 180.0)),
         "time_below_70_pct": _normalize_value(float((glucose < 70.0).mean() * 100.0)),
+        "time_below_54_pct": _normalize_value(float((glucose < 54.0).mean() * 100.0)),
         "time_above_180_pct": _normalize_value(float((glucose > 180.0).mean() * 100.0)),
+        "time_above_250_pct": _normalize_value(float((glucose > 250.0).mean() * 100.0)),
         "delivered_insulin_total_units": _normalize_value(_safe_sum(df, "delivered_insulin_units")),
         "recommended_insulin_total_units": _normalize_value(_safe_sum(df, "algo_recommended_insulin_units")),
         "safety_trigger_count": _bool_sum(df, "safety_triggered"),
@@ -228,6 +238,23 @@ def _build_payloads(
             "trace_sample": trace_sample,
             "baseline_comparison": baseline_comparison,
         },
+        "review_payload.json": {
+            **common,
+            "audit_summary": audit_summary,
+            "baseline_comparison": baseline_comparison,
+            "trace_sample": trace_sample,
+            "review_focus": {
+                "goal": "Judge whether the simulation or imported dataset looks physiologically plausible and internally coherent.",
+                "checks": [
+                    "glucose range plausibility",
+                    "excursion size and recovery behavior",
+                    "time in range and severe hypo/hyper exposure",
+                    "insulin delivery realism relative to observed glucose behavior",
+                    "safety trigger and override consistency",
+                ],
+            },
+            "run_manifest": run_manifest,
+        },
         "step_riskiest.json": {
             **common,
             **risk_payload,

{iints_sdk_python35-1.4.0 → iints_sdk_python35-1.5.0}/src/iints/ai/prompts.py

@@ -4,7 +4,13 @@ import json
 from typing import Any, Literal
 
 
-TaskName = Literal["explain_decision", "analyze_trends", "detect_anomalies", "generate_report"]
+TaskName = Literal[
+    "explain_decision",
+    "analyze_trends",
+    "detect_anomalies",
+    "generate_report",
+    "review_realism",
+]
 MAX_PROMPT_PAYLOAD_CHARS = 12000
 
 SYSTEM_PROMPT = (
@@ -52,6 +58,18 @@ TASK_TEMPLATES: dict[TaskName, str] = {
         "5. Research-only conclusion\n\n"
         "Input JSON:\n{data}"
     ),
+    "review_realism": (
+        "Review this simulation or imported-data payload and judge whether the results look physiologically plausible for research use.\n"
+        "Be conservative and do not overclaim. If the payload is incomplete, say so clearly.\n"
+        "Respond in markdown with these sections:\n"
+        "1. Overall realism verdict (Likely realistic / Needs review / Likely unrealistic)\n"
+        "2. Strong realism signals\n"
+        "3. Questionable or unrealistic patterns\n"
+        "4. Concrete feedback points the SDK developer can improve\n"
+        "5. Suggested follow-up validation checks\n\n"
+        "Focus on glycemic ranges, excursion patterns, insulin behavior, safety overrides, and whether the data looks internally coherent.\n\n"
+        "Input JSON:\n{data}"
+    ),
 }
 
 

{iints_sdk_python35-1.4.0 → iints_sdk_python35-1.5.0}/src/iints/analysis/booth_demo.py

@@ -196,6 +196,7 @@ def _build_jury_brief(
             "```bash",
             "iints ai local-check --model ministral-3:3b",
             f"iints ai report {run_outputs['03_supervisor_override']['output_dir']} --model ministral-3:3b",
+            f"iints ai review {run_outputs['03_supervisor_override']['output_dir']} --model ministral-3:3b",
             f"iints ai explain {run_outputs['03_supervisor_override']['output_dir']} --model ministral-3:3b",
             "```",
             "",
@@ -247,6 +248,7 @@ def _build_commands_markdown(
         "```bash\n"
         "iints ai local-check --model ministral-3:3b\n"
         f"iints ai report {supervisor_dir} --model ministral-3:3b\n"
+        f"iints ai review {supervisor_dir} --model ministral-3:3b\n"
         f"iints ai explain {supervisor_dir} --model ministral-3:3b\n"
         "```\n"
     )
@@ -296,6 +298,7 @@ def _build_live_demo_script_text(
         "- If Ollama is ready, run:\n"
         "  iints ai local-check --model ministral-3:3b\n"
         f"  iints ai report {run_outputs['03_supervisor_override']['output_dir']} --model ministral-3:3b\n"
+        f"  iints ai review {run_outputs['03_supervisor_override']['output_dir']} --model ministral-3:3b\n"
         f"  iints ai explain {run_outputs['03_supervisor_override']['output_dir']} --model ministral-3:3b\n"
         "- Say: the local model explains the result, but only after the SDK has prepared the run artifacts.\n\n"
         "7. IF THE JURY ASKS WHY THIS MATTERS\n"

{iints_sdk_python35-1.4.0 → iints_sdk_python35-1.5.0}/src/iints/analysis/carelink_workbench.py

@@ -202,6 +202,23 @@ def _prepare_ai_payloads(
             "profile_24h": profile_records,
             "trace_sample": trace_sample,
         },
+        "review_payload.json": {
+            **common,
+            "daily_summary": daily_records,
+            "profile_24h": profile_records,
+            "trace_sample": trace_sample,
+            "top_alerts": alert_counts,
+            "top_sensor_exceptions": sensor_exception_counts,
+            "review_focus": {
+                "goal": "Judge whether the imported glucose history looks internally coherent and physiologically plausible.",
+                "checks": [
+                    "time in range versus extreme exposure",
+                    "daily variability and day-to-day stability",
+                    "consistency between glucose, carbs, and insulin logs",
+                    "frequency of alerts and sensor exceptions",
+                ],
+            },
+        },
         "anomalies_payload.json": {
             **common,
             "lowest_readings": [

{iints_sdk_python35-1.4.0 → iints_sdk_python35-1.5.0}/src/iints/templates/demos/live_stage_demo.py

@@ -254,6 +254,7 @@ def _build_jury_talk_track(summary: dict[str, Any]) -> str:
             "```bash",
             "iints ai local-check --model ministral-3:3b",
             f"iints ai report {summary['scenarios'][2]['output_dir']} --model ministral-3:3b",
+            f"iints ai review {summary['scenarios'][2]['output_dir']} --model ministral-3:3b",
             f"iints ai explain {summary['scenarios'][2]['output_dir']} --model ministral-3:3b",
             "```",
             "",
@@ -304,6 +305,7 @@ def _build_run_commands(summary: dict[str, Any]) -> str:
         "```bash\n"
         "iints ai local-check --model ministral-3:3b\n"
         f"iints ai report {supervisor_dir} --model ministral-3:3b\n"
+        f"iints ai review {supervisor_dir} --model ministral-3:3b\n"
         f"iints ai explain {supervisor_dir} --model ministral-3:3b\n"
         "```\n"
     )

{iints_sdk_python35-1.4.0 → iints_sdk_python35-1.5.0/src/iints_sdk_python35.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: iints-sdk-python35
-Version: 1.4.0
+Version: 1.5.0
 Summary: A pre-clinical Edge-AI SDK for diabetes management validation.
 Author-email: Rune Bobbaers <rune.bobbaers@gmail.com>
 License-Expression: Apache-2.0
@@ -187,6 +187,7 @@ cd iints_quickstart
 iints presets run --name baseline_t1d --algo algorithms/example_algorithm.py
 iints ai prepare results/<run_id>
 iints ai report results/<run_id>
+iints ai review results/<run_id>
 ```
 
 For imported CareLink data, the matching flow is:
@@ -197,6 +198,7 @@ iints carelink-workbench \
   --output-dir results/personal_carelink
 
 iints ai report results/personal_carelink --model ministral-3:3b
+iints ai review 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
 ```
@@ -217,7 +219,7 @@ Notes:
 - `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 ai prepare`, you can point `iints ai explain|trends|anomalies|report|review` 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.
 

{iints_sdk_python35-1.4.0 → iints_sdk_python35-1.5.0}/src/mdmp_core/cli.py

@@ -1,7 +1,8 @@
 from __future__ import annotations
 
-from pathlib import Path
 import json
+import os
+from pathlib import Path
 
 import pandas as pd
 import typer