@hybridlabor-api/aos 4.2.0 → 4.4.0

package/mcps/windows-computer-use-mcp/docs/_stale/RENAME-TO-AUTOMATION-MCP.md

@@ -1,191 +0,0 @@
-# Rename Proposal: windows-computer-use-mcp → automation-mcp
-
-**Status**: 📋 **READY FOR IMPLEMENTATION**  
-**Date**: 2025-08-28  
-**Priority**: High (UX Improvement)
-
-## Problem Statement
-
-The current name `windows-computer-use-mcp` has significant UX issues:
-- ❌ Obscure library name nobody recognizes
-- ❌ Horrible to type (py-win-auto = mental gymnastics)  
-- ❌ Sounds technical/intimidating
-- ❌ No clear indication of functionality
-- ❌ Mixed case/lowercase inconsistency
-
-## Proposed Solution: `automation-mcp`
-
-### Why This Name Works
-
-#### ✅ Conversational UX Excellence
-```
-Current:  "pywinauto click that button"  😵‍💫
-Proposed: "auto click that button"        😊
-          "automation fill this form"     😊
-          "auto take a screenshot"        😊
-```
-
-#### ✅ No Naming Conflicts
-After comprehensive search of MCP ecosystem:
-- **No existing `automation-mcp`** in official repositories
-- Related but distinct: `arduino-mcp` (robotics), `browser-automation` (web), `workflow-automation` (CI/CD)
-- Clear differentiation: This is **Windows UI automation**
-
-#### ✅ Professional & Discoverable
-- Clear purpose indication
-- Easy to remember and type
-- Professional sound for enterprise use
-- SEO/search friendly
-
-#### ✅ Future-Proof Architecture
-- Can expand to other platforms later
-- Consistent with modern MCP naming patterns
-- Scalable branding approach
-
-## Implementation Plan
-
-### Phase 1: Repository Rename
-```powershell
-# GitHub repository rename (via web interface)
-# Old: https://github.com/sandraschi/windows-computer-use-mcp
-# New: https://github.com/sandraschi/automation-mcp
-```
-
-### Phase 2: Package Structure Update
-
-#### 2.1 Core Files
-```
-📁 automation-mcp/
-├── 📄 pyproject.toml          # Update package name
-├── 📁 src/
-│   └── 📁 automation_mcp/     # Rename from windows_computer_use_mcp
-│       ├── 📄 __init__.py
-│       ├── 📄 server.py       # Update imports
-│       └── 📁 tools/          # Keep structure
-└── 📄 README.md               # Update all references
-```
-
-#### 2.2 Package Configuration
-**pyproject.toml changes:**
-```toml
-[project]
-name = "automation-mcp"                    # Changed from "windows-computer-use-mcp"
-description = "Windows UI automation MCP server using pywinauto"
-
-[project.scripts]
-automation-mcp = "automation_mcp.server:main"  # Updated entry point
-```
-
-#### 2.3 Module Rename
-```python
-# Before: src/windows_computer_use_mcp/
-# After:  src/automation_mcp/
-
-# Update all import statements:
-from automation_mcp.tools import *        # Changed from windows_computer_use_mcp
-```
-
-### Phase 3: Documentation Update
-
-#### 3.1 User-Facing Documentation
-- README.md: Complete rewrite with new branding
-- Installation instructions: `pip install automation-mcp`
-- Usage examples with "auto" commands
-- Configuration examples
-
-#### 3.2 MCP Configuration Examples
-```json
-{
-  "mcpServers": {
-    "automation": {                        // Cleaner config key
-      "command": "automation-mcp",         // New command name
-      "args": []
-    }
-  }
-}
-```
-
-### Phase 4: Migration Strategy
-
-#### 4.1 Backward Compatibility (Optional)
-- Keep `windows-computer-use-mcp` as deprecated alias package
-- Redirect imports for smooth transition
-- Deprecation warnings for 2-3 versions
-
-#### 4.2 User Communication
-- Clear migration guide in README
-- GitHub release notes explaining rename
-- Update any external documentation/tutorials
-
-### Phase 5: Quality Assurance
-
-#### 5.1 Testing Checklist
-- [ ] Package builds successfully
-- [ ] MCP server starts without errors
-- [ ] All tools register correctly
-- [ ] Claude Desktop integration works
-- [ ] No broken import paths
-- [ ] Entry points function properly
-
-#### 5.2 Validation Commands
-```powershell
-# Build and test locally
-cd "D:\Dev\repos\automation-mcp"
-pip install -e .
-automation-mcp
-
-# Test in Claude Desktop
-# Update claude_desktop_config.json with new name
-# Verify tool registration and functionality
-```
-
-## Expected Benefits
-
-### Immediate UX Improvements
-- 🎯 **40% fewer characters to type**: `automation` vs `pywinauto`
-- ⚡ **Instant recognition**: Everyone understands "automation"
-- 💬 **Natural conversations**: "auto click" flows naturally
-- 📈 **Increased adoption**: Lower barrier to entry
-
-### Long-term Strategic Value
-- 🚀 **Professional branding** for enterprise adoption
-- 🔍 **Better discoverability** in MCP ecosystem  
-- 🌐 **Future expansion potential** to other platforms
-- 🏗️ **Consistent naming** with other MCP servers
-
-## Implementation Timeline
-
-**Estimated effort**: 2-3 hours total
-- **Phase 1-2**: 1 hour (rename, package updates)
-- **Phase 3**: 30 minutes (documentation)  
-- **Phase 4-5**: 1 hour (testing, validation)
-
-**Recommended approach**: Single PR with all changes for atomic transition
-
-## Risk Assessment
-
-### Low Risk Factors
-- ✅ Simple file/folder renames
-- ✅ No complex dependencies
-- ✅ No breaking API changes
-- ✅ Clear rollback path available
-
-### Mitigation Strategies
-- 🔄 **Backup**: Complete repo backup before changes
-- 🧪 **Testing**: Thorough local testing before push
-- 📋 **Documentation**: Clear migration instructions
-- ⏪ **Rollback**: Keep old repo as backup temporarily
-
-## Conclusion
-
-Renaming `windows-computer-use-mcp` to `automation-mcp` is a **high-value, low-risk improvement** that will significantly enhance user experience and adoption. The change aligns with modern MCP naming conventions and provides a foundation for future growth.
-
-**Recommendation**: **IMPLEMENT IMMEDIATELY** 
-
-The improved conversational UX alone justifies the small implementation effort. Users will immediately appreciate being able to say "auto click that" instead of wrestling with "pywinauto".
-
----
-
-**Implementation Ready**: All details provided above  
-**Next Action**: Execute rename following the phase-by-phase plan  
-**Success Metric**: Natural "auto" commands work seamlessly in Claude Desktop

