@dollhousemcp/mcp-server 1.9.0 → 1.9.1

package/README.github.md

@@ -97,11 +97,11 @@
 ```bash
 npm install @dollhousemcp/mcp-server
 ```
-See [Quick Start](#quick-start) for complete setup instructions.
+See [Quick Start](#-quick-start) for complete setup instructions.
 
 ---
 
-## 🎯 Element Types: Available Now & Coming Soon
+## 🎯 Element Types
 
 ### ✅ Available Now
 
@@ -121,7 +121,7 @@ Shape how your AI behaves and responds
 </td>
 <td width="50%">
 
-#### 💡 Skills  
+#### 💡 Skills
 Add specialized capabilities your AI can use
 - **Code Review** - Analyze code quality and suggest improvements
 - **Data Analysis** - Statistical analysis and visualization
@@ -159,18 +159,27 @@ Enable autonomous task completion
 </td>
 </tr>
 <tr>
-<td width="50%">
+<td colspan="2">
+
+#### 🧠 Memory <span style="background-color: #4CAF50; color: white; padding: 2px 6px; border-radius: 3px; font-size: 0.8em;">NEW in v1.9.0</span>
+Persistent context across sessions with intelligent organization
+- **Text-based storage** - Currently supports text content (PDFs, images, and other media types coming soon)
+- **Date-based folders** - Automatic YYYY-MM-DD organization prevents flat directory issues
+- **YAML format** - Human-readable structured data (vs Markdown for other elements)
+- **Smart deduplication** - SHA-256 hashing prevents duplicate storage
+- **Search indexing** - Fast queries across thousands of entries
+- **Use**: `"Create a memory for this project"` or `"Remember this conversation"`
 
-#### 🧠 Memory (NEW in v1.9.0!)
-Persistent context across sessions
-- **Project Context** - Remember project details and decisions
-- **Learning Progress** - Track skill development over time
-- **Personal Preferences** - Store user-specific settings
-- **Conversation History** - Maintain dialogue continuity
-- **Date-based organization** - Automatic folder structure
-- **Use**: `"Create a memory for this project"`
+**Typical file sizes**: Single memories up to ~100KB, folder structure enables unlimited collections
 
 </td>
+</tr>
+</table>
+
+### 🚀 Coming Soon
+
+<table>
+<tr>
 <td width="50%">
 
 #### 🎯 Ensembles
@@ -179,7 +188,18 @@ Combine multiple elements as one unified entity
 - **Writing Suite** - Creative + Technical + Editorial capabilities
 - **Security Team** - Analyst + Auditor + Remediation skills
 - **Data Science Platform** - Analysis + Visualization + ML skills
-- **Status**: Coming Soon
+- **Status**: In development
+
+</td>
+<td width="50%">
+
+#### 📋 Prompts
+Reusable instruction sets
+- **Code Review Checklist** - Systematic review steps
+- **Security Audit Guide** - Vulnerability assessment process
+- **Writing Guidelines** - Style and tone instructions
+- **Debug Workflow** - Problem-solving methodology
+- **Status**: Planned
 
 </td>
 </tr>
@@ -192,18 +212,18 @@ External function calls and commands
 - **Database Queries** - Direct database interaction
 - **API Calls** - External service integration
 - **File Operations** - Advanced file manipulation
-- **Status**: Planned
+- **Status**: Under consideration
 
 </td>
 <td width="50%">
 
-#### 📋 Prompts
-Reusable instruction sets
-- **Code Review Checklist** - Systematic review steps
-- **Security Audit Guide** - Vulnerability assessment process
-- **Writing Guidelines** - Style and tone instructions
-- **Debug Workflow** - Problem-solving methodology
-- **Status**: Planned
+#### 📚 Memory Enhancements
+Expanding memory capabilities
+- **PDF Support** - Text extraction from PDF documents
+- **Image Analysis** - Visual content understanding
+- **Audio Transcription** - Voice and sound processing
+- **Video Understanding** - Motion and scene analysis
+- **Status**: Roadmap planned
 
 </td>
 </tr>
@@ -297,7 +317,7 @@ Assistant: "I've saved 'Hard SciFi Writer' to your portfolio. You can activate i
 - **Save your favorites**: `"Save this configuration as my default setup"`
 - **Share with others**: `"Submit my custom persona to the community collection"`
 
-## 🚀 Quick Start
+## 📦 Installation
 
 ### Choose Your Installation Method
 
@@ -463,7 +483,7 @@ After configuring and restarting Claude Desktop, test with:
 list_elements type="personas"
 ```
 
-You should see your available personas. If not, check the [Troubleshooting](#troubleshooting) section.
+You should see your available personas. If not, check the [Troubleshooting](#-troubleshooting) section.
 
 ---
 
@@ -475,7 +495,7 @@ By default, your elements are stored in:
 
 Use the `DOLLHOUSE_PORTFOLIO_DIR` environment variable to customize this location.
 
-## 🎯 Getting Started
+## 🚀 Quick Start
 
 Once installed, try these commands in Claude:
 
@@ -521,14 +541,28 @@ Your portfolio is organized by element type:
 
 ```
 ~/.dollhouse/portfolio/
-├── personas/       # Behavioral profiles
-├── skills/         # Discrete capabilities  
-├── templates/      # Reusable content structures
-├── agents/         # Goal-oriented actors
-├── memories/       # Persistent context
-└── ensembles/      # Element combinations
+├── personas/       # Behavioral profiles (Markdown files)
+├── skills/         # Discrete capabilities (Markdown files)
+├── templates/      # Reusable content structures (Markdown files)
+├── agents/         # Goal-oriented actors (Markdown files)
+├── memories/       # Persistent context (YAML files with date folders)
+│   ├── 2025-09-18/
+│   │   └── project-context.yaml
+│   └── 2025-09-19/
+│       ├── meeting-notes.yaml
+│       └── code-review.yaml
+└── ensembles/      # Element combinations (Markdown files)
 ```
 
+**Note on File Types:**
+- **Markdown (.md)**: Used for personas, skills, templates, agents, and ensembles - human-readable with YAML frontmatter
+- **YAML (.yaml)**: Used exclusively for memories - structured data optimized for context storage
+
+**Memory Organization:**
+- Memories use automatic **YYYY-MM-DD** folder structure to prevent flat directory performance issues
+- Each memory file can grow up to ~100KB before creating a new file
+- Folder structure enables unlimited memory collections without degradation
+
 ### Key Features
 
 - **Local-First Architecture**: All elements stored locally with optional cloud sync

package/README.md

@@ -12,7 +12,7 @@ A comprehensive Model Context Protocol (MCP) server that enables dynamic AI pers
 **📦 NPM Package**: https://www.npmjs.com/package/@dollhousemcp/mcp-server  
 **🌍 Website**: https://dollhousemcp.com
 
-## 🚀 Quick Start
+## 📦 Installation
 
 ### Choose Your Installation Method
 
@@ -178,7 +178,7 @@ After configuring and restarting Claude Desktop, test with:
 list_elements type="personas"
 ```
 
-You should see your available personas. If not, check the [Troubleshooting](#troubleshooting) section.
+You should see your available personas. If not, check the [Troubleshooting](#-troubleshooting) section.
 
 ---
 
@@ -190,7 +190,7 @@ By default, your elements are stored in:
 
 Use the `DOLLHOUSE_PORTFOLIO_DIR` environment variable to customize this location.
 
-## 🎯 Getting Started
+## 🚀 Quick Start
 
 Once installed, try these commands in Claude: