@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,6 +1,6 @@
1
1
  {
2
2
  "name": "@puca/puca-core",
3
- "version": "14.16.3",
3
+ "version": "14.16.4",
4
4
  "description": "",
5
5
  "author": "Raphael Aguiar",
6
6
  "license": "UNLICENSED",
@@ -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