wegho-agentes 4.0.1

package/docs/LEARNING_SYSTEM.md

@@ -0,0 +1,326 @@
+# Sistema de Agentes com Aprendizado Contínuo
+
+## 🎯 Visão Geral
+
+Sistema inteligente onde cada agente possui memória persistente, aprende com sucessos e falhas, e o orquestrador seleciona os melhores agentes baseado em histórico de performance.
+
+## 🚀 Início Rápido
+
+### 1. Instalação
+
+```bash
+# Já incluído no sistema de agentes
+cd seu-projeto
+node .agents/test-init-context.js
+```
+
+### 2. Uso Básico
+
+```javascript
+const { IntelligentOrchestrator } = require('./.agents/orchestrator');
+const { ContextLoader } = require('./.agents/context-loader');
+
+// Carregar contexto
+const contextLoader = new ContextLoader();
+const context = await contextLoader.loadContext();
+
+// Criar orquestrador
+const orchestrator = new IntelligentOrchestrator(context);
+
+// Executar tarefa
+const result = await orchestrator.orchestrateTask(
+    'Criar componente de login com validação'
+);
+
+// Fornecer feedback
+await orchestrator.provideFeedback(result.taskId, 'frontend-agent', {
+    satisfied: true,
+    likes: ['Validação implementada', 'Acessibilidade OK'],
+    dislikes: [],
+    suggestions: ['Adicionar animações']
+});
+```
+
+## 📁 Estrutura de Memória
+
+```
+.agents/memory/
+├── frontend-agent/
+│   ├── specialty.md          # Especialidade e responsabilidades
+│   ├── successes.json        # Histórico de sucessos
+│   ├── failures.json         # Histórico de falhas
+│   └── learnings.json        # Padrões aprendidos
+├── security-agent/
+│   └── ...
+└── ...
+```
+
+## 🧠 Como Funciona o Aprendizado
+
+### 1. Registro Automático
+
+Cada vez que um agente executa uma tarefa:
+- ✅ **Sucesso**: Registrado em `successes.json`
+- ❌ **Falha**: Registrado em `failures.json`
+
+### 2. Feedback do Usuário
+
+Após cada tarefa, você pode fornecer feedback:
+
+```javascript
+await orchestrator.provideFeedback(taskId, agentName, {
+    satisfied: true,
+    likes: ['Feature X', 'Implementação Y'],
+    dislikes: ['Problema Z'],
+    suggestions: ['Melhorar W']
+});
+```
+
+### 3. Geração de Aprendizados
+
+O sistema analisa feedback e gera aprendizados:
+- **Padrões positivos**: "Repetir: Feature X"
+- **Padrões negativos**: "Evitar: Problema Z"
+- **Sugestões**: "Considerar: Melhorar W"
+
+### 4. Aplicação em Tarefas Futuras
+
+Em tarefas similares, agentes:
+- 🔍 Consultam memória para casos parecidos
+- 💡 Aplicam recomendações aprendidas
+- ⚠️ Alertam sobre padrões problemáticos
+
+## 🎯 Orquestrador Inteligente
+
+### Seleção Baseada em Performance
+
+O orquestrador analisa histórico de cada agente:
+
+```
+📊 frontend-agent:
+   Taxa de sucesso: 85.5%
+   Total de tarefas: 23
+   ✅ Selecionado (alta confiança)
+
+📊 security-agent:
+   Taxa de sucesso: 92.1%
+   Total de tarefas: 38
+   ✅ Selecionado (alta confiança)
+```
+
+### Escalação Inteligente
+
+1. **Análise da Tarefa**: Identifica áreas envolvidas
+2. **Seleção de Agentes**: Escolhe melhores baseado em histórico
+3. **Distribuição**: Atribui subtarefas específicas
+4. **Execução**: Agentes trabalham com memória
+5. **Feedback**: Coleta resultados e aprende
+
+## 📊 Exemplos de Uso
+
+### Exemplo 1: Componente com Validação
+
+```javascript
+const result = await orchestrator.orchestrateTask(
+    'Criar componente de formulário com validação Zod e estados de loading/error'
+);
+
+// Agentes selecionados:
+// - frontend-agent: Validar UI/UX e estados
+// - security-agent: Verificar validação de inputs
+// - architecture-agent: Garantir estrutura < 500 linhas
+```
+
+### Exemplo 2: Feedback Positivo
+
+```javascript
+await orchestrator.provideFeedback(result.taskId, 'frontend-agent', {
+    satisfied: true,
+    likes: [
+        'Estados de loading/error implementados',
+        'Validação com Zod',
+        'Acessibilidade com aria-labels'
+    ],
+    dislikes: [],
+    suggestions: ['Adicionar testes unitários']
+});
+
+// Aprendizados gerados:
+// ✅ "Repetir: Estados de loading/error implementados"
+// ✅ "Repetir: Validação com Zod"
+// ✅ "Repetir: Acessibilidade com aria-labels"
+// 💡 "Sugestão: Adicionar testes unitários"
+```
+
+### Exemplo 3: Feedback Negativo
+
+```javascript
+await orchestrator.provideFeedback(result.taskId, 'security-agent', {
+    satisfied: false,
+    likes: [],
+    dislikes: [
+        'Não detectou falta de sanitização',
+        'Permitiu uso de dangerouslySetInnerHTML'
+    ],
+    suggestions: ['Adicionar verificação de DOMPurify']
+});
+
+// Aprendizados gerados:
+// ❌ "Evitar: Não detectou falta de sanitização"
+// ❌ "Evitar: Permitiu uso de dangerouslySetInnerHTML"
+// 💡 "Sugestão: Adicionar verificação de DOMPurify"
+```
+
+## 🔧 Configuração
+
+### Habilitar/Desabilitar Memória
+
+```typescript
+// .agents/config.ts
+export const DEFAULT_CONFIG: AgentConfig = {
+    // ...
+    memoryEnabled: true,           // Habilitar sistema de memória
+    memoryPath: '.agents/memory',  // Caminho da memória
+    feedbackEnabled: true,          // Habilitar coleta de feedback
+    autoLearn: false,               // Requerer aprovação manual
+    maxMemoryEntries: 1000,         // Limite de entradas
+};
+```
+
+### Aprendizado Automático vs Manual
+
+- **Manual** (`autoLearn: false`): Requer aprovação para cada aprendizado
+- **Automático** (`autoLearn: true`): Aprende automaticamente com feedback
+
+## 📈 Relatórios
+
+### Ver Feedback de um Agente
+
+```javascript
+const report = orchestrator.getFeedbackReport('frontend-agent');
+console.log(report);
+```
+
+Saída:
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📊 RELATÓRIO DE FEEDBACK - frontend-agent
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📈 Estatísticas:
+   Total de tarefas: 23
+   Taxa de sucesso: 85.5%
+
+👍 O que os usuários mais gostam:
+   1. Estados de loading/error implementados
+   2. Validação com Zod
+   3. Acessibilidade com aria-labels
+
+👎 O que os usuários não gostam:
+   1. Falta de testes unitários
+   2. Componentes muito grandes
+
+💡 Sugestões recorrentes:
+   1. Adicionar testes unitários
+   2. Dividir componentes grandes
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## 🎓 Melhores Práticas
+
+### 1. Forneça Feedback Específico
+
+❌ **Ruim**:
+```javascript
+likes: ['Bom trabalho']
+```
+
+✅ **Bom**:
+```javascript
+likes: [
+    'Validação de email com regex correto',
+    'Estados de loading implementados',
+    'Acessibilidade com ARIA'
+]
+```
+
+### 2. Seja Consistente
+
+- Forneça feedback para todas as tarefas importantes
+- Use terminologia consistente
+- Seja específico sobre o que gostou/não gostou
+
+### 3. Monitore Aprendizados
+
+```javascript
+// Ver aprendizados periodicamente
+const report = orchestrator.getFeedbackReport('frontend-agent');
+console.log(report);
+```
+
+### 4. Limpe Memória Antiga
+
+```javascript
+// Memória é limitada a maxMemoryEntries (padrão: 1000)
+// Entradas mais antigas são removidas automaticamente
+```
+
+## 🚨 Troubleshooting
+
+### Memória não está sendo salva
+
+1. Verificar permissões da pasta `.agents/memory/`
+2. Verificar se `memoryEnabled: true` em config
+3. Verificar logs de erro
+
+### Agentes não estão aprendendo
+
+1. Verificar se está fornecendo feedback
+2. Verificar se `feedbackEnabled: true`
+3. Ver arquivos `learnings.json` para confirmar
+
+### Performance lenta
+
+1. Reduzir `maxMemoryEntries` em config
+2. Limpar memória antiga manualmente
+3. Desabilitar memória para tarefas simples
+
+## 📚 Arquivos de Especialidade
+
+Cada agente tem um arquivo `specialty.md` que define:
+- Responsabilidades
+- Expertise
+- Regras
+- Tarefas típicas
+
+Exemplo: `.agents/memory/frontend-agent/specialty.md`
+
+## 🔄 Fluxo Completo
+
+```
+1. Usuário solicita tarefa
+   ↓
+2. Orquestrador analisa tarefa
+   ↓
+3. Seleciona melhores agentes (baseado em histórico)
+   ↓
+4. Agentes consultam memória
+   ↓
+5. Agentes executam com recomendações
+   ↓
+6. Resultados são registrados
+   ↓
+7. Usuário fornece feedback
+   ↓
+8. Sistema gera aprendizados
+   ↓
+9. Próxima tarefa usa aprendizados
+```
+
+## 🎉 Benefícios
+
+- ✅ **Aprendizado Contínuo**: Agentes melhoram com o tempo
+- ✅ **Seleção Inteligente**: Melhores agentes para cada tarefa
+- ✅ **Evita Erros**: Aprende com falhas passadas
+- ✅ **Personalização**: Adapta-se ao seu estilo
+- ✅ **Transparência**: Histórico completo de decisões

package/docs/SYMBOLS_TREE.md

@@ -0,0 +1,182 @@
+# Árvore de Símbolos do Projeto
+
+**Última atualização**: 2026-01-20 10:10  
+**Versão**: 1.0.0
+
+Esta árvore mapeia a estrutura hierárquica de componentes, hooks, tipos e serviços do projeto.
+
+---
+
+## 📁 Estrutura de Diretórios
+
+```
+app/
+├── (auth)/
+│   ├── login/
+│   │   └── page.tsx → LoginPage
+│   └── layout.tsx → AuthLayout
+├── (dashboard)/
+│   ├── page.tsx → DashboardPage
+│   ├── production/
+│   │   └── page.tsx → ProductionPage
+│   ├── orders/
+│   │   └── page.tsx → OrdersPage
+│   ├── weighing/
+│   │   └── page.tsx → WeighingPage
+│   ├── financial/
+│   │   └── page.tsx → FinancialPage
+│   └── layout.tsx → DashboardLayout
+└── layout.tsx → RootLayout
+```
+
+---
+
+## 🧩 Componentes
+
+### UI Primitives (`components/ui/`)
+Componentes base do shadcn/ui:
+- `Button` - Botão com variantes (default, outline, ghost, destructive, link)
+- `Input` - Campo de entrada de texto
+- `Card`, `CardHeader`, `CardContent`, `CardFooter` - Container de conteúdo
+- `Dialog`, `DialogTrigger`, `DialogContent` - Modal/Dialog
+- `Label` - Label para inputs
+- `Table`, `TableHeader`, `TableBody`, `TableRow`, `TableCell` - Tabela
+- `Select`, `SelectTrigger`, `SelectContent`, `SelectItem` - Dropdown
+- `Tabs`, `TabsList`, `TabsTrigger`, `TabsContent` - Abas
+
+### Common Components (`components/common/`)
+Componentes reutilizáveis globais:
+- `Header` - Cabeçalho do dashboard
+- `Footer` - Rodapé (se existir)
+- `Sidebar` - Menu lateral de navegação
+- `LoadingSpinner` - Indicador de loading
+- `ErrorBoundary` - Tratamento de erros React
+
+### Page Components (`components/pages/`)
+Componentes específicos de páginas:
+- `DashboardView` - Visão geral do dashboard
+- `ProductionView` - Gestão de produção
+- `OrdersView` - Gestão de pedidos
+- `WeighingView` - Sistema de pesagem
+- `FinancialView` - Gestão financeira
+
+### Feature Components
+Componentes específicos por funcionalidade:
+- **Production** (`components/production/`)
+  - `ProductionEventForm` - Formulário de eventos de produção
+  - `ProductionEventTable` - Tabela de eventos
+  - `PlantProductionCard` - Card de produção da planta
+  
+- **Orders** (`components/orders/`)
+  - `OrderForm` - Formulário de pedidos
+  - `OrderTable` - Tabela de pedidos
+  - `OrderDetailsModal` - Modal de detalhes
+  
+- **Weighing** (`components/weighing/`)
+  - `WeighingForm` - Formulário de pesagem
+  - `WeighingHistory` - Histórico de pesagens
+
+---
+
+## 🪝 Hooks Customizados
+
+### Global Hooks (`hooks/`)
+- `useAppCrud` - CRUD genérico para qualquer tabela Supabase
+  - **Funções**: `handleAdd`, `handleUpdate`, `handleDelete`
+  - **Estados**: `loading`, `error`
+  
+- `useAuth` - Gerenciamento de autenticação
+  - **Funções**: `signIn`, `signOut`, `signUp`
+  - **Estados**: `user`, `session`, `loading`
+  
+- `useAppLogic` - Lógica de negócio principal
+  - **Dados**: `orders`, `productionEvents`, `miningCycles`, `plantLogs`
+  - **Refreshers**: `refreshOrders`, `refreshProductionEvents`, etc.
+
+### Feature Hooks
+- `usePlantProduction` (`hooks/usePlantProduction.ts`) - Lógica de produção da planta
+- `useOrderManagement` - Lógica de gestão de pedidos
+- `useWeighing` - Lógica de pesagem
+
+---
+
+## 🛠 Services & APIs
+
+### Supabase (`utils/supabase/`)
+- `client.ts` - Cliente Supabase (browser)
+- `server.ts` - Cliente Supabase (server-side)
+
+### API Clients (`services/`)
+- `orders.ts` - Funções de API para pedidos
+- `production.ts` - Funções de API para produção
+- `weighing.ts` - Funções de API para pesagem
+- `financial.ts` - Funções de API para financeiro
+
+---
+
+## 📊 Types & Interfaces
+
+### Database Types (`types/database.ts`)
+Tipos gerados do Supabase:
+- Todas as tabelas do banco de dados
+
+### Domain Types (`types/`)
+- `Order` - Pedido
+- `ProductionEvent` - Evento de produção
+- `MiningCycle` - Ciclo de mineração
+- `PlantLog` - Log da planta
+- `WeighingRecord` - Registro de pesagem
+
+---
+
+## 🔧 Utilitários
+
+### Helpers (`lib/`)
+- `utils.ts` - Funções utilitárias gerais (ex: `cn()` para classes)
+- `format.ts` - Formatação de datas, números, moeda
+- `validation.ts` - Schemas de validação Zod
+
+### Constants (`constants/`)
+- `TABLE_NAMES` - Nomes das tabelas do Supabase
+  ```ts
+  {
+    orders: 'orders',
+    production_events: 'production_events',
+    mining_cycles: 'mining_cycles',
+    plant_logs: 'plant_logs'
+  }
+  ```
+- `ROLES` - Papéis de usuários
+- `STATUS` - Status de pedidos, produção, etc.
+
+---
+
+## 🗃 Schemas Supabase
+
+### Tabelas Principais
+- `orders` - Pedidos expedidos
+- `production_events` - Eventos de produção
+- `mining_cycles` - Ciclos de mineração
+- `plant_logs` - Logs da planta
+- `weighing_records` - Registros de pesagem
+- `users` - Usuários do sistema
+- `profiles` - Perfis de usuários
+
+### Views
+- (Se houver views, listar aqui)
+
+### Functions
+- (Se houver functions, listar aqui)
+
+---
+
+## 📝 Notas
+
+- Esta árvore é atualizada automaticamente pelo **Agente de Documentação**
+- Ao adicionar novos componentes/hooks/services, eles devem ser registrados aqui
+- Manter sincronizado com a estrutura real do código
+
+---
+
+**Gerado por**: Documentation Agent  
+**Próxima atualização**: Após próximo build

package/docs/VERSION.md

@@ -0,0 +1,6 @@
+# Version History
+
+| Version | Date | Build | Description | Author |
+|:---:|:---:|:---:|:---|:---:|
+| 0.0.1 | 2026-01-09 | 2 | Fix Orders View "Green Screen" crash by adding safety guards to property accesses. | AI Agent |
+| 0.0.0 | 2026-01-08 | 1 | Initial audit and global rules implementation start. | AI Agent |

package/docs/architecture.md

@@ -0,0 +1,111 @@
+# Architecture: Triunfo Mineração - KP Fértil
+
+> [!IMPORTANT]
+> This document is the **Source of Truth (SOT)** for the application's architecture. Any major changes to hooks, services, pages, or database tables must be reflected here.
+
+## Navigation & Routes
+
+| View | Component | Description |
+| :--- | :--- | :--- |
+| `HOME` | `HomeView` | Welcome screen with quick access modules. |
+| `DASHBOARD` | `Dashboard` | Admin control panel, metrics, and data management. |
+| `CLIENTS` | `ClientsView` | Customer list and location management. |
+| `ORDERS` | `OrdersView` | **(Current Focus)** Order management and tracking. |
+| `WEIGHING` | `WeighingView` | Balance records and dispatch control. |
+| `SCHEDULING` | `SchedulingView` | Loading schedules and logistics. |
+| `GATE` | `GateView` | Security/Gate control for truck entry. |
+| `FINANCIAL` | `FinancialView` | Billing and accounting integration. |
+| `MY_ACCOUNT` | `MyAccountView` | User profile and preferences. |
+
+---
+
+## Current Architecture (Monolith)
+
+The application currently operates as a feature-rich monolith where `App.tsx` manages the majority of the global state and logic, distributing it via props to lazy-loaded views.
+
+```mermaid
+graph TD
+    App[App.tsx (God Component)]
+    App -->|Props: products, users...| Dashboard
+    App -->|Props: clients, orders...| ClientsView
+    App -->|Props: orders...| OrdersView
+    App -->|Props: records...| WeighingView
+
+    App --Owns--> State[Global State (All Data)]
+    App --Owns--> Logic[Business Logic & Handlers]
+    App --Owns--> Fetch[useSupabaseTable (Internal Hook)]
+
+    subgraph Services
+        Supabase[Supabase Client]
+    end
+
+    App --> Supabase
+```
+
+## Target Architecture (Modular)
+
+Transitioning towards a context-based and hook-driven architecture to improve maintainability and performance.
+
+```mermaid
+graph TD
+    Root[App.tsx (Router/Layout)]
+
+    subgraph Contexts
+        AuthCtx[AuthContext]
+        DataCtx[DataContext]
+    end
+
+    subgraph Hooks
+        useAuth
+        useSupabaseTable
+        useOrders
+        useClients
+    end
+
+    Root --> AuthCtx
+    Root --> DataCtx
+
+    DataCtx --> useSupabaseTable
+
+    Dashboard --> useOrders
+    ClientsView --> useClients
+
+    subgraph Dashboard_Module
+        Dashboard[Dashboard (Main)]
+        
+        subgraph Dashboard_Hooks
+            useRegistration
+            useReports
+            useInvoices
+            useMaintenance
+            useLinkMapping
+            useHistory
+        end
+        
+        Dashboard --> useRegistration
+        Dashboard --> useReports
+        Dashboard --> useInvoices
+        Dashboard --> useMaintenance
+        Dashboard --> useLinkMapping
+        Dashboard --> useHistory
+
+        Dashboard --> AnalyticsTab[AnalyticsTab]
+        Dashboard --> ReportsTab[ReportsTab]
+        Dashboard --> SettingsTab[SettingsTab]
+        
+        Dashboard --> RegistrationTabs[Registration Tabs (Products, Users, etc.)]
+        RegistrationTabs --> GenericRegistrationTab
+        
+        AnalyticsTab --> AnalyticsCards[cards/AnalyticsCards]
+        AnalyticsTab --> AnalyticsCharts[charts/AnalyticsCharts]
+        AnalyticsTab --> SalespersonTable[analytics/SalespersonTable]
+    end
+```
+
+---
+
+## Database & Sync
+
+- **Service**: Supabase (PostgreSQL).
+- **Sync**: `useSyncQueue` handles offline operations and synchronization.
+- **Policies**: Row Level Security (RLS) is applied to all sensitive tables.

package/package.json

@@ -0,0 +1,60 @@
+{
+    "name": "wegho-agentes",
+    "version": "4.0.1",
+    "description": "Sistema de agentes especializados para Next.js + Supabase com validação automática de qualidade, segurança e arquitetura",
+    "main": ".agents/cli.js",
+    "bin": {
+        "wegho-agentes": ".agents/cli.js"
+    },
+    "scripts": {
+        "init": "npx tsx .agents/init.ts",
+        "install-agents": "node .agents/install.js",
+        "test": "jest",
+        "test:watch": "jest --watch",
+        "test:coverage": "jest --coverage",
+        "agent": "node .agents/cli.js"
+    },
+    "keywords": [
+        "agents",
+        "nextjs",
+        "supabase",
+        "typescript",
+        "validation",
+        "security",
+        "architecture",
+        "quality",
+        "code-quality",
+        "automation"
+    ],
+    "author": "Caleb Cordeirinho <cordeirinhocaleb@gmail.com>",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/cordeirinhocaleb/wegho-agentes.git"
+    },
+    "engines": {
+        "node": ">=18.0.0"
+    },
+    "peerDependencies": {
+        "typescript": "^5.0.0"
+    },
+    "devDependencies": {
+        "@types/jest": "^30.0.0",
+        "@types/node": "^25.0.10",
+        "jest": "^30.2.0",
+        "ts-jest": "^29.4.6"
+    },
+    "files": [
+        ".agents/**/*",
+        "docs/**/*",
+        "README.md",
+        "INSTALL.md",
+        "LICENSE"
+    ],
+    "publishConfig": {
+        "access": "public"
+    },
+    "dependencies": {
+        "glob": "^13.0.0"
+    }
+}