Skip to content

Puckworks v0.3.0 — Guided Espresso Pull

Latest

Choose a tag to compare

@trbrewer trbrewer released this 18 Jul 15:30
· 878 commits to main since this release

Puckworks v0.3.0 — Guided Espresso Pull

The Guided Espresso Pull — a rights-independent, runnable guided mechanism explorer — under the
supported puckworks.product API. Enter a bounded recipe and run one coherent, model-backed espresso
pull on CPU, stage by stage, with evidence-labelled traces, a visual report, deterministic exports,
and a guided Google Colab notebook. Also adds the caller-owned input normalization boundary.

What you get

  • Package API: load_pull_preset, simulate_pull, render_pull_report, pull_run_to_json /
    pull_run_to_markdown; records PullRecipe / PullConfig / PullRun / PullSeries / PullTrace
    / ComponentCoverage / PullReportArtifacts.
  • CLI: puckworks-pull presets, puckworks-pull run …, and --report-dir/--figures.
  • Authoritative traces copied from the solver at full precision, each labelled by value role
    (prescribed input · simulated output · derived quantity).
  • Visual report: evidence-badged figures + captions + JSON/Markdown (matplotlib is an optional
    [viz] extra; the core stays matplotlib-free).
  • Google Colab: notebooks/guided_espresso_pull_colab.ipynb with native form controls, installing
    this exact release wheel after SHA-256 verification.

One coherent model — and its honest limits

The one executed chain is cameron2020.extraction_bdf (grind → machine/flow → extraction → cup). It
is an EXPLORATORY_SIMULATION, code-verified against the source paper, not independently validated
against a measured cup. Active recipe controls: dose, target beverage, prescribed constant pressure,
EK43 grind, coffee profile, domain policy. Bean label is metadata only. Temperature is
recorded-only
(no thermal transient). It does not model physical first drip or puck
wetting
(the model begins from a saturated bed), does not simulate a dynamic pressure
profile
(pressure is prescribed constant), reports chemical composition (never sensory flavor),
and never executes or averages a parallel lens into a consensus. Alternative components get an
explicit, non-executed coverage disposition.

Install (GitHub-only — not on PyPI)

Download puckworks-0.3.0-py3-none-any.whl from this release and pip install the file. Puckworks is
not published on PyPI.

Provenance

  • Source commit: c5ab770b76ea2fb876c348ca48d802d604c112ca
  • puckworks-0.3.0-py3-none-any.whl — SHA-256 4a88931fc0bbc069365242fc5e3ef4d226da9225c80384b6d013028e4b7a3ec0 (1,036,725 bytes)
  • puckworks-0.3.0.tar.gz — SHA-256 dc89d1f40c2e8329ac34b7a474f7b03cb7f17c5c8952f9232a2a2daa3954b1ca (1,064,496 bytes)

No private or rights-gated fixture is distributed. See CHANGELOG.md for the full change list.