Document the public 0.5.0 release

Author: JVLegend

CHANGELOG.md

@@ -6,7 +6,11 @@ medidos pelos scripts versionados.
 
 ## Não publicado
 
-Nenhuma mudança registrada.
+### Documentação
+
+- registrou a publicação pública da `0.5.0`, os hashes dos artefatos e o smoke
+  test de instalação independente;
+- adicionou badge do PyPI e a lab note da primeira release pública.
 
 ## 0.5.0 - 2026-08-04
 

README.md

@@ -7,6 +7,7 @@
 ### Open detection of engineered biosignatures in remote hyperspectral imagery
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-b8972a.svg)](LICENSE)
+[![PyPI](https://img.shields.io/pypi/v/hypermix.svg)](https://pypi.org/project/hypermix/)
 [![Python](https://img.shields.io/badge/python-3.10%20to%203.14-1a2f52.svg)](pyproject.toml)
 [![PyTorch](https://img.shields.io/badge/detector-PyTorch-ee4c2c.svg)](hypermix/detector.py)
 [![Tests](https://img.shields.io/badge/tests-67%20passing-2ea44f.svg)](tests/)

RELEASE.md

@@ -1,5 +1,8 @@
 # Publicando o HyperMix
 
+Estado da `0.5.0`: publicada no GitHub e no PyPI em 2026-08-04. O procedimento
+abaixo permanece como registro auditável e base para a próxima versão.
+
 O HyperMix usa PyPI Trusted Publishing. Não crie token permanente e não salve
 credenciais no GitHub ou no repositório.
 

STATUS.md

@@ -2,6 +2,28 @@
 
 Source of progress truth for the repo. Read before starting a phase, update at the end.
 
+## Release pública 0.5.0 no PyPI - 2026-08-04
+
+A versão `0.5.0` foi publicada em https://pypi.org/project/hypermix/ por Trusted
+Publishing/OIDC, sem token permanente. O publisher que era pendente tornou-se
+ativo após o primeiro upload. A GitHub Release está em
+https://github.com/JVLegend/HyperMix/releases/tag/v0.5.0, e o workflow de
+publicação concluiu em
+https://github.com/JVLegend/HyperMix/actions/runs/30969871588.
+
+A tag anotada `v0.5.0` aponta para o commit validado
+`e60cef1302f72885979b88b947871c3ec549fa4e`. Ela não tem assinatura criptográfica
+porque não havia identidade de assinatura configurada na máquina. O PyPI gerou
+atestações digitais para os uploads. Os SHA-256 públicos são:
+
+- wheel: `a8bb453ad75de68d78badcf9bdaa5e0e35deb2c9c92aa2f6c8a284329bb74ae4`;
+- sdist: `4e536805d875d4a35ffa525982a1cfc99e7f8e0af425f90f82cc3783788da0c7`.
+
+Uma instalação sem cache em ambiente vazio baixou `hypermix==0.5.0` do índice,
+confirmou `reference_spectra.csv` e executou o exemplo mínimo com AUC `0,955064`
+para `snr_db=10` e `seed=0`. Esse valor é somente um smoke test do exemplo, não
+um novo resultado científico agregado. Zenodo e DOI continuam pendentes.
+
 ## Release candidate 0.5.0 validado, publisher PyPI pendente - 2026-08-04
 
 Os artefatos versionados da `0.5.0` foram preparados no commit `ddced5b`.

docs/RELEASE_CHECKLIST.md

@@ -1,7 +1,7 @@
 # Checklist da release pública
 
-Estado em 2026-08-04: preparação em andamento. A versão `0.5.0` ainda não foi
-publicada no PyPI, GitHub ou Zenodo.
+Estado em 2026-08-04: a versão `0.5.0` foi publicada no GitHub e no PyPI. Zenodo
+e DOI ainda estão pendentes.
 
 ## Pré-release
 
@@ -20,21 +20,22 @@ publicada no PyPI, GitHub ou Zenodo.
 ## Publicação
 
 - [x] Criar o environment `pypi` no GitHub, sem tokens permanentes.
-- [ ] Criar o projeto `hypermix` no PyPI e configurar Trusted Publishing para
+- [x] Criar o projeto `hypermix` no PyPI e configurar Trusted Publishing para
       `JVLegend/HyperMix` e o workflow aprovado.
 - [x] Adicionar uma etapa OIDC com `id-token: write`; ela só executa quando uma
       release do GitHub é publicada.
-- [ ] Criar a tag assinada `v0.5.0` no commit validado.
+- [x] Criar a tag anotada `v0.5.0` no commit validado `e60cef1`. A tag não foi
+      assinada porque não havia identidade de assinatura configurada.
 - [x] Conferir os artefatos produzidos por `release-artifacts.yml`.
-- [ ] Publicar a release no GitHub com notas derivadas do changelog.
-- [ ] Publicar sdist e wheel no PyPI sem reutilizar o número da versão.
+- [x] Publicar a release no GitHub com notas derivadas do changelog.
+- [x] Publicar sdist e wheel no PyPI sem reutilizar o número da versão.
 - [ ] Ativar ou conferir a integração do repositório com Zenodo.
 - [ ] Registrar o DOI no README e em `CITATION.cff`.
 
 ## Pós-release
 
-- [ ] Instalar `hypermix==0.5.0` em um ambiente vazio.
-- [ ] Executar o exemplo mínimo do README.
+- [x] Instalar `hypermix==0.5.0` em um ambiente vazio e sem cache.
+- [x] Executar o exemplo mínimo do README.
 - [ ] Abrir uma issue para qualquer divergência entre pacote, tag e documentação.
 - [ ] Registrar uma reprodução externa quando ela existir.
 

docs/labnotes/11-hypermix-050-is-public.md

@@ -0,0 +1,34 @@
+# HyperMix 0.5.0 está público
+
+Status: publicado
+Imagem sugerida: página do pacote no PyPI
+
+O HyperMix `0.5.0` agora pode ser instalado diretamente do Python Package
+Index:
+
+```bash
+pip install "hypermix[viz]==0.5.0"
+```
+
+A publicação foi feita por OIDC, sem guardar um token permanente no GitHub. O
+workflow reconstruiu o pacote a partir da tag, executou o gate de consistência,
+validou sdist e wheel e enviou os dois arquivos ao PyPI. O publisher pendente
+se tornou ativo depois do primeiro upload.
+
+Em seguida, uma instalação independente e sem cache baixou a wheel pública em
+um ambiente vazio. Ela confirmou a versão, encontrou o recurso espectral
+curado e executou o exemplo mínimo do README. Para `snr_db=10` e `seed=0`, esse
+smoke test produziu AUC `0,955064`. Esse número valida a instalação; ele não é
+um novo benchmark nem altera a conclusão científica.
+
+Os artefatos públicos têm estes SHA-256:
+
+- wheel: `a8bb453ad75de68d78badcf9bdaa5e0e35deb2c9c92aa2f6c8a284329bb74ae4`;
+- sdist: `4e536805d875d4a35ffa525982a1cfc99e7f8e0af425f90f82cc3783788da0c7`.
+
+A versão pública preserva o resultado central do projeto. Nos experimentos
+concluídos, nenhum método aprendido superou de forma robusta o matched filter
+espacial bem calibrado. A contribuição é o benchmark aberto e auditável.
+
+O próximo registro permanente será o DOI do Zenodo. A integração ainda depende
+da autenticação da conta e, portanto, não foi antecipada nem inventada.

docs/labnotes/README.md

@@ -17,6 +17,7 @@ advanced since the draft date.
 | 8 | `08-release-gates-before-publication.md` | CI badge after first green run | ready |
 | 9 | `09-the-050-release-candidate-is-ready.md` | CI badge for release candidate | ready |
 | 10 | `10-the-release-now-fails-closed.md` | CI gate or metadata diagram | ready |
+| 11 | `11-hypermix-050-is-public.md` | PyPI project page or release badge | ready |
 
 Public framing to preserve in every post: