Imported from mvanhorn/printing-press-library (
library/travel/japan-timed-tickets/AGENTS.md). Install upstream withnpx skills add mvanhorn/printing-press-library --skill japan-timed-tickets. Copyright stays with the author.
Japan Timed Tickets Printed CLI Agent Guide
This directory is a generated japan-timed-tickets-pp-cli printed CLI. It was produced by CLI Printing Press, so treat systemic fixes as upstream Printing Press fixes first. Keep local edits narrow and document why a generated-tree patch belongs here.
Local Operating Contract
Start by asking the generated CLI for current runtime truth:
japan-timed-tickets-pp-cli doctor --json
japan-timed-tickets-pp-cli agent-context --pretty
Use runtime discovery instead of relying on a copied command list:
japan-timed-tickets-pp-cli which "sunset slots" --json
japan-timed-tickets-pp-cli onsale --help
Add --agent to command invocations for JSON, compact output, non-interactive defaults, and no color:
japan-timed-tickets-pp-cli onsale --date 2026-11-24 --agent
This CLI is read-only: it never buys, adds to cart, logs in or joins a waiting room. --dry-run previews a command without network calls:
japan-timed-tickets-pp-cli availability teamlab-kyoto --date 2026-11-24 --dry-run --agent
--yes applies only to the local profile delete. --agent does not imply --yes.
Novel Command Data Sources
Every hand-written novel command must declare its strategy in a Go line comment:
// pp:data-source auto
Use exactly one of auto, local, live, or computed. Keep auto when the command honors --data-source auto|local|live by preferring live data with a local fallback; use local for local-only reads, live for remote-only reads, and computed for pure computation from embedded rules. Change a generated scaffold's auto default deliberately when its implementation has a narrower source, and keep cmd.Annotations["pp:data-source"] on the same command in sync; --agent envelopes read that annotation for meta.source. Reject incompatible --data-source requests with a clear error. TODO stubs still fail dogfood even when annotated.
Platform Credential References
Normal API authentication is separate from optional platform-source credential
resolution. If this CLI uses indirect references for a tenant-gated platform
source, add the downstream registration in a preserved hand-authored file
under internal/cli/ and provide both CredentialResolverFactory and
ValidateSourceProfile on platformSourceRegistration for any selected source
that has references. A source with no references may omit both hooks and receives
an empty credential map. Keep reference values opaque to shared profile code,
validate only the selected source in the downstream hook, and never persist
resolved credential bytes. Do not edit generator-owned internal/platform
packages; a reprint refreshes those files while retaining the downstream
registration file.
For install, auth, examples, and longer product guidance, read README.md and SKILL.md. This file intentionally stays small so repo-local agents get invariant local guidance without duplicating the generated docs.
Release Ledger
CHANGELOG.md and .printing-press-release.json are the public library's per-CLI release ledger. Fresh prints carry an unstamped runtime version such as 0.0.0-dev; the final YYYY.M.N CLI release version is assigned only after a publish PR merges in mvanhorn/printing-press-library. Do not hand-bump those files or edit var version = ... for release bookkeeping; preserve existing ledger files on reprint and let the library workflow stamp the next release.
Local Customizations
This directory is generated output -- a fresh print can overwrite the whole tree, so ad-hoc hand-edits don't survive on their own. If you modify the generated code, record each change under .printing-press-patches/ (parallel to .printing-press.json). Regen and publish-validate read those records and fail closed when a recorded file or call site is gone, so a dropped customization cannot ship as if it were still applied.
The entry shape, and the altitude to write it at -- a durable reprint-guard, not a changelog -- live in the public library's AGENTS.md, which is the single source of truth; this guide intentionally doesn't duplicate them.
