@christianmaf80/agentic-workflow 1.41.0-beta.10 → 1.42.0

package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/7-qa-agent-unit-tests.md

@@ -0,0 +1,104 @@
+---
+artifact: agent_task
+phase: phase-4-implementation
+owner: qa-agent
+status: in-progress
+related_task: task-20260130-chatkit-mainview-Integrar ChatKit en mainView
+task_number: 7
+---
+
+🛡️ **qa-agent**: Crear unit tests para el protocolo ChatKit (módulo puro).
+
+# Agent Task — 7-qa-agent-unit-tests
+
+## Identificacion del agente (OBLIGATORIA)
+Primera linea del documento:
+`<icono> **<nombre-agente>**: <mensaje>`
+
+## Input (REQUIRED)
+- **Objetivo**: Añadir unit tests del módulo puro de protocolo ChatKit (threads/items/eventos).
+- **Alcance**: tests únicamente; no modificar lógica productiva.
+- **Dependencias**: Tarea 6 completada; módulo puro disponible.
+
+---
+
+## Reasoning (OBLIGATORIO)
+
+> [!IMPORTANT]
+> El agente **DEBE** completar esta sección ANTES de ejecutar.
+> Documentar el razonamiento mejora la calidad y permite detectar errores temprano.
+
+### Análisis del objetivo
+- Añadir tests unitarios para el módulo puro de protocolo ChatKit.
+- Depende de que exista `chatkit-protocol.ts` y su build en `dist`.
+
+### Opciones consideradas
+- **Opción A**: Usar `node:test` con JS ESM contra `dist`.
+- **Opción B**: Integrar con `vscode-test` (más pesado).
+
+### Decisión tomada
+- Opción elegida: A.
+- Justificación: Evita dependencias extra y no toca VS Code API.
+
+---
+
+## Output (REQUIRED)
+- **Entregables**:
+  - Tests para crear thread, añadir item, paginación
+- **Evidencia requerida**:
+  - Comando de test y salida (si aplica)
+
+---
+
+## Execution
+
+```yaml
+execution:
+  agent: "qa-agent"
+  status: completed
+  started_at: 2026-01-31T00:00:00Z
+  completed_at: 2026-01-31T00:00:00Z
+```
+
+---
+
+## Implementation Report
+
+> Esta sección la completa el agente asignado durante la ejecución.
+
+### Cambios realizados
+- Añadidos unit tests en `test/chatkit-protocol.test.js`.
+
+### Decisiones técnicas
+- Tests en JS ESM usando `node:test` para evitar tooling adicional.
+
+### Evidencia
+- `npm run compile`\n- `node --test test/chatkit-protocol.test.js`
+
+### Desviaciones del objetivo
+- Ninguna.
+
+---
+
+## Gate (REQUIRED)
+
+El desarrollador **DEBE** aprobar esta tarea antes de que el arquitecto asigne la siguiente.
+
+```yaml
+approval:
+  developer:
+    decision: SI
+    date: 2026-01-31T00:00:00Z
+    comments: "Aprobado."
+```
+
+---
+
+## Reglas contractuales
+
+1. Esta tarea **NO puede marcarse como completada** sin Gate PASS (`decision: SI`).
+2. Si Gate FAIL (`decision: NO`):
+   - El arquitecto define acciones correctivas.
+   - Se genera una nueva tarea de corrección si procede.
+3. El agente asignado **NO puede modificar** el Input ni el Output definidos por el arquitecto.
+4. El Gate es **síncrono y bloqueante**: el flujo se detiene hasta obtener respuesta del desarrollador.

package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/fix-10-vscode-specialist-api-key-handshake.md

