FixLoop

Voice-first household incident recovery, built as an Alexa+ concept simulation (not an official Alexa product; no native Alexa/Echo integration is claimed).

Status

See docs/IMPLEMENTATION_STATUS.md for what genuinely works today.

Related MCP server: Latchbook

Run locally (no Docker required)

pnpm install            # pnpm 12, Node >= 22
cp .env.example .env
pnpm db:start &         # real PostgreSQL 17 via embedded-postgres on :54329 (or: docker compose up -d)
pnpm db:migrate && pnpm db:seed
pnpm dev                # API + MCP at http://127.0.0.1:4000 (POST /mcp)
pnpm verify             # typecheck + tests

Delivery: simulated or real email

After you approve a repair request, FixLoop delivers it one of two ways, chosen by DELIVERY in .env:

• simulated (default): the request is stored in the local ProviderRequest table. No technician is contacted.

• email: the exact approved text is emailed through the Resend API. Set EMAIL_API_KEY, EMAIL_FROM and TECHNICIAN_EMAIL. With Resend's test sender (onboarding@resend.dev) mail can only go to the address that owns the Resend account, so use that address as TECHNICIAN_EMAIL to try it safely.

In email mode the recipient address is on the approval card, is covered by the approval hash, and the request is sent at most once (the request's idempotency key is the email service's Idempotency-Key). The demo scenarios that submit a request or inject faults are disabled, because they only make sense with the simulated provider.