@yukioa2z/visa-apply 3.0.0

package/skill/references/pipeline.md

@@ -0,0 +1,104 @@
+# Visa Application Pipeline
+
+## 1. Intake Routing
+
+Collect only the routing facts first:
+
+- destination country or area
+- all nationalities, or stateless/refugee status
+- travel-document type and issuing country
+- country of legal residence and residence status
+- current physical location and intended application location
+- travel purpose
+- intended arrival, duration, and number of entries
+- whether the applicant already holds relevant visas or residence permits
+
+Do not start a detailed questionnaire until the live route check identifies visa-free, ETA, eVisa, visa on arrival, consular visa, transit authorization, residence route, mixed, or unresolved.
+
+Never use interface language, IP location, time zone, or the user's current city as a proxy for citizenship or residence. Citizenship, document issuer, legal residence, physical location, and consular jurisdiction can all differ.
+
+## 2. Run The Live Visa-Need Check
+
+Resolve the destination through `jurisdictions.json`. Use `official-sources.json` only as a set of cached starting URLs, never as a current visa-policy answer. Browse on every new application and follow this authority order:
+
+1. National immigration authority, foreign ministry, or supranational authority such as the European Commission.
+2. Embassy or consulate responsible for the applicant's legal residence.
+3. Official government application portal.
+4. Delegated visa application centre for logistics only.
+
+A delegated centre can establish appointment, submission, and service-fee logistics. It cannot override government eligibility or document rules. Never treat travel blogs, agencies, forums, search snippets, or AI summaries as application authority.
+
+Check visa exemption, ETA, eVisa, visa on arrival, consular visa, transit, and residence-permit substitution for the exact route key. Check every transit and self-transfer separately. Cross-check IATA Travel Centre/Timatic or the operating carrier for boarding requirements and label that result operational, not legal.
+
+Apply the freshness and conflict rules in `live-route-check.md`. Do not continue to detailed intake until the verdict and its evidence are written to the HTML.
+
+## 3. Create A Source Snapshot
+
+Before asking detailed questions, record in the HTML:
+
+- exact official URLs
+- authority name
+- page purpose
+- date checked
+- applicant nationality and residence used for the lookup
+- travel-document issuer, residence status, and application location used for the lookup
+- unresolved conflicts or location-specific requirements
+
+Recheck immediately before filing or payment, whenever the itinerary changes, and whenever the live route check is more than 7 days old. Recheck entry and carrier requirements within 72 hours before departure.
+
+## 4. Build The Country And Visa-Type Adapter
+
+Load an existing adapter from `references/countries/` when available. Otherwise use `adapter-schema.md` to create a temporary adapter in the dossier from the official sources.
+
+Compose the question set from:
+
+- `core-intake.md`
+- destination-country requirements
+- visa-type requirements
+- applicant-specific branches such as minors, sponsors, prior refusals, dependants, work, study, medical travel, or family relationship
+
+Mark unsupported or uncertain branches as `Pending official verification`.
+
+## 5. Grill And Collect
+
+Use the `grill-me` pattern. Ask one question at a time by default and provide the recommended answer format. If the user asks for batches, group a compact set by form page or evidence category.
+
+Write every answer to the HTML immediately:
+
+- raw wording and provenance under `Source: Collected Answers`
+- normalized value under `Final Visa Application Preview`
+- required evidence under `Document Checklist`
+- missing or inferred values under `Open Issues`
+
+The HTML remains the only source of truth.
+
+## 6. Quality And Review Gates
+
+Run `quality-gates.md`. Before browser entry, verify:
+
+- the correct visa route and responsible post
+- source snapshot is current
+- every required field has a final value or explicit unresolved status
+- documents support the stated purpose, funding, accommodation, and ties
+- dates and identity fields are consistent across documents
+- the applicant reviewed all sensitive, security, immigration-history, and declaration answers
+- transit, document-format, translation/legalization, deadline/time-zone, fee/refund, evidence-expiry, and post-arrival branches are resolved
+
+## 7. Assisted Form Entry
+
+Use the available Browser or Computer Use capability. In non-Codex environments, use an equivalent browser/computer skill such as Peekaboo or the runtime's supported automation package.
+
+Do not bypass CAPTCHA or anti-automation controls. Do not invent data. The applicant handles passwords, CAPTCHA, final declaration, signature, certification, and submission unless the official process explicitly permits an authorized representative and the user has established that authority.
+
+## 8. Backfill And Track
+
+After each portal milestone, update the HTML with:
+
+- application or case number
+- submission date
+- fee and receipt number
+- biometrics or appointment date and location
+- document-request deadlines
+- decision/status and passport-return details
+
+Progress checkpoints are: live visa-need check, intake, documents, application, fee, appointment/biometrics, decision, and passport/visa received.

