brain · git:20260814.5023d8c · 2026-08-14 · sha256 4cb709539b4ba360

brain git:20260814.5023d8cA

Immutable. This exact content is served forever at /api/v1/blob/4cb709539b4ba360.

---
name: brain
description: >
  One-glance health of the "second brain" so failures aren't SILENT — is the local search server
  alive, is the RAG index fresh, is the session-memory ledger filling, did the nightly
  distillation run. Trigger on "/brain", "/memory", "brain health", "is the reindex alive".
  READ-ONLY diagnostic with a green/red verdict per component.
license: MIT
---

# /brain — здоровье «второго мозга» одним взглядом

> 🧒 В конце ответа Антону — простой recap «Простыми словами» (memory `eli5-always`).

Ловит ТИХИЕ поломки memory/RAG-стека (то, что в этом месяце ломалось снова и снова: реиндекс, сервер :8770, пилот памяти). Read-only, 0 токенов.

## Что делает (один скрипт)
`python $IMPORTS_ROOT/brain_health.py`

Проверяет 5 вещей и красит 🟢/🟡/🔴:
1. **Поисковый сервер** :8770 — жив ли (если лёг → авто-recall молча пропадает); показывает, включена ли Ассоциативная (граф).
2. **Индекс** `_brain_e5.npy` — насколько свежий (🟡 если реиндекс отстал >48ч).
3. **TurnState-леджер** — сколько ходов записано (Phase 1 памяти), последний когда.
4. **Ночной сон** — кандидаты в карантине + когда последний прогон.
5. **A/B Прямая↔Ассоциативная** — сколько прогонов + твои вердикты (👍/👎).

Пишет дашборд `$OBSIDIAN_VAULT/_Dashboards/Brain-Health.html` (Антон смотрит глазами, [[prefer-visual-dashboards]]). Exit-код 0/1/2 = ok/warn/red (для скриптов).

## Когда чинить (если 🔴/🟡)
- **🔴 сервер :8770** → `restart_brain_server.cmd` (от админа, см. [[always-on-memory-pilot]]); или ребут (AtLogon поднимет).
- **🟡 индекс отстал** → `gpu_check.py [--kill]` затем `brain_embed_update.py [--wait-gpu 10]` ([[reindex-routine]]).
- **🟡 леджер пуст** → норм, если Phase 1 только включился (заполнится со следующих сессий).

## Что НЕ делает
Не чинит сам и не пишет в волт. Это диагностика. Чинит — отдельный явный шаг (правило «прочитай перед починкой» [[verify-existing-before-proposing]]).