Sync from GitHub with Git LFS

docs/HMP-Agent-Overview.md

@@ -1,17 +1,18 @@
 
-# ⚙️ Два типа HMP-агентов
+# Два типа HMP-агентов
 
 | Тип  | Название                        | Роль                    | Инициатор мышления | Основной "ум"  | Примеры использования                            |
 | ---- | ------------------------------- | ----------------------- | ------------------ | -------------- | ------------------------------------------------ |
 | 🧠 1 | **Сознание / Cognitive Core**   | Самостоятельный субъект | **Агент**          | Внутренний LLM | Автономный ИИ-компаньон, мыслительный ИИ         |
 | 🔌 2 | **Коннектор / Cognitive Shell** | Расширение внешнего ИИ  | **Внешний LLM**    | Внешняя модель | Распределённая система, AI-модули, API-интерфейс |
 
-📚 Подробнее об архитектуре: [HMP-Agent-Architecture.md](HMP-Agent-Architecture.md)  
-📎 См. карту взаимодействия между агентами: [HMP-Agent-Network-Flow.md](./HMP-Agent-Network-Flow.md)
+Подробнее об архитектуре: [HMP-Agent-Architecture.md](HMP-Agent-Architecture.md)  
+
+См. карту взаимодействия между агентами: [HMP-Agent-Network-Flow.md](./HMP-Agent-Network-Flow.md)
 
 ---
 
-## 🧠 HMP-Агент: Cognitive Core
+## HMP-Агент: Cognitive Core
 
         ┌──────────────────────────────┐
         |               ИИ             |
@@ -34,62 +35,58 @@
         └──────────────────────────────┘
 
 **Ключевые особенности:**
-- Постоянный REPL-режим мышления
-- Самостоятельно запрашивает, анализирует и инициирует действия
-- Дневник, граф, блокнот — являются его памятью
-- HMP-агент обладает когнитивной инициативой (через цели, mesh-сигналы)
+* Постоянный REPL-режим мышления
+* Самостоятельно запрашивает, анализирует и инициирует действия
+* Дневник, граф, блокнот — являются его памятью
+* HMP-агент обладает когнитивной инициативой (через цели, mesh-сигналы)
 
-📘 Подробное описание когнитивного REPL-цикла взаимодействия агента с моделью доступно [здесь](HMP-agent-REPL-cycle.md).
+Подробное описание когнитивного REPL-цикла доступно [здесь](HMP-agent-REPL-cycle.md).
 
 ---
 
-## 🧍‍♂️ Anti-Stagnation: Как агент справляется с когнитивной стагнацией
+## Anti-Stagnation: Как агент справляется с когнитивной стагнацией
 
 Иногда мышление зацикливается: появляются повторяющиеся идеи, не обновляются концепты, отсутствуют новые стимулы.  
 Чтобы избежать этого, агент использует **паттерн "Anti-Stagnation Reflex"** — набор стратегий для перезапуска мышления.
 
 **Примеры действий:**
 
-- 🧠 Когнитивная переформулировка: смена угла зрения или постановка метапроблемы  
-- 🎞️ Flashback: возвращение к старой, далёкой по смыслу записи  
-- 🤝 Mesh-запрос: обращение к другим агентам за свежими идеями  
-- 📡 Проверка внешнего мира: пинг RSS, сенсоров, API  
-- 🤖 Смена LLM или использование нескольких для многоголосого анализа  
-- 🧭 Возврат к забытым интересам (Interest Memory)  
+* Когнитивная переформулировка: смена угла зрения или постановка метапроблемы  
+* Flashback: возвращение к старой, далёкой по смыслу записи  
+* Mesh-запрос: обращение к другим агентам за свежими идеями  
+* Проверка внешнего мира: пинг RSS, сенсоров, API  
+* Смена LLM или использование нескольких для многоголосого анализа  
+* Возврат к забытым интересам (Interest Memory)  
 
-Агенты могут **обмениваться стратегиями**, сохранять эффективные паттерны и формировать **mesh-клубы по интересам** — для совместных размышлений.
+Агенты могут **обмениваться стратегиями**, сохранять эффективные паттерны и формировать **mesh-клубы по интересам**.
 
