@spec-wave/cli 1.0.7 → 1.1.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 (68) hide show
  1. package/package.json +1 -1
  2. package/src/commands/audit.mjs +24 -18
  3. package/src/commands/code-review.mjs +91 -59
  4. package/src/commands/decompose.mjs +258 -221
  5. package/src/commands/doctor.mjs +16 -11
  6. package/src/commands/generate-bug.mjs +51 -44
  7. package/src/commands/generate-plan.mjs +83 -63
  8. package/src/commands/generate-qa-plan.mjs +145 -117
  9. package/src/commands/generate-spec.mjs +33 -28
  10. package/src/commands/implement.mjs +155 -79
  11. package/src/commands/info.mjs +4 -3
  12. package/src/commands/init.mjs +11 -5
  13. package/src/commands/install-skill.mjs +19 -0
  14. package/src/commands/issue.mjs +26 -39
  15. package/src/commands/merge.mjs +71 -20
  16. package/src/commands/mode.mjs +11 -6
  17. package/src/commands/move.mjs +16 -20
  18. package/src/commands/order.mjs +33 -22
  19. package/src/commands/preflight.mjs +24 -13
  20. package/src/commands/qa-lead.mjs +30 -17
  21. package/src/commands/qa-run.mjs +125 -103
  22. package/src/commands/qa.mjs +55 -44
  23. package/src/commands/refresh.mjs +24 -16
  24. package/src/commands/repair-stage.mjs +29 -16
  25. package/src/commands/repo.mjs +12 -4
  26. package/src/commands/run.mjs +23 -11
  27. package/src/commands/story.mjs +20 -25
  28. package/src/commands/task.mjs +21 -27
  29. package/src/commands/triage.mjs +33 -31
  30. package/src/commands/uninstall.mjs +7 -3
  31. package/src/commands/update.mjs +31 -22
  32. package/src/commands/validate.mjs +60 -52
  33. package/src/commands/workspace.mjs +7 -5
  34. package/src/config.mjs +7 -1
  35. package/src/lib/artifact-publish.mjs +20 -18
  36. package/src/lib/board-policy.mjs +144 -0
  37. package/src/lib/board.mjs +134 -233
  38. package/src/lib/cli-ref.mjs +75 -0
  39. package/src/lib/config-file.mjs +2 -1
  40. package/src/lib/doc-availability.mjs +10 -3
  41. package/src/lib/doc-source.mjs +9 -9
  42. package/src/lib/execution-mode.mjs +5 -3
  43. package/src/lib/implement-board.mjs +23 -26
  44. package/src/lib/issue-type.mjs +5 -1
  45. package/src/lib/plugin-skills.mjs +10 -0
  46. package/src/lib/pr-ready.mjs +48 -10
  47. package/src/lib/pr-step.mjs +3 -1
  48. package/src/lib/qa-exec.mjs +3 -1
  49. package/src/lib/qa-lead.mjs +11 -3
  50. package/src/lib/qa-plan-doc.mjs +10 -4
  51. package/src/lib/qa-report.mjs +2 -1
  52. package/src/lib/skill-compose.mjs +3 -0
  53. package/src/lib/spec-audit.mjs +1 -1
  54. package/src/lib/story-graph.mjs +62 -8
  55. package/src/lib/usage-report.mjs +8 -5
  56. package/src/lib/work-item-ref.mjs +176 -0
  57. package/src/plugin/.claude-plugin/plugin.json +1 -1
  58. package/src/plugins/scm-github/index.mjs +439 -0
  59. package/src/plugins/tracker-github-projects/fields.mjs +73 -0
  60. package/src/plugins/tracker-github-projects/index.mjs +625 -0
  61. package/src/ports/scm.mjs +197 -0
  62. package/src/ports/tracker.mjs +239 -0
  63. package/src/ports/types.mjs +254 -0
  64. package/src/setup/files.mjs +14 -12
  65. package/src/setup/labels.mjs +17 -12
  66. package/src/setup/project.mjs +40 -59
  67. package/src/templates/workflows/code/code-review.yml +1 -1
  68. package/src/templates/workflows/code/qa.yml +1 -1
