EuConquisto Composer MCP

--- document: Root Directory Cleanup Plan version: 1.0.0 status: executed author: Claude Desktop created: 2025-06-30 last_updated: 2025-06-30 executed_by: Claude Code execution_date: 2025-06-30 --- # Root Directory Cleanup Plan - EuConquisto Composer MCP ## 🎯 Objective Systematically organize 100+ files currently cluttering the project root directory according to the document versioning standard and logical project structure. ## 📊 Current Analysis **Total files in root**: 135+ files **Total directories in root**: 14 directories **Priority**: HIGH - blocking clean development workflow ## 🗂️ File Categorization Strategy ### ✅ **KEEP IN ROOT** (Core Configuration) ``` ✅ .env ✅ .env.example ✅ .gitignore ✅ package.json ✅ package-lock.json ✅ tsconfig.json ✅ tsconfig-minimal.json ✅ project.json ✅ mcp-interface-structure.ts (main interface definitions) ✅ README.md ✅ CHANGELOG.md ✅ VERSION ✅ CLAUDE_START_HERE.md ✅ CLAUDE_DESKTOP_README.md ✅ CLAUDE_DESKTOP_CONTEXT.md ✅ CURRENT_STATUS.md ✅ WORKING-SYSTEM-SUMMARY.md ✅ VIEWING-COMPOSITIONS.md ``` ### 📦 **MOVE TO /archive** (Deprecated/Historical Files) ``` 📦 authenticated-diagnostic-report.json → /archive/diagnostics/ 📦 authenticated-diagnostic-summary.md → /archive/diagnostics/ 📦 composer-storage-log.txt → /archive/logs/ 📦 correct-jwt-new.txt → /archive/authentication/ 📦 correct-jwt.txt → /archive/authentication/ 📦 claude-desktop-config.json → /archive/config/ 📦 CLAUDE.md → /archive/deprecated-docs/ ``` ### 🔧 **MOVE TO /tools** (Utility Scripts) ``` 🔧 analyze-composition-url.js → /tools/analysis/ 🔧 analyze-mcp-jwt.cjs → /tools/authentication/ 🔧 compare-urls.js → /tools/analysis/ 🔧 connect-to-browser.js → /tools/browser/ 🔧 connect-via-cdp.js → /tools/browser/ 🔧 corruption-proof-automation-v1.0.0.js → /tools/automation/ 🔧 corruption-proof-jwt-v1.0.0.js → /tools/authentication/ 🔧 debug-dom-selectors.js → /tools/debugging/ 🔧 debug-dynamic-loading.js → /tools/debugging/ 🔧 debug-simple.js → /tools/debugging/ 🔧 debug-url-comparison.js → /tools/debugging/ 🔧 debug-url-construction.js → /tools/debugging/ 🔧 debug-working-interface.js → /tools/debugging/ 🔧 demo-brazilian-working.js → /tools/demos/ 🔧 detailed-url-compare.js → /tools/analysis/ 🔧 execute-jwt-trace.cjs → /tools/authentication/ 🔧 inject-fotossintese-v1.1.0.js → /tools/injection/ 🔧 investigate-url-difference.js → /tools/analysis/ 🔧 jwt-corruption-tracer-v1.0.0.js → /tools/authentication/ 🔧 jwt-redirect-server-v1.0.0.cjs → /tools/servers/ 🔧 jwt-redirect-server-v1.0.0.js → /tools/servers/ 🔧 jwt-redirect-server-v1.0.1.js → /tools/servers/ 🔧 jwt-redirect-server-v1.0.2.js → /tools/servers/ 🔧 jwt-solution-v1.0.0.js → /tools/authentication/ 🔧 run-browser-mcp.sh → /tools/scripts/ 🔧 start-persistent-browser.js → /tools/browser/ 🔧 verify-jwt-fix.js → /tools/authentication/ ``` ### 🧪 **MOVE TO /tests** (Test Files) ``` 🧪 test-api-debug.js → /tests/api/ 🧪 test-api-detailed.js → /tests/api/ 🧪 test-api-enhanced.js → /tests/api/ 🧪 test-api-put.js → /tests/api/ 🧪 test-brave-like.js → /tests/browser/ 🧪 test-brazilian-prompt.js → /tests/content/ 🧪 test-brazilian-quick.js → /tests/content/ 🧪 test-brazilian-simple.js → /tests/content/ 🧪 test-complete-jwt.js → /tests/authentication/ 🧪 test-composer-access.js → /tests/composer/ 🧪 test-composer-interactive.js → /tests/composer/ 🧪 test-composer-simple.js → /tests/composer/ 🧪 test-composer-storage-file-logger.js → /tests/storage/ 🧪 test-composer-storage-tracker.js → /tests/storage/ 🧪 test-composition-creation.js → /tests/composition/ 🧪 test-corrected-jwt-final.js → /tests/authentication/ 🧪 test-corrected-jwt.js → /tests/authentication/ 🧪 test-corrected-navigation.js → /tests/navigation/ 🧪 test-enhanced-mcp.js → /tests/mcp/ 🧪 test-enhanced-spa.js → /tests/spa/ 🧪 test-exact-manual.js → /tests/manual/ 🧪 test-exact-url.js → /tests/navigation/ 🧪 test-existing-tab.js → /tests/browser/ 🧪 test-final-corrected.js → /tests/integration/ 🧪 test-final-solution.js → /tests/integration/ 🧪 test-fixed-jwt.js → /tests/authentication/ 🧪 test-fresh-composer.js → /tests/composer/ 🧪 test-http-api.js → /tests/api/ 🧪 test-intelligent-mcp.js → /tests/mcp/ 🧪 test-live-composition.mjs → /tests/composition/ 🧪 test-localstorage.js → /tests/storage/ 🧪 test-manual-browser.js → /tests/manual/ 🧪 test-mcp-server.js → /tests/mcp/ 🧪 test-navigation-strategies.js → /tests/navigation/ 🧪 test-simple-creation.js → /tests/composition/ 🧪 test-simple.mjs → /tests/basic/ 🧪 test-stealth-browser.js → /tests/browser/ 🧪 test-with-firefox.js → /tests/browser/ 🧪 test-working-analysis.js → /tests/analysis/ 🧪 test-working-mcp.js → /tests/mcp/ 🧪 test-working-tab-final.js → /tests/browser/ ``` ### 📸 **MOVE TO /logs** (Screenshots & Debug Outputs) ``` 📸 brave-like-test-1751037818851.png → /logs/screenshots/browser/ 📸 complete-jwt-test-1751059290097.png → /logs/screenshots/jwt/ 📸 composer-access-test.png → /logs/screenshots/composer/ 📸 corrected-jwt-test-1751057041639.png → /logs/screenshots/jwt/ 📸 corrected-jwt-test-1751057931742.png → /logs/screenshots/jwt/ 📸 corrected-jwt-test-1751058095464.png → /logs/screenshots/jwt/ 📸 corrected-navigation-1751064311046.png → /logs/screenshots/navigation/ 📸 debug-authenticated-1751224915658.png → /logs/screenshots/debug/ 📸 debug-authenticated-1751225823878.png → /logs/screenshots/debug/ 📸 debug-authenticated-1751226139597.png → /logs/screenshots/debug/ 📸 debug-navigation-1751032390709.png → /logs/screenshots/debug/ 📸 debug-navigation-1751033359280.png → /logs/screenshots/debug/ 📸 debug-navigation-1751034828989.png → /logs/screenshots/debug/ 📸 debug-navigation-1751035683583.png → /logs/screenshots/debug/ 📸 debug-navigation-1751038016331.png → /logs/screenshots/debug/ 📸 debug-navigation-1751040288369.png → /logs/screenshots/debug/ 📸 debug-navigation-1751041418843.png → /logs/screenshots/debug/ 📸 debug-navigation-1751044217787.png → /logs/screenshots/debug/ 📸 debug-navigation-1751045714953.png → /logs/screenshots/debug/ 📸 debug-navigation-1751049135451.png → /logs/screenshots/debug/ 📸 debug-navigation-1751051889857.png → /logs/screenshots/debug/ 📸 debug-navigation-1751233568503.png → /logs/screenshots/debug/ 📸 debug-navigation-1751237027008.png → /logs/screenshots/debug/ 📸 debug-navigation-1751249622487.png → /logs/screenshots/debug/ 📸 debug-navigation-1751253474407.png → /logs/screenshots/debug/ 📸 direct-access-test-1751052436338.png → /logs/screenshots/access/ 📸 error-navigation-1751233585426.png → /logs/screenshots/errors/ 📸 error-navigation-1751237096811.png → /logs/screenshots/errors/ 📸 error-navigation-1751249710501.png → /logs/screenshots/errors/ 📸 final-comprehensive-analysis.png → /logs/screenshots/analysis/ 📸 final-corrected-test-1751060198861.png → /logs/screenshots/final/ 📸 final-corrected-test-1751061927087.png → /logs/screenshots/final/ 📸 final-corrected-test-1751062182039.png → /logs/screenshots/final/ 📸 final-corrected-test-1751063018923.png → /logs/screenshots/final/ 📸 firefox-test-1751037569741.png → /logs/screenshots/browser/ 📸 fresh-composer-test-1751036108963.png → /logs/screenshots/composer/ 📸 loading-stage-1-initial-js-load.png → /logs/screenshots/loading/ 📸 loading-stage-2-framework-initialization.png → /logs/screenshots/loading/ 📸 loading-stage-3-component-mounting.png → /logs/screenshots/loading/ 📸 loading-stage-4-data-loading.png → /logs/screenshots/loading/ 📸 loading-stage-5-ui-rendering-complete.png → /logs/screenshots/loading/ 📸 manual-replication-test-1751033451659.png → /logs/screenshots/manual/ 📸 manual-replication-test-1751033727173.png → /logs/screenshots/manual/ 📸 navigation-strategies-1751064062850.png → /logs/screenshots/navigation/ 📸 stealth-test-1751063684639.png → /logs/screenshots/stealth/ 📸 working-interface-analyzed.png → /logs/screenshots/interface/ 📸 working-interface-initial.png → /logs/screenshots/interface/ 📸 mcp_server.pid → /logs/processes/ ``` ### 🗑️ **DELETE** (Temporary/System Files) ``` 🗑️ .DS_Store (macOS system file) ``` ## 📁 Directory Structure to Create ``` /archive/ /authentication/ /config/ /deprecated-docs/ /diagnostics/ /logs/ /tools/ /analysis/ /authentication/ /automation/ /browser/ /debugging/ /demos/ /injection/ /scripts/ /servers/ /tests/ /api/ /analysis/ /authentication/ /basic/ /browser/ /composer/ /composition/ /content/ /integration/ /manual/ /mcp/ /navigation/ /spa/ /storage/ /logs/ /processes/ /screenshots/ /access/ /analysis/ /browser/ /composer/ /debug/ /errors/ /final/ /interface/ /jwt/ /loading/ /manual/ /navigation/ /stealth/ ``` ## ✅ Implementation Steps 1. **Create directory structure** with proper permissions 2. **Move files with version headers** following document versioning standard 3. **Update .gitignore** to exclude appropriate logs and temporary files 4. **Update coordination files** with new structure references 5. **Validate all moved files** have proper version headers ## 📋 Post-Cleanup Validation - [ ] All core configuration files remain in root - [ ] All test files organized by category - [ ] All tools organized by function - [ ] All screenshots/logs chronologically organized - [ ] Document versioning headers applied where missing - [ ] .gitignore updated for new structure - [ ] Coordination files reference new paths --- *This cleanup plan ensures organized development workflow while preserving all project assets and maintaining full traceability.*