feat(mnemosyne): wire memory search UI - toggle, render, fly-to, keyboard shortcut (#1208)

.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,14 +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 { TimelineScrubber } from './nexus/components/timeline-scrubber.js';
-import { MemoryParticles } from './nexus/components/memory-particles.js';
+import { MemoryOptimizer } from './nexus/components/memory-optimizer.js';
 
 // ═══════════════════════════════════════════
 // NEXUS v1.1 — Portal System Update
@@ -49,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';
 
@@ -710,14 +707,21 @@ async function init() {
   createWorkshopTerminal();
   createAshStorm();
   SpatialMemory.init(scene);
-  MemoryParticles.init(scene);
-  SpatialMemory.setOnMemoryPlaced(MemoryParticles.onMemoryPlaced);
-  TimelineScrubber.init(SpatialMemory);
-  SessionRooms.init(scene, camera, null);
   updateLoad(90);
 
   loadSession();
   connectHermes();
+  // Mnemosyne: Periodic GOFAI Optimization
+  setInterval(() => {
+    console.info('[Mnemosyne] Running periodic optimization...');
+    MemoryOptimizer.optimize(SpatialMemory);
+  }, 1000 * 60 * 10); // Every 10 minutes
+
+  
+// Wire memory search input
+const searchInput = document.getElementById('memory-search-input');
+if (searchInput) searchInput.addEventListener('input', onMemorySearchInput);
+
   fetchGiteaData();
   setInterval(fetchGiteaData, 30000); // Refresh every 30s
 
@@ -1892,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,
@@ -1900,47 +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);
-              // Memory access trail particles
-              if (camera) {
-                MemoryParticles.onMemoryAccessed(camera.position, hitMesh.position, memInfo.data.category || memInfo.region || 'working');
-              }
-              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();
       }
     }
   });
@@ -1993,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) {
@@ -2152,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
@@ -2202,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 = '';
@@ -2213,6 +2125,209 @@ function handleHermesMessage(data) {
   }
 }
 
