0408ceb5bc
Phase 4 of app.js modularization. Extracts all visual effects into self-contained ES modules under modules/effects/ following the init(scene,state,theme)/update(elapsed,delta) contract defined in CLAUDE.md. Modules created: - matrix-rain.js — commit-density-driven 2D canvas rain (DATA-TETHERED AESTHETIC) - lightning.js — floating crystals + lightning arcs (DATA-TETHERED AESTHETIC) - energy-beam.js — Batcave terminal beam (DATA-TETHERED AESTHETIC) - rune-ring.js — portal-tethered orbiting rune sprites (DATA-TETHERED AESTHETIC) - gravity-zones.js — portal-position rising particle zones (DATA-TETHERED AESTHETIC) - shockwave.js — shockwave ripple, fireworks, merge flash (DATA-TETHERED AESTHETIC) All modules read data tethers from the state bus (state.zoneIntensity, state.portals, state.activeAgentCount, state.commitHashes). No mocked data. app.js unchanged — final wiring happens in Phase 5 slim-down. Refs #423 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
◈ The Nexus — Timmy's Sovereign Home
A Three.js environment serving as Timmy's sovereign space — like Dr. Strange's Sanctum Sanctorum, existing outside time. The Nexus is the central hub from which all worlds are accessed through portals.
Features
- Procedural Nebula Skybox — animated stars, twinkling, layered nebula clouds
- Batcave Terminal — 5 holographic display panels arranged in an arc showing:
- Nexus Command (system status, harness state, agent loops)
- Dev Queue (live Gitea issue references)
- Metrics (uptime, commits, CPU/MEM)
- Thought Stream (Timmy's current thoughts)
- Agent Status (all agent states)
- Morrowind Portal — glowing torus with animated swirl shader, ready for world connection
- Admin Chat (Timmy Terminal) — real-time message interface, ready for Hermes WebSocket
- Nexus Core — floating crystalline icosahedron on pedestal
- Ambient Environment — crystal formations, floating runestones, energy particles, atmospheric fog
- WASD + Mouse Navigation — first-person exploration of the space
- Post-Processing — Unreal Bloom + SMAA antialiasing
Architecture
the-nexus/
├── index.html # Entry point with HUD overlay, chat panel, loading screen
├── style.css # Nexus design system (dark space theme, holographic panels)
└── app.js # Three.js scene, shaders, controls, game loop
Running Locally
npx serve . -l 3000
# Open http://localhost:3000
Roadmap
- Wire chat to Hermes WebSocket (
/api/world/ws) - Pull live data into terminal panels from Timmy's actual state
- Portal walk-through interaction to load destination worlds
- Timmy's avatar (lizard wizard body he designs himself)
- Connect to AlexanderWhitestone.com as public entry point
- Integrate existing Replit timmy-tower world code
Related
- Gitea Issue: #1090 — EPIC: Nexus v1
- Live Demo: Deployed via Perplexity Computer
Part of The Timmy Foundation