fix: reduce complexity in scripts/predict.py to unblock xenon pre-commit

[raveriss]

Motivation

• La pipeline CI échouait sur le hook xenon à cause d'une complexité cyclomatique élevée dans scripts/predict.py::_build_npy_from_edf, il fallait simplifier la fonction sans modifier le comportement métier.
• Objectif KISS/DRY : découper les responsabilités pour améliorer la lisibilité et la testabilité tout en faisant passer la gate qualité (radon/xenon).

Description

• Extraction d'un helper _ensure_physionet_files_exist(subject, run, raw_path, event_path) pour centraliser la validation des fichiers EDF/.edf.event et réduire les branches dans _build_npy_from_edf.
• Extraction d'un helper _summarize_epochs_with_missing_labels_fallback(epochs, motor_labels, subject, run) qui encapsule le fallback du QC (gestion ValueError("Missing labels")).
• Simplification de _build_npy_from_edf(...) : il orchestre maintenant les helpers et contient moins de branches conditionnelles, ce qui réduit la complexité signalée par Xenon.
• Tests : ajout d’un test ciblé test_ensure_physionet_files_exist_raises_when_event_missing dans tests/test_predict_load_data.py et ajustement d’un test de diagnostic (tests/test_utils.py) pour accepter deux diagnostics valides selon l’environnement d’exécution.
• Mise à jour de poetry.lock (bump pillow → 12.1.1) pour résoudre un avertissement de pip-audit généré durant la validation.
• Fichiers modifiés : scripts/predict.py, tests/test_predict_load_data.py, tests/test_utils.py, poetry.lock.

Testing

• poetry run pre-commit run --all-files --show-diff-on-failure then poetry run pre-commit run --all-files — hooks pass after minimal auto-reformat by black (hook reformatted once, re-run OK).
• Static checks: poetry run black --check ., poetry run isort --check-only ., poetry run ruff check ., poetry run mypy src scripts tests, poetry run bandit, poetry run radon, poetry run xenon — tous passés après correctifs.
• poetry run pip-audit --progress-spinner=off — no blocking vulnerabilities after bump.
• make cov (runs pytest + coverage) — 606 tests passed, coverage total reported at 90% and coverage report --fail-under=90 succeeded.
• Résultat global : pre-commit / static analysis / tests + coverage sont verts, le job CI pré-commit ne doit plus échouer sur la complexité de _build_npy_from_edf.

---

Codex Task

[codecov]

Codecov Report

❌ Patch coverage is 87.50000% with 2 lines in your changes missing coverage. Please review.

Files with missing lines	Patch %	Lines
scripts/predict.py	87.50%	1 Missing and 1 partial ⚠️

📢 Thoughts on this report? Let us know!