Pp Halal Gourmet Japan

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

Halal Gourmet Japan — Printing Press CLI

Prerequisites: Install the CLI

This skill drives the halal-gourmet-japan-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 halal-gourmet-japan --cli-only

2. Verify: halal-gourmet-japan-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/halal-gourmet-japan/cmd/halal-gourmet-japan-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 restaurants, mosques and prayer spaces by destination. Inspect full conditions, then compare saved evidence, match explicit requirements, identify missing facts, pair food and prayer stops, and track factual changes. Certification labels remain separate from HGJ verification and other conditions.

When to Use This CLI

Use for Japan Muslim-travel decisions that depend on explicit restaurant conditions and mosque/prayer-space facilities. Discover candidates, inspect full details, then compare successful saved observations. This unofficial adapter reads public HGJ pages over ordinary HTTPS without an account or browser runtime.

Evidence contract

• Keep certification.label_state, certification.certifier, certification.valid_until, verification.month and each food/facility condition separate. HGJ Verified is a platform badge with a month; it does not fill certification fields.
• reported records an explicit source label. not_reported is missing full-detail evidence, not_visible_on_card means the card cannot establish the fact, inapplicable belongs to another entity family, and reported_negative retains an explicit source JSON-LD false value if supplied.
• Search cards show limited icons and sometimes +; inspect details before deciding whether all requirements are reported. Repeated source filters are discovery semantics; plan match evaluates each requirement independently.
• Source descriptions and labels do not establish religious acceptability, ingredient/allergy certainty, cross-contamination control, current certificate validity, current opening or permission to enter.
• Prayer access notes retain explicit source text. Hours in notes remain source text; no schedule, prayer time or route is inferred. Pair distances are straight-line kilometres.

Unique Capabilities

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

Evidence planning

• plan compare — Align the source-reported food and prayer facts of selected saved places.

  Compare full facts before choosing from a shortlist.

  halal-gourmet-japan-pp-cli plan compare --restaurants 300739,949742 --prayer 838884 --agent

• plan match — See which requested source labels are reported and which need confirmation.

  Test every explicit requirement without issuing a halal verdict.

  halal-gourmet-japan-pp-cli plan match --restaurants 300739 --require certified,meat,prayer --agent

• plan gaps — List missing certifier, certificate validity, hours and access evidence.

  Prepare factual questions for selected food and prayer stops.

  halal-gourmet-japan-pp-cli plan gaps --restaurants 300739 --prayer 838884 --agent

• plan pair — Pair selected restaurants and prayer places by straight-line distance.

  Assess proximity while preserving access and hours unknowns.

  halal-gourmet-japan-pp-cli plan pair --restaurants 300739 --prayer 838884 --max-km 5 --agent

Saved observations

• plan changes — See factual changes between the latest two successful observations.

  Recheck a shortlist before visiting and inspect changed evidence.

  halal-gourmet-japan-pp-cli plan changes --restaurants 300739 --prayer 838884 --agent

Command Reference

All plan commands take --restaurants and/or --prayer as comma-separated or repeated numeric IDs, at most 20 per kind. They read local details only and reject --data-source live; save inspections first. Missing snapshots appear in missing_snapshots, never as invented rows. Plans bound output with --limit and pairing examines at most 400 candidate pairs.

Food keys: certified, owner, noAlcoholicDrinks, porkFree, meat, seasoning, tableware, meal, vegetarian, prayer. Prayer keys: wudu, wifi, hotWater, qibla. Missing card conditions do not satisfy any key.

Recipes

Narrow restaurant discovery

halal-gourmet-japan-pp-cli restaurants search --prefecture Tokyo --query ramen --limit 5 --agent --select results.id,results.name,results.source_url

Cards discover candidates; missing card icons are not a requirement verdict.

Inspect food and prayer evidence

halal-gourmet-japan-pp-cli plan compare --restaurants 300739 --prayer 838884 --agent

Load successful detail snapshots before comparing saved facts.

Clarify missing evidence

halal-gourmet-japan-pp-cli plan gaps --restaurants 300739 --prayer 838884 --agent

List unreported certifier, validity, applicable hours/access and coordinates.

Compare proximity

halal-gourmet-japan-pp-cli plan pair --restaurants 300739 --prayer 838884 --max-km 5 --agent

Straight-line distance is not a route, walking time or access guarantee.

Recheck saved observations

halal-gourmet-japan-pp-cli plan changes --restaurants 300739 --agent

Run restaurants get --data-source live again before comparing two successful observations.

Auth Setup

The scoped public pages require no account or API key. Requests use ordinary HTTPS and never book, post or alter an account.

Run halal-gourmet-japan-pp-cli doctor to verify setup.

Agent Mode

Use --agent for JSON, compact, non-interactive, colour-free output. --json returns a plain result object; --agent adds meta.source and a results envelope. Search already has a results array; the agent wrapper preserves one envelope. Select fields before automatic wrapping: detail uses --select id,name,certification,verification; search uses --select results.id,results.name.

--select accepts dotted paths, --compact reduces optional content, --csv/--plain request tabular output, and --quiet requests identities. JSON stays on stdout and warnings stay on stderr. --dry-run performs no network or cache I/O.