@spec-wave/cli 1.6.0 → 1.7.1
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
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)')
|
package/src/commands/doctor.mjs
CHANGED
|
@@ -897,8 +897,15 @@ async function checkAi(ctx) {
|
|
|
897
897
|
|
|
898
898
|
// Se o token permitir, confere os secrets do Actions no repo.
|
|
899
899
|
if (ctx.token && cfg?.owner && cfg?.repo) {
|
|
900
|
-
|
|
901
|
-
|
|
900
|
+
// Fato do `scm.verify({deep: true})` — o plugin coleta, o core julga. Chamar
|
|
901
|
+
// a API aqui era a última chamada crua que o bloco G deixou para trás.
|
|
902
|
+
const segredos = fatoDaPorta(ctx.scmVerify, 'automationSecretNames');
|
|
903
|
+
if (segredos.estado !== 'ok') {
|
|
904
|
+
notes.push(segredos.estado === 'ilegivel'
|
|
905
|
+
? 'Secrets do Actions não verificáveis com este token (requer admin no repo).'
|
|
906
|
+
: 'Secrets do Actions não verificáveis agora: a porta de scm não respondeu.');
|
|
907
|
+
} else {
|
|
908
|
+
const secretNames = segredos.valor;
|
|
902
909
|
// Dois modos de autenticação nos workflows: GitHub App da org
|
|
903
910
|
// (SPEC_WAVE_APP_ID + SPEC_WAVE_APP_PRIVATE_KEY, App antes do PAT) ou os
|
|
904
911
|
// PATs. Com a App presente, o GH_PROJECT_TOKEN vira fallback opcional.
|
|
@@ -929,12 +936,6 @@ async function checkAi(ctx) {
|
|
|
929
936
|
'que os tokens funcionam nem que têm o escopo necessário).'
|
|
930
937
|
);
|
|
931
938
|
}
|
|
932
|
-
} catch (err) {
|
|
933
|
-
if (err.status === 403) {
|
|
934
|
-
notes.push('Secrets do Actions não verificáveis com este token (403 — requer admin no repo).');
|
|
935
|
-
} else {
|
|
936
|
-
notes.push(`Secrets do Actions não verificáveis agora: ${err.message}`);
|
|
937
|
-
}
|
|
938
939
|
}
|
|
939
940
|
}
|
|
940
941
|
return { name, status, detail: notes.join('\n') };
|
|
@@ -35,7 +35,7 @@ import { loadArtifact } from '../lib/doc-source.mjs';
|
|
|
35
35
|
import { buildBugContext } from '../lib/bug-context.mjs';
|
|
36
36
|
import { slugify } from '../lib/slugify.mjs';
|
|
37
37
|
import { parseDependencies, orderStories, formatDependencyLine } from '../lib/dependencies.mjs';
|
|
38
|
-
import { STREAM_DIR_ENV, runStreamed, streamFileFor, withStreamJson } from '../lib/implement-stream.mjs';
|
|
38
|
+
import { STREAM_DIR_ENV, runStreamed, specKitEnv, streamFileFor, withStreamJson } from '../lib/implement-stream.mjs';
|
|
39
39
|
import { loadProjectConfig } from '../lib/board.mjs';
|
|
40
40
|
import { planBoardMoves, applyBoardMoves } from '../lib/implement-board.mjs';
|
|
41
41
|
import { markFeaturePrsReady } from '../lib/pr-ready.mjs';
|
|
@@ -1398,7 +1398,7 @@ async function writeContextAndRunSpecKit({
|
|
|
1398
1398
|
}
|
|
1399
1399
|
} else {
|
|
1400
1400
|
try {
|
|
1401
|
-
(deps.exec ?? execSync)(command, { stdio: 'inherit' });
|
|
1401
|
+
(deps.exec ?? execSync)(command, { stdio: 'inherit', env: specKitEnv(process.env) });
|
|
1402
1402
|
} catch (err) {
|
|
1403
1403
|
p.log.error(`spec-kit implement falhou: ${err.message}`);
|
|
1404
1404
|
process.exitCode = 1;
|
|
@@ -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
|
+
}
|
|
@@ -25,6 +25,30 @@ import { createInterface } from 'node:readline';
|
|
|
25
25
|
|
|
26
26
|
export const STREAM_DIR_ENV = 'SPEC_WAVE_STREAM_DIR';
|
|
27
27
|
|
|
28
|
+
// Token da assinatura para o agente interno (RFC-008). O Claude Code não
|
|
29
|
+
// repassa o próprio CLAUDE_CODE_OAUTH_TOKEN aos comandos do Bash dele, então,
|
|
30
|
+
// sob um executor Claude (Fleet Job em modo assinatura), o `claude -p` do
|
|
31
|
+
// spec-kit nascia sem credencial ("Not logged in"). Quem monta o ambiente (o
|
|
32
|
+
// fleet-runner) repete o token neste nome, e a CLI o devolve SÓ ao filho.
|
|
33
|
+
export const SUBSCRIPTION_TOKEN_ENV = 'SPEC_WAVE_CLAUDE_OAUTH_TOKEN';
|
|
34
|
+
|
|
35
|
+
/**
|
|
36
|
+
* Ambiente do comando do spec-kit (função PURA). Com o token no nome da
|
|
37
|
+
* spec-wave e sem o do Claude Code, o filho recebe o do Claude Code; o nome da
|
|
38
|
+
* spec-wave não segue adiante — o agente interno não precisa dele, e cada
|
|
39
|
+
* nível a mais que o enxerga é exposição sem motivo.
|
|
40
|
+
*
|
|
41
|
+
* @param {Record<string, string|undefined>} env
|
|
42
|
+
* @returns {Record<string, string|undefined>}
|
|
43
|
+
*/
|
|
44
|
+
export function specKitEnv(env) {
|
|
45
|
+
const out = { ...env };
|
|
46
|
+
const alias = out[SUBSCRIPTION_TOKEN_ENV];
|
|
47
|
+
delete out[SUBSCRIPTION_TOKEN_ENV];
|
|
48
|
+
if (alias && !out.CLAUDE_CODE_OAUTH_TOKEN) out.CLAUDE_CODE_OAUTH_TOKEN = alias;
|
|
49
|
+
return out;
|
|
50
|
+
}
|
|
51
|
+
|
|
28
52
|
// Acrescenta o formato stream-json ao Claude Code quando o comando não escolhe
|
|
29
53
|
// formato. Só para `claude`: as flags não existem nos outros agentes.
|
|
30
54
|
// Comando composto (pipe, `;`, `&&`, redirecionamento) fica como está: as
|
|
@@ -62,10 +86,10 @@ export function streamFileFor(dir, issueNumber) {
|
|
|
62
86
|
// Roda o comando (via shell, como o execSync de sempre) gravando cada linha do
|
|
63
87
|
// stdout em `streamFile` e ecoando o resumo. stdin e stderr continuam herdados.
|
|
64
88
|
// Resolve com o exit code (1 quando morto por sinal).
|
|
65
|
-
export function runStreamed(command, { streamFile, cwd, write = (s) => process.stdout.write(s) }) {
|
|
89
|
+
export function runStreamed(command, { streamFile, cwd, env = process.env, write = (s) => process.stdout.write(s) }) {
|
|
66
90
|
mkdirSync(path.dirname(streamFile), { recursive: true });
|
|
67
91
|
return new Promise((resolve, reject) => {
|
|
68
|
-
const child = spawn(command, { shell: true, cwd, stdio: ['inherit', 'pipe', 'inherit'] });
|
|
92
|
+
const child = spawn(command, { shell: true, cwd, env: specKitEnv(env), stdio: ['inherit', 'pipe', 'inherit'] });
|
|
69
93
|
const lines = createInterface({ input: child.stdout });
|
|
70
94
|
lines.on('line', (line) => {
|
|
71
95
|
// Arquivo primeiro: é a fonte da tela ao vivo. Falha de disco não pode
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "spec-wave",
|
|
3
3
|
"displayName": "Spec Wave",
|
|
4
|
-
"version": "1.
|
|
4
|
+
"version": "1.7.1",
|
|
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",
|