@spec-wave/cli 1.0.2 → 1.0.4
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 +1 -1
- package/src/api/auth.mjs +29 -1
- package/src/commands/code-review.mjs +3 -1
- package/src/commands/decompose.mjs +1 -1
- package/src/commands/doctor.mjs +54 -20
- package/src/commands/generate-bug.mjs +1 -0
- package/src/commands/generate-plan.mjs +1 -0
- package/src/commands/generate-qa-plan.mjs +1 -0
- package/src/commands/generate-spec.mjs +1 -0
- package/src/commands/implement.mjs +31 -3
- package/src/commands/init.mjs +4 -1
- package/src/commands/merge.mjs +157 -59
- package/src/commands/run.mjs +16 -0
- package/src/commands/workspace.mjs +5 -1
- package/src/lib/claude.mjs +14 -0
- package/src/lib/pr-ready.mjs +43 -21
- package/src/lib/workspace.mjs +64 -0
- package/src/plugin/.claude-plugin/plugin.json +1 -1
- package/src/plugin/skills/bug/model-prompt.md +2 -0
- package/src/plugin/skills/decompose/model-prompt.feature.md +2 -0
- package/src/plugin/skills/decompose/model-prompt.rfc.md +2 -0
- package/src/plugin/skills/merge/SKILL.md +1 -0
- package/src/plugin/skills/plan/model-prompt.md +2 -0
- package/src/plugin/skills/qa/model-prompt.md +2 -0
- package/src/plugin/skills/setup/SKILL.md +9 -0
- package/src/plugin/skills/spec/model-prompt.md +2 -0
- package/src/templates/skill/SKILL.md +9 -0
- package/src/templates/workflows/code/code-review.yml +25 -7
- package/src/templates/workflows/code/qa.yml +24 -6
- package/src/templates/workflows/code-review.yml +16 -1
- package/src/templates/workflows/decompose.yml +30 -2
- package/src/templates/workflows/generate-bug.yml +27 -1
- package/src/templates/workflows/generate-plan.yml +27 -1
- package/src/templates/workflows/generate-qa-plan.yml +28 -2
- package/src/templates/workflows/generate-spec.yml +27 -1
- package/src/templates/workflows/pr-events.yml +35 -8
- package/src/templates/workflows/qa.yml +15 -1
package/src/commands/merge.mjs
CHANGED
|
@@ -29,7 +29,8 @@ import { missingTrailers } from '../lib/commit-trailers.mjs';
|
|
|
29
29
|
import { detectIssueType } from '../lib/issue-type.mjs';
|
|
30
30
|
import { orderStories } from '../lib/dependencies.mjs';
|
|
31
31
|
import { resolveHubContext, loadConfig } from '../lib/project-root.mjs';
|
|
32
|
-
import { extractIssueRefs, hubIssueNumbers, resolveLinkMode } from '../lib/pr-link.mjs';
|
|
32
|
+
import { extractIssueRefs, hubIssueNumbers, resolveLinkMode, sameRepo } from '../lib/pr-link.mjs';
|
|
33
|
+
import { codeReposForItems } from '../lib/workspace.mjs';
|
|
33
34
|
import { loadFeatureStories } from '../lib/story-graph.mjs';
|
|
34
35
|
import { resolveCacheTtl, invalidateCache } from '../lib/net-cache.mjs';
|
|
35
36
|
import { CONFIG_FILE } from '../config.mjs';
|
|
@@ -55,13 +56,46 @@ import { qa } from './qa.mjs';
|
|
|
55
56
|
* @returns {{ fila: Array<{story:number, pr:object}>, concluidas: Array<{story:number, pr:object}>,
|
|
56
57
|
* semPr: number[], bloqueios: string[], avisos: string[] }}
|
|
57
58
|
*/
|
|
58
|
-
|
|
59
|
+
/**
|
|
60
|
+
* Repositório de um PR. Os PRs passam a carregar `repo` ({owner, repo}, o
|
|
61
|
+
* repositório de onde foram listados — RFC-005); sem o campo, é o hub.
|
|
62
|
+
*/
|
|
63
|
+
export function prRepoOf(pr, hub) {
|
|
64
|
+
return pr?.repo?.owner && pr?.repo?.repo ? pr.repo : hub;
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
export function repoKey(r) {
|
|
68
|
+
return r ? `${r.owner}/${r.repo}`.toLowerCase() : '';
|
|
69
|
+
}
|
|
70
|
+
|
|
71
|
+
/** `#12` no hub, `acme/api#12` fora dele — a forma que o GitHub reconhece. */
|
|
72
|
+
export function prRef(pr, hub) {
|
|
73
|
+
const r = prRepoOf(pr, hub);
|
|
74
|
+
return !r || !hub || sameRepo(r, hub) ? `#${pr.number}` : `${r.owner}/${r.repo}#${pr.number}`;
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
/**
|
|
78
|
+
* @param {object} params
|
|
79
|
+
* @param {number[]} params.sorted ordem topológica (números de Story)
|
|
80
|
+
* @param {Map<number, {title: string}>} params.byNumber
|
|
81
|
+
* @param {Map<number, Array<{number, state, merged, isDraft, baseRefName, headRefName, repo?}>>} params.prsByStory
|
|
82
|
+
* @param {string} params.defaultBranch branch default do hub (e de quem não tiver a sua)
|
|
83
|
+
* @param {Map<string, string>} [params.defaultBranches] repoKey → branch default, por repo de código
|
|
84
|
+
* @param {{owner:string, repo:string}} [params.hub]
|
|
85
|
+
*/
|
|
86
|
+
export function planMerge({
|
|
87
|
+
sorted = [], byNumber = new Map(), prsByStory = new Map(), defaultBranch, defaultBranches = new Map(), hub = null,
|
|
88
|
+
} = {}) {
|
|
59
89
|
const fila = [];
|
|
60
90
|
const concluidas = [];
|
|
61
91
|
const semPr = [];
|
|
62
92
|
const bloqueios = [];
|
|
63
93
|
const avisos = [];
|
|
94
|
+
// A pilha é POR REPOSITÓRIO (RFC-005 §6.2): a head de um PR do `api` não é
|
|
95
|
+
// base válida para um PR do `web`. Chave = repo + branch.
|
|
64
96
|
const headsNoPlano = new Set();
|
|
97
|
+
const ref = pr => prRef(pr, hub);
|
|
98
|
+
const defaultOf = r => defaultBranches.get(repoKey(r)) ?? defaultBranch;
|
|
65
99
|
|
|
66
100
|
for (const story of sorted) {
|
|
67
101
|
const prs = prsByStory.get(story) || [];
|
|
@@ -76,31 +110,54 @@ export function planMerge({ sorted = [], byNumber = new Map(), prsByStory = new
|
|
|
76
110
|
semPr.push(story);
|
|
77
111
|
continue;
|
|
78
112
|
}
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
113
|
+
|
|
114
|
+
// Uma Story cross-repo tem UM PR por repositório (§3.4) — isso é o
|
|
115
|
+
// esperado. Ambíguo é mais de um PR aberto no MESMO repositório.
|
|
116
|
+
const porRepo = new Map();
|
|
117
|
+
for (const pr of abertos) {
|
|
118
|
+
const key = repoKey(prRepoOf(pr, hub));
|
|
119
|
+
porRepo.set(key, [...(porRepo.get(key) || []), pr]);
|
|
85
120
|
}
|
|
86
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
);
|
|
92
|
-
|
|
121
|
+
// Hub primeiro, depois os repos de código em ordem estável.
|
|
122
|
+
const chaves = [...porRepo.keys()].sort((a, b) => (a === repoKey(hub) ? -1 : b === repoKey(hub) ? 1 : a.localeCompare(b)));
|
|
123
|
+
let bloqueada = false;
|
|
124
|
+
const daStory = [];
|
|
125
|
+
for (const key of chaves) {
|
|
126
|
+
const grupo = porRepo.get(key);
|
|
127
|
+
if (grupo.length > 1) {
|
|
128
|
+
bloqueios.push(
|
|
129
|
+
`Story #${story} tem ${grupo.length} PRs abertos no mesmo repositório (${grupo.map(ref).join(', ')}) — ` +
|
|
130
|
+
'ambíguo; feche o que não vale antes de mergear.'
|
|
131
|
+
);
|
|
132
|
+
bloqueada = true;
|
|
133
|
+
continue;
|
|
134
|
+
}
|
|
135
|
+
const pr = grupo[0];
|
|
136
|
+
if (pr.isDraft) {
|
|
137
|
+
bloqueios.push(
|
|
138
|
+
`PR ${ref(pr)} (Story #${story}) está em RASCUNHO. Marcar pronto é a revisão humana ` +
|
|
139
|
+
'e o que dispara o CI — revise e marque pronto antes de mergear.'
|
|
140
|
+
);
|
|
141
|
+
bloqueada = true;
|
|
142
|
+
continue;
|
|
143
|
+
}
|
|
144
|
+
// Base que não é a default do repo nem a head de alguém que mergeia
|
|
145
|
+
// antes NO MESMO repo: ou a pilha está fora de ordem, ou aponta para
|
|
146
|
+
// algo que este plano não conhece.
|
|
147
|
+
const r = prRepoOf(pr, hub);
|
|
148
|
+
if (pr.baseRefName !== defaultOf(r) && !headsNoPlano.has(`${key}:${pr.baseRefName}`)) {
|
|
149
|
+
avisos.push(
|
|
150
|
+
`PR ${ref(pr)} (Story #${story}) tem base "${pr.baseRefName}", que não é a default ` +
|
|
151
|
+
'nem a branch de um PR anterior da fila nesse repositório — confira a pilha antes de confirmar.'
|
|
152
|
+
);
|
|
153
|
+
}
|
|
154
|
+
daStory.push(pr);
|
|
93
155
|
}
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
`PR #${pr.number} (Story #${story}) tem base "${pr.baseRefName}", que não é a default ` +
|
|
99
|
-
'nem a branch de um PR anterior da fila — confira a pilha antes de confirmar.'
|
|
100
|
-
);
|
|
156
|
+
if (bloqueada) continue;
|
|
157
|
+
for (const pr of daStory) {
|
|
158
|
+
headsNoPlano.add(`${repoKey(prRepoOf(pr, hub))}:${pr.headRefName}`);
|
|
159
|
+
fila.push({ story, pr });
|
|
101
160
|
}
|
|
102
|
-
headsNoPlano.add(pr.headRefName);
|
|
103
|
-
fila.push({ story, pr });
|
|
104
161
|
}
|
|
105
162
|
|
|
106
163
|
if (semPr.length > 0) {
|
|
@@ -135,14 +192,20 @@ export function planMerge({ sorted = [], byNumber = new Map(), prsByStory = new
|
|
|
135
192
|
export function complementWithBodyLinks({ sorted = [], prsByStory = new Map(), openPrs = [], hub, linkMode = 'explicit' } = {}) {
|
|
136
193
|
const out = new Map(prsByStory);
|
|
137
194
|
const adicionados = [];
|
|
138
|
-
const
|
|
139
|
-
if (faltantes.size === 0) return { prsByStory: out, adicionados };
|
|
195
|
+
const stories = new Set(sorted);
|
|
140
196
|
|
|
197
|
+
// A regra "só Story sem vínculo nativo" é POR REPOSITÓRIO: o vínculo nativo
|
|
198
|
+
// só existe no hub (o GitHub não fecha issue entre repos, §4), então o PR do
|
|
199
|
+
// `web` de uma Story que já tem PR nativo no hub entra pelo corpo — e um PR
|
|
200
|
+
// do hub redundante continua ignorado. No mono-repo é o comportamento antigo.
|
|
141
201
|
for (const pr of openPrs) {
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
202
|
+
const r = prRepoOf(pr, hub);
|
|
203
|
+
for (const n of hubIssueNumbers(extractIssueRefs(pr.body || '', { prRepo: r, linkMode }), hub)) {
|
|
204
|
+
if (!stories.has(n)) continue;
|
|
205
|
+
const atuais = out.get(n) || [];
|
|
206
|
+
if (atuais.some(p => repoKey(prRepoOf(p, hub)) === repoKey(r))) continue;
|
|
207
|
+
out.set(n, [...atuais, pr]);
|
|
208
|
+
adicionados.push({ story: n, pr: pr.number, repo: r });
|
|
146
209
|
}
|
|
147
210
|
}
|
|
148
211
|
return { prsByStory: out, adicionados };
|
|
@@ -247,8 +310,26 @@ export async function merge({
|
|
|
247
310
|
}
|
|
248
311
|
|
|
249
312
|
const enriched = stories.map(st => ({
|
|
250
|
-
number: st.number, title: st.title, nodeId: st.nodeId, dependsOn: st.dependsOn,
|
|
313
|
+
number: st.number, title: st.title, nodeId: st.nodeId, dependsOn: st.dependsOn, labels: st.labels,
|
|
251
314
|
}));
|
|
315
|
+
|
|
316
|
+
// Repositórios da Feature (RFC-005): o hub + os repos de código que as
|
|
317
|
+
// Stories declaram por label. No mono-repo a lista é só o hub — nada muda.
|
|
318
|
+
const hub = { owner, repo };
|
|
319
|
+
const { repos: codeRepos, unknown: desconhecidos } = codeReposForItems(fileConfig, {
|
|
320
|
+
labels: featureIssue.labels, children: stories,
|
|
321
|
+
});
|
|
322
|
+
if (desconhecidos.length > 0) {
|
|
323
|
+
p.log.warn(`Story(ies) declaram repositório(s) que o hub não conhece (${desconhecidos.join(', ')}) — PRs de lá não entram no plano; registre em repositories[] do ${CONFIG_FILE}.`);
|
|
324
|
+
}
|
|
325
|
+
const repos = [hub, ...codeRepos.map(r => ({ owner: r.owner, repo: r.repo, slug: r.slug }))];
|
|
326
|
+
const defaultBranches = new Map();
|
|
327
|
+
for (const r of codeRepos) {
|
|
328
|
+
const branch = await getRepoDefaultBranch(token, r.owner, r.repo).catch(() => null);
|
|
329
|
+
if (branch) defaultBranches.set(repoKey(r), branch);
|
|
330
|
+
else p.log.warn(`Não consegui ler a branch default de ${r.owner}/${r.repo} — assumindo "${defaultBranch}".`);
|
|
331
|
+
}
|
|
332
|
+
const defaultOf = r => defaultBranches.get(repoKey(r)) ?? defaultBranch;
|
|
252
333
|
const byNumber = new Map(enriched.map(x => [x.number, x]));
|
|
253
334
|
const { order: sorted, cycle } = orderStories(
|
|
254
335
|
enriched.map(({ number, dependsOn }) => ({ number, dependsOn })));
|
|
@@ -268,30 +349,39 @@ export async function merge({
|
|
|
268
349
|
}
|
|
269
350
|
|
|
270
351
|
// Vínculo nativo só existe com base na default — numa pilha, só o PR de
|
|
271
|
-
// baixo
|
|
272
|
-
// (`Closes #N`) é a fonte que o
|
|
273
|
-
|
|
274
|
-
|
|
352
|
+
// baixo — e só no hub: o GitHub não fecha issue entre repositórios (§4).
|
|
353
|
+
// O corpo dos PRs abertos (`Closes #N` / `Closes hub#N`) é a fonte que o
|
|
354
|
+
// autor de fato escreveu, em cada repositório da Feature.
|
|
355
|
+
if (codeRepos.length > 0 || sorted.some(story => (prsByStory.get(story) || []).length === 0)) {
|
|
356
|
+
const abertos = [];
|
|
357
|
+
for (const r of repos) {
|
|
358
|
+
const lista = await listOpenPullRequests(token, r.owner, r.repo).catch(() => []);
|
|
359
|
+
abertos.push(...lista.map(pr => ({ ...pr, repo: { owner: r.owner, repo: r.repo } })));
|
|
360
|
+
}
|
|
275
361
|
const linkMode = resolveLinkMode(fileConfig);
|
|
276
|
-
const comp = complementWithBodyLinks({ sorted, prsByStory, openPrs: abertos, hub
|
|
362
|
+
const comp = complementWithBodyLinks({ sorted, prsByStory, openPrs: abertos, hub, linkMode });
|
|
277
363
|
prsByStory = comp.prsByStory;
|
|
278
364
|
if (comp.adicionados.length > 0) {
|
|
279
365
|
p.log.info(chalk.dim(
|
|
280
|
-
comp.adicionados.map(({ story, pr }) => `Story #${story} ← PR
|
|
281
|
-
' — vínculo pelo corpo (Closes
|
|
366
|
+
comp.adicionados.map(({ story, pr, repo: r }) => `Story #${story} ← PR ${prRef({ number: pr, repo: r }, hub)}`).join(' · ') +
|
|
367
|
+
' — vínculo pelo corpo (Closes); o GitHub só registra o nativo quando a base é a default, e só no hub.'
|
|
282
368
|
));
|
|
283
369
|
}
|
|
284
370
|
}
|
|
285
371
|
|
|
286
|
-
const plano = planMerge({ sorted, byNumber, prsByStory, defaultBranch });
|
|
372
|
+
const plano = planMerge({ sorted, byNumber, prsByStory, defaultBranch, defaultBranches, hub });
|
|
287
373
|
s.stop(`${plano.fila.length} PR(s) a mergear · ${plano.concluidas.length} já mergeado(s).`);
|
|
288
374
|
|
|
289
375
|
const linha = ({ story, pr }) => {
|
|
290
|
-
const
|
|
291
|
-
|
|
376
|
+
const def = defaultOf(prRepoOf(pr, hub));
|
|
377
|
+
const retarget = pr.baseRefName !== def ? ` ${chalk.dim(`base ${pr.baseRefName} → ${def}`)}` : '';
|
|
378
|
+
return ` PR ${prRef(pr, hub)} · Story #${story} ${byNumber.get(story)?.title || ''}${retarget}`;
|
|
292
379
|
};
|
|
293
380
|
if (plano.fila.length > 0) {
|
|
294
|
-
|
|
381
|
+
const bases = codeRepos.length > 0
|
|
382
|
+
? repos.map(r => `${r.slug ?? 'hub'}: ${defaultOf(r)}`).join(', ')
|
|
383
|
+
: defaultBranch;
|
|
384
|
+
p.note(plano.fila.map(linha).join('\n'), `Ordem de merge (base: ${bases}, método: merge commit)`);
|
|
295
385
|
}
|
|
296
386
|
for (const a of plano.avisos) p.log.warn(a);
|
|
297
387
|
for (const b of plano.bloqueios) p.log.error(b);
|
|
@@ -301,12 +391,13 @@ export async function merge({
|
|
|
301
391
|
// guarda. Só as PRs que de fato vão ser mergeadas (plano.fila) valem a
|
|
302
392
|
// chamada extra por PR; falha de rede não afirma nada, só é pulada.
|
|
303
393
|
for (const { story, pr } of plano.fila) {
|
|
304
|
-
const
|
|
394
|
+
const r = prRepoOf(pr, hub);
|
|
395
|
+
const messages = await listPullRequestCommitMessages(token, r.owner, r.repo, pr.number).catch(() => null);
|
|
305
396
|
if (messages === null) continue;
|
|
306
397
|
const { missingStories } = missingTrailers(messages, { stories: [story] });
|
|
307
398
|
if (missingStories.length > 0) {
|
|
308
399
|
p.log.warn(
|
|
309
|
-
`PR
|
|
400
|
+
`PR ${prRef(pr, hub)} (Story #${story}): nenhum commit traz o trailer \`Spec-Wave-Story: #${story}\` ` +
|
|
310
401
|
'— confira se é mesmo o trabalho certo antes de mergear.'
|
|
311
402
|
);
|
|
312
403
|
}
|
|
@@ -331,48 +422,55 @@ export async function merge({
|
|
|
331
422
|
const mergedHeads = [];
|
|
332
423
|
try {
|
|
333
424
|
for (const { story, pr } of plano.fila) {
|
|
425
|
+
// Cada PR é mergeado NO SEU repositório; a pilha é por repo (RFC-005).
|
|
426
|
+
const r = prRepoOf(pr, hub);
|
|
427
|
+
const def = defaultOf(r);
|
|
428
|
+
const ref = prRef(pr, hub);
|
|
429
|
+
const prRepoOpt = sameRepo(r, hub) ? undefined : `${r.owner}/${r.repo}`;
|
|
334
430
|
// Estado fresco: a fila pode ter envelhecido entre o plano e este ponto.
|
|
335
|
-
const atual = await getPR(token, owner, repo, pr.number);
|
|
431
|
+
const atual = await getPR(token, r.owner, r.repo, pr.number);
|
|
336
432
|
if (atual.merged_at) {
|
|
337
|
-
p.log.info(`PR
|
|
433
|
+
p.log.info(`PR ${ref} já estava mergeado — seguindo.`);
|
|
338
434
|
continue;
|
|
339
435
|
}
|
|
340
|
-
if (atual.base?.ref !==
|
|
341
|
-
p.log.step(`PR
|
|
342
|
-
await updatePRBase(token, owner, repo, pr.number,
|
|
436
|
+
if (atual.base?.ref !== def) {
|
|
437
|
+
p.log.step(`PR ${ref}: base ${atual.base?.ref} → ${def}`);
|
|
438
|
+
await updatePRBase(token, r.owner, r.repo, pr.number, def);
|
|
343
439
|
}
|
|
344
440
|
try {
|
|
345
|
-
await mergePR(token, owner, repo, pr.number, { method: 'merge' });
|
|
441
|
+
await mergePR(token, r.owner, r.repo, pr.number, { method: 'merge' });
|
|
346
442
|
} catch (err) {
|
|
347
443
|
// 405 = draft/check pendente/conflito. Parar AQUI preserva a ordem: os
|
|
348
444
|
// dependentes continuam com branch e PR intactos, e rodar de novo retoma.
|
|
445
|
+
// Numa Story cross-repo isso pode deixar `api` mergeado e `web` não —
|
|
446
|
+
// a janela que a §3.4 aceita conscientemente; rodar de novo fecha.
|
|
349
447
|
p.log.error(
|
|
350
|
-
`Merge do PR
|
|
448
|
+
`Merge do PR ${ref} (Story #${story}) recusado: ${err.message}\n` +
|
|
351
449
|
'Nada depois dele foi mergeado. Resolva (checks, conflito) e rode o comando de novo — ' +
|
|
352
450
|
'os já mergeados saem do plano sozinhos.'
|
|
353
451
|
);
|
|
354
452
|
process.exitCode = 1;
|
|
355
453
|
return;
|
|
356
454
|
}
|
|
357
|
-
p.log.success(`PR
|
|
358
|
-
mergedHeads.push(pr.headRefName);
|
|
455
|
+
p.log.success(`PR ${ref} mergeado (Story #${story}).`);
|
|
456
|
+
mergedHeads.push({ repo: r, head: pr.headRefName });
|
|
359
457
|
|
|
360
458
|
// Board: merge move até 🧪 QA. Falha aqui não desfaz merge — avisa e segue.
|
|
361
459
|
try {
|
|
362
|
-
await codeReview({ prNumber: String(pr.number) });
|
|
363
|
-
await qa({ prNumber: String(pr.number) });
|
|
460
|
+
await codeReview({ prNumber: String(pr.number), prRepo: prRepoOpt });
|
|
461
|
+
await qa({ prNumber: String(pr.number), prRepo: prRepoOpt });
|
|
364
462
|
} catch (err) {
|
|
365
|
-
p.log.warn(`Board não atualizado para o PR
|
|
463
|
+
p.log.warn(`Board não atualizado para o PR ${ref}: ${err.message} — rode \`spec-wave run --pr ${pr.number}\` depois.`);
|
|
366
464
|
}
|
|
367
465
|
}
|
|
368
466
|
|
|
369
467
|
// Branches só no FIM, quando nenhum PR aberto depende delas — apagar antes
|
|
370
468
|
// do retarget do dependente foi o que fechou um PR empilhado sem volta.
|
|
371
469
|
if (!keepBranches) {
|
|
372
|
-
for (const head of mergedHeads) {
|
|
470
|
+
for (const { repo: r, head } of mergedHeads) {
|
|
373
471
|
if (!head) continue;
|
|
374
|
-
await deleteBranch(token, owner, repo, head).catch(err =>
|
|
375
|
-
p.log.warn(`Branch ${head} não apagada: ${err.message}`));
|
|
472
|
+
await deleteBranch(token, r.owner, r.repo, head).catch(err =>
|
|
473
|
+
p.log.warn(`Branch ${head} (${r.owner}/${r.repo}) não apagada: ${err.message}`));
|
|
376
474
|
}
|
|
377
475
|
}
|
|
378
476
|
} finally {
|
package/src/commands/run.mjs
CHANGED
|
@@ -275,7 +275,23 @@ export function renderRunJson({ issueNumber, type, ultimaDecisao, passos = [] })
|
|
|
275
275
|
);
|
|
276
276
|
}
|
|
277
277
|
|
|
278
|
+
// Passos que chamam o modelo com Read/Glob/Grep: antes deles, o workspace
|
|
279
|
+
// multi-repo (RFC-005 §7.2) — o mesmo passo que o Action do hub roda. Local,
|
|
280
|
+
// resolve irmãos/override e clona o que faltar; best-effort, porque no
|
|
281
|
+
// mono-repo não há nada a montar e um aviso já diz o que faltou.
|
|
282
|
+
const ACTIONS_COM_CODIGO = new Set(['generate-spec', 'generate-plan', 'decompose', 'generate-bug', 'generate-qa-plan']);
|
|
283
|
+
|
|
284
|
+
async function prepareWorkspaceFor(issueNumber) {
|
|
285
|
+
try {
|
|
286
|
+
const { workspace } = await import('./workspace.mjs');
|
|
287
|
+
await workspace({ action: 'prepare', issue: issueNumber });
|
|
288
|
+
} catch (err) {
|
|
289
|
+
console.warn(`Workspace multi-repo não montado (${err.message}) — o modelo lê só o hub.`);
|
|
290
|
+
}
|
|
291
|
+
}
|
|
292
|
+
|
|
278
293
|
async function dispatch(action, { issueNumber }) {
|
|
294
|
+
if (ACTIONS_COM_CODIGO.has(action)) await prepareWorkspaceFor(issueNumber);
|
|
279
295
|
switch (action) {
|
|
280
296
|
case 'generate-spec': {
|
|
281
297
|
const { generateSpec } = await import('./generate-spec.mjs');
|
|
@@ -14,7 +14,7 @@ import { resolveCacheTtl } from '../lib/net-cache.mjs';
|
|
|
14
14
|
import { codeRepositories } from '../lib/repo-role.mjs';
|
|
15
15
|
import {
|
|
16
16
|
slugsForItem, resolveWorkspaceLayout, readWorkspaceOverride, prepareWorkspace, renderRepoDirs,
|
|
17
|
-
WORKSPACE_OVERRIDE_FILE,
|
|
17
|
+
writeWorkspaceManifest, WORKSPACE_OVERRIDE_FILE,
|
|
18
18
|
} from '../lib/workspace.mjs';
|
|
19
19
|
import { CONFIG_FILE } from '../config.mjs';
|
|
20
20
|
|
|
@@ -87,6 +87,10 @@ export async function workspace({ action, issue: issueArg, json = false, dryRun
|
|
|
87
87
|
const { cloned, missing } = await prepareWorkspace({
|
|
88
88
|
layout, token: isActions ? token : null, shallow: isActions, log,
|
|
89
89
|
});
|
|
90
|
+
// O manifesto é o que os prompts leem (generateDocument anexa a seção
|
|
91
|
+
// "Workspace multi-repo" a partir dele) — por issue, para não vazar o
|
|
92
|
+
// workspace de uma Feature na geração de outra.
|
|
93
|
+
writeWorkspaceManifest(root, issueNumber, layout);
|
|
90
94
|
if (!json) {
|
|
91
95
|
for (const r of layout.repos) {
|
|
92
96
|
p.log.success(`${r.slug} → ${chalk.cyan(r.dir)} (${cloned.includes(r.slug) ? 'clonado' : r.source})`);
|
package/src/lib/claude.mjs
CHANGED
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
import Anthropic from '@anthropic-ai/sdk';
|
|
2
2
|
import { readFileSync } from 'node:fs';
|
|
3
|
+
import path from 'node:path';
|
|
3
4
|
import {
|
|
4
5
|
getProvider, DEFAULT_PROVIDER, MODEL_LABEL_PREFIX,
|
|
5
6
|
DEFAULT_MAX_CRITIQUE_ATTEMPTS, labelNames,
|
|
@@ -9,6 +10,7 @@ import { runAgent } from '../agent/index.mjs';
|
|
|
9
10
|
import { TruncatedOutputError, MaxTurnsError, isTruncationReason } from '../agent/errors.mjs';
|
|
10
11
|
import { computeCost } from './usage-report.mjs';
|
|
11
12
|
import { findConfigPath } from './project-root.mjs';
|
|
13
|
+
import { readWorkspaceManifest, workspacePromptSection } from './workspace.mjs';
|
|
12
14
|
|
|
13
15
|
// Teto de saída padrão. O valor anterior (8192) truncava specs reais: um
|
|
14
16
|
// documento de ~20 KB em pt-BR já custa ~6k tokens, e modelos com raciocínio
|
|
@@ -285,6 +287,18 @@ export function supportsStrictSchema(model) {
|
|
|
285
287
|
// soma tokens/custo na MESMA entrada).
|
|
286
288
|
export async function generateDocument(systemPrompt, userContent, opts = {}) {
|
|
287
289
|
const ai = resolveAi(opts.action, { labels: opts.labels });
|
|
290
|
+
// Multi-repo (RFC-005 §7.2): se `workspace prepare` rodou para esta issue,
|
|
291
|
+
// a entrada ganha os diretórios dos repos de código — sem eles o modelo
|
|
292
|
+
// "lê o repositório", acha só markdown e escreve um plano sem ver código.
|
|
293
|
+
if (opts.issueNumber) {
|
|
294
|
+
const configPath = findConfigPath();
|
|
295
|
+
const root = opts.cwd ?? (configPath ? path.dirname(configPath) : process.cwd());
|
|
296
|
+
const secao = workspacePromptSection(readWorkspaceManifest(root, opts.issueNumber));
|
|
297
|
+
if (secao) {
|
|
298
|
+
userContent = `${userContent}\n${secao}`;
|
|
299
|
+
console.log('Workspace multi-repo anexado à entrada do modelo (.spec-wave/workspace-' + opts.issueNumber + '.json).');
|
|
300
|
+
}
|
|
301
|
+
}
|
|
288
302
|
const temperature = opts.temperature ?? 0.2;
|
|
289
303
|
// Modelos de reasoning (ex.: deepseek-r1, Opus 4.7+) consomem tokens
|
|
290
304
|
// "pensando" antes da resposta, então o teto precisa cobrir raciocínio +
|
package/src/lib/pr-ready.mjs
CHANGED
|
@@ -39,9 +39,12 @@ export function planPrsToReady(prs = []) {
|
|
|
39
39
|
for (const pr of prs) {
|
|
40
40
|
if (!pr?.id || !pr.isDraft || pr.merged) continue;
|
|
41
41
|
if (pr.state && pr.state !== 'open') continue;
|
|
42
|
-
|
|
42
|
+
// Chave = node id: o número colide entre repositórios (PR #42 do `api` e
|
|
43
|
+
// #42 do `web`), o id não.
|
|
44
|
+
if (!out.has(pr.id)) out.set(pr.id, pr);
|
|
43
45
|
}
|
|
44
|
-
|
|
46
|
+
const repoOf = pr => (pr.repo ? `${pr.repo.owner}/${pr.repo.repo}`.toLowerCase() : '');
|
|
47
|
+
return [...out.values()].sort((a, b) => repoOf(a).localeCompare(repoOf(b)) || a.number - b.number);
|
|
45
48
|
}
|
|
46
49
|
|
|
47
50
|
/**
|
|
@@ -61,28 +64,42 @@ export function planPrsToReady(prs = []) {
|
|
|
61
64
|
* @returns {Promise<Array<object>>} PRs sem repetição
|
|
62
65
|
*/
|
|
63
66
|
export async function collectFeaturePullRequests({
|
|
64
|
-
token, owner, repo, issueNumbers = [], issueNodes = [], linkMode = 'explicit',
|
|
67
|
+
token, owner, repo, issueNumbers = [], issueNodes = [], linkMode = 'explicit', codeRepos = [],
|
|
65
68
|
}) {
|
|
66
69
|
const alvo = new Set(issueNumbers);
|
|
67
|
-
const
|
|
70
|
+
const byKey = new Map();
|
|
71
|
+
const keyOf = pr => pr.id || `${pr.repo?.owner}/${pr.repo?.repo}#${pr.number}`.toLowerCase();
|
|
68
72
|
|
|
69
|
-
// `owner/repo` é o hub: as issues são dele
|
|
70
|
-
//
|
|
71
|
-
//
|
|
73
|
+
// `owner/repo` é o hub: as issues são dele. Os PRs vivem no hub E nos repos
|
|
74
|
+
// de código da Feature (RFC-005); cada um sai marcado com o repositório de
|
|
75
|
+
// onde foi listado — o número colide entre repos, o par não. Um `#N` solto
|
|
76
|
+
// é issue do repo do PR; só o que aponta para o hub é desta Feature.
|
|
72
77
|
const hub = { owner, repo };
|
|
73
|
-
const
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
78
|
+
for (const r of [hub, ...codeRepos]) {
|
|
79
|
+
const abertos = await listOpenPullRequests(token, r.owner, r.repo).catch(() => []);
|
|
80
|
+
for (const raw of abertos) {
|
|
81
|
+
const pr = { ...raw, repo: { owner: r.owner, repo: r.repo } };
|
|
82
|
+
const fecha = hubIssueNumbers(extractIssueRefs(pr.body || '', { prRepo: pr.repo, linkMode }), hub);
|
|
83
|
+
if (fecha.some(n => alvo.has(n))) byKey.set(keyOf(pr), pr);
|
|
84
|
+
}
|
|
77
85
|
}
|
|
78
86
|
|
|
87
|
+
// Vínculo nativo: só existe no hub (o GitHub não fecha issue entre repos).
|
|
79
88
|
for (const node of issueNodes) {
|
|
80
89
|
if (!node?.nodeId) continue;
|
|
81
|
-
for (const
|
|
82
|
-
|
|
90
|
+
for (const raw of await listIssuePullRequests(token, node.nodeId).catch(() => [])) {
|
|
91
|
+
const pr = { ...raw, repo: raw.repo || hub };
|
|
92
|
+
if (!byKey.has(keyOf(pr))) byKey.set(keyOf(pr), pr);
|
|
83
93
|
}
|
|
84
94
|
}
|
|
85
|
-
return [...
|
|
95
|
+
return [...byKey.values()];
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
/** `#12` no hub, `acme/api#12` fora dele. */
|
|
99
|
+
export function prLabel(pr, hub) {
|
|
100
|
+
const r = pr.repo;
|
|
101
|
+
const noHub = !r || (r.owner.toLowerCase() === hub.owner.toLowerCase() && r.repo.toLowerCase() === hub.repo.toLowerCase());
|
|
102
|
+
return noHub ? `#${pr.number}` : `${r.owner}/${r.repo}#${pr.number}`;
|
|
86
103
|
}
|
|
87
104
|
|
|
88
105
|
/**
|
|
@@ -96,15 +113,18 @@ export async function collectFeaturePullRequests({
|
|
|
96
113
|
* @param {{number:number, nodeId?:string}} params.feature
|
|
97
114
|
* @param {Array<{number:number, nodeId?:string}>} params.stories todas as
|
|
98
115
|
* Stories da Feature — as recém-concluídas E as que já estavam em Code Review
|
|
99
|
-
* @
|
|
116
|
+
* @param {Array<{owner:string, repo:string}>} [params.codeRepos] repos de código da
|
|
117
|
+
* Feature (RFC-005) — os PRs vivem neles além do hub
|
|
118
|
+
* @returns {Promise<string[]>} rótulos dos PRs marcados (`#12`, `acme/api#12`)
|
|
100
119
|
*/
|
|
101
120
|
export async function markFeaturePrsReady({
|
|
102
|
-
token, owner, repo, feature, stories = [], dryRun = false, log = p.log, linkMode = 'explicit',
|
|
121
|
+
token, owner, repo, feature, stories = [], dryRun = false, log = p.log, linkMode = 'explicit', codeRepos = [],
|
|
103
122
|
}) {
|
|
104
123
|
if (!token || !owner || !repo || !feature?.number) return [];
|
|
124
|
+
const hub = { owner, repo };
|
|
105
125
|
try {
|
|
106
126
|
const prs = await collectFeaturePullRequests({
|
|
107
|
-
token, owner, repo, linkMode,
|
|
127
|
+
token, owner, repo, linkMode, codeRepos,
|
|
108
128
|
issueNumbers: [feature.number, ...stories.map(s => s.number)].filter(Boolean),
|
|
109
129
|
issueNodes: [feature, ...stories],
|
|
110
130
|
});
|
|
@@ -113,26 +133,28 @@ export async function markFeaturePrsReady({
|
|
|
113
133
|
|
|
114
134
|
if (dryRun) {
|
|
115
135
|
log.info(
|
|
116
|
-
`PRs (dry-run): ${alvos.map(pr =>
|
|
136
|
+
`PRs (dry-run): ${alvos.map(pr => prLabel(pr, hub)).join(', ')} sairiam do rascunho ` +
|
|
117
137
|
`(Feature #${feature.number} pronta para review) — não aplicado`
|
|
118
138
|
);
|
|
119
139
|
return [];
|
|
120
140
|
}
|
|
121
141
|
|
|
142
|
+
// Devolve os rótulos (`#12`, `acme/api#12`), não os números: fora do hub o
|
|
143
|
+
// número sozinho não identifica o PR.
|
|
122
144
|
const marcados = [];
|
|
123
145
|
const falhas = [];
|
|
124
146
|
for (const pr of alvos) {
|
|
125
147
|
try {
|
|
126
148
|
await markPullRequestReadyForReview(token, pr.id);
|
|
127
|
-
marcados.push(pr
|
|
149
|
+
marcados.push(prLabel(pr, hub));
|
|
128
150
|
} catch (err) {
|
|
129
|
-
falhas.push(
|
|
151
|
+
falhas.push(`${prLabel(pr, hub)} (${err.message})`);
|
|
130
152
|
}
|
|
131
153
|
}
|
|
132
154
|
if (marcados.length > 0) {
|
|
133
155
|
log.success(
|
|
134
156
|
`${marcados.length} PR(s) da Feature #${feature.number} prontos para revisão: ` +
|
|
135
|
-
marcados.
|
|
157
|
+
marcados.join(', ')
|
|
136
158
|
);
|
|
137
159
|
}
|
|
138
160
|
if (falhas.length > 0) {
|
package/src/lib/workspace.mjs
CHANGED
|
@@ -41,6 +41,21 @@ export function slugsForItem({ labels = [], children = [] } = {}) {
|
|
|
41
41
|
return [...agg].sort();
|
|
42
42
|
}
|
|
43
43
|
|
|
44
|
+
/**
|
|
45
|
+
* Repositórios de código de um item, resolvidos contra `repositories[]` do hub
|
|
46
|
+
* (função PURA): os slugs vêm das labels (Feature agrega os filhos), e um slug
|
|
47
|
+
* que o hub não conhece volta em `unknown` em vez de virar repositório.
|
|
48
|
+
*
|
|
49
|
+
* @returns {{ repos: Array<{slug:string, owner:string, repo:string}>, unknown: string[] }}
|
|
50
|
+
*/
|
|
51
|
+
export function codeReposForItems(config, { labels = [], children = [] } = {}) {
|
|
52
|
+
const slugs = slugsForItem({ labels, children });
|
|
53
|
+
const known = codeRepositories(config);
|
|
54
|
+
const repos = known.filter(r => slugs.includes(r.slug));
|
|
55
|
+
const unknown = slugs.filter(s => !repos.some(r => r.slug === s));
|
|
56
|
+
return { repos, unknown };
|
|
57
|
+
}
|
|
58
|
+
|
|
44
59
|
/**
|
|
45
60
|
* Onde cada repositório fica (função PURA — `exists` é injetável).
|
|
46
61
|
*
|
|
@@ -102,6 +117,55 @@ export function renderRepoDirs(repos = []) {
|
|
|
102
117
|
return repos.map(r => `${r.slug}=${r.dir}`).join(' ');
|
|
103
118
|
}
|
|
104
119
|
|
|
120
|
+
/** Manifesto do workspace de uma issue — o elo entre `workspace prepare` e os prompts. */
|
|
121
|
+
export function workspaceManifestPath(root, issueNumber) {
|
|
122
|
+
return path.join(root, '.spec-wave', `workspace-${issueNumber}.json`);
|
|
123
|
+
}
|
|
124
|
+
|
|
125
|
+
export function writeWorkspaceManifest(root, issueNumber, layout) {
|
|
126
|
+
const file = workspaceManifestPath(root, issueNumber);
|
|
127
|
+
mkdirSync(path.dirname(file), { recursive: true });
|
|
128
|
+
writeFileSync(file, `${JSON.stringify({
|
|
129
|
+
issue: issueNumber,
|
|
130
|
+
preparedAt: new Date().toISOString(),
|
|
131
|
+
workspaceDir: layout.workspaceDir,
|
|
132
|
+
hubDir: layout.hubDir,
|
|
133
|
+
repos: layout.repos.map(r => ({ slug: r.slug, owner: r.owner, repo: r.repo, dir: r.dir, present: r.present })),
|
|
134
|
+
}, null, 2)}\n`);
|
|
135
|
+
return file;
|
|
136
|
+
}
|
|
137
|
+
|
|
138
|
+
export function readWorkspaceManifest(root, issueNumber) {
|
|
139
|
+
try {
|
|
140
|
+
const parsed = JSON.parse(readFileSync(workspaceManifestPath(root, issueNumber), 'utf-8'));
|
|
141
|
+
return parsed && Array.isArray(parsed.repos) ? parsed : null;
|
|
142
|
+
} catch {
|
|
143
|
+
return null;
|
|
144
|
+
}
|
|
145
|
+
}
|
|
146
|
+
|
|
147
|
+
/**
|
|
148
|
+
* Seção "Workspace multi-repo" anexada à entrada do modelo (função PURA sobre
|
|
149
|
+
* o manifesto). Os clones ficam sob um `.gitignore` com `*`, e o Glob do
|
|
150
|
+
* backend anthropic respeita gitignore a partir da raiz do hub: sem os
|
|
151
|
+
* caminhos explícitos o modelo procuraria o código e não acharia nada —
|
|
152
|
+
* exatamente o plano plausível escrito sem ver uma linha (§7.2).
|
|
153
|
+
*
|
|
154
|
+
* @returns {string} '' quando não há repo presente
|
|
155
|
+
*/
|
|
156
|
+
export function workspacePromptSection(manifest) {
|
|
157
|
+
const presentes = (manifest?.repos || []).filter(r => r.present && r.dir);
|
|
158
|
+
if (presentes.length === 0) return '';
|
|
159
|
+
return [
|
|
160
|
+
'',
|
|
161
|
+
'## Workspace multi-repo',
|
|
162
|
+
'Este hub guarda só documentação. O código desta issue está nos repositórios abaixo, ' +
|
|
163
|
+
'já clonados — aponte `Glob`/`Grep`/`Read` para esses diretórios (parâmetro `path`, caminho absoluto): ' +
|
|
164
|
+
'a partir da raiz do hub eles ficam fora da busca.',
|
|
165
|
+
...presentes.map(r => `- \`${r.slug}\` (${r.owner}/${r.repo}): \`${r.dir}\``),
|
|
166
|
+
].join('\n');
|
|
167
|
+
}
|
|
168
|
+
|
|
105
169
|
function cloneUrl({ owner, repo }, token) {
|
|
106
170
|
// Token na URL só no Action, onde o clone é descartável; localmente o git
|
|
107
171
|
// usa o credential helper do dev (o do gh, normalmente).
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "spec-wave",
|
|
3
3
|
"displayName": "Spec Wave",
|
|
4
|
-
"version": "1.0.
|
|
4
|
+
"version": "1.0.4",
|
|
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",
|
|
@@ -33,6 +33,8 @@ Você tem `Read`, `Glob` e `Grep` no repositório. Use-os para transformar sinto
|
|
|
33
33
|
3. Procure o teste que deveria ter pego isto. A ausência dele é um achado, e vira a seção **Teste de Regressão**.
|
|
34
34
|
|
|
35
35
|
Cite arquivo e função nas seções **Causa Raiz** e **Escopo do Fix**. Um `bug.md` sem referência a código é um relato reescrito, não uma investigação.
|
|
36
|
+
|
|
37
|
+
Se a entrada trouxer a seção **Workspace multi-repo**, o código NÃO está neste repositório (o hub só guarda documentação): está nos diretórios listados ali, um por repositório de código. Aponte `Glob`/`Grep`/`Read` para esses caminhos absolutos (parâmetro `path`) — a partir da raiz do hub eles ficam fora da busca — e diga em qual repositório está a causa.
|
|
36
38
|
<!-- /requires-tools -->
|
|
37
39
|
|
|
38
40
|
## Estrutura obrigatória
|
|
@@ -25,6 +25,8 @@ Quando um dos dois documentos não existir, a entrada diz isso explicitamente. D
|
|
|
25
25
|
## Exploração antes de decompor
|
|
26
26
|
|
|
27
27
|
Você tem `Read`, `Glob` e `Grep` no repositório. Use-os para dimensionar as tasks contra o código que existe de verdade: uma task "criar endpoint X" é diferente conforme o controller já exista ou não. Ancore os títulos técnicos nos caminhos e nomes reais que encontrar.
|
|
28
|
+
|
|
29
|
+
Se a entrada trouxer a seção **Workspace multi-repo**, o código NÃO está neste repositório (o hub só guarda documentação): está nos diretórios listados ali, um por repositório de código. Aponte `Glob`/`Grep`/`Read` para esses caminhos absolutos (parâmetro `path`) — a partir da raiz do hub eles ficam fora da busca — e diga em cada task em qual repositório ela acontece.
|
|
28
30
|
<!-- /requires-tools -->
|
|
29
31
|
|
|
30
32
|
## Contrato de saída
|