Skip to content

Conversation

@bshepp
Copy link
Owner

@bshepp bshepp commented Dec 20, 2025

Note

Remove the entire .archive/ directory and its legacy docs, configs, and tests to clean up the repository.

  • Cleanup:
    • Remove the entire /.archive/ tree, including development artifacts (ECS/Amplify configs, deploy scripts, DNS/SSL records), extensive documentation templates/guides, and cognitive/coordination JSONs.
    • Delete legacy test scripts under /.archive/legacy-tests/ and miscellaneous web reference configs/templates.
    • Effectively prunes historical/non-essential files and infrastructure remnants from the repo.

Written by Cursor Bugbot for commit 2553ed1. This will update automatically on new commits. Configure here.

bshepp and others added 22 commits September 8, 2025 00:25
- Replaced FastAPI REST endpoints with MCP JSON-RPC calls
- Updated all UI panels to use MCP tools (calculate_hypersphere, calculate_hypercube, etc.)
- Added server status checking and connection banner
- Implemented proper error handling for MCP responses
- Added dimension scaling visualization with Plotly
- Maintained all original UI features with MCP backend

This fixes the production deployment issue where the frontend was expecting
FastAPI endpoints but only MCP Lambda was deployed.
- AMPLIFY_DEPLOYMENT_ANALYSIS.md: complete analysis of API mismatch issue
- INFRASTRUCTURE_AUDIT_REPORT.md: comprehensive AWS infrastructure audit
- Documents decision to refocus project as MCP-first architecture
- Preserves analysis of web interface removal rationale

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
BREAKING CHANGE: Complete removal of web interface components

Removed files:
- web_api.py - FastAPI web server (44KB)
- demo.html - Web interface (27KB)
- amplify-web-app/ - Frontend deployment artifacts
- .lighthouserc.json, .pa11yrc - Web validation configs
- .github/workflows/web-validate.yml - Web testing workflow

Updated files:
- requirements.txt - Removed FastAPI dependencies, focused on MCP
- requirements-dev.txt - Removed web testing dependencies
- README.md - Complete rewrite for MCP-first architecture
- .github/workflows/deploy-production.yml - Updated for MCP-only deployment

Project is now exclusively an MCP server for Claude Desktop integration.
Verified: MCP server imports and AWS connectivity working correctly.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
- Replace test_api_integration.py with test_mcp_integration.py (205 lines)
- Remove web API server startup from all workflows
- Update all workflows to test MCP functionality instead
- Remove FastAPI dependencies from CI/CD pipeline
- Add comprehensive MCP protocol testing with mocked AWS responses

Fixed workflows:
- develop-ci.yml: Updated MCP tests and dependencies
- ci.yml: Replaced API integration with MCP integration tests
- deploy-development.yml: Removed web server startup

Tests now focus on:
- MCP server imports and functionality
- Geometry engine calculations
- Mocked AWS connectivity
- Protocol compliance

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
### **Cleanup Summary:**
- **AWS Lambda packages**: Removed 236MB of boto3/botocore deployment artifacts
- **Backup directories**: Removed 345MB of old ECS containers and backups
- **Test reports**: Removed 3.6MB of generated HTML coverage reports
- **Session documentation**: Removed 10 temporary status/summary files
- **Node.js artifacts**: Removed misplaced JavaScript dependencies

### **Files Removed:**
- `mcp-server/deploy/boto3/` - AWS SDK (should never be in git)
- `mcp-server/deploy/botocore/` - AWS core library
- `backup/` - Old ECS container backups
- `test-reports/` - Generated coverage HTML
- `docker_job_logs.zip` - Temporary logs
- `docs/*_SESSION_SUMMARY.md` - Session status reports

### **Updated .gitignore:**
- Added AWS deployment package exclusions
- Added session summary document patterns
- Prevents future deployment artifact tracking

### **Result:**
✅ Core functionality preserved - geometry engine and MCP server intact
✅ Repository size reduced by ~584MB
✅ Clean, focused MCP-only project structure
✅ Prevents future bloat with enhanced .gitignore

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
### **Documentation Cleanup:**
- **Removed development session documents** (CLAUDE.md, audit reports, setup notes)
- **Removed development planning docs** (strategy, features, improvements)
- **Removed entire mcp-server/ directory** (development experiments)
- **Enhanced .gitignore** with development document patterns

