cobb/cauldron
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Mealie-backed AI meal planner + shopping list for the family
49 commits 1 branch 0 tags 524 KiB
Find a file
Kayos 1445e0cbab enrich v5: more agent context — cooking, kid-fit, expanded macros, occasion, 
hecate's quip + macro confidence + chain-of-thought macro estimation

Eight new fields packed in before Cobb's force re-enrich rerun:

(1) active_minutes + hands_off_minutes — split estimated_minutes into
    "you must be present" vs "rise/marinade/braise unattended". Lets
    weeknight planning match real available active time. A 4-hour beef
    stew might be 30 active + 210 hands-off — fine for Sunday but
    misleading as "240 minutes" on a busy weeknight.

(2) equipment[] — required appliances/modes from a fixed enum:
    oven, stovetop, grill, instant-pot, slow-cooker, sheet-pan,
    cast-iron, air-fryer, food-processor, blender, mixer, smoker,
    sous-vide, no-cook. Foundation for "no oven this week" filters.

(3) flavor_profile[] — 2-5 dominant flavor notes (spicy, sweet,
    savory, umami, tangy, smoky, herby, citrusy, rich, fresh, bitter,
    earthy). Lets the planner enforce variety so we don't get five
    spicy nights in a row.

(4) kid_friendly_score 1-5 — separate from comfort_tier. Cobb has
    Leia and Luna; this is real signal. 1=adults-only (capers, blue
    cheese, super spicy), 5=kids beg for it (mac and cheese, pancakes).

(5) fiber_g + sodium_mg per serving — extends the macro coverage.
    Sodium for heart-health weeks, fiber for gut weeks.

(6) cost_per_serving_estimate — rough USD per serving (2026 prices).
    Bean bowl $2, salmon for two $8-12, fancy roast $15+. Foundation
    for budget-week preference. Set null for too-volatile items.

(7) occasion_fit[] — when is this dish AT HOME? weeknight, weekend,
    brunch, date-night, party, picnic, camping, holiday, game-day,
    kids-birthday, quiet-night-in.

(8) hecate_quip — one-line voice description in Hecate's mythic-witch
    tone. Pure flavor for tooltips/detail pages. ~10-20 words. Examples:
    "Pure midwinter comfort — asks for a fire and quiet."
    "Sharp and bright like a Tuesday morning resolution."

