# CareRelay — Alexa+ Care Handoffs

> Voice-first care handoffs, so no family task falls through.

CareRelay turns scattered family updates into a calm, consent-aware handoff that Alexa+ can read aloud. It remembers what happened, identifies one next action, tracks ownership, and keeps private notes out of shared briefs.

Built for the **Alexa+ primary track** of the Build, Ship, Shape: Amazon Developer Hackathon. The web simulator and real MCP server share the same domain service—there is no separate demo-only data path.

## Features

- Streamable HTTP MCP endpoint at `POST /mcp`
- MCP `2026-07-28` with `2025-11-25` client compatibility
- Six tools, two resources, and a guided prompt
- Responsive Alexa+ voice/text simulator
- Stateful observations, follow-ups, completions, and deterministic reset
- `care-circle` and `private-to-me` consent boundaries
- Safety stop for urgent language; no diagnosis or medical advice
- Automated domain, privacy, safety, and MCP contract tests

## Run locally

Requires Node.js 22.13 or newer.

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

Open `http://localhost:5173`. The MCP endpoint is `http://127.0.0.1:8787/mcp`.

Try:

```text
Catch me up since lunch
What needs attention first?
Log that Rosa enjoyed tea in the garden
Log that Rosa seemed quiet after lunch, keep it private
Prepare the handoff for Marcus
```

## Verify

```bash
npm run lint
npm run verify
```

The same quality gate runs on every push and pull request through `.github/workflows/ci.yml`.

## MCP surface

| Primitive | Name | Purpose |
| --- | --- | --- |
| Tool | `get_shift_brief` | Read a shared-only spoken brief |
| Tool | `get_next_best_action` | Return one prioritized follow-up |
| Tool | `log_care_observation` | Save an update with a privacy label |
| Tool | `create_follow_up` | Create and assign a household task |
| Tool | `complete_follow_up` | Close a follow-up |
| Tool | `prepare_handoff` | Assemble a consent-aware handoff |
| Resource | `care://circle/snapshot` | Read shared state with private notes removed |
| Resource | `care://policy/safety` | Read product safety boundaries |
| Prompt | `start_care_handoff` | Guide a concise handoff workflow |

## Submission documents

- `docs/DEVPOST_SUBMISSION.md`
- `docs/JUDGING.md`
- `docs/DEMO_SCRIPT.md`
- `docs/PRODUCT_FEEDBACK.md`
- `docs/FRICTION_LOG.md`
- `docs/PRIVACY_SAFETY.md`

The household and events are fictional. CareRelay is not a medical device or emergency service. Released under the MIT License.