Enforce compact primitive array formatting across repo - PR 11.100

Author: DavidQ

docs/dev/PROJECT_INSTRUCTIONS.md

@@ -286,4 +286,13 @@ These rules are mandatory for every Codex BUILD execution:
 ## Current Recovery Lane
 
 The active UAT lane is opening Workspace Manager from a `games/index.html` game tile.
-Treat this as a recovery/stabilization PR only. Do not expand into a broader games hub, tool registry, template, or roadmap rewrite.
+Treat this as a recovery/stabilization PR only. Do not expand into a broader games hub, tool registry, template, or roadmap rewrite.
+
+---
+
+## ARRAY FORMATTING RULE
+
+- Primitive-only arrays in JSON must use compact single-line formatting.
+- Primitive values are: string, number, boolean, and null.
+- Complex arrays (arrays containing objects or nested arrays) must not be compacted.
+- Do not change JSON contracts or semantics while applying array formatting.

docs/dev/codex_commands.md

@@ -1,8 +1,12 @@
-# Codex Commands - PR 11.99
+# CODEX COMMANDS
 
-Model: GPT-5.4
-Reasoning: high
+Model: GPT-5.3-codex
+Reasoning: low
 
-```powershell
-codex exec --model gpt-5.4 --reasoning high "Apply docs/pr/PR_11_99_SCHEMA_FAILURE_CLEANUP_AND_SAMPLE_CONTRACT_ALIGNMENT/BUILD.md exactly. Keep scope to strict schema failure cleanup. Do not loosen schemas. Do not create fallback assets or media buckets. Produce required reports and final repo-structured ZIP at tmp/PR_11_99_SCHEMA_FAILURE_CLEANUP_AND_SAMPLE_CONTRACT_ALIGNMENT.zip."
-```
+Apply formatting rule:
+
+1. Update PROJECT_INSTRUCTIONS.md with ARRAY FORMATTING RULE
+2. Scan repo JSON files
+3. Convert primitive arrays to compact format
+4. Do NOT modify complex arrays
+5. Validate JSON syntax

docs/dev/commit_comment.txt

@@ -1 +1 @@
-Normalize strict sample contracts without weakening schemas - PR 11.99
+Enforce compact primitive array formatting across repo - PR 11.100

docs/dev/project_instructions_update.md

@@ -0,0 +1,48 @@
+# PROJECT INSTRUCTIONS (UPDATE)
+
+## 🔧 ARRAY FORMATTING RULE (MANDATORY)
+
+All arrays MUST be formatted in single-line compact form when values are simple primitives.
+
+### ❌ Invalid
+[
+  1,
+  1,
+  1,
+  1,
+  1,
+  1,
+  1,
+  1,
+  1,
+  1,
+  1,
+  1
+],
+
+### ✅ Valid
+[
+  1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1
+],
+
+## Rules
+
+- Apply to:
+  - numbers
+  - strings
+  - booleans
+
+- Do NOT apply to:
+  - objects
+  - nested arrays
+  - complex structures
+
+- Max line length rule:
+  - If array exceeds reasonable readability (~120 chars), allow wrap but prefer compact grouping
+
+## Enforcement
+
+- Schema validation MUST NOT allow multi-line primitive arrays
+- Codex must normalize arrays during BUILD
+- All samples/tools/games must comply
+

docs/dev/reports/PR_11_21_workspace_tool_presence_evidence.json

@@ -1,26 +1,7 @@
 {
   "sourcePath": "samples/phase-19/1902/sample.1902.workspace-all-tools.json",
   "schemaPath": "tools/schemas/workspace.manifest.schema.json",
-  "rawLoadedToolKeys": [
-    "vector-map-editor",
-    "vector-asset-studio",
-    "tile-map-editor",
-    "parallax-editor",
-    "sprite-editor",
-    "skin-editor",
-    "asset-browser",
-    "palette-browser",
-    "state-inspector",
-    "replay-visualizer",
-    "performance-profiler",
-    "physics-sandbox",
-    "asset-pipeline-tool",
-    "tile-model-converter",
-    "3d-json-payload-normalizer",
-    "3d-asset-viewer",
-    "3d-camera-path-editor",
-    "palette"
-  ],
+  "rawLoadedToolKeys": ["vector-map-editor", "vector-asset-studio", "tile-map-editor", "parallax-editor", "sprite-editor", "skin-editor", "asset-browser", "palette-browser", "state-inspector", "replay-visualizer", "performance-profiler", "physics-sandbox", "asset-pipeline-tool", "tile-model-converter", "3d-json-payload-normalizer", "3d-asset-viewer", "3d-camera-path-editor", "palette"],
   "normalizedKeys": [
     {
       "rawKey": "vector-map-editor",
@@ -203,43 +184,7 @@
       "reasons": []
     }
   ],
-  "validPresentKeys": [
-    "vector-map-editor",
-    "vector-asset-studio",
-    "tile-map-editor",
-    "parallax-editor",
-    "sprite-editor",
-    "skin-editor",
-    "asset-browser",
-    "palette-browser",
-    "state-inspector",
-    "replay-visualizer",
-    "performance-profiler",
-    "physics-sandbox",
-    "asset-pipeline-tool",
-    "tile-model-converter",
-    "3d-json-payload-normalizer",
-    "3d-asset-viewer",
-    "3d-camera-path-editor"
-  ],
+  "validPresentKeys": ["vector-map-editor", "vector-asset-studio", "tile-map-editor", "parallax-editor", "sprite-editor", "skin-editor", "asset-browser", "palette-browser", "state-inspector", "replay-visualizer", "performance-profiler", "physics-sandbox", "asset-pipeline-tool", "tile-model-converter", "3d-json-payload-normalizer", "3d-asset-viewer", "3d-camera-path-editor"],
   "invalidKeys": [],
-  "visibleWorkspaceManagerTools": [
-    "vector-map-editor",
-    "vector-asset-studio",
-    "tile-map-editor",
-    "parallax-editor",
-    "sprite-editor",
-    "skin-editor",
-    "asset-browser",
-    "palette-browser",
-    "state-inspector",
-    "replay-visualizer",
-    "performance-profiler",
-    "physics-sandbox",
-    "asset-pipeline-tool",
-    "tile-model-converter",
-    "3d-json-payload-normalizer",
-    "3d-asset-viewer",
-    "3d-camera-path-editor"
-  ]
-}
+  "visibleWorkspaceManagerTools": ["vector-map-editor", "vector-asset-studio", "tile-map-editor", "parallax-editor", "sprite-editor", "skin-editor", "asset-browser", "palette-browser", "state-inspector", "replay-visualizer", "performance-profiler", "physics-sandbox", "asset-pipeline-tool", "tile-model-converter", "3d-json-payload-normalizer", "3d-asset-viewer", "3d-camera-path-editor"]
+}

