data expanded

data/intake/choices/budget.yaml

@@ -0,0 +1,24 @@
+- Under USD 2,500 savings
+- USD 2,500-5,000 savings
+- USD 5,000-10,000 savings
+- USD 10,000-15,000 savings
+- USD 15,000-25,000 savings
+- USD 25,000-40,000 savings
+- USD 40,000-60,000 savings
+- USD 60,000-100,000 savings
+- USD 100,000+ savings
+- Monthly income under USD 1,000
+- Monthly income USD 1,000-2,000
+- Monthly income USD 2,000-3,500
+- Monthly income USD 3,500-5,000
+- Monthly income USD 5,000-8,000
+- Monthly income USD 8,000-12,000
+- Monthly income USD 12,000+
+- Can show proof of funds for visa (amount flexible)
+- Employer sponsorship available
+- Family sponsor abroad
+- Scholarship / grant funding
+- Can invest USD 50,000+ (business / golden visa)
+- Can invest USD 100,000+ (business / golden visa)
+- Prefer lower cost of living
+- Flexible / not sure

data/intake/choices/education.yaml

@@ -0,0 +1,17 @@
+- No formal schooling
+- Some primary / elementary school
+- High school / secondary (incomplete)
+- High school / secondary (completed)
+- Vocational / trade certificate
+- Associate degree / diploma
+- Bachelor's degree (in progress)
+- Bachelor's degree
+- Master's degree (in progress)
+- Master's degree
+- PhD / doctorate (in progress)
+- PhD / doctorate
+- Professional degree (MD, JD, DDS, etc.)
+- Postgraduate diploma / certificate
+- Professional license or board certification
+- Currently studying (secondary)
+- Currently studying (university)

data/intake/choices/experience.yaml

@@ -0,0 +1,11 @@
+- No professional experience
+- Internship / trainee only
+- Less than 1 year
+- 1-2 years
+- 2-3 years
+- 3-5 years
+- 5-7 years
+- 7-10 years
+- 10-15 years
+- 15-20 years
+- 20+ years

data/intake/choices/fallback_countries.yaml

@@ -0,0 +1,84 @@
+- Afghanistan
+- Algeria
+- Argentina
+- Australia
+- Austria
+- Bangladesh
+- Belgium
+- Bolivia
+- Brazil
+- Cambodia
+- Cameroon
+- Canada
+- Chile
+- China
+- Colombia
+- Costa Rica
+- Croatia
+- Czech Republic
+- Denmark
+- Dominican Republic
+- Ecuador
+- Egypt
+- Ethiopia
+- Finland
+- France
+- Germany
+- Ghana
+- Greece
+- Hong Kong
+- Hungary
+- India
+- Indonesia
+- Iran
+- Iraq
+- Ireland
+- Israel
+- Italy
+- Jamaica
+- Japan
+- Jordan
+- Kenya
+- South Korea
+- Kuwait
+- Lebanon
+- Malaysia
+- Mexico
+- Morocco
+- Myanmar
+- Nepal
+- Netherlands
+- New Zealand
+- Nigeria
+- Norway
+- Pakistan
+- Peru
+- Philippines
+- Poland
+- Portugal
+- Qatar
+- Romania
+- Russia
+- Saudi Arabia
+- Senegal
+- Serbia
+- Singapore
+- South Africa
+- Spain
+- Sri Lanka
+- Sweden
+- Switzerland
+- Taiwan
+- Tanzania
+- Thailand
+- Tunisia
+- Turkey
+- Uganda
+- Ukraine
+- United Arab Emirates
+- United Kingdom
+- United States
+- Uruguay
+- Venezuela
+- Vietnam
+- Zimbabwe

data/intake/choices/family.yaml

@@ -0,0 +1,13 @@
+- Solo applicant
+- Spouse / civil partner only
+- Unmarried partner (de facto)
+- Spouse / partner + 1 child
+- Spouse / partner + 2 children
+- Spouse / partner + 3+ children
+- Dependents only (no spouse)
+- Parent(s) relocating with me
+- Adult child(ren) relocating with me
+- Sibling(s) relocating with me
+- Extended family relocating together
+- Planning family reunification later
+- Pet(s) must relocate with me

data/intake/choices/languages.yaml

@@ -0,0 +1,62 @@
+- Afrikaans
+- Albanian
+- Amharic
+- Arabic
+- Armenian
+- Bengali
+- Bulgarian
+- Burmese
+- Cantonese
+- Croatian
+- Czech
+- Danish
+- Dutch
+- English
+- Estonian
+- Farsi / Persian
+- Filipino / Tagalog
+- Finnish
+- French
+- German
+- Greek
+- Gujarati
+- Hausa
+- Hebrew
+- Hindi
+- Hungarian
+- Igbo
+- Indonesian
+- Italian
+- Japanese
+- Kannada
+- Khmer
+- Korean
+- Lao
+- Latvian
+- Lithuanian
+- Malay
+- Malayalam
+- Mandarin Chinese
+- Marathi
+- Nepali
+- Norwegian
+- Polish
+- Portuguese
+- Punjabi
+- Romanian
+- Russian
+- Serbian
+- Sinhala
+- Slovak
+- Somali
+- Spanish
+- Swahili
+- Swedish
+- Tamil
+- Telugu
+- Thai
+- Turkish
+- Ukrainian
+- Urdu
+- Vietnamese
+- Yoruba

data/intake/choices/occupation.yaml

@@ -0,0 +1,29 @@
+- Software / IT
+- Data / AI / analytics
+- Engineering (non-software)
+- Healthcare (clinical)
+- Healthcare (non-clinical / admin)
+- Nursing / caregiving
+- Education / teaching
+- Research / academia
+- Finance / accounting
+- Legal / compliance
+- Sales / marketing
+- Design / creative / media
+- Hospitality / food service
+- Logistics / supply chain
+- Manufacturing / production
+- Construction / trades
+- Agriculture / farming
+- Retail / customer service
+- Government / public sector
+- Nonprofit / NGO
+- Management / executive
+- Business owner / entrepreneur
+- Self-employed / freelancer
+- Remote worker (overseas clients)
+- Student / no full-time work
+- Homemaker / caregiver (unpaid)
+- Retired / not currently working
+- Military / veteran
+- Unemployed / between jobs

data/intake/choices/residence_status.yaml

@@ -0,0 +1,20 @@
+- Citizen
+- Permanent resident / green card equivalent
+- Long-term resident (5+ years)
+- Work visa / employment pass
+- Intra-company transfer visa
+- Skilled worker / points visa
+- Student visa
+- Post-study work visa
+- Dependent / family visa
+- Spousal / partner visa
+- Investor / business visa
+- Entrepreneur / startup visa
+- Digital nomad visa
+- Working holiday visa
+- Refugee / asylum seeker
+- Humanitarian / protected status
+- Tourist / short-term stay
+- Visa overstay / out of status
+- Between visas / relocating soon
+- Stateless / unclear documentation

data/intake/choices/timeline.yaml

@@ -0,0 +1,12 @@
+- ASAP (under 3 months)
+- 3-6 months
+- 6-12 months
+- 12-18 months
+- 18-24 months
+- 2-3 years
+- 3-5 years
+- After finishing current studies
+- After current work contract ends
+- Long term / flexible
+- Exploring options only
+- Dependent on visa processing times

data/intake/personas.yaml

