Pp Iko Yo

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

Iko-yo Trip — Printing Press CLI

Prerequisites: Install the CLI

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

2. Verify: iko-yo-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/iko-yo/cmd/iko-yo-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.

Discover Iko-yo Trip’s local experiences and municipal events, inspect evidence, and compare a small family shortlist. Keyword and date filters apply only to the reported bounded listing window; cached records retain their observation times. The full core Iko-yo catalog is not integrated.

When to Use This CLI

Use this CLI for selected Iko-yo Trip family spots, municipal events and local experiences across Japan. It is useful when event dates, separate fees, application conditions or explicit family facilities affect a small shortlist. Report the bounded source window and preserve unknown facts.

Anti-triggers

Do not use this CLI for:

• Full core Iko-yo catalog or core age-filter search
• Bookings, payments, reviews, posts or account changes
• Live seat availability or guaranteed age/accessibility suitability

Unique Capabilities

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

Find family-trip candidates

• trip discover — Find regional candidates while seeing exactly which listing pages and records were checked.

  Choose this when a trip window matters and complete source coverage is unavailable.

  iko-yo-pp-cli trip discover --kind events --region 6 --prefecture 11 --from 2026-11-14 --to 2026-11-15 --max-pages 2 --agent

Check published conditions

• trip inspect — See published age, indoor, nursing and changing evidence with unknown fields exposed.

  Choose this before deciding whether published family facts meet a requirement.

  iko-yo-pp-cli trip inspect spots/8220 --agent

• trip compare — Compare separate fee statements, payment conditions and explicit application intervals.

  Choose this to compare published costs and deadlines without assuming a total or seat availability.

  iko-yo-pp-cli trip compare spots/8220 events/8412 --on 2026-11-15 --as-of 2026-10-03 --agent

• trip compare — Compare selected outings against age, requested amenities and a trip date using supported, excluded and unknown states.

  Choose this for a small family shortlist that needs explicit constraints.

  iko-yo-pp-cli trip compare spots/8220 events/8412 --on 2026-11-15 --age-months 24 --amenities indoor,nursing,changing --agent

Revisit saved facts

• trip cached — Search saved family facts with their original observation times and collection coverage.

  Choose this to revisit saved records without network access.

  iko-yo-pp-cli trip cached Mooovi --kind spots --agent

Discovery Signals

This CLI was generated with browser-observed traffic context.

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

Command Reference

events — Operations on events

• iko-yo-pp-cli events get — Inspect published Iko-yo Trip event facts
• iko-yo-pp-cli events list — Fetch structured links from /events
• iko-yo-pp-cli events prefecture — Discover Iko-yo Trip events in a source prefecture
• iko-yo-pp-cli events region — Discover Iko-yo Trip events in a source region

spots — Operations on spots

• iko-yo-pp-cli spots get — Inspect published Iko-yo Trip spot facts
• iko-yo-pp-cli spots list — Fetch structured links from /spots

Finding the right command

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

iko-yo-pp-cli which "<capability in your own words>"

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.

Evidence and coverage rules

Use Iko-yo Trip branding when presenting results. This is selected nationwide family experiences and municipal/local events; the full core Iko-yo catalog and its server age/facility filters are excluded.

• Discovery scans at most five pages total across listing kinds, separately from the output limit. Listings are publication-ordered and include archived events. Report coverage, remaining pages, scanned/unknown counts and the zero-result note. An empty bounded scan does not establish that no matching events exist.
• schedule.status distinguishes upcoming and ended records; irregular schedules stay unknown. A published span overlapping a visit date does not establish daily operation or an individual session.
• Compare only explicit age and facility evidence. Missing amenities remain unknown. An indoor area does not imply an entirely indoor venue. Published age descriptions are not formal admission or safety guarantees.
• Preserve separate child/adult fee statements and payment qualifiers. Do not derive a family total, dated quote or available seats. Application intervals, capacities and lottery terms are published evidence only.
• Local facts retain observed_at. Auto inspect/compare tries live first; only a network failure permits saved-detail fallback with a warning. HTTP access errors and rate limits remain errors. Local scans cap records independently of returned matches and cap provenance to 5,000 memberships and 100 collections.
• Saved Trip reads and MCP SQL require a stable, checkpointed cache and use a private snapshot capped at 128 MiB. If active sidecars or changed identity are reported, close writers and retry; do not interpret the error as an empty collection. Live saves use canonical SQLite transactions. Symlinks to singly linked targets work; hard links and %, ? or # in selected/resolved/temp paths are refused. External cache replacement during writing is unsupported. --no-cache skips live snapshot saving.

Recipes

Narrow event candidates

iko-yo-pp-cli trip discover --kind events --region 6 --prefecture 11 --max-pages 1 --agent --select records.ref,records.name,records.schedule,coverage

Inspect published event dates and the exact scanned source window.

Published family facts

iko-yo-pp-cli trip inspect spots/8220 --agent

Read age and facility evidence and unknowns for one source record.

Compare a family shortlist

iko-yo-pp-cli trip compare spots/8220 events/8412 --on 2026-11-15 --as-of 2026-10-03 --age-months 24 --amenities indoor,nursing,changing --agent

Compare constraints, charge qualifiers and application boundaries.

Offline saved facts

iko-yo-pp-cli trip cached Mooovi --kind spots --agent

Search only previously saved normalized records with their provenance.

Auth Setup

The supported Trip pages use ordinary public HTTP and need no account or API key. Source records are published information, not live availability.

Run iko-yo-pp-cli doctor to verify setup.

Agent Mode

Add --agent to any command. Expands to: --json --compact --no-input --no-color.

Global format flags share one contract on source, planning, and --deliver paths:

• --json — one JSON document on stdout

• --compact — keep identity/status/timestamp fields; does not change the document vs stream shape

• --csv / --plain — tabular rows (collection envelopes unwrap to the row array)

• --quiet — one identity value per row, no envelope

• Pipeable — JSON on stdout, errors on stderr

• Filterable — --select keeps a subset of fields. Dotted paths descend into nested structures; arrays traverse element-wise. Critical for keeping context small on verbose APIs:

  iko-yo-pp-cli events list --agent

• Previewable — --dry-run shows the request without sending

• Offline-friendly — trip cached and trip inspect --data-source local read selected saved facts

• Non-interactive — never prompts, every input is a flag

• Read-only — do not use this CLI for create, update, delete, publish, comment, upvote, invite, order, send, or other mutating requests