pantrybase 0.0.0-stage → 0.2.0

package/seed/vocabulary.yaml

@@ -0,0 +1,277 @@
+# Tag vocabulary. Copied to ./pantrybase/vocabulary.yaml on first use; edit that copy.
+#
+# mode: closed  — only listed values are kept; unknown tags move to `other` (allergens are kept but flagged)
+# mode: open    — new values are accepted and reported so the vocabulary can grow
+# synonyms map card wording to one value; parent builds a hierarchy (filtering on a parent matches children).
+# Values are kebab-case. Matching ignores case, accents and punctuation.
+
+diet:
+  mode: closed
+  values:
+    vegetarian: {synonyms: [veggie, veg, meat-free, meatless]}
+    vegan: {synonyms: [plant-based, plant based]}
+    vegan-adaptable: {synonyms: [vegan-option, can-be-vegan]}
+    pescatarian: {}
+    gluten-free: {synonyms: [gf]}
+    dairy-free: {synonyms: [df, lactose-free]}
+    low-carb: {synonyms: [carb-conscious, keto]}
+    high-protein: {synonyms: [protein-packed]}
+    low-calorie: {synonyms: [calorie-conscious, lean, light]}
+    halal: {}
+    family-friendly: {synonyms: [kid-friendly, family]}
+
+protein:
+  mode: open
+  values:
+    chicken: {}
+    beef: {}
+    pork: {}
+    lamb: {}
+    turkey: {}
+    duck: {}
+    venison: {synonyms: [game]}
+    fish: {}
+    salmon: {parent: fish}
+    white-fish: {parent: fish, synonyms: [hake, cod, haddock]}
+    tuna: {parent: fish}
+    seafood: {}
+    prawns: {parent: seafood, synonyms: [shrimp]}
+    egg: {synonyms: [eggs]}
+    cheese: {synonyms: [halloumi, paneer]}
+    tofu: {}
+    tempeh: {}
+    legumes: {synonyms: [beans, pulses]}
+    chickpeas: {parent: legumes, synonyms: [chickpea]}
+    lentils: {parent: legumes, synonyms: [lentil]}
+    plant-based-meat: {synonyms: [meat-alternative, plant-based-nuggets, mock-meat]}
+    falafel: {parent: legumes}
+
+starch:
+  mode: open
+  values:
+    rice: {}
+    pasta: {}
+    noodles: {}
+    potato: {synonyms: [potatoes]}
+    sweet-potato: {}
+    bread: {synonyms: [flatbread, naan, pita, sourdough]}
+    couscous: {}
+    grains: {synonyms: [quinoa, bulgur, barley, farro]}
+    polenta: {}
+    tortilla: {synonyms: [wraps]}
+    gnocchi: {}
+    none: {synonyms: [no-starch, carb-free]}
+
+flavor:
+  mode: open
+  values:
+    spicy: {synonyms: [hot, chilli, fiery]}
+    mild: {}
+    smoky: {}
+    sweet: {}
+    savoury: {synonyms: [savory]}
+    umami: {}
+    tangy: {synonyms: [sour]}
+    zesty: {synonyms: [citrusy, lemony]}
+    fresh: {}
+    herby: {synonyms: [herbaceous]}
+    garlicky: {}
+    rich: {}
+    creamy: {}
+    cheesy: {}
+    fragrant: {synonyms: [aromatic]}
+    earthy: {}
+    nutty: {}
+    peppery: {}
+    sweet-and-sour: {}
+
+texture:
+  mode: open
+  values:
+    crispy: {synonyms: [crisp]}
+    crunchy: {}
+    creamy: {}
+    silky: {synonyms: [smooth]}
+    saucy: {}
+    chewy: {}
+    tender: {}
+    hearty: {synonyms: [chunky]}
+
+cuisine:
+  mode: open
+  values:
+    asian: {}
+    east-asian: {parent: asian}
+    chinese: {parent: east-asian}
+    japanese: {parent: east-asian}
+    korean: {parent: east-asian}
+    southeast-asian: {parent: asian, synonyms: [south-east-asian]}
+    thai: {parent: southeast-asian}
+    vietnamese: {parent: southeast-asian}
+    indonesian: {parent: southeast-asian}
+    malaysian: {parent: southeast-asian}
+    south-asian: {parent: asian}
+    indian: {parent: south-asian}
+    sri-lankan: {parent: south-asian}
+    middle-eastern: {synonyms: [levantine]}
+    lebanese: {parent: middle-eastern}
+    turkish: {parent: middle-eastern}
+    persian: {parent: middle-eastern}
+    israeli: {parent: middle-eastern}
+    african: {}
+    north-african: {parent: african}
+    moroccan: {parent: north-african}
+    south-african: {parent: african, synonyms: [braai]}
+    cape-malay: {parent: south-african}
+    west-african: {parent: african}
+    east-african: {parent: african}
+    european: {}
+    mediterranean: {parent: european}
+    italian: {parent: mediterranean}
+    greek: {parent: mediterranean}
+    spanish: {parent: mediterranean}
+    french: {parent: european}
+    british: {parent: european}
+    german: {parent: european}
+    portuguese: {parent: european}
+    american: {}
+    mexican: {parent: american, synonyms: [tex-mex]}
+    southern-us: {parent: american, synonyms: [cajun, creole]}
+    latin-american: {parent: american}
+    caribbean: {parent: american}
+    fusion: {}
+
+dish:
+  mode: closed
+  values:
+    curry: {synonyms: [dhal, dal, korma, masala]}
+    stew: {synonyms: [tagine, casserole, chilli-con-carne]}
+    soup: {synonyms: [broth, ramen-soup, chowder]}
+    salad: {}
+    bowl: {synonyms: [buddha-bowl, grain-bowl, poke, rice-bowl]}
+    pasta: {synonyms: [spaghetti, tagliatelle, penne, linguine]}
+    pasta-bake: {synonyms: [baked-pasta, lasagne, lasagna, mac-and-cheese]}
+    stuffed-pasta: {synonyms: [ravioli, tortellini, stuffed-shells, cannelloni]}
+    risotto: {}
+    noodles: {synonyms: [stir-fried-noodles, pad-thai, ramen]}
+    stir-fry: {}
+    traybake: {synonyms: [sheet-pan, one-tray, tray-bake]}
+    roast: {}
+    flatbread: {synonyms: [pizza, naan-pizza, flammkuchen]}
+    burger: {}
+    sandwich: {synonyms: [toastie, sub]}
+    wrap: {synonyms: [burrito, shawarma-wrap]}
+    tacos: {synonyms: [taco, quesadilla, fajitas, nachos]}
+    platter: {synonyms: [mezze, mezze-platter, sharing-board, grazing]}
+    pie: {synonyms: [tart, quiche, pot-pie]}
+    fritters: {synonyms: [nuggets, croquettes, patties, falafels]}
+    skewers: {synonyms: [kebab, kebabs, sosaties]}
+    grain-dish: {synonyms: [pilaf, biryani, fried-rice, paella]}
+    steak: {}
+    dessert: {}
+    side: {}
+    other: {}
+
+meal:
+  mode: closed
+  values:
+    breakfast: {synonyms: [brunch]}
+    lunch: {}
+    dinner: {synonyms: [supper, main]}
+    snack: {}
+    dessert: {}
+    side: {}
+
+method:
+  mode: closed
+  values:
+    roast: {synonyms: [oven-roast, roasting]}
+    bake: {synonyms: [baking, oven-bake]}
+    grill: {synonyms: [broil, grilling, char, chargrill]}
+    braai: {synonyms: [barbecue, bbq]}
+    pan-fry: {synonyms: [fry, frying, sear, pan-sear]}
+    shallow-fry: {}
+    deep-fry: {}
+    saute: {synonyms: [sauteed, sweat, soften]}
+    stir-fry: {}
+    air-fry: {synonyms: [air-fryer]}
+    boil: {synonyms: [boiling, blanch]}
+    simmer: {synonyms: [reduce]}
+    steam: {}
+    poach: {}
+    braise: {synonyms: [slow-cook]}
+    toast: {synonyms: [dry-toast, toasting]}
+    blend: {synonyms: [puree, blitz, pulse]}
+    pickle: {synonyms: [quick-pickle]}
+    marinate: {}
+    mash: {synonyms: [crush]}
+    microwave: {}
+    raw: {synonyms: [no-cook, assemble]}
+
+time:
+  mode: closed
+  values:
+    quick: {synonyms: [quick-and-easy, fast, 15-minute, 20-minute, express]}
+    weeknight: {}
+    under-30: {synonyms: [30-minute]}
+    under-45: {}
+    slow: {synonyms: [weekend, low-and-slow]}
+
+season:
+  mode: closed
+  values:
+    spring: {}
+    summer: {synonyms: [hot-weather]}
+    autumn: {synonyms: [fall]}
+    winter: {synonyms: [cold-weather, warming, cosy, comfort]}
+
+other:
+  mode: open
+  values:
+    one-pan: {synonyms: [one-pot, one-pot-wonder]}
+    make-ahead: {synonyms: [meal-prep]}
+    freezer-friendly: {}
+    leftovers-friendly: {}
+    date-night: {synonyms: [special-occasion]}
+
+allergen:
+  mode: closed
+  values:
+    gluten: {}
+    wheat: {}
+    egg: {synonyms: [eggs]}
+    dairy: {synonyms: [cows-milk, cow-s-milk, milk, lactose]}
+    soy: {synonyms: [soya, soybeans]}
+    sesame: {}
+    tree-nuts: {synonyms: [nuts, tree-nut]}
+    peanuts: {synonyms: [peanut, groundnuts]}
+    sulphites: {synonyms: [sulfites, sulphur-dioxide]}
+    allium: {synonyms: [onion, garlic]}
+    fish: {}
+    crustaceans: {synonyms: [shellfish, crustacean]}
+    molluscs: {synonyms: [mollusks]}
+    celery: {}
+    mustard: {}
+    lupin: {}
+
+equipment:
+  mode: open
+  values:
+    oven: {}
+    grill: {synonyms: [oven-grill, broiler]}
+    air-fryer: {}
+    microwave: {}
+    stovetop: {synonyms: [hob]}
+    pan: {synonyms: [frying-pan, large-pan, skillet]}
+    pot: {synonyms: [saucepan]}
+    wok: {}
+    roasting-tray: {synonyms: [baking-tray, tray, sheet-pan, roasting-pan]}
+    ovenproof-dish: {synonyms: [baking-dish, oven-dish, small-ovenproof-dish]}
+    blender: {synonyms: [food-processor, stick-blender]}
+    kettle: {}
+    grater: {}
+    sieve: {synonyms: [colander]}
+    paper-towel: {synonyms: [kitchen-paper, paper-towels]}
+    tongs: {}
+    whisk: {}
+    lid: {}

