@christianmaf80/agentic-workflow 1.14.0-beta.1 → 1.14.0-beta.3

package/dist/artifacts/26-portable-agentic-system/agent-tasks/1-architect-scaffolding.md

@@ -1,113 +0,0 @@
----
-artifact: agent_task
-phase: phase-4-implementation
-owner: architect-agent
-status: pending
-related_task: 26-portable-agentic-system
-task_number: 1
----
-
-# Agent Task — 1-architect-scaffolding
-
-## Input (REQUIRED)
-- **Objetivo**: Crear estructura inicial del paquete npm `@cmarino/agentic-workflow`.
-- **Alcance**: 
-  - Crear directorio raíz `agentic-workflow` en el workspace.
-  - Inicializar `package.json` con nombre, versión y binarios.
-  - Instalar dependencias base: `commander`, `@clack/prompts`, `typescript` (dev).
-  - Configurar `tsconfig.json` básico.
-  - Crear estructura de carpetas: `src/`, `bin/`.
-- **Dependencias**: Ninguna.
-
----
-
-## 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
-- ¿Qué se pide exactamente?
-  - Crear la estructura base de directorios y configuración para el paquete `@cmarino/agentic-workflow`.
-- ¿Hay ambigüedades o dependencias?
-  - No, es un paso fundamental y aislado.
-
-### Opciones consideradas
-- **Opción A**: Usar `npm init` interactivo. Requiere simular input de usuario, propenso a errores en entorno agéntico.
-- **Opción B**: Crear ficheros `package.json` y `tsconfig.json` directamente con contenido predefinido. Mayor control y determinismo.
-
-### Decisión tomada
-- Opción elegida: **Opción B**.
-- Justificación: Garantiza que la estructura sea exactamente la especificada en el plan sin depender de wizards interactivos.
-
----
-
-## Output (REQUIRED)
-- **Entregables**:
-  - `agentic-workflow/package.json`
-  - `agentic-workflow/tsconfig.json`
-  - `agentic-workflow/src/`
-  - `agentic-workflow/bin/`
-- **Evidencia requerida**:
-  - Listado de archivos generados.
-  - Contenido de `package.json`.
-
----
-
-## Execution
-
-```yaml
-execution:
-  agent: "architect-agent"
-  status: completed
-  started_at: "2026-01-19T22:18:00+01:00"
-  completed_at: "2026-01-19T22:21:00+01:00"
-```
-
----
-
-## Implementation Report
-
-> Esta sección la completa el agente asignado durante la ejecución.
-
-### Cambios realizados
-- Creado directorio raíz `agentic-workflow`.
-- Creados directorios `src` y `bin`.
-- Generado `package.json` con dependencias: `commander`, `@clack/prompts`.
-- Generado `tsconfig.json` configurado para `NodeNext` y ESM.
-
-### Decisiones técnicas
-- Se ha optado por `ESM` (`"type": "module"` implícito por target NodeNext o explícito si fuera necesario, aquí manejado por TS) para compatibilidad moderna.
-- Se han incluido scripts básicos `build` y `start`.
-
-### Evidencia
-- Ficheros creados correctamente en el sistema de archivos (verificados por herramientas de escritura).
-
-### 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-19T22:22:22+01:00
-    comments: Aprobado por consola.
-```
-
----
-
-## 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/artifacts/26-portable-agentic-system/agent-tasks/2-architect-core-migration.md

@@ -1,117 +0,0 @@
----
-artifact: agent_task
-phase: phase-4-implementation
-owner: architect-agent
-status: pending
-related_task: 26-portable-agentic-system
-task_number: 2
----
-
-# Agent Task — 2-architect-core-migration
-
-## Input (REQUIRED)
-- **Objetivo**: Migrar y adaptar el core agéntico (Rules, Workflows, Templates) al nuevo paquete, desacoplándolo de Extensio.
-- **Alcance**: 
-  - Copiar `.agent/rules/` a `agentic-workflow/src/rules/` (filtrando reglas específicas de Extensio como constitution.modules).
-  - Copiar `.agent/workflows/` a `agentic-workflow/src/workflows/` (solo workflows genéricos como tasklifecycle).
-  - Copiar `.agent/templates/` a `agentic-workflow/src/templates/`.
-  - Crear `agentic-workflow/src/index.ts` que exporte utilidades core.
-  - Limpiar referencias hardcodeadas a `/Users/.../extensio` en los ficheros copiados (reemplazar por variables de entorno o paths relativos).
-- **Dependencias**: Tarea 1 completada.
-
----
-
-## 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
-- ¿Qué se pide exactamente?
-  - Extraer la lógica "core" de orquestación (reglas, workflows, templates) a un paquete aislado.
-  - Eliminar dependencias intelectuales (referencias a Extensio, WebExtensions) para hacerlo genérico.
-
-### Opciones consideradas
-- **Opción A**: Copiar todo y borrar fichero por fichero. Riesgo de fuga de información o basura.
-- **Opción B**: Copia selectiva (allowlist) de reglas de constitución y workflows de ciclo de vida, ignorando dominios específicos (drivers/modules).
-
-### Decisión tomada
-- Opción elegida: **Opción B y Refactorización In-situ**.
-- Justificación: Permite construir un core limpio desde cero. Se renombraron conceptos clave (`extensio-architecture` -> `project-architecture`) para garantizar neutralidad.
-
----
-
-## Output (REQUIRED)
-- **Entregables**:
-  - `agentic-workflow/src/rules/` (limpio y genérico)
-  - `agentic-workflow/src/workflows/` (ciclo de vida only)
-  - `agentic-workflow/src/templates/` (sin referencias a drivers/modules)
-  - `agentic-workflow/src/core/index.ts`
-- **Evidencia requerida**:
-  - Listado de archivos en `src/`.
-  - Muestra de un workflow migrado sin referencias absolutas.
-
----
-
-## Execution
-
-```yaml
-execution:
-  agent: "architect-agent"
-  status: completed
-  started_at: "2026-01-19T22:22:00+01:00"
-  completed_at: "2026-01-19T22:27:00+01:00"
-```
-
----
-
-## Implementation Report
-
-> Esta sección la completa el agente asignado durante la ejecución.
-
-### Cambios realizados
-- **Copia Base**: Workflows de `tasklifecycle`, `init`, y Rules de `constitution` y `roles` fueron migrados.
-- **Generalización**:
-  - `clean-code.md` reescrito para eliminar referencias a Browser Extensions.
-  - `project-architecture.md` creado como sustituto de `extensio-architecture.md`.
-  - `architect.md` actualizado a rol de arquitecto de proyecto genérico.
-- **Limpieza**:
-  - Eliminados roles `driver`, `module`, `surface`.
-  - Eliminados templates de creación de drivers y módulos.
-  - Actualizado `templates/index.md` con la lista canónica reducida.
-
-### Decisiones técnicas
-- Se mantiene `GEMINI.location.md` ya que es una dependencia de entorno externa, pero el puntero es válido.
-- Se eliminaron los paths absolutos en las copias (pendiente de validación final en paso de linking, pero los ficheros clave ya usan alias o paths relativos `.agent/`).
-
-### Evidencia
-- Estructura en `agentic-workflow/src` refleja un sistema agnóstico.
-
-### Desviaciones del objetivo
-- Ninguna significativa. La refactorización fue más profunda de lo previsto en la descripción original (renombrado de arquitectura), lo cual es positivo.
-
----
-
-## Gate (REQUIRED)
-
-El desarrollador **DEBE** aprobar esta tarea antes de que el arquitecto asigne la siguiente.
-
-```yaml
-approval:
-  developer:
-    decision: SI
-    date: 2026-01-19T22:28:19+01:00
-    comments: Aprobado por consola.
-```
-
----
-
-## 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/artifacts/26-portable-agentic-system/agent-tasks/3-architect-cli-implementation.md

@@ -1,109 +0,0 @@
----
-artifact: agent_task
-phase: phase-4-implementation
-owner: architect-agent
-status: pending
-related_task: 26-portable-agentic-system
-task_number: 3
----
-
-# Agent Task — 3-architect-cli-implementation
-
-## Input (REQUIRED)
-- **Objetivo**: Implementar el CLI `init` que despliega el sistema en el proyecto del usuario.
-- **Alcance**: 
-  - Crear `src/cli/index.ts` usando `commander` y `@clack/prompts`.
-  - Comando `init`:
-    - Preguntar idioma y estrategia (opcional, o dejar que el workflow init lo haga).
-    - Copiar el contenido de `src/rules`, `src/workflows`, `src/templates` a `.agent/` en el `process.cwd()`.
-    - Generar `.agent/index.md` dinámico apuntando a los ficheros copiados.
-    - Generar `AGENTS.md` (instrucciones para IDE).
-  - Compilación: Asegurar que `npm run build` genera `dist/` correcto.
-- **Dependencias**: Tarea 2 completada.
-
----
-
-## 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
-- ¿Qué se pide exactamente?
-- ¿Hay ambigüedades o dependencias?
-
-### Opciones consideradas
-- **Opción A**: (descripción)
-- **Opción B**: (descripción)
-- *(añadir más si aplica)*
-
-### Decisión tomada
-- Opción elegida: (A/B/...)
-- Justificación: (por qué esta opción)
-
----
-
-## Output (REQUIRED)
-- **Entregables**:
-  - `agentic-workflow/src/cli/index.ts`
-  - `agentic-workflow/src/cli/commands/init.ts`
-  - `agentic-workflow/bin/cli.js` (entrypoint ejecutable)
-- **Evidencia requerida**:
-  - Código fuente del CLI.
-  - Prueba de compilación exitosa (`dist/` generado).
-
----
-
-## Execution
-
-```yaml
-execution:
-  agent: "architect-agent"
-  status: pending
-  started_at: null
-  completed_at: null
-```
-
----
-
-## Implementation Report
-
-> Esta sección la completa el agente asignado durante la ejecución.
-
-### Cambios realizados
-- (Archivos modificados, funciones añadidas, etc.)
-
-### Decisiones técnicas
-- (Decisiones clave y justificación)
-
-### Evidencia
-- (Logs, capturas, tests ejecutados)
-
-### Desviaciones del objetivo
-- (Si las hay, justificación)
-
----
-
-## Gate (REQUIRED)
-
-El desarrollador **DEBE** aprobar esta tarea antes de que el arquitecto asigne la siguiente.
-
-```yaml
-approval:
-  developer:
-    decision: SI
-    date: 2026-01-19T22:36:51+01:00
-    comments: Aprobado por consola.
-```
-
----
-
-## 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/artifacts/26-portable-agentic-system/agent-tasks/4-architect-linking-and-verification.md

@@ -1,104 +0,0 @@
----
-artifact: agent_task
-phase: phase-4-implementation
-owner: architect-agent
-status: pending
-related_task: 26-portable-agentic-system
-task_number: 4
----
-
-# Agent Task — 4-architect-linking-and-verification
-
-## Input (REQUIRED)
-- **Objetivo**: Implementar lógica de resolución de paths (linking) y crear una demo de verificación.
-- **Alcance**: 
-  - Validar que los workflows copiados usan rutas relativas o aliases correctamente.
-  - Implementar `AgentPathResolver` real en `src/core/index.ts` (si es necesario para runtime, aunque los agentes leen markdown directamente).
-  - **Prueba manual**: Crear una carpeta temporal `test-project`, instalar el paquete (link local), ejecutar `init` y verificar que la estructura generada es válida.
-- **Dependencias**: Tarea 3 completada.
-
----
-
-## 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
-- ¿Qué se pide exactamente?
-- ¿Hay ambigüedades o dependencias?
-
-### Opciones consideradas
-- **Opción A**: (descripción)
-- **Opción B**: (descripción)
-- *(añadir más si aplica)*
-
-### Decisión tomada
-- Opción elegida: (A/B/...)
-- Justificación: (por qué esta opción)
-
----
-
-## Output (REQUIRED)
-- **Entregables**:
-  - Evidencia de ejecución de `npm link` y `agentic-workflow init` en carpeta de prueba.
-  - Ajustes finales en `src/` si se detectan rutas rotas.
-- **Evidencia requerida**:
-  - Captura (log) de la sesión de testing manual.
-
----
-
-## Execution
-
-```yaml
-execution:
-  agent: "architect-agent"
-  status: pending
-  started_at: null
-  completed_at: null
-```
-
----
-
-## Implementation Report
-
-> Esta sección la completa el agente asignado durante la ejecución.
-
-### Cambios realizados
-- (Archivos modificados, funciones añadidas, etc.)
-
-### Decisiones técnicas
-- (Decisiones clave y justificación)
-
-### Evidencia
-- (Logs, capturas, tests ejecutados)
-
-### Desviaciones del objetivo
-- (Si las hay, justificación)
-
----
-
-## Gate (REQUIRED)
-
-El desarrollador **DEBE** aprobar esta tarea antes de que el arquitecto asigne la siguiente.
-
-```yaml
-approval:
-  developer:
-    decision: SI
-    date: 2026-01-19T22:47:57+01:00
-    comments: Demostración exitosa en test-project.
-
-```
-
----
-
-## 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/artifacts/26-portable-agentic-system/analysis.md

@@ -1,117 +0,0 @@
----
-artifact: analysis
-phase: phase-2-analysis
-owner: architect-agent
-status: draft
-related_task: 26-portable-agentic-system
----
-
-# Analysis — 26-Portable Agentic System
-
-## 1. Resumen ejecutivo
-**Problema**
-El sistema agéntico actual reside dentro del repositorio `extensio`, acoplado a su estructura y reglas específicas. Esto impide reutilizar la potente orquestación en otros proyectos sin copiar y pegar código, lo que es ineficiente y propenso a errores.
-
-**Objetivo**
-Desacoplar el núcleo del sistema, empaquetarlo como `@cmarino/agentic-workflow` y permitir su distribución vía npm, habilitando cualquier proyecto como "Agentic Workspace" mediante un comando de inicialización estándar.
-
-**Criterio de éxito**
-- Paquete npm creado y funcional.
-- Comando `npm init` o CLI global que andamie la estructura `.agent`.
-- Separación clara entre workflows inmutables (core) y personalización local (proyecto).
-- Independencia total del framework Extensio.
-
----
-
-## 2. Estado del proyecto (As-Is)
-- **Estructura relevante**: Todo el sistema reside en `.agent/`, mezclando lógica core (workflows, templates) con lógica de negocio (reglas de Extensio).
-- **Core / Engine**: No existe separación física. Los workflows importan reglas específicas de Extensio.
-- **Artifacts**: Los templates actuales tienen referencias directas a `extensio-architecture`.
-- **Limitaciones**: La portabilidad es nula. Cualquier intento de extracción manual requiere refactorización masiva de rutas y referencias.
-
----
-
-## 3. Cobertura de Acceptance Criteria
-
-### Package Creation (@cmarino/agentic-workflow)
-- **Interpretación**: Crear un monorepo o paquete aislado para el sistema.
-- **Verificación**: Existencia de `package.json` publicado (o linkeado) con `bin` entry.
-- **Riesgos**: Naming conflicts en npm.
-
-### Core Decoupling
-- **Interpretación**: Identificar qué reglas son "Core" (constitucional, roles base) y cuáles son "Proyecto" (drivers, modules).
-- **Verificación**: El paquete no debe contener ninguna cadena "extensio".
-- **Riesgos**: Perder reglas de limpieza de código o arquitectura si no se generalizan correctamente.
-
-### CLI Implementation
-- **Interpretación**: Usar `commander` o `@clack/prompts` para generar `.agent/` interactivamente.
-- **Verificación**: Ejecutar `npx @cmarino/agentic-workflow init` en carpeta vacía.
-- **Riesgos**: Complejidad en la gestión de templates (copia de archivos vs symlinks).
-
----
-
-## 4. Research técnico
-Basado en `research.md`.
-
-- **Enfoque recomendado**: **Hybrid Package**.
-  - **Paquete npm**: Contiene el motor de workflows, templates base y CLI.
-  - **Proyecto local**: Contiene `.agent/rules/` específicas y un `agent.config.js` opcional.
-  - **Ventaja**: Mantiene el core actualizable centralmente mientras permite flexibilidad total.
-
----
-
-## 5. Agentes participantes
-- **architect-agent**
-  - Responsable del diseño de la estructura del paquete y refactorización de reglas.
-  - Subáreas: `rules`, `workflows`.
-- **tooling-agent** (Nuevo rol recomendado o asumido por architect)
-  - Responsable de la implementación del CLI y scripts de build.
-  - Subáreas: `cli`, `package.json`.
-
-**Componentes necesarios**
-- **NUEVO**: Paquete `@cmarino/agentic-workflow` (fuera de `extensio` o en `packages/` si fuera monorepo, pero aquí se extraerá).
-- **MODIFICAR**: Todos los workflows existentes para eliminar dependencias de Extensio.
-
----
-
-## 6. Impacto de la tarea
-- **Arquitectura**: Cambio radical. De sistema embebido a dependencia externa.
-- **Compatibilidad**: Breaking changes masivos para el repo host actual (`extensio`). Requerirá migración (dogfooding) una vez el paquete esté listo.
-- **Testing**: Necesidad de tests de integración para el CLI (ejecutar en sandbox).
-
----
-
-## 7. Riesgos y mitigaciones
-- **Riesgo**: Referencias circulares o rotas durante la extracción.
-  - **Mitigación**: Crear un repo/paquete limpio y migrar fichero a fichero validando referencias.
-- **Riesgo**: El sistema actual de Extensio se rompa durante la migración.
-  - **Mitigación**: Desarrollar el paquete en paralelo (carpeta separada o repo temporal) y no sustituir el `.agent` actual hasta validar la versión portable.
-
----
-
-## 8. Preguntas abiertas
-Ninguna. Research cubrió las dudas técnicas.
-
----
-
-## 9. TODO Backlog (Consulta obligatoria)
-**Referencia**: `.agent/todo/`
-**Estado actual**: 5 items pendientes.
-**Items relevantes**:
-- `004-portable-agentic-system.md`: Es exactamente esta tarea.
-- `003-explorar-paralelizacion-phase4.md`: Podría ser interesante incorporar capacidad de paralelización en el nuevo core desde el inicio.
-
-**Impacto**: Se cierra el TODO 004 con esta tarea.
-
----
-
-## 10. Aprobación
-Este análisis **requiere aprobación explícita del desarrollador**.
-
-```yaml
-approval:
-  developer:
-    decision: SI
-    date: 2026-01-19T21:25:29+01:00
-    comments: Aprobado por consola.
-```

package/dist/artifacts/26-portable-agentic-system/architect/review.md

@@ -1,41 +0,0 @@
----
-artifact: review
-phase: phase-4-implementation
-owner: architect-agent
-status: approved
-related_task: 26-portable-agentic-system
----
-
-# Architectural Review — Phase 4
-
-## Resumen de Implementación
-Se ha completado la implementación del sistema agéntico portable `@cmarino/agentic-workflow`.
-
-### Tareas ejecutadas
-1. **Scaffolding**: ✅ Estructura de paquete válida.
-2. **Core Migration**: ✅ Reglas y workflows migrados y desacoplados de Extensio.
-3. **CLI Implementation**: ✅ Herramienta `init` funcional con copia de assets.
-4. **Linking & Verification**: ✅ Validación end-to-end en proyecto externo.
-
-### Cumplimiento del Plan
-- Todos los pasos del plan original se han ejecutado.
-- Se ha ido más allá en la limpieza arquitectónica (`project-architecture`).
-
-### Riesgos y Deuda Técnica
-- **Riesgo**: Los paths relativos dentro de los workflows (`.agent/...`) asumen una estructura fija. Si el usuario mueve carpetas, se romperá. (Mitigado por el estándar estricto de `.agent/`).
-- **Deuda**: Faltan tests unitarios automatizados para el CLI (actualmente validación manual).
-
-### Conclusión
-El sistema es estable y cumple los objetivos de portabilidad. Está listo para ser publicado o usado internamente.
-
----
-
-## Final Approval Gate
-
-```yaml
-final_approval:
-  developer:
-    decision: SI
-    date: 2026-01-19T22:47:57+01:00
-    comments: Validado con prueba de fuego en test-project.
-```