@daobrew/wellness-mcp 0.1.0 → 0.1.1

package/README.md

@@ -1,98 +1,158 @@
-# @daobrew/wellness-mcp
+# 🍵 @daobrew/wellness-mcp
 
-Biometric stress detection & TCM-guided recovery for developers using Claude Code.
+**Your coding agent just learned to read your body.**
 
-Reads your health data (Apple Watch, Oura Ring), detects stress patterns through Traditional Chinese Medicine theory, and plays therapeutic breathing music with binaural beats — right inside your coding session.
+Reads your biometrics (Apple Watch, Oura Ring), detects stress patterns, and plays therapeutic breathing music with binaural beats — all without leaving your editor.
 
-## Install
+No popups. No app switching. Just music that fades in when you need it. 🎧
+
+---
+
+## ⚡ Quick Start
 
 ```bash
 npm install -g @daobrew/wellness-mcp
 npx daobrew-wellness-setup
 ```
 
-Setup asks two questions (data source + ambient mode). Done in 30 seconds.
+Two questions. 30 seconds. Done.
 
-## What it does
+Works with **Claude Code**, **Cursor**, **Windsurf**, and any MCP-compatible agent.
 
-- **Detects stress** from real biometrics (HRV, heart rate, steps, sleep)
-- **Maps to TCM patterns**: Wood/Tension, Fire/Overdrive, Earth/Stagnation, Metal/Constriction, Water/Depletion
-- **Plays breathing music** with binaural beats (4Hz theta) and breath-paced volume modulation
-- **Works inside Claude Code** — no app switching, no popups
+---
 
-## Usage
+## 🧘 What It Does
 
-**On-demand** — ask anytime:
 ```
-/stress     → check your current wellness state
-/breathe    → start a breathing session for your top stress pattern
-/stop       → stop current session
+You're coding.   →   Agent detects stress.   →   Music fades in.   →   You keep coding.
+                      (real biometric data)       (binaural beats       (stress goes down)
+                                                   + breath pacing)
+```
+
+- 📊 **Detects stress** from real biometrics — HRV, heart rate, sleep, activity
+- 🌿 **Maps to 5 stress patterns** — Wood/Tension, Fire/Overdrive, Earth/Stagnation, Metal/Constriction, Water/Depletion
+- 🎵 **Plays genre-matched music** with 4Hz theta binaural beats and breath-paced volume swells
+- 🔇 **Zero interruption** — ambient mode works silently in the background
+
+---
+
+## 🎮 Usage
+
+### On-demand — ask anytime
 ```
+/stress     →   "You're in Pushing It mode — Fire · Heart Qi restlessness (score 72)"
+/breathe    →   Lo-fi jazz fades in through your headphones 🎧
+/stop       →   Music stops, session result logged
+```
+
+### Ambient — hands-free stress relief
+Enable once: *"enable ambient mode"*
+
+From then on, your agent monitors stress at natural breakpoints. When it detects a spike + you have headphones in, therapeutic music fades in silently. You keep coding. Your HRV recovers. One line at the end:
+
+> ♪ Session ended. HRV 28ms → 41ms (+46%), HR 82 → 71bpm.
+
+Say *"disable wellness"* anytime to turn it off.
+
+---
 
-**Ambient** — auto-plays when stress is detected:
-- Enable with: `"enable ambient mode"` in Claude Code
-- Requires headphones (binaural beats need stereo separation)
-- 30-minute cooldown between sessions
-- Say `"disable wellness"` to turn off
+## 📱 Data Sources
 
