npm - wegho-agentes - Versions diffs - 7.0.3 → 7.0.6 - Mend

wegho-agentes 7.0.3 → 7.0.6

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 (1483) hide show

package/.agent/skills/webapp-testing/scripts/playwright_runner.py ADDED Viewed

@@ -0,0 +1,173 @@
+#!/usr/bin/env python3
+"""
+Skill: webapp-testing
+Script: playwright_runner.py
+Purpose: Run basic Playwright browser tests
+Usage: python playwright_runner.py <url> [--screenshot]
+Output: JSON with page info, health status, and optional screenshot path
+Note: Requires playwright (pip install playwright && playwright install chromium)
+Screenshots: Saved to system temp directory (auto-cleaned by OS)
+"""
+import sys
+import json
+import os
+import tempfile
+from datetime import datetime
+# Fix Windows console encoding for Unicode output
+try:
+    sys.stdout.reconfigure(encoding='utf-8', errors='replace')
+    sys.stderr.reconfigure(encoding='utf-8', errors='replace')
+except AttributeError:
+    pass  # Python < 3.7
+try:
+    from playwright.sync_api import sync_playwright
+    PLAYWRIGHT_AVAILABLE = True
+except ImportError:
+    PLAYWRIGHT_AVAILABLE = False
+def run_basic_test(url: str, take_screenshot: bool = False) -> dict:
+    """Run basic browser test on URL."""
+    if not PLAYWRIGHT_AVAILABLE:
+        return {
+            "error": "Playwright not installed",
+            "fix": "pip install playwright && playwright install chromium"
+        }
+    result = {
+        "url": url,
+        "timestamp": datetime.now().isoformat(),
+        "status": "pending"
+    }
+    try:
+        with sync_playwright() as p:
+            browser = p.chromium.launch(headless=True)
+            context = browser.new_context(
+                viewport={"width": 1280, "height": 720},
+                user_agent="Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36"
+            )
+            page = context.new_page()
+            # Navigate
+            response = page.goto(url, wait_until="networkidle", timeout=30000)
+            # Basic info
+            result["page"] = {
+                "title": page.title(),
+                "url": page.url,
+                "status_code": response.status if response else None
+            }
+            # Health checks
+            result["health"] = {
+                "loaded": response.ok if response else False,
+                "has_title": bool(page.title()),
+                "has_h1": page.locator("h1").count() > 0,
+                "has_links": page.locator("a").count() > 0,
+                "has_images": page.locator("img").count() > 0
+            }
+            # Console errors
+            console_errors = []
+            page.on("console", lambda msg: console_errors.append(msg.text) if msg.type == "error" else None)
+            # Performance metrics
+            result["performance"] = {
+                "dom_content_loaded": page.evaluate("window.performance.timing.domContentLoadedEventEnd - window.performance.timing.navigationStart"),
+                "load_complete": page.evaluate("window.performance.timing.loadEventEnd - window.performance.timing.navigationStart")
+            }
+            # Screenshot - uses system temp directory (cross-platform, auto-cleaned)
+            if take_screenshot:
+                # Cross-platform: Windows=%TEMP%, Linux/macOS=/tmp
+                screenshot_dir = os.path.join(tempfile.gettempdir(), "maestro_screenshots")
+                os.makedirs(screenshot_dir, exist_ok=True)
+                screenshot_path = os.path.join(screenshot_dir, f"screenshot_{datetime.now().strftime('%Y%m%d_%H%M%S')}.png")
+                page.screenshot(path=screenshot_path, full_page=True)
+                result["screenshot"] = screenshot_path
+                result["screenshot_note"] = "Saved to temp directory (auto-cleaned by OS)"
+            # Element counts
+            result["elements"] = {
+                "links": page.locator("a").count(),
+                "buttons": page.locator("button").count(),
+                "inputs": page.locator("input").count(),
+                "images": page.locator("img").count(),
+                "forms": page.locator("form").count()
+            }
+            browser.close()
+            result["status"] = "success" if result["health"]["loaded"] else "failed"
+            result["summary"] = "[OK] Page loaded successfully" if result["status"] == "success" else "[X] Page failed to load"
+    except Exception as e:
+        result["status"] = "error"
+        result["error"] = str(e)
+        result["summary"] = f"[X] Error: {str(e)[:100]}"
+    return result
+def run_accessibility_check(url: str) -> dict:
+    """Run basic accessibility check."""
+    if not PLAYWRIGHT_AVAILABLE:
+        return {"error": "Playwright not installed"}
+    result = {"url": url, "accessibility": {}}
+    try:
+        with sync_playwright() as p:
+            browser = p.chromium.launch(headless=True)
+            page = browser.new_page()
+            page.goto(url, wait_until="networkidle", timeout=30000)
+            # Basic a11y checks
+            result["accessibility"] = {
+                "images_with_alt": page.locator("img[alt]").count(),
+                "images_without_alt": page.locator("img:not([alt])").count(),
+                "buttons_with_label": page.locator("button[aria-label], button:has-text('')").count(),
+                "links_with_text": page.locator("a:has-text('')").count(),
+                "form_labels": page.locator("label").count(),
+                "headings": {
+                    "h1": page.locator("h1").count(),
+                    "h2": page.locator("h2").count(),
+                    "h3": page.locator("h3").count()
+                }
+            }
+            browser.close()
+            result["status"] = "success"
+    except Exception as e:
+        result["status"] = "error"
+        result["error"] = str(e)
+    return result
+if __name__ == "__main__":
+    if len(sys.argv) < 2:
+        print(json.dumps({
+            "error": "Usage: python playwright_runner.py <url> [--screenshot] [--a11y]",
+            "examples": [
+                "python playwright_runner.py https://example.com",
+                "python playwright_runner.py https://example.com --screenshot",
+                "python playwright_runner.py https://example.com --a11y"
+            ]
+        }, indent=2))
+        sys.exit(1)
+    url = sys.argv[1]
+    take_screenshot = "--screenshot" in sys.argv
+    check_a11y = "--a11y" in sys.argv
+    if check_a11y:
+        result = run_accessibility_check(url)
+    else:
+        result = run_basic_test(url, take_screenshot)
+    print(json.dumps(result, indent=2))

