@wenathlan/saddle 1.8.4 → 1.8.6

package/docs/plans/31.auditoria.dados.md

@@ -0,0 +1,163 @@
+# Auditoria de Dados Hardcoded - webscrape
+
+**Data:** 2026-06-08
+**Pasta:** `webscrape/`
+
+---
+
+## Problemas Críticos
+
+### 1. tokens.ts - Preços de modelos hardcoded e desatualizados
+
+**Severidade:** ALTA
+**Arquivo:** `tokens.ts` (linhas 37-44)
+
+```typescript
+const PRICES = {
+  'gpt-4o':             { input: 0.0025, output: 0.01 },      // ← DESATUALIZADO
+  'gpt-4o-mini':        { input: 0.00015, output: 0.0006 },   // ← DESATUALIZADO
+  'gpt-4-turbo':        { input: 0.01, output: 0.03 },        // ← DESATUALIZADO
+  'claude-3-5-sonnet':  { input: 0.003, output: 0.015 },      // ← DESATUALIZADO
+  'claude-3-haiku':     { input: 0.00025, output: 0.00125 },  // ← DESATUALIZADO
+  'gemini-1.5-pro':     { input: 0.00125, output: 0.005 },    // ← DESATUALIZADO
+  'gemini-1.5-flash':   { input: 0.000075, output: 0.0003 },  // ← DESATUALIZADO
+};
+```
+
+**Problema:** Preços de API são de 2024 e estão completamente desatualizados.
+
+**Solução:** Carregar preços de configuração ou API remota.
+
+---
+
+### 2. browser.ts - User-Agent hardcoded
+
+**Severidade:** MÉDIA
+**Arquivo:** `browser.ts` (linha 13)
+
+```typescript
+userAgent = 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 ...'
+```
+
+**Problema:** User-Agent estático hardcoded. Deveria ser rotacionado ou configurável.
+
+---
+
+### 3. server.ts - Host hardcoded
+
+**Severidade:** MÉDIA
+**Arquivo:** `server.ts` (linha 132)
+
+```typescript
+host: '0.0.0.0'  // ← hardcoded - escuta em todas as interfaces
+```
+
+**Problema:** Servidor escuta em todas as interfaces de rede por padrão.
+
+**Solução:** Default para `127.0.0.1` e permitir configuração.
+
+---
+
+### 4. renderer.ts - Caminhos hardcoded
+
+**Severidade:** MÉDIA
+**Arquivo:** `renderer.ts`
+
+```typescript
+pythonPath: 'python'           // hardcoded
+windowSize: '1280x720'         // hardcoded
+doomFramesDir: '~/devthink/webscrape/doom_frames'  // hardcoded
+```
+
+---
+
+### 5. .github/dependabot.yml - Ecosystem vazio
+
+**Severidade:** MÉDIA
+**Arquivo:** `.github/dependabot.yml`
+
+```yaml
+package-ecosystem: ""  // ← PLACEHOLDER
+```
+
+---
+
+### 6. Versão hardcoded em múltiplos arquivos
+
+**Severidade:** MÉDIA
+
+| Arquivo | Versão |
+|---------|--------|
+| `cli.ts:17` | `2.0.0` |
+| `server.ts:123` | `2.0.0` |
+| `web/index.html:88` | `v2.0.0` |
+| `package.json` | `2.0.0` |
+
+---
+
+## Valores que Devem Ser Configuráveis
+
+| Arquivo | Valor | Default |
+|---------|-------|---------|
+| `types.ts` | Timeout | `30000` ms |
+| `types.ts` | Scroll delay | `300` ms |
+| `types.ts` | Max scrolls | `50` |
+| `types.ts` | Retries | `3` |
+| `types.ts` | Retry delay | `1000` ms |
+| `types.ts` | Cache TTL | `300000` ms |
+| `types.ts` | Viewport | `{ width: 1280, height: 720 }` |
+| `types.ts` | Locale | `'en-US'` |
+| `cli.ts` | Format default | `'markdown'` |
+| `cli.ts` | Mode default | `'auto'` |
+| `crawler.ts` | Max depth | `2` |
+| `crawler.ts` | Max pages | `50` |
+| `crawler.ts` | Max concurrent | `3` |
+| `crawler.ts` | Delay | `1000` ms |
+| `agent.ts` | Max tokens | `8000` |
+| `agent.ts` | Chunk size | `512` |
+| `agent.ts` | Model | `'default'` |
+| `cache.ts` | Max size | `1000` |
+| `cache.ts` | Default TTL | `5 min` |
+| `proxy.ts` | Max failures | `3` |
+| `proxy.ts` | Revive after | `30 min` |
+| `rate-limiter.ts` | Max tokens | `10` |
+| `rate-limiter.ts` | Interval | `1000` ms |
+| `rate-limiter.ts` | Max concurrent | `5` |
+| `pool.ts` | Max size | `3` |
+| `batch.ts` | Concurrency | `5` |
+| `chunking.ts` | Max tokens | `512` |
+| `chunking.ts` | Overlap | `50` |
+| `serialize.ts` | Redis key pattern | `'page:1'` |
+| `llms-txt.ts` | Max pages listed | `20` |
+| `robots.ts` | User-Agent | `'DevThink-WebScrape/2.0'` |
+| `robots.ts` | Cache TTL | `24h` |
+
+---
+
+## Preocupação de Segurança
+
+| Arquivo | Problema |
+|---------|----------|
+| `browser.ts:37` | `'--disable-web-security'` hardcoded no launch args |
+| `dev-server.ts:14` | CORS `'*'` (aceitável para dev, não para prod) |
+
+---
+
+## Resumo
+
+| Categoria | Quantidade |
+|-----------|-----------|
+| Preços desatualizados | 7 modelos |
+| User-Agent hardcoded | 1 |
+| Host hardcoded | 1 |
+| Caminhos hardcoded | 3 |
+| Versão hardcoded | 4 arquivos |
+| Dependabot placeholder | 1 |
+| Valores configuráveis | 30+ |
+| Preocupações de segurança | 2 |
+
+**Ações prioritárias:**
+1. Tornar preços de token configuráveis (ou carregar de API)
+2. Tornar User-Agent rotativo/configurável
+3. Default server para 127.0.0.1
+4. Remover `--disable-web-security` ou documentar risco