docs/dev/reports/PR_11_22_workspace_embedded_payload_asset_status_evidence.json

@@ -1,24 +1,6 @@
 {
   "sourcePath": "samples/phase-19/1902/sample.1902.workspace-all-tools.json",
-  "requiredPayloadDocumentMappingKeys": [
-    "vectorMapDocument",
-    "vectorAssetDocument",
-    "tileMapDocument",
-    "parallaxDocument",
-    "spriteProject",
-    "skin",
-    "assetCatalog",
-    "palette",
-    "snapshot",
-    "events",
-    "profileSettings",
-    "physicsBody",
-    "pipelinePayload",
-    "candidate",
-    "mapPayload",
-    "asset3d",
-    "cameraPath"
-  ],
+  "requiredPayloadDocumentMappingKeys": ["vectorMapDocument", "vectorAssetDocument", "tileMapDocument", "parallaxDocument", "spriteProject", "skin", "assetCatalog", "palette", "snapshot", "events", "profileSettings", "physicsBody", "pipelinePayload", "candidate", "mapPayload", "asset3d", "cameraPath"],
   "byRawManifestToolKey": [
     {
       "rawKey": "vector-map-editor",
@@ -339,4 +321,4 @@
     }
   ],
   "payloadBackedMissing": []
-}
+}

docs/dev/reports/PR_11_57_cleanup_actions.json

@@ -1,14 +1,5 @@
 {
-  "deletedFiles": [
-    "samples/phase-02/0205/sample.0205.state-inspector.json",
-    "samples/phase-02/0208/sample.0208.state-inspector.json",
-    "samples/phase-02/0217/sample.0217.state-inspector.json",
-    "samples/phase-07/0708/sample.0708.replay-visualizer.json",
-    "samples/phase-13/1315/sample.1315.replay-visualizer.json",
-    "samples/phase-13/1319/sample.1319.performance-profiler.json",
-    "samples/phase-14/1406/sample.1406.replay-visualizer.json",
-    "samples/phase-14/1407/sample.1407.performance-profiler.json"
-  ],
+  "deletedFiles": ["samples/phase-02/0205/sample.0205.state-inspector.json", "samples/phase-02/0208/sample.0208.state-inspector.json", "samples/phase-02/0217/sample.0217.state-inspector.json", "samples/phase-07/0708/sample.0708.replay-visualizer.json", "samples/phase-13/1315/sample.1315.replay-visualizer.json", "samples/phase-13/1319/sample.1319.performance-profiler.json", "samples/phase-14/1406/sample.1406.replay-visualizer.json", "samples/phase-14/1407/sample.1407.performance-profiler.json"],
   "deletedCount": 8,
   "removedMetadataReferences": [
     {

docs/dev/reports/PR_11_59_cleanup_actions.json

@@ -1,20 +1,7 @@
 {
   "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"
-  ],
+  "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",

docs/dev/reports/PR_11_59_safe_candidates.json

@@ -1,17 +1 @@
-[
-  "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"
-]
+["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_61_cleanup_actions.json

@@ -3,7 +3,5 @@
   "deletedFiles": [],
   "removedMetadataReferenceCount": 0,
   "removedMetadataReferences": [],
-  "skipReasons": [
-    "Only two non-protected NO candidates remain and each is coupled to a protected tile-map-editor-document.json entry; deleting would convert protected YES entries into NO and violate count-proof objective."
-  ]
+  "skipReasons": ["Only two non-protected NO candidates remain and each is coupled to a protected tile-map-editor-document.json entry; deleting would convert protected YES entries into NO and violate count-proof objective."]
 }