iints-sdk-python35 0.1.22__tar.gz → 1.0.0__tar.gz

iints_sdk_python35-1.0.0/PKG-INFO

@@ -0,0 +1,154 @@
+Metadata-Version: 2.4
+Name: iints-sdk-python35
+Version: 1.0.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
+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: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Development Status :: 5 - Production/Stable
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fpdf2>=2.8.0
+Requires-Dist: matplotlib>=3.5.0
+Requires-Dist: numpy>=1.24.0
+Requires-Dist: openpyxl>=3.0.0
+Requires-Dist: pandas>=2.0.0
+Requires-Dist: pillow>=12.1.1
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: PyYAML
+Requires-Dist: rich>=12.0.0
+Requires-Dist: scipy>=1.9.0
+Requires-Dist: seaborn>=0.11.0
+Requires-Dist: typer[all]
+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: 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: mdmp-protocol>=0.2.1; extra == "mdmp"
+Dynamic: license-file
+
+# IINTS-AF SDK
+[![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)
+[![Site](https://img.shields.io/badge/site-IINTS--AF-0a66c2?style=flat&logo=firefox-browser&logoColor=white)](https://python35.github.io/IINTS-Site/index.html)
+
+IINTS-AF is a safety-first SDK for insulin-algorithm research.
+It lets you simulate, validate, and report results with reproducible artifacts.
+
+Docs (GitHub Pages): [python35.github.io/IINTS-SDK](https://python35.github.io/IINTS-SDK/)
+
+## What You Can Do
+- Run virtual patient simulations.
+- Test algorithm safety gates (deterministic supervisor).
+- Add optional AI glucose forecasting.
+- Validate datasets before training/evaluation.
+- Generate audit-ready CSV/JSON/PDF/HTML outputs.
+
+## Quick Start
+```bash
+python3 -m venv .venv
+source .venv/bin/activate
+python -m pip install -U pip
+pip install iints-sdk-python35
+```
+
+```bash
+iints doctor --smoke-run
+iints quickstart --project-name iints_quickstart
+cd iints_quickstart
+iints presets run --name baseline_t1d --algo algorithms/example_algorithm.py
+```
+
+## MDMP (Short)
+MDMP is the data-quality protocol used by IINTS.
+
+- `Contract`: defines expected columns, types, units, and bounds.
+- `Validation`: checks a dataset against the contract.
+- `Fingerprint + Grade`: writes deterministic hashes and a grade (`draft`, `research_grade`, `clinical_grade`).
+- `Visualizer`: builds a single-file HTML report for audits.
+
+Use the dedicated namespace:
+
+```bash
+iints mdmp template --output-path mdmp_contract.yaml
+iints mdmp validate mdmp_contract.yaml data/my_cgm.csv --output-json results/mdmp_report.json
+iints mdmp visualizer results/mdmp_report.json --output-html results/mdmp_dashboard.html
+```
+
+Use standalone MDMP backend (optional):
+
+```bash
+export IINTS_MDMP_BACKEND=mdmp_core
+```
+
+Staleness / lineage checks (standalone MDMP CLI):
+
+```bash
+mdmp fingerprint-record data/my_cgm.csv --output-json results/fingerprint.json --expires-days 365
+mdmp fingerprint-check results/fingerprint.json data/my_cgm.csv
+mdmp lineage-card-refresh results/mdmp_model_card.yaml
+mdmp registry init --registry registry/mdmp_registry.json
+mdmp registry push --registry registry/mdmp_registry.json --report results/mdmp_report.json
+```
+
+## Dual Repo Workflow
+- SDK repo: `python35/IINTS-SDK`
+- MDMP repo: `python35/MDMP`
+
+Local helper scripts:
+- `tools/local/dual_repo_status.sh`
+- `tools/local/dual_repo_commit_push.sh`
+
+Full process: `docs/DUAL_REPO_WORKFLOW.md`
+
+MDMP sync CI gate:
+- `.github/workflows/mdmp-sync.yml`
+- Pulls the public `python35/MDMP` repo directly.
+- Auto dependency updates for MDMP are handled via Dependabot (`.github/dependabot.yml`).
+
+## Typical Workflow
+1. Prepare or import data.
+2. Validate data with MDMP.
+3. Run simulation or forecast evaluation.
+4. Review report artifacts and metrics.
+
+## Key Commands
+```bash
+iints run-full --algo algorithms/example_algorithm.py --scenario-path scenarios/clinic_safe_baseline.json --output-dir results/run_full
+iints scorecard --algo algorithms/example_algorithm.py --profile research_default --output-dir results/scorecard
+iints study-ready --algo algorithms/example_algorithm.py --output-dir results/study_ready
+iints sources --output-json results/source_manifest.json
+```
+
+## Documentation
+- Docs site: [python35.github.io/IINTS-SDK](https://python35.github.io/IINTS-SDK/)
+- Plain guide: [docs/PLAIN_LANGUAGE_GUIDE.md](https://github.com/python35/IINTS-SDK/blob/main/docs/PLAIN_LANGUAGE_GUIDE.md)
+- Comprehensive guide: [docs/COMPREHENSIVE_GUIDE.md](https://github.com/python35/IINTS-SDK/blob/main/docs/COMPREHENSIVE_GUIDE.md)
+- MDMP draft: [docs/MDMP.md](https://github.com/python35/IINTS-SDK/blob/main/docs/MDMP.md)
+- Demos: [examples/demos](https://github.com/python35/IINTS-SDK/tree/main/examples/demos)
+- Notebooks: [examples/notebooks](https://github.com/python35/IINTS-SDK/tree/main/examples/notebooks)
+
+## Safety Notice
+For research use only. Not a medical device. No clinical dosing advice.

iints_sdk_python35-1.0.0/README.md

@@ -0,0 +1,103 @@
+# IINTS-AF SDK
+[![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)
+[![Site](https://img.shields.io/badge/site-IINTS--AF-0a66c2?style=flat&logo=firefox-browser&logoColor=white)](https://python35.github.io/IINTS-Site/index.html)
+
+IINTS-AF is a safety-first SDK for insulin-algorithm research.
+It lets you simulate, validate, and report results with reproducible artifacts.
+
+Docs (GitHub Pages): [python35.github.io/IINTS-SDK](https://python35.github.io/IINTS-SDK/)
+
+## What You Can Do
+- Run virtual patient simulations.
+- Test algorithm safety gates (deterministic supervisor).
+- Add optional AI glucose forecasting.
+- Validate datasets before training/evaluation.
+- Generate audit-ready CSV/JSON/PDF/HTML outputs.
+
+## Quick Start
+```bash
+python3 -m venv .venv
+source .venv/bin/activate
+python -m pip install -U pip
+pip install iints-sdk-python35
+```
+
+```bash
+iints doctor --smoke-run
+iints quickstart --project-name iints_quickstart
+cd iints_quickstart
+iints presets run --name baseline_t1d --algo algorithms/example_algorithm.py
+```
+
+## MDMP (Short)
+MDMP is the data-quality protocol used by IINTS.
+
+- `Contract`: defines expected columns, types, units, and bounds.
+- `Validation`: checks a dataset against the contract.
+- `Fingerprint + Grade`: writes deterministic hashes and a grade (`draft`, `research_grade`, `clinical_grade`).
+- `Visualizer`: builds a single-file HTML report for audits.
+
+Use the dedicated namespace:
+
+```bash
+iints mdmp template --output-path mdmp_contract.yaml
+iints mdmp validate mdmp_contract.yaml data/my_cgm.csv --output-json results/mdmp_report.json
+iints mdmp visualizer results/mdmp_report.json --output-html results/mdmp_dashboard.html
+```
+
+Use standalone MDMP backend (optional):
+
+```bash
+export IINTS_MDMP_BACKEND=mdmp_core
+```
+
+Staleness / lineage checks (standalone MDMP CLI):
+
+```bash
+mdmp fingerprint-record data/my_cgm.csv --output-json results/fingerprint.json --expires-days 365
+mdmp fingerprint-check results/fingerprint.json data/my_cgm.csv
+mdmp lineage-card-refresh results/mdmp_model_card.yaml
+mdmp registry init --registry registry/mdmp_registry.json
+mdmp registry push --registry registry/mdmp_registry.json --report results/mdmp_report.json
+```
+
+## Dual Repo Workflow
+- SDK repo: `python35/IINTS-SDK`
+- MDMP repo: `python35/MDMP`
+
+Local helper scripts:
+- `tools/local/dual_repo_status.sh`
+- `tools/local/dual_repo_commit_push.sh`
+
+Full process: `docs/DUAL_REPO_WORKFLOW.md`
+
+MDMP sync CI gate:
+- `.github/workflows/mdmp-sync.yml`
+- Pulls the public `python35/MDMP` repo directly.
+- Auto dependency updates for MDMP are handled via Dependabot (`.github/dependabot.yml`).
+
+## Typical Workflow
+1. Prepare or import data.
+2. Validate data with MDMP.
+3. Run simulation or forecast evaluation.
+4. Review report artifacts and metrics.
+
+## Key Commands
+```bash
+iints run-full --algo algorithms/example_algorithm.py --scenario-path scenarios/clinic_safe_baseline.json --output-dir results/run_full
+iints scorecard --algo algorithms/example_algorithm.py --profile research_default --output-dir results/scorecard
+iints study-ready --algo algorithms/example_algorithm.py --output-dir results/study_ready
+iints sources --output-json results/source_manifest.json
+```
+
+## Documentation
+- Docs site: [python35.github.io/IINTS-SDK](https://python35.github.io/IINTS-SDK/)
+- Plain guide: [docs/PLAIN_LANGUAGE_GUIDE.md](https://github.com/python35/IINTS-SDK/blob/main/docs/PLAIN_LANGUAGE_GUIDE.md)
+- Comprehensive guide: [docs/COMPREHENSIVE_GUIDE.md](https://github.com/python35/IINTS-SDK/blob/main/docs/COMPREHENSIVE_GUIDE.md)
+- MDMP draft: [docs/MDMP.md](https://github.com/python35/IINTS-SDK/blob/main/docs/MDMP.md)
+- Demos: [examples/demos](https://github.com/python35/IINTS-SDK/tree/main/examples/demos)
+- Notebooks: [examples/notebooks](https://github.com/python35/IINTS-SDK/tree/main/examples/notebooks)
+
+## Safety Notice
+For research use only. Not a medical device. No clinical dosing advice.

{iints_sdk_python35-0.1.22 → iints_sdk_python35-1.0.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "iints-sdk-python35" 
-version = "0.1.22"
+version = "1.0.0"
 authors = [
   { name="Rune Bobbaers", email="rune.bobbaers@gmail.com" },
 ]
@@ -19,7 +19,7 @@ classifiers = [
     "Programming Language :: Python :: 3.13",
     "License :: OSI Approved :: MIT License",
     "Operating System :: OS Independent",
-    "Development Status :: 3 - Alpha",
+    "Development Status :: 5 - Production/Stable",
 ]
 dependencies = [
     "fpdf2>=2.8.0",
@@ -59,6 +59,9 @@ research = [
   "onnx>=1.16.0",
   "onnxscript>=0.1.0",
 ]
+mdmp = [
+  "mdmp-protocol>=0.2.1",
+]
 
 [project.scripts]
 iints = "iints.cli.cli:app"

{iints_sdk_python35-0.1.22 → iints_sdk_python35-1.0.0}/src/iints/cli/cli.py

@@ -15,6 +15,7 @@ import time
 import yaml # Added for Virtual Patient Registry
 import pandas as pd # Added for DataFrame in benchmark results
 import numpy as np
+from typer.core import TyperGroup
 
 from rich.console import Console  # type: ignore # For pretty printing
 from rich.table import Table  # type: ignore # For comparison table
@@ -45,13 +46,15 @@ from iints.data.registry import (
     DatasetRegistryError,
 )
 from iints.data.contracts import load_contract_yaml
-from iints.data.runner import (
-    ContractRunner,
+from iints.data.synthetic_mirror import generate_synthetic_mirror
+from iints.mdmp.backend import (
     MDMP_GRADE_ORDER,
+    active_mdmp_backend,
+    build_mdmp_dashboard_html,
+    load_mdmp_contract,
     mdmp_grade_meets_minimum,
+    run_mdmp_validation,
 )
-from iints.data.mdmp_visualizer import build_mdmp_dashboard_html
-from iints.data.synthetic_mirror import generate_synthetic_mirror
 from iints.utils.run_io import (
     build_run_metadata,
     build_run_manifest,
@@ -84,7 +87,33 @@ from iints.validation import (
 )
 
 
-app = typer.Typer(help="IINTS-AF SDK CLI - Intelligent Insulin Titration System for Artificial Pancreas research.")
+IINTS_ASCII_LOGO = r"""
+ /$$$$$$ /$$$$$$ /$$   /$$ /$$$$$$$$ /$$$$$$           /$$$$$$  /$$$$$$$  /$$   /$$
+|_  $$_/|_  $$_/| $$$ | $$|__  $$__//$$__  $$         /$$__  $$| $$__  $$| $$  /$$/
+  | $$    | $$  | $$$$| $$   | $$  | $$  \__/        | $$  \__/| $$  \ $$| $$ /$$/
+  | $$    | $$  | $$ $$ $$   | $$  |  $$$$$$  /$$$$$$|  $$$$$$ | $$  | $$| $$$$$/
+  | $$    | $$  | $$  $$$$   | $$   \____  $$|______/ \____  $$| $$  | $$| $$  $$
+  | $$    | $$  | $$\  $$$   | $$   /$$  \ $$         /$$  \ $$| $$  | $$| $$\  $$
+ /$$$$$$ /$$$$$$| $$ \  $$   | $$  |  $$$$$$/        |  $$$$$$/| $$$$$$$/| $$ \  $$
+|______/|______/|__/  \__/   |__/   \______/          \______/ |_______/ |__/  \__/
+"""
+
+APP_HELP = (
+    "IINTS-AF SDK CLI - Intelligent Insulin Titration System for Artificial Pancreas research."
+)
+
+
+class BrandedTyperGroup(TyperGroup):
+    def get_help(self, ctx):  # type: ignore[override]
+        return f"{IINTS_ASCII_LOGO}\n\n{super().get_help(ctx)}"
+
+
+app = typer.Typer(
+    help=APP_HELP,
+    context_settings={"max_content_width": 120},
+    cls=BrandedTyperGroup,
+    rich_markup_mode=None,
+)
 docs_app = typer.Typer(help="Generate documentation and technical summaries for IINTS-AF components.")
 presets_app = typer.Typer(help="Clinic-safe presets and quickstart runs.")
 profiles_app = typer.Typer(help="Patient profiles and physiological presets.")
@@ -2809,16 +2838,37 @@ def _build_data_contract_template() -> Dict[str, Any]:
     }
 
 
+def _build_mdmp_core_contract_template() -> Dict[str, Any]:
+    return {
+        "schema": {
+            "name": "cgm_dataset",
+            "version": "1.0",
+            "industry": "health",
+            "columns": [
+                {"name": "timestamp", "type": "datetime", "required": True},
+                {"name": "glucose", "type": "float", "unit": "mg/dL", "bounds": [40, 400], "required": True},
+            ],
+        },
+        "consent": {
+            "ai_training_allowed": True,
+            "jurisdiction": "GDPR",
+            "anonymized": True,
+        },
+    }
+
+
 @data_app.command("contract-template")
 def data_contract_template(
     output_path: Annotated[Path, typer.Option(help="Where to write the starter contract YAML")] = Path("data_contract.yaml"),
 ):
     """Write a starter data contract template for model-ready validation."""
     console = Console()
-    template = _build_data_contract_template()
+    backend = active_mdmp_backend()
+    template = _build_mdmp_core_contract_template() if backend == "mdmp_core" else _build_data_contract_template()
     output_path.parent.mkdir(parents=True, exist_ok=True)
     output_path.write_text(yaml.safe_dump(template, sort_keys=False))
     console.print(f"[green]Contract template written:[/green] {output_path}")
+    console.print(f"[cyan]Template backend:[/cyan] {backend}")
 
 
 @data_app.command("contract-run")
@@ -2843,10 +2893,13 @@ def data_contract_run(
         raise typer.Exit(code=1)
 
     try:
-        contract = load_contract_yaml(contract_path)
+        contract = load_mdmp_contract(contract_path)
         df = pd.read_csv(input_csv)
-        runner = ContractRunner(contract)
-        report = runner.run(df, apply_builtin_transforms=apply_builtin_transforms)
+        report = run_mdmp_validation(
+            contract,
+            df,
+            apply_builtin_transforms=apply_builtin_transforms,
+        )
     except Exception as exc:
         console.print(f"[bold red]Contract runner failed: {exc}[/bold red]")
         raise typer.Exit(code=1)
@@ -2857,6 +2910,7 @@ def data_contract_run(
     summary.add_row("Rows", str(report.row_count))
     summary.add_row("Compliance", f"{report.compliance_score:.2f}%")
     summary.add_row("Status", "[green]PASS[/green]" if report.is_compliant else "[red]FAIL[/red]")
+    summary.add_row("Backend", active_mdmp_backend())
     summary.add_row("MDMP grade", report.mdmp_grade)
     summary.add_row("MDMP protocol", report.mdmp_protocol_version)
     summary.add_row(

{iints_sdk_python35-0.1.22 → iints_sdk_python35-1.0.0}/src/iints/mdmp/__init__.py

@@ -29,6 +29,16 @@ from ..data.runner import (
 from ..data.guardians import mdmp_gate, MDMPGateError
 from ..data.synthetic_mirror import generate_synthetic_mirror, SyntheticMirrorArtifact
 from ..data.mdmp_visualizer import build_mdmp_dashboard_html
+from .backend import (
+    MDMPValidationResult,
+    MDMPCheckResult,
+    MDMP_GRADE_ORDER as BACKEND_MDMP_GRADE_ORDER,
+    mdmp_grade_meets_minimum as backend_mdmp_grade_meets_minimum,
+    active_mdmp_backend,
+    load_mdmp_contract,
+    run_mdmp_validation,
+    build_mdmp_dashboard_html as build_mdmp_dashboard_html_with_backend,
+)
 
 __all__ = [
     "StreamSpec",
@@ -53,5 +63,12 @@ __all__ = [
     "generate_synthetic_mirror",
     "SyntheticMirrorArtifact",
     "build_mdmp_dashboard_html",
+    "MDMPValidationResult",
+    "MDMPCheckResult",
+    "BACKEND_MDMP_GRADE_ORDER",
+    "backend_mdmp_grade_meets_minimum",
+    "active_mdmp_backend",
+    "load_mdmp_contract",
+    "run_mdmp_validation",
+    "build_mdmp_dashboard_html_with_backend",
 ]
-

iints_sdk_python35-1.0.0/src/iints/mdmp/backend.py

@@ -0,0 +1,185 @@
+from __future__ import annotations
+
+from dataclasses import dataclass
+import os
+from pathlib import Path
+from typing import Any, Iterable, List, Optional
+
+import pandas as pd
+import yaml
+
+from iints.data.contracts import load_contract_yaml as _load_iints_contract_yaml
+from iints.data.mdmp_visualizer import build_mdmp_dashboard_html as _build_iints_dashboard_html
+from iints.data.runner import ContractRunner as _IintsContractRunner
+
+
+try:  # Optional standalone MDMP backend
+    from mdmp_core.contracts import load_contract as _load_external_contract
+    from mdmp_core.runner import ContractRunner as _ExternalContractRunner
+    from mdmp_core.visualizer import build_dashboard_html as _build_external_dashboard_html
+
+    _EXTERNAL_MDMP_AVAILABLE = True
+except Exception:  # pragma: no cover - depends on optional install
+    _EXTERNAL_MDMP_AVAILABLE = False
+
+
+MDMP_GRADE_ORDER = ("raw", "draft", "research_grade", "clinical_grade", "ai_ready")
+
+
+@dataclass(frozen=True)
+class MDMPCheckResult:
+    name: str
+    passed: bool
+    detail: str
+    failed_rows: int = 0
+
+    def to_dict(self) -> dict[str, Any]:
+        return {
+            "name": self.name,
+            "passed": self.passed,
+            "detail": self.detail,
+            "failed_rows": self.failed_rows,
+        }
+
+
+@dataclass(frozen=True)
+class MDMPValidationResult:
+    is_compliant: bool
+    compliance_score: float
+    mdmp_grade: str
+    mdmp_protocol_version: str
+    certified_for_medical_research: bool
+    contract_fingerprint_sha256: str
+    dataset_fingerprint_sha256: str
+    row_count: int
+    checks: List[MDMPCheckResult]
+
+    def to_dict(self) -> dict[str, Any]:
+        return {
+            "is_compliant": self.is_compliant,
+            "compliance_score": self.compliance_score,
+            "mdmp_grade": self.mdmp_grade,
+            "mdmp_protocol_version": self.mdmp_protocol_version,
+            "certified_for_medical_research": self.certified_for_medical_research,
+            "contract_fingerprint_sha256": self.contract_fingerprint_sha256,
+            "dataset_fingerprint_sha256": self.dataset_fingerprint_sha256,
+            "row_count": self.row_count,
+            "checks": [check.to_dict() for check in self.checks],
+        }
+
+
+def mdmp_grade_meets_minimum(actual_grade: str, minimum_grade: str) -> bool:
+    try:
+        actual_idx = MDMP_GRADE_ORDER.index(actual_grade)
+        minimum_idx = MDMP_GRADE_ORDER.index(minimum_grade)
+    except ValueError:
+        return False
+    return actual_idx >= minimum_idx
+
+
+def _normalize_grade(grade: str) -> str:
+    value = (grade or "").strip().lower()
+    if value in MDMP_GRADE_ORDER:
+        return value
+    # Backward compatibility with legacy/report variants
+    aliases = {
+        "clinical": "clinical_grade",
+        "research": "research_grade",
+    }
+    return aliases.get(value, "draft")
+
+
+def _requested_backend() -> str:
+    return os.getenv("IINTS_MDMP_BACKEND", "iints").strip().lower()
+
+
+def active_mdmp_backend() -> str:
+    requested = _requested_backend()
+    if requested in {"mdmp", "mdmp_core", "external"} and _EXTERNAL_MDMP_AVAILABLE:
+        return "mdmp_core"
+    if requested == "auto" and _EXTERNAL_MDMP_AVAILABLE:
+        return "mdmp_core"
+    return "iints"
+
+
+def load_mdmp_contract(path: Path) -> Any:
+    backend = active_mdmp_backend()
+    if backend == "mdmp_core":
+        try:
+            payload = yaml.safe_load(path.read_text(encoding="utf-8")) or {}
+        except Exception:
+            payload = {}
+        if isinstance(payload, dict) and ("streams" in payload or "processes" in payload):
+            # Legacy IINTS contract format.
+            return _load_iints_contract_yaml(path)
+        try:
+            return _load_external_contract(path)
+        except Exception:
+            # Backward compatibility: legacy IINTS contract format.
+            return _load_iints_contract_yaml(path)
+    return _load_iints_contract_yaml(path)
+
+
+def _normalize_checks(checks: Iterable[Any]) -> List[MDMPCheckResult]:
+    rows: List[MDMPCheckResult] = []
+    for check in checks:
+        rows.append(
+            MDMPCheckResult(
+                name=str(getattr(check, "name", "")),
+                passed=bool(getattr(check, "passed", False)),
+                detail=str(getattr(check, "detail", "")),
+                failed_rows=int(getattr(check, "failed_rows", 0) or 0),
+            )
+        )
+    return rows
+
+
+def run_mdmp_validation(
+    contract: Any,
+    df: pd.DataFrame,
+    *,
+    apply_builtin_transforms: bool = True,
+) -> MDMPValidationResult:
+    backend = active_mdmp_backend()
+    if backend == "mdmp_core":
+        try:
+            raw_result = _ExternalContractRunner(contract).run(df)
+            grade = _normalize_grade(str(getattr(raw_result, "grade", "draft")))
+            checks = _normalize_checks(getattr(raw_result, "checks", []))
+            return MDMPValidationResult(
+                is_compliant=bool(getattr(raw_result, "is_compliant", False)),
+                compliance_score=float(getattr(raw_result, "compliance_score", 0.0)),
+                mdmp_grade=grade,
+                mdmp_protocol_version=str(getattr(raw_result, "protocol_version", "1.0")),
+                certified_for_medical_research=grade in {"clinical_grade", "ai_ready"},
+                contract_fingerprint_sha256=str(getattr(raw_result, "contract_fingerprint_sha256", "")),
+                dataset_fingerprint_sha256=str(getattr(raw_result, "dataset_fingerprint_sha256", "")),
+                row_count=int(getattr(raw_result, "row_count", len(df))),
+                checks=checks,
+            )
+        except Exception:
+            # Backward compatibility for legacy contracts and mixed environments.
+            pass
+
+    raw_result = _IintsContractRunner(contract).run(
+        df,
+        apply_builtin_transforms=apply_builtin_transforms,
+    )
+    checks = _normalize_checks(raw_result.checks)
+    return MDMPValidationResult(
+        is_compliant=raw_result.is_compliant,
+        compliance_score=raw_result.compliance_score,
+        mdmp_grade=_normalize_grade(raw_result.mdmp_grade),
+        mdmp_protocol_version=raw_result.mdmp_protocol_version,
+        certified_for_medical_research=raw_result.certified_for_medical_research,
+        contract_fingerprint_sha256=raw_result.contract_fingerprint_sha256,
+        dataset_fingerprint_sha256=raw_result.dataset_fingerprint_sha256,
+        row_count=raw_result.row_count,
+        checks=checks,
+    )
+
+
+def build_mdmp_dashboard_html(report: dict[str, Any], *, title: str) -> str:
+    if active_mdmp_backend() == "mdmp_core":
+        return _build_external_dashboard_html(report, title=title)
+    return _build_iints_dashboard_html(report, title=title)