npm - @christianmaf80/agentic-workflow - Versions diffs - 1.41.0-beta.11 → 1.42.0 - Mend

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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (347) hide show

package/dist/agent/PRESENTATION.html DELETED Viewed

@@ -1,369 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>Agentic System - Professional Presentation</title>
-  <script type="module">
-    import mermaid from 'https://cdn.jsdelivr.net/npm/mermaid@10/dist/mermaid.esm.min.mjs';
-    mermaid.initialize({
-      startOnLoad: true,
-      theme: 'dark',
-      securityLevel: 'loose',
-      fontFamily: 'Outfit, sans-serif'
-    });
-  </script>
-  <link rel="preconnect" href="https://fonts.googleapis.com">
-  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-  <link href="https://fonts.googleapis.com/css2?family=Outfit:wght@300;400;600;700&family=JetBrains+Mono&display=swap"
-    rel="stylesheet">
-  <style>
-    :root {
-      --primary: #00d5ff;
-      --secondary: #7b2ff7;
-      --bg: #0a0a0c;
-      --surface: #16161a;
-      --text: #e1e1e6;
-      --text-dim: #a1a1aa;
-      --border: #27272a;
-    }
-    * {
-      box-sizing: border-box;
-      margin: 0;
-      padding: 0;
-    }
-    body {
-      background-color: var(--bg);
-      color: var(--text);
-      font-family: 'Outfit', sans-serif;
-      line-height: 1.6;
-      overflow-x: hidden;
-    }
-    .container {
-      max-width: 1100px;
-      margin: 0 auto;
-      padding: 4rem 2rem;
-    }
-    header {
-      text-align: center;
-      margin-bottom: 5rem;
-    }
-    h1 {
-      font-size: 3.5rem;
-      font-weight: 700;
-      background: linear-gradient(135deg, var(--primary), var(--secondary));
-      -webkit-background-clip: text;
-      background-clip: text;
-      -webkit-text-fill-color: transparent;
-      margin-bottom: 1rem;
-      letter-spacing: -0.02em;
-    }
-    .subtitle {
-      font-size: 1.25rem;
-      color: var(--text-dim);
-      max-width: 600px;
-      margin: 0 auto;
-    }
-    .hero-image {
-      width: 100%;
-      border-radius: 24px;
-      box-shadow: 0 20px 50px rgba(0, 0, 0, 0.5), 0 0 20px rgba(0, 213, 255, 0.1);
-      margin-bottom: 5rem;
-      overflow: hidden;
-      border: 1px solid var(--border);
-    }
-    .hero-image img {
-      width: 100%;
-      display: block;
-    }
-    section {
-      margin-bottom: 6rem;
-    }
-    h2 {
-      font-size: 2rem;
-      margin-bottom: 2rem;
-      border-left: 4px solid var(--primary);
-      padding-left: 1rem;
-    }
-    .card {
-      background: var(--surface);
-      border: 1px solid var(--border);
-      border-radius: 20px;
-      padding: 2.5rem;
-      margin-bottom: 2rem;
-      transition: transform 0.3s ease, box-shadow 0.3s ease;
-    }
-    .card:hover {
-      transform: translateY(-5px);
-      box-shadow: 0 10px 30px rgba(0, 0, 0, 0.4);
-      border-color: var(--primary);
-    }
-    .mermaid {
-      background: rgba(0, 0, 0, 0.2);
-      padding: 2rem;
-      border-radius: 12px;
-      margin-top: 1rem;
-    }
-    .grid {
-      display: grid;
-      grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));
-      gap: 2rem;
-    }
-    .feature-icon {
-      font-size: 2rem;
-      margin-bottom: 1rem;
-      display: inline-block;
-      background: linear-gradient(135deg, var(--primary), var(--secondary));
-      -webkit-background-clip: text;
-      background-clip: text;
-      -webkit-text-fill-color: transparent;
-    }
-    .code-block {
-      font-family: 'JetBrains Mono', monospace;
-      background: #000;
-      padding: 1.5rem;
-      border-radius: 12px;
-      color: #50fa7b;
-      font-size: 0.9rem;
-      border: 1px solid var(--border);
-      overflow-x: auto;
-    }
-    .footer {
-      text-align: center;
-      padding: 4rem 0;
-      color: var(--text-dim);
-      border-top: 1px solid var(--border);
-    }
-    .text-dim {
-      color: var(--text-dim);
-    }
-    .margin-bottom-2 {
-      margin-bottom: 2rem;
-    }
-    .margin-top-05 {
-      margin-top: 0.5rem;
-    }
-    .margin-bottom-1 {
-      margin-bottom: 1rem;
-    }
-    .badge {
-      display: inline-block;
-      padding: 0.25rem 0.75rem;
-      border-radius: 99px;
-      font-size: 0.8rem;
-      font-weight: 600;
-      text-transform: uppercase;
-      letter-spacing: 0.05em;
-      background: rgba(0, 213, 255, 0.1);
-      color: var(--primary);
-      margin-bottom: 1rem;
-    }
-    .focus-highlight {
-      filter: drop-shadow(0 0 15px var(--primary)) brightness(1.2);
-      transition: all 0.5s ease;
-      transform: scale(1.05);
-    }
-    .mermaid svg {
-      transition: all 0.8s ease;
-    }
-  </style>
-</head>
-<body>
-  <div class="container">
-    <header>
-      <div class="badge">Agnostic Core v1.40</div>
-      <h1>Agentic Workflow Core</h1>
-      <p class="subtitle">The new frontier of portable, modular, and scalable agentic orchestration.</p>
-    </header>
-    <div class="hero-image">
-      <img src="agentic_system_hq_diagram.png" alt="Architecture Hero">
-    </div>
-    <section id="governance">
-      <h2>Governance & Communication</h2>
-      <div class="card">
-        <p class="text-dim margin-bottom-2">How the Assistant, MCP Server, and Runtime interact to govern the workspace.
-        </p>
-        <div class="mermaid">
-          sequenceDiagram
-          participant LLM as AI Assistant (LLM)
-          participant MCP as MCP Server (Bridge)
-          participant RT as Runtime Engine (Governor)
-          participant FS as Filesystem (.agent/MD)
-          Note over LLM, FS: 1. Capability Discovery
-          LLM->>MCP: ListTools()
-          MCP-->>LLM: Runtime Tools (run, next_step, etc.)
-          Note over LLM, FS: 2. Contextual Memory
-          FS->>RT: Read constitution + task.md
-          RT-->>MCP: State + Active Rules
-          MCP-->>LLM: Context injected into System Prompt
-          Note over LLM, FS: 3. Execution & Control
-          LLM->>MCP: CallTool("runtime_next_step")
-          MCP->>RT: Validate Gate (Constitution)
-          RT->>FS: Update task.md
-          RT-->>MCP: ACK Phase updated
-          MCP-->>LLM: New Workspace State
-        </div>
-      </div>
-    </section>
-    <section id="data-structure">
-      <h2>Markdown: Single Source of Truth</h2>
-      <div class="card">
-        <p class="text-dim margin-bottom-2">The system uses Markdown files with YAML metadata and state markers for
-          readable and robust persistence.</p>
-        <div class="mermaid">
-          graph LR
-          subgraph "MD File Structure"
-          FM[Frontmatter YAML]
-          Body[Markdown Content]
-          RT_Tags[Runtime Markers]
-          end
-          subgraph "Runtime Logic"
-          Parse[Markdown Parser]
-          Sync[Frontmatter Sync]
-          Guard[Write Guard]
-          end
-          FM -->|Metadata| Sync
-          Sync --> Parse
-          Body --> Parse
-          Parse --> Guard
-          Guard -->|Persistence| FS[(.agent/artifacts)]
-          classDef tech fill:#1a1a2e,stroke:#00d5ff,stroke-width:2px,color:#fff;
-          class FM,Body,RT_Tags,Sync,Guard tech;
-        </div>
-      </div>
-    </section>
-    <section id="architecture">
-      <h2>System Architecture</h2>
-      <div class="card">
-        <p class="text-dim margin-bottom-2">The Orchestrator Core manages communication between the AI assistant and the
-          filesystem through a robust protocol and a deterministic runtime.</p>
-        <div class="mermaid">
-          graph TD
-          subgraph AI["AI Interfaces"]
-          Assistant["Assistant (Antigravity/Codex)"]
-          end
-          subgraph Core["Agentic Core Engine"]
-          MCP["MCP Server (Protocol)"]
-          RT["Runtime Orchestrator"]
-          CLI["CLI Controller"]
-          subgraph Data["Knowledge & Structure"]
-          Workflows["Workflows (.agent)"]
-          Rules["Rules & Constitution"]
-          Artifacts["Task Artifacts"]
-          end
-          end
-          Assistant <-->|JSON-RPC| MCP
-            MCP <--> RT
-              RT <--> Workflows
-                RT <--> Rules
-                  RT <--> Artifacts
-                    CLI --> RT
-                    classDef core fill:#1a1a2e,stroke:#00d5ff,stroke-width:2px,color:#fff;
-                    classDef interface fill:#2e1a3e,stroke:#7b2ff7,stroke-width:2px,color:#fff;
-                    class MCP,RT,CLI core;
-                    class Assistant interface;
-        </div>
-      </div>
-    </section>
-    <section id="workflows">
-      <h2>Task Lifecycle</h2>
-      <div class="grid">
-        <div class="card">
-          <div class="feature-icon">⚡</div>
-          <h3>Long Strategy</h3>
-          <p class="text-dim margin-top-05">A 9-phase process designed for maximum security and traceability in complex
-            tasks.</p>
-          <div class="mermaid">
-            stateDiagram-v2
-            [*] --> Research
-            Research --> Analysis
-            Analysis --> Planning
-            Planning --> Implementation
-            Implementation --> Verification
-            Verification --> Results
-            Results --> [*]
-          </div>
-        </div>
-        <div class="card">
-          <div class="feature-icon">🚀</div>
-          <h3>Short Strategy</h3>
-          <p class="text-dim margin-top-05">Optimized 3-4 phase flow for rapid iterations and agile fixes.</p>
-          <div class="mermaid">
-            stateDiagram-v2
-            [*] --> Analysis
-            Analysis --> Implementation
-            Implementation --> Results
-            Results --> [*]
-          </div>
-        </div>
-      </div>
-    </section>
-    <section id="usage">
-      <h2>Portable Execution</h2>
-      <div class="card">
-        <p class="margin-bottom-1">After migration, the system is 100% independent of VS Code:</p>
-        <div class="code-block">
-          # Install dependencies
-          npm install
-          # Build the core
-          npm run build
-          # Start MCP server
-          node dist/cli/index.js mcp
-          # Initialize a new workspace
-          node dist/cli/index.js init
-        </div>
-      </div>
-    </section>
-    <footer class="footer">
-      <p>&copy; 2026 Agentic System Team - Advanced Agentic Coding</p>
-    </footer>
-  </div>
-</body>
-</html>

