wegho-agentes 7.0.3 → 7.0.6

package/.agents/core/skill-manager.md

@@ -0,0 +1,36 @@
+# skill-manager.ts
+
+> Arquivo fonte: `.agents/core/skill-manager.ts`
+
+## O que este arquivo faz
+Este arquivo expõe lógica reutilizável para outras partes do sistema, centralizando comportamento, configuração ou execução especializada.
+
+## Principais Responsabilidades
+- Expor 3 item(ns) reutilizável(is) para outras partes do sistema.
+- Definir classes ou estruturas centrais para encapsular comportamento.
+- Concentrar funções que executam a lógica principal deste arquivo.
+- Servir como ponto de manutenção para esta parte da funcionalidade.
+
+## Como funciona
+1. Carrega definições locais e dependências necessárias.
+2. Expõe a interface pública consumida por outros arquivos do projeto.
+3. Executa etapas assíncronas quando precisa consultar arquivos, serviços ou processos externos.
+4. Processa a responsabilidade principal do arquivo e retorna ou aplica o resultado esperado.
+5. Entrega a saída esperada para os consumidores diretos deste arquivo.
+
+## Dependências
+- fs
+- path
+- embeddings
+
+## Integrações
+- Sistema de arquivos
+
+## Segurança
+- Não há controle de segurança explícito neste arquivo; a proteção depende das camadas consumidoras e das regras globais do sistema.
+
+## Impacto da Remoção
+Sem este arquivo, consumidores diretos perdem a lógica ou a configuração que ele centraliza, causando erro funcional ou regressão de comportamento.
+
+## Resumo Técnico
+Arquivo técnico de suporte ao sistema, responsável por fornecer lógica, configuração ou interface reutilizável para outros módulos.

package/.agents/core/stack-boundary-agent.md

@@ -0,0 +1,38 @@
+# stack-boundary-agent.ts
+
+> Arquivo fonte: `.agents/core/stack-boundary-agent.ts`
+
+## O que este arquivo faz
+Este arquivo expõe lógica reutilizável para outras partes do sistema, centralizando comportamento, configuração ou execução especializada.
+
+## Principais Responsabilidades
+- Expor 1 item(ns) reutilizável(is) para outras partes do sistema.
+- Definir classes ou estruturas centrais para encapsular comportamento.
+- Concentrar funções que executam a lógica principal deste arquivo.
+- Servir como ponto de manutenção para esta parte da funcionalidade.
+
+## Como funciona
+1. Carrega definições locais e dependências necessárias.
+2. Expõe a interface pública consumida por outros arquivos do projeto.
+3. Executa etapas assíncronas quando precisa consultar arquivos, serviços ou processos externos.
+4. Processa a responsabilidade principal do arquivo e retorna ou aplica o resultado esperado.
+5. Entrega a saída esperada para os consumidores diretos deste arquivo.
+
+## Dependências
+- ./base-agent.js
+- fs
+- path
+- glob
+
+## Integrações
+- Supabase
+- Sistema de arquivos
+
+## Segurança
+- Não há controle de segurança explícito neste arquivo; a proteção depende das camadas consumidoras e das regras globais do sistema.
+
+## Impacto da Remoção
+Sem este arquivo, consumidores diretos perdem a lógica ou a configuração que ele centraliza, causando erro funcional ou regressão de comportamento.
+
+## Resumo Técnico
+Arquivo técnico de suporte ao sistema, responsável por fornecer lógica, configuração ou interface reutilizável para outros módulos.

package/.agents/core/testing-agent.md

