Mountainash Wearables

An intelligent textbook for mountainash-wearables -- unified health and fitness data from wearable platforms.

Textbook deferred — unavailable. The inherited chapter outline and topics below are retained for reference; no textbook is currently published.

Source repository

Chapters

1. Foundation Concepts
2. Connection Layer Architecture
3. WHOOP Provider Implementation
4. Garmin and Oura Providers
5. Strava, Google Health, and Apple Health Providers
6. Pipeline Infrastructure
7. Access Methods and Raw Storage
8. Raw Pipeline Implementations
9. Bronze Layer Unified Schema
10. Bronze Provider Mapping Functions
11. CLI Layer

Key Topics

• Connection layer -- WearableProvider structural protocol with OAuth2 lifecycle, YAML configuration, and provider registry for six platforms (WHOOP, Garmin, Google Health, Oura, Strava, Apple Health)
• Pipeline architecture -- EndpointPipeline structural protocol with four-step fetch/parse/flatten/conform pipeline and three access methods (live, sync, read)
• Raw and bronze storage -- WearableStore wrapping IbisBackend with per-provider DuckDB files, plus BronzeIngester orchestrating a unified 4-table schema (events, daily, series, scores)
• Cross-provider unification -- CanonicalField enum with 53 cross-provider field names, mapping functions per provider, and 83 series types for normalized health data
• CLI layer -- Click-based mw-extract command with list, sync, live, and read subcommands for multi-provider wearable data operations