### **Files Removed:**
**Root Development Documents:**
- `CLAUDE.md` - Internal Claude instructions (36KB+)
- `AMPLIFY_DEPLOYMENT_ANALYSIS.md` - Session analysis
- `INFRASTRUCTURE_AUDIT_REPORT.md` - Development audit
- `MCP_SETUP.md` - Development setup notes
- `config/ai_cognitive_framework_geometry_engine.json` - AI metadata

**docs/ Directory Cleanup:**
- `BRANCH_STRATEGY.md` - Development workflow
- `ENHANCED_MCP_FEATURES.md` - Development wishlist
- `FUTURE_IMPROVEMENTS.md` - Development planning
- `TEST_SUMMARY.md` - Development test report
- `docs/CHANGELOG.md` - Duplicate changelog

**Entire mcp-server/ Directory:**
- Development dashboard experiments
- Lambda deployment prototypes
- Duplicate MCP server implementations
- Development configuration files

### **Retained Production Documentation:**
✅ `README.md` - Project overview
✅ `docs/API_REFERENCE.md` - User API documentation
✅ `docs/INSTALLATION.md` - Setup instructions
✅ `docs/TROUBLESHOOTING.md` - User support
✅ `docs/CONTRIBUTING.md` - Development guidelines
✅ `docs/DEPLOYMENT.md` - Production deployment
✅ `docs/TESTING.md` - Test documentation

### **Result:**
🎯 **Clean, production-focused repository**
📦 **Reduced repository size and complexity**
🛡️ **Prevents future development document accumulation**
🚀 **Clear separation: development artifacts vs production docs**

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
### **Removed Obsolete Files:**

**Configuration:**
- `config/environments.json` - Web application configuration (111 lines)
  - Contained frontend/API endpoints for removed web interface
  - Referenced ECS clusters and CORS settings no longer relevant
  - MCP-only architecture doesn't need this configuration

**Development Artifacts:**
- `demos/FINAL_DEMO.py` - Large demonstration script (475 lines)
  - Comprehensive feature showcase for development
  - Not essential for end users

**Unused Enhanced Java Files:**
- `src/java/enhanced/GeometryAgent.java` - AI-powered geometry agent
- `src/java/enhanced/GeometryConsole.java` - Interactive console
- `src/java/enhanced/HyperCube.java` - N-dimensional cube class
- `src/java/enhanced/HyperSphere.java` - N-dimensional sphere class
- `src/java/enhanced/ModernSphere.java` - Modernized sphere class
- `src/java/enhanced/NDShape.java` - N-dimensional shape abstraction

**Rationale:**
- Enhanced Java files only referenced in archived legacy tests
- Current MCP architecture uses Python geometry engine
- Original CS102 Java files preserved for historical value
- Configuration was specific to removed web interface

**Retained Essential Files:**
✅ `src/java/original/` - Original CS102 files (historical preservation)
✅ `demos/verify_installation.py` - User installation utility
✅ `demos/demo_original_java.py` - Java integration example
✅ `claude_desktop_config_example.json` - MCP setup example

### **Result:**
🎯 **Ultra-clean repository** focused purely on MCP functionality
📦 **Removed ~30KB+ of unused Java code**
🚀 **Clear separation**: essential vs development artifacts

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
### Documentation De-emojified:

**Core Documentation:**
- `README.md` - Project overview and setup instructions
- `CHANGELOG.md` - Version history and release notes

**docs/ Directory:**
- `API_REFERENCE.md` - Complete API documentation
- `CONTRIBUTING.md` - Development guidelines
- `DEPLOYMENT.md` - Production deployment guide
- `INSTALLATION.md` - Setup and installation instructions
- `TESTING.md` - Testing framework documentation
- `TROUBLESHOOTING.md` - Common issues and solutions

**GitHub Configuration:**
- `.github/branch-protection-setup.md` - Repository settings