package/mcps/windows-computer-use-mcp/docs/_stale/STATUS_REPORT.md

@@ -1,288 +0,0 @@
-# Windows Computer Use - Status Report
-
-**Last Updated:** 2025-11-29  
-**Version:** 0.3.0 (Portmanteau Edition)  
-**Status:** Production Ready ✅
-
----
-
-## Executive Summary
-
-Windows Computer Use has undergone a major architectural refactor to implement the **Portmanteau Pattern**. The server has been consolidated from 60+ scattered individual tools down to **8 comprehensive portmanteau tools**, following FastMCP 2.13.1 best practices.
-
-### Key Achievements
-
-| Metric | Before | After | Improvement |
-|--------|--------|-------|-------------|
-| Tool Count | 60+ | 8 | 87% reduction |
-| Duplicate Definitions | Many | Zero | 100% eliminated |
-| FastMCP Version | Mixed | 2.13.1 | Standardized |
-| Discoverability | Poor | Excellent | Drastically improved |
-
----
-
-## Architecture Changes
-
-### Previous Architecture (v0.2.x)
-
-```
-tools/
-├── basic_tools.py       # 10 tools, some duplicated
-├── element_tools.py     # 15 tools, overlaps with element.py
-├── element.py           # Additional element tools
-├── face_recognition.py  # 5 tools
-├── input.py             # Keyboard/mouse mixed
-├── mouse.py             # Dedicated mouse tools
-├── system_tools.py      # System utilities
-├── visual_tools.py      # OCR and vision
-├── visual.py            # More visual tools
-├── window.py            # Window management
-└── desktop_state.py     # Desktop state capture
-```
-
-**Problems:**
-- Tool explosion (60+ tools overwhelming users)
-- Duplicate functionality across files
-- Inconsistent import patterns (circular import risks)
-- Poor discoverability for Claude
-
-### New Architecture (v0.3.0)
-
-```
-tools/
-├── portmanteau_windows.py    # 11 operations
-├── portmanteau_elements.py   # 14 operations  
-├── portmanteau_mouse.py      # 9 operations
-├── portmanteau_keyboard.py   # 4 operations
-├── portmanteau_visual.py     # 4 operations
-├── portmanteau_face.py       # 5 operations
-├── portmanteau_system.py     # 7 operations
-├── desktop_state.py          # Standalone (unchanged)
-└── archived/                 # Old tools preserved
-```
-
-**Benefits:**
-- Clean 8-tool interface
-- Related operations grouped logically
-- Literal type enums for Claude discoverability
-- Standardized import pattern via `app.py`
-
----
-
-## Tool Inventory
-
-### 1. automation_windows (11 operations)
-Window lifecycle and management operations.
-
-| Operation | Description |
-|-----------|-------------|
-| `list` | List all visible windows |
-| `find` | Find window by title |
-| `maximize` | Maximize window |
-| `minimize` | Minimize window |
-| `restore` | Restore window |
-| `close` | Close window |
-| `activate` | Bring to foreground |
-| `position` | Set position/size |
-| `rect` | Get bounds |
-| `title` | Get title |
-| `state` | Get state flags |
-
-### 2. automation_elements (14 operations)
-UI element interaction and verification.
-
-| Operation | Description |
-|-----------|-------------|
-| `click` | Click element |
-| `double_click` | Double-click |
-| `right_click` | Right-click |
-| `hover` | Hover over element |
-| `text` | Get element text |
-| `set_text` | Set element text |
-| `value` | Get element value |
-| `set_value` | Set element value |
-| `wait` | Wait for element |
-| `verify_text` | Verify text matches |
-| `select` | Select item |
-| `check` | Check checkbox |
-| `uncheck` | Uncheck checkbox |
-| `focus` | Set focus |
-
-### 3. automation_mouse (9 operations)
-Low-level mouse control.
-
-| Operation | Description |
-|-----------|-------------|
-| `position` | Get cursor position |
-| `move` | Move to absolute |
-| `move_relative` | Move relative |
-| `click` | Left click |
-| `double_click` | Double click |
-| `right_click` | Right click |
-| `middle_click` | Middle click |
-| `scroll` | Scroll wheel |
-| `drag` | Drag operation |
-
-### 4. automation_keyboard (4 operations)
-Keyboard input simulation.
-
-| Operation | Description |
-|-----------|-------------|
-| `type` | Type text string |
-| `press` | Press single key |
-| `hotkey` | Key combination |
-| `release` | Release key |
-
-### 5. automation_visual (4 operations)
-Vision and OCR operations.
-
-| Operation | Description |
-|-----------|-------------|
-| `screenshot` | Capture screen/window |
-| `extract_text` | OCR text extraction |
-| `find_image` | Template matching |
-| `compare` | Compare images |
-
-### 6. automation_face (5 operations)
-Face recognition security.
-
-| Operation | Description |
-|-----------|-------------|
-| `add` | Add face to database |
-| `recognize` | Identify face |
-| `list` | List known faces |
-| `delete` | Remove face |
-| `capture` | Webcam capture |
-
-### 7. automation_system (7 operations)
-System utilities.
-
-| Operation | Description |
-|-----------|-------------|
-| `health` | System health check |
-| `help` | Show help |
-| `wait` | Wait seconds |
-| `wait_for_window` | Wait for window |
-| `clipboard_get` | Read clipboard |
-| `clipboard_set` | Set clipboard |
-| `process_list` | List processes |
-
-### 8. get_desktop_state (standalone)
-Comprehensive UI element discovery tool with visual annotations and OCR.
-
----
-
-## Dependency Status
-
-### Core Dependencies
-| Package | Version | Status |
-|---------|---------|--------|
-| fastmcp | >=2.13.1,<3.0.0 | ✅ Current |
-| pywinauto | >=0.6.8 | ✅ Stable |
-| pillow | >=10.0.0 | ✅ Current |
-
-### Optional Dependencies
-| Package | Version | Status |
-|---------|---------|--------|
-| pytesseract | >=0.3.10 | ✅ Optional (OCR) |
-| face-recognition | >=1.3.0 | ✅ Optional (Face) |
-| opencv-python | >=4.8.0 | ✅ Optional (Vision) |
-
----
-
-## Test Status
-
-| Test Suite | Status | Notes |
-|------------|--------|-------|
-| Unit Tests | 🟡 Needs Update | Need to update for portmanteau tools |
-| Integration Tests | 🟡 Needs Update | Pending portmanteau conversion |
-| Import Tests | ✅ Passing | All tools import cleanly |
-| Registration Tests | ✅ Passing | All 8 tools register |
-
-### Quick Verification
-
-```powershell
-cd D:\Dev\repos\windows-computer-use-mcp
-python -c "from windows_computer_use_mcp.app import app; from windows_computer_use_mcp import tools; print('All 8 tools loaded successfully')"
-```
-
----
-
-## Known Issues
-
-### Issue 1: Test Suite Needs Migration
-**Status:** Open  
-**Priority:** Medium  
-**Description:** Unit tests still reference old individual tool functions. Need to update to test portmanteau operations.
-
-### Issue 2: Desktop State Import Warning
-**Status:** Fixed in 0.3.0  
-**Description:** `Optional[Image]` type hint was failing when PIL not properly imported. Fixed by adding explicit `from PIL import Image` import.
-
----
-
-## Migration Notes
-
-### For Users Upgrading from v0.2.x
-
-**Before (v0.2.x):**
-```python
-# Individual tool calls
-list_windows()
-click_element(handle=123, control_id="btn")
-type_text("Hello")
-```
-
-**After (v0.3.0):**
-```python
-# Portmanteau pattern
-automation_windows("list")
-automation_elements("click", window_handle=123, control_id="btn")
-automation_keyboard("type", text="Hello")
-```
-
-### Backward Compatibility
-
-The old individual tool implementations are preserved in `tools/archived/` but are no longer registered with the MCP server. If you need direct function access for testing, import from archived modules.
-
----
-
-## Roadmap
-
-### v0.3.1 (Planned)
-- [ ] Update test suite for portmanteau tools
-- [ ] Add integration tests
-- [ ] Performance benchmarks
-
-### v0.4.0 (Future)
-- [ ] Multi-monitor support improvements
-- [ ] Enhanced OCR with language packs
-- [ ] Recording/playback functionality
-
----
-
-## Compliance
-
-### Glama.ai Status
-- **Last Scan:** Pending rescan after v0.3.0
-- **Previous Status:** Gold ⭐
-- **Expected:** Maintain Gold status
-
-### FastMCP 2.13.1 Compliance
-- ✅ Literal types for action enums
-- ✅ Comprehensive docstrings
-- ✅ No explicit description parameter
-- ✅ Self-registration pattern
-- ✅ Proper error handling
-
----
-
-## Support
-
-- **Repository:** [github.com/sandraschi/windows-computer-use-mcp](https://github.com/sandraschi/windows-computer-use-mcp)
-- **Documentation:** See `/docs` folder
-- **Issues:** GitHub Issues
-
----
-
-*This status report reflects the state as of version 0.3.0 (Portmanteau Edition).*