docs(README): HF Spaces YAML + 5-sentence Executive Summary + Demo Scripts

feat(deploy): Hugging Face Spaces Dockerfile + supervisord launcher

feat(frontend): Experiments tab — MLflow runs table + two-run diff

feat(api): GET /experiments/runs + POST /experiments/diff (Track 5)

feat(frontend): inline AI Assistant in EEG + MRI tabs

feat(api): POST /explain/eeg + /explain/mri — full-stack Track-1 coverage

feat(llm): modality dispatch — explain(payload, modality) for BBB/EEG/MRI

docs(plan): Day-8 Grand Finale — multi-modal agents, Track 5, HF deploy

docs: Day-7 close-out — AGENTS §10 drift + §11 LLM explainer + README recipe

feat(frontend): AI Assistant tab — natural-language explainer

feat(api): POST /explain/bbb — natural-language rationale endpoint

feat(llm): explainer with deterministic template + OpenRouter fallback

fix(schemas): silence Pydantic protected-namespace warning on ModelProvenance

feat(api+frontend): MLflow provenance badge in decision card

feat(frontend): drift metric line + last-prediction session state

feat(api): drift z-score in /predict/bbb response

feat(models): train-time confidence stats stashed on _neurobridge_train_stats

docs(plan): Day-7 implementation plan — drift, traceability, agents

docs(spec): Day-7 final-5% design — drift, traceability, agents

docs: Day-6 close-out — AGENTS §8 calibration + §9 demo features

feat(frontend): MRI tab — Pre/Post ComBat KDE + site-gap KPI strip

feat(api): POST /pipeline/mri/diagnostics — pre/post ComBat KPIs + long-format rows

feat(pipelines): compute_harmonization_diagnostics — long-format pre/post ComBat for viz

feat(frontend): trust caption — precision-at-confidence below decision card

feat(api): expose calibration bin in /predict/bbb response

feat(models): calibration metadata — precision-at-threshold bins on _neurobridge_calibration

feat(frontend): edge-case dropdown for BBB robustness demo

docs(plan): add Day-6 final-polish + demo-features plan

docs: Day-5 close-out — AGENTS §8 decision layer + trainer CLI

feat(frontend): interactive BBB tab — SMILES input + decision card + SHAP bars

feat(api): POST /predict/bbb with prediction, uncertainty, SHAP top-k

feat(models): SHAP top-k explainer for BBB predictions

feat(models): BBB classifier with predict_with_proba uncertainty

docs(plan): add Day-5 downstream-model + XAI + interactive plan

docs: Day-4 close-out — AGENTS §7 tracking, README MLOps surface

feat(frontend): Streamlit dashboard with 3 modality tabs

feat(deploy): Dockerfile + compose for api + mlflow server

feat(api): POST /pipeline/{bbb,eeg,mri} dispatch routes

feat(api): scaffold FastAPI app + /health + shared Pydantic schemas

feat(mri): log run params, metrics, and parquet artifact to MLflow

feat(eeg): log run params, metrics, and parquet artifact to MLflow

feat(bbb): log run params, metrics, and parquet artifact to MLflow

feat(core): add MLflow tracking helper with disable env-flag

test: cross-pipeline smoke run for all three modalities

refactor(bbb): align pin_threads() comment with EEG/MRI sibling files

refactor(mri): use core.determinism + core.storage helpers

refactor(eeg): use core.determinism + core.storage helpers

refactor(bbb): use core.determinism + core.storage helpers

feat(core): extract write_parquet() helper for §6 storage contract

feat(core): extract pin_threads() helper for determinism