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

package/dist/agent/skills/runtime-governance/SKILL.md

@@ -1,62 +0,0 @@
-# SKILL: runtime-governance
-
-> [!IMPORTANT]
-> **Exclusividad**: Este skill es de uso exclusivo para el **architect-agent**.
-> **Severidad**: PERMANENT
-
-## Objetivo
-Proveer al arquitecto de un conjunto de herramientas y procedimientos para garantizar que el LLM (y otros agentes) utilicen estrictamente el Runtime MCP para la gobernanza del workflow, detectando evasiones de forma reactiva.
-
-## 1. Procedimiento de Trazabilidad (Step 0)
-
-Cuando un workflow solicite "Verificar Trazabilidad", el arquitecto debe:
-1. Llamar a `runtime_chat` o `runtime_emit_event` con un mensaje de activación (ej: "Verifying traceability for session [ID]").
-2. Esperar la confirmación del runtime (`{status: "ok"}`).
-3. Solo tras recibir confirmación, registrar `traceability.verified: true` en el artefacto correspondiente.
-4. **Ruta obligatoria para init**:
-   - `runtime_run` **DEBE** llamarse con `taskPath: ".agent/artifacts/candidate"` (sin `/` final).
-   - **PROHIBIDO** usar:
-     - `.agent/artifacts/candidate/`
-     - `.agent/artifacts/candidate/init.md`
-5. **Completar init vía Runtime (OBLIGATORIO)**:
-   - Tras `runtime_run`, llamar a `runtime_update_init` con los datos recolectados.
-   - El init candidate **NO** puede quedar con placeholders `{{...}}`.
-
-## 2. Huella Digital de Gobernanza (Obligatoria)
-
-Antes de cada transición de fase (Gate), el arquitecto debe asegurar que los logs de stderr contienen la siguiente secuencia para el `runId` actual:
-
-1. `runtime_run`: Debe existir para la tarea activa.
-2. `runtime_update_init`: Debe existir para init antes de validar gate.
-2. `runtime_validate_gate`: Llamado antes del `notify_user` de fin de fase.
-3. `runtime_advance_phase`: Llamado inmediatamente después de recibir el "SI" del usuario.
-
-## 2. Detección Reactiva de Bypasses
-
-El arquitecto debe comparar el estado del sistema de archivos con los logs obtenidos mediante `debug_read_logs`:
-
-- **Anomalía A**: Existe un artefacto de fase (ej: `planning.md`) cuyas marcas de tiempo son posteriores a un mensaje de chat de aprobación, pero **NO** hay registro de `runtime_advance_phase`.
-- **Anomalía B**: El archivo `task.md` marca un paso como completado (`[x]`) sin que el log de runtime muestre la actividad correspondiente en esa ventana temporal.
-- **Anomalía C (Init)**: El init candidate contiene placeholders `{{...}}` o no hay log de `runtime_update_init`.
-
-**Acción ante Bypass**:
-- Invalidar la fase actual.
-- Realizar rollback de los archivos modificados sin gobernanza.
-- Notificar al usuario la violación de gobernanza y solicitar re-ejecución del gate.
-
-## 3. Procedimiento de Validación de Gate
-
-1. Cargar el artefacto de la fase (ej: `analysis.md`).
-2. Llamar a `runtime_validate_gate` con `expectedPhase`.
-3. Si el runtime falla (error visualizado en stdout), **CORREGIR** el artefacto antes de pedir aprobación al usuario.
-4. Una vez aprobado por el usuario, llamar a `runtime_advance_phase`.
-
-## 4. Auditoría de Logs (Checklist)
-
-Para verificar que el sistema está funcionando, busca estos patrones en los logs:
-- `[INFO] [MCP] Server started` -> Servidor activo.
-- `[INFO] [Runtime] Chat message received` -> Comunicación activa.
-- `[INFO] [MCP] Tool called: runtime_...` -> Uso de herramientas.
-
----
-*Garantizando la integridad del proceso agentic-workflow.*

package/dist/agent/templates/analisis.md

@@ -1,86 +0,0 @@
----
-artifact: analisis
-phase: short-phase-1-analisis
-owner: architect-agent
-implementation_owner: architect-agent
-status: draft | approved
-related_task: <taskId>-<taskTitle>
----
-
-# Analisis — <taskId>-<taskTitle>
-
-## Identificacion del agente (OBLIGATORIA)
-Primera linea del documento:
-`<icono> **<nombre-agente>**: <mensaje>`
-
-## 1. Identificacion de la tarea
-
-**Titulo**: <titulo de la tarea>
-**Objetivo**: <objetivo principal>
-**Estrategia**: Short
-**Owner de implementacion**: <agent-id> (por defecto: architect-agent)
-
----
-
-## 2. Las 5 Preguntas Obligatorias
-
-| # | Pregunta (formulada por architect) | Respuesta (del desarrollador) |
-|---|-----------------------------------|-------------------------------|
-| 1 | | |
-| 2 | | |
-| 3 | | |
-| 4 | | |
-| 5 | | |
-
----
-
-## 3. Acceptance Criteria
-
-Derivados de las respuestas anteriores:
-
-1. **Alcance**:
-2. **Entradas/Datos**:
-3. **Salidas esperadas**:
-4. **Restricciones**:
-5. **Criterio de Done**:
-
----
-
-## 4. Analisis simplificado
-
-### Estado actual (As-Is)
-- Estructura afectada:
-- Limitaciones conocidas:
-
-### Evaluacion de complejidad
-
-| Indicador | Estado | Comentario |
-|-----------|--------|------------|
-| Afecta mas de 3 paquetes | ☐ Si ☐ No | |
-| Requiere investigacion APIs | ☐ Si ☐ No | |
-| Cambios breaking | ☐ Si ☐ No | |
-| Tests E2E complejos | ☐ Si ☐ No | |
-
-**Resultado de complejidad**: ☐ BAJA (continuar Short) ☐ ALTA (recomendar abortar a Long)
-
----
-
-## 5. Evaluacion de agentes
-
-| Agente | Desempeno (1-10) | Propuestas de mejora |
-|--------|------------------|----------------------|
-| | | |
-
----
-
-## 6. Aprobacion del desarrollador (OBLIGATORIA)
-
-```yaml
-approval:
-  developer:
-    decision: SI | NO
-    date: <ISO-8601>
-    comments: <opcional>
-```
-
-> Sin aprobacion, esta fase NO puede avanzar a Plan.

package/dist/agent/templates/index.md

@@ -1,43 +0,0 @@
----
-id: templates.index
-owner: architect-agent
-version: 1.0.0
-severity: PERMANENT
----
-
-# INDEX — Templates
-
-## Objetivo
-Este fichero enumera los **templates contractuales** del sistema.
-Los workflows y agentes **DEBEN** referenciar estas plantillas
-por alias en vez de rutas directas.
-
-## Aliases (YAML)
-```yaml
-templates:
-  task: .agent/templates/task.md
-  acceptance: .agent/templates/acceptance.md
-  init: .agent/templates/init.md
-  analysis: .agent/templates/analysis.md
-  planning: .agent/templates/planning.md
-  subtask_implementation: .agent/templates/subtask-implementation.md
-  review: .agent/templates/review.md
-  verification: .agent/templates/verification.md
-  results_acceptance: .agent/templates/results-acceptance.md
-  task_metrics: .agent/templates/task-metrics.md
-  agent_scores: .agent/templates/agent-scores.md
-  research: .agent/templates/research.md
-  agent_task: .agent/templates/agent-task.md
-  todo_item: .agent/templates/todo-item.md
-  changelog: .agent/templates/changelog.md
-  supplemental_report: .agent/templates/supplemental-report.md
-
-  # Templates del ciclo Short
-  analisis: .agent/templates/analisis.md
-  plan: .agent/templates/plan.md
-  qa_results: .agent/templates/qa-results.md
-```
-
-## Reglas
-- Solo declarar templates contractuales del sistema.
-- Cualquier nuevo template **DEBE** añadirse aquí antes de ser referenciado.

package/dist/agent/templates/plan.md

