@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 +1 -1
- package/src/commands/audit.mjs +3 -2
- package/src/commands/code-review.mjs +3 -2
- package/src/commands/decompose.mjs +26 -7
- package/src/commands/generate-bug.mjs +16 -6
- package/src/commands/generate-plan.mjs +21 -11
- package/src/commands/generate-qa-plan.mjs +20 -10
- package/src/commands/generate-spec.mjs +18 -5
- package/src/commands/implement.mjs +91 -47
- package/src/commands/init.mjs +3 -2
- package/src/commands/merge.mjs +14 -6
- package/src/commands/mode.mjs +3 -2
- package/src/commands/order.mjs +29 -19
- package/src/commands/preflight.mjs +3 -2
- package/src/commands/qa-lead.mjs +40 -28
- package/src/commands/qa-run.mjs +68 -52
- package/src/commands/qa.mjs +3 -2
- package/src/commands/repo.mjs +3 -2
- package/src/commands/run.mjs +3 -2
- package/src/commands/uninstall.mjs +3 -2
- package/src/commands/update.mjs +3 -2
- package/src/commands/validate.mjs +3 -2
- package/src/lib/artifact-publish.mjs +3 -2
- package/src/lib/critique.mjs +11 -1
- package/src/lib/doc-source.mjs +3 -2
- package/src/lib/implement-board.mjs +5 -0
- package/src/lib/implement-stream.mjs +87 -0
- package/src/lib/pr-ready.mjs +4 -3
- package/src/lib/story-graph.mjs +9 -2
- package/src/plugin/.claude-plugin/plugin.json +1 -1
- package/src/ports/index.mjs +192 -0
- package/src/ports/tracker.mjs +51 -1
- package/src/ports/types.mjs +29 -0
- package/src/setup/files.mjs +3 -2
package/package.json
CHANGED
package/src/commands/audit.mjs
CHANGED
|
@@ -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
|
|
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:
|
|
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
|
|
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:
|
|
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
|
|
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
|
-
|
|
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:
|
|
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
|
-
|
|
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
|
|
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
|
-
|
|
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:
|
|
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:
|
|
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
|
|
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
|
-
|
|
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:
|
|
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
|
-
|
|
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
|
|
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
|
}
|