wellness-nourish 0.1.0

package/dist/services/meal-estimator.js

@@ -0,0 +1,178 @@
+import { addNutrients } from "./nutrients.js";
+import { gramsForQuantity, nutrientsForGrams } from "./portion-engine.js";
+const SIMPLE_FOODS = [
+    {
+        canonical: "egg",
+        aliases: ["eggs", "egg"],
+        servingGrams: 50,
+        nutrientsPer100g: {
+            calories_kcal: 143,
+            protein_g: 12.6,
+            carbohydrates_g: 0.7,
+            fat_g: 9.5,
+        },
+    },
+    {
+        canonical: "banana",
+        aliases: ["banana"],
+        servingGrams: 118,
+        nutrientsPer100g: {
+            calories_kcal: 89,
+            protein_g: 1.09,
+            carbohydrates_g: 22.84,
+            fat_g: 0.33,
+            fiber_g: 2.6,
+            sugar_g: 12.23,
+        },
+    },
+    {
+        canonical: "toast",
+        aliases: ["toast", "bread"],
+        servingGrams: 30,
+        nutrientsPer100g: {
+            calories_kcal: 313,
+            protein_g: 13,
+            carbohydrates_g: 55,
+            fat_g: 4,
+        },
+    },
+    {
+        canonical: "rice",
+        aliases: ["rice", "white rice", "brown rice"],
+        servingGrams: 158,
+        nutrientsPer100g: {
+            calories_kcal: 130,
+            protein_g: 2.7,
+            carbohydrates_g: 28,
+            fat_g: 0.3,
+        },
+    },
+    {
+        canonical: "chicken",
+        aliases: ["chicken", "chicken breast"],
+        servingGrams: 100,
+        nutrientsPer100g: {
+            calories_kcal: 165,
+            protein_g: 31,
+            carbohydrates_g: 0,
+            fat_g: 3.6,
+        },
+    },
+    {
+        canonical: "oatmeal",
+        aliases: ["oatmeal", "oats"],
+        servingGrams: 234,
+        nutrientsPer100g: {
+            calories_kcal: 71,
+            protein_g: 2.5,
+            carbohydrates_g: 12,
+            fat_g: 1.5,
+            fiber_g: 1.7,
+        },
+    },
+    {
+        canonical: "milk",
+        aliases: ["milk"],
+        servingGrams: 244,
+        nutrientsPer100g: {
+            calories_kcal: 61,
+            protein_g: 3.2,
+            carbohydrates_g: 4.8,
+            fat_g: 3.3,
+        },
+    },
+    {
+        canonical: "apple",
+        aliases: ["apple", "apples"],
+        servingGrams: 182,
+        nutrientsPer100g: {
+            calories_kcal: 52,
+            protein_g: 0.3,
+            carbohydrates_g: 13.8,
+            fat_g: 0.2,
+            fiber_g: 2.4,
+            sugar_g: 10.4,
+        },
+    },
+];
+const FOOD_BY_ALIAS = new Map(SIMPLE_FOODS.flatMap((food) => food.aliases.map((alias) => [alias, food])));
+const QUANTITY_PATTERN = String.raw `\d+(?:\.\d+)?(?:\/\d+(?:\.\d+)?)?`;
+const UNIT_PATTERN = [
+    "tablespoons",
+    "tablespoon",
+    "teaspoons",
+    "teaspoon",
+    "servings",
+    "serving",
+    "slices",
+    "slice",
+    "pieces",
+    "piece",
+    "cups",
+    "cup",
+    "tbsp",
+    "tsp",
+    "ounces",
+    "ounce",
+    "oz",
+    "grams",
+    "gram",
+    "g",
+    "kg",
+    "lb",
+    "ml",
+    "l",
+].join("|");
+const FOOD_PATTERN = new RegExp(String.raw `(?:^|(?<=[^\p{L}\p{N}_\/-]))(?:(${QUANTITY_PATTERN})\s+)?(?:(${UNIT_PATTERN})\s+)?(${[...FOOD_BY_ALIAS.keys()]
+    .sort((a, b) => b.length - a.length)
+    .join("|")})(?=$|[^\p{L}\p{N}_-])`, "giu");
+export async function estimateMeal(input) {
+    const items = [];
+    for (const match of input.text.matchAll(FOOD_PATTERN)) {
+        const quantity = parseQuantity(match[1]);
+        const unit = match[2]?.toLowerCase();
+        const alias = match[3]?.toLowerCase();
+        const food = alias === undefined ? undefined : FOOD_BY_ALIAS.get(alias);
+        if (food === undefined) {
+            continue;
+        }
+        const grams = unit === undefined
+            ? food.servingGrams * quantity
+            : (gramsForQuantity(quantity, unit, food.servingGrams) ?? food.servingGrams * quantity);
+        items.push({
+            name: food.canonical,
+            quantity,
+            grams,
+            nutrients: nutrientsForGrams(food.nutrientsPer100g, grams),
+        });
+    }
+    const foundAny = items.length > 0;
+    return {
+        text: input.text,
+        locale: input.locale,
+        meal_type: input.meal_type,
+        items,
+        total_nutrients: addNutrients(items.map((item) => item.nutrients)),
+        confidence: foundAny ? 0.55 : 0.2,
+        unresolved: foundAny ? [] : [input.text],
+        warnings: [
+            foundAny
+                ? "Nutrition values are estimates from simple food defaults."
+                : "No simple foods matched; nutrition estimate is incomplete.",
+        ],
+    };
+}
+function parseQuantity(raw) {
+    if (raw === undefined) {
+        return 1;
+    }
+    const [numerator, denominator] = raw.split("/");
+    if (numerator === undefined) {
+        return 1;
+    }
+    const quantity = denominator === undefined
+        ? Number.parseFloat(numerator)
+        : Number.parseFloat(numerator) / Number.parseFloat(denominator);
+    return Number.isFinite(quantity) && quantity > 0 ? quantity : 1;
+}
+//# sourceMappingURL=meal-estimator.js.map

