@dollhousemcp/mcp-server 1.8.1 โ†’ 1.9.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (58) hide show
  1. package/README.github.md +96 -33
  2. package/README.md +3 -3
  3. package/README.md.backup +100 -36
  4. package/README.npm.md +3 -3
  5. package/dist/collection/CollectionBrowser.d.ts.map +1 -1
  6. package/dist/collection/CollectionBrowser.js +6 -5
  7. package/dist/elements/memories/Memory.d.ts +190 -0
  8. package/dist/elements/memories/Memory.d.ts.map +1 -0
  9. package/dist/elements/memories/Memory.js +627 -0
  10. package/dist/elements/memories/MemoryManager.d.ts +136 -0
  11. package/dist/elements/memories/MemoryManager.d.ts.map +1 -0
  12. package/dist/elements/memories/MemoryManager.js +607 -0
  13. package/dist/elements/memories/MemorySearchIndex.d.ts +156 -0
  14. package/dist/elements/memories/MemorySearchIndex.d.ts.map +1 -0
  15. package/dist/elements/memories/MemorySearchIndex.js +690 -0
  16. package/dist/elements/memories/constants.d.ts +95 -0
  17. package/dist/elements/memories/constants.d.ts.map +1 -0
  18. package/dist/elements/memories/constants.js +102 -0
  19. package/dist/elements/memories/index.d.ts +7 -0
  20. package/dist/elements/memories/index.d.ts.map +1 -0
  21. package/dist/elements/memories/index.js +7 -0
  22. package/dist/elements/memories/utils.d.ts +68 -0
  23. package/dist/elements/memories/utils.d.ts.map +1 -0
  24. package/dist/elements/memories/utils.js +137 -0
  25. package/dist/generated/version.d.ts +2 -2
  26. package/dist/generated/version.js +3 -3
  27. package/dist/index.d.ts.map +1 -1
  28. package/dist/index.js +10 -4
  29. package/dist/security/audit/SecurityAuditor.d.ts.map +1 -1
  30. package/dist/security/audit/SecurityAuditor.js +24 -2
  31. package/dist/security/audit/config/suppressions.d.ts.map +1 -1
  32. package/dist/security/audit/config/suppressions.js +91 -1
  33. package/dist/security/securityMonitor.d.ts +1 -1
  34. package/dist/security/securityMonitor.d.ts.map +1 -1
  35. package/dist/security/securityMonitor.js +1 -1
  36. package/dist/server/tools/CollectionTools.js +7 -7
  37. package/package.json +1 -1
  38. package/dist/config/ConfigWizardDisplay.d.ts +0 -64
  39. package/dist/config/ConfigWizardDisplay.d.ts.map +0 -1
  40. package/dist/config/ConfigWizardDisplay.js +0 -150
  41. package/dist/config/WizardFirstResponse.d.ts +0 -25
  42. package/dist/config/WizardFirstResponse.d.ts.map +0 -1
  43. package/dist/config/WizardFirstResponse.js +0 -118
  44. package/dist/scripts/scripts/run-config-wizard.js +0 -57
  45. package/dist/scripts/src/config/ConfigManager.js +0 -799
  46. package/dist/scripts/src/config/ConfigWizard.js +0 -368
  47. package/dist/scripts/src/errors/SecurityError.js +0 -47
  48. package/dist/scripts/src/security/constants.js +0 -28
  49. package/dist/scripts/src/security/contentValidator.js +0 -415
  50. package/dist/scripts/src/security/errors.js +0 -32
  51. package/dist/scripts/src/security/regexValidator.js +0 -217
  52. package/dist/scripts/src/security/secureYamlParser.js +0 -272
  53. package/dist/scripts/src/security/securityMonitor.js +0 -111
  54. package/dist/scripts/src/security/validators/unicodeValidator.js +0 -315
  55. package/dist/scripts/src/utils/logger.js +0 -288
  56. package/dist/tools/getWelcomeMessage.d.ts +0 -41
  57. package/dist/tools/getWelcomeMessage.d.ts.map +0 -1
  58. package/dist/tools/getWelcomeMessage.js +0 -109
package/README.github.md CHANGED
@@ -97,11 +97,11 @@
97
97
  ```bash
98
98
  npm install @dollhousemcp/mcp-server
99
99
  ```
