@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 +1 -1
- package/src/cli.mjs +27 -0
- package/src/commands/pr.mjs +89 -0
- package/src/plugin/.claude-plugin/plugin.json +1 -1
package/package.json
CHANGED
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.
|
|
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",
|