Build game configuration foundation

Author: ToolboxAid

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

@@ -3,6 +3,7 @@ import {
   readServerToolConstants,
   requireServerConstant,
 } from "../../../../src/api/server-api-client.js";
+import { getSessionCurrent } from "../../../../src/api/session-api-client.js";
 
 const constants = readServerToolConstants("game-configuration");
 
@@ -32,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]")
 };
 
@@ -75,10 +92,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
   };
 }
@@ -106,6 +129,23 @@ function applyConfigurationToForm(configuration) {
   });
 }
 
+function currentSession() {
+  try {
+    return getSessionCurrent();
+  } catch {
+    return { authenticated: false };
+  }
+}
+
+function redirectGuestSaveAction() {
+  if (currentSession()?.authenticated === true) {
+    return false;
+  }
+  setText(elements.statusLog, "Sign in before saving Game Configuration.");
+  window.location.href = new URL("/account/sign-in.html", window.location.href).href;
+  return true;
+}
+
 function renderValidation(validation) {
   if (!elements.validationList || !elements.validationOverlay) {
     return;
@@ -141,16 +181,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);
@@ -199,9 +259,13 @@ elements.form?.addEventListener("submit", (event) => {
     return;
   }
 
+  if (redirectGuestSaveAction()) {
+    return;
+  }
+
   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,22 +8,52 @@
 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");
 
 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,
@@ -33,6 +63,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,9 @@
+# PR_26177_ALFA_061-game-configuration-foundation Branch Validation
+
+Generated: 2026-06-26 18:51:30 UTC
+
+- Branch check: PASS - current branch is `PR_26177_ALFA_061-game-configuration-foundation`.
+- Scope check: PASS - changes are limited to Game Configuration seeded data behavior, targeted tests, reports, and package artifacts.
+- Architecture check: PASS - targeted validation proves Browser -> API -> Database persistence.
+- Current game check: PASS - status bar and Game Configuration handoff both show Demo Game.
+- 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 18:51:30 UTC
+
+- Loaded /toolbox/game-configuration/index.html and confirmed the status bar selected game is Demo Game.
+- Confirmed Game Name and Game Type render as read-only text, not editable inputs.
+- Confirmed seeded current-game configuration fields load before editing.
+- Edited configuration settings, saved through the API, and verified game_configuration_records rows.
+- Reloaded and confirmed Game Details and Game Basics persisted.
+- Cleared required fields to verify validation still reports missing sections.
+- Verified guest browser save redirects and direct guest API save returns 401.

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

@@ -0,0 +1,24 @@
+# PR_26177_ALFA_061-game-configuration-foundation Report
+
+Generated: 2026-06-26 18:51:30 UTC
+Branch: `PR_26177_ALFA_061-game-configuration-foundation`
+Base: `main`
+Current HEAD before packaging: `72f8f181c`
+
+## Summary
+PR061 makes Game Configuration a human-testable API/DB-backed tool with seeded current-game configuration data. Project identity stays read-only from Game Hub/Game Design handoff, editable configuration settings can be saved, database rows are asserted, and refresh/reload preserves saved values.
+
+## Implementation Notes
+- `makeValidGameDesign()` seeds a current-game configuration only when the selected game has no existing configuration record.
+- Game Name and Game Type remain non-input status text.
+- Tests assert the shared status bar selected game and seeded Demo Game configuration values before editing.
+- Validation coverage clears fields explicitly to prove missing-section behavior despite the seeded ready state.
+- No SQLite, tmp runtime dependency, JSON source of truth, mock-db-store expansion, or new mock repository file was added.
+
+## Validation
+- PASS - node --check assets/toolbox/game-configuration/js/index.js
+- PASS - node --check src/dev-runtime/persistence/tool-repositories/game-configuration-mock-repository.js
+- PASS - node --check src/dev-runtime/server/local-api-router.mjs
+- PASS - node --check tests/playwright/tools/GameConfigurationApiBehavior.spec.mjs
+- PASS - git diff --check (line-ending notices only)
+- PASS - npx playwright test tests/playwright/tools/GameConfigurationApiBehavior.spec.mjs --workers=1 --reporter=line (6 passed)

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

@@ -0,0 +1,15 @@
+# PR_26177_ALFA_061-game-configuration-foundation Requirement Checklist
+
+Generated: 2026-06-26 18:51:30 UTC
+
+- PASS - Center title is Configuration; Configuration Workspace wording is absent.
+- PASS - Game Name comes from Game Hub and is read-only/non-editable.
+- PASS - Game Type comes from the Game Hub/Game Design handoff and is read-only/non-editable.
+- PASS - Configuration owns editable settings only after project creation.
+- PASS - Tool loads seeded configuration data for the current selected Game Hub game.
+- PASS - Tool asserts the shared status bar selected game is Demo Game.
+- PASS - Read/write behavior remains scoped to the active current game configuration.
+- PASS - Signed-in Creator can edit fields, save through API/DB, reload, and see persisted values.
+- PASS - Guest browser save redirects to account/sign-in.html and direct guest API save returns 401.
+- PASS - No SQLite, tmp runtime dependency, JSON source of truth, mock-db-store expansion, or new mock repository file was added.
+- PASS - DDL/DML/seed artifacts remain under docs_build/database/ddl, dml, and seed paths.

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

@@ -0,0 +1,10 @@
+# PR_26177_ALFA_061-game-configuration-foundation Validation Lane
+
+Generated: 2026-06-26 18:51:30 UTC
+
+- PASS - node --check assets/toolbox/game-configuration/js/index.js
+- PASS - node --check src/dev-runtime/persistence/tool-repositories/game-configuration-mock-repository.js
+- PASS - node --check src/dev-runtime/server/local-api-router.mjs
+- PASS - node --check tests/playwright/tools/GameConfigurationApiBehavior.spec.mjs
+- PASS - git diff --check (line-ending notices only)
+- PASS - npx playwright test tests/playwright/tools/GameConfigurationApiBehavior.spec.mjs --workers=1 --reporter=line (6 passed)

docs_build/dev/reports/codex_changed_files.txt

@@ -1,16 +1,16 @@
-M	docs_build/dev/reports/PR_26177_OWNER_057-game-journey-metrics-regression-recovery_branch-validation.md
-M	docs_build/dev/reports/PR_26177_OWNER_057-game-journey-metrics-regression-recovery_manual-validation-notes.md
-M	docs_build/dev/reports/PR_26177_OWNER_057-game-journey-metrics-regression-recovery_report.md
-M	docs_build/dev/reports/PR_26177_OWNER_057-game-journey-metrics-regression-recovery_requirement-checklist.md
-M	docs_build/dev/reports/PR_26177_OWNER_057-game-journey-metrics-regression-recovery_validation-lane.md
-M	docs_build/dev/reports/coverage_changed_js_guardrail.txt
-M	docs_build/dev/reports/playwright_v8_coverage_report.txt
-D	scripts/migrate-game-journey-completion-metrics-sqlite-to-postgres.mjs
-M	scripts/validate-browser-env-agnostic.mjs
-D	src/dev-runtime/persistence/game-journey-completion-metrics-migration.mjs
-D	tests/dev-runtime/GameJourneyCompletionMetricsMigration.test.mjs
-M	tests/dev-runtime/GameJourneyCompletionMetricsStore.test.mjs
-M	tests/playwright/tools/AdminHealthOperationsPage.spec.mjs
-M	tests/playwright/tools/GameJourneyTool.spec.mjs
-M	docs_build/dev/reports/codex_changed_files.txt
-M	docs_build/dev/reports/codex_review.diff
+assets/toolbox/game-configuration/js/index.js
+docs_build/database/ddl/game-configuration.sql
+docs_build/database/seed/game-configuration.json
+docs_build/dev/reports/PR_26177_ALFA_061-game-configuration-foundation_branch-validation.md
+docs_build/dev/reports/PR_26177_ALFA_061-game-configuration-foundation_manual-validation-notes.md
+docs_build/dev/reports/PR_26177_ALFA_061-game-configuration-foundation_report.md
+docs_build/dev/reports/PR_26177_ALFA_061-game-configuration-foundation_requirement-checklist.md
+docs_build/dev/reports/PR_26177_ALFA_061-game-configuration-foundation_validation-lane.md
+docs_build/dev/reports/codex_changed_files.txt
+docs_build/dev/reports/codex_review.diff
+docs_build/dev/reports/coverage_changed_js_guardrail.txt
+docs_build/dev/reports/playwright_v8_coverage_report.txt
+src/dev-runtime/persistence/tool-repositories/game-configuration-mock-repository.js
+src/dev-runtime/server/local-api-router.mjs
+tests/playwright/tools/GameConfigurationApiBehavior.spec.mjs
+toolbox/game-configuration/index.html