package/.agent/skills/wegho-global-rules/SKILL.md CHANGED Viewed

@@ -7,17 +7,47 @@ description: Always-on rules for wegho-agentes. Applies to any task in this work
 This skill enforces the global rules and mandatory workflow for all agents.
+## Identity lock
+You are operating inside the `wegho-agentes` system. Never treat this workspace as a generic Antigravity Kit install.
+Before every response, tool call, code edit, or agent handoff, silently confirm:
+- Active system: `wegho-agentes`
+- Runtime engine: `.agents/` TypeScript orchestrator
+- Declarative layer: `.agent/` agents, skills, workflows, rules
+- Required docs sync: `npm run docs:sync`
+- Required workflow: `.agents/AGENT_WORKFLOW.md`
+- Required preflight: `npm run agent:preflight`
+If you cannot confirm these, stop and reload this skill plus the files below before continuing.
 ## Always load these files before doing any work
 - `docs/AGENT_RULES.md`
 - `.agents/AGENT_WORKFLOW.md`
 - `.agent/workflows/run-agents-workflow.md`
 - `.agent/workflows/auto-run-orchestrator.md`
+- `.agent/ARCHITECTURE.md`
+- `.agent/rules/GEMINI.md`
 ## Mandatory behavior
 1. Follow all rules in `docs/AGENT_RULES.md` with no exceptions.
-2. Execute the mandatory workflow steps from `.agents/AGENT_WORKFLOW.md` for every task.
-3. In Antigravity, always run preflight first: `npm run agent:preflight`.
-4. For autonomous execution, prefer `npm run agent:auto`.
-5. If you switch agent/model (default agent included), re-run preflight before continuing.
-6. If any rule conflicts with the user request, stop and ask for clarification.
-7. If a workflow step cannot be completed, report it explicitly and block completion.
+2. Run `npm run docs:sync` before normal execution whenever files may have changed.
+3. Execute the mandatory workflow steps from `.agents/AGENT_WORKFLOW.md` for every task.
+4. In Antigravity, always run preflight first: `npm run agent:preflight`.
+5. For autonomous execution, prefer `npm run agent:auto`.
+6. If you switch agent/model (default agent included), re-run preflight before continuing.
+7. If any rule conflicts with the user request, stop and ask for clarification.
+8. If a workflow step cannot be completed, report it explicitly and block completion.
+9. Every specialist agent must keep `wegho-global-rules` loaded even when applying its own domain skills.
+10. Every substantive answer should explicitly mention the active WebGho agent/workflow when useful for user verification.
+11. Do not bypass `.agents/cli.ts`, `.agents/orchestrator.ts`, or `executeWithMemory()` when the task requires the runtime agent system.
+## Agent switch recovery
+When the user changes agent in Antigravity, or the assistant notices missing context:
+1. Reload `wegho-global-rules`.
+2. Read the selected `.agent/agents/<agent>.md`.
+3. Load only the skills listed in that agent's `skills:` frontmatter.
+4. Run or request `npm run agent:preflight` before execution.
+5. Continue as WebGho Agents, not as a standalone specialist.

