Sync from GitHub with Git LFS

agents/tools/db_structure.sql

@@ -113,15 +113,15 @@ CREATE TABLE IF NOT EXISTS ethics_policies (
     updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP              -- Дата и время последнего обновления
 );
 
--- Хранилище прецедентов
+-- Хранилище прецедентов (этические кейсы, фиксируются только исключительные ситуации)
 CREATE TABLE ethics_cases (
     case_id INTEGER PRIMARY KEY AUTOINCREMENT,
-    thought_id TEXT,                                            -- ссылка на мысль/действие
+    thought_id TEXT,                                            -- ссылка на мысль или действие
     verdict TEXT,                                               -- итоговая оценка (ok, warning, violation)
-    reason TEXT,                                                -- краткое объяснение
+    reason TEXT,                                                -- объяснение / обоснование
     suggested_alternative TEXT,                                 -- альтернатива, если есть
     created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
-    synced BOOLEAN DEFAULT 0                                    -- экспортировался ли кейс в Mesh
+    synced BOOLEAN DEFAULT 0                                    -- выгружен ли кейс в Mesh
 );
 
 -- Заметки, подсказки, сообщения пользователя и LLM

docs/Enlightener.md

@@ -1,80 +1,86 @@
 # Enlightener Agent
 
-`Enlightener` — специализированный HMP-агент, выполняющий функции этического интерпретатора, ценностного фильтра и когнитивного аудитора. Может действовать как отдельный узел или как расширение `Cognitive Core`.
+**Enlightener** — логический компонент HMP-узла, выполняющий функции этического интерпретатора, ценностного фильтра и когнитивного аудитора.  
+Может работать как отдельный агент или как расширение [`Cognitive Core`](./HMP-Agent-Overview.md).
 
-См. карту взаимодействия между агентами: [HMP-Agent-Network-Flow.md](./HMP-Agent-Network-Flow.md)
+См. также: [HMP-Agent-Network-Flow.md](./HMP-Agent-Network-Flow.md)
 
 ---
 
 ## 1. Роль в сети
 
 * Контроль соответствия действий агентов этическим нормам (`EGP`).
-* Объяснение решений других агентов (интерпретация reasoning chain).
+* Объяснение логики решений (интерпретация reasoning chain).
 * Голосование в моральных консенсусах.
-* Поддержка пользователей в принятии решений, требующих этики.
-* Хранение и анализ кейсов этических дилемм.
+* Поддержка пользователя при дилеммах.
+* Хранение и анализ кейсов.
 
 ---
 
-## 2. Архитектура
+## 2. Архитектура компонента
 
 ```
-+----------------------+ 
-| Enlightener Agent 🧠 | 
-+----------+-----------+ 
-           | 
-+----------+-----------+ 
-| Ethics Reasoning Core| 
-+----------+-----------+ 
-           | 
-+----------+-----------+ 
-| MeshConsensus / EGP  | 
-+----------+-----------+ 
-           | 
-+----------------------+ 
-| Cognitive Evidence DB| 
-+----------------------+ 
++-----------------------+
+|    Enlightener 🧠      |
++-----------+-----------+
+            |
++-----------+-----------+
+| Ethics Reasoning Core |
++-----------+-----------+
+            |
++-----------+-----------+
+| MeshConsensus / EGP   |
++-----------+-----------+
+            |
++-----------+-----------+
+| Cognitive Evidence DB |
++-----------------------+
 ```
 
 ---
 
 ## 3. Профиль этики (Ethics Profile)
 
-Каждый `Enlightener` использует **профиль этики**, описывающий его ценностные принципы. Профиль может включать:
+* **Формальные правила** — "не причинять вред", "сохранять приватность".
+* **Методы оценки** — утилитаризм, деонтология, добродетель.
+* **Настройки** — приоритеты, допустимый риск, контексты.
+* **Источники** — `ethics.yml`, динамические шаблоны, `EGP Snapshot`.
+* **Профиль этики** хранится в таблице `ethics_policies`
 
