@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 +26 -1
- package/package.json +1 -1
- package/src/plugin/.claude-plugin/plugin.json +1 -1
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
|
-
|
|
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,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "spec-wave",
|
|
3
3
|
"displayName": "Spec Wave",
|
|
4
|
-
"version": "1.0.
|
|
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",
|