package/skill/references/quality-gates.md

@@ -0,0 +1,52 @@
+# Application Quality Gates
+
+Use these checks after the route is resolved and before submission.
+
+## Identity And Jurisdiction
+
+- Names, dates, passport numbers, nationality, and civil status agree across all records.
+- The travel document remains valid for the rule-specific margin and has required blank pages.
+- Legal residence supports filing at the selected post; residence permit expiry is acceptable.
+- Native-script, transliteration, prior names, and dual nationality are handled as the form defines them.
+
+## Itinerary And Transit
+
+- Every border crossing, transit, self-transfer, airport change, and overnight stop is checked.
+- Purpose and planned activities stay within the selected route, including business and remote-work boundaries.
+- Accommodation, host, transport, dates, duration, and entries agree across the form and evidence.
+- Non-refundable travel is not treated as mandatory unless the authority explicitly requires it.
+
+## Documents
+
+- Always-required, conditional, post-specific, and post-submission documents are separated.
+- Translations, certified copies, notarization, apostille/legalization, and document recency are verified.
+- Photo, scan, filename, file type, size, resolution, page order, and upload limits are checked.
+- Minor/guardian consent, custody, medical, police, military, sponsor, and relationship evidence branches are resolved when triggered.
+
+## Money And Timing
+
+- Prior applications, withdrawals/cancellations, reusable fee receipts, duplicate applicant profiles, account locks, and support cases are checked before creating or paying for a new case.
+- Government fee, service fee, currency, payment method, refundability, and receipt validity are distinguished.
+- Appointment availability, biometrics, medicals, interviews, courier time, and processing estimates are tracked separately.
+- All deadlines use an explicit date, time zone, owner, and next action.
+- Evidence expiry is tracked for passports, photos, bank records, police certificates, medicals, and enrollment/employment letters.
+
+## Consistency And Review
+
+- Raw answers, normalized form values, and supporting documents do not conflict.
+- Inferences and unresolved values remain visible; the agent never silently fills them.
+- Security, criminal, immigration, health, and declaration answers are confirmed by the applicant.
+- The applicant reviews the final preview and handles required signatures, declarations, CAPTCHA, and submission.
+
+## After Submission And Travel
+
+- Store application/case IDs, receipts, appointments, requests, decision, visa label/eVisa, and passport return.
+- Verify the issued visa against name, passport, category, entries, validity, and annotations.
+- Track pre-arrival forms, health/customs declarations, registration, reporting, work/study conditions, extension rules, and departure deadline.
+- Make clear that a visa or authorization does not guarantee admission at the border.
+
+## Privacy And Access
+
+- All applicant data stays local: it lives only in the local HTML dossier and is never transmitted to any external service, logged elsewhere, or used for any purpose beyond this application. This is a hard constraint, not a user setting.
+- Never store passwords, one-time codes, security answers, or payment-card data in the dossier.
+- Keep the HTML as the only authoritative case record.

package/skill/scripts/create_dossier.py

