sab.code.lab
1c85091186
Прежняя git-история утрачена при переносе проекта на машину владельца (снапшот без .git). Хэши коммитов в docs/reports/* относятся к утраченной истории. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
53 lines
4 KiB
Markdown
53 lines
4 KiB
Markdown
# План фазы 3: этап 3 — ИИ ур. 1–3, эвристика (packages/ai)
|
||
|
||
Обновлено: 2026-08-05 | Статус: выполнен (gates зелёные; perf chooseMove 19×19 ≈ 8 мс)
|
||
|
||
## Критические долги (реестр — в начале, III.5)
|
||
|
||
- Нет.
|
||
|
||
## Ключевые решения (не пере-решать)
|
||
|
||
- Отдельный пакет packages/ai — core остаётся чистыми правилами (рекомендация
|
||
отчёта сессии 2, принято).
|
||
- ИИ — синхронный чистый вычислитель; воркер появится в этапе 4 (MCTS),
|
||
протокол postMessage фиксируется там же.
|
||
- Случайность — только seeded Rng из core, передаётся параметром (детерминизм
|
||
= воспроизводимые партии и тесты).
|
||
- Легальность — только через applyMove из core; дублирование правил запрещено.
|
||
- Приоритеты и вероятности уровней — по контракту в docs/INTERFACES.md
|
||
(зафиксирован 2026-08-05 до кода).
|
||
- Простая эвристика глаза: все ортогональные соседи — свои камни, без анализа
|
||
диагоналей; осознанно грубо, ручной игры «подложить себе» бот не имитирует.
|
||
|
||
## Объём этапа 3
|
||
|
||
1. packages/ai (@go-learn/ai 0.1.0, зависимость @go-learn/core):
|
||
chooseMove + LEVEL_ATARI_PROBABILITY + типы по контракту.
|
||
2. Внутренние эвристики: поиск групп в атари (groupAt/liberties из core),
|
||
ходы-спасения (>1 дамэ после хода или контрзахват), ходы-захвата,
|
||
фильтр своего глаза, кандидаты nearby (Chebyshev ≤ 2), взвешенный выбор.
|
||
3. Корневой tsconfig: references += packages/ai (без project reference на core —
|
||
TS6310, см. PROJECT_STATE; резолв через workspace-симлинк).
|
||
|
||
## Тесты (гейт приёмки этапа)
|
||
|
||
- Детерминизм: одинаковый seed → идентичная последовательность ходов в полной
|
||
партии бот-бот (два прогона, сравнение SGF или списка ходов).
|
||
- Приоритеты: сконструированные позиции — при rng «всегда 0» (ролл < p)
|
||
бот спасает своё атари / забирает чужое; при rng «всегда 0.99» (ролл ≥ p)
|
||
приоритет пропускается.
|
||
- Фильтр глаза: бот не заполняет свой глаз при наличии других ходов.
|
||
- Легальность: все ходы бота в длинных партиях легальны (property: случайные
|
||
партии бот-бот до двух пасов, seed запинен; ни одного ok:false).
|
||
- Завершение: партия бот-бот 9×9 завершается (over) за разумное число ходов;
|
||
после over вызов chooseMove кидает Error.
|
||
- Perf-smoke: chooseMove на позиции 19×19 средней игры < 200 мс в CI-среде
|
||
(критерий приёмки «ур.3 < 50 мс на среднем ноутбуке» — замер фактический,
|
||
число в отчёте сессии; порог в тесте с запасом, машинно-зависимый).
|
||
- Wiring: orphan-check по экспортам packages/ai.
|
||
|
||
## Критерий выхода
|
||
|
||
Все тесты зелёные + `npm run gates` зелёный. Полная партия 9×9 бот-бот
|
||
завершается корректно (предпосылка критерия приёмки v1 №2 для ур. 5 в этапе 4).
|