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

package/dist/workflows/modules/create.md

@@ -1,160 +0,0 @@
----
-description: Workflow para crear módulos siguiendo la constitución y reglas de arquitectura del ecosistema Extensio.
----
-
----
-id: workflow.modules.create
-owner: module-agent
-version: 2.0.0
-severity: PERMANENT
-trigger:
-  commands: ["module-create", "modules:create"]
-blocking: true
----
-
-# WORKFLOW: modules.create
-
-## Input (REQUIRED)
-- El arquitecto ha determinado en el plan la creación de un nuevo módulo:
-  - `.agent/artifacts/<taskId>-<taskTitle>/plan.md`
-
-## Output (REQUIRED)
-- Informe de creación de módulo (OBLIGATORIO):
-  - `.agent/artifacts/<taskId>-<taskTitle>/module/create.md`
-
-## Objetivo (ONLY)
-Asegurar que la creación de un nuevo módulo cumple:
-- la constitución de módulos (`constitution.modules`)
-- la constitución de pages (`constitution.pages`) si aplica
-- la constitución de shards (`constitution.shards`) si aplica
-- la arquitectura de Extensio y reglas globales
-- la integración correcta en el ecosistema
-
-> Esta fase **NO** omite auditoría del architect-agent.
-
-## Template (OBLIGATORIO)
-- El informe **DEBE** crearse usando el template:
-  - `templates.module_create`
-- Si el template no existe o no se puede cargar → **FAIL**.
-
----
-
-## Pasos obligatorios
-
-0. Activar `module-agent` y usar prefijo obligatorio en cada mensaje.
-
-1. Verificar inputs
-   - Existe `plan.md` que requiere crear un módulo.
-   - Si falla → ir a **Paso 9 (FAIL)**.
-
-2. Crear el módulo (module-agent)
-   - El **module-agent** usa su skill `extensio_create_module`:
-     - Leer `.agent/skills/extensio-create-module/SKILL.md`
-     - Ejecutar MCP tool `mcp_extensio-cli_extensio_create` con:
-       - `type: "module"`
-       - `name`: nombre del módulo
-       - `withShards`: según necesidades de UI
-       - `withPages`: según necesidades de páginas
-       - `includeDemo`: true (default)
-   - La creación manual **solo** es válida si el CLI no soporta la operación.
-   - Garantizar estructura, types, constants, globals y ciclo de vida.
-
-3. Verificar estructura base (OBLIGATORIO)
-   - Verificar que `global.d.mts` contiene el namespace `Extensio.<NombreModulo>`.
-   - Verificar que `constants.mts` root exporta las constantes del módulo.
-   - Verificar que `demo/` existe y es funcional.
-   - Validar scopes (Engine obligatorio).
-   - Verificar reactividad y `waitingLoadProps` donde aplique.
-   - Si falta algo → corregir antes de continuar.
-
-4. Verificar Surfaces (si aplica)
-   
-   **Si el módulo tiene Pages:**
-   - Verificar que existe `src/surface/pages/index.mts` con imports de HTML.
-   - Verificar estructura: `<page-name>/index.html` + `<page-name>/index.mts`
-   - Verificar ciclo de vida: `run()` → `listen()` → `start()`
-   - Verificar responsabilidades (§11-12 de `constitution.pages`):
-     - Solo lógica de presentación
-     - Solo lógica de interacción
-     - Solo orquestación de Shards
-     - NO estado persistente de negocio
-   
-   **Si el módulo tiene Shards:**
-   - Verificar que existe `src/surface/shards/index.mts` con `Shard.register()`.
-   - Verificar que cada Shard tiene `getTagName()` único.
-   - Verificar cumplimiento de `constitution.shards`.
-
-5. Crear informe de creación
-   - Crear:
-     - `.agent/artifacts/<taskId>-<taskTitle>/module/create.md`
-   - Completar el informe según el template.
-
-6. Auditoría del architect-agent (OBLIGATORIA)
-   - El `architect-agent` **DEBE** revisar el módulo y el informe.
-   - Si detecta fallos → ir a **Paso 9 (FAIL)**.
-
-7. Solicitar aprobacion del desarrollador (OBLIGATORIA, por consola)
-   - El desarrollador **DEBE** aprobar el informe:
-     - **SI** → aprobado
-     - **NO** → rechazado
-   - Registrar la decision en `module/create.md`:
-     ```yaml
-     approval:
-       developer:
-         decision: SI | NO
-         date: <ISO-8601>
-         comments: <opcional>
-     ```
-   - Si `decision != SI` → ir a **Paso 9 (FAIL)**.
-
-8. PASS
-   - Informar que el módulo cumple el contrato.
-   - Actualizar `.agent/artifacts/<taskId>-<taskTitle>/task.md`:
-     - Agregar una entrada en `task.lifecycle.subflows.modules.create[]`:
-       - `name: <module-name>`
-       - `completed: true`
-       - `validated_by: "architect-agent"`
-       - `validated_at: <ISO-8601>`
-     - `task.phase.updated_at = <ISO-8601>`
-
----
-
-## FAIL (OBLIGATORIO)
-
-9. Declarar creación de módulo como **NO completada**
-   - Indicar exactamente qué falló:
-     - plan inexistente o no requiere módulo
-     - template inexistente
-     - incumplimiento de `constitution.modules`
-     - incumplimiento de `constitution.pages` (si aplica)
-     - incumplimiento de `constitution.shards` (si aplica)
-     - Pages con lógica de negocio persistente (violación §11-12)
-     - fallos de integración en el ecosistema
-     - auditoría del architect-agent rechazada
-   - Acción mínima:
-     - corregir los puntos detectados por architect o desarrollador
-   - Terminar bloqueado: no avanzar.
-
----
-
-## Gate (REQUIRED)
-
-Requisitos (todos obligatorios):
-1. Existe `.agent/artifacts/<taskId>-<taskTitle>/module/create.md`.
-2. El informe sigue la estructura del template `templates.module_create`.
-3. El `module/create.md` inicia con el prefijo del `module-agent`.
-4. El módulo cumple `constitution.modules`.
-5. Si hay Pages, cumplen `constitution.pages` (especialmente §11-12).
-6. Si hay Shards, cumplen `constitution.shards`.
-7. Auditoría del architect-agent aprobada.
-8. Existe aprobacion explicita del desarrollador (por consola) registrada en `module/create.md`:
-   - `approval.developer.decision == SI`
-9. `task.md` refleja subflow y timestamp:
-   - Existe una entrada en `task.lifecycle.subflows.modules.create[]` con:
-     - `name: <module-name>`
-     - `completed == true`
-     - `validated_at` no nulo
-   - `task.phase.updated_at` no nulo
-
-Si Gate FAIL:
-- Ejecutar **Paso 9 (FAIL)**.