package/dist/services/meal-estimator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meal-estimator.js","sourceRoot":"","sources":["../../src/services/meal-estimator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AA2B1E,MAAM,YAAY,GAA0B;IAC1C;QACE,SAAS,EAAE,KAAK;QAChB,OAAO,EAAE,CAAC,MAAM,EAAE,KAAK,CAAC;QACxB,YAAY,EAAE,EAAE;QAChB,gBAAgB,EAAE;YAChB,aAAa,EAAE,GAAG;YAClB,SAAS,EAAE,IAAI;YACf,eAAe,EAAE,GAAG;YACpB,KAAK,EAAE,GAAG;SACX;KACF;IACD;QACE,SAAS,EAAE,QAAQ;QACnB,OAAO,EAAE,CAAC,QAAQ,CAAC;QACnB,YAAY,EAAE,GAAG;QACjB,gBAAgB,EAAE;YAChB,aAAa,EAAE,EAAE;YACjB,SAAS,EAAE,IAAI;YACf,eAAe,EAAE,KAAK;YACtB,KAAK,EAAE,IAAI;YACX,OAAO,EAAE,GAAG;YACZ,OAAO,EAAE,KAAK;SACf;KACF;IACD;QACE,SAAS,EAAE,OAAO;QAClB,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC;QAC3B,YAAY,EAAE,EAAE;QAChB,gBAAgB,EAAE;YAChB,aAAa,EAAE,GAAG;YAClB,SAAS,EAAE,EAAE;YACb,eAAe,EAAE,EAAE;YACnB,KAAK,EAAE,CAAC;SACT;KACF;IACD;QACE,SAAS,EAAE,MAAM;QACjB,OAAO,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,YAAY,CAAC;QAC7C,YAAY,EAAE,GAAG;QACjB,gBAAgB,EAAE;YAChB,aAAa,EAAE,GAAG;YAClB,SAAS,EAAE,GAAG;YACd,eAAe,EAAE,EAAE;YACnB,KAAK,EAAE,GAAG;SACX;KACF;IACD;QACE,SAAS,EAAE,SAAS;QACpB,OAAO,EAAE,CAAC,SAAS,EAAE,gBAAgB,CAAC;QACtC,YAAY,EAAE,GAAG;QACjB,gBAAgB,EAAE;YAChB,aAAa,EAAE,GAAG;YAClB,SAAS,EAAE,EAAE;YACb,eAAe,EAAE,CAAC;YAClB,KAAK,EAAE,GAAG;SACX;KACF;IACD;QACE,SAAS,EAAE,SAAS;QACpB,OAAO,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC;QAC5B,YAAY,EAAE,GAAG;QACjB,gBAAgB,EAAE;YAChB,aAAa,EAAE,EAAE;YACjB,SAAS,EAAE,GAAG;YACd,eAAe,EAAE,EAAE;YACnB,KAAK,EAAE,GAAG;YACV,OAAO,EAAE,GAAG;SACb;KACF;IACD;QACE,SAAS,EAAE,MAAM;QACjB,OAAO,EAAE,CAAC,MAAM,CAAC;QACjB,YAAY,EAAE,GAAG;QACjB,gBAAgB,EAAE;YAChB,aAAa,EAAE,EAAE;YACjB,SAAS,EAAE,GAAG;YACd,eAAe,EAAE,GAAG;YACpB,KAAK,EAAE,GAAG;SACX;KACF;IACD;QACE,SAAS,EAAE,OAAO;QAClB,OAAO,EAAE,CAAC,OAAO,EAAE,QAAQ,CAAC;QAC5B,YAAY,EAAE,GAAG;QACjB,gBAAgB,EAAE;YAChB,aAAa,EAAE,EAAE;YACjB,SAAS,EAAE,GAAG;YACd,eAAe,EAAE,IAAI;YACrB,KAAK,EAAE,GAAG;YACV,OAAO,EAAE,GAAG;YACZ,OAAO,EAAE,IAAI;SACd;KACF;CACF,CAAC;AAEF,MAAM,aAAa,GAAG,IAAI,GAAG,CAC3B,YAAY,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,CAAU,CAAC,CAAC,CACpF,CAAC;AAEF,MAAM,gBAAgB,GAAG,MAAM,CAAC,GAAG,CAAA,mCAAmC,CAAC;AACvE,MAAM,YAAY,GAAG;IACnB,aAAa;IACb,YAAY;IACZ,WAAW;IACX,UAAU;IACV,UAAU;IACV,SAAS;IACT,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,OAAO;IACP,MAAM;IACN,KAAK;IACL,MAAM;IACN,KAAK;IACL,QAAQ;IACR,OAAO;IACP,IAAI;IACJ,OAAO;IACP,MAAM;IACN,GAAG;IACH,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,GAAG;CACJ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACZ,MAAM,YAAY,GAAG,IAAI,MAAM,CAC7B,MAAM,CAAC,GAAG,CAAA,mCAAmC,gBAAgB,aAAa,YAAY,UAAU,CAAC,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC;KACtH,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;KACnC,IAAI,CAAC,GAAG,CAAC,wBAAwB,EACpC,KAAK,CACN,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAIlC;IACC,MAAM,KAAK,GAAwB,EAAE,CAAC;IAEtC,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC;QACtD,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACzC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAExE,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,SAAS;QACX,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,KAAK,SAAS;YAC9B,CAAC,CAAC,IAAI,CAAC,YAAY,GAAG,QAAQ;YAC9B,CAAC,CAAC,CAAC,gBAAgB,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,IAAI,IAAI,CAAC,YAAY,GAAG,QAAQ,CAAC,CAAC;QAC1F,KAAK,CAAC,IAAI,CAAC;YACT,IAAI,EAAE,IAAI,CAAC,SAAS;YACpB,QAAQ;YACR,KAAK;YACL,SAAS,EAAE,iBAAiB,CAAC,IAAI,CAAC,gBAAgB,EAAE,KAAK,CAAC;SAC3D,CAAC,CAAC;IACL,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IAElC,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,KAAK;QACL,eAAe,EAAE,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAClE,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG;QACjC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;QACxC,QAAQ,EAAE;YACR,QAAQ;gBACN,CAAC,CAAC,2DAA2D;gBAC7D,CAAC,CAAC,4DAA4D;SACjE;KACF,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,GAAuB;IAC5C,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAChD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,QAAQ,GACZ,WAAW,KAAK,SAAS;QACvB,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC;QAC9B,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;IAEpE,OAAO,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AAClE,CAAC"}

