@daobrew/wellness-mcp 0.1.0

package/dist/tests/mock.test.js

@@ -0,0 +1,194 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_test_1 = require("node:test");
+const assert = __importStar(require("node:assert/strict"));
+const mock_js_1 = require("../src/mock.js");
+const types_js_1 = require("../src/types.js");
+const ELEMENTS = ["wood", "fire", "earth", "metal", "water"];
+const QUADRANTS = ["peak", "pushing_it", "recharging", "burnout"];
+(0, node_test_1.describe)("daobrew_get_wellness_state", () => {
+    (0, node_test_1.it)("returns all required fields with correct types", () => {
+        const state = (0, mock_js_1.mockWellnessState)();
+        assert.ok(typeof state.yin === "number" && state.yin >= 0 && state.yin <= 100);
+        assert.ok(typeof state.yang === "number" && state.yang >= 0 && state.yang <= 100);
+        assert.ok(QUADRANTS.includes(state.quadrant));
+        assert.ok(typeof state.quadrant_label === "string" && state.quadrant_label.length > 0);
+        assert.ok(typeof state.quadrant_description === "string" && state.quadrant_description.length > 0);
+        assert.ok(typeof state.yin_label === "string" && state.yin_label.length > 0);
+        assert.ok(typeof state.yang_label === "string" && state.yang_label.length > 0);
+        assert.ok(Array.isArray(state.active_elements));
+        ELEMENTS.forEach(e => assert.ok(typeof state.element_scores[e] === "number"));
+        assert.ok(typeof state.top_signal === "string");
+        assert.ok(typeof state.recommendation === "string");
+        assert.strictEqual(state.data_tier, "tier_2");
+        assert.ok(!isNaN(Date.parse(state.last_updated))); // valid ISO 8601
+    });
+    (0, node_test_1.it)("quadrant matches yin/yang thresholds", () => {
+        for (let i = 0; i < 20; i++) {
+            const state = (0, mock_js_1.mockWellnessState)();
+            if (state.yin >= 50 && state.yang >= 50)
+                assert.strictEqual(state.quadrant, "peak");
+            if (state.yin < 50 && state.yang >= 50)
+                assert.strictEqual(state.quadrant, "pushing_it");
+            if (state.yin >= 50 && state.yang < 50)
+                assert.strictEqual(state.quadrant, "recharging");
+            if (state.yin < 50 && state.yang < 50)
+                assert.strictEqual(state.quadrant, "burnout");
+        }
+    });
+    (0, node_test_1.it)("active_elements matches elements with score >= 50", () => {
+        for (let i = 0; i < 10; i++) {
+            const state = (0, mock_js_1.mockWellnessState)();
+            const expected = ELEMENTS.filter(e => state.element_scores[e] >= 50);
+            assert.deepStrictEqual(state.active_elements.sort(), expected.sort());
+        }
+    });
+    (0, node_test_1.it)("cycles through different quadrants across calls", () => {
+        const quadrants = new Set();
+        for (let i = 0; i < 12; i++)
+            quadrants.add((0, mock_js_1.mockWellnessState)().quadrant);
+        assert.ok(quadrants.size >= 2, `Expected >= 2 quadrants, got ${quadrants.size}`);
+    });
+});
+(0, node_test_1.describe)("daobrew_get_element_detail", () => {
+    ELEMENTS.forEach(element => {
+        (0, node_test_1.it)(`returns valid detail for ${element}`, () => {
+            const detail = (0, mock_js_1.mockElementDetail)(element);
+            assert.strictEqual(detail.element, element);
+            assert.strictEqual(detail.label, `${types_js_1.ELEMENT_LABELS[element]} · ${types_js_1.ELEMENT_ORGANS[element]}`);
+            assert.strictEqual(detail.intervention.genre, types_js_1.ELEMENT_GENRES[element]);
+            assert.strictEqual(detail.intervention.type, "breathing");
+            assert.strictEqual(detail.intervention.breathing_rate_bpm, 6.0);
+            assert.ok(detail.evidence.length > 0);
+            assert.ok(typeof detail.headline === "string");
+            assert.ok(typeof detail.why_this_practice === "string");
+        });
+    });
+});
+(0, node_test_1.describe)("daobrew_start_breathing_session", () => {
+    (0, node_test_1.it)("text tier returns valid session", () => {
+        const session = (0, mock_js_1.mockStartSession)("wood", "text");
+        assert.strictEqual(session.status, "started");
+        assert.ok(session.session_id.startsWith("sess_"));
+        assert.strictEqual(session.element, "wood");
+        assert.strictEqual(session.genre, "ambient_downtempo");
+    });
+    (0, node_test_1.it)("audio tier returns session without script", () => {
+        const session = (0, mock_js_1.mockStartSession)("fire", "audio");
+        assert.strictEqual(session.status, "started");
+        assert.strictEqual(session.tier, "audio");
+    });
+});
+(0, node_test_1.describe)("daobrew_get_session_result", () => {
+    (0, node_test_1.it)("returns improvement metrics", () => {
+        const session = (0, mock_js_1.mockStartSession)("earth", "text");
+        const result = (0, mock_js_1.mockSessionResult)(session.session_id);
+        assert.strictEqual(result.completed, true);
+        assert.ok(result.hrv_before < result.hrv_after);
+        assert.ok(result.hrv_change_pct >= 20 && result.hrv_change_pct <= 60);
+        assert.ok(result.hr_before > result.hr_after);
+        assert.ok(typeof result.summary === "string" && result.summary.length > 0);
+    });
+});
+(0, node_test_1.describe)("daobrew_get_session_history", () => {
+    (0, node_test_1.it)("returns sorted entries within date range", () => {
+        const entries = (0, mock_js_1.mockSessionHistory)(7);
+        assert.ok(entries.length >= 3 && entries.length <= 14);
+        for (let i = 1; i < entries.length; i++) {
+            assert.ok(new Date(entries[i - 1].timestamp) >= new Date(entries[i].timestamp), "not sorted desc");
+        }
+        entries.forEach(e => {
+            assert.ok(ELEMENTS.includes(e.element));
+            assert.ok(e.session_id.length > 0);
+            assert.ok(typeof e.hrv_change_pct === "number");
+        });
+    });
+});
+(0, node_test_1.describe)("mock first call always stressed", () => {
+    (0, node_test_1.it)("first mockWellnessState() call has active_elements.length > 0", () => {
+        (0, mock_js_1._resetWellnessCallCount)();
+        const state = (0, mock_js_1.mockWellnessState)();
+        assert.ok(state.active_elements.length > 0, "First call should always be stressed");
+    });
+});
+(0, node_test_1.describe)("mock demo mode", () => {
+    (0, node_test_1.it)("isDemo=true always produces stressed output", () => {
+        (0, mock_js_1._resetWellnessCallCount)();
+        for (let i = 0; i < 5; i++) {
+            const state = (0, mock_js_1.mockWellnessState)(true);
+            assert.ok(state.active_elements.length > 0, `Demo call ${i + 1} should be stressed`);
+        }
+    });
+});
+(0, node_test_1.describe)("mock session result labeled", () => {
+    (0, node_test_1.it)("summary starts with [Mock]", () => {
+        const session = (0, mock_js_1.mockStartSession)("earth", "text");
+        const result = (0, mock_js_1.mockSessionResult)(session.session_id);
+        assert.ok(result.summary.startsWith("[Mock]"), `Expected [Mock] prefix, got: ${result.summary.substring(0, 20)}`);
+    });
+});
+(0, node_test_1.describe)("daobrew_stop_session", () => {
+    (0, node_test_1.it)("returns no_active_session when nothing playing", async () => {
+        const { handleToolCall } = await import("../src/tools.js");
+        const result = await handleToolCall("daobrew_stop_session", {}, true);
+        assert.strictEqual(result.status, "no_active_session");
+        assert.strictEqual(result.duration_played, null);
+    });
+});
+(0, node_test_1.describe)("get_wellness_state caching", () => {
+    (0, node_test_1.it)("returns cache_age_seconds = 0 on first call", async () => {
+        const { handleToolCall } = await import("../src/tools.js");
+        const result = await handleToolCall("daobrew_get_wellness_state", { force_refresh: true }, true);
+        assert.strictEqual(result.cache_age_seconds, 0);
+    });
+    (0, node_test_1.it)("returns cached data on second call without force_refresh", async () => {
+        const { handleToolCall } = await import("../src/tools.js");
+        const r1 = await handleToolCall("daobrew_get_wellness_state", { force_refresh: true }, true);
+        const r2 = await handleToolCall("daobrew_get_wellness_state", {}, true);
+        assert.ok(r2.cache_age_seconds >= 0);
+        assert.strictEqual(r2.yin, r1.yin);
+        assert.strictEqual(r2.yang, r1.yang);
+    });
+});
+(0, node_test_1.describe)("start_breathing_session guards", () => {
+    (0, node_test_1.it)("rejects ambient mode without optin", async () => {
+        const { save } = await import("../src/preferences.js");
+        save({ disabled: false, ambient_optin: false });
+        const { handleToolCall } = await import("../src/tools.js");
+        const result = await handleToolCall("daobrew_start_breathing_session", { element: "wood", mode: "ambient" }, true);
+        assert.strictEqual(result.status, "requires_optin");
+    });
+});

