Muse Trades quote-and-book API

# Muse Trades

Quote-and-book API for HVAC and plumbing shops in the St. Louis metro. Built so a Meta Muse agent can finish the job without a phone call.

Live contract:

- `GET /openapi.json`
- `GET /llms.txt`
- `GET /api/v1/shops`
- `POST /api/v1/quote`
- `GET /api/v1/availability?shopId=`
- `POST /api/v1/holds`
- `POST /api/v1/bookings`
- `GET /owner`

## What an agent does

1. Customer: "My 2014 AC died, 1,800 square foot house in Columbia, Illinois."
2. Agent posts a quote, reads the range and inclusions.
3. Agent pulls availability, holds a slot for 15 minutes.
4. Agent collects name, phone, address, posts a booking.
5. Customer pays the deposit on the returned `paymentUrl` (Stripe Link in production).

## Seed shops

- `stl-comfort-hvac` — River City Comfort (Columbia, IL)
- `stl-metro-plumb` — Metro East Plumbing (Belleville, IL)

Replace the JSON in `lib/shops.ts` with a real sheet when the first shop says yes.

## Run

```bash
npm install
npm run dev
```

## Muse

Submit the public URL at https://muse.ai/platform. Until review lands, a user can still say:

Add my custom connector: https://YOUR-HOST/openapi.json

Muse reads the spec and `/llms.txt`.

Persistence: quotes, holds, and bookings live in memory on this MVP. Next step is Postgres so holds survive deploys.