Previous value: -"Optional caffeine content of this item, in milligrams (e.g. ~95 for a mug of brewed coffee)."New value: +"Optional caffeine content of this item, in milligrams (e.g. ~95 for an 8 oz brewed coffee). If you omit it, Forkmate fills it from the label or its reference table when it knows the drink."

Previous value: -"Estimated nutrition for the portion eaten. Omitted fields are looked up from the food databases."New value: +"Estimated nutrition for the portion eaten. Omitted fields are looked up from the food databases. Without this object, kcal (or calories), protein_g, carb_g (or carbs_g) and fat_g set on the item itself are read as these macros."

Previous value: -"Optional. The user's own words describing this meal, verbatim (e.g. 'a pint of IPA and wings at the bar'). Only the meal description — not other parts of the conversation."New value: +"The amounts are checked against this: the user's own words for this meal, verbatim (e.g. 'a pint of IPA and wings at the bar'). Only the meal description — not other parts of the conversation. Optional; without it, the amounts are logged as sent."

Added value: +{
+  "description": "Optional. The user's own words describing this meal, verbatim (e.g. 'a pint of IPA and wings at the bar'). Only the meal description — not other parts of the conversation.",
+  "maxLength": 300,
+  "type": "string"
+}

Previous value: -"Optional provenance for these items: the `source` label of the food-database candidate they came from ('USDA', 'Open Food Facts' or 'Forkmate'), or 'estimate'. Defaults to 'estimate'; unrecognized values are recorded as an estimate."New value: +"Optional provenance for these items: the `source` label of the food-database candidate they came from ('USDA', 'Open Food Facts', 'Forkmate' or 'product label'), or 'estimate'. Defaults to 'estimate'; unrecognized values are recorded as an estimate."

Previous value: -[
-  "USDA",
-  "Open Food Facts",
-  "Forkmate",
-  "estimate"
-]New value: +[
+  "USDA",
+  "Open Food Facts",
+  "Forkmate",
+  "product label",
+  "estimate"
+]

Previous value: -"Optional provenance for these items, e.g. 'usda' or 'off' for a food-database result. Defaults to 'client' (an estimate); unrecognized values are recorded as 'client'."New value: +"Optional provenance for these items: the `source` label of the food-database candidate they came from ('USDA', 'Open Food Facts' or 'Forkmate'), or 'estimate'. Defaults to 'estimate'; unrecognized values are recorded as an estimate."

Previous value: -[
-  "client",
-  "usda",
-  "off",
-  "usda-index",
-  "mfp-import",
-  "manual",
-  "chain-menu"
-]New value: +[
+  "USDA",
+  "Open Food Facts",
+  "Forkmate",
+  "estimate"
+]

Removed value: -{
-  "type": "string"
-}

Added value: +"Identifies the entry for a later edit or deletion."

Removed value: -{
-  "description": "Where the macros came from (e.g. usda, off, client).",
-  "type": "string"
-}

Added value: +{
+  "description": "Macros missing from the source data: shown as 0 but unknown, not a real zero.",
+  "items": {
+    "enum": [
+      "protein_g",
+      "carb_g",
+      "fat_g"
+    ],
+    "type": "string"
+  },
+  "type": "array"
+}

