From plugadvpl
Orchestrates compile → restart → smoke for ADVPL/.prw sources on Protheus AppServer. Use after editing sources when user says "deploy", "compile and restart", or wants to see effect on server.
How this skill is triggered — by the user, by Claude, or both
Slash command
/plugadvpl:deployfonte ou opçõesThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
Orquestra o ciclo completo de dev: **compila o fonte, restarta o AppServer e (opcionalmente) confere se o REST voltou**. Não é um subcomando novo — é um wrapper instrutivo sobre [`/plugadvpl:compile`](../compile/SKILL.md) + [`/plugadvpl:tq`](../tq/SKILL.md) que evita o usuário ter que lembrar os 3 passos e os encadeamentos com `&&`.
/plugadvpl:deployOrquestra o ciclo completo de dev: compila o fonte, restarta o AppServer e (opcionalmente) confere se o REST voltou. Não é um subcomando novo — é um wrapper instrutivo sobre /plugadvpl:compile + /plugadvpl:tq que evita o usuário ter que lembrar os 3 passos e os encadeamentos com &&.
.prw/.tlpp e quer ver no AppServer.edit-prw e precisa publicar./plugadvpl:compile./plugadvpl:tq.restart_cmd que faça o rollback dentro do próprio cmd (ex: restart-com-fallback.bat que detecta falha e restaura RPO anterior).Verifique que tanto compile quanto tq estão configurados:
plugadvpl --format json compile --doctor
plugadvpl compile --list-servers
O server alvo precisa ter restart_cmd setado. Se aparecer vazio, configure antes:
plugadvpl compile --set-restart-cmd <server> --cmd "<cmd do restart>"
Ex. Windows: "cmd.exe /c gaps\\restart-totvs.bat"
Ex. Linux: "sudo systemctl restart totvs-appserver12"
plugadvpl compile --use-server <server> --all-envs <fonte> && \
plugadvpl tq --use-server <server>
Importante:
&& garante que só restarta se compilar limpo. Compile com erro aborta o flow, AppServer fica intacto.--all-envs é recomendado quando o server tem múltiplos environments (típico: protheus + protheus_rest) — RPO sai sincronizado entre eles.advpls, passe --port no tq:
plugadvpl tq --use-server Local --port 8019
Se tem endpoint REST custom pra testar, valide depois do tq voltar:
curl -s http://<host>:<port>/rest/<endpoint> | jq .
Se quebrou:
console.log do AppServer (path em appserver.ini → [General].ConsoleFile).plugadvpl log-diagnose <console.log> pra rodar a KB de 93 correction tips.| Sinal | Provável causa | Fix |
|---|---|---|
compile exit 1 com C2xxx | erro de sintaxe / include faltando | /plugadvpl:compile mostra diagnóstico, edita fonte e repete |
tq exit 1 com restart_exit_code != 0 | restart_cmd falhou (permissão, path errado) | rode o cmd manual pra ver erro completo |
tq exit 1 com healthcheck timeout | AppServer demorou pra subir / porta REST diferente | aumente --timeout ou ajuste --port |
smoke 500 mas tq ok | bug no fonte que compilou mas estoura em runtime | log-diagnose no console.log |
Cenário real: ajustar coletadb.tlpp, publicar nos 2 envs, validar /rest/coletadb/ping:
# 1. Compile + restart
plugadvpl compile --use-server Local --all-envs docs/reference-impl/coletadb.tlpp && \
plugadvpl tq --use-server Local --port 8019
# 2. Smoke
curl -s http://127.0.0.1:8019/rest/coletadb/ping
Se o smoke der 200, deploy ok. Qualquer fail anterior aborta a cadeia.
/plugadvpl:compile — passo 1 isolado/plugadvpl:tq — passo 2 isolado/plugadvpl:edit-prw — fluxo de edição antes do deploy (preserva encoding CP1252)/plugadvpl:log-diagnose — troubleshoot pós-deploynpx claudepluginhub jonipraia/plugadvpl --plugin plugadvplCompiles ADVPL source code via plugadvpl (TOTVS advpls wrapper). Includes a mandatory 4-step workflow for the Claude Code agent.
Builds (npm run build) and deploys Power Apps code apps to Power Platform using pac code push. Handles TS errors, user confirmation, Mac auth fallback, and memory bank updates.
Scaffolds, builds, debugs, and deploys UiPath Coded Web Apps and Coded Action Apps using the uip CLI and @uipath/uipath-typescript SDK. Handles app.config.json, action-schema.json, and full publish/deploy pipeline.