@@ -0,0 +1,84 @@
+---
+artifact: agent_task
+phase: phase-4-implementation
+owner: vscode-specialist
+status: in-progress
+related_task: task-20260130-chatkit-mainview-Integrar ChatKit en mainView
+task_number: 10
+---
+
+🧩 **vscode-specialist**: Handshake webview-ready para estado de API key.
+
+# Agent Task — fix-10-vscode-specialist-api-key-handshake
+
+## Identificacion del agente (OBLIGATORIA)
+Primera linea del documento:
+`<icono> **<nombre-agente>**: <mensaje>`
+
+## Input (REQUIRED)
+- **Objetivo**: Asegurar que el estado de API key llega a la webview usando handshake `webview-ready`.
+- **Alcance**: `src/extension/views/main-view.ts` únicamente.
+- **Dependencias**: Fix de SecretStorage ya implementado.
+
+---
+
+## Reasoning (OBLIGATORIO)
+
+### Análisis del objetivo
+- El mensaje actual puede emitirse antes de que el webview registre el listener.
+
+### Opciones consideradas
+- **Opción A**: Handshake `webview-ready`.
+- **Opción B**: Retry con timeout.
+
+### Decisión tomada
+- Opción elegida: A.
+- Justificación: determinístico y simple.
+
+---
+
+## Output (REQUIRED)
+- **Entregables**:
+  - Webview envía `webview-ready` al iniciar.
+  - Host responde con `api-key-missing` / `api-key-present`.
+- **Evidencia requerida**:
+  - `npm run compile` OK.
+
+---
+
+## Execution
+
+```yaml
+execution:
+  agent: "vscode-specialist"
+  status: completed
+  started_at: 2026-01-31T00:00:00Z
+  completed_at: 2026-01-31T00:00:00Z
+```
+
+---
+
+## Implementation Report
+
+### Cambios realizados
+- `src/extension/views/main-view.ts`: handshake `webview-ready` para enviar estado de API key.
+
+### Decisiones técnicas
+- Mensaje inicial desde webview asegura que el listener esté listo.
+
+### Evidencia
+- `npm run compile` OK.
+
+### Desviaciones del objetivo
+- Ninguna.
+
+---
+
+## Gate (REQUIRED)
+```yaml
+approval:
+  developer:
+    decision: SI | NO
+    date: <ISO-8601>
+    comments: <opcional>
+```

package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/fix-11-vscode-specialist-api-key-button-style.md

@@ -0,0 +1,83 @@
+---
+artifact: agent_task
+phase: phase-4-implementation
+owner: vscode-specialist
+status: in-progress
+related_task: task-20260130-chatkit-mainview-Integrar ChatKit en mainView
+task_number: 11
+---
+
+🧩 **vscode-specialist**: Asegurar visibilidad del botón de API key.
+
+# Agent Task — fix-11-vscode-specialist-api-key-button-style
+
+## Identificacion del agente (OBLIGATORIA)
+Primera linea del documento:
+`<icono> **<nombre-agente>**: <mensaje>`
+
+## Input (REQUIRED)
+- **Objetivo**: Hacer visible el botón “Set API Key” cuando falta la key.
+- **Alcance**: `src/extension/views/main-view.ts` (CSS/HTML).
+- **Dependencias**: UX de API key existente.
+
+---
+
+## Reasoning (OBLIGATORIO)
+
+### Análisis del objetivo
+- El texto aparece pero el botón no, probablemente por estilos/contraste/espaciado.
+
+### Opciones consideradas
+- **Opción A**: Ajustar estilos del bloque y botón (background/outline/margin).
+- **Opción B**: Mover el botón al header.
+
+### Decisión tomada
+- Opción elegida: A.
+- Justificación: cambio mínimo y localizado.
+
+---
+
+## Output (REQUIRED)
+- **Entregables**:
+  - Estilos visibles para el botón.
+- **Evidencia requerida**:
+  - `npm run compile` OK.
+
+---
+
+## Execution
+
+```yaml
+execution:
+  agent: "vscode-specialist"
+  status: completed
+  started_at: 2026-01-31T00:00:00Z
+  completed_at: 2026-01-31T00:00:00Z
+```
+
+---
+
+## Implementation Report
+
+### Cambios realizados
+- `src/extension/views/main-view.ts`: estilos con variables de tema de VS Code para botón y aviso.
+
+### Decisiones técnicas
+- Uso de variables `--vscode-button-*` para contraste automático en tema claro/oscuro.
+
+### Evidencia
+- `npm run compile` OK.
+
+### Desviaciones del objetivo
+- Ninguna.
+
+---
+
+## Gate (REQUIRED)
+```yaml
+approval:
+  developer:
+    decision: SI | NO
+    date: <ISO-8601>
+    comments: <opcional>
+```

package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/fix-12-vscode-specialist-key-gate-view.md

