kiwi/app/api/endpoints
pyr0ball b4624fba84 feat(ask): add POST /recipes/ask endpoint for natural-language recipe search
Free tier: keyword extraction + FTS ingredient search + title probe search.
Paid tier / BYOK: same search, then LLM synthesis of a conversational answer
(8s timeout so an unresponsive model degrades gracefully to recipe list only).

- AskRequest / AskRecipeHit / AskResponse schemas in recipe.py
- _extract_ask_keywords(): tokenize question, strip stopwords
- _ask_in_thread(): two-pronged search (ingredient FTS + title LIKE)
  merges by ID, computes pantry match_pct when pantry_items provided
- Endpoint registered before /{recipe_id} to avoid integer coercion on /ask
- LLM synthesis gated to paid/premium/ultra only (not "local" dev tier)

Closes #134 (backend)
2026-05-11 13:07:53 -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 fix(barcode): look up product info before checking auto_add_to_inventory 2026-05-11 11:33:02 -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(ask): add POST /recipes/ask endpoint for natural-language recipe search 2026-05-11 13:07:53 -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