@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.
- package/package.json +1 -1
- package/protocol/scm.v1.json +154 -0
- package/protocol/tracker.v1.json +175 -0
- package/src/api/github-rest.mjs +109 -0
- package/src/commands/audit.mjs +3 -4
- package/src/commands/code-review.mjs +11 -6
- package/src/commands/decompose.mjs +29 -9
- package/src/commands/doctor.mjs +389 -220
- package/src/commands/generate-bug.mjs +17 -7
- package/src/commands/generate-plan.mjs +21 -13
- package/src/commands/generate-qa-plan.mjs +19 -11
- package/src/commands/generate-spec.mjs +19 -6
- package/src/commands/implement.mjs +105 -49
- package/src/commands/init.mjs +36 -6
- package/src/commands/issue.mjs +6 -2
- package/src/commands/merge.mjs +31 -18
- package/src/commands/mode.mjs +18 -10
- package/src/commands/move.mjs +3 -3
- package/src/commands/order.mjs +30 -20
- package/src/commands/preflight.mjs +10 -5
- package/src/commands/qa-lead.mjs +41 -31
- package/src/commands/qa-run.mjs +83 -55
- package/src/commands/qa.mjs +10 -6
- package/src/commands/refresh.mjs +6 -3
- package/src/commands/repair-stage.mjs +1 -1
- package/src/commands/repo.mjs +7 -7
- package/src/commands/run.mjs +7 -4
- package/src/commands/story.mjs +3 -3
- package/src/commands/task.mjs +3 -3
- package/src/commands/triage.mjs +3 -3
- package/src/commands/uninstall.mjs +14 -5
- package/src/commands/update.mjs +47 -19
- package/src/commands/validate.mjs +3 -4
- package/src/commands/workspace.mjs +2 -2
- package/src/lib/artifact-publish.mjs +4 -3
- package/src/lib/board.mjs +22 -24
- package/src/lib/config-ports.mjs +114 -0
- package/src/lib/critique.mjs +11 -1
- package/src/lib/doc-source.mjs +16 -2
- package/src/lib/doctor-capabilities.mjs +168 -0
- package/src/lib/implement-board.mjs +6 -1
- package/src/lib/implement-stream.mjs +87 -0
- package/src/lib/pr-ready.mjs +24 -11
- package/src/lib/story-graph.mjs +26 -6
- package/src/lib/tag-registry.mjs +58 -0
- package/src/lib/usage-report.mjs +15 -2
- package/src/plugin/.claude-plugin/plugin.json +1 -1
- package/src/plugins/load.mjs +427 -0
- package/src/plugins/scm-github/index.mjs +71 -2
- package/src/plugins/tracker-github-projects/index.mjs +52 -10
- package/src/ports/capabilities.mjs +47 -0
- package/src/ports/index.mjs +347 -0
- package/src/ports/scm.mjs +39 -2
- package/src/ports/tracker.mjs +94 -3
- package/src/ports/types.mjs +59 -6
- package/src/setup/files.mjs +2 -2
- package/src/setup/labels.mjs +2 -2
- package/src/setup/project.mjs +2 -2
- 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
|
-
|
|
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 =
|
|
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 {
|
|
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
|
-
|
|
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 =
|
|
146
|
-
const scm =
|
|
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 =
|
|
407
|
-
const scm =
|
|
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 {
|
|
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
|
-
|
|
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 =
|
|
74
|
-
const scm =
|
|
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
|
-
|
|
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 =
|
|
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
|
|
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({
|
|
158
|
+
await recordUsage({
|
|
159
|
+
token, owner, repo, tracker: deps.tracker ?? null,
|
|
160
|
+
issueNumber: parseInt(issueNumber, 10), entries: usageEntries,
|
|
161
|
+
});
|
|
149
162
|
}
|
|
150
163
|
}
|