§01
Umumiy ko'rinish
- Bu nima: Popper (#50) supervision dvigatelining API'sini sinash va namoyish qilish uchun ishga tushiriladigan misollar (
bun run examples/NN-*.ts) bilan hamroh paket.lib/popper-clientklient wrapper'i (supervise/printResponse), tiplar@regain/hermes'dan. - Turi / holati / roli: library (examples/cookbook) · faol · lead — 13 tadan 10 ta foydalanuvchi kommiti (aniashev 3 ta).
- Faol davr: 2026-01-26 → 2026-01-28 — 3 kunlik sprint.
§02
Stek
- Tillar: TypeScript.
- Freymvork/kutubxonalar: Bun (runner),
@regain/hermes(supervision/HTV kontraktlari), Popper API uchun klient..cursor/(AI tooling Cursor). - Infra/deploy: yo'q — lokal ishga tushiriladigan skriptlar.
- Ma'lumotlar: Popper API'ni chaqiradi.
§03
Nima qilindi
10 ta muallif kommiti; 20 ta misol, tiketga yo'naltirilgan (SAL-*/POP-*):
- Bazaviy supervision oqimi: health (01), oddiy xabar (02), wellness va clinical rejimlar (03), eskirgan snapshot (04), dori taklifi (05).
- API imkoniyatlari (SAL-604..614): to'liq supervision testi (06), audit hodisalari (07), idempotentlik (08), safe-mode (09), API kalitlar (10), tashkilotlar (11), rate limiting (12), operatsion sozlamalar (13).
- Siyosat/boshqaruv (POP-013b..016): siyosat hayotiy sikli (14), drift hisoblagichlari (15), drift baseline'lari (16), drift triggerlari (17).
- RLHF va eksport (POP-015b, 023a/b): RLHF to'plamlari (18), eksport to'plamlari (19), TEFCA/USCDI o'zaro muvofiqligi (20).
- Hajm: 3 kunda 13 ta kommit; butun Popper API'ning qamrovi.
§04
Texnik chellenjlar
Misollar to'plami bo'yicha (murakkab boshqaruv API'sini tushunishni namoyish qiladi; foydalanuvchi mualliligi):
- Drift aniqlash (15–17-misollar: hisoblagichlar → baseline'lar → triggerlar): model/siyosatlar driftini baseline va triggerlar bilan monitoring qilish. → MLOps yetukligi (AI degradatsiyasini kuzatish).
- RLHF to'plamlari (18): fine-tuning uchun feedback ma'lumotlarini yig'ish. → ML feedback sikli.
- Sog'liqni saqlash o'zaro muvofiqligi (20: TEFCA/USCDI): AQSh sog'liqni saqlash ma'lumotlari almashinuvi standartlarida eksport (TEFCA — Trusted Exchange Framework, USCDI — US Core Data for Interoperability). → Sog'liqni saqlash regulyator standartlarini bilish.
- Idempotentlik / safe-mode / rate-limiting / operatsion sozlamalar (08, 09, 12, 13): supervision API'ning production darajasidagi ishonchliligi. → Bardoshli API'larni tushunish.
- Bular misollar (dvigatel emas), lekin boshqaruv/muvofiqlik sohasining to'liq qamrovi va tushunilishini ko'rsatadi.
§05
AI yordamida ishlab chiqish
- Topilgan sessiyalar: tegishli katalogda 0 ta (normalizatsiya orqali tekshirilgan).
.cursor/mavjud → ishlab chiqish Cursor AI orqali bo'lgan; bu katalogda Claude Code sessiyalari yo'q. - AI bilan nima qilingan: tiketlar bo'yicha misollar yozish, ehtimol Cursor bilan.
- AI vorkflow patternlari: cookbook'ga asoslangan ishlab chiqish (misollar jonli API testlari sifatida), tiketga yo'naltirilgan.
§06
Yutuqlar va metrikalar
- 20 ta misol supervision API'ni uchma-uch qamrab oladi (supervision, audit, idempotentlik, safe-mode, siyosat hayotiy sikli, drift, RLHF, eksport, TEFCA/USCDI).