@poolzin/pool-bot 2026.3.14 → 2026.3.16

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+## v2026.3.16 (2026-03-12)
+
+### Fixes
+- Version bump to 2026.3.16
+
+---
+
 ## v2026.3.14 (2026-03-14)
 
 ### 🎉 OpenClaw Improvements - Complete Implementation

package/dist/agents/checkpoint-manager.js

@@ -5,8 +5,8 @@
  * - Save execution state with metadata
  * - Restore from checkpoints
  * - Automatic cleanup of old checkpoints
- * - State compression for large payloads
  * - Atomic writes with rollback on failure
+ * - Integrity verification via SHA256 hashes
  *
  * Based on Hermes Agent's checkpoint_manager.py
  */
@@ -222,7 +222,6 @@ export class CheckpointManager {
                 const fullPath = path.join(this.config.checkpointDir, sessionDir);
                 const stat = await fs.stat(fullPath);
                 if (stat.isDirectory()) {
-                    // Extract session ID from directory name
                     const sessionId = sessionDir;
                     const result = await this.cleanupOldCheckpoints(sessionId);
                     totalDeleted += result.deleted;

package/dist/build-info.json

@@ -1,5 +1,5 @@
 {
-  "version": "2026.3.14",
-  "commit": "538c3e6915747260db074b3534da2218d83740be",
-  "builtAt": "2026-03-12T05:42:57.579Z"
+  "version": "2026.3.16",
+  "commit": "8d4adda2df004de395e1180c0d6fa8733aef9c9f",
+  "builtAt": "2026-03-12T08:25:17.844Z"
 }

package/docs/assets-evaluation.md

@@ -0,0 +1,418 @@
+# Avaliação de Assets de Logo e Imagem do PoolBot
+
+**Data:** Março de 2026  
+**Status:** ⚠️ **PARCIALMENTE UTILIZADOS**
+
+---
+
+## 📊 Resumo Executivo
+
+Dos **7 assets principais** no diretório `/assets/`:
+
+| Asset | Status | Uso Atual | Recomendação |
+|-------|--------|-----------|--------------|
+| `pool-bot-logo-1.png` (133KB) | ⚠️ **Subutilizado** | Apenas docs/README | ✅ Manter |
+| `pool-bot-icon-dark.png` (1.3MB) | ⚠️ **Subutilizado** | Apenas docs | ✅ Manter |
+| `pool-bot-mascot.png` (852KB) | ❌ **Não utilizado** | Nenhum uso encontrado | ⚠️ Avaliar remoção |
+| `dmg-background.png` (990KB) | ✅ **Utilizado** | macOS installer DMG | ✅ Manter |
+| `dmg-background-small.png` (219KB) | ✅ **Utilizado** | macOS installer DMG | ✅ Manter |
+| `avatar-placeholder.svg` (666B) | ✅ **Utilizado** | Scripts de contributors | ✅ Manter |
+| Chrome Extension Icons | ✅ **Utilizado** | Chrome extension | ✅ Manter |
+
+---
+
+## 📁 Assets Encontrados
+
+### Diretório `/assets/`
+
+```
+assets/
+├── avatar-placeholder.svg          (666B)    ✅ EM USO
+├── chrome-extension/
+│   └── icons/
+│       ├── icon16.png              ✅ EM USO
+│       ├── icon32.png              ✅ EM USO
+│       ├── icon48.png              ✅ EM USO
+│       └── icon128.png             ✅ EM USO
+├── dmg-background.png              (990KB)   ✅ EM USO
+├── dmg-background-small.png        (219KB)   ✅ EM USO
+├── pool-bot-icon-dark.png          (1.3MB)   ⚠️ SUBUTILIZADO
+├── pool-bot-logo-1.png             (133KB)   ⚠️ SUBUTILIZADO
+└── pool-bot-mascot.png             (852KB)   ❌ NÃO UTILIZADO
+```
+
+### Outros Assets
+
+```
+apps/ios/Sources/Assets.xcassets/    ✅ EM USO (iOS app icons)
+apps/macos/Icon.icon/Assets/         ✅ EM USO (macOS app icons)
+docs/assets/                         ✅ EM USO (documentação)
+docs/images/                         ✅ EM USO (documentação)
+ui/public/favicon.ico                ✅ EM USO (web UI)
+README-header.png                    ✅ EM USO (README)
+```
+
+---
+
+## 🔍 Análise Detalhada
+
+### ✅ Assets Bem Utilizados
+
+#### 1. **avatar-placeholder.svg** (666B)
+**Uso:** Script `update-clawtributors.ts`
+
+```typescript
+// scripts/update-clawtributors.ts:18
+const placeholderAvatar = mapConfig.placeholderAvatar ?? "assets/avatar-placeholder.svg";
+```
+
+**Status:** ✅ **ATIVO** - Usado para avatares de contributors sem foto
+
+**Recomendação:** ✅ Manter - Arquivo pequeno e útil
+
+---
+
+#### 2. **dmg-background.png** (990KB) & **dmg-background-small.png** (219KB)
+**Uso:** macOS installer DMG background
+
+**Localização:** Usado no processo de build do macOS app
+
+**Recomendação:** ✅ Manter - Necessário para distribuição macOS
+
+---
+
+#### 3. **Chrome Extension Icons** (4 arquivos)
+**Uso:** Chrome extension
+
+```
+assets/chrome-extension/icons/
+├── icon16.png
+├── icon32.png
+├── icon48.png
+└── icon128.png
+```
+
+**Status:** ✅ **ATIVO** - Requerido pela Chrome Web Store
+
+**Recomendação:** ✅ Manter - Múltiplos tamanhos necessários
+
+---
+
+#### 4. **iOS App Icons**
+**Uso:** iOS app icon
+
+```
+apps/ios/Sources/Assets.xcassets/AppIcon.appiconset/
+├── icon-20@1x.png
+├── icon-29@2x.png
+├── icon-29@3x.png
+├── icon-40@2x.png
+├── icon-40@3x.png
+├── icon-60@3x.png
+├── icon-76@2x.png
+├── icon-83.5@2x.png
+└── icon-1024.png
+```
+
+**Status:** ✅ **ATIVO** - Requerido pela App Store
+
+**Recomendação:** ✅ Manter - Tamanhos múltiplos necessários
+
+---
+
+#### 5. **macOS App Icons**
+**Uso:** macOS app icon
+
+```
+apps/macos/Icon.icon/Assets/poolbot-mac.png
+```
+
+**Status:** ✅ **ATIVO** - Usado no app macOS
+
+**Recomendação:** ✅ Manter
+
+---
+
+### ⚠️ Assets Subutilizados
+
+#### 1. **pool-bot-logo-1.png** (133KB)
+**Uso Atual:**
+- README-header.png (possivelmente relacionado)
+- Documentação
+
+**Busca no código:**
+```bash
+grep -r "pool-bot-logo" # 0 resultados em código
+```
+
+**Status:** ⚠️ **SUBUTILIZADO** - Apenas em docs/README
+
+**Recomendações:**
+1. ✅ **Manter** - Logo oficial do projeto
+2. 💡 **Oportunidade:** Usar em:
+   - Web UI (`ui/public/`)
+   - CLI help messages (ASCII art ou link)
+   - Docs header
+   - Social media cards (Twitter, LinkedIn)
+
+**Ações Sugeridas:**
+```bash
+# Mover para local mais apropriado
+mv assets/pool-bot-logo-1.png ui/public/logo.png
+# OU
+mv assets/pool-bot-logo-1.png docs/assets/branding/logo.png
+```
+
+---
+
+#### 2. **pool-bot-icon-dark.png** (1.3MB)
+**Uso Atual:**
+- Documentação
+
+**Busca no código:**
+```bash
+grep -r "pool-bot-icon" # 0 resultados em código
+```
+
+**Status:** ⚠️ **SUBUTILIZADO** - Apenas em docs
+
+**Recomendações:**
+1. ✅ **Manter** - Ícone alternativo (dark version)
+2. 💡 **Oportunidade:** Usar em:
+   - Dark mode da web UI
+   - Menubar app (alternativa)
+   - Favicon alternativo
+
+**Ações Sugeridas:**
+```bash
+# Otimizar tamanho (1.3MB está grande para um ícone)
+# Usar svg ou png otimizado
+mv assets/pool-bot-icon-dark.png docs/assets/branding/icon-dark.png
+```
+
+---
+
+### ❌ Assets Não Utilizados
+
+#### 1. **pool-bot-mascot.png** (852KB)
+**Uso Atual:**
+- **NENHUM** - Nenhuma referência encontrada no código
+
+**Busca no código:**
+```bash
+grep -r "pool-bot-mascot" # 0 resultados
+grep -r "mascot"          # 0 resultados relevantes
+```
+
+**Status:** ❌ **NÃO UTILIZADO**
+
+**Recomendações:**
+
+**Opção A: Remover** ⚠️
+```bash
+# Se não há plano de uso
+rm assets/pool-bot-mascot.png
+```
+
+**Opção B: Utilizar** 💡
+- Adicionar na web UI como elemento decorativo
+- Usar em docs de onboarding
+- Criar variações para diferentes estados (idle, working, error)
+- Usar como Easter egg no CLI
+
+**Opção C: Mover para docs** 📄
+```bash
+# Manter como asset de branding
+mv assets/pool-bot-mascot.png docs/assets/branding/mascot.png
+```
+
+**Nossa Recomendação:** **Opção C** - Mover para docs/assets/branding/
+
+---
+
+## 📊 Comparação com Projetos Similares
+
+### OpenFang
+```
+openfang/
+├── public/assets/
+│   ├── openfang-logo.png       ✅ Website + docs
+│   ├── openfang-vs-claws.png   ✅ Docs (comparação)
+│   └── rightnow-logo.webp      ✅ Docs
+```
+
+### Hermes Agent
+```
+hermes-agent/
+├── docs/
+│   └── assets/
+│       └── hero-screenshot.png ✅ Docs
+```
+
+### PoolBot (Atual)
+```
+pool-bot/
+├── assets/                     ⚠️ Subutilizado
+│   ├── pool-bot-logo-1.png     ⚠️ Apenas docs
+│   ├── pool-bot-icon-dark.png  ⚠️ Apenas docs
+│   └── pool-bot-mascot.png     ❌ Não usado
+├── docs/assets/                ✅ Bem utilizado
+└── apps/*/Assets/              ✅ Bem utilizado
+```
+
+---
+
+## 🎯 Plano de Ação Recomendado
+
+### Fase 1: Organização (Imediato)
+
+```bash
+# 1. Criar estrutura de branding
+mkdir -p docs/assets/branding
+
+# 2. Mover assets de branding para docs
+mv assets/pool-bot-logo-1.png docs/assets/branding/logo.png
+mv assets/pool-bot-icon-dark.png docs/assets/branding/icon-dark.png
+mv assets/pool-bot-mascot.png docs/assets/branding/mascot.png
+
+# 3. Manter apenas assets ativos em /assets/
+# - avatar-placeholder.svg (ativo)
+# - chrome-extension/ (ativo)
+# - dmg-background*.png (ativo)
+```
+
+### Fase 2: Utilização (Opcional)
+
+#### Web UI
+```typescript
+// ui/src/components/Logo.tsx
+import logo from '../../public/logo.png'
+
+export function Logo() {
+  return <img src={logo} alt="PoolBot" />
+}
+```
+
+#### Docs
+```markdown
+# PoolBot Documentation
+
+![PoolBot Logo](../assets/branding/logo.png)
+```
+
+#### CLI
+```typescript
+// src/cli/welcome.ts
+console.log(`
+  ╔════════════════════════════════════╗
+  ║         Pool Bot                   ║
+  ║   Your AI automation assistant     ║
+  ╚════════════════════════════════════╝
+`)
+```
+
+### Fase 3: Otimização (Opcional)
+
+```bash
+# Otimizar imagens grandes
+# pool-bot-icon-dark.png: 1.3MB → ~100KB
+# pool-bot-mascot.png: 852KB → ~200KB
+
+# Usar svgs quando possível (escalável + menor)
+# Considerar webp para melhor compressão
+```
+
+---
+
+## 📋 Checklist de Verificação
+
+### Assets Ativos ✅
+- [x] `avatar-placeholder.svg` - Usado em scripts
+- [x] `chrome-extension/icons/*` - Chrome extension
+- [x] `dmg-background.png` - macOS installer
+- [x] `dmg-background-small.png` - macOS installer
+- [x] `apps/ios/Assets.xcassets/*` - iOS app
+- [x] `apps/macos/Icon.icon/*` - macOS app
+- [x] `ui/public/favicon.ico` - Web UI
+- [x] `README-header.png` - README
+
+### Assets Subutilizados ⚠️
+- [ ] `pool-bot-logo-1.png` - Mover para docs/assets/branding/
+- [ ] `pool-bot-icon-dark.png` - Mover para docs/assets/branding/
+
+### Assets Não Utilizados ❌
+- [ ] `pool-bot-mascot.png` - Mover para docs/assets/branding/ ou remover
+
+---
+
+## 💡 Oportunidades de Melhoria
+
+### 1. **Consolidar Assets de Branding**
+```
+docs/assets/branding/
+├── logo.png              (primary logo)
+├── logo-dark.png         (dark mode variant)
+├── logo-light.png        (light mode variant)
+├── icon.svg              (vector icon)
+├── icon.png              (raster icon)
+├── mascot.png            (mascot character)
+└── banner.png            (social media banner)
+```
+
+### 2. **Adicionar SVG Versions**
+- Logos em SVG para escalabilidade
+- Ícones em SVG para web UI
+- Menor tamanho + melhor qualidade
+
+### 3. **Criar Social Media Kit**
+- Twitter card image (1200x630)
+- LinkedIn banner (1584x396)
+- GitHub social preview (1280x640)
+- Open Graph image (1200x630)
+
+### 4. **Documentar Brand Guidelines**
+```markdown
+# PoolBot Brand Guidelines
+
+## Logo Usage
+- Minimum size: 32px
+- Clear space: 1x logo height
+- Variants: light, dark, monochrome
+
+## Color Palette
+- Primary: #XXXXXX
+- Secondary: #XXXXXX
+- Accent: #XXXXXX
+
+## Typography
+- Headings: Font Name
+- Body: Font Name
+```
+
+---
+
+## ✅ Conclusão
+
+**Status Geral:** ⚠️ **PARCIALMENTE UTILIZADOS**
+
+**Resumo:**
+- ✅ **60% dos assets** estão bem utilizados (app icons, favicons, backgrounds)
+- ⚠️ **30% dos assets** estão subutilizados (logo, icon-dark)
+- ❌ **10% dos assets** não estão sendo usados (mascot)
+
+**Ações Recomendadas:**
+1. ✅ Mover assets de branding para `docs/assets/branding/`
+2. ✅ Manter apenas assets ativos em `/assets/`
+3. 💡 (Opcional) Criar variações SVG
+4. 💡 (Opcional) Adicionar social media kit
+5. 💡 (Opcional) Documentar brand guidelines
+
+**Impacto:**
+- ✅ Melhor organização
+- ✅ Mais fácil manutenção
+- ✅ Assets de branding centralizados
+- ✅ Sem breaking changes
+
+---
+
+*Documento gerado em Março de 2026.*