package/dist/services/nutrients.d.ts

@@ -0,0 +1,4 @@
+import type { NutrientMap } from "../types.js";
+export declare function roundNutrient(value: number): number;
+export declare function scaleNutrients(nutrients: NutrientMap, factor: number): NutrientMap;
+export declare function addNutrients(items: NutrientMap[]): NutrientMap;

package/dist/services/nutrients.js

@@ -0,0 +1,31 @@
+export function roundNutrient(value) {
+    return Math.round((value + Number.EPSILON) * 100) / 100;
+}
+export function scaleNutrients(nutrients, factor) {
+    const scaled = {};
+    if (!Number.isFinite(factor)) {
+        return scaled;
+    }
+    for (const [key, value] of Object.entries(nutrients)) {
+        if (typeof value === "number" && Number.isFinite(value)) {
+            scaled[key] = roundNutrient(value * factor);
+        }
+    }
+    return scaled;
+}
+export function addNutrients(items) {
+    const totals = {};
+    for (const item of items) {
+        for (const [key, value] of Object.entries(item)) {
+            if (typeof value === "number" && Number.isFinite(value)) {
+                totals[key] = (totals[key] ?? 0) + value;
+            }
+        }
+    }
+    const summed = {};
+    for (const [key, value] of Object.entries(totals)) {
+        summed[key] = roundNutrient(value);
+    }
+    return summed;
+}
+//# sourceMappingURL=nutrients.js.map

package/dist/services/nutrients.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nutrients.js","sourceRoot":"","sources":["../../src/services/nutrients.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,SAAsB,EAAE,MAAc;IACnE,MAAM,MAAM,GAAgB,EAAE,CAAC;IAE/B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC7B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAmD,EAAE,CAAC;QACvG,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACxD,MAAM,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAoB;IAC/C,MAAM,MAAM,GAA+C,EAAE,CAAC;IAE9D,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAmD,EAAE,CAAC;YAClG,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBACxD,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC;YAC3C,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAgB,EAAE,CAAC;IAC/B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAuC,EAAE,CAAC;QACxF,MAAM,CAAC,GAAG,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

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

@@ -0,0 +1,4 @@
+import type { NutrientMap } from "../types.js";
+export declare const UNIT_TO_GRAMS: Readonly<Record<string, number>>;
+export declare function gramsForQuantity(quantity: number, unit: string, servingGrams?: number): number | undefined;
+export declare function nutrientsForGrams(per100g: NutrientMap, grams: number): NutrientMap;

package/dist/services/portion-engine.js

@@ -0,0 +1,50 @@
+import { scaleNutrients } from "./nutrients.js";
+export const UNIT_TO_GRAMS = {
+    g: 1,
+    gram: 1,
+    grams: 1,
+    kg: 1000,
+    oz: 28.35,
+    ounce: 28.35,
+    ounces: 28.35,
+    lb: 453.59,
+    ml: 1,
+    l: 1000,
+    cup: 240,
+    cups: 240,
+    tbsp: 15,
+    tablespoon: 15,
+    tablespoons: 15,
+    tsp: 5,
+    teaspoon: 5,
+    teaspoons: 5,
+    slice: 30,
+    slices: 30,
+    piece: 1,
+    pieces: 1,
+};
+export function gramsForQuantity(quantity, unit, servingGrams) {
+    if (!Number.isFinite(quantity)) {
+        return undefined;
+    }
+    const normalizedUnit = unit.trim().toLowerCase();
+    if (normalizedUnit === "serving" || normalizedUnit === "servings") {
+        return typeof servingGrams === "number" && Number.isFinite(servingGrams)
+            ? roundGrams(quantity * servingGrams)
+            : undefined;
+    }
+    if (normalizedUnit === "piece" || normalizedUnit === "pieces") {
+        return typeof servingGrams === "number" && Number.isFinite(servingGrams)
+            ? roundGrams(quantity * servingGrams)
+            : undefined;
+    }
+    const gramsPerUnit = UNIT_TO_GRAMS[normalizedUnit];
+    return gramsPerUnit === undefined ? undefined : roundGrams(quantity * gramsPerUnit);
+}
+export function nutrientsForGrams(per100g, grams) {
+    return scaleNutrients(per100g, grams / 100);
+}
+function roundGrams(value) {
+    return Math.round((value + Number.EPSILON) * 100) / 100;
+}
+//# sourceMappingURL=portion-engine.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"portion-engine.js","sourceRoot":"","sources":["../../src/services/portion-engine.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,CAAC,MAAM,aAAa,GAAqC;IAC7D,CAAC,EAAE,CAAC;IACJ,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,KAAK;IACT,KAAK,EAAE,KAAK;IACZ,MAAM,EAAE,KAAK;IACb,EAAE,EAAE,MAAM;IACV,EAAE,EAAE,CAAC;IACL,CAAC,EAAE,IAAI;IACP,GAAG,EAAE,GAAG;IACR,IAAI,EAAE,GAAG;IACT,IAAI,EAAE,EAAE;IACR,UAAU,EAAE,EAAE;IACd,WAAW,EAAE,EAAE;IACf,GAAG,EAAE,CAAC;IACN,QAAQ,EAAE,CAAC;IACX,SAAS,EAAE,CAAC;IACZ,KAAK,EAAE,EAAE;IACT,MAAM,EAAE,EAAE;IACV,KAAK,EAAE,CAAC;IACR,MAAM,EAAE,CAAC;CACV,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAC9B,QAAgB,EAChB,IAAY,EACZ,YAAqB;IAErB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACjD,IAAI,cAAc,KAAK,SAAS,IAAI,cAAc,KAAK,UAAU,EAAE,CAAC;QAClE,OAAO,OAAO,YAAY,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC;YACtE,CAAC,CAAC,UAAU,CAAC,QAAQ,GAAG,YAAY,CAAC;YACrC,CAAC,CAAC,SAAS,CAAC;IAChB,CAAC;IAED,IAAI,cAAc,KAAK,OAAO,IAAI,cAAc,KAAK,QAAQ,EAAE,CAAC;QAC9D,OAAO,OAAO,YAAY,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC;YACtE,CAAC,CAAC,UAAU,CAAC,QAAQ,GAAG,YAAY,CAAC;YACrC,CAAC,CAAC,SAAS,CAAC;IAChB,CAAC;IAED,MAAM,YAAY,GAAG,aAAa,CAAC,cAAc,CAAC,CAAC;IACnD,OAAO,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,GAAG,YAAY,CAAC,CAAC;AACtF,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAoB,EAAE,KAAa;IACnE,OAAO,cAAc,CAAC,OAAO,EAAE,KAAK,GAAG,GAAG,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;AAC1D,CAAC"}

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

