Phase 08.10 — Wave 3 normalization (final wave)

Author: DavidQ

docs/dev/CODEX_COMMANDS.md

@@ -1,8 +1,8 @@
 MODEL: GPT-5.4
 REASONING: high
 
-Normalize Wave 2 games:
-Orbit, MultiBallChaos, PaddleIntercept, Thruster, SpaceDuel, SolarSystem
+Normalize Wave 3 games:
+PacmanLite, PacmanFullAI, AITargetDummy, vector-arcade-sample
 
-Same constraints as Wave 1.
+Same constraints as previous waves.
 Return ZIP to <project folder>/tmp/

docs/dev/COMMIT_COMMENT.txt

@@ -1 +1 @@
-build(games): normalize wave-2 repo-wide game boundaries (orbit/multiballchaos/paddleintercept/thruster/spaceduel/solarsystem)
+build(games): normalize wave-3 repo-wide game boundaries (pacmanlite/pacmanfullai/aitargetdummy/vector-arcade-sample)

docs/dev/reports/change_summary.txt

@@ -1,19 +1,18 @@
-Wave 2 Change Summary
+Wave 3 Change Summary
 
 What changed
-- 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.
+- Added real rules modules and required flow files for all four Wave 3 targets.
+- Converted rules-placeholder-only condition to real rules JS presence.
+- Added missing required boundary dirs for vector-arcade-sample.
 
-Wave 2 targets normalized
-- Orbit
-- MultiBallChaos
-- PaddleIntercept
-- Thruster
-- SpaceDuel
-- SolarSystem
+Wave 3 targets normalized
+- PacmanLite
+- PacmanFullAI
+- AITargetDummy
+- vector-arcade-sample
 
 What did not change
 - No engine files
 - No launcher/bootstrap work
+- No cross-wave normalization edits
 - No status inflation edits
-- Existing compliant games (Asteroids, Puckman, SpaceInvaders) preserved

docs/dev/reports/file_tree.txt

@@ -1,33 +1,30 @@
-Wave 2 Normalization Tree
+Wave 3 Normalization Tree
 
 games/
-  Orbit/
+  PacmanLite/
     rules/gameFlowRules.js
     flow/attract.js
     flow/intro.js
     flow/highscore.js
-  MultiBallChaos/
+  PacmanFullAI/
     rules/gameFlowRules.js
     flow/attract.js
     flow/intro.js
     flow/highscore.js
-  PaddleIntercept/
+  AITargetDummy/
     rules/gameFlowRules.js
     flow/attract.js
     flow/intro.js
     flow/highscore.js
-  Thruster/
-    rules/gameFlowRules.js
-    flow/attract.js
-    flow/intro.js
-    flow/highscore.js
-  SpaceDuel/
-    rules/gameFlowRules.js
+  vector-arcade-sample/
+    debug/.gitkeep
+    entities/.gitkeep
     flow/attract.js
     flow/intro.js
     flow/highscore.js
-  SolarSystem/
+    game/.gitkeep
+    levels/.gitkeep
     rules/gameFlowRules.js
-    flow/attract.js
-    flow/intro.js
-    flow/highscore.js
+    systems/.gitkeep
+    ui/.gitkeep
+    utils/.gitkeep

docs/dev/reports/validation_checklist.txt

@@ -1,10 +1,10 @@
-Wave 2 Validation Checklist
+Wave 3 Validation Checklist
 
 Scope guard
-- [x] Wave 2 targets only
+- [x] Wave 3 targets only
 - [x] No engine modifications
 - [x] No launch/bootstrap normalization
-- [x] Existing compliant games preserved
+- [x] Same constraints as prior waves applied
 
 Per-target checks
 For each target game:
@@ -15,13 +15,11 @@ For each target game:
 - flow/highscore.js present
 
 Results
-- [x] Orbit
-- [x] MultiBallChaos
-- [x] PaddleIntercept
-- [x] Thruster
-- [x] SpaceDuel
-- [x] SolarSystem
+- [x] PacmanLite
+- [x] PacmanFullAI
+- [x] AITargetDummy
+- [x] vector-arcade-sample
 
 Command evidence
-- node --check on all 24 Wave 2 files: PASS
+- node --check on all 16 Wave 3 files: PASS
 - per-target structural checks: PASS

docs/pr/BUILD_PR_LEVEL_08_10_REPO_WIDE_GAME_NORMALIZATION_WAVE_3.md

@@ -0,0 +1,22 @@
+# BUILD_PR — LEVEL 08.10 REPO-WIDE GAME NORMALIZATION WAVE 3
+
+## Purpose
+Continue repo-wide normalization (Option A) with final remaining non-compliant games.
+
+## Wave 3 target set
+- PacmanLite
+- PacmanFullAI
+- AITargetDummy
+- vector-arcade-sample
+
+## Required structure
+Same as previous waves.
+
+## Acceptance criteria
+Same as previous waves.
+
+## Scope
+Docs-only, Wave 3 only.
+
+## Out of scope
+No engine, no launcher, no cross-wave changes.

games/AITargetDummy/flow/attract.js