+
+// ═══════════════════════════════════════════
+
+// ═══ MNEMOSYNE — MEMORY SEARCH (#1208) ═══
+let memorySearchVisible = false;
+let memorySearchDebounce = null;
+
+function toggleMemorySearch() {
+  const panel = document.getElementById('memory-search-panel');
+  const input = document.getElementById('memory-search-input');
+  if (!panel) return;
+
+  memorySearchVisible = !memorySearchVisible;
+  panel.style.display = memorySearchVisible ? 'block' : 'none';
+
+  if (memorySearchVisible && input) {
+    input.value = '';
+    input.focus();
+    renderMemorySearchResults([]);
+  }
+}
+
+function renderMemorySearchResults(results) {
+  const container = document.getElementById('memory-search-results');
+  if (!container) return;
+
+  if (results.length === 0) {
+    container.innerHTML = '<div class="memory-search-empty">' +
+      (document.getElementById('memory-search-input')?.value ? 'No memories found' : 'Type to search your archive...') +
+      '</div>';
+    return;
+  }
+
+  container.innerHTML = results.map(r => {
+    const regionDef = SpatialMemory.REGIONS[r.category] || SpatialMemory.REGIONS.working;
+    const dotColor = '#' + regionDef.color.toString(16).padStart(6, '0');
+    const truncated = r.content.length > 55 ? r.content.slice(0, 55) + '\u2026' : r.content;
+    return '<div class="memory-search-result" onclick="flyToMemory(\'' + r.id + '\')">' +
+      '<div class="memory-search-dot" style="background:' + dotColor + '"></div>' +
+      '<span class="memory-search-text">' + truncated + '</span>' +
+      '<span class="memory-search-meta">' + r.category + '</span>' +
+      '</div>';
+  }).join('');
+}
+
+function onMemorySearchInput(e) {
+  const query = e.target.value;
+  if (memorySearchDebounce) clearTimeout(memorySearchDebounce);
+
+  memorySearchDebounce = setTimeout(() => {
+    if (!query || query.trim().length === 0) {
+      renderMemorySearchResults([]);
+      return;
+    }
+    const results = SpatialMemory.searchByContent(query, { maxResults: 15 });
+    renderMemorySearchResults(results);
+  }, 150);
+}
+
+function flyToMemory(memId) {
+  const memories = SpatialMemory.getAllMemories();
+  const mem = memories.find(m => m.id === memId);
+  if (!mem) return;
+
+  // Highlight the crystal
+  SpatialMemory.highlightMemory(memId);
+
+  // Fly camera to memory position (if camera controls exist)
+  if (typeof camera !== 'undefined' && camera.position) {
+    const target = new THREE.Vector3(mem.position[0], mem.position[1] + 3, mem.position[2] + 5);
+    // Simple lerp animation
+    const start = camera.position.clone();
+    let t = 0;
+    const flyAnim = () => {
+      t += 0.03;
+      if (t > 1) t = 1;
+      camera.position.lerpVectors(start, target, t);
+      if (t < 1) requestAnimationFrame(flyAnim);
+    };
+    flyAnim();
+  }
+
+  // Close search panel
+  if (memorySearchVisible) toggleMemorySearch();
+
+  // Show in memory feed
+  addMemoryFeedEntry('update', { content: 'Navigated to: ' + (mem.content || mem.id).slice(0, 40), id: memId });
+}
+
+// Keyboard shortcut: Ctrl+K or / to toggle search
+document.addEventListener('keydown', (e) => {
+  if ((e.ctrlKey && e.key === 'k') || (e.key === '/' && !e.target.matches('input, textarea'))) {
+    e.preventDefault();
+    toggleMemorySearch();
+  }
+  if (e.key === 'Escape' && memorySearchVisible) {
+    toggleMemorySearch();
+  }
+});
+
+//  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);
+  }
+}
+
+/**
+ * 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';
+}
+
+
 function updateWsHudStatus(connected) {
   // Update MemPalace status alongside regular WS status
   updateMemPalaceStatus();
@@ -2507,15 +2622,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';
@@ -2537,37 +2643,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';
@@ -2648,42 +2723,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>
@@ -2701,14 +2746,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');
   }
 }
 
@@ -2735,238 +2777,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, ' ')}`);
-
-  // Access trail particles
-  const meshes = SpatialMemory.getCrystalMeshes();
-  for (const mesh of meshes) {
-    if (mesh.userData && mesh.userData.memId === memId) {
-      const memInfo = SpatialMemory.getMemoryFromMesh(mesh);
-      if (memInfo && camera) {
-        MemoryParticles.onMemoryAccessed(camera.position, mesh.position, memInfo.data.category || memInfo.region || 'working');
-      }
-      break;
-    }
-  }
-  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);
@@ -2994,14 +2804,9 @@ function gameLoop() {
   // Project Mnemosyne - Memory Orb Animation
   if (typeof animateMemoryOrbs === 'function') {
     SpatialMemory.update(delta);
-    MemoryParticles.update(delta);
-    TimelineScrubber.update();
     animateMemoryOrbs(delta);
   }
 
-  // Project Mnemosyne - Session Rooms (#1171)
-  SessionRooms.update(delta);
-
 
   const mode = NAV_MODES[navModeIdx];
   const chatActive = document.activeElement === document.getElementById('chat-input');
@@ -3525,167 +3330,13 @@ 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();
-
-
-  // ═══ SPATIAL SEARCH (Mnemosyne #1170) ═══
-  (() => {
-    const input = document.getElementById('spatial-search-input');
-    const resultsDiv = document.getElementById('spatial-search-results');
-    if (!input || !resultsDiv) return;
-
-    let searchTimeout = null;
-    let currentMatches = [];
-
-    function runSearch(query) {
-      if (!query.trim()) {
-        SpatialMemory.clearSearch();
-        resultsDiv.classList.remove('visible');
-        resultsDiv.innerHTML = '';
-        currentMatches = [];
-        return;
-      }
-
-      const matches = SpatialMemory.searchContent(query);
-      currentMatches = matches;
-
-      if (matches.length === 0) {
-        SpatialMemory.clearSearch();
-        resultsDiv.innerHTML = '<div class="spatial-search-count">No matches</div>';
-        resultsDiv.classList.add('visible');
-        return;
-      }
-
-      SpatialMemory.highlightSearchResults(matches);
-
-      // Build results list
-      const allMems = SpatialMemory.getAllMemories();
-      let html = `<div class="spatial-search-count">${matches.length} match${matches.length > 1 ? 'es' : ''}</div>`;
-      matches.forEach(id => {
-        const mem = allMems.find(m => m.id === id);
-        if (mem) {
-          const label = (mem.content || id).slice(0, 60);
-          const region = mem.category || '?';
-          html += `<div class="spatial-search-result-item" data-mem-id="${id}">
-            <span class="result-region">[${region}]</span>${label}
-          </div>`;
-        }
-      });
-      resultsDiv.innerHTML = html;
-      resultsDiv.classList.add('visible');
-
-      // Click handler for result items
-      resultsDiv.querySelectorAll('.spatial-search-result-item').forEach(el => {
-        el.addEventListener('click', () => {
-          const memId = el.getAttribute('data-mem-id');
-          flyToMemory(memId);
-        });
-      });
-
-      // Fly camera to first match
-      if (matches.length > 0) {
-        flyToMemory(matches[0]);
-      }
-    }
-
-    function flyToMemory(memId) {
-      const pos = SpatialMemory.getSearchMatchPosition(memId);
-      if (!pos) return;
-
-      // Smooth camera fly-to: place camera above and in front of crystal
-      const targetPos = new THREE.Vector3(pos.x, pos.y + 4, pos.z + 6);
-
-      // Use simple lerp animation over ~800ms
-      const startPos = playerPos.clone();
-      const startTime = performance.now();
-      const duration = 800;
-
-      function animateCamera(now) {
-        const elapsed = now - startTime;
-        const t = Math.min(1, elapsed / duration);
-        // Ease out cubic
-        const ease = 1 - Math.pow(1 - t, 3);
-
-        playerPos.lerpVectors(startPos, targetPos, ease);
-        camera.position.copy(playerPos);
-
-        // Look at crystal
-        const lookTarget = pos.clone();
-        lookTarget.y += 1.5;
-        camera.lookAt(lookTarget);
-
-        if (t < 1) {
-          requestAnimationFrame(animateCamera);
-        } else {
-          SpatialMemory.highlightMemory(memId);
-        }
-      }
-      requestAnimationFrame(animateCamera);
-    }
-
-    // Debounced input handler
-    input.addEventListener('input', () => {
-      clearTimeout(searchTimeout);
-      searchTimeout = setTimeout(() => runSearch(input.value), 200);
-    });
-
-    // Escape clears search
-    input.addEventListener('keydown', (e) => {
-      if (e.key === 'Escape') {
-        input.value = '';
-        SpatialMemory.clearSearch();
-        resultsDiv.classList.remove('visible');
-        resultsDiv.innerHTML = '';
-        currentMatches = [];
-        input.blur();
-      }
-    });
-  })();
-
-
-  // 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);
+  
+// Wire memory search input
+const searchInput = document.getElementById('memory-search-input');
+if (searchInput) searchInput.addEventListener('input', onMemorySearchInput);
 
   fetchGiteaData();
   setInterval(fetchGiteaData, 30000);

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()

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>
@@ -66,14 +64,6 @@ chdir: error retrieving current directory: getcwd: cannot access parent director
   </div>
 </div>
 
-
-<!-- Spatial Search Overlay (Mnemosyne #1170) -->
-<div id="spatial-search" class="spatial-search-overlay">
-  <input type="text" id="spatial-search-input" class="spatial-search-input" 
-         placeholder="🔍 Search memories..." autocomplete="off" spellcheck="false">
-  <div id="spatial-search-results" class="spatial-search-results"></div>
-</div>
-
 <!-- HUD Overlay -->
 <div id="hud" class="game-ui" style="display:none;">
   <!-- GOFAI HUD Panels -->
@@ -123,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>
@@ -153,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">
@@ -194,11 +155,11 @@ 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 class="ws-hud-status">HERMES: <span id="ws-status-dot" class="chat-status-dot"></span></span>
   </div>
 
   <!-- Portal Hint -->
@@ -222,7 +183,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>
 
@@ -235,67 +196,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">
@@ -304,7 +215,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 -->
@@ -528,5 +439,26 @@ index.html
   setInterval(poll, INTERVAL);
 })();
 </script>
+
+  <!-- Memory Activity Feed (Mnemosyne) -->
+  
+    <!-- Mnemosyne Memory Search Panel (#1208) -->
+    <div id="memory-search-panel" style="display:none;">
+      <div class="memory-search-header">
+        <span class="memory-search-icon">🔍</span>
+        <input type="text" id="memory-search-input" placeholder="Search archive..." autocomplete="off" spellcheck="false" />
+        <span class="memory-search-close" onclick="toggleMemorySearch()">✕</span>
+      </div>
+      <div id="memory-search-results"></div>
+    </div>
+
+    <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>

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/spatial-memory.js

@@ -32,9 +32,6 @@
 
 const SpatialMemory = (() => {
 
-  // ─── CALLBACKS ────────────────────────────────────────
-  let _onMemoryPlacedCallback = null;
-
   // ─── REGION DEFINITIONS ───────────────────────────────
   const REGIONS = {
     engineering: {
@@ -136,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) ───────────
@@ -143,47 +143,6 @@ const SpatialMemory = (() => {
     return new THREE.OctahedronGeometry(size, 0);
   }
 
-  // ─── TRUST-BASED VISUALS ─────────────────────────────
-  // Wire crystal visual properties to fact trust score (0.0-1.0).
-  // Issue #1166: Trust > 0.8 = bright glow/full opacity,
-  // 0.5-0.8 = medium/80%, < 0.5 = dim/40%, < 0.3 = near-invisible pulsing red.
-  function _getTrustVisuals(trust, regionColor) {
-    const t = Math.max(0, Math.min(1, trust));
-    if (t >= 0.8) {
-      return {
-        opacity: 1.0,
-        emissiveIntensity: 2.0 * t,
-        emissiveColor: regionColor,
-        lightIntensity: 1.2,
-        glowDesc: 'high'
-      };
-    } else if (t >= 0.5) {
-      return {
-        opacity: 0.8,
-        emissiveIntensity: 1.2 * t,
-        emissiveColor: regionColor,
-        lightIntensity: 0.6,
-        glowDesc: 'medium'
-      };
-    } else if (t >= 0.3) {
-      return {
-        opacity: 0.4,
-        emissiveIntensity: 0.5 * t,
-        emissiveColor: regionColor,
-        lightIntensity: 0.2,
-        glowDesc: 'dim'
-      };
-    } else {
-      return {
-        opacity: 0.15,
-        emissiveIntensity: 0.3,
-        emissiveColor: 0xff2200,
-        lightIntensity: 0.1,
-        glowDesc: 'untrusted'
-      };
-    }
-  }
-
   // ─── REGION MARKER ───────────────────────────────────
   function createRegionMarker(regionKey, region) {
     const cx = region.center[0];
@@ -250,7 +209,147 @@ 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);
+    });
+  }
+
+
+  // ─── CONTENT SEARCH (Mnemosyne #1208) ──────────────────
+  /**
+   * Search memories by text content. Case-insensitive substring match.
+   * @param {string} query - Search query
+   * @param {object} options - { category: string, maxResults: number, minStrength: number }
+   * @returns {Array} Matching memories sorted by relevance (strength desc, then match position)
+   */
+  function searchByContent(query, options) {
+    options = options || {};
+    const maxResults = options.maxResults || 20;
+    const minStrength = options.minStrength || 0;
+    const categoryFilter = options.category || null;
+
+    if (!query || query.trim().length === 0) return [];
+
+    const lowerQuery = query.toLowerCase().trim();
+    const terms = lowerQuery.split(/\s+/);
+    const results = [];
+
+    Object.values(_memoryObjects).forEach(obj => {
+      const data = obj.data;
+      if (!data.content) return;
+
+      // Category filter
+      if (categoryFilter && obj.region !== categoryFilter) return;
+
+      // Strength filter
+      const strength = obj.mesh.userData.strength || 0.7;
+      if (strength < minStrength) return;
+
+      const lowerContent = data.content.toLowerCase();
+
+      // Score: count how many terms match, weight by first-match position
+      let matchCount = 0;
+      let firstMatchPos = Infinity;
+      terms.forEach(term => {
+        const pos = lowerContent.indexOf(term);
+        if (pos !== -1) {
+          matchCount++;
+          if (pos < firstMatchPos) firstMatchPos = pos;
+        }
+      });
+
+      if (matchCount > 0) {
+        const relevance = matchCount * 100 + strength * 10 - firstMatchPos * 0.01;
+        results.push({
+          id: data.id,
+          content: data.content,
+          category: obj.region,
+          strength: strength,
+          position: [obj.mesh.position.x, obj.mesh.position.y - 1.5, obj.mesh.position.z],
+          relevance: relevance,
+          matchCount: matchCount,
+          source: data.source || 'unknown',
+          timestamp: data.timestamp || obj.mesh.userData.createdAt
+        });
+      }
+    });
+
+    results.sort((a, b) => b.relevance - a.relevance);
+    return results.slice(0, maxResults);
+  }
+
+  return { ring, disc, glowDisc, sprite };
   }
 
   // ─── PLACE A MEMORY ──────────────────────────────────