@@ -0,0 +1,12 @@
+export interface NourishPrivacyAudit {
+    local_storage: string;
+    personal_data: string;
+    secrets_returned_by_tools: boolean;
+    raw_provider_tokens_returned_by_tools: boolean;
+    default_search_mode: string;
+    deletion: string;
+    medical_boundary: string;
+    source_license_boundary: string;
+    agent_safety: string[];
+}
+export declare function buildPrivacyAudit(): NourishPrivacyAudit;

package/dist/services/privacy-audit.js

@@ -0,0 +1,19 @@
+import { getConfig } from "./config.js";
+export function buildPrivacyAudit() {
+    const config = getConfig();
+    return {
+        local_storage: config.local_dir,
+        personal_data: "intake logs only when explicitly logged",
+        secrets_returned_by_tools: false,
+        raw_provider_tokens_returned_by_tools: false,
+        default_search_mode: "read-only",
+        deletion: "Local intake logs can be deleted by entry through nourish_delete_intake or by removing the local intake.jsonl file in the configured local storage directory.",
+        medical_boundary: "not medical advice/diagnosis/treatment/emergency",
+        source_license_boundary: "USDA FoodData Central is the primary source. Open Food Facts metadata is ODbL share-alike and must preserve attribution and share-alike obligations.",
+        agent_safety: [
+            "never ask users to paste secrets, raw health exports, provider tokens, or private food logs",
+            "return configuration booleans and paths, not secret values",
+        ],
+    };
+}
+//# 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,SAAS,EAAE,MAAM,aAAa,CAAC;AAcxC,MAAM,UAAU,iBAAiB;IAC/B,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAE3B,OAAO;QACL,aAAa,EAAE,MAAM,CAAC,SAAS;QAC/B,aAAa,EAAE,yCAAyC;QACxD,yBAAyB,EAAE,KAAK;QAChC,qCAAqC,EAAE,KAAK;QAC5C,mBAAmB,EAAE,WAAW;QAChC,QAAQ,EACN,+JAA+J;QACjK,gBAAgB,EAAE,kDAAkD;QACpE,uBAAuB,EACrB,sJAAsJ;QACxJ,YAAY,EAAE;YACZ,6FAA6F;YAC7F,4DAA4D;SAC7D;KACF,CAAC;AACJ,CAAC"}

