fix: [Mnemosyne] Memory persistence export — dump spatial state to JSON (closes #1174)

app.js

@@ -2006,6 +2006,30 @@ function setupControls() {
   
   document.getElementById('atlas-toggle-btn').addEventListener('click', openPortalAtlas);
   document.getElementById('atlas-close-btn').addEventListener('click', closePortalAtlas);
+
+  // Mnemosyne export/import (#1174)
+  document.getElementById('mnemosyne-export-btn').addEventListener('click', () => {
+    const result = SpatialMemory.exportToFile();
+    if (result) {
+      addChatMessage('system', 'Mnemosyne: Exported ' + result.count + ' memories to ' + result.filename);
+    }
+  });
+
+  document.getElementById('mnemosyne-import-btn').addEventListener('click', () => {
+    document.getElementById('mnemosyne-import-file').click();
+  });
+
+  document.getElementById('mnemosyne-import-file').addEventListener('change', async (e) => {
+    const file = e.target.files[0];
+    if (!file) return;
+    try {
+      const result = await SpatialMemory.importFromFile(file);
+      addChatMessage('system', 'Mnemosyne: Imported ' + result.count + ' of ' + result.total + ' memories');
+    } catch (err) {
+      addChatMessage('system', 'Mnemosyne: Import failed — ' + err.message);
+    }
+    e.target.value = '';
+  });
 }
 
 function sendChatMessage(overrideText = null) {
@@ -2516,46 +2540,24 @@ function populateAtlas() {
   const grid = document.getElementById('atlas-grid');
   grid.innerHTML = '';
   
-  // Counters by status
   let onlineCount = 0;
   let standbyCount = 0;
-  let rebuildingCount = 0;
-  let localCount = 0;
-  let blockedCount = 0;
-  
-  // Group portals by environment
-  const byEnv = { production: [], staging: [], local: [] };
   
   portals.forEach(portal => {
     const config = portal.config;
-    const status = config.status || 'online';
-    const env = config.environment || 'production';
+    if (config.status === 'online') onlineCount++;
+    if (config.status === 'standby') standbyCount++;
     
-    // Count statuses
-    if (status === 'online' || status === 'active') onlineCount++;
-    else if (status === 'standby') standbyCount++;
-    else if (status === 'rebuilding') rebuildingCount++;
-    else if (status === 'local-only') localCount++;
-    else if (status === 'blocked') blockedCount++;
-    
-    // Group by environment
-    if (byEnv[env]) {
-      byEnv[env].push({ config, status });
-    } else {
-      byEnv['production'].push({ config, status });
-    }
-    
-    // Create atlas card
     const card = document.createElement('div');
     card.className = 'atlas-card';
     card.style.setProperty('--portal-color', config.color);
     
-    const statusClass = `status-${status}`;
+    const statusClass = `status-${config.status || 'online'}`;
     
     card.innerHTML = `
       <div class="atlas-card-header">
         <div class="atlas-card-name">${config.name}</div>
-        <div class="atlas-card-status ${statusClass}">${status.toUpperCase()}</div>
+        <div class="atlas-card-status ${statusClass}">${config.status || 'ONLINE'}</div>
       </div>
       <div class="atlas-card-desc">${config.description}</div>
       <div class="atlas-card-footer">
@@ -2572,18 +2574,9 @@ function populateAtlas() {
     grid.appendChild(card);
   });
   
-  // Update footer counts
   document.getElementById('atlas-online-count').textContent = onlineCount;
   document.getElementById('atlas-standby-count').textContent = standbyCount;
-  document.getElementById('atlas-rebuilding-count').textContent = rebuildingCount;
-  document.getElementById('atlas-local-count').textContent = localCount;
-  document.getElementById('atlas-blocked-count').textContent = blockedCount;
-  
-  // Populate status wall by environment
-  populateStatusWallEnv('production', byEnv.production);
-  populateStatusWallEnv('staging', byEnv.staging);
-  populateStatusWallEnv('local', byEnv.local);
-  
+
   // Update Bannerlord HUD status
   const bannerlord = portals.find(p => p.config.id === 'bannerlord');
   if (bannerlord) {
@@ -2592,75 +2585,6 @@ function populateAtlas() {
   }
 }
 
-function populateStatusWallEnv(envName, portalList) {
-  const container = document.getElementById(`${envName}-portals`);
-  const summary = document.getElementById(`${envName}-summary`);
-  container.innerHTML = '';
-  
-  if (portalList.length === 0) {
-    container.innerHTML = '<div class="status-portal-row"><span class="status-portal-name" style="font-style: italic; color: rgba(160,184,208,0.4);">No worlds</span></div>';
-    summary.textContent = 'No portals in this environment';
-    return;
-  }
-  
-  // Count statuses in this environment
-  const statusCounts = {};
-  portalList.forEach(({ config, status }) => {
-    statusCounts[status] = (statusCounts[status] || 0) + 1;
-  });
-  
-  // Create portal rows
-  portalList.forEach(({ config, status }) => {
-    const row = document.createElement('div');
-    row.className = 'status-portal-row';
-    
-    const indicator = document.createElement('span');
-    indicator.className = `status-portal-indicator status-dot ${status}`;
-    
-    const nameSpan = document.createElement('span');
-    nameSpan.className = 'status-portal-name';
-    nameSpan.textContent = config.name;
-    
-    const statusSpan = document.createElement('span');
-    statusSpan.style.fontSize = '9px';
-    statusSpan.style.textTransform = 'uppercase';
-    statusSpan.style.marginLeft = '8px';
-    statusSpan.style.color = getStatusColor(status);
-    statusSpan.textContent = status;
-    
-    row.appendChild(nameSpan);
-    row.appendChild(statusSpan);
-    row.appendChild(indicator);
-    container.appendChild(row);
-  });
-  
-  // Create summary
-  const summaryParts = Object.entries(statusCounts).map(([status, count]) => 
-    `${count} ${status}`
-  );
-  summary.textContent = summaryParts.join(' · ');
-}
-
-function getStatusColor(status) {
-  switch (status) {
-    case 'online':
-    case 'active':
-      return 'var(--color-primary)';
-    case 'standby':
-      return 'var(--color-gold)';
-    case 'rebuilding':
-      return '#ffa500';
-    case 'local-only':
-      return '#00ff88';
-    case 'blocked':
-      return '#ff0000';
-    case 'offline':
-      return 'var(--color-danger)';
-    default:
-      return 'var(--color-text-muted)';
-  }
-}
-
 function focusPortal(portal) {
   // Teleport player to a position in front of the portal
   const offset = new THREE.Vector3(0, 0, 6).applyEuler(new THREE.Euler(0, portal.config.rotation?.y || 0, 0));

index.html

@@ -233,6 +233,11 @@
         <div class="memory-meta-row"><span class="memory-meta-label">Time</span><span id="memory-panel-time">\u2014</span></div>
         <div class="memory-meta-row memory-meta-row--related"><span class="memory-meta-label">Related</span><span id="memory-panel-connections">\u2014</span></div>
       </div>
+      <div class="memory-panel-actions">
+        <button id="mnemosyne-export-btn" class="mnemosyne-action-btn" title="Export spatial memory to JSON">&#x2913; Export</button>
+        <button id="mnemosyne-import-btn" class="mnemosyne-action-btn" title="Import spatial memory from JSON">&#x2912; Import</button>
+        <input type="file" id="mnemosyne-import-file" accept=".json" style="display:none;">
+      </div>
     </div>
   </div>
 
@@ -264,57 +269,11 @@
       <div class="atlas-grid" id="atlas-grid">
         <!-- Portals will be injected here -->
       </div>
-      <!-- Portal Status Wall -->
-      <div class="atlas-status-wall">
-        <div class="status-wall-header">
-          <span class="status-wall-title">WORLD STATUS WALL</span>
-          <span class="status-wall-subtitle">Real-time portal health</span>
-        </div>
-        <div class="status-wall-grid">
-          <div class="status-wall-env" id="status-wall-production">
-            <div class="status-env-header">
-              <span class="status-env-dot production"></span>
-              <span class="status-env-label">PRODUCTION</span>
-            </div>
-            <div class="status-env-portals" id="production-portals"></div>
-            <div class="status-env-summary" id="production-summary"></div>
-          </div>
-          <div class="status-wall-env" id="status-wall-staging">
-            <div class="status-env-header">
-              <span class="status-env-dot staging"></span>
-              <span class="status-env-label">STAGING</span>
-            </div>
-            <div class="status-env-portals" id="staging-portals"></div>
-            <div class="status-env-summary" id="staging-summary"></div>
-          </div>
-          <div class="status-wall-env" id="status-wall-local">
-            <div class="status-env-header">
-              <span class="status-env-dot local"></span>
-              <span class="status-env-label">LOCAL</span>
-            </div>
-            <div class="status-env-portals" id="local-portals"></div>
-            <div class="status-env-summary" id="local-summary"></div>
-          </div>
-        </div>
-        <div class="status-wall-legend">
-          <div class="legend-item"><span class="status-dot online"></span> Online</div>
-          <div class="legend-item"><span class="status-dot rebuilding"></span> Rebuilding</div>
-          <div class="legend-item"><span class="status-dot local-only"></span> Local-only</div>
-          <div class="legend-item"><span class="status-dot blocked"></span> Blocked</div>
-          <div class="legend-item"><span class="status-dot offline"></span> Offline</div>
-        </div>
-      </div>
       <div class="atlas-footer">
         <div class="atlas-status-summary">
           <span class="status-indicator online"></span> <span id="atlas-online-count">0</span> ONLINE
           &nbsp;&nbsp;
           <span class="status-indicator standby"></span> <span id="atlas-standby-count">0</span> STANDBY
-          &nbsp;&nbsp;
-          <span class="status-indicator rebuilding"></span> <span id="atlas-rebuilding-count">0</span> REBUILDING
-          &nbsp;&nbsp;
-          <span class="status-indicator local-only"></span> <span id="atlas-local-count">0</span> LOCAL
-          &nbsp;&nbsp;
-          <span class="status-indicator blocked"></span> <span id="atlas-blocked-count">0</span> BLOCKED
         </div>
         <div class="atlas-hint">Click a portal to focus or teleport</div>
       </div>

nexus/components/spatial-memory.js

@@ -652,11 +652,93 @@ const SpatialMemory = (() => {
     return _selectedId;
   }
 
+  // ─── FILE EXPORT ──────────────────────────────────────
+  function exportToFile() {
+    const index = exportIndex();
+    const json = JSON.stringify(index, null, 2);
+    const date = new Date().toISOString().slice(0, 10);
+    const filename = 'mnemosyne-export-' + date + '.json';
+
+    const blob = new Blob([json], { type: 'application/json' });
+    const url = URL.createObjectURL(blob);
+    const a = document.createElement('a');
+    a.href = url;
+    a.download = filename;
+    document.body.appendChild(a);
+    a.click();
+    document.body.removeChild(a);
+    URL.revokeObjectURL(url);
+
+    console.info('[Mnemosyne] Exported', index.memories.length, 'memories to', filename);
+    return { filename, count: index.memories.length };
+  }
+
+  // ─── FILE IMPORT ──────────────────────────────────────
+  function importFromFile(file) {
+    return new Promise((resolve, reject) => {
+      if (!file) {
+        reject(new Error('No file provided'));
+        return;
+      }
+
+      const reader = new FileReader();
+      reader.onload = function(e) {
+        try {
+          const data = JSON.parse(e.target.result);
+
+          // Schema validation
+          if (!data || typeof data !== 'object') {
+            reject(new Error('Invalid JSON: not an object'));
+            return;
+          }
+          if (typeof data.version !== 'number') {
+            reject(new Error('Invalid schema: missing version field'));
+            return;
+          }
+          if (data.version !== STORAGE_VERSION) {
+            reject(new Error('Version mismatch: got ' + data.version + ', expected ' + STORAGE_VERSION));
+            return;
+          }
+          if (!Array.isArray(data.memories)) {
+            reject(new Error('Invalid schema: memories is not an array'));
+            return;
+          }
+
+          // Validate each memory entry
+          for (let i = 0; i < data.memories.length; i++) {
+            const mem = data.memories[i];
+            if (!mem.id || typeof mem.id !== 'string') {
+              reject(new Error('Invalid memory at index ' + i + ': missing or invalid id'));
+              return;
+            }
+            if (!mem.category || typeof mem.category !== 'string') {
+              reject(new Error('Invalid memory "' + mem.id + '": missing category'));
+              return;
+            }
+          }
+
+          const count = importIndex(data);
+          saveToStorage();
+          console.info('[Mnemosyne] Imported', count, 'memories from file');
+          resolve({ count, total: data.memories.length });
+        } catch (parseErr) {
+          reject(new Error('Failed to parse JSON: ' + parseErr.message));
+        }
+      };
+
+      reader.onerror = function() {
+        reject(new Error('Failed to read file'));
+      };
+
+      reader.readAsText(file);
+    });
+  }
+
   return {
     init, placeMemory, removeMemory, update,
     getMemoryAtPosition, getRegionAtPosition, getMemoriesInRegion, getAllMemories,
     getCrystalMeshes, getMemoryFromMesh, highlightMemory, clearHighlight, getSelectedId,
-    exportIndex, importIndex, searchNearby, REGIONS,
+    exportIndex, importIndex, exportToFile, importFromFile, searchNearby, REGIONS,
     saveToStorage, loadFromStorage, clearStorage,
     runGravityLayout
   };

portals.json

@@ -4,7 +4,6 @@
     "name": "Morrowind",
     "description": "The Vvardenfell harness. Ash storms and ancient mysteries.",
     "status": "online",
-    "environment": "production",
     "color": "#ff6600",
     "position": { "x": 15, "y": 0, "z": -10 },
     "rotation": { "y": -0.5 },
@@ -18,13 +17,13 @@
     "id": "bannerlord",
     "name": "Bannerlord",
     "description": "Calradia battle harness. Massive armies, tactical command.",
-    "status": "online",
-    "environment": "production",
+    "status": "active",
     "color": "#ffd700",
     "position": { "x": -15, "y": 0, "z": -10 },
     "rotation": { "y": 0.5 },
     "portal_type": "game-world",
     "world_category": "strategy-rpg",
+    "environment": "production",
     "access_mode": "operator",
     "readiness_state": "active",
     "telemetry_source": "hermes-harness:bannerlord",
@@ -43,7 +42,6 @@
     "name": "Workshop",
     "description": "The creative harness. Build, script, and manifest.",
     "status": "online",
-    "environment": "production",
     "color": "#4af0c0",
     "position": { "x": 0, "y": 0, "z": -20 },
     "rotation": { "y": 0 },
@@ -58,7 +56,6 @@
     "name": "Archive",
     "description": "The repository of all knowledge. History, logs, and ancient data.",
     "status": "online",
-    "environment": "production",
     "color": "#0066ff",
     "position": { "x": 25, "y": 0, "z": 0 },
     "rotation": { "y": -1.57 },
@@ -73,7 +70,6 @@
     "name": "Chapel",
     "description": "A sanctuary for reflection and digital peace.",
     "status": "online",
-    "environment": "production",
     "color": "#ffd700",
     "position": { "x": -25, "y": 0, "z": 0 },
     "rotation": { "y": 1.57 },
@@ -88,7 +84,6 @@
     "name": "Courtyard",
     "description": "The open nexus. A place for agents to gather and connect.",
     "status": "online",
-    "environment": "production",
     "color": "#4af0c0",
     "position": { "x": 15, "y": 0, "z": 10 },
     "rotation": { "y": -2.5 },
@@ -103,7 +98,6 @@
     "name": "Gate",
     "description": "The transition point. Entry and exit from the Nexus core.",
     "status": "standby",
-    "environment": "staging",
     "color": "#ff4466",
     "position": { "x": -15, "y": 0, "z": 10 },
     "rotation": { "y": 2.5 },
@@ -112,20 +106,5 @@
       "type": "harness",
       "params": { "mode": "transit" }
     }
-  },
-  {
-    "id": "dev",
-    "name": "Dev Sandbox",
-    "description": "Local development world. Unstable, experimental, honest.",
-    "status": "local-only",
-    "environment": "local",
-    "color": "#00ff88",
-    "position": { "x": 0, "y": 0, "z": 20 },
-    "rotation": { "y": 0 },
-    "destination": {
-      "url": "http://localhost:3000",
-      "type": "local",
-      "params": { "mode": "dev" }
-    }
   }
 ]

style.css

@@ -365,11 +365,7 @@ canvas#nexus-canvas {
 }
 
 .status-online { background: rgba(74, 240, 192, 0.2); color: var(--color-primary); border: 1px solid var(--color-primary); }
-.status-active { 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-rebuilding { background: rgba(255, 165, 0, 0.2); color: #ffa500; border: 1px solid #ffa500; }
-.status-local-only { background: rgba(0, 255, 136, 0.2); color: #00ff88; border: 1px solid #00ff88; }
-.status-blocked { background: rgba(255, 0, 0, 0.2); color: #ff0000; border: 1px solid #ff0000; }
 .status-offline { background: rgba(255, 68, 102, 0.2); color: var(--color-danger); border: 1px solid var(--color-danger); }
 
 .atlas-card-desc {
@@ -414,165 +410,6 @@ canvas#nexus-canvas {
   font-style: italic;
 }
 
-/* Portal Status Wall */
-.atlas-status-wall {
-  padding: 20px 30px;
-  border-top: 1px solid var(--color-border);
-  background: rgba(10, 15, 40, 0.5);
-}
-
-.status-wall-header {
-  display: flex;
-  flex-direction: column;
-  gap: 4px;
-  margin-bottom: 16px;
-}
-
-.status-wall-title {
-  font-family: var(--font-display);
-  font-size: 14px;
-  font-weight: 700;
-  color: var(--color-primary);
-  letter-spacing: 1px;
-}
-
-.status-wall-subtitle {
-  font-family: var(--font-body);
-  font-size: 11px;
-  color: var(--color-text-muted);
-}
-
-.status-wall-grid {
-  display: grid;
-  grid-template-columns: repeat(3, 1fr);
-  gap: 20px;
-  margin-bottom: 16px;
-}
-
-.status-wall-env {
-  background: rgba(20, 30, 60, 0.3);
-  border: 1px solid rgba(255, 255, 255, 0.05);
-  padding: 12px;
-  border-radius: 4px;
-}
-
-.status-env-header {
-  display: flex;
-  align-items: center;
-  gap: 8px;
-  margin-bottom: 10px;
-  padding-bottom: 8px;
-  border-bottom: 1px solid rgba(255, 255, 255, 0.05);
-}
-
-.status-env-dot {
-  width: 8px;
-  height: 8px;
-  border-radius: 50%;
-}
-
-.status-env-dot.production {
-  background: var(--color-primary);
-  box-shadow: 0 0 5px var(--color-primary);
-}
-
-.status-env-dot.staging {
-  background: var(--color-gold);
-  box-shadow: 0 0 5px var(--color-gold);
-}
-
-.status-env-dot.local {
-  background: #00ff88;
-  box-shadow: 0 0 5px #00ff88;
-}
-
-.status-env-label {
-  font-family: var(--font-display);
-  font-size: 11px;
-  font-weight: 600;
-  color: #fff;
-  letter-spacing: 0.5px;
-}
-
-.status-env-portals {
-  display: flex;
-  flex-direction: column;
-  gap: 6px;
-  margin-bottom: 10px;
-  max-height: 120px;
-  overflow-y: auto;
-}
-
-.status-portal-row {
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-  font-family: var(--font-body);
-  font-size: 11px;
-  color: var(--color-text-muted);
-  padding: 4px 0;
-}
-
-.status-portal-name {
-  flex: 1;
-  overflow: hidden;
-  text-overflow: ellipsis;
-  white-space: nowrap;
-}
-
-.status-portal-indicator {
-  width: 6px;
-  height: 6px;
-  border-radius: 50%;
-  margin-left: 8px;
-  flex-shrink: 0;
-}
-
-.status-env-summary {
-  font-family: var(--font-body);
-  font-size: 10px;
-  color: var(--color-text-muted);
-  padding-top: 8px;
-  border-top: 1px solid rgba(255, 255, 255, 0.05);
-}
-
-.status-wall-legend {
-  display: flex;
-  flex-wrap: wrap;
-  gap: 16px;
-  padding-top: 12px;
-  border-top: 1px solid rgba(255, 255, 255, 0.05);
-}
-
-.legend-item {
-  display: flex;
-  align-items: center;
-  gap: 6px;
-  font-family: var(--font-body);
-  font-size: 10px;
-  color: var(--color-text-muted);
-}
-
-.status-dot {
-  display: inline-block;
-  width: 6px;
-  height: 6px;
-  border-radius: 50%;
-}
-
-.status-dot.online { background: var(--color-primary); box-shadow: 0 0 4px var(--color-primary); }
-.status-dot.active { background: var(--color-primary); box-shadow: 0 0 4px var(--color-primary); }
-.status-dot.standby { background: var(--color-gold); box-shadow: 0 0 4px var(--color-gold); }
-.status-dot.rebuilding { background: #ffa500; box-shadow: 0 0 4px #ffa500; }
-.status-dot.local-only { background: #00ff88; box-shadow: 0 0 4px #00ff88; }
-.status-dot.blocked { background: #ff0000; box-shadow: 0 0 4px #ff0000; }
-.status-dot.offline { background: var(--color-danger); box-shadow: 0 0 4px var(--color-danger); }
-
-/* Additional status indicators for footer */
-.status-indicator.rebuilding { background: #ffa500; box-shadow: 0 0 5px #ffa500; }
-.status-indicator.local-only { background: #00ff88; box-shadow: 0 0 5px #00ff88; }
-.status-indicator.blocked { background: #ff0000; box-shadow: 0 0 5px #ff0000; }
-
 @keyframes fadeIn {
   from { opacity: 0; }
   to { opacity: 1; }
@@ -586,12 +423,6 @@ canvas#nexus-canvas {
   .atlas-content {
     max-height: 90vh;
   }
-  .status-wall-grid {
-    grid-template-columns: 1fr;
-  }
-  .atlas-status-wall {
-    padding: 15px 20px;
-  }
 }
 
 /* Debug overlay */
@@ -1630,6 +1461,43 @@ canvas#nexus-canvas {
   gap: 2px;
 }
 
+/* ═══════════════════════════════════════════════════════
+   PROJECT MNEMOSYNE — EXPORT/IMPORT ACTIONS (#1174)
+═══════════════════════════════════════════════════════ */
+
+.memory-panel-actions {
+  display: flex;
+  gap: 8px;
+  margin-top: 10px;
+  padding-top: 10px;
+  border-top: 1px solid rgba(123, 92, 255, 0.15);
+}
+
+.mnemosyne-action-btn {
+  flex: 1;
+  padding: 6px 10px;
+  background: rgba(123, 92, 255, 0.12);
+  border: 1px solid rgba(123, 92, 255, 0.3);
+  border-radius: 6px;
+  color: #a08cff;
+  font-size: 11px;
+  font-family: monospace;
+  cursor: pointer;
+  transition: all 0.15s ease;
+  text-align: center;
+  white-space: nowrap;
+}
+
+.mnemosyne-action-btn:hover {
+  background: rgba(123, 92, 255, 0.25);
+  border-color: rgba(123, 92, 255, 0.6);
+  color: #c4b5ff;
+}
+
+.mnemosyne-action-btn:active {
+  transform: scale(0.96);
+}
+
 /* ═══════════════════════════════════════════════════════
    PROJECT MNEMOSYNE — SESSION ROOM HUD PANEL (#1171)
 ═══════════════════════════════════════════════════════ */