M1 «Вертикальный срез» — план реализации

For agentic workers: REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (- [ ]) syntax for tracking.

Goal: Первая играбельная партия в браузере: новая игра → карта → движение → основание города → обработка клеток → производство → конец хода → простой ИИ → сохранение/загрузка.

Architecture: Чистое детерминированное ядро @territory/core (состояние — JSON, изменения — команды, случайность — сид в состоянии). Данные правил — @territory/content (типы из core). ИИ — @territory/ai отдаёт команды тем же путём. @territory/sim гоняет партии ИИ без интерфейса. Клиент — Vite + PixiJS (карта) + DOM-панели, ИИ в Web Worker.

Tech Stack: TypeScript 6, Vitest 5, Vite, PixiJS 8.

Spec: docs/specs/2026-11-17-territory-design.md (разделы 6, 7, 10) и правила docs/game/{map,terrain,units,cities,production,turn}.md.

Global Constraints

Review Focus


Task 1: Ядро — типы, сид-генератор, ruleset, создание партии и карта

Files: packages/core/src/{types,rng,grid,mapgen,newgame,index}.ts + тесты рядом; packages/content/src/{ruleset,index}.ts + тест.

Interfaces (Produces):

Тесты: одинаковый сид → одинаковые terrain; разные сиды → разные; края — deep; доля суши 35–55% на трёх сидах; newGame даёт стартовые позиции на суше, попарно ≥ 8; JSON.parse(JSON.stringify(state)) равно state; ruleset проходит проверку ссылок (все id в гильдиях существуют).

Task 2: Ядро — видимость, движение, путь, команды юнитов

Files: packages/core/src/{fog,movement,path,commands}.ts + тесты.

Interfaces:

Тесты: шаг по лугу тратит 1 очко; шаг в лес с полным запасом 1 очко разрешён; повторный — нет; вода и чужой юнит — ошибка; чужой юнит / не свой ход — ошибка и состояние не изменилось; goto идёт по пути в пределах очков и сохраняет остаток пути; путь обходит воду; fortify/skip; обзор разведчика 2.

Task 3: Ядро — города, производство, фаза мира, сохранение

Files: packages/core/src/{cities,economy,turn,save}.ts + тесты.

Interfaces:

Тесты: основание на воде / ближе 3 / без очков — ошибка; новый город размер 1, центр с «очагом»; рост на пороге 15 + 6×size, Кладовая сохраняет 40%; голод в размере 1 — размер 1, запас 0; Мастерская +25% вниз; основатель ждёт размер 2 и забирает жителя; излишек промысла переносится; второе кольцо с размера 5; «золотая» мини-партия: 10 ходов из фиксированного сида с фиксированными командами → тот же хэш состояния при повторе и после сохранения/загрузки.

Task 4: ИИ и симуляция

Files: packages/ai/src/{index,ai}.ts + тест; packages/sim/src/{index,run}.ts + тест.

Interfaces: nextAiCommand(state, rules, factionId): Command (детерминированно; всегда в итоге endTurn); runSimulation(rules, opts: { seed; size; factions: number; turns }): GameState.

Тесты: ИИ за ход отдаёт ≤ 500 команд и заканчивает ход; за 60 ходов на малой карте у каждой фракции ≥ 3 городов; симуляция детерминирована (одинаковый хэш); ИИ никогда не получает ошибку от applyCommand.

Task 5: Клиент — запуск в браузере

Files: apps/client/{index.html,vite.config.ts}, apps/client/src/{main,i18n,game,save,input}.ts, apps/client/src/render/{map,sprites}.ts, apps/client/src/ui/{hud,city,newgame}.ts, apps/client/src/ai.worker.ts, apps/client/src/style.css.

Проверка: pnpm --filter @territory/client build без ошибок; ручной прогон в браузере 20+ ходов: основать 2 города, построить воина и основателя, ИИ основывает города, сохранение/загрузка.

Task 6: Документы и статусы