package/dist/services/summary.d.ts

@@ -0,0 +1,28 @@
+import type { MealType, NutrientMap } from "../types.js";
+import { buildHydrationSummary } from "./hydration-store.js";
+type ByMealSummary = Record<MealType, NutrientMap>;
+export interface DailySummary {
+    date: string;
+    entry_count: number;
+    total_nutrients: NutrientMap;
+    by_meal: ByMealSummary;
+    hydration: Awaited<ReturnType<typeof buildHydrationSummary>>;
+    goal_progress: Record<string, GoalProgressEntry>;
+    confidence: number;
+    source_coverage: string[];
+}
+export interface WeeklySummary {
+    start_date: string;
+    end_date: string;
+    days: DailySummary[];
+    entry_count: number;
+    total_nutrients: NutrientMap;
+}
+interface GoalProgressEntry {
+    actual: number;
+    goal: number;
+    percent: number;
+}
+export declare function buildDailySummary(date?: string): Promise<DailySummary>;
+export declare function buildWeeklySummary(startDate?: string): Promise<WeeklySummary>;
+export {};

package/dist/services/summary.js

@@ -0,0 +1,84 @@
+import { getGoals } from "./goals-store.js";
+import { buildHydrationSummary } from "./hydration-store.js";
+import { listIntakeEntries } from "./intake-store.js";
+import { addNutrients, roundNutrient } from "./nutrients.js";
+const MEAL_TYPES = ["breakfast", "lunch", "dinner", "snack", "other"];
+export async function buildDailySummary(date = todayDate()) {
+    const entries = await listIntakeEntries({ date });
+    const byMeal = emptyByMeal();
+    const totalNutrients = addNutrients(entries.map((entry) => entry.nutrients));
+    const hydration = await buildHydrationSummary(date);
+    const goals = await getGoals();
+    for (const mealType of MEAL_TYPES) {
+        byMeal[mealType] = addNutrients(entries.filter((entry) => entry.meal_type === mealType).map((entry) => entry.nutrients));
+    }
+    return {
+        date,
+        entry_count: entries.length,
+        total_nutrients: totalNutrients,
+        by_meal: byMeal,
+        hydration,
+        goal_progress: buildGoalProgress(totalNutrients, hydration.total_ml, goals.daily, goals.hydration_ml),
+        confidence: averageConfidence(entries),
+        source_coverage: [...new Set(entries.map((entry) => entry.source_trace))],
+    };
+}
+export async function buildWeeklySummary(startDate = todayDate()) {
+    const dates = [...Array(7)].map((_, index) => addDays(startDate, index));
+    const days = await Promise.all(dates.map((date) => buildDailySummary(date)));
+    return {
+        start_date: dates[0] ?? startDate,
+        end_date: dates[6] ?? startDate,
+        days,
+        entry_count: days.reduce((total, day) => total + day.entry_count, 0),
+        total_nutrients: addNutrients(days.map((day) => day.total_nutrients)),
+    };
+}
+function emptyByMeal() {
+    return {
+        breakfast: {},
+        lunch: {},
+        dinner: {},
+        snack: {},
+        other: {},
+    };
+}
+function averageConfidence(entries) {
+    if (entries.length === 0) {
+        return 0;
+    }
+    const total = entries.reduce((sum, entry) => sum + entry.confidence, 0);
+    return roundNutrient(total / entries.length);
+}
+function buildGoalProgress(nutrients, hydrationMl, nutrientGoals, hydrationGoalMl) {
+    const progress = {};
+    for (const key of Object.keys(nutrientGoals)) {
+        const goal = nutrientGoals[key];
+        if (goal === undefined || goal <= 0) {
+            continue;
+        }
+        const actual = nutrients[key] ?? 0;
+        progress[key] = {
+            actual,
+            goal,
+            percent: roundNutrient((actual / goal) * 100),
+        };
+    }
+    if (hydrationGoalMl !== undefined && hydrationGoalMl > 0) {
+        progress.hydration_ml = {
+            actual: hydrationMl,
+            goal: hydrationGoalMl,
+            percent: roundNutrient((hydrationMl / hydrationGoalMl) * 100),
+        };
+    }
+    return progress;
+}
+function todayDate() {
+    return new Date().toISOString().slice(0, 10);
+}
+function addDays(date, days) {
+    const parsed = new Date(`${date}T00:00:00.000Z`);
+    parsed.setUTCDate(parsed.getUTCDate() + days);
+    return parsed.toISOString().slice(0, 10);
+}
+//# sourceMappingURL=summary.js.map

