@poolzin/pool-bot 2026.3.11 → 2026.3.14

package/docs/competitive-analysis.md

@@ -0,0 +1,421 @@
+# Análise Competitiva: OpenFang e Hermes Agent
+
+**Data da Análise:** Março de 2026  
+**Projetos Analisados:**
+- OpenFang v0.3.30 (RightNow-AI/openfang)
+- Hermes Agent (hermes-agent)
+- PoolBot (poolbot/poolbot)
+
+---
+
+## 🎯 Executive Summary
+
+### Principais Descobertas
+
+1. **OpenFang está ~6 meses à frente** em agentes autônomos e segurança criptográfica
+2. **Hermes lidera em ferramentas de ML/RL** e delegation de subagentes
+3. **PoolBot tem oportunidade** de implementar features críticas em 30-90 dias
+
+### Features Mais Críticas Ausentes no PoolBot
+
+| Prioridade | Feature | Projeto Original | Impacto |
+|------------|---------|------------------|---------|
+| 🔴 CRÍTICA | Agentes Autônomos 24/7 (Hands) | OpenFang | Diferencial competitivo majeur |
+| 🔴 CRÍTICA | Subagent Delegation | Hermes | Capacidade de delegation |
+| 🔴 CRÍTICA | WASM Dual-Metered Sandbox | OpenFang | Segurança de sandbox |
+| 🔴 CRÍTICA | Merkle Audit Trail | OpenFang | Compliance e segurança |
+| 🟠 ALTA | Session Repair Automático | OpenFang | Estabilidade do agent loop |
+| 🟠 ALTA | Loop Guard com Circuit Breaker | OpenFang | Previne runaway agents |
+
+---
+
+## 📋 Índice
+
+1. [OpenFang - 16 Features Exclusivas](#openfang---16-features-exclusivas)
+2. [Hermes Agent - 16 Features Exclusivas](#hermes-agent---16-features-exclusivas)
+3. [Gap Analysis](#gap-analysis)
+4. [Plano de Implementação em 3 Fases](#plano-de-implementação-em-3-fases)
+5. [Métricas Comparativas](#métricas-comparativas)
+
+---
+
+## OpenFang - 16 Features Exclusivas
+
+### 1. Hands (Agentes Autônomos) ⭐⭐⭐⭐⭐
+**Status no PoolBot:** ❌ NÃO EXISTE
+
+7 agentes pré-construídos que trabalham autonomamente:
+- **Clip**: YouTube → Shorts (pipeline de 8 fases)
+- **Lead**: Geração de leads B2B com ICP scoring
+- **Collector**: OSINT e monitoramento contínuo
+- **Predictor**: Superforecasting com Brier score
+- **Researcher**: Pesquisa com critérios CRAAP
+- **Twitter**: Gestão autônoma de conta
+- **Browser**: Automação web com approval gate
+
+**Arquivo de referência:** `agents/*/agent.toml`
+
+### 2. WASM Dual-Metered Sandbox ⭐⭐⭐⭐⭐
+**Status no PoolBot:** ⚠️ PARCIAL
+
+Duas camadas de proteção:
+- Fuel metering (instruções)
+- Epoch interruption (wall-clock com watchdog)
+
+**Arquivo de referência:** `crates/openfang-runtime/src/wasm_sandbox.rs`
+
+### 3. Merkle Hash-Chain Audit Trail ⭐⭐⭐⭐⭐
+**Status no PoolBot:** ❌ NÃO EXISTE
+
+Cada entrada inclui hash da anterior = tamper-evident logging.
+
+**Arquivo de referência:** `crates/openfang-runtime/src/audit.rs`
+
+### 4. Information Flow Taint Tracking ⭐⭐⭐⭐
+**Status no PoolBot:** ❌ NÃO EXISTE
+
+Labels de taint propagam através da execução.
+
+**Arquivo de referência:** `crates/openfang-types/src/taint.rs`
+
+### 5. Ed25519 Manifest Signing ⭐⭐⭐⭐
+**Status no PoolBot:** ❌ NÃO EXISTE
+
+Agent manifests assinados criptograficamente.
+
+**Arquivo de referência:** `crates/openfang-types/src/manifest_signing.rs`
+
+### 6. OFP Protocol (P2P com HMAC-SHA256) ⭐⭐⭐⭐
+**Status no PoolBot:** ⚠️ PARCIAL
+
+Protocolo wire para comunicação entre máquinas.
+
+**Arquivo de referência:** `crates/openfang-wire/`
+
+### 7. Model Catalog (51 Modelos) ⭐⭐⭐
+**Status no PoolBot:** ⚠️ PARCIAL
+
+Catálogo com 20+ providers, 51 models, tier system.
+
+**Arquivo de referência:** `crates/openfang-runtime/src/model_catalog.rs`
+
+### 8. Desktop App Tauri 2.0 ⭐⭐⭐
+**Status no PoolBot:** ⚠️ PARCIAL
+
+App nativo com kernel in-process.
+
+**Arquivo de referência:** `crates/openfang-desktop/`
+
+### 9. 60 Bundled Skills ⭐⭐⭐
+**Status no PoolBot:** ⚠️ PARCIAL
+
+Skills compiladas no binário com prompt injection scanner.
+
+**Arquivo de referência:** `crates/openfang-skills/`
+
+### 10. Loop Guard com Circuit Breaker ⭐⭐⭐⭐⭐
+**Status no PoolBot:** ⚠️ PARCIAL
+
+3 thresholds: warn (3), block (5), circuit breaker (30).
+
+**Arquivo de referência:** `crates/openfang-runtime/src/loop_guard.rs`
+
+### 11. Session Repair Automático ⭐⭐⭐⭐
+**Status no PoolBot:** ❌ NÃO EXISTE
+
+7-phase validation antes de cada loop.
+
+**Arquivo de referência:** `crates/openfang-runtime/src/session_repair.rs`
+
+### 12. Block-Aware Compactor ⭐⭐⭐
+**Status no PoolBot:** ⚠️ PARCIAL
+
+Handle Text, ToolUse, ToolResult, Image blocks.
+
+**Arquivo de referência:** `crates/openfang-runtime/src/compactor.rs`
+
+### 13. 40 Channel Adapters ⭐⭐⭐⭐⭐
+**Status no PoolBot:** ⚠️ PARCIAL (~15 canais)
+
+Wave 1-4: 15+8+8+9 canais.
+
+**Arquivo de referência:** `crates/openfang-channels/`
+
+### 14. GCRA Rate Limiter ⭐⭐⭐
+**Status no PoolBot:** ⚠️ PARCIAL
+
+Generic Cell Rate Algorithm com cost-aware buckets.
+
+**Arquivo de referência:** `crates/openfang-api/src/middleware/rate_limiter.rs`
+
+### 15. Canonical Sessions ⭐⭐⭐⭐
+**Status no PoolBot:** ❌ NÃO EXISTE
+
+Memória cross-channel com compaction.
+
+**Arquivo de referência:** `crates/openfang-memory/src/canonical_sessions.rs`
+
+### 16. Usage Tracking Persistente ⭐⭐⭐
+**Status no PoolBot:** ⚠️ PARCIAL
+
+Tabela `usage_events` com UsageStore.
+
+**Arquivo de referência:** `crates/openfang-memory/src/usage.rs`
+
+---
+
+## Hermes Agent - 16 Features Exclusivas
+
+### 1. Skin System ⭐⭐⭐⭐
+**Status no PoolBot:** ❌ NÃO EXISTE
+
+Temas customizáveis para CLI (cores, spinner, branding).
+
+**Arquivo de referência:** `docs/skins/example-skin.yaml`
+
+### 2. RL Training (Tinker-Atropos) ⭐⭐⭐⭐⭐
+**Status no PoolBot:** ❌ NÃO EXISTE
+
+11 ferramentas para treino de RL.
+
+**Arquivo de referência:** `tools/rl_training_tool.py`
+
+### 3. Mixture of Agents ⭐⭐⭐⭐
+**Status no PoolBot:** ❌ NÃO EXISTE
+
+Multi-model collaborative reasoning.
+
+**Arquivo de referência:** `tools/mixture_of_agents_tool.py`
+
+### 4. Checkpoint Manager ⭐⭐⭐⭐
+**Status no PoolBot:** ❌ NÃO EXISTE
+
+Save/restore state com rollback.
+
+**Arquivo de referência:** `tools/checkpoint_manager.py`
+
+### 5. Home Assistant ⭐⭐⭐⭐
+**Status no PoolBot:** ❌ NÃO EXISTE
+
+Tool nativa para home automation.
+
+**Arquivo de referência:** `tools/homeassistant_tool.py`
+
+### 6. Honcho Integration ⭐⭐⭐
+**Status no PoolBot:** ❌ NÃO EXISTE
+
+Session management externo.
+
+**Arquivo de referência:** `honcho_integration/`
+
+### 7. Text-to-Speech ⭐⭐⭐
+**Status no PoolBot:** ❌ NÃO EXISTE
+
+Edge TTS, ElevenLabs, OpenAI TTS.
+
+**Arquivo de referência:** `tools/tts_tool.py`
+
+### 8. Patch Tool ⭐⭐⭐⭐
+**Status no PoolBot:** ⚠️ PARCIAL
+
+File patching tipo diff/patch.
+
+**Arquivo de referência:** `tools/patch_parser.py`
+
+### 9. Vision Analyze ⭐⭐⭐⭐
+**Status no PoolBot:** ⚠️ PARCIAL
+
+Image understanding, OCR.
+
+**Arquivo de referência:** `tools/vision_tools.py`
+
+### 10. Image Generation ⭐⭐⭐
+**Status no PoolBot:** ❌ NÃO EXISTE
+
+Text-to-image com upscaling.
+
+**Arquivo de referência:** `tools/image_generation_tool.py`
+
+### 11. Cronjob CLI Tools ⭐⭐⭐⭐
+**Status no PoolBot:** ⚠️ PARCIAL
+
+Schedule, list, remove cronjobs.
+
+**Arquivo de referência:** `tools/cronjob_tools.py`
+
+### 12. Subagent Delegation ⭐⭐⭐⭐⭐
+**Status no PoolBot:** ❌ NÃO EXISTE
+
+Spawn de child agents com contexto isolado.
+
+**Arquivo de referência:** `tools/delegate_tool.py`
+
+### 13. Clarify Tool ⭐⭐⭐⭐
+**Status no PoolBot:** ❌ NÃO EXISTE
+
+Interactive Q&A com usuário.
+
+**Arquivo de referência:** `tools/clarify_tool.py`
+
+### 14. Code Execution Sandbox ⭐⭐⭐⭐⭐
+**Status no PoolBot:** ⚠️ PARCIAL
+
+EXECUTE_CODE_SCHEMA com múltiplos backends.
+
+**Arquivo de referência:** `tools/code_execution_tool.py`
+
+### 15. Todo/Planning Tool ⭐⭐⭐⭐
+**Status no PoolBot:** ❌ NÃO EXISTE
+
+TODO_SCHEMA e TodoStore.
+
+**Arquivo de referência:** `tools/todo_tool.py`
+
+### 16. Skills com Platform Matching ⭐⭐⭐⭐
+**Status no PoolBot:** ❌ NÃO EXISTE
+
+skill_matches_platform() para cross-platform.
+
+**Arquivo de referência:** `tools/skills_tool.py`
+
+---
+
+## Gap Analysis
+
+### Crítico (0-30 dias)
+
+| Feature | OpenFang | Hermes | PoolBot | Gap |
+|---------|----------|--------|---------|-----|
+| Agentes Autônomos | ✅ | ❌ | ❌ | -1 |
+| Subagent Delegation | ❌ | ✅ | ❌ | -1 |
+| WASM Dual-Metering | ✅ | ❌ | ⚠️ | -0.5 |
+| Merkle Audit Trail | ✅ | ❌ | ❌ | -1 |
+| Session Repair | ✅ | ❌ | ❌ | -1 |
+| Loop Guard Circuit Breaker | ✅ | ❌ | ⚠️ | -0.5 |
+
+### Alta (30-60 dias)
+
+| Feature | OpenFang | Hermes | PoolBot | Gap |
+|---------|----------|--------|---------|-----|
+| Canonical Sessions | ✅ | ❌ | ❌ | -1 |
+| Model Catalog | ✅ | ❌ | ⚠️ | -0.5 |
+| RL Training | ❌ | ✅ | ❌ | -1 |
+| Mixture of Agents | ❌ | ✅ | ❌ | -1 |
+| Checkpoint Manager | ❌ | ✅ | ❌ | -1 |
+| Clarify Tool | ❌ | ✅ | ❌ | -1 |
+
+---
+
+## Plano de Implementação em 3 Fases
+
+### Fase 1 (0-30 dias) - Crítico
+
+#### 1.1 Agentes Autônomos (Hands)
+- [ ] Criar `HAND.toml` manifest schema
+- [ ] Implementar scheduler autônomo
+- [ ] Criar 2 hands iniciais:
+  - [ ] Researcher (web search + synthesis)
+  - [ ] Collector (monitoramento contínuo)
+- [ ] Dashboard de status
+
+#### 1.2 Subagent Delegation
+- [ ] `DELEGATE_TASK` schema
+- [ ] Context isolation
+- [ ] Result aggregation
+- [ ] Depth limit (max 5)
+
+#### 1.3 Session Repair
+- [ ] Validação de message history
+- [ ] Drop orphaned ToolResults
+- [ ] Merge consecutive same-role
+- [ ] Auto-fix antes de cada loop
+
+### Fase 2 (30-60 dias) - Alta
+
+#### 2.1 Loop Guard com Circuit Breaker
+- [ ] SHA256-based `(tool_name, params)` detection
+- [ ] 3-tier thresholds (warn/block/breaker)
+- [ ] Auto-termination
+
+#### 2.2 Canonical Sessions
+- [ ] Cross-channel memory
+- [ ] Compaction com summaries
+- [ ] System prompt injection
+
+#### 2.3 Checkpoint Manager
+- [ ] Save state durante execução
+- [ ] Rollback para checkpoints
+- [ ] State compression
+
+### Fase 3 (60-90 dias) - Média
+
+#### 3.1 Merkle Audit Trail
+- [ ] Hash chain implementation
+- [ ] Tamper detection
+- [ ] Audit API
+
+#### 3.2 Model Catalog
+- [ ] 51 builtin models
+- [ ] Cost tracking
+- [ ] Auto-routing por complexidade
+
+#### 3.3 Mixture of Agents
+- [ ] Multi-model consensus
+- [ ] Diverse perspectives
+- [ ] Conflict resolution
+
+---
+
+## Métricas Comparativas
+
+| Métrica | OpenFang | Hermes | PoolBot |
+|---------|----------|--------|---------|
+| **Linguagem** | Rust | Python | TypeScript |
+| **LOC** | 137K | ~30K | ~100K |
+| **Tests** | 1,767+ | ~200 | ~500 |
+| **Security Layers** | 16 | 6 | 8 |
+| **Channels** | 40 | 15 | ~15 |
+| **LLM Providers** | 27 | 20+ | 20+ |
+| **Tools** | 53+ | 30+ | 40+ |
+| **Cold Start** | 180ms | ~2s | ~500ms |
+| **Memory Idle** | 40MB | ~200MB | ~150MB |
+| **Install Size** | 32MB | ~500MB | ~200MB |
+
+---
+
+## Conclusão e Próximos Passos
+
+### OpenFang é superior em:
+- ✅ Segurança (16 layers)
+- ✅ Agentes autônomos (7 Hands)
+- ✅ Performance (Rust, 32MB)
+- ✅ Audit trail criptográfico
+
+### Hermes é superior em:
+- ✅ Ferramentas ML/RL (11 tools)
+- ✅ Subagent delegation
+- ✅ Code execution sandbox
+- ✅ Customização UI (Skins)
+
+### PoolBot deve priorizar:
+1. 🔴 Agentes autônomos (Hands) - Diferencial competitivo
+2. 🔴 Subagent delegation - Capacidade crítica
+3. 🟠 Session repair - Estabilidade
+4. 🟠 Loop guard circuit breaker - Segurança
+5. 🟠 Canonical sessions - Memória cross-channel
+
+### Risco Competitivo
+**OpenFang está ~6 meses à frente** em agentes autônomos e segurança. Recomenda-se iniciar Fase 1 imediatamente.
+
+---
+
+## Referências
+
+- OpenFang: https://github.com/RightNow-AI/openfang
+- OpenFang Docs: https://openfang.sh/docs
+- Hermes Agent: (repositório local analisado)
+- PoolBot: https://github.com/poolbot/poolbot
+
+---
+
+*Documento gerado em Março de 2026 para planejamento estratégico do PoolBot.*