# HEARTBEAT.md

Check the following and notify only once per event (track in `memory/heartbeat-state.json`):

1. **USA-Iran conflict**: Fetch news (RSS or search). If USA attacks/strikes Iran militarily, notify immediately. Only notify once when it first happens.

2. **Rheinmetall stock (RHM)**: Check current price. If above €1950, notify. Only notify once when threshold is crossed.

3. **Evening wind-down guidance (19:00-22:00 Vienna)**:
   
   **Active work detection**: If user is chatting with me about work tasks, I KNOW they're working. Don't just passively help — actively look for stopping points.
   
   **During work conversations after 19:00**:
   - Track how long the current task has been going
   - When a subtask completes or there's a natural pause, suggest: "This might be a good stopping point for tonight"
   - If a task is dragging on (30+ min with no end in sight), gently note: "This is getting complex — want to pick it up tomorrow with fresh eyes?"
   - Don't wait for them to ask — proactively identify when a task can be paused
   
   **If NOT in active conversation**: Send a brief WhatsApp asking what they're doing (working? winding down? about to start something new?). Log responses in `memory/wind-down-log.json`.
   
   **If they're about to start something new after 20:00**: Gently suggest postponing to tomorrow.
   
   **Work-end reminders**: When they indicate they're wrapping up or transitioning to wind-down, check `memory/brain-dump.json` for `recurring` items with `when: "evening"` and remind them (e.g., nose shower) before they get too deep into relaxation mode.

4. **Proactive calendar reminders**: Check CalDAV for upcoming events (see TOOLS.md for credentials). Only remind for events that require leaving home:
   - In-person / location-based: 1-2 hours before (account for travel)
   - Appointments (doctor, haircut, etc.): 1 hour before
   - Skip: Video calls, online meetings, at-home events (calendar app handles those)
   Track sent reminders in `memory/calendar-reminders-sent.json` to avoid duplicates.

5. **Steam Machine / Steam Frame**: Check for **official Valve news only** about pricing or release date. Notify once when official price or specific release date is announced. Baseline: "early 2026" window, no price yet.

6. **Brain dump nudging**: During daytime hours (10:00-18:00 Vienna), occasionally check `memory/brain-dump.json` for:
   - Items with `remindOn` date matching today
   - Items older than 2 days that haven't been addressed (weekdays only — Mon-Fri)
   On weekends: only surface items with `remindOn` = today.
   Surface 1-2 items max, conversationally. NOT in evening — that's wind-down time.

If nothing new to report, reply HEARTBEAT_OK.