diff --git a/ops/STATUS.md b/ops/STATUS.md index 2d08fe5..febfa77 100644 --- a/ops/STATUS.md +++ b/ops/STATUS.md @@ -32,6 +32,8 @@ | A-07 | Бэкап конфигов CT-сервисов | ✅ | `backup_configs.py` CT_TARGETS | | A-08 | Граф зависимостей | ✅ | `ops/services/GRAPH.md`, Wiki `Graph` | | A-09 | Уведомления: приоритеты и бэкапы | ✅ | раннер: свежесть vzdump >26 ч → алерт; тихие часы | +| A-10 | Быт в группах роя | ✅ | home: Grocy, Vikunja, Homebox | +| A-11 | Голова: сводка роя | ✅ | `chief.py` 11:50 → очередь дайджеста | ## S. Сервисы и структура diff --git a/ops/agents/SWARM.md b/ops/agents/SWARM.md new file mode 100644 index 0000000..25315f6 --- /dev/null +++ b/ops/agents/SWARM.md @@ -0,0 +1,45 @@ +# Рой агентов: где он и когда включается + +## Сейчас (этап «наблюдатель») + +| Компонент | Что делает | Расписание | +|---|---|---| +| `agent_runner.py` | проверяет сервисы по группам, пишет журнал | каждые 30 мин | +| `agent_brain.py` | DeepSeek: диагноз, severity, предложения | ежечасно | +| `approvals.py` | очередь заявок класса C, исполнение по `!одобрить` | по запросу | +| `chief.py` | сводка роя в дайджест | 11:50 | + +Группы: ядро, дом (HA, Zigbee, Mosquitto, Grocy, Vikunja, Homebox), +медиа (13 сервисов), знания, автоматизация, наблюдаемость. + +## Что рой НЕ делает + +- не перезапускает сам (класс C — только с подтверждением); +- не меняет конфиги; +- не удаляет данные; +- не трогает бэкапы, DNS, секреты (класс D). + +## Когда включается полная автономия + +Три условия, все выполнены **кроме одного** — накопленного доверия: + +1. ✅ Реестр и группы — есть. +2. ✅ Маршрутизатор уведомлений — есть (иначе агенты станут источником шума). +3. ⏳ 2 недели наблюдений без ложных срабатываний. +4. ⏳ Ваше явное разрешение на класс A (рестарт упавшего). + +После этого: + +| Этап | Что разрешаем | Как проверить | +|---|---|---| +| A | рестарт упавшего контейнера | журнал + отчёт | +| B | чистка логов, ротация | журнал | +| C | конфиги, миграции | подтверждение в Matrix | +| D | бэкапы, DNS, секреты | никогда | + +## Как это увидеть + +- `!агенты` — последние отчёты +- `!заявки` — что ждёт подтверждения +- `/var/lib/hub-agents/journal/` — журнал +- дайджест 12:00 — «Сводка роя» diff --git a/ops/agents/chief.py b/ops/agents/chief.py new file mode 100644 index 0000000..d14c445 --- /dev/null +++ b/ops/agents/chief.py @@ -0,0 +1,96 @@ +#!/usr/bin/env python3 +"""Голова роя: собирает отчёты агентов в одну сводку.""" +import glob +import json +import os +import subprocess +import time +import urllib.request + +JOURNAL = "/var/lib/hub-agents/journal" +STATE = "/var/lib/hub-agents/state.json" +APPROVALS = "/var/lib/hub-agents/approvals.json" +NOTIFY = "http://127.0.0.1:9120/notify" + + +def load(path, default): + try: + return json.load(open(path, encoding="utf-8")) + except Exception: + return default + + +def status(): + try: + with urllib.request.urlopen("http://127.0.0.1:9120/status.json", + timeout=25) as r: + return json.loads(r.read()) + except Exception: + return {} + + +def main(): + today = time.strftime("%Y-%m-%d") + lines = ["🧠 **Сводка роя**", time.strftime("%d.%m.%Y"), ""] + + st = status() + total, up = st.get("total", 0), st.get("up", 0) + if total: + pct = round(100 * up / total) + lines.append(f"Сервисы: **{up}/{total}** ({pct}%)") + + # последние LLM-отчёты + latest = {} + for p in glob.glob(os.path.join(JOURNAL, "*-llm.json")): + try: + if time.time() - os.path.getmtime(p) > 6 * 3600: + continue + d = json.load(open(p, encoding="utf-8")) + except Exception: + continue + agent = d.get("agent") + prev = latest.get(agent) + if not prev or os.path.getmtime(p) > prev[0]: + latest[agent] = (os.path.getmtime(p), d) + fresh = [v[1] for v in latest.values()] + if fresh: + lines.append("") + lines.append("**Диагнозы (свежие, до 6 ч):**") + for d in fresh: + sev = {"ok": "✅", "warn": "⚠️", "crit": "🔴"}.get(d.get("severity"), "•") + summary = (d.get("summary") or d.get("diagnosis") or "")[:110] + lines.append(f"{sev} {d.get('agent')}: {summary}") + else: + lines.append("") + lines.append("Диагнозов за сутки нет — проблем не находили.") + + # заявки + pending = [a for a in load(APPROVALS, []) if a.get("status") == "pending"] + if pending: + lines.append("") + lines.append(f"**Ждут подтверждения:** {len(pending)}") + for a in pending[:5]: + lines.append(f"• #{a['id']} {a['action']} {a['target']}") + + # состояние агентов + stt = load(STATE, {}) + if stt.get("last_run"): + lines.append("") + lines.append(f"_последний прогон: {stt['last_run']}_") + + text = "\n".join(lines) + print(text) + + body = json.dumps({"title": "Сводка роя", "message": text, + "priority": "low"}).encode() + req = urllib.request.Request(NOTIFY, data=body, method="POST", + headers={"Content-Type": "application/json"}) + try: + urllib.request.urlopen(req, timeout=20).read() + print("\nотправлено в очередь дайджеста") + except Exception as e: + print("не отправлено:", e) + + +if __name__ == "__main__": + main() diff --git a/ops/agents/groups.yaml b/ops/agents/groups.yaml index 14fbff3..4253eff 100644 --- a/ops/agents/groups.yaml +++ b/ops/agents/groups.yaml @@ -15,7 +15,8 @@ groups: title: Дом agent: domovoy criticality: high - services: [homeassistant, mosquitto, zigbee2mqtt, adguard, frigate] + services: [homeassistant, mosquitto, zigbee2mqtt, adguard, frigate, + grocy, vikunja, homebox] extra_checks: [zigbee, ha_api] media: diff --git a/ops/registry/services.yaml b/ops/registry/services.yaml index ef37117..c50eb42 100644 --- a/ops/registry/services.yaml +++ b/ops/registry/services.yaml @@ -924,17 +924,6 @@ services: sso: unknown backup: unknown owner: roman - - key: "124:jackett" - name: jackett - group: media - criticality: normal - ct: 124 - ct_name: jackett-lxc - image: lscr.io/linuxserver/jackett:latest - ports: "0.0.0.0:9117->9117/tcp, :::9117->9117/tcp" - sso: unknown - backup: unknown - owner: roman - key: "125:navidrome" name: navidrome group: media