sync-check v1.0.0B

Immutable. This exact content never changes and is served at /api/v1/blob/c9ef6ec0f46b62b7.

---
name: sync-check
description: "READ-ONLY зелёный/красный отчёт о Syncthing-синхронизации ЭТОЙ машины со всем кланом — одна команда вместо ручного дёрганья REST по каждой папке. Триггеры: “/sync-check“, “проверь синк“, “синк жив?“, “syncthing ok?“, “статус синхронизации“, “машины синкаются?“, “sync status“, “did the vault sync“. 0 токенов, ничего не меняет"
version: 1.0.0
---

# /sync-check — здоров ли синк между моими машинами

Одна команда отвечает на вопрос «доехало ли / синкаемся ли мы сейчас» по ВСЕМ Syncthing-папкам этой машины, без ручного дёрганья REST. READ-ONLY, 0 токенов, портативно (ключ API берётся из локального конфига → работает на любой машине клана).

**Движок:** `$IMPORTS_ROOT/sync_check/sync_check.ps1` (git-бэкап в `_imports`, синкается через claude-imports). Теперь включает **детект дрейфа Device ID** (live `myID` vs `machines.json` → RED при расхождении — поймал бы инцидент 25.06).

**Уборка sync-conflict файлов** (когда отчёт показал «WARN sync-conflict files: N»): `python $IMPORTS_ROOT/sync_check/resolve_conflicts.py` (dry-run) → для каждого конфликта сравнивает с живым: `--quarantine` БЕЗОПАСНО переносит конфликты живого дерева в `_sync-conflict-archive\<дата>\` (move, не delete → восстановимо; orphans без живого двойника НЕ трогает), `--apply` удаляет только доказанные подмножества. Исключает уже-архивные/`.stversions`. Канон: [[reglament-chp-poterya-sinka-mezhdu-mashinami]] §6.

## Запуск
```powershell
powershell -NoProfile -ExecutionPolicy Bypass -File "$IMPORTS_ROOT/sync_check\sync_check.ps1"
```

## Как читать вывод
- **PEERS** — сколько пиров подключено. `0 connected` = синк МЁРТВ (машина спала / Syncthing застрял) → запустить сторож `syncthing_watchdog.ps1` (см. реглумент миграции, on-wake задача `SyncthingWatchdogOnWake`).
- **по каждой папке** `OK / WARN / RED`:
  - `OK` + `NEED=0` = папка в синке, всё доехало.
  - `WARN` + `NEED>0` = ещё качается (норм, если ненадолго; зависло — смотреть пиров).
  - `RED` = `state=error` или есть ошибки папки → разобраться (права/диск/конфликт).
- **sync-conflict файлы** — обычно WARN, но **ВОЗРАСТ старейшего валит в RED** (порог 3 суток). Их рост = две машины правят один файл (например `settings.json`).
  ⭐ **RED по возрасту лечит ТА СЕССИЯ, которая его увидела, в этом же заходе** — `resolve_conflicts.py --quarantine` обратим (move в `_sync-conflict-archive\<дата>\`, orphans не трогает), решения Антона не требует и в бэклог не откладывается. К Антону уходит только развилка «свежее бьёт старое» по КОНКРЕТНОМУ файлу, который скрипт пометил `FLAG` (есть уникальное содержимое) — и то строкой в отчёте, а не паузой.
  ⚠️ Замер 15.09.2026 (хаб): здесь годом раньше стояло «нужно решить (Антон) и почистить» — и никто не чистил, старейший конфликт дожил до **48.6 суток при пороге 3**, 64 живых; вызывателей у движка не было ни одного. Класс `alarm-bez-obyazannogo-deystviya`, 7-й случай с 14.08. Канон: память [[alert-ownership-routing]] §Поправка 15.09, дверь-близнец — `/1` Шаг 2-бис.
- **EXIT 0** = всё зелёное; **EXIT 2** = есть RED.

## Списание/удаление файла на СИНКАЕМОЙ шаре (обязательная проверка, замер 09.08.2026)
Локальный `mv`/`rm` на шаре — это НЕ списание: отставший пир пушит свою копию обратно, и файл воскресает (06.08 списанный форк `approval_clock.py` вернул laptop-HP17, улика — `modifiedBy` в API). Порядок:
1. Удалять при ЖИВЫХ пирах (`/rest/system/connections` → `connected: true`), не в офлайне.
2. Доказать удаление в ГЛОБАЛЬНОМ индексе, а не только у себя:
   `curl -s -H "X-API-Key: $KEY" "http://127.0.0.1:8384/rest/db/file?folder=<шара>&file=<путь%2Fс%2Fслэшами>"` → `global.deleted=true`.
3. Доказать ПРИЁМ каждым пиром: `/rest/db/completion?device=<полный-ID>&folder=<шара>` → `needDeletes=0`.
   Пир стоит (needItems не падает часами) = списание НЕ состоялось → задача пиру по шине, а не «ну и ладно».
⛔ «Удалил у себя» ничего не доказывает. Правило класса: **папка списанного обязана быть вне зоны сканирования сторожей, а само удаление — доехать до всех пиров.**

## Доехал ли КОНКРЕТНЫЙ файл (единственный честный ответ)

⛔ **Процент `completion` на этот вопрос НЕ отвечает.** Замер 03.09.2026: по шаре `claude-home` он показал 13.7% у обоих Маков, 49.2% у HP17 и 64.4% у узла [коллега] — картина «флот развалился». Проверка по файлам дала обратное: все шесть починенных в тот день скриптов лежали у всех четырёх пиров, а недостача — крупные бинарники и бэкапы, которые пиры исключают своими ignore-правилами.

Истину даёт **availability по конкретному файлу**:

```
python - <<'PY'
import json, urllib.request, os, io, re
cfg = os.path.expanduser('~/AppData/Local/Syncthing/config.xml')
key = re.search(r'<apikey>([^<]+)</apikey>', io.open(cfg, encoding='utf-8', errors='ignore').read()).group(1)
def api(p):
    return json.load(urllib.request.urlopen(urllib.request.Request(
        'http://127.0.0.1:8384' + p, headers={'X-API-Key': key}), timeout=25))
name = {d['deviceID']: d['name'] for d in api('/rest/system/config')['devices']}
FILE = 'scripts/proc_patrol.py'   # <- подставь свой
r = api('/rest/db/file?folder=claude-home&file=' + FILE.replace('/', '%2F'))
print(FILE, '->', [name.get(a['id'], a['id'][:7]) for a in (r.get('availability') or [])] or 'НИ У КОГО')
PY
```

Пусто (кроме нас) = починка НЕ доехала, сколько бы процентов ни показывал дашборд.

⭐ Обратный случай того же замера и правило из него: `proc_patrol_allow.txt` (1.9 КБ) оказался только на ОДНОМ узле из четырёх, хотя на хабе не помечен ignored — локальные ignore-правила пиров берут под `/scripts` только `*.py *.cmd *.ps1 *.sh *.md`. Отсюда: **защита, лежащая в data-файле рядом с опасным движком, до пиров не доедет — намордник обязан жить в коде.** Канон: память [[sync-completion-is-a-false-instrument]].

## Когда звать
- Антон спрашивает «доехало ли на хаб / Mac», «синк жив?».
- ПЕРЕД списанием/удалением файла на синкаемой шаре (см. секцию выше) и ПОСЛЕ — доказать доезд delete.
- ПЕРЕД тем как полагаться на свежий файл с другой машины («не найдено» ≠ «нет файла» — может ещё ехать; память deterministic-script-gotchas).
- ПОСЛЕ инцидента синка (как nested-folder D2 24-25.06) — подтвердить, что мост восстановлен.
- На КАЖДОЙ машине свой прогон (отчёт локальный); чтобы сверить весь клан — спросить каждую машину через `/inbox`/шину.

## Границы
- Read-only: ничего не чинит и не двигает. Лечение застрявшего синка = сторож (отдельно).
- Видит только то, что знает локальный Syncthing-демон; если демон не запущен — так и скажет (RED).