eeg-pipeline

What problem does it solve?

It solves the problem of coordinating a complete EEG workflow—from BIDS intake through preprocessing, feature extraction, statistics, figure generation, and an audit—so you can produce a paper-ready result without manually wiring dozens of steps together.

Core Features & Use Cases

• End-to-end orchestration: Chains key stages (bids → preprocess → ica → epoch → erp/tfr/connectivity/microstate/source → stats → figure → report → audit) while determining which branches to run from DATASET_BRIEF.md and ANALYSIS_PLAN.md.
• Plan-gated execution: Refuses to run analyses without a frozen ANALYSIS_PLAN.md, optionally generating a draft and confirming with the user.
• Resumable crash recovery: Persists progress in PIPELINE_STATE.json and supports resuming from the last incomplete stage or from a specific stage via arguments.
• Automated review gate: Runs eeg-audit and only treats the pipeline as complete when the verdict is pass or pass-with-caveats.

Quick Start

Ask the agent to run the full pipeline for your project directory, automatically reading DATASET_BRIEF.md and ANALYSIS_PLAN.md to decide which branches to execute.