Phase 08.09 — Wave 2 normalization

Author: DavidQ

docs/dev/CODEX_COMMANDS.md

@@ -1,16 +1,8 @@
 MODEL: GPT-5.4
 REASONING: high
 
-COMMAND GOAL:
-Create BUILD_PR_LEVEL_08_08_REPO_WIDE_GAME_NORMALIZATION_WAVE_1 as a docs-first, small-scope
-implementation bundle for the first repo-wide normalization wave.
+Normalize Wave 2 games:
+Orbit, MultiBallChaos, PaddleIntercept, Thruster, SpaceDuel, SolarSystem
 
-CONSTRAINTS:
-- One PR purpose only
-- Smallest scoped valid change
-- No engine modifications
-- No launch/bootstrap work
-- No status inflation
-- Preserve existing compliant games: Asteroids, Puckman, SpaceInvaders
-- Normalize only Wave 1 targets:
-  Breakout, Pong, Bouncing-ball, ProjectileLab, Gravity, GravityWell
+Same constraints as Wave 1.
+Return ZIP to <project folder>/tmp/

docs/dev/COMMIT_COMMENT.txt

@@ -1 +1 @@
-build(games): normalize wave-1 repo-wide game boundaries (breakout/pong/bouncing-ball/projectilelab/gravity/gravitywell)
+build(games): normalize wave-2 repo-wide game boundaries (orbit/multiballchaos/paddleintercept/thruster/spaceduel/solarsystem)

docs/dev/reports/change_summary.txt

@@ -1,23 +1,19 @@
-BUILD_PR_LEVEL_08_08_REPO_WIDE_GAME_NORMALIZATION_WAVE_1
+Wave 2 Change Summary
 
 What changed
-- Added wave-1 rules modules and flow files for six target games only.
-- Converted each target from rules-placeholder-only to real rules JS + required flow file presence.
+- Added real rules modules and required flow files for six Wave 2 targets.
+- Removed placeholder-only rules condition for Wave 2 targets by adding rules/gameFlowRules.js.
 
-Wave 1 targets normalized
-- Breakout
-- Pong
-- Bouncing-ball
-- ProjectileLab
-- Gravity
-- GravityWell
+Wave 2 targets normalized
+- Orbit
+- MultiBallChaos
+- PaddleIntercept
+- Thruster
+- SpaceDuel
+- SolarSystem
 
-What was intentionally not changed
+What did not change
 - No engine files
-- No launch/bootstrap wiring
-- No behavior standardization beyond file presence + rules source surface
-- No status inflation for repo-wide completion lines
-
-Net effect
-- First repo-wide normalization wave completed at minimal structural boundary scope.
-- Remaining non-wave targets still require future waves.
+- No launcher/bootstrap work
+- No status inflation edits
+- Existing compliant games (Asteroids, Puckman, SpaceInvaders) preserved

docs/dev/reports/file_tree.txt

@@ -1,41 +1,33 @@
-Wave 1 Normalization Tree
+Wave 2 Normalization Tree
 
 games/
-  Breakout/
+  Orbit/
     rules/gameFlowRules.js
     flow/attract.js
     flow/intro.js
     flow/highscore.js
-  Pong/
+  MultiBallChaos/
     rules/gameFlowRules.js
     flow/attract.js
     flow/intro.js
     flow/highscore.js
-  Bouncing-ball/
+  PaddleIntercept/
     rules/gameFlowRules.js
     flow/attract.js
     flow/intro.js
     flow/highscore.js
-  ProjectileLab/
+  Thruster/
     rules/gameFlowRules.js
     flow/attract.js
     flow/intro.js
     flow/highscore.js
-  Gravity/
+  SpaceDuel/
     rules/gameFlowRules.js
     flow/attract.js
     flow/intro.js
     flow/highscore.js
-  GravityWell/
+  SolarSystem/
     rules/gameFlowRules.js
     flow/attract.js
     flow/intro.js
     flow/highscore.js
-
-docs/
-  pr/BUILD_PR_LEVEL_08_08_REPO_WIDE_GAME_NORMALIZATION_WAVE_1.md
-  dev/codex_commands.md
-  dev/commit_comment.txt
-  dev/reports/change_summary.txt
-  dev/reports/validation_checklist.txt
-  dev/reports/file_tree.txt

docs/dev/reports/validation_checklist.txt

@@ -1,32 +1,27 @@
-PR: BUILD_PR_LEVEL_08_08_REPO_WIDE_GAME_NORMALIZATION_WAVE_1
-
-Validation checklist
+Wave 2 Validation Checklist
 
 Scope guard
-- [x] Only Wave 1 targets changed: Breakout, Pong, Bouncing-ball, ProjectileLab, Gravity, GravityWell
-- [x] Existing compliant games preserved (Asteroids, Puckman, SpaceInvaders untouched)
-- [x] No engine files modified
-- [x] No launch/bootstrap normalization work performed
+- [x] Wave 2 targets only
+- [x] No engine modifications
+- [x] No launch/bootstrap normalization
+- [x] Existing compliant games preserved
 
-Per-target contract
-For each Wave 1 game:
-1. required dirs exist
-2. real rules JS exists at rules/gameFlowRules.js
-3. flow/attract.js exists
-4. flow/intro.js exists
-5. flow/highscore.js exists
+Per-target checks
+For each target game:
+- required dirs present
+- rules/gameFlowRules.js present
+- flow/attract.js present
+- flow/intro.js present
+- flow/highscore.js present
 
 Results
-- [x] Breakout
-- [x] Pong
-- [x] Bouncing-ball
-- [x] ProjectileLab
-- [x] Gravity
-- [x] GravityWell
+- [x] Orbit
+- [x] MultiBallChaos
+- [x] PaddleIntercept
+- [x] Thruster
+- [x] SpaceDuel
+- [x] SolarSystem
 
 Command evidence
-- node --check run on all 24 new files (6 rules + 18 flow): PASS
-- structural presence check for all 6 targets: PASS
-
-Status rule
-- [x] No Section 8 repo-wide [x] inflation performed in this PR
+- node --check on all 24 Wave 2 files: PASS
+- per-target structural checks: PASS

docs/pr/BUILD_PR_LEVEL_08_09_REPO_WIDE_GAME_NORMALIZATION_WAVE_2.md

@@ -0,0 +1,24 @@
+# BUILD_PR — LEVEL 08.09 REPO-WIDE GAME NORMALIZATION WAVE 2
+
+## Purpose
+Continue Option A by normalizing the next set of non-compliant games.
+
+## Wave 2 target set
+- Orbit
+- MultiBallChaos
+- PaddleIntercept
+- Thruster
+- SpaceDuel
+- SolarSystem
+
+## Required structure
+Same as Wave 1.
+
+## Acceptance criteria
+Same as Wave 1.
+
+## Scope
+Docs-only, Wave 2 only.
+
+## Out of scope
+No engine, no launcher, no cross-wave changes.

games/MultiBallChaos/flow/attract.js

@@ -0,0 +1,19 @@
+import {
+  MULTI_BALL_CHAOS_FLOW_IDS,
+  MULTI_BALL_CHAOS_FLOW_LABELS,
+  MULTI_BALL_CHAOS_GAME_OVER_RETURN_MODE,
+  MULTI_BALL_CHAOS_GAME_OVER_RETURN_RESET_IDLE,
+  MULTI_BALL_CHAOS_GAME_OVER_RETURN_STATUS,
+  createMULTIBALLCHAOSFlowDescriptor
+} from "../rules/gameFlowRules.js";
+
+export const MULTI_BALL_CHAOS_ATTRACT_FLOW_NEXT_ID = MULTI_BALL_CHAOS_FLOW_IDS.intro;
+
+export const attractFlow = createMULTIBALLCHAOSFlowDescriptor(MULTI_BALL_CHAOS_FLOW_IDS.attract, {
+  label: MULTI_BALL_CHAOS_FLOW_LABELS.attract,
+  nextFlowId: MULTI_BALL_CHAOS_ATTRACT_FLOW_NEXT_ID,
+  autoAdvanceSeconds: null,
+  statusText: MULTI_BALL_CHAOS_GAME_OVER_RETURN_STATUS,
+  returnMode: MULTI_BALL_CHAOS_GAME_OVER_RETURN_MODE,
+  resetIdleOnReturn: MULTI_BALL_CHAOS_GAME_OVER_RETURN_RESET_IDLE
+});

games/MultiBallChaos/flow/highscore.js