@@ -0,0 +1,84 @@
+---
+artifact: agent_task
+phase: phase-4-implementation
+owner: vscode-specialist
+status: in-progress
+related_task: task-20260130-chatkit-mainview-Integrar ChatKit en mainView
+task_number: 12
+---
+
+🧩 **vscode-specialist**: Vista exclusiva para API key antes de ChatKit.
+
+# Agent Task — fix-12-vscode-specialist-key-gate-view
+
+## Identificacion del agente (OBLIGATORIA)
+Primera linea del documento:
+`<icono> **<nombre-agente>**: <mensaje>`
+
+## Input (REQUIRED)
+- **Objetivo**: Mostrar una vista exclusiva para pedir API key cuando falta; solo mostrar ChatKit y “Ready” cuando la key esté guardada.
+- **Alcance**: `src/extension/views/main-view.ts` únicamente.
+- **Dependencias**: Handshake de API key ya implementado.
+
+---
+
+## Reasoning (OBLIGATORIO)
+
+### Análisis del objetivo
+- UX debe bloquear ChatKit y “Ready” hasta que exista API key.
+
+### Opciones consideradas
+- **Opción A**: Dos layouts en el mismo HTML (key-view vs chat-view) con toggle.
+- **Opción B**: Dos webviews distintas (más complejidad).
+
+### Decisión tomada
+- Opción elegida: A.
+- Justificación: cambio mínimo sin nuevas contribuciones.
+
+---
+
+## Output (REQUIRED)
+- **Entregables**:
+  - Vista de key visible cuando falta.
+  - Vista principal visible cuando hay key.
+- **Evidencia requerida**:
+  - `npm run compile` OK.
+
+---
+
+## Execution
+
+```yaml
+execution:
+  agent: "vscode-specialist"
+  status: completed
+  started_at: 2026-01-31T00:00:00Z
+  completed_at: 2026-01-31T00:00:00Z
+```
+
+---
+
+## Implementation Report
+
+### Cambios realizados
+- `src/extension/views/main-view.ts`: vista “key” exclusiva hasta que exista API key, luego se muestra ChatKit.
+
+### Decisiones técnicas
+- Toggle de vistas dentro del mismo HTML para evitar nuevas contribuciones.
+
+### Evidencia
+- `npm run compile` OK.
+
+### Desviaciones del objetivo
+- Ninguna.
+
+---
+
+## Gate (REQUIRED)
+```yaml
+approval:
+  developer:
+    decision: SI | NO
+    date: <ISO-8601>
+    comments: <opcional>
+```

package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/fix-13-vscode-specialist-status-timeout.md

@@ -0,0 +1,83 @@
+---
+artifact: agent_task
+phase: phase-4-implementation
+owner: vscode-specialist
+status: in-progress
+related_task: task-20260130-chatkit-mainview-Integrar ChatKit en mainView
+task_number: 13
+---
+
+🧩 **vscode-specialist**: Ajustar estado “Sending…” con timeout y error.
+
+# Agent Task — fix-13-vscode-specialist-status-timeout
+
+## Identificacion del agente (OBLIGATORIA)
+Primera linea del documento:
+`<icono> **<nombre-agente>**: <mensaje>`
+
+## Input (REQUIRED)
+- **Objetivo**: Evitar que el estado quede en “Sending…” tras pulsar Test; mostrar Ready o Error con timeout.
+- **Alcance**: `src/extension/views/main-view.ts` únicamente.
+- **Dependencias**: ChatKit UI y botón Test ya implementados.
+
+---
+
+## Reasoning (OBLIGATORIO)
+
+### Análisis del objetivo
+- El promise de `sendUserMessage` puede colgarse o no resolver.
+
+### Opciones consideradas
+- **Opción A**: `Promise.race` con timeout y fallback “Ready”.
+- **Opción B**: Escuchar eventos del componente (no garantizado).
+
+### Decisión tomada
+- Opción elegida: A.
+- Justificación: determinístico sin depender de eventos externos.
+
+---
+
+## Output (REQUIRED)
+- **Entregables**:
+  - Timeout y manejo de error en botón Test.
+- **Evidencia requerida**:
+  - `npm run compile` OK.
+
+---
+
+## Execution
+
+```yaml
+execution:
+  agent: "vscode-specialist"
+  status: completed
+  started_at: 2026-01-31T00:00:00Z
+  completed_at: 2026-01-31T00:00:00Z
+```
+
+---
+
+## Implementation Report
+
+### Cambios realizados
+- `src/extension/views/main-view.ts`: timeout y manejo de error para botón Test.
+
+### Decisiones técnicas
+- `Promise.race` con timeout de 10s para evitar estado colgado.
+
+### Evidencia
+- `npm run compile` OK.
+
+### Desviaciones del objetivo
+- Ninguna.
+
+---
+
+## Gate (REQUIRED)
+```yaml
+approval:
+  developer:
+    decision: SI | NO
+    date: <ISO-8601>
+    comments: <opcional>
+```

