@yukioa2z/visa-apply 3.0.0

package/skill/references/adapter-schema.md

@@ -0,0 +1,55 @@
+# Country Adapter Schema
+
+Create an adapter only from current official sources.
+
+## Metadata
+
+- Country or area
+- Supported visa routes
+- Applicant nationality or stateless/refugee status, travel-document issuer, legal residence, residence status, and application-location assumptions
+- Last verified date
+- Official source IDs from `official-sources.json`
+- Support level: `full_adapter`, `source_seeded`, or `discovered`
+
+## Route Map
+
+For each route record:
+
+- official visa or authorization name
+- purpose and duration boundary
+- eligibility inputs
+- application authority and responsible post
+- online, paper, in-person, or hybrid process
+- form/application portal
+- fee, biometrics, appointment, interview, and status channels
+- visa-free, ETA, eVisa, visa-on-arrival, transit, and residence-permit substitution branches
+- policy effective dates, freshness trigger, and carrier/Timatic operational cross-check
+
+## Question Overlay
+
+List only questions beyond `core-intake.md`, in official form order when known. Each question should include:
+
+- field label
+- expected format
+- conditional trigger
+- evidence source
+- official source URL or registry source label
+
+## Documents
+
+Separate documents into:
+
+- always required
+- conditional
+- location-specific
+- generated after submission
+
+Do not call a document mandatory unless the relevant official source says so for the applicant's route and place of application.
+
+## Portal Workflow
+
+Record the page order, save/retrieve behavior, generated identifiers, upload constraints, payment, appointment, and status steps. Include automation limits and applicant-only declaration/signature steps.
+
+## Review Risks
+
+Record unresolved source conflicts, translation/legalization rules, passport validity rules, residence-jurisdiction limits, and facts that require applicant confirmation.

package/skill/references/core-intake.md

@@ -0,0 +1,66 @@
+# Core Visa Intake
+
+Ask only the sections required by the selected country adapter and visa type.
+
+## Routing
+
+- Destination; every current nationality, or stateless/refugee status
+- Travel-document type, issuing country/authority, and any nationality encoded by that document
+- Travel-document issue/expiry dates, blank pages, damage, and emergency/refugee-document status
+- Legal residence, residence status/expiry, current physical location, and intended application location
+- Purpose, dates, duration, entries, arrival mode/port, travel companions
+- Every transit, self-transfer, airport change, baggage recheck, and overnight stop
+- Existing visas or residence permits that may change eligibility
+
+## Identity And Passport
+
+- Name exactly as passport, other names, native-script name if requested
+- Date and place of birth, sex/gender field as the form defines it, marital status
+- All current and former nationalities, stateless/refugee status, national ID if requested
+- Passport number/type, issue/expiry dates, issuing authority/place
+- Refugee, emergency, laissez-passer, or other non-passport travel document details when applicable
+- Previous, lost, or stolen passports when requested
+
+## Contact And Residence
+
+- Current and permanent address
+- Phone, email, social accounts only when the official form asks
+- Residence status in the place of application
+- Emergency contact when requested
+
+## Trip
+
+- Purpose and intended activities
+- Arrival/departure, itinerary, entry/exit points
+- Airside/landside transit, self-transfer, airport change, and onward-entry permission
+- Accommodation and host/contact
+- Travel payer, budget, insurance, and transport reservations when relevant
+
+## Work, Education, And Funds
+
+- Current occupation, employer/school, dates, income, duties/course
+- Previous employment/education when requested
+- Personal funds, sponsor, relationship, and supporting evidence
+
+## Family And Relationships
+
+- Parents, spouse/partner, children, dependants
+- Family or host in destination country
+- Relationship evidence for family routes
+
+## Travel And Immigration History
+
+- Previous travel to destination and other countries
+- Previous visas, refusals, cancellations, removals, overstays, or status violations
+- Criminal, security, health, military, government, or immigration questions exactly as the official form asks
+
+## Visa-Type Overlays
+
+- Visitor/business: activity boundary, host, itinerary, funding, return ties
+- Study: institution, course, enrollment document, fees, funding, language, prior study
+- Work: employer/petitioner, role, worksite, contract, salary, permit or sponsorship reference
+- Family: petitioner/sponsor, legal relationship, timeline, residence status, dependants
+- Transit/crew: route, onward permission, carrier/vessel, role, layover
+- Medical: provider, treatment plan, cost, payer, medical records
+- Investment/startup: entity, ownership, funds, source of funds, business plan
+- Minor/dependant: guardian, consent/custody, accompanying adult, school and sponsor evidence

package/skill/references/countries/au.md

