kiwi/app/api/endpoints
pyr0ball 896b4e048c feat: recipe scanner — photo to structured recipe (kiwi#9)
New feature: photograph a recipe card, cookbook page, or handwritten
note and have it extracted into a structured, editable recipe.

Backend:
- POST /recipes/scan: accept 1-4 photos, run VLM extraction, return
  structured JSON for review (not auto-saved)
- POST /recipes/scan/save: persist a reviewed/edited recipe
- GET/DELETE /recipes/user: user-created recipe CRUD
- Vision backend priority: cf-orch -> local Qwen2.5-VL -> Anthropic BYOK
- 503 with clear config hint when no vision backend available
- Multi-photo support: facing pages (ingredients/directions) sent together
- Pantry cross-reference: marks which ingredients are already on hand
- migration 041: user_recipes table (title, servings, cook_time, steps,
  ingredients JSON, source, pantry_match_pct)
- Tier gate: recipe_scan -> paid, BYOK-unlockable

Frontend:
- "Scan" button in the Recipes tab bar (camera icon)
- RecipeScanModal: upload step (drag-drop + file picker, up to 4 photos,
  live previews), processing step (spinner), review/edit step (all
  fields inline-editable before save), pantry match badge, warning banner
  for low-confidence or incomplete scans

Tests: 35 new tests (23 unit + 12 API), 404 total passing
2026-04-27 08:23:01 -07:00
..
__init__.py chore: initial commit — kiwi Phase 2 complete 2026-03-30 22:20:48 -07:00
community.py fix: recipe enrichment backfill, main_ingredient browser domain, bug batch 2026-04-18 15:38:56 -07:00
corrections.py feat: corrections router (#73) + Magpie flywheel hook (#28) 2026-04-25 23:31:20 -07:00
export.py fix: recipe enrichment backfill, main_ingredient browser domain, bug batch 2026-04-18 15:38:56 -07:00
feedback.py refactor: use shorter circuitforge_core.api import for feedback router 2026-04-05 21:21:50 -07:00
feedback_attach.py feat: screenshot attachment in feedback form (#82) 2026-04-15 23:08:02 -07:00
health.py chore: initial commit — kiwi Phase 2 complete 2026-03-30 22:20:48 -07:00
household.py feat(recipe-engine): time-effort profile, product-label tokenisation, L1 tuning 2026-04-25 21:44:26 -07:00
imitate.py chore: commit in-progress work -- tag inferrer, imitate endpoint, hall-of-chaos easter egg, migration files, Dockerfile .env defense 2026-04-14 13:23:15 -07:00
inventory.py feat: visual label capture for unenriched barcodes (kiwi#79) 2026-04-24 17:57:25 -07:00
meal_plans.py feat: wire meal planner slot editor and meal type picker 2026-04-16 14:23:38 -07:00
ocr.py fix: wire recipe corpus to cloud per-user DBs via SQLite ATTACH (#102) 2026-04-18 14:21:56 -07:00
orch_usage.py feat(kiwi): add /orch-usage proxy endpoint for frontend budget display 2026-04-14 15:42:58 -07:00
receipts.py fix: recipe enrichment backfill, main_ingredient browser domain, bug batch 2026-04-18 15:38:56 -07:00
recipe_scan.py feat: recipe scanner — photo to structured recipe (kiwi#9) 2026-04-27 08:23:01 -07:00
recipe_tags.py feat(recipe-tags): community subcategory tagging API endpoints 2026-04-22 12:37:32 -07:00
recipes.py feat(browse): active time estimation, prep scaling, required-ingredient filter 2026-04-27 07:13:12 -07:00
saved_recipes.py feat: corrections router (#73) + Magpie flywheel hook (#28) 2026-04-25 23:31:20 -07:00
session.py fix: suppress E2E test sessions from log-based analytics 2026-04-18 19:06:37 -07:00
settings.py feat: time-first recipe entry (kiwi#52) 2026-04-24 10:15:58 -07:00
shopping.py feat(shopping): locale-aware grocery links with region settings UI 2026-04-21 15:05:28 -07:00
staples.py feat: recipe + staple API endpoints with tier gating 2026-03-31 12:49:38 -07:00