From 6fc4cf4a33e2af65dc6fa0357343e2246acdb5ea Mon Sep 17 00:00:00 2001 From: paodelonga Date: Thu, 22 Oct 2026 01:56:55 -0300 Subject: [PATCH] docs(processo): aponta o propagar e a lista de manuais para os scripts do modpack MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit O op.sh propagar passa a ser o caminho principal; o passo a passo à mão fica para quando o script não puder rodar. A tabela de processos manuais mostra o script de cada issue do modpack. Signed-off-by: paodelonga --- processo/automatico.md | 6 +++--- processo/manual.md | 28 +++++++++++++++------------- processo/propagar.md | 31 +++++++++++++++++++++++++------ 3 files changed, 43 insertions(+), 22 deletions(-) diff --git a/processo/automatico.md b/processo/automatico.md index d1cf801..a6bfda3 100644 --- a/processo/automatico.md +++ b/processo/automatico.md @@ -14,7 +14,7 @@ Os workflows de agenda só rodam na `main` do repositório. | Todo dia, 09h17 UTC (06h17 em Brasília) | `modpack-moderacao` | Acompanhar pack base | Se o `modpack` tem estável nova, a branch `base/vX.Y.Z` e o PR (ou uma issue, se o Actions não puder abrir PR) | | Segunda, 06h17 UTC (03h17) | `minecraft-infra` | Cloudflare backup | Artefato com a configuração das zonas do domínio | | Segunda, 10h23 UTC (07h23) | `modpack` | Atualizações de mods | Issue fixa **Mods com versão nova**, fechada quando não há nada pendente | -| Segunda, 10h53 UTC (07h53) | `modpack` | Resumo semanal | Issue fixa **Resumo semanal**: versões dos três repositórios e se estão alinhadas, CI quebrado, commits fora da `main`, PRs e issues abertos, envios de config pendentes e o estado da CurseForge | +| Segunda, 10h53 UTC (07h53) | `modpack` | Resumo semanal | Issue fixa **Resumo semanal**: versões dos três repositórios e se estão alinhadas, CI quebrado, commits fora da `main`, PRs e issues abertos, envios de config pendentes, o estado da CurseForge e quando vencem os tokens | ## Por evento @@ -44,8 +44,8 @@ PR devel/devel → main (modpack) envio manual ao servidor (pessoa) ``` -Os passos entre o Release do `modpack` e o `MODPACK` ainda são feitos à mão ou -pela skill `/propagar`: veja [propagar uma estável](propagar.md). +Os passos entre o Release do `modpack` e o `MODPACK` são feitos por uma pessoa +com o `op.sh propagar` (ou a skill `/propagar`): veja [propagar uma estável](propagar.md). ## Referência de cada repositório diff --git a/processo/manual.md b/processo/manual.md index 54bf3cf..dc17841 100644 --- a/processo/manual.md +++ b/processo/manual.md @@ -18,21 +18,23 @@ foi revisada em 20/10/2026. O que roda sozinho está em ## Ainda pela skill, vai virar script -Estes passos são mecânicos, mas hoje dependem de uma skill do Claude Code. -Sem ela, são feitos à mão pelos guias de cada repositório. Cada um tem uma -issue com o passo atual e o script proposto. +Estes passos são mecânicos e já viraram script no `modpack` (22/10/2026); a +skill só chama o script. Os que faltam estão nas issues dos outros dois +repositórios. As issues do `modpack` fecham quando a estável com os scripts +chegar à `main`. -| Skill | Passo | Issue | +| Passo | Script | Issue | | --- | --- | --- | -| `/add-mod` (modpack) | Definir o lado de cada mod pelo Modrinth | [modpack#17](https://github.com/IunaMC/modpack/issues/17) | -| `/remover-mod` | Achar dependências órfãs e configs que sobram | [modpack#18](https://github.com/IunaMC/modpack/issues/18) | -| `/beta` | Versão, `refresh`, README, commit, push e acompanhar o Release | [modpack#19](https://github.com/IunaMC/modpack/issues/19) | -| `/estavel` | PR, merge, Release e alinhar a `devel/devel` | [modpack#20](https://github.com/IunaMC/modpack/issues/20) | -| `/propagar` | Moderação (refazer o commit do bot com assinatura, PR, merge) e `MODPACK` | [modpack#21](https://github.com/IunaMC/modpack/issues/21) | -| `/testar` (modpack) | Esperar o Validar e mostrar só o erro | [modpack#22](https://github.com/IunaMC/modpack/issues/22) | -| `/enviar-configs` | Comparar a `config/` do servidor com o repositório | [minecraft-config#10](https://github.com/IunaMC/minecraft-config/issues/10) | -| `/versao` e `/testar` (configs) | Versão, conferência dos marcadores e teste | [minecraft-config#11](https://github.com/IunaMC/minecraft-config/issues/11) | -| `/add-mod` (moderação) | Achar o que o pack base já tem | [modpack-moderacao#8](https://github.com/IunaMC/modpack-moderacao/issues/8) | +| Definir o lado de cada mod pelo Modrinth (`/add-mod`) | `pack.py lado` | [modpack#17](https://github.com/IunaMC/modpack/issues/17) | +| Achar dependências órfãs e configs que sobram (`/remover-mod`) | `pack.py orfas` | [modpack#18](https://github.com/IunaMC/modpack/issues/18) | +| Versão, `refresh`, README, commit, push e acompanhar o Release (`/beta`) | `op.sh beta` | [modpack#19](https://github.com/IunaMC/modpack/issues/19) | +| PR, merge, Release e alinhar a `devel/devel` (`/estavel`) | `op.sh estavel` | [modpack#20](https://github.com/IunaMC/modpack/issues/20) | +| Moderação (refazer o commit do bot com assinatura, PR, merge) e `MODPACK` (`/propagar`) | `op.sh propagar` | [modpack#21](https://github.com/IunaMC/modpack/issues/21) | +| Esperar o Validar e mostrar só o erro (`/testar`) | `op.sh ci` | [modpack#22](https://github.com/IunaMC/modpack/issues/22) | +| Avisar quando um token vence | Resumo semanal | [modpack#23](https://github.com/IunaMC/modpack/issues/23) | +| Comparar a `config/` do servidor com o repositório (`/enviar-configs`) | a fazer | [minecraft-config#10](https://github.com/IunaMC/minecraft-config/issues/10) | +| Versão, conferência dos marcadores e teste (`/versao` e `/testar` das configs) | a fazer | [minecraft-config#11](https://github.com/IunaMC/minecraft-config/issues/11) | +| Achar o que o pack base já tem (`/add-mod` da moderação) | a fazer | [modpack-moderacao#8](https://github.com/IunaMC/modpack-moderacao/issues/8) | Continuam com pessoa ou com a skill: escrever o `MUDANCAS.md` e o texto dos PRs, achar o Project ID da CurseForge de um mod novo e ler perfis do Spark. diff --git a/processo/propagar.md b/processo/propagar.md index 5d89f30..9546414 100644 --- a/processo/propagar.md +++ b/processo/propagar.md @@ -1,16 +1,35 @@ # Propagar uma estável Depois de uma estável do `modpack`, leve a mesma versão ao pack da staff e às -configs. No Claude Code, a skill `/propagar` do modpack faz estes passos, e o -`/estavel` já a chama no fim. +configs. O `op.sh propagar` do modpack faz estes passos, a skill `/propagar` +chama o script e o `/estavel` já a chama no fim. -## Moderação +## Pelo script + +No clone do `modpack`, com os clones `iunamc.modpack-moderacao` e +`iunamc.minecraft-config` ao lado (árvores limpas, e as configs na +`devel/devel`): + +```sh +bash scripts/op.sh propagar X.Y.Z +``` + +O script faz os dois lados abaixo, em ordem, e para no primeiro passo +vermelho. Pula o que já está na versão. O guia do comando está em +[propagar](https://github.com/IunaMC/modpack/blob/devel/devel/docs/guias/propagar.md) +no `modpack`. + +## Passo a passo à mão + +Para quando o script não puder rodar. + +### Moderação 1. O workflow *Acompanhar pack base* do `modpack-moderacao` abre a branch `base/vX.Y.Z`. Ele roda todo dia; para não esperar: `gh workflow run acompanhar-base.yaml -R IunaMC/modpack-moderacao`. -2. O commit do bot vem sem assinatura. Refaça com a sua, no clone do - `modpack-moderacao`: +2. O commit do bot vem sem assinatura, porque o Actions não tem a chave de + quem mantém. Refaça com a sua, no clone do `modpack-moderacao`: ```sh git fetch --prune && git switch base/vX.Y.Z @@ -36,7 +55,7 @@ configs. No Claude Code, a skill `/propagar` do modpack faz estes passos, e o git switch devel/devel && git fetch && git merge --ff-only origin/main && git push ``` -## Configs +### Configs 1. No clone do `minecraft-config`, na `devel/devel`, escreva a versão em `MODPACK` (sem o `v`):