ShotPulled

Showing 25 of 34 from the live probe.

• Register a grinder

  Register a manual or electric grinder with its dial settings scheme.

• Set grinder position

  Set the current grinder collar position. source="measured" resets verification freshness.

• Register an espresso machine

  Register an espresso or alternative preparation machine.

• Archive or restore equipment

  Archive or restore a grinder, machine, water, or scale.

• Log maintenance

  Log a cleaning or maintenance job against a piece of equipment. A task that takes the thing apart opens a calibration epoch, and every recipe locked before it is read through that epoch's offset — so record the offset here if you counted the clicks while reassembling, which is the one moment anybody actually knows it. Read the available tasks, their intervals and their due state from list_grinders.

• Set calibration offset

  Record how far a maintenance job moved the reference, on an entry that opened a calibration epoch. Takes an ENTRY, not a piece of equipment: the offset belongs to the event that caused it, which is what lets several of them compose for a recipe locked before all of them. Zero is a legitimate measurement and means "measured, and it had not moved" — omit offset_value entirely to clear it back to unmeasured.

• Register a water recipe

  Register a custom or commercial water formulation.

• List water recipes

  List registered waters for the account. The `id` on each row is the number this account knows that record by, counting from 1 — safe to show, and what other tools expect back.

• Register a scale

  Register a brewing scale — the instrument that weighs the dose and the yield.

• List scales

  List registered scales for the account. The `id` on each row is the number this account knows that record by, counting from 1 — safe to show, and what other tools expect back.

• Register a machine program

  Register a programmed shot button on a machine. A program cuts the shot off either by weight (program_type "volumetric", set target_volume_g) or by time (program_type "timed", set target_time_s). One machine can have a mix of both.

• Register a bag of coffee

  Register a new bag of coffee beans.

• Set active equipment

  Switch the active bean, grinder or machine for this account. The numbers come from list_beans, list_grinders and list_machines. Registering something already makes it active, so use this to switch back to something that exists, not after register_coffee.

• Update a bag of coffee

  Update coffee bag fields. Changing dial_category changes what the engine advises (G5, C10), so say why in the optional note.

• Get current dial state

  Retrieve current dialing state, active context, recent shots, recommendations, and locked recipes.

• Log a shot

  Log an espresso or alternative shot/brew attempt. Uses the active context (bean/grinder/machine/program) unless overridden via bean_id/grinder_id/machine_id/program_id — ALWAYS pass bean_id explicitly when the user names a specific coffee, so the shot cannot land on the wrong bag. Backdate with pulled_at when the shot happened earlier. When the user reports taste (bitter, sour, harsh, hollow…), include matching sensory_tags — the diagnosis engine reads tags and metrics, not free-text flavor_note

• Lock a recipe

  Lock a successful shot as the reference dialing recipe for this equipment profile.

• Delete a shot

  Delete a logged shot from history. Restores the bean's remaining weight (which is derived from logged doses). Hard delete — there is no undo. To fix a mistake on an otherwise-valid shot, prefer update_shot over delete-and-relog.

• Update a shot

  Correct fields on an already-logged shot in place — no need to delete and re-log. Use for fixing a wrong dose/yield/time or grind label, re-filing a shot onto the right bean (bean_id), backfilling rating/tasting notes, or fixing the timestamp (pulled_at). Changing grind_label re-derives the numeric grind position from the shot's grinder; changing yield/time/dose/tds keeps flow rate and extraction yield consistent automatically.

• List locked recipes

  List recipes (all or filtered by equipment and status). The `id` on each row is the number this account knows that record by, counting from 1 — safe to show, and what other tools expect back.

• Get statistics

  Get compact flat usage stats for a grinder, machine, or bean.

• List grinders

  List grinders registered for the account, with status filter. The `id` on each row is the number this account knows that record by, counting from 1 — safe to show, and what other tools expect back.

• List espresso machines

  List machines registered for the account, with status filter. The `id` on each row is the number this account knows that record by, counting from 1 — safe to show, and what other tools expect back.

• List bags of coffee

  List coffee beans registered for the account, with status filter. The `id` on each row is the number this account knows that record by, counting from 1 — safe to show, and what other tools expect back.

• Grinder math

  Determine steps/clicks difference and directions between setting labels (C3).