package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/fix-14-vscode-specialist-init-flow.md

@@ -0,0 +1,84 @@
+---
+artifact: agent_task
+phase: phase-4-implementation
+owner: vscode-specialist
+status: in-progress
+related_task: task-20260130-chatkit-mainview-Integrar ChatKit en mainView
+task_number: 14
+---
+
+🧩 **vscode-specialist**: Ajustar flow de inicio y mensajes de estado.
+
+# Agent Task — fix-14-vscode-specialist-init-flow
+
+## Identificacion del agente (OBLIGATORIA)
+Primera linea del documento:
+`<icono> **<nombre-agente>**: <mensaje>`
+
+## Input (REQUIRED)
+- **Objetivo**: Implementar flujo de inicio especificado (key-view vs chat-view) y textos de estado.
+- **Alcance**: `src/extension/views/main-view.ts` únicamente.
+- **Dependencias**: Handshake y vista key ya implementados.
+
+---
+
+## Reasoning (OBLIGATORIO)
+
+### Análisis del objetivo
+- Ajustar estados visibles y mensajes según el flujo definido por el usuario.
+
+### Opciones consideradas
+- **Opción A**: Controlar estados con flags locales (`loading`, `ready`).
+- **Opción B**: Rehacer UI con plantillas separadas (no necesario).
+
+### Decisión tomada
+- Opción elegida: A.
+- Justificación: cambio mínimo.
+
+---
+
+## Output (REQUIRED)
+- **Entregables**:
+  - “Loading…” hasta que ChatKit esté listo.
+  - “Sending…” + timeout 10s con error “Tenemos problemas, reintentelo mas tarde”.
+- **Evidencia requerida**:
+  - `npm run compile` OK.
+
+---
+
+## Execution
+
+```yaml
+execution:
+  agent: "vscode-specialist"
+  status: completed
+  started_at: 2026-01-31T00:00:00Z
+  completed_at: 2026-01-31T00:00:00Z
+```
+
+---
+
+## Implementation Report
+
+### Cambios realizados
+- `src/extension/views/main-view.ts`: flujo key->chat con “Loading…” hasta ChatKit listo, timeout 10s y mensaje de error solicitado.
+
+### Decisiones técnicas
+- Inicializar ChatKit solo cuando la key esté presente.
+
+### Evidencia
+- `npm run compile` OK.
+
+### Desviaciones del objetivo
+- Ninguna.
+
+---
+
+## Gate (REQUIRED)
+```yaml
+approval:
+  developer:
+    decision: SI | NO
+    date: <ISO-8601>
+    comments: <opcional>
+```

package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/fix-16-vscode-specialist-view-context.md