@@ -0,0 +1,140 @@
+#!/usr/bin/env python3
+"""Create a local visa application dossier from the bundled HTML template."""
+
+from __future__ import annotations
+
+import argparse
+from datetime import datetime
+from html import escape
+from pathlib import Path
+from urllib.parse import urlparse
+
+from source_registry import find_destination, load_directory, load_registry
+
+
+ROOT = Path(__file__).resolve().parents[1]
+TEMPLATE = ROOT / "assets" / "visa-dossier-template.html"
+
+
+def parse_args() -> argparse.Namespace:
+    parser = argparse.ArgumentParser(description=__doc__)
+    parser.add_argument("output", help="Output HTML path to create")
+    parser.add_argument("--title")
+    parser.add_argument("--country", help="Registry id, country name, or alias")
+    parser.add_argument("--destination")
+    parser.add_argument("--visa-type", default="Pending")
+    parser.add_argument("--form-name", default="Pending")
+    parser.add_argument(
+        "--application-location",
+        "--location",
+        dest="application_location",
+        default="Pending",
+    )
+    parser.add_argument("--applicant-label", default="Applicant")
+    parser.add_argument("--nationality", "--nationalities", default="Pending")
+    parser.add_argument("--passport-type", default="Pending")
+    parser.add_argument("--travel-document-issuer", default="Pending")
+    parser.add_argument("--legal-residence", default="Pending")
+    parser.add_argument("--residence-status", default="Pending")
+    parser.add_argument("--purpose", default="Pending")
+    parser.add_argument("--arrival-date", default="Pending")
+    parser.add_argument("--duration", default="Pending")
+    parser.add_argument("--entries", default="Pending")
+    parser.add_argument("--arrival-mode", default="Pending")
+    parser.add_argument("--transit", default="None declared")
+    parser.add_argument("--existing-entry-rights", default="None declared")
+    parser.add_argument("--route-verdict", default="Unresolved - live check required")
+    parser.add_argument("--live-checked-at", default="Pending")
+    parser.add_argument("--recheck-due", default="Before filing and again before departure")
+    parser.add_argument("--official-source-url")
+    return parser.parse_args()
+
+
+def main() -> None:
+    args = parse_args()
+    if not TEMPLATE.exists():
+        raise SystemExit(f"Template not found: {TEMPLATE}")
+
+    output = Path(args.output).expanduser().resolve()
+    output.parent.mkdir(parents=True, exist_ok=True)
+
+    destination_match = None
+    seed = None
+    registry = load_registry()
+    directory = load_directory()
+    if args.country:
+        result = find_destination(registry, directory, args.country)
+        if not result:
+            raise SystemExit(
+                f"Unknown destination: {args.country}. "
+                "Use source_registry.py list or pass --destination."
+            )
+        destination_match, seed = result
+
+    destination = args.destination or (
+        destination_match["name"] if destination_match else "Pending"
+    )
+    official_source_url = args.official_source_url
+    if official_source_url:
+        parsed_source = urlparse(official_source_url)
+        if parsed_source.scheme != "https" or not parsed_source.netloc:
+            raise SystemExit("--official-source-url must be an https URL")
+    if not official_source_url and seed:
+        official_source_url = next(
+            source["url"]
+            for source in seed["sources"]
+            if "authoritative_rules" in source["roles"]
+        )
+    official_source_url = official_source_url or "Pending official verification"
+    official_source_href = (
+        official_source_url if official_source_url.startswith("https://") else "#"
+    )
+    if seed:
+        source_status = (
+            f"Cached official seed checked {registry['last_verified']}; "
+            "mandatory live route check pending"
+        )
+    elif destination_match:
+        source_status = "Live official-source discovery required; no static visa verdict"
+    else:
+        source_status = "Pending destination and live official verification"
+
+    title = args.title or f"{destination} Visa Application Dossier"
+    replacements = {
+        "{{TITLE}}": title,
+        "{{DESTINATION}}": destination,
+        "{{VISA_TYPE}}": args.visa_type,
+        "{{FORM_NAME}}": args.form_name,
+        "{{APPLICATION_LOCATION}}": args.application_location,
+        "{{APPLICANT_LABEL}}": args.applicant_label,
+        "{{NATIONALITY}}": args.nationality,
+        "{{PASSPORT_TYPE}}": args.passport_type,
+        "{{TRAVEL_DOCUMENT_ISSUER}}": args.travel_document_issuer,
+        "{{LEGAL_RESIDENCE}}": args.legal_residence,
+        "{{RESIDENCE_STATUS}}": args.residence_status,
+        "{{TRAVEL_PURPOSE}}": args.purpose,
+        "{{ARRIVAL_DATE}}": args.arrival_date,
+        "{{TRIP_DURATION}}": args.duration,
+        "{{ENTRY_COUNT}}": args.entries,
+        "{{ARRIVAL_MODE}}": args.arrival_mode,
+        "{{TRANSIT_ROUTE}}": args.transit,
+        "{{EXISTING_ENTRY_RIGHTS}}": args.existing_entry_rights,
+        "{{ROUTE_VERDICT}}": args.route_verdict,
+        "{{LIVE_CHECKED_AT}}": args.live_checked_at,
+        "{{RECHECK_DUE}}": args.recheck_due,
+        "{{OFFICIAL_SOURCE_URL}}": official_source_url,
+        "{{OFFICIAL_SOURCE_HREF}}": official_source_href,
+        "{{SOURCE_VERIFICATION_STATUS}}": source_status,
+        "{{GENERATED_AT}}": datetime.now().strftime("%Y-%m-%d %H:%M"),
+    }
+
+    html = TEMPLATE.read_text(encoding="utf-8")
+    for key, value in replacements.items():
+        html = html.replace(key, escape(value, quote=True))
+
+    output.write_text(html, encoding="utf-8")
+    print(output)
+
+
+if __name__ == "__main__":
+    main()