package/skills/cook/SKILL.md

@@ -0,0 +1,28 @@
+---
+name: cook
+description: Answer "what can I cook?" from the pantrybase recipe collection and the user's pantry, find recipes by ingredient, tag, cuisine, allergen or mood, keep the pantry up to date, and invent new recipes grounded in the collection. Use when the user asks for meal ideas, what to make with what they have, recipes matching criteria, a new recipe in the style of their collection, or to update their pantry.
+---
+
+# Cook from the collection
+
+## Keep the pantry current
+- "I bought…", "I have…", "we're out of…" → `pb_pantry_add {items}` / `pb_pantry_remove {names}`. Names are matched to the catalog (plurals, aliases, regional names), so use the user's words.
+- Don't add staples one by one unless asked; salt, pepper, oil, water and other "from your kitchen" items never count against a recipe anyway.
+
+## What can I cook?
+1. `pb_pantry_match` — add `ingredients` for things the user mentions having right now; pass their constraints as filters (`tags: {diet: [vegetarian]}`, `exclude_allergens: [tree-nuts]`, `max_total_min: 30`).
+2. Lead with full matches, then near misses (`missing` has 1–2 items) — say exactly what's missing, and suggest a swap from the pantry when an obvious one exists.
+3. `pb_get_recipe` only for the recipe the user picks, then give it in a cook-friendly form.
+
+## Find recipes
+- Free text, mood or occasion ("something cosy and quick", "fresh summer lunch") → `pb_search {query}`; it's hybrid keyword + semantic.
+- Criteria → `pb_search` with `tags` (assigned: cuisine, diet, dish, protein, starch, flavor, texture, method, meal, time, season; derived: allergen, equipment, technique, chef, provider, plan). Parents expand: `cuisine: [asian]` includes thai and korean.
+- `pb_list_tags` shows which values exist.
+
+## Invent a new recipe
+1. `pb_synthesis_context` with a `query` for what the user wants, `use_pantry: true` if it should use what they have, and any filters. Read the source recipes, shared ingredients, pairings and techniques.
+2. Write a genuinely new recipe: combine techniques and flavour patterns from the sources, prefer pantry ingredients, keep quantities realistic for the servings, and respect any diet or allergen constraints.
+3. Show it to the user. If they want to keep it, save it with `pb_save_recipe`: `source: {kind: "synthesized"}`, `derived_from` = only the slugs you actually drew on, no `provider`, structured ingredients (`source: "kitchen"` for pantry items) and steps (`techniques`, `uses`), tags, and a `blurb`. It then shows up in search and the graph, linked to its sources.
+
+## Tidy the catalog
+- After saving, `new_ingredients` lists names the catalog didn't know. If one is really an existing ingredient under another name, `pb_merge_ingredients {from, into}` fixes every recipe and remembers the alias.

