travel-itinerary-planner

# Travel Itinerary Planner

Create end-to-end travel plans from minimal user input and output a polished, image-ready itinerary in Markdown.

## Quick Start

1. Collect minimum inputs: destination, start date, end date.
2. Collect high-impact optional inputs: origin city, travelers, budget level, pace, interests, hard constraints.
3. Generate a base draft:
```bash
python scripts/build_trip_plan.py \
  --destination "Kyoto, Japan" \
  --start-date 2026-04-03 \
  --end-date 2026-04-08 \
  --origin "Shanghai, China" \
  --travelers 2 \
  --budget-level standard \
  --pace balanced \
  --focus "food,history,photo spots" \
  --cover-image "<trusted-https-cover-image-url>" \
  --image-url "<trusted-https-image-url-1>" \
  --image-url "<trusted-https-image-url-2>"
```
4. Enrich the draft with current facts and concrete bookings.

## Workflow

### 1) Confirm Inputs

Collect at least:
- Destination
- Absolute start/end dates (`YYYY-MM-DD`)

Collect when available:
- Origin city and preferred transportation
- Number of travelers and trip style (solo/couple/family/friends)
- Budget level (`economy|standard|premium`) and currency
- Pace (`relaxed|balanced|intense`)
- Interests (`food,museum,nature,shopping,...`)
- Constraints (mobility, dietary, child-friendly, no driving, etc.)

If user gives relative time (for example "next Friday"), convert to exact calendar dates before planning.

### 2) Verify Time-Sensitive Facts

Do not rely on stale assumptions for travel.
Verify:
- Weather forecast and seasonal conditions
- Attraction opening hours / closure dates
- Train/flight/ferry schedules and transfer durations
- Visa/entry policy and passport validity notes (if cross-border)
- Major local events that impact crowds, ticketing, or hotel prices

Use primary sources first (official attractions, airlines/rail operators, tourism boards).  
Use `references/research-checklist.md` as a pre-flight checklist.

### 3) Build Base Itinerary

Run `scripts/build_trip_plan.py` to generate a stru...