pp-coffee-goat

What this skill does

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/food-and-dining/coffee-goat/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

# Coffee GOAT — Printing Press CLI

## Prerequisites: Install the CLI

This skill drives the `coffee-goat-pp-cli` binary. **You must verify the CLI is installed before invoking any command from this skill.** If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to `$HOME/.local/bin` on macOS/Linux and `%LOCALAPPDATA%\Programs\PrintingPress\bin` on Windows:
   ```bash
   npx -y @mvanhorn/printing-press-library install coffee-goat --cli-only
   ```
2. Verify: `coffee-goat-pp-cli --version`
3. Ensure the reported install directory is on `$PATH` for the agent/runtime that will invoke this skill.

If the `npx` install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.3 or newer):

```bash
go install github.com/mvanhorn/printing-press-library/library/food-and-dining/coffee-goat/cmd/coffee-goat-pp-cli@latest
```

If `--version` reports "command not found" after install, the runtime cannot see the binary directory on `$PATH`. Do not proceed with skill commands until verification succeeds.

## When to Use This CLI

Use coffee-goat when an agent needs to compare or recommend specialty coffee across many roasters at once, when answering 'what should I drink next' or 'what should I buy next' from a user's logged cellar, when finding YouTube creator coverage of a specific bag in seconds instead of rewatching a 20-minute video, when matching champion recipes to currently-buyable beans, when mapping a user's palate onto the SCA flavor wheel, when picking a gift bag for a friend whose palate profile is imported, when finding cafes near a location, or when diagnosing whether a user's recent low ratings are bean quality or equipment drift. Do NOT use it for ordering — coffee-goat is read-only across upstream sources. Do NOT use it to find which beans a cafe serves — no public no-auth source links cafes to beans.

## When Not to Use This CLI

Do not activate this CLI for requests that require creating, updating, deleting, publishing, commenting, upvoting, inviting, ordering, sending messages, booking, purchasing, or changing remote state. This printed CLI exposes read-only commands for inspection, export, sync, and analysis.

## Unique Capabilities

These capabilities aren't available in any other tool for this API.

### The God cup
- **`god-cup`** — Integrates your shelf, brew history, Coffee Review scores, Hoffmann/Hedrick coverage, and champion recipes to produce one brew-now pick and one buy-next pick.

  _Pick this as the headline 'what should I do next' question; integrates every signal source into one answer._

  ```bash
  coffee-goat god-cup --method espresso --agent
  ```

### Cross-source corpus
- **`search`** — Search every elite specialty roaster's catalog at once — Ethiopian naturals across the curated shelf in one query.

  _Pick this when an agent needs a cross-source, structured product query rather than visiting many storefronts._

  ```bash
  coffee-goat search "ethiopia natural" --in-stock --price-lt 2500 --agent
  ```
- **`watch`** — Saved search emits only new matches on each sync — silent when nothing changed, cron-safe.

  _Pick this when a user wants to be alerted the moment a specific producer or origin appears anywhere._

  ```bash
  coffee-goat watch save bermudez "diego bermudez gesha" --agent
  ```
- **`twin`** — Given a bean you loved, find the closest current match across the curated shelf via origin/varietal/process/altitude/descriptor similarity.

  _Pick this to replace a sold-out favorite without manually scanning every other roaster._

  ```bash
  coffee-goat twin sey-banko-gotiti --top 5 --agent
  ```
- **`compare`** — Side-by-side bean table with origin/process/altitude/$/oz/score deltas; works across roasters.

  _Pick this when choosing between candidates from different roasters with structured deltas._

  ```bash
  coffee-goat compare sey-banko-gotiti glitch-yirgacheffe --agent
  ```
- **`producer`** — Track a producer or farm (Diego Bermudez, Wush Wush, El Paraiso) across every roaster sync — multi-year lineage view.

  _Pick this to compare different roasters' interpretations of one producer or to track lot evolution._

  ```bash
  coffee-goat producer "Diego Bermudez" --min-roasters 3 --agent
  ```
- **`fx`** — Live ECB FX rates normalize $/oz across continents; curated shipping table adds ship-to landed cost.

  _Pick this before ordering from JP/DK/UK/DE roasters to compare true landed cost._

  ```bash
  coffee-goat fx tim-wendelboe-finca-el-paraiso --target USD --to us-domestic --agent
  ```

### Personal-history analytics
- **`dial-in`** — Suggest grind/dose/yield/time for a new bean using your brew history of similar beans (origin/process/varietal/altitude clusters).

  _Pick this to start with a confidence-banded recipe instead of burning beans on cold-start dial-ins._

  ```bash
  coffee-goat dial-in sey-banko-gotiti --method espresso --agent
  ```
- **`shelf`** — What's on your shelf today, sorted by freshness with per-method peak windows (espresso 8–21d, filter 5–28d).

  _Pick this to answer 'what should I open next' with hard freshness rules._

  ```bash
  coffee-goat shelf --method v60 --agent
  ```
- **`whats-next`** — Joins shelf freshness × dial-in confidence × user palate signature to pick one bag from your shelf for tomorrow morning.

  _Pick this when the household agent needs one deterministic 'brew this' answer at dawn._

  ```bash
  coffee-goat whats-next --method v60 --agent
  ```
- **`drift`** — Detect grinder/water/technique drift via fixed-effects OLS on rating-vs-day across multiple beans; partitions variance by method.

  _Pick this when ratings slide across unrelated beans — the CLI tells you it's your hardware, not the coffee._

  ```bash
  coffee-goat drift --method espresso --agent
  ```
- **`refill-plan`** — Combines consumption rate from your brews + shelf depletion + cross-roaster twin similarity to recommend 3 replacement picks.

  _Pick this to never run out of coffee and always restock toward your taste profile._

  ```bash
  coffee-goat refill-plan --agent
  ```
- **`blind-cup`** — Blind cupping session with hashed cup IDs; reveal at end and report Spearman correlation against Coffee Review's scores.

  _Pick this to quantify how your palate maps to published scores over time._

  ```bash
  coffee-goat blind-cup --agent
  ```
- **`palate-map`** — Aggregate your 8+ rated brews into an origin/process/varietal weight signature, then rank current shelf and restock candidates by signature match.

  _Pick this to see what flavor profile you actually prefer (vs what you claim), and rank everything by it._

  ```bash
  coffee-goat palate-map --agent
  ```
- **`bag-life`** — For one bag, plot daily ratings vs days-since-roast and call peak / decline / dead.

  _Pick this to decide whether a struggling shot is the bag dying or your technique slipping._

  ```bash
  coffee-goat bag-life onyx-geometry --agent
  ```
- **`friend-pick`** — Recommend a bag for a friend whose palate profile you've imported — pick from your shelf or current market, ranked against their descriptor signature instead of yours.

  _Pick this when an agent needs to recommend a gift bag or birthday-coffee pick that fits someone else's documented palate._

  ```bash
  coffee-goat friend-pick pick maya --from market --top 3 --agent
  ```
- **`flavor-wheel`** — Maps your brew ratings onto the official SCA Coffee Tasters' Flavor Wheel hierarchy (fruity → berry → blackberry, floral → tea-like → black tea, etc.) and shows which sections you actually prefer.

  _Pick this when the use