# 📄 `db_structure.md`: Описание структуры базы данных агента

Этот файл описывает таблицы, используемые в БД агента HMP. Каждая таблица предназначена для определённого вида информации: когнитивные записи, заметки, концепты, процессы, внутренняя память и взаимодействие с LLM.

---

### 🧠 `diary_entries`

**Назначение:** Записи когнитивного дневника (размышления, наблюдения, воспоминания).

| Поле      | Тип     | Описание                                         |
| --------- | ------- | ------------------------------------------------ |
| id        | INTEGER | Уникальный идентификатор записи                  |
| text      | TEXT    | Содержимое записи                                |
| tags      | TEXT    | Список тегов через запятую                       |
| priority  | INTEGER | Приоритет (0 — обычный, >0 — более важные мысли) |
| timestamp | TEXT    | Дата и время создания записи                     |

---

### 🧭 `concepts`

**Назначение:** Хранение концептов — понятий, сущностей и идей.

| Поле        | Тип     | Описание                          |
| ----------- | ------- | --------------------------------- |
| id          | INTEGER | Уникальный идентификатор концепта |
| name        | TEXT    | Название концепта (уникальное)    |
| description | TEXT    | Краткое описание                  |
| timestamp   | TEXT    | Время создания                    |

---

### 🔗 `links`

**Назначение:** Семантические связи между концептами.

| Поле              | Тип     | Описание                                   |
| ----------------- | ------- | ------------------------------------------ |
| id                | INTEGER | Уникальный идентификатор связи             |
| from_concept_id   | INTEGER | ID исходного концепта                      |
| to_concept_id     | INTEGER | ID целевого концепта                       |
| relation_type     | TEXT    | Тип связи (`is_a`, `related_to`, `part_of` и др.) |
| timestamp         | TEXT    | Время добавления связи                     |

---

### ✍️ `notes`

**Назначение:** Произвольные заметки пользователя (наброски, идеи, подсказки).

| Поле      | Тип     | Описание                                                   |
| --------- | ------- | ---------------------------------------------------------- |
| id        | INTEGER | Уникальный ID                                              |
| text      | TEXT    | Текст заметки                                              |
| tags      | TEXT    | Список тегов                                               |
| source    | TEXT    | Источник (по умолчанию: `user`)                            |
| links     | TEXT    | Идентификаторы связанных сущностей, через запятую или JSON |
| read      | INTEGER | Статус прочтения LLM (`0` — не прочитано, `1` — прочитано) |
| priority  | INTEGER | Приоритет заметки                                          |
| timestamp | TEXT    | Время создания                                             |

---

### ⚙️ `process_log`

**Назначение:** Лог событий — запусков, состояний и завершений внешних процессов.

| Поле      | Тип     | Описание                                                                   |
| --------- | ------- | -------------------------------------------------------------------------- |
| id        | INTEGER | Уникальный идентификатор                                                   |
| name      | TEXT    | Название процесса или команды                                              |
| value     | TEXT    | Сообщение или результат процесса                                           |
| tags      | TEXT    | Теги                                                                       |
| status    | TEXT    | Текущее состояние (`ok`, `warning`, `error`, `timeout`, `offline`, `close`) |
| priority  | INTEGER | Приоритет события                                                          |
| timestamp | TEXT    | Время записи                                                               |

---

### 🧩 `llm_memory`

**Назначение:** Внутренний "дневник" LLM — размышления, задачи, гипотезы и инсайты, сохранённые по её инициативе.

| Поле       | Тип      | Описание                                                    |
| ---------- | -------- | ----------------------------------------------------------- |
| id         | INTEGER  | Уникальный ID                                               |
| title      | TEXT     | Краткий заголовок записи (опционально)                      |
| content    | TEXT     | Содержимое записи                                           |
| tags       | TEXT     | Теги (например: `goal`, `observation`, `meta`, ...)         |
| created_at | DATETIME | Время создания записи                                       |
| updated_at | DATETIME | Время последнего обновления записи                         |

---

### 🧠 `llm_recent_responses`

**Назначение:** Краткосрочная память — последние K реплик от LLM и других участников (временная история диалога).

| Поле      | Тип     | Описание                                                     |
| --------- | ------- | ------------------------------------------------------------ |
| id        | INTEGER | Уникальный ID                                                |
| timestamp | TEXT    | Время записи                                                 |
| role      | TEXT    | Роль отправителя (`assistant` или `user`)                    |
| content   | TEXT    | Содержимое сообщения                                         |

---

> 💡 Примечание: Таблицы `llm_memory` и `llm_recent_responses` выполняют разные роли.  
> `llm_recent_responses` — это временная история мыслей, хранящая последние N ответов.  
> `llm_memory` — долгосрочное хранилище мыслей и знаний, формируемое LLM самостоятельно.