feat: formalize comms-agent and initialize agent_registry (F2-1)

- Populated agents/REGISTRY.md with 8 planned agents
- Created first agent charter: CHARTER-comms-agent.md (Telegram Bot)
- Added SQL init script for agent_registry table in PG (CT 151)
- Registered comms-agent as 'active' in the database
This commit is contained in:
root committed 2026-10-07 12:38:50 +03:00
1 parent eee86a73e5
commit 15b79e0b5b
3 files changed
+52 -1

No files matched your search

+23
View File
@@ -0,0 +1,23 @@
# Хартия агента: comms-agent
## 1. Миссия
Обеспечение надежного, защищенного канала коммуникации между инфраструктурой и администратором.
## 2. Подконтрольные сервисы
- Telegram Admin Bot (развернут на VPS `direct-emerald`, порт 1080 SOCKS5 proxy).
- Matrix mautrix-telegram bridge (CT 155).
## 3. Allowlist (Разрешенные действия)
- ✅ Чтение таблицы `host_states` из PostgreSQL (CT 151).
- ✅ Чтение открытых задач (issues) из Gitea API (CT 140).
- ✅ Отправка уведомлений и ответов на команды `/start`, `/status`, `/issues` в Telegram.
- ✅ Регистрация heartbeat в таблице `agent_registry` каждые 30 секунд.
## 4. Запрещено (Denylist)
- ❌ Любые изменения конфигурационных файлов (.env, compose.yml).
- ❌ Удаление или модификация записей в базах данных.
- ❌ Выполнение команд на хостах или в контейнерах (только чтение статуса).
- ❌ Обработка команд от пользователей, чей ID не равен `ADMIN_ID`.
## 5. Эскалация
При невозможности подключиться к PG или Gitea в течение 3 минут → отправка алерта `sev:2` владельцу.
+14 -1
View File
@@ -1 +1,14 @@
# Agent Registry
# Реестр агентов (Agent Registry)
| Агент | Домен | Сервисы | Статус | Heartbeat (PG) |
|---|---|---|---|---|
| `comms-agent` | Коммуникации | Telegram Admin Bot, Matrix Bridge | 🟢 Active | `SELECT * FROM agent_registry WHERE name='comms-agent'` |
| `automation-agent` | Оркестрация | n8n, Swarm, Remediation API | 🟡 Pending | - |
| `data-agent` | Данные | PostgreSQL, Duplicati | 🟡 Pending | - |
| `edge-agent` | Сеть | Nginx, VPS Proxy, Headscale | 🟡 Pending | - |
| `identity-agent` | Доступы | Authentik, Vaultwarden | 🟡 Pending | - |
| `obs-agent` | Наблюдаемость | Uptime Kuma, Grafana/Loki | 🟡 Pending | - |
| `knowledge-agent` | Знания | Gitea | 🟡 Pending | - |
| `auditor-agent` | Мета-аудит | Все системы (read-only) | 🟡 Pending | - |
*Обновлено: 2026-10-07*