Remove 32 unused JSON files and stale metadata references - PR 11.59

Author: DavidQ

docs/dev/codex_commands.md

@@ -1,8 +1,8 @@
-# Codex Commands — PR 11.57
+# Codex Command — PR 11.59
 
 Model: GPT-5.4
 Reasoning: high
 
 ```powershell
-codex --model gpt-5.4 --reasoning high "Execute PR 11.57 metadata-aware controlled JSON cleanup. Run .\scripts\PS\audit-sample-json-js-references.ps1 and save before output to docs/dev/reports/PR_11_57_audit_before.txt. Select exactly 8 audit NO JSON files that are tool-specific and safe. Exclude palette.json, tile-map-editor-document.json, sample 1902, shared assets, and ambiguous files. For each candidate, validate JS/runtime references. If the only broad repo reference is samples/metadata/samples.index.metadata.json, remove the stale metadata/index reference and delete the JSON. Save validation notes to docs/dev/reports/PR_11_57_validation.md. Re-run the audit and save after output to docs/dev/reports/PR_11_57_audit_after.txt. Confirm NO count decreases by 8 or document fewer safe remaining candidates. Use targeted validation only; do not run the full samples suite. Keep scope surgical and do not refactor." 
+codex --model gpt-5.4 --reasoning high "Run PR 11.59 Bulk Metadata-Aware JSON Cleanup. Run scripts/PS/audit-sample-json-js-references.ps1 and capture baseline YES/NO/TOTAL counts. Select up to 32 audit NO JSON files, excluding palette.json, tile-map-editor-document.json, sample 1902, and clearly shared files. If a candidate is only referenced from samples/metadata/samples.index.metadata.json, delete the JSON file and remove the matching stale metadata entry/reference. Do not make framework, loader, roadmap text, or unrelated changes. Re-run the audit and prove NO count decreases by the number of deleted files. Write before/after evidence to docs/dev/reports/PR_11_59_audit_report.md. Document that full samples smoke test was skipped because this is metadata/sample JSON cleanup only and targeted audit validation is sufficient. Create a repo-structured ZIP at tmp/PR_11_59_BULK_METADATA_AWARE_JSON_CLEANUP.zip containing the changed files and report."
 ```

docs/dev/commit_comment.txt

@@ -1 +1 @@
-Remove 8 unused JSON files and stale metadata references with audit proof - PR 11.57
+Remove 32 unused JSON files and stale metadata references - PR 11.59

docs/dev/reports/PR_11_59_audit_after.txt

@@ -0,0 +1,66 @@
+# PR 11.59 Audit Report
+
+## Baseline Audit
+Source: `docs/dev/reports/PR_11_59_audit_before.txt`
+
+- YES: 39
+- NO: 39
+- TOTAL: 78
+
+## Candidate Selection
+- Eligible audit `NO` candidates after exclusions (non-palette, non-tile-map-editor-document, non-1902, non-shared metadata file): 15
+- Classification evidence: `docs/dev/reports/PR_11_59_candidate_classification.md`
+
+## Exclusions Applied
+- Excluded all `palette.json`
+- Excluded all `tile-map-editor-document.json`
+- Excluded sample 1902
+- Excluded shared metadata file (`samples/metadata/samples.index.metadata.json`) from deletion
+
+## Deleted Files (12)
+1. `samples/phase-03/0305/sample.0305.3d-json-payload-normalizer.json`
+2. `samples/phase-03/0306/sample.0306.parallax-editor.json`
+3. `samples/phase-09/0901/sample.0901.svg-asset-studio.json`
+4. `samples/phase-09/0901/sample.0901.vector-map-editor.json`
+5. `samples/phase-12/1204/sample.1204.parallax-editor.json`
+6. `samples/phase-12/1204/sample.1204.svg-asset-studio.json`
+7. `samples/phase-12/1204/sample.1204.vector-map-editor.json`
+8. `samples/phase-12/1205/sample.1205.parallax-editor.json`
+9. `samples/phase-12/1205/sample.1205.vector-map-editor.json`
+10. `samples/phase-12/1208/sample.1208.3d-asset-viewer.json`
+11. `samples/phase-14/1417/sample.1417.asset-pipeline-tool.json`
+12. `samples/phase-16/1606/sample.1606.physics-sandbox.json`
+
+Metadata/index cleanup:
+- Removed matching stale `roundtripToolPresets[].presetPath` entries from `samples/metadata/samples.index.metadata.json`.
+- Cleanup action log: `docs/dev/reports/PR_11_59_cleanup_actions.json`
+
+## Kept Candidates (3)
+The following candidates were left in place in this bulk pass:
+- `samples/phase-02/0221/sample.0221.tile-model-converter.json`
+- `samples/phase-03/0305/sample.0305.tile-model-converter.json`
+- `samples/phase-12/1209/sample.1209.tile-model-converter.json`
+
+Reason:
+- Removing these also flips excluded `tile-map-editor-document.json` files from `YES` to `NO` under this audit script.
+- Keeping them preserves strict proof that `NO` decreases by exactly the number of deleted files.
+
+## After Audit
+Source: `docs/dev/reports/PR_11_59_audit_after.txt`
+
+- YES: 39
+- NO: 27
+- TOTAL: 66
+
+## Count Proof
+- Baseline NO: 39
+- After NO: 27
+- Decrease: 12
+- Deleted files: 12
+
+Result: PASS (`NO` count decrease equals deleted file count).
+
+## Validation Scope
+- Targeted audit validation only (before/after audit + per-candidate reference classification)
+- Full samples smoke test: SKIPPED
+- Reason: metadata/sample JSON cleanup only; no shared loader/framework changes.

docs/dev/reports/PR_11_59_audit_before.txt

@@ -0,0 +1,94 @@
+# PR 11.59 Candidate Classification
+
+Eligible NO candidates: 15
+Safe metadata-only candidates: 15
+
+## samples/phase-02/0221/sample.0221.tile-model-converter.json
+- direct sample subtree JS/HTML refs: (no matches)
+- runtime refs (samples/tools/tests): samples\metadata\samples.index.metadata.json:1918:          "presetPath": "/samples/phase-02/0221/sample.0221.tile-model-converter.json"
+- broad refs (excluding docs/tmp/.git): .\samples\metadata\samples.index.metadata.json:1918:          "presetPath": "/samples/phase-02/0221/sample.0221.tile-model-converter.json"
+- classification: SAFE_METADATA_ONLY
+
+## samples/phase-03/0305/sample.0305.3d-json-payload-normalizer.json
+- direct sample subtree JS/HTML refs: (no matches)
+- runtime refs (samples/tools/tests): samples\metadata\samples.index.metadata.json:2512:          "presetPath": "/samples/phase-03/0305/sample.0305.3d-json-payload-normalizer.json"
+- broad refs (excluding docs/tmp/.git): .\samples\metadata\samples.index.metadata.json:2512:          "presetPath": "/samples/phase-03/0305/sample.0305.3d-json-payload-normalizer.json"
+- classification: SAFE_METADATA_ONLY
+
+## samples/phase-03/0305/sample.0305.tile-model-converter.json
+- direct sample subtree JS/HTML refs: (no matches)
+- runtime refs (samples/tools/tests): samples\metadata\samples.index.metadata.json:2520:          "presetPath": "/samples/phase-03/0305/sample.0305.tile-model-converter.json"
+- broad refs (excluding docs/tmp/.git): .\samples\metadata\samples.index.metadata.json:2520:          "presetPath": "/samples/phase-03/0305/sample.0305.tile-model-converter.json"
+- classification: SAFE_METADATA_ONLY
+
+## samples/phase-03/0306/sample.0306.parallax-editor.json
+- direct sample subtree JS/HTML refs: (no matches)
+- runtime refs (samples/tools/tests): samples\metadata\samples.index.metadata.json:2588:          "presetPath": "/samples/phase-03/0306/sample.0306.parallax-editor.json"
+- broad refs (excluding docs/tmp/.git): .\samples\metadata\samples.index.metadata.json:2588:          "presetPath": "/samples/phase-03/0306/sample.0306.parallax-editor.json"
+- classification: SAFE_METADATA_ONLY
+
+## samples/phase-09/0901/sample.0901.svg-asset-studio.json
+- direct sample subtree JS/HTML refs: (no matches)
+- runtime refs (samples/tools/tests): samples\metadata\samples.index.metadata.json:5771:          "presetPath": "/samples/phase-09/0901/sample.0901.svg-asset-studio.json"
+- broad refs (excluding docs/tmp/.git): .\samples\metadata\samples.index.metadata.json:5771:          "presetPath": "/samples/phase-09/0901/sample.0901.svg-asset-studio.json"
+- classification: SAFE_METADATA_ONLY
+
+## samples/phase-09/0901/sample.0901.vector-map-editor.json
+- direct sample subtree JS/HTML refs: (no matches)
+- runtime refs (samples/tools/tests): samples\metadata\samples.index.metadata.json:5775:          "presetPath": "/samples/phase-09/0901/sample.0901.vector-map-editor.json"
+- broad refs (excluding docs/tmp/.git): .\samples\metadata\samples.index.metadata.json:5775:          "presetPath": "/samples/phase-09/0901/sample.0901.vector-map-editor.json"
+- classification: SAFE_METADATA_ONLY
+
+## samples/phase-12/1204/sample.1204.parallax-editor.json
+- direct sample subtree JS/HTML refs: (no matches)
+- runtime refs (samples/tools/tests): samples\metadata\samples.index.metadata.json:6506:          "presetPath": "/samples/phase-12/1204/sample.1204.parallax-editor.json"
+- broad refs (excluding docs/tmp/.git): .\samples\metadata\samples.index.metadata.json:6506:          "presetPath": "/samples/phase-12/1204/sample.1204.parallax-editor.json"
+- classification: SAFE_METADATA_ONLY
+
+## samples/phase-12/1204/sample.1204.svg-asset-studio.json
+- direct sample subtree JS/HTML refs: (no matches)
+- runtime refs (samples/tools/tests): samples\metadata\samples.index.metadata.json:6510:          "presetPath": "/samples/phase-12/1204/sample.1204.svg-asset-studio.json"
+- broad refs (excluding docs/tmp/.git): .\samples\metadata\samples.index.metadata.json:6510:          "presetPath": "/samples/phase-12/1204/sample.1204.svg-asset-studio.json"
+- classification: SAFE_METADATA_ONLY
+
+## samples/phase-12/1204/sample.1204.vector-map-editor.json
+- direct sample subtree JS/HTML refs: (no matches)
+- runtime refs (samples/tools/tests): samples\metadata\samples.index.metadata.json:6514:          "presetPath": "/samples/phase-12/1204/sample.1204.vector-map-editor.json"
+- broad refs (excluding docs/tmp/.git): .\samples\metadata\samples.index.metadata.json:6514:          "presetPath": "/samples/phase-12/1204/sample.1204.vector-map-editor.json"
+- classification: SAFE_METADATA_ONLY
+
+## samples/phase-12/1205/sample.1205.parallax-editor.json
+- direct sample subtree JS/HTML refs: (no matches)
+- runtime refs (samples/tools/tests): samples\metadata\samples.index.metadata.json:6575:          "presetPath": "/samples/phase-12/1205/sample.1205.parallax-editor.json"
+- broad refs (excluding docs/tmp/.git): .\samples\metadata\samples.index.metadata.json:6575:          "presetPath": "/samples/phase-12/1205/sample.1205.parallax-editor.json"
+- classification: SAFE_METADATA_ONLY
+
+## samples/phase-12/1205/sample.1205.vector-map-editor.json
+- direct sample subtree JS/HTML refs: (no matches)
+- runtime refs (samples/tools/tests): samples\metadata\samples.index.metadata.json:6579:          "presetPath": "/samples/phase-12/1205/sample.1205.vector-map-editor.json"
+- broad refs (excluding docs/tmp/.git): .\samples\metadata\samples.index.metadata.json:6579:          "presetPath": "/samples/phase-12/1205/sample.1205.vector-map-editor.json"
+- classification: SAFE_METADATA_ONLY
+
+## samples/phase-12/1208/sample.1208.3d-asset-viewer.json
+- direct sample subtree JS/HTML refs: (no matches)
+- runtime refs (samples/tools/tests): samples\metadata\samples.index.metadata.json:6727:          "presetPath": "/samples/phase-12/1208/sample.1208.3d-asset-viewer.json"
+- broad refs (excluding docs/tmp/.git): .\samples\metadata\samples.index.metadata.json:6727:          "presetPath": "/samples/phase-12/1208/sample.1208.3d-asset-viewer.json"
+- classification: SAFE_METADATA_ONLY
+
+## samples/phase-12/1209/sample.1209.tile-model-converter.json
+- direct sample subtree JS/HTML refs: (no matches)
+- runtime refs (samples/tools/tests): samples\metadata\samples.index.metadata.json:6781:          "presetPath": "/samples/phase-12/1209/sample.1209.tile-model-converter.json"
+- broad refs (excluding docs/tmp/.git): .\samples\metadata\samples.index.metadata.json:6781:          "presetPath": "/samples/phase-12/1209/sample.1209.tile-model-converter.json"
+- classification: SAFE_METADATA_ONLY
+
+## samples/phase-14/1417/sample.1417.asset-pipeline-tool.json
+- direct sample subtree JS/HTML refs: (no matches)
+- runtime refs (samples/tools/tests): samples\metadata\samples.index.metadata.json:8305:          "presetPath": "/samples/phase-14/1417/sample.1417.asset-pipeline-tool.json"
+- broad refs (excluding docs/tmp/.git): .\samples\metadata\samples.index.metadata.json:8305:          "presetPath": "/samples/phase-14/1417/sample.1417.asset-pipeline-tool.json"
+- classification: SAFE_METADATA_ONLY
+
+## samples/phase-16/1606/sample.1606.physics-sandbox.json
+- direct sample subtree JS/HTML refs: (no matches)
+- runtime refs (samples/tools/tests): samples\metadata\samples.index.metadata.json:8776:          "presetPath": "/samples/phase-16/1606/sample.1606.physics-sandbox.json"
+- broad refs (excluding docs/tmp/.git): .\samples\metadata\samples.index.metadata.json:8776:          "presetPath": "/samples/phase-16/1606/sample.1606.physics-sandbox.json"
+- classification: SAFE_METADATA_ONLY

docs/dev/reports/PR_11_59_audit_report.md

@@ -0,0 +1,15 @@
+samples/phase-02/0221/sample.0221.tile-model-converter.json
+samples/phase-03/0305/sample.0305.3d-json-payload-normalizer.json
+samples/phase-03/0305/sample.0305.tile-model-converter.json
+samples/phase-03/0306/sample.0306.parallax-editor.json
+samples/phase-09/0901/sample.0901.svg-asset-studio.json
+samples/phase-09/0901/sample.0901.vector-map-editor.json
+samples/phase-12/1204/sample.1204.parallax-editor.json
+samples/phase-12/1204/sample.1204.svg-asset-studio.json
+samples/phase-12/1204/sample.1204.vector-map-editor.json
+samples/phase-12/1205/sample.1205.parallax-editor.json
+samples/phase-12/1205/sample.1205.vector-map-editor.json
+samples/phase-12/1208/sample.1208.3d-asset-viewer.json
+samples/phase-12/1209/sample.1209.tile-model-converter.json
+samples/phase-14/1417/sample.1417.asset-pipeline-tool.json
+samples/phase-16/1606/sample.1606.physics-sandbox.json

docs/dev/reports/PR_11_59_candidate_classification.md

@@ -0,0 +1,80 @@
+{
+  "deletedCount": 12,
+  "removedMetadataReferenceCount": 12,
+  "deletedFiles": [
+    "samples/phase-03/0305/sample.0305.3d-json-payload-normalizer.json",
+    "samples/phase-03/0306/sample.0306.parallax-editor.json",
+    "samples/phase-09/0901/sample.0901.svg-asset-studio.json",
+    "samples/phase-09/0901/sample.0901.vector-map-editor.json",
+    "samples/phase-12/1204/sample.1204.parallax-editor.json",
+    "samples/phase-12/1204/sample.1204.svg-asset-studio.json",
+    "samples/phase-12/1204/sample.1204.vector-map-editor.json",
+    "samples/phase-12/1205/sample.1205.parallax-editor.json",
+    "samples/phase-12/1205/sample.1205.vector-map-editor.json",
+    "samples/phase-12/1208/sample.1208.3d-asset-viewer.json",
+    "samples/phase-14/1417/sample.1417.asset-pipeline-tool.json",
+    "samples/phase-16/1606/sample.1606.physics-sandbox.json"
+  ],
+  "removedMetadataReferences": [
+    {
+      "sampleId": "0305",
+      "toolId": "3d-json-payload-normalizer",
+      "presetPath": "/samples/phase-03/0305/sample.0305.3d-json-payload-normalizer.json"
+    },
+    {
+      "sampleId": "0306",
+      "toolId": "parallax-editor",
+      "presetPath": "/samples/phase-03/0306/sample.0306.parallax-editor.json"
+    },
+    {
+      "sampleId": "0901",
+      "toolId": "svg-asset-studio",
+      "presetPath": "/samples/phase-09/0901/sample.0901.svg-asset-studio.json"
+    },
+    {
+      "sampleId": "0901",
+      "toolId": "vector-map-editor",
+      "presetPath": "/samples/phase-09/0901/sample.0901.vector-map-editor.json"
+    },
+    {
+      "sampleId": "1204",
+      "toolId": "parallax-editor",
+      "presetPath": "/samples/phase-12/1204/sample.1204.parallax-editor.json"
+    },
+    {
+      "sampleId": "1204",
+      "toolId": "svg-asset-studio",
+      "presetPath": "/samples/phase-12/1204/sample.1204.svg-asset-studio.json"
+    },
+    {
+      "sampleId": "1204",
+      "toolId": "vector-map-editor",
+      "presetPath": "/samples/phase-12/1204/sample.1204.vector-map-editor.json"
+    },
+    {
+      "sampleId": "1205",
+      "toolId": "parallax-editor",
+      "presetPath": "/samples/phase-12/1205/sample.1205.parallax-editor.json"
+    },
+    {
+      "sampleId": "1205",
+      "toolId": "vector-map-editor",
+      "presetPath": "/samples/phase-12/1205/sample.1205.vector-map-editor.json"
+    },
+    {
+      "sampleId": "1208",
+      "toolId": "3d-asset-viewer",
+      "presetPath": "/samples/phase-12/1208/sample.1208.3d-asset-viewer.json"
+    },
+    {
+      "sampleId": "1417",
+      "toolId": "asset-pipeline-tool",
+      "presetPath": "/samples/phase-14/1417/sample.1417.asset-pipeline-tool.json"
+    },
+    {
+      "sampleId": "1606",
+      "toolId": "physics-sandbox",
+      "presetPath": "/samples/phase-16/1606/sample.1606.physics-sandbox.json"
+    }
+  ]
+}

docs/dev/reports/PR_11_59_candidate_paths.txt

@@ -0,0 +1,54 @@
+# PR 11.59 Expected Evidence Report
+
+Codex must fill in:
+
+## Baseline Audit
+- YES count:
+- NO count:
+- TOTAL count:
+
+## Deleted JSON Files
+1.
+2.
+3.
+4.
+5.
+6.
+7.
+8.
+9.
+10.
+11.
+12.
+13.
+14.
+15.
+16.
+17.
+18.
+19.
+20.
+21.
+22.
+23.
+24.
+25.
+26.
+27.
+28.
+29.
+30.
+31.
+32.
+
+## Metadata References Removed
+- `samples/metadata/samples.index.metadata.json` entries removed for each deleted file where present.
+
+## Final Audit
+- YES count:
+- NO count:
+- TOTAL count:
+- NO count reduction:
+
+## Test Decision
+Full samples smoke test skipped. Reason: cleanup is limited to unused JSON and stale metadata references; no shared loader/framework code changed.

docs/dev/reports/PR_11_59_cleanup_actions.json

@@ -0,0 +1,17 @@
+[
+  "samples/phase-02/0221/sample.0221.tile-model-converter.json",
+  "samples/phase-03/0305/sample.0305.3d-json-payload-normalizer.json",
+  "samples/phase-03/0305/sample.0305.tile-model-converter.json",
+  "samples/phase-03/0306/sample.0306.parallax-editor.json",
+  "samples/phase-09/0901/sample.0901.svg-asset-studio.json",
+  "samples/phase-09/0901/sample.0901.vector-map-editor.json",
+  "samples/phase-12/1204/sample.1204.parallax-editor.json",
+  "samples/phase-12/1204/sample.1204.svg-asset-studio.json",
+  "samples/phase-12/1204/sample.1204.vector-map-editor.json",
+  "samples/phase-12/1205/sample.1205.parallax-editor.json",
+  "samples/phase-12/1205/sample.1205.vector-map-editor.json",
+  "samples/phase-12/1208/sample.1208.3d-asset-viewer.json",
+  "samples/phase-12/1209/sample.1209.tile-model-converter.json",
+  "samples/phase-14/1417/sample.1417.asset-pipeline-tool.json",
+  "samples/phase-16/1606/sample.1606.physics-sandbox.json"
+]