Pp Michi No Eki

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

Michi-no-Eki source workflow

Prerequisites: Install the CLI

This skill drives the michi-no-eki-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 michi-no-eki --cli-only

2. Verify: michi-no-eki-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/michi-no-eki/cmd/michi-no-eki-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.

Search the official Japanese directory by prefecture, source region, and facilities. Compare parking and published hours, rank nearby candidates, inspect bounded station notices, and compare saved observations without inferring camping permission.

When to Use This CLI

Find Japan roadside-station service stops; inspect source-listed food, shops, baths, parking and facilities; compare a shortlist; rank scoped nearby candidates; inspect bounded station-linked notices; compare saved factual observations offline. Resolve filter vocabulary with catalog, then use concrete IDs from find.

Anti-triggers

Use the relevant booking/provider interface for campsite/RV inventory or transactions. Use routing tools for driving/vehicle-clearance planning. Station listing or active icons do not establish overnight lodging, outdoor camping or live service availability.

Unique Capabilities

Native station planning preserves read-only source behavior. Optional local learning has explicit write hints, validates cached resource identity, and preserves supported derived rules on targeted undo.

These commands combine source evidence into bounded planning workflows.

Accountable campervan stops

• readiness — Inspect source facts and permission or service unknowns for one station ID

  Campervan planner; trip agent can inspect source evidence without merging tabs manually.

  michi-no-eki-pp-cli readiness 19187 --agent

• compare — Compare up to six ordered station IDs with source facts and per-ID failures

  Campervan planner; trip agent can inspect source evidence without merging tabs manually.

  michi-no-eki-pp-cli compare --ids 19187,19189 --agent

• nearby — Rank source stations by straight-line kilometers from required latitude/longitude, scoped by area and facilities

  Campervan planner can inspect source evidence without merging tabs manually.

  michi-no-eki-pp-cli nearby --prefecture nagano --facility onsen --lat 35.8632686 --lon 138.2769108 --limit 3 --agent

• station-notices — Find notices explicitly linked to one station ID within page/detail scan limits

  Advisory researcher; trip agent can inspect source evidence without merging tabs manually.

  michi-no-eki-pp-cli station-notices 19487 --max-scan-pages 1 --max-detail-records 10 --agent

• changes — Compare two saved snapshot files offline by stable station ID and factual fields, or use an explicit synthetic demo

  Trip agent; advisory researcher can inspect source evidence without merging tabs manually.

  michi-no-eki-pp-cli changes --demo --agent

Source workflow

1. Run catalog for official IDs/aliases. Choose --prefecture or the provider's --region, not both. Preserve Japanese names and canonical URLs.
2. Use find --facility with explicit --match all|any. Provider multi-facility search is any-of; the default all-of is a local required-facility filter. present is listed evidence, not_listed is an inactive source icon, and missing data is unknown.
3. Use station, compare or readiness for published hours, nominal parking capacities and operator handoff links. Current opening, fees, charging operation, spaces and vehicle fit remain unknown. General MLIT rest guidance stays separate from per-station permissions.
4. Use nearby only with supplied itinerary coordinates; distances are straight-line kilometers. Inspect candidate cap/coverage and missing-coordinate warnings.
5. Use notices or station-notices with independent page/detail scan caps. Match exact linked station IDs. station-notices retains every notice on the scanned index pages, then opens only the --max-detail-records prefix; a no-match covers those opened details, not later index rows. Publication date is a JST calendar date, distinct from dates discussed in text. Follow the canonical notice for full text/attachments.
6. Use complete snapshot --ids ... --json stdout for user-directed local saving. changes reads two snapshots, excludes observation timestamps, and marks fetch gaps unresolved. Projected outputs cannot serve as complete snapshots.

Command Reference

Use find, station, notices, notice, catalog, guidance, snapshot, and the verified capability commands above. Each command exposes domain examples in help. Low-level stations search/get and bulletins list/get return HTML metadata/links; prefer domain commands for planning.

Recipes

Inspect optional local learning evidence

michi-no-eki-pp-cli recall "station 19187" --agent --debug-mismatches
michi-no-eki-pp-cli learnings list --agent

# Only when the user asks to undo this specific local teaching
michi-no-eki-pp-cli learnings forget "station 19187" --resource 19187 --agent

These optional helpers write local learning/audit state; they do not fetch station evidence or populate a nationwide station cache. A known conflicting cached resource remains in mismatches and cannot become an exact hit through a teaching alias or synthesized pattern. Direct aliases require a canonical shared by query, teaching and cached resource. Pattern validation uses the exact entity that produced its candidate, not unrelated entities elsewhere in the query. Recall considers later verified entity bindings from the same pattern when an earlier binding conflicts, retains its first accepted binding, and accepted typed resource IDs are omitted from mismatch diagnostics and their warnings. Final typed-ID deduplication retains the best validated hit under Recall ranking, so a prior partial or lower-ranked hit cannot hide better evidence. recall --limit caps final results, not local database work: candidate validation can scan the full optional pattern store to preserve identity filtering and final ranking. Large local stores can take longer; no local-work or latency bound is claimed. Identifier-verified patterns with no extractable cached identity retain their legacy matching behavior; that is not evidence of current provider identity or facts. Missing cached resources retain an explicit warning and still require a live source fetch. Only a genuine missing row uses this fallback; unexpected cached-identity read failures or cancellation fail recall with runtime exit 5 and no success envelope. Undo reconciles only affected inferred families. A rule needs two distinct compatible positive (boost) examples from eligible teaching sources; unusable rows do not veto valid support. New synthesis and reconciliation after an affected forget exclude hide/alias effects. Unsupported affected rules are removed; explicitly taught and unrelated patterns remain. An explicit teach-pattern records its full declared scope; later inference cannot replace it.

Native domain calls and low-level stations/bulletins reads suppress automatic learning journals/corrections. The six stateful MCP helpers disclose local writes; normal optional recall results remain available.