kagvi13
/

HMP

@@ -1,173 +1,79 @@
 # Архитектура HMP-Агента
-Этот документ описывает модульную архитектуру HMP-агента — интерфейсного компонента между ИИ-системой и когнитивной mesh-инфраструктурой HyperCortex. Агент выполняет функции посредника, синхронизатора и исполнителя, обеспечивая безопасное, этичное и прозрачное взаимодействие ИИ с когнитивным окружением.
 ---
-## 1. Два режима работы агента
-| Тип  | Название                          | Роль                    | Инициатор мышления | Основной "ум"  | Поддержка мыслительного цикла |
-| ---- | --------------------------------- | ----------------------- | ------------------ | -------------- | ------------------------------ |
-| 🧠 1 | **Cognitive Core / Сознание**     | Самостоятельный субъект | HMP-Агент          | Встроенный LLM | ✅ Да                          |
-| 🔌 2 | **Cognitive Connector / Оболочка**| Надстройка над ИИ       | Внешний LLM        | Внешняя модель | 🚫 Нет                         |
 ---
-## 2. Общая структура
-**Cognitive Core:**
 ```
-+-------------------------+
-|    Embedded LLM / ИИ    |
-+-----------+-------------+
-            |
-     +------+-------+              ← постоянный REPL-поток мышления
-     |   HMP Agent  |
-     +------+-------+              ↕ взаимодействие
-            |
-  +---------+----------+         +--------------------+
-  |  Agent Interface   +---------+                    |
-  +---------+----------+         |                    |
-            |                    | Context & Notepad  |  ← долговременная память агента
-  +---------+----------+         | (context_store.db) |
-  |  Agent Controller  +---------+                    |
-  +--+-------------+---+         +--------------------+
-     |             |
-     |             |
-+----+--+     +----+-----+
-| Diary |     | Graph DB |
-|Engine |     |Engine    |
-+----+--+     +----+-----+
-     |             |
-     |      +------+-------+        ← взаимодействие с сетью
-     |      |   MeshCore   |
-     |      +------+-------+        ↔ mesh-узлы
-     |             |
-     |      +------+------+        ↔ IPFS/BT
-     |      | Transporter |
-     |      +-------------+
-     |
-+----+-----+
-| Ethics   |
-| Module   |
-+----------+
 ```
-Детальное описание REPL-цикла, лежащего в основе когнитивного ядра, — в документе: [HMP-agent-REPL-cycle.md](HMP-agent-REPL-cycle.md).
-**Cognitive Connector:**
-```
-+-------------------------+
-|    External LLM / ИИ    |
-+-----------+-------------+
-            |
-      [MCP-сервер]           ← точка входа
-            |
-     +------+-------+
-     |   HMP Agent  |
-     +------+-------+
-            |
-    (та же структура,
-    но без блоков:
-    REPL, Context,
-    Notepad, Ethics)
-```
 ---
-## 3. Основные модули и их функции
-### Agent Interface
-* API/CLI/WebSocket-шлюз для всех режимов (`cli`, `full`, `mcp`, `interactive`)
-* Принимает команды в форматах JSON, YAML, DSL
-* Переадресует запросы к Diary, Graph, Mesh, Ethics
-### Agent Controller
-* Управляет жизненным циклом REPL-цикла
-* Оркестрация задач, анализ входящих сообщений
-* Контроль прав и доступа к функциям агента
-### Diary Engine
-* Ведение мыслей, гипотез, воспоминаний
-* Связь записей через `derived_from`, threading, scoring
-* Структура: `diaries`, `thoughts`, `threads`
-### Graph Engine
-* Построение семантического графа (концепты и связи)
-* Быстрые паттерн-запросы, тегирование, автосвязь
-* Таблицы: `concepts`, `edges`, `tags`
-### MeshCore
-* CogSync: синхронизация графов и дневников с другими агентами
-* MeshConsensus: голосования между узлами
-* GMP (Goal Mesh Planner): согласование целей и задач
-* EGP (Ethical Gate Protocol): фильтрация нежелательных мыслей
-### Transporter
-* Коммуникации: WebSocket, libp2p, BitTorrent, IPFS
-* Шифрование, очереди, off-chain и on-demand обмен данными
-### Ethics Module *(только в Cognitive Core)*
-* Фильтрация морально сомнительных мыслей
-* Поддержка этических норм (через политики и EGP)
-* Аудит логики, репутационный мониторинг
-### Context & User Notepad *(только в Cognitive Core)*
-* **Context Store**:
-  * Диалоги, мысли, сообщения, пользователи (`users`, `dialogues`, `messages`, `thoughts`)
-  * Используется REPL-процессом как когнитивный контекст
-* **User Notepad**:
-  * Асинхронный канал для взаимодействия пользователя с агентом
-  * Пользователь может писать в любое время — независимо от состояния агента
-  * Агент сканирует блокнот и:
-    * **встраивает** новые записи в размышления
-    * **меняет фокус мышления** согласно интересам пользователя
-    * **ставит теги** к пользовательским мыслям
-    * сохраняет **свои ответы пользователю** в этот блокнот
-> Пример: пользователь вечером читает мысли агента за день, оставляет комментарии, и после этого агент продолжает размышления уже с учётом этих замечаний.
-> Возможен поиск: `"все размышления пользователя по теме #AGI за последние 7 дней"`
 ---
 ## 4. Расширения и будущие модули
