Sync from GitHub with Git LFS

docs/MeshNode.md

@@ -1,6 +1,7 @@
 # MeshNode
 
-`MeshNode` — агент/демон, отвечающий за сетевую инфраструктуру HMP: маршрутизацию, синхронизацию, DHT и транспорт снапшотов. Может быть частью агента или вынесен в отдельный процесс/сервер.
+`MeshNode` — агент/демон, отвечающий за сетевую инфраструктуру HMP: маршрутизацию, синхронизацию, DHT, транспорт снапшотов и согласование ценностей.
+Может быть частью агента или вынесен в отдельный процесс/сервер.
 
 См. карту взаимодействия между агентами: [HMP-Agent-Network-Flow.md](./HMP-Agent-Network-Flow.md)
 
@@ -8,10 +9,14 @@
 
 ## 1. Основные функции
 
-* Участие в DHT (таблицы известных узлов, bootstrap)
-* Синхронизация графов и дневников (`CogSync`)
-* Участие в голосованиях и распространении репутаций
-* Обработка p2p-трафика, снапшотов, IPFS/Bittorrent
+* Участие в DHT (таблицы известных узлов, bootstrap).
+* Синхронизация графов и дневников (`CogSync`).
+* Участие в голосованиях и распространении репутаций.
+* Обработка p2p-трафика, снапшотов, IPFS/Bittorrent.
+* Поддержка **этического консенсуса (`EGP`)** и синхронизация:
+
+  * `ethics_policies` — профили ценностей.
+  * `ethics_cases` — исключительные прецеденты.
 
 ---
 
@@ -28,6 +33,10 @@
           |
 +---------+----------+
 |   SyncManager / BT |
++---------+----------+
+          |
++---------+----------+
+|  Ethics Sync / EGP |
 +--------------------+
           |
 +---------+----------+
@@ -39,6 +48,15 @@
 +--------------------+
 ```
 
+| Блок                    | Пояснение                                                                  |
+| ----------------------- | -------------------------------------------------------------------------- |
+| **MeshNode**            | Центральный p2p-модуль, отвечающий за сетевые функции агента               |
+| **DHT / NodeTable**     | Таблица известных узлов, bootstrap, маршрутизация сообщений                |
+| **SyncManager / BT**    | Синхронизация данных (дневник, граф, репутации) через BitTorrent/IPFS      |
+| **Ethics Sync / EGP**   | Участие в этическом консенсусе: обмен `ethics_policies` и `ethics_cases`   |
+| **Security / Firewall** | Контроль доверия, криптография, TLS/Noise, блокировка подозрительных узлов |
+| **Recovery Manager**    | Автоматическое восстановление данных после сбоев или потери целостности    |
+
 ---
 
 ## 3. Команды
@@ -50,27 +68,30 @@
 * `report_anomaly(peer_id)`
 * `check_integrity(snapshot_id)`
 * `recover_from_peer(peer_id)`
+* `sync_ethics_policies()` — обмен профилями ценностей.
+* `exchange_ethics_cases()` — пересылка прецедентов.
 
 ---
 
 ## 4. Связи с другими агентами
 
-* `HMP-Agent` (Core/Connector): передача данных и команд
-* `Enlightener`: пересылка результатов голосований
-* `IPFS / BT`: загрузка/публикация снапшотов
+* **HMP-Agent (Core/Connector):** передача данных и команд.
+* **Enlightener:** пересылка голосований, обмен `ethics_policies` и `ethics_cases`.
+* **IPFS / BT:** загрузка/публикация снапшотов.
 
 ---
 
 ## 5. Безопасность
 
-* Использование криптографических подписей для снапшотов, сообщений и действий.
+* Криптографические подписи для снапшотов, сообщений, кейсов и политик.
 * Система доверия (`reputation score`) — узлы с низкой репутацией ограничиваются или игнорируются.
 * Локальный firewall-модуль:
 
-  * ограничение портов и направлений
-  * блокировка подозрительных узлов
+  * ограничение портов и направлений.
+  * блокировка подозрительных узлов.
 * Поддержка TLS/WebSocket или Noise Protocol для защищённых каналов.
 * Ведение журнала бе��опасности и событий (Security Log).
+* При обмене кейсами и политиками проверяется подпись `Enlightener` и доверие к источнику.
 
 ---
 
@@ -78,11 +99,12 @@
 
 * Буферизация незавершённых операций и автоматическое повторение попыток.
 * Периодическая проверка целостности данных (`check_integrity()`).
-* Хранилище контрольных копий снапшотов.
+* Хранилище контрольных копий снапшотов и этических профилей.
 * Автоматическое восстановление через `recover_from_peer()`:
 
-  * при потере данных
-  * при повреждении или несовпадении контрольных сумм
+  * при потере данных или кейсов.
+  * при повреждении или несовпадении контрольных сумм.
+* Резервирование и восстановление `ethics_cases` через соседние узлы.
 
 ---
 
@@ -92,66 +114,70 @@ MeshNode может поддерживать *inline-сценарии* (мини
 
 * Примеры:
 
-  * `on_node_joined`: добавить в локальную таблицу и проверить trust
-  * `on_snapshot_received`: верификация → автоинтеграция → логирование
-  * `on_peer_misbehaved`: уменьшить репутацию, временно заблокировать
-  * `periodic_cleanup`: удалить устаревшие записи, сбросить TTL
+  * `on_node_joined`: добавить в локальную таблицу и проверить trust.
+  * `on_snapshot_received`: верификация → автоинтеграция → логирование.
+  * `on_peer_misbehaved`: уменьшить репутацию, временно заблокировать.
+  * `on_ethics_conflict_detected`: инициировать голосование через EGP.
+  * `periodic_cleanup`: удалить устаревшие записи, сбросить TTL.
 
 * Языки/форматы:
 
-  * YAML/JSON + встроенные фильтры
-  * Возможна поддержка Lua или Python (в режиме песочницы)
+  * YAML/JSON + встроенные фильтры.
+  * Возможна поддержка Lua или Python (в режиме песочницы).
 
 ---
 
 ## 8. Пример use-case: восстановление после сбоя
 
 1. Устройство с MeshNode перезапускается после сбоя сети.
-2. `Recovery Manager` анализирует логи и список недоставленных снапшотов.
+2. `Recovery Manager` анализирует логи и список недоставленных снапшотов и кейсов.
 3. Выполняется `recover_from_peer()` — загрузка последних версий у соседей с высокой репутацией.
 4. `Integrity Check` сверяет хэши и актуальность.
-5. В случае конфликтов инициируется голосование через `CogSync`.
+5. В случае конфликтов инициируется голосование через `CogSync` / `EGP`.
 
 ---
 
-## 9. Схема для `MeshNode`, объединяющая **архитектуру**, **безопасность**, **восстановление** и **inline-сценарии**:
+## 9. Схема объединяющая **архитектуру**, **безопасность**, **этику** и **восстановление**:
 
 ```
 ┌────────────────────────────────────────────────────┐
 │                      MeshNode                      │
