Восемнадцатая партия бэклога: запись с прежним текстом сообщения и сверка зеркал

[keyfire]

Два пункта бэклога: запись списка принятых перестаёт совпадать, когда правило меняет текст сообщения, и никто не сверяет зеркала страниц сайта документации с их источниками.

Запись с прежним текстом сообщения

Запись списка принятых опознаётся по файлу, правилу и тексту сообщения, а текст принадлежит правилу. Одно из правил недавно изменило формулировку, и на живом проекте принятая находка с причиной вернулась как новая, а её запись стала устаревшей.

Теперь у сопоставления есть второй проход. Запись, которую не израсходовал точный текст, удерживает находку того же правила в том же файле, если выполнены оба условия:

• текст записи не подходит ни под одну нынешнюю формулировку правила ни на одном языке;
• в нём стоят значения, которые называет находка, в тех же кавычках и в том же порядке.

Второе условие отсекает чужие находки: имя в кавычках служит опознавательным признаком, а одиночная буква нет. Первое не даёт записи с нынешним текстом удержать другую находку. Так бывает у правила с двумя сообщениями, где у одного значений больше: исчезнувшая длинная находка не прикроет появившуюся короткую. Сообщение без значений сопоставляется только по тексту, потому что две такие находки нечем различить.

Проверка называет такие записи: строкой в текстовом отчёте, ключами baseline_reworded и baseline_reworded_entries в сводке json и в ответе MCP lint_paths. --write-baseline записывает находку под новым текстом и переносит причину записи. Страница linting в обеих редакциях говорит об этом.

Зеркала страниц документации

scripts/sync-docs.mjs копирует README расширения и журналы изменений в docs/, а сборка сайта делает свои копии. Поэтому отставшее зеркало видно только на GitHub: одно отстало на два абзаца и нашлось случайно. Задача docs в CI теперь запускает генератор после генераторов страниц команд и включает зеркала в git diff --exit-code.

Проверки

• Новые тесты tests/test_baseline_reworded.py сначала падали: у apply не было параметра reworded, находка не удерживалась, причина при перезаписи терялась. Среди них есть тесты на отказ: другие значения, другой порядок, запись с нынешним текстом другого сообщения, сообщение без значений.
• На корпусе в 1467 файлов со своим списком принятых отличие от main одно: запись с прежним текстом удержала свою находку. Других совпадений второй проход не дал.
• Сверка зеркал на чистом дереве проходит, а после правки README без запуска генератора падает.
• Имитация публичного клона без данных: 2473 пройдено. langguard, purity_scan и check_docs с каталогом данных – ноль замечаний.