@spec-wave/cli 1.0.4 → 1.0.5

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": "@spec-wave/cli",
3
- "version": "1.0.4",
3
+ "version": "1.0.5",
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.4",
4
+ "version": "1.0.5",
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",
@@ -49,7 +49,7 @@ npx @spec-wave/cli@latest repo list
49
49
 
50
50
  Os workflows precisam de um token que atravesse repositórios e mexa no Project. Dois modos, e o `doctor` diz qual está em uso:
51
51
 
52
- - **GitHub App da organização** (preferido): secrets `SPEC_WAVE_APP_ID` e `SPEC_WAVE_APP_PRIVATE_KEY` (PEM completo) no hub **e** nos repos de código, com a App instalada em todos eles. Permissões mínimas: Issues RW, Contents RW, Pull requests RW, Metadata R, Projects (org) RW. Cada workflow gera um token por run (`actions/create-github-app-token`) — quem sai da org não derruba o fluxo, e `GH_PR_TOKEN` deixa de ser necessário (PR aberto por App dispara workflows).
52
+ - **GitHub App da organização** (preferido): secrets `SPEC_WAVE_APP_ID` e `SPEC_WAVE_APP_PRIVATE_KEY` (PEM completo) no hub **e** nos repos de código, com a App instalada em todos eles. Permissões mínimas para os workflows: Issues RW, Contents RW, Pull requests RW, Metadata R, Projects (org) RW. Se a App também for usada para rodar `init`/`update` (token `ghs_` gravando `.github/workflows/` pela Contents API), acrescente **Workflows: write** — sem ela o GitHub responde 422 "refusing to allow a GitHub App to create or update workflow … without workflows permission". Cada workflow gera um token por run (`actions/create-github-app-token`) — quem sai da org não derruba o fluxo, e `GH_PR_TOKEN` deixa de ser necessário (PR aberto por App dispara workflows).
53
53
  - **PATs** (modo original): `GH_PROJECT_TOKEN` (escopos `repo` + `project`), `GH_PR_TOKEN` quando a org proíbe o `GITHUB_TOKEN` de abrir PR, e `SPEC_WAVE_HUB_TOKEN` no repo de código. Com a App configurada, esses viram fallback.
54
54
 
55
55
  `init` e `doctor` aceitam token de instalação de App (`ghs_…`) — sem escopos legíveis, a verificação é funcional (acesso ao repo e ao Project).
@@ -573,7 +573,7 @@ npx @spec-wave/cli@latest repo list
573
573
 
574
574
  Os workflows precisam de um token que atravesse repositórios e mexa no Project. Dois modos, e o `doctor` diz qual está em uso:
575
575
 
576
- - **GitHub App da organização** (preferido): secrets `SPEC_WAVE_APP_ID` e `SPEC_WAVE_APP_PRIVATE_KEY` (PEM completo) no hub **e** nos repos de código, com a App instalada em todos eles. Permissões mínimas: Issues RW, Contents RW, Pull requests RW, Metadata R, Projects (org) RW. Cada workflow gera um token por run (`actions/create-github-app-token`) — quem sai da org não derruba o fluxo, e `GH_PR_TOKEN` deixa de ser necessário (PR aberto por App dispara workflows).
576
+ - **GitHub App da organização** (preferido): secrets `SPEC_WAVE_APP_ID` e `SPEC_WAVE_APP_PRIVATE_KEY` (PEM completo) no hub **e** nos repos de código, com a App instalada em todos eles. Permissões mínimas para os workflows: Issues RW, Contents RW, Pull requests RW, Metadata R, Projects (org) RW. Se a App também for usada para rodar `init`/`update` (token `ghs_` gravando `.github/workflows/` pela Contents API), acrescente **Workflows: write** — sem ela o GitHub responde 422 "refusing to allow a GitHub App to create or update workflow … without workflows permission". Cada workflow gera um token por run (`actions/create-github-app-token`) — quem sai da org não derruba o fluxo, e `GH_PR_TOKEN` deixa de ser necessário (PR aberto por App dispara workflows).
577
577
  - **PATs** (modo original): `GH_PROJECT_TOKEN` (escopos `repo` + `project`), `GH_PR_TOKEN` quando a org proíbe o `GITHUB_TOKEN` de abrir PR, e `SPEC_WAVE_HUB_TOKEN` no repo de código. Com a App configurada, esses viram fallback.
578
578
 
579
579
  `init` e `doctor` aceitam token de instalação de App (`ghs_…`) — sem escopos legíveis, a verificação é funcional (acesso ao repo e ao Project).