iints-sdk-python35 1.5.2__tar.gz → 1.5.4__tar.gz

iints_sdk_python35-1.5.4/PKG-INFO

@@ -0,0 +1,200 @@
+Metadata-Version: 2.4
+Name: iints-sdk-python35
+Version: 1.5.4
+Summary: A pre-clinical Edge-AI SDK for diabetes management validation.
+Author-email: Rune Bobbaers <rune.bobbaers@gmail.com>
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://github.com/python35/IINTS-SDK
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Operating System :: OS Independent
+Classifier: Development Status :: 5 - Production/Stable
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: NOTICE
+License-File: LICENSE-MIT-IINTS-LEGACY
+Requires-Dist: fastapi>=0.115.0
+Requires-Dist: numpy>=1.24.0
+Requires-Dist: pandas>=2.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: PyYAML
+Requires-Dist: rich>=12.0.0
+Requires-Dist: scipy>=1.9.0
+Requires-Dist: typer[all]
+Requires-Dist: uvicorn>=0.30.0
+Provides-Extra: edge
+Requires-Dist: pyserial>=3.5; extra == "edge"
+Provides-Extra: reports
+Requires-Dist: fpdf2>=2.8.0; extra == "reports"
+Requires-Dist: matplotlib>=3.5.0; extra == "reports"
+Requires-Dist: openpyxl>=3.0.0; extra == "reports"
+Requires-Dist: pillow>=12.1.1; extra == "reports"
+Requires-Dist: seaborn>=0.11.0; extra == "reports"
+Provides-Extra: full
+Requires-Dist: fpdf2>=2.8.0; extra == "full"
+Requires-Dist: matplotlib>=3.5.0; extra == "full"
+Requires-Dist: openpyxl>=3.0.0; extra == "full"
+Requires-Dist: pyserial>=3.5; extra == "full"
+Requires-Dist: pillow>=12.1.1; extra == "full"
+Requires-Dist: seaborn>=0.11.0; extra == "full"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: hypothesis>=6.0.0; extra == "dev"
+Requires-Dist: flake8; extra == "dev"
+Requires-Dist: httpx>=0.27.0; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Requires-Dist: pandas-stubs; extra == "dev"
+Requires-Dist: types-PyYAML; extra == "dev"
+Requires-Dist: types-psutil; extra == "dev"
+Provides-Extra: torch
+Requires-Dist: torch>=1.9.0; extra == "torch"
+Provides-Extra: nightscout
+Requires-Dist: py-nightscout; extra == "nightscout"
+Provides-Extra: research
+Requires-Dist: torch>=2.0.0; extra == "research"
+Requires-Dist: pyarrow>=12.0.0; extra == "research"
+Requires-Dist: h5py>=3.10.0; extra == "research"
+Requires-Dist: onnx>=1.16.0; extra == "research"
+Requires-Dist: onnxscript>=0.1.0; extra == "research"
+Provides-Extra: mdmp
+Requires-Dist: cryptography>=42.0.0; extra == "mdmp"
+Dynamic: license-file
+
+# IINTS-AF SDK
+[![EUCYS 2026](https://img.shields.io/badge/EUCYS-2026%20Selected-gold?style=flat)](https://eucys.eu)
+[![PyPI version](https://badge.fury.io/py/iints-sdk-python35.svg)](https://badge.fury.io/py/iints-sdk-python35)
+[![Python Package CI](https://github.com/python35/IINTS-SDK/actions/workflows/python-package.yml/badge.svg)](https://github.com/python35/IINTS-SDK/actions/workflows/python-package.yml)
+[![Docs](https://img.shields.io/badge/docs-IINTS--AF-0a66c2?style=flat&logo=firefox-browser&logoColor=white)](https://python35.github.io/IINTS-SDK/)
+
+> "Code shouldn't be a secret when it's managing a life."
+
+Insulin pumps make hundreds of autonomous decisions about drug delivery every day.  
+The algorithms behind those decisions are proprietary, unauditable, and difficult to inspect or improve, even by the patients whose lives depend on them.
+
+IINTS-AF is an open-source research platform that changes that.
+
+## Core Research Question
+
+**Can open-source simulation and deterministic safety supervision make insulin delivery algorithm development safer and more transparent for researchers and patients?**
+
+---
+
+## What It Does
+
+**Simulate:** Run virtual patients through thousands of scenarios before any algorithm reaches a real device. A deterministic safety supervisor audits every AI decision. The AI may suggest. The supervisor decides.
+
+**Certify:** Every dataset is fingerprinted and graded before it touches a study workflow. The goal is to keep benchmark inputs traceable, reviewable, and reproducible.
+
+**Understand:** Generate audit-ready reports, visual posters, and local AI summaries from the same study bundle. IINTS-AF can use local models such as Ministral for explanation workflows on your own hardware.
+
+---
+
+## Research Results
+
+Final locked benchmark: `3600` simulation runs, `6` profiles, `4` scenario families, `5` algorithms, `10` fixed seeds.
+
+| Metric | ExampleAlgorithm | PID Baseline | Delta |
+|---|---:|---:|---:|
+| Time in Range | 87.16% | 83.72% | +3.44% |
+| Time < 70 mg/dL | 1.28% | 5.25% | -3.97% |
+| Supervisor interventions | 99 | 177 | -78 |
+
+Additional benchmark result:
+- clean certified conditions showed `+17.64` Time-in-Range points versus corrupted uncertified conditions
+
+For the full scientific write-up, see:
+- `research/EUCYS_REPORT.md`
+- `research/EUCYS_REPORT.pdf`
+- `results/eucys_2026/EUCYS_RESULTS/EUCYS_SUMMARY.md`
+
+---
+
+## Install
+
+```bash
+python3 -m venv .venv && source .venv/bin/activate
+pip install -U "iints-sdk-python35[full,mdmp]"
+iints doctor --smoke-run
+```
+
+**Edge devices (Raspberry Pi 5, Arduino UNO Q):**
+
+```bash
+pip install -U "iints-sdk-python35[edge,mdmp]"
+```
+
+---
+
+## Quick Start
+
+```bash
+iints quickstart --project-name my_study
+cd my_study
+iints presets run --name baseline_t1d --algo algorithms/example_algorithm.py
+iints data certify contracts/clinical_mdmp_contract.yaml data/demo/diabetes_cgm.csv --output-json audit/certification.json
+iints ai report results/<run_id>
+```
+
+---
+
+## Final Benchmark Workflow
+
+```bash
+tools/research/run_eucys_final.sh \
+  --algo algorithms/example_algorithm.py \
+  --output-dir results/eucys_2026 \
+  --seeds 1,2,3,4,5,6,7,8,9,10
+```
+
+Then render the report:
+
+```bash
+tools/research/render_eucys_report_pdf.sh
+```
+
+Main final artifacts:
+- `results/eucys_2026/`
+- `results/eucys_2026/EUCYS_RESULTS/EUCYS_MAIN_FIGURE.png`
+- `results/eucys_2026/EUCYS_RESULTS/EUCYS_RESULTS_TABLE.csv`
+- `research/EUCYS_REPORT.md`
+- `research/EUCYS_REPORT.pdf`
+
+---
+
+## Live Digital Patient (Raspberry Pi)
+
+```bash
+iints patient start \
+  --algo algorithms/example_algorithm.py \
+  --scenario-profile expo_hot_start \
+  --mode demo-time --speed 60x
+```
+
+Open `http://127.0.0.1:8765/dashboard`. You will see a virtual patient running continuously, reacting to meals, exercise, and sleep in real time.
+
+---
+
+## Documentation
+
+| | |
+|---|---|
+| Getting started | [Open guide](https://python35.github.io/IINTS-SDK/GETTING_STARTED/) |
+| Edge hardware | [Open guide](https://python35.github.io/IINTS-SDK/EDGE_HARDWARE/) |
+| Raspberry Pi setup | [Open guide](https://python35.github.io/IINTS-SDK/DIGITAL_PATIENT_PI/) |
+| Data certification | [Open guide](https://python35.github.io/IINTS-SDK/MDMP_QUICKSTART/) |
+| Full manual | [Open PDF manual](https://python35.github.io/IINTS-SDK/manuals/IINTS-AF_SDK_Manual.pdf) |
+| Research report | [Open report source](research/EUCYS_REPORT.md) |
+
+---
+
+> IINTS-AF is research software. Not a medical device.  
+> No clinical dosing advice. MIT Licensed.
+
+---
+
+*Built by a 17-year-old with type 1 diabetes who wanted to 
+understand the device managing his life.*

iints_sdk_python35-1.5.4/README.md

@@ -0,0 +1,134 @@
+# IINTS-AF SDK
+[![EUCYS 2026](https://img.shields.io/badge/EUCYS-2026%20Selected-gold?style=flat)](https://eucys.eu)
+[![PyPI version](https://badge.fury.io/py/iints-sdk-python35.svg)](https://badge.fury.io/py/iints-sdk-python35)
+[![Python Package CI](https://github.com/python35/IINTS-SDK/actions/workflows/python-package.yml/badge.svg)](https://github.com/python35/IINTS-SDK/actions/workflows/python-package.yml)
+[![Docs](https://img.shields.io/badge/docs-IINTS--AF-0a66c2?style=flat&logo=firefox-browser&logoColor=white)](https://python35.github.io/IINTS-SDK/)
+
+> "Code shouldn't be a secret when it's managing a life."
+
+Insulin pumps make hundreds of autonomous decisions about drug delivery every day.  
+The algorithms behind those decisions are proprietary, unauditable, and difficult to inspect or improve, even by the patients whose lives depend on them.
+
+IINTS-AF is an open-source research platform that changes that.
+
+## Core Research Question
+
+**Can open-source simulation and deterministic safety supervision make insulin delivery algorithm development safer and more transparent for researchers and patients?**
+
+---
+
+## What It Does
+
+**Simulate:** Run virtual patients through thousands of scenarios before any algorithm reaches a real device. A deterministic safety supervisor audits every AI decision. The AI may suggest. The supervisor decides.
+
+**Certify:** Every dataset is fingerprinted and graded before it touches a study workflow. The goal is to keep benchmark inputs traceable, reviewable, and reproducible.
+
+**Understand:** Generate audit-ready reports, visual posters, and local AI summaries from the same study bundle. IINTS-AF can use local models such as Ministral for explanation workflows on your own hardware.
+
+---
+
+## Research Results
+
+Final locked benchmark: `3600` simulation runs, `6` profiles, `4` scenario families, `5` algorithms, `10` fixed seeds.
+
+| Metric | ExampleAlgorithm | PID Baseline | Delta |
+|---|---:|---:|---:|
+| Time in Range | 87.16% | 83.72% | +3.44% |
+| Time < 70 mg/dL | 1.28% | 5.25% | -3.97% |
+| Supervisor interventions | 99 | 177 | -78 |
+
+Additional benchmark result:
+- clean certified conditions showed `+17.64` Time-in-Range points versus corrupted uncertified conditions
+
+For the full scientific write-up, see:
+- `research/EUCYS_REPORT.md`
+- `research/EUCYS_REPORT.pdf`
+- `results/eucys_2026/EUCYS_RESULTS/EUCYS_SUMMARY.md`
+
+---
+
+## Install
+
+```bash
+python3 -m venv .venv && source .venv/bin/activate
+pip install -U "iints-sdk-python35[full,mdmp]"
+iints doctor --smoke-run
+```
+
+**Edge devices (Raspberry Pi 5, Arduino UNO Q):**
+
+```bash
+pip install -U "iints-sdk-python35[edge,mdmp]"
+```
+
+---
+
+## Quick Start
+
+```bash
+iints quickstart --project-name my_study
+cd my_study
+iints presets run --name baseline_t1d --algo algorithms/example_algorithm.py
+iints data certify contracts/clinical_mdmp_contract.yaml data/demo/diabetes_cgm.csv --output-json audit/certification.json
+iints ai report results/<run_id>
+```
+
+---
+
+## Final Benchmark Workflow
+
+```bash
+tools/research/run_eucys_final.sh \
+  --algo algorithms/example_algorithm.py \
+  --output-dir results/eucys_2026 \
+  --seeds 1,2,3,4,5,6,7,8,9,10
+```
+
+Then render the report:
+
+```bash
+tools/research/render_eucys_report_pdf.sh
+```
+
+Main final artifacts:
+- `results/eucys_2026/`
+- `results/eucys_2026/EUCYS_RESULTS/EUCYS_MAIN_FIGURE.png`
+- `results/eucys_2026/EUCYS_RESULTS/EUCYS_RESULTS_TABLE.csv`
+- `research/EUCYS_REPORT.md`
+- `research/EUCYS_REPORT.pdf`
+
+---
+
+## Live Digital Patient (Raspberry Pi)
+
+```bash
+iints patient start \
+  --algo algorithms/example_algorithm.py \
+  --scenario-profile expo_hot_start \
+  --mode demo-time --speed 60x
+```
+
+Open `http://127.0.0.1:8765/dashboard`. You will see a virtual patient running continuously, reacting to meals, exercise, and sleep in real time.
+
+---
+
+## Documentation
+
+| | |
+|---|---|
+| Getting started | [Open guide](https://python35.github.io/IINTS-SDK/GETTING_STARTED/) |
+| Edge hardware | [Open guide](https://python35.github.io/IINTS-SDK/EDGE_HARDWARE/) |
+| Raspberry Pi setup | [Open guide](https://python35.github.io/IINTS-SDK/DIGITAL_PATIENT_PI/) |
+| Data certification | [Open guide](https://python35.github.io/IINTS-SDK/MDMP_QUICKSTART/) |
+| Full manual | [Open PDF manual](https://python35.github.io/IINTS-SDK/manuals/IINTS-AF_SDK_Manual.pdf) |
+| Research report | [Open report source](research/EUCYS_REPORT.md) |
+
+---
+
+> IINTS-AF is research software. Not a medical device.  
+> No clinical dosing advice. MIT Licensed.
+
+---
+
+*Built by a 17-year-old with type 1 diabetes who wanted to 
+understand the device managing his life.*

{iints_sdk_python35-1.5.2 → iints_sdk_python35-1.5.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "iints-sdk-python35" 
-version = "1.5.2"
+version = "1.5.4"
 authors = [
   { name="Rune Bobbaers", email="rune.bobbaers@gmail.com" },
 ]
@@ -35,7 +35,9 @@ dependencies = [
 ]
 
 [project.optional-dependencies]
-edge = []
+edge = [
+  "pyserial>=3.5",
+]
 reports = [
   "fpdf2>=2.8.0",
   "matplotlib>=3.5.0",
@@ -47,6 +49,7 @@ full = [
   "fpdf2>=2.8.0",
   "matplotlib>=3.5.0",
   "openpyxl>=3.0.0",
+  "pyserial>=3.5",
   "pillow>=12.1.1",
   "seaborn>=0.11.0",
 ]
@@ -54,6 +57,7 @@ dev = [
   "pytest>=7.0.0",
   "hypothesis>=6.0.0",
   "flake8",
+  "httpx>=0.27.0",
   "mypy",
   "pandas-stubs",
   "types-PyYAML",

{iints_sdk_python35-1.5.2 → iints_sdk_python35-1.5.4}/src/iints/__init__.py

@@ -1,7 +1,7 @@
 # src/iints/__init__.py
 
 import pandas as pd # Required for type hints like pd.DataFrame
-from typing import Optional
+from typing import Any, Optional
 
 try:
     from importlib.metadata import PackageNotFoundError, version
@@ -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.5.2"
+    __version__ = "1.5.4"
 
 # 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.
@@ -95,9 +95,26 @@ from .live_patient import (
     summarize_edge_workspace,
     write_edge_update_script,
 )
-from .highlevel import run_simulation, run_full, run_population
 from .scenarios import ScenarioGeneratorConfig, generate_random_scenario
 
+
+def run_simulation(*args: Any, **kwargs: Any) -> Any:
+    from .highlevel import run_simulation as _run_simulation
+
+    return _run_simulation(*args, **kwargs)
+
+
+def run_full(*args: Any, **kwargs: Any) -> Any:
+    from .highlevel import run_full as _run_full
+
+    return _run_full(*args, **kwargs)
+
+
+def run_population(*args: Any, **kwargs: Any) -> Any:
+    from .highlevel import run_population as _run_population
+
+    return _run_population(*args, **kwargs)
+
 try:
     from .analysis.booth_demo import build_booth_demo
 except Exception as exc:  # pragma: no cover - optional reports stack

{iints_sdk_python35-1.5.2 → iints_sdk_python35-1.5.4}/src/iints/ai/cli.py

@@ -160,7 +160,7 @@ def _render_local_check(console: Console, status: dict[str, object]) -> None:
         console.print("[bold red]Ollama is too old for the open Ministral 3 runtime.[/bold red]")
 
 
-@app.command("models")
+@app.command(name="models")
 def models() -> None:
     console = Console()
     table = Table(title="IINTS AI Local Mistral Model Guide")
@@ -189,7 +189,7 @@ def models() -> None:
     )
 
 
-@app.command("prepare")
+@app.command(name="prepare")
 def prepare(
     run_dir: Annotated[Path, typer.Argument(help="Run output directory containing results.csv and run_metadata.json.")],
     create_dev_mdmp_cert: Annotated[
@@ -254,7 +254,7 @@ def _build_assistant(
     )
 
 
-@app.command("local-check")
+@app.command(name="local-check")
 def local_check(
     model: Annotated[str, typer.Option(help="Ollama model name to validate locally.")] = DEFAULT_MINISTRAL_MODEL,
     ollama_host: Annotated[Optional[str], typer.Option(help="Override the Ollama base URL.")] = None,
@@ -294,7 +294,7 @@ def local_check(
         raise typer.Exit(code=1)
 
 
-@app.command("explain")
+@app.command(name="explain")
 def explain(
     input_json: Annotated[Path, typer.Argument(help="Prepared run directory or JSON file with a single simulation step or decision context.")],
     mdmp_cert: Annotated[Optional[Path], typer.Option(help="Signed MDMP artifact required before AI analysis can run.")] = None,
@@ -335,7 +335,7 @@ def explain(
         raise typer.Exit(code=1)
 
 
-@app.command("trends")
+@app.command(name="trends")
 def trends(
     input_json: Annotated[Path, typer.Argument(help="Prepared run directory or JSON file with glucose trace data or a run payload.")],
     mdmp_cert: Annotated[Optional[Path], typer.Option(help="Signed MDMP artifact required before AI analysis can run.")] = None,
@@ -376,7 +376,7 @@ def trends(
         raise typer.Exit(code=1)
 
 
-@app.command("anomalies")
+@app.command(name="anomalies")
 def anomalies(
     input_json: Annotated[Path, typer.Argument(help="Prepared run directory or JSON file with simulation results or run summary.")],
     mdmp_cert: Annotated[Optional[Path], typer.Option(help="Signed MDMP artifact required before AI analysis can run.")] = None,
@@ -417,7 +417,7 @@ def anomalies(
         raise typer.Exit(code=1)
 
 
-@app.command("report")
+@app.command(name="report")
 def report(
     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,
@@ -458,7 +458,7 @@ def report(
         raise typer.Exit(code=1)
 
 
-@app.command("review")
+@app.command(name="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,

{iints_sdk_python35-1.5.2 → iints_sdk_python35-1.5.4}/src/iints/analysis/__init__.py

@@ -1,10 +1,26 @@
 from .clinical_metrics import ClinicalMetricsCalculator, ClinicalMetricsResult
 from .baseline import compute_metrics, run_baseline_comparison, write_baseline_comparison
+from .study_engine import (
+    StudyAlgorithmSpec,
+    StudyArmSpec,
+    StudyDesignPayload,
+    StudyMatrixRow,
+    StudyProfileSpec,
+    build_algorithm_registry,
+    build_study_design_payload,
+    resolve_profile_specs,
+)
 from .study_protocol import (
     build_study_protocol_payload,
     render_study_protocol_markdown,
     write_study_protocol_bundle,
 )
+from .study_experiment import (
+    StudyExperimentConfig,
+    build_study_experiment_template,
+    load_study_experiment_config,
+    render_study_experiment_yaml,
+)
 from .study_analysis import (
     analyze_run_directory,
     analyze_study_directory,
@@ -15,6 +31,15 @@ from .study_analysis import (
     StudyRunSummary,
     StudySummary,
 )
+from .eucys_results import (
+    build_eucys_abstract_draft_markdown,
+    build_eucys_filled_abstract_markdown,
+    build_eucys_jury_qa_markdown,
+    build_eucys_limitations_and_ethics_markdown,
+    build_eucys_poster_outline_markdown,
+    generate_eucys_main_figure,
+    generate_eucys_results_bundle,
+)
 
 
 def _missing_reports_dependency(feature: str, exc: Exception) -> None:
@@ -80,15 +105,34 @@ __all__ = [
     "ClinicalReportGenerator",
     "compute_metrics",
     "compare_studies",
+    "build_eucys_abstract_draft_markdown",
+    "build_eucys_filled_abstract_markdown",
+    "build_eucys_jury_qa_markdown",
+    "build_eucys_limitations_and_ethics_markdown",
+    "build_eucys_poster_outline_markdown",
+    "generate_eucys_main_figure",
+    "resolve_profile_specs",
+    "generate_eucys_results_bundle",
     "generate_results_poster",
     "generate_study_poster",
+    "build_algorithm_registry",
+    "build_study_design_payload",
     "build_study_protocol_payload",
+    "build_study_experiment_template",
     "render_study_protocol_markdown",
+    "render_study_experiment_yaml",
     "write_study_protocol_bundle",
+    "load_study_experiment_config",
     "load_study_summary",
     "quality_badges_for_metrics",
     "run_baseline_comparison",
+    "StudyAlgorithmSpec",
+    "StudyArmSpec",
     "StudyComparison",
+    "StudyDesignPayload",
+    "StudyExperimentConfig",
+    "StudyMatrixRow",
+    "StudyProfileSpec",
     "StudyRunSummary",
     "StudySummary",
     "write_baseline_comparison",

{iints_sdk_python35-1.5.2 → iints_sdk_python35-1.5.4}/src/iints/analysis/baseline.py

@@ -8,10 +8,12 @@ import pandas as pd
 
 from iints.analysis.clinical_metrics import ClinicalMetricsCalculator
 from iints.api.base_algorithm import InsulinAlgorithm
+from iints.core.algorithms.clinical_baseline import ClinicalBaselineAlgorithm
 from iints.core.algorithms.pid_controller import PIDController
 from iints.core.algorithms.standard_pump_algo import StandardPumpAlgorithm
 from iints.core.patient.models import PatientModel
 from iints.core.simulator import Simulator
+from iints.utils.csv_safety import sanitize_csv_dataframe
 from iints.validation import build_stress_events
 
 
@@ -50,7 +52,10 @@ def run_baseline_comparison(
         }
     )
 
-    baselines: List[Tuple[str, InsulinAlgorithm]] = [("Standard PID", PIDController())]
+    baselines: List[Tuple[str, InsulinAlgorithm]] = [
+        ("Clinical Baseline", ClinicalBaselineAlgorithm()),
+        ("Standard PID", PIDController()),
+    ]
     if compare_standard_pump:
         baselines.append(("Standard Pump", StandardPumpAlgorithm()))
 
@@ -88,5 +93,5 @@ def write_baseline_comparison(comparison: Dict[str, Any], output_dir: Path) -> D
     json_path = output_dir / "baseline_comparison.json"
     csv_path = output_dir / "baseline_comparison.csv"
     json_path.write_text(json.dumps(comparison, indent=2))
-    pd.DataFrame(comparison.get("rows", [])).to_csv(csv_path, index=False)
+    sanitize_csv_dataframe(pd.DataFrame(comparison.get("rows", []))).to_csv(csv_path, index=False)
     return {"json": str(json_path), "csv": str(csv_path)}