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

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."
+```

package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/fix-18-vscode-specialist-context-sync.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: 18
+---
+
+🧩 **vscode-specialist**: Sincronizar context key al set/clear de API key.
+
+# Agent Task — fix-18-vscode-specialist-context-sync
+
+## Identificacion del agente (OBLIGATORIA)
+Primera linea del documento:
+`<icono> **<nombre-agente>**: <mensaje>`
+
+## Input (REQUIRED)
+- **Objetivo**: Asegurar que `agenticWorkflow.hasKey` se actualiza al set/clear y se emite broadcast.
+- **Alcance**: `src/extension/chatkit/openai-key-command.ts`, `src/extension/extension.ts`.
+- **Dependencias**: ApiKeyBroadcaster y context keys ya implementados.
+
+---
+
+## Reasoning (OBLIGATORIO)
+
+### Análisis del objetivo
+- El panel Setup no aparece por contexto stale.
+
+### Opciones consideradas
+- **Opción A**: SetContext en set/clear + broadcast.
+- **Opción B**: Solo en activation (insuficiente).
+
+### Decisión tomada
+- Opción elegida: A.
+- Justificación: garantiza coherencia inmediata.
+
+---
+
+## Output (REQUIRED)
+- **Entregables**:
+  - Context key actualizado en set/clear.
+  - Broadcast hacia views.
+- **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
+- `registerOpenAIKeyCommand` ahora actualiza context key y emite broadcast en set/clear.\n- `activate` sincroniza context key y broadcast inicial.\n@@\n ### Decisiones técnicas\n-- (Decisiones clave y justificación)\n+- Context key se actualiza siempre en set/clear para evitar estado stale.\n@@\n ### Evidencia\n-- (Logs, capturas, tests ejecutados)\n+- `npm run compile` OK.\n@@\n ### Desviaciones del objetivo\n-- (Si las hay, justificación)\n+- Ninguna.
+
+### Decisiones técnicas
+- (Decisiones clave y justificación)
+
+### Evidencia
+- (Logs, capturas, tests ejecutados)
+
+### Desviaciones del objetivo
+- (Si las hay, justificación)
+
+---
+
+## 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-19-vscode-specialist-setup-visible.md

@@ -0,0 +1,88 @@
+---
+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: 19
+---
+
+🧩 **vscode-specialist**: Setup visible siempre + focus chat + Test solo cuando ready.
+
+# Agent Task — fix-19-vscode-specialist-setup-visible
+
+## Identificacion del agente (OBLIGATORIA)
+Primera linea del documento:
+`<icono> **<nombre-agente>**: <mensaje>`
+
+## Input (REQUIRED)
+- **Objetivo**:
+  - Setup visible siempre como sección.
+  - Tras guardar key, enfocar/expandir Chat y colapsar otras views si es posible.
+  - Botón Test solo visible cuando ChatKit esté listo.
+- **Alcance**: `package.json`, `src/extension/views/key/key-view.ts`, `src/extension/views/chat/chat-view.ts`.
+- **Dependencias**: Router de views y context key existentes.
+
+---
+
+## Reasoning (OBLIGATORIO)
+
+### Análisis del objetivo
+- Ajustar UX a flujo deseado con Setup permanente.
+
+### Opciones consideradas
+- **Opción A**: Quitar `when` de setup y usar comandos para enfocar view.
+- **Opción B**: Mantener `when` y mostrar setup inline (no deseado).
+
+### Decisión tomada
+- Opción elegida: A.
+- Justificación: Setup visible siempre y control de foco.
+
+---
+
+## Output (REQUIRED)
+- **Entregables**:
+  - Setup visible siempre.
+  - Chat focus tras guardar key.
+  - Botón Test visible solo cuando ready.
+- **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
+- `package.json`: setup visible siempre.\n- `key-view.ts`: enfocar chat al guardar key.\n- `chat-view.ts`: ocultar Test hasta Ready.\n@@\n ### Decisiones técnicas\n-- (Decisiones clave y justificación)\n+- Uso de `workbench.action.focusView` para expandir Chat.\n@@\n ### Evidencia\n-- (Logs, capturas, tests ejecutados)\n+- `npm run compile` OK.\n@@\n ### Desviaciones del objetivo\n-- (Si las hay, justificación)\n+- Colapsar otras views depende del estado del UI; se fuerza foco en Chat.
+
+### Decisiones técnicas
+- (Decisiones clave y justificación)
+
+### Evidencia
+- (Logs, capturas, tests ejecutados)
+
+### Desviaciones del objetivo
+- (Si las hay, justificación)
+
+---
+
+## Gate (REQUIRED)
+```yaml
+approval:
+  developer:
+    decision: SI | NO
+    date: <ISO-8601>
+    comments: <opcional>
+```

package/dist/agent/artifacts/task-20260130-chatkit-mainview/agent-tasks/fix-20-vscode-specialist-loading-state.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: 20
+---
+
+🧩 **vscode-specialist**: Mensaje Loading centrado en views.
+
+# Agent Task — fix-20-vscode-specialist-loading-state
+
+## Identificacion del agente (OBLIGATORIA)
+Primera linea del documento:
+`<icono> **<nombre-agente>**: <mensaje>`
+
+## Input (REQUIRED)
+- **Objetivo**: Mostrar mensaje centrado “Loading…” hasta que cada view esté listo.
+- **Alcance**: `src/extension/views/chat/chat-view.ts`, `key/key-view.ts`, `history/history-view.ts`, `workflow/workflow-view.ts`.
+- **Dependencias**: views existentes.
+
+---
+
+## Reasoning (OBLIGATORIO)
+
+### Análisis del objetivo
+- UX consistente para cargas iniciales de webviews.
+
+### Opciones consideradas
+- **Opción A**: HTML con contenedor centrado y ocultar al listo.
+- **Opción B**: Spinner complejo (no necesario).
+
+### Decisión tomada
+- Opción elegida: A.
+- Justificación: simple y consistente.
+
+---
+
+## Output (REQUIRED)
+- **Entregables**:
+  - Mensaje “Loading…” centrado en cada view.
+- **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
+- Loading centrado en chat/setup/history/workflow views.
+
+### Decisiones técnicas
+- HTML simple con clase `.loading` para consistencia.
+
+### 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-21-vscode-specialist-loading-label.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: 21
+---
+
+🧩 **vscode-specialist**: Loading con etiqueta de view + ocultar cuando listo.
+
+# Agent Task — fix-21-vscode-specialist-loading-label
+
+## Identificacion del agente (OBLIGATORIA)
+Primera linea del documento:
+`<icono> **<nombre-agente>**: <mensaje>`
+
+## Input (REQUIRED)
+- **Objetivo**: Mostrar “Loading… [view]” y ocultar loading en cada view cuando el HTML esté listo.
+- **Alcance**: `src/extension/views/chat/chat-view.ts`, `key/key-view.ts`, `history/history-view.ts`, `workflow/workflow-view.ts`.
+- **Dependencias**: Loading actual.
+
+---
+
+## Reasoning (OBLIGATORIO)
+
+### Análisis del objetivo
+- Loading debe indicar qué view está cargando y desaparecer cuando esté listo.
+
+### Opciones consideradas
+- **Opción A**: Ocultar loading con `window.onload`.
+- **Opción B**: Mantener loading siempre (no deseado).
+
+### Decisión tomada
+- Opción elegida: A.
+- Justificación: simple, sin dependencias.
+
+---
+
+## Output (REQUIRED)
+- **Entregables**:
+  - “Loading… [view]” visible al inicio.
+  - Loading oculto en cada view al cargar.
+- **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
+- Loading con etiqueta por view y ocultación en load.\n@@\n ### Decisiones técnicas\n-- (Decisiones clave y justificación)\n+- `window.load` para ocultar loading simple.\n@@\n ### Evidencia\n-- (Logs, capturas, tests ejecutados)\n+- `npm run compile` OK.\n@@\n ### Desviaciones del objetivo\n-- (Si las hay, justificación)\n+- Ninguna.
+
+### Decisiones técnicas
+- (Decisiones clave y justificación)
+
+### Evidencia
+- (Logs, capturas, tests ejecutados)
+
+### Desviaciones del objetivo
+- (Si las hay, justificación)
+
+---
+
+## Gate (REQUIRED)
+```yaml
+approval:
+  developer:
+    decision: SI | NO
+    date: <ISO-8601>
+    comments: <opcional>
+```

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

@@ -0,0 +1,89 @@
+---
+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: 8
+---
+
+🧩 **vscode-specialist**: Fix detección de API key faltante en webview.
+
+# Agent Task — fix-8-vscode-specialist-api-key-detect
+
+## Identificacion del agente (OBLIGATORIA)
+Primera linea del documento:
+`<icono> **<nombre-agente>**: <mensaje>`
+
+## Input (REQUIRED)
+- **Objetivo**: Mostrar botón de API key cuando el backend responde 401 al inicializar la vista.
+- **Alcance**: `src/extension/views/main-view.ts` únicamente.
+- **Dependencias**: Servidor ChatKit custom y UX del botón ya implementados.
+
+---
+
+## Reasoning (OBLIGATORIO)
+
+> [!IMPORTANT]
+> El agente **DEBE** completar esta sección ANTES de ejecutar.
+
+### Análisis del objetivo
+- Necesitamos un chequeo explícito de estado de API key al cargar la vista.
+
+### Opciones consideradas
+- **Opción A**: `fetch` a `/chatkit` con `threads.list` y evaluar 401.
+- **Opción B**: confiar en evento `error` del componente (insuficiente).
+
+### Decisión tomada
+- Opción elegida: A.
+- Justificación: asegura UX consistente incluso si el componente no emite evento.
+
+---
+
+## Output (REQUIRED)
+- **Entregables**:
+  - `fetch` inicial a `/chatkit` con `threads.list`.
+  - Mostrar aviso/botón si 401.
+- **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
+
+> Esta sección la completa el agente asignado durante la ejecución.
+
+### Cambios realizados
+- `src/extension/views/main-view.ts`: `fetch` inicial a `/chatkit` con `threads.list` para detectar 401 y mostrar aviso de API key.
+
+### Decisiones técnicas
+- Chequeo explícito al iniciar, no depender de eventos del componente.
+
+### 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-9-vscode-specialist-api-key-state.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: 9
+---
+
+🧩 **vscode-specialist**: Mostrar botón de API key según SecretStorage.
+
+# Agent Task — fix-9-vscode-specialist-api-key-state
+
+## Identificacion del agente (OBLIGATORIA)
+Primera linea del documento:
+`<icono> **<nombre-agente>**: <mensaje>`
+
+## Input (REQUIRED)
+- **Objetivo**: Validar existencia de API key en SecretStorage y avisar a la webview para mostrar el botón si falta.
+- **Alcance**: `src/extension/views/main-view.ts` únicamente.
+- **Dependencias**: Comando de API key y webview ya implementados.
+
+---
+
+## Reasoning (OBLIGATORIO)
+
+### Análisis del objetivo
+- Debemos consultar la key desde el extension host y notificar a la webview.
+
+### Opciones consideradas
+- **Opción A**: Mensaje `api-key-missing` en `resolveWebviewView`.
+- **Opción B**: Continuar con `fetch` al backend.
+
+### Decisión tomada
+- Opción elegida: A.
+- Justificación: No depende de networking ni eventos del componente.
+
+---
+
+## Output (REQUIRED)
+- **Entregables**:
+  - Enviar mensaje inicial `api-key-missing` / `api-key-present`.
+  - Webview muestra/oculta aviso.
+- **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`: envío de estado de API key desde extension host y renderizado del aviso en webview.
+
+### Decisiones técnicas
+- Se usa `context.secrets.get` para estado real sin depender de red.
+
+### Evidencia
+- `npm run compile` OK.
+
+### Desviaciones del objetivo
+- Ninguna.
+
+---
+
+## Gate (REQUIRED)
+```yaml
+approval:
+  developer:
+    decision: SI
+    date: 2026-01-31T00:00:00Z
+    comments: "Aprobado."
+```