§01
Обзор
- Что это: сопутствующий пакет с запускаемыми примерами (
bun run examples/NN-*.ts) для тестирования и демонстрации API движка supervision Popper (#50). Клиентская обёрткаlib/popper-client(supervise/printResponse), типы из@regain/hermes. - Тип / статус / роль: библиотека (примеры/кукбук) · активный · lead — 10 из 13 пользовательских коммитов (aniashev 3).
- Активный период: 2026-01-26 → 2026-01-28 — трёхдневный спринт.
§02
Стек
- Языки: TypeScript.
- Фреймворки/библиотеки: Bun (раннер),
@regain/hermes(контракты supervision/HTV), клиент для Popper API..cursor/(AI-тулинг Cursor). - Инфра/деплой: нет — локально запускаемые скрипты.
- Данные: обращается к Popper API.
§03
Что реализовано
10 авторских коммитов; 20 примеров, привязанных к тикетам (SAL-*/POP-*):
- Базовый supervision-флоу: health (01), простое сообщение (02), режимы wellness vs clinical (03), устаревший снапшот (04), предложение по медикаментам (05).
- Фичи API (SAL-604..614): полный тест supervision (06), события аудита (07), идемпотентность (08), safe-mode (09), API-ключи (10), организации (11), rate limiting (12), операционные настройки (13).
- Политики/гавернанс (POP-013b..016): жизненный цикл политик (14), счётчики дрейфа (15), базовые линии дрейфа (16), триггеры дрейфа (17).
- RLHF и экспорт (POP-015b, 023a/b): RLHF-бандлы (18), экспорт-бандлы (19), интероперабельность TEFCA/USCDI (20).
- Объём: 13 коммитов за 3 дня; покрытие всего Popper API.
§04
Технические челленджи
По набору примеров (демонстрируют понимание сложного governance-API; авторство пользователя):
- Детекция дрейфа (примеры 15–17: счётчики → базовые линии → триггеры): мониторинг дрейфа модели/политик с базовыми линиями и триггерами. → Зрелость MLOps (отслеживание деградации AI).
- RLHF-бандлы (18): сбор данных обратной связи для файнтюнинга. → ML feedback loop.
- Интероперабельность в здравоохранении (20: TEFCA/USCDI): экспорт в стандартах обмена медицинскими данными США (TEFCA — Trusted Exchange Framework, USCDI — US Core Data for Interoperability). → Знание регуляторных стандартов здравоохранения.
- Идемпотентность / safe-mode / rate-limiting / операционные настройки (08, 09, 12, 13): production-grade надёжность supervision-API. → Понимание отказоустойчивых API.
- Это примеры (не сам движок), но они показывают полное покрытие и понимание домена governance/compliance.
§05
AI-разработка
- Найдено сессий: 0 в соответствующей директории (проверено нормализацией). Присутствует
.cursor/→ разработка велась через Cursor AI; сессий Claude Code в этой директории нет. - Что делалось с AI: написание примеров по тикетам, вероятно, с Cursor.
- Паттерны AI-воркфлоу: cookbook-driven development (примеры как живые тесты API), привязка к тикетам.
§06
Достижения и метрики
- 20 примеров, покрывающих supervision-API end-to-end (supervision, аудит, идемпотентность, safe-mode, жизненный цикл политик, дрейф, RLHF, экспорт, TEFCA/USCDI).