Visión del proyecto — Shell Sentinel

Misión

Ofrecer un copiloto de IA nativo en terminal que mantiene sesiones SSH/SFTP persistentes, habla en lenguaje natural y acerca operaciones amigables a infraestructura crítica.

Stack técnico

• Python 3.12, Textual 8.2.7 para la TUI, Strands Agents SDK ≥1.45 para razonamiento conversacional.
• Instalación reproducible con pyproject.toml y lockfiles pip-tools (make lock, make install).
• Herramientas personalizadas: remote_ssh_command, remote_sftp_transfer, local_datetime.
• Herramientas MCP Firecrawl para investigación, scraping y extracción estructurada.

Responsabilidades clave

• Centralizar la configuración en conf/; sin valores hardcodeados en código.
• Actualizar traducciones, manuales y web estática cuando cambie el comportamiento.
• Documentar proveedores personalizados y reglas de plugins; cada plugin con documentación concisa.
• Respetar políticas de seguridad (sin secretos en claro, solo variables de entorno).

Flujo de trabajo

1. Crear entorno virtual con python3.12 -m venv .venv y activarlo.
2. Instalar dependencias con make install.
3. Antes de un PR: make format, make lint, make test.
4. Validar la TUI con make run y la web con make website-serve.

Para políticas completas consulta el manual de colaboración y la documentación de gobernanza. La web estática forma parte del contrato de documentación del producto.