Previous value: -nullNew value: +{
+  "properties": {
+    "day_totals": {
+      "properties": {
+        "caffeine_mg": {
+          "type": "number"
+        },
+        "entry_count": {
+          "type": "integer"
+        },
+        "fluid_ml": {
+          "type": "number"
+        },
+        "local_date": {
+          "description": "A local date, YYYY-MM-DD.",
+          "type": "string"
+        },
+        "totals": {
+          "description": "Calories and macros. Estimates, not lab-measured; not for insulin dosing.",
+          "properties": {
+            "carb_g": {
+              "type": "number"
+            },
+            "fat_g": {
+              "type": "number"
+            },
+            "kcal": {
+              "type": "number"
+            },
+            "protein_g": {
+              "type": "number"
+            }
+          },
+          "required": [
+            "kcal",
+            "protein_g",
+            "carb_g",
+            "fat_g"
+          ],
+          "type": "object"
+        }
+      },
+      "required": [
+        "local_date",
+        "entry_count",
+        "totals"
+      ],
+      "type": "object"
+    },
+    "entry": {
+      "description": "One diary entry: a meal with its foods.",
+      "properties": {
+        "at": {
+          "description": "ISO-8601 UTC instant the food was eaten.",
+          "type": "string"
+        },
+        "created_at": {
+          "type": "string"
+        },
+        "id": {
+          "type": "string"
+        },
+        "items": {
+          "items": {
+            "properties": {
+              "caffeine_mg": {
+                "type": "number"
+              },
+              "fluid_ml": {
+                "type": "number"
+              },
+              "macros": {
+                "description": "Calories and macros. Estimates, not lab-measured; not for insulin dosing.",
+                "properties": {
+                  "carb_g": {
+                    "type": "number"
+                  },
+                  "fat_g": {
+                    "type": "number"
+                  },
+                  "kcal": {
+                    "type": "number"
+                  },
+                  "protein_g": {
+                    "type": "number"
+                  }
+                },
+                "required": [],
+                "type": "object"
+              },
+              "name": {
+                "type": "string"
+              },
+              "quantity": {
+                "type": "string"
+              },
+              "source": {
+                "description": "Where the macros came from (e.g. usda, off, client).",
+                "type": "string"
+              }
+            },
+            "required": [
+              "name"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "local_date": {
+          "description": "A local date, YYYY-MM-DD.",
+          "type": "string"
+        },
+        "meal": {
+          "description": "breakfast, lunch, dinner or snack, when set.",
+          "type": "string"
+        },
+        "note": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "id",
+        "at",
+        "local_date",
+        "items"
+      ],
+      "type": "object"
+    }
+  },
+  "required": [
+    "entry",
+    "day_totals"
+  ],
+  "type": "object"
+}

Added value: +"The foods in this meal, one entry per food."

Added value: +"The package's UPC/EAN barcode, when the food came from a barcode lookup."

Added value: +"Estimated nutrition for the portion eaten. Omitted fields are looked up from the food databases."

Added value: +"Total carbohydrate for the whole portion eaten, in grams."

Added value: +"Total fat for the whole portion eaten, in grams."

Added value: +"Energy for the whole portion eaten, in kilocalories (not per 100 g)."

Added value: +"Protein for the whole portion eaten, in grams."

Added value: +"What the food is, e.g. 'scrambled eggs' or 'Greek yogurt, plain'."

Added value: +"Which meal of the day this was."

Added value: +"Optional free-text note stored with the meal, e.g. 'post-run'."

Previous value: -"Optional caffeine content of this item, in milligrams (e.g. ~95 for a mug of brewed coffee). Include it for caffeinated drinks/foods when known; omit if unknown."New value: +"Optional caffeine content of this item, in milligrams (e.g. ~95 for a mug of brewed coffee)."

Previous value: -"Optional fluid/hydration volume of this item, in millilitres (e.g. 240 for an 8 oz cup). Include it for drinks when known; omit if unknown."New value: +"Optional fluid/hydration volume of this item, in millilitres (e.g. 240 for an 8 oz cup)."

Previous value: -"Portion as the user stated it, e.g. '3' or '1 cup'. When logging a search_foods/lookup_barcode candidate you scaled by its serving, write it as 'N × <serving_label> (<total_g> g)' to match the web app's diary — e.g. a candidate with serving_grams 48 and serving_label '1 frank', eaten ×2, becomes macros = the per-100 g figures × 0.96 (96 g total), quantity '2 × 1 frank (96 g)', and `source` set to that candidate's source. This field is a DISPLAY LABEL ONLY — you must still send the already-scaled macros; the server never re-scales them."New value: +"Portion as a display label, e.g. '3', '1 cup' or '2 × 1 frank (96 g)'. Display only: the server stores macros exactly as sent and does not re-scale them."

Previous value: -"YYYY-MM-DD diary date; defaults to the user's local date (from their timezone). Pass this to log a meal on a different day."New value: +"YYYY-MM-DD diary date; defaults to the user's local date (from their timezone)."

Previous value: -"Optional provenance for these items. After search_foods/lookup_barcode, pass the candidate's source class (e.g. 'usda' or 'off') so the diary shows it's grounded. Defaults to 'client' (your own estimate). Unrecognized values are recorded as 'client'."New value: +"Optional provenance for these items, e.g. 'usda' or 'off' for a food-database result. Defaults to 'client' (an estimate); unrecognized values are recorded as 'client'."

Previous value: -[
-  "client",
-  "usda",
-  "off",
-  "usda-index",
-  "mfp-import",
-  "manual"
-]New value: +[
+  "client",
+  "usda",
+  "off",
+  "usda-index",
+  "mfp-import",
+  "manual",
+  "chain-menu"
+]

Previous value: -"Portion as stated, e.g. '3' or '1 cup'."New value: +"Portion as the user stated it, e.g. '3' or '1 cup'. When logging a search_foods/lookup_barcode candidate you scaled by its serving, write it as 'N × <serving_label> (<total_g> g)' to match the web app's diary — e.g. a candidate with serving_grams 48 and serving_label '1 frank', eaten ×2, becomes macros = the per-100 g figures × 0.96 (96 g total), quantity '2 × 1 frank (96 g)', and `source` set to that candidate's source. This field is a DISPLAY LABEL ONLY — you must still send the already-scaled macros; the server never re-scales them."

Added value: +{
+  "description": "Optional caffeine content of this item, in milligrams (e.g. ~95 for a mug of brewed coffee). Include it for caffeinated drinks/foods when known; omit if unknown.",
+  "type": "number"
+}

Added value: +{
+  "description": "Optional fluid/hydration volume of this item, in millilitres (e.g. 240 for an 8 oz cup). Include it for drinks when known; omit if unknown.",
+  "type": "number"
+}