package/dist/services/summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary.js","sourceRoot":"","sources":["../../src/services/summary.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE7D,MAAM,UAAU,GAAwB,CAAC,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AA6B3F,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAI,GAAG,SAAS,EAAE;IACxD,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC;IAC7B,MAAM,cAAc,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;IAC7E,MAAM,SAAS,GAAG,MAAM,qBAAqB,CAAC,IAAI,CAAC,CAAC;IACpD,MAAM,KAAK,GAAG,MAAM,QAAQ,EAAE,CAAC;IAE/B,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;QAClC,MAAM,CAAC,QAAQ,CAAC,GAAG,YAAY,CAC7B,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CACxF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI;QACJ,WAAW,EAAE,OAAO,CAAC,MAAM;QAC3B,eAAe,EAAE,cAAc;QAC/B,OAAO,EAAE,MAAM;QACf,SAAS;QACT,aAAa,EAAE,iBAAiB,CAAC,cAAc,EAAE,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,YAAY,CAAC;QACrG,UAAU,EAAE,iBAAiB,CAAC,OAAO,CAAC;QACtC,eAAe,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;KAC1E,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,SAAS,GAAG,SAAS,EAAE;IAC9D,MAAM,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;IACzE,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAE7E,OAAO;QACL,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,SAAS;QACjC,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,SAAS;QAC/B,IAAI;QACJ,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,KAAK,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;QACpE,eAAe,EAAE,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;KACtE,CAAC;AACJ,CAAC;AAED,SAAS,WAAW;IAClB,OAAO;QACL,SAAS,EAAE,EAAE;QACb,KAAK,EAAE,EAAE;QACT,MAAM,EAAE,EAAE;QACV,KAAK,EAAE,EAAE;QACT,KAAK,EAAE,EAAE;KACV,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,OAAsB;IAC/C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;IACxE,OAAO,aAAa,CAAC,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AAC/C,CAAC;AAED,SAAS,iBAAiB,CACxB,SAAsB,EACtB,WAAmB,EACnB,aAA0B,EAC1B,eAAmC;IAEnC,MAAM,QAAQ,GAAsC,EAAE,CAAC;IAEvD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,aAAa,CAA6B,EAAE,CAAC;QACzE,MAAM,IAAI,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC;YACpC,SAAS;QACX,CAAC;QAED,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACnC,QAAQ,CAAC,GAAG,CAAC,GAAG;YACd,MAAM;YACN,IAAI;YACJ,OAAO,EAAE,aAAa,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC;SAC9C,CAAC;IACJ,CAAC;IAED,IAAI,eAAe,KAAK,SAAS,IAAI,eAAe,GAAG,CAAC,EAAE,CAAC;QACzD,QAAQ,CAAC,YAAY,GAAG;YACtB,MAAM,EAAE,WAAW;YACnB,IAAI,EAAE,eAAe;YACrB,OAAO,EAAE,aAAa,CAAC,CAAC,WAAW,GAAG,eAAe,CAAC,GAAG,GAAG,CAAC;SAC9D,CAAC;IACJ,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,SAAS;IAChB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC/C,CAAC;AAED,SAAS,OAAO,CAAC,IAAY,EAAE,IAAY;IACzC,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,GAAG,IAAI,gBAAgB,CAAC,CAAC;IACjD,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,CAAC;IAC9C,OAAO,MAAM,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC3C,CAAC"}

package/dist/services/usage-guide.d.ts

@@ -0,0 +1,12 @@
+export interface NourishUsageGuide {
+    name: string;
+    version: string;
+    first_minute: string[];
+    agent_workflows: Array<{
+        name: string;
+        steps: string[];
+    }>;
+    human_cli: Record<string, string>;
+    safety_rules: string[];
+}
+export declare function buildUsageGuide(): NourishUsageGuide;

package/dist/services/usage-guide.js

