Add project purpose roles capability demos and Game Design ready gate - PR_26155_061-067-project-workspace-purpose-roles

Author: ToolboxAid

docs_build/dev/reports/capability-demo-project-seeds.md

@@ -0,0 +1,30 @@
+# Capability Demo Project Seeds
+
+Stacked PR:
+- PR_26155_065-capability-demo-project-seeds
+
+## Summary
+
+Added mock seed definitions for Capability Demo projects.
+
+Seeded projects:
+- Gravity Demo
+- Collision Demo
+- Camera Follow Demo
+
+Each demo is a real mock project row with:
+- `purpose: "Capability Demo"`
+- Creator User membership
+- Admin User membership
+- Guest Preview User Viewer membership
+
+No real game runtime files, sample JSON, or playable demo implementation was added.
+
+## Validation
+
+Covered by `npm run test:lane:project-workspace`.
+
+The targeted lane verifies:
+- Capability Demo projects appear in the Project Workspace project list.
+- Capability Demo projects are seeded as projects, not as samples or runtime assets.
+- Reset/seed/clear mock data actions still work through the existing admin Project Data wireframe.

docs_build/dev/reports/game-design-ready-gate.md

@@ -0,0 +1,42 @@
+# Game Design Ready Gate
+
+Stacked PR:
+- PR_26155_067-game-design-ready-gate
+
+## Ready Gate
+
+Game Design can start after this Project Workspace bundle because Project Workspace now supports:
+- Project Purpose
+- Project Member Role
+- SQL-shaped mock repository tables
+- Capability Demo seed projects
+- Targeted MSJ coverage for the new Project Workspace model
+- Role-focused Toolbox filtering wireframe behavior
+
+Project Workspace remains the active root for the next rebuild.
+
+## Next Implementation PR
+
+The next implementation PR should start Game Design.
+
+Game Design should consume Project Workspace as the source for:
+- active project identity
+- project purpose
+- current user role
+- project status
+- project progress
+- publishing progress
+- recommended next tool
+
+This bundle does not start Game Design implementation.
+
+## Boundaries Preserved
+
+Preserved:
+- Primary nav order: Games, Toolbox, Marketplace, Learn, Account, Admin.
+- Learn as top-level navigation.
+- Admin as one top-level navigation area only.
+- Arcade outside Toolbox.
+- The site/product ID remains `GameFoundryStudio`; creator-facing tool labels do not use the suffix.
+- No real DB/auth/cloud/persistence.
+- No page-local CSS, tool-local CSS, inline styles, or style blocks.

docs_build/dev/reports/project-member-role-model.md

@@ -0,0 +1,39 @@
+# Project Member Role Model
+
+Stacked PR:
+- PR_26155_062-project-member-role-model
+
+## Summary
+
+Added Project Member Role to the Project Workspace mock SQL-shaped contract.
+
+Supported member roles:
+- Owner
+- Designer
+- World Builder
+- Artist
+- Audio Creator
+- Translator
+- Tester
+- Publisher
+- Viewer
+
+Contract change:
+- `project_members` now includes `role`.
+- Existing `permission` is preserved for compatibility.
+- New project owner membership writes both `permission: "Owner"` and `role: "Owner"`.
+
+Model notes:
+- Project Member Role describes what the user can work on.
+- Owner is documented as full access for the wireframe model.
+- Role-based tool visibility is Toolbox filtering only, not security enforcement.
+
+## Validation
+
+Covered by `npm run test:lane:project-workspace`.
+
+The targeted lane verifies:
+- Current User Role appears in Project Workspace.
+- Role options include all supported values.
+- Demo Project shows Creator User as Owner.
+- Changing Current User Role updates the active Project Workspace display and member table.

docs_build/dev/reports/project-purpose-model.md

@@ -0,0 +1,31 @@
+# Project Purpose Model
+
+Stacked PR:
+- PR_26155_061-project-purpose-model
+
+## Summary
+
+Added Project Purpose to the Project Workspace mock SQL-shaped contract.
+
+Supported purposes:
+- Game Project
+- Capability Demo
+- Learning Project
+- Template Project
+
+Contract change:
+- `projects` now includes `purpose`.
+- Existing Demo Project uses `purpose: "Game Project"`.
+- New projects default to `Game Project` unless the UI or caller supplies another supported purpose.
+
+Project Purpose describes what the project is. It does not add real database, auth, cloud, or persistence behavior.
+
+## Validation
+
+Covered by `npm run test:lane:project-workspace`.
+
+The targeted lane verifies:
+- Project Purpose appears in Project Workspace.
+- Purpose options include all supported values.
+- Created projects can use `Capability Demo`.
+- Existing create/open/delete behavior remains intact.

docs_build/dev/reports/project-workspace-purpose-role-ui.md