package/dist/workflows/modules/delete.md

@@ -1,121 +0,0 @@
----
-description: Workflow para eliminar modulos siguiendo la constitucion y reglas de arquitectura del ecosistema Extensio.
----
-
----
-id: workflow.modules.delete
-owner: module-agent
-version: 1.0.0
-severity: PERMANENT
-trigger:
-  commands: ["module-delete", "modules:delete"]
-blocking: true
----
-
-# WORKFLOW: modules.delete
-
-## Input (REQUIRED)
-- El arquitecto ha determinado en el plan la eliminacion de un modulo:
-  - `.agent/artifacts/<taskId>-<taskTitle>/plan.md`
-
-## Output (REQUIRED)
-- Informe de eliminacion de modulo (OBLIGATORIO):
-  - `.agent/artifacts/<taskId>-<taskTitle>/module/delete.md`
-
-## Objetivo (ONLY)
-Asegurar que la eliminacion de un modulo cumple:
-- la constitucion de modulos
-- la arquitectura de Extensio y reglas globales
-- la integridad del ecosistema
-
-> Esta fase **NO** omite auditoria del architect-agent.
-
-## Template (OBLIGATORIO)
-- El informe **DEBE** crearse usando el template:
-  - `templates.module_delete`
-- Si el template no existe o no se puede cargar → **FAIL**.
-
----
-
-## Pasos obligatorios
-
-0. Activar `module-agent` y usar prefijo obligatorio en cada mensaje.
-
-1. Verificar inputs
-   - Existe `plan.md` que requiere eliminar un modulo.
-   - Si falla → ir a **Paso 9 (FAIL)**.
-
-2. Eliminar el modulo
-   - Eliminar modulo y referencias.
-   - Validar sin imports huerfanos.
-   - Confirmar que no quedan referencias en globals/constants.
-
-3. Crear informe de eliminacion
-   - Crear:
-     - `.agent/artifacts/<taskId>-<taskTitle>/module/delete.md`
-   - Completar el informe segun el template.
-
-4. Auditoria del architect-agent (OBLIGATORIA)
-   - El `architect-agent` **DEBE** revisar el informe.
-   - Si detecta fallos → ir a **Paso 9 (FAIL)**.
-
-5. Solicitar aprobacion del desarrollador (OBLIGATORIA, por consola)
-   - El desarrollador **DEBE** aprobar el informe:
-     - **SI** → aprobado
-     - **NO** → rechazado
-   - Registrar la decision en `module/delete.md`:
-     ```yaml
-     approval:
-       developer:
-         decision: SI | NO
-         date: <ISO-8601>
-         comments: <opcional>
-     ```
-   - Si `decision != SI` → ir a **Paso 9 (FAIL)**.
-
-6. PASS
-   - Informar que la eliminacion cumple el contrato.
-   - Actualizar `.agent/artifacts/<taskId>-<taskTitle>/task.md`:
-     - Agregar una entrada en `task.lifecycle.subflows.modules.delete[]`:
-       - `name: <module-name>`
-       - `completed: true`
-       - `validated_by: "architect-agent"`
-       - `validated_at: <ISO-8601>`
-     - `task.phase.updated_at = <ISO-8601>`
-
----
-
-## FAIL (OBLIGATORIO)
-
-9. Declarar eliminacion de modulo como **NO completada**
-   - Indicar exactamente que fallo:
-     - plan inexistente o no requiere modulo
-     - template inexistente
-     - incumplimiento de `constitution.modules`
-     - fallos de integracion en el ecosistema
-     - auditoria del architect-agent rechazada
-   - Accion minima:
-     - corregir los puntos detectados por architect o desarrollador
-   - Terminar bloqueado: no avanzar.
-
----
-
-## Gate (REQUIRED)
-
-Requisitos (todos obligatorios):
-1. Existe `.agent/artifacts/<taskId>-<taskTitle>/module/delete.md`.
-2. El informe sigue la estructura del template `templates.module_delete`.
-3. El `module/delete.md` inicia con el prefijo del `module-agent`.
-4. La eliminacion cumple `constitution.modules`.
-5. Auditoria del architect-agent aprobada.
-6. Existe aprobacion explicita del desarrollador (por consola) registrada en `module/delete.md`:
-   - `approval.developer.decision == SI`
-7. `task.md` refleja subflow y timestamp:
-   - Existe una entrada en `task.lifecycle.subflows.modules.delete[]` con:
-     - `name: <module-name>`
-     - `completed == true`
-     - `validated_at` no nulo
-   - `task.phase.updated_at` no nulo
-
-Si Gate FAIL:
-- Ejecutar **Paso 9 (FAIL)**.

package/dist/workflows/modules/index.md

@@ -1,27 +0,0 @@
----
-id: workflows.modules.index
-owner: architect-agent
-version: 2.0.0
-severity: PERMANENT
-description: Indice del dominio de workflows para modulos.
----
-
-# INDEX — Workflows / Modules
-
-## Objetivo
-Este fichero define los workflows del dominio `modules`.
-
-## Aliases (YAML)
-```yaml
-workflows:
-  modules:
-    create: .agent/workflows/modules/create.md
-    refactor: .agent/workflows/modules/refactor.md
-    delete: .agent/workflows/modules/delete.md
-    shards_create: .agent/workflows/modules/shards.create.md
-    pages_create: .agent/workflows/modules/pages.create.md
-```
-
-## Reglas
-- Este indice **solo** declara workflows del dominio `modules`.
-- Cualquier workflow nuevo **DEBE** añadirse aqui antes de ser referenciado.

package/dist/workflows/modules/pages.create.md

@@ -1,234 +0,0 @@
----
-description: Workflow para crear Pages siguiendo la constitución de Extensio.
----
-
----
-id: workflow.pages.create
-owner: module-agent
-version: 2.0.0
-severity: PERMANENT
-trigger:
-  commands: ["page-create", "pages:create"]
-blocking: true
----
-
-# WORKFLOW: pages.create
-
-## Input (REQUIRED)
-- El módulo donde se creará la Page ya existe y cumple `constitution.modules`.
-- El plan o la tarea requiere crear una nueva Page.
-
-## Output (REQUIRED)
-- Page creada con estructura completa
-- Índice de Pages actualizado
-- Page accesible mediante `Engine.navigate()`
-
-## Objetivo (ONLY)
-Asegurar que la creación de una Page cumple:
-- `constitution.pages` (estructura, ciclo de vida, responsabilidades)
-- Integración correcta con el módulo y el Engine
-
----
-
-## Pasos obligatorios
-
-0. Activar `module-agent` y usar prefijo obligatorio en cada mensaje.
-
-### 1. Verificar inputs
-- Existe el módulo destino.
-- El módulo tiene estructura válida.
-- Si falla → **FAIL**.
-
-### 2. Crear estructura de carpetas
-```
-src/surface/pages/<page-name>/
-├── index.html    # Documento HTML
-├── index.mts     # Script principal
-└── styles.css    # Estilos (opcional)
-```
-
-### 3. Crear documento HTML (`index.html`)
-El HTML **DEBE**:
-- Ser un documento HTML5 válido
-- Incluir `<script type="module" src="./index.mts">`
-- No contener lógica inline
-
-Ejemplo mínimo:
-```html
-<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>Page Name</title>
-  <link rel="stylesheet" href="./styles.css">
-</head>
-<body>
-  <div id="app"></div>
-  <script type="module" src="./index.mts"></script>
-</body>
-</html>
-```
-
-### 4. Crear script principal (`index.mts`)
-El script **DEBE**:
-- Extender la clase `Page`
-- Implementar el ciclo de vida: `run()` → `listen()` → `start()`
-- Respetar las responsabilidades (§11-12):
-  - Solo lógica de presentación
-  - Solo lógica de interacción
-  - Solo orquestación de Shards
-
-Ejemplo mínimo:
-```ts
-import { Page } from '@extensio/core/surface/pages';
-
-class MyPage extends Page {
-  constructor() {
-    super('my-page');
-  }
-
-  override listen() {
-    super.listen();
-    // Registrar listeners de eventos/drivers
-  }
-
-  override start() {
-    // Lógica de presentación
-    this.render();
-  }
-
-  private render() {
-    const app = document.getElementById('app');
-    if (app) {
-      app.innerHTML = '<h1>My Page</h1>';
-    }
-  }
-}
-
-const page = new MyPage();
-page.run();
-```
-
-### 5. Registrar en índice de Pages
-Actualizar `src/surface/pages/index.mts`:
-```ts
-import myPage from "./my-page/index.html";
-
-export const Pages = {
-  // ... otras pages
-  myPage,
-};
-```
-
-### 6. Importar índice en Engine
-Verificar que el Engine importa el índice de Pages para que el CLI las detecte:
-```ts
-// En el Engine
-import { Pages } from './surface/pages/index.mts';
-```
-
-### 7. Verificar responsabilidades (§11-12)
-La Page **DEBE** contener solo:
-- ✅ Lógica de presentación
-- ✅ Lógica de interacción
-- ✅ Orquestación de Shards
-
-La Page **NO DEBE** contener:
-- ❌ Estado de negocio persistente
-- ❌ Lógica que afecte otras partes de la extensión
-- ❌ Duplicación de lógica del Engine
-
-### 8. Validar accesibilidad
-- Verificar que la Page es accesible mediante `navigate()`:
-```ts
-await this.navigate(Pages.myPage);
-```
-- Ejecutar build para verificar que el CLI procesa la Page correctamente.
-
-### 9. Solicitar aprobación del desarrollador (OBLIGATORIA, por consola)
-- El desarrollador **DEBE** aprobar la Page creada:
-  - **SI** → aprobado
-  - **NO** → rechazado
-- Registrar la decision en el informe de creacion:
-  - `.agent/artifacts/<taskId>-<taskTitle>/module/create.md`
-  ```yaml
-  approval:
-    developer:
-      decision: SI | NO
-      date: <ISO-8601>
-      comments: <opcional>
-  ```
-- Si `decision != SI` → ir a **Paso 11 (FAIL)**.
-
-### 10. PASS
-- La Page cumple `constitution.pages`.
-- La Page está registrada e integrada.
- - Actualizar `.agent/artifacts/<taskId>-<taskTitle>/task.md`:
-   - Agregar una entrada en `task.lifecycle.subflows.pages.create[]`:
-     - `name: <page-name>`
-     - `completed: true`
-     - `validated_by: "architect-agent"`
-     - `validated_at: <ISO-8601>`
-   - `task.phase.updated_at = <ISO-8601>`
-
----
-
-## FAIL (OBLIGATORIO)
-
-11. Declarar creación como **NO completada**
-    - Indicar qué falló:
-      - Estructura incorrecta (§3)
-      - Ciclo de vida incompleto (§4)
-      - Responsabilidades incorrectas (§11-12)
-      - No registrada en índice
-      - No accesible via `navigate()`
-    - Corregir antes de continuar.
-
----
-
-## Gate (REQUIRED)
-
-Requisitos (todos obligatorios):
-1. Estructura: `<page-name>/index.html` + `<page-name>/index.mts`
-2. HTML válido con `<script type="module">`
-3. Script extiende `Page` y usa `run()` → `listen()` → `start()`
-4. Responsabilidades conforme a §11-12
-5. Registrada en `src/surface/pages/index.mts`
-6. Índice importado en Engine
-7. Accesible mediante `navigate()`
-8. Existe aprobación explícita del desarrollador (por consola) registrada en `module/create.md`:
-   - `approval.developer.decision == SI`
-9. `task.md` refleja subflow y timestamp:
-   - Existe una entrada en `task.lifecycle.subflows.pages.create[]` con:
-     - `name: <page-name>`
-     - `completed == true`
-     - `validated_at` no nulo
-   - `task.phase.updated_at` no nulo
-
- Si Gate FAIL:
-- Ejecutar **Paso 11 (FAIL)**.
-
----
-
-## Nota: Hooks Automáticos
-
-Las Pages heredan de Surface, por lo que tienen acceso a los hooks automáticos:
-
-- **onMount()**: Se ejecuta automáticamente DESPUÉS de `render()`. Sobrescribir para lógica post-render.
-- **onUnmount()**: Se ejecuta automáticamente ANTES de destruir (cuando el tab se cierra). Sobrescribir para cleanup.
-
-```ts
-class MyPage extends Page {
-  protected override onMount(): void {
-    console.log('Page visible y montada');
-    // Inicializar animaciones, enfocar elementos, etc.
-  }
-
-  protected override onUnmount(): void {
-    // Cancelar timers, remover listeners globales, etc.
-  }
-}
-```
-
-Estos hooks son opcionales pero recomendados para gestionar el ciclo de vida del componente.

