hf_repo/agents/_old/db_structure.md

📦 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