Skip to content

feat(ci): publicar releases desktop automaticamente após merges - #14

Merged
vitormattos merged 10 commits into
mainfrom
feat/automatic-desktop-releases
Nov 17, 2026
Merged

vitormattos merged 10 commits into
mainfrom
feat/automatic-desktop-releases

Conversation

@vitormattos

@vitormattos vitormattos commented Nov 17, 2026 •

Copy link
Copy Markdown
Member

Objetivo

Após merge na main, planejar automaticamente a próxima versão estável pelo histórico de Conventional Commits e publicar os instaladores Linux, Windows e macOS, sem um segundo PR de versionamento.

Contrato de versionamento

  • fix:, perf: e revert: ⇒ PATCH; feat: ⇒ MINOR; !: ou BREAKING CHANGE: ⇒ MAJOR.
  • docs:, test:, chore: e mensagens não convencionais, isoladamente, não geram release.
  • O incremento de maior impacto vence. A referência é a última tag estável; o planejador também entende tags em commits laterais contendo somente o bump de versão.
  • O package.json e o lockfile recebem a versão calculada somente na workspace do build e no commit versionado pela tag. Não há número de versão fixo no YAML e a main não recebe commits automatizados de bump.

Fluxo seguro e testável

  • .github/workflows/desktop-release.yml reage a push main e usa jobs plan → packages → publish. Merge apenas documental não compila nem publica binários.
  • Os 4 jobs de empacotamento precisam concluir com sucesso antes de registrar a tag.
  • scripts/plan-desktop-release.mjs: cálculo SemVer, histórico Git e notas de release.
  • scripts/finalize-desktop-release.mjs: commit de versão com DCO, tag, publicação em draft e posterior publicação pública, com executor de comandos injetável para testes sem rede.
  • Se uma publicação falhar após criar draft/tag, workflow_dispatch na main com release_tag recupera a mesma versão. Um release já publicado não é sobrescrito; tags nunca são forçadas.
  • Segredos de assinatura e o job publish são bloqueados para eventos de PR independentemente do resultado calculado pelo código da branch.
  • PRs exigem mensagens e títulos Conventional Commits; usamos o mesmo action pinado empregado no LibreSign.
  • O README permanece inalterado; o funcionamento está em docs/DISTRIBUTION.md.

Validações

  • 11 testes locais aprovados para versionamento, não publicação de docs, evolução de tags Git, proteção contra duplicação, interrupção de upload e recuperação de draft.
  • npm version --no-git-tag-version --ignore-scripts foi validado em fixture local para atualização simultânea de pacote e lockfile.
  • A CI do PR executa esses testes junto com PHPUnit e builds desktop; não houve publicação real ou execução de upgrade de dispositivos físicos nesta branch.
  • Commits da implementação assinados criptograficamente e com DCO confirmado.

Limites de homologação

As releases geradas após merge ainda precisam de homologação de instalação e atualização em máquinas físicas. O job publish precisa de contents: write; um repositório que exija assinatura criptográfica também dos commits versionados pelo bot precisará ter essa capacidade configurada. O GitHub GITHUB_TOKEN não reaciona workflows por push de tags; por isso tag e publicação ocorrem no mesmo run.

Não efetuar merge sem verificar os checks finais deste PR.

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
…checks

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>
@vitormattos
vitormattos merged commit 10e2833 into main Nov 17, 2026
6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant