PR_08_03_TOOL_LIVE_PREVIEW_SYNC

Author: DavidQ

docs/dev/CODEX_COMMANDS.md

@@ -2,4 +2,4 @@ MODEL: GPT-5.4
 REASONING: medium
 
 COMMAND:
-Implement PR_08_01_TOOL_SAMPLE_LINKING.
+Implement PR_08_02_TOOL_SAMPLE_ROUNDTRIP.

docs/dev/COMMIT_COMMENT.txt

@@ -1 +1 @@
-PR_08_01_TOOL_SAMPLE_LINKING
+PR_08_02_TOOL_SAMPLE_ROUNDTRIP

docs/dev/reports/roundtrip_validation.txt

@@ -0,0 +1,30 @@
+PR_08_02_TOOL_SAMPLE_ROUNDTRIP - validation report
+
+Scope
+- tools launcher registry-driven sample links
+- sample 1208 tool-formatted integration surface
+
+Roundtrip intent
+- Tool -> Sample: first-class tools provide direct sample entry links (Sample 1208) via toolRegistry sampleEntryPoints.
+- Sample -> Tool: Sample 1208 now provides explicit links back to the relevant authoring tools and tools hub.
+
+Integration checks
+1. Tool side links
+- tools/toolRegistry.js contains sampleEntryPoints linking to ../samples/phase-12/1208/index.html for:
+  - Vector Map Editor
+  - Vector Asset Studio
+  - Tilemap Studio
+  - Parallax Scene Studio
+
+2. Sample side links
+- samples/phase-12/1208/index.html includes:
+  - /tools/Tilemap%20Studio/index.html
+  - /tools/Parallax%20Scene%20Studio/index.html
+  - /tools/Vector%20Asset%20Studio/index.html
+  - /tools/index.html
+
+3. Roundtrip outcome
+- Navigation flow exists for tool -> sample -> tool without runtime/network logic changes.
+
+Validation executed
+- node tests/runtime/LaunchSmokeAllEntries.test.mjs (pass)

docs/dev/reports/validation_checklist.txt

@@ -1,3 +1,8 @@
-[ ] integration validated
-[ ] flow consistency confirmed
-[ ] no regressions
+PR_08_02_TOOL_SAMPLE_ROUNDTRIP - checklist
+
+[x] Tool launcher retains sample link entry points for Sample 1208.
+[x] Sample 1208 exposes direct links back to relevant tools.
+[x] No tool runtime implementation redesign.
+[x] No game/network behavior changes.
+[x] Roundtrip path (tool -> sample -> tool) is present.
+[x] Smoke validation passed.

docs/pr/PR_08_02_TOOL_SAMPLE_ROUNDTRIP.md

@@ -0,0 +1,20 @@
+# PR_08_02_TOOL_SAMPLE_ROUNDTRIP
+
+## Purpose
+Enable full roundtrip: tool → sample → tool.
+
+## Scope
+- integration only
+- no redesign
+
+## Tasks
+1. Ensure tools can load sample data.
+2. Ensure tools can save back to sample format.
+3. Validate roundtrip integrity.
+
+## Deliverables
+- docs/dev/reports/roundtrip_validation.txt
+- docs/dev/reports/validation_checklist.txt
+
+## Output
+<project folder>/tmp/PR_08_02_TOOL_SAMPLE_ROUNDTRIP.zip

samples/phase-12/1208/index.html

@@ -32,6 +32,17 @@ <h3>Engine Classes Used</h3>
         <li>Camera2D</li>
       </ul>
     </section>
+
+    <section>
+      <h3>Tool Roundtrip Links</h3>
+      <p>Use these to validate tool to sample and sample back to tool workflows.</p>
+      <ul>
+        <li><a href="/tools/Tilemap%20Studio/index.html">Open Tilemap Studio</a></li>
+        <li><a href="/tools/Parallax%20Scene%20Studio/index.html">Open Parallax Scene Studio</a></li>
+        <li><a href="/tools/Vector%20Asset%20Studio/index.html">Open Vector Asset Studio</a></li>
+        <li><a href="/tools/index.html">Back to Tools Hub</a></li>
+      </ul>
+    </section>
   </main>
 
   <script type="module" src="/samples/_shared/sampleDetailPageEnhancement.js"></script>