Files
bare/docs/decisions/057-version-marks-dirty-tree.md
T
mayatnikovandClaude Opus 5 383e374f0f iOS: запрет масштабирования, версия в подвале, самообновление, строка ввода
Отзыв с iPhone после первого живого прогона.

Масштабирование запрещено (ADR-066): viewport как в соседнем sixlines плюс
viewport-fit=cover, мета-теги установленного приложения, touch-action против
двойного тапа и страховка на JS — гашение жестов iOS, потому что мета-строку
Safari вправе проигнорировать. Размеры шрифтов не тронуты: 14 px из брифа
остаются, поднимать поля до 16 px владелец отклонил. Цена — доступность
для тех, кому зум нужен — записана в ADR и в ui.md честно.

Версия в подвале (ADR-065, 067): GET /api/config отдаёт короткую ревизию
и время коммита. Именно коммита, а не сборки: штамп компиляции в бинаре
means каждая пересборка даёт новый хеш, и обещание ADR-022 «бинарь собирается
из тега байт в байт» перестаёт проверяться.

Самообновление PWA (ADR-068, 070): в режиме приложения на iPhone перезагрузки
нет, и старая версия жила бы вечно. Проверка при возврате в приложение,
включение ждущей оболочки, перезагрузка — но не тогда, когда в строке набран
текст. Замок от петли сравнивает версию оболочки, а не считает перезагрузки:
счётчик отменял саму фичу, долгоживущая вкладка переставала обновляться.
Замерено: было 30, 60, 120, 240 секунд между релизами, стало ровно 30.

Строка ввода — редактируемый блок (ADR-069): iOS рисует над клавиатурой
полосу со стрелками и «готово» для полей формы, и убрать её со страницы
нельзя. Для contenteditable не рисует. Режим plaintext-only с проверкой,
что он применился, и запасным путём с разбором вставки: невалидное значение
атрибута в части браузеров делает блок нередактируемым вовсе. Чтение
и запись только через textContent, innerHTML в клиенте по-прежнему нет.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015DbCjVfTFq4ZFG8juD45YJ
2026-08-23 15:11:13 +03:00

2.9 KiB
Raw Blame History

ADR-057: bare version помечает сборку из изменённого дерева

Уточняет ADR-022: проверка подлинности бинаря опирается на ревизию, значит ревизия обязана быть честной.

Уточнён ADR-065: чтение build info переехало в internal/build, ревизия печатается короткой и рядом с временем коммита; +dirty и unknown — как здесь. Формат стал проверяемым тестом — разбор build info отделён от debug.ReadBuildInfo; сама простановка vcs.* по-прежнему проверяется руками.

Контекст

docs/threat-model.md называет единственное смягчение против активно-злонамеренного оператора: «статика внутри бинаря, хеш которого сверяется со сборкой из тега: подмену можно заметить». docs/deploy.md доводит это до двух проверок после деплоя — sha256sum на сервере и bare version.

revision() брала из debug.ReadBuildInfo() первое значение vcs.revision и печатала его как есть. Рядом лежит vcs.modified, и его никто не читал: бинарь, собранный из дерева с правками, печатал чистый хеш коммита, к которому его содержимое отношения не имеет. При этом scripts/deploy.sh собирает именно рабочее дерево — штатный путь деплоя такие бинари и порождает.

Решение

  • revision() читает vcs.modified вместе с vcs.revision. При vcs.modified = true к хешу дописывается +dirty.
  • Ревизии нет вовсе — прежнее unknown.
  • Строка про версию бинаря в docs/deploy.md говорит то же.

Следствия

  • Сверка «хеш файла на сервере против сборки из тега» перестаёт молча проходить для бинаря из грязного дерева: bare version называет его грязным раньше, чем сойдётся или не сойдётся sha256sum.
  • Релиз, собранный из чистого тега, печатает прежнюю строку — привычка не ломается.
  • Проверять это в тесте нечем: vcs.* появляется только у собранного бинаря, а go test их не проставляет. Проверка ручная, она в docs/deploy.md.