From 3aee20701e1775fc5d19225472aba3bb263f77b0 Mon Sep 17 00:00:00 2001
From: Simbiot Harness <harness@simbiot>
Date: Sat, 17 Oct 2026 08:24:18 +0000
Subject: [PATCH] =?UTF-8?q?README:=20=D1=8F=D0=B4=D1=80=D0=BE=20=D0=9A?=
 =?UTF-8?q?=D0=BE=D0=B4=D0=B8=20=E2=80=94=20=D0=BE=D0=B1=D1=83=D1=87=D0=B0?=
 =?UTF-8?q?=D0=B5=D0=BC=D1=8B=D0=B5=20=D1=83=D1=87=D0=B5=D0=BD=D0=B8=D0=BA?=
 =?UTF-8?q?=D0=B8=20=D1=80=D0=B5=D1=88=D0=B5=D0=BD=D0=B8=D0=B9?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 README.md | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/README.md b/README.md
index f3150f3..2f819c9 100644
--- a/README.md
+++ b/README.md
@@ -369,6 +369,29 @@ off — тесты герметичны), точечно `SIMBIOT_DECISION_<TASK
 исходом). Статус/статистика: `cli.py decide`, `cli.py decide --stats`.
 Тест: `./venv/bin/python tests/test_decision.py` (фейковый эндпоинт).
 
+## Ядро Коди — обучаемые ученики решений (harness/kodi_core.py)
+
+Цикл как в systemone-bench (engine42/router42): учитель → маленькая
+своя модель + kNN-память новизны → роутер → дообучение на исходах.
+Первая голова — `addressing` (отвечать ли в группе), режим
+`SIMBIOT_CORE_ADDRESSING=shadow|on|off` (дефолт shadow: решает учитель
+`clef:27b`, ученик пишет прогноз `CorePrediction`).
+
+- **Метки** (события `core`, подписаны): учитель (живые вердикты и
+  разметка истории `cli.py core backfill`, вес 1), неявная обратная
+  связь чата (`CoreFeedback`: «не тебе/продолжает» после ответа → 0,
+  «@juno42bot»/«Коди?» сразу после молчания → 1, вес 3), Alex —
+  кнопки «Это было мне?» в личку на незнакомых спорных (≤ 5/сут, вес 5).
+- **Ученик**: эмбеддинг сообщения (локальный `nomic-embed-text`, кеш в
+  `<home>/core/emb.sqlite`) + 8 флагов → логрегрессия (numpy); новизна —
+  kNN к обучающей памяти, пороги калибруются на холдауте.
+- **Роутер**: знакомо и |p−0.5| ≥ 0.4 → ученик; незнакомо и учитель
+  сомневается → вопрос Alex; иначе учитель.
+- **Тренировка**: дневной тик (и `cli.py core train`) — временной
+  холдаут, претендент сменяет чемпиона только при лучшем log-loss;
+  `CoreModelPromoted` с sha256 файла; подменённый файл не грузится;
+  `cli.py core rollback`. Метрики и тень за 7 дней — `cli.py core status`.
+
 ## Модели
 
 9router (router.cil.by), отдельный ключ `sk-simbiot` в `.env`, комбо `auto`: