Living Memory System

🧠 Overview

Living Memory is a sophisticated filesystem-based memory system that provides two powerful modes of operation: RAW and JSON. This system enables intelligent data organization, retrieval, and management through a flexible and intuitive interface.

🛠️ Core Features

RAW Mode Operations

• create_file: Create plain text files
• create_dir: Create directories
• move_file: Move files between locations
• move_dir: Move directories
• append_content: Add content to existing files
• rename_file: Rename files
• read_all_files: List all files in the system
• read_file_content: Read file contents
• fuzzy_search: Search through files

JSON Mode Enhancements

• Tag-based organization
• Structured data storage
• Enhanced search capabilities
• Metadata management
• Automatic JSON formatting

💡 Use Cases

1. Knowledge Management

   • Personal knowledge bases
   • Research documentation
   • Project wikis
   • Learning resources

2. Data Organization

   • Structured content management
   • Tagged file systems
   • Hierarchical information storage
   • Version tracking

3. Information Retrieval

   • Smart searching
   • Content discovery
   • Relationship mapping
   • Context preservation

🎯 Prompting Examples

RAW Mode

// Create a new file
MODE_RAW.create_file({
  name: "notes.txt",
  content: "Important meeting notes",
});

// Move a file
MODE_RAW.move_file({
  source: "old/path.txt",
  dest: "new/path.txt",
});

JSON Mode

// Create a tagged file
MODE_JSON.create_file({
  name: "project_alpha.txt",
  tags: ["project", "alpha", "documentation"],
  content: {
    title: "Project Alpha",
    status: "active",
    priority: "high",
  },
});

// Fuzzy search
MODE_JSON.fuzzy_search({
  query: "alpha project",
});

🚀 Capabilities

File Management

• Create, read, update, and delete operations
• Directory structure maintenance
• File movement and organization
• Content appending and modification

Search & Discovery

• Full-text search
• Tag-based filtering
• Fuzzy matching
• Pattern recognition

Data Structure

• Flexible content formats
• Metadata management
• Relationship mapping
• Version control support

Security

• File integrity checks
• Access control
• Data validation
• Error handling

📝 Implementation Notes

The system utilizes a hybrid approach combining traditional filesystem operations with enhanced JSON-based storage:

1. RAW Mode provides direct filesystem access for basic operations
2. JSON Mode adds a layer of structured data management
3. Files in JSON mode automatically receive the .json extension
4. Tags provide additional context and improved searchability
5. Both modes support comprehensive error handling

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.

👤 Author

XroSilence

Made with 💡 by XroSilence | GPL-3.0 License