docs(eeg): correct float64 dtype claim; tighten test match; clarify CLI default

AGENTS.md

@@ -89,7 +89,7 @@ refactored into a pipeline.
 ## 6. Storage Format Convention
 
 All `data/processed/` outputs MUST be **Parquet** (`pyarrow` engine, `compression="snappy"`):
-- Preserves dtypes (uint8 fingerprints stay uint8; float32 EEG features stay float32) — CSV silently widens numeric columns and is unsuitable for the high-dimensional float arrays produced by the EEG and MRI pipelines.
+- Preserves dtypes (uint8 fingerprints stay uint8; float64 EEG features stay float64) — CSV silently widens numeric columns and is unsuitable for the high-dimensional float arrays produced by the EEG and MRI pipelines.
 - Byte-deterministic with fixed compression and single-threaded writes (satisfies §4 Determinism).
 - Read with `pd.read_parquet(path)`; no dtype hints required.
 

src/pipelines/eeg_pipeline.py

@@ -433,6 +433,8 @@ def run_pipeline(
         raise FileNotFoundError(f"Raw EEG file not found: {input_path}")
 
     logger.info("Reading raw EEG from %s", input_path)
+    # Format dispatch: .edf via read_raw_edf, anything else (FIF, gzipped FIF)
+    # via read_raw_fif. .bdf / .set / .vhdr support can be added here.
     if input_path.suffix.lower() == ".edf":
         raw = mne.io.read_raw_edf(input_path, preload=True, verbose="ERROR")
     else:
@@ -468,6 +470,8 @@ def run_pipeline(
 
 if __name__ == "__main__":
     # Day-2 CLI entrypoint — runs with default paths against `data/raw/eeg.fif`.
-    # Argument parsing (argparse / click) will land in a later task.
+    # Defaults to `eog_ch_name=None` (ICA disabled). Pass an EOG channel
+    # name programmatically via run_pipeline(eog_ch_name=...) to enable
+    # artifact rejection. Argument parsing (argparse / click) lands later.
     #   python -m src.pipelines.eeg_pipeline
     run_pipeline()

tests/pipelines/test_eeg_pipeline.py

@@ -408,7 +408,7 @@ class TestRunPipeline:
         assert first == second, "EEG pipeline output must be byte-deterministic"
 
     def test_run_pipeline_raises_when_input_missing(self, tmp_path: Path) -> None:
-        with pytest.raises(FileNotFoundError):
+        with pytest.raises(FileNotFoundError, match="Raw EEG file not found"):
             run_pipeline(
                 input_path=tmp_path / "nope.fif",
                 output_path=tmp_path / "out.parquet",