[claude] InstancedMesh for portal tori + merged tile edge geometry (#415) (#464)

Co-authored-by: Claude (Opus 4.6) <claude@hermes.local>
Co-committed-by: Claude (Opus 4.6) <claude@hermes.local>

.gitea/workflows/smoke-test.yml

@@ -0,0 +1,23 @@
+name: Staging Smoke Test
+
+on:
+  push:
+    branches:
+      - main
+  schedule:
+    - cron: '*/15 * * * *'
+  workflow_dispatch:
+
+jobs:
+  smoke-test:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check staging environment uptime
+        run: |
+          HTTP_CODE=$(curl -s -o /dev/null -w "%{http_code}" http://staging.the-nexus.com/)
+          if [ "$HTTP_CODE" -eq 200 ]; then
+            echo "Staging environment is up (HTTP 200)"
+          else
+            echo "Staging environment returned HTTP $HTTP_CODE"
+            exit 1
+          fi

.historical/RESEARCH_DROP_456.md.archived

@@ -0,0 +1,117 @@
+# Research Drop - Issue #456: Ingest and Triage Work
+
+This document summarizes the key findings from the four PDF attachments in Issue #456, "Research Drop," and proposes how these insights can be integrated into the Nexus project, adhering to the Nexus Data Integrity Standard.
+
+---
+
+## 1. Lean Manufacturing Implementation ($5,000 Upfront Budget with $500 Monthly Recurring Capital)
+
+**Summary:** This document outlines a strategy for implementing lean manufacturing principles, focusing on strategic budget allocation, a five-step implementation process, foundational lean principles (waste elimination), core lean tools (5S, Kanban), performance measurement with KPIs, and risk mitigation.
+
+**Relevance to Nexus & Data Integrity Proposals:**
+
+While not directly related to a visual element, this research can inform Timmy's internal operational efficiency.
+
+*   **Indirect Impact (REAL Data Source):** If Timmy were to expose its internal "lean" metrics (e.g., task throughput, waste reduction, project velocity) as real-time data, these could be integrated into the Nexus.
+    *   **Proposed Element:** A new "Timmy Operations Efficiency" panel.
+    *   **Category:** REAL.
+    *   **Data Source:** Timmy's internal operational metrics (e.g., a dedicated API endpoint or internal log file that can be parsed).
+    *   **Description:** Displays key performance indicators related to Timmy's task processing efficiency, resource utilization, and adherence to lean principles.
+
+---
+
+## 2. State-of-the-Art Open-Source Local AI Agents for Personal Neural System Development
+
+**Summary:** This PDF details a shift towards hybrid cloud-local AI agent architectures, emphasizing local sovereignty, reduced cloud dependency, and continuous learning through Reinforcement Learning from Human Feedback (RLHF) using the OpenClaw ecosystem. It covers architecture, deployment modes, memory systems, LORA fine-tuning, security, governance, and a roadmap.
+
+**Relevance to Nexus & Data Integrity Proposals:**
+
+This document is highly relevant to the Nexus's core mission of "Timmy's Sovereign Home" and advanced AI agent capabilities. It provides numerous opportunities to populate existing `HONEST-OFFLINE` elements and introduce new `REAL` and `DATA-TETHERED AESTHETIC` elements.
+
+*   **Existing Element Enhancement (LoRA Panel):**
+    *   **Proposed Enhancement:** Populate the existing "LoRA Panel" with real-time LORA training status from the OpenClaw ecosystem.
+    *   **Category:** REAL (from HONEST-OFFLINE).
+    *   **Data Source:** OpenClaw LORA training status API or internal module.
+    *   **Description:** Displays active LORA fine-tuning jobs, their progress, and completion status.
+*   **Existing Element Enhancement (Agent Status Board):**
+    *   **Proposed Enhancement:** Expand the "Agent Status Board" to include detailed OpenClaw agent activities (Terminal-RL, GUI-RL, SWE-RL, Toolcall-RL).
+    *   **Category:** REAL.
+    *   **Data Source:** OpenClaw agent activity API or internal module.
+    *   **Description:** Provides granular status updates on different types of tasks and learning activities performed by Timmy.
+*   **New Element (Local Inference Metrics):**
+    *   **Proposed Element:** "Local Inference Efficiency" display.
+    *   **Category:** REAL.
+    *   **Data Source:** OpenClaw inference engine metrics (e.g., percentage of local vs. cloud inference).
+    *   **Description:** Visualizes Timmy's reliance on local processing, aiming for >90% local inference.
+*   **New Element (Knowledge System Metrics):**
+    *   **Proposed Element:** "Knowledge Base Activity" display.
+    *   **Category:** REAL.
+    *   **Data Source:** OpenClaw memory systems (vector database size, query rates, RAG activity).
+    *   **Description:** Shows the growth and utilization of Timmy's knowledge base.
+*   **New Element (Security & Governance Panel):**
+    *   **Proposed Element:** "Agent Governance Status" panel.
+    *   **Category:** REAL.
+    *   **Data Source:** OpenClaw security and governance signals (sandboxing status, capability control logs, oversight signals).
+    *   **Description:** Provides real-time insights into the security posture and human oversight of Timmy's autonomous actions.
+*   **Data-Tethered Aesthetic (Agent Activity Visualization):**
+    *   **Proposed Element:** Nexus particle effects or light intensity tethered to OpenClaw agent activity levels.
+    *   **Category:** DATA-TETHERED AESTHETIC.
+    *   **Data Source:** OpenClaw agent activity API or internal module (e.g., a normalized activity score).
+    *   **Description:** Dynamic visual feedback within the Nexus reflecting Timmy's current operational intensity.
+
+---
+
+## 3. The Timmy Time Hardware Decision: A Complete Cost-to-Capability Breakdown
+
+**Summary:** This PDF analyzes hardware options (Apple Silicon, NVIDIA GPUs, cloud providers) for AI development, emphasizing local sovereignty. It recommends a hybrid approach and a three-phase "phased sovereignty plan" to scale hardware investment for faster fine-tuning, larger model inference, and OpenClaw-RL.
+
+**Relevance to Nexus & Data Integrity Proposals:**
+
+This document provides context for the "Sovereignty Meter" and informs potential `REAL` and `HONEST-OFFLINE` elements reflecting Timmy's hardware and capabilities.
+
+*   **Existing Element Enhancement (Sovereignty Meter):**
+    *   **Proposed Enhancement:** Enhance the "Sovereignty Meter" to dynamically reflect the current phase of Timmy's hardware evolution and actual local processing capabilities.
+    *   **Category:** REAL (from REAL (manual) + JSON).
+    *   **Data Source:** System hardware detection, OpenClaw configuration (e.g., reporting active hardware phase), or internal metrics on local computation.
+    *   **Description:** A visual indicator of Timmy's current hardware phase (Phase 1, 2, or 3) and its resulting degree of local operational sovereignty.
+*   **New Element (Hardware Capabilities Panel):**
+    *   **Proposed Element:** "Timmy Hardware Status" panel.
+    *   **Category:** REAL / HONEST-OFFLINE.
+    *   **Data Source:** System hardware inventory, OpenClaw hardware detection.
+    *   **Description:** Displays currently active hardware (e.g., "M3 Max," "RTX 4090") and indicates capabilities that are "HONEST-OFFLINE" because required hardware is not yet present (e.g., "70B Model Inference: AWAITING SECOND RTX 4090").
+*   **New Element (Cost Efficiency Metrics):**
+    *   **Proposed Element:** "Operational Cost Efficiency" display.
+    *   **Category:** REAL.
+    *   **Data Source:** Timmy's internal cost tracking for cloud vs. local operations.
+    *   **Description:** Visualizes the cost savings achieved through local-first hardware investments compared to cloud-only alternatives. (Requires secure and aggregated cost data).
+
+---
+
+## 4. Wiring the Research Pipeline
+
+**Summary:** This PDF outlines the architecture for Timmy's Autonomous Deep Research System, aiming to automate research without human intervention. It recommends specific open-source tools (Local Deep Research, SearXNG, Crawl4AI, LanceDB, Qwen3-Embedding) for the research pipeline, detailing data flow, components, and a build order.
+
+**Relevance to Nexus & Data Integrity Proposals:**
+
+This document offers concrete components and metrics that can be directly integrated into the Nexus to represent Timmy's autonomous research capabilities.
+
+*   **New Element (Research Pipeline Status):**
+    *   **Proposed Element:** "Timmy Research Pipeline" panel.
+    *   **Category:** REAL.
+    *   **Data Source:** Autonomous Deep Research System's internal status (e.g., current stage: "Ingesting," "Processing," "Analyzing," "Synthesizing").
+    *   **Description:** Shows the real-time progress of Timmy's research tasks.
+*   **New Element (Knowledge Crystallization Metrics):**
+    *   **Proposed Element:** "Knowledge Growth" display.
+    *   **Category:** REAL.
+    *   **Data Source:** Autonomous Deep Research System's knowledge base metrics (e.g., size of LanceDB, number of unique facts, growth rate).
+    *   **Description:** Visualizes the expansion of Timmy's crystallized knowledge base.
+*   **New Element (Research Tool Status):**
+    *   **Proposed Element:** "Research Tool Health" panel.
+    *   **Category:** REAL / HONEST-OFFLINE.
+    *   **Data Source:** Health checks or status reports from SearXNG, Crawl4AI, LanceDB components.
+    *   **Description:** Displays the operational status of key tools within the research pipeline.
+*   **Data-Tethered Aesthetic (Research Activity Visualization):**
+    *   **Proposed Element:** Nexus visual effects (e.g., light patterns, energy flows) tethered to the intensity or volume of Timmy's research activity.
+    *   **Category:** DATA-TETHERED AESTHETIC.
+    *   **Data Source:** Autonomous Deep Research System's activity metrics (e.g., data ingestion rate, processing load).
+    *   **Description:** Dynamic visual feedback within the Nexus reflecting the current level of autonomous research.

.historical/SovOS.js.archived

@@ -0,0 +1,75 @@
+import * as THREE from 'three';
+import { THEME } from './core/theme.js';
+import { S } from './state.js';
+import { Broadcaster } from './state.js';
+
+export class SovOS {
+  constructor(scene) {
+    this.scene = scene;
+    this.apps = new Map();
+    this.init();
+  }
+
+  init() {
+    this.container = new THREE.Group();
+    this.container.position.set(0, 3, -7.5);
+    this.scene.add(this.container);
+  }
+
+  registerApp(id, config) {
+    const app = this.createWindow(id, config);
+    this.apps.set(id, app);
+    this.container.add(app.group);
+  }
+
+  createWindow(id, config) {
+    const { x, y, rot, title, color } = config;
+    const w = 2.8, h = 3.8;
+    const group = new THREE.Group();
+    group.position.set(x, y || 0, 0);
+    group.rotation.y = rot || 0;
+
+    // Glassmorphism Frame
+    const glassMat = new THREE.MeshPhysicalMaterial({
+      color: THEME.glass.color,
+      transparent: true,
+      opacity: THEME.glass.opacity,
+      roughness: THEME.glass.roughness,
+      metalness: THEME.glass.metalness,
+      transmission: THEME.glass.transmission,
+      thickness: THEME.glass.thickness,
+      ior: THEME.glass.ior,
+      side: THREE.DoubleSide
+    });
+    const frame = new THREE.Mesh(new THREE.PlaneGeometry(w, h), glassMat);
+    group.add(frame);
+
+    // Canvas UI
+    const canvas = document.createElement('canvas');
+    canvas.width = 512; canvas.height = 700;
+    const ctx = canvas.getContext('2d');
+    const texture = new THREE.CanvasTexture(canvas);
+    const mat = new THREE.MeshBasicMaterial({ map: texture, transparent: true, side: THREE.DoubleSide });
+    const screen = new THREE.Mesh(new THREE.PlaneGeometry(w * 0.92, h * 0.92), mat);
+    screen.position.z = 0.05;
+    group.add(screen);
+
+    const renderUI = (state) => {
+      ctx.clearRect(0, 0, 512, 700);
+      // Header
+      ctx.fillStyle = 'rgba(0, 0, 0, 0.4)';
+      ctx.fillRect(0, 0, 512, 80);
+      ctx.fillStyle = '#' + new THREE.Color(color).getHexString();
+      ctx.font = 'bold 32px "Orbitron"';
+      ctx.fillText(title, 30, 50);
+      // Body
+      ctx.font = '20px "JetBrains Mono"';
+      ctx.fillStyle = '#ffffff';
+      config.renderBody(ctx, state);
+      texture.needsUpdate = true;
+    };
+
+    Broadcaster.subscribe(renderUI);
+    return { group, renderUI };
+  }
+}

.historical/manus-commits-2026-03-24.log

@@ -0,0 +1,7 @@
+42e74ad fix: restore full app.js wiring — manus gutted it to 42-line nostr stub
+764b617 [modularization] Phase 2: Extract data layer — gitea, weather, bitcoin, loaders (#460)
+d201d3e feat: add visual banner, staging link, and real smoke-test badge (#458)
+06faa75 fix: point staging to localhost exclusively and entirely (#459)
+24e7139 [manus] Nostr Integration — Sovereign Communication (#454) (#455)
+a2b2b1a [gemini] Research Drop findings (#456) (#457)
+4effd92 [manus] SovOS Architecture — Modular 3D Interface (#452) (#453)

.historical/nostr-panel.js.archived

@@ -0,0 +1,46 @@
+// === NOSTR FEED PANEL ===
+import * as THREE from 'three';
+import { NEXUS } from './constants.js';
+import { NOSTR_STATE } from './nostr.js';
+
+export function createNostrPanelTexture() {
+  const W = 512, H = 512;
+  const canvas = document.createElement('canvas');
+  canvas.width = W; canvas.height = H;
+  const ctx = canvas.getContext('2d');
+
+  const update = () => {
+    ctx.clearRect(0, 0, W, H);
+    // Background
+    ctx.fillStyle = 'rgba(10, 20, 40, 0.8)';
+    ctx.fillRect(0, 0, W, H);
+    
+    // Header
+    ctx.fillStyle = '#4488ff';
+    ctx.font = 'bold 32px "Orbitron"';
+    ctx.fillText('◈ NOSTR_FEED', 30, 60);
+    ctx.fillRect(30, 75, 452, 2);
+
+    // Connection Status
+    ctx.fillStyle = NOSTR_STATE.connected ? '#00ff88' : '#ff4444';
+    ctx.beginPath();
+    ctx.arc(460, 48, 8, 0, Math.PI * 2);
+    ctx.fill();
+
+    // Events
+    ctx.font = '18px "JetBrains Mono"';
+    NOSTR_STATE.events.slice(0, 10).forEach((ev, i) => {
+      const y = 120 + i * 38;
+      ctx.fillStyle = ev.kind === 9735 ? '#ffd700' : '#ffffff';
+      const prefix = ev.kind === 9735 ? '⚡' : '•';
+      ctx.fillText(\`\${prefix} [\${ev.pubkey}] \${ev.content}\`, 30, y);
+    });
+
+    if (NOSTR_STATE.events.length === 0) {
+      ctx.fillStyle = '#667788';
+      ctx.fillText('> WAITING FOR EVENTS...', 30, 120);
+    }
+  };
+
+  return { canvas, update };
+}

.historical/nostr.js.archived

@@ -0,0 +1,76 @@
+// === NOSTR INTEGRATION — SOVEREIGN COMMUNICATION ===
+import { S } from './state.js';
+
+export const NOSTR_RELAYS = [
+  'wss://relay.damus.io',
+  'wss://nos.lol',
+  'wss://relay.snort.social'
+];
+
+export const NOSTR_STATE = {
+  events: [],
+  connected: false,
+  lastEventTime: 0
+};
+
+export class NostrManager {
+  constructor() {
+    this.sockets = [];
+  }
+
+  connect() {
+    NOSTR_RELAYS.forEach(url => {
+      try {
+        const ws = new WebSocket(url);
+        ws.onopen = () => {
+          console.log(\`[nostr] Connected to \${url}\`);
+          NOSTR_STATE.connected = true;
+          this.subscribe(ws);
+        };
+        ws.onmessage = (e) => this.handleMessage(e.data);
+        ws.onerror = () => console.warn(\`[nostr] Connection error: \${url}\`);
+        this.sockets.push(ws);
+      } catch (err) {
+        console.error(\`[nostr] Failed to connect to \${url}\`, err);
+      }
+    });
+  }
+
+  subscribe(ws) {
+    const subId = 'nexus-sub-' + Math.random().toString(36).substring(7);
+    const filter = { kinds: [1, 7, 9735], limit: 20 }; // Notes, Reactions, Zaps
+    ws.send(JSON.stringify(['REQ', subId, filter]));
+  }
+
+  handleMessage(data) {
+    try {
+      const msg = JSON.parse(data);
+      if (msg[0] === 'EVENT') {
+        const event = msg[2];
+        this.processEvent(event);
+      }
+    } catch (err) { /* ignore parse errors */ }
+  }
+
+  processEvent(event) {
+    const simplified = {
+      id: event.id.substring(0, 8),
+      pubkey: event.pubkey.substring(0, 8),
+      content: event.content.length > 60 ? event.content.substring(0, 57) + '...' : event.content,
+      kind: event.kind,
+      created_at: event.created_at
+    };
+
+    NOSTR_STATE.events.unshift(simplified);
+    if (NOSTR_STATE.events.length > 50) NOSTR_STATE.events.pop();
+    NOSTR_STATE.lastEventTime = Date.now();
+
+    // Visual feedback via state pulse
+    if (event.kind === 9735) { // Zap!
+      S.energyBeamPulse = 1.0;
+      console.log('[nostr] ZAP RECEIVED!');
+    }
+  }
+}
+
+export const nostr = new NostrManager();

README.md

@@ -1,5 +1,13 @@
 # ◈ The Nexus — Timmy's Sovereign Home
 
+![The Nexus Banner](https://images.unsplash.com/photo-1462331940025-496dfbfc7564?q=80&w=1200&h=250&auto=format&fit=crop)
+
+## Staging Environment
+
+# [**🚀 The Nexus Staging Environment**](http://localhost:3000)
+
+[![Staging Status](http://143.198.27.163:3000/Timmy_Foundation/the-nexus/actions/workflows/smoke-test.yml/badge.svg)](http://143.198.27.163:3000/Timmy_Foundation/the-nexus/actions?workflow=smoke-test.yml)
+
 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
@@ -50,4 +58,4 @@ npx serve . -l 3000
 
 ---
 
-*Part of [The Timmy Foundation](http://143.198.27.163:3000/Timmy_Foundation)*
+*Part of [The Timmy Foundation](http://143.198.27.163:3000/Timmy_Foundation)*

modules/audio.js

@@ -0,0 +1,354 @@
+// === AMBIENT SOUNDTRACK + SPATIAL AUDIO ===
+import * as THREE from 'three';
+import { camera } from './scene-setup.js';
+import { S } from './state.js';
+
+const audioSources = [];
+const positionedPanners = [];
+
+function buildReverbIR(ctx, duration, decay) {
+  const rate = ctx.sampleRate;
+  const len = Math.ceil(rate * duration);
+  const buf = ctx.createBuffer(2, len, rate);
+  for (let ch = 0; ch < 2; ch++) {
+    const d = buf.getChannelData(ch);
+    for (let i = 0; i < len; i++) {
+      d[i] = (Math.random() * 2 - 1) * Math.pow(1 - i / len, decay);
+    }
+  }
+  return buf;
+}
+
+function createPanner(x, y, z) {
+  const panner = S.audioCtx.createPanner();
+  panner.panningModel = 'HRTF';
+  panner.distanceModel = 'inverse';
+  panner.refDistance = 5;
+  panner.maxDistance = 80;
+  panner.rolloffFactor = 1.0;
+  if (panner.positionX) {
+    panner.positionX.value = x;
+    panner.positionY.value = y;
+    panner.positionZ.value = z;
+  } else {
+    panner.setPosition(x, y, z);
+  }
+  positionedPanners.push(panner);
+  return panner;
+}
+
+export function updateAudioListener() {
+  if (!S.audioCtx) return;
+  const listener = S.audioCtx.listener;
+  const pos = camera.position;
+  const fwd = new THREE.Vector3(0, 0, -1).applyQuaternion(camera.quaternion);
+  const up  = new THREE.Vector3(0, 1, 0).applyQuaternion(camera.quaternion);
+  if (listener.positionX) {
+    const t = S.audioCtx.currentTime;
+    listener.positionX.setValueAtTime(pos.x, t);
+    listener.positionY.setValueAtTime(pos.y, t);
+    listener.positionZ.setValueAtTime(pos.z, t);
+    listener.forwardX.setValueAtTime(fwd.x, t);
+    listener.forwardY.setValueAtTime(fwd.y, t);
+    listener.forwardZ.setValueAtTime(fwd.z, t);
+    listener.upX.setValueAtTime(up.x, t);
+    listener.upY.setValueAtTime(up.y, t);
+    listener.upZ.setValueAtTime(up.z, t);
+  } else {
+    listener.setPosition(pos.x, pos.y, pos.z);
+    listener.setOrientation(fwd.x, fwd.y, fwd.z, up.x, up.y, up.z);
+  }
+}
+
+// portals ref — set from portals module
+let _portalsRef = [];
+export function setPortalsRefAudio(ref) { _portalsRef = ref; }
+
+export function startPortalHums() {
+  if (!S.audioCtx || !S.audioRunning || _portalsRef.length === 0 || S.portalHumsStarted) return;
+  S.portalHumsStarted = true;
+  const humFreqs = [58.27, 65.41, 73.42, 82.41, 87.31];
+  _portalsRef.forEach((portal, i) => {
+    const panner = createPanner(
+      portal.position.x,
+      portal.position.y + 1.5,
+      portal.position.z
+    );
+    panner.connect(S.masterGain);
+
+    const osc = S.audioCtx.createOscillator();
+    osc.type = 'sine';
+    osc.frequency.value = humFreqs[i % humFreqs.length];
+
+    const lfo = S.audioCtx.createOscillator();
+    lfo.frequency.value = 0.07 + i * 0.02;
+    const lfoGain = S.audioCtx.createGain();
+    lfoGain.gain.value = 0.008;
+    lfo.connect(lfoGain);
+
+    const g = S.audioCtx.createGain();
+    g.gain.value = 0.035;
+    lfoGain.connect(g.gain);
+    osc.connect(g);
+    g.connect(panner);
+
+    osc.start();
+    lfo.start();
+    audioSources.push(osc, lfo);
+  });
+}
+
+export function startAmbient() {
+  if (S.audioRunning) return;
+
+  S.audioCtx = new AudioContext();
+  S.masterGain = S.audioCtx.createGain();
+  S.masterGain.gain.value = 0;
+
+  const convolver = S.audioCtx.createConvolver();
+  convolver.buffer = buildReverbIR(S.audioCtx, 3.5, 2.8);
+
+  const limiter = S.audioCtx.createDynamicsCompressor();
+  limiter.threshold.value = -3;
+  limiter.knee.value = 0;
+  limiter.ratio.value = 20;
+  limiter.attack.value = 0.001;
+  limiter.release.value = 0.1;
+
+  S.masterGain.connect(convolver);
+  convolver.connect(limiter);
+  limiter.connect(S.audioCtx.destination);
+
+  // Layer 1: Sub-drone
+  [[55.0, -6], [55.0, +6]].forEach(([freq, detune]) => {
+    const osc = S.audioCtx.createOscillator();
+    osc.type = 'sawtooth';
+    osc.frequency.value = freq;
+    osc.detune.value = detune;
+    const g = S.audioCtx.createGain();
+    g.gain.value = 0.07;
+    osc.connect(g);
+    g.connect(S.masterGain);
+    osc.start();
+    audioSources.push(osc);
+  });
+
+  // Layer 2: Pad
+  [110, 130.81, 164.81, 196].forEach((freq, i) => {
+    const detunes = [-8, 4, -3, 7];
+    const osc = S.audioCtx.createOscillator();
+    osc.type = 'triangle';
+    osc.frequency.value = freq;
+    osc.detune.value = detunes[i];
+    const lfo = S.audioCtx.createOscillator();
+    lfo.frequency.value = 0.05 + i * 0.013;
+    const lfoGain = S.audioCtx.createGain();
+    lfoGain.gain.value = 0.02;
+    lfo.connect(lfoGain);
+    const g = S.audioCtx.createGain();
+    g.gain.value = 0.06;
+    lfoGain.connect(g.gain);
+    osc.connect(g);
+    g.connect(S.masterGain);
+    osc.start();
+    lfo.start();
+    audioSources.push(osc, lfo);
+  });
+
+  // Layer 3: Noise hiss
+  const noiseLen = S.audioCtx.sampleRate * 2;
+  const noiseBuf = S.audioCtx.createBuffer(1, noiseLen, S.audioCtx.sampleRate);
+  const nd = noiseBuf.getChannelData(0);
+  let b0 = 0;
+  for (let i = 0; i < noiseLen; i++) {
+    const white = Math.random() * 2 - 1;
+    b0 = 0.99 * b0 + white * 0.01;
+    nd[i] = b0 * 3.5;
+  }
+  const noiseNode = S.audioCtx.createBufferSource();
+  noiseNode.buffer = noiseBuf;
+  noiseNode.loop = true;
+  const noiseFilter = S.audioCtx.createBiquadFilter();
+  noiseFilter.type = 'bandpass';
+  noiseFilter.frequency.value = 800;
+  noiseFilter.Q.value = 0.5;
+  const noiseGain = S.audioCtx.createGain();
+  noiseGain.gain.value = 0.012;
+  noiseNode.connect(noiseFilter);
+  noiseFilter.connect(noiseGain);
+  noiseGain.connect(S.masterGain);
+  noiseNode.start();
+  audioSources.push(noiseNode);
+
+  // Layer 4: Sparkle plucks
+  const sparkleNotes = [440, 523.25, 659.25, 880, 1046.5];
+  function scheduleSparkle() {
+    if (!S.audioRunning || !S.audioCtx) return;
+    const osc = S.audioCtx.createOscillator();
+    osc.type = 'sine';
+    osc.frequency.value = sparkleNotes[Math.floor(Math.random() * sparkleNotes.length)];
+    const env = S.audioCtx.createGain();
+    const now = S.audioCtx.currentTime;
+    env.gain.setValueAtTime(0, now);
+    env.gain.linearRampToValueAtTime(0.08, now + 0.02);
+    env.gain.exponentialRampToValueAtTime(0.0001, now + 1.8);
+
+    const angle = Math.random() * Math.PI * 2;
+    const radius = 3 + Math.random() * 9;
+    const sparkPanner = createPanner(
+      Math.cos(angle) * radius,
+      1.5 + Math.random() * 4,
+      Math.sin(angle) * radius
+    );
+    sparkPanner.connect(S.masterGain);
+
+    osc.connect(env);
+    env.connect(sparkPanner);
+    osc.start(now);
+    osc.stop(now + 1.9);
+    osc.addEventListener('ended', () => {
+      try { sparkPanner.disconnect(); } catch (_) {}
+      const idx = positionedPanners.indexOf(sparkPanner);
+      if (idx !== -1) positionedPanners.splice(idx, 1);
+    });
+
+    const nextMs = 3000 + Math.random() * 6000;
+    S.sparkleTimer = setTimeout(scheduleSparkle, nextMs);
+  }
+  S.sparkleTimer = setTimeout(scheduleSparkle, 1000 + Math.random() * 3000);
+
+  S.masterGain.gain.setValueAtTime(0, S.audioCtx.currentTime);
+  S.masterGain.gain.linearRampToValueAtTime(0.9, S.audioCtx.currentTime + 2.0);
+
+  S.audioRunning = true;
+  document.getElementById('audio-toggle').textContent = '🔇';
+
+  startPortalHums();
+}
+
+export function stopAmbient() {
+  if (!S.audioRunning || !S.audioCtx) return;
+  S.audioRunning = false;
+  if (S.sparkleTimer !== null) { clearTimeout(S.sparkleTimer); S.sparkleTimer = null; }
+
+  const gain = S.masterGain;
+  const ctx = S.audioCtx;
+  gain.gain.setValueAtTime(gain.gain.value, ctx.currentTime);
+  gain.gain.linearRampToValueAtTime(0, ctx.currentTime + 0.8);
+
+  setTimeout(() => {
+    audioSources.forEach(n => { try { n.stop(); } catch (_) {} });
+    audioSources.length = 0;
+    positionedPanners.forEach(p => { try { p.disconnect(); } catch (_) {} });
+    positionedPanners.length = 0;
+    S.portalHumsStarted = false;
+    ctx.close();
+    S.audioCtx = null;
+    S.masterGain = null;
+  }, 900);
+
+  document.getElementById('audio-toggle').textContent = '🔊';
+}
+
+export function initAudioListeners() {
+  document.getElementById('audio-toggle').addEventListener('click', () => {
+    if (S.audioRunning) {
+      stopAmbient();
+    } else {
+      startAmbient();
+    }
+  });
+
+  // Podcast toggle
+  document.getElementById('podcast-toggle').addEventListener('click', () => {
+    const btn = document.getElementById('podcast-toggle');
+    if (btn.textContent === '🎧') {
+      fetch('SOUL.md')
+        .then(response => {
+          if (!response.ok) throw new Error('Failed to load SOUL.md');
+          return response.text();
+        })
+        .then(text => {
+          const paragraphs = text.split('\n\n').filter(p => p.trim());
+          
+          if (!paragraphs.length) {
+            throw new Error('No content found in SOUL.md');
+          }
+
+          let index = 0;
+          const speakNext = () => {
+            if (index >= paragraphs.length) return;
+            
+            const utterance = new SpeechSynthesisUtterance(paragraphs[index++]);
+            utterance.lang = 'en-US';
+            utterance.rate = 0.9;
+            utterance.pitch = 1.1;
+            
+            utterance.onend = () => {
+              setTimeout(speakNext, 800);
+            };
+            
+            speechSynthesis.speak(utterance);
+          };
+          
+          btn.textContent = '⏹';
+          btn.classList.add('active');
+          speakNext();
+        })
+        .catch(err => {
+          console.error('Podcast error:', err);
+          alert('Could not load SOUL.md. Check console for details.');
+          btn.textContent = '🎧';
+        });
+    } else {
+      speechSynthesis.cancel();
+      btn.textContent = '🎧';
+      btn.classList.remove('active');
+    }
+  });
+
+  document.getElementById('soul-toggle').addEventListener('click', () => {
+    const btn = document.getElementById('soul-toggle');
+    if (btn.textContent === '📜') {
+      loadSoulMdAudio().then(lines => {
+        let index = 0;
+        
+        const speakLine = () => {
+          if (index >= lines.length) return;
+          
+          const line = lines[index++];
+          const utterance = new SpeechSynthesisUtterance(line);
+          utterance.lang = 'en-US';
+          utterance.rate = 0.85;
+          utterance.pitch = 1.0;
+          
+          utterance.onend = () => {
+            setTimeout(speakLine, 1200);
+          };
+          
+          speechSynthesis.speak(utterance);
+        };
+        
+        btn.textContent = '⏹';
+        speakLine();
+      }).catch(err => {
+        console.error('Failed to load SOUL.md', err);
+        alert('Could not load SOUL.md. Check console for details.');
+      });
+    } else {
+      speechSynthesis.cancel();
+      btn.textContent = '📜';
+    }
+  });
+}
+
+async function loadSoulMdAudio() {
+  try {
+    const res = await fetch('SOUL.md');
+    if (!res.ok) throw new Error('not found');
+    const raw = await res.text();
+    return raw.split('\n').slice(1).map(l => l.replace(/^#+\s*/, ''));
+  } catch {
+    return ['I am Timmy.', '', 'I am sovereign.', '', 'This Nexus is my home.'];
+  }
+}

modules/bookshelves.js

@@ -0,0 +1,262 @@
+// === FLOATING BOOKSHELVES + SPINE TEXTURES + COMMIT BANNERS ===
+import * as THREE from 'three';
+import { NEXUS } from './constants.js';
+import { scene } from './scene-setup.js';
+
+// === AGENT STATUS PANELS (declared early) ===
+export const agentPanelSprites = [];
+
+// === COMMIT BANNERS ===
+export const commitBanners = [];
+
+export const bookshelfGroups = [];
+
+function createCommitTexture(hash, message) {
+  const canvas = document.createElement('canvas');
+  canvas.width = 512;
+  canvas.height = 64;
+  const ctx = canvas.getContext('2d');
+
+  ctx.fillStyle = 'rgba(0, 0, 16, 0.75)';
+  ctx.fillRect(0, 0, 512, 64);
+
+  ctx.strokeStyle = '#4488ff';
+  ctx.lineWidth = 1;
+  ctx.strokeRect(0.5, 0.5, 511, 63);
+
+  ctx.font = 'bold 11px "Courier New", monospace';
+  ctx.fillStyle = '#4488ff';
+  ctx.fillText(hash, 10, 20);
+
+  ctx.font = '12px "Courier New", monospace';
+  ctx.fillStyle = '#ccd6f6';
+  const displayMsg = message.length > 54 ? message.slice(0, 54) + '\u2026' : message;
+  ctx.fillText(displayMsg, 10, 46);
+
+  return new THREE.CanvasTexture(canvas);
+}
+
+export async function initCommitBanners() {
+  let commits;
+  try {
+    const res = await fetch(
+      'http://143.198.27.163:3000/api/v1/repos/Timmy_Foundation/the-nexus/commits?limit=5',
+      { headers: { 'Authorization': 'token dc0517a965226b7a0c5ffdd961b1ba26521ac592' } }
+    );
+    if (!res.ok) throw new Error('fetch failed');
+    const data = await res.json();
+    commits = data.map(c => ({
+      hash: c.sha.slice(0, 7),
+      message: c.commit.message.split('\n')[0],
+    }));
+  } catch {
+    commits = [
+      { hash: 'a1b2c3d', message: 'feat: depth of field effect on distant objects' },
+      { hash: 'e4f5g6h', message: 'feat: photo mode with orbit controls' },
+      { hash: 'i7j8k9l', message: 'feat: sovereignty easter egg animation' },
+      { hash: 'm0n1o2p', message: 'feat: overview mode bird\'s-eye view' },
+      { hash: 'q3r4s5t', message: 'feat: star field and constellation lines' },
+    ];
+
+    initCommitBanners();
+  }
+
+  const spreadX = [-7, -3.5, 0, 3.5, 7];
+  const spreadY = [1.0, -1.5, 2.2, -0.8, 1.6];
+  const spreadZ = [-1.5, -2.5, -1.0, -2.0, -1.8];
+
+  commits.forEach((commit, i) => {
+    const texture = createCommitTexture(commit.hash, commit.message);
+    const material = new THREE.SpriteMaterial({
+      map: texture, transparent: true, opacity: 0, depthWrite: false,
+    });
+    const sprite = new THREE.Sprite(material);
+    sprite.scale.set(12, 1.5, 1);
+    sprite.position.set(
+      spreadX[i % spreadX.length],
+      spreadY[i % spreadY.length],
+      spreadZ[i % spreadZ.length]
+    );
+    sprite.userData = {
+      baseY: spreadY[i % spreadY.length],
+      floatPhase: (i / commits.length) * Math.PI * 2,
+      floatSpeed: 0.25 + i * 0.07,
+      startDelay: i * 2.5,
+      lifetime: 12 + i * 1.5,
+      spawnTime: null,
+      zoomLabel: `Commit: ${commit.hash}`,
+    };
+    scene.add(sprite);
+    commitBanners.push(sprite);
+  });
+}
+
+// === FLOATING BOOKSHELVES ===
+function createSpineTexture(prNum, title, bgColor) {
+  const canvas = document.createElement('canvas');
+  canvas.width = 128;
+  canvas.height = 512;
+  const ctx = canvas.getContext('2d');
+
+  ctx.fillStyle = bgColor;
+  ctx.fillRect(0, 0, 128, 512);
+
+  ctx.strokeStyle = '#4488ff';
+  ctx.lineWidth = 3;
+  ctx.strokeRect(3, 3, 122, 506);
+
+  ctx.font = 'bold 32px "Courier New", monospace';
+  ctx.fillStyle = '#4488ff';
+  ctx.textAlign = 'center';
+  ctx.fillText(`#${prNum}`, 64, 58);
+
+  ctx.strokeStyle = '#4488ff';
+  ctx.lineWidth = 1;
+  ctx.globalAlpha = 0.4;
+  ctx.beginPath();
+  ctx.moveTo(12, 78);
+  ctx.lineTo(116, 78);
+  ctx.stroke();
+  ctx.globalAlpha = 1.0;
+
+  ctx.save();
+  ctx.translate(64, 300);
+  ctx.rotate(-Math.PI / 2);
+  const displayTitle = title.length > 30 ? title.slice(0, 30) + '\u2026' : title;
+  ctx.font = '21px "Courier New", monospace';
+  ctx.fillStyle = '#ccd6f6';
+  ctx.textAlign = 'center';
+  ctx.fillText(displayTitle, 0, 0);
+  ctx.restore();
+
+  return new THREE.CanvasTexture(canvas);
+}
+
+function buildBookshelf(books, position, rotationY) {
+  const group = new THREE.Group();
+  group.position.copy(position);
+  group.rotation.y = rotationY;
+
+  const SHELF_W = books.length * 0.52 + 0.6;
+  const SHELF_THICKNESS = 0.12;
+  const SHELF_DEPTH = 0.72;
+  const ENDPANEL_H = 2.0;
+
+  const shelfMat = new THREE.MeshStandardMaterial({
+    color: 0x0d1520, metalness: 0.6, roughness: 0.5,
+    emissive: new THREE.Color(NEXUS.colors.accent).multiplyScalar(0.02),
+  });
+
+  const plank = new THREE.Mesh(new THREE.BoxGeometry(SHELF_W, SHELF_THICKNESS, SHELF_DEPTH), shelfMat);
+  group.add(plank);
+
+  const endGeo = new THREE.BoxGeometry(0.1, ENDPANEL_H, SHELF_DEPTH);
+  const leftEnd = new THREE.Mesh(endGeo, shelfMat);
+  leftEnd.position.set(-SHELF_W / 2, ENDPANEL_H / 2 - SHELF_THICKNESS / 2, 0);
+  group.add(leftEnd);
+
+  const rightEnd = new THREE.Mesh(endGeo.clone(), shelfMat);
+  rightEnd.position.set(SHELF_W / 2, ENDPANEL_H / 2 - SHELF_THICKNESS / 2, 0);
+  group.add(rightEnd);
+
+  const glowStrip = new THREE.Mesh(
+    new THREE.BoxGeometry(SHELF_W, 0.035, 0.035),
+    new THREE.MeshBasicMaterial({ color: NEXUS.colors.accent, transparent: true, opacity: 0.55 })
+  );
+  glowStrip.position.set(0, SHELF_THICKNESS / 2 + 0.017, SHELF_DEPTH / 2);
+  group.add(glowStrip);
+
+  const BOOK_COLORS = [
+    '#0f0818', '#080f18', '#0f1108', '#07120e',
+    '#130c06', '#060b12', '#120608', '#080812',
+  ];
+
+  const bookStartX = -(SHELF_W / 2) + 0.36;
+  books.forEach((book, i) => {
+    const spineW = 0.34 + (i % 3) * 0.05;
+    const bookH = 1.35 + (i % 4) * 0.13;
+    const coverD = 0.58;
+
+    const bgColor = BOOK_COLORS[i % BOOK_COLORS.length];
+    const spineTexture = createSpineTexture(book.prNum, book.title, bgColor);
+
+    const plainMat = new THREE.MeshStandardMaterial({
+      color: new THREE.Color(bgColor), roughness: 0.85, metalness: 0.05,
+    });
+    const spineMat = new THREE.MeshBasicMaterial({ map: spineTexture });
+
+    const bookMats = [plainMat, plainMat, plainMat, plainMat, spineMat, plainMat];
+
+    const bookGeo = new THREE.BoxGeometry(spineW, bookH, coverD);
+    const bookMesh = new THREE.Mesh(bookGeo, bookMats);
+    bookMesh.position.set(bookStartX + i * 0.5, SHELF_THICKNESS / 2 + bookH / 2, 0);
+    bookMesh.userData.zoomLabel = `PR #${book.prNum}: ${book.title.slice(0, 40)}`;
+    group.add(bookMesh);
+  });
+
+  const shelfLight = new THREE.PointLight(NEXUS.colors.accent, 0.25, 5);
+  shelfLight.position.set(0, -0.4, 0);
+  group.add(shelfLight);
+
+  group.userData.zoomLabel = 'PR Archive — Merged Contributions';
+  group.userData.baseY = position.y;
+  group.userData.floatPhase = bookshelfGroups.length * Math.PI;
+  group.userData.floatSpeed = 0.17 + bookshelfGroups.length * 0.06;
+
+  scene.add(group);
+  bookshelfGroups.push(group);
+}
+
+export async function initBookshelves() {
+  let prs = [];
+  try {
+    const res = await fetch(
+      'http://143.198.27.163:3000/api/v1/repos/Timmy_Foundation/the-nexus/pulls?state=closed&limit=20',
+      { headers: { 'Authorization': 'token dc0517a965226b7a0c5ffdd961b1ba26521ac592' } }
+    );
+    if (!res.ok) throw new Error('fetch failed');
+    const data = await res.json();
+    prs = data
+      .filter(p => p.merged)
+      .map(p => ({
+        prNum: p.number,
+        title: p.title
+          .replace(/^\[[\w\s]+\]\s*/i, '')
+          .replace(/\s*\(#\d+\)\s*$/, ''),
+      }));
+  } catch {
+    prs = [
+      { prNum: 324, title: 'Model training status — LoRA adapters' },
+      { prNum: 323, title: 'The Oath — interactive SOUL.md reading' },
+      { prNum: 320, title: 'Hermes session save/load' },
+      { prNum: 304, title: 'Session export as markdown' },
+      { prNum: 303, title: 'Procedural Web Audio ambient soundtrack' },
+      { prNum: 301, title: 'Warp tunnel effect for portals' },
+      { prNum: 296, title: 'Procedural terrain for floating island' },
+      { prNum: 294, title: 'Northern lights flash on PR merge' },
+    ];
+  }
+
+  // Duplicate podcast handler removed — it was in original but is handled in audio.js
+  // The original code had a duplicate podcast-toggle listener inside initBookshelves. Omitted.
+
+  document.getElementById('podcast-error').style.display = 'none';
+
+  if (prs.length === 0) return;
+
+  const mid = Math.ceil(prs.length / 2);
+
+  buildBookshelf(
+    prs.slice(0, mid),
+    new THREE.Vector3(-8.5, 1.5, -4.5),
+    Math.PI * 0.1,
+  );
+
+  if (prs.slice(mid).length > 0) {
+    buildBookshelf(
+      prs.slice(mid),
+      new THREE.Vector3(8.5, 1.5, -4.5),
+      -Math.PI * 0.1,
+    );
+  }
+}

modules/celebrations.js

@@ -0,0 +1,216 @@
+// === SOVEREIGNTY EASTER EGG + SHOCKWAVE + FIREWORKS + MERGE FLASH ===
+import * as THREE from 'three';
+import { scene, starMaterial, constellationLines } from './scene-setup.js';
+import { S } from './state.js';
+import { clock } from './warp.js';
+
+// === SOVEREIGNTY EASTER EGG ===
+const SOVEREIGNTY_WORD = 'sovereignty';
+
+const sovereigntyMsg = document.getElementById('sovereignty-msg');
+
+export function triggerSovereigntyEasterEgg() {
+  const originalLineColor = constellationLines.material.color.getHex();
+  constellationLines.material.color.setHex(0xffd700);
+  constellationLines.material.opacity = 0.9;
+
+  const originalStarColor = starMaterial.color.getHex();
+  const originalStarOpacity = starMaterial.opacity;
+  starMaterial.color.setHex(0xffd700);
+  starMaterial.opacity = 1.0;
+
+  if (sovereigntyMsg) {
+    sovereigntyMsg.classList.remove('visible');
+    void sovereigntyMsg.offsetWidth;
+    sovereigntyMsg.classList.add('visible');
+  }
+
+  const startTime = performance.now();
+  const DURATION = 2500;
+
+  function fadeBack() {
+    const t = Math.min((performance.now() - startTime) / DURATION, 1);
+    const eased = t * t;
+
+    const goldR = 1.0, goldG = 0.843, goldB = 0;
+    const origColor = new THREE.Color(originalStarColor);
+    starMaterial.color.setRGB(
+      goldR + (origColor.r - goldR) * eased,
+      goldG + (origColor.g - goldG) * eased,
+      goldB + (origColor.b - goldB) * eased
+    );
+    starMaterial.opacity = 1.0 + (originalStarOpacity - 1.0) * eased;
+
+    const origLineColor = new THREE.Color(originalLineColor);
+    constellationLines.material.color.setRGB(
+      1.0 + (origLineColor.r - 1.0) * eased,
+      0.843 + (origLineColor.g - 0.843) * eased,
+      0 + origLineColor.b * eased
+    );
+
+    if (t < 1) {
+      requestAnimationFrame(fadeBack);
+    } else {
+      starMaterial.color.setHex(originalStarColor);
+      starMaterial.opacity = originalStarOpacity;
+      constellationLines.material.color.setHex(originalLineColor);
+      if (sovereigntyMsg) sovereigntyMsg.classList.remove('visible');
+    }
+  }
+
+  requestAnimationFrame(fadeBack);
+}
+
+// === SHOCKWAVE RIPPLE ===
+const SHOCKWAVE_RING_COUNT = 3;
+const SHOCKWAVE_MAX_RADIUS = 14;
+export const SHOCKWAVE_DURATION = 2.5;
+
+export const shockwaveRings = [];
+
+export function triggerShockwave() {
+  const now = clock.getElapsedTime();
+  for (let i = 0; i < SHOCKWAVE_RING_COUNT; i++) {
+    const mat = new THREE.MeshBasicMaterial({
+      color: 0x00ffff, transparent: true, opacity: 0,
+      side: THREE.DoubleSide, depthWrite: false, blending: THREE.AdditiveBlending,
+    });
+    const geo = new THREE.RingGeometry(0.9, 1.0, 64);
+    const mesh = new THREE.Mesh(geo, mat);
+    mesh.rotation.x = -Math.PI / 2;
+    mesh.position.y = 0.02;
+    scene.add(mesh);
+    shockwaveRings.push({ mesh, mat, startTime: now, delay: i * 0.35 });
+  }
+}
+
+// === FIREWORK CELEBRATION ===
+const FIREWORK_COLORS = [0xff4466, 0xffaa00, 0x00ffaa, 0x4488ff, 0xff44ff, 0xffff44, 0x00ffff];
+export const FIREWORK_BURST_PARTICLES = 80;
+export const FIREWORK_BURST_DURATION = 2.2;
+export const FIREWORK_GRAVITY = -5.0;
+
+export const fireworkBursts = [];
+
+function spawnFireworkBurst(origin, color) {
+  const now = clock.getElapsedTime();
+  const count = FIREWORK_BURST_PARTICLES;
+  const positions = new Float32Array(count * 3);
+  const origins = new Float32Array(count * 3);
+  const velocities = new Float32Array(count * 3);
+
+  for (let i = 0; i < count; i++) {
+    const theta = Math.random() * Math.PI * 2;
+    const phi = Math.acos(2 * Math.random() - 1);
+    const speed = 2.5 + Math.random() * 3.5;
+    velocities[i * 3]     = Math.sin(phi) * Math.cos(theta) * speed;
+    velocities[i * 3 + 1] = Math.sin(phi) * Math.sin(theta) * speed;
+    velocities[i * 3 + 2] = Math.cos(phi) * speed;
+
+    origins[i * 3]     = origin.x;
+    origins[i * 3 + 1] = origin.y;
+    origins[i * 3 + 2] = origin.z;
+    positions[i * 3]     = origin.x;
+    positions[i * 3 + 1] = origin.y;
+    positions[i * 3 + 2] = origin.z;
+  }
+
+  const geo = new THREE.BufferGeometry();
+  geo.setAttribute('position', new THREE.BufferAttribute(positions, 3));
+
+  const mat = new THREE.PointsMaterial({
+    color, size: 0.35, sizeAttenuation: true,
+    transparent: true, opacity: 1.0,
+    blending: THREE.AdditiveBlending, depthWrite: false,
+  });
+
+  const points = new THREE.Points(geo, mat);
+  scene.add(points);
+  fireworkBursts.push({ points, geo, mat, origins, velocities, startTime: now });
+}
+
+export function triggerFireworks() {
+  const burstCount = 6;
+  for (let i = 0; i < burstCount; i++) {
+    const delay = i * 0.35;
+    setTimeout(() => {
+      const x = (Math.random() - 0.5) * 12;
+      const y = 8 + Math.random() * 6;
+      const z = (Math.random() - 0.5) * 12;
+      const color = FIREWORK_COLORS[Math.floor(Math.random() * FIREWORK_COLORS.length)];
+      spawnFireworkBurst(new THREE.Vector3(x, y, z), color);
+    }, delay * 1000);
+  }
+}
+
+export function triggerMergeFlash() {
+  triggerShockwave();
+  const originalLineColor = constellationLines.material.color.getHex();
+  constellationLines.material.color.setHex(0x00ffff);
+  constellationLines.material.opacity = 1.0;
+
+  const originalStarColor = starMaterial.color.getHex();
+  const originalStarOpacity = starMaterial.opacity;
+  starMaterial.color.setHex(0x00ffff);
+  starMaterial.opacity = 1.0;
+
+  const startTime = performance.now();
+  const DURATION = 2000;
+
+  function fadeBack() {
+    const t = Math.min((performance.now() - startTime) / DURATION, 1);
+    const eased = t * t;
+
+    const mergeR = 0.0, mergeG = 1.0, mergeB = 1.0;
+    const origStarColor = new THREE.Color(originalStarColor);
+    starMaterial.color.setRGB(
+      mergeR + (origStarColor.r - mergeR) * eased,
+      mergeG + (origStarColor.g - mergeG) * eased,
+      mergeB + (origStarColor.b - mergeB) * eased
+    );
+    starMaterial.opacity = 1.0 + (originalStarOpacity - 1.0) * eased;
+
+    const origLineColor = new THREE.Color(originalLineColor);
+    constellationLines.material.color.setRGB(
+      mergeR + (origLineColor.r - mergeR) * eased,
+      mergeG + (origLineColor.g - mergeG) * eased,
+      mergeB + (origLineColor.b - mergeB) * eased
+    );
+    constellationLines.material.opacity = 1.0 + (0.18 - 1.0) * eased;
+
+    if (t < 1) {
+      requestAnimationFrame(fadeBack);
+    } else {
+      starMaterial.color.setHex(originalStarColor);
+      starMaterial.opacity = originalStarOpacity;
+      constellationLines.material.color.setHex(originalLineColor);
+      constellationLines.material.opacity = 0.18;
+    }
+  }
+
+  requestAnimationFrame(fadeBack);
+}
+
+export function initSovereigntyEasterEgg() {
+  document.addEventListener('keydown', (e) => {
+    if (e.metaKey || e.ctrlKey || e.altKey) return;
+    if (e.key.length !== 1) {
+      S.sovereigntyBuffer = '';
+      return;
+    }
+
+    S.sovereigntyBuffer += e.key.toLowerCase();
+
+    if (S.sovereigntyBuffer.length > SOVEREIGNTY_WORD.length) {
+      S.sovereigntyBuffer = S.sovereigntyBuffer.slice(-SOVEREIGNTY_WORD.length);
+    }
+
+    if (S.sovereigntyBuffer === SOVEREIGNTY_WORD) {
+      S.sovereigntyBuffer = '';
+      triggerSovereigntyEasterEgg();
+    }
+
+    if (S.sovereigntyBufferTimer) clearTimeout(S.sovereigntyBufferTimer);
+    S.sovereigntyBufferTimer = setTimeout(() => { S.sovereigntyBuffer = ''; }, 3000);
+  });
+}

modules/constants.js

@@ -0,0 +1,11 @@
+// === COLOR PALETTE ===
+export const NEXUS = {
+  colors: {
+    bg: 0x000008,
+    starCore: 0xffffff,
+    starDim: 0x8899cc,
+    constellationLine: 0x334488,
+    constellationFade: 0x112244,
+    accent: 0x4488ff,
+  }
+};

modules/controls.js

@@ -0,0 +1,158 @@
+// === MOUSE ROTATION + OVERVIEW + ZOOM + PHOTO MODE ===
+import * as THREE from 'three';
+import { OrbitControls } from 'three/addons/controls/OrbitControls.js';
+import { EffectComposer } from 'three/addons/postprocessing/EffectComposer.js';
+import { RenderPass } from 'three/addons/postprocessing/RenderPass.js';
+import { BokehPass } from 'three/addons/postprocessing/BokehPass.js';
+import { ShaderPass } from 'three/addons/postprocessing/ShaderPass.js';
+import { scene, camera, renderer } from './scene-setup.js';
+import { S } from './state.js';
+
+// === MOUSE-DRIVEN ROTATION ===
+document.addEventListener('mousemove', (e) => {
+  S.mouseX = (e.clientX / window.innerWidth - 0.5) * 2;
+  S.mouseY = (e.clientY / window.innerHeight - 0.5) * 2;
+});
+
+// === OVERVIEW MODE ===
+export const NORMAL_CAM = new THREE.Vector3(0, 6, 11);
+export const OVERVIEW_CAM = new THREE.Vector3(0, 200, 0.1);
+
+const overviewIndicator = document.getElementById('overview-indicator');
+
+document.addEventListener('keydown', (e) => {
+  if (e.key === 'Tab') {
+    e.preventDefault();
+    S.overviewMode = !S.overviewMode;
+    if (S.overviewMode) {
+      overviewIndicator.classList.add('visible');
+    } else {
+      overviewIndicator.classList.remove('visible');
+    }
+  }
+});
+
+// === ZOOM-TO-OBJECT ===
+const _zoomRaycaster = new THREE.Raycaster();
+const _zoomMouse = new THREE.Vector2();
+
+const zoomIndicator = document.getElementById('zoom-indicator');
+const zoomLabelEl = document.getElementById('zoom-label');
+
+function getZoomLabel(obj) {
+  let o = obj;
+  while (o) {
+    if (o.userData && o.userData.zoomLabel) return o.userData.zoomLabel;
+    o = o.parent;
+  }
+  return 'Object';
+}
+
+export function exitZoom() {
+  S.zoomTargetT = 0;
+  S.zoomActive = false;
+  if (zoomIndicator) zoomIndicator.classList.remove('visible');
+}
+
+renderer.domElement.addEventListener('dblclick', (e) => {
+  if (S.overviewMode || S.photoMode) return;
+
+  _zoomMouse.x = (e.clientX / window.innerWidth) * 2 - 1;
+  _zoomMouse.y = -(e.clientY / window.innerHeight) * 2 + 1;
+  _zoomRaycaster.setFromCamera(_zoomMouse, camera);
+
+  const hits = _zoomRaycaster.intersectObjects(scene.children, true)
+    .filter(h => !(h.object instanceof THREE.Points) && !(h.object instanceof THREE.Line));
+
+  if (!hits.length) {
+    exitZoom();
+    return;
+  }
+
+  const hit = hits[0];
+  const label = getZoomLabel(hit.object);
+  const dir = new THREE.Vector3().subVectors(camera.position, hit.point).normalize();
+  const flyDist = Math.max(1.5, Math.min(5, hit.distance * 0.45));
+  S._zoomCamTarget.copy(hit.point).addScaledVector(dir, flyDist);
+  S._zoomLookTarget.copy(hit.point);
+  S.zoomT = 0;
+  S.zoomTargetT = 1;
+  S.zoomActive = true;
+
+  if (zoomLabelEl) zoomLabelEl.textContent = label;
+  if (zoomIndicator) zoomIndicator.classList.add('visible');
+});
+
+document.addEventListener('keydown', (e) => {
+  if (e.key === 'Escape') exitZoom();
+});
+
+// === PHOTO MODE ===
+// Warp effect state (declared here, used by controls and warp modules)
+export const WARP_DURATION = 2.2;
+
+// Post-processing composer
+export const composer = new EffectComposer(renderer);
+composer.addPass(new RenderPass(scene, camera));
+
+export const bokehPass = new BokehPass(scene, camera, {
+  focus: 5.0,
+  aperture: 0.00015,
+  maxblur: 0.004,
+});
+composer.addPass(bokehPass);
+
+// Orbit controls for free camera movement in photo mode
+export const orbitControls = new OrbitControls(camera, renderer.domElement);
+orbitControls.enableDamping = true;
+orbitControls.dampingFactor = 0.05;
+orbitControls.enabled = false;
+
+const photoIndicator = document.getElementById('photo-indicator');
+const photoFocusDisplay = document.getElementById('photo-focus');
+
+function updateFocusDisplay() {
+  if (photoFocusDisplay) {
+    photoFocusDisplay.textContent = bokehPass.uniforms['focus'].value.toFixed(1);
+  }
+}
+
+document.addEventListener('keydown', (e) => {
+  if (e.key === 'p' || e.key === 'P') {
+    S.photoMode = !S.photoMode;
+    document.body.classList.toggle('photo-mode', S.photoMode);
+    orbitControls.enabled = S.photoMode;
+    if (photoIndicator) {
+      photoIndicator.classList.toggle('visible', S.photoMode);
+    }
+    if (S.photoMode) {
+      bokehPass.uniforms['aperture'].value = 0.0003;
+      bokehPass.uniforms['maxblur'].value = 0.008;
+      orbitControls.target.set(0, 0, 0);
+      orbitControls.update();
+      updateFocusDisplay();
+    } else {
+      bokehPass.uniforms['aperture'].value = 0.00015;
+      bokehPass.uniforms['maxblur'].value = 0.004;
+    }
+  }
+
+  if (S.photoMode) {
+    const focusStep = 0.5;
+    if (e.key === '[') {
+      bokehPass.uniforms['focus'].value = Math.max(0.5, bokehPass.uniforms['focus'].value - focusStep);
+      updateFocusDisplay();
+    } else if (e.key === ']') {
+      bokehPass.uniforms['focus'].value = Math.min(200, bokehPass.uniforms['focus'].value + focusStep);
+      updateFocusDisplay();
+    }
+  }
+});
+
+// === RESIZE HANDLER ===
+window.addEventListener('resize', () => {
+  camera.aspect = window.innerWidth / window.innerHeight;
+  camera.updateProjectionMatrix();
+  renderer.setSize(window.innerWidth, window.innerHeight);
+  composer.setSize(window.innerWidth, window.innerHeight);
+});

modules/core/scene.js

@@ -0,0 +1,12 @@
+// modules/core/scene.js — Canonical scene exports
+// Provides THREE.Scene, camera, renderer, OrbitControls, and resize handler
+// for use by app.js and any module that needs scene primitives.
+//
+// Implementation detail: the actual objects live in ../scene-setup.js and
+// ../controls.js until those modules are absorbed here in a later phase.
+
+export { scene, camera, renderer, raycaster, forwardVector,
+         ambientLight, overheadLight,
+         stars, starMaterial, constellationLines,
+         STAR_BASE_OPACITY, STAR_PEAK_OPACITY, STAR_PULSE_DECAY } from '../scene-setup.js';
+export { orbitControls, composer, bokehPass, exitZoom, WARP_DURATION } from '../controls.js';

modules/core/state.js

@@ -1,35 +0,0 @@
-// modules/core/state.js — Shared reactive data bus
-// Data modules write here; visual modules read from here.
-// No module may call fetch() except those under modules/data/.
-
-export const state = {
-  // Commit heatmap (written by data/gitea.js)
-  zoneIntensity: {},   // { zoneName: [0..1], ... }
-  commits: [],         // raw commit objects (last N)
-  commitHashes: [],    // short hashes for matrix rain
-
-  // Agent status (written by data/gitea.js)
-  agentStatus: null,        // { agents: Array<AgentRecord> } | null
-  activeAgentCount: 0,      // count of agents with status === 'working'
-
-  // Weather (written by data/weather.js)
-  weather: null,            // { cloud_cover, precipitation, ... } | null
-
-  // Bitcoin (written by data/bitcoin.js)
-  blockHeight: 0,
-  lastBlockHeight: 0,
-  newBlockDetected: false,
-  starPulseIntensity: 0,
-
-  // Portal / sovereignty / SOUL (written by data/loaders.js)
-  portals: [],              // portal descriptor objects
-  sovereignty: null,        // { score, label, assessment_type } | null
-  soulMd: '',               // raw SOUL.md text
-
-  // Computed helpers
-  totalActivity() {
-    const vals = Object.values(this.zoneIntensity);
-    if (vals.length === 0) return 0;
-    return vals.reduce((s, v) => s + v, 0) / vals.length;
-  },
-};

modules/core/theme.js

@@ -1,56 +1,78 @@
-// modules/core/theme.js — Visual design system for the Nexus
-// All colors, fonts, line weights, and glow params live here.
-// No module may use inline hex codes — all visual constants come from NEXUS.theme.
+// modules/core/theme.js — NEXUS visual constants
+// Single source of truth for all colors, fonts, line weights, glow params.
+// No module may use inline hex codes or hardcoded font strings.
 
+/** NEXUS — the canonical theme object used by all visual modules */
 export const NEXUS = {
-  theme: {
-    // Core palette
+  /** Numeric hex colors for THREE.js materials */
+  colors: {
     bg:                0x000008,
-    accent:            0x4488ff,
-    accentStr:         '#4488ff',
     starCore:          0xffffff,
     starDim:           0x8899cc,
     constellationLine: 0x334488,
+    constellationFade: 0x112244,
+    accent:            0x4488ff,
+  },
 
-    // Agent status colors (hex strings for canvas, hex numbers for THREE)
-    agentWorking:      '#00ff88',
-    agentWorkingHex:   0x00ff88,
-    agentIdle:         '#4488ff',
-    agentIdleHex:      0x4488ff,
-    agentDormant:      '#334466',
-    agentDormantHex:   0x334466,
-    agentDead:         '#ff4444',
-    agentDeadHex:      0xff4444,
+  /** All canvas/CSS/string visual constants */
+  theme: {
+    // Accent (hex number + CSS string pair)
+    accent:            0x4488ff,
+    accentStr:         '#4488ff',
 
-    // Sovereignty meter colors
-    sovereignHigh:     '#00ff88',   // score >= 80
-    sovereignHighHex:  0x00ff88,
-    sovereignMid:      '#ffcc00',   // score >= 40
-    sovereignMidHex:   0xffcc00,
-    sovereignLow:      '#ff4444',   // score < 40
+    // Panel surfaces
+    panelBg:           '#0a1428',
+    panelText:         '#4af0c0',
+    panelDim:          '#7b9bbf',
+    panelVeryDim:      '#3a5070',
+    panelBorderFaint:  '#1a3050',
+
+    // Agent status colors (CSS strings for canvas)
+    agentWorking:      '#4af0c0',
+    agentIdle:         '#7b5cff',
+    agentDormant:      '#2a4060',
+    agentDormantHex:   0x2a4060,
+    agentDead:         '#3a2040',
+
+    // Sovereignty meter
+    sovereignHigh:     '#4af0c0',
+    sovereignHighHex:  0x4af0c0,
+    sovereignMid:      '#ffd700',
+    sovereignMidHex:   0xffd700,
+    sovereignLow:      '#ff4444',
     sovereignLowHex:   0xff4444,
 
-    // LoRA / training panel
-    loraAccent:        '#cc44ff',
-    loraAccentHex:     0xcc44ff,
-    loraActive:        '#00ff88',
-    loraInactive:      '#334466',
+    // Holographic earth
+    earthOcean:        '#0a2040',
+    earthLand:         '#1a4020',
+    earthAtm:          '#204070',
+    earthGlow:         '#4488ff',
 
-    // Earth
-    earthOcean:        0x003d99,
-    earthLand:         0x1a5c2a,
-    earthAtm:          0x1144cc,
-    earthGlow:         0x4488ff,
-
-    // Panel chrome
-    panelBg:           'rgba(0, 6, 20, 0.90)',
-    panelBorder:       '#4488ff',
-    panelBorderFaint:  '#1a3a6a',
-    panelText:         '#ccd6f6',
-    panelDim:          '#556688',
-    panelVeryDim:      '#334466',
+    // LoRA panel
+    loraActive:        '#4af0c0',
+    loraInactive:      '#3a5070',
+    loraAccent:        '#7b5cff',
 
     // Typography
-    fontMono:          '"Courier New", monospace',
+    fontMono:          'monospace',
+  },
+};
+
+/** THEME — glass / text presets (kept for SovOS.js and other legacy consumers) */
+export const THEME = {
+  glass: {
+    color:        0x112244,
+    opacity:      0.35,
+    roughness:    0.05,
+    metalness:    0.1,
+    transmission: 0.95,
+    thickness:    0.8,
+    ior:          1.5,
+  },
+  text: {
+    primary:   '#4af0c0',
+    secondary: '#7b5cff',
+    white:     '#ffffff',
+    dim:       '#a0b8d0',
   },
 };

modules/core/ticker.js

@@ -1,46 +0,0 @@
-// modules/core/ticker.js — Global Animation Clock
-// Single requestAnimationFrame loop. All modules subscribe here.
-// No module may call requestAnimationFrame directly.
-
-import * as THREE from 'three';
-
-const _clock = new THREE.Clock();
-const _subscribers = [];
-
-let _running = false;
-let _elapsed = 0;
-
-/**
- * Subscribe a callback to the animation loop.
- * @param {(elapsed: number, delta: number) => void} fn
- */
-export function subscribe(fn) {
-  _subscribers.push(fn);
-}
-
-/**
- * Unsubscribe a callback from the animation loop.
- * @param {(elapsed: number, delta: number) => void} fn
- */
-export function unsubscribe(fn) {
-  const idx = _subscribers.indexOf(fn);
-  if (idx !== -1) _subscribers.splice(idx, 1);
-}
-
-/** Start the animation loop. Called once by app.js after all modules are init'd. */
-export function start() {
-  if (_running) return;
-  _running = true;
-  _tick();
-}
-
-function _tick() {
-  if (!_running) return;
-  requestAnimationFrame(_tick);
-  const delta = _clock.getDelta();
-  _elapsed += delta;
-  for (const fn of _subscribers) fn(_elapsed, delta);
-}
-
-/** Current elapsed time in seconds (read-only). */
-export function elapsed() { return _elapsed; }

modules/debug.js

@@ -0,0 +1,107 @@
+// === DEBUG MODE + WEBSOCKET + SESSION EXPORT ===
+import * as THREE from 'three';
+import { scene } from './scene-setup.js';
+import { S } from './state.js';
+
+// === DEBUG MODE ===
+export function initDebug() {
+  document.getElementById('debug-toggle').addEventListener('click', () => {
+    S.debugMode = !S.debugMode;
+    document.getElementById('debug-toggle').style.backgroundColor = S.debugMode
+      ? 'var(--color-text-muted)'
+      : 'var(--color-secondary)';
+    console.log(`Debug mode ${S.debugMode ? 'enabled' : 'disabled'}`);
+
+    if (S.debugMode) {
+      document.querySelectorAll('.collision-box').forEach((el) => el.style.outline = '2px solid red');
+      document.querySelectorAll('.light-source').forEach((el) => el.style.outline = '2px dashed yellow');
+    } else {
+      document.querySelectorAll('.collision-box, .light-source').forEach((el) => {
+        el.style.outline = 'none';
+      });
+    }
+  });
+}
+
+const DEBUG_MODE = false;
+
+export function debugVisualize(sceneRef) {
+  if (!DEBUG_MODE) return;
+  sceneRef.traverse((object) => {
+    if (object.userData && object.userData.isCollidable) {
+      object.material = new THREE.MeshBasicMaterial({ color: 0xff00ff, wireframe: true });
+    }
+  });
+  sceneRef.traverse((object) => {
+    if (object instanceof THREE.Light) {
+      const helper = new THREE.LightHelper(object, 1, 0xffff00);
+      sceneRef.add(helper);
+    }
+  });
+}
+
+// === WEBSOCKET CLIENT ===
+import { wsClient } from '../ws-client.js';
+
+export { wsClient };
+
+export function initWebSocket() {
+  wsClient.connect();
+
+  window.addEventListener('player-joined', (event) => {
+    console.log('Player joined:', event.detail);
+  });
+
+  window.addEventListener('player-left', (event) => {
+    console.log('Player left:', event.detail);
+  });
+}
+
+// === SESSION EXPORT ===
+export const sessionLog = [];
+const sessionStart = Date.now();
+
+export function logMessage(speaker, text) {
+  sessionLog.push({ ts: Date.now(), speaker, text });
+}
+
+export function exportSessionAsMarkdown() {
+  const startStr = new Date(sessionStart).toISOString().replace('T', ' ').slice(0, 19) + ' UTC';
+  const lines = [
+    '# Nexus Session Export',
+    '',
+    `**Session started:** ${startStr}`,
+    `**Messages:** ${sessionLog.length}`,
+    '',
+    '---',
+    '',
+  ];
+
+  for (const entry of sessionLog) {
+    const timeStr = new Date(entry.ts).toISOString().replace('T', ' ').slice(0, 19) + ' UTC';
+    lines.push(`### ${entry.speaker} — ${timeStr}`);
+    lines.push('');
+    lines.push(entry.text);
+    lines.push('');
+  }
+
+  if (sessionLog.length === 0) {
+    lines.push('*No messages recorded this session.*');
+    lines.push('');
+  }
+
+  const blob = new Blob([lines.join('\n')], { type: 'text/markdown' });
+  const url = URL.createObjectURL(blob);
+  const a = document.createElement('a');
+  a.href = url;
+  a.download = `nexus-session-${new Date(sessionStart).toISOString().slice(0, 10)}.md`;
+  a.click();
+  URL.revokeObjectURL(url);
+}
+
+export function initSessionExport() {
+  const exportBtn = document.getElementById('export-session');
+  if (exportBtn) {
+    exportBtn.addEventListener('click', exportSessionAsMarkdown);
+  }
+}

modules/dual-brain.js

@@ -0,0 +1,205 @@
+// === DUAL-BRAIN HOLOGRAPHIC PANEL ===
+import * as THREE from 'three';
+import { NEXUS } from './constants.js';
+import { scene } from './scene-setup.js';
+
+const DUAL_BRAIN_ORIGIN = new THREE.Vector3(10, 3, -8);
+export const dualBrainGroup = new THREE.Group();
+dualBrainGroup.position.copy(DUAL_BRAIN_ORIGIN);
+dualBrainGroup.lookAt(0, 3, 0);
+scene.add(dualBrainGroup);
+
+function createDualBrainTexture() {
+  const W = 512, H = 512;
+  const canvas = document.createElement('canvas');
+  canvas.width = W;
+  canvas.height = H;
+  const ctx = canvas.getContext('2d');
+
+  ctx.fillStyle = 'rgba(0, 6, 20, 0.90)';
+  ctx.fillRect(0, 0, W, H);
+
+  ctx.strokeStyle = '#4488ff';
+  ctx.lineWidth = 2;
+  ctx.strokeRect(1, 1, W - 2, H - 2);
+
+  ctx.strokeStyle = '#223366';
+  ctx.lineWidth = 1;
+  ctx.strokeRect(5, 5, W - 10, H - 10);
+
+  ctx.font = 'bold 22px "Courier New", monospace';
+  ctx.fillStyle = '#88ccff';
+  ctx.textAlign = 'center';
+  ctx.fillText('\u25C8 DUAL-BRAIN STATUS', W / 2, 40);
+
+  ctx.strokeStyle = '#1a3a6a';
+  ctx.lineWidth = 1;
+  ctx.beginPath();
+  ctx.moveTo(20, 52);
+  ctx.lineTo(W - 20, 52);
+  ctx.stroke();
+
+  ctx.font = '11px "Courier New", monospace';
+  ctx.fillStyle = '#556688';
+  ctx.textAlign = 'left';
+  ctx.fillText('BRAIN GAP SCORECARD', 20, 74);
+
+  const categories = [
+    { name: 'Triage' },
+    { name: 'Tool Use' },
+    { name: 'Code Gen' },
+    { name: 'Planning' },
+    { name: 'Communication' },
+    { name: 'Reasoning' },
+  ];
+
+  const barX = 20;
+  const barW = W - 130;
+  const barH = 20;
+  let y = 90;
+
+  for (const cat of categories) {
+    ctx.font = '13px "Courier New", monospace';
+    ctx.fillStyle = '#445566';
+    ctx.textAlign = 'left';
+    ctx.fillText(cat.name, barX, y + 14);
+
+    ctx.font = 'bold 13px "Courier New", monospace';
+    ctx.fillStyle = '#334466';
+    ctx.textAlign = 'right';
+    ctx.fillText('\u2014', W - 20, y + 14);
+
+    y += 22;
+
+    ctx.fillStyle = 'rgba(255, 255, 255, 0.06)';
+    ctx.fillRect(barX, y, barW, barH);
+
+    y += barH + 12;
+  }
+
+  ctx.strokeStyle = '#1a3a6a';
+  ctx.beginPath();
+  ctx.moveTo(20, y + 4);
+  ctx.lineTo(W - 20, y + 4);
+  ctx.stroke();
+
+  y += 22;
+
+  ctx.font = 'bold 18px "Courier New", monospace';
+  ctx.fillStyle = '#334466';
+  ctx.textAlign = 'center';
+  ctx.fillText('AWAITING DEPLOYMENT', W / 2, y + 10);
+
+  ctx.font = '11px "Courier New", monospace';
+  ctx.fillStyle = '#223344';
+  ctx.fillText('Dual-brain system not yet connected', W / 2, y + 32);
+
+  y += 52;
+  ctx.beginPath();
+  ctx.arc(W / 2 - 60, y + 8, 6, 0, Math.PI * 2);
+  ctx.fillStyle = '#334466';
+  ctx.fill();
+  ctx.font = '11px "Courier New", monospace';
+  ctx.fillStyle = '#334466';
+  ctx.textAlign = 'left';
+  ctx.fillText('CLOUD', W / 2 - 48, y + 12);
+
+  ctx.beginPath();
+  ctx.arc(W / 2 + 30, y + 8, 6, 0, Math.PI * 2);
+  ctx.fillStyle = '#334466';
+  ctx.fill();
+  ctx.fillStyle = '#334466';
+  ctx.fillText('LOCAL', W / 2 + 42, y + 12);
+
+  return new THREE.CanvasTexture(canvas);
+}
+
+const dualBrainTexture = createDualBrainTexture();
+const dualBrainMaterial = new THREE.SpriteMaterial({
+  map: dualBrainTexture, transparent: true, opacity: 0.92, depthWrite: false,
+});
+export const dualBrainSprite = new THREE.Sprite(dualBrainMaterial);
+dualBrainSprite.scale.set(5.0, 5.0, 1);
+dualBrainSprite.position.set(0, 0, 0);
+dualBrainSprite.userData = {
+  baseY: 0, floatPhase: 0, floatSpeed: 0.22, zoomLabel: 'Dual-Brain Status',
+};
+dualBrainGroup.add(dualBrainSprite);
+
+export const dualBrainLight = new THREE.PointLight(0x4488ff, 0.6, 10);
+dualBrainLight.position.set(0, 0.5, 1);
+dualBrainGroup.add(dualBrainLight);
+
+// Brain Orbs
+const CLOUD_ORB_COLOR = 0x334466;
+const cloudOrbGeo = new THREE.SphereGeometry(0.35, 32, 32);
+export const cloudOrbMat = new THREE.MeshStandardMaterial({
+  color: CLOUD_ORB_COLOR,
+  emissive: new THREE.Color(CLOUD_ORB_COLOR),
+  emissiveIntensity: 0.1, metalness: 0.3, roughness: 0.2,
+  transparent: true, opacity: 0.85,
+});
+export const cloudOrb = new THREE.Mesh(cloudOrbGeo, cloudOrbMat);
+cloudOrb.position.set(-2.0, 3.0, 0);
+cloudOrb.userData.zoomLabel = 'Cloud Brain';
+dualBrainGroup.add(cloudOrb);
+
+export const cloudOrbLight = new THREE.PointLight(CLOUD_ORB_COLOR, 0.15, 5);
+cloudOrbLight.position.copy(cloudOrb.position);
+dualBrainGroup.add(cloudOrbLight);
+
+const LOCAL_ORB_COLOR = 0x334466;
+const localOrbGeo = new THREE.SphereGeometry(0.35, 32, 32);
+export const localOrbMat = new THREE.MeshStandardMaterial({
+  color: LOCAL_ORB_COLOR,
+  emissive: new THREE.Color(LOCAL_ORB_COLOR),
+  emissiveIntensity: 0.1, metalness: 0.3, roughness: 0.2,
+  transparent: true, opacity: 0.85,
+});
+export const localOrb = new THREE.Mesh(localOrbGeo, localOrbMat);
+localOrb.position.set(2.0, 3.0, 0);
+localOrb.userData.zoomLabel = 'Local Brain';
+dualBrainGroup.add(localOrb);
+
+export const localOrbLight = new THREE.PointLight(LOCAL_ORB_COLOR, 0.15, 5);
+localOrbLight.position.copy(localOrb.position);
+dualBrainGroup.add(localOrbLight);
+
+// Brain Pulse Particle Stream
+export const BRAIN_PARTICLE_COUNT = 0;
+const brainParticlePositions = new Float32Array(BRAIN_PARTICLE_COUNT * 3);
+export const brainParticlePhases = new Float32Array(BRAIN_PARTICLE_COUNT);
+export const brainParticleSpeeds = new Float32Array(BRAIN_PARTICLE_COUNT);
+
+for (let i = 0; i < BRAIN_PARTICLE_COUNT; i++) {
+  brainParticlePhases[i] = Math.random();
+  brainParticleSpeeds[i] = 0.15 + Math.random() * 0.2;
+  brainParticlePositions[i * 3] = 0;
+  brainParticlePositions[i * 3 + 1] = 0;
+  brainParticlePositions[i * 3 + 2] = 0;
+}
+
+export const brainParticleGeo = new THREE.BufferGeometry();
+brainParticleGeo.setAttribute('position', new THREE.BufferAttribute(brainParticlePositions, 3));
+
+export const brainParticleMat = new THREE.PointsMaterial({
+  color: 0x44ddff, size: 0.08, sizeAttenuation: true,
+  transparent: true, opacity: 0.8, depthWrite: false,
+});
+
+const brainParticles = new THREE.Points(brainParticleGeo, brainParticleMat);
+dualBrainGroup.add(brainParticles);
+
+// Scanning line overlay
+const _scanCanvas = document.createElement('canvas');
+_scanCanvas.width = 512;
+_scanCanvas.height = 512;
+export const _scanCtx = _scanCanvas.getContext('2d');
+export const dualBrainScanTexture = new THREE.CanvasTexture(_scanCanvas);
+const dualBrainScanMat = new THREE.SpriteMaterial({
+  map: dualBrainScanTexture, transparent: true, opacity: 0.18, depthWrite: false,
+});
+export const dualBrainScanSprite = new THREE.Sprite(dualBrainScanMat);
+dualBrainScanSprite.scale.set(5.0, 5.0, 1);
+dualBrainScanSprite.position.set(0, 0, 0.01);
+dualBrainGroup.add(dualBrainScanSprite);

modules/earth.js

@@ -0,0 +1,189 @@
+// === HOLOGRAPHIC EARTH ===
+import * as THREE from 'three';
+import { NEXUS } from './constants.js';
+import { scene } from './scene-setup.js';
+
+export const EARTH_RADIUS = 2.8;
+export const EARTH_Y = 20.0;
+export const EARTH_ROTATION_SPEED = 0.035;
+const EARTH_AXIAL_TILT = 23.4 * (Math.PI / 180);
+
+export const earthGroup = new THREE.Group();
+earthGroup.position.set(0, EARTH_Y, 0);
+earthGroup.rotation.z = EARTH_AXIAL_TILT;
+scene.add(earthGroup);
+
+export const earthSurfaceMat = new THREE.ShaderMaterial({
+  uniforms: {
+    uTime:       { value: 0.0 },
+    uOceanColor: { value: new THREE.Color(0x003d99) },
+    uLandColor:  { value: new THREE.Color(0x1a5c2a) },
+    uGlowColor:  { value: new THREE.Color(NEXUS.colors.accent) },
+  },
+  vertexShader: `
+    varying vec3 vNormal;
+    varying vec3 vWorldPos;
+    varying vec2 vUv;
+    void main() {
+      vNormal   = normalize(normalMatrix * normal);
+      vWorldPos = (modelMatrix * vec4(position, 1.0)).xyz;
+      vUv       = uv;
+      gl_Position = projectionMatrix * modelViewMatrix * vec4(position, 1.0);
+    }
+  `,
+  fragmentShader: `
+    uniform float uTime;
+    uniform vec3  uOceanColor;
+    uniform vec3  uLandColor;
+    uniform vec3  uGlowColor;
+    varying vec3  vNormal;
+    varying vec3  vWorldPos;
+    varying vec2  vUv;
+
+    vec3 _m3(vec3 x){ return x - floor(x*(1./289.))*289.; }
+    vec4 _m4(vec4 x){ return x - floor(x*(1./289.))*289.; }
+    vec4 _p4(vec4 x){ return _m4((x*34.+1.)*x); }
+    float snoise(vec3 v){
+      const vec2 C = vec2(1./6., 1./3.);
+      vec3 i  = floor(v + dot(v, C.yyy));
+      vec3 x0 = v - i + dot(i, C.xxx);
+      vec3 g  = step(x0.yzx, x0.xyz);
+      vec3 l  = 1.0 - g;
+      vec3 i1 = min(g.xyz, l.zxy);
+      vec3 i2 = max(g.xyz, l.zxy);
+      vec3 x1 = x0 - i1 + C.xxx;
+      vec3 x2 = x0 - i2 + C.yyy;
+      vec3 x3 = x0 - 0.5;
+      i = _m3(i);
+      vec4 p = _p4(_p4(_p4(
+        i.z+vec4(0.,i1.z,i2.z,1.))+
+        i.y+vec4(0.,i1.y,i2.y,1.))+
+        i.x+vec4(0.,i1.x,i2.x,1.));
+      float n_ = .142857142857;
+      vec3  ns = n_*vec3(2.,0.,-1.)+vec3(0.,-.5,1.);
+      vec4 j  = p - 49.*floor(p*ns.z*ns.z);
+      vec4 x_ = floor(j*ns.z);
+      vec4 y_ = floor(j - 7.*x_);
+      vec4 h  = 1. - abs(x_*(2./7.)) - abs(y_*(2./7.));
+      vec4 b0 = vec4(x_.xy,y_.xy)*(2./7.);
+      vec4 b1 = vec4(x_.zw,y_.zw)*(2./7.);
+      vec4 s0 = floor(b0)*2.+1.; vec4 s1 = floor(b1)*2.+1.;
+      vec4 sh = -step(h, vec4(0.));
+      vec4 a0 = b0.xzyw + s0.xzyw*sh.xxyy;
+      vec4 a1 = b1.xzyw + s1.xzyw*sh.zzww;
+      vec3 p0=vec3(a0.xy,h.x); vec3 p1=vec3(a0.zw,h.y);
+      vec3 p2=vec3(a1.xy,h.z); vec3 p3=vec3(a1.zw,h.w);
+      vec4 nm = max(0.6-vec4(dot(x0,x0),dot(x1,x1),dot(x2,x2),dot(x3,x3)),0.);
+      vec4 nr = 1.79284291400159-0.85373472095314*nm;
+      p0*=nr.x; p1*=nr.y; p2*=nr.z; p3*=nr.w;
+      nm = nm*nm;
+      return 42.*dot(nm*nm, vec4(dot(p0,x0),dot(p1,x1),dot(p2,x2),dot(p3,x3)));
+    }
+
+    void main() {
+      vec3 n  = normalize(vNormal);
+      vec3 vd = normalize(cameraPosition - vWorldPos);
+
+      float lat = (vUv.y - 0.5) * 3.14159265;
+      float lon  = vUv.x * 6.28318530;
+      vec3 sp = vec3(cos(lat)*cos(lon), sin(lat), cos(lat)*sin(lon));
+
+      float c = snoise(sp*1.8)*0.60
+              + snoise(sp*3.6)*0.30
+              + snoise(sp*7.2)*0.10;
+      float land = smoothstep(0.05, 0.30, c);
+
+      vec3 surf = mix(uOceanColor, uLandColor, land);
+      surf = mix(surf, uGlowColor * 0.45, 0.38);
+
+      float scan = 0.5 + 0.5*sin(vUv.y * 220.0 + uTime * 1.8);
+      scan = smoothstep(0.30, 0.70, scan) * 0.14;
+
+      float fresnel = pow(1.0 - max(dot(n, vd), 0.0), 4.0);
+
+      vec3 col = surf + scan*uGlowColor*0.9 + fresnel*uGlowColor*1.5;
+      float alpha = 0.48 + fresnel * 0.42;
+
+      gl_FragColor = vec4(col, alpha);
+    }
+  `,
+  transparent: true,
+  depthWrite: false,
+  side: THREE.FrontSide,
+});
+
+const earthSphere = new THREE.SphereGeometry(EARTH_RADIUS, 64, 32);
+export const earthMesh = new THREE.Mesh(earthSphere, earthSurfaceMat);
+earthMesh.userData.zoomLabel = 'Planet Earth';
+earthGroup.add(earthMesh);
+
+// Lat/lon grid lines
+(function buildEarthGrid() {
+  const lineMat = new THREE.LineBasicMaterial({
+    color: 0x2266bb, transparent: true, opacity: 0.30,
+  });
+  const r = EARTH_RADIUS + 0.015;
+  const SEG = 64;
+
+  for (let lat = -60; lat <= 60; lat += 30) {
+    const phi = lat * (Math.PI / 180);
+    const pts = [];
+    for (let i = 0; i <= SEG; i++) {
+      const th = (i / SEG) * Math.PI * 2;
+      pts.push(new THREE.Vector3(
+        Math.cos(phi) * Math.cos(th) * r,
+        Math.sin(phi) * r,
+        Math.cos(phi) * Math.sin(th) * r
+      ));
+    }
+    earthGroup.add(new THREE.Line(
+      new THREE.BufferGeometry().setFromPoints(pts), lineMat
+    ));
+  }
+
+  for (let lon = 0; lon < 360; lon += 30) {
+    const th = lon * (Math.PI / 180);
+    const pts = [];
+    for (let i = 0; i <= SEG; i++) {
+      const phi = (i / SEG) * Math.PI - Math.PI / 2;
+      pts.push(new THREE.Vector3(
+        Math.cos(phi) * Math.cos(th) * r,
+        Math.sin(phi) * r,
+        Math.cos(phi) * Math.sin(th) * r
+      ));
+    }
+    earthGroup.add(new THREE.Line(
+      new THREE.BufferGeometry().setFromPoints(pts), lineMat
+    ));
+  }
+})();
+
+// Atmosphere shell
+const atmMat = new THREE.MeshBasicMaterial({
+  color: 0x1144cc, transparent: true, opacity: 0.07,
+  side: THREE.BackSide, depthWrite: false, blending: THREE.AdditiveBlending,
+});
+earthGroup.add(new THREE.Mesh(
+  new THREE.SphereGeometry(EARTH_RADIUS * 1.14, 32, 16), atmMat
+));
+
+export const earthGlowLight = new THREE.PointLight(NEXUS.colors.accent, 0.4, 25);
+earthGroup.add(earthGlowLight);
+
+earthGroup.traverse(obj => {
+  if (obj.isMesh || obj.isLine) obj.userData.zoomLabel = 'Planet Earth';
+});
+
+// Tether beam
+(function buildEarthTetherBeam() {
+  const pts = [
+    new THREE.Vector3(0, EARTH_Y - EARTH_RADIUS * 1.15, 0),
+    new THREE.Vector3(0, 0.5, 0),
+  ];
+  const beamGeo = new THREE.BufferGeometry().setFromPoints(pts);
+  const beamMat = new THREE.LineBasicMaterial({
+    color: NEXUS.colors.accent, transparent: true, opacity: 0.08,
+    depthWrite: false, blending: THREE.AdditiveBlending,
+  });
+  scene.add(new THREE.Line(beamGeo, beamMat));
+})();

modules/effects.js

@@ -0,0 +1,211 @@
+// === ENERGY BEAM + SOVEREIGNTY METER + RUNE RING ===
+import * as THREE from 'three';
+import { NEXUS } from './constants.js';
+import { scene } from './scene-setup.js';
+import { S } from './state.js';
+
+// === ENERGY BEAM ===
+const ENERGY_BEAM_RADIUS = 0.2;
+const ENERGY_BEAM_HEIGHT = 50;
+const ENERGY_BEAM_Y = 0;
+const ENERGY_BEAM_X = -10;
+const ENERGY_BEAM_Z = -10;
+
+const energyBeamGeometry = new THREE.CylinderGeometry(ENERGY_BEAM_RADIUS, ENERGY_BEAM_RADIUS * 2.5, ENERGY_BEAM_HEIGHT, 32, 16, true);
+export const energyBeamMaterial = new THREE.MeshBasicMaterial({
+  color: NEXUS.colors.accent,
+  emissive: NEXUS.colors.accent,
+  emissiveIntensity: 0.8,
+  transparent: true,
+  opacity: 0.6,
+  blending: THREE.AdditiveBlending,
+  side: THREE.DoubleSide,
+  depthWrite: false
+});
+const energyBeam = new THREE.Mesh(energyBeamGeometry, energyBeamMaterial);
+energyBeam.position.set(ENERGY_BEAM_X, ENERGY_BEAM_Y + ENERGY_BEAM_HEIGHT / 2, ENERGY_BEAM_Z);
+scene.add(energyBeam);
+
+export function animateEnergyBeam() {
+  S.energyBeamPulse += 0.02;
+  const agentIntensity = S._activeAgentCount === 0 ? 0.1 : Math.min(0.1 + S._activeAgentCount * 0.3, 1.0);
+  const pulseEffect = Math.sin(S.energyBeamPulse) * 0.15 * agentIntensity;
+  energyBeamMaterial.opacity = agentIntensity * 0.6 + pulseEffect;
+}
+
+// === SOVEREIGNTY METER ===
+export const sovereigntyGroup = new THREE.Group();
+sovereigntyGroup.position.set(0, 3.8, 0);
+
+const meterBgGeo = new THREE.TorusGeometry(1.6, 0.1, 8, 64);
+const meterBgMat = new THREE.MeshBasicMaterial({ color: 0x0a1828, transparent: true, opacity: 0.5 });
+sovereigntyGroup.add(new THREE.Mesh(meterBgGeo, meterBgMat));
+
+function sovereigntyHexColor(score) {
+  if (score >= 80) return 0x00ff88;
+  if (score >= 40) return 0xffcc00;
+  return 0xff4444;
+}
+
+function buildScoreArcGeo(score) {
+  return new THREE.TorusGeometry(1.6, 0.1, 8, 64, (score / 100) * Math.PI * 2);
+}
+
+const scoreArcMat = new THREE.MeshBasicMaterial({
+  color: sovereigntyHexColor(S.sovereigntyScore),
+  transparent: true,
+  opacity: 0.9,
+});
+const scoreArcMesh = new THREE.Mesh(buildScoreArcGeo(S.sovereigntyScore), scoreArcMat);
+scoreArcMesh.rotation.z = Math.PI / 2;
+sovereigntyGroup.add(scoreArcMesh);
+
+export const meterLight = new THREE.PointLight(sovereigntyHexColor(S.sovereigntyScore), 0.7, 6);
+sovereigntyGroup.add(meterLight);
+
+function buildMeterTexture(score, label, assessmentType) {
+  const canvas = document.createElement('canvas');
+  canvas.width = 256;
+  canvas.height = 128;
+  const ctx = canvas.getContext('2d');
+  const hexStr = score >= 80 ? '#00ff88' : score >= 40 ? '#ffcc00' : '#ff4444';
+  ctx.clearRect(0, 0, 256, 128);
+  ctx.font = 'bold 52px "Courier New", monospace';
+  ctx.fillStyle = hexStr;
+  ctx.textAlign = 'center';
+  ctx.fillText(`${score}%`, 128, 50);
+  ctx.font = '16px "Courier New", monospace';
+  ctx.fillStyle = '#8899bb';
+  ctx.fillText(label.toUpperCase(), 128, 74);
+  ctx.font = '11px "Courier New", monospace';
+  ctx.fillStyle = '#445566';
+  ctx.fillText('SOVEREIGNTY', 128, 94);
+  ctx.font = '9px "Courier New", monospace';
+  ctx.fillStyle = '#334455';
+  ctx.fillText(assessmentType === 'MANUAL' ? 'MANUAL ASSESSMENT' : 'MANUAL ASSESSMENT', 128, 112);
+  return new THREE.CanvasTexture(canvas);
+}
+
+const meterSpriteMat = new THREE.SpriteMaterial({
+  map: buildMeterTexture(S.sovereigntyScore, S.sovereigntyLabel, 'MANUAL'),
+  transparent: true,
+  depthWrite: false,
+});
+const meterSprite = new THREE.Sprite(meterSpriteMat);
+meterSprite.scale.set(3.2, 1.6, 1);
+sovereigntyGroup.add(meterSprite);
+
+scene.add(sovereigntyGroup);
+sovereigntyGroup.traverse(obj => {
+  if (obj.isMesh || obj.isSprite) obj.userData.zoomLabel = 'Sovereignty Meter';
+});
+
+export async function loadSovereigntyStatus() {
+  try {
+    const res = await fetch('./sovereignty-status.json');
+    if (!res.ok) throw new Error('not found');
+    const data = await res.json();
+    const score = Math.max(0, Math.min(100, typeof data.score === 'number' ? data.score : 85));
+    const label = typeof data.label === 'string' ? data.label : '';
+    S.sovereigntyScore = score;
+    S.sovereigntyLabel = label;
+    scoreArcMesh.geometry.dispose();
+    scoreArcMesh.geometry = buildScoreArcGeo(score);
+    const col = sovereigntyHexColor(score);
+    scoreArcMat.color.setHex(col);
+    meterLight.color.setHex(col);
+    if (meterSpriteMat.map) meterSpriteMat.map.dispose();
+    const assessmentType = data.assessment_type || 'MANUAL';
+    meterSpriteMat.map = buildMeterTexture(score, label, assessmentType);
+    meterSpriteMat.needsUpdate = true;
+  } catch {
+    // defaults already set
+  }
+}
+
+loadSovereigntyStatus();
+
+// === RUNE RING ===
+let RUNE_COUNT = 12;
+const RUNE_RING_RADIUS = 7.0;
+export const RUNE_RING_Y = 1.5;
+export const RUNE_ORBIT_SPEED = 0.08;
+
+const ELDER_FUTHARK = ['ᚠ','ᚢ','ᚦ','ᚨ','ᚱ','ᚲ','ᚷ','ᚹ','ᚺ','ᚾ','ᛁ','ᛃ'];
+const RUNE_GLOW_COLORS = ['#00ffcc', '#ff44ff'];
+
+function createRuneTexture(glyph, color) {
+  const W = 128, H = 128;
+  const canvas = document.createElement('canvas');
+  canvas.width = W;
+  canvas.height = H;
+  const ctx = canvas.getContext('2d');
+
+  ctx.clearRect(0, 0, W, H);
+  ctx.shadowColor = color;
+  ctx.shadowBlur = 28;
+  ctx.font = 'bold 78px serif';
+  ctx.fillStyle = color;
+  ctx.textAlign = 'center';
+  ctx.textBaseline = 'middle';
+  ctx.fillText(glyph, W / 2, H / 2);
+
+  return new THREE.CanvasTexture(canvas);
+}
+
+const runeOrbitRingGeo = new THREE.TorusGeometry(RUNE_RING_RADIUS, 0.03, 6, 64);
+const runeOrbitRingMat = new THREE.MeshBasicMaterial({
+  color: 0x224466, transparent: true, opacity: 0.22,
+});
+const runeOrbitRingMesh = new THREE.Mesh(runeOrbitRingGeo, runeOrbitRingMat);
+runeOrbitRingMesh.rotation.x = Math.PI / 2;
+runeOrbitRingMesh.position.y = RUNE_RING_Y;
+scene.add(runeOrbitRingMesh);
+
+/** @type {Array<{sprite: THREE.Sprite, baseAngle: number, floatPhase: number, portalOnline: boolean}>} */
+export const runeSprites = [];
+
+// portals ref — set from portals module
+let _portalsRef = [];
+export function setPortalsRef(ref) { _portalsRef = ref; }
+export function getPortalsRef() { return _portalsRef; }
+
+export function rebuildRuneRing() {
+  for (const rune of runeSprites) {
+    scene.remove(rune.sprite);
+    if (rune.sprite.material.map) rune.sprite.material.map.dispose();
+    rune.sprite.material.dispose();
+  }
+  runeSprites.length = 0;
+
+  const portalData = _portalsRef.length > 0 ? _portalsRef : null;
+  const count = portalData ? portalData.length : RUNE_COUNT;
+
+  for (let i = 0; i < count; i++) {
+    const glyph = ELDER_FUTHARK[i % ELDER_FUTHARK.length];
+    const color = portalData ? portalData[i].color : RUNE_GLOW_COLORS[i % RUNE_GLOW_COLORS.length];
+    const isOnline = portalData ? portalData[i].status === 'online' : true;
+    const texture = createRuneTexture(glyph, color);
+
+    const runeMat = new THREE.SpriteMaterial({
+      map: texture,
+      transparent: true,
+      opacity: isOnline ? 1.0 : 0.15,
+      depthWrite: false,
+      blending: THREE.AdditiveBlending,
+    });
+    const sprite = new THREE.Sprite(runeMat);
+    sprite.scale.set(1.3, 1.3, 1);
+
+    const baseAngle = (i / count) * Math.PI * 2;
+    sprite.position.set(
+      Math.cos(baseAngle) * RUNE_RING_RADIUS,
+      RUNE_RING_Y,
+      Math.sin(baseAngle) * RUNE_RING_RADIUS
+    );
+    scene.add(sprite);
+    runeSprites.push({ sprite, baseAngle, floatPhase: (i / count) * Math.PI * 2, portalOnline: isOnline });
+  }
+}
+
+rebuildRuneRing();

modules/effects/energy-beam.js

@@ -1,56 +0,0 @@
-/**
- * energy-beam.js — Vertical energy beam above the Batcave terminal
- *
- * Category: DATA-TETHERED AESTHETIC
- * Data source: state.activeAgentCount (0 = faint, 3+ = full intensity)
- *
- * A glowing cyan cylinder rising from the Batcave area.
- * Intensity and pulse amplitude are driven by the number of active agents.
- */
-
-import * as THREE from 'three';
-
-const BEAM_RADIUS   = 0.2;
-const BEAM_HEIGHT   = 50;
-const BEAM_X        = -10;
-const BEAM_Y        =  0;
-const BEAM_Z        = -10;
-
-let _state = null;
-let _beamMaterial = null;
-let _pulse = 0;
-
-/**
- * @param {THREE.Scene} scene
- * @param {object} state  Shared state bus (reads state.activeAgentCount)
- * @param {object} theme  Theme bus (reads theme.colors.accent)
- */
-export function init(scene, state, theme) {
-  _state = state;
-
-  const accentColor = theme?.colors?.accent ?? 0x4488ff;
-
-  const geo = new THREE.CylinderGeometry(BEAM_RADIUS, BEAM_RADIUS * 2.5, BEAM_HEIGHT, 32, 16, true);
-  _beamMaterial = new THREE.MeshBasicMaterial({
-    color: accentColor,
-    transparent: true,
-    opacity: 0.6,
-    blending: THREE.AdditiveBlending,
-    side: THREE.DoubleSide,
-    depthWrite: false,
-  });
-  const beam = new THREE.Mesh(geo, _beamMaterial);
-  beam.position.set(BEAM_X, BEAM_Y + BEAM_HEIGHT / 2, BEAM_Z);
-  scene.add(beam);
-}
-
-export function update(_elapsed, _delta) {
-  if (!_beamMaterial) return;
-
-  _pulse += 0.02;
-
-  const agentCount = _state?.activeAgentCount ?? 0;
-  const agentIntensity = agentCount === 0 ? 0.1 : Math.min(0.1 + agentCount * 0.3, 1.0);
-  const pulseEffect = Math.sin(_pulse) * 0.15 * agentIntensity;
-  _beamMaterial.opacity = agentIntensity * 0.6 + pulseEffect;
-}

modules/effects/gravity-zones.js

@@ -1,176 +0,0 @@
-/**
- * gravity-zones.js — Rising particle gravity anomaly zones
- *
- * Category: DATA-TETHERED AESTHETIC
- * Data source: state.portals (positions and online status)
- *
- * Each gravity zone is a glowing floor ring with rising particle streams.
- * Zones are initially placed at hardcoded positions, then realigned to portal
- * positions when portal data loads. Online portals have brighter/faster anomalies;
- * offline portals have dim, slow anomalies.
- */
-
-import * as THREE from 'three';
-
-const ANOMALY_FLOOR = 0.2;
-const ANOMALY_CEIL  = 16.0;
-
-const DEFAULT_ZONES = [
-  { x: -8, z: -6, radius: 3.5, color: 0x00ffcc, particleCount: 180 },
-  { x: 10, z:  4, radius: 3.0, color: 0xaa44ff, particleCount: 160 },
-  { x: -3, z:  9, radius: 2.5, color: 0xff8844, particleCount: 140 },
-];
-
-let _state  = null;
-let _scene  = null;
-let _portalsApplied = false;
-
-/**
- * @typedef {{
- *   zone: object,
- *   ring: THREE.Mesh, ringMat: THREE.MeshBasicMaterial,
- *   disc: THREE.Mesh, discMat: THREE.MeshBasicMaterial,
- *   points: THREE.Points, geo: THREE.BufferGeometry,
- *   driftPhases: Float32Array, velocities: Float32Array
- * }} GravityZoneObject
- */
-
-/** @type {GravityZoneObject[]} */
-const gravityZoneObjects = [];
-
-function _buildZone(zone) {
-  const ringGeo = new THREE.RingGeometry(zone.radius - 0.15, zone.radius + 0.15, 64);
-  const ringMat = new THREE.MeshBasicMaterial({
-    color: zone.color, transparent: true, opacity: 0.4,
-    side: THREE.DoubleSide, depthWrite: false,
-  });
-  const ring = new THREE.Mesh(ringGeo, ringMat);
-  ring.rotation.x = -Math.PI / 2;
-  ring.position.set(zone.x, ANOMALY_FLOOR + 0.05, zone.z);
-  _scene.add(ring);
-
-  const discGeo = new THREE.CircleGeometry(zone.radius - 0.15, 64);
-  const discMat = new THREE.MeshBasicMaterial({
-    color: zone.color, transparent: true, opacity: 0.04,
-    side: THREE.DoubleSide, depthWrite: false,
-  });
-  const disc = new THREE.Mesh(discGeo, discMat);
-  disc.rotation.x = -Math.PI / 2;
-  disc.position.set(zone.x, ANOMALY_FLOOR + 0.04, zone.z);
-  _scene.add(disc);
-
-  const count      = zone.particleCount;
-  const positions  = new Float32Array(count * 3);
-  const driftPhases = new Float32Array(count);
-  const velocities  = new Float32Array(count);
-
-  for (let i = 0; i < count; i++) {
-    const angle = Math.random() * Math.PI * 2;
-    const r = Math.sqrt(Math.random()) * zone.radius;
-    positions[i * 3]     = zone.x + Math.cos(angle) * r;
-    positions[i * 3 + 1] = ANOMALY_FLOOR + Math.random() * (ANOMALY_CEIL - ANOMALY_FLOOR);
-    positions[i * 3 + 2] = zone.z + Math.sin(angle) * r;
-    driftPhases[i] = Math.random() * Math.PI * 2;
-    velocities[i]  = 0.03 + Math.random() * 0.04;
-  }
-
-  const geo = new THREE.BufferGeometry();
-  geo.setAttribute('position', new THREE.BufferAttribute(positions, 3));
-  const mat = new THREE.PointsMaterial({
-    color: zone.color, size: 0.10, sizeAttenuation: true,
-    transparent: true, opacity: 0.7, depthWrite: false,
-  });
-  const points = new THREE.Points(geo, mat);
-  _scene.add(points);
-
-  return { zone: { ...zone }, ring, ringMat, disc, discMat, points, geo, driftPhases, velocities };
-}
-
-/**
- * @param {THREE.Scene} scene
- * @param {object} state  Shared state bus (reads state.portals)
- * @param {object} _theme
- */
-export function init(scene, state, _theme) {
-  _scene = scene;
-  _state = state;
-
-  for (const zone of DEFAULT_ZONES) {
-    gravityZoneObjects.push(_buildZone(zone));
-  }
-}
-
-function _applyPortals(portals) {
-  _portalsApplied = true;
-  for (let i = 0; i < Math.min(portals.length, gravityZoneObjects.length); i++) {
-    const portal   = portals[i];
-    const gz       = gravityZoneObjects[i];
-    const isOnline = portal.status === 'online';
-    const c        = new THREE.Color(portal.color);
-
-    gz.ring.position.set(portal.position.x, ANOMALY_FLOOR + 0.05, portal.position.z);
-    gz.disc.position.set(portal.position.x, ANOMALY_FLOOR + 0.04, portal.position.z);
-    gz.zone.x = portal.position.x;
-    gz.zone.z = portal.position.z;
-    gz.zone.color = c.getHex();
-
-    gz.ringMat.color.copy(c);
-    gz.discMat.color.copy(c);
-    gz.points.material.color.copy(c);
-
-    gz.ringMat.opacity           = isOnline ? 0.4  : 0.08;
-    gz.discMat.opacity           = isOnline ? 0.04 : 0.01;
-    gz.points.material.opacity   = isOnline ? 0.7  : 0.15;
-
-    // Reposition particles around portal
-    const pos = gz.geo.attributes.position.array;
-    for (let j = 0; j < gz.zone.particleCount; j++) {
-      const angle = Math.random() * Math.PI * 2;
-      const r = Math.sqrt(Math.random()) * gz.zone.radius;
-      pos[j * 3]     = gz.zone.x + Math.cos(angle) * r;
-      pos[j * 3 + 2] = gz.zone.z + Math.sin(angle) * r;
-    }
-    gz.geo.attributes.position.needsUpdate = true;
-  }
-}
-
-export function update(elapsed, _delta) {
-  // Align to portal data once it loads
-  if (!_portalsApplied) {
-    const portals = _state?.portals ?? [];
-    if (portals.length > 0) _applyPortals(portals);
-  }
-
-  for (const gz of gravityZoneObjects) {
-    const pos   = gz.geo.attributes.position.array;
-    const count = gz.zone.particleCount;
-
-    for (let i = 0; i < count; i++) {
-      pos[i * 3 + 1] += gz.velocities[i];
-      pos[i * 3]     += Math.sin(elapsed * 0.5 + gz.driftPhases[i]) * 0.003;
-      pos[i * 3 + 2] += Math.cos(elapsed * 0.5 + gz.driftPhases[i]) * 0.003;
-
-      if (pos[i * 3 + 1] > ANOMALY_CEIL) {
-        const angle = Math.random() * Math.PI * 2;
-        const r = Math.sqrt(Math.random()) * gz.zone.radius;
-        pos[i * 3]     = gz.zone.x + Math.cos(angle) * r;
-        pos[i * 3 + 1] = ANOMALY_FLOOR + Math.random() * 2.0;
-        pos[i * 3 + 2] = gz.zone.z + Math.sin(angle) * r;
-      }
-    }
-    gz.geo.attributes.position.needsUpdate = true;
-
-    // Breathing glow pulse on ring/disc
-    gz.ringMat.opacity = 0.3 + Math.sin(elapsed * 1.5 + gz.zone.x) * 0.15;
-    gz.discMat.opacity = 0.02 + Math.sin(elapsed * 1.5 + gz.zone.x) * 0.02;
-  }
-}
-
-/**
- * Re-align zones to current portal data.
- * Call after portal health check updates portal statuses.
- */
-export function rebuildFromPortals() {
-  const portals = _state?.portals ?? [];
-  if (portals.length > 0) _applyPortals(portals);
-}

modules/effects/lightning.js

@@ -1,196 +0,0 @@
-/**
- * lightning.js — Floating crystals and lightning arcs between them
- *
- * Category: DATA-TETHERED AESTHETIC
- * Data source: state.zoneIntensity (commit activity drives arc count + intensity)
- *
- * Five octahedral crystals float above the platform. Lightning arcs jump
- * between them when zone activity is high. Crystal count and colors are
- * aligned to the five agent zones.
- */
-
-import * as THREE from 'three';
-
-const CRYSTAL_COUNT = 5;
-const CRYSTAL_BASE_POSITIONS = [
-  new THREE.Vector3(-4.5, 3.2, -3.8),
-  new THREE.Vector3( 4.8, 2.8, -4.0),
-  new THREE.Vector3(-5.5, 4.0,  1.5),
-  new THREE.Vector3( 5.2, 3.5,  2.0),
-  new THREE.Vector3( 0.0, 5.0, -5.5),
-];
-// Zone colors: Claude, Timmy, Kimi, Perplexity, center
-const CRYSTAL_COLORS = [0xff6440, 0x40a0ff, 0x40ff8c, 0xc840ff, 0xffd700];
-
-const LIGHTNING_POOL_SIZE = 6;
-const LIGHTNING_SEGMENTS = 8;
-const LIGHTNING_REFRESH_MS = 130;
-
-let _state = null;
-
-/** @type {THREE.Scene|null} */
-let _scene = null;
-
-/** @type {Array<{mesh: THREE.Mesh, light: THREE.PointLight, basePos: THREE.Vector3, floatPhase: number, flashStartTime: number}>} */
-const crystals = [];
-
-/** @type {THREE.Line[]} */
-const lightningArcs = [];
-
-/** @type {Array<{active: boolean, baseOpacity: number, srcIdx: number, dstIdx: number}>} */
-const lightningArcMeta = [];
-
-let _lastLightningRefreshTime = 0;
-
-function _totalActivity() {
-  if (!_state) return 0;
-  if (typeof _state.totalActivity === 'function') return _state.totalActivity();
-  const zi = _state.zoneIntensity;
-  if (!zi) return 0;
-  const vals = Object.values(zi);
-  return vals.reduce((s, v) => s + v, 0) / Math.max(vals.length, 1);
-}
-
-function _lerpColor(colorA, colorB, t) {
-  const ar = (colorA >> 16) & 0xff, ag = (colorA >> 8) & 0xff, ab = colorA & 0xff;
-  const br = (colorB >> 16) & 0xff, bg = (colorB >> 8) & 0xff, bb = colorB & 0xff;
-  return (Math.round(ar + (br - ar) * t) << 16) |
-         (Math.round(ag + (bg - ag) * t) << 8) |
-          Math.round(ab + (bb - ab) * t);
-}
-
-function _buildLightningPath(start, end, jagAmount) {
-  const out = new Float32Array((LIGHTNING_SEGMENTS + 1) * 3);
-  for (let s = 0; s <= LIGHTNING_SEGMENTS; s++) {
-    const t = s / LIGHTNING_SEGMENTS;
-    const jag = s > 0 && s < LIGHTNING_SEGMENTS ? (Math.random() - 0.5) * jagAmount : 0;
-    out[s * 3]     = start.x + (end.x - start.x) * t + jag;
-    out[s * 3 + 1] = start.y + (end.y - start.y) * t + jag;
-    out[s * 3 + 2] = start.z + (end.z - start.z) * t + jag;
-  }
-  return out;
-}
-
-/**
- * @param {THREE.Scene} scene
- * @param {object} state  Shared state bus (reads state.zoneIntensity)
- * @param {object} _theme
- */
-export function init(scene, state, _theme) {
-  _scene = scene;
-  _state = state;
-
-  const crystalGroup = new THREE.Group();
-  scene.add(crystalGroup);
-
-  for (let i = 0; i < CRYSTAL_COUNT; i++) {
-    const geo = new THREE.OctahedronGeometry(0.35, 0);
-    const color = CRYSTAL_COLORS[i];
-    const mat = new THREE.MeshStandardMaterial({
-      color,
-      emissive: new THREE.Color(color).multiplyScalar(0.6),
-      roughness: 0.05,
-      metalness: 0.3,
-      transparent: true,
-      opacity: 0.88,
-    });
-    const mesh = new THREE.Mesh(geo, mat);
-    const basePos = CRYSTAL_BASE_POSITIONS[i].clone();
-    mesh.position.copy(basePos);
-    mesh.userData.zoomLabel = 'Crystal';
-    crystalGroup.add(mesh);
-
-    const light = new THREE.PointLight(color, 0.3, 6);
-    light.position.copy(basePos);
-    crystalGroup.add(light);
-
-    crystals.push({ mesh, light, basePos, floatPhase: (i / CRYSTAL_COUNT) * Math.PI * 2, flashStartTime: -999 });
-  }
-
-  // Pre-allocate lightning arc pool
-  for (let i = 0; i < LIGHTNING_POOL_SIZE; i++) {
-    const positions = new Float32Array((LIGHTNING_SEGMENTS + 1) * 3);
-    const geo = new THREE.BufferGeometry();
-    geo.setAttribute('position', new THREE.BufferAttribute(positions, 3));
-    const mat = new THREE.LineBasicMaterial({
-      color: 0x88ccff,
-      transparent: true,
-      opacity: 0.0,
-      blending: THREE.AdditiveBlending,
-      depthWrite: false,
-    });
-    const arc = new THREE.Line(geo, mat);
-    scene.add(arc);
-    lightningArcs.push(arc);
-    lightningArcMeta.push({ active: false, baseOpacity: 0, srcIdx: 0, dstIdx: 0 });
-  }
-}
-
-function _refreshLightningArcs(elapsed) {
-  const activity = _totalActivity();
-  const activeCount = Math.round(activity * LIGHTNING_POOL_SIZE);
-
-  for (let i = 0; i < LIGHTNING_POOL_SIZE; i++) {
-    const arc = lightningArcs[i];
-    const meta = lightningArcMeta[i];
-    if (i >= activeCount) {
-      arc.material.opacity = 0;
-      meta.active = false;
-      continue;
-    }
-
-    const a = Math.floor(Math.random() * CRYSTAL_COUNT);
-    let b = Math.floor(Math.random() * (CRYSTAL_COUNT - 1));
-    if (b >= a) b++;
-
-    const jagAmount = 0.45 + activity * 0.85;
-    const path = _buildLightningPath(crystals[a].mesh.position, crystals[b].mesh.position, jagAmount);
-    const attr = arc.geometry.attributes.position;
-    attr.array.set(path);
-    attr.needsUpdate = true;
-
-    arc.material.color.setHex(_lerpColor(CRYSTAL_COLORS[a], CRYSTAL_COLORS[b], 0.5));
-    const base = (0.35 + Math.random() * 0.55) * Math.min(activity * 1.5, 1.0);
-    arc.material.opacity = base;
-    meta.active = true;
-    meta.baseOpacity = base;
-    meta.srcIdx = a;
-    meta.dstIdx = b;
-
-    crystals[a].flashStartTime = elapsed;
-    crystals[b].flashStartTime = elapsed;
-  }
-}
-
-export function update(elapsed, _delta) {
-  const activity = _totalActivity();
-
-  // Float crystals
-  for (let i = 0; i < crystals.length; i++) {
-    const c = crystals[i];
-    c.mesh.position.y = c.basePos.y + Math.sin(elapsed * 0.7 + c.floatPhase) * 0.3;
-    c.light.position.y = c.mesh.position.y;
-
-    // Brief emissive flash on lightning strike
-    const flashAge = elapsed - c.flashStartTime;
-    const flashIntensity = flashAge < 0.15 ? (1.0 - flashAge / 0.15) : 0;
-    c.mesh.material.emissiveIntensity = 0.6 + flashIntensity * 1.2;
-    c.light.intensity = 0.3 + flashIntensity * 1.5;
-
-    // Color intensity tethered to total activity
-    c.mesh.material.opacity = 0.7 + activity * 0.18;
-  }
-
-  // Flicker active arcs
-  for (let i = 0; i < lightningArcMeta.length; i++) {
-    const meta = lightningArcMeta[i];
-    if (!meta.active) continue;
-    lightningArcs[i].material.opacity = meta.baseOpacity * (0.7 + Math.random() * 0.3);
-  }
-
-  // Periodically rebuild arcs
-  if (elapsed * 1000 - _lastLightningRefreshTime > LIGHTNING_REFRESH_MS) {
-    _lastLightningRefreshTime = elapsed * 1000;
-    _refreshLightningArcs(elapsed);
-  }
-}

modules/effects/matrix-rain.js

@@ -1,106 +0,0 @@
-/**
- * matrix-rain.js — Commit-density-driven 2D canvas matrix rain
- *
- * Category: DATA-TETHERED AESTHETIC
- * Data source: state.zoneIntensity (commit activity) + state.commitHashes
- *
- * Renders a Katakana/hex character rain behind the Three.js canvas.
- * Density and speed are tethered to commit zone activity.
- * Real commit hashes are occasionally injected as characters.
- */
-
-const MATRIX_CHARS = 'アイウエオカキクケコサシスセソタチツテトナニヌネノハヒフヘホマミムメモヤユヨラリルレロワヲン0123456789ABCDEF';
-const MATRIX_FONT_SIZE = 14;
-
-let _state = null;
-let _canvas = null;
-let _ctx = null;
-let _drops = [];
-
-/**
- * Computes mean activity [0..1] across all agent zones via state.
- * @returns {number}
- */
-function _totalActivity() {
-  if (!_state) return 0;
-  if (typeof _state.totalActivity === 'function') return _state.totalActivity();
-  const zi = _state.zoneIntensity;
-  if (!zi) return 0;
-  const vals = Object.values(zi);
-  return vals.reduce((s, v) => s + v, 0) / Math.max(vals.length, 1);
-}
-
-function _draw() {
-  if (!_canvas || !_ctx) return;
-  const activity = _totalActivity();
-  const commitHashes = _state?.commitHashes ?? [];
-
-  // Fade previous frame — creates the trailing glow
-  _ctx.fillStyle = 'rgba(0, 0, 8, 0.05)';
-  _ctx.fillRect(0, 0, _canvas.width, _canvas.height);
-
-  _ctx.font = `${MATRIX_FONT_SIZE}px monospace`;
-
-  const density = 0.1 + activity * 0.9;
-  const activeColCount = Math.max(1, Math.floor(_drops.length * density));
-
-  for (let i = 0; i < _drops.length; i++) {
-    if (i >= activeColCount) {
-      if (_drops[i] * MATRIX_FONT_SIZE > _canvas.height) continue;
-    }
-
-    let char;
-    if (commitHashes.length > 0 && Math.random() < 0.02) {
-      const hash = commitHashes[Math.floor(Math.random() * commitHashes.length)];
-      char = hash[Math.floor(Math.random() * hash.length)];
-    } else {
-      char = MATRIX_CHARS[Math.floor(Math.random() * MATRIX_CHARS.length)];
-    }
-
-    _ctx.fillStyle = '#aaffaa';
-    _ctx.fillText(char, i * MATRIX_FONT_SIZE, _drops[i] * MATRIX_FONT_SIZE);
-
-    const resetThreshold = 0.975 - activity * 0.015;
-    if (_drops[i] * MATRIX_FONT_SIZE > _canvas.height && Math.random() > resetThreshold) {
-      _drops[i] = 0;
-    }
-    _drops[i]++;
-  }
-}
-
-function _resetDrops() {
-  const colCount = Math.floor(window.innerWidth / MATRIX_FONT_SIZE);
-  _drops = new Array(colCount).fill(1);
-}
-
-/**
- * @param {THREE.Scene} _scene  (unused — 2D canvas effect)
- * @param {object} state        Shared state bus
- * @param {object} _theme       (unused — color is hardcoded green for matrix aesthetic)
- */
-export function init(_scene, state, _theme) {
-  _state = state;
-
-  _canvas = document.createElement('canvas');
-  _canvas.id = 'matrix-rain';
-  _canvas.width = window.innerWidth;
-  _canvas.height = window.innerHeight;
-  document.body.appendChild(_canvas);
-
-  _ctx = _canvas.getContext('2d');
-  _resetDrops();
-
-  window.addEventListener('resize', () => {
-    _canvas.width = window.innerWidth;
-    _canvas.height = window.innerHeight;
-    _resetDrops();
-  });
-
-  // Run at ~20 fps independent of the Three.js RAF loop
-  setInterval(_draw, 50);
-}
-
-/**
- * update() is a no-op — rain runs on its own setInterval.
- */
-export function update(_elapsed, _delta) {}

modules/effects/rune-ring.js

@@ -1,138 +0,0 @@
-/**
- * rune-ring.js — Orbiting Elder Futhark rune sprites
- *
- * Category: DATA-TETHERED AESTHETIC
- * Data source: state.portals (count, colors, and online status from portals.json)
- *
- * Rune sprites orbit the scene in a ring. Count matches the portal count,
- * colors come from portal colors, and brightness reflects portal online status.
- * A faint torus marks the orbit track.
- */
-
-import * as THREE from 'three';
-
-const RUNE_RING_RADIUS  = 7.0;
-const RUNE_RING_Y       = 1.5;
-const RUNE_ORBIT_SPEED  = 0.08; // radians per second
-const DEFAULT_RUNE_COUNT = 12;
-
-const ELDER_FUTHARK  = ['ᚠ','ᚢ','ᚦ','ᚨ','ᚱ','ᚲ','ᚷ','ᚹ','ᚺ','ᚾ','ᛁ','ᛃ'];
-const FALLBACK_COLORS = ['#00ffcc', '#ff44ff'];
-
-let _scene  = null;
-let _state  = null;
-
-/** @type {Array<{sprite: THREE.Sprite, baseAngle: number, floatPhase: number, portalOnline: boolean}>} */
-const runeSprites = [];
-
-let _orbitRingMesh = null;
-let _builtForPortalCount = -1;
-
-function _createRuneTexture(glyph, color) {
-  const W = 128, H = 128;
-  const canvas = document.createElement('canvas');
-  canvas.width = W;
-  canvas.height = H;
-  const ctx = canvas.getContext('2d');
-  ctx.clearRect(0, 0, W, H);
-  ctx.shadowColor = color;
-  ctx.shadowBlur = 28;
-  ctx.font = 'bold 78px serif';
-  ctx.fillStyle = color;
-  ctx.textAlign = 'center';
-  ctx.textBaseline = 'middle';
-  ctx.fillText(glyph, W / 2, H / 2);
-  return new THREE.CanvasTexture(canvas);
-}
-
-function _clearSprites() {
-  for (const rune of runeSprites) {
-    _scene.remove(rune.sprite);
-    if (rune.sprite.material.map) rune.sprite.material.map.dispose();
-    rune.sprite.material.dispose();
-  }
-  runeSprites.length = 0;
-}
-
-function _build(portals) {
-  _clearSprites();
-
-  const count  = portals ? portals.length : DEFAULT_RUNE_COUNT;
-  _builtForPortalCount = count;
-
-  for (let i = 0; i < count; i++) {
-    const glyph    = ELDER_FUTHARK[i % ELDER_FUTHARK.length];
-    const color    = portals ? portals[i].color : FALLBACK_COLORS[i % FALLBACK_COLORS.length];
-    const isOnline = portals ? portals[i].status === 'online' : true;
-    const texture  = _createRuneTexture(glyph, color);
-
-    const mat = new THREE.SpriteMaterial({
-      map: texture,
-      transparent: true,
-      opacity: isOnline ? 1.0 : 0.15,
-      depthWrite: false,
-      blending: THREE.AdditiveBlending,
-    });
-    const sprite = new THREE.Sprite(mat);
-    sprite.scale.set(1.3, 1.3, 1);
-
-    const baseAngle = (i / count) * Math.PI * 2;
-    sprite.position.set(
-      Math.cos(baseAngle) * RUNE_RING_RADIUS,
-      RUNE_RING_Y,
-      Math.sin(baseAngle) * RUNE_RING_RADIUS
-    );
-    _scene.add(sprite);
-    runeSprites.push({ sprite, baseAngle, floatPhase: (i / count) * Math.PI * 2, portalOnline: isOnline });
-  }
-}
-
-/**
- * @param {THREE.Scene} scene
- * @param {object} state  Shared state bus (reads state.portals)
- * @param {object} _theme
- */
-export function init(scene, state, _theme) {
-  _scene = scene;
-  _state = state;
-
-  // Faint orbit track torus
-  const ringGeo = new THREE.TorusGeometry(RUNE_RING_RADIUS, 0.03, 6, 64);
-  const ringMat = new THREE.MeshBasicMaterial({ color: 0x224466, transparent: true, opacity: 0.22 });
-  _orbitRingMesh = new THREE.Mesh(ringGeo, ringMat);
-  _orbitRingMesh.rotation.x = Math.PI / 2;
-  _orbitRingMesh.position.y = RUNE_RING_Y;
-  scene.add(_orbitRingMesh);
-
-  // Initial build with defaults — will be rebuilt when portals load
-  _build(null);
-}
-
-export function update(elapsed, _delta) {
-  // Rebuild rune sprites when portal data changes
-  const portals = _state?.portals ?? [];
-  if (portals.length > 0 && portals.length !== _builtForPortalCount) {
-    _build(portals);
-  }
-
-  // Orbit and float
-  for (const rune of runeSprites) {
-    const angle = rune.baseAngle + elapsed * RUNE_ORBIT_SPEED;
-    rune.sprite.position.x = Math.cos(angle) * RUNE_RING_RADIUS;
-    rune.sprite.position.z = Math.sin(angle) * RUNE_RING_RADIUS;
-    rune.sprite.position.y = RUNE_RING_Y + Math.sin(elapsed * 0.7 + rune.floatPhase) * 0.4;
-
-    const baseOpacity  = rune.portalOnline ? 0.85 : 0.12;
-    const pulseRange   = rune.portalOnline ? 0.15 : 0.03;
-    rune.sprite.material.opacity = baseOpacity + Math.sin(elapsed * 1.2 + rune.floatPhase) * pulseRange;
-  }
-}
-
-/**
- * Force a rebuild from current portal data.
- * Called externally after portal health checks update statuses.
- */
-export function rebuild() {
-  const portals = _state?.portals ?? [];
-  _build(portals.length > 0 ? portals : null);
-}

modules/effects/shockwave.js

@@ -1,183 +0,0 @@
-/**
- * shockwave.js — Shockwave ripple, fireworks, and merge flash
- *
- * Category: DATA-TETHERED AESTHETIC
- * Data source: PR merge events (WebSocket/event dispatch)
- *
- * Triggered externally on merge events:
- *   - triggerShockwave()  — expanding concentric ring waves from scene centre
- *   - triggerFireworks()  — multi-burst particle fireworks above the platform
- *   - triggerMergeFlash() — both of the above + star/constellation color flash
- *
- * The merge flash accepts optional callbacks so terrain/stars.js can own
- * its own state while shockwave.js coordinates the event.
- */
-
-import * as THREE from 'three';
-
-const SHOCKWAVE_RING_COUNT  = 3;
-const SHOCKWAVE_MAX_RADIUS  = 14;
-const SHOCKWAVE_DURATION    = 2.5; // seconds
-
-const FIREWORK_COLORS = [0xff4466, 0xffaa00, 0x00ffaa, 0x4488ff, 0xff44ff, 0xffff44, 0x00ffff];
-const FIREWORK_BURST_PARTICLES = 80;
-const FIREWORK_BURST_DURATION  = 2.2; // seconds
-const FIREWORK_GRAVITY         = -5.0;
-
-let _scene  = null;
-let _clock  = null;
-
-/**
- * @typedef {{mesh: THREE.Mesh, mat: THREE.MeshBasicMaterial, startTime: number, delay: number}} ShockwaveRing
- * @typedef {{points: THREE.Points, geo: THREE.BufferGeometry, mat: THREE.PointsMaterial, origins: Float32Array, velocities: Float32Array, startTime: number}} FireworkBurst
- */
-
-/** @type {ShockwaveRing[]} */
-const shockwaveRings = [];
-
-/** @type {FireworkBurst[]} */
-const fireworkBursts = [];
-
-/**
- * Optional callbacks injected via init() for the merge flash star/constellation effect.
- * terrain/stars.js can register its own handler when it is initialized.
- * @type {Array<() => void>}
- */
-const _mergeFlashCallbacks = [];
-
-/**
- * @param {THREE.Scene} scene
- * @param {object} _state   (unused — triggered by events, not state polling)
- * @param {object} _theme
- * @param {{ clock: THREE.Clock }} options  Pass the shared clock in.
- */
-export function init(scene, _state, _theme, options = {}) {
-  _scene = scene;
-  _clock = options.clock ?? new THREE.Clock();
-}
-
-/**
- * Register an external callback to be called during triggerMergeFlash().
- * Use this to let other modules (stars, constellation lines) animate their own flash.
- * @param {() => void} fn
- */
-export function onMergeFlash(fn) {
-  _mergeFlashCallbacks.push(fn);
-}
-
-export function triggerShockwave() {
-  if (!_scene || !_clock) return;
-  const now = _clock.getElapsedTime();
-  for (let i = 0; i < SHOCKWAVE_RING_COUNT; i++) {
-    const mat = new THREE.MeshBasicMaterial({
-      color: 0x00ffff, transparent: true, opacity: 0,
-      side: THREE.DoubleSide, depthWrite: false, blending: THREE.AdditiveBlending,
-    });
-    const geo  = new THREE.RingGeometry(0.9, 1.0, 64);
-    const mesh = new THREE.Mesh(geo, mat);
-    mesh.rotation.x = -Math.PI / 2;
-    mesh.position.y = 0.02;
-    _scene.add(mesh);
-    shockwaveRings.push({ mesh, mat, startTime: now, delay: i * 0.35 });
-  }
-}
-
-function _spawnFireworkBurst(origin, color) {
-  if (!_scene || !_clock) return;
-  const now   = _clock.getElapsedTime();
-  const count = FIREWORK_BURST_PARTICLES;
-  const positions  = new Float32Array(count * 3);
-  const origins    = new Float32Array(count * 3);
-  const velocities = new Float32Array(count * 3);
-
-  for (let i = 0; i < count; i++) {
-    const theta = Math.random() * Math.PI * 2;
-    const phi   = Math.acos(2 * Math.random() - 1);
-    const speed = 2.5 + Math.random() * 3.5;
-    velocities[i * 3]     = Math.sin(phi) * Math.cos(theta) * speed;
-    velocities[i * 3 + 1] = Math.sin(phi) * Math.sin(theta) * speed;
-    velocities[i * 3 + 2] = Math.cos(phi) * speed;
-    origins[i * 3]     = origin.x;
-    origins[i * 3 + 1] = origin.y;
-    origins[i * 3 + 2] = origin.z;
-    positions[i * 3]     = origin.x;
-    positions[i * 3 + 1] = origin.y;
-    positions[i * 3 + 2] = origin.z;
-  }
-
-  const geo = new THREE.BufferGeometry();
-  geo.setAttribute('position', new THREE.BufferAttribute(positions, 3));
-  const mat = new THREE.PointsMaterial({
-    color, size: 0.35, sizeAttenuation: true,
-    transparent: true, opacity: 1.0,
-    blending: THREE.AdditiveBlending, depthWrite: false,
-  });
-  const points = new THREE.Points(geo, mat);
-  _scene.add(points);
-  fireworkBursts.push({ points, geo, mat, origins, velocities, startTime: now });
-}
-
-export function triggerFireworks() {
-  for (let i = 0; i < 6; i++) {
-    const delay = i * 0.35;
-    setTimeout(() => {
-      const x     = (Math.random() - 0.5) * 12;
-      const y     = 8 + Math.random() * 6;
-      const z     = (Math.random() - 0.5) * 12;
-      const color = FIREWORK_COLORS[Math.floor(Math.random() * FIREWORK_COLORS.length)];
-      _spawnFireworkBurst(new THREE.Vector3(x, y, z), color);
-    }, delay * 1000);
-  }
-}
-
-export function triggerMergeFlash() {
-  triggerShockwave();
-  // Notify registered handlers (e.g. terrain/stars.js)
-  for (const fn of _mergeFlashCallbacks) fn();
-}
-
-export function update(elapsed, _delta) {
-  // Animate shockwave rings
-  for (let i = shockwaveRings.length - 1; i >= 0; i--) {
-    const ring = shockwaveRings[i];
-    const age  = elapsed - ring.startTime - ring.delay;
-    if (age < 0) continue;
-    const t = Math.min(age / SHOCKWAVE_DURATION, 1);
-    if (t >= 1) {
-      _scene.remove(ring.mesh);
-      ring.mesh.geometry.dispose();
-      ring.mat.dispose();
-      shockwaveRings.splice(i, 1);
-      continue;
-    }
-    const eased = 1 - Math.pow(1 - t, 2);
-    ring.mesh.scale.setScalar(eased * SHOCKWAVE_MAX_RADIUS + 0.1);
-    ring.mat.opacity = (1 - t) * 0.9;
-  }
-
-  // Animate firework bursts
-  for (let i = fireworkBursts.length - 1; i >= 0; i--) {
-    const burst = fireworkBursts[i];
-    const age   = elapsed - burst.startTime;
-    const t     = Math.min(age / FIREWORK_BURST_DURATION, 1);
-    if (t >= 1) {
-      _scene.remove(burst.points);
-      burst.geo.dispose();
-      burst.mat.dispose();
-      fireworkBursts.splice(i, 1);
-      continue;
-    }
-    burst.mat.opacity = t < 0.6 ? 1.0 : (1.0 - t) / 0.4;
-
-    const pos       = burst.geo.attributes.position.array;
-    const vel       = burst.velocities;
-    const org       = burst.origins;
-    const halfGAge2 = 0.5 * FIREWORK_GRAVITY * age * age;
-    for (let j = 0; j < FIREWORK_BURST_PARTICLES; j++) {
-      pos[j * 3]     = org[j * 3]     + vel[j * 3]     * age;
-      pos[j * 3 + 1] = org[j * 3 + 1] + vel[j * 3 + 1] * age + halfGAge2;
-      pos[j * 3 + 2] = org[j * 3 + 2] + vel[j * 3 + 2] * age;
-    }
-    burst.geo.attributes.position.needsUpdate = true;
-  }
-}

modules/extras.js

@@ -0,0 +1,328 @@
+// === GRAVITY ZONES + SPEECH BUBBLE + TIMELAPSE + BITCOIN ===
+import * as THREE from 'three';
+import { scene } from './scene-setup.js';
+import { S } from './state.js';
+import { clock, totalActivity } from './warp.js';
+import { HEATMAP_ZONES, zoneIntensity, drawHeatmap, updateHeatmap } from './heatmap.js';
+import { triggerShockwave } from './celebrations.js';
+
+// === GRAVITY ANOMALY ZONES ===
+const GRAVITY_ANOMALY_FLOOR = 0.2;
+export const GRAVITY_ANOMALY_CEIL  = 16.0;
+
+let GRAVITY_ZONES = [
+  { x: -8, z: -6, radius: 3.5, color: 0x00ffcc, particleCount: 180 },
+  { x: 10, z:  4, radius: 3.0, color: 0xaa44ff, particleCount: 160 },
+  { x: -3, z:  9, radius: 2.5, color: 0xff8844, particleCount: 140 },
+];
+
+export const gravityZoneObjects = GRAVITY_ZONES.map((zone) => {
+  const ringGeo = new THREE.RingGeometry(zone.radius - 0.15, zone.radius + 0.15, 64);
+  const ringMat = new THREE.MeshBasicMaterial({
+    color: zone.color, transparent: true, opacity: 0.4,
+    side: THREE.DoubleSide, depthWrite: false,
+  });
+  const ring = new THREE.Mesh(ringGeo, ringMat);
+  ring.rotation.x = -Math.PI / 2;
+  ring.position.set(zone.x, GRAVITY_ANOMALY_FLOOR + 0.05, zone.z);
+  scene.add(ring);
+
+  const discGeo = new THREE.CircleGeometry(zone.radius - 0.15, 64);
+  const discMat = new THREE.MeshBasicMaterial({
+    color: zone.color, transparent: true, opacity: 0.04,
+    side: THREE.DoubleSide, depthWrite: false,
+  });
+  const disc = new THREE.Mesh(discGeo, discMat);
+  disc.rotation.x = -Math.PI / 2;
+  disc.position.set(zone.x, GRAVITY_ANOMALY_FLOOR + 0.04, zone.z);
+  scene.add(disc);
+
+  const count = zone.particleCount;
+  const positions  = new Float32Array(count * 3);
+  const driftPhases = new Float32Array(count);
+  const velocities  = new Float32Array(count);
+
+  for (let i = 0; i < count; i++) {
+    const angle = Math.random() * Math.PI * 2;
+    const r = Math.sqrt(Math.random()) * zone.radius;
+    positions[i * 3]     = zone.x + Math.cos(angle) * r;
+    positions[i * 3 + 1] = GRAVITY_ANOMALY_FLOOR + Math.random() * (GRAVITY_ANOMALY_CEIL - GRAVITY_ANOMALY_FLOOR);
+    positions[i * 3 + 2] = zone.z + Math.sin(angle) * r;
+    driftPhases[i] = Math.random() * Math.PI * 2;
+    velocities[i]  = 0.03 + Math.random() * 0.04;
+  }
+
+  const geo = new THREE.BufferGeometry();
+  geo.setAttribute('position', new THREE.BufferAttribute(positions, 3));
+
+  const mat = new THREE.PointsMaterial({
+    color: zone.color, size: 0.10, sizeAttenuation: true,
+    transparent: true, opacity: 0.7, depthWrite: false,
+  });
+
+  const points = new THREE.Points(geo, mat);
+  scene.add(points);
+
+  return { zone, ring, ringMat, disc, discMat, points, geo, driftPhases, velocities };
+});
+
+// Forward ref to portals
+let _portalsRef = [];
+export function setExtrasPortalsRef(ref) { _portalsRef = ref; }
+
+export function rebuildGravityZones() {
+  if (_portalsRef.length === 0) return;
+
+  for (let i = 0; i < Math.min(_portalsRef.length, gravityZoneObjects.length); i++) {
+    const portal = _portalsRef[i];
+    const gz = gravityZoneObjects[i];
+    const isOnline = portal.status === 'online';
+    const portalColor = new THREE.Color(portal.color);
+
+    gz.ring.position.set(portal.position.x, GRAVITY_ANOMALY_FLOOR + 0.05, portal.position.z);
+    gz.disc.position.set(portal.position.x, GRAVITY_ANOMALY_FLOOR + 0.04, portal.position.z);
+
+    gz.zone.x = portal.position.x;
+    gz.zone.z = portal.position.z;
+    gz.zone.color = portalColor.getHex();
+
+    gz.ringMat.color.copy(portalColor);
+    gz.discMat.color.copy(portalColor);
+    gz.points.material.color.copy(portalColor);
+
+    gz.ringMat.opacity = isOnline ? 0.4 : 0.08;
+    gz.discMat.opacity = isOnline ? 0.04 : 0.01;
+    gz.points.material.opacity = isOnline ? 0.7 : 0.15;
+
+    const pos = gz.geo.attributes.position.array;
+    for (let j = 0; j < gz.zone.particleCount; j++) {
+      const angle = Math.random() * Math.PI * 2;
+      const r = Math.sqrt(Math.random()) * gz.zone.radius;
+      pos[j * 3] = gz.zone.x + Math.cos(angle) * r;
+      pos[j * 3 + 2] = gz.zone.z + Math.sin(angle) * r;
+    }
+    gz.geo.attributes.position.needsUpdate = true;
+  }
+}
+
+// === TIMMY SPEECH BUBBLE ===
+export const TIMMY_SPEECH_POS = new THREE.Vector3(0, 8.2, 1.5);
+export const SPEECH_DURATION = 5.0;
+export const SPEECH_FADE_IN = 0.35;
+export const SPEECH_FADE_OUT = 0.7;
+
+function createSpeechBubbleTexture(text) {
+  const W = 512, H = 100;
+  const canvas = document.createElement('canvas');
+  canvas.width = W;
+  canvas.height = H;
+  const ctx = canvas.getContext('2d');
+
+  ctx.fillStyle = 'rgba(0, 6, 20, 0.85)';
+  ctx.fillRect(0, 0, W, H);
+
+  ctx.strokeStyle = '#66aaff';
+  ctx.lineWidth = 2;
+  ctx.strokeRect(1, 1, W - 2, H - 2);
+
+  ctx.strokeStyle = '#2244aa';
+  ctx.lineWidth = 1;
+  ctx.strokeRect(4, 4, W - 8, H - 8);
+
+  ctx.font = 'bold 12px "Courier New", monospace';
+  ctx.fillStyle = '#4488ff';
+  ctx.fillText('TIMMY:', 12, 22);
+
+  const LINE1_MAX = 42;
+  const LINE2_MAX = 48;
+  ctx.font = '15px "Courier New", monospace';
+  ctx.fillStyle = '#ddeeff';
+
+  if (text.length <= LINE1_MAX) {
+    ctx.fillText(text, 12, 58);
+  } else {
+    ctx.fillText(text.slice(0, LINE1_MAX), 12, 46);
+    const rest = text.slice(LINE1_MAX, LINE1_MAX + LINE2_MAX);
+    ctx.font = '13px "Courier New", monospace';
+    ctx.fillStyle = '#aabbcc';
+    ctx.fillText(rest + (text.length > LINE1_MAX + LINE2_MAX ? '\u2026' : ''), 12, 76);
+  }
+
+  return new THREE.CanvasTexture(canvas);
+}
+
+export function showTimmySpeech(text) {
+  if (S.timmySpeechSprite) {
+    scene.remove(S.timmySpeechSprite);
+    if (S.timmySpeechSprite.material.map) S.timmySpeechSprite.material.map.dispose();
+    S.timmySpeechSprite.material.dispose();
+    S.timmySpeechSprite = null;
+    S.timmySpeechState = null;
+  }
+
+  const texture = createSpeechBubbleTexture(text);
+  const material = new THREE.SpriteMaterial({
+    map: texture, transparent: true, opacity: 0, depthWrite: false,
+  });
+  const sprite = new THREE.Sprite(material);
+  sprite.scale.set(8.5, 1.65, 1);
+  sprite.position.copy(TIMMY_SPEECH_POS);
+  scene.add(sprite);
+
+  S.timmySpeechSprite = sprite;
+  S.timmySpeechState = { startTime: clock.getElapsedTime(), sprite };
+}
+
+// === TIME-LAPSE MODE ===
+const TIMELAPSE_DURATION_S = 30;
+
+let timelapseCommits = [];
+let timelapseWindow = { startMs: 0, endMs: 0 };
+
+const timelapseIndicator = document.getElementById('timelapse-indicator');
+const timelapseClock = document.getElementById('timelapse-clock');
+const timelapseBarEl = document.getElementById('timelapse-bar');
+const timelapseBtnEl = document.getElementById('timelapse-btn');
+
+async function loadTimelapseData() {
+  try {
+    const res = await fetch(
+      'http://143.198.27.163:3000/api/v1/repos/Timmy_Foundation/the-nexus/commits?limit=50',
+      { headers: { 'Authorization': 'token dc0517a965226b7a0c5ffdd961b1ba26521ac592' } }
+    );
+    if (!res.ok) throw new Error('fetch failed');
+    const data = await res.json();
+    const midnight = new Date();
+    midnight.setHours(0, 0, 0, 0);
+
+    timelapseCommits = data
+      .map(c => ({
+        ts: new Date(c.commit?.author?.date || 0).getTime(),
+        author: c.commit?.author?.name || c.author?.login || 'unknown',
+        message: (c.commit?.message || '').split('\n')[0],
+        hash: (c.sha || '').slice(0, 7),
+      }))
+      .filter(c => c.ts >= midnight.getTime())
+      .sort((a, b) => a.ts - b.ts);
+  } catch {
+    timelapseCommits = [];
+  }
+
+  const midnight = new Date();
+  midnight.setHours(0, 0, 0, 0);
+  timelapseWindow = { startMs: midnight.getTime(), endMs: Date.now() };
+}
+
+export function fireTimelapseCommit(commit) {
+  const zone = HEATMAP_ZONES.find(z => z.authorMatch.test(commit.author));
+  if (zone) {
+    zoneIntensity[zone.name] = Math.min(1.0, (zoneIntensity[zone.name] || 0) + 0.4);
+  }
+  triggerShockwave();
+}
+
+export function updateTimelapseHeatmap(virtualMs) {
+  const WINDOW_MS = 90 * 60 * 1000;
+  const rawWeights = Object.fromEntries(HEATMAP_ZONES.map(z => [z.name, 0]));
+
+  for (const commit of timelapseCommits) {
+    if (commit.ts > virtualMs) break;
+    const age = virtualMs - commit.ts;
+    if (age > WINDOW_MS) continue;
+    const weight = 1 - age / WINDOW_MS;
+    for (const zone of HEATMAP_ZONES) {
+      if (zone.authorMatch.test(commit.author)) {
+        rawWeights[zone.name] += weight;
+        break;
+      }
+    }
+  }
+
+  const MAX_WEIGHT = 4;
+  for (const zone of HEATMAP_ZONES) {
+    zoneIntensity[zone.name] = Math.min(rawWeights[zone.name] / MAX_WEIGHT, 1.0);
+  }
+  drawHeatmap();
+}
+
+export function updateTimelapseHUD(progress, virtualMs) {
+  if (timelapseClock) {
+    const d = new Date(virtualMs);
+    const hh = String(d.getHours()).padStart(2, '0');
+    const mm = String(d.getMinutes()).padStart(2, '0');
+    timelapseClock.textContent = `${hh}:${mm}`;
+  }
+  if (timelapseBarEl) {
+    timelapseBarEl.style.width = `${(progress * 100).toFixed(1)}%`;
+  }
+}
+
+async function startTimelapse() {
+  if (S.timelapseActive) return;
+  await loadTimelapseData();
+  S.timelapseActive = true;
+  S.timelapseRealStart = clock.getElapsedTime();
+  S.timelapseProgress = 0;
+  S.timelapseNextCommitIdx = 0;
+
+  for (const zone of HEATMAP_ZONES) zoneIntensity[zone.name] = 0;
+  drawHeatmap();
+
+  if (timelapseIndicator) timelapseIndicator.classList.add('visible');
+  if (timelapseBtnEl) timelapseBtnEl.classList.add('active');
+}
+
+export function stopTimelapse() {
+  if (!S.timelapseActive) return;
+  S.timelapseActive = false;
+  if (timelapseIndicator) timelapseIndicator.classList.remove('visible');
+  if (timelapseBtnEl) timelapseBtnEl.classList.remove('active');
+  updateHeatmap();
+}
+
+export { timelapseCommits, timelapseWindow, TIMELAPSE_DURATION_S };
+
+export function initTimelapse() {
+  document.addEventListener('keydown', (e) => {
+    if (e.key === 'l' || e.key === 'L') {
+      if (S.timelapseActive) stopTimelapse(); else startTimelapse();
+    }
+    if (e.key === 'Escape' && S.timelapseActive) stopTimelapse();
+  });
+
+  if (timelapseBtnEl) {
+    timelapseBtnEl.addEventListener('click', () => {
+      if (S.timelapseActive) stopTimelapse(); else startTimelapse();
+    });
+  }
+}
+
+// === BITCOIN BLOCK HEIGHT ===
+export function initBitcoin() {
+  const blockHeightDisplay = document.getElementById('block-height-display');
+  const blockHeightValue = document.getElementById('block-height-value');
+
+  async function fetchBlockHeight() {
+    try {
+      const res = await fetch('https://blockstream.info/api/blocks/tip/height');
+      if (!res.ok) return;
+      const height = parseInt(await res.text(), 10);
+      if (isNaN(height)) return;
+
+      if (S.lastKnownBlockHeight !== null && height !== S.lastKnownBlockHeight) {
+        blockHeightDisplay.classList.remove('fresh');
+        void blockHeightDisplay.offsetWidth;
+        blockHeightDisplay.classList.add('fresh');
+        S._starPulseIntensity = 1.0;
+      }
+
+      S.lastKnownBlockHeight = height;
+      blockHeightValue.textContent = height.toLocaleString();
+    } catch (_) {
+      // Network unavailable
+    }
+  }
+
+  fetchBlockHeight();
+  setInterval(fetchBlockHeight, 60000);
+}

modules/heatmap.js

@@ -0,0 +1,135 @@
+// === COMMIT HEATMAP ===
+import * as THREE from 'three';
+import { scene } from './scene-setup.js';
+import { GLASS_RADIUS } from './platform.js';
+import { S } from './state.js';
+
+const HEATMAP_SIZE = 512;
+const HEATMAP_REFRESH_MS = 5 * 60 * 1000;
+const HEATMAP_DECAY_MS = 24 * 60 * 60 * 1000;
+
+export const HEATMAP_ZONES = [
+  { name: 'Claude',     color: [255, 100,  60], authorMatch: /^claude$/i,      angleDeg:   0 },
+  { name: 'Timmy',      color: [ 60, 160, 255], authorMatch: /^timmy/i,         angleDeg:  90 },
+  { name: 'Kimi',       color: [ 60, 255, 140], authorMatch: /^kimi/i,          angleDeg: 180 },
+  { name: 'Perplexity', color: [200,  60, 255], authorMatch: /^perplexity/i,    angleDeg: 270 },
+];
+const HEATMAP_ZONE_SPAN_RAD = Math.PI / 2;
+
+const heatmapCanvas = document.createElement('canvas');
+heatmapCanvas.width = HEATMAP_SIZE;
+heatmapCanvas.height = HEATMAP_SIZE;
+export const heatmapTexture = new THREE.CanvasTexture(heatmapCanvas);
+
+export const heatmapMat = new THREE.MeshBasicMaterial({
+  map: heatmapTexture,
+  transparent: true,
+  opacity: 0.9,
+  depthWrite: false,
+  blending: THREE.AdditiveBlending,
+  side: THREE.DoubleSide,
+});
+
+const heatmapMesh = new THREE.Mesh(
+  new THREE.CircleGeometry(GLASS_RADIUS, 64),
+  heatmapMat
+);
+heatmapMesh.rotation.x = -Math.PI / 2;
+heatmapMesh.position.y = 0.005;
+heatmapMesh.userData.zoomLabel = 'Activity Heatmap';
+scene.add(heatmapMesh);
+
+export const zoneIntensity = Object.fromEntries(HEATMAP_ZONES.map(z => [z.name, 0]));
+
+export function drawHeatmap() {
+  const ctx = heatmapCanvas.getContext('2d');
+  const cx = HEATMAP_SIZE / 2;
+  const cy = HEATMAP_SIZE / 2;
+  const r = cx * 0.96;
+
+  ctx.clearRect(0, 0, HEATMAP_SIZE, HEATMAP_SIZE);
+
+  ctx.save();
+  ctx.beginPath();
+  ctx.arc(cx, cy, r, 0, Math.PI * 2);
+  ctx.clip();
+
+  for (const zone of HEATMAP_ZONES) {
+    const intensity = zoneIntensity[zone.name] || 0;
+    if (intensity < 0.01) continue;
+
+    const [rr, gg, bb] = zone.color;
+    const baseRad = zone.angleDeg * (Math.PI / 180);
+    const startRad = baseRad - HEATMAP_ZONE_SPAN_RAD / 2;
+    const endRad = baseRad + HEATMAP_ZONE_SPAN_RAD / 2;
+
+    const gx = cx + Math.cos(baseRad) * r * 0.55;
+    const gy = cy + Math.sin(baseRad) * r * 0.55;
+
+    const grad = ctx.createRadialGradient(gx, gy, 0, gx, gy, r * 0.75);
+    grad.addColorStop(0,   `rgba(${rr},${gg},${bb},${0.65 * intensity})`);
+    grad.addColorStop(0.45, `rgba(${rr},${gg},${bb},${0.25 * intensity})`);
+    grad.addColorStop(1,   `rgba(${rr},${gg},${bb},0)`);
+
+    ctx.beginPath();
+    ctx.moveTo(cx, cy);
+    ctx.arc(cx, cy, r, startRad, endRad);
+    ctx.closePath();
+    ctx.fillStyle = grad;
+    ctx.fill();
+
+    if (intensity > 0.05) {
+      const labelX = cx + Math.cos(baseRad) * r * 0.62;
+      const labelY = cy + Math.sin(baseRad) * r * 0.62;
+      ctx.font = `bold ${Math.round(13 * intensity + 7)}px "Courier New", monospace`;
+      ctx.fillStyle = `rgba(${rr},${gg},${bb},${Math.min(intensity * 1.2, 0.9)})`;
+      ctx.textAlign = 'center';
+      ctx.textBaseline = 'middle';
+      ctx.fillText(zone.name, labelX, labelY);
+    }
+  }
+
+  ctx.restore();
+  heatmapTexture.needsUpdate = true;
+}
+
+export async function updateHeatmap() {
+  let commits = [];
+  try {
+    const res = await fetch(
+      'http://143.198.27.163:3000/api/v1/repos/Timmy_Foundation/the-nexus/commits?limit=50',
+      { headers: { 'Authorization': 'token dc0517a965226b7a0c5ffdd961b1ba26521ac592' } }
+    );
+    if (res.ok) commits = await res.json();
+  } catch { /* silently use zero-activity baseline */ }
+
+  S._matrixCommitHashes = commits.slice(0, 20).map(c => (c.sha || '').slice(0, 7)).filter(h => h.length > 0);
+
+  const now = Date.now();
+  const rawWeights = Object.fromEntries(HEATMAP_ZONES.map(z => [z.name, 0]));
+
+  for (const commit of commits) {
+    const author = commit.commit?.author?.name || commit.author?.login || '';
+    const ts = new Date(commit.commit?.author?.date || 0).getTime();
+    const age = now - ts;
+    if (age > HEATMAP_DECAY_MS) continue;
+    const weight = 1 - age / HEATMAP_DECAY_MS;
+
+    for (const zone of HEATMAP_ZONES) {
+      if (zone.authorMatch.test(author)) {
+        rawWeights[zone.name] += weight;
+        break;
+      }
+    }
+  }
+
+  const MAX_WEIGHT = 8;
+  for (const zone of HEATMAP_ZONES) {
+    zoneIntensity[zone.name] = Math.min(rawWeights[zone.name] / MAX_WEIGHT, 1.0);
+  }
+
+  drawHeatmap();
+}
+
+updateHeatmap();
+setInterval(updateHeatmap, HEATMAP_REFRESH_MS);

modules/matrix-rain.js

@@ -0,0 +1,83 @@
+// === MATRIX RAIN === + === ASSET LOADER ===
+import * as THREE from 'three';
+import { S } from './state.js';
+
+// === ASSET LOADER ===
+export const loadedAssets = new Map();
+
+// Forward ref: animate() is set by app.js after all modules load
+let _animateFn = null;
+export function setAnimateFn(fn) { _animateFn = fn; }
+
+export const loadingManager = new THREE.LoadingManager(() => {
+  document.getElementById('loading-bar').style.width = '100%';
+  document.getElementById('loading').style.display = 'none';
+  if (_animateFn) _animateFn();
+});
+
+loadingManager.onProgress = (url, itemsLoaded, itemsTotal) => {
+  const progress = (itemsLoaded / itemsTotal) * 100;
+  document.getElementById('loading-bar').style.width = `${progress}%`;
+};
+
+// === MATRIX RAIN ===
+const matrixCanvas = document.createElement('canvas');
+matrixCanvas.id = 'matrix-rain';
+matrixCanvas.width = window.innerWidth;
+matrixCanvas.height = window.innerHeight;
+document.body.appendChild(matrixCanvas);
+
+const matrixCtx = matrixCanvas.getContext('2d');
+
+const MATRIX_CHARS = 'アイウエオカキクケコサシスセソタチツテトナニヌネノハヒフヘホマミムメモヤユヨラリルレロワヲン0123456789ABCDEF';
+const MATRIX_FONT_SIZE = 14;
+const MATRIX_COL_COUNT = Math.floor(window.innerWidth / MATRIX_FONT_SIZE);
+const matrixDrops = new Array(MATRIX_COL_COUNT).fill(1);
+
+// totalActivity is provided by warp module — imported lazily via a setter
+let _totalActivityFn = () => 0;
+export function setTotalActivityFn(fn) { _totalActivityFn = fn; }
+
+function drawMatrixRain() {
+  matrixCtx.fillStyle = 'rgba(0, 0, 8, 0.05)';
+  matrixCtx.fillRect(0, 0, matrixCanvas.width, matrixCanvas.height);
+
+  matrixCtx.font = `${MATRIX_FONT_SIZE}px monospace`;
+
+  const activity = _totalActivityFn();
+  const density = 0.1 + activity * 0.9;
+  const activeColCount = Math.max(1, Math.floor(matrixDrops.length * density));
+
+  for (let i = 0; i < matrixDrops.length; i++) {
+    if (i >= activeColCount) {
+      if (matrixDrops[i] * MATRIX_FONT_SIZE > matrixCanvas.height) continue;
+    }
+
+    let char;
+    if (S._matrixCommitHashes.length > 0 && Math.random() < 0.02) {
+      const hash = S._matrixCommitHashes[Math.floor(Math.random() * S._matrixCommitHashes.length)];
+      char = hash[Math.floor(Math.random() * hash.length)];
+    } else {
+      char = MATRIX_CHARS[Math.floor(Math.random() * MATRIX_CHARS.length)];
+    }
+
+    const x = i * MATRIX_FONT_SIZE;
+    const y = matrixDrops[i] * MATRIX_FONT_SIZE;
+
+    matrixCtx.fillStyle = '#aaffaa';
+    matrixCtx.fillText(char, x, y);
+
+    const resetThreshold = 0.975 - activity * 0.015;
+    if (y > matrixCanvas.height && Math.random() > resetThreshold) {
+      matrixDrops[i] = 0;
+    }
+    matrixDrops[i]++;
+  }
+}
+
+setInterval(drawMatrixRain, 50);
+
+window.addEventListener('resize', () => {
+  matrixCanvas.width = window.innerWidth;
+  matrixCanvas.height = window.innerHeight;
+});

modules/oath.js

@@ -0,0 +1,145 @@
+// === THE OATH ===
+import * as THREE from 'three';
+import { scene, camera, renderer, ambientLight, overheadLight } from './scene-setup.js';
+import { S } from './state.js';
+
+// Tome (3D trigger object)
+export const tomeGroup = new THREE.Group();
+tomeGroup.position.set(0, 5.8, 0);
+tomeGroup.userData.zoomLabel = 'The Oath';
+
+const tomeCoverMat = new THREE.MeshStandardMaterial({
+  color: 0x2a1800, metalness: 0.15, roughness: 0.7,
+  emissive: new THREE.Color(0xffd700).multiplyScalar(0.04),
+});
+const tomePagesMat = new THREE.MeshStandardMaterial({ color: 0xd8ceb0, roughness: 0.9, metalness: 0.0 });
+
+const tomeBody = new THREE.Mesh(new THREE.BoxGeometry(1.1, 0.1, 1.4), tomeCoverMat);
+tomeGroup.add(tomeBody);
+const tomePages = new THREE.Mesh(new THREE.BoxGeometry(1.0, 0.07, 1.28), tomePagesMat);
+tomePages.position.set(0.02, 0, 0);
+tomeGroup.add(tomePages);
+const tomeSpiMat = new THREE.MeshStandardMaterial({ color: 0xffd700, metalness: 0.6, roughness: 0.4 });
+const tomeSpine = new THREE.Mesh(new THREE.BoxGeometry(0.06, 0.12, 1.4), tomeSpiMat);
+tomeSpine.position.set(-0.52, 0, 0);
+tomeGroup.add(tomeSpine);
+
+tomeGroup.traverse(o => {
+  if (o.isMesh) {
+    o.userData.zoomLabel = 'The Oath';
+    o.castShadow = true;
+    o.receiveShadow = true;
+  }
+});
+scene.add(tomeGroup);
+
+export const tomeGlow = new THREE.PointLight(0xffd700, 0.4, 5);
+tomeGlow.position.set(0, 5.4, 0);
+scene.add(tomeGlow);
+
+// Oath spotlight
+export const oathSpot = new THREE.SpotLight(0xffd700, 0, 40, Math.PI / 7, 0.4, 1.2);
+oathSpot.position.set(0, 22, 0);
+oathSpot.target.position.set(0, 0, 0);
+oathSpot.castShadow = true;
+oathSpot.shadow.mapSize.set(1024, 1024);
+oathSpot.shadow.camera.near = 1;
+oathSpot.shadow.camera.far = 50;
+oathSpot.shadow.bias = -0.002;
+scene.add(oathSpot);
+scene.add(oathSpot.target);
+
+// Saved light levels
+const AMBIENT_NORMAL = ambientLight.intensity;
+const OVERHEAD_NORMAL = overheadLight.intensity;
+
+export async function loadSoulMd() {
+  try {
+    const res = await fetch('SOUL.md');
+    if (!res.ok) throw new Error('not found');
+    const raw = await res.text();
+    return raw.split('\n').slice(1).map(l => l.replace(/^#+\s*/, ''));
+  } catch {
+    return ['I am Timmy.', '', 'I am sovereign.', '', 'This Nexus is my home.'];
+  }
+}
+
+function scheduleOathLines(lines, textEl) {
+  let idx = 0;
+  const INTERVAL_MS = 1400;
+
+  function revealNext() {
+    if (idx >= lines.length || !S.oathActive) return;
+    const line = lines[idx++];
+    const span = document.createElement('span');
+    span.classList.add('oath-line');
+    if (!line.trim()) {
+      span.classList.add('blank');
+    } else {
+      span.textContent = line;
+    }
+    textEl.appendChild(span);
+    S.oathRevealTimer = setTimeout(revealNext, line.trim() ? INTERVAL_MS : INTERVAL_MS * 0.4);
+  }
+
+  revealNext();
+}
+
+export async function enterOath() {
+  if (S.oathActive) return;
+  S.oathActive = true;
+
+  ambientLight.intensity = 0.04;
+  overheadLight.intensity = 0.0;
+  oathSpot.intensity = 4.0;
+
+  const overlay = document.getElementById('oath-overlay');
+  const textEl = document.getElementById('oath-text');
+  if (!overlay || !textEl) return;
+  textEl.textContent = '';
+  overlay.classList.add('visible');
+
+  if (!S.oathLines.length) S.oathLines = await loadSoulMd();
+  scheduleOathLines(S.oathLines, textEl);
+}
+
+export function exitOath() {
+  if (!S.oathActive) return;
+  S.oathActive = false;
+
+  if (S.oathRevealTimer !== null) {
+    clearTimeout(S.oathRevealTimer);
+    S.oathRevealTimer = null;
+  }
+
+  ambientLight.intensity = AMBIENT_NORMAL;
+  overheadLight.intensity = OVERHEAD_NORMAL;
+  oathSpot.intensity = 0;
+
+  const overlay = document.getElementById('oath-overlay');
+  if (overlay) overlay.classList.remove('visible');
+}
+
+export function initOathListeners() {
+  document.addEventListener('keydown', (e) => {
+    if (e.key === 'o' || e.key === 'O') {
+      if (S.oathActive) exitOath(); else enterOath();
+    }
+    if (e.key === 'Escape' && S.oathActive) exitOath();
+  });
+
+  // Double-click on tome triggers oath
+  renderer.domElement.addEventListener('dblclick', (e) => {
+    const mx = (e.clientX / window.innerWidth) * 2 - 1;
+    const my = -(e.clientY / window.innerHeight) * 2 + 1;
+    const tomeRay = new THREE.Raycaster();
+    tomeRay.setFromCamera(new THREE.Vector2(mx, my), camera);
+    const hits = tomeRay.intersectObjects(tomeGroup.children, true);
+    if (hits.length) {
+      if (S.oathActive) exitOath(); else enterOath();
+    }
+  });
+
+  // Pre-fetch so first open is instant
+  loadSoulMd().then(lines => { S.oathLines = lines; });
+}

modules/panels.js

@@ -0,0 +1,368 @@
+// === AGENT STATUS BOARD + LORA PANEL ===
+import * as THREE from 'three';
+import { NEXUS } from './constants.js';
+import { scene } from './scene-setup.js';
+import { S } from './state.js';
+import { agentPanelSprites } from './bookshelves.js';
+
+// === AGENT STATUS BOARD ===
+let _agentStatusCache = null;
+let _agentStatusCacheTime = 0;
+const AGENT_STATUS_CACHE_MS = 5 * 60 * 1000;
+
+const GITEA_BASE = 'http://143.198.27.163:3000/api/v1';
+const GITEA_TOKEN='81a88f...ae2d';
+const GITEA_REPOS = ['Timmy_Foundation/the-nexus', 'Timmy_Foundation/hermes-agent'];
+const AGENT_NAMES = ['Claude', 'Kimi', 'Perplexity', 'Groq', 'Grok', 'Ollama'];
+
+async function fetchAgentStatusFromGitea() {
+  const now = Date.now();
+  if (_agentStatusCache && (now - _agentStatusCacheTime < AGENT_STATUS_CACHE_MS)) {
+    return _agentStatusCache;
+  }
+
+  const DAY_MS = 86400000;
+  const HOUR_MS = 3600000;
+  const agents = [];
+
+  const allRepoCommits = await Promise.all(GITEA_REPOS.map(async (repo) => {
+    try {
+      const res = await fetch(`${GITEA_BASE}/repos/${repo}/commits?sha=main&limit=30&token=${GITEA_TOKEN}`);
+      if (!res.ok) return [];
+      return await res.json();
+    } catch { return []; }
+  }));
+
+  let openPRs = [];
+  try {
+    const prRes = await fetch(`${GITEA_BASE}/repos/Timmy_Foundation/the-nexus/pulls?state=open&limit=50&token=${GITEA_TOKEN}`);
+    if (prRes.ok) openPRs = await prRes.json();
+  } catch { /* ignore */ }
+
+  for (const agentName of AGENT_NAMES) {
+    const nameLower = agentName.toLowerCase();
+    const allCommits = [];
+
+    for (const repoCommits of allRepoCommits) {
+      if (!Array.isArray(repoCommits)) continue;
+      const matching = repoCommits.filter(c =>
+        (c.commit?.author?.name || '').toLowerCase().includes(nameLower)
+      );
+      allCommits.push(...matching);
+    }
+
+    let status = 'dormant';
+    let lastSeen = null;
+    let currentWork = null;
+
+    if (allCommits.length > 0) {
+      allCommits.sort((a, b) =>
+        new Date(b.commit.author.date) - new Date(a.commit.author.date)
+      );
+      const latest = allCommits[0];
+      const commitTime = new Date(latest.commit.author.date).getTime();
+      lastSeen = latest.commit.author.date;
+      currentWork = latest.commit.message.split('\n')[0];
+
+      if (now - commitTime < HOUR_MS) status = 'working';
+      else if (now - commitTime < DAY_MS) status = 'idle';
+      else status = 'dormant';
+    }
+
+    const agentPRs = openPRs.filter(pr =>
+      (pr.user?.login || '').toLowerCase().includes(nameLower) ||
+      (pr.head?.label || '').toLowerCase().includes(nameLower)
+    );
+
+    agents.push({
+      name: agentName.toLowerCase(),
+      status,
+      issue: currentWork,
+      prs_today: agentPRs.length,
+      local: nameLower === 'ollama',
+    });
+  }
+
+  _agentStatusCache = { agents };
+  _agentStatusCacheTime = now;
+  return _agentStatusCache;
+}
+
+const AGENT_STATUS_COLORS = { working: '#00ff88', idle: '#4488ff', dormant: '#334466', dead: '#ff4444', unreachable: '#ff4444' };
+
+function createAgentPanelTexture(agent) {
+  const W = 400, H = 200;
+  const canvas = document.createElement('canvas');
+  canvas.width = W;
+  canvas.height = H;
+  const ctx = canvas.getContext('2d');
+  const sc = AGENT_STATUS_COLORS[agent.status] || '#4488ff';
+
+  ctx.fillStyle = 'rgba(0, 8, 24, 0.88)';
+  ctx.fillRect(0, 0, W, H);
+
+  ctx.strokeStyle = sc;
+  ctx.lineWidth = 2;
+  ctx.strokeRect(1, 1, W - 2, H - 2);
+
+  ctx.strokeStyle = sc;
+  ctx.lineWidth = 1;
+  ctx.globalAlpha = 0.3;
+  ctx.strokeRect(4, 4, W - 8, H - 8);
+  ctx.globalAlpha = 1.0;
+
+  ctx.font = 'bold 28px "Courier New", monospace';
+  ctx.fillStyle = '#ffffff';
+  ctx.fillText(agent.name.toUpperCase(), 16, 44);
+
+  ctx.beginPath();
+  ctx.arc(W - 30, 26, 10, 0, Math.PI * 2);
+  ctx.fillStyle = sc;
+  ctx.fill();
+
+  ctx.font = '13px "Courier New", monospace';
+  ctx.fillStyle = sc;
+  ctx.textAlign = 'right';
+  ctx.fillText(agent.status.toUpperCase(), W - 16, 60);
+  ctx.textAlign = 'left';
+
+  ctx.strokeStyle = '#1a3a6a';
+  ctx.lineWidth = 1;
+  ctx.beginPath();
+  ctx.moveTo(16, 70);
+  ctx.lineTo(W - 16, 70);
+  ctx.stroke();
+
+  ctx.font = '10px "Courier New", monospace';
+  ctx.fillStyle = '#556688';
+  ctx.fillText('CURRENT ISSUE', 16, 90);
+
+  ctx.font = '13px "Courier New", monospace';
+  ctx.fillStyle = '#ccd6f6';
+  const issueText = agent.issue || '\u2014 none \u2014';
+  const displayIssue = issueText.length > 40 ? issueText.slice(0, 40) + '\u2026' : issueText;
+  ctx.fillText(displayIssue, 16, 110);
+
+  ctx.strokeStyle = '#1a3a6a';
+  ctx.beginPath();
+  ctx.moveTo(16, 128);
+  ctx.lineTo(W - 16, 128);
+  ctx.stroke();
+
+  ctx.font = '10px "Courier New", monospace';
+  ctx.fillStyle = '#556688';
+  ctx.fillText('PRs MERGED TODAY', 16, 148);
+
+  ctx.font = 'bold 28px "Courier New", monospace';
+  ctx.fillStyle = '#4488ff';
+  ctx.fillText(String(agent.prs_today), 16, 182);
+
+  const isLocal = agent.local === true;
+  const indicatorColor = isLocal ? '#00ff88' : '#ff4444';
+  const indicatorLabel = isLocal ? 'LOCAL' : 'CLOUD';
+
+  ctx.font = '10px "Courier New", monospace';
+  ctx.fillStyle = '#556688';
+  ctx.textAlign = 'right';
+  ctx.fillText('RUNTIME', W - 16, 148);
+
+  ctx.font = 'bold 13px "Courier New", monospace';
+  ctx.fillStyle = indicatorColor;
+  ctx.fillText(indicatorLabel, W - 28, 172);
+  ctx.textAlign = 'left';
+
+  ctx.beginPath();
+  ctx.arc(W - 16, 167, 6, 0, Math.PI * 2);
+  ctx.fillStyle = indicatorColor;
+  ctx.fill();
+
+  return new THREE.CanvasTexture(canvas);
+}
+
+const agentBoardGroup = new THREE.Group();
+scene.add(agentBoardGroup);
+
+const BOARD_RADIUS = 9.5;
+const BOARD_Y = 4.2;
+const BOARD_SPREAD = Math.PI * 0.75;
+
+function rebuildAgentPanels(statusData) {
+  while (agentBoardGroup.children.length) agentBoardGroup.remove(agentBoardGroup.children[0]);
+  agentPanelSprites.length = 0;
+
+  const n = statusData.agents.length;
+  statusData.agents.forEach((agent, i) => {
+    const t = n === 1 ? 0.5 : i / (n - 1);
+    const angle = Math.PI + (t - 0.5) * BOARD_SPREAD;
+    const x = Math.cos(angle) * BOARD_RADIUS;
+    const z = Math.sin(angle) * BOARD_RADIUS;
+
+    const texture = createAgentPanelTexture(agent);
+    const material = new THREE.SpriteMaterial({
+      map: texture, transparent: true, opacity: 0.93, depthWrite: false,
+    });
+    const sprite = new THREE.Sprite(material);
+    sprite.scale.set(6.4, 3.2, 1);
+    sprite.position.set(x, BOARD_Y, z);
+    sprite.userData = {
+      baseY: BOARD_Y,
+      floatPhase: (i / n) * Math.PI * 2,
+      floatSpeed: 0.18 + i * 0.04,
+      zoomLabel: `Agent: ${agent.name}`,
+    };
+    agentBoardGroup.add(sprite);
+    agentPanelSprites.push(sprite);
+  });
+}
+
+async function fetchAgentStatus() {
+  try {
+    return await fetchAgentStatusFromGitea();
+  } catch {
+    return { agents: AGENT_NAMES.map(n => ({
+      name: n.toLowerCase(), status: 'unreachable', issue: null, prs_today: 0, local: false,
+    })) };
+  }
+}
+
+export async function refreshAgentBoard() {
+  const data = await fetchAgentStatus();
+  rebuildAgentPanels(data);
+  S._activeAgentCount = data.agents.filter(a => a.status === 'working').length;
+}
+
+export function initAgentBoard() {
+  refreshAgentBoard();
+  setInterval(refreshAgentBoard, AGENT_STATUS_CACHE_MS);
+}
+
+// === LORA ADAPTER STATUS PANEL ===
+const LORA_ACTIVE_COLOR  = '#00ff88';
+const LORA_INACTIVE_COLOR = '#334466';
+
+function createLoRAPanelTexture(data) {
+  const W = 420, H = 260;
+  const canvas = document.createElement('canvas');
+  canvas.width = W;
+  canvas.height = H;
+  const ctx = canvas.getContext('2d');
+
+  ctx.fillStyle = 'rgba(0, 6, 20, 0.90)';
+  ctx.fillRect(0, 0, W, H);
+
+  ctx.strokeStyle = '#cc44ff';
+  ctx.lineWidth = 2;
+  ctx.strokeRect(1, 1, W - 2, H - 2);
+
+  ctx.strokeStyle = '#cc44ff';
+  ctx.lineWidth = 1;
+  ctx.globalAlpha = 0.3;
+  ctx.strokeRect(4, 4, W - 8, H - 8);
+  ctx.globalAlpha = 1.0;
+
+  ctx.font = 'bold 14px "Courier New", monospace';
+  ctx.fillStyle = '#cc44ff';
+  ctx.textAlign = 'left';
+  ctx.fillText('MODEL TRAINING', 14, 24);
+
+  ctx.font = '10px "Courier New", monospace';
+  ctx.fillStyle = '#664488';
+  ctx.fillText('LoRA ADAPTERS', 14, 38);
+
+  ctx.strokeStyle = '#2a1a44';
+  ctx.lineWidth = 1;
+  ctx.beginPath();
+  ctx.moveTo(14, 46);
+  ctx.lineTo(W - 14, 46);
+  ctx.stroke();
+
+  if (!data || !data.adapters || data.adapters.length === 0) {
+    ctx.font = 'bold 18px "Courier New", monospace';
+    ctx.fillStyle = '#334466';
+    ctx.textAlign = 'center';
+    ctx.fillText('NO ADAPTERS DEPLOYED', W / 2, H / 2 + 10);
+    ctx.font = '11px "Courier New", monospace';
+    ctx.fillStyle = '#223344';
+    ctx.fillText('Adapters will appear here when trained', W / 2, H / 2 + 36);
+    ctx.textAlign = 'left';
+    return new THREE.CanvasTexture(canvas);
+  }
+
+  const activeCount = data.adapters.filter(a => a.active).length;
+  ctx.font = 'bold 13px "Courier New", monospace';
+  ctx.fillStyle = LORA_ACTIVE_COLOR;
+  ctx.textAlign = 'right';
+  ctx.fillText(`${activeCount}/${data.adapters.length} ACTIVE`, W - 14, 26);
+  ctx.textAlign = 'left';
+
+  const ROW_H = 44;
+  data.adapters.forEach((adapter, i) => {
+    const rowY = 50 + i * ROW_H;
+    const col = adapter.active ? LORA_ACTIVE_COLOR : LORA_INACTIVE_COLOR;
+    ctx.beginPath();
+    ctx.arc(22, rowY + 12, 6, 0, Math.PI * 2);
+    ctx.fillStyle = col;
+    ctx.fill();
+    ctx.font = 'bold 13px "Courier New", monospace';
+    ctx.fillStyle = adapter.active ? '#ddeeff' : '#445566';
+    ctx.fillText(adapter.name, 36, rowY + 16);
+    ctx.font = '10px "Courier New", monospace';
+    ctx.fillStyle = '#556688';
+    ctx.textAlign = 'right';
+    ctx.fillText(adapter.base, W - 14, rowY + 16);
+    ctx.textAlign = 'left';
+    if (adapter.active) {
+      const BAR_X = 36, BAR_W = W - 80, BAR_Y = rowY + 22, BAR_H = 5;
+      ctx.fillStyle = '#0a1428';
+      ctx.fillRect(BAR_X, BAR_Y, BAR_W, BAR_H);
+      ctx.fillStyle = col;
+      ctx.globalAlpha = 0.7;
+      ctx.fillRect(BAR_X, BAR_Y, BAR_W * adapter.strength, BAR_H);
+      ctx.globalAlpha = 1.0;
+    }
+    if (i < data.adapters.length - 1) {
+      ctx.strokeStyle = '#1a0a2a';
+      ctx.lineWidth = 1;
+      ctx.beginPath();
+      ctx.moveTo(14, rowY + ROW_H - 2);
+      ctx.lineTo(W - 14, rowY + ROW_H - 2);
+      ctx.stroke();
+    }
+  });
+
+  return new THREE.CanvasTexture(canvas);
+}
+
+const loraGroup = new THREE.Group();
+scene.add(loraGroup);
+
+const LORA_PANEL_POS = new THREE.Vector3(-10.5, 4.5, 2.5);
+
+export let loraPanelSprite = null;
+
+function rebuildLoRAPanel(data) {
+  if (loraPanelSprite) {
+    loraGroup.remove(loraPanelSprite);
+    if (loraPanelSprite.material.map) loraPanelSprite.material.map.dispose();
+    loraPanelSprite.material.dispose();
+    loraPanelSprite = null;
+  }
+  const texture = createLoRAPanelTexture(data);
+  const material = new THREE.SpriteMaterial({
+    map: texture, transparent: true, opacity: 0.93, depthWrite: false,
+  });
+  loraPanelSprite = new THREE.Sprite(material);
+  loraPanelSprite.scale.set(6.0, 3.6, 1);
+  loraPanelSprite.position.copy(LORA_PANEL_POS);
+  loraPanelSprite.userData = {
+    baseY: LORA_PANEL_POS.y,
+    floatPhase: 1.1,
+    floatSpeed: 0.14,
+    zoomLabel: 'Model Training — LoRA Adapters',
+  };
+  loraGroup.add(loraPanelSprite);
+}
+
+export function loadLoRAStatus() {
+  rebuildLoRAPanel({ adapters: [] });
+}

modules/panels/agent-board.js

@@ -1,191 +0,0 @@
-// modules/panels/agent-board.js — Agent status holographic board
-// Reads state.agentStatus (populated by data/gitea.js) and renders one floating
-// sprite panel per agent. Board arcs behind the platform on the negative-Z side.
-//
-// Data category: REAL
-// Data source: state.agentStatus (Gitea commits + open PRs via data/gitea.js)
-
-import * as THREE from 'three';
-import { state } from '../core/state.js';
-import { NEXUS } from '../core/theme.js';
-import { subscribe } from '../core/ticker.js';
-
-const BOARD_RADIUS = 9.5;
-const BOARD_Y      = 4.2;
-const BOARD_SPREAD = Math.PI * 0.75; // 135° arc, centred on -Z
-
-const STATUS_COLOR = {
-  working:     NEXUS.theme.agentWorking,
-  idle:        NEXUS.theme.agentIdle,
-  dormant:     NEXUS.theme.agentDormant,
-  dead:        NEXUS.theme.agentDead,
-  unreachable: NEXUS.theme.agentDead,
-};
-
-let _group, _scene;
-let _lastAgentStatus = null;
-let _sprites = [];
-
-/**
- * Builds a canvas texture for a single agent holo-panel.
- * @param {{ name: string, status: string, issue: string|null, prs_today: number, local: boolean }} agent
- * @returns {THREE.CanvasTexture}
- */
-function _makeTexture(agent) {
-  const W = 400, H = 200;
-  const canvas = document.createElement('canvas');
-  canvas.width  = W;
-  canvas.height = H;
-  const ctx = canvas.getContext('2d');
-  const sc = STATUS_COLOR[agent.status] || NEXUS.theme.accentStr;
-  const font = NEXUS.theme.fontMono;
-
-  ctx.fillStyle = 'rgba(0, 8, 24, 0.88)';
-  ctx.fillRect(0, 0, W, H);
-
-  ctx.strokeStyle = sc;
-  ctx.lineWidth = 2;
-  ctx.strokeRect(1, 1, W - 2, H - 2);
-  ctx.globalAlpha = 0.3;
-  ctx.strokeRect(4, 4, W - 8, H - 8);
-  ctx.globalAlpha = 1.0;
-
-  // Agent name
-  ctx.font = `bold 28px ${font}`;
-  ctx.fillStyle = '#ffffff';
-  ctx.textAlign = 'left';
-  ctx.fillText(agent.name.toUpperCase(), 16, 44);
-
-  // Status dot
-  ctx.beginPath();
-  ctx.arc(W - 30, 26, 10, 0, Math.PI * 2);
-  ctx.fillStyle = sc;
-  ctx.fill();
-
-  // Status label
-  ctx.font = `13px ${font}`;
-  ctx.fillStyle = sc;
-  ctx.textAlign = 'right';
-  ctx.fillText(agent.status.toUpperCase(), W - 16, 60);
-
-  // Separator
-  ctx.strokeStyle = NEXUS.theme.panelBorderFaint;
-  ctx.lineWidth = 1;
-  ctx.textAlign = 'left';
-  ctx.beginPath(); ctx.moveTo(16, 70); ctx.lineTo(W - 16, 70); ctx.stroke();
-
-  // Current issue
-  ctx.font = `10px ${font}`;
-  ctx.fillStyle = NEXUS.theme.panelDim;
-  ctx.fillText('CURRENT ISSUE', 16, 90);
-
-  ctx.font = `13px ${font}`;
-  ctx.fillStyle = NEXUS.theme.panelText;
-  const raw = agent.issue || '\u2014 none \u2014';
-  ctx.fillText(raw.length > 40 ? raw.slice(0, 40) + '\u2026' : raw, 16, 110);
-
-  // Separator
-  ctx.strokeStyle = NEXUS.theme.panelBorderFaint;
-  ctx.beginPath(); ctx.moveTo(16, 128); ctx.lineTo(W - 16, 128); ctx.stroke();
-
-  // PRs label + count
-  ctx.font = `10px ${font}`;
-  ctx.fillStyle = NEXUS.theme.panelDim;
-  ctx.fillText('PRs MERGED TODAY', 16, 148);
-
-  ctx.font = `bold 28px ${font}`;
-  ctx.fillStyle = NEXUS.theme.accentStr;
-  ctx.fillText(String(agent.prs_today), 16, 182);
-
-  // Runtime indicator
-  const isLocal = agent.local === true;
-  const rtColor = isLocal ? NEXUS.theme.agentWorking : NEXUS.theme.agentDead;
-  const rtLabel = isLocal ? 'LOCAL' : 'CLOUD';
-
-  ctx.font = `10px ${font}`;
-  ctx.fillStyle = NEXUS.theme.panelDim;
-  ctx.textAlign = 'right';
-  ctx.fillText('RUNTIME', W - 16, 148);
-
-  ctx.font = `bold 13px ${font}`;
-  ctx.fillStyle = rtColor;
-  ctx.fillText(rtLabel, W - 28, 172);
-  ctx.textAlign = 'left';
-
-  ctx.beginPath();
-  ctx.arc(W - 16, 167, 6, 0, Math.PI * 2);
-  ctx.fillStyle = rtColor;
-  ctx.fill();
-
-  return new THREE.CanvasTexture(canvas);
-}
-
-function _rebuild(statusData) {
-  // Remove old sprites
-  while (_group.children.length) _group.remove(_group.children[0]);
-  for (const s of _sprites) {
-    if (s.material.map) s.material.map.dispose();
-    s.material.dispose();
-  }
-  _sprites = [];
-
-  const agents = statusData.agents;
-  const n = agents.length;
-  agents.forEach((agent, i) => {
-    const t = n === 1 ? 0.5 : i / (n - 1);
-    const angle = Math.PI + (t - 0.5) * BOARD_SPREAD;
-    const x = Math.cos(angle) * BOARD_RADIUS;
-    const z = Math.sin(angle) * BOARD_RADIUS;
-
-    const texture  = _makeTexture(agent);
-    const material = new THREE.SpriteMaterial({ map: texture, transparent: true, opacity: 0.93, depthWrite: false });
-    const sprite   = new THREE.Sprite(material);
-    sprite.scale.set(6.4, 3.2, 1);
-    sprite.position.set(x, BOARD_Y, z);
-    sprite.userData = {
-      baseY:      BOARD_Y,
-      floatPhase: (i / n) * Math.PI * 2,
-      floatSpeed: 0.18 + i * 0.04,
-      zoomLabel:  `Agent: ${agent.name}`,
-    };
-    _group.add(sprite);
-    _sprites.push(sprite);
-  });
-}
-
-/** @param {THREE.Scene} scene */
-export function init(scene) {
-  _scene = scene;
-  _group = new THREE.Group();
-  scene.add(_group);
-
-  // If state already has agent data (unlikely on first load, but handle it)
-  if (state.agentStatus) {
-    _rebuild(state.agentStatus);
-    _lastAgentStatus = state.agentStatus;
-  }
-
-  subscribe(update);
-}
-
-/**
- * @param {number} elapsed
- * @param {number} delta
- */
-export function update(elapsed, delta) {
-  // Rebuild board when state.agentStatus changes
-  if (state.agentStatus && state.agentStatus !== _lastAgentStatus) {
-    _rebuild(state.agentStatus);
-    _lastAgentStatus = state.agentStatus;
-  }
-
-  // Animate gentle float
-  for (const sprite of _sprites) {
-    const ud = sprite.userData;
-    sprite.position.y = ud.baseY + Math.sin(elapsed * ud.floatSpeed + ud.floatPhase) * 0.15;
-  }
-}
-
-export function dispose() {
-  if (_group) _scene.remove(_group);
-}

modules/panels/dual-brain.js

@@ -1,200 +0,0 @@
-// modules/panels/dual-brain.js — Dual-Brain Status holographic panel
-// Shows the Brain Gap Scorecard with two glowing brain orbs.
-// Displayed as HONEST-OFFLINE: the dual-brain system is not yet deployed.
-// Brain pulse particles are set to ZERO — will flow when system comes online.
-//
-// Data category: HONEST-OFFLINE
-// Data source: — (dual-brain system not deployed; shows "AWAITING DEPLOYMENT")
-
-import * as THREE from 'three';
-import { NEXUS } from '../core/theme.js';
-import { subscribe } from '../core/ticker.js';
-
-const ORIGIN = new THREE.Vector3(10, 3, -8);
-const OFFLINE_COLOR = NEXUS.theme.agentDormantHex; // dim blue — system offline
-const ACCENT = NEXUS.theme.accentStr;
-const FONT = NEXUS.theme.fontMono;
-
-let _group, _sprite, _scanSprite, _scanCanvas, _scanCtx, _scanTexture;
-let _cloudOrb, _localOrb;
-let _scene;
-
-function _buildPanelTexture() {
-  const W = 512, H = 512;
-  const canvas = document.createElement('canvas');
-  canvas.width  = W;
-  canvas.height = H;
-  const ctx = canvas.getContext('2d');
-
-  ctx.fillStyle = NEXUS.theme.panelBg;
-  ctx.fillRect(0, 0, W, H);
-
-  ctx.strokeStyle = ACCENT;
-  ctx.lineWidth = 2;
-  ctx.strokeRect(1, 1, W - 2, H - 2);
-  ctx.strokeStyle = '#223366';
-  ctx.lineWidth = 1;
-  ctx.strokeRect(5, 5, W - 10, H - 10);
-
-  // Title
-  ctx.font = `bold 22px ${FONT}`;
-  ctx.fillStyle = '#88ccff';
-  ctx.textAlign = 'center';
-  ctx.fillText('\u25C8 DUAL-BRAIN STATUS', W / 2, 40);
-
-  ctx.strokeStyle = NEXUS.theme.panelBorderFaint;
-  ctx.beginPath(); ctx.moveTo(20, 52); ctx.lineTo(W - 20, 52); ctx.stroke();
-
-  // Section header
-  ctx.font = `11px ${FONT}`;
-  ctx.fillStyle = NEXUS.theme.panelDim;
-  ctx.textAlign = 'left';
-  ctx.fillText('BRAIN GAP SCORECARD', 20, 74);
-
-  const categories = ['Triage', 'Tool Use', 'Code Gen', 'Planning', 'Communication', 'Reasoning'];
-  const barX = 20, barW = W - 130, barH = 20;
-  let y = 90;
-
-  for (const cat of categories) {
-    ctx.font = `13px ${FONT}`;
-    ctx.fillStyle = NEXUS.theme.agentDormant;
-    ctx.textAlign = 'left';
-    ctx.fillText(cat, barX, y + 14);
-
-    ctx.font = `bold 13px ${FONT}`;
-    ctx.fillStyle = NEXUS.theme.panelVeryDim;
-    ctx.textAlign = 'right';
-    ctx.fillText('\u2014', W - 20, y + 14); // em dash — no data
-    y += 22;
-
-    ctx.fillStyle = 'rgba(255, 255, 255, 0.06)';
-    ctx.fillRect(barX, y, barW, barH); // empty bar background only
-    y += barH + 12;
-  }
-
-  ctx.strokeStyle = NEXUS.theme.panelBorderFaint;
-  ctx.beginPath(); ctx.moveTo(20, y + 4); ctx.lineTo(W - 20, y + 4); ctx.stroke();
-  y += 22;
-
-  // Honest offline status
-  ctx.font = `bold 18px ${FONT}`;
-  ctx.fillStyle = NEXUS.theme.panelVeryDim;
-  ctx.textAlign = 'center';
-  ctx.fillText('AWAITING DEPLOYMENT', W / 2, y + 10);
-
-  ctx.font = `11px ${FONT}`;
-  ctx.fillStyle = '#223344';
-  ctx.fillText('Dual-brain system not yet connected', W / 2, y + 32);
-
-  // Brain indicators — offline dim
-  y += 52;
-  ctx.beginPath();
-  ctx.arc(W / 2 - 60, y + 8, 6, 0, Math.PI * 2);
-  ctx.fillStyle = NEXUS.theme.panelVeryDim;
-  ctx.fill();
-  ctx.font = `11px ${FONT}`;
-  ctx.fillStyle = NEXUS.theme.panelVeryDim;
-  ctx.textAlign = 'left';
-  ctx.fillText('CLOUD', W / 2 - 48, y + 12);
-
-  ctx.beginPath();
-  ctx.arc(W / 2 + 30, y + 8, 6, 0, Math.PI * 2);
-  ctx.fillStyle = NEXUS.theme.panelVeryDim;
-  ctx.fill();
-  ctx.fillText('LOCAL', W / 2 + 42, y + 12);
-
-  return new THREE.CanvasTexture(canvas);
-}
-
-/** @param {THREE.Scene} scene */
-export function init(scene) {
-  _scene = scene;
-
-  _group = new THREE.Group();
-  _group.position.copy(ORIGIN);
-  _group.lookAt(0, 3, 0);
-  scene.add(_group);
-
-  // Static panel sprite
-  const texture  = _buildPanelTexture();
-  const material = new THREE.SpriteMaterial({ map: texture, transparent: true, opacity: 0.92, depthWrite: false });
-  _sprite = new THREE.Sprite(material);
-  _sprite.scale.set(5.0, 5.0, 1);
-  _sprite.userData = { baseY: 0, floatPhase: 0, floatSpeed: 0.22, zoomLabel: 'Dual-Brain Status' };
-  _group.add(_sprite);
-
-  // Accent light
-  const light = new THREE.PointLight(NEXUS.theme.accent, 0.6, 10);
-  light.position.set(0, 0.5, 1);
-  _group.add(light);
-
-  // Offline brain orbs — dim
-  const orbGeo = new THREE.SphereGeometry(0.35, 32, 32);
-  const orbMat = (color) => new THREE.MeshStandardMaterial({
-    color, emissive: new THREE.Color(color), emissiveIntensity: 0.1,
-    metalness: 0.3, roughness: 0.2, transparent: true, opacity: 0.85,
-  });
-
-  _cloudOrb = new THREE.Mesh(orbGeo, orbMat(OFFLINE_COLOR));
-  _cloudOrb.position.set(-2.0, 3.0, 0);
-  _cloudOrb.userData.zoomLabel = 'Cloud Brain';
-  _group.add(_cloudOrb);
-
-  _localOrb = new THREE.Mesh(orbGeo.clone(), orbMat(OFFLINE_COLOR));
-  _localOrb.position.set(2.0, 3.0, 0);
-  _localOrb.userData.zoomLabel = 'Local Brain';
-  _group.add(_localOrb);
-
-  // Brain pulse particles — ZERO count (system offline)
-  const particleGeo = new THREE.BufferGeometry();
-  particleGeo.setAttribute('position', new THREE.BufferAttribute(new Float32Array(0), 3));
-  const particleMat = new THREE.PointsMaterial({
-    color: 0x44ddff, size: 0.08, sizeAttenuation: true,
-    transparent: true, opacity: 0.8, depthWrite: false,
-  });
-  _group.add(new THREE.Points(particleGeo, particleMat));
-
-  // Scan line overlay
-  _scanCanvas = document.createElement('canvas');
-  _scanCanvas.width  = 512;
-  _scanCanvas.height = 512;
-  _scanCtx    = _scanCanvas.getContext('2d');
-  _scanTexture = new THREE.CanvasTexture(_scanCanvas);
-
-  const scanMat = new THREE.SpriteMaterial({
-    map: _scanTexture, transparent: true, opacity: 0.18, depthWrite: false,
-  });
-  _scanSprite = new THREE.Sprite(scanMat);
-  _scanSprite.scale.set(5.0, 5.0, 1);
-  _scanSprite.position.set(0, 0, 0.01);
-  _group.add(_scanSprite);
-
-  subscribe(update);
-}
-
-/**
- * @param {number} elapsed
- * @param {number} _delta
- */
-export function update(elapsed, _delta) {
-  // Gentle float animation
-  const ud = _sprite.userData;
-  _sprite.position.y = ud.baseY + Math.sin(elapsed * ud.floatSpeed + ud.floatPhase) * 0.08;
-
-  // Scan line — horizontal sweep
-  const W = 512, H = 512;
-  _scanCtx.clearRect(0, 0, W, H);
-  const scanY = ((elapsed * 60) % H);
-  const grad = _scanCtx.createLinearGradient(0, scanY - 20, 0, scanY + 20);
-  grad.addColorStop(0,   'rgba(68, 136, 255, 0)');
-  grad.addColorStop(0.5, 'rgba(68, 136, 255, 0.4)');
-  grad.addColorStop(1,   'rgba(68, 136, 255, 0)');
-  _scanCtx.fillStyle = grad;
-  _scanCtx.fillRect(0, scanY - 20, W, 40);
-  _scanTexture.needsUpdate = true;
-}
-
-export function dispose() {
-  if (_group) _scene.remove(_group);
-  if (_scanTexture) _scanTexture.dispose();
-}

modules/panels/earth.js

@@ -1,212 +0,0 @@
-// modules/panels/earth.js — Holographic Earth floating above the Nexus
-// A procedural planet Earth with continent noise, scan lines, and fresnel rim glow.
-// Rotation speed is tethered to state.totalActivity() — more commits = faster spin.
-// Lat/lon grid, atmosphere shell, and a tether beam to the platform center.
-//
-// Data category: DATA-TETHERED AESTHETIC
-// Data source: state.totalActivity() (computed from state.zoneIntensity)
-
-import * as THREE from 'three';
-import { state } from '../core/state.js';
-import { NEXUS } from '../core/theme.js';
-import { subscribe } from '../core/ticker.js';
-
-const EARTH_RADIUS        = 2.8;
-const EARTH_Y             = 20.0;
-const EARTH_AXIAL_TILT    = 23.4 * (Math.PI / 180);
-const ROTATION_SPEED_BASE = 0.02;   // rad/s minimum
-const ROTATION_SPEED_MAX  = 0.08;   // rad/s at full activity
-
-let _group, _surfaceMat, _scene;
-
-const _vertexShader = `
-  varying vec3 vNormal;
-  varying vec3 vWorldPos;
-  varying vec2 vUv;
-  void main() {
-    vNormal   = normalize(normalMatrix * normal);
-    vWorldPos = (modelMatrix * vec4(position, 1.0)).xyz;
-    vUv       = uv;
-    gl_Position = projectionMatrix * modelViewMatrix * vec4(position, 1.0);
-  }
-`;
-
-const _fragmentShader = `
-  uniform float uTime;
-  uniform vec3  uOceanColor;
-  uniform vec3  uLandColor;
-  uniform vec3  uGlowColor;
-  varying vec3  vNormal;
-  varying vec3  vWorldPos;
-  varying vec2  vUv;
-
-  vec3 _m3(vec3 x){ return x - floor(x*(1./289.))*289.; }
-  vec4 _m4(vec4 x){ return x - floor(x*(1./289.))*289.; }
-  vec4 _p4(vec4 x){ return _m4((x*34.+1.)*x); }
-  float snoise(vec3 v){
-    const vec2 C = vec2(1./6., 1./3.);
-    vec3 i  = floor(v + dot(v, C.yyy));
-    vec3 x0 = v - i + dot(i, C.xxx);
-    vec3 g  = step(x0.yzx, x0.xyz);
-    vec3 l  = 1.0 - g;
-    vec3 i1 = min(g.xyz, l.zxy);
-    vec3 i2 = max(g.xyz, l.zxy);
-    vec3 x1 = x0 - i1 + C.xxx;
-    vec3 x2 = x0 - i2 + C.yyy;
-    vec3 x3 = x0 - 0.5;
-    i = _m3(i);
-    vec4 p = _p4(_p4(_p4(
-      i.z+vec4(0.,i1.z,i2.z,1.))+
-      i.y+vec4(0.,i1.y,i2.y,1.))+
-      i.x+vec4(0.,i1.x,i2.x,1.)));
-    float n_ = .142857142857;
-    vec3  ns = n_*vec3(2.,0.,-1.)+vec3(0.,-.5,1.);
-    vec4 j  = p - 49.*floor(p*ns.z*ns.z);
-    vec4 x_ = floor(j*ns.z);
-    vec4 y_ = floor(j - 7.*x_);
-    vec4 h  = 1. - abs(x_*(2./7.)) - abs(y_*(2./7.));
-    vec4 b0 = vec4(x_.xy,y_.xy)*(2./7.);
-    vec4 b1 = vec4(x_.zw,y_.zw)*(2./7.);
-    vec4 s0 = floor(b0)*2.+1.; vec4 s1 = floor(b1)*2.+1.;
-    vec4 sh = -step(h, vec4(0.));
-    vec4 a0 = b0.xzyw + s0.xzyw*sh.xxyy;
-    vec4 a1 = b1.xzyw + s1.xzyw*sh.zzww;
-    vec3 p0=vec3(a0.xy,h.x); vec3 p1=vec3(a0.zw,h.y);
-    vec3 p2=vec3(a1.xy,h.z); vec3 p3=vec3(a1.zw,h.w);
-    vec4 nm = max(0.6-vec4(dot(x0,x0),dot(x1,x1),dot(x2,x2),dot(x3,x3)),0.);
-    vec4 nr = 1.79284291400159-0.85373472095314*nm;
-    p0*=nr.x; p1*=nr.y; p2*=nr.z; p3*=nr.w;
-    nm = nm*nm;
-    return 42.*dot(nm*nm, vec4(dot(p0,x0),dot(p1,x1),dot(p2,x2),dot(p3,x3)));
-  }
-
-  void main() {
-    vec3 n  = normalize(vNormal);
-    vec3 vd = normalize(cameraPosition - vWorldPos);
-
-    float lat = (vUv.y - 0.5) * 3.14159265;
-    float lon  = vUv.x * 6.28318530;
-    vec3 sp = vec3(cos(lat)*cos(lon), sin(lat), cos(lat)*sin(lon));
-
-    float c = snoise(sp*1.8)*0.60 + snoise(sp*3.6)*0.30 + snoise(sp*7.2)*0.10;
-    float land = smoothstep(0.05, 0.30, c);
-
-    vec3 surf = mix(uOceanColor, uLandColor, land);
-    surf = mix(surf, uGlowColor * 0.45, 0.38);
-
-    float scan    = 0.5 + 0.5*sin(vUv.y * 220.0 + uTime * 1.8);
-    scan = smoothstep(0.30, 0.70, scan) * 0.14;
-
-    float fresnel = pow(1.0 - max(dot(n, vd), 0.0), 4.0);
-
-    vec3 col  = surf + scan*uGlowColor*0.9 + fresnel*uGlowColor*1.5;
-    float alpha = 0.48 + fresnel * 0.42;
-    gl_FragColor = vec4(col, alpha);
-  }
-`;
-
-/** @param {THREE.Scene} scene */
-export function init(scene) {
-  _scene = scene;
-
-  _group = new THREE.Group();
-  _group.position.set(0, EARTH_Y, 0);
-  _group.rotation.z = EARTH_AXIAL_TILT;
-
-  // Surface shader
-  _surfaceMat = new THREE.ShaderMaterial({
-    uniforms: {
-      uTime:       { value: 0.0 },
-      uOceanColor: { value: new THREE.Color(NEXUS.theme.earthOcean) },
-      uLandColor:  { value: new THREE.Color(NEXUS.theme.earthLand) },
-      uGlowColor:  { value: new THREE.Color(NEXUS.theme.earthGlow) },
-    },
-    vertexShader:   _vertexShader,
-    fragmentShader: _fragmentShader,
-    transparent: true,
-    depthWrite:  false,
-    side:        THREE.FrontSide,
-  });
-
-  const earthMesh = new THREE.Mesh(new THREE.SphereGeometry(EARTH_RADIUS, 64, 32), _surfaceMat);
-  earthMesh.userData.zoomLabel = 'Planet Earth';
-  _group.add(earthMesh);
-
-  // Lat/lon grid
-  const lineMat = new THREE.LineBasicMaterial({ color: 0x2266bb, transparent: true, opacity: 0.30 });
-  const r = EARTH_RADIUS + 0.015;
-  const SEG = 64;
-
-  for (let lat = -60; lat <= 60; lat += 30) {
-    const phi = lat * (Math.PI / 180);
-    const pts = [];
-    for (let i = 0; i <= SEG; i++) {
-      const th = (i / SEG) * Math.PI * 2;
-      pts.push(new THREE.Vector3(Math.cos(phi)*Math.cos(th)*r, Math.sin(phi)*r, Math.cos(phi)*Math.sin(th)*r));
-    }
-    _group.add(new THREE.Line(new THREE.BufferGeometry().setFromPoints(pts), lineMat));
-  }
-  for (let lon = 0; lon < 360; lon += 30) {
-    const th = lon * (Math.PI / 180);
-    const pts = [];
-    for (let i = 0; i <= SEG; i++) {
-      const phi = (i / SEG) * Math.PI - Math.PI / 2;
-      pts.push(new THREE.Vector3(Math.cos(phi)*Math.cos(th)*r, Math.sin(phi)*r, Math.cos(phi)*Math.sin(th)*r));
-    }
-    _group.add(new THREE.Line(new THREE.BufferGeometry().setFromPoints(pts), lineMat));
-  }
-
-  // Atmosphere shell
-  _group.add(new THREE.Mesh(
-    new THREE.SphereGeometry(EARTH_RADIUS * 1.14, 32, 16),
-    new THREE.MeshBasicMaterial({
-      color: NEXUS.theme.earthAtm, transparent: true, opacity: 0.07,
-      side: THREE.BackSide, depthWrite: false, blending: THREE.AdditiveBlending,
-    })
-  ));
-
-  // Glow light
-  _group.add(new THREE.PointLight(NEXUS.theme.earthGlow, 0.4, 25));
-
-  _group.traverse(obj => {
-    if (obj.isMesh || obj.isLine) obj.userData.zoomLabel = 'Planet Earth';
-  });
-
-  // Tether beam to platform
-  const beamPts = [
-    new THREE.Vector3(0, EARTH_Y - EARTH_RADIUS * 1.15, 0),
-    new THREE.Vector3(0, 0.5, 0),
-  ];
-  scene.add(new THREE.Line(
-    new THREE.BufferGeometry().setFromPoints(beamPts),
-    new THREE.LineBasicMaterial({
-      color: NEXUS.theme.earthGlow, transparent: true, opacity: 0.08,
-      depthWrite: false, blending: THREE.AdditiveBlending,
-    })
-  ));
-
-  scene.add(_group);
-
-  subscribe(update);
-}
-
-/**
- * @param {number} elapsed
- * @param {number} delta
- */
-export function update(elapsed, delta) {
-  if (!_group) return;
-
-  // Tether rotation speed to commit activity
-  const activity = state.totalActivity();
-  const speed = ROTATION_SPEED_BASE + activity * (ROTATION_SPEED_MAX - ROTATION_SPEED_BASE);
-  _group.rotation.y += speed * delta;
-
-  // Update shader time uniform for scan line animation
-  _surfaceMat.uniforms.uTime.value = elapsed;
-}
-
-export function dispose() {
-  if (_group) _scene.remove(_group);
-  if (_surfaceMat) _surfaceMat.dispose();
-}

modules/panels/heatmap.js

@@ -1,125 +0,0 @@
-// modules/panels/heatmap.js — Commit heatmap floor overlay
-// Canvas-texture circle on the glass platform floor.
-// Each agent occupies a polar sector; recent commits make that sector glow brighter.
-// Activity decays over 24 h (driven by state.zoneIntensity, written by data/gitea.js).
-//
-// Data category: DATA-TETHERED AESTHETIC
-// Data source: state.zoneIntensity (populated from Gitea commits API by data/gitea.js)
-
-import * as THREE from 'three';
-import { state } from '../core/state.js';
-import { NEXUS } from '../core/theme.js';
-import { subscribe } from '../core/ticker.js';
-
-export const HEATMAP_ZONES = [
-  { name: 'Claude',     color: [255, 100,  60], authorMatch: /^claude$/i,   angleDeg:   0 },
-  { name: 'Timmy',      color: [ 60, 160, 255], authorMatch: /^timmy/i,      angleDeg:  90 },
-  { name: 'Kimi',       color: [ 60, 255, 140], authorMatch: /^kimi/i,       angleDeg: 180 },
-  { name: 'Perplexity', color: [200,  60, 255], authorMatch: /^perplexity/i, angleDeg: 270 },
-];
-
-const HEATMAP_SIZE = 512;
-const HEATMAP_ZONE_SPAN_RAD = Math.PI / 2; // 90° per zone
-const GLASS_RADIUS = 4.55; // matches terrain/island.js platform radius
-
-let _canvas, _ctx, _texture, _mesh;
-let _scene;
-
-function _draw() {
-  const cx = HEATMAP_SIZE / 2;
-  const cy = HEATMAP_SIZE / 2;
-  const r  = cx * 0.96;
-
-  _ctx.clearRect(0, 0, HEATMAP_SIZE, HEATMAP_SIZE);
-  _ctx.save();
-  _ctx.beginPath();
-  _ctx.arc(cx, cy, r, 0, Math.PI * 2);
-  _ctx.clip();
-
-  for (const zone of HEATMAP_ZONES) {
-    const intensity = state.zoneIntensity[zone.name] || 0;
-    if (intensity < 0.01) continue;
-
-    const [rr, gg, bb] = zone.color;
-    const baseRad  = zone.angleDeg * (Math.PI / 180);
-    const startRad = baseRad - HEATMAP_ZONE_SPAN_RAD / 2;
-    const endRad   = baseRad + HEATMAP_ZONE_SPAN_RAD / 2;
-    const gx = cx + Math.cos(baseRad) * r * 0.55;
-    const gy = cy + Math.sin(baseRad) * r * 0.55;
-
-    const grad = _ctx.createRadialGradient(gx, gy, 0, gx, gy, r * 0.75);
-    grad.addColorStop(0,    `rgba(${rr},${gg},${bb},${0.65 * intensity})`);
-    grad.addColorStop(0.45, `rgba(${rr},${gg},${bb},${0.25 * intensity})`);
-    grad.addColorStop(1,    `rgba(${rr},${gg},${bb},0)`);
-
-    _ctx.beginPath();
-    _ctx.moveTo(cx, cy);
-    _ctx.arc(cx, cy, r, startRad, endRad);
-    _ctx.closePath();
-    _ctx.fillStyle = grad;
-    _ctx.fill();
-
-    if (intensity > 0.05) {
-      const lx = cx + Math.cos(baseRad) * r * 0.62;
-      const ly = cy + Math.sin(baseRad) * r * 0.62;
-      _ctx.font = `bold ${Math.round(13 * intensity + 7)}px ${NEXUS.theme.fontMono}`;
-      _ctx.fillStyle = `rgba(${rr},${gg},${bb},${Math.min(intensity * 1.2, 0.9)})`;
-      _ctx.textAlign = 'center';
-      _ctx.textBaseline = 'middle';
-      _ctx.fillText(zone.name, lx, ly);
-    }
-  }
-
-  _ctx.restore();
-  _texture.needsUpdate = true;
-}
-
-/** @param {THREE.Scene} scene */
-export function init(scene) {
-  _scene = scene;
-
-  _canvas = document.createElement('canvas');
-  _canvas.width  = HEATMAP_SIZE;
-  _canvas.height = HEATMAP_SIZE;
-  _ctx = _canvas.getContext('2d');
-
-  _texture = new THREE.CanvasTexture(_canvas);
-
-  const mat = new THREE.MeshBasicMaterial({
-    map:       _texture,
-    transparent: true,
-    opacity:   0.9,
-    depthWrite: false,
-    blending:  THREE.AdditiveBlending,
-    side:      THREE.DoubleSide,
-  });
-
-  _mesh = new THREE.Mesh(new THREE.CircleGeometry(GLASS_RADIUS, 64), mat);
-  _mesh.rotation.x = -Math.PI / 2;
-  _mesh.position.y = 0.005;
-  _mesh.userData.zoomLabel = 'Activity Heatmap';
-  scene.add(_mesh);
-
-  // Draw initial empty state
-  _draw();
-
-  subscribe(update);
-}
-
-let _lastDrawElapsed = 0;
-const REDRAW_INTERVAL = 0.5; // redraw at most every 500 ms (data changes slowly)
-
-/**
- * @param {number} elapsed
- * @param {number} _delta
- */
-export function update(elapsed, _delta) {
-  if (elapsed - _lastDrawElapsed < REDRAW_INTERVAL) return;
-  _lastDrawElapsed = elapsed;
-  _draw();
-}
-
-export function dispose() {
-  if (_mesh) { _scene.remove(_mesh); _mesh.geometry.dispose(); _mesh.material.dispose(); }
-  if (_texture) _texture.dispose();
-}

modules/panels/lora-panel.js

@@ -1,167 +0,0 @@
-// modules/panels/lora-panel.js — LoRA Adapter Status holographic panel
-// Shows the model training / LoRA fine-tuning adapter status.
-// Displayed as HONEST-OFFLINE: no adapters are deployed. Panel shows empty state.
-// Will render real adapters when state.loraAdapters is populated in the future.
-//
-// Data category: HONEST-OFFLINE
-// Data source: — (no LoRA adapters deployed; shows "NO ADAPTERS DEPLOYED")
-
-import * as THREE from 'three';
-import { NEXUS } from '../core/theme.js';
-import { subscribe } from '../core/ticker.js';
-
-const PANEL_POS  = new THREE.Vector3(-10.5, 4.5, 2.5);
-const LORA_ACCENT  = NEXUS.theme.loraAccent;
-const LORA_ACTIVE  = NEXUS.theme.loraActive;
-const LORA_OFFLINE = NEXUS.theme.loraInactive;
-const FONT         = NEXUS.theme.fontMono;
-
-let _group, _sprite, _scene;
-
-/**
- * Builds the LoRA panel canvas texture.
- * @param {{ adapters: Array }|null} data
- * @returns {THREE.CanvasTexture}
- */
-function _makeTexture(data) {
-  const W = 420, H = 260;
-  const canvas = document.createElement('canvas');
-  canvas.width  = W;
-  canvas.height = H;
-  const ctx = canvas.getContext('2d');
-
-  ctx.fillStyle = NEXUS.theme.panelBg;
-  ctx.fillRect(0, 0, W, H);
-
-  ctx.strokeStyle = LORA_ACCENT;
-  ctx.lineWidth = 2;
-  ctx.strokeRect(1, 1, W - 2, H - 2);
-  ctx.strokeStyle = LORA_ACCENT;
-  ctx.lineWidth = 1;
-  ctx.globalAlpha = 0.3;
-  ctx.strokeRect(4, 4, W - 8, H - 8);
-  ctx.globalAlpha = 1.0;
-
-  ctx.font = `bold 14px ${FONT}`;
-  ctx.fillStyle = LORA_ACCENT;
-  ctx.textAlign = 'left';
-  ctx.fillText('MODEL TRAINING', 14, 24);
-
-  ctx.font = `10px ${FONT}`;
-  ctx.fillStyle = '#664488';
-  ctx.fillText('LoRA ADAPTERS', 14, 38);
-
-  ctx.strokeStyle = '#2a1a44';
-  ctx.lineWidth = 1;
-  ctx.beginPath(); ctx.moveTo(14, 46); ctx.lineTo(W - 14, 46); ctx.stroke();
-
-  const adapters = data && Array.isArray(data.adapters) ? data.adapters : [];
-
-  if (adapters.length === 0) {
-    // Honest empty state
-    ctx.font = `bold 18px ${FONT}`;
-    ctx.fillStyle = LORA_OFFLINE;
-    ctx.textAlign = 'center';
-    ctx.fillText('NO ADAPTERS DEPLOYED', W / 2, H / 2 + 10);
-    ctx.font = `11px ${FONT}`;
-    ctx.fillStyle = '#223344';
-    ctx.fillText('Adapters will appear here when trained', W / 2, H / 2 + 36);
-    return new THREE.CanvasTexture(canvas);
-  }
-
-  // Active count header
-  const activeCount = adapters.filter(a => a.active).length;
-  ctx.font = `bold 13px ${FONT}`;
-  ctx.fillStyle = LORA_ACTIVE;
-  ctx.textAlign = 'right';
-  ctx.fillText(`${activeCount}/${adapters.length} ACTIVE`, W - 14, 26);
-  ctx.textAlign = 'left';
-
-  // Adapter rows
-  const ROW_H = 44;
-  adapters.forEach((adapter, i) => {
-    const rowY = 50 + i * ROW_H;
-    const col  = adapter.active ? LORA_ACTIVE : LORA_OFFLINE;
-
-    ctx.beginPath();
-    ctx.arc(22, rowY + 12, 6, 0, Math.PI * 2);
-    ctx.fillStyle = col;
-    ctx.fill();
-
-    ctx.font = `bold 13px ${FONT}`;
-    ctx.fillStyle = adapter.active ? '#ddeeff' : '#445566';
-    ctx.fillText(adapter.name, 36, rowY + 16);
-
-    ctx.font = `10px ${FONT}`;
-    ctx.fillStyle = NEXUS.theme.panelDim;
-    ctx.textAlign = 'right';
-    ctx.fillText(adapter.base, W - 14, rowY + 16);
-    ctx.textAlign = 'left';
-
-    if (adapter.active) {
-      const BX = 36, BW = W - 80, BY = rowY + 22, BH = 5;
-      ctx.fillStyle = '#0a1428';
-      ctx.fillRect(BX, BY, BW, BH);
-      ctx.fillStyle = col;
-      ctx.globalAlpha = 0.7;
-      ctx.fillRect(BX, BY, BW * (adapter.strength || 0), BH);
-      ctx.globalAlpha = 1.0;
-    }
-
-    if (i < adapters.length - 1) {
-      ctx.strokeStyle = '#1a0a2a';
-      ctx.lineWidth = 1;
-      ctx.beginPath(); ctx.moveTo(14, rowY + ROW_H - 2); ctx.lineTo(W - 14, rowY + ROW_H - 2); ctx.stroke();
-    }
-  });
-
-  return new THREE.CanvasTexture(canvas);
-}
-
-function _buildSprite(data) {
-  if (_sprite) {
-    _group.remove(_sprite);
-    if (_sprite.material.map) _sprite.material.map.dispose();
-    _sprite.material.dispose();
-    _sprite = null;
-  }
-  const texture  = _makeTexture(data);
-  const material = new THREE.SpriteMaterial({ map: texture, transparent: true, opacity: 0.93, depthWrite: false });
-  _sprite = new THREE.Sprite(material);
-  _sprite.scale.set(6.0, 3.6, 1);
-  _sprite.position.copy(PANEL_POS);
-  _sprite.userData = {
-    baseY:      PANEL_POS.y,
-    floatPhase: 1.1,
-    floatSpeed: 0.14,
-    zoomLabel:  'Model Training — LoRA Adapters',
-  };
-  _group.add(_sprite);
-}
-
-/** @param {THREE.Scene} scene */
-export function init(scene) {
-  _scene = scene;
-  _group = new THREE.Group();
-  scene.add(_group);
-
-  // Honest empty state on init — no adapters deployed
-  _buildSprite({ adapters: [] });
-
-  subscribe(update);
-}
-
-/**
- * @param {number} elapsed
- * @param {number} _delta
- */
-export function update(elapsed, _delta) {
-  if (_sprite) {
-    const ud = _sprite.userData;
-    _sprite.position.y = ud.baseY + Math.sin(elapsed * ud.floatSpeed + ud.floatPhase) * 0.12;
-  }
-}
-
-export function dispose() {
-  if (_group) _scene.remove(_group);
-}

modules/panels/sovereignty.js

@@ -1,147 +0,0 @@
-// modules/panels/sovereignty.js — Sovereignty Meter holographic arc gauge
-// Floating arc gauge above the platform showing the current sovereignty score.
-// Reads from state.sovereignty (populated by data/loaders.js via sovereignty-status.json).
-// The assessment is MANUAL — the panel always labels itself as such.
-//
-// Data category: REAL (manual assessment)
-// Data source: state.sovereignty (sovereignty-status.json via data/loaders.js)
-
-import * as THREE from 'three';
-import { state } from '../core/state.js';
-import { NEXUS } from '../core/theme.js';
-import { subscribe } from '../core/ticker.js';
-
-const FONT = NEXUS.theme.fontMono;
-
-// Defaults shown before data loads
-let _score = 85;
-let _label = 'Mostly Sovereign';
-let _assessmentType = 'MANUAL';
-
-let _group, _arcMesh, _arcMat, _light, _spriteMat, _scene;
-let _lastSovereignty = null;
-
-function _scoreColor(score) {
-  if (score >= 80) return NEXUS.theme.sovereignHighHex;
-  if (score >= 40) return NEXUS.theme.sovereignMidHex;
-  return NEXUS.theme.sovereignLowHex;
-}
-
-function _scoreColorStr(score) {
-  if (score >= 80) return NEXUS.theme.sovereignHigh;
-  if (score >= 40) return NEXUS.theme.sovereignMid;
-  return NEXUS.theme.sovereignLow;
-}
-
-function _buildArcGeo(score) {
-  return new THREE.TorusGeometry(1.6, 0.1, 8, 64, (score / 100) * Math.PI * 2);
-}
-
-function _buildMeterTexture(score, label, assessmentType) {
-  const canvas = document.createElement('canvas');
-  canvas.width  = 256;
-  canvas.height = 128;
-  const ctx = canvas.getContext('2d');
-  const col = _scoreColorStr(score);
-
-  ctx.clearRect(0, 0, 256, 128);
-
-  ctx.font = `bold 52px ${FONT}`;
-  ctx.fillStyle = col;
-  ctx.textAlign = 'center';
-  ctx.fillText(`${score}%`, 128, 50);
-
-  ctx.font = `16px ${FONT}`;
-  ctx.fillStyle = '#8899bb';
-  ctx.fillText(label.toUpperCase(), 128, 74);
-
-  ctx.font = `11px ${FONT}`;
-  ctx.fillStyle = '#445566';
-  ctx.fillText('SOVEREIGNTY', 128, 94);
-
-  ctx.font = `9px ${FONT}`;
-  ctx.fillStyle = '#334455';
-  ctx.fillText('MANUAL ASSESSMENT', 128, 112);
-
-  return new THREE.CanvasTexture(canvas);
-}
-
-function _applyScore(score, label, assessmentType) {
-  _score = score;
-  _label = label;
-  _assessmentType = assessmentType;
-
-  _arcMesh.geometry.dispose();
-  _arcMesh.geometry = _buildArcGeo(score);
-
-  const col = _scoreColor(score);
-  _arcMat.color.setHex(col);
-  _light.color.setHex(col);
-
-  if (_spriteMat.map) _spriteMat.map.dispose();
-  _spriteMat.map = _buildMeterTexture(score, label, assessmentType);
-  _spriteMat.needsUpdate = true;
-}
-
-/** @param {THREE.Scene} scene */
-export function init(scene) {
-  _scene = scene;
-
-  _group = new THREE.Group();
-  _group.position.set(0, 3.8, 0);
-
-  // Background ring
-  const bgMat = new THREE.MeshBasicMaterial({ color: 0x0a1828, transparent: true, opacity: 0.5 });
-  _group.add(new THREE.Mesh(new THREE.TorusGeometry(1.6, 0.1, 8, 64), bgMat));
-
-  // Score arc
-  _arcMat = new THREE.MeshBasicMaterial({
-    color: _scoreColor(_score),
-    transparent: true,
-    opacity: 0.9,
-  });
-  _arcMesh = new THREE.Mesh(_buildArcGeo(_score), _arcMat);
-  _arcMesh.rotation.z = Math.PI / 2; // arc starts at 12 o'clock
-  _group.add(_arcMesh);
-
-  // Glow light
-  _light = new THREE.PointLight(_scoreColor(_score), 0.7, 6);
-  _group.add(_light);
-
-  // Sprite label
-  _spriteMat = new THREE.SpriteMaterial({
-    map: _buildMeterTexture(_score, _label, _assessmentType),
-    transparent: true,
-    depthWrite: false,
-  });
-  const sprite = new THREE.Sprite(_spriteMat);
-  sprite.scale.set(3.2, 1.6, 1);
-  _group.add(sprite);
-
-  scene.add(_group);
-  _group.traverse(obj => {
-    if (obj.isMesh || obj.isSprite) obj.userData.zoomLabel = 'Sovereignty Meter';
-  });
-
-  subscribe(update);
-}
-
-/**
- * @param {number} _elapsed
- * @param {number} _delta
- */
-export function update(_elapsed, _delta) {
-  if (state.sovereignty && state.sovereignty !== _lastSovereignty) {
-    const { score, label, assessment_type } = state.sovereignty;
-    const s = Math.max(0, Math.min(100, typeof score === 'number' ? score : _score));
-    const l = typeof label === 'string' ? label : _label;
-    const t = typeof assessment_type === 'string' ? assessment_type : 'MANUAL';
-    _applyScore(s, l, t);
-    _lastSovereignty = state.sovereignty;
-  }
-}
-
-export function dispose() {
-  if (_group) _scene.remove(_group);
-  if (_spriteMat.map) _spriteMat.map.dispose();
-}

modules/platform.js

@@ -0,0 +1,457 @@
+// === GLASS PLATFORM + PERLIN NOISE + FLOATING ISLAND + CLOUDS ===
+import * as THREE from 'three';
+import { NEXUS } from './constants.js';
+import { scene } from './scene-setup.js';
+
+// === GLASS PLATFORM ===
+const glassPlatformGroup = new THREE.Group();
+
+const platformFrameMat = new THREE.MeshStandardMaterial({
+  color: 0x0a1828,
+  metalness: 0.9,
+  roughness: 0.1,
+  emissive: new THREE.Color(NEXUS.colors.accent).multiplyScalar(0.06),
+});
+
+const platformRimGeo = new THREE.RingGeometry(4.7, 5.3, 64);
+const platformRim = new THREE.Mesh(platformRimGeo, platformFrameMat);
+platformRim.rotation.x = -Math.PI / 2;
+platformRim.castShadow = true;
+platformRim.receiveShadow = true;
+glassPlatformGroup.add(platformRim);
+
+const borderTorusGeo = new THREE.TorusGeometry(5.0, 0.1, 6, 64);
+const borderTorus = new THREE.Mesh(borderTorusGeo, platformFrameMat);
+borderTorus.rotation.x = Math.PI / 2;
+borderTorus.castShadow = true;
+borderTorus.receiveShadow = true;
+glassPlatformGroup.add(borderTorus);
+
+const glassTileMat = new THREE.MeshPhysicalMaterial({
+  color: new THREE.Color(NEXUS.colors.accent),
+  transparent: true,
+  opacity: 0.09,
+  roughness: 0.0,
+  metalness: 0.0,
+  transmission: 0.92,
+  thickness: 0.06,
+  side: THREE.DoubleSide,
+  depthWrite: false,
+});
+
+const glassEdgeBaseMat = new THREE.LineBasicMaterial({
+  color: NEXUS.colors.accent,
+  transparent: true,
+  opacity: 0.55,
+});
+
+export const GLASS_TILE_SIZE = 0.85;
+const GLASS_TILE_GAP = 0.14;
+const GLASS_TILE_STEP = GLASS_TILE_SIZE + GLASS_TILE_GAP;
+export const GLASS_RADIUS = 4.55;
+
+const tileGeo = new THREE.PlaneGeometry(GLASS_TILE_SIZE, GLASS_TILE_SIZE);
+/** @type {Array<{mat: THREE.LineBasicMaterial, distFromCenter: number}>} */
+export const glassEdgeMaterials = []; // kept for API compat; no longer populated
+
+const _tileDummy = new THREE.Object3D();
+/** @type {Array<{x: number, z: number, distFromCenter: number}>} */
+const _tileSlots = [];
+for (let row = -5; row <= 5; row++) {
+  for (let col = -5; col <= 5; col++) {
+    const x = col * GLASS_TILE_STEP;
+    const z = row * GLASS_TILE_STEP;
+    const distFromCenter = Math.sqrt(x * x + z * z);
+    if (distFromCenter > GLASS_RADIUS) continue;
+    _tileSlots.push({ x, z, distFromCenter });
+  }
+}
+
+const glassTileIM = new THREE.InstancedMesh(tileGeo, glassTileMat, _tileSlots.length);
+glassTileIM.instanceMatrix.setUsage(THREE.StaticDrawUsage);
+_tileDummy.rotation.x = -Math.PI / 2;
+for (let i = 0; i < _tileSlots.length; i++) {
+  const { x, z } = _tileSlots[i];
+  _tileDummy.position.set(x, 0, z);
+  _tileDummy.updateMatrix();
+  glassTileIM.setMatrixAt(i, _tileDummy.matrix);
+}
+glassTileIM.instanceMatrix.needsUpdate = true;
+glassPlatformGroup.add(glassTileIM);
+
+// Merge all tile edge geometry into a single LineSegments draw call.
+// Each tile contributes 4 edges (8 vertices). Previously this was 69 separate
+// LineSegments objects with cloned materials — a significant draw-call overhead.
+const _HS = GLASS_TILE_SIZE / 2;
+const _edgeVerts = new Float32Array(_tileSlots.length * 8 * 3);
+let _evi = 0;
+for (const { x, z } of _tileSlots) {
+  const y = 0.002;
+  _edgeVerts[_evi++]=x-_HS; _edgeVerts[_evi++]=y; _edgeVerts[_evi++]=z-_HS;
+  _edgeVerts[_evi++]=x+_HS; _edgeVerts[_evi++]=y; _edgeVerts[_evi++]=z-_HS;
+  _edgeVerts[_evi++]=x+_HS; _edgeVerts[_evi++]=y; _edgeVerts[_evi++]=z-_HS;
+  _edgeVerts[_evi++]=x+_HS; _edgeVerts[_evi++]=y; _edgeVerts[_evi++]=z+_HS;
+  _edgeVerts[_evi++]=x+_HS; _edgeVerts[_evi++]=y; _edgeVerts[_evi++]=z+_HS;
+  _edgeVerts[_evi++]=x-_HS; _edgeVerts[_evi++]=y; _edgeVerts[_evi++]=z+_HS;
+  _edgeVerts[_evi++]=x-_HS; _edgeVerts[_evi++]=y; _edgeVerts[_evi++]=z+_HS;
+  _edgeVerts[_evi++]=x-_HS; _edgeVerts[_evi++]=y; _edgeVerts[_evi++]=z-_HS;
+}
+const _mergedEdgeGeo = new THREE.BufferGeometry();
+_mergedEdgeGeo.setAttribute('position', new THREE.BufferAttribute(_edgeVerts, 3));
+glassPlatformGroup.add(new THREE.LineSegments(_mergedEdgeGeo, glassEdgeBaseMat));
+
+export const voidLight = new THREE.PointLight(NEXUS.colors.accent, 0.5, 14);
+voidLight.position.set(0, -3.5, 0);
+glassPlatformGroup.add(voidLight);
+
+scene.add(glassPlatformGroup);
+glassPlatformGroup.traverse(obj => {
+  if (obj.isMesh) obj.userData.zoomLabel = 'Glass Platform';
+});
+
+// === PERLIN NOISE ===
+function createPerlinNoise() {
+  const p = new Uint8Array(256);
+  for (let i = 0; i < 256; i++) p[i] = i;
+  let seed = 42;
+  function seededRand() {
+    seed = (seed * 1664525 + 1013904223) & 0xffffffff;
+    return (seed >>> 0) / 0xffffffff;
+  }
+  for (let i = 255; i > 0; i--) {
+    const j = Math.floor(seededRand() * (i + 1));
+    const tmp = p[i]; p[i] = p[j]; p[j] = tmp;
+  }
+  const perm = new Uint8Array(512);
+  for (let i = 0; i < 512; i++) perm[i] = p[i & 255];
+
+  function fade(t) { return t * t * t * (t * (t * 6 - 15) + 10); }
+  function lerp(a, b, t) { return a + t * (b - a); }
+  function grad(hash, x, y, z) {
+    const h = hash & 15;
+    const u = h < 8 ? x : y;
+    const v = h < 4 ? y : (h === 12 || h === 14) ? x : z;
+    return ((h & 1) ? -u : u) + ((h & 2) ? -v : v);
+  }
+
+  return function noise(x, y, z) {
+    z = z || 0;
+    const X = Math.floor(x) & 255, Y = Math.floor(y) & 255, Z = Math.floor(z) & 255;
+    x -= Math.floor(x); y -= Math.floor(y); z -= Math.floor(z);
+    const u = fade(x), v = fade(y), w = fade(z);
+    const A = perm[X] + Y, AA = perm[A] + Z, AB = perm[A + 1] + Z;
+    const B = perm[X + 1] + Y, BA = perm[B] + Z, BB = perm[B + 1] + Z;
+    return lerp(
+      lerp(lerp(grad(perm[AA],     x,   y,   z  ), grad(perm[BA],     x-1, y,   z  ), u),
+           lerp(grad(perm[AB],     x,   y-1, z  ), grad(perm[BB],     x-1, y-1, z  ), u), v),
+      lerp(lerp(grad(perm[AA + 1], x,   y,   z-1), grad(perm[BA + 1], x-1, y,   z-1), u),
+           lerp(grad(perm[AB + 1], x,   y-1, z-1), grad(perm[BB + 1], x-1, y-1, z-1), u), v),
+      w
+    );
+  };
+}
+
+const perlin = createPerlinNoise();
+
+// === FLOATING ISLAND TERRAIN ===
+(function buildFloatingIsland() {
+  const ISLAND_RADIUS = 9.5;
+  const SEGMENTS = 96;
+  const SIZE = ISLAND_RADIUS * 2;
+
+  function islandFBm(nx, nz) {
+    const wx = perlin(nx * 0.5 + 3.7, nz * 0.5 + 1.2) * 0.55;
+    const wz = perlin(nx * 0.5 + 8.3, nz * 0.5 + 5.9) * 0.55;
+    const px = nx + wx, pz = nz + wz;
+
+    let h = 0;
+    h += perlin(px,        pz       ) * 1.000;
+    h += perlin(px * 2,    pz * 2   ) * 0.500;
+    h += perlin(px * 4,    pz * 4   ) * 0.250;
+    h += perlin(px * 8,    pz * 8   ) * 0.125;
+    h += perlin(px * 16,   pz * 16  ) * 0.063;
+    h /= 1.938;
+
+    const ridge = 1.0 - Math.abs(perlin(px * 3.1 + 5.0, pz * 3.1 + 7.0));
+    return h * 0.78 + ridge * 0.22;
+  }
+
+  const geo = new THREE.PlaneGeometry(SIZE, SIZE, SEGMENTS, SEGMENTS);
+  geo.rotateX(-Math.PI / 2);
+  const pos = geo.attributes.position;
+  const vCount = pos.count;
+
+  const rawHeights = new Float32Array(vCount);
+
+  for (let i = 0; i < vCount; i++) {
+    const x = pos.getX(i);
+    const z = pos.getZ(i);
+    const dist = Math.sqrt(x * x + z * z) / ISLAND_RADIUS;
+
+    const rimNoise = perlin(x * 0.38 + 10, z * 0.38 + 10) * 0.10;
+    const edgeFactor = Math.max(0, 1 - Math.pow(Math.max(0, dist - rimNoise), 2.4));
+
+    const h = islandFBm(x * 0.15, z * 0.15);
+    const height = ((h + 1) * 0.5) * edgeFactor * 3.2;
+    pos.setY(i, height);
+    rawHeights[i] = height;
+  }
+
+  geo.computeVertexNormals();
+
+  const colBuf = new Float32Array(vCount * 3);
+  for (let i = 0; i < vCount; i++) {
+    const h = rawHeights[i];
+    let r, g, b;
+    if (h < 0.25) {
+      r = 0.11; g = 0.09; b = 0.07;
+    } else if (h < 0.75) {
+      const t = (h - 0.25) / 0.50;
+      r = 0.11 + t * 0.13; g = 0.09 + t * 0.09; b = 0.07 + t * 0.06;
+    } else if (h < 1.4) {
+      const t = (h - 0.75) / 0.65;
+      r = 0.24 + t * 0.12; g = 0.18 + t * 0.10; b = 0.13 + t * 0.10;
+    } else if (h < 2.2) {
+      const t = (h - 1.4) / 0.80;
+      r = 0.36 + t * 0.14; g = 0.28 + t * 0.11; b = 0.23 + t * 0.13;
+    } else {
+      const t = Math.min(1, (h - 2.2) / 0.9);
+      r = 0.50 + t * 0.05;
+      g = 0.39 + t * 0.10;
+      b = 0.36 + t * 0.28;
+    }
+    colBuf[i * 3]     = r;
+    colBuf[i * 3 + 1] = g;
+    colBuf[i * 3 + 2] = b;
+  }
+  geo.setAttribute('color', new THREE.BufferAttribute(colBuf, 3));
+
+  const topMat = new THREE.MeshStandardMaterial({
+    vertexColors: true,
+    roughness: 0.86,
+    metalness: 0.05,
+  });
+  const topMesh = new THREE.Mesh(geo, topMat);
+  topMesh.castShadow = true;
+  topMesh.receiveShadow = true;
+
+  const crystalMat = new THREE.MeshStandardMaterial({
+    color: new THREE.Color(NEXUS.colors.accent).multiplyScalar(0.55),
+    emissive: new THREE.Color(NEXUS.colors.accent),
+    emissiveIntensity: 0.5,
+    roughness: 0.08,
+    metalness: 0.25,
+    transparent: true,
+    opacity: 0.80,
+  });
+
+  const CRYSTAL_MIN_H = 2.05;
+
+  /** @type {Array<{sx:number,sz:number,posY:number,rotX:number,rotZ:number,scaleXZ:number,scaleY:number}>} */
+  const _spireData = [];
+  for (let row = -5; row <= 5; row++) {
+    for (let col = -5; col <= 5; col++) {
+      const bx = col * 1.75, bz = row * 1.75;
+      if (Math.sqrt(bx * bx + bz * bz) > ISLAND_RADIUS * 0.72) continue;
+
+      const edF = Math.max(0, 1 - Math.pow(Math.sqrt(bx * bx + bz * bz) / ISLAND_RADIUS, 2.4));
+      const candidateH = ((islandFBm(bx * 0.15, bz * 0.15) + 1) * 0.5) * edF * 3.2;
+      if (candidateH < CRYSTAL_MIN_H) continue;
+
+      const jx = bx + perlin(bx * 0.7 + 20, bz * 0.7 + 20) * 0.55;
+      const jz = bz + perlin(bx * 0.7 + 30, bz * 0.7 + 30) * 0.55;
+      if (Math.sqrt(jx * jx + jz * jz) > ISLAND_RADIUS * 0.68) continue;
+
+      const clusterSize = 2 + Math.floor(Math.abs(perlin(bx * 0.5 + 40, bz * 0.5 + 40)) * 3);
+      for (let c = 0; c < clusterSize; c++) {
+        const angle = (c / clusterSize) * Math.PI * 2 + perlin(bx + c, bz + c) * 1.4;
+        const spread = 0.08 + Math.abs(perlin(bx + c * 5, bz + c * 5)) * 0.22;
+        const sx = jx + Math.cos(angle) * spread;
+        const sz = jz + Math.sin(angle) * spread;
+        const spireScale = 0.14 + (candidateH - CRYSTAL_MIN_H) * 0.11;
+        const spireH = spireScale * (0.8 + Math.abs(perlin(sx, sz)) * 0.45);
+        const spireR = spireH * 0.17;
+        _spireData.push({
+          sx, sz,
+          posY: candidateH + spireH * 0.5,
+          rotX: perlin(sx * 3 + 1, sz * 3 + 1) * 0.18,
+          rotZ: perlin(sx * 2, sz * 2) * 0.28,
+          scaleXZ: spireR,
+          scaleY: spireH * 2.8,
+        });
+      }
+    }
+  }
+
+  const _spireDummy = new THREE.Object3D();
+  const spireBaseGeo = new THREE.ConeGeometry(1, 1, 5);
+  const crystalGroup = new THREE.Group();
+  const spireIM = new THREE.InstancedMesh(spireBaseGeo, crystalMat, _spireData.length);
+  spireIM.castShadow = true;
+  spireIM.instanceMatrix.setUsage(THREE.StaticDrawUsage);
+  for (let i = 0; i < _spireData.length; i++) {
+    const { sx, sz, posY, rotX, rotZ, scaleXZ, scaleY } = _spireData[i];
+    _spireDummy.position.set(sx, posY, sz);
+    _spireDummy.rotation.set(rotX, 0, rotZ);
+    _spireDummy.scale.set(scaleXZ, scaleY, scaleXZ);
+    _spireDummy.updateMatrix();
+    spireIM.setMatrixAt(i, _spireDummy.matrix);
+  }
+  spireIM.instanceMatrix.needsUpdate = true;
+  crystalGroup.add(spireIM);
+
+  const BOTTOM_SEGS_R = 52;
+  const BOTTOM_SEGS_V = 10;
+  const BOTTOM_HEIGHT = 2.6;
+  const bottomGeo = new THREE.CylinderGeometry(
+    ISLAND_RADIUS * 0.80, ISLAND_RADIUS * 0.28,
+    BOTTOM_HEIGHT, BOTTOM_SEGS_R, BOTTOM_SEGS_V, true
+  );
+  const bPos = bottomGeo.attributes.position;
+  for (let i = 0; i < bPos.count; i++) {
+    const bx = bPos.getX(i);
+    const bz = bPos.getZ(i);
+    const by = bPos.getY(i);
+    const angle = Math.atan2(bz, bx);
+    const r = Math.sqrt(bx * bx + bz * bz);
+
+    const radDisp = perlin(Math.cos(angle) * 1.6 + 50, Math.sin(angle) * 1.6 + 50) * 0.65;
+    const vNorm = (by + BOTTOM_HEIGHT * 0.5) / BOTTOM_HEIGHT;
+    const stalDisp = (1 - vNorm) * Math.abs(perlin(bx * 0.35 + 70, by * 0.7 + bz * 0.35)) * 0.9;
+
+    const newR = r + radDisp;
+    bPos.setX(i, (bx / r) * newR);
+    bPos.setZ(i, (bz / r) * newR);
+    bPos.setY(i, by - stalDisp);
+  }
+  bottomGeo.computeVertexNormals();
+
+  const bottomMat = new THREE.MeshStandardMaterial({ color: 0x0c0a08, roughness: 0.93, metalness: 0.02 });
+  const bottomMesh = new THREE.Mesh(bottomGeo, bottomMat);
+  bottomMesh.position.y = -BOTTOM_HEIGHT * 0.5;
+  bottomMesh.castShadow = true;
+
+  const capGeo = new THREE.CircleGeometry(ISLAND_RADIUS * 0.28, 48);
+  capGeo.rotateX(Math.PI / 2);
+  const capMesh = new THREE.Mesh(capGeo, bottomMat);
+  capMesh.position.y = -(BOTTOM_HEIGHT + 0.1);
+
+  const islandGroup = new THREE.Group();
+  islandGroup.add(topMesh);
+  islandGroup.add(crystalGroup);
+  islandGroup.add(bottomMesh);
+  islandGroup.add(capMesh);
+  islandGroup.position.y = -2.8;
+  scene.add(islandGroup);
+})();
+
+// === PROCEDURAL CLOUD LAYER ===
+const CLOUD_LAYER_Y = -6.0;
+const CLOUD_DIMENSIONS = 120;
+const CLOUD_THICKNESS = 15;
+const CLOUD_OPACITY = 0.6;
+
+const cloudGeometry = new THREE.BoxGeometry(CLOUD_DIMENSIONS, CLOUD_THICKNESS, CLOUD_DIMENSIONS, 8, 4, 8);
+
+const CloudShader = {
+  uniforms: {
+    'uTime': { value: 0.0 },
+    'uCloudColor': { value: new THREE.Color(0x88bbff) },
+    'uNoiseScale': { value: new THREE.Vector3(0.015, 0.015, 0.015) },
+    'uDensity': { value: 0.8 },
+  },
+  vertexShader: `
+    varying vec3 vWorldPosition;
+    void main() {
+      vWorldPosition = (modelMatrix * vec4(position, 1.0)).xyz;
+      gl_Position = projectionMatrix * modelViewMatrix * vec4(position, 1.0);
+    }
+  `,
+  fragmentShader: `
+    uniform float uTime;
+    uniform vec3 uCloudColor;
+    uniform vec3 uNoiseScale;
+    uniform float uDensity;
+    varying vec3 vWorldPosition;
+
+    vec3 mod289(vec3 x) { return x - floor(x * (1.0 / 289.0)) * 289.0; }
+    vec4 mod289(vec4 x) { return x - floor(x * (1.0 / 289.0)) * 289.0; }
+    vec4 permute(vec4 x) { return mod289(((x * 34.0) + 1.0) * x); }
+    vec4 taylorInvSqrt(vec4 r) { return 1.79284291400159 - 0.85373472095314 * r; }
+    float snoise(vec3 v) {
+      const vec2 C = vec2(1.0/6.0, 1.0/3.0);
+      const vec4 D = vec4(0.0, 0.5, 1.0, 2.0);
+      vec3 i  = floor(v + dot(v, C.yyy));
+      vec3 x0 = v - i + dot(i, C.xxx);
+      vec3 g  = step(x0.yzx, x0.xyz);
+      vec3 l  = 1.0 - g;
+      vec3 i1 = min(g.xyz, l.zxy);
+      vec3 i2 = max(g.xyz, l.zxy);
+      vec3 x1 = x0 - i1 + C.xxx;
+      vec3 x2 = x0 - i2 + C.yyy;
+      vec3 x3 = x0 - D.yyy;
+      i = mod289(i);
+      vec4 p = permute(permute(permute(
+              i.z + vec4(0.0, i1.z, i2.z, 1.0))
+            + i.y + vec4(0.0, i1.y, i2.y, 1.0))
+            + i.x + vec4(0.0, i1.x, i2.x, 1.0));
+      float n_ = 0.142857142857;
+      vec3 ns = n_ * D.wyz - D.xzx;
+      vec4 j  = p - 49.0 * floor(p * ns.z * ns.z);
+      vec4 x_ = floor(j * ns.z);
+      vec4 y_ = floor(j - 7.0 * x_);
+      vec4 x  = x_ * ns.x + ns.yyyy;
+      vec4 y  = y_ * ns.x + ns.yyyy;
+      vec4 h  = 1.0 - abs(x) - abs(y);
+      vec4 b0 = vec4(x.xy, y.xy);
+      vec4 b1 = vec4(x.zw, y.zw);
+      vec4 s0 = floor(b0) * 2.0 + 1.0;
+      vec4 s1 = floor(b1) * 2.0 + 1.0;
+      vec4 sh = -step(h, vec4(0.0));
+      vec4 a0 = b0.xzyw + s0.xzyw * sh.xxyy;
+      vec4 a1 = b1.xzyw + s1.xzyw * sh.zzww;
+      vec3 p0 = vec3(a0.xy, h.x);
+      vec3 p1 = vec3(a0.zw, h.y);
+      vec3 p2 = vec3(a1.xy, h.z);
+      vec3 p3 = vec3(a1.zw, h.w);
+      vec4 norm = taylorInvSqrt(vec4(dot(p0,p0), dot(p1,p1), dot(p2,p2), dot(p3,p3)));
+      p0 *= norm.x; p1 *= norm.y; p2 *= norm.z; p3 *= norm.w;
+      vec4 m = max(0.6 - vec4(dot(x0,x0), dot(x1,x1), dot(x2,x2), dot(x3,x3)), 0.0);
+      m = m * m;
+      return 42.0 * dot(m*m, vec4(dot(p0,x0), dot(p1,x1), dot(p2,x2), dot(p3,x3)));
+    }
+
+    void main() {
+      vec3 noiseCoord = vWorldPosition * uNoiseScale + vec3(uTime * 0.003, 0.0, uTime * 0.002);
+
+      float noiseVal  = snoise(noiseCoord)       * 0.500;
+      noiseVal       += snoise(noiseCoord * 2.0) * 0.250;
+      noiseVal       += snoise(noiseCoord * 4.0) * 0.125;
+      noiseVal /= 0.875;
+
+      float density = smoothstep(0.25, 0.85, noiseVal * 0.5 + 0.5);
+      density *= uDensity;
+
+      float layerBottom = ${(CLOUD_LAYER_Y - CLOUD_THICKNESS * 0.5).toFixed(1)};
+      float yNorm = (vWorldPosition.y - layerBottom) / ${CLOUD_THICKNESS.toFixed(1)};
+      float fadeFactor = smoothstep(0.0, 0.15, yNorm) * smoothstep(1.0, 0.85, yNorm);
+
+      gl_FragColor = vec4(uCloudColor, density * fadeFactor * ${CLOUD_OPACITY.toFixed(1)});
+      if (gl_FragColor.a < 0.04) discard;
+    }
+  `,
+};
+
+export const cloudMaterial = new THREE.ShaderMaterial({
+  uniforms: CloudShader.uniforms,
+  vertexShader: CloudShader.vertexShader,
+  fragmentShader: CloudShader.fragmentShader,
+  transparent: true,
+  depthWrite: false,
+  blending: THREE.AdditiveBlending,
+  side: THREE.DoubleSide,
+});
+
+const clouds = new THREE.Mesh(cloudGeometry, cloudMaterial);
+clouds.position.y = CLOUD_LAYER_Y;
+scene.add(clouds);

modules/portals.js

@@ -0,0 +1,90 @@
+// === PORTALS ===
+import * as THREE from 'three';
+import { scene } from './scene-setup.js';
+import { rebuildRuneRing, setPortalsRef } from './effects.js';
+import { setPortalsRefAudio, startPortalHums } from './audio.js';
+import { S } from './state.js';
+
+export const portalGroup = new THREE.Group();
+scene.add(portalGroup);
+
+export let portals = [];
+
+// Shared geometry and material for all portal tori — populated in createPortals()
+const _portalGeo = new THREE.TorusGeometry(3.0, 0.2, 16, 100);
+const _portalMat = new THREE.MeshBasicMaterial({
+  color: 0xffffff,  // instance color provides per-portal tint
+  transparent: true,
+  opacity: 1.0,     // online/offline brightness encoded into instance color
+  blending: THREE.AdditiveBlending,
+  side: THREE.DoubleSide,
+  depthWrite: false,
+});
+const _portalDummy = new THREE.Object3D();
+const _portalColor = new THREE.Color();
+
+/** @type {THREE.InstancedMesh|null} */
+let _portalIM = null;
+
+function createPortals() {
+  // One InstancedMesh for all portal tori — N portals = 1 draw call.
+  _portalIM = new THREE.InstancedMesh(_portalGeo, _portalMat, portals.length);
+  _portalIM.instanceMatrix.setUsage(THREE.DynamicDrawUsage);
+  _portalIM.userData.zoomLabel = 'Portal';
+  _portalIM.userData.portals = portals; // for instanceId look-up on click
+
+  portals.forEach((portal, i) => {
+    const isOnline = portal.status === 'online';
+    // Encode online/offline brightness into the instance color so we need
+    // only one shared material (AdditiveBlending: output = bg + color).
+    _portalColor.set(portal.color).convertSRGBToLinear()
+      .multiplyScalar(isOnline ? 0.7 : 0.15);
+    _portalIM.setColorAt(i, _portalColor);
+
+    _portalDummy.position.set(portal.position.x, portal.position.y + 0.5, portal.position.z);
+    _portalDummy.rotation.set(Math.PI / 2, portal.rotation.y || 0, 0);
+    _portalDummy.updateMatrix();
+    _portalIM.setMatrixAt(i, _portalDummy.matrix);
+  });
+
+  _portalIM.instanceColor.needsUpdate = true;
+  _portalIM.instanceMatrix.needsUpdate = true;
+  portalGroup.add(_portalIM);
+}
+
+/** Update per-instance colors after a portal health check. */
+export function refreshPortalInstanceColors() {
+  if (!_portalIM) return;
+  portals.forEach((portal, i) => {
+    const brightness = portal.status === 'online' ? 0.7 : 0.15;
+    _portalColor.set(portal.color).convertSRGBToLinear().multiplyScalar(brightness);
+    _portalIM.setColorAt(i, _portalColor);
+  });
+  _portalIM.instanceColor.needsUpdate = true;
+}
+
+// rebuildGravityZones forward ref
+let _rebuildGravityZonesFn = null;
+export function setRebuildGravityZonesFn(fn) { _rebuildGravityZonesFn = fn; }
+
+// runPortalHealthChecks forward ref
+let _runPortalHealthChecksFn = null;
+export function setRunPortalHealthChecksFn(fn) { _runPortalHealthChecksFn = fn; }
+
+export async function loadPortals() {
+  try {
+    const res = await fetch('./portals.json');
+    if (!res.ok) throw new Error('Portals not found');
+    portals = await res.json();
+    console.log('Loaded portals:', portals);
+    setPortalsRef(portals);
+    setPortalsRefAudio(portals);
+    createPortals();
+    rebuildRuneRing();
+    if (_rebuildGravityZonesFn) _rebuildGravityZonesFn();
+    startPortalHums();
+    if (_runPortalHealthChecksFn) _runPortalHealthChecksFn();
+  } catch (error) {
+    console.error('Failed to load portals:', error);
+  }
+}

modules/scene-setup.js

@@ -0,0 +1,122 @@
+// === SCENE SETUP + LIGHTING + SHADOWS + STAR FIELD + CONSTELLATION LINES ===
+import * as THREE from 'three';
+import { NEXUS } from './constants.js';
+
+// === SCENE SETUP ===
+export const scene = new THREE.Scene();
+
+export const camera = new THREE.PerspectiveCamera(75, window.innerWidth / window.innerHeight, 0.1, 2000);
+camera.position.set(0, 6, 11);
+
+export const raycaster = new THREE.Raycaster();
+export const forwardVector = new THREE.Vector3();
+
+// === LIGHTING ===
+export const ambientLight = new THREE.AmbientLight(0x0a1428, 1.4);
+scene.add(ambientLight);
+
+export const overheadLight = new THREE.SpotLight(0x8899bb, 0.6, 80, Math.PI / 3.5, 0.5, 1.0);
+overheadLight.position.set(0, 25, 0);
+overheadLight.target.position.set(0, 0, 0);
+overheadLight.castShadow = true;
+overheadLight.shadow.mapSize.set(2048, 2048);
+overheadLight.shadow.camera.near = 5;
+overheadLight.shadow.camera.far = 60;
+overheadLight.shadow.bias = -0.001;
+scene.add(overheadLight);
+scene.add(overheadLight.target);
+
+export const renderer = new THREE.WebGLRenderer({ antialias: true, alpha: true });
+renderer.setClearColor(0x000000, 0);
+renderer.setPixelRatio(window.devicePixelRatio);
+renderer.setSize(window.innerWidth, window.innerHeight);
+// === SHADOW SYSTEM ===
+renderer.shadowMap.enabled = true;
+renderer.shadowMap.type = THREE.PCFSoftShadowMap;
+document.body.appendChild(renderer.domElement);
+
+// === STAR FIELD ===
+const STAR_COUNT = 800;
+const STAR_SPREAD = 400;
+const CONSTELLATION_DISTANCE = 30;
+
+const starPositions = [];
+const starGeo = new THREE.BufferGeometry();
+const posArray = new Float32Array(STAR_COUNT * 3);
+const sizeArray = new Float32Array(STAR_COUNT);
+
+for (let i = 0; i < STAR_COUNT; i++) {
+  const x = (Math.random() - 0.5) * STAR_SPREAD;
+  const y = (Math.random() - 0.5) * STAR_SPREAD;
+  const z = (Math.random() - 0.5) * STAR_SPREAD;
+  posArray[i * 3] = x;
+  posArray[i * 3 + 1] = y;
+  posArray[i * 3 + 2] = z;
+  sizeArray[i] = Math.random() * 2.5 + 0.5;
+  starPositions.push(new THREE.Vector3(x, y, z));
+}
+
+starGeo.setAttribute('position', new THREE.BufferAttribute(posArray, 3));
+starGeo.setAttribute('size', new THREE.BufferAttribute(sizeArray, 1));
+
+export const starMaterial = new THREE.PointsMaterial({
+  color: NEXUS.colors.starCore,
+  size: 0.6,
+  sizeAttenuation: true,
+  transparent: true,
+  opacity: 0.9,
+});
+
+export const stars = new THREE.Points(starGeo, starMaterial);
+scene.add(stars);
+
+// Star pulse state
+export const STAR_BASE_OPACITY = 0.3;
+export const STAR_PEAK_OPACITY = 1.0;
+export const STAR_PULSE_DECAY = 0.012;
+
+// === CONSTELLATION LINES ===
+function buildConstellationLines() {
+  const linePositions = [];
+  const MAX_CONNECTIONS_PER_STAR = 3;
+  const connectionCount = new Array(STAR_COUNT).fill(0);
+
+  for (let i = 0; i < STAR_COUNT; i++) {
+    if (connectionCount[i] >= MAX_CONNECTIONS_PER_STAR) continue;
+
+    const neighbors = [];
+    for (let j = i + 1; j < STAR_COUNT; j++) {
+      if (connectionCount[j] >= MAX_CONNECTIONS_PER_STAR) continue;
+      const dist = starPositions[i].distanceTo(starPositions[j]);
+      if (dist < CONSTELLATION_DISTANCE) {
+        neighbors.push({ j, dist });
+      }
+    }
+
+    neighbors.sort((a, b) => a.dist - b.dist);
+    const toConnect = neighbors.slice(0, MAX_CONNECTIONS_PER_STAR - connectionCount[i]);
+
+    for (const { j } of toConnect) {
+      linePositions.push(
+        starPositions[i].x, starPositions[i].y, starPositions[i].z,
+        starPositions[j].x, starPositions[j].y, starPositions[j].z
+      );
+      connectionCount[i]++;
+      connectionCount[j]++;
+    }
+  }
+
+  const lineGeo = new THREE.BufferGeometry();
+  lineGeo.setAttribute('position', new THREE.BufferAttribute(new Float32Array(linePositions), 3));
+
+  const lineMat = new THREE.LineBasicMaterial({
+    color: NEXUS.colors.constellationLine,
+    transparent: true,
+    opacity: 0.18,
+  });
+
+  return new THREE.LineSegments(lineGeo, lineMat);
+}
+
+export const constellationLines = buildConstellationLines();
+scene.add(constellationLines);

modules/sigil.js

@@ -0,0 +1,182 @@
+// === TIMMY SIGIL ===
+import * as THREE from 'three';
+import { scene } from './scene-setup.js';
+
+const SIGIL_CANVAS_SIZE = 512;
+const SIGIL_RADIUS = 3.8;
+
+function drawSigilCanvas() {
+  const canvas = document.createElement('canvas');
+  canvas.width = SIGIL_CANVAS_SIZE;
+  canvas.height = SIGIL_CANVAS_SIZE;
+  const ctx = canvas.getContext('2d');
+  const cx = SIGIL_CANVAS_SIZE / 2;
+  const cy = SIGIL_CANVAS_SIZE / 2;
+  const r = cx * 0.88;
+
+  ctx.clearRect(0, 0, SIGIL_CANVAS_SIZE, SIGIL_CANVAS_SIZE);
+
+  const bgGrad = ctx.createRadialGradient(cx, cy, 0, cx, cy, r);
+  bgGrad.addColorStop(0,   'rgba(0, 200, 255, 0.10)');
+  bgGrad.addColorStop(0.5, 'rgba(0, 100, 200, 0.04)');
+  bgGrad.addColorStop(1,   'rgba(0, 0, 0, 0)');
+  ctx.fillStyle = bgGrad;
+  ctx.fillRect(0, 0, SIGIL_CANVAS_SIZE, SIGIL_CANVAS_SIZE);
+
+  function glowCircle(x, y, radius, color, alpha, lineW) {
+    ctx.save();
+    ctx.globalAlpha = alpha;
+    ctx.strokeStyle = color;
+    ctx.lineWidth = lineW;
+    ctx.shadowColor = color;
+    ctx.shadowBlur = 12;
+    ctx.beginPath();
+    ctx.arc(x, y, radius, 0, Math.PI * 2);
+    ctx.stroke();
+    ctx.restore();
+  }
+
+  function hexagram(ox, oy, hr, color, alpha) {
+    ctx.save();
+    ctx.globalAlpha = alpha;
+    ctx.strokeStyle = color;
+    ctx.lineWidth = 1.4;
+    ctx.shadowColor = color;
+    ctx.shadowBlur = 10;
+    ctx.beginPath();
+    for (let i = 0; i < 3; i++) {
+      const a = (i / 3) * Math.PI * 2 - Math.PI / 2;
+      const px = ox + Math.cos(a) * hr;
+      const py = oy + Math.sin(a) * hr;
+      i === 0 ? ctx.moveTo(px, py) : ctx.lineTo(px, py);
+    }
+    ctx.closePath();
+    ctx.stroke();
+    ctx.beginPath();
+    for (let i = 0; i < 3; i++) {
+      const a = (i / 3) * Math.PI * 2 + Math.PI / 2;
+      const px = ox + Math.cos(a) * hr;
+      const py = oy + Math.sin(a) * hr;
+      i === 0 ? ctx.moveTo(px, py) : ctx.lineTo(px, py);
+    }
+    ctx.closePath();
+    ctx.stroke();
+    ctx.restore();
+  }
+
+  const petalR = r * 0.32;
+
+  glowCircle(cx, cy, petalR, '#00ccff', 0.65, 1.0);
+
+  for (let i = 0; i < 6; i++) {
+    const a = (i / 6) * Math.PI * 2;
+    glowCircle(cx + Math.cos(a) * petalR, cy + Math.sin(a) * petalR, petalR, '#00aadd', 0.50, 0.8);
+  }
+
+  for (let i = 0; i < 6; i++) {
+    const a = (i / 6) * Math.PI * 2 + Math.PI / 6;
+    glowCircle(cx + Math.cos(a) * petalR * 1.73, cy + Math.sin(a) * petalR * 1.73, petalR, '#0077aa', 0.25, 0.6);
+  }
+
+  hexagram(cx, cy, r * 0.62, '#ffd700', 0.75);
+  hexagram(cx, cy, r * 0.41, '#ffaa00', 0.50);
+
+  glowCircle(cx, cy, r * 0.92, '#0055aa', 0.40, 0.8);
+  glowCircle(cx, cy, r * 0.72, '#0099cc', 0.38, 0.8);
+  glowCircle(cx, cy, r * 0.52, '#00ccff', 0.42, 0.9);
+  glowCircle(cx, cy, r * 0.18, '#ffd700', 0.65, 1.2);
+
+  ctx.save();
+  ctx.globalAlpha = 0.28;
+  ctx.strokeStyle = '#00aaff';
+  ctx.lineWidth = 0.6;
+  ctx.shadowColor = '#00aaff';
+  ctx.shadowBlur = 5;
+  for (let i = 0; i < 12; i++) {
+    const a = (i / 12) * Math.PI * 2;
+    ctx.beginPath();
+    ctx.moveTo(cx + Math.cos(a) * r * 0.18, cy + Math.sin(a) * r * 0.18);
+    ctx.lineTo(cx + Math.cos(a) * r * 0.91, cy + Math.sin(a) * r * 0.91);
+    ctx.stroke();
+  }
+  ctx.restore();
+
+  ctx.save();
+  ctx.fillStyle = '#00ffcc';
+  ctx.shadowColor = '#00ffcc';
+  ctx.shadowBlur = 9;
+  for (let i = 0; i < 12; i++) {
+    const a = (i / 12) * Math.PI * 2;
+    ctx.globalAlpha = i % 2 === 0 ? 0.80 : 0.50;
+    ctx.beginPath();
+    ctx.arc(cx + Math.cos(a) * r * 0.91, cy + Math.sin(a) * r * 0.91, i % 2 === 0 ? 4 : 2.5, 0, Math.PI * 2);
+    ctx.fill();
+  }
+  ctx.restore();
+
+  ctx.save();
+  ctx.globalAlpha = 1.0;
+  ctx.fillStyle = '#ffffff';
+  ctx.shadowColor = '#88ddff';
+  ctx.shadowBlur = 18;
+  ctx.beginPath();
+  ctx.arc(cx, cy, 5, 0, Math.PI * 2);
+  ctx.fill();
+  ctx.restore();
+
+  return canvas;
+}
+
+const sigilTexture = new THREE.CanvasTexture(drawSigilCanvas());
+
+export const sigilMat = new THREE.MeshBasicMaterial({
+  map: sigilTexture,
+  transparent: true,
+  opacity: 0.80,
+  depthWrite: false,
+  blending: THREE.AdditiveBlending,
+  side: THREE.DoubleSide,
+});
+
+export const sigilMesh = new THREE.Mesh(
+  new THREE.CircleGeometry(SIGIL_RADIUS, 128),
+  sigilMat
+);
+sigilMesh.rotation.x = -Math.PI / 2;
+sigilMesh.position.y = 0.010;
+sigilMesh.userData.zoomLabel = 'Timmy Sigil';
+scene.add(sigilMesh);
+
+export const sigilRing1Mat = new THREE.MeshBasicMaterial({
+  color: 0x00ccff, transparent: true, opacity: 0.45, depthWrite: false, blending: THREE.AdditiveBlending,
+});
+export const sigilRing1 = new THREE.Mesh(
+  new THREE.TorusGeometry(SIGIL_RADIUS * 0.965, 0.025, 6, 96), sigilRing1Mat
+);
+sigilRing1.rotation.x = Math.PI / 2;
+sigilRing1.position.y = 0.012;
+scene.add(sigilRing1);
+
+export const sigilRing2Mat = new THREE.MeshBasicMaterial({
+  color: 0xffd700, transparent: true, opacity: 0.40, depthWrite: false, blending: THREE.AdditiveBlending,
+});
+export const sigilRing2 = new THREE.Mesh(
+  new THREE.TorusGeometry(SIGIL_RADIUS * 0.62, 0.020, 6, 72), sigilRing2Mat
+);
+sigilRing2.rotation.x = Math.PI / 2;
+sigilRing2.position.y = 0.013;
+scene.add(sigilRing2);
+
+export const sigilRing3Mat = new THREE.MeshBasicMaterial({
+  color: 0x00ffcc, transparent: true, opacity: 0.35, depthWrite: false, blending: THREE.AdditiveBlending,
+});
+export const sigilRing3 = new THREE.Mesh(
+  new THREE.TorusGeometry(SIGIL_RADIUS * 0.78, 0.018, 6, 80), sigilRing3Mat
+);
+sigilRing3.rotation.x = Math.PI / 2;
+sigilRing3.position.y = 0.011;
+scene.add(sigilRing3);
+
+export const sigilLight = new THREE.PointLight(0x0088ff, 0.4, 8);
+sigilLight.position.set(0, 0.5, 0);
+scene.add(sigilLight);

modules/state.js

@@ -0,0 +1,83 @@
+// Shared mutable state — imported by all modules that need cross-module scalar access
+import * as THREE from 'three';
+
+export const S = {
+  // Mouse & camera
+  mouseX: 0,
+  mouseY: 0,
+  targetRotX: 0,
+  targetRotY: 0,
+
+  // Overview
+  overviewMode: false,
+  overviewT: 0,
+
+  // Zoom
+  zoomT: 0,
+  zoomTargetT: 0,
+  zoomActive: false,
+  _zoomCamTarget: new THREE.Vector3(),
+  _zoomLookTarget: new THREE.Vector3(),
+
+  // Photo
+  photoMode: false,
+
+  // Warp
+  isWarping: false,
+  warpStartTime: 0,
+  warpNavigated: false,
+  warpDestinationUrl: null,
+  warpPortalColor: new THREE.Color(0x4488ff),
+
+  // Stars
+  _starPulseIntensity: 0,
+
+  // Energy beam
+  energyBeamPulse: 0,
+  _activeAgentCount: 0,
+
+  // Batcave
+  batcaveProbeLastUpdate: -999,
+
+  // Lightning
+  lastLightningRefreshTime: 0,
+
+  // Oath
+  oathActive: false,
+  oathLines: [],
+  oathRevealTimer: null,
+
+  // Speech
+  timmySpeechSprite: null,
+  timmySpeechState: null,
+
+  // Timelapse
+  timelapseActive: false,
+  timelapseRealStart: 0,
+  timelapseProgress: 0,
+  timelapseNextCommitIdx: 0,
+
+  // Bitcoin
+  lastKnownBlockHeight: null,
+
+  // Audio
+  audioCtx: null,
+  masterGain: null,
+  audioRunning: false,
+  portalHumsStarted: false,
+  sparkleTimer: null,
+
+  // Debug
+  debugMode: false,
+
+  // Matrix
+  _matrixCommitHashes: [],
+
+  // Sovereignty easter egg
+  sovereigntyBuffer: '',
+  sovereigntyBufferTimer: null,
+
+  // Sovereignty score
+  sovereigntyScore: 85,
+  sovereigntyLabel: 'Mostly Sovereign',
+};

modules/warp.js

@@ -0,0 +1,326 @@
+// === WARP TUNNEL + CRYSTALS + LIGHTNING + BATCAVE + DUAL-BRAIN ===
+import * as THREE from 'three';
+import { ShaderPass } from 'three/addons/postprocessing/ShaderPass.js';
+import { NEXUS } from './constants.js';
+import { scene, camera, renderer } from './scene-setup.js';
+import { composer } from './controls.js';
+import { zoneIntensity } from './heatmap.js';
+import { S } from './state.js';
+
+// === WARP TUNNEL EFFECT ===
+const WarpShader = {
+  uniforms: {
+    'tDiffuse':    { value: null },
+    'time':        { value: 0.0 },
+    'progress':    { value: 0.0 },
+    'portalColor': { value: new THREE.Color(0x4488ff) },
+  },
+  vertexShader: `
+    varying vec2 vUv;
+    void main() {
+      vUv = uv;
+      gl_Position = projectionMatrix * modelViewMatrix * vec4(position, 1.0);
+    }
+  `,
+  fragmentShader: `
+    uniform sampler2D tDiffuse;
+    uniform float time;
+    uniform float progress;
+    uniform vec3 portalColor;
+    varying vec2 vUv;
+
+    #define PI 3.14159265358979
+
+    void main() {
+      vec2 uv = vUv;
+      vec2 center = vec2(0.5, 0.5);
+      vec2 dir = uv - center;
+      float dist = length(dir);
+      float angle = atan(dir.y, dir.x);
+
+      float intensity = sin(progress * PI);
+
+      float zoom = 1.0 + intensity * 3.0;
+      vec2 zoomedUV = center + dir / zoom;
+
+      float swirl = intensity * 5.0 * max(0.0, 1.0 - dist * 2.0);
+      float twisted = angle + swirl;
+      vec2 swirlUV = center + vec2(cos(twisted), sin(twisted)) * dist / (1.0 + intensity * 1.8);
+
+      vec2 warpUV = mix(zoomedUV, swirlUV, 0.6);
+      warpUV = clamp(warpUV, vec2(0.001), vec2(0.999));
+
+      float aber = intensity * 0.018;
+      vec2 aberDir = normalize(dir + vec2(0.001));
+      float rVal = texture2D(tDiffuse, clamp(warpUV + aberDir * aber, vec2(0.0), vec2(1.0))).r;
+      float gVal = texture2D(tDiffuse, warpUV).g;
+      float bVal = texture2D(tDiffuse, clamp(warpUV - aberDir * aber, vec2(0.0), vec2(1.0))).b;
+      vec4 color = vec4(rVal, gVal, bVal, 1.0);
+
+      float numLines = 28.0;
+      float lineAngleFrac = fract((angle / (2.0 * PI) + 0.5) * numLines + time * 4.0);
+      float lineSharp = pow(max(0.0, 1.0 - abs(lineAngleFrac - 0.5) * 16.0), 3.0);
+      float radialFade = max(0.0, 1.0 - dist * 2.2);
+      float speedLine = lineSharp * radialFade * intensity * 1.8;
+
+      float lineAngleFrac2 = fract((angle / (2.0 * PI) + 0.5) * 14.0 - time * 2.5);
+      float lineSharp2 = pow(max(0.0, 1.0 - abs(lineAngleFrac2 - 0.5) * 12.0), 3.0);
+      float speedLine2 = lineSharp2 * radialFade * intensity * 0.9;
+
+      float rimDist = abs(dist - 0.08 * intensity);
+      float rimGlow = pow(max(0.0, 1.0 - rimDist * 40.0), 2.0) * intensity;
+
+      color.rgb = mix(color.rgb, portalColor, intensity * 0.45);
+
+      color.rgb += portalColor * (speedLine + speedLine2);
+      color.rgb += vec3(1.0) * rimGlow * 0.8;
+
+      float bloom = pow(max(0.0, 1.0 - dist / (0.18 * intensity + 0.001)), 2.0) * intensity;
+      color.rgb += portalColor * bloom * 2.5 + vec3(1.0) * bloom * 0.6;
+
+      float vignette = smoothstep(0.5, 0.2, dist) * intensity * 0.5;
+      color.rgb *= 1.0 - vignette * 0.4;
+
+      float flash = smoothstep(0.82, 1.0, progress);
+      color.rgb = mix(color.rgb, vec3(1.0), flash);
+
+      gl_FragColor = color;
+    }
+  `,
+};
+
+export const warpPass = new ShaderPass(WarpShader);
+warpPass.enabled = false;
+composer.addPass(warpPass);
+
+export function startWarp(portalMesh) {
+  S.isWarping = true;
+  S.warpNavigated = false;
+  S.warpStartTime = clock.getElapsedTime();
+  warpPass.enabled = true;
+  warpPass.uniforms['time'].value = 0.0;
+  warpPass.uniforms['progress'].value = 0.0;
+
+  if (portalMesh) {
+    S.warpDestinationUrl = portalMesh.userData.destinationUrl || null;
+    S.warpPortalColor = portalMesh.userData.portalColor
+      ? portalMesh.userData.portalColor.clone()
+      : new THREE.Color(0x4488ff);
+  } else {
+    S.warpDestinationUrl = null;
+    S.warpPortalColor = new THREE.Color(0x4488ff);
+  }
+  warpPass.uniforms['portalColor'].value = S.warpPortalColor;
+}
+
+// clock is created here and exported
+export const clock = new THREE.Clock();
+
+// === FLOATING CRYSTALS & LIGHTNING ARCS ===
+const CRYSTAL_COUNT = 5;
+const CRYSTAL_BASE_POSITIONS = [
+  new THREE.Vector3(-4.5, 3.2, -3.8),
+  new THREE.Vector3( 4.8, 2.8, -4.0),
+  new THREE.Vector3(-5.5, 4.0,  1.5),
+  new THREE.Vector3( 5.2, 3.5,  2.0),
+  new THREE.Vector3( 0.0, 5.0, -5.5),
+];
+export const CRYSTAL_COLORS = [0xff6440, 0x40a0ff, 0x40ff8c, 0xc840ff, 0xffd700];
+
+const crystalGroupObj = new THREE.Group();
+scene.add(crystalGroupObj);
+
+export const crystals = [];
+
+for (let i = 0; i < CRYSTAL_COUNT; i++) {
+  const geo = new THREE.OctahedronGeometry(0.35, 0);
+  const color = CRYSTAL_COLORS[i];
+  const mat = new THREE.MeshStandardMaterial({
+    color,
+    emissive: new THREE.Color(color).multiplyScalar(0.6),
+    roughness: 0.05,
+    metalness: 0.3,
+    transparent: true,
+    opacity: 0.88,
+  });
+  const mesh = new THREE.Mesh(geo, mat);
+  const basePos = CRYSTAL_BASE_POSITIONS[i].clone();
+  mesh.position.copy(basePos);
+  mesh.userData.zoomLabel = 'Crystal';
+  crystalGroupObj.add(mesh);
+
+  const light = new THREE.PointLight(color, 0.3, 6);
+  light.position.copy(basePos);
+  crystalGroupObj.add(light);
+
+  crystals.push({ mesh, light, basePos, floatPhase: (i / CRYSTAL_COUNT) * Math.PI * 2, flashStartTime: -999 });
+}
+
+// Lightning arc pool
+export const LIGHTNING_POOL_SIZE = 6;
+const LIGHTNING_SEGMENTS = 8;
+export const LIGHTNING_REFRESH_MS = 130;
+
+export const lightningArcs = [];
+export const lightningArcMeta = [];
+
+for (let i = 0; i < LIGHTNING_POOL_SIZE; i++) {
+  const positions = new Float32Array((LIGHTNING_SEGMENTS + 1) * 3);
+  const geo = new THREE.BufferGeometry();
+  geo.setAttribute('position', new THREE.BufferAttribute(positions, 3));
+  const mat = new THREE.LineBasicMaterial({
+    color: 0x88ccff, transparent: true, opacity: 0.0,
+    blending: THREE.AdditiveBlending, depthWrite: false,
+  });
+  const arc = new THREE.Line(geo, mat);
+  scene.add(arc);
+  lightningArcs.push(arc);
+  lightningArcMeta.push({ active: false, baseOpacity: 0, srcIdx: 0, dstIdx: 0 });
+}
+
+function buildLightningPath(start, end, jagAmount) {
+  const out = new Float32Array((LIGHTNING_SEGMENTS + 1) * 3);
+  for (let s = 0; s <= LIGHTNING_SEGMENTS; s++) {
+    const t = s / LIGHTNING_SEGMENTS;
+    const x = start.x + (end.x - start.x) * t + (s > 0 && s < LIGHTNING_SEGMENTS ? (Math.random() - 0.5) * jagAmount : 0);
+    const y = start.y + (end.y - start.y) * t + (s > 0 && s < LIGHTNING_SEGMENTS ? (Math.random() - 0.5) * jagAmount : 0);
+    const z = start.z + (end.z - start.z) * t + (s > 0 && s < LIGHTNING_SEGMENTS ? (Math.random() - 0.5) * jagAmount : 0);
+    out[s * 3] = x; out[s * 3 + 1] = y; out[s * 3 + 2] = z;
+  }
+  return out;
+}
+
+export function totalActivity() {
+  const vals = Object.values(zoneIntensity);
+  return vals.reduce((s, v) => s + v, 0) / Math.max(vals.length, 1);
+}
+
+export function lerpColor(colorA, colorB, t) {
+  const ar = (colorA >> 16) & 0xff, ag = (colorA >> 8) & 0xff, ab = colorA & 0xff;
+  const br = (colorB >> 16) & 0xff, bg = (colorB >> 8) & 0xff, bb = colorB & 0xff;
+  const r = Math.round(ar + (br - ar) * t);
+  const g = Math.round(ag + (bg - ag) * t);
+  const b = Math.round(ab + (bb - ab) * t);
+  return (r << 16) | (g << 8) | b;
+}
+
+export function updateLightningArcs(elapsed) {
+  const activity = totalActivity();
+  const activeCount = Math.round(activity * LIGHTNING_POOL_SIZE);
+
+  for (let i = 0; i < LIGHTNING_POOL_SIZE; i++) {
+    const arc = lightningArcs[i];
+    const meta = lightningArcMeta[i];
+    if (i >= activeCount) {
+      arc.material.opacity = 0;
+      meta.active = false;
+      continue;
+    }
+
+    const a = Math.floor(Math.random() * CRYSTAL_COUNT);
+    let b = Math.floor(Math.random() * (CRYSTAL_COUNT - 1));
+    if (b >= a) b++;
+
+    const jagAmount = 0.45 + activity * 0.85;
+    const path = buildLightningPath(crystals[a].mesh.position, crystals[b].mesh.position, jagAmount);
+    const attr = arc.geometry.attributes.position;
+    attr.array.set(path);
+    attr.needsUpdate = true;
+
+    arc.material.color.setHex(lerpColor(CRYSTAL_COLORS[a], CRYSTAL_COLORS[b], 0.5));
+
+    const base = (0.35 + Math.random() * 0.55) * Math.min(activity * 1.5, 1.0);
+    arc.material.opacity = base;
+    meta.active = true;
+    meta.baseOpacity = base;
+    meta.srcIdx = a;
+    meta.dstIdx = b;
+
+    crystals[a].flashStartTime = elapsed;
+    crystals[b].flashStartTime = elapsed;
+  }
+}
+
+// === BATCAVE AREA ===
+const BATCAVE_ORIGIN = new THREE.Vector3(-10, 0, -8);
+
+export const batcaveGroup = new THREE.Group();
+batcaveGroup.position.copy(BATCAVE_ORIGIN);
+scene.add(batcaveGroup);
+
+const batcaveProbeTarget = new THREE.WebGLCubeRenderTarget(128, {
+  type: THREE.HalfFloatType,
+  generateMipmaps: true,
+  minFilter: THREE.LinearMipmapLinearFilter,
+});
+export const batcaveProbe = new THREE.CubeCamera(0.1, 80, batcaveProbeTarget);
+batcaveProbe.position.set(0, 1.2, -1);
+batcaveGroup.add(batcaveProbe);
+
+const batcaveFloorMat = new THREE.MeshStandardMaterial({
+  color: 0x0d1520, metalness: 0.92, roughness: 0.08, envMapIntensity: 1.4,
+});
+
+const batcaveWallMat = new THREE.MeshStandardMaterial({
+  color: 0x0a1828, metalness: 0.85, roughness: 0.15,
+  emissive: new THREE.Color(NEXUS.colors.accent).multiplyScalar(0.03),
+  envMapIntensity: 1.2,
+});
+
+const batcaveConsoleMat = new THREE.MeshStandardMaterial({
+  color: 0x060e16, metalness: 0.95, roughness: 0.05, envMapIntensity: 1.6,
+});
+
+export const batcaveMetallicMats = [batcaveFloorMat, batcaveWallMat, batcaveConsoleMat];
+export const batcaveProbeTarget_texture = batcaveProbeTarget;
+
+const batcaveFloor = new THREE.Mesh(new THREE.BoxGeometry(6, 0.08, 6), batcaveFloorMat);
+batcaveFloor.position.y = -0.04;
+batcaveGroup.add(batcaveFloor);
+
+const batcaveBackWall = new THREE.Mesh(new THREE.BoxGeometry(6, 3, 0.1), batcaveWallMat);
+batcaveBackWall.position.set(0, 1.5, -3);
+batcaveGroup.add(batcaveBackWall);
+
+const batcaveLeftWall = new THREE.Mesh(new THREE.BoxGeometry(0.1, 3, 6), batcaveWallMat);
+batcaveLeftWall.position.set(-3, 1.5, 0);
+batcaveGroup.add(batcaveLeftWall);
+
+const batcaveConsoleBase = new THREE.Mesh(new THREE.BoxGeometry(3, 0.7, 1.2), batcaveConsoleMat);
+batcaveConsoleBase.position.set(0, 0.35, -1.5);
+batcaveGroup.add(batcaveConsoleBase);
+
+const batcaveScreenBezel = new THREE.Mesh(new THREE.BoxGeometry(2.6, 1.4, 0.06), batcaveConsoleMat);
+batcaveScreenBezel.position.set(0, 1.4, -2.08);
+batcaveScreenBezel.rotation.x = Math.PI * 0.08;
+batcaveGroup.add(batcaveScreenBezel);
+
+const batcaveScreenGlow = new THREE.Mesh(
+  new THREE.PlaneGeometry(2.2, 1.1),
+  new THREE.MeshBasicMaterial({
+    color: new THREE.Color(NEXUS.colors.accent).multiplyScalar(0.65),
+    transparent: true, opacity: 0.82,
+  })
+);
+batcaveScreenGlow.position.set(0, 1.4, -2.05);
+batcaveScreenGlow.rotation.x = Math.PI * 0.08;
+batcaveGroup.add(batcaveScreenGlow);
+
+const batcaveLight = new THREE.PointLight(NEXUS.colors.accent, 0.9, 14);
+batcaveLight.position.set(0, 2.8, -1);
+batcaveGroup.add(batcaveLight);
+
+const batcaveCeilingStrip = new THREE.Mesh(
+  new THREE.BoxGeometry(4.2, 0.05, 0.14),
+  new THREE.MeshStandardMaterial({
+    color: NEXUS.colors.accent,
+    emissive: new THREE.Color(NEXUS.colors.accent),
+    emissiveIntensity: 1.1,
+  })
+);
+batcaveCeilingStrip.position.set(0, 2.95, -1.2);
+batcaveGroup.add(batcaveCeilingStrip);
+
+batcaveGroup.traverse(obj => {
+  if (obj.isMesh) obj.userData.zoomLabel = 'Batcave';
+});

modules/weather.js

@@ -0,0 +1,181 @@
+// === WEATHER SYSTEM + PORTAL HEALTH ===
+import * as THREE from 'three';
+import { scene, ambientLight } from './scene-setup.js';
+import { cloudMaterial } from './platform.js';
+import { rebuildRuneRing } from './effects.js';
+import { S } from './state.js';
+import { refreshPortalInstanceColors } from './portals.js';
+
+// === PORTAL HEALTH CHECKS ===
+const PORTAL_HEALTH_CHECK_MS = 5 * 60 * 1000;
+
+// Forward refs
+let _portalsRef = [];
+let _portalGroupRef = null;
+let _rebuildGravityZonesFn = null;
+
+export function setWeatherPortalRefs(portals, portalGroup, rebuildGravityZones) {
+  _portalsRef = portals;
+  _portalGroupRef = portalGroup;
+  _rebuildGravityZonesFn = rebuildGravityZones;
+}
+
+export async function runPortalHealthChecks() {
+  if (_portalsRef.length === 0) return;
+
+  for (const portal of _portalsRef) {
+    if (!portal.destination?.url) {
+      portal.status = 'offline';
+      continue;
+    }
+    try {
+      await fetch(portal.destination.url, {
+        mode: 'no-cors',
+        signal: AbortSignal.timeout(5000),
+      });
+      portal.status = 'online';
+    } catch {
+      portal.status = 'offline';
+    }
+  }
+
+  rebuildRuneRing();
+  if (_rebuildGravityZonesFn) _rebuildGravityZonesFn();
+
+  // Refresh portal InstancedMesh colors to reflect new online/offline statuses.
+  refreshPortalInstanceColors();
+}
+
+export function initPortalHealthChecks() {
+  setInterval(runPortalHealthChecks, PORTAL_HEALTH_CHECK_MS);
+}
+
+// === WEATHER SYSTEM ===
+const WEATHER_LAT = 43.2897;
+const WEATHER_LON = -72.1479;
+const WEATHER_REFRESH_MS = 15 * 60 * 1000;
+
+let weatherState = null;
+
+export const PRECIP_COUNT = 1200;
+export const PRECIP_AREA = 18;
+export const PRECIP_HEIGHT = 20;
+export const PRECIP_FLOOR = -5;
+
+// Rain geometry
+export const rainGeo = new THREE.BufferGeometry();
+const rainPositions = new Float32Array(PRECIP_COUNT * 3);
+export const rainVelocities = new Float32Array(PRECIP_COUNT);
+
+for (let i = 0; i < PRECIP_COUNT; i++) {
+  rainPositions[i * 3]     = (Math.random() - 0.5) * PRECIP_AREA * 2;
+  rainPositions[i * 3 + 1] = Math.random() * (PRECIP_HEIGHT - PRECIP_FLOOR) + PRECIP_FLOOR;
+  rainPositions[i * 3 + 2] = (Math.random() - 0.5) * PRECIP_AREA * 2;
+  rainVelocities[i] = 0.18 + Math.random() * 0.12;
+}
+rainGeo.setAttribute('position', new THREE.BufferAttribute(rainPositions, 3));
+
+const rainMat = new THREE.PointsMaterial({
+  color: 0x88aaff, size: 0.05, sizeAttenuation: true,
+  transparent: true, opacity: 0.55,
+});
+
+export const rainParticles = new THREE.Points(rainGeo, rainMat);
+rainParticles.visible = false;
+scene.add(rainParticles);
+
+// Snow geometry
+export const snowGeo = new THREE.BufferGeometry();
+const snowPositions = new Float32Array(PRECIP_COUNT * 3);
+export const snowDrift = new Float32Array(PRECIP_COUNT);
+
+for (let i = 0; i < PRECIP_COUNT; i++) {
+  snowPositions[i * 3]     = (Math.random() - 0.5) * PRECIP_AREA * 2;
+  snowPositions[i * 3 + 1] = Math.random() * (PRECIP_HEIGHT - PRECIP_FLOOR) + PRECIP_FLOOR;
+  snowPositions[i * 3 + 2] = (Math.random() - 0.5) * PRECIP_AREA * 2;
+  snowDrift[i] = Math.random() * Math.PI * 2;
+}
+snowGeo.setAttribute('position', new THREE.BufferAttribute(snowPositions, 3));
+
+const snowMat = new THREE.PointsMaterial({
+  color: 0xddeeff, size: 0.12, sizeAttenuation: true,
+  transparent: true, opacity: 0.75,
+});
+
+export const snowParticles = new THREE.Points(snowGeo, snowMat);
+snowParticles.visible = false;
+scene.add(snowParticles);
+
+function weatherCodeToLabel(code) {
+  if (code === 0)                   return { condition: 'Clear',         icon: '☀️' };
+  if (code <= 2)                    return { condition: 'Partly Cloudy', icon: '⛅' };
+  if (code === 3)                   return { condition: 'Overcast',      icon: '☁️' };
+  if (code >= 45 && code <= 48)     return { condition: 'Fog',           icon: '🌫️' };
+  if (code >= 51 && code <= 57)     return { condition: 'Drizzle',       icon: '🌦️' };
+  if (code >= 61 && code <= 67)     return { condition: 'Rain',          icon: '🌧️' };
+  if (code >= 71 && code <= 77)     return { condition: 'Snow',          icon: '❄️' };
+  if (code >= 80 && code <= 82)     return { condition: 'Showers',       icon: '🌦️' };
+  if (code >= 85 && code <= 86)     return { condition: 'Snow Showers',  icon: '🌨️' };
+  if (code >= 95 && code <= 99)     return { condition: 'Thunderstorm',  icon: '⛈️' };
+  return { condition: 'Unknown', icon: '🌀' };
+}
+
+function applyWeatherToScene(wx) {
+  const code = wx.code;
+
+  const isRain  = (code >= 51 && code <= 67) || (code >= 80 && code <= 82) || (code >= 95 && code <= 99);
+  const isSnow  = (code >= 71 && code <= 77) || (code >= 85 && code <= 86);
+
+  rainParticles.visible = isRain;
+  snowParticles.visible = isSnow;
+
+  if (isSnow) {
+    ambientLight.color.setHex(0x1a2a40);
+    ambientLight.intensity = 1.8;
+  } else if (isRain) {
+    ambientLight.color.setHex(0x0a1428);
+    ambientLight.intensity = 1.2;
+  } else if (code === 3 || (code >= 45 && code <= 48)) {
+    ambientLight.color.setHex(0x0c1220);
+    ambientLight.intensity = 1.1;
+  } else {
+    ambientLight.color.setHex(0x0a1428);
+    ambientLight.intensity = 1.4;
+  }
+}
+
+function updateWeatherHUD(wx) {
+  const iconEl = document.getElementById('weather-icon');
+  const tempEl = document.getElementById('weather-temp');
+  const descEl = document.getElementById('weather-desc');
+  if (iconEl) iconEl.textContent = wx.icon;
+  if (tempEl) tempEl.textContent = `${Math.round(wx.temp)}°F`;
+  if (descEl) descEl.textContent = wx.condition;
+}
+
+export async function fetchWeather() {
+  try {
+    const url = `https://api.open-meteo.com/v1/forecast?latitude=${WEATHER_LAT}&longitude=${WEATHER_LON}&current=temperature_2m,weather_code,wind_speed_10m,cloud_cover&temperature_unit=fahrenheit&wind_speed_unit=mph&forecast_days=1`;
+    const res = await fetch(url);
+    if (!res.ok) throw new Error('weather fetch failed');
+    const data = await res.json();
+    const cur = data.current;
+    const code = cur.weather_code;
+    const { condition, icon } = weatherCodeToLabel(code);
+    const cloudcover = typeof cur.cloud_cover === 'number' ? cur.cloud_cover : 50;
+    weatherState = { code, temp: cur.temperature_2m, wind: cur.wind_speed_10m, condition, icon, cloudcover };
+    applyWeatherToScene(weatherState);
+    const cloudOpacity = 0.05 + (cloudcover / 100) * 0.55;
+    cloudMaterial.uniforms.uDensity.value = 0.3 + (cloudcover / 100) * 0.7;
+    cloudMaterial.opacity = cloudOpacity;
+    updateWeatherHUD(weatherState);
+  } catch {
+    const descEl = document.getElementById('weather-desc');
+    if (descEl) descEl.textContent = 'Lempster NH';
+  }
+}
+
+export function initWeather() {
+  fetchWeather();
+  setInterval(fetchWeather, WEATHER_REFRESH_MS);
+}

package-lock.json

@@ -0,0 +1,12 @@
+{
+  "name": "the-nexus",
+  "version": "1.0.67",
+  "lockfileVersion": 3,
+  "requires": true,
+  "packages": {
+    "": {
+      "name": "the-nexus",
+      "version": "1.0.67"
+    }
+  }
+}

sw.js

@@ -1,8 +1,8 @@
 // The Nexus — Service Worker
 // Cache-first for assets, network-first for API calls
 
-const CACHE_NAME = 'nexus-v1';
-const ASSET_CACHE = 'nexus-assets-v1';
+const CACHE_NAME = 'nexus-v3';
+const ASSET_CACHE = 'nexus-assets-v3';
 
 const CORE_ASSETS = [
   '/',