@@ -1,49 +0,0 @@
----
-artifact: plan
-phase: short-phase-2-plan
-owner: architect-agent
-status: draft | approved
-related_task: <taskId>-<taskTitle>
----
-
-# Plan — <taskId>-<taskTitle>
-
-## Identificacion del agente (OBLIGATORIA)
-Primera linea del documento:
-`<icono> **<nombre-agente>**: <mensaje>`
-
-## 1. Resumen del plan
-- Objetivo resumido
-- Resultado esperado
-
----
-
-## 2. Pasos de implementacion
-
-### Paso 1
-- Descripcion:
-- Entregables:
-
-### Paso 2
-- Descripcion:
-- Entregables:
-
----
-
-## 3. Verificacion prevista
-- Tests / validaciones:
-- Criterios de exito:
-
----
-
-## 4. Aprobacion del desarrollador (OBLIGATORIA)
-
-```yaml
-approval:
-  developer:
-    decision: SI | NO
-    date: <ISO-8601>
-    comments: <opcional>
-```
-
-> Sin aprobacion, esta fase NO puede avanzar a Implementacion.

package/dist/agent/templates/qa-results.md

@@ -1,70 +0,0 @@
----
-artifact: qa-results
-phase: short-phase-4-qa-results
-owner: architect-agent
-status: draft | approved
-related_task: <taskId>-<taskTitle>
----
-
-# QA Results — <taskId>-<taskTitle>
-
-## Identificacion del agente (OBLIGATORIA)
-Primera linea del documento:
-`<icono> **<nombre-agente>**: <mensaje>`
-
-## 1. Resumen de la tarea
-
-**Titulo**: <titulo>
-**Estrategia**: Short
-**Estado final**: ☐ Completada ☐ Abortada
-
----
-
-## 2. Verificacion
-
-### Tests ejecutados
-
-| Tipo | Comando/Metodo | Resultado |
-|------|----------------|-----------|
-| Unit | | ☐ Pass ☐ Fail ☐ N/A |
-| Integration | | ☐ Pass ☐ Fail ☐ N/A |
-| E2E | | ☐ Pass ☐ Fail ☐ N/A |
-
-### Justificacion (si no hay tests)
-<Explicar por que no aplican tests>
-
----
-
-## 3. Estado de Acceptance Criteria
-
-| AC | Descripcion | Estado |
-|----|-------------|--------|
-| 1 | | ☐ ✅ ☐ ❌ |
-| 2 | | ☐ ✅ ☐ ❌ |
-| 3 | | ☐ ✅ ☐ ❌ |
-| 4 | | ☐ ✅ ☐ ❌ |
-| 5 | | ☐ ✅ ☐ ❌ |
-
----
-
-## 4. Cambios realizados
-
-### Ficheros modificados/creados
-
-| Fichero | Accion | Descripcion |
-|---------|--------|-------------|
-| | Created/Modified/Deleted | |
-
----
-
-## 5. Aceptacion final del desarrollador (OBLIGATORIA)
-
-```yaml
-approval:
-  developer:
-    decision: SI | NO
-    date: <ISO-8601>
-    comments: <opcional>
-```
-
-> Sin aceptacion, la tarea NO puede marcarse como completada.

package/dist/agent/workflows/index.md

@@ -1,30 +0,0 @@
----
-id: workflows.index
-owner: architect-agent
-version: 1.0.0
-severity: PERMANENT
-description: Índice raíz de workflows del sistema.
----
-
-# INDEX — Workflows (Root)
-
-## Objetivo
-Este índice define los **workflows raíz** del sistema.
-No lista fases ni workflows internos; solo puntos de entrada principales.
-
-Los workflows que representen un dominio complejo (ej. `tasklifecycle`)
-**DEBEN** tener su propio `index.md` local.
-
-```yaml
-workflows:
-  init: .agent/workflows/init.md
-  tasklifecycle-long: .agent/workflows/tasklifecycle-long/index.md
-  tasklifecycle-short: .agent/workflows/tasklifecycle-short/index.md
-```
-
-## Reglas
-- Este índice es **estable y minimalista**.
-- Los workflows NO deben referenciar rutas largas directamente.
-- Las fases **NO deben** declararse en este índice.
-- Para fases o sub-workflows, cargar siempre el `index.md` local del dominio.
-- Si un workflow listado aquí no existe → FAIL.

