go-learn/docs/reports/session-11.md
sab.code.lab 1c85091186 chore: восстановление репозитория из снапшота v0.3.1
Прежняя git-история утрачена при переносе проекта на машину владельца
(снапшот без .git). Хэши коммитов в docs/reports/* относятся к утраченной
истории.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-07 09:34:02 +02:00

7.9 KiB
Raw Permalink Blame History

Отчёт сессии 11 — этап 11: аудит контента, страница «Источники», дисклеймер

Дата: 2026-08-07. Ветка main: 32199a6 → 66dc7a5 (+docs(sync)). Версия 0.3.1.

Вводные

Владелец спросил, насколько можно доверять обучающему контенту, и принял решение: (1) обязательный аудит курса по авторитетным источникам; (2) отдельная страница «Источники» — только голые проверяемые факты, что не нашли — честно «не найдено», выдумывать КАТЕГОРИЧЕСКИ ЗАПРЕЩЕНО; (3) дисклеймер об открытом редактировании. Железное правило зафиксировано в INTERFACES.md (этап 11).

Что сделано

  1. Контракт (INTERFACES.md, «Аудит контента, страница „Источники“, дисклеймер (этап 11)», 4b6bf80): правило реально открытых URL с цитатой, формат отчётов и страницы, приёмка с выборочной перепроверкой оркестратором.
  2. Аудит — 3 параллельных research-агента (ветки audit/r1..r3, слиты --no-ff; отчёты docs/audit/01-03.md, 04-07.md, 08-10.md):
    • 85 проверяемых утверждений: 70 подтверждено, 10 расхождений, 5 не найдено. Источники: правила AGA (зеркала BGA и cs.cmu.edu), Sensei's Library, rusgolib.gofederation.ru.
    • Каждое подтверждение — URL + дословная цитата из реально открытой страницы.
  3. Перепроверка оркестратором (приёмка контракта): открыто и сверено с цитатами 5 URL из отчётов (Atari, Calling Out Atari, Ladder, Bamboo Joint, Dango — все Sensei's Library); дополнительно curl'ом подтверждены ключевые для правок страницы ChineseRules (коми 7.5, cost 0), Komi и 34PointHighApproachAttachDrawbackJoseki (цукэ-хики). Часть страниц SL/BGA в момент проверки отвечала таймаутами — то же наблюдали аудиторы.
  4. Дисклеймер (32199a6): примечание на /learn.html («курс создан с помощью ИИ и находится в открытом редактировании…») со ссылкой на «Источники»; пункт «Источники» в футере.
  5. Страница /istochniki.html (218c292): 8 тематических разделов, формат «факт одной строкой — ссылка на первоисточник», 50 ссылок (все — только из аудит-отчётов, target="_blank" rel="noopener"), обязательный честный раздел «Что пока не удалось подтвердить» (5 пунктов). Строки вынесены в strings.ts (раздел sources).
  6. Правки уроков по подтверждённым расхождениям (218c292, 9 файлов):
    • урок 01: «атари» вслух — практика обучающих партий, опытные не объявляют;
    • урок 02: атари вынуждает, но не обязывает отвечать; «сирэ» → «ситё-прерыватель» (ladder breaker);
    • урок 03: нелегальный ход по AGA отменяется и засчитывается как пас;
    • урок 05: ход в свою территорию — 1 очко только по японским правилам, по китайским (нашим) счёт тот же; про коми добавлено: наши 6,5/5,5, стандарт китайских — 7,5;
    • урок 06: изолированное косуми локально неразрезаемо (миаи);
    • урок 07: неподтверждённые числа камней → канонические «стены 2/3/4»; убран термин «линия смерти»;
    • урок 08: «ханэ у подошвы 3-4» → цукэ-хики с верными ролями цветов (цукэ/хики — чёрные, ханэ — белые);
    • урок 09: «танэки» → «такэфу»; «столб» → «данго» (пельменная форма); диаграммы тигровой пасти и бамбука приведены к собственному тексту;
    • урок 10: убран неподтверждённый диапазон «13 очка» и суперлатив «самый частый приём».

Проверки

  • gates: 467/467 (28 файлов), format+lint+typecheck зелёные — прогон оркестратором в чистом worktree на merge-коммите 66dc7a5.
  • Сборка: 19 страниц, dist/istochniki.html на месте; eager-вес страницы источников ~38 КБ (HTML 20 КБ + общий CSS 18 КБ) — бюджет ≤300 КБ с большим запасом.
  • Скриншот-проверка /istochniki.html в браузере: шапка, разделы, ссылки — в порядке.
  • Контрактная перепроверка ≥5 URL — выполнена (см. выше).

Доставка

  • dist → /mnt/agents/output/app (rsync с --exclude=.git), сохранена новая версия превью (website_version_manager, id 70226a8).

Опыт сессии

  • Sensei's Library периодически отвечает таймаутами на web_open_url — аудиторам и оркестратору стоит делать повторы и дублировать проверку curl'ом; недоступность источника фиксировать честно («не найдено»).
  • Аудит-отчёты от субагентов пришли неформатированными — prettier --check падал; механическая нормализация docs/audit/*.md (только формат, без изменения текста) включена в коммит 218c292.

Открыто

  • Расхождение коми: движок и INTERFACES.md держат 6,5 (19×19) по решению владельца от 2026-08-05, а стандарт китайских правил — 7,5. Урок теперь честно разводит «наши партии» и «стандарт». Сменить ли дефолт движка на 7,5 — отдельное решение владельца (затронет контракт, тесты подсчёта, сохранённые партии).
  • Поле order во frontmatter уроков у всех = 1 (не используется; порядок — по id). Либо проставить 1..10, либо убрать из схемы.
  • Тексты кикеров этапа 10 частично живут в разметке (помечены «до переноса в strings.ts»).
  • Этап 8.2 (OAuth VK ID / Yandex ID) ждёт ключи приложений от владельца; дизайн — docs/design/oauth-vk-yandex.md. Иностранные провайдеры запрещены.
  • Этап 9 (KataGo ONNX) заморожен; деплой на хостинг и ручная приёмка — «немного попозже» (владелец).