### Changes Made:
- **Headers**: Removed emoji prefixes from all section headers
- **Bullet Points**: Cleaned emoji markers from list items
- **Status Indicators**: Replaced emoji status with text equivalents
- **Feature Lists**: Removed decorative emojis while preserving content
- **Achievement Lists**: Converted emoji bullets to professional formatting

### Result:
- **Professional Appearance**: Clean, corporate-ready documentation
- **Improved Readability**: Focus on content without visual distractions
- **Accessibility**: Better screen reader compatibility
- **Consistency**: Uniform formatting across all documentation
- **Maintainability**: Easier to edit and update without emoji considerations

All functionality and content preserved - only visual emoji elements removed.

Co-Authored-By: Claude <noreply@anthropic.com>
### Ignore Files Removed (8 obsolete files):

**Web Development Tools (No longer used):**
- `.amplifyignore` - AWS Amplify hosting (removed from architecture)
- `.eslintignore` - ESLint JavaScript linting (no JS in MCP Python project)
- `.prettierignore` - Prettier code formatting (Python uses Black)

**Development Framework Artifacts:**
- `.awsignore` - AWS CLI (not used locally in MCP architecture)
- `.agentignore` - AI ensemble development artifacts
- `.humanignore` - AI consciousness exploration areas
- `.catignore` - Framework migration artifacts

**Duplicate Configuration:**
- `.testignore` - Duplicate of `.pytestignore` with identical patterns

### Ignore Files Retained (6 essential files):

**Core Development Tools:**
- `.gitignore` - Git version control (5,865 lines, comprehensive)
- `.dockerignore` - Docker builds and testing (3,364 lines)
- `.pytestignore` - Pytest test discovery and collection (924 lines)
- `.blackignore` - Black code formatting exclusions (911 lines)
- `.coveragerc` - Coverage reporting configuration (1,805 lines)
- `.ignore` - Modern CLI tools (ripgrep, fd) (1,147 lines)

### Rationale:
- **MCP-Only Architecture**: Removed web development tooling ignore files
- **Tool Alignment**: Keep only ignore files for tools we actually use
- **Reduced Complexity**: From 14 ignore files down to 6 essential ones
- **Maintained Coverage**: All actively used tools still properly configured

### Result:
- **Focused Configuration**: Only relevant ignore patterns remain
- **Reduced Maintenance**: Fewer files to maintain and update
- **Clear Intent**: Ignore files directly map to tools in use
- **No Functionality Lost**: All essential exclusions preserved

Co-Authored-By: Claude <noreply@anthropic.com>
### Configuration Files Updated:

**pyproject.toml:**
- Removed references to deleted mcp-server/ directory from Black exclude patterns
- Cleaned isort skip patterns to remove mcp-server references
- Updated for current MCP-only file structure

**setup.cfg:**
- Removed mcp-server/deploy and mcp-server/src from flake8 excludes
- Cleaned MyPy exclude patterns to remove mcp-server references
- Simplified to only exclude actually existing directories

**requirements-production.txt:**
- MAJOR: Rewrote for MCP-only architecture (no web API)
- Removed FastAPI, uvicorn, pydantic, plotly dependencies
- Focused on core: numpy, mcp, httpx only (4 packages vs 7)
- Updated optimization metrics for MCP-only deployment
- Removed references to removed web_api.py

### Result:
- Configuration files now match actual repository structure
- Production requirements optimized for MCP server only
- Removed all references to deleted web infrastructure
- 90% faster deployment potential with minimal dependencies

Co-Authored-By: Claude <noreply@anthropic.com>
- Updated demos/verify_installation.py for MCP-only architecture
  * Replaced FastAPI/web dependencies with MCP requirements
  * Changed web_api.py checks to geometry_oracle_mcp_server.py checks
  * Updated installation recommendations for MCP workflow

- Fixed run_tests.py configuration issues
  * Removed obsolete mcp-server directory references from MyPy excludes
  * Updated integration test coverage from web_api to geometry_oracle_mcp_server