@@ -0,0 +1,33 @@
+# testing-agent.ts
+
+> Arquivo fonte: `.agents/core/testing-agent.ts`
+
+## O que este arquivo faz
+Este arquivo expõe lógica reutilizável para outras partes do sistema, centralizando comportamento, configuração ou execução especializada.
+
+## Principais Responsabilidades
+- Expor 1 item(ns) reutilizável(is) para outras partes do sistema.
+- Definir classes ou estruturas centrais para encapsular comportamento.
+- Servir como ponto de manutenção para esta parte da funcionalidade.
+
+## Como funciona
+1. Carrega definições locais e dependências necessárias.
+2. Expõe a interface pública consumida por outros arquivos do projeto.
+3. Executa etapas assíncronas quando precisa consultar arquivos, serviços ou processos externos.
+4. Processa a responsabilidade principal do arquivo e retorna ou aplica o resultado esperado.
+5. Entrega a saída esperada para os consumidores diretos deste arquivo.
+
+## Dependências
+- ./base-agent.js
+
+## Integrações
+- Não há integração externa explícita identificada neste arquivo.
+
+## Segurança
+- Não há controle de segurança explícito neste arquivo; a proteção depende das camadas consumidoras e das regras globais do sistema.
+
+## Impacto da Remoção
+Sem este arquivo, consumidores diretos perdem a lógica ou a configuração que ele centraliza, causando erro funcional ou regressão de comportamento.
+
+## Resumo Técnico
+Arquivo técnico de suporte ao sistema, responsável por fornecer lógica, configuração ou interface reutilizável para outros módulos.

package/.agents/core/ui-data-map-agent.md

@@ -0,0 +1,38 @@
+# ui-data-map-agent.ts
+
+> Arquivo fonte: `.agents/core/ui-data-map-agent.ts`
+
+## O que este arquivo faz
+Este arquivo expõe lógica reutilizável para outras partes do sistema, centralizando comportamento, configuração ou execução especializada.
+
+## Principais Responsabilidades
+- Expor 1 item(ns) reutilizável(is) para outras partes do sistema.
+- Definir classes ou estruturas centrais para encapsular comportamento.
+- Concentrar funções que executam a lógica principal deste arquivo.
+- Servir como ponto de manutenção para esta parte da funcionalidade.
+
+## Como funciona
+1. Carrega definições locais e dependências necessárias.
+2. Expõe a interface pública consumida por outros arquivos do projeto.
+3. Executa etapas assíncronas quando precisa consultar arquivos, serviços ou processos externos.
+4. Processa a responsabilidade principal do arquivo e retorna ou aplica o resultado esperado.
+5. Entrega a saída esperada para os consumidores diretos deste arquivo.
+
+## Dependências
+- ./base-agent.js
+- fs
+- path
+- glob
+
+## Integrações
+- HTTP APIs externas
+- Sistema de arquivos
+
+## Segurança
+- Não há controle de segurança explícito neste arquivo; a proteção depende das camadas consumidoras e das regras globais do sistema.
+
+## Impacto da Remoção
+Sem este arquivo, consumidores diretos perdem a lógica ou a configuração que ele centraliza, causando erro funcional ou regressão de comportamento.
+
+## Resumo Técnico
+Arquivo técnico de suporte ao sistema, responsável por fornecer lógica, configuração ou interface reutilizável para outros módulos.

package/.agents/core/uiux-agent.md

@@ -0,0 +1,35 @@
+# uiux-agent.ts
+
+> Arquivo fonte: `.agents/core/uiux-agent.ts`
+
+## O que este arquivo faz
+Este arquivo expõe lógica reutilizável para outras partes do sistema, centralizando comportamento, configuração ou execução especializada.
+
+## Principais Responsabilidades
+- Expor 1 item(ns) reutilizável(is) para outras partes do sistema.
+- Definir classes ou estruturas centrais para encapsular comportamento.
+- Servir como ponto de manutenção para esta parte da funcionalidade.
+
+## Como funciona
+1. Carrega definições locais e dependências necessárias.
+2. Expõe a interface pública consumida por outros arquivos do projeto.
+3. Executa etapas assíncronas quando precisa consultar arquivos, serviços ou processos externos.
+4. Processa a responsabilidade principal do arquivo e retorna ou aplica o resultado esperado.
+5. Entrega a saída esperada para os consumidores diretos deste arquivo.
+
+## Dependências
+- ./base-agent.js
+- fs
+- path
+
+## Integrações
+- Não há integração externa explícita identificada neste arquivo.
+
+## Segurança
+- Não há controle de segurança explícito neste arquivo; a proteção depende das camadas consumidoras e das regras globais do sistema.
+
+## Impacto da Remoção
+Sem este arquivo, consumidores diretos perdem a lógica ou a configuração que ele centraliza, causando erro funcional ou regressão de comportamento.
+
+## Resumo Técnico
+Arquivo técnico de suporte ao sistema, responsável por fornecer lógica, configuração ou interface reutilizável para outros módulos.

