@spec-wave/cli 1.3.0 → 1.4.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.3.0",
3
+ "version": "1.4.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": {
@@ -23,7 +23,8 @@ import path from 'node:path';
23
23
 
24
24
  import { resolveToken } from '../api/auth.mjs';
25
25
  import { createGithubTracker } from '../plugins/tracker-github-projects/index.mjs';
26
- import { createGithubScm, githubLink } from '../plugins/scm-github/index.mjs';
26
+ import { createGithubScm } from '../plugins/scm-github/index.mjs';
27
+ import { resolveScmLink } from '../ports/index.mjs';
27
28
  import { CONFIG_FILE } from '../config.mjs';
28
29
  import { detectIssueType } from '../lib/issue-type.mjs';
29
30
  import { featureDocPaths } from '../lib/doc-paths.mjs';
@@ -96,7 +97,7 @@ export async function audit({ milestone: milestoneArg, critique = false, json =
96
97
  }
97
98
 
98
99
  const tracker = deps.tracker ?? createGithubTracker({ token, owner, repo });
99
- const scm = deps.scm ?? createGithubScm({ link: githubLink({ owner, repo }), token });
100
+ const scm = deps.scm ?? createGithubScm({ link: resolveScmLink({ owner, repo }), token });
100
101
 
101
102
  const s = json ? null : p.spinner();
102
103
  s?.start('Montando o catálogo de Features...');
@@ -1,7 +1,8 @@
1
1
  import { appendFileSync } from 'node:fs';
2
2
  import { resolveToken } from '../api/auth.mjs';
3
3
  import { createGithubTracker } from '../plugins/tracker-github-projects/index.mjs';
4
- import { createGithubScm, githubLink } from '../plugins/scm-github/index.mjs';
4
+ import { createGithubScm } from '../plugins/scm-github/index.mjs';
5
+ import { resolveScmLink } from '../ports/index.mjs';
5
6
 
6
7
  // WorkItem → a forma `{number, nodeId, title, labels}` que este arquivo usa nos
7
8
  // mapas de Stories/Tasks. Um lugar só, no ponto de leitura.
@@ -230,7 +231,7 @@ export async function codeReview({ prNumber, prRepo: prRepoOpt, resolveOnly = fa
230
231
  // Porta do repositório DO PR — `--pr-repo` pode apontar para um repo de
231
232
  // código, e o número de PR colide entre repositórios.
232
233
  const prScm = deps.scm ?? createGithubScm({
233
- link: githubLink({
234
+ link: resolveScmLink({
234
235
  owner: prRepo.owner, repo: prRepo.repo, role: sameRepo(prRepo, hub) ? 'hub' : 'code',
235
236
  }),
236
237
  token,
@@ -19,7 +19,8 @@
19
19
  import { execSync } from 'node:child_process';
20
20
  import { resolveToken } from '../api/auth.mjs';
21
21
  import { createGithubTracker } from '../plugins/tracker-github-projects/index.mjs';
22
- import { createGithubScm, githubLink } from '../plugins/scm-github/index.mjs';
22
+ import { createGithubScm } from '../plugins/scm-github/index.mjs';
23
+ import { resolveScmLink } from '../ports/index.mjs';
23
24
  import { codeRepositories, repoLabel, repoLabelSpec } from '../lib/repo-role.mjs';
24
25
 
25
26
  import { openTracker, advanceToStage } from '../lib/board.mjs';
@@ -267,8 +268,10 @@ function formatItemsLintWarning(texts) {
267
268
  * catch: o aviso some e vira unhandled rejection.
268
269
  */
269
270
  async function publishFile(ctx, { doc, pathRel, content, nextLabel = null, extraFiles = [] }) {
271
+ const { deps = {} } = ctx;
270
272
  const { token, owner, repo, issue, issueNumber, base } = ctx;
271
273
  const published = await publishArtifact({
274
+ scm: deps.scm ?? null,
272
275
  token, owner, repo, doc,
273
276
  issueNumber: parseInt(issueNumber, 10),
274
277
  issueTitle: issue?.title || '',
@@ -309,6 +312,7 @@ export function codeReposPromptSection(config) {
309
312
  }
310
313
 
311
314
  async function draftDecomposition(ctx) {
315
+ const { deps = {} } = ctx;
312
316
  const {
313
317
  token, owner, repo, tracker, issue, issueNumber, type, labels, usage, root, runMode,
314
318
  docRel, dirRel, base,
@@ -317,6 +321,7 @@ async function draftDecomposition(ctx) {
317
321
  const kind = DECOMPOSE_TARGETS[type]; // Feature → 'stories'; RFC → 'tasks'
318
322
 
319
323
  const ler = (doc, pathRel) => loadArtifact({
324
+ scm: deps.scm ?? null,
320
325
  token, owner, repo, root, pathRel, doc, issueNumber: number, base,
321
326
  });
322
327
 
@@ -392,7 +397,7 @@ async function draftDecomposition(ctx) {
392
397
  type === 'RFC' ? 'decompose/rfc' : 'decompose/feature',
393
398
  { cwd: root },
394
399
  );
395
- const generated = parseModelJson(await generateDocument(
400
+ const generated = parseModelJson(await (deps.gerarDocumento ?? generateDocument)(
396
401
  systemPromptWithTools(decomposePrompt),
397
402
  userContent,
398
403
  { action: 'decompose', labels, usage, maxTurns: decomposePrompt.maxTurns, issueNumber, cwd: root }
@@ -482,6 +487,7 @@ async function draftDecomposition(ctx) {
482
487
  try {
483
488
  critique = await runCritique({
484
489
  kind: 'stories',
490
+ gerarEstruturado: deps.gerarEstruturado,
485
491
  decisions,
486
492
  spec: specContent,
487
493
  plan: planContent,
@@ -578,10 +584,12 @@ async function finishDraft(
578
584
  // ---------------------------------------------------------------------------
579
585
 
580
586
  async function applyDecomposition(ctx) {
587
+ const { deps = {} } = ctx;
581
588
  const { token, owner, repo, tracker, issueNumber, docRel, root, base } = ctx;
582
589
  const number = parseInt(issueNumber, 10);
583
590
 
584
591
  const rascunho = await loadArtifact({
592
+ scm: deps.scm ?? null,
585
593
  token, owner, repo, root, pathRel: docRel,
586
594
  doc: 'decomposition', issueNumber: number, base,
587
595
  });
@@ -1088,7 +1096,7 @@ async function createTasksFromDoc(ctx, doc) {
1088
1096
  }
1089
1097
 
1090
1098
  // Projeto + campos Etapa/Status do board (reutilizados em todos os itens).
1091
- async function resolveBoard({ token, projectToken, owner, repo, root }, { strict = false } = {}) {
1099
+ async function resolveBoard({ token, projectToken, owner, repo, root, deps = {} }, { strict = false } = {}) {
1092
1100
  const { tracker, error: projectError } = openTracker({
1093
1101
  token, projectToken, owner, repo, cwd: root || process.cwd(),
1094
1102
  });
@@ -1170,7 +1178,17 @@ export function renderApplyFailureComment({ trigger, message, createdItems = [],
1170
1178
  // `apply` SEM default: `undefined` significa "ninguém decidiu" e é o que faz o
1171
1179
  // fallback por label valer no workflow. Um default `false` aqui reintroduziria
1172
1180
  // o bug, porque a CLI passa `undefined` quando a flag não é usada.
1173
- export async function decompose({ issueNumber, apply }) {
1181
+ /**
1182
+ * @param {object} params
1183
+ * @param {string|number} params.issueNumber
1184
+ * @param {boolean} [params.apply]
1185
+ * @param {object} [params.deps] seam de teste — `tracker`, `scm`,
1186
+ * `gerarDocumento` e `gerarEstruturado`. Viaja dentro do `ctx`, que já é o
1187
+ * objeto que atravessa as funções internas (`draftDecomposition`,
1188
+ * `applyDecomposition`, `publishFile`, `resolveBoard`): pendurá-lo ali é um
1189
+ * ponto de costura em vez de quatro.
1190
+ */
1191
+ export async function decompose({ issueNumber, apply, deps = {} }) {
1174
1192
  const token = await resolveToken();
1175
1193
  // PROJECT_TOKEN deve ter scope "project" para atualizar GitHub Projects v2.
1176
1194
  // Fallback para GITHUB_TOKEN (só funciona em repos pessoais sem org restrictions).
@@ -1180,7 +1198,7 @@ export async function decompose({ issueNumber, apply }) {
1180
1198
  console.log(`Modo de execução: ${runMode}`);
1181
1199
 
1182
1200
  const number = parseInt(issueNumber, 10);
1183
- const tracker = createGithubTracker({ token, projectToken, owner, repo });
1201
+ const tracker = deps.tracker ?? createGithubTracker({ token, projectToken, owner, repo });
1184
1202
  const issue = await tracker.getWorkItem({ ref: { key: String(number) } });
1185
1203
  const type = detectIssueType(issue);
1186
1204
  const labels = labelNames(issue);
@@ -1244,7 +1262,7 @@ export async function decompose({ issueNumber, apply }) {
1244
1262
  // Branch base: é dela que os documentos são lidos quando não estão no clone, e
1245
1263
  // é contra ela que o PR do rascunho é aberto. Best-effort — sem ela a leitura
1246
1264
  // cai para o default da API, que é o mesmo lugar.
1247
- const base = await createGithubScm({ link: githubLink({ owner, repo }), token })
1265
+ const base = await (deps.scm ?? createGithubScm({ link: resolveScmLink({ owner, repo }), token }))
1248
1266
  .defaultBranch().catch(() => null);
1249
1267
 
1250
1268
  // Comentários só são necessários no rascunho (contador de tentativas).
@@ -1262,6 +1280,7 @@ export async function decompose({ issueNumber, apply }) {
1262
1280
  const usageEntries = [];
1263
1281
  const ctx = {
1264
1282
  token, projectToken, owner, repo, tracker, issue, issueNumber, type, labels, comments,
1283
+ deps,
1265
1284
  root, runMode, docRel: `${docRel}/${DECOMPOSITION_FILE}`,
1266
1285
  dirRel: docRel,
1267
1286
  base,
@@ -1301,6 +1320,6 @@ export async function decompose({ issueNumber, apply }) {
1301
1320
  throw err;
1302
1321
  } finally {
1303
1322
  // Best-effort: nunca propaga erro (ver recordUsage).
1304
- await recordUsage({ token, owner, repo, issueNumber: number, entries: usageEntries });
1323
+ await recordUsage({ token, owner, repo, tracker, issueNumber: number, entries: usageEntries });
1305
1324
  }
1306
1325
  }
@@ -48,14 +48,22 @@ function isSpecWaveComment(body) {
48
48
  return t.includes('<!-- spec-wave:') || t.includes('**(spec-wave)**') || t.includes('(spec-wave)');
49
49
  }
50
50
 
51
- export async function generateBug({ issueNumber }) {
51
+ /**
52
+ * @param {object} params
53
+ * @param {string|number} params.issueNumber
54
+ * @param {object} [params.deps] seam de teste — `tracker`, `scm` e
55
+ * `gerarDocumento`. Ver a nota em `generate-spec.mjs`: sem a costura de IA não
56
+ * existe teste de caminho, porque a primeira coisa útil que o comando faz é
57
+ * pagar uma chamada de modelo.
58
+ */
59
+ export async function generateBug({ issueNumber, deps = {} }) {
52
60
  const token = await resolveToken();
53
61
  // Mesmo contexto dos outros geradores: GITHUB_REPOSITORY quando existe, o
54
62
  // `.spec-wave.json` quando não. Este comando exigia a env crua e morria fora
55
63
  // do runner mandando exportá-la — dentro de um repo que já sabe seu owner/repo.
56
64
  const { owner, repo, root, config, mode } = resolveFlowContext({ command: 'generate-bug', requireRoot: true });
57
65
  const n = parseInt(issueNumber, 10);
58
- const tracker = createGithubTracker({ token, owner, repo });
66
+ const tracker = deps.tracker ?? createGithubTracker({ token, owner, repo });
59
67
  const ref = { key: String(n) };
60
68
 
61
69
  console.log(`Buscando issue #${n}...`);
@@ -103,7 +111,7 @@ export async function generateBug({ issueNumber }) {
103
111
  console.log(`Gerando bug.md para: ${issue.title}`);
104
112
  const bugPrompt = loadPrompt('bug', { cwd: root });
105
113
  const systemPrompt = systemPromptWithTools(bugPrompt);
106
- const { content: bruto } = await generateDocument(systemPrompt, userContent, {
114
+ const { content: bruto } = await (deps.gerarDocumento ?? generateDocument)(systemPrompt, userContent, {
107
115
  action: 'bug',
108
116
  issueNumber, cwd: root,
109
117
  maxTurns: bugPrompt.maxTurns,
@@ -122,7 +130,7 @@ export async function generateBug({ issueNumber }) {
122
130
  // existia aqui commitava direto na branch default sem sequer escopar o
123
131
  // commit ao arquivo — varria para dentro qualquer coisa no index.
124
132
  const published = await publishArtifact({
125
- token, owner, repo,
133
+ token, owner, repo, scm: deps.scm ?? null,
126
134
  doc: 'bug',
127
135
  issueNumber: n,
128
136
  issueTitle: issue.title,
@@ -140,6 +148,7 @@ export async function generateBug({ issueNumber }) {
140
148
  const critique = await critiqueBugDoc({
141
149
  tracker, issueNumber: n, issue,
142
150
  bugDoc: content, report, labels: issueLabels, cwd: root, usage: usageEntries,
151
+ gerarEstruturado: deps.gerarEstruturado,
143
152
  });
144
153
 
145
154
  await tracker.addComment({
@@ -170,14 +179,14 @@ export async function generateBug({ issueNumber }) {
170
179
  }).catch(() => {});
171
180
  throw err;
172
181
  } finally {
173
- await recordUsage({ token, owner, repo, issueNumber: n, entries: usageEntries });
182
+ await recordUsage({ token, owner, repo, tracker: deps.tracker ?? null, issueNumber: n, entries: usageEntries });
174
183
  }
175
184
  }
176
185
 
177
186
  // Roda a crítica e reflete o veredito em labels/comentário. Best-effort: uma
178
187
  // falha da crítica não invalida o documento já commitado.
179
188
  async function critiqueBugDoc({
180
- tracker, issueNumber, issue, bugDoc, report, labels, cwd, usage,
189
+ tracker, issueNumber, issue, bugDoc, report, labels, cwd, usage, gerarEstruturado,
181
190
  }) {
182
191
  const ref = { key: String(issueNumber) };
183
192
  try {
@@ -197,6 +206,7 @@ async function critiqueBugDoc({
197
206
 
198
207
  const result = await runCritique({
199
208
  kind: 'bug', bugDoc, bugReport: report, attempt, labels, usage, cwd,
209
+ gerarEstruturado,
200
210
  });
201
211
  await tracker.addComment({ ref, body: result.markdown });
202
212
  if (result.grave) {
@@ -2,7 +2,8 @@ import path from 'node:path';
2
2
  import { readFileSync, existsSync } from 'node:fs';
3
3
  import { resolveToken } from '../api/auth.mjs';
4
4
  import { createGithubTracker } from '../plugins/tracker-github-projects/index.mjs';
5
- import { createGithubScm, githubLink } from '../plugins/scm-github/index.mjs';
5
+ import { createGithubScm } from '../plugins/scm-github/index.mjs';
6
+ import { resolveScmLink } from '../ports/index.mjs';
6
7
  import { detectIssueType } from '../lib/issue-type.mjs';
7
8
  import {
8
9
  allowsSpecPlan, SPEC_PLAN_EXCLUDED_TYPES, TARGET_LANGUAGE,
@@ -55,7 +56,7 @@ function formatLintWarning(lintFindings) {
55
56
  * Nunca lança: o plan já foi commitado e o humano precisa dele para corrigir.
56
57
  */
57
58
  async function critiquePlan({
58
- tracker, issueNumber, spec, plan, techContextYaml, labels, config, usage,
59
+ tracker, issueNumber, spec, plan, techContextYaml, labels, config, usage, gerarEstruturado,
59
60
  }) {
60
61
  const ref = { key: String(issueNumber) };
61
62
  if (labels.includes(LABEL_NEEDS_HUMAN)) {
@@ -94,7 +95,7 @@ async function critiquePlan({
94
95
  try {
95
96
  critique = await runCritique({
96
97
  kind: 'plan', spec, plan, techContextYaml, attempt, maxAttempts, model, labels, usage,
97
- decisions,
98
+ decisions, gerarEstruturado,
98
99
  });
99
100
  } catch (err) {
100
101
  console.warn(`Crítica adversarial não concluiu: ${err.message}`);
@@ -135,15 +136,23 @@ async function critiquePlan({
135
136
  await tracker.removeTag({ ref, tag: LABEL_CRITIQUE_FAILED }).catch(() => {});
136
137
  }
137
138
 
138
- export async function generatePlan({ issueNumber }) {
139
+ /**
140
+ * @param {object} params
141
+ * @param {string|number} params.issueNumber
142
+ * @param {object} [params.deps] seam de teste — `tracker`, `scm` e
143
+ * `gerarDocumento`. Ver a nota em `generate-spec.mjs`: sem a costura de IA não
144
+ * existe teste de caminho, porque a primeira coisa útil que o comando faz é
145
+ * pagar uma chamada de modelo.
146
+ */
147
+ export async function generatePlan({ issueNumber, deps = {} }) {
139
148
  const token = await resolveToken();
140
149
  // Roda nos dois modos: no Action (disparado por label) e na sessão local.
141
150
  const { owner, repo, root, config, mode } = resolveFlowContext({ command: 'generate-plan', requireRoot: true });
142
151
  console.log(`Modo de execução: ${mode}`);
143
152
 
144
153
  console.log(`Buscando issue #${issueNumber}...`);
145
- const tracker = createGithubTracker({ token, owner, repo });
146
- const scm = createGithubScm({ link: githubLink({ owner, repo }), token });
154
+ const tracker = deps.tracker ?? createGithubTracker({ token, owner, repo });
155
+ const scm = deps.scm ?? createGithubScm({ link: resolveScmLink({ owner, repo }), token });
147
156
  const ref = { key: String(parseInt(issueNumber, 10)) };
148
157
  const issue = await tracker.getWorkItem({ ref });
149
158
 
@@ -175,7 +184,7 @@ export async function generatePlan({ issueNumber }) {
175
184
  const base = await scm.defaultBranch().catch(() => null);
176
185
  const spec = await loadArtifact({
177
186
  token, owner, repo, root, pathRel: specRel, doc: 'spec',
178
- issueNumber: parseInt(issueNumber, 10), base,
187
+ issueNumber: parseInt(issueNumber, 10), base, scm,
179
188
  });
180
189
 
181
190
  // Portão duro. Este comando TOLERAVA a spec ausente e seguia com um
@@ -226,7 +235,7 @@ export async function generatePlan({ issueNumber }) {
226
235
  console.log(`Gerando plan.md para: ${issue.title}`);
227
236
  const planPrompt = loadPrompt('plan', { cwd: root });
228
237
  const systemPrompt = systemPromptWithTools(planPrompt);
229
- const { content: bruto, lintFindings } = await generateDocument(systemPrompt, userContent, {
238
+ const { content: bruto, lintFindings } = await (deps.gerarDocumento ?? generateDocument)(systemPrompt, userContent, {
230
239
  action: 'plan',
231
240
  issueNumber, cwd: root,
232
241
  maxTurns: planPrompt.maxTurns,
@@ -241,7 +250,7 @@ export async function generatePlan({ issueNumber }) {
241
250
  const content = unwrapGeneratedDoc(bruto);
242
251
 
243
252
  const published = await publishArtifact({
244
- token, owner, repo,
253
+ token, owner, repo, scm: deps.scm ?? null,
245
254
  doc: 'plan',
246
255
  issueNumber: parseInt(issueNumber, 10),
247
256
  issueTitle: issue.title,
@@ -275,6 +284,7 @@ export async function generatePlan({ issueNumber }) {
275
284
  tracker, issueNumber: parseInt(issueNumber, 10),
276
285
  spec: specContent, plan: content, techContextYaml: tech.yaml,
277
286
  labels: issueLabels, config, usage: usageEntries,
287
+ gerarEstruturado: deps.gerarEstruturado,
278
288
  });
279
289
 
280
290
  console.log(`plan.md publicado em ${published.branch} (${fileRel}).`);
@@ -296,7 +306,7 @@ export async function generatePlan({ issueNumber }) {
296
306
  throw err;
297
307
  } finally {
298
308
  // Best-effort: nunca propaga erro (ver recordUsage).
299
- await recordUsage({ token, owner, repo, issueNumber: parseInt(issueNumber, 10), entries: usageEntries });
309
+ await recordUsage({ token, owner, repo, tracker: deps.tracker ?? null, issueNumber: parseInt(issueNumber, 10), entries: usageEntries });
300
310
  }
301
311
  }
302
312
 
@@ -404,7 +414,7 @@ export async function critique({ issueNumber, file, kind, failOnGrave = false })
404
414
 
405
415
  const n = parseInt(issueNumber, 10);
406
416
  const tracker = createGithubTracker({ token, owner, repo });
407
- const scm = createGithubScm({ link: githubLink({ owner, repo }), token });
417
+ const scm = createGithubScm({ link: resolveScmLink({ owner, repo }), token });
408
418
  const ref = { key: String(n) };
409
419
  const issue = await tracker.getWorkItem({ ref });
410
420
  const type = detectIssueType(issue);
@@ -13,7 +13,8 @@
13
13
 
14
14
  import { resolveToken } from '../api/auth.mjs';
15
15
  import { createGithubTracker } from '../plugins/tracker-github-projects/index.mjs';
16
- import { createGithubScm, githubLink } from '../plugins/scm-github/index.mjs';
16
+ import { createGithubScm } from '../plugins/scm-github/index.mjs';
17
+ import { resolveScmLink } from '../ports/index.mjs';
17
18
  import { detectIssueType } from '../lib/issue-type.mjs';
18
19
  import { generateDocument } from '../lib/claude.mjs';
19
20
  import { unwrapGeneratedDoc } from '../lib/unwrap-doc.mjs';
@@ -64,14 +65,22 @@ async function resolveParentFeature(tracker, startRef) {
64
65
  return null;
65
66
  }
66
67
 
67
- export async function generateQaPlan({ issueNumber }) {
68
+ /**
69
+ * @param {object} params
70
+ * @param {string|number} params.issueNumber
71
+ * @param {object} [params.deps] seam de teste — `tracker`, `scm` e
72
+ * `gerarDocumento`. Ver a nota em `generate-spec.mjs`: sem a costura de IA não
73
+ * existe teste de caminho, porque a primeira coisa útil que o comando faz é
74
+ * pagar uma chamada de modelo.
75
+ */
76
+ export async function generateQaPlan({ issueNumber, deps = {} }) {
68
77
  const token = await resolveToken();
69
78
  const { owner, repo, mode: runMode } = resolveFlowContext({ command: 'generate-qa-plan' });
70
79
  console.log(`Modo de execução: ${runMode}`);
71
80
 
72
81
  const number = parseInt(issueNumber, 10);
73
- const tracker = createGithubTracker({ token, owner, repo });
74
- const scm = createGithubScm({ link: githubLink({ owner, repo }), token });
82
+ const tracker = deps.tracker ?? createGithubTracker({ token, owner, repo });
83
+ const scm = deps.scm ?? createGithubScm({ link: resolveScmLink({ owner, repo }), token });
75
84
  const ref = { key: String(number) };
76
85
  const issue = await tracker.getWorkItem({ ref });
77
86
  const type = detectIssueType(issue);
@@ -137,7 +146,7 @@ export async function generateQaPlan({ issueNumber }) {
137
146
  const base = await scm.defaultBranch().catch(() => null);
138
147
 
139
148
  const ler = (doc, pathRel) => loadArtifact({
140
- token, owner, repo, root, pathRel, doc, issueNumber: number, base,
149
+ token, owner, repo, root, pathRel, doc, issueNumber: number, base, scm,
141
150
  });
142
151
 
143
152
  // ── spec.md e plan.md são a matéria-prima (spec §6.1 passo 3) ──────────────
@@ -207,7 +216,7 @@ export async function generateQaPlan({ issueNumber }) {
207
216
  try {
208
217
  await runDraftOrCritique({
209
218
  token, owner, repo, tracker, scm, ref, issue, number, labels, config, root, runMode,
210
- dirRel, docRel, base, spec, plan, stories, usage: usageEntries, ler,
219
+ dirRel, docRel, base, spec, plan, stories, usage: usageEntries, ler, deps,
211
220
  });
212
221
  } catch (err) {
213
222
  if (!err.blocked) {
@@ -223,14 +232,14 @@ export async function generateQaPlan({ issueNumber }) {
223
232
  }
224
233
  throw err;
225
234
  } finally {
226
- await recordUsage({ token, owner, repo, issueNumber: number, entries: usageEntries });
235
+ await recordUsage({ token, owner, repo, tracker: deps.tracker ?? null, issueNumber: number, entries: usageEntries });
227
236
  }
228
237
  }
229
238
 
230
239
  async function runDraftOrCritique(ctx) {
231
240
  const {
232
241
  token, owner, repo, tracker, scm, ref, issue, number, labels, config, root, runMode,
233
- dirRel, docRel, base, spec, plan, stories, usage, ler,
242
+ dirRel, docRel, base, spec, plan, stories, usage, ler, deps = {},
234
243
  } = ctx;
235
244
  // O resto da função chama a issue de `issueNumber` desde antes das portas.
236
245
  const issueNumber = number;
@@ -266,7 +275,7 @@ async function runDraftOrCritique(ctx) {
266
275
  JSON.stringify(payload, null, 2);
267
276
 
268
277
  const qaPrompt = loadPrompt('qa', { cwd: root });
269
- const { content: bruto } = await generateDocument(
278
+ const { content: bruto } = await (deps.gerarDocumento ?? generateDocument)(
270
279
  systemPromptWithTools(qaPrompt),
271
280
  userContent,
272
281
  {
@@ -290,7 +299,7 @@ async function runDraftOrCritique(ctx) {
290
299
  scenarios: gerado.scenarios.map(s => ({ story: s.story, body: s.body })),
291
300
  });
292
301
  publicado = await publishArtifact({
293
- token, owner, repo, doc: 'qa-plan',
302
+ token, owner, repo, scm: deps.scm ?? null, doc: 'qa-plan',
294
303
  issueNumber: number, issueTitle: issue.title, issueUrl: issue.ref.url,
295
304
  pathRel: docRel, content: markdown, base,
296
305
  });
@@ -380,6 +389,7 @@ async function runDraftOrCritique(ctx) {
380
389
  qaPlan: markdown,
381
390
  decisions,
382
391
  attempt, maxAttempts, model, labels, usage, cwd: root || undefined,
392
+ gerarEstruturado: deps.gerarEstruturado,
383
393
  });
384
394
  } catch (err) {
385
395
  // O verde do QA é automático (D-QA3), então o portão do plano não pode ser
@@ -29,14 +29,24 @@ function formatLintWarning(lintFindings) {
29
29
  // bloco `requires-tools`: o `generateDocument` entrega Read/Glob/Grep ao modelo,
30
30
  // e é esse bloco que o ensina a explorar o repositório e a parar de explorar.
31
31
 
32
- export async function generateSpec({ issueNumber }) {
32
+ /**
33
+ * @param {object} params
34
+ * @param {string|number} params.issueNumber
35
+ * @param {object} [params.deps] seam de teste — `tracker`, `scm` e
36
+ * `gerarDocumento`. A costura de IA é a que distingue estes comandos dos 12
37
+ * do PR #134: sem ela não há teste de caminho possível, porque a primeira
38
+ * coisa que o comando faz de útil é pagar uma chamada de modelo.
39
+ */
40
+ export async function generateSpec({ issueNumber, deps = {} }) {
33
41
  const token = await resolveToken();
34
42
  // Roda nos dois modos: no Action (disparado por label) e na sessão local.
35
43
  const { owner, repo, root, mode } = resolveFlowContext({ command: 'generate-spec', requireRoot: true });
36
44
  console.log(`Modo de execução: ${mode}`);
37
45
 
46
+ const gerar = deps.gerarDocumento ?? generateDocument;
47
+
38
48
  console.log(`Buscando issue #${issueNumber}...`);
39
- const tracker = createGithubTracker({ token, owner, repo });
49
+ const tracker = deps.tracker ?? createGithubTracker({ token, owner, repo });
40
50
  const ref = { key: String(issueNumber) };
41
51
  const issue = await tracker.getWorkItem({ ref });
42
52
 
@@ -83,7 +93,7 @@ export async function generateSpec({ issueNumber }) {
83
93
  console.log(`Gerando spec.md para: ${issue.title}`);
84
94
  const specPrompt = loadPrompt('spec', { cwd: root });
85
95
  const systemPrompt = systemPromptWithTools(specPrompt);
86
- const { content: bruto, lintFindings } = await generateDocument(systemPrompt, userContent, {
96
+ const { content: bruto, lintFindings } = await gerar(systemPrompt, userContent, {
87
97
  action: 'spec',
88
98
  issueNumber, cwd: root,
89
99
  maxTurns: specPrompt.maxTurns,
@@ -98,7 +108,7 @@ export async function generateSpec({ issueNumber }) {
98
108
  const content = unwrapGeneratedDoc(bruto);
99
109
 
100
110
  const published = await publishArtifact({
101
- token, owner, repo,
111
+ token, owner, repo, scm: deps.scm ?? null,
102
112
  doc: 'spec',
103
113
  issueNumber: parseInt(issueNumber, 10),
104
114
  issueTitle: issue.title,
@@ -145,6 +155,9 @@ export async function generateSpec({ issueNumber }) {
145
155
  throw err;
146
156
  } finally {
147
157
  // Best-effort: nunca propaga erro (ver recordUsage).
148
- await recordUsage({ token, owner, repo, issueNumber: parseInt(issueNumber, 10), entries: usageEntries });
158
+ await recordUsage({
159
+ token, owner, repo, tracker: deps.tracker ?? null,
160
+ issueNumber: parseInt(issueNumber, 10), entries: usageEntries,
161
+ });
149
162
  }
150
163
  }