tanml 0.1.6__tar.gz → 0.1.7__tar.gz

{tanml-0.1.6 → tanml-0.1.7}/MANIFEST.in

@@ -1,6 +1,4 @@
 include README.md
 include LICENSE
 include pyproject.toml
-
 include tanml/report/templates/*.docx
-include tanml/config_templates/*.yaml

tanml-0.1.7/PKG-INFO

@@ -0,0 +1,164 @@
+Metadata-Version: 2.4
+Name: tanml
+Version: 0.1.7
+Summary: Automated validation toolkit for tabular ML models—MRM, credit risk, insurance, and other regulated use cases.
+Author: Tanmay Sah, Dolly Sah
+Maintainer: Tanmay Sah, Dolly Sah
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/tdlabs-ai/tanml
+Project-URL: Source, https://github.com/tdlabs-ai/tanml
+Project-URL: Issues, https://github.com/tdlabs-ai/tanml/issues
+Project-URL: Documentation, https://github.com/tdlabs-ai/tanml#readme
+Keywords: model validation,model risk management,model governance,SR 11-7,tabular ML,credit risk,insurance analytics,explainability,XAI,SHAP,stress testing,reporting,docx,streamlit,xgboost,lightgbm,catboost
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Scientific/Engineering :: Information Analysis
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy>=1.26
+Requires-Dist: scipy>=1.11
+Requires-Dist: pandas>=2.0
+Requires-Dist: scikit-learn>=1.3
+Requires-Dist: statsmodels>=0.14
+Requires-Dist: xgboost>=2.0
+Requires-Dist: lightgbm>=4.3
+Requires-Dist: catboost>=1.2
+Requires-Dist: shap>=0.44
+Requires-Dist: numba>=0.58
+Requires-Dist: matplotlib>=3.8
+Requires-Dist: seaborn>=0.13
+Requires-Dist: Pillow>=10.0
+Requires-Dist: python-docx>=1.1.2
+Requires-Dist: tzlocal>=5.0
+Requires-Dist: tqdm>=4.66
+Requires-Dist: pyarrow>=14.0
+Requires-Dist: openpyxl>=3.1
+Requires-Dist: pyreadstat>=1.2
+Requires-Dist: streamlit>=1.36
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: black; extra == "dev"
+Requires-Dist: isort; extra == "dev"
+Dynamic: license-file
+
+# TanML: Automated Model Validation Toolkit for Tabular Machine Learning
+
+[![Cite this repo](https://img.shields.io/badge/Cite-this_repo-blue)](https://github.com/tdlabs-ai/tanml#license--citation)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+[![Downloads](https://pepy.tech/badge/tanml)](https://pepy.tech/project/tanml)
+
+**TanML** validates tabular ML models with a zero-config **Streamlit UI** and exports an audit-ready, **editable Word report (.docx)**. It covers data quality, correlation/VIF, performance, explainability (SHAP), and robustness/stress tests—built for regulated settings (MRM, credit risk, insurance, etc.).
+
+* **Status:** Beta (`0.x`)
+* **License:** MIT
+* **Python:** 3.8–3.12
+* **OS:** Linux / macOS / Windows (incl. WSL)
+
+---
+
+## Why TanML?
+
+* **Zero-config UI:** launch Streamlit, upload data, click **Run**—no YAML needed.
+* **Audit-ready outputs:** tables/plots + a polished DOCX your stakeholders can edit.
+* **Regulatory alignment:** supports common Model Risk Management themes (e.g., SR 11-7 style).
+* **Works with your stack:** scikit-learn, XGBoost/LightGBM/CatBoost, etc.
+
+---
+
+## Install
+
+```bash
+pip install tanml
+```
+
+## Quick Start (UI)
+
+```bash
+tanml ui
+```
+
+* Opens at **[http://127.0.0.1:8501](http://127.0.0.1:8501)**
+* **Upload limit ~1 GB** (preconfigured)
+* **Telemetry disabled by default**
+
+### In the app
+
+1. **Load data** — upload a cleaned CSV/XLSX/Parquet (optional: raw or separate Train/Test).
+2. **Select target & features** — target auto-suggested; features default to all non-target columns.
+3. **Pick a model** — choose library/algorithm (scikit-learn, XGBoost, LightGBM, CatBoost) and tweak params.
+4. **Run validation** — click **▶️ Refit & validate**.
+5. **Export** — click **⬇️ Download report** to get a **DOCX** (auto-selects classification/regression template).
+
+**Outputs**
+
+* Report: `./.ui_runs/<session>/tanml_report_*.docx`
+* Artifacts (CSV/PNGs): `./.ui_runs/<session>/artifacts/*`
+
+---
+
+## What TanML Checks
+
+* **Raw Data (optional):** rows/cols, missingness, duplicates, constant columns
+* **Data Quality & EDA:** summaries, distributions
+* **Correlation & Multicollinearity:** heatmap, top-pairs CSV, **VIF** table
+* **Performance**
+
+  * **Classification:** AUC, PR-AUC, KS, decile lift, confusion
+  * **Regression:** R², MAE, MSE/RMSE, error stats
+* **Explainability:** SHAP (auto explainer; configurable background size)
+* **Robustness/Stress Tests:** feature perturbations → delta-metrics
+* **Model Metadata:** model class, hyperparameters, features, training info
+
+---
+
+
+## Templates
+
+TanML ships DOCX templates (packaged in wheel & sdist):
+
+* `tanml/report/templates/report_template_cls.docx`
+* `tanml/report/templates/report_template_reg.docx`
+
+---
+
+
+## License & Citation
+
+**License:** MIT. See [LICENSE](https://github.com/tdlabs-ai/tanml/blob/main/LICENSE).  
+SPDX-License-Identifier: MIT
+
+© 2025 Tanmay Sah and Dolly Sah. You may use, modify, and distribute this software with appropriate attribution.
+
+### How to cite
+
+If TanML helps your work or publications, please cite:
+
+> Sah, T., & Sah, D. (2025). *TanML: Automated Model Validation Toolkit for Tabular Machine Learning* [Software]. Available at https://github.com/tdlabs-ai/tanml
+
+Or in BibTeX (version-agnostic):
+
+```bibtex
+@misc{tanml,
+  author = {Sah, Tanmay and Sah, Dolly},
+  title  = {TanML: Automated Model Validation Toolkit for Tabular Machine Learning},
+  year   = {2025},
+  note   = {Software; MIT License},
+  url    = {https://github.com/tdlabs-ai/tanml}
+}
+```
+
+A machine-readable citation file (`CITATION.cff`) is included for citation tools and GitHub’s “Cite this repository” button.

tanml-0.1.7/README-pypi.md

@@ -0,0 +1,107 @@
+# TanML: Automated Model Validation Toolkit for Tabular Machine Learning
+
+[![Cite this repo](https://img.shields.io/badge/Cite-this_repo-blue)](https://github.com/tdlabs-ai/tanml#license--citation)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+[![Downloads](https://pepy.tech/badge/tanml)](https://pepy.tech/project/tanml)
+
+**TanML** validates tabular ML models with a zero-config **Streamlit UI** and exports an audit-ready, **editable Word report (.docx)**. It covers data quality, correlation/VIF, performance, explainability (SHAP), and robustness/stress tests—built for regulated settings (MRM, credit risk, insurance, etc.).
+
+* **Status:** Beta (`0.x`)
+* **License:** MIT
+* **Python:** 3.8–3.12
+* **OS:** Linux / macOS / Windows (incl. WSL)
+
+---
+
+## Why TanML?
+
+* **Zero-config UI:** launch Streamlit, upload data, click **Run**—no YAML needed.
+* **Audit-ready outputs:** tables/plots + a polished DOCX your stakeholders can edit.
+* **Regulatory alignment:** supports common Model Risk Management themes (e.g., SR 11-7 style).
+* **Works with your stack:** scikit-learn, XGBoost/LightGBM/CatBoost, etc.
+
+---
+
+## Install
+
+```bash
+pip install tanml
+```
+
+## Quick Start (UI)
+
+```bash
+tanml ui
+```
+
+* Opens at **[http://127.0.0.1:8501](http://127.0.0.1:8501)**
+* **Upload limit ~1 GB** (preconfigured)
+* **Telemetry disabled by default**
+
+### In the app
+
+1. **Load data** — upload a cleaned CSV/XLSX/Parquet (optional: raw or separate Train/Test).
+2. **Select target & features** — target auto-suggested; features default to all non-target columns.
+3. **Pick a model** — choose library/algorithm (scikit-learn, XGBoost, LightGBM, CatBoost) and tweak params.
+4. **Run validation** — click **▶️ Refit & validate**.
+5. **Export** — click **⬇️ Download report** to get a **DOCX** (auto-selects classification/regression template).
+
+**Outputs**
+
+* Report: `./.ui_runs/<session>/tanml_report_*.docx`
+* Artifacts (CSV/PNGs): `./.ui_runs/<session>/artifacts/*`
+
+---
+
+## What TanML Checks
+
+* **Raw Data (optional):** rows/cols, missingness, duplicates, constant columns
+* **Data Quality & EDA:** summaries, distributions
+* **Correlation & Multicollinearity:** heatmap, top-pairs CSV, **VIF** table
+* **Performance**
+
+  * **Classification:** AUC, PR-AUC, KS, decile lift, confusion
+  * **Regression:** R², MAE, MSE/RMSE, error stats
+* **Explainability:** SHAP (auto explainer; configurable background size)
+* **Robustness/Stress Tests:** feature perturbations → delta-metrics
+* **Model Metadata:** model class, hyperparameters, features, training info
+
+---
+
+
+## Templates
+
+TanML ships DOCX templates (packaged in wheel & sdist):
+
+* `tanml/report/templates/report_template_cls.docx`
+* `tanml/report/templates/report_template_reg.docx`
+
+---
+
+
+## License & Citation
+
+**License:** MIT. See [LICENSE](https://github.com/tdlabs-ai/tanml/blob/main/LICENSE).  
+SPDX-License-Identifier: MIT
+
+© 2025 Tanmay Sah and Dolly Sah. You may use, modify, and distribute this software with appropriate attribution.
+
+### How to cite
+
+If TanML helps your work or publications, please cite:
+
+> Sah, T., & Sah, D. (2025). *TanML: Automated Model Validation Toolkit for Tabular Machine Learning* [Software]. Available at https://github.com/tdlabs-ai/tanml
+
+Or in BibTeX (version-agnostic):
+
+```bibtex
+@misc{tanml,
+  author = {Sah, Tanmay and Sah, Dolly},
+  title  = {TanML: Automated Model Validation Toolkit for Tabular Machine Learning},
+  year   = {2025},
+  note   = {Software; MIT License},
+  url    = {https://github.com/tdlabs-ai/tanml}
+}
+```
+
+A machine-readable citation file (`CITATION.cff`) is included for citation tools and GitHub’s “Cite this repository” button.

tanml-0.1.7/README.md

@@ -0,0 +1,148 @@
+# TanML: Automated Model Validation Toolkit for Tabular Machine Learning
+
+[![Cite this repo](https://img.shields.io/badge/Cite-this_repo-blue)](https://github.com/tdlabs-ai/tanml#license--citation)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+[![Downloads](https://pepy.tech/badge/tanml)](https://pepy.tech/project/tanml)
+
+**TanML** validates tabular ML models with a zero-config **Streamlit UI** and exports an audit-ready, **editable Word report (.docx)**. It covers data quality, correlation/VIF, performance, explainability (SHAP), and robustness/stress tests—built for regulated settings (MRM, credit risk, insurance, etc.).
+
+* **Status:** Beta (`0.x`)
+* **License:** MIT
+* **Python:** 3.8–3.12
+* **OS:** Linux / macOS / Windows (incl. WSL)
+
+---
+
+## Why TanML?
+
+* **Zero-config UI:** launch Streamlit, upload data, click **Run**—no YAML needed.
+* **Audit-ready outputs:** tables/plots + a polished DOCX your stakeholders can edit.
+* **Regulatory alignment:** supports common Model Risk Management themes (e.g., SR 11-7 style).
+* **Works with your stack:** scikit-learn, XGBoost/LightGBM/CatBoost, etc.
+
+---
+
+## Install
+
+```bash
+pip install tanml
+```
+
+## Quick Start (UI)
+
+```bash
+tanml ui
+```
+
+* Opens at **[http://127.0.0.1:8501](http://127.0.0.1:8501)**
+* **Upload limit ~1 GB** (preconfigured)
+* **Telemetry disabled by default**
+
+### In the app
+
+1. **Load data** — upload a cleaned CSV/XLSX/Parquet (optional: raw or separate Train/Test).
+2. **Select target & features** — target auto-suggested; features default to all non-target columns.
+3. **Pick a model** — choose library/algorithm (scikit-learn, XGBoost, LightGBM, CatBoost) and tweak params.
+4. **Run validation** — click **▶️ Refit & validate**.
+5. **Export** — click **⬇️ Download report** to get a **DOCX** (auto-selects classification/regression template).
+
+**Outputs**
+
+* Report: `./.ui_runs/<session>/tanml_report_*.docx`
+* Artifacts (CSV/PNGs): `./.ui_runs/<session>/artifacts/*`
+
+---
+
+## What TanML Checks
+
+* **Raw Data (optional):** rows/cols, missingness, duplicates, constant columns
+* **Data Quality & EDA:** summaries, distributions
+* **Correlation & Multicollinearity:** heatmap, top-pairs CSV, **VIF** table
+* **Performance**
+
+  * **Classification:** AUC, PR-AUC, KS, decile lift, confusion
+  * **Regression:** R², MAE, MSE/RMSE, error stats
+* **Explainability:** SHAP (auto explainer; configurable background size)
+* **Robustness/Stress Tests:** feature perturbations → delta-metrics
+* **Model Metadata:** model class, hyperparameters, features, training info
+
+---
+
+## Optional CLI Flags
+
+Most users just run `tanml ui`. These help on teams/servers:
+
+```bash
+# Share on LAN
+tanml ui --public
+
+# Different port
+tanml ui --port 9000
+
+# Headless (server/CI; no auto-open browser)
+tanml ui --headless
+
+# Larger limit (e.g., 2 GB)
+tanml ui --max-mb 2048
+```
+
+Env var equivalents (Linux/macOS bash):
+
+```bash
+TANML_SERVER_ADDRESS=0.0.0.0 TANML_PORT=9000 TANML_MAX_MB=2048 tanml ui
+```
+
+Windows PowerShell:
+
+```powershell
+$env:TANML_SERVER_ADDRESS="0.0.0.0"; $env:TANML_PORT="9000"; $env:TANML_MAX_MB="2048"; tanml ui
+```
+
+**Defaults:** address `127.0.0.1`, port `8501`, limit `1024 MB`, telemetry **OFF**.
+
+---
+
+## Templates
+
+TanML ships DOCX templates (packaged in wheel & sdist):
+
+* `tanml/report/templates/report_template_cls.docx`
+* `tanml/report/templates/report_template_reg.docx`
+
+---
+
+## Troubleshooting
+
+* **Page didn’t open?** Visit `http://127.0.0.1:8501` or run `tanml ui --port 9000`.
+* **Large CSVs are slow/heavy?** Prefer **Parquet**; CSV → DataFrame can use several GB RAM.
+* **Artifacts missing?** Check `./.ui_runs/<session>/artifacts/`.
+* **Corporate networks:** use `tanml ui --public` to share on LAN.
+
+---
+
+## License & Citation
+
+**License:** MIT. See [LICENSE](https://github.com/tdlabs-ai/tanml/blob/main/LICENSE).  
+SPDX-License-Identifier: MIT
+
+© 2025 Tanmay Sah and Dolly Sah. You may use, modify, and distribute this software with appropriate attribution.
+
+### How to cite
+
+If TanML helps your work or publications, please cite:
+
+> Sah, T., & Sah, D. (2025). *TanML: Automated Model Validation Toolkit for Tabular Machine Learning* [Software]. Available at https://github.com/tdlabs-ai/tanml
+
+Or in BibTeX (version-agnostic):
+
+```bibtex
+@misc{tanml,
+  author = {Sah, Tanmay and Sah, Dolly},
+  title  = {TanML: Automated Model Validation Toolkit for Tabular Machine Learning},
+  year   = {2025},
+  note   = {Software; MIT License},
+  url    = {https://github.com/tdlabs-ai/tanml}
+}
+```
+
+A machine-readable citation file (`CITATION.cff`) is included for citation tools and GitHub’s “Cite this repository” button.

tanml-0.1.7/pyproject.toml

@@ -0,0 +1,112 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "tanml"
+version = "0.1.7"
+description = "Automated validation toolkit for tabular ML models—MRM, credit risk, insurance, and other regulated use cases."
+readme = { file = "README-pypi.md", content-type = "text/markdown" }
+requires-python = ">=3.8"
+license = "MIT"
+license-files = ["LICENSE"]
+
+
+keywords = [
+  "model validation",
+  "model risk management",
+  "model governance",
+  "SR 11-7",
+  "tabular ML",
+  "credit risk",
+  "insurance analytics",
+  "explainability",
+  "XAI",
+  "SHAP",
+  "stress testing",
+  "reporting",
+  "docx",
+  "streamlit",
+  "xgboost",
+  "lightgbm",
+  "catboost"
+]
+
+
+
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Science/Research",
+  "Intended Audience :: Financial and Insurance Industry",
+  "Natural Language :: English",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.8",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Topic :: Scientific/Engineering :: Artificial Intelligence",
+  "Topic :: Scientific/Engineering :: Information Analysis",
+  "Topic :: Scientific/Engineering :: Visualization"
+]
+
+
+authors = [
+  { name = "Tanmay Sah" },
+  { name = "Dolly Sah" }
+]
+
+maintainers = [
+  { name = "Tanmay Sah" },
+  { name = "Dolly Sah" }
+]
+
+dependencies = [
+  "numpy>=1.26",
+  "scipy>=1.11",
+  "pandas>=2.0",
+  "scikit-learn>=1.3",
+  "statsmodels>=0.14",
+  "xgboost>=2.0",
+  "lightgbm>=4.3",
+  "catboost>=1.2",
+  "shap>=0.44",
+  "numba>=0.58",
+  "matplotlib>=3.8",
+  "seaborn>=0.13",
+  "Pillow>=10.0",
+  "python-docx>=1.1.2",
+  "tzlocal>=5.0",
+  "tqdm>=4.66",
+  "pyarrow>=14.0",
+  "openpyxl>=3.1",
+  "pyreadstat>=1.2",
+  "streamlit>=1.36"
+]
+
+
+[project.optional-dependencies]
+dev = ["pytest", "black", "isort"]
+
+[project.scripts]
+tanml = "tanml.cli.main:main"
+
+[project.urls]
+Homepage = "https://github.com/tdlabs-ai/tanml"
+Source = "https://github.com/tdlabs-ai/tanml"
+Issues = "https://github.com/tdlabs-ai/tanml/issues"
+Documentation = "https://github.com/tdlabs-ai/tanml#readme"
+
+
+[tool.setuptools]
+include-package-data = true
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["tanml*"]
+
+[tool.setuptools.package-data]
+"tanml.report.templates" = ["*.docx"] 

tanml-0.1.7/tanml/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.7"

{tanml-0.1.6 → tanml-0.1.7}/tanml/check_runners/cleaning_repro_runner.py

@@ -3,12 +3,12 @@ from tanml.checks.cleaning_repro import CleaningReproCheck
 
 def run_cleaning_repro_check(model, X_train, X_test, y_train, y_test,
                              config, cleaned_data, *args, **kwargs):
-    # honour rules.yaml toggle
+    
     if not config.get("rules", {}).get("CleaningReproCheck", {}).get("enabled", True):
         print("ℹ️ CleaningReproCheck skipped (disabled in rules.yaml)")
         return None
 
-    # raw_df can come from rules.yaml *or* via kwargs (passed by ValidationEngine)
+    
     raw_data = config.get("raw_data") or kwargs.get("raw_df")
     if raw_data is None:
         print("⚠️ Skipping CleaningReproCheck — raw_data missing in config and kwargs")

tanml-0.1.7/tanml/check_runners/correlation_runner.py

@@ -0,0 +1,52 @@
+# tanml/check_runners/correlation_runner.py
+from __future__ import annotations
+import os
+from typing import Any, Dict, List
+import pandas as pd
+
+from tanml.checks.correlation import CorrelationCheck  
+
+def _resolve_outdir(config: Dict[str, Any]) -> str:
+    base = (config.get("options") or {}).get("save_artifacts_dir") or "reports"
+    outdir = os.path.join(base, "correlation")
+    os.makedirs(outdir, exist_ok=True)
+    return outdir
+
+def _df_features_only(cleaned_df: pd.DataFrame) -> pd.DataFrame:
+    if cleaned_df is None or cleaned_df.empty:
+        return cleaned_df
+    cols = list(cleaned_df.columns)
+    if len(cols) >= 2:
+        return cleaned_df[cols[:-1]]
+    return cleaned_df
+
+def CorrelationCheckRunner(
+    model,
+    X_train,
+    X_test,
+    y_train,
+    y_test,
+    config: Dict[str, Any],
+    cleaned_df: pd.DataFrame,
+    raw_df: pd.DataFrame | None = None,
+):
+    ui_block: Dict[str, Any] = (config.get("CorrelationCheck") or {})
+    legacy: Dict[str, Any] = (config.get("correlation") or {})
+    if not bool(ui_block.get("enabled", legacy.get("enabled", True))):
+        return None
+
+    df = _df_features_only(cleaned_df)
+    cfg: Dict[str, Any] = {
+        "method": ui_block.get("method", "pearson"),
+        "high_corr_threshold": float(ui_block.get("high_corr_threshold", 0.8)),
+        "heatmap_max_features_default": int(ui_block.get("heatmap_max_features_default", 20)),
+        "heatmap_max_features_limit": int(ui_block.get("heatmap_max_features_limit", 60)),
+        "subset_strategy": ui_block.get("subset_strategy", "cluster"),
+        "sample_rows": int(ui_block.get("sample_rows", 150_000)),
+        "seed": int(ui_block.get("seed", 42)),
+        "save_csv": True,
+        "save_fig": True,
+        "appendix_csv_cap": ui_block.get("appendix_csv_cap", None),
+    }
+    outdir = _resolve_outdir(config)
+    return CorrelationCheck(cleaned_data=df, cfg=cfg, output_dir=outdir).run()

tanml-0.1.7/tanml/check_runners/explainability_runner.py

@@ -0,0 +1,18 @@
+# explainability runner
+from tanml.checks.explainability.shap_check import SHAPCheck
+
+def run_shap_check(model, X_train, X_test, y_train, y_test, rule_config, cleaned_df, *args, **kwargs):
+    try:
+        cfg_shapcheck = (rule_config or {}).get("SHAPCheck", {}) or {}
+        cfg_expl = (rule_config or {}).get("explainability", {}).get("shap", {}) or {}
+        enabled = cfg_shapcheck.get("enabled", cfg_expl.get("enabled", True))
+        if not enabled:
+            print("ℹ️ SHAPCheck skipped (disabled)")
+            return {"SHAPCheck": {"skipped": True}}
+
+        check = SHAPCheck(model, X_train, X_test, y_train, y_test, rule_config=rule_config, cleaned_df=cleaned_df)
+        result = check.run()
+        return {"SHAPCheck": result}
+    except Exception as e:
+        print(f"⚠️ SHAPCheck failed: {e}")
+        return {"SHAPCheck": {"status": "error", "error": str(e)}}