feat(generator): добавлен артефакт стартовой истории

- Зачем:
  - чистый стенд должен восстанавливать стартовую историю без повторной генерации.
- Что:
  - добавлены export/import артефакта через Kafka и compact-топики.
  - добавлена manifest-aware сверка ClickHouse и защита от смешения state.
  - добавлен runbook использования стартовой истории.
- Проверка:
  - uv run --with-requirements generator/requirements.txt pytest generator/tests -q.
  - bash -n scripts/check_startup_history_manifest.sh scripts/export_startup_history_artifact.sh scripts/import_startup_history_artifact.sh.
  - git diff --check.

generator/README.md

@@ -78,6 +78,7 @@ generator-service -> Kafka topics -> (потребители отдельно)
 | `GEN_MODEL_TIMEZONE` | Часовой пояс модельных часов для дневного коэффициента | `UTC` |
 | `GEN_MODEL_TIME_SPEED` | Сколько модельных секунд проходит за одну настенную секунду | `1` |
 | `GEN_RUN_MODE` | Режим генератора | `live` |
+| `GEN_STARTUP_HISTORY_ARTIFACT` | JSON-файл для экспорта стартовой истории в режиме `backfill` | — |
 | `GEN_DATA_DIR` | Путь к JSONL файлам | `/data` |
 | `GEN_SEED` | Сид для воспроизводимости | — |
 | `GEN_ENABLED` | Включить генерацию | `true` |
@@ -104,6 +105,8 @@ GEN_LAMBDA_BASE_PER_MIN=60 GEN_POPULATION_MAX=500 docker compose up -d generator
 на `T_end` в `generator_state` и пишет manifest в compact-topic
 `generator_startup_history_manifest`. Live-запуск с теми же настройками
 использует этот manifest, чтобы продолжить ровно с `T_end` без настенной дельты.
+Экспорт и импорт портативного файла описаны в
+[`docs/runbooks/startup-history.md`](../docs/runbooks/startup-history.md).
 Для одноразового backfill-запуска через compose используйте `docker compose run
 --rm generator`, а не `docker compose up generator`: у штатного сервиса включён
 restart policy.