1607 core loop

Author: DavidQ

docs/dev/CODEX_COMMANDS.md

@@ -1,39 +1,4 @@
+
 MODEL: GPT-5.3-codex
 REASONING: high
-
-COMMAND:
-Create BUILD_PR_LEVEL_17_12_SAMPLE_1606_PHYSICS_PLAYGROUND_IMPLEMENTATION.
-
-Goal:
-Implement a real, testable improvement to Sample 1606 so the physics playground visibly demonstrates gravity, bounce, and multi-object motion.
-
-Constraints:
-- one PR purpose only
-- smallest scoped valid change
-- no repo-wide scanning
-- no zip output from Codex
-- keep 2D and networking untouched
-- do not modify start_of_day
-
-Implement:
-1. Inspect samples/phase-16/1606/PhysicsPlayground3DScene.js.
-2. Increase visible gravity and bounce clarity.
-3. Ensure at least two or more objects show distinct readable motion/interaction.
-4. Keep camera/render readability simple and stable.
-5. Extend tests/runtime/Phase16VisibilitySanity.test.mjs only if a surgical targeted check is useful.
-6. Update docs/dev/reports/change_summary.txt and docs/dev/reports/validation_checklist.txt.
-
-Validate:
-- verify 1606 renders visible 3D content on load
-- verify gravity is visually obvious
-- verify bounce is clearly visible
-- verify multiple objects show distinct motion/interaction
-- run targeted smoke for 1606
-- run targeted affected sanity check
-- verify no 2D regression in targeted checks
-- verify no networking regression in targeted checks
-
-Output:
-- modify repo files directly
-- do not create any zip
-- keep commit-ready changes minimal
+Implement 1607 loop.

docs/dev/COMMIT_COMMENT.txt

@@ -1 +1 @@
-Implement a real visible physics playground improvement for Sample 1606 with targeted validation<BUILD_PR_LEVEL_17_12_SAMPLE_1606_PHYSICS_PLAYGROUND_IMPLEMENTATION>
+1607 core loop

docs/dev/reports/change_summary.txt

@@ -1,18 +1 @@
-BUILD_PR_LEVEL_17_12_SAMPLE_1606_PHYSICS_PLAYGROUND_IMPLEMENTATION
-
-Scope:
-- Updated only Sample 1606 runtime physics behavior plus a surgical 1606 sanity assertion update.
-- Kept 2D systems and networking runtime code untouched.
-
-Runtime changes:
-- Increased gravity strength for clearer vertical acceleration.
-- Tuned body profiles (size, bounce, mass, initial velocity) for readable and distinct motion.
-- Added lightweight AABB body-to-body collision resolution to make multi-object interaction visible.
-- Added collision telemetry line in the 1606 runtime panel for quick inspection.
-
-Validation evidence:
-- `node --input-type=module -e "... import('./tests/runtime/Phase16VisibilitySanity.test.mjs') ..."` -> PASS
-- `node -e "... LaunchSmokeAllEntries ... --sample-range=1606-1606"` -> PASS
-- `node -e "... LaunchSmokeAllEntries ... --sample-range=0101-0101"` -> PASS (focused 2D regression check)
-- `node -e "... import('./tests/final/MultiplayerNetworkingStack.test.mjs') ..."` -> PASS
-- `node -e "... import('./tests/final/NetworkDebugAndServerDashboardCloseout.test.mjs') ..."` -> PASS
+1607 adds playable loop

docs/dev/reports/launch_smoke_report.md

@@ -1,9 +1,9 @@
 # Launch Smoke Report
 
-Generated: 2026-04-15T21:30:19.616Z
+Generated: 2026-04-15T21:41:25.257Z
 
-Filters: games=false, samples=true, tools=false, sampleRange=0101-0101
+Filters: games=false, samples=true, tools=false, sampleRange=1607-1607
 
 | Status | Type | Label | Path | Notes | Steps |
 | --- | --- | --- | --- | --- | --- |
-| PASS | sample | 0101 | samples\phase-01\0101\index.html |  | npm install --prefix ./tmp ws → npm run test:launch-smoke |
+| PASS | sample | 1607 | samples\phase-16\1607\index.html |  | npm install --prefix ./tmp ws → npm run test:launch-smoke |

docs/dev/reports/validation_checklist.txt

@@ -1,10 +1,4 @@
-Sample 1606 implementation checklist
-[x] 1606 renders visible 3D content on load
-[x] gravity is visually obvious
-[x] bounce is clearly visible
-[x] multiple objects show distinct motion/interaction
-[x] sample is readable without extra explanation
-[x] targeted affected sanity passes
-[x] targeted smoke for 1606 passes
-[x] no 2D regression observed in targeted checks
-[x] no networking regression observed in targeted checks
+
+[ ] movement
+[ ] shooting
+[ ] hit

