Stabilize remaining post-refactor tests by fixing one behavioral assertion failure and one sandbox-sensitive validator execution path without reopening stale-path migration work.

&
Clean up shared extraction guard violations and restore pretest to a reliable repo signal with minimal, documented changes.

Author: ToolboxAid

scripts/run-node-tests.mjs

@@ -4,4 +4,22 @@ David Quesenberry
 03/21/2026
 run-node-tests.mjs
 */
-import '../tests/run-tests.mjs';
+import path from 'node:path';
+import { registerHooks } from 'node:module';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+
+const repoRoot = fileURLToPath(new URL('..', import.meta.url));
+const ROOT_ALIASES = ['/src/', '/games/', '/tools/', '/samples/'];
+
+registerHooks({
+  resolve(specifier, context, nextResolve) {
+    if (ROOT_ALIASES.some((prefix) => specifier.startsWith(prefix))) {
+      const resolved = pathToFileURL(path.join(repoRoot, specifier.slice(1))).href;
+      return nextResolve(resolved, context);
+    }
+
+    return nextResolve(specifier, context);
+  },
+});
+
+await import('../tests/run-tests.mjs');

scripts/validate-games-template-contract.mjs

@@ -141,7 +141,7 @@ async function validateTarget(target) {
   return { issues, notes };
 }
 
-async function main() {
+export async function validateGamesTemplateContract({ emitLogs = true } = {}) {
   const issues = [];
   const notes = [];
 
@@ -174,14 +174,40 @@ async function main() {
   await fs.writeFile(REPORT_PATH, `${reportLines.join("\n")}\n`, "utf8");
 
   if (issues.length > 0) {
-    console.error("GAMES_TEMPLATE_CONTRACT_INVALID");
-    issues.forEach((issue) => console.error(`- ${issue}`));
-    process.exitCode = 1;
-    return;
+    if (emitLogs) {
+      console.error("GAMES_TEMPLATE_CONTRACT_INVALID");
+      issues.forEach((issue) => console.error(`- ${issue}`));
+    }
+    return {
+      status: "invalid",
+      issues,
+      notes,
+      targets,
+      reportPath: toRepoRelative(REPORT_PATH)
+    };
   }
 
-  console.log("GAMES_TEMPLATE_CONTRACT_VALID");
-  console.log(`Report: ${toRepoRelative(REPORT_PATH)}`);
+  if (emitLogs) {
+    console.log("GAMES_TEMPLATE_CONTRACT_VALID");
+    console.log(`Report: ${toRepoRelative(REPORT_PATH)}`);
+  }
+
+  return {
+    status: "valid",
+    issues,
+    notes,
+    targets,
+    reportPath: toRepoRelative(REPORT_PATH)
+  };
 }
 
-await main();
+async function main() {
+  const result = await validateGamesTemplateContract({ emitLogs: true });
+  if (result.status !== "valid") {
+    process.exitCode = 1;
+  }
+}
+
+if (process.argv[1] && path.resolve(process.argv[1]) === __filename) {
+  await main();
+}

tests/ai/AIBehaviors.test.mjs

@@ -12,7 +12,7 @@ import {
   findGridPath,
   stepChaseBehavior,
   stepEvadeBehavior,
-} from '/src/engine/ai/index.js';
+} from '../../src/engine/ai/index.js';
 
 export function run() {
   const grid = [

tests/assets/AssetLoaderSystem.test.mjs

@@ -5,9 +5,9 @@ David Quesenberry
 AssetLoaderSystem.test.mjs
 */
 import assert from 'node:assert/strict';
-import AssetRegistry from '/src/engine/assets/AssetRegistry.js';
-import ImageAssetLoader from '/src/engine/assets/ImageAssetLoader.js';
-import AssetLoaderSystem from '/src/engine/assets/AssetLoaderSystem.js';
+import AssetRegistry from '../../src/engine/assets/AssetRegistry.js';
+import ImageAssetLoader from '../../src/engine/assets/ImageAssetLoader.js';
+import AssetLoaderSystem from '../../src/engine/assets/AssetLoaderSystem.js';
 
 export async function run() {
   const registry = new AssetRegistry();

tests/audio/AudioService.test.mjs

@@ -5,7 +5,7 @@ David Quesenberry
 AudioService.test.mjs
 */
 import assert from 'node:assert/strict';
-import { AudioService } from '/src/engine/audio/index.js';
+import { AudioService } from '../../src/engine/audio/index.js';
 
 function createTarget() {
   const listeners = new Map();

tests/combat/Combat.test.mjs

@@ -14,7 +14,7 @@ import {
   startAttack,
   updateAttackState,
   updateCombatant,
-} from '/src/engine/combat/index.js';
+} from '../../src/engine/combat/index.js';
 
 export function run() {
   const attacker = createCombatant({ x: 100, y: 100, width: 30, height: 30, facing: 1 });

tests/config/ConfigStore.test.mjs

@@ -5,7 +5,7 @@ David Quesenberry
 ConfigStore.test.mjs
 */
 import assert from 'node:assert/strict';
-import ConfigStore from '/src/engine/config/ConfigStore.js';
+import ConfigStore from '../../src/engine/config/ConfigStore.js';
 
 export function run() {
   const store = new ConfigStore();

tests/core/EngineFullscreen.test.mjs

@@ -5,8 +5,8 @@
  EngineFullscreen.test.mjs
 */
 import assert from 'node:assert/strict';
-import Engine from '/src/engine/core/Engine.js';
-import { FullscreenService } from '/src/engine/runtime/index.js';
+import Engine from '../../src/engine/core/Engine.js';
+import { FullscreenService } from '../../src/engine/runtime/index.js';
 
 function createCanvas() {
   const canvas = {

tests/core/EngineSceneLifecycle.test.mjs

@@ -5,9 +5,9 @@
  EngineSceneLifecycle.test.mjs
 */
 import assert from 'node:assert/strict';
-import Engine from '/src/engine/core/Engine.js';
-import SceneTransition from '/src/engine/scenes/SceneTransition.js';
-import TransitionScene from '/src/engine/scenes/TransitionScene.js';
+import Engine from '../../src/engine/core/Engine.js';
+import SceneTransition from '../../src/engine/scenes/SceneTransition.js';
+import TransitionScene from '../../src/engine/scenes/TransitionScene.js';
 
 function createCanvas() {
   const canvas = {

tests/core/EngineTiming.test.mjs

@@ -5,9 +5,9 @@
  EngineTiming.test.mjs
 */
 import assert from 'node:assert/strict';
-import Engine from '/src/engine/core/Engine.js';
-import FrameClock from '/src/engine/core/FrameClock.js';
-import FixedTicker from '/src/engine/core/FixedTicker.js';
+import Engine from '../../src/engine/core/Engine.js';
+import FrameClock from '../../src/engine/core/FrameClock.js';
+import FixedTicker from '../../src/engine/core/FixedTicker.js';
 
 function createCanvas() {
   const canvas = {