Pp Sunflower Ferry

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

Sunflower Ferry — Printing Press CLI

Source and planning boundaries

Use the structured planning commands: routes list, routes search, routes show, calendar, sailings, quote, cabins, ports, conditions, and handoff. The source commands are lower-level public-page metadata; they do not produce the typed planning facts. Verified coverage is Osaka–Beppu, Kobe–Oita and Osaka–Shibushi in both directions. Keep Osaka Terminal 1 (Beppu) and Terminal 2 (Shibushi) distinct. Oarai–Tomakomai is outside this build's verified booking-system scope.

For dates, use exact YYYY-MM-DD Japan boarding dates. Quotes/sailings require future or same-day dates within the published three-month booking window; replace the dated examples when necessary. routes show is a normal weekday pattern, while sailings reads the actual anonymous date lookup. calendar preserves missing dates and explicit coverage; E is a special daytime cruise. Never infer an ordinary overnight sailing from E or an unpublished date.

For party quotes, preserve school stage: adults are junior-high-or-older; elementary-school students remain children even at 12. Toddlers are preschool children aged 1+; infants are under 1. --mode car requires --car-category lt3m|lt4m|lt5m|lt6m with strict length bounds. --mode bike requires --bike-category over750cc|le750cc|le125cc|bicycle --bikes N, with no more bikes than adults. The source limits adults plus children to 14, one car/room and up to two medium pet cages. Special discounts, trucks, room charges, roundtrip/Dangan and unsupported cases require the reservation center.

Treat every cabin price as the source's displayed price for the exact entered one-way configuration. Fuel/tax/fee breakdown and final payable price remain unverified; no hand-built fare arithmetic. --cabin-id only filters returned rows. Availability symbols are snapshots, and missing rooms may be unavailable or ineligible. Quotes never select a cabin, reserve inventory or create a hold. handoff returns the canonical URL and context without prefilling it. July 2025 marketing fare examples are historical and excluded.

Planning JSON has data, source meta and warnings; --agent wraps this document in results. Use --select data.quote.sailings, --select data.calendar, or --select data.cabins as appropriate. Domain facts are already bounded, so agent compact mode preserves their uncertainty/provenance. Inspect meta.observed_at and source URLs. Offline route metadata identifies its reference verification date; dynamic fares, calendars and access pages are fetched live. No source session or credential is persisted.

The official FAQ lists daily booking-system maintenance from 03:00 to 05:00 JST. During source maintenance, quote and sailings return an explicit error; inventory remains unknown. Try the read-only lookup again after the published window and confirm actual recovery.

conditions distinguishes the carried-item definition (sum of three dimensions ≤2 m and per-item weight ≤30 kg) from the aggregate free carried-baggage weight (≤20 kg). The English cancellation summary omits the day-before band; the linked Japanese common passenger conditions supply normal-ticket rates/minimums. Confirm agency/campaign/vehicle conditions. English check-in guidance recommends 60 minutes and may refuse boarding within 30 minutes; confirm earlier vehicle/seasonal requirements. Access times/fares are undated reference guidance. Never promise inventory, eligibility, punctuality or final price.

Prerequisites: Install the CLI

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

2. Verify: sunflower-ferry-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/sunflower-ferry/cmd/sunflower-ferry-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.

Query the anonymous fare simulator, compare seasonal calendar dates and retain exact overnight arrivals. Discover cabins and terminal access, then use the official booking handoff.

When to Use This CLI

Use for Kansai–Kyushu Sunflower route, exact date, seasonal band, room fare, vehicle category and terminal planning. Every dynamic result retains source observation time and uncertainty.

Anti-triggers

Do not use this CLI for:

• Booking or holding a cabin or vehicle
• Payments, account login or personal reservation management
• Hokkaido Oarai–Tomakomai or other ferry operators
• Guaranteed inventory or manually invented fare arithmetic

Unique Capabilities

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

Official ferry planning

• sailings — Turns source boarding-date results into dated JST arrival; handles daytime E cruises without projecting ordinary timetables.

  Turns source boarding-date results into dated JST arrival; handles daytime E cruises without projecting ordinary timetables.

  sunflower-ferry-pp-cli sailings --route osaka-beppu --date 2026-10-15 --agent

• quote — Presents every source-eligible cabin fare for the entered party/vehicle without hand-made fare arithmetic.

  Presents every source-eligible cabin fare for the entered party/vehicle without hand-made fare arithmetic.

  sunflower-ferry-pp-cli quote --route osaka-beppu --date 2026-10-15 --agent

• calendar — Filters bounded published date ranges with explicit coverage and special sailing warnings.

  Filters bounded published date ranges with explicit coverage and special sailing warnings.

  sunflower-ferry-pp-cli calendar --route osaka-beppu --agent

• cabins — Extracts source room occupancy so agents can distinguish dormitory capacity from private room occupancy.

  Extracts source room occupancy so agents can distinguish dormitory capacity from private room occupancy.

  sunflower-ferry-pp-cli cabins --route osaka-beppu --agent

• ports — Keeps Osaka Terminal1 and Terminal2 distinct with concise source address/access/checkin evidence.

  Keeps Osaka Terminal1 and Terminal2 distinct with concise source address/access/checkin evidence.

  sunflower-ferry-pp-cli ports --route osaka-beppu --agent

• conditions — Preserves source cancellation/baggage and quote assumptions with explicit missing English day-before band.

  Preserves source cancellation/baggage and quote assumptions with explicit missing English day-before band.

  sunflower-ferry-pp-cli conditions --agent

Discovery Signals

This CLI was generated with browser-observed traffic context.

• Capture coverage: 0 API entries from 3 total network entries
• Protocols: html_scrape (55% confidence)
• Auth signals: none

Command Reference

source — Official public source metadata; use the planning commands for structured facts

• sunflower-ferry-pp-cli source cabins — Read the official cabin description page
• sunflower-ferry-pp-cli source conditions — Read the official English boarding and cancellation policy
• sunflower-ferry-pp-cli source fares — Read the official fare and seasonal-calendar page
• sunflower-ferry-pp-cli source terminal — Read the official port access page
• sunflower-ferry-pp-cli source timetable — Read the official published weekday timetable page

Finding the right command

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

sunflower-ferry-pp-cli which "seasonal fare calendar"

which resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code 0 means at least one match; exit code 2 means no confident match — fall back to --help or use a narrower query. --json (and other machine formats) keep that exit-2 contract and write {"matches":[]} on stdout so agents can inspect the envelope without treating a miss as success.

Recipes

Fare season window

sunflower-ferry-pp-cli calendar --route osaka-beppu --from 2026-10-15 --to 2026-10-17 --agent --select data

Keep only published seasonal dates.

Overnight arrival

sunflower-ferry-pp-cli sailings --route osaka-beppu --date 2026-10-15 --agent

Read the actual source sailing for an exact boarding date.

Vehicle party quote

sunflower-ferry-pp-cli quote --route kobe-oita --date 2026-10-15 --adults 2 --children 1 --mode car --car-category lt5m --agent

Return the source total per eligible cabin for this input party.

Auth Setup

Public-source commands need no API key or login. Fare searches create an ephemeral anonymous session and stop at the fare/availability table.

Run sunflower-ferry-pp-cli doctor to verify setup.