Brewing:
- roasted_beans + brews tables; /beans (bean management with LLM URL
prefill) and /brews (silhouette brewer picker across immersion/
percolation/espresso, recipe fields, auto ratio, 0-10 rating, tasting
notes); bean remaining weight derived from logged brew doses
- Green inventory lot form also prefills from a product URL
Navigation/UX:
- Side nav is now generated from one definition in nav.js, grouped
Roasting / Brewing / account, consistent on every page
LLM:
- 'Ask the LLM' chat drawer on the planner (stateless /api/plan-chat)
grounded in the plan, computed ledger, learned pace, and a new
roaster-behavior profile aggregated from uploaded .alogs
(/api/roaster-profile: TP lag, phase RoR, median milestone temps)
- The profile also feeds roast reviews and the planner curve's fallback
milestone temps
API platform:
- User-generated bearer tokens (rpt_…) with account-page management;
token requests skip CSRF; hand-authored OpenAPI 3 spec at
/api/openapi.json rendered by self-hosted Swagger UI at /api-docs
- Full-database backup export/import (admin) + per-user data export
Co-Authored-By: Claude Fable 5 <[email protected]>
- New server/llm.js consolidates ModelRuntime + model selection: admin
setting (app_settings.llm_model) > LLM_MODEL/PREFILL_MODEL env > first
available; used by both prefill and roast evaluation
- GET/PUT /api/admin/llm lists configured models and stores the choice
(validated against the list; empty = auto; audited); admin page gains
an LLM section with a model picker
- All user-facing 'Pi agent' wording is now 'LLM'; no_model error message
no longer references the pi CLI
- /roasts table: Review column removed (review lives in the detail view)
Co-Authored-By: Claude Fable 5 <[email protected]>
- POST /api/roasts stores the original .alog verbatim (multiple per plan),
parses it server-side, and kicks off an async zero-tool Pi agent review
(grade, highlights, concerns, next-batch suggestions, plan-vs-actual)
- /roasts page: table of historical actual roasts with review summaries;
row detail renders the BT curve as SVG with the plan curve overlaid,
shows the full review, and offers original-.alog backup download,
re-evaluate, and delete
- Planner's Reference curve drawer gains a multi-file finished-roast
uploader that attaches to the open (synced) plan
- Failed reviews record the error on the row and are retryable via
POST /api/roasts/:id/evaluate (e.g. once a model is configured)
Co-Authored-By: Claude Fable 5 <[email protected]>
- shared/ ports the worksheet's ledger math, time parsing, and reference tables
(cultivars/processes/roast-levels/machine bands) as browser-safe ESM, imported
by both the server and the browser so the arithmetic can't drift between them.
- server/prefill.js runs a zero-tool Pi Coding Agent SDK turn to extract page facts
from a bean product URL, then derives worksheet field IDs deterministically from
reference-data.js — the model never invents a first-crack anchor or a modifier.
- server/alog.js ports the Python alog_parser.py's format handling, including the
tokenizer-based Python-dict-literal-to-JSON conversion the real files need.
- public/ is the worksheet reproduced as a live HTML form: worksheet.css is a
verbatim copy of the paper worksheet's print CSS, print.js bakes values into
the print layout so the same DOM renders both on screen and on paper.
- Ledger math verified against both of the paper worksheet's worked examples;
alog parser verified against all 14 real logs in ref/roasts/.
Co-Authored-By: Claude Sonnet 5 <[email protected]>