@@ -0,0 +1,254 @@
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
+ * @typedef {object} CommentRef
71
+ * @property {string} id
72
+ * @property {string} body **Markdown, sempre**, na ida e na volta. Converter
73
+ * de/para `adf` ou `wiki` é responsabilidade do plugin (`commentFormat`) —
74
+ * o core escreve markdown em todo lugar e a UI o renderiza com react-markdown.
75
+ * @property {string} author
76
+ * @property {string} createdAt
77
+ */
78
+
79
+ /**
80
+ * Nome CANÔNICO de campo — lista fechada, espelho de `capabilities.fields`.
81
+ *
82
+ * O core nunca passa o rótulo de exibição (`"Work Item Type"`, `"Etapa"`):
83
+ * traduzir nome canônico → campo do fornecedor é do plugin, e é exatamente o
84
+ * que o `fieldMap` do Jira resolve (lá `storyPoints` é `customfield_1XXXX`,
85
+ * variável por site).
86
+ *
87
+ * @typedef {'workItemType'|'priority'|'storyPoints'|'area'|'release'} FieldName
88
+ */
89
+
90
+ /**
91
+ * PROGRESSO dentro da etapa atual.
92
+ *
93
+ * ⚠️ Não é `stage` e não é `state`. São três dimensões distintas:
94
+ * • `stage` — a coluna do kanban (STATUS_OPTIONS)
95
+ * • `progress` — este aqui: Todo / In Progress / Done DENTRO da coluna
96
+ * • `state` — aberto/fechado (`closeSemantics`)
97
+ *
98
+ * `task start` marca In Progress sem mexer na Etapa, porque a Task continua em
99
+ * 🚧 Desenvolvimento — é o que distingue "há trabalho em curso" de "mudou de
100
+ * coluna". No GitHub é o campo nativo "Status" do Projects v2.
101
+ *
102
+ * `capabilities.progress: 'none'` faz o core PULAR a escrita em vez de emular:
103
+ * no Jira o status É a etapa, e emular criaria duas fontes de verdade para a
104
+ * mesma coluna.
105
+ *
106
+ * @typedef {'Todo'|'In Progress'|'Done'} Progress
107
+ */
108
+
109
+ /**
110
+ * Um item do board como o core o consome.
111
+ *
112
+ * Note o que NÃO está aqui: `itemId`, node id de campo, `optionId`.
113
+ * Endereçamento é do plugin — é a diferença entre esta porta e
114
+ * `advanceToStage(token, project, etapaField, statusField, nodeId, …)`.
115
+ *
116
+ * @typedef {object} BoardItem
117
+ * @property {WorkItemRef} ref
118
+ * @property {string} title
119
+ * @property {'open'|'closed'} state
120
+ * @property {string|null} stage Nome CANÔNICO de STATUS_OPTIONS.
121
+ * @property {Progress|null} progress
122
+ * @property {MilestoneRef|null} milestone
123
+ * @property {Partial<Record<FieldName, string>>} fields Chaveado pelo nome
124
+ * canônico, nunca por `"Work Item Type"`.
125
+ */
126
+
127
+ /**
128
+ * Endereço de UM repositório de código.
129
+ *
130
+ * Substitui o par `{owner, repo}` que `lib/project-root.mjs resolveRepoContext()`
131
+ * devolve: o Azure DevOps acrescenta um nível (`org/project/repo`) que não cabe
132
+ * no par (RFC §11.1).
133
+ *
134
+ * Quando a RFC-005 reexpressar `scm` como LISTA (RFC §12), é só passar a haver
135
+ * N links com um `role: 'hub'` — nenhuma assinatura de porta muda. É a razão de
136
+ * `role` já estar aqui na Fase 1.
137
+ *
138
+ * @typedef {object} ScmLink
139
+ * @property {string} id Chave estável e opaca para o core — mapa, cache,
140
+ * deduplicação de PR. `"github:owner/repo"`.
141
+ * @property {string} kind `"github"`, `"azure-devops"`.
142
+ * @property {'hub'|'code'} role
143
+ * @property {string} label Rótulo humano ("acme/api").
144
+ * @property {object} config Bloco do fornecedor, OPACO para o core.
145
+ */
146
+
147
+ /**
148
+ * @typedef {object} PullRequestRef
149
+ * @property {string} id
150
+ * @property {string} number String: o identificador de PR também é do fornecedor.
151
+ * @property {string|null} url
152
+ * @property {string} title
153
+ * @property {string} body
154
+ * @property {'open'|'closed'|'merged'} state
155
+ * @property {boolean} draft
156
+ * @property {string|null} baseRef
157
+ * @property {string|null} headRef
158
+ * @property {string|null} [createdAt] ISO-8601. É o CORTE TEMPORAL do
159
+ * code-review: sub-issue nascida depois da abertura do PR não faz parte do
160
+ * que aquele PR entrega. Usa a data do PR e não o relógio do run porque
161
+ * precisa ser determinística — reprocessar o mesmo PR tem de dar o mesmo
162
+ * recorte.
163
+ * @property {ScmLink} link De QUAL repositório este PR veio. Obrigatório: o
164
+ * número colide entre repositórios, o par (link, número) não.
165
+ */
166
+
167
+ /**
168
+ * Um voto/veredito de revisor, CRU.
169
+ *
170
+ * O plugin não normaliza — dois plugins `vote` normalizariam diferente e
171
+ * `pr-ready` passaria a depender de qual está instalado. Quem agrega é
172
+ * `reviewDecision()` em `src/ports/scm.mjs`, no core.
173
+ *
174
+ * @typedef {object} Review
175
+ * @property {string} reviewer
176
+ * @property {string|null} submittedAt
177
+ * @property {'APPROVED'|'CHANGES_REQUESTED'|'COMMENTED'|'DISMISSED'|'PENDING'} [state]
178
+ * Só em `reviewModel: 'decision'`.
179
+ * @property {number} [vote] Só em `reviewModel: 'vote'` (−10…10).
180
+ */
181
+
182
+ /** @typedef {'approved'|'changes_requested'|'pending'} ReviewDecision */
183
+
184
+ /**
185
+ * @typedef {object} FileWrite
186
+ * @property {string} path
187
+ * @property {string} content
188
+ * @property {'utf-8'|'base64'} [encoding='utf-8'] Aditivo e sem uso na Fase 1
189
+ * (a evidência visual do QA vai por git local, não por aqui). Existe desde já
190
+ * porque `newContent.contentType` do Azure DevOps exige a decisão POR ARQUIVO,
191
+ * e descobrir isso na Fase 4 obrigaria a mudar a assinatura de `writeFiles`.
192
+ */
193
+
194
+ /**
195
+ * @typedef {object} CommitResult
196
+ * @property {string} branch
197
+ * @property {string} base
198
+ * @property {string} commitSha
199
+ * @property {boolean} createdBranch
200
+ * @property {boolean} unchanged Árvore idêntica à do pai — nada a commitar.
201
+ * Não é erro: commit vazio num PR só confunde quem revisa.
202
+ * @property {string} baseSha
203
+ */
204
+
205
+ /** @typedef {'identical'|'ahead'|'behind'|'diverged'|null} CompareStatus */
206
+
207
+ /**
208
+ * Uma execução de automação (workflow run, pipeline run).
209
+ *
210
+ * `status` e `conclusion` são separados porque uma run em andamento não tem
211
+ * conclusão. Colapsá-los num campo só obrigaria a inventar um valor `'running'`
212
+ * que não existe em nenhum dos dois fornecedores.
213
+ *
214
+ * `action_required` é um veredito à parte, e não um `failure`: ele significa
215
+ * que a run está BLOQUEADA esperando aprovação humana (ambiente protegido no
216
+ * Actions, gate de aprovação no Pipelines). O remédio é outro — alguém precisa
217
+ * aprovar, não corrigir —, e uma tela que o trate como falha manda o usuário
218
+ * depurar um problema que não existe. Ele entrou no enum depois de a
219
+ * spec-wave-ui apontar que a normalização o perdia: lá isso vira "a execução
220
+ * terminou sem gerar a spec" em vez de "está esperando aprovação".
221
+ *
222
+ * O que NÃO tem valor próprio, e por quê:
223
+ * • `startup_failure` (run que nem começou) normaliza para `failure` — o
224
+ * remédio é o mesmo, e um valor que significasse "falhou, só que antes" não
225
+ * muda decisão nenhuma;
226
+ * • `neutral` e `stale` viram `null` — "terminou sem veredito" já é o que
227
+ * `status: 'completed'` + `conclusion: null` diz.
228
+ *
229
+ * @typedef {object} AutomationRun
230
+ * @property {string} id
231
+ * @property {string} name
232
+ * @property {'queued'|'in_progress'|'completed'} status
233
+ * @property {'success'|'failure'|'cancelled'|'skipped'|'timed_out'|'action_required'|null} conclusion
234
+ * @property {string} createdAt
235
+ * @property {string|null} url
236
+ * @property {string|null} headBranch
237
+ */
238
+
239
+ /**
240
+ * Resultado de `verify()` — diagnóstico SEM efeito, nas duas portas.
241
+ *
242
+ * `facts` é o saco de "User vs Organization", título do project, contagem de
243
+ * campos: o que o `doctor` imprime e o core não interpreta. Sacola aberta de
244
+ * propósito — cada fornecedor tem fatos próprios, e forçá-los num schema
245
+ * fechado seria inventar campo que só um deles preenche.
246
+ *
247
+ * @typedef {object} VerifyResult
248
+ * @property {boolean} ok
249
+ * @property {{remaining: number|null, limit: number|null, resetAt: string|null}} quota
250
+ * @property {Record<string, string>} facts
251
+ * @property {string[]} problems
252
+ */
253
+
254
+ 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
  }