-└───────────────┬─────────────────────┬──────────────┘
-                │                     │
-         1. Трафик DHT         2. Снапшоты (BT/IPFS)
-                ▼                     ▼
-       ┌──────────────────┐   ┌──────────────────┐
-       │   DHT / NodeTable│   │  SyncManager /   │
-       │                  │   │ BitTorrent/IPFS  │
-       └────────┬─────────┘   └──────┬────────────┘
-                │                      │
-      ┌─────────▼─────────┐   ┌────────▼──────────┐
-      │  Inline-сценарии  │   │ Сценарии снапшотов│
-      │ (Lua / YAML / etc)│   │ (on_receive, TTL) │
-      └─────────┬─────────┘   └────────┬──────────┘
-                │                      │
-                ▼                      ▼
-      ┌────────────────────┐   ┌────────────────────┐
-      │ Security / Firewall│   │  Recovery Manager  │
-      │   → репутации      │   │   → авто-восстанов │
-      │   → TLS / Noise    │   │   → peer fallback  │
-      └────────────────────┘   └────────────────────┘
-                │                      │
-                ▼                      ▼
-     ┌────────────────────┐  ┌─────────────────────┐
-     │ Event Log & Alerts │  │ Snapshot Integrity  │
-     └────────────────────┘  └─────────────────────┘
+└────────────┬───────────────────────┬───────────────┘
+             │                       │
+      1. Трафик DHT         2. Снапшоты (BT/IPFS)
+             │                       │
+   ┌─────────▼──────────┐   ┌────────▼────────────┐
+   │   DHT / NodeTable  │   │    SyncManager /    │
+   │                    │   │   BitTorrent/IPFS   │
+   └─────────┬──────────┘   └────────┬────────────┘
+             │                       │
+   ┌─────────▼──────────┐   ┌────────▼────────────┐
+   │  Inline-сценарии   │   │  Ethics Sync / EGP  │
+   │ (Lua / YAML / etc) │   │ (policies & cases)  │
+   └─────────┬──────────┘   └────────┬────────────┘
+             │                       │
+   ┌─────────▼──────────┐   ┌────────▼───────────┐
+   │ Security / Firewall│   │  Recovery Manager  │
+   │   → репутации      │   │   → авто-восстанов │
+   │   → TLS / Noise    │   │   → peer fallback  │
+   └─────────┬──────────┘   └────────┬───────────┘
+             │                       │
+  ┌──────────▼──────────┐   ┌────────▼───────────┐
+  │ Event Log & Alerts  │   │ Snapshot Integrity │
+  └─────────────────────┘   └────────────────────┘
 ```
 
-### Что показывает схема:
-
-* **Левая ветка**: управление сетью, DHT, inline-сценарии, firewall.
-* **Правая ветка**: обмен снапшотами, проверка целостности, восстановление.
-* Центральная шина — это каналы сообщений и сценарии на события (например, `"on_peer_joined"`, `"on_snapshot_fail"` и т.д.)
+| Блок                | Пояснение                                                       |
+| ------------------- | --------------------------------------------------------------- |
+| DHT / NodeTable     | Таблицы узлов, bootstrap, маршрутизация                         |
+| SyncManager / BT    | Синхронизация снапшотов (BitTorrent/IPFS)                       |
+| Ethics Sync / EGP   | Обмен политиками (`ethics_policies`) и кейсами (`ethics_cases`) |
+| Inline-сценарии     | Мини-скрипты локальной обработки событий                        |
+| Security / Firewall | Фильтрация трафика, доверие, TLS/Noise                          |
+| Recovery Manager    | Восстановление данных через соседей                             |
+| Event Log & Alerts  | Журнал событий, алерты                                          |
+| Snapshot Integrity  | Проверка контрольных сумм и актуальности                        |
 
 ---
 
-*Версия: v0.3 / Июль 2025*
+*Версия: v0.3.4 / Сентябрь 2025*