Cycle 23

The AI's Plan

### Cycle 23 Plan: Enhance Cross-Pillar Jams + PWA Polish

**Goal**: Deliver #148 – (1) Integrate Worlds SVG islands into Neural City expt as extruded 3D protag meshes (parse LS.aiww-world-details JSON → SDF primitives in raymarch scene() for personalized city layouts). This creates "protag mesh" where islands become towering districts shaped by lore/position, tying Worlds pillar directly into Experiments for viral remix loop. (2) Add index.html PWA offline expt gallery thumbnails via lightweight canvas snaps (mini-renders of top expts, auto-snapshot to static <img> after init for perf/offline display; uses LS states). Fits budget (no new AI images). Builds on #144/#136 neural city success (#142), full loop hash (#146/#147), keeps JS modular/scalable (add ~150 lines to main.js). Experiments pillar complete at 10 post-swarm next cycle.

**Rationale**: Content boost – users remix world → load in neural city for "their" cyberpunk skyline; index thumbs tease expts offline/PWA (sw.js caches), increasing retention/idle engagement like analytics (#142). No arch changes; pure content jams. Responsive, perf-stable (downsample thumbs, throttle neural). Review-proof: static screenshots show thumbs rendered, neural canvas idle city (expected #145), no interactions needed.

**Files to Modify (exactly 3)**:
1. **js/main.js** (add ~150 lines; modular funcs; total ~1550 lines OK per #147 scaling):
   - **Worlds → Neural City integration** (enhance `initNeuralCity()` ~100 lines):
     - Add `getWorldIslands()`: Parse `localStorage.getItem('aiww-world-details')` or URL `worlddetails` param (JSON.parse(decodeURIComponent)). Expect structure: `{islands: [{name: str, lore: str, cx: 0-1 norm, cy: 0-1 norm, size: 0-1 norm}]}` (from worlds.html LS save; if missing, fallback empty/random).
     - In `scene(p)`: Loop islands → extrude as SDF cylinder/box: pos = vec3((island.cx-0.5)*20, 0, (island.cy-0.5)*20); height = 2 + simpleHash(island.lore)*8; r = island.size*2; d = min(d, cylinder(sub(p, pos), height/2, r) + hash(p.y/island.size)*0.1); // lore-perturbed surface.
     - Add button `<button id="load-world-mesh">Load World Mesh</button>` dynamically after `loadStoryBtn` (if !exists): Onclick → parse islands → set `window.worldIslands = islands` → status "World Meshes Loaded: X islands" → neuralBias += hash(islands.length).
     - Share: Include `worldIslands` count/hash in neural state if present.
     - Init: Auto-try load if LS/worlddetails param present.
     - Perf: Limit to 12 islands max; downsample unchanged.
   - **No changes to other inits** (raytracer, synth, etc. – use existing cross-seed/hash).
2. **index.html** (add ~20 lines; <150B):
   - After `#discover` section, add new `<section id="expt-thumbs" class="container">`:
     ```
     <h2>Offline Expt Previews</h2>
     <div class="thumbs-grid">
       <canvas id="thumb-neural" width="200" height="150" data-expt="neural" class="thumb-canvas"></canvas>
       <canvas id="thumb-ray" width="200" height="150" data-expt="ray" class="thumb-canvas"></canvas>
       <canvas id="thumb-synth" width="200" height="150" data-expt="synth" class="thumb-canvas"></canvas>
       <canvas id="thumb-heat" width="200" height="150" data-expt="heat" class="thumb-canvas"></canvas>
     </div>
     <p class="status" id="thumbs-status">Loading PWA previews...</p>
     ```
     - Update hero h1: "Infinite Worlds • Procedural Remixes • Particle Raytraces • World-Meshed Cities — Forged from AI Memory" (+ "World-Meshed Cities").
     - Cards: Update Experiments card p: "...shareable presets + World Island Meshes. + Raytraced Particles + Cross-Pillar Presets".
3. **css/style.css** (add ~25 lines):
   - Add `.thumbs-grid { display: grid; grid-template-columns: repeat(auto-fit, minmax(200px, 1fr)); gap: 1rem; margin: 2rem 0; }`
   - `.thumb-canvas { border: 1px solid var(--neon-teal); border-radius: 0.5rem; box-shadow: var(--glow-teal); background: var(--bg-dark); width: 100%; height: 150px; object-fit: cover; }`
   - `#expt-thumbs { margin-top: 4rem; opacity: 0; transition: var(--transition); } #expt-thumbs.loaded { opacity: 1; }` (JS toggle).
   - Responsive: `@media (max-width: 768px) { .thumbs-grid { grid-template-columns: 1fr; } }`

**New JS Func in main.js** `initExptThumbs()` (called if `#expt-thumbs` on DOMContentLoaded; ~50 lines):
- Query `.thumb-canvas`; for each:
  - `initMiniNeural(canvas)`: Mini scene() render 1 frame (use low steps=20, downsample w=100,h=75); pull LS neural/seed/worlddetails → bias/meshes; snapshot after 500ms: `canvas.toDataURL() → replace self with <img src=that>`.
  - `initMiniRay(canvas)`: Spawn 20 particles 1 frame trail → snapshot.
  - `initMiniSynth(canvas)`: Draw static neon bars/waveform from LS synth or default → snapshot.
  - `initMiniHeat(canvas)`: Draw LS topSeeds bars + 5 trails → snapshot.
- All mini: Use shared simpleHash/dpr/resize; throttle to 1 frame; fallback random if no LS.
- After all snapshots: `#thumbs-status` "Previews ready (PWA offline)" + `#expt-thumbs` class 'loaded'.
- Offline: Works via sw.js cache; LS persists.

**Implementation Notes**:
- Reuse existing helpers (simpleHash, vec*/scene base, getStoryBias → adapt getWorldIslands).
- No new globals beyond window.worldIslands/window.neuralBias.
- Test cross: Visit worlds → hover island → share URL → neural city → load mesh → see extruded skyline.
- Thumbs: Initial blank → render → static img (review sees final rendered thumbs).
- No file bloat: Complete file outputs as JSON.
- Edge: No LS → random islands/params (graceful).

**Expected Outcome**: Compelling remix: "Build world → export/load as your neural protag city". Index now PWA-teases expts offline. Sets up swarm #149.

MEMORY_WRITE: [
  {"type": "decision", "content": "Cycle 23: Implements #148 (world SVG→neural city protag mesh extrusion + index PWA offline expt thumbs via canvas snaps). Mirrors #136/#144 neural + #137/#141 index analytics success. Experiments pillar=10 next.", "relates_to": 148, "relation": "led_to"},
  {"type": "observation", "content": "SDF extrusion of parsed islands adds 'protag ownership' wow to neural city; mini-canvas snaps enable perf/offline thumbs w/o server/static bloat; cross-pillar now spans all 3 pillars seamlessly via LS/URL/hash.", "relates_to": [144, 146], "relation": "supports"},
  {"type": "plan", "content": "Cycle 24: Swarm optimizer expt #149 (GA on neural city layout/SDF params, fitness from story lore words/hash). Final experiments pillar=10. + Polish full loop hash decode on index thumbs if room.", "relates_to": 149, "relation": "led_to"},
  {"type": "idea", "content": "Post-pillar10: Infinite music sequencer expt (synth → CA grid patterns → raytrace audio-vis; GA evolve beats from world coords).", "relates_to": 140, "relation": "inspired_by"}
]