@yukioa2z/visa-apply 3.0.1 → 3.0.3

package/README.md

@@ -5,7 +5,14 @@ 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)
 
 ```sh
-npx --yes @yukioa2z/visa-apply
+npx @yukioa2z/visa-apply
+```
+
+Run in a terminal and pick your agent when prompted. To skip the prompt, pass your agent's skills directory:
+
+```sh
+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 +27,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 +47,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

@@ -3,20 +3,32 @@
 const fs = require("fs");
 const os = require("os");
 const path = require("path");
+const readline = require("readline");
 
 const skillName = "visa-apply";
 const packageRoot = path.resolve(__dirname, "..");
 const sourceDir = path.join(packageRoot, "skill");
 
+// Known agents and the skills directory each one scans.
+const AGENTS = [
+  { label: "Claude Code", dir: "~/.claude/skills" },
+  { label: "Codex", dir: "~/.codex/skills" },
+];
+
 function usage() {
+  const lines = AGENTS.map(
+    (a) => `  ${a.label.padEnd(13)} npx @yukioa2z/visa-apply -- --dest ${a.dir}`
+  ).join("\n");
   console.log(`Install ${skillName}
 
-Usage:
-  npx @yukioa2z/visa-apply
-  npx @yukioa2z/visa-apply -- --dest ~/.claude/skills
+Pick your agent's skills directory with --dest:
+${lines}
+  Other agent   npx @yukioa2z/visa-apply -- --dest <your agent's skills dir>
+
+Run with no --dest in a terminal to choose interactively.
 
 Options:
-  --dest <path>   Skill root directory. Defaults to $CODEX_HOME/skills or ~/.codex/skills.
+  --dest <path>   Skill root directory.
   --dry-run       Print the destination without copying files.
   --help          Show this help message.
 `);
@@ -36,32 +48,75 @@ function readOption(name) {
   return args[index + 1];
 }
 
-const args = process.argv.slice(2);
-if (args.includes("--help") || args.includes("-h")) {
-  usage();
-  process.exit(0);
+function install(destRoot, dryRun) {
+  const destDir = path.join(destRoot, skillName);
+  if (dryRun) {
+    console.log(destDir);
+    return;
+  }
+  fs.mkdirSync(destRoot, { recursive: true });
+  fs.rmSync(destDir, { recursive: true, force: true });
+  fs.cpSync(sourceDir, destDir, { recursive: true });
+  console.log(`Installed ${skillName} to ${destDir}`);
+  console.log(
+    `Try: Use $${skillName} to check your visa need and prepare an application dossier.`
+  );
 }
 
-if (!fs.existsSync(sourceDir)) {
-  console.error(`Skill source not found: ${sourceDir}`);
-  process.exit(1);
+function promptAgent() {
+  return new Promise((resolve) => {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    console.log("Which agent are you installing for?\n");
+    AGENTS.forEach((a, i) => console.log(`  ${i + 1}) ${a.label}  (${a.dir})`));
+    console.log(`  ${AGENTS.length + 1}) Other  (enter a path)\n`);
+    rl.question("Choice: ", (answer) => {
+      rl.close();
+      const n = parseInt(answer.trim(), 10);
+      if (n >= 1 && n <= AGENTS.length) {
+        resolve(AGENTS[n - 1].dir);
+      } else if (n === AGENTS.length + 1) {
+        const rl2 = readline.createInterface({ input: process.stdin, output: process.stdout });
+        rl2.question("Skills directory path: ", (p) => {
+          rl2.close();
+          resolve(p.trim() || null);
+        });
+      } else {
+        resolve(null);
+      }
+    });
+  });
 }
 
-const defaultRoot = process.env.CODEX_HOME
-  ? path.join(process.env.CODEX_HOME, "skills")
-  : path.join(os.homedir(), ".codex", "skills");
+async function main() {
+  const args = process.argv.slice(2);
+  if (args.includes("--help") || args.includes("-h")) {
+    usage();
+    return;
+  }
+  if (!fs.existsSync(sourceDir)) {
+    console.error(`Skill source not found: ${sourceDir}`);
+    process.exitCode = 1;
+    return;
+  }
 
-const destRoot = path.resolve(expandHome(readOption("--dest") || defaultRoot));
-const destDir = path.join(destRoot, skillName);
+  const dryRun = args.includes("--dry-run");
+  let dest = readOption("--dest");
 
-if (args.includes("--dry-run")) {
-  console.log(destDir);
-  process.exit(0);
-}
+  if (!dest) {
+    // No target given. Ask interactively when attached to a terminal;
+    // otherwise (agent/CI) print guidance and exit without guessing.
+    if (process.stdin.isTTY && process.stdout.isTTY) {
+      dest = await promptAgent();
+    }
+    if (!dest) {
+      console.error("No skills directory chosen.\n");
+      usage();
+      process.exitCode = 1;
+      return;
+    }
+  }
 
-fs.mkdirSync(destRoot, { recursive: true });
-fs.rmSync(destDir, { recursive: true, force: true });
-fs.cpSync(sourceDir, destDir, { recursive: true });
+  install(path.resolve(expandHome(dest)), dryRun);
+}
 
-console.log(`Installed ${skillName} to ${destDir}`);
-console.log(`Try: Use $${skillName} to check your visa need and prepare an application dossier.`);
+main();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yukioa2z/visa-apply",
-  "version": "3.0.1",
+  "version": "3.0.3",
   "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.