package/dist/tests/preferences.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/preferences.test.js

@@ -0,0 +1,71 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_test_1 = require("node:test");
+const assert = __importStar(require("node:assert/strict"));
+const fs_1 = require("fs");
+const path_1 = require("path");
+const os_1 = require("os");
+const preferences_js_1 = require("../src/preferences.js");
+const PREFS_FILE = (0, path_1.join)((0, os_1.homedir)(), ".daobrew", "prefs.json");
+(0, node_test_1.describe)("preferences", () => {
+    (0, node_test_1.beforeEach)(() => {
+        if ((0, fs_1.existsSync)(PREFS_FILE))
+            (0, fs_1.unlinkSync)(PREFS_FILE);
+    });
+    (0, node_test_1.it)("load() returns defaults when no file exists", () => {
+        const prefs = (0, preferences_js_1.load)();
+        assert.strictEqual(prefs.ambient_optin, false);
+        assert.strictEqual(prefs.preferred_volume, 0.3);
+        assert.strictEqual(prefs.session_count, 0);
+        assert.strictEqual(prefs.voiceover, true);
+    });
+    (0, node_test_1.it)("save() persists and load() reads back", () => {
+        (0, preferences_js_1.save)({ ambient_optin: true, preferred_volume: 0.5 });
+        const prefs = (0, preferences_js_1.load)();
+        assert.strictEqual(prefs.ambient_optin, true);
+        assert.strictEqual(prefs.preferred_volume, 0.5);
+        assert.strictEqual(prefs.disabled, false);
+    });
+    (0, node_test_1.it)("incrementSessionCount auto-disables voiceover at 3", () => {
+        (0, preferences_js_1.save)({ session_count: 0, voiceover: true });
+        (0, preferences_js_1.incrementSessionCount)(); // 1
+        assert.strictEqual((0, preferences_js_1.load)().voiceover, true);
+        (0, preferences_js_1.incrementSessionCount)(); // 2
+        assert.strictEqual((0, preferences_js_1.load)().voiceover, true);
+        (0, preferences_js_1.incrementSessionCount)(); // 3
+        assert.strictEqual((0, preferences_js_1.load)().voiceover, false);
+    });
+});

