Lista os servidores Protheus do servers.json do TDS (~/.totvsls), com ambientes, includes e qual está conectado nesta sessão do MCP.

Conecta e autentica em um servidor/ambiente do servers.json para as demais tools. Tenta o token de reconexão salvo pelo TDS; se falhar, usa credenciais de ~/.tds-mcp/config.json.

Compila fontes ou pastas no RPO do servidor conectado. Use recompile=true para forçar recompilação. COMO LER O RESULTADO: confie SEMPRE no campo booleano sucesso — ele já combina as duas formas de falha. (a) falha de BUILD: returnCode != 0, com falhaDeBuild explicando; nesse caso o build é revertido e NADA é gravado no RPO, mesmo que a lista resultados venha vazia ou só com SUCCESS (ex.: COMPILEERROR-300 = sem acesso exclusivo ao RPO). (b) falha de FONTE: itens com status ERROR/FATAL em resultados. Nunca conclua sucesso apenas por não haver erros em resultados. Em falha, logDoServidor traz as mensagens do AppServer. ATENÇÃO ao status SKIPPED: o fonte foi ignorado por já estar atualizado no RPO — é sucesso, mas NADA foi gravado; confira ignorados e o campo aviso antes de afirmar que compilou. Fontes precisam estar em CP1252: arquivos em UTF-8 são recusados antes do envio (o compilador Protheus gravaria caracteres corrompidos no RPO). Aceita fontes e recursos (.tres, .png, imagens, layouts).

Compila com syntaxOnly: valida os fontes no servidor SEM commitar no RPO. Sem efeito colateral — pode ser usada livremente antes de tds_compile. Confie no campo sintaxeOk: ele considera tanto returnCode (falha de build) quanto os status por fonte. Lista resultados vazia NÃO significa sucesso.

Retorna o fonte após o pré-processador (resolução de #include/#define). Útil para depurar problemas de defines e includes.

Lista fontes/recursos do RPO do ambiente conectado. Use filtro para limitar (ex.: 'TEC10'). ATENÇÃO à semântica de dataFonte: é o mtime (data de modificação) do ARQUIVO-FONTE registrado no momento da compilação — NÃO é o instante em que a compilação ocorreu. Uso correto: comparar com o mtime do arquivo em disco — igual (±2s) significa que o RPO contém o conteúdo atual do arquivo; disco mais novo significa fonte alterado depois da última compilação. NÃO compare com data de commit git (commit posterior ao mtime é normal). Sem filtro retorna contagem + primeiros 100.

Lista funções do RPO com fonte e linha onde estão definidas. Use filtro para procurar uma função específica (ex.: 'U_TEC10R06').

Versão do RPO, data de geração e histórico de patches aplicados no ambiente conectado. Auditoria pré/pós-deploy.

Gera um patch PTM a partir de fontes já compilados no RPO, com organização padrão (///DDMMAA_HHMM_.ptm, datas no padrão brasileiro), manifesto JSON (sha256, fontes, datas do RPO, servidor, autor, git) e histórico. Retorna também título e descrição recomendados — o título começa com data e hora. No manifesto/retorno, rpoDate de cada fonte é o mtime do arquivo-fonte na compilação (semântica de tds_rpo_objects), não o instante da compilação.

Valida um arquivo de patch contra o RPO do ambiente conectado, sem aplicar. Aponta fontes do patch mais antigos que o RPO. Gate recomendado antes de tds_patch_apply. As datas comparadas (dataPatch/dataRPO) seguem a semântica de mtime do arquivo-fonte na compilação, não do instante de compilação.

Lista o conteúdo (fontes, datas, tamanhos) de um arquivo de patch sem aplicá-lo. Auditoria de patch recebido de terceiros. O campo date de cada objeto é o mtime do arquivo-fonte registrado na compilação (mesma semântica de tds_rpo_objects).

APLICA um patch no RPO do ambiente conectado (operação de deploy — altera o ambiente). Por padrão aplica somente fontes mais novos; use aplicarAntigos=true para forçar. Recomenda-se tds_patch_validate antes.

Últimas mensagens emitidas pelo advpls nesta sessão (diagnóstico de conexão/compilação).