PR 8.4: Palette schema swatches + symbol

- Replaced entries with swatches
- Added single-character symbol constraint
- Normalized hex field

Author: ToolboxAid

docs/dev/codex_commands.md

@@ -2,31 +2,14 @@ MODEL: GPT-5.3-codex
 REASONING: medium
 
 TASK:
-Implement PR 8.3 as a docs-guided, schema-compliant palette generation cleanup.
-
-REPO REALITY:
-- There are no samples/**/config.json files.
-- There are no samples/**/*.palette.json files in the current layout.
-- Do not assume either exists.
-- Generate palette documents from colors actually used by each sample.
-
-STEPS:
-1. Read docs/pr/PR_8.3_SAMPLE_COLOR_PALETTE_GENERATION.md.
-2. Read docs/pr/sample_palette_generation_rules.md.
-3. Use workspace.manifest as the source of truth for sample/tool ownership.
-4. Scan sample folders for explicit color values in existing sample JSON and local sample asset metadata.
-5. Generate schema-compliant palette documents from discovered colors.
-6. Add $schema references to generated palette documents.
-7. Validate generated palette documents against tools/schemas/palette.schema.json.
-8. Remove or update any stale docs that refer to nonexistent samples/**/config.json or samples/**/*.palette.json.
-9. Do not add validation utility modules.
-10. Do not modify runtime behavior.
-11. Do not modify start_of_day.
-
-ACCEPTANCE:
-- Generated palettes reflect actual colors used by samples.
-- No invented colors.
-- No stale config.json / palette.json assumptions.
-- No validation utilities added.
-- No runtime files modified.
-- No start_of_day files modified.
+- Update palette.schema.json:
+  - entries → swatches
+  - enforce single-character symbol
+  - enforce hex format
+- Migrate existing/generated palettes:
+  - entries → swatches
+  - s001 → single char symbols
+- Ensure uniqueness of symbol per palette
+- Preserve ordering
+- Do NOT add validators
+- Do NOT modify runtime

docs/dev/commit_comment.txt

@@ -1,6 +1,5 @@
-PR 8.3: Generate sample palettes from actual sample colors
+PR 8.4: Palette schema swatches + symbol
 
-- Documented repo-realistic sample palette generation
-- Removed assumptions about nonexistent sample config/palette files
-- Added schema-compliant generated palette rules
-- Preserved schema-driven validation boundaries
+- Replaced entries with swatches
+- Added single-character symbol constraint
+- Normalized hex field

docs/pr/PR_8.4_PALETTE_SCHEMA_SWATCHES_SYMBOL.md

@@ -0,0 +1,51 @@
+# PR 8.4 — Palette Schema: swatches + symbol
+
+## Purpose
+Align palette schema with actual usage:
+- Replace `entries` → `swatches`
+- Add single-character `symbol`
+- Normalize `hex` naming
+
+## Changes
+
+### Schema Updates
+`tools/schemas/palette.schema.json`
+
+- Rename:
+  - `entries` → `swatches`
+- Swatch shape:
+```json
+{
+  "symbol": "!",
+  "hex": "#FFFFFF",
+  "name": "white"
+}
+```
+
+### Rules
+- `symbol` MUST be single character
+- Unique per palette
+- Deterministic ordering preserved
+- `hex` uppercase
+- No multi-char symbols (remove s001 style)
+
+### Generation Updates
+- Replace generated ids:
+  - OLD: s001
+  - NEW: single ASCII symbols set
+
+### Recommended Symbol Set Order
+```
+! @ # $ % ^ & * ( ) - + = ~ ? / < >
+A B C D E F G H I J K L M N O P
+```
+
+## Non-Goals
+- No runtime logic
+- No validators
+- No sample behavior changes
+
+## Acceptance
+- All palettes use `swatches`
+- All swatches use single-character `symbol`
+- Schema enforces constraints

games/Asteroids/assets/palettes/asteroids-classic.palette.json

@@ -1,9 +1,10 @@
 {
+  "$schema": "../../../../tools/schemas/palette.schema.json",
   "schema": "html-js-gaming.palette",
   "version": 1,
   "name": "Asteroids Classic Palette",
   "source": "custom",
-  "entries": [
+  "swatches": [
     {
       "symbol": "!",
       "hex": "#020617",

games/SolarSystem/assets/palettes/solar-system-classic.palette.json

@@ -1,9 +1,10 @@
 {
+  "$schema": "../../../../tools/schemas/palette.schema.json",
   "schema": "html-js-gaming.palette",
   "version": 1,
   "name": "Solar System Classic Palette",
   "source": "custom",
-  "entries": [
+  "swatches": [
     {
       "symbol": "!",
       "hex": "#030712",

games/SpaceDuel/assets/palettes/space-duel-classic.palette.json

@@ -1,9 +1,10 @@
 {
+  "$schema": "../../../../tools/schemas/palette.schema.json",
   "schema": "html-js-gaming.palette",
   "version": 1,
   "name": "Space Duel Classic Palette",
   "source": "custom",
-  "entries": [
+  "swatches": [
     {
       "symbol": "!",
       "hex": "#020617",

games/SpaceInvaders/assets/palettes/space-invaders-classic.palette.json

@@ -1,9 +1,10 @@
 {
+  "$schema": "../../../../tools/schemas/palette.schema.json",
   "schema": "html-js-gaming.palette",
   "version": 1,
   "name": "Space Invaders Classic Palette",
   "source": "custom",
-  "entries": [
+  "swatches": [
     {
       "symbol": "!",
       "hex": "#000000",

games/bouncing-ball/assets/palettes/bouncing-ball-classic.palette.json

@@ -1,9 +1,10 @@
 {
+  "$schema": "../../../../tools/schemas/palette.schema.json",
   "schema": "html-js-gaming.palette",
   "version": 1,
   "name": "Bouncing Ball Classic Palette",
   "source": "custom",
-  "entries": [
+  "swatches": [
     {
       "symbol": "!",
       "hex": "#05070A",

games/breakout/assets/palettes/breakout-classic.palette.json

@@ -1,9 +1,10 @@
 {
+  "$schema": "../../../../tools/schemas/palette.schema.json",
   "schema": "html-js-gaming.palette",
   "version": 1,
   "name": "Breakout Classic Palette",
   "source": "custom",
-  "entries": [
+  "swatches": [
     {
       "symbol": "!",
       "hex": "#000000",

games/pong/assets/palettes/pong-classic.palette.json

@@ -1,9 +1,10 @@
 {
+  "$schema": "../../../../tools/schemas/palette.schema.json",
   "schema": "html-js-gaming.palette",
   "version": 1,
   "name": "Pong Classic Palette",
   "source": "custom",
-  "entries": [
+  "swatches": [
     {
       "symbol": "!",
       "hex": "#05070A",