agente-testes 0.4.7__tar.gz

agente_testes-0.4.7/.cursor/rules/commit-patterns.mdc

@@ -0,0 +1,44 @@
+---
+description: Padrão de commits iuricode + Conventional Commits (emoji, tipo, português)
+alwaysApply: true
+---
+
+# Commits — iuricode/padroes-de-commits
+
+Referência: https://github.com/iuricode/padroes-de-commits
+
+## Formato obrigatório
+
+```
+:emoji: tipo: Descrição curta
+```
+
+ou, sem emoji:
+
+```
+tipo: Descrição curta
+```
+
+Escopo opcional: `tipo(escopo): …` — ex.: `feat(cli): …`
+
+## Regras
+
+- Título curto (≈4 palavras); detalhes no corpo do commit.
+- Português na descrição; imperativo ("Adicionar", "Corrigir", "Atualizar").
+- Tipos: `feat`, `fix`, `docs`, `test`, `refactor`, `perf`, `style`, `chore`, `build`, `ci`, `raw`, `cleanup`, `remove`, `revert`.
+- Emojis comuns: `:sparkles:` feat, `:bug:` fix, `:books:` docs, `:test_tube:` test, `:recycle:` refactor, `:wrench:` chore, `:bricks:` ci.
+- Nunca commitar `.env` ou secrets.
+- Manter `Co-Authored-By: Cursor <noreply@cursor.com>` no rodapé quando o commit for feito pelo agente.
+
+## Exemplos válidos
+
+- `:sparkles: feat: Comando init do workspace`
+- `:bug: fix: Corrigir path do spec Playwright`
+- `:books: docs: Atualizar README de instalacao`
+
+## Exemplos inválidos
+
+- `feat(cli): add Phase 2` (inglês sem emoji — evitar)
+- `WIP` / `fix stuff` (sem tipo)
+
+Guia completo: `docs/COMMITS.md`

agente_testes-0.4.7/.env.example

@@ -0,0 +1,20 @@
+# Copie para .env e preencha com valores reais (nunca commite .env)
+# cp .env.example .env
+
+# --- CrewAI / LLM (obrigatório para `agente-testes run`) ---
+OPENAI_API_KEY=
+# Nome do modelo OpenAI; prefixo openai/ é aplicado automaticamente se omitido
+MODEL=openai/gpt-4o-mini
+
+# --- Aplicação sob teste ---
+# URL base do app (preferida; evita conflito com BASE_URL do CrewAI)
+AGENTE_TESTES_APP_URL=http://localhost:3000
+# Fallback legado; o CLI também aceita --url
+BASE_URL=http://localhost:3000
+
+# --- Pedido padrão (opcional; sobrescrito pelo argumento `run`) ---
+USER_REQUEST=
+
+# --- Credenciais E2E (opcional; referenciadas nos scripts Playwright gerados) ---
+TEST_USER=
+TEST_PASSWORD=

agente_testes-0.4.7/.env.schema

@@ -0,0 +1,23 @@
+# Schema Varlock — valores reais ficam em .env (gitignored)
+# @defaultSensitive=true @defaultRequired=infer
+
+# @type=string(startsWith=sk_) @required @sensitive
+OPENAI_API_KEY=
+
+# @type=string @sensitive=false
+MODEL=openai/gpt-4o-mini
+
+# @type=url @sensitive=false
+AGENTE_TESTES_APP_URL=http://localhost:3000
+
+# @type=url @sensitive=false
+BASE_URL=http://localhost:3000
+
+# @type=string @sensitive=false
+USER_REQUEST=
+
+# @type=string @sensitive
+TEST_USER=
+
+# @type=string @sensitive
+TEST_PASSWORD=

agente_testes-0.4.7/.github/workflows/ci.yml

@@ -0,0 +1,98 @@
+name: CI
+
+on:
+  push:
+    branches: [master, main]
+  pull_request:
+    branches: [master, main]
+
+concurrency:
+  group: ci-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  smoke-and-deterministic-e2e:
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: npm
+
+      - name: Setup uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Install Python dependencies
+        run: uv sync
+
+      - name: Install Playwright (npm + Chromium)
+        run: |
+          npm ci
+          npx playwright install --with-deps chromium
+
+      - name: Start demo app
+        run: |
+          node fixtures/demo-app/server.js &
+          for i in $(seq 1 30); do
+            if curl -fsS http://localhost:3000/login > /dev/null; then
+              echo "Demo app ready"
+              exit 0
+            fi
+            sleep 1
+          done
+          echo "Demo app failed to start"
+          exit 1
+
+      - name: Smoke tools (sem LLM)
+        run: uv run python scripts/smoke_tools.py
+
+      - name: Unit tests (sem LLM)
+        run: uv run --group dev pytest tests/ -q
+
+      - name: Verify self-healing (sem LLM)
+        run: uv run python scripts/verify_healing.py
+
+      - name: Exec spec versionado — login inválido (determinístico)
+        run: |
+          uv run agente-testes exec tests/e2e/demo-login-invalid.spec.js \
+            --repo fixtures/demo-app \
+            --url http://localhost:3000
+
+      - name: Gerar storageState (auth setup)
+        env:
+          TEST_USER: usuario-demo@exemplo.com
+          TEST_PASSWORD: senha-demo
+        run: |
+          uv run agente-testes auth-setup \
+            --repo fixtures/demo-app \
+            --url http://localhost:3000
+
+      - name: Exec spec versionado — dashboard autenticado
+        env:
+          TEST_USER: usuario-demo@exemplo.com
+          TEST_PASSWORD: senha-demo
+          AGENTE_TESTES_STORAGE_STATE: fixtures/demo-app/.agente-testes/artifacts/auth-state.json
+        run: |
+          uv run agente-testes exec tests/e2e/demo-dashboard-authenticated.spec.js \
+            --repo fixtures/demo-app \
+            --url http://localhost:3000
+
+      - name: Upload artefatos E2E
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: agente-testes-artifacts
+          path: |
+            fixtures/demo-app/.agente-testes/output/
+            fixtures/demo-app/.agente-testes/artifacts/
+            fixtures/demo-app/.agente-testes/temp_specs/
+          retention-days: 14
+          if-no-files-found: warn

agente_testes-0.4.7/.github/workflows/e2e-ai.yml

@@ -0,0 +1,74 @@
+name: E2E com IA
+
+on:
+  workflow_dispatch:
+    inputs:
+      request:
+        description: Pedido em linguagem natural
+        required: true
+        default: "Validar login com e-mail inválido na rota /login"
+      base_url:
+        description: URL base do app
+        required: false
+        default: "http://localhost:3000"
+
+jobs:
+  ai-e2e:
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: npm
+
+      - name: Setup uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Install Python dependencies
+        run: uv sync
+
+      - name: Install Playwright (npm + Chromium)
+        run: |
+          npm ci
+          npx playwright install --with-deps chromium
+
+      - name: Start demo app
+        run: |
+          node fixtures/demo-app/server.js &
+          for i in $(seq 1 30); do
+            if curl -fsS http://localhost:3000/login > /dev/null; then
+              echo "Demo app ready"
+              exit 0
+            fi
+            sleep 1
+          done
+          echo "Demo app failed to start"
+          exit 1
+
+      - name: Executar agente-testes run (IA)
+        env:
+          OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
+        run: |
+          uv run agente-testes run "${{ inputs.request }}" \
+            --repo fixtures/demo-app \
+            --url "${{ inputs.base_url }}"
+
+      - name: Upload artefatos E2E (IA)
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: agente-testes-ai-artifacts
+          path: |
+            fixtures/demo-app/.agente-testes/output/
+            fixtures/demo-app/.agente-testes/artifacts/
+            fixtures/demo-app/.agente-testes/temp_specs/
+          retention-days: 14
+          if-no-files-found: warn

