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

package/dist/artifacts/7-modules-globals-constants/plan.md

@@ -1,276 +0,0 @@
----
-artifact: plan
-phase: phase-3-planning
-owner: architect-agent
-status: draft
-related_task: 7-modules-globals-constants
----
-
-# Implementation Plan — 7-modules-globals-constants
-
-## 1. Resumen del plan
-
-**Contexto:**  
-Unificar namespace global a `Extensio` para drivers y módulos, documentar patrón de globals/constants en `constitution.modules`, y añadir verificación en workflows.
-
-**Resultado esperado:**
-- Namespace `Extensio` unificado en `global.d.mts`
-- `constitution.modules` con secciones de globals/constants (equivalentes a drivers)
-- Workflows de módulos con pasos de verificación
-- CLI actualizado para generar con namespace `Extensio`
-- Módulo de test con demo funcionando
-
-**Alcance:**
-- ✅ Incluye: Migración de namespace, documentación de patrón, verificación en workflows, CLI, módulo de test
-- ❌ Excluye: Migración de código existente que use `Extension.*` (no existe actualmente)
-
----
-
-## 2. Inputs contractuales
-
-- **Task**: `.agent/artifacts/7-modules-globals-constants/task.md`
-- **Analysis**: `.agent/artifacts/7-modules-globals-constants/analysis.md`
-- **Acceptance Criteria**: AC-1 a AC-5 (ver task.md)
-
-**Dispatch de dominios**
-```yaml
-plan:
-  workflows:
-    modules:
-      action: verify
-      workflow: workflow.modules.create
-
-  dispatch:
-    - domain: modules
-      action: create
-      workflow: workflow.modules.create
-```
-
----
-
-## 3. Desglose de implementación (pasos)
-
-### Paso 1: Migrar namespace en `global.d.mts`
-- **Descripción:** Cambiar `namespace Extension` → `namespace Extensio` en `global.d.mts`
-- **Dependencias:** Ninguna
-- **Entregables:** `global.d.mts` actualizado
-- **Agente responsable:** architect-agent
-
-### Paso 2: Actualizar `constitution.modules`
-- **Descripción:** Añadir secciones equivalentes a drivers:
-  - Sección sobre `types.d.mts` y registro en globals
-  - Sección sobre `constants.mts` y extensión del root
-  - Ejemplos con namespace `Extensio`
-- **Dependencias:** Paso 1
-- **Entregables:** `constitution.modules` actualizado
-- **Agente responsable:** architect-agent
-
-### Paso 3: Actualizar `constitution.drivers`
-- **Descripción:** Actualizar ejemplos de namespace `Extension` → `Extensio`
-- **Dependencias:** Paso 1
-- **Entregables:** `constitution.drivers` actualizado
-- **Agente responsable:** architect-agent
-
-### Paso 4: Actualizar workflows de módulos
-- **Descripción:** Añadir pasos de verificación en:
-  - `workflows/modules/create.md`
-  - `workflows/modules/refactor.md`
-  - `workflows/modules/delete.md`
-- **Dependencias:** Paso 2
-- **Entregables:** Workflows actualizados
-- **Agente responsable:** architect-agent
-
-### Paso 5: Actualizar template `module-create.md`
-- **Descripción:** Añadir checklist de verificación de globals/constants
-- **Dependencias:** Paso 4
-- **Entregables:** Template actualizado
-- **Agente responsable:** architect-agent
-
-### Paso 6: Actualizar generador de módulos en CLI
-- **Descripción:** Cambiar namespace `Extension` → `Extensio` en `_extendGlobalTypes()`
-- **Dependencias:** Paso 1
-- **Entregables:** `cli/src/generators/module/index.mts` actualizado
-- **Agente responsable:** module-agent
-- **Tool:** Edición manual (no hay tool específico para esto)
-
-### Paso 7: Verificar generador de drivers en CLI
-- **Descripción:** Verificar si usa `Extension` y cambiar a `Extensio` si aplica
-- **Dependencias:** Paso 1
-- **Entregables:** `cli/src/generators/driver/index.mts` actualizado (si aplica)
-- **Agente responsable:** driver-agent
-
-### Paso 8: Crear módulo de test con demo
-- **Descripción:** Crear módulo de test para verificar funcionamiento
-- **Dependencias:** Pasos 1-7
-- **Entregables:** Módulo `test-globals` en `packages/modules/`
-- **Agente responsable:** module-agent
-- **Tool:** `mcp_extensio-cli extensio_create` con `--type module --name test-globals --includeDemo`
-
-### Paso 9: Verificar build del proyecto
-- **Descripción:** Ejecutar build completo para validar cambios
-- **Dependencias:** Paso 8
-- **Entregables:** Build exitoso sin errores de tipos
-- **Agente responsable:** qa-agent
-- **Tool:** `mcp_extensio-cli extensio_build`
-
----
-
-## 4. Asignación de responsabilidades (Agentes)
-
-### architect-agent
-- Responsabilidades:
-  - Migrar namespace en `global.d.mts`
-  - Actualizar constitutions (modules, drivers)
-  - Actualizar workflows de módulos
-  - Actualizar template de creación
-  - Validar coherencia arquitectónica
-
-### module-agent
-- Responsabilidades:
-  - Actualizar generador de módulos en CLI
-  - Crear módulo de test con demo
-
-### driver-agent
-- Responsabilidades:
-  - Verificar/actualizar generador de drivers en CLI
-
-### qa-agent
-- Responsabilidades:
-  - Verificar build del proyecto
-  - Ejecutar tests
-
-**Handoffs:**
-1. architect-agent → module-agent: Constitutions y workflows listos
-2. module-agent → qa-agent: Módulo de test creado
-3. qa-agent → architect-agent: Resultados de verificación
-
-**Componentes:**
-
-| Componente | Responsable | Cómo | Tool |
-|------------|-------------|------|------|
-| `global.d.mts` | architect-agent | Edición directa | N/A |
-| `constitution.modules` | architect-agent | Edición directa | N/A |
-| `constitution.drivers` | architect-agent | Edición directa | N/A |
-| `workflows/modules/*.md` | architect-agent | Edición directa | N/A |
-| `templates/module-create.md` | architect-agent | Edición directa | N/A |
-| `cli/generators/module/index.mts` | module-agent | Edición directa | N/A |
-| `cli/generators/driver/index.mts` | driver-agent | Edición directa | N/A |
-| Módulo de test | module-agent | CLI | `mcp_extensio-cli extensio_create` |
-
-**Demo:**
-- Estructura: Módulo con demo siguiendo `constitution.extensio_architecture`
-- Tool: `mcp_extensio-cli extensio_demo` si el módulo ya existe, o incluir con `--includeDemo`
-
----
-
-## 5. Estrategia de testing y validación
-
-### Build validation
-- **Comando:** `npm run build` (desde root)
-- **Criterio:** Sin errores de TypeScript
-
-### Verificación de namespace
-- **Manual:** Revisar que `global.d.mts` use `namespace Extensio`
-- **Manual:** Revisar que CLI genere con `Extensio`
-
-### Módulo de test
-- **Comando:** `mcp_extensio-cli extensio_build --browsers chrome`
-- **Criterio:** Build exitoso del módulo de test
-
-### Trazabilidad
-
-| AC | Verificación |
-|----|--------------|
-| AC-1 | Confirmar que no hay módulos existentes |
-| AC-2 | Verificar namespace `Extensio` en `global.d.mts` y CLI |
-| AC-3 | Verificar que solo tipos públicos se exportan |
-| AC-4 | Revisar workflows actualizados |
-| AC-5 | Crear módulo de test y verificar funcionamiento |
-
----
-
-## 6. Plan de demo
-
-**Objetivo:** Demostrar que el patrón de globals/constants funciona para módulos
-
-**Escenario:**
-1. Crear módulo `test-globals` con demo usando CLI
-2. Verificar que `global.d.mts` se extiende con `Extensio.TestGlobals`
-3. Verificar que `constants.mts` se extiende correctamente
-4. Build exitoso del módulo y demo
-
-**Criterios de éxito:**
-- Módulo creado sin errores
-- Namespace correcto en globals
-- Build exitoso
-
----
-
-## 7. Estimaciones y pesos de implementación
-
-| Paso | Esfuerzo | Complejidad |
-|------|----------|-------------|
-| Paso 1: Migrar namespace | Bajo | Baja |
-| Paso 2: Actualizar constitution.modules | Medio | Media |
-| Paso 3: Actualizar constitution.drivers | Bajo | Baja |
-| Paso 4: Actualizar workflows | Medio | Media |
-| Paso 5: Actualizar template | Bajo | Baja |
-| Paso 6: Actualizar CLI módulos | Bajo | Baja |
-| Paso 7: Verificar CLI drivers | Bajo | Baja |
-| Paso 8: Crear módulo de test | Bajo | Baja |
-| Paso 9: Verificar build | Bajo | Baja |
-
-**Estimación total:** ~30-45 minutos de implementación
-
----
-
-## 8. Puntos críticos y resolución
-
-### Punto crítico 1: Breaking change en código existente
-- **Riesgo:** Código que use `Extension.*` fallará
-- **Impacto:** Alto si existe código dependiente
-- **Resolución:** Verificado que no existe código usando `Extension.*` en packages
-
-### Punto crítico 2: CLI no genera correctamente
-- **Riesgo:** Módulo de test no se crea con namespace correcto
-- **Impacto:** Medio
-- **Resolución:** Actualizar CLI antes de crear módulo de test
-
----
-
-## 9. Dependencias y compatibilidad
-
-**Dependencias internas:**
-- `@extensio/cli` (generadores)
-- `global.d.mts` y `constants.mts` (root)
-
-**Dependencias externas:**
-- Ninguna
-
-**Compatibilidad entre navegadores:**
-- No aplica (cambios en sistema de tipos, no runtime)
-
----
-
-## 10. Criterios de finalización
-
-- [ ] `global.d.mts` usa namespace `Extensio`
-- [ ] `constitution.modules` incluye secciones de globals/constants
-- [ ] `constitution.drivers` usa ejemplos con `Extensio`
-- [ ] Workflows de módulos incluyen verificación de globals/constants
-- [ ] Template `module-create.md` incluye checklist
-- [ ] CLI genera módulos con namespace `Extensio`
-- [ ] Módulo de test creado y funcionando
-- [ ] Build del proyecto exitoso
-
----
-
-## 11. Aprobación del desarrollador (OBLIGATORIA)
-
-```yaml
-approval:
-  developer:
-    decision: SI
-    date: 2026-01-07T21:02:25+01:00
-    comments: ""
-```

package/dist/artifacts/7-modules-globals-constants/researcher/research.md

@@ -1,247 +0,0 @@
----
-artifact: research
-phase: phase-1-research
-owner: researcher-agent
-status: draft
-related_task: 7-modules-globals-constants
----
-
-# Research Report — 7-modules-globals-constants
-
-## 1. Resumen ejecutivo
-
-**Problema investigado:**  
-Los módulos de Extensio no tienen definidas reglas para extender los archivos globales `global.d.mts` y `constants.mts`, a diferencia de los drivers que sí tienen un contrato claro.
-
-**Objetivo:**  
-Aplicar el mismo patrón de integración de tipos y constantes que utilizan los drivers a los módulos, usando el namespace `Extensio.<ModuleName>.<types>`.
-
-**Principales hallazgos:**
-1. El patrón de drivers está bien documentado en `constitution.drivers` (secciones 2.3 y 2.4)
-2. Los archivos globales ya existen y funcionan: `global.d.mts` y `constants.mts` en root
-3. El namespace actual para drivers es `Extension.<DriverName>` (no `Extensio`)
-4. Los workflows de módulos existen pero carecen de pasos de verificación de globals/constants
-5. El MCP CLI tiene soporte para crear módulos pero requiere verificación
-
----
-
-## 2. Necesidades detectadas
-
-### Requisitos técnicos identificados:
-1. **Actualizar `constitution.modules`** con secciones equivalentes a drivers para globals y constants
-2. **Definir namespace para módulos**: `Extensio.<ModuleName>` (diferenciado de `Extension` de drivers)
-3. **Actualizar workflows de módulos** (`create.md`, `refactor.md`, `delete.md`) con verificación obligatoria
-4. **Actualizar template `module-create.md`** para incluir checklist de globals/constants
-5. **Verificar MCP CLI** para que genere estructura correcta
-
-### Suposiciones:
-- No existen módulos implementados actualmente (confirmado por el desarrollador)
-- Solo tipos "públicos" deben registrarse en globals (decisión del desarrollador)
-- El formato del namespace debe ser PascalCase igual que drivers
-
-### Límites:
-- Esta tarea NO implementa código de módulos, solo actualiza contratos y workflows
-- La verificación se hará mediante un módulo de test (no producción)
-
----
-
-## 3. Alternativas técnicas
-
-### Alternativa A: Namespace unificado `Extension`
-**Descripción:** Usar el mismo namespace `Extension` para drivers y módulos.
-
-| Aspecto | Evaluación |
-|---------|------------|
-| Pros | Simplicidad, un solo namespace global |
-| Contras | Sin distinción clara entre drivers y módulos |
-| Riesgo | Colisiones de nombres si un driver y módulo tienen el mismo nombre |
-| Impacto | Bajo impacto, reutiliza estructura existente |
-
-### Alternativa B: Namespace separado `Extensio` ✅ RECOMENDADA
-**Descripción:** Usar namespace `Extensio.<ModuleName>` separado para módulos.
-
-| Aspecto | Evaluación |
-|---------|------------|
-| Pros | Distinción clara, sin riesgo de colisiones |
-| Contras | Dos namespaces a mantener |
-| Riesgo | Bajo |
-| Impacto | Requiere documentar convención claramente |
-
-> **Recomendación:** El desarrollador ya especificó `Extensio.<ModuleName>` como namespace objetivo.
-
-### Alternativa C: No extender globals para módulos
-**Descripción:** Mantener tipos de módulos solo en sus archivos locales.
-
-| Aspecto | Evaluación |
-|---------|------------|
-| Pros | Menor complejidad |
-| Contras | Módulos no pueden exportar tipos públicamente |
-| Riesgo | Limita interoperabilidad entre módulos |
-| Impacto | Contradice el objetivo del desarrollador |
-
----
-
-## 4. APIs Web / WebExtensions relevantes
-
-Esta tarea no involucra APIs del navegador directamente. Es una actualización de contratos y workflows del sistema agéntico.
-
-| Componente | Estado |
-|------------|--------|
-| TypeScript namespaces | Estable, bien soportado |
-| TypeScript `declare global` | Estable, patrón actual en uso |
-| ESM exports/imports | Estable, patrón actual en uso |
-
----
-
-## 5. Compatibilidad multi-browser
-
-No aplica para esta tarea. Los cambios son a nivel de sistema de tipos y contratos de desarrollo, no afectan runtime del navegador.
-
----
-
-## 6. Recomendaciones AI-first
-
-### Oportunidades para agentes/automatización:
-
-1. **Verificación automática en workflows:**  
-   Los workflows de módulos deben incluir pasos que validen automáticamente que `global.d.mts` y `constants.mts` están actualizados correctamente.
-
-2. **Generación via MCP CLI:**  
-   El comando `extensio_create module` debe generar la estructura completa incluyendo:
-   - `types.d.mts` con tipos públicos marcados
-   - `constants.mts` con constantes exportables
-   - Snippet para añadir al `global.d.mts` root
-   - Snippet para añadir al `constants.mts` root
-
-3. **Checklist automatizada:**  
-   El template `module-create.md` debe incluir un checklist verificable por el agente.
-
-### Impacto esperado:
-- Reducción de errores en integración de módulos
-- Consistencia con el contrato de drivers
-- Trazabilidad completa de tipos públicos
-
----
-
-## 7. Riesgos y trade-offs
-
-| Riesgo | Severidad | Mitigación |
-|--------|-----------|------------|
-| Inconsistencia de namespace entre documentos | Media | Actualizar todos los documentos afectados en la misma tarea |
-| MCP CLI no soporta generación de globals | Baja | Verificar y actualizar si es necesario |
-| Módulo de test incompleto | Media | Crear módulo minimal pero funcional |
-| Conflicto con arquitectura existente | Baja | Los módulos no existen aún, no hay legacy |
-
----
-
-## 8. Fuentes
-
-- [constitution.drivers](/Users/milos/Documents/workspace/extensio/.agent/rules/constitution/drivers.md) — Secciones 2.3 y 2.4
-- [constitution.modules](/Users/milos/Documents/workspace/extensio/.agent/rules/constitution/modules.md) — Sección 3
-- [global.d.mts](/Users/milos/Documents/workspace/extensio/global.d.mts) — Estructura actual de drivers
-- [constants.mts](/Users/milos/Documents/workspace/extensio/constants.mts) — Estructura actual de drivers
-- [workflow modules/create.md](/Users/milos/Documents/workspace/extensio/.agent/workflows/modules/create.md)
-- [template module-create.md](/Users/milos/Documents/workspace/extensio/.agent/templates/module-create.md)
-
----
-
-## 9. Demos de módulos — Análisis de estructura
-
-### 9.1 Alias `__PARENT_SRC__` (no `__PARENT_PATH__`)
-
-El alias correcto para referenciar el código fuente del módulo padre desde una demo es:
-
-```json
-"paths": {
-  "__PARENT_SRC__/*": ["../src/*"]
-}
-```
-
-**Ubicación:** Se configura en el `tsconfig.json` de la demo.
-
-**Uso en código:**
-```typescript
-export * from '__PARENT_SRC__/engine/index.mts';
-export * from '__PARENT_SRC__/surface/pages/index.mts';
-export * from '__PARENT_SRC__/surface/shards/index.mts';
-```
-
-### 9.2 Estructura de demos de módulos
-
-El CLI (`demo.mts` y `generators/module/index.mts`) genera demos con esta estructura:
-
-```
-module-name/
-├── src/                    # Código fuente del módulo
-│   ├── engine/
-│   ├── surface/
-│   │   ├── pages/
-│   │   └── shards/
-│   ├── types.d.mts
-│   └── constants.mts
-└── demo/                   # Demo del módulo
-    ├── src/
-    │   ├── engine/         # Re-exporta desde __PARENT_SRC__
-    │   ├── surface/
-    │   │   ├── pages/      # Re-exporta desde __PARENT_SRC__
-    │   │   └── shards/     # Re-exporta desde __PARENT_SRC__
-    │   ├── types.d.mts     # Tipos propios de la demo
-    │   └── manifest.json
-    ├── images/
-    ├── test/e2e/
-    ├── tsconfig.json       # Incluye paths con __PARENT_SRC__
-    └── package.json
-```
-
-### 9.3 Hallazgos clave del generador
-
-Analizando `generators/module/index.mts`:
-
-1. **Extensión automática de globals:** El método `_extendGlobalTypes()` ya extiende `global.d.mts` automáticamente al crear un módulo.
-2. **Extensión automática de constants:** El método `_extendRootConstants()` ya extiende `constants.mts` root automáticamente.
-3. **Namespace usado:** Actualmente usa namespace `Extension` (no `Extensio`), ejemplo:
-   ```typescript
-   namespace Extension {
-     namespace ModuleName {
-       export type SomeType = SomeType;
-     }
-   }
-   ```
-
-### 9.4 Decisión del desarrollador
-
-> [!IMPORTANT]
-> **Decisión:** Unificar namespace a `Extensio` para **drivers y módulos**.
-> 
-> Esto implica que `Extension` actual debe migrarse a `Extensio` en:
-> - `global.d.mts` (root)
-> - Generador de drivers (`generators/driver/index.mts`)
-> - Generador de módulos (`generators/module/index.mts`)
-> - Documentación y constitutions
-
-**Impacto adicional:**
-- Cambio breaking en tipos globales existentes
-- Requiere actualizar imports en código que use `Extension.*`
-
-### 9.5 Recomendación
-
-Dado que:
-- El CLI ya implementa extensión de globals/constants para módulos
-- La estructura de demos está correctamente definida
-- El alias `__PARENT_SRC__` funciona correctamente
-
-**Acción sugerida:**
-1. Si se desea namespace `Extensio`, actualizar `_extendGlobalTypes()` en el generador
-2. Documentar el patrón en `constitution.modules`
-3. Añadir verificación en workflows de módulos
-
----
-
-## 10. Aprobación del desarrollador (OBLIGATORIA)
-```yaml
-approval:
-  developer:
-    decision: SI
-    date: 2026-01-07T20:55:08+01:00
-    comments: "Unificar namespace a Extensio para drivers y módulos"
-```

