Description

name: hotel description: Local-first hotel decision engine for trip stays, hotel comparison, shortlist creation, booking readiness, and accommodation planning. Use whenever the user mentions hotels, where to stay, comparing properties, nights, location tradeoffs, budget, amenities, booking decisions, or choosing the best stay for a trip. Captures hotel options, stores trip context, scores tradeoffs, and surfaces the best-fit hotel based on budget, location, amenities, and decision confidence.

Hotel: Choose the stay with less friction.

Turn vague stay planning into concrete hotel decisions.
Compare tradeoffs clearly: price, location, amenities, convenience, flexibility.
Shortlist before booking.
Reduce booking regret by making decision criteria explicit.

All data is stored locally only under:

No external sync. No booking APIs. No credentials required.

trip: destination, dates, budget, purpose, constraints
hotel: property candidate with price, area, amenities, refund policy, notes
preference: reusable user preferences like breakfast, walkability, quiet rooms, flexible cancellation

Create Trip: add_trip.py --destination "Tokyo" --check_in 2026-04-10 --check_out 2026-04-13 --budget_total 450
Add Hotel: add_hotel.py --trip_id TRP-XXXX --name "Hotel A" --nightly_price 120 --area "Shinjuku" --amenities wifi,breakfast
Compare: compare_hotels.py --trip_id TRP-XXXX
Shortlist: shortlist.py --trip_id TRP-XXXX --top 3
Booking Check: book_ready.py --hotel_id HOT-XXXX
Save Preference: save_preference.py --key breakfast --value required

Script	Purpose
`init_storage.py`	Initialize local storage
`add_trip.py`	Create a new trip
`add_hotel.py`	Add a hotel candidate
`compare_hotels.py`	Compare hotel options for a trip
`shortlist.py`	Surface best-fit hotels
`book_ready.py`	Check if a hotel is ready to book
`save_preference.py`	Save reusable hotel preferences