@spec-wave/cli 1.7.5 → 1.8.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 (52) 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 +93 -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/init.mjs +2 -2
  16. package/src/commands/preflight.mjs +38 -2
  17. package/src/commands/relink.mjs +105 -0
  18. package/src/commands/report-failure.mjs +99 -0
  19. package/src/commands/retry.mjs +91 -0
  20. package/src/commands/update.mjs +70 -0
  21. package/src/config.mjs +8 -8
  22. package/src/lib/cited-paths.mjs +89 -0
  23. package/src/lib/claude.mjs +4 -2
  24. package/src/lib/cli-line.mjs +153 -0
  25. package/src/lib/cli-ref.mjs +53 -2
  26. package/src/lib/failure-report.mjs +319 -0
  27. package/src/lib/repo-identity.mjs +55 -0
  28. package/src/lib/spec-index.mjs +114 -0
  29. package/src/lib/tech-context.mjs +144 -5
  30. package/src/plugin/.claude-plugin/plugin.json +1 -1
  31. package/src/plugin/skills/plan/SKILL.md +1 -1
  32. package/src/plugin/skills/plan/reference/tech-context.md +12 -4
  33. package/src/plugin/skills/setup/SKILL.md +1 -1
  34. package/src/plugin/skills/spec/model-prompt.md +8 -1
  35. package/src/plugins/scm-github/index.mjs +8 -1
  36. package/src/plugins/tracker-github-projects/index.mjs +11 -4
  37. package/src/ports/tracker.mjs +2 -1
  38. package/src/setup/labels.mjs +5 -3
  39. package/src/setup/project.mjs +5 -3
  40. package/src/templates/config/tech_context.yml +29 -25
  41. package/src/templates/skill/SKILL.md +27 -9
  42. package/src/templates/skill/core.md +25 -7
  43. package/src/templates/workflows/code-review.yml +1 -0
  44. package/src/templates/workflows/critique.yml +11 -0
  45. package/src/templates/workflows/decompose.yml +27 -0
  46. package/src/templates/workflows/generate-bug.yml +26 -0
  47. package/src/templates/workflows/generate-plan.yml +26 -0
  48. package/src/templates/workflows/generate-qa-plan.yml +27 -0
  49. package/src/templates/workflows/generate-spec.yml +26 -0
  50. package/src/templates/workflows/pr-events.yml +11 -1
  51. package/src/templates/workflows/qa.yml +1 -0
  52. package/src/templates/workflows/validate.yml +11 -0
@@ -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 }}
@@ -12,7 +12,9 @@ name: PR Events
12
12
  # GITHUB_TOKEN — o da GitHub App da organização (SPEC_WAVE_APP_ID +
13
13
  # SPEC_WAVE_APP_PRIVATE_KEY), quando configurada, senão o GH_PROJECT_TOKEN
14
14
  # (PAT com repo + project). Sem nenhum dos dois, cai no GITHUB_TOKEN, que
15
- # ainda lê PR de repo público mas não comenta.
15
+ # ainda lê PR de repo público mas não comenta. O token da App sai com
16
+ # `owner:` — sem ele, create-github-app-token limita o token a ESTE repo e a
17
+ # leitura do PR de repo privado responde 404.
16
18
  on:
17
19
  repository_dispatch:
18
20
  types: [spec-wave-pr]
@@ -56,6 +58,7 @@ jobs:
56
58
  with:
57
59
  app-id: ${{ secrets.SPEC_WAVE_APP_ID }}
58
60
  private-key: ${{ secrets.SPEC_WAVE_APP_PRIVATE_KEY }}
61
+ owner: ${{ github.repository_owner }}
59
62
 
60
63
  - id: resolve
61
64
  run: >
@@ -65,6 +68,7 @@ jobs:
65
68
  --resolve-only
66
69
  env:
67
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' }}
68
72
  GITHUB_REPOSITORY: ${{ github.repository }}
69
73
 
70
74
  move:
@@ -98,6 +102,7 @@ jobs:
98
102
  with:
99
103
  app-id: ${{ secrets.SPEC_WAVE_APP_ID }}
100
104
  private-key: ${{ secrets.SPEC_WAVE_APP_PRIVATE_KEY }}
105
+ owner: ${{ github.repository_owner }}
101
106
 
102
107
  - name: Move Feature to Code Review
103
108
  run: >
@@ -106,7 +111,9 @@ jobs:
106
111
  --pr-repo ${{ github.event.client_payload.pr_repo }}
107
112
  env:
108
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' }}
109
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' }}
110
117
  GITHUB_REPOSITORY: ${{ github.repository }}
111
118
 
112
119
  qa:
@@ -131,6 +138,7 @@ jobs:
131
138
  with:
132
139
  app-id: ${{ secrets.SPEC_WAVE_APP_ID }}
133
140
  private-key: ${{ secrets.SPEC_WAVE_APP_PRIVATE_KEY }}
141
+ owner: ${{ github.repository_owner }}
134
142
 
135
143
  - name: Move Feature to QA
136
144
  run: >
@@ -139,5 +147,7 @@ jobs:
139
147
  --pr-repo ${{ github.event.client_payload.pr_repo }}
140
148
  env:
141
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' }}
142
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' }}
143
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 }}