package/.agents/core/workflow-validator.md

@@ -0,0 +1,33 @@
+# workflow-validator.ts
+
+> Arquivo fonte: `.agents/core/workflow-validator.ts`
+
+## O que este arquivo faz
+Este arquivo expõe lógica reutilizável para outras partes do sistema, centralizando comportamento, configuração ou execução especializada.
+
+## Principais Responsabilidades
+- Expor 3 item(ns) reutilizável(is) para outras partes do sistema.
+- Definir classes ou estruturas centrais para encapsular comportamento.
+- Concentrar funções que executam a lógica principal deste arquivo.
+- Servir como ponto de manutenção para esta parte da funcionalidade.
+
+## Como funciona
+1. Carrega definições locais e dependências necessárias.
+2. Expõe a interface pública consumida por outros arquivos do projeto.
+3. Processa a responsabilidade principal do arquivo e retorna ou aplica o resultado esperado.
+4. Entrega a saída esperada para os consumidores diretos deste arquivo.
+
+## Dependências
+- Nenhuma dependência explícita identificada pelo gerador.
+
+## Integrações
+- Não há integração externa explícita identificada neste arquivo.
+
+## Segurança
+- Não há controle de segurança explícito neste arquivo; a proteção depende das camadas consumidoras e das regras globais do sistema.
+
+## Impacto da Remoção
+Sem este arquivo, consumidores diretos perdem a lógica ou a configuração que ele centraliza, causando erro funcional ou regressão de comportamento.
+
+## Resumo Técnico
+Arquivo técnico de suporte ao sistema, responsável por fornecer lógica, configuração ou interface reutilizável para outros módulos.

package/.agents/core/workflow-validator.ts

