explore-check-travel-docs

explore-check-travel-docs

Trigger: Called by op-document-check, op-monthly-sync, op-trip-planning-review Produces: Document validity report with per-document expiration status and renewal flags returned to calling op

What It Does

This flow reads the full travel document inventory from vault/explore/00_current/ and validates each document against two sets of requirements: the absolute expiry thresholds (the document's calendar expiration date vs. today) and the trip-specific requirements (the document's validity vs. upcoming trip dates with applicable rules applied).

Document inventory reading: The flow reads all files in vault/explore/00_current/: passport.md (one per traveler), global-entry.md, tsa-precheck.md, nexus.md if applicable, visa files in vault/explore/00_current/visas/, and vaccination records in vault/explore/00_current/vaccinations/. For each document, it reads the key fields: document type, person name, expiration date, issuing country, and document number.

Absolute expiry validation: For each document, the flow calculates days until expiry and assigns a status tier based on document type. Passport: 🟢 if 12+ months remaining, 🟡 if 6-12 months ("Start renewal process — some countries may reject"), 🔴 if under 6 months ("Renew immediately — many countries will deny entry"). Global Entry: 🟢 if 18+ months remaining, 🟡 if 12-18 months ("Submit renewal — interviews booked months in advance"), 🔴 if under 12 months ("Submit renewal now"). TSA PreCheck: 🟢 if 6+ months remaining, 🟡 if 3-6 months, 🔴 if under 3 months. Vaccination records: 🟢 if within validity period, 🔴 if expired.

Trip-specific validation: When called with trip context (destination country, departure date, return date, travelers), the flow applies destination-specific rules. Passport: applies the 6-month rule for most countries (passport must be valid 6+ months beyond the return date) or the 3-month rule for Schengen countries (3+ months beyond return date) or the stay-validity rule for select countries (passport just needs to cover the stay). Visa: checks whether the user's citizenship requires a visa for the destination country; if yes, checks whether an appropriate visa has been obtained (reading vault/explore/00_current/visas/ for any matching visa). Vaccinations: checks whether the destination country requires or strongly recommends specific vaccinations; mandatory requirements (like Yellow Fever for some African and South American countries) are flagged as 🔴 if the vaccination record is missing or expired.

Renewal lead time annotation: For every flagged document, the flow appends the document-type-specific renewal lead time: US passport standard 10-13 weeks / expedited 4-6 weeks / emergency 2-4 days; Global Entry 2-6 months (plus interview wait); TSA PreCheck 3-5 weeks. This allows the calling op to communicate a realistic timeline rather than just "renew."

Steps

1. Read all files in vault/explore/00_current/ (passports, Global Entry, TSA PreCheck, visas, vaccinations)
2. For each document: parse expiry date; calculate days remaining
3. Assign absolute expiry status tier per document type thresholds
4. If trip context provided: apply destination-specific passport validity rules (6-month / 3-month / stay-validity)
5. Check visa requirements for destination country against user's citizenship
6. Check whether applicable visa exists in vault/explore/00_current/visas/
7. Check vaccination requirements for destination; verify against vault/explore/00_current/vaccinations/
8. For each flagged document: append renewal lead time and specific renewal action
9. Return full validation report to calling op

Input

• ~/Documents/aireadylife/vault/explore/00_current/ (all travel documents)
• ~/Documents/aireadylife/vault/explore/01_prior/ — prior period records for trend comparison
• Trip context from calling op (destination, departure date, return date, travelers) — optional for general check

Output Format

Returns structured validation report to calling op:

{
  travelers: [
    {
      name: "Name",
      passport: { expires: "2027-02-14", days_remaining: 307, status: "🟢", trip_valid: true, trip_valid_note: "Valid 6+ months beyond return" },
      global_entry: { expires: "2026-03-01", days_remaining: 52, status: "🔴", renewal_lead_time: "2-6 months + interview", action: "Submit renewal at cbp.gov/ttp now" },
      tsa_precheck: { expires: "2028-01-15", days_remaining: 642, status: "🟢" }
    }
  ],
  trip_specific: {
    destination: "Japan",
    passport_rule: "6-month rule",
    passport_ok: true,
    visa_required: false,
    visa_note: "US citizens visa-free for 90 days",
    vaccinations_required: [],
    vaccinations_recommended: ["Hepatitis A", "Hepatitis B"]
  },
  flags: [
    { document: "Global Entry", person: "Name", urgency: "🔴", action: "Submit renewal immediately at cbp.gov/ttp", lead_time: "2-6 months for processing" }
  ]
}

Configuration

Required in vault/explore/config.md:

• travelers — names and passport expiry dates
• citizenship — for visa requirement lookup

Error Handling

• Document file missing for a traveler: Return "No [document type] record found for [traveler] — add to vault/explore/00_current/." Flag as status unknown (🟡 by default).
• Destination visa requirements unknown to the system: Note "Verify current visa requirements at travel.state.gov or the [country] embassy website."
• Vaccination requirements for destination unknown: Note "Verify current vaccination requirements at wwwnc.cdc.gov/travel/destinations or the [country] entry requirements page."

Vault Paths

• Reads from: ~/Documents/aireadylife/vault/explore/01_prior/ — prior period records
• Reads from: ~/Documents/aireadylife/vault/explore/00_current/, ~/Documents/aireadylife/vault/explore/config.md
• Writes to: none (returns data to calling op)