@pathbit/agentdevkit 0.0.20 → 0.0.21
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md
CHANGED
|
@@ -4,6 +4,11 @@ description: Alterações verificáveis por versão do AgentDevKit.
|
|
|
4
4
|
|
|
5
5
|
# Changelog
|
|
6
6
|
|
|
7
|
+
## 0.0.21 — 2026-11-13
|
|
8
|
+
|
|
9
|
+
- Criação automática da tag da versão após aprovação da matriz de CI.
|
|
10
|
+
- Publicação acionada pela automação com proteção contra colisões de tags.
|
|
11
|
+
|
|
7
12
|
## 0.0.20 — 2026-11-13
|
|
8
13
|
|
|
9
14
|
- Atualização da ferramenta agent-browser compatível com sua distribuição atual.
|
|
@@ -75,8 +75,15 @@ nada. Nunca versione o tarball ou seus relatórios.
|
|
|
75
75
|
|
|
76
76
|
1. Atualize versão e lockfile, changelog, exemplos e escopo da entrega.
|
|
77
77
|
2. Conclua testes, documentação e revisão independente.
|
|
78
|
-
3. Envie o commit à branch principal e
|
|
79
|
-
|
|
78
|
+
3. Envie o commit à branch principal e acompanhe o CI e a release.
|
|
79
|
+
|
|
80
|
+
Após toda a matriz de CI passar, a automação cria a tag `v<versão>` no
|
|
81
|
+
commit verificado e inicia o workflow de release. Um push sem mudança de versão
|
|
82
|
+
publicada não gera outra release. Uma tag existente não é movida: se a versão
|
|
83
|
+
mudou e a tag aponta para outro commit, a automação falha para revisão.
|
|
84
|
+
Versões inferiores às já registradas também não são publicadas automaticamente.
|
|
85
|
+
Se um push cancelar o CI anterior e a versão ainda não tiver tag, o próximo
|
|
86
|
+
CI aprovado da branch principal poderá publicar a versão no seu próprio commit.
|
|
80
87
|
|
|
81
88
|
O [workflow de release][release] localiza o CI aprovado de um push na branch
|
|
82
89
|
principal, confere o commit e baixa seu artifact por ID. Verifica procedência,
|
|
@@ -85,9 +92,10 @@ Também envia o mesmo pacote ao [npm público e GitHub Packages](packages.md),
|
|
|
85
92
|
confere a integridade nos dois destinos e testa versão, instalação, diagnóstico
|
|
86
93
|
e sincronização. O consumo pelo npm é anônimo; pelo GitHub, autenticado.
|
|
87
94
|
|
|
88
|
-
A tag é a origem da publicação: `v0.0.
|
|
89
|
-
`0.0.
|
|
90
|
-
não crie outra tag para uma versão nem mova uma tag já publicada.
|
|
95
|
+
A tag é a origem da publicação: `v0.0.21`, a release `v0.0.21` e os pacotes
|
|
96
|
+
`0.0.21` apontam para a mesma entrega. A execução manual também exige a tag;
|
|
97
|
+
não crie outra tag para uma versão nem mova uma tag já publicada. Publicações
|
|
98
|
+
feitas fora desse fluxo não criam tags automaticamente.
|
|
91
99
|
|
|
92
100
|
Para consultar o código de uma versão sem trocar os arquivos atuais:
|
|
93
101
|
|
|
@@ -124,6 +132,9 @@ Se a release ainda não existe, use **Re-run failed jobs** ou
|
|
|
124
132
|
`gh workflow run release.yml --ref vX.Y.Z` com a tag real. A publicação prioriza
|
|
125
133
|
o secret `NPMJS_TOKEN` do repositório; sem ele, usa OIDC, conforme
|
|
126
134
|
[publicação](packages.md).
|
|
135
|
+
Se a criação da tag ou o acionamento falhar, consulte a execução **Automatic
|
|
136
|
+
release tag**. Uma tag no commit correto pode ser retomada sem movê-la; se ela
|
|
137
|
+
apontar para outro commit, investigue antes de qualquer publicação.
|
|
127
138
|
|
|
128
139
|
Se a release já existe e falta somente o pacote em um registro, use o modo
|
|
129
140
|
`package_only` descrito em [pacote npm](packages.md#publicar-pelo-actions).
|
package/docs/specs/README.md
CHANGED
|
@@ -27,6 +27,7 @@ description: Incrementos verificáveis do AgentDevKit.
|
|
|
27
27
|
- [Ignore do projeto](project-ignore/SPEC.md): preservar o arquivo da raiz.
|
|
28
28
|
- [Ignore de clientes](client-ignore/SPEC.md): padrão local e exceções do projeto.
|
|
29
29
|
- [Ferramenta e versões](tool-release/SPEC.md): atualização segura e tags de release.
|
|
30
|
+
- [Tags automáticas](automatic-release-tags/SPEC.md): publicação após CI aprovada.
|
|
30
31
|
|
|
31
32
|
Cada incremento vincula requisitos, critérios, testes e evidências locais.
|
|
32
33
|
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: Criação e publicação seguras de tags de versões verificadas.
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# Tags automáticas de release
|
|
6
|
+
|
|
7
|
+
## Critérios de aceite
|
|
8
|
+
|
|
9
|
+
- AC-001: A CI cria `v<versão>` no commit da branch principal somente após
|
|
10
|
+
toda a matriz passar e inicia a publicação do mesmo commit.
|
|
11
|
+
- AC-002: Alterações sem nova versão não duplicam publicações; tags existentes
|
|
12
|
+
nunca são movidas e colisões ou regressões de versão impedem a publicação.
|
|
13
|
+
- AC-003: A release e os dois pacotes usam o mesmo artefato e a mesma versão
|
|
14
|
+
da tag; a publicação exige o CI completo aprovado.
|
|
15
|
+
- AC-004: Testes verificam eventos indevidos, falhas, colisões, retomada e
|
|
16
|
+
corridas sem criar tags ou publicar pacotes reais.
|