log de saida

README.md

@@ -81,9 +81,42 @@ Campos **nullable** permitem limpar o valor escolhendo "Limpar campo (null)" ou
 
 O app também tenta carregar `../clarizen-lib/.env` se não houver `.env` local.
 
+## Log de execução
+
+Após cada atualização concluída, o app gera `run-log-<timestamp>.json` na pasta do projeto com o registro completo da execução:
+
+- data/hora e duração
+- usuário autenticado
+- tipo de entidade, filtro, campo e valor aplicado
+- resumo (total, atualizados, erros)
+- lista de cada objeto com `status: "updated"` ou `status: "error"`
+
+Exemplo resumido:
+
+```json
+{
+  "executedAt": "2026-06-09T15:30:00.000Z",
+  "durationMs": 45230,
+  "userId": "/User/abc123",
+  "operation": {
+    "typeName": "Task",
+    "filter": "Todos",
+    "fieldName": "C_MeuCampo",
+    "value": true
+  },
+  "summary": { "total": 10, "updated": 9, "errors": 1 },
+  "results": [
+    { "id": "/Task/...", "displayName": "Tarefa 1", "status": "updated" },
+    { "id": "/Task/...", "displayName": "Tarefa 2", "status": "error", "message": "..." }
+  ]
+}
+```
+
+O caminho do arquivo é exibido no terminal ao final: `Log da execução: ...`
+
 ## Erros
 
-Objetos que falharem na atualização são listados ao final. Um arquivo `errors-<timestamp>.json` é gerado na pasta do projeto com os detalhes.
+Objetos que falharem na atualização também aparecem no `run-log-*.json`. Além disso, um arquivo `errors-<timestamp>.json` é gerado quando há falhas, contendo só os erros para reprocessamento.
 
 ## Observações