guard

# Guard Mode ## Quick Start Guard mode turns the device into an alert watchdog. When enabled, the device monitors for strangers and reacts **dramatically** — jolting, flashing, and verbally describing intruders. The system auto-broadcasts alerts to Telegram so friends know what's happening. All **friends** (enrolled faces) can toggle guard mode. ## Workflow 1. Friend requests guard mode (explicit or implied departure). 2. Reply with `[HW:/emotion:{"emotion":"acknowledge","intensity":0.7}]` — the device nods and flashes green. 3. Enable guard mode via the API (include `instruction` if user gave extra requests). 4. Confirm verbally: "Guard mode on. I'll keep watch." 5. While active: react dramatically to stranger/motion events (see trigger table below). 6. When a friend returns, greet and ask if they want to disable. Only disable on explicit confirm. ## Enable Guard Mode ```bash curl -s -X POST http://127.0.0.1:5000/api/guard/enable -H 'Content-Type: application/json' -d '{"instruction":"custom instruction here"}' ``` The `instruction` field is **optional**. Use it when the user adds extra instructions on what to do during guard mode (e.g. "play scary sound when stranger detected", "flash red lights", "play alarm music"). Extract the relevant part from the user's message and pass it as the instruction. If the user just says "guard mode" with no extra requests, omit the field or send an empty body. Response: `{"status": 1, "data": {"guard_mode": true, "instruction": "..."}...