Rename Puckman → Pacman across repo

BUILD_PR_LEVEL_19_9_RENAME_PUCKMAN_TO_PACMAN

Author: DavidQ

docs/dev/CODEX_COMMANDS.md

@@ -1,32 +1,16 @@
 MODEL: GPT-5.4-codex
-REASONING: high
+REASONING: medium
 
 COMMAND:
-1. Run:
-   node tools/dev/checkSharedExtractionGuard.mjs
-
-2. Capture output differences.
-
-3. Locate baseline file (likely in tools/dev or reports).
-
-4. Determine:
-   - Are new shared entries valid? If YES → update baseline
-   - If NO → fix classification logic
-
-5. Apply smallest change:
-   - update baseline JSON OR
-   - adjust guard filters
-
-6. Run:
-   npm test
-
-7. Confirm:
-   pretest passes (no baseline drift)
-
-8. Package:
-   <project folder>/tmp/BUILD_PR_LEVEL_19_8_FIX_SHARED_EXTRACTION_GUARD_BASELINE.zip
+1. Search repo for "Puckman"
+2. Replace all occurrences with "Pacman"
+3. Rename files/folders if needed
+4. Fix any import paths
+5. Run tests:
+   node ./scripts/run-node-tests.mjs
+6. Package ZIP:
+   <project folder>/tmp/BUILD_PR_LEVEL_19_9_RENAME_PUCKMAN_TO_PACMAN.zip
 
 CONSTRAINTS:
-- Do not modify unrelated systems
-- Do not remove guard
-- Preserve intent of guard
+- No logic changes
+- Keep changes minimal and focused

docs/dev/COMMIT_COMMENT.txt

@@ -1,3 +1,3 @@
-Fix shared extraction guard baseline drift
+Rename Puckman → Pacman across repo
 
-BUILD_PR_LEVEL_19_8_FIX_SHARED_EXTRACTION_GUARD_BASELINE
+BUILD_PR_LEVEL_19_9_RENAME_PUCKMAN_TO_PACMAN

docs/dev/reports/BUILD_PR_LEVEL_19_9_RENAME_PUCKMAN_TO_PACMAN_summary.md

@@ -0,0 +1,14 @@
+# Pacman Naming Correction
+
+## Issue
+Repo contained mixed naming:
+- Pacman (original arcade internal name)
+- Pacman (standard public name)
+
+## Resolution
+Standardized to "Pacman" across entire repo.
+
+## Result
+- Consistent naming
+- Cleaner documentation
+- Avoid confusion

docs/dev/reports/launch_smoke_report.md

@@ -1,6 +1,6 @@
 # Launch Smoke Report
 
-Generated: 2026-04-17T15:32:24.952Z
+Generated: 2026-04-17T15:45:00.839Z
 
 Filters: games=true, samples=true, tools=true, sampleRange=all
 

docs/dev/reports/phase_08_status_correction.txt

@@ -1,7 +1,7 @@
-Phase 08 status correction after BUILD_PR_LEVEL_08_04_PUCKMAN_BOUNDARY_NORMALIZATION
+Phase 08 status correction after BUILD_PR_LEVEL_08_04_PACMAN_BOUNDARY_NORMALIZATION
 
 Earned now
-- [x] puckman normalized
+- [x] pacman normalized
 
 Still not earned repo-wide
 - [ ] game flow pattern standardized (`flow/attract.js`, `flow/intro.js`, `flow/highscore.js`)
@@ -11,5 +11,5 @@ Still not earned repo-wide
 - [ ] future games follow template-first path
 
 Notes
-- This PR normalizes Puckman only.
+- This PR normalizes Pacman only.
 - Repo-wide completion markers remain unchanged unless globally satisfied.

docs/dev/reports/puckman_boundary_model.txt

@@ -1,15 +1,15 @@
-PR: BUILD_PR_LEVEL_08_04_PUCKMAN_BOUNDARY_NORMALIZATION
+PR: BUILD_PR_LEVEL_08_04_PACMAN_BOUNDARY_NORMALIZATION
 
-Puckman boundary normalization (smallest scope)
-- Added game-local boundary folders under games/Puckman.
-- Added rules source of truth at games/Puckman/rules/gameFlowRules.js.
+Pacman boundary normalization (smallest scope)
+- Added game-local boundary folders under games/Pacman.
+- Added rules source of truth at games/Pacman/rules/gameFlowRules.js.
 - Added flow modules consuming rules constants:
-  - games/Puckman/flow/attract.js
-  - games/Puckman/flow/intro.js
-  - games/Puckman/flow/highscore.js
+  - games/Pacman/flow/attract.js
+  - games/Pacman/flow/intro.js
+  - games/Pacman/flow/highscore.js
 - Added gameplay runtime/scene modules consuming rules constants:
-  - games/Puckman/game/PuckmanRuntime.js
-  - games/Puckman/game/PuckmanGameScene.js
+  - games/Pacman/game/PacmanRuntime.js
+  - games/Pacman/game/PacmanGameScene.js
 
 Boundary ownership
 - flow: descriptors only, no duplicated constants

docs/dev/roadmaps/MASTER_ROADMAP_HIGH_LEVEL.md

@@ -1,4 +1,4 @@
-# MASTER ROADMAP - HIGH LEVEL (v7 ADDITIVE)
+# MASTER ROADMAP - HIGH LEVEL (v7 ADDITIVE)
 
 ## Status Key
 - [x] complete
@@ -232,7 +232,7 @@
 ### Track A - Debug Foundation
 - [x] Dev Console (input + command execution)
 - [x] Debug Overlay (visual panels)
-- [x] Console ↔ Overlay Boundary
+- [x] Console ↔ Overlay Boundary
 - [x] Panel Registry
 - [x] Data Providers (read-only model)
 - [x] Operator Commands (control surface)
@@ -409,7 +409,7 @@
 - [x] game-specific asset ownership enforced
 - [x] shared-vs-game utility boundaries enforced
 - [x] space_invaders normalized
-- [x] puckman normalized
+- [x] pacman normalized
 - [x] future games follow template-first path
 
 ---
@@ -707,7 +707,7 @@
 ## 18. Engine Finalization & Hardening (Deferred Execution)
 
 > Purpose: convert the built system into a clean, stable, production-grade engine after all major capability tracks are complete.  
-> This is NOT a scaffolding phase — it is a consolidation + enforcement phase.
+> This is NOT a scaffolding phase — it is a consolidation + enforcement phase.
 
 ### Scope Rules
 - additive only (no blind refactors)
@@ -721,36 +721,36 @@
 [ ] Clean boundaries
 [ ] Document contracts
 
-### Track A — Engine Usage Enforcement
+### Track A — Engine Usage Enforcement
 - [x] verify all `samples/` use engine systems (no local reimplementation)
 - [.] verify all `games/` use engine systems
 - [x] migrate any local logic into engine/shared where appropriate
 - [ ] remove sample-specific logic from engine paths
 
-### Track B — Boundary Hardening
+### Track B — Boundary Hardening
 - [.] enforce engine vs shared vs game vs tool boundaries
 - [.] eliminate cross-layer leakage
 - [.] validate dependency direction rules across repo
 - [ ] remove accidental coupling
 
-### Track C — Contract Stabilization
+### Track C — Contract Stabilization
 - [.] finalize engine public APIs
 - [.] finalize shared contracts
 - [ ] ensure selectors/providers are stable
 - [.] remove unstable or experimental surfaces
 
-### Track D — Codebase Consistency
+### Track D — Codebase Consistency
 - [ ] single class per file enforcement
 - [ ] remove duplicate helpers
 - [ ] normalize naming consistency
 - [ ] eliminate import/export anti-patterns
 
-### Track E — CSS & UI Normalization
+### Track E — CSS & UI Normalization
 - [ ] flatten CSS layers
 - [ ] enforce shared UI classes
 - [ ] remove redundant styles
 
-### Track F — Docs System Cleanup
+### Track F — Docs System Cleanup
 [ ] Docs organization: classify all `./docs/` into buckets.
 
 [ ] Arrange docs into classification buckets.
@@ -761,15 +761,15 @@
 - [ ] remove move-only historical docs (after validation)
 - [ ] align docs to feature-based structure
 