package/skills/ingest/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: ingest
+description: Capture recipe card photos into the pantrybase knowledge base — import a folder of photos, read each card (front and back), extract the full structured recipe with tags, nutrition and allergens, and save it. Use when the user wants to add, scan, import or process recipe cards or photos, or asks to continue or check progress on ingestion.
+---
+
+# Ingest recipe cards
+
+You turn photos in `pantrybase/inbox/` into recipes. The queue is on disk, so ingestion can stop at any point and resume later, even in a new session — just start again from step 2.
+
+## 1. Get the photos in (if they aren't already)
+
+- If the user names a folder or files: `pb_ingest_source {paths: [...]}`. Originals are copied, never moved; photos already known are skipped.
+- Photos dropped straight into `pantrybase/inbox/`, or uploaded in the web UI, are picked up automatically.
+
+## 2. Prepare once per session
+
+1. `pb_inbox_next {window: 4}` — look at `progress` to see how much is left. If `done: true`, report and stop.
+2. Look at the first photo with `pb_inbox_image {id}` and identify the provider from the logo/footer. Then `pb_providers {id: "<provider>"}` (or `"generic"`) and follow that guide for every card. Read it once, not per card.
+3. `pb_list_tags {vocabulary: true}` once, so you reuse existing tag values instead of inventing near-duplicates.
+
+## 3. Loop, one card at a time
+
+1. `pb_inbox_next {window: 4}` gives the next photos in capture order.
+2. If a photo has a `rotation_hint`, or shows up sideways or upside down, turn it upright first with `pb_inbox_rotate {id, degrees}` (clockwise: text reading bottom-to-top → 90, upside down → 180, top-to-bottom → 270) and view it again. Never transcribe a sideways photo.
+3. View them in order with `pb_inbox_image`. Group the photos that belong to one card: usually a front (title, photo) followed by its back (ingredients, steps, nutrition — no title). Match a back to its front by order and by ingredients that echo the front's subtitle and description.
+   - `retake_of` means a near-identical photo of the same side: use the clearer one as the main image and attach the other with the same side, or skip it.
+   - If small print is unreadable, request `pb_inbox_image {id, max_px: 2400}` before giving up on a field.
+4. Extract everything the guide asks for and call `pb_save_recipe` with `provider`, `source: {kind: "card"}`, the full structured record, your own `blurb`, and `ingest: [{id, side}]` listing **every** photo of the card.
+5. Handle the response:
+   - `saved: true` — note the slug and move on. Glance at `vocabulary.rejected` and `unmatched_uses`; fix only clear mistakes (re-save with `slug`).
+   - `duplicate_of` — compare with that recipe (`pb_get_recipe`). Same card → attach the photos to it (`pb_save_recipe` with its `slug`, the same data and `ingest`) or `pb_inbox_resolve {status: "skipped", reason: "duplicate of <slug>"}`. Genuinely different → re-save with `allow_duplicate: true`.
+   - `already_ingested` — the photos were saved before; continue.
+   - `error` — read it; usually a photo id is wrong or already attached elsewhere.
+6. Photos that aren't recipe cards → `skipped` with a reason. Photos you cannot read at all → `failed` with what's wrong ("back too blurry to read steps") so the user can re-shoot them.
+7. A front whose back is missing: save what the front gives with `extraction.needs_review: true` and list the missing parts in `extraction.uncertain`. Don't hold up the batch waiting for it.
+
+## Rules
+
+- Never guess numbers (quantities, nutrition, times). Unreadable → null + `extraction.uncertain`.
+- Don't echo extracted recipes into the conversation; the record is in the file. Report progress briefly every ~10 cards: done / remaining / flagged for review.
+- Keep going until `pb_inbox_next` reports `done: true` or the user stops you. At the end, summarise: cards saved, photos skipped or failed (with reasons), recipes needing review (`pb_search {needs_review: true}`).