@@ -0,0 +1,87 @@
+---
+artifact: agent_task
+phase: phase-4-implementation
+owner: vscode-specialist
+status: in-progress
+related_task: task-20260130-chatkit-mainview-Integrar ChatKit en mainView
+task_number: 16
+---
+
+🧩 **vscode-specialist**: Context keys para mostrar Setup vs Chat views.
+
+# Agent Task — fix-16-vscode-specialist-view-context
+
+## Identificacion del agente (OBLIGATORIA)
+Primera linea del documento:
+`<icono> **<nombre-agente>**: <mensaje>`
+
+## Input (REQUIRED)
+- **Objetivo**: Usar context keys para ocultar/mostrar views según API key; renombrar keyView a “Setup”.
+- **Alcance**: `src/extension/extension.ts`, `src/extension/views/key/key-view.ts`, `package.json`.
+- **Dependencias**: ApiKeyBroadcaster ya implementado.
+
+---
+
+## Reasoning (OBLIGATORIO)
+
+### Análisis del objetivo
+- Mostrar solo Setup si no hay key; mostrar Chat/History/Workflow si hay key.
+
+### Opciones consideradas
+- **Opción A**: `setContext` + `when` en `package.json`.
+- **Opción B**: Collapse manual (no soportado).
+
+### Decisión tomada
+- Opción elegida: A.
+- Justificación: patrón recomendado por VS Code para visibilidad condicional.
+
+---
+
+## Output (REQUIRED)
+- **Entregables**:
+  - `setContext('agenticWorkflow.hasKey', boolean)`.
+  - `views[*].when` en `package.json`.
+  - Vista “Setup”.
+- **Evidencia requerida**:
+  - `npm run compile` OK.
+
+---
+
+## Execution
+
+```yaml
+execution:
+  agent: "vscode-specialist"
+  status: completed
+  started_at: 2026-01-31T00:00:00Z
+  completed_at: 2026-01-31T00:00:00Z
+```
+
+---
+
+## Implementation Report
+
+### Cambios realizados
+- `setContext('agenticWorkflow.hasKey', ...)` en activación y al guardar key.
+- `package.json` views con `when` para mostrar Setup solo si falta key.
+- Setup view renombrada.
+
+### Decisiones técnicas
+- Uso de context keys para visibilidad condicional de views.
+
+### Evidencia
+- `npm run compile` OK.
+
+### Desviaciones del objetivo
+- Ninguna.
+
+---
+
+## Gate (REQUIRED)
+```yaml
+approval:
+  developer:
+    decision: SI
+    date: 2026-01-31T00:00:00Z
+    comments: "Aprobado."
+```

package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/fix-17-vscode-specialist-clear-key-command.md

@@ -0,0 +1,85 @@
+---
+artifact: agent_task
+phase: phase-4-implementation
+owner: vscode-specialist
+status: in-progress
+related_task: task-20260130-chatkit-mainview-Integrar ChatKit en mainView
+task_number: 17
+---
+
+🧩 **vscode-specialist**: Añadir comando para borrar API key.
+
+# Agent Task — fix-17-vscode-specialist-clear-key-command
+
+## Identificacion del agente (OBLIGATORIA)
+Primera linea del documento:
+`<icono> **<nombre-agente>**: <mensaje>`
+
+## Input (REQUIRED)
+- **Objetivo**: Crear comando “Agentic: Clear OpenAI API Key” que borre SecretStorage y actualice context key.
+- **Alcance**: `src/extension/chatkit/openai-key-command.ts`, `package.json`, `src/extension/extension.ts`.
+- **Dependencias**: API key command existente; context keys.
+
+---
+
+## Reasoning (OBLIGATORIO)
+
+### Análisis del objetivo
+- Facilitar tests y resets del flujo setup.
+
+### Opciones consideradas
+- **Opción A**: Nuevo comando de borrado.
+- **Opción B**: Manual vía storage (insuficiente).
+
+### Decisión tomada
+- Opción elegida: A.
+- Justificación: UX directa para QA.
+
+---
+
+## Output (REQUIRED)
+- **Entregables**:
+  - Comando de borrado.
+  - Actualización de context key.
+- **Evidencia requerida**:
+  - `npm run compile` OK.
+
+---
+
+## Execution
+
+```yaml
+execution:
+  agent: "vscode-specialist"
+  status: completed
+  started_at: 2026-01-31T00:00:00Z
+  completed_at: 2026-01-31T00:00:00Z
+```
+
+---
+
+## Implementation Report
+
+### Cambios realizados
+- Nuevo comando `agenticWorkflow.clearOpenAIKey` para borrar SecretStorage.
+- `package.json` actualizado con contribución y activationEvent.
+
+### Decisiones técnicas
+- Mantener comandos en `openai-key-command.ts` para centralizar gestión de key.
+
+### Evidencia
+- `npm run compile` OK.
+
+### Desviaciones del objetivo
+- Ninguna.
+
+---
+
+## Gate (REQUIRED)
+```yaml
+approval:
+  developer:
+    decision: SI
+    date: 2026-01-31T00:00:00Z
+    comments: "Aprobado."
+```