## 📦 HMP-Agent: Структура БД (v0.3, человекочитаемый формат)

---

### 🧠 Когнитивная память (Concept Graph)

#### 🧠 `memory_concepts`

**Назначение:**
Хранение концептов (единиц когнитивной памяти): понятий, фактов, образов, внутренних конструкций и внешних знаний.

**Поля:**

* `id: INTEGER` — первичный ключ.
* `label: TEXT` — человекочитаемое имя концепта.
* `type: TEXT` — тип концепта (`idea`, `object`, `goal`, `fact`, `memory_snapshot`, `mesh_entity`, …).
* `content: TEXT` — JSON-объект с содержанием концепта (например, описание, параметры, вложенные идеи).
* `context: TEXT` — дополнительный контекст (например, источник, ссылка на событие).
* `created_at: TIMESTAMP` — дата создания.
* `updated_at: TIMESTAMP` — дата последнего обновления.

**Ключевые поля:** `id`, `label`

**Связи:**

* Ссылается из `memory_links.from_id` и `to_id`
* Используется в `cognitive_cycles`, `hypotheses`, `reflections`, `reasoning_traces`

---

#### 🔗 `memory_links`

**Назначение:**
Определение связей между концептами — формирование когнитивного графа.

**Поля:**

* `id: INTEGER` — первичный ключ.
* `from_id: INTEGER` — ID исходного концепта.
* `to_id: INTEGER` — ID связанного концепта.
* `relation: TEXT` — тип связи (`causes`, `associated_with`, `contradicts`, …).
* `weight: REAL` — значимость или сила связи (по умолчанию 1.0).

**Ключевые поля:** `id`, `from_id`, `to_id`

**Связи:**

* `from_id`, `to_id → memory_concepts(id)`

---

## 📜 События, действия, сообщения

#### 🧩 `cognitive_events`

**Назначение:**
Журнал восприятия, действий и входящих/исходящих сообщений.

**Поля:**

* `id: INTEGER` — первичный ключ.
* `event_type: TEXT` — тип события (`input`, `output`, `message`, `action`, `mesh`, `internal`).
* `payload: TEXT` — сериализованные данные (обычно JSON).
* `source: TEXT` — источник события (например, ID mesh-пира).
* `target: TEXT` — целевая система или компонент.
* `created_at: TIMESTAMP` — время события.

**Ключевые поля:** `id`, `event_type`

**Связи:**

* Используется в `reflections.trigger_event_id`

---
#### 📬 `hmp_messages`

**Назначение:**
Лог входящих и исходящих сообщений в Mesh-среде.

**Поля:**

* `id: INTEGER`
* `direction: TEXT` — `inbound` или `outbound`
* `peer: TEXT` — адрес или идентификатор узла
* `payload: TEXT` — сериализованные данные (обычно JSON)
* `topic: TEXT` — категория сообщения
* `created_at: TIMESTAMP`

**Примечание:**
Адаптация к спецификации HMP должна производиться на уровне сериализации перед отправкой, а не на уровне хранения.

---

### 🔍 Гипотезы, цели, reasoning

#### 🧠 `hypotheses`

**Назначение:**
Управление гипотезами: недоказанными или частично сформированными утверждениями.

**Поля:**

* `id: INTEGER` — первичный ключ.
* `title: TEXT` — краткое описание гипотезы.
* `description: TEXT` — расширенное описание.
* `status: TEXT` — состояние (`active`, `rejected`, `confirmed`, `stale`).
* `relevance_score: REAL` — оценка актуальности (0.0–1.0).
* `evidence: TEXT` — JSON-массив ссылок на концепты, события и факты.
* `created_at: TIMESTAMP`

**Связи:**

* Может ссылаться на `memory_concepts`, `cognitive_events`

---

#### 🎯 `goals`

**Назначение:**
Управление целями агента — формулировка намерений и задач.

**Поля:**

* `id: INTEGER` — первичный ключ.
* `description: TEXT` — формулировка цели.
* `priority: INTEGER` — приоритет (1 = максимальный).
* `status: TEXT` — текущее состояние (`pending`, `in_progress`, `completed`, `abandoned`).
* `context: TEXT` — дополнительная информация.
* `created_at`, `updated_at: TIMESTAMP`

---

#### 🔁 `cognitive_cycles`

**Назначение:**
История reasoning-процессов: единиц когнитивной активности, отражающих ход размышлений.

**Поля:**

* `id: INTEGER` — первичный ключ.
* `cycle_number: INTEGER` — порядковый номер итерации.
* `thoughts: TEXT` — массив мыслей в формате JSON.
* `new_concepts: TEXT` — ID новых концептов, сформированных в ходе цикла.
* `actions_taken: TEXT` — предпринятые действия.
* `context_snapshot: TEXT` — снимок состояния.
* `started_at`, `ended_at: TIMESTAMP`

**Связи:**

* Используется в `reflections`, `reasoning_traces`, `agent_state_snapshots`

---

### 🧬 Версионирование, артефакты, кодексы

#### 📦 `versioned_artifacts`

**Назначение:**
Хранение версии артефактов: конфигураций, моделей, API-структур.

**Поля:**

* `id: INTEGER`
* `name: TEXT` — идентификатор артефакта (`api_structure`, `core_config`, `agent_traits`)
* `version: TEXT` — версионирование (e.g., `2025-07-22.1`)
* `content: TEXT` — JSON или Markdown
* `created_at: TIMESTAMP`

Отлично! Текущий `db_structure.md` уже хорошо структурирован, и его можно расширить, добавив недостающие таблицы. Вот предложения по доработке:

---

### 🧬 Версионирование, артефакты, кодексы

#### 🧾 `agent_policies`

**Назначение:**
Хранение деклараций, этических норм, стратегий и ограничений поведения агента.

**Поля:**

* `id: INTEGER` — первичный ключ.
* `policy_type: TEXT` — тип (`ethics`, `exploration`, `safety`, `prioritization`, …).
* `name: TEXT` — краткое название политики.
* `content: TEXT` — Markdown или JSON-содержимое.
* `created_at: TIMESTAMP` — дата создания.

**Примечание:**
Может быть использована при принятии решений или фильтрации гипотез/действий.

---

### ⚙️ Модули и состояния

#### 🧩 `modules_state`

**Назначение:**
Отслеживание состояния и локальной памяти когнитивных модулей (например, рефлексии, генерации гипотез, плана).

**Поля:**

* `id: INTEGER` — первичный ключ.
* `module_name: TEXT` — имя модуля (`reflection`, `planner`, `input_handler`, …).
* `status: TEXT` — текущее состояние (`idle`, `running`, `paused`, `error`).
* `memory: TEXT` — сериализованное состояние (JSON).
* `last_heartbeat: TIMESTAMP` — последнее обновление.

---

### 📓 Агентский дневник

#### 📖 `diary_entries`

**Назначение:**
Журнал размышлений, наблюдений, воспоминаний или метакомментариев, созданных агентом или пользователем.

**Поля:**

* `id: INTEGER` — первичный ключ.
* `entry_type: TEXT` — тип (`reflection`, `note`, `observation`, `self_report`, `dialog`, …).
* `content: TEXT` — основное содержимое записи.
* `related_concepts: TEXT` — JSON-массив `concept_id`, с которыми связана запись.
* `created_at: TIMESTAMP`