package/dist/tests/session.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/session.test.js

@@ -0,0 +1,85 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_test_1 = require("node:test");
+const assert = __importStar(require("node:assert/strict"));
+const session_js_1 = require("../src/session.js");
+(0, node_test_1.describe)("session state", () => {
+    (0, node_test_1.beforeEach)(() => {
+        (0, session_js_1.clearSession)();
+    });
+    (0, node_test_1.it)("starts with no active session", () => {
+        assert.strictEqual((0, session_js_1.getActiveSession)(), null);
+        assert.strictEqual((0, session_js_1.isSessionRunning)(), false);
+        assert.strictEqual((0, session_js_1.durationPlayed)(), null);
+    });
+    (0, node_test_1.it)("startSession/getActiveSession round-trips", () => {
+        const session = {
+            sessionId: "sess_test", pid: 0, element: "wood",
+            genre: "ambient_downtempo", duration: 300, startTime: Date.now(), mode: "ondemand",
+        };
+        (0, session_js_1.startSession)(session);
+        assert.strictEqual((0, session_js_1.isSessionRunning)(), true);
+        assert.strictEqual((0, session_js_1.getActiveSession)()?.sessionId, "sess_test");
+        assert.strictEqual((0, session_js_1.getActiveSession)()?.mode, "ondemand");
+    });
+    (0, node_test_1.it)("clearSession returns previous and clears state", () => {
+        const session = {
+            sessionId: "sess_clear", pid: 99, element: "fire",
+            genre: "lofi_chill_jazz", duration: 300, startTime: Date.now(), mode: "ambient",
+        };
+        (0, session_js_1.startSession)(session);
+        const prev = (0, session_js_1.clearSession)();
+        assert.strictEqual(prev?.sessionId, "sess_clear");
+        assert.strictEqual((0, session_js_1.isSessionRunning)(), false);
+    });
+    (0, node_test_1.it)("durationPlayed returns elapsed seconds", () => {
+        const session = {
+            sessionId: "sess_dur", pid: 0, element: "earth",
+            genre: "acoustic_folk_calm", duration: 300, startTime: Date.now() - 5000, mode: "ondemand",
+        };
+        (0, session_js_1.startSession)(session);
+        const played = (0, session_js_1.durationPlayed)();
+        assert.ok(played !== null && played >= 4 && played <= 6);
+    });
+    (0, node_test_1.it)("declines second session when one is already running", () => {
+        const s1 = {
+            sessionId: "sess_1", pid: 0, element: "wood",
+            genre: "ambient_downtempo", duration: 300, startTime: Date.now(), mode: "ondemand",
+        };
+        (0, session_js_1.startSession)(s1);
+        assert.strictEqual((0, session_js_1.isSessionRunning)(), true);
+    });
+});

