Initialize a single active workspace palette for Workspace V2 export baseline - PR_11_309

Author: DavidQ

docs/dev/reports/PR_11_309_report.md

@@ -0,0 +1,39 @@
+# PR_11_309 Report - Workspace V2 Default Active Palette Initialization
+
+## Scope
+- `tools/workspace-v2/index.js`
+- Workspace V2 initialization / full reset / export baseline behavior
+
+## Files Changed
+- `tools/workspace-v2/index.js`
+- `docs/dev/reports/PR_11_309_report.md`
+
+## What Changed
+- Added `ensureWorkspaceActivePaletteBaseline()` to guarantee one schema-valid active palette state exists in Workspace V2 memory.
+- Called baseline palette initialization:
+  - during startup before producer session initialization
+  - at producer session initialization start
+  - during full reset after clearing prior state
+- Baseline active palette uses one active palette entry source with empty swatches:
+  - `hostContextId: "workspace-active-palette"`
+  - `palette.swatches: []`
+- This ensures workspace manifest export can always build `tools.palette-browser` with:
+  - `schema`
+  - `version`
+  - `name`
+  - `swatches: []`
+
+## Validation
+- Command run:
+  - `node --check tools/workspace-v2/index.js`
+- Result:
+  - PASS
+
+## Expected Runtime Outcome
+- Fresh page load and full reset now keep exactly one active palette baseline available.
+- Export no longer fails solely because active palette state was missing after refresh/reset.
+- Asset Browser session creation/launch does not remove the workspace-owned palette entry.
+
+## Full Samples Smoke
+- Skipped.
+- Reason: change is isolated to Workspace V2 state initialization/reset in one JS file and does not modify shared sample infrastructure.

tools/workspace-v2/index.js

@@ -224,6 +224,7 @@ class WorkspaceV2SessionProducer {
     this.initializeWorkspaceToolsSummaryNode();
     this.initializeHiddenImportFileInput();
     this.decodeSessionParamFromUrl();
+    this.ensureWorkspaceActivePaletteBaseline();
     this.initializeWorkspaceProducerSession();
     this.refreshPaletteOwnershipStateAndUi();
     this.registerSnapshotHook();
@@ -506,6 +507,18 @@ class WorkspaceV2SessionProducer {
     );
   }
 
+  ensureWorkspaceActivePaletteBaseline() {
+    if (this.hasWorkspaceActivePalette()) {
+      return;
+    }
+    this.workspaceActivePalette = {
+      hostContextId: "workspace-active-palette",
+      palette: {
+        swatches: []
+      }
+    };
+  }
+
   hasWorkspaceActivePalette() {
     return Boolean(
       this.workspaceActivePalette &&
@@ -670,6 +683,7 @@ class WorkspaceV2SessionProducer {
   }
 
   initializeWorkspaceProducerSession() {
+    this.ensureWorkspaceActivePaletteBaseline();
     if (this.isValidSessionPayload(this.currentSessionPayload) && this.currentHostContextId) {
       return;
     }
@@ -3174,6 +3188,7 @@ class WorkspaceV2SessionProducer {
     this.resetUrlState(false);
     this.currentHostContextId = "";
     this.workspaceActivePalette = null;
+    this.ensureWorkspaceActivePaletteBaseline();
     this.workspaceImportedToolEntries = {};
     this.setCurrentSessionPayload(null, "");
     this.initializeWorkspaceProducerSession();