@@ -260,20 +359,17 @@ const SpatialMemory = (() => {
     const region = REGIONS[mem.category] || REGIONS.working;
     const pos = mem.position || _assignPosition(mem.category, mem.id);
     const strength = Math.max(0.05, Math.min(1, mem.strength != null ? mem.strength : 0.7));
-    const trust = mem.trust != null ? Math.max(0, Math.min(1, mem.trust)) : 0.7;
     const size = 0.2 + strength * 0.3;
 
-    const tv = _getTrustVisuals(trust, region.color);
-
     const geo = createCrystalGeometry(size);
     const mat = new THREE.MeshStandardMaterial({
       color: region.color,
-      emissive: tv.emissiveColor,
-      emissiveIntensity: tv.emissiveIntensity,
+      emissive: region.color,
+      emissiveIntensity: 1.5 * strength,
       metalness: 0.6,
       roughness: 0.15,
       transparent: true,
-      opacity: tv.opacity
+      opacity: 0.5 + strength * 0.4
     });
 
     const crystal = new THREE.Mesh(geo, mat);
@@ -286,12 +382,10 @@ const SpatialMemory = (() => {
       region: mem.category,
       pulse: Math.random() * Math.PI * 2,
       strength: strength,
-      trust: trust,
-      glowDesc: tv.glowDesc,
       createdAt: mem.timestamp || new Date().toISOString()
     };
 
-    const light = new THREE.PointLight(tv.emissiveColor, tv.lightIntensity, 5);
+    const light = new THREE.PointLight(region.color, 0.8 * strength, 5);
     crystal.add(light);
 
     _scene.add(crystal);
@@ -301,15 +395,13 @@ 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);
-
-    // Fire particle burst callback
-    if (_onMemoryPlacedCallback) {
-      _onMemoryPlacedCallback(crystal.position.clone(), mem.category || 'working');
-    }
-
     return crystal;
   }
 
@@ -353,6 +445,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];
@@ -372,6 +535,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();
@@ -392,19 +565,13 @@ const SpatialMemory = (() => {
       mesh.scale.setScalar(pulse);
 
       if (mesh.material) {
-        const trust = mesh.userData.trust != null ? mesh.userData.trust : 0.7;
         const base = mesh.userData.strength || 0.7;
-        if (trust < 0.3) {
-          // Low trust: pulsing red — visible warning
-          const pulseAlpha = 0.15 + Math.sin(mesh.userData.pulse * 2.0) * 0.15;
-          mesh.material.emissiveIntensity = 0.3 + Math.sin(mesh.userData.pulse * 2.0) * 0.3;
-          mesh.material.opacity = pulseAlpha;
-        } else {
-          mesh.material.emissiveIntensity = 1.0 + Math.sin(mesh.userData.pulse * 0.7) * 0.5 * base;
-        }
+        mesh.material.emissiveIntensity = 1.0 + Math.sin(mesh.userData.pulse * 0.7) * 0.5 * base;
       }
     });
 
