Create asteroids_new scaffold from template (non-destructive) &

DavidQ · DavidQ · commit 67a28a9bb74f · 2026-04-09T12:21:54.000-04:00
Add minimal boot wiring for asteroids_new &amp;
Copy first entity slice into new template structure
diff --git a/docs/dev/CODEX_COMMANDS.md b/docs/dev/CODEX_COMMANDS.md
@@ -1,7 +1,5 @@
 MODEL: GPT-5.4-codex
-REASONING: low
-
+REASONING: medium
 COMMAND:
-Execute docs/pr/BUILD_PR_GAMES_84_TEMPLATE_GITKEEP_STANDARDIZATION.md exactly.
-Package to:
-<project folder>/tmp/BUILD_PR_GAMES_84_TEMPLATE_GITKEEP_STANDARDIZATION_delta.zip
+Execute docs/pr/BUILD_PR_GAMES_87_ASTEROIDS_SINGLE_SLICE_MIGRATION.md exactly.
+Package to <project folder>/tmp/BUILD_PR_GAMES_87_ASTEROIDS_SINGLE_SLICE_MIGRATION_delta.zip
diff --git a/docs/dev/COMMIT_COMMENT.txt b/docs/dev/COMMIT_COMMENT.txt
@@ -1 +1 @@
-Standardize template placeholders to .gitkeep for Git tracking
+Copy first entity slice into new template structure
diff --git a/docs/dev/NEXT_COMMAND.txt b/docs/dev/NEXT_COMMAND.txt
@@ -1 +1 @@
-Next: begin first game migration to template
+Next: expand slice or validate
diff --git a/docs/dev/reports/change_summary.txt b/docs/dev/reports/change_summary.txt
@@ -1 +1 @@
-gitkeep standardization
+Copy first entity slice into new template structure
diff --git a/docs/dev/reports/file_tree.txt b/docs/dev/reports/file_tree.txt
@@ -1 +1,2 @@
-games/_template/**/.gitkeep
+games/asteroids/entities/*
+games/asteroids_new/entities/*
diff --git a/docs/dev/reports/validation_checklist.txt b/docs/dev/reports/validation_checklist.txt
@@ -1 +1 @@
-folders tracked by git
+exact files only; no behavior change
diff --git a/docs/pr/BUILD_PR_GAMES_85_ASTEROIDS_TEMPLATE_ADOPTION_SCAFFOLD.md b/docs/pr/BUILD_PR_GAMES_85_ASTEROIDS_TEMPLATE_ADOPTION_SCAFFOLD.md
@@ -0,0 +1,24 @@
+# BUILD PR — Asteroids Template Adoption (Scaffold, Non-Destructive)
+
+## Purpose
+Introduce template-aligned structure alongside existing Asteroids game without moving or deleting current files.
+
+## Files
+- games/asteroids_new/index.js
+- games/asteroids_new/flow/attract.js
+- games/asteroids_new/flow/intro.js
+- games/asteroids_new/entities/.gitkeep
+- games/asteroids_new/systems/.gitkeep
+- games/asteroids_new/levels/.gitkeep
+- games/asteroids_new/assets/.gitkeep
+- games/asteroids_new/ui/.gitkeep
+- games/asteroids_new/config/.gitkeep
+
+## Actions
+- create a parallel scaffold following games/_template
+- no wiring to existing game
+- no deletions
+
+## Constraints
+- exact files only
+- non-destructive
diff --git a/docs/pr/BUILD_PR_GAMES_86_ASTEROIDS_TEMPLATE_MINIMAL_WIRING.md b/docs/pr/BUILD_PR_GAMES_86_ASTEROIDS_TEMPLATE_MINIMAL_WIRING.md
@@ -0,0 +1,12 @@
+# BUILD PR — Asteroids Template Minimal Wiring
+
+## Files
+- games/asteroids_new/index.js
+
+## Actions
+- wire minimal boot using template structure
+- no dependency changes to existing asteroids
+
+## Constraints
+- exact file only
+- no refactor
diff --git a/docs/pr/BUILD_PR_GAMES_87_ASTEROIDS_SINGLE_SLICE_MIGRATION.md b/docs/pr/BUILD_PR_GAMES_87_ASTEROIDS_SINGLE_SLICE_MIGRATION.md
@@ -0,0 +1,13 @@
+# BUILD PR — Asteroids Single Slice Migration (Entities)
+
+## Files
+- games/asteroids/entities/*
+- games/asteroids_new/entities/*
+
+## Actions
+- copy one small entity slice into new structure
+- do not delete original
+
+## Constraints
+- exact files only
+- copy, not move
diff --git a/games/asteroids_new/assets/.gitkeep b/games/asteroids_new/assets/.gitkeep
diff --git a/games/asteroids_new/config/.gitkeep b/games/asteroids_new/config/.gitkeep
diff --git a/games/asteroids_new/entities/.gitkeep b/games/asteroids_new/entities/.gitkeep
diff --git a/games/asteroids_new/entities/Bullet.js b/games/asteroids_new/entities/Bullet.js
@@ -0,0 +1,37 @@
+/*
+Toolbox Aid
+David Quesenberry
+03/22/2026
+Bullet.js
+*/
+import { wrap } from '../utils/math.js';
+
+export default class Bullet {
+  constructor(x, y, vx, vy, life = 1.1) {
+    this.x = x;
+    this.y = y;
+    this.vx = vx;
+    this.vy = vy;
+    this.life = life;
+    this.radius = 2;
+  }
+
+  update(dtSeconds, bounds) {
+    this.x = wrap(this.x + this.vx * dtSeconds, bounds.width);
+    this.y = wrap(this.y + this.vy * dtSeconds, bounds.height);
+    this.life -= dtSeconds;
+  }
+
+  isAlive() {
+    return this.life > 0;
+  }
+
+  getCollisionPolygon() {
+    return [
+      { x: this.x - this.radius, y: this.y - this.radius },
+      { x: this.x + this.radius, y: this.y - this.radius },
+      { x: this.x + this.radius, y: this.y + this.radius },
+      { x: this.x - this.radius, y: this.y + this.radius },
+    ];
+  }
+}
diff --git a/games/asteroids_new/flow/attract.js b/games/asteroids_new/flow/attract.js
@@ -0,0 +1,4 @@
+export const attractFlow = Object.freeze({
+  id: "attract",
+  label: "Attract"
+});
diff --git a/games/asteroids_new/flow/intro.js b/games/asteroids_new/flow/intro.js
@@ -0,0 +1,4 @@
+export const introFlow = Object.freeze({
+  id: "intro",
+  label: "Intro"
+});
diff --git a/games/asteroids_new/index.js b/games/asteroids_new/index.js
@@ -0,0 +1,39 @@
+import { attractFlow } from "./flow/attract.js";
+import { introFlow } from "./flow/intro.js";
+
+export const asteroidFlow = Object.freeze({
+  attract: attractFlow,
+  intro: introFlow
+});
+
+export function createAsteroidsTemplateBoot(initialFlow = "attract") {
+  let currentFlowId = Object.prototype.hasOwnProperty.call(asteroidFlow, initialFlow)
+    ? initialFlow
+    : "attract";
+
+  function getCurrentFlow() {
+    return asteroidFlow[currentFlowId];
+  }
+
+  function setFlow(nextFlowId) {
+    if (Object.prototype.hasOwnProperty.call(asteroidFlow, nextFlowId)) {
+      currentFlowId = nextFlowId;
+    }
+    return getCurrentFlow();
+  }
+
+  function start() {
+    return getCurrentFlow();
+  }
+
+  return Object.freeze({
+    get currentFlowId() {
+      return currentFlowId;
+    },
+    getCurrentFlow,
+    setFlow,
+    start
+  });
+}
+
+export default asteroidFlow;
diff --git a/games/asteroids_new/levels/.gitkeep b/games/asteroids_new/levels/.gitkeep
diff --git a/games/asteroids_new/systems/.gitkeep b/games/asteroids_new/systems/.gitkeep
diff --git a/games/asteroids_new/ui/.gitkeep b/games/asteroids_new/ui/.gitkeep

Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-Standardize template placeholders to .gitkeep for Git tracking`
	`1`	`+Copy first entity slice into new template structure`
Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-Next: begin first game migration to template`
	`1`	`+Next: expand slice or validate`
Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-gitkeep standardization`
	`1`	`+Copy first entity slice into new template structure`
Original file line number	Diff line number	Diff line change
`@@ -1 +1,2 @@`
`1`		`-games/_template/**/.gitkeep`
	`1`	`+games/asteroids/entities/*`
	`2`	`+games/asteroids_new/entities/*`
Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-folders tracked by git`
	`1`	`+exact files only; no behavior change`