package/dist/agent/agentic_domain_structure.png DELETED Viewed

Binary file

package/dist/agent/agentic_structure_deep_dive.png DELETED Viewed

Binary file

package/dist/agent/agentic_structure_rules.png DELETED Viewed

Binary file

package/dist/agent/agentic_system_hq_diagram.png DELETED Viewed

Binary file

package/dist/agent/agents_and_tools_structure.png DELETED Viewed

Binary file

package/dist/agent/artifacts/candidate/index.md DELETED Viewed

@@ -1,26 +0,0 @@
----
-id: artifacts.candidate.index
-owner: architect-agent
-version: 1.0.0
-severity: PERMANENT
----
-# INDEX — Artifacts / Candidate
-## Objetivo
-Este fichero define el indice del dominio artifacts.candidate.
-Declara la carpeta base para candidates.
-## Aliases (YAML)
-```yaml
-artifacts:
-  candidate:
-    dir: .agent/artifacts/candidate
-```
-## Reglas
-- No declarar rutas de archivos canonicos aqui.
-- Los candidates son dinamicos y se generan por workflow.
-## Candidates (auto)
-<!-- AUTO-GENERATED: candidates -->

package/dist/agent/artifacts/index.md DELETED Viewed

@@ -1,25 +0,0 @@
----
-id: artifacts.index
-owner: architect-agent
-version: 1.0.0
-severity: PERMANENT
----
-# INDEX — Artifacts
-## Objetivo
-Este fichero es el índice del dominio artifacts.
-Define rutas y alias contractuales para los artifacts generados dinámicamente.
-## Aliases (YAML)
-```yaml
-artifacts:
-  candidate:
-    dir: .agent/artifacts/candidate
-    index: .agent/artifacts/candidate/index.md
-    task: .agent/artifacts/candidate/task.md
-```
-## Reglas
-- Los artifacts dinámicos por tarea no se declaran aquí.
-- Solo se declaran rutas canónicas de candidate.

