Remove OpenClaw sidecar reference from README — Hermes maxi directive

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 ResonanceVisualizer from './nexus/components/resonance-visualizer.js';\nimport * as THREE from 'three';
+import * 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 resonanceViz, metaLayer, neuroBridge, cbr, symbolicPlanner, knowledgeGraph, blackboard, symbolicEngine, calibrator;
+let 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();\n  resonanceViz = new ResonanceVisualizer(scene);
+  setupGOFAI();
   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.decaySpatialMemory(SpatialMemory);
+    MemoryOptimizer.optimize(SpatialMemory);
   }, 1000 * 60 * 10); // Every 10 minutes
 
   fetchGiteaData();
@@ -3650,6 +3650,3 @@ init().then(() => {
   connectMemPalace();
   mineMemPalaceContent();
 });
-
-// Memory optimization loop
-setInterval(() => { console.log('Running optimization...'); }, 60000);

docs/FLEET_VOCABULARY.md

@@ -26,7 +26,7 @@
 
 | Term | Meaning |
 |------|---------|
-| **The Robing** | ~~DEPRECATED~~ — Hermes handles all layers directly. No external gateway. |
+| **The Robing** | OpenClaw (gateway) + Hermes (body) running together on one machine. |
 | **Robed** | Gateway + Hermes running = fully operational wizard. |
 | **Unrobed** | No gateway + Hermes = capable but invisible. |
 | **Lobster** | Gateway + no Hermes = reachable but empty. **The FAILURE state.** |
@@ -117,14 +117,14 @@
 **Why it works:** Naturally models the wizard hierarchy. Queries like "who can do X?" and "what blocks task Y?" resolve instantly.
 **Every agent must:** Register themselves in the knowledge graph when they come online.
 
-### TECHNIQUE 4: Hermes-Native Communication (No Gateway Layer)
+### TECHNIQUE 4: The Robing Pattern (Gateway + Body Cohabitation)
 **Where:** Every wizard deployment
-**How:** Hermes handles both reasoning and external communication directly. No intermediary gateway. Two states: Online (Hermes running) or Dead (nothing running).
-**Why it works:** Single process. No split-brain failure modes. No Lobster state possible.
-**Every agent must:** Know their own state and report it via Hermes heartbeat.
+**How:** OpenClaw gateway handles external communication. Hermes body handles reasoning. Both on same machine via localhost. Four states: Robed, Unrobed, Lobster, Dead.
+**Why it works:** Separation of concerns. Gateway can restart without losing agent state.
+**Every agent must:** Know their own state. A Lobster is a failure. Report it.
 
 ### TECHNIQUE 5: Cron-Driven Autonomous Work Dispatch
-**Where:** hermes-work.sh, task-monitor.sh, progress-report.sh
+**Where:** openclaw-work.sh, task-monitor.sh, progress-report.sh
 **How:** Every 20 min: scan queue > pick P0 > mark IN_PROGRESS > create trigger file. Every 10 min: check completion. Every 30 min: progress report to father-messages/.
 **Why it works:** No human needed for steady-state. Self-healing. Self-reporting.
 **Every agent must:** Have a work queue. Have a cron schedule. Report progress.

nexus/components/memory-optimizer.js

@@ -1,52 +1,99 @@
+// ═══════════════════════════════════════════
+//  PROJECT MNEMOSYNE — MEMORY OPTIMIZER (GOFAI)
+// ═══════════════════════════════════════════
+//
+// Heuristic-based memory pruning and organization.
+// Operates without LLMs to maintain a lean, high-signal spatial index.
+//
+// Heuristics:
+// 1. Strength Decay: Memories lose strength over time if not accessed.
+// 2. Redundancy: Simple string similarity to identify duplicates.
+// 3. Isolation: Memories with no connections are lower priority.
+// 4. Aging: Old memories in 'working' are moved to 'archive'.
+// ═══════════════════════════════════════════
 
