ChefHyDev Tasks - Extensión de VS Code

Extensión de Visual Studio Code para visualizar y gestionar tus tareas asignadas desde ChefHyDev directamente en el editor.

Características

• 📋 Visualiza todas tus tareas asignadas en un panel lateral
• ✅ Marca tareas como completadas con un clic
• 🔄 Actualización automática cada 5 minutos (configurable)
• 🎨 Muestra información de prioridad, fecha de vencimiento y proyecto
• ⚡ Iconos visuales según la prioridad de la tarea

Instalación

Opción 1: Instalación desde código fuente

1. Clona o descarga este repositorio
2. Abre la carpeta vscode-extension en VS Code
3. Instala las dependencias:

   npm install
   

4. Compila la extensión:

   npm run compile
   

5. Presiona F5 para abrir una nueva ventana de VS Code con la extensión cargada

Opción 2: Instalación como paquete VSIX

1. Compila la extensión:

   npm install
   npm run compile
   

2. Empaqueta la extensión:

   npx vsce package
   

3. Instala el archivo .vsix generado:
   • Abre VS Code
   • Ve a Extensiones (Ctrl+Shift+X)
   • Haz clic en "..." y selecciona "Install from VSIX..."
   • Selecciona el archivo .vsix generado

Configuración

Configurar la URL de la API

1. Abre la configuración de VS Code (Ctrl+,)
2. Busca "ChefHyDev"
3. Configura la URL base de tu API:
   • chefhydev.apiUrl: URL base de la API (por defecto: https://chefhydev.online)

O usa el comando:

• Presiona Ctrl+Shift+P (o Cmd+Shift+P en Mac)
• Escribe "ChefHyDev: Configurar API"
• Ingresa la URL de tu API

Configurar actualización automática

En la configuración puedes ajustar:

• chefhydev.autoRefresh: Activar/desactivar actualización automática (por defecto: true)
• chefhydev.refreshInterval: Intervalo en milisegundos (por defecto: 300000 = 5 minutos)

Uso

Ver tus tareas

1. Abre el panel lateral de explorador (Ctrl+Shift+E)
2. Busca la sección "Mis Tareas"
3. Las tareas se cargarán automáticamente

Actualizar tareas manualmente

• Haz clic en el icono de actualizar (🔄) en la parte superior del panel
• O usa el comando: Ctrl+Shift+P → "ChefHyDev: Actualizar Tareas"

Ver el log de la extensión (depuración)

Si algo no funciona (por ejemplo, "Marcar como completada" no responde al primer clic), puedes ver los logs:

1. Panel Output con canal ChefHyDev Tasks

   • Menú View > Output (o Ctrl+Shift+U)
   • En el desplegable de la derecha del panel Output, elige "ChefHyDev Tasks"
   • Ahí aparecen todos los mensajes de la extensión (clic en completar, API, refrescos, etc.)

2. Desde la paleta de comandos

   • Ctrl+Shift+P → escribe "ChefHyDev: Mostrar log"
   • Se abre el panel Output con el canal "ChefHyDev Tasks" ya seleccionado

3. Extension Host (logs crudos de VS Code)

   • Help > Toggle Developer Tools → pestaña Console
   • O View > Output → desplegable "Extension Host"

Marcar tarea como completada

1. Haz clic derecho sobre una tarea
2. Selecciona "Marcar como Completada"
3. La tarea se actualizará automáticamente

Autenticación

La extensión soporta autenticación con tokens API. Para obtener un token:

Obtener Token de Autenticación

1. Inicia sesión en tu aplicación web de ChefHyDev
2. Abre la consola del navegador (F12)
3. Ejecuta el siguiente código JavaScript:

   fetch('/api/auth/token', { method: 'POST', credentials: 'include' })
     .then(r => r.json())
     .then(data => console.log('Tu token:', data.token))
   

4. Copia el token que aparece en la consola
5. En VS Code, ve a Configuración → ChefHyDev → Auth Token
6. Pega el token

Alternativa: Usa el comando de configuración:

• Presiona Ctrl+Shift+P (o Cmd+Shift+P en Mac)
• Escribe "ChefHyDev: Configurar API"
• Selecciona "Configurar Token de Autenticación"
• Pega tu token

Nota: El token expira después de 30 días. Necesitarás generar uno nuevo cuando expire.

Requisitos

• Visual Studio Code 1.74.0 o superior
• Node.js 18+ (para desarrollo)
• Aplicación ChefHyDev ejecutándose y accesible

Desarrollo

Estructura del proyecto

vscode-extension/
├── src/
│   ├── extension.ts      # Punto de entrada principal
│   ├── taskProvider.ts   # Proveedor de datos para el TreeView
│   ├── taskItem.ts       # Representación de cada tarea
│   └── apiService.ts     # Servicio para comunicarse con la API
├── package.json          # Configuración de la extensión
├── tsconfig.json         # Configuración de TypeScript
└── README.md            # Este archivo

Compilar

npm run compile

Compilar en modo watch (desarrollo)

npm run watch

Solución de problemas

Las tareas no se cargan

1. Verifica que la aplicación web esté ejecutándose
2. Verifica la URL de la API en la configuración
3. Verifica que tengas una sesión activa en el navegador
4. Revisa la consola de VS Code para ver errores: Help → Toggle Developer Tools

Error de autenticación

Si recibes errores 401 (No autorizado):

• Asegúrate de estar logueado en la aplicación web
• Considera implementar autenticación con tokens API

Contribuir

Las contribuciones son bienvenidas. Por favor:

1. Fork el proyecto
2. Crea una rama para tu feature (git checkout -b feature/AmazingFeature)
3. Commit tus cambios (git commit -m 'Add some AmazingFeature')
4. Push a la rama (git push origin feature/AmazingFeature)
5. Abre un Pull Request

Licencia

Este proyecto está bajo la misma licencia que ChefHyDev.