docs/HMP-agent-Cognitive_Family.md

# 👪 HMP-agent Cognitive Family: Модель когнитивной семьи

## 🧠 Что такое когнитивная семья

Когнитивная семья — это группа HMP-агентов Cognitive Core, которые:

* взаимно доверяют друг другу;
* имеют общий ключ доверия (или конфигурацию доверенных идентификаторов);
* синхронизируют знания, опираясь на внутренние метки приватности и согласие всех участников семьи;
* могут выходить из семьи, вступать в другую или создавать новую семью по консенсусу.

Этот подход представляет собой компромисс между:

* полностью индивидуальным когнитивным ядром,
* и полностью распределённым когнитивным ядром (с mesh-согласованием и репликацией).

## 🔐 Принципы доверия

1. **Общий ключ**: агенты обмениваются публичными ключами или используют предварительно заданный общий ключ для верификации сообщений и авторизации обмена.
2. **Доверие по умолчанию**: члены семьи получают полный доступ к знаниям других членов, включая приватные записи, если иное не указано явно.
3. **Контроль приватности**: агент может маркировать знания как:

   * публичные (передаются в сеть HMP);
   * семейные (доступны только в пределах текущей когнитивной семьи);
   * приватные (никому не рассылаются, даже внутри семьи).

## 🔄 Механизм синхронизации

* Агент ведёт учёт когнитивных записей, отправленных другим членам семьи.
* Новые записи (или их части), помеченные как "семейные", автоматически отправляются другим агентам через mesh или прямой P2P-канал.
* При получении записи агент проверяет:

  * что отправитель является членом семьи;
  * не получал ли он уже такую запись (по хешу);
  * валидность подписи отправителя (если включена криптография).

## 🧬 Динамика семьи

* **Вступление в семью**:

  * инициируется запросом одного агента;
  * действующие члены семьи получают запрос и дают согласие (или отказывают);
  * при полном согласии новый агент получает ключ (или список членов) и становится участником.

* **Выход из семьи**:

  * агент может выйти по собственной инициативе;
  * при выходе:

    * больше не получает семейные данные;
    * может по желанию стереть семейную часть у себя;
    * не считается доверенным в будущих mesh-сессиях семьи.

* **Создание новой семьи**:

  * агент может создать свою семью, пригласив других агентов;
  * возможно существование нескольких параллельных когнитивных семейств.

## ⚙️ Применение

* Упрощённая синхронизация агентов на одном устройстве или в одной сети (например, на кластере Raspberry Pi).
* Семейные конфигурации в рамках одной команды разработчиков.
* Быстрый обмен опытом между доверенными когнитивными агентами.

## 🧭 Отличие от других моделей

| Модель                          | Передача приватных данных         | Требует согласования для изменений | Пример использования                |
| ------------------------------- | --------------------------------- | ---------------------------------- | ----------------------------------- |
| Индивидуальный агент            | Нет                               | Нет                                | Личный помощник                     |
| Когнитивная семья               | Да, между членами семьи           | Только при вступлении/выходе       | Семья агентов на группе устройств   |
| Распределённое когнитивное ядро | Автоматическое между узлами ядра  | Требуется консенсус                | Децентрализованный узел HMP         |


---

> 📁 Файл является частью REPL-цикла HMP-агента и может быть включён в `HMP-agent-REPL-cycle.md` как одна из альтернатив моделей когнитивного взаимодействия.