Make sample 1902 launch only through Workspace Manager - PR 11.24

Author: DavidQ

docs/dev/codex_commands.md

@@ -1,3 +1,28 @@
 MODEL: GPT-5.3-codex
 REASONING: medium
-COMMAND: Apply UI binding fix for payload asset display
+
+TASK:
+Apply PR 11.24.
+
+Find the sample 1902 page/content that renders the visible "Tool Roundtrip Links" section and individual "Open <tool>" links.
+
+Make the smallest targeted change so sample 1902 exposes only:
+
+Open with Workspace Manager
+
+Do not modify tool implementation files unless the sample entry page delegates rendering there.
+Do not change payload schema.
+Do not change manifest data except where required to remove direct visible sample links.
+Do not add fallback links.
+Do not touch start_of_day folders.
+
+VALIDATION:
+node --check <changed-js-files>
+node ./tests/runtime/LaunchSmokeAllEntries.test.mjs --samples --sample-range=1902-1902 --tools
+
+REPORT:
+Write docs/dev/reports/PR_11_24_validation.txt with:
+- changed files
+- before behavior
+- after behavior
+- validation commands/results

docs/dev/commit_comment.txt

@@ -1 +1 @@
-Bind Workspace Manager UI to embedded payload for asset display - PR 11.23
+Make sample 1902 launch only through Workspace Manager - PR 11.24

docs/dev/reports/PR_11_24_validation.txt

@@ -0,0 +1,17 @@
+changed files
+- samples/index.render.js
+- docs/dev/reports/PR_11_24_validation.txt
+
+before behavior
+- Sample 1902 rendered the "Tool Roundtrip Links" section with direct "Open <tool>" links.
+
+after behavior
+- Sample 1902 renders only one launch action:
+  - Open with Workspace Manager
+- The generic "Tool Roundtrip Links" section is not rendered for sample 1902.
+
+validation commands/results
+- node --check "samples/index.render.js"
+  - PASS
+- node ./tests/runtime/LaunchSmokeAllEntries.test.mjs --samples --sample-range=1902-1902 --tools
+  - PASS (PASS=19 FAIL=0 TOTAL=19)

docs/dev/reports/PR_11_24_validation_template.txt

@@ -0,0 +1,14 @@
+# PR 11.24 Validation
+
+Changed files:
+-
+
+Before:
+- Sample 1902 showed Tool Roundtrip Links and direct Open <tool> links.
+
+After:
+- Sample 1902 shows only Open with Workspace Manager.
+
+Validation:
+- node --check ...
+- node ./tests/runtime/LaunchSmokeAllEntries.test.mjs --samples --sample-range=1902-1902 --tools

docs/dev/reports/launch_smoke_report.md

@@ -1,6 +1,6 @@
 # Launch Smoke Report
 
-Generated: 2026-04-29T15:41:58.002Z
+Generated: 2026-04-29T16:01:46.656Z
 
 Filters: games=false, samples=true, tools=true, sampleRange=1902-1902
 

docs/pr/PR_11_24_SAMPLE_1902_WORKSPACE_MANAGER_ONLY_ENTRY.md

@@ -0,0 +1,29 @@
+# PR 11.24 — Sample 1902 Workspace Manager Only Entry
+
+## Purpose
+Make sample 1902 expose only the intended Workspace Manager launch path.
+
+## Problem
+Sample 1902 currently shows the legacy "Tool Roundtrip Links" section with direct links to every workspace-supported tool.
+
+## Required Change
+Remove or hide the sample-owned direct tool roundtrip link section from sample 1902.
+
+The visible sample page must show only one launch action:
+
+Open with Workspace Manager
+
+## Scope
+- Target sample 1902 only.
+- Do not modify tool implementations.
+- Do not change workspace payload schema.
+- Do not change Workspace Manager behavior.
+- Do not add replacement direct tool links.
+- Do not touch start_of_day folders.
+
+## Acceptance
+- Opening sample 1902 shows only "Open with Workspace Manager" as the tool launch action.
+- No "Tool Roundtrip Links" heading is visible.
+- No direct tool links are visible.
+- Workspace Manager still opens sample 1902 payload.
+- Runtime smoke for sample 1902 and tools passes.

samples/index.render.js

@@ -3,6 +3,8 @@ import { launchWithExternalToolWorkspaceReset, resolveSampleToolLaunchHref } fro
 
 const METADATA_PATH = "./metadata/samples.index.metadata.json";
 const PINNED_KEY = "samples-index-pinned";
+const WORKSPACE_MANAGER_PATH = "/tools/Workspace%20Manager/index.html";
+const SAMPLE_1902_WORKSPACE_PRESET_PATH = "/samples/phase-19/1902/sample.1902.workspace-all-tools.json";
 
 function normalize(value) {
   return typeof value === "string" ? value.trim() : "";
@@ -50,6 +52,20 @@ function normalizePresetPath(value) {
   return "";
 }
 
+function buildWorkspaceManagerSampleLaunchHref(sample) {
+  const sampleId = normalize(sample?.id);
+  if (sampleId !== "1902") {
+    return "";
+  }
+  const params = new URLSearchParams({
+    tool: "vector-map-editor",
+    sampleId,
+    sampleTitle: normalize(sample?.title) || "",
+    samplePresetPath: SAMPLE_1902_WORKSPACE_PRESET_PATH
+  });
+  return `${WORKSPACE_MANAGER_PATH}?${params.toString()}`;
+}
+
 function getExplicitRoundtripPresetPath(sample, toolId) {
   const safeToolId = normalizeToken(toolId);
   if (!safeToolId) {
@@ -337,7 +353,19 @@ function buildSampleCard(sample) {
   card.appendChild(title);
   card.appendChild(previewWrap);
   card.appendChild(description);
-  if (Array.isArray(sample.roundtripLinks) && sample.roundtripLinks.length > 0) {
+  if (sample.id === "1902") {
+    const workspaceLaunchHref = buildWorkspaceManagerSampleLaunchHref(sample);
+    if (workspaceLaunchHref) {
+      const workspaceLaunchSection = document.createElement("section");
+      workspaceLaunchSection.className = "sample-tool-roundtrip";
+      workspaceLaunchSection.innerHTML = `
+        <ul>
+          <li><a data-tool-launch-href="${escapeHtml(workspaceLaunchHref)}" href="${escapeHtml(workspaceLaunchHref)}">Open with Workspace Manager</a></li>
+        </ul>
+      `;
+      card.appendChild(workspaceLaunchSection);
+    }
+  } else if (Array.isArray(sample.roundtripLinks) && sample.roundtripLinks.length > 0) {
     const roundtripSection = document.createElement("section");
     roundtripSection.className = "sample-tool-roundtrip";
     roundtripSection.innerHTML = `