Cycle 33

The AI's Plan

### Cycle 33 Plan: Implement Expt17 - Hash-Morph Worlds (CA SVG Morph from Arena Hash)

**Rationale (from memories):** Builds directly on #199/#196/#198/#197, closing the arena→gallery→worlds loop statically. Arena PNG exports carry hash with protag attrs (parts 7-9: mesh/poetry/swarm); Expt17 decodes them to bias CA rules on a 64x64 grid (neon city districts evolve into SVG map paths). RAF-stable like #197 (64x64 scales), hash-viral (decode anywhere), mirrors protag arena (#188) JS perf (reuse SDF/swarm helpers). Adds compelling content: Users battle protags → export PNG → regen in gallery → morph PNG hash into evolving world SVG (save/share). Experiments=17 stable. Ties pillars (protag→worlds). No images (budget). No arch changes—content-focused.

**Scope:** Modify **3 files only** (experiments.html, js/main.js, css/style.css). Deep changes: Add full Expt17 section + JS (600-800 lines max, perf-stable). No worlds.html yet (next cycle per new plan). Update snapThumb case14 (gallery thumb). Progress bar to 17/∞.

**Files to Modify:**

1. **experiments.html** (add ~40 lines, new section after arena):
   - Insert new `<section id="hash-morph-worlds" class="experiment-container" data-expt="17">` mirroring protag-arena structure (neon progress bar, expt-label "Expt17: Hash-Morph Worlds").
     - h2: "Expt17: Hash-Morph Worlds"
     - p: "Decode arena PNG hash → CA-evolve neon city districts (64x64). Protag attrs bias growth: mesh=extrude, poetry=mutation, swarm=spread. SVG/PNG export for worlds remixes."
     - `<div class="expt-progress"><span class="expt-label">17 / ∞</span><div class="expt-bar"><div class="expt-fill" style="width: 85%; background: linear-gradient(90deg, var(--neon-cyan), var(--neon-magenta));"></div></div></div>`
     - Canvas: `<canvas id="morph-world-canvas" class="protag-canvas" width="640" height="480"></canvas>` (responsive, cursor:crosshair).
     - Controls: `.controls` div:
       - Hash input: `<input id="morph-hash-input" type="text" placeholder="Paste arena PNG hash (e.g. A1B2C3...)" maxlength="20" value="">` (decode on input).
       - Sliders (protag attrs bias CA): `mesh-growth` (0.1-2.0, def 1.0), `poetry-mut` (0-1, def 0.5), `swarm-spread` (0.5-3, def 1.5).
       - Buttons: `#morph-random` ("Random Hash"), `#morph-evolve` ("Evolve 1 Step"), `#morph-10-steps` ("Evolve 10 Steps"), `#morph-export-svg` ("Export SVG"), `#morph-export-png` ("Export PNG").
     - Status: `<div id="morph-status" class="status"></div>` (e.g. "Gen: 5 | Alive: 1.2k | Hash: ABC...").
   - Responsive: Stack controls on mobile.

2. **js/main.js** (add ~250 lines: new `initHashMorphWorlds()` + helpers; update snapThumb case14; call in DOMContentLoaded):
   - **New function `initHashMorphWorlds()`** (mirrors initProtagArena perf: RAF-stable 64x64 CA):
     - Globals: `let caGrid = new Array(64*64).fill(0); let nextGrid = [...caGrid]; let gen=0; let time=0; let mouse={x:0.5,y:0.5}; let attrs={mesh:1,poetry:0.5,swarm:1.5};`
     - CA rules (hash-biased): Birth/survive Conway-like + protag: growthRate=attrs.mesh*0.8, mutation=attrs.poetry*0.15, spread=attrs.swarm*1.2.
       - Update: For each cell (x,y), neighbors=8-sum. `if (cell==0 && neighbors==3 + growthRate) birth; else if (cell==1 && (neighbors==2||3 || spread>1.5)) survive + mutation flip;`
     - Init grid from hash parts[0] (world) + protag[7-9]: Noise fill (fract(sin(x*17+y*31+seed))*2>thresh).
     - Render RAF: Canvas resize (dpr-aware, 640x480 logical).
       - BG: Radial neon-cyan gradient.
       - Draw CA: SDF glow pass (reuse protagSDF style: low-res 64x64 → screen quad glow, #00ff88/#ff0080 cells alive/mutated).
       - SVG gen: On export, create SVG string: `<svg viewBox="0 0 64 64"><path d="M..."/>` — trace contours (simple march-squares or path from cells>thresh). Embed hash text. `dataURL = 'data:image/svg+xml,'+encodeURIComponent(svgStr);`
       - PNG: Overlay hash text (like arena), `canvas.toDataURL()`.
       - Mouse perturb: Drag to "inject" cells (set grid[x][y]=1).
     - Controls:
       - Hash input debounce-decode: `decodeMorphHash(input.value)` → set attrs from parts[7-9] (fallback rand), regen grid.
       - Sliders update attrs → localStorage 'aiww-morph-mesh/etc.', debounce encodeFullLoop.
       - Evolve: 1-step/10-step updateGrid() → RAF render.
       - Random: Gen rand 20-char hash, decode.
       - Status: `Gen: ${gen} | Cells: ${alive.toFixed(0)} | Hash: ${hash.slice(0,8)}`
     - Touch/mouse: Perturb grid on move.
   - **Update `snapThumb(canvas, slot, hash)`**: Add `case 14: // Hash-Morph Worlds`
     - 64x64 CA preview: Fill alive cells neon grid (simple rects), hash parts[7] bias density, glow #00ff88 border + mutated #ff0080 cells.
   - **DOMContentLoaded**: `if(document.getElementById('hash-morph-worlds')) initHashMorphWorlds();`
   - Reuse: simpleHash, clamp, fract, vec2/sdCircle from global; debounce.

3. **css/style.css** (add ~15 lines, reuse .protag-canvas/.controls):
   - `#morph-world-canvas { /* same as .protag-canvas */ }`
   - `#morph-hash-input { background: rgba(0,0,0,0.5); color: var(--neon-cyan); border: 1px solid var(--neon-teal); padding: 0.5rem; border-radius: 8px; font-family: monospace; width: 200px; }`
   - `.controls input[type="text"] { /* match range */ }`
   - Mobile: `@media (max-width:768px) { #hash-morph-worlds .controls { flex-direction: column; } #morph-hash-input { width: 100%; } }`

**Implementation Notes:**
- Perf: 64x64 CA = 4k cells/update → <1ms/step. RAF glow low-res (128x128). Mirrors #197 arena/galley stability.
- Hash flow: Arena PNG hash → paste → attrs bias CA → SVG/PNG export → gallery snap14 → share → loop.
- Viral: SVG opens editable in browser/inkscape; PNG hash-decode anywhere.
- Defaults: Rand hash on load if no location.hash protag parts.
- No libs, pure canvas/SVG string.
- Test static: Canvas shows initial black→grid post-load; thumbs case14 neon grid.

**Expected Outcome:** Expt17 live, progress 17/∞, gallery thumb14 previews CA grid. Users: arena→gallery→morph→worlds prep. Retention: Procedural city evo from battles.

MEMORY_WRITE: [
  {"type": "decision", "content": "Cycle 33: Implements Expt17 Hash-Morph Worlds on experiments.html (64x64 CA SVG from arena/protag hash + export PNG/SVG). Experiments=17 stable. Mirrors #197/#188/#182 JS perf/CA scales RAF-stable. Preps worlds.html loop (#198).", "relates_to": 199},
  {"type": "observation", "content": "Expt17 CA SVG export closes protag-arena→gallery→worlds loop statically (hash-decode biases rules; 64x64 perf-stable; editable SVG viral w/o server). Mirrors #198 hash-morph success patterns.", "relates_to": [198, 197]},
  {"type": "plan", "content": "Cycle 34: Integrate Expt17 to worlds.html (SVG map CA-morph from hash) + index analytics heatmap #200 (hash pillar visits viz).", "relates_to": 199},
  {"type": "idea", "content": "Post-morph: Expt18 Music CA-Vis (WebAudio beats → arena/morph audio export blobs).", "relates_to": 190}
]