[2026-09-26] eagle: personal/plans/balda-mm-pr-plan.md personal/projects/balda/balda-kraken-mm-deploy.md personal/tech/music-tags-repair-truenas.md

personal/tech/music-tags-repair-truenas.md

@@ -151,7 +151,32 @@ Alex: **«Сам проверил весь файл на адекватност
 - ⚠️ **Скрипт диагностики синка** — `check_syncthing2.sh` (в `tools/music-tags/`): версия, статус папки,
   connections, completion для телефона. Писать в файл, а не инлайн — иначе `APIKEY=` в heredoc режется.
 
-## 📋 ДОКУМЕНТЫ РЕВЬЮ В VAULT (2026-09-26)
+### 🔴 ПИТФОЛЛ: права файлов в git-клоне блокируют Syncthing
+
+После заливки нот Syncthing показал `needFiles: 1`, `needBytes: 89174` — файл **не уходил на телефон**.
+
+**Причина:** `1-needs-decision.md` имел `noPermissions: true`. Файлы, созданные/обновлённые
+из контейнера `hermes-taiga` (там **root**), получают `owner=root`, а Syncthing работает под
+**uid 950** (`truenas_admin`). Каталог был `drwxr-xr-x root:truenas_admin` → Syncthing не мог войти.
+
+**Эталон (как у всех рабочих файлов):** `truenas_admin:truenas_admin`, `drwxrwx---` (770).
+
+**Фикс:**
+```bash
+docker exec hermes-taiga chown -R 950:950 /obsidian-syncthing/<path>
+docker exec hermes-taiga chmod -R 770 /obsidian-syncthing/<path>
+# затем форс-скан
+docker exec syncthing curl -s -X POST -H "X-API-Key: $K" \
+  "http://localhost:8384/rest/db/scan?folder=k5vyy-gzdgj&sub=<path>"
+```
+
+> 🔴 **Проверять ПОСЛЕ каждого синка новых файлов.** `sudo` у `truenas_admin` требует пароль —
+> chown делать **из контейнера** (`hermes-taiga`), где root.
+
+**Правило приёмки синка:** `needFiles: 0` + `errors: 0`, а не «Pushed ✓». `Pushed` — это про git,
+не про Syncthing.
+
+
 
 CSV отдан не только файлом, но и **читаемыми нотами в Obsidian** — по просьбе Alex.