hermes

• Bu nima: @regain/hermes (hermes_version: 2.0.0) — nomdosh protokolning referens implementatsiyasi: standartlashtirilgan xabarlar (supervision_request, supervision_response, control_command_v2, control_command_response, audit_event, clinician_feedback, bias_detection), ularning tiplari/guardlari/JSON Schema'si, hamda runtime epistemologiya utilitalari (HTV kompozit, kalibrlangan noaniqlik, evidence-grade iyerarxiyasi, v1→v2 Control-kanal migratsiyasi). Hermes — dunyolar o'rtasidagi xabarchi sharafiga nomlangan; bu yerda klinik-AI agenti va nazorat tizimi o'rtasidagi xabarchi. README uni "xavfsiz, auditlanadigan klinik AI uchun sanoat standarti protokoli" sifatida taqdim etadi va kelgusi sertifikatsiya dasturiga (Compatible / Certified / Certified Clinical) ishora qiladi.
• Tur / status / rol: kutubxona (npm paketi, ESM+CJS, Bun ostida shartli eksportlar bilan dist/ + src/) · active / Public Alpha · lead — foydalanuvchi asosiy muallif (24 kommitdan 14 tasi = 58%); US healthtech platform jamoasi: Anton Kim <anton@US healthtech platform> (9), Harsh Manwani (1). 1–5 bosqichlarning barchasi va npm publikatsiyasi foydalanuvchiga tegishli.
• Faollik davri: 2026-01-25 → 2026-02-13 — "noldan npm v1.0.x → v2.0.0'gacha" ~3 haftalik sprint, registrida jonli. To'liq OSS skaffolding (LICENSE Apache 2.0, README, VISION, GOVERNANCE, CONTRIBUTING, CODE_OF_CONDUCT, TRADEMARK, CERTIFICATION, CHANGELOG, CI badge'lari).

