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

package/dist/tools/extensio-cli.md

@@ -1,76 +0,0 @@
----
-id: tool.extensio_cli
-type: tool
-owner: architect-agent
-version: 1.0.0
-severity: PERMANENT
-scope: global
-
-name: "@extensio/cli"
-runtime: node
-invocation: shell
-
-allowed_commands:
-  - "npx @extensio/cli --help"
-  - "npx @extensio/cli create --type driver --name <name> <params>"
-  - "npx @extensio/cli create --type module --name <name> <params>"
-  - "npx @extensio/cli create --type project --name <name> <params>"
-  - "npx @extensio/cli demo --type <type> --name <name> <params>"
-  - "npx @extensio/cli build"
-  - "npx @extensio/cli test"
-
-constraints:
-  destructive_requires_approval: true
-  requires_constitution:
-    - constitution.drivers
----
-
-# TOOL: @extensio/cli
-
-## Objetivo
-Tool oficial para **scaffolding, build y testing** en Extensio.
-Permite crear entidades (drivers, modules, projects) y ejecutar build/test siguiendo la constitucion.
-
-## Uso
-- Los agentes **DEBEN** usar este tool para crear drivers cuando el comando exista.
-- La ejecución real del comando se realiza fuera de Antigravity
-  (IDE, CI o intervención humana).
-- `ext build` compila el `src/` del directorio actual. Debe ejecutarse desde el root
-  del modulo. Si una demo es un modulo dentro de un modulo padre, tambien se usa
-  `ext build` ejecutandolo desde la carpeta de la demo.
-
-## Ejemplos de uso
-- Ayuda:
-  - `npx @extensio/cli --help`
-- Crear driver:
-  - `npx @extensio/cli create --type driver --name prompt-ai --methods "createSession,prompt,close" --platforms "chrome" --includeDemo true --non-interactive`
-- Crear modulo:
-  - `npx @extensio/cli create --type module --name storage-core --inheritsCore true --withEngine true --withSurface false --non-interactive`
-- Crear proyecto:
-  - `npx @extensio/cli create --type project --name extensio-app --targetPath ./packages --non-interactive`
-- Crear demo para driver existente:
-  - `npx @extensio/cli demo --type driver --name prompt-ai --non-interactive`
-- Crear demo para modulo existente:
-  - `npx @extensio/cli demo --type module --name storage-core --non-interactive`
-- Build:
-  - `npx @extensio/cli build --browsers chrome,firefox --types --no-launch`
-- Tests:
-  - `npx @extensio/cli test --type unit --coverage --non-interactive`
-  - `npx @extensio/cli test --type e2e --browsers chromium --no-headless --non-interactive`
-
-## Seguridad
-- Los comandos destructivos requieren aprobación explícita del desarrollador (`SI | NO`).
-
-## Notas
-- Usar siempre `npx` para evitar dependencias globales.
-
-## Guia rapida (CLI local)
-Si agregas un comando nuevo al CLI, debes regenerar `dist/`:
-1. Instalar dependencias del workspace:
-   - `npm install`
-2. Compilar el CLI:
-   - `cd packages/cli && npm run build`
-3. Verificar el bin:
-   - `node dist/index.mjs --help`
-
-Nota: `packages/**/dist` esta en `.gitignore`, por lo que el bin requiere build local.

package/dist/tools/index.md

@@ -1,14 +0,0 @@
----
-id: tools.index
-type: rule
-owner: architect-agent
-version: 1.0.0
-severity: PERMANENT
-scope: global
----
-
-```yaml
-tools:
-  extensio_cli: .agent/tools/extensio-cli.md
-  run_command: .agent/tools/run-command.md
-```

package/dist/tools/run-command.md

@@ -1,42 +0,0 @@
----
-id: tool.run_command
-type: tool
-owner: architect-agent
-version: 1.0.0
-severity: PERMANENT
-scope: global
-
-name: run_command
-runtime: shell
-invocation: shell
-
-allowed_commands:
-  - "npx tsc --noEmit"
-  - "npx eslint . --ext .ts,.mts,.tsx"
-  - "git diff --name-only --diff-filter=ACMR"
-
-constraints:
-  destructive_requires_approval: true
-  network_access_requires_approval: true
----
-
-# TOOL: run_command
-
-## Objetivo
-Tool generico para ejecutar comandos de terminal cuando no existe un MCP tool especifico.
-Se usa principalmente para validaciones locales (TypeScript, ESLint) y utilidades de git.
-
-## Uso
-- Usar este tool solo cuando no haya un tool dedicado en `.agent/tools/index.md`.
-- Si el comando es destructivo o requiere red, pedir aprobacion explicita.
-
-## Ejemplos de uso
-- Validacion TypeScript:
-  - `npx tsc --noEmit`
-- Validacion ESLint:
-  - `npx eslint . --ext .ts,.mts,.tsx`
-- Archivos modificados:
-  - `git diff --name-only --diff-filter=ACMR`
-
-## Seguridad
-- Comandos destructivos o con acceso a red requieren aprobacion explicita del desarrollador.

package/dist/workflows/drivers/create.md

@@ -1,139 +0,0 @@
----
-description: Workflow para crear drivers siguiendo la constitucion y reglas de arquitectura del ecosistema Extensio.
----
-
----
-id: workflow.drivers.create
-owner: driver-agent
-version: 1.0.0
-severity: PERMANENT
-trigger:
-  commands: ["driver-create", "drivers:create"]
-blocking: true
----
-
-# WORKFLOW: drivers.create
-
-## Input (REQUIRED)
-- El arquitecto ha determinado en el plan la creacion de un nuevo driver:
-  - `.agent/artifacts/<taskId>-<taskTitle>/plan.md`
-
-## Output (REQUIRED)
-- Informe de creacion de driver (OBLIGATORIO):
-  - `.agent/artifacts/<taskId>-<taskTitle>/driver/create.md`
-
-## Objetivo (ONLY)
-Asegurar que la creacion de un nuevo driver cumple:
-- la constitucion de drivers
-- 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.driver_create`
-- Si el template no existe o no se puede cargar → **FAIL**.
-
----
-
-## Pasos obligatorios
-
-0. Activar `driver-agent` y usar prefijo obligatorio en cada mensaje.
-
-1. Verificar inputs
-   - Existe `plan.md` que requiere crear un driver.
-   - Si falla → ir a **Paso 9 (FAIL)**.
-
-2. Crear el driver (driver-agent)
-   - El **driver-agent** usa su skill `extensio_create_driver`:
-     - Leer `.agent/skills/extensio-create-driver/SKILL.md`
-     - Ejecutar MCP tool `mcp_extensio-cli_extensio_create` con:
-       - `type: "driver"`
-       - `name`: nombre del driver
-       - `platforms`: "chrome,firefox,safari,common"
-       - `includeDemo`: según plan
-       - `testType`: "vitest" (por defecto)
-   - La creación manual **solo** es válida si el CLI no soporta la operación.
-   - Garantizar estructura, types, constants, globals y compatibilidad.
-   - Registrar tipos en `globals.d.mts` bajo `Extensio.<NamespaceDelDriver>`.
-   - Exportar constantes del driver en el `constants.mts` del root.
-   - Verificar `globals.d.mts`:
-     - imports/exports correctos de tipos del driver
-     - sin duplicados o nombres corruptos
-     - integración no rompe el fichero
-   - Verificar `constants.mts` (root):
-     - exports correctos de constantes del driver
-     - sin duplicados o nombres corruptos
-     - integración no rompe el fichero
-
-3. Crear informe de creacion
-   - Crear:
-     - `.agent/artifacts/<taskId>-<taskTitle>/driver/create.md`
-   - Completar el informe segun el template.
-
-4. Auditoria del architect-agent (OBLIGATORIA)
-   - El `architect-agent` **DEBE** revisar el driver 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 `driver/create.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 driver cumple el contrato.
-   - Actualizar `.agent/artifacts/<taskId>-<taskTitle>/task.md`:
-     - Agregar una entrada en `task.lifecycle.subflows.drivers.create[]`:
-       - `name: <driver-name>`
-       - `completed: true`
-       - `validated_by: "architect-agent"`
-       - `validated_at: <ISO-8601>`
-     - `task.phase.updated_at = <ISO-8601>`
-
----
-
-## FAIL (OBLIGATORIO)
-
-9. Declarar creacion de driver como **NO completada**
-   - Indicar exactamente que fallo:
-     - plan inexistente o no requiere driver
-     - template inexistente
-     - incumplimiento de `constitution.drivers`
-     - 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>/driver/create.md`.
-2. El informe sigue la estructura del template `templates.driver_create`.
-3. El `driver/create.md` inicia con el prefijo del `driver-agent`.
-4. El driver cumple `constitution.drivers`.
-5. Auditoria del architect-agent aprobada.
-6. Existe aprobacion explicita del desarrollador (por consola) registrada en `driver/create.md`:
-   - `approval.developer.decision == SI`
-7. `globals.d.mts` y `constants.mts` integran el driver sin duplicados ni errores.
-8. `task.md` refleja subflow y timestamp:
-   - Existe una entrada en `task.lifecycle.subflows.drivers.create[]` con:
-     - `name: <driver-name>`
-     - `completed == true`
-     - `validated_at` no nulo
-   - `task.phase.updated_at` no nulo
-
-Si Gate FAIL:
-- Ejecutar **Paso 9 (FAIL)**.

package/dist/workflows/drivers/delete.md

@@ -1,124 +0,0 @@
----
-description: Workflow para eliminar drivers siguiendo la constitucion y reglas de arquitectura del ecosistema Extensio.
----
-
----
-id: workflow.drivers.delete
-owner: driver-agent
-version: 1.0.0
-severity: PERMANENT
-trigger:
-  commands: ["driver-delete", "drivers:delete"]
-blocking: true
----
-
-# WORKFLOW: drivers.delete
-
-## Input (REQUIRED)
-- El arquitecto ha determinado en el plan la eliminacion del driver:
-  - `.agent/artifacts/<taskId>-<taskTitle>/plan.md`
-
-## Output (REQUIRED)
-- Informe de eliminacion de driver (OBLIGATORIO):
-  - `.agent/artifacts/<taskId>-<taskTitle>/driver/delete.md`
-
-## Objetivo (ONLY)
-Asegurar que la eliminacion de un driver:
-- elimina referencias sin dejar imports huerfanos
-- actualiza globals/constants del proyecto
-- mantiene integridad del ecosistema
-
-> Esta fase **NO** omite auditoria del architect-agent.
-
-## Template (OBLIGATORIO)
-- El informe **DEBE** crearse usando el template:
-  - `templates.driver_delete`
-- Si el template no existe o no se puede cargar → **FAIL**.
-
----
-
-## Pasos obligatorios
-
-0. Activar `driver-agent` y usar prefijo obligatorio en cada mensaje.
-
-1. Verificar inputs
-   - Existe `plan.md` que requiere eliminar un driver.
-   - Si falla → ir a **Paso 9 (FAIL)**.
-
-2. Eliminar el driver
-   - Eliminar el driver segun el plan y `constitution.drivers`.
-   - Remover referencias en el ecosistema (imports, docs, tests).
-   - Remover tipos del namespace en `globals.d.mts`.
-   - Remover exports de constantes en `constants.mts` (root).
-   - Actualizar `globals.d.mts` y `constants.mts` (sin duplicados/errores).
-
-3. Crear informe de eliminacion
-   - Crear:
-     - `.agent/artifacts/<taskId>-<taskTitle>/driver/delete.md`
-   - Completar el informe segun el template.
-
-4. Auditoria del architect-agent (OBLIGATORIA)
-   - El `architect-agent` **DEBE** revisar el cambio 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 `driver/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 el driver fue eliminado correctamente.
-   - Actualizar `.agent/artifacts/<taskId>-<taskTitle>/task.md`:
-     - Agregar una entrada en `task.lifecycle.subflows.drivers.delete[]`:
-       - `name: <driver-name>`
-       - `completed: true`
-       - `validated_by: "architect-agent"`
-       - `validated_at: <ISO-8601>`
-     - `task.phase.updated_at = <ISO-8601>`
-
----
-
-## FAIL (OBLIGATORIO)
-
-9. Declarar eliminacion de driver como **NO completada**
-   - Indicar exactamente que fallo:
-     - plan inexistente o no requiere eliminacion
-     - template inexistente
-     - referencias huerfanas
-     - integracion corrupta 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>/driver/delete.md`.
-2. El informe sigue la estructura del template `templates.driver_delete`.
-3. El `driver/delete.md` inicia con el prefijo del `driver-agent`.
-4. No hay referencias huerfanas al driver eliminado.
-5. Auditoria del architect-agent aprobada.
-6. Existe aprobacion explicita del desarrollador (por consola) registrada en `driver/delete.md`:
-   - `approval.developer.decision == SI`
-7. `globals.d.mts` y `constants.mts` actualizados sin duplicados ni errores.
-8. `task.md` refleja subflow y timestamp:
-   - Existe una entrada en `task.lifecycle.subflows.drivers.delete[]` con:
-     - `name: <driver-name>`
-     - `completed == true`
-     - `validated_at` no nulo
-   - `task.phase.updated_at` no nulo
-
-Si Gate FAIL:
-- Ejecutar **Paso 9 (FAIL)**.

package/dist/workflows/drivers/index.md

@@ -1,25 +0,0 @@
----
-id: workflows.drivers.index
-owner: architect-agent
-version: 1.0.0
-severity: PERMANENT
-description: Índice del dominio de workflows para drivers: creación, refactor y eliminación. Define los entrypoints oficiales y obliga a usar estos flujos para mantener la constitución y la integración correcta en Extensio.
----
-
-# INDEX — Workflows / Drivers
-
-## Objetivo
-Este fichero define los workflows del dominio `drivers`.
-
-## Aliases (YAML)
-```yaml
-workflows:
-  drivers:
-    create: .agent/workflows/drivers/create.md
-    refactor: .agent/workflows/drivers/refactor.md
-    delete: .agent/workflows/drivers/delete.md
-```
-
-## Reglas
-- Este índice **solo** declara workflows del dominio `drivers`.
-- Cualquier workflow nuevo **DEBE** añadirse aquí antes de ser referenciado.

package/dist/workflows/drivers/refactor.md

@@ -1,125 +0,0 @@
----
-description: Workflow para refactorizar drivers siguiendo la constitucion y reglas de arquitectura del ecosistema Extensio.
----
-
----
-id: workflow.drivers.refactor
-owner: driver-agent
-version: 1.0.0
-severity: PERMANENT
-trigger:
-  commands: ["driver-refactor", "drivers:refactor"]
-blocking: true
----
-
-# WORKFLOW: drivers.refactor
-
-## Input (REQUIRED)
-- El arquitecto ha determinado en el plan la refactorizacion del driver:
-  - `.agent/artifacts/<taskId>-<taskTitle>/plan.md`
-
-## Output (REQUIRED)
-- Informe de refactorizacion de driver (OBLIGATORIO):
-  - `.agent/artifacts/<taskId>-<taskTitle>/driver/refactor.md`
-
-## Objetivo (ONLY)
-Asegurar que el refactor de un driver:
-- mantiene cumplimiento de `constitution.drivers`
-- preserva compatibilidad multi-browser
-- actualiza integraciones en globals/constants si aplica
-
-> Esta fase **NO** omite auditoria del architect-agent.
-
-## Template (OBLIGATORIO)
-- El informe **DEBE** crearse usando el template:
-  - `templates.driver_refactor`
-- Si el template no existe o no se puede cargar → **FAIL**.
-
----
-
-## Pasos obligatorios
-
-0. Activar `driver-agent` y usar prefijo obligatorio en cada mensaje.
-
-1. Verificar inputs
-   - Existe `plan.md` que requiere refactorizar un driver.
-   - Si falla → ir a **Paso 9 (FAIL)**.
-
-2. Refactorizar el driver
-   - Ejecutar cambios segun el plan y `constitution.drivers`.
-   - Validar estructura, types, constants y compatibilidad.
-   - Si hay cambios en tipos/constantes:
-     - registrar tipos en `globals.d.mts` bajo `Extensio.<NamespaceDelDriver>`
-     - exportar constantes en el `constants.mts` del root
-   - Verificar `globals.d.mts` y `constants.mts` si hubo cambios.
-
-3. Crear informe de refactorizacion
-   - Crear:
-     - `.agent/artifacts/<taskId>-<taskTitle>/driver/refactor.md`
-   - Completar el informe segun el template.
-
-4. Auditoria del architect-agent (OBLIGATORIA)
-   - El `architect-agent` **DEBE** revisar el driver 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 `driver/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 driver cumple el contrato tras el refactor.
-   - Actualizar `.agent/artifacts/<taskId>-<taskTitle>/task.md`:
-     - Agregar una entrada en `task.lifecycle.subflows.drivers.refactor[]`:
-       - `name: <driver-name>`
-       - `completed: true`
-       - `validated_by: "architect-agent"`
-       - `validated_at: <ISO-8601>`
-     - `task.phase.updated_at = <ISO-8601>`
-
----
-
-## FAIL (OBLIGATORIO)
-
-9. Declarar refactorizacion de driver como **NO completada**
-   - Indicar exactamente que fallo:
-     - plan inexistente o no requiere refactor
-     - template inexistente
-     - incumplimiento de `constitution.drivers`
-     - 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>/driver/refactor.md`.
-2. El informe sigue la estructura del template `templates.driver_refactor`.
-3. El `driver/refactor.md` inicia con el prefijo del `driver-agent`.
-4. El driver cumple `constitution.drivers`.
-5. Auditoria del architect-agent aprobada.
-6. Existe aprobacion explicita del desarrollador (por consola) registrada en `driver/refactor.md`:
-   - `approval.developer.decision == SI`
-7. `globals.d.mts` y `constants.mts` integran cambios sin duplicados ni errores.
-8. `task.md` refleja subflow y timestamp:
-   - Existe una entrada en `task.lifecycle.subflows.drivers.refactor[]` con:
-     - `name: <driver-name>`
-     - `completed == true`
-     - `validated_at` no nulo
-   - `task.phase.updated_at` no nulo
-
-Si Gate FAIL:
-- Ejecutar **Paso 9 (FAIL)**.