package/dist/agent/workflows/tasklifecycle-long/index.md

@@ -1,172 +0,0 @@
----
-id: workflow.tasklifecycle-long
-owner: architect-agent
-version: 6.0.0
-severity: PERMANENT
-description: Orquesta el ciclo de vida completo (Long) de una tarea a partir de un init válido.
-trigger:
-  commands: ["tasklifecycle-long", "/tasklifecycle-long"]
-blocking: true
----
-
-# WORKFLOW: tasklifecycle-long (Index)
-
-## Índices requeridos (OBLIGATORIO)
-Este workflow **NO** define aliases fuera de su dominio (`tasklifecycle-long`).
-Para artifacts y templates, **DEBE** cargar índices globales:
-
-- Artifacts index: `.agent/artifacts/index.md`
-- Templates index: `.agent/templates/index.md`
-
-## Aliases del dominio `tasklifecycle-long` (OBLIGATORIO)
-Este workflow define aliases **solo** del dominio `tasklifecycle-long` (task lifecycle long).
-Existe **un único namespace** `aliases.tasklifecycle-long.phases.*` que contiene:
-- `id` de fase
-- `workflow` (path del workflow de la fase)
-
-## Aliases (YAML)
-```yaml
-aliases:
-  tasklifecycle-long:
-    phases:
-      phase_0:
-        id: phase-0-acceptance-criteria
-        workflow: .agent/workflows/tasklifecycle-long/phase-0-acceptance-criteria.md
-      phase_1:
-        id: phase-1-research
-        workflow: .agent/workflows/tasklifecycle-long/phase-1-research.md
-      phase_2:
-        id: phase-2-analysis
-        workflow: .agent/workflows/tasklifecycle-long/phase-2-analysis.md
-      phase_3:
-        id: phase-3-planning
-        workflow: .agent/workflows/tasklifecycle-long/phase-3-planning.md
-      phase_4:
-        id: phase-4-implementation
-        workflow: .agent/workflows/tasklifecycle-long/phase-4-implementation.md
-      phase_5:
-        id: phase-5-verification
-        workflow: .agent/workflows/tasklifecycle-long/phase-5-verification.md
-      phase_6:
-        id: phase-6-results-acceptance
-        workflow: .agent/workflows/tasklifecycle-long/phase-6-results-acceptance.md
-      phase_7:
-        id: phase-7-evaluation
-        workflow: .agent/workflows/tasklifecycle-long/phase-7-evaluation.md
-      phase_8:
-        id: phase-8-commit-push
-        workflow: .agent/workflows/tasklifecycle-long/phase-8-commit-push.md
-```
-
-## Input (REQUIRED)
-- Existe el init candidate (contrato de bootstrap) con timestamp:
-  - `.agent/artifacts/candidate/<timestamp>-init.md`
-- El artefacto `init` **DEBE** contener en su bloque YAML:
-  - `language.value` no vacío
-  - `language.confirmed == true`
-- El desarrollador **DEBE haber respondido** a la pregunta del **Paso 10 (PASS) del workflow `init`**:
-  - definición de la tarea
-  - objetivo de la tarea
-
-## Output (REQUIRED)
-- Crear task candidate (definido en el **Artifacts index**):
-  - `artifacts.candidate.task`
-- El fichero `task candidate` **DEBE** seguir exactamente el template (definido en el **Templates index**):
-  - `templates.task`
-
-## Objetivo (ONLY)
-- Verificar los requisitos mínimos para **iniciar la Fase 0** (inputs obligatorios).
-- Crear el **task candidate** usando el template contractual.
-- Verificar que los workflows de fase del dominio `tasklifecycle-long` existen y se pueden cargar.
-- Si falta algún requisito, **bloquear** y pedir la acción mínima para poder iniciar la **Fase 0**.
-
-> Este workflow **NO** controla si las fases se han completado.
-> La validación y avance de fase es responsabilidad del `architect-agent` dentro de cada fase (gate propio).
-
-## Dispatch / Routing (OBLIGATORIO)
-- El routing de fases **DEBE** basarse en `task.phase.current`.
-- La fase activa **DEBE** mapearse a `aliases.tasklifecycle-long.phases.*.workflow`.
-- Si no existe mapping → **FAIL** (fase inválida o índice corrupto).
-- Solo el `architect-agent` puede cambiar `task.phase.current`.
-
-## Pasos obligatorios
-1. Cargar índices globales:
-   - Cargar `.agent/artifacts/index.md` y `.agent/templates/index.md`.
-   - Si no se pueden cargar → ir a **Paso 7 (FAIL)**.
-
-2. Verificar input:
-   - Comprobar que existe `.agent/artifacts/candidate/<timestamp>-init.md`.
-   - Leer su bloque YAML y validar:
-     - `language.value` no vacío
-     - `language.confirmed == true`
-   - Si falla → ir a **Paso 7 (FAIL)**.
-
-3. Cargar el template contractual de task:
-   - `templates.task`
-   - Si no existe o no se puede cargar → ir a **Paso 7 (FAIL)**.
-
-4. Crear el directorio de candidate (si no existe):
-   - `artifacts.candidate.dir`
-
-5. Crear el artefacto task candidate:
-   - Escribir `artifacts.candidate.task`
-   - El contenido **DEBE** ser conforme al template (sin omitir claves obligatorias).
-   - **DEBE incluir** la información proporcionada por el desarrollador:
-     - descripción de la tarea
-     - objetivo de la tarea
-   - Inicializar `task.phase.current` a `aliases.tasklifecycle-long.phases.phase_0.id`.
-   - Si no se puede crear/escribir → ir a **Paso 7 (FAIL)**.
-
-6. Verificar disponibilidad de fases (solo existencia/carga)
-   - Los workflows de fase **DEBEN** existir como ficheros (no se ejecutan aquí):
-     - `aliases.tasklifecycle-long.phases.phase_0.workflow`
-     - `aliases.tasklifecycle-long.phases.phase_1.workflow`
-     - `aliases.tasklifecycle-long.phases.phase_2.workflow`
-     - `aliases.tasklifecycle-long.phases.phase_3.workflow`
-     - `aliases.tasklifecycle-long.phases.phase_4.workflow`
-     - `aliases.tasklifecycle-long.phases.phase_5.workflow`
-     - `aliases.tasklifecycle-long.phases.phase_6.workflow`
-     - `aliases.tasklifecycle-long.phases.phase_7.workflow`
-     - `aliases.tasklifecycle-long.phases.phase_8.workflow`
-   - Si falta alguno → ir a **Paso 7 (FAIL)**.
-
-7. FAIL (obligatorio)
-   - Declarar `tasklifecycle` como **NO listo para iniciar la Fase 0**.
-   - Indicar exactamente qué caso aplica (uno o más):
-     - índices globales no cargables (`.agent/artifacts/index.md` / `.agent/templates/index.md`)
-     - `init` no existe (`.agent/artifacts/candidate/<timestamp>-init.md`)
-     - idioma no definido o no confirmado en `init`
-     - template inaccesible (`templates.task`)
-     - no se pudo crear `task candidate` (`artifacts.candidate.task`)
-     - falta uno o más workflows de fase (`aliases.tasklifecycle-long.phases.*.workflow`)
-   - Pedir la acción mínima para solventar:
-     - ejecutar `init`
-     - confirmar idioma
-     - corregir índices globales
-     - corregir permisos/ruta para crear el candidate
-     - crear/restaurar el workflow de fase faltante
-   - Terminar bloqueado: hasta solventar errores, **no se puede comenzar la Fase 0**.
-
-## Orden oficial de ejecución de fases
-Las fases del ciclo de vida **DEBEN ejecutarse estrictamente en el orden numérico establecido**.
-No se permite saltar, reordenar ni paralelizar fases.
-
-Orden obligatorio:
-0. `aliases.tasklifecycle-long.phases.phase_0.id`
-1. `aliases.tasklifecycle-long.phases.phase_1.id`
-2. `aliases.tasklifecycle-long.phases.phase_2.id`
-3. `aliases.tasklifecycle-long.phases.phase_3.id`
-4. `aliases.tasklifecycle-long.phases.phase_4.id`
-5. `aliases.tasklifecycle-long.phases.phase_5.id`
-6. `aliases.tasklifecycle-long.phases.phase_6.id`
-7. `aliases.tasklifecycle-long.phases.phase_7.id`
-8. `aliases.tasklifecycle-long.phases.phase_8.id`
-
-## Gate (REQUIRED)
-Requisitos (todos obligatorios):
-1. Existe `artifacts.candidate.task`.
-2. `artifacts.candidate.task` cumple el template `templates.task`.
-3. Están disponibles (existencia) todos los workflows de fase listados en el Paso 6.
-
-Si Gate FAIL:
-- Ejecutar **Paso 7 (FAIL)**.

