@spec-wave/cli 1.0.8 → 1.2.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/src/api/github-graphql.mjs +51 -0
  3. package/src/api/github-rest.mjs +48 -0
  4. package/src/commands/audit.mjs +24 -18
  5. package/src/commands/code-review.mjs +89 -58
  6. package/src/commands/decompose.mjs +254 -218
  7. package/src/commands/generate-bug.mjs +51 -44
  8. package/src/commands/generate-plan.mjs +83 -63
  9. package/src/commands/generate-qa-plan.mjs +144 -117
  10. package/src/commands/generate-spec.mjs +33 -28
  11. package/src/commands/implement.mjs +154 -79
  12. package/src/commands/init.mjs +8 -3
  13. package/src/commands/issue.mjs +26 -39
  14. package/src/commands/merge.mjs +71 -20
  15. package/src/commands/mode.mjs +8 -4
  16. package/src/commands/move.mjs +16 -20
  17. package/src/commands/order.mjs +33 -22
  18. package/src/commands/preflight.mjs +24 -13
  19. package/src/commands/qa-lead.mjs +28 -16
  20. package/src/commands/qa-run.mjs +122 -101
  21. package/src/commands/qa.mjs +55 -44
  22. package/src/commands/refresh.mjs +24 -16
  23. package/src/commands/repair-stage.mjs +29 -16
  24. package/src/commands/repo.mjs +10 -3
  25. package/src/commands/run.mjs +23 -11
  26. package/src/commands/story.mjs +20 -25
  27. package/src/commands/task.mjs +21 -27
  28. package/src/commands/triage.mjs +33 -31
  29. package/src/commands/uninstall.mjs +7 -3
  30. package/src/commands/update.mjs +29 -21
  31. package/src/commands/validate.mjs +60 -52
  32. package/src/commands/workspace.mjs +7 -5
  33. package/src/config.mjs +7 -1
  34. package/src/lib/artifact-publish.mjs +20 -18
  35. package/src/lib/board-policy.mjs +144 -0
  36. package/src/lib/board.mjs +134 -233
  37. package/src/lib/doc-availability.mjs +10 -3
  38. package/src/lib/doc-source.mjs +9 -9
  39. package/src/lib/implement-board.mjs +23 -26
  40. package/src/lib/issue-type.mjs +5 -1
  41. package/src/lib/pr-ready.mjs +48 -10
  42. package/src/lib/pr-step.mjs +3 -1
  43. package/src/lib/qa-exec.mjs +3 -1
  44. package/src/lib/qa-lead.mjs +11 -3
  45. package/src/lib/qa-plan-doc.mjs +10 -4
  46. package/src/lib/spec-audit.mjs +1 -1
  47. package/src/lib/story-graph.mjs +62 -8
  48. package/src/lib/usage-report.mjs +8 -5
  49. package/src/lib/work-item-ref.mjs +176 -0
  50. package/src/plugin/.claude-plugin/plugin.json +1 -1
  51. package/src/plugins/scm-github/index.mjs +439 -0
  52. package/src/plugins/tracker-github-projects/fields.mjs +73 -0
  53. package/src/plugins/tracker-github-projects/index.mjs +662 -0
  54. package/src/ports/scm.mjs +197 -0
  55. package/src/ports/tracker.mjs +280 -0
  56. package/src/ports/types.mjs +295 -0
  57. package/src/setup/files.mjs +14 -12
  58. package/src/setup/labels.mjs +17 -12
  59. package/src/setup/project.mjs +40 -59