package/docs/plans/32.bots.automacao.computacional.md

@@ -0,0 +1,214 @@
+# Bots de Automacao e Processamento Computacional
+
+> Status: Julho 2026 | Foco: Bots gratuitos e open source para processamento computacional, tarefas e automacao  
+> Exclui bots ja estrelados na conta do usuario (iakadion).
+
+## 1. Resumo Executivo
+
+| Categoria | Bot | Estrelas | Gratuito | Open Source | Observacao |
+|-----------|-----|----------|----------|-------------|------------|
+| Automacao | FreeClaw | 4 | Sim | MIT | Telegram AI agent, OpenClaw |
+| Automacao | become-ceo | 58 | Sim | MIT | AI executive team Discord |
+| Automacao | Agentic-AI | 1 | ? | - | AI agents workflow |
+| Automacao | Agent-2-Beta | 37 | ? | - | Self-hosted browser AI agent |
+| Processamento | Custom-MCP-Calculator | 0 | Sim | ? | MCP calculator server |
+| Computacao | gaia-agent | 2 | ? | - | GAIA benchmark, web search |
+| Computacao | Improved-Browser-Agent | 0 | ? | - | Browser automation + math |
+| Computacao | AI-Agent-Pipeline | 2 | ? | - | Token optimization, multi-agent |
+| Computacao | AI-Agent-Optimization | 0 | ? | - | Token optimization debug |
+| Devops | ai-devops-automation | 1 | ? | - | FastAPI microservice |
+| Devops | AI-devops-agents | 0 | ? | - | CI/CD, deployment pipelines |
+
+## 2. Detalhamento por Bot
+
+### 2.1 FreeClaw (privatekey7/FreeClaw) - 4 estrelas
+
+**GitHub:** [privatekey7/FreeClaw](https://github.com/privatekey7/FreeClaw)  
+**License:** MIT  
+
+**O que faz:**
+- Deploy em um comando de Telegram AI agent
+- OpenClaw + Qwen via OpenRouter
+- Totalmente gratuito via Telegram
+
+**Instalacao:**
+```bash
+# Um comando para instalar
+npx freeclaw
+# ou
+curl -fsSL https://github.com/privatekey7/FreeClaw/raw/main/install.sh | bash
+```
+
+### 2.2 become-ceo (wanikua/become-ceo) - 58 estrelas
+
+**GitHub:** [wanikua/become-ceo](https://github.com/wanikua/become-ceo)  
+**License:** MIT  
+
+**O que faz:**
+- Equipe executiva de AI no Discord
+- 7 agentes especializados: Engineering, Finance, etc.
+- Automacao de tarefas empresariais
+
+**Instalacao:**
+```bash
+git clone https://github.com/wanikua/become-ceo
+cd become-ceo
+# Follow setup instructions
+```
+
+### 2.3 Agentic-AI (Saimoguloju/Agentic-AI) - 1 estrela
+
+**GitHub:** [Saimoguloju/Agentic-AI](https://github.com/Saimoguloju/Agentic-AI)
+
+**O que faz:**
+- Colecao de agentes autonomos
+- Demonstra workflows passo a passo
+- Research agents, code reviewers, customer support bots, data analyzers
+
+### 2.4 Agent-2-Beta (aaravshah1311/Agent-2-Beta) - 37 estrelas
+
+**GitHub:** [aaravshah1311/Agent-2-Beta](https://github.com/aaravshah1311/Agent-2-Beta)
+
+**O que faz:**
+- AI agent autonomo browser-based
+- Acesso a terminal real
+- Ferramentas de teste de seguranca
+- Memoria persistente
+- Sistema de workspace
+
+**Instalacao:**
+```bash
+git clone https://github.com/aaravshah1311/Agent-2-Beta
+cd Agent-2-Beta
+# Run the web interface
+```
+
+### 2.5 Custom-MCP-Calculator-Server (SumitPariyar) - 0 estrelas
+
+**GitHub:** [SumitPariyar/Custom-MCP-Calculator-Server](https://github.com/SumitPariyar/Custom-MCP-Calculator-Server)
+
+**O que faz:**
+- Servidor MCP para operacoes matematicas dinamicas
+- Integracao com AI agents via MCP
+- Processamento computacional em tempo real
+
+### 2.6 gaia-agent (hasancoded/gaia-agent) - 2 estrelas
+
+**GitHub:** [hasancoded/gaia-agent](https://github.com/hasancoded/gaia-agent)
+
+**O que faz:**
+- AI Agent com 100% de accuracy no GAIA benchmark
+- Multi-model LLM orchestration
+- Integracao com web search, file processing, mathematical computation
+- Arquitetura Python + Hugging Face Transformers + Gradio
+
+### 2.7 Improved-Browser-Agent (SHMISHRA666) - 0 estrelas
+
+**GitHub:** [SHMISHRA666/Improved_Browser_Agent](https://github.com/SHMISHRA666/Improved_Browser_Agent)
+
+**O que faz:**
+- Multi-agent AI system
+- Browser automation com Puppeteer
+- Processamento de documentos
+- Web search e mathematical computation
+- Planejamento e execucao inteligente
+
+### 2.8 AI-Agent-Pipeline (raoopriyanka) - 2 estrelas
+
+**GitHub:** [raoopriyanka/AI-Agent-Pipeline](https://github.com/raoopriyanka/AI-Agent-Pipeline)
+
+**O que faz:**
+- Pipeline de AI Agent
+- Otimizacao de tokens LLM
+- Multi-agent debugging
+- Arquitetura escalavel
+
+### 2.9 AI-Agent-Optimization (KshitijaKhilari) - 0 estrelas
+
+**GitHub:** [KshitijaKhilari/AI-Agent-Optimization-Assignment](https://github.com/KshitijaKhilari/AI-Agent-Optimization-Assignment)
+
+**O que faz:**
+- Optimizacao de tokens
+- Multi-agent debugging
+- Production-inspired pipeline
+
+### 2.10 ai-devops-automation (ankitpatil3003) - 1 estrela
+
+**GitHub:** [ankitpatil3003/Agentic-AI-DevOps-Automation-Project](https://github.com/ankitpatil3003/Agentic-AI-DevOps-Automation-Project)
+
+**O que faz:**
+- AI system em forma de microservice FastAPI
+- Integracao com Servo
+- Automacao DevOps
+
+### 2.11 AI-devops-agents (AI-employee-force) - 0 estrelas
+
+**GitHub:** [AI-employee-force/aief-devopsy](https://github.com/AI-employee-force/aief-devopsy)
+
+**O que faz:**
+- DevOpsy - AI DevOps Engineer agent
+- CI/CD, deployments, pipelines
+
+## 3. Bots de Computacao Especifica
+
+### 3.1 Agentes de Browser Automation
+
+**agent-browser** (ja estrelado) - 39k estrelas
+- Browser automation CLI para AI agents
+
+**Agent-2-Beta** - 37 estrelas
+- Self-hosted browser AI agent com terminal acesso
+
+### 3.2 Agentes de Calculo/Matematica
+
+**Custom-MCP-Calculator-Server** - 0 estrelas
+- Servidor MCP para calculos matematicos
+
+**gaia-agent** - 2 estrelas
+- Integracao com mathematical computation
+
+### 3.3 Agentes de Processamento de Dados
+
+**AI-Agent-Pipeline** - 2 estrelas
+- Data processing pipelines
+- Token optimization
+
+## 4. Recomendacoes de Instalacao
+
+### 4.1 FreeClaw - Telegram AI Agent (Recomendado)
+
+```bash
+npx freeclaw
+# Configurar OpenRouter key
+# Pronto! Bot no Telegram
+```
+
+### 4.2 Agent-2-Beta - Self-hosted AI Agent
+
+```bash
+git clone https://github.com/aaravshah1311/Agent-2-Beta
+cd Agent-2-Beta
+pip install -r requirements.txt
+python app.py
+# Acessar via browser
+```
+
+### 4.3 Custom-MCP-Calculator-Server
+
+```bash
+# Funciona como MCP server
+# Integrar com Claude Code / Codex / OpenCode
+mcp use https://github.com/SumitPariyar/Custom-MCP-Calculator-Server
+```
+
+## 5. Conclusao
+
+Novos bots para processamento computacional e automacao:
+
+- **FreeClaw** (4 estrelas): Telegram bot gratuito, deploy em 1 comando
+- **Agent-2-Beta** (37 estrelas): Agente self-hosted browser-based
+- **Custom-MCP-Calculator-Server** (0 estrelas): MCP server para calculos
+- **gaia-agent** (2 estrelas): AI agent com alta precisao
+- **become-ceo** (58 estrelas): Equipe AI no Discord
+
+Estes complementam os agentes ja instalados (opencode, deer-flow, dagu, por exemple).

package/docs/plans/33.bots.codigo.revisao.md

@@ -0,0 +1,220 @@
+# Bots de Cdigo e Revisao de Codigo
+
+> Status: Julho 2026 | Foco: Bots gratuitos e open source para GitHub Actions  
+> Exclui bots ja estrelados na conta do usuario (iakadion).
+
+## 1. Resumo Executivo
+
+| Categoria | Bot | Estrelas | Gratuito | Open Source | Observacao |
+|-----------|-----|----------|----------|-------------|------------|
+| Revisao AI | robin | 11 | Sim (OpenRouter free) | MIT | BYOK, review por PR |
+| Revisao AI | AICodeBot | 62 | Freemium | - | Commit messages + review |
+| Revisao AI | AI-Code-Reviewer | 49 | Sim (Claude API) | - | GitHub Actions |
+| Revisao AI | codeflow-ai-reviewer | 8 | ? | - | Qualidade + seguranca |
+| Revisao AI | repo-guard | 7 | ? | - | PR + issue quality |
+| Revisao AI | acrobot | 1 | Free tier | MIT | Org bot |
+| Revisao AI | multi-provider-code-review | 3 | ? | - | Multi-provider paralelo |
+| Revuo AI | li-agent | 0 | Sim | ? | LLM inline comments |
+| Reviao AI | AI-Code-Review-Bot | 0 | ? | - | Gemini Flash |
+
+## 2. Detalhamento por Bot
+
+### 2.1 Robin (antongulin/robin) - 11 estrelas
+
+**GitHub:** [antongulin/robin](https://github.com/antongulin/robin)  
+**License:** MIT  
+**Linguagem:** TypeScript  
+**Instalacao:** GitHub Action (reusable workflow)
+
+**O que faz:**
+- Revisao automatica de PRs com LLM
+- Posts comentarios inline + resumo
+- Suporta provedores: OpenRouter (gratis), OpenAI, Groq, Ollama
+- Free tier do OpenRouter funciona (openrouter/free)
+- Compativel com Claude Code, Cursor, Copilot, Windsurf
+
+**Instalacao (3 passos):**
+```bash
+# No repo alvo
+npx robin-review
+# ou
+curl -fsSL https://robinreview.dev/install.sh | bash
+```
+
+Secrets necessarios:
+- `LLM_API_KEY` - Sua chave OpenRouter
+- `LLM_BASE_URL` - https://openrouter.ai/api/v1
+- `LLM_MODEL` - openrouter/free
+
+Arquivo workflow (.github/workflows/robin.yml):
+```yaml
+name: Robin
+on:
+  pull_request:
+    types: [opened, reopened, ready_for_review]
+  issue_comment:
+    types: [created]
+permissions:
+  actions: read
+  contents: read
+  pull-requests: write
+jobs:
+  review:
+    uses: antongulin/robin/.github/workflows/review.yml@main
+    secrets:
+      LLM_API_KEY: ${{ secrets.LLM_API_KEY }}
+      LLM_BASE_URL: ${{ secrets.LLM_BASE_URL }}
+      LLM_MODEL: ${{ secrets.LLM_MODEL }}
+```
+
+Comandos no PR:
+- `/robin` - nova revisao
+- `/summary` - resumo apenas
+
+**Pagina:** https://www.robinreview.dev
+
+### 2.2 TechNickAI/AICodeBot - 62 estrelas
+
+**GitHub:** [TechNickAI/AICodeBot](https://github.com/TechNickAI/AICodeBot)  
+**License:** -  
+**Linguagem:** -
+
+**O que faz:**
+- Gera mensagens de commit a partir de mudancas git
+- Revisa codigo para qualidade
+- CLI tool
+
+### 2.3 MoaKK/AI-Code-Reviewer - 49 estrelas
+
+**GitHub:** [MoaKK/AI-Code-Reviewer](https://github.com/MoaKK/AI-Code-Reviewer)  
+**License:** -  
+**Linguagem:** -
+
+**O que faz:**
+- Bot de revisao de PRs usando Claude API
+- GitHub Actions nativo
+
+### 2.4 codeflow-ai-reviewer - 8 estrelas
+
+**GitHub:** [SnakeEye-sudo/codeflow-ai-reviewer](https://github.com/SnakeEye-sudo/codeflow-ai-reviewer)  
+
+**O que faz:**
+- Reviw de qualidade de codigo
+- Analise de seguranca
+- GitHub Action
+
+### 2.5 repo-guard - 7 estrelas
+
+**GitHub:** [ceilf6/repo-guard](https://github.com/ceilf6/repo-guard)  
+
+**O que faz:**
+- GitHub Action para PR review e issue quality
+- AI-powered
+
+### 2.6 acrobot - 1 estrela
+
+**GitHub:** [FazleRas/acrobot](https://github.com/FazleRas/acrobot)  
+**License:** MIT
+
+**O que faz:**
+- AI Code Review Org Bot
+- GitHub Action com free-tier constraints
+- Revisa diffs de PRs com LLM
+
+### 2.7 multi-provider-code-review - 3 estrelas
+
+**GitHub:** [keithah/multi-provider-code-review](https://github.com/keithah/multi-provider-code-review)  
+
+**O que faz:**
+- Multi-provider Code Review
+- Revises paralelos com multiples provedores
+
+### 2.8 AI-Code-Review-Bot - 0 estrelas
+
+**GitHub:** [euzghe/AI-Code-Review-Bot](https://github.com/euzghe/AI-Code-Review-Bot)  
+
+**O que faz:**
+- GitHub Action usando Gemini 3 Flash
+
+### 2.9 li-agent - 0 estrelas
+
+**GitHub:** [lbartoszcze/li-agent](https://github.com/lbartoszcze/li-agent)  
+**License:** -
+
+**O que faz:**
+- Free AI code review GitHub Action
+- Detecta vulnerabilidades de seguranca, bugs e performance
+- Posts inline comments
+
+### 2.10 semantic-code-review-bot - 1 estrela
+
+**GitHub:** [afnana4med/semantic-code-review-bot](https://github.com/afnana4med/semantic-code-review-bot)  
+
+**O que faz:**
+- Revisa diffs de PRs e posts comentarios inline
+- GitHub Action
+
+## 3. Bots NAO Estrelados (Novos para o Usuario)
+
+Estes bots NAO aparecem na lista de estrelas do usuario e sao totalmente novos:
+
+| Bot | Estrelas | Categoria | Gratuito |
+|-----|----------|-----------|----------|
+| TechNickAI/AICodeBot | 62 | Revisao + Commit msg | Freemium |
+| MoaKK/AI-Code-Reviewer | 49 | Revisao (Claude) | Sim |
+| SnakeEye-sudo/codeflow-ai-reviewer | 8 | Revisao + Seguranca | ? |
+| ceilf6/repo-guard | 7 | Reviao + Issue quality | ? |
+| FazleRas/acrobot | 1 | Org code review | Free tier |
+| keithah/multi-provider-code-review | 3 | Multi-provider review | ? |
+| euzghe/AI-Code-Review-Bot | 0 | Revisao (Gemini) | ? |
+| lbartoszcze/li-agent | 0 | Seguranca + Perf | Sim |
+| Sriruthuhasa/ai-code-sentinel | 0 | AST + Seguranca | ? |
+| muruganparamasivan-automind/ai-code-review-bot | 0 | Claude-powered | ? |
+| kalepavan298-del/ai-code-review-bot | 0 | AI code review | ? |
+| Omii-004/AI-code-reviewer | 0 | FastAPI + AI | ? |
+| mrsddq/ai-code-review-bot | 0 | Determinístico Python | ? |
+| hkhatib005/ai-code-review-bot | 0 | LLM inline comments | ? |
+| abdallahbot/AI-Code-Reviewer | 0 | ? | ? |
+| feiwei8889/ai-code-reviewer | 0 | GitHub App | ? |
+| AbdullahBakir97/ai-approve | 0 | GitHub Models (gratis) | Sim |
+| amalvpratish-2004/ai-code-reviewer | 0 | Llama 3.3 (Groq) | ? |
+
+## 4. Recomendacoes de Instalacao
+
+### 4.1 Robin - Revisao de PR com AI (Recomendado)
+
+```bash
+# Instalacao rapida
+npx robin-review
+# Adicionar secrets: LLM_API_KEY, LLM_BASE_URL, LLM_MODEL
+```
+
+### 4.2 li-agent - Seguranca + Performance (Gratuito)
+
+```yaml
+# .github/workflows/li-agent.yml
+- uses: lbartoszcze/li-agent@main
+```
+
+### 4.3 acrobot - Code Review para Orgs (Free tier)
+
+```yaml
+# .github/workflows/acrobot.yml
+- uses: FazleRas/acrobot@main
+```
+
+### 4.4 multi-provider-code-review - Reviso paralela
+
+```yaml
+# .github/workflows/multi-review.yml
+- uses: keithah/multi-provider-code-review@v1
+```
+
+## 5. Conclusao
+
+- **Robin** (11 estrelas): O mais completo e gratuito com OpenRouter free
+- **AICodeBot** (62 estrelas): Foco em commit messages + review
+- **li-agent** (0 estrelas): Gratuito, foco em seguranca e performance
+- **acrobot** (1 estrela): Ideal para orgs, free-tier
+
+Estes bots complementam o ecossistema ja instalado (opencode, robin ja estrelado).