@@ -0,0 +1,129 @@
+personas:
+  - id: india_software_engineer
+    label: India software engineer
+    profile:
+      citizenship:
+        - India
+      current_country: India
+      residence_status: Citizen
+      education: Master's degree
+      occupation: Software / IT
+      experience: 7-10 years
+      languages:
+        - English
+        - Hindi
+      budget: USD 15,000-25,000 savings
+      family: Solo applicant
+      timeline: 12-18 months
+      goals: >
+        I want to relocate for skilled work within the next 12-18 months.
+        Compare realistic countries, visa pathways, required documents,
+        approximate costs, and risks. Prioritize routes with a path to
+        permanent residence.
+
+  - id: hong_kong_student
+    label: Hong Kong student
+    profile:
+      citizenship:
+        - Hong Kong
+      current_country: Hong Kong
+      residence_status: Citizen
+      education: Bachelor's degree
+      occupation: Student / no full-time work
+      experience: Less than 1 year
+      languages:
+        - English
+        - Mandarin Chinese
+      budget: USD 10,000-15,000 savings
+      family: Solo applicant
+      timeline: 6-12 months
+      goals: >
+        I want to study in Europe on a modest budget and care about
+        post-study work options. Compare realistic countries, tuition and
+        living costs, student visa rules, and mark viable destinations on
+        the globe.
+
+  - id: brazil_remote_family
+    label: Remote worker family
+    profile:
+      citizenship:
+        - Brazil
+      current_country: Brazil
+      residence_status: Citizen
+      education: Bachelor's degree
+      occupation: Design / creative / media
+      experience: 3-5 years
+      languages:
+        - Portuguese
+        - English
+      budget: Monthly income USD 3,500-5,000
+      family: Spouse / partner + 1 child
+      timeline: 3-6 months
+      goals: >
+        We want a safe country with good schools and a route that does not
+        require a local job offer immediately. Compare digital-nomad,
+        investor, and family-friendly residency options with realistic
+        timelines under one year.
+
+  - id: nigeria_healthcare_worker
+    label: Nigeria healthcare worker
+    profile:
+      citizenship:
+        - Nigeria
+      current_country: Nigeria
+      residence_status: Citizen
+      education: Bachelor's degree
+      occupation: Nursing / caregiving
+      experience: 7-10 years
+      languages:
+        - English
+      budget: USD 15,000-25,000 savings
+      family: Spouse / civil partner only
+      timeline: 12-18 months
+      goals: >
+        I am a registered nurse looking for skilled-worker or health-sector
+        migration routes to Canada, the UK, or Australia. Compare licensing
+        steps, language tests, credential recognition, and which pathway is
+        most realistic for my profile.
+
+  - id: philippines_caregiver
+    label: Philippines caregiver
+    profile:
+      citizenship:
+        - Philippines
+      current_country: Philippines
+      residence_status: Citizen
+      education: Vocational / trade certificate
+      occupation: Nursing / caregiving
+      experience: 3-5 years
+      languages:
+        - English
+        - Filipino / Tagalog
+      budget: USD 5,000-10,000 savings
+      family: Solo applicant
+      timeline: 6-12 months
+      goals: >
+        I have caregiver experience and want to work abroad in Canada, Japan,
+        or Europe. Compare employer-sponsored routes, language requirements,
+        training or certification gaps, and total upfront costs.
+
+  - id: us_tech_europe
+    label: US tech worker exploring Europe
+    profile:
+      citizenship:
+        - United States
+      current_country: United States
+      residence_status: Citizen
+      education: Bachelor's degree
+      occupation: Software / IT
+      experience: 10-15 years
+      languages:
+        - English
+      budget: USD 60,000-100,000 savings
+      family: Spouse / civil partner only
+      timeline: 2-3 years
+      goals: >
+        My spouse and I want to move to Europe for quality of life without
+        giving up remote-friendly tech work immediately. Compare EU Blue
+        Card, freelancer/self-employed, and digital-nomad options in Portugal,
+        Germany, Spain, and the Netherlands.

ui/intake/choices.py

@@ -3,139 +3,19 @@ from __future__ import annotations
 
 from functools import lru_cache
 
