Rename runtime Workspace contract to Project Workspace - PR_26152_079-project-workspace-contract-rename

Author: qbytesdq-jpg

docs/dev/reports/project_workspace_contract_rename_validation.md

@@ -0,0 +1,82 @@
+# Project Workspace Contract Rename Validation
+
+PR: PR_26152_079-project-workspace-contract-rename
+Date: 2026-06-02
+
+## Scope
+
+- Continued from PR_26152_078.
+- Renamed runtime-only Workspace terminology to Project Workspace.
+- Updated contracts, contract tests, docs/specs, and required reports only.
+- No database implementation, authentication implementation, runtime UI, page, CSS, or HTML changes were made.
+
+## Contract Rename
+
+- The previous runtime-only contract file was renamed to `src/shared/contracts/projectWorkspaceRuntimeContract.js`.
+- The matching runtime-only contract test was renamed to `tests/shared/ProjectWorkspaceRuntimeContract.test.mjs`.
+- The runtime-only contract terminology was renamed to Project Workspace Runtime Contract.
+- Project Workspace is the active runtime working context for a Project.
+
+## Project Workspace Rules
+
+- Project Workspace is runtime-only.
+- Project Workspace does not persist tool payloads.
+- Project Workspace does not own saved tool state.
+- Project Workspace does not duplicate project storage.
+- Project Workspace does not duplicate tool state storage.
+- Project Workspace recovery points to Tool State recovery.
+
+## Data Ownership
+
+- Project = persisted DB container.
+- Project Workspace = current runtime working context for the Project.
+- Tool State = persisted DB record for one tool.
+- Manifest = portable export/import format.
+
+## Docs
+
+- Added `docs/dev/specs/PROJECT_WORKSPACE_RUNTIME_CONTRACT.md`.
+- Updated `docs/dev/specs/TOOL_LAUNCH_SSOT.md` to use Project Workspace terminology for prior runtime launch state.
+
+## Validation Commands
+
+Targeted contract tests:
+
+```powershell
+$contractTests = @(
+  'tests/shared/ProjectWorkspaceRuntimeContract.test.mjs',
+  'tests/shared/ToolStateContract.test.mjs',
+  'tests/shared/ProjectContract.test.mjs',
+  'tests/shared/IdentityPermissionsContract.test.mjs'
+)
+$toolContractTests = Get-ChildItem -Path tests/shared/tools -Filter '*.test.mjs' | Sort-Object Name | ForEach-Object { $_.FullName }
+node ./scripts/run-node-test-files.mjs $contractTests $toolContractTests
+```
+
+Result: PASS, `40/40 targeted node test file(s) passed`.
+
+Static checks:
+
+```powershell
+git diff --check -- src/shared/contracts tests/shared docs/dev/specs docs/dev/reports/project_workspace_contract_rename_validation.md docs/dev/commit_comment.txt
+git diff --name-only -- '*.css' '*.html'
+Test-Path src/shared/contracts/workspaceRuntimeContract.js
+Test-Path tests/shared/WorkspaceRuntimeContract.test.mjs
+rg -P "^# Workspace|^- Workspace|^Workspace(?! Manager)|^- workspace|^workspace" -n src/shared/contracts/projectWorkspaceRuntimeContract.js tests/shared/ProjectWorkspaceRuntimeContract.test.mjs docs/dev/specs/PROJECT_WORKSPACE_RUNTIME_CONTRACT.md docs/dev/specs/TOOL_LAUNCH_SSOT.md docs/dev/reports/project_workspace_contract_rename_validation.md
+rg '"workspaceState"' -n src/shared/contracts/projectWorkspaceRuntimeContract.js tests/shared/ProjectWorkspaceRuntimeContract.test.mjs
+```
+
+## Expected Results
+
+- PASS: Project Workspace contract tests validate terminology and behavior remain unchanged.
+- PASS: Project Workspace rejects old standalone workspace storage fields such as `workspaceState`.
+- PASS: Tool State remains the saved editing source.
+- PASS: Project, Identity/Permissions, and Tool contract tests remain compatible.
+- PASS: no runtime/UI/CSS/HTML files changed.
+- PASS: no repo-wide or samples tests run.
+
+## Skipped
+
+- Repo-wide tests were not run.
+- Samples tests were not run.
+- Runtime/UI validation was not run because this PR only changes contracts, contract tests, docs/specs, and reports.

docs/dev/reports/workspace_runtime_only_contract_validation.md

@@ -0,0 +1,40 @@
+# Project Workspace Runtime Contract
+
+Date: 2026-06-02
+
+## Purpose
+
+Project Workspace is the runtime-only active working context for a Project.
+
+## Rules
+
+- Project Workspace is runtime-only.
+- Project Workspace does not persist tool payloads.
+- Project Workspace does not own saved tool state.
+- Project Workspace does not duplicate project storage.
+- Project Workspace does not duplicate tool state storage.
+- Project Workspace recovery points to Tool State recovery.
+
+## Runtime Fields
+
+Project Workspace may track:
+
+- `activeProjectId`
+- `activeToolId`
+- `activeToolStateId`
+- `dirty`
+- `recoveryAvailable`
+- `recoveryToolStateId`
+- `activePaletteContext`
+- `flowState`
+
+## Data Ownership
+
+- Project = persisted DB container.
+- Project Workspace = current runtime working context for the Project.
+- Tool State = persisted DB record for one tool.
+- Manifest = portable export/import format.
+
+## Prohibited Storage
+
+Project Workspace must not contain saved tool state records, tool payload data, project records, manifest data, database IDs, Project Workspace storage records, or Project Workspace-owned recovery state.

docs/dev/specs/PROJECT_WORKSPACE_RUNTIME_CONTRACT.md

@@ -71,7 +71,7 @@ An external launch is any launch that begins from:
 
 External launches MUST clear launch memory before loading the target tool or workspace.
 
-External launches MUST NOT reuse prior tool state, prior workspace state, stale selected tool values, stale selected game values, stale launch context, or prior session carryover.
+External launches MUST NOT reuse prior tool state, prior Project Workspace state, stale selected tool values, stale selected game values, stale launch context, or prior session carryover.
 
 ## Query Contract