pp-pagliacci

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Pagliacci Pizza — Printing Press CLI

Prerequisites: Install the CLI

前提条件：安装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:

Install via the Printing Press installer:

bash

npx -y @mvanhorn/printing-press install pagliacci --cli-only

Verify:
```
pagliacci-pp-cli --version
```
Ensure
```
$GOPATH/bin
```
(or
```
$HOME/go/bin
```
) is on
```
$PATH
```
.

If the

npx

install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.23+):

bash

go install github.com/mvanhorn/printing-press-library/library/food-and-dining/pagliacci/cmd/pagliacci-pp-cli@latest

--version

reports "command not found" after install, the install step did not put the binary on

$PATH

. Do not proceed with skill commands until verification succeeds.

本Skill驱动

pagliacci-pp-cli

二进制文件。在调用本Skill的任何命令之前，您必须确认CLI已安装。 如果未安装，请先执行以下步骤：

通过Printing Press安装器安装：

bash

npx -y @mvanhorn/printing-press install pagliacci --cli-only

验证：
```
pagliacci-pp-cli --version
```
确保
```
$GOPATH/bin
```
（或
```
$HOME/go/bin
```
）已添加到
```
$PATH
```
环境变量中。

如果

npx

安装失败（无Node环境、离线等），可改用Go直接安装（要求Go 1.23+版本）：

bash

go install github.com/mvanhorn/printing-press-library/library/food-and-dining/pagliacci/cmd/pagliacci-pp-cli@latest

如果安装后执行

--version

提示“command not found”，说明安装步骤未将二进制文件添加到

$PATH

中。在验证成功前，请不要执行Skill命令。

When to Use This CLI

何时使用本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.

当Agent或用户想要以编程方式与Pagliacci Pizza交互时使用本CLI：浏览菜单、查找门店和时间段、制作双拼披萨、规划小型派对订单、查看积分余额或重复过往订单。本CLI专为家庭或小型派对订购场景设计。

Unique Capabilities

独特功能

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

以下功能是其他同类型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
```

slices today
— 查看西雅图所有门店当前可订购的披萨切片，按与您保存地址的距离排序。
当家人问“今晚我们能订什么切片披萨？”时，该命令会返回一个统一的对比列表——无需逐个门店查看。
bash
```
pagliacci-pp-cli slices today --agent
```
rewards stack
— 根据给定的订单总额，计算优惠券、积分兑换和账户余额的最优组合使用方式。默认采用“最优单张优惠券+余额”模式；多优惠券叠加功能标记为--experimental（实验性）。
家庭规模的订单（40美元以上）会达到积分阈值，此时叠加优惠能节省不少钱——Agent会选择最优折扣方案，而非仅使用第一个有效的优惠券。
bash
```
pagliacci-pp-cli rewards stack --order-total 55.00 --agent
```
orders summary
— 按时间范围汇总订单，包含热门商品、门店分布和订购频率。
查看家庭的披萨订购模式——最常订购的品类、偏好门店、订购频率——用于预算规划或趣味统计。
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
```