MACRO QUALITY (Cobb's separate ask):
- Prompt now instructs Sonnet to compute macros chain-of-thought:
  list each major ingredient, approximate its per-serving contribution
  in grams, sum, output. Plus a sanity check: protein×4 + carbs×4 +
  fat×9 ≈ calories. Not free precision but better than guess-the-total.
- New macros_confidence field (low/medium/high) — Sonnet rates own
  certainty so users know when to trust the numbers and the planner
  can avoid summing low-confidence macros over a 7-day budget.
- Future commit: deterministic USDA-FDC backfill into cauldron_food_
  metadata for true ingredient-by-ingredient sums. Same shape as the
  existing density backfill we did in Step 2.

Plan generator pool prompt expanded — every recipe entry now carries
inline:
  active=Nm+offhand=Mm
  eq:oven,stovetop
  flavor:savory/herby/rich
  kid=4
  ~$5/svg
  for:weeknight/date-night
  fiber=Ng / sodium=Nmg

ENRICH_VERSION 4→5. Cobb's force re-enrich gets all of these on the
existing 222 recipes in one walk.
2026-04-30 22:12:29 -07:00
cauldron enrich v5: more agent context — cooking, kid-fit, expanded macros, occasion, 2026-04-30 22:12:29 -07:00
scripts v0.3 step 5: lean shopping list — claude on-demand foods + game strip 2026-04-29 22:02:20 -07:00
tests v0.3 step 3+4: AI plan generator + /list shopping aggregation 2026-04-29 06:26:54 -07:00
.env.example v0.2 foundation — Authentik OIDC + sulkta-mariadb DB + Fernet crypto 2026-04-28 19:47:47 -07:00
.gitignore v0.1 — backend bones + ingredient sterilizer 2026-04-28 16:59:11 -07:00
compose.yml compose: also join sulkta-db-net so cauldron can reach sulkta-mariadb 2026-04-28 19:48:59 -07:00
Dockerfile v0.1 — backend bones + ingredient sterilizer 2026-04-28 16:59:11 -07:00
LICENSE Initial commit 2026-04-28 16:35:30 -07:00
README.md v0.1 — backend bones + ingredient sterilizer 2026-04-28 16:59:11 -07:00
requirements.txt search: local fuzzy recipe index — way smarter than Mealie's lexical default 2026-04-28 21:37:12 -07:00

README.md

cauldron

Mealie-backed AI meal planner + shopping list for the family. LAN-only, internal tool. Mealie at recipes.sulkta.com is the source of truth for recipes / meal plans / shopping lists; cauldron is the AI layer + Abby's branded UI on top.

Status

v0.1 — backend bones (current). Ingredient sterilizer endpoint working. No UI yet; bearer-auth API only. Frontend + Authentik OIDC arrives in v0.2. Native Kotlin Android in v0.5.

Surface (v0.1)

GET  /healthz                              liveness + clawdforge upstream
GET  /api/recipes                          list Mealie recipes (paginated)
POST /api/sterilize/preview/<slug>         dry-run AI parse, return proposals
POST /api/sterilize/apply/<slug>           write parses back to Mealie

All routes except /healthz require Authorization: Bearer <ADMIN_BEARER>.

Architecture

Abby's phone (later: Kotlin app)
        │
        ▼
  cauldron (Flask, port 7790, LAN-only)
   ├─ Mealie API client  ─── recipes.sulkta.com  (source of truth)
   ├─ clawdforge client  ─── 192.168.0.5:8800   (claude -p runner)
   └─ Authentik OIDC (v0.2)

cauldron does NOT hold its own database in v0.1 — all state lives in Mealie. A small Postgres/MariaDB schema lands in v0.2 for Abby-specific prefs + chat history.

Ingredient sterilizer

Mealie's CRF parser is mediocre. Cobb's hand-typed recipes have lots of free-form quantity strings ("about 2 cups cooked white rice", "1 small handful kale", "a pinch of salt") that don't aggregate cleanly into a shopping list.

The sterilizer batches all ingredients of one recipe into a single Sonnet call (via clawdforge), gets back parallel structured parses, then on apply links each parse to existing Mealie food/unit records (creating any missing by name) and PUTs the recipe back.

Preview is non-destructive — review proposals before apply.

# Dry-run preview
curl -sS -X POST -H "Authorization: Bearer $ADMIN_BEARER" \
  http://192.168.0.5:7790/api/sterilize/preview/spaghetti-bolognese | jq .

# Apply (creates missing foods/units by default)
curl -sS -X POST -H "Authorization: Bearer $ADMIN_BEARER" \
  http://192.168.0.5:7790/api/sterilize/apply/spaghetti-bolognese | jq .

Deploy

  1. ssh lucy
  2. cd /mnt/user/appdata && git clone <gitea-url> cauldron && cd cauldron/build (or wherever the deploy convention lands)
  3. Drop .env at /mnt/cache/appdata/secrets/cauldron.env (chmod 600 root:root)
    • CLAWDFORGE_TOKEN is already populated by the bootstrap (see memory/2026-04-28.md)
    • MEALIE_API_TOKEN — mint at recipes.sulkta.com → user → API tokens
    • ADMIN_BEARER — pick 32 bytes of entropy
    • SECRET_KEY — 32 bytes for Flask sessions
  4. docker compose up -d --build
  5. Smoke: curl http://192.168.0.5:7790/healthz

Roadmap

  • v0.1 ✓ — sterilizer backend + Flask shell
  • v0.2 — Authentik OIDC, Abby-branded web UI, palette CSS, postgres for prefs
  • v0.3 — meal plan generator (week → Mealie meal plan write)
  • v0.4 — shopping list aggregator (read meal plan → consolidated grocery list)
  • v0.5 — native Kotlin + Compose Android app (read-only shopping list + plan view)

Repo layout

cauldron/
├─ cauldron/
│  ├─ config.py            env-driven config
│  ├─ forge.py             clawdforge HTTP client
│  ├─ mealie.py            Mealie API client
│  ├─ sterilizer.py        ingredient parse + apply pipeline
│  └─ server.py            Flask app
├─ Dockerfile
├─ compose.yml
├─ requirements.txt
└─ .env.example