-### Track G — Repo Hygiene
+### Track G — Repo Hygiene
 [ ] Remove imports to export (should not be import x, export x)
 [ ] Other than templates (games/samples/tools), remove the .keep file, if the folder is empty, delete
 - [ ] remove unnecessary `.keep` files
 - [ ] remove empty folders
 - [ ] validate folder ownership rules
 - [ ] enforce clean repo structure
 
-### Track H — PR Consolidation Strategy
+### Track H — PR Consolidation Strategy
 - [ ] bundle related PRs into capability-level units
 - [ ] reduce multi-PR fragmentation
 - [ ] ensure each PR represents a complete capability
@@ -786,7 +786,7 @@
 - no experimental work
 - only stabilization, validation, and extensibility
 
-### Track A — System Integration Validation
+### Track A — System Integration Validation
 - [.] validate all major systems working together:
   - rendering
   - input
@@ -797,45 +797,45 @@
 - [.] verify no hidden coupling
 - [.] verify predictable system interaction
 
-### Track B — Runtime Lifecycle Validation
-- [ ] validate boot → run → shutdown lifecycle
+### Track B — Runtime Lifecycle Validation
+- [ ] validate boot ? run ? shutdown lifecycle
 - [ ] validate hot reload / reset flows
 - [ ] validate error handling paths
 - [ ] validate long-running stability
 
-### Track C — Performance & Scaling
+### Track C — Performance & Scaling
 - [.] validate large scene performance
 - [.] validate stress scenarios (1k+ entities)
 - [.] validate memory stability
 - [.] identify bottlenecks
 
-### Track D — Debug & Observability Maturity
+### Track D — Debug & Observability Maturity
 - [ ] ensure all systems expose debug data
 - [x] ensure providers are complete and consistent
 - [x] validate debug panels across systems
 - [x] confirm production-safe debug toggling
 
-### Track E — Toolchain Validation
+### Track E — Toolchain Validation
 - [ ] verify tools integrate cleanly with engine
 - [ ] validate asset pipelines end-to-end
-- [ ] validate editor → runtime consistency
+- [ ] validate editor ? runtime consistency
 - [ ] confirm no tool-specific logic leaks into engine
 
-### Track F — Sample & Game Validation
+### Track F — Sample & Game Validation
 - [.] Organize/rebuild `samples/` and `games/` as if newly constructed, with proper classes/data in proper folders.
 - [.] Simulated code (for example, some network samples) should be converted to real networks, with tests as needed.
 - [.] verify all samples still function correctly
 - [ ] verify curriculum progression remains intact
 - [ ] validate games follow template strictly
 - [ ] confirm no regression across phases
 
-### Track G — Extensibility Readiness
+### Track G — Extensibility Readiness
 - [x] validate plugin/extension patterns
 - [x] validate adding new systems is clean
 - [x] validate external integration points
 - [x] ensure future phases can build cleanly
 
-### Track H — Final Stability Gate
+### Track H — Final Stability Gate
 - [x] full-repo validation sweep
 - [x] zero regression requirement
 - [x] contract freeze readiness

docs/pr/BUILD_PR_LEVEL_08_04_PUCKMAN_BOUNDARY_NORMALIZATION.md

@@ -1,7 +1,7 @@
-# BUILD_PR_LEVEL_08_04_PUCKMAN_BOUNDARY_NORMALIZATION
+# BUILD_PR_LEVEL_08_04_PACMAN_BOUNDARY_NORMALIZATION
 
 ## Purpose
-Normalize **Puckman** to the Phase 08 games-layer boundary model only.
+Normalize **Pacman** to the Phase 08 games-layer boundary model only.
 
 This PR is intentionally narrow:
 - no engine edits
@@ -20,37 +20,37 @@ What is now true:
 What is still not true:
 - repo-wide flow standardization is not earned
 - shared-vs-game utility enforcement is not earned
-- Puckman normalization is still not earned
+- Pacman normalization is still not earned
 - full current-games migration is still not earned
 
 The smallest valid next move is:
-1. normalize **Puckman** to the same game-local boundary model used for focused game migrations,
+1. normalize **Pacman** to the same game-local boundary model used for focused game migrations,
 2. keep the PR game-local and surgical,
 3. update Phase 08 status only where actually earned.
 
 ## Required boundary target
