Pp Walkerplus

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

Walkerplus event discovery

For a source checkout, use a locally built walkerplus-pp-cli binary with Go 1.26.6 or newer. Catalog installation requires a merged library release. Verify walkerplus-pp-cli --version; if missing, build with go build -o walkerplus-pp-cli ./cmd/walkerplus-pp-cli and make the binary available on PATH. Public Walkerplus HTML is the only runtime source. No credentials, browser, booking, or translation provider is involved. MCP is compiled for stdio only; no HTTP listener is included. When using MCP, inspect truncation metadata and narrow --limit or --select after a bounded result or capture-limit error. CLI JSON error codes remain available; auxiliary diagnostics are separate.

Workflow

1. Resolve the travel location and event category through the catalogs. Accepted codes and source slugs map to Japanese source labels. City codes, source slugs and Japanese city names from areas are accepted with the matching prefecture; for example, --prefecture tokyo --city ar0313104 or --city shinjuku.

   walkerplus-pp-cli areas --prefecture kyoto
   walkerplus-pp-cli categories

2. Discover bounded candidates cheaply. Search reads listings only. Use exact trip dates and inspect coverage before describing completeness.

   walkerplus-pp-cli search --prefecture kyoto --category festival --from 2026-10-01 --to 2026-10-31 --limit 5 --max-pages 3

3. Enrich a bounded shortlist when the traveler needs attendance confidence or strict constraints. Keep possible matches separate from confirmed days.

   walkerplus-pp-cli shortlist --prefecture kyoto --from 2026-10-10 --to 2026-10-12 --max-details 10 --agent --select id,title_ja,start_date,end_date,location,match,schedule,sources
   walkerplus-pp-cli shortlist --prefecture osaka --from 2026-10-11 --to 2026-10-11 --indoor --max-details 10

   --free requires explicit event admission evidence; --indoor requires unconditional indoor evidence. Both flags mean AND. Optional paid purchases do not make explicitly free admission paid; preserve those caveats. Unknown and conditional source attributes are excluded by strict constraints.

4. Read the event edition before recommending attendance. Carry schedule exceptions, weather, cancellation, admission and reservation facts into the answer with its source URL.

   walkerplus-pp-cli event ar0313e603640 --select id,title_ja,source_url,schedule,hours,admission,reservation_required,reservation_text,weather,cancellation,organizer_urls,sources

   Completion means every recommendation cites the edition, relevant source dates, match confidence, practical caveats, and coverage limits. If published evidence does not resolve attendance, describe it as possible and direct the traveler to the organizer.

Evidence and bounds

Japanese titles are authoritative. Raw schedule, admission and reservation text, evidence, and source URLs are source facts. Normalized edition_year/date_certainty, parsed recurrence/exclusion lists, admission status, boolean classifications, and match/rank fields are derived conveniences. An overall date envelope is not proof of daily activity. Closure-only rules narrow possible days; explicit occurrences, daily activity or positive recurrence can confirm activity. Approximate seasons, unresolved holiday exceptions, and undisclosed next-year editions never become confirmed dates. --timing starts|ends checks published envelope boundaries.

JSON is compact by default; --agent and --json are compatible. --select/--fields project event fields while retaining query, coverage and provenance. Use schema to discover fields. Unknown scalars are null, collections are empty arrays, diagnostics are stderr.

Default caps are 10 returned events, 3 listing pages, and 10 detail candidates. Shortlist returns only detail-inspected candidates; reaching --max-details can leave fewer results than --limit. Detail selection checks listing-supported location/category matches before candidates with missing facts, using --sort within each group; returned results use --sort. Widen --max-pages and --max-details deliberately within hard limits; an empty bounded scan does not establish absence. Coverage gives sampled routes, counts, continuation, cache hits and incomplete reasons. Resolving an additional city performs at most one prefecture catalog lookup outside the --max-pages event-page budget; catalog_requests/catalog_routes record it, and request_count includes it. Native month/day routes have no year selector; exact local filtering cannot manufacture a future edition.

Use --refresh when a source recheck is needed. sources provide fetch time and cache age; publisher update text is separate. Every custom command accepts --dry-run for offline validation.

walkerplus-pp-cli doctor --dry-run --json
walkerplus-pp-cli event --dry-run --agent

Usage errors exit 2, missing event 3, fetch/parser failure 5, exhausted rate limiting 7. Source failure emits JSON error rather than empty success. Read README.md for build, cache, troubleshooting and live verification details.