@@ -0,0 +1,295 @@
1
+ // Tipos do DOMÍNIO das duas portas (RFC-006). Módulo de TIPOS: nenhum runtime,
2
+ // nenhum import, e nenhuma palavra que pertença a um fornecedor — nada de
3
+ // "issue", "label", "milestone do GitHub", "sprint". O core manipula isto; o
4
+ // que o plugin fala com o fornecedor é problema do plugin.
5
+ //
6
+ // Por que os typedefs vivem num arquivo só e separados das assinaturas: eles
7
+ // são o vocabulário compartilhado pelas duas portas (`WorkItemRef` aparece nas
8
+ // duas) e são o que a spec-wave-ui precisa ler para implementar as portas dela
9
+ // contra O MESMO contrato — não contra um parecido (RFC-007 §3.1).
10
+ //
11
+ // Na Fase 2 estes tipos viram `protocol/{tracker,scm}.v1.json` publicados no
12
+ // pacote. Enquanto a RFC é Proposta, o normativo é `rfc/protocol/*.v1.json`.
13
+
14
+ /**
15
+ * Identidade de um work item (RFC-006 §4).
16
+ *
17
+ * Os construtores e as funções puras sobre ela vivem em
18
+ * `src/lib/work-item-ref.mjs` — aqui fica só a forma.
19
+ *
20
+ * @typedef {object} WorkItemRef
21
+ * @property {string} key Identificador humano e PÚBLICO: `"123"` no GitHub,
22
+ * `"PROJ-123"` no Jira. É o que vai para nome de branch, corpo de PR, trailer
23
+ * de commit e nome de arquivo.
24
+ * @property {string|null} id Opaco do fornecedor (node id no GitHub). Nunca
25
+ * exibido, nunca escrito em documento.
26
+ * @property {string|null} url Endereço navegável.
27
+ */
28
+
29
+ /**
30
+ * Um work item lido do tracker.
31
+ *
32
+ * @typedef {object} WorkItem
33
+ * @property {WorkItemRef} ref
34
+ * @property {string} title
35
+ * @property {string} body
36
+ * @property {'open'|'closed'} state NORMALIZADO pela porta. Em
37
+ * `closeSemantics: 'transition-and-resolution'` o plugin deriva de categoria
38
+ * de status + resolution; o core nunca vê "Done" nem "Resolvido".
39
+ * @property {string[]} tags
40
+ * @property {MilestoneRef|null} milestone
41
+ * @property {string|null} createdAt ISO-8601. É o que permite ao code-review
42
+ * ignorar filhos nascidos depois da abertura do PR.
43
+ * @property {'completed'|'not-planned'|'reopened'|null} [stateReason] POR QUE o
44
+ * item está fechado. É o que distingue "entregue" de "descartada no rescopo",
45
+ * e o `doctor` depende disso para não acusar deriva de decomposição numa
46
+ * Story que o time tirou do escopo de propósito. Mesmo vocabulário do `reason`
47
+ * de `closeWorkItem` — e é o que a `resolution` do Jira preenche.
48
+ * @property {WorkItemRef|null} [parent] Só com `hierarchy: 'native'`.
49
+ */
50
+
51
+ /**
52
+ * Agrupamento por entrega.
53
+ *
54
+ * GitHub usa milestones; Jira usa **Versions** (`fixVersions`) e NÃO sprints —
55
+ * quem consome isto é `listWorkItemsByMilestone`, `preflight`, `audit` e
56
+ * `qa-lead`, todos com semântica de release, não de iteração.
57
+ *
58
+ * @typedef {object} MilestoneRef
59
+ * @property {string} key Identificador no fornecedor (número da milestone no
60
+ * GitHub, id da Version no Jira). String pelo mesmo motivo de `WorkItemRef.key`.
61
+ * @property {string} title O que o usuário digita ("v06").
62
+ * @property {string|null} [dueOn] Data-alvo, ISO-8601. Não é decoração: é o que
63
+ * `audit` usa para decidir se uma dependência resolve para uma entrega
64
+ * POSTERIOR — o defeito de sequenciamento que o comando existe para achar.
65
+ * Portável: uma Version do Jira tem `releaseDate`.
66
+ * @property {string} [description]
67
+ */
68
+
69
+ /**
70
+ * ENDEREÇO de uma milestone — a chave, e só.
71
+ *
72
+ * Existe para que as operações que apenas apontam para uma entrega
73
+ * (`setMilestone`, `listWorkItemsByMilestone`) não exijam o `MilestoneRef`
74
+ * inteiro. Um chamador que tem só o número — o snapshot de board devolve
75
+ * `{key, title}`, mas uma cascata Feature→Stories costuma ter só números —
76
+ * teria de FORJAR `title: ''` para satisfazer o tipo, e isso é uma aposta de
77
+ * que o plugin ignora o campo forjado. Aposta sobre um plugin específico: o
78
+ * próximo pode não ignorar, e aí o título vazio sobrescreve o de verdade.
79
+ *
80
+ * Mesma razão do parcial de `getParent`: ninguém deve inventar dado para
81
+ * conseguir chamar. Endereçar é pela chave; `title` e `dueOn` são o que a
82
+ * LEITURA devolve. Um `MilestoneRef` satisfaz `MilestoneKey` por construção.
83
+ *
84
+ * @typedef {object} MilestoneKey
85
+ * @property {string} key
86
+ */
87
+
88
+ /**
89
+ * @typedef {object} CommentRef
90
+ * @property {string} id
91
+ * @property {string} body **Markdown, sempre**, na ida e na volta. Converter
92
+ * de/para `adf` ou `wiki` é responsabilidade do plugin (`commentFormat`) —
93
+ * o core escreve markdown em todo lugar e a UI o renderiza com react-markdown.
94
+ * @property {string} author
95
+ * @property {string} createdAt
96
+ */
97
+
98
+ /**
99
+ * Nome CANÔNICO de campo — lista fechada, espelho de `capabilities.fields`.
100
+ *
101
+ * O core nunca passa o rótulo de exibição (`"Work Item Type"`, `"Etapa"`):
102
+ * traduzir nome canônico → campo do fornecedor é do plugin, e é exatamente o
103
+ * que o `fieldMap` do Jira resolve (lá `storyPoints` é `customfield_1XXXX`,
104
+ * variável por site).
105
+ *
106
+ * ⚠️ **`release` NÃO é o milestone.** São dois eixos independentes, e um item
107
+ * pode ter os dois, um ou nenhum:
108
+ *
109
+ * - `release` é um campo ANOTADO no item, de texto livre, sem entidade própria
110
+ * — não se lista, não se cria, não tem data-alvo. Aqui ele é um campo TEXT do
111
+ * Projects v2 (`config.mjs`); na `spec-wave-ui` é uma label (`v1.2`). Três
112
+ * implementações já escolheram três mecanismos, e isso está certo: o
113
+ * mecanismo é do plugin.
114
+ * - O milestone é uma ENTIDADE do tracker, com `key`, título e `dueOn`, que se
115
+ * lista (`listMilestones`) e pela qual se filtra (`listWorkItemsByMilestone`).
116
+ * É o que `preflight`, `audit` e `qa-lead` consomem. Escreve-se com
117
+ * `setMilestone`, nunca por aqui.
118
+ *
119
+ * A distinção é normativa, e não descritiva do GitHub: sem ela, um plugin pode
120
+ * representar `release` COMO o milestone de boa-fé, e aí `setField({field:
121
+ * 'release'})` e `setMilestone()` viram dois caminhos de escrita para o mesmo
122
+ * valor, sem nada que os mantenha coerentes. Um plugin que só tenha um dos dois
123
+ * declara o outro ausente em `capabilities` — não os funde.
124
+ *
125
+ * O sintoma de confundir os dois é mudo: a escrita tem SUCESSO, o texto entra
126
+ * no campo anotado e os filtros por milestone seguem sem enxergar o item.
127
+ *
128
+ * @typedef {'workItemType'|'priority'|'storyPoints'|'area'|'release'} FieldName
129
+ */
130
+
131
+ /**
132
+ * PROGRESSO dentro da etapa atual.
133
+ *
134
+ * ⚠️ Não é `stage` e não é `state`. São três dimensões distintas:
135
+ * • `stage` — a coluna do kanban (STATUS_OPTIONS)
136
+ * • `progress` — este aqui: Todo / In Progress / Done DENTRO da coluna
137
+ * • `state` — aberto/fechado (`closeSemantics`)
138
+ *
139
+ * `task start` marca In Progress sem mexer na Etapa, porque a Task continua em
140
+ * 🚧 Desenvolvimento — é o que distingue "há trabalho em curso" de "mudou de
141
+ * coluna". No GitHub é o campo nativo "Status" do Projects v2.
142
+ *
143
+ * `capabilities.progress: 'none'` faz o core PULAR a escrita em vez de emular:
144
+ * no Jira o status É a etapa, e emular criaria duas fontes de verdade para a
145
+ * mesma coluna.
146
+ *
147
+ * @typedef {'Todo'|'In Progress'|'Done'} Progress
148
+ */
149
+
150
+ /**
151
+ * Um item do board como o core o consome.
152
+ *
153
+ * Note o que NÃO está aqui: `itemId`, node id de campo, `optionId`.
154
+ * Endereçamento é do plugin — é a diferença entre esta porta e
155
+ * `advanceToStage(token, project, etapaField, statusField, nodeId, …)`.
156
+ *
157
+ * @typedef {object} BoardItem
158
+ * @property {WorkItemRef} ref
159
+ * @property {string} title
160
+ * @property {'open'|'closed'} state
161
+ * @property {string|null} stage Nome CANÔNICO de STATUS_OPTIONS.
162
+ * @property {Progress|null} progress
163
+ * @property {MilestoneRef|null} milestone
164
+ * @property {Partial<Record<FieldName, string>>} fields Chaveado pelo nome
165
+ * canônico, nunca por `"Work Item Type"`.
166
+ */
167
+
168
+ /**
169
+ * Endereço de UM repositório de código.
170
+ *
171
+ * Substitui o par `{owner, repo}` que `lib/project-root.mjs resolveRepoContext()`
172
+ * devolve: o Azure DevOps acrescenta um nível (`org/project/repo`) que não cabe
173
+ * no par (RFC §11.1).
174
+ *
175
+ * Quando a RFC-005 reexpressar `scm` como LISTA (RFC §12), é só passar a haver
176
+ * N links com um `role: 'hub'` — nenhuma assinatura de porta muda. É a razão de
177
+ * `role` já estar aqui na Fase 1.
178
+ *
179
+ * @typedef {object} ScmLink
180
+ * @property {string} id Chave estável e opaca para o core — mapa, cache,
181
+ * deduplicação de PR. `"github:owner/repo"`.
182
+ * @property {string} kind `"github"`, `"azure-devops"`.
183
+ * @property {'hub'|'code'} role
184
+ * @property {string} label Rótulo humano ("acme/api").
185
+ * @property {object} config Bloco do fornecedor, OPACO para o core.
186
+ */
187
+
188
+ /**
189
+ * @typedef {object} PullRequestRef
190
+ * @property {string} id
191
+ * @property {string} number String: o identificador de PR também é do fornecedor.
192
+ * @property {string|null} url
193
+ * @property {string} title
194
+ * @property {string} body
195
+ * @property {'open'|'closed'|'merged'} state
196
+ * @property {boolean} draft
197
+ * @property {string|null} baseRef
198
+ * @property {string|null} headRef
199
+ * @property {string|null} [createdAt] ISO-8601. É o CORTE TEMPORAL do
200
+ * code-review: sub-issue nascida depois da abertura do PR não faz parte do
201
+ * que aquele PR entrega. Usa a data do PR e não o relógio do run porque
202
+ * precisa ser determinística — reprocessar o mesmo PR tem de dar o mesmo
203
+ * recorte.
204
+ * @property {ScmLink} link De QUAL repositório este PR veio. Obrigatório: o
205
+ * número colide entre repositórios, o par (link, número) não.
206
+ */
207
+
208
+ /**
209
+ * Um voto/veredito de revisor, CRU.
210
+ *
211
+ * O plugin não normaliza — dois plugins `vote` normalizariam diferente e
212
+ * `pr-ready` passaria a depender de qual está instalado. Quem agrega é
213
+ * `reviewDecision()` em `src/ports/scm.mjs`, no core.
214
+ *
215
+ * @typedef {object} Review
216
+ * @property {string} reviewer
217
+ * @property {string|null} submittedAt
218
+ * @property {'APPROVED'|'CHANGES_REQUESTED'|'COMMENTED'|'DISMISSED'|'PENDING'} [state]
219
+ * Só em `reviewModel: 'decision'`.
220
+ * @property {number} [vote] Só em `reviewModel: 'vote'` (−10…10).
221
+ */
222
+
223
+ /** @typedef {'approved'|'changes_requested'|'pending'} ReviewDecision */
224
+
225
+ /**
226
+ * @typedef {object} FileWrite
227
+ * @property {string} path
228
+ * @property {string} content
229
+ * @property {'utf-8'|'base64'} [encoding='utf-8'] Aditivo e sem uso na Fase 1
230
+ * (a evidência visual do QA vai por git local, não por aqui). Existe desde já
231
+ * porque `newContent.contentType` do Azure DevOps exige a decisão POR ARQUIVO,
232
+ * e descobrir isso na Fase 4 obrigaria a mudar a assinatura de `writeFiles`.
233
+ */
234
+
235
+ /**
236
+ * @typedef {object} CommitResult
237
+ * @property {string} branch
238
+ * @property {string} base
239
+ * @property {string} commitSha
240
+ * @property {boolean} createdBranch
241
+ * @property {boolean} unchanged Árvore idêntica à do pai — nada a commitar.
242
+ * Não é erro: commit vazio num PR só confunde quem revisa.
243
+ * @property {string} baseSha
244
+ */
245
+
246
+ /** @typedef {'identical'|'ahead'|'behind'|'diverged'|null} CompareStatus */
247
+
248
+ /**
249
+ * Uma execução de automação (workflow run, pipeline run).
250
+ *
251
+ * `status` e `conclusion` são separados porque uma run em andamento não tem
252
+ * conclusão. Colapsá-los num campo só obrigaria a inventar um valor `'running'`
253
+ * que não existe em nenhum dos dois fornecedores.
254
+ *
255
+ * `action_required` é um veredito à parte, e não um `failure`: ele significa
256
+ * que a run está BLOQUEADA esperando aprovação humana (ambiente protegido no
257
+ * Actions, gate de aprovação no Pipelines). O remédio é outro — alguém precisa
258
+ * aprovar, não corrigir —, e uma tela que o trate como falha manda o usuário
259
+ * depurar um problema que não existe. Ele entrou no enum depois de a
260
+ * spec-wave-ui apontar que a normalização o perdia: lá isso vira "a execução
261
+ * terminou sem gerar a spec" em vez de "está esperando aprovação".
262
+ *
263
+ * O que NÃO tem valor próprio, e por quê:
264
+ * • `startup_failure` (run que nem começou) normaliza para `failure` — o
265
+ * remédio é o mesmo, e um valor que significasse "falhou, só que antes" não
266
+ * muda decisão nenhuma;
267
+ * • `neutral` e `stale` viram `null` — "terminou sem veredito" já é o que
268
+ * `status: 'completed'` + `conclusion: null` diz.
269
+ *
270
+ * @typedef {object} AutomationRun
271
+ * @property {string} id
272
+ * @property {string} name
273
+ * @property {'queued'|'in_progress'|'completed'} status
274
+ * @property {'success'|'failure'|'cancelled'|'skipped'|'timed_out'|'action_required'|null} conclusion
275
+ * @property {string} createdAt
276
+ * @property {string|null} url
277
+ * @property {string|null} headBranch
278
+ */
279
+
280
+ /**
281
+ * Resultado de `verify()` — diagnóstico SEM efeito, nas duas portas.
282
+ *
283
+ * `facts` é o saco de "User vs Organization", título do project, contagem de
284
+ * campos: o que o `doctor` imprime e o core não interpreta. Sacola aberta de
285
+ * propósito — cada fornecedor tem fatos próprios, e forçá-los num schema
286
+ * fechado seria inventar campo que só um deles preenche.
287
+ *
288
+ * @typedef {object} VerifyResult
289
+ * @property {boolean} ok
290
+ * @property {{remaining: number|null, limit: number|null, resetAt: string|null}} quota
291
+ * @property {Record<string, string>} facts
292
+ * @property {string[]} problems
293
+ */
294
+
295
+ export {};
@@ -1,5 +1,5 @@
1
- import { upsertFile, getFileContent, isRepoInitialized } from '../api/github-rest.mjs';
2
1
  import { WORKFLOW_FILES, CODE_WORKFLOW_FILES } from '../config.mjs';
