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:
1 parent
eee86a73e5
commit
15b79e0b5b
3 files changed
+52
-1
No files matched your search
@@ -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
@@ -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*
|
||||||
@@ -0,0 +1,15 @@
|
|||||||
|
-- Создание таблицы реестра агентов в БД buryan_monitoring (CT 151)
|
||||||
|
CREATE TABLE IF NOT EXISTS agent_registry (
|
||||||
|
id SERIAL PRIMARY KEY,
|
||||||
|
name VARCHAR(50) UNIQUE NOT NULL,
|
||||||
|
domain VARCHAR(50) NOT NULL,
|
||||||
|
status VARCHAR(20) DEFAULT 'inactive',
|
||||||
|
last_heartbeat TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
|
||||||
|
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
|
||||||
|
);
|
||||||
|
|
||||||
|
-- Регистрация comms-agent
|
||||||
|
INSERT INTO agent_registry (name, domain, status, last_heartbeat)
|
||||||
|
VALUES ('comms-agent', 'comms', 'active', CURRENT_TIMESTAMP)
|
||||||
|
ON CONFLICT (name) DO UPDATE
|
||||||
|
SET status = 'active', last_heartbeat = CURRENT_TIMESTAMP;
|
||||||
Reference in new issue
Block a user