pp-pagliacci

What this skill does

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/food-and-dining/pagliacci/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/". -->

# Pagliacci Pizza — Printing Press CLI

## Prerequisites: Install the CLI

This skill drives the `pagliacci-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 pagliacci --cli-only
   ```
2. Verify: `pagliacci-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/pagliacci/cmd/pagliacci-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 an agent or user wants to interact with Pagliacci Pizza programmatically: browsing the menu, finding a store and time slot, building a half-and-half pizza, planning a small-party order, checking rewards balance, or replaying a past order. The CLI is built for households ordering for family or small parties.

## Unique Capabilities

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

### Local state that compounds
- **`slices today`** — See which Pagliacci slices are available right now at every Seattle store, sorted by proximity to your saved address.

  _When the family asks 'what slices can we order tonight?', this returns a single comparable list — no per-store iteration needed._

  ```bash
  pagliacci-pp-cli slices today --agent
  ```
- **`rewards stack`** — Compute the best application of stored coupons, reward redemption, and account credit for a given order total. Defaults to single-best-coupon + credit; multi-coupon stacking is flagged --experimental.

  _Family-size orders ($40+) hit reward thresholds where stacking actually saves real money — agents pick the optimal discount, not just the first valid coupon._

  ```bash
  pagliacci-pp-cli rewards stack --order-total 55.00 --agent
  ```
- **`orders summary`** — Aggregate orders over a time range with top items, store breakdown, and order frequency.

  _See the household's pizza pattern — what we order most, which store, how often — for budgeting or just fun._

  ```bash
  pagliacci-pp-cli orders summary --since 90d --agent
  ```

### Time-aware composed lookups
- **`store tonight`** — List stores that are still open and can deliver to your saved address right now, sorted by ETA.

  _Last-minute family dinner: only surface stores that will actually take the order tonight._

  ```bash
  pagliacci-pp-cli store tonight --address-label home --agent
  ```
- **`address best-time`** — Resolve a saved address label to the next available delivery slot in one call.

  _Schedule delivery to land at family dinner time — no separate zone lookup or slot search._

  ```bash
  pagliacci-pp-cli address best-time --label home --agent
  ```

### Order workflows
- **`orders reorder`** — Re-create a past order as a fresh cart, with price revalidation since prices change. Add --send to also submit.

  _Households have a usual order — replay it without rebuilding the cart line by line._

  ```bash
  pagliacci-pp-cli orders reorder --last --dry-run
  ```
- **`menu half-half`** — Build a half-and-half pizza in one command, with each side's toppings validated against the menu and priced via ProductPrice.

  _Families with picky kids order half-and-half pies as the default. One command produces a sendable cart entry for the most common household pizza shape._

  ```bash
  pagliacci-pp-cli menu half-half --left pepperoni --right cheese --size large --json
  ```
- **`orders plan`** — Given the number of people and a saved address, suggest a complete order plan: best store, delivery slot, sized cart contents, and the optimal discount stack.

  _Hosting 4–8 people: one command gives the agent everything it needs to confirm an order — no chained tool calls, no manual compose._

  ```bash
  pagliacci-pp-cli orders plan --people 6 --address-label home --json
  ```

## HTTP Transport

This CLI uses Chrome-compatible HTTP transport for browser-facing endpoints. It does not require a resident browser process for normal API calls.

## Discovery Signals

This CLI was generated with browser-observed traffic context.
- Capture coverage: 26 API entries from 26 total network entries
- Protocols: rest_json (98% confidence)
- Auth signals: composed — headers: Authorization — cookies: customerId, authToken
- Generation hints: requires_browser_auth, composed_auth
- Candidate command ideas: store list — GET /Store returned full inventory of locations; menu top — GET /MenuTop/{storeId} drives the home menu UI; menu cache — GET /MenuCache/{storeId} returns the full menu; menu slices — GET /MenuSlices returns today's slices across all stores; address lookup — POST /AddressInfo validates an address and resolves a delivery store; address list — GET /AddressName returns saved addresses; orders list — GET /OrderList/{page}/{size} returns paginated history; orders get — GET /OrderListItem/{id} returns full detail

## Command Reference

**account** — Authentication and registration (no auth required for these endpoints)

- `pagliacci-pp-cli account confirm_email` — Confirm a new account by clicking the email-confirmation link's token
- `pagliacci-pp-cli account create_token` — Issue a session token (used internally by the SPA for token refresh)
- `pagliacci-pp-cli account login` — Authenticate with email/phone + password. Response sets customerId and authToken cookies.
- `pagliacci-pp-cli account logout` — Invalidate the current session
- `pagliacci-pp-cli account password_forgot` — Request a password reset email
- `pagliacci-pp-cli account password_reset` — Reset a password using a token from PasswordForgot email
- `pagliacci-pp-cli account register` — Create a new customer account

**address** — Address validation and saved address book

- `pagliacci-pp-cli address create` — Create a new saved address
- `pagliacci-pp-cli address delete` — Delete a saved address
- `pagliacci-pp-cli address get` — Get a saved address by ID
- `pagliacci-pp-cli address get_info` — Get address info by saved ID
- `pagliacci-pp-cli address list` — List the authenticated user's saved addresses
- `pagliacci-pp-cli address lookup` — Validate an address and check delivery zone (returns store ID if deliverable)

**cart** — Build and price an order before sending it

- `pagliacci-pp-cli cart get_quote_building` — Get the current cart/quote-building state by building ID
- `pagliacci-pp-cli cart price_order` — Compute the total price for an order (cart contents, taxes, fees, delivery) before sending
- `pagliacci-pp-cli cart send_order` — Submit an order. Requires payment information for guests; uses stored payment for authenticated users.
- `pagliacci-pp-cli cart update_quote_building` — Update cart contents (add/remove/modify items)

**credit** — Account credit balance and entries

- `pagliacci-pp-cli credit delete` — Remove an account credit entry
- `pagliacci-pp-cli credit get` — Get a single credit entry
- `pagliacci-pp-cli credit list` — List the authenticated user's account credit entries

**customer** — Customer profile and devices

- `pagliacci-pp-cli customer access_devices_delete` — Revoke