- New flavor-wheel.js: two-ring sunburst (families inner, descriptors
outer) in SCA hue families; tapping a wedge toggles the same flavor
tag as the checkbox list; selections render bold with a dark outline;
respects the tag limit; labels drawn above all wedges so long names
never clip (screenshot-verified in headless Chromium)
- Cupping radar: one hue per attribute on labels + vertex dots
Co-Authored-By: Claude Fable 5 <[email protected]>
Root cause of the broken diagrams found and fixed: CSS transform
animations were overriding the SVG positioning transform on the same
element, throwing animated elements (beans, flames) to the canvas
origin — the bean/flame helpers now split position (outer group) from
animation (inner group).
Every scene was then rendered in headless Chromium and screenshot-
inspected, with fixes applied and re-verified: drying-scene label
collision, RoR ideal-line label overlap, first-crack dot off the curve,
composition bar stagger orphaning its labels, moka flame hidden behind
the base.
New opening slide (user request): 'The whole journey, in one bean' — a
large bean on a 14-second loop living the full roast (heat in, drying
steam out, green→yellow→brown, pressure swell, crack) synced to a
stage timeline with a riding marker; narrated like the rest.
Co-Authored-By: Claude Fable 5 <[email protected]>
- Roasting is now a single continuous 11-slide lesson ('The roast,
start to finish') merging the six lessons' content; brewing keeps its
four per-family lessons
- Progress tracking: resume-where-you-left-off per lesson, progress bar
and completed badge on the lesson cards (localStorage)
- Every scene rebuilt against a fixed safe area (nothing off-canvas),
with animations that depict the narrated mechanism: contained
thermometer fills, a drawn dip-and-turn for the turning point, chaff
drifting off the swelling Maillard bean, crash/flick/stall on one
annotated RoR chart, per-brewer water/grounds anchored to each
silhouette's actual bowl, gauge needle sweeps instead of spinning
clocks; multiline labels replace out-of-frame text
- 9 new narration clips generated, 23 orphaned ones removed (31 total)
Co-Authored-By: Claude Fable 5 <[email protected]>
The admin nav-link reveal ran before the generated nav existed
(getElementById('nav-admin') was null only for admins — which is why
tests and non-admin checks missed it), aborting init before form wiring,
autosave, and loadPlans. initSideNav now runs first, the reveal is
null-safe, and wireCuppingLink degrades instead of crashing (its button
lost its home when After-the-Roast moved — it now lives at the end of
the Roast Log section with a pointer to the Roasts page).
Also: the Roasts page graph now honors the planner's °C/°F preference.
Co-Authored-By: Claude Fable 5 <[email protected]>
- The app header now wraps: brand + actions on the first row (actions
shrink and wrap instead of pushing Print off-screen), section pills
always on their own full-width row; the planner's sticky offsets use
a two-row --header-h via body:has(#plan-form)
- Roast detail gains a Plan selector (attach/detach any of your plans)
alongside the Machine selector; PUT /api/roasts/:id accepts
roastPlanId with ownership checks
Co-Authored-By: Claude Fable 5 <[email protected]>
One system: post-roast observations (weights, colour, DTR, cup notes,
'one change next batch', disproof) now live on the uploaded roast
(actual_roasts.after, migration 011), edited on the roast detail view
with weights/DTR prefilled from the .alog itself. The planner's screen
section is removed (the print worksheet keeps its hand-fill copy), and
the lot 'last refine' suggestion reads the note from both the new home
and legacy plans, newest wins.
Every roast now downloads two ways: the untouched original .alog, and
an updated supplemental copy with the app's data written back as valid
Artisan fields (weight, beans, roastingnotes incl. the LLM review,
cuppingnotes incl. linked cupping score/flavors) — serialized as a
Python literal so Artisan's ast.literal_eval re-imports it.
Co-Authored-By: Claude Fable 5 <[email protected]>
The section nav (Plan/Bean/Machine/Log/After) was an overflow-x:auto
strip with hidden scrollbars — undiscoverable on touch. It now wraps on
desktop and renders as a fixed five-column grid of equal pills at
≤720px (labels shortened to fit 320px), and the actions row lets the
autosave chip shrink/ellipsize so nothing can force horizontal overflow.
Co-Authored-By: Claude Fable 5 <[email protected]>
Machines:
- roasters table + actual_roasts.roaster_id (migrations 009): per-user
machines with a default; uploads attach to the default roaster and are
reassignable from the roast detail view
- Learning is now per machine: /api/roaster-profile scopes to a roaster
(default when unspecified) and applies the user's override tweaks
(milestone temps, TP time, pace factor) on top of learned medians
- /roasters page: machine list + analysis report showing learned vs
applied values with editable tweaks, typical RoR, and a plain-language
list of the adjustments applied to plans; planner honors a manual pace
override; evaluations use the roast's own machine profile
Mobile header redesign:
- The planner's header tools collapse behind a single 'Tools ▾'
disclosure (dropdown card) at ≤720px, keeping the fixed three-row
mobile header with no wrapped or scrolling button rows; desktop
renders inline via display:contents (same DOM, same handlers)
Profile pictures:
- users.avatar (migration 010) + PUT/GET/DELETE /api/account/avatar;
client-side centre-crop resize to 128px JPEG; avatar shows in the nav
chip on every page; included in full backups
Co-Authored-By: Claude Fable 5 <[email protected]>
- user_gear table (migration 008) + GET/PUT /api/gear (brewer keys
validated against the taxonomy, grinders deduped/trimmed)
- /gear page: silhouette multi-select for owned brewers (autosaves) and
a grinder list; nav gains Brewing → Equipment
- Brews page: with gear configured, the picker shows only owned brewers
(plus the edited brew's method) with a show-all toggle; grinder field
suggests your grinders; empty-gear state links to /gear
- Included in full backups, per-user export, and the OpenAPI spec
Co-Authored-By: Claude Fable 5 <[email protected]>
The Tools group (Plans, Ask the LLM, Prefill, Curves, Import/export,
Field IDs, Settings) acted on the open plan, not on navigation — it now
renders as compact action buttons in the planner header's existing
actions row (wrapping on narrow screens), and the left rail is pure
navigation, identical on every page.
Co-Authored-By: Claude Fable 5 <[email protected]>
The extraction schema gains cultivarGroup (typica/bourbon/ethiopian/
hybrid, classified by the LLM from coffee genetics); when the named
variety isn't in the cultivar table, deriveFields now falls back to the
group's first-crack anchor (number still comes only from the reference
table) instead of leaving 1.4 blank and breaking every downstream
calculation. deriveFields exported + unit-tested.
Co-Authored-By: Claude Fable 5 <[email protected]>
Free-text recipe (bloom, pours, timings) distinct from tasting notes and
next-time notes: new brews.recipe column (migration 007), form textarea,
shown under the recipe summary in brew history, carried by Brew again,
included in backups and the OpenAPI spec.
Co-Authored-By: Claude Fable 5 <[email protected]>
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]>
