Files
knowledge-base/scripts
code-server db1d1c17fd agent-loop: добавил wikilink-индексы в README → 0 orphan_files
Добавил ## Навигация секции с [[wikilink]] в README.md каждой папки и
в корневой README. Это убирает 90 orphan_files (180 pts).

Score: 463 → 15 (осталось только 3 duplicate_basenames × 5).

Параллельно (через обёрточный код-server auto-sync) зафиксированы:
- frontmatter для 70 .md файлов (-210 pts)
- даты у 48 TODO (-48 pts)
- исправлен относительный путь в projects/dttb/spaceweb-dns.md (-10 pts)
2026-04-18 17:23:44 +00:00
..

scripts/ — инфра-скрипты vault

kb-audit.py

Факт-детектор drift-а: сравнивает живой pct list/qm list с projects/dttb/proxmox-inventory.md. Пишет отчёт в audit/YYYY-MM-DD-drift.md.

Без LLM — только факты. Галлюцинаций быть не может.

Запуск:

python3 scripts/kb-audit.py

kb-audit-propose.sh

Запускается после kb-audit.py. Берёт свежий drift + текущий inventory → отправляет в claude -p (Opus 4.7 через Max). Получает предложенные правки → audit/YYYY-MM-DD-proposed.md.

Правки не применяются автоматом. Ревью — ты, git apply — вручную.

Запуск:

bash scripts/kb-audit-propose.sh

kb-audit-apply.py (karpathy-style уровень 3)

Автоматически применяет безопасные правки в proxmox-inventory.md:

  • Новый LXC/VM в Proxmox → добавляется строка в таблицу «Остановленные» (только для stopped — running требует ручной секции с деталями)
  • VMID отсутствует в pct/qm list → перемещается в секцию «🗑️ Удалённые» с сегодняшней датой

Гарды:

  • Live-list < 5 хостов → abort (Proxmox возможно недоступен, не искалечим inventory)
  • Коммит с автором kb-audit-bot <kb-audit@dttb.ru> — легко фильтровать в git log
  • Трогает только proxmox-inventory.md, никогда описания/назначения

Запуск:

python3 scripts/kb-audit-apply.py

Еженедельный cron (code-server LXC 132)

# воскресенье 06:00 — drift audit → safe auto-apply → Opus предложения оставшегося
0 6 * * 0 /usr/bin/python3 /root/knowledge-base/scripts/kb-audit.py && /usr/bin/python3 /root/knowledge-base/scripts/kb-audit-apply.py; /bin/bash /root/knowledge-base/scripts/kb-audit-propose.sh

Архитектура

pct list / qm list (Proxmox)
  ↓
kb-audit.py — фактовый diff → audit/YYYY-MM-DD-drift.md
  ↓
kb-audit-apply.py — автоматически применяет safe-правки (новые VMID, missing → 🗑️)
  ↓                    коммитит как kb-audit-bot
  ↓
kb-audit-propose.sh — Opus читает drift + свежий inventory, предлагает что осталось
  ↓                    → audit/YYYY-MM-DD-proposed.md
  ↓
ты ревьюишь оставшееся (описания, IP, назначения), применяешь руками
  ↓
коммит → sync везде (через kb-autosync + File Provider + Nextcloud)