• Tillar: TypeScript 5.7 (strict, ESM-first), JSON Schema (draft-2020-12).
• Freymvorklar/kutubxonalar: Bun (test runner, dev/watch, bun build orqali --format esm va --format cjs bilan dual ESM+CJS build); AJV 8 + ajv-formats runtime schema validatsiyasi uchun (draft-2020-12 mosligi uchun new Ajv({ allErrors: true, strict: false })); Biome 1.9 (lint/format); deklaratsiyalar uchun tsc --emitDeclarationOnly; lefthook uslubidagi .githooks/pre-commit (prepare git config core.hooksPathni ishga tushiradi). package.jsonda shartli exports — bun → src/*.ts, import → dist/*.js, require → dist/*.cjs (Bun loyihalarida zero-build DX + klassik Node distribyutsiyasi).
• Infra/deploy: GitHub Actions CI (ci.yml badge yashil); registry.npmjs.orgda access: public bilan npm'ga chop etilgan; fix(ci): publish only on version tags (185de71) — relizlar faqat git teglarida. Homepage/issue tracker — github.com/US healthtech platform/hermes.
• Ma'lumotlar: ma'lumotlar bazasi yo'q (bu kutubxona); u PHI minimizatsiyasi bilan audit-event formatlarini va downstream saqlash uchun AuditRedactionBaseni tavsiflaydi.
• E'tiborga molik tooling: git worktree (hermes-2, hermes-3) 2 va 3-bosqichlarni bitta main branchda parallel ishlash uchun ishlatilgan — foydalanuvchi tomonidan boshlangan ahamiyatli vorkflow (AI sessiyalariga qarang). Trademark to'plami (US healthtech platform Hermes™, Popper™, Deutsch™, Hard2Vary™).

24 kommit, 5 aniq ajratilgan bosqich → publikatsiya → v2:

• 1-bosqich — Core Types (762a1ed +4361/-0, 28 fayl): branded tiplar, bazaviy TraceContext / IsoDateTime / HermesVersion / SubjectRef / ProposedInterventionKind / Mode / SupervisionDecision, type guardlar.
• 2-bosqich — Supervision Contract (5927e52 +2876/-72, hermes-2 worktree'da): SupervisionRequest/Response, InputRisk (phi_detected, prompt_injection_suspected), PriorOverride, ProposedIntervention, HealthStateSnapshotRef, cross-domain konfliktlar (CrossDomainConflict, ConflictEvaluation), ConfidenceLevel / OverrideApplicability / RationaleCategory.
• 3-bosqich — Epistemology Types (bbdca0c +1959, hermes-3 worktree'da): ClaimType + risk profillar (diagnosis / treatment_rec / escalation → requiresPopper: true), EvidenceGrade (systematic_reviewdan calculatedgacha 10 darajali iyerarxiya), HTVScore (Hard2Vary 4D: interdependence/specificity/parsimony/falsifiability), UncertaintyCalibration + UncertaintyDriver. Ikki worktree birlashtiriladi (7eaa0d6, PR #1, PR #2).
• 4-bosqich — Clinical, Imaging & Bias Detection (b963693 +2642): imaging.ts (tibbiy imaging), bias.ts (BiasDetectionType: demographic_override_disparity / intervention_type_bias / clinician_specialty_bias — FDA post-market AI/ML monitoringi), feedback.ts (rationale kategoriyalari bilan klinisist fikri), disclosure.ts.
• 5-bosqich — Testing, Validation & CI (6f4faa3 +3375): draft-2020-12 uchun AJV validator, 1405 qatorli JSON Schema (hermes-message.schema.json), 11 fixture fayl (sup-request/response, audit-event, clinician-feedback, evidence, htv-score), 41 conformance test, GitHub Actions, .githooks/pre-commit. package.json eksportlariga ./schema va ./fixtures submodullari qo'shildi.
• npm publikatsiyasi: a977689 chore: prepare for npm publication v1.0.0, b9c3791 chore: remove internal docs and spec references (-2977 qator, publik reliz oldidan yopiq PRD/speclarni tozalash — namunali pre-publish gate), 1.0.0 → 1.0.1 → 1.0.2 → 1.0.3 relizlari, a6b9c9c chore: change license from MIT to Apache 2.0 (trademark strategiyasiga ega klinik dasturiy ta'minot uchun to'g'ri tanlov).
• **Publikatsiyadan so'ng darhol SAL-* funksiya to'plami keldi:** c6df831 developer hujjatlari (docs/DEVELOPER-GUIDE.md, API-REFERENCE.md, EPISTEMOLOGY-GUIDE.md, TESTING.md), bc3d701 feat(SAL-508): auto-refutation types for Popperian prediction failure, a964697 ControlCommandV2 + Operational Settings Catalog (621 qator tip, 176 qator test), 8d082ab v1→v2 builderlar + migratsiya utilitalari, 117cc28 Control v2 uchun AJV schemalari + conformance fixturelari, d017a86 feat: add Control v2 exports, comprehensive tests, and bump to v2.0.0 — 3 haftada major bump.
• Hajm: 24 kommit; 10,901 qator TypeScript + 1,405 qator JSON Schema; to'liq test bilan qoplangan (har bir modul yonida *.test.ts).

Kod / difflar bo'yicha:

• Popper/Deutsch epistemologiyasi kod sifatida (src/types/epistemology.ts, src/utils/htv.ts, src/utils/uncertainty.ts): protokol fan falsafasini kodlashtiradi — har bir klinik da'vo klassifikatsiyalanadi (observation / diagnosis / treatment_rec / escalation ...), va yuqori riskli tiplar advocate_clinical rejimida falsification_criteria olib yurishi shart. HTV kompozit (Hard2Vary, Deutschga ishora): interdependence × specificity × parsimony × falsifiability'ning tortilgan yig'indisi; [0,1] oralig'iga clamp qilinadi va diapazon validatsiyasi bilan. Kalibrlangan noaniqlik (computeUncertainty): 5 ta drayver ustidan additiv model (evidence_grade 0–0.3, htv_score 0–0.3, data_quality 0–0.2, debate_consensus 0–0.1, staleness 0–0.1) → low | medium | high. → Akademik epistemologiyani ishlaydigan API'ga aylantirishni namoyish etadi.
• JSON Schema draft-2020-12 + AJV strict-relax (src/schema/validator.ts): draft-2020-12 mosligi uchun new Ajv({ strict: false }); xatolar {path, message}[]ga map qilinadi; maxsus HermesValidationError xabarni agregatlaydi; API juftligi — validateHermesMessage (qaytaradi), parseHermesMessage (throw qiladi), isValidHermesMessage (type guard). → Kutubxona uchun puxta API dizayn: bitta validatsiya ustida uchta runtime kontrakt.
• Idiomatik TypeScript dizayni: branded tiplar (src/types/branded.ts), hamma joyda readonly (faqat DTO), runtime enum validatsiyasi uchun as const massivlari, Bun (zero-build) va Node (ESM+CJS) uchun shartli exports, tree-shaking uchun sideEffects: false. 1-bosqich diffi (+4361/-0) darhol guardlar va testlar bilan poydevorni yotqizadi.
• Migratsiyali Control Channel v2 (src/types/control-v2.ts 239 qator, src/utils/control-migration.ts 192): stringly-typed v1'dan to'liq tiplashtirilgan (SettingValue = boolean|string|number|string[]) tomon o'tish, batched buyruqlar, priority-aware (ROUTINE / URGENT / EMERGENCY), idempotency_key, operatsion rejimlar (NORMAL / RESTRICTED / SAFE_MODE / MAINTENANCE), ack'da to'liq holat snapshotlari. Ikki tomonlama mapV1ToV2 / mapV2SettingToV1 autonomy mapping bilan ('0' → 'passive', ...) va olib tashlangan v1 kalitlari to'plami (disable_domain, policy_pack). → Murakkab, ammo intizomli protokol evolyutsiyasi; SAL-* ticketlar ortida haqiqiy legacy turibdi.
• Bias detection birinchi darajali xabar tipi sifatida (src/types/bias.ts 302 qator): BiasDetectionType ('demographic_override_disparity' va boshqalar), BiasSeverity, BiasAnalysisPeriod, BiasDimensionType — FDA AI/ML post-market surveillance yo'riqnomasiga muvofiq. → Compliance tafakkuri keyin ilib qo'yilgan emas, balki kodga kiritilgan.
• Parallel bosqichlar uchun git-worktree vorkflow'i (AI sessiyalariga qarang): foydalanuvchi 3-bosqich uchun git worktree add hermes-3ni o'zi boshladi, 2-bosqich uchun hermes-2 bilan parallel, PRlar (#1, #2) orqali main'ga birlashtirdi. → Ko'pgina seniorlarga xos bo'lmagan yetuk git buyruqlari.
• Publikatsiya oldidan gigiyena: b9c3791 chore: remove internal docs and spec references kommiti publik reliz oldidan 2,977 qator ichki PRD/spec materialini o'chirdi — npm tarball'iga Healthcare platform'ga xos tafsilotlar tushib qolmasligi uchun o'ylab qo'yilgan gate. Bu tijoriy-OSS strategiya tafakkuri.

• Topilgan sessiyalar: 5 (-Users-macbookpro-development-hermes/, jami 133 xabar). hermes-2/3 worktreelari ichidagi qo'shimcha sessiyalar alohida CC loyihalari sifatida ro'yxatga olinmagan — ular asosiy hermes katalogi orqali ishlagan.
• AI bilan nima qilingan (indeksning firstPrompt / summarysi bo'yicha): 1. cf51ad0a — "Study best practices for npm package development with bun.js... create the scaffold" (10 xabar) — paket bootstrap. 2. 7853e944 — "@docs/PLAN-01-phase-1-core.md translate all tasks... into a task list" (31 xabar) — 1-bosqich (Core Types). 3. eebcdb59 — "Create git worktree hermes-2 and let's switch to working in it" (41 xabar) — worktree'da 2-3-bosqich. 4. b7a92f59 — "Create git worktree hermes-3 and let's switch to working in it" (27 xabar) — parallel ravishda 3-bosqich (Epistemology). 5. 0dc63c85 — "@docs/PLAN-04-phase-4-clinical.md break down the tasks... grounded in ...new_unified_health_app/docs/0..." (24 xabar) — cross-repo kontekst bilan 4-bosqich (Clinical/Imaging/Bias).
• AI vorkflow patternlari: plan-driven (PLAN-XX-phase-X-*.md kontrakt sifatida), task listlar agent tomonidan markdown'dan TodoWrite'ga tarjima qilinadi, git worktreelar ichida parallel bosqich-agentlari (asosiy AI-native harakatlardan biri — bitta repoda konfliktsiz bir nechta ish oqimi), cross-repo grounding (4-bosqich new_unified_health_app speclariga tayanadi — o'sha healthcare monorepo). Barcha 5 bosqich ~3 haftada yuqori tezlikda, test qamrovi va OSS skaffolding'ini saqlagan holda bajarildi va yetkazildi.

• @regain/hermes npm paketi publik npmjs.org registrida (Apache 2.0, public alpha), v2.0.0; yashil CI badge'li GitHub US healthtech platform/hermes.
• 10,901 qator TypeScript + 1,405 qator JSON Schema; 5-bosqichda 41 conformance test; modul bo'yicha testlar (har bir tip / utilita yonida *.test.ts).
• Oldindan arxitektura rejalashtirishga ega 5 bosqich (PLAN-01..05) ~3 haftada yetkazildi (24 kommit, 14 tasi foydalanuvchi tomonidan yozilgan).
• Foydalanuvchi popper (#62/72 foydalanuvchi kommiti, infra/governance), deutsch (reasoning engine), healthcare-crm (mahsulot CRM) va lab-processor (Temporal pipeline)'ni yagona US healthtech platform klinik-AI platformasiga bog'laydigan protokolning asosiy muallifi.