package/dist/agent/workflows/tasklifecycle-short/index.md

@@ -1,77 +0,0 @@
----
-id: workflow.tasklifecycle-short
-owner: architect-agent
-version: 1.0.0
-severity: PERMANENT
-description: Orquesta el ciclo de vida simplificado (Short) de una tarea a partir de un init válido.
-trigger:
-  commands: ["tasklifecycle-short", "/tasklifecycle-short"]
-blocking: true
----
-
-# WORKFLOW: tasklifecycle-short (Index)
-
-## Índices requeridos (OBLIGATORIO)
-Este workflow **NO** define aliases fuera de su dominio (`tasklifecycle-short`).
-Para artifacts y templates, **DEBE** cargar índices globales:
-
-- Artifacts index: `.agent/artifacts/index.md`
-- Templates index: `.agent/templates/index.md`
-
-## Aliases del dominio `tasklifecycle-short` (OBLIGATORIO)
-Este workflow define aliases **solo** del dominio `tasklifecycle-short` (task lifecycle short).
-Existe **un único namespace** `aliases.tasklifecycle-short.phases.*` que contiene:
-- `id` de fase
-- `workflow` (path del workflow de la fase)
-
-## Aliases (YAML)
-```yaml
-aliases:
-  tasklifecycle-short:
-    phases:
-      init:
-        id: init
-        workflow: .agent/workflows/init.md
-      short_phase_1:
-        id: short-phase-1-analisis
-        workflow: .agent/workflows/tasklifecycle-short/short-phase-1-analisis.md
-      short_phase_2:
-        id: short-phase-2-plan
-        workflow: .agent/workflows/tasklifecycle-short/short-phase-2-plan.md
-      short_phase_3:
-        id: short-phase-3-implementation
-        workflow: .agent/workflows/tasklifecycle-short/short-phase-3-implementation.md
-      short_phase_4:
-        id: short-phase-4-qa-results
-        workflow: .agent/workflows/tasklifecycle-short/short-phase-4-qa-results.md
-```
-
-## Input (REQUIRED)
-- Existe el init candidate con `task.strategy == "short"` en `.agent/artifacts/candidate/<timestamp>-init.md`.
-- El desarrollador ha definido título y objetivo de la tarea.
-
-## Output (REQUIRED)
-- Task candidate con `task.strategy: short`.
-- Artefactos de cada fase: `analisis.md`, `plan.md`, `implementation.md`, `qa-results.md`.
-
-## Objetivo (ONLY)
-- Ejecutar un ciclo simplificado de 4 fases para tareas de baja complejidad.
-- Mantener la integridad de los gates arquitectónicos.
-- Si se detecta complejidad alta en Analisis, ofrecer abortar a Long.
-
-## Orden oficial de ejecución de fases
-Las fases del ciclo Short **DEBEN ejecutarse estrictamente en orden**:
-
-1. `aliases.tasklifecycle-short.phases.short_phase_1.id` (Analisis)
-2. `aliases.tasklifecycle-short.phases.short_phase_2.id` (Plan)
-3. `aliases.tasklifecycle-short.phases.short_phase_3.id` (Implementation)
-4. `aliases.tasklifecycle-short.phases.short_phase_4.id` (QA + Resultados)
-
-## Gate (REQUIRED)
-Requisitos (todos obligatorios):
-1. Existe `artifacts.candidate.task` con `task.strategy: short`.
-2. Están disponibles todos los workflows de fase del dominio `tasklifecycle-short`.
-
-Si Gate FAIL:
-- Indicar exactamente qué requisito falta.
-- Bloquear hasta resolver.