# ZALVRYX HOST V1.00 (1.00.0)
**Next-Generation Unified Model Context Protocol (MCP) Server for Windows 11**

Zalvryx Host V1.00 es la plataforma consolidada de ejecución, automatización del sistema operativo Windows 11, ingeniería documental, integración persistente con GitHub y ciclo de vida de agentes de inteligencia artificial y entornos de desarrollo mediante el protocolo estándar **Model Context Protocol (MCP)**.

---

## 🏛️ Arquitectura Canónica de 10 Herramientas

Zalvryx Host V1.00 expone exactamente **diez herramientas principales canónicas** en el registro MCP. Cada herramienta implementa un dominio funcional completo y se invoca pasando el discriminador requerido `operation` (o `action` para interoperabilidad):

| # | Herramienta MCP | Dominio | Operaciones Principales |
|---|---|---|---|
| 1 | `zalvryx_files` | Files | `read_text`, `write_text`, `append_text`, `read_metadata`, `list_directory`, `create_directory`, `remove_directory`, `copy_file`, `move_file`, `delete_file`, `search_content`, `search_files`, `calculate_hash`, `archive_create`, `archive_extract` |
| 2 | `zalvryx_documents` | Documents | `read`, `create`, `edit`, `save`, `close`, `validate`, `status`, `recover_word`, `pdf_read`, `pdf_metadata` (Integración nativa COM con Microsoft Word, Excel, PowerPoint y PDF) |
| 3 | `zalvryx_network` | Network | `http_request`, `check_port`, `dns_resolve`, `list_adapters`, `diagnose_connection` |
| 4 | `zalvryx_hosts` | Hosts | `list_hosts`, `inspect_host`, `list_mcp_servers`, `inspect_mcp_connection`, `reconnect_mcp`, `diagnose_handshake` (Auditoría de Antigravity, Claude Desktop, Cursor) |
| 5 | `zalvryx_dev` | Dev | `detect_toolchain`, `build_project`, `compile_project`, `test_project`, `inspect_android_sdk`, `inspect_dependencies` |
| 6 | `zalvryx_shell` | Shell | `run_powershell`, `run_cmd`, `run_command`, `run_background`, `get_job_output`, `stop_job`, `inspect_admin_status`, `winget_search`, `winget_install` |
| 7 | `zalvryx_github` | Github | `get_status`, `list_repos`, `get_repo`, `create_repo`, `list_branches`, `upload_project`, `list_commits`, `list_pulls`, `create_pull`, `list_issues`, `create_issue`, `list_workflows`, `list_workflow_runs`, `detect_local_repo` |
| 8 | `zalvryx_shortcuts` | Shortcuts | `create_shortcut`, `list_shortcuts`, `get_shortcut`, `execute_shortcut`, `delete_shortcut`, `validate_shortcut`, `clean_expired` (Persistencia en `data/shortcuts` con TTL por defecto de 21 días) |
| 9 | `zalvryx_system` | System | **Ciclo de vida del actualizador**: `upd_info`, `upd_check`, `upd_backup_force`, `upd_install`<br>**Telemetría y SO**: `get_telemetry`, `get_clipboard`, `set_clipboard`, `list_processes`, `inspect_port` |
| 10 | `zalvryx_guide` | Guide | `list_domains`, `explain`, `search`, `get_usage`, `diagnose_known_error` |

---

## 🔄 Retrocompatibilidad Total

El runtime incorpora un enrutador interno inteligente (`DomainRegistry`):
- **Llamadas directas V1.00**: `{ name: "zalvryx_files", arguments: { operation: "read_text", path: "..." } }`
- **Alias planos retrocompatibles**: Cualquier llamada heredada (ej. `zalvryx_files_read_text` o `zalvryx_terminal_run_command`) se enruta transparentemente a su correspondiente dominio y operación sin alterar scripts existentes.

---

## 🔐 Integración Persistente con GitHub

- Autenticación nativa mediante Windows Credential Manager y GitHub CLI (`gh`).
- Sube carpetas y proyectos completos de forma atómica en un solo commit utilizando **Git Data API** (blobs, trees, commit y ref update) sin desbordar buffers de memoria ni bloquear hilos.
- Gestión de Pull Requests, Issues, commits y ejecuciones de GitHub Actions.

---

## 🚀 Instalación y Ejecución

```powershell
# Iniciar servidor MCP en STDIO
node server.mjs

# Ejecutar suite de pruebas completa (16 suites al 100%)
node tests/run_all_tests.mjs

# Exportar esquemas canónicos
node export_schemas.mjs
```

---

## 📋 Recursos MCP Oficiales

- `zalvryx://host/overview`: Resumen general de telemetría, versión y salud del host.
- `zalvryx://catalog/tools`: Catálogo completo de las 10 herramientas canónicas y sus operaciones.
- `zalvryx://github/connection`: Estado de autenticación y conectividad con GitHub.
- `zalvryx://github/account`: Perfil y cuotas de rate limit del usuario autenticado.