vesma-vitals

Методология и инструментализация честного измерения работы сервера памяти Mnemos. Доказывать — или честно опровергать — каждое обещание: динамический контекст, правильная память на запрос, экономию токенов, здоровье каждой подсистемы.

Навигация · Что это · Почему отдельный проект · Архитектура · Документация · Статус

Что это

Владелец Mnemos сформулировал проблему (2026-09-09): «на словах и доках всё красиво, а по факту нет ощущения, что контекст РЕАЛЬНО динамически формируется. Сколько токенов реально экономим? Подставляется ли нужная инструкция или кусок памяти по запросу?» Стенды сервера (S1–S4) меряют качество выдачи и латентности — ни один не отвечает, что память даёт петле и работает ли каждая функция.

vesma-vitals закрывает этот разрыв двумя контурами:

Оба решения приняты Архитектурным комитетом mnemos (2026-09-09, mnemos 7ec9dda3 ядро + 061398fe аддендум «весь функционал»); ADR-0026 mnemos — формальная запись. Этот репозиторий — реализация.

Почему отдельный проект

• Граница доверия: сборщик метрик — гость в сервере. Изоляция кода исключает случайное сращивание телеметрии с конвейером assemble_context и основным стором.
• Контракт внедрения: vesma-vitals встраивается в mnemos минимальными точками (10 определённых границ), сервер не зависит от него.
• Скорость: свой CI, свои релизы, свой ревью-цикл — метрики не ждут релизного окна сервера.
• Переиспользуемость: методология применима к любому серверу памяти с той же формой контракта (харнес → память → модель).

Навигация

Архитектура

flowchart LR
    subgraph MNEMOS["Сервер mnemos (не меняется)"]
        AC[assemble_context и др.]
        EP[10 границ: MCP / REST / фон / CLI]
    end
    subgraph VITALS["vesma-vitals"]
        SINK["MetricsSink<br/>allowlist, fail-closed"]
        LEDGER[("metrics.sqlite sidecar<br/>5 таблиц born-final")]
        S5["Стенд S5 memory-value<br/>два рукава on/off"]
        EXP["Prometheus-гибрид<br/>counters + p50/p95 из rollup"]
        REPORT["Отчёт: светофор F8/F9<br/>PASS / FAIL / NO-DATA"]
    end
    EP -->|verb, status, latency, project| SINK
    SINK --> LEDGER
    LEDGER --> EXP
    LEDGER --> S5
    S5 --> REPORT
    EXP --> REPORT

Ключевые свойства: allowlist-схема без колонок для сырого текста (приватность — структурой, не фильтром), keyed-HMAC-отпечатки, born no-federate, TTL 30/90 дней fail-loud, таксономия статусов — инвариант / коридор / вердикт.

Документация

Статус

Фундамент заложен (2026-09-09); фаза A в работе. Библиотечное ядро пассивного сбора готово (born-final схема + C1-канарейка + MetricsStore, 33 теста зелёных); интеграция в mnemos — отдельным PR в репо сервера. Полный статус — docs/status.md. Обещания и их измеренный статус — docs/claims.md.

Критичные действия

Любое действие, затрагивающее основной стор mnemos, выполняется только средствами mnemos — vesma-vitals не имеет API записи в него.

Лицензирование — по решению владельца; проект наследует канон экосистемы Vesma (vesma — сервер, vesma-eyes — веб-просмотрщик).