the-nexus/spatial-memory-schema.json

{
  "version": "1.0.0",
  "project": "Mnemosyne",
  "description": "Spatial memory schema for holographic memory visualization",
  "rooms": {
    "library": {
      "name": "The Library",
      "category": "user_pref",
      "description": "User preferences and personal settings",
      "visual_theme": {
        "lighting": "soft_ambient",
        "colors": {
          "primary": "#8B4513",
          "secondary": "#DAA520",
          "accent": "#FFD700",
          "particle": "#FFE4B5"
        },
        "materials": {
          "floor": "dark_wood",
          "walls": "bookshelf",
          "ceiling": "vaulted_stone"
        },
        "particle_effects": [
          "dust_motes",
          "book_sparkles"
        ]
      },
      "spatial_bounds": {
        "center": [
          0,
          0,
          0
        ],
        "dimensions": [
          20,
          10,
          20
        ],
        "orb_density": 0.7
      },
      "object_types": {
        "preference": {
          "shape": "sphere",
          "base_size": 0.3,
          "glow_intensity": 0.8
        },
        "setting": {
          "shape": "cube",
          "base_size": 0.4,
          "glow_intensity": 0.6
        }
      }
    },
    "workshop": {
      "name": "The Workshop",
      "category": "project",
      "description": "Active projects and development work",
      "visual_theme": {
        "lighting": "bright_work",
        "colors": {
          "primary": "#4682B4",
          "secondary": "#B0C4DE",
          "accent": "#00BFFF",
          "particle": "#87CEEB"
        },
        "materials": {
          "floor": "polished_concrete",
          "walls": "blueprint_paper",
          "ceiling": "industrial_metal"
        },
        "particle_effects": [
          "blueprint_lines",
          "tool_sparks"
        ]
      },
      "spatial_bounds": {
        "center": [
          30,
          0,
          0
        ],
        "dimensions": [
          25,
          12,
          25
        ],
        "orb_density": 0.8
      },
      "object_types": {
        "project": {
          "shape": "pyramid",
          "base_size": 0.5,
          "glow_intensity": 0.9
        },
        "task": {
          "shape": "cube",
          "base_size": 0.3,
          "glow_intensity": 0.7
        }
      }
    },
    "armory": {
      "name": "The Armory",
      "category": "tool",
      "description": "Tools, skills, and capabilities",
      "visual_theme": {
        "lighting": "neon_glow",
        "colors": {
          "primary": "#2E8B57",
          "secondary": "#3CB371",
          "accent": "#00FF7F",
          "particle": "#98FB98"
        },
        "materials": {
          "floor": "chrome_grid",
          "walls": "server_rack",
          "ceiling": "neon_tube"
        },
        "particle_effects": [
          "data_streams",
          "circuit_traces"
        ]
      },
      "spatial_bounds": {
        "center": [
          0,
          0,
          30
        ],
        "dimensions": [
          15,
          8,
          15
        ],
        "orb_density": 0.6
      },
      "object_types": {
        "tool": {
          "shape": "octahedron",
          "base_size": 0.4,
          "glow_intensity": 1.0
        },
        "skill": {
          "shape": "sphere",
          "base_size": 0.35,
          "glow_intensity": 0.85
        }
      }
    },
    "commons": {
      "name": "The Commons",
      "category": "general",
      "description": "General knowledge and miscellaneous facts",
      "visual_theme": {
        "lighting": "natural_daylight",
        "colors": {
          "primary": "#9370DB",
          "secondary": "#BA55D3",
          "accent": "#DA70D6",
          "particle": "#E6E6FA"
        },
        "materials": {
          "floor": "grass",
          "walls": "floating_islands",
          "ceiling": "open_sky"
        },
        "particle_effects": [
          "floating_pollen",
          "lightning_bugs"
        ]
      },
      "spatial_bounds": {
        "center": [
          30,
          0,
          30
        ],
        "dimensions": [
          30,
          15,
          30
        ],
        "orb_density": 0.5
      },
      "object_types": {
        "fact": {
          "shape": "sphere",
          "base_size": 0.25,
          "glow_intensity": 0.7
        },
        "memory": {
          "shape": "dodecahedron",
          "base_size": 0.3,
          "glow_intensity": 0.65
        }
      }
    }
  },
  "object_properties": {
    "trust_mapping": {
      "description": "Maps trust score (0.0-1.0) to visual properties",
      "glow_intensity": {
        "min": 0.2,
        "max": 1.0,
        "curve": "linear"
      },
      "opacity": {
        "min": 0.3,
        "max": 1.0,
        "curve": "ease_in_out"
      }
    },
    "importance_mapping": {
      "description": "Maps importance (relation count) to visual properties",
      "scale": {
        "min": 0.2,
        "max": 2.0,
        "curve": "logarithmic"
      },
      "particle_density": {
        "min": 10,
        "max": 100,
        "curve": "linear"
      }
    },
    "lifecycle_events": {
      "FACT_CREATED": {
        "animation": "fade_in",
        "duration": 1.5,
        "particle_effect": "spawn_burst"
      },
      "FACT_UPDATED": {
        "animation": "pulse_glow",
        "duration": 0.8,
        "particle_effect": "update_ripple"
      },
      "FACT_REMOVED": {
        "animation": "dissolve",
        "duration": 2.0,
        "particle_effect": "scatter"
      },
      "FACT_RECALLED": {
        "animation": "beam_light",
        "duration": 1.0,
        "particle_effect": "recall_beam"
      }
    }
  },
  "connections": {
    "holographic_threads": {
      "description": "Visual connections between related memory orbs",
      "material": "transparent_glow",
      "colors": {
        "strong_relation": "#00FFFF",
        "medium_relation": "#00CED1",
        "weak_relation": "#5F9EA0"
      },
      "thickness": {
        "min": 0.02,
        "max": 0.1,
        "curve": "linear"
      }
    },
    "cross_room_portals": {
      "description": "Portals connecting different memory rooms",
      "effect": "swirling_vortex",
      "colors": {
        "library_workshop": "#FFD700",
        "workshop_armory": "#00BFFF",
        "armory_commons": "#00FF7F",
        "commons_library": "#DA70D6"
      }
    }
  },
  "rag_integration": {
    "retrieval_visualization": {
      "description": "How RAG retrieval results are visualized",
      "highlight_effect": "golden_glow",
      "spiral_arrangement": {
        "radius": 3.0,
        "height_step": 0.5,
        "rotation_step": 0.618033988749895
      },
      "relevance_scoring": {
        "high": {
          "color": "#FFD700",
          "size_multiplier": 1.5
        },
        "medium": {
          "color": "#FFA500",
          "size_multiplier": 1.2
        },
        "low": {
          "color": "#FF8C00",
          "size_multiplier": 1.0
        }
      }
    },
    "query_beam": {
      "description": "Beam from user to relevant memory orbs",
      "color": "#FFFFFF",
      "opacity": 0.8,
      "pulse_frequency": 2.0
    }
  },
  "animation_timing": {
    "orb_spawn_delay": 0.1,
    "room_transition_duration": 2.0,
    "connection_draw_speed": 0.5,
    "particle_fade_time": 1.5
  }
}