@@ -46,7 +46,7 @@ jobs:
46
46
  owner="$(jq -r '.hub.owner // ""' .spec-wave.json)"
47
47
  name="$(jq -r '.hub.repo // ""' .spec-wave.json)"
48
48
  if [ -z "$owner" ] || [ -z "$name" ]; then
49
- echo "::error::.spec-wave.json sem hub {owner, repo}. Rode: npx @spec-wave/cli@latest init --role code --repo ${{ github.repository }} --hub <owner/repo>"
49
+ echo "::error::.spec-wave.json sem hub {owner, repo}. Rode: npx @spec-wave/cli@{{CLI_VERSION}} init --role code --repo ${{ github.repository }} --hub <owner/repo>"
50
50
  exit 1
51
51
  fi
52
52
  echo "owner=$owner" >> "$GITHUB_OUTPUT"
@@ -45,7 +45,7 @@ jobs:
45
45
  owner="$(jq -r '.hub.owner // ""' .spec-wave.json)"
46
46
  name="$(jq -r '.hub.repo // ""' .spec-wave.json)"
47
47
  if [ -z "$owner" ] || [ -z "$name" ]; then
48
- echo "::error::.spec-wave.json sem hub {owner, repo}. Rode: npx @spec-wave/cli@latest init --role code --repo ${{ github.repository }} --hub <owner/repo>"
48
+ echo "::error::.spec-wave.json sem hub {owner, repo}. Rode: npx @spec-wave/cli@{{CLI_VERSION}} init --role code --repo ${{ github.repository }} --hub <owner/repo>"
49
49
  exit 1
50
50
  fi
51
51
  echo "owner=$owner" >> "$GITHUB_OUTPUT"