@spec-wave/cli 1.7.6 → 1.9.0

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.
Files changed (56) hide show
  1. package/README.md +1 -1
  2. package/package.json +1 -1
  3. package/src/agent/errors.mjs +31 -1
  4. package/src/agent/openrouter-agent.mjs +25 -2
  5. package/src/api/github-graphql.mjs +31 -0
  6. package/src/api/github-rest.mjs +20 -0
  7. package/src/cli.mjs +103 -36
  8. package/src/commands/auth-check.mjs +72 -0
  9. package/src/commands/decompose.mjs +14 -2
  10. package/src/commands/doctor.mjs +139 -2
  11. package/src/commands/generate-bug.mjs +6 -6
  12. package/src/commands/generate-plan.mjs +9 -8
  13. package/src/commands/generate-qa-plan.mjs +9 -6
  14. package/src/commands/generate-spec.mjs +12 -7
  15. package/src/commands/implement.mjs +21 -0
  16. package/src/commands/init.mjs +2 -2
  17. package/src/commands/preflight.mjs +38 -2
  18. package/src/commands/progress.mjs +144 -0
  19. package/src/commands/relink.mjs +105 -0
  20. package/src/commands/report-failure.mjs +99 -0
  21. package/src/commands/retry.mjs +91 -0
  22. package/src/commands/task.mjs +5 -0
  23. package/src/commands/update.mjs +70 -0
  24. package/src/config.mjs +8 -8
  25. package/src/lib/cited-paths.mjs +89 -0
  26. package/src/lib/claude.mjs +4 -2
  27. package/src/lib/cli-line.mjs +153 -0
  28. package/src/lib/cli-ref.mjs +53 -2
  29. package/src/lib/failure-report.mjs +319 -0
  30. package/src/lib/progress-events.mjs +46 -0
  31. package/src/lib/repo-identity.mjs +55 -0
  32. package/src/lib/spec-index.mjs +114 -0
  33. package/src/lib/tech-context.mjs +144 -5
  34. package/src/plugin/.claude-plugin/plugin.json +1 -1
  35. package/src/plugin/skills/plan/SKILL.md +1 -1
  36. package/src/plugin/skills/plan/reference/tech-context.md +12 -4
  37. package/src/plugin/skills/setup/SKILL.md +1 -1
  38. package/src/plugin/skills/spec/model-prompt.md +8 -1
  39. package/src/plugins/scm-github/index.mjs +8 -1
  40. package/src/plugins/tracker-github-projects/index.mjs +11 -4
  41. package/src/ports/tracker.mjs +2 -1
  42. package/src/setup/labels.mjs +5 -3
  43. package/src/setup/project.mjs +5 -3
  44. package/src/templates/config/tech_context.yml +29 -25
  45. package/src/templates/skill/SKILL.md +27 -9
  46. package/src/templates/skill/core.md +25 -7
  47. package/src/templates/workflows/code-review.yml +1 -0
  48. package/src/templates/workflows/critique.yml +11 -0
  49. package/src/templates/workflows/decompose.yml +27 -0
  50. package/src/templates/workflows/generate-bug.yml +26 -0
  51. package/src/templates/workflows/generate-plan.yml +26 -0
  52. package/src/templates/workflows/generate-qa-plan.yml +27 -0
  53. package/src/templates/workflows/generate-spec.yml +26 -0
  54. package/src/templates/workflows/pr-events.yml +5 -0
  55. package/src/templates/workflows/qa.yml +1 -0
  56. package/src/templates/workflows/validate.yml +11 -0
@@ -243,6 +243,14 @@ Mesmas flags do `issue` (exceto `--type`, fixo em `feature`). Mantido para o flu
243
243
  > - `generate-spec` / `generate-plan` → **apenas Features**. Para **Spike, RFC e Bug** a geração é **pulada** (o Action remove a label e comenta) — esses tipos não usam spec/plan.
244
244
  > - `decompose` → **Feature** (gera Stories + Tasks) e **RFC** (gera **Tasks** diretamente, sem Stories). Para outros tipos, o Action recusa.
245
245
 
246
+ ### `@spec-wave/cli retry <issue>` — dispara de novo a etapa que falhou (comando LOCAL)
247
+ | Flag | Tipo | Descrição |
248
+ |------|------|-----------|
249
+ | `--label <label>` | string | Label de gatilho a reaplicar. Obrigatória quando a issue não tem nenhuma aplicada (o comando que falhou a removeu). |
250
+ | `--force` | flag | Aceita reaplicar `spec-wave:decompose-apply` (pode duplicar issues já criadas). |
251
+
252
+ > Quando um workflow falha, o comentário ❌ na issue traz a **causa provável** (auth, max_turns, provider…), qual secret trocar e o próximo passo. Depois de corrigir, use `retry` — **não** `gh run rerun`, que reexecuta o commit ORIGINAL e ignora correções já mergeadas (um override de prompt, um workflow atualizado). O `retry` remove e reaplica a label, e o run novo usa a branch default atual. Em modo local o caminho é `run`.
253
+
246
254
  ### `@spec-wave/cli implement` — aciona o spec-kit para uma Feature, Story ou Task (comando LOCAL)
247
255
  | Flag/Arg | Tipo | Descrição |
248
256
  |----------|------|-----------|
@@ -440,11 +448,11 @@ Cada ação de IA (`spec`, `plan`, `decompose`, `critique`) pode usar um modelo
440
448
  "plan": "claude-opus-4-1",
441
449
  "critique": "claude-opus-4-1"
442
450
  },
443
- "escalationModel": "claude-opus-5",
451
+ "escalationModel": "claude-opus-5-5",
444
452
  "maxCritiqueAttempts": 3,
