Skip to main content
Glama

DollhouseMCP

by DollhouseMCP
QUICK_START_PORTFOLIO_NEXT_SESSION.md3.33 kB
# Quick Start - Portfolio Implementation Next Session ## 🚀 Immediate Start Commands ```bash # 1. Check if PR #493 is merged gh pr view 493 # 2. If merged, sync and start Phase 2 git checkout develop git pull origin develop git checkout -b feature/portfolio-repo-manager # 3. If not merged, continue from feature branch git checkout feature/oauth-client-setup ``` ## ✅ What's Already Done - **OAuth App**: Registered with CLIENT_ID `Ov23liOrPRXkNN7PMCBt` - **Code**: CLIENT_ID hardcoded and working - **Tests**: Fixed and passing (GitHubAuthManager tests excluded) - **PR #493**: Ready to merge to develop ## 📋 Phase 2 Task List (Portfolio Manager) ### Task 1: Write Failing Tests (30 min) ```bash # Create test file mkdir -p test/__tests__/unit/portfolio touch test/__tests__/unit/portfolio/PortfolioRepoManager.test.ts # Write these RED tests: # 1. should check if portfolio exists # 2. should create portfolio only with user consent # 3. should generate correct portfolio structure # 4. should save element to correct location # 5. should handle API failures gracefully ``` ### Task 2: Implement PortfolioRepoManager (45 min) ```bash # Create implementation touch src/portfolio/PortfolioRepoManager.ts # Key methods to implement: # - checkPortfolioExists(username: string): Promise<boolean> # - createPortfolio(username: string, consent: boolean): Promise<string> # - saveElement(element: Element, consent: boolean): Promise<string> ``` ### Task 3: Make Tests Pass (30 min) - Run tests: `npm test -- test/__tests__/unit/portfolio/` - Fix until all GREEN ## 🔑 Critical Requirements ### MUST HAVE Consent Checks ```typescript // ❌ WRONG - No consent async createPortfolio(username: string) { // Creates without asking } // ✅ RIGHT - Explicit consent required async createPortfolio(username: string, consent: boolean) { if (!consent) { throw new Error('User declined portfolio creation'); } // Only create with consent } ``` ### User Control Flow 1. **ASK** before creating portfolio 2. **EXPLAIN** what will happen 3. **ALLOW** opt-out 4. **ONLY** upload what user selects 5. **KEEP** everything else local ## 🎯 Success Criteria for Phase 2 - [ ] All tests written first (RED) - [ ] PortfolioRepoManager implemented - [ ] All tests passing (GREEN) - [ ] Consent required for ALL operations - [ ] PR created to develop branch ## 📝 Commit Message Template ```bash git commit -m "test: Add failing tests for PortfolioRepoManager Following TDD approach - RED phase complete. Tests verify: - Portfolio existence checking - Consent-based portfolio creation - Element saving with permission - API error handling Next: Implement PortfolioRepoManager to make tests pass. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>" ``` ## 🔗 References - **Detailed Plan**: `SESSION_NOTES_2025_08_07_OAUTH_PORTFOLIO_TDD.md` - **OAuth Implementation**: PR #493 - **Portfolio Plan**: `GITHUB_AUTH_PORTFOLIO_PLAN.md` ## 💡 Remember - **TDD**: Write tests FIRST, then code - **Consent**: EVERYTHING requires explicit permission - **GitFlow**: Branch from develop, PR back to develop - **Atomic**: Small, verifiable tasks - **Verify**: Each step must be testable --- Ready to continue with Phase 2: Portfolio Repository Manager! 🚀

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/DollhouseMCP/DollhouseMCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server