From fb74d4231df51e93704f7da696ceaa4cd8814005 Mon Sep 17 00:00:00 2001 From: wangzhendong Date: Fri, 15 May 2026 12:09:54 +0800 Subject: [PATCH] Add sync state health documentation Co-authored-by: Cursor --- sync-state/README.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) create mode 100644 sync-state/README.md 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.