@spec-wave/cli 1.6.0 → 1.7.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.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@spec-wave/cli",
3
- "version": "1.6.0",
3
+ "version": "1.7.0",
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": {
package/src/cli.mjs CHANGED
@@ -408,6 +408,33 @@ Ordem de resolução por slug: override em .spec-wave/workspace.json ({ "dirs":
408
408
  Irmãos e overrides são seus: nunca são clonados nem tocados. O implement lê o mesmo layout
409
409
  para preencher {workspaceDir} e {repoDirs} no comando do spec-kit.`);
410
410
 
411
+ program
412
+ .command('pr')
413
+ .description('Abre (ou reaproveita) o Pull Request de uma branch pela porta de SCM — o caminho do spec-wave-agent, sem gh')
414
+ .argument('<acao>', 'open')
415
+ .requiredOption('--repo <owner/repo>', 'Repositório onde o PR nasce')
416
+ .requiredOption('--head <branch>', 'Branch do PR')
417
+ .option('--base <branch>', 'Branch de destino (default: a default do repositório)')
418
+ .option('--title <titulo>', 'Título do PR (default: o do --work-item no tracker)')
419
+ .option('--body <texto>', 'Corpo do PR')
420
+ .option('--body-file <arquivo>', 'Corpo lido de arquivo ("-" = stdin)')
421
+ .option('--work-item <n>', 'Item de trabalho que o PR implementa — dá o título quando --title falta')
422
+ .option('--hub <owner/repo>', 'Repositório do item de trabalho, quando o PR é de um repositório de código (default: --repo)')
423
+ .option('--draft', 'Abre como rascunho')
424
+ .option('--json', 'Imprime {url, number, created} em JSON')
425
+ .action(async (acao, options) => {
426
+ if (acao !== 'open') {
427
+ console.error(`Ação desconhecida: ${acao}. Use: spec-wave pr open`);
428
+ process.exit(1);
429
+ }
430
+ const { prOpen } = await import('./commands/pr.mjs');
431
+ await prOpen(options).catch(err => { console.error(err.message); process.exit(err.exitCode ?? 1); });
432
+ })
433
+ .addHelpText('after', `
434
+ Idempotente: se a branch já tem PR aberto, devolve esse (created=false) em vez de abrir outro.
435
+ Sem nada à frente da base, não abre PR e sai com código 2. O token de PR segue a mesma política
436
+ dos artefatos (SPEC_WAVE_PR_TOKEN / GH_PR_TOKEN, senão o da execução).`);
437
+
411
438
  program
412
439
  .command('qa-lead')
413
440
  .description('Orquestra o QA de uma trilha (milestone): prepara os planos (plan), executa o ciclo em containers paralelos (run) e reimprime relatórios (report)')
@@ -0,0 +1,89 @@
1
+ // `spec-wave pr open` — abre (ou reaproveita) o Pull Request de uma branch pela
2
+ // porta de SCM (RFC-008 P17).
3
+ //
4
+ // Existe para quem roda fora do fluxo de artefatos e ainda chamava o `gh`
5
+ // direto: o spec-wave-agent abre o PR da branch de trabalho de cada item, e o
6
+ // Fleet Job no sandbox do cliente roda o mesmo agente. Pela porta, o próximo
7
+ // provedor de SCM é um plugin da CLI — o agente não muda.
8
+ //
9
+ // Idempotente como `ensurePullRequest`: um relançamento (rodada incompleta,
10
+ // takeover por outro agente) devolve o PR que já existe em vez de abrir outro.
11
+ //
12
+ // Saída: a URL do PR no stdout (uma linha), ou `--json`. Sem nada a revisar
13
+ // (branch sem commit à frente da base), sai com código 2 — o chamador decide
14
+ // se isso é erro.
15
+
16
+ import { readFileSync } from 'node:fs';
17
+ import { resolveToken } from '../api/auth.mjs';
18
+ import { resolvePrToken } from '../lib/artifact-publish.mjs';
19
+ import { requireScm, requireTracker, resolveScmLink } from '../ports/index.mjs';
20
+
21
+ export const EXIT_NOTHING_TO_REVIEW = 2;
22
+
23
+ // "owner/repo" → { owner, repo }. O endereço ainda é o formato do GitHub
24
+ // (ver `resolveScmLink`); generalizá-lo é o bloco F da RFC-006.
25
+ export function parseRepoAddress(value, flag = '--repo') {
26
+ const m = /^([A-Za-z0-9_.-]+)\/([A-Za-z0-9_.-]+)$/.exec(String(value ?? '').trim());
27
+ if (!m) throw new Error(`${flag} precisa ser "owner/repo" (recebi "${value ?? ''}").`);
28
+ return { owner: m[1], repo: m[2] };
29
+ }
30
+
31
+ // Título do PR: o explícito; senão o do item de trabalho no tracker; senão um
32
+ // genérico. Falha do tracker não impede o PR.
33
+ export async function resolvePrTitle({ title, workItem, hub, tracker }) {
34
+ if (title) return title;
35
+ if (!workItem) throw new Error('Informe --title, ou --work-item para usar o título do item.');
36
+ const item = tracker ? await tracker.getWorkItem({ ref: String(workItem) }).catch(() => null) : null;
37
+ return item?.title?.trim() || `Implementação do item ${hub}#${workItem}`;
38
+ }
39
+
40
+ /**
41
+ * @param {object} opts
42
+ * @param {string} opts.repo onde o PR nasce ("owner/repo")
43
+ * @param {string} opts.head branch de trabalho
44
+ * @param {string} [opts.base] branch de destino; ausente = a default do repo
45
+ * @param {string} [opts.title]
46
+ * @param {string} [opts.body]
47
+ * @param {string} [opts.bodyFile] corpo lido de arquivo ("-" = stdin)
48
+ * @param {string|number} [opts.workItem] item de trabalho (para o título)
49
+ * @param {string} [opts.hub] repo do item ("owner/repo"); ausente = `repo`
50
+ * @param {boolean} [opts.draft]
51
+ * @param {boolean} [opts.json]
52
+ * @param {object} [deps] injeções para teste: `token`, `scm`, `tracker`, `out`
53
+ * @returns {Promise<{url: string|null, number: string|null, created: boolean}>}
54
+ */
55
+ export async function prOpen(opts, deps = {}) {
56
+ const { owner, repo } = parseRepoAddress(opts.repo);
57
+ const hub = opts.hub ? parseRepoAddress(opts.hub, '--hub') : { owner, repo };
58
+ if (!opts.head) throw new Error('--head (a branch do PR) é obrigatório.');
59
+ if (opts.body !== undefined && opts.bodyFile) throw new Error('Use --body ou --body-file, não os dois.');
60
+ const body = opts.bodyFile
61
+ ? readFileSync(opts.bodyFile === '-' ? 0 : opts.bodyFile, 'utf8')
62
+ : (opts.body ?? '');
63
+
64
+ const token = deps.token ?? (await resolveToken({ quiet: true }));
65
+ const scm = deps.scm ?? (await requireScm({
66
+ link: resolveScmLink({ owner, repo }), token, prToken: resolvePrToken(token),
67
+ }));
68
+ const tracker = opts.title || !opts.workItem
69
+ ? null
70
+ : deps.tracker ?? (await requireTracker({ token, owner: hub.owner, repo: hub.repo }).catch(() => null));
71
+ const title = await resolvePrTitle({
72
+ title: opts.title, workItem: opts.workItem, hub: `${hub.owner}/${hub.repo}`, tracker,
73
+ });
74
+ const base = opts.base || (await scm.defaultBranch());
75
+
76
+ const { pr, created } = await scm.ensurePullRequest({
77
+ branch: opts.head, base, title, body, draft: Boolean(opts.draft),
78
+ });
79
+ const result = { url: pr?.url ?? null, number: pr?.number ?? null, created: Boolean(created) };
80
+ const out = deps.out ?? process.stdout;
81
+ if (opts.json) out.write(`${JSON.stringify(result)}\n`);
82
+ else if (result.url) out.write(`${result.url}\n`);
83
+ if (!pr) {
84
+ const err = new Error(`"${opts.head}" não tem nada à frente de "${base}" em ${owner}/${repo} — nenhum PR a abrir.`);
85
+ err.exitCode = EXIT_NOTHING_TO_REVIEW;
86
+ throw err;
87
+ }
88
+ return result;
89
+ }
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "spec-wave",
3
3
  "displayName": "Spec Wave",
4
- "version": "1.6.0",
4
+ "version": "1.7.0",
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",