Repo Sync Agent (heartbeat.md)

This page defines heartbeat behavior for connectsoft-repo-sync so it stays observable without burning tokens.

Goals

• Detect “stuck” gateway/channel issues early\n+- Provide a low-noise success indicator\n+- Produce actionable output only on failures

Heartbeat payload (recommended)

On a schedule (daily or every few hours), emit:

• gateway healthy?\n+- last sync run time\n+- last report path\n+- number of repos synced\n+ On failure, include:

• repo name\n+- error summary\n+- where logs/report are written

Tip

Prefer writing full details to a run report file and sending a short WhatsApp message with the report path.