plugadvpl

Use quando o usuário pergunta "explique como funciona X", "o que faz a função Y", "qual o fluxo de Z", "me ajuda a entender este fonte" em código ADVPL/Protheus. Orquestra plugadvpl arch → callers/callees → leitura targeted de chunks → sumarização concisa. NÃO usar para gerar código novo (use advpl-code-generator) nem para revisar (use advpl-reviewer-bot).

Use quando o usuário pede "crie User Function para X", "gere MVC de cadastro Y", "novo Ponto de Entrada", "Web Service REST/SOAP", "job RPC", "rotina batch". Gera código ADVPL/TLPP respeitando encoding cp1252, naming com prefixo de cliente, evitando funções restritas, e roda lint automaticamente após gerar. NÃO usar para revisar código existente (use advpl-reviewer-bot).

Use quando o usuário pergunta "se eu mudar X, o que quebra?", "qual o impacto de remover Y?", "onde Z é usado?", "posso renomear esta função?", "essa tabela é gravada onde?". Cruza callers/tables/param/lint do plugadvpl para listar impacto por arquivo+linha com classificação de risco. NÃO usar para explicar código (use advpl-analyzer).

Use quando o usuário pede "audita esse INI", "verifica appserver.ini", "checa configuração do DBAccess", "está tudo certo no broker", "valida tss.ini", "compare config dev vs prd". Roda `ini-audit` do plugadvpl contra 487 regras TDN-oficiais filtradas por tipo (appserver/dbaccess/smartclient/tss/broker) e role (slave_rest, dbaccess_master, broker_http, etc.), classifica findings por severidade e indica o fix. NÃO usar pra ler INI bruto (use Read) nem pra editar INI direto (peça confirmação ao usuário).

Use quando o usuário pede "investiga esse log", "o que houve no console.log", "analisa o error.log do crash", "diagnóstico do log de produção", "o que causou esse erro Protheus". Roda `log-diagnose` do plugadvpl contra logs Protheus (console.log, error.log, profile.log, compila.log), classifica findings por severidade + categoria, e correlaciona com 93 correction tips da KB TDN oficial. NÃO usar pra ler log bruto (use Read em chunks pequenos) nem pra propor mudança de código (passa pro advpl-reviewer-bot depois).

Tópicos avançados ADVPL — transações ACID (Begin Transaction + DisarmTransaction), relatórios TReport (TRSection/TRCell/TRFunction), FWTemporaryTable, manipulação de arquivos (FT_F* família 2 para SPED/EDI), MsNewGetDados, threads (MsRunInThread), OOP em ADVPL clássico (Class/Method/Self), reflection via Type/ValType, NoRound financeiro, anti-padrões legados (AxCadastro/Modelo2/Modelo3). Use quando contexto sair do escopo básico de cadastros/MVC.

35 regras de code review ADVPL/TLPP implementadas — 100% do catálogo (22 single-file via regex + 13 cross-file: 12 que requerem ingest-sx + MOD-003 só fontes). Use após gerar/editar fonte ADVPL, antes de marcar tarefa como concluída, ou quando o usuário pede "revise este código".

Top 30 erros comuns em ADVPL/TLPP em produção e métodos de debug. Tabela de sintoma → causa raiz → comando de diagnóstico → fix. Use quando o usuário cola um erro do AppServer.log, descreve "está dando erro" sem detalhe, ou pede ajuda pra investigar bug Protheus.

Validações ADVPL embarcadas no dicionário SX (X3_VALID, X3_INIT, X3_WHEN, X3_VLDUSER, X7_REGRA, X1_VALID). Use ao analisar customização de cadastro/dicionário ou rastrear impacto de mudança de campo via `plugadvpl impacto`.

Dicionário SX do Protheus — SX1 (perguntas), SX2 (tabelas), SX3 (campos), SX5 (tabelas genéricas), SX6 (parâmetros MV_*), SX7 (gatilhos), SX8 (numeração sequencial), SX9 (relacionamentos), SXA (pastas/folders), SXB (consultas F3), SXG (grupos de campo), SIX (índices). Use ao criar campo/parâmetro/gatilho/consulta, customizar via dicionário, ou diagnosticar comportamento controlado pelo SX. Para análise cruzada com fontes, use /plugadvpl:impacto e /plugadvpl:gatilho.

1 hook across 1 event