Merge PR_26177_ALFA_061-game-configuration-foundation

# Conflicts:
#	tests/playwright/tools/GameConfigurationApiBehavior.spec.mjs
#	tests/playwright/tools/GameConfigurationApiDb.spec.mjs
#	tests/playwright/tools/GameConfigurationMockRepository.spec.mjs

Author: ToolboxAid

assets/toolbox/game-configuration/js/index.js

@@ -33,25 +33,41 @@ const elements = {
   form: document.querySelector("[data-game-configuration-form]"),
   formCard: document.querySelector("[data-game-configuration-form-card]"),
   gameBasics: document.querySelector("[data-game-configuration-game-basics]"),
+  gameDetails: document.querySelector("[data-game-configuration-game-details]"),
+  gameName: document.querySelector("[data-game-configuration-game-name]"),
   gameRules: document.querySelector("[data-game-configuration-game-rules]"),
+  gameType: document.querySelector("[data-game-configuration-game-type]"),
   handoffContext: document.querySelector("[data-game-configuration-handoff-context]"),
   handoffOverlay: document.querySelector("[data-game-configuration-handoff-overlay]"),
   missingItems: document.querySelector("[data-game-configuration-output-missing]"),
   objectSetup: document.querySelector("[data-game-configuration-object-setup]"),
   outputCapability: document.querySelector("[data-game-configuration-output-capability]"),
+  outputDetails: document.querySelector("[data-game-configuration-output-details]"),
+  outputGameType: document.querySelector("[data-game-configuration-output-game-type]"),
+  outputName: document.querySelector("[data-game-configuration-output-name]"),
   outputNextStep: document.querySelector("[data-game-configuration-output-next-step]"),
+  outputPlatforms: document.querySelector("[data-game-configuration-output-platforms]"),
   outputPlayerMode: document.querySelector("[data-game-configuration-output-player-mode]"),
   outputReadiness: document.querySelector("[data-game-configuration-output-readiness]"),
+  outputResolution: document.querySelector("[data-game-configuration-output-resolution]"),
+  outputStartup: document.querySelector("[data-game-configuration-output-startup]"),
   outputSummary: document.querySelector("[data-game-configuration-output-summary]"),
+  outputVersion: document.querySelector("[data-game-configuration-output-version]"),
+  outputVisibility: document.querySelector("[data-game-configuration-output-visibility]"),
+  platforms: document.querySelector("[data-game-configuration-platforms]"),
   playerSetup: document.querySelector("[data-game-configuration-player-setup]"),
   progressCurrentFocus: document.querySelector("[data-game-configuration-current-focus]"),
   progressGame: document.querySelector("[data-game-configuration-game-progress]"),
   progressPublishing: document.querySelector("[data-game-configuration-publishing-progress]"),
   progressRecommended: document.querySelectorAll("[data-game-configuration-recommended-tool]"),
+  resolution: document.querySelector("[data-game-configuration-resolution]"),
   statusLog: document.querySelector("[data-game-configuration-log]"),
+  startupSettings: document.querySelector("[data-game-configuration-startup-settings]"),
   testReadiness: document.querySelector("[data-game-configuration-test-readiness]"),
   validationList: document.querySelector("[data-game-configuration-validation-list]"),
   validationOverlay: document.querySelector("[data-game-configuration-validation-overlay]"),
+  version: document.querySelector("[data-game-configuration-version]"),
+  visibility: document.querySelector("[data-game-configuration-visibility]"),
   worldSetup: document.querySelector("[data-game-configuration-world-setup]")
 };
 
@@ -93,10 +109,16 @@ function readForm() {
   return {
     audioSetup: elements.audioSetup?.value,
     gameBasics: elements.gameBasics?.value,
+    gameDetails: elements.gameDetails?.value,
     gameRules: elements.gameRules?.value,
     objectSetup: elements.objectSetup?.value,
+    platforms: elements.platforms?.value,
     playerSetup: elements.playerSetup?.value,
+    resolution: elements.resolution?.value,
+    startupSettings: elements.startupSettings?.value,
     testReadiness: elements.testReadiness?.value,
+    version: elements.version?.value,
+    visibility: elements.visibility?.value,
     worldSetup: elements.worldSetup?.value
   };
 }
@@ -108,6 +130,15 @@ function clearForm() {
       input.value = "";
     }
   });
+  if (elements.version) {
+    elements.version.value = "";
+  }
+  if (elements.resolution) {
+    elements.resolution.value = "1280x720";
+  }
+  if (elements.visibility) {
+    elements.visibility.value = "Private";
+  }
 }
 
 function applyConfigurationToForm(configuration) {
@@ -122,6 +153,15 @@ function applyConfigurationToForm(configuration) {
       input.value = configuration[section] || "";
     }
   });
+  if (elements.version) {
+    elements.version.value = configuration.version || "";
+  }
+  if (elements.resolution) {
+    elements.resolution.value = configuration.resolution || "1280x720";
+  }
+  if (elements.visibility) {
+    elements.visibility.value = configuration.visibility || "Private";
+  }
 }
 
 function renderValidation(validation) {
@@ -159,16 +199,36 @@ function renderHandoff(snapshot) {
   }
 }
 
+function inheritedGameName(snapshot) {
+  return snapshot.handoff.activeProject?.name || snapshot.handoff.activeGame?.name || "";
+}
+
+function inheritedGameType(snapshot) {
+  return snapshot.handoff.activeProject?.gameType || snapshot.handoff.activeDesign?.gameType || snapshot.handoff.activeProject?.purpose || "";
+}
+
 function renderOutput(snapshot) {
   const configuration = snapshot.configuration;
   const validation = snapshot.validation;
+  const gameName = configuration?.gameName || inheritedGameName(snapshot);
+  const gameType = inheritedGameType(snapshot);
   const missing = validation.findings.map((finding) => finding.label).join(", ");
   const summary = configuration?.gameBasics || "No configuration summary saved yet.";
   const activeGame = snapshot.handoff.activeGame || snapshot.handoff.activeProject;
   const capability = activeGame?.purpose === "Capability Demo"
     ? `${activeGame.name} remains a game-owned capability demo.`
     : "Standard game configuration.";
 
+  setText(elements.gameName, gameName || "From Game Hub");
+  setText(elements.gameType, gameType || "From Game Hub");
+  setText(elements.outputName, gameName || "No game name saved yet.");
+  setText(elements.outputGameType, gameType || "No game type inherited yet.");
+  setText(elements.outputDetails, configuration?.gameDetails || "No game details saved yet.");
+  setText(elements.outputVersion, configuration?.version || "No version saved yet.");
+  setText(elements.outputResolution, configuration?.resolution || "No resolution saved yet.");
+  setText(elements.outputPlatforms, configuration?.platforms || "No platforms saved yet.");
+  setText(elements.outputVisibility, configuration?.visibility || "No visibility saved yet.");
+  setText(elements.outputStartup, configuration?.startupSettings || "No startup settings saved yet.");
   setText(elements.outputSummary, summary);
   setText(elements.outputPlayerMode, configuration?.playerMode || snapshot.handoff.activeDesign?.playerMode || "1 Player");
   setText(elements.outputReadiness, snapshot.progressHandoff.readinessStatus);
@@ -222,7 +282,7 @@ elements.form?.addEventListener("submit", (event) => {
 
   const configuration = repository.updateConfiguration(projectId, readForm());
   const nextSnapshot = repository.getSnapshot();
-  const message = configuration?.status === "Ready"
+  const message = configuration?.status === "Ready" || nextSnapshot.progressHandoff.readinessStatus === "Ready"
     ? "Saved Game Configuration as ready. Assets is the recommended next tool."
     : `Saved Game Configuration with ${nextSnapshot.validation.findings.length} missing item${nextSnapshot.validation.findings.length === 1 ? "" : "s"}.`;
 

docs_build/database/ddl/game-configuration.sql

@@ -8,15 +8,44 @@
 CREATE TABLE IF NOT EXISTS game_configuration_records (
     key text PRIMARY KEY,
     "gameKey" text REFERENCES game_workspace_games(key),
+    "gameDetails" text,
+    "version" text,
+    "resolution" text,
+    "platforms" text,
+    "visibility" text,
+    "startupSettings" text,
     "status" text,
     "summary" text,
     "playerMode" text,
+    "gameBasics" text,
+    "gameRules" text,
+    "playerSetup" text,
+    "worldSetup" text,
+    "objectSetup" text,
+    "audioSetup" text,
+    "testReadiness" text,
     "createdAt" timestamptz NOT NULL DEFAULT now(),
     "updatedAt" timestamptz NOT NULL DEFAULT now(),
     "createdBy" text NOT NULL REFERENCES users(key),
     "updatedBy" text NOT NULL REFERENCES users(key)
 );
 
+ALTER TABLE game_configuration_records ADD COLUMN IF NOT EXISTS "gameDetails" text;
+ALTER TABLE game_configuration_records ADD COLUMN IF NOT EXISTS "version" text;
+ALTER TABLE game_configuration_records ADD COLUMN IF NOT EXISTS "resolution" text;
+ALTER TABLE game_configuration_records ADD COLUMN IF NOT EXISTS "platforms" text;
+ALTER TABLE game_configuration_records ADD COLUMN IF NOT EXISTS "visibility" text;
+ALTER TABLE game_configuration_records ADD COLUMN IF NOT EXISTS "startupSettings" text;
+ALTER TABLE game_configuration_records ADD COLUMN IF NOT EXISTS "summary" text;
+ALTER TABLE game_configuration_records ADD COLUMN IF NOT EXISTS "playerMode" text;
+ALTER TABLE game_configuration_records ADD COLUMN IF NOT EXISTS "gameBasics" text;
+ALTER TABLE game_configuration_records ADD COLUMN IF NOT EXISTS "gameRules" text;
+ALTER TABLE game_configuration_records ADD COLUMN IF NOT EXISTS "playerSetup" text;
+ALTER TABLE game_configuration_records ADD COLUMN IF NOT EXISTS "worldSetup" text;
+ALTER TABLE game_configuration_records ADD COLUMN IF NOT EXISTS "objectSetup" text;
+ALTER TABLE game_configuration_records ADD COLUMN IF NOT EXISTS "audioSetup" text;
+ALTER TABLE game_configuration_records ADD COLUMN IF NOT EXISTS "testReadiness" text;
+
 CREATE INDEX IF NOT EXISTS idx_game_configuration_records_gamekey ON game_configuration_records ("gameKey");
 CREATE INDEX IF NOT EXISTS idx_game_configuration_records_createdby ON game_configuration_records ("createdBy");
 CREATE INDEX IF NOT EXISTS idx_game_configuration_records_updatedby ON game_configuration_records ("updatedBy");
@@ -36,6 +65,7 @@ ALTER TABLE game_configuration_records ADD COLUMN IF NOT EXISTS "testReadiness"
 CREATE TABLE IF NOT EXISTS game_configuration_validation_items (
     key text PRIMARY KEY,
     "gameKey" text REFERENCES game_workspace_games(key),
+    "section" text,
     "label" text,
     "status" text,
     "action" text,
@@ -45,6 +75,8 @@ CREATE TABLE IF NOT EXISTS game_configuration_validation_items (
     "updatedBy" text NOT NULL REFERENCES users(key)
 );
 
+ALTER TABLE game_configuration_validation_items ADD COLUMN IF NOT EXISTS "section" text;
+
 CREATE INDEX IF NOT EXISTS idx_game_configuration_validation_items_gamekey ON game_configuration_validation_items ("gameKey");
 CREATE INDEX IF NOT EXISTS idx_game_configuration_validation_items_createdby ON game_configuration_validation_items ("createdBy");
 CREATE INDEX IF NOT EXISTS idx_game_configuration_validation_items_updatedby ON game_configuration_validation_items ("updatedBy");

docs_build/database/seed/game-configuration.json

@@ -8,5 +8,5 @@
     "game_configuration_records": [],
     "game_configuration_validation_items": []
   },
-  "note": "Seed records for this group are intentionally empty until an Admin-owned server API seeds them."
+  "note": "Game Configuration records are server/API-owned. Browser pages must not seed or generate authoritative configuration records."
 }

docs_build/dev/reports/PR_26177_ALFA_061-game-configuration-foundation_branch-validation.md

@@ -0,0 +1,10 @@
+# PR_26177_ALFA_061-game-configuration-foundation Branch Validation
+
+Generated: 2026-06-26 20:51:40 UTC
+
+- Branch check: PASS - current branch is `PR_26177_ALFA_061-game-configuration-foundation`.
+- Scope check: PASS - runtime changes are limited to the stacked Alfa API service/tool pages/tests needed for Tags, Game Design, and Game Configuration DB-backed behavior.
+- No-mock check: PASS - `tags-mock-repository.js`, `game-design-mock-repository.js`, and `game-configuration-mock-repository.js` are absent, and the guardrail test fails if they return or are imported.
+- Router check: PASS - `local-api-router.mjs` routes Tags, Game Design, and Game Configuration through database-backed API services, not retired mock repositories.
+- Architecture check: PASS - targeted tests exercise Browser -> API -> Database persistence and guest write rejection/redirect behavior.
+- Validation result: PASS.

docs_build/dev/reports/PR_26177_ALFA_061-game-configuration-foundation_manual-validation-notes.md

@@ -0,0 +1,11 @@
+# PR_26177_ALFA_061-game-configuration-foundation Manual Validation Notes
+
+Generated: 2026-06-26 20:51:40 UTC
+
+- Loaded `/toolbox/game-configuration/index.html` with the default valid current-game handoff and confirmed the selected game status shows Demo Game.
+- Confirmed Game Name and Game Type render as inherited read-only text, with no editable inputs for those values.
+- Confirmed seeded Game Details, Platforms, Startup Settings, Game Basics, Game Rules, and setup fields load for the current game.
+- Edited configuration fields, saved through the API, verified `game_configuration_records` rows, reloaded, and confirmed persisted values return.
+- Cleared required fields, saved, and confirmed the validation overlay reports missing sections without generic snapshot seeding hiding the invalid state.
+- Verified guest browser save redirects to `account/sign-in.html`.
+- Verified Tags and Game Design focused lanes still pass after the shared Alfa API service changes.

docs_build/dev/reports/PR_26177_ALFA_061-game-configuration-foundation_report.md

@@ -0,0 +1,31 @@
+# PR_26177_ALFA_061-game-configuration-foundation Report
+
+Generated: 2026-06-26 20:51:40 UTC
+Branch: `PR_26177_ALFA_061-game-configuration-foundation`
+Base: stacked on `PR_26177_ALFA_060-game-design-foundation`
+Current HEAD before packaging: `d0ce8ebda`
+
+## Summary
+PR061 completes the Game Configuration foundation as a human-testable Browser -> API -> Database tool. Game Name and Game Type are inherited from the current Game Hub/Game Design context and remain read-only, while configuration-owned fields save through the API, reload from database persistence, and surface Creator-safe readiness guidance.
+
+## Implementation Notes
+- Game Configuration uses the shared Alfa API service in `src/dev-runtime/toolbox-api/alfa-tool-services.mjs`; the deleted Game Configuration mock repository is not routed or imported.
+- The normal valid-handoff bootstrap prepares a ready starter configuration only when the current game has no complete usable configuration. Explicit invalid saves remain visible and are not silently repaired by later snapshots.
+- `local-api-router.mjs` routes Tags, Game Design, and Game Configuration to the shared database-backed service instead of retired mock repositories.
+- Provider contract stubs include the Game Design section/demo tables required by the shared service contract.
+- No scoped Tags, Game Crew, Game Design, or Game Configuration mock repository source of truth is present in this branch.
+
+## Validation
+- PASS - `node --check src/dev-runtime/toolbox-api/alfa-tool-services.mjs`
+- PASS - `node --check src/dev-runtime/server/local-api-router.mjs`
+- PASS - `node --check assets/toolbox/tags/js/index.js`
+- PASS - `node --check assets/toolbox/game-design/js/index.js`
+- PASS - `node --check assets/toolbox/game-configuration/js/index.js`
+- PASS - `node --test tests/dev-runtime/DevRuntimeBoundary.test.mjs` (5 passed)
+- PASS - `npx playwright test tests/playwright/tools/TagsTool.spec.mjs --project=playwright --workers=1 --reporter=line` (4 passed)
+- PASS - `npx playwright test tests/playwright/tools/GameDesignApiBehavior.spec.mjs --project=playwright --workers=1 --reporter=line` (6 passed)
+- PASS - `npx playwright test tests/playwright/tools/GameConfigurationApiBehavior.spec.mjs --project=playwright --workers=1 --reporter=line` (6 passed)
+- PASS - `git diff --check` (line-ending notices only)
+
+## Packaging
+- Repo-structured ZIP: `tmp/PR_26177_ALFA_061-game-configuration-foundation_delta.zip`

docs_build/dev/reports/PR_26177_ALFA_061-game-configuration-foundation_requirement-checklist.md

@@ -0,0 +1,16 @@
+# PR_26177_ALFA_061-game-configuration-foundation Requirement Checklist
+
+Generated: 2026-06-26 20:51:40 UTC
+
+- PASS - Center title is Configuration; Configuration Workspace wording is absent.
+- PASS - Game Name comes from Game Hub and renders read-only.
+- PASS - Game Type comes from the Game Hub/Game Design handoff and renders read-only.
+- PASS - Configuration owns editable settings only after project creation.
+- PASS - Tool loads seeded current-game configuration data through the API/database path.
+- PASS - Signed-in Creator can edit settings, save, refresh, and see persisted values.
+- PASS - Invalid saves remain visible as missing-section validation and are not silently repaired by generic snapshots.
+- PASS - Guest browser save redirects to `account/sign-in.html`; direct guest API save returns 401.
+- PASS - Tags, Game Design, and Game Configuration do not route through retired mock repositories.
+- PASS - Guardrail test fails if `tags-mock-repository.js`, `game-design-mock-repository.js`, or `game-configuration-mock-repository.js` exists or is imported.
+- PASS - No scoped mock-db-store expansion, page-local arrays, JSON source of truth, SQLite, or tmp runtime dependency was introduced.
+- PASS - DDL, DML, and seed artifacts remain under `docs_build/database/ddl/`, `docs_build/database/dml/`, and `docs_build/database/seed/`.

docs_build/dev/reports/PR_26177_ALFA_061-game-configuration-foundation_validation-lane.md

@@ -0,0 +1,16 @@
+# PR_26177_ALFA_061-game-configuration-foundation Validation Lane
+
+Generated: 2026-06-26 20:51:40 UTC
+
+- PASS - `node --check src/dev-runtime/toolbox-api/alfa-tool-services.mjs`
+- PASS - `node --check src/dev-runtime/server/local-api-router.mjs`
+- PASS - `node --check assets/toolbox/tags/js/index.js`
+- PASS - `node --check assets/toolbox/game-design/js/index.js`
+- PASS - `node --check assets/toolbox/game-configuration/js/index.js`
+- PASS - `node --test tests/dev-runtime/DevRuntimeBoundary.test.mjs`
+- PASS - `npx playwright test tests/playwright/tools/TagsTool.spec.mjs --project=playwright --workers=1 --reporter=line`
+- PASS - `npx playwright test tests/playwright/tools/GameDesignApiBehavior.spec.mjs --project=playwright --workers=1 --reporter=line`
+- PASS - `npx playwright test tests/playwright/tools/GameConfigurationApiBehavior.spec.mjs --project=playwright --workers=1 --reporter=line`
+- PASS - `git diff --check`
+
+Note: an earlier parallel Game Design run timed out while writing Playwright trace artifacts; the same lane passed when rerun alone.