+      _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;
@@ -431,42 +598,6 @@ const SpatialMemory = (() => {
     return REGIONS;
   }
 
-  // ─── UPDATE VISUAL PROPERTIES ────────────────────────
-  // Re-render crystal when trust/strength change (no position move).
-  function updateMemoryVisual(memId, updates) {
-    const obj = _memoryObjects[memId];
-    if (!obj) return false;
-
-    const mesh = obj.mesh;
-    const region = REGIONS[obj.region] || REGIONS.working;
-
-    if (updates.trust != null) {
-      const trust = Math.max(0, Math.min(1, updates.trust));
-      mesh.userData.trust = trust;
-      obj.data.trust = trust;
-      const tv = _getTrustVisuals(trust, region.color);
-      mesh.material.emissive = new THREE.Color(tv.emissiveColor);
-      mesh.material.emissiveIntensity = tv.emissiveIntensity;
-      mesh.material.opacity = tv.opacity;
-      mesh.userData.glowDesc = tv.glowDesc;
-      if (mesh.children.length > 0 && mesh.children[0].isPointLight) {
-        mesh.children[0].intensity = tv.lightIntensity;
-        mesh.children[0].color = new THREE.Color(tv.emissiveColor);
-      }
-    }
-
-    if (updates.strength != null) {
-      const strength = Math.max(0.05, Math.min(1, updates.strength));
-      mesh.userData.strength = strength;
-      obj.data.strength = strength;
-    }
-
-    _dirty = true;
-    saveToStorage();
-    console.info('[Mnemosyne] Visual updated:', memId, 'trust:', mesh.userData.trust, 'glow:', mesh.userData.glowDesc);
-    return true;
-  }
-
   // ─── QUERY ───────────────────────────────────────────
   function getMemoryAtPosition(position, maxDist) {
     maxDist = maxDist || 2;
@@ -606,7 +737,6 @@ const SpatialMemory = (() => {
         source: o.data.source || 'unknown',
         timestamp: o.data.timestamp || o.mesh.userData.createdAt,
         strength: o.mesh.userData.strength || 0.7,
-        trust: o.mesh.userData.trust != null ? o.mesh.userData.trust : 0.7,
         connections: o.data.connections || []
       }))
     };
