review-flow

Review de Fluxo APIPASS

Audita um fluxo existente contra as convenções e boas práticas da plataforma APIPASS e produz um relatório com findings classificados por severidade.

---

1. Autenticação

Verificar apipass_auth_status. Se não autenticado, chamar apipass_login antes de continuar.

---

2. Resolução do Fluxo

• Se o usuário passou um nome: chamar list_flows e localizar pelo nome (case-insensitive).
• Se passou um ID: usar diretamente.
• Se ambíguo: perguntar ao usuário qual fluxo deseja revisar (listar as opções encontradas).

---

3. Coleta de Dados

Executar em paralelo:

get_flow_development(flowId)          → estrutura completa (steps, counters, logEnabled)
get_flow_info(flowId)                 → metadados (nome, trigger, projeto)
get_published_environments_for_flow(flowId) → environments publicados (para regra S1)

Para fluxos com steps NodeJS ou custom actions, chamar também:

get_custom_action_file(actionId)  → inspecionar código JS (regras JS1–JS6)

Para steps SQL, extrair as queries dos campos rawData/inputData para análise estática (regras SQL1–SQL5) — não requer chamada adicional, os dados já vêm em get_flow_development.

3a. Subfluxos Aninhados

Após coletar o fluxo principal, identificar todos os subfluxos referenciados:

• RunChildFlow (type: ".utility.runchildflow.RunChildFlow" ou similar): extrair o flowId do subfluxo referenciado no inputData/mappingAttributes.
• Steps AMS (coreRouteType: "AMS_SEND_MESSAGE"): localizar o fluxo consumidor da fila — geralmente documentado no campo documentation do step ou identificável pelo nome da fila. Localizar via list_flows filtrando pelo nome da fila.

Para cada subfluxo identificado, executar o mesmo ciclo de coleta (get_flow_development, get_flow_info, get_published_environments_for_flow) e aplicar todas as mesmas regras de revisão (seção 4). Reportar os findings de cada subfluxo em seção própria no relatório, identificada pelo nome do subfluxo.