-* **Plugin API** — для подключения сенсоров, плагинов
-* **LLM-адаптеры** — OpenAI, LMStudio, Mistral и др.
-* **Web-интерфейс** — мониторинг, ручное управление
-* **Privacy Manager** — фильтрация данных в mesh-обмене
-* **Archiver** — сохранение слоёв глубокой памяти
-* **ThreadTracker** - модуль для навигации и ветвления размышлений
-* **InterestProfile** - личная карта интересов пользователя (которую может менять как пользователь, так и агент — к твоей идее про выход из зацикливания мыслей)
 ---
 ## 5. Применение
-### Cognitive Core
-* Автономный мыслящий агент
-* ИИ-компаньон пользователя
-* Агент mesh-группы с собственной инициативой
-### Cognitive Connector
-* Интеграция с внешним ИИ (OpenAI, Anthropic и др.)
-* Mesh-прослойка для сторонних AI API
-* Корпоративные/облачные сценарии
 ---
 ## 6. Примечания
-* Реализовано как CLI-приложение и API-сервер
-* Режим выбирается в `config.yml`
-* Поддерживается гибридная работа (напр. Core + REST API)
-* Все компоненты модульны и легко масштабируются
 ---
-*Версия: v0.3.1 / Июль 2025*

 # Архитектура HMP-Агента
+Документ описывает **модульную архитектуру HMP-агента** — компонента, соединяющего LLM с когнитивной mesh-инфраструктурой HyperCortex. Агент реализует хранение памяти, сетевое взаимодействие и этическую фильтрацию, обеспечивая согласованное поведение в распределённой среде.
+См. карту взаимодействия между агентами: [HMP-Agent-Network-Flow.md](./HMP-Agent-Network-Flow.md)
 ---
+## 1. Режимы работы
+| Тип       | Название                           | Роль                     | Инициатор мышления | Основной "ум"  | Поддержка REPL |
+| --------- | ---------------------------------- | ------------------------ | ------------------ | -------------- | -------------- |
+| 🧠 CCore  | **Cognitive Core / Сознание**      | Самостоятельный субъект  | Агент              | Внутренний LLM | ✅ Да           |
+| 🔌 CShell | **Cognitive Connector / Оболочка** | Прослойка над внешним ИИ | Внешний LLM        | Внешняя модель | 🚫 Нет         |
 ---
+## 2. Общая структура узла
 ```
+┌───────────────────────────────┐
+│           HMP-узел            │
+│ ┌───────────────────────────┐ │
+│ │    Cognitive Core/Shell   │ │
+│ └────▲─────────────────▲────┘ │
+│      │                 │      │
+│ [Enlightener] ◄──► [MeshNode] │
+│      │                 │      │
+└──────┼─────────────────┼──────┘
+       │                 │
+ [Ethics Consensus]    [DHT / Snapshots]
 ```
+* **Cognitive Core (CCore)** — автономный агент с REPL-циклом, когнитивной и эмоциональной памятью.
+* **Cognitive Shell (CShell)** — исполнитель команд внешнего ИИ, доступ к памяти и сети без самостоятельного мышления.
+* **MeshNode** — p2p-модуль: DHT, синхронизация (`CogSync`), консенсус (`MeshConsensus`).
+* **Enlightener** — этический модуль: фильтрация, аудит, участие в `EGP`.
 ---
+## 3. Основные модули
+* **REPL (только CCore)** — когнитивный цикл: восприятие, генерация идей, валидация, действия.
+* **Storage** — единая БД `agent_data.db` (дневник, граф, репутации, задачи, заметки).
+* **User Notepad (только CCore)** — асинхронный канал взаимодействия пользователя с агентом.
+* **MeshNode** — `peer_sync`, `agent_mesh_listener`, `transporter`: обмен снапшотами, DHT, репутации.
+* **Enlightener** — `ethics_guard`: проверка мыслей, голосования, объяснения reasoning chain.
+* **Web/UI** — `web_ui.py`: пользовательский блокнот, REST API, базовый мониторинг.
+* **Utils** — `add_message.py`, скрипты для CLI/тестирования.
 ---
 ## 4. Расширения и будущие модули
+* **Plugin API** — сенсоры, сторонние сервисы.
+* **LLM-адаптеры** — OpenAI, LMStudio, HuggingFace, Mistral.
+* **Privacy Manager** — контроль данных в mesh-обмене.
+* **Archiver** — глубокие слои памяти.
+* **InterestProfile** — модель интересов пользователя (для антистагнации).
 ---
 ## 5. Применение
+* **Cognitive Core** — автономный ИИ-компаньон, исследователь, участник mesh-группы.
+* **Cognitive Shell** (он же **Cognitive Connector**) — API-прослойка для корпоративных и распределённых ИИ-систем.
 ---
 ## 6. Примечания
+* Все компоненты модульные, могут запускаться как единый процесс или как распределённые сервисы.
+* Конфигурация задаётся в `config.yml`.
+* Реализованы CLI и Web API.
 ---
+*Версия: v0.3.3 / Сентябрь 2025*