@@ -0,0 +1,57 @@
+import { SERVER_NAME, SERVER_VERSION } from "../constants.js";
+export function buildUsageGuide() {
+    return {
+        name: SERVER_NAME,
+        version: SERVER_VERSION,
+        first_minute: [
+            "Call nourish_connection_status.",
+            "Call nourish_capabilities.",
+            "Read nourish://usage-guide.",
+            "Use nourish_search_food or nourish_lookup_barcode before estimating whenever possible.",
+        ],
+        agent_workflows: [
+            {
+                name: "preview before write",
+                steps: [
+                    "Estimate with nourish_estimate_meal.",
+                    "Show calories, confidence, source trace, and warnings to the user.",
+                    "Call nourish_log_intake only after explicit user intent.",
+                ],
+            },
+            {
+                name: "review day",
+                steps: [
+                    "Call nourish_daily_summary with response_format markdown for human review.",
+                    "Use nourish_list_intake when the user wants to edit a specific item.",
+                    "Use nourish_update_intake or nourish_delete_intake only for the selected id.",
+                ],
+            },
+            {
+                name: "goals and hydration",
+                steps: [
+                    "Use nourish_get_goals before comparing totals to targets.",
+                    "Call nourish_log_water only after explicit user intent.",
+                    "Treat goals as local tracking preferences, not medical guidance.",
+                ],
+            },
+        ],
+        human_cli: {
+            setup: "nourish-mcp setup --client claude",
+            doctor: "nourish-mcp doctor",
+            preview: "nourish-mcp log --preview --meal breakfast \"2 eggs and banana\"",
+            list: "nourish-mcp list 2026-05-05",
+            edit: "nourish-mcp edit --entry intake_id --meal snack --notes \"corrected\"",
+            clear_day: "nourish-mcp clear-day 2026-05-05 --yes",
+            hydration: "nourish-mcp water 500 --date 2026-05-05",
+            goals: "nourish-mcp goals --set-calories 2200 --set-protein 120 --set-water 2500",
+            csv_export: "nourish-mcp export --format csv",
+        },
+        safety_rules: [
+            "Require explicit user intent for intake, hydration, goals, and deletion mutations.",
+            "Keep local food logs out of chat unless the user asks to inspect or export them.",
+            "Preserve source attribution and confidence values.",
+            "Do not present nutrition estimates as medical advice.",
+        ],
+    };
+}
+//# sourceMappingURL=usage-guide.js.map

package/dist/services/usage-guide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-guide.js","sourceRoot":"","sources":["../../src/services/usage-guide.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAc9D,MAAM,UAAU,eAAe;IAC7B,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,cAAc;QACvB,YAAY,EAAE;YACZ,iCAAiC;YACjC,4BAA4B;YAC5B,6BAA6B;YAC7B,wFAAwF;SACzF;QACD,eAAe,EAAE;YACf;gBACE,IAAI,EAAE,sBAAsB;gBAC5B,KAAK,EAAE;oBACL,sCAAsC;oBACtC,oEAAoE;oBACpE,0DAA0D;iBAC3D;aACF;YACD;gBACE,IAAI,EAAE,YAAY;gBAClB,KAAK,EAAE;oBACL,4EAA4E;oBAC5E,sEAAsE;oBACtE,8EAA8E;iBAC/E;aACF;YACD;gBACE,IAAI,EAAE,qBAAqB;gBAC3B,KAAK,EAAE;oBACL,2DAA2D;oBAC3D,yDAAyD;oBACzD,kEAAkE;iBACnE;aACF;SACF;QACD,SAAS,EAAE;YACT,KAAK,EAAE,mCAAmC;YAC1C,MAAM,EAAE,oBAAoB;YAC5B,OAAO,EAAE,kEAAkE;YAC3E,IAAI,EAAE,6BAA6B;YACnC,IAAI,EAAE,uEAAuE;YAC7E,SAAS,EAAE,wCAAwC;YACnD,SAAS,EAAE,yCAAyC;YACpD,KAAK,EAAE,0EAA0E;YACjF,UAAU,EAAE,iCAAiC;SAC9C;QACD,YAAY,EAAE;YACZ,oFAAoF;YACpF,kFAAkF;YAClF,oDAAoD;YACpD,uDAAuD;SACxD;KACF,CAAC;AACJ,CAAC"}

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

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