Назад в архив
II. Клинический AI и медицинские платформывитриналидклиент анонимизирован

Popper — Clinical AI Supervision

Движок супервизии/политик для платформы US healthtech platform/Healthcare platform: реализует Hermes Protocol v2.0.0 (запросы/ответы супервизии, HTV-скоринг, предлагаемые вмешательства, аудит). Human-in-the-loop управление поверх клинического AI (deutsch). Полноценный проект OSS-уровня с мультирегиональным деплоем (KSA + US).

Статус
активный
Период
2026-01-25 → 2026-02-14
AI-сессий
Стек
Языки
TypeScriptSQL
Фреймворки · Инфра
Elysia.jsBunDrizzle ORMTimescaleDBTurborepoBiome
§01

Обзор

  • Что это: «Popper» — слой супервизии/политик: принимает запросы супервизии от AI-движка (deutsch), применяет пакеты политик (YAML DSL), вычисляет пороги HTV, выносит решения (approve/route/reject) с обязательным аудитом. Назван в честь Карла Поппера (эпистемология опровержения — общая тема с deutsch/HTV). Часть экосистемы US healthtech platform; общий протокол — @regain/hermes.
  • Тип / статус / роль: api (движок политик/супервизии + сервер) · active · lead — пользователь основной автор (72 из 112 коммитов); команда US healthtech platform: Anton Kim <anton@US healthtech platform> (18), Harsh Manwani (17), aniashev/Anna Shevtsova (8).
  • Период активности: 2026-01-25 → 2026-02-14 — интенсивный ~3-недельный спринт, active. Полный OSS-скаффолдинг (LICENSE, VISION, GOVERNANCE, CODE_OF_CONDUCT, CONTRIBUTING, TRADEMARK, CERTIFICATION, PRD.md 51 KB).
§02

Стек

  • Языки: TypeScript (строжайший tsconfig), SQL (TimescaleDB).
  • Фреймворки/библиотеки: Bun 1.3+; Elysia.js (HTTP, apps/server); TimescaleDB (PostgreSQL 16, hypertables) + Drizzle ORM; Turborepo; Biome 2 (lint/format); lefthook (git-хуки); @regain/hermes (npm-пакет с контрактами: типы, AJV-валидация, билдеры, HTV-утилиты, фикстуры). apps: server, queue, web; packages: core (движок политик + парсер DSL), db, auth, cache.
  • Инфраструктура/деплой: мультирегион — Helm с двухрежимными секретами (HashiCorp Vault для KSA/Саудовская Аравия + AWS Secrets Manager для US), GitHub Actions деплой US + SA, AWS ECS (task definitions с ARN-rewrite при миграции аккаунта), OTEL/LGTM observability (Loki/Grafana/Tempo/Mimir). config/policies (YAML-пакеты политик), docs/specs (PRD + спеки Popper/Hermes).
  • Данные: TimescaleDB (time-series аудит с компрессией / retention 7 лет / continuous aggregates).
§03

Что реализовано

Основные коммиты авторства пользователя (по диффам) — преимущественно платформа/инфра/governance:

  • Двухрежимные секреты для data residency (187423c, +528): поддержка Helm для Vault (KSA) и AWS Secrets Manager (US) — под требования региональной резидентности данных.
  • Мультирегиональный CI/CD: воркфлоу деплоя AWS US (b4cf6cb +124), фиксы путей Dockerfile (56d6d5e), ARN-rewrite при миграции AWS-аккаунта (86cb1bd, 41714b6), DATABASE_URL через Turbo для серверных тестов (2d38ac1).
  • Observability: конфиг/логирование OTEL (0e44db2, 99631f8), секция LGTM в гайде по деплою SA (2a1c467).
  • Runtime: переход с bun compile на рантайм Bun ради поддержки env (3b7d546).
  • Движок политик + контракты Hermes: core (парсер DSL, пакеты политик), интеграция @regain/hermes (типы супервизии, HTV).
  • Объём: 112 коммитов за 3 недели; пользователь — lead по инфре/деплою/governance.
§04

Технические челленджи

По коду/диффам (авторство пользователя):

  • Мультирегиональный деплой с data residency (187423c): один Helm-чарт, два режима секретов — Vault (Саудовская Аравия, KSA) против AWS Secrets Manager (US) — так что данные/ключи никогда не покидают регион. → Серьёзный инфра/compliance-инжиниринг (медицинские данные, разные юрисдикции).
  • TimescaleDB hypertables для аудита (воркфлоу CLAUDE.md): составной PK с колонкой-партицией timestamp, segment_by/order_by, компрессия после 7 дней, retention 7 лет (аудит), continuous aggregates (почасовые дашборды / дневные бейзлайны), real-time агрегация выключена. → Грамотный time-series дизайн, проведённый через pg aiguide.
  • Движок политик/супервизии (packages/core): парсер DSL YAML-пакетов политик, применение к запросам супервизии, пороги HTV, решения с аудитом. Контракты через @regain/hermes (AJV-валидация, type guards). → Governance-движок, супервизирующий AI (responsible AI).
  • Observability-first: OTEL + стек LGTM (Loki/Grafana/Tempo/Mimir) в обоих регионах. → Продакшн-observability для распределённой системы.
  • Инженерная культура: строжайший TS, Biome, lefthook, Turborepo, полный OSS-набор governance.
§05

AI-разработка

  • Найдено сессий: 0 в локальной директории сессий Claude Code (проверено нормализацией полного пути). API-тестирование велось в popper-cookbook (#51) — сессии искать там. CLAUDE.md подробно описывает воркфлоу с MCP (pg aiguide) и скиллами (pg:setup-timescaledb-hypertables).
  • Что делалось с AI: разработка по тикетам SAL-* (supervision API и др.), проектирование БД через MCP pg-aiguide.
  • Паттерны AI-воркфлоу: MCP-тулинг для дизайна схемы TimescaleDB, скиллы, тестирование через cookbook, детальные спеки/PRD как контекст. Зрелый AI-native процесс.
§06

Достижения и метрики

  • Governance-движок для реального health-AI продукта US healthtech platform; мультирегион (KSA + US) с data residency; аудит на TimescaleDB с retention 7 лет; observability OTEL/LGTM; полный набор OSS-документации (PRD 51 KB).
  • Команда из 5 человек, пользователь — ведущий автор (72/112) по инфре/деплою/governance.
§07

Контрибьюторы

git shortlog · все ветки

  1. Dave9372
  2. Anton Kim18
  3. Harsh Manwani17
  4. aniashev8
4 контрибьютора115 коммитов всего
Сейчас

Открыт к ролям Senior / Staff инженера и избранному фрилансу — продакшн-AI, платформы и full-stack разработка.

Связаться