@@ -0,0 +1,19 @@
+import {
+  AI_TARGET_DUMMY_FLOW_IDS,
+  AI_TARGET_DUMMY_FLOW_LABELS,
+  AI_TARGET_DUMMY_GAME_OVER_RETURN_MODE,
+  AI_TARGET_DUMMY_GAME_OVER_RETURN_RESET_IDLE,
+  AI_TARGET_DUMMY_GAME_OVER_RETURN_STATUS,
+  createAITARGETDUMMYFlowDescriptor
+} from "../rules/gameFlowRules.js";
+
+export const AI_TARGET_DUMMY_ATTRACT_FLOW_NEXT_ID = AI_TARGET_DUMMY_FLOW_IDS.intro;
+
+export const attractFlow = createAITARGETDUMMYFlowDescriptor(AI_TARGET_DUMMY_FLOW_IDS.attract, {
+  label: AI_TARGET_DUMMY_FLOW_LABELS.attract,
+  nextFlowId: AI_TARGET_DUMMY_ATTRACT_FLOW_NEXT_ID,
+  autoAdvanceSeconds: null,
+  statusText: AI_TARGET_DUMMY_GAME_OVER_RETURN_STATUS,
+  returnMode: AI_TARGET_DUMMY_GAME_OVER_RETURN_MODE,
+  resetIdleOnReturn: AI_TARGET_DUMMY_GAME_OVER_RETURN_RESET_IDLE
+});

games/AITargetDummy/flow/highscore.js

@@ -0,0 +1,16 @@
+import {
+  AI_TARGET_DUMMY_FLOW_IDS,
+  AI_TARGET_DUMMY_FLOW_LABELS,
+  AI_TARGET_DUMMY_HIGHSCORE_AUTO_EXIT_SECONDS,
+  AI_TARGET_DUMMY_HIGHSCORE_STATUS,
+  createAITARGETDUMMYFlowDescriptor
+} from "../rules/gameFlowRules.js";
+
+export const AI_TARGET_DUMMY_HIGHSCORE_FLOW_NEXT_ID = AI_TARGET_DUMMY_FLOW_IDS.attract;
+
+export const highscoreFlow = createAITARGETDUMMYFlowDescriptor(AI_TARGET_DUMMY_FLOW_IDS.highscore, {
+  label: AI_TARGET_DUMMY_FLOW_LABELS.highscore,
+  nextFlowId: AI_TARGET_DUMMY_HIGHSCORE_FLOW_NEXT_ID,
+  autoAdvanceSeconds: AI_TARGET_DUMMY_HIGHSCORE_AUTO_EXIT_SECONDS,
+  statusText: AI_TARGET_DUMMY_HIGHSCORE_STATUS
+});

games/AITargetDummy/flow/intro.js

@@ -0,0 +1,20 @@
+import {
+  AI_TARGET_DUMMY_FLOW_IDS,
+  AI_TARGET_DUMMY_FLOW_LABELS,
+  AI_TARGET_DUMMY_GAME_OVER_AUTO_EXIT_SECONDS,
+  AI_TARGET_DUMMY_GAME_OVER_RETURN_MODE,
+  AI_TARGET_DUMMY_GAME_OVER_RETURN_RESET_IDLE,
+  AI_TARGET_DUMMY_GAME_OVER_RETURN_STATUS,
+  createAITARGETDUMMYFlowDescriptor
+} from "../rules/gameFlowRules.js";
+
+export const AI_TARGET_DUMMY_INTRO_FLOW_NEXT_ID = AI_TARGET_DUMMY_FLOW_IDS.highscore;
+
+export const introFlow = createAITARGETDUMMYFlowDescriptor(AI_TARGET_DUMMY_FLOW_IDS.intro, {
+  label: AI_TARGET_DUMMY_FLOW_LABELS.intro,
+  nextFlowId: AI_TARGET_DUMMY_INTRO_FLOW_NEXT_ID,
+  autoAdvanceSeconds: AI_TARGET_DUMMY_GAME_OVER_AUTO_EXIT_SECONDS,
+  statusText: AI_TARGET_DUMMY_GAME_OVER_RETURN_STATUS,
+  returnMode: AI_TARGET_DUMMY_GAME_OVER_RETURN_MODE,
+  resetIdleOnReturn: AI_TARGET_DUMMY_GAME_OVER_RETURN_RESET_IDLE
+});

games/AITargetDummy/rules/gameFlowRules.js

@@ -0,0 +1,35 @@
+export const AI_TARGET_DUMMY_FLOW_CONTRACT_VERSION = "1";
+
+export const AI_TARGET_DUMMY_FLOW_IDS = Object.freeze({
+  attract: "attract",
+  intro: "intro",
+  highscore: "highscore"
+});
+
+export const AI_TARGET_DUMMY_FLOW_LABELS = Object.freeze({
+  attract: "Attract",
+  intro: "Intro",
+  highscore: "Highscore"
+});
+
+export const AI_TARGET_DUMMY_GAME_OVER_AUTO_EXIT_SECONDS = 30;
+export const AI_TARGET_DUMMY_GAME_OVER_RETURN_MODE = "menu";
+export const AI_TARGET_DUMMY_GAME_OVER_RETURN_STATUS = "Press 1 for one player or 2 for two players.";
+export const AI_TARGET_DUMMY_GAME_OVER_RETURN_RESET_IDLE = true;
+
+export const AI_TARGET_DUMMY_HIGHSCORE_AUTO_EXIT_SECONDS = 12;
+export const AI_TARGET_DUMMY_HIGHSCORE_STATUS = "AI Target Dummy high scores";
+
+export function createAITARGETDUMMYFlowDescriptor(id, options = {}) {
+  return Object.freeze({
+    id,
+    label: options.label || id,
+    contractVersion: AI_TARGET_DUMMY_FLOW_CONTRACT_VERSION,
+    nextFlowId: options.nextFlowId || AI_TARGET_DUMMY_FLOW_IDS.attract,
+    autoAdvanceSeconds: options.autoAdvanceSeconds ?? null,
+    statusText: options.statusText || "",
+    returnMode: options.returnMode || AI_TARGET_DUMMY_GAME_OVER_RETURN_MODE,
+    resetIdleOnReturn: options.resetIdleOnReturn ?? AI_TARGET_DUMMY_GAME_OVER_RETURN_RESET_IDLE,
+    debugPluginFactory: options.debugPluginFactory || null
+  });
+}