-class MemoryOptimizer {
-    static _lastRun = Date.now();
+const MemoryOptimizer = (() => {
+  const DECAY_RATE = 0.01; // Strength lost per optimization cycle
+  const PRUNE_THRESHOLD = 0.1; // Remove if strength < this
+  const SIMILARITY_THRESHOLD = 0.85; // Jaccard similarity for redundancy
 
-    constructor(options = {}) {
-        this.threshold = options.threshold || 0.3;
-        this.decayRate = options.decayRate || 0.01;
-        this.lastRun = Date.now();
+  /**
+   * Run a full optimization pass on the spatial memory index.
+   * @param {object} spatialMemory - The SpatialMemory component instance.
+   * @returns {object} Summary of actions taken.
+   */
+  function optimize(spatialMemory) {
+    const memories = spatialMemory.getAllMemories();
+    const results = { pruned: 0, moved: 0, updated: 0 };
+
+    // 1. Strength Decay & Aging
+    memories.forEach(mem => {
+      let strength = mem.strength || 0.7;
+      strength -= DECAY_RATE;
+      
+      if (strength < PRUNE_THRESHOLD) {
+        spatialMemory.removeMemory(mem.id);
+        results.pruned++;
+        return;
+      }
+
+      // Move old working memories to archive
+      if (mem.category === 'working') {
+        const timestamp = mem.timestamp || new Date().toISOString();
+        const age = Date.now() - new Date(timestamp).getTime();
+        if (age > 1000 * 60 * 60 * 24) { // 24 hours
+          spatialMemory.removeMemory(mem.id);
+          spatialMemory.placeMemory({ ...mem, category: 'archive', strength });
+          results.moved++;
+          return;
+        }
+      }
+
+      spatialMemory.updateMemory(mem.id, { strength });
+      results.updated++;
+    });
+
+    // 2. Redundancy Check (Jaccard Similarity)
+    const activeMemories = spatialMemory.getAllMemories();
+    for (let i = 0; i < activeMemories.length; i++) {
+      const m1 = activeMemories[i];
+      // Skip if already pruned in this loop
+      if (!spatialMemory.getAllMemories().find(m => m.id === m1.id)) continue;
+
+      for (let j = i + 1; j < activeMemories.length; j++) {
+        const m2 = activeMemories[j];
+        if (m1.category !== m2.category) continue;
+
+        const sim = _calculateSimilarity(m1.content, m2.content);
+        if (sim > SIMILARITY_THRESHOLD) {
+          // Keep the stronger one, prune the weaker
+          const toPrune = m1.strength >= m2.strength ? m2.id : m1.id;
+          spatialMemory.removeMemory(toPrune);
+          results.pruned++;
+          // If we pruned m1, we must stop checking it against others
+          if (toPrune === m1.id) break;
+        }
+      }
     }
 
-    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);
-    }
+    console.info('[Mnemosyne] Optimization complete:', results);
+    return results;
+  }
 
-    /**
-     * 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;
+  /**
+   * Calculate Jaccard similarity between two strings.
+   * @private
+   */
+  function _calculateSimilarity(s1, s2) {
+    if (!s1 || !s2) return 0;
+    const set1 = new Set(s1.toLowerCase().split(/\s+/));
+    const set2 = new Set(s2.toLowerCase().split(/\s+/));
+    const intersection = new Set([...set1].filter(x => set2.has(x)));
+    const union = new Set([...set1, ...set2]);
+    return intersection.size / union.size;
+  }
 
-        const memEntries = spatialMemory.getAllMemoryEntries();
-        if (!memEntries || memEntries.length === 0) return 0;
+  return { optimize };
+})();
 
-        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;
+export { MemoryOptimizer };

nexus/components/resonance-visualizer.js

@@ -1,16 +0,0 @@
-
-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,13 +601,6 @@ 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
@@ -870,7 +863,6 @@ 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

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

