From 6d64f3909ae2ab2623eb01c455093b456dc6ec83 Mon Sep 17 00:00:00 2001 From: Dmitry Dementev Date: Sun, 5 Jul 2026 22:01:44 +0300 Subject: [PATCH] =?UTF-8?q?docs(generator):=20=D0=B7=D0=B0=D0=BA=D1=80?= =?UTF-8?q?=D1=8B=D1=82=D0=B0=20=D0=B7=D0=B0=D0=B4=D0=B0=D1=87=D0=B0=2018?= =?UTF-8?q?=20=D0=B2=20=D1=82=D1=80=D0=B5=D0=BA=D0=B5=D1=80=D0=B5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Зачем: - coordinator-loop отделяет рабочие изменения от статусов и журнала. - Что: - задача 18 переведена в done с закрытыми критериями. - журнал дополнен ревью, проверками чистого маршрута и коммитом. - Проверка: - staged-состав содержит только issue 18 и журнал. --- .../coordinator-journal.md | 38 +++++++++++++++++++ .../18-course-clean-stand-startup-history.md | 14 +++---- 2 files changed, 45 insertions(+), 7 deletions(-) diff --git a/.scratch/generator-model-time-startup-history/coordinator-journal.md b/.scratch/generator-model-time-startup-history/coordinator-journal.md index b52540e..d8209d4 100644 --- a/.scratch/generator-model-time-startup-history/coordinator-journal.md +++ b/.scratch/generator-model-time-startup-history/coordinator-journal.md @@ -514,3 +514,41 @@ gate оставил `clickhouse`, `kafka` running. - 21:32 Issue 17 рабочий коммит: `00c97eb` (`test(generator): усилены проверки startup-history и Superset`). + +- 21:33 Перед issue 18: дерево clean; dependencies 15, 16, 17 закрыты. Issue + 18 запущен worker-у. Режим ревью: обычный; worker reasoning_effort=`medium`; + code review/docs review после реализации `high`. Примечание: runtime gate 17 + оставил `clickhouse`, `kafka` running; worker должен сам очистить или + подготовить стенд перед проверкой курса. +- 21:51 Issue 18: worker вернул `DONE_WITH_CONCERNS`. Индекс: урок 00 + объясняет служебные топики генератора; урок 01 переводит перезаливку + `kafka_msg_ts` на `CLEAN_START=0`; урок 05 согласован с no-live default и + consumer lag; course README добавляет HITL-пункт чистого маршрута 00/01/05; + OPERATIONS ведёт STG-путь через startup-history, `make data` архивный. + Checks worker-а: `make generated-history-analytics` PASS на чистом стенде; + `make up` PASS; SQL-проверка `kafka_msg_ts` + `CLEAN_START=0` PASS + (16054/16054); восстановление схемы PASS; Kafka topics PASS; Prometheus + targets PASS (`generator=0` no-live); `system.kafka_consumers` PASS; + `git diff --check` PASS. Concern: стенд после проверки не свежий из-за + намеренного `CLEAN_START=0`. +- 21:52 Issue 18 code/docs review запущен координатором: свежий + observer-субагент `Hume`, reasoning_effort=`high`, без правок репозитория и + среды. +- 21:53 Issue 18 code/docs review `Hume`: `APPROVED` с medium finding: + урок 05 говорит о трёх Prometheus scrape-блоках, но в `configs/prometheus.yml` + их четыре, включая `generator`; находка возвращена worker-у для короткого + триажа перед коммитом. +- 21:54 Issue 18: worker вернул `DONE` после medium finding. Исправлено: + урок 05 говорит о четырёх scrape-блоках и связывает `generator:9109` с + ожидаемым `DOWN` без live. Checks: `rg` PASS; `git diff --check` по уроку + PASS. +- 21:55 Issue 18 docs narrow rerun отправлен `Hume`: проверить закрытие + medium-находки по Prometheus scrape-блокам. +- 21:55 Issue 18 docs narrow rerun `Hume`: `APPROVED`. Findings: нет. + Chain-level решение: открыть коммит-гейт 18. +- 22:00 Issue 18 commit gate: doc `rg` PASS; `git diff --check` PASS; + `make generated-history-analytics` PASS (manifest profile `ci`, + T_end=`2026-01-01T06:00:00+00:00`, 16054 events); `make up` PASS. Diff в + границах issue 18; журнал не staged. +- 22:00 Issue 18 рабочий коммит: `77e4fb6` + (`docs(course): согласованы уроки со startup-history`). diff --git a/.scratch/generator-model-time-startup-history/issues/18-course-clean-stand-startup-history.md b/.scratch/generator-model-time-startup-history/issues/18-course-clean-stand-startup-history.md index 5823913..b08aa10 100644 --- a/.scratch/generator-model-time-startup-history/issues/18-course-clean-stand-startup-history.md +++ b/.scratch/generator-model-time-startup-history/issues/18-course-clean-stand-startup-history.md @@ -1,4 +1,4 @@ -Status: ready-for-agent +Status: done # Курс проходит по startup-history на чистом стенде @@ -20,19 +20,19 @@ Status: ready-for-agent ## Acceptance criteria -- [ ] Упражнение урока 01 с добавлением `kafka_msg_ts` воспроизводимо на стенде: +- [x] Упражнение урока 01 с добавлением `kafka_msg_ts` воспроизводимо на стенде: повторная заливка данных не сбрасывает схему, которую только что изменил менти. -- [ ] Урок 00 объясняет служебные топики генератора настолько, чтобы список +- [x] Урок 00 объясняет служебные топики генератора настолько, чтобы список топиков не выглядел как набор неожиданных артефактов. -- [ ] Уроки 00 и 05 не противоречат друг другу в описании видимости consumer lag; +- [x] Уроки 00 и 05 не противоречат друг другу в описании видимости consumer lag; утверждение проверено на текущем стенде. -- [ ] Урок мониторинга согласован с no-live default: либо явно запускает live, +- [x] Урок мониторинга согласован с no-live default: либо явно запускает live, либо не обещает, что алерт отсутствия сообщений будет тихим на здоровом стенде без live. -- [ ] Операционная документация не ведёт учебный путь первым делом к архивному +- [x] Операционная документация не ведёт учебный путь первым делом к архивному `make data`; startup-history остаётся основным источником аналитики. -- [ ] Проход уроков 00, 01 и 05 на чистом стенде проверен командно или вынесен +- [x] Проход уроков 00, 01 и 05 на чистом стенде проверен командно или вынесен в явный HITL-пункт с точной инструкцией, что должен подтвердить человек. ## Blocked by