agente_testes-0.4.7/.github/workflows/publish-pypi.yml

@@ -0,0 +1,30 @@
+name: Publish PyPI
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Build package
+        run: uv build
+
+      - name: Publish to PyPI (Trusted Publisher)
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}
+          skip-existing: true

agente_testes-0.4.7/.gitignore

@@ -0,0 +1,46 @@
+# Secrets — nunca commitar
+.env
+.env.*
+!.env.example
+!.env.schema
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+.venv/
+.pytest_cache/
+*.egg-info/
+dist/
+build/
+
+# Node / Playwright
+node_modules/
+test-results/
+playwright-report/
+blob-report/
+
+# Artefatos de execução (pacote legado, fallback sem workspace)
+output/*
+!output/.gitkeep
+artifacts/*
+!artifacts/.gitkeep
+temp_specs/*
+!temp_specs/.gitkeep
+
+# Workspace por projeto alvo (criado em <repo>/.agente-testes/)
+**/.agente-testes/
+
+# Logs e temporários
+*.log
+npm-debug.log*
+yarn-error.log*
+*.tmp
+*.temp
+*.cache
+*.swp
+
+# SO / IDE
+.DS_Store
+Thumbs.db
+desktop.ini

agente_testes-0.4.7/.gitmessage

@@ -0,0 +1,15 @@
+# :emoji: tipo: Descricao curta (max. ~4 palavras no titulo)
+#
+# Tipos: feat | fix | docs | test | build | perf | style | refactor | chore | ci | raw | cleanup | remove
+#
+# Exemplos:
+#   :sparkles: feat: Pagina de login
+#   :bug: fix: Corrigir seletor do formulario
+#   :books: docs: Atualizar README
+#   :test_tube: test: Cobrir self-healing
+#
+# Corpo (opcional): impacto, motivo, instrucoes futuras.
+# Rodape (opcional): Refs #123 | Reviewed-by: Nome
+#
+# Guia: docs/COMMITS.md
+# Referencia: https://github.com/iuricode/padroes-de-commits

agente_testes-0.4.7/AGENTS.md