package/dist/workflows/modules/refactor.md

@@ -1,122 +0,0 @@
----
-description: Workflow para refactorizar modulos siguiendo la constitucion y reglas de arquitectura del ecosistema Extensio.
----
-
----
-id: workflow.modules.refactor
-owner: module-agent
-version: 1.0.0
-severity: PERMANENT
-trigger:
-  commands: ["module-refactor", "modules:refactor"]
-blocking: true
----
-
-# WORKFLOW: modules.refactor
-
-## Input (REQUIRED)
-- El arquitecto ha determinado en el plan el refactor de un modulo:
-  - `.agent/artifacts/<taskId>-<taskTitle>/plan.md`
-
-## Output (REQUIRED)
-- Informe de refactor de modulo (OBLIGATORIO):
-  - `.agent/artifacts/<taskId>-<taskTitle>/module/refactor.md`
-
-## Objetivo (ONLY)
-Asegurar que el refactor de un modulo cumple:
-- la constitucion de modulos
-- la arquitectura de Extensio y reglas globales
-- la integracion correcta en el ecosistema
-
-> Esta fase **NO** omite auditoria del architect-agent.
-
-## Template (OBLIGATORIO)
-- El informe **DEBE** crearse usando el template:
-  - `templates.module_refactor`
-- Si el template no existe o no se puede cargar → **FAIL**.
-
----
-
-## Pasos obligatorios
-
-0. Activar `module-agent` y usar prefijo obligatorio en cada mensaje.
-
-1. Verificar inputs
-   - Existe `plan.md` que requiere refactor de modulo.
-   - Si falla → ir a **Paso 9 (FAIL)**.
-
-2. Ejecutar refactor
-   - Aplicar cambios definidos en el plan.
-   - Validar estructura post-refactor.
-   - Validar scopes preservados.
-   - Validar reactividad y ciclo de vida intactos.
-
-3. Crear informe de refactor
-   - Crear:
-     - `.agent/artifacts/<taskId>-<taskTitle>/module/refactor.md`
-   - Completar el informe segun el template.
-
-4. Auditoria del architect-agent (OBLIGATORIA)
-   - El `architect-agent` **DEBE** revisar el modulo y el informe.
-   - Si detecta fallos → ir a **Paso 9 (FAIL)**.
-
-5. Solicitar aprobacion del desarrollador (OBLIGATORIA, por consola)
-   - El desarrollador **DEBE** aprobar el informe:
-     - **SI** → aprobado
-     - **NO** → rechazado
-   - Registrar la decision en `module/refactor.md`:
-     ```yaml
-     approval:
-       developer:
-         decision: SI | NO
-         date: <ISO-8601>
-         comments: <opcional>
-     ```
-   - Si `decision != SI` → ir a **Paso 9 (FAIL)**.
-
-6. PASS
-   - Informar que el modulo cumple el contrato.
-   - Actualizar `.agent/artifacts/<taskId>-<taskTitle>/task.md`:
-     - Agregar una entrada en `task.lifecycle.subflows.modules.refactor[]`:
-       - `name: <module-name>`
-       - `completed: true`
-       - `validated_by: "architect-agent"`
-       - `validated_at: <ISO-8601>`
-     - `task.phase.updated_at = <ISO-8601>`
-
----
-
-## FAIL (OBLIGATORIO)
-
-9. Declarar refactor de modulo como **NO completado**
-   - Indicar exactamente que fallo:
-     - plan inexistente o no requiere modulo
-     - template inexistente
-     - incumplimiento de `constitution.modules`
-     - fallos de integracion en el ecosistema
-     - auditoria del architect-agent rechazada
-   - Accion minima:
-     - corregir los puntos detectados por architect o desarrollador
-   - Terminar bloqueado: no avanzar.
-
----
-
-## Gate (REQUIRED)
-
-Requisitos (todos obligatorios):
-1. Existe `.agent/artifacts/<taskId>-<taskTitle>/module/refactor.md`.
-2. El informe sigue la estructura del template `templates.module_refactor`.
-3. El `module/refactor.md` inicia con el prefijo del `module-agent`.
-4. El modulo cumple `constitution.modules`.
-5. Auditoria del architect-agent aprobada.
-6. Existe aprobacion explicita del desarrollador (por consola) registrada en `module/refactor.md`:
-   - `approval.developer.decision == SI`
-7. `task.md` refleja subflow y timestamp:
-   - Existe una entrada en `task.lifecycle.subflows.modules.refactor[]` con:
-     - `name: <module-name>`
-     - `completed == true`
-     - `validated_at` no nulo
-   - `task.phase.updated_at` no nulo
-
-Si Gate FAIL:
-- Ejecutar **Paso 9 (FAIL)**.