@@ -0,0 +1,149 @@
+# Australia Adapter: Visitor entry (601 ETA / 651 eVisitor / 600 Visitor visa)
+
+Support level: `full_adapter` (rules + document-checklist depth; ImmiAccount is login-walled and not field-scriptable). Rules, fees, and document requirements verified live against immi.homeaffairs.gov.au on 2026-07-20. The 601 page's last-updated stamp is 12/08/2025.
+
+## Metadata
+
+- **Country/area:** Australia
+- **Supported visa routes:**
+  - **Subclass 601 — Electronic Travel Authority (ETA)** — tourist / family visit / business visitor activities, applied via the Australian ETA app.
+  - **Subclass 651 — eVisitor** — same activities, applied via ImmiAccount, free.
+  - **Subclass 600 — Visitor visa** — full visitor visa with streams: **Tourist (apply outside Australia)**, **Tourist (apply in Australia / onshore)**, **Business Visitor**, **Sponsored Family**, **Approved Destination Status (ADS)**, **Frequent Traveller**.
+- **Applicant assumptions:** Nationality/passport determines route eligibility. Applicant is outside Australia for 601, 651, Tourist-overseas, Business, Sponsored Family, ADS, Frequent Traveller; onshore only for the Tourist (apply in Australia) stream. Not an Australian citizen. Purpose is a genuine short-term visit, not paid work or study >3 months.
+- **Last verified date:** 2026-07-20
+- **Official source IDs/URLs:** see `official-sources.json`.
+- **Support level:** `full_adapter`
+
+## Route Map
+
+### Subclass 601 — Electronic Travel Authority (ETA)
+- **Official name:** Electronic Travel Authority (subclass 601).
+- **Purpose / duration:** Tourism, visit family or friends, or business-visitor activities. Study/train up to 3 months total. Valid for travel **12 months** (or passport validity if shorter), **multiple entry**, **stay up to 3 months per entry**.
+- **Eligibility (passports):** Must hold a valid passport from an **ETA-eligible country/jurisdiction** (incl. Andorra, Austria, Belgium, Brunei, Canada, Denmark, Finland, France, Germany, Greece, Hong Kong SAR, Iceland, Ireland, Italy, Japan, Liechtenstein, Luxembourg, Malaysia, Malta, Monaco, Norway, Portugal, San Marino, Singapore, South Korea, Spain, Sweden, Switzerland, Taiwan (non-official/diplomatic), Netherlands, UK–British Citizen, UK–British National (Overseas), USA, Vatican City). No non-citizen passport / certificate of identity / Titre de Voyage. Australian citizens ineligible.
+- **Application authority / process:** Department of Home Affairs, via the **Australian ETA app** (iOS/Android) — scan passport, live photo, answer questions (incl. criminal-conviction declaration), pay, submit. Not applied through ImmiAccount.
+- **Fee:** **No Visa Application Charge; AUD 20 service charge to use the Australian ETA app.**
+- **Health/character routing:** If the applicant has previously failed the health requirement, has a criminal conviction, or will enter health-care/hospital environments (or train as doctor/dentist/nurse/paramedic/childcare) → **do not use ETA; apply subclass 600.**
+- **Freshness trigger:** ETA is linked to the passport used; **ETA ceases if that passport expires or is replaced** — must re-apply. Verify fee/eligible-passport list each cycle (page last updated 12/08/2025).
+- **Timatic/carrier note:** Digitally linked to passport, no label; carriers verify at check-in. Do not book travel until granted.
+
+### Subclass 651 — eVisitor
+- **Official name:** eVisitor (subclass 651).
+- **Purpose / duration:** Same activities as ETA. Valid for travel **12 months from grant**, **multiple entry**, **stay up to 3 months per entry**.
+- **Eligibility (passports):** Must be a **citizen of and hold a passport from a European eligible country** (Andorra, Austria, Belgium, Bulgaria, Croatia, Cyprus, Czech Republic, Denmark, Estonia, Finland, France, Germany, Greece, Hungary, Iceland, Ireland, Italy, Latvia, Liechtenstein, Lithuania, Luxembourg, Malta, Monaco, Netherlands, Norway, Poland, Portugal, Romania, San Marino, Slovakia, Slovenia, Spain, Sweden, Switzerland, UK–British Citizen, Vatican City). Cannot apply with a non-citizen passport/CoI/Titre de Voyage, or BN(O)/British Dependent Territories/British Overseas Citizen/British Protected Person/British Subject passports. Australian citizens ineligible.
+- **Application authority / process:** Department of Home Affairs via **ImmiAccount** (online); form ID **`TV-AP-651`**.
+- **Fee:** **Free.**
+- **Health/character routing:** As for 601 — criminal conviction / prior health failure / health-care environments → **apply subclass 600 instead.** May be asked for a police certificate.
+- **Timatic/carrier note:** No label; carriers verify at check-in. Applicant must be outside Australia at grant.
+
+### Subclass 600 — Visitor visa (streams)
+- **Official name:** Visitor visa (subclass 600).
+- **Purpose:** For everyone not eligible/able to use 601 or 651, or with longer/specific-purpose needs (criminal conviction, prior health-requirement failure, health-care environments, sponsored family visits, ADS tour groups, long-validity frequent travel).
+- **Application authority / process:** Department of Home Affairs via **ImmiAccount**. **All streams use form ID `VSS-AP-600`.**
+- **Streams — duration, location, base Visa Application Charge (VAC, current AUD):**
+
+  | Stream | Location | Stay | Base VAC (AUD) | Notes |
+  |---|---|---|---|---|
+  | Tourist — apply outside Australia | Offshore | 3, 6 or 12 months | **from 250** | Tourism/family/friends |
+  | Tourist — apply in Australia (onshore) | Onshore | up to 12 months | **from 630** | Stay/extend from within Australia |
+  | Business Visitor | Offshore | up to 3 months | **250** | Business-visitor activities only; ABTC interaction |
+  | Sponsored Family | Offshore | up to 12 months | **250** | Requires eligible sponsor; **sponsor may pay a security bond** |
+  | Approved Destination Status (ADS) | Offshore | as granted | **250** | PRC citizens (excl. SARs) on organised tour group |
+  | Frequent Traveller | Offshore | validity up to **10 years**, 3 months/entry | **1,845** | Citizens of PRC, Brunei, Cambodia, Philippines, Laos, Indonesia, Malaysia, Singapore, Thailand, Vietnam, Timor-Leste |
+
+  **Cost concession:** From 1 July 2026 a lower visa cost applies to eligible Pacific Island and Timor-Leste citizens (recognised by passport in ImmiAccount). Use the **Visa Pricing Estimator** for the exact charge — the base VAC excludes second-instalment and subsequent-family-member charges.
+- **Biometrics/health:** Health examinations may be required (before applying or when requested; mandatory-context for health-care/hospital environments, long stays, parents seeking longer visas). Biometrics if requested. Police certificate(s) if requested / where character concerns.
+- **Freshness trigger:** Fees change on the annual 1 July cycle (1 July 2026 concession confirmed; PNG passport arrangements from 1 July 2026). Re-verify all VAC figures via the Visa Pricing Estimator each cycle.
+- **Timatic/carrier note:** Digitally linked to passport, no label; carriers verify at check-in.
+
+## Question Overlay
+
+ImmiAccount is login-walled, so field-level scripting is not reproducible. The subclass 600 form (`VSS-AP-600`) follows this general information order (from official Step-by-step / Eligibility content; not literal in-portal labels):
+
+| Field / topic | Format | Conditional trigger | Evidence source |
+|---|---|---|---|
+| Identity — passport bio page | Passport scan/photo, colour | Always | 600 Tourist (Identity documents) |
+| National identity card | Scan | If held | 600 Tourist |
+| Change-of-name proof | Marriage/divorce/name-change docs | If name differs from passport | 600 Tourist |
+| Other passports / other names | Declaration | If applicable | 601 / 600 |
+| Purpose of visit / plans in Australia | Free-text + itinerary | Always | 600 Tourist (Genuine visitor) |
+| Funds / access to money | Bank statements (3 months), pay slips, tax records, term deposits | Always | 600 Tourist (Have enough money) |
+| Invitation from relative/friend | Letter (relationship, purpose, length, accommodation; + their funds if they pay) | If visiting/staying with someone | 600 Tourist |
+| Ties to home country / intent to return | Employer letter, study proof, family, assets | Always | 600 Tourist |
+| Genuine visitor / genuine temporary entrant declaration | Declaration | Always | 600 Tourist |
+| Sponsor details | Sponsor identity + relationship evidence | Sponsored Family stream only | 600 Sponsored |
+| Security bond | Payable by sponsor if requested | Sponsored Family, if requested | 600 Sponsored |
+| Health declarations / examinations | Panel-physician exam if triggered | Long stay, health-care/hospital, prior health failure, or if requested | 600 Tourist; Health req |
+| Character declarations | Criminal-conviction declaration; military service; police certificate | Always declare; certificate if requested | 600 Tourist; Character req |
+| Previous travel / visa refusals | Declaration | Always | 601/651 (accurate info) |
+| Longer-visa request | Reason + evidence | If requesting >standard stay / parent applicants | 600 Tourist |
+| Minor (under 18) details + consent | Birth cert / family book / court docs; Form 1229 or statutory declaration; Form 1257 if not staying with relative/guardian | Applicant under 18 | 600 Tourist |
+
+For **601 (ETA app)** the in-app flow captures: passport scan, live photo, criminal-conviction declaration, prior names, Australian contact details, other passports, payment. For **651** the key checks are name spelling, eligible-passport confirmation, DOB, email, criminal-conduct declaration.
+
+## Documents
+
+Cite official source per mandatory item. "601/651/600" indicate which route(s) the item applies to.
+
+**Always required**
+- **Valid passport** (bio/photo page; for 600 provide photo, personal-details and issue/expiry pages). 601/651/600.
+- **Live facial image / photo** — captured in the ETA app (601); standard identity for 651/600.
+- **Evidence of sufficient funds** (600: itemised personal bank statements for a 3-month period, pay slips, audited accounts, tax records, term deposits). 651 requires an "enough money" declaration; 600 requires documentary proof.
+- **Genuine-visitor / intent-to-return evidence** (600: employer letter, study proof, family in home country, property/assets).
+
+**Conditional**
+- **Letter of invitation** from Australian relative/friend (+ proof of their funds if they will pay). Trigger: visiting/staying with someone; also the without-sponsor alternative to the Sponsored Family stream.
+- **Sponsorship documents + sponsor** — Sponsored Family stream only; sponsor must be eligible; relationship evidence; **security bond** if the Department requests.
+- **Police certificate(s)** — where character concerns / criminal conviction, or if requested. An ETA/eVisitor applicant with a criminal conviction in any country should apply **subclass 600.**
+- **Military service record / discharge papers** — 600, if applicable.
+- **Health examinations** — panel-physician exams if triggered (long stay, health-care/hospital environments, prior health-requirement failure, or if requested).
+- **Change-of-name / national ID** documents — if name differs or held.
+- **Longer-visa evidence** — e.g. proof child is AU citizen/PR (parents).
+
+**Minors (under 18) — conditional**
+- Birth certificate showing both parents (or family book / government ID / court document / family census register).
+- Guardianship/adoption proof if not biological parents.
+- **Form 1229** (consent to grant a visa to a child under 18) or a statutory declaration of consent, plus signed/photo ID of the consenter.
+- **Form 1257** (Undertaking declaration) if the child is not staying with a relative/legal guardian.
+
+**Location-specific / representation**
+- Non-English documents must be translated to English; in-Australia translators must be NAATI-accredited; overseas translators must state name, address/phone, qualifications (in English).
+- Documents scanned/photographed in colour, clear, multi-page saved as one file.
+- **Form 956A** (authorised recipient) / **Form 956** (registered migration agent, legal practitioner, exempt person) if using a representative.
+
+**Generated after submission**
+- **Visa grant notice** (grant number, start date, conditions) or refusal notice with review rights — issued in writing.
+- **Form 1554** (ETA Request for further processing) — only if the Department requests further ETA processing.
+
+## Portal Workflow
+
+### Australian ETA app (subclass 601)
+1. Check passport validity; **download the Australian ETA app** (Apple Store / Google Play).
+2. Device requirements: camera, **NFC enabled**, location services enabled, valid email, valid payment method.
+3. In-app: **scan passport → take a live photo → answer questions** (criminal convictions, prior names, Australian contact details, other passports).
+4. **Pay AUD 20 service fee** in-app and submit. Each person needs a separate application.
+5. Result usually immediate by email; do not book travel until granted.
+6. Post-grant: check status via **VEVO** or the app's "Visa check"; ETA is linked to the passport (no label). If further processing is needed, the Department sends a link to submit an online form in ImmiAccount + **Form 1554**.
+
+*(In-app screens are login-walled/device-side; steps above are the publicly documented flow.)*
+
+### ImmiAccount (subclass 651 and 600)
+1. **Create / log in to ImmiAccount.** *[account creation public; the application editor is login-walled]*
+2. Start a new application: 651 → form **`TV-AP-651`**; 600 (any stream) → form **`VSS-AP-600`**.
+3. Complete the online form (identity, purpose, funds, genuine-visitor, character/health declarations, sponsor if Sponsored Family). *[login-walled]*
+4. **Attach documents** (colour scans; translations where needed); submit family applications together where applicable. *[login-walled]*
+5. **Pay the Visa Application Charge** — none for 651; for 600 the base VAC per stream. Application not processed until paid. *[login-walled]*
+6. **Biometrics** — provide if the Department notifies you. *[triggered]*
+7. **Health examinations** — complete before applying or when requested. *[triggered]*
+8. **Outcome** — written grant notice or refusal with review rights.
+9. Post-grant: check details/conditions and prove your visa via **VEVO**; complete an Incoming Passenger Card at the border.
+
+## Review Risks
+
+- **Route selection (601 vs 651 vs 600):** ETA (601) is app-only and limited to the ETA-eligible passport list. eVisitor (651) is ImmiAccount-only, free, for the European eligible list (UK only British Citizen; **BN(O) qualifies for ETA but NOT eVisitor**; British Protected Person/Subject qualify for neither). Overlap exists (several EU states on both) — 651 is free while 601 costs AUD 20. Everyone else, or anyone with a **criminal conviction, prior health-requirement failure, health-care/hospital environment intent, sponsored-family visit, ADS tour, or need for >3-month/long-validity stay**, must use **subclass 600.**
+- **Genuine-visitor / genuine-temporary-entrant test:** All routes require genuine temporary intent. Frequent/long stays can prompt questioning and possible cancellation. 600 requires documentary evidence of ties and intent to return.
+- **Health & character triggers:** Any criminal conviction (any country) or prior health-requirement failure routes the applicant off 601/651 onto 600. Health exams/police certificates are request-driven.
+- **Funds:** 600 expects itemised 3-month bank statements plus supporting financial evidence; thin or unexplained funds are a common refusal driver.
+- **Sponsored streams:** Sponsored Family (600) needs an eligible sponsor and relationship evidence; the Department may require a **security bond** from the sponsor. The Tourist stream (invitation letter instead of sponsor) is often simpler.
+- **Minors:** Consent (Form 1229 or statutory declaration), guardianship proof, and Form 1257 (if not staying with relative/guardian) are frequent gaps.
+- **Fee freshness:** VAC figures change on the 1 July annual cycle; a Pacific Island / Timor-Leste concession and PNG passport arrangements take effect 1 July 2026. Always re-confirm via the Visa Pricing Estimator.
+- **Passport linkage:** ETA/eVisitor/600 grants are digitally linked to the passport. A new/expired passport **ceases an ETA** and requires re-application.

