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

- **Задание:** `../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 как сожжённые.
Альтернатива — не упоминать их вовсе. Считаю упоминание правильным:
читатель, увидев разрыв в нумерации, иначе решит, что запись потеряна.