package/dist/artifacts/7-modules-globals-constants/task.md

@@ -1,112 +0,0 @@
-# Task: Modules Globals & Constants
-
-## Identificación
-- id: 7
-- title: modules-globals-constants
-- scope: current
-- owner: architect-agent
-
-## Origen
-- created_from:
-  - workflow: tasklifecycle
-  - source: init
-  - candidate_path: artifacts.candidate.task
-
-## Descripción de la tarea
-Aplicar a los módulos la misma norma que tienen los drivers para extender `globals.d.mts` y `constants.mts`, verificando su contenido cuando se crea, modifica o elimina un módulo.
-
-## Objetivo
-Los módulos deben extender el namespace `Extensio.<ModuleName>.<types>` en los archivos globales del proyecto, siguiendo el mismo patrón establecido para drivers.
-
-## Estado del ciclo de vida (FUENTE ÚNICA DE VERDAD)
-
-```yaml
-task:
-  id: "7"
-  title: "modules-globals-constants"
-  phase:
-    current: "phase-8-commit-push"
-    validated_by: "architect-agent"
-    updated_at: "2026-01-07T21:18:31+01:00"
-  lifecycle:
-    phases:
-      phase-0-acceptance-criteria:
-        completed: true
-        validated_by: architect-agent
-        validated_at: "2026-01-07T20:45:47+01:00"
-      phase-1-research:
-        completed: true
-        validated_by: architect-agent
-        validated_at: "2026-01-07T20:55:08+01:00"
-      phase-2-analysis:
-        completed: true
-        validated_by: architect-agent
-        validated_at: "2026-01-07T20:58:48+01:00"
-      phase-3-planning:
-        completed: true
-        validated_by: architect-agent
-        validated_at: "2026-01-07T21:02:25+01:00"
-      phase-4-implementation:
-        completed: true
-        validated_by: architect-agent
-        validated_at: "2026-01-07T21:15:00+01:00"
-      phase-5-verification:
-        completed: true
-        validated_by: qa-agent
-        validated_at: "2026-01-07T21:18:00+01:00"
-      phase-6-results-acceptance:
-        completed: true
-        validated_by: developer
-        validated_at: "2026-01-07T21:16:47+01:00"
-      phase-7-evaluation:
-        completed: true
-        validated_by: developer
-        validated_at: "2026-01-07T21:18:31+01:00"
-      phase-8-commit-push:
-        completed: true
-        validated_by: developer
-        validated_at: "2026-01-07T21:20:16+01:00"
-```
-
-## Acceptance Criteria (verificables)
-
-### 1. Alcance
-- [ ] Solo aplica a módulos futuros (no existen módulos actualmente)
-- [ ] Las normas se documentan en `constitution.modules`
-
-### 2. Namespace
-- [ ] Formato PascalCase: `Extensio.<ModuleName>` (mismo que drivers)
-- [ ] Tipos públicos registrados bajo `Extensio.<ModuleName>.<TypeName>`
-
-### 3. Tipos públicos
-- [ ] Solo tipos marcados como "públicos" se registran en `globals.d.mts`
-- [ ] Tipos internos permanecen en `types.d.mts` del módulo
-
-### 4. Verificación automatizada
-- [ ] Workflow de creación/modificación incluye validación de `globals.d.mts`
-- [ ] Workflow de creación/modificación incluye validación de `constants.mts`
-
-### 5. Integración MCP CLI
-- [ ] Comando `extensio_create` genera estructura correcta para módulos
-- [ ] Validar funcionamiento mediante creación de módulo de test
-
-## Criterio de Done
-- [ ] `constitution.modules` actualizada con secciones equivalentes a drivers (2.3, 2.4)
-- [ ] Workflows de módulos actualizados con verificación de globals/constants
-- [ ] MCP CLI actualizado si es necesario
-- [ ] Módulo de test creado y validado
-
-## Historial de validaciones (append-only)
-```yaml
-history:
-  - phase: "phase-0-acceptance-criteria"
-    action: "completed"
-    validated_by: "architect-agent"
-    timestamp: "2026-01-07T20:45:47+01:00"
-    notes: "5 preguntas respondidas. Acceptance criteria definidos."
-  - phase: "phase-2-analysis"
-    action: "completed"
-    validated_by: "architect-agent"
-    timestamp: "2026-01-07T20:58:48+01:00"
-    notes: "Análisis aprobado. Alcance: 10 componentes, documentación de patrón y verificación en workflows."
-```