445
453
  "modelAliases": {
446
- "opus": "claude-opus-5",
447
- "haiku": "claude-haiku-4-5"
454
+ "opus": "claude-opus-5-5",
455
+ "haiku": "claude-haiku-5-5"
448
456
  }
449
457
  }
450
458
  }
@@ -617,7 +625,7 @@ Sem essas envs nada muda (instalação normal por `npm install -g`). Com elas, o
617
625
 
618
626
  7. O `init` cria o Project, as labels, os workflows, um **scaffold de `.github/config/tech_context.yml`** (só se ainda não existir) e grava o `.spec-wave.json`. Oriente o usuário a fazer `git pull` para trazer os arquivos ao checkout local.
619
627
 
620
- 8. **Adapte o `tech_context.yml`** — o scaffold vem com dados de exemplo e a qualidade do `plan.md` depende dele. Ofereça ajustá-lo agora; o passo a passo está na seção **Tech Context** deste documento.
628
+ 8. **Preencha o `tech_context.yml`** — o scaffold é um **formulário em branco** aberto pela linha `# spec-wave:template`, e a qualidade do `plan.md` depende dele. Enquanto essa linha existir (ou os campos estiverem vazios) o arquivo conta como **não preenchido**: o `doctor` reprova, o `preflight` bloqueia a rodada e o `generate-plan` gera sem contexto técnico. Ofereça preenchê-lo agora — com o stack real e **sem** a linha do marcador; o passo a passo está na seção **Tech Context** deste documento.
621
629
 
622
630
  9. **Secret de IA:** instrua a adicionar em Settings → Secrets → Actions a credencial do provider escolhido: `ANTHROPIC_API_KEY` (Anthropic), `CLAUDE_CODE_OAUTH_TOKEN` (assinatura Claude Pro/Max — gere com `claude setup-token`) ou `OPENROUTER_API_KEY` (OpenRouter).
623
631
 
