# SleepLab

SleepLab is an open-source, local-first, privacy-focused sleep therapy health data platform designed to process, store, and visualize CPAP metrics and oximetry data alongside optional wearable telemetry overlays.

---

## 1. AI Governance & Architecture

- **[AI Governance (Single Source of Truth)](.claude/governance.md):** Architectural boundaries, coding style guides (Ruff, Black, TS-ESLint), WCAG 2.1 AA accessibility regulations, and pre-commit quality gates.
- **[Active Agent Memory Logs](.ai/memory.md):** Asynchronous ledger tracking completed milestones, ongoing tasks, and cross-session insights to prevent task drift.

---

## 2. Developer & Ingestion Guides

- **[Contributing Manual](docs/contributing.md):** Setup guide for local development workspaces (Node.js, Python, PostgreSQL, Nx), style standards, and pull request requirements.
- **[Testing Framework Guide](docs/testing.md):** Execution workflows for backend `pytest` suites and frontend `vitest` unit/component tests.
- **[CPAP Autosync Webhook](docs/cpap-autosync-integration.md):** Walkthrough for wiring CPAP sync event webhooks to SleepLab's background importers, including GitLab active roadmap links (`cpap-monitor`).
- **[SleepHQ Integration Sync](docs/sleephq-integration.md):** Design of the SleepHQ API bridge, OAuth2 setup, timezone mapping, and robust exponential rate-limiting handling.

---

## 3. End-User Manuals

- **[User Guide](docs/user-guide.md):** Instructions for importing CPAP SD cards, managing display and CPAP machine timezones, configuring AI daily/trend summaries (Ollama, OpenAI, LiteLLM), and connection troubleshooting.

---

## 4. API Reference

- **[Backend API Reference](docs/api/backend.md):** Specifications and Google-style autogenerated Python reference docs for core backend controllers.
- **[Frontend Architecture Reference](docs/api/frontend.md):** Autogenerated React and TypeScript module details.