@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
|
@@ -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
|
-
|
|
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
|
+
"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: >
|