QUICK_START_EXPORT_IMPORT.mdโข2.54 kB
# Quick Start - Export/Import Feature Completion
## Immediate Actions for Next Session
### 1. Check PR Status
```bash
cd /Users/mick/Developer/MCP-Servers/DollhouseMCP
git checkout feature/export-import-sharing
gh pr view 197 --comments
```
### 2. Read Any New Review Comments
The PR review identified several issues we've already fixed, but check for new feedback.
### 3. Priority Tasks
#### A. Write PersonaSharer Tests (HIGH PRIORITY)
Create `__tests__/unit/PersonaSharer.test.ts`:
- Mock fetch for GitHub API calls
- Test Gist creation flow
- Test URL validation (SSRF prevention)
- Test expiry date logic
- Test fallback to base64 URLs
#### B. Implement Rate Limiting (HIGH PRIORITY)
```typescript
// Consider reusing from UpdateManager
import { RateLimiter } from '../update/RateLimiter.js';
// Or create simple implementation
class GitHubRateLimiter {
private requests: number[] = [];
private limit = 60; // per hour
canMakeRequest(): boolean {
const hourAgo = Date.now() - 3600000;
this.requests = this.requests.filter(t => t > hourAgo);
return this.requests.length < this.limit;
}
}
```
#### C. Final Fixes
- Check if any CI tests are failing
- Address any new review comments
- Test the complete flow manually
### 4. Test the Features
```bash
# Build first
npm run build
# Test export
node -e "
const { DollhouseMCPServer } = require('./dist/index.js');
const server = new DollhouseMCPServer();
// Test export functionality
"
# Or create a test script
npx tsx test-integration.ts
```
### 5. Update Documentation
Add to README.md:
```markdown
## Export/Import/Sharing
### Export a Persona
```bash
export_persona "Creative Writer"
```
### Export All Personas
```bash
export_all_personas
```
### Import from JSON/Base64
```bash
import_persona "<base64-or-json>"
```
### Share a Persona (requires GITHUB_TOKEN)
```bash
share_persona "Creative Writer" 7 # 7 day expiry
```
### Import from URL
```bash
import_from_url "https://gist.github.com/..."
```
```
## Current State Summary
โ
**Completed**:
- Core implementation (3 modules)
- 5 MCP tools integrated
- Fixed critical bugs from review
- 19 unit tests passing
- Security validation working
๐ **Remaining**:
- PersonaSharer tests
- Rate limiting
- Documentation
- Final review fixes
## Estimated Timeline
- 3-4 hours to complete everything
- Ready for deployment after that
## Remember
- Don't merge until Mick approves
- Test with actual Claude Desktop before finalizing
- The feature is "almost through to get deployed" per Mick