@@ -0,0 +1,65 @@
+# Agent Instructions
+
+CrewAI E2E: linguagem natural → Playwright → relatório. Ver `README.md` para setup.
+
+## Package Manager
+
+- **Python:** `uv sync` na raiz do projeto
+- **Node (Playwright):** `npm install` + `npx playwright install chromium`
+
+## File-Scoped Commands
+
+| Task | Command |
+|------|---------|
+| Setup global | `uv tool install .` + `agente-testes setup` |
+| Doctor | `uv run agente-testes doctor` |
+| Run crew | `uv run agente-testes run "pedido"` |
+| Exec spec (CI) | `uv run agente-testes exec tests/e2e/demo-login-invalid.spec.js --repo fixtures/demo-app` |
+| Smoke (sem LLM) | `uv run python scripts/smoke_tools.py` |
+| Demo app | `uv run python scripts/start_demo.py` |
+
+## Key Conventions
+
+- Working dir alvo: passe `--repo` ou rode de dentro do projeto testado
+- Workspace de execução: `<repo-alvo>/.agente-testes/` (gitignored)
+- URL do app: `AGENTE_TESTES_APP_URL` (não use `BASE_URL` para CrewAI LLM)
+- Secrets: só em `.env` local; validar com `varlock load` se instalado
+- Nunca ler/commitar `.env`; schema em `.env.schema`
+- Tools sensíveis: `src/agente_testes/security.py` (denylist + redaction)
+- Config crew: `src/agente_testes/config/{agents,tasks}.yaml`, `crew.py`
+
+## Commits
+
+Padrão [iuricode/padroes-de-commits](https://github.com/iuricode/padroes-de-commits):
+
+```
+:emoji: tipo: Descrição curta
+```
+
+Ex.: `:sparkles: feat: Comando init do workspace` — ver `docs/COMMITS.md`.
+
+Hook local: `.\scripts\install-git-hooks.ps1`
+
+## Commit Attribution
+
+AI commits MUST include:
+
+```
+Co-Authored-By: Cursor <noreply@cursor.com>
+```
+
+## Structure
+
+```
+src/agente_testes/cli.py          Entrada CLI
+src/agente_testes/crew.py         Agentes e tasks
+src/agente_testes/tools/          Playwright + repositório
+src/agente_testes/security.py     Hardening de secrets
+fixtures/demo-app/                Demo HTTP :3000
+```
+
+## Do Not
+
+- Commitar `.env`, `.venv/`, `node_modules/`, `test-results/`, artefatos em `output/`/`artifacts/`/`temp_specs/`
+- Hardcodar API keys ou senhas em código ou specs
+- Usar `os.environ.copy()` em subprocessos — usar `minimal_playwright_env()`

agente_testes-0.4.7/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 BrunooooPaiva
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

agente_testes-0.4.7/PKG-INFO

@@ -0,0 +1,180 @@
+Metadata-Version: 2.4
+Name: agente-testes
+Version: 0.4.7
+Summary: CLI de testes E2E com IA: linguagem natural vira Playwright executável.
+Project-URL: Homepage, https://github.com/BrunooooPaiva/agente-testes
+Project-URL: Repository, https://github.com/BrunooooPaiva/agente-testes
+Project-URL: Issues, https://github.com/BrunooooPaiva/agente-testes/issues
+Project-URL: Documentation, https://github.com/BrunooooPaiva/agente-testes#readme
+Project-URL: Changelog, https://github.com/BrunooooPaiva/agente-testes/releases
+Author: BrunooooPaiva
+License-Expression: MIT
+License-File: LICENSE
+Keywords: cli,crewai,e2e,playwright,qa,testing
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Testing
+Requires-Python: <3.14,>=3.10
+Requires-Dist: crewai[tools]==1.14.5a2
+Requires-Dist: python-dotenv>=1.0.0
+Description-Content-Type: text/markdown
+
+# Agente Testes
+
+CLI que transforma pedidos em **linguagem natural** em testes **Playwright** executáveis, com relatório e evidências — powered by CrewAI.
+
+Repositório: https://github.com/BrunooooPaiva/agente-testes
+
+## Instalação global (recomendado)
+
+**Pré-requisitos:** Python 3.10–3.13, Node.js 18+ (`npm`/`npx` no PATH), chave OpenAI.
+
+### Opção A — PyPI (recomendado)
+
+```powershell
+pip install --pre agente-testes
+agente-testes setup
+```
+
+Com [uv](https://docs.astral.sh/uv/):
+
+```powershell
+uv tool install --pre agente-testes
+agente-testes setup
+```
+
+### Opção B — `uv tool` a partir do repositório
+
+```powershell
+cd agente_testes
+uv tool install --prerelease=allow .
+agente-testes setup
+```
+
+### Opção C — repositório Git
+
+```powershell
+pip install "agente-testes @ git+https://github.com/BrunooooPaiva/agente-testes.git"
+agente-testes setup
+```
+
+O comando `setup` cria `~/.agente-testes/.env`, instala `@playwright/test` e o Chromium no runtime global.
+
+Edite a API key:
+
+```powershell
+notepad $env:USERPROFILE\.agente-testes\.env
+```
+
+## Fluxo CLI (3 passos)
+
+```powershell
+# 1. Entre no projeto que quer testar
+cd C:\projetos\meu-app
+
+# 2. (opcional) prepara workspace local
+agente-testes init
+
+# 3. Com o app rodando (npm run dev), peça o teste
+agente-testes run "Validar login com e-mail inválido na rota /login"
+```
+
+Saída esperada: status ✅/❌, caminhos do relatório, spec e artefatos em `.agente-testes/`.
+
+## Comandos
+
+| Comando | Descrição |
+|---------|-----------|
+| `agente-testes run "<pedido>"` | Fluxo completo com IA: análise → Playwright → execução → relatório |
+| `agente-testes exec <spec>` | Executa spec versionado **sem IA** (ideal para CI) |
+| `agente-testes init` | Cria `.agente-testes/` e entradas no `.gitignore` do projeto |
+| `agente-testes doctor` | Valida Python, API key, npx, Playwright, URL e portas locais |
+| `agente-testes setup` | Instala runtime Playwright (uso global) |
+| `agente-testes --verbose run ...` | Logs completos do CrewAI |
+
+Exemplo determinístico (CT-02 versionado):
+
+```powershell
+agente-testes exec tests/e2e/demo-login-invalid.spec.js --repo fixtures/demo-app
+```
+
+Flags úteis do `run`: `--repo`, `--url`, `--skip-url-check`.
+
+## Desenvolvimento local
+
+```powershell
+cd agente_testes
+uv sync
+npm install
+npx playwright install chromium
+copy .env.example .env
+# Edite OPENAI_API_KEY em .env
+
+uv run agente-testes doctor
+uv run python scripts/start_demo.py   # http://localhost:3000/login
+```
+
+Demo E2E:
+
+```powershell
+cd fixtures\demo-app
+uv run agente-testes init
+uv run agente-testes run "Validar login com e-mail inválido na rota /login"
+```
+
+Smoke (sem LLM):
+
+```powershell
+uv run python scripts/smoke_tools.py
+```
+
+## Configuração
+
+| Onde | Variável | Uso |
+|------|----------|-----|
+| `~/.agente-testes/.env` | `OPENAI_API_KEY` | Obrigatória (instalação global) |
+| Projeto alvo `.env` | `AGENTE_TESTES_APP_URL` | URL do app sob teste |
+| CLI | `--url` | Sobrescreve URL na execução |
+
+Artefatos ficam em `<projeto>/.agente-testes/` (`output/`, `artifacts/`, `temp_specs/`).
+
+## Estrutura
+
+```
+src/agente_testes/   CLI, crew, tools, self-healing
+fixtures/demo-app/   App HTTP de demonstração (:3000)
+scripts/             smoke, demo, hooks de commit
+docs/COMMITS.md      Padrão de commits do projeto
+```
+
+## Segurança
+
+- Nunca commite `.env`; use `.env.example` / `~/.agente-testes/.env`
+- Tools bloqueiam leitura de secrets no repositório alvo
+- Subprocess Playwright usa env mínimo (sem `OPENAI_API_KEY`)
+
+## Validação em app externo (CT-05, só local)
+
+Apps reais na sua máquina podem ser usados para teste manual (`agente-testes run` com `--repo` implícito via `cwd`). Isso **não** faz parte do CI nem dos specs versionados deste pacote. Guia: [`docs/CT-05.md`](docs/CT-05.md).
+
+Padrões Next.js + toast Sonner: fixture `fixtures/nextjs-sonner-fixture/`.
+
+## Fase 5 — qualidade
+
+- Pré-leitura de login antes da IA (`login_preflight`)
+- Healing proativo ao salvar specs
+- Testes: `uv run --group dev pytest tests/ -q`
+
+Detalhes: [`docs/FASE-5.md`](docs/FASE-5.md)
+
+## CI (GitHub Actions)
+
+- **Automático em PR/push:** smoke + pytest + `exec` (sem custo de API) — ver [`docs/CI.md`](docs/CI.md)
+- **Manual com IA:** workflow `E2E com IA` + secret `OPENAI_API_KEY` — ver [`docs/CI.md#secret-obrigatório`](docs/CI.md)
+
+## Licença
+
+MIT