@@ -0,0 +1,33 @@
+# Project Workspace Purpose Role UI
+
+Stacked PR:
+- PR_26155_063-project-workspace-purpose-role-ui
+
+## Summary
+
+Updated Project Workspace to expose the new mock/wireframe fields:
+- Project Purpose
+- Current User Role
+
+UI changes:
+- Added a Project Purpose select in Project Setup.
+- Added a Current User Role select in Project Setup.
+- Added Project Purpose and Current User Role to the active project summary.
+- Updated Project Members table to show Role and Permission.
+- Updated open project list metadata to include purpose.
+
+Behavior boundaries:
+- Single-user behavior remains first.
+- Creator User is Owner of Demo Project.
+- Guest Preview User is Viewer in seeded memberships.
+- No real DB/auth/cloud/persistence was added.
+- No CSS was added.
+
+## Validation
+
+Covered by `npm run test:lane:project-workspace`.
+
+Manual notes:
+- Project Purpose and Current User Role are editable wireframe/mock fields.
+- Editing these fields updates the in-memory mock repository only.
+- Create/open/delete behavior still works.

docs_build/dev/reports/project-workspace-targeted-msj-coverage.md

@@ -0,0 +1,51 @@
+# Project Workspace Targeted MSJ Coverage
+
+Stacked PR:
+- PR_26155_066-project-workspace-targeted-msj-coverage
+
+## Impacted Lane
+
+Impacted lane:
+- `project-workspace`
+
+Additional affected lane run because Toolbox role rendering changed:
+- `workspace-contract` through the legacy command name `npm run test:workspace-v2`
+
+## Coverage Added
+
+Extended `tests/playwright/tools/ProjectWorkspaceMockRepository.spec.mjs` to cover:
+- Project Purpose options and active display.
+- Project Member Role options and active display.
+- Editing Project Purpose.
+- Editing Current User Role.
+- Capability Demo seed projects.
+- Project create/open/delete behavior after the model changes.
+- Reset/seed/clear mock data actions.
+- Role-focused Toolbox filtering for Owner, Designer, Audio Creator, Viewer, and Admin views.
+
+## Skipped Lanes
+
+Skipped:
+- Full suite
+- Samples lane
+- Archive/deprecated lanes
+
+Rationale:
+- No samples, archived content, engine runtime, parser, or real persistence behavior changed.
+- Validation stayed on the directly affected Project Workspace and Toolbox contract lanes.
+
+## Commands Run
+
+- `node --check toolbox/project-workspace/project-workspace-mock-repository.js`
+- `node --check toolbox/project-workspace/project-workspace.js`
+- `node --check toolbox/tools-page-accordions.js`
+- `node --check tests/playwright/tools/ProjectWorkspaceMockRepository.spec.mjs`
+- `node --check tests/playwright/tools/RootToolsFutureState.spec.mjs`
+- `npm run test:lane:project-workspace`
+- `npm run test:workspace-v2`
+- `git diff --check`
+
+Results:
+- Project Workspace lane passed: 8 tests.
+- Workspace-contract lane passed: 4 tests.
+- `git diff --check` passed.

docs_build/dev/reports/toolbox-role-focused-filtering.md

@@ -0,0 +1,54 @@
+# Toolbox Role Focused Filtering
+
+Stacked PR:
+- PR_26155_064-toolbox-role-focused-filtering
+
+## Summary
+
+Added dev-mode Toolbox filtering by Project Member Role on top of the existing role simulation.
+
+Existing role simulation remains:
+- `?role=guest`
+- `?role=user`
+- `?role=admin`
+
+New optional member-role filter:
+- `?memberRole=Owner`
+- `?memberRole=Designer`
+- `?memberRole=World%20Builder`
+- `?memberRole=Artist`
+- `?memberRole=Audio%20Creator`
+- `?memberRole=Translator`
+- `?memberRole=Tester`
+- `?memberRole=Publisher`
+- `?memberRole=Viewer`
+
+Default guest/user views remain Owner-style non-admin current-tool views for compatibility with the existing Toolbox surface. Focused member roles narrow visible tiles for review.
+
+Role focus behavior:
+- Owner sees all current non-admin tools allowed by the current wireframe status model.
+- Designer focuses on Project Workspace, Game Design, Game Configuration, Objects, Worlds, Characters, Colors, and Assets.
+- World Builder focuses on Worlds, Objects, Assets, Colors, and Animations.
+- Artist focuses on Assets, Colors, Fonts, Sprites, Characters, Objects, and Animations.
+- Audio Creator focuses on Audio, Music, Voices, MIDI, Audio Effects, Voice Capture, Voice Output, and Assets.
+- Translator focuses on Languages, Voices, Voice Capture, and Voice Output.
+- Tester focuses on Game Testing, Controls, Hitboxes, Debug, Performance, and Events.
+- Publisher focuses on Publish, Marketplace, Community, Cloud, and Languages.
+- Viewer focuses on preview-safe read-only tiles.
+- Admin view still shows planned/admin-capable Toolbox entries.
+
+Focused views include a callout explaining that unavailable tools are hidden by role focus, not by security enforcement.
+
+## Validation
+
+Covered by:
+- `npm run test:lane:project-workspace`
+- `npm run test:workspace-v2`
+
+The targeted lane verifies:
+- Owner/user view still shows the current non-admin surface.
+- Designer view focuses expected tools.
+- Audio Creator view exposes expected media tools, including planned media capabilities.
+- Viewer view is reduced to preview-safe tiles.
+- Admin view still shows planned/admin-capable tools and Project Data controls.
+- No console errors.