package/dist/tests/sync.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/sync.test.js

@@ -0,0 +1,54 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_test_1 = require("node:test");
+const assert = __importStar(require("node:assert/strict"));
+const sync_js_1 = require("../src/health/sync.js");
+const client_js_1 = require("../src/client.js");
+(0, node_test_1.describe)("syncAllConnectedSources", () => {
+    (0, node_test_1.it)("returns empty array when no sources connected", async () => {
+        // Create a client pointing at nothing (won't be called since no tokens exist)
+        const client = new client_js_1.DaoBrewClient({ apiKey: "dbk_test", baseUrl: "http://localhost:1", timeoutMs: 1000 });
+        const results = await (0, sync_js_1.syncAllConnectedSources)(client);
+        // No tokens exist at ~/.daobrew/oura-token.json or google-fit-token.json
+        // so both isConnected() checks return false and no sync happens
+        assert.ok(Array.isArray(results));
+        // Should have 0 results since nothing is connected
+        for (const r of results) {
+            assert.ok(typeof r.source === "string");
+            assert.ok(typeof r.samples_pushed === "number");
+        }
+    });
+});

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@daobrew/wellness-mcp",
+  "version": "0.1.0",
+  "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"],
+  "scripts": {
+    "build": "tsc",
+    "setup": "node dist/src/setup-cli.js",
+    "dev": "ts-node src/index.ts",
+    "mock": "ts-node src/index.ts --mock",
+    "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"],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.2",
+    "ts-node": "^10.9.2",
+    "typescript": "^6.0.2"
+  }
+}

package/src/setup-cli.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+require("./setup.js").default();