@spec-wave/cli 1.7.4 → 1.7.6

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.7.4",
3
+ "version": "1.7.6",
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": {
@@ -482,7 +482,13 @@ async function draftDecomposition(ctx) {
482
482
  `plano e reaplique \`${LABEL_DECOMPOSE}\`. Na spec-wave-ui: "Analisar pendências" na ` +
483
483
  'Specification do PM e o agente da Technical Review para o plano.',
484
484
  }).catch(() => {});
485
- throw new DecomposeBlockedError(pendencias.message);
485
+ // Desfecho esperado, não falha: devolve em vez de lançar. Lançar terminava
486
+ // a Action em vermelho, e a spec-wave-ui lia a run quebrada como "falhou
487
+ // na execução" (spec-wave-ui#382) — mandando a pessoa ler log quando o
488
+ // que falta é decisão do PO, já listada no comentário. O `run` para a
489
+ // cadeia no `ok: false`, como faz com a reprova do validate.
490
+ console.log(pendencias.message);
491
+ return { ok: false, blocked: 'open-todos', message: pendencias.message };
486
492
  }
487
493
  console.log(`Gerando rascunho de decomposição para ${type}: ${issue.title}`);
488
494
  const userContent = type === 'RFC'
@@ -6,6 +6,7 @@ import {
6
6
  REQUIRED_PLAN_SECTIONS, REQUIRED_SPEC_SECTIONS, REQUIRED_BUG_SECTIONS, labelNames,
7
7
  } from '../config.mjs';
8
8
  import { findIncompleteDocSigns } from '../lib/doc-completeness.mjs';
9
+ import { findOpenTodos } from '../lib/open-todos.mjs';
9
10
  import { bugDocPaths, describeMissingSections } from '../lib/bug-doc.mjs';
10
11
  import { detectIssueType } from '../lib/issue-type.mjs';
11
12
  import { resolveHubContext } from '../lib/project-root.mjs';
@@ -151,6 +152,33 @@ export function renderMissingSection(doc, { section, found }) {
151
152
  : base;
152
153
  }
153
154
 
155
+ /**
156
+ * Erro de validação por pendências [TODO] abertas (função PURA — testável).
157
+ *
158
+ * O decompose recusa decompor por cima de `[TODO: requer esclarecimento do PO …]`
159
+ * (ver lib/open-todos.mjs). Sem esta checagem o validate aprovava o par e dizia
160
+ * "pronta para a decomposição", e o passo seguinte parava — foi o caso da
161
+ * spec-wave-ui#382, aprovada com 6 pendências na spec. As duas pontas usam o
162
+ * MESMO detector, então "aprovado aqui" significa "o decompose não barra por isso".
163
+ *
164
+ * @param {string} doc nome curto do documento (`spec.md`)
165
+ * @param {string} pathRel caminho mostrado em cada pendência
166
+ * @param {string|null} content
167
+ * @param {{ max?: number }} [opts] quantas pendências listar
168
+ * @returns {string|null} null = nada pendente
169
+ */
170
+ export function describeOpenTodos(doc, pathRel, content, { max = 10 } = {}) {
171
+ const found = findOpenTodos(content);
172
+ if (found.length === 0) return null;
173
+ const linhas = found.slice(0, max).map(t => ` - \`${pathRel}:${t.line}\` — ${t.excerpt}`);
174
+ if (found.length > max) linhas.push(` - … e mais ${found.length - max}.`);
175
+ return (
176
+ `❌ \`${doc}\` tem ${found.length} pendência(s) [TODO] aberta(s) — decida e reescreva ` +
177
+ 'cada trecho sem a marcação (o decompose recusa decompor por cima delas):\n' +
178
+ linhas.join('\n')
179
+ );
180
+ }
181
+
154
182
  /**
155
183
  * Valida os documentos de uma issue.
156
184
  *
@@ -241,6 +269,8 @@ export async function validate({ issueNumber, deps = {} }) {
241
269
  for (const problem of findIncompleteDocSigns(planContent)) {
242
270
  errors.push(`❌ \`plan.md\` parece incompleto: ${problem}`);
243
271
  }
272
+ const pendencias = describeOpenTodos('plan.md', planRel, planContent);
273
+ if (pendencias) errors.push(pendencias);
244
274
  }
245
275
 
246
276
  // Check spec.md
@@ -257,6 +287,8 @@ export async function validate({ issueNumber, deps = {} }) {
257
287
  for (const problem of findIncompleteDocSigns(specContent)) {
258
288
  errors.push(`❌ \`spec.md\` parece incompleto: ${problem}`);
259
289
  }
290
+ const pendencias = describeOpenTodos('spec.md', specRel, specContent);
291
+ if (pendencias) errors.push(pendencias);
260
292
  // Aviso, NUNCA erro (item 3e do rfc/plano-hardening-agentes-2026-08.md):
261
293
  // "Dependências" não está em REQUIRED_SPEC_SECTIONS de propósito — exigi-la
262
294
  // quebraria specs antigas num comando que é gatilho de Action. O parser
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "spec-wave",
3
3
  "displayName": "Spec Wave",
4
- "version": "1.7.4",
4
+ "version": "1.7.6",
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",
@@ -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: >
@@ -98,6 +101,7 @@ jobs:
98
101
  with:
99
102
  app-id: ${{ secrets.SPEC_WAVE_APP_ID }}
100
103
  private-key: ${{ secrets.SPEC_WAVE_APP_PRIVATE_KEY }}
104
+ owner: ${{ github.repository_owner }}
101
105
 
102
106
  - name: Move Feature to Code Review
103
107
  run: >
@@ -131,6 +135,7 @@ jobs:
131
135
  with:
132
136
  app-id: ${{ secrets.SPEC_WAVE_APP_ID }}
133
137
  private-key: ${{ secrets.SPEC_WAVE_APP_PRIVATE_KEY }}
138
+ owner: ${{ github.repository_owner }}
134
139
 
135
140
  - name: Move Feature to QA
136
141
  run: >