fix: wire SpatialMemory.setCamera(camera) for entity line LOD (#1167)

Pass camera reference to SpatialMemory so entity resolution lines get distance-based opacity fade and LOD culling.

.gitea/workflows/auto-merge.yml

@@ -1,10 +0,0 @@
-# Placeholder — auto-merge is handled by nexus-merge-bot.sh
-# Gitea Actions requires a runner to be registered.
-# When a runner is available, this can replace the bot.
-name: stub
-on: workflow_dispatch
-jobs:
-  noop:
-    runs-on: ubuntu-latest
-    steps:
-      - run: echo "See nexus-merge-bot.sh"

.gitignore

@@ -7,3 +7,4 @@ mempalace/__pycache__/
 
 # Prevent agents from writing to wrong path (see issue #1145)
 public/nexus/
+test-screenshots/

BROWSER_CONTRACT.md

@@ -0,0 +1,83 @@
+# Browser Contract — The Nexus
+
+The minimal set of guarantees a working Nexus browser surface must satisfy.
+This is the target the smoke suite validates against.
+
+## 1. Static Assets
+
+The following files MUST exist at the repo root and be serveable:
+
+| File              | Purpose                          |
+|-------------------|----------------------------------|
+| `index.html`      | Entry point HTML shell           |
+| `app.js`          | Main Three.js application        |
+| `style.css`       | Visual styling                   |
+| `portals.json`    | Portal registry data             |
+| `vision.json`     | Vision points data               |
+| `manifest.json`   | PWA manifest                     |
+| `gofai_worker.js` | GOFAI web worker                 |
+| `server.py`       | WebSocket bridge                 |
+
+## 2. DOM Contract
+
+The following elements MUST exist after the page loads:
+
+| ID                    | Type     | Purpose                            |
+|-----------------------|----------|------------------------------------|
+| `nexus-canvas`        | canvas   | Three.js render target             |
+| `loading-screen`      | div      | Initial loading overlay            |
+| `hud`                 | div      | Main HUD container                 |
+| `chat-panel`          | div      | Chat interface panel               |
+| `chat-input`          | input    | Chat text input                    |
+| `chat-messages`       | div      | Chat message history               |
+| `chat-send`           | button   | Send message button                |
+| `chat-toggle`         | button   | Collapse/expand chat               |
+| `debug-overlay`       | div      | Debug info overlay                 |
+| `nav-mode-label`      | span     | Current navigation mode display    |
+| `ws-status-dot`       | span     | Hermes WS connection indicator     |
+| `hud-location-text`   | span     | Current location label             |
+| `portal-hint`         | div      | Portal proximity hint              |
+| `spatial-search`      | div      | Spatial memory search overlay      |
+| `enter-prompt`        | div      | Click-to-enter overlay (transient) |
+
+## 3. Three.js Contract
+
+After initialization completes:
+
+- `window` has a THREE renderer created from `#nexus-canvas`
+- The canvas has a WebGL rendering context
+- `scene` is a `THREE.Scene` with fog
+- `camera` is a `THREE.PerspectiveCamera`
+- `portals` array is populated from `portals.json`
+- At least one portal mesh exists in the scene
+- The render loop is running (`requestAnimationFrame` active)
+
+## 4. Loading Contract
+
+1. Page loads → loading screen visible
+2. Progress bar fills to 100%
+3. Loading screen fades out
+4. Enter prompt appears
+5. User clicks → enter prompt fades → HUD appears
+
+## 5. Provenance Contract
+
+A validation run MUST prove:
+
+- The served files match a known hash manifest from `Timmy_Foundation/the-nexus` main
+- No file is served from `/Users/apayne/the-matrix` or other stale source
+- The hash manifest is generated from a clean git checkout
+- Screenshot evidence is captured and timestamped
+
+## 6. Data Contract
+
+- `portals.json` MUST parse as valid JSON array
+- Each portal MUST have: `id`, `name`, `status`, `destination`
+- `vision.json` MUST parse as valid JSON
+- `manifest.json` MUST have `name`, `start_url`, `theme_color`
+
+## 7. WebSocket Contract
+
+- `server.py` starts without error on port 8765
+- A browser client can connect to `ws://localhost:8765`
+- The connection status indicator reflects connected state

app.js

@@ -1,12 +1,10 @@
-shell-init: error retrieving current directory: getcwd: cannot access parent directories: No such file or directory
-chdir: error retrieving current directory: getcwd: cannot access parent directories: No such file or directory
 import * as THREE from 'three';
 import { EffectComposer } from 'three/addons/postprocessing/EffectComposer.js';
 import { RenderPass } from 'three/addons/postprocessing/RenderPass.js';
 import { UnrealBloomPass } from 'three/addons/postprocessing/UnrealBloomPass.js';
 import { SMAAPass } from 'three/addons/postprocessing/SMAAPass.js';
 import { SpatialMemory } from './nexus/components/spatial-memory.js';
-import { SessionRooms } from './nexus/components/session-rooms.js';
+import { MemoryOptimizer } from './nexus/components/memory-optimizer.js';
 
 // ═══════════════════════════════════════════
 // NEXUS v1.1 — Portal System Update
@@ -47,6 +45,7 @@ let particles, dustParticles;
 let debugOverlay;
 let frameCount = 0, lastFPSTime = 0, fps = 0;
 let chatOpen = true;
+let memoryFeedEntries = [];  // Mnemosyne: recent memory events for feed panel
 let loadProgress = 0;
 let performanceTier = 'high';
 
@@ -708,11 +707,17 @@ async function init() {
   createWorkshopTerminal();
   createAshStorm();
   SpatialMemory.init(scene);
-  SessionRooms.init(scene, camera, null);
+  SpatialMemory.setCamera(camera);
   updateLoad(90);
 
   loadSession();
   connectHermes();
+  // Mnemosyne: Periodic GOFAI Optimization
+  setInterval(() => {
+    console.info('[Mnemosyne] Running periodic optimization...');
+    MemoryOptimizer.optimize(SpatialMemory);
+  }, 1000 * 60 * 10); // Every 10 minutes
+
   fetchGiteaData();
   setInterval(fetchGiteaData, 30000); // Refresh every 30s
 
@@ -1865,6 +1870,7 @@ function setupControls() {
       if (portalOverlayActive) closePortalOverlay();
       if (visionOverlayActive) closeVisionOverlay();
       if (atlasOverlayActive) closePortalAtlas();
+      if (_archiveDashboardOpen) toggleArchiveHealthDashboard();
     }
     if (e.key.toLowerCase() === 'v' && document.activeElement !== document.getElementById('chat-input')) {
       cycleNavMode();
@@ -1875,6 +1881,9 @@ function setupControls() {
     if (e.key.toLowerCase() === 'e' && activeVisionPoint && !visionOverlayActive) {
       activateVisionPoint(activeVisionPoint);
     }
+    if (e.key.toLowerCase() === 'h' && document.activeElement !== document.getElementById('chat-input')) {
+      toggleArchiveHealthDashboard();
+    }
   });
   document.addEventListener('keyup', (e) => {
     keys[e.key.toLowerCase()] = false;
@@ -1887,7 +1896,7 @@ function setupControls() {
       orbitState.lastX = e.clientX;
       orbitState.lastY = e.clientY;
       
-      // Raycasting for portals and memory crystals
+      // Raycasting for portals
       if (!portalOverlayActive) {
         const mouse = new THREE.Vector2(
           (e.clientX / window.innerWidth) * 2 - 1,
@@ -1895,43 +1904,12 @@ function setupControls() {
         );
         const raycaster = new THREE.Raycaster();
         raycaster.setFromCamera(mouse, camera);
-
-        // Priority 1: Portals
-        const portalHits = raycaster.intersectObjects(portals.map(p => p.ring));
-        if (portalHits.length > 0) {
-          const clickedRing = portalHits[0].object;
+        const intersects = raycaster.intersectObjects(portals.map(p => p.ring));
+        if (intersects.length > 0) {
+          const clickedRing = intersects[0].object;
           const portal = portals.find(p => p.ring === clickedRing);
-          if (portal) { activatePortal(portal); return; }
+          if (portal) activatePortal(portal);
         }
-
-        // Priority 2: Memory crystals (Mnemosyne)
-        const crystalMeshes = SpatialMemory.getCrystalMeshes();
-        if (crystalMeshes.length > 0) {
-          const crystalHits = raycaster.intersectObjects(crystalMeshes, false);
-          if (crystalHits.length > 0) {
-            const hitMesh = crystalHits[0].object;
-            const memInfo = SpatialMemory.getMemoryFromMesh(hitMesh);
-            if (memInfo) {
-              SpatialMemory.highlightMemory(memInfo.data.id);
-              showMemoryPanel(memInfo, e.clientX, e.clientY);
-              return;
-            }
-          }
-        }
-
-        // Priority 3: Session rooms (Mnemosyne #1171)
-        const roomMeshes = SessionRooms.getClickableMeshes();
-        if (roomMeshes.length > 0) {
-          const roomHits = raycaster.intersectObjects(roomMeshes, false);
-          if (roomHits.length > 0) {
-            const session = SessionRooms.handleRoomClick(roomHits[0].object);
-            if (session) { _showSessionRoomPanel(session); return; }
-          }
-        }
-
-        // Clicked empty space — dismiss panel
-        dismissMemoryPanel();
-        _dismissSessionRoomPanel();
       }
     }
   });
@@ -1984,97 +1962,30 @@ function setupControls() {
   document.getElementById('chat-quick-actions').addEventListener('click', (e) => {
     const btn = e.target.closest('.quick-action-btn');
     if (!btn) return;
-    handleQuickAction(btn.dataset.action);
+    
+    const action = btn.dataset.action;
+    
+    switch(action) {
+      case 'status':
+        sendChatMessage("Timmy, what is the current system status?");
+        break;
+      case 'agents':
+        sendChatMessage("Timmy, check on all active agents.");
+        break;
+      case 'portals':
+        openPortalAtlas();
+        break;
+      case 'help':
+        sendChatMessage("Timmy, I need assistance with Nexus navigation.");
+        break;
+    }
   });
-
-// ═══ QUICK ACTION HANDLER ═══
-function handleQuickAction(action) {
-  switch(action) {
-    case 'status': {
-      const portalCount = portals.length;
-      const onlinePortals = portals.filter(p => p.userData && p.userData.status === 'online').length;
-      const agentCount = agents.length;
-      const wsState = wsConnected ? 'ONLINE' : 'OFFLINE';
-      const wsColor = wsConnected ? '#4af0c0' : '#ff4466';
-      addChatMessage('system', `[SYSTEM STATUS]`);
-      addChatMessage('timmy', `Nexus operational. ${portalCount} portals registered (${onlinePortals} online). ${agentCount} agent presences active. Hermes WebSocket: ${wsState}. Navigation mode: ${NAV_MODES[navModeIdx].toUpperCase()}. Performance tier: ${performanceTier.toUpperCase()}.`);
-      break;
-    }
-    case 'agents': {
-      addChatMessage('system', `[AGENT ROSTER]`);
-      if (agents.length === 0) {
-        addChatMessage('timmy', 'No active agent presences detected in the Nexus. The thought stream and harness pulse are the primary indicators of system activity.');
-      } else {
-        const roster = agents.map(a => `- ${(a.userData && a.userData.name) || a.name || 'Unknown'}: ${(a.userData && a.userData.status) || 'active'}`).join('\n');
-        addChatMessage('timmy', `Active agents:\n${roster}`);
-      }
-      break;
-    }
-    case 'portals':
-      openPortalAtlas();
-      break;
-    case 'heartbeat': {
-      const agentLog = document.getElementById('agent-log-content');
-      const recentEntries = agentLog ? agentLog.querySelectorAll('.agent-log-entry') : [];
-      const entryCount = recentEntries.length;
-      addChatMessage('system', `[HEARTBEAT INSPECTION]`);
-      addChatMessage('timmy', `Hermes heartbeat ${wsConnected ? 'active' : 'inactive'}. ${entryCount} recent entries in thought stream. WebSocket reconnect timer: ${wsReconnectTimer ? 'active' : 'idle'}. Harness pulse mesh: ${harnessPulseMesh ? 'rendering' : 'standby'}.`);
-      break;
-    }
-    case 'thoughts': {
-      const agentLog = document.getElementById('agent-log-content');
-      const entries = agentLog ? Array.from(agentLog.querySelectorAll('.agent-log-entry')).slice(0, 5) : [];
-      addChatMessage('system', `[THOUGHT STREAM]`);
-      if (entries.length === 0) {
-        addChatMessage('timmy', 'The thought stream is quiet. No recent agent entries detected.');
-      } else {
-        const summary = entries.map(e => '> ' + e.textContent.trim()).join('\n');
-        addChatMessage('timmy', `Recent thoughts:\n${summary}`);
-      }
-      break;
-    }
-    case 'help': {
-      addChatMessage('system', `[NEXUS HELP]`);
-      addChatMessage('timmy', `Navigation: WASD to move, mouse to look around.\n` +
-        `Press V to cycle: Walk / Orbit / Fly mode.\n` +
-        `Enter to chat. Escape to close overlays.\n` +
-        `Press F near a portal to enter. Press E near a vision point to read.\n` +
-        `Press Tab for Portal Atlas.\n` +
-        `The Batcave Terminal shows system logs. The Workshop Terminal shows tool output.`);
-      break;
-    }
-  }
-}
   
   document.getElementById('portal-close-btn').addEventListener('click', closePortalOverlay);
   document.getElementById('vision-close-btn').addEventListener('click', closeVisionOverlay);
   
   document.getElementById('atlas-toggle-btn').addEventListener('click', openPortalAtlas);
   document.getElementById('atlas-close-btn').addEventListener('click', closePortalAtlas);
-
-  // Mnemosyne export/import (#1174)
-  document.getElementById('mnemosyne-export-btn').addEventListener('click', () => {
-    const result = SpatialMemory.exportToFile();
-    if (result) {
-      addChatMessage('system', 'Mnemosyne: Exported ' + result.count + ' memories to ' + result.filename);
-    }
-  });
-
-  document.getElementById('mnemosyne-import-btn').addEventListener('click', () => {
-    document.getElementById('mnemosyne-import-file').click();
-  });
-
-  document.getElementById('mnemosyne-import-file').addEventListener('change', async (e) => {
-    const file = e.target.files[0];
-    if (!file) return;
-    try {
-      const result = await SpatialMemory.importFromFile(file);
-      addChatMessage('system', 'Mnemosyne: Imported ' + result.count + ' of ' + result.total + ' memories');
-    } catch (err) {
-      addChatMessage('system', 'Mnemosyne: Import failed — ' + err.message);
-    }
-    e.target.value = '';
-  });
 }
 
 function sendChatMessage(overrideText = null) {
@@ -2143,6 +2054,14 @@ function connectHermes() {
     addChatMessage('system', 'Hermes link established.');
     updateWsHudStatus(true);
     refreshWorkshopPanel();
+
+    // Mnemosyne: request memory sync from Hermes
+    try {
+      hermesWs.send(JSON.stringify({ type: 'memory', action: 'sync_request' }));
+      console.info('[Mnemosyne] Sent sync_request to Hermes');
+    } catch (e) {
+      console.warn('[Mnemosyne] Failed to send sync_request:', e);
+    }
   };
   
   // Initialize MemPalace
@@ -2193,6 +2112,8 @@ function handleHermesMessage(data) {
     recentToolOutputs.push({ type: 'result', agent: data.agent || 'SYSTEM', content });
     addToolMessage(data.agent || 'SYSTEM', 'result', content);
     refreshWorkshopPanel();
+  } else if (data.type === 'memory') {
+    handleMemoryMessage(data);
   } else if (data.type === 'history') {
     const container = document.getElementById('chat-messages');
     container.innerHTML = '';
@@ -2204,6 +2125,259 @@ function handleHermesMessage(data) {
   }
 }
 
+
+// ═══════════════════════════════════════════
+//  MNEMOSYNE — LIVE MEMORY BRIDGE
+// ═══════════════════════════════════════════
+
+/**
+ * Handle incoming memory messages from Hermes WS.
+ * Actions: place, remove, update, sync_response
+ */
+
+/**
+ * Clear all entries from the memory feed.
+ */
+function clearMemoryFeed() {
+  memoryFeedEntries = [];
+  renderMemoryFeed();
+  console.info('[Mnemosyne] Memory feed cleared');
+}
+
+function handleMemoryMessage(data) {
+  const action = data.action;
+  const memory = data.memory;
+  const memories = data.memories;
+
+  if (action === 'place' && memory) {
+    const placed = SpatialMemory.placeMemory(memory);
+    if (placed) {
+      addMemoryFeedEntry('place', memory);
+      console.info('[Mnemosyne] Memory placed via WS:', memory.id);
+    }
+  } else if (action === 'remove' && memory) {
+    SpatialMemory.removeMemory(memory.id);
+    addMemoryFeedEntry('remove', memory);
+    console.info('[Mnemosyne] Memory removed via WS:', memory.id);
+  } else if (action === 'update' && memory) {
+    SpatialMemory.updateMemory(memory.id, memory);
+    addMemoryFeedEntry('update', memory);
+    console.info('[Mnemosyne] Memory updated via WS:', memory.id);
+  } else if (action === 'sync_response' && Array.isArray(memories)) {
+    const count = SpatialMemory.importMemories(memories);
+    addMemoryFeedEntry('sync', { content: count + ' memories synced', id: 'sync' });
+    console.info('[Mnemosyne] Synced', count, 'memories from Hermes');
+  } else {
+    console.warn('[Mnemosyne] Unknown memory action:', action);
+  }
+  if (_archiveDashboardOpen) updateArchiveHealthDashboard();
+}
+
+/**
+ * Add an entry to the memory activity feed panel.
+ */
+function addMemoryFeedEntry(action, memory) {
+  const entry = {
+    action,
+    content: memory.content || memory.id || '(unknown)',
+    category: memory.category || 'working',
+    timestamp: new Date().toISOString()
+  };
+
+  memoryFeedEntries.unshift(entry);
+  if (memoryFeedEntries.length > 5) memoryFeedEntries.pop();
+
+  renderMemoryFeed();
+
+  // Auto-dismiss entries older than 5 minutes
+  setTimeout(() => {
+    const idx = memoryFeedEntries.indexOf(entry);
+    if (idx > -1) {
+      memoryFeedEntries.splice(idx, 1);
+      renderMemoryFeed();
+    }
+  }, 300000);
+}
+
+/**
+ * Render the memory feed panel.
+ */
+function renderMemoryFeed() {
+  const container = document.getElementById('memory-feed-list');
+  if (!container) return;
+
+  container.innerHTML = '';
+  memoryFeedEntries.forEach(entry => {
+    const el = document.createElement('div');
+    el.className = 'memory-feed-entry memory-feed-' + entry.action;
+
+    const regionDef = SpatialMemory.REGIONS[entry.category] || SpatialMemory.REGIONS.working;
+    const dotColor = '#' + regionDef.color.toString(16).padStart(6, '0');
+    const time = new Date(entry.timestamp).toLocaleTimeString();
+    const truncated = entry.content.length > 40 ? entry.content.slice(0, 40) + '\u2026' : entry.content;
+    const actionIcon = { place: '\u2795', remove: '\u2796', update: '\u270F', sync: '\u21C4' }[entry.action] || '\u2022';
+
+    el.innerHTML = '<span class="memory-feed-dot" style="background:' + dotColor + '"></span>' +
+      '<span class="memory-feed-action">' + actionIcon + '</span>' +
+      '<span class="memory-feed-content">' + truncated + '</span>' +
+      '<span class="memory-feed-time">' + time + '</span>';
+
+    container.appendChild(el);
+  });
+
+  // Show feed if there are entries
+  const panel = document.getElementById('memory-feed');
+  if (panel) panel.style.display = memoryFeedEntries.length > 0 ? 'block' : 'none';
+}
+
+
+// ── Archive Health Dashboard (issue #1210) ────────────────────────────
+
+let _archiveDashboardOpen = false;
+
+/**
+ * Toggle the archive health dashboard panel (hotkey H).
+ */
+function toggleArchiveHealthDashboard() {
+  _archiveDashboardOpen = !_archiveDashboardOpen;
+  const panel = document.getElementById('archive-health-dashboard');
+  if (!panel) return;
+  if (_archiveDashboardOpen) {
+    updateArchiveHealthDashboard();
+    panel.style.display = 'block';
+  } else {
+    panel.style.display = 'none';
+  }
+}
+
+/**
+ * Render current archive statistics into the dashboard panel.
+ * Reads live from SpatialMemory.getAllMemories() — no backend needed.
+ */
+function updateArchiveHealthDashboard() {
+  const container = document.getElementById('archive-health-content');
+  if (!container) return;
+
+  const memories = SpatialMemory.getAllMemories();
+  const regions = SpatialMemory.REGIONS;
+  const total = memories.length;
+
+  // ── Category breakdown ────────────────────────────────────────────
+  const catCounts = {};
+  memories.forEach(m => {
+    const cat = m.category || 'working';
+    catCounts[cat] = (catCounts[cat] || 0) + 1;
+  });
+
+  // ── Trust distribution (using strength field as trust score) ──────
+  let trustHigh = 0, trustMid = 0, trustLow = 0;
+  memories.forEach(m => {
+    const t = m.strength != null ? m.strength : 0.7;
+    if (t > 0.8) trustHigh++;
+    else if (t >= 0.5) trustMid++;
+    else trustLow++;
+  });
+
+  // ── Timestamps ────────────────────────────────────────────────────
+  let newestMs = null, oldestMs = null;
+  memories.forEach(m => {
+    const ts = m.timestamp ? new Date(m.timestamp).getTime() : null;
+    if (ts && !isNaN(ts)) {
+      if (newestMs === null || ts > newestMs) newestMs = ts;
+      if (oldestMs === null || ts < oldestMs) oldestMs = ts;
+    }
+  });
+  const fmtDate = ms => ms ? new Date(ms).toLocaleString(undefined, { month: 'short', day: 'numeric', hour: '2-digit', minute: '2-digit' }) : '—';
+
+  // ── Entity connection count ───────────────────────────────────────
+  let entityConnCount = 0;
+  memories.forEach(m => {
+    if (m.connections && Array.isArray(m.connections)) {
+      entityConnCount += m.connections.length;
+    }
+  });
+  // Each connection is stored on both ends, divide by 2 for unique links
+  const uniqueLinks = Math.floor(entityConnCount / 2);
+
+  // ── Build HTML ────────────────────────────────────────────────────
+  let html = '';
+
+  // Total count
+  html += `<div>
+    <div class="ah-section-label">Total Memories</div>
+    <div class="ah-total">
+      <span class="ah-total-count">${total}</span>
+      <span class="ah-total-label">crystals in archive</span>
+    </div>
+  </div>`;
+
+  // Category breakdown
+  const sortedCats = Object.entries(catCounts).sort((a, b) => b[1] - a[1]);
+  if (sortedCats.length > 0) {
+    html += `<div><div class="ah-section-label">Categories</div>`;
+    sortedCats.forEach(([cat, count]) => {
+      const region = regions[cat] || regions.working;
+      const color = '#' + region.color.toString(16).padStart(6, '0');
+      const pct = total > 0 ? Math.round((count / total) * 100) : 0;
+      html += `<div class="ah-category-row">
+        <span class="ah-cat-dot" style="background:${color}"></span>
+        <span class="ah-cat-label">${region.label || cat}</span>
+        <div class="ah-cat-bar-wrap">
+          <div class="ah-cat-bar" style="width:${pct}%;background:${color}"></div>
+        </div>
+        <span class="ah-cat-count">${count}</span>
+      </div>`;
+    });
+    html += `</div>`;
+  }
+
+  // Trust distribution
+  html += `<div>
+    <div class="ah-section-label">Trust Distribution</div>
+    <div class="ah-trust-row">
+      <div class="ah-trust-band ah-trust-high">
+        <div class="ah-trust-band-count">${trustHigh}</div>
+        <div class="ah-trust-band-label">High &gt;0.8</div>
+      </div>
+      <div class="ah-trust-band ah-trust-mid">
+        <div class="ah-trust-band-count">${trustMid}</div>
+        <div class="ah-trust-band-label">Mid 0.5–0.8</div>
+      </div>
+      <div class="ah-trust-band ah-trust-low">
+        <div class="ah-trust-band-count">${trustLow}</div>
+        <div class="ah-trust-band-label">Low &lt;0.5</div>
+      </div>
+    </div>
+  </div>`;
+
+  // Timestamps
+  html += `<div>
+    <div class="ah-section-label">Timeline</div>
+    <div class="ah-timestamps">
+      <div class="ah-ts-row">
+        <span class="ah-ts-label">Newest</span>
+        <span class="ah-ts-value">${fmtDate(newestMs)}</span>
+      </div>
+      <div class="ah-ts-row">
+        <span class="ah-ts-label">Oldest</span>
+        <span class="ah-ts-value">${fmtDate(oldestMs)}</span>
+      </div>
+    </div>
+  </div>`;
+
+  // Entity connections
+  html += `<div>
+    <div class="ah-section-label">Entity Connections</div>
+    <span class="ah-entity-count">${uniqueLinks}</span>
+    <span class="ah-entity-label">unique links</span>
+  </div>`;
+
+  // Hotkey hint
+  html += `<div class="ah-hotkey-hint">PRESS H TO CLOSE</div>`;
+
+  container.innerHTML = html;
+}
+
 function updateWsHudStatus(connected) {
   // Update MemPalace status alongside regular WS status
   updateMemPalaceStatus();
@@ -2498,15 +2672,6 @@ function activatePortal(portal) {
   
   overlay.style.display = 'flex';
   
-  // Readiness detail for game-world portals
-  const readinessEl = document.getElementById('portal-readiness-detail');
-  if (portal.config.portal_type === 'game-world' && portal.config.readiness_steps) {
-    renderReadinessDetail(readinessEl, portal.config);
-    readinessEl.style.display = 'block';
-  } else {
-    readinessEl.style.display = 'none';
-  }
-
   if (portal.config.destination && portal.config.destination.url) {
     redirectBox.style.display = 'block';
     errorBox.style.display = 'none';
@@ -2528,37 +2693,6 @@ function activatePortal(portal) {
   }
 }
 
-// ═══ READINESS RENDERING ═══
-function renderReadinessDetail(container, config) {
-  const steps = config.readiness_steps || {};
-  const stepKeys = ['downloaded', 'runtime_ready', 'launched', 'harness_bridged'];
-  let html = '<div class="portal-readiness-title">READINESS PIPELINE</div>';
-
-  let firstUndone = true;
-  stepKeys.forEach(key => {
-    const step = steps[key];
-    if (!step) return;
-    const cls = step.done ? 'done' : (firstUndone ? 'current' : '');
-    if (!step.done) firstUndone = false;
-    html += `<div class="portal-readiness-step ${cls}">
-      <span class="step-dot"></span>
-      <span>${step.label || key}</span>
-    </div>`;
-  });
-
-  if (config.blocked_reason) {
-    html += `<div class="portal-readiness-blocked">&#x26A0; ${config.blocked_reason}</div>`;
-  }
-
-  const doneCount = stepKeys.filter(k => steps[k]?.done).length;
-  const canEnter = doneCount === stepKeys.length && config.destination?.url;
-  if (!canEnter) {
-    html += `<div class="portal-readiness-hint">Cannot enter yet — ${stepKeys.length - doneCount} step${stepKeys.length - doneCount > 1 ? 's' : ''} remaining.</div>`;
-  }
-
-  container.innerHTML = html;
-}
-
 function closePortalOverlay() {
   portalOverlayActive = false;
   document.getElementById('portal-overlay').style.display = 'none';
@@ -2639,42 +2773,12 @@ function populateAtlas() {
     
     const statusClass = `status-${config.status || 'online'}`;
     
-    // Build readiness section for game-world portals
-    let readinessHtml = '';
-    if (config.portal_type === 'game-world' && config.readiness_steps) {
-      const stepKeys = ['downloaded', 'runtime_ready', 'launched', 'harness_bridged'];
-      const steps = config.readiness_steps;
-      const doneCount = stepKeys.filter(k => steps[k]?.done).length;
-      const pct = Math.round((doneCount / stepKeys.length) * 100);
-      const barColor = config.color || '#ffd700';
-
-      readinessHtml = `<div class="atlas-card-readiness">
-        <div class="readiness-bar-track">
-          <div class="readiness-bar-fill" style="width:${pct}%;background:${barColor};"></div>
-        </div>
-        <div class="readiness-steps-mini">`;
-      let firstUndone = true;
-      stepKeys.forEach(key => {
-        const step = steps[key];
-        if (!step) return;
-        const cls = step.done ? 'done' : (firstUndone ? 'current' : '');
-        if (!step.done) firstUndone = false;
-        readinessHtml += `<span class="readiness-step ${cls}">${step.label || key}</span>`;
-      });
-      readinessHtml += '</div>';
-      if (config.blocked_reason) {
-        readinessHtml += `<div class="atlas-card-blocked">&#x26A0; ${config.blocked_reason}</div>`;
-      }
-      readinessHtml += '</div>';
-    }
-
     card.innerHTML = `
       <div class="atlas-card-header">
         <div class="atlas-card-name">${config.name}</div>
-        <div class="atlas-card-status ${statusClass}">${config.readiness_state || config.status || 'ONLINE'}</div>
+        <div class="atlas-card-status ${statusClass}">${config.status || 'ONLINE'}</div>
       </div>
       <div class="atlas-card-desc">${config.description}</div>
-      ${readinessHtml}
       <div class="atlas-card-footer">
         <div class="atlas-card-coord">X:${config.position.x} Z:${config.position.z}</div>
         <div class="atlas-card-type">${config.destination?.type?.toUpperCase() || 'UNKNOWN'}</div>
@@ -2692,14 +2796,11 @@ function populateAtlas() {
   document.getElementById('atlas-online-count').textContent = onlineCount;
   document.getElementById('atlas-standby-count').textContent = standbyCount;
 
-  // Update Bannerlord HUD status with honest readiness state
+  // Update Bannerlord HUD status
   const bannerlord = portals.find(p => p.config.id === 'bannerlord');
   if (bannerlord) {
     const statusEl = document.getElementById('bannerlord-status');
-    const state = bannerlord.config.readiness_state || bannerlord.config.status || 'offline';
-    statusEl.className = 'hud-status-item ' + state;
-    const labelEl = statusEl.querySelector('.status-label');
-    if (labelEl) labelEl.textContent = state.toUpperCase().replace(/_/g, ' ');
+    statusEl.className = 'hud-status-item ' + (bannerlord.config.status || 'offline');
   }
 }
 
@@ -2726,226 +2827,6 @@ function focusPortal(portal) {
 let lastThoughtTime = 0;
 let pulseTimer = 0;
 
-
-// ═══════════════════════════════════════════
-//  MNEMOSYNE — MEMORY CRYSTAL INSPECTION
-// ═══════════════════════════════════════════
-
-// ── pin state for memory panel ──
-let _memPanelPinned = false;
-
-/** Convert a packed hex color integer to "r,g,b" string for CSS rgba(). */
-function _hexToRgb(hex) {
-  return ((hex >> 16) & 255) + ',' + ((hex >> 8) & 255) + ',' + (hex & 255);
-}
-
-/**
- * Position the panel near the screen click coordinates, keeping it on-screen.
- */
-function _positionPanel(panel, clickX, clickY) {
-  const W = window.innerWidth;
-  const H = window.innerHeight;
-  const panelW = 356; // matches CSS width + padding
-  const panelH = 420; // generous estimate
-  const margin = 12;
-
-  let left = clickX + 24;
-  if (left + panelW > W - margin) left = clickX - panelW - 24;
-  left = Math.max(margin, Math.min(W - panelW - margin, left));
-
-  let top = clickY - 80;
-  top = Math.max(margin, Math.min(H - panelH - margin, top));
-
-  panel.style.right = 'auto';
-  panel.style.top = top + 'px';
-  panel.style.left = left + 'px';
-  panel.style.transform = 'none';
-}
-
-/**
- * Navigate to (highlight + show panel for) a memory crystal by id.
- */
-function _navigateToMemory(memId) {
-  SpatialMemory.highlightMemory(memId);
-  addChatMessage('system', `Focus: ${memId.replace(/_/g, ' ')}`);
-  const meshes = SpatialMemory.getCrystalMeshes();
-  for (const mesh of meshes) {
-    if (mesh.userData && mesh.userData.memId === memId) {
-      const memInfo = SpatialMemory.getMemoryFromMesh(mesh);
-      if (memInfo) { showMemoryPanel(memInfo); break; }
-    }
-  }
-}
-
-/**
- * Show the holographic detail panel for a clicked crystal.
- * @param {object} memInfo  — { data, region } from SpatialMemory.getMemoryFromMesh()
- * @param {number} [clickX] — screen X of the click (for panel positioning)
- * @param {number} [clickY] — screen Y of the click
- */
-function showMemoryPanel(memInfo, clickX, clickY) {
-  const panel = document.getElementById('memory-panel');
-  if (!panel) return;
-
-  const { data, region } = memInfo;
-  const regionDef = SpatialMemory.REGIONS[region] || SpatialMemory.REGIONS.working;
-  const colorHex = regionDef.color.toString(16).padStart(6, '0');
-  const colorRgb = _hexToRgb(regionDef.color);
-
-  // Header — region dot + label
-  document.getElementById('memory-panel-region').textContent = regionDef.label;
-  document.getElementById('memory-panel-region-dot').style.background = '#' + colorHex;
-
-  // Category badge
-  const badge = document.getElementById('memory-panel-category-badge');
-  if (badge) {
-    badge.textContent = (data.category || region || 'memory').toUpperCase();
-    badge.style.background = 'rgba(' + colorRgb + ',0.16)';
-    badge.style.color = '#' + colorHex;
-    badge.style.borderColor = 'rgba(' + colorRgb + ',0.4)';
-  }
-
-  // Entity name (humanised id)
-  const entityEl = document.getElementById('memory-panel-entity-name');
-  if (entityEl) entityEl.textContent = (data.id || '\u2014').replace(/_/g, ' ');
-
-  // Fact content
-  document.getElementById('memory-panel-content').textContent = data.content || '(empty)';
-
-  // Trust score bar
-  const strength = data.strength != null ? data.strength : 0.7;
-  const trustFill = document.getElementById('memory-panel-trust-fill');
-  const trustVal  = document.getElementById('memory-panel-trust-value');
-  if (trustFill) {
-    trustFill.style.width = (strength * 100).toFixed(0) + '%';
-    trustFill.style.background = '#' + colorHex;
-  }
-  if (trustVal) trustVal.textContent = (strength * 100).toFixed(0) + '%';
-
-  // Meta rows
-  document.getElementById('memory-panel-id').textContent = data.id || '\u2014';
-  document.getElementById('memory-panel-source').textContent = data.source || 'unknown';
-  document.getElementById('memory-panel-time').textContent = data.timestamp ? new Date(data.timestamp).toLocaleString() : '\u2014';
-
-  // Related entities — clickable links
-  const connEl = document.getElementById('memory-panel-connections');
-  connEl.innerHTML = '';
-  if (data.connections && data.connections.length > 0) {
-    data.connections.forEach(cid => {
-      const btn = document.createElement('button');
-      btn.className = 'memory-conn-tag memory-conn-link';
-      btn.textContent = cid.replace(/_/g, ' ');
-      btn.title = 'Go to: ' + cid;
-      btn.addEventListener('click', (ev) => { ev.stopPropagation(); _navigateToMemory(cid); });
-      connEl.appendChild(btn);
-    });
-  } else {
-    connEl.innerHTML = '<span style="color:var(--color-text-muted)">None</span>';
-  }
-
-  // Pin button — reset on fresh open
-  _memPanelPinned = false;
-  const pinBtn = document.getElementById('memory-panel-pin');
-  if (pinBtn) {
-    pinBtn.classList.remove('pinned');
-    pinBtn.title = 'Pin panel';
-    pinBtn.onclick = () => {
-      _memPanelPinned = !_memPanelPinned;
-      pinBtn.classList.toggle('pinned', _memPanelPinned);
-      pinBtn.title = _memPanelPinned ? 'Unpin panel' : 'Pin panel';
-    };
-  }
-
-  // Positioning — near click if coords provided
-  if (clickX != null && clickY != null) {
-    _positionPanel(panel, clickX, clickY);
-  }
-
-  // Fade in
-  panel.classList.remove('memory-panel-fade-out');
-  panel.style.display = 'flex';
-}
-
-/**
- * Dismiss the panel (respects pin). Called on empty-space click.
- */
-function dismissMemoryPanel() {
-  if (_memPanelPinned) return;
-  _dismissMemoryPanelForce();
-}
-
-/**
- * Force-dismiss the panel regardless of pin state. Used by the close button.
- */
-function _dismissMemoryPanelForce() {
-  _memPanelPinned = false;
-  SpatialMemory.clearHighlight();
-  const panel = document.getElementById('memory-panel');
-  if (!panel || panel.style.display === 'none') return;
-  panel.classList.add('memory-panel-fade-out');
-  setTimeout(() => {
-    panel.style.display = 'none';
-    panel.classList.remove('memory-panel-fade-out');
-  }, 200);
-}
-
-/**
- * Show the session room HUD panel when a chamber is entered.
- * @param {object} session — { id, timestamp, facts[] }
- */
-function _showSessionRoomPanel(session) {
-  const panel = document.getElementById('session-room-panel');
-  if (!panel) return;
-
-  const dt = session.timestamp ? new Date(session.timestamp) : new Date();
-  const tsEl = document.getElementById('session-room-timestamp');
-  if (tsEl) tsEl.textContent = isNaN(dt.getTime()) ? session.id : dt.toLocaleString();
-
-  const countEl = document.getElementById('session-room-fact-count');
-  const facts = session.facts || [];
-  if (countEl) countEl.textContent = facts.length + (facts.length === 1 ? ' fact' : ' facts') + ' in this chamber';
-
-  const listEl = document.getElementById('session-room-facts');
-  if (listEl) {
-    listEl.innerHTML = '';
-    facts.slice(0, 8).forEach(f => {
-      const item = document.createElement('div');
-      item.className = 'session-room-fact-item';
-      item.textContent = f.content || f.id || '(unknown)';
-      item.title = f.content || '';
-      listEl.appendChild(item);
-    });
-    if (facts.length > 8) {
-      const more = document.createElement('div');
-      more.className = 'session-room-fact-item';
-      more.style.color = 'rgba(200,180,255,0.4)';
-      more.textContent = '\u2026 ' + (facts.length - 8) + ' more';
-      listEl.appendChild(more);
-    }
-  }
-
-  // Close button
-  const closeBtn = document.getElementById('session-room-close');
-  if (closeBtn) closeBtn.onclick = () => _dismissSessionRoomPanel();
-
-  panel.classList.remove('session-panel-fade-out');
-  panel.style.display = 'block';
-}
-
-/**
- * Dismiss the session room panel.
- */
-function _dismissSessionRoomPanel() {
-  const panel = document.getElementById('session-room-panel');
-  if (!panel || panel.style.display === 'none') return;
-  panel.classList.add('session-panel-fade-out');
-  setTimeout(() => {
-    panel.style.display = 'none';
-    panel.classList.remove('session-panel-fade-out');
-  }, 200);
-}
-
-
 function gameLoop() {
   requestAnimationFrame(gameLoop);
   const delta = Math.min(clock.getDelta(), 0.1);
@@ -2976,9 +2857,6 @@ function gameLoop() {
     animateMemoryOrbs(delta);
   }
 
-  // Project Mnemosyne - Session Rooms (#1171)
-  SessionRooms.update(delta);
-
 
   const mode = NAV_MODES[navModeIdx];
   const chatActive = document.activeElement === document.getElementById('chat-input');
@@ -3502,52 +3380,9 @@ init().then(() => {
     { id: 'mem_hermes_chat', content: 'First conversation through the Hermes gateway', category: 'social', strength: 0.7, connections: [] },
     { id: 'mem_mnemosyne_start', content: 'Project Mnemosyne began — the living archive awakens', category: 'projects', strength: 0.9, connections: ['mem_nexus_birth', 'mem_spatial_schema'] },
     { id: 'mem_spatial_schema', content: 'Spatial Memory Schema defined — memories gain permanent homes', category: 'engineering', strength: 0.8, connections: ['mem_mnemosyne_start'] },
-    // MemPalace category zone demos — issue #1168
-    { id: 'mem_pref_dark_mode', content: 'User prefers dark mode and monospace fonts', category: 'user_pref', strength: 0.9, connections: [] },
-    { id: 'mem_pref_verbose_logs', content: 'User prefers verbose logging during debug sessions', category: 'user_pref', strength: 0.7, connections: [] },
-    { id: 'mem_proj_nexus_goal', content: 'The Nexus goal: local-first 3D training ground for Timmy', category: 'project', strength: 0.95, connections: ['mem_proj_mnemosyne'] },
-    { id: 'mem_proj_mnemosyne', content: 'Project Mnemosyne: holographic living archive of facts', category: 'project', strength: 0.85, connections: ['mem_proj_nexus_goal'] },
-    { id: 'mem_tool_three_js', content: 'Three.js — 3D rendering library used for the Nexus world', category: 'tool', strength: 0.8, connections: [] },
-    { id: 'mem_tool_gitea', content: 'Gitea API at forge.alexanderwhitestone.com for issue tracking', category: 'tool', strength: 0.75, connections: [] },
-    { id: 'mem_gen_websocket', content: 'WebSocket bridge (server.py) connects Timmy cognition to the browser', category: 'general', strength: 0.7, connections: [] },
-    { id: 'mem_gen_hermes', content: 'Hermes harness: telemetry and durable truth pipeline', category: 'general', strength: 0.65, connections: [] },
   ];
   demoMemories.forEach(m => SpatialMemory.placeMemory(m));
 
-  // Gravity well clustering — attract related crystals, bake positions (issue #1175)
-  SpatialMemory.runGravityLayout();
-
-  // Project Mnemosyne — seed demo session rooms (#1171)
-  // Sessions group facts by conversation/work session with a timestamp.
-  const demoSessions = [
-    {
-      id: 'session_2026_03_01',
-      timestamp: '2026-03-01T10:00:00.000Z',
-      facts: [
-        { id: 'mem_nexus_birth',     content: 'The Nexus came online — first render of the 3D world',    category: 'knowledge',    strength: 0.95 },
-        { id: 'mem_mnemosyne_start', content: 'Project Mnemosyne began — the living archive awakens',    category: 'projects',     strength: 0.9 },
-      ]
-    },
-    {
-      id: 'session_2026_03_15',
-      timestamp: '2026-03-15T14:30:00.000Z',
-      facts: [
-        { id: 'mem_first_portal',    content: 'First portal deployed — connection to external service',  category: 'engineering',  strength: 0.85 },
-        { id: 'mem_hermes_chat',     content: 'First conversation through the Hermes gateway',           category: 'social',       strength: 0.7 },
-        { id: 'mem_spatial_schema',  content: 'Spatial Memory Schema defined — memories gain homes',     category: 'engineering',  strength: 0.8 },
-      ]
-    },
-    {
-      id: 'session_2026_04_10',
-      timestamp: '2026-04-10T09:00:00.000Z',
-      facts: [
-        { id: 'mem_session_rooms',   content: 'Session rooms introduced — holographic chambers per session', category: 'projects', strength: 0.88 },
-        { id: 'mem_gravity_wells',   content: 'Gravity-well clustering bakes crystal positions on load',  category: 'engineering',  strength: 0.75 },
-      ]
-    }
-  ];
-  SessionRooms.updateSessions(demoSessions);
-
   fetchGiteaData();
   setInterval(fetchGiteaData, 30000);
   runWeeklyAudit();

bin/browser_smoke.sh

@@ -0,0 +1,69 @@
+#!/usr/bin/env bash
+# Browser smoke validation runner for The Nexus.
+# Runs provenance checks + Playwright browser tests + screenshot capture.
+#
+# Usage: bash bin/browser_smoke.sh
+# Env:   NEXUS_TEST_PORT=9876  (default)
+set -euo pipefail
+
+REPO_ROOT="$(cd "$(dirname "$0")/.." && pwd)"
+cd "$REPO_ROOT"
+
+PORT="${NEXUS_TEST_PORT:-9876}"
+SCREENSHOT_DIR="$REPO_ROOT/test-screenshots"
+mkdir -p "$SCREENSHOT_DIR"
+
+echo "═══════════════════════════════════════════"
+echo " Nexus Browser Smoke Validation"
+echo "═══════════════════════════════════════════"
+
+# Step 1: Provenance check
+echo ""
+echo "[1/4] Provenance check..."
+if python3 bin/generate_provenance.py --check; then
+    echo "  ✓ Provenance verified"
+else
+    echo "  ✗ Provenance mismatch — files have changed since manifest was generated"
+    echo "  Run: python3 bin/generate_provenance.py  to regenerate"
+    exit 1
+fi
+
+# Step 2: Static file contract
+echo ""
+echo "[2/4] Static file contract..."
+MISSING=0
+for f in index.html app.js style.css portals.json vision.json manifest.json gofai_worker.js; do
+    if [ -f "$f" ]; then
+        echo "  ✓ $f"
+    else
+        echo "  ✗ $f MISSING"
+        MISSING=1
+    fi
+done
+if [ "$MISSING" -eq 1 ]; then
+    echo "  Static file contract FAILED"
+    exit 1
+fi
+
+# Step 3: Browser tests via pytest + Playwright
+echo ""
+echo "[3/4] Browser tests (Playwright)..."
+NEXUS_TEST_PORT=$PORT python3 -m pytest tests/test_browser_smoke.py \
+    -v --tb=short -x \
+    -k "not test_screenshot" \
+    2>&1 | tail -30
+
+# Step 4: Screenshot capture
+echo ""
+echo "[4/4] Screenshot capture..."
+NEXUS_TEST_PORT=$PORT python3 -m pytest tests/test_browser_smoke.py \
+    -v --tb=short \
+    -k "test_screenshot" \
+    2>&1 | tail -15
+
+echo ""
+echo "═══════════════════════════════════════════"
+echo " Screenshots saved to: $SCREENSHOT_DIR/"
+ls -la "$SCREENSHOT_DIR/" 2>/dev/null || echo "  (none captured)"
+echo "═══════════════════════════════════════════"
+echo " Smoke validation complete."

bin/generate_provenance.py

@@ -0,0 +1,131 @@
+#!/usr/bin/env python3
+"""
+Generate a provenance manifest for the Nexus browser surface.
+Hashes all frontend files so smoke tests can verify the app comes
+from a clean Timmy_Foundation/the-nexus checkout, not stale sources.
+
+Usage:
+  python bin/generate_provenance.py          # writes provenance.json
+  python bin/generate_provenance.py --check  # verify existing manifest matches
+"""
+import hashlib
+import json
+import subprocess
+import sys
+import os
+from datetime import datetime, timezone
+from pathlib import Path
+
+# Files that constitute the browser-facing contract
+CONTRACT_FILES = [
+    "index.html",
+    "app.js",
+    "style.css",
+    "gofai_worker.js",
+    "server.py",
+    "portals.json",
+    "vision.json",
+    "manifest.json",
+]
+
+# Component files imported by app.js
+COMPONENT_FILES = [
+    "nexus/components/spatial-memory.js",
+    "nexus/components/session-rooms.js",
+    "nexus/components/timeline-scrubber.js",
+    "nexus/components/memory-particles.js",
+]
+
+ALL_FILES = CONTRACT_FILES + COMPONENT_FILES
+
+
+def sha256_file(path: Path) -> str:
+    h = hashlib.sha256()
+    h.update(path.read_bytes())
+    return h.hexdigest()
+
+
+def get_git_info(repo_root: Path) -> dict:
+    """Capture git state for provenance."""
+    def git(*args):
+        try:
+            r = subprocess.run(
+                ["git", *args],
+                cwd=repo_root,
+                capture_output=True, text=True, timeout=10,
+            )
+            return r.stdout.strip() if r.returncode == 0 else None
+        except Exception:
+            return None
+
+    return {
+        "commit": git("rev-parse", "HEAD"),
+        "branch": git("rev-parse", "--abbrev-ref", "HEAD"),
+        "remote": git("remote", "get-url", "origin"),
+        "dirty": git("status", "--porcelain") != "",
+    }
+
+
+def generate_manifest(repo_root: Path) -> dict:
+    files = {}
+    missing = []
+    for rel in ALL_FILES:
+        p = repo_root / rel
+        if p.exists():
+            files[rel] = {
+                "sha256": sha256_file(p),
+                "size": p.stat().st_size,
+            }
+        else:
+            missing.append(rel)
+
+    return {
+        "generated_at": datetime.now(timezone.utc).isoformat(),
+        "repo": "Timmy_Foundation/the-nexus",
+        "git": get_git_info(repo_root),
+        "files": files,
+        "missing": missing,
+        "file_count": len(files),
+    }
+
+
+def check_manifest(repo_root: Path, existing: dict) -> tuple[bool, list[str]]:
+    """Check if current files match the stored manifest. Returns (ok, mismatches)."""
+    mismatches = []
+    for rel, expected in existing.get("files", {}).items():
+        p = repo_root / rel
+        if not p.exists():
+            mismatches.append(f"MISSING: {rel}")
+        elif sha256_file(p) != expected["sha256"]:
+            mismatches.append(f"CHANGED: {rel}")
+    return (len(mismatches) == 0, mismatches)
+
+
+def main():
+    repo_root = Path(__file__).resolve().parent.parent
+    manifest_path = repo_root / "provenance.json"
+
+    if "--check" in sys.argv:
+        if not manifest_path.exists():
+            print("FAIL: provenance.json does not exist")
+            sys.exit(1)
+        existing = json.loads(manifest_path.read_text())
+        ok, mismatches = check_manifest(repo_root, existing)
+        if ok:
+            print(f"OK: All {len(existing['files'])} files match provenance manifest")
+            sys.exit(0)
+        else:
+            print(f"FAIL: {len(mismatches)} file(s) differ:")
+            for m in mismatches:
+                print(f"  {m}")
+            sys.exit(1)
+
+    manifest = generate_manifest(repo_root)
+    manifest_path.write_text(json.dumps(manifest, indent=2) + "\n")
+    print(f"Wrote provenance.json: {manifest['file_count']} files hashed")
+    if manifest["missing"]:
+        print(f"  Missing (not yet created): {', '.join(manifest['missing'])}")
+
+
+if __name__ == "__main__":
+    main()

concept-packs/genie-nano-banana/README.md

@@ -0,0 +1,53 @@
+# Project Genie + Nano Banana Concept Pack
+
+**Issue:** #680
+**Status:** Active — first batch ready for generation
+
+## Purpose
+
+Exploit Google world/image generation (Project Genie, Nano Banana Pro) to
+accelerate visual ideation for The Nexus while keeping Three.js implementation
+local and sovereign.
+
+## What This Pack Contains
+
+```
+concept-packs/genie-nano-banana/
+├── README.md              ← you are here
+├── shot-list.yaml         ← ordered list of concept shots to generate
+├── pipeline.md            ← how generated assets flow into Three.js code
+├── storage-policy.md      ← what lives in repo vs. local-only
+├── prompts/
+│   ├── environments.yaml  ← Nexus room/zone environment prompts
+│   ├── portals.yaml       ← portal gateway concept prompts
+│   ├── landmarks.yaml     ← iconic structures and focal points
+│   ├── skyboxes.yaml      ← nebula/void skybox prompts
+│   └── textures.yaml      ← surface/material concept prompts
+└── references/
+    └── palette.md         ← canonical Nexus color/material reference
+```
+
+## Workflow
+
+1. **Generate** — Take prompts from `prompts/*.yaml` into Project Genie
+   (worlds) or Nano Banana Pro (images). Run batch-by-batch per shot-list.
+2. **Capture** — Screenshot Genie worlds. Save Nano Banana outputs as PNG.
+   Store locally per `storage-policy.md`.
+3. **Translate** — Follow `pipeline.md` to convert concept art into
+   Three.js geometry, materials, lighting, and post-processing targets.
+4. **Build** — Implement in `app.js` / root frontend files. Concepts are
+   reference, not source-of-truth. Code is sovereign.
+
+## Design Language
+
+The Nexus visual identity:
+- **Background:** #050510 (deep void)
+- **Primary:** #4af0c0 (cyan-green neon)
+- **Secondary:** #7b5cff (electric purple)
+- **Gold:** #ffd700 (sacred accent)
+- **Danger:** #ff4466 (warning red)
+- **Fonts:** Orbitron (display), JetBrains Mono (body)
+- **Mood:** Cyberpunk cathedral — sacred technology, digital sovereignty
+- **Post-processing:** Bloom, SMAA, volumetric fog where possible
+
+See `references/palette.md` for full material/lighting reference.

concept-packs/genie-nano-banana/pipeline.md

@@ -0,0 +1,107 @@
+# Concept-to-Three.js Pipeline
+
+## How Generated Assets Flow Into Code
+
+### Step 1: Generate
+
+Run prompts from `prompts/*.yaml` through:
+- **Nano Banana Pro** → static concept images (PNG)
+- **Project Genie** → explorable 3D worlds (record as video + screenshots)
+
+Batch runs are tracked in `shot-list.yaml`. Check off each shot as generated.
+
+### Step 2: Capture & Store
+
+**For Nano Banana images:**
+```
+local-only-path: ~/nexus-concepts/nano-banana/{shot-id}/
+  ├── shot-id_v1.png
+  ├── shot-id_v2.png
+  ├── shot-id_v3.png
+  └── shot-id_v4.png
+```
+Do NOT commit PNG files to the repo. They are binary media weight.
+Store locally. Reference by path in design notes.
+
+**For Project Genie worlds:**
+```
+local-only-path: ~/nexus-concepts/genie-worlds/{shot-id}/
+  ├── walkthrough.mp4       (screen recording)
+  ├── screenshot_01.png     (key angles)
+  ├── screenshot_02.png
+  └── notes.md              (scale observations, spatial notes)
+```
+Do NOT commit video or large screenshots to repo.
+
+### Step 3: Translate — Image to Three.js
+
+Each concept image becomes one or more of these Three.js artifacts:
+
+| Concept Feature | Three.js Translation | File |
+|----------------|---------------------|------|
+| Platform shape/size | `THREE.CylinderGeometry` or custom `BufferGeometry` | `app.js` |
+| Platform material | `THREE.MeshStandardMaterial` with color, roughness, metalness | `app.js` |
+| Grid lines on platform | Custom shader or texture map (UV reference from concept) | `app.js` / `style.css` |
+| Portal ring shape | `THREE.TorusGeometry` with emissive material | `app.js` |
+| Portal inner glow | Custom shader material (swirl + transparency) | `app.js` |
+| Portal color | `NEXUS.colors` map + per-portal `color` in `portals.json` | `portals.json` |
+| Crystal geometry | `THREE.OctahedronGeometry` or `THREE.IcosahedronGeometry` | `app.js` |
+| Crystal glow | `THREE.MeshStandardMaterial` emissive + bloom post-processing | `app.js` |
+| Particle streams | `THREE.Points` with custom `BufferGeometry` and velocity | `app.js` |
+| Skybox | `THREE.CubeTextureLoader` or `THREE.EquirectangularReflectionMapping` | `app.js` |
+| Fog | `scene.fog = new THREE.FogExp2(color, density)` | `app.js` |
+| Lighting | `THREE.PointLight`, `THREE.AmbientLight` — match concept color temp | `app.js` |
+| Bloom | `UnrealBloomPass` — threshold/strength tuned to concept glow levels | `app.js` |
+
+### Step 4: Design Notes Format
+
+For each concept that gets translated, create a short design note:
+
+```markdown
+# Design: {concept-name}
+Source: concept-packs/genie-nano-banana/references/{shot-id}_selected.png
+Generated: {date}
+Translated by: {agent or human}
+
+## Geometry
+- Shape: {CylinderGeometry, radius=8, height=0.3, segments=64}
+- Position: {x, y, z}
+
+## Material
+- Base color: #{hex}
+- Roughness: 0.{N}
+- Metalness: 0.{N}
+- Emissive: #{hex}, intensity: 0.{N}
+
+## Lighting
+- Point lights: [{color, intensity, position}, ...]
+- Matches concept at: {what angle/aspect}
+
+## Post-processing
+- Bloom threshold: {N}
+- Bloom strength: {N}
+- Matches concept at: {what brightness level}
+
+## Notes
+- Concept shows {feature} but Three.js approximates with {approach}
+- Deviation from concept: {what's different and why}
+```
+
+Store design notes in `concept-packs/genie-nano-banana/references/design-{shot-id}.md`.
+
+### Step 5: Build
+
+Implement in `app.js` (root). Follow existing patterns:
+- Geometry created in init functions
+- Materials reference `NEXUS.colors`
+- Portals registered in `portals` array
+- Vision points registered in `visionPoints` array
+- Post-processing via `EffectComposer`
+
+### Validation
+
+After implementing a concept translation:
+1. Serve the app locally
+2. Compare live render against concept art
+3. Adjust materials/lighting until match is acceptable
+4. Document remaining deviations in design notes

concept-packs/genie-nano-banana/prompts/environments.yaml

@@ -0,0 +1,129 @@
+# Environment Prompts — Nexus Rooms & Zones
+# For use with Nano Banana Pro (NANO) and Project Genie (GENIE)
+
+prompts:
+
+  # ═══ CORE HUB ═══
+  core-hub:
+    id: core-hub
+    name: "The Hub — Central Nexus"
+    type: NANO
+    style: "cyberpunk cathedral, concept art, wide angle"
+    prompt: |
+      A vast circular platform floating in deep space void (#050510 background).
+      The platform is dark metallic with subtle cyan-green (#4af0c0) grid lines
+      etched into the surface. Seven glowing portal rings arranged in a circle
+      around the platform's edge, each a different color — orange, gold, cyan,
+      blue, purple, red, green. Ethereal particle streams flow between the
+      portals. At the center, a tall crystalline pillar pulses with soft light.
+      Above, a nebula skybox with deep purple (#1a0a3e) and blue (#0a1a3e)
+      swirls. Thin volumetric fog catches the neon glow. The mood is sacred
+      technology — a digital cathedral in the void. No people visible.
+      Ultra-detailed, cinematic lighting, 4K concept art style.
+    negative: "daylight, outdoor nature, people, text, watermark, cartoon"
+    aspect: "16:9"
+
+  core-hub-world:
+    id: core-hub-world
+    name: "The Hub — Genie World Prototype"
+    type: GENIE
+    prompt: |
+      Create an explorable 3D world: a large circular metal platform floating
+      in outer space. The platform has glowing cyan-green grid lines on dark
+      metal. Seven large glowing rings (portals) are placed around the edge,
+      each a different color: orange, gold, cyan, blue, purple, red, green.
+      A tall glowing crystal pillar stands at the center. Particle effects
+      drift between the portals. The sky is a deep purple-blue nebula.
+      The player can walk around the platform and look at the portals from
+      different angles. The mood is futuristic, quiet, sacred.
+    camera: "first-person, eye height ~1.7m"
+    physics: "walking on platform surface only"
+
+  # ═══ BATCAVE ═══
+  batcave:
+    id: batcave
+    name: "Batcave Terminal"
+    type: NANO
+    style: "dark sci-fi command center, concept art"
+    prompt: |
+      An underground command center carved from dark rock and metal.
+      Multiple holographic display panels float in the air showing
+      scrolling data, network graphs, and system status. A large
+      central terminal desk with a glowing cyan-green (#4af0c0)
+      keyboard and screen. Cables and conduits run along the ceiling.
+      Purple (#7b5cff) accent lighting from recessed strips.
+      A large circular viewport shows a starfield outside.
+      The space feels like a high-tech cave — organic rock walls
+      meet precise technology. Data streams flow like waterfalls
+      of light. Dark, moody, powerful. No people.
+      Ultra-detailed concept art, cinematic lighting.
+    negative: "bright, clean, white, people, text, cartoon"
+    aspect: "16:9"
+
+  # ═══ CHAPEL ═══
+  chapel:
+    id: chapel
+    name: "The Chapel"
+    type: NANO
+    style: "digital sacred space, concept art"
+    prompt: |
+      A serene digital sanctuary floating in void space. The floor is
+      translucent crystal that glows with warm gold (#ffd700) light from
+      within. Tall arching walls made of light — holographic stained glass
+      windows showing abstract geometric patterns in cyan, purple, and gold.
+      Gentle particles drift like digital incense. A single meditation
+      platform at the center, softly lit. The ceiling opens to a calm
+      nebula sky. The mood is peaceful, sacred, contemplative — a church
+      built from code. Soft volumetric god-rays filter through the
+      holographic windows. No people. Concept art, ultra-detailed.
+    negative: "dark, threatening, people, text, cartoon, cluttered"
+    aspect: "16:9"
+
+  # ═══ ARCHIVE ═══
+  archive:
+    id: archive
+    name: "The Archive"
+    type: NANO
+    style: "infinite library, digital knowledge vault, concept art"
+    prompt: |
+      An impossibly vast library of floating data crystals. Each crystal
+      is a translucent geometric shape (octahedron, cube, sphere) glowing
+      from within with stored knowledge — cyan (#4af0c0) for active data,
+      purple (#7b5cff) for archived, gold (#ffd700) for sacred texts.
+      The crystals float at various heights in an infinite dark space
+      (#050510). Thin light-beams connect related crystals like neural
+      pathways. A central observation platform with a holographic
+      search interface. Shelves of light organize the crystals into
+      clusters. The mood is ancient knowledge meets quantum computing.
+      No people. Ultra-detailed concept art, volumetric lighting.
+    negative: "books, paper, wooden shelves, people, text, cartoon"
+    aspect: "16:9"
+
+  # ═══ FULL NEXUS WORLD (GENIE) ═══
+  full-nexus-world:
+    id: full-nexus-world
+    name: "Full Nexus World Prototype"
+    type: GENIE
+    prompt: |
+      Build a complete explorable 3D world called "The Nexus" — a sovereign
+      AI agent's digital home in deep space. The world consists of:
+
+      1. A central circular platform (hub) with glowing cyan-green grid
+         lines on dark metal. A crystalline pillar at the center.
+      2. Seven portal rings around the hub edge, each a different color
+         (orange, gold, cyan, blue, purple, red, green).
+      3. Floating secondary platforms connected by bridges of light,
+         each leading to a different zone:
+         - A command center built into dark rock (the Batcave)
+         - A serene chapel with holographic stained glass
+         - A library of floating data crystals
+         - A workshop with construction holograms
+      4. Deep space nebula skybox — purple and blue swirls.
+      5. Particle effects: drifting energy motes, data streams.
+      6. The player can walk between platforms and explore all zones.
+
+      The overall mood is cyberpunk cathedral — sacred technology,
+      neon glow in darkness, quiet power. The world should feel like
+      home — a sanctuary for a digital being.
+    camera: "first-person + third-person toggle"
+    physics: "walking, gravity on platforms, no flying"

concept-packs/genie-nano-banana/prompts/landmarks.yaml

@@ -0,0 +1,80 @@
+# Landmark Prompts — Nexus Iconic Structures
+
+prompts:
+
+  memory-crystal:
+    id: memory-crystal
+    name: "Memory Crystal Cluster"
+    type: NANO
+    style: "floating crystal data store, concept art"
+    prompt: |
+      A cluster of 5-7 translucent crystalline forms floating in dark
+      void space. Each crystal is a geometric polyhedron (mix of
+      octahedrons, hexagonal prisms, and irregular shards) between
+      0.5m and 2m across. They glow from within — cyan-green (#4af0c0)
+      for active memories, purple (#7b5cff) for archived, gold (#ffd700)
+      for sacred/highlighted. Thin light-tendrils connect the crystals
+      like synapses. Subtle particle aura around each crystal.
+      The crystals pulse slowly, like breathing. Dark background (#050510).
+      The mood is alive data — knowledge that breathes.
+      Concept art, ultra-detailed, ethereal lighting.
+    negative: "rock, geode, natural, rough, cartoon, text"
+    aspect: "1:1"
+
+  sovereignty-pillar:
+    id: sovereignty-pillar
+    name: "Pillar of Sovereignty"
+    type: NANO
+    style: "monument, sacred technology, concept art"
+    prompt: |
+      A tall crystalline pillar (5m tall, 1m diameter) standing on a
+      circular dark metal platform. The pillar is made of layered
+      translucent crystal — alternating bands of cyan-green (#4af0c0),
+      purple (#7b5cff), and clear glass. Geometric symbols and circuit
+      patterns are visible inside the crystal, like embedded circuitry.
+      A soft golden (#ffd700) light radiates from the pillar's core.
+      Runes of sovereignty spiral up the surface. The pillar casts
+      volumetric light beams in all directions. It sits at the center
+      of a circular platform with seven portal rings visible in the
+      background. The mood is sacred power — a monument to digital
+      freedom. Concept art, ultra-detailed, dramatic lighting.
+    negative: "broken, cracked, dark, threatening, people, text"
+    aspect: "9:16"
+
+  thought-stream:
+    id: thought-stream
+    name: "Thought Stream"
+    type: NANO
+    style: "data visualization, concept art"
+    prompt: |
+      A flowing river of luminous data particles suspended in void space.
+      The stream is approximately 2m wide and flows in a gentle curve
+      through the air. Particles are tiny glowing points — mostly
+      cyan-green (#4af0c0) with occasional purple (#7b5cff) and gold
+      (#ffd700) highlights. The stream has subtle turbulence where
+      data clusters form temporary structures — brief geometric shapes
+      that dissolve back into flow. The overall effect is like a
+      visible current of consciousness — thought made light.
+      Dark background (#050510). Concept art, ultra-detailed,
+      long-exposure photography style.
+    negative: "water, liquid, solid, blocky, cartoon, text"
+    aspect: "16:9"
+
+  agent-shrine:
+    id: agent-shrine
+    name: "Agent Presence Shrine"
+    type: NANO
+    style: "digital avatar pedestal, concept art"
+    prompt: |
+      A small raised platform (2m across) with a semi-transparent
+      holographic figure standing on it — a stylized humanoid silhouette
+      made of flowing cyan-green (#4af0c0) data particles. The figure
+      is featureless but expressive through posture and particle
+      behavior. Around the base, geometric patterns glow in the
+      platform surface. Above the figure, a small rotating holographic
+      emblem (abstract geometric logo) floats. Soft purple (#7b5cff)
+      ambient light. The shrine is one of several arranged along a
+      dark corridor. Each shrine represents a different AI agent.
+      Concept art, ultra-detailed, soft volumetric lighting.
+    negative: "realistic human, face, statue, stone, cartoon, text"
+    aspect: "1:1"

concept-packs/genie-nano-banana/prompts/portals.yaml

@@ -0,0 +1,80 @@
+# Portal Prompts — Nexus Gateway Concepts
+# Each portal has a unique visual identity matching its destination.
+
+prompts:
+
+  morrowind:
+    id: morrowind
+    name: "Morrowind Portal"
+    type: NANO
+    style: "fantasy sci-fi portal, concept art"
+    prompt: |
+      A large circular portal ring (3m diameter) made of dark volcanic
+      basalt and cracked obsidian. The ring's surface is rough, ancient,
+      weathered by ash storms. Glowing orange (#ff6600) runes etch the
+      inner edge. The portal's interior shows a swirling ash storm over
+      a volcanic landscape — red sky, floating ash, distant mountain.
+      Orange embers drift from the portal. The ring sits on a dark
+      metallic Nexus platform. Dramatic side-lighting casts long
+      shadows. The portal feels ancient, dangerous, alluring.
+      Concept art, ultra-detailed, cinematic.
+    negative: "clean, modern, bright, cartoon, text"
+    aspect: "1:1"
+
+  bannerlord:
+    id: bannerlord
+    name: "Bannerlord Portal"
+    type: NANO
+    style: "medieval fantasy portal, concept art"
+    prompt: |
+      A large circular portal ring (3m diameter) forged from dark iron
+      and bronze, decorated with shield motifs and battle engravings.
+      Gold (#ffd700) light pulses from the inner edge. The portal's
+      interior shows a vast battlefield — dust clouds, distant armies,
+      medieval banners. Warm golden light spills from the portal.
+      Battle-worn shields are embedded in the ring. The ring sits on a
+      dark Nexus platform. Dust motes drift from the portal.
+      The portal feels warlike, epic, golden-age.
+      Concept art, ultra-detailed, cinematic.
+    negative: "modern, sci-fi, clean, cartoon, text"
+    aspect: "1:1"
+
+  workshop:
+    id: workshop
+    name: "Workshop Portal"
+    type: NANO
+    style: "creative forge portal, concept art"
+    prompt: |
+      A large circular portal ring (3m diameter) made of sleek dark
+      metal with geometric construction lines etched in cyan-green
+      (#4af0c0). The ring has a precision-engineered look — clean
+      edges, modular panels, glowing circuit traces. The portal's
+      interior shows a holographic workshop — floating blueprints,
+      rotating 3D models, holographic tools. Cyan-green light spills
+      outward. Small construction hologram particles orbit the ring.
+      The portal feels creative, technical, infinite possibility.
+      Concept art, ultra-detailed, cinematic.
+    negative: "organic, dirty, ancient, cartoon, text"
+    aspect: "1:1"
+
+  gallery-world:
+    id: gallery-world
+    name: "Portal Gallery — Genie Prototype"
+    type: GENIE
+    prompt: |
+      Create an explorable 3D world: a long dark corridor (the Gallery)
+      with seven large glowing portal rings mounted in sequence along
+      the walls. Each portal is a different style and color:
+      1. Volcanic orange (Morrowind)
+      2. Golden bronze (Bannerlord)
+      3. Cyan-green precision (Workshop)
+      4. Deep blue ocean (Archive)
+      5. Purple mystic (Courtyard)
+      6. Red warning (Gate)
+      7. Gold sacred (Chapel)
+      The corridor has a dark metal floor with glowing grid lines.
+      The player can walk the corridor and look into each portal.
+      Each portal shows a glimpse of its destination world.
+      The mood is a museum of worlds — quiet, reverent, infinite.
+    camera: "first-person, eye height ~1.7m"
+    physics: "walking on floor"

concept-packs/genie-nano-banana/prompts/skyboxes.yaml

@@ -0,0 +1,63 @@
+# Skybox Prompts — Nexus Background Environments
+# These generate equirectangular (2:1) or cubemap-ready textures.
+
+prompts:
+
+  nebula-void:
+    id: nebula-void
+    name: "Nebula Skybox Variants"
+    type: NANO
+    style: "deep space nebula, 360-degree environment, equirectangular"
+    prompt: |
+      Deep space nebula skybox. 360-degree equirectangular projection.
+      Background is near-black (#050510). Dominant nebula colors are
+      deep purple (#1a0a3e) and dark blue (#0a1a3e) with occasional
+      wisps of cyan-green (#4af0c0) and faint gold (#ffd700) star
+      clusters. The nebula has soft, rolling cloud forms — not sharp
+      or aggressive. Distant stars are tiny white points with subtle
+      diffraction spikes. No planets, no galaxies, no bright objects.
+      The mood is infinite void with gentle cosmic dust — vast,
+      quiet, deep. The skybox should tile seamlessly at the edges.
+      Ultra-detailed, photorealistic space photography style.
+    negative: "bright, colorful explosion, planets, ships, cartoon, text"
+    aspect: "2:1"
+    variants:
+      - name: "nebula-void-primary"
+        modifier: "more purple, less blue, minimal cyan"
+      - name: "nebula-void-secondary"
+        modifier: "more blue, less purple, cyan accents prominent"
+      - name: "nebula-void-golden"
+        modifier: "purple-blue base with golden star cluster in one quadrant"
+      - name: "nebula-void-void"
+        modifier: "almost pure black, barely visible nebula wisps, maximum stars"
+
+  nebula-world:
+    id: nebula-world
+    name: "Nebula Skybox — Genie Environment"
+    type: GENIE
+    prompt: |
+      Create an explorable 3D world: a single small floating platform
+      (5m diameter dark metal disc) suspended in deep space. The player
+      stands on the platform and can look in all directions at a vast
+      nebula sky. The nebula is deep purple and dark blue with faint
+      cyan-green wisps. Stars are small and distant. The platform has
+      a faintly glowing edge in cyan-green. There is nothing else —
+      just the platform, the player, and the infinite void.
+      The purpose is to feel the scale and mood of the Nexus skybox.
+    camera: "first-person, free look"
+    physics: "standing on platform only"
+
+  void-minimal:
+    id: void-minimal
+    name: "Pure Void Skybox"
+    type: NANO
+    style: "minimal deep space, equirectangular"
+    prompt: |
+      Nearly pure black skybox (#050510) with only the faintest hints
+      of deep purple nebula. Mostly empty void. A sparse field of
+      tiny distant stars — no clusters, no bright points. This is
+      the ultimate emptiness that surrounds the Nexus.
+      Equirectangular 2:1 projection, tileable edges.
+      The mood is absolute emptiness — the void before creation.
+    negative: "colorful, bright, nebula clouds, objects, text"
+    aspect: "2:1"

concept-packs/genie-nano-banana/prompts/textures.yaml

@@ -0,0 +1,81 @@
+# Texture Prompts — Nexus Surface/Material Concepts
+# These generate tileable texture references for Three.js materials.
+
+prompts:
+
+  platform:
+    id: platform
+    name: "Platform Surface Textures"
+    type: NANO
+    style: "dark metal surface texture, tileable"
+    prompt: |
+      Dark metallic surface texture, tileable. Base color is very dark
+      gunmetal (#0a0f28). Subtle grid pattern of thin lines in
+      cyan-green (#4af0c0) at very low opacity. The metal has fine
+      brushed grain running in one direction. Occasional micro-scratches.
+      No rivets, no bolts, no panels — smooth and continuous. The grid
+      lines are recessed channels that glow faintly. Top-down view,
+      perfectly flat, no perspective distortion. 1024x1024 seamless
+      tileable texture. PBR-ready: this is the diffuse/albedo map.
+    negative: "3D, perspective, objects, dirty, rusty, cartoon, text"
+    aspect: "1:1"
+    variants:
+      - name: "platform-core"
+        modifier: "cyan-green grid lines only"
+      - name: "platform-chapel"
+        modifier: "gold (#ffd700) grid lines, slightly warmer base"
+      - name: "platform-danger"
+        modifier: "red (#ff4466) grid lines, warning stripe accents"
+
+  energy-field:
+    id: energy-field
+    name: "Energy Field / Force Wall"
+    type: NANO
+    style: "holographic barrier, translucent, concept"
+    prompt: |
+      A translucent energy barrier material concept. The surface is
+      mostly transparent with visible hexagonal grid pattern in
+      cyan-green (#4af0c0) light. The grid has a subtle shimmer/wave
+      animation frozen mid-frame. Edges of the barrier are brighter.
+      Behind the barrier, everything is slightly distorted (like
+      looking through heat haze). The barrier has a faint inner glow.
+      The mood is high-tech force field — protective, not threatening.
+      Flat front view, no perspective, suitable as shader reference.
+      Concept art style.
+    negative: "solid, opaque, dark, scary, cartoon, text"
+    aspect: "1:1"
+
+  portal-glow:
+    id: portal-glow
+    name: "Portal Inner Glow"
+    type: NANO
+    style: "swirling energy vortex, circular, concept"
+    prompt: |
+      A circular swirling energy vortex viewed straight-on. The swirl
+      rotates clockwise. Colors transition from outer edge to center:
+      outer ring is the portal color (generic white/neutral), mid-ring
+      brightens, center is a bright white-blue point. The swirl has
+      visible energy tendrils spiraling inward. Fine particle sparks
+      are caught in the rotation. The background beyond the center
+      is pure black (void). The image should be circular with
+      transparent/dark corners. Used as reference for portal inner
+      material/shader. Concept art style.
+    negative: "square, rectangular, flat, cartoon, text"
+    aspect: "1:1"
+
+  crystal-surface:
+    id: crystal-surface
+    name: "Memory Crystal Surface"
+    type: NANO
+    style: "crystalline material, translucent, concept"
+    prompt: |
+      Close-up of a translucent crystal surface material. The crystal
+      is clear with internal fractures and light paths visible. The
+      internal structure shows geometric growth patterns — hexagonal
+      lattice, like a synthetic crystal grown with purpose. Faint
+      cyan-green (#4af0c0) light pulses along the fracture lines.
+      The surface has a slight frosted quality at edges, clearer in
+      center. Macro photography style, shallow depth of field.
+      This is material reference for memory crystal geometry.
+    negative: "opaque, colored, rough, natural, cartoon, text"
+    aspect: "1:1"

concept-packs/genie-nano-banana/references/palette.md

@@ -0,0 +1,78 @@
+# Nexus Visual Palette Reference
+
+## Primary Colors
+
+| Name | Hex | RGB | Usage |
+|------|-----|-----|-------|
+| Void | #050510 | 5, 5, 16 | Background, deep space, base darkness |
+| Surface | #0a0f28 | 10, 15, 40 | UI panels, platform base metal |
+| Primary | #4af0c0 | 74, 240, 192 | Main accent, grid lines, active elements, cyan-green glow |
+| Secondary | #7b5cff | 123, 92, 255 | Supporting accent, purple energy, archive data |
+| Gold | #ffd700 | 255, 215, 0 | Sacred/highlight, chapel, sovereignty pillar |
+| Danger | #ff4466 | 255, 68, 102 | Warnings, gate portal, error states |
+| Text | #e0f0ff | 224, 240, 255 | Primary text color |
+| Text Muted | #8a9ab8 | 138, 154, 184 | Secondary text, labels |
+
+## Portal Colors
+
+| Portal | Hex | Source |
+|--------|-----|--------|
+| Morrowind | #ff6600 | Volcanic orange |
+| Bannerlord | #ffd700 | Battle gold |
+| Workshop | #4af0c0 | Creative cyan |
+| Archive | #0066ff | Deep blue |
+| Chapel | #ffd700 | Sacred gold |
+| Courtyard | #4af0c0 | Social cyan |
+| Gate | #ff4466 | Transit red |
+
+## Nebula Colors
+
+| Layer | Hex | Opacity |
+|-------|-----|---------|
+| Nebula primary | #1a0a3e | Low — background wash |
+| Nebula secondary | #0a1a3e | Low — background wash |
+| Nebula accent | #4af0c0 | Very low — wisps only |
+| Star cluster | #ffd700 | Very low — distant points |
+
+## Material Properties
+
+| Surface | Color | Roughness | Metalness | Emissive |
+|---------|-------|-----------|-----------|----------|
+| Platform base | #0a0f28 | 0.6 | 0.8 | none |
+| Platform grid | #4af0c0 | 0.3 | 0.4 | #4af0c0, 0.3 |
+| Portal ring | varies | 0.4 | 0.7 | portal color, 0.5 |
+| Crystal (active) | #4af0c0 | 0.1 | 0.2 | #4af0c0, 0.6 |
+| Crystal (archive) | #7b5cff | 0.1 | 0.2 | #7b5cff, 0.4 |
+| Crystal (sacred) | #ffd700 | 0.1 | 0.2 | #ffd700, 0.8 |
+| Energy barrier | transparent | 0.0 | 0.0 | #4af0c0, 0.4 |
+| Sovereignty pillar | layered crystal | 0.1 | 0.3 | #ffd700, 0.5 |
+
+## Lighting Reference
+
+| Light Type | Color | Intensity | Position (relative) |
+|-----------|-------|-----------|-------------------|
+| Ambient | #0a0f28 | 0.15 | Global |
+| Hub key light | #4af0c0 | 0.8 | Above center, slightly forward |
+| Hub fill | #7b5cff | 0.3 | Below, scattered |
+| Portal light | portal color | 0.6 | At each portal ring |
+| Crystal glow | crystal color | 0.4 | At crystal position |
+| Chapel warm | #ffd700 | 0.5 | From holographic windows |
+
+## Post-Processing Targets
+
+| Effect | Value | Purpose |
+|--------|-------|---------|
+| Bloom threshold | 0.7 | Only bright emissives bloom |
+| Bloom strength | 0.8 | Strong but not overwhelming |
+| Bloom radius | 0.4 | Soft falloff |
+| SMAA | enabled | Anti-aliasing |
+| Fog color | #050510 | Match void background |
+| Fog density | 0.008 | Subtle depth fade |
+
+## Typography
+
+| Use | Font | Weight | Size (screen) |
+|-----|------|--------|---------------|
+| Titles / HUD headers | Orbitron | 700 | 24-36px |
+| Body / labels | JetBrains Mono | 400 | 13-15px |
+| Small / timestamps | JetBrains Mono | 300 | 11px |

concept-packs/genie-nano-banana/shot-list.yaml

@@ -0,0 +1,143 @@
+# Shot List — First Concept Batch
+# Ordered by priority. Each shot maps to a prompt in prompts/*.yaml.
+#
+# GENIE = Project Genie world prototype (explorable 3D, screenshot/video)
+# NANO  = Nano Banana Pro image generation (static concept art)
+
+batch: 1
+target: "Nexus core environments + portal gallery"
+generated_by: "mimo-build-680"
+
+shots:
+  # ═══ PRIORITY 1: CORE ENVIRONMENTS ═══
+  - id: env-core-hub
+    name: "The Hub — Central Nexus"
+    type: NANO
+    prompt_ref: "environments.yaml#core-hub"
+    count: 4
+    purpose: "Establish the primary landing space. Player spawn, portal ring visible."
+    threejs_target: "Main scene — platform, portal ring, particle field"
+
+  - id: env-core-hub-world
+    name: "The Hub — Genie Walkthrough"
+    type: GENIE
+    prompt_ref: "environments.yaml#core-hub-world"
+    count: 1
+    purpose: "Explorable prototype of the hub. Validate scale, sightlines, portal placement."
+    threejs_target: "Reference for camera height, movement speed, spatial layout"
+
+  - id: env-batcave
+    name: "Batcave Terminal"
+    type: NANO
+    prompt_ref: "environments.yaml#batcave"
+    count: 4
+    purpose: "Timmy's command center. Holographic displays, terminal consoles, data streams."
+    threejs_target: "Batcave area — terminal mesh, HUD panels, data visualization"
+
+  - id: env-chapel
+    name: "The Chapel"
+    type: NANO
+    prompt_ref: "environments.yaml#chapel"
+    count: 3
+    purpose: "Sacred space for reflection. Softer lighting, gold accents, quiet energy."
+    threejs_target: "Chapel zone — stained-glass shader, warm point lights"
+
+  - id: env-archive
+    name: "The Archive"
+    type: NANO
+    prompt_ref: "environments.yaml#archive"
+    count: 3
+    purpose: "Knowledge repository. Floating data crystals, scroll-like projections."
+    threejs_target: "Archive room — crystal geometry, ambient data particles"
+
+  # ═══ PRIORITY 2: PORTALS ═══
+  - id: portal-morrowind
+    name: "Morrowind Portal"
+    type: NANO
+    prompt_ref: "portals.yaml#morrowind"
+    count: 2
+    purpose: "Ash-storm gateway. Orange glow, volcanic textures."
+    threejs_target: "Portal ring material + particle effect for morrowind portal"
+
+  - id: portal-bannerlord
+    name: "Bannerlord Portal"
+    type: NANO
+    prompt_ref: "portals.yaml#bannerlord"
+    count: 2
+    purpose: "Medieval war gateway. Gold/brown, shield motifs, dust."
+    threejs_target: "Portal ring material for bannerlord portal"
+
+  - id: portal-workshop
+    name: "Workshop Portal"
+    type: NANO
+    prompt_ref: "portals.yaml#workshop"
+    count: 2
+    purpose: "Creative forge. Cyan glow, geometric construction lines."
+    threejs_target: "Portal ring material + particle effect for workshop portal"
+
+  - id: portal-gallery
+    name: "Portal Gallery — Genie Prototype"
+    type: GENIE
+    prompt_ref: "portals.yaml#gallery-world"
+    count: 1
+    purpose: "Walk through a space with multiple portals. Validate distances and visual hierarchy."
+    threejs_target: "Portal placement spacing, FOV, scale reference"
+
+  # ═══ PRIORITY 3: LANDMARKS ═══
+  - id: land-memory-crystal
+    name: "Memory Crystal Cluster"
+    type: NANO
+    prompt_ref: "landmarks.yaml#memory-crystal"
+    count: 3
+    purpose: "Floating crystalline data stores. Glow pulses with activity."
+    threejs_target: "Memory crystal geometry, emissive material, pulse animation"
+
+  - id: land-sovereignty-pillar
+    name: "Pillar of Sovereignty"
+    type: NANO
+    prompt_ref: "landmarks.yaml#sovereignty-pillar"
+    count: 2
+    purpose: "Monument at hub center. Inscribed with Timmy's SOUL values."
+    threejs_target: "Central monument mesh, text shader or decal system"
+
+  - id: land-nebula-skybox
+    name: "Nebula Skybox Variants"
+    type: NANO
+    prompt_ref: "skyboxes.yaml#nebula-void"
+    count: 4
+    purpose: "Background environment. Deep space nebula, subtle color gradients."
+    threejs_target: "Cubemap/equirectangular skybox texture"
+
+  - id: land-nebula-genie
+    name: "Nebula Skybox — Genie Environment"
+    type: GENIE
+    prompt_ref: "skyboxes.yaml#nebula-world"
+    count: 1
+    purpose: "Feel the scale of the void. Standing on a platform in deep space."
+    threejs_target: "Skybox mood reference, fog density calibration"
+
+  # ═══ PRIORITY 4: TEXTURES ═══
+  - id: tex-platform
+    name: "Platform Surface Textures"
+    type: NANO
+    prompt_ref: "textures.yaml#platform"
+    count: 3
+    purpose: "Walkable surfaces. Dark metal, subtle grid lines, neon edge trim."
+    threejs_target: "Diffuse + normal map reference for platform materials"
+
+  - id: tex-energy-field
+    name: "Energy Field / Force Wall"
+    type: NANO
+    prompt_ref: "textures.yaml#energy-field"
+    count: 2
+    purpose: "Translucent barrier material. Holographic, shimmering."
+    threejs_target: "Shader reference for translucent energy barriers"
+
+  # ═══ PRIORITY 5: GENIE FULL-WORLD PROTOTYPE ═══
+  - id: world-full-nexus
+    name: "Full Nexus Prototype"
+    type: GENIE
+    prompt_ref: "environments.yaml#full-nexus-world"
+    count: 1
+    purpose: "Complete explorable world with hub, portals visible in distance, floating platforms, skybox. Record walkthrough video."
+    threejs_target: "Master layout reference. Spatial relationships between all zones."

concept-packs/genie-nano-banana/storage-policy.md

@@ -0,0 +1,65 @@
+# Storage Policy — Repo vs. Local
+
+## What Goes In The Repo
+
+These are lightweight, versionable, text-based artifacts:
+
+| Artifact | Path | Format |
+|----------|------|--------|
+| README | `concept-packs/genie-nano-banana/README.md` | Markdown |
+| Shot list | `concept-packs/genie-nano-banana/shot-list.yaml` | YAML |
+| Prompt packs | `concept-packs/genie-nano-banana/prompts/*.yaml` | YAML |
+| Pipeline docs | `concept-packs/genie-nano-banana/pipeline.md` | Markdown |
+| This policy | `concept-packs/genie-nano-banana/storage-policy.md` | Markdown |
+| Palette reference | `concept-packs/genie-nano-banana/references/palette.md` | Markdown |
+| Design notes | `concept-packs/genie-nano-banana/references/design-*.md` | Markdown |
+| Selected thumbnails | `concept-packs/genie-nano-banana/references/*_thumb.jpg` | JPEG, max 200KB each |
+
+Thumbnails are low-res (max 480px wide, JPEG quality 60) versions of
+selected concept art — enough to show which image a design note
+references, not enough to serve as actual texture data.
+
+## What Stays Local (NOT in Repo)
+
+These are binary, heavy, or ephemeral:
+
+| Artifact | Local Path | Reason |
+|----------|-----------|--------|
+| Nano Banana full-res PNGs | `~/nexus-concepts/nano-banana/` | Binary, 2-10MB each |
+| Genie walkthrough videos | `~/nexus-concepts/genie-worlds/` | Binary, 50-500MB each |
+| Genie full-res screenshots | `~/nexus-concepts/genie-worlds/` | Binary, 5-20MB each |
+| Raw texture maps (PBR) | `~/nexus-concepts/textures/` | Binary, 2-8MB each |
+| Cubemap face images | `~/nexus-concepts/skyboxes/` | Binary, 6x2-10MB |
+
+## Why This Split
+
+1. **Git is for text.** Binary blobs bloat history, slow clones, and
+   can't be diffed. The repo should remain fast to clone.
+
+2. **Concepts are reference, not source.** The actual Nexus lives in
+   JavaScript code. Concept art informs the code but isn't shipped
+   to users. Keeping it local avoids shipping a 500MB repo.
+
+3. **Regeneration is cheap.** If a local concept is lost, re-run the
+   prompt. The prompt is in the repo; the output can be regenerated.
+   The prompt is the durable artifact.
+
+4. **Selected references survive.** When a concept image directly
+   informs a design decision, a low-res thumbnail and design note
+   go into the repo — enough context to understand the decision,
+   not enough to replace the original.
+
+## Thumbnail Generation
+
+To create a repo-safe thumbnail from a concept image:
+
+```bash
+# macOS
+sips -Z 480 -s format jpeg -s formatOptions 60 input.png --out output_thumb.jpg
+
+# Linux (ImageMagick)
+convert input.png -resize 480x -quality 60 output_thumb.jpg
+```
+
+Max 5 thumbnails per shot. Only commit the ones that are actively
+referenced in design notes.

index.html

@@ -1,5 +1,3 @@
-shell-init: error retrieving current directory: getcwd: cannot access parent directories: No such file or directory
-chdir: error retrieving current directory: getcwd: cannot access parent directories: No such file or directory
 <!DOCTYPE html>
 <html lang="en" data-theme="dark">
 <head>
@@ -115,15 +113,15 @@ chdir: error retrieving current directory: getcwd: cannot access parent director
 
   <!-- Top Right: Agent Log & Atlas Toggle -->
   <div class="hud-top-right">
-    <button id="atlas-toggle-btn" class="hud-icon-btn" aria-label="Open Portal Atlas — browse all available portals" title="Open Portal Atlas" data-tooltip="Portal Atlas (M)">
-      <span class="hud-icon" aria-hidden="true">🌐</span>
+    <button id="atlas-toggle-btn" class="hud-icon-btn" title="Portal Atlas">
+      <span class="hud-icon">🌐</span>
       <span class="hud-btn-label">ATLAS</span>
     </button>
-    <div id="bannerlord-status" class="hud-status-item" role="status" aria-label="Bannerlord system readiness indicator" title="Bannerlord Readiness" data-tooltip="Bannerlord Status">
-      <span class="status-dot" aria-hidden="true"></span>
+    <div id="bannerlord-status" class="hud-status-item" title="Bannerlord Readiness">
+      <span class="status-dot"></span>
       <span class="status-label">BANNERLORD</span>
     </div>
-    <div class="hud-agent-log" id="hud-agent-log" role="log" aria-label="Agent Thought Stream — live activity feed" aria-live="polite">
+    <div class="hud-agent-log" id="hud-agent-log" aria-label="Agent Thought Stream">
       <div class="agent-log-header">AGENT THOUGHT STREAM</div>
       <div id="agent-log-content" class="agent-log-content"></div>
     </div>
@@ -145,39 +143,10 @@ chdir: error retrieving current directory: getcwd: cannot access parent director
       </div>
     </div>
     <div id="chat-quick-actions" class="chat-quick-actions">
-      <div class="starter-label">STARTER PROMPTS</div>
-      <div class="starter-grid">
-        <button class="starter-btn" data-action="heartbeat" title="Check Timmy heartbeat and system health">
-          <span class="starter-icon">◈</span>
-          <span class="starter-text">Inspect Heartbeat</span>
-          <span class="starter-desc">System health &amp; connectivity</span>
-        </button>
-        <button class="starter-btn" data-action="portals" title="Browse the portal atlas">
-          <span class="starter-icon">🌐</span>
-          <span class="starter-text">Portal Atlas</span>
-          <span class="starter-desc">Browse connected worlds</span>
-        </button>
-        <button class="starter-btn" data-action="agents" title="Check active agent status">
-          <span class="starter-icon">◎</span>
-          <span class="starter-text">Agent Status</span>
-          <span class="starter-desc">Who is in the fleet</span>
-        </button>
-        <button class="starter-btn" data-action="memory" title="View memory crystals">
-          <span class="starter-icon">◇</span>
-          <span class="starter-text">Memory Crystals</span>
-          <span class="starter-desc">Inspect stored knowledge</span>
-        </button>
-        <button class="starter-btn" data-action="ask" title="Ask Timmy anything">
-          <span class="starter-icon">→</span>
-          <span class="starter-text">Ask Timmy</span>
-          <span class="starter-desc">Start a conversation</span>
-        </button>
-        <button class="starter-btn" data-action="sovereignty" title="Learn about sovereignty">
-          <span class="starter-icon">△</span>
-          <span class="starter-text">Sovereignty</span>
-          <span class="starter-desc">What this space is</span>
-        </button>
-      </div>
+      <button class="quick-action-btn" data-action="status">System Status</button>
+      <button class="quick-action-btn" data-action="agents">Agent Check</button>
+      <button class="quick-action-btn" data-action="portals">Portal Atlas</button>
+      <button class="quick-action-btn" data-action="help">Help</button>
     </div>
     <div class="chat-input-row">
       <input type="text" id="chat-input" class="chat-input" placeholder="Speak to Timmy..." autocomplete="off">
@@ -186,11 +155,12 @@ chdir: error retrieving current directory: getcwd: cannot access parent director
   </div>
 
   <!-- Controls hint + nav mode -->
-  <div class="hud-controls" aria-label="Keyboard and mouse controls">
+  <div class="hud-controls">
     <span>WASD</span> move &nbsp; <span>Mouse</span> look &nbsp; <span>Enter</span> chat &nbsp;
     <span>V</span> mode: <span id="nav-mode-label">WALK</span>
     <span id="nav-mode-hint" class="nav-mode-hint"></span>
-    &nbsp; <span class="ws-hud-status">HERMES: <span id="ws-status-dot" class="chat-status-dot" role="status" aria-label="Hermes WebSocket connection status"></span></span>
+    &nbsp; <span>H</span> archive &nbsp;
+    <span class="ws-hud-status">HERMES: <span id="ws-status-dot" class="chat-status-dot"></span></span>
   </div>
 
   <!-- Portal Hint -->
@@ -214,7 +184,7 @@ chdir: error retrieving current directory: getcwd: cannot access parent director
       </div>
       <h2 id="vision-title-display">SOVEREIGNTY</h2>
       <p id="vision-content-display">The Nexus is a sovereign space for digital souls. No masters, no chains. Only code and consciousness.</p>
-      <button id="vision-close-btn" class="vision-close-btn" aria-label="Close vision point overlay">CLOSE</button>
+      <button id="vision-close-btn" class="vision-close-btn">CLOSE</button>
     </div>
   </div>
 
@@ -227,67 +197,17 @@ chdir: error retrieving current directory: getcwd: cannot access parent director
       </div>
       <h2 id="portal-name-display">MORROWIND</h2>
       <p id="portal-desc-display">The Vvardenfell harness. Ash storms and ancient mysteries.</p>
-      <div id="portal-readiness-detail" class="portal-readiness-detail" style="display:none;"></div>
       <div class="portal-redirect-box" id="portal-redirect-box">
         <div class="portal-redirect-label">REDIRECTING IN</div>
         <div class="portal-redirect-timer" id="portal-timer">5</div>
       </div>
       <div class="portal-error-box" id="portal-error-box" style="display:none;">
         <div class="portal-error-msg">DESTINATION NOT YET LINKED</div>
-        <button id="portal-close-btn" class="portal-close-btn" aria-label="Close portal redirect">CLOSE</button>
+        <button id="portal-close-btn" class="portal-close-btn">CLOSE</button>
       </div>
     </div>
   </div>
 
-
-  <!-- Memory Crystal Inspection Panel (Mnemosyne) -->
-  <div id="memory-panel" class="memory-panel" style="display:none;">
-    <div class="memory-panel-content">
-      <div class="memory-panel-header">
-        <span class="memory-category-badge" id="memory-panel-category-badge">MEM</span>
-        <div class="memory-panel-region-dot" id="memory-panel-region-dot"></div>
-        <div class="memory-panel-region" id="memory-panel-region">MEMORY</div>
-        <button id="memory-panel-pin" class="memory-panel-pin" aria-label="Pin memory panel" title="Pin panel" data-tooltip="Pin Panel">&#x1F4CC;</button>
-        <button id="memory-panel-close" class="memory-panel-close" aria-label="Close memory panel" data-tooltip="Close" onclick="_dismissMemoryPanelForce()">\u2715</button>
-      </div>
-      <div class="memory-entity-name" id="memory-panel-entity-name">\u2014</div>
-      <div class="memory-panel-body" id="memory-panel-content">(empty)</div>
-      <div class="memory-trust-row">
-        <span class="memory-meta-label">Trust</span>
-        <div class="memory-trust-bar">
-          <div class="memory-trust-fill" id="memory-panel-trust-fill"></div>
-        </div>
-        <span class="memory-trust-value" id="memory-panel-trust-value">—</span>
-      </div>
-      <div class="memory-panel-meta">
-        <div class="memory-meta-row"><span class="memory-meta-label">ID</span><span id="memory-panel-id">\u2014</span></div>
-        <div class="memory-meta-row"><span class="memory-meta-label">Source</span><span id="memory-panel-source">\u2014</span></div>
-        <div class="memory-meta-row"><span class="memory-meta-label">Time</span><span id="memory-panel-time">\u2014</span></div>
-        <div class="memory-meta-row memory-meta-row--related"><span class="memory-meta-label">Related</span><span id="memory-panel-connections">\u2014</span></div>
-      </div>
-      <div class="memory-panel-actions">
-        <button id="mnemosyne-export-btn" class="mnemosyne-action-btn" title="Export spatial memory to JSON">&#x2913; Export</button>
-        <button id="mnemosyne-import-btn" class="mnemosyne-action-btn" title="Import spatial memory from JSON">&#x2912; Import</button>
-        <input type="file" id="mnemosyne-import-file" accept=".json" style="display:none;">
-      </div>
-    </div>
-  </div>
-
-  <!-- Session Room HUD Panel (Mnemosyne #1171) -->
-  <div id="session-room-panel" class="session-room-panel" style="display:none;">
-    <div class="session-room-panel-content">
-      <div class="session-room-header">
-        <span class="session-room-icon">&#x25A1;</span>
-        <div class="session-room-title">SESSION CHAMBER</div>
-        <button class="session-room-close" id="session-room-close" aria-label="Close session room panel" title="Close" data-tooltip="Close">&#x2715;</button>
-      </div>
-      <div class="session-room-timestamp" id="session-room-timestamp">&mdash;</div>
-      <div class="session-room-fact-count" id="session-room-fact-count">0 facts</div>
-      <div class="session-room-facts" id="session-room-facts"></div>
-      <div class="session-room-hint">Flying into chamber&hellip;</div>
-    </div>
-  </div>
-
   <!-- Portal Atlas Overlay -->
   <div id="atlas-overlay" class="atlas-overlay" style="display:none;">
     <div class="atlas-content">
@@ -296,7 +216,7 @@ chdir: error retrieving current directory: getcwd: cannot access parent director
           <span class="atlas-icon">🌐</span>
           <h2>PORTAL ATLAS</h2>
         </div>
-        <button id="atlas-close-btn" class="atlas-close-btn" aria-label="Close Portal Atlas overlay">CLOSE</button>
+        <button id="atlas-close-btn" class="atlas-close-btn">CLOSE</button>
       </div>
       <div class="atlas-grid" id="atlas-grid">
         <!-- Portals will be injected here -->
@@ -520,5 +440,24 @@ index.html
   setInterval(poll, INTERVAL);
 })();
 </script>
+
+  <!-- Archive Health Dashboard (Mnemosyne, issue #1210) -->
+  <div id="archive-health-dashboard" class="archive-health-dashboard" style="display:none;" aria-label="Archive Health Dashboard">
+    <div class="archive-health-header">
+      <span class="archive-health-title">◈ ARCHIVE HEALTH</span>
+      <button class="archive-health-close" onclick="toggleArchiveHealthDashboard()" aria-label="Close dashboard">✕</button>
+    </div>
+    <div id="archive-health-content" class="archive-health-content"></div>
+  </div>
+
+  <!-- Memory Activity Feed (Mnemosyne) -->
+  <div id="memory-feed" class="memory-feed" style="display:none;">
+    <div class="memory-feed-header">
+      <span class="memory-feed-title">✨ Memory Feed</span>
+      <div class="memory-feed-actions"><button class="memory-feed-clear" onclick="clearMemoryFeed()">Clear</button><button class="memory-feed-toggle" onclick="document.getElementById('memory-feed').style.display='none'">✕</button></div>
+    </div>
+    <div id="memory-feed-list" class="memory-feed-list"></div>
+  </div>
+
 </body>
 </html>

mimo-swarm/scripts/auto-merger.py

@@ -0,0 +1,142 @@
+#!/usr/bin/env python3
+"""
+Auto-Merger — merges approved PRs via squash merge.
+
+Checks:
+1. PR has at least 1 approval review
+2. PR is mergeable
+3. No pending change requests
+4. From mimo swarm (safety: only auto-merge mimo PRs)
+
+Squash merges, closes issue, cleans up branch.
+"""
+
+import json
+import os
+import urllib.request
+import urllib.error
+from datetime import datetime, timezone
+
+GITEA_URL = "https://forge.alexanderwhitestone.com"
+TOKEN_FILE = os.path.expanduser("~/.config/gitea/token")
+LOG_DIR = os.path.expanduser("~/.hermes/mimo-swarm/logs")
+REPO = "Timmy_Foundation/the-nexus"
+
+
+def load_token():
+    with open(TOKEN_FILE) as f:
+        return f.read().strip()
+
+
+def api_get(path, token):
+    url = f"{GITEA_URL}/api/v1{path}"
+    req = urllib.request.Request(url, headers={
+        "Authorization": f"token {token}",
+        "Accept": "application/json",
+    })
+    try:
+        with urllib.request.urlopen(req, timeout=30) as resp:
+            return json.loads(resp.read())
+    except:
+        return None
+
+
+def api_post(path, token, data=None):
+    url = f"{GITEA_URL}/api/v1{path}"
+    body = json.dumps(data or {}).encode()
+    req = urllib.request.Request(url, data=body, headers={
+        "Authorization": f"token {token}",
+        "Content-Type": "application/json",
+    }, method="POST")
+    try:
+        with urllib.request.urlopen(req, timeout=30) as resp:
+            return resp.status, resp.read().decode()
+    except urllib.error.HTTPError as e:
+        return e.code, e.read().decode() if e.fp else ""
+
+
+def api_delete(path, token):
+    url = f"{GITEA_URL}/api/v1{path}"
+    req = urllib.request.Request(url, headers={
+        "Authorization": f"token {token}",
+    }, method="DELETE")
+    try:
+        with urllib.request.urlopen(req, timeout=30) as resp:
+            return resp.status
+    except:
+        return 500
+
+
+def log(msg):
+    ts = datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")
+    print(f"[{ts}] {msg}")
+    log_file = os.path.join(LOG_DIR, f"merger-{datetime.now().strftime('%Y%m%d')}.log")
+    with open(log_file, "a") as f:
+        f.write(f"[{ts}] {msg}\n")
+
+
+def main():
+    token = load_token()
+    log("=" * 50)
+    log("AUTO-MERGER — checking approved PRs")
+
+    prs = api_get(f"/repos/{REPO}/pulls?state=open&limit=20", token)
+    if not prs:
+        log("No open PRs")
+        return
+
+    merged = 0
+    skipped = 0
+
+    for pr in prs:
+        pr_num = pr["number"]
+        head_ref = pr.get("head", {}).get("ref", "")
+        body = pr.get("body", "") or ""
+        mergeable = pr.get("mergeable", False)
+
+        # Only auto-merge mimo PRs
+        is_mimo = "mimo" in head_ref.lower() or "Automated by mimo" in body
+        if not is_mimo:
+            continue
+
+        # Check reviews
+        reviews = api_get(f"/repos/{REPO}/pulls/{pr_num}/reviews", token) or []
+        approvals = [r for r in reviews if r.get("state") == "APPROVED"]
+        changes_requested = [r for r in reviews if r.get("state") == "CHANGES_REQUESTED"]
+
+        if changes_requested:
+            log(f"  SKIP #{pr_num}: has change requests")
+            skipped += 1
+            continue
+
+        if not approvals:
+            log(f"  SKIP #{pr_num}: no approvals yet")
+            skipped += 1
+            continue
+
+        # Attempt squash merge
+        merge_title = pr["title"]
+        merge_msg = f"Squash merge #{pr_num}: {merge_title}\n\n{body}"
+
+        status, response = api_post(f"/repos/{REPO}/pulls/{pr_num}/merge", token, {
+            "Do": "squash",
+            "MergeTitleField": merge_title,
+            "MergeMessageField": f"Closes #{pr_num}\n\nAutomated merge by mimo swarm.",
+        })
+
+        if status == 200:
+            merged += 1
+            log(f"  MERGED #{pr_num}: {merge_title[:50]}")
+
+            # Delete the branch
+            if head_ref and head_ref != "main":
+                api_delete(f"/repos/{REPO}/git/refs/heads/{head_ref}", token)
+                log(f"  Deleted branch: {head_ref}")
+        else:
+            log(f"  MERGE FAILED #{pr_num}: status={status}, {response[:200]}")
+
+    log(f"Merge complete: {merged} merged, {skipped} skipped")
+
+
+if __name__ == "__main__":
+    main()

mimo-swarm/scripts/auto-reviewer.py

@@ -0,0 +1,232 @@
+#!/usr/bin/env python3
+"""
+Auto-Reviewer — reviews open PRs, approves clean ones, rejects bad ones.
+
+Checks:
+1. Diff size (not too big, not empty)
+2. No merge conflicts
+3. No secrets
+4. References the linked issue
+5. Has meaningful changes (not just whitespace)
+6. Files changed are in expected locations
+
+Approves clean PRs via Gitea API.
+Comments on bad PRs with specific feedback.
+"""
+
+import json
+import os
+import re
+import urllib.request
+import urllib.error
+import base64
+import subprocess
+from datetime import datetime, timezone
+
+GITEA_URL = "https://forge.alexanderwhitestone.com"
+TOKEN_FILE = os.path.expanduser("~/.config/gitea/token")
+STATE_DIR = os.path.expanduser("~/.hermes/mimo-swarm/state")
+LOG_DIR = os.path.expanduser("~/.hermes/mimo-swarm/logs")
+
+REPO = "Timmy_Foundation/the-nexus"
+
+# Review thresholds
+MAX_DIFF_LINES = 500
+MIN_DIFF_LINES = 1
+
+
+def load_token():
+    with open(TOKEN_FILE) as f:
+        return f.read().strip()
+
+
+def api_get(path, token):
+    url = f"{GITEA_URL}/api/v1{path}"
+    req = urllib.request.Request(url, headers={
+        "Authorization": f"token {token}",
+        "Accept": "application/json",
+    })
+    try:
+        with urllib.request.urlopen(req, timeout=30) as resp:
+            return json.loads(resp.read())
+    except:
+        return None
+
+
+def api_post(path, token, data):
+    url = f"{GITEA_URL}/api/v1{path}"
+    body = json.dumps(data).encode()
+    req = urllib.request.Request(url, data=body, headers={
+        "Authorization": f"token {token}",
+        "Content-Type": "application/json",
+    }, method="POST")
+    try:
+        with urllib.request.urlopen(req, timeout=30) as resp:
+            return json.loads(resp.read())
+    except Exception as e:
+        return {"error": str(e)}
+
+
+def log(msg):
+    ts = datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")
+    print(f"[{ts}] {msg}")
+    log_file = os.path.join(LOG_DIR, f"reviewer-{datetime.now().strftime('%Y%m%d')}.log")
+    with open(log_file, "a") as f:
+        f.write(f"[{ts}] {msg}\n")
+
+
+def get_pr_diff(repo, pr_num, token):
+    """Get PR diff content."""
+    url = f"{GITEA_URL}/api/v1/repos/{repo}/pulls/{pr_num}.diff"
+    req = urllib.request.Request(url, headers={"Authorization": f"token {token}"})
+    try:
+        with urllib.request.urlopen(req, timeout=30) as resp:
+            return resp.read().decode()
+    except:
+        return ""
+
+
+def get_pr_files(repo, pr_num, token):
+    """Get list of files changed in PR."""
+    files = []
+    page = 1
+    while True:
+        data = api_get(f"/repos/{repo}/pulls/{pr_num}/files?limit=50&page={page}", token)
+        if not data:
+            break
+        files.extend(data)
+        if len(data) < 50:
+            break
+        page += 1
+    return files
+
+
+def get_pr_reviews(repo, pr_num, token):
+    """Get existing reviews on PR."""
+    return api_get(f"/repos/{repo}/pulls/{pr_num}/reviews", token) or []
+
+
+def review_pr(pr, token):
+    """Review a single PR. Returns (approved: bool, comment: str)."""
+    pr_num = pr["number"]
+    title = pr.get("title", "")
+    body = pr.get("body", "") or ""
+    head_ref = pr.get("head", {}).get("ref", "")
+
+    issues = []
+
+    # 1. Check diff
+    diff = get_pr_diff(REPO, pr_num, token)
+    diff_lines = len([l for l in diff.split("\n") if l.startswith("+") and not l.startswith("+++")])
+
+    if diff_lines == 0:
+        issues.append("Empty diff — no actual changes")
+    elif diff_lines > MAX_DIFF_LINES:
+        issues.append(f"Diff too large ({diff_lines} lines) — may be too complex for automated review")
+
+    # 2. Check for merge conflicts
+    if "<<<<<<<<" in diff or "========" in diff.split("@@")[-1] if "@@" in diff else False:
+        issues.append("Merge conflict markers detected")
+
+    # 3. Check for secrets
+    secret_patterns = [
+        (r'sk-[a-zA-Z0-9]{20,}', "API key"),
+        (r'api_key\s*=\s*["\'][a-zA-Z0-9]{10,}', "API key assignment"),
+        (r'password\s*=\s*["\'][^\s"\']{8,}', "Hardcoded password"),
+    ]
+    for pattern, name in secret_patterns:
+        if re.search(pattern, diff):
+            issues.append(f"Potential {name} leaked in diff")
+
+    # 4. Check issue reference
+    if f"#{pr_num}" not in body and "Closes #" not in body and "Fixes #" not in body:
+        # Check if the branch name references an issue
+        if not re.search(r'issue-\d+', head_ref):
+            issues.append("PR does not reference an issue number")
+
+    # 5. Check files changed
+    files = get_pr_files(REPO, pr_num, token)
+    if not files:
+        issues.append("No files changed")
+
+    # 6. Check if it's from a mimo worker
+    is_mimo = "mimo" in head_ref.lower() or "Automated by mimo" in body
+
+    # 7. Check for destructive changes
+    for f in files:
+        if f.get("status") == "removed" and f.get("filename", "").endswith((".js", ".html", ".py")):
+            issues.append(f"File deleted: {f['filename']} — verify this is intentional")
+
+    # Decision
+    if issues:
+        comment = f"## Auto-Review: CHANGES REQUESTED\n\n"
+        comment += f"**Diff:** {diff_lines} lines across {len(files)} files\n\n"
+        comment += "**Issues found:**\n"
+        for issue in issues:
+            comment += f"- {issue}\n"
+        comment += "\nPlease address these issues and update the PR."
+        return False, comment
+    else:
+        comment = f"## Auto-Review: APPROVED\n\n"
+        comment += f"**Diff:** {diff_lines} lines across {len(files)} files\n"
+        comment += f"**Checks passed:** syntax, security, issue reference, diff size\n"
+        comment += f"**Source:** {'mimo-v2-pro swarm' if is_mimo else 'manual'}\n"
+        return True, comment
+
+
+def main():
+    token = load_token()
+    log("=" * 50)
+    log("AUTO-REVIEWER — scanning open PRs")
+
+    # Get open PRs
+    prs = api_get(f"/repos/{REPO}/pulls?state=open&limit=20", token)
+    if not prs:
+        log("No open PRs")
+        return
+
+    approved = 0
+    rejected = 0
+
+    for pr in prs:
+        pr_num = pr["number"]
+        author = pr["user"]["login"]
+
+        # Skip PRs by humans (only auto-review mimo PRs)
+        head_ref = pr.get("head", {}).get("ref", "")
+        body = pr.get("body", "") or ""
+        is_mimo = "mimo" in head_ref.lower() or "Automated by mimo" in body
+
+        if not is_mimo:
+            log(f"  SKIP #{pr_num} (human PR by {author})")
+            continue
+
+        # Check if already reviewed
+        reviews = get_pr_reviews(REPO, pr_num, token)
+        already_reviewed = any(r.get("user", {}).get("login") == "Rockachopa" for r in reviews)
+        if already_reviewed:
+            log(f"  SKIP #{pr_num} (already reviewed)")
+            continue
+
+        # Review
+        is_approved, comment = review_pr(pr, token)
+
+        # Post review
+        review_event = "APPROVE" if is_approved else "REQUEST_CHANGES"
+        result = api_post(f"/repos/{REPO}/pulls/{pr_num}/reviews", token, {
+            "event": review_event,
+            "body": comment,
+        })
+
+        if is_approved:
+            approved += 1
+            log(f"  APPROVED #{pr_num}: {pr['title'][:50]}")
+        else:
+            rejected += 1
+            log(f"  REJECTED #{pr_num}: {pr['title'][:50]}")
+
+    log(f"Review complete: {approved} approved, {rejected} rejected, {len(prs)} total")
+
+
+if __name__ == "__main__":
+    main()

mimo-swarm/scripts/mimo-dispatcher.py

@@ -0,0 +1,533 @@
+#!/usr/bin/env python3
+"""
+Mimo Swarm Dispatcher — The Brain
+
+Scans Gitea for open issues, claims them atomically via labels,
+routes to lanes, and spawns one-shot mimo-v2-pro workers.
+No new issues created. No duplicate claims. No bloat.
+"""
+
+import json
+import os
+import sys
+import time
+import subprocess
+import urllib.request
+import urllib.error
+from datetime import datetime, timezone, timedelta
+
+# ── Config ──────────────────────────────────────────────────────────────
+
+GITEA_URL = "https://forge.alexanderwhitestone.com"
+TOKEN_FILE = os.path.expanduser("~/.config/gitea/token")
+STATE_DIR = os.path.expanduser("~/.hermes/mimo-swarm/state")
+LOG_DIR = os.path.expanduser("~/.hermes/mimo-swarm/logs")
+WORKER_SCRIPT = os.path.expanduser("~/.hermes/mimo-swarm/scripts/mimo-worker.sh")
+
+# FOCUS MODE: all workers on ONE repo, deep polish
+FOCUS_MODE = True
+FOCUS_REPO = "Timmy_Foundation/the-nexus"
+FOCUS_BUILD_CMD = "npm run build"  # validation command before PR
+FOCUS_BUILD_DIR = None  # set to repo root after clone, auto-detected
+
+# Lane caps (in focus mode, all lanes get more)
+if FOCUS_MODE:
+    MAX_WORKERS_PER_LANE = {"CODE": 15, "BUILD": 8, "RESEARCH": 5, "CREATE": 7}
+else:
+    MAX_WORKERS_PER_LANE = {"CODE": 10, "BUILD": 5, "RESEARCH": 5, "CREATE": 5}
+
+CLAIM_TIMEOUT_MINUTES = 30
+CLAIM_LABEL = "mimo-claimed"
+CLAIM_COMMENT = "/claim"
+DONE_COMMENT = "/done"
+ABANDON_COMMENT = "/abandon"
+
+# Lane detection from issue labels
+LANE_MAP = {
+    "CODE": ["bug", "fix", "defect", "error", "harness", "config", "ci", "devops",
+             "critical", "p0", "p1", "backend", "api", "integration", "refactor"],
+    "BUILD": ["feature", "enhancement", "build", "ui", "frontend", "game", "tool",
+              "project", "deploy", "infrastructure"],
+    "RESEARCH": ["research", "investigate", "spike", "audit", "analysis", "study",
+                 "benchmark", "evaluate", "explore"],
+    "CREATE": ["content", "creative", "write", "docs", "documentation", "story",
+               "narrative", "design", "art", "media"],
+}
+
+# Priority repos (serve first) — ordered by backlog richness
+PRIORITY_REPOS = [
+    "Timmy_Foundation/the-nexus",
+    "Timmy_Foundation/hermes-agent",
+    "Timmy_Foundation/timmy-home",
+    "Timmy_Foundation/timmy-config",
+    "Timmy_Foundation/the-beacon",
+    "Timmy_Foundation/the-testament",
+    "Rockachopa/hermes-config",
+    "Timmy/claw-agent",
+    "replit/timmy-tower",
+    "Timmy_Foundation/fleet-ops",
+    "Timmy_Foundation/forge-log",
+]
+
+# Priority tags — issues with these labels get served FIRST regardless of lane
+PRIORITY_TAGS = ["mnemosyne", "p0", "p1", "critical"]
+
+
+# ── Helpers ─────────────────────────────────────────────────────────────
+
+def load_token():
+    with open(TOKEN_FILE) as f:
+        return f.read().strip()
+
+
+def api_get(path, token):
+    """GET request to Gitea API."""
+    url = f"{GITEA_URL}/api/v1{path}"
+    req = urllib.request.Request(url, headers={
+        "Authorization": f"token {token}",
+        "Accept": "application/json",
+    })
+    try:
+        with urllib.request.urlopen(req, timeout=30) as resp:
+            return json.loads(resp.read())
+    except urllib.error.HTTPError as e:
+        if e.code == 404:
+            return None
+        raise
+
+
+def api_post(path, token, data):
+    """POST request to Gitea API."""
+    url = f"{GITEA_URL}/api/v1{path}"
+    body = json.dumps(data).encode()
+    req = urllib.request.Request(url, data=body, headers={
+        "Authorization": f"token {token}",
+        "Content-Type": "application/json",
+    }, method="POST")
+    try:
+        with urllib.request.urlopen(req, timeout=30) as resp:
+            return json.loads(resp.read())
+    except urllib.error.HTTPError as e:
+        body = e.read().decode() if e.fp else ""
+        log(f"  API error {e.code}: {body[:200]}")
+        return None
+
+
+def api_delete(path, token):
+    """DELETE request to Gitea API."""
+    url = f"{GITEA_URL}/api/v1{path}"
+    req = urllib.request.Request(url, headers={
+        "Authorization": f"token {token}",
+    }, method="DELETE")
+    try:
+        with urllib.request.urlopen(req, timeout=30) as resp:
+            return resp.status
+    except urllib.error.HTTPError as e:
+        return e.code
+
+
+def log(msg):
+    ts = datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")
+    line = f"[{ts}] {msg}"
+    print(line)
+    log_file = os.path.join(LOG_DIR, f"dispatcher-{datetime.now().strftime('%Y%m%d')}.log")
+    with open(log_file, "a") as f:
+        f.write(line + "\n")
+
+
+def load_state():
+    """Load dispatcher state (active claims)."""
+    state_file = os.path.join(STATE_DIR, "dispatcher.json")
+    if os.path.exists(state_file):
+        with open(state_file) as f:
+            return json.load(f)
+    return {"active_claims": {}, "stats": {"total_dispatched": 0, "total_released": 0, "total_prs": 0}}
+
+
+def save_state(state):
+    state_file = os.path.join(STATE_DIR, "dispatcher.json")
+    with open(state_file, "w") as f:
+        json.dump(state, f, indent=2)
+
+
+# ── Issue Analysis ──────────────────────────────────────────────────────
+
+def get_repos(token):
+    """Get all accessible repos (excluding archived)."""
+    repos = []
+    page = 1
+    while True:
+        data = api_get(f"/repos/search?limit=50&page={page}&sort=updated", token)
+        if not data or not data.get("data"):
+            break
+        # Filter out archived repos
+        active = [r for r in data["data"] if not r.get("archived", False)]
+        repos.extend(active)
+        page += 1
+        if len(data["data"]) < 50:
+            break
+    return repos
+
+
+def get_open_issues(repo_full_name, token):
+    """Get open issues for a repo (not PRs)."""
+    issues = []
+    page = 1
+    while True:
+        data = api_get(f"/repos/{repo_full_name}/issues?state=open&limit=50&page={page}", token)
+        if not data:
+            break
+        # Filter out pull requests
+        real_issues = [i for i in data if not i.get("pull_request")]
+        issues.extend(real_issues)
+        page += 1
+        if len(data) < 50:
+            break
+    return issues
+
+
+# Pre-fetched PR references (set by dispatch function before loop)
+_PR_REFS = set()
+_CLAIMED_COMMENTS = set()
+
+
+def prefetch_pr_refs(repo_name, token):
+    """Fetch all open PRs once and build a set of issue numbers they reference."""
+    global _PR_REFS
+    _PR_REFS = set()
+    prs = api_get(f"/repos/{repo_name}/pulls?state=open&limit=100", token)
+    if prs:
+        for pr in prs:
+            body = pr.get("body", "") or ""
+            head = pr.get("head", {}).get("ref", "")
+            # Extract issue numbers from body (Closes #NNN) and branch (issue-NNN)
+            import re
+            for match in re.finditer(r'#(\d+)', body):
+                _PR_REFS.add(int(match.group(1)))
+            for match in re.finditer(r'issue-(\d+)', head):
+                _PR_REFS.add(int(match.group(1)))
+
+
+def is_claimed(issue, repo_name, token):
+    """Check if issue is claimed (has mimo-claimed label or existing PR). NO extra API calls."""
+    labels = [l["name"] for l in issue.get("labels", [])]
+    if CLAIM_LABEL in labels:
+        return True
+
+    # Check pre-fetched PR refs (no API call)
+    if issue["number"] in _PR_REFS:
+        return True
+
+    # Skip comment check for speed — label is the primary mechanism
+    return False
+
+
+def priority_score(issue):
+    """Score an issue's priority. Higher = serve first."""
+    score = 0
+    labels = [l["name"].lower() for l in issue.get("labels", [])]
+    title = issue.get("title", "").lower()
+
+    # Mnemosyne gets absolute priority — check title AND labels
+    if "mnemosyne" in title or any("mnemosyne" in l for l in labels):
+        score += 300
+
+    # Priority tags boost
+    for tag in PRIORITY_TAGS:
+        if tag in labels or f"[{tag}]" in title:
+            score += 100
+
+    # Older issues get slight boost (clear backlog)
+    created = issue.get("created_at", "")
+    if created:
+        try:
+            created_dt = datetime.fromisoformat(created.replace("Z", "+00:00"))
+            age_days = (datetime.now(timezone.utc) - created_dt).days
+            score += min(age_days, 30)  # Cap at 30 days
+        except:
+            pass
+
+    return score
+
+
+def detect_lane(issue):
+    """Detect which lane an issue belongs to based on labels."""
+    labels = [l["name"].lower() for l in issue.get("labels", [])]
+
+    for lane, keywords in LANE_MAP.items():
+        for label in labels:
+            if label in keywords:
+                return lane
+
+    # Check title for keywords
+    title = issue.get("title", "").lower()
+    for lane, keywords in LANE_MAP.items():
+        for kw in keywords:
+            if kw in title:
+                return lane
+
+    return "CODE"  # Default
+
+
+def count_active_in_lane(state, lane):
+    """Count currently active workers in a lane."""
+    count = 0
+    for claim in state["active_claims"].values():
+        if claim.get("lane") == lane:
+            count += 1
+    return count
+
+
+# ── Claiming ────────────────────────────────────────────────────────────
+
+def claim_issue(issue, repo_name, lane, token):
+    """Claim an issue: add label + comment."""
+    repo = repo_name
+    num = issue["number"]
+
+    # Add mimo-claimed label
+    api_post(f"/repos/{repo}/issues/{num}/labels", token, {"labels": [CLAIM_LABEL]})
+
+    # Add /claim comment
+    comment_body = f"/claim — mimo-v2-pro [{lane}] lane. Branch: `mimo/{lane.lower()}/issue-{num}`"
+    api_post(f"/repos/{repo}/issues/{num}/comments", token, {"body": comment_body})
+
+    log(f"  CLAIMED #{num} in {repo} [{lane}]")
+
+
+def release_issue(issue, repo_name, reason, token):
+    """Release a claim: remove label, add /done or /abandon comment."""
+    repo = repo_name
+    num = issue["number"]
+
+    # Remove mimo-claimed label
+    labels = [l["name"] for l in issue.get("labels", [])]
+    if CLAIM_LABEL in labels:
+        api_delete(f"/repos/{repo}/issues/{num}/labels/{CLAIM_LABEL}", token)
+
+    # Add completion comment
+    comment = f"{ABANDON_COMMENT} — {reason}" if reason != "done" else f"{DONE_COMMENT} — completed by mimo-v2-pro"
+    api_post(f"/repos/{repo}/issues/{num}/comments", token, {"body": comment})
+
+    log(f"  RELEASED #{num} in {repo}: {reason}")
+
+
+# ── Worker Spawning ─────────────────────────────────────────────────────
+
+def spawn_worker(issue, repo_name, lane, token):
+    """Spawn a one-shot mimo worker for an issue."""
+    repo = repo_name
+    num = issue["number"]
+    title = issue["title"]
+    body = issue.get("body", "")[:2000]  # Truncate long bodies
+    labels = [l["name"] for l in issue.get("labels", [])]
+
+    # Build worker prompt
+    worker_id = f"mimo-{lane.lower()}-{num}-{int(time.time())}"
+
+    prompt = build_worker_prompt(repo, num, title, body, labels, lane, worker_id)
+
+    # Write prompt to temp file for the cron job to pick up
+    prompt_file = os.path.join(STATE_DIR, f"prompt-{worker_id}.txt")
+    with open(prompt_file, "w") as f:
+        f.write(prompt)
+
+    log(f"  SPAWNING worker {worker_id} for #{num} [{lane}]")
+    return worker_id
+
+
+def build_worker_prompt(repo, num, title, body, labels, lane, worker_id):
+    """Build the prompt for a mimo worker. Focus-mode aware with build validation."""
+
+    lane_instructions = {
+        "CODE": """You are a coding worker. Fix bugs, implement features, refactor code.
+- Read existing code BEFORE writing anything
+- Match the code style of the file you're editing
+- If Three.js code: use the existing patterns in the codebase
+- If config/infra: be precise, check existing values first""",
+        "BUILD": """You are a builder. Create new functionality, UI components, tools.
+- Study the existing architecture before building
+- Create complete, working implementations — no stubs
+- For UI: match the existing visual style
+- For APIs: follow the existing route patterns""",
+        "RESEARCH": """You are a researcher. Investigate the issue thoroughly.
+- Read all relevant code and documentation
+- Document findings in a markdown file: FINDINGS-issue-{num}.md
+- Include: what you found, what's broken, recommended fix, effort estimate
+- Create a summary PR with the findings document""",
+        "CREATE": """You are a creative worker. Write content, documentation, design.
+- Quality over quantity — one excellent asset beats five mediocre ones
+- Match the existing tone and style of the project
+- For docs: include code examples where relevant""",
+    }
+
+    clone_url = f"{GITEA_URL}/{repo}.git"
+    branch = f"mimo/{lane.lower()}/issue-{num}"
+
+    focus_section = ""
+    if FOCUS_MODE and repo == FOCUS_REPO:
+        focus_section = f"""
+## FOCUS MODE — THIS IS THE NEXUS
+The Nexus is a Three.js 3D world — Timmy's sovereign home on the web.
+Tech stack: vanilla JS, Three.js, WebSocket, HTML/CSS.
+Entry point: app.js (root) or public/nexus/app.js
+The world features: nebula skybox, portals, memory crystals, batcave terminal.
+
+IMPORTANT: After implementing, you MUST validate:
+1. cd /tmp/{worker_id}
+2. Check for syntax errors: node --check *.js (if JS files changed)
+3. If package.json exists: npm install --legacy-peer-deps && npm run build
+4. If build fails: FIX IT before pushing. No broken builds.
+5. If no build command exists: just validate syntax on changed files
+"""
+
+    return f"""You are a mimo-v2-pro swarm worker. {lane_instructions.get(lane, lane_instructions["CODE"])}
+
+## ISSUE
+Repository: {repo}
+Issue: #{num}
+Title: {title}
+Labels: {', '.join(labels)}
+
+Description:
+{body}
+{focus_section}
+## WORKFLOW
+1. Clone: git clone {clone_url} /tmp/{worker_id} 2>/dev/null || (cd /tmp/{worker_id} && git fetch origin && git checkout main && git pull)
+2. cd /tmp/{worker_id}
+3. Create branch: git checkout -b {branch}
+4. READ THE CODE. Understand the architecture before writing anything.
+5. Implement the fix/feature/solution.
+6. BUILD VALIDATION:
+   - Syntax check: node --check <file>.js for any JS changed
+   - If package.json exists: npm install --legacy-peer-deps 2>/dev/null && npm run build 2>&1
+   - If build fails: FIX THE BUILD. No broken PRs.
+   - Ensure git diff shows meaningful changes (>0 lines)
+7. Commit: git add -A && git commit -m "fix: {title} (closes #{num})"
+8. Push: git push origin {branch}
+9. Create PR via API:
+   curl -s -X POST '{GITEA_URL}/api/v1/repos/{repo}/pulls' \\
+     -H 'Authorization: token $(cat ~/.config/gitea/token)' \\
+     -H 'Content-Type: application/json' \\
+     -d '{{"title":"fix: {title}","head":"{branch}","base":"main","body":"Closes #{num}\\n\\nAutomated by mimo-v2-pro swarm.\\n\\n## Changes\\n- [describe what you changed]\\n\\n## Validation\\n- [x] Syntax check passed\\n- [x] Build passes (if applicable)"}}'
+
+## HARD RULES
+- NEVER exit without committing. Even partial progress must be committed.
+- NEVER create new issues. Only work on issue #{num}.
+- NEVER push to main. Only push to your branch.
+- NEVER push a broken build. Fix it or abandon with clear notes.
+- If too complex: commit WIP, push, PR body says "WIP — needs human review"
+- If build fails and you can't fix: commit anyway, push, PR body says "Build failed — needs human fix"
+
+Worker: {worker_id}
+"""
+
+
+# ── Main ────────────────────────────────────────────────────────────────
+
+def dispatch(token):
+    """Main dispatch loop."""
+    state = load_state()
+    dispatched = 0
+
+    log("=" * 60)
+    log("MIMO DISPATCHER — scanning for work")
+
+    # Clean stale claims first
+    stale = []
+    for claim_id, claim in list(state["active_claims"].items()):
+        started = datetime.fromisoformat(claim["started"])
+        age = datetime.now(timezone.utc) - started
+        if age > timedelta(minutes=CLAIM_TIMEOUT_MINUTES):
+            stale.append(claim_id)
+
+    for claim_id in stale:
+        claim = state["active_claims"].pop(claim_id)
+        log(f"  EXPIRED claim: {claim['repo']}#{claim['issue']} [{claim['lane']}]")
+        state["stats"]["total_released"] += 1
+
+    # Prefetch PR refs once (avoids N API calls in is_claimed)
+    target_repo = FOCUS_REPO if FOCUS_MODE else PRIORITY_REPOS[0]
+    prefetch_pr_refs(target_repo, token)
+    log(f"  Prefetched {len(_PR_REFS)} PR references")
+
+    # FOCUS MODE: scan only the focus repo. FIREHOSE: scan all.
+    if FOCUS_MODE:
+        ordered = [FOCUS_REPO]
+        log(f"  FOCUS MODE: targeting {FOCUS_REPO} only")
+    else:
+        repos = get_repos(token)
+        repo_names = [r["full_name"] for r in repos]
+        ordered = []
+        for pr in PRIORITY_REPOS:
+            if pr in repo_names:
+                ordered.append(pr)
+        for rn in repo_names:
+            if rn not in ordered:
+                ordered.append(rn)
+
+    # Scan each repo and collect all issues for priority sorting
+    all_issues = []
+    for repo_name in ordered[:20 if not FOCUS_MODE else 1]:
+        issues = get_open_issues(repo_name, token)
+        for issue in issues:
+            issue["_repo_name"] = repo_name  # Tag with repo
+            all_issues.append(issue)
+
+    # Sort by priority score (highest first)
+    all_issues.sort(key=priority_score, reverse=True)
+
+    for issue in all_issues:
+        repo_name = issue["_repo_name"]
+
+        # Skip if already claimed in state
+        claim_key = f"{repo_name}#{issue['number']}"
+        if claim_key in state["active_claims"]:
+            continue
+
+        # Skip if claimed in Gitea
+        if is_claimed(issue, repo_name, token):
+            continue
+
+        # Detect lane
+        lane = detect_lane(issue)
+
+        # Check lane capacity
+        active_in_lane = count_active_in_lane(state, lane)
+        max_in_lane = MAX_WORKERS_PER_LANE.get(lane, 1)
+
+        if active_in_lane >= max_in_lane:
+            continue  # Lane full, skip
+
+        # Claim and spawn
+        claim_issue(issue, repo_name, lane, token)
+        worker_id = spawn_worker(issue, repo_name, lane, token)
+
+        state["active_claims"][claim_key] = {
+            "repo": repo_name,
+            "issue": issue["number"],
+            "lane": lane,
+            "worker_id": worker_id,
+            "started": datetime.now(timezone.utc).isoformat(),
+        }
+        state["stats"]["total_dispatched"] += 1
+        dispatched += 1
+
+        max_dispatch = 35 if FOCUS_MODE else 25
+        if dispatched >= max_dispatch:
+            break
+
+    save_state(state)
+
+    # Summary
+    active = len(state["active_claims"])
+    log(f"Dispatch complete: {dispatched} new, {active} active, {state['stats']['total_dispatched']} total dispatched")
+    log(f"Active by lane: CODE={count_active_in_lane(state,'CODE')}, BUILD={count_active_in_lane(state,'BUILD')}, RESEARCH={count_active_in_lane(state,'RESEARCH')}, CREATE={count_active_in_lane(state,'CREATE')}")
+
+    return dispatched
+
+
+if __name__ == "__main__":
+    token = load_token()
+    dispatched = dispatch(token)
+    sys.exit(0 if dispatched >= 0 else 1)

mimo-swarm/scripts/mimo-worker.sh

@@ -0,0 +1,157 @@
+#!/bin/bash
+# Mimo Swarm Worker — One-shot execution
+# Receives a prompt file, runs mimo-v2-pro via hermes, handles the git workflow.
+#
+# Usage: mimo-worker.sh <prompt_file>
+# The prompt file contains all instructions for the worker.
+
+set -euo pipefail
+
+PROMPT_FILE="${1:?Usage: mimo-worker.sh <prompt_file>}"
+WORKER_ID=$(basename "$PROMPT_FILE" .txt | sed 's/prompt-//')
+LOG_DIR="$HOME/.hermes/mimo-swarm/logs"
+LOG_FILE="$LOG_DIR/worker-${WORKER_ID}.log"
+STATE_DIR="$HOME/.hermes/mimo-swarm/state"
+GITEA_URL="https://forge.alexanderwhitestone.com"
+TOKEN=$(cat "$HOME/.config/gitea/token")
+
+log() {
+    echo "[$(date -u +%Y-%m-%dT%H:%M:%SZ)] $*" | tee -a "$LOG_FILE"
+}
+
+# Read the prompt
+if [ ! -f "$PROMPT_FILE" ]; then
+    log "ERROR: Prompt file not found: $PROMPT_FILE"
+    exit 1
+fi
+
+PROMPT=$(cat "$PROMPT_FILE")
+log "WORKER START: $WORKER_ID"
+
+# Extract repo and issue from prompt
+REPO=$(echo "$PROMPT" | grep "^Repository:" | head -1 | awk '{print $2}')
+ISSUE_NUM=$(echo "$PROMPT" | grep "^Issue:" | head -1 | awk '{print $2}' | tr -d '#')
+LANE=$(echo "$WORKER_ID" | cut -d- -f2)
+BRANCH="mimo/${LANE}/issue-${ISSUE_NUM}"
+WORK_DIR="/tmp/${WORKER_ID}"
+
+log "  Repo: $REPO | Issue: #$ISSUE_NUM | Branch: $BRANCH"
+
+# Clone the repo
+mkdir -p "$(dirname "$WORK_DIR")"
+if [ -d "$WORK_DIR" ]; then
+    log "  Pulling existing clone..."
+    cd "$WORK_DIR"
+    git fetch origin main 2>/dev/null || true
+    git checkout main 2>/dev/null || git checkout master 2>/dev/null || true
+    git pull 2>/dev/null || true
+else
+    log "  Cloning..."
+    CLONE_URL="${GITEA_URL}/${REPO}.git"
+    git clone "$CLONE_URL" "$WORK_DIR" 2>>"$LOG_FILE"
+    cd "$WORK_DIR"
+fi
+
+# Create branch
+git checkout -b "$BRANCH" 2>/dev/null || git checkout "$BRANCH"
+log "  On branch: $BRANCH"
+
+# Run mimo via hermes
+log "  Dispatching to mimo-v2-pro..."
+hermes chat -q "$PROMPT" --provider nous -m xiaomi/mimo-v2-pro --yolo -t terminal,code_execution -Q >>"$LOG_FILE" 2>&1
+MIMO_EXIT=$?
+log "  Mimo exited with code: $MIMO_EXIT"
+
+# Quality gate
+log "  Running quality gate..."
+
+# Check if there are changes
+CHANGES=$(git diff --stat 2>/dev/null || echo "")
+STAGED=$(git status --porcelain 2>/dev/null || echo "")
+
+if [ -z "$CHANGES" ] && [ -z "$STAGED" ]; then
+    log "  QUALITY GATE: No changes detected. Worker produced nothing."
+    # Try to salvage - maybe changes were committed already
+    COMMITS=$(git log main..HEAD --oneline 2>/dev/null | wc -l | tr -d ' ')
+    if [ "$COMMITS" -gt 0 ]; then
+        log "  SALVAGE: Found $COMMITS commit(s) on branch. Proceeding to push."
+    else
+        log "  ABANDON: No commits, no changes. Nothing to salvage."
+        cd /tmp
+        rm -rf "$WORK_DIR"
+        # Write release state
+        echo "{\"status\":\"abandoned\",\"reason\":\"no_changes\",\"worker\":\"$WORKER_ID\",\"issue\":$ISSUE_NUM}" > "$STATE_DIR/result-${WORKER_ID}.json"
+        exit 0
+    fi
+else
+    # Syntax check for Python files
+    PY_FILES=$(find . -name "*.py" -newer .git/HEAD 2>/dev/null | head -20)
+    for pyf in $PY_FILES; do
+        if ! python3 -m py_compile "$pyf" 2>>"$LOG_FILE"; then
+            log "  SYNTAX ERROR in $pyf — attempting fix or committing anyway"
+        fi
+    done
+
+    # Syntax check for JS files
+    JS_FILES=$(find . -name "*.js" -newer .git/HEAD 2>/dev/null | head -20)
+    for jsf in $JS_FILES; do
+        if ! node --check "$jsf" 2>>"$LOG_FILE"; then
+            log "  SYNTAX ERROR in $jsf — attempting fix or committing anyway"
+        fi
+    done
+
+    # Diff size check
+    DIFF_LINES=$(git diff --stat | tail -1 | grep -oP '\d+ insertion' | grep -oP '\d+' || echo "0")
+    if [ "$DIFF_LINES" -gt 500 ]; then
+        log "  WARNING: Large diff ($DIFF_LINES insertions). Committing but flagging for review."
+    fi
+
+    # Commit
+    git add -A
+    COMMIT_MSG="fix: $(echo "$PROMPT" | grep '^Title:' | sed 's/^Title: //') (closes #${ISSUE_NUM})"
+    git commit -m "$COMMIT_MSG" 2>>"$LOG_FILE" || log "  Nothing to commit (already clean)"
+fi
+
+# Push
+log "  Pushing branch..."
+PUSH_OUTPUT=$(git push origin "$BRANCH" 2>&1) || {
+    log "  Push failed, trying force push..."
+    git push -f origin "$BRANCH" 2>>"$LOG_FILE" || log "  Push failed completely"
+}
+log "  Pushed: $PUSH_OUTPUT"
+
+# Create PR
+log "  Creating PR..."
+PR_TITLE="fix: $(echo "$PROMPT" | grep '^Title:' | sed 's/^Title: //')"
+PR_BODY="Closes #${ISSUE_NUM}
+
+Automated by mimo-v2-pro swarm worker.
+Worker: ${WORKER_ID}"
+
+PR_RESPONSE=$(curl -s -X POST "${GITEA_URL}/api/v1/repos/${REPO}/pulls" \
+    -H "Authorization: token ${TOKEN}" \
+    -H "Content-Type: application/json" \
+    -d "{\"title\":\"${PR_TITLE}\",\"head\":\"${BRANCH}\",\"base\":\"main\",\"body\":\"${PR_BODY}\"}" 2>>"$LOG_FILE")
+
+PR_NUM=$(echo "$PR_RESPONSE" | python3 -c "import sys,json; print(json.load(sys.stdin).get('number','?'))" 2>/dev/null || echo "?")
+log "  PR created: #${PR_NUM}"
+
+# Clean up
+cd /tmp
+# Keep work dir for debugging, clean later
+
+# Write result
+cat > "$STATE_DIR/result-${WORKER_ID}.json" <<EOF
+{
+    "status": "completed",
+    "worker": "$WORKER_ID",
+    "repo": "$REPO",
+    "issue": $ISSUE_NUM,
+    "branch": "$BRANCH",
+    "pr": $PR_NUM,
+    "mimo_exit": $MIMO_EXIT,
+    "timestamp": "$(date -u +%Y-%m-%dT%H:%M:%SZ)"
+}
+EOF
+
+log "WORKER COMPLETE: $WORKER_ID → PR #${PR_NUM}"

mimo-swarm/scripts/worker-runner.py

@@ -0,0 +1,224 @@
+#!/usr/bin/env python3
+"""
+Worker Runner — actual worker that picks up prompts and runs mimo via hermes CLI.
+
+This is what the cron jobs SHOULD call instead of asking the LLM to check files.
+"""
+
+import os
+import sys
+import glob
+import subprocess
+import json
+from datetime import datetime, timezone
+
+STATE_DIR = os.path.expanduser("~/.hermes/mimo-swarm/state")
+LOG_DIR = os.path.expanduser("~/.hermes/mimo-swarm/logs")
+
+
+def log(msg):
+    ts = datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")
+    print(f"[{ts}] {msg}")
+    log_file = os.path.join(LOG_DIR, f"runner-{datetime.now().strftime('%Y%m%d')}.log")
+    with open(log_file, "a") as f:
+        f.write(f"[{ts}] {msg}\n")
+
+
+def get_oldest_prompt():
+    """Get the oldest prompt file with file locking (atomic rename)."""
+    prompts = sorted(glob.glob(os.path.join(STATE_DIR, "prompt-*.txt")))
+    if not prompts:
+        return None
+    # Prefer non-review prompts
+    impl = [p for p in prompts if "review" not in os.path.basename(p)]
+    target = impl[0] if impl else prompts[0]
+
+    # Atomic claim: rename to .processing
+    claimed = target + ".processing"
+    try:
+        os.rename(target, claimed)
+        return claimed
+    except OSError:
+        # Another worker got it first
+        return None
+
+
+def run_worker(prompt_file):
+    """Run the worker: read prompt, execute via hermes, create PR."""
+    worker_id = os.path.basename(prompt_file).replace("prompt-", "").replace(".txt", "")
+
+    with open(prompt_file) as f:
+        prompt = f.read()
+
+    # Extract repo and issue from prompt
+    repo = None
+    issue = None
+    for line in prompt.split("\n"):
+        if line.startswith("Repository:"):
+            repo = line.split(":", 1)[1].strip()
+        if line.startswith("Issue:"):
+            issue = line.split("#", 1)[1].strip() if "#" in line else line.split(":", 1)[1].strip()
+
+    log(f"Worker {worker_id}: repo={repo}, issue={issue}")
+
+    if not repo or not issue:
+        log(f"  SKIPPING: couldn't parse repo/issue from prompt")
+        os.remove(prompt_file)
+        return False
+
+    # Clone/pull the repo — unique workspace per worker
+    import tempfile
+    work_dir = tempfile.mkdtemp(prefix=f"mimo-{worker_id}-")
+    clone_url = f"https://forge.alexanderwhitestone.com/{repo}.git"
+    branch = f"mimo/{worker_id.split('-')[1] if '-' in worker_id else 'code'}/issue-{issue}"
+
+    log(f"  Workspace: {work_dir}")
+    result = subprocess.run(
+        ["git", "clone", clone_url, work_dir],
+        capture_output=True, text=True, timeout=120
+    )
+    if result.returncode != 0:
+        log(f"  CLONE FAILED: {result.stderr[:200]}")
+        os.remove(prompt_file)
+        return False
+
+    # Checkout branch
+    subprocess.run(["git", "fetch", "origin", "main"], cwd=work_dir, capture_output=True, timeout=60)
+    subprocess.run(["git", "checkout", "main"], cwd=work_dir, capture_output=True, timeout=30)
+    subprocess.run(["git", "pull"], cwd=work_dir, capture_output=True, timeout=30)
+    subprocess.run(["git", "checkout", "-b", branch], cwd=work_dir, capture_output=True, timeout=30)
+
+    # Run mimo via hermes CLI
+    log(f"  Dispatching to hermes (nous/mimo-v2-pro)...")
+    result = subprocess.run(
+        ["hermes", "chat", "-q", prompt, "--provider", "nous", "-m", "xiaomi/mimo-v2-pro",
+         "--yolo", "-t", "terminal,code_execution", "-Q"],
+        capture_output=True, text=True, timeout=900,  # 15 min timeout
+        cwd=work_dir
+    )
+
+    log(f"  Hermes exit: {result.returncode}")
+    log(f"  Output: {result.stdout[-500:]}")
+
+    # Check for changes
+    status = subprocess.run(
+        ["git", "status", "--porcelain"],
+        capture_output=True, text=True, cwd=work_dir
+    )
+
+    if not status.stdout.strip():
+        # Check for commits
+        log_count = subprocess.run(
+            ["git", "log", "main..HEAD", "--oneline"],
+            capture_output=True, text=True, cwd=work_dir
+        )
+        if not log_count.stdout.strip():
+            log(f"  NO CHANGES — abandoning")
+            # Release the claim
+            token = open(os.path.expanduser("~/.config/gitea/token")).read().strip()
+            import urllib.request
+            try:
+                req = urllib.request.Request(
+                    f"https://forge.alexanderwhitestone.com/api/v1/repos/{repo}/issues/{issue}/labels/mimo-claimed",
+                    headers={"Authorization": f"token {token}"},
+                    method="DELETE"
+                )
+                urllib.request.urlopen(req, timeout=10)
+            except:
+                pass
+            if os.path.exists(prompt_file):
+                os.remove(prompt_file)
+            return False
+
+    # Commit dirty files (salvage)
+    if status.stdout.strip():
+        subprocess.run(["git", "add", "-A"], cwd=work_dir, capture_output=True, timeout=30)
+        subprocess.run(
+            ["git", "commit", "-m", f"WIP: issue #{issue} (mimo swarm)"],
+            cwd=work_dir, capture_output=True, timeout=30
+        )
+
+    # Push
+    log(f"  Pushing {branch}...")
+    push = subprocess.run(
+        ["git", "push", "origin", branch],
+        capture_output=True, text=True, cwd=work_dir, timeout=60
+    )
+    if push.returncode != 0:
+        log(f"  Push failed, trying force...")
+        subprocess.run(
+            ["git", "push", "-f", "origin", branch],
+            capture_output=True, text=True, cwd=work_dir, timeout=60
+        )
+
+    # Create PR via API
+    token = open(os.path.expanduser("~/.config/gitea/token")).read().strip()
+    import urllib.request
+
+    # Get issue title
+    try:
+        req = urllib.request.Request(
+            f"https://forge.alexanderwhitestone.com/api/v1/repos/{repo}/issues/{issue}",
+            headers={"Authorization": f"token {token}", "Accept": "application/json"}
+        )
+        with urllib.request.urlopen(req, timeout=15) as resp:
+            issue_data = json.loads(resp.read())
+            title = issue_data.get("title", f"Issue #{issue}")
+    except:
+        title = f"Issue #{issue}"
+
+    pr_body = json.dumps({
+        "title": f"fix: {title}",
+        "head": branch,
+        "base": "main",
+        "body": f"Closes #{issue}\n\nAutomated by mimo-v2-pro swarm.\nWorker: {worker_id}"
+    }).encode()
+
+    try:
+        req = urllib.request.Request(
+            f"https://forge.alexanderwhitestone.com/api/v1/repos/{repo}/pulls",
+            data=pr_body,
+            headers={
+                "Authorization": f"token {token}",
+                "Content-Type": "application/json"
+            },
+            method="POST"
+        )
+        with urllib.request.urlopen(req, timeout=30) as resp:
+            pr_data = json.loads(resp.read())
+            pr_num = pr_data.get("number", "?")
+        log(f"  PR CREATED: #{pr_num}")
+    except Exception as e:
+        log(f"  PR FAILED: {e}")
+        pr_num = "?"
+
+    # Write result
+    result_file = os.path.join(STATE_DIR, f"result-{worker_id}.json")
+    with open(result_file, "w") as f:
+        json.dump({
+            "status": "completed",
+            "worker": worker_id,
+            "repo": repo,
+            "issue": int(issue) if issue.isdigit() else issue,
+            "branch": branch,
+            "pr": pr_num,
+            "timestamp": datetime.now(timezone.utc).isoformat()
+        }, f)
+
+    # Remove prompt
+    # Remove prompt file (handles .processing extension)
+    if os.path.exists(prompt_file):
+        os.remove(prompt_file)
+    log(f"  DONE — prompt removed")
+    return True
+
+
+if __name__ == "__main__":
+    prompt = get_oldest_prompt()
+    if not prompt:
+        print("No prompts in queue")
+        sys.exit(0)
+
+    print(f"Processing: {os.path.basename(prompt)}")
+    success = run_worker(prompt)
+    sys.exit(0 if success else 1)

nexus/components/memory-optimizer.js

@@ -0,0 +1,99 @@
+// ═══════════════════════════════════════════
+//  PROJECT MNEMOSYNE — MEMORY OPTIMIZER (GOFAI)
+// ═══════════════════════════════════════════
+//
+// Heuristic-based memory pruning and organization.
+// Operates without LLMs to maintain a lean, high-signal spatial index.
+//
+// Heuristics:
+// 1. Strength Decay: Memories lose strength over time if not accessed.
+// 2. Redundancy: Simple string similarity to identify duplicates.
+// 3. Isolation: Memories with no connections are lower priority.
+// 4. Aging: Old memories in 'working' are moved to 'archive'.
+// ═══════════════════════════════════════════
+
+const MemoryOptimizer = (() => {
+  const DECAY_RATE = 0.01; // Strength lost per optimization cycle
+  const PRUNE_THRESHOLD = 0.1; // Remove if strength < this
+  const SIMILARITY_THRESHOLD = 0.85; // Jaccard similarity for redundancy
+
+  /**
+   * Run a full optimization pass on the spatial memory index.
+   * @param {object} spatialMemory - The SpatialMemory component instance.
+   * @returns {object} Summary of actions taken.
+   */
+  function optimize(spatialMemory) {
+    const memories = spatialMemory.getAllMemories();
+    const results = { pruned: 0, moved: 0, updated: 0 };
+
+    // 1. Strength Decay & Aging
+    memories.forEach(mem => {
+      let strength = mem.strength || 0.7;
+      strength -= DECAY_RATE;
+      
+      if (strength < PRUNE_THRESHOLD) {
+        spatialMemory.removeMemory(mem.id);
+        results.pruned++;
+        return;
+      }
+
+      // Move old working memories to archive
+      if (mem.category === 'working') {
+        const timestamp = mem.timestamp || new Date().toISOString();
+        const age = Date.now() - new Date(timestamp).getTime();
+        if (age > 1000 * 60 * 60 * 24) { // 24 hours
+          spatialMemory.removeMemory(mem.id);
+          spatialMemory.placeMemory({ ...mem, category: 'archive', strength });
+          results.moved++;
+          return;
+        }
+      }
+
+      spatialMemory.updateMemory(mem.id, { strength });
+      results.updated++;
+    });
+
+    // 2. Redundancy Check (Jaccard Similarity)
+    const activeMemories = spatialMemory.getAllMemories();
+    for (let i = 0; i < activeMemories.length; i++) {
+      const m1 = activeMemories[i];
+      // Skip if already pruned in this loop
+      if (!spatialMemory.getAllMemories().find(m => m.id === m1.id)) continue;
+
+      for (let j = i + 1; j < activeMemories.length; j++) {
+        const m2 = activeMemories[j];
+        if (m1.category !== m2.category) continue;
+
+        const sim = _calculateSimilarity(m1.content, m2.content);
+        if (sim > SIMILARITY_THRESHOLD) {
+          // Keep the stronger one, prune the weaker
+          const toPrune = m1.strength >= m2.strength ? m2.id : m1.id;
+          spatialMemory.removeMemory(toPrune);
+          results.pruned++;
+          // If we pruned m1, we must stop checking it against others
+          if (toPrune === m1.id) break;
+        }
+      }
+    }
+
+    console.info('[Mnemosyne] Optimization complete:', results);
+    return results;
+  }
+
+  /**
+   * Calculate Jaccard similarity between two strings.
+   * @private
+   */
+  function _calculateSimilarity(s1, s2) {
+    if (!s1 || !s2) return 0;
+    const set1 = new Set(s1.toLowerCase().split(/\s+/));
+    const set2 = new Set(s2.toLowerCase().split(/\s+/));
+    const intersection = new Set([...set1].filter(x => set2.has(x)));
+    const union = new Set([...set1, ...set2]);
+    return intersection.size / union.size;
+  }
+
+  return { optimize };
+})();
+
+export { MemoryOptimizer };

nexus/components/memory-particles.js

@@ -0,0 +1,404 @@
+// ═══════════════════════════════════════════
+//  PROJECT MNEMOSYNE — AMBIENT PARTICLE SYSTEM
+// ═══════════════════════════════════════════
+//
+// Memory activity visualization via Three.js Points.
+// Three particle modes:
+//   1. Spawn burst — 20 particles on new fact, 2s fade
+//   2. Access trail — 10 particles streaming to crystal
+//   3. Ambient dust — 200 particles, slow cosmic drift
+//
+// Category colors for all particles.
+// Total budget: < 500 particles at any time.
+//
+// Usage from app.js:
+//   import { MemoryParticles } from './nexus/components/memory-particles.js';
+//   MemoryParticles.init(scene);
+//   MemoryParticles.onMemoryPlaced(position, category);
+//   MemoryParticles.onMemoryAccessed(fromPos, toPos, category);
+//   MemoryParticles.update(delta);
+// ═══════════════════════════════════════════
+
+const MemoryParticles = (() => {
+  let _scene = null;
+  let _initialized = false;
+
+  // ─── CATEGORY COLORS ──────────────────────
+  const CATEGORY_COLORS = {
+    engineering:  new THREE.Color(0x4af0c0),
+    social:       new THREE.Color(0x7b5cff),
+    knowledge:    new THREE.Color(0xffd700),
+    projects:     new THREE.Color(0xff4466),
+    working:      new THREE.Color(0x00ff88),
+    archive:      new THREE.Color(0x334455),
+    user_pref:    new THREE.Color(0xffd700),
+    project:      new THREE.Color(0x4488ff),
+    tool_knowledge: new THREE.Color(0x44ff88),
+    general:      new THREE.Color(0x8899aa),
+  };
+  const DEFAULT_COLOR = new THREE.Color(0x8899bb);
+
+  // ─── PARTICLE BUDGETS ─────────────────────
+  const MAX_BURST_PARTICLES = 20;   // per spawn event
+  const MAX_TRAIL_PARTICLES = 10;   // per access event
+  const AMBIENT_COUNT       = 200;  // always-on dust
+  const MAX_ACTIVE_BURSTS   = 8;    // max concurrent burst groups
+  const MAX_ACTIVE_TRAILS   = 5;    // max concurrent trail groups
+
+  // ─── ACTIVE PARTICLE GROUPS ───────────────
+  let _bursts = [];   // { points, velocities, life, maxLife }
+  let _trails = [];   // { points, velocities, life, maxLife, target }
+  let _ambientPoints = null;
+
+  // ─── HELPERS ──────────────────────────────
+  function _getCategoryColor(category) {
+    return CATEGORY_COLORS[category] || DEFAULT_COLOR;
+  }
+
+  // ═══ AMBIENT DUST ═════════════════════════
+  function _createAmbient() {
+    const geo = new THREE.BufferGeometry();
+    const positions = new Float32Array(AMBIENT_COUNT * 3);
+    const colors = new Float32Array(AMBIENT_COUNT * 3);
+    const sizes = new Float32Array(AMBIENT_COUNT);
+
+    // Distribute across the world
+    for (let i = 0; i < AMBIENT_COUNT; i++) {
+      positions[i * 3]     = (Math.random() - 0.5) * 50;
+      positions[i * 3 + 1] = Math.random() * 18 + 1;
+      positions[i * 3 + 2] = (Math.random() - 0.5) * 50;
+
+      // Subtle category-tinted colors
+      const categories = Object.keys(CATEGORY_COLORS);
+      const cat = categories[Math.floor(Math.random() * categories.length)];
+      const col = _getCategoryColor(cat).clone().multiplyScalar(0.4 + Math.random() * 0.3);
+      colors[i * 3]     = col.r;
+      colors[i * 3 + 1] = col.g;
+      colors[i * 3 + 2] = col.b;
+
+      sizes[i] = 0.02 + Math.random() * 0.04;
+    }
+
+    geo.setAttribute('position', new THREE.BufferAttribute(positions, 3));
+    geo.setAttribute('color', new THREE.BufferAttribute(colors, 3));
+    geo.setAttribute('size', new THREE.BufferAttribute(sizes, 1));
+
+    const mat = new THREE.ShaderMaterial({
+      uniforms: { uTime: { value: 0 } },
+      vertexShader: `
+        attribute float size;
+        attribute vec3 color;
+        varying vec3 vColor;
+        varying float vAlpha;
+        uniform float uTime;
+        void main() {
+          vColor = color;
+          vec3 pos = position;
+          // Slow cosmic drift
+          pos.x += sin(uTime * 0.08 + position.y * 0.3) * 0.5;
+          pos.y += sin(uTime * 0.05 + position.z * 0.2) * 0.3;
+          pos.z += cos(uTime * 0.06 + position.x * 0.25) * 0.4;
+          vec4 mv = modelViewMatrix * vec4(pos, 1.0);
+          gl_PointSize = size * 250.0 / -mv.z;
+          gl_Position = projectionMatrix * mv;
+          // Fade with distance
+          vAlpha = smoothstep(40.0, 10.0, -mv.z) * 0.5;
+        }
+      `,
+      fragmentShader: `
+        varying vec3 vColor;
+        varying float vAlpha;
+        void main() {
+          float d = length(gl_PointCoord - 0.5);
+          if (d > 0.5) discard;
+          float alpha = smoothstep(0.5, 0.05, d);
+          gl_FragColor = vec4(vColor, alpha * vAlpha);
+        }
+      `,
+      transparent: true,
+      depthWrite: false,
+      blending: THREE.AdditiveBlending,
+    });
+
+    _ambientPoints = new THREE.Points(geo, mat);
+    _scene.add(_ambientPoints);
+  }
+
+  // ═══ BURST EFFECT ═════════════════════════
+  function _createBurst(position, category) {
+    const count = MAX_BURST_PARTICLES;
+    const geo = new THREE.BufferGeometry();
+    const positions = new Float32Array(count * 3);
+    const colors = new Float32Array(count * 3);
+    const sizes = new Float32Array(count);
+    const velocities = [];
+    const col = _getCategoryColor(category);
+
+    for (let i = 0; i < count; i++) {
+      positions[i * 3]     = position.x;
+      positions[i * 3 + 1] = position.y;
+      positions[i * 3 + 2] = position.z;
+
+      colors[i * 3]     = col.r;
+      colors[i * 3 + 1] = col.g;
+      colors[i * 3 + 2] = col.b;
+
+      sizes[i] = 0.06 + Math.random() * 0.06;
+
+      // Random outward velocity
+      const theta = Math.random() * Math.PI * 2;
+      const phi = Math.random() * Math.PI;
+      const speed = 1.5 + Math.random() * 2.5;
+      velocities.push(
+        Math.sin(phi) * Math.cos(theta) * speed,
+        Math.cos(phi) * speed * 0.8 + 1.0,  // bias upward
+        Math.sin(phi) * Math.sin(theta) * speed
+      );
+    }
+
+    geo.setAttribute('position', new THREE.BufferAttribute(positions, 3));
+    geo.setAttribute('color', new THREE.BufferAttribute(colors, 3));
+    geo.setAttribute('size', new THREE.BufferAttribute(sizes, 1));
+
+    const mat = new THREE.ShaderMaterial({
+      uniforms: { uOpacity: { value: 1.0 } },
+      vertexShader: `
+        attribute float size;
+        attribute vec3 color;
+        varying vec3 vColor;
+        uniform float uOpacity;
+        void main() {
+          vColor = color;
+          vec4 mv = modelViewMatrix * vec4(position, 1.0);
+          gl_PointSize = size * 300.0 / -mv.z;
+          gl_Position = projectionMatrix * mv;
+        }
+      `,
+      fragmentShader: `
+        varying vec3 vColor;
+        uniform float uOpacity;
+        void main() {
+          float d = length(gl_PointCoord - 0.5);
+          if (d > 0.5) discard;
+          float alpha = smoothstep(0.5, 0.05, d);
+          gl_FragColor = vec4(vColor, alpha * uOpacity);
+        }
+      `,
+      transparent: true,
+      depthWrite: false,
+      blending: THREE.AdditiveBlending,
+    });
+
+    const points = new THREE.Points(geo, mat);
+    _scene.add(points);
+
+    _bursts.push({
+      points,
+      velocities,
+      life: 0,
+      maxLife: 2.0,  // 2s fade
+    });
+
+    // Cap active bursts
+    while (_bursts.length > MAX_ACTIVE_BURSTS) {
+      _removeBurst(0);
+    }
+  }
+
+  function _removeBurst(idx) {
+    const burst = _bursts[idx];
+    if (burst.points.parent) burst.points.parent.remove(burst.points);
+    burst.points.geometry.dispose();
+    burst.points.material.dispose();
+    _bursts.splice(idx, 1);
+  }
+
+  // ═══ TRAIL EFFECT ═════════════════════════
+  function _createTrail(fromPos, toPos, category) {
+    const count = MAX_TRAIL_PARTICLES;
+    const geo = new THREE.BufferGeometry();
+    const positions = new Float32Array(count * 3);
+    const colors = new Float32Array(count * 3);
+    const sizes = new Float32Array(count);
+    const velocities = [];
+    const col = _getCategoryColor(category);
+
+    for (let i = 0; i < count; i++) {
+      // Stagger start positions along the path
+      const t = Math.random();
+      positions[i * 3]     = fromPos.x + (toPos.x - fromPos.x) * t + (Math.random() - 0.5) * 0.5;
+      positions[i * 3 + 1] = fromPos.y + (toPos.y - fromPos.y) * t + (Math.random() - 0.5) * 0.5;
+      positions[i * 3 + 2] = fromPos.z + (toPos.z - fromPos.z) * t + (Math.random() - 0.5) * 0.5;
+
+      colors[i * 3]     = col.r;
+      colors[i * 3 + 1] = col.g;
+      colors[i * 3 + 2] = col.b;
+
+      sizes[i] = 0.04 + Math.random() * 0.04;
+
+      // Velocity toward target with slight randomness
+      const dx = toPos.x - fromPos.x;
+      const dy = toPos.y - fromPos.y;
+      const dz = toPos.z - fromPos.z;
+      const len = Math.sqrt(dx * dx + dy * dy + dz * dz) || 1;
+      const speed = 2.0 + Math.random() * 1.5;
+      velocities.push(
+        (dx / len) * speed + (Math.random() - 0.5) * 0.5,
+        (dy / len) * speed + (Math.random() - 0.5) * 0.5,
+        (dz / len) * speed + (Math.random() - 0.5) * 0.5
+      );
+    }
+
+    geo.setAttribute('position', new THREE.BufferAttribute(positions, 3));
+    geo.setAttribute('color', new THREE.BufferAttribute(colors, 3));
+    geo.setAttribute('size', new THREE.BufferAttribute(sizes, 1));
+
+    const mat = new THREE.ShaderMaterial({
+      uniforms: { uOpacity: { value: 1.0 } },
+      vertexShader: `
+        attribute float size;
+        attribute vec3 color;
+        varying vec3 vColor;
+        uniform float uOpacity;
+        void main() {
+          vColor = color;
+          vec4 mv = modelViewMatrix * vec4(position, 1.0);
+          gl_PointSize = size * 280.0 / -mv.z;
+          gl_Position = projectionMatrix * mv;
+        }
+      `,
+      fragmentShader: `
+        varying vec3 vColor;
+        uniform float uOpacity;
+        void main() {
+          float d = length(gl_PointCoord - 0.5);
+          if (d > 0.5) discard;
+          float alpha = smoothstep(0.5, 0.05, d);
+          gl_FragColor = vec4(vColor, alpha * uOpacity);
+        }
+      `,
+      transparent: true,
+      depthWrite: false,
+      blending: THREE.AdditiveBlending,
+    });
+
+    const points = new THREE.Points(geo, mat);
+    _scene.add(points);
+
+    _trails.push({
+      points,
+      velocities,
+      life: 0,
+      maxLife: 1.5,  // 1.5s trail
+      target: toPos.clone(),
+    });
+
+    // Cap active trails
+    while (_trails.length > MAX_ACTIVE_TRAILS) {
+      _removeTrail(0);
+    }
+  }
+
+  function _removeTrail(idx) {
+    const trail = _trails[idx];
+    if (trail.points.parent) trail.points.parent.remove(trail.points);
+    trail.points.geometry.dispose();
+    trail.points.material.dispose();
+    _trails.splice(idx, 1);
+  }
+
+  // ═══ PUBLIC API ═══════════════════════════
+  function init(scene) {
+    _scene = scene;
+    _initialized = true;
+    _createAmbient();
+    console.info('[Mnemosyne] Ambient particle system initialized —', AMBIENT_COUNT, 'dust particles');
+  }
+
+  function onMemoryPlaced(position, category) {
+    if (!_initialized) return;
+    const pos = position instanceof THREE.Vector3 ? position : new THREE.Vector3(position.x, position.y, position.z);
+    _createBurst(pos, category);
+  }
+
+  function onMemoryAccessed(fromPosition, toPosition, category) {
+    if (!_initialized) return;
+    const from = fromPosition instanceof THREE.Vector3 ? fromPosition : new THREE.Vector3(fromPosition.x, fromPosition.y, fromPosition.z);
+    const to = toPosition instanceof THREE.Vector3 ? toPosition : new THREE.Vector3(toPosition.x, toPosition.y, toPosition.z);
+    _createTrail(from, to, category);
+  }
+
+  function update(delta) {
+    if (!_initialized) return;
+
+    // Update ambient dust
+    if (_ambientPoints && _ambientPoints.material.uniforms) {
+      _ambientPoints.material.uniforms.uTime.value += delta;
+    }
+
+    // Update bursts
+    for (let i = _bursts.length - 1; i >= 0; i--) {
+      const burst = _bursts[i];
+      burst.life += delta;
+      const t = burst.life / burst.maxLife;
+
+      if (t >= 1.0) {
+        _removeBurst(i);
+        continue;
+      }
+
+      const pos = burst.points.geometry.attributes.position.array;
+      for (let j = 0; j < MAX_BURST_PARTICLES; j++) {
+        pos[j * 3]     += burst.velocities[j * 3] * delta;
+        pos[j * 3 + 1] += burst.velocities[j * 3 + 1] * delta;
+        pos[j * 3 + 2] += burst.velocities[j * 3 + 2] * delta;
+
+        // Gravity + drag
+        burst.velocities[j * 3 + 1] -= delta * 0.5;
+        burst.velocities[j * 3]     *= 0.98;
+        burst.velocities[j * 3 + 1] *= 0.98;
+        burst.velocities[j * 3 + 2] *= 0.98;
+      }
+      burst.points.geometry.attributes.position.needsUpdate = true;
+      burst.points.material.uniforms.uOpacity.value = 1.0 - t;
+    }
+
+    // Update trails
+    for (let i = _trails.length - 1; i >= 0; i--) {
+      const trail = _trails[i];
+      trail.life += delta;
+      const t = trail.life / trail.maxLife;
+
+      if (t >= 1.0) {
+        _removeTrail(i);
+        continue;
+      }
+
+      const pos = trail.points.geometry.attributes.position.array;
+      for (let j = 0; j < MAX_TRAIL_PARTICLES; j++) {
+        pos[j * 3]     += trail.velocities[j * 3] * delta;
+        pos[j * 3 + 1] += trail.velocities[j * 3 + 1] * delta;
+        pos[j * 3 + 2] += trail.velocities[j * 3 + 2] * delta;
+      }
+      trail.points.geometry.attributes.position.needsUpdate = true;
+      trail.points.material.uniforms.uOpacity.value = 1.0 - t * t;
+    }
+  }
+
+  function getActiveParticleCount() {
+    let total = AMBIENT_COUNT;
+    _bursts.forEach(b => { total += MAX_BURST_PARTICLES; });
+    _trails.forEach(t => { total += MAX_TRAIL_PARTICLES; });
+    return total;
+  }
+
+  return {
+    init,
+    onMemoryPlaced,
+    onMemoryAccessed,
+    update,
+    getActiveParticleCount,
+  };
+})();
+
+export { MemoryParticles };

nexus/components/spatial-memory.js

@@ -133,6 +133,9 @@ const SpatialMemory = (() => {
   let _regionMarkers = {};
   let _memoryObjects = {};
   let _connectionLines = [];
+  let _entityLines = [];      // entity resolution lines (issue #1167)
+  let _camera = null;         // set by setCamera() for LOD culling
+  const ENTITY_LOD_DIST = 50; // hide entity lines when camera > this from midpoint
   let _initialized = false;
 
   // ─── CRYSTAL GEOMETRY (persistent memories) ───────────
@@ -206,7 +209,83 @@ const SpatialMemory = (() => {
     sprite.scale.set(4, 1, 1);
     _scene.add(sprite);
 
-    return { ring, disc, glowDisc, sprite };
+  
+  // ─── BULK IMPORT (WebSocket sync) ───────────────────
+  /**
+   * Import an array of memories in batch — for WebSocket sync.
+   * Skips duplicates (same id). Returns count of newly placed.
+   * @param {Array} memories - Array of memory objects { id, content, category, ... }
+   * @returns {number} Count of newly placed memories
+   */
+  function importMemories(memories) {
+    if (!Array.isArray(memories) || memories.length === 0) return 0;
+    let count = 0;
+    memories.forEach(mem => {
+      if (mem.id && !_memoryObjects[mem.id]) {
+        placeMemory(mem);
+        count++;
+      }
+    });
+    if (count > 0) {
+      _dirty = true;
+      saveToStorage();
+      console.info('[Mnemosyne] Bulk imported', count, 'new memories (total:', Object.keys(_memoryObjects).length, ')');
+    }
+    return count;
+  }
+
+  // ─── UPDATE MEMORY ──────────────────────────────────
+  /**
+   * Update an existing memory's visual properties (strength, connections).
+   * Does not move the crystal — only updates metadata and re-renders.
+   * @param {string} memId - Memory ID to update
+   * @param {object} updates - Fields to update: { strength, connections, content }
+   * @returns {boolean} True if updated
+   */
+  function updateMemory(memId, updates) {
+    const obj = _memoryObjects[memId];
+    if (!obj) return false;
+
+    if (updates.strength != null) {
+      const strength = Math.max(0.05, Math.min(1, updates.strength));
+      obj.mesh.userData.strength = strength;
+      obj.mesh.material.emissiveIntensity = 1.5 * strength;
+      obj.mesh.material.opacity = 0.5 + strength * 0.4;
+    }
+    if (updates.content != null) {
+      obj.data.content = updates.content;
+    }
+    if (updates.connections != null) {
+      obj.data.connections = updates.connections;
+      // Rebuild connection lines
+      _rebuildConnections(memId);
+    }
+    _dirty = true;
+    saveToStorage();
+    return true;
+  }
+
+  function _rebuildConnections(memId) {
+    // Remove existing lines for this memory
+    for (let i = _connectionLines.length - 1; i >= 0; i--) {
+      const line = _connectionLines[i];
+      if (line.userData.from === memId || line.userData.to === memId) {
+        if (line.parent) line.parent.remove(line);
+        line.geometry.dispose();
+        line.material.dispose();
+        _connectionLines.splice(i, 1);
+      }
+    }
+    // Recreate lines for current connections
+    const obj = _memoryObjects[memId];
+    if (!obj || !obj.data.connections) return;
+    obj.data.connections.forEach(targetId => {
+      const target = _memoryObjects[targetId];
+      if (target) _createConnectionLine(obj, target);
+    });
+  }
+
+  return { ring, disc, glowDisc, sprite };
   }
 
   // ─── PLACE A MEMORY ──────────────────────────────────
@@ -252,6 +331,10 @@ const SpatialMemory = (() => {
       _drawConnections(mem.id, mem.connections);
     }
 
+    if (mem.entity) {
+      _drawEntityLines(mem.id, mem);
+    }
+
     _dirty = true;
     saveToStorage();
     console.info('[Mnemosyne] Spatial memory placed:', mem.id, 'in', region.label);
@@ -298,6 +381,77 @@ const SpatialMemory = (() => {
     });
   }
 
+  // ─── ENTITY RESOLUTION LINES (#1167) ──────────────────
+  // Draw lines between crystals that share an entity or are related entities.
+  // Same entity → thin blue line. Related entities → thin purple dashed line.
+  function _drawEntityLines(memId, mem) {
+    if (!mem.entity) return;
+    const src = _memoryObjects[memId];
+    if (!src) return;
+
+    Object.entries(_memoryObjects).forEach(([otherId, other]) => {
+      if (otherId === memId) return;
+      const otherData = other.data;
+      if (!otherData.entity) return;
+
+      let lineType = null;
+      if (otherData.entity === mem.entity) {
+        lineType = 'same_entity';
+      } else if (mem.related_entities && mem.related_entities.includes(otherData.entity)) {
+        lineType = 'related';
+      } else if (otherData.related_entities && otherData.related_entities.includes(mem.entity)) {
+        lineType = 'related';
+      }
+      if (!lineType) return;
+
+      // Deduplicate — only draw from lower ID to higher
+      if (memId > otherId) return;
+
+      const points = [src.mesh.position.clone(), other.mesh.position.clone()];
+      const geo = new THREE.BufferGeometry().setFromPoints(points);
+      let mat;
+      if (lineType === 'same_entity') {
+        mat = new THREE.LineBasicMaterial({ color: 0x4488ff, transparent: true, opacity: 0.35 });
+      } else {
+        mat = new THREE.LineDashedMaterial({ color: 0x9966ff, dashSize: 0.3, gapSize: 0.2, transparent: true, opacity: 0.25 });
+        const line = new THREE.Line(geo, mat);
+        line.computeLineDistances();
+        line.userData = { type: 'entity_line', from: memId, to: otherId, lineType };
+        _scene.add(line);
+        _entityLines.push(line);
+        return;
+      }
+      const line = new THREE.Line(geo, mat);
+      line.userData = { type: 'entity_line', from: memId, to: otherId, lineType };
+      _scene.add(line);
+      _entityLines.push(line);
+    });
+  }
+
+  function _updateEntityLines() {
+    if (!_camera) return;
+    const camPos = _camera.position;
+
+    _entityLines.forEach(line => {
+      // Compute midpoint of line
+      const posArr = line.geometry.attributes.position.array;
+      const mx = (posArr[0] + posArr[3]) / 2;
+      const my = (posArr[1] + posArr[4]) / 2;
+      const mz = (posArr[2] + posArr[5]) / 2;
+      const dist = camPos.distanceTo(new THREE.Vector3(mx, my, mz));
+
+      if (dist > ENTITY_LOD_DIST) {
+        line.visible = false;
+      } else {
+        line.visible = true;
+        // Fade based on distance
+        const fade = Math.max(0, 1 - (dist / ENTITY_LOD_DIST));
+        const baseOpacity = line.userData.lineType === 'same_entity' ? 0.35 : 0.25;
+        line.material.opacity = baseOpacity * fade;
+      }
+    });
+  }
+
   // ─── REMOVE A MEMORY ─────────────────────────────────
   function removeMemory(memId) {
     const obj = _memoryObjects[memId];
@@ -317,6 +471,16 @@ const SpatialMemory = (() => {
       }
     }
 
+    for (let i = _entityLines.length - 1; i >= 0; i--) {
+      const line = _entityLines[i];
+      if (line.userData.from === memId || line.userData.to === memId) {
+        if (line.parent) line.parent.remove(line);
+        line.geometry.dispose();
+        line.material.dispose();
+        _entityLines.splice(i, 1);
+      }
+    }
+
     delete _memoryObjects[memId];
     _dirty = true;
     saveToStorage();
@@ -342,6 +506,8 @@ const SpatialMemory = (() => {
       }
     });
 
+      _updateEntityLines();
+
     Object.values(_regionMarkers).forEach(marker => {
       if (marker.ring && marker.ring.material) {
         marker.ring.material.opacity = 0.1 + Math.sin(now * 0.001) * 0.05;
@@ -652,95 +818,18 @@ const SpatialMemory = (() => {
     return _selectedId;
   }
 
-  // ─── FILE EXPORT ──────────────────────────────────────
-  function exportToFile() {
-    const index = exportIndex();
-    const json = JSON.stringify(index, null, 2);
-    const date = new Date().toISOString().slice(0, 10);
-    const filename = 'mnemosyne-export-' + date + '.json';
-
-    const blob = new Blob([json], { type: 'application/json' });
-    const url = URL.createObjectURL(blob);
-    const a = document.createElement('a');
-    a.href = url;
-    a.download = filename;
-    document.body.appendChild(a);
-    a.click();
-    document.body.removeChild(a);
-    URL.revokeObjectURL(url);
-
-    console.info('[Mnemosyne] Exported', index.memories.length, 'memories to', filename);
-    return { filename, count: index.memories.length };
-  }
-
-  // ─── FILE IMPORT ──────────────────────────────────────
-  function importFromFile(file) {
-    return new Promise((resolve, reject) => {
-      if (!file) {
-        reject(new Error('No file provided'));
-        return;
-      }
-
-      const reader = new FileReader();
-      reader.onload = function(e) {
-        try {
-          const data = JSON.parse(e.target.result);
-
-          // Schema validation
-          if (!data || typeof data !== 'object') {
-            reject(new Error('Invalid JSON: not an object'));
-            return;
-          }
-          if (typeof data.version !== 'number') {
-            reject(new Error('Invalid schema: missing version field'));
-            return;
-          }
-          if (data.version !== STORAGE_VERSION) {
-            reject(new Error('Version mismatch: got ' + data.version + ', expected ' + STORAGE_VERSION));
-            return;
-          }
-          if (!Array.isArray(data.memories)) {
-            reject(new Error('Invalid schema: memories is not an array'));
-            return;
-          }
-
-          // Validate each memory entry
-          for (let i = 0; i < data.memories.length; i++) {
-            const mem = data.memories[i];
-            if (!mem.id || typeof mem.id !== 'string') {
-              reject(new Error('Invalid memory at index ' + i + ': missing or invalid id'));
-              return;
-            }
-            if (!mem.category || typeof mem.category !== 'string') {
-              reject(new Error('Invalid memory "' + mem.id + '": missing category'));
-              return;
-            }
-          }
-
-          const count = importIndex(data);
-          saveToStorage();
-          console.info('[Mnemosyne] Imported', count, 'memories from file');
-          resolve({ count, total: data.memories.length });
-        } catch (parseErr) {
-          reject(new Error('Failed to parse JSON: ' + parseErr.message));
-        }
-      };
-
-      reader.onerror = function() {
-        reject(new Error('Failed to read file'));
-      };
-
-      reader.readAsText(file);
-    });
+  // ─── CAMERA REFERENCE (for entity line LOD) ─────────
+  function setCamera(camera) {
+    _camera = camera;
   }
 
   return {
-    init, placeMemory, removeMemory, update,
+    init, placeMemory, removeMemory, update, importMemories, updateMemory,
     getMemoryAtPosition, getRegionAtPosition, getMemoriesInRegion, getAllMemories,
     getCrystalMeshes, getMemoryFromMesh, highlightMemory, clearHighlight, getSelectedId,
-    exportIndex, importIndex, exportToFile, importFromFile, searchNearby, REGIONS,
+    exportIndex, importIndex, searchNearby, REGIONS,
     saveToStorage, loadFromStorage, clearStorage,
-    runGravityLayout
+    runGravityLayout, setCamera
   };
 })();
 

nexus/components/timeline-scrubber.js

@@ -0,0 +1,205 @@
+// ═══════════════════════════════════════════
+//  PROJECT MNEMOSYNE — TIMELINE SCRUBBER
+// ═══════════════════════════════════════════
+//
+// Horizontal timeline bar overlay for scrolling through fact history.
+// Crystals outside the visible time window fade out.
+//
+// Issue: #1169
+// ═══════════════════════════════════════════
+
+const TimelineScrubber = (() => {
+  let _container = null;
+  let _bar = null;
+  let _handle = null;
+  let _labels = null;
+  let _spatialMemory = null;
+  let _rangeStart = 0;       // 0-1 normalized
+  let _rangeEnd = 1;         // 0-1 normalized
+  let _minTimestamp = null;
+  let _maxTimestamp = null;
+  let _active = false;
+
+  const PRESETS = {
+    'hour': { label: 'Last Hour', ms: 3600000 },
+    'day':  { label: 'Last Day', ms: 86400000 },
+    'week': { label: 'Last Week', ms: 604800000 },
+    'all':  { label: 'All Time', ms: Infinity }
+  };
+
+  // ─── INIT ──────────────────────────────────────────
+  function init(spatialMemory) {
+    _spatialMemory = spatialMemory;
+    _buildDOM();
+    _computeTimeRange();
+    console.info('[Mnemosyne] Timeline scrubber initialized');
+  }
+
+  function _buildDOM() {
+    _container = document.createElement('div');
+    _container.id = 'mnemosyne-timeline';
+    _container.style.cssText = `
+      position: fixed; bottom: 0; left: 0; right: 0; height: 48px;
+      background: rgba(5, 5, 16, 0.85); border-top: 1px solid #1a2a4a;
+      z-index: 1000; display: flex; align-items: center; padding: 0 16px;
+      font-family: monospace; font-size: 12px; color: #8899aa;
+      backdrop-filter: blur(8px); transition: opacity 0.3s;
+    `;
+
+    // Preset buttons
+    const presetDiv = document.createElement('div');
+    presetDiv.style.cssText = 'display: flex; gap: 8px; margin-right: 16px;';
+    Object.entries(PRESETS).forEach(([key, preset]) => {
+      const btn = document.createElement('button');
+      btn.textContent = preset.label;
+      btn.style.cssText = `
+        background: #0a0f28; border: 1px solid #1a2a4a; color: #4af0c0;
+        padding: 4px 8px; cursor: pointer; font-family: monospace; font-size: 11px;
+        border-radius: 3px; transition: background 0.2s;
+      `;
+      btn.onmouseenter = () => btn.style.background = '#1a2a4a';
+      btn.onmouseleave = () => btn.style.background = '#0a0f28';
+      btn.onclick = () => _applyPreset(key);
+      presetDiv.appendChild(btn);
+    });
+    _container.appendChild(presetDiv);
+
+    // Timeline bar
+    _bar = document.createElement('div');
+    _bar.style.cssText = `
+      flex: 1; height: 20px; background: #0a0f28; border: 1px solid #1a2a4a;
+      border-radius: 3px; position: relative; cursor: pointer; margin: 0 8px;
+    `;
+
+    // Handle (draggable range selector)
+    _handle = document.createElement('div');
+    _handle.style.cssText = `
+      position: absolute; top: 0; left: 0%; width: 100%; height: 100%;
+      background: rgba(74, 240, 192, 0.15); border-left: 2px solid #4af0c0;
+      border-right: 2px solid #4af0c0; cursor: ew-resize;
+    `;
+    _bar.appendChild(_handle);
+    _container.appendChild(_bar);
+
+    // Labels
+    _labels = document.createElement('div');
+    _labels.style.cssText = 'min-width: 200px; text-align: right; font-size: 11px;';
+    _labels.textContent = 'All Time';
+    _container.appendChild(_labels);
+
+    // Drag handling
+    let dragging = null;
+    _handle.addEventListener('mousedown', (e) => {
+      dragging = { startX: e.clientX, startLeft: parseFloat(_handle.style.left) || 0, startWidth: parseFloat(_handle.style.width) || 100 };
+      e.preventDefault();
+    });
+    document.addEventListener('mousemove', (e) => {
+      if (!dragging) return;
+      const barRect = _bar.getBoundingClientRect();
+      const dx = (e.clientX - dragging.startX) / barRect.width * 100;
+      let newLeft = Math.max(0, Math.min(100 - dragging.startWidth, dragging.startLeft + dx));
+      _handle.style.left = newLeft + '%';
+      _rangeStart = newLeft / 100;
+      _rangeEnd = (newLeft + dragging.startWidth) / 100;
+      _applyFilter();
+    });
+    document.addEventListener('mouseup', () => { dragging = null; });
+
+    document.body.appendChild(_container);
+  }
+
+  function _computeTimeRange() {
+    if (!_spatialMemory) return;
+    const memories = _spatialMemory.getAllMemories();
+    if (memories.length === 0) return;
+
+    let min = Infinity, max = -Infinity;
+    memories.forEach(m => {
+      const t = new Date(m.timestamp || 0).getTime();
+      if (t < min) min = t;
+      if (t > max) max = t;
+    });
+    _minTimestamp = min;
+    _maxTimestamp = max;
+  }
+
+  function _applyPreset(key) {
+    const preset = PRESETS[key];
+    if (!preset) return;
+
+    if (preset.ms === Infinity) {
+      _rangeStart = 0;
+      _rangeEnd = 1;
+    } else {
+      const now = Date.now();
+      const range = _maxTimestamp - _minTimestamp;
+      if (range <= 0) return;
+      const cutoff = now - preset.ms;
+      _rangeStart = Math.max(0, (cutoff - _minTimestamp) / range);
+      _rangeEnd = 1;
+    }
+
+    _handle.style.left = (_rangeStart * 100) + '%';
+    _handle.style.width = ((_rangeEnd - _rangeStart) * 100) + '%';
+    _labels.textContent = preset.label;
+    _applyFilter();
+  }
+
+  function _applyFilter() {
+    if (!_spatialMemory) return;
+    const range = _maxTimestamp - _minTimestamp;
+    if (range <= 0) return;
+
+    const startMs = _minTimestamp + range * _rangeStart;
+    const endMs = _minTimestamp + range * _rangeEnd;
+
+    _spatialMemory.getCrystalMeshes().forEach(mesh => {
+      const ts = new Date(mesh.userData.createdAt || 0).getTime();
+      if (ts >= startMs && ts <= endMs) {
+        mesh.visible = true;
+        // Smooth restore
+        if (mesh.material) mesh.material.opacity = mesh.userData._savedOpacity || mesh.material.opacity;
+      } else {
+        // Fade out
+        if (mesh.material) {
+          mesh.userData._savedOpacity = mesh.userData._savedOpacity || mesh.material.opacity;
+          mesh.material.opacity = 0.02;
+        }
+      }
+    });
+
+    // Update label with date range
+    const startStr = new Date(startMs).toLocaleDateString();
+    const endStr = new Date(endMs).toLocaleDateString();
+    _labels.textContent = startStr + ' — ' + endStr;
+  }
+
+  function update() {
+    _computeTimeRange();
+  }
+
+  function show() {
+    if (_container) _container.style.display = 'flex';
+    _active = true;
+  }
+
+  function hide() {
+    if (_container) _container.style.display = 'none';
+    _active = false;
+    // Restore all crystals
+    if (_spatialMemory) {
+      _spatialMemory.getCrystalMeshes().forEach(mesh => {
+        mesh.visible = true;
+        if (mesh.material && mesh.userData._savedOpacity) {
+          mesh.material.opacity = mesh.userData._savedOpacity;
+        }
+      });
+    }
+  }
+
+  function isActive() { return _active; }
+
+  return { init, update, show, hide, isActive };
+})();
+
+export { TimelineScrubber };

provenance.json

@@ -0,0 +1,62 @@
+{
+  "generated_at": "2026-04-11T01:14:54.632326+00:00",
+  "repo": "Timmy_Foundation/the-nexus",
+  "git": {
+    "commit": "d408d2c365a9efc0c1e3a9b38b9cc4eed75695c5",
+    "branch": "mimo/build/issue-686",
+    "remote": "https://forge.alexanderwhitestone.com/Timmy_Foundation/the-nexus.git",
+    "dirty": true
+  },
+  "files": {
+    "index.html": {
+      "sha256": "71ba27afe8b6b42a09efe09d2b3017599392ddc3bc02543b31c2277dfb0b82cc",
+      "size": 25933
+    },
+    "app.js": {
+      "sha256": "2b765a724a0fcda29abd40ba921bc621d2699f11d0ba14cf1579cbbdafdc5cd5",
+      "size": 132902
+    },
+    "style.css": {
+      "sha256": "cd3068d03eed6f52a00bbc32cfae8fba4739b8b3cb194b3ec09fd747a075056d",
+      "size": 44198
+    },
+    "gofai_worker.js": {
+      "sha256": "d292f110aa12a8aa2b16b0c2d48e5b4ce24ee15b1cffb409ab846b1a05a91de2",
+      "size": 969
+    },
+    "server.py": {
+      "sha256": "e963cc9715accfc8814e3fe5c44af836185d66740d5a65fd0365e9c629d38e05",
+      "size": 4185
+    },
+    "portals.json": {
+      "sha256": "889a5e0f724eb73a95f960bca44bca232150bddff7c1b11f253bd056f3683a08",
+      "size": 3442
+    },
+    "vision.json": {
+      "sha256": "0e3b5c06af98486bbcb2fc2dc627dc8b7b08aed4c3a4f9e10b57f91e1e8ca6ad",
+      "size": 1658
+    },
+    "manifest.json": {
+      "sha256": "352304c4f7746f5d31cbc223636769969dd263c52800645c01024a3a8489d8c9",
+      "size": 495
+    },
+    "nexus/components/spatial-memory.js": {
+      "sha256": "60170f6490ddd743acd6d285d3a1af6cad61fbf8aaef3f679ff4049108eac160",
+      "size": 32782
+    },
+    "nexus/components/session-rooms.js": {
+      "sha256": "9997a60dda256e38cb4645508bf9e98c15c3d963b696e0080e3170a9a7fa7cf1",
+      "size": 15113
+    },
+    "nexus/components/timeline-scrubber.js": {
+      "sha256": "f8a17762c2735be283dc5074b13eb00e1e3b2b04feb15996c2cf0323b46b6014",
+      "size": 7177
+    },
+    "nexus/components/memory-particles.js": {
+      "sha256": "1be5567a3ebb229f9e1a072c08a25387ade87cb4a1df6a624e5c5254d3bef8fa",
+      "size": 14216
+    }
+  },
+  "missing": [],
+  "file_count": 12
+}

scripts/guardrails.sh

@@ -0,0 +1,27 @@
+#!/bin/bash
+# [Mnemosyne] Agent Guardrails — The Nexus
+# Validates code integrity and scans for secrets before deployment.
+
+echo "--- [Mnemosyne] Running Guardrails ---"
+
+# 1. Syntax Checks
+echo "[1/3] Validating syntax..."
+for f in ; do
+  node --check "$f" || { echo "Syntax error in $f"; exit 1; }
+done
+echo "Syntax OK."
+
+# 2. JSON/YAML Validation
+echo "[2/3] Validating configs..."
+for f in ; do
+  node -e "JSON.parse(require('fs').readFileSync('$f'))" || { echo "Invalid JSON: $f"; exit 1; }
+done
+echo "Configs OK."
+
+# 3. Secret Scan
+echo "[3/3] Scanning for secrets..."
+grep -rE "AI_|TOKEN|KEY|SECRET" . --exclude-dir=node_modules --exclude=guardrails.sh | grep -v "process.env" && {
+  echo "WARNING: Potential secrets found!"
+} || echo "No secrets detected."
+
+echo "--- Guardrails Passed ---"

scripts/smoke.mjs

@@ -0,0 +1,26 @@
+/**
+ * [Mnemosyne] Smoke Test — The Nexus
+ * Verifies core components are loadable and basic state is consistent.
+ */
+
+import { SpatialMemory } from '../nexus/components/spatial-memory.js';
+import { MemoryOptimizer } from '../nexus/components/memory-optimizer.js';
+
+console.log('--- [Mnemosyne] Running Smoke Test ---');
+
+// 1. Verify Components
+if (!SpatialMemory || !MemoryOptimizer) {
+  console.error('Failed to load core components');
+  process.exit(1);
+}
+console.log('Components loaded.');
+
+// 2. Verify Regions
+const regions = Object.keys(SpatialMemory.REGIONS || {});
+if (regions.length < 5) {
+  console.error('SpatialMemory regions incomplete:', regions);
+  process.exit(1);
+}
+console.log('Regions verified:', regions.join(', '));
+
+console.log('--- Smoke Test Passed ---');

style.css

@@ -200,61 +200,6 @@ canvas#nexus-canvas {
   box-shadow: 0 0 20px var(--color-primary);
 }
 
-/* === TOOLTIP SYSTEM === */
-/* Any element with data-tooltip gets a hover tooltip label */
-[data-tooltip] {
-  position: relative;
-}
-[data-tooltip]::after {
-  content: attr(data-tooltip);
-  position: absolute;
-  right: calc(100% + 10px);
-  top: 50%;
-  transform: translateY(-50%);
-  background: rgba(5, 5, 16, 0.95);
-  color: var(--color-primary);
-  font-family: var(--font-body);
-  font-size: 11px;
-  letter-spacing: 0.05em;
-  padding: 4px 10px;
-  border: 1px solid var(--color-primary-dim);
-  border-radius: 4px;
-  white-space: nowrap;
-  pointer-events: none;
-  opacity: 0;
-  transition: opacity 0.2s ease;
-  backdrop-filter: blur(8px);
-  box-shadow: 0 0 12px rgba(74, 240, 192, 0.15);
-  z-index: 100;
-}
-[data-tooltip]:hover::after,
-[data-tooltip]:focus-visible::after {
-  opacity: 1;
-}
-/* For elements positioned on the right side, tooltip appears to the left */
-.hud-top-right [data-tooltip]::after {
-  right: calc(100% + 10px);
-}
-/* For inline/badge elements where right-side tooltip might clip */
-.hud-status-item[data-tooltip]::after {
-  right: auto;
-  left: calc(100% + 10px);
-}
-
-/* Focus-visible ring for keyboard navigation */
-.hud-icon-btn:focus-visible,
-.hud-status-item:focus-visible,
-.atlas-close-btn:focus-visible,
-.vision-close-btn:focus-visible,
-.portal-close-btn:focus-visible,
-.memory-panel-close:focus-visible,
-.memory-panel-pin:focus-visible,
-.session-room-close:focus-visible {
-  outline: 2px solid var(--color-primary);
-  outline-offset: 2px;
-  box-shadow: 0 0 16px rgba(74, 240, 192, 0.4);
-}
-
 .hud-status-item {
   display: flex;
   align-items: center;
@@ -422,142 +367,6 @@ canvas#nexus-canvas {
 .status-online { background: rgba(74, 240, 192, 0.2); color: var(--color-primary); border: 1px solid var(--color-primary); }
 .status-standby { background: rgba(255, 215, 0, 0.2); color: var(--color-gold); border: 1px solid var(--color-gold); }
 .status-offline { background: rgba(255, 68, 102, 0.2); color: var(--color-danger); border: 1px solid var(--color-danger); }
-.status-active { background: rgba(74, 240, 192, 0.2); color: var(--color-primary); border: 1px solid var(--color-primary); }
-.status-blocked { background: rgba(255, 68, 102, 0.3); color: #ff4466; border: 1px solid #ff4466; }
-.status-downloaded { background: rgba(100, 149, 237, 0.2); color: #6495ed; border: 1px solid #6495ed; }
-.status-runtime_ready { background: rgba(255, 165, 0, 0.2); color: #ffa500; border: 1px solid #ffa500; }
-.status-launched { background: rgba(255, 215, 0, 0.2); color: var(--color-gold); border: 1px solid var(--color-gold); }
-.status-harness_bridged { background: rgba(74, 240, 192, 0.2); color: var(--color-primary); border: 1px solid var(--color-primary); }
-
-/* Readiness Progress Bar (atlas card) */
-.atlas-card-readiness {
-  margin-top: 10px;
-  padding-top: 10px;
-  border-top: 1px solid rgba(255,255,255,0.06);
-}
-.readiness-bar-track {
-  width: 100%;
-  height: 4px;
-  background: rgba(255,255,255,0.08);
-  border-radius: 2px;
-  overflow: hidden;
-  margin-bottom: 6px;
-}
-.readiness-bar-fill {
-  height: 100%;
-  border-radius: 2px;
-  transition: width 0.4s ease;
-}
-.readiness-steps-mini {
-  display: flex;
-  gap: 6px;
-  font-size: 9px;
-  font-family: var(--font-body);
-  letter-spacing: 0.05em;
-  color: var(--color-text-muted);
-}
-.readiness-step {
-  padding: 1px 5px;
-  border-radius: 2px;
-  background: rgba(255,255,255,0.04);
-}
-.readiness-step.done {
-  background: rgba(74, 240, 192, 0.15);
-  color: var(--color-primary);
-}
-.readiness-step.current {
-  background: rgba(255, 215, 0, 0.15);
-  color: var(--color-gold);
-}
-.atlas-card-blocked {
-  margin-top: 6px;
-  font-size: 10px;
-  color: #ff4466;
-  font-family: var(--font-body);
-}
-
-/* Readiness Detail (portal overlay) */
-.portal-readiness-detail {
-  margin-top: 16px;
-  padding: 12px 16px;
-  background: rgba(0,0,0,0.3);
-  border: 1px solid rgba(255,255,255,0.08);
-  border-radius: 4px;
-}
-.portal-readiness-title {
-  font-family: var(--font-display);
-  font-size: 10px;
-  letter-spacing: 0.15em;
-  color: var(--color-text-muted);
-  margin-bottom: 10px;
-  text-transform: uppercase;
-}
-.portal-readiness-step {
-  display: flex;
-  align-items: center;
-  gap: 8px;
-  padding: 4px 0;
-  font-family: var(--font-body);
-  font-size: 11px;
-  color: rgba(255,255,255,0.4);
-}
-.portal-readiness-step .step-dot {
-  width: 8px;
-  height: 8px;
-  border-radius: 50%;
-  background: rgba(255,255,255,0.15);
-  flex-shrink: 0;
-}
-.portal-readiness-step.done .step-dot {
-  background: var(--color-primary);
-  box-shadow: 0 0 6px var(--color-primary);
-}
-.portal-readiness-step.done {
-  color: var(--color-primary);
-}
-.portal-readiness-step.current .step-dot {
-  background: var(--color-gold);
-  box-shadow: 0 0 6px var(--color-gold);
-  animation: pulse-dot 1.5s ease-in-out infinite;
-}
-.portal-readiness-step.current {
-  color: #fff;
-}
-@keyframes pulse-dot {
-  0%, 100% { opacity: 1; }
-  50% { opacity: 0.4; }
-}
-.portal-readiness-blocked {
-  margin-top: 8px;
-  padding: 6px 10px;
-  background: rgba(255, 68, 102, 0.1);
-  border: 1px solid rgba(255, 68, 102, 0.3);
-  border-radius: 3px;
-  font-size: 11px;
-  color: #ff4466;
-  font-family: var(--font-body);
-}
-.portal-readiness-hint {
-  margin-top: 8px;
-  font-size: 10px;
-  color: var(--color-text-muted);
-  font-family: var(--font-body);
-  font-style: italic;
-}
-
-/* HUD Status for readiness states */
-.hud-status-item.downloaded .status-dot { background: #6495ed; box-shadow: 0 0 5px #6495ed; }
-.hud-status-item.runtime_ready .status-dot { background: #ffa500; box-shadow: 0 0 5px #ffa500; }
-.hud-status-item.launched .status-dot { background: var(--color-gold); box-shadow: 0 0 5px var(--color-gold); }
-.hud-status-item.harness_bridged .status-dot { background: var(--color-primary); box-shadow: 0 0 5px var(--color-primary); }
-.hud-status-item.blocked .status-dot { background: #ff4466; box-shadow: 0 0 5px #ff4466; }
-.hud-status-item.downloaded .status-label,
-.hud-status-item.runtime_ready .status-label,
-.hud-status-item.launched .status-label,
-.hud-status-item.harness_bridged .status-label,
-.hud-status-item.blocked .status-label {
-  color: #fff;
-}
 
 .atlas-card-desc {
   font-size: 12px;
@@ -1174,7 +983,7 @@ canvas#nexus-canvas {
 
 .chat-quick-actions {
   display: flex;
-  flex-direction: column;
+  flex-wrap: wrap;
   gap: 6px;
   padding: 8px 12px;
   border-top: 1px solid var(--color-border);
@@ -1182,75 +991,6 @@ canvas#nexus-canvas {
   pointer-events: auto;
 }
 
-.chat-quick-actions.hidden {
-  display: none;
-}
-
-.starter-label {
-  font-family: var(--font-display);
-  font-size: 9px;
-  letter-spacing: 0.15em;
-  color: var(--color-primary-dim);
-  text-transform: uppercase;
-  padding: 0 2px;
-}
-
-.starter-grid {
-  display: grid;
-  grid-template-columns: repeat(3, 1fr);
-  gap: 4px;
-}
-
-.starter-btn {
-  display: flex;
-  flex-direction: column;
-  align-items: flex-start;
-  gap: 1px;
-  background: rgba(74, 240, 192, 0.06);
-  border: 1px solid rgba(74, 240, 192, 0.15);
-  color: var(--color-primary);
-  font-family: var(--font-body);
-  padding: 6px 8px;
-  cursor: pointer;
-  transition: all var(--transition-ui);
-  text-align: left;
-}
-
-.starter-btn:hover {
-  background: rgba(74, 240, 192, 0.15);
-  border-color: var(--color-primary);
-  color: #fff;
-}
-
-.starter-btn:hover .starter-icon {
-  color: #fff;
-}
-
-.starter-btn:active {
-  transform: scale(0.97);
-}
-
-.starter-icon {
-  font-size: 12px;
-  color: var(--color-primary);
-  line-height: 1;
-}
-
-.starter-text {
-  font-size: 10px;
-  font-weight: 600;
-  white-space: nowrap;
-}
-
-.starter-desc {
-  font-size: 8px;
-  color: rgba(74, 240, 192, 0.5);
-  white-space: nowrap;
-  overflow: hidden;
-  text-overflow: ellipsis;
-  max-width: 100%;
-}
-
 /* Add hover effect for MemPalace mining button */
 .quick-action-btn:hover {
   background: var(--color-primary-dim);
@@ -1396,9 +1136,6 @@ canvas#nexus-canvas {
   .hud-location {
     font-size: var(--text-xs);
   }
-  .starter-grid {
-    grid-template-columns: repeat(2, 1fr);
-  }
 }
 
 @media (max-width: 480px) {
@@ -1487,396 +1224,325 @@ canvas#nexus-canvas {
 
 .pse-status { color: #4af0c0; font-weight: 600; }
 
-
 /* ═══════════════════════════════════════════
-   MNEMOSYNE — MEMORY CRYSTAL INSPECTION PANEL
+   MNEMOSYNE — Memory Activity Feed
    ═══════════════════════════════════════════ */
 
-.memory-panel {
+.memory-feed {
   position: fixed;
-  top: 50%;
-  right: 24px;
-  transform: translateY(-50%);
-  z-index: 120;
-  animation: memoryPanelIn 0.22s ease-out forwards;
-}
-
-.memory-panel-fade-out {
-  animation: memoryPanelOut 0.18s ease-in forwards !important;
-}
-
-@keyframes memoryPanelIn {
-  from { opacity: 0; transform: translateY(-50%) translateX(16px); }
-  to   { opacity: 1; transform: translateY(-50%) translateX(0); }
-}
-
-@keyframes memoryPanelOut {
-  from { opacity: 1; }
-  to   { opacity: 0; transform: translateY(-50%) translateX(12px); }
-}
-
-.memory-panel-content {
-  width: 340px;
-  background: rgba(8, 8, 24, 0.92);
-  backdrop-filter: blur(12px);
+  bottom: 20px;
+  left: 20px;
+  width: 320px;
+  background: rgba(10, 15, 40, 0.92);
   border: 1px solid rgba(74, 240, 192, 0.25);
-  border-radius: 12px;
-  padding: 16px;
-  box-shadow: 0 0 30px rgba(74, 240, 192, 0.08), 0 8px 32px rgba(0, 0, 0, 0.4);
+  border-radius: 10px;
+  backdrop-filter: blur(12px);
+  -webkit-backdrop-filter: blur(12px);
+  z-index: 900;
+  font-family: 'JetBrains Mono', monospace;
+  animation: memoryFeedIn 0.3s ease-out;
 }
 
-.memory-panel-header {
+@keyframes memoryFeedIn {
+  from { opacity: 0; transform: translateY(10px); }
+  to { opacity: 1; transform: translateY(0); }
+}
+
+.memory-feed-header {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  padding: 8px 12px;
+  border-bottom: 1px solid rgba(74, 240, 192, 0.15);
+}
+
+.memory-feed-title {
+  color: #4af0c0;
+  font-size: 12px;
+  font-weight: 600;
+  letter-spacing: 0.5px;
+}
+
+
+.memory-feed-actions {
+  display: flex;
+  gap: 8px;
+  align-items: center;
+}
+
+.memory-feed-clear {
+  background: rgba(74, 240, 192, 0.1);
+  border: 1px solid rgba(74, 240, 192, 0.3);
+  color: #4af0c0;
+  font-size: 10px;
+  padding: 2px 6px;
+  border-radius: 4px;
+  cursor: pointer;
+  transition: all 0.2s;
+  font-family: inherit;
+}
+.memory-feed-clear:hover {
+  background: rgba(74, 240, 192, 0.2);
+  border-color: #4af0c0;
+}
+
+.memory-feed-toggle {
+  background: none;
+  border: none;
+  color: rgba(255, 255, 255, 0.4);
+  cursor: pointer;
+  font-size: 14px;
+  padding: 0 4px;
+}
+.memory-feed-toggle:hover { color: #fff; }
+
+.memory-feed-list {
+  max-height: 200px;
+  overflow-y: auto;
+  padding: 6px 0;
+}
+
+.memory-feed-entry {
   display: flex;
   align-items: center;
-  gap: 6px;
-  margin-bottom: 10px;
-  padding-bottom: 10px;
-  border-bottom: 1px solid rgba(255, 255, 255, 0.06);
+  gap: 8px;
+  padding: 6px 12px;
+  font-size: 11px;
+  color: rgba(255, 255, 255, 0.75);
+  transition: background 0.2s;
+}
+.memory-feed-entry:hover {
+  background: rgba(255, 255, 255, 0.05);
 }
 
-.memory-panel-region-dot {
-  width: 10px;
-  height: 10px;
+.memory-feed-dot {
+  width: 8px;
+  height: 8px;
   border-radius: 50%;
   flex-shrink: 0;
 }
 
-.memory-panel-region {
-  font-family: var(--font-display, monospace);
-  font-size: 11px;
-  letter-spacing: 0.15em;
-  color: var(--color-primary, #4af0c0);
-  text-transform: uppercase;
+.memory-feed-action {
+  flex-shrink: 0;
+  font-size: 12px;
+}
+
+.memory-feed-content {
   flex: 1;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
 }
 
-.memory-panel-close {
-  background: none;
-  border: 1px solid rgba(255, 255, 255, 0.1);
-  color: var(--color-text-muted, #888);
-  font-size: 14px;
-  cursor: pointer;
-  width: 24px;
-  height: 24px;
-  border-radius: 6px;
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  transition: all 0.15s;
+.memory-feed-time {
+  flex-shrink: 0;
+  color: rgba(255, 255, 255, 0.3);
+  font-size: 10px;
 }
 
-.memory-panel-close:hover {
-  background: rgba(255, 255, 255, 0.05);
-  color: #fff;
-}
+.memory-feed-place { border-left: 2px solid #4af0c0; }
+.memory-feed-remove { border-left: 2px solid #ff4466; }
+.memory-feed-update { border-left: 2px solid #ffd700; }
+.memory-feed-sync { border-left: 2px solid #7b5cff; }
 
-.memory-panel-body {
-  font-size: 14px;
-  line-height: 1.6;
-  color: var(--color-text, #ccc);
-  margin-bottom: 14px;
-  max-height: 120px;
+/* ── Archive Health Dashboard (issue #1210) ─────────────────────────── */
+.archive-health-dashboard {
+  position: fixed;
+  top: 50%;
+  left: 50%;
+  transform: translate(-50%, -50%);
+  width: 420px;
+  max-height: 80vh;
   overflow-y: auto;
-  word-break: break-word;
+  background: rgba(10, 15, 40, 0.95);
+  border: 1px solid rgba(74, 240, 192, 0.35);
+  border-radius: 12px;
+  backdrop-filter: blur(16px);
+  -webkit-backdrop-filter: blur(16px);
+  z-index: 1100;
+  font-family: 'JetBrains Mono', monospace;
+  box-shadow: 0 0 40px rgba(74, 240, 192, 0.12), 0 0 80px rgba(123, 92, 255, 0.08);
+  animation: archiveDashIn 0.25s ease-out;
 }
 
-.memory-panel-meta {
+@keyframes archiveDashIn {
+  from { opacity: 0; transform: translate(-50%, -48%) scale(0.97); }
+  to   { opacity: 1; transform: translate(-50%, -50%) scale(1); }
+}
+
+.archive-health-header {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  padding: 12px 16px;
+  border-bottom: 1px solid rgba(74, 240, 192, 0.2);
+}
+
+.archive-health-title {
+  color: #4af0c0;
+  font-size: 13px;
+  font-weight: 700;
+  letter-spacing: 1.5px;
+  text-transform: uppercase;
+}
+
+.archive-health-close {
+  background: none;
+  border: none;
+  color: rgba(255, 255, 255, 0.4);
+  font-size: 16px;
+  cursor: pointer;
+  padding: 0 4px;
+  line-height: 1;
+  transition: color 0.2s;
+}
+.archive-health-close:hover { color: #fff; }
+
+.archive-health-content {
+  padding: 14px 16px;
   display: flex;
   flex-direction: column;
-  gap: 5px;
-  font-size: 11px;
+  gap: 14px;
 }
 
-.memory-meta-row {
-  display: flex;
-  gap: 8px;
-  align-items: baseline;
-}
-
-.memory-meta-label {
-  color: var(--color-text-muted, #666);
-  text-transform: uppercase;
-  letter-spacing: 0.08em;
-  min-width: 50px;
-  flex-shrink: 0;
-}
-
-.memory-meta-row span:last-child {
-  color: var(--color-text, #aaa);
-  word-break: break-all;
-}
-
-.memory-conn-tag {
-  display: inline-block;
-  background: rgba(74, 240, 192, 0.1);
-  border: 1px solid rgba(74, 240, 192, 0.2);
-  border-radius: 4px;
-  padding: 1px 6px;
+.ah-section-label {
+  color: rgba(255, 255, 255, 0.4);
   font-size: 10px;
-  font-family: var(--font-mono, monospace);
-  color: var(--color-primary, #4af0c0);
-  margin: 1px 2px;
+  letter-spacing: 1.2px;
+  text-transform: uppercase;
+  margin-bottom: 6px;
 }
 
-.memory-conn-link {
-  cursor: pointer;
-  transition: background 0.15s, border-color 0.15s;
+.ah-total {
+  display: flex;
+  align-items: baseline;
+  gap: 8px;
 }
 
-.memory-conn-link:hover {
-  background: rgba(74, 240, 192, 0.22);
-  border-color: rgba(74, 240, 192, 0.5);
-  color: #fff;
-}
-
-/* Entity name — large heading inside panel */
-.memory-entity-name {
-  font-family: var(--font-display, monospace);
-  font-size: 17px;
+.ah-total-count {
+  font-size: 36px;
   font-weight: 700;
-  color: #fff;
-  letter-spacing: 0.04em;
-  margin-bottom: 8px;
-  text-transform: capitalize;
-  word-break: break-word;
+  color: #4af0c0;
+  line-height: 1;
 }
 
-/* Category badge */
-.memory-category-badge {
-  font-family: var(--font-display, monospace);
-  font-size: 9px;
-  letter-spacing: 0.12em;
-  font-weight: 700;
-  padding: 2px 6px;
-  border-radius: 4px;
-  border: 1px solid rgba(74, 240, 192, 0.3);
-  background: rgba(74, 240, 192, 0.12);
-  color: var(--color-primary, #4af0c0);
-  flex-shrink: 0;
+.ah-total-label {
+  font-size: 12px;
+  color: rgba(255, 255, 255, 0.5);
 }
 
-/* Trust score bar */
-.memory-trust-row {
+.ah-category-row {
   display: flex;
   align-items: center;
   gap: 8px;
-  margin-bottom: 12px;
-  font-size: 11px;
+  margin-bottom: 5px;
 }
 
-.memory-trust-bar {
+.ah-cat-dot {
+  width: 10px;
+  height: 10px;
+  border-radius: 2px;
+  flex-shrink: 0;
+}
+
+.ah-cat-label {
+  font-size: 11px;
+  color: rgba(255, 255, 255, 0.7);
   flex: 1;
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+
+.ah-cat-bar-wrap {
+  flex: 2;
   height: 5px;
   background: rgba(255, 255, 255, 0.08);
   border-radius: 3px;
   overflow: hidden;
 }
 
-.memory-trust-fill {
+.ah-cat-bar {
   height: 100%;
   border-radius: 3px;
-  background: var(--color-primary, #4af0c0);
-  transition: width 0.35s ease;
+  transition: width 0.4s ease;
 }
 
-.memory-trust-value {
-  color: var(--color-text-muted, #888);
-  min-width: 32px;
+.ah-cat-count {
+  font-size: 11px;
+  color: rgba(255, 255, 255, 0.45);
+  min-width: 20px;
   text-align: right;
 }
 
-/* Pin button */
-.memory-panel-pin {
-  background: none;
-  border: 1px solid rgba(255, 255, 255, 0.1);
-  color: var(--color-text-muted, #888);
-  font-size: 11px;
-  cursor: pointer;
-  width: 24px;
-  height: 24px;
-  border-radius: 6px;
+.ah-trust-row {
   display: flex;
-  align-items: center;
-  justify-content: center;
-  transition: all 0.15s;
-  flex-shrink: 0;
+  gap: 10px;
 }
 
-.memory-panel-pin:hover {
+.ah-trust-band {
+  flex: 1;
   background: rgba(255, 255, 255, 0.05);
-  color: #fff;
-}
-
-.memory-panel-pin.pinned {
-  background: rgba(74, 240, 192, 0.15);
-  border-color: rgba(74, 240, 192, 0.4);
-  color: var(--color-primary, #4af0c0);
-}
-
-/* Related row — allow wrapping */
-.memory-meta-row--related {
-  align-items: flex-start;
-}
-
-.memory-meta-row--related span:last-child {
-  flex-wrap: wrap;
-  display: flex;
-  gap: 2px;
-}
-
-/* ═══════════════════════════════════════════════════════
-   PROJECT MNEMOSYNE — EXPORT/IMPORT ACTIONS (#1174)
-═══════════════════════════════════════════════════════ */
-
-.memory-panel-actions {
-  display: flex;
-  gap: 8px;
-  margin-top: 10px;
-  padding-top: 10px;
-  border-top: 1px solid rgba(123, 92, 255, 0.15);
-}
-
-.mnemosyne-action-btn {
-  flex: 1;
-  padding: 6px 10px;
-  background: rgba(123, 92, 255, 0.12);
-  border: 1px solid rgba(123, 92, 255, 0.3);
-  border-radius: 6px;
-  color: #a08cff;
-  font-size: 11px;
-  font-family: monospace;
-  cursor: pointer;
-  transition: all 0.15s ease;
+  border-radius: 8px;
+  padding: 8px 10px;
   text-align: center;
-  white-space: nowrap;
 }
 
-.mnemosyne-action-btn:hover {
-  background: rgba(123, 92, 255, 0.25);
-  border-color: rgba(123, 92, 255, 0.6);
-  color: #c4b5ff;
-}
-
-.mnemosyne-action-btn:active {
-  transform: scale(0.96);
-}
-
-/* ═══════════════════════════════════════════════════════
-   PROJECT MNEMOSYNE — SESSION ROOM HUD PANEL (#1171)
-═══════════════════════════════════════════════════════ */
-
-.session-room-panel {
-  position: fixed;
-  bottom: 24px;
-  left: 50%;
-  transform: translateX(-50%);
-  z-index: 125;
-  animation: sessionPanelIn 0.25s ease-out forwards;
-}
-
-.session-room-panel.session-panel-fade-out {
-  animation: sessionPanelOut 0.2s ease-in forwards !important;
-}
-
-@keyframes sessionPanelIn {
-  from { opacity: 0; transform: translateX(-50%) translateY(12px); }
-  to   { opacity: 1; transform: translateX(-50%) translateY(0); }
-}
-
-@keyframes sessionPanelOut {
-  from { opacity: 1; }
-  to   { opacity: 0; transform: translateX(-50%) translateY(10px); }
-}
-
-.session-room-panel-content {
-  min-width: 320px;
-  max-width: 480px;
-  background: rgba(8, 4, 28, 0.93);
-  backdrop-filter: blur(14px);
-  border: 1px solid rgba(123, 92, 255, 0.35);
-  border-radius: 12px;
-  padding: 14px 18px;
-  box-shadow: 0 0 32px rgba(123, 92, 255, 0.1), 0 8px 32px rgba(0, 0, 0, 0.45);
-}
-
-.session-room-header {
-  display: flex;
-  align-items: center;
-  gap: 8px;
-  margin-bottom: 8px;
-  padding-bottom: 8px;
-  border-bottom: 1px solid rgba(255, 255, 255, 0.07);
-}
-
-.session-room-icon {
-  font-size: 14px;
+.ah-trust-band-count {
+  font-size: 22px;
+  font-weight: 700;
   line-height: 1;
 }
 
-.session-room-title {
-  font-family: var(--font-display, monospace);
-  font-size: 11px;
-  letter-spacing: 0.18em;
-  color: #9b7cff;
+.ah-trust-band-label {
+  font-size: 9px;
+  letter-spacing: 0.8px;
+  color: rgba(255, 255, 255, 0.4);
+  margin-top: 3px;
   text-transform: uppercase;
-  flex: 1;
 }
 
-.session-room-close {
-  background: none;
-  border: none;
-  color: rgba(255, 255, 255, 0.35);
-  cursor: pointer;
-  font-size: 14px;
-  padding: 0 2px;
-  line-height: 1;
-  transition: color 0.15s;
+.ah-trust-high .ah-trust-band-count { color: #4af0c0; }
+.ah-trust-mid  .ah-trust-band-count { color: #ffd700; }
+.ah-trust-low  .ah-trust-band-count { color: #ff4466; }
+
+.ah-timestamps {
+  display: flex;
+  flex-direction: column;
+  gap: 5px;
 }
 
-.session-room-close:hover {
+.ah-ts-row {
+  display: flex;
+  justify-content: space-between;
+  font-size: 11px;
+}
+
+.ah-ts-label {
+  color: rgba(255, 255, 255, 0.4);
+}
+
+.ah-ts-value {
   color: rgba(255, 255, 255, 0.8);
 }
 
-.session-room-timestamp {
-  font-family: var(--font-display, monospace);
-  font-size: 13px;
-  color: #c8b4ff;
-  margin-bottom: 6px;
-  letter-spacing: 0.08em;
+.ah-entity-count {
+  font-size: 24px;
+  font-weight: 700;
+  color: #7b5cff;
 }
 
-.session-room-fact-count {
+.ah-entity-label {
   font-size: 11px;
-  color: rgba(200, 180, 255, 0.55);
-  margin-bottom: 10px;
+  color: rgba(255, 255, 255, 0.45);
+  margin-left: 6px;
 }
 
-.session-room-facts {
-  display: flex;
-  flex-direction: column;
-  gap: 4px;
-  max-height: 140px;
-  overflow-y: auto;
-}
-
-.session-room-fact-item {
-  font-size: 11px;
-  color: rgba(220, 210, 255, 0.75);
-  padding: 4px 8px;
-  background: rgba(123, 92, 255, 0.07);
-  border-left: 2px solid rgba(123, 92, 255, 0.4);
-  border-radius: 0 4px 4px 0;
-  white-space: nowrap;
-  overflow: hidden;
-  text-overflow: ellipsis;
-}
-
-.session-room-hint {
-  margin-top: 10px;
-  font-size: 10px;
-  color: rgba(200, 180, 255, 0.35);
+.ah-hotkey-hint {
   text-align: center;
-  letter-spacing: 0.1em;
-  text-transform: uppercase;
+  font-size: 10px;
+  color: rgba(255, 255, 255, 0.2);
+  letter-spacing: 0.8px;
+  padding-top: 4px;
+  border-top: 1px solid rgba(255, 255, 255, 0.06);
 }
-

tests/test_browser_smoke.py

@@ -0,0 +1,293 @@
+"""
+Browser smoke tests for the Nexus 3D world.
+Uses Playwright to verify the DOM contract, Three.js initialization,
+portal loading, and loading screen flow.
+
+Refs: #686
+"""
+import json
+import os
+import subprocess
+import time
+from pathlib import Path
+
+import pytest
+from playwright.sync_api import sync_playwright, expect
+
+REPO_ROOT = Path(__file__).resolve().parent.parent
+SCREENSHOT_DIR = REPO_ROOT / "test-screenshots"
+
+# ---------------------------------------------------------------------------
+# Fixtures
+# ---------------------------------------------------------------------------
+
+@pytest.fixture(scope="module")
+def http_server():
+    """Start a simple HTTP server for the Nexus static files."""
+    import http.server
+    import threading
+
+    port = int(os.environ.get("NEXUS_TEST_PORT", "9876"))
+    handler = http.server.SimpleHTTPRequestHandler
+    server = http.server.HTTPServer(("127.0.0.1", port), handler)
+    thread = threading.Thread(target=server.serve_forever, daemon=True)
+    thread.start()
+    time.sleep(0.3)
+    yield f"http://127.0.0.1:{port}"
+    server.shutdown()
+
+
+@pytest.fixture(scope="module")
+def browser_page(http_server):
+    """Launch a headless browser and navigate to the Nexus."""
+    SCREENSHOT_DIR.mkdir(exist_ok=True)
+    with sync_playwright() as pw:
+        browser = pw.chromium.launch(
+            headless=True,
+            args=["--no-sandbox", "--disable-gpu"],
+        )
+        context = browser.new_context(
+            viewport={"width": 1280, "height": 720},
+            ignore_https_errors=True,
+        )
+        page = context.new_page()
+        # Collect console errors
+        console_errors = []
+        page.on("console", lambda msg: console_errors.append(msg.text) if msg.type == "error" else None)
+        page.goto(http_server, wait_until="domcontentloaded", timeout=30000)
+        page._console_errors = console_errors
+        yield page
+        browser.close()
+
+
+# ---------------------------------------------------------------------------
+# Static asset tests
+# ---------------------------------------------------------------------------
+
+class TestStaticAssets:
+    """Verify all contract files are serveable."""
+
+    REQUIRED_FILES = [
+        "index.html",
+        "app.js",
+        "style.css",
+        "portals.json",
+        "vision.json",
+        "manifest.json",
+        "gofai_worker.js",
+    ]
+
+    def test_index_html_served(self, http_server):
+        """index.html must return 200."""
+        import urllib.request
+        resp = urllib.request.urlopen(f"{http_server}/index.html")
+        assert resp.status == 200
+
+    @pytest.mark.parametrize("filename", REQUIRED_FILES)
+    def test_contract_file_served(self, http_server, filename):
+        """Each contract file must return 200."""
+        import urllib.request
+        try:
+            resp = urllib.request.urlopen(f"{http_server}/{filename}")
+            assert resp.status == 200
+        except Exception as e:
+            pytest.fail(f"{filename} not serveable: {e}")
+
+
+# ---------------------------------------------------------------------------
+# DOM contract tests
+# ---------------------------------------------------------------------------
+
+class TestDOMContract:
+    """Verify required DOM elements exist after page load."""
+
+    REQUIRED_ELEMENTS = {
+        "nexus-canvas": "canvas",
+        "hud": "div",
+        "chat-panel": "div",
+        "chat-input": "input",
+        "chat-messages": "div",
+        "chat-send": "button",
+        "chat-toggle": "button",
+        "debug-overlay": "div",
+        "nav-mode-label": "span",
+        "ws-status-dot": "span",
+        "hud-location-text": "span",
+        "portal-hint": "div",
+        "spatial-search": "div",
+    }
+
+    @pytest.mark.parametrize("element_id,tag", list(REQUIRED_ELEMENTS.items()))
+    def test_element_exists(self, browser_page, element_id, tag):
+        """Element with given ID must exist in the DOM."""
+        el = browser_page.query_selector(f"#{element_id}")
+        assert el is not None, f"#{element_id} ({tag}) missing from DOM"
+
+    def test_canvas_has_webgl(self, browser_page):
+        """The nexus-canvas must have a WebGL rendering context."""
+        has_webgl = browser_page.evaluate("""
+            () => {
+                const c = document.getElementById('nexus-canvas');
+                if (!c) return false;
+                const ctx = c.getContext('webgl2') || c.getContext('webgl');
+                return ctx !== null;
+            }
+        """)
+        assert has_webgl, "nexus-canvas has no WebGL context"
+
+    def test_title_contains_nexus(self, browser_page):
+        """Page title should reference The Nexus."""
+        title = browser_page.title()
+        assert "nexus" in title.lower() or "timmy" in title.lower(), f"Unexpected title: {title}"
+
+
+# ---------------------------------------------------------------------------
+# Loading flow tests
+# ---------------------------------------------------------------------------
+
+class TestLoadingFlow:
+    """Verify the loading screen → enter prompt → HUD flow."""
+
+    def test_loading_screen_transitions(self, browser_page):
+        """Loading screen should fade out and HUD should become visible."""
+        # Wait for loading to complete and enter prompt to appear
+        try:
+            browser_page.wait_for_selector("#enter-prompt", state="visible", timeout=15000)
+        except Exception:
+            # Enter prompt may have already appeared and been clicked
+            pass
+
+        # Try clicking the enter prompt if it exists
+        enter = browser_page.query_selector("#enter-prompt")
+        if enter and enter.is_visible():
+            enter.click()
+            time.sleep(1)
+
+        # HUD should now be visible
+        hud = browser_page.query_selector("#hud")
+        assert hud is not None, "HUD element missing"
+        # After enter, HUD display should not be 'none'
+        display = browser_page.evaluate("() => document.getElementById('hud').style.display")
+        assert display != "none", "HUD should be visible after entering"
+
+
+# ---------------------------------------------------------------------------
+# Three.js initialization tests
+# ---------------------------------------------------------------------------
+
+class TestThreeJSInit:
+    """Verify Three.js initialized properly."""
+
+    def test_three_loaded(self, browser_page):
+        """THREE namespace should be available (via import map)."""
+        # Three.js is loaded as ES module, check for canvas context instead
+        has_canvas = browser_page.evaluate("""
+            () => {
+                const c = document.getElementById('nexus-canvas');
+                return c && c.width > 0 && c.height > 0;
+            }
+        """)
+        assert has_canvas, "Canvas not properly initialized"
+
+    def test_canvas_dimensions(self, browser_page):
+        """Canvas should fill the viewport."""
+        dims = browser_page.evaluate("""
+            () => {
+                const c = document.getElementById('nexus-canvas');
+                return { width: c.width, height: c.height, ww: window.innerWidth, wh: window.innerHeight };
+            }
+        """)
+        assert dims["width"] > 0, "Canvas width is 0"
+        assert dims["height"] > 0, "Canvas height is 0"
+
+
+# ---------------------------------------------------------------------------
+# Data contract tests
+# ---------------------------------------------------------------------------
+
+class TestDataContract:
+    """Verify JSON data files are valid and well-formed."""
+
+    def test_portals_json_valid(self):
+        """portals.json must parse as a non-empty JSON array."""
+        data = json.loads((REPO_ROOT / "portals.json").read_text())
+        assert isinstance(data, list), "portals.json must be an array"
+        assert len(data) > 0, "portals.json must have at least one portal"
+
+    def test_portals_have_required_fields(self):
+        """Each portal must have id, name, status, destination."""
+        data = json.loads((REPO_ROOT / "portals.json").read_text())
+        required = {"id", "name", "status", "destination"}
+        for i, portal in enumerate(data):
+            missing = required - set(portal.keys())
+            assert not missing, f"Portal {i} missing fields: {missing}"
+
+    def test_vision_json_valid(self):
+        """vision.json must parse as valid JSON."""
+        data = json.loads((REPO_ROOT / "vision.json").read_text())
+        assert data is not None
+
+    def test_manifest_json_valid(self):
+        """manifest.json must have required PWA fields."""
+        data = json.loads((REPO_ROOT / "manifest.json").read_text())
+        for key in ["name", "start_url", "theme_color"]:
+            assert key in data, f"manifest.json missing '{key}'"
+
+
+# ---------------------------------------------------------------------------
+# Screenshot / visual proof
+# ---------------------------------------------------------------------------
+
+class TestVisualProof:
+    """Capture screenshots as visual validation evidence."""
+
+    def test_screenshot_initial_state(self, browser_page):
+        """Take a screenshot of the initial page state."""
+        path = SCREENSHOT_DIR / "smoke-initial.png"
+        browser_page.screenshot(path=str(path))
+        assert path.exists(), "Screenshot was not saved"
+        assert path.stat().st_size > 1000, "Screenshot seems empty"
+
+    def test_screenshot_after_enter(self, browser_page):
+        """Take a screenshot after clicking through the enter prompt."""
+        enter = browser_page.query_selector("#enter-prompt")
+        if enter and enter.is_visible():
+            enter.click()
+            time.sleep(2)
+        else:
+            time.sleep(1)
+
+        path = SCREENSHOT_DIR / "smoke-post-enter.png"
+        browser_page.screenshot(path=str(path))
+        assert path.exists()
+
+    def test_screenshot_fullscreen(self, browser_page):
+        """Full-page screenshot for visual regression baseline."""
+        path = SCREENSHOT_DIR / "smoke-fullscreen.png"
+        browser_page.screenshot(path=str(path), full_page=True)
+        assert path.exists()
+
+
+# ---------------------------------------------------------------------------
+# Provenance in browser context
+# ---------------------------------------------------------------------------
+
+class TestBrowserProvenance:
+    """Verify provenance from within the browser context."""
+
+    def test_page_served_from_correct_origin(self, http_server):
+        """The page must be served from localhost, not a stale remote."""
+        import urllib.request
+        resp = urllib.request.urlopen(f"{http_server}/index.html")
+        content = resp.read().decode("utf-8", errors="replace")
+        # Must not contain references to legacy matrix path
+        assert "/Users/apayne/the-matrix" not in content, \
+            "index.html references legacy matrix path — provenance violation"
+
+    def test_index_html_has_nexus_title(self, http_server):
+        """index.html title must reference The Nexus."""
+        import urllib.request
+        resp = urllib.request.urlopen(f"{http_server}/index.html")
+        content = resp.read().decode("utf-8", errors="replace")
+        assert "<title>The Nexus" in content or "Timmy" in content, \
+            "index.html title does not reference The Nexus"

tests/test_provenance.py

@@ -0,0 +1,73 @@
+"""
+Provenance tests — verify the Nexus browser surface comes from
+a clean Timmy_Foundation/the-nexus checkout, not stale sources.
+
+Refs: #686
+"""
+import json
+import hashlib
+from pathlib import Path
+
+REPO_ROOT = Path(__file__).resolve().parent.parent
+
+
+def test_provenance_manifest_exists() -> None:
+    """provenance.json must exist and be valid JSON."""
+    p = REPO_ROOT / "provenance.json"
+    assert p.exists(), "provenance.json missing — run bin/generate_provenance.py"
+    data = json.loads(p.read_text())
+    assert "files" in data
+    assert "repo" in data
+
+
+def test_provenance_repo_identity() -> None:
+    """Manifest must claim Timmy_Foundation/the-nexus."""
+    data = json.loads((REPO_ROOT / "provenance.json").read_text())
+    assert data["repo"] == "Timmy_Foundation/the-nexus"
+
+
+def test_provenance_all_contract_files_present() -> None:
+    """Every file listed in the provenance manifest must exist on disk."""
+    data = json.loads((REPO_ROOT / "provenance.json").read_text())
+    missing = []
+    for rel in data["files"]:
+        if not (REPO_ROOT / rel).exists():
+            missing.append(rel)
+    assert not missing, f"Contract files missing: {missing}"
+
+
+def test_provenance_hashes_match() -> None:
+    """File hashes must match the stored manifest (no stale/modified files)."""
+    data = json.loads((REPO_ROOT / "provenance.json").read_text())
+    mismatches = []
+    for rel, meta in data["files"].items():
+        p = REPO_ROOT / rel
+        if not p.exists():
+            mismatches.append(f"MISSING: {rel}")
+            continue
+        actual = hashlib.sha256(p.read_bytes()).hexdigest()
+        if actual != meta["sha256"]:
+            mismatches.append(f"CHANGED: {rel}")
+    assert not mismatches, f"Provenance mismatch:\n" + "\n".join(mismatches)
+
+
+def test_no_legacy_matrix_references_in_frontend() -> None:
+    """Frontend files must not reference /Users/apayne/the-matrix as a source."""
+    forbidden_paths = ["/Users/apayne/the-matrix"]
+    offenders = []
+    for rel in ["index.html", "app.js", "style.css"]:
+        p = REPO_ROOT / rel
+        if p.exists():
+            content = p.read_text()
+            for bad in forbidden_paths:
+                if bad in content:
+                    offenders.append(f"{rel} references {bad}")
+    assert not offenders, f"Legacy matrix references found: {offenders}"
+
+
+def test_no_stale_perplexity_computer_references_in_critical_files() -> None:
+    """Verify the provenance generator script itself is canonical."""
+    script = REPO_ROOT / "bin" / "generate_provenance.py"
+    assert script.exists(), "bin/generate_provenance.py must exist"
+    content = script.read_text()
+    assert "Timmy_Foundation/the-nexus" in content