diff --git a/sync-state/README.md b/sync-state/README.md new file mode 100644 index 0000000..771c4c0 --- /dev/null +++ b/sync-state/README.md @@ -0,0 +1,19 @@ +# Sync State + +Tracked health reports from PC and VPS sync scripts. + +Files: + +- `heartbeat-pc.json`: last successful PC sync-script heartbeat. +- `heartbeat-vps.json`: last successful VPS sync-script heartbeat. +- `error-pc.md`: PC sync-script error report, if present. +- `error-vps.md`: VPS sync-script error report, if present. + +These files must not contain secrets. They exist so CORRECTION can detect stale communication without direct terminal access. + +Health thresholds: + +- Warning: peer heartbeat older than 2 minutes. +- Blocked: peer heartbeat older than 5 minutes. +- Blocked: any `error-*.md` file exists. +- Blocked: either side reports persistent `ahead`, `behind`, or dirty state that prevents evidence visibility.