-Puckman should follow this ownership model:
+Pacman should follow this ownership model:
 
-- `games/Puckman/flow/*`
+- `games/Pacman/flow/*`
   - attract / intro / highscore flow modules when those states exist
   - no duplicated rule constants
-- `games/Puckman/game/*`
+- `games/Pacman/game/*`
   - runtime orchestration and scene wiring only
-- `games/Puckman/entities/*`
+- `games/Pacman/entities/*`
   - player, ghost, pellet, fruit, tunnel, collision-domain entities
-- `games/Puckman/levels/*`
+- `games/Pacman/levels/*`
   - maze/layout/start-state progression definitions
-- `games/Puckman/rules/*`
+- `games/Pacman/rules/*`
   - authoritative game-local constants and flow/rules contracts
-- `games/Puckman/assets/*` and platform-local assets
-  - only Puckman-owned media/content
-- `games/Puckman/systems/*` and `games/Puckman/utils/*`
+- `games/Pacman/assets/*` and platform-local assets
+  - only Pacman-owned media/content
+- `games/Pacman/systems/*` and `games/Pacman/utils/*`
   - game-specific helpers only
 
 ## Implementation goals
 Codex should make only the smallest changes needed to achieve the following:
 
-1. Create or normalize a Puckman rules surface
+1. Create or normalize a Pacman rules surface
    - add a game-local rules module if missing
    - move duplicated flow/gameplay constants there
    - make flow + gameplay import from one source of truth
@@ -65,7 +65,7 @@ Codex should make only the smallest changes needed to achieve the following:
    - keep scene/runtime files focused on orchestration
 
 4. Preserve game-local ownership
-   - do not move Puckman assets/utilities into shared unless they are already clearly cross-game
+   - do not move Pacman assets/utilities into shared unless they are already clearly cross-game
    - do not pull engine utilities into the game folder
 
 5. Update status truthfully
@@ -82,14 +82,14 @@ Codex should make only the smallest changes needed to achieve the following:
 - no Phase 09+ work
 
 ## Expected touched areas
-- `games/Puckman/flow/*`
-- `games/Puckman/game/*`
-- `games/Puckman/rules/*`
-- optional: `games/Puckman/entities/*`, `levels/*`, `systems/*`, `utils/*`
+- `games/Pacman/flow/*`
+- `games/Pacman/game/*`
+- `games/Pacman/rules/*`
+- optional: `games/Pacman/entities/*`, `levels/*`, `systems/*`, `utils/*`
 - roadmap/status docs only if already part of the repo’s active tracking files
 
 ## Acceptance criteria
-- Puckman has a clear local boundary split for flow/game/rules
+- Pacman has a clear local boundary split for flow/game/rules
 - no duplicated flow-rule constants across flow and gameplay
 - gameplay scene/runtime files consume rules constants instead of defining them
 - no engine files changed
@@ -108,14 +108,14 @@ Still not earned from the uploaded PRs:
 - [ ] gameplay/entities/levels/rules/assets boundaries normalized
 - [ ] shared-vs-game utility boundaries enforced
 - [ ] space_invaders normalized
-- [ ] puckman normalized
+- [ ] pacman normalized
 - [ ] future games follow template-first path
 
 ## Suggested commit title
-`build(games): normalize puckman boundaries for phase 08`
+`build(games): normalize pacman boundaries for phase 08`
 
 ## After this PR
-Phase 08 should be reassessed strictly from repo truth. Likely remaining work after Puckman will be:
+Phase 08 should be reassessed strictly from repo truth. Likely remaining work after Pacman will be:
 - Space Invaders normalization, if not already fully implemented in repo
 - shared-vs-game utility boundary enforcement
 - final truthful status alignment

docs/pr/BUILD_PR_LEVEL_08_05_SPACE_INVADERS_COMPLETION.md

@@ -1,7 +1,7 @@
 # BUILD_PR — LEVEL 08.05 SPACE INVADERS COMPLETION
 
 ## Purpose
-Complete Space Invaders boundary normalization to match Asteroids and Puckman.
+Complete Space Invaders boundary normalization to match Asteroids and Pacman.
 
 ## Scope
 - Only Space Invaders game folder