Consolidate sample JSON ownership and tool sample alignment rules - PR 11.41. Remove default payload builders from 3D tools - PR 11.42

.

Author: DavidQ

docs/dev/codex_commands.md

@@ -1,84 +1,50 @@
 MODEL: GPT-5.3-codex
-REASONING: high
+REASONING: medium
 
 TASK:
-Apply PR 11.37.
-
-Perform a deep rename:
-Vector Asset Studio -> SVG Asset Studio
-
-This is not display-only. Rename directories, files, ids, usage, schema references, JSON payloads, docs, tests, imports, launch URLs, registry entries, and Workspace Manager references as needed.
-
-Canonical new identity:
-- display name: SVG Asset Studio
-- internal/tool id: svg-asset-studio
-- purpose: SVG-focused asset authoring studio
-
-Old identity:
-- display name: Vector Asset Studio
-- old id likely: vector-asset-studio
-
-Compatibility:
-- Provide one centralized temporary alias:
-  vector-asset-studio -> svg-asset-studio
-- The alias must be documented.
-- Do not scatter remapping logic across files.
-- Do not create duplicate tool entries.
-- Do not keep both tools visible.
-- Do not create pass-through variable chains.
-- Do not add hidden/default fallback data.
-
-Required work:
-1. Inspect actual current repo for all references:
-   - "Vector Asset Studio"
-   - "vector-asset-studio"
-   - "vectorAssetStudio"
-   - "vector asset studio"
-   - related path names
-2. Rename active tool directory/file names where feasible.
-3. Update imports and references.
-4. Update tool manifest/registry/schema entries.
-5. Update sample 1902 workspace JSON/payload references.
-6. Update docs/help text that users see.
-7. Update tests/smoke expectations.
-8. Keep old references only in:
-   - one compatibility alias location
-   - migration/report docs
-9. Validate no duplicate SVG/Vector Asset Studio tiles appear.
+Apply PR 11.42.
+
+Remove `buildDefaultPayload` from:
+- 3D Asset Viewer
+- 3D Camera Path Editor
+- 3D JSON Payload Normalizer
+
+This cleanup supports the explicit sample JSON/input contract from PR 11.41.
+
+Rules:
+- Do not fabricate payloads.
+- Do not auto-load hidden defaults.
+- Do not create fallback sample geometry/camera/path data.
+- When no payload/input exists, show a safe empty state explaining explicit JSON/input is required.
+- Preserve behavior when explicit payload/input is provided.
+- Keep changes limited to the listed tools and direct shared helpers only if required.
+
+Search terms:
+- buildDefaultPayload
+- 3d asset viewer
+- 3d camera path editor
+- 3d json payload normalizer
+- payload normalizer
 
 Do NOT:
-- change unrelated tool behavior
-- modify Vector Map Editor except where it references the renamed tool
-- modify payload behavior except ID/name migration
-- touch start_of_day folders unless required by active runtime validation
-- leave mixed canonical naming
+- change unrelated tools
+- change sample 1902 workspace payload except as needed for correct explicit-input messaging
+- undo SVG Asset Studio rename
+- touch start_of_day folders
 
 Validation:
+Run targeted syntax checks for changed JS files.
 Run:
-node --check tools/shared/platformShell.js
-node ./tests/runtime/LaunchSmokeAllEntries.test.mjs --samples --sample-range=1902-1902 --tools
+node ./tests/runtime/LaunchSmokeAllEntries.test.mjs --samples --tools
 
-Also run repo search checks and include results in report:
-- search for "Vector Asset Studio"
-- search for "vector-asset-studio"
-- search for "SVG Asset Studio"
-- search for "svg-asset-studio"
+If full smoke is too broad, run relevant targeted smoke and document why.
 
-Manual validation:
-Open sample 1902 -> Workspace Manager.
-Confirm:
-- one tile only: SVG Asset Studio
-- no Vector Asset Studio tile
-- SVG Asset Studio opens
-- Vector Map Editor still opens
-- workspace payload still loads correctly
+Reports:
+Write:
+docs/dev/reports/PR_11_42_validation.txt
 