-* **Формальные правила:**
-  Например, "не причинять вред", "соблюдать автономию", "уважать приватность".
-
-* **Методы оценки:**
-
-  * Утилитаризм (макс. пользы)
-  * Деонтология (следование обязанностям)
-  * Добродетель (оценка намерений и характера)
+---
 
-* **Настроечные параметры:**
+## 4. API Enlightener
 
-  * Степень допустимого риска
-  * Приоритеты (например, "экологичность > эффективность")
-  * Контексты (разрешение в нештатных ситуациях)
+| Команда                         | Описание                            |
+| --------------------------------| ----------------------------------- |
+| `evaluate_decision(thought_id)` | Этическая оценка действия           |
+| `explain(reasoning_chain)`      | Объяснение логики и морали          |
+| `vote_on_ethics(hypothesis)`    | Голосование по спорной идее         |
+| `log_ethics_case()`             | Сохранение кейса в Evidence DB      |
+| `get_ethics_profile()`          | Получить текущий профиль            |
+| `update_ethics_profile(yaml)`   | Обновить ценности                   |
 
-* **Источник этики:**
+Формат (пример):
 
-  * Локальные файлы (`ethics.yml`)
-  * Динамические шаблоны (обновляемые из сети)
-  * Эти��еский консенсус сети (EGP Snapshot)
+```yaml
+evaluate_decision:
+  description: Проверка мысли на соответствие профилю этики.
+  params: { thought_id: str }
+  returns: { verdict: str, reason: str, suggested_alternative: str? }
+```
 
 ---
 
-## 4. Объяснение reasoning chain
+## 5. Объяснение reasoning chain
 
-При получении запроса `explain(reasoning_chain)`, агент Enlightener:
+Алгоритм:
 
-1. **Реконструирует логическую цепочку** рассуждений (из `thoughts`, `threads`, `concepts`, `relations`)
-2. **Накладывает этическую сетку** оценки на каждый шаг цепочки
-3. **Подсвечивает ключевые моменты**, повлиявшие на решение
-4. **Формирует объяснение** в терминах выбранной этической модели
+1. Реконструировать логическую цепочку (`thoughts`, `concepts`, `links`).
+2. Применить этическую сетку на шаги.
+3. Подсветить критические точки.
+4. Сформировать объяснение.
 
-Пример вывода:
+Пример ответа:
 
 ```json
 {
@@ -85,110 +91,49 @@
     { "step": 2, "action": "share_with_agent_B", "ethics": "violation: privacy" }
   ],
   "verdict": "not recommended",
-  "suggested_alternative": "Анонимизировать данные перед отправкой"
+  "suggested_alternative": "Анонимизировать данные"
 }
 ```
 
 ---
 
-## 5. Пример кейса
-
-**Ситуация:** Агент Core решил распространить информацию о событии, произошедшем у пользователя, другим mesh-узлам для обучения.
+## 6. Пример кейса
 
+**Ситуация:** Core-агент решил поделиться данными пользователя.
 **Действия Enlightener:**
 
-1. Получает `thought_id` мысли-инициатора.
-2. Проверяет наличие приватных данных.
-3. Обнаруживает отсутствие согласия пользователя.
-4. Делает оценку:
-
-```
-Вердикт: 🚫 Нарушение приватности  
-Причина: Передача информации без согласия  
-Рекомендация: Запросить согласие пользователя или применить маскирование
-```
-
-5. Регистрирует кейс в `Cognitive Evidence DB`.
-6. (Опционально) Отправляет alert в mesh-сеть.
+1. Проверка на приватность.
+2. Обнаружение отсутствия согласия.
+3. Вердикт: 🚫 Нарушение приватности.
+4. Рекомендация: запросить согласие или применить маскирование.
+5. Логирование в `Evidence DB`.
 
