feat(mnemosyne): trust-based crystal rendering (#1166)

Wire crystal visual properties to fact trust scores:
- Trust > 0.8: bright glow, full opacity
- Trust 0.5-0.8: medium glow, 80% opacity
- Trust < 0.5: dim, 40% opacity
- Trust < 0.3: near-invisible, pulsing red

Adds:
- _getTrustVisuals() helper computes material props from trust
- updateMemoryVisual() for runtime trust updates
- trust persisted in exportIndex and localStorage
- Low-trust crystals pulse red in update() loop

Closes #1166

nexus/components/spatial-memory.js

@@ -140,6 +140,47 @@ 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];
@@ -216,17 +257,20 @@ 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: region.color,
-      emissiveIntensity: 1.5 * strength,
+      emissive: tv.emissiveColor,
+      emissiveIntensity: tv.emissiveIntensity,
       metalness: 0.6,
       roughness: 0.15,
       transparent: true,
-      opacity: 0.5 + strength * 0.4
+      opacity: tv.opacity
     });
 
     const crystal = new THREE.Mesh(geo, mat);
@@ -239,10 +283,12 @@ 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(region.color, 0.8 * strength, 5);
+    const light = new THREE.PointLight(tv.emissiveColor, tv.lightIntensity, 5);
     crystal.add(light);
 
     _scene.add(crystal);
@@ -337,8 +383,16 @@ 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;
-        mesh.material.emissiveIntensity = 1.0 + Math.sin(mesh.userData.pulse * 0.7) * 0.5 * base;
+        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;
+        }
       }
     });
 
@@ -368,6 +422,42 @@ 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;
@@ -507,6 +597,7 @@ 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 || []
       }))
     };
@@ -653,7 +744,7 @@ const SpatialMemory = (() => {
   }
 
   return {
-    init, placeMemory, removeMemory, update,
+    init, placeMemory, removeMemory, update, updateMemoryVisual,
     getMemoryAtPosition, getRegionAtPosition, getMemoriesInRegion, getAllMemories,
     getCrystalMeshes, getMemoryFromMesh, highlightMemory, clearHighlight, getSelectedId,
     exportIndex, importIndex, searchNearby, REGIONS,

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" }
     }
   },
   {