sab.code.lab
1c85091186
Прежняя git-история утрачена при переносе проекта на машину владельца (снапшот без .git). Хэши коммитов в docs/reports/* относятся к утраченной истории. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
4.9 KiB
4.9 KiB
Отчёт сессии 5 (для следующей сессии)
Дата: 2026-08-05 | Ветка: main | Этап 5 (игровой интерфейс) — завершён
Что сделано
- Контракты этапа 5 в docs/INTERFACES.md до кода: схема localStorage (конверт version+checksum FNV-1a, SettingsV1, recovered при битом состоянии) и AiClient (ур. 1–3 синхронно, ур. 4–6 воркер, cancel=terminate+recreate, fail-safe синхронный фолбэк с пометкой).
- apps/web (Astro 5.18.2, static, vanilla TS + DOM):
- lib: storage.ts, ai-client.ts, game-store.ts (чистый: фазы playing/scoring/viewer, гонка requestId, undo пары ходов, подсчёт с toggle мёртвых, SGF-просмотр), territory.ts (карта территории для заливки);
- страницы: / (визитка) и /play (канва + полная панель: размер/уровень/ цвет/коми, чекбоксы, Пас/Сдаться/Отменить/Новая, счётчики пленников, статус-строка с причинами MoveError, предупреждение 19×19 при ур. 4–6, подсказки топ-3 с winRate и дельтой, скачивание/загрузка SGF);
- ui/strings.ts — все строки UI одним файлом; тёмная тёплая тема, адаптивность.
- Тесты: 147/147 (+29: storage 7, ai-client 5, game-store 12, territory 3, wiring 2), lint 0 warnings. astro build PASS, dist 80K, worker-chunk 9.75 kB. Браузерный смоук исполнителем: рендер доски, пас + ответ бота, hidden-состояния.
- Интеграционная правка main loop: astro 5.18.2 (MIT) добавлен в THIRD_PARTY_LICENSES.md — лицензионный гейт.
Принятые отклонения (задокументированы исполнителем)
- Astro 5.18.2 вместо 7.1.6: astro 6/7 требуют Node ≥22.12 (hardcoded в bin), окружение Node 20.20.2. Записано в PROJECT_STATE.
- AiClient.fallback: boolean и StorageLike-инжекция в storage — дополнения контрактов, поведение не меняют.
- eslint.config.js/.prettierignore/.gitignore +=
**/.astro/.
Что НЕ сделано
- Этапы 6–9 не начаты.
- Ручная приёмка: критерии v1 №2 (партия vs ур.5 до подсчёта) и №5 (мобильный Safari) — владельцем; визуальный смоук кадра — по матрице plan-phase-2.
Подводные камни для следующей сессии (этап 6)
- Среда: worktree в $HOME, пересоздание, коммитить всё; контракты дублировать
в задании; docs через prettier; project references не добавлять;
.astro/в игноре — не пугаться генерируемого каталога. - suggestDeadGroups грубовата (предлагает живые группы на разрежённых позициях) — при работе с уроками «жизнь и смерть» это станет заметно; кандидат на уточнение (через ADR, зона core).
- Строки UI — только через ui/strings.ts, новые строки туда же.
- Worker-chunk собирается Vite; при изменении packages/ai/src/worker.ts пересобирать apps/web.
С чего начать продолжение
Этап 6 (курс + цумэ-го):
- Контракт форматов в docs/INTERFACES.md ДО кода: схема Markdown-урока (разделы → уроки → шаги), формат интерактивной задачи (SGF-позиция + условие успеха, проверяемое движком — не хардкод координат), схема localStorage прогресса курса (version + checksum, ключ go-learn:progress).
- Программа по спеке: дамэ/захват → атари/лестница/сеть → самоубийство и ко → глаза, жизнь и смерть, ложный глаз → подсчёт/пас/конец → связь/разрезание → углы-стороны-центр → 3–4 базовых дзёсэки → форма → простое ёсэ.
- Цумэ-го ≥30 задач, фильтры, свободная лицензия с атрибуцией (CREDITS.md) либо формат импорта.
- «Мой прогресс»: уроки, задачи, серия дней.
- Создать docs/plans/plan-phase-6.md.