@spec-wave/cli 1.3.0 → 1.5.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.
Files changed (59) hide show
  1. package/package.json +1 -1
  2. package/protocol/scm.v1.json +154 -0
  3. package/protocol/tracker.v1.json +175 -0
  4. package/src/api/github-rest.mjs +109 -0
  5. package/src/commands/audit.mjs +3 -4
  6. package/src/commands/code-review.mjs +11 -6
  7. package/src/commands/decompose.mjs +29 -9
  8. package/src/commands/doctor.mjs +389 -220
  9. package/src/commands/generate-bug.mjs +17 -7
  10. package/src/commands/generate-plan.mjs +21 -13
  11. package/src/commands/generate-qa-plan.mjs +19 -11
  12. package/src/commands/generate-spec.mjs +19 -6
  13. package/src/commands/implement.mjs +105 -49
  14. package/src/commands/init.mjs +36 -6
  15. package/src/commands/issue.mjs +6 -2
  16. package/src/commands/merge.mjs +31 -18
  17. package/src/commands/mode.mjs +18 -10
  18. package/src/commands/move.mjs +3 -3
  19. package/src/commands/order.mjs +30 -20
  20. package/src/commands/preflight.mjs +10 -5
  21. package/src/commands/qa-lead.mjs +41 -31
  22. package/src/commands/qa-run.mjs +83 -55
  23. package/src/commands/qa.mjs +10 -6
  24. package/src/commands/refresh.mjs +6 -3
  25. package/src/commands/repair-stage.mjs +1 -1
  26. package/src/commands/repo.mjs +7 -7
  27. package/src/commands/run.mjs +7 -4
  28. package/src/commands/story.mjs +3 -3
  29. package/src/commands/task.mjs +3 -3
  30. package/src/commands/triage.mjs +3 -3
  31. package/src/commands/uninstall.mjs +14 -5
  32. package/src/commands/update.mjs +47 -19
  33. package/src/commands/validate.mjs +3 -4
  34. package/src/commands/workspace.mjs +2 -2
  35. package/src/lib/artifact-publish.mjs +4 -3
  36. package/src/lib/board.mjs +22 -24
  37. package/src/lib/config-ports.mjs +114 -0
  38. package/src/lib/critique.mjs +11 -1
  39. package/src/lib/doc-source.mjs +16 -2
  40. package/src/lib/doctor-capabilities.mjs +168 -0
  41. package/src/lib/implement-board.mjs +6 -1
  42. package/src/lib/implement-stream.mjs +87 -0
  43. package/src/lib/pr-ready.mjs +24 -11
  44. package/src/lib/story-graph.mjs +26 -6
  45. package/src/lib/tag-registry.mjs +58 -0
  46. package/src/lib/usage-report.mjs +15 -2
  47. package/src/plugin/.claude-plugin/plugin.json +1 -1
  48. package/src/plugins/load.mjs +427 -0
  49. package/src/plugins/scm-github/index.mjs +71 -2
  50. package/src/plugins/tracker-github-projects/index.mjs +52 -10
  51. package/src/ports/capabilities.mjs +47 -0
  52. package/src/ports/index.mjs +347 -0
  53. package/src/ports/scm.mjs +39 -2
  54. package/src/ports/tracker.mjs +94 -3
  55. package/src/ports/types.mjs +59 -6
  56. package/src/setup/files.mjs +2 -2
  57. package/src/setup/labels.mjs +2 -2
  58. package/src/setup/project.mjs +2 -2
  59. package/src/ui/wizard.mjs +76 -1
@@ -9,7 +9,6 @@
9
9
  // RELATADOS — sem o relato, ela só avalia coerência interna.
10
10
  // 3. Escreve em docs/bugs/<slug>/, fora de docs/features/.
11
11
  import { resolveToken } from '../api/auth.mjs';
12
- import { createGithubTracker } from '../plugins/tracker-github-projects/index.mjs';
13
12
  import { generateDocument } from '../lib/claude.mjs';
14
13
  import { unwrapGeneratedDoc } from '../lib/unwrap-doc.mjs';
15
14
  import { recordUsage } from '../lib/usage-report.mjs';
@@ -22,6 +21,7 @@ import { renderPrLine } from '../lib/artifact-pr.mjs';
22
21
  import {
23
22
  runCritique, resolveCritiqueAttempt, renderNeedsHumanComment,
24
23
  } from '../lib/critique.mjs';
24
+ import { requireTracker } from '../ports/index.mjs';
25
25
  import {
26
26
  LABEL_BUG, LABEL_CRITIQUE_FAILED, LABEL_NEEDS_HUMAN, REQUIRED_BUG_SECTIONS,
27
27
  TARGET_LANGUAGE, DEFAULT_MAX_CRITIQUE_ATTEMPTS, labelNames,
@@ -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 = await requireTracker({ token, owner, repo, deps });
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) {
@@ -1,8 +1,7 @@
1
1
  import path from 'node:path';
2
2
  import { readFileSync, existsSync } from 'node:fs';
3
3
  import { resolveToken } from '../api/auth.mjs';
4
- import { createGithubTracker } from '../plugins/tracker-github-projects/index.mjs';
5
- import { createGithubScm, githubLink } from '../plugins/scm-github/index.mjs';
4
+ import { requireScm, requireTracker, resolveScmLink } from '../ports/index.mjs';
6
5
  import { detectIssueType } from '../lib/issue-type.mjs';
7
6
  import {
8
7
  allowsSpecPlan, SPEC_PLAN_EXCLUDED_TYPES, TARGET_LANGUAGE,
@@ -55,7 +54,7 @@ function formatLintWarning(lintFindings) {
55
54
  * Nunca lança: o plan já foi commitado e o humano precisa dele para corrigir.
56
55
  */
57
56
  async function critiquePlan({
58
- tracker, issueNumber, spec, plan, techContextYaml, labels, config, usage,
57
+ tracker, issueNumber, spec, plan, techContextYaml, labels, config, usage, gerarEstruturado,
59
58
  }) {
60
59
  const ref = { key: String(issueNumber) };
61
60
  if (labels.includes(LABEL_NEEDS_HUMAN)) {
@@ -94,7 +93,7 @@ async function critiquePlan({
94
93
  try {
95
94
  critique = await runCritique({
96
95
  kind: 'plan', spec, plan, techContextYaml, attempt, maxAttempts, model, labels, usage,
97
- decisions,
96
+ decisions, gerarEstruturado,
98
97
  });
99
98
  } catch (err) {
100
99
  console.warn(`Crítica adversarial não concluiu: ${err.message}`);
@@ -135,15 +134,23 @@ async function critiquePlan({
135
134
  await tracker.removeTag({ ref, tag: LABEL_CRITIQUE_FAILED }).catch(() => {});
136
135
  }
137
136
 
138
- export async function generatePlan({ issueNumber }) {
137
+ /**
138
+ * @param {object} params
139
+ * @param {string|number} params.issueNumber
140
+ * @param {object} [params.deps] seam de teste — `tracker`, `scm` e
141
+ * `gerarDocumento`. Ver a nota em `generate-spec.mjs`: sem a costura de IA não
142
+ * existe teste de caminho, porque a primeira coisa útil que o comando faz é
143
+ * pagar uma chamada de modelo.
144
+ */
145
+ export async function generatePlan({ issueNumber, deps = {} }) {
139
146
  const token = await resolveToken();
140
147
  // Roda nos dois modos: no Action (disparado por label) e na sessão local.
141
148
  const { owner, repo, root, config, mode } = resolveFlowContext({ command: 'generate-plan', requireRoot: true });
142
149
  console.log(`Modo de execução: ${mode}`);
143
150
 
144
151
  console.log(`Buscando issue #${issueNumber}...`);
145
- const tracker = createGithubTracker({ token, owner, repo });
146
- const scm = createGithubScm({ link: githubLink({ owner, repo }), token });
152
+ const tracker = await requireTracker({ token, owner, repo, deps });
153
+ const scm = await requireScm({ link: resolveScmLink({ owner, repo }), token, deps });
147
154
  const ref = { key: String(parseInt(issueNumber, 10)) };
148
155
  const issue = await tracker.getWorkItem({ ref });
149
156
 
@@ -175,7 +182,7 @@ export async function generatePlan({ issueNumber }) {
175
182
  const base = await scm.defaultBranch().catch(() => null);
176
183
  const spec = await loadArtifact({
177
184
  token, owner, repo, root, pathRel: specRel, doc: 'spec',
178
- issueNumber: parseInt(issueNumber, 10), base,
185
+ issueNumber: parseInt(issueNumber, 10), base, scm,
179
186
  });
180
187
 
181
188
  // Portão duro. Este comando TOLERAVA a spec ausente e seguia com um
@@ -226,7 +233,7 @@ export async function generatePlan({ issueNumber }) {
226
233
  console.log(`Gerando plan.md para: ${issue.title}`);
227
234
  const planPrompt = loadPrompt('plan', { cwd: root });
228
235
  const systemPrompt = systemPromptWithTools(planPrompt);
229
- const { content: bruto, lintFindings } = await generateDocument(systemPrompt, userContent, {
236
+ const { content: bruto, lintFindings } = await (deps.gerarDocumento ?? generateDocument)(systemPrompt, userContent, {
230
237
  action: 'plan',
231
238
  issueNumber, cwd: root,
232
239
  maxTurns: planPrompt.maxTurns,
@@ -241,7 +248,7 @@ export async function generatePlan({ issueNumber }) {
241
248
  const content = unwrapGeneratedDoc(bruto);
242
249
 
243
250
  const published = await publishArtifact({
244
- token, owner, repo,
251
+ token, owner, repo, scm: deps.scm ?? null,
245
252
  doc: 'plan',
246
253
  issueNumber: parseInt(issueNumber, 10),
247
254
  issueTitle: issue.title,
@@ -275,6 +282,7 @@ export async function generatePlan({ issueNumber }) {
275
282
  tracker, issueNumber: parseInt(issueNumber, 10),
276
283
  spec: specContent, plan: content, techContextYaml: tech.yaml,
277
284
  labels: issueLabels, config, usage: usageEntries,
285
+ gerarEstruturado: deps.gerarEstruturado,
278
286
  });
279
287
 
280
288
  console.log(`plan.md publicado em ${published.branch} (${fileRel}).`);
@@ -296,7 +304,7 @@ export async function generatePlan({ issueNumber }) {
296
304
  throw err;
297
305
  } finally {
298
306
  // Best-effort: nunca propaga erro (ver recordUsage).
299
- await recordUsage({ token, owner, repo, issueNumber: parseInt(issueNumber, 10), entries: usageEntries });
307
+ await recordUsage({ token, owner, repo, tracker: deps.tracker ?? null, issueNumber: parseInt(issueNumber, 10), entries: usageEntries });
300
308
  }
301
309
  }
302
310
 
@@ -403,8 +411,8 @@ export async function critique({ issueNumber, file, kind, failOnGrave = false })
403
411
  console.log(`Modo de execução: ${mode}`);
404
412
 
405
413
  const n = parseInt(issueNumber, 10);
406
- const tracker = createGithubTracker({ token, owner, repo });
407
- const scm = createGithubScm({ link: githubLink({ owner, repo }), token });
414
+ const tracker = await requireTracker({ token, owner, repo });
415
+ const scm = await requireScm({ link: resolveScmLink({ owner, repo }), token });
408
416
  const ref = { key: String(n) };
409
417
  const issue = await tracker.getWorkItem({ ref });
410
418
  const type = detectIssueType(issue);
@@ -12,8 +12,7 @@
12
12
  // Só um plano estruturalmente válido gasta uma chamada de crítica.
13
13
 
14
14
  import { resolveToken } from '../api/auth.mjs';
15
- import { createGithubTracker } from '../plugins/tracker-github-projects/index.mjs';
16
- import { createGithubScm, githubLink } from '../plugins/scm-github/index.mjs';
15
+ import { requireScm, requireTracker, resolveScmLink } from '../ports/index.mjs';
17
16
  import { detectIssueType } from '../lib/issue-type.mjs';
18
17
  import { generateDocument } from '../lib/claude.mjs';
19
18
  import { unwrapGeneratedDoc } from '../lib/unwrap-doc.mjs';
@@ -64,14 +63,22 @@ async function resolveParentFeature(tracker, startRef) {
64
63
  return null;
65
64
  }
66
65
 
67
- export async function generateQaPlan({ issueNumber }) {
66
+ /**
67
+ * @param {object} params
68
+ * @param {string|number} params.issueNumber
69
+ * @param {object} [params.deps] seam de teste — `tracker`, `scm` e
70
+ * `gerarDocumento`. Ver a nota em `generate-spec.mjs`: sem a costura de IA não
71
+ * existe teste de caminho, porque a primeira coisa útil que o comando faz é
72
+ * pagar uma chamada de modelo.
73
+ */
74
+ export async function generateQaPlan({ issueNumber, deps = {} }) {
68
75
  const token = await resolveToken();
69
76
  const { owner, repo, mode: runMode } = resolveFlowContext({ command: 'generate-qa-plan' });
70
77
  console.log(`Modo de execução: ${runMode}`);
71
78
 
72
79
  const number = parseInt(issueNumber, 10);
73
- const tracker = createGithubTracker({ token, owner, repo });
74
- const scm = createGithubScm({ link: githubLink({ owner, repo }), token });
80
+ const tracker = await requireTracker({ token, owner, repo, deps });
81
+ const scm = await requireScm({ link: resolveScmLink({ owner, repo }), token, deps });
75
82
  const ref = { key: String(number) };
76
83
  const issue = await tracker.getWorkItem({ ref });
77
84
  const type = detectIssueType(issue);
@@ -137,7 +144,7 @@ export async function generateQaPlan({ issueNumber }) {
137
144
  const base = await scm.defaultBranch().catch(() => null);
138
145
 
139
146
  const ler = (doc, pathRel) => loadArtifact({
140
- token, owner, repo, root, pathRel, doc, issueNumber: number, base,
147
+ token, owner, repo, root, pathRel, doc, issueNumber: number, base, scm,
141
148
  });
142
149
 
143
150
  // ── spec.md e plan.md são a matéria-prima (spec §6.1 passo 3) ──────────────
@@ -207,7 +214,7 @@ export async function generateQaPlan({ issueNumber }) {
207
214
  try {
208
215
  await runDraftOrCritique({
209
216
  token, owner, repo, tracker, scm, ref, issue, number, labels, config, root, runMode,
210
- dirRel, docRel, base, spec, plan, stories, usage: usageEntries, ler,
217
+ dirRel, docRel, base, spec, plan, stories, usage: usageEntries, ler, deps,
211
218
  });
212
219
  } catch (err) {
213
220
  if (!err.blocked) {
@@ -223,14 +230,14 @@ export async function generateQaPlan({ issueNumber }) {
223
230
  }
224
231
  throw err;
225
232
  } finally {
226
- await recordUsage({ token, owner, repo, issueNumber: number, entries: usageEntries });
233
+ await recordUsage({ token, owner, repo, tracker: deps.tracker ?? null, issueNumber: number, entries: usageEntries });
227
234
  }
228
235
  }
229
236
 
230
237
  async function runDraftOrCritique(ctx) {
231
238
  const {
232
239
  token, owner, repo, tracker, scm, ref, issue, number, labels, config, root, runMode,
233
- dirRel, docRel, base, spec, plan, stories, usage, ler,
240
+ dirRel, docRel, base, spec, plan, stories, usage, ler, deps = {},
234
241
  } = ctx;
235
242
  // O resto da função chama a issue de `issueNumber` desde antes das portas.
236
243
  const issueNumber = number;
@@ -266,7 +273,7 @@ async function runDraftOrCritique(ctx) {
266
273
  JSON.stringify(payload, null, 2);
267
274
 
268
275
  const qaPrompt = loadPrompt('qa', { cwd: root });
269
- const { content: bruto } = await generateDocument(
276
+ const { content: bruto } = await (deps.gerarDocumento ?? generateDocument)(
270
277
  systemPromptWithTools(qaPrompt),
271
278
  userContent,
272
279
  {
@@ -290,7 +297,7 @@ async function runDraftOrCritique(ctx) {
290
297
  scenarios: gerado.scenarios.map(s => ({ story: s.story, body: s.body })),
291
298
  });
292
299
  publicado = await publishArtifact({
293
- token, owner, repo, doc: 'qa-plan',
300
+ token, owner, repo, scm: deps.scm ?? null, doc: 'qa-plan',
294
301
  issueNumber: number, issueTitle: issue.title, issueUrl: issue.ref.url,
295
302
  pathRel: docRel, content: markdown, base,
296
303
  });
@@ -380,6 +387,7 @@ async function runDraftOrCritique(ctx) {
380
387
  qaPlan: markdown,
381
388
  decisions,
382
389
  attempt, maxAttempts, model, labels, usage, cwd: root || undefined,
390
+ gerarEstruturado: deps.gerarEstruturado,
383
391
  });
384
392
  } catch (err) {
385
393
  // O verde do QA é automático (D-QA3), então o portão do plano não pode ser
@@ -1,5 +1,4 @@
1
1
  import { resolveToken } from '../api/auth.mjs';
2
- import { createGithubTracker } from '../plugins/tracker-github-projects/index.mjs';
3
2
  import { generateDocument } from '../lib/claude.mjs';
4
3
  import { unwrapGeneratedDoc } from '../lib/unwrap-doc.mjs';
5
4
  import { recordUsage } from '../lib/usage-report.mjs';
@@ -9,6 +8,7 @@ import { publishArtifact } from '../lib/artifact-publish.mjs';
9
8
  import { renderPrLine } from '../lib/artifact-pr.mjs';
10
9
  import { loadPrompt, systemPromptWithTools } from '../lib/prompt-loader.mjs';
11
10
  import { detectIssueType } from '../lib/issue-type.mjs';
11
+ import { requireTracker } from '../ports/index.mjs';
12
12
  import {
13
13
  allowsSpecPlan, SPEC_PLAN_EXCLUDED_TYPES, TARGET_LANGUAGE, labelNames,
14
14
  } from '../config.mjs';
@@ -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 = await requireTracker({ token, owner, repo, deps });
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
  }