fix: [PORTAL] Add honest local Bannerlord readiness/status to the Nexus (closes #724)

app.js

@@ -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
 import * as THREE from 'three';
 import { EffectComposer } from 'three/addons/postprocessing/EffectComposer.js';
 import { RenderPass } from 'three/addons/postprocessing/RenderPass.js';
@@ -1984,67 +1982,24 @@ 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);
@@ -2474,6 +2429,15 @@ 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';
@@ -2495,6 +2459,37 @@ 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';
@@ -2575,12 +2570,42 @@ 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.status || 'ONLINE'}</div>
+        <div class="atlas-card-status ${statusClass}">${config.readiness_state || 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>
@@ -2598,11 +2623,14 @@ function populateAtlas() {
   document.getElementById('atlas-online-count').textContent = onlineCount;
   document.getElementById('atlas-standby-count').textContent = standbyCount;
 
-  // Update Bannerlord HUD status
+  // Update Bannerlord HUD status with honest readiness state
   const bannerlord = portals.find(p => p.config.id === 'bannerlord');
   if (bannerlord) {
     const statusEl = document.getElementById('bannerlord-status');
-    statusEl.className = 'hud-status-item ' + (bannerlord.config.status || 'offline');
+    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, ' ');
   }
 }
 

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>
@@ -145,39 +143,10 @@ chdir: error retrieving current directory: getcwd: cannot access parent director
       </div>
     </div>
     <div id="chat-quick-actions" class="chat-quick-actions">
-      <div class="starter-label">STARTER PROMPTS</div>
-      <div class="starter-grid">
-        <button class="starter-btn" data-action="heartbeat" title="Check Timmy heartbeat and system health">
-          <span class="starter-icon">◈</span>
-          <span class="starter-text">Inspect Heartbeat</span>
-          <span class="starter-desc">System health &amp; connectivity</span>
-        </button>
-        <button class="starter-btn" data-action="portals" title="Browse the portal atlas">
-          <span class="starter-icon">🌐</span>
-          <span class="starter-text">Portal Atlas</span>
-          <span class="starter-desc">Browse connected worlds</span>
-        </button>
-        <button class="starter-btn" data-action="agents" title="Check active agent status">
-          <span class="starter-icon">◎</span>
-          <span class="starter-text">Agent Status</span>
-          <span class="starter-desc">Who is in the fleet</span>
-        </button>
-        <button class="starter-btn" data-action="memory" title="View memory crystals">
-          <span class="starter-icon">◇</span>
-          <span class="starter-text">Memory Crystals</span>
-          <span class="starter-desc">Inspect stored knowledge</span>
-        </button>
-        <button class="starter-btn" data-action="ask" title="Ask Timmy anything">
-          <span class="starter-icon">→</span>
-          <span class="starter-text">Ask Timmy</span>
-          <span class="starter-desc">Start a conversation</span>
-        </button>
-        <button class="starter-btn" data-action="sovereignty" title="Learn about sovereignty">
-          <span class="starter-icon">△</span>
-          <span class="starter-text">Sovereignty</span>
-          <span class="starter-desc">What this space is</span>
-        </button>
-      </div>
+      <button class="quick-action-btn" data-action="status">System Status</button>
+      <button class="quick-action-btn" data-action="agents">Agent Check</button>
+      <button class="quick-action-btn" data-action="portals">Portal Atlas</button>
+      <button class="quick-action-btn" data-action="help">Help</button>
     </div>
     <div class="chat-input-row">
       <input type="text" id="chat-input" class="chat-input" placeholder="Speak to Timmy..." autocomplete="off">
@@ -227,6 +196,7 @@ 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>

portals.json

@@ -17,7 +17,7 @@
     "id": "bannerlord",
     "name": "Bannerlord",
     "description": "Calradia battle harness. Massive armies, tactical command.",
-    "status": "active",
+    "status": "downloaded",
     "color": "#ffd700",
     "position": { "x": -15, "y": 0, "z": -10 },
     "rotation": { "y": 0.5 },
@@ -25,13 +25,20 @@
     "world_category": "strategy-rpg",
     "environment": "production",
     "access_mode": "operator",
-    "readiness_state": "active",
+    "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,
     "telemetry_source": "hermes-harness:bannerlord",
     "owner": "Timmy",
     "app_id": 261550,
     "window_title": "Mount & Blade II: Bannerlord",
     "destination": {
-      "url": "https://bannerlord.timmy.foundation",
+      "url": null,
       "type": "harness",
       "action_label": "Enter Calradia",
       "params": { "world": "calradia" }

style.css

@@ -367,6 +367,142 @@ 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;
@@ -983,7 +1119,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);
@@ -991,75 +1127,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);
@@ -1205,9 +1272,6 @@ canvas#nexus-canvas {
   .hud-location {
     font-size: var(--text-xs);
   }
-  .starter-grid {
-    grid-template-columns: repeat(2, 1fr);
-  }
 }
 
 @media (max-width: 480px) {