@spec-wave/cli 1.0.8 → 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.
- package/package.json +1 -1
- package/src/commands/audit.mjs +24 -18
- package/src/commands/code-review.mjs +89 -58
- package/src/commands/decompose.mjs +254 -218
- package/src/commands/generate-bug.mjs +51 -44
- package/src/commands/generate-plan.mjs +83 -63
- package/src/commands/generate-qa-plan.mjs +144 -117
- package/src/commands/generate-spec.mjs +33 -28
- package/src/commands/implement.mjs +154 -79
- package/src/commands/init.mjs +8 -3
- package/src/commands/issue.mjs +26 -39
- package/src/commands/merge.mjs +71 -20
- package/src/commands/mode.mjs +8 -4
- package/src/commands/move.mjs +16 -20
- package/src/commands/order.mjs +33 -22
- package/src/commands/preflight.mjs +24 -13
- package/src/commands/qa-lead.mjs +28 -16
- package/src/commands/qa-run.mjs +122 -101
- package/src/commands/qa.mjs +55 -44
- package/src/commands/refresh.mjs +24 -16
- package/src/commands/repair-stage.mjs +29 -16
- package/src/commands/repo.mjs +10 -3
- package/src/commands/run.mjs +23 -11
- package/src/commands/story.mjs +20 -25
- package/src/commands/task.mjs +21 -27
- package/src/commands/triage.mjs +33 -31
- package/src/commands/uninstall.mjs +7 -3
- package/src/commands/update.mjs +29 -21
- package/src/commands/validate.mjs +60 -52
- package/src/commands/workspace.mjs +7 -5
- package/src/config.mjs +7 -1
- package/src/lib/artifact-publish.mjs +20 -18
- package/src/lib/board-policy.mjs +144 -0
- package/src/lib/board.mjs +134 -233
- package/src/lib/doc-availability.mjs +10 -3
- package/src/lib/doc-source.mjs +9 -9
- package/src/lib/implement-board.mjs +23 -26
- package/src/lib/issue-type.mjs +5 -1
- package/src/lib/pr-ready.mjs +48 -10
- package/src/lib/pr-step.mjs +3 -1
- package/src/lib/qa-exec.mjs +3 -1
- package/src/lib/qa-lead.mjs +11 -3
- package/src/lib/qa-plan-doc.mjs +10 -4
- package/src/lib/spec-audit.mjs +1 -1
- package/src/lib/story-graph.mjs +62 -8
- package/src/lib/usage-report.mjs +8 -5
- package/src/lib/work-item-ref.mjs +176 -0
- package/src/plugin/.claude-plugin/plugin.json +1 -1
- package/src/plugins/scm-github/index.mjs +439 -0
- package/src/plugins/tracker-github-projects/fields.mjs +73 -0
- package/src/plugins/tracker-github-projects/index.mjs +625 -0
- package/src/ports/scm.mjs +197 -0
- package/src/ports/tracker.mjs +239 -0
- package/src/ports/types.mjs +254 -0
- package/src/setup/files.mjs +14 -12
- package/src/setup/labels.mjs +17 -12
- package/src/setup/project.mjs +40 -59
|
@@ -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 {};
|
package/src/setup/files.mjs
CHANGED
|
@@ -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
|
|
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
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
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
|
|
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
|
|
86
|
+
await scm.installAutomation({ files: [file] });
|
|
85
87
|
}
|
|
86
88
|
}
|
package/src/setup/labels.mjs
CHANGED
|
@@ -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
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
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
|
}
|
package/src/setup/project.mjs
CHANGED
|
@@ -1,62 +1,43 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
//
|
|
11
|
-
//
|
|
12
|
-
//
|
|
13
|
-
//
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
const
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
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 { ...
|
|
40
|
+
return { ...config, linkWarning: warnings[0] };
|
|
59
41
|
}
|
|
60
|
-
|
|
61
|
-
return result;
|
|
42
|
+
return config;
|
|
62
43
|
}
|