feat(testes): padronizar uso obrigatorio de --session <modulo> no agent-browser

rules/testes-interface-agent-browser.md

@@ -1,10 +1,10 @@
 ---
 type: rule
 name: testes-interface-agent-browser
-description: Testes automatizados de interface (E2E) e acesso visual ao frontend devem usar agent-browser, sempre visível (--headed) ao operador.
+description: Testes automatizados de interface (E2E) e acesso visual ao frontend devem usar agent-browser, sempre visível (--headed) e com isolamento por sessão (--session <modulo>).
 scope: global
 trigger: always_on
-updatedAt: "2026-09-16"
+updatedAt: "2026-10-08"
 ---
 
 # Regra: Testes Automatizados de Interface e Navegação com agent-browser
@@ -13,6 +13,8 @@ updatedAt: "2026-09-16"
 
 Quando uma IA precisa testar o frontend, validar jornadas de usuário, inspecionar componentes gráficos ou simular interações na tela, é crucial utilizar uma ferramenta rápida, determinística e econômica em tokens. Além disso, o operador humano deve sempre ter visibilidade do que a IA está executando em tempo real na interface gráfica.
 
+Por padrão, invocações sem identificação de sessão utilizam a sessão `"default"`, compartilhando o mesmo daemon e socket Unix. Para viabilizar testes concorrentes e evitar interferências mútuas entre múltiplos módulos ou workspaces, todo comando deve operar em sessão isolada identificada pelo módulo.
+
 Esta regra padroniza o uso da ferramenta CLI **`agent-browser`** para qualquer teste de interface ou automação de navegador conduzida por agentes de IA.
 
 ---
@@ -25,14 +27,19 @@ Sempre que qualquer agente de IA (`@testes`, `@front`, `@ux` ou outro) precisar
 2. **Executar SEMPRE em Modo Visível (`--headed`)**:
    - A janela do navegador **deve sempre aparecer na área de trabalho do operador**.
    - É **terminantemente proibido** rodar testes ocultos (headless silencioso), a menos que o operador humano solicite expressamente essa exceção.
-   - Usar a flag `--headed` nos comandos de abertura (`agent-browser open --headed <url>`) ou garantir a variável de ambiente `export AGENT_BROWSER_HEADED=true`.
-3. **Utilizar o modelo de referências (`@ref`)**:
-   - Mapear a tela via `agent-browser snapshot -i`, obtendo referências compactas como `@e1`, `@e2`.
+   - Usar a flag `--headed` nos comandos de abertura (`agent-browser --session <modulo> open --headed <url>`) ou garantir a variável de ambiente `export AGENT_BROWSER_HEADED=true`.
+3. **Isolamento Mandatório de Sessão (`--session <modulo>`)**:
+   - **Nunca utilizar a sessão padrão compartilhada** sem identificar o módulo.
+   - Todo comando `agent-browser` **DEVE OBRIGATORIAMENTE ser acompanhado da flag `--session <modulo>`** (onde `<modulo>` é o `modulo-id` canônico extraído de `memorias-ia/modulo.yml`), ou garantir no ambiente `export AGENT_BROWSER_SESSION=<modulo>`.
+   - Cada sessão possui daemon e socket Unix dedicados (ex: `/run/user/1000/agent-browser/<modulo>.sock`), prevenindo colisões de abas, perda de contexto e encerramento indevido de processos em testes simultâneos multi-módulos.
+   - Caso um mesmo módulo necessite de sub-isolamento para testes paralelos, deve-se adotar o sufixo determinístico `<modulo-id>-<slug-ou-pid>`.
+4. **Utilizar o modelo de referências (`@ref`)**:
+   - Mapear a tela via `agent-browser --session <modulo> snapshot -i`, obtendo referências compactas como `@e1`, `@e2`.
    - Executar ações determinísticas referenciando os IDs gerados (`click @e1`, `fill @e2 "texto"`).
-4. **Registrar evidências e fechar sessão**:
-   - Registrar comprovações visuais com `agent-browser screenshot <arquivo.png>`.
-   - Encerrar graciosamente o navegador com `agent-browser close` ao término do fluxo.
-5. **Credenciais Canônicas de Teste (`modulo-acesso`)**:
+5. **Registrar evidências e fechar sessão**:
+   - Registrar comprovações visuais com `agent-browser --session <modulo> screenshot <arquivo.png>`.
+   - Encerrar graciosamente o navegador com `agent-browser --session <modulo> close` ao término do fluxo.
+6. **Credenciais Canônicas de Teste (`modulo-acesso`)**:
    - Sempre que o teste exigir autenticação (login, sessão administrativa), o agente **DEVE OBRIGATORIAMENTE extrair `usuario` e `senha` de `modulo-acesso` em `memorias-ia/modulo.yml`**.
    - É terminantemente proibido inventar credenciais aleatórias ou chutar credenciais inexistentes que falhem no teste.
 
@@ -56,52 +63,55 @@ Documentação de referência: **https://agent-browser.dev/**
 
 ## Protocolo Operacional Padrão
 