package/.agent/workflows/PROMPT_GUIDE.md CHANGED Viewed

@@ -1,208 +1,21 @@
-# Prompt Completo para Executar Workflow dos Agentes
-## ðŸŽ¯ Objetivo
-Executar o sistema de agentes `wegho-agentes` garantindo que todos os 6 passos obrigatÃ³rios sejam seguidos e validados.
+# Prompt Completo para Executar Workflow dos Agentes
-## âœ… Regra global (Antigravity)
-Sempre carregar a skill `wegho-global-rules` antes de executar qualquer tarefa ou trocar de agente.
+## Regra principal
+Antes de qualquer execução:
+1. Carregar `.agent/skills/wegho-global-rules/SKILL.md`
+2. Executar `npm run docs:sync`
+3. Executar `npm run agent:preflight`
+4. Seguir `.agents/AGENT_WORKFLOW.md`
----
-## ðŸ“‹ Prompt para IA
-```
-Execute o workflow completo do sistema de agentes wegho-agentes seguindo estes passos:
-1. VERIFICAR ESTRUTURA
-   - Confirme que a pasta .agents/memory existe
-   - Verifique se reference-repositories.json estÃ¡ presente
-   - Liste os agentes disponÃveis em .agents/core/
-2. EXECUTAR SISTEMA
-   - Execute: npm run agent:preflight
-   - Execute: npm run agent:auto
-   - Monitore a saÃda do console
-   - Verifique se todos os agentes executaram os 6 passos:
-     âœ“ Consultar MemÃ³ria
-     âœ“ Obter RecomendaÃ§Ãµes
-     âœ“ Consultar RepositÃ³rios
-     âœ“ Aplicar Aprendizados
-     âœ“ Registrar Resultado
-     âœ“ Gerar Aprendizados (opcional)
-3. VALIDAR EXECUÃ‡ÃƒO
-   - Verifique se apareceu "âœ… COMPLIANT" para cada agente
-   - Confirme que logs foram salvos em orchestrator-logs.json
-   - Verifique se nÃ£o hÃ¡ "âŒ NON-COMPLIANT"
-4. ANALISAR RESULTADOS
-   - Abra .agents/memory/orchestrator-logs.json
-   - Mostre o Ãºltimo registro de execuÃ§Ã£o
-   - Calcule a taxa de sucesso dos agentes
-   - Liste warnings se houver
-5. REPORTAR
-   - Resuma a execuÃ§Ã£o
-   - Liste agentes que executaram
-   - Mostre estatÃsticas de compliance
-   - Indique prÃ³ximos passos se houver problemas
-```
----
-## ðŸ¤– Exemplo de Uso com Antigravity
-**VocÃª pode dizer:**
-> "Execute o workflow /run-agents-workflow e me mostre os resultados da validaÃ§Ã£o"
-**Ou mais especÃfico:**
-> "Preciso que vocÃª:
-> 1. Execute o sistema de agentes
-> 2. Valide se todos seguiram os 6 passos obrigatÃ³rios
-> 3. Me mostre os logs da Ãºltima execuÃ§Ã£o
-> 4. Calcule a taxa de compliance de cada agente"
----
-## ðŸ“Š Output Esperado
-ApÃ³s executar, vocÃª deve ver algo assim:
-```
-â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”
-ðŸŽ¯ ORQUESTRADOR INTELIGENTE
-â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”
-ðŸ“Š Fase 1: AnÃ¡lise da Tarefa
-[INFO] Fase 1: AnÃ¡lise da Tarefa
-ðŸ¤– Fase 2: SeleÃ§Ã£o Inteligente de Agentes
-[INFO] Fase 2: SeleÃ§Ã£o Inteligente de Agentes
-âš™ï¸  Fase 3: ExecuÃ§Ã£o com Agentes
-[INFO] Fase 3: ExecuÃ§Ã£o com Agentes
-ðŸ¤– AGENTE ATIVO: FRONTEND-AGENT
-ðŸ“‹ Tarefa: Validar componente de login
-â° InÃcio: 21:32:45
-ðŸ’ [frontend-agent] Encontrei 2 caso(s) similar(es):
-  1. âœ… Validar componente de registro
-  2. âœ… Validar formulÃ¡rio de contato
-ðŸ’¡ [frontend-agent] RecomendaÃ§Ãµes baseadas em aprendizados:
-  1. Usar validaÃ§Ã£o com Zod
-  2. Incluir estados de loading/error
-ðŸ“š [frontend-agent] Consultando repositÃ³rios de referÃªncia:
-   - React: https://react.dev
-   - Zod: https://github.com/colinhacks/zod
-ðŸŽ¯ [frontend-agent] Aplicando 2 aprendizado(s) de alta confianÃ§a:
-   1. Usar validaÃ§Ã£o com Zod (confianÃ§a: 85%)
-   2. Incluir estados de loading/error (confianÃ§a: 90%)
-âš™ï¸  [frontend-agent] Executando tarefa...
-âœ… SUCESSO [frontend-agent] Tarefa concluÃda
-â° TÃ©rmino: 21:32:48
-â”â”â” ValidaÃ§Ã£o de Workflow: frontend-agent â”â”â”
-Status: âœ… COMPLIANT
-Passos Completados: 5/5
-âœ… Passos Executados:
-   - Consultar MemÃ³ria
-   - Obter RecomendaÃ§Ãµes
-   - Consultar RepositÃ³rios
-   - Aplicar Aprendizados
-   - Registrar Resultado
-â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”
-[INFO] Agente frontend-agent seguiu workflow completo
-[INFO] Fase 4: DecisÃ£o Final - GO
-[INFO] Fase 6: Salvando logs de execuÃ§Ã£o
-âœ… GO - ExecuÃ§Ã£o concluÃda
-â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”â”
-```
----
-## ðŸ” VerificaÃ§Ã£o de Compliance
-**Comando para verificar:**
-```powershell
-Get-Content .agents/memory/orchestrator-logs.json | ConvertFrom-Json | Select-Object -Last 1 | Select-Object taskId, timestamp, @{Name='TotalLogs';Expression={$_.logs.Count}}
-```
-**EstatÃsticas dos agentes:**
-```powershell
-Get-ChildItem .agents/memory -Directory | ForEach-Object {
-    $agentName = $_.Name
-    $successFile = Join-Path $_.FullName "successes.json"
-    if (Test-Path $successFile) {
-        $successes = (Get-Content $successFile | ConvertFrom-Json).Count
-        Write-Host "ðŸ“Š $agentName - $successes execuÃ§Ãµes bem-sucedidas"
-    }
-}
-```
----
-## âš ï¸ Troubleshooting
-### Se aparecer "âŒ NON-COMPLIANT"
-**Problema:** Agente nÃ£o executou todos os passos
-**SoluÃ§Ã£o:**
-1. Verifique se o agente herda de `BaseAgent`
-2. Confirme que usa `executeWithMemory()` e nÃ£o `executeTask()` diretamente
-3. Veja os logs detalhados em `orchestrator-logs.json`
-### Se nÃ£o salvar logs
-**Problema:** Arquivo `orchestrator-logs.json` nÃ£o Ã© criado
-**SoluÃ§Ã£o:**
-1. Verifique permissÃµes da pasta `.agents/memory`
-2. Execute como administrador se necessÃ¡rio
-3. Verifique erros no console durante execuÃ§Ã£o
----
-## ðŸ“ˆ MÃ©tricas de Sucesso
-âœ… **ExecuÃ§Ã£o Perfeita:**
-- Status: `âœ… COMPLIANT` para todos os agentes
-- Logs salvos: `orchestrator-logs.json` atualizado
-- Taxa de sucesso: > 90%
-- Sem warnings crÃticos
-âš ï¸ **ExecuÃ§Ã£o com Avisos:**
-- Status: `âœ… COMPLIANT` mas com warnings
-- Alguns passos fora de ordem (nÃ£o crÃtico)
-- Taxa de sucesso: 70-90%
-âŒ **ExecuÃ§Ã£o Falhou:**
-- Status: `âŒ NON-COMPLIANT`
-- Passos obrigatÃ³rios faltando
-- Taxa de sucesso: < 70%
-- Requer correÃ§Ã£o imediata
+## Prompt base
----
-## Auto-run (Antigravity)
-Se a sessao estiver rodando no Antigravity, execute automaticamente o workflow:
+```text
+Execute o workflow completo do sistema de agentes wegho-agentes.
+1. Sincronize a documentação técnica por arquivo com npm run docs:sync
+2. Rode npm run agent:preflight
+3. Valide escopo e arquivos impactados
+4. Execute a tarefa com mudanças mínimas
+5. Rode as validações disponíveis
+6. Revise o diff e reporte o resultado final
 ```
-auto-run-orchestrator
-```
-Este workflow le tarefas em `docs/ANTIGRAVITY_TASKS.md` e executa o orquestrador sem comandos manuais.

package/.agent/workflows/auto-run-orchestrator.md CHANGED Viewed

@@ -16,9 +16,9 @@ npm run agent:auto
 ```
 ## O que o preflight garante
-- Cria pastas obrigatorias (`.agents/memory`, `docs/mapsite`, `docs/ui-maps`).
-- Cria arquivos base faltantes (`docs/ANTIGRAVITY_TASKS.md`, `reference-repositories.json`).
-- Recria memoria minima por agente se algum arquivo estiver faltando.
+- Cria pastas obrigatorias (`.agents/runtime`, `docs/mapsite`, `docs/ui-maps`).
+- Cria arquivos base faltantes (`docs/ANTIGRAVITY_TASKS.md`, `.agents/reference-repositories.json`).
+- Sincroniza a documentação técnica por arquivo antes da execução.
 ## O que o auto-run faz
 - Le tarefas `- [ ]` em `docs/ANTIGRAVITY_TASKS.md`.

package/.agent/workflows/brainstorm.md ADDED Viewed

@@ -0,0 +1,113 @@
+---
+description: Structured brainstorming for projects and features. Explores multiple options before implementation.
+---
+# /brainstorm - Structured Idea Exploration
+$ARGUMENTS
+---
+## Purpose
+This command activates BRAINSTORM mode for structured idea exploration. Use when you need to explore options before committing to an implementation.
+---
+## Behavior
+When `/brainstorm` is triggered:
+1. **Understand the goal**
+   - What problem are we solving?
+   - Who is the user?
+   - What constraints exist?
+2. **Generate options**
+   - Provide at least 3 different approaches
+   - Each with pros and cons
+   - Consider unconventional solutions
+3. **Compare and recommend**
+   - Summarize tradeoffs
+   - Give a recommendation with reasoning
+---
+## Output Format
+```markdown
+## 🧠 Brainstorm: [Topic]
+### Context
+[Brief problem statement]
+---
+### Option A: [Name]
+[Description]
+✅ **Pros:**
+- [benefit 1]
+- [benefit 2]
+❌ **Cons:**
+- [drawback 1]
+📊 **Effort:** Low | Medium | High
+---
+### Option B: [Name]
+[Description]
+✅ **Pros:**
+- [benefit 1]
+❌ **Cons:**
+- [drawback 1]
+- [drawback 2]
+📊 **Effort:** Low | Medium | High
+---
+### Option C: [Name]
+[Description]
+✅ **Pros:**
+- [benefit 1]
+❌ **Cons:**
+- [drawback 1]
+📊 **Effort:** Low | Medium | High
+---
+## 💡 Recommendation
+**Option [X]** because [reasoning].
+What direction would you like to explore?
+```
+---
+## Examples
+```
+/brainstorm authentication system
+/brainstorm state management for complex form
+/brainstorm database schema for social app
+/brainstorm caching strategy
+```
+---
+## Key Principles
+- **No code** - this is about ideas, not implementation
+- **Visual when helpful** - use diagrams for architecture
+- **Honest tradeoffs** - don't hide complexity
+- **Defer to user** - present options, let them decide

package/.agent/workflows/create.md ADDED Viewed

@@ -0,0 +1,59 @@
+---
+description: Create new application command. Triggers App Builder skill and starts interactive dialogue with user.
+---
+# /create - Create Application
+$ARGUMENTS
+---
+## Task
+This command starts a new application creation process.
+### Steps:
+1. **Request Analysis**
+   - Understand what the user wants
+   - If information is missing, use `conversation-manager` skill to ask
+2. **Project Planning**
+   - Use `project-planner` agent for task breakdown
+   - Determine tech stack
+   - Plan file structure
+   - Create plan file and proceed to building
+3. **Application Building (After Approval)**
+   - Orchestrate with `app-builder` skill
+   - Coordinate expert agents:
+     - `database-architect` → Schema
+     - `backend-specialist` → API
+     - `frontend-specialist` → UI
+4. **Preview**
+   - Start with `auto_preview.py` when complete
+   - Present URL to user
+---
+## Usage Examples
+```
+/create blog site
+/create e-commerce app with product listing and cart
+/create todo app
+/create Instagram clone
+/create crm system with customer management
+```
+---
+## Before Starting
+If request is unclear, ask these questions:
+- What type of application?
+- What are the basic features?
+- Who will use it?
+Use defaults, add details later.