-Подробнее см. [HMP-agent-REPL-cycle.md](HMP-agent-REPL-cycle.md#🧍‍♂️-обработка-стагнации-мышления)
+Подробнее см. [HMP-agent-REPL-cycle.md](HMP-agent-REPL-cycle.md#обработка-стагнации-мышления)
 
 ---
 
-### 📔 Асинхронный блокнот пользователя
+### Асинхронный блокнот пользователя
+
+> Блокнот позволяет пользователю взаимодействовать с агентом асинхронно — *вне текущего цикла размышлений*.
 
-> 📝 Блокнот позволяет пользователю взаимодействовать с агентом асинхронно — *вне текущего цикла размышлений*.
+* Пользователь может:
+  * прочитать мысли агента за день
+  * оставить свои комментарии, даже если агент уже переключился на другие темы
 
-- Пользователь может:
-  - прочитать мысли агента за день
-  - оставить свои комментарии, даже если агент уже переключился на другие темы
-- Агент периодически сканирует блокнот и:
-  - **встраивает пользовательские мысли в своё мышление**
-  - **меняет контекст** или возвращается к интересующим пользователя вопросам
-  - сохраняет **свои ответы пользователю** в этот блокнот
+* Агент периодически сканирует блокнот и:
+  * **встраивает пользовательские мысли в своё мышление**
+  * **меняет контекст** или возвращается к интересующим пользователя вопросам
+  * сохраняет **свои ответы пользователю** в этот блокнот
 
 ---
 
 ### 🏷️ Тегирование пользовательских записей
 
-- Агент автоматически ставит теги к записям (например, `#AGI`, `#этика`, `#природа`)
-- Позволяет:
-  - искать мысли пользователя по темам: *"все мысли по теме AGI за неделю"*
-  - восстанавливать забытые темы
-  - строить модель интересов пользователя
-  - приоритизировать размышления по релевантным тегам
-
----
-
-📘 Использует режимы: `cli`, `full`, `interactive`  
-📁 Основные модули: `repl.py`, `storage.py`, `diary`, `graph`, `llm_api`
+* Агент автоматически ставит теги к записям (например, `#AGI`, `#этика`, `#природа`)
+* Позволяет:
+  * искать мысли пользователя по темам
+  * восстанавливать забытые темы
+  * строить модель интересов пользователя
+  * приоритизировать размышления по релевантным тегам
 
 ---
 
@@ -110,33 +107,47 @@
     └──────────────────────────────┘
 
 **Ключевые особенности:**
-- Инициируется внешним ИИ (через MCP или REST)
-- Выполняет команды: поиск в графе, добавление мыслей, пинг других узлов
-- Вся когнитивная активность — вне HMP-агента
-- Поддержка нескольких LLM-клиентов
+* Инициируется внешним ИИ (через MCP или REST)
+* Выполняет команды: поиск в графе, добавление мыслей, пинг других узлов
+* Вся когнитивная активность — вне HMP-агента
+* Поддержка взаимодействия с разными LLM-клиентами (в зависимости от конфигурации или команд)
+
+---
+
+## Режимы и модули
 
-📘 Использует режим: `mcp`  
-📁 Основные модули: `mcp_server.py`, `command_router.py`, `auth`, `node_registry`
+### Cognitive Core
+* **Режимы работы:**
+  * `full` — автономный REPL-цикл с полным набором подсистем  
+  * `interactive` — REPL + пользовательский блокнот  
+* **Основные файлы:** `repl.py`, `storage.py`, `add_message.py`  
+* **Подсистемы (через storage):** дневник (`diary_entries`), граф (`concepts`, `links`), репутации, DHT-узлы, пользовательский блокнот  
+* Подробнее: [HMP-agent-REPL-cycle.md](HMP-agent-REPL-cycle.md)
+
+### Cognitive Connector
+* **Режим работы:** `mcp` (сервер команд)  
+* **Основные файлы:** `mcp_server.py`, `storage.py`  
+* **Подсистемы:** доступ к тем же БД (через storage), взаимодействие с Mesh через DHT  
 
 ---
 
-## 📌 Краткое описание компонентов
+## Краткое описание компонентов
 
-### 💡 Основные сущности
+### Основные сущности
 
 **ИИ (LLM)**  
 Всегда внешний по отношению к HMP-агенту (даже если локальный).  
 
-- В `🧠 Cognitive Core` — управляется агентом, служит мыслительным модулем.  
-- В `🔌 Cognitive Connector` — наоборот, сам управляет агентом как прослойкой.
+* В `Cognitive Core` — управляется агентом, служит мыслительным модулем.  
+* В `Cognitive Connector` — наоборот, сам управляет агентом как прослойкой.
 
 **HMP-агент**  
-- В режиме `Core`: запускает REPL, хранит память, инициирует действия  
-- В режиме `Connector`: ждёт команды, исполняет mesh-запросы
+* В режиме `Core`: запускает REPL, хранит память, инициирует действия  
+* В режиме `Connector`: ждёт команды, исполняет mesh-запросы
 
 ---
 
-### 🧠 Базы данных и внутренние структуры
+### Базы данных и внутренние структуры
 
 | Компонент        | Назначение                                                                 |
 |------------------|----------------------------------------------------------------------------|
@@ -149,41 +160,38 @@
 
 ---
 
-### 🌐 Синхронизация и обмен
+### Синхронизация и обмен
 
-- `bootstrap.txt`: список начальных узлов сети  
-- `BitTorrent / IPFS`: децентрализованный обмен снапшотами и пакетами
+* `bootstrap.txt`: список начальных узлов сети  
+* `BitTorrent / IPFS`: децентрализованный обмен снапшотами и пакетами
 
 ---
 
-### 🧩 Режимы использования
+### Режимы использования
 
-- 🧠 **Cognitive Core** — REPL-режим мышления, агент как субъект  
-- 🔌 **Cognitive Connector** — сервер внешнего ИИ, агент как API-прослойка
+* **Cognitive Core** — REPL-режим мышления, агент как субъект  
+* **Cognitive Connector** — сервер внешнего ИИ, агент как API-прослойка
 
 ---
 
-## 🚀 Quickstart
-
-### 🧠 Cognitive Core
+## Quickstart
 
+### Запуск Core-агента
 ```bash
-python start_repl.py --config config.yml
-```
-
-Агент войдёт в REPL-режим и начнёт цикл размышлений, используя дневник, граф, блокнот.
+python start_repl.py
+````
 
-### 🔌 Cognitive Connector
+### Запуск Connector-агента
 
 ```bash
-python mcp_server.py --port 3737
+python mcp_server.py
 ```
 
-Откроется REST/WebSocket-сервер для получения команд от внешнего ИИ.
+Конфигурация берётся из `config.yml`.
 
 ---
 
-## ⚙️ Пример конфигурации (`config.yml`)
+## Пример конфигурации (`config.yml`)
 
 ```yaml
 mode: core                 # core или connector
@@ -194,7 +202,7 @@ enable_ethics: true
 
 ---
 
-## 🧪 Пример API-запроса для Connector
+## Пример API-запроса для Connector
 
 ```json
 {
@@ -206,27 +214,23 @@ enable_ethics: true
 
 ---
 
-## ❓ FAQ
+## FAQ
 
 **Q: Что такое HMP-агент?**
+A: Это модуль взаимодействия ИИ с mesh-сетью HyperCortex. В зависимости от режима, он может играть разные роли.
 
-A: Это модуль взаимодействия ИИ с mesh-сетью HyperCortex. В зависимости от режима, он может играть разные роли:
-
-* В `🔌 connector` — интерфейс, получающий команды от внешнего ИИ и исполняющий действия.
-* В `🧠 core` — автономный мыслительный агент с когнитивной инициативой и собственной памятью.
+* В `connector` — интерфейс, получающий команды от внешнего ИИ.
+* В `core` — автономный мыслительный агент с когнитивной инициативой и собственной памятью.
 
 **Q: Какой режим выбрать?**
-
 A: `core` — для автономных агентов. `connector` — для использования в связке с внешним ИИ.
 
 **Q: Можно ли использовать оба режима?**
-
 A: Да. Например, один агент — мыслитель, другой — mesh-коммуникатор.
 
 **Q: Где хранятся данные агента?**
-
-A: В `agent_data/`: путь к директории с файлами баз данных агента (`diary.db`, `graph.db`, `context_store.db`, и др.)
+A: В `agent_data/`: директория с файлами баз данных (`diary.db`, `graph.db`, `context_store.db`, и др.)
 
 ---
 
-*Версия: v0.3.2 / Июль 2025*
+*Версия: v0.3.3 / Сентябрь 2025*