Repository navigation
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; recordsPullRecipe/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.ipynbwith 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-2564a88931fc0bbc069365242fc5e3ef4d226da9225c80384b6d013028e4b7a3ec0(1,036,725 bytes)puckworks-0.3.0.tar.gz— SHA-256dc89d1f40c2e8329ac34b7a474f7b03cb7f17c5c8952f9232a2a2daa3954b1ca(1,064,496 bytes)
No private or rights-gated fixture is distributed. See CHANGELOG.md for the full change list.