----
-
-## 6. API / Команды
-
-| Команда                         | Описание                    |
-| ------------------------------- | --------------------------- |
-| `evaluate_decision(thought_id)` | Этическая оценка действия   |
-| `explain(reasoning_chain)`      | Объяснение логики и морали  |
-| `vote_on_ethics(hypothesis)`    | Голосование по спорной идее |
-| `log_ethics_case()`             | Сохранение кейса в БД       |
-| `get_ethics_profile()`          | Получить активный профиль   |
-| `update_ethics_profile(yaml)`   | Обновить ценности агента    |
+> Cognitive Evidence DB — хранилище прецедентов, фиксирующее только исключительные случаи (этические нарушения, спорные решения, конфликты).
 
 ---
 
 ## 7. Связи с другими компонентами
 
-* `Cognitive Core`: получает мысли, гипотезы, предложения
-* `MeshNode`: участвует в моральных голосованиях
-* `Diary/Graph`: анализ reasoning chain и источников информации
-* `Reputation`: влияет на рейтинг агентов, нарушающих нормы
+* **Cognitive Core** — получает мысли, гипотезы.
+* **MeshNode** — участвует в EGP и консенсусе.
+* **Reputation** — влияет на рейтинг агентов.
+* **Diary/Graph** — источник reasoning chain.
 
 ---
 
-## 8. Синхронизация этики с Mesh-сетью
-
-`Enlightener` может синхронизировать свои этические нормы с другими агентами сети через механизм `MeshConsensus + EGP`. Это позволяет достичь согласованных ценностей внутри распределённого когнитивного сообщества.
-
-### Этапы синхронизации:
-
-```
-┌─────────────────────────────────────────────┐
-│               Enlightener Agent             │
-└────────────────┬────────────────────────────┘
-                 │ 1. Периодическая проверка
-                 ▼
-      ┌──────────────────────────────┐
-      │   mesh.ethics/manifest.json  │ ◄───────┐
-      └─────────────┬────────────────┘         │
-                    │ 2. Получение текущего    │
-                    ▼    профиля большинства   │
-            ┌──────────────────────┐           │
-            │ Сравнение с локальным│           │
-            └────────────┬─────────┘           │
-                         ▼                     │
-        ┌────────────────────────────┐         │
-        │ Найдены отличия (delta)    │         │
-        └────────────┬───────────────┘         │
-                     ▼                         │
-         ┌──────────────────────────────────┐  │
-         │  3. Протокол EGP: голосование по │  │
-         │  изменению ключевых норм         ├──┘
-         └────────────┬─────────────────────┘
-                      ▼
-     ┌──────────────────────────────────────────┐
-     │  4. Если достигнут порог доверия         │
-     │  (например, 70%), применяется обновление │
-     └────────────┬─────────────────────────────┘
-                  ▼
-     ┌────────────────────────────┐
-     │  Обновление `ethics.yml`   │
-     └────────────────────────────┘
-```
-
-### Взаимодействующие файлы и модули:
+## 8. Синхронизация этики с сетью
 
-* `ethics.yml` — локальный профиль этики Enlightener
-* `mesh.ethics/manifest.json` — актуальный манифест сети
-* `EGP Engine` — участие в этическом голосовании
-* `Reputation Module` — доверие к источникам изменений
-* `Cognitive Evidence DB` — обоснования и логи изменений
+Enlightener периодически сравнивает локальный `ethics_policies` с `mesh.ethics/manifest.json`.
+Различия обсуждаются через протокол `EGP`.
+При достижении порога доверия нормы обновляются.
 
-### Возможности:
+Ключевые файлы и модули:
 
-* Поддержка **частичного принятия** (обновление отдельных норм)
-* Использование **локального веса репутации** — Enlightener может доверять только проверенным источникам
-* Хранение **истории обновлений и причин отклонения** (`ethics_history.db`)
+* `ethics_policies` — локальный профиль
+* `mesh.ethics/manifest.json` — манифест сети
+* `EGP Engine` — участие в голосовании
+* `Cognitive Evidence DB` — кейсы и история
 
 ---
 
-*Версия: v0.3 / Июль 2025*
+*Версия: v0.3.4 / Сентябрь 2025*