-FALLBACK_COUNTRIES = [
-    "Australia",
-    "Brazil",
-    "Canada",
-    "China",
-    "France",
-    "Germany",
-    "Hong Kong",
-    "India",
-    "Indonesia",
-    "Ireland",
-    "Italy",
-    "Japan",
-    "Malaysia",
-    "Mexico",
-    "Netherlands",
-    "New Zealand",
-    "Nigeria",
-    "Philippines",
-    "Poland",
-    "Portugal",
-    "Singapore",
-    "South Africa",
-    "South Korea",
-    "Spain",
-    "Sweden",
-    "Switzerland",
-    "Taiwan",
-    "Thailand",
-    "United Arab Emirates",
-    "United Kingdom",
-    "United States",
-    "Vietnam",
-]
-
-EDUCATION_CHOICES = [
-    "High school / secondary",
-    "Associate degree",
-    "Bachelor's degree",
-    "Master's degree",
-    "PhD / doctorate",
-    "Professional degree (MD, JD, etc.)",
-    "Vocational / trade certificate",
-    "Currently studying",
-]
-
-OCCUPATION_CHOICES = [
-    "Software / IT",
-    "Engineering (non-software)",
-    "Healthcare",
-    "Education / teaching",
-    "Finance / accounting",
-    "Sales / marketing",
-    "Design / creative",
-    "Trades / skilled labor",
-    "Management / executive",
-    "Research / academia",
-    "Student / no full-time work",
-    "Self-employed / freelancer",
-]
-
-EXPERIENCE_CHOICES = [
-    "Less than 1 year",
-    "1-3 years",
-    "3-5 years",
-    "5-10 years",
-    "10+ years",
-]
-
-LANGUAGE_CHOICES = [
-    "Arabic",
-    "Bengali",
-    "Dutch",
-    "English",
-    "French",
-    "German",
-    "Hindi",
-    "Indonesian",
-    "Italian",
-    "Japanese",
-    "Korean",
-    "Mandarin Chinese",
-    "Polish",
-    "Portuguese",
-    "Russian",
-    "Spanish",
-    "Tagalog",
-    "Thai",
-    "Turkish",
-    "Urdu",
-    "Vietnamese",
-]
-
-BUDGET_CHOICES = [
-    "Under USD 5,000 savings",
-    "USD 5,000-15,000 savings",
-    "USD 15,000-30,000 savings",
-    "USD 30,000-50,000 savings",
-    "USD 50,000+ savings",
-    "Monthly income under USD 2,000",
-    "Monthly income USD 2,000-5,000",
-    "Monthly income USD 5,000+",
-    "Prefer lower cost of living",
-    "Flexible / not sure",
-]
-
-FAMILY_CHOICES = [
-    "Solo applicant",
-    "Spouse / partner only",
-    "Spouse + 1 child",
-    "Spouse + 2+ children",
-    "Dependents only (no spouse)",
-    "Extended family relocating together",
-]
-
-TIMELINE_CHOICES = [
-    "ASAP (under 6 months)",
-    "6-12 months",
-    "12-18 months",
-    "2-3 years",
-    "Long term / flexible",
-    "Exploring options only",
-]
-
-RESIDENCE_STATUS_CHOICES = [
-    "Citizen",
-    "Permanent resident",
-    "Work visa / employment pass",
-    "Student visa",
-    "Dependent / family visa",
-    "Tourist / short-term stay",
-    "Between visas / relocating soon",
-]
+from ui.intake.loader import load_intake_choices
+
+_choices = load_intake_choices()
+
+FALLBACK_COUNTRIES = _choices["fallback_countries"]
+EDUCATION_CHOICES = _choices["education"]
+OCCUPATION_CHOICES = _choices["occupation"]
+EXPERIENCE_CHOICES = _choices["experience"]
+LANGUAGE_CHOICES = _choices["languages"]
+BUDGET_CHOICES = _choices["budget"]
+FAMILY_CHOICES = _choices["family"]
+TIMELINE_CHOICES = _choices["timeline"]
+RESIDENCE_STATUS_CHOICES = _choices["residence_status"]
 
 
 @lru_cache(maxsize=1)

