From 43502690c9240fcaa3577c3e95fb148f18136253 Mon Sep 17 00:00:00 2001 From: buryan-agent Date: Wed, 21 Oct 2026 13:18:18 +0300 Subject: [PATCH] =?UTF-8?q?=D0=9F=D0=BE=D0=BB=D0=B8=D1=82=D0=B8=D0=BA?= =?UTF-8?q?=D0=B0:=20=D0=BF=D0=B5=D1=80=D0=B5=D0=B7=D0=B0=D0=BF=D1=83?= =?UTF-8?q?=D1=81=D0=BA=20=E2=80=94=20=D0=BA=D0=BB=D0=B0=D1=81=D1=81=20C?= =?UTF-8?q?=20=D1=81=20=D0=BF=D0=BE=D0=B4=D1=82=D0=B2=D0=B5=D1=80=D0=B6?= =?UTF-8?q?=D0=B4=D0=B5=D0=BD=D0=B8=D0=B5=D0=BC;=20=D0=B7=D0=B0=D1=8F?= =?UTF-8?q?=D0=B2=D0=BA=D0=B8=20=D0=B2=20Matrix?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Перезапуск контейнера отнесён к классу C (влияет на сервис) — агент только предлагает, владелец подтверждает. Добавлена очередь заявок /opt/hub-agents/approvals.json и команды бота: !заявки, !одобрить N, !отклонить N. Исполняются только разрешённые действия (restart_container). Дорожная карта переставлена: сначала скелет и структура сервисов, работа (ВКС/Presale) — после стабилизации. Wiki обновлена. --- ops/agents/approvals.py | 158 ++++++++++++++++++++++++++++++++++++++++ ops/agents/policy.yaml | 39 +++++++--- ops/wiki/build_wiki.py | 23 +++--- 3 files changed, 199 insertions(+), 21 deletions(-) create mode 100644 ops/agents/approvals.py diff --git a/ops/agents/approvals.py b/ops/agents/approvals.py new file mode 100644 index 0000000..4023363 --- /dev/null +++ b/ops/agents/approvals.py @@ -0,0 +1,158 @@ +#!/usr/bin/env python3 +"""Очередь заявок класса C: агент предлагает — владелец одобряет. + +Использование: + approvals.py list — показать ожидающие + approvals.py approve — выполнить (только из actions_allowed) + approvals.py reject — отклонить +""" +import json +import os +import subprocess +import sys +from datetime import datetime + +QUEUE = "/var/lib/hub-agents/approvals.json" +JOURNAL = "/var/lib/hub-agents/journal" +ALLOWED = {"restart_container"} + + +def load(): + try: + return json.load(open(QUEUE, encoding="utf-8")) + except Exception: + return [] + + +def save(items): + os.makedirs(os.path.dirname(QUEUE), exist_ok=True) + json.dump(items, open(QUEUE, "w", encoding="utf-8"), ensure_ascii=False, indent=1) + + +def next_id(items): + return (max([i.get("id", 0) for i in items] or [0]) + 1) + + +def add(proposals, agent): + """Добавляет предложения агента в очередь (без дублей).""" + items = load() + added = [] + for p in proposals: + if (p.get("class") or "").upper() != "C": + continue + action = p.get("action") + target = p.get("target") + if not action or not target: + continue + dup = [i for i in items if i.get("action") == action + and i.get("target") == target and i.get("status") == "pending"] + if dup: + continue + item = { + "id": next_id(items), + "agent": agent, + "action": action, + "target": target, + "why": p.get("why", ""), + "status": "pending", + "created": datetime.now().isoformat(timespec="seconds"), + } + items.append(item) + added.append(item) + save(items) + return added + + +def find(items, ident): + for i in items: + if str(i.get("id")) == str(ident): + return i + return None + + +def log(entry): + os.makedirs(JOURNAL, exist_ok=True) + path = os.path.join(JOURNAL, datetime.now().strftime("%Y-%m-%d") + "-approvals.jsonl") + with open(path, "a", encoding="utf-8") as f: + f.write(json.dumps(entry, ensure_ascii=False) + "\n") + + +def execute(item): + action, target = item.get("action"), item.get("target") + if action not in ALLOWED: + return False, f"действие {action} не разрешено к исполнению" + # ищем контейнер: сначала на хосте, потом по CT + try: + r = subprocess.run(["docker", "restart", target], capture_output=True, + text=True, timeout=90) + if r.returncode == 0: + return True, "перезапущен на хосте" + except Exception: + pass + try: + cts = subprocess.run(["pct", "list"], capture_output=True, text=True, timeout=20).stdout + for line in cts.splitlines()[1:]: + parts = line.split() + if len(parts) < 3: + continue + ct = parts[0] + names = subprocess.run(["pct", "exec", ct, "--", "docker", "ps", + "--format", "{{.Names}}"], + capture_output=True, text=True, timeout=15).stdout + if target in names.split(): + r = subprocess.run(["pct", "exec", ct, "--", "docker", "restart", target], + capture_output=True, text=True, timeout=120) + return (r.returncode == 0), f"перезапущен в CT{ct}" + except Exception as e: + return False, str(e)[:120] + return False, "контейнер не найден" + + +def cmd_list(): + items = [i for i in load() if i.get("status") == "pending"] + if not items: + print("заявок нет") + return + for i in items: + print(f"#{i['id']} [{i['agent']}] {i['action']} {i['target']} — {i.get('why', '')[:90]}") + + +def cmd_approve(ident): + items = load() + item = find(items, ident) + if not item or item.get("status") != "pending": + print("заявка не найдена или уже обработана") + return + ok, detail = execute(item) + item["status"] = "done" if ok else "failed" + item["result"] = detail + item["decided"] = datetime.now().isoformat(timespec="seconds") + save(items) + log(item) + print(("✅ " if ok else "❌ ") + f"#{item['id']} {item['action']} {item['target']}: {detail}") + + +def cmd_reject(ident): + items = load() + item = find(items, ident) + if not item or item.get("status") != "pending": + print("заявка не найдена") + return + item["status"] = "rejected" + item["decided"] = datetime.now().isoformat(timespec="seconds") + save(items) + log(item) + print(f"отклонено #{item['id']}") + + +if __name__ == "__main__": + if len(sys.argv) < 2: + cmd_list() + elif sys.argv[1] == "list": + cmd_list() + elif sys.argv[1] == "approve" and len(sys.argv) > 2: + cmd_approve(sys.argv[2]) + elif sys.argv[1] == "reject" and len(sys.argv) > 2: + cmd_reject(sys.argv[2]) + else: + print(__doc__) diff --git a/ops/agents/policy.yaml b/ops/agents/policy.yaml index cfc55d8..5b77ca0 100644 --- a/ops/agents/policy.yaml +++ b/ops/agents/policy.yaml @@ -1,32 +1,46 @@ -version: 1 +version: 2 # Политика действий агентов. +# A — только чтение и метрики (сам) +# B — гигиена без влияния на доступность (сам, с записью) +# C — влияет на сервис → ТОЛЬКО с подтверждением владельца +# D — запрещено classes: A: - title: Безопасное + title: Наблюдение auto: true - examples: [restart_container, cleanup_logs, health_check, vacuum_journal] + examples: [health_check, collect_metrics, journal_write, status_probe] limits: - actions_per_hour: 10 - actions_per_day: 50 + actions_per_hour: 60 + affects_service: false B: - title: Заметное + title: Гигиена auto: true notify: journal - examples: [update_container, rotate_logs, reindex_library, refresh_cache] + examples: [rotate_logs, vacuum_journal, clear_cache, trim_tmp] limits: - actions_per_hour: 3 - actions_per_day: 10 + actions_per_hour: 4 + actions_per_day: 12 + affects_service: false C: - title: Рискованное + title: Влияет на сервис auto: false approval: matrix_owner - examples: [change_config, migrate_data, delete_service, change_dns] + examples: [restart_container, update_container, change_config, migrate_data, + delete_service, change_dns, reindex_library] + note: "Любое действие, после которого сервис может стать недоступен" D: title: Запрещено auto: false approval: never - examples: [delete_backup, read_secrets, change_router_config, disable_2fa] + examples: [delete_backup, read_secrets, disable_2fa, change_router_config, + drop_database] + +approvals: + channel: matrix + ttl_hours: 24 + queue: /var/lib/hub-agents/approvals.json + actions_allowed: [restart_container] notifications: owner: @@ -40,6 +54,7 @@ notifications: journal: /var/lib/hub-agents/journal safety: + observe_mode: true dry_run_first_days: 14 snapshot_before_change: true auto_rollback_if_unhealthy: true diff --git a/ops/wiki/build_wiki.py b/ops/wiki/build_wiki.py index 9844dc0..478250b 100644 --- a/ops/wiki/build_wiki.py +++ b/ops/wiki/build_wiki.py @@ -180,15 +180,20 @@ def page_roadmap(): | Фаза | Статус | Результат | |---|---|---| -| 0. Скелет | ✅ сделано | реестр, Wiki, статус-страница, сверка с аудитом | -| 1. Агенты-наблюдатели | 🔄 в работе | 6 агентов «читать и предлагать», журнал | -| 2. Автономия A | ⏳ | перезапуск, чистка, health | -| 3. Автономия B | ⏳ | обновления, ротация | -| 4. Класс C + Голова | ⏳ | подтверждения, сводки | -| 5. Быт | ⏳ | Grocy, Vikunja, Actual, Mealie | -| 6. Работа | ⏳ | Presale Cockpit | -| 7. Интеллект | ⏳ | RAG, CLIP, MCP | -| 8. Устойчивость | ⏳ | учения, резервный канал, UPS | +| 0. Скелет | ✅ | реестр, Wiki, статус-страница, сверка с аудитом | +| 1. Структура сервисов | 🔄 сейчас | карточки на все сервисы, группы, связи | +| 2. Агенты + заявки C | 🔄 сейчас | 6 секретарей, DeepSeek, подтверждения в Matrix | +| 3. Гигиена B | ⏳ | логи, кэш, ротация — без влияния на доступность | +| 4. Дом и быт | ⏳ | сценарии HA, Grocy, Vikunja, бюджет | +| 5. Контент и интеллект | ⏳ | RAG, CLIP, рекомендации, аудиокниги | +| 6. Работа (Presale) | ⏳ позже | после полной структуры сервисов | +| 7. Устойчивость | ⏳ | учения, резервный канал, UPS | + +## Правило порядка + +Сначала **скелет и структура**: реестр, карточки, связи, агенты. +Работа (ВКС/Presale) — после того, как сервисы и процессы стабильны. +Никаких новых сервисов, пока нет карточки, бэкапа и мониторинга. Подробно — `ops/audit/AUDIT-2026-10-21-VISION.md`. """