pp-asoview

Imported from mvanhorn/printing-press-library (cli-skills/pp-asoview/SKILL.md). Install upstream with npx skills add mvanhorn/printing-press-library --skill pp-asoview. Copyright stays with the author (Apache-2.0).

Asoview

Local build (current release)

Use the local build from this project or its promoted local library copy. It has not been published to a registry. From the project:

go build -o asoview-pp-cli ./cmd/asoview-pp-cli
./asoview-pp-cli --version

Resolve asoview-pp-cli from the local build path before running examples below. Requires Go 1.26.6 or newer to build; no credentials or paid account for the verified public surface.

When to Use This CLI

Find Asoview leisure tickets and experiences in Japan, compare terms, inspect dated public stock and fee bands, and hand off a canonical booking URL. Japanese content is the verified first-party language surface.

Anti-triggers

Purchases, reservations, ticket holds, account/history access, other providers and guaranteed checkout quotes belong to other workflows.

Operating steps

1. Resolve source IDs with inventory --kind regions or inventory --kind categories. Exact Japanese names or IDs work in filters.
2. Run discover with native region/category/date/party filters. Use --query only as a local substring over bounded scanned cards. Inspect coverage.partial and coverage.next_cursor before interpreting an empty result.
3. Fetch only shortlisted product details. Undated prices are advertised bands; lowest ticket price may be a child band. Use --full only when descriptions/manuals are needed.
4. Use availability for one date or calendar month. Preserve unknown/request-only/closed/sold-out distinctions, source units and timestamps. Date validity and opening hours do not create a reserved slot.
5. Use dated options when exact bands matter; select --slot from returned source slots when required. --party calculates an unconfirmed subtotal with exclusions, not a checkout quote. Preserve product and dated band age labels when they differ.
6. Finish with handoff. It derives the canonical URL; current existence is verified by product, not handoff alone.

Unique Capabilities

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

Japan leisure planning

• compare — Compare a bounded shortlist and preserve missing values.

  Compare a bounded shortlist and preserve missing values.

  asoview-pp-cli compare ticket0000049223 ticket0000012233 --agent

• discover — Filter Japanese names without claiming a global keyword index.

  Filter Japanese names without claiming a global keyword index.

  asoview-pp-cli discover --region prf130000 --category 192 --query 葛西 --agent

• availability — Inspect public stock for a date and quantity.

  Inspect public stock for a date and quantity.

  asoview-pp-cli availability ticket0000049223 --date 2026-10-02 --agent

• options — Read exact date-specific price units and age labels.

  Read exact date-specific price units and age labels.

  asoview-pp-cli options pln3000044589 --date 2026-10-03 --agent

• inventory — Resolve region/category IDs with explicit refresh control.

  Resolve region/category IDs with explicit refresh control.

  asoview-pp-cli inventory --kind categories --query 水族館 --agent

Worked examples

asoview-pp-cli discover --region prf130000 --category 192 --agent --select meta,results.id,results.name_ja,results.booking_url
asoview-pp-cli product ticket0000049223 --agent
asoview-pp-cli availability ticket0000049223 --date 2026-10-02 --quantity 2 --agent
asoview-pp-cli options ticket0000049223 --date 2026-10-02 --party 2411665:2,2411667:1 --agent
asoview-pp-cli compare ticket0000049223 ticket0000012233 --agent
asoview-pp-cli inventory --kind categories --query 水族館 --refresh-inventory --agent

Replace dates with the intended Japan local date. Units, fees, cancellation conditions and limits come from source data; missing facts remain null. meta.sources carries freshness and meta.metrics carries actual network/cache work. Explicit projection can omit metadata.

Health and failures

Use doctor --json, command help or agent-context --pretty for runtime truth. Business stdout is compact JSON and diagnostics are stderr. Input/schema/source failures exit nonzero; empty discovery is a successful bounded scan, not a network failure.

Use --refresh for a fresh requested response, --no-cache to bypass cache, or --data-source local for fresh cache only. --data-source live bypasses business caching. Inventory refresh requires --refresh-inventory; default inventory reads never fetch the complete taxonomy.

Read README.md for exact limits, price/entry semantics and canonical evidence paths. Completion requires a relevant shortlist, verified requested public facts or explicit unknown coverage, and a canonical URL; no booking action is performed.

Future published-release reference

The following generator-owned reference applies only after a public registry release exists. This build is unpublished: use the local build instructions above; registry install commands are currently unavailable.

Prerequisites: Install the CLI

This skill drives the asoview-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 asoview --cli-only

2. Verify: asoview-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). This installs into $GOPATH/bin (default $HOME/go/bin), so add that directory to $PATH instead:

go install github.com/mvanhorn/printing-press-library/library/travel/asoview/cmd/asoview-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.

Bounded first-party discovery, lazy detail and honest date/party coverage. Human handoff only.

Recipes

Small shortlist

asoview-pp-cli discover --region prf130000 --category 192 --agent --select results.id,results.name_ja,results.booking_url

Project only handoff fields.

Dated stock

asoview-pp-cli availability ticket0000049223 --date 2026-10-02 --agent

Stock is a snapshot, no booking.

Terms comparison

asoview-pp-cli compare ticket0000049223 ticket0000012233 --agent

Compare advertised bands and ticket terms.

Auth Setup

Selected public GETs need no credentials or paid account.

Run asoview-pp-cli doctor to verify setup.