pp-dice-fm

What this skill does

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/media-and-entertainment/dice-fm/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/". -->

# DICE — Printing Press CLI

## Prerequisites: Install the CLI

This skill drives the `dice-fm-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 dice-fm --cli-only
   ```
2. Verify: `dice-fm-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/media-and-entertainment/dice-fm/cmd/dice-fm-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 this CLI when you need to query your DICE event data programmatically — building door lists before shows, generating financial reports, segmenting fan lists for Mailchimp, or identifying repeat buyers across your event history. It is the right tool for any workflow that requires cross-event aggregation or data that the DICE dashboard cannot combine in one view.

## 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.

### Access management
- **`door list`** — Generate a valid-ticket-holder list for any event, with transferred tickets showing the new holder's name — ready for door access management.

  _Use this before every show to get the definitive 'who can enter' list including all transfers and minus all returns._

  ```bash
  dice-fm-pp-cli door list --event RXZlbnQ6MTIzNDU= --json
  ```

### Financial intelligence
- **`revenue summary`** — Aggregate gross revenue, Dice fees, and net earnings per event or across a date range — ready for CFO reports.

  _Use this for weekly financial reporting without manually totaling per-event dashboards in a spreadsheet._

  ```bash
  dice-fm-pp-cli revenue summary --from 2026-01-01 --json
  ```
- **`velocity show`** — Show cumulative ticket sales by day or hour relative to the on-sale date — see whether an event is tracking fast or slow.

  _Use within the first 72 hours after an on-sale to decide whether an event needs promotional push._

  ```bash
  dice-fm-pp-cli velocity show --event RXZlbnQ6MTIzNDU= --bucket day --json
  ```
- **`returns anomalies`** — Flag events with unusually high refund rates — a pricing or marketing signal that deserves immediate attention.

  _Use after sales close each week to surface events that may have pricing problems before the show date._

  ```bash
  dice-fm-pp-cli returns anomalies --threshold 0.08 --agent
  ```

### Audience intelligence
- **`fans repeat`** — Find fans who bought tickets to two or more of your events — your most loyal audience, ready for VIP outreach.

  _Use weekly to build re-engagement lists before announcing new events to warm audiences first._

  ```bash
  dice-fm-pp-cli fans repeat --min-events 2 --since 2026-01-01 --csv
  ```
- **`fans optin`** — Export opted-in fan contacts filtered by city or country — CSV ready for Mailchimp, no dashboard exports needed.

  _Use every Monday to build targeted email lists from the previous week's ticket buyers without touching the Dice dashboard._

  ```bash
  dice-fm-pp-cli fans optin --event RXZlbnQ6MTIzNDU= --country GB --city London --csv
  ```
- **`fans top`** — Rank ticket buyers by total spend for an event or across all events — your VIP list for comps, upgrades, and sponsor decks.

  _Use before each show to identify high-value fans for VIP treatment, and before sponsor meetings to demonstrate audience quality._

  ```bash
  dice-fm-pp-cli fans top --event RXZlbnQ6MTIzNDU= --n 20 --json
  ```

### Inventory & catalog intelligence
- **`capacity`** — Roll up sold-vs-capacity headroom across every event from the local store; `capacity pools` breaks one event down by ticket pool (pool-sum vs event total).

  ```bash
  dice-fm-pp-cli capacity --limit 20 --select event_name,sold,capacity,remaining,pct_sold
  ```
- **`tier-performance`** — Rank price tiers by redemptions and each tier's share of total sales from the local store.

  ```bash
  dice-fm-pp-cli tier-performance --limit 20 --json
  ```
- **`normalize`** — Canonicalize free-text ticket-type and venue names into structured axes (parallel, re-runnable, local-only); `normalize recommend` emits a starter config, `normalize stats` shows coverage, and `normalize promote-rules` learns reusable regex rules from manual classifications.

  ```bash
  dice-fm-pp-cli normalize --tiers --fuzzy
  ```

## Command Reference

**events** — Events on your DICE account (scheduling, state, venues, ticket types)

- `dice-fm-pp-cli events get` — Get a single event by ID
- `dice-fm-pp-cli events list` — List your events

**extras** — Extras and add-ons sold with tickets

- `dice-fm-pp-cli extras` — List extras (filter by event)

**genres** — Event genre types and their child genres

- `dice-fm-pp-cli genres` — List genre types

**orders** — Ticket purchase orders with financial and geographic data

- `dice-fm-pp-cli orders` — List orders (filter by event)

**returns** — Ticket returns and refunds

- `dice-fm-pp-cli returns` — List returns (filter by event)

**tickets** — Sold tickets with holder details, pricing, and claim status

- `dice-fm-pp-cli tickets` — List sold tickets (filter by event)

**transfers** — Ticket transfers between fans

- `dice-fm-pp-cli transfers` — List ticket transfers (filter by event)

**normalize** — Canonicalize manually-entered ticket-type and venue names into structured axes (parallel and re-runnable; raw synced data is never modified)

- `dice-fm-pp-cli normalize` — Resolve raw names → canonical entities + axes (`--tiers`, `--venues`, `--all`, `--entity`, `--fuzzy`, `--fuzzy-threshold <float>`, `--export-unmatched <file>`, `--export-format prompt|names`, `--import <file.csv|.json>`)
- `dice-fm-pp-cli normalize stats` — Show the normalized axis distribution (`--entity`)
- `dice-fm-pp-cli normalize recommend` — Profile the store and emit a starter normalization config (`--print` previews without writing)
- `dice-fm-pp-cli normalize promote-rules` — Graduate method=manual classifications into validated regex rules (`--entity <type>`, `--write`, `--min-support <int>` default `2`)

  Query the normalized view via `revenue summary --by-axis <access_class|sales_stage|entry_window_type|group_size|comp_flag>`. Raw is the default; `--by-axis` falls back to raw (with a warning) if `normalize` has not been run. Normalization is local-only — resolved name mappings never leave your machine.

  Future: `--classifier-cmd <path>` will let you bring your own LLM subprocess for classification; the external command owns its auth and credentials.

**capacity** — Cross-event sold-vs-capacity headroom from the local store

- `dice-fm-pp-cli capacity` — Sold-vs-capacity headroom rollup across events (`--event`, `--limit`)
- `dice-fm-pp-cli capacity pools` — Per-ticket-pool allocat