kiwi/tests/services/recipe/test_recipe_engine.py
pyr0ball b5eb8e4772 feat: cross-encoder reranker for recipe suggestions (kiwi#117)
Integrates cf-core reranker into the L1/L2 recipe engine. Paid+ tier
gets a BGE cross-encoder pass over the top-20 FTS candidates, scoring
each recipe against the user's full context: pantry state, dietary
constraints, allergies, expiry urgency, style preference, and effort
preference. Free tier keeps the existing overlap sort unchanged.

- New app/services/recipe/reranker.py: build_query, build_candidate_string,
  rerank_suggestions with tier gate (_RERANKER_TIERS) and graceful fallback
- rerank_score field added to RecipeSuggestion (None on free tier, float on paid+)
- recipe_engine.py: single call after candidate assembly, before final sort;
  hard_day_mode tier grouping preserved as primary sort when reranker active
- Fix pre-existing circular import in app/services/__init__.py (eager import
  of ReceiptService triggered store.py → services → receipt_service → store)
- 27 unit tests (mock backend, no model weights) + 2 engine-level tier tests;
  325 tests passing, no regressions
2026-04-24 16:39:51 -07:00

206 lines
8.4 KiB
Python

import pytest, json
from tests.services.recipe.test_element_classifier import store_with_profiles
from tests.db.test_store_recipes import store_with_recipes
def test_level1_returns_ranked_suggestions(store_with_recipes):
from app.services.recipe.recipe_engine import RecipeEngine, RecipeRequest
engine = RecipeEngine(store_with_recipes)
req = RecipeRequest(
pantry_items=["butter", "parmesan"],
level=1,
constraints=[],
)
result = engine.suggest(req)
assert len(result.suggestions) > 0
assert result.suggestions[0].title == "Butter Pasta"
def test_level1_expiry_first_requires_rate_limit_free(store_with_recipes):
from app.services.recipe.recipe_engine import RecipeEngine, RecipeRequest
engine = RecipeEngine(store_with_recipes)
for _ in range(5):
req = RecipeRequest(
pantry_items=["butter"],
level=1,
constraints=[],
expiry_first=True,
tier="free",
)
result = engine.suggest(req)
assert result.rate_limited is False
req = RecipeRequest(
pantry_items=["butter"],
level=1,
constraints=[],
expiry_first=True,
tier="free",
)
result = engine.suggest(req)
assert result.rate_limited is True
def test_level2_returns_swap_candidates(store_with_recipes):
from app.services.recipe.recipe_engine import RecipeEngine, RecipeRequest
store_with_recipes.conn.execute("""
INSERT INTO substitution_pairs
(original_name, substitute_name, constraint_label, fat_delta, occurrence_count)
VALUES (?,?,?,?,?)
""", ("butter", "coconut oil", "vegan", -1.0, 12))
store_with_recipes.conn.commit()
engine = RecipeEngine(store_with_recipes)
req = RecipeRequest(
pantry_items=["butter", "parmesan"],
level=2,
constraints=["vegan"],
)
result = engine.suggest(req)
swapped = [s for s in result.suggestions if s.swap_candidates]
assert len(swapped) > 0
def test_element_gaps_reported(store_with_recipes):
from app.services.recipe.recipe_engine import RecipeEngine, RecipeRequest
engine = RecipeEngine(store_with_recipes)
req = RecipeRequest(pantry_items=["butter"], level=1, constraints=[])
result = engine.suggest(req)
assert isinstance(result.element_gaps, list)
def test_grocery_list_max_missing(store_with_recipes):
from app.services.recipe.recipe_engine import RecipeEngine, RecipeRequest
engine = RecipeEngine(store_with_recipes)
# Butter Pasta needs butter, pasta, parmesan. We have only butter → missing 2
req = RecipeRequest(
pantry_items=["butter"],
level=1,
constraints=[],
max_missing=2,
)
result = engine.suggest(req)
assert all(len(s.missing_ingredients) <= 2 for s in result.suggestions)
assert isinstance(result.grocery_list, list)
def test_hard_day_mode_filters_complex_methods(store_with_recipes):
from app.services.recipe.recipe_engine import RecipeEngine, RecipeRequest, _classify_method_complexity
# Test the classifier directly
assert _classify_method_complexity(["mix all ingredients", "stir to combine"]) == "easy"
assert _classify_method_complexity(["sauté onions", "braise for 2 hours"]) == "involved"
# With hard_day_mode, involved recipes should be filtered out
# Seed a hard recipe into the store
store_with_recipes.conn.execute("""
INSERT INTO recipes (external_id, title, ingredients, ingredient_names,
directions, category, keywords, element_coverage)
VALUES (?,?,?,?,?,?,?,?)
""", ("99", "Braised Short Ribs",
'["butter","beef ribs"]', '["butter","beef ribs"]',
'["braise short ribs for 3 hours","reduce sauce"]',
"Meat", '[]', '{"Richness":0.8}'))
store_with_recipes.conn.commit()
engine = RecipeEngine(store_with_recipes)
req_hard = RecipeRequest(pantry_items=["butter"], level=1, constraints=[], hard_day_mode=True)
result = engine.suggest(req_hard)
titles = [s.title for s in result.suggestions]
assert "Braised Short Ribs" not in titles
def test_grocery_links_free_tier(store_with_recipes):
from app.services.recipe.recipe_engine import RecipeEngine, RecipeRequest
engine = RecipeEngine(store_with_recipes)
req = RecipeRequest(pantry_items=["butter"], level=1, constraints=[], max_missing=5)
result = engine.suggest(req)
# Links may be empty if no retailer env vars set, but structure must be correct
assert isinstance(result.grocery_links, list)
for link in result.grocery_links:
assert hasattr(link, "ingredient")
assert hasattr(link, "retailer")
assert hasattr(link, "url")
def test_suggest_returns_no_assembly_results(store_with_recipes):
"""Assembly templates (negative IDs) must no longer appear in suggest() output."""
from app.services.recipe.recipe_engine import RecipeEngine
from app.models.schemas.recipe import RecipeRequest
engine = RecipeEngine(store_with_recipes)
req = RecipeRequest(
pantry_items=["flour tortilla", "chicken", "salsa", "rice"],
level=1,
constraints=[],
)
result = engine.suggest(req)
assembly_ids = [s.id for s in result.suggestions if s.id < 0]
assert assembly_ids == [], f"Found assembly results in suggest(): {assembly_ids}"
# ── _within_time tests (kiwi#52) ──────────────────────────────────────────────
def test_within_time_no_directions_passes():
"""Empty directions -> True (don't hide recipes with no data)."""
from app.services.recipe.recipe_engine import _within_time
assert _within_time([], max_total_min=10) is True
def test_within_time_no_time_signals_passes():
"""Directions with no time signals -> total_min == 0 -> True."""
from app.services.recipe.recipe_engine import _within_time
steps = ["mix together", "pour over ice", "serve immediately"]
assert _within_time(steps, max_total_min=5) is True
def test_within_time_under_limit_passes():
"""Recipe with 10 min total and limit of 15 -> passes."""
from app.services.recipe.recipe_engine import _within_time
steps = ["cook for 10 minutes", "serve"]
assert _within_time(steps, max_total_min=15) is True
def test_within_time_at_limit_passes():
"""Recipe exactly at limit -> passes (inclusive boundary)."""
from app.services.recipe.recipe_engine import _within_time
steps = ["simmer for 10 minutes"]
assert _within_time(steps, max_total_min=10) is True
def test_within_time_over_limit_fails():
"""Recipe with 45 min total and limit of 30 -> fails."""
from app.services.recipe.recipe_engine import _within_time
steps = ["brown onions for 15 minutes", "simmer for 30 minutes"]
assert _within_time(steps, max_total_min=30) is False
# ── Reranker tier-gating tests ────────────────────────────────────────────────
def test_paid_tier_suggest_populates_rerank_score(store_with_recipes, monkeypatch):
"""Paid tier: at least one suggestion should have rerank_score populated."""
monkeypatch.setenv("CF_RERANKER_MOCK", "1")
try:
from circuitforge_core.reranker import reset_reranker
reset_reranker()
except ImportError:
pytest.skip("cf-core reranker not installed")
from app.services.recipe.recipe_engine import RecipeEngine
from app.models.schemas.recipe import RecipeRequest
engine = RecipeEngine(store_with_recipes)
req = RecipeRequest(pantry_items=["butter", "parmesan", "pasta"], level=1, tier="paid")
result = engine.suggest(req)
# Need at least _MIN_CANDIDATES for reranker to fire
from app.services.recipe.reranker import _MIN_CANDIDATES
if len(result.suggestions) >= _MIN_CANDIDATES:
assert any(s.rerank_score is not None for s in result.suggestions)
reset_reranker()
def test_free_tier_suggest_has_no_rerank_score(store_with_recipes):
"""Free tier: rerank_score must be None on all suggestions."""
from app.services.recipe.recipe_engine import RecipeEngine
from app.models.schemas.recipe import RecipeRequest
engine = RecipeEngine(store_with_recipes)
req = RecipeRequest(pantry_items=["butter", "parmesan"], level=1, tier="free")
result = engine.suggest(req)
assert all(s.rerank_score is None for s in result.suggestions)