forge-openclaw-plugin 0.2.98 → 0.2.100

package/dist/server/src/components/ui/info-tooltip.js

@@ -1,14 +1,59 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useEffect, useId, useRef, useState } from "react";
+import { useEffect, useId, useLayoutEffect, useRef, useState } from "react";
+import { createPortal } from "react-dom";
 import { CircleHelp } from "lucide-react";
 import { cn } from "../../lib/utils.js";
+const TOOLTIP_GUTTER_PX = 16;
+const TOOLTIP_MAX_WIDTH_PX = 320;
+const TOOLTIP_MIN_HEIGHT_BELOW_PX = 180;
+const TOOLTIP_ESTIMATED_HEIGHT_PX = 220;
 export function FieldHint({ children, className }) {
     return (_jsx("div", { className: cn("text-sm leading-6 text-white/50", className), children: children }));
 }
 export function InfoTooltip({ content, title, label = "Explain this field", className, panelClassName }) {
     const [open, setOpen] = useState(false);
+    const [panelStyle, setPanelStyle] = useState({});
     const containerRef = useRef(null);
+    const triggerRef = useRef(null);
     const tooltipId = useId();
+    const tooltipPanel = typeof document === "undefined"
+        ? null
+        : createPortal(_jsxs("span", { id: tooltipId, role: "tooltip", "aria-hidden": !open, "data-state": open ? "open" : "closed", style: panelStyle, className: cn("pointer-events-none fixed z-[9999] grid overflow-y-auto rounded-[8px] border border-white/10 bg-[#0c111e] px-3 py-2.5 text-left font-sans text-sm normal-case leading-6 tracking-normal text-white/74 shadow-[0_18px_48px_rgba(3,8,18,0.42)] transition", open ? "translate-y-0 opacity-100" : "translate-y-1 opacity-0", panelClassName), children: [title ? (_jsx("span", { className: "text-[11px] font-semibold uppercase tracking-[0.14em] text-white/58", children: title })) : null, _jsx("span", { className: "block min-w-0 whitespace-normal break-words", children: content })] }), document.body);
+    useLayoutEffect(() => {
+        if (!open) {
+            return;
+        }
+        const positionTooltip = () => {
+            const trigger = triggerRef.current;
+            if (!trigger) {
+                return;
+            }
+            const rect = trigger.getBoundingClientRect();
+            const width = window.innerWidth < 480
+                ? window.innerWidth - TOOLTIP_GUTTER_PX * 2
+                : Math.min(TOOLTIP_MAX_WIDTH_PX, window.innerWidth - TOOLTIP_GUTTER_PX * 2);
+            const centeredLeft = rect.left + rect.width / 2 - width / 2;
+            const maxLeft = window.innerWidth - width - TOOLTIP_GUTTER_PX;
+            const left = Math.max(TOOLTIP_GUTTER_PX, Math.min(centeredLeft, maxLeft));
+            const availableBelow = window.innerHeight - rect.bottom;
+            const top = availableBelow >= TOOLTIP_MIN_HEIGHT_BELOW_PX
+                ? rect.bottom + 8
+                : Math.max(TOOLTIP_GUTTER_PX, rect.top - TOOLTIP_ESTIMATED_HEIGHT_PX);
+            setPanelStyle({
+                left,
+                maxHeight: `calc(100vh - ${top + TOOLTIP_GUTTER_PX}px)`,
+                top,
+                width
+            });
+        };
+        positionTooltip();
+        window.addEventListener("resize", positionTooltip);
+        window.addEventListener("scroll", positionTooltip, true);
+        return () => {
+            window.removeEventListener("resize", positionTooltip);
+            window.removeEventListener("scroll", positionTooltip, true);
+        };
+    }, [open]);
     useEffect(() => {
         if (!open) {
             return;
@@ -21,9 +66,9 @@ export function InfoTooltip({ content, title, label = "Explain this field", clas
         document.addEventListener("pointerdown", handlePointerDown);
         return () => document.removeEventListener("pointerdown", handlePointerDown);
     }, [open]);
-    return (_jsxs("span", { ref: containerRef, className: cn("relative inline-flex items-center", className), onMouseEnter: () => setOpen(true), onMouseLeave: () => setOpen(false), children: [_jsx("button", { type: "button", "aria-label": label, "aria-describedby": open ? tooltipId : undefined, "aria-expanded": open, className: "inline-flex size-5 items-center justify-center rounded-full text-white/42 transition hover:bg-white/[0.06] hover:text-white/78 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[rgba(192,193,255,0.35)]", onFocus: () => setOpen(true), onBlur: () => setOpen(false), onClick: () => setOpen((current) => !current), onKeyDown: (event) => {
+    return (_jsxs("span", { ref: containerRef, className: cn("relative inline-flex items-center", className), onMouseEnter: () => setOpen(true), onMouseLeave: () => setOpen(false), children: [_jsx("button", { ref: triggerRef, type: "button", "aria-label": label, "aria-describedby": open ? tooltipId : undefined, "aria-expanded": open, className: "inline-flex size-5 items-center justify-center rounded-full text-white/42 transition hover:bg-white/[0.06] hover:text-white/78 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[rgba(192,193,255,0.35)]", onFocus: () => setOpen(true), onBlur: () => setOpen(false), onClick: () => setOpen((current) => !current), onKeyDown: (event) => {
                     if (event.key === "Escape") {
                         setOpen(false);
                     }
-                }, children: _jsx(CircleHelp, { className: "size-3.5" }) }), _jsxs("span", { id: tooltipId, role: "tooltip", "aria-hidden": !open, "data-state": open ? "open" : "closed", className: cn("pointer-events-none absolute right-0 top-[calc(100%+0.55rem)] z-40 grid w-[min(20rem,calc(100vw-2.5rem))] max-w-[calc(100vw-2.5rem)] gap-1 rounded-[8px] border border-white/10 bg-[rgba(12,17,30,0.97)] px-3 py-2.5 text-left text-sm leading-6 text-white/74 shadow-[0_18px_48px_rgba(3,8,18,0.42)] transition", open ? "translate-y-0 opacity-100" : "translate-y-1 opacity-0", panelClassName), children: [title ? (_jsx("span", { className: "text-[11px] font-semibold uppercase tracking-[0.14em] text-white/58", children: title })) : null, _jsx("span", { children: content })] })] }));
+                }, children: _jsx(CircleHelp, { className: "size-3.5" }) }), tooltipPanel] }));
 }

package/dist/server/src/lib/api.js

@@ -1756,6 +1756,137 @@ export function getVitalsView(userIds) {
     const suffix = search.size > 0 ? `?${search.toString()}` : "";
     return request(`/api/v1/health/vitals${suffix}`);
 }
+export function getWeightLossView(userIds) {
+    const search = new URLSearchParams();
+    appendUserIds(search, coerceUserIds(userIds));
+    const suffix = search.size > 0 ? `?${search.toString()}` : "";
+    return request(`/api/v1/health/weight-loss${suffix}`);
+}
+export function updateNutritionTarget(patch, userIds) {
+    const search = new URLSearchParams();
+    appendUserIds(search, coerceUserIds(userIds));
+    const suffix = search.size > 0 ? `?${search.toString()}` : "";
+    return request(`/api/v1/health/weight-loss/target${suffix}`, {
+        method: "PATCH",
+        body: JSON.stringify(patch)
+    });
+}
+export function searchNutritionFoods(input) {
+    const search = new URLSearchParams();
+    appendUserIds(search, coerceUserIds(input.userIds));
+    const suffix = search.size > 0 ? `?${search.toString()}` : "";
+    return request(`/api/v1/health/weight-loss/foods/search${suffix}`, {
+        method: "POST",
+        body: JSON.stringify({ query: input.query, limit: input.limit })
+    });
+}
+export function lookupNutritionBarcode(input) {
+    const search = new URLSearchParams();
+    appendUserIds(search, coerceUserIds(input.userIds));
+    const suffix = search.size > 0 ? `?${search.toString()}` : "";
+    return request(`/api/v1/health/weight-loss/foods/barcode${suffix}`, {
+        method: "POST",
+        body: JSON.stringify({ barcode: input.barcode })
+    });
+}
+export function createNutritionFoodLog(input, userIds) {
+    const search = new URLSearchParams();
+    appendUserIds(search, coerceUserIds(userIds));
+    const suffix = search.size > 0 ? `?${search.toString()}` : "";
+    return request(`/api/v1/health/weight-loss/food-logs${suffix}`, {
+        method: "POST",
+        body: JSON.stringify(input)
+    });
+}
+export function patchNutritionFoodLog(foodLogId, patch, userIds) {
+    const search = new URLSearchParams();
+    appendUserIds(search, coerceUserIds(userIds));
+    const suffix = search.size > 0 ? `?${search.toString()}` : "";
+    return request(`/api/v1/health/weight-loss/food-logs/${foodLogId}${suffix}`, {
+        method: "PATCH",
+        body: JSON.stringify(patch)
+    });
+}
+export function deleteNutritionFoodLog(foodLogId, userIds) {
+    const search = new URLSearchParams();
+    appendUserIds(search, coerceUserIds(userIds));
+    const suffix = search.size > 0 ? `?${search.toString()}` : "";
+    return request(`/api/v1/health/weight-loss/food-logs/${foodLogId}${suffix}`, { method: "DELETE" });
+}
+export function parseNutritionFoodLogWithChatGpt(input) {
+    const search = new URLSearchParams();
+    appendUserIds(search, coerceUserIds(input.userIds));
+    const suffix = search.size > 0 ? `?${search.toString()}` : "";
+    return request(`/api/v1/health/weight-loss/parse${suffix}`, {
+        method: "POST",
+        body: JSON.stringify({
+            text: input.text,
+            imageDescription: input.imageDescription,
+            loggedAt: input.loggedAt,
+            mealLabel: input.mealLabel
+        })
+    });
+}
+export function createNutritionBodyCheckin(input, userIds) {
+    const search = new URLSearchParams();
+    appendUserIds(search, coerceUserIds(userIds));
+    const suffix = search.size > 0 ? `?${search.toString()}` : "";
+    return request(`/api/v1/health/weight-loss/body-checkins${suffix}`, {
+        method: "POST",
+        body: JSON.stringify(input)
+    });
+}
+export function createNutritionAppearanceCheckin(input, userIds) {
+    const search = new URLSearchParams();
+    appendUserIds(search, coerceUserIds(userIds));
+    const suffix = search.size > 0 ? `?${search.toString()}` : "";
+    return request(`/api/v1/health/weight-loss/appearance-checkins${suffix}`, {
+        method: "POST",
+        body: JSON.stringify(input)
+    });
+}
+export function createNutritionSubjectiveCheckin(input, userIds) {
+    const search = new URLSearchParams();
+    appendUserIds(search, coerceUserIds(userIds));
+    const suffix = search.size > 0 ? `?${search.toString()}` : "";
+    return request(`/api/v1/health/weight-loss/subjective-checkins${suffix}`, {
+        method: "POST",
+        body: JSON.stringify(input)
+    });
+}
+export function createNutritionGutCheckin(input, userIds) {
+    const search = new URLSearchParams();
+    appendUserIds(search, coerceUserIds(userIds));
+    const suffix = search.size > 0 ? `?${search.toString()}` : "";
+    return request(`/api/v1/health/weight-loss/gut-checkins${suffix}`, {
+        method: "POST",
+        body: JSON.stringify(input)
+    });
+}
+export function getNutritionPatterns(userIds) {
+    const search = new URLSearchParams();
+    appendUserIds(search, coerceUserIds(userIds));
+    const suffix = search.size > 0 ? `?${search.toString()}` : "";
+    return request(`/api/v1/health/weight-loss/patterns${suffix}`);
+}
+export function createNutritionExperiment(input, userIds) {
+    const search = new URLSearchParams();
+    appendUserIds(search, coerceUserIds(userIds));
+    const suffix = search.size > 0 ? `?${search.toString()}` : "";
+    return request(`/api/v1/health/weight-loss/experiments${suffix}`, {
+        method: "POST",
+        body: JSON.stringify(input)
+    });
+}
+export function patchNutritionExperiment(experimentId, patch, userIds) {
+    const search = new URLSearchParams();
+    appendUserIds(search, coerceUserIds(userIds));
+    const suffix = search.size > 0 ? `?${search.toString()}` : "";
+    return request(`/api/v1/health/weight-loss/experiments/${experimentId}${suffix}`, {
+        method: "PATCH",
+        body: JSON.stringify(patch)
+    });
+}
 export function getMovementDay(input) {
     const search = new URLSearchParams();
     if (input?.date) {

package/dist/server/src/lib/weight-loss-types.js

@@ -0,0 +1 @@
+export {};

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "forge-openclaw-plugin",
   "name": "Forge",
   "description": "Curated OpenClaw adapter for the Forge collaboration API, UI entrypoint, and localhost auto-start runtime.",
-  "version": "0.2.98",
+  "version": "0.2.100",
   "activation": {
     "onStartup": true,
     "onCapabilities": [
@@ -42,6 +42,7 @@
       "forge_get_calendar_overview",
       "forge_get_current_work",
       "forge_get_doctor",
+      "forge_get_nutrition_patterns",
       "forge_get_operator_context",
       "forge_get_operator_overview",
       "forge_get_preferences_workspace",
@@ -55,6 +56,7 @@
       "forge_get_ui_entrypoint",
       "forge_get_user_directory",
       "forge_get_weekly_review",
+      "forge_get_weight_loss_overview",
       "forge_get_wiki_health",
       "forge_get_wiki_page",
       "forge_get_wiki_settings",
@@ -64,8 +66,15 @@
       "forge_ingest_wiki_source",
       "forge_list_questionnaires",
       "forge_list_wiki_pages",
+      "forge_log_appearance_checkin",
+      "forge_log_body_checkin",
+      "forge_log_food",
+      "forge_log_gut_checkin",
+      "forge_log_subjective_food_effect",
       "forge_log_work",
+      "forge_lookup_nutrition_barcode",
       "forge_merge_preferences_contexts",
+      "forge_parse_food_log_with_chatgpt",
       "forge_post_insight",
       "forge_publish_questionnaire_draft",
       "forge_recommend_task_timeboxes",
@@ -73,7 +82,10 @@
       "forge_release_task_run",
       "forge_restore_entities",
       "forge_search_entities",
+      "forge_search_foods",
+      "forge_search_nutrition_foods",
       "forge_search_wiki",
+      "forge_start_nutrition_experiment",
       "forge_start_preferences_game",
       "forge_start_questionnaire_run",
       "forge_start_task_run",
@@ -82,6 +94,7 @@
       "forge_sync_calendar_connection",
       "forge_sync_wiki_vault",
       "forge_update_entities",
+      "forge_update_nutrition_experiment",
       "forge_update_preferences_score",
       "forge_update_questionnaire_run",
       "forge_update_sleep_session",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "forge-openclaw-plugin",
-  "version": "0.2.98",
+  "version": "0.2.100",
   "description": "Curated OpenClaw adapter for the Forge collaboration API, UI entrypoint, and localhost auto-start runtime.",
   "type": "module",
   "license": "Apache-2.0",

package/server/migrations/065_weight_loss_nutrition_insights.sql

@@ -0,0 +1,236 @@
+CREATE TABLE IF NOT EXISTS nutrition_targets (
+  id TEXT PRIMARY KEY,
+  user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+  calorie_target REAL,
+  protein_grams_target REAL,
+  fiber_grams_target REAL,
+  carbohydrate_grams_target REAL,
+  fat_grams_target REAL,
+  weight_goal_kg REAL,
+  weekly_rate_goal_kg REAL,
+  diet_style TEXT NOT NULL DEFAULT '',
+  body_goal TEXT NOT NULL DEFAULT '',
+  notes TEXT NOT NULL DEFAULT '',
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+
+CREATE UNIQUE INDEX IF NOT EXISTS idx_nutrition_targets_user
+  ON nutrition_targets(user_id);
+
+CREATE TABLE IF NOT EXISTS nutrition_food_catalog (
+  id TEXT PRIMARY KEY,
+  source TEXT NOT NULL,
+  source_id TEXT NOT NULL,
+  barcode TEXT,
+  name TEXT NOT NULL,
+  brand TEXT NOT NULL DEFAULT '',
+  serving_label TEXT NOT NULL DEFAULT '',
+  serving_grams REAL,
+  calories REAL,
+  protein_grams REAL,
+  carbohydrate_grams REAL,
+  fat_grams REAL,
+  fiber_grams REAL,
+  sugar_grams REAL,
+  sodium_mg REAL,
+  potassium_mg REAL,
+  caffeine_mg REAL,
+  alcohol_grams REAL,
+  nova_group INTEGER,
+  nutri_score TEXT,
+  tags_json TEXT NOT NULL DEFAULT '[]',
+  nutrients_json TEXT NOT NULL DEFAULT '{}',
+  confidence REAL NOT NULL DEFAULT 0.65,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+
+CREATE UNIQUE INDEX IF NOT EXISTS idx_nutrition_food_catalog_source
+  ON nutrition_food_catalog(source, source_id);
+
+CREATE INDEX IF NOT EXISTS idx_nutrition_food_catalog_barcode
+  ON nutrition_food_catalog(barcode);
+
+CREATE TABLE IF NOT EXISTS nutrition_food_logs (
+  id TEXT PRIMARY KEY,
+  user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+  logged_at TEXT NOT NULL,
+  meal_label TEXT NOT NULL DEFAULT '',
+  source TEXT NOT NULL DEFAULT 'manual',
+  confirmation_state TEXT NOT NULL DEFAULT 'confirmed',
+  notes TEXT NOT NULL DEFAULT '',
+  place_id TEXT,
+  stay_id TEXT,
+  workout_id TEXT,
+  sleep_id TEXT,
+  day_key TEXT NOT NULL,
+  image_refs_json TEXT NOT NULL DEFAULT '[]',
+  parser_provenance_json TEXT NOT NULL DEFAULT '{}',
+  links_json TEXT NOT NULL DEFAULT '[]',
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_nutrition_food_logs_user_time
+  ON nutrition_food_logs(user_id, logged_at DESC);
+
+CREATE INDEX IF NOT EXISTS idx_nutrition_food_logs_day
+  ON nutrition_food_logs(user_id, day_key);
+
+CREATE TABLE IF NOT EXISTS nutrition_meal_items (
+  id TEXT PRIMARY KEY,
+  log_id TEXT NOT NULL REFERENCES nutrition_food_logs(id) ON DELETE CASCADE,
+  food_id TEXT REFERENCES nutrition_food_catalog(id) ON DELETE SET NULL,
+  name TEXT NOT NULL,
+  quantity REAL NOT NULL DEFAULT 1,
+  unit TEXT NOT NULL DEFAULT 'serving',
+  grams REAL,
+  calories REAL,
+  protein_grams REAL,
+  carbohydrate_grams REAL,
+  fat_grams REAL,
+  fiber_grams REAL,
+  sugar_grams REAL,
+  sodium_mg REAL,
+  potassium_mg REAL,
+  caffeine_mg REAL,
+  alcohol_grams REAL,
+  tags_json TEXT NOT NULL DEFAULT '[]',
+  nutrients_json TEXT NOT NULL DEFAULT '{}',
+  confidence REAL NOT NULL DEFAULT 0.65,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_nutrition_meal_items_log
+  ON nutrition_meal_items(log_id);
+
+CREATE TABLE IF NOT EXISTS nutrition_body_checkins (
+  id TEXT PRIMARY KEY,
+  user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+  checked_at TEXT NOT NULL,
+  weight_kg REAL,
+  waist_cm REAL,
+  hip_cm REAL,
+  neck_cm REAL,
+  chest_cm REAL,
+  arm_cm REAL,
+  thigh_cm REAL,
+  body_fat_percent REAL,
+  clothing_fit_score INTEGER,
+  notes TEXT NOT NULL DEFAULT '',
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_nutrition_body_checkins_user_time
+  ON nutrition_body_checkins(user_id, checked_at DESC);
+
+CREATE TABLE IF NOT EXISTS nutrition_appearance_checkins (
+  id TEXT PRIMARY KEY,
+  user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+  checked_at TEXT NOT NULL,
+  photo_refs_json TEXT NOT NULL DEFAULT '[]',
+  face_puffiness INTEGER,
+  leanness INTEGER,
+  muscularity INTEGER,
+  posture INTEGER,
+  bloating_look INTEGER,
+  confidence_score INTEGER,
+  notes TEXT NOT NULL DEFAULT '',
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_nutrition_appearance_checkins_user_time
+  ON nutrition_appearance_checkins(user_id, checked_at DESC);
+
+CREATE TABLE IF NOT EXISTS nutrition_subjective_checkins (
+  id TEXT PRIMARY KEY,
+  user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+  checked_at TEXT NOT NULL,
+  meal_log_id TEXT REFERENCES nutrition_food_logs(id) ON DELETE SET NULL,
+  time_relation TEXT NOT NULL DEFAULT 'unspecified',
+  hunger INTEGER,
+  fullness INTEGER,
+  cravings INTEGER,
+  mood INTEGER,
+  energy INTEGER,
+  focus INTEGER,
+  stress INTEGER,
+  sleepiness INTEGER,
+  crash_score INTEGER,
+  notes TEXT NOT NULL DEFAULT '',
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_nutrition_subjective_checkins_user_time
+  ON nutrition_subjective_checkins(user_id, checked_at DESC);
+
+CREATE TABLE IF NOT EXISTS nutrition_gut_checkins (
+  id TEXT PRIMARY KEY,
+  user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+  checked_at TEXT NOT NULL,
+  meal_log_id TEXT REFERENCES nutrition_food_logs(id) ON DELETE SET NULL,
+  bristol_stool_type INTEGER,
+  stool_frequency INTEGER,
+  bloating INTEGER,
+  gas INTEGER,
+  reflux INTEGER,
+  abdominal_pain INTEGER,
+  urgency INTEGER,
+  nausea INTEGER,
+  constipation INTEGER,
+  diarrhea INTEGER,
+  trigger_tags_json TEXT NOT NULL DEFAULT '[]',
+  notes TEXT NOT NULL DEFAULT '',
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_nutrition_gut_checkins_user_time
+  ON nutrition_gut_checkins(user_id, checked_at DESC);
+
+CREATE TABLE IF NOT EXISTS nutrition_hypotheses (
+  id TEXT PRIMARY KEY,
+  user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+  title TEXT NOT NULL,
+  summary TEXT NOT NULL DEFAULT '',
+  status TEXT NOT NULL DEFAULT 'candidate',
+  confidence REAL NOT NULL DEFAULT 0.25,
+  evidence_count INTEGER NOT NULL DEFAULT 0,
+  signal_key TEXT NOT NULL DEFAULT '',
+  outcome_key TEXT NOT NULL DEFAULT '',
+  lag_window TEXT NOT NULL DEFAULT '',
+  evidence_json TEXT NOT NULL DEFAULT '{}',
+  confounders_json TEXT NOT NULL DEFAULT '[]',
+  suggested_action TEXT NOT NULL DEFAULT '',
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_nutrition_hypotheses_user_status
+  ON nutrition_hypotheses(user_id, status, updated_at DESC);
+
+CREATE TABLE IF NOT EXISTS nutrition_experiments (
+  id TEXT PRIMARY KEY,
+  user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+  hypothesis_id TEXT REFERENCES nutrition_hypotheses(id) ON DELETE SET NULL,
+  title TEXT NOT NULL,
+  status TEXT NOT NULL DEFAULT 'planned',
+  baseline_start TEXT,
+  baseline_end TEXT,
+  intervention_start TEXT,
+  intervention_end TEXT,
+  tracked_outcomes_json TEXT NOT NULL DEFAULT '[]',
+  protocol_json TEXT NOT NULL DEFAULT '{}',
+  adherence_json TEXT NOT NULL DEFAULT '{}',
+  result_summary TEXT NOT NULL DEFAULT '',
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_nutrition_experiments_user_status
+  ON nutrition_experiments(user_id, status, updated_at DESC);

package/server/migrations/066_watch_action_receipts.sql

@@ -0,0 +1,20 @@
+CREATE TABLE IF NOT EXISTS watch_action_receipts (
+  id TEXT PRIMARY KEY,
+  pairing_session_id TEXT REFERENCES companion_pairing_sessions(id) ON DELETE SET NULL,
+  user_id TEXT NOT NULL REFERENCES users(id) ON DELETE CASCADE,
+  action_id TEXT NOT NULL,
+  kind TEXT NOT NULL,
+  received_at TEXT NOT NULL,
+  processed_at TEXT NOT NULL,
+  status TEXT NOT NULL,
+  result_json TEXT NOT NULL DEFAULT '{}',
+  error_json TEXT NOT NULL DEFAULT '{}',
+  created_at TEXT NOT NULL,
+  UNIQUE (user_id, action_id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_watch_action_receipts_user_processed
+  ON watch_action_receipts(user_id, processed_at DESC);
+
+CREATE INDEX IF NOT EXISTS idx_watch_action_receipts_kind
+  ON watch_action_receipts(user_id, kind, processed_at DESC);

package/skills/forge-openclaw/SKILL.md

@@ -199,8 +199,17 @@ Wiki navigation and search rule:
 Health rule:
 
 - Sleep and sports records are first-class health surfaces, not generic notes or tasks.
-- Use `forge_get_sleep_overview`, `forge_get_sports_overview`, and
-  `forge_get_training_load_overview` for health review and trend reading.
+- Use `forge_get_sleep_overview`, `forge_get_sports_overview`,
+  `forge_get_training_load_overview`, and `forge_get_weight_loss_overview`
+  for health review and trend reading.
+- Use the dedicated nutrition tools for food/body work: `forge_search_foods`, `forge_search_nutrition_foods`,
+  `forge_lookup_nutrition_barcode`, `forge_log_food`,
+  `forge_parse_food_log_with_chatgpt`, `forge_log_body_checkin`,
+  `forge_log_appearance_checkin`, `forge_log_subjective_food_effect`,
+  `forge_log_gut_checkin`, `forge_get_nutrition_patterns`,
+  `forge_start_nutrition_experiment`, and `forge_update_nutrition_experiment`.
+  `forge_parse_food_log_with_chatgpt` must use Forge's configured `openai-codex`
+  ChatGPT subscription connection, not a metered OpenAI Platform API path.
 - In `forge_get_agent_onboarding.entityRouteModel.readModelOnlySurfaces`, operator,
   calendar, self-observation, sleep, sports, and training-load read models are published with
   both camelCase names and entity-style aliases where useful, including
@@ -227,6 +236,14 @@ Entity conversation rule:
 - Prefer a progression of:
   concrete example or intent -> working name -> purpose or meaning -> placement in Forge -> operational details -> linked context.
 - Use those same playbooks for action-heavy non-Psyche flows such as `work_adjustment`, `preference_judgment`, `preference_signal`, and specialized `movement`, `life_force`, or `workbench` requests so the conversation starts from what the user is trying to understand, change, add, update, link, or run before you choose the route.
+- When one message combines several jobs, sequence them instead of turning them into
+  a broad menu: read before a correction when the current truth is uncertain,
+  formulate the primary Psyche record before deriving a flashcard or note, and ask
+  only for the missing span, wording, flow, run, node, weekday, or link that changes
+  the next action.
+- Before deleting, archiving, invalidating, disconnecting, or replacing a record, confirm
+  the exact target and what should remain understandable; for Psyche records, preserve
+  therapeutic history unless the user clearly wants removal.
 - When the operation is not already explicit, identify the job first:
   add, update, review, compare, navigate, link, or run. Skip that meta question
   when the action is already obvious from the user's wording.
@@ -515,7 +532,7 @@ Use these rules when choosing tools.
 
 Read first with `forge_get_operator_overview`, `forge_get_operator_context`, or `forge_get_current_work` unless the user is clearly asking for one exact known record or one exact write.
 
-Before creating or updating an ambiguous stored entity, use `forge_search_entities` to check for duplicates.
+Before creating or updating an ambiguous stored entity, use `forge_search_entities` to check for duplicates. If a likely match appears, ask whether the user wants to update that record, link to it, or save a separate new record; do not reopen the whole create flow.
 
 Use the batch entity tools for stored records:
 `forge_search_entities`, `forge_create_entities`, `forge_update_entities`, `forge_delete_entities`, `forge_restore_entities`
@@ -526,8 +543,8 @@ These tools operate on:
 Use the wiki tools for SQLite-backed memory work:
 `forge_get_wiki_settings`, `forge_list_wiki_pages`, `forge_get_wiki_page`, `forge_search_wiki`, `forge_upsert_wiki_page`, `forge_get_wiki_health`, `forge_sync_wiki_vault`, `forge_reindex_wiki_embeddings`, `forge_ingest_wiki_source`
 
-Use the health tools for review and reflective enrichment, not as the default CRUD architecture:
-`forge_get_sleep_overview`, `forge_get_sports_overview`, `forge_get_training_load_overview`, `forge_update_sleep_session`, `forge_update_workout_session`
+Use the health tools for review, reflective enrichment, and nutrition evidence capture:
+`forge_get_sleep_overview`, `forge_get_sports_overview`, `forge_get_training_load_overview`, `forge_get_weight_loss_overview`, `forge_update_sleep_session`, `forge_update_workout_session`, `forge_search_foods`, `forge_search_nutrition_foods`, `forge_lookup_nutrition_barcode`, `forge_log_food`, `forge_parse_food_log_with_chatgpt`, `forge_log_body_checkin`, `forge_log_appearance_checkin`, `forge_log_subjective_food_effect`, `forge_log_gut_checkin`, `forge_get_nutrition_patterns`, `forge_start_nutrition_experiment`, `forge_update_nutrition_experiment`
 
 Use the dedicated domain routes for specialized surfaces that are not simple batch entities:
 
@@ -683,6 +700,10 @@ Use the health tools when the request is about sleep or sports review:
 - `forge_get_sleep_overview` to inspect recent nights, averages, regularity, stage breakdown, and linked reflective context
 - `forge_get_sports_overview` to inspect training volume, workout types, effort trends, habit-generated sessions, and linked context
 - `forge_get_training_load_overview` to inspect cardiovascular load, HR zone balance, zone-time buckets, smart training modes, acute/chronic stress, high-intensity pressure, VO2max context, next-workout guidance, and training target fit
+- `forge_get_weight_loss_overview` to inspect calorie balance, protein/fiber targets, body trend, food quality, training fuel, subjective energy, gut comfort, aesthetic look, hypotheses, and experiments
+- `forge_parse_food_log_with_chatgpt` to convert rough meal text or a photo description into a candidate food log through the configured `openai-codex` ChatGPT subscription connection
+- `forge_log_food`, `forge_log_body_checkin`, `forge_log_appearance_checkin`, `forge_log_subjective_food_effect`, and `forge_log_gut_checkin` to preserve the user's food, body-composition, visual-look, energy/craving/performance, and gut-health evidence
+- `forge_get_nutrition_patterns`, `forge_start_nutrition_experiment`, and `forge_update_nutrition_experiment` to turn repeated food/body observations into testable N-of-1 hypotheses
 - `forge_update_sleep_session` to add sleep-quality notes, tags, or links back to Forge entities after review
 - `forge_update_workout_session` to add subjective effort, mood, meaning, tags, or links on one workout after review
 - remember that the UI route is `/sports` while the backend overview route is `/api/v1/health/fitness`; the dedicated training-load UI is `/training-load` and its backend route is `/api/v1/health/training-load`, including zone-time reporting and Combat/Base/Endurance smart modes