package/skill/references/countries/ca.md

@@ -0,0 +1,124 @@
+# Canada Adapter: Temporary Resident Visa (visitor visa) via IRCC
+
+Support level: `full_adapter` (rules + document-checklist depth; the IRCC secure account is login-walled and not field-scriptable). Verified against IRCC / canada.ca on 2026-07-20. A few specifics are marked **pending exact-page reconfirmation** because those pages 404'd or dropped the connection on the verification date.
+
+## Metadata
+
+- **Country/area:** Canada
+- **Supported visa routes:**
+  - **Temporary Resident Visa (TRV) / visitor visa** — the primary route this adapter scripts.
+  - **eTA (Electronic Travel Authorization)** — a *separate, simpler* route for visa-exempt foreign nationals arriving **by air**. Not a visa. Determines whether the visa workflow applies at all.
+  - **Super Visa** — long-validity multiple-entry visa for parents/grandparents of Canadian citizens/PRs/registered Indians. A TRV variant with extra insurance + host-income requirements.
+- **Applicant assumptions:** Nationality- and residence-agnostic. The responsible visa office is the IRCC visa office / VAC network servicing the applicant's country of residence; country-specific instructions attach to the online personalized document checklist. Applicant is assumed to be **outside Canada** at time of application.
+- **Last verified date:** 2026-07-20
+- **Official source IDs/URLs:** see `official-sources.json`.
+- **Support level:** `full_adapter`
+
+## Route Map
+
+### Branch A — eTA (visa-exempt air travelers) — NOT a visa workflow
+- **Official name:** Electronic Travel Authorization (eTA).
+- **Applies to:** Visa-exempt foreign nationals flying to or transiting through a Canadian airport. Visa-exempt travelers "do not need an eTA when arriving by car, bus, train or boat (including a cruise ship)."
+- **Exempt from eTA (carry other ID instead):** U.S. citizens (carry valid U.S. passport); U.S. lawful permanent residents (carry valid PR card [I-551] or re-entry permit [I-327] **plus** a valid passport of nationality); Canadian citizens/dual citizens (Canadian passport); Canadian PRs (PR card / PR travel document).
+- **Duration/validity:** Valid up to five years or until the passport expires, electronically linked to the passport. Does not guarantee entry.
+- **Split rule (load-bearing):** Visa-exempt + air → **use the eTA route, not this TRV workflow.** Visa-exempt + land/sea → nothing needed. Some visa-required nationals may be eTA-eligible for air travel but **still need a TRV for land/sea entry.**
+- **Fee:** eTA is CAD $7 (confirm on the eTA facts page at apply time — the facts page opened on 2026-07-20 did not restate the amount, so treat as **pending exact-page reconfirmation**).
+- **Timatic/carrier cross-check:** Airlines validate eTA/visa status at boarding against IRCC systems; mismatch = denied boarding. Cross-check nationality + arrival mode against the eTA-vs-TRV decision before assuming the visa workflow applies.
+
+### Branch B — Temporary Resident Visa (visitor visa)
+- **Official name:** Temporary Resident Visa (TRV), commonly "visitor visa."
+- **Purpose/duration boundary:** Tourism, visiting family/friends, business visits, transit, event attendance (incl. FIFA World Cup 2026 match attendance). Standard authorized stay on entry is up to 6 months (determined by the border officer, not the visa). Stays intended >6 months trigger medical-exam rules.
+- **Eligibility inputs:** valid passport/travel document; "good health"; "no criminal or immigration-related convictions"; must convince an officer of ties (job, home, financial assets, family) that will take you back; must convince an officer you will leave at the end of the visit; enough money for the stay; not otherwise inadmissible.
+- **Application authority & responsible office:** IRCC. Visa is printed by a visa office outside Canada; country-specific document instructions attach via the online personalized checklist. VAC handles logistics (biometrics, document intake) only.
+- **Process:** Apply **online** via the IRCC account. Two online options: **IRCC Portal** and **IRCC Portal – New version** (new version limited to applicants 18+, applying alone, first-time, not using a representative). Applicants may also use the **IRCC secure account**. Paper only if unable to apply online (disability, or refugee/stateless/non-citizen travel documents).
+- **Form/portal:** Guide **5256**; core form **IMM 5257** (Application for TRV / Details of Visit); supporting IMM 5645 (Family Information), IMM 5476 (Use of a Representative), IMM 5475 (Authority to Release Personal Information), IMM 5484 (Document Checklist).
+- **Fee (CAD):** Visitor visa processing — **$100 individual**; **$500 family (5+)**. Biometrics — **$85 individual**; **$170 family maximum**. Some applicants may be exempt. Payment: Visa, MasterCard, Amex, JCB, UnionPay (online), Visa Debit; cardholder need not be the applicant.
+- **Biometrics:** Required for temporary residence "except US nationals," unless exempt (children under 14, applicants over 79). **10-year reuse:** biometrics are valid for 10 years; if given within the last 10 years and still valid, generally not repeated for a new TR application. *(Exact reuse wording could not be opened on a single live page on 2026-07-20 — treat the 10-year figure as pending exact-page reconfirmation; the facts page confirmed the fee/exemption structure.)*
+- **Appointment:** After submitting, applicant receives a **Biometrics Instruction Letter (BIL)** and books biometrics at a VAC promptly.
+- **Visa validity:** May be issued for up to 10 years or until the expiry of the passport or biometrics, whichever comes first. Renewing biometrics does not automatically extend the visa to 10 years.
+- **Medical exam triggers:** Stays **≤6 months** — generally not required, except jobs in close contact with people (health care, clinical lab, childcare, medical students) and certain agricultural workers who lived in/visited a designated country 6+ consecutive months in the prior year. Stays **>6 months** — required if at least one applies: lived in/traveled to a designated country for 6+ consecutive months in the year before coming; OR coming to work a public-health-sensitive job; OR applying for a parent/grandparent super visa. The designated-country list was updated **November 3, 2025** — re-check the current list.
+- **Policy freshness trigger:** Re-verify each cycle: fee schedule, biometrics fee/exemptions, medical designated-country list (last change 2025-11-03), and LICO income tables (annual).
+
+### Branch C — Super Visa (parents & grandparents)
+- **Who:** Parents/grandparents (biological or adopted) of a child/grandchild who is a Canadian citizen, PR, or registered Indian, aged 18+ and living in Canada. Cannot include dependants.
+- **Duration:** Multiple entry, valid up to 10 years; each stay up to 5 years at a time.
+- **Fee:** From CAD $100 (+ biometrics).
+- **Extra requirements:** mandatory medical exam; **$100,000** minimum private medical insurance covering health care, hospitalization, and repatriation, valid ≥1 year from date of entry; host must meet or exceed **minimum necessary income (LICO)**; signed host letter of invitation.
+
+## Question Overlay
+(Fields BEYOND a universal core intake of name/DOB/nationality/passport/contact. IMM 5257 / Details of Visit order where known.)
+
+| # | Field label | Expected format | Conditional trigger | Evidence source |
+|---|---|---|---|---|
+| 1 | Purpose of visit | Enum: tourism / visit family / business / transit / study<6mo / other + free text | Always | IMM 5257; apply-page purpose router |
+| 2 | Intended arrival / departure dates & duration | Dates; duration | Always; >6 months flags medical | IMM 5257; medical-exam rules |
+| 3 | Funds available during stay | Amount in CAD | Always | Guide 5256 |
+| 4 | Who is paying / funds source | Self / host / employer + relationship | Always | Guide 5256 |
+| 5 | Ties to home country | Free text + evidence: job, home, assets, family | Always (officer-weighted) | Eligibility page |
+| 6 | Family in Canada | Names, status, relationship, address | If any relative in Canada | IMM 5645; invitation logic |
+| 7 | Host / invitation | Host name, status, address; invitation letter | If visiting a person or business | Apply page |
+| 8 | Previous travel history (10 yr) | Countries, dates, prior passports/visas/permits | Always | Apply page |
+| 9 | Previous Canada applications / permits | UCI, prior TRV/study/work/PR, dates | If ever applied to Canada | IRCC account linking; IMM 5257 |
+| 10 | Prior refusals / removals (any country incl. US) | Yes/No + details | Always — must disclose | Eligibility (admissibility) |
+| 11 | Criminal / immigration convictions | Yes/No + details | Always | Eligibility |
+| 12 | Occupation / employer | Employer, role, salary, contact | If employed | Apply page (employer letter ≤3 months old) |
+| 13 | Representative used | Yes/No + rep details | If using paid/unpaid rep | IMM 5476 |
+| 14 | Minor traveling | Custody, parental authorization letter | If applicant/accompanied child is a minor | Guide 5256 |
+| 15 | Biometrics given in last 10 years? | Yes/No + prior UCI/date | Determines whether biometrics repeat needed | Biometrics facts (reuse — pending exact-page reconfirm) |
+| 16 *(Super Visa)* | Host income (LICO) | Host income vs. LICO for family size | Super Visa only | Super Visa manual |
+| 17 *(Super Visa)* | Medical insurance policy | Insurer, coverage amount, validity dates | Super Visa only | Super Visa manual ($100k / 1yr) |
+
+## Documents
+
+### Always required (TRV)
+- **Valid passport / travel document** — valid at least 6 months beyond travel date; color copy of the bio page plus all pages with stamps/visas. Not accepted: Somali passports, non-machine-readable Czech passports, temporary South African passports, provisional Venezuelan passports.
+- **Digital photo** — meeting IRCC visa photo specifications (or none in-app if a biometrics photo is being captured). *Exact spec (frame 35×45 mm, chin-to-crown ~31–36 mm, within 6 months, plain light background) is standard IRCC but the dedicated photo-spec page 404'd on 2026-07-20 — treat exact numeric spec as pending exact-page reconfirmation via the visa photo appendix linked from Guide 5256.*
+- **Proof of funds** — enough money to maintain yourself and to return home; typically bank statements with at least 6 months of account details/balances.
+- **Purpose-of-visit evidence / itinerary** — flight details, accommodation, event registration.
+- **Family Information (IMM 5645)** and, if using one, **Use of a Representative (IMM 5476)**.
+
+### Conditional (TRV)
+- **Letter of invitation** — from a Canadian person or business, if visiting someone/an organization.
+- **Employer letter** — on letterhead, dated ≤3 months before applying, confirming job/salary/manager contact, if employed.
+- **Travel history** — prior passports/visas/permits used within the last 10 years.
+- **Minor authorization letter** — for a minor traveling alone or with one parent; signed by both parents/legal guardians.
+- **Medical exam (eMedical) results** — if a medical trigger applies.
+- **Authority to Release Personal Information (IMM 5475)** — if authorizing release to a third party.
+
+### Location-specific
+- **Personalized document checklist** — generated online per applicant; the responsible visa office attaches country-specific instructions and may require additional documents.
+
+### Super Visa additional (mandatory for Branch C)
+- **Private medical insurance** — minimum **$100,000** emergency coverage; must cover health care, hospitalization and repatriation; valid for a minimum of 1 year from the date of entry and for each entry; from a Canadian insurer or an OSFI-listed/minister-approved foreign insurer; **quotes are not accepted.**
+- **Host letter of invitation + proof of host income at/above LICO** — LICO figures track Statistics Canada low-income cut-offs and change annually; pull the current table at application time.
+- **Immigration medical exam** — mandatory for super visa.
+
+### Generated after submission
+- **Biometrics Instruction Letter (BIL)** — issued in-account after submission; book VAC appointment promptly.
+- **Personalized document checklist** — produced by the online questionnaire.
+- **Correspondence / decision letter & (if approved) visa counterfoil** — delivered via IRCC account; passport submitted to VAC for visa printing.
+
+## Portal Workflow (IRCC secure account / IRCC Portal)
+
+**Publicly knowable (no login):**
+- **Account options / sign-in:** GCKey (reusable username/password) or a Canadian Interac® Sign-In Partner. New users create a new account in the IRCC secure account.
+- **Two-factor authentication:** choose a second authentication method to use each sign-in; save recovery codes.
+- **Application options:** IRCC Portal, IRCC Portal – New version (18+, applying alone, first-time, no representative), or IRCC secure account.
+- **Personal reference code:** from the "Come to Canada" eligibility tool; expires 60 days after issue; used to start/link an application.
+- **Linking applications:** if items are missing you may link the application to your account.
+- **Fee payment:** paid online at the end via credit/debit; cardholder need not be the applicant.
+- **Biometrics:** BIL issued after submission; biometrics given at a VAC.
+
+**Login-walled (not publicly scrapable — do NOT attempt field-level scripting):**
+- The authenticated dashboard, the actual application forms/upload slots, personalized document checklist contents, message centre, application status, and the biometrics letter itself all sit behind GCKey/Sign-In-Partner authentication. This adapter is rules + checklist depth only.
+
+## Review Risks
+
+1. **eTA-vs-TRV confusion (highest-impact):** Confirm nationality **and** arrival mode before assuming the visa workflow. Visa-exempt + air → eTA (not TRV). Visa-exempt + land/sea → nothing. U.S. citizens/green-card holders → neither eTA nor TRV (carry ID). Visa-required + air → may be eTA-eligible but still needs a TRV for land/sea. Wrong route = denied boarding.
+2. **Biometrics reuse window:** Check for valid biometrics given in the last 10 years before paying the $85/$170 fee or booking a VAC slot. (Reuse rule wording is pending exact-page reconfirmation.)
+3. **Proof-of-funds sufficiency:** No fixed IRCC dollar figure for visitors — officer-assessed against trip length and accommodation. Under-documented funds are a leading refusal reason; recommend ~6 months of statements plus a funds-source narrative.
+4. **Refusal-history disclosure:** All prior refusals/removals from any country (notably the U.S.) must be disclosed. Non-disclosure risks misrepresentation findings (potential multi-year inadmissibility).
+5. **Dual intent:** Visiting while also pursuing PR is permissible, but the applicant must still satisfy the officer they will leave at the end of the visit. Ties evidence must be genuine and specific.
+6. **Minors / custody:** Minors traveling alone or with one parent need an authorization letter signed by both parents/legal guardians; custody/consent gaps trigger scrutiny.
+7. **Super Visa specifics:** Insurance must be a purchased policy of ≥$100,000 valid ≥1 year (quotes rejected); host income must meet current-year LICO; medical exam is mandatory. Any missing = refusal.
+8. **Freshness:** Medical designated-country list changed 2025-11-03; LICO and fees update periodically — re-verify at application time.

