WIP: issue #701 (mimo swarm)

app.js

@@ -1,3 +1,5 @@
+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';
@@ -1982,24 +1984,67 @@ function setupControls() {
   document.getElementById('chat-quick-actions').addEventListener('click', (e) => {
     const btn = e.target.closest('.quick-action-btn');
     if (!btn) return;
-    
-    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;
-    }
+    handleQuickAction(btn.dataset.action);
   });
+
+// ═══ 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);

index.html

@@ -1,3 +1,5 @@
+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>
@@ -143,10 +145,39 @@
       </div>
     </div>
     <div id="chat-quick-actions" class="chat-quick-actions">
-      <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 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>
     </div>
     <div class="chat-input-row">
       <input type="text" id="chat-input" class="chat-input" placeholder="Speak to Timmy..." autocomplete="off">

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

@@ -23,21 +23,18 @@
     "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",
+    "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": "https://bannerlord.timmy.foundation",
+      "type": "harness",
       "action_label": "Enter Calradia",
-      "params": { "world": "calradia", "runtime": "wine/gptk" }
+      "params": { "world": "calradia" }
     }
   },
   {

style.css

@@ -983,7 +983,7 @@ canvas#nexus-canvas {
 
 .chat-quick-actions {
   display: flex;
-  flex-wrap: wrap;
+  flex-direction: column;
   gap: 6px;
   padding: 8px 12px;
   border-top: 1px solid var(--color-border);
@@ -991,6 +991,75 @@ 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);
@@ -1136,6 +1205,9 @@ canvas#nexus-canvas {
   .hud-location {
     font-size: var(--text-xs);
   }
+  .starter-grid {
+    grid-template-columns: repeat(2, 1fr);
+  }
 }
 
 @media (max-width: 480px) {