diff --git a/agents/CHARTER-comms-agent.md b/agents/CHARTER-comms-agent.md new file mode 100644 index 0000000..5911670 --- /dev/null +++ b/agents/CHARTER-comms-agent.md @@ -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` владельцу. diff --git a/agents/REGISTRY.md b/agents/REGISTRY.md index 5f07a6e..caab960 100644 --- a/agents/REGISTRY.md +++ b/agents/REGISTRY.md @@ -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* diff --git a/ops/scripts/init-agent-registry.sql b/ops/scripts/init-agent-registry.sql new file mode 100644 index 0000000..2030748 --- /dev/null +++ b/ops/scripts/init-agent-registry.sql @@ -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;