100
- See [Quick Start](#quick-start) for complete setup instructions.
100
+ See [Quick Start](#-quick-start) for complete setup instructions.
101
101
 
102
102
  ---
103
103
 
104
- ## ๐ŸŽฏ Element Types: Available Now & Coming Soon
104
+ ## ๐ŸŽฏ Element Types
105
105
 
106
106
  ### โœ… Available Now
107
107
 
@@ -121,7 +121,7 @@ Shape how your AI behaves and responds
121
121
  </td>
122
122
  <td width="50%">
123
123
 
124
- #### ๐Ÿ’ก Skills
124
+ #### ๐Ÿ’ก Skills
125
125
  Add specialized capabilities your AI can use
126
126
  - **Code Review** - Analyze code quality and suggest improvements
127
127
  - **Data Analysis** - Statistical analysis and visualization
@@ -156,34 +156,50 @@ Enable autonomous task completion
156
156
  - **Security Fix Specialist** - Vulnerability remediation
157
157
  - **Use**: `"Run the code reviewer agent"`
158
158
 
159
+ </td>
160
+ </tr>
161
+ <tr>
162
+ <td colspan="2">
163
+
164
+ #### ๐Ÿง  Memory <span style="background-color: #4CAF50; color: white; padding: 2px 6px; border-radius: 3px; font-size: 0.8em;">NEW in v1.9.0</span>
165
+ Persistent context across sessions with intelligent organization
166
+ - **Text-based storage** - Currently supports text content (PDFs, images, and other media types coming soon)
167
+ - **Date-based folders** - Automatic YYYY-MM-DD organization prevents flat directory issues
168
+ - **YAML format** - Human-readable structured data (vs Markdown for other elements)
169
+ - **Smart deduplication** - SHA-256 hashing prevents duplicate storage
170
+ - **Search indexing** - Fast queries across thousands of entries
171
+ - **Use**: `"Create a memory for this project"` or `"Remember this conversation"`
172
+
173
+ **Typical file sizes**: Single memories up to ~100KB, folder structure enables unlimited collections
174
+
159
175
  </td>
160
176
  </tr>
161
177
  </table>
162
178
 
163
- ### ๐Ÿ”„ Coming Soon
179
+ ### ๐Ÿš€ Coming Soon
164
180
 
165
181
  <table>
166
182
  <tr>
167
183
  <td width="50%">
168
184
 
169
- #### ๐Ÿง  Memory
170
- Persistent context across sessions
171
- - **Project Context** - Remember project details and decisions
172
- - **Learning Progress** - Track skill development over time
173
- - **Personal Preferences** - Store user-specific settings
174
- - **Conversation History** - Maintain dialogue continuity
175
- - **Status**: Coming Soon
176
-
177
- </td>
178
- <td width="50%">
179
-
180
185
  #### ๐ŸŽฏ Ensembles
181
186
  Combine multiple elements as one unified entity
182
187
  - **Full-Stack Developer** - Frontend + Backend + DevOps skills
183
188
  - **Writing Suite** - Creative + Technical + Editorial capabilities
184
189
  - **Security Team** - Analyst + Auditor + Remediation skills
185
190
  - **Data Science Platform** - Analysis + Visualization + ML skills
186
- - **Status**: Coming Soon
191
+ - **Status**: In development
192
+
193
+ </td>
194
+ <td width="50%">
195
+
196
+ #### ๐Ÿ“‹ Prompts
197
+ Reusable instruction sets
198
+ - **Code Review Checklist** - Systematic review steps
199
+ - **Security Audit Guide** - Vulnerability assessment process
200
+ - **Writing Guidelines** - Style and tone instructions
201
+ - **Debug Workflow** - Problem-solving methodology
202
+ - **Status**: Planned
187
203
 
188
204
  </td>
189
205
  </tr>
@@ -196,18 +212,18 @@ External function calls and commands
196
212
  - **Database Queries** - Direct database interaction
197
213
  - **API Calls** - External service integration
198
214
  - **File Operations** - Advanced file manipulation
199
- - **Status**: Planned
215
+ - **Status**: Under consideration
200
216
 
201
217
  </td>
202
218
  <td width="50%">
203
219
 
204
- #### ๐Ÿ“‹ Prompts
205
- Reusable instruction sets
206
- - **Code Review Checklist** - Systematic review steps
207
- - **Security Audit Guide** - Vulnerability assessment process
208
- - **Writing Guidelines** - Style and tone instructions
209
- - **Debug Workflow** - Problem-solving methodology
210
- - **Status**: Planned
220
+ #### ๐Ÿ“š Memory Enhancements
221
+ Expanding memory capabilities
222
+ - **PDF Support** - Text extraction from PDF documents
223
+ - **Image Analysis** - Visual content understanding
224
+ - **Audio Transcription** - Voice and sound processing
225
+ - **Video Understanding** - Motion and scene analysis
226
+ - **Status**: Roadmap planned
211
227
 
212
228
  </td>
213
229
  </tr>
@@ -301,7 +317,7 @@ Assistant: "I've saved 'Hard SciFi Writer' to your portfolio. You can activate i
301
317
  - **Save your favorites**: `"Save this configuration as my default setup"`
302
318
  - **Share with others**: `"Submit my custom persona to the community collection"`
303
319
 
304
- ## ๐Ÿš€ Quick Start
320
+ ## ๐Ÿ“ฆ Installation
305
321
 
306
322
  ### Choose Your Installation Method
307
323
 
@@ -467,7 +483,7 @@ After configuring and restarting Claude Desktop, test with:
467
483
  list_elements type="personas"
468
484
  ```
469
485
 
470
- You should see your available personas. If not, check the [Troubleshooting](#troubleshooting) section.
486
+ You should see your available personas. If not, check the [Troubleshooting](#-troubleshooting) section.
471
487
 
472
488
  ---
473
489
 
@@ -479,7 +495,7 @@ By default, your elements are stored in:
479
495
 
480
496
  Use the `DOLLHOUSE_PORTFOLIO_DIR` environment variable to customize this location.
481
497
 
482
- ## ๐ŸŽฏ Getting Started
498
+ ## ๐Ÿš€ Quick Start
483
499
 
484
500
  Once installed, try these commands in Claude:
485
501
 
@@ -525,14 +541,28 @@ Your portfolio is organized by element type:
525
541
 
526
542
  ```
527
543
  ~/.dollhouse/portfolio/
528
- โ”œโ”€โ”€ personas/ # Behavioral profiles
529
- โ”œโ”€โ”€ skills/ # Discrete capabilities
530
- โ”œโ”€โ”€ templates/ # Reusable content structures
531
- โ”œโ”€โ”€ agents/ # Goal-oriented actors
532
- โ”œโ”€โ”€ memories/ # Persistent context
533
- โ””โ”€โ”€ ensembles/ # Element combinations
544
+ โ”œโ”€โ”€ personas/ # Behavioral profiles (Markdown files)
545
+ โ”œโ”€โ”€ skills/ # Discrete capabilities (Markdown files)
546
+ โ”œโ”€โ”€ templates/ # Reusable content structures (Markdown files)
547
+ โ”œโ”€โ”€ agents/ # Goal-oriented actors (Markdown files)
548
+ โ”œโ”€โ”€ memories/ # Persistent context (YAML files with date folders)
549
+ โ”‚ โ”œโ”€โ”€ 2025-09-18/
550
+ โ”‚ โ”‚ โ””โ”€โ”€ project-context.yaml
551
+ โ”‚ โ””โ”€โ”€ 2025-09-19/
552
+ โ”‚ โ”œโ”€โ”€ meeting-notes.yaml
553
+ โ”‚ โ””โ”€โ”€ code-review.yaml
554
+ โ””โ”€โ”€ ensembles/ # Element combinations (Markdown files)
534
555
  ```
535
556
 
557
+ **Note on File Types:**
558
+ - **Markdown (.md)**: Used for personas, skills, templates, agents, and ensembles - human-readable with YAML frontmatter
559
+ - **YAML (.yaml)**: Used exclusively for memories - structured data optimized for context storage
560
+
561
+ **Memory Organization:**
562
+ - Memories use automatic **YYYY-MM-DD** folder structure to prevent flat directory performance issues
563
+ - Each memory file can grow up to ~100KB before creating a new file
564
+ - Folder structure enables unlimited memory collections without degradation
565
+
536
566
  ### Key Features
537
567
 
538
568
  - **Local-First Architecture**: All elements stored locally with optional cloud sync
@@ -842,6 +872,39 @@ For detailed guidelines, see [CONTRIBUTING.md](CONTRIBUTING.md).
842
872
 
843
873
  ## ๐Ÿท๏ธ Version History
844
874
 
875
+ ### v1.9.0 - September 19, 2025
876
+
877
+ **๐ŸŽ‰ Memory Element Release**: Persistent context storage with enterprise-grade features
878
+
879
+ #### โœจ New Features
880
+ - **Memory Element**: Complete implementation of persistent context storage (PR #1000 - The Milestone PR!)
881
+ - **Date-based Organization**: Automatic folder structure (YYYY-MM-DD) prevents flat directory issues
882
+ - **Content Deduplication**: SHA-256 hashing prevents duplicate storage (Issue #994)
883
+ - **Search Indexing**: Fast queries across thousands of entries with O(log n) performance (Issue #984)
884
+ - **Privacy Levels**: Three-tier access control (public, private, sensitive)
885
+ - **Retention Policies**: Automatic cleanup based on age and capacity
886
+
887
+ #### ๐Ÿ”ง Improvements
888
+ - **Performance Optimizations**: 60-second cache for date folder operations
889
+ - **Collision Handling**: Automatic version suffixes for same-named files
890
+ - **Atomic Operations**: FileLockManager prevents corruption and race conditions
891
+ - **Sanitization Caching**: SHA-256 checksums reduce CPU usage by ~40% during deserialization
892
+ - **Retry Logic**: Search index building with exponential backoff
893
+
894
+ #### ๐Ÿ›ก๏ธ Security
895
+ - **Comprehensive Input Validation**: All memory content sanitized with DOMPurify
896
+ - **Path Traversal Protection**: Robust validation in MemoryManager
897
+ - **Size Limits**: DoS protection with 1MB memory and 100KB entry limits
898
+ - **Audit Logging**: Complete security event tracking
899
+
900
+ #### ๐Ÿงช Testing
901
+ - **89 Memory Tests**: Comprehensive coverage across 4 test suites
902
+ - **Concurrent Access Tests**: Thread safety verification
903
+ - **Security Coverage**: XSS, Unicode attacks, path traversal
904
+ - **CI Improvements**: Fixed GitHub integration test conflicts (PR #1001)
905
+
906
+ ---
907
+
845
908
  ### v1.8.1 - September 15, 2025
846
909
 
847
910
  **CI Reliability Improvements**: Fixed persistent test failures across platforms
package/README.md CHANGED
@@ -12,7 +12,7 @@ A comprehensive Model Context Protocol (MCP) server that enables dynamic AI pers
12
12
  **๐Ÿ“ฆ NPM Package**: https://www.npmjs.com/package/@dollhousemcp/mcp-server
13
13
  **๐ŸŒ Website**: https://dollhousemcp.com
14
14
 
15
- ## ๐Ÿš€ Quick Start
15
+ ## ๐Ÿ“ฆ Installation
16
16
 
17
17
  ### Choose Your Installation Method
18
18
 
@@ -178,7 +178,7 @@ After configuring and restarting Claude Desktop, test with:
178
178
  list_elements type="personas"
179
179
  ```
180
180
 
181
- You should see your available personas. If not, check the [Troubleshooting](#troubleshooting) section.
181
+ You should see your available personas. If not, check the [Troubleshooting](#-troubleshooting) section.
182
182
 
183
183
  ---
184
184
 
@@ -190,7 +190,7 @@ By default, your elements are stored in:
190
190
 
191
191
  Use the `DOLLHOUSE_PORTFOLIO_DIR` environment variable to customize this location.
192
192
 
193
- ## ๐ŸŽฏ Getting Started
193
+ ## ๐Ÿš€ Quick Start
194
194
 
195
195
  Once installed, try these commands in Claude:
196
196
 
package/README.md.backup CHANGED
@@ -49,7 +49,7 @@
49
49
 
50
50
  ## Elements That Customize Your AI's Capabilities and Actions
51
51
 
52
- **DollhouseMCP** is open source, community-powered AI customization. Create your own customization elementsโ€”personas that shape behavior, skills that add capabilities, templates for consistent outputs, and agents for automationโ€”or use and modify an ever-growing number of customization elements from the community. Every element you create can be saved to your portfolio and used again or shared back to the DollhouseMCP Collection to help others.
52
+ **DollhouseMCP** is open source, community-powered AI customization. Create your own customization elementsโ€”personas that shape behavior, skills that add capabilities, templates for consistent outputs, agents for automation, and memories for persistent contextโ€”or use and modify an ever-growing number of customization elements from the community. Every element you create can be saved to your portfolio and used again or shared back to the DollhouseMCP Collection to help others.
53
53
 
54
54
  ### What Are Customization Elements?
55
55
 
@@ -57,11 +57,12 @@
57
57
  - **Skills** โ€“ Add specialized capabilities your AI can use
58
58
  - **Templates** โ€“ Ensure consistent, high-quality outputs
59
59
  - **Agents** โ€“ Enable autonomous task completion with smart decision-making
60
+ - **Memory** โ€“ Persistent context storage across sessions
60
61
 
61
62
  ### Core Capabilities
62
63
 
63
- - **๐ŸŒ Community Element Library** โ€“ A growing number of tested personas, skills, templates, and agents
64
- - **โœจ Create Custom Elements** โ€“ Create personas, skills, templates, and agents from scratch using natural language
64
+ - **๐ŸŒ Community Element Library** โ€“ A growing number of tested personas, skills, templates, agents, and memories
65
+ - **โœจ Create Custom Elements** โ€“ Create personas, skills, templates, agents, and memories from scratch using natural language
65
66
  - **๐Ÿค Open Source** โ€“ AGPL-3.0 licensed, ensuring community contributions stay free
66
67
  - **๐Ÿ“š The DollhouseMCP Collection** โ€“ Install any community element with one command
67
68
  - **๐Ÿ› ๏ธ 41 Professional Tools** โ€“ Complete toolkit for element creation and management
@@ -97,11 +98,11 @@
97
98
  ```bash
98
99
  npm install @dollhousemcp/mcp-server
99
100
  ```
100
- See [Quick Start](#quick-start) for complete setup instructions.
101
+ See [Quick Start](#-quick-start) for complete setup instructions.
101
102
 
102
103
  ---
103
104
 
104
- ## ๐ŸŽฏ Element Types: Available Now & Coming Soon
105
+ ## ๐ŸŽฏ Element Types
105
106
 
106
107
  ### โœ… Available Now
107
108
 
@@ -121,7 +122,7 @@ Shape how your AI behaves and responds
121
122
  </td>
122
123
  <td width="50%">
123
124
 
124
- #### ๐Ÿ’ก Skills
125
+ #### ๐Ÿ’ก Skills
125
126
  Add specialized capabilities your AI can use
126
127
  - **Code Review** - Analyze code quality and suggest improvements
127
128
  - **Data Analysis** - Statistical analysis and visualization
@@ -156,34 +157,50 @@ Enable autonomous task completion
156
157
  - **Security Fix Specialist** - Vulnerability remediation
157
158
  - **Use**: `"Run the code reviewer agent"`
158
159
 
160
+ </td>
161
+ </tr>
162
+ <tr>
163
+ <td colspan="2">
164
+
165
+ #### ๐Ÿง  Memory <span style="background-color: #4CAF50; color: white; padding: 2px 6px; border-radius: 3px; font-size: 0.8em;">NEW in v1.9.0</span>
166
+ Persistent context across sessions with intelligent organization
167
+ - **Text-based storage** - Currently supports text content (PDFs, images, and other media types coming soon)
168
+ - **Date-based folders** - Automatic YYYY-MM-DD organization prevents flat directory issues
169
+ - **YAML format** - Human-readable structured data (vs Markdown for other elements)
170
+ - **Smart deduplication** - SHA-256 hashing prevents duplicate storage
171
+ - **Search indexing** - Fast queries across thousands of entries
172
+ - **Use**: `"Create a memory for this project"` or `"Remember this conversation"`
173
+
174
+ **Typical file sizes**: Single memories up to ~100KB, folder structure enables unlimited collections
175
+
159
176
  </td>
160
177
  </tr>
161
178
  </table>
162
179
 
163
- ### ๐Ÿ”„ Coming Soon
180
+ ### ๐Ÿš€ Coming Soon
164
181
 
165
182
  <table>
166
183
  <tr>
167
184
  <td width="50%">
168
185
 
169
- #### ๐Ÿง  Memory
170
- Persistent context across sessions
171
- - **Project Context** - Remember project details and decisions
172
- - **Learning Progress** - Track skill development over time
173
- - **Personal Preferences** - Store user-specific settings
174
- - **Conversation History** - Maintain dialogue continuity
175
- - **Status**: Coming Soon
176
-
177
- </td>
178
- <td width="50%">
179
-
180
186
  #### ๐ŸŽฏ Ensembles
181
187
  Combine multiple elements as one unified entity
182
188
  - **Full-Stack Developer** - Frontend + Backend + DevOps skills
183
189
  - **Writing Suite** - Creative + Technical + Editorial capabilities
184
190
  - **Security Team** - Analyst + Auditor + Remediation skills
185
191
  - **Data Science Platform** - Analysis + Visualization + ML skills
186
- - **Status**: Coming Soon
192
+ - **Status**: In development
193
+
194
+ </td>
195
+ <td width="50%">
196
+
197
+ #### ๐Ÿ“‹ Prompts
198
+ Reusable instruction sets
199
+ - **Code Review Checklist** - Systematic review steps
200
+ - **Security Audit Guide** - Vulnerability assessment process
201
+ - **Writing Guidelines** - Style and tone instructions
202
+ - **Debug Workflow** - Problem-solving methodology
203
+ - **Status**: Planned
187
204
 
188
205
  </td>
189
206
  </tr>
@@ -196,18 +213,18 @@ External function calls and commands
196
213
  - **Database Queries** - Direct database interaction
197
214
  - **API Calls** - External service integration
198
215
  - **File Operations** - Advanced file manipulation
199
- - **Status**: Planned
216
+ - **Status**: Under consideration
200
217
 
201
218
  </td>
202
219
  <td width="50%">
203
220
 
204
- #### ๐Ÿ“‹ Prompts
205
- Reusable instruction sets
206
- - **Code Review Checklist** - Systematic review steps
207
- - **Security Audit Guide** - Vulnerability assessment process
208
- - **Writing Guidelines** - Style and tone instructions
209
- - **Debug Workflow** - Problem-solving methodology
210
- - **Status**: Planned
221
+ #### ๐Ÿ“š Memory Enhancements
222
+ Expanding memory capabilities
223
+ - **PDF Support** - Text extraction from PDF documents
224
+ - **Image Analysis** - Visual content understanding
225
+ - **Audio Transcription** - Voice and sound processing
226
+ - **Video Understanding** - Motion and scene analysis
227
+ - **Status**: Roadmap planned
211
228
 
212
229
  </td>
213
230
  </tr>
@@ -301,7 +318,7 @@ Assistant: "I've saved 'Hard SciFi Writer' to your portfolio. You can activate i
301
318
  - **Save your favorites**: `"Save this configuration as my default setup"`
302
319
  - **Share with others**: `"Submit my custom persona to the community collection"`
303
320
 
304
- ## ๐Ÿš€ Quick Start
321
+ ## ๐Ÿ“ฆ Installation
305
322
 
306
323
  ### Choose Your Installation Method
307
324
 
@@ -467,7 +484,7 @@ After configuring and restarting Claude Desktop, test with:
467
484
  list_elements type="personas"
468
485
  ```
469
486
 
470
- You should see your available personas. If not, check the [Troubleshooting](#troubleshooting) section.
487
+ You should see your available personas. If not, check the [Troubleshooting](#-troubleshooting) section.
471
488
 
472
489
  ---
473
490
 
@@ -479,7 +496,7 @@ By default, your elements are stored in:
479
496
 
480
497
  Use the `DOLLHOUSE_PORTFOLIO_DIR` environment variable to customize this location.
481
498
 
482
- ## ๐ŸŽฏ Getting Started
499
+ ## ๐Ÿš€ Quick Start
483
500
 
484
501
  Once installed, try these commands in Claude:
485
502
 
@@ -525,14 +542,28 @@ Your portfolio is organized by element type:
525
542
 
526
543
  ```
527
544
  ~/.dollhouse/portfolio/
528
- โ”œโ”€โ”€ personas/ # Behavioral profiles
529
- โ”œโ”€โ”€ skills/ # Discrete capabilities
530
- โ”œโ”€โ”€ templates/ # Reusable content structures
531
- โ”œโ”€โ”€ agents/ # Goal-oriented actors
532
- โ”œโ”€โ”€ memories/ # Persistent context
533
- โ””โ”€โ”€ ensembles/ # Element combinations
545
+ โ”œโ”€โ”€ personas/ # Behavioral profiles (Markdown files)
546
+ โ”œโ”€โ”€ skills/ # Discrete capabilities (Markdown files)
547
+ โ”œโ”€โ”€ templates/ # Reusable content structures (Markdown files)
548
+ โ”œโ”€โ”€ agents/ # Goal-oriented actors (Markdown files)
549
+ โ”œโ”€โ”€ memories/ # Persistent context (YAML files with date folders)
550
+ โ”‚ โ”œโ”€โ”€ 2025-09-18/
551
+ โ”‚ โ”‚ โ””โ”€โ”€ project-context.yaml
552
+ โ”‚ โ””โ”€โ”€ 2025-09-19/
553
+ โ”‚ โ”œโ”€โ”€ meeting-notes.yaml
554
+ โ”‚ โ””โ”€โ”€ code-review.yaml
555
+ โ””โ”€โ”€ ensembles/ # Element combinations (Markdown files)
534
556
  ```
535
557
 
558
+ **Note on File Types:**
559
+ - **Markdown (.md)**: Used for personas, skills, templates, agents, and ensembles - human-readable with YAML frontmatter
560
+ - **YAML (.yaml)**: Used exclusively for memories - structured data optimized for context storage
561
+
562
+ **Memory Organization:**
563
+ - Memories use automatic **YYYY-MM-DD** folder structure to prevent flat directory performance issues
564
+ - Each memory file can grow up to ~100KB before creating a new file
565
+ - Folder structure enables unlimited memory collections without degradation
566
+
536
567
  ### Key Features
537
568
 
538
569
  - **Local-First Architecture**: All elements stored locally with optional cloud sync
@@ -842,6 +873,39 @@ For detailed guidelines, see [CONTRIBUTING.md](CONTRIBUTING.md).
842
873
 
843
874
  ## ๐Ÿท๏ธ Version History
844
875
 
876
+ ### v1.9.0 - September 19, 2025
877
+
878
+ **๐ŸŽ‰ Memory Element Release**: Persistent context storage with enterprise-grade features
879
+
880
+ #### โœจ New Features
881
+ - **Memory Element**: Complete implementation of persistent context storage (PR #1000 - The Milestone PR!)
882
+ - **Date-based Organization**: Automatic folder structure (YYYY-MM-DD) prevents flat directory issues
883
+ - **Content Deduplication**: SHA-256 hashing prevents duplicate storage (Issue #994)
884
+ - **Search Indexing**: Fast queries across thousands of entries with O(log n) performance (Issue #984)
885
+ - **Privacy Levels**: Three-tier access control (public, private, sensitive)
886
+ - **Retention Policies**: Automatic cleanup based on age and capacity
887
+
888
+ #### ๐Ÿ”ง Improvements
889
+ - **Performance Optimizations**: 60-second cache for date folder operations
890
+ - **Collision Handling**: Automatic version suffixes for same-named files
891
+ - **Atomic Operations**: FileLockManager prevents corruption and race conditions
892
+ - **Sanitization Caching**: SHA-256 checksums reduce CPU usage by ~40% during deserialization
893
+ - **Retry Logic**: Search index building with exponential backoff
894
+
895
+ #### ๐Ÿ›ก๏ธ Security
896
+ - **Comprehensive Input Validation**: All memory content sanitized with DOMPurify
897
+ - **Path Traversal Protection**: Robust validation in MemoryManager
898
+ - **Size Limits**: DoS protection with 1MB memory and 100KB entry limits
899
+ - **Audit Logging**: Complete security event tracking
900
+
901
+ #### ๐Ÿงช Testing
902
+ - **89 Memory Tests**: Comprehensive coverage across 4 test suites
903
+ - **Concurrent Access Tests**: Thread safety verification
904
+ - **Security Coverage**: XSS, Unicode attacks, path traversal
905
+ - **CI Improvements**: Fixed GitHub integration test conflicts (PR #1001)
906
+
907
+ ---
908
+
845
909
  ### v1.8.1 - September 15, 2025
846
910
 
847
911
  **CI Reliability Improvements**: Fixed persistent test failures across platforms
package/README.npm.md CHANGED
@@ -12,7 +12,7 @@ A comprehensive Model Context Protocol (MCP) server that enables dynamic AI pers
12
12
  **๐Ÿ“ฆ NPM Package**: https://www.npmjs.com/package/@dollhousemcp/mcp-server
13
13
  **๐ŸŒ Website**: https://dollhousemcp.com
14
14
 
15
- ## ๐Ÿš€ Quick Start
15
+ ## ๐Ÿ“ฆ Installation
16
16
 
17
17
  ### Choose Your Installation Method
18
18
 
@@ -178,7 +178,7 @@ After configuring and restarting Claude Desktop, test with:
178
178
  list_elements type="personas"
179
179
  ```
180
180
 
181
- You should see your available personas. If not, check the [Troubleshooting](#troubleshooting) section.
181
+ You should see your available personas. If not, check the [Troubleshooting](#-troubleshooting) section.
182
182
 
183
183
  ---
184
184
 
@@ -190,7 +190,7 @@ By default, your elements are stored in:
190
190
 
191
191
  Use the `DOLLHOUSE_PORTFOLIO_DIR` environment variable to customize this location.
192
192
 
193
- ## ๐ŸŽฏ Getting Started
193
+ ## ๐Ÿš€ Quick Start
194
194
 
195
195
  Once installed, try these commands in Claude:
196
196
 
@@ -1 +1 @@
1
- {"version":3,"file":"CollectionBrowser.d.ts","sourceRoot":"","sources":["../../src/collection/CollectionBrowser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAkB,MAAM,6BAA6B,CAAC;AAE9E,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AA+BrE,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,YAAY,CAAyB;IAC7C,OAAO,CAAC,OAAO,CAAmE;gBAEtE,YAAY,EAAE,YAAY,EAAE,eAAe,CAAC,EAAE,eAAe,EAAE,YAAY,CAAC,EAAE,sBAAsB;IAMhH;;;;;;OAMG;IACG,gBAAgB,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,GAAG,EAAE,CAAC;QAAC,UAAU,EAAE,GAAG,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAA;KAAE,CAAC;IA+DvH;;;OAGG;YACW,eAAe;IAiC7B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAiBhC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAiBzB;;OAEG;IACH,OAAO,CAAC,+BAA+B;IAWvC;;OAEG;YACW,eAAe;IAwC7B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAmB1B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAqBhC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAgB5B;;OAEG;IACH,OAAO,CAAC,+BAA+B;IAWvC;;OAEG;IACH,mBAAmB,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,gBAAgB,GAAE,MAAW,GAAG,MAAM;CAgF7H"}
1
+ {"version":3,"file":"CollectionBrowser.d.ts","sourceRoot":"","sources":["../../src/collection/CollectionBrowser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAkB,MAAM,6BAA6B,CAAC;AAE9E,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAgCrE,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,YAAY,CAAyB;IAC7C,OAAO,CAAC,OAAO,CAAmE;gBAEtE,YAAY,EAAE,YAAY,EAAE,eAAe,CAAC,EAAE,eAAe,EAAE,YAAY,CAAC,EAAE,sBAAsB;IAMhH;;;;;;OAMG;IACG,gBAAgB,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,GAAG,EAAE,CAAC;QAAC,UAAU,EAAE,GAAG,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAA;KAAE,CAAC;IA+DvH;;;OAGG;YACW,eAAe;IAiC7B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAiBhC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAiBzB;;OAEG;IACH,OAAO,CAAC,+BAA+B;IAWvC;;OAEG;YACW,eAAe;IAwC7B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAmB1B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAqBhC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAgB5B;;OAEG;IACH,OAAO,CAAC,+BAA+B;IAWvC;;OAEG;IACH,mBAAmB,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,gBAAgB,GAAE,MAAW,GAAG,MAAM;CAgF7H"}