Limits and Honesty

What the CLI and docs do not overclaim.

Versioning

• Document the CLI package version (postsale --version; postsale doctor adds checks.build.commit).
• The CLI ships as a signed, self-contained program (no runtime needed). A public one-line install channel is still rolling out; until then the program is distributed directly.

Platform / backend seams

Known platform issues are tracked internally and are not documented here; this page covers only what the CLI itself can promise.

Dry-run is not "no writes"

Only the intercepted set is simulated. Order/shipment field edits, tags, and filter create/update can still hit the API under --dry-run.

Parallel batches keyword gate

Read-only batches can fail closed on money-adjacent wording. Not a bug to "bypass" - reword the template.

Model behavior

LLM choice of tools can flake (wrong tool, premature stop, dry-run still proposing money wording). Hosts should enforce gates in the CLI (already) and not rely solely on model compliance.

Carrier outcomes

Rate quotes, voids, and refunds depend on carrier accounts and network state. Reprint is not a free re-purchase.

Schema list ≠ full CLI

See cli-only-commands.md.

MCP / Desktop

Separate product surface - cross-link only (docs/mcp-transfer/).

Request attribution

User-Agent format is intentional platform citizenship - do not spoof.