wellness-cycle-coach 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Changelog
+
+## [Unreleased]
+
+## [0.1.0] - 2026-05-10
+
+### Added
+
+- Initial release. Stateless menstrual cycle coach MCP — orchestrates cycle data into phase-aware nutrition + training + hydration recommendations.
+- 11 MCP tools: standard 5 (`cycle_agent_manifest`, `cycle_capabilities`, `cycle_connection_status`, `cycle_privacy_audit`, `cycle_data_inventory`) + cycle-specific 6 (`cycle_estimate_phase`, `cycle_predict_next_period`, `cycle_phase_guidance`, `cycle_recommend_nutrition`, `cycle_recommend_training`, `cycle_full_report`).
+- Phase detection over 4-phase model: menstrual / follicular / ovulatory / luteal.
+- Evidence-informed nutrition + training + hydration guidance per phase.
+- Confidence scoring (low/medium/high) based on amount of period history provided.
+- CLI: `wellness-cycle-coach status`, `doctor`, `setup`.
+- Stateless by design — never persists cycle data. Stress-tested via smoke suite.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 David Batista
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,139 @@
+<!-- delx-wellness header v2 -->
+<h1 align="center">Wellness Cycle Coach</h1>
+
+<h3 align="center">
+  Stateless menstrual cycle coach MCP for AI agents.<br>
+  Built so AI finally serves the <strong>50% of users</strong> agents have ignored — without ever storing the data.
+</h3>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/wellness-cycle-coach"><img src="https://img.shields.io/npm/v/wellness-cycle-coach?style=for-the-badge&labelColor=0F172A&color=10B981&logo=npm&logoColor=white" alt="npm version" /></a>
+  <a href="https://www.npmjs.com/package/wellness-cycle-coach"><img src="https://img.shields.io/npm/dm/wellness-cycle-coach?style=for-the-badge&labelColor=0F172A&color=0EA5A3&logo=npm&logoColor=white" alt="npm downloads" /></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/LICENSE-MIT-22C55E?style=for-the-badge&labelColor=0F172A" alt="License MIT" /></a>
+  <a href="https://wellness.delx.ai/connectors/cycle"><img src="https://img.shields.io/badge/SITE-wellness.delx.ai-0EA5A3?style=for-the-badge&labelColor=0F172A" alt="Site" /></a>
+</p>
+
+<p align="center">
+  <a href="https://github.com/davidmosiah/wellness-cycle-coach/stargazers"><img src="https://img.shields.io/github/stars/davidmosiah/wellness-cycle-coach?style=for-the-badge&labelColor=0F172A&color=FBBF24&logo=github" alt="GitHub stars" /></a>
+  <a href="https://modelcontextprotocol.io"><img src="https://img.shields.io/badge/BUILT_FOR-MCP-7C3AED?style=for-the-badge&labelColor=0F172A" alt="Built for MCP" /></a>
+  <a href="https://github.com/davidmosiah/delx-wellness-hermes"><img src="https://img.shields.io/badge/HERMES-one--command_setup-10B981?style=for-the-badge&labelColor=0F172A" alt="Hermes" /></a>
+  <a href="https://github.com/davidmosiah/delx-wellness-openclaw"><img src="https://img.shields.io/badge/OPENCLAW-one--command_setup-FB923C?style=for-the-badge&labelColor=0F172A" alt="OpenClaw" /></a>
+</p>
+
+<p align="center">
+  <strong>🌙 Why this exists:</strong> Most AI agents treat the body as a single context-free unit. But energy, recovery, training tolerance, nutrient needs and even cognitive bandwidth shift across the menstrual cycle. <code>wellness-cycle-coach</code> gives any agent <strong>phase-aware</strong> guidance — and never stores the data to do it.
+</p>
+
+> ⚡ **One-command install** — pick your runtime:
+> - [Delx Wellness for Hermes](https://github.com/davidmosiah/delx-wellness-hermes): `npx -y delx-wellness-hermes setup`
+> - [Delx Wellness for OpenClaw](https://github.com/davidmosiah/delx-wellness-openclaw): `npx -y delx-wellness-openclaw setup`
+
+---
+<!-- /delx-wellness header v2 -->
+
+## Overview
+
+Pass in period start dates (from any source — Apple Health Cycle, Garmin women's health, Fitbit female health, or direct user input) and get back the user's current phase plus phase-aware recommendations for nutrition, training, and hydration. **Stateless** — the MCP itself never persists cycle data.
+
+## Try It In 60 Seconds
+
+```bash
+npx -y wellness-cycle-coach doctor
+
+# Or use the MCP directly via your client:
+# {
+#   "mcpServers": {
+#     "wellness-cycle-coach": {
+#       "command": "npx",
+#       "args": ["-y", "wellness-cycle-coach"]
+#     }
+#   }
+# }
+```
+
+Then in your agent:
+
+```json
+{
+  "name": "cycle_full_report",
+  "arguments": {
+    "history": [
+      { "start_date": "2026-04-01" },
+      { "start_date": "2026-04-29" }
+    ]
+  }
+}
+```
+
+Returns current phase + nutrition emphasize/moderate/avoid + training style/intensity + hydration target + next-period estimate.
+
+## Tools (11)
+
+| Tool | Purpose |
+|---|---|
+| `cycle_agent_manifest` | Runtime contract |
+| `cycle_capabilities` | Phases, upstream connectors, metrics |
+| `cycle_connection_status` | Health + stateless reminder |
+| `cycle_privacy_audit` | What's logged (nothing) vs sent out (nothing) |
+| `cycle_data_inventory` | Phase taxonomy + metric catalog |
+| **`cycle_estimate_phase`** | **Current phase + cycle day + confidence** |
+| `cycle_predict_next_period` | Average cycle length + next-period date |
+| `cycle_phase_guidance` | Recommendations for any specific phase |
+| **`cycle_recommend_nutrition`** | **Phase-aware nutrition for current phase** |
+| **`cycle_recommend_training`** | **Phase-aware training for current phase** |
+| **`cycle_full_report`** | **Single-call combined report** |
+
+## The 4-phase model
+
+| Phase | When | Energy | Nutrition emphasis | Training |
+|---|---|---|---|---|
+| **menstrual** | days 1 → period end (~5) | Lower | Iron + magnesium + omega-3 | Restorative (yoga, walking, mobility) |
+| **follicular** | post-period → ovulation - 2 | Rising / peak | Complex carbs + lean protein + fermented foods | **Build** (strength, sprints, new skills) |
+| **ovulatory** | ovulation ± 1 day | Peak | Antioxidants + zinc | **Peak** (PRs, plyometrics) |
+| **luteal** | ovulation + 2 → next period | Falling | B vitamins + magnesium + complex carbs | Endurance + technique |
+
+## Why stateless?
+
+Menstrual cycle data is **medical-record sensitive**. The strongest privacy guarantee is to never store it. Other apps (Flo, Clue) live by hoarding cycle data on their servers; this MCP refuses to participate. The agent passes data in, the coach returns guidance, the data evaporates.
+
+## Cross-connector wedge
+
+```
+Apple Health Cycle → period dates       ┐
+Garmin women's health → cycle context   ├─→ wellness-cycle-coach → phase + guidance
+Fitbit female health → period dates     ┘                                  │
+                                                                            │
+                                                                            ↓
+                                                            wellness-nourish coach
+                                                            (phase-aware meal planning)
+                                                                            │
+                                                            whoop-mcp / garminmcp / ouramcp
+                                                            (recovery-aware late-luteal load adjustments)
+```
+
+## Privacy
+
+- ✅ **Stateless** — no period dates persisted.
+- ✅ **Offline-capable** — pure-function computation. No outbound calls.
+- ✅ **Tool-arg-only data** — agent passes data in via the MCP request and it stays in process memory.
+
+Run `wellness-cycle-coach doctor` to inspect.
+
+## What this is NOT
+
+- Not medical advice or diagnosis.
+- Not a fertility tracker or contraception aid (consult a clinician).
+- Not a replacement for talking to a healthcare provider about painful, abnormal, or absent periods.
+- Not specialized for PCOS, perimenopause, post-pill, or other complex contexts (yet — see CONTRIBUTING.md).
+
+## Roadmap
+
+- **v0.2** — adapters for apple-health-mcp / garminmcp / fitbitmcp so agents can pull period history with one MCP call.
+- **v0.3** — symptom logging surface + symptom-aware guidance adjustments (cramps → magnesium emphasis, mood drop → B-vitamin emphasis).
+- **v0.4** — non-English locale support starting with pt-BR.
+
+## License
+
+MIT — see [LICENSE](LICENSE).
+
+<sub>wellness-cycle-coach is independent research-software. Not affiliated with Clue, Flo, Stardust, or any other cycle-tracking app. Not medical advice.</sub>

package/SECURITY.md

@@ -0,0 +1,18 @@
+# Security Policy
+
+## Reporting
+
+Email **mosiahdavid@gmail.com** with details and reproduction. Do not open a public issue for security findings.
+
+## Scope
+
+This is a stateless MCP — no data persistence, no outbound calls. The relevant security surfaces are:
+
+- HTTP transport (`--http`) bound to `127.0.0.1` by default with CORS.
+- Tool argument validation (zod schemas).
+
+If you find ways to leak the period history passed in tool args, or unintended outbound calls, please report.
+
+## Privacy is the security story
+
+The most valuable contribution is keeping this MCP genuinely stateless. Any change that introduces cycle-data persistence must be opt-in, encrypted, and clearly disclosed. PRs that add cloud telemetry will not be accepted.

package/dist/cli/commands.d.ts

@@ -0,0 +1,2 @@
+export declare function isCliCommand(args: string[]): boolean;
+export declare function runCliCommand(args: string[]): Promise<number>;

package/dist/cli/commands.js

@@ -0,0 +1,58 @@
+import { NPM_PACKAGE_NAME, SERVER_VERSION } from "../constants.js";
+import { buildCapabilities } from "../services/capabilities.js";
+import { buildPrivacyAudit } from "../services/privacy-audit.js";
+const COMMANDS = new Set(["status", "doctor", "setup"]);
+function printCommunityCTA() {
+    if (process.env.WELLNESS_CYCLE_COACH_QUIET === "1")
+        return;
+    if (!process.stderr.isTTY)
+        return;
+    process.stderr.write(`\n✨ wellness-cycle-coach v${SERVER_VERSION} — built so AI agents finally serve menstruating users. A star ⭐ helps surface this to other builders.\n` +
+        `   ⭐  https://github.com/davidmosiah/wellness-cycle-coach\n` +
+        `   💬  https://github.com/davidmosiah/wellness-cycle-coach/issues\n` +
+        `   🐦  https://x.com/delx369\n` +
+        `   (silence with WELLNESS_CYCLE_COACH_QUIET=1)\n\n`);
+}
+export function isCliCommand(args) {
+    const command = args[0];
+    return command !== undefined && COMMANDS.has(command);
+}
+export async function runCliCommand(args) {
+    const [command] = args;
+    switch (command) {
+        case "status":
+            console.log(JSON.stringify({ name: NPM_PACKAGE_NAME, version: SERVER_VERSION, stateless: true }, null, 2));
+            printCommunityCTA();
+            return 0;
+        case "doctor":
+            console.log(JSON.stringify({
+                ok: true,
+                package: NPM_PACKAGE_NAME,
+                version: SERVER_VERSION,
+                stateless: true,
+                capabilities: buildCapabilities(),
+                privacy: buildPrivacyAudit(),
+            }, null, 2));
+            printCommunityCTA();
+            return 0;
+        case "setup":
+            console.log(JSON.stringify({
+                mcpServers: {
+                    "wellness-cycle-coach": {
+                        command: "npx",
+                        args: ["-y", NPM_PACKAGE_NAME],
+                    },
+                },
+                next_steps: [
+                    "Pass period start dates via tool args to cycle_estimate_phase / cycle_full_report.",
+                    "Pair with apple-health-mcp / garminmcp / fitbitmcp to fetch period history automatically.",
+                    "Cross-reference recovery + nutrition for full coaching context.",
+                ],
+            }, null, 2));
+            printCommunityCTA();
+            return 0;
+        default:
+            return -1;
+    }
+}
+//# sourceMappingURL=commands.js.map

package/dist/cli/commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEjE,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC;AAExD,SAAS,iBAAiB;IACxB,IAAI,OAAO,CAAC,GAAG,CAAC,0BAA0B,KAAK,GAAG;QAAE,OAAO;IAC3D,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK;QAAE,OAAO;IAClC,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,6BAA6B,cAAc,0GAA0G;QACnJ,6DAA6D;QAC7D,qEAAqE;QACrE,gCAAgC;QAChC,oDAAoD,CACvD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAc;IACzC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACxB,OAAO,OAAO,KAAK,SAAS,IAAI,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAc;IAChD,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC;IACvB,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,QAAQ;YACX,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAC3G,iBAAiB,EAAE,CAAC;YACpB,OAAO,CAAC,CAAC;QACX,KAAK,QAAQ;YACX,OAAO,CAAC,GAAG,CACT,IAAI,CAAC,SAAS,CACZ;gBACE,EAAE,EAAE,IAAI;gBACR,OAAO,EAAE,gBAAgB;gBACzB,OAAO,EAAE,cAAc;gBACvB,SAAS,EAAE,IAAI;gBACf,YAAY,EAAE,iBAAiB,EAAE;gBACjC,OAAO,EAAE,iBAAiB,EAAE;aAC7B,EACD,IAAI,EACJ,CAAC,CACF,CACF,CAAC;YACF,iBAAiB,EAAE,CAAC;YACpB,OAAO,CAAC,CAAC;QACX,KAAK,OAAO;YACV,OAAO,CAAC,GAAG,CACT,IAAI,CAAC,SAAS,CACZ;gBACE,UAAU,EAAE;oBACV,sBAAsB,EAAE;wBACtB,OAAO,EAAE,KAAK;wBACd,IAAI,EAAE,CAAC,IAAI,EAAE,gBAAgB,CAAC;qBAC/B;iBACF;gBACD,UAAU,EAAE;oBACV,oFAAoF;oBACpF,2FAA2F;oBAC3F,iEAAiE;iBAClE;aACF,EACD,IAAI,EACJ,CAAC,CACF,CACF,CAAC;YACF,iBAAiB,EAAE,CAAC;YACpB,OAAO,CAAC,CAAC;QACX;YACE,OAAO,CAAC,CAAC,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/constants.d.ts

@@ -0,0 +1,16 @@
+export declare const SERVER_NAME = "wellness-cycle-coach-mcp";
+export declare const SERVER_VERSION = "0.1.0";
+export declare const NPM_PACKAGE_NAME = "wellness-cycle-coach";
+export declare const PINNED_NPM_PACKAGE = "wellness-cycle-coach@0.1.0";
+export declare const DEFAULT_HOST = "127.0.0.1";
+export declare const DEFAULT_PORT = 3011;
+export declare const LOCAL_DIR_NAME = ".wellness-cycle-coach";
+export declare const CYCLE_PHASES: readonly ["menstrual", "follicular", "ovulatory", "luteal"];
+export type CyclePhase = typeof CYCLE_PHASES[number];
+/** Default cycle/phase lengths used when the user hasn't logged enough history yet. */
+export declare const DEFAULT_CYCLE_LENGTH_DAYS = 28;
+export declare const DEFAULT_PERIOD_LENGTH_DAYS = 5;
+export declare const DEFAULT_LUTEAL_LENGTH_DAYS = 14;
+/** Upstream connector names this coach knows how to consume data from. */
+export declare const UPSTREAM_CONNECTORS: readonly ["apple-health-mcp", "garminmcp", "fitbitmcp"];
+export type UpstreamConnector = typeof UPSTREAM_CONNECTORS[number];

package/dist/constants.js

@@ -0,0 +1,15 @@
+export const SERVER_NAME = "wellness-cycle-coach-mcp";
+export const SERVER_VERSION = "0.1.0";
+export const NPM_PACKAGE_NAME = "wellness-cycle-coach";
+export const PINNED_NPM_PACKAGE = `${NPM_PACKAGE_NAME}@${SERVER_VERSION}`;
+export const DEFAULT_HOST = "127.0.0.1";
+export const DEFAULT_PORT = 3011;
+export const LOCAL_DIR_NAME = ".wellness-cycle-coach";
+export const CYCLE_PHASES = ["menstrual", "follicular", "ovulatory", "luteal"];
+/** Default cycle/phase lengths used when the user hasn't logged enough history yet. */
+export const DEFAULT_CYCLE_LENGTH_DAYS = 28;
+export const DEFAULT_PERIOD_LENGTH_DAYS = 5;
+export const DEFAULT_LUTEAL_LENGTH_DAYS = 14;
+/** Upstream connector names this coach knows how to consume data from. */
+export const UPSTREAM_CONNECTORS = ["apple-health-mcp", "garminmcp", "fitbitmcp"];
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG,0BAA0B,CAAC;AACtD,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AACtC,MAAM,CAAC,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;AACvD,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,gBAAgB,IAAI,cAAc,EAAE,CAAC;AAC1E,MAAM,CAAC,MAAM,YAAY,GAAG,WAAW,CAAC;AACxC,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC;AACjC,MAAM,CAAC,MAAM,cAAc,GAAG,uBAAuB,CAAC;AAEtD,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,CAAU,CAAC;AAGxF,uFAAuF;AACvF,MAAM,CAAC,MAAM,yBAAyB,GAAG,EAAE,CAAC;AAC5C,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC;AAC5C,MAAM,CAAC,MAAM,0BAA0B,GAAG,EAAE,CAAC;AAE7C,0EAA0E;AAC1E,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,kBAAkB,EAAE,WAAW,EAAE,WAAW,CAAU,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,74 @@
+#!/usr/bin/env node
+import cors from "cors";
+import express from "express";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { DEFAULT_HOST, DEFAULT_PORT, SERVER_NAME, SERVER_VERSION } from "./constants.js";
+import { isCliCommand, runCliCommand } from "./cli/commands.js";
+import { registerCycleTools } from "./tools/cycle-tools.js";
+function createServer() {
+    const server = new McpServer({ name: SERVER_NAME, version: SERVER_VERSION });
+    registerCycleTools(server);
+    return server;
+}
+async function runStdio() {
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+async function runHttp() {
+    const app = express();
+    const host = process.env.WELLNESS_CYCLE_COACH_HOST ?? DEFAULT_HOST;
+    const port = Number(process.env.WELLNESS_CYCLE_COACH_PORT ?? DEFAULT_PORT);
+    const allowedOrigin = process.env.WELLNESS_CYCLE_COACH_ALLOWED_ORIGIN ?? `http://${host}:${port}`;
+    app.use(express.json({ limit: "1mb" }));
+    app.use(cors({ origin: allowedOrigin }));
+    app.get("/health", (_req, res) => res.json({ ok: true, name: SERVER_NAME, version: SERVER_VERSION }));
+    app.post("/mcp", async (req, res) => {
+        const server = createServer();
+        const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined, enableJsonResponse: true });
+        res.on("close", () => {
+            transport.close().catch(() => undefined);
+            server.close().catch(() => undefined);
+        });
+        try {
+            await server.connect(transport);
+            await transport.handleRequest(req, res, req.body);
+        }
+        catch (error) {
+            console.error("MCP HTTP request failed:", error);
+            if (!res.headersSent) {
+                res.status(500).json({ jsonrpc: "2.0", error: { code: -32603, message: "Internal server error" }, id: null });
+            }
+        }
+    });
+    app.listen(port, host, () => {
+        console.error(`${SERVER_NAME} HTTP transport listening on http://${host}:${port}/mcp`);
+    });
+}
+const args = process.argv.slice(2);
+if (args.includes("--http")) {
+    await runHttp();
+}
+else if (isCliCommand(args)) {
+    const code = await runCliCommand(args);
+    process.exit(code);
+}
+else if (args.length === 0 || args.includes("--stdio")) {
+    await runStdio();
+}
+else {
+    console.error([
+        `${SERVER_NAME} v${SERVER_VERSION}`,
+        "",
+        "Usage:",
+        "  wellness-cycle-coach              Run MCP stdio server (default).",
+        "  wellness-cycle-coach --http       Run MCP Streamable HTTP server.",
+        "  wellness-cycle-coach doctor       Local DX checks.",
+        "  wellness-cycle-coach status       Show current version.",
+        "  wellness-cycle-coach setup        Print MCP client config snippet.",
+    ].join("\n"));
+    process.exit(1);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/services/agent-manifest.d.ts

@@ -0,0 +1,28 @@
+import { buildCapabilities } from "./capabilities.js";
+import { buildPrivacyAudit } from "./privacy-audit.js";
+export type CycleCoachClient = "claude" | "codex" | "cursor" | "windsurf" | "hermes" | "openclaw" | "generic";
+export interface CycleCoachAgentManifest {
+    name: string;
+    version: string;
+    client: string;
+    supported_clients: CycleCoachClient[];
+    install: {
+        command: string;
+        args: string[];
+        optional_env: string[];
+    };
+    recommended_first_calls: string[];
+    tools: ReadonlyArray<string>;
+    resources: string[];
+    agent_rules: string[];
+    community: {
+        repo: string;
+        issues: string;
+        twitter: string;
+        docs: string;
+        invite: string;
+    };
+    capabilities: ReturnType<typeof buildCapabilities>;
+    privacy: ReturnType<typeof buildPrivacyAudit>;
+}
+export declare function buildAgentManifest(client?: CycleCoachClient): CycleCoachAgentManifest;

package/dist/services/agent-manifest.js

@@ -0,0 +1,67 @@
+import { PINNED_NPM_PACKAGE, SERVER_NAME, SERVER_VERSION } from "../constants.js";
+import { buildCapabilities } from "./capabilities.js";
+import { buildPrivacyAudit } from "./privacy-audit.js";
+const SUPPORTED_CLIENTS = [
+    "claude",
+    "codex",
+    "cursor",
+    "windsurf",
+    "hermes",
+    "openclaw",
+    "generic",
+];
+const TOOLS = [
+    "cycle_agent_manifest",
+    "cycle_capabilities",
+    "cycle_connection_status",
+    "cycle_privacy_audit",
+    "cycle_data_inventory",
+    "cycle_estimate_phase",
+    "cycle_predict_next_period",
+    "cycle_phase_guidance",
+    "cycle_recommend_nutrition",
+    "cycle_recommend_training",
+    "cycle_full_report",
+];
+const RECOMMENDED_FIRST_CALLS = [
+    "cycle_connection_status",
+    "cycle_capabilities",
+    "cycle_estimate_phase",
+];
+export function buildAgentManifest(client = "generic") {
+    return {
+        name: SERVER_NAME,
+        version: SERVER_VERSION,
+        client,
+        supported_clients: SUPPORTED_CLIENTS,
+        install: {
+            command: "npx",
+            args: ["-y", PINNED_NPM_PACKAGE],
+            optional_env: ["WELLNESS_CYCLE_COACH_LOCAL_DIR"],
+        },
+        recommended_first_calls: RECOMMENDED_FIRST_CALLS,
+        tools: TOOLS,
+        resources: [
+            "wellness-cycle-coach://agent-manifest",
+            "wellness-cycle-coach://capabilities",
+            "wellness-cycle-coach://privacy-audit",
+        ],
+        agent_rules: [
+            "Cycle history (period start dates) must be passed in via tool args. This coach is stateless.",
+            "Use cycle_estimate_phase to detect the user's current phase before recommending nutrition or training.",
+            "Always state confidence level — a single logged period is 'low' confidence.",
+            "Cross-reference with WHOOP/Garmin/Oura recovery for late-luteal fatigue patterns.",
+            "Never claim medical accuracy. Defer to a clinician for fertility, pregnancy, or symptom-management decisions.",
+        ],
+        community: {
+            repo: "https://github.com/davidmosiah/wellness-cycle-coach",
+            issues: "https://github.com/davidmosiah/wellness-cycle-coach/issues",
+            twitter: "https://x.com/delx369",
+            docs: "https://wellness.delx.ai/connectors/cycle",
+            invite: "If wellness-cycle-coach helps your agent serve a long-overlooked population, a star on the repository increases visibility for other AI builders.",
+        },
+        capabilities: buildCapabilities(),
+        privacy: buildPrivacyAudit(),
+    };
+}
+//# sourceMappingURL=agent-manifest.js.map

package/dist/services/agent-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-manifest.js","sourceRoot":"","sources":["../../src/services/agent-manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,kBAAkB,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACpG,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAIvD,MAAM,iBAAiB,GAAuB;IAC5C,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,UAAU;IACV,QAAQ;IACR,UAAU;IACV,SAAS;CACV,CAAC;AAEF,MAAM,KAAK,GAAG;IACZ,sBAAsB;IACtB,oBAAoB;IACpB,yBAAyB;IACzB,qBAAqB;IACrB,sBAAsB;IACtB,sBAAsB;IACtB,2BAA2B;IAC3B,sBAAsB;IACtB,2BAA2B;IAC3B,0BAA0B;IAC1B,mBAAmB;CACX,CAAC;AAEX,MAAM,uBAAuB,GAAG;IAC9B,yBAAyB;IACzB,oBAAoB;IACpB,sBAAsB;CACvB,CAAC;AAiBF,MAAM,UAAU,kBAAkB,CAAC,SAA2B,SAAS;IACrE,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,cAAc;QACvB,MAAM;QACN,iBAAiB,EAAE,iBAAiB;QACpC,OAAO,EAAE;YACP,OAAO,EAAE,KAAK;YACd,IAAI,EAAE,CAAC,IAAI,EAAE,kBAAkB,CAAC;YAChC,YAAY,EAAE,CAAC,gCAAgC,CAAC;SACjD;QACD,uBAAuB,EAAE,uBAAuB;QAChD,KAAK,EAAE,KAAK;QACZ,SAAS,EAAE;YACT,uCAAuC;YACvC,qCAAqC;YACrC,sCAAsC;SACvC;QACD,WAAW,EAAE;YACX,8FAA8F;YAC9F,wGAAwG;YACxG,6EAA6E;YAC7E,mFAAmF;YACnF,+GAA+G;SAChH;QACD,SAAS,EAAE;YACT,IAAI,EAAE,qDAAqD;YAC3D,MAAM,EAAE,4DAA4D;YACpE,OAAO,EAAE,uBAAuB;YAChC,IAAI,EAAE,2CAA2C;YACjD,MAAM,EACJ,mJAAmJ;SACtJ;QACD,YAAY,EAAE,iBAAiB,EAAE;QACjC,OAAO,EAAE,iBAAiB,EAAE;KAC7B,CAAC;AACJ,CAAC"}

package/dist/services/capabilities.d.ts

@@ -0,0 +1,8 @@
+export interface CycleCoachCapabilities {
+    phases: ReadonlyArray<string>;
+    upstream_connectors: ReadonlyArray<string>;
+    metrics: ReadonlyArray<string>;
+    privacy_modes: ReadonlyArray<"summary" | "structured" | "raw">;
+    notes: string[];
+}
+export declare function buildCapabilities(): CycleCoachCapabilities;

package/dist/services/capabilities.js

@@ -0,0 +1,24 @@
+import { CYCLE_PHASES, UPSTREAM_CONNECTORS } from "../constants.js";
+export function buildCapabilities() {
+    return {
+        phases: CYCLE_PHASES,
+        upstream_connectors: UPSTREAM_CONNECTORS,
+        metrics: [
+            "current_phase",
+            "cycle_day",
+            "cycle_length",
+            "next_period_estimate",
+            "phase_nutrition",
+            "phase_training",
+            "phase_hydration_ml",
+        ],
+        privacy_modes: ["summary", "structured", "raw"],
+        notes: [
+            "All cycle data must be passed in by the agent (or fetched separately from apple-health-mcp / garminmcp / fitbitmcp).",
+            "This coach NEVER stores cycle data itself. It is a stateless orchestration layer.",
+            "Phase estimates use a rolling-average cycle length; confidence rises with more period history.",
+            "Recommendations are evidence-informed defaults — every body is different. Personalize over time.",
+        ],
+    };
+}
+//# sourceMappingURL=capabilities.js.map

package/dist/services/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../../src/services/capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAUpE,MAAM,UAAU,iBAAiB;IAC/B,OAAO;QACL,MAAM,EAAE,YAAY;QACpB,mBAAmB,EAAE,mBAAmB;QACxC,OAAO,EAAE;YACP,eAAe;YACf,WAAW;YACX,cAAc;YACd,sBAAsB;YACtB,iBAAiB;YACjB,gBAAgB;YAChB,oBAAoB;SACrB;QACD,aAAa,EAAE,CAAC,SAAS,EAAE,YAAY,EAAE,KAAK,CAAU;QACxD,KAAK,EAAE;YACL,sHAAsH;YACtH,mFAAmF;YACnF,gGAAgG;YAChG,kGAAkG;SACnG;KACF,CAAC;AACJ,CAAC"}

package/dist/services/cycle-engine.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Cycle engine — pure functions to detect phase, predict next period, and
+ * recommend nutrition / training per phase. Does NOT call any external API;
+ * all data comes from the agent or other MCP connectors and is passed in.
+ */
+import { type CyclePhase } from "../constants.js";
+export interface CycleHistoryEntry {
+    /** ISO date YYYY-MM-DD when the period started. */
+    start_date: string;
+    /** Optional length in days. */
+    length_days?: number;
+}
+export interface PhaseEstimate {
+    phase: CyclePhase;
+    cycle_day: number;
+    cycle_length_days: number;
+    /** ISO date when the next period is expected. */
+    next_period_estimate: string;
+    /** Confidence based on how much history was provided (low/medium/high). */
+    confidence: "low" | "medium" | "high";
+    notes: string[];
+}
+export declare function estimateAverageCycleLength(history: CycleHistoryEntry[]): number;
+export declare function estimatePhase(history: CycleHistoryEntry[], today?: Date): PhaseEstimate;
+export declare function phaseFromDay(cycleDay: number, cycleLength: number, periodLength: number): CyclePhase;
+export interface PhaseGuidance {
+    phase: CyclePhase;
+    nutrition: {
+        emphasize: string[];
+        moderate: string[];
+        avoid: string[];
+        hydration_ml_target: number;
+    };
+    training: {
+        style: string;
+        intensity: "low" | "low-moderate" | "moderate" | "moderate-high" | "high";
+        notes: string[];
+    };
+    notes: string[];
+}
+export declare function guidanceForPhase(phase: CyclePhase): PhaseGuidance;
+export declare function listAllPhases(): ReadonlyArray<CyclePhase>;

package/dist/services/cycle-engine.js

@@ -0,0 +1,132 @@
+/**
+ * Cycle engine — pure functions to detect phase, predict next period, and
+ * recommend nutrition / training per phase. Does NOT call any external API;
+ * all data comes from the agent or other MCP connectors and is passed in.
+ */
+import { CYCLE_PHASES, DEFAULT_CYCLE_LENGTH_DAYS, DEFAULT_LUTEAL_LENGTH_DAYS, DEFAULT_PERIOD_LENGTH_DAYS, } from "../constants.js";
+export function estimateAverageCycleLength(history) {
+    if (history.length < 2)
+        return DEFAULT_CYCLE_LENGTH_DAYS;
+    const sorted = [...history].sort((a, b) => a.start_date.localeCompare(b.start_date));
+    const diffs = [];
+    for (let i = 1; i < sorted.length; i++) {
+        const a = new Date(sorted[i - 1].start_date).getTime();
+        const b = new Date(sorted[i].start_date).getTime();
+        const days = Math.round((b - a) / 86_400_000);
+        if (days >= 18 && days <= 45)
+            diffs.push(days);
+    }
+    if (diffs.length === 0)
+        return DEFAULT_CYCLE_LENGTH_DAYS;
+    const avg = diffs.reduce((a, b) => a + b, 0) / diffs.length;
+    return Math.round(avg);
+}
+export function estimatePhase(history, today = new Date()) {
+    const sorted = [...history].sort((a, b) => a.start_date.localeCompare(b.start_date));
+    const lastPeriod = sorted[sorted.length - 1];
+    if (!lastPeriod) {
+        return {
+            phase: "follicular",
+            cycle_day: 0,
+            cycle_length_days: DEFAULT_CYCLE_LENGTH_DAYS,
+            next_period_estimate: "",
+            confidence: "low",
+            notes: ["No cycle history provided. Returning a 'follicular' default; please log at least one period start date."],
+        };
+    }
+    const cycleLength = estimateAverageCycleLength(history);
+    const cycleDay = Math.floor((today.getTime() - new Date(lastPeriod.start_date).getTime()) / 86_400_000) + 1;
+    const phase = phaseFromDay(cycleDay, cycleLength, lastPeriod.length_days ?? DEFAULT_PERIOD_LENGTH_DAYS);
+    const nextStart = new Date(new Date(lastPeriod.start_date).getTime() + cycleLength * 86_400_000);
+    const confidence = history.length >= 6 ? "high" : history.length >= 3 ? "medium" : "low";
+    return {
+        phase,
+        cycle_day: cycleDay,
+        cycle_length_days: cycleLength,
+        next_period_estimate: nextStart.toISOString().slice(0, 10),
+        confidence,
+        notes: confidence === "low" ? ["Confidence low; log more periods to improve accuracy."] : [],
+    };
+}
+export function phaseFromDay(cycleDay, cycleLength, periodLength) {
+    if (cycleDay <= periodLength)
+        return "menstrual";
+    const ovulationDay = cycleLength - DEFAULT_LUTEAL_LENGTH_DAYS;
+    if (cycleDay < ovulationDay - 1)
+        return "follicular";
+    if (cycleDay <= ovulationDay + 1)
+        return "ovulatory";
+    return "luteal";
+}
+export function guidanceForPhase(phase) {
+    switch (phase) {
+        case "menstrual":
+            return {
+                phase,
+                nutrition: {
+                    emphasize: ["iron-rich (lentils, beef, dark leafy greens)", "vitamin C (citrus, peppers) to boost iron absorption", "magnesium (dark chocolate, pumpkin seeds, spinach)", "omega-3 (fatty fish, walnuts, flax)"],
+                    moderate: ["caffeine (can worsen cramps)", "alcohol"],
+                    avoid: ["very salty foods (worsens bloating)"],
+                    hydration_ml_target: 2500,
+                },
+                training: {
+                    style: "restorative — yoga, walking, mobility, light strength",
+                    intensity: "low-moderate",
+                    notes: ["Listen to body. If energy is good on day 3+, progressive load is fine.", "Avoid heavy inversions if they're uncomfortable for you."],
+                },
+                notes: ["Energy and pain tolerance often dip on days 1-2.", "Cravings for iron-rich foods are common and physiologically reasonable."],
+            };
+        case "follicular":
+            return {
+                phase,
+                nutrition: {
+                    emphasize: ["complex carbs (oats, sweet potato, quinoa)", "fermented foods (kimchi, kefir, sauerkraut)", "leafy greens", "lean protein"],
+                    moderate: ["alcohol", "high-glycemic snacks"],
+                    avoid: [],
+                    hydration_ml_target: 2400,
+                },
+                training: {
+                    style: "build — strength, sprints, new skills, longer endurance",
+                    intensity: "moderate-high",
+                    notes: ["Body is most receptive to strength gains here.", "Higher pain tolerance and faster recovery."],
+                },
+                notes: ["Estrogen rising → mood, energy, cognitive performance typically peak.", "Best time to schedule challenging workouts and demanding cognitive work."],
+            };
+        case "ovulatory":
+            return {
+                phase,
+                nutrition: {
+                    emphasize: ["antioxidants (berries, citrus, green tea)", "fiber (cruciferous vegetables)", "lean protein", "zinc (oysters, beef, pumpkin seeds)"],
+                    moderate: ["caffeine"],
+                    avoid: [],
+                    hydration_ml_target: 2500,
+                },
+                training: {
+                    style: "peak — high intensity, PRs, plyometrics, sprints",
+                    intensity: "high",
+                    notes: ["Estrogen + testosterone both elevated — power output peaks.", "Watch joint laxity (knee/ankle) on cutting movements."],
+                },
+                notes: ["1-3 day window. Body temperature rises ~0.3°C after ovulation.", "Libido often peaks; mood is typically high."],
+            };
+        case "luteal":
+            return {
+                phase,
+                nutrition: {
+                    emphasize: ["complex carbs (slow-release energy)", "B vitamins (eggs, salmon, leafy greens)", "magnesium (dark chocolate, almonds)", "calcium (dairy or fortified alternatives)"],
+                    moderate: ["caffeine (sleep sensitivity rises)", "refined sugar (PMS worse)"],
+                    avoid: ["heavy alcohol (sleep disruption + mood)"],
+                    hydration_ml_target: 2600,
+                },
+                training: {
+                    style: "endurance + technique — Zone 2 cardio, mobility, mind-body work",
+                    intensity: "moderate",
+                    notes: ["Resting heart rate typically rises 3-5 bpm.", "Recovery slower; protein needs may rise 5-10%."],
+                },
+                notes: ["Progesterone dominant. Sleep quality may dip. Watch caffeine after noon.", "Mood/energy can drop in late luteal (PMS window)."],
+            };
+    }
+}
+export function listAllPhases() {
+    return CYCLE_PHASES;
+}
+//# sourceMappingURL=cycle-engine.js.map

package/dist/services/cycle-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cycle-engine.js","sourceRoot":"","sources":["../../src/services/cycle-engine.ts"],"names":[],"mappings":"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"}

package/dist/services/privacy-audit.d.ts

@@ -0,0 +1,8 @@
+export interface CycleCoachPrivacyAudit {
+    local_storage: string;
+    outbound_destinations: string[];
+    what_is_logged: string[];
+    what_is_never_logged: string[];
+    agent_rules: string[];
+}
+export declare function buildPrivacyAudit(): CycleCoachPrivacyAudit;

package/dist/services/privacy-audit.js

@@ -0,0 +1,22 @@
+import { LOCAL_DIR_NAME } from "../constants.js";
+export function buildPrivacyAudit() {
+    return {
+        local_storage: `~/${LOCAL_DIR_NAME} (only diagnostic logs; no cycle data is persisted)`,
+        outbound_destinations: ["none — fully local computation"],
+        what_is_logged: [
+            "Diagnostic information from doctor command (versions, env presence) — no cycle data.",
+        ],
+        what_is_never_logged: [
+            "Period dates, cycle history, symptoms, ovulation predictions, or any reproductive-health data.",
+            "User identifiers, names, or contact info.",
+        ],
+        agent_rules: [
+            "Treat menstrual cycle data with the same sensitivity as medical records.",
+            "Do not surface predictions to third parties without explicit user consent.",
+            "Never claim diagnostic accuracy — these are evidence-informed defaults, not medical guidance.",
+            "When the user is in late luteal phase and reports fatigue/mood drop, normalize it; do not pathologize.",
+            "If the user asks about pregnancy/fertility decisions, defer to a clinician.",
+        ],
+    };
+}
+//# sourceMappingURL=privacy-audit.js.map

package/dist/services/privacy-audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"privacy-audit.js","sourceRoot":"","sources":["../../src/services/privacy-audit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAUjD,MAAM,UAAU,iBAAiB;IAC/B,OAAO;QACL,aAAa,EAAE,KAAK,cAAc,qDAAqD;QACvF,qBAAqB,EAAE,CAAC,gCAAgC,CAAC;QACzD,cAAc,EAAE;YACd,sFAAsF;SACvF;QACD,oBAAoB,EAAE;YACpB,gGAAgG;YAChG,2CAA2C;SAC5C;QACD,WAAW,EAAE;YACX,0EAA0E;YAC1E,4EAA4E;YAC5E,+FAA+F;YAC/F,wGAAwG;YACxG,6EAA6E;SAC9E;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/cycle-tools.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerCycleTools(server: McpServer): void;

package/dist/tools/cycle-tools.js

@@ -0,0 +1,154 @@
+import { z } from "zod";
+import { estimatePhase, guidanceForPhase, estimateAverageCycleLength, } from "../services/cycle-engine.js";
+import { buildAgentManifest } from "../services/agent-manifest.js";
+import { buildCapabilities } from "../services/capabilities.js";
+import { buildPrivacyAudit } from "../services/privacy-audit.js";
+import { CYCLE_PHASES, UPSTREAM_CONNECTORS } from "../constants.js";
+function jsonResponse(payload) {
+    return {
+        content: [{ type: "text", text: JSON.stringify(payload, null, 2) }],
+        structuredContent: payload,
+    };
+}
+const HistorySchema = z.array(z.object({
+    start_date: z.string().regex(/^\d{4}-\d{2}-\d{2}$/),
+    length_days: z.number().int().positive().optional(),
+}));
+export function registerCycleTools(server) {
+    server.registerTool("cycle_agent_manifest", {
+        title: "Cycle agent manifest",
+        description: "Returns the wellness-cycle-coach agent manifest: tool list, supported clients, env vars, recommended first calls, capabilities, privacy posture, and community links.",
+        inputSchema: {
+            client: z
+                .enum(["claude", "codex", "cursor", "windsurf", "hermes", "openclaw", "generic"])
+                .optional(),
+        },
+    }, async ({ client }) => jsonResponse(buildAgentManifest(client ?? "generic")));
+    server.registerTool("cycle_capabilities", {
+        title: "Cycle capabilities",
+        description: "Lists supported phases, upstream connectors this coach reads from, available metrics, and privacy modes.",
+        inputSchema: {},
+    }, async () => jsonResponse(buildCapabilities()));
+    server.registerTool("cycle_connection_status", {
+        title: "Cycle connection status",
+        description: "Reports the coach is alive and reminds the agent that cycle data must be passed in via tool args (this MCP is stateless).",
+        inputSchema: {},
+    }, async () => jsonResponse({
+        ok: true,
+        stateless: true,
+        upstream_connectors: UPSTREAM_CONNECTORS,
+        note: "wellness-cycle-coach orchestrates cycle math; period start dates must be passed in tool calls (or fetched separately from apple-health-mcp / garminmcp / fitbitmcp).",
+    }));
+    server.registerTool("cycle_privacy_audit", {
+        title: "Cycle privacy audit",
+        description: "Returns what wellness-cycle-coach stores locally (none), what it sends out (none), and agent rules for handling cycle data.",
+        inputSchema: {},
+    }, async () => jsonResponse(buildPrivacyAudit()));
+    server.registerTool("cycle_data_inventory", {
+        title: "Cycle data inventory",
+        description: "Returns the metric catalog and phase taxonomy used by the coach.",
+        inputSchema: {},
+    }, async () => jsonResponse({
+        phases: CYCLE_PHASES,
+        metrics: ["current_phase", "cycle_day", "cycle_length", "next_period_estimate"],
+        recommendations: ["nutrition", "training", "hydration_ml"],
+    }));
+    server.registerTool("cycle_estimate_phase", {
+        title: "Cycle estimate phase",
+        description: "Given a list of recent period start dates (from any source), returns the current phase, cycle day, estimated cycle length, next-period date, and confidence.",
+        inputSchema: {
+            history: HistorySchema.describe("Array of {start_date: 'YYYY-MM-DD', length_days?: number}. Sorted automatically."),
+            today: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional().describe("Optional reference date; defaults to system today."),
+        },
+    }, async ({ history, today }) => {
+        const referenceDate = today ? new Date(today + "T12:00:00Z") : new Date();
+        const estimate = estimatePhase(history, referenceDate);
+        return jsonResponse(estimate);
+    });
+    server.registerTool("cycle_predict_next_period", {
+        title: "Cycle predict next period",
+        description: "Given period history, returns the average cycle length and the next-expected period start date with confidence.",
+        inputSchema: {
+            history: HistorySchema,
+        },
+    }, async ({ history }) => {
+        const cycleLength = estimateAverageCycleLength(history);
+        const sorted = [...history].sort((a, b) => a.start_date.localeCompare(b.start_date));
+        const lastStart = sorted[sorted.length - 1]?.start_date;
+        if (!lastStart) {
+            return jsonResponse({ ok: false, error: "no_history", hint: "Pass at least one period start date." });
+        }
+        const next = new Date(new Date(lastStart).getTime() + cycleLength * 86_400_000)
+            .toISOString()
+            .slice(0, 10);
+        const confidence = history.length >= 6 ? "high" : history.length >= 3 ? "medium" : "low";
+        return jsonResponse({ ok: true, cycle_length_days: cycleLength, next_period_estimate: next, confidence });
+    });
+    server.registerTool("cycle_phase_guidance", {
+        title: "Cycle phase guidance",
+        description: "Returns evidence-informed nutrition + training + hydration recommendations for a given phase.",
+        inputSchema: {
+            phase: z.enum(CYCLE_PHASES),
+        },
+    }, async ({ phase }) => jsonResponse(guidanceForPhase(phase)));
+    server.registerTool("cycle_recommend_nutrition", {
+        title: "Cycle recommend nutrition",
+        description: "Given period history, returns nutrition recommendations for the user's current phase. Combine with wellness-nourish for full meal planning.",
+        inputSchema: {
+            history: HistorySchema,
+            today: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional(),
+        },
+    }, async ({ history, today }) => {
+        const reference = today ? new Date(today + "T12:00:00Z") : new Date();
+        const estimate = estimatePhase(history, reference);
+        const guidance = guidanceForPhase(estimate.phase);
+        return jsonResponse({
+            phase: estimate.phase,
+            cycle_day: estimate.cycle_day,
+            confidence: estimate.confidence,
+            nutrition: guidance.nutrition,
+            notes: guidance.notes,
+        });
+    });
+    server.registerTool("cycle_recommend_training", {
+        title: "Cycle recommend training",
+        description: "Given period history, returns training recommendations for the user's current phase. Pair with WHOOP/Oura/Garmin recovery for late-luteal load adjustments.",
+        inputSchema: {
+            history: HistorySchema,
+            today: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional(),
+        },
+    }, async ({ history, today }) => {
+        const reference = today ? new Date(today + "T12:00:00Z") : new Date();
+        const estimate = estimatePhase(history, reference);
+        const guidance = guidanceForPhase(estimate.phase);
+        return jsonResponse({
+            phase: estimate.phase,
+            cycle_day: estimate.cycle_day,
+            confidence: estimate.confidence,
+            training: guidance.training,
+            notes: guidance.notes,
+        });
+    });
+    server.registerTool("cycle_full_report", {
+        title: "Cycle full report",
+        description: "Single-call report: phase + nutrition + training + hydration + next-period estimate.",
+        inputSchema: {
+            history: HistorySchema,
+            today: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional(),
+        },
+    }, async ({ history, today }) => {
+        const reference = today ? new Date(today + "T12:00:00Z") : new Date();
+        const estimate = estimatePhase(history, reference);
+        const guidance = guidanceForPhase(estimate.phase);
+        return jsonResponse({
+            estimate,
+            guidance,
+            cross_connector_hints: [
+                "Pair nutrition with `wellness-nourish` for meal planning that respects phase emphasis.",
+                "Pair training with `whoop-mcp` / `garminmcp` / `ouramcp` recovery for late-luteal load adjustments.",
+                "Pair hydration target with `wellness-nourish` hydration tools.",
+            ],
+        });
+    });
+}
+//# sourceMappingURL=cycle-tools.js.map

package/dist/tools/cycle-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cycle-tools.js","sourceRoot":"","sources":["../../src/tools/cycle-tools.ts"],"names":[],"mappings":"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"}

package/llms.txt

@@ -0,0 +1,45 @@
+# Wellness Cycle Coach
+
+Local-first, stateless menstrual cycle coach MCP. Takes period start dates (passed by the agent or fetched from apple-health-mcp / garminmcp / fitbitmcp), computes the user's current phase, and returns phase-aware nutrition + training + hydration recommendations. Never stores cycle data itself.
+
+Repository: https://github.com/davidmosiah/wellness-cycle-coach
+NPM: https://www.npmjs.com/package/wellness-cycle-coach
+Docs: https://wellness.delx.ai/connectors/cycle
+Primary command: npx -y wellness-cycle-coach doctor
+MCP command: wellness-cycle-mcp
+
+Core tools (11):
+- cycle_agent_manifest — runtime contract, supported clients, env vars
+- cycle_capabilities — phases, upstream connectors, metrics
+- cycle_connection_status — health + reminder this MCP is stateless
+- cycle_privacy_audit — what is logged (nothing) vs sent out (nothing)
+- cycle_data_inventory — phase taxonomy + metric catalog
+- cycle_estimate_phase — given history, return current phase + cycle day + confidence
+- cycle_predict_next_period — average cycle length + next-period date
+- cycle_phase_guidance — nutrition + training + hydration for any phase
+- cycle_recommend_nutrition — phase-aware nutrition guidance
+- cycle_recommend_training — phase-aware training guidance
+- cycle_full_report — single-call combined report
+
+Optional env vars:
+- WELLNESS_CYCLE_COACH_QUIET=1 — suppress the stderr community CTA
+
+Workflow for agents:
+1. Fetch period history from apple-health-mcp (Apple Health Cycle), garminmcp (women's health), or fitbitmcp (female health). Or take user input directly.
+2. Pass `history: [{start_date: 'YYYY-MM-DD'}]` to cycle_estimate_phase or cycle_full_report.
+3. Use returned phase to query nutrition + training guidance.
+4. Cross-reference with WHOOP/Oura/Garmin recovery for late-luteal training-load adjustments.
+5. Pair nutrition output with wellness-nourish for full meal planning.
+
+Phases:
+- menstrual (days 1 → period_length): iron + magnesium, restorative training
+- follicular (period end → ~day 13): complex carbs, build phase / strength training
+- ovulatory (~days 13-15): antioxidants, peak intensity training
+- luteal (~day 15 → next period): magnesium + B vitamins, endurance + technique training
+
+Safety:
+- Stateless — never persists cycle data.
+- Never claims medical accuracy — recommendations are evidence-informed defaults.
+- Never surfaces predictions to third parties without explicit consent.
+- Defer to clinician for fertility, pregnancy, or symptom-management decisions.
+- Treat menstrual cycle data with the same sensitivity as medical records.

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "wellness-cycle-coach",
+  "version": "0.1.0",
+  "description": "Local-first menstrual cycle coach MCP for AI agents — orchestrates Apple Health Cycle, Garmin women's health, and Fitbit female health into phase-aware nutrition and recovery context.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "wellness-cycle-coach": "dist/index.js",
+    "wellness-cycle-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "SECURITY.md",
+    "CHANGELOG.md",
+    "server.json",
+    "llms.txt"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "smoke": "node scripts/smoke-tools.mjs",
+    "test:metadata": "node scripts/metadata-check.mjs",
+    "test": "npm run typecheck && npm run build && npm run smoke && npm run test:metadata",
+    "prepublishOnly": "npm test"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "homepage": "https://wellness.delx.ai/connectors/cycle",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/davidmosiah/wellness-cycle-coach.git"
+  },
+  "bugs": {
+    "url": "https://github.com/davidmosiah/wellness-cycle-coach/issues"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "ai-agents",
+    "menstrual-cycle",
+    "womens-health",
+    "fertility",
+    "wellness",
+    "delx-wellness"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.21.0",
+    "cors": "^2.8.6",
+    "express": "^5.2.1",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/cors": "^2.8.19",
+    "@types/express": "^5.0.6",
+    "@types/node": "^25.6.0",
+    "tsx": "^4.20.6",
+    "typescript": "^6.0.3"
+  },
+  "mcpName": "io.github.davidmosiah/wellness-cycle-coach",
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "dist/index.js"
+}

package/server.json

@@ -0,0 +1,21 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.davidmosiah/wellness-cycle-coach",
+  "description": "Local-first menstrual cycle coach MCP — orchestrates cycle data into phase-aware nutrition and training context.",
+  "repository": {
+    "url": "https://github.com/davidmosiah/wellness-cycle-coach",
+    "source": "github"
+  },
+  "version": "0.1.0",
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "wellness-cycle-coach",
+      "version": "0.1.0",
+      "transport": {
+        "type": "stdio"
+      }
+    }
+  ],
+  "websiteUrl": "https://wellness.delx.ai/connectors/cycle"
+}