wegho-agentes 7.0.4 → 7.0.6

package/docs/LEARNING_SYSTEM.md

@@ -1,326 +0,0 @@
-# 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/SYSTEM_FLOW_AUDIT.md

@@ -1,115 +0,0 @@
-# Auditoria de Fluxo do Sistema de Agents
-
-Gerado em: 2026-04-08
-
-## 1) Como o sistema comeca
-
-Entrada A (inicializacao):
-- Comando: `npm run init`
-- Arquivo de entrada: `.agents/init.ts`
-- Fluxo:
-  - Executa `install()` para preparar arquivos base.
-  - Inicializa agentes principais.
-  - Cria/mantem memoria em `.agents/memory`.
-  - Faz scan inicial com `InventoryAgent`.
-
-Entrada B (execucao por tarefa):
-- Comando: `npm run agent "descricao da tarefa"`
-- Arquivo de entrada: `.agents/cli.ts`
-- Fluxo:
-  - `main()` identifica que nao e comando `!`.
-  - Executa `initializeContext(true)` em `.agents/context-loader.ts`.
-  - Cria `IntelligentOrchestrator`.
-  - Chama `orchestrateTask(taskDescription)`.
-
-Entrada C (execucao por comando):
-- Comando: `npm run agent "!iniciar contexto"` (ou outros `!`)
-- Arquivo de entrada: `.agents/cli.ts`
-- Fluxo:
-  - `COMMANDS` roteia para handler.
-  - Ex.: `!iniciar contexto` chama `initializeContext(true)`.
-
-Entrada D (autonomo / Antigravity):
-- Workflow: `.agent/workflows/auto-run-orchestrator.md`
-- Runner: `.agents/auto-runner.ts`
-- Fluxo:
-  - Lê `docs/ANTIGRAVITY_TASKS.md`.
-  - Carrega contexto com `initializeContext(false)`.
-  - Chama `orchestrateTask` para cada tarefa.
-  - Fallback para tarefa padrao se nao houver fila.
-
-## 2) Por onde passa cada sistema
-
-### Contexto
-- Arquivo: `.agents/context-loader.ts`
-- Carrega:
-  - `docs/DESIGN_SYSTEM.md`
-  - `docs/SYMBOLS_TREE.md`
-  - `docs/BUILD_HISTORY.md`
-  - `docs/AGENT_RULES.md`
-- Detecta dominio com `detectDomain()` em `.agents/config.ts`.
-
-### Orquestracao
-- Arquivo: `.agents/orchestrator.ts`
-- Pipeline:
-  1. Analise da tarefa (`TaskAnalyzerAgent`)
-  2. Planejamento automatico (`PlanningAgent`)
-  3. Checkpoint (`CheckpointManager`)
-  4. Implementacao (`FileGenerator`)
-  5. Validacao automatica (`npm run validate`)
-  6. Selecao de agentes (com memoria e performance)
-  7. Execucao de agentes em paralelo + relatorio final GO/NO-GO
-
-### Roteamento de agentes
-- Arquivo: `.agents/task-analyzer-agent.ts`
-- Decide areas e agentes.
-- Inclui validacoes de stack e mapeamento quando aplicavel.
-
-### Memoria e aprendizado
-- Base: `.agents/core/base-agent.ts`
-- Persistencia: `.agents/core/memory-system.ts`
-- Feedback: `.agents/core/feedback-collector.ts`
-
-### Sistema de mapeamento de paginas
-- Arquivo: `.agents/core/ui-data-map-agent.ts`
-- Saidas:
-  - `docs/UI_DATA_MAP_REPORT.md`
-  - `docs/ui-maps/*.md`
-  - `docs/ui-maps/INDEX.md`
-  - `docs/mapsite/MAPSITE.md`
-  - `docs/mapsite/INDEX.md`
-  - `docs/mapsite/modules/*.md`
-
-### Regra de fronteira de stack
-- Arquivo: `.agents/core/stack-boundary-agent.ts`
-- Regra:
-  - TS/TSX apenas front-end.
-  - Dados para banco via PHP.
-
-## 3) O que era teste/artefato e foi excluido
-
-Removidos nesta limpeza:
-- Pasta `.lixo/`
-- Pasta `artifacts/`
-- Pasta `test-esm/`
-- Arquivo `.agents/example-learning-system.ts`
-- Testes internos em `.agents/core/*.test.ts`
-- Relatorios temporarios:
-  - `docs/AUDIT_REPORT.md`
-  - `docs/CLEANUP_REPORT.md`
-- `example-project/` (ja havia sido removido antes desta auditoria)
-
-## 4) O que permanece como nucleo
-
-- `.agents/` (orquestracao, agentes, memoria, seguranca, validacao)
-- `.agent/` (workflows/skills para Antigravity)
-- `docs/` (regras e documentacao do sistema)
-- `skills/` (base de skills operacionais)
-- `scripts/` (scripts auxiliares)
-- `package.json`, `package-lock.json`, `tsconfig.json`
-
-## 5) Observacao tecnica
-
-Existe worktree com varias alteracoes locais em arquivos de sistema.
-Esta auditoria documenta o fluxo e removeu artefatos de teste, mas nao
-reverteu mudancas de funcionalidade ja existentes.

package/skills/loki-mode/.github/workflows/claude-code-review.yml

@@ -1,57 +0,0 @@
-name: Claude Code Review
-
-on:
-  pull_request:
-    types: [opened, synchronize]
-    # Optional: Only run on specific file changes
-    # paths:
-    #   - "src/**/*.ts"
-    #   - "src/**/*.tsx"
-    #   - "src/**/*.js"
-    #   - "src/**/*.jsx"
-
-jobs:
-  claude-review:
-    # Optional: Filter by PR author
-    # if: |
-    #   github.event.pull_request.user.login == 'external-contributor' ||
-    #   github.event.pull_request.user.login == 'new-developer' ||
-    #   github.event.pull_request.author_association == 'FIRST_TIME_CONTRIBUTOR'
-
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      pull-requests: read
-      issues: read
-      id-token: write
-
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 1
-
-      - name: Run Claude Code Review
-        id: claude-review
-        uses: anthropics/claude-code-action@v1
-        with:
-          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
-          prompt: |
-            REPO: ${{ github.repository }}
-            PR NUMBER: ${{ github.event.pull_request.number }}
-
-            Please review this pull request and provide feedback on:
-            - Code quality and best practices
-            - Potential bugs or issues
-            - Performance considerations
-            - Security concerns
-            - Test coverage
-
-            Use the repository's CLAUDE.md for guidance on style and conventions. Be constructive and helpful in your feedback.
-
-            Use `gh pr comment` with your Bash tool to leave your review as a comment on the PR.
-
-          # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
-          # or https://code.claude.com/docs/en/cli-reference for available options
-          claude_args: '--allowed-tools "Bash(gh issue view:*),Bash(gh search:*),Bash(gh issue list:*),Bash(gh pr comment:*),Bash(gh pr diff:*),Bash(gh pr view:*),Bash(gh pr list:*)"'
-

package/skills/loki-mode/.github/workflows/claude.yml

@@ -1,50 +0,0 @@
-name: Claude Code
-
-on:
-  issue_comment:
-    types: [created]
-  pull_request_review_comment:
-    types: [created]
-  issues:
-    types: [opened, assigned]
-  pull_request_review:
-    types: [submitted]
-
-jobs:
-  claude:
-    if: |
-      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@claude')) ||
-      (github.event_name == 'pull_request_review_comment' && contains(github.event.comment.body, '@claude')) ||
-      (github.event_name == 'pull_request_review' && contains(github.event.review.body, '@claude')) ||
-      (github.event_name == 'issues' && (contains(github.event.issue.body, '@claude') || contains(github.event.issue.title, '@claude')))
-    runs-on: ubuntu-latest
-    permissions:
-      contents: read
-      pull-requests: read
-      issues: read
-      id-token: write
-      actions: read # Required for Claude to read CI results on PRs
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 1
-
-      - name: Run Claude Code
-        id: claude
-        uses: anthropics/claude-code-action@v1
-        with:
-          claude_code_oauth_token: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
-
-          # This is an optional setting that allows Claude to read CI results on PRs
-          additional_permissions: |
-            actions: read
-
-          # Optional: Give a custom prompt to Claude. If this is not specified, Claude will perform the instructions specified in the comment that tagged it.
-          # prompt: 'Update the pull request description to include a summary of changes.'
-
-          # Optional: Add claude_args to customize behavior and configuration
-          # See https://github.com/anthropics/claude-code-action/blob/main/docs/usage.md
-          # or https://code.claude.com/docs/en/cli-reference for available options
-          # claude_args: '--allowed-tools Bash(gh pr:*)'
-

package/skills/loki-mode/.github/workflows/release.yml

@@ -1,128 +0,0 @@
-name: Release
-
-on:
-  push:
-    paths:
-      - 'VERSION'
-    branches:
-      - main
-
-jobs:
-  release:
-    runs-on: ubuntu-latest
-    permissions:
-      contents: write
-
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v4
-        with:
-          fetch-depth: 0
-
-      - name: Read version
-        id: version
-        run: |
-          VERSION=$(cat VERSION | tr -d '\n')
-          echo "version=$VERSION" >> $GITHUB_OUTPUT
-          echo "tag=v$VERSION" >> $GITHUB_OUTPUT
-
-      - name: Check if tag exists
-        id: check_tag
-        run: |
-          if git rev-parse "v${{ steps.version.outputs.version }}" >/dev/null 2>&1; then
-            echo "exists=true" >> $GITHUB_OUTPUT
-          else
-            echo "exists=false" >> $GITHUB_OUTPUT
-          fi
-
-      - name: Create release artifacts
-        if: steps.check_tag.outputs.exists == 'false'
-        run: |
-          mkdir -p release
-
-          # ============================================
-          # Artifact 1: loki-mode.zip (for Claude.ai website)
-          # SKILL.md at ROOT level for direct upload
-          # ============================================
-          mkdir -p release/skill-root
-          cp SKILL.md release/skill-root/
-          cp -r references release/skill-root/
-
-          cd release/skill-root
-          zip -r ../loki-mode-${{ steps.version.outputs.version }}.zip .
-          cd ../..
-
-          # Also create .skill file (same as zip, different extension)
-          cp release/loki-mode-${{ steps.version.outputs.version }}.zip release/loki-mode-${{ steps.version.outputs.version }}.skill
-
-          # ============================================
-          # Artifact 2: loki-mode-api.zip (for console.anthropic.com)
-          # SKILL.md inside loki-mode/ folder (API requires folder wrapper)
-          # ============================================
-          mkdir -p release/api-package/loki-mode
-          cp SKILL.md release/api-package/loki-mode/
-          cp -r references release/api-package/loki-mode/
-
-          cd release/api-package
-          zip -r ../loki-mode-api-${{ steps.version.outputs.version }}.zip loki-mode
-          cd ../..
-
-          # ============================================
-          # Artifact 3: loki-mode-claude-code.zip
-          # For Claude Code: full package with loki-mode/ folder
-          # Extract to ~/.claude/skills/
-          # ============================================
-          mkdir -p release/loki-mode
-          cp SKILL.md release/loki-mode/
-          cp README.md release/loki-mode/
-          cp LICENSE release/loki-mode/ 2>/dev/null || true
-          cp VERSION release/loki-mode/
-          cp CHANGELOG.md release/loki-mode/
-          cp -r references release/loki-mode/
-          cp -r examples release/loki-mode/
-          cp -r tests release/loki-mode/
-          cp -r scripts release/loki-mode/
-          cp -r autonomy release/loki-mode/
-
-          cd release
-          zip -r loki-mode-claude-code-${{ steps.version.outputs.version }}.zip loki-mode
-          tar -czvf loki-mode-claude-code-${{ steps.version.outputs.version }}.tar.gz loki-mode
-          cd ..
-
-      - name: Create Git Tag
-        if: steps.check_tag.outputs.exists == 'false'
-        run: |
-          git config user.name "github-actions[bot]"
-          git config user.email "github-actions[bot]@users.noreply.github.com"
-          git tag -a "v${{ steps.version.outputs.version }}" -m "Release v${{ steps.version.outputs.version }}"
-          git push origin "v${{ steps.version.outputs.version }}"
-
-      - name: Extract changelog for this version
-        if: steps.check_tag.outputs.exists == 'false'
-        id: changelog
-        run: |
-          VERSION="${{ steps.version.outputs.version }}"
-          CHANGELOG=$(awk "/^## \[$VERSION\]/{flag=1; next} /^## \[/{flag=0} flag" CHANGELOG.md)
-          if [ -z "$CHANGELOG" ]; then
-            CHANGELOG="Release v$VERSION"
-          fi
-          echo "$CHANGELOG" > changelog_body.txt
-
-      - name: Create GitHub Release
-        if: steps.check_tag.outputs.exists == 'false'
-        env:
-          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: |
-          gh release create "v${{ steps.version.outputs.version }}" \
-            release/loki-mode-${{ steps.version.outputs.version }}.zip \
-            release/loki-mode-${{ steps.version.outputs.version }}.skill \
-            release/loki-mode-api-${{ steps.version.outputs.version }}.zip \
-            release/loki-mode-claude-code-${{ steps.version.outputs.version }}.zip \
-            release/loki-mode-claude-code-${{ steps.version.outputs.version }}.tar.gz \
-            --title "Loki Mode v${{ steps.version.outputs.version }}" \
-            --notes-file changelog_body.txt
-
-      - name: Skip message
-        if: steps.check_tag.outputs.exists == 'true'
-        run: |
-          echo "Tag v${{ steps.version.outputs.version }} already exists. Skipping release."