Technical source library

The guides below condense the operational contracts from core into navigable documentation. This inventory also keeps specialist design notes and historical investigations discoverable without presenting every experiment as a supported workflow.

• Temperature ownership and holds
• Sensor ingestion, biometrics, and calibration
• Hardware protocol, alarms, and safety
• Build, test, deployment, and releases
• System diagnostics

Core source is pinned to 17d5369ef921231e225d5f1ff0774fe965625f41. Generated wiki pages are secondary summaries; prefer the primary implementation and documents when they differ. Historical performance results, security investigation plans, and review notes are evidence from a specific revision, not promises about current behavior.

Operations

• Debugging Runbook  — integrated guide.
• Deployment Guide  — integrated guide.

Privacy

• sleepypod Privacy Policy  — existing guide and primary reference.

Architecture decisions

• ADR: Why this project lives in a new repository  — pinned design reference.
• ADR: Core Application Stack  — pinned design reference.
• ADR: TypeScript and React for Full-Stack Development  — pinned design reference.
• ADR: Next.js for Unified Frontend and Backend  — pinned design reference.
• ADR: tRPC for Type-Safe API Communication  — pinned design reference.
• ADR: Developer Tooling  — pinned design reference.
• ADR: ESLint with Recommended Rules  — pinned design reference.
• ADR: Drizzle ORM with SQLite  — pinned design reference.
• ADR: Biometrics Module System  — pinned design reference.
• ADR: Yocto-compatible deployment toolchain  — pinned design reference.
• ADR: Sensor Calibration System  — pinned design reference.
• ADR: Event Bus for Device Mutations  — pinned design reference.
• ADR: Raw Hardware Command Execution Endpoint  — pinned design reference.
• ADR: Use uv for Python package management  — pinned design reference.
• ADR: tmpfs for live RAW frames + gzip cold archive on eMMC  — pinned design reference.
• ADR 0019: MQTT bridge for Home Assistant integration  — pinned design reference.
• ADR 0020: Deterministic HomeKit identity derivation  — pinned design reference.
• ADR 0021: Use ALARM_SOLO (cmd 2) for cover-only Pod 5 vibration alarms — pinned design reference.
• ADR 0022: Pump stall safety guard and conditional thermal cross-check  — pinned design reference.
• ADR 0023: Reactive automations engine (Autopilot)  — pinned design reference.

Historical investigations

• Code Review Fix Plan — 2026-07-03  — historical evidence; not current instructions.
• Startup and API performance — 2026-09-06  — historical evidence; not current instructions.
• Pod web-service measurements — 2026-09-06 UTC  — historical evidence; not current instructions.
• Snoo Smart Bassinet — Pentest Methodology & Reconnaissance Plan  — historical evidence; not current instructions.
• Temperature Units Action Plan  — historical evidence; not current instructions.
• Test coverage audit — 2026-09-06  — historical evidence; not current instructions.

Hardware

• DAC Hardware Protocol  — integrated guide and investigation reference.
• Alarm system  — integrated guide and investigation reference.
• DAC socket takeover — investigation technique and findings  — integrated guide and investigation reference.
• LPS diagnostic stream  — integrated guide and investigation reference.

Sensors and calibration

• Calibration System Architecture  — integrated guide.
• Pod Hardware Sensor Profiles  — integrated guide.
• NATS Frame Readers  — integrated guide.
• Piezo Processor v2  — integrated guide.
• Sleep Detector  — integrated guide.

Media

• README media  — media provenance.

Temperature control

• Temperature ownership and manual holds  — integrated guide.

API and architecture

• tRPC API Architecture  — existing guide and primary reference.

Generated wiki

• sleepypod core Wiki  — index only; consult primary source.
• Compile Log  — index only; consult primary source.
• Wiki Schema  — index only; consult primary source.
• API Architecture  — index only; consult primary source.
• Architecture and Stack  — index only; consult primary source.
• Biometrics System  — index only; consult primary source.
• Deployment  — index only; consult primary source.
• Hardware Protocol  — index only; consult primary source.
• Piezo Processing  — index only; consult primary source.
• Privacy  — index only; consult primary source.
• Sensor Calibration  — index only; consult primary source.
• Sensor Hardware  — index only; consult primary source.
• Sleep Detection  — index only; consult primary source.