@@ -1,158 +1,98 @@
-/**
- * Workflow Validator - Garante que agentes sigam os 6 passos obrigatórios
- * 
- * Passos obrigatórios do AGENT_WORKFLOW.md:
- * 1. Consultar memória para casos similares
- * 2. Obter recomendações de aprendizados
- * 3. Consultar repositórios de referência relevantes
- * 4. Aplicar aprendizados com alta confiança (>0.7)
- * 5. Registrar resultado (sucesso ou falha)
- * 6. Gerar aprendizados baseado em feedback (opcional)
- */
-
-export interface WorkflowStep {
-    name: string;
-    required: boolean;
-    completed: boolean;
-    timestamp?: Date;
-    details?: any;
-}
-
-export interface WorkflowValidationResult {
-    compliant: boolean;
-    missingSteps: string[];
-    warnings: string[];
-    completedSteps: string[];
-    totalRequired: number;
-    totalCompleted: number;
-}
-
-export class WorkflowValidator {
-    /**
-     * Valida se um agente seguiu todos os passos obrigatórios
-     */
-    validateAgentExecution(agentName: string, executionLog: WorkflowStep[]): WorkflowValidationResult {
-        const requiredSteps = executionLog.filter(step => step.required);
-        const completedRequired = requiredSteps.filter(step => step.completed);
-        const missingSteps = requiredSteps
-            .filter(step => !step.completed)
-            .map(step => step.name);
-
-        const warnings: string[] = [];
-        const completedSteps = executionLog
-            .filter(step => step.completed)
-            .map(step => step.name);
-
-        // Verificar se passos foram executados na ordem correta
-        const expectedOrder = [
-            'Consultar Memória',
-            'Obter Recomendações',
-            'Consultar Repositórios',
-            'Aplicar Aprendizados',
-            'Registrar Resultado'
-        ];
-
-        const completedOrder = executionLog
-            .filter(step => step.completed && step.timestamp)
-            .sort((a, b) => a.timestamp!.getTime() - b.timestamp!.getTime())
-            .map(step => step.name);
-
-        // Verificar ordem (warning, não erro)
-        for (let i = 0; i < completedOrder.length - 1; i++) {
-            const currentIndex = expectedOrder.indexOf(completedOrder[i]);
-            const nextIndex = expectedOrder.indexOf(completedOrder[i + 1]);
-
-            if (currentIndex !== -1 && nextIndex !== -1 && currentIndex > nextIndex) {
-                warnings.push(
-                    `Passos executados fora de ordem: "${completedOrder[i]}" antes de "${completedOrder[i + 1]}"`
-                );
-            }
-        }
-
-        // Verificar se passos críticos foram pulados
-        const criticalSteps = ['Consultar Memória', 'Registrar Resultado'];
-        const missingCritical = criticalSteps.filter(
-            step => !completedSteps.includes(step)
-        );
-
-        if (missingCritical.length > 0) {
-            warnings.push(
-                `Passos críticos não executados: ${missingCritical.join(', ')}`
-            );
-        }
-
-        const compliant = missingSteps.length === 0;
-
-        return {
-            compliant,
-            missingSteps,
-            warnings,
-            completedSteps,
-            totalRequired: requiredSteps.length,
-            totalCompleted: completedRequired.length
-        };
-    }
-
-    /**
-     * Gera relatório detalhado de validação
-     */
-    generateValidationReport(agentName: string, validation: WorkflowValidationResult): string {
-        const lines: string[] = [];
-
-        lines.push(`\n━━━ Validação de Workflow: ${agentName} ━━━`);
-        lines.push(`Status: ${validation.compliant ? '✅ COMPLIANT' : '❌ NON-COMPLIANT'}`);
-        lines.push(`Passos Completados: ${validation.totalCompleted}/${validation.totalRequired}`);
-
-        if (validation.completedSteps.length > 0) {
-            lines.push(`\n✅ Passos Executados:`);
-            validation.completedSteps.forEach(step => {
-                lines.push(`   - ${step}`);
-            });
-        }
-
-        if (validation.missingSteps.length > 0) {
-            lines.push(`\n❌ Passos Faltantes:`);
-            validation.missingSteps.forEach(step => {
-                lines.push(`   - ${step}`);
-            });
-        }
-
-        if (validation.warnings.length > 0) {
-            lines.push(`\n⚠️  Avisos:`);
-            validation.warnings.forEach(warning => {
-                lines.push(`   - ${warning}`);
-            });
-        }
-
-        lines.push(`━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n`);
-
-        return lines.join('\n');
-    }
-
-    /**
-     * Valida múltiplos agentes e retorna resumo
-     */
-    validateMultipleAgents(
-        agentExecutions: Array<{ agentName: string; steps: WorkflowStep[] }>
-    ): {
-        allCompliant: boolean;
-        compliantCount: number;
-        nonCompliantCount: number;
-        details: Array<{ agentName: string; validation: WorkflowValidationResult }>;
-    } {
-        const details = agentExecutions.map(({ agentName, steps }) => ({
-            agentName,
-            validation: this.validateAgentExecution(agentName, steps)
-        }));
-
-        const compliantCount = details.filter(d => d.validation.compliant).length;
-        const nonCompliantCount = details.length - compliantCount;
-
-        return {
-            allCompliant: nonCompliantCount === 0,
-            compliantCount,
-            nonCompliantCount,
-            details
-        };
-    }
-}
+export interface WorkflowStep {
+    name: string;
+    required: boolean;
+    completed: boolean;
+    timestamp?: Date;
+    details?: any;
+}
+
+export interface WorkflowValidationResult {
+    compliant: boolean;
+    missingSteps: string[];
+    warnings: string[];
+    completedSteps: string[];
+    totalRequired: number;
+    totalCompleted: number;
+}
+
+export class WorkflowValidator {
+    validateAgentExecution(_agentName: string, executionLog: WorkflowStep[]): WorkflowValidationResult {
+        const requiredSteps = executionLog.filter((step) => step.required);
+        const completedRequired = requiredSteps.filter((step) => step.completed);
+        const missingSteps = requiredSteps.filter((step) => !step.completed).map((step) => step.name);
+        const completedSteps = executionLog.filter((step) => step.completed).map((step) => step.name);
+
+        const expectedOrder = [
+            'Validar Escopo',
+            'Consultar Repositórios',
+            'Carregar Skills',
+            'Executar Tarefa',
+            'Registrar Resultado',
+        ];
+
+        const warnings: string[] = [];
+        const completedOrder = executionLog
+            .filter((step) => step.completed && step.timestamp)
+            .sort((left, right) => left.timestamp!.getTime() - right.timestamp!.getTime())
+            .map((step) => step.name);
+
+        for (let index = 0; index < completedOrder.length - 1; index++) {
+            const currentIndex = expectedOrder.indexOf(completedOrder[index]);
+            const nextIndex = expectedOrder.indexOf(completedOrder[index + 1]);
+
+            if (currentIndex !== -1 && nextIndex !== -1 && currentIndex > nextIndex) {
+                warnings.push(`Passos executados fora de ordem: "${completedOrder[index]}" antes de "${completedOrder[index + 1]}"`);
+            }
+        }
+
+        return {
+            compliant: missingSteps.length === 0,
+            missingSteps,
+            warnings,
+            completedSteps,
+            totalRequired: requiredSteps.length,
+            totalCompleted: completedRequired.length,
+        };
+    }
+
+    generateValidationReport(agentName: string, validation: WorkflowValidationResult): string {
+        const lines: string[] = [];
+        lines.push(`\n--- Validação de Workflow: ${agentName} ---`);
+        lines.push(`Status: ${validation.compliant ? 'COMPLIANT' : 'NON-COMPLIANT'}`);
+        lines.push(`Passos Completados: ${validation.totalCompleted}/${validation.totalRequired}`);
+
+        if (validation.completedSteps.length > 0) {
+            lines.push('\nPassos Executados:');
+            validation.completedSteps.forEach((step) => lines.push(` - ${step}`));
+        }
+
+        if (validation.missingSteps.length > 0) {
+            lines.push('\nPassos Faltantes:');
+            validation.missingSteps.forEach((step) => lines.push(` - ${step}`));
+        }
+
+        if (validation.warnings.length > 0) {
+            lines.push('\nAvisos:');
+            validation.warnings.forEach((warning) => lines.push(` - ${warning}`));
+        }
+
+        return lines.join('\n');
+    }
+
+    validateMultipleAgents(agentExecutions: Array<{ agentName: string; steps: WorkflowStep[] }>) {
+        const details = agentExecutions.map(({ agentName, steps }) => ({
+            agentName,
+            validation: this.validateAgentExecution(agentName, steps),
+        }));
+
+        const compliantCount = details.filter((item) => item.validation.compliant).length;
+        const nonCompliantCount = details.length - compliantCount;
+
+        return {
+            allCompliant: nonCompliantCount === 0,
+            compliantCount,
+            nonCompliantCount,
+            details,
+        };
+    }
+}