package/skill/references/countries/jp.md

@@ -0,0 +1,133 @@
+# Japan Adapter: Short-Term Stay (Temporary Visitor) visa
+
+Support level: `full_adapter` (rules + document-checklist depth). Covers tourism, visiting relatives/friends, and short-term business (no remunerated activity). Rules verified live against mofa.go.jp on 2026-07-20.
+
+## Metadata
+
+- **Country/area:** Japan
+- **Visa class covered:** Short-Term Stay (Temporary Visitor / 短期滞在).
+- **Supported visa routes:**
+  1. **Visa exemption (visa-free short-term stay)** — Japan has reciprocal visa-exemption arrangements with 74 countries/regions (MOFA, dated Sept 1, 2025). Exempt travellers need NO visa for short-term stay. **Must be checked per nationality against the official MOFA exemption page** — the list changes and carries per-country notes (e.g., Indonesia requires prior "Visa Waiver Registration"; Thailand/Indonesia 15-day stay; Brunei/Qatar 30-day; others up to 90 days). Do NOT hard-code a stale list.
+  2. **JAPAN eVISA (electronic visa)** — online single-entry short-term-stay visa, **tourism purpose only**, up to 90 days, for ordinary-passport holders who are NOT visa-exempt and reside in eligible countries/regions. Issued electronically (no sticker); displayed as a "Visa Issuance Notice" at boarding.
+  3. **Consular short-term-stay visa** — the standard route via the Japanese Embassy/Consulate-General/Consular Office (or, in some jurisdictions, only via an accredited travel agency / Japan Visa Application Centre). Covers all short-term purposes and single- or multiple-entry.
+- **Purpose-driven document differences:** Tourism, visiting relatives/friends, and short-term business each require a distinct evidence set (see Documents). Tourism is lightest; visiting relatives/friends and business add inviter/guarantor documents.
+- **Applicant assumptions:** Nationality- and residence-agnostic. Applicable route is a function of (nationality × country of residence). **In some jurisdictions applications cannot be lodged directly at the mission and MUST go through an accredited/approved travel agency** — most notably China (all short-term-stay purposes route through an approved Chinese travel agency), and packaged-tour routing for the Philippines and Viet Nam.
+- **Last verified date:** 2026-07-20
+- **Official source IDs/URLs:** see `official-sources.json`.
+- **Support level:** `full_adapter`
+
+## Route Map
+
+### Route 0 — Visa exemption (pre-route gate, not an application)
+- **Official name:** Exemption of Visa (Short-Term Stay).
+- **Purpose/duration:** Short-term stay; stay period granted at landing is 90 days for most, 30 days (Brunei, Qatar), or 15 days (Indonesia, Thailand). Not extendable as a rule; no remunerated activity.
+- **Eligibility:** Nationals of the 74 exemption countries/regions on the MOFA novisa page, subject to per-country notes. **Determination is per nationality — always resolve live.**
+- **Authority:** MOFA (rules); landing permission granted by Immigration at port of entry (not a guarantee of entry).
+- **Process:** No visa application. Traveller boards and seeks landing permission on arrival.
+- **Freshness trigger:** MOFA novisa page "last updated" date changes; any note about a suspended/added country.
+- **Timatic/carrier note:** Carriers check visa/exemption status at check-in. If exempt, no visa; if not exempt, proceed to eVISA or consular route below.
+
+### Route 1 — JAPAN eVISA (single-entry short-term, tourism only)
+- **Official name:** JAPAN eVISA system (electronic visa).
+- **Purpose/duration:** Single-entry short-term stay for **tourism**, up to 90 days. (Special stay lengths: China residents 15/30 days; Viet Nam and Philippines residents 15 days.)
+- **Eligibility (per MOFA eVISA info, dated May 15, 2026):** Ordinary-passport holder; NOT a national of a visa-exemption country; travelling by international flight or scheduled passenger ferry; single-entry, tourism, <90 days. Direct online application for residents of: Australia, Brazil, Cambodia, Canada, Saudi Arabia, South Africa, Taiwan, United Kingdom, U.S.A. Additional residence groups apply **through an accredited agency**: China, Philippines and Viet Nam (packaged tour), and Hong Kong, India, Indonesia, Macau, Mongolia, Republic of Korea (except Jeju consulate jurisdiction), Singapore, UAE. Not available if: dual Japanese national; multiple-entry sought; purpose other than tourism; prior conviction/deportation.
+- **Application authority & mission:** MOFA operates the portal; the responsible overseas establishment examines and may summon for interview.
+- **Process (portal):** (1) verify visa need & documents, (2) enter application information, (3) receive examination result by email, (4) pay fee online by credit card (only online payment; no cash), (5) eVISA issued.
+- **Form/portal:** eVISA portal (https://www.evisa.mofa.go.jp/index). Required documents vary by residence/nationality and surface inside the portal (login-walled).
+- **Fee:** Set per reciprocity/nationality; paid online by card. Some nationalities fee-exempt by bilateral agreement (portal auto-issues). Exact figure confirmed inside portal / by responsible mission — treat numeric fee as **verify per mission**.
+- **Biometrics note:** No routine biometric capture for eVISA; in-person interview may be requested.
+- **Freshness trigger:** MOFA eVISA "As of <date>" changes; portal eligibility list changes.
+- **Timatic/carrier note:** No sticker. Traveller must display the "Visa Issuance Notice" (with QR) **live on a device** at check-in — PDF, screenshot, or printout are NOT accepted (proxy applicants excepted). Carrier verifies at boarding.
+
+### Route 2 — Consular short-term-stay visa (standard)
+- **Official name:** Short-Term Stay visa (Temporary Visitor).
+- **Purpose/duration:** Tourism, visiting relatives/friends, or short-term business affairs; typically up to 90 days per stay; single- or multiple-entry (multiple-entry has additional criteria/forms). No remunerated activity.
+- **Eligibility:** Non-exempt travellers, or those needing a purpose the eVISA does not cover (visiting relatives/friends, business, multiple-entry).
+- **Application authority & responsible mission:** Japanese Embassy / Consulate-General / Consular Office with jurisdiction over the applicant's place of residence (Taiwan: Taipei/Kaohsiung offices of the Japan-Taiwan Exchange Association). MOFA sets rules.
+- **Process:** Prepare documents → submit at the consular section of the responsible mission, **or at an accredited agency / Japan Visa Application Centre, or online, by the method the responsible mission specifies**. Applications cannot be made inside Japan. Inviter/guarantor sends their documents to the applicant.
+- **Accredited-agency-only jurisdictions:** China — all short-term-stay purposes must be lodged **through an approved Chinese travel agency**; the applicant cannot apply directly. Philippines/Viet Nam packaged-tour tourism similarly route through designated agencies.
+- **Form/portal:** MOFA "Visa application form (English)" PDF. Supporting form templates (letter of guarantee, invitation letters single/multiple, list of applicants, company overview, travel itinerary) linked from the MOFA short-term-stay page.
+- **Fee:** Reciprocity-based and **set per mission**, paid at the mission/agency. MOFA does not publish a single universal figure; missions commonly state roughly 3,000 yen (single-entry), 6,000 yen (multiple-entry), 700 yen (transit) or local-currency equivalents — but this **varies by nationality/reciprocal agreement and some categories are waived**. Marked: numeric fee = **verify per responsible mission.**
+- **Biometrics note:** No routine consular biometric enrolment for short-term stay in general; some missions/agencies may require in-person submission or interview.
+- **Freshness trigger:** MOFA short-term-stay / responsible mission page date changes; checklist PDF revision date; change to accredited-agency list.
+- **Timatic/carrier note:** Visa sticker affixed in passport; carrier verifies at check-in. Processing time is at least 5 working days from the day after receipt; additional documents may be requested case-by-case.
+
+## Question Overlay
+
+Beyond core intake (identity, passport, travel dates), Japan's short-term form/checklist order where publicly known (source: MOFA application form, single-entry checklist PDF):
+
+| Field label | Format | Conditional trigger | Evidence source |
+|---|---|---|---|
+| Purpose of visit (Tourism / Visiting relatives/friends / Short-term business) | Enum | Always | Applicant declaration; drives document set |
+| Passport number, type, nationality | String | Always | Passport |
+| Date of arrival / departure (DD/MM/YYYY) | Date | Always | Flight/ship itinerary |
+| Flight/ship number & itinerary | String | Always | Booking |
+| Itinerary in Japan / schedule of stay (滞在予定表) | Structured day-by-day | Always (esp. visiting/business) | MOFA "Travel itinerary" template |
+| Guarantor (身元保証人) — name, address, relationship, occupation, income | Person/org | Business, or visiting relatives/friends where a guarantor covers expenses | Letter of Guarantee (MOFA template); guarantor proof of funds, Juminhyo |
+| Inviter (招へい人) — name, org, relationship, reason for invitation | Person/org | Visiting relatives/friends; business | Letter of Invitation (MOFA template); reason-for-invitation document |
+| Relationship to inviter/guarantor | Enum + evidence | Visiting relatives/friends | Kinship: birth/marriage certificate, family register (Kosekitohon). Friends: photos, emails, call history, letters |
+| Who pays travel expenses (self / inviter / guarantor) | Enum | Always | If self: applicant bank statement/income certificate. If guarantor: guarantor financial docs |
+| Proof of funds | Doc | Always (self-funded) or on guarantor | Income certificate / tax return by public agency, or bank statement / balance certificate |
+| Consent to accredited-agency handling of data & fee | Checkbox | When applying via accredited agency | MOFA application form |
+
+## Documents
+
+### Always required (all purposes) — source: MOFA single-entry checklist, application form
+- **Valid passport.**
+- **Visa application form ×1.**
+- **Photo ×1** — **45 mm × 35 mm** (or 2 in × 1.4 in), taken within the last 6 months, plain untextured background, face centered; not a re-shot passport/licence/group photo.
+- **Itinerary with flight/ship number and dates of arrival/departure.**
+- **Proof of ability to pay travel/stay expenses** (self-funded: income certificate or public-agency tax return, or bank statement / balance certificate).
+
+### Conditional — Tourism
+- **Daily itinerary/schedule of stay in Japan** (滞在予定表) — MOFA "Travel itinerary" template.
+
+### Conditional — Visiting relatives/friends
+- **Document proving kinship/friendship/acquaintance** — relatives: birth/marriage certificate, family register (Kosekitohon); friends/acquaintances: photos, emails, call history, letters.
+- **Letter of Invitation** (MOFA template).
+- **Reason-for-invitation document** (e.g., graduation/wedding notice, medical certificate).
+- **List of visa applicants** (if more than one applicant).
+- **Schedule of stay in Japan.**
+- **If a guarantor covers expenses:** Letter of Guarantee; guarantor proof of funds (income/taxation certificate or balance certificate; withholding-tax slip NOT accepted); Certificate of residence (Juminhyo) listing all family members' relationships; if guarantor is a foreign national, copy of both sides of Residence Card / special permanent resident certificate.
+
+### Conditional — Short-term business
+- **Document proving business purpose** (travel order from employer, letter from employer, or equivalent).
+- **Certificate of employment.**
+- **Invitation letter** or documents explaining activities (inter-company transaction agreement, conference materials).
+- **List of visa applicants** (if multiple).
+- **Schedule of stay in Japan.**
+- **If a guarantor in Japan covers expenses:** Letter of Guarantee + certified copy of corporation register or Overview of company/organization (waived if listed company filing quarterly reports; individual guarantor may substitute Certificate of employment).
+
+### Location-specific
+- **China residents (Chinese nationals):** documents defined and lodged by an **approved Chinese travel agency**; applicant does not apply directly.
+- **Nationality/residence-specific checklists** (single vs multiple entry, per region) linked from the MOFA short-term-stay page.
+- **Per-mission variations:** the responsible mission may add documents; confirm on its page.
+
+### Generated after submission
+- **eVISA:** "Visa Issuance Notice" (QR) displayed live on a device at check-in (Route 1).
+- **Consular:** visa sticker affixed in passport (Route 2).
+
+## Portal Workflow
+
+**JAPAN eVISA portal — publicly knowable steps:**
+1. **Eligibility check** (public) — confirm ordinary passport, non-exempt nationality, eligible residence, tourism, single-entry, <90 days, air/sea entry. Portal links to the MOFA exemption list.
+2. **Verify visa need & required documents** (partly public; exact doc set surfaces after residence/nationality selection).
+3. **Create account / enter application information** (*login/eligibility-walled*; personal data and uploads).
+4. **Examination** — mission may request an in-person interview (*walled*); result emailed.
+5. **Fee payment** (*walled*; online credit card only; auto-skipped if fee-exempt).
+6. **eVISA issuance** — issued electronically; no passport sticker.
+7. **At boarding/entry** — display "Visa Issuance Notice" (QR) live on a device; PDF/screenshot/printout not accepted (proxy applicants excepted).
+
+**Consular route:** Often lodged **through an accredited agency / Japan Visa Application Centre, not directly at the mission** — determined by the responsible mission. China short-term stay is agency-only. There is no single national online consular portal for these purposes; the method is specified per mission.
+
+## Review Risks
+
+- **Visa-exemption vs visa confusion:** The single biggest error. Many nationalities need NO visa for short-term stay; others do. Must resolve live per nationality (note per-country stay lengths and conditions, e.g., Indonesia's Visa Waiver Registration, Thailand/Indonesia 15 days). Do not apply for a visa when exempt, and do not assume exemption.
+- **eVISA eligibility scope:** eVISA is **tourism-only, single-entry, ordinary passport, eligible residence**. Any of visiting relatives/friends, business, study, work, transit, or multiple-entry disqualifies the eVISA path — route to consular. Direct-online vs agency-mediated eVISA residences differ.
+- **Accredited-agency-only jurisdictions:** China (all short-term purposes), and Philippines/Viet Nam packaged-tour tourism, cannot be lodged directly — must go through an approved/designated agency. Missing this produces a dead-end intake.
+- **Inviter/guarantor document burden:** Visiting relatives/friends and business add the heaviest set (invitation letter, reason for invitation, guarantor letter, guarantor financials, Juminhyo, corporation register). Distinguish "who pays" (self vs guarantor).
+- **Single vs multiple entry:** Different checklists, forms, and fees; multiple-entry has extra eligibility criteria.
+- **Purpose-specific doc sets:** Tourism, visiting relatives/friends, and business each have a distinct item list in the checklist PDF — do not merge them.
+- **Fee ambiguity:** Fees are reciprocity-based and set per mission; some categories waived by bilateral agreement. Never quote a fixed figure without confirming the responsible mission's tariff.
+- **eVISA presentation trap:** eVISA must be shown live on a device at boarding; PDF/screenshot/print is rejected — a common denied-boarding cause.
+- **Visa ≠ entry:** A visa (or exemption) does not guarantee entry; landing permission is decided by Immigration at the port.