Pp Dice Fm

<!-- 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:

   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.6 or newer):

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.

  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.

  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.

  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.

  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.

  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.

  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.

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

  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.

  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.

  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 allocation breakdown, pool-sum vs event total (--event, --limit)

tier-performance — Price-tier sales analysis from the local store

• dice-fm-pp-cli tier-performance — Per price-tier redemptions and each tier's share of total sales (--limit)

Finding the right command

When you know what you want to do but not which command does it, ask the CLI directly:

dice-fm-pp-cli which "<capability in your own words>"

which resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code 0 means at least one match; exit code 2 means no confident match — fall back to --help or use a narrower query.

Recipes

Build tonight's door list

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

Returns valid ticket holders with transfer resolution — who holds valid tickets, with new holder names for any transferred tickets.

Export opted-in London fans for Mailchimp

dice-fm-pp-cli fans optin --event RXZlbnQ6MTIzNDU= --country GB --city London --csv

Filters opted-in buyers from London, outputs CSV with firstName, lastName, email for direct import.

Weekly CFO revenue report

dice-fm-pp-cli revenue summary --from 2026-01-01 --json --select event_name,gross,dice_fees,net,orders_count

Aggregates all orders since January 1, showing gross, Dice fees, and net per event with totals.

Find repeat buyers for new event announcement

dice-fm-pp-cli fans repeat --min-events 2 --since 2026-01-01 --agent

Lists fans who attended 2+ events this year with total spend — warm audience for early access campaigns.

Check ticket velocity in first 72 hours

dice-fm-pp-cli velocity show --event RXZlbnQ6MTIzNDU= --bucket hour --json --select hour_offset,cumulative_sold

Shows hourly cumulative ticket sales relative to on-sale time so you can decide if an event needs promotional push.

Cross-event capacity headroom

dice-fm-pp-cli capacity --limit 20 --select event_name,sold,capacity,remaining,pct_sold

Ranks events by how close they are to selling out (sold, capacity, remaining, pct_sold). Add capacity pools --event <id> to break a single event into its ticket pools.

Which price tiers carried the sales mix

dice-fm-pp-cli tier-performance --limit 20 --json

Per price-tier redemptions and each tier's share of total sales — which price points actually moved.

Normalize names, then report by axis

dice-fm-pp-cli normalize --tiers --venues --fuzzy
dice-fm-pp-cli normalize --export-unmatched unmatched.json
# classify externally, then import the result as method=manual
dice-fm-pp-cli normalize --import classified.json
dice-fm-pp-cli normalize promote-rules --entity ticket_type --write
dice-fm-pp-cli normalize --tiers --venues --fuzzy
dice-fm-pp-cli revenue summary --from 2026-01-01 --by-axis access_class --json

Canonicalizes free-text ticket-type and venue names into structured axes (parallel and local-only; raw data untouched), then groups a revenue report on a clean axis. Run normalize recommend --print first to preview a starter config; after importing manual classifications, normalize promote-rules --entity <type> --write promotes repeat tokens into deterministic regex rules.