-Todo teste ou navegação de interface executado pela IA deve seguir o fluxo:
+Todo teste ou navegação de interface executado pela IA deve seguir o fluxo com isolamento de sessão:
 
-### 1. Abertura com Janela Visível
+### 1. Obter Identificador do Módulo e Abertura com Janela Visível
 
 ```bash
-# Abrir sempre visível ao operador humano
-agent-browser open --headed http://localhost:8080
+# Obter o modulo-id canônico de memorias-ia/modulo.yml
+MODULO=$(grep -E "^modulo-id:" memorias-ia/modulo.yml | awk '{print $2}')
+
+# Abrir sempre visível ao operador humano na sessão isolada do módulo
+agent-browser --session "$MODULO" open --headed http://localhost:8080
 ```
 
 ### 2. Inspeção de Elementos Interativos
 
 ```bash
 # Gera árvore de acessibilidade compacta com refs determinísticas (@e1, @e2)
-agent-browser snapshot -i
+agent-browser --session "$MODULO" snapshot -i
 ```
 
 ### 3. Interações por Referência Direta
 
 ```bash
 # Interagir diretamente com os elementos identificados no snapshot
-agent-browser fill @e1 "usuario@exemplo.com"
-agent-browser fill @e2 "senhaSegura123"
-agent-browser click @e3
+agent-browser --session "$MODULO" fill @e1 "usuario@exemplo.com"
+agent-browser --session "$MODULO" fill @e2 "senhaSegura123"
+agent-browser --session "$MODULO" click @e3
 ```
 
 ### 4. Validação e Evidência
 
 ```bash
 # Aguardar estabilização se houver transição assíncrona
-agent-browser wait 1000
+agent-browser --session "$MODULO" wait 1000
 
 # Obter novo snapshot para verificar estado pós-ação
-agent-browser snapshot -i
+agent-browser --session "$MODULO" snapshot -i
 
 # Capturar evidência gráfica do teste
-agent-browser screenshot evidencias/teste-login-sucesso.png
+agent-browser --session "$MODULO" screenshot evidencias/teste-login-sucesso.png
 
 # Verificar erros no console do navegador
-agent-browser console
+agent-browser --session "$MODULO" console
 ```
 
 ### 5. Finalização
 
 ```bash
-# Fechar a sessão do navegador ao concluir o teste
-agent-browser close
+# Fechar a sessão isolada do navegador ao concluir o teste
+agent-browser --session "$MODULO" close
 ```
 
 ---
@@ -109,20 +119,23 @@ agent-browser close
 ## Boas Práticas e Proibições
 
 ### Proibido ❌
+- **Proibido executar sem a flag `--session <modulo>`** (ou sem `AGENT_BROWSER_SESSION`), evitando poluir a sessão default compartilhada.
 - **Proibido abrir em modo headless silencioso** sem flag `--headed` ou variável `AGENT_BROWSER_HEADED=true`.
 - **Proibido despejar o HTML/DOM completo** no contexto da IA (consome milhares de tokens desnecessários; use sempre `snapshot -i`).
 - **Proibido navegar para URLs desconhecidas** ou inventadas pela IA fora do escopo aprovado do teste.
-- **Proibido deixar processos ou janelas orfãs** após a conclusão do trabalho (sempre executar `agent-browser close`).
+- **Proibido deixar processos ou janelas órfãs** após a conclusão do trabalho (sempre executar `agent-browser --session <modulo> close`).
 
 ### Permitido e Recomendado ✅
-- Manter sessões persistentes quando necessário via `--session <nome>` e `--restore`.
-- Usar `agent-browser screenshot --annotate` para inspecionar layouts complexos com visão computacional.
+- Manter sessões persistentes quando necessário via `--session <modulo> --restore`.
+- Utilizar sub-isolamento determinístico (`<modulo-id>-<slug-ou-pid>`) caso múltiplos testes do mesmo módulo ocorram simultaneamente no mesmo host.
+- Usar `agent-browser --session <modulo> screenshot --annotate` para inspecionar layouts complexos com visão computacional.
 - Consultar guias embutidos do próprio binário via `agent-browser skills get core --full` ou `agent-browser skills get dogfood`.
 
 ---
 
 ## Impacto
 
+- **Isolamento e Concorrência**: Múltiplos agentes ou módulos rodando testes E2E simultâneos não conflitam de abas nem fecham janelas alheias.
 - **Transparência para o operador**: O operador humano acompanha exatamente o que a IA está clicando e testando na interface em tempo real.
 - **Eficiência de tokens**: A árvore de acessibilidade reduz o consumo de contexto em até 90% comparado a inspeções de DOM HTML bruto.
 - **Confiabilidade**: Interações determinísticas por `@ref` eliminam fragilidade de seletores CSS dinâmicos.
@@ -133,4 +146,6 @@ agent-browser close
 
 - Documentação Oficial: https://agent-browser.dev/
 - Skill associada: `skills/testar-interface-agent-browser/SKILL.md`
+- Rule associada: `rules/identidade-modulo.md`
 - Ferramentas CLI: `.agent/TOOLS`
+