wellness-cycle-coach 0.1.0 → 0.3.0

package/CHANGELOG.md

@@ -2,6 +2,35 @@
 
 ## [Unreleased]
 
+## [0.3.0] - 2026-05-11
+
+### Added
+
+- **Shared wellness profile support** — vendored canonical `profile-store` (Delx Wellness `ab83d1a`) at `src/services/profile-store.ts`. Reads/writes `~/.delx-wellness/profile.json` (the same file every Delx Wellness MCP can read).
+- `cycle_profile_get` MCP tool — returns the user's shared profile, one-line summary, and missing critical fields. Read-only.
+- `cycle_profile_update` MCP tool — persist a partial patch with `explicit_user_intent: true`. Rejects secret-like fields (oauth/token/secret/password/cookie/refresh/api_key/session).
+- `cycle_onboarding` MCP tool — returns the 11-question onboarding flow + the current profile + a cross-connector hint that `profile.profile.sex_or_gender_context` activates phase-aware coaching (pair with wellness-nourish phase-emphasis meals + whoop-mcp recovery for late-luteal load adjustments).
+- `wellness-cycle-coach onboarding [pt-BR|en]` CLI command — emits the flow as JSON on stdout plus a TTY-gated Markdown walkthrough on stderr ("the agent will ask these 11 questions next — non-secret data only, stored at ~/.delx-wellness/profile.json").
+
+### Changed
+
+- Tool count: 13 → 16.
+- `recommended_first_calls` now leads with `cycle_profile_get` so agents fetch the user's `sex_or_gender_context` before activating phase-aware coaching.
+
+## [0.2.0] - 2026-05-10
+
+### Added
+
+- `cycle_quickstart` tool — returns a personalized 3-step walkthrough for using the coach (gather history → call full_report → cross-reference with rest of the wellness stack).
+- `cycle_demo` tool — returns a sample `cycle_full_report` payload with synthetic data so agents see the contract before integrating real period dates.
+- `cycle_full_report` now returns a one-line `tldr` string for quick agent rendering ("Phase: luteal (cycle day 22). Eat: complex carbs, B vitamins. Train: endurance + technique (moderate). Hydrate: 2600 ml. Next period: ~2026-05-27.")
+- `doctor` CLI now returns a `recommendations[]` array suggesting next-step tools.
+
+### Changed
+
+- `recommended_first_calls` on the agent manifest now leads with `cycle_quickstart`.
+- Tool count: 11 → 13.
+
 ## [0.1.0] - 2026-05-10
 
 ### Added

package/dist/cli/commands.js

@@ -1,7 +1,8 @@
 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"]);
+import { getOnboardingFlow, getProfile, getProfilePath, missingCriticalFields, } from "../services/profile-store.js";
+const COMMANDS = new Set(["status", "doctor", "setup", "onboarding"]);
 function printCommunityCTA() {
     if (process.env.WELLNESS_CYCLE_COACH_QUIET === "1")
         return;
@@ -18,7 +19,7 @@ export function isCliCommand(args) {
     return command !== undefined && COMMANDS.has(command);
 }
 export async function runCliCommand(args) {
-    const [command] = args;
+    const [command, ...rest] = args;
     switch (command) {
         case "status":
             console.log(JSON.stringify({ name: NPM_PACKAGE_NAME, version: SERVER_VERSION, stateless: true }, null, 2));
@@ -32,6 +33,11 @@ export async function runCliCommand(args) {
                 stateless: true,
                 capabilities: buildCapabilities(),
                 privacy: buildPrivacyAudit(),
+                recommendations: [
+                    "Try cycle_demo to see a sample output before integrating real data.",
+                    "Try cycle_quickstart to get a 3-step setup tailored to your client.",
+                    "Pass period start dates via tool args; this MCP is stateless by design.",
+                ],
             }, null, 2));
             printCommunityCTA();
             return 0;
@@ -51,6 +57,28 @@ export async function runCliCommand(args) {
             }, null, 2));
             printCommunityCTA();
             return 0;
+        case "onboarding": {
+            const locale = rest[0] === "pt-BR" ? "pt-BR" : "en";
+            const flow = getOnboardingFlow(locale);
+            const profile = await getProfile();
+            const missing = missingCriticalFields(profile);
+            console.log(JSON.stringify({
+                ...flow,
+                current_profile: profile,
+                missing_critical: missing,
+            }, null, 2));
+            if (process.stderr.isTTY && process.env.WELLNESS_CYCLE_COACH_QUIET !== "1") {
+                process.stderr.write(`\n## Delx Wellness shared onboarding (${locale})\n` +
+                    `\nThe agent will ask these 11 questions next so wellness-cycle-coach (and the rest\n` +
+                    `of the wellness stack) can personalize responses — non-secret data only, stored at\n` +
+                    `${getProfilePath()}.\n\n` +
+                    flow.questions
+                        .map((q, i) => `${i + 1}. (${q.required ? "required" : "optional"}) ${q.prompt}`)
+                        .join("\n") +
+                    `\n\nPrivacy: ${flow.privacy_note}\n\n`);
+            }
+            return 0;
+        }
         default:
             return -1;
     }