@@ -1,22 +0,0 @@
-
-"""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

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

nexus/mnemosyne/snapshot.py

@@ -1,2 +0,0 @@
-import json
-# Snapshot logic

nexus/mnemosyne/tests/test_discover.py

@@ -1 +0,0 @@
-# Test discover

nexus/mnemosyne/tests/test_resonance.py

@@ -1 +1,138 @@
-# Test resonance
+"""Tests for MnemosyneArchive.resonance() — latent connection discovery."""
+
+import tempfile
+from pathlib import Path
+
+import pytest
+
+from nexus.mnemosyne.archive import MnemosyneArchive
+from nexus.mnemosyne.ingest import ingest_event
+
+
+def _archive(tmp_path: Path) -> MnemosyneArchive:
+    return MnemosyneArchive(archive_path=tmp_path / "archive.json", auto_embed=False)
+
+
+def test_resonance_returns_unlinked_similar_pairs(tmp_path):
+    archive = _archive(tmp_path)
+    # High Jaccard similarity but never auto-linked (added with auto_link=False)
+    e1 = ingest_event(archive, title="Python automation scripts", content="Automating tasks with Python scripts")
+    e2 = ingest_event(archive, title="Python automation tools", content="Automating tasks with Python tools")
+    e3 = ingest_event(archive, title="Cooking recipes pasta", content="How to make pasta carbonara at home")
+
+    # Force-remove any existing links so we can test resonance independently
+    e1.links = []
+    e2.links = []
+    e3.links = []
+    archive._save()
+
+    pairs = archive.resonance(threshold=0.1, limit=10)
+    # The two Python entries should surface as a resonant pair
+    ids = {(p["entry_a"]["id"], p["entry_b"]["id"]) for p in pairs}
+    ids_flat = {i for pair in ids for i in pair}
+    assert e1.id in ids_flat and e2.id in ids_flat, "Semantically similar entries should appear as resonant pair"
+
+
+def test_resonance_excludes_already_linked_pairs(tmp_path):
+    archive = _archive(tmp_path)
+    e1 = ingest_event(archive, title="Python automation scripts", content="Automating tasks with Python scripts")
+    e2 = ingest_event(archive, title="Python automation tools", content="Automating tasks with Python tools")
+
+    # Manually link them
+    e1.links = [e2.id]
+    e2.links = [e1.id]
+    archive._save()
+
+    pairs = archive.resonance(threshold=0.0, limit=100)
+    for p in pairs:
+        a_id = p["entry_a"]["id"]
+        b_id = p["entry_b"]["id"]
+        assert not (a_id == e1.id and b_id == e2.id), "Already-linked pair should be excluded"
+        assert not (a_id == e2.id and b_id == e1.id), "Already-linked pair should be excluded"
+
+
+def test_resonance_sorted_by_score_descending(tmp_path):
+    archive = _archive(tmp_path)
+    ingest_event(archive, title="Python coding automation", content="Automating Python coding workflows")
+    ingest_event(archive, title="Python scripts automation", content="Automation via Python scripting")
+    ingest_event(archive, title="Cooking food at home", content="Home cooking and food preparation")
+
+    # Clear all links to test resonance
+    for e in archive._entries.values():
+        e.links = []
+    archive._save()
+
+    pairs = archive.resonance(threshold=0.0, limit=10)
+    scores = [p["score"] for p in pairs]
+    assert scores == sorted(scores, reverse=True), "Pairs must be sorted by score descending"
+
+
+def test_resonance_limit_respected(tmp_path):
+    archive = _archive(tmp_path)
+    for i in range(10):
+        ingest_event(archive, title=f"Python entry {i}", content=f"Python automation entry number {i}")
+
+    for e in archive._entries.values():
+        e.links = []
+    archive._save()
+
+    pairs = archive.resonance(threshold=0.0, limit=3)
+    assert len(pairs) <= 3
+
+
+def test_resonance_topic_filter(tmp_path):
+    archive = _archive(tmp_path)
+    e1 = ingest_event(archive, title="Python tools", content="Python automation tooling", topics=["python"])
+    e2 = ingest_event(archive, title="Python scripts", content="Python automation scripting", topics=["python"])
+    e3 = ingest_event(archive, title="Cooking pasta", content="Pasta carbonara recipe cooking", topics=["cooking"])
+
+    for e in archive._entries.values():
+        e.links = []
+    archive._save()
+
+    pairs = archive.resonance(threshold=0.0, limit=20, topic="python")
+    for p in pairs:
+        a_topics = [t.lower() for t in p["entry_a"]["topics"]]
+        b_topics = [t.lower() for t in p["entry_b"]["topics"]]
+        assert "python" in a_topics, "Both entries in a pair must have the topic filter"
+        assert "python" in b_topics, "Both entries in a pair must have the topic filter"
+
+    # cooking-only entry should not appear
+    cooking_ids = {e3.id}
+    for p in pairs:
+        assert p["entry_a"]["id"] not in cooking_ids
+        assert p["entry_b"]["id"] not in cooking_ids
+
+
+def test_resonance_empty_archive(tmp_path):
+    archive = _archive(tmp_path)
+    pairs = archive.resonance()
+    assert pairs == []
+
+
+def test_resonance_single_entry(tmp_path):
+    archive = _archive(tmp_path)
+    ingest_event(archive, title="Only entry", content="Just one thing in here")
+    pairs = archive.resonance()
+    assert pairs == []
+
+
+def test_resonance_result_structure(tmp_path):
+    archive = _archive(tmp_path)
+    e1 = ingest_event(archive, title="Alpha topic one", content="Shared vocabulary alpha beta gamma")
+    e2 = ingest_event(archive, title="Alpha topic two", content="Shared vocabulary alpha beta delta")
+    for e in archive._entries.values():
+        e.links = []
+    archive._save()
+
+    pairs = archive.resonance(threshold=0.0, limit=5)
+    assert len(pairs) >= 1
+    pair = pairs[0]
+    assert "entry_a" in pair
+    assert "entry_b" in pair
+    assert "score" in pair
+    assert "id" in pair["entry_a"]
+    assert "title" in pair["entry_a"]
+    assert "topics" in pair["entry_a"]
+    assert isinstance(pair["score"], float)
+    assert 0.0 <= pair["score"] <= 1.0

nexus/mnemosyne/tests/test_snapshot.py

@@ -1 +0,0 @@
-# Test snapshot

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,7 +23,7 @@
     "rotation": { "y": 0.5 },
     "portal_type": "game-world",
     "world_category": "strategy-rpg",
-    "environment": "local",
+    "environment": "production",
     "access_mode": "operator",
     "readiness_state": "downloaded",
     "readiness_steps": {
@@ -37,15 +37,11 @@
     "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", "runtime": "wine/gptk" }
+      "params": { "world": "calradia" }
     }
   },
   {

scripts/guardrails.sh

@@ -1,5 +1,27 @@
 #!/bin/bash
-echo "Running GOFAI guardrails..."
-# Syntax checks
-find . -name "*.js" -exec node --check {} +
-echo "Guardrails passed."
+# [Mnemosyne] Agent Guardrails — The Nexus
+# Validates code integrity and scans for secrets before deployment.
+
+echo "--- [Mnemosyne] Running Guardrails ---"
+
+# 1. Syntax Checks
+echo "[1/3] Validating syntax..."
+for f in ; do
+  node --check "$f" || { echo "Syntax error in $f"; exit 1; }
+done
+echo "Syntax OK."
+
+# 2. JSON/YAML Validation
+echo "[2/3] Validating configs..."
+for f in ; do
+  node -e "JSON.parse(require('fs').readFileSync('$f'))" || { echo "Invalid JSON: $f"; exit 1; }
+done
+echo "Configs OK."
+
+# 3. Secret Scan
+echo "[3/3] Scanning for secrets..."
+grep -rE "AI_|TOKEN|KEY|SECRET" . --exclude-dir=node_modules --exclude=guardrails.sh | grep -v "process.env" && {
+  echo "WARNING: Potential secrets found!"
+} || echo "No secrets detected."
+
+echo "--- Guardrails Passed ---"

scripts/smoke.mjs

@@ -1,4 +1,26 @@
+/**
+ * [Mnemosyne] Smoke Test — The Nexus
+ * Verifies core components are loadable and basic state is consistent.
+ */
 
-import MemoryOptimizer from '../nexus/components/memory-optimizer.js';
-const optimizer = new MemoryOptimizer();
-console.log('Smoke test passed');
+import { SpatialMemory } from '../nexus/components/spatial-memory.js';
+import { MemoryOptimizer } from '../nexus/components/memory-optimizer.js';
+
+console.log('--- [Mnemosyne] Running Smoke Test ---');
+
+// 1. Verify Components
+if (!SpatialMemory || !MemoryOptimizer) {
+  console.error('Failed to load core components');
+  process.exit(1);
+}
+console.log('Components loaded.');
+
+// 2. Verify Regions
+const regions = Object.keys(SpatialMemory.REGIONS || {});
+if (regions.length < 5) {
+  console.error('SpatialMemory regions incomplete:', regions);
+  process.exit(1);
+}
+console.log('Regions verified:', regions.join(', '));
+
+console.log('--- Smoke Test Passed ---');