revise August 2021 storage contract articles

editorial/reviews/2021-08-draft.md

@@ -0,0 +1,158 @@
+# Автономное тройное ревью П42 · август 2021 · «Контракт хранилища»
+
+Статус: **принята к публикации после независимой интеграции**. Изначально
+registry и Git автономным пакетом не менялись.
+
+Пакет заменяет через overlay только три стабильных slug:
+
+- <code>editorial-2021-08-practice-storage-contracts</code>;
+- <code>editorial-2021-08-mechanism-storage-contracts</code>;
+- <code>editorial-2021-08-field-storage-contracts</code>.
+
+Созданы ровно пять файлов П42:
+
+- <code>web/scripts/upgrade-2021-08.mjs</code>;
+- <code>web/public/assets/editorial/2021/storage-contract-compatibility-2021.svg</code>;
+- <code>web/public/assets/editorial/2021/storage-contract-evolution-2021.svg</code>;
+- <code>web/public/assets/editorial/2021/storage-contract-diagnosis-2021.svg</code>;
+- этот документ.
+
+Revision-модуль экспортирует только изменяемые редакционные поля. В нём нет
+<code>date</code>, <code>author</code>, registry import или изменения
+<code>articles.json</code>. Fixture использует только Array, Map и objects в
+одном Node-процессе; не запускает БД, broker, реальные файлы, сеть, provider,
+миграционный job или сервис.
+
+## Проход 1. Структура, тон и объём — пройдено
+
+| Revision | Ситуация и цена в первых двух абзацах | M4 и практическая граница | Объём body |
+| --- | --- | --- | --- |
+| Практика | Новый <code>timezone</code> смешивается с absent/null; цена — запись, которую старый reader трактует иначе | owner, поддержка старых pair и reader-before-writer rollout | **10 574** знака body |
+| Механизм | Reader принял форму, но не смог объяснить значение; цена — закреплённая догадка вместо договора | type, presence, narrowing и semantic break разделены | **11 259** знаков body |
+| Полевой разбор | Reader упал после записи; цена — потеря evidence при поспешном rollback | evidence, stop criterion и rollback-safe действия | **10 349** знаков body |
+
+- У всех трёх текстов есть ситуация и стоимость ошибки в первых двух абзацах,
+  таблица, привязанный SVG с содержательными <code>alt</code>/<code>figcaption</code>,
+  рабочие JS-фрагменты, нумерованный маршрут, ограничения и отдельный раздел
+  источников.
+- Голос М4 августа 2021 года: короткая инженерная речь «симптом → причина →
+  проверка → действие», явный owner и граница между reader, writer и contract.
+  Текст не изображает автора владельцем platform/SLA или реальной migration
+  program.
+- Удалены универсальные формулы о «современном подходе»: каждое обобщение
+  привязано к profile.settings, matrix или fixture.
+
+Вердикт: **пройден**. <code>audit:draft</code> подтвердил диапазон 5 000–15 000
+знаков и наличие sections, table, figure, code, route, sources и локального
+asset у каждого revision.
+
+## Проход 2. Техника, source boundaries и fixture — пройдено
+
+| Граница | Что утверждает пакет | Как это проверяется | Чего пакет не утверждает |
+| --- | --- | --- | --- |
+| JSON object | reader читает именованные key, а не их позицию | reordered v2 record даёт тот же нормализованный result | одинаковый порядок во всех parser или storage |
+| Optional field | absent, <code>null</code> и строка — разные states | v1 → v2 даёт absent; v2 clear даёт explicit-null | absent всегда должен означать clear |
+| Additive change | v2 добавляет only optional <code>timezone</code> | v2 writer → v1 reader и v1 writer → v2 reader зелёные в matrix | любой новый key безопасен для любого consumer |
+| Breaking changes | narrowing, semantic change и required timezone отвергаются | три отдельные negative matrix assertions | generic JSON сам даёт эволюционную совместимость |
+
+Первичные и официальные источники ограничивают историческую рамку:
+
+- [RFC 8259](https://www.rfc-editor.org/rfc/rfc8259.html) для JSON object,
+  literal <code>null</code> и отсутствия переносимого договора о порядке
+  object members;
+- [JSON Schema draft 2019-09 Validation](https://json-schema.org/draft/2019-09/draft-handrews-json-schema-validation-02), официальный опубликованный Draft от 17 сентября 2019 года (не IETF RFC),
+  для vocabulary structural assertions и типа <code>null</code>;
+- [Apache Avro 1.10.2 Specification](https://avro.apache.org/docs/1.10.2/spec.pdf)
+  для ограниченного, форматно-зависимого примера writer/reader schema resolution.
+
+<code>runStorageContractFixture()</code> создаёт v1, additive v2, v2 clear,
+legacy <code>daily</code>, type error и семь направлений matrix. Она требует
+тринадцать истинных assertions: v1/v2 reads, additive direction, absent versus
+explicit null, order independence, required-field rejection, type rejection,
+narrowing, semantic and presence break. Функция не вызывает файловую систему,
+сеть, БД, broker или внешний API.
+
+Вердикт: **пройден**. Технические claims ограничены fixture и указанными
+документами; format-specific Avro rules не переносятся на generic JSON.
+
+## Проход 3. Фактическая точность, SVG и preflight — пройдено
+
+- Во всех SVG есть <code>title</code>, <code>desc</code> и
+  <code>role="img"</code>. В схемах показаны только contract-level шаги:
+  compatibility directions, reader-before-writer evolution и diagnostic tree.
+  Статическая safety-проверка не нашла <code>script</code>,
+  <code>foreignObject</code>, внешние asset URL или raster data URI. Тексты,
+  стрелки и карточки рассчитаны на статичный просмотр, а не заменяют browser
+  или screen-reader проверку.
+- Первый Sharp-рендер обнаружил два настоящих дефекта: длинная подпись
+  выходила за правую границу в evolution SVG, а четыре узкие ветви diagnosis
+  SVG плохо читались на 375 px. Заголовок и нижняя подпись evolution сокращены;
+  diagnosis перестроен в четыре широкие карточки. После правки повторный
+  375 px рендер просмотрен вручную: clipping, overlap и horizontal overflow
+  внутри трёх схем не обнаружены.
+
+### Команды preflight
+
+<pre><code>cd web &amp;&amp; node --check scripts/upgrade-2021-08.mjs
+cd web &amp;&amp; npm run audit:draft -- scripts/upgrade-2021-08.mjs
+cd web &amp;&amp; node scripts/upgrade-2021-08.mjs --verify-fixture
+cd web &amp;&amp; xmllint --noout \
+  public/assets/editorial/2021/storage-contract-compatibility-2021.svg \
+  public/assets/editorial/2021/storage-contract-evolution-2021.svg \
+  public/assets/editorial/2021/storage-contract-diagnosis-2021.svg</code></pre>
+
+### Финальные фактические результаты
+
+Проверки выполнены 31 июля 2026 года после всех правок:
+
+| Проверка | Реальный результат |
+| --- | --- |
+| <code>node --check</code> | PASS, code 0 |
+| <code>npm run audit:draft</code> | PASS: **10 574 / 11 259 / 10 349** знаков body; у всех трёх slug есть table, figure, code, route, sources и локальный SVG |
+| In-memory fixture | PASS: **13/13** assertions истинны; зелёные v1/v2 направления и три отрицательные matrix-пары проверены |
+| <code>xmllint --noout</code> | PASS, три SVG — корректный XML |
+| SVG safety scan | PASS: не найдены active tags, <code>foreignObject</code>, внешние assets или raster data URI |
+| Sharp mobile preflight | PASS: три финальных PNG шириной 375 px вручную просмотрены после правки; нет clipping, overlap или horizontal overflow |
+| Scope/self-review | PASS: П42 создала только пять разрешённых файлов; registry, README, <code>articles.json</code>, audit scripts, общие правила/очередь и Git не менялись; mascot PNG не затрагивались |
+
+<code>npm run audit:draft</code> вывела старые предупреждения пользовательской
+конфигурации npm о <code>store-dir</code>, <code>cache-dir</code> и
+<code>public-hoist-pattern</code>. Они не относятся к П42 и не изменялись.
+
+Integration registry audit, production build, browser, реальное storage,
+migration, CI, commit и push намеренно не запускались: они находятся за
+границей автономной П42.
+
+Выпусковой вердикт автономной партии: **готова к независимой интеграции**.
+
+## Независимая редактура и интеграция · 31 июля 2026
+
+Основной редактор провёл ещё один технический и исторический проход.
+
+1. Assertion `genericJsonDoesNotBypassTheContract` дублировал проверку
+   `timezone: 3`. Его заменили на отдельный случай: синтаксически корректное
+   JSON-значение <code>emailDigest: "hourly"</code> не входит в договор и
+   отклоняется reader v1. Так fixture различает форму JSON и доменное
+   перечисление, не увеличивая формальное число assertions.
+2. Источник JSON Schema уточнён как официальный опубликованный Draft 2019-09
+   от 17 сентября 2019 года, а не IETF RFC. Avro 1.10.2 дополнительно
+   сверена по официальному анонсу выпуска от 15 марта 2021 года. Оба источника
+   существовали к августу 2021-го; правила Avro по-прежнему не переносятся на
+   generic JSON.
+3. Все три SVG повторно просмотрены после независимого Sharp-рендера на 375 px:
+   читабельны направления совместимости, порядок rollout и четыре ветви
+   диагностики; clipping, overlap и overflow не обнаружены.
+
+| Проверка | Результат независимого прохода |
+| --- | --- |
+| `node --check` и draft gate | PASS: **10 574 / 11 259 / 10 349** знаков body |
+| Fixture | PASS: 13/13; есть отдельные проверки absent/null, type, допустимого формата с недопустимым enum, narrowing, semantic и presence break |
+| `xmllint` и SVG safety scan | PASS: три XML-диаграммы корректны; не найдены script, foreignObject, внешние URL или raster data URI |
+| Strict audit через registry | PASS: 1 figure, 2 table и 3–4 code examples в каждой revision; объёмы **10 574 / 11 259 / 10 349** |
+| Production build | PASS: Next.js сгенерировал 374 статические страницы |
+
+Три revision подключены к `web/data/editorial-revisions.mjs`; архив остаётся
+владельцем stable slug, даты и автора. После интеграции строгий охват —
+**130 из 358**, осталось **228** материалов.
+
+Финальный вердикт: **ACCEPTED FOR PUBLICATION**.