docs/pr/BUILD_PR_LEVEL_17_13_SAMPLE_1607_SPACE_SHOOTER_CORE_LOOP.md

@@ -0,0 +1,2 @@
+
+Core loop PR for 1607: movement, shooting, hit detection. Testable only.

samples/phase-16/1607/SpaceShooter3DScene.js

@@ -28,6 +28,14 @@ function createAsteroid(seed) {
   };
 }
 
+function getCenter(transform3D, size3D) {
+  return {
+    x: transform3D.x + size3D.width * 0.5,
+    y: transform3D.y + size3D.height * 0.5,
+    z: transform3D.z + size3D.depth * 0.5,
+  };
+}
+
 export default class SpaceShooter3DScene extends Scene {
   constructor() {
     super();
@@ -48,8 +56,16 @@ export default class SpaceShooter3DScene extends Scene {
     this.bulletSpeed = 26;
     this.asteroidSpeed = 7.5;
     this.fireCooldown = 0;
+    this.bulletHitPadding = 1.2;
     this.score = 0;
     this.misses = 0;
+    this.loopMissLimit = 10;
+    this.loopNumber = 1;
+    this.loopElapsedSeconds = 0;
+    this.loopScoreAtStart = 0;
+    this.lastLoopScore = 0;
+    this.lastLoopReason = 'active';
+    this.resetLatch = false;
   }
 
   setCamera3D(camera3D) {
@@ -83,8 +99,33 @@ export default class SpaceShooter3DScene extends Scene {
     asteroid.driftY = ((seed * 5) % 10 - 5) * 0.11;
   }
 
+  startLoop(reason = 'manual-reset') {
+    this.lastLoopReason = reason;
+    this.lastLoopScore = this.score - this.loopScoreAtStart;
+    this.loopNumber += 1;
+    this.loopElapsedSeconds = 0;
+    this.loopScoreAtStart = this.score;
+    this.misses = 0;
+    this.fireCooldown = 0;
+    this.bullets = [];
+    this.ship.transform3D.x = 0;
+    this.ship.transform3D.y = 0;
+    this.ship.transform3D.z = 6.5;
+
+    this.asteroids.forEach((asteroid, asteroidIndex) => {
+      this.resetAsteroid(asteroid, asteroidIndex + this.loopNumber * 11);
+    });
+    this.syncCamera();
+  }
+
   step3DPhysics(dt, engine) {
     const input = engine.input;
+    const resetPressed = input?.isDown('KeyR') === true;
+    if (resetPressed && !this.resetLatch) {
+      this.startLoop('manual-reset');
+    }
+    this.resetLatch = resetPressed;
+
     const moveX = (input?.isDown('KeyD') ? 1 : 0) - (input?.isDown('KeyA') ? 1 : 0);
     const moveY = (input?.isDown('KeyW') ? 1 : 0) - (input?.isDown('KeyS') ? 1 : 0);
     const moveLength = Math.hypot(moveX, moveY) || 1;
@@ -97,21 +138,63 @@ export default class SpaceShooter3DScene extends Scene {
     this.fireCooldown = Math.max(0, this.fireCooldown - dt);
     const firePressed = input?.isDown('Space') === true;
     if (firePressed && this.fireCooldown <= 0) {
+      const bulletSize = { width: 0.25, height: 0.25, depth: 0.8 };
+      const bulletTransform = {
+        x: this.ship.transform3D.x + this.ship.size3D.width * 0.5 - bulletSize.width * 0.5,
+        y: this.ship.transform3D.y + this.ship.size3D.height * 0.5 - bulletSize.height * 0.5,
+        z: this.ship.transform3D.z + 1.7,
+      };
+      const bulletCenter = getCenter(bulletTransform, bulletSize);
+
+      let target = null;
+      for (const asteroid of this.asteroids) {
+        if (asteroid.transform3D.z + asteroid.size3D.depth < bulletTransform.z) {
+          continue;
+        }
+        if (!target || asteroid.transform3D.z < target.transform3D.z) {
+          target = asteroid;
+        }
+      }
+
+      let velocityX = 0;
+      let velocityY = 0;
+      let velocityZ = this.bulletSpeed;
+      if (target) {
+        const targetCenter = getCenter(target.transform3D, target.size3D);
+        const dx = targetCenter.x - bulletCenter.x;
+        const dy = targetCenter.y - bulletCenter.y;
+        const dz = Math.max(0.8, targetCenter.z - bulletCenter.z);
+        const magnitude = Math.hypot(dx, dy, dz) || 1;
+        velocityX = (dx / magnitude) * this.bulletSpeed;
+        velocityY = (dy / magnitude) * this.bulletSpeed;
+        velocityZ = (dz / magnitude) * this.bulletSpeed;
+      }
+
       this.bullets.push({
-        transform3D: {
-          x: this.ship.transform3D.x + 0.38,
-          y: this.ship.transform3D.y + 0.2,
-          z: this.ship.transform3D.z + 1.7,
-        },
-        size3D: { width: 0.25, height: 0.25, depth: 0.8 },
+        transform3D: bulletTransform,
+        previousTransform3D: { ...bulletTransform },
+        size3D: bulletSize,
+        velocity3D: { x: velocityX, y: velocityY, z: velocityZ },
       });
       this.fireCooldown = 0.13;
     }
 
     this.bullets.forEach((bullet) => {
-      bullet.transform3D.z += this.bulletSpeed * dt;
+      bullet.previousTransform3D.x = bullet.transform3D.x;
+      bullet.previousTransform3D.y = bullet.transform3D.y;
+      bullet.previousTransform3D.z = bullet.transform3D.z;
+      bullet.transform3D.x += bullet.velocity3D.x * dt;
+      bullet.transform3D.y += bullet.velocity3D.y * dt;
+      bullet.transform3D.z += bullet.velocity3D.z * dt;
     });
-    this.bullets = this.bullets.filter((bullet) => bullet.transform3D.z < 40);
+    this.bullets = this.bullets.filter(
+      (bullet) =>
+        bullet.transform3D.z < 40 &&
+        bullet.transform3D.x > -9 &&
+        bullet.transform3D.x < 9 &&
+        bullet.transform3D.y > -5 &&
+        bullet.transform3D.y < 7,
+    );
 
     this.asteroids.forEach((asteroid, asteroidIndex) => {
       asteroid.transform3D.z -= this.asteroidSpeed * dt;
@@ -133,12 +216,15 @@ export default class SpaceShooter3DScene extends Scene {
         const asteroid = this.asteroids[asteroidIndex];
         const collided = isAabbColliding3D(
           {
-            x: bullet.transform3D.x,
-            y: bullet.transform3D.y,
-            z: bullet.transform3D.z,
-            width: bullet.size3D.width,
-            height: bullet.size3D.height,
-            depth: bullet.size3D.depth,
+            x: Math.min(bullet.previousTransform3D.x, bullet.transform3D.x) - this.bulletHitPadding,
+            y: Math.min(bullet.previousTransform3D.y, bullet.transform3D.y) - this.bulletHitPadding,
+            z: Math.min(bullet.previousTransform3D.z, bullet.transform3D.z) - this.bulletHitPadding,
+            width: bullet.size3D.width + this.bulletHitPadding * 2,
+            height: bullet.size3D.height + this.bulletHitPadding * 2,
+            depth:
+              Math.abs(bullet.transform3D.z - bullet.previousTransform3D.z) +
+              bullet.size3D.depth +
+              this.bulletHitPadding * 2,
           },
           {
             x: asteroid.transform3D.x,
@@ -163,15 +249,20 @@ export default class SpaceShooter3DScene extends Scene {
       }
     }
 
+    this.loopElapsedSeconds += dt;
+    if (this.misses >= this.loopMissLimit) {
+      this.startLoop('miss-limit');
+    }
+
     this.syncCamera();
   }
 
   render(renderer) {
     drawFrame(renderer, theme, [
       'Sample 1607 - 3D Space Shooter',
-      'Pilot a ship lane, fire at incoming asteroids, and track score.',
-      'Move: W A S D | Fire: Space',
-      'Keep the asteroid lane clear before misses stack up.',
+      'Pilot a ship lane, fire at incoming asteroids, and track looping rounds.',
+      'Move: W A S D | Fire: Space | Reset round: R',
+      'Round auto-resets when misses reach the round limit.',
     ]);
 
     renderer.strokeRect(this.viewport.x, this.viewport.y, this.viewport.width, this.viewport.height, '#d8d5ff', 2);
@@ -202,13 +293,14 @@ export default class SpaceShooter3DScene extends Scene {
       drawWireBox(renderer, asteroid.transform3D, asteroid.size3D, cameraState, projectionViewport, '#fb7185', 2);
     });
 
-    drawPanel(renderer, 620, 34, 300, 126, 'Shooter Runtime', [
+    drawPanel(renderer, 620, 34, 300, 186, 'Shooter Runtime', [
       `Ship: x=${this.ship.transform3D.x.toFixed(2)} y=${this.ship.transform3D.y.toFixed(2)} z=${this.ship.transform3D.z.toFixed(2)}`,
       `Bullets: ${this.bullets.length} | Cooldown: ${this.fireCooldown.toFixed(2)} s`,
       `Asteroids: ${this.asteroids.length}`,
       `Score: ${this.score}`,
-      `Misses: ${this.misses}`,
+      `Round ${this.loopNumber} | Misses: ${this.misses}/${this.loopMissLimit}`,
+      `Round time: ${this.loopElapsedSeconds.toFixed(1)} s | Last round score: ${this.lastLoopScore}`,
+      `Last round reset: ${this.lastLoopReason}`,
     ]);
   }
 }
-