ui/intake/examples.py

@@ -1,25 +1,47 @@
 # ui/intake/examples.py
-EXAMPLE_PROMPTS = [
-    (
-        "India software engineer",
-        "I'm a software engineer from India with 5 years of backend experience, "
-        "a master's degree, English fluency, and a budget of about USD 18,000. "
-        "I want to relocate for work within the next 12-18 months. Which "
-        "countries are realistic, what visa pathways should I look at, and "
-        "what documents should I prepare?",
-    ),
-    (
-        "Hong Kong student",
-        "I hold a Hong Kong passport and want to study in Europe on a modest "
-        "budget. I speak English and conversational Mandarin, can show around "
-        "USD 12,000 in savings, and care about post-study work options. Compare "
-        "realistic countries and mark them on the globe.",
-    ),
-    (
-        "Remote worker family",
-        "I'm a freelance product designer from Brazil, married with one child, "
-        "earning around USD 4,500 per month from overseas clients. We want a "
-        "safe country with good schools, a route that does not require a local "
-        "job offer immediately, and a timeline under one year.",
-    ),
-]
+from __future__ import annotations
+
+from typing import Any, TypedDict
+
+from ui.intake.loader import load_demo_personas
+from ui.intake.prompts import build_profile_prompt
+
+
+class PersonaProfile(TypedDict):
+    citizenship: list[str] | str
+    current_country: str
+    residence_status: str
+    education: str
+    occupation: str
+    experience: str
+    languages: list[str] | str
+    budget: str
+    family: str
+    timeline: str
+    goals: str
+
+
+class DemoPersona(TypedDict):
+    id: str
+    label: str
+    profile: PersonaProfile
+
+
+def demo_personas() -> list[DemoPersona]:
+    return load_demo_personas()  # type: ignore[return-value]
+
+
+def persona_prompt(profile: PersonaProfile | dict[str, Any]) -> dict[str, object]:
+    return build_profile_prompt(
+        profile.get("citizenship"),
+        profile.get("current_country"),
+        profile.get("residence_status"),
+        profile.get("education"),
+        profile.get("occupation"),
+        profile.get("experience"),
+        profile.get("languages"),
+        profile.get("budget"),
+        profile.get("family"),
+        profile.get("timeline"),
+        profile.get("goals", ""),
+    )

ui/intake/loader.py

@@ -0,0 +1,30 @@
+# ui/intake/loader.py
+from __future__ import annotations
+
+from functools import lru_cache
+from pathlib import Path
+from typing import Any
+
+import yaml
+
+DATA_DIR = Path(__file__).resolve().parents[2] / "data" / "intake"
+CHOICES_DIR = DATA_DIR / "choices"
+
+
+@lru_cache(maxsize=1)
+def load_intake_choices() -> dict[str, list[str]]:
+    choices: dict[str, list[str]] = {}
+    for path in sorted(CHOICES_DIR.glob("*.yaml")):
+        with path.open(encoding="utf-8") as handle:
+            data = yaml.safe_load(handle)
+        if not isinstance(data, list):
+            raise ValueError(f"{path.name} must contain a YAML list")
+        choices[path.stem] = list(data)
+    return choices
+
+
+@lru_cache(maxsize=1)
+def load_demo_personas() -> list[dict[str, Any]]:
+    with (DATA_DIR / "personas.yaml").open(encoding="utf-8") as handle:
+        data = yaml.safe_load(handle)
+    return list(data["personas"])

ui/intake/panel.py

@@ -12,6 +12,7 @@ from ui.intake.choices import (
     TIMELINE_CHOICES,
     country_choices,
 )
+from ui.intake.examples import demo_personas, persona_prompt
 from ui.intake.prompts import build_profile_prompt