fix: closes #721

Closes #1266

- Fix cmd_path calling nonexistent _load() -> use MnemosyneArchive()
- Add path to dispatch dict
- Add touch, decay, vitality, fading, vibrant CLI commands

app.js

@@ -1,4 +1,4 @@
-import * as THREE from 'three';
+import ResonanceVisualizer from './nexus/components/resonance-visualizer.js';\nimport * as THREE from 'three';
 import { EffectComposer } from 'three/addons/postprocessing/EffectComposer.js';
 import { RenderPass } from 'three/addons/postprocessing/RenderPass.js';
 import { UnrealBloomPass } from 'three/addons/postprocessing/UnrealBloomPass.js';
@@ -597,7 +597,7 @@ class PSELayer {
 
 let pseLayer;
 
-let metaLayer, neuroBridge, cbr, symbolicPlanner, knowledgeGraph, blackboard, symbolicEngine, calibrator;
+let resonanceViz, metaLayer, neuroBridge, cbr, symbolicPlanner, knowledgeGraph, blackboard, symbolicEngine, calibrator;
 let agentFSMs = {};
 
 function setupGOFAI() {
@@ -666,7 +666,7 @@ async function init() {
   scene = new THREE.Scene();
   scene.fog = new THREE.FogExp2(0x050510, 0.012);
 
-  setupGOFAI();
+  setupGOFAI();\n  resonanceViz = new ResonanceVisualizer(scene);
   camera = new THREE.PerspectiveCamera(65, window.innerWidth / window.innerHeight, 0.1, 1000);
   camera.position.copy(playerPos);
 
@@ -724,7 +724,7 @@ async function init() {
   // Mnemosyne: Periodic GOFAI Optimization
   setInterval(() => {
     console.info('[Mnemosyne] Running periodic optimization...');
-    MemoryOptimizer.optimize(SpatialMemory);
+    MemoryOptimizer.decaySpatialMemory(SpatialMemory);
   }, 1000 * 60 * 10); // Every 10 minutes
 
   fetchGiteaData();

nexus/components/memory-optimizer.js

@@ -1,13 +1,52 @@
 
 class MemoryOptimizer {
+    static _lastRun = Date.now();
+
     constructor(options = {}) {
-        this.threshold = options.threshold || 0.8;
-        this.decayRate = options.decayRate || 0.05;
+        this.threshold = options.threshold || 0.3;
+        this.decayRate = options.decayRate || 0.01;
+        this.lastRun = Date.now();
     }
-    optimize(memory) {
-        console.log('Optimizing memory...');
-        // Heuristic-based pruning
-        return memory.filter(m => m.strength > this.threshold);
+
+    optimize(memories) {
+        const now = Date.now();
+        const elapsed = (now - this.lastRun) / 1000;
+        this.lastRun = now;
+        return memories.map(m => {
+            const decay = (m.importance || 1) * this.decayRate * elapsed;
+            return { ...m, strength: Math.max(0, (m.strength || 1) - decay) };
+        }).filter(m => m.strength > this.threshold || m.locked);
+    }
+
+    /**
+     * Static decay pass — updates SpatialMemory crystals in-place.
+     * Call as: MemoryOptimizer.decaySpatialMemory(spatialMemoryModule)
+     */
+    static decaySpatialMemory(spatialMemory, { decayRate = 0.005, threshold = 0.15 } = {}) {
+        const now = Date.now();
+        const elapsed = (now - MemoryOptimizer._lastRun) / 1000;
+        MemoryOptimizer._lastRun = now;
+
+        const memEntries = spatialMemory.getAllMemoryEntries();
+        if (!memEntries || memEntries.length === 0) return 0;
+
+        let decayed = 0;
+        memEntries.forEach(entry => {
+            const currentStrength = entry.mesh?.userData?.strength ?? 0.7;
+            const importance = entry.data?.importance || 1;
+            const decay = importance * decayRate * elapsed;
+            const newStrength = Math.max(0, currentStrength - decay);
+
+            if (newStrength <= threshold && !entry.data?.locked) {
+                spatialMemory.removeMemory(entry.data.id);
+                decayed++;
+            } else if (entry.mesh) {
+                spatialMemory.updateMemory(entry.data.id, { strength: newStrength });
+            }
+        });
+
+        console.info(`[MemoryOptimizer] Decay pass: ${decayed} faded, ${memEntries.length - decayed} retained`);
+        return decayed;
     }
 }
 export default MemoryOptimizer;

nexus/components/resonance-visualizer.js

@@ -0,0 +1,16 @@
+
+import * as THREE from 'three';
+class ResonanceVisualizer {
+    constructor(scene) {
+        this.scene = scene;
+        this.links = [];
+    }
+    addLink(p1, p2, strength) {
+        const geometry = new THREE.BufferGeometry().setFromPoints([p1, p2]);
+        const material = new THREE.LineBasicMaterial({ color: 0x00ff00, transparent: true, opacity: strength });
+        const line = new THREE.Line(geometry, material);
+        this.scene.add(line);
+        this.links.push(line);
+    }
+}
+export default ResonanceVisualizer;

nexus/components/spatial-memory.js

@@ -601,6 +601,13 @@ const SpatialMemory = (() => {
     return Object.values(_memoryObjects).map(o => o.data);
   }
 
+  /**
+   * Return full memory entries (mesh + data) for batch operations like decay.
+   */
+  function getAllMemoryEntries() {
+    return Object.values(_memoryObjects);
+  }
+
   // ─── LOCALSTORAGE PERSISTENCE ────────────────────────
   function _indexHash(index) {
     // Simple hash of memory IDs + count to detect changes
@@ -863,6 +870,7 @@ const SpatialMemory = (() => {
   return {
     init, placeMemory, removeMemory, update, importMemories, updateMemory,
     getMemoryAtPosition, getRegionAtPosition, getMemoriesInRegion, getAllMemories,
+    getAllMemoryEntries,
     getCrystalMeshes, getMemoryFromMesh, highlightMemory, clearHighlight, getSelectedId,
     exportIndex, importIndex, searchNearby, REGIONS,
     saveToStorage, loadFromStorage, clearStorage,

nexus/mnemosyne/reasoner.py

@@ -0,0 +1,14 @@
+
+class Reasoner:
+    def __init__(self, rules):
+        self.rules = rules
+    def evaluate(self, entries):
+        return [r['action'] for r in self.rules if self._check(r['condition'], entries)]
+    def _check(self, cond, entries):
+        if cond.startswith('count'):
+            # e.g. count(type=anomaly)>3
+            p = cond.replace('count(', '').split(')')
+            key, val = p[0].split('=')
+            count = sum(1 for e in entries if e.get(key) == val)
+            return eval(f"{count}{p[1]}")
+        return False

nexus/mnemosyne/resonance_linker.py

@@ -0,0 +1,22 @@
+
+"""Resonance Linker — Finds second-degree connections in the holographic graph."""
+
+class ResonanceLinker:
+    def __init__(self, archive):
+        self.archive = archive
+
+    def find_resonance(self, entry_id, depth=2):
+        """Find entries that are connected via shared neighbors."""
+        if entry_id not in self.archive._entries: return []
+        
+        entry = self.archive._entries[entry_id]
+        neighbors = set(entry.links)
+        resonance = {}
+
+        for neighbor_id in neighbors:
+            if neighbor_id in self.archive._entries:
+                for second_neighbor in self.archive._entries[neighbor_id].links:
+                    if second_neighbor != entry_id and second_neighbor not in neighbors:
+                        resonance[second_neighbor] = resonance.get(second_neighbor, 0) + 1
+        
+        return sorted(resonance.items(), key=lambda x: x[1], reverse=True)

nexus/mnemosyne/rules.json

@@ -0,0 +1,6 @@
+[
+  {
+    "condition": "count(type=anomaly)>3",
+    "action": "alert"
+  }
+]

portal/bannerlord/INSTALL.md

@@ -0,0 +1,112 @@
+# 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

@@ -0,0 +1,115 @@
+#!/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

@@ -0,0 +1,16 @@
+# 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,7 +23,7 @@
     "rotation": { "y": 0.5 },
     "portal_type": "game-world",
     "world_category": "strategy-rpg",
-    "environment": "production",
+    "environment": "local",
     "access_mode": "operator",
     "readiness_state": "downloaded",
     "readiness_steps": {
@@ -37,11 +37,15 @@
     "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": {
       "url": null,
       "type": "harness",
       "action_label": "Enter Calradia",
-      "params": { "world": "calradia" }
+      "params": { "world": "calradia", "runtime": "wine/gptk" }
     }
   },
   {