@yukioa2z/visa-apply 3.0.0

package/skill/references/countries/schengen.md

@@ -0,0 +1,183 @@
+# Schengen Short-Stay (Type C) Visa — Country Adapter
+
+> Depth: rules + document-checklist. This adapter does NOT script per-field form entry: the actual
+> application portals (France-Visas, VIDEX, etc.) are login-walled and not publicly scrapable.
+> All rules below trace to official EU Commission sources opened live on 2026-07-20. Two figures
+> from the Visa Code (Regulation 810/2009) — the €30,000 insurance minimum and the 59-month
+> fingerprint-reuse window — could not be re-verified live (EUR-Lex was unreachable, HTTP 202
+> bot-challenge) and are marked **Pending official verification**.
+
+## Metadata
+
+- **Country/area:** Schengen Area. 30 countries listed as accepting Schengen visa applications on the
+  EU Commission "Applying for a Schengen visa" page (verified 2026-07-20):
+  Austria, Belgium, Bulgaria, Croatia, Czechia, Denmark, Estonia, Finland, France, Germany, Greece,
+  Hungary, Iceland, Italy, Latvia, Liechtenstein, Lithuania, Luxembourg, Malta, Netherlands, Norway,
+  Poland, Portugal, Romania, Slovakia, Slovenia, Spain, Sweden, Switzerland — plus the applicant
+  applies via the responsible member-state consulate. (Iceland, Liechtenstein, Norway, Switzerland
+  are Schengen-associated non-EU states; Bulgaria, Croatia, Romania are EU states in Schengen.)
+- **Supported visa routes:**
+  - **Uniform short-stay visa (Type C)** — stays of up to **90 days in any 180-day period** across
+    the whole Schengen area. Issued single-entry, multiple-entry, or as an **airport transit visa
+    (Type A)** (transit through the international zone only — does not permit entry).
+  - **ETIAS (not a visa — separate track for visa-EXEMPT travellers):** ETIAS is a travel
+    *authorisation*, not a visa. Nationals who are already visa-exempt for short stays do **not**
+    apply for a Type C visa; once ETIAS is operational they instead obtain an online ETIAS
+    authorisation. Visa-*required* nationals still need a Type C visa and are out of ETIAS scope.
+    ETIAS collects no biometrics, needs no consulate visit, and (per the ETIAS Regulation) is valid
+    3 years or until passport expiry, whichever is first. **Status on 2026-07-20: ETIAS is NOT in
+    operation and no applications are being collected** (per the Commission ETIAS page dated
+    2025-10-06). See Route Map note and Review Risks.
+- **Applicant assumptions:** Nationality- and residence-agnostic. This adapter applies to any non-EU
+  national who is **visa-required** for the Schengen area. Responsible consulate = the consulate of
+  the **main destination** (longest stay); if stays are of equal length across countries, the
+  consulate of the **country of first entry**; as a general rule the applicant applies at the
+  consulate with territorial responsibility for their country of legal residence.
+- **Last verified date:** 2026-07-20
+- **Official source IDs/URLs:** see `official-sources.json` block at end.
+- **Support level:** `full_adapter`
+
+## Route Map (Type C — Uniform Short-Stay Visa)
+
+| Attribute | Value (source) |
+|---|---|
+| **Official name** | Schengen visa (uniform short-stay visa, Type C). Sub-forms: single-entry, multiple-entry, airport transit visa (Type A). [EU: Applying for a Schengen visa] |
+| **Purpose / duration boundary** | Short, temporary visit of **up to 90 days in any 180-day period** anywhere in the Schengen area. Use the EU short-stay calculator to compute remaining allowance. [EU: Applying for a Schengen visa] |
+| **Eligibility inputs** | Applicant is a national of a country whose citizens are required to hold a visa to cross the Schengen external border (check the EU visa-requirement list); purpose fits short stay (tourism, business, family/friends visit, etc.); intends to leave before 90/180 exhausted. [EU: Applying for a Schengen visa] |
+| **Application authority & responsible post rule** | Lodge at the **consulate of the country you intend to visit**. Multiple countries → consulate of the country of **longest stay**. Equal-length stays → consulate of **first country of entry**. General rule: consulate with territorial responsibility for country of legal residence. [EU: Applying for a Schengen visa] |
+| **Process** | Hybrid. Application is lodged at a consulate or an authorised visa service centre (which collects on behalf of consulates). May require a prior appointment. Fingerprints collected in person at submission. Some member states use an online form/portal for pre-fill, but the lodging step is in-person/consular. [EU: Applying for a Schengen visa] |
+| **Form / portal** | Harmonised Schengen application form (Visa Code Annex I). Per-country online front-ends differ (e.g. France-Visas, Germany VIDEX). See Portal Workflow. |
+| **Fee** | **€90 adults; €45 children aged 6–12; €35 for applicants from Armenia, Azerbaijan, and Belarus; €67.50 for applicants from Cabo Verde.** An additional service fee may apply at visa service centres. The visa fee **can be waived for specific categories of applicants**. Under the Free Movement Directive, family members of EU/EEA citizens get a **free and accelerated** procedure. [EU: Applying for a Schengen visa] |
+| **Biometrics** | Fingerprints are collected in person when the application is submitted (exemptions exist for specific categories — e.g. children below the Visa Code age threshold, certain officials). Data is stored in the **Visa Information System (VIS)**; VIS performs biometric matching, primarily fingerprints. VIS retention is **5 years**. Fingerprint **59-month reuse window** (previously enrolled prints may be copied from an earlier application): **Pending official verification** (Visa Code Art. 13; EUR-Lex unreachable on 2026-07-20). [EU: Applying for a Schengen visa; EU: VIS] |
+| **Appointment / interview** | An appointment may be required before lodging. Submit **at least 15 days before** the intended journey and **no earlier than 6 months** beforehand. [EU: Applying for a Schengen visa] |
+| **Travel medical insurance minimum** | Medical insurance covering **emergency medical care, hospitalisation, and repatriation (including in the event of death)** is required. Minimum coverage amount of **€30,000**: **Pending official verification** (Visa Code Art. 15; EUR-Lex unreachable on 2026-07-20 — the EU applying page states the coverage scope but not the euro figure). [EU: Applying for a Schengen visa] |
+| **Processing time** | Normal **15 days**; may be extended to **up to 45 days** where a more detailed examination or additional documents are needed. [EU: Applying for a Schengen visa] |
+| **Policy freshness trigger** | Re-verify when: (a) the "Applying for a Schengen visa" page "last updated" date changes (was 2025-12-02); (b) ETIAS goes operational (changes the whole visa-exempt track); (c) the Entry/Exit System (EES) rollout alters biometric steps; (d) the €90 base fee is revised (Visa Code fee reviews occur periodically). |
+| **Timatic / carrier cross-check note** | A valid Type C visa is necessary but not sufficient for boarding: airlines check document validity against Timatic/IATA rules (passport validity, onward/return, insurance for some carriers). The visa does not guarantee entry — border guards make the final admission decision. Cross-check passport 3-months-beyond rule against carrier boarding rules before travel. |
+
+## Question Overlay
+
+Questions **beyond** a universal core intake (name, DOB, passport number, contact). These map to
+non-obvious fields of the harmonised Schengen application form (Visa Code Annex I) and the
+responsible-post logic. Field order approximates the harmonised form where known.
+
+| # | Field label | Expected format | Conditional trigger | Evidence source |
+|---|---|---|---|---|
+| 1 | Main destination member state | Country pick-list | Always. Drives which consulate is responsible. | Applicant's itinerary; longest-stay rule [EU] |
+| 2 | Member state of first entry | Country pick-list | Only when stays are of equal length across countries (tie-break for responsible post). | Itinerary [EU] |
+| 3 | Country of legal residence + residence-permit details | Country + permit no./validity | If applying outside country of nationality. Determines territorial competence. | Residence permit [EU] |
+| 4 | Purpose sub-type of journey | Enum (tourism / business / visiting family or friends / cultural / sports / official / medical / study / transit / other) | Always. Drives the supporting-document set. | Harmonised form field 21 |
+| 5 | Number of entries requested | single / two / multiple | Always. Multiple-entry needs stronger justification + longer passport-validity margin. | Harmonised form field 24 |
+| 6 | Intended dates of arrival/departure + duration | Dates + day count | Always. Checked against the 90/180 allowance. | Itinerary; short-stay calculator [EU] |
+| 7 | Sponsor / inviting person or company | Name, address, relationship; for company: reg. details | If purpose is family/friends visit or business, or if a host covers costs. | Invitation letter / employer letter |
+| 8 | Means of support (who pays) | Enum: self / sponsor + cover type (cash, traveller's cheques, credit card, prepaid accommodation/transport, other) | Always. Feeds proof-of-funds evidence. | Harmonised form field 33; bank statements |
+| 9 | Previous Schengen visas held | Yes/No + dates of last visa | Always. Multiple-entry / trusted-traveller assessment. | Prior passport/visa stickers |
+| 10 | Fingerprints previously collected | Yes/No + date (if within reuse window) | Always. Determines whether biometrics must be re-enrolled. | VIS record / prior application [reuse window Pending verification] |
+| 11 | Prior fingerprinting for a Schengen visa — sticker no. of prior visa | Visa sticker number | If prints previously given. | Prior visa sticker |
+| 12 | Family member of an EU/EEA/CH citizen | Yes/No + relationship + citizen's details | If applicable → free & accelerated Free-Movement-Directive procedure. | Marriage/birth cert; citizen's ID [EU] |
+| 13 | Minor applicant — parental authority / guardian | Guardian name, address, nationality | If applicant is a minor. | Birth certificate; consent (see Documents) |
+
+## Documents
+
+Nothing below is labelled mandatory unless an official EU source states it. The Commission's
+"Applying for a Schengen visa" page (verified 2026-07-20) lists the required set; euro-denominated
+insurance minimum is flagged Pending verification.
+
+### Always required (per EU "Applying for a Schengen visa")
+- **Valid passport.** Expiry date **at least 3 months after** the date of departure from the Schengen
+  area (for multiple-entry visas, at least 3 months after departure from the last country visited).
+  [EU]
+  - *Issued-within-last-10-years* and *at least 2 blank pages*: **Pending official verification** — these
+    are standard entry-condition rules (Schengen Borders Code) but were not stated on the EU applying
+    page and EUR-Lex was unreachable on 2026-07-20. Treat as strongly expected but verify per consulate.
+- **Completed visa application form** (harmonised Schengen form). [EU]
+- **Photo compliant with ICAO standards.** [EU]
+- **Travel medical insurance** covering emergency medical care, hospitalisation, and repatriation
+  (including in the event of death). Minimum **€30,000** coverage: **Pending official verification**
+  (scope confirmed by EU; euro figure from Visa Code Art. 15, EUR-Lex unreachable). [EU]
+- **Supporting documents on purpose of stay.** [EU]
+- **Evidence of financial means (proof of funds).** [EU]
+- **Evidence of accommodation during the stay.** [EU]
+- **Evidence of intention to return to the home country after the stay.** [EU]
+- **Fingerprints (biometrics)** collected at submission unless exempt. [EU]
+
+### Conditional (triggered by purpose / applicant profile)
+- **Tourism:** itinerary, hotel/host reservations, round-trip transport reservation. [purpose-of-stay evidence, EU]
+- **Business:** employer letter, invitation from Schengen company, event/trade-fair registration. [EU]
+- **Family/friends visit:** formal invitation / proof-of-sponsorship from the host (member-state-specific form in many countries). [EU]
+- **Minors:** birth certificate; **consent from parents/guardians** (and, when travelling without a
+  parent, notarised consent) — form varies by consulate. [minors handling, EU form field for guardian]
+- **Family member of an EU/EEA/CH national:** proof of the family relationship + the citizen's status
+  → free & accelerated procedure, reduced documentary burden. [EU]
+- **Fee-reduced/exempt categories:** documentation supporting reduced (€45 child 6–12; €35 AM/AZ/BY;
+  €67.50 CV) or waived fee. [EU]
+
+### Location-specific (per responsible member state / consulate)
+- **Additional documents may be requested by the consulates** — the EU explicitly notes consulates may
+  ask for more than the common core. [EU]
+- Member-state-specific invitation/obligation forms (e.g. formal sponsorship declarations), local
+  proof-of-funds thresholds, and local insurance-provider acceptance rules. Determined by the
+  responsible post — see Portal Workflow. (Consulate/VFS logistics; not rule authority.)
+
+### Generated after submission
+- Application receipt / reference number (from consulate or visa service centre).
+- Appointment confirmation (if biometrics/lodging appointment booked).
+- Payment receipt for the visa fee (+ service-centre fee if applicable).
+- Tracking reference (where a visa service centre handles logistics).
+- Decision: visa sticker (single/multiple-entry, with validity + allowed days) or a refusal notice
+  stating the reason and how to appeal. [EU: refusal always states reason + appeal route]
+
+## Portal Workflow
+
+Per-country portals differ and most require login. What is publicly knowable (page order) vs.
+login-walled is marked.
+
+**Publicly knowable, common flow:**
+1. Determine responsible member state (main destination / first entry / residence) — publicly
+   documented logic. [EU]
+2. Reach the responsible member state's official visa front-end (examples, not exhaustive):
+   France → **France-Visas**; Germany → **VIDEX** online form + consular/service-centre appointment
+   booking; Italy, Spain, Netherlands, etc. → their own consular systems. (URLs vary; some are
+   bot-protected — treat as logistics, not rule authority.)
+3. Complete the harmonised application form (online pre-fill or paper). — *Some portals login-walled.*
+4. Book an appointment (consulate or authorised visa service centre) where required. — *Booking
+   systems typically login-walled.*
+5. **VIS biometrics step:** attend in person; fingerprints + photo captured at lodging (unless a valid
+   prior enrolment can be reused — reuse window Pending verification). [EU: VIS]
+6. Upload / submit supporting documents (portal upload or in-person handover). — *Uploads
+   login-walled.*
+7. Pay the visa fee (+ any service-centre fee). — *Payment login-walled.*
+8. Receive receipt/tracking; await decision (15 days normal, up to 45). [EU]
+9. Collect passport with visa sticker or refusal notice. [EU]
+
+**Login-walled / not publicly scrapable:** account creation, per-field form submission, appointment
+calendars, document upload endpoints, payment. This adapter deliberately stops at rules +
+document-checklist depth for these.
+
+## Review Risks
+
+- **Source conflicts (ETIAS fee):** the current Commission ETIAS page (2025-10-06) states the fee is
+  **€20** (raised from the €7 in the 2018 ETIAS Regulation / 2018 Q&A memo). The €20 figure is
+  current but "enters into effect as soon as ETIAS is operational" and was still in a Council/Parliament
+  review window. Do not present €7 as current.
+- **Insurance / coverage edge cases:** the **€30,000 minimum is Pending official verification** here —
+  confirm against Visa Code Art. 15 or the responsible consulate before asserting the number. Coverage
+  must be valid across all Schengen states and for the full stay; single-country-only or
+  under-threshold policies are a common refusal cause. Multiple-entry applicants need policy validity
+  matching each trip.
+- **"Which consulate is responsible" disputes:** longest-stay vs. first-entry vs. legal-residence can
+  conflict for multi-country or equal-length itineraries; the wrong post will reject as not competent.
+  Resolve by the documented hierarchy: main destination (longest stay) → first entry (ties) → legal
+  residence.
+- **ETIAS-vs-visa confusion:** ETIAS is **not** a visa and applies only to visa-*exempt* nationals; a
+  visa-required applicant cannot substitute ETIAS. As of 2026-07-20 ETIAS is **not operational**, so
+  visa-exempt travellers currently need neither — but this will change on launch. Do not tell a
+  visa-required applicant to "just get ETIAS."
+- **Passport validity rule:** the 3-months-beyond-departure rule IS confirmed by the EU. The
+  issued-within-10-years and 2-blank-pages rules are **Pending verification** here (standard Schengen
+  Borders Code entry conditions, but not stated on the applying page and EUR-Lex was unreachable) —
+  verify before treating as hard requirements.
+- **Minors:** parental/guardian consent requirements and forms vary by consulate; missing notarised
+  consent for a child travelling without a parent is a frequent rejection. Birth certificate expected.
+- **Free Movement Directive path:** family members of EU/EEA/CH citizens are entitled to a free,
+  accelerated procedure — misclassifying them into the standard paid track is a rights/process error.

package/skill/references/countries/uk.md

@@ -0,0 +1,144 @@
+# United Kingdom Adapter: Standard Visitor visa (and the ETA branch)
+
+Support level: `full_adapter` (rules + document-checklist depth; the UKVI apply portal is login-walled and not field-scriptable). All fees, rules, and the full TB country list verified live against gov.uk on 2026-07-20.
+
+## Metadata
+
+- **Country/area:** United Kingdom (England, Scotland, Wales, Northern Ireland; ETA also covers Jersey, Guernsey, Isle of Man)
+- **Supported visa routes:**
+  - **Standard Visitor visa** — for nationals who must hold a visa before travel. Sub-purposes within the same route: tourism, family/friends, business activities, study (courses ≤6 months), Permitted Paid Engagement, academic/senior doctor/dentist, medical treatment. **Marriage/civil partnership is *not* covered** — a separate Marriage Visitor visa is required.
+  - **ETA branch (Electronic Travel Authorisation)** — for visa-exempt nationals who still need pre-travel authorisation. **An ETA is not a visa** and does not use the visa-application workflow.
+- **Applicant assumptions:** Nationality- and residence-agnostic. Whether a person needs a Standard Visitor visa, an ETA, or nothing is determined solely by nationality + purpose via the official "Check if you need a UK visa" tool. This adapter drives the visa-form workflow **only when the applicant needs a Standard Visitor visa**; ETA applicants are routed to the ETA app/online flow instead.
+- **Last verified date:** 2026-07-20
+- **Official source IDs/URLs:** see `official-sources.json` (all gov.uk / Home Office).
+- **Support level:** `full_adapter`
+
+## Route Map
+
+### Branch selector (run first)
+Determine, from nationality + purpose, which of three states applies (source: gov.uk/standard-visitor, gov.uk/eta):
+1. **Needs a Standard Visitor visa** → run the visa workflow below.
+2. **Needs an ETA** (visa-exempt but authorisation-required: typically Europe, USA, Australia, Canada and certain others) → run the ETA flow. **Not a visa.**
+3. **Needs neither** (e.g., British/Irish passport holders, or those with existing UK permission) → no pre-travel document; must still meet visitor eligibility at the border.
+
+Authoritative selector tool: "Check if you need a UK visa" — https://www.gov.uk/check-uk-visa
+
+> Note: Even someone who only *needs* an ETA (or nothing) **may choose to apply for a Standard Visitor visa** if they have a prior UK refusal or a criminal record (gov.uk/standard-visitor).
+
+### Standard Visitor visa
+- **Official name:** Standard Visitor visa (UK Visas and Immigration / UKVI, Home Office).
+- **Purpose/duration:** Visits for tourism, business, short study (≤6 months), permitted paid engagements, medical, academic. Usual max stay **6 months** per visit.
+- **Eligibility (source: gov.uk/standard-visitor):** passport/travel document valid for the whole stay; will leave at end of visit; can support self + dependants (or funded by someone); can pay for return/onward journey; will not make the UK a main home via frequent/successive visits.
+- **Application authority:** UKVI, applied for **online** before travel; biometrics at a Visa Application Centre (VAC).
+- **Form/portal:** Online apply (login-walled) via gov.uk "Apply now" → https://www.gov.uk/standard-visitor/apply-standard-visitor-visa
+- **Fees (current, GBP — source: gov.uk/standard-visitor/apply-standard-visitor-visa):**
+
+  | Product | Fee | Max stay |
+  |---|---|---|
+  | Standard Visitor visa | **£135** | 6 months |
+  | Standard Visitor (medical reasons) | £234 | 11 months |
+  | Standard Visitor (academics) | £234 | 12 months |
+  | Long-term 2-year | £506 | 6 months/visit |
+  | Long-term 5-year | £903 | 6 months/visit |
+  | Long-term 10-year | £1,128 | 6 months/visit |
+  | Visitor in Transit (transit-only) | £74.50 | — |
+
+- **Biometrics / BRP-vs-eVisa:** Fingerprints + photo taken at the VAC (or, for some, verified via the UK Immigration: ID Check app). The UK has **moved to eVisas** — a digital immigration status in a UKVI account — replacing physical BRPs/documents. Any passport vignette (sticker) issued remains valid until it expires. (Source: https://www.gov.uk/evisa)
+- **Appointment:** Booked as part of the online application; attend at a VAC. Passport returned same day; other documents may be retained during processing.
+- **Timing:** Earliest apply = **3 months** before travel. Decision **usually within 3 weeks**.
+- **Freshness trigger:** Re-verify if fee table changes, if eVisa rollout status changes, or if the visa/ETA nationality mapping changes. Re-check the visa-fees.homeoffice.gov.uk calculator and gov.uk/standard-visitor.
+- **Timatic/carrier note:** Carriers check pre-travel authorisation status. For visa nationals, the vignette/eVisa is the credential; for ETA nationals, the ETA is linked to the passport (no document shown beyond the passport).
+
+### ETA branch
+- **Official name:** Electronic Travel Authorisation (ETA), UKVI/Home Office. **Not a visa.**
+- **Who needs it:** Visa-exempt visitors "usually from Europe, the USA, Australia, Canada or certain other countries" (source: gov.uk/eta). Confirm per nationality via the check tool.
+- **Who does not:** British/Irish passport holders; anyone with existing permission to live/work/study in the UK. Every traveller including babies/children needs their own ETA. Also required for **landside transit** through a UK airport.
+- **Fee:** **£20** (source: gov.uk/eta/apply). Beware imitation sites charging more.
+- **Validity:** **2 years or until passport expires, whichever is sooner**; multiple visits, each up to 6 months.
+- **Apply:** UK ETA **app** (scan passport + face) or **online** (upload passport photo + face photo). Needs passport, email, card/Apple Pay/Google Pay. Decision **usually within a day**, allow up to **3 working days**. A 16-digit ETA reference is emailed; ETA is linked to the passport. (Source: https://www.gov.uk/eta/apply)
+- **Does not guarantee entry.**
+
+## Question Overlay
+
+Field order below reflects gov.uk's stated "Documents and information you'll need" (source: gov.uk/standard-visitor/apply-standard-visitor-visa). The actual multi-step portal is login-walled; exact widget order is not publicly scrapable.
+
+**Always asked (core intake):**
+
+| Field | Format | Trigger | Evidence source |
+|---|---|---|---|
+| Planned travel dates to UK | Date range | Always | Applicant plan |
+| Where you'll stay in the UK | Address/text | Always | Booking / host address |
+| Estimated trip cost | Amount (GBP) | Always | Applicant estimate |
+| Current home address + duration there | Address + years | Always | Proof of residence |
+| Parents' names + DOB (if known) | Names/dates | Always | — |
+| Annual income (if any) | Amount | Always | Payslips/bank |
+| Criminal / civil / immigration offences | Declaration | Always | Applicant declaration |
+
+**Conditional:**
+
+| Field | Trigger | Evidence source |
+|---|---|---|
+| Travel history for past 10 years | If applicable to circumstances | Passport stamps/visas |
+| Employer address + phone | If employed | Employer |
+| Partner name, DOB, passport number | If has partner | Partner passport |
+| Name/address of anyone paying for the trip | If third-party funded | Sponsor |
+| Name/address/passport of UK-based family | If family in UK | Relative documents |
+| TB certificate | Only if visiting **6+ months** and lived in a listed country (see Documents) | Approved TB clinic |
+| Accompanying adult(s) — up to 2 named | If applicant is under 18 | Adult passports; names appear on the visa |
+| Extra evidence for study / academic / PPE / medical sub-purposes | If that sub-purpose | Sub-purpose docs |
+
+Non-English/Welsh documents require **certified translations**.
+
+## Documents
+
+### Always (Standard Visitor)
+- **Passport / travel document** valid for the whole stay (source: gov.uk/standard-visitor, /apply-standard-visitor-visa). *Mandatory.*
+- **Biometrics** — fingerprints + photo taken at the VAC (source: /apply-standard-visitor-visa). *Mandatory.*
+- Evidence supporting eligibility: funds to support self/dependants, ability to pay return/onward journey, intent to leave (source: gov.uk/standard-visitor eligibility section). *Mandatory to demonstrate.*
+
+### Conditional
+- **Funds / income evidence** (bank statements, payslips) — to show maintenance and return-journey funds. (gov.uk/standard-visitor eligibility)
+- **Accommodation & travel plan** — where you'll stay, trip dates, cost. (/apply-standard-visitor-visa)
+- **Employment / purpose evidence** — employer details; for study/academic/PPE/medical, "additional documents" are required per sub-purpose. (/apply-standard-visitor-visa)
+- **Sponsor / third-party funder details** — name and address of anyone paying. (/apply-standard-visitor-visa)
+- **Minors (under 18):** written parental/guardian consent to travel (if travelling alone) + full contact details; proof of suitable accommodation; identification of up to 2 accompanying adults in the application; possible local-authority notification for private foster care. (Source: https://www.gov.uk/standard-visitor/if-youre-under-18)
+- **Certified translations** for any non-English/Welsh document. (/apply-standard-visitor-visa)
+
+### Location-specific — TB test certificate
+Required **only if** all are true: coming to the UK for **6 months or more**, AND lived 6+ months in a listed country, AND lived there (or another listed country) within the last 6 months. (Source: https://www.gov.uk/tb-test-visa)
+
+> Practical note: a **standard 6-month Standard Visitor visa does not trigger the TB requirement** (it applies at "6 months or more" stays). It becomes relevant for the 11-month medical and 12-month academic visitor variants. Certificate valid **6 months** from x-ray date. Full authoritative country list: gov.uk/tb-test-visa/countries-where-you-need-a-tb-test.
+
+### Generated after submission
+- **Decision email** from the Home Office (next-steps instructions).
+- **Visa vignette (sticker)** in passport where issued, and/or **eVisa** — a digital status accessed via a UKVI account; used to generate a share code to prove status (source: gov.uk/evisa). Physical BRPs have been replaced by eVisas.
+
+### ETA (documents)
+- Passport to be travelled with; a face photo (and passport photo if applying online for another person). No supporting-document upload beyond photos. (gov.uk/eta/apply)
+
+## Portal Workflow
+
+### Standard Visitor (gov.uk apply flow)
+1. **Check** you need a visa (public) — https://www.gov.uk/check-uk-visa
+2. **Start application** online via "Apply now" (public entry point; **login-walled** thereafter) — /apply-standard-visitor-visa. Can save and resume.
+3. **Complete the online form** (login-walled) — intake fields per Question Overlay.
+4. **Pay the fee** (login-walled). £135 for 6-month visit; other products per fee table.
+5. **Book biometrics appointment** at a VAC as part of the application (login-walled booking).
+6. **Attend the VAC** (or use the UK Immigration: ID Check app where offered) — prove identity, give fingerprints + photo, submit required documents. Passport returned same day.
+7. **Decision** by email (usually ≤3 weeks).
+8. **eVisa / UKVI account** — set up/access the UKVI account to view the digital status and generate share codes (public guidance: gov.uk/evisa; account access is login-walled).
+
+*Family members each need a separate application, fee, and appointment; a parent/partner may apply on behalf of a child/partner who cannot apply themselves.*
+
+### ETA flow (not the visa workflow)
+1. Confirm ETA (not visa) is required via the check tool.
+2. Apply via UK ETA app (scan passport + face) or online (upload photos). Pay £20.
+3. Await email decision (usually within a day; up to 3 working days) with 16-digit reference. ETA is linked to the passport.
+
+## Review Risks
+- **ETA-vs-visa confusion (highest risk):** An ETA is **not a visa** and uses a different app/online flow. Routing an ETA-eligible national into the Standard Visitor visa workflow (or vice versa) is the primary failure mode. Always run the check tool first, keyed on nationality **and** purpose.
+- **TB certificate by country/duration:** Only triggers at **6+ month** stays for listed countries — so it generally does **not** apply to the standard 6-month visitor visa, but **does** apply to the 11-month medical and 12-month academic variants. Watch the "get tested in another country" exceptions and the 6-month certificate validity.
+- **Funds sufficiency & intent to leave:** Weak maintenance evidence or a travel pattern suggesting the UK as a main home is a common refusal ground; long-term visas can be cancelled for repeated extended residence.
+- **eVisa transition:** No physical BRP for new grants; applicants must set up a UKVI account and use share codes to prove status. Legacy vignettes remain valid until expiry.
+- **Refusal / criminal history:** Must be declared. Prior refusal or a criminal record may make it advisable to apply for a Standard Visitor visa even when only an ETA/nothing is otherwise required.
+- **Minors:** Consent letters, accompanying-adult identification (max 2, named on the visa), and possible local-authority notification for private foster care are easy to miss.

package/skill/references/countries/us.md

@@ -0,0 +1,134 @@
+# United States Adapter: DS-160
+
+Support level: `full_adapter`
+
+Use for U.S. nonimmigrant and K visa applications that use DS-160. Resolve the interview post and country-specific scheduling/payment instructions from the responsible U.S. embassy or consulate before filing.
+
+## Ground Rules
+
+- The local HTML dossier is the single source of truth.
+- All applicant data stays local in the dossier; never transmit it externally or use it beyond this application.
+- Use official sources for current requirements, fees, appointment process, photo rules, and visa-category guidance.
+- The applicant performs final review, certification, signature, and submission.
+- Do not bypass CAPTCHA, anti-automation locks, or identity checks.
+- Do not invent unknown facts. Mark them `Pending`, `Unknown`, or `Does Not Apply` only when the official form supports that answer and the user confirms it.
+
+## Official Source Starting Points
+
+- State Department DS-160 overview: https://travel.state.gov/content/travel/en/us-visas/visa-information-resources/forms/ds-160-online-nonimmigrant-visa-application.html
+- DS-160 FAQ: https://travel.state.gov/content/travel/en/us-visas/visa-information-resources/forms/ds-160-online-nonimmigrant-visa-application/ds-160-faqs.html.html
+- CEAC DS-160 start/retrieve page: https://ceac.state.gov/genniv/
+- State Department visitor visa page: https://travel.state.gov/content/travel/en/us-visas/tourism-visit/visitor.html
+
+For country scheduling and fee payment, find the currently official embassy/consulate or visa scheduling portal for the applicant's interview country.
+
+## Intake Order
+
+Ask in DS-160 order unless the user is actively filling a different page.
+
+This adapter covers the DS-160 consular visa step only: preparing the online application and interview for a category the applicant already qualifies to apply for. It does not cover any USCIS petition or lottery step. For petition-based categories the workflow starts only after the petition is already approved.
+
+Before detailed intake, create a visa-type branch:
+
+- Core DS-160 questions are always required.
+- B-1, B-2, or B-1/B-2: travel purpose, itinerary, U.S. address/contact, trip payer, tourism/business boundary, employment/ties, and whether any work/study will occur.
+- F or M: school/program, SEVIS ID, I-20 details, funding, prior study/status history, and intended course of study.
+- J: exchange program, DS-2019 details, SEVIS ID, sponsor, funding, field/category, and two-year home residency relevance if prompted by the form.
+- H, L, O, P, Q, R, or similar petition-based work categories: petition/receipt details, petitioner/employer, job title, worksite, duties, and dates. Start only from an approved petition (Form I-797 approval notice); the USCIS registration/lottery (e.g. H-1B) and the employer's I-129 petition are the employer's and their attorney's responsibility, sit behind USCIS accounts, and are out of scope — if the user is at that stage, say so plainly and stop at this boundary rather than collecting petition data.
+- E treaty trader/investor: enterprise, investment/trade facts, role, ownership, and supporting business details.
+- C, D, or C-1/D: transit, vessel/airline, crew role, onward travel, and short-stay logistics.
+- A, G, NATO, or official categories: official position, mission/organization, diplomatic/official travel purpose, and assignment details.
+- K categories: petitioner/beneficiary relationship, petition details, consular case details, and relationship timeline.
+
+If the selected visa class does not fit one of these examples, search official State Department and consular sources for that category and add the resulting branch to the HTML coverage map before asking detailed questions.
+
+1. Logistics
+   - Visa class and purpose of travel.
+   - Application location and intended interview post.
+   - CEAC application ID, security question, and save/retrieve details if already created.
+2. Personal information
+   - Passport name, native alphabet name, telecodes if applicable.
+   - Sex, marital status, date/place/country of birth.
+   - Nationality, other nationality, permanent residence elsewhere.
+   - National ID, SSN, ITIN, if applicable.
+3. Travel information
+   - Arrival and departure dates or intended dates.
+   - Cities/places to visit.
+   - U.S. address.
+   - Trip payer.
+   - Travel companions.
+4. Previous U.S. travel and visas
+   - Prior visits, I-94 entries, prior visa details.
+   - Refusals, cancellations, revocations, lost/stolen visa or passport.
+   - Driver license and U.S. identifiers when requested.
+5. Address, phone, email, social media
+   - Current home address and mailing address.
+   - Phone numbers, email addresses.
+   - Social media identifiers for the requested period.
+6. Passport information
+   - Passport number, book number if present, issuance/expiration date, issuing city/state/country.
+   - Lost/stolen passport history.
+7. U.S. contact
+   - Person or organization in the U.S.
+   - Relationship, address, phone, email if available.
+8. Family
+   - Parents' names/dates of birth or unknown status.
+   - Spouse/former spouse if applicable.
+   - Relatives in the United States.
+9. Present work, education, and training
+   - Current employment or study.
+   - Employer/school address and phone.
+   - Salary, start date, duties.
+10. Previous work, education, travel
+   - Past work history required by DS-160.
+   - Education after elementary level.
+   - Recent travel to other countries.
+   - Languages, organizations, specialized skills or training, military/government/security service.
+11. Security and background
+   - Ask the official security pages carefully.
+   - Group all clear "No" responses only after the user explicitly confirms.
+12. Review and submission
+   - Photo status.
+   - Final preview complete.
+   - Applicant review complete.
+   - Submission/confirmation number backfilled.
+13. Fee, appointment, and status
+   - Payment status and receipt number.
+   - Appointment date/time and location.
+   - Visa status or passport return status.
+
+## HTML Update Rules
+
+- Update `Visa Process Progress` whenever a milestone changes.
+- Update `Current Filing Status` with a plain-language summary.
+- Update `Final DS-160 Filled Preview` with cleaned values only.
+- Update `Source: Collected Answers` with raw answers and provenance.
+- Update `DS-160 Coverage Map` so missing sections are obvious.
+- Keep placeholders visible instead of deleting unresolved fields.
+- Use `Pending user confirmation` for inferred values until the user confirms.
+
+## Browser And Computer Use
+
+Use Browser when the task is in the Codex in-app browser, local HTML, localhost, or another local target. Use Computer Use when interacting with the user's real browser session, authenticated pages, installed extensions, profile cookies, native file pickers, or desktop dialogs.
+
+If the agent runtime is not Codex, translate this step to the equivalent browser-use or computer-use capability in that environment. Claude Code, Hermes, OpenClaw, and similar agents may require another skill or plugin, such as Peekaboo or an environment-specific browser/computer-control skill. Keep the same safety boundaries regardless of tool choice.
+
+Before entering official form data:
+
+1. Open the local dossier and final preview.
+2. Ask the user to confirm the final preview is ready for form entry.
+3. Fill fields page by page from the final preview.
+4. After each page, use the official form's own navigation/save controls.
+5. Let the user handle CAPTCHA, passwords, final certification, signature, and submission.
+6. Backfill generated IDs and milestones into the HTML.
+
+## Review Gate Checklist
+
+- All final fields have a value, `Does Not Apply`, or clear `Pending` note.
+- Travel purpose matches the visa class.
+- U.S. address and contact are consistent.
+- Current work/school data is current.
+- Previous U.S. visa/travel data is consistent with documents.
+- Security/background answers are confirmed by the user.
+- Photo is ready and meets current official requirements.
+- The user understands that official submission is their act, not the agent's.