ShiZa/go-learn
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
go-learn/docs/decisions/ADR-0003-build-position.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

2.3 KiB
Raw Blame History

ADR-0003: buildPosition в core + разметка цели CR вместо MA (этап 6)

Дата: 2026-08-06. Статус: принято.

Контекст

Этап 6 (уроки и цумэ-го) требует стартовать задачу с произвольной позиции. План-фаза 6 фиксировала «packages/* не трогаем», но аудит выявил два пробела контракта:

  1. parseSgf (этап 1) не поддерживает setup-свойства AB/AW — произвольную позицию из SGF не собрать, а конструировать BoardState вручную вне core опасно (positionHashes для суперко считает внутренний hashPosition).
  2. NodeMarkup не содержит стрелок MA (только LB/TR/SQ/CR) — разметка цели «connect» по контракту была невыразима.

Решение

  1. В packages/core добавлена ОДНА аддитивная функция buildPosition(size, black, white, toPlay) (board.ts, экспорт через index.ts): валидация (вне доски / дубли / группа без дамэ → Error), корректный positionHashes. Поведение существующих функций не меняется, зона core в остальном заморожена.
  2. Разметка цели connect в задачах — CR (круги) вместо MA; контракт INTERFACES.md обновлён. SGF задачи хранит позицию данными JSON (setupBlack/setupWhite), а SGF-поле несёт только дерево вариантов (B/W-ходы от стартовой позиции, TR/CR-разметку цели на корневом узле).

Последствия

  • Позиция задачи: JSON-поля setupBlack/setupWhite + buildPosition; дерево вариантов парсится parseSgf и накатывается applyMove на построенную позицию.
  • При расширении parseSgf поддержкой AB/AW в будущем формат можно упростить до чистого SGF (миграция контента, отдельной задачей).