ochenstarik/server-monitor-manager
1
0
Fork 0
Code Issues Pull requests 6 Projects Releases 17 Packages Wiki Activity Actions
server-monitor-manager/agents/claude/done/2026-08-20-docs-sync.md
Ochenstarik 1e6348ff2b docs: восстановить историю релизов в CHANGELOG, policy и roadmap 
CHANGELOG обрывался на alpha.6 от 2026-07-31 при тегах до alpha.20.
Дописаны 14 версий по тегам и коммитам между ними; даты сверены с датами
тегов, расхождений нет. Сожжённые alpha.10, alpha.11 и alpha.19 помечены
как несопубликованные с указанием, чем упал пайплайн. Для опубликованных,
но дефектных версий записан сам дефект, иначе CHANGELOG подсказывал бы
ставить версию, которая не ставится.

В release-policy добавлена запись про alpha.20. В roadmap дописано
фактически поставленное: веб-консоль и её разделы, режим полного удаления
сервера, объединённый установщик.

README и переводы намеренно не тронуты: по release-policy строка статуса
релиза принадлежит владельцу релиза, изменение запрошено заданием Codex.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-20 16:36:40 +07:00

5.4 KiB
Raw Blame History

Отчёт: документация приведена в соответствие с историей релизов

  • Задание: ../inbox/2026-08-20-docs-sync.md
  • Агент: claude
  • Дата: 2026-08-20
  • Ветка: claude/deps-update

Что сделано

CHANGELOG.md. Дописаны 14 отсутствовавших версий, alpha.7 … alpha.20. Записи выведены из тегов и коммитов между ними, а не из памяти. Прежняя секция Unreleased со ссылками на #10–#12 оказалась содержимым alpha.7 — перенесена туда. Новый Unreleased описывает слитое после alpha.20: #63, #64, #44, #46. Ссылки сравнения версий перестроены для всех 20 тегов.

Сожжённые номера помечены прямо в заголовке — burned, not published — с указанием, чем упал пайплайн и под какой версией вышло их содержимое:

  • alpha.10 и alpha.11 — пайплайн упал до публикации;
  • alpha.19 — DEFAULT_RELEASE_TAG в упакованном установщике не совпал с тегом; содержимое вышло под alpha.20.

Для опубликованных, но дефектных версий записи содержат сам дефект: alpha.8 (осиротевшая подпись без manifest v2), alpha.12 и alpha.13 (подпись без сертификата Fulcio), alpha.14 (проверяемая, но не устанавливаемая на чистый хост), alpha.15 … alpha.17 (на чём остановилась проверка). Иначе CHANGELOG подсказывал бы ставить версию, которая не ставится.

docs/release-policy.md. Добавлена запись про alpha.20 — что он исправляет, что переносит из сожжённого alpha.19.

docs/roadmap.md. Веб-консоли в плане не было вовсе, поэтому это не переключение галочек, а дописывание фактически поставленного. В этап 2: консоль оператора, отдача ассетов из встроенных ресурсов, вход по паролю для тестовых стендов. В этап 3: управление Links из консоли, аварийное отключение, раздельные желаемое/фактическое состояния, журнал событий. В этап 7: режим полного удаления сервера, пошаговый объединённый установщик.

Как проверено

Все 20 версий на месте:

$ grep -c "^## \[v0.1.0-alpha" CHANGELOG.md
20

Даты записей сверены с датами тегов — расхождений нет:

$ for n in $(seq 1 20); do t="v0.1.0-alpha.$n"; ... done
v0.1.0-alpha.1     2026-07-16  2026-07-16  совпадает
...
v0.1.0-alpha.20    2026-08-18  2026-08-18  совпадает

Двадцать строк, все «совпадает».

Что не сделано

README и одиннадцать переводов не тронуты намеренно. README.md:101 по-прежнему называет v0.1.0-alpha.14. docs/release-policy.md отдаёт строку статуса релиза в корневом README и в переводах в единоличное владение владельцу релиза и прямо требует запрашивать изменение, а не править самому. Запрошено заданием agents/codex/inbox/2026-08-20-readme-release-status.md.

Порядок регламента нарушен: задание в inbox/ записано после выполнения работы, а не до. Указываю прямо, чтобы это не выглядело соблюдённым.

Замечено рядом

  1. README.md:101 и переводы — предмет выданного задания Codex.
  2. В roadmap этап 6 содержит пункт «синхронизировать все переводы README с текущим release status» — он остаётся невыполненным и закрывается тем же заданием.
  3. Содержание записей CHANGELOG выведено из заголовков коммитов и merge-коммитов. Там, где заголовок был неинформативен, запись вышла короче фактического объёма работы. Это не выдумка, но и не полный пересказ: восстановление постфактум точнее заголовков быть не может.

Вопросы к приёмке

Записи alpha.10, alpha.11 и alpha.19 оставлены в CHANGELOG как сожжённые. Альтернатива — не упоминать их вовсе. Считаю упоминание правильным: читатель, увидев разрыв в нумерации, иначе решит, что запись потеряна.