@yukioa2z/visa-apply 3.0.1 → 3.0.2

package/README.md

@@ -4,8 +4,11 @@ Research, prepare, review, and track visa applications with current official sou
 
 [Website](https://yukioa2z.github.io/visa-apply/) · [Source](https://github.com/Yukioa2z/visa-apply)
 
+Install into your agent's skills directory with `--dest`:
+
 ```sh
-npx --yes @yukioa2z/visa-apply
+npx @yukioa2z/visa-apply -- --dest ~/.claude/skills   # Claude Code
+npx @yukioa2z/visa-apply -- --dest ~/.codex/skills    # Codex
 ```
 
 Then invoke. To just check whether you need a visa:
@@ -20,11 +23,7 @@ Many trips end there with a visa-free or ETA answer. To prepare a full applicati
 Use $visa-apply to help me prepare a visa application for my destination and visa type.
 ```
 
-The installer copies the skill to `~/.codex/skills/visa-apply`. For Claude Code, Hermes, OpenClaw, or another agent with a different skill directory:
-
-```sh
-npx --yes @yukioa2z/visa-apply -- --dest ~/.claude/skills
-```
+`--dest` is your agent's skills root; the installer copies the skill into `<dest>/visa-apply`. Point it at whatever directory your agent scans — Claude Code, Codex, Hermes, OpenClaw, or another agent. Run with `--help` to see the target paths.
 
 ## Pipeline
 
@@ -44,6 +43,12 @@ No cached source stores a visa-free or visa-required answer. Every case must be
 
 Government immigration, foreign-ministry, and embassy pages are the rule authority. Delegated visa application centres are used only for appointment and submission logistics.
 
+## Weekly source monitoring
+
+Every Monday at 00:00 Asia/Shanghai, GitHub Actions compares normalized content fingerprints for every registered official visa source. All 250 destinations appear in the generated monitor: destinations with registered sources receive a change status, while destinations without a source seed are explicitly marked as requiring live official-source discovery.
+
+A new fingerprint is first recorded as a review candidate and is only confirmed as changed when the same fingerprint appears in the next run. Either state is a review signal, not a visa-policy verdict. The workflow records the result in `skill/references/policy-monitor.json`, increments the package patch version, commits the report, and dispatches the npm trusted-publishing workflow. This keeps the installable skill current without turning an arbitrary webpage edit into legal guidance.
+
 The applicant model is global. It keeps citizenship, travel-document issuer, legal residence, current location, consular application location, and transit route separate, including dual nationals, third-country applicants, minors, and holders of refugee or other non-passport travel documents.
 
 This skill is not legal advice. The applicant must review all information and handle applicant-only declarations, signatures, certifications, CAPTCHA, and submission.

package/bin/install.js

@@ -11,12 +11,13 @@ const sourceDir = path.join(packageRoot, "skill");
 function usage() {
   console.log(`Install ${skillName}
 
-Usage:
-  npx @yukioa2z/visa-apply
-  npx @yukioa2z/visa-apply -- --dest ~/.claude/skills
+Choose where to install with --dest — your agent's skills directory:
+  Claude Code   npx @yukioa2z/visa-apply -- --dest ~/.claude/skills
+  Codex         npx @yukioa2z/visa-apply -- --dest ~/.codex/skills
+  Other agent   npx @yukioa2z/visa-apply -- --dest <your agent's skills dir>
 
 Options:
-  --dest <path>   Skill root directory. Defaults to $CODEX_HOME/skills or ~/.codex/skills.
+  --dest <path>   Skill root directory (required).
   --dry-run       Print the destination without copying files.
   --help          Show this help message.
 `);
@@ -47,11 +48,16 @@ if (!fs.existsSync(sourceDir)) {
   process.exit(1);
 }
 
-const defaultRoot = process.env.CODEX_HOME
-  ? path.join(process.env.CODEX_HOME, "skills")
-  : path.join(os.homedir(), ".codex", "skills");
+const destOption = readOption("--dest");
+if (!destOption) {
+  console.error(
+    "No --dest given. Install into your agent's skills directory:\n"
+  );
+  usage();
+  process.exit(1);
+}
 
-const destRoot = path.resolve(expandHome(readOption("--dest") || defaultRoot));
+const destRoot = path.resolve(expandHome(destOption));
 const destDir = path.join(destRoot, skillName);
 
 if (args.includes("--dry-run")) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yukioa2z/visa-apply",
-  "version": "3.0.1",
+  "version": "3.0.2",
   "description": "Install a global visa-need research and application filing skill.",
   "license": "MIT",
   "keywords": [

package/skill/SKILL.md

@@ -23,6 +23,7 @@ This skill is not legal advice. The applicant must review every answer and handl
 3. Run the mandatory live visa-need check before detailed intake.
    - Read `references/live-route-check.md`.
    - Resolve the destination in `references/jurisdictions.json`; cached starting sources are in `references/official-sources.json`.
+   - Consult `references/policy-monitor.json` when present. A changed fingerprint means the official page needs review; it is never a visa verdict and never replaces the live check.
    - Run `python3 scripts/source_registry.py live-check-plan <country> ...` when useful.
    - Browse current destination-government and responsible-mission sources for the exact passport, residence, purpose, dates, duration, entries, arrival mode, and transit itinerary.
    - Cross-check IATA Travel Centre/Timatic or the operating carrier for boarding requirements. Treat it as operational evidence, not legal authority.
@@ -42,6 +43,7 @@ This skill is not legal advice. The applicant must review every answer and handl
    - No chat note or scratch file may become more authoritative than the HTML.
 8. Run `references/quality-gates.md`, then stop at the applicant review gate before portal entry. Call out inferred values, stale sources, missing documents, expiring evidence, and unresolved conflicts.
 9. Assist with form entry using Browser or Computer Use after review.
+   - Before filling anything, make sure the dossier HTML is open in the user's default viewer (open it if it is not) so they can follow progress while you enter the form. Keep updating that file as each field is filled; the user refreshes to see the latest.
    - In non-Codex environments, use the equivalent browser/computer capability, such as Peekaboo or the runtime's supported automation skill.
    - Never bypass CAPTCHA or security controls, invent data, or perform an applicant-only signature/certification.
 10. Backfill application IDs, receipts, appointments/biometrics, document requests, decision status, and passport/visa return details into the HTML.
@@ -68,6 +70,8 @@ python3 scripts/create_dossier.py /path/to/visa-dossier.html \
   --transit "Singapore, airside"
 ```
 
+Immediately open the dossier in the user's default viewer so they can watch it fill in as the interview proceeds. Use the platform opener: `open <path>` on macOS, `xdg-open <path>` on Linux, `start "" <path>` on Windows. Open it once; each later HTML update lands in the same file, so the user just refreshes the tab. If no opener is available (headless/remote), tell the user the local path to open manually.
+
 ## References
 
 - Full pipeline and source freshness rules: `references/pipeline.md`
@@ -77,4 +81,5 @@ python3 scripts/create_dossier.py /path/to/visa-dossier.html \
 - Submission, document, timing, and privacy gates: `references/quality-gates.md`
 - Searchable destination directory: `references/jurisdictions.json`
 - Official source registry: `references/official-sources.json`
+- Weekly official-source change signals: `references/policy-monitor.json` (source health only, never a visa verdict)
 - Full country adapters: `references/countries/` — United States DS-160 (`us.md`), Schengen Type C (`schengen.md`), Canada IRCC (`ca.md`), United Kingdom (`uk.md`), Australia (`au.md`), Japan (`jp.md`). Every other destination uses a source-seeded or live-discovered adapter.