-REPORT:
-Write docs/dev/reports/PR_11_37_deep_rename_validation.txt with:
-- files renamed
-- files edited
-- canonical new IDs/names
-- compatibility alias location
-- remaining old-name references and why each is allowed
+Report must include:
+- files changed
+- each removed buildDefaultPayload location
+- new no-input behavior for each tool
 - validation command results
-- manual validation notes

docs/dev/commit_comment.txt

@@ -1 +1 @@
-Deep rename Vector Asset Studio to SVG Asset Studio - PR 11.37
+Remove default payload builders from 3D tools - PR 11.42

docs/dev/reports/PR_11_41_sample_json_ownership_audit.md

@@ -0,0 +1,26 @@
+# PR 11.41 Sample JSON Ownership Audit
+
+## Contract
+Sample JSON must belong to the correct executable sample for the correct tool/use case.
+
+If it does not fit, it must be rehomed, deleted, or replaced by a correct sample update while preserving coverage.
+
+## Sample 1902 Exception
+Sample 1902 is a Workspace Manager/workspace integration sample and is exempt from single-tool JSON ownership enforcement.
+
+## Decision Table
+
+| JSON Path | Current Sample | Intended Tool/Use Case | Executable Entry Point | Fits Current Sample? | Loaded? | Visible Effect? | Decision | Reason |
+|---|---|---|---|---|---|---|---|---|
+
+## Files Moved
+
+## Files Deleted
+
+## Files Updated
+
+## Files Created
+
+## Coverage Preserved Statement
+
+## Uncertain Items Deferred

docs/dev/reports/PR_11_41_sample_json_ownership_audit_template.md

@@ -0,0 +1,46 @@
+PR 11.41 Validation
+
+Status: PASS
+
+Task summary
+- Consolidated audit logic for PR 11.38/11.39/11.40 into a single executable audit path.
+- Added explicit sample 1902 workspace exemption handling.
+- Generated ownership decision table and deferred-only list without destructive JSON moves/deletes.
+
+Changed files
+- scripts/audit-sample-json-ownership.mjs
+- docs/dev/reports/PR_11_41_sample_json_ownership_audit.md
+- docs/dev/reports/launch_smoke_report.md
+
+Validation commands and results
+1) node --check tools/shared/platformShell.js
+- PASS
+
+2) node ./tests/runtime/LaunchSmokeAllEntries.test.mjs --samples --tools
+- PASS
+- Summary: PASS=275 FAIL=0 TOTAL=275
+- Includes sample 1902 PASS and all tool entry PASS.
+
+3) git diff --check
+- PASS
+
+Audit output summary
+- Total audited sample JSON files: 94
+- KEEP + WIRE: 73
+- MOVE / REHOME: 0
+- DELETE: 0
+- CREATE / UPDATE CORRECT SAMPLE: 20 (deferred/uncertain, no destructive action in this PR)
+- EXEMPT WORKSPACE SAMPLE: 1 (samples/phase-19/1902/sample.1902.workspace-all-tools.json)
+
+Sample 1902 exemption confirmation
+- Sample 1902 treated as workspace aggregation sample.
+- Single-tool KEEP/MOVE/DELETE enforcement was not applied to 1902.
+- 1902 JSON was validated only for workspace integration context.
+
+Manual validation notes
+- No sample JSON files were moved/deleted/rewired in this PR, so there are no changed sample payload ownership paths requiring manual re-check.
+- Runtime smoke includes sample 1902 launch PASS, confirming workspace JSON remains loadable under exemption.
+
+Remaining deferred items
+- 20 sample-local companion JSON files are documented in the audit report as uncertain/non-authoritative for destructive action.
+- These are deferred to a follow-up PR to avoid reducing coverage or guessing ownership.

docs/dev/reports/PR_11_41_validation.txt

@@ -0,0 +1,20 @@
+# PR 11.41 Validation
+
+## Changed Files
+-
+
+## Sample 1902 Exemption Confirmed
+-
+
+## Coverage Preserved
+-
+
+## Validation Commands
+- node --check tools/shared/platformShell.js
+- node ./tests/runtime/LaunchSmokeAllEntries.test.mjs --samples --tools
+
+## Manual Validation
+-
+
+## Notes
+-

