Initial Commit

openspec/changes/enterprise-gaming-universe/tasks.md

@@ -0,0 +1,64 @@
+
+
+## 0. Pre-flight (non-negotiable)
+
+- [ ] 0.1 Confirm clean working tree (`git status` reports nothing) and no in-flight worktrees with uncommitted work (`git worktree list` then `git status` in each)
+- [ ] 0.2 If any worktrees exist under `.claude/worktrees/`, account for each one: still-active agent, work-pending-merge, or stale-and-prune. Stale worktrees MUST be removed (`git worktree remove`) before opening a new one — code that has been lost twice on main is the failure mode this guards against.
+- [ ] 0.3 Confirm the package set in `MANIFEST.md` matches `find packages -maxdepth 3 -name package.json` count. Drift here means a prior change archived without regenerating the manifest.
+
+## 1. gaming-universe — Game Clock Wrapper
+
+- [ ] 1.1 Scaffold `@suaveplan/gaming-universe` package in `packages/universal/gaming/gaming-universe` with `package.json`, `tsconfig.json`, `vitest.config.ts` (100/100/100/100 thresholds)
+- [ ] 1.2 Implement `GamingUniverseOptions` and `GamingUniverse` class
+- [ ] 1.3 Integrate `@suaveplan/timing` `AsyncScheduler` for tick driving
+- [ ] 1.4 Implement `setTimeScale`, `setGameTime`, `pause`, `resume`, `isPaused`, `getGameTime`
+- [ ] 1.5 Implement `getScene` delegating to `UniverseClient` at current game time
+- [ ] 1.6 Implement event emission via `@suaveplan/events` for `hourChanged`, `dayChanged`, `seasonChanged`, `sunriseStarted`, `sunsetStarted`, `moonriseStarted`, `moonsetStarted`, `eclipseStarted`
+- [ ] 1.7 Implement `dispose` stopping scheduler and cancelling in-flight queries (idempotent)
+- [ ] 1.8 Expose readonly `universe` property
+- [ ] 1.9 Add Zod schemas for all public option types
+- [ ] 1.10 Add OTel spans on all public entrypoints
+- [ ] 1.11 Add `AbortSignal` on `getScene`
+- [ ] 1.12 Write tests achieving 100% coverage
+- [ ] 1.13 Write sibling `.md` docs for every implementation file
+- [ ] 1.14 Write `README.md` with install, quick-start, and module links
+- [ ] 1.15 Configure explicit named barrel exports for all subpaths (no `export *`)
+- [ ] 1.16 Run `bunx turbo lint typecheck test build --filter=@suaveplan/gaming-universe` and fix all errors
+- [ ] 1.17 Run `bunx turbo test:coverage --filter=@suaveplan/gaming-universe` and verify 100%
+
+## 2. gaming-environment-lighting — Physical Lighting
+
+- [ ] 2.1 Scaffold `@suaveplan/gaming-environment-lighting` package in `packages/universal/gaming/gaming-environment-lighting`
+- [ ] 2.2 Implement Rayleigh/Mie scattering sky colour computation from `sunAltitude` and `AtmosphereConfig`
+- [ ] 2.3 Implement twilight star visibility thresholds (civil/nautical/astronomical/full dark)
+- [ ] 2.4 Implement vacuum collapse (no atmosphere → always full dark)
+- [ ] 2.5 Implement multi-satellite moonlight sum (`moonLight ∝ phaseIllumination × angularDiameter² × albedo`)
+- [ ] 2.6 Implement `EnvironmentModifiers`: `totalAmbientLight`, `stealthBonus`, `visibilityRangeMetres`, `npcSleepProbability`
+- [ ] 2.7 Export plain ECS component interfaces: `DayNightClock`, `LightState`, `DayNightAffected`
+- [ ] 2.8 Implement `RenderPayload` generation per tick
+- [ ] 2.9 Pass `PlanetTextureManifest` identifiers through verbatim
+- [ ] 2.10 Handle optional `WeatherState` pass-through without breaking
+- [ ] 2.11 Add Zod schemas for all public option types
+- [ ] 2.12 Add OTel spans on all public entrypoints
+- [ ] 2.13 Write tests achieving 100% coverage
+- [ ] 2.14 Write sibling `.md` docs for every implementation file
+- [ ] 2.15 Write `README.md` with install, quick-start, and module links
+- [ ] 2.16 Configure explicit named barrel exports for all subpaths (no `export *`)
+- [ ] 2.17 Run `bunx turbo lint typecheck test build --filter=@suaveplan/gaming-environment-lighting` and fix all errors
+- [ ] 2.18 Run `bunx turbo test:coverage --filter=@suaveplan/gaming-environment-lighting` and verify 100%
+
+## 3. Cross-cutting and Archive
+
+- [ ] 3.1 Update `STATUS.md`: mark `gaming-universe` and `gaming-environment-lighting` as completed
+- [ ] 3.2 Update `SUMMARY.md` with per-package paragraphs
+- [ ] 3.3 Update `MANIFEST.md` via `bun scripts/folder-reorg/generate-manifest.ts`
+- [ ] 3.4 Update `MISSING.yml` via `bun scripts/generate-missing.ts`
+- [ ] 3.5 Run `bunx markdownlint-cli2 --fix` on all touched root docs
+- [ ] 3.6 Run `bunx turbo lint typecheck test` across the full gaming-universe filter set
+- [ ] 3.7 Verify zero banned patterns in all new package `src/` directories
+- [ ] 3.8 Verify zero `export *` in feature barrels
+- [ ] 3.9 Verify zero direct `vitest`/`bun:test` imports in non-exempt packages
+- [ ] 3.10 Verify every `.ts` has a sibling `.md`
+- [ ] 3.11 Verify every package has a `README.md`
+- [ ] 3.12 Verify no bare version strings in any new `package.json`
+- [ ] 3.13 Archive change: move `openspec/changes/enterprise-gaming-universe` to `openspec/archive/2026-04-25-enterprise-gaming-universe`