@tunnelhub/mcp 1.0.6 → 1.0.9
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/CONTRIBUTING.md +19 -0
- package/README.md +27 -0
- package/package.json +1 -1
package/CONTRIBUTING.md
CHANGED
|
@@ -68,3 +68,22 @@ Package publication is validated with:
|
|
|
68
68
|
pnpm pack:check
|
|
69
69
|
pnpm publish:dry-run
|
|
70
70
|
```
|
|
71
|
+
|
|
72
|
+
## Release process
|
|
73
|
+
|
|
74
|
+
Releases are created from git tags in the format `vX.Y.Z`.
|
|
75
|
+
|
|
76
|
+
Typical flow:
|
|
77
|
+
|
|
78
|
+
```bash
|
|
79
|
+
pnpm release:patch
|
|
80
|
+
git push origin main --follow-tags
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
The GitHub Actions workflow then:
|
|
84
|
+
|
|
85
|
+
- validates the pushed tag against `package.json`
|
|
86
|
+
- runs `pnpm check`
|
|
87
|
+
- creates the package tarball with `npm pack`
|
|
88
|
+
- publishes to npm using trusted publishing with GitHub Actions OIDC
|
|
89
|
+
- creates or updates the matching GitHub Release
|
package/README.md
CHANGED
|
@@ -381,6 +381,33 @@ Se você estiver evoluindo o MCP internamente, vale sempre validar:
|
|
|
381
381
|
- Consistência dos filtros
|
|
382
382
|
- Qualidade dos exemplos do README
|
|
383
383
|
|
|
384
|
+
## 📦 Releases
|
|
385
|
+
|
|
386
|
+
O repositório publica GitHub Releases e o pacote no npm a partir de tags no formato `vX.Y.Z`.
|
|
387
|
+
|
|
388
|
+
Fluxo recomendado:
|
|
389
|
+
|
|
390
|
+
1. Garanta que a branch principal esteja pronta para release
|
|
391
|
+
2. Atualize a versão com um dos comandos abaixo:
|
|
392
|
+
- `pnpm release:patch`
|
|
393
|
+
- `pnpm release:minor`
|
|
394
|
+
- `pnpm release:major`
|
|
395
|
+
3. Envie o commit e a tag:
|
|
396
|
+
|
|
397
|
+
```bash
|
|
398
|
+
git push origin main --follow-tags
|
|
399
|
+
```
|
|
400
|
+
|
|
401
|
+
Quando a tag chegar no GitHub, o workflow de release:
|
|
402
|
+
|
|
403
|
+
- valida se a tag bate com a versão do `package.json`
|
|
404
|
+
- roda `pnpm check`
|
|
405
|
+
- gera o tarball com `npm pack`
|
|
406
|
+
- publica no npm via Trusted Publishing (OIDC)
|
|
407
|
+
- cria ou atualiza a GitHub Release com notas automáticas
|
|
408
|
+
|
|
409
|
+
Para o publish no npm funcionar, configure o pacote no npm com `Trusted Publisher` apontando para `tunnelhub/mcp` e o workflow `release.yml`.
|
|
410
|
+
|
|
384
411
|
## 📚 Documentação técnica
|
|
385
412
|
|
|
386
413
|
Detalhes técnicos, arquitetura e comportamento interno estão documentados em inglês:
|