-## Data Sources
+| Source | What You Get | How to Connect |
+|--------|-------------|----------------|
+| ⌚ **Apple Watch** | HRV, HR, steps, sleep, respiratory | Install [DaoBrew Health Sync](https://testflight.apple.com/join/6XTNFvv5) on iPhone |
+| 💍 **Oura Ring** | HRV, HR, sleep, readiness, temp | Say *"connect oura"* in your agent |
+| 🚶 **None** | Step count only (demo mode) | Works out of the box |
 
-| Source | Data | Setup |
-|--------|------|-------|
-| **Apple Watch** | HRV, HR, steps, sleep | Install [DaoBrew Health Sync](https://testflight.apple.com/join/6XTNFvv5) on iPhone |
-| **Oura Ring** | HRV, HR, sleep, readiness | Say `"connect oura"` in Claude Code |
+---
 
-Without a wearable, only step count is available (Earth/Spleen pattern only).
+## 🎵 The Five Sounds
 
-## 9 Tools + 3 Prompts
+Each stress pattern gets its own genre, breathing rate, and vibe:
 
-| Tool | Description |
+| Pattern | When You Feel... | Genre | BPM | What It Does |
+|---------|-----------------|-------|-----|-------------|
+| 🌲 Wood | Tense, tight, clenching | Ambient Downtempo | 6 | Releases tension, restores flow |
+| 🔥 Fire | Wired, restless, can't focus | Lo-fi Chill Jazz | 5 | Cools the mind, settles racing thoughts |
+| 🌍 Earth | Sluggish, foggy, unmotivated | Acoustic Folk | 6 | Grounds and centers, wakes you up gently |
+| ⚔️ Metal | Shallow breathing, constricted | Nature + Pads | 7 | Opens the chest, deepens your breath |
+| 🌊 Water | Drained, depleted, running on empty | Drone Ambient | 5 | Deep rest, replenishes your reserves |
+
+Every track layers a **4Hz theta binaural beat** (requires headphones) plus **breath-paced volume modulation** — the music rises and falls to gently guide your breathing.
+
+> 💡 On your first session, the agent tells you: *"Breathe in as the music rises, out as it fades."* After that, your body remembers — no voice prompts, just music.
+
+---
+
+## 🛠 9 Tools
+
+| Tool | What It Does |
 |------|-------------|
-| `daobrew_get_wellness_state` | Current Yin/Yang balance + Five Element stress scores |
-| `daobrew_get_element_detail` | Deep-dive evidence for a specific stress pattern |
-| `daobrew_start_breathing_session` | Start guided breathing with audio playback |
-| `daobrew_get_session_result` | Post-session HRV improvement metrics |
-| `daobrew_get_session_history` | Recent session history and trends |
-| `daobrew_stop_session` | Stop current breathing session |
-| `daobrew_status` | Server mode, headphones, preferences, active session |
-| `daobrew_set_monitoring` | Configure ambient mode, volume, cooldown |
-| `daobrew_connect_source` | Connect Oura Ring or Apple Watch |
-
-## How it works
+| `daobrew_get_wellness_state` | Yin/Yang balance + Five Element stress scores |
+| `daobrew_get_element_detail` | Evidence breakdown for a specific pattern |
+| `daobrew_start_breathing_session` | Start session with audio/text |
+| `daobrew_get_session_result` | Post-session HRV changes |
+| `daobrew_get_session_history` | Recent sessions and trends |
+| `daobrew_stop_session` | Stop current session |
+| `daobrew_status` | Server mode, headphones, preferences |
+| `daobrew_set_monitoring` | Configure ambient, volume, cooldown |
+| `daobrew_connect_source` | Connect Apple Watch or Oura Ring |
+
+---
+
+## 🔒 Privacy
+
+- Agent only sees **wellness scores** — never raw health records
+- Health tokens stored locally at `~/.daobrew/`
+- Speaker blocklist prevents accidental playback without headphones
+- Ambient mode requires explicit opt-in
+
+---
+
+## 🏗 Architecture
 
 ```
-Apple Watch / Oura
-        ↓
-  DaoBrew Backend (Gemini LLM + TCM scoring)
-        ↓
-  MCP Server (local, TypeScript)
-        ↓
-  Claude Code ←→ afplay/mpv (binaural + breath modulation)
+  ⌚ Apple Watch ──→ iPhone SDK ──→ DaoBrew Cloud ──→ TCM Scoring Engine
+  💍 Oura Ring ────→ OAuth API ──↗        ↓
+                                    MCP Server (local)
+                                         ↓
+                                   Your Coding Agent
+                                         ↓
+                                  afplay / mpv 🎧
+                              (binaural + breath modulation)
 ```
 
-## Privacy
+---
 
-- Only scored wellness data — no raw health records in agent context
-- Health data stored locally (`~/.daobrew/`)
-- Headphone detection prevents accidental speaker playback
-- Ambient mode requires explicit opt-in
+## ⚙️ Configuration
 
-## Configuration
+Talk to your agent:
+- *"set volume to 0.5"*
+- *"change cooldown to 15 minutes"*
+- *"trust headphones"* (skip detection)
+- *"disable wellness"*
 
-Change settings in Claude Code: `"set volume to 0.5"`, `"change cooldown to 15 minutes"`, `"disable wellness"`
+Or edit `~/.daobrew/prefs.json`.
 
-Or edit `~/.daobrew/prefs.json` directly.
+---
 
-## Development
+## 🧑‍💻 Development
 
 ```bash
+git clone <repo>
 cd daobrew-wellness-mcp
-npm install
-npm run build
+npm install && npm run build
 npm test          # 74 tests
 npm run setup     # interactive setup
 ```
 
-## License
+---
+
+## 📜 License
 
 MIT
+
+---
+
+*Built with 🍵 by [DaoBrew](https://daobrew.com).*
+*Take a breath. Your code can wait.*

package/dist/src/client.d.ts

@@ -19,4 +19,8 @@ export declare class DaoBrewClient {
         samples_received: number;
         message: string;
     }>;
+    createPairingCode(): Promise<{
+        code: string;
+        expires_in_seconds: number;
+    }>;
 }

package/dist/src/client.js

@@ -61,5 +61,10 @@ class DaoBrewClient {
             body: JSON.stringify({ samples }),
         });
     }
