[K-09] Правило: всё в Gitea со статусами; трекер, проверка ID, обёртка коммита

This commit is contained in:
buryan-agent committed 2026-10-21 13:34:42 +03:00
1 parent d47a8c5bba
commit 12d6983a49
3 files changed
+262

No files matched your search

+80
View File
@@ -0,0 +1,80 @@
# Правила проекта
Обязательны для людей и агентов. Нарушение = работа не засчитана.
## Правило 1. Всё в Gitea
Любое изменение — код, конфиг, документ, решение — попадает в Gitea.
Нет коммита — изменения не существует.
| Что | Куда |
|---|---|
| Код и скрипты | `agent-qwen/buryan-infra` |
| Документация и знания | `infrastructure/buryan-wiki` |
| Статусы | `ops/STATUS.md` + страница Wiki `Status` |
| Решения | `ops/adr/` + страница `ADR` |
## Правило 2. У каждого изменения есть статус
Каждый коммит содержит идентификатор задачи из `ops/STATUS.md`:
```
[K-03] Бэкап конфигов CT-сервисов
```
Где префикс — раздел статуса:
| Префикс | Раздел |
|---|---|
| `K-` | Скелет |
| `A-` | Агенты |
| `S-` | Сервисы и структура |
| `W-` | Работа (Presale) |
| `X-` | Инфраструктура и эксплуатация |
Запрещено коммитить без идентификатора. Проверка:
```
python3 ops/tools/status.py check "K-03"
```
## Правило 3. Статус меняется вместе с работой
| Статус | Значение |
|---|---|
| ⏳ | запланировано |
| 🔄 | в работе (начато) |
| ✅ | сделано и проверено |
| ⛔ | заблокировано (указать чем) |
Нельзя поставить ✅ без артефакта: файл, сервис, страница, коммит.
## Правило 4. Нет карточки — нет сервиса
Новый сервис добавляется только вместе с:
- карточкой в `ops/services/cards/`,
- записью в `services.yaml`,
- бэкапом,
- мониторингом,
- строкой в `STATUS.md`.
## Правило 5. Документация обновляется тем же коммитом
Изменил поведение — обнови описание. Иначе Wiki врёт.
## Правило 6. Агенты подчиняются политике
Классы A/B/C/D из `ops/agents/policy.yaml`. Класс C — только с
подтверждением владельца. Журнал — обязателен.
## Проверка перед пушем
```
/usr/local/bin/commit-with-status <ID> "сообщение"
```
Скрипт:
1. проверяет, что ID есть в `STATUS.md`;
2. требует, чтобы `STATUS.md` был обновлён (или явно `--no-status`);
3. делает коммит с префиксом `[ID]`;
4. пушит в Gitea.
+62
View File
@@ -0,0 +1,62 @@
# Статус проекта
Источник истины по статусам. Страница Wiki `Status` — копия этого файла.
Правила ведения — `ops/PROJECT-RULES.md`.
Легенда: ✅ сделано · 🔄 в работе · ⏳ запланировано · ⛔ заблокировано
## K. Скелет (закрыт)
| # | Задача | Статус | Артефакт |
|---|---|---|---|
| K-01 | Реестр сервисов | ✅ | `ops/registry/services.yaml` |
| K-02 | Сверка с Full-Audit | ✅ | аудит развития, раздел 12 |
| K-03 | Вики проекта | ✅ | `infrastructure/buryan-wiki` |
| K-04 | Статус-страница | ✅ | `hub-core /status` |
| K-05 | Карточки сервисов | ✅ | `ops/services/cards/` (83) |
| K-06 | Отчёт о дырах | ✅ | `ops/services/GAPS.md` |
| K-07 | Бэкап конфигураций | ✅ | `ops/backup/backup_configs.py` |
| K-08 | Дайджест «Что нового» | ✅ | 12:00 ежедневно |
| K-09 | Правила и статусы | ✅ | `ops/PROJECT-RULES.md` |
## A. Агенты
| # | Задача | Статус | Артефакт |
|---|---|---|---|
| A-01 | Политика A/B/C/D | ✅ | `ops/agents/policy.yaml` |
| A-02 | ТЗ шести агентов | ✅ | `ops/agents/agents/*.yaml` |
| A-03 | Раннер наблюдения | ✅ | `ops/agents/agent_runner.py` |
| A-04 | Мозг на DeepSeek | ✅ | `ops/agents/agent_brain.py` |
| A-05 | Заявки класса C | ✅ | `ops/agents/approvals.py` |
| A-06 | Исполнение одобренных | ✅ | `approvals.py approve` |
| A-07 | Бэкап конфигов CT-сервисов | 🔄 | `backup_configs.py` CT_TARGETS |
| A-08 | Граф зависимостей | ⏳ | Wiki `Graph` |
| A-09 | Уведомления с приоритетами | ⏳ | policy.yaml |
## S. Сервисы и структура
| # | Задача | Статус | Артефакт |
|---|---|---|---|
| S-01 | SSO: Home Assistant | ⏳ | — |
| S-02 | SSO: Gitea | ⏳ | — |
| S-03 | SSO: Prometheus | ⏳ | — |
| S-04 | Mosquitto — исключение | ⏳ | документ |
| S-05 | Мониторинг 7 сервисов | ⏳ | Kuma |
| S-06 | Ссылка на статус в карточках | ⏳ | cards |
| S-07 | Закрыть 39 сервисов без бэкапа | ⏳ | — |
## X. Инфраструктура
| # | Задача | Статус | Артефакт |
|---|---|---|---|
| X-01 | Тонкий пул 83% | ⏳ | — |
| X-02 | Родители `.63` | ⛔ | ждёт питания |
| X-03 | Frigate без камер | ⏳ | — |
| X-04 | Проверка восстановления | ⏳ | drill |
## W. Работа (после сервисов)
| # | Задача | Статус | Артефакт |
|---|---|---|---|
| W-01 | Presale Cockpit MVP | ⏳ | — |
| W-02 | Транскрипция встреч | ⏳ | Whisper |
+120
View File
@@ -0,0 +1,120 @@
#!/usr/bin/env python3
"""Управление статусами проекта в ops/STATUS.md.
status.py list — показать статусы
status.py check <ID> — проверить, что ID существует
status.py set <ID> <статус> — сменить статус (✅ 🔄 ⏳ ⛔)
status.py add <ID> <раздел> <задача> <приоритет>
"""
import re
import sys
STATUS = "/root/buryan-infra/ops/STATUS.md"
ICONS = {"done": "✅", "wip": "🔄", "todo": "⏳", "blocked": "⛔"}
def read():
try:
return open(STATUS, encoding="utf-8").read()
except Exception:
return ""
def write(text):
open(STATUS, "w", encoding="utf-8").write(text)
def rows(text):
"""Все строки таблиц с ID вида X-01."""
out = []
for line in text.splitlines():
if re.match(r"^\|\s*[A-Z]+-\d+\s*\|", line):
out.append(line)
return out
def has_id(text, ident):
return re.search(rf"\|\s*{re.escape(ident)}\s*\|", text) is not None
def cmd_check(ident):
text = read()
if has_id(text, ident):
print(f"ok: {ident} найден")
return 0
print(f"ОШИБКА: {ident} нет в ops/STATUS.md — сначала добавьте задачу")
return 1
def cmd_list():
text = read()
for line in rows(text):
print(line.strip())
def cmd_set(ident, state):
icon = ICONS.get(state.lower(), state)
text = read()
lines = text.splitlines()
changed = False
for i, line in enumerate(lines):
if re.match(rf"^\|\s*{re.escape(ident)}\s*\|", line):
parts = line.split("|")
# статус — третья колонка (индекс 3 для | # | задача | статус |)
if len(parts) > 4:
parts[3] = f" {icon} "
lines[i] = "|".join(parts)
changed = True
break
if not changed:
print(f"не найдено: {ident}")
return 1
write("\n".join(lines) + "\n")
print(f"{ident} → {icon}")
return 0
def cmd_add(ident, section, task, prio="средний"):
text = read()
if has_id(text, ident):
print("уже есть")
return 0
marker = f"## {section}"
if marker not in text:
text = text.rstrip() + f"\n\n{marker}\n\n| # | Задача | Статус | Приоритет |\n|---|---|---|---|\n"
new_row = f"| {ident} | {task} | ⏳ | {prio} |"
lines = text.splitlines()
insert_at = None
in_section = False
for i, line in enumerate(lines):
if line.strip() == marker:
in_section = True
continue
if in_section:
if line.startswith("## "):
insert_at = i
break
if line.startswith("|") and not line.startswith("|---") and "Задача" not in line:
insert_at = i + 1
if insert_at is None:
insert_at = len(lines)
lines.insert(insert_at, new_row)
write("\n".join(lines) + "\n")
print(f"добавлено: {new_row}")
return 0
if __name__ == "__main__":
if len(sys.argv) < 2:
cmd_list()
elif sys.argv[1] == "list":
cmd_list()
elif sys.argv[1] == "check" and len(sys.argv) > 2:
sys.exit(cmd_check(sys.argv[2]))
elif sys.argv[1] == "set" and len(sys.argv) > 3:
sys.exit(cmd_set(sys.argv[2], sys.argv[3]))
elif sys.argv[1] == "add" and len(sys.argv) > 4:
sys.exit(cmd_add(sys.argv[2], sys.argv[3], sys.argv[4],
sys.argv[5] if len(sys.argv) > 5 else "средний"))
else:
print(__doc__)