Pp Japan Bus Online

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/travel/japan-bus-online/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/". -->

Japan Bus Online

This CLI uses anonymous public English pages over standard Go HTTP. A browser is unnecessary at runtime. Source sessions are temporary and memory-only.

Use the existing local binary or build from this directory with go build -o build/japan-bus-online-pp-cli ./cmd/japan-bus-online-pp-cli, then add the build directory to PATH. The distribution instructions below require this package to be merged and included in the public catalog. Use this local build until distribution is available.

Prerequisites: Install the CLI

This skill drives the japan-bus-online-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 japan-bus-online --cli-only

2. Verify: japan-bus-online-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/japan-bus-online/cmd/japan-bus-online-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.

Workflow

Discover directional timetables, then check dated services and exact boarding-pair fares. Overnight dates and unknown capacity remain explicit.

1. Find the source course ID with routes list; retain its canonical URL.
2. Read bus route for direction IDs and the published timetable. Timetable rows do not prove seats are for sale.
3. Check bus services for an explicit YYYY-MM-DD JST service day. Retain service ID, both dates, availability and booking URL.
4. Run bus quote --include-stops to discover real stop IDs for that route, direction, service and fare plan. Repeat with selected stop IDs and party counts.
5. Read bus conditions and quote cancellation fees, then hand the canonical booking URL to the traveler.

Completion means source-grounded dates, stops, JPY fare assumptions and capacity uncertainty are clear. Booking, payment, cancellation and account history are outside this CLI.

Anti-triggers

Use another workflow for bookings, payments, cancellations, account history, guaranteed seat adjacency or group discounts.

Recipes

Bound discovery

japan-bus-online-pp-cli routes list --query Hamamatsu --limit 5 --agent --select routes.id,routes.name,routes.url

Return a compact route shortlist.

Evidence rules

• bus route.kind=published_schedule_not_inventory separates the timetable from saleable services. schedule_row is a display position, not a stop ID.
• Dates and timestamps use Asia/Tokyo. A departure at 25:00 boards at 01:00 on the next calendar day. Use boarding.timestamp_jst, rather than adding a second day to normalized times.
• sold_out, not_on_sale, unavailable_unknown_reason, no services and source date substitution have distinct meanings. An empty requested-day result does not imply sold out.
• Service availability describes the headline route. Quote party evidence uses the selected stop-pair fare table. Positive numeric seat counts are conservative lower bounds; a party larger than that count remains unknown. An explicit zero means capacity insufficient. A transaction limit is separate from capacity. Seat adjacency and gender or seat-plan feasibility remain unknown.
• Quote prices use source Adult and Child age labels in JPY for one way. The total is arithmetic, not a confirmed booking. Group discounts, roundtrip prices and unlabeled infant fares remain unknown. Missing cancellation fees are null; partial fetch failures are reported.
• Only --language en is verified. Names remain as the source supplies them; name_ja is null when no Japanese name exists.