package/dist/cli/commands.js.map

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

package/dist/constants.d.ts

@@ -1,7 +1,7 @@
 export declare const SERVER_NAME = "wellness-cycle-coach-mcp";
-export declare const SERVER_VERSION = "0.1.0";
+export declare const SERVER_VERSION = "0.3.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 PINNED_NPM_PACKAGE = "wellness-cycle-coach@0.3.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";

package/dist/constants.js

@@ -1,5 +1,5 @@
 export const SERVER_NAME = "wellness-cycle-coach-mcp";
-export const SERVER_VERSION = "0.1.0";
+export const SERVER_VERSION = "0.3.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";

package/dist/services/agent-manifest.js

@@ -14,19 +14,24 @@ const TOOLS = [
     "cycle_agent_manifest",
     "cycle_capabilities",
     "cycle_connection_status",
-    "cycle_privacy_audit",
     "cycle_data_inventory",
+    "cycle_demo",
     "cycle_estimate_phase",
-    "cycle_predict_next_period",
+    "cycle_full_report",
+    "cycle_onboarding",
     "cycle_phase_guidance",
+    "cycle_predict_next_period",
+    "cycle_privacy_audit",
+    "cycle_profile_get",
+    "cycle_profile_update",
+    "cycle_quickstart",
     "cycle_recommend_nutrition",
     "cycle_recommend_training",
-    "cycle_full_report",
 ];
 const RECOMMENDED_FIRST_CALLS = [
-    "cycle_connection_status",
-    "cycle_capabilities",
-    "cycle_estimate_phase",
+    "cycle_profile_get",
+    "cycle_quickstart",
+    "cycle_full_report",
 ];
 export function buildAgentManifest(client = "generic") {
     return {

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

@@ -1 +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"}
+{"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,sBAAsB;IACtB,YAAY;IACZ,sBAAsB;IACtB,mBAAmB;IACnB,kBAAkB;IAClB,sBAAsB;IACtB,2BAA2B;IAC3B,qBAAqB;IACrB,mBAAmB;IACnB,sBAAsB;IACtB,kBAAkB;IAClB,2BAA2B;IAC3B,0BAA0B;CAClB,CAAC;AAEX,MAAM,uBAAuB,GAAG;IAC9B,mBAAmB;IACnB,kBAAkB;IAClB,mBAAmB;CACpB,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/profile-store.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Delx Wellness shared profile store — canonical source.
+ *
+ * Single source of truth for user wellness context across the 14+ MCP
+ * connectors in the Delx Wellness ecosystem. Stored at:
+ *
+ *   ~/.delx-wellness/profile.json
+ *
+ * Every connector that wants to read/write user profile data vendors a
+ * COPY of this file into `src/services/profile-store.ts` (keeps each
+ * connector self-contained, no extra npm dep). When the schema changes,
+ * bump v1 → v2 here AND copy the same change into every connector.
+ *
+ * Schema is intentionally identical to
+ * `delx-wellness-hermes/src/wellness-profile.ts` (v1) so the Hermes /
+ * OpenClaw profile packs can hand off seamlessly via the migration
+ * helper below.
+ *
+ * PRIVACY CONTRACT (enforced at validation time):
+ *   ✘ NEVER stores OAuth tokens, API keys, refresh tokens, cookies,
+ *     session ids, raw provider secrets.
+ *   ✘ NEVER stores diagnostic biomarkers (HRV, glucose, BP) — those live
+ *     in the connector's own data flow.
+ *   ✓ Stores only what the user explicitly typed into onboarding:
+ *     preferred name, body basics, goals, devices, training context,
+ *     nutrition context, exercise preferences, agent preferences,
+ *     safety flags.
+ */
+export type WellnessLanguage = "en" | "pt-BR";
+export type WellnessUnits = "metric" | "imperial";
+export type WellnessReplyStyle = "concise" | "detailed";
+export interface WellnessProfile {
+    preferred_name: string;
+    language: WellnessLanguage;
+    timezone: string;
+    units: WellnessUnits;
+    /** Either an integer year (e.g. "1985") or a stated age (e.g. "39"). Optional. */
+    age_or_birth_year: string;
+    /** Free-form, e.g. "178 cm" or "5'10\"". */
+    height: string;
+    /** Free-form, e.g. "72 kg" or "158 lb". */
+    weight: string;
+    /** Free-form context for cycle-aware coaching, e.g. "female (menstruating)". Optional. */
+    sex_or_gender_context: string;
+}
+export interface WellnessGoals {
+    primary: string;
+    secondary: string[];
+    training_focus: string;
+    recovery_focus: string;
+    nutrition_focus: string;
+    sleep_focus: string;
+    biggest_friction: string;
+}
+export interface WellnessDevices {
+    connected: string[];
+    desired: string[];
+    primary_recovery_source: string;
+    primary_activity_source: string;
+    primary_nutrition_source: string;
+}
+export interface WellnessTraining {
+    sports: string[];
+    weekly_schedule: string;
+    equipment: string[];
+    location: string[];
+    preferred_duration_minutes: string;
+    exercises_to_avoid: string[];
+    limitations: string[];
+}
+export interface WellnessNutrition {
+    dietary_preferences: string[];
+    restrictions_or_allergies: string[];
+    protein_target_g: string;
+    hydration_target_ml: string;
+    calorie_target: string;
+}
+export interface WellnessPreferences {
+    language_priority: WellnessLanguage[];
+    reply_style: WellnessReplyStyle;
+    telegram_style: WellnessReplyStyle;
+    ask_before_logging: boolean;
+    include_exercise_videos_when_available: boolean;
+}
+export interface WellnessSafety {
+    injuries_or_pain: string[];
+    medical_constraints: string[];
+    conservative_flags: string[];
+}
+export interface WellnessProfileDocument {
+    schema: "delx-wellness-profile/v1";
+    generated_by: string;
+    version: 1;
+    profile: WellnessProfile;
+    goals: WellnessGoals;
+    devices: WellnessDevices;
+    training: WellnessTraining;
+    nutrition: WellnessNutrition;
+    preferences: WellnessPreferences;
+    safety: WellnessSafety;
+    notes: string;
+    updated_at?: string;
+}
+export interface OnboardingQuestion {
+    id: string;
+    prompt: string;
+    category: "profile" | "goals" | "devices" | "training" | "nutrition" | "exercise" | "preferences" | "safety";
+    required: boolean;
+}
+export interface OnboardingFlow {
+    locale: WellnessLanguage;
+    questions: OnboardingQuestion[];
+    storage_path: string;
+    privacy_note: string;
+}
+export declare const DEFAULT_PROFILE: WellnessProfileDocument;
+/** Returns the absolute storage path. Useful in privacy_audit responses. */
+export declare function getProfilePath(): string;
+/**
+ * Read the canonical profile. Returns a fresh DEFAULT_PROFILE if no file
+ * exists (and does not create the file — call updateProfile to persist).
+ *
+ * Auto-migrates from Hermes / OpenClaw profile if found and the canonical
+ * file is missing.
+ */
+export declare function getProfile(): Promise<WellnessProfileDocument>;
+/**
+ * Persist a partial patch to the canonical profile. Validates the patch
+ * against the schema before writing, rejecting unknown top-level keys and
+ * any field that smells like a secret (oauth, token, secret, password,
+ * cookie, refresh).
+ */
+export declare function updateProfile(patch: Partial<WellnessProfileDocument>): Promise<WellnessProfileDocument>;
+/**
+ * One-time migration from the Hermes or OpenClaw profile pack location.
+ * Only runs if the canonical file does NOT exist. Idempotent.
+ */
+export declare function migrateFromLegacy(): Promise<{
+    migrated: boolean;
+    from?: string;
+}>;
+/** Return the 11-question onboarding flow in the requested locale. */
+export declare function getOnboardingQuestions(locale?: WellnessLanguage): OnboardingQuestion[];
+export declare function getOnboardingFlow(locale?: WellnessLanguage): OnboardingFlow;
+/** One-line summary for agent context handoff. */
+export declare function buildProfileSummary(profile: WellnessProfileDocument): string;
+export declare function missingCriticalFields(profile: WellnessProfileDocument): string[];

package/dist/services/profile-store.js

@@ -0,0 +1,299 @@
+/**
+ * Delx Wellness shared profile store — canonical source.
+ *
+ * Single source of truth for user wellness context across the 14+ MCP
+ * connectors in the Delx Wellness ecosystem. Stored at:
+ *
+ *   ~/.delx-wellness/profile.json
+ *
+ * Every connector that wants to read/write user profile data vendors a
+ * COPY of this file into `src/services/profile-store.ts` (keeps each
+ * connector self-contained, no extra npm dep). When the schema changes,
+ * bump v1 → v2 here AND copy the same change into every connector.
+ *
+ * Schema is intentionally identical to
+ * `delx-wellness-hermes/src/wellness-profile.ts` (v1) so the Hermes /
+ * OpenClaw profile packs can hand off seamlessly via the migration
+ * helper below.
+ *
+ * PRIVACY CONTRACT (enforced at validation time):
+ *   ✘ NEVER stores OAuth tokens, API keys, refresh tokens, cookies,
+ *     session ids, raw provider secrets.
+ *   ✘ NEVER stores diagnostic biomarkers (HRV, glucose, BP) — those live
+ *     in the connector's own data flow.
+ *   ✓ Stores only what the user explicitly typed into onboarding:
+ *     preferred name, body basics, goals, devices, training context,
+ *     nutrition context, exercise preferences, agent preferences,
+ *     safety flags.
+ */
+/// <reference types="node" />
+import { promises as fs } from "node:fs";
+import { homedir } from "node:os";
+import { join, dirname } from "node:path";
+const PROFILE_DIR = join(homedir(), ".delx-wellness");
+const PROFILE_PATH = join(PROFILE_DIR, "profile.json");
+const LEGACY_PATHS = [
+    join(homedir(), ".hermes/profiles/delx-wellness/wellness-profile.json"),
+    join(homedir(), ".openclaw-delx-wellness/workspace/wellness-profile.json"),
+];
+export const DEFAULT_PROFILE = {
+    schema: "delx-wellness-profile/v1",
+    generated_by: "wellness-cycle-coach",
+    version: 1,
+    profile: {
+        preferred_name: "",
+        language: "en",
+        timezone: "",
+        units: "metric",
+        age_or_birth_year: "",
+        height: "",
+        weight: "",
+        sex_or_gender_context: "",
+    },
+    goals: {
+        primary: "",
+        secondary: [],
+        training_focus: "",
+        recovery_focus: "",
+        nutrition_focus: "",
+        sleep_focus: "",
+        biggest_friction: "",
+    },
+    devices: {
+        connected: [],
+        desired: [],
+        primary_recovery_source: "",
+        primary_activity_source: "",
+        primary_nutrition_source: "nourish",
+    },
+    training: {
+        sports: [],
+        weekly_schedule: "",
+        equipment: [],
+        location: [],
+        preferred_duration_minutes: "",
+        exercises_to_avoid: [],
+        limitations: [],
+    },
+    nutrition: {
+        dietary_preferences: [],
+        restrictions_or_allergies: [],
+        protein_target_g: "",
+        hydration_target_ml: "",
+        calorie_target: "",
+    },
+    preferences: {
+        language_priority: ["en", "pt-BR"],
+        reply_style: "concise",
+        telegram_style: "concise",
+        ask_before_logging: true,
+        include_exercise_videos_when_available: true,
+    },
+    safety: {
+        injuries_or_pain: [],
+        medical_constraints: [],
+        conservative_flags: [],
+    },
+    notes: "",
+};
+/** Returns the absolute storage path. Useful in privacy_audit responses. */
+export function getProfilePath() {
+    return PROFILE_PATH;
+}
+function clone(value) {
+    return JSON.parse(JSON.stringify(value));
+}
+async function fileExists(path) {
+    try {
+        await fs.access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function readProfileFile(path) {
+    try {
+        const raw = await fs.readFile(path, "utf8");
+        const parsed = JSON.parse(raw);
+        if (parsed.schema !== "delx-wellness-profile/v1")
+            return null;
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+async function writeProfileFile(path, profile) {
+    await fs.mkdir(dirname(path), { recursive: true });
+    const tmp = `${path}.tmp.${process.pid}.${Date.now()}`;
+    await fs.writeFile(tmp, JSON.stringify(profile, null, 2) + "\n", { encoding: "utf8", mode: 0o600 });
+    await fs.rename(tmp, path);
+}
+/**
+ * Read the canonical profile. Returns a fresh DEFAULT_PROFILE if no file
+ * exists (and does not create the file — call updateProfile to persist).
+ *
+ * Auto-migrates from Hermes / OpenClaw profile if found and the canonical
+ * file is missing.
+ */
+export async function getProfile() {
+    if (!(await fileExists(PROFILE_PATH))) {
+        const migration = await migrateFromLegacy();
+        if (migration.migrated) {
+            const migrated = await readProfileFile(PROFILE_PATH);
+            if (migrated)
+                return migrated;
+        }
+        return clone(DEFAULT_PROFILE);
+    }
+    const existing = await readProfileFile(PROFILE_PATH);
+    return existing ?? clone(DEFAULT_PROFILE);
+}
+/**
+ * Persist a partial patch to the canonical profile. Validates the patch
+ * against the schema before writing, rejecting unknown top-level keys and
+ * any field that smells like a secret (oauth, token, secret, password,
+ * cookie, refresh).
+ */
+export async function updateProfile(patch) {
+    rejectSecretsInPatch(patch);
+    const current = await getProfile();
+    const merged = {
+        schema: "delx-wellness-profile/v1",
+        generated_by: current.generated_by || DEFAULT_PROFILE.generated_by,
+        version: 1,
+        profile: { ...current.profile, ...(patch.profile ?? {}) },
+        goals: { ...current.goals, ...(patch.goals ?? {}) },
+        devices: { ...current.devices, ...(patch.devices ?? {}) },
+        training: { ...current.training, ...(patch.training ?? {}) },
+        nutrition: { ...current.nutrition, ...(patch.nutrition ?? {}) },
+        preferences: { ...current.preferences, ...(patch.preferences ?? {}) },
+        safety: { ...current.safety, ...(patch.safety ?? {}) },
+        notes: patch.notes ?? current.notes,
+        updated_at: new Date().toISOString(),
+    };
+    await writeProfileFile(PROFILE_PATH, merged);
+    return merged;
+}
+const SECRET_PATTERNS = /(oauth|token|secret|password|cookie|refresh|api[_-]?key|session)/i;
+function rejectSecretsInPatch(patch) {
+    function scan(value, path = []) {
+        if (value === null || value === undefined)
+            return;
+        if (typeof value === "string") {
+            const flat = path.join(".");
+            if (SECRET_PATTERNS.test(flat) || SECRET_PATTERNS.test(value)) {
+                throw new Error(`Refusing to store secret-like value at '${flat}'. ` +
+                    `Profile is for non-secret wellness context only.`);
+            }
+            return;
+        }
+        if (Array.isArray(value)) {
+            value.forEach((entry, i) => scan(entry, [...path, String(i)]));
+            return;
+        }
+        if (typeof value === "object") {
+            for (const [k, v] of Object.entries(value)) {
+                if (SECRET_PATTERNS.test(k)) {
+                    throw new Error(`Refusing to store secret-like field '${k}'. ` +
+                        `Profile is for non-secret wellness context only.`);
+                }
+                scan(v, [...path, k]);
+            }
+        }
+    }
+    scan(patch);
+}
+/**
+ * One-time migration from the Hermes or OpenClaw profile pack location.
+ * Only runs if the canonical file does NOT exist. Idempotent.
+ */
+export async function migrateFromLegacy() {
+    if (await fileExists(PROFILE_PATH))
+        return { migrated: false };
+    for (const candidate of LEGACY_PATHS) {
+        if (await fileExists(candidate)) {
+            const legacy = await readProfileFile(candidate);
+            if (legacy) {
+                await writeProfileFile(PROFILE_PATH, { ...legacy, updated_at: new Date().toISOString() });
+                return { migrated: true, from: candidate };
+            }
+        }
+    }
+    return { migrated: false };
+}
+const QUESTIONS_EN = [
+    { id: "preferred_name", category: "profile", required: false, prompt: "What should the agent call you?" },
+    { id: "locale_timezone_units", category: "profile", required: true, prompt: "What are your language, timezone, and units?" },
+    { id: "body_basics", category: "profile", required: false, prompt: "Share age or birth year, height, weight, and gender/sex only if you want the agent to use that context." },
+    { id: "primary_goal", category: "goals", required: true, prompt: "What is your primary wellness goal right now?" },
+    { id: "secondary_goals", category: "goals", required: false, prompt: "What secondary goals matter: fat loss, muscle, endurance, sleep, recovery, longevity, stress, consistency?" },
+    { id: "devices", category: "devices", required: true, prompt: "Which sources do you use: WHOOP, Garmin, Oura, Strava, Fitbit, Google Health, Withings, Apple Health, Samsung Health, Polar, Nourish, Air, CGM, Cycle Coach?" },
+    { id: "training_context", category: "training", required: true, prompt: "What sports do you train, how often, and what does a normal week look like?" },
+    { id: "nutrition_context", category: "nutrition", required: false, prompt: "What nutrition context should the agent know: meals, calories, macros, restrictions, allergies, or food preferences?" },
+    { id: "exercise_preferences", category: "exercise", required: false, prompt: "What equipment, location, duration, exercises to avoid, or limitations should workouts respect?" },
+    { id: "agent_preferences", category: "preferences", required: false, prompt: "Do you prefer concise replies, detailed explanations, pt-BR, English, or logging confirmations?" },
+    { id: "safety_context", category: "safety", required: false, prompt: "Any injuries, pain, medical constraints, or symptoms the agent should treat as a reason to be conservative?" },
+];
+const QUESTIONS_PT_BR = [
+    { id: "preferred_name", category: "profile", required: false, prompt: "Como o agente deve te chamar?" },
+    { id: "locale_timezone_units", category: "profile", required: true, prompt: "Qual idioma, fuso horário e sistema de medidas você prefere?" },
+    { id: "body_basics", category: "profile", required: false, prompt: "Compartilhe idade ou ano de nascimento, altura, peso e gênero/sexo apenas se quiser que o agente use esse contexto." },
+    { id: "primary_goal", category: "goals", required: true, prompt: "Qual é seu principal objetivo de wellness agora?" },
+    { id: "secondary_goals", category: "goals", required: false, prompt: "Quais objetivos secundários importam: perda de gordura, massa, endurance, sono, recuperação, longevidade, estresse ou consistência?" },
+    { id: "devices", category: "devices", required: true, prompt: "Quais fontes você usa: WHOOP, Garmin, Oura, Strava, Fitbit, Google Health, Withings, Apple Health, Samsung Health, Polar, Nourish, Air, CGM, Cycle Coach?" },
+    { id: "training_context", category: "training", required: true, prompt: "Quais esportes você treina, com que frequência, e como é uma semana normal?" },
+    { id: "nutrition_context", category: "nutrition", required: false, prompt: "Que contexto nutricional o agente deve saber: refeições, calorias, macros, restrições, alergias ou preferências alimentares?" },
+    { id: "exercise_preferences", category: "exercise", required: false, prompt: "Quais equipamentos, local, duração, exercícios a evitar ou limitações os treinos devem respeitar?" },
+    { id: "agent_preferences", category: "preferences", required: false, prompt: "Você prefere respostas concisas, explicações detalhadas, pt-BR, inglês ou confirmações antes de registrar dados?" },
+    { id: "safety_context", category: "safety", required: false, prompt: "Há lesões, dor, restrições médicas ou sintomas que o agente deve tratar como motivo para ser conservador?" },
+];
+/** Return the 11-question onboarding flow in the requested locale. */
+export function getOnboardingQuestions(locale = "en") {
+    return locale === "pt-BR" ? clone(QUESTIONS_PT_BR) : clone(QUESTIONS_EN);
+}
+export function getOnboardingFlow(locale = "en") {
+    return {
+        locale,
+        questions: getOnboardingQuestions(locale),
+        storage_path: PROFILE_PATH,
+        privacy_note: "Profile NEVER stores OAuth tokens, API keys, refresh tokens, cookies, or raw provider secrets. " +
+            "Tokens stay in each connector's own local-config (e.g. ~/.whoop-mcp/tokens.json).",
+    };
+}
+/** One-line summary for agent context handoff. */
+export function buildProfileSummary(profile) {
+    const parts = [];
+    const p = profile.profile;
+    if (p.preferred_name)
+        parts.push(p.preferred_name);
+    if (p.age_or_birth_year || p.sex_or_gender_context) {
+        const bits = [p.age_or_birth_year, p.sex_or_gender_context].filter(Boolean).join(", ");
+        parts.push(bits);
+    }
+    if (p.height && p.weight)
+        parts.push(`${p.height} / ${p.weight}`);
+    if (profile.goals.primary)
+        parts.push(`goal: ${profile.goals.primary}`);
+    if (profile.devices.connected.length > 0)
+        parts.push(`devices: ${profile.devices.connected.join(", ")}`);
+    if (profile.preferences.language_priority[0])
+        parts.push(`lang: ${profile.preferences.language_priority[0]}`);
+    return parts.length > 0 ? parts.join(" · ") : "Empty profile — run onboarding to populate.";
+}
+export function missingCriticalFields(profile) {
+    const missing = [];
+    if (!profile.profile.preferred_name)
+        missing.push("preferred_name");
+    if (!profile.profile.timezone)
+        missing.push("timezone");
+    if (!profile.goals.primary)
+        missing.push("primary_goal");
+    if (profile.devices.connected.length === 0)
+        missing.push("connected_devices");
+    if (!profile.training.weekly_schedule)
+        missing.push("training_weekly_schedule");
+    return missing;
+}
+//# sourceMappingURL=profile-store.js.map

package/dist/services/profile-store.js.map

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

package/dist/tools/cycle-tools.js

@@ -3,6 +3,7 @@ import { estimatePhase, guidanceForPhase, estimateAverageCycleLength, } from "..
 import { buildAgentManifest } from "../services/agent-manifest.js";
 import { buildCapabilities } from "../services/capabilities.js";
 import { buildPrivacyAudit } from "../services/privacy-audit.js";
+import { buildProfileSummary, getOnboardingFlow, getProfile, getProfilePath, missingCriticalFields, updateProfile, } from "../services/profile-store.js";
 import { CYCLE_PHASES, UPSTREAM_CONNECTORS } from "../constants.js";
 function jsonResponse(payload) {
     return {
@@ -131,7 +132,7 @@ export function registerCycleTools(server) {
     });
     server.registerTool("cycle_full_report", {
         title: "Cycle full report",
-        description: "Single-call report: phase + nutrition + training + hydration + next-period estimate.",
+        description: "Single-call report: phase + nutrition + training + hydration + next-period estimate. Includes a TL;DR string for quick agent rendering.",
         inputSchema: {
             history: HistorySchema,
             today: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional(),
@@ -140,7 +141,13 @@ export function registerCycleTools(server) {
         const reference = today ? new Date(today + "T12:00:00Z") : new Date();
         const estimate = estimatePhase(history, reference);
         const guidance = guidanceForPhase(estimate.phase);
+        const tldr = `Phase: ${estimate.phase} (cycle day ${estimate.cycle_day} of ~${estimate.cycle_length_days}). ` +
+            `Eat: ${guidance.nutrition.emphasize.slice(0, 2).join(", ")}. ` +
+            `Train: ${guidance.training.style} (${guidance.training.intensity}). ` +
+            `Hydrate: ${guidance.nutrition.hydration_ml_target} ml. ` +
+            `Next period: ~${estimate.next_period_estimate}.`;
         return jsonResponse({
+            tldr,
             estimate,
             guidance,
             cross_connector_hints: [
@@ -150,5 +157,133 @@ export function registerCycleTools(server) {
             ],
         });
     });
+    server.registerTool("cycle_quickstart", {
+        title: "Cycle quickstart",
+        description: "Returns a personalized 3-step walkthrough for using wellness-cycle-coach. Call this first when the user asks 'how do I use this?'",
+        inputSchema: {
+            client: z
+                .enum(["claude", "codex", "cursor", "windsurf", "hermes", "openclaw", "generic"])
+                .optional(),
+        },
+    }, async ({ client }) => {
+        return jsonResponse({
+            ok: true,
+            client: client ?? "generic",
+            stateless_reminder: "wellness-cycle-coach NEVER stores cycle data. Every call requires period start dates passed in tool args.",
+            steps: [
+                {
+                    step: 1,
+                    title: "Gather period start dates",
+                    action: "Pull period history from apple-health-mcp (Apple Health Cycle), garminmcp (women's health), or fitbitmcp (female health) — all three are in the davidmosiah ecosystem. Or ask the user directly.",
+                    example: "history: [{ start_date: '2026-04-01' }, { start_date: '2026-04-29' }]",
+                },
+                {
+                    step: 2,
+                    title: "Call cycle_full_report",
+                    action: "Pass the history array (and optionally `today` for testing). Get back current phase + nutrition + training + hydration + next-period date + a TL;DR string.",
+                    example: "cycle_full_report({ history: [...] }) → { tldr: 'Phase: luteal...', estimate, guidance }",
+                },
+                {
+                    step: 3,
+                    title: "Cross-reference with the rest of the wellness stack",
+                    action: "Use the phase to inform wellness-nourish meal planning, WHOOP/Oura/Garmin recovery to adjust training intensity in luteal, and nourish hydration to set the daily ml target.",
+                    example: "Late luteal + WHOOP recovery 65 → 'expected; pre-period normal. Endurance + magnesium-rich meal.'",
+                },
+            ],
+            next_call: "cycle_full_report",
+        });
+    });
+    server.registerTool("cycle_profile_get", {
+        title: "Cycle profile get",
+        description: "Returns the shared Delx Wellness profile (~/.delx-wellness/profile.json). Read-only. Surfaces the user's sex_or_gender_context so wellness-cycle-coach knows whether to activate phase-aware coaching at all.",
+        inputSchema: {},
+    }, async () => {
+        const profile = await getProfile();
+        return jsonResponse({
+            ok: true,
+            profile,
+            summary: buildProfileSummary(profile),
+            missing_critical: missingCriticalFields(profile),
+            storage_path: getProfilePath(),
+        });
+    });
+    server.registerTool("cycle_profile_update", {
+        title: "Cycle profile update",
+        description: "Persist a partial patch to the shared Delx Wellness profile. Requires explicit_user_intent: true. Rejects any field containing oauth/token/secret/password/cookie/refresh/api_key/session — the profile is for non-secret wellness context only.",
+        inputSchema: {
+            patch: z
+                .record(z.string(), z.unknown())
+                .describe("Partial WellnessProfileDocument patch. Top-level keys: profile, goals, devices, training, nutrition, preferences, safety, notes."),
+            explicit_user_intent: z
+                .boolean()
+                .optional()
+                .describe("Must be true. Pass only after the user explicitly asked to save/update profile data."),
+        },
+    }, async ({ patch, explicit_user_intent }) => {
+        if (explicit_user_intent !== true) {
+            return jsonResponse({
+                ok: false,
+                error: "USER_ACTION_REQUIRED",
+                message: "explicit_user_intent must be true to update the shared wellness profile. Confirm with the user, then retry.",
+            });
+        }
+        try {
+            const profile = await updateProfile(patch);
+            return jsonResponse({
+                ok: true,
+                profile,
+                summary: buildProfileSummary(profile),
+                storage_path: getProfilePath(),
+            });
+        }
+        catch (err) {
+            return jsonResponse({ ok: false, error: "update_failed", message: err.message });
+        }
+    });
+    server.registerTool("cycle_onboarding", {
+        title: "Cycle onboarding",
+        description: "Returns the 11-question onboarding flow for the shared Delx Wellness profile. Read-only. The agent should ask these questions next so wellness-cycle-coach (and the rest of the wellness stack) can personalize responses — non-secret data only, stored at ~/.delx-wellness/profile.json.",
+        inputSchema: {
+            locale: z.enum(["en", "pt-BR"]).optional().describe("Onboarding locale. Defaults to en."),
+        },
+    }, async ({ locale }) => {
+        const flow = getOnboardingFlow(locale ?? "en");
+        const profile = await getProfile();
+        return jsonResponse({
+            ok: true,
+            ...flow,
+            current_profile: profile,
+            missing_critical: missingCriticalFields(profile),
+            cross_connector_hint: "wellness-cycle-coach reads profile.profile.sex_or_gender_context to activate phase-aware coaching. Pair with wellness-nourish (phase-emphasis meals) and whoop-mcp recovery (late-luteal load adjustments).",
+        });
+    });
+    server.registerTool("cycle_demo", {
+        title: "Cycle demo",
+        description: "Returns a realistic example payload showing what cycle_full_report looks like with sample data. Use to help agents understand the contract before a real call.",
+        inputSchema: {},
+    }, async () => {
+        const sampleHistory = [
+            { start_date: "2026-03-04" },
+            { start_date: "2026-04-01" },
+            { start_date: "2026-04-29" },
+        ];
+        const estimate = estimatePhase(sampleHistory, new Date("2026-05-15T12:00:00Z"));
+        const guidance = guidanceForPhase(estimate.phase);
+        const tldr = `Phase: ${estimate.phase} (cycle day ${estimate.cycle_day} of ~${estimate.cycle_length_days}). ` +
+            `Eat: ${guidance.nutrition.emphasize.slice(0, 2).join(", ")}. ` +
+            `Train: ${guidance.training.style} (${guidance.training.intensity}). ` +
+            `Hydrate: ${guidance.nutrition.hydration_ml_target} ml.`;
+        return jsonResponse({
+            ok: true,
+            is_demo: true,
+            sample_input: { history: sampleHistory, today: "2026-05-15" },
+            sample_output: { tldr, estimate, guidance },
+            notes: [
+                "This is synthetic data showing the shape of cycle_full_report output.",
+                "In real use, the agent passes the user's actual period start dates.",
+                "Confidence rises as more history accumulates (3+ periods = medium, 6+ = high).",
+            ],
+        });
+    });
 }
 //# sourceMappingURL=cycle-tools.js.map

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wellness-cycle-coach",
-  "version": "0.1.0",
+  "version": "0.3.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",

package/server.json

@@ -6,12 +6,12 @@
     "url": "https://github.com/davidmosiah/wellness-cycle-coach",
     "source": "github"
   },
-  "version": "0.1.0",
+  "version": "0.3.0",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "wellness-cycle-coach",
-      "version": "0.1.0",
+      "version": "0.3.0",
       "transport": {
         "type": "stdio"
       }