56 lines
3.0 KiB
Markdown
56 lines
3.0 KiB
Markdown
# Tasks — Wave A: `@suaveplan/game-server` core foundation
|
|
|
|
## 0. Pre-flight (non-negotiable)
|
|
|
|
- [x] 0.1 Confirm clean working tree (`git status` reports nothing) and no in-flight worktrees with uncommitted work
|
|
- [x] 0.2 Account for every `.claude/worktrees/agent-*` — operating inside `agent-a3cb7ed021fa6e13a` for this change
|
|
- [x] 0.3 `MANIFEST.md` matches `find packages -maxdepth 3 -name package.json` count — verified unchanged (no new packages added; this is an in-package extension)
|
|
|
|
## 1. Spec authoring
|
|
|
|
- [x] 1.1 Read `../suaveplan/packages/universal/game-server/src/core/` upstream sources
|
|
- [x] 1.2 Read existing `openspec/changes/enterprise-game-server-core/proposal.md` to align with prior scope decisions
|
|
- [x] 1.3 Read `openspec/AGENTS.md` Sections 13 and 14
|
|
- [x] 1.4 Draft `proposal.md`
|
|
- [x] 1.5 Source mapping documented in the Parity Checklist
|
|
- [x] 1.6 Draft `specs/game-server/spec.md`
|
|
- [x] 1.7 Every `### Requirement:` carries a `**Verified by:**` line
|
|
|
|
## 2. Implementation
|
|
|
|
- [x] 2.1 `src/core/types/core.types.ts` — `ConnectionStatus`, `PlayerConnection`, `SessionNode`, `SessionData`, `StateChangeEvent`, `GameEvents`
|
|
- [x] 2.2 `src/core/interfaces/i-game-logic/` — interface + `runIGameLogicConformance`
|
|
- [x] 2.3 `src/core/interfaces/i-player-manager/` — interface + `runIPlayerManagerConformance`
|
|
- [x] 2.4 `src/core/interfaces/i-session-manager/` — interface + `runISessionManagerConformance`
|
|
- [x] 2.5 `src/core/interfaces/i-state-manager/` — interface + `runIStateManagerConformance`
|
|
- [x] 2.6 `src/core/events/game-events/` — `GAME_EVENT_KEYS` + `isGameEventKey`
|
|
- [x] 2.7 `src/core/events/game-event-emitter/` — `GameEventEmitter` with all helpers
|
|
- [x] 2.8 `src/core/abstract-game-logic/` — `AbstractGameLogic` with Clock + IdGenerator + OTel
|
|
- [x] 2.9 Extend `src/errors/game-server-error.ts` — 6 new codes
|
|
- [x] 2.10 Extend root `src/index.ts` and `package.json` exports
|
|
|
|
## 3. Tests
|
|
|
|
- [x] 3.1 Unit tests for every implementation file (one `.test.ts` per `.ts`)
|
|
- [x] 3.2 Conformance harness tests against compliant + non-compliant reference impls
|
|
- [x] 3.3 Every `it(...)` carries `{ timeout: 5000 }`
|
|
- [x] 3.4 OTel assertion via `flushTestMetrics()` from the existing polyfill
|
|
|
|
## 4. Documentation
|
|
|
|
- [x] 4.1 Sibling `.md` for every implementation `.ts`
|
|
- [x] 4.2 Existing `README.md` covers the package (Wave A surface auto-discoverable via re-exports; no README rewrite required for the core extension)
|
|
|
|
## 5. Pre-archive verification (the 5-gate triple)
|
|
|
|
- [ ] 5.1 `bun run check` — Biome 0 errors across the package
|
|
- [ ] 5.2 `bunx turbo lint typecheck test --filter=@suaveplan/game-server` — green
|
|
- [ ] 5.3 `bunx turbo test:coverage --filter=@suaveplan/game-server` — 100/100/100/100
|
|
- [ ] 5.4 Banned-pattern scan returns empty
|
|
- [ ] 5.5 `bunx turbo build --filter=@suaveplan/game-server` — green
|
|
|
|
## 6. Archive (NOT performed in this worktree)
|
|
|
|
- [ ] 6.1 Fold delta into `openspec/specs/game-server/spec.md` (orchestrator step)
|
|
- [ ] 6.2 Move folder to `openspec/archive/<yyyy-mm-dd>-game-server-core/` (orchestrator step)
|