docs: publish gitea host operations guide

docs/public/gitea-actions-host/README.md

@@ -0,0 +1,38 @@
+# Gitea Actions em Host Mode
+
+Esta documentação descreve a operação real do ambiente de Gitea Actions em host mode já validado em produção.
+
+## O que esta solução faz
+
+- executa workflows do Gitea Actions no servidor real, sem Docker nos jobs
+- roda `git fetch`, `checkout`, `reset`, `clean` e o comando de deploy direto nas pastas reais
+- roda `git add`, `commit` e `push` direto nas pastas reais quando a operação é de commit local
+- suporta deploy de projetos Cloudflare e Vercel sem trocar a arquitetura já operacional
+
+## Workflows disponíveis
+
+- `host-deploy`: sincroniza a pasta real e executa o comando de deploy do projeto
+- `host-local-push`: commita e envia alterações locais da pasta real
+- `host-smoke`: valida runner, path, git, node, npm e npx sem fazer deploy
+- `host-ops`: agregador manual para `pull_deploy` ou `commit_push`
+
+## Como a operação funciona
+
+1. O workflow é disparado manualmente no repositório do projeto.
+2. O runner host mode consome o job na máquina real.
+3. O script entra no path real do projeto no servidor.
+4. O script sincroniza o Git ou faz commit local, conforme a operação.
+5. O comando de deploy roda na pasta real do projeto.
+
+## Ressalva importante sobre `runs-on`
+
+- o runner está registrado em host mode com label `linux_amd64:host`
+- nesta instância Gitea `1.25.3`, o agendamento operacional dos workflows funciona com `runs-on: linux_amd64`
+- não force `runs-on: linux_amd64:host` nos workflows ativos, porque isso já demonstrou deixar job em fila sem consumo
+
+## Documentos relacionados
+
+- [Runner](runner.md)
+- [Workflows](workflows.md)
+- [Projetos](projects.md)
+- [Troubleshooting](troubleshooting.md)