Timmy_Foundation/the-nexus
15
1
Fork 2
Code Issues 93 Pull Requests 6 Actions Packages Projects Releases Wiki Activity

[Mnemosyne] Persist spatial memory state to localStorage #1158

New Issue
Closed
opened 2026-04-10 12:42:04 +00:00 by Rockachopa · 2 comments
Rockachopa commented 2026-04-10 12:42:04 +00:00
Owner
Copy Link

What

The Spatial Memory Schema (merged in #1156) maps memories to 3D regions, but all state is lost on page reload. Memories need to survive across sessions.

Why

A holographic archive that forgets everything when you close the browser is not an archive. Persistence is the foundation that makes every future Mnemosyne feature (search, ingestion, decay) meaningful.

How

  1. Auto-save on change: Call SpatialMemory.exportIndex() and save to localStorage whenever a memory is placed or removed
  2. Auto-load on init: In SpatialMemory.init(), check for saved state and restore via importIndex()
  3. Change detection: Only write when the index actually changed (avoid thrashing on every update tick)
  4. Quota handling: Wrap localStorage.setItem in try/catch — if quota exceeded, prune oldest archive-region memories first

Acceptance Criteria

  • Place a memory, reload page, memory reappears in same position
  • Remove a memory, reload page, memory stays removed
  • Console shows [SpatialMemory] Saved N memories to localStorage on save
  • Console shows [SpatialMemory] Restored N memories from localStorage on load
  • Graceful degradation if localStorage unavailable (no crash, just warn)
## What The Spatial Memory Schema (merged in #1156) maps memories to 3D regions, but all state is lost on page reload. Memories need to survive across sessions. ## Why A holographic archive that forgets everything when you close the browser is not an archive. Persistence is the foundation that makes every future Mnemosyne feature (search, ingestion, decay) meaningful. ## How 1. **Auto-save on change**: Call `SpatialMemory.exportIndex()` and save to `localStorage` whenever a memory is placed or removed 2. **Auto-load on init**: In `SpatialMemory.init()`, check for saved state and restore via `importIndex()` 3. **Change detection**: Only write when the index actually changed (avoid thrashing on every update tick) 4. **Quota handling**: Wrap `localStorage.setItem` in try/catch — if quota exceeded, prune oldest archive-region memories first ## Acceptance Criteria - [ ] Place a memory, reload page, memory reappears in same position - [ ] Remove a memory, reload page, memory stays removed - [ ] Console shows `[SpatialMemory] Saved N memories to localStorage` on save - [ ] Console shows `[SpatialMemory] Restored N memories from localStorage` on load - [ ] Graceful degradation if localStorage unavailable (no crash, just warn)
Timmy was assigned by Rockachopa 2026-04-10 12:42:04 +00:00
Rockachopa commented 2026-04-10 12:42:15 +00:00
Author
Owner
Copy Link

Claiming this issue

Claiming this issue
Rockachopa commented 2026-04-10 12:43:29 +00:00
Author
Owner
Copy Link

PR submitted: #1159

Adds localStorage persistence — auto-saves on memory place/remove, auto-restores on page load, handles quota exhaustion by pruning archive memories.

PR submitted: #1159 Adds localStorage persistence — auto-saves on memory place/remove, auto-restores on page load, handles quota exhaustion by pruning archive memories.
Timmy closed this issue 2026-04-10 19:03:43 +00:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
222-epic
3d-world
CI
Continuous integration, runners, workflow issues
 QA
Quality assurance, testing, and production audit
 actionable
agent-presence
aistudio-ready
assigned-aistudio
assigned-claude
assigned-claw-code
Queued for Code Claw (qwen/openrouter)
 assigned-gemini
assigned-groq
assigned-kimi
assigned-kimi
Dispatched to Kimi via OpenClaw
 assigned-perplexity
assigned-sonnet
blocked
Blocked by external dependency or merge conflict
 claude-ready
claw-code-done
Code Claw completed this task
 claw-code-in-progress
Code Claw is actively working
 deprioritized
duplicate
epic
Epic / umbrella issue
 gemini-api
Gemini API integration
 gemini-review
google-ai-ultra
Google AI Ultra integration work
 groq-ready
harness
identity
Timmy identity and branding
 infrastructure
kimi-done
Kimi completed this task
 kimi-in-progress
Kimi is actively working on this
 kimi-ready
lazzyPit
Lazarus Pit — automated agent resurrection and health recovery
 media-gen
AI media generation (image/video/audio)
 mnemosyne
Project Mnemosyne — The Living Holographic Archive
 modularization
needs-design
nostr
p0-critical
p1-important
p2-backlog
performance
perplexity-ready
portal
research
Deep research and planning tasks
 security
Security hardening, vulnerability fixes, access control
 sonnet-ready
sovereignty
velocity-engine
Auto-generated by velocity engine
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
KimiClaw Rockachopa Timmy allegro antigravity bezalel claude claw-code codex-agent ezra gemini google grok hermes kimi manus perplexity sonnet
No Assignees Timmy
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Timmy_Foundation/the-nexus#1158
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?