# DoorSense: Alexa+ caregiving companion

Ask Alexa "Is Mom okay?" and get a real answer from her front door.
Built for the Amazon Developer Hackathon 2026 (Alexa+ track, Open Source mini challenge).

**Live app:** https://spark-the-next-venture.lovable.app
**MCP connection:** https://spark-the-next-venture.lovable.app/mcp

## Features
- Simulated Alexa+ voice chat (AI-powered)
- Wellness score and alerts: no activity for 18h or more, 3 or more unknown visitors in 24h, a package left out for 6h or more
- "Ask about visits": findings plus a suggested next step
- **MCP server** (Streamable HTTP, spec 2025-11-25) with tools:
  - `check_on_resident`: score, hours since last activity, alerts
  - `get_recent_events`: front-door events in the last N hours
  - `notify_family`: demo check-in message to family (simulated)

Try the MCP server with any MCP client pointed at the connection URL above.

## Run locally
Requires Bun (or Node 20+):
```bash
bun install
bun run dev
```
Then open http://localhost:8080. Run the tests with `bunx vitest run`.

## Code map
- `src/lib/doorsense/`: demo household data, wellness rules, AI chat client, AI functions
- `src/lib/mcp/`: MCP server and tools
- `src/routes/index.tsx`: dashboard

Demo data is fictional (Kamala, 78, and her family). License: MIT.