Casual Friday

Ping

Health check — returns ok.

List Beans

List green coffee beans with optional filters. Compact by default: origin, country/region, altitude, processing method, density, moisture, water activity, total_score, cost, grade. Pass `verbose=True` to get Sweet Maria's full record (cupping notes, flavor profiles, farm notes, roast recommendations) — large; use selectively. Default limit covers the full catalog; narrow with `country`, `processing_method`, or `min_score`.

Get Bean

Get the full record for one green coffee bean by ID.

List Roasts

List roasts with their stored scores. Lightweight — no timeline. Sorted newest-first by roast_number, then truncated to `limit`. For all-time best/worst (regardless of recency), pass `min_score=N` — it filters server-side BEFORE the limit slice. Don't rely on `limit` alone to find top scorers; it biases toward recent roasts only.

Get Roast

Get one roast by roast_number with optional timeline + milestones. Timeline is large (one record per second) — only opt in when analyzing the curve. Milestones (TP, FC start/end, 2nd crack, yellowing) are cheap.

Get Roast Score

Compute and return the full score breakdown for one roast. Includes total score (0-100), letter grade, algorithm version, per-component scores with their max values, plain-English explanations, and improvement suggestions. Use this when iterating on the scoring algorithm.

List Roast Scores

Score N roasts and return only score + components. Newest first. For aggregates ("average ror_quality across my last N"). For top-of- all-time queries, prefer list_roasts(min_score=N) to find candidates across the whole catalog, then pull breakdowns with get_roast_score.

Generate Bullet R2 Recipe

Generate a Bullet R2 roast recipe for a green bean. Direct 1:1 port of the original TypeScript recipe generator. Produces a complete profile: charging temp, time-based roast table (P/F/D settings per phase), batch size, success factors, warnings, and confidence score. With no reference_roast_numbers, returns the baseline recipe (confidence 0.3). Pass a list of high-scoring roast_numbers (ideally for similar beans) to derive the recipe from real timeline + milestone data — those roasts are trea