package/.agents/domains/README.md

@@ -1,53 +1,10 @@
-# Agentes de Domínio
-
-Agentes especializados para diferentes domínios de negócio.
-
----
-
-## 📰 News Domain (Site de Notícias)
-
-### ✅ Implementados:
-- **cms-agent.ts** - Validação de artigos/posts
-- **seo-agent.ts** - Meta tags, structured data, sitemap
-
-### 🚧 Pendentes:
-- **content-agent.ts** - Qualidade de conteúdo, links quebrados
-- **analytics-agent.ts** - Métricas, dashboards, A/B tests
-
----
-
-## 🏭 Production Domain (Produção/Expedição)
-
-### ✅ Implementados:
-- **production-control-agent.ts** - Eventos, gargalos, fluxo
-
-### 🚧 Pendentes:
-- **quality-control-agent.ts** - Inspeções, não-conformidade
-- **shipping-agent.ts** - Pedidos expedidos, fretes
-- **inventory-agent.ts** - Estoque, níveis críticos
-
----
-
-## 🚚 Logistics Domain (Logística)
-
-### ✅ Implementados:
-- **route-agent.ts** - Rotas, distâncias, otimização
-
-### 🚧 Pendentes:
-- **fleet-agent.ts** - Frota, manutenção, documentos
-- **warehouse-agent.ts** - Armazéns, picking, packing
-- **tracking-agent.ts** - Rastreamento GPS em tempo real
-
----
-
-## 🔧 Como Adicionar Novo Agente
-
-1. Crie arquivo em `.agents/domains/{dominio}/{nome}-agent.ts`
-2. Implemente interface padrão com métodos `validate*`
-3. Adicione testes em `.agents/domains/{dominio}/tests/`
-4. Documente no README.md do domínio
-
----
-
-**Status**: 5/12 implementados (42%)  
-**Última atualização**: 2026-01-20
+# Agentes de Domínio
+
+## Implementados
+- `news/cms-agent.ts`
+- `news/seo-agent.ts`
+- `production/production-control-agent.ts`
+- `logistics/route-agent.ts`
+
+## Removido
+- agente legado de inventário

package/.agents/domains/logistics/route-agent.md

@@ -0,0 +1,34 @@
+# route-agent.ts
+
+> Arquivo fonte: `.agents/domains/logistics/route-agent.ts`
+
+## O que este arquivo faz
+Este arquivo expõe lógica reutilizável para outras partes do sistema, centralizando comportamento, configuração ou execução especializada.
+
+## Principais Responsabilidades
+- Expor 3 item(ns) reutilizável(is) para outras partes do sistema.
+- Definir classes ou estruturas centrais para encapsular comportamento.
+- Concentrar funções que executam a lógica principal deste arquivo.
+- Servir como ponto de manutenção para esta parte da funcionalidade.
+
+## Como funciona
+1. Carrega definições locais e dependências necessárias.
+2. Expõe a interface pública consumida por outros arquivos do projeto.
+3. Executa etapas assíncronas quando precisa consultar arquivos, serviços ou processos externos.
+4. Processa a responsabilidade principal do arquivo e retorna ou aplica o resultado esperado.
+5. Entrega a saída esperada para os consumidores diretos deste arquivo.
+
+## Dependências
+- ../../core/base-agent.js
+
+## Integrações
+- Não há integração externa explícita identificada neste arquivo.
+
+## Segurança
+- Não há controle de segurança explícito neste arquivo; a proteção depende das camadas consumidoras e das regras globais do sistema.
+
+## Impacto da Remoção
+Sem este arquivo, consumidores diretos perdem a lógica ou a configuração que ele centraliza, causando erro funcional ou regressão de comportamento.
+
+## Resumo Técnico
+Arquivo técnico de suporte ao sistema, responsável por fornecer lógica, configuração ou interface reutilizável para outros módulos.

package/.agents/domains/logistics/route-agent.ts

@@ -28,7 +28,7 @@ export interface Route {
 }
 
 export class RouteAgent extends BaseAgent {
-    constructor(memoryBasePath: string = '.agents/memory') {
+    constructor(memoryBasePath: string = '.agents/runtime') {
         super('route-agent', memoryBasePath);
     }
 

package/.agents/domains/news/cms-agent.md

@@ -0,0 +1,35 @@
+# cms-agent.ts
+
+> Arquivo fonte: `.agents/domains/news/cms-agent.ts`
+
+## O que este arquivo faz
+Este arquivo expõe lógica reutilizável para outras partes do sistema, centralizando comportamento, configuração ou execução especializada.
+
+## Principais Responsabilidades
+- Expor 2 item(ns) reutilizável(is) para outras partes do sistema.
+- Definir classes ou estruturas centrais para encapsular comportamento.
+- Concentrar funções que executam a lógica principal deste arquivo.
+- Servir como ponto de manutenção para esta parte da funcionalidade.
+
+## Como funciona
+1. Carrega definições locais e dependências necessárias.
+2. Expõe a interface pública consumida por outros arquivos do projeto.
+3. Executa etapas assíncronas quando precisa consultar arquivos, serviços ou processos externos.
+4. Processa a responsabilidade principal do arquivo e retorna ou aplica o resultado esperado.
+5. Entrega a saída esperada para os consumidores diretos deste arquivo.
+
+## Dependências
+- ../../core/base-agent.js
+
+## Integrações
+- Supabase
+
+## Segurança
+- Aplica ou referencia regras de RLS.
+- Inclui verificação ou dependência de autenticação/autorização.
+
+## Impacto da Remoção
+Sem este arquivo, consumidores diretos perdem a lógica ou a configuração que ele centraliza, causando erro funcional ou regressão de comportamento.
+
+## Resumo Técnico
+Arquivo técnico de suporte ao sistema, responsável por fornecer lógica, configuração ou interface reutilizável para outros módulos.

package/.agents/domains/news/cms-agent.ts

@@ -24,7 +24,7 @@ export interface Article {
 }
 
 export class CMSAgent extends BaseAgent {
-    constructor(memoryBasePath: string = '.agents/memory') {
+    constructor(memoryBasePath: string = '.agents/runtime') {
         super('cms-agent', memoryBasePath);
     }