feat: Phase 2 — saved recipes, browser, accessibility, level UX #69

Merged

pyr0ball merged 17 commits from feature/orch-auto-lifecycle into main

2026-04-08 15:13:45 -07:00

pyr0ball commented

2026-04-08 15:04:22 -07:00

Owner

Summary

Saved recipes: save/unsave, star ratings, notes, tags, collections (migrations 018–020)
Recipe browser: domain/category browsing with pantry match badges and pagination
Recipe detail panel: full directions, ingredient checklist, swap candidates, prep notes
Accessibility (WCAG): keyboard focus rings, icon-only button labels, modal focus management, tab ARIA semantics, aria-live results announcer, prefers-reduced-motion guard
Level UX: descriptive names (Use What I Have / Allow Swaps / Get Creative / Surprise Me) with inline descriptions

Test plan

Save a recipe from Find and Browse tabs
Edit saved recipe (rating, notes, tags, collection)
Browse by domain and category; verify pantry match badges
Open recipe detail panel; check ingredient checklist and directions
Keyboard-navigate the tab bar with arrow keys
Tab through the page — verify focus ring visible on all buttons
Screen reader: verify icon buttons announce contextual labels
Switch creativity levels — verify description updates below selector
Level 4 confirmation checkbox present and required

## Summary - **Saved recipes**: save/unsave, star ratings, notes, tags, collections (migrations 018–020) - **Recipe browser**: domain/category browsing with pantry match badges and pagination - **Recipe detail panel**: full directions, ingredient checklist, swap candidates, prep notes - **Accessibility (WCAG)**: keyboard focus rings, icon-only button labels, modal focus management, tab ARIA semantics, aria-live results announcer, prefers-reduced-motion guard - **Level UX**: descriptive names (Use What I Have / Allow Swaps / Get Creative / Surprise Me) with inline descriptions ## Test plan - [ ] Save a recipe from Find and Browse tabs - [ ] Edit saved recipe (rating, notes, tags, collection) - [ ] Browse by domain and category; verify pantry match badges - [ ] Open recipe detail panel; check ingredient checklist and directions - [ ] Keyboard-navigate the tab bar with arrow keys - [ ] Tab through the page — verify focus ring visible on all buttons - [ ] Screen reader: verify icon buttons announce contextual labels - [ ] Switch creativity levels — verify description updates below selector - [ ] Level 4 confirmation checkbox present and required

pyr0ball added 17 commits 2026-04-08 15:04:23 -07:00

feat: add household_invites migration (017) 9602f84e62

feat: extend CloudUser with household_id + update session resolution 9985d12156

Add household_id and is_household_owner fields to CloudUser dataclass.
Update _user_db_path to route household members to a shared DB path.
Update _fetch_cloud_tier to return a 3-tuple and cache a dict.
Update get_session to unpack and propagate household fields.

test: use tmp_path for _user_db_path tests; remove duplicate comment ed6813713e

Patch _user_db_path tests to monkeypatch CLOUD_DATA_ROOT onto a
tmp_path so they never touch /devl or any real filesystem path.
Remove duplicate X-Real-IP comment block in cloud_session.get_session.

chore: bump circuitforge-core dep to >=0.8.0; fix stale resources imports e605954254

- pyproject.toml: circuitforge-core>=0.6.0 → >=0.8.0 (orch split)
- vl_model.py: circuitforge_core.resources → circuitforge_orch.client
- llm_recipe.py: circuitforge_core.resources → circuitforge_orch.client

feat: add household Pydantic schemas 2db4de6d8f

refactor: use str | None + Field(default_factory=list) in household schemas dce8d05a09

feat: household API endpoints (create, status, invite, accept, leave, remove-member) 7650747651

feat: add MessageResponse schema; wire response_model on leave + remove-member endpoints c7861344b7

feat: add householdAPI typed wrappers to api.ts 70b1319b60

feat: household management UI in Settings (Premium-gated) 7cce05b95a

feat: handle household invite accept on app load via URL hash 11a0d1f3a6

fix: row_factory in _household_store; validate household_id from Heimdall; monkeypatch CLOUD_DATA_ROOT in accept test; add KIWI_BASE_URL to compose.cloud.yml 6a59c8dfd1

feat: migrate feedback endpoint to circuitforge-core router f3bc796f2c

Replace hand-rolled feedback.py with make_feedback_router() from
circuitforge_core.api.feedback. Update tests to mount the shared
router on a minimal FastAPI app and mock at the core module level.

refactor: use shorter circuitforge_core.api import for feedback router c064933b14

feat: saved recipes, recipe browser, and recipe detail panel 793df1b5cf

- Saved recipes: save/unsave, star rating, notes, tags, collections (migrations 018-020)
- Recipe browser: domain/category browsing with pantry match badges, pagination
- Recipe detail panel: full directions, ingredient checklist, swap candidates, prep notes
- Grocery links: affiliate links for missing ingredients
- Nutrition filters and display chips on recipe cards
- Bookmark toggle persisted to saved_recipes table
- Tier gates on saved recipes (paid) and collections (premium)
- Browser telemetry for domain/category click tracking
- Cloud compose: CLOUD_DATA_ROOT volume mount for per-user SQLite trees
- manage.sh: cf-orch agent sidecar in local stack
- README: updated feature list and stack description

fix(a11y): WCAG accessibility improvements across frontend e203ad4bdc

- Global :focus-visible ring in theme.css — covers all interactive elements
  with keyboard-nav focus ring without affecting mouse/touch users
- Removed pulse-urgent animation (safety policy violation — infinite animation)
- Global prefers-reduced-motion guard suppresses all animations system-wide
- Added .sr-only utility class for screen-reader-only content
- Tab bar (RecipesView): role=tablist/tab/tabpanel + aria-selected + arrow key nav
- Modal focus management: trap focus on open, restore on close, Escape to dismiss
  (SaveRecipeModal, RecipeDetailPanel, SavedRecipesPanel new-collection dialog)
- aria-modal=true on all modal dialogs
- Icon-only buttons now have contextual aria-labels:
  chip-remove: "Remove constraint: vegetarian" / "Remove allergy: peanuts"
  bookmark: "Bookmark: {title}" / "Remove bookmark: {title}"
  dismiss: "Hide recipe: {title}"
  browser save toggle: "Save recipe: {title}" / "Edit saved recipe: {title}"
- InventoryList qty +/- buttons: aria-label="Increase/Decrease quantity"
- Quantity number inputs: aria-label="Quantity"
- Select elements (SavedRecipesPanel): labelled via .sr-only for-id pattern
- Star rating group: role=group + aria-labelledby; each star: aria-pressed
- Ingredient checkboxes: label wraps input + span (label association fix)
- aria-live="polite" announcer for dynamic recipe results count
- Dynamic aria-labels on status messages (role=alert/status + aria-live)

feat(ux): rename creativity levels with descriptive labels and inline descriptions 74a7c068bc

- "Use What I Have" / "Allow Swaps" / "Get Creative" / "Surprise Me 🎲"
- Active level shows a one-liner description beneath the selector
- Hover tooltips repeat the description for mouse users
- Label changed from "Creativity Level" to "How far should we stretch?"
- Wildcard confirmation copy updated to match new framing