Files
transcriber/tasks/items/docs-consistency-2026-08-13.md
T
av eacaf76d5f tasks: заведён остаток работы о гейте, контексте и токене
- четыре новые записи: проверить шаг migrations так же, как шаг сверки версий Go;
  свести шесть расхождений между документами канона; запретить обращаться к Bot
  API мимо клиента бота; разведка о шагах гейта, теряющих предмет
- context-cancel-in-pipeline приведена к правде: дописан перечень сделанного
  попутно, критерий с оракулом «тест на трёх прерываниях подряд» разбит надвое —
  проверена была только его узкая половина
2026-08-13 10:55:38 +03:00

5.1 KiB
Raw Blame History

🧹 Свести шесть расхождений между документами канона

  • Тип: chore
  • Категория: Очередь — Находки одной сверки: чинится одним заходом, пока помнится, чем каждое место было найдено.
  • Зачем: Сверка 2026-08-13 нашла шесть мест, где два документа отвечают на один вопрос по-разному; четыре из них в architecture.md, и по ним читатель строит решения о выкладке и о периметре.

Находки сверки документов агентами doc-consistency и doc-code-drift, прогнанной 2026-08-13 вместе с работой о контексте и токене. К той работе расхождения отношения не имеют — они старше, и потому не чинились тем же коммитом.

Каждое место названо с домом факта, то есть с тем документом, который прав:

  1. Панель администратора против Authelia. architecture.md, «Открытые вопросы»: «Панель администратора Authelia не закрывает». security.md, «Периметр»: адрес /_/ закрывает Authelia на обратном прокси решением от 2026-08-11. Дом — security.md.
  2. Провайдер OIDC не назван внешней зависимостью. Работает с 2026-08-12, у него два таймаута в database.md и нормативная спека access, но в таблице зависимостей architecture.md его нет, а языковая модель числится там «пятой зависимостью». Дом — architecture.md, править его.
  3. «Таймаута нет ни у одного обращения наружу» (architecture.md, «Эксплуатация») против таймаутов обмена кода у провайдера в database.md и требования спеки access. Верно узкое утверждение: таймаутов нет у Telegram, Object Storage и SpeechKit. Дом — database.md.
  4. gin в README.md. Веб-фреймворка нет: HTTP-поверхность — роутер встроенной PocketBase, и logging.md прямо говорит, что вместе с gin ушёл и sloggin. Дом стека — CLAUDE.md.
  5. Вид временной метки. conventions/database.md: RFC 3339 с T, секундная точность. docs/database.md: 2006-01-02 15:04:05.000Z, и вид обязателен побайтово — сравнение в SQLite строковое. Дом — docs/database.md; конвенции нужна строка «Расхождение:».
  6. Дубли текста в CLAUDE.md — подавления hadolint и настройка errcheck пересказаны там дословно, хотя обе преамбулы договорились, что дом перечня подавлений — go-linters.md.

Затрагивает

  • docs/architecture.md — «Открытые вопросы», таблица внешних зависимостей, раздел «Эксплуатация»;
  • docs/conventions/database.md — вид временной метки;
  • docs/security.md и docs/database.md — как дома фактов, если правка потребует уточнить формулировку;
  • README.md — перечень технологий;
  • CLAUDE.md — раздел «Гейт», два места с пересказом.

Критерии приёмки

  • Ни одно из шести мест не отвечает на свой вопрос двумя способами. Оракул — повторный прогон av-dev-docs:healthcheck: перечисленные шесть находок не возвращаются.
  • Провайдер OIDC стоит в таблице внешних зависимостей со своими четырьмя столбцами отказа, и счёт зависимостей в «Открытых вопросах» сходится с таблицей. Оракул — чтение таблицы: число строк против числа в тексте.
  • Дрейф раскладки и битые ссылки не заведены. Оракул — task gate зелёный (шаг docs).

Рамки

Правится текст документов, а не поведение сервиса: если расхождение окажется дефектом кода, оно уезжает своей задачей, а не чинится здесь. Спеки openspec/specs/ не трогаем — у них свой порядок изменения.