@spec-wave/cli 1.0.6 → 1.0.7

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/README.md CHANGED
@@ -104,12 +104,37 @@ Arquivo em `.github/config/tech_context.yml` que descreve a stack tecnológica d
104
104
  ## Pré-requisitos
105
105
 
106
106
  - Node.js >= 20
107
+ - O repositório pertence a uma **organização**, não a uma conta pessoal — o `init` recusa conta
108
+ pessoal, porque a instalação de um GitHub App não alcança Projects v2 fora de uma org e metade do
109
+ fluxo (tudo que move card) morreria em runtime
107
110
  - GitHub CLI (`gh`) autenticado com escopos `project`, `repo` e `workflow`:
108
111
  ```bash
109
112
  gh auth refresh --scopes project,repo,workflow
110
113
  ```
114
+ - **Actions habilitado** no repositório e permitido pela política da organização
111
115
  - Secret no repositório, conforme o provider: `ANTHROPIC_API_KEY`, `CLAUDE_CODE_OAUTH_TOKEN` (assinatura Claude Pro/Max) ou `OPENROUTER_API_KEY` (Settings → Secrets → Actions)
112
- - Para repositórios em organizações: criar PAT com escopo `project` e adicionar como secret `GH_PROJECT_TOKEN`
116
+
117
+ ### Autenticação dos workflows: GitHub App ou PATs
118
+
119
+ O `GITHUB_TOKEN` do Actions **não** tem escopo de Projects e não alcança outro repositório. Dois
120
+ caminhos preenchem essa lacuna — e `spec-wave doctor` diz qual está valendo:
121
+
122
+ **GitHub App da organização (recomendado).** Crie uma App na org, instale no hub e em cada
123
+ repositório de código, e grave `SPEC_WAVE_APP_ID` + `SPEC_WAVE_APP_PRIVATE_KEY` (o `.pem` completo).
124
+ Cada execução gera o próprio token, sem depender do PAT de uma pessoa. Permissões: Issues RW,
125
+ Contents RW, Pull requests RW, Metadata R, Projects (org) RW — mais Workflows W só se a App também
126
+ for usada para rodar `init`/`update`. Prefira secret de **organização**; se a visibilidade for
127
+ *Selected repositories*, lembre de acrescentar cada repositório novo à lista, senão o workflow dele
128
+ não enxerga o secret e a falha só aparece na primeira execução.
129
+
130
+ **PATs (sem App).** `GH_PROJECT_TOKEN` com escopo `project` (mover cards), `GH_PR_TOKEN` quando a
131
+ organização não permite o Actions abrir PR ou a branch exige status checks, e `SPEC_WAVE_HUB_TOKEN`
132
+ no repositório de código (multi-repo). O PAT é de uma pessoa: quando ela sai da organização — ou o
133
+ token expira — os workflows param em silêncio.
134
+
135
+ Checklist completo, com o sintoma de cada item quando falta, em
136
+ [Configurações do GitHub](https://github.com/astratech-net-br/spec-wave-cli/blob/main/apps/docs/src/content/docs/configuracao/github.md)
137
+ — este README é publicado no npm, então o link é absoluto de propósito.
113
138
 
114
139
  ---
115
140
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@spec-wave/cli",
3
- "version": "1.0.6",
3
+ "version": "1.0.7",
4
4
  "description": "Setup spec-driven GitHub workflow with Projects v2, labels, issue templates, and AI-powered Actions",
5
5
  "type": "module",
6
6
  "bin": {
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "spec-wave",
3
3
  "displayName": "Spec Wave",
4
- "version": "1.0.6",
4
+ "version": "1.0.7",
5
5
  "description": "Fluxo spec-driven no GitHub (RFC-001): Projects v2, labels de gatilho, spec/plan gerados por Action, decomposição em duas etapas e implementação orientada a Stories/Tasks.",
6
6
  "author": {
7
7
  "name": "Astratech",