@christianmaf80/agentic-workflow 1.24.0-beta.3 → 1.25.0-beta.3

package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/6-vscode-specialist-refactor-protocol.md

@@ -0,0 +1,108 @@
+---
+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: 6
+---
+
+🧩 **vscode-specialist**: Extraer lógica pura del protocolo ChatKit para habilitar unit tests.
+
+# Agent Task — 6-vscode-specialist-refactor-protocol
+
+## Identificacion del agente (OBLIGATORIA)
+Primera linea del documento:
+`<icono> **<nombre-agente>**: <mensaje>`
+
+## Input (REQUIRED)
+- **Objetivo**: Extraer la lógica pura de protocolo ChatKit (threads/items/eventos) a un módulo sin `vscode` para permitir unit tests.
+- **Alcance**: `src/extension/chatkit/**` únicamente; sin cambiar el comportamiento observable del servidor.
+- **Dependencias**: Servidor ChatKit custom ya implementado.
+
+---
+
+## 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
+- Extraer lógica pura (threads/items/eventos) a un módulo sin `vscode`.
+- Debe mantener el comportamiento del servidor.
+
+### Opciones consideradas
+- **Opción A**: Extraer helpers puros (thread store, builders) a `chatkit-protocol.ts`.
+- **Opción B**: Testear directamente el servidor con mocks de `vscode`.
+
+### Decisión tomada
+- Opción elegida: A.
+- Justificación: Habilita unit tests sin dependencias de VS Code.
+
+---
+
+## Output (REQUIRED)
+- **Entregables**:
+  - Nuevo módulo puro para protocolo ChatKit
+  - Servidor usa ese módulo
+- **Evidencia requerida**:
+  - Build `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
+
+> Esta sección la completa el agente asignado durante la ejecución.
+
+### Cambios realizados
+- Nuevo módulo puro `src/extension/chatkit/chatkit-protocol.ts` con thread store y helpers.
+- `chatkit-server.ts` ahora usa el módulo puro.
+- `src/extension/chatkit/index.ts` exporta tipos/funciones del protocolo.
+
+### Decisiones técnicas
+- Store in-memory para threads/items mantiene el comportamiento actual.
+- Helpers puros permiten testeo con `node:test`.
+
+### Evidencia
+- `npm run compile` OK.
+
+### 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/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>
+```