wellness-nourish 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,97 @@
+export type ResponseFormat = "json" | "markdown";
+export type ProviderSource = "usda" | "open_food_facts" | "manual" | "estimate";
+export type MealType = "breakfast" | "lunch" | "dinner" | "snack" | "other";
+export interface NutrientMap {
+    calories_kcal?: number;
+    protein_g?: number;
+    carbohydrates_g?: number;
+    fat_g?: number;
+    fiber_g?: number;
+    sugar_g?: number;
+    saturated_fat_g?: number;
+    sodium_mg?: number;
+}
+export interface SourceLicense {
+    name: string;
+    attribution: string;
+    share_alike: boolean;
+    url?: string;
+}
+export interface FoodItem {
+    id: string;
+    source: ProviderSource;
+    source_id: string;
+    source_url?: string;
+    name: string;
+    brand?: string;
+    barcode?: string;
+    locale?: string;
+    serving?: {
+        quantity: number;
+        unit: string;
+        grams?: number;
+    };
+    available_portions: Array<{
+        label: string;
+        quantity: number;
+        unit: string;
+        grams?: number;
+    }>;
+    nutrients_per_100g: NutrientMap;
+    nutrients_per_serving?: NutrientMap;
+    data_quality: {
+        completeness: "low" | "medium" | "high";
+        confidence: number;
+        warnings: string[];
+    };
+    license: SourceLicense;
+}
+export interface IntakeEntry {
+    id: string;
+    timestamp: string;
+    date: string;
+    meal_type: MealType;
+    food_ref?: {
+        source: ProviderSource;
+        source_id: string;
+        name: string;
+    };
+    custom_food?: FoodItem;
+    quantity: number;
+    unit: string;
+    grams_estimate?: number;
+    nutrients: NutrientMap;
+    confidence: number;
+    source_trace: "exact_food" | "barcode" | "estimate" | "manual" | "agent_inference";
+    notes?: string;
+    tags: string[];
+    wellness_context_refs: string[];
+}
+export interface HydrationEntry {
+    id: string;
+    timestamp: string;
+    date: string;
+    amount_ml: number;
+    source: "manual" | "agent";
+    notes?: string;
+}
+export interface HydrationSummary {
+    date: string;
+    total_ml: number;
+    goal_ml?: number;
+    progress_percent?: number;
+    entries: HydrationEntry[];
+}
+export interface NourishGoals {
+    daily: NutrientMap;
+    hydration_ml?: number;
+    updated_at?: string;
+}
+export interface NourishConfig {
+    local_dir: string;
+    fixture_mode: boolean;
+    usda_api_key?: string;
+    off_enabled: boolean;
+    cache_ttl_seconds: number;
+    max_results: number;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/examples/claude-desktop.json

@@ -0,0 +1,13 @@
+{
+  "mcpServers": {
+    "nourish": {
+      "command": "npx",
+      "args": ["-y", "wellness-nourish"],
+      "env": {
+        "FDC_API_KEY": "${FDC_API_KEY}",
+        "NOURISH_OFF_ENABLED": "1",
+        "NOURISH_LOCAL_DIR": "~/.wellness-nourish"
+      }
+    }
+  }
+}

package/examples/codex.json

@@ -0,0 +1,13 @@
+{
+  "mcpServers": {
+    "nourish": {
+      "command": "npx",
+      "args": ["-y", "wellness-nourish"],
+      "env": {
+        "FDC_API_KEY": "${FDC_API_KEY}",
+        "NOURISH_OFF_ENABLED": "1",
+        "NOURISH_LOCAL_DIR": "~/.wellness-nourish"
+      }
+    }
+  }
+}

package/examples/cursor.json

@@ -0,0 +1,13 @@
+{
+  "mcpServers": {
+    "nourish": {
+      "command": "npx",
+      "args": ["-y", "wellness-nourish"],
+      "env": {
+        "FDC_API_KEY": "${FDC_API_KEY}",
+        "NOURISH_OFF_ENABLED": "1",
+        "NOURISH_LOCAL_DIR": "~/.wellness-nourish"
+      }
+    }
+  }
+}

package/examples/hermes.md

@@ -0,0 +1,18 @@
+# Hermes
+
+Use the package command as the MCP server command:
+
+```json
+{
+  "name": "nourish",
+  "command": "npx",
+  "args": ["-y", "wellness-nourish"],
+  "env": {
+    "FDC_API_KEY": "${FDC_API_KEY}",
+    "NOURISH_OFF_ENABLED": "1",
+    "NOURISH_LOCAL_DIR": "~/.wellness-nourish"
+  }
+}
+```
+
+After config changes, reload MCP and call `nourish_connection_status`, `nourish_capabilities`, and `nourish_agent_manifest`.

package/examples/openclaw.md

@@ -0,0 +1,18 @@
+# OpenClaw
+
+Register `nourish` as a stdio MCP server:
+
+```json
+{
+  "name": "nourish",
+  "command": "npx",
+  "args": ["-y", "wellness-nourish"],
+  "env": {
+    "FDC_API_KEY": "${FDC_API_KEY}",
+    "NOURISH_OFF_ENABLED": "1",
+    "NOURISH_LOCAL_DIR": "~/.wellness-nourish"
+  }
+}
+```
+
+Use direct MCP tools for reads and mutations. Agents should preview or summarize before logging, and only mutate intake, hydration, or goals after explicit user intent.

package/examples/windsurf.json

@@ -0,0 +1,13 @@
+{
+  "mcpServers": {
+    "nourish": {
+      "command": "npx",
+      "args": ["-y", "wellness-nourish"],
+      "env": {
+        "FDC_API_KEY": "${FDC_API_KEY}",
+        "NOURISH_OFF_ENABLED": "1",
+        "NOURISH_LOCAL_DIR": "~/.wellness-nourish"
+      }
+    }
+  }
+}

package/fixtures/open-food-facts/barcode-peanut-butter.json

@@ -0,0 +1,23 @@
+{
+  "code": "737628064502",
+  "status": 1,
+  "product": {
+    "code": "737628064502",
+    "product_name": "Peanut Butter",
+    "brands": "Fixture Foods",
+    "url": "https://world.openfoodfacts.org/product/737628064502",
+    "quantity": "454 g",
+    "serving_size": "2 tbsp (32 g)",
+    "serving_quantity": 32,
+    "nutriments": {
+      "energy-kcal_100g": 588,
+      "proteins_100g": 25,
+      "carbohydrates_100g": 20,
+      "fat_100g": 50,
+      "fiber_100g": 6,
+      "sugars_100g": 9,
+      "saturated-fat_100g": 10,
+      "sodium_100g": 0.4
+    }
+  }
+}

package/fixtures/usda/food-banana.json

@@ -0,0 +1,16 @@
+{
+  "fdcId": 173944,
+  "description": "Bananas, raw",
+  "dataType": "SR Legacy",
+  "foodNutrients": [
+    { "nutrient": { "id": 1008 }, "amount": 89 },
+    { "nutrient": { "id": 1003 }, "amount": 1.09 },
+    { "nutrient": { "id": 1005 }, "amount": 22.84 },
+    { "nutrient": { "id": 1004 }, "amount": 0.33 },
+    { "nutrient": { "id": 1079 }, "amount": 2.6 },
+    { "nutrient": { "id": 1063 }, "amount": 12.23 }
+  ],
+  "foodPortions": [
+    { "gramWeight": 118, "modifier": "1 medium" }
+  ]
+}

package/fixtures/usda/search-banana.json

@@ -0,0 +1,17 @@
+{
+  "foods": [
+    {
+      "fdcId": 173944,
+      "description": "Bananas, raw",
+      "dataType": "SR Legacy",
+      "foodNutrients": [
+        { "nutrientId": 1008, "value": 89 },
+        { "nutrientId": 1003, "value": 1.09 },
+        { "nutrientId": 1005, "value": 22.84 },
+        { "nutrientId": 1004, "value": 0.33 },
+        { "nutrientId": 1079, "value": 2.6 },
+        { "nutrientId": 1063, "value": 12.23 }
+      ]
+    }
+  ]
+}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "wellness-nourish",
+  "version": "0.1.0",
+  "description": "Standalone MCP server for nutrition search, intake, and meal summaries.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "wellness-nourish": "dist/index.js",
+    "nourish-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "prepack": "npm run build && node -e \"require('node:fs').accessSync('dist/index.js')\"",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "smoke": "node scripts/smoke-tools.mjs",
+    "smoke:http": "node scripts/smoke-http.mjs",
+    "test:normalization": "node scripts/test-normalization.mjs",
+    "test:providers": "node scripts/test-providers.mjs",
+    "test:intake-store": "node scripts/test-intake-store.mjs",
+    "test:hydration-goals": "node scripts/test-hydration-goals.mjs",
+    "test:meal-estimator": "node scripts/test-meal-estimator.mjs",
+    "test:summary": "node scripts/test-summary.mjs",
+    "test:cli-ux": "node scripts/cli-ux-test.mjs",
+    "test:agent-readiness": "node scripts/agent-readiness-test.mjs",
+    "test:hermes-agent": "node scripts/hermes-agent-manifest-test.mjs",
+    "test:privacy": "node scripts/privacy-redaction-test.mjs",
+    "test": "npm run typecheck && npm run build && npm run test:normalization && npm run test:providers && npm run test:intake-store && npm run test:hydration-goals && npm run test:meal-estimator && npm run test:summary && npm run test:privacy && npm run smoke && npm run smoke:http && npm run test:cli-ux && npm run test:agent-readiness && npm run test:hermes-agent && npm run prepack"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "homepage": "https://wellness.delx.ai/connectors/nourish",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/davidmosiah/wellness-nourish.git"
+  },
+  "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"
+  }
+}

package/server.json

@@ -0,0 +1,16 @@
+{
+  "name": "io.github.davidmosiah/wellness-nourish",
+  "package": "wellness-nourish",
+  "version": "0.1.0",
+  "description": "Local MCP server for nutrition search, barcode lookup, intake logging, hydration, goals, exports, and meal summaries.",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/davidmosiah/wellness-nourish"
+  },
+  "command": "npx",
+  "args": [
+    "-y",
+    "wellness-nourish"
+  ],
+  "status": "active"
+}

package/tsconfig.json

@@ -0,0 +1,21 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2022"],
+    "rootDir": "src",
+    "outDir": "dist",
+    "strict": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "skipLibCheck": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "sourceMap": true,
+    "noUncheckedIndexedAccess": true,
+    "exactOptionalPropertyTypes": true
+  },
+  "include": ["src/**/*.ts"],
+  "exclude": ["dist", "node_modules"]
+}