@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.
Files changed (37) hide show
  1. package/package.json +1 -1
  2. package/src/api/auth.mjs +29 -1
  3. package/src/commands/code-review.mjs +3 -1
  4. package/src/commands/decompose.mjs +1 -1
  5. package/src/commands/doctor.mjs +54 -20
  6. package/src/commands/generate-bug.mjs +1 -0
  7. package/src/commands/generate-plan.mjs +1 -0
  8. package/src/commands/generate-qa-plan.mjs +1 -0
  9. package/src/commands/generate-spec.mjs +1 -0
  10. package/src/commands/implement.mjs +31 -3
  11. package/src/commands/init.mjs +4 -1
  12. package/src/commands/merge.mjs +157 -59
  13. package/src/commands/run.mjs +16 -0
  14. package/src/commands/workspace.mjs +5 -1
  15. package/src/lib/claude.mjs +14 -0
  16. package/src/lib/pr-ready.mjs +43 -21
  17. package/src/lib/workspace.mjs +64 -0
  18. package/src/plugin/.claude-plugin/plugin.json +1 -1
  19. package/src/plugin/skills/bug/model-prompt.md +2 -0
  20. package/src/plugin/skills/decompose/model-prompt.feature.md +2 -0
  21. package/src/plugin/skills/decompose/model-prompt.rfc.md +2 -0
  22. package/src/plugin/skills/merge/SKILL.md +1 -0
  23. package/src/plugin/skills/plan/model-prompt.md +2 -0
  24. package/src/plugin/skills/qa/model-prompt.md +2 -0
  25. package/src/plugin/skills/setup/SKILL.md +9 -0
  26. package/src/plugin/skills/spec/model-prompt.md +2 -0
  27. package/src/templates/skill/SKILL.md +9 -0
  28. package/src/templates/workflows/code/code-review.yml +25 -7
  29. package/src/templates/workflows/code/qa.yml +24 -6
  30. package/src/templates/workflows/code-review.yml +16 -1
  31. package/src/templates/workflows/decompose.yml +30 -2
  32. package/src/templates/workflows/generate-bug.yml +27 -1
  33. package/src/templates/workflows/generate-plan.yml +27 -1
  34. package/src/templates/workflows/generate-qa-plan.yml +28 -2
  35. package/src/templates/workflows/generate-spec.yml +27 -1
  36. package/src/templates/workflows/pr-events.yml +35 -8
  37. package/src/templates/workflows/qa.yml +15 -1
@@ -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
- export function planMerge({ sorted = [], byNumber = new Map(), prsByStory = new Map(), defaultBranch } = {}) {
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
- if (abertos.length > 1) {
80
- bloqueios.push(
81
- `Story #${story} tem ${abertos.length} PRs abertos (${abertos.map(x => `#${x.number}`).join(', ')}) — ` +
82
- 'ambíguo; feche o que não vale antes de mergear.'
83
- );
84
- continue;
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
- const pr = abertos[0];
87
- if (pr.isDraft) {
88
- bloqueios.push(
89
- `PR #${pr.number} (Story #${story}) está em RASCUNHO. Marcar pronto é a revisão humana ` +
90
- 'e o que dispara o CI — revise e marque pronto antes de mergear.'
91
- );
92
- continue;
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
- // Base que não é a default nem a head de alguém que mergeia antes: ou a
95
- // pilha está fora de ordem, ou aponta para algo que este plano não conhece.
96
- if (pr.baseRefName !== defaultBranch && !headsNoPlano.has(pr.baseRefName)) {
97
- avisos.push(
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 faltantes = new Set(sorted.filter(s => (out.get(s) || []).length === 0));
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
- for (const n of hubIssueNumbers(extractIssueRefs(pr.body || '', { prRepo: hub, linkMode }), hub)) {
143
- if (!faltantes.has(n)) continue;
144
- out.set(n, [...(out.get(n) || []), pr]);
145
- adicionados.push({ story: n, pr: pr.number });
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. Para as Stories que ficaram sem nada, o corpo dos PRs abertos
272
- // (`Closes #N`) é a fonte que o autor de fato escreveu.
273
- if (sorted.some(story => (prsByStory.get(story) || []).length === 0)) {
274
- const abertos = await listOpenPullRequests(token, owner, repo).catch(() => []);
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: { owner, repo }, linkMode });
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 #${pr}`).join(' · ') +
281
- ' — vínculo pelo corpo (Closes #N); o GitHub só registra o nativo quando a base é a default.'
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 retarget = pr.baseRefName !== defaultBranch ? ` ${chalk.dim(`base ${pr.baseRefName} → ${defaultBranch}`)}` : '';
291
- return ` PR #${pr.number} · Story #${story} ${byNumber.get(story)?.title || ''}${retarget}`;
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
- p.note(plano.fila.map(linha).join('\n'), `Ordem de merge (base: ${defaultBranch}, método: merge commit)`);
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 messages = await listPullRequestCommitMessages(token, owner, repo, pr.number).catch(() => null);
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 #${pr.number} (Story #${story}): nenhum commit traz o trailer \`Spec-Wave-Story: #${story}\` ` +
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 #${pr.number} já estava mergeado — seguindo.`);
433
+ p.log.info(`PR ${ref} já estava mergeado — seguindo.`);
338
434
  continue;
339
435
  }
340
- if (atual.base?.ref !== defaultBranch) {
341
- p.log.step(`PR #${pr.number}: base ${atual.base?.ref} → ${defaultBranch}`);
342
- await updatePRBase(token, owner, repo, pr.number, defaultBranch);
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 #${pr.number} (Story #${story}) recusado: ${err.message}\n` +
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 #${pr.number} mergeado (Story #${story}).`);
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 #${pr.number}: ${err.message} — rode \`spec-wave run --pr ${pr.number}\` depois.`);
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 {
@@ -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})`);
@@ -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 +
@@ -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
- if (!out.has(pr.number)) out.set(pr.number, pr);
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
- return [...out.values()].sort((a, b) => a.number - b.number);
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 byNumber = new Map();
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 e, por ora, os PRs listados também.
70
- // Um `#N` solto num PR do hub é issue do hub; um `outro/repo#N` não é desta
71
- // Feature — sem isso `acme/api#412` num PR do hub casaria a Story #412.
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 abertos = await listOpenPullRequests(token, owner, repo).catch(() => []);
74
- for (const pr of abertos) {
75
- const fecha = hubIssueNumbers(extractIssueRefs(pr.body || '', { prRepo: hub, linkMode }), hub);
76
- if (fecha.some(n => alvo.has(n))) byNumber.set(pr.number, pr);
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 pr of await listIssuePullRequests(token, node.nodeId).catch(() => [])) {
82
- if (!byNumber.has(pr.number)) byNumber.set(pr.number, pr);
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 [...byNumber.values()];
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
- * @returns {Promise<number[]>} números dos PRs marcados como prontos
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 => `#${pr.number}`).join(', ')} sairiam do rascunho ` +
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.number);
149
+ marcados.push(prLabel(pr, hub));
128
150
  } catch (err) {
129
- falhas.push(`#${pr.number} (${err.message})`);
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.map(n => `#${n}`).join(', ')
157
+ marcados.join(', ')
136
158
  );
137
159
  }
138
160
  if (falhas.length > 0) {
@@ -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.2",
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