@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
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@spec-wave/cli",
3
- "version": "1.6.0",
3
+ "version": "1.7.1",
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)')
@@ -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
- try {
901
- const secretNames = await listActionsSecretNames(ctx.token, cfg.owner, cfg.repo);
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.6.0",
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",