@@ -752,173 +882,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);
-    });
-  }
-
-
-  // ─── SPATIAL SEARCH (issue #1170) ────────────────────
-  let _searchOriginalState = {};  // memId -> { emissiveIntensity, opacity } for restore
-
-  function searchContent(query) {
-    if (!query || !query.trim()) return [];
-    const q = query.toLowerCase().trim();
-    const matches = [];
-
-    Object.values(_memoryObjects).forEach(obj => {
-      const d = obj.data;
-      const searchable = [
-        d.content || '',
-        d.id || '',
-        d.category || '',
-        d.source || '',
-        ...(d.connections || [])
-      ].join(' ').toLowerCase();
-
-      if (searchable.includes(q)) {
-        matches.push(d.id);
-      }
-    });
-
-    return matches;
-  }
-
-  function highlightSearchResults(matchIds) {
-    // Save original state and apply search highlighting
-    _searchOriginalState = {};
-    const matchSet = new Set(matchIds);
-
-    Object.entries(_memoryObjects).forEach(([id, obj]) => {
-      const mat = obj.mesh.material;
-      _searchOriginalState[id] = {
-        emissiveIntensity: mat.emissiveIntensity,
-        opacity: mat.opacity
-      };
-
-      if (matchSet.has(id)) {
-        // Match: bright white glow
-        mat.emissive.setHex(0xffffff);
-        mat.emissiveIntensity = 5.0;
-        mat.opacity = 1.0;
-      } else {
-        // Non-match: dim to 10% opacity
-        mat.opacity = 0.1;
-        mat.emissiveIntensity = 0.2;
-      }
-    });
-  }
-
-  function clearSearch() {
-    Object.entries(_memoryObjects).forEach(([id, obj]) => {
-      const mat = obj.mesh.material;
-      const saved = _searchOriginalState[id];
-      if (saved) {
-        // Restore original emissive color from region
-        const region = REGIONS[obj.region] || REGIONS.working;
-        mat.emissive.copy(region.color);
-        mat.emissiveIntensity = saved.emissiveIntensity;
-        mat.opacity = saved.opacity;
-      }
-    });
-    _searchOriginalState = {};
-  }
-
-  function getSearchMatchPosition(matchId) {
-    const obj = _memoryObjects[matchId];
-    return obj ? obj.mesh.position.clone() : null;
-  }
-
-  function setOnMemoryPlaced(callback) {
-    _onMemoryPlacedCallback = callback;
+  // ─── CAMERA REFERENCE (for entity line LOD) ─────────
+  function setCamera(camera) {
+    _camera = camera;
   }
 
   return {
-    init, placeMemory, removeMemory, update, updateMemoryVisual,
+    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,
-    searchContent, highlightSearchResults, clearSearch, getSearchMatchPosition,
-    setOnMemoryPlaced
+    runGravityLayout, searchByContent
   };
 })();
 

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,477 +1224,233 @@ 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;
-  flex: 1;
-}
-
-.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-panel-close:hover {
-  background: rgba(255, 255, 255, 0.05);
-  color: #fff;
-}
-
-.memory-panel-body {
-  font-size: 14px;
-  line-height: 1.6;
-  color: var(--color-text, #ccc);
-  margin-bottom: 14px;
-  max-height: 120px;
-  overflow-y: auto;
-  word-break: break-word;
-}
-
-.memory-panel-meta {
-  display: flex;
-  flex-direction: column;
-  gap: 5px;
-  font-size: 11px;
-}
-
-.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;
+.memory-feed-action {
   flex-shrink: 0;
+  font-size: 12px;
 }
 
-.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;
-  font-size: 10px;
-  font-family: var(--font-mono, monospace);
-  color: var(--color-primary, #4af0c0);
-  margin: 1px 2px;
-}
-
-.memory-conn-link {
-  cursor: pointer;
-  transition: background 0.15s, border-color 0.15s;
-}
-
-.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;
-  font-weight: 700;
-  color: #fff;
-  letter-spacing: 0.04em;
-  margin-bottom: 8px;
-  text-transform: capitalize;
-  word-break: break-word;
-}
-
-/* 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;
-}
-
-/* Trust score bar */
-.memory-trust-row {
-  display: flex;
-  align-items: center;
-  gap: 8px;
-  margin-bottom: 12px;
-  font-size: 11px;
-}
-
-.memory-trust-bar {
+.memory-feed-content {
   flex: 1;
-  height: 5px;
-  background: rgba(255, 255, 255, 0.08);
-  border-radius: 3px;
-  overflow: hidden;
-}
-
-.memory-trust-fill {
-  height: 100%;
-  border-radius: 3px;
-  background: var(--color-primary, #4af0c0);
-  transition: width 0.35s ease;
-}
-
-.memory-trust-value {
-  color: var(--color-text-muted, #888);
-  min-width: 32px;
-  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;
-  display: flex;
-  align-items: center;
-  justify-content: center;
-  transition: all 0.15s;
-  flex-shrink: 0;
-}
-
-.memory-panel-pin:hover {
-  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;
-  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;
-  line-height: 1;
-}
-
-.session-room-title {
-  font-family: var(--font-display, monospace);
-  font-size: 11px;
-  letter-spacing: 0.18em;
-  color: #9b7cff;
-  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;
-}
-
-.session-room-close:hover {
-  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;
-}
-
-.session-room-fact-count {
-  font-size: 11px;
-  color: rgba(200, 180, 255, 0.55);
-  margin-bottom: 10px;
-}
-
-.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;
+  white-space: nowrap;
 }
 
-.session-room-hint {
-  margin-top: 10px;
+.memory-feed-time {
+  flex-shrink: 0;
+  color: rgba(255, 255, 255, 0.3);
   font-size: 10px;
-  color: rgba(200, 180, 255, 0.35);
-  text-align: center;
-  letter-spacing: 0.1em;
-  text-transform: uppercase;
 }
 
+.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; }
 
-/* ═══ SPATIAL SEARCH OVERLAY (Mnemosyne #1170) ═══ */
-.spatial-search-overlay {
+/* ═══ MNEMOSYNE — Memory Search Panel (#1208) ═══ */
+#memory-search-panel {
   position: fixed;
-  top: 12px;
-  right: 12px;
-  z-index: 100;
-  display: flex;
-  flex-direction: column;
-  align-items: flex-end;
-  font-family: 'JetBrains Mono', monospace;
+  top: 60px;
+  left: 50%;
+  transform: translateX(-50%);
+  width: 420px;
+  max-height: 400px;
+  background: rgba(10, 14, 26, 0.95);
+  border: 1px solid rgba(74, 240, 192, 0.3);
+  border-radius: 8px;
+  z-index: 1000;
+  backdrop-filter: blur(12px);
+  box-shadow: 0 8px 32px rgba(0,0,0,0.5), 0 0 20px rgba(74, 240, 192, 0.1);
+  overflow: hidden;
 }
 
-.spatial-search-input {
-  width: 260px;
-  padding: 8px 14px;
-  background: rgba(0, 0, 0, 0.65);
-  border: 1px solid rgba(74, 240, 192, 0.3);
-  border-radius: 6px;
-  color: #e0f0ff;
+.memory-search-header {
+  display: flex;
+  align-items: center;
+  padding: 8px 12px;
+  border-bottom: 1px solid rgba(74, 240, 192, 0.15);
+  gap: 8px;
+}
+
+.memory-search-icon {
+  font-size: 14px;
+  opacity: 0.7;
+}
+
+#memory-search-input {
+  flex: 1;
+  background: transparent;
+  border: none;
+  color: #c0ffe0;
   font-family: 'JetBrains Mono', monospace;
   font-size: 13px;
   outline: none;
-  backdrop-filter: blur(8px);
-  transition: border-color 0.2s, box-shadow 0.2s;
 }
 
-.spatial-search-input:focus {
-  border-color: rgba(74, 240, 192, 0.7);
-  box-shadow: 0 0 12px rgba(74, 240, 192, 0.15);
+#memory-search-input::placeholder {
+  color: rgba(192, 255, 224, 0.35);
 }
 
-.spatial-search-input::placeholder {
-  color: rgba(224, 240, 255, 0.35);
-}
-
-.spatial-search-results {
-  margin-top: 4px;
-  max-height: 200px;
-  overflow-y: auto;
-  background: rgba(0, 0, 0, 0.55);
-  border: 1px solid rgba(74, 240, 192, 0.15);
-  border-radius: 4px;
-  font-size: 11px;
-  color: #a0c0d0;
-  width: 260px;
-  backdrop-filter: blur(8px);
-  display: none;
-}
-
-.spatial-search-results.visible {
-  display: block;
-}
-
-.spatial-search-result-item {
-  padding: 5px 10px;
+.memory-search-close {
   cursor: pointer;
-  border-bottom: 1px solid rgba(74, 240, 192, 0.08);
+  color: rgba(192, 255, 224, 0.4);
+  font-size: 14px;
+  padding: 2px 4px;
+  border-radius: 3px;
+}
+
+.memory-search-close:hover {
+  color: #ff4466;
+  background: rgba(255, 68, 102, 0.15);
+}
+
+#memory-search-results {
+  max-height: 340px;
+  overflow-y: auto;
+  scrollbar-width: thin;
+  scrollbar-color: rgba(74, 240, 192, 0.2) transparent;
+}
+
+.memory-search-result {
+  display: flex;
+  align-items: center;
+  padding: 8px 12px;
+  cursor: pointer;
+  gap: 10px;
+  border-bottom: 1px solid rgba(255,255,255,0.03);
+  transition: background 0.15s;
+}
+
+.memory-search-result:hover {
+  background: rgba(74, 240, 192, 0.08);
+}
+
+.memory-search-dot {
+  width: 8px;
+  height: 8px;
+  border-radius: 50%;
+  flex-shrink: 0;
+}
+
+.memory-search-text {
+  flex: 1;
+  font-size: 12px;
+  color: rgba(192, 255, 224, 0.75);
   white-space: nowrap;
   overflow: hidden;
   text-overflow: ellipsis;
+  font-family: 'JetBrains Mono', monospace;
 }
 
-.spatial-search-result-item:hover {
-  background: rgba(74, 240, 192, 0.1);
-  color: #e0f0ff;
-}
-
-.spatial-search-result-item .result-region {
-  color: #4af0c0;
-  font-size: 9px;
-  margin-right: 6px;
-}
-
-.spatial-search-count {
-  padding: 4px 10px;
-  color: rgba(74, 240, 192, 0.6);
+.memory-search-meta {
   font-size: 10px;
-  border-bottom: 1px solid rgba(74, 240, 192, 0.1);
+  color: rgba(192, 255, 224, 0.35);
+  flex-shrink: 0;
+  font-family: 'JetBrains Mono', monospace;
 }
 
+.memory-search-empty {
+  padding: 20px;
+  text-align: center;
+  color: rgba(192, 255, 224, 0.3);
+  font-size: 12px;
+  font-family: 'JetBrains Mono', monospace;
+}

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