1.9 KiB
1.9 KiB
Tasks: enterprise-gaming-weather
0. Pre-flight (non-negotiable)
- 0.1 Confirm clean working tree (
git statusreports nothing) and no in-flight worktrees with uncommitted work (git worktree listthengit statusin 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.mdmatchesfind packages -maxdepth 3 -name package.jsoncount. Drift here means a prior change archived without regenerating the manifest.
Phase 1 — Scaffold
- Create
gaming/world/weather/(@suaveplan/weather,0.1.0,sideEffects: false) tsconfig.json,vitest.config.ts
Phase 2 — Error codes & constants
src/error-codes.ts+src/constants/index.tssrc/presets/index.ts— CLEAR, RAIN, STORM, SNOW, FOG presets
Phase 3 — Types
src/types/common.ts+common.md
Phase 4 — Blend utility
src/utils/blend.ts—blendWeatherlinear interpolation of all fields- Tests + docs
Phase 5 — Weather zone
src/core/weather-zone/weather-zone.ts— radius + blend edge, getBlendFactor- Tests + docs
Phase 6 — Weather system
src/core/weather-system/weather-system.ts— state machine, transitionTo/tick, lightning RNG, events, OTel- Tests (transition progress, lightning fires event, zone blend)
- Docs
Phase 7 — Integration tests
tests/integration.test.ts— preset sequence: CLEAR → RAIN → STORM → tick through transitions
Phase 8 — Pre-publish gate
bunx turbo lint typecheck test --filter=@suaveplan/weathergreen- 100% coverage
- Publish:
bun scripts/publish.ts --package @suaveplan/weather