+    async createPairingCode() {
+        return this.request("/pair/create", {
+            method: "POST",
+        });
+    }
 }
 exports.DaoBrewClient = DaoBrewClient;

package/dist/src/tools.js

@@ -373,10 +373,27 @@ async function handleToolCall(name, args, isMock, _apiKey, isDemo = false, clien
         case "daobrew_connect_source": {
             const source = args.source;
             if (source === "apple_watch") {
+                // Generate pairing code if connected to real backend
+                if (!isMock && client) {
+                    try {
+                        const pairing = await client.createPairingCode();
+                        return {
+                            status: "pairing_started",
+                            source: "apple_watch",
+                            pairing_code: pairing.code,
+                            expires_in_seconds: pairing.expires_in_seconds,
+                            install_url: "https://testflight.apple.com/join/6XTNFvv5",
+                            instructions: `1. Install DaoBrew Health Sync on your iPhone (TestFlight link above)\n2. Open the app and tap "Pair with Claude Code"\n3. Enter code: ${pairing.code}\n4. Grant HealthKit permissions when prompted\n5. Health data will sync automatically within 1-2 minutes`,
+                        };
+                    }
+                    catch {
+                        // Fall through to static response if backend unavailable
+                    }
+                }
                 return {
                     status: "install_required",
                     source: "apple_watch",
-                    install_url: "https://daobrew.com/health-sync",
+                    install_url: "https://testflight.apple.com/join/6XTNFvv5",
                     instructions: "Install DaoBrew Health Sync on your iPhone via TestFlight. It reads your Apple Watch data and syncs it to DaoBrew.",
                 };
             }

package/package.json

@@ -1,13 +1,19 @@
 {
   "name": "@daobrew/wellness-mcp",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Wellness MCP server — biometric stress detection & recovery for AI agents",
   "main": "dist/src/index.js",
   "bin": {
     "daobrew-wellness-mcp": "dist/src/index.js",
     "daobrew-wellness-setup": "dist/src/setup-cli.js"
   },
-  "files": ["dist/", "audio/", "SKILL.md", "README.md", "src/setup-cli.js"],
+  "files": [
+    "dist/",
+    "audio/",
+    "SKILL.md",
+    "README.md",
+    "src/setup-cli.js"
+  ],
   "scripts": {
     "build": "tsc",
     "setup": "node dist/src/setup-cli.js",
@@ -16,7 +22,15 @@
     "postinstall": "echo '\\n  Run: npx daobrew-wellness-setup\\n  to complete DaoBrew configuration.\\n'",
     "test": "node --test --test-concurrency=1 dist/tests/mock.test.js dist/tests/preferences.test.js dist/tests/headphones.test.js dist/tests/session.test.js dist/tests/cooldown.test.js dist/tests/cache.test.js dist/tests/e2e.test.js dist/tests/audio.test.js dist/tests/guards.test.js dist/tests/client.test.js dist/tests/sync.test.js"
   },
-  "keywords": ["mcp", "wellness", "health", "biometrics", "tcm", "stress", "breathing"],
+  "keywords": [
+    "mcp",
+    "wellness",
+    "health",
+    "biometrics",
+    "tcm",
+    "stress",
+    "breathing"
+  ],
   "license": "MIT",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0"