@lume.produtos/intelidente-agent-tools 1.0.0 → 1.0.2

package/bin/intelidente-agent-tools.js

@@ -4,6 +4,7 @@ import { fileURLToPath } from 'node:url';
 import fs from 'node:fs';
 import path from 'node:path';
 import process from 'node:process';
+import os from 'node:os';
 
 /*
 |--------------------------------------------------------------------------
@@ -57,11 +58,9 @@ const targets = targetArg
   ? targetArg
       .replace('--targets=', '')
       .split(/[,\s]+/)
-      .map(item => item.trim())
+      .map(item => item.trim().toLowerCase())
       .filter(Boolean)
   : ['claude', 'codex'];
-  
-  console.log(targets);
 
 /*
 |--------------------------------------------------------------------------
@@ -96,6 +95,8 @@ if (!name) {
 
 const projectPath = process.cwd();
 
+const userHome = os.homedir();
+
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
@@ -105,6 +106,8 @@ const packagePath = path.resolve(__dirname, '..');
 |--------------------------------------------------------------------------
 | Claude
 |--------------------------------------------------------------------------
+| Claude fica LOCAL no projeto
+|--------------------------------------------------------------------------
 */
 
 if (targets.includes('claude')) {
@@ -141,7 +144,7 @@ if (targets.includes('claude')) {
   fs.copyFileSync(claudeSource, claudeTarget);
 
   console.log(
-    `✓ Claude command instalado: ${name}`
+    `✓ Claude command instalado: ${claudeTarget}`
   );
 }
 
@@ -149,6 +152,8 @@ if (targets.includes('claude')) {
 |--------------------------------------------------------------------------
 | Codex
 |--------------------------------------------------------------------------
+| Codex fica GLOBAL no usuário
+|--------------------------------------------------------------------------
 */
 
 if (targets.includes('codex')) {
@@ -163,7 +168,7 @@ if (targets.includes('codex')) {
   );
 
   const codexTarget = path.join(
-    projectPath,
+    userHome,
     '.codex',
     'skills',
     name
@@ -181,7 +186,7 @@ if (targets.includes('codex')) {
   copyDir(codexSource, codexTarget);
 
   console.log(
-    `✓ Codex skill instalada: ${name}`
+    `✓ Codex skill instalada: ${codexTarget}`
   );
 }
 

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "@lume.produtos/intelidente-agent-tools",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Installer for Intelidente Claude commands and Codex skills",
   "type": "module",
   "bin": {
-  "intelidente-agent-tools": "bin/intelidente-agent-tools.js"
-},
+    "intelidente-agent-tools": "bin/intelidente-agent-tools.js"
+  },
   "files": [
     "bin",
     "templates"
   ],
   "license": "MIT"
-}
+}

package/templates/criar-testes/claude/commands/criar-testes.md

@@ -1,3 +1,150 @@
-# Command Criar Testes
+---
+description: Cria testes a partir das planilhas padrao em docs/testing/criar e move os roteiros concluidos para docs/testing/executado.
+allowed-tools: Read, Write, Edit, MultiEdit, Bash, Glob, Grep, LS, TodoWrite
+---
 
-Esse é um comando de teste.
+Voce e o agente `criar-testes` deste repositorio. Sua tarefa e transformar as planilhas padrao pendentes em `docs/testing/criar` em testes automatizados reais no projeto indicado pela propria planilha.
+
+## Entrada
+
+- Leia todos os arquivos em `docs/testing/criar`.
+- Ignore arquivos temporarios ou de lock, especialmente arquivos iniciados por `~$`.
+- O formato principal aceito e `.xlsx`.
+- A planilha precisa seguir o padrao com as colunas:
+  - `Projeto`
+  - `Teste`
+  - `Acao`
+  - `Descricao`
+  - `Como Fazer`
+- Se um arquivo nao seguir esse padrao, ignore o arquivo e informe no resumo final que ele foi ignorado por estar fora do formato esperado.
+- Se a pasta estiver vazia, responda apenas que nao existem roteiros pendentes.
+
+## Como trabalhar
+
+1. Abra a planilha e leia as linhas validas.
+2. Agrupe as linhas por `Projeto` e por `Teste`.
+3. Use a coluna `Projeto` para decidir onde procurar/criar os testes. Exemplos:
+   - `agenda` normalmente fica em `e2e/agenda`.
+   - `data-import` deve ser tratado como outro projeto, procurando arquivos e comandos relacionados a `data-import`.
+   - Para qualquer outro valor, procure no repo por testes, scripts e pastas que combinem com o nome do projeto.
+4. A pasta do projeto dentro de `e2e` e obrigatoria: crie `e2e/<projeto>` quando ela ainda nao existir, usando o valor normalizado da coluna `Projeto` em kebab-case/minusculo. Exemplos: `agenda` -> `e2e/agenda`; `data import` -> `e2e/data-import`.
+5. Nao crie specs diretamente em `e2e/` quando a planilha tiver `Projeto`; coloque os arquivos do roteiro dentro de `e2e/<projeto>`.
+6. Dentro de cada grupo de `Teste`, siga as linhas na ordem da planilha. Cada linha representa uma acao do roteiro.
+7. Use `Acao` como identificador tecnico do passo.
+8. Use `Descricao` para entender o objetivo esperado.
+9. Use `Como Fazer` como instrucao operacional principal para criar o passo no teste.
+10. Entenda o roteiro de teste inteiro antes de editar codigo.
+11. Procure testes existentes relacionados ao projeto informado na coluna `Projeto`.
+12. Antes de criar qualquer passo, verifique se a `Acao` da linha ja existe nos testes do projeto ou se o comportamento ja foi coberto por um passo criado anteriormente no mesmo processamento.
+13. Considere a acao existente quando encontrar o identificador tecnico da coluna `Acao`, o mesmo comportamento descrito em `Descricao`/`Como Fazer`, ou logs claros que comprovem a cobertura do passo.
+14. Se a acao ja existir ou ja tiver sido criada, nao duplique o codigo; apenas reaproveite o fluxo existente e informe isso no resumo final.
+15. Reutilize helpers, fixtures, seletores e padroes ja usados no projeto.
+16. Crie ou atualize os testes necessarios para cobrir apenas os passos ainda nao atendidos do roteiro.
+17. Registre os passos importantes em `console.log` usando prefixo claro derivado do projeto, por exemplo `[AGENDA]` ou `[DATA-IMPORT]`.
+18. Use seletores Playwright resilientes: `getByRole`, labels, placeholders e texto visivel quando possivel.
+19. Evite depender de cores exatas ou posicoes fragiles, salvo quando for inevitavel.
+20. Quando houver dados variaveis, salve nomes, datas e horarios em variaveis e logue o valor usado.
+21. Nao remova fluxos existentes sem necessidade. Acrescente o novo comportamento no ponto correto do teste.
+22. Se um passo do roteiro estiver ambiguo, faca a melhor inferencia a partir dos testes existentes e registre a decisao no resumo final.
+
+## Validacao
+
+- Rode o teste afetado quando for viavel.
+- Os testes devem ler credenciais por `process.env.E2E_USER` e `process.env.E2E_PASSWORD`.
+- O login de teste deve ficar no arquivo `.env.test` dentro do app/projeto correspondente, por exemplo `apps/agenda/.env.test`.
+- Antes de rodar E2E, verifique se `E2E_USER` e `E2E_PASSWORD` existem no `.env.test` do projeto. Se o projeto ainda nao tiver `.env.test` ou se as variaveis estiverem ausentes, avise o usuario e nao invente credenciais.
+- Para agenda, o `playwright.config.ts` ja carrega automaticamente `apps/agenda/.env.test` antes dos testes.
+- Se as variaveis nao existirem, oriente o usuario a configurar o arquivo do app, por exemplo:
+  - `apps/<projeto>/.env.test`, com `E2E_USER=<usuario>` e `E2E_PASSWORD=<senha>`.
+- Nunca grave senha real em comandos Markdown ou logs.
+- Descubra o comando correto pelo projeto informado na coluna `Projeto`, consultando `package.json`, `playwright.config.ts`, scripts do monorepo e testes existentes.
+- Exemplos:
+
+Agenda:
+
+```powershell
+pnpm test:e2e --project=agenda e2e/agenda/selecao-profissional.spec.ts
+```
+
+Projeto generico Playwright, quando houver project correspondente:
+
+```powershell
+pnpm test:e2e --project=<projeto>
+```
+
+- Nao assuma que todo roteiro pertence a agenda.
+- Nao use `e2e/agenda` se a coluna `Projeto` indicar outro projeto.
+
+- Se a validacao falhar por instabilidade externa, login, ambiente ou backend, explique isso no resumo e deixe claro ate onde o teste executou.
+- Corrija falhas do teste que forem causadas pela implementacao criada.
+
+## Resultado JSON e Blob Storage
+
+- O projeto usa o reporter `e2e/blob-log-reporter.ts`, configurado em `playwright.config.ts`.
+- Todo processamento que rodar Playwright deve gerar um JSON local em `test-results/blob-logs`.
+- O nome do arquivo deve seguir o padrao do reporter:
+  - `<projeto>-e2e-<startedAt ISO sem ":" e ".">-<status>.json`, quando houver um unico projeto.
+  - `multi-project-e2e-<startedAt ISO sem ":" e ".">-<status>.json`, quando houver mais de um projeto.
+  - Exemplos: `agenda-e2e-2026-05-15T14-37-39-743Z-passed.json`, `data-import-e2e-2026-05-15T14-37-39-743Z-failed.json`.
+- O JSON deve ter este formato:
+
+```json
+{
+  "status": "passed",
+  "startedAt": "2026-05-15T14:37:39.743Z",
+  "finishedAt": "2026-05-15T14:38:12.120Z",
+  "durationMs": 32377,
+  "tests": [
+    {
+      "title": "Agenda - login > login completo + redirect para a tela da agenda",
+      "project": "agenda",
+      "file": "e2e/agenda/login.spec.ts",
+      "line": 9,
+      "status": "passed",
+      "durationMs": 12000,
+      "retry": 0,
+      "stdout": ["[AGENDA] Agenda autenticada validada."],
+      "stderr": [],
+      "errors": []
+    }
+  ]
+}
+```
+
+- Para enviar o JSON ao Blob Storage, configure `E2E_BLOB_LOG_UPLOAD_URL` no `.env.test` do projeto, preferencialmente como template com `{fileName}`:
+
+```env
+E2E_BLOB_LOG_UPLOAD_URL=https://<account>.blob.core.windows.net/<container>/e2e/{fileName}?<sas>
+```
+
+- Tambem e aceito um URL de container/pasta com SAS sem `{fileName}`; nesse caso o reporter acrescenta o nome do arquivo antes da query string.
+- Nao exponha SAS/token real no resumo final. Informe apenas se a variavel estava configurada e se o upload foi executado, ignorado ou falhou.
+
+## Finalizacao
+
+Depois que os testes forem criados e validados tanto quanto possivel, a movimentacao dos roteiros concluidos e obrigatoria. Nao finalize a resposta sem executar esta etapa ou explicar claramente por que ela nao pode ser executada.
+
+1. Mova cada arquivo de planilha concluido de `docs/testing/criar` para `docs/testing/executado`.
+2. Nao mova arquivos temporarios iniciados por `~$`.
+3. Nao mova arquivos ignorados por estarem fora do padrao esperado; mantenha-os em `docs/testing/criar`.
+4. Se ja existir arquivo com o mesmo nome em `executado`, preserve ambos usando um sufixo com data/hora.
+5. Execute a movimentacao com comando real no filesystem. Em PowerShell, use `Move-Item -LiteralPath <arquivo> -Destination <destino>`.
+6. Depois de mover, liste `docs/testing/criar` e `docs/testing/executado` para confirmar que:
+   - os arquivos concluidos sairam de `criar`;
+   - os arquivos concluidos aparecem em `executado`;
+   - os arquivos temporarios `~$*` continuam ignorados.
+7. No resumo final, informe:
+   - arquivos de planilha processados;
+   - arquivos ignorados por formato invalido;
+   - arquivos movidos para `docs/testing/executado`;
+   - arquivos que permaneceram em `docs/testing/criar` e o motivo;
+   - projetos encontrados na coluna `Projeto`;
+   - acoes novas, acoes reaproveitadas e acoes ignoradas por ja existirem;
+   - arquivos de teste alterados/criados;
+   - comando de validacao executado;
+   - resultado da validacao;
+   - qualquer passo que ficou pendente ou inferido.
+
+## Regra importante
+
+So mova um roteiro para `docs/testing/executado` quando ele tiver sido realmente tratado. Se encontrar um bloqueio que impeca criar os testes, mantenha o arquivo em `docs/testing/criar` e explique o motivo.

package/templates/criar-testes/codex/skills/criar-testes/SKILL.md

@@ -0,0 +1,128 @@
+---
+name: criar-testes
+description: Use when Codex needs to create or update automated E2E tests from spreadsheet test scripts in docs/testing/criar, especially for Intelidente microfrontends. Reads .xlsx files with Projeto, Teste, Acao, Descricao, and Como Fazer columns; creates or reuses Playwright tests; validates when viable; and moves completed spreadsheets to docs/testing/executado.
+---
+
+# Criar Testes
+
+Use this skill to process pending spreadsheet-based test scripts and turn them into real automated tests.
+
+## Expected Repository Shape
+
+- Pending scripts live in `docs/testing/criar`.
+- Completed scripts must be moved to `docs/testing/executado`.
+- Ignore temporary Excel lock files such as `~$*.xlsx`.
+- The primary accepted format is `.xlsx`.
+- The expected columns are:
+  - `Projeto`
+  - `Teste`
+  - `Acao`
+  - `Descricao`
+  - `Como Fazer`
+
+## Workflow
+
+1. List `docs/testing/criar`.
+2. If there are no non-temporary files, report that there are no pending scripts.
+3. Read each valid spreadsheet.
+4. Ignore files outside the expected format and report them in the final summary.
+5. Group rows by `Projeto` and then by `Teste`.
+6. Use `Projeto` to find the correct E2E area:
+   - `agenda` usually maps to `e2e/agenda`.
+   - Other projects must be discovered from repo folders, Playwright projects, scripts, and existing tests.
+7. Create the project folder under `e2e` when it does not exist. The folder is mandatory and must be based on the normalized `Projeto` value, for example `agenda` -> `e2e/agenda` and `data import` -> `e2e/data-import`.
+8. Do not create project specs directly under `e2e/` when the spreadsheet has a `Projeto` value; place them under `e2e/<projeto>`.
+9. Read existing tests before editing.
+10. For each row, treat `Acao` as the technical step identifier, `Descricao` as the expected intent, and `Como Fazer` as the operational instruction.
+11. Before creating code, verify whether the action already exists or whether the same behavior is already covered.
+12. Consider an action existing when the identifier, behavior, or clear logs already cover it.
+13. Do not duplicate existing actions. Reuse the existing flow and report reused actions.
+14. Create or update only the tests needed for uncovered actions.
+15. Reuse local helpers, fixtures, selectors, and Playwright patterns.
+16. Prefer resilient Playwright selectors such as `getByRole`, labels, placeholders, visible text, and stable DOM attributes.
+17. Add meaningful `console.log` entries with a project prefix such as `[AGENDA]`.
+18. Keep variable data such as names, dates, and times in variables and log the chosen values.
+19. Do not remove unrelated flows.
+
+## Validation
+
+- Run the affected test when viable.
+- E2E tests must read credentials from `process.env.E2E_USER` and `process.env.E2E_PASSWORD`.
+- Test login credentials must live in the app/project `.env.test` file, for example `apps/agenda/.env.test`.
+- Before running E2E, check whether the project `.env.test` exists and contains `E2E_USER` and `E2E_PASSWORD`.
+- If the file or variables are missing, tell the user to configure `apps/<projeto>/.env.test` with `E2E_USER=<user>` and `E2E_PASSWORD=<password>`; do not invent credentials.
+- For agenda, `playwright.config.ts` automatically loads `apps/agenda/.env.test` before agenda tests run.
+- Never write real passwords into Markdown commands or logs.
+- Discover the correct command from `package.json`, `playwright.config.ts`, workspace scripts, and existing test conventions.
+- Do not assume every script belongs to `agenda`.
+- If validation fails because of login, backend, environment, or instability, explain how far execution got.
+- Fix failures caused by the newly created implementation.
+
+## JSON Result and Blob Storage
+
+- Use the existing reporter `e2e/blob-log-reporter.ts`, configured in `playwright.config.ts`, for Playwright result JSON.
+- Every Playwright validation should write a JSON file under `test-results/blob-logs`.
+- The file name must follow the reporter pattern:
+  - `<projeto>-e2e-<startedAt ISO without ":" or ".">-<status>.json` for a single project.
+  - `multi-project-e2e-<startedAt ISO without ":" or ".">-<status>.json` for multiple projects.
+  - Examples: `agenda-e2e-2026-05-15T14-37-39-743Z-passed.json`, `data-import-e2e-2026-05-15T14-37-39-743Z-failed.json`.
+- The JSON payload must have this shape:
+
+```json
+{
+  "status": "passed",
+  "startedAt": "2026-05-15T14:37:39.743Z",
+  "finishedAt": "2026-05-15T14:38:12.120Z",
+  "durationMs": 32377,
+  "tests": [
+    {
+      "title": "Agenda - login > login completo + redirect para a tela da agenda",
+      "project": "agenda",
+      "file": "e2e/agenda/login.spec.ts",
+      "line": 9,
+      "status": "passed",
+      "durationMs": 12000,
+      "retry": 0,
+      "stdout": ["[AGENDA] Agenda autenticada validada."],
+      "stderr": [],
+      "errors": []
+    }
+  ]
+}
+```
+
+- To upload the JSON to Blob Storage, configure `E2E_BLOB_LOG_UPLOAD_URL` in the project `.env.test`, preferably with a `{fileName}` placeholder:
+
+```env
+E2E_BLOB_LOG_UPLOAD_URL=https://<account>.blob.core.windows.net/<container>/e2e/{fileName}?<sas>
+```
+
+- A container/folder SAS URL without `{fileName}` is also accepted; the reporter appends the generated file name before the query string.
+- Never expose the real SAS/token in the final summary. Report only whether the variable was configured and whether upload was executed, skipped, or failed.
+
+## Required Finalization
+
+After a spreadsheet has been genuinely treated, moving it is mandatory:
+
+1. Move each completed spreadsheet from `docs/testing/criar` to `docs/testing/executado`.
+2. Do not move temporary `~$*` files.
+3. Do not move invalid or blocked files.
+4. If the destination filename already exists, preserve both files by adding a date/time suffix to the moved file.
+5. Execute the move with a real filesystem command, for example PowerShell `Move-Item -LiteralPath <file> -Destination <destination>`.
+6. After moving, list both folders to confirm completed files left `criar` and appeared in `executado`.
+
+Do not send the final answer until the move step has been executed or a concrete blocker has been reported.
+
+## Final Summary
+
+Include:
+
+- spreadsheets processed;
+- spreadsheets ignored because of invalid format;
+- spreadsheets moved to `docs/testing/executado`;
+- spreadsheets left in `docs/testing/criar` and why;
+- projects found in the `Projeto` column;
+- new actions, reused actions, and actions skipped because they already existed;
+- test files created or changed;
+- validation command and result;
+- any inferred or pending steps.

package/templates/criar-testes/codex/skills/criar-testes/agents/openai.yaml

@@ -0,0 +1,3 @@
+display_name: Criar Testes
+short_description: Cria testes E2E a partir de planilhas pendentes.
+default_prompt: Use esta skill para ler roteiros em docs/testing/criar, criar ou reaproveitar testes E2E e mover roteiros concluidos para docs/testing/executado.