feat: biblioteca inteligente libs/ + 5 novas skills (20 skills total)
NOVAS SKILLS: - next-best-practices v0.1.0 (CLEAN) — Next.js App Router, RSC, caching, data - nextjs-patterns v1.0.0 (CLEAN) — Next.js 15: Server Actions, route handlers - vite v1.0.0 (CLEAN) — env vars, aliases, proxy, CJS compat - uncle-bob v1.0.0 (CLEAN) — Clean Code, SOLID, Clean Architecture - clean-code-review v1.0.0 (CLEAN) — naming, guard clauses, anti-patterns, refactoring - vue v1.0.0 (CLEAN) — Vue framework - vue-composition-api-best-practices v1.0.0 (CLEAN) — composables, Pinia, reactivity BIBLIOTECA INTELIGENTE libs/ (10 dominios, 11 arquivos): - typescript/ — TS safe + generics gotchas - react/ — Next.js App Router + Vite config - vue/ — Composition API + Pinia - linux/ — System diagnostic cheatsheet - database/ — PostgreSQL + MySQL patterns - browser/ — Chromium CLI + E2E testing - security/ — SAST audit (OWASP Top 10) - best-practices/ — Clean Code + SOLID + Clean Architecture - deploy/ — Docker multi-stack + OpenClaw ops - + INDEX.md como guia de navegacao .learnings/ — LRN-20260519-003 criado (biblioteca compartilhada)
This commit is contained in:
@@ -0,0 +1,91 @@
|
||||
# Browser Automation — Chromium CLI (agent-browser)
|
||||
|
||||
> CLI headless Chromium para navegação, login, raspagem e screenshots.
|
||||
|
||||
## Fluxo Padrão
|
||||
```bash
|
||||
agent-browser open https://exemplo.com/form
|
||||
agent-browser snapshot -i # Descobre elementos → @e1, @e2, @e3
|
||||
agent-browser fill @e1 "user@exemplo.com"
|
||||
agent-browser fill @e2 "senha123"
|
||||
agent-browser click @e3
|
||||
agent-browser wait --load networkidle
|
||||
agent-browser snapshot -i # Re-snapshot após mudança de DOM
|
||||
```
|
||||
|
||||
## Comandos Essenciais
|
||||
```bash
|
||||
# Navegação
|
||||
agent-browser open <url>
|
||||
agent-browser close
|
||||
|
||||
# Snapshot (sempre primeiro)
|
||||
agent-browser snapshot -i # Elementos interativos + @refs
|
||||
agent-browser snapshot -i -C # + cursor-interactive elements
|
||||
|
||||
# Interação com @refs
|
||||
agent-browser click @e1
|
||||
agent-browser fill @e2 "text" # Clear + type
|
||||
agent-browser type @e2 "text" # Type sem limpar
|
||||
agent-browser select @e1 "option"
|
||||
agent-browser check @e1
|
||||
agent-browser press Enter
|
||||
agent-browser scroll down 500
|
||||
agent-browser hover @e1
|
||||
|
||||
# Extração
|
||||
agent-browser get text @e1
|
||||
agent-browser get text body > page.txt
|
||||
agent-browser get html @e1
|
||||
agent-browser get url
|
||||
agent-browser get title
|
||||
|
||||
# Espera
|
||||
agent-browser wait @e1
|
||||
agent-browser wait --load networkidle
|
||||
agent-browser wait --url "**/dashboard"
|
||||
|
||||
# Captura
|
||||
agent-browser screenshot page.png
|
||||
agent-browser screenshot --full # Página inteira
|
||||
agent-browser pdf relatorio.pdf
|
||||
|
||||
# Download
|
||||
agent-browser download @e1 ./file.pdf
|
||||
agent-browser wait --download ./output.zip
|
||||
```
|
||||
|
||||
## 🔐 Login + Persistência de Sessão
|
||||
```bash
|
||||
# Login
|
||||
agent-browser open https://app.exemplo.com/login
|
||||
agent-browser fill @e1 "$USERNAME" && agent-browser fill @e2 "$PASSWORD"
|
||||
agent-browser click @e3
|
||||
agent-browser wait --url "**/dashboard"
|
||||
agent-browser state save ~/auth.json # Salva cookies + sessão
|
||||
|
||||
# Reutilizar
|
||||
agent-browser state load ~/auth.json
|
||||
agent-browser open https://app.exemplo.com/dashboard
|
||||
```
|
||||
|
||||
## 🔒 Segurança (ambiente)
|
||||
```bash
|
||||
export AGENT_BROWSER_ALLOWED_DOMAINS="exemplo.com"
|
||||
export AGENT_BROWSER_MAX_OUTPUT=50000
|
||||
export AGENT_BROWSER_CONTENT_BOUNDARIES=1
|
||||
```
|
||||
|
||||
## ⚠️ Ref Lifecycle
|
||||
> Refs (`@e1`, `@e2`) são **invalidados** após qualquer mudança de DOM.
|
||||
> Sempre faça `snapshot -i` de novo após:
|
||||
> - Cliques que navegam
|
||||
> - Submissão de formulário
|
||||
> - Conteúdo dinâmico (dropdowns, modais)
|
||||
|
||||
## Sessões Paralelas
|
||||
```bash
|
||||
agent-browser --session site1 open https://site-a.com
|
||||
agent-browser --session site2 open https://site-b.com
|
||||
agent-browser session list
|
||||
```
|
||||
@@ -0,0 +1,37 @@
|
||||
# E2E Testing — Pirâmide e Padrões
|
||||
|
||||
> Extraído de `e2e-testing-patterns` v1.0.0
|
||||
|
||||
## 🏔️ Test Pyramid
|
||||
```
|
||||
/\ ← POUCOS: Critical paths (E2E)
|
||||
/E2E\ ← MAIS: Component/API integration
|
||||
/─────\
|
||||
/Integr\ ← MUITOS: Unit tests (rápidos, isolados)
|
||||
/────────\
|
||||
/Unit Tests\
|
||||
/────────────\
|
||||
```
|
||||
|
||||
## O que E2E Tests DEVEM cobrir
|
||||
| ✅ E2E | ❌ Não E2E |
|
||||
|--------|-----------|
|
||||
| Critical journeys (auth → dashboard → logout) | Lógica unitária → use unit tests |
|
||||
| Multi-step flows (checkout, onboarding) | API contracts → use integration |
|
||||
| Cross-browser | Edge cases (muito lento) |
|
||||
| Real API integration | Internal implementation |
|
||||
| Auth flows | Visual states → use Storybook |
|
||||
|
||||
## Core Principles
|
||||
| Princípio | Como |
|
||||
|-----------|------|
|
||||
| **Test behavior, not implementation** | Assert em outcomes visíveis, não estrutura DOM |
|
||||
| **Independent tests** | Cada teste cria próprios dados e limpa |
|
||||
| **Deterministic waits** | Esperar por condição, não timeout fixo |
|
||||
| **Stable selectors** | Usar `data-testid`, roles, labels — nunca CSS classes |
|
||||
| **Fast feedback** | Mockar serviços externos, paralelizar, shard |
|
||||
|
||||
## Selector Priority
|
||||
```
|
||||
data-testid → data-cy → role → text → id → class (último recurso)
|
||||
```
|
||||
Reference in New Issue
Block a user