@@ -0,0 +1,16 @@
+import {
+  MULTI_BALL_CHAOS_FLOW_IDS,
+  MULTI_BALL_CHAOS_FLOW_LABELS,
+  MULTI_BALL_CHAOS_HIGHSCORE_AUTO_EXIT_SECONDS,
+  MULTI_BALL_CHAOS_HIGHSCORE_STATUS,
+  createMULTIBALLCHAOSFlowDescriptor
+} from "../rules/gameFlowRules.js";
+
+export const MULTI_BALL_CHAOS_HIGHSCORE_FLOW_NEXT_ID = MULTI_BALL_CHAOS_FLOW_IDS.attract;
+
+export const highscoreFlow = createMULTIBALLCHAOSFlowDescriptor(MULTI_BALL_CHAOS_FLOW_IDS.highscore, {
+  label: MULTI_BALL_CHAOS_FLOW_LABELS.highscore,
+  nextFlowId: MULTI_BALL_CHAOS_HIGHSCORE_FLOW_NEXT_ID,
+  autoAdvanceSeconds: MULTI_BALL_CHAOS_HIGHSCORE_AUTO_EXIT_SECONDS,
+  statusText: MULTI_BALL_CHAOS_HIGHSCORE_STATUS
+});

games/MultiBallChaos/flow/intro.js

@@ -0,0 +1,20 @@
+import {
+  MULTI_BALL_CHAOS_FLOW_IDS,
+  MULTI_BALL_CHAOS_FLOW_LABELS,
+  MULTI_BALL_CHAOS_GAME_OVER_AUTO_EXIT_SECONDS,
+  MULTI_BALL_CHAOS_GAME_OVER_RETURN_MODE,
+  MULTI_BALL_CHAOS_GAME_OVER_RETURN_RESET_IDLE,
+  MULTI_BALL_CHAOS_GAME_OVER_RETURN_STATUS,
+  createMULTIBALLCHAOSFlowDescriptor
+} from "../rules/gameFlowRules.js";
+
+export const MULTI_BALL_CHAOS_INTRO_FLOW_NEXT_ID = MULTI_BALL_CHAOS_FLOW_IDS.highscore;
+
+export const introFlow = createMULTIBALLCHAOSFlowDescriptor(MULTI_BALL_CHAOS_FLOW_IDS.intro, {
+  label: MULTI_BALL_CHAOS_FLOW_LABELS.intro,
+  nextFlowId: MULTI_BALL_CHAOS_INTRO_FLOW_NEXT_ID,
+  autoAdvanceSeconds: MULTI_BALL_CHAOS_GAME_OVER_AUTO_EXIT_SECONDS,
+  statusText: MULTI_BALL_CHAOS_GAME_OVER_RETURN_STATUS,
+  returnMode: MULTI_BALL_CHAOS_GAME_OVER_RETURN_MODE,
+  resetIdleOnReturn: MULTI_BALL_CHAOS_GAME_OVER_RETURN_RESET_IDLE
+});

games/MultiBallChaos/rules/gameFlowRules.js

@@ -0,0 +1,35 @@
+export const MULTI_BALL_CHAOS_FLOW_CONTRACT_VERSION = "1";
+
+export const MULTI_BALL_CHAOS_FLOW_IDS = Object.freeze({
+  attract: "attract",
+  intro: "intro",
+  highscore: "highscore"
+});
+
+export const MULTI_BALL_CHAOS_FLOW_LABELS = Object.freeze({
+  attract: "Attract",
+  intro: "Intro",
+  highscore: "Highscore"
+});
+
+export const MULTI_BALL_CHAOS_GAME_OVER_AUTO_EXIT_SECONDS = 30;
+export const MULTI_BALL_CHAOS_GAME_OVER_RETURN_MODE = "menu";
+export const MULTI_BALL_CHAOS_GAME_OVER_RETURN_STATUS = "Press 1 for one player or 2 for two players.";
+export const MULTI_BALL_CHAOS_GAME_OVER_RETURN_RESET_IDLE = true;
+
+export const MULTI_BALL_CHAOS_HIGHSCORE_AUTO_EXIT_SECONDS = 12;
+export const MULTI_BALL_CHAOS_HIGHSCORE_STATUS = "Multi Ball Chaos high scores";
+
+export function createMULTIBALLCHAOSFlowDescriptor(id, options = {}) {
+  return Object.freeze({
+    id,
+    label: options.label || id,
+    contractVersion: MULTI_BALL_CHAOS_FLOW_CONTRACT_VERSION,
+    nextFlowId: options.nextFlowId || MULTI_BALL_CHAOS_FLOW_IDS.attract,
+    autoAdvanceSeconds: options.autoAdvanceSeconds ?? null,
+    statusText: options.statusText || "",
+    returnMode: options.returnMode || MULTI_BALL_CHAOS_GAME_OVER_RETURN_MODE,
+    resetIdleOnReturn: options.resetIdleOnReturn ?? MULTI_BALL_CHAOS_GAME_OVER_RETURN_RESET_IDLE,
+    debugPluginFactory: options.debugPluginFactory || null
+  });
+}