docs/dev/reports/PR_11_41_validation_template.txt

@@ -0,0 +1,69 @@
+PR 11.42 Validation
+
+Status: PASS
+
+Files changed
+- tools/3D Asset Viewer/main.js
+- tools/3D Camera Path Editor/main.js
+- tools/3D JSON Payload Normalizer/main.js
+- docs/dev/reports/PR_11_42_validation.txt
+- docs/dev/reports/launch_smoke_report.md
+
+Removed buildDefaultPayload locations
+1) tools/3D Asset Viewer/main.js
+- Removed `buildDefaultPayload` function.
+- Removed boot-time default textarea fill (`refs.input.value = toPrettyJson(buildDefaultPayload())`).
+- Removed normalize fallback that returned `buildDefaultPayload()` when raw payload was missing.
+
+2) tools/3D Camera Path Editor/main.js
+- Removed `buildDefaultPayload` function.
+- Removed boot-time default textarea fill (`refs.input.value = toPrettyJson(buildDefaultPayload())`).
+- Removed normalize fallback that returned `buildDefaultPayload()` when raw payload was missing.
+- Removed add-waypoint fallback (`parseInputPayload() || buildDefaultPayload()`).
+
+3) tools/3D JSON Payload Normalizer/main.js
+- Removed `buildDefaultPayload` function.
+- Removed boot-time default textarea fill (`refs.input.value = toPrettyJson(buildDefaultPayload())`).
+- Removed normalize fallback that returned `buildDefaultPayload()` when raw payload was missing.
+
+New no-input behavior
+1) 3D Asset Viewer
+- On missing `samplePresetPath`, status now shows:
+  "No 3D asset payload loaded. Provide explicit JSON input or launch with samplePresetPath."
+- On empty textarea at boot, no payload is fabricated; same explicit-input status is shown.
+- Explicit preset/input flow remains unchanged when valid payload exists.
+
+2) 3D Camera Path Editor
+- On missing `samplePresetPath`, status now shows:
+  "No camera path payload loaded. Provide explicit JSON input or launch with samplePresetPath."
+- On empty textarea at boot, no payload is fabricated; same explicit-input status is shown.
+- Add Waypoint now requires existing explicit JSON input; if missing/invalid it shows:
+  "Cannot add waypoint: explicit camera path JSON input is required."
+- Explicit preset/input flow remains unchanged when valid payload exists.
+
+3) 3D JSON Payload Normalizer
+- On missing `samplePresetPath`, status now shows:
+  "No map payload loaded. Provide explicit JSON input or launch with samplePresetPath."
+- On empty textarea at boot, no payload is fabricated; same explicit-input status is shown.
+- Explicit preset/input flow remains unchanged when valid payload exists.
+
+Validation commands and results
+- rg -n "buildDefaultPayload" "tools/3D Asset Viewer/main.js" "tools/3D Camera Path Editor/main.js" "tools/3D JSON Payload Normalizer/main.js"
+  - Result: no matches (function fully removed from all 3 target files).
+
+- node --check "tools/3D Asset Viewer/main.js"
+  - PASS
+
+- node --check "tools/3D Camera Path Editor/main.js"
+  - PASS
+
+- node --check "tools/3D JSON Payload Normalizer/main.js"
+  - PASS
+
+- node ./tests/runtime/LaunchSmokeAllEntries.test.mjs --samples --tools
+  - PASS
+  - Summary: PASS=275 FAIL=0 TOTAL=275
+
+Notes
+- No hidden/default sample geometry/camera/path payloads are auto-loaded by these three tools after this change.
+- Scope remained limited to the listed tools and reporting.

docs/dev/reports/PR_11_42_validation.txt

@@ -0,0 +1,18 @@
+# PR 11.42 Validation
+
+## Changed Files
+-
+
+## Removed buildDefaultPayload Locations
+-
+
+## New No-Input Behavior
+
+### 3D Asset Viewer
+
+### 3D Camera Path Editor
+
+### 3D JSON Payload Normalizer
+
+## Validation
+-