@@ -861,7 +869,7 @@ O plano segue o schema do **RFC-002 §3.2**: **Estratégia Técnica** (com Matri
861
869
 
862
870
  1. **A spec existe?** Verifique `docs/features/<slug>/spec.md` — o plano usa a especificação funcional como contexto. Se não existir, gere a spec primeiro (skill **spec**).
863
871
 
864
- 2. **Garanta o `tech_context`.** Verifique se `.github/config/tech_context.yml` existe (Read). **Se não existir, ajude a criar AGORA** — o passo a passo está na seção **Tech Context** deste documento. Garanta que esteja **commitado e pushado** antes de aplicar a label: o Action lê o arquivo do repositório, não do seu disco local.
872
+ 2. **Garanta o `tech_context`.** Verifique se `.github/config/tech_context.yml` existe (Read) e está **preenchido** — o scaffold do `init` é um formulário em branco aberto pela linha `# spec-wave:template`, e nesse estado o plano sai sem contexto técnico. **Se não existir ou não estiver preenchido, ajude a criar AGORA** — o passo a passo está na seção **Tech Context** deste documento. Garanta que esteja **commitado e pushado** antes de aplicar a label: o Action lê o arquivo do repositório, não do seu disco local.
865
873
 
866
874
  3. **Acione**, no modo escolhido:
867
875
  ```bash
@@ -1587,11 +1595,21 @@ utilitários de board estão flag a flag na *Referência da CLI* acima. Rode
1587
1595
 
1588
1596
  ## Tech Context (`.github/config/tech_context.yml`)
1589
1597
 
1590
- Fonte de verdade estática da stack do sistema (RFC-002 §4). O `generate-plan` lê este arquivo para embasar o plano técnico e usar **APENAS** as tecnologias/serviços nele declarados — sem ele, o plano fica genérico e pode inventar APIs inexistentes. O `npx @spec-wave/cli@latest init` gera um **scaffold de exemplo** que **deve ser adaptado** à stack real. Use este fluxo quando o arquivo estiver ausente ou desatualizado.
1598
+ Fonte de verdade estática da stack do sistema (RFC-002 §4). O `generate-plan` lê este arquivo para embasar o plano técnico e usar **APENAS** as tecnologias/serviços nele declarados — sem ele, o plano fica genérico e pode inventar APIs inexistentes.
1599
+
1600
+ O `npx @spec-wave/cli@latest init` gera um **scaffold em branco** — um formulário, não um exemplo — aberto pela linha `# spec-wave:template`. Use este fluxo quando o arquivo estiver ausente, **não preenchido** ou desatualizado.
1601
+
1602
+ **Não preenchido** é qualquer um destes três casos, e nos três o `doctor` reprova, o `preflight` bloqueia a rodada e o `generate-plan` gera **sem** contexto técnico estático (avisando na issue):
1603
+
1604
+ - a linha `# spec-wave:template` ainda abre o arquivo;
1605
+ - nenhum campo além de `system_info.name` tem valor (apagar só a linha do marcador não resolve);
1606
+ - o arquivo é o **exemplo dos scaffolds antigos** (até a CLI 1.7.x): `name: "Order Management System"` com `backend: "Node.js (NestJS v10)"`. Esse não tem marcador para apagar — o conteúdo é que precisa ser substituído pelo stack real.
1591
1607
 
1592
- **Como ajudar a criar (quando não existir):**
1608
+ **Como ajudar a criar (quando não existir ou não estiver preenchido):**
1593
1609
 
1594
- 1. **Confirme a ausência:** tente `Read .github/config/tech_context.yml`. Se já existir, apenas confirme com o usuário se reflete a stack atual e pule para o fim.
1610
+ 1. **Leia o que existe:** tente `Read .github/config/tech_context.yml`.
1611
+ - **Ausente ou não preenchido** (ver acima) → siga os passos abaixo.
1612
+ - **Preenchido** → confirme com o usuário se reflete a stack atual e pule para o fim.
1595
1613
  2. **Detecte a stack** lendo os arquivos do repositório (use Read; não invente):
1596
1614
  - `package.json` → backend/frontend e libs (ex.: `@nestjs/core`, `next`, `react`, `@prisma/client`, `express`).
1597
1615
  - `pom.xml` / `build.gradle` (Java), `requirements.txt` / `pyproject.toml` (Python), `go.mod` (Go).
@@ -1622,7 +1640,7 @@ Fonte de verdade estática da stack do sistema (RFC-002 §4). O `generate-plan`
1622
1640
  - "<lib interna>"
1623
1641
  ```
1624
1642
  4. **Mostre o rascunho ao usuário e peça confirmação/ajustes** antes de gravar (ele conhece serviços internos e roles que o código pode não revelar).
1625
- 5. **Grave** com Write em `.github/config/tech_context.yml`.
1643
+ 5. **Grave** com Write em `.github/config/tech_context.yml` — **sem** a linha `# spec-wave:template` do scaffold. Ela é o que marca o arquivo como não preenchido; mantê-la bloqueia o `preflight` mesmo com os campos certos.
1626
1644
  6. **Oriente a commitar e pushar** antes de seguir (o Action lê do repo). Sugira ao usuário rodar, via prefixo `!`:
1627
1645
  ```bash
1628
1646
  !git add .github/config/tech_context.yml && git commit -m "chore: tech_context.yml [spec-wave]" && git push
@@ -239,6 +239,14 @@ Mesmas flags do `issue` (exceto `--type`, fixo em `feature`). Mantido para o flu
239
239
  > - `generate-spec` / `generate-plan` → **apenas Features**. Para **Spike, RFC e Bug** a geração é **pulada** (o Action remove a label e comenta) — esses tipos não usam spec/plan.
240
240
  > - `decompose` → **Feature** (gera Stories + Tasks) e **RFC** (gera **Tasks** diretamente, sem Stories). Para outros tipos, o Action recusa.
241
241
 
242
+ ### `@spec-wave/cli retry <issue>` — dispara de novo a etapa que falhou (comando LOCAL)
243
+ | Flag | Tipo | Descrição |
244
+ |------|------|-----------|
245
+ | `--label <label>` | string | Label de gatilho a reaplicar. Obrigatória quando a issue não tem nenhuma aplicada (o comando que falhou a removeu). |
246
+ | `--force` | flag | Aceita reaplicar `spec-wave:decompose-apply` (pode duplicar issues já criadas). |
247
+
248
+ > Quando um workflow falha, o comentário ❌ na issue traz a **causa provável** (auth, max_turns, provider…), qual secret trocar e o próximo passo. Depois de corrigir, use `retry` — **não** `gh run rerun`, que reexecuta o commit ORIGINAL e ignora correções já mergeadas (um override de prompt, um workflow atualizado). O `retry` remove e reaplica a label, e o run novo usa a branch default atual. Em modo local o caminho é `run`.
249
+
242
250
  ### `@spec-wave/cli implement` — aciona o spec-kit para uma Feature, Story ou Task (comando LOCAL)
243
251
  | Flag/Arg | Tipo | Descrição |
244
252
  |----------|------|-----------|
@@ -436,11 +444,11 @@ Cada ação de IA (`spec`, `plan`, `decompose`, `critique`) pode usar um modelo
436
444
  "plan": "claude-opus-4-1",
437
445
  "critique": "claude-opus-4-1"
438
446
  },
439
- "escalationModel": "claude-opus-5",
447
+ "escalationModel": "claude-opus-5-5",
440
448
  "maxCritiqueAttempts": 3,
441
449
  "modelAliases": {
442
- "opus": "claude-opus-5",
443
- "haiku": "claude-haiku-4-5"
450
+ "opus": "claude-opus-5-5",
451
+ "haiku": "claude-haiku-5-5"
444
452
  }
445
453
  }
446
454
  }
@@ -496,11 +504,21 @@ O `validate` também recusa documento com sinal objetivo de corte (bloco de cód
496
504
 
497
505
  ## Tech Context (`.github/config/tech_context.yml`)
498
506
 
499
- Fonte de verdade estática da stack do sistema (RFC-002 §4). O `generate-plan` lê este arquivo para embasar o plano técnico e usar **APENAS** as tecnologias/serviços nele declarados — sem ele, o plano fica genérico e pode inventar APIs inexistentes. O `npx @spec-wave/cli@latest init` gera um **scaffold de exemplo** que **deve ser adaptado** à stack real. Use este fluxo quando o arquivo estiver ausente ou desatualizado.
507
+ Fonte de verdade estática da stack do sistema (RFC-002 §4). O `generate-plan` lê este arquivo para embasar o plano técnico e usar **APENAS** as tecnologias/serviços nele declarados — sem ele, o plano fica genérico e pode inventar APIs inexistentes.
508
+
509
+ O `npx @spec-wave/cli@latest init` gera um **scaffold em branco** — um formulário, não um exemplo — aberto pela linha `# spec-wave:template`. Use este fluxo quando o arquivo estiver ausente, **não preenchido** ou desatualizado.
510
+
511
+ **Não preenchido** é qualquer um destes três casos, e nos três o `doctor` reprova, o `preflight` bloqueia a rodada e o `generate-plan` gera **sem** contexto técnico estático (avisando na issue):
512
+
513
+ - a linha `# spec-wave:template` ainda abre o arquivo;
514
+ - nenhum campo além de `system_info.name` tem valor (apagar só a linha do marcador não resolve);
515
+ - o arquivo é o **exemplo dos scaffolds antigos** (até a CLI 1.7.x): `name: "Order Management System"` com `backend: "Node.js (NestJS v10)"`. Esse não tem marcador para apagar — o conteúdo é que precisa ser substituído pelo stack real.
500
516
 
501
- **Como ajudar a criar (quando não existir):**
517
+ **Como ajudar a criar (quando não existir ou não estiver preenchido):**
502
518
 
503
- 1. **Confirme a ausência:** tente `Read .github/config/tech_context.yml`. Se já existir, apenas confirme com o usuário se reflete a stack atual e pule para o fim.
519
+ 1. **Leia o que existe:** tente `Read .github/config/tech_context.yml`.
520
+ - **Ausente ou não preenchido** (ver acima) → siga os passos abaixo.
521
+ - **Preenchido** → confirme com o usuário se reflete a stack atual e pule para o fim.
504
522
  2. **Detecte a stack** lendo os arquivos do repositório (use Read; não invente):
505
523
  - `package.json` → backend/frontend e libs (ex.: `@nestjs/core`, `next`, `react`, `@prisma/client`, `express`).
506
524
  - `pom.xml` / `build.gradle` (Java), `requirements.txt` / `pyproject.toml` (Python), `go.mod` (Go).
@@ -531,7 +549,7 @@ Fonte de verdade estática da stack do sistema (RFC-002 §4). O `generate-plan`
531
549
  - "<lib interna>"
532
550
  ```
533
551
  4. **Mostre o rascunho ao usuário e peça confirmação/ajustes** antes de gravar (ele conhece serviços internos e roles que o código pode não revelar).
534
- 5. **Grave** com Write em `.github/config/tech_context.yml`.
552
+ 5. **Grave** com Write em `.github/config/tech_context.yml` — **sem** a linha `# spec-wave:template` do scaffold. Ela é o que marca o arquivo como não preenchido; mantê-la bloqueia o `preflight` mesmo com os campos certos.
535
553
  6. **Oriente a commitar e pushar** antes de seguir (o Action lê do repo). Sugira ao usuário rodar, via prefixo `!`:
536
554
  ```bash
537
555
  !git add .github/config/tech_context.yml && git commit -m "chore: tech_context.yml [spec-wave]" && git push
@@ -98,4 +98,5 @@ jobs:
98
98
  env:
99
99
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
100
100
  PROJECT_TOKEN: ${{ steps.app.outputs.token || secrets.GH_PROJECT_TOKEN }}
101
+ SPEC_WAVE_PROJECT_TOKEN_SOURCE: ${{ steps.app.outputs.token && 'GitHub App (SPEC_WAVE_APP_*)' || 'GH_PROJECT_TOKEN' }}
101
102
  GITHUB_REPOSITORY: ${{ github.repository }}
@@ -58,3 +58,14 @@ jobs:
58
58
  CLAUDE_CODE_OAUTH_TOKEN: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
59
59
  OPENROUTER_API_KEY: ${{ secrets.OPENROUTER_API_KEY }}
60
60
  GITHUB_REPOSITORY: ${{ github.repository }}
61
+
62
+ # A falha chega à issue: causa classificada (auth, max_turns, provider…),
63
+ # qual secret trocar e o próximo passo. Quando o próprio comando já
64
+ # comentou, o registro em $RUNNER_TEMP diz isso e nada se repete. Também
65
+ # remove a label de gatilho — com ela aplicada, reaplicá-la não dispara.
66
+ - name: Reporta a falha na issue
67
+ if: failure()
68
+ run: spec-wave report-failure --issue ${{ github.event.issue.number }} --label "${{ github.event.label.name }}" --step critique
69
+ env:
70
+ GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
71
+ GITHUB_REPOSITORY: ${{ github.repository }}
@@ -96,6 +96,19 @@ jobs:
96
96
  app-id: ${{ secrets.SPEC_WAVE_APP_ID }}
97
97
  private-key: ${{ secrets.SPEC_WAVE_APP_PRIVATE_KEY }}
98
98
 
99
+ # Testa as credenciais DE VERDADE antes de qualquer trabalho: lê a issue
100
+ # com o token deste passo e o Project com o PROJECT_TOKEN. O doctor só vê
101
+ # o NOME dos secrets; um PAT expirado só aparecia como 401 no meio do run,
102
+ # sem dizer qual. Falhou aqui → o passo report-failure diz qual trocar.
103
+ - name: Verifica as credenciais
104
+ run: spec-wave auth check --issue ${{ github.event.issue.number }}
105
+ env:
106
+ GITHUB_TOKEN: ${{ steps.app.outputs.token || secrets.GH_PROJECT_TOKEN || secrets.GITHUB_TOKEN }}
107
+ SPEC_WAVE_TOKEN_SOURCE: ${{ steps.app.outputs.token && 'GitHub App (SPEC_WAVE_APP_*)' || secrets.GH_PROJECT_TOKEN && 'GH_PROJECT_TOKEN' || 'GITHUB_TOKEN' }}
108
+ PROJECT_TOKEN: ${{ steps.app.outputs.token || secrets.GH_PROJECT_TOKEN }}
109
+ SPEC_WAVE_PROJECT_TOKEN_SOURCE: ${{ steps.app.outputs.token && 'GitHub App (SPEC_WAVE_APP_*)' || 'GH_PROJECT_TOKEN' }}
110
+ GITHUB_REPOSITORY: ${{ github.repository }}
111
+
99
112
  # Multi-repo (RFC-005 §7.2): clona em .spec-wave/repos/<slug>/ os repos
100
113
  # de código que a issue declara (labels repo:<slug>; a Feature agrega as
101
114
  # Stories), para o modelo ler CÓDIGO e não só o markdown do hub. Só no
@@ -107,6 +120,7 @@ jobs:
107
120
  run: spec-wave workspace prepare --issue ${{ github.event.issue.number }}
108
121
  env:
109
122
  GITHUB_TOKEN: ${{ steps.app.outputs.token || secrets.GH_PROJECT_TOKEN || secrets.GITHUB_TOKEN }}
123
+ SPEC_WAVE_TOKEN_SOURCE: ${{ steps.app.outputs.token && 'GitHub App (SPEC_WAVE_APP_*)' || secrets.GH_PROJECT_TOKEN && 'GH_PROJECT_TOKEN' || 'GITHUB_TOKEN' }}
110
124
  GITHUB_REPOSITORY: ${{ github.repository }}
111
125
 
112
126
  - name: Decompose into Stories and Tasks
@@ -117,8 +131,21 @@ jobs:
117
131
  env:
118
132
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
119
133
  GH_PR_TOKEN: ${{ steps.app.outputs.token || secrets.GH_PR_TOKEN }}
134
+ SPEC_WAVE_PR_TOKEN_SOURCE: ${{ steps.app.outputs.token && 'GitHub App (SPEC_WAVE_APP_*)' || 'GH_PR_TOKEN' }}
120
135
  PROJECT_TOKEN: ${{ steps.app.outputs.token || secrets.GH_PROJECT_TOKEN }}
136
+ SPEC_WAVE_PROJECT_TOKEN_SOURCE: ${{ steps.app.outputs.token && 'GitHub App (SPEC_WAVE_APP_*)' || 'GH_PROJECT_TOKEN' }}
121
137
  ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
122
138
  CLAUDE_CODE_OAUTH_TOKEN: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
123
139
  OPENROUTER_API_KEY: ${{ secrets.OPENROUTER_API_KEY }}
124
140
  GITHUB_REPOSITORY: ${{ github.repository }}
141
+
142
+ # A falha chega à issue: causa classificada (auth, max_turns, provider…),
143
+ # qual secret trocar e o próximo passo. Quando o próprio comando já
144
+ # comentou, o registro em $RUNNER_TEMP diz isso e nada se repete. Também
145
+ # remove a label de gatilho — com ela aplicada, reaplicá-la não dispara.
146
+ - name: Reporta a falha na issue
147
+ if: failure()
148
+ run: spec-wave report-failure --issue ${{ github.event.issue.number }} --label "${{ github.event.label.name }}" --step decompose
149
+ env:
150
+ GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
151
+ GITHUB_REPOSITORY: ${{ github.repository }}
@@ -80,6 +80,19 @@ jobs:
80
80
  app-id: ${{ secrets.SPEC_WAVE_APP_ID }}
81
81
  private-key: ${{ secrets.SPEC_WAVE_APP_PRIVATE_KEY }}
82
82
 
83
+ # Testa as credenciais DE VERDADE antes de qualquer trabalho: lê a issue
84
+ # com o token deste passo e o Project com o PROJECT_TOKEN. O doctor só vê
85
+ # o NOME dos secrets; um PAT expirado só aparecia como 401 no meio do run,
86
+ # sem dizer qual. Falhou aqui → o passo report-failure diz qual trocar.
87
+ - name: Verifica as credenciais
88
+ run: spec-wave auth check --issue ${{ github.event.issue.number }}
89
+ env:
90
+ GITHUB_TOKEN: ${{ steps.app.outputs.token || secrets.GH_PROJECT_TOKEN || secrets.GITHUB_TOKEN }}
91
+ SPEC_WAVE_TOKEN_SOURCE: ${{ steps.app.outputs.token && 'GitHub App (SPEC_WAVE_APP_*)' || secrets.GH_PROJECT_TOKEN && 'GH_PROJECT_TOKEN' || 'GITHUB_TOKEN' }}
92
+ PROJECT_TOKEN: ${{ steps.app.outputs.token || secrets.GH_PROJECT_TOKEN }}
93
+ SPEC_WAVE_PROJECT_TOKEN_SOURCE: ${{ steps.app.outputs.token && 'GitHub App (SPEC_WAVE_APP_*)' || 'GH_PROJECT_TOKEN' }}
94
+ GITHUB_REPOSITORY: ${{ github.repository }}
95
+
83
96
  # Multi-repo (RFC-005 §7.2): clona em .spec-wave/repos/<slug>/ os repos
84
97
  # de código que a issue declara (labels repo:<slug>), para o modelo ler
85
98
  # CÓDIGO e não só o markdown do hub. Sem repo declarado só avisa. O
@@ -89,6 +102,7 @@ jobs:
89
102
  run: spec-wave workspace prepare --issue ${{ github.event.issue.number }}
90
103
  env:
91
104
  GITHUB_TOKEN: ${{ steps.app.outputs.token || secrets.GH_PROJECT_TOKEN || secrets.GITHUB_TOKEN }}
105
+ SPEC_WAVE_TOKEN_SOURCE: ${{ steps.app.outputs.token && 'GitHub App (SPEC_WAVE_APP_*)' || secrets.GH_PROJECT_TOKEN && 'GH_PROJECT_TOKEN' || 'GITHUB_TOKEN' }}
92
106
  GITHUB_REPOSITORY: ${{ github.repository }}
93
107
 
94
108
  - name: Generate bug.md
@@ -96,7 +110,19 @@ jobs:
96
110
  env:
97
111
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
98
112
  GH_PR_TOKEN: ${{ steps.app.outputs.token || secrets.GH_PR_TOKEN }}
113
+ SPEC_WAVE_PR_TOKEN_SOURCE: ${{ steps.app.outputs.token && 'GitHub App (SPEC_WAVE_APP_*)' || 'GH_PR_TOKEN' }}
99
114
  ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
100
115
  CLAUDE_CODE_OAUTH_TOKEN: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
101
116
  OPENROUTER_API_KEY: ${{ secrets.OPENROUTER_API_KEY }}
102
117
  GITHUB_REPOSITORY: ${{ github.repository }}
118
+
119
+ # A falha chega à issue: causa classificada (auth, max_turns, provider…),
120
+ # qual secret trocar e o próximo passo. Quando o próprio comando já
121
+ # comentou, o registro em $RUNNER_TEMP diz isso e nada se repete. Também
122
+ # remove a label de gatilho — com ela aplicada, reaplicá-la não dispara.
123
+ - name: Reporta a falha na issue
124
+ if: failure()
125
+ run: spec-wave report-failure --issue ${{ github.event.issue.number }} --label "${{ github.event.label.name }}" --step generate-bug
126
+ env:
127
+ GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
128
+ GITHUB_REPOSITORY: ${{ github.repository }}
@@ -90,6 +90,19 @@ jobs:
90
90
  app-id: ${{ secrets.SPEC_WAVE_APP_ID }}
91
91
  private-key: ${{ secrets.SPEC_WAVE_APP_PRIVATE_KEY }}
92
92
 
93
+ # Testa as credenciais DE VERDADE antes de qualquer trabalho: lê a issue
94
+ # com o token deste passo e o Project com o PROJECT_TOKEN. O doctor só vê
95
+ # o NOME dos secrets; um PAT expirado só aparecia como 401 no meio do run,
96
+ # sem dizer qual. Falhou aqui → o passo report-failure diz qual trocar.
97
+ - name: Verifica as credenciais
98
+ run: spec-wave auth check --issue ${{ github.event.issue.number }}
99
+ env:
100
+ GITHUB_TOKEN: ${{ steps.app.outputs.token || secrets.GH_PROJECT_TOKEN || secrets.GITHUB_TOKEN }}
101
+ SPEC_WAVE_TOKEN_SOURCE: ${{ steps.app.outputs.token && 'GitHub App (SPEC_WAVE_APP_*)' || secrets.GH_PROJECT_TOKEN && 'GH_PROJECT_TOKEN' || 'GITHUB_TOKEN' }}
102
+ PROJECT_TOKEN: ${{ steps.app.outputs.token || secrets.GH_PROJECT_TOKEN }}
103
+ SPEC_WAVE_PROJECT_TOKEN_SOURCE: ${{ steps.app.outputs.token && 'GitHub App (SPEC_WAVE_APP_*)' || 'GH_PROJECT_TOKEN' }}
104
+ GITHUB_REPOSITORY: ${{ github.repository }}
105
+
93
106
  # Multi-repo (RFC-005 §7.2): clona em .spec-wave/repos/<slug>/ os repos
94
107
  # de código que a issue declara (labels repo:<slug>; a Feature agrega as
95
108
  # Stories), para o modelo ler CÓDIGO e não só o markdown do hub. Sem repo
@@ -99,6 +112,7 @@ jobs:
99
112
  run: spec-wave workspace prepare --issue ${{ github.event.issue.number }}
100
113
  env:
101
114
  GITHUB_TOKEN: ${{ steps.app.outputs.token || secrets.GH_PROJECT_TOKEN || secrets.GITHUB_TOKEN }}
115
+ SPEC_WAVE_TOKEN_SOURCE: ${{ steps.app.outputs.token && 'GitHub App (SPEC_WAVE_APP_*)' || secrets.GH_PROJECT_TOKEN && 'GH_PROJECT_TOKEN' || 'GITHUB_TOKEN' }}
102
116
  GITHUB_REPOSITORY: ${{ github.repository }}
103
117
 
104
118
  - name: Generate plan.md
@@ -106,7 +120,19 @@ jobs:
106
120
  env:
107
121
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
108
122
  GH_PR_TOKEN: ${{ steps.app.outputs.token || secrets.GH_PR_TOKEN }}
123
+ SPEC_WAVE_PR_TOKEN_SOURCE: ${{ steps.app.outputs.token && 'GitHub App (SPEC_WAVE_APP_*)' || 'GH_PR_TOKEN' }}
109
124
  ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
110
125
  CLAUDE_CODE_OAUTH_TOKEN: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
111
126
  OPENROUTER_API_KEY: ${{ secrets.OPENROUTER_API_KEY }}
112
127
  GITHUB_REPOSITORY: ${{ github.repository }}
128
+
129
+ # A falha chega à issue: causa classificada (auth, max_turns, provider…),
130
+ # qual secret trocar e o próximo passo. Quando o próprio comando já
131
+ # comentou, o registro em $RUNNER_TEMP diz isso e nada se repete. Também
132
+ # remove a label de gatilho — com ela aplicada, reaplicá-la não dispara.
133
+ - name: Reporta a falha na issue
134
+ if: failure()
135
+ run: spec-wave report-failure --issue ${{ github.event.issue.number }} --label "${{ github.event.label.name }}" --step generate-plan
136
+ env:
137
+ GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
138
+ GITHUB_REPOSITORY: ${{ github.repository }}
@@ -67,6 +67,19 @@ jobs:
67
67
  app-id: ${{ secrets.SPEC_WAVE_APP_ID }}
68
68
  private-key: ${{ secrets.SPEC_WAVE_APP_PRIVATE_KEY }}
69
69
 
70
+ # Testa as credenciais DE VERDADE antes de qualquer trabalho: lê a issue
71
+ # com o token deste passo e o Project com o PROJECT_TOKEN. O doctor só vê
72
+ # o NOME dos secrets; um PAT expirado só aparecia como 401 no meio do run,
73
+ # sem dizer qual. Falhou aqui → o passo report-failure diz qual trocar.
74
+ - name: Verifica as credenciais
75
+ run: spec-wave auth check --issue ${{ github.event.issue.number }}
76
+ env:
77
+ GITHUB_TOKEN: ${{ steps.app.outputs.token || secrets.GH_PROJECT_TOKEN || secrets.GITHUB_TOKEN }}
78
+ SPEC_WAVE_TOKEN_SOURCE: ${{ steps.app.outputs.token && 'GitHub App (SPEC_WAVE_APP_*)' || secrets.GH_PROJECT_TOKEN && 'GH_PROJECT_TOKEN' || 'GITHUB_TOKEN' }}
79
+ PROJECT_TOKEN: ${{ steps.app.outputs.token || secrets.GH_PROJECT_TOKEN }}
80
+ SPEC_WAVE_PROJECT_TOKEN_SOURCE: ${{ steps.app.outputs.token && 'GitHub App (SPEC_WAVE_APP_*)' || 'GH_PROJECT_TOKEN' }}
81
+ GITHUB_REPOSITORY: ${{ github.repository }}
82
+
70
83
  # Multi-repo (RFC-005 §7.2): clona em .spec-wave/repos/<slug>/ os repos
71
84
  # de código que a issue declara (labels repo:<slug>; a Feature agrega as
72
85
  # Stories), para o modelo ler CÓDIGO e não só o markdown do hub. Sem repo
@@ -76,6 +89,7 @@ jobs:
76
89
  run: spec-wave workspace prepare --issue ${{ github.event.issue.number }}
77
90
  env:
78
91
  GITHUB_TOKEN: ${{ steps.app.outputs.token || secrets.GH_PROJECT_TOKEN || secrets.GITHUB_TOKEN }}
92
+ SPEC_WAVE_TOKEN_SOURCE: ${{ steps.app.outputs.token && 'GitHub App (SPEC_WAVE_APP_*)' || secrets.GH_PROJECT_TOKEN && 'GH_PROJECT_TOKEN' || 'GITHUB_TOKEN' }}
79
93
  GITHUB_REPOSITORY: ${{ github.repository }}
80
94
 
81
95
  - name: Generate QA plan
@@ -83,8 +97,21 @@ jobs:
83
97
  env:
84
98
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
85
99
  GH_PR_TOKEN: ${{ steps.app.outputs.token || secrets.GH_PR_TOKEN }}
100
+ SPEC_WAVE_PR_TOKEN_SOURCE: ${{ steps.app.outputs.token && 'GitHub App (SPEC_WAVE_APP_*)' || 'GH_PR_TOKEN' }}
86
101
  PROJECT_TOKEN: ${{ steps.app.outputs.token || secrets.GH_PROJECT_TOKEN }}
102
+ SPEC_WAVE_PROJECT_TOKEN_SOURCE: ${{ steps.app.outputs.token && 'GitHub App (SPEC_WAVE_APP_*)' || 'GH_PROJECT_TOKEN' }}
87
103
  ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
88
104
  CLAUDE_CODE_OAUTH_TOKEN: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
89
105
  OPENROUTER_API_KEY: ${{ secrets.OPENROUTER_API_KEY }}
90
106
  GITHUB_REPOSITORY: ${{ github.repository }}
107
+
108
+ # A falha chega à issue: causa classificada (auth, max_turns, provider…),
109
+ # qual secret trocar e o próximo passo. Quando o próprio comando já
110
+ # comentou, o registro em $RUNNER_TEMP diz isso e nada se repete. Também
111
+ # remove a label de gatilho — com ela aplicada, reaplicá-la não dispara.
112
+ - name: Reporta a falha na issue
113
+ if: failure()
114
+ run: spec-wave report-failure --issue ${{ github.event.issue.number }} --label "${{ github.event.label.name }}" --step generate-qa-plan
115
+ env:
116
+ GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
117
+ GITHUB_REPOSITORY: ${{ github.repository }}
@@ -90,6 +90,19 @@ jobs:
90
90
  app-id: ${{ secrets.SPEC_WAVE_APP_ID }}
91
91
  private-key: ${{ secrets.SPEC_WAVE_APP_PRIVATE_KEY }}
92
92
 
93
+ # Testa as credenciais DE VERDADE antes de qualquer trabalho: lê a issue
94
+ # com o token deste passo e o Project com o PROJECT_TOKEN. O doctor só vê
95
+ # o NOME dos secrets; um PAT expirado só aparecia como 401 no meio do run,
96
+ # sem dizer qual. Falhou aqui → o passo report-failure diz qual trocar.
97
+ - name: Verifica as credenciais
98
+ run: spec-wave auth check --issue ${{ github.event.issue.number }}
99
+ env:
100
+ GITHUB_TOKEN: ${{ steps.app.outputs.token || secrets.GH_PROJECT_TOKEN || secrets.GITHUB_TOKEN }}
101
+ SPEC_WAVE_TOKEN_SOURCE: ${{ steps.app.outputs.token && 'GitHub App (SPEC_WAVE_APP_*)' || secrets.GH_PROJECT_TOKEN && 'GH_PROJECT_TOKEN' || 'GITHUB_TOKEN' }}
102
+ PROJECT_TOKEN: ${{ steps.app.outputs.token || secrets.GH_PROJECT_TOKEN }}
103
+ SPEC_WAVE_PROJECT_TOKEN_SOURCE: ${{ steps.app.outputs.token && 'GitHub App (SPEC_WAVE_APP_*)' || 'GH_PROJECT_TOKEN' }}
104
+ GITHUB_REPOSITORY: ${{ github.repository }}
105
+
93
106
  # Multi-repo (RFC-005 §7.2): clona em .spec-wave/repos/<slug>/ os repos
94
107
  # de código que a issue declara (labels repo:<slug>; a Feature agrega as
95
108
  # Stories), para o modelo ler CÓDIGO e não só o markdown do hub. Sem repo
@@ -99,6 +112,7 @@ jobs:
99
112
  run: spec-wave workspace prepare --issue ${{ github.event.issue.number }}
100
113
  env:
101
114
  GITHUB_TOKEN: ${{ steps.app.outputs.token || secrets.GH_PROJECT_TOKEN || secrets.GITHUB_TOKEN }}
115
+ SPEC_WAVE_TOKEN_SOURCE: ${{ steps.app.outputs.token && 'GitHub App (SPEC_WAVE_APP_*)' || secrets.GH_PROJECT_TOKEN && 'GH_PROJECT_TOKEN' || 'GITHUB_TOKEN' }}
102
116
  GITHUB_REPOSITORY: ${{ github.repository }}
103
117
 
104
118
  - name: Generate spec.md
@@ -106,7 +120,19 @@ jobs:
106
120
  env:
107
121
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
108
122
  GH_PR_TOKEN: ${{ steps.app.outputs.token || secrets.GH_PR_TOKEN }}
123
+ SPEC_WAVE_PR_TOKEN_SOURCE: ${{ steps.app.outputs.token && 'GitHub App (SPEC_WAVE_APP_*)' || 'GH_PR_TOKEN' }}
109
124
  ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
110
125
  CLAUDE_CODE_OAUTH_TOKEN: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
111
126
  OPENROUTER_API_KEY: ${{ secrets.OPENROUTER_API_KEY }}
112
127
  GITHUB_REPOSITORY: ${{ github.repository }}
128
+
129
+ # A falha chega à issue: causa classificada (auth, max_turns, provider…),
130
+ # qual secret trocar e o próximo passo. Quando o próprio comando já
131
+ # comentou, o registro em $RUNNER_TEMP diz isso e nada se repete. Também
132
+ # remove a label de gatilho — com ela aplicada, reaplicá-la não dispara.
133
+ - name: Reporta a falha na issue
134
+ if: failure()
135
+ run: spec-wave report-failure --issue ${{ github.event.issue.number }} --label "${{ github.event.label.name }}" --step generate-spec
136
+ env:
137
+ GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
138
+ GITHUB_REPOSITORY: ${{ github.repository }}
@@ -68,6 +68,7 @@ jobs:
68
68
  --resolve-only
69
69
  env:
70
70
  GITHUB_TOKEN: ${{ steps.app.outputs.token || secrets.GH_PROJECT_TOKEN || secrets.GITHUB_TOKEN }}
71
+ SPEC_WAVE_TOKEN_SOURCE: ${{ steps.app.outputs.token && 'GitHub App (SPEC_WAVE_APP_*)' || secrets.GH_PROJECT_TOKEN && 'GH_PROJECT_TOKEN' || 'GITHUB_TOKEN' }}
71
72
  GITHUB_REPOSITORY: ${{ github.repository }}
72
73
 
73
74
  move:
@@ -110,7 +111,9 @@ jobs:
110
111
  --pr-repo ${{ github.event.client_payload.pr_repo }}
111
112
  env:
112
113
  GITHUB_TOKEN: ${{ steps.app.outputs.token || secrets.GH_PROJECT_TOKEN || secrets.GITHUB_TOKEN }}
114
+ SPEC_WAVE_TOKEN_SOURCE: ${{ steps.app.outputs.token && 'GitHub App (SPEC_WAVE_APP_*)' || secrets.GH_PROJECT_TOKEN && 'GH_PROJECT_TOKEN' || 'GITHUB_TOKEN' }}
113
115
  PROJECT_TOKEN: ${{ steps.app.outputs.token || secrets.GH_PROJECT_TOKEN }}
116
+ SPEC_WAVE_PROJECT_TOKEN_SOURCE: ${{ steps.app.outputs.token && 'GitHub App (SPEC_WAVE_APP_*)' || 'GH_PROJECT_TOKEN' }}
114
117
  GITHUB_REPOSITORY: ${{ github.repository }}
115
118
 
116
119
  qa:
@@ -144,5 +147,7 @@ jobs:
144
147
  --pr-repo ${{ github.event.client_payload.pr_repo }}
145
148
  env:
146
149
  GITHUB_TOKEN: ${{ steps.app.outputs.token || secrets.GH_PROJECT_TOKEN || secrets.GITHUB_TOKEN }}
150
+ SPEC_WAVE_TOKEN_SOURCE: ${{ steps.app.outputs.token && 'GitHub App (SPEC_WAVE_APP_*)' || secrets.GH_PROJECT_TOKEN && 'GH_PROJECT_TOKEN' || 'GITHUB_TOKEN' }}
147
151
  PROJECT_TOKEN: ${{ steps.app.outputs.token || secrets.GH_PROJECT_TOKEN }}
152
+ SPEC_WAVE_PROJECT_TOKEN_SOURCE: ${{ steps.app.outputs.token && 'GitHub App (SPEC_WAVE_APP_*)' || 'GH_PROJECT_TOKEN' }}
148
153
  GITHUB_REPOSITORY: ${{ github.repository }}
@@ -73,4 +73,5 @@ jobs:
73
73
  env:
74
74
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
75
75
  PROJECT_TOKEN: ${{ steps.app.outputs.token || secrets.GH_PROJECT_TOKEN }}
76
+ SPEC_WAVE_PROJECT_TOKEN_SOURCE: ${{ steps.app.outputs.token && 'GitHub App (SPEC_WAVE_APP_*)' || 'GH_PROJECT_TOKEN' }}
76
77
  GITHUB_REPOSITORY: ${{ github.repository }}
@@ -52,3 +52,14 @@ jobs:
52
52
  env:
53
53
  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
54
54
  GITHUB_REPOSITORY: ${{ github.repository }}
55
+
56
+ # A falha chega à issue: causa classificada (auth, max_turns, provider…),
57
+ # qual secret trocar e o próximo passo. Quando o próprio comando já
58
+ # comentou, o registro em $RUNNER_TEMP diz isso e nada se repete. Também
59
+ # remove a label de gatilho — com ela aplicada, reaplicá-la não dispara.
60
+ - name: Reporta a falha na issue
61
+ if: failure()
62
+ run: spec-wave report-failure --issue ${{ github.event.issue.number }} --label "${{ github.event.label.name }}" --step validate
63
+ env:
64
+ GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
65
+ GITHUB_REPOSITORY: ${{ github.repository }}