@puca/puca-core 14.16.3 → 14.16.4
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/package.json
CHANGED
|
@@ -1,128 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: build-publish-puca-core
|
|
3
|
-
description: >-
|
|
4
|
-
Orienta o build e publish do puca-core-lib (@puca/puca-core): commit opcional,
|
|
5
|
-
npm version, git push com a nova tag, npm publish. Também atualiza a versão do
|
|
6
|
-
@puca/puca-core no package.json de módulos que forem gerados em seguida via tag.sh.
|
|
7
|
-
Use quando o usuário pedir build, publish, versionar, ou lançar nova versão do puca-core-lib.
|
|
8
|
-
alwaysApply: false
|
|
9
|
-
---
|
|
10
|
-
|
|
11
|
-
# Build & Publish — `puca-core-lib` (`@puca/puca-core`)
|
|
12
|
-
|
|
13
|
-
Skill operacional: versionar, buildar e publicar o pacote `@puca/puca-core` no npm, e (quando aplicável) propagar a nova versão nos módulos que serão gerados em seguida.
|
|
14
|
-
|
|
15
|
-
## Pré-condições
|
|
16
|
-
|
|
17
|
-
- Diretório de trabalho: `puca-core-lib/`
|
|
18
|
-
- Branch: `master`
|
|
19
|
-
- Acesso ao npm registry configurado (`npm whoami` deve retornar o usuário)
|
|
20
|
-
|
|
21
|
-
## ⚠️ Obrigatório — rodar fora do sandbox
|
|
22
|
-
|
|
23
|
-
**Todos os comandos desta skill devem ser executados fora do sandbox** (`required_permissions: ["all"]` em toda chamada ao Shell tool). Isso se aplica a: git, npm version, npm publish e qualquer edição de `package.json` via shell.
|
|
24
|
-
|
|
25
|
-
Motivo: `npm publish` e `git push` requerem acesso irrestrito à rede e ao sistema de arquivos.
|
|
26
|
-
|
|
27
|
-
## Fluxo completo
|
|
28
|
-
|
|
29
|
-
### 1. Commit (se necessário)
|
|
30
|
-
|
|
31
|
-
Verifique se há mudanças não commitadas:
|
|
32
|
-
|
|
33
|
-
```bash
|
|
34
|
-
cd puca-core-lib
|
|
35
|
-
git status
|
|
36
|
-
```
|
|
37
|
-
|
|
38
|
-
Se houver arquivos modificados/staged, faça o commit **somente do que for parte da mudança da lib**:
|
|
39
|
-
|
|
40
|
-
```bash
|
|
41
|
-
git add <arquivos relevantes>
|
|
42
|
-
git commit -m "descrição da mudança"
|
|
43
|
-
```
|
|
44
|
-
|
|
45
|
-
> Nunca faça commit automático de arquivos fora do escopo da alteração. Se houver dúvida, pause e pergunte ao usuário.
|
|
46
|
-
|
|
47
|
-
### 2. Bump de versão
|
|
48
|
-
|
|
49
|
-
Use `npm version` com o incremento correto. **Nunca use `master` — o incremento correto é `patch`, `minor` ou `major`.**
|
|
50
|
-
|
|
51
|
-
```bash
|
|
52
|
-
npm version patch # correção de bug (ex: 14.16.1 → 14.16.2)
|
|
53
|
-
npm version minor # nova feature compatível (ex: 14.16.1 → 14.17.0)
|
|
54
|
-
npm version major # breaking change (ex: 14.16.1 → 15.0.0)
|
|
55
|
-
```
|
|
56
|
-
|
|
57
|
-
O comando já:
|
|
58
|
-
- Atualiza o `version` em `package.json`
|
|
59
|
-
- Cria um commit de versão (`v14.x.x`)
|
|
60
|
-
- Cria a tag git correspondente
|
|
61
|
-
|
|
62
|
-
Após rodar, capture a nova versão:
|
|
63
|
-
|
|
64
|
-
```bash
|
|
65
|
-
NEW_VERSION=$(node -p "require('./package.json').version")
|
|
66
|
-
echo "Nova versão: $NEW_VERSION"
|
|
67
|
-
```
|
|
68
|
-
|
|
69
|
-
### 3. Push (branch + tag)
|
|
70
|
-
|
|
71
|
-
```bash
|
|
72
|
-
git push origin master
|
|
73
|
-
git push origin "v$NEW_VERSION"
|
|
74
|
-
```
|
|
75
|
-
|
|
76
|
-
### 4. Publish
|
|
77
|
-
|
|
78
|
-
> ⚠️ O `prepublishOnly` do `package.json` roda `yarn test && yarn build` automaticamente antes de publicar. Garanta que os testes passem antes de chegar aqui.
|
|
79
|
-
|
|
80
|
-
```bash
|
|
81
|
-
npm publish
|
|
82
|
-
```
|
|
83
|
-
|
|
84
|
-
Se o registry exigir OTP (2FA), o npm solicitará interativamente. **Não tente automatizar o OTP** — deixe o usuário digitar.
|
|
85
|
-
|
|
86
|
-
## Adendo — Propagar versão nos módulos após tag.sh generate
|
|
87
|
-
|
|
88
|
-
Quando o usuário solicitar `tag.sh generate api` de um ou mais módulos **logo após** o publish do puca-core, atualize a dependência `@puca/puca-core` no `package.json` de cada módulo antes de disparar o subagente de generate:
|
|
89
|
-
|
|
90
|
-
### Módulos e seus caminhos de `package.json` (api)
|
|
91
|
-
|
|
92
|
-
| Módulo | package.json |
|
|
93
|
-
|---|---|
|
|
94
|
-
| base | `puca-base/api/package.json` |
|
|
95
|
-
| crud | `puca-crud/api/package.json` |
|
|
96
|
-
| crm | `puca-crm/api/package.json` |
|
|
97
|
-
| fin | `puca-fin/api/package.json` |
|
|
98
|
-
| flow | `puca-flow/api/package.json` |
|
|
99
|
-
| tax | `puca-tax/api/package.json` |
|
|
100
|
-
| recurring-sales | `puca-recurring-sales/api/package.json` |
|
|
101
|
-
| functions | `puca-functions/api/package.json` |
|
|
102
|
-
| indicators | `puca-indicators/api/package.json` |
|
|
103
|
-
| hub | `puca-hub/api/package.json` |
|
|
104
|
-
|
|
105
|
-
### Procedimento de atualização
|
|
106
|
-
|
|
107
|
-
Para cada módulo envolvido, edite o `package.json` e substitua a versão anterior do `@puca/puca-core` pela `NEW_VERSION`:
|
|
108
|
-
|
|
109
|
-
```json
|
|
110
|
-
"@puca/puca-core": "^14.16.2"
|
|
111
|
-
```
|
|
112
|
-
|
|
113
|
-
Use o StrReplace tool (nunca sed/awk). Exemplo de como localizar e substituir:
|
|
114
|
-
|
|
115
|
-
```
|
|
116
|
-
old: "@puca/puca-core": "^14.16.1"
|
|
117
|
-
new: "@puca/puca-core": "^14.16.2"
|
|
118
|
-
```
|
|
119
|
-
|
|
120
|
-
Faça isso **antes** de disparar o subagente `tag-release-automation` para o módulo. Após editar, inclua o `package.json` atualizado no commit de generate (o próprio fluxo do `tag.sh` cuida disso).
|
|
121
|
-
|
|
122
|
-
## Checklist resumido
|
|
123
|
-
|
|
124
|
-
- [ ] `git status` limpo ou commit feito
|
|
125
|
-
- [ ] `npm version [patch|minor|major]` rodado
|
|
126
|
-
- [ ] `git push origin master` + `git push origin vX.Y.Z`
|
|
127
|
-
- [ ] `npm publish` executado (usuário digitou OTP se necessário)
|
|
128
|
-
- [ ] `@puca/puca-core` atualizado nos `package.json` dos módulos que serão gerados em seguida
|