package/dist/agent/conceptual_architecture.png DELETED Viewed

Binary file

package/dist/agent/rules/constitution/index.md DELETED Viewed

@@ -1,26 +0,0 @@
----
-id: rules.constitution.index
-owner: architect-agent
-version: 2.0.0
-severity: PERMANENT
-trigger: always_on
----
-# INDEX — Rules / Constitution
-## Objetivo
-Este fichero enumera todas las rules del dominio `constitution`.
-Los workflows y agentes **DEBEN** referenciar estas reglas
-por alias en lugar de rutas directas.
-## Aliases (YAML)
-```yaml
-constitution:
-  clean_code: .agent/rules/constitution/clean-code.md
-  agents_behavior: .agent/rules/constitution/agents-behavior.md
-  runtime_integration: .agent/rules/constitution/runtime-integration.md
-```
-## Reglas
-- Este índice **solo** declara reglas del dominio `constitution`.
-- Cualquier nueva regla del dominio **DEBE** añadirse aquí.

package/dist/agent/rules/constitution/runtime-integration.md DELETED Viewed

@@ -1,102 +0,0 @@
----
-id: constitution.runtime_integration
-owner: architect-agent
-version: 1.0.0
-severity: PERMANENT
-scope: global
----
-# RUNTIME INTEGRATION CONSTITUTION
-Este documento define las reglas obligatorias para la integración del runtime MCP en la ejecución de workflows.
----
-## 1. REGLA DE INTEGRACIÓN RUNTIME (PERMANENT - CRITICAL)
-Cuando cualquier agente ejecute un workflow del sistema (`init`, `tasklifecycle-short`, `tasklifecycle-long`), **DEBE** utilizar las herramientas del runtime MCP para garantizar trazabilidad y persistencia de estado.
-### 1.1 Herramientas Obligatorias
-| Evento | Herramienta MCP | Cuándo usar |
-|--------|-----------------|-------------|
-| Inicio de tarea | `runtime_run` | Al crear una nueva tarea |
-| Avance de fase | `runtime_advance_phase` | Al completar cada fase del ciclo |
-| Obtener estado | `runtime_get_state` | Para consultar el estado actual |
-| Validar gate | `runtime_validate_gate` | Antes de solicitar aprobación |
-| Evento importante | `runtime_emit_event` | Para eventos de chat, errores, etc. |
-### 1.2 Flujo Obligatorio
-```
-1. Al iniciar workflow:
-   → Llamar `runtime_run` con taskPath y agent
-2. Al completar cada fase:
-   → Llamar `runtime_validate_gate` para verificar precondiciones
-   → Solicitar aprobación al desarrollador (notify_user)
-   → Llamar `runtime_advance_phase` tras aprobación
-3. Durante la ejecución:
-   → Usar `runtime_emit_event` para eventos significativos
-   → Usar `runtime_get_state` para consultar estado si es necesario
-```
-### 1.3 Regla de Nulidad (Bypass Detection)
-Cualquier acción técnica de cambio de estado (creación de artefactos, avance de fase) realizada sin una llamada correspondiente registrada en el Runtime MCP será considerada **nula e inválida**.
-- La "Huella Digital de Gobernanza" (logs de `validate_gate` y `advance_phase`) generada mediante el **Skill de Gobernanza** es el único comprobante legal de cumplimiento de proceso.
-### 1.4 Skill de Gobernanza (Mejor Práctica)
-El uso del `skill.runtime-governance` es la **mejor práctica y el método obligatorio** para el `architect-agent`.
-- **Por qué**: Centraliza la complejidad técnica de las herramientas MCP y permite auditorías reactivas consistentes sin sobrecargar los archivos de workflow.
-- **Invocación**: Los workflows deben simplemente invocar la acción de control, y el Arquitecto debe proveer el "Cómo" mediante este Skill exclusivo.
-```
----
-## 2. REQUISITOS PREVIOS (PERMANENT)
-Para que esta constitución sea aplicable:
-1. El servidor MCP debe estar registrado en el cliente (Antigravity/Codex).
-   - Si no está registrado, ejecutar: `agentic-workflow register-mcp`
-2. El servidor MCP debe estar corriendo en background o ser invocable.
-### 2.1 Verificación de Registro
-Al iniciar cualquier workflow, el agente **DEBE** verificar que las herramientas del runtime están disponibles. Si no lo están:
-- Informar al desarrollador.
-- Sugerir ejecutar `agentic-workflow register-mcp`.
-- Continuar con ejecución fallback (sin runtime) si el desarrollador lo autoriza.
----
-## 3. LOGS Y TRAZABILIDAD (PERMANENT)
-Todas las llamadas al runtime generan logs en stderr. Estos logs son la **fuente de verdad** para auditar la ejecución de workflows.
-### 3.1 Formato de Logs
-```
-[LEVEL] [SOURCE] Message {context}
-```
-### 3.2 Herramienta de Debug
-- `debug_read_logs`: Permite leer los logs almacenados en el buffer del runtime.
----
-## 4. EXCEPCIONES (PERMANENT)
-Esta constitución **NO aplica** cuando:
-- El desarrollador solicita explícitamente ejecución sin runtime.
-- Las herramientas MCP no están disponibles y el desarrollador autoriza fallback.
-- Se trata de operaciones de solo lectura (consultas, investigación).
----
-## Authority
-Esta constitución es **binding** cuando referenciada como `INJECTED` o `PERMANENT`.
-Creada por: architect-agent
-Fecha: 2026-02-02

package/dist/agent/rules/index.md DELETED Viewed

@@ -1,70 +0,0 @@
----
-id: rules.index
-owner: architect-agent
-version: 1.0.3
-severity: PERMANENT
-trigger: always_on
----
-# INDEX — Rules
-## Objetivo
-Este fichero enumera los **dominios de rules contractuales** del proyecto
-y dónde están sus índices locales. Los workflows y agentes **DEBEN**
-referenciar estas reglas por alias.
-## Aliases (YAML)
-```yaml
-rules:
-  constitution:
-    index: .agent/rules/constitution/index.md
-  roles:
-    index: .agent/rules/roles/index.md
-```
----
-## Reglas Globales (PERMANENT)
-### Comportamiento e Identificación de Agentes
-**Severidad**: PERMANENT
-**Alcance**: Todos los agentes
-**NUNCA puede ocurrir una respuesta sin identificación.** Todos los agentes deben comenzar sus mensajes con su icono y nombre en negrita: `<icono> **<nombre-agente>**`, salvo la excepcion de compatibilidad definida en `constitution.agents_behavior`.
-Esta regla es el pilar de la trazabilidad y su incumplimiento invalida la respuesta.
-Referencia completa: `constitution.agents_behavior`
-### Modificación de Reglas - Autoridad Exclusiva del Architect
-**Severidad**: PERMANENT
-**Alcance**: Todos los agentes
-**Solo el 🏛️ architect-agent puede modificar archivos de reglas.**
-Archivos protegidos:
-- `.agent/rules/**/*.md` (todas las reglas)
-- `.agent/workflows/**/*.md` (todos los workflows)
-- `.agent/index.md`
-**Prohibiciones**:
-- ❌ Ningún agente (qa, researcher, neo) puede modificar reglas
-- ❌ Ningún agente puede modificar workflows
-- ❌ Ningún agente puede modificar índices
-**Excepciones**:
-- ✅ El architect-agent puede modificar cualquier regla
-- ✅ Los agentes pueden **proponer** cambios en sus informes
-- ✅ El desarrollador puede solicitar cambios explícitamente
-**Violación**:
-Si un agente modifica una regla sin autorización:
-1. El cambio DEBE revertirse inmediatamente
-2. El architect-agent DEBE documentar la violación
-3. El agente DEBE ser reactivado con la regla reforzada
----
-## Reglas de Índice
-- Este índice **solo** declara dominios de rules.
-- Cada dominio **DEBE** tener su propio `index.md`.

package/dist/agent/rules/roles/index.md DELETED Viewed

@@ -1,44 +0,0 @@
----
-id: rules.roles.index
-owner: architect-agent
-version: 1.0.1
-severity: PERMANENT
-trigger: always_on
----
-# INDEX — Rules / Roles
-## Objetivo
-Este fichero enumera todas las rules del dominio `roles`.
-Los workflows/agentes **DEBEN** referenciar estas reglas
-por alias en lugar de rutas directas.
-## Reglas Globales (PERMANENT)
-### Comportamiento e Identificación de Agentes
-**Severidad**: PERMANENT
-**Alcance**: Todos los roles
-Todos los agentes DEBEN seguir estrictamente las normas de identificación e interacción definidas en:
-`constitution.agents_behavior`
-**Resumen**:
-- Identificación obligatoria mediante `<icono> **<nombre-agente>**`, con la excepcion de compatibilidad definida en `constitution.agents_behavior`.
-- Solo el Architect puede modificar reglas.
-- QA no implementa código funcional.
----
-## Aliases (YAML)
-```yaml
-roles:
-  architect: .agent/rules/roles/architect.md
-  qa: .agent/rules/roles/qa.md
-  researcher: .agent/rules/roles/researcher.md
-  neo: .agent/rules/roles/neo.md
-```
-## Reglas
-- Este índice **solo** declara reglas del dominio `roles`.
-- Cada nuevo rol **DEBE** añadirse aquí antes de ser utilizado.
-- Cada rol **DEBE** incluir la regla de prefijo obligatorio en su definición.

package/dist/agent/skills/index.md DELETED Viewed

@@ -1,23 +0,0 @@
----
-id: skills.index
-owner: architect-agent
-version: 1.0.0
-severity: PERMANENT
----
-# INDEX — Skills
-## Objetivo
-Este fichero enumera los **skills (habilidades)** disponibles en el sistema.
-Los agentes **DEBEN** referenciar estas habilidades por alias.
-## Aliases (YAML)
-```yaml
-skills:
-  runtime-governance: .agent/skills/runtime-governance/SKILL.md
-```
-## Reglas
-- Este índice solo declara skills del sistema.
-- Cada skill debe estar en su propia carpeta en `.agent/skills/`.
-- Cualquier nuevo skill **DEBE** añadirse aquí antes de ser referenciado.