# Biometric Service — EEG Integration

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
```