Merge PR_26177_ALFA_060-game-design-foundation

# Conflicts:
#	tests/playwright/tools/GameDesignApiBehavior.spec.mjs
#	tests/playwright/tools/GameDesignApiDb.spec.mjs
#	tests/playwright/tools/GameDesignMockRepository.spec.mjs

Author: ToolboxAid

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

@@ -31,7 +31,9 @@ const elements = {
   capabilityDemoNotes: document.querySelector("[data-game-design-capability-notes]"),
   capabilityDemoPanel: document.querySelector("[data-game-design-capability-panel]"),
   configurationLink: document.querySelector("[data-game-design-configuration-link]"),
+  coreLoop: document.querySelector("[data-game-design-core-loop]"),
   designSummary: document.querySelector("[data-game-design-summary]"),
+  designNotes: document.querySelector("[data-game-design-notes]"),
   designStatus: document.querySelector("[data-game-design-status]"),
   form: document.querySelector("[data-game-design-form]"),
   gameType: document.querySelector("[data-game-design-type]"),
@@ -41,20 +43,30 @@ const elements = {
   handoffProgress: document.querySelector("[data-game-design-game-progress]"),
   handoffPublishing: document.querySelector("[data-game-design-publishing-progress]"),
   handoffRecommended: document.querySelector("[data-game-design-recommended-tool]"),
+  loseCondition: document.querySelector("[data-game-design-lose-condition]"),
+  outputAudience: document.querySelector("[data-game-design-output-audience]"),
   outputCapability: document.querySelector("[data-game-design-output-capability]"),
+  outputCoreLoop: document.querySelector("[data-game-design-output-core-loop]"),
+  outputLose: document.querySelector("[data-game-design-output-lose]"),
   outputMissing: document.querySelector("[data-game-design-output-missing]"),
   outputNextStep: document.querySelector("[data-game-design-output-next-step]"),
+  outputNotes: document.querySelector("[data-game-design-output-notes]"),
   outputPlayerMode: document.querySelector("[data-game-design-output-player-mode]"),
+  outputStory: document.querySelector("[data-game-design-output-story]"),
   outputSummary: document.querySelector("[data-game-design-output-summary]"),
   outputValidation: document.querySelector("[data-game-design-output-validation]"),
+  outputWin: document.querySelector("[data-game-design-output-win]"),
   playerMode: document.querySelector("[data-game-design-player-mode]"),
   playStyle: document.querySelector("[data-game-design-play-style]"),
+  story: document.querySelector("[data-game-design-story]"),
+  targetAudience: document.querySelector("[data-game-design-target-audience]"),
   gameContext: document.querySelector("[data-game-design-game-context]"),
   gameOverlay: document.querySelector("[data-game-design-game-overlay]"),
   statusLog: document.querySelector("[data-game-design-log]"),
   tableCounts: document.querySelector("[data-game-design-table-counts]"),
   validationList: document.querySelector("[data-game-design-validation-list]"),
-  validationOverlay: document.querySelector("[data-game-design-validation-overlay]")
+  validationOverlay: document.querySelector("[data-game-design-validation-overlay]"),
+  winCondition: document.querySelector("[data-game-design-win-condition]")
 };
 
 function setText(element, value) {
@@ -110,11 +122,18 @@ function readForm() {
   return {
     capabilityDemoAuthoring: repository.getActiveGame()?.purpose === "Capability Demo",
     capabilityDemoNotes: elements.capabilityDemoNotes?.value,
+    coreLoop: elements.coreLoop?.value,
+    designNotes: elements.designNotes?.value,
     designSummary: elements.designSummary?.value,
     gameType: elements.gameType?.value,
     genre: elements.genre?.value,
+    loseCondition: elements.loseCondition?.value,
     playerMode: elements.playerMode?.value,
-    playStyle: elements.playStyle?.value
+    playStyle: elements.playStyle?.value,
+    story: elements.story?.value,
+    summary: elements.designSummary?.value,
+    targetAudience: elements.targetAudience?.value,
+    winCondition: elements.winCondition?.value
   };
 }
 
@@ -134,6 +153,24 @@ function clearForm() {
   if (elements.designSummary) {
     elements.designSummary.value = "";
   }
+  if (elements.story) {
+    elements.story.value = "";
+  }
+  if (elements.coreLoop) {
+    elements.coreLoop.value = "";
+  }
+  if (elements.winCondition) {
+    elements.winCondition.value = "";
+  }
+  if (elements.loseCondition) {
+    elements.loseCondition.value = "";
+  }
+  if (elements.targetAudience) {
+    elements.targetAudience.value = "";
+  }
+  if (elements.designNotes) {
+    elements.designNotes.value = "";
+  }
   if (elements.capabilityDemoNotes) {
     elements.capabilityDemoNotes.value = "";
   }
@@ -158,7 +195,25 @@ function applyDesignToForm(design) {
     elements.playerMode.value = design.playerMode || "1 Player";
   }
   if (elements.designSummary) {
-    elements.designSummary.value = design.designSummary;
+    elements.designSummary.value = design.summary || design.designSummary;
+  }
+  if (elements.story) {
+    elements.story.value = design.story;
+  }
+  if (elements.coreLoop) {
+    elements.coreLoop.value = design.coreLoop;
+  }
+  if (elements.winCondition) {
+    elements.winCondition.value = design.winCondition;
+  }
+  if (elements.loseCondition) {
+    elements.loseCondition.value = design.loseCondition;
+  }
+  if (elements.targetAudience) {
+    elements.targetAudience.value = design.targetAudience;
+  }
+  if (elements.designNotes) {
+    elements.designNotes.value = design.designNotes;
   }
   if (elements.capabilityDemoNotes) {
     elements.capabilityDemoNotes.value = design.capabilityDemoNotes;
@@ -243,7 +298,13 @@ function renderOutput(snapshot, validation) {
   const activeGame = snapshot.activeGame || snapshot.activeProject;
   const missingRequirements = validation.findings.map((finding) => finding.label).join(", ");
 
-  setText(elements.outputSummary, activeDesign?.designSummary || "No design summary saved yet.");
+  setText(elements.outputSummary, activeDesign?.summary || activeDesign?.designSummary || "No design summary saved yet.");
+  setText(elements.outputStory, activeDesign?.story || "No story saved yet.");
+  setText(elements.outputCoreLoop, activeDesign?.coreLoop || "No core loop saved yet.");
+  setText(elements.outputWin, activeDesign?.winCondition || "No win condition saved yet.");
+  setText(elements.outputLose, activeDesign?.loseCondition || "No lose condition saved yet.");
+  setText(elements.outputAudience, activeDesign?.targetAudience || "No audience saved yet.");
+  setText(elements.outputNotes, activeDesign?.designNotes || "No notes saved yet.");
   setText(elements.outputPlayerMode, activeDesign?.playerMode || "1 Player");
   setText(elements.outputValidation, validation.status);
   setText(elements.outputNextStep, snapshot.progressHandoff.recommendedNextTool);

docs_build/database/ddl/game-design.sql

@@ -4,18 +4,47 @@
 -- Target DEV database: gamefoundry_dev
 -- Scope: executable grouped table DDL for active Supabase/server API migration.
 -- Authoritative key values are generated by the server/API layer unless a later DEV-only seed exception explicitly applies.
--- Owned tables: game_design_documents, game_design_validation_items
+-- Owned tables: game_design_documents, game_design_validation_items, game_design_sections, game_design_capability_demos
 CREATE TABLE IF NOT EXISTS game_design_documents (
     key text PRIMARY KEY,
     "gameKey" text REFERENCES game_workspace_games(key),
     "title" text,
+    "gamePurpose" text,
+    "gameType" text,
+    "genre" text,
+    "playStyle" text,
+    "playerMode" text,
+    "summary" text,
+    "story" text,
+    "coreLoop" text,
+    "winCondition" text,
+    "loseCondition" text,
+    "targetAudience" text,
+    "designNotes" text,
+    "capabilityDemoAuthoring" boolean NOT NULL DEFAULT false,
+    "capabilityDemoNotes" text,
     "status" 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_design_documents ADD COLUMN IF NOT EXISTS "gamePurpose" text;
+ALTER TABLE game_design_documents ADD COLUMN IF NOT EXISTS "gameType" text;
+ALTER TABLE game_design_documents ADD COLUMN IF NOT EXISTS "genre" text;
+ALTER TABLE game_design_documents ADD COLUMN IF NOT EXISTS "playStyle" text;
+ALTER TABLE game_design_documents ADD COLUMN IF NOT EXISTS "playerMode" text;
+ALTER TABLE game_design_documents ADD COLUMN IF NOT EXISTS "summary" text;
+ALTER TABLE game_design_documents ADD COLUMN IF NOT EXISTS "story" text;
+ALTER TABLE game_design_documents ADD COLUMN IF NOT EXISTS "coreLoop" text;
+ALTER TABLE game_design_documents ADD COLUMN IF NOT EXISTS "winCondition" text;
+ALTER TABLE game_design_documents ADD COLUMN IF NOT EXISTS "loseCondition" text;
+ALTER TABLE game_design_documents ADD COLUMN IF NOT EXISTS "targetAudience" text;
+ALTER TABLE game_design_documents ADD COLUMN IF NOT EXISTS "designNotes" text;
+ALTER TABLE game_design_documents ADD COLUMN IF NOT EXISTS "capabilityDemoAuthoring" boolean NOT NULL DEFAULT false;
+ALTER TABLE game_design_documents ADD COLUMN IF NOT EXISTS "capabilityDemoNotes" text;
+
 CREATE INDEX IF NOT EXISTS idx_game_design_documents_gamekey ON game_design_documents ("gameKey");
 CREATE INDEX IF NOT EXISTS idx_game_design_documents_createdby ON game_design_documents ("createdBy");
 CREATE INDEX IF NOT EXISTS idx_game_design_documents_updatedby ON game_design_documents ("updatedBy");
@@ -32,6 +61,7 @@ ALTER TABLE game_design_documents ADD COLUMN IF NOT EXISTS "capabilityDemoNotes"
 CREATE TABLE IF NOT EXISTS game_design_validation_items (
     key text PRIMARY KEY,
     "gameKey" text REFERENCES game_workspace_games(key),
+    "field" text,
     "label" text,
     "status" text,
     "action" text,
@@ -41,10 +71,30 @@ CREATE TABLE IF NOT EXISTS game_design_validation_items (
     "updatedBy" text NOT NULL REFERENCES users(key)
 );
 
+ALTER TABLE game_design_validation_items ADD COLUMN IF NOT EXISTS "field" text;
+
 CREATE INDEX IF NOT EXISTS idx_game_design_validation_items_gamekey ON game_design_validation_items ("gameKey");
 CREATE INDEX IF NOT EXISTS idx_game_design_validation_items_createdby ON game_design_validation_items ("createdBy");
 CREATE INDEX IF NOT EXISTS idx_game_design_validation_items_updatedby ON game_design_validation_items ("updatedBy");
-ALTER TABLE game_design_validation_items ADD COLUMN IF NOT EXISTS "field" text;
+
+CREATE TABLE IF NOT EXISTS game_design_sections (
+    key text PRIMARY KEY,
+    "gameKey" text REFERENCES game_workspace_games(key),
+    "documentKey" text REFERENCES game_design_documents(key),
+    "sectionKey" text,
+    "heading" text,
+    "body" text,
+    "sortOrder" integer NOT NULL DEFAULT 0,
+    "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)
+);
+
+CREATE INDEX IF NOT EXISTS idx_game_design_sections_gamekey ON game_design_sections ("gameKey");
+CREATE INDEX IF NOT EXISTS idx_game_design_sections_documentkey ON game_design_sections ("documentKey");
+CREATE INDEX IF NOT EXISTS idx_game_design_sections_createdby ON game_design_sections ("createdBy");
+CREATE INDEX IF NOT EXISTS idx_game_design_sections_updatedby ON game_design_sections ("updatedBy");
 
 CREATE TABLE IF NOT EXISTS game_design_capability_demos (
     key text PRIMARY KEY,

docs_build/database/dml/game-design.sql

@@ -4,7 +4,7 @@
 -- Runtime setup/seed operations for this group must run through server-side APIs.
 -- Temporary scope: DEV/review artifact only until Admin Site Setup/server seed APIs fully own grouped setup.
 -- Browser pages must not directly seed authoritative DB records.
--- Owned tables: game_design_documents, game_design_validation_items
+-- Owned tables: game_design_documents, game_design_validation_items, game_design_sections, game_design_capability_demos
 
 -- DML status: Server-seed-owned.
 -- Setup is performed through the Admin-owned server-side seed API.

docs_build/database/seed/game-design.json

@@ -6,7 +6,9 @@
   "browserAuthoritativeKeyGenerationAllowed": false,
   "tables": {
     "game_design_documents": [],
-    "game_design_validation_items": []
+    "game_design_validation_items": [],
+    "game_design_sections": [],
+    "game_design_capability_demos": []
   },
   "note": "Seed records for this group are intentionally empty until an Admin-owned server API seeds them."
 }

docs_build/database/seed/guest/game-design.json

@@ -7,7 +7,9 @@
   "signInRedirect": "account/sign-in.html",
   "tables": {
     "game_design_documents": [],
-    "game_design_validation_items": []
+    "game_design_validation_items": [],
+    "game_design_sections": [],
+    "game_design_capability_demos": []
   },
   "samplePackages": [
     {

docs_build/database/seed/tags.json

@@ -7,62 +7,7 @@
   "architecture": "Browser -> API -> Database",
   "flatTagsOnly": true,
   "tables": {
-    "project_tags": [
-      {
-        "key": "01K2GFSJ0Y0000000000007201",
-        "slug": "platformer",
-        "label": "platformer",
-        "description": "Platforming, jumping, and movement-focused projects.",
-        "active": true,
-        "createdBy": "01K2GFSJ0Y0000000000000054",
-        "updatedBy": "01K2GFSJ0Y0000000000000054"
-      },
-      {
-        "key": "01K2GFSJ0Y0000000000007202",
-        "slug": "fantasy",
-        "label": "fantasy",
-        "description": "Magic, legends, and fantasy world themes.",
-        "active": true,
-        "createdBy": "01K2GFSJ0Y0000000000000054",
-        "updatedBy": "01K2GFSJ0Y0000000000000054"
-      },
-      {
-        "key": "01K2GFSJ0Y0000000000007203",
-        "slug": "medium",
-        "label": "medium",
-        "description": "Medium-sized project scope.",
-        "active": true,
-        "createdBy": "01K2GFSJ0Y0000000000000054",
-        "updatedBy": "01K2GFSJ0Y0000000000000054"
-      },
-      {
-        "key": "01K2GFSJ0Y0000000000007204",
-        "slug": "pixel-art",
-        "label": "pixel-art",
-        "description": "Pixel art visual direction.",
-        "active": true,
-        "createdBy": "01K2GFSJ0Y0000000000000054",
-        "updatedBy": "01K2GFSJ0Y0000000000000054"
-      },
-      {
-        "key": "01K2GFSJ0Y0000000000007205",
-        "slug": "kids",
-        "label": "kids",
-        "description": "Designed for younger players.",
-        "active": true,
-        "createdBy": "01K2GFSJ0Y0000000000000054",
-        "updatedBy": "01K2GFSJ0Y0000000000000054"
-      },
-      {
-        "key": "01K2GFSJ0Y0000000000007206",
-        "slug": "boss-fight",
-        "label": "boss-fight",
-        "description": "Includes a climactic boss encounter.",
-        "active": true,
-        "createdBy": "01K2GFSJ0Y0000000000000054",
-        "updatedBy": "01K2GFSJ0Y0000000000000054"
-      }
-    ],
+    "project_tags": [],
     "project_tag_assignments": []
   },
   "note": "Flat reusable tag seed labels are server/API owned. Current-game starter assignments are created by the API repository at runtime so project keys stay server-owned."

docs_build/dev/reports/PR_26177_ALFA_060-game-design-foundation_branch-validation.md

@@ -0,0 +1,10 @@
+# PR_26177_ALFA_060-game-design-foundation Branch Validation
+
+Generated: 2026-06-26 20:59:30 UTC
+
+- Branch check: PASS - current branch is `PR_26177_ALFA_060-game-design-foundation`.
+- Scope check: PASS - runtime changes are limited to shared Alfa API/database services and affected Tags/Game Design/Game Configuration tool surfaces carried by the stack.
+- Mock repository check: PASS - retired Tags/Game Design/Game Configuration mock repository files are deleted and guardrail tests pass.
+- Mock DB expansion check: PASS - this branch does not add or expand mock-db-store as the source of truth for Tags, Game Design, or Game Configuration.
+- Architecture check: PASS - targeted validation proves Browser -> API -> Database persistence.
+- Validation result: PASS.

docs_build/dev/reports/PR_26177_ALFA_060-game-design-foundation_manual-validation-notes.md

@@ -0,0 +1,13 @@
+# PR_26177_ALFA_060-game-design-foundation Manual Validation Notes
+
+Generated: 2026-06-26 20:59:30 UTC
+
+- Loaded `/toolbox/game-design/index.html` and confirmed the selected Game Hub game context renders for Demo Game.
+- Confirmed the page is an editable tool surface, not a landing page.
+- Confirmed signed-in Creator edits save through the API and survive reload.
+- Verified `game_design_documents` and `game_design_sections` contain the saved current-game values.
+- Opened the missing-game scenario and confirmed the validation overlay blocks save until a Game Hub game exists.
+- Opened Gravity Demo context and confirmed capability demo data remains game-owned.
+- Confirmed guest browser save redirects to `account/sign-in.html`.
+- Confirmed direct guest API save returns 401 and does not write product data.
+- Confirmed retired Alfa mock repositories are absent and the guardrail test passes.

docs_build/dev/reports/PR_26177_ALFA_060-game-design-foundation_report.md

@@ -0,0 +1,28 @@
+# PR_26177_ALFA_060-game-design-foundation Report
+
+Generated: 2026-06-26 20:59:30 UTC
+Branch: `PR_26177_ALFA_060-game-design-foundation`
+
+## Summary
+PR060 reworks Game Design as a human-testable API/DB-backed tool while carrying forward the stack correction that removes retired Alfa mock repositories. The shared Alfa API service now persists Game Design documents, validation rows, capability demo rows, and design section rows through the database adapter.
+
+## Implementation Notes
+- Removed the retired `game-design-mock-repository.js` file from the active stack and kept the router on `createGameDesignApiService`.
+- Persisted editable Game Design fields for the active Game Hub game: summary, story, core loop, win condition, lose condition, target audience, design notes, and capability demo notes.
+- Added `game_design_sections` to the shared Game Design service/table contract so section content persists through API/DB and can be validated directly.
+- Changed seeding to create starter data only when no Game Design record exists; incomplete Creator saves are no longer overwritten by starter data.
+- Kept guest browser saves redirecting to `account/sign-in.html` and direct guest API writes returning 401.
+- Preserved flat Tags API/DB behavior from the stack without adding a Tags mock repository or expanding mock-db-store usage for Tags.
+
+## 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/game-design/js/index.js`
+- PASS - `node --test tests/dev-runtime/DevRuntimeBoundary.test.mjs`
+- PASS - `npx playwright test tests/playwright/tools/GameDesignApiBehavior.spec.mjs --project=playwright --workers=1 --reporter=line` (6 passed)
+
+## Notes
+- No SQLite or tmp runtime dependency was introduced.
+- No JSON source of truth or browser-owned product data was introduced.
+- No new `*-mock-repository.js` file was added for Tags, Game Crew, Game Design, or Game Configuration.
+- No `mock-db-store.js` or Admin DB viewer expansion is present in this PR.

docs_build/dev/reports/PR_26177_ALFA_060-game-design-foundation_requirement-checklist.md

@@ -0,0 +1,18 @@
+# PR_26177_ALFA_060-game-design-foundation Requirement Checklist
+
+Generated: 2026-06-26 20:59:30 UTC
+
+- PASS - Browser -> API -> Database is the active product-data path.
+- PASS - Game Design routes through the shared Alfa API service, not `game-design-mock-repository.js`.
+- PASS - Retired Tags/Game Design/Game Configuration mock repository files are deleted from this stack.
+- PASS - Router guardrail confirms Tags, Game Crew, Game Design, and Game Configuration are not routed to retired mock repositories.
+- PASS - Center title is `Design`; `Design Workspace` wording is absent.
+- PASS - Tool loads current selected Game Hub game context from the shared status/game context.
+- PASS - Signed-in Creator can edit Game Design fields, save through API/DB, reload, and see persisted values.
+- PASS - Editable fields include summary, story, core loop, win condition, lose condition, target audience, and design notes.
+- PASS - `game_design_sections` persists section rows through API/DB.
+- PASS - Guest browser save redirects to `account/sign-in.html`.
+- PASS - Direct guest API save returns 401 with Creator-safe sign-in wording.
+- PASS - No SQLite, tmp runtime dependency, JSON source of truth, browser-owned product data, or new mock repository source of truth was introduced.
+- PASS - No `mock-db-store.js` or Admin DB viewer expansion is present in this PR.
+- PASS - DDL/DML/seed artifacts remain under `docs_build/database/ddl`, `docs_build/database/dml`, and `docs_build/database/seed`.