4508bc7339
6 категорий штрафов со взвешенной суммой: - broken_wikilinks (×10) — [[foo]] не ведёт никуда - broken_paths (×10) — [text](./foo.md) не существует - missing_frontmatter (×3) — .md без frontmatter-заголовка - orphan_files (×2) — нет входящих wikilinks и не в служебных папках - undated_todos (×1) — "- [ ]" без YYYY-MM-DD - duplicate_basenames (×5) — одинаковое имя в разных папках Baseline сегодня: score=493 (158 файлов). Выход: audit/DATE-health.md (человекочит) + audit/health-latest.json (для agent-loop). False-positives зачинены: - wikilinks внутри backticks/fenced code игнорим - ../ и ./ пути резолвятся от файла-источника - CLAUDE.md/README.md не требуют frontmatter
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)