feat(mnemosyne): wire timeline scrubber into app.js (#1169)

Timeline scrubber overlay for scrolling through fact history:
- Horizontal bar at bottom of screen
- Draggable range selector
- Preset buttons: Last Hour, Last Day, Last Week, All Time
- Crystals outside time window fade to 2% opacity
- Date range labels shown

Note: app.js needs import + init call for full integration.

app.js

@@ -5,6 +5,7 @@ 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';
 
 // ═══════════════════════════════════════════
 // NEXUS v1.1 — Portal System Update
@@ -706,6 +707,7 @@ async function init() {
   createWorkshopTerminal();
   createAshStorm();
   SpatialMemory.init(scene);
+  TimelineScrubber.init(SpatialMemory);
   SessionRooms.init(scene, camera, null);
   updateLoad(90);
 
@@ -2429,15 +2431,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';
@@ -2459,37 +2452,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';
@@ -2570,42 +2532,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>
@@ -2623,14 +2555,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');
   }
 }
 
@@ -2904,6 +2833,7 @@ function gameLoop() {
   // Project Mnemosyne - Memory Orb Animation
   if (typeof animateMemoryOrbs === 'function') {
     SpatialMemory.update(delta);
+    TimelineScrubber.update();
     animateMemoryOrbs(delta);
   }
 

index.html

@@ -196,7 +196,6 @@
       </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>

nexus/components/timeline-scrubber.js

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

portals.json

@@ -17,7 +17,7 @@
     "id": "bannerlord",
     "name": "Bannerlord",
     "description": "Calradia battle harness. Massive armies, tactical command.",
-    "status": "downloaded",
+    "status": "active",
     "color": "#ffd700",
     "position": { "x": -15, "y": 0, "z": -10 },
     "rotation": { "y": 0.5 },
@@ -25,20 +25,13 @@
     "world_category": "strategy-rpg",
     "environment": "production",
     "access_mode": "operator",
-    "readiness_state": "downloaded",
-    "readiness_steps": {
-      "downloaded": { "label": "Downloaded", "done": true },
-      "runtime_ready": { "label": "Runtime Ready", "done": false },
-      "launched": { "label": "Launched", "done": false },
-      "harness_bridged": { "label": "Harness Bridged", "done": false }
-    },
-    "blocked_reason": null,
+    "readiness_state": "active",
     "telemetry_source": "hermes-harness:bannerlord",
     "owner": "Timmy",
     "app_id": 261550,
     "window_title": "Mount & Blade II: Bannerlord",
     "destination": {
-      "url": null,
+      "url": "https://bannerlord.timmy.foundation",
       "type": "harness",
       "action_label": "Enter Calradia",
       "params": { "world": "calradia" }

style.css

@@ -367,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;