2
+ import { createGithubScm, githubLink } from '../plugins/scm-github/index.mjs';
3
3
  // readTemplate resolve {{CLI_VERSION}} — é o que fixa a versão da CLI nos
4
4
  // workflows gravados no repo-alvo (ver src/lib/templates.mjs).
5
5
  import { readTemplate } from '../lib/templates.mjs';
@@ -41,9 +41,14 @@ export function repoFilesFor(role) {
41
41
  ];
42
42
  }
43
43
 
44
- export async function setupFiles(token, owner, repo, spinner, { role = 'hub' } = {}) {
44
+ export async function setupFiles(token, owner, repo, spinner, { role = 'hub', port } = {}) {
45
+ // `repoFilesFor` continua no CORE: QUAL papel recebe QUAIS arquivos é regra
46
+ // de fluxo (RFC-005 §7.5). O que saiu para o plugin foi a gravação — e o
47
+ // conteúdo dos templates, que é formato de motor de automação, não de fluxo.
48
+ const scm = port || createGithubScm({ link: githubLink({ owner, repo, role }), token });
49
+
45
50
  spinner.message('Verificando repositório...');
46
- const initialized = await isRepoInitialized(token, owner, repo);
51
+ const initialized = await scm.isInitialized();
47
52
  if (!initialized) {
48
53
  throw new Error(
49
54
  `O repositório ${owner}/${repo} está vazio (sem commits).\n` +
@@ -53,13 +58,10 @@ export async function setupFiles(token, owner, repo, spinner, { role = 'hub' } =
53
58
  );
54
59
  }
55
60
 
56
- const filesToCreate = repoFilesFor(role);
57
-
58
- for (let i = 0; i < filesToCreate.length; i++) {
59
- const file = filesToCreate[i];
60
- spinner.message(`Criando arquivo ${i + 1}/${filesToCreate.length}: ${file.path}`);
61
- await upsertFile(token, owner, repo, file.path, file.content, file.message);
62
- }
61
+ await scm.installAutomation({
62
+ files: repoFilesFor(role),
63
+ log: ({ index, total, path }) => spinner.message(`Criando arquivo ${index + 1}/${total}: ${path}`),
64
+ });
63
65
 
64
66
  // O tech_context é do hub: é lá que os prompts o leem.
65
67
  if (role === 'code') return;
@@ -75,12 +77,12 @@ export async function setupFiles(token, owner, repo, spinner, { role = 'hub' } =
75
77
  ];
76
78
 
77
79
  for (const file of configFiles) {
78
- const existing = await getFileContent(token, owner, repo, file.path);
80
+ const existing = await scm.readFile({ path: file.path });
79
81
  if (existing !== null) {
80
82
  spinner.message(`Mantendo ${file.path} existente (não sobrescrito)`);
81
83
  continue;
82
84
  }
83
85
  spinner.message(`Criando arquivo de config: ${file.path}`);
84
- await upsertFile(token, owner, repo, file.path, file.content, file.message);
86
+ await scm.installAutomation({ files: [file] });
85
87
  }
86
88
  }
@@ -1,22 +1,27 @@
1
- import { createLabel } from '../api/github-rest.mjs';
2
1
  import { allLabelsFor } from '../config.mjs';
2
+ import { createGithubTracker } from '../plugins/tracker-github-projects/index.mjs';
3
3
 
4
+ /**
5
+ * Pausa entre criações de label.
6
+ *
7
+ * Fica AQUI e não no plugin porque ela depende do tamanho da rajada, não do
8
+ * fornecedor: o `init` cria o conjunto inteiro (~30 labels de uma vez, que é o
9
+ * que tromba no rate limit secundário do GitHub), enquanto o `update` cria só
10
+ * as que faltam. A porta aceita `delayMs`; quem sabe o tamanho da rajada é
11
+ * quem chama.
12
+ */
4
13
  const DELAY_MS = 120;
5
14
 
6
- function sleep(ms) {
7
- return new Promise(r => setTimeout(r, ms));
8
- }
9
-
10
15
  // `fileAi` traz as labels de modelo derivadas de `ai.modelAliases`, o mesmo
11
16
  // vale para `devAgent` e as filas extra do dev-agent. No `init` os dois vêm
12
17
  // vazios (o config ainda nem foi gravado) e o conjunto é só o do fluxo; quem
13
18
  // cria as de modelo/fila depois é o `update`, que já lê o config do repo.
14
- export async function setupLabels(token, owner, repo, spinner, fileAi, devAgent) {
19
+ export async function setupLabels(token, owner, repo, spinner, fileAi, devAgent, { port } = {}) {
20
+ const tracker = port || createGithubTracker({ token, owner, repo });
15
21
  const labels = allLabelsFor(fileAi, devAgent);
16
- for (let i = 0; i < labels.length; i++) {
17
- const label = labels[i];
18
- spinner.message(`Criando label ${i + 1}/${labels.length}: ${label.name}`);
19
- await createLabel(token, owner, repo, label);
20
- if (i < labels.length - 1) await sleep(DELAY_MS);
21
- }
22
+ await tracker.ensureTags({
23
+ tags: labels,
24
+ delayMs: DELAY_MS,
25
+ log: ({ index, total, name }) => spinner.message(`Criando label ${index + 1}/${total}: ${name}`),
26
+ });
22
27
  }
@@ -1,62 +1,43 @@
1
- import {
2
- createProject,
3
- createSingleSelectField,
4
- createTextField,
5
- linkProjectToRepo,
6
- } from '../api/github-graphql.mjs';
7
- import { getOwnerNodeId, getRepoNodeId } from '../api/github-rest.mjs';
8
- import { STATUS_OPTIONS, CUSTOM_FIELDS } from '../config.mjs';
9
-
10
- // The GitHub Projects v2 API does not allow replacing the built-in Status field
11
- // options atomically ("Position has already been taken" error). We create a custom
12
- // "Etapa" field with the RFC-001 kanban columns instead, and configure the board
13
- // view to group by it.
14
- const ETAPA_FIELD = {
15
- name: 'Etapa',
16
- dataType: 'SINGLE_SELECT',
17
- options: STATUS_OPTIONS,
18
- };
19
-
20
- export async function setupProject(token, owner, repo, projectTitle, spinner) {
21
- spinner.message('Buscando IDs do owner e repositório...');
22
- const [ownerId, repositoryId] = await Promise.all([
23
- getOwnerNodeId(token, owner),
24
- getRepoNodeId(token, owner, repo),
25
- ]);
26
-
27
- spinner.message('Criando GitHub Project...');
28
- const { projectId, projectNumber, projectUrl } = await createProject(token, ownerId, projectTitle);
29
-
30
- spinner.message('Criando campos customizados...');
31
- const selectFields = CUSTOM_FIELDS.filter(f => f.dataType === 'SINGLE_SELECT');
32
- const textFields = CUSTOM_FIELDS.filter(f => f.dataType === 'TEXT');
33
- const allFields = [ETAPA_FIELD, ...selectFields];
34
-
35
- // Sequential creation: the GitHub Projects v2 API raises "Position has already
36
- // been taken" when multiple SINGLE_SELECT fields are created concurrently.
37
- // Capturamos id + opções de cada campo num mapa `fields` (nome → {id, options})
38
- // para o .spec-wave.json — o comando `issue` usa isso para setar Etapa e Work Item Type.
39
- const fields = {};
40
- for (const f of allFields) {
41
- spinner.message(`Criando campo "${f.name}"...`);
42
- fields[f.name] = await createSingleSelectField(token, projectId, f.name, f.options);
43
- }
44
- for (const f of textFields) {
45
- spinner.message(`Criando campo "${f.name}"...`);
46
- await createTextField(token, projectId, f.name);
47
- }
48
-
49
- const result = { projectId, projectNumber, projectUrl, fields };
50
-
51
- spinner.message('Vinculando projeto ao repositório...');
52
- try {
53
- await linkProjectToRepo(token, projectId, repositoryId);
54
- } catch (err) {
55
- // Linking is cosmetic (shows project in repo's Projects tab).
56
- // It requires `repo` scope in addition to `project`. Skip gracefully.
1
+ // Provisionamento do board — agora uma casca sobre a porta de tracker.
2
+ //
3
+ // O corpo (criar o Project, o campo Etapa com as 12 etapas, os campos custom
4
+ // sequencialmente, vincular ao repo) mudou para
5
+ // `src/plugins/tracker-github-projects/`, porque tudo ali é GitHub Projects v2:
6
+ // `dataType: 'SINGLE_SELECT'`, as cores do enum do Projects, e o erro
7
+ // "Position has already been taken" que obriga a criação sequencial. Num Jira
8
+ // isso não é criar nada — é MAPEAR o que o admin do site já configurou
9
+ // (`boardProvisioning: 'map-only'`), e por isso a decisão não podia continuar
10
+ // no core.
11
+ //
12
+ // Esta função sobrevive com a assinatura de antes por um motivo só: `init.mjs`
13
+ // a chama com um spinner do Clack, e trocar o formato do progresso do `init`
14
+ // seria mudança de comportamento numa fase que promete não ter nenhuma.
15
+
16
+ import { createGithubTracker } from '../plugins/tracker-github-projects/index.mjs';
17
+
18
+ /**
19
+ * Cria o GitHub Project e os campos do RFC-001.
20
+ *
21
+ * @param {string} token
22
+ * @param {string} owner
23
+ * @param {string} repo
24
+ * @param {string} projectTitle
25
+ * @param {{message: Function}} spinner spinner do Clack (só progresso)
26
+ * @param {{port?: object}} [opts] injeção da porta, para teste
27
+ * @returns {Promise<{projectId, projectNumber, projectUrl, fields, linkWarning?}>}
28
+ */
29
+ export async function setupProject(token, owner, repo, projectTitle, spinner, { port } = {}) {
30
+ const tracker = port || createGithubTracker({ token, owner, repo });
31
+ const { config, warnings } = await tracker.setup({
32
+ provision: true,
33
+ title: projectTitle,
34
+ log: m => spinner.message(m),
35
+ });
36
+ if (warnings.length > 0) {
37
+ // Vincular o project ao repositório é cosmético e exige `repo` além de
38
+ // `project`; o init transforma isso em instrução manual, não em falha.
57
39
  spinner.message('');
58
- return { ...result, linkWarning: err.message };
40
+ return { ...config, linkWarning: warnings[0] };
59
41
  }
60
-
61
- return result;
42
+ return config;
62
43
  }