# HEARTBEAT.md

Development monitoring for /opt/aitbc.

On each heartbeat:
1. Run: `/opt/aitbc/dev/scripts/dev_heartbeat.py` (use `python3` or ensure executable).
2. If exit code is 0 → respond `HEARTBEAT_OK`.
3. If exit code is non-zero → parse the markdown output and send it as a proactive message (do not include `HEARTBEAT_OK`).

Script outputs:
- **All checks passed** when clean.
- **# Development Health Report** with issues (uncommitted changes, build/test failures, log errors, outdated packages) when problems are found.

Notes:
- Keep noise low: only alert on findings.
- Run checks during active hours; avoid late night unless urgent.
- Track repeated issues in memory/ notes if helpful.