Eve library

Biometric Service — EEG Integration

Other

Revision 1

On this page

Brainwave monitoring orchestration for meditation sessions. The service coordinates device calibration, real-time EEG sample analysis, neurofeedback, and session summarisation.

Capabilities#

  • Session onboarding — calibrates EEG hardware, computes per-band baselines, stores launch metadata, and returns guidance.
  • Real-time processing — analyses multi-channel samples, compares against baseline, classifies conscious states, persists metrics, and emits adaptive feedback.
  • Completion workflow — aggregates session metrics, computes averages and peak states, records summaries, and composes closing reflections.
  • Heart rate variability — synchronises HRV sensors, computes resonance baselines, streams rolling coherence windows, and summarises nervous-system resilience metrics.
  • Galvanic skin response — calibrates electrodermal sensors, detects tonic/phasic shifts, classifies arousal events, and captures anomaly-aware session summaries.
  • Eye tracking — maps gaze calibration, streams gaze/pupil analytics, detects focus and cognitive load, and synthesises fixation/saccade session reports.
  • Breath pattern analysis — calibrates respiratory sensors, analyzes inhale/exhale dynamics in real time, generates coherence feedback, and summarises variability with anomaly detection.
  • Body temperature mapping — calibrates thermal meshes, tracks regional/energy-center heat flows, detects anomalies, and produces session summaries with closure guidance.
  • Posture detection — calibrates multi-sensor posture wearables, evaluates spinal alignment and balance, streams guidance cues, and records high-variance posture events with closure insights.

Tests#

Run the focused Jest suite:

bash
cd apps/lilith/svc-biometric
timeout -k 5 120s env TRACING_EXPORTER=none TRACING_ENABLED=false APM_ENABLED=false OTEL_EXPORT_TIMEOUT_MS=250 APM_EXPORT_TIMEOUT_MS=250 npx jest --config jest.config.cjs --runInBand