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