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

app.js

@@ -2429,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';
@@ -2450,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';
@@ -2530,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>
@@ -2553,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

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

portal/bannerlord/INSTALL.md

@@ -1,112 +0,0 @@
-# Bannerlord Local Install Guide (macOS / Apple Silicon)
-
-## Goal
-Run the GOG Mount & Blade II: Bannerlord build natively on Alexander's Mac (arm64, macOS Sequoia+).
-
-## Prerequisites
-- macOS 14+ on Apple Silicon (arm64)
-- ~60 GB free disk space (game + Wine prefix)
-- GOG installer files in `~/Downloads/`:
-  - `setup_mount__blade_ii_bannerlord_1.3.15.109797_(64bit)_(89124).exe`
-  - `setup_mount__blade_ii_bannerlord_1.3.15.109797_(64bit)_(89124)-1.bin` through `-13.bin`
-
-## Step 1: Install Porting Kit
-
-Porting Kit (free) wraps Wine/GPTK for macOS. It has a GUI but we automate what we can.
-
-```bash
-brew install --cask porting-kit
-```
-
-Launch it once to complete first-run setup:
-```bash
-open -a "Porting Kit"
-```
-
-## Step 2: Create Wine Prefix + Install Game
-
-**Option A: Via Porting Kit GUI (recommended)**
-
-1. Open Porting Kit
-2. Click "Install Game" → "Custom Port" or search for Bannerlord
-3. Point it at: `~/Downloads/setup_mount__blade_ii_bannerlord_1.3.15.109797_(64bit)_(89124).exe`
-4. Follow the GOG installer wizard
-5. Install to default path inside the Wine prefix
-6. When done, note the prefix path (usually `~/Library/Application Support/PortingKit/...`)
-
-**Option B: Manual Wine prefix (advanced)**
-
-If you have Homebrew Wine (or GPTK) installed:
-
-```bash
-# Create prefix
-export WINEPREFIX="$HOME/Games/Bannerlord"
-wine64 boot /init
-
-# Run the GOG installer (it auto-chains the .bin files)
-cd ~/Downloads
-wine64 setup_mount__blade_ii_bannerlord_1.3.15.109797_\(64bit\)_\(89124\).exe
-```
-
-Follow the GOG installer wizard. Default install path is fine.
-
-## Step 3: Locate the Game Binary
-
-After installation, the game executable is at:
-```
-$WINEPREFIX/drive_c/GOG Games/Mount & Blade II Bannerlord/bin/Win64_Shipping_Client/Bannerlord.exe
-```
-
-Or inside Porting Kit's prefix at:
-```
-~/Library/Application Support/PortingKit/<prefix-name>/drive_c/GOG Games/Mount & Blade II Bannerlord/bin/Win64_Shipping_Client/Bannerlord.exe
-```
-
-## Step 4: First Launch
-
-```bash
-# Find the actual path first, then:
-cd "$HOME/Games/Bannerlord/drive_c/GOG Games/Mount & Blade II Bannerlord/bin/Win64_Shipping_Client"
-wine64 Bannerlord.exe
-```
-
-Or use the launcher script:
-```bash
-./portal/bannerlord/launch.sh
-```
-
-## Step 5: Proof (Operator Checklist)
-
-- [ ] Game window opens and is visible on screen
-- [ ] At least the main menu renders (TaleWorlds logo, "Campaign", "Custom Battle", etc.)
-- [ ] Screenshot taken: save to `portal/bannerlord/proof/` 
-- [ ] Launch command recorded below for repeatability
-
-**Launch command (fill in after install):**
-```
-# Repeatable launch:
-./portal/bannerlord/launch.sh
-```
-
-## Troubleshooting
-
-**Black screen on launch:**
-- Try: `wine64 Bannerlord.exe -force-d3d11` or `-force-vulkan`
-- Set Windows version: `winecfg` → set to Windows 10
-
-**Missing DLLs:**
-- Install DirectX runtime: `winetricks d3dx9 d3dx10 d3dx11 vcrun2019`
-
-**Performance:**
-- GPTK/Rosetta overhead is expected; 30-60 FPS is normal on M1/M2
-- Lower in-game graphics settings to "Medium" for first run
-
-**Installer won't chain .bin files:**
-- Make sure all .bin files are in the same directory as the .exe
-- Verify with: `ls -la ~/Downloads/setup_mount__blade_ii_bannerlord_*`
-
-## References
-- GamePortal Protocol: `GAMEPORTAL_PROTOCOL.md`
-- Portal config: `portals.json` (entry: "bannerlord")
-- GOG App ID: Mount & Blade II: Bannerlord
-- Steam App ID: 261550 (for Steam stats integration)

portal/bannerlord/launch.sh

@@ -1,115 +0,0 @@
-#!/usr/bin/env bash
-# Bannerlord Launcher for macOS (Apple Silicon via Wine/GPTK)
-# Usage: ./portal/bannerlord/launch.sh [--wine-prefix PATH] [--exe PATH]
-
-set -euo pipefail
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-REPO_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
-
-# Defaults — override with flags or environment
-WINEPREFIX="${WINEPREFIX:-$HOME/Games/Bannerlord}"
-BANNERLORD_EXE=""
-WINE_CMD=""
-
-# Parse args
-while [[ $# -gt 0 ]]; do
-  case "$1" in
-    --wine-prefix) WINEPREFIX="$2"; shift 2 ;;
-    --exe) BANNERLORD_EXE="$2"; shift 2 ;;
-    --help)
-      echo "Usage: $0 [--wine-prefix PATH] [--exe PATH]"
-      echo ""
-      echo "Defaults:"
-      echo "  Wine prefix: $WINEPREFIX"
-      echo "  Auto-discovers Bannerlord.exe in the prefix"
-      exit 0
-      ;;
-    *) echo "Unknown arg: $1"; exit 1 ;;
-  esac
-done
-
-# Find wine command
-find_wine() {
-  if command -v wine64 &>/dev/null; then
-    echo "wine64"
-  elif command -v wine &>/dev/null; then
-    echo "wine"
-  elif [ -f "/Applications/Whisky.app/Contents/Resources/WhiskyCmd" ]; then
-    echo "/Applications/Whisky.app/Contents/Resources/WhiskyCmd"
-  else
-    echo ""
-  fi
-}
-
-WINE_CMD="$(find_wine)"
-if [ -z "$WINE_CMD" ]; then
-  echo "ERROR: No Wine runtime found."
-  echo "Install one of:"
-  echo "  brew install --cask porting-kit"
-  echo "  brew install --cask crossover"
-  echo "  brew tap apple/apple && brew install game-porting-toolkit"
-  exit 1
-fi
-
-echo "Wine runtime: $WINE_CMD"
-echo "Wine prefix:  $WINEPREFIX"
-
-# Find Bannerlord.exe if not specified
-if [ -z "$BANNERLORD_EXE" ]; then
-  # Search common GOG install paths
-  SEARCH_PATHS=(
-    "$WINEPREFIX/drive_c/GOG Games/Mount & Blade II Bannerlord/bin/Win64_Shipping_Client/Bannerlord.exe"
-    "$WINEPREFIX/drive_c/GOG Games/Mount Blade II Bannerlord/bin/Win64_Shipping_Client/Bannerlord.exe"
-    "$WINEPREFIX/drive_c/Program Files/Mount & Blade II Bannerlord/bin/Win64_Shipping_Client/Bannerlord.exe"
-  )
-
-  # Also search PortingKit prefixes
-  while IFS= read -r -d '' exe; do
-    SEARCH_PATHS+=("$exe")
-  done < <(find "$HOME/Library/Application Support/PortingKit" -name "Bannerlord.exe" -print0 2>/dev/null || true)
-
-  for path in "${SEARCH_PATHS[@]}"; do
-    if [ -f "$path" ]; then
-      BANNERLORD_EXE="$path"
-      break
-    fi
-  done
-fi
-
-if [ -z "$BANNERLORD_EXE" ] || [ ! -f "$BANNERLORD_EXE" ]; then
-  echo "ERROR: Bannerlord.exe not found."
-  echo "Searched:"
-  echo "  $WINEPREFIX/drive_c/GOG Games/"
-  echo "  ~/Library/Application Support/PortingKit/"
-  echo ""
-  echo "Run the install first. See: portal/bannerlord/INSTALL.md"
-  exit 1
-fi
-
-echo "Game binary:  $BANNERLORD_EXE"
-echo "Launching..."
-echo ""
-
-# Log the launch for proof
-LAUNCH_LOG="$SCRIPT_DIR/proof/launch_$(date +%Y%m%d_%H%M%S).log"
-mkdir -p "$SCRIPT_DIR/proof"
-{
-  echo "=== Bannerlord Launch ==="
-  echo "Date: $(date -Iseconds)"
-  echo "Wine: $WINE_CMD"
-  echo "Prefix: $WINEPREFIX"
-  echo "Binary: $BANNERLORD_EXE"
-  echo "User: $(whoami)"
-  echo "macOS: $(sw_vers -productVersion)"
-  echo "Arch: $(uname -m)"
-  echo "========================="
-} > "$LAUNCH_LOG"
-echo "Launch log: $LAUNCH_LOG"
-echo ""
-
-# Set the prefix and launch
-export WINEPREFIX
-EXE_DIR="$(dirname "$BANNERLORD_EXE")"
-cd "$EXE_DIR"
-exec "$WINE_CMD" "Bannerlord.exe" "$@"

portal/bannerlord/proof/README.md

@@ -1,16 +0,0 @@
-# Bannerlord Proof
-
-Screenshots and launch logs proving the game runs locally on the Mac.
-
-## How to capture proof
-
-1. Launch the game: `./portal/bannerlord/launch.sh`
-2. Wait for main menu to render
-3. Take screenshot: `screencapture -x portal/bannerlord/proof/main_menu_$(date +%Y%m%d).png`
-4. Save launch log (auto-generated by launch.sh)
-
-## Expected proof files
-
-- `main_menu_*.png` — screenshot of game main menu
-- `launch_*.log` — launch command + environment details
-- `ingame_*.png` — optional in-game screenshots

portals.json

@@ -17,27 +17,31 @@
     "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 },
     "portal_type": "game-world",
     "world_category": "strategy-rpg",
-    "environment": "local",
+    "environment": "production",
     "access_mode": "operator",
-    "readiness_state": "active",
-    "telemetry_source": "local-desktop:bannerlord",
+    "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",
-    "install_source": "gog",
-    "gog_version": "1.3.15.109797",
-    "launcher_script": "portal/bannerlord/launch.sh",
-    "install_guide": "portal/bannerlord/INSTALL.md",
     "destination": {
-      "type": "local-launch",
+      "url": null,
+      "type": "harness",
       "action_label": "Enter Calradia",
-      "params": { "world": "calradia", "runtime": "wine/gptk" }
+      "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;