docs(generator): закрыта задача 18 в трекере

- Зачем:
  - coordinator-loop отделяет рабочие изменения от статусов и журнала.
- Что:
  - задача 18 переведена в done с закрытыми критериями.
  - журнал дополнен ревью, проверками чистого маршрута и коммитом.
- Проверка:
  - staged-состав содержит только issue 18 и журнал.
This commit is contained in:
2026-07-05 22:01:44 +03:00
parent 77e4fb6119
commit 6d64f3909a
2 changed files with 45 additions and 7 deletions
@@ -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`).
@@ -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