@fullwell/fullwell 1.1.11 → 1.1.13

package/runtime/local-household-mcp.mjs

@@ -8,11 +8,24 @@ import {
   activeCodexHome,
   runRequest,
 } from "./local-household.mjs";
+import { loadLocalProfile, updateLocalProfile } from "./local-profile.mjs";
+import { createLocalRecipeBoard } from "./local-recipe-board.mjs";
+import { stopLocalWhatsAppRunner } from "./local-runner-control.mjs";
 
 const SERVER_NAME = "fullwell-local";
 const SERVER_VERSION = "1";
 const MAX_MESSAGE_BYTES = 20 * 1024 * 1024;
-const UPDATE_OPERATIONS = new Set(["initialize", "save", "finalize", "record_cloud_backup"]);
+const UPDATE_OPERATIONS = new Set([
+  "initialize",
+  "save",
+  "rename_household",
+  "finalize",
+  "record_cloud_backup",
+  "save_meal_planning_profile",
+  "review_meal_constraints",
+  "append_meal_proposal",
+  "record_meal_plan_event",
+]);
 
 const emptyObjectSchema = {
   type: "object",
@@ -24,15 +37,195 @@ const revisionSchema = {
   type: "integer",
   minimum: 1,
 };
+const expectedProfileRevisionSchema = {
+  type: "integer",
+  minimum: 0,
+};
+const localDisplayNameSchema = {
+  type: "string",
+  minLength: 1,
+  maxLength: 108,
+};
+const householdNameSchema = {
+  type: "string",
+  minLength: 1,
+  maxLength: 120,
+};
+
+const nullableStringSchema = { type: ["string", "null"] };
+const localMealSlotSchema = {
+  oneOf: [
+    {
+      type: "object",
+      required: ["kind"],
+      properties: { kind: { type: "string", enum: ["breakfast", "lunch", "dinner", "snack"] } },
+      additionalProperties: false,
+    },
+    {
+      type: "object",
+      required: ["kind", "label"],
+      properties: {
+        kind: { const: "custom" },
+        label: { type: "string", minLength: 1, maxLength: 80 },
+      },
+      additionalProperties: false,
+    },
+  ],
+};
+const localMealSourceSchema = {
+  oneOf: [
+    {
+      type: "object",
+      required: ["kind", "title"],
+      properties: {
+        kind: { const: "freeform" },
+        title: { type: "string", minLength: 1, maxLength: 300 },
+      },
+      additionalProperties: false,
+    },
+    {
+      type: "object",
+      required: ["kind", "item_id", "item_revision", "liked_evidence_ids"],
+      properties: {
+        kind: { const: "journal_recipe" },
+        item_id: { type: "string" },
+        item_revision: { type: "string" },
+        liked_evidence_ids: { type: "array", minItems: 1, maxItems: 100, items: { type: "string" } },
+      },
+      additionalProperties: false,
+    },
+    {
+      type: "object",
+      required: ["kind", "title", "canonical_url", "site_name", "discovered_at"],
+      properties: {
+        kind: { const: "external_recipe" },
+        title: { type: "string", minLength: 1, maxLength: 300 },
+        canonical_url: { type: "string", format: "uri" },
+        site_name: { type: "string", minLength: 1, maxLength: 200 },
+        discovered_at: { type: "string", format: "date-time" },
+      },
+      additionalProperties: false,
+    },
+  ],
+};
+const mealConstraintsSchema = {
+  oneOf: [
+    {
+      type: "object",
+      required: ["status", "time_zone", "reviewed_at"],
+      properties: {
+        status: { const: "confirmed_none" },
+        time_zone: { type: "string" },
+        reviewed_at: { type: "string", format: "date-time" },
+      },
+      additionalProperties: false,
+    },
+    {
+      type: "object",
+      required: ["status", "time_zone", "allergy_labels", "sensitivity_labels", "reviewed_at"],
+      properties: {
+        status: { const: "recorded" },
+        time_zone: { type: "string" },
+        allergy_labels: { type: "array", maxItems: 30, items: { type: "string", minLength: 1, maxLength: 120 } },
+        sensitivity_labels: { type: "array", maxItems: 30, items: { type: "string", minLength: 1, maxLength: 120 } },
+        reviewed_at: { type: "string", format: "date-time" },
+      },
+      additionalProperties: false,
+    },
+  ],
+};
+const idempotencyKeySchema = { type: "string", minLength: 8, maxLength: 128 };
+const actorLabelSchema = { type: "string", minLength: 1, maxLength: 80 };
+const weekStartSchema = { type: "string", format: "date" };
+const withdrawalEventSchema = {
+  type: "object",
+  required: ["kind", "proposal_id", "reason"],
+  properties: {
+    kind: { const: "proposal_withdrawn" },
+    proposal_id: { type: "string" },
+    reason: nullableStringSchema,
+  },
+  additionalProperties: false,
+};
+const updateOperationSchema = (operation, properties = {}) => ({
+  type: "object",
+  required: ["operation", ...Object.keys(properties)],
+  properties: { operation: { const: operation }, ...properties },
+  additionalProperties: false,
+});
+const householdUpdateSchema = {
+  type: "object",
+  oneOf: [
+    {
+      type: "object",
+      required: ["operation"],
+      properties: {
+        operation: { const: "initialize" },
+        household_name: householdNameSchema,
+      },
+      additionalProperties: false,
+    },
+    updateOperationSchema("save", {
+      expected_revision: revisionSchema,
+      journal: { type: "object" },
+    }),
+    updateOperationSchema("rename_household", {
+      expected_revision: revisionSchema,
+      household_name: householdNameSchema,
+    }),
+    updateOperationSchema("finalize", { expected_revision: revisionSchema }),
+    updateOperationSchema("record_cloud_backup", {
+      expected_revision: revisionSchema,
+      user_id: { type: "string" },
+      household_id: { type: "string" },
+      repository_head: { type: "string" },
+    }),
+    updateOperationSchema("save_meal_planning_profile", {
+      expected_revision: revisionSchema,
+      idempotency_key: idempotencyKeySchema,
+      actor_label: actorLabelSchema,
+      constraints: mealConstraintsSchema,
+    }),
+    updateOperationSchema("review_meal_constraints", {
+      expected_revision: revisionSchema,
+      idempotency_key: idempotencyKeySchema,
+      actor_label: actorLabelSchema,
+      week_start: weekStartSchema,
+      constraint_revision: revisionSchema,
+    }),
+    updateOperationSchema("append_meal_proposal", {
+      expected_revision: revisionSchema,
+      idempotency_key: idempotencyKeySchema,
+      actor_label: actorLabelSchema,
+      week_start: weekStartSchema,
+      meal_date: { type: "string", format: "date" },
+      slot: localMealSlotSchema,
+      source: localMealSourceSchema,
+      servings: { type: ["integer", "null"], minimum: 1, maximum: 100 },
+      notes: nullableStringSchema,
+      constraint_revision: revisionSchema,
+      constraint_review_event_id: { type: "string" },
+      compatibility: { type: "string", enum: ["appears_compatible", "incomplete_evidence", "needs_recheck"] },
+      compatibility_caveat: { type: "string", minLength: 1, maxLength: 1_000 },
+    }),
+    updateOperationSchema("record_meal_plan_event", {
+      expected_revision: revisionSchema,
+      idempotency_key: idempotencyKeySchema,
+      actor_label: actorLabelSchema,
+      week_start: weekStartSchema,
+      event: withdrawalEventSchema,
+    }),
+  ],
+};
 
 const localTools = [
   {
-    name: "fullwell_local_household_load",
-    title: "Load Fullwell's private local household journal",
-    description: "Loads the bounded local Fullwell guest household from the active Codex home without contacting Fullwell's cloud service.",
+    name: "fullwell_local_profile_load",
+    title: "Load Fullwell's private local member profile",
+    description: "Loads the remembered local member display name and its deterministic first-household name without contacting Fullwell's cloud service.",
     inputSchema: emptyObjectSchema,
     annotations: {
-      title: "Load local Fullwell household",
+      title: "Load local Fullwell member profile",
       readOnlyHint: true,
       destructiveHint: false,
       idempotentHint: true,
@@ -40,25 +233,44 @@ const localTools = [
     },
   },
   {
-    name: "fullwell_local_household_update",
-    title: "Update Fullwell's private local household journal",
-    description: "Initializes, revision-checks, saves, finalizes, or records cloud linkage for the bounded local Fullwell guest household.",
+    name: "fullwell_local_profile_update",
+    title: "Update Fullwell's private local member profile",
+    description: "Creates or revision-checks the remembered local member display name without changing household authority or contacting Fullwell's cloud service.",
     inputSchema: {
       type: "object",
-      required: ["operation"],
+      required: ["expected_revision", "display_name"],
       properties: {
-        operation: {
-          type: "string",
-          enum: ["initialize", "save", "finalize", "record_cloud_backup"],
-        },
-        expected_revision: revisionSchema,
-        journal: { type: "object" },
-        user_id: { type: "string" },
-        household_id: { type: "string" },
-        repository_head: { type: "string" },
+        expected_revision: expectedProfileRevisionSchema,
+        display_name: localDisplayNameSchema,
       },
       additionalProperties: false,
     },
+    annotations: {
+      title: "Update local Fullwell member profile",
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: false,
+    },
+  },
+  {
+    name: "fullwell_local_household_load",
+    title: "Load Fullwell's private local household journal",
+    description: "Loads the bounded local Fullwell guest household from the active Codex home without contacting Fullwell's cloud service.",
+    inputSchema: emptyObjectSchema,
+    annotations: {
+      title: "Load local Fullwell household",
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: false,
+    },
+  },
+  {
+    name: "fullwell_local_household_update",
+    title: "Update Fullwell's private local household journal",
+    description: "Initializes, revision-checks, saves, finalizes, records cloud linkage, or appends validated meal-planning state for the bounded local Fullwell guest household.",
+    inputSchema: householdUpdateSchema,
     annotations: {
       title: "Update local Fullwell household",
       readOnlyHint: false,
@@ -85,6 +297,81 @@ const localTools = [
       openWorldHint: false,
     },
   },
+  {
+    name: "fullwell_local_recipe_board_create",
+    title: "Create a private local Fullwell recipe board",
+    description: "Creates one bounded static recipe-board snapshot beneath Fullwell's private local directory without searching, fetching images, opening a browser, or changing a journal.",
+    inputSchema: {
+      type: "object",
+      required: ["idempotency_key", "title", "context_label", "cards"],
+      properties: {
+        idempotency_key: { type: "string", minLength: 8, maxLength: 128 },
+        title: { type: "string", minLength: 1, maxLength: 300 },
+        context_label: nullableStringSchema,
+        cards: {
+          type: "array",
+          minItems: 1,
+          maxItems: 48,
+          items: {
+            type: "object",
+            required: [
+              "id",
+              "title",
+              "image_url",
+              "image_page_url",
+              "recipe_url",
+              "source_label",
+              "why_recommended",
+              "journal_statuses",
+              "proposed_slot",
+              "compatibility",
+              "compatibility_caveat",
+            ],
+            properties: {
+              id: { type: "string", minLength: 1, maxLength: 120 },
+              title: { type: "string", minLength: 1, maxLength: 300 },
+              image_url: nullableStringSchema,
+              image_page_url: nullableStringSchema,
+              recipe_url: nullableStringSchema,
+              source_label: { type: "string", minLength: 1, maxLength: 200 },
+              why_recommended: { type: "string", minLength: 1, maxLength: 1_000 },
+              journal_statuses: {
+                type: "array",
+                maxItems: 3,
+                uniqueItems: true,
+                items: { type: "string", enum: ["Saved", "Cooked", "Liked"] },
+              },
+              proposed_slot: nullableStringSchema,
+              compatibility: { type: "string", enum: ["appears_compatible", "incomplete_evidence", "needs_recheck"] },
+              compatibility_caveat: { type: "string", minLength: 1, maxLength: 1_000 },
+            },
+            additionalProperties: false,
+          },
+        },
+      },
+      additionalProperties: false,
+    },
+    annotations: {
+      title: "Create private recipe board",
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: false,
+    },
+  },
+  {
+    name: "fullwell_local_whatsapp_runner_stop",
+    title: "Stop the local Fullwell WhatsApp runner",
+    description: "Stops and removes only the macOS Fullwell runner LaunchAgent while preserving its cloud connection, Keychain credentials, snapshots, receipts, and local journal.",
+    inputSchema: emptyObjectSchema,
+    annotations: {
+      title: "Stop local Fullwell WhatsApp runner",
+      readOnlyHint: false,
+      destructiveHint: true,
+      idempotentHint: true,
+      openWorldHint: false,
+    },
+  },
 ];
 
 function jsonRpcResult(id, result) {
@@ -133,8 +420,15 @@ function assertEmptyArguments(value) {
   }
 }
 
-async function callLocalTool(root, name, input) {
+async function callLocalTool(root, name, input, controls) {
   try {
+    if (name === "fullwell_local_profile_load") {
+      assertEmptyArguments(input);
+      return toolResult(await loadLocalProfile(root));
+    }
+    if (name === "fullwell_local_profile_update") {
+      return toolResult(await updateLocalProfile(root, assertPlainObject(input, "arguments")));
+    }
     if (name === "fullwell_local_household_load") {
       assertEmptyArguments(input);
       return toolResult(await runRequest(root, { operation: "load" }));
@@ -150,6 +444,13 @@ async function callLocalTool(root, name, input) {
       const args = assertPlainObject(input, "arguments");
       return toolResult(await runRequest(root, { ...args, operation: "delete_collecting" }));
     }
+    if (name === "fullwell_local_recipe_board_create") {
+      return toolResult(await createLocalRecipeBoard(root, assertPlainObject(input, "arguments")));
+    }
+    if (name === "fullwell_local_whatsapp_runner_stop") {
+      assertEmptyArguments(input);
+      return toolResult(await controls.stopRunner());
+    }
     return null;
   } catch (error) {
     return toolError(error);
@@ -162,7 +463,11 @@ async function callLocalTool(root, name, input) {
  * Domain validation remains in `local-household.mjs`, so the stdio adapter
  * cannot drift from the file, revision, size, or prohibited-data boundary.
  */
-export async function handleLocalHouseholdMcpMessage(root, message) {
+export async function handleLocalHouseholdMcpMessage(
+  root,
+  message,
+  controls = { stopRunner: stopLocalWhatsAppRunner },
+) {
   if (message === null || typeof message !== "object" || Array.isArray(message) || message.jsonrpc !== "2.0") {
     return jsonRpcError(null, -32600, "Invalid Request");
   }
@@ -183,7 +488,7 @@ export async function handleLocalHouseholdMcpMessage(root, message) {
   if (message.method === "tools/call") {
     const name = message.params?.name;
     if (typeof name !== "string") return jsonRpcError(id, -32602, "Invalid params");
-    const result = await callLocalTool(root, name, message.params?.arguments ?? {});
+    const result = await callLocalTool(root, name, message.params?.arguments ?? {}, controls);
     return result === null
       ? jsonRpcError(id, -32602, `Unknown local Fullwell tool: ${name}`)
       : jsonRpcResult(id, result);