@wenathlan/saddle 1.8.17 → 2.0.2

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

@@ -1,163 +0,0 @@
-# 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

@@ -1,214 +0,0 @@
-# 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

@@ -1,220 +0,0 @@
-# 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).