store tonight
— 列出当前仍营业且可配送至您保存地址的门店，按预计送达时间排序。
临时决定的家庭晚餐：只显示今晚实际可接单的门店。
bash
```
pagliacci-pp-cli store tonight --address-label home --agent
```
address best-time
— 一键查询已保存地址对应的下一个可用配送时段。
将配送时间安排在家庭晚餐时段——无需单独查询配送区域或时段。
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
```

orders reorder
— 将过往订单重新创建为新购物车，并重新验证价格（因价格可能变动）。添加--send参数可直接提交订单。
家庭通常有固定的订购偏好——无需逐行重建购物车即可重复订购。
bash
```
pagliacci-pp-cli orders reorder --last --dry-run
```
menu half-half
— 一键制作双拼披萨，每半边的配料会根据菜单验证，并通过ProductPrice计算价格。
有挑食孩子的家庭通常会订购双拼披萨。一个命令即可生成可提交的购物车条目，满足最常见的家庭披萨需求。
bash
```
pagliacci-pp-cli menu half-half --left pepperoni --right cheese --size large --json
```
orders plan
— 根据人数和已保存地址，推荐完整的订单方案：最优门店、配送时段、合适分量的购物车内容，以及最优折扣组合。
招待4-8人：一个命令即可为Agent提供确认订单所需的全部信息——无需链式工具调用或手动组合。
bash
```
pagliacci-pp-cli orders plan --people 6 --address-label home --json
```

HTTP Transport

HTTP传输

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

本CLI使用兼容Chrome的HTTP传输来访问面向浏览器的接口。正常API调用不需要常驻浏览器进程。

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

本CLI是基于浏览器观测到的流量上下文生成的。

捕获覆盖：26个API条目（共26个网络条目）
协议：rest_json（98%置信度）
认证信号：组合式——请求头：Authorization — Cookie：customerId, authToken
生成提示：requires_browser_auth, composed_auth
候选命令思路：store list — GET /Store返回所有门店信息；menu top — GET /MenuTop/{storeId}驱动首页菜单UI；menu cache — GET /MenuCache/{storeId}返回完整菜单；menu slices — GET /MenuSlices返回当日所有门店的切片披萨；address lookup — POST /AddressInfo验证地址并解析配送门店；address list — GET /AddressName返回已保存地址；orders list — GET /OrderList/{page}/{size}返回分页历史订单；orders get — GET /OrderListItem/{id}返回订单详情

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 a device's access to the account

```
pagliacci-pp-cli customer access_devices_list
```
— List devices that have access to this account
```
pagliacci-pp-cli customer get
```
— Get customer profile by ID
```
pagliacci-pp-cli customer migrate_answer
```
— Submit the answer to a migration question
```
pagliacci-pp-cli customer migrate_question
```
— Submit a security/migration question (legacy account migration flow)

customer_feedback — Customer feedback submissions to Pagliacci

```
pagliacci-pp-cli customer_feedback get
```
— Get a feedback submission by ID
```
pagliacci-pp-cli customer_feedback submit
```
— Submit customer feedback (guest or authenticated)

gifts — Stored gift cards, balance lookup, and transfer

```
pagliacci-pp-cli gifts check
```
— Check the balance of a gift card by ID and PIN (no auth required to check)
```
pagliacci-pp-cli gifts delete
```
— Remove a stored gift card from the account
```
pagliacci-pp-cli gifts get
```
— Get a single stored gift card by ID
```
pagliacci-pp-cli gifts list
```
— List the authenticated user's stored gift cards
```
pagliacci-pp-cli gifts transfer
```
— Transfer gift card balance to another account
```
pagliacci-pp-cli gifts value
```
— Get current value/balance of a saved gift card

menu — Menus, slices, and product pricing

```
pagliacci-pp-cli menu cache
```
— Get the full menu (categories, products, prices, descriptions, images) for a store
```
pagliacci-pp-cli menu product_price
```
— Calculate the price for a customized product (size, toppings, modifiers)
```
pagliacci-pp-cli menu slices
```
— Get available slices across all stores for the current day (perishable, rotates daily)
```
pagliacci-pp-cli menu top
```
— Get featured top-of-menu items for a store

orders — Order history and details

```
pagliacci-pp-cli orders clone
```
— Get order data shaped for re-ordering (transforms a past order into a new cart)
```
pagliacci-pp-cli orders get
```
— Get the full detail of a single past order (items, prices, store, time)
```
pagliacci-pp-cli orders list
```
— List the authenticated user's order history (paginated)
```
pagliacci-pp-cli orders list_gift_cards
```
— List orders that purchased gift cards
```
pagliacci-pp-cli orders list_pending
```
— List orders that are currently in flight (placed but not yet delivered/picked up)
```
pagliacci-pp-cli orders suggestion
```
— Get personalized order suggestions for a customer

rewards — Loyalty card, rewards history, and stored coupons

```
pagliacci-pp-cli rewards card
```
— Get the authenticated user's reward card balance, points, and available rewards
```
pagliacci-pp-cli rewards coupon_lookup
```
— Look up a coupon by its serial number (validate before applying)
```
pagliacci-pp-cli rewards history
```
— Get reward earning/redemption history (most recent N entries)
```
pagliacci-pp-cli rewards stored_coupons
```
— List coupons saved to the authenticated user's account

scheduling — Delivery and pickup time windows

```
pagliacci-pp-cli scheduling slot_list
```
— List available time-window slots for a store and service type
```
pagliacci-pp-cli scheduling slot_list_for_date
```
— List allowed slot times for a specific delivery/pickup date (YYYYMMDD)
```
pagliacci-pp-cli scheduling window_days
```
— List available delivery or pickup days for a store. serviceType is DEL (delivery) or PICK (pickup)

store — Pagliacci store locations, hours, and quote info

```
pagliacci-pp-cli store compute_quote
```
— Compute a quote for a specific store with cart contents (returns Delivery, Drone, Pickup wait values)
```
pagliacci-pp-cli store get
```
— Get a single store by its numeric ID
```
pagliacci-pp-cli store get_quote
```
— Get quote-store metadata (delivery fee, drone status, pickup wait time) for a single store
```
pagliacci-pp-cli store list
```
— List all Pagliacci store locations with addresses, hours, GPS, amenities, and available slices
```
pagliacci-pp-cli store list_quotes
```
— List quote-store metadata (delivery fee, drone status, pickup wait) for all stores

system — System information and announcements

```
pagliacci-pp-cli system site_wide_message
```
— Get site-wide announcement banner text (closures, holiday hours, etc.)
```
pagliacci-pp-cli system version
```
— Get the current API version

account — 认证与注册（这些接口无需认证）

```
pagliacci-pp-cli account confirm_email
```
— 通过点击邮件确认链接中的令牌来确认新账户
```
pagliacci-pp-cli account create_token
```
— 生成会话令牌（供SPA内部用于令牌刷新）
```
pagliacci-pp-cli account login
```
— 使用邮箱/手机号+密码进行认证。响应会设置customerId和authToken Cookie。
```
pagliacci-pp-cli account logout
```
— 使当前会话失效

pagliacci-pp-cli account password_forgot

— 请求重置密码邮件

```
pagliacci-pp-cli account password_reset
```
— 使用PasswordForgot邮件中的令牌重置密码
```
pagliacci-pp-cli account register
```
— 创建新客户账户

address — 地址验证与已保存地址簿

```
pagliacci-pp-cli address create
```
— 创建新的已保存地址
```
pagliacci-pp-cli address delete
```
— 删除已保存地址
```
pagliacci-pp-cli address get
```
— 通过ID获取已保存地址
```
pagliacci-pp-cli address get_info
```
— 通过已保存ID获取地址信息
```
pagliacci-pp-cli address list
```
— 列出已认证用户的所有已保存地址
```
pagliacci-pp-cli address lookup
```
— 验证地址并检查配送区域（如果可配送则返回门店ID）

cart — 提交前构建并计算订单价格

```
pagliacci-pp-cli cart get_quote_building
```
— 通过构建ID获取当前购物车/报价构建状态
```
pagliacci-pp-cli cart price_order
```
— 计算订单总价（购物车内容、税费、服务费、配送费），无需提交订单
```
pagliacci-pp-cli cart send_order
```
— 提交订单。访客需要支付信息；已认证用户使用已存储的支付方式。
```
pagliacci-pp-cli cart update_quote_building
```
— 更新购物车内容（添加/删除/修改商品）

credit — 账户余额与记录

```
pagliacci-pp-cli credit delete
```
— 删除账户余额记录
```
pagliacci-pp-cli credit get
```
— 获取单个余额记录
```
pagliacci-pp-cli credit list
```
— 列出已认证用户的所有账户余额记录

customer — 客户资料与设备

pagliacci-pp-cli customer access_devices_delete

— 撤销设备对账户的访问权限

pagliacci-pp-cli customer access_devices_list

— 列出有权访问本账户的设备

```
pagliacci-pp-cli customer get
```
— 通过ID获取客户资料

pagliacci-pp-cli customer migrate_answer

— 提交迁移问题的答案

```
pagliacci-pp-cli customer migrate_question
```
— 提交安全/迁移问题（遗留账户迁移流程）

customer_feedback — 向Pagliacci提交客户反馈

```
pagliacci-pp-cli customer_feedback get
```
— 通过ID获取反馈提交记录
```
pagliacci-pp-cli customer_feedback submit
```
— 提交客户反馈（访客或已认证用户均可）

gifts — 已存储礼品卡、余额查询与转账

```
pagliacci-pp-cli gifts check
```
— 通过ID和PIN查询礼品卡余额（无需认证即可查询）
```
pagliacci-pp-cli gifts delete
```
— 从账户中移除已存储的礼品卡
```
pagliacci-pp-cli gifts get
```
— 通过ID获取单个已存储礼品卡
```
pagliacci-pp-cli gifts list
```
— 列出已认证用户的所有已存储礼品卡
```
pagliacci-pp-cli gifts transfer
```
— 将礼品卡余额转账至其他账户
```
pagliacci-pp-cli gifts value
```
— 获取已保存礼品卡的当前余额

menu — 菜单、切片披萨与商品定价

```
pagliacci-pp-cli menu cache
```
— 获取指定门店的完整菜单（分类、商品、价格、描述、图片）
```
pagliacci-pp-cli menu product_price
```
— 计算定制商品的价格（尺寸、配料、修饰项）
```
pagliacci-pp-cli menu slices
```
— 获取当日所有门店的可用切片披萨（每日轮换）
```
pagliacci-pp-cli menu top
```
— 获取指定门店的首页热门商品

orders — 订单历史与详情

```
pagliacci-pp-cli orders clone
```
— 获取用于重新订购的订单数据（将过往订单转换为新购物车）
```
pagliacci-pp-cli orders get
```
— 获取单个过往订单的完整详情（商品、价格、门店、时间）
```
pagliacci-pp-cli orders list
```
— 列出已认证用户的订单历史（分页）
```
pagliacci-pp-cli orders list_gift_cards
```
— 列出购买礼品卡的订单
```
pagliacci-pp-cli orders list_pending
```
— 列出当前处理中的订单（已下单但未配送/取货）
```
pagliacci-pp-cli orders suggestion
```
— 获取针对客户的个性化订单建议

rewards — 积分卡、积分历史与已存储优惠券

```
pagliacci-pp-cli rewards card
```
— 获取已认证用户的积分卡余额、积分和可用奖励
```
pagliacci-pp-cli rewards coupon_lookup
```
— 通过序列号查询优惠券（应用前验证）
```
pagliacci-pp-cli rewards history
```
— 获取积分获取/兑换历史（最近N条记录）
```
pagliacci-pp-cli rewards stored_coupons
```
— 列出已保存到已认证用户账户的优惠券

scheduling — 配送与取货时间段

```
pagliacci-pp-cli scheduling slot_list
```
— 列出指定门店和服务类型的可用时间段
```
pagliacci-pp-cli scheduling slot_list_for_date
```
— 列出指定配送/取货日期（YYYYMMDD）的允许时间段
```
pagliacci-pp-cli scheduling window_days
```
— 列出指定门店的可用配送或取货日期。serviceType为DEL（配送）或PICK（取货）

store — Pagliacci门店位置、营业时间与报价信息

```
pagliacci-pp-cli store compute_quote
```
— 计算指定门店的订单报价（返回配送、无人机配送、取货等待时间）
```
pagliacci-pp-cli store get
```
— 通过数字ID获取单个门店信息
```
pagliacci-pp-cli store get_quote
```
— 获取指定门店的报价元数据（配送费、无人机状态、取货等待时间）
```
pagliacci-pp-cli store list
```
— 列出所有Pagliacci门店的位置、地址、营业时间、GPS坐标、设施和可用切片披萨
```
pagliacci-pp-cli store list_quotes
```
— 列出所有门店的报价元数据（配送费、无人机状态、取货等待时间）

system — 系统信息与公告

```
pagliacci-pp-cli system site_wide_message
```
— 获取全站公告横幅文本（闭店通知、节假日营业时间等）
```
pagliacci-pp-cli system version
```
— 获取当前API版本

Freshness Contract

新鲜度协议

This printed CLI owns bounded freshness only for registered store-backed read command paths. In

--data-source auto

mode, those paths check

sync_state

and may run a bounded refresh before reading local data.

--data-source local

never refreshes.

--data-source live

reads the API and does not mutate the local store. Set

PAGLIACCI_NO_AUTO_REFRESH=1

to skip the freshness hook without changing source selection.

Covered paths:

```
pagliacci-pp-cli address
```
```
pagliacci-pp-cli address create
```
```
pagliacci-pp-cli address delete
```
```
pagliacci-pp-cli address get
```
```
pagliacci-pp-cli address get_info
```
```
pagliacci-pp-cli address list
```
```
pagliacci-pp-cli address lookup
```
```
pagliacci-pp-cli credit
```
```
pagliacci-pp-cli credit delete
```
```
pagliacci-pp-cli credit get
```
```
pagliacci-pp-cli credit list
```
```
pagliacci-pp-cli customer
```

pagliacci-pp-cli customer access_devices_delete

pagliacci-pp-cli customer access_devices_list

```
pagliacci-pp-cli customer get
```

pagliacci-pp-cli customer migrate_answer

pagliacci-pp-cli customer migrate_question

```
pagliacci-pp-cli gifts
```
```
pagliacci-pp-cli gifts check
```
```
pagliacci-pp-cli gifts delete
```
```
pagliacci-pp-cli gifts get
```
```
pagliacci-pp-cli gifts list
```
```
pagliacci-pp-cli gifts transfer
```
```
pagliacci-pp-cli gifts value
```
```
pagliacci-pp-cli orders
```
```
pagliacci-pp-cli orders clone
```
```
pagliacci-pp-cli orders get
```
```
pagliacci-pp-cli orders list
```
```
pagliacci-pp-cli orders list_gift_cards
```
```
pagliacci-pp-cli orders list_pending
```
```
pagliacci-pp-cli orders suggestion
```
```
pagliacci-pp-cli store
```
```
pagliacci-pp-cli store compute_quote
```
```
pagliacci-pp-cli store get
```
```
pagliacci-pp-cli store get_quote
```
```
pagliacci-pp-cli store list
```
```
pagliacci-pp-cli store list_quotes
```

When JSON output uses the generated provenance envelope, freshness metadata appears at

meta.freshness

. Treat it as current-cache freshness for the covered command path, not a guarantee of complete historical backfill or API-specific enrichment.

本打印版CLI仅对已注册的门店支持型读取命令路径提供有限新鲜度保障。在

--data-source auto

模式下，这些路径会检查

sync_state

，并可能在读取本地数据前执行有限刷新。

--data-source local

模式从不刷新。

--data-source live

模式直接读取API，不修改本地存储。设置

PAGLIACCI_NO_AUTO_REFRESH=1

可跳过新鲜度检查，无需更改数据源选择。

覆盖的路径：

```
pagliacci-pp-cli address
```
```
pagliacci-pp-cli address create
```
```
pagliacci-pp-cli address delete
```
```
pagliacci-pp-cli address get
```
```
pagliacci-pp-cli address get_info
```
```
pagliacci-pp-cli address list
```
```
pagliacci-pp-cli address lookup
```
```
pagliacci-pp-cli credit
```
```
pagliacci-pp-cli credit delete
```
```
pagliacci-pp-cli credit get
```
```
pagliacci-pp-cli credit list
```
```
pagliacci-pp-cli customer
```

pagliacci-pp-cli customer access_devices_delete

pagliacci-pp-cli customer access_devices_list

```
pagliacci-pp-cli customer get
```

pagliacci-pp-cli customer migrate_answer

pagliacci-pp-cli customer migrate_question

```
pagliacci-pp-cli gifts
```
```
pagliacci-pp-cli gifts check
```
```
pagliacci-pp-cli gifts delete
```
```
pagliacci-pp-cli gifts get
```
```
pagliacci-pp-cli gifts list
```
```
pagliacci-pp-cli gifts transfer
```
```
pagliacci-pp-cli gifts value
```
```
pagliacci-pp-cli orders
```
```
pagliacci-pp-cli orders clone
```
```
pagliacci-pp-cli orders get
```
```
pagliacci-pp-cli orders list
```
```
pagliacci-pp-cli orders list_gift_cards
```
```
pagliacci-pp-cli orders list_pending
```
```
pagliacci-pp-cli orders suggestion
```
```
pagliacci-pp-cli store
```
```
pagliacci-pp-cli store compute_quote
```
```
pagliacci-pp-cli store get
```
```
pagliacci-pp-cli store get_quote
```
```
pagliacci-pp-cli store list
```
```
pagliacci-pp-cli store list_quotes
```

当JSON输出使用生成的来源信封时，新鲜度元数据会显示在

meta.freshness

字段中。将其视为覆盖命令路径的当前缓存新鲜度，而非完整历史回填或API特定增强的保证。

Finding the right command

查找合适的命令

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

bash

pagliacci-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

means at least one match; exit code

means no confident match — fall back to

--help

or use a narrower query.

当您知道要做什么但不知道对应的命令时，可直接询问CLI：

bash

pagliacci-pp-cli which "<用您自己的话描述功能>"

which

命令会将自然语言功能查询解析为CLI精选功能索引中最匹配的命令。退出码

表示至少有一个匹配项；退出码

表示没有确定的匹配项——请回退到

--help

或使用更精确的查询。

Recipes

使用示例

What can we eat tonight?

今晚我们能吃什么？

bash

pagliacci-pp-cli slices today --agent --select store,slice,price

Returns today's available slices across all stores with just the high-gravity fields for fast agent decision making.

bash

pagliacci-pp-cli slices today --agent --select store,slice,price

返回当日所有门店的可用切片披萨，仅保留关键字段，便于Agent快速决策。

Plan a small-party order for 6

为6人规划小型派对订单

bash

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

Composes store proximity, delivery slot, sized cart, and discount stack into one recommendation.

bash

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

将门店距离、配送时段、合适分量的购物车和折扣组合整合为一个推荐方案。

Build a half-and-half family pizza

制作双拼家庭披萨

bash

pagliacci-pp-cli menu half-half --left pepperoni --right cheese --size large --json

Validates both halves against the menu and returns a priced, sendable cart entry.

bash

pagliacci-pp-cli menu half-half --left pepperoni --right cheese --size large --json

验证双拼披萨的两边配料是否符合菜单要求，并返回已定价、可提交的购物车条目。

Replay last order

重复上一次订单

bash

pagliacci-pp-cli orders reorder --last --dry-run --json

Pulls the most recent OrderListItem, transforms via OrderClone, re-prices, and returns a sendable cart without submitting.

bash

pagliacci-pp-cli orders reorder --last --dry-run --json

获取最近的OrderListItem，通过OrderClone转换，重新定价，并返回可提交的购物车，但不实际提交。

Maximize discount before checkout

结账前最大化折扣

bash

pagliacci-pp-cli rewards stack --order-total 55.00 --agent

Computes the best application of saved coupons, reward redemption, and account credit for a given order total.

bash

pagliacci-pp-cli rewards stack --order-total 55.00 --agent

根据给定的订单总额，计算已保存优惠券、积分兑换和账户余额的最优组合使用方式。

Auth Setup

认证设置

Pagliacci has no public API and uses a custom composed

PagliacciAuth {customerId}|{authToken}

header constructed from cookies. Run

pagliacci-pp-cli auth login --chrome

while logged into pagliacci.com in Chrome — the CLI reads the auth cookies and constructs the header for you. Public commands (menu, stores, slices, time-windows) work without login; authenticated commands (order history, rewards, saved addresses) require the Chrome session.

Run

pagliacci-pp-cli doctor

to verify setup.

Pagliacci没有公开API，使用自定义的组合式

PagliacciAuth {customerId}|{authToken}

请求头，由Cookie构造而成。当您在Chrome中登录pagliacci.com后，运行

pagliacci-pp-cli auth login --chrome

——CLI会读取认证Cookie并为您构造请求头。公开命令（菜单、门店、切片披萨、时间段）无需登录；需认证的命令（订单历史、积分、已保存地址）需要Chrome会话。

运行

pagliacci-pp-cli doctor

验证设置是否正确。

Agent Mode

Agent模式

Add

--agent

to any command. Expands to:

--json --compact --no-input --no-color --yes

Pipeable — JSON on stdout, errors on stderr
Filterable —
```
--select
```
keeps a subset of fields. Dotted paths descend into nested structures; arrays traverse element-wise. Critical for keeping context small on verbose APIs:
bash
```
pagliacci-pp-cli address list --agent --select id,name,status
```
Previewable —
```
--dry-run
```
shows the request without sending
Offline-friendly — sync/search commands can use the local SQLite store when available
Non-interactive — never prompts, every input is a flag

在任何命令后添加

--agent

参数。等效于：

--json --compact --no-input --no-color --yes

。

可管道传输 — 标准输出为JSON，错误信息输出到标准错误
可过滤 —
```
--select
```
参数保留字段子集。点路径可深入嵌套结构；数组可遍历元素。对于冗长的API，这是保持上下文简洁的关键：
bash
```
pagliacci-pp-cli address list --agent --select id,name,status
```
可预览 —
```
--dry-run
```
参数显示请求但不发送
离线友好 — 同步/搜索命令在可用时可使用本地SQLite存储
非交互式 — 从不提示，所有输入均通过标志参数提供

Response envelope

响应信封

Commands that read from the local store or the API wrap output in a provenance envelope:

json

{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

Parse

.results

for data and

.meta.source

to know whether it's live or local. A human-readable

N results (live)

summary is printed to stderr only when stdout is a terminal — piped/agent consumers get pure JSON on stdout.

从本地存储或API读取数据的命令会将输出包装在来源信封中：

json

{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

解析

.results

字段获取数据，

.meta.source

字段表示数据是实时的还是本地的。仅当标准输出为终端时，才会向标准错误输出人类可读的

N results (live)

摘要——管道/Agent消费者仅会在标准输出获取纯JSON。

Agent Feedback

Agent反馈

When you (or the agent) notice something off about this CLI, record it:

pagliacci-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
pagliacci-pp-cli feedback --stdin < notes.txt
pagliacci-pp-cli feedback list --json --limit 10

Entries are stored locally at

~/.pagliacci-pp-cli/feedback.jsonl

. They are never POSTed unless

PAGLIACCI_FEEDBACK_ENDPOINT

is set AND either

--send

is passed or

PAGLIACCI_FEEDBACK_AUTO_SEND=true

. Default behavior is local-only.

Write what surprised you, not a bug report. Short, specific, one line: that is the part that compounds.

当您（或Agent）发现本CLI存在问题时，请记录反馈：

pagliacci-pp-cli feedback "--since参数是包含性的，但文档说是排他性的"
pagliacci-pp-cli feedback --stdin < notes.txt
pagliacci-pp-cli feedback list --json --limit 10

反馈记录存储在本地

~/.pagliacci-pp-cli/feedback.jsonl

文件中。除非设置了

PAGLIACCI_FEEDBACK_ENDPOINT

且传递了

--send

参数或设置了

PAGLIACCI_FEEDBACK_AUTO_SEND=true

，否则反馈记录不会被POST提交。默认行为仅存储在本地。

请写下让您感到意外的内容，而非正式的错误报告。简短、具体、单行记录：这样的反馈才会产生价值。

Output Delivery

输出交付

Every command accepts

--deliver <sink>

. The output goes to the named sink in addition to (or instead of) stdout, so agents can route command results without hand-piping. Three sinks are supported:

Sink	Effect
`stdout`	Default; write to stdout only
`file:<path>`	Atomically write output to `<path>` (tmp + rename)
`webhook:<url>`	POST the output body to the URL ( `application/json` or `application/x-ndjson` when `--compact` )

Unknown schemes are refused with a structured error naming the supported set. Webhook failures return non-zero and log the URL + HTTP status on stderr.

每个命令都支持

--deliver <sink>

参数。输出会发送到指定的接收器，同时（或替代）标准输出，以便Agent无需手动管道即可路由命令结果。支持三种接收器：

接收器	效果
`stdout`	默认；仅输出到标准输出
`file:<path>`	原子性地将输出写入 `<path>` （先写入临时文件再重命名）
`webhook:<url>`	将输出体POST到指定URL（ `application/json` 格式；使用 `--compact` 时为 `application/x-ndjson` 格式）

不支持的协议会返回结构化错误，并列出支持的接收器类型。Webhook失败会返回非零退出码，并在标准错误输出URL和HTTP状态码。

Named Profiles

命名配置文件

A profile is a saved set of flag values, reused across invocations. Use it when a scheduled agent calls the same command every run with the same configuration - HeyGen's "Beacon" pattern.

pagliacci-pp-cli profile save briefing --json
pagliacci-pp-cli --profile briefing address list
pagliacci-pp-cli profile list --json
pagliacci-pp-cli profile show briefing
pagliacci-pp-cli profile delete briefing --yes

Explicit flags always win over profile values; profile values win over defaults.

agent-context

lists all available profiles under

available_profiles

so introspecting agents discover them at runtime.

配置文件是一组保存的标志值，可在多次调用中复用。当调度Agent每次运行都使用相同配置调用同一命令时使用此功能——即HeyGen的“Beacon”模式。

pagliacci-pp-cli profile save briefing --json
pagliacci-pp-cli --profile briefing address list
pagliacci-pp-cli profile list --json
pagliacci-pp-cli profile show briefing
pagliacci-pp-cli profile delete briefing --yes

显式标志始终优先于配置文件值；配置文件值优先于默认值。

agent-context

会在

available_profiles

下列出所有可用配置文件，以便内省Agent在运行时发现它们。

Exit Codes

退出码

Code	Meaning
0	Success
2	Usage error (wrong arguments)
3	Resource not found
4	Authentication required
5	API error (upstream issue)
7	Rate limited (wait and retry)
10	Config error

代码	含义
0	成功
2	使用错误（参数错误）
3	资源未找到
4	需要认证
5	API错误（上游问题）
7	速率限制（请等待后重试）
10	配置错误

Argument Parsing

参数解析

Parse

$ARGUMENTS

Empty,
help
, or
--help
→ show
```
pagliacci-pp-cli --help
```
output
Starts with
install
→ ends with
```
mcp
```
→ MCP installation; otherwise → see Prerequisites above
Anything else → Direct Use (execute as CLI command with
```
--agent
```
)

解析

$ARGUMENTS

：

为空、
help
或
--help
→ 显示
```
pagliacci-pp-cli --help
```
输出
以
install
开头 → 结尾为
```
mcp
```
→ MCP安装；否则 → 参见顶部的前提条件
其他情况 → 直接使用（以
```
--agent
```
标志执行CLI命令）

MCP Server Installation

MCP服务器安装

Install the MCP server:

bash

go install github.com/mvanhorn/printing-press-library/library/food-and-dining/pagliacci/cmd/pagliacci-pp-mcp@latest

bash

claude mcp add pagliacci-pp-mcp -- pagliacci-pp-mcp

Verify:
```
claude mcp list
```

安装MCP服务器：

bash

go install github.com/mvanhorn/printing-press-library/library/food-and-dining/pagliacci/cmd/pagliacci-pp-mcp@latest

注册到Claude Code：

bash

claude mcp add pagliacci-pp-mcp -- pagliacci-pp-mcp

验证：
```
claude mcp list
```

Direct Use

直接使用

Check if installed:
```
which pagliacci-pp-cli
```
If not found, offer to install (see Prerequisites at the top of this skill).
Match the user query to the best command from the Unique Capabilities and Command Reference above.

Execute with the

--agent

flag:

bash

pagliacci-pp-cli <command> [subcommand] [args] --agent

If ambiguous, drill into subcommand help:
```
pagliacci-pp-cli <command> --help
```
.

检查是否已安装：
```
which pagliacci-pp-cli
```
如果未找到，提供安装选项（参见顶部的前提条件）。
将用户查询与上述独特功能和命令参考中的最佳命令匹配。

使用

--agent

标志执行：

bash

pagliacci-pp-cli <command> [subcommand] [args] --agent

如果存在歧义，查看子命令帮助：
```
pagliacci-pp-cli <command> --help
```
。