- Transformed docs/API_REFERENCE.md from REST API to MCP tools documentation
  * Converted from HTTP endpoints to MCP tool descriptions
  * Updated all examples to show MCP tool usage patterns
  * Replaced web API authentication with MCP protocol explanation
  * Added comprehensive MCP tool documentation for all 6 tools

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
🔧 Fixed 4 critical CI/CD issues:

1. **pytest MCP marker configuration**
   - Added missing 'mcp' marker to pytest.ini markers list
   - Fixed pytest.ini section header from [tool:pytest] to [pytest]
   - Simplified configuration to remove problematic benchmark options

2. **MCP server object test failure**
   - Updated test_mcp_server_object_exists to check for list_tools method
   - Fixed assertion to match actual FastMCP object structure

3. **Coverage configuration cleanup**
   - Updated pytest coverage from web_api to geometry_oracle_mcp_server
   - Aligned with MCP-only architecture (removed web API references)

4. **Java compilation path safety**
   - Added conditional check for Java source directory existence
   - Prevents CI failure when src/java/original directory missing

✅ **Result**: All 18 MCP integration tests now pass
✅ **Status**: CI/CD pipeline ready for successful runs
✅ **Architecture**: Fully aligned with MCP-only project structure

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
- Applied Black code formatting standards
- Fixed quote consistency (single to double quotes)
- Corrected import sorting with isort
- Added proper whitespace and newlines
- Resolved CI/CD formatting failures

🎯 Fixes the remaining CI/CD pipeline formatting checks

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
- Replace run_tests.py with focused MCP integration tests
- Remove obsolete pytest-html dependency installation
- Update messaging from web validation to MCP server validation
- Correct deployment status from frontend/backend to MCP components
- Improve AWS deployment guidance for MCP architecture

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
- Remove references to non-existent web_api.py file
- Remove references to non-existent mcp-server/ directory
- Update to use geometry_oracle_mcp_server.py as main application
- Install MCP dependencies directly instead of from missing mcp-requirements.txt
- Update health check and CMD for MCP server instead of web API
- Fix Docker build failures in CI/CD pipeline

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
…pi with test-mcp

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
- Remove all 'master' branch references (use only 'main')
- Fix missing test_api_integration.py references → test_mcp_integration.py
- Fix incorrect volume() method call → get_volume() in production workflow
- Remove obsolete setup.py build step (MCP deployment uses direct file copy)
- Update Docker test file comments for MCP architecture
- Ensure all workflows align with MCP-only codebase structure

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
… deployment

- Add 'aws lambda wait function-updated' to prevent ResourceConflictException
- Ensures Lambda function update completes before attempting to publish version
- Fixes production deployment failures due to timing conflicts

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
- ndgeometry.py: 171 lines, pure stdlib, 4 shape classes (Sphere, Cube, Ellipsoid, Simplex)
- mcp_server.py: 178 lines, direct local computation (no AWS proxy)
- test_ndgeometry.py: 142 lines, 25 tests covering all core functionality

Replaces 2,300+ line geometry_engine.py with mathematically equivalent but 92% smaller implementation.
Original Java from 2014 CS102 preserved in src/java/original/.
Removed:
- geometry_engine.py (2,300 lines) - replaced by ndgeometry.py (171 lines)
- geometry_oracle_mcp_server.py (AWS proxy) - replaced by mcp_server.py (local)
- tests/ (3,600+ lines) - replaced by test_ndgeometry.py (142 lines)
- docs/ (6 documentation files for non-existent features)
- demos/, docker/, Dockerfile
- Old requirements files, config files

Kept:
- src/java/original/ (the actual 2014 CS102 code)
- LICENSE

Net result: ~7,000 lines removed, ~500 lines remain that actually work.
Removed:
- .archive/ directory (48 legacy files)
- 9 tool config files (.bandit, .blackignore, .coveragerc, etc.)
- 6 GitHub workflow files (AWS deployments, Docker builds, etc.)

Added:
- Simple .gitignore (27 lines vs 338)
- Simple test.yml workflow (runs pytest on Python 3.10-3.12)
@bshepp bshepp merged commit 648724e into main Dec 20, 2025
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants