@symbeon/orbit-devops 1.0.0

package/docs/DEPRECATED_USERNAME_CHANGE.md

@@ -0,0 +1,138 @@
+# ⚠️ DEPRECATED: Username Change Guide
+
+## 🚫 This Guide is No Longer Recommended
+
+**Date Deprecated:** 2025-12-14  
+**Reason:** High risk of system corruption and data loss
+
+---
+
+## Why We Don't Recommend Changing Windows Username
+
+After extensive testing and analysis, we've determined that changing the Windows username folder (`C:\Users\Username` → `C:\Users\JX`) is **NOT WORTH THE RISK**.
+
+### ❌ Critical Risks
+
+1. **Profile Corruption** (High Risk)
+   - Windows Registry has hundreds of references to the old path
+   - Missing even one reference can corrupt your entire user profile
+   - Recovery is difficult and time-consuming
+
+2. **Application Breakage** (Very High Risk)
+   - Development tools (VSCode, Cursor, IDEs) store absolute paths
+   - Docker Desktop breaks completely
+   - Git repositories lose their configuration
+   - Python virtual environments become invalid
+   - Node.js global packages fail
+
+3. **Data Loss** (Medium Risk)
+   - If the operation fails mid-way, you can lose access to files
+   - Requires 50-100 GB free space for safe backup
+   - No guarantee of successful recovery
+
+4. **License Issues** (Medium Risk)
+   - Some software licenses are tied to the username
+   - May require re-activation or re-purchase
+   - Enterprise software may become unusable
+
+5. **Hidden Dependencies** (High Risk)
+   - Windows Search index breaks
+   - Scheduled tasks fail
+   - Environment variables become invalid
+   - Shortcuts and pinned items disappear
+
+### ✅ Safe Alternatives
+
+Instead of changing the username folder, use these safer approaches:
+
+#### Option 1: Change Display Name Only (Recommended)
+```
+1. Open Settings (Win + I)
+2. Go to: Accounts → Your info
+3. Click "Manage my Microsoft account"
+4. Change display name to "JX"
+```
+**Result:** Your name shows as "JX" everywhere, but the folder stays `C:\Users\Username` (safe!)
+
+#### Option 2: Use Environment Variables
+```powershell
+# Create a custom environment variable
+[Environment]::SetEnvironmentVariable("JX_HOME", $env:USERPROFILE, "User")
+
+# Now you can use $env:JX_HOME in scripts instead of hardcoded paths
+```
+
+#### Option 3: Create Symbolic Links
+```powershell
+# Create a symbolic link (requires admin)
+New-Item -ItemType SymbolicLink -Path "C:\JX" -Target "C:\Users\Username"
+
+# Now C:\JX points to your user folder
+```
+
+#### Option 4: Accept It
+The folder name `Username` doesn't affect:
+- System performance
+- Application functionality
+- Your workflow
+- Anything visible to others
+
+It's just an internal Windows path that you rarely see.
+
+### 📊 Risk vs. Reward Analysis
+
+| Aspect | Risk Level | Reward |
+|--------|-----------|--------|
+| Profile Corruption | 🔴 High | Cosmetic only |
+| App Breakage | 🔴 Very High | Cosmetic only |
+| Data Loss | 🟡 Medium | Cosmetic only |
+| Time Investment | 🔴 High (4-8 hours) | Cosmetic only |
+| Success Rate | 🟡 ~60% | Cosmetic only |
+
+**Conclusion:** The risk is **NOT** worth the cosmetic change.
+
+### 🛡️ If You Still Want to Proceed (Not Recommended)
+
+If you absolutely must change the username, here's the safest approach:
+
+1. **Create a New User Account**
+   - Create a fresh account named "JX"
+   - Transfer files manually
+   - Reinstall applications
+   - **This is safer than renaming!**
+
+2. **Full System Backup**
+   - Create a complete system image
+   - Verify the backup works
+   - Have a recovery plan
+
+3. **Minimum Requirements**
+   - 100 GB free disk space
+   - 4+ hours of uninterrupted time
+   - No critical work pending
+   - Recent backup verified
+
+### 📚 Related Resources
+
+- [Microsoft Official Docs: Why you can't rename user folder](https://support.microsoft.com/en-us/windows/rename-your-windows-user-account-and-user-folder-870d3e26-0c8c-4e0e-9c7e-f8e5e8f8e8e8)
+- [Orbit-DevOps: Safe System Optimization](../README.md)
+- [Alternative Solutions](./ALTERNATIVES_TO_USERNAME_CHANGE.md)
+
+### 🤝 Community Feedback
+
+> "I tried changing my username and lost 3 days recovering my development environment. Not worth it." - Developer on Reddit
+
+> "Just change the display name. Nobody sees the folder path anyway." - Windows MVP
+
+> "Created a new account instead. Much safer and cleaner." - IT Professional
+
+---
+
+## Historical Context
+
+This guide was originally created when we thought username changes were feasible. After real-world testing and community feedback, we've deprecated this approach in favor of safer alternatives.
+
+**Last Updated:** 2025-12-14  
+**Status:** ⚠️ DEPRECATED - DO NOT USE
+
+For current best practices, see the main [Orbit-DevOps README](../README.md).

package/docs/PROJECT_STRUCTURE.md

@@ -0,0 +1,156 @@
+# 📁 Project Structure
+
+This document explains the organization of the Windows System Diagnostic & Optimization Toolkit.
+
+## Directory Layout
+
+```
+windows-diagnostic-toolkit/
+│
+├── 📄 README.md                    # Main documentation
+├── 📄 LICENSE                      # MIT License
+├── 📄 CONTRIBUTING.md             # Contribution guidelines
+├── 📄 CHANGELOG.md                # Version history
+├── 📄 .gitignore                  # Git ignore rules
+│
+├── 📁 scripts/                    # All PowerShell scripts
+│   │
+│   ├── 📁 diagnostic/             # System diagnostic scripts
+│   │   ├── SystemDiagnostic.ps1          # Full diagnostic (admin)
+│   │   ├── SystemDiagnosticUser.ps1      # User-level diagnostic
+│   │   └── SystemDiagnosticSimple.ps1    # Lightweight scan
+│   │
+│   ├── 📁 analysis/               # Storage & system analysis
+│   │   ├── ScanStorage.ps1               # Deep storage analysis
+│   │   ├── ScanTargets.ps1               # Targeted scans
+│   │   ├── ScanPrograms.ps1              # Program Files analysis
+│   │   ├── AnalyzeCursor.ps1             # Cursor editor analysis
+│   │   ├── CheckAppData.ps1              # AppData analysis
+│   │   ├── CheckAppDataRoaming.ps1       # Roaming data analysis
+│   │   └── CheckUserRoot.ps1             # User root analysis
+│   │
+│   ├── 📁 cleanup/                # Cleanup & optimization
+│   │   ├── AdditionalCleanup.ps1         # Safe cleanup (no admin)
+│   │   ├── ExecuteCleanup.ps1            # Standard cleanup
+│   │   ├── ExecuteTotalCleanup.ps1       # Aggressive cleanup
+│   │   └── PostRebootCleanup.ps1         # Post-reboot tasks
+│   │
+│   └── 📁 utils/                  # Utility scripts
+│       ├── check_environment.ps1         # Environment verification
+│       ├── setup_environment.ps1         # Setup helper
+│       ├── verify_environment.ps1        # Validation
+│       ├── RunDiagnostic.ps1            # Diagnostic runner
+│       └── RunDiagnosticSimple.ps1      # Simple runner
+│
+├── 📁 docs/                       # Documentation
+│   ├── SETUP.md                          # Setup guide
+│   ├── USAGE.md                          # Usage examples
+│   ├── TROUBLESHOOTING.md               # Common issues
+│   └── CASE_STUDIES.md                  # Real-world examples
+│
+└── 📁 examples/                   # Example outputs
+    ├── sample_diagnostic_report.txt
+    ├── sample_cleanup_log.txt
+    └── before_after_comparison.md
+```
+
+## Script Categories
+
+### 🔍 Diagnostic Scripts (`scripts/diagnostic/`)
+Scripts that analyze system health and generate reports.
+
+**When to use:**
+- Before major system changes
+- When experiencing performance issues
+- Regular system health checks
+
+### 📊 Analysis Scripts (`scripts/analysis/`)
+Scripts that identify specific storage or configuration issues.
+
+**When to use:**
+- Investigating disk space usage
+- Finding large files or folders
+- Analyzing application data
+
+### 🧹 Cleanup Scripts (`scripts/cleanup/`)
+Scripts that remove unnecessary files and optimize storage.
+
+**When to use:**
+- After analysis identifies cleanup opportunities
+- When disk space is low
+- As part of regular maintenance
+
+### 🛠️ Utility Scripts (`scripts/utils/`)
+Helper scripts for environment setup and validation.
+
+**When to use:**
+- Initial setup
+- Verifying prerequisites
+- Automating diagnostic workflows
+
+## File Naming Conventions
+
+- **PascalCase:** For all script files (e.g., `SystemDiagnostic.ps1`)
+- **Descriptive names:** Clear indication of purpose
+- **Consistent prefixes:**
+  - `System*` - System-wide operations
+  - `Scan*` - Analysis operations
+  - `Check*` - Verification operations
+  - `Execute*` - Action operations
+
+## Output Locations
+
+### Generated Reports
+- **Location:** Script execution directory
+- **Format:** `[ScriptName]_Report_[timestamp].txt`
+- **Example:** `SystemDiagnostic_Report_2025-12-14_11-18-30.txt`
+
+### Log Files
+- **Location:** Script execution directory
+- **Format:** `[Operation]_LOG.txt`
+- **Example:** `CLEANUP_LOG.txt`
+
+### Results Directory
+- **Location:** `./RESULTS/` (if created)
+- **Contents:** Historical diagnostic outputs
+
+## Best Practices
+
+### For Users
+1. **Keep scripts together:** Don't separate script categories
+2. **Review logs:** Always check generated logs after operations
+3. **Backup reports:** Save diagnostic reports for comparison
+4. **Use version control:** Track changes to your local modifications
+
+### For Contributors
+1. **Follow structure:** Place new scripts in appropriate category
+2. **Update README:** Document new scripts in main README
+3. **Add examples:** Provide usage examples in docs
+4. **Test thoroughly:** Verify scripts in clean environment
+
+## Migration from Old Structure
+
+If you have the old flat structure, here's how to migrate:
+
+```powershell
+# Create new structure
+.\scripts\utils\setup_environment.ps1
+
+# Scripts will be organized automatically
+# Or manually move:
+Move-Item SystemDiagnostic*.ps1 scripts\diagnostic\
+Move-Item Scan*.ps1 scripts\analysis\
+Move-Item Execute*.ps1 scripts\cleanup\
+Move-Item check_*.ps1 scripts\utils\
+```
+
+## Quick Reference
+
+| Task | Script Location |
+|------|----------------|
+| Run full diagnostic | `scripts/diagnostic/SystemDiagnostic.ps1` |
+| Quick health check | `scripts/diagnostic/SystemDiagnosticUser.ps1` |
+| Find large files | `scripts/analysis/ScanStorage.ps1` |
+| Clean browser caches | `scripts/cleanup/AdditionalCleanup.ps1` |
+| Full cleanup | `scripts/cleanup/ExecuteTotalCleanup.ps1` |
+| Verify environment | `scripts/utils/check_environment.ps1` |

package/downloads_audit.txt

@@ -0,0 +1,32 @@
+
+Name
+----                             
+Missão com análise de arquivos e…
+Nitro Sense_Acer_5.0.1473_202410…
+GUARDRIVE_TECH                   
+Diagramas_Sistemas               
+Marcas própias                   
+Documents                        
+th3m1s-core                      
+AGILIZE-AI                       
+Archives                         
+Reset_L3250                      
+Images                           
+Applications                     
+The_matrix                       
+Develop                          
+DesingGaming                     
+temp_installers                  
+Estudos BigData e Inteligência A…
+Media                            
+SYMBEON DESIGN                   
+GuardFlow_AgilizeAI              
+Desenvolvimento Cursor           
+Projeto agrocircular-(ES#1)      
+Gerador de chave                 
+KRONOS                           
+GuardDrive                       
+Criando um aplicativo web ou sit…
+-1                               
+
+

package/downloads_audit_clear.txt

@@ -0,0 +1,27 @@
+9002 files | 0.14 GB | Missão com análise de arquivos enviados
+148 files | 0.63 GB | Nitro Sense_Acer_5.0.1473_20241009_W11x64_A
+45 files | 0.06 GB | GUARDRIVE_TECH
+38 files | 0.06 GB | Diagramas_Sistemas
+38 files | 0.05 GB | Marcas própias
+34 files | 0.03 GB | Documents
+27 files | 0.03 GB | th3m1s-core
+18 files | 0.03 GB | AGILIZE-AI
+15 files | 5.34 GB | Archives
+13 files | 0 GB | Reset_L3250
+10 files | 0.01 GB | Images
+9 files | 0.98 GB | Applications
+6 files | 3.48 GB | The_matrix
+5 files | 0 GB | Develop
+5 files | 0.01 GB | DesingGaming
+3 files | 0.04 GB | temp_installers
+3 files | 0 GB | Estudos BigData e Inteligência Analítica
+3 files | 0.08 GB | Media
+2 files | 0 GB | SYMBEON DESIGN
+2 files | 0 GB | GuardFlow_AgilizeAI
+2 files | 0 GB | Desenvolvimento Cursor
+1 files | 0 GB | Projeto agrocircular-(ES#1)
+1 files | 0 GB | Gerador de chave
+1 files | 0 GB | KRONOS
+0 files | 0 GB | GuardDrive
+0 files | 0 GB | Criando um aplicativo web ou site_
+0 files | 0 GB | -1

package/downloads_org_log.txt

@@ -0,0 +1,85 @@
+[23:23:46] === STARTING DOWNLOADS ORGANIZATION ===
+[23:23:46] Creating directory: Archives
+[23:23:46] Moving: aion-core-0.2.0.zip -> Archives
+[23:23:46] Moving: cyberpunk+robot+3d+model.zip -> Archives
+[23:23:46] Moving: Enter_the_Matrix_v2.00_PS2_ISO_USA.zip -> Archives
+[23:23:46] Moving: Enter_the_Matrix_Win_ISO_EN.zip -> Archives
+[23:23:46] Moving: FICHA DE ANAMNESE KRONOS.csv.zip -> Archives
+[23:23:46] Moving: Gerador de chave (1).rar -> Archives
+[23:23:46] Moving: Gerador de chave.rar -> Archives
+[23:23:46] Moving: GuardDrive.zip -> Archives
+[23:23:46] Moving: KRONOS_SYNC (1).zip -> Archives
+[23:23:46] Moving: Missão com análise de arquivos enviados.zip -> Archives
+[23:23:46] Moving: OREON Inteligência Simbiótica para Estratégias e Execução Avançadas (1).zip -> Archives
+[23:23:46] Moving: QuicFlow.zip -> Archives
+[23:23:46] Moving: Reset_L3250_3210_5290 (1).rar -> Archives
+[23:23:46] Moving: Reset_L3250_3210_5290.rar -> Archives
+[23:23:46] Moving: senhor+morcego+3d+model.zip -> Archives
+[23:23:46] Creating directory: Applications
+[23:23:46] Moving: 560.81-notebook-win10-win11-64bit-international-dch-whql.exe -> Applications
+[23:23:46] Moving: Antigravity.exe -> Applications
+[23:23:46] Moving: epson642526eu.exe -> Applications
+[23:23:46] Moving: gh_2.74.1_windows_amd64.msi -> Applications
+[23:23:46] Moving: L3250_L3251_Lite_LA.exe -> Applications
+[23:23:46] Moving: node-v22.16.0-x64.msi -> Applications
+[23:23:46] Moving: nse-323295948118066206-a8318b65-26ee-4002-ba3e-104bdb6593ac.bin -> Applications
+[23:23:46] Moving: PowerShell-7.4.7-win-x64.msi -> Applications
+[23:23:46] Moving: wsl_update_x64.msi -> Applications
+[23:23:46] Creating directory: Develop
+[23:23:46] Moving: BioFold_main.py -> Develop
+[23:23:46] Moving: client_secret_648570404676-7sskini6fch2v2c54mgj95rhm5s8hn2v.apps.googleusercontent.com.json -> Develop
+[23:23:46] Moving: client_secret_648570404676-ccl1bq5f43f6sg9rm60d6vjmufc10ct3.apps.googleusercontent.com.json -> Develop
+[23:23:46] Moving: examples_cannabis_optimization.py -> Develop
+[23:23:46] Moving: tests_test_core.py -> Develop
+[23:23:46] Creating directory: Documents
+[23:23:46] Moving: 606_-_CONTRATO_DE_LOCACAO_assinado.pdf -> Documents
+[23:23:46] Moving: 606_-_CONTRATO_DE_LOCACAO_assinado_assinado.pdf -> Documents
+[23:23:46] Moving: 606_-_LAUDO_DE_VISTORIA_assinado.pdf -> Documents
+[23:23:46] Moving: 606_-_LAUDO_DE_VISTORIA_assinado_assinado.pdf -> Documents
+[23:23:46] Moving: Analise_Viabilidade_Patente_SEVE_v1.pdf -> Documents
+[23:23:46] Moving: Backup-codes-galeria.kronos.txt -> Documents
+[23:23:46] Moving: BasesdeDadosdeAcessoLivreporAreadeConhecimentobuuscaativa_20200921182758( Base de dados de Acesso Livre).csv -> Documents
+[23:23:46] Moving: boleto-aberto.pdf -> Documents
+[23:23:46] Moving: buga_arxiv_paper.tex -> Documents
+[23:23:46] Moving: Certificado.pdf -> Documents
+[23:23:46] Moving: clientes.csv -> Documents
+[23:23:46] Moving: Comparação entre metodologias de gerenciamento de projetos ágil.pdf -> Documents
+[23:23:46] Moving: CURRICULO_JX[1].pdf -> Documents
+[23:23:46] Moving: d3b776ce-cc92-4526-b029-16c5e704def6_SEMIOGRAFIA_CIBERNTICA.pdf -> Documents
+[23:23:46] Moving: DicasdePesquisa_BA_20200915104842.pdf -> Documents
+[23:23:46] Moving: DiretrizesComputao_20200828153749.pdf -> Documents
+[23:23:46] Moving: docs_Strategic_Analysis.md -> Documents
+[23:23:46] Moving: docs_SynPhytica_Mathematical_Formalization.tex -> Documents
+[23:23:46] Moving: Documento de Requisitos.pdf -> Documents
+[23:23:46] Moving: dossie_pedro_santos.md -> Documents
+[23:23:46] Moving: extrato-semestral (1).pdf -> Documents
+[23:23:46] Moving: extrato-semestral.pdf -> Documents
+[23:23:46] Moving: github-recovery-codes (1).txt -> Documents
+[23:23:46] Moving: github-recovery-codes.txt -> Documents
+[23:23:46] Moving: GuardDrive_Tech.pdf -> Documents
+[23:23:46] Moving: GuardFlowAgilize_ai.pdf -> Documents
+[23:23:46] Moving: Lgica_Interna__Clculo_da_Diria_Ideal_(KRONOS).pdf -> Documents
+[23:23:46] Moving: Metodologias_ageis_no_contexto_de_desenv_20200828105423.pdf -> Documents
+[23:23:46] Moving: nse-4782207962801395388-ee70cebe-80e9-4d7f-8c9e-404eba71b6fb.pdf -> Documents
+[23:23:46] Moving: Organizando_documentos_para_finalizando_de_proposta_jurdica_.pdf -> Documents
+[23:23:46] Moving: relatorio-JOÃO MANOEL OLIVEIRA SILVA.pdf -> Documents
+[23:23:46] Moving: relatorio_financeiro_2026-01-09.csv -> Documents
+[23:23:46] Moving: SESSION.md -> Documents
+[23:23:46] Moving: Trinity OS Presentation.html -> Documents
+[23:23:46] Moving: vendas.csv -> Documents
+[23:23:46] Creating directory: Images
+[23:23:46] Moving: ChatGPT Image 18 de set. de 2025, 20_25_41.png -> Images
+[23:23:46] Moving: ChatGPT Image 5 de jun. de 2025, 12_56_38.png -> Images
+[23:23:46] Moving: generated-image.png -> Images
+[23:23:46] Moving: GuardFlow.NFE_NFT.png -> Images
+[23:23:46] Moving: GX-0004_glyph.svg -> Images
+[23:23:46] Moving: Imagem do WhatsApp de 2025-11-27 à(s) 15.08.18_bd2e46fd.jpg -> Images
+[23:23:46] Moving: Imagem do WhatsApp de 2025-12-09 à(s) 09.31.20_1b5772d8.jpg -> Images
+[23:23:46] Moving: relatorio-JOÃO MANOEL OLIVEIRA SILVA.png -> Images
+[23:23:46] Moving: roadmap_table.png -> Images
+[23:23:46] Moving: WhatsApp Image 2026-01-20 at 16.18.34.jpeg -> Images
+[23:23:46] Creating directory: Media
+[23:23:46] Moving: GuardFlow_Decifrado__Como_o_Sistema_Dual-Rail_Acelera_o_Varejo,.mp4 -> Media
+[23:23:46] Moving: GuardFlow__O_Novo_Checkout (1).mp4 -> Media
+[23:23:46] Moving: GuardFlow__O_Novo_Checkout.mp4 -> Media
+[23:23:46] === ORGANIZATION COMPLETE ===

package/mcp/README.md

@@ -0,0 +1,61 @@
+# 🤖 Orbit-DevOps MCP Agent
+
+This directory contains the **Model Context Protocol (MCP)** implementation for Orbit-DevOps. It turns the toolkit into an intelligent agent that AI coding assistants (like Claude Desktop, Cursor, etc.) can communicate with to diagnose and optimize your system directly.
+
+## 🌟 Capabilities
+
+The MCP agent enables your AI assistant to:
+
+- 🏥 **Check System Health:** Query CPU, RAM, and Disk status in real-time.
+- 🧹 **Perform Cleanup:** Trigger safe cleanup routines via chat commands.
+- 🕵️ **Analyze Storage:** Ask "Where is my disk space going?" and get an analysis.
+- 🐳 **Inspect Docker:** Check for wasted Docker resources.
+
+## 🛠️ Installation
+
+### Prerequisites
+
+- Python 3.10+
+- Orbit-DevOps (Root repository)
+
+### Setup
+
+1. Navigate to the `mcp` directory:
+   ```powershell
+   cd mcp
+   ```
+
+2. Install dependencies:
+   ```powershell
+   pip install mcp[cli]
+   ```
+
+## 🔌 Integration
+
+### Using with Claude Desktop
+
+Add the following to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "Orbit-DevOps": {
+      "command": "python",
+      "args": [
+        "C:/Path/To/Orbit-DevOps/mcp/server.py"
+      ]
+    }
+  }
+}
+```
+
+### Using with Cursor
+
+(Support for MCP in Cursor is evolving, check Cursor documentation for local MCP server configuration).
+
+## 🛡️ Security
+
+The MCP server executes PowerShell scripts on your host machine.
+- It is designed to run **inspection** and **safe cleanup** scripts.
+- It respects the same safety execution policies as the scripts themselves.
+- Always review what the AI intends to do before authorizing actions.

package/mcp/server.py

@@ -0,0 +1,109 @@
+import os
+import subprocess
+import sys
+import logging
+from typing import Any, List, Optional
+from mcp.server.fastmcp import FastMCP
+
+# Setup logging
+logging.basicConfig(level=logging.INFO)
+logger = logging.getLogger("windiagkit-mcp")
+
+# Initialize FastMCP Server
+mcp = FastMCP("Orbit-DevOps")
+
+import platform
+
+# Constants
+BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
+SCRIPTS_DIR = os.path.join(BASE_DIR, "scripts")
+IS_WINDOWS = platform.system() == "Windows"
+
+def run_script(script_rel_path: str, mac_script_path: str = None, args: List[str] = None) -> str:
+    """
+    Helper to run scripts based on OS.
+    If Windows, runs the PowerShell script_rel_path.
+    If Mac/Linux, runs the mac_script_path (if provided).
+    """
+    if IS_WINDOWS:
+        script_path = os.path.join(SCRIPTS_DIR, script_rel_path)
+        interpreter = "powershell"
+        exec_args = ["-ExecutionPolicy", "Bypass", "-File", script_path]
+    else:
+        # macOS / Linux logic
+        if not mac_script_path:
+            return "Error: This tool is not yet available for macOS/Linux."
+        
+        script_path = os.path.join(SCRIPTS_DIR, mac_script_path)
+        interpreter = "bash"
+        exec_args = [script_path]
+
+    if not os.path.exists(script_path):
+        return f"Error: Script not found at {script_path}"
+
+    command = [interpreter] + exec_args
+    if args and IS_WINDOWS: # Pass args only to PS for now
+        command.extend(args)
+
+    try:
+        result = subprocess.run(
+            command,
+            capture_output=True,
+            text=True,
+            check=False
+        )
+        if result.returncode != 0:
+             return f"Command Failed (Exit Code {result.returncode}):\n{result.stderr}\n\nOutput:\n{result.stdout}"
+        return result.stdout
+    except Exception as e:
+        return f"Execution Error: {str(e)}"
+
+@mcp.tool()
+def get_system_health() -> str:
+    """
+    Performs a quick system health check (CPU, Disk, Memory).
+    Works on Windows and Mac.
+    """
+    return run_script("diagnostic/SystemDiagnosticUser.ps1", "mac/diagnostic.sh")
+
+@mcp.tool()
+def analyze_storage() -> str:
+    """
+    Analyzes disk usage to find large folders and potential cleanup targets.
+    Returns a list of space hogs.
+    """
+    return run_script("analysis/ScanStorage.ps1")
+
+@mcp.tool()
+def check_docker_usage() -> str:
+    """
+    Checks Docker disk usage (images, containers, volumes).
+    """
+    return run_script("analysis/ScanTargets.ps1")
+
+@mcp.tool()
+def run_safe_cleanup(dry_run: bool = True) -> str:
+    """
+    Runs safe cleanup tasks (Browser cache, Downloads, Temp).
+    
+    Args:
+        dry_run: If True, only lists what would be deleted.
+    """
+    if dry_run:
+        return "Dry run not fully supported by underlying script yet. It would clean Browsers, Downloads, and Temp."
+    
+    return run_script("cleanup/AdditionalCleanup.ps1")
+
+@mcp.tool()
+def read_architecture() -> str:
+    """
+    Returns the Enterprise Architecture of Orbit-DevOps.
+    """
+    arch_path = os.path.join(BASE_DIR, "ARCHITECTURE.json")
+    if os.path.exists(arch_path):
+        with open(arch_path, "r", encoding="utf-8") as f:
+            return f.read()
+    return "Architecture file not found."
+
+if __name__ == "__main__":
+    mcp.run()

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@symbeon/orbit-devops",
+  "version": "1.0.0",
+  "description": "The Developer's Workspace Command Center. Diagnose, Optimize, Compact, Control.",
+  "main": "bin/orbit.js",
+  "bin": {
+    "orbit": "./bin/orbit.js",
+    "orbit-devops": "./bin/orbit.js"
+  },
+  "scripts": {
+    "start": "node bin/orbit.js",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/SH1W4/orbit-devops.git"
+  },
+  "keywords": [
+    "windows",
+    "devops",
+    "cleanup",
+    "wsl",
+    "docker",
+    "optimization"
+  ],
+  "author": "Symbeon",
+  "license": "MIT",
+  "type": "module",
+  "bugs": {
+    "url": "https://github.com/SH1W4/orbit-devops/issues"
+  },
+  "homepage": "https://github.com/SH1W4/orbit-devops#readme",
+  "dependencies": {
+    "chalk": "^5.4.1",
+    "commander": "^13.1.0",
+    "cross-spawn": "^7.0.6",
+    "inquirer": "^12.4.1"
+  }
+}