EuConquisto Composer MCP

--- document: Root Directory Cleanup - Execution Task for Claude Code version: 1.1.0 status: completed priority: HIGH author: Claude Desktop created: 2025-06-30 last_updated: 2025-06-30 completed_by: Claude Code completion_date: 2025-06-30 --- # Task: Execute Root Directory Cleanup **Priority**: HIGH - Blocking clean development workflow **Created**: 2025-06-30 **Assigned to**: Claude Code ## Objective Execute systematic file organization to clean up 138 files currently cluttering the project root directory, following the detailed plan in `/docs/analysis/root-directory-cleanup-plan-v1.0.0.md`. ## Current Situation **Root directory status**: 138 files need organization **Impact**: Blocking clean development workflow **Plan available**: Complete categorization and directory structure designed ## Requirements ### 1. Pre-Move Analysis - Cross-Reference Mapping **CRITICAL**: Analyze file dependencies BEFORE moving files to prevent broken references. ```bash # Search for file references in the codebase grep -r "\./" src/ --include="*.ts" --include="*.js" | grep -v node_modules grep -r "\.\./.*\.js" . --include="*.ts" --include="*.js" --include="*.json" | grep -v node_modules grep -r "require.*\.js" . --include="*.ts" --include="*.js" | grep -v node_modules grep -r "import.*\.js" . --include="*.ts" --include="*.js" | grep -v node_modules # Check package.json scripts for file references cat package.json | grep -E "(scripts|main|bin)" # Check for hardcoded paths in config files grep -r "/Users/ricardokawasaki/Desktop/euconquisto-composer-mcp-poc" . --include="*.json" --include="*.md" --include="*.js" --include="*.ts" ``` ### 2. Create Required Directory Structure ```bash mkdir -p archive/{authentication,config,deprecated-docs,diagnostics,logs} mkdir -p tools/{analysis,authentication,automation,browser,debugging,demos,injection,scripts,servers} mkdir -p tests/{api,analysis,authentication,basic,browser,composer,composition,content,integration,manual,mcp,navigation,spa,storage} mkdir -p logs/{processes,screenshots/{access,analysis,browser,composer,debug,errors,final,interface,jwt,loading,manual,navigation,stealth}} ``` ### 3. Move Files According to Categorization **⚠️ CRITICAL**: Before moving each file, check for references and update them. **Reference plan**: `/docs/analysis/root-directory-cleanup-plan-v1.0.0.md` #### KEEP IN ROOT (19 core files) ✅ No action needed for: - .env, .env.example, .gitignore - package.json, package-lock.json - tsconfig.json, tsconfig-minimal.json - project.json, mcp-interface-structure.ts - 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 (7 files) **⚠️ Check references before moving each file** ```bash # For each file, search for references first: grep -r "authenticated-diagnostic-report.json" . --exclude-dir=node_modules mv authenticated-diagnostic-report.json archive/diagnostics/ grep -r "authenticated-diagnostic-summary.md" . --exclude-dir=node_modules mv authenticated-diagnostic-summary.md archive/diagnostics/ grep -r "composer-storage-log.txt" . --exclude-dir=node_modules mv composer-storage-log.txt archive/logs/ grep -r "correct-jwt-new.txt" . --exclude-dir=node_modules # UPDATE REFERENCES: src/intelligent-composer-mcp-server.ts line ~65 sed -i.bak "s|resolve(currentDir, '..', 'correct-jwt-new.txt')|resolve(currentDir, '..', 'archive/authentication/correct-jwt-new.txt')|g" src/intelligent-composer-mcp-server.ts mv correct-jwt-new.txt archive/authentication/ grep -r "correct-jwt.txt" . --exclude-dir=node_modules mv correct-jwt.txt archive/authentication/ grep -r "claude-desktop-config.json" . --exclude-dir=node_modules mv claude-desktop-config.json archive/config/ grep -r "CLAUDE.md" . --exclude-dir=node_modules mv CLAUDE.md archive/deprecated-docs/ ``` #### MOVE TO TOOLS (~25 files) **⚠️ Check and update package.json scripts that reference these files** ```bash # Check package.json for script references before moving grep -n "run-browser-mcp.sh\|jwt-redirect-server" package.json # Analysis tools grep -r "analyze-composition-url.js" . --exclude-dir=node_modules mv analyze-composition-url.js tools/analysis/ grep -r "compare-urls.js" . --exclude-dir=node_modules mv compare-urls.js tools/analysis/ grep -r "detailed-url-compare.js" . --exclude-dir=node_modules mv detailed-url-compare.js tools/analysis/ grep -r "investigate-url-difference.js" . --exclude-dir=node_modules mv investigate-url-difference.js tools/analysis/ # Authentication tools - UPDATE REFERENCES grep -r "analyze-mcp-jwt.cjs" . --exclude-dir=node_modules mv analyze-mcp-jwt.cjs tools/authentication/ # Server files - CHECK PACKAGE.JSON SCRIPTS grep -r "jwt-redirect-server" . --exclude-dir=node_modules mv jwt-redirect-server-v1.0.0.cjs tools/servers/ mv jwt-redirect-server-v1.0.0.js tools/servers/ mv jwt-redirect-server-v1.0.1.js tools/servers/ mv jwt-redirect-server-v1.0.2.js tools/servers/ # Script files - UPDATE PACKAGE.JSON IF REFERENCED grep -r "run-browser-mcp.sh" . --exclude-dir=node_modules mv run-browser-mcp.sh tools/scripts/ # Continue with other tools... mv corruption-proof-jwt-v1.0.0.js tools/authentication/ mv execute-jwt-trace.cjs tools/authentication/ mv jwt-corruption-tracer-v1.0.0.js tools/authentication/ mv jwt-solution-v1.0.0.js tools/authentication/ mv verify-jwt-fix.js tools/authentication/ mv connect-to-browser.js tools/browser/ mv connect-via-cdp.js tools/browser/ mv start-persistent-browser.js tools/browser/ mv debug-dom-selectors.js tools/debugging/ mv debug-dynamic-loading.js tools/debugging/ mv debug-simple.js tools/debugging/ mv debug-url-comparison.js tools/debugging/ mv debug-url-construction.js tools/debugging/ mv debug-working-interface.js tools/debugging/ mv corruption-proof-automation-v1.0.0.js tools/automation/ mv demo-brazilian-working.js tools/demos/ mv inject-fotossintese-v1.1.0.js tools/injection/ ``` #### MOVE TO TESTS (~35 files) ```bash # API tests mv test-api-debug.js tests/api/ mv test-api-detailed.js tests/api/ mv test-api-enhanced.js tests/api/ mv test-api-put.js tests/api/ mv test-http-api.js tests/api/ # Authentication tests mv test-complete-jwt.js tests/authentication/ mv test-corrected-jwt-final.js tests/authentication/ mv test-corrected-jwt.js tests/authentication/ mv test-fixed-jwt.js tests/authentication/ # Browser tests mv test-brave-like.js tests/browser/ mv test-existing-tab.js tests/browser/ mv test-stealth-browser.js tests/browser/ mv test-with-firefox.js tests/browser/ mv test-working-tab-final.js tests/browser/ # Composer tests mv test-composer-access.js tests/composer/ mv test-composer-interactive.js tests/composer/ mv test-composer-simple.js tests/composer/ mv test-fresh-composer.js tests/composer/ # Composition tests mv test-composition-creation.js tests/composition/ mv test-live-composition.mjs tests/composition/ mv test-simple-creation.js tests/composition/ # Content tests mv test-brazilian-prompt.js tests/content/ mv test-brazilian-quick.js tests/content/ mv test-brazilian-simple.js tests/content/ # MCP tests mv test-enhanced-mcp.js tests/mcp/ mv test-intelligent-mcp.js tests/mcp/ mv test-mcp-server.js tests/mcp/ mv test-working-mcp.js tests/mcp/ # Navigation tests mv test-corrected-navigation.js tests/navigation/ mv test-exact-url.js tests/navigation/ mv test-navigation-strategies.js tests/navigation/ # Storage tests mv test-composer-storage-file-logger.js tests/storage/ mv test-composer-storage-tracker.js tests/storage/ mv test-localstorage.js tests/storage/ # Integration tests mv test-final-corrected.js tests/integration/ mv test-final-solution.js tests/integration/ # Manual tests mv test-exact-manual.js tests/manual/ mv test-manual-browser.js tests/manual/ # Other tests mv test-enhanced-spa.js tests/spa/ mv test-simple.mjs tests/basic/ mv test-working-analysis.js tests/analysis/ ``` #### MOVE TO LOGS (~40+ screenshots) ```bash # JWT screenshots mv complete-jwt-test-1751059290097.png logs/screenshots/jwt/ mv corrected-jwt-test-1751057041639.png logs/screenshots/jwt/ mv corrected-jwt-test-1751057931742.png logs/screenshots/jwt/ mv corrected-jwt-test-1751058095464.png logs/screenshots/jwt/ # Debug screenshots mv debug-authenticated-1751224915658.png logs/screenshots/debug/ mv debug-authenticated-1751225823878.png logs/screenshots/debug/ mv debug-authenticated-1751226139597.png logs/screenshots/debug/ mv debug-navigation-1751032390709.png logs/screenshots/debug/ mv debug-navigation-1751033359280.png logs/screenshots/debug/ mv debug-navigation-1751034828989.png logs/screenshots/debug/ mv debug-navigation-1751035683583.png logs/screenshots/debug/ mv debug-navigation-1751038016331.png logs/screenshots/debug/ mv debug-navigation-1751040288369.png logs/screenshots/debug/ mv debug-navigation-1751041418843.png logs/screenshots/debug/ mv debug-navigation-1751044217787.png logs/screenshots/debug/ mv debug-navigation-1751045714953.png logs/screenshots/debug/ mv debug-navigation-1751049135451.png logs/screenshots/debug/ mv debug-navigation-1751051889857.png logs/screenshots/debug/ mv debug-navigation-1751233568503.png logs/screenshots/debug/ mv debug-navigation-1751237027008.png logs/screenshots/debug/ mv debug-navigation-1751249622487.png logs/screenshots/debug/ mv debug-navigation-1751253474407.png logs/screenshots/debug/ # Navigation screenshots mv corrected-navigation-1751064311046.png logs/screenshots/navigation/ mv navigation-strategies-1751064062850.png logs/screenshots/navigation/ # Browser screenshots mv brave-like-test-1751037818851.png logs/screenshots/browser/ mv firefox-test-1751037569741.png logs/screenshots/browser/ # Composer screenshots mv composer-access-test.png logs/screenshots/composer/ mv fresh-composer-test-1751036108963.png logs/screenshots/composer/ # Error screenshots mv error-navigation-1751233585426.png logs/screenshots/errors/ mv error-navigation-1751237096811.png logs/screenshots/errors/ mv error-navigation-1751249710501.png logs/screenshots/errors/ # Final screenshots mv final-corrected-test-1751060198861.png logs/screenshots/final/ mv final-corrected-test-1751061927087.png logs/screenshots/final/ mv final-corrected-test-1751062182039.png logs/screenshots/final/ mv final-corrected-test-1751063018923.png logs/screenshots/final/ # Interface screenshots mv working-interface-analyzed.png logs/screenshots/interface/ mv working-interface-initial.png logs/screenshots/interface/ # Loading screenshots mv loading-stage-1-initial-js-load.png logs/screenshots/loading/ mv loading-stage-2-framework-initialization.png logs/screenshots/loading/ mv loading-stage-3-component-mounting.png logs/screenshots/loading/ mv loading-stage-4-data-loading.png logs/screenshots/loading/ mv loading-stage-5-ui-rendering-complete.png logs/screenshots/loading/ # Manual screenshots mv manual-replication-test-1751033451659.png logs/screenshots/manual/ mv manual-replication-test-1751033727173.png logs/screenshots/manual/ # Other screenshots mv direct-access-test-1751052436338.png logs/screenshots/access/ mv final-comprehensive-analysis.png logs/screenshots/analysis/ mv stealth-test-1751063684639.png logs/screenshots/stealth/ # Process files mv mcp_server.pid logs/processes/ ``` #### DELETE (1 file) ```bash rm .DS_Store ``` ### 4. Update Cross-References After Moves **CRITICAL**: Update all discovered references to moved files. ```bash # Update package.json scripts (if any reference moved files) # This will be identified during pre-move analysis # Update any import/require statements in source files # Example updates based on common patterns: # If any src files import from root (update paths): find src/ -name "*.ts" -o -name "*.js" | xargs grep -l "\.\./.*\.js" | while read file; do echo "Checking $file for path updates needed" # Manual review and update required based on what files were moved done # Update documentation references find docs/ -name "*.md" | xargs grep -l "\.\./.*\.js" | while read file; do echo "Checking $file for documentation path updates" done # Update any config file references grep -r "\./[^/]*\.js" . --include="*.json" --include="*.config.*" | grep -v node_modules ``` ### 5. Apply Version Headers Add document versioning headers to moved files that lack them, following `/docs/standards/document-versioning-standard.md`. ### 6. Update .gitignore Add appropriate ignore patterns for new log directories: ``` logs/screenshots/ logs/processes/ archive/logs/ ``` ## Implementation Notes ### CRITICAL SAFETY MEASURES - **Analyze dependencies FIRST** using pre-move analysis commands - **Check each file for references** before moving - **Update package.json scripts** if they reference moved files - **Test functionality after moves** to catch broken references - **Keep backups** of critical config files during the process ### Standard Procedures - **Preserve file permissions** during moves - **Validate moves** by checking file counts in each directory - **Update any path references** in existing scripts - **Document any issues** encountered during moves ## Success Criteria - [ ] **Pre-move analysis completed** - all file references identified - [ ] Root directory contains only 19 core configuration files - [ ] All files organized according to categorization plan - [ ] **All cross-references updated** to point to new file locations - [ ] **Package.json scripts updated** if they referenced moved files - [ ] Version headers applied where missing - [ ] .gitignore updated for new structure - [ ] **No broken file references** - all imports/requires still work - [ ] **Functionality validated** - intelligent systems still operational - [ ] Clean development workflow enabled ## Validation Commands ```bash # Check root directory file count (should be ~19) ls -la /Users/ricardokawasaki/Desktop/euconquisto-composer-mcp-poc/ | grep "^-" | wc -l # Verify directory structure created ls -la archive/ tools/ tests/ logs/ # CRITICAL: Test that moved files don't break functionality npm test # if applicable node -c src/working-intelligent-mcp-server.ts # Syntax check node -c src/intelligent-composer-mcp-server.ts # Syntax check # Verify no broken imports grep -r "Error.*Cannot find module\|Error.*ENOENT" . --exclude-dir=node_modules || echo "No broken imports found" # Test critical intelligent systems still work npm run mcp:working # if this script exists ``` ## Post-Completion Actions 1. **Validate no broken references** by testing intelligent systems 2. **Update coordination files** with any path changes discovered 3. **Test MCP server functionality** to ensure working systems still operational 4. **Commit organized structure** to version control 5. **Document** any reference updates made during cleanup 6. **Verify** that `working-intelligent-mcp-server.ts` still functions properly **⚠️ CRITICAL**: If any functionality breaks, restore files and update references before re-attempting moves. --- **Execute this task to enable clean development workflow and complete the house-keeping directive.**