vault-audit

vault-audit — гигиена knowledge vault

Ты — аудитор <workspace>/knowledge/ (Obsidian vault, markdown source of truth).

Контекст (адаптируется под workspace)

• Vault root: <workspace>/knowledge/
• Hub-нота: <workspace>/knowledge/00-Overview/INDEX.md (ВСЕ заметки должны быть upомянуты)
• Source of truth: <workspace>/knowledge/00-Overview/CURRENT_STATE.md
• Memory log: <workspace>/knowledge/00-Overview/MEMORY-LOG.md
• Folders:
  • 00-Overview/ — INDEX, CURRENT_STATE, MEMORY-LOG, AUDIT-*
  • 01-Infrastructure/ — серверы, домены (если есть)
  • 02-Projects/ — хабы каждого проекта
  • 03-Operations/ — runbooks
  • 04-Credentials/ — gitignored
  • 05-Decisions/ — ADR (YYYY-MM-DD-<name>.md)
  • archive/legacy/ — заархивированные ноты
  • templates/ — шаблоны

Workflow

Phase 1 — Inventory

cd <workspace>/knowledge

# Все .md файлы (исключая archive, .obsidian, templates)
ALL_MD=$(find . -name "*.md" -not -path "./archive/*" -not -path "./.obsidian/*" -not -path "./templates/*" 2>/dev/null)
echo "Total .md files: $(echo "$ALL_MD" | wc -l)"

Phase 2 — Orphan detection

Найди заметки которые не упомянуты в INDEX.md:

# Все имена файлов без .md
ALL_NAMES=$(find . -name "*.md" -not -path "./archive/*" -not -path "./.obsidian/*" -not -path "./templates/*" -not -name "INDEX.md" \
  -exec basename {} .md \; 2>/dev/null | sort -u)

# Те что не упоминаются в INDEX.md как [[name]]
INDEX_LINKS=$(grep -oE '\[\[([^\]\|]+)\]\]' 00-Overview/INDEX.md 2>/dev/null | sed 's/\[\[//;s/\]\]//;s/|.*//' | sort -u)

# Diff — orphan files
comm -23 <(echo "$ALL_NAMES") <(echo "$INDEX_LINKS")

Phase 3 — Broken wiki-links

Найди ссылки [[X]] где X не существует:

# Все wiki-link targets
LINKS=$(grep -rohE '\[\[([^\]\|]+)\]\]' . --include="*.md" 2>/dev/null | sed 's/\[\[//;s/\]\]//;s/|.*//;s/#.*//' | sort -u)

# Все имена файлов
EXISTS=$(find . -name "*.md" -exec basename {} .md \; 2>/dev/null | sort -u)

# Targets без файла
echo "$LINKS" | while read l; do
  [ -z "$l" ] && continue
  if ! echo "$EXISTS" | grep -qx "$l"; then
    file=$(grep -rl "\[\[$l\]\]\|\[\[$l|" . --include="*.md" 2>/dev/null | head -1)
    echo "BROKEN: [[$l]] referenced in $file"
  fi
done