@hybridlabor-api/aos 4.3.0 → 4.4.1

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

@@ -1,353 +0,0 @@
-# AutoHotkey vs Windows Computer Use - Comparative Analysis
-
-**Purpose:** Understanding two competing Windows automation approaches  
-**Date:** 2025-11-29
-
----
-
-## Executive Summary
-
-Both AutoHotkey (AHK) and Windows Computer Use provide Windows desktop automation, but they serve **different use cases** with **different trade-offs**.
-
-| Aspect | AutoHotkey | Windows Computer Use |
-|--------|------------|---------------|
-| **Philosophy** | Scripted automation | AI-assisted automation |
-| **Distribution** | Email .ahk/.exe | MCP client required |
-| **User Interface** | Hotkeys, native GUIs | Conversational AI |
-| **Learning Curve** | Script syntax | MCP concepts |
-| **Target User** | Power users, scripters | AI developers, MCP users |
-| **Execution** | Deterministic | AI-adaptive |
-| **Weight** | Lightweight (~5MB) | Heavy (Python stack) |
-
-**TL;DR:** Use AHK for shareable scripts and hotkeys; use Windows Computer Use for AI-driven adaptive automation.
-
----
-
-## Approach Comparison
-
-### AutoHotkey: The Scripted Approach
-
-```
-User writes script → Script runs deterministically → Same result every time
-```
-
-**Strengths:**
-- **Portable**: Send `.ahk` file to anyone, or compile to `.exe`
-- **Lightweight**: Just AutoHotkey runtime (~5MB install)
-- **Hotkey-native**: Built for keyboard shortcuts
-- **GUI creation**: Native Windows GUI building
-- **Offline**: No network/AI dependencies
-- **Deterministic**: Same script = same result
-
-**Example: Send to Brother Steve**
-```ahk
-; clipboard_saver.ahk - Save clipboard to file
-; Just email this file, Steve runs it, done!
-
-^+s::  ; Ctrl+Shift+S
-{
-    content := A_Clipboard
-    FileAppend content, "saved_clipboard.txt"
-    MsgBox "Clipboard saved!"
-}
-```
-
-### Windows Computer Use: The AI-Assisted Approach
-
-```
-User describes goal → AI decides actions → Adaptive execution
-```
-
-**Strengths:**
-- **Adaptive**: AI understands context and handles variations
-- **Conversational**: Describe what you want in natural language
-- **Deep introspection**: Full UI element tree, OCR, accessibility
-- **Cross-app intelligence**: AI can orchestrate complex workflows
-- **Face recognition**: Biometric security built-in
-- **No script writing**: Claude figures out the automation
-
-**Example: Ask Claude**
-```
-User: "Find the Notepad window, type 'Meeting notes for tomorrow', 
-       save it as meeting.txt on my desktop"
-
-Claude: (uses automation_windows, automation_keyboard, etc.)
-        "Done! I found Notepad, typed your text, and saved the file."
-```
-
----
-
-## Feature Comparison Matrix
-
-### Core Capabilities
-
-| Feature | AutoHotkey | Windows Computer Use |
-|---------|------------|---------------|
-| Keyboard simulation | ✅ Native | ✅ automation_keyboard |
-| Mouse control | ✅ Native | ✅ automation_mouse |
-| Window management | ✅ WinAPI | ✅ automation_windows |
-| UI element interaction | ⚠️ Limited | ✅ Deep UIA support |
-| Hotkey binding | ✅ Excellent | ❌ Not applicable |
-| GUI creation | ✅ Native GUIs | ❌ Not applicable |
-| OCR/text extraction | ❌ External libs | ✅ Built-in |
-| Face recognition | ❌ Not available | ✅ Built-in |
-| Screenshot | ⚠️ Basic | ✅ Advanced |
-| Clipboard | ✅ Native | ✅ automation_system |
-| Process management | ✅ Run, Process | ✅ automation_system |
-
-### Distribution & Deployment
-
-| Aspect | AutoHotkey | Windows Computer Use |
-|--------|------------|---------------|
-| Send via email | ✅ Just send .ahk | ❌ Requires setup |
-| Compile to EXE | ✅ Ahk2Exe | ❌ Not applicable |
-| No install required | ✅ Portable EXE | ❌ Python + deps |
-| Run on any Windows PC | ✅ Yes | ❌ Needs Python stack |
-| Share with non-technical users | ✅ Easy | ❌ Complex |
-
-### Development & Maintenance
-
-| Aspect | AutoHotkey | Windows Computer Use |
-|--------|------------|---------------|
-| Learning curve | Medium (AHK syntax) | Low (natural language) |
-| Debugging | AHK debugger | MCP logs, tool results |
-| Error handling | Try/Catch | AI adapts |
-| Version control | .ahk files | Python code |
-| Testing | Manual/unit tests | Conversational testing |
-| IDE support | VS Code, Cursor | Any MCP client |
-
----
-
-## Use Case Matrix
-
-### When to Use AutoHotkey
-
-| Scenario | Why AHK? |
-|----------|----------|
-| **Hotkey bindings** | AHK was built for this |
-| **Share with non-tech users** | Just email .exe |
-| **Offline automation** | No AI/network needed |
-| **Consistent, repeatable tasks** | Deterministic scripts |
-| **Custom GUIs** | Native GUI toolkit |
-| **Lightweight deployment** | Minimal dependencies |
-| **Game macros** | Low-level input |
-
-**Examples from autohotkey-test:**
-- `clipboard_manager.ahk` - Global clipboard history
-- `window_snapping.ahk` - Custom window layouts
-- `text_expander.ahk` - Text shortcuts
-- `volume_control.ahk` - Media hotkeys
-- `chess_stockfish.ahk` - Full game GUI
-
-### When to Use Windows Computer Use
-
-| Scenario | Why Windows Computer Use? |
-|----------|-------------------|
-| **AI-driven workflows** | Claude decides actions |
-| **Complex UI analysis** | Deep element introspection |
-| **Accessibility auditing** | Full UIA tree access |
-| **OCR text extraction** | Built-in Tesseract |
-| **Security-gated operations** | Face recognition |
-| **Adaptive automation** | Handles UI variations |
-| **Cross-app orchestration** | AI coordinates multiple apps |
-
-**Examples:**
-- "What's on my screen?" (desktop discovery)
-- "Fill out this form" (element interaction)
-- "Only proceed if I'm the authorized user" (face recognition)
-- "Find the error text in this dialog" (OCR)
-
----
-
-## Overlapping Use Cases
-
-Some tasks can be done by either approach:
-
-| Task | AHK Approach | Windows Computer Use Approach |
-|------|--------------|------------------------|
-| **Open Notepad, type text** | `Run "notepad"`<br>`Send "Hello"` | `automation_keyboard("hotkey", ["win","r"])`<br>`automation_keyboard("type", "notepad")` |
-| **Click a button** | `Click 500, 300` or `ControlClick` | `automation_elements("click", control_id="...")` |
-| **Get window title** | `WinGetTitle` | `automation_windows("title", handle=...)` |
-| **Clipboard operations** | `A_Clipboard` | `automation_system("clipboard_get")` |
-| **Screenshot** | External library | `automation_visual("screenshot")` |
-
-**Key Difference:** AHK scripts are predetermined; Windows Computer Use adapts via AI.
-
----
-
-## Distribution Comparison
-
-### AutoHotkey: The "Email to Steve" Model
-
-```
-1. Write script.ahk
-2. (Optional) Compile to script.exe with Ahk2Exe
-3. Email to Steve
-4. Steve double-clicks, runs immediately
-5. Done!
-```
-
-**Requirements for Steve:**
-- AutoHotkey installed (or use compiled .exe)
-- Windows 10/11
-- Trust in the script source
-
-### Windows Computer Use: The "Full Stack" Model
-
-```
-1. Steve installs Python 3.10+
-2. Steve clones/downloads windows-computer-use-mcp
-3. Steve creates virtual environment
-4. Steve installs dependencies (pip install -e .)
-5. Steve configures Claude Desktop MCP settings
-6. Steve restarts Claude Desktop
-7. Steve asks Claude to do automation
-```
-
-**Requirements for Steve:**
-- Python 3.10+
-- pip and virtual environments knowledge
-- Claude Desktop or other MCP client
-- MCP configuration understanding
-- Patience
-
----
-
-## Hybrid Approach: Best of Both Worlds
-
-### Use AHK for Hotkeys + Windows Computer Use for Complex Tasks
-
-**Scenario:** You want quick hotkeys AND AI-driven automation.
-
-```ahk
-; hybrid_launcher.ahk
-; Quick hotkeys that invoke Claude for complex tasks
-
-^!a::  ; Ctrl+Alt+A - Ask Claude to analyze screen
-{
-    ; Copy current context to clipboard
-    ; Claude Desktop with windows-computer-use-mcp handles the rest
-    MsgBox "Switching to Claude for screen analysis..."
-    Run "claude-desktop://"  ; Deep link to Claude
-}
-
-^!f::  ; Ctrl+Alt+F - Quick file operations (AHK handles)
-{
-    ; Simple deterministic task - AHK is faster
-    FileSelectFile, selectedFile
-    FileRead, content, %selectedFile%
-    MsgBox "File contents: " . SubStr(content, 1, 100) . "..."
-}
-```
-
-### Integration Possibilities
-
-1. **AHK calls MCP server** - AHK script triggers windows-computer-use-mcp via HTTP
-2. **MCP generates AHK** - Claude writes AHK scripts via windows-computer-use-mcp
-3. **Shared data** - Both access clipboard, files
-
----
-
-## Migration Scenarios
-
-### From AHK to Windows Computer Use
-
-**When to migrate:**
-- Need adaptive automation
-- Want AI decision-making
-- Require deep UI introspection
-- Building MCP-integrated workflows
-
-**Migration challenges:**
-- Hotkeys don't translate (different paradigm)
-- GUIs need redesign (conversational UI instead)
-- Distribution becomes complex
-
-### From Windows Computer Use to AHK
-
-**When to migrate:**
-- Need to share with non-technical users
-- Want lightweight deployment
-- Require offline operation
-- Need deterministic behavior
-
-**Migration approach:**
-- Extract common operations into AHK scripts
-- Compile to .exe for distribution
-- Document the scripts for users
-
----
-
-## Summary Decision Tree
-
-```
-Need automation on Windows?
-│
-├─ Sharing with non-technical users?
-│   └─ YES → AutoHotkey (compile to .exe)
-│
-├─ Need hotkey bindings?
-│   └─ YES → AutoHotkey (built for this)
-│
-├─ Want AI-adaptive automation?
-│   └─ YES → Windows Computer Use
-│
-├─ Need deep UI introspection?
-│   └─ YES → Windows Computer Use
-│
-├─ Face recognition security needed?
-│   └─ YES → Windows Computer Use
-│
-├─ Offline operation required?
-│   └─ YES → AutoHotkey
-│
-├─ Building MCP-integrated system?
-│   └─ YES → Windows Computer Use
-│
-└─ Simple, repeatable task?
-    └─ AutoHotkey (deterministic scripts)
-```
-
----
-
-## Conclusion
-
-**AutoHotkey** and **Windows Computer Use** are complementary rather than competing:
-
-- **AHK** = Lightweight, shareable, hotkey-focused, deterministic
-- **Windows Computer Use** = AI-powered, adaptive, introspective, integrated
-
-The right choice depends on:
-1. **Who will run it** - Tech-savvy vs general users
-2. **How to distribute** - Email vs MCP client setup
-3. **Execution model** - Deterministic vs AI-adaptive
-4. **Feature needs** - Hotkeys vs deep UI analysis
-
-For many workflows, using **both together** provides the best experience: AHK for quick hotkeys and local scripts, Windows Computer Use for complex AI-driven automation.
-
----
-
----
-
-## Security Warning: AHK EXE + UAC = Malware Vector
-
-**CRITICAL:** AHK compiled executables requesting UAC elevation are a **severe malware vector**.
-
-When you send someone a helpful .exe that requests admin rights:
-- They trust you and click "Yes"
-- The script now has FULL ADMIN ACCESS
-- Could install malware, disable antivirus, encrypt files
-
-**Safe Practice:** Design AHK tools to run WITHOUT admin for analysis. Only request elevation for specific cleanup actions that truly need it, with clear explanation.
-
-See: [AHK EXE Security Warning](../../../autohotkey-test/docs/AHK_EXE_SECURITY_WARNING.md)
-
----
-
-## See Also
-
-- [autohotkey-test repository](../../../autohotkey-test/) - 75+ AHK scriptlets
-- [Windows Cleanup Robot](../../../autohotkey-test/scriptlets/windows_cleanup_robot.ahk) - Safe diagnostic tool
-- [Windows Computer Use Usage Scenarios](./USAGE_SCENARIOS.md) - MCP usage patterns
-- [Portmanteau Pattern](../../mcp-central-docs/patterns/PORTMANTEAU_CONCEPT.md) - Tool design
-

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

@@ -1,54 +0,0 @@
-# windows-computer-use-mcp - Project Assessment
-
-**Category**: MCP Server  
-**Assessment Date**: 2026-01-01  
-**Status**: Production Ready
-
----
-
-## 📊 **Assessment Summary**
-
-| Metric | Value |
-|--------|-------|
-| **Status** | Production Ready |
-| **Development Status** | Complete |
-| **Runt Status** | Unknown |
-| **Last Modified** | 11/29/2025 09:39:45 |
-| **Has Git Repository** | True |
-| **Has Proper Structure** | True |
-| **Has MCPB Packaging** | True |
-| **Has CI/CD Pipeline** | True |
-| **Has Monitoring Stack** | False |
-
----
-
-## 🎯 **Standards Compliance**
-
-- ✅ Proper project structure
-- ✅ MCPB packaging
-- ✅ CI/CD pipeline
----
-
-## 📋 **Important TODOs**
-
-- 🟡 **IMPORTANT**: Implement monitoring stack
----
-
-## 🚀 **Next Steps**
-
-### **Maintain Production**
-1. **Keep up to date with latest standards**
-2. **Regular maintenance and updates**
-3. **Monitor for improvements**
----
-
-## 📚 **References**
-
-- [MCP Central Documentation Standards](../STANDARDS.md)
-- [FastMCP 2.12 Migration Guide](../FASTMCP_2.12_MIGRATION.md)
-- [MCPB Packaging Standards](../MCPB_PACKAGING_STANDARDS.md)
-- [Monitoring Standards](../monitoring/README.md)
-
----
-
-*Assessment generated on 2026-01-01 21:47:42*