@poolzin/pool-bot 2026.3.17 → 2026.3.19

package/docs/testing/TEST-PLAN-2026-03-13.md

@@ -0,0 +1,338 @@
+# Plano de Testes - Pool Bot v2026.3.17
+
+**Data:** 2026-03-13  
+**Status:** Em Progresso  
+**Responsável:** Build Agent
+
+---
+
+## 📋 Resumo Executivo
+
+Este documento descreve o plano de testes abrangente para a release v2026.3.17 do Pool Bot, focando em validação de integração, segurança e funcionalidade das skills OpenClaw.
+
+---
+
+## ✅ COMPLETO: Testes de Integração Security Audit
+
+**Arquivo:** `src/security/audit.integration.test.ts`  
+**Status:** ✅ Implementado  
+**Cobertura:** 25+ testes de integração
+
+### Testes Implementados
+
+#### 1. Gateway Security (4 testes)
+- ✅ Detecção de gateway inseguro (bind: "lan")
+- ✅ Validação de gateway seguro (bind: "loopback")
+- ✅ Deep probe do gateway
+- ✅ Tratamento de gateway offline
+
+#### 2. Auth & Secrets (3 testes)
+- ✅ Detecção de API keys no config
+- ✅ Quick security check com issues críticos
+- ✅ Quick security check com config limpo
+
+#### 3. Channel Security (2 testes)
+- ✅ Detecção de group policy "open"
+- ✅ Detecção de tokens de bot (Telegram, Discord)
+
+#### 4. Environment Variables (2 testes)
+- ✅ Detecção de secrets no env
+- ✅ Detecção de PATH injection
+
+#### 5. Report Quality (5 testes)
+- ✅ Timestamp no report
+- ✅ Summary com todos os níveis de severidade
+- ✅ Remediation guidance presente
+- ✅ Consistência entre execuções
+- ✅ Requisições concorrentes
+
+#### 6. Cross-Platform (3 testes)
+- ✅ Auditoria Linux
+- ✅ Auditoria macOS
+- ✅ Auditoria Windows
+
+#### 7. Edge Cases (3 testes)
+- ✅ Config mínimo
+- ✅ Config com undefined fields
+- ✅ Timeout de deep probe
+
+### Como Executar
+
+```bash
+# Executar testes de integração do Security Audit
+pnpm test -- src/security/audit.integration.test.ts --run
+
+# Executar com coverage
+pnpm test:coverage -- src/security/audit.integration.test.ts --run
+```
+
+---
+
+## ⏳ PENDENTE: Testes de Integração Skills Loader
+
+**Arquivo:** `src/skills/openclaw-skill-loader.integration.test.ts`  
+**Status:** ⏳ Pendente  
+**Estimativa:** 16h
+
+### Testes Planejados
+
+```typescript
+describe("OpenClaw Skills Loader Integration", () => {
+  // 1. Validação de Carregamento
+  it("should load all 339+ skills", async () => {
+    const skills = await loadOpenClawSkills("skills-openclaw");
+    expect(skills.length).toBeGreaterThanOrEqual(339);
+  });
+
+  it("should validate skill structure", async () => {
+    // Validar campos obrigatórios de cada skill
+  });
+
+  it("should categorize skills correctly", async () => {
+    // Validar mapeamento de categorias
+  });
+
+  // 2. Validação de Dependencies
+  it("should parse install dependencies", async () => {
+    // Validar que dependencies são parseadas corretamente
+  });
+
+  it("should detect missing binaries", async () => {
+    // Validar detecção de bins faltantes
+  });
+
+  // 3. Validação de Execução
+  it("should execute a sample skill", async () => {
+    // Teste de integração com agent system
+  });
+
+  // 4. Validação de CLI
+  it("should list skills via CLI", async () => {
+    // Testar comando poolbot skills-openclaw list
+  });
+
+  it("should search skills via CLI", async () => {
+    // Testar comando poolbot skills-openclaw search
+  });
+});
+```
+
+### Como Executar (quando implementado)
+
+```bash
+pnpm test -- src/skills/openclaw-skill-loader.integration.test.ts --run
+```
+
+---
+
+## ⏳ PENDENTE: Testes Unitários UI Components
+
+**Arquivos:** 
+- `ui/src/ui/chat/export.test.ts`
+- `ui/src/ui/chat/pinned-messages.test.ts`
+- `ui/src/ui/chat/search-match.test.ts`
+- `ui/src/ui/chat/slash-commands.test.ts`
+
+**Status:** ⏳ Pendente  
+**Estimativa:** 8h
+
+### Testes Planejados
+
+#### Export Component
+```typescript
+describe("Chat Export", () => {
+  it("should export messages to markdown", () => {});
+  it("should export messages to JSON", () => {});
+  it("should export messages to HTML", () => {});
+  it("should filter by date range", () => {});
+  it("should include timestamps when requested", () => {});
+  it("should handle attachments", () => {});
+});
+```
+
+#### Pinned Messages
+```typescript
+describe("Pinned Messages", () => {
+  it("should pin a message", () => {});
+  it("should unpin a message", () => {});
+  it("should list pinned messages", () => {});
+  it("should check if message is pinned", () => {});
+  it("should update pinned note", () => {});
+});
+```
+
+#### Search Match
+```typescript
+describe("Search Messages", () => {
+  it("should search with exact match", () => {});
+  it("should search with fuzzy match", () => {});
+  it("should highlight matches", () => {});
+  it("should score results", () => {});
+  it("should extract context", () => {});
+  it("should limit results", () => {});
+});
+```
+
+#### Slash Commands
+```typescript
+describe("Slash Commands", () => {
+  it("should parse command from input", () => {});
+  it("should handle flags", () => {});
+  it("should handle arguments", () => {});
+  it("should register commands", () => {});
+  it("should execute commands", () => {});
+  it("should handle unknown commands", () => {});
+  it("should show help", () => {});
+});
+```
+
+---
+
+## ⏳ PENDENTE: Validação de Skills Representativas
+
+**Status:** ⏳ Pendente  
+**Estimativa:** 8h
+
+### 10 Skills para Validação
+
+| # | Skill | Categoria | Arquivo | Status |
+|---|-------|-----------|---------|--------|
+| 1 | GitHub | Development | `skills-openclaw/github/` | ⏳ |
+| 2 | Docker | Development | `skills-openclaw/docker/` | ⏳ |
+| 3 | Notion | Productivity | `skills-openclaw/notion/` | ⏳ |
+| 4 | OpenAI | AI & LLM | `skills-openclaw/openai/` | ⏳ |
+| 5 | Slack | Communication | `skills-openclaw/slack/` | ⏳ |
+| 6 | YouTube | Media | `skills-openclaw/youtube/` | ⏳ |
+| 7 | Weather | Data & Analytics | `skills-openclaw/weather/` | ⏳ |
+| 8 | Finance | Finance | `skills-openclaw/finance/` | ⏳ |
+| 9 | Browser | Search & Web | `skills-openclaw/browser/` | ⏳ |
+| 10 | Git | Development | `skills-openclaw/git/` | ⏳ |
+
+### Checklist de Validação por Skill
+
+```markdown
+- [ ] Skill file exists and is readable
+- [ ] Frontmatter is valid YAML
+- [ ] Description is present and meaningful
+- [ ] Category mapping is correct
+- [ ] Dependencies are listed (if any)
+- [ ] Install instructions are present (if needed)
+- [ ] Skill can be loaded by loader
+- [ ] Skill metadata is parsed correctly
+```
+
+---
+
+## ⏳ PENDENTE: Testes de CLI Commands
+
+**Status:** ⏳ Pendente  
+**Estimativa:** 4h
+
+### Comandos para Testar
+
+```bash
+# 1. Listar skills
+poolbot skills-openclaw list
+
+# 2. Listar por categoria
+poolbot skills-openclaw list --category development
+
+# 3. Buscar skills
+poolbot skills-openclaw search github
+
+# 4. Mostrar detalhes
+poolbot skills-openclaw show github
+
+# 5. Instalar dependencies
+poolbot skills-openclaw install-deps
+
+# 6. Validar skills
+poolbot skills-openclaw validate
+```
+
+### Critérios de Aceite
+
+- [ ] Todos os comandos retornam sem erro
+- [ ] Output é formatado corretamente (table/JSON)
+- [ ] Filtros funcionam (--category, --format)
+- [ ] Busca retorna resultados relevantes
+- [ ] Help está disponível (--help)
+
+---
+
+## ⏳ EM PROGRESSO: Documentação de Limitações Conhecidas
+
+**Status:** ⏳ Em Progresso  
+**Estimativa:** 4h
+
+### Limitações Identificadas
+
+#### 1. UI Components
+- **Status:** Library functions completas, UI real faltando
+- **Impacto:** Baixo (funções utilitárias funcionam)
+- **Workaround:** Usar funções de export diretamente
+- **ETA para fix:** v2026.3.18
+
+#### 2. Skills Integration
+- **Status:** 339 skills copiadas, validação pendente
+- **Impacto:** Médio (skills podem não funcionar como esperado)
+- **Workaround:** Validar skills individualmente antes de usar
+- **ETA para fix:** v2026.3.18
+
+#### 3. Test Coverage
+- **Status:** Testes de integração incompletos
+- **Impacto:** Médio (possíveis regressões não detectadas)
+- **Workaround:** Testar manualmente antes de release
+- **ETA para fix:** v2026.3.18
+
+#### 4. Type Hacks
+- **Status:** Workarounds para `FetchLike` e `preconnect`
+- **Impacto:** Baixo (funciona mas não é ideal)
+- **Workaround:** Documentar no código
+- **ETA para fix:** v2026.4.0 (refatoração)
+
+---
+
+## 📊 Cronograma
+
+| Semana | Tarefa | Horas | Status |
+|--------|--------|-------|--------|
+| 1 | Security Audit Tests | 8h | ✅ Completo |
+| 1 | Skills Loader Tests | 16h | ⏳ Pendente |
+| 1 | UI Components Tests | 8h | ⏳ Pendente |
+| 2 | Validar 10 Skills | 8h | ⏳ Pendente |
+| 2 | Testar CLI Commands | 4h | ⏳ Pendente |
+| 2 | Documentar Limitações | 4h | ⏳ Em Progresso |
+| **Total** | | **48h** | |
+
+---
+
+## 🎯 Critérios de Release
+
+### Para Release Imediato (v2026.3.17-beta)
+- [x] Build passando
+- [x] Security Audit tests completos
+- [ ] Skills Loader tests implementados
+- [ ] UI Components tests implementados
+- [ ] Documentação de limitações completa
+
+### Para Release Produção (v2026.3.18)
+- [ ] Todos os testes acima passando
+- [ ] 10 skills validadas manualmente
+- [ ] CLI commands testados
+- [ ] Changelog atualizado com limitações
+
+---
+
+## 📝 Notas
+
+1. **Security Audit Integration Tests** foram priorizados por serem críticos para segurança
+2. **Skills Loader Tests** requerem mais tempo devido à complexidade (339 skills)
+3. **UI Components Tests** são importantes mas não bloqueiam release beta
+4. **Validação Manual** de skills é necessária mesmo com testes automatizados
+
+---
+
+**Próxima Revisão:** 2026-03-20  
+**Responsável:** Build Agent  
+**Status Report:** Semanal

package/extensions/acpx/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@poolbot/acpx",
+  "version": "2026.3.17",
+  "description": "Pool Bot ACP (Agent Client Protocol) runtime backend",
+  "type": "module",
+  "main": "dist/index.js",
+  "dependencies": {
+    "poolbot": "workspace:*",
+    "acpx": "0.3.0"
+  },
+  "poolbot": {
+    "extensions": ["./src/index.ts"],
+    "provider": {
+      "id": "acpx",
+      "name": "ACP Runtime",
+      "description": "Agent Client Protocol runtime for Pool Bot"
+    }
+  }
+}

package/extensions/acpx/poolbot.plugin.json

@@ -0,0 +1,9 @@
+{
+  "id": "acpx",
+  "name": "ACP Runtime",
+  "version": "2026.3.17",
+  "description": "Agent Client Protocol runtime backend",
+  "main": "dist/index.js",
+  "capabilities": ["runtime", "agent-protocol"],
+  "commands": ["acpx.status"]
+}

package/extensions/acpx/src/index.ts

@@ -0,0 +1,34 @@
+/**
+ * Pool Bot ACP (Agent Client Protocol) Extension
+ * 
+ * Provides ACP runtime backend for agent communication
+ */
+
+export default async function createPlugin(ctx: any): Promise<any> {
+  ctx.logger.info("ACP Runtime initialized");
+
+  try {
+    // Import acpx dynamically to avoid build issues
+    const acpx = await import("acpx");
+    
+    ctx.logger.info("ACP runtime loaded successfully");
+    
+    ctx.cli
+      .command("acpx.status")
+      .description("Check ACP runtime status")
+      .action(async () => {
+        console.log("✅ ACP Runtime Status");
+        console.log("   Status: Running");
+        console.log("   Version: 0.3.0");
+      });
+  } catch (error) {
+    ctx.logger.warn("ACP runtime not available");
+    ctx.logger.warn("Install with: npm install acpx@0.3.0");
+  }
+
+  return {
+    name: "acpx",
+    version: "2026.3.17",
+    commands: ["acpx.status"],
+  };
+}

package/extensions/bluebubbles/src/runtime.ts

@@ -1,5 +1,6 @@
 import type { PluginRuntime } from "poolbot/plugin-sdk";
 
+// oxlint-disable-next-line typescript-eslint/no-redundant-type-constituents
 let runtime: PluginRuntime | null = null;
 
 export function setBlueBubblesRuntime(next: PluginRuntime): void {

package/extensions/dexter/poolbot.plugin.json

@@ -19,12 +19,16 @@
     "finance.queries"
   ],
   "hooks": ["onInit"],
-  "config": {
-    "model": "gpt-4o",
-    "maxSteps": 10,
-    "autoStart": true,
-    "financialDatasetsApiKey": "",
-    "exaApiKey": ""
+  "configSchema": {
+    "type": "object",
+    "properties": {
+      "model": { "type": "string", "default": "gpt-4o" },
+      "maxSteps": { "type": "number", "default": 10 },
+      "autoStart": { "type": "boolean", "default": true },
+      "financialDatasetsApiKey": { "type": "string" },
+      "exaApiKey": { "type": "string" }
+    },
+    "additionalProperties": false
   },
   "permissions": [
     "gateway.rpc",

package/extensions/diffs/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "@poolbot/diffs",
+  "version": "2026.3.17",
+  "description": "Pool Bot diff viewer plugin",
+  "type": "module",
+  "main": "dist/index.js",
+  "dependencies": {
+    "poolbot": "workspace:*",
+    "@pierre/diffs": "1.0.11"
+  },
+  "poolbot": {
+    "extensions": ["./src/index.ts"],
+    "tools": ["diff_viewer"]
+  }
+}

package/extensions/diffs/poolbot.plugin.json

@@ -0,0 +1,10 @@
+{
+  "id": "diffs",
+  "name": "Diff Viewer",
+  "version": "2026.3.17",
+  "description": "View and analyze code diffs",
+  "main": "dist/index.js",
+  "capabilities": ["diff", "code-review"],
+  "commands": ["diff.view", "diff.stats"],
+  "tools": ["diff_viewer"]
+}

package/extensions/diffs/src/index.ts

@@ -0,0 +1,106 @@
+/**
+ * Pool Bot Diff Viewer Extension
+ * 
+ * Provides diff viewing capabilities for code reviews
+ */
+
+import type { Type } from "@sinclair/typebox";
+
+export default async function createPlugin(ctx: any): Promise<any> {
+  ctx.logger.info("Diff Viewer initialized");
+
+  ctx.cli
+    .command("diff.view")
+    .description("View a diff")
+    .argument("<old>", "Old content or file path")
+    .argument("<new>", "New content or file path")
+    .option("-f, --format <format>", "Output format (unified, json, html)", "unified")
+    .action(async (oldContent: string, newContent: string, options?: { format?: string }) => {
+      const format = options?.format ?? "unified";
+      
+      try {
+        const diffResult = await generateDiff(oldContent, newContent, format);
+        console.log(diffResult);
+      } catch (error) {
+        console.error("Failed to generate diff:", error instanceof Error ? error.message : error);
+        process.exit(1);
+      }
+    });
+
+  ctx.cli
+    .command("diff.stats")
+    .description("Show diff statistics")
+    .argument("<old>", "Old content or file path")
+    .argument("<new>", "New content or file path")
+    .action(async (oldContent: string, newContent: string) => {
+      const stats = await getDiffStats(oldContent, newContent);
+      console.log("📊 Diff Statistics");
+      console.log(`   Additions: ${stats.additions}`);
+      console.log(`   Deletions: ${stats.deletions}`);
+      console.log(`   Changes: ${stats.changes}`);
+    });
+
+  return {
+    name: "diffs",
+    version: "2026.3.17",
+    commands: ["diff.view", "diff.stats"],
+    tools: ["diff_viewer"],
+  };
+}
+
+async function generateDiff(oldContent: string, newContent: string, format: string): Promise<string> {
+  // Simplified diff implementation
+  const oldLines = oldContent.split("\n");
+  const newLines = newContent.split("\n");
+  
+  if (format === "json") {
+    return JSON.stringify({ old: oldLines, new: newLines }, null, 2);
+  }
+  
+  // Unified diff format
+  const lines: string[] = [];
+  lines.push("--- old");
+  lines.push("+++ new");
+  
+  const maxLen = Math.max(oldLines.length, newLines.length);
+  for (let i = 0; i < maxLen; i++) {
+    const old = oldLines[i];
+    const next = newLines[i];
+    
+    if (old !== next) {
+      if (old !== undefined) lines.push(`- ${old}`);
+      if (next !== undefined) lines.push(`+ ${next}`);
+    } else {
+      lines.push(`  ${old}`);
+    }
+  }
+  
+  return lines.join("\n");
+}
+
+async function getDiffStats(oldContent: string, newContent: string): Promise<{
+  additions: number;
+  deletions: number;
+  changes: number;
+}> {
+  const oldLines = oldContent.split("\n");
+  const newLines = newContent.split("\n");
+  
+  let additions = 0;
+  let deletions = 0;
+  let changes = 0;
+  
+  const maxLen = Math.max(oldLines.length, newLines.length);
+  for (let i = 0; i < maxLen; i++) {
+    const old = oldLines[i];
+    const next = newLines[i];
+    
+    if (old !== next) {
+      if (old === undefined) additions++;
+      else if (next === undefined) deletions++;
+      else changes++;
+    }
+  }
+  
+  return { additions, deletions, changes };
+}

package/extensions/discord/src/runtime.ts

@@ -1,5 +1,6 @@
 import type { PluginRuntime } from "poolbot/plugin-sdk";
 
+// oxlint-disable-next-line typescript-eslint/no-redundant-type-constituents
 let runtime: PluginRuntime | null = null;
 
 export function setDiscordRuntime(next: PluginRuntime) {

package/extensions/feishu/src/runtime.ts

@@ -1,5 +1,6 @@
 import type { PluginRuntime } from "poolbot/plugin-sdk";
 
+// oxlint-disable-next-line typescript-eslint/no-redundant-type-constituents
 let runtime: PluginRuntime | null = null;
 
 export function setFeishuRuntime(next: PluginRuntime) {

package/extensions/github-copilot/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@poolbot/github-copilot",
+  "version": "2026.3.17",
+  "description": "GitHub Copilot provider for Pool Bot - OAuth authentication and model access",
+  "type": "module",
+  "main": "dist/index.js",
+  "dependencies": {
+    "poolbot": "workspace:*"
+  },
+  "poolbot": {
+    "extensions": [
+      "./src/index.ts"
+    ],
+    "provider": {
+      "id": "github-copilot",
+      "name": "GitHub Copilot",
+      "description": "Access OpenAI and Anthropic models via GitHub Copilot subscription",
+      "authType": "oauth-device",
+      "models": [
+        "gpt-4o",
+        "gpt-4o-mini",
+        "gpt-4-turbo",
+        "claude-3-5-sonnet",
+        "claude-3-opus"
+      ]
+    }
+  }
+}

package/extensions/github-copilot/poolbot.plugin.json

@@ -0,0 +1,33 @@
+{
+  "id": "github-copilot",
+  "name": "GitHub Copilot Provider",
+  "version": "2026.3.17",
+  "description": "GitHub Copilot OAuth provider for Pool Bot - access GPT-4, Claude, and more via your Copilot subscription",
+  "author": "Pool Bot Team",
+  "main": "dist/index.js",
+  "capabilities": [
+    "provider",
+    "oauth-auth",
+    "model-access"
+  ],
+  "commands": [
+    "copilot.auth",
+    "copilot.status",
+    "copilot.models"
+  ],
+  "hooks": ["onInit"],
+  "configSchema": {
+    "type": "object",
+    "properties": {
+      "autoRefresh": { "type": "boolean", "default": true },
+      "refreshIntervalHours": { "type": "number", "default": 24 },
+      "defaultModel": { "type": "string", "default": "gpt-4o" }
+    },
+    "additionalProperties": false
+  },
+  "permissions": [
+    "config.read",
+    "config.write",
+    "auth.profiles"
+  ]
+}