sdd-flow 1.0.0 → 1.2.4

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/bin/cli.js CHANGED
@@ -1,315 +1,380 @@
1
- #!/usr/bin/env node
2
-
3
- 'use strict';
4
-
5
- const fs = require('fs');
6
- const path = require('path');
7
- const rl = require('readline');
8
-
9
- const TEMPLATES = path.join(__dirname, '..', 'templates');
10
- const CWD = process.cwd();
11
- const VERSION = require('../package.json').version;
12
- const useColor = process.stdout.isTTY && !process.env.NO_COLOR;
13
-
14
- const c = useColor
15
- ? { reset: '\x1b[0m', bold: '\x1b[1m', green: '\x1b[32m',
16
- yellow: '\x1b[33m', cyan: '\x1b[36m', red: '\x1b[31m', dim: '\x1b[2m' }
17
- : { reset: '', bold: '', green: '', yellow: '', cyan: '', red: '', dim: '' };
18
-
19
- const log = (msg = '') => console.log(msg);
20
- const ok = (msg) => console.log(`${c.green}✔${c.reset} ${msg}`);
21
- const warn = (msg) => console.log(`${c.yellow}⚠${c.reset} ${msg}`);
22
- const info = (msg) => console.log(`${c.cyan}ℹ${c.reset} ${msg}`);
23
- const error = (msg) => console.log(`${c.red}✖${c.reset} ${msg}`);
24
- const bold = (msg) => `${c.bold}${msg}${c.reset}`;
25
- const dim = (msg) => `${c.dim}${msg}${c.reset}`;
26
-
27
- function ask(prompt) {
28
- const iface = rl.createInterface({ input: process.stdin, output: process.stdout });
29
- return new Promise(resolve =>
30
- iface.question(prompt, answer => { iface.close(); resolve(answer.trim()); })
31
- );
32
- }
33
-
34
- function copy(src, dest) {
35
- fs.mkdirSync(path.dirname(dest), { recursive: true });
36
- fs.copyFileSync(src, dest);
37
- }
38
-
39
- function copyDir(src, dest, exclude = []) {
40
- fs.mkdirSync(dest, { recursive: true });
41
- for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
42
- if (exclude.includes(entry.name)) continue;
43
- const srcPath = path.join(src, entry.name);
44
- const destPath = path.join(dest, entry.name);
45
- entry.isDirectory() ? copyDir(srcPath, destPath) : copy(srcPath, destPath);
46
- }
47
- }
48
-
49
- const HARNESS_CONFIG = {
50
- '2': {
51
- name: 'claude-code',
52
- commandsDest: path.join(CWD, '.claude', 'commands'),
53
- },
54
- '3': {
55
- name: 'opencode',
56
- commandsDest: path.join(CWD, '.opencode', 'commands'),
57
- },
58
- };
59
-
60
- function showSlashCommands() {
61
- log(bold('Slash commands disponíveis:'));
62
- log(` ${c.cyan}/sdd-research${c.reset} 001-nome-da-feature`);
63
- log(` ${c.cyan}/sdd-plan${c.reset} 001-nome-da-feature`);
64
- log(` ${c.cyan}/sdd-implement${c.reset} 001-nome-da-feature`);
65
- log(` ${c.cyan}/sdd-validate${c.reset} 001-nome-da-feature`);
66
- }
67
-
68
- function removeSddCommands(commandsDest) {
69
- if (!fs.existsSync(commandsDest)) return;
70
- for (const f of fs.readdirSync(commandsDest)) {
71
- if (f.startsWith('sdd-')) fs.rmSync(path.join(commandsDest, f));
72
- }
73
- }
74
-
75
- async function init() {
76
- log();
77
- log(bold('sdd-cli') + dim(' — Spec Driven Development workflow'));
78
- log();
79
-
80
- const agentsDir = path.join(CWD, 'agents');
81
- if (fs.existsSync(agentsDir)) {
82
- warn('A pasta agents/ já existe neste projeto.');
83
- const answer = await ask(' Deseja sobrescrever os arquivos do workflow? (s/N) ');
84
- if (answer.toLowerCase() !== 's') {
85
- info('Operação cancelada. Use ' + bold('sdd update') + ' para atualizar prompts e regras.');
86
- log();
87
- process.exit(0);
88
- }
89
- log();
90
- }
91
-
92
- copy(path.join(TEMPLATES, 'AGENTS.md'), path.join(CWD, 'AGENTS.md'));
93
- ok('AGENTS.md criado na raiz do projeto');
94
-
95
- copy(path.join(TEMPLATES, 'QUICKSTART.md'), path.join(CWD, 'QUICKSTART.md'));
96
- ok('QUICKSTART.md criado na raiz do projeto');
97
-
98
- copyDir(path.join(TEMPLATES, 'agents'), agentsDir, ['harness']);
99
- ok('Workflow instalado em agents/');
100
-
101
- log();
102
- info('O harness instala hooks de segurança e slash commands ' + dim('(opcional)'));
103
- log(' 1) Pular esta etapa');
104
- log(' 2) Claude Code');
105
- log(' 3) OpenCode');
106
- const choice = await ask(' Escolha [1]: ');
107
-
108
- const harnessCfg = HARNESS_CONFIG[choice];
109
- let harnessInstalled = false;
110
-
111
- if (harnessCfg) {
112
- const { name, commandsDest } = harnessCfg;
113
- const harnessSrc = path.join(TEMPLATES, 'agents', 'harness', name);
114
-
115
- if (fs.existsSync(harnessSrc)) {
116
- copyDir(harnessSrc, path.join(agentsDir, 'harness', name), ['commands']);
117
- ok(`Harness instalado: ${name}`);
118
-
119
- const cmdSrc = path.join(harnessSrc, 'commands');
120
- if (fs.existsSync(cmdSrc)) {
121
- copyDir(cmdSrc, commandsDest);
122
- ok(`Slash commands instalados em ${path.relative(CWD, commandsDest)}/`);
123
- }
124
-
125
- harnessInstalled = true;
126
- } else {
127
- warn(`Harness "${name}" não encontrado. Use sdd harness para instalar depois.`);
128
- }
129
- } else {
130
- info('Harness ignorado. Use ' + bold('sdd harness') + ' para instalar depois.');
131
- }
132
-
133
- log();
134
- log(bold('Próximos passos:'));
135
- log(` ${c.cyan}1.${c.reset} Abra uma sessão do seu agente no projeto`);
136
- log(` ${c.cyan}2.${c.reset} Instrua: ${dim('"Leia e siga agents/SETUP.md"')}`);
137
- log(` ${c.cyan}3.${c.reset} Forneça seu PRD ou descreva o projeto`);
138
- log(` ${c.cyan}4.${c.reset} Revise os arquivos gerados e delete agents/SETUP.md`);
139
- log();
140
-
141
- if (harnessInstalled) {
142
- showSlashCommands();
143
- } else {
144
- log(dim(' Sem slash commands — consulte QUICKSTART.md para instruções manuais.'));
145
- log(dim(' Para instalar depois: sdd harness'));
146
- }
147
-
148
- log();
149
- log(dim(' Documentação: https://github.com/moisesuailab/spec-driven-workflow'));
150
- log();
151
- }
152
-
153
- async function harness() {
154
- log();
155
- log(bold('sdd harness'));
156
- log();
157
-
158
- const agentsDir = path.join(CWD, 'agents');
159
- if (!fs.existsSync(agentsDir)) {
160
- error('Pasta agents/ não encontrada. Rode ' + bold('sdd init') + ' primeiro.');
161
- log();
162
- process.exit(1);
163
- }
164
-
165
- info('O que deseja fazer?');
166
- log(' 1) Remover harness atual');
167
- log(' 2) Instalar / trocar para Claude Code');
168
- log(' 3) Instalar / trocar para OpenCode');
169
- const choice = await ask(' Escolha: ');
170
-
171
- if (choice === '1') {
172
- const harnessDir = path.join(agentsDir, 'harness');
173
- if (fs.existsSync(harnessDir)) {
174
- fs.rmSync(harnessDir, { recursive: true });
175
- ok('Hooks removidos de agents/harness/');
176
- }
177
- for (const cfg of Object.values(HARNESS_CONFIG)) {
178
- removeSddCommands(cfg.commandsDest);
179
- if (fs.existsSync(cfg.commandsDest)) {
180
- ok(`Slash commands removidos de ${path.relative(CWD, cfg.commandsDest)}/`);
181
- }
182
- }
183
- log();
184
- ok('Harness desinstalado.');
185
- log();
186
- return;
187
- }
188
-
189
- const harnessCfg = HARNESS_CONFIG[choice];
190
- if (!harnessCfg) {
191
- info('Operação cancelada.');
192
- log();
193
- process.exit(0);
194
- }
195
-
196
- const { name, commandsDest } = harnessCfg;
197
- const harnessSrc = path.join(TEMPLATES, 'agents', 'harness', name);
198
-
199
- if (!fs.existsSync(harnessSrc)) {
200
- error(`Harness "${name}" não encontrado nos templates.`);
201
- process.exit(1);
202
- }
203
-
204
- for (const cfg of Object.values(HARNESS_CONFIG)) {
205
- removeSddCommands(cfg.commandsDest);
206
- }
207
-
208
- copyDir(harnessSrc, path.join(agentsDir, 'harness', name), ['commands']);
209
- ok(`Harness instalado: ${name}`);
210
-
211
- const cmdSrc = path.join(harnessSrc, 'commands');
212
- if (fs.existsSync(cmdSrc)) {
213
- copyDir(cmdSrc, commandsDest);
214
- ok(`Slash commands instalados em ${path.relative(CWD, commandsDest)}/`);
215
- }
216
-
217
- log();
218
- showSlashCommands();
219
- log();
220
- }
221
-
222
- async function update() {
223
- log();
224
- log(bold('sdd update'));
225
- log();
226
-
227
- const agentsDir = path.join(CWD, 'agents');
228
- if (!fs.existsSync(agentsDir)) {
229
- error('Pasta agents/ não encontrada. Rode ' + bold('sdd init') + ' primeiro.');
230
- log();
231
- process.exit(1);
232
- }
233
-
234
- warn('Isso atualizará AGENTS.md, RULES.md, QUICKSTART.md e todos os prompts.');
235
- const answer = await ask(' Deseja continuar? (s/N) ');
236
- if (answer.toLowerCase() !== 's') {
237
- info('Operação cancelada.');
238
- log();
239
- process.exit(0);
240
- }
241
- log();
242
-
243
- const coreFiles = [
244
- { rel: ['AGENTS.md'], dest: path.join(CWD, 'AGENTS.md') },
245
- { rel: ['QUICKSTART.md'], dest: path.join(CWD, 'QUICKSTART.md') },
246
- { rel: ['agents', 'AGENTS.md'], dest: path.join(agentsDir, 'AGENTS.md') },
247
- { rel: ['agents', 'RULES.md'], dest: path.join(agentsDir, 'RULES.md') },
248
- ];
249
-
250
- for (const { rel, dest } of coreFiles) {
251
- copy(path.join(TEMPLATES, ...rel), dest);
252
- ok(`Atualizado: ${rel.join('/')}`);
253
- }
254
-
255
- copyDir(
256
- path.join(TEMPLATES, 'agents', 'prompts'),
257
- path.join(agentsDir, 'prompts')
258
- );
259
- ok('Atualizado: agents/prompts/');
260
-
261
- log();
262
- info('Preservados (dados do projeto):');
263
- ['agents/PROJECT.md', 'agents/DECISIONS.md', 'agents/skills/', 'agents/specs/', 'agents/harness/']
264
- .forEach(f => log(` ${dim(f)}`));
265
- log();
266
- ok('Workflow atualizado com sucesso.');
267
- log();
268
- }
269
-
270
- function help() {
271
- log();
272
- log(bold('sdd-cli') + dim(' — Spec Driven Development workflow'));
273
- log();
274
- log('Uso:');
275
- log(` sdd-cli ${c.cyan}init${c.reset} Instala o workflow no projeto atual`);
276
- log(` sdd-cli ${c.cyan}harness${c.reset} Instala, troca ou remove o harness do agente`);
277
- log(` sdd-cli ${c.cyan}update${c.reset} Atualiza prompts e regras, preserva dados do projeto`);
278
- log(` sdd-cli ${c.cyan}help${c.reset} Exibe esta mensagem`);
279
- log(` sdd-cli ${c.cyan}--version${c.reset} Exibe a versão instalada`);
280
- log();
281
- log(dim(' Alias: sdd init / sdd harness / sdd update / sdd help / sdd --version'));
282
- log();
283
- log(dim(' Documentação: https://github.com/moisesuailab/spec-driven-workflow'));
284
- log();
285
- }
286
-
287
- const cmd = process.argv[2];
288
-
289
- switch (cmd) {
290
- case 'init':
291
- init().catch(e => { error(e.message); process.exit(1); });
292
- break;
293
- case 'harness':
294
- harness().catch(e => { error(e.message); process.exit(1); });
295
- break;
296
- case 'update':
297
- update().catch(e => { error(e.message); process.exit(1); });
298
- break;
299
- case 'help':
300
- case '--help':
301
- case '-h':
302
- help();
303
- break;
304
- case '--version':
305
- case '-v':
306
- log(VERSION);
307
- break;
308
- case undefined:
309
- help();
310
- break;
311
- default:
312
- error(`Comando desconhecido: "${cmd}"`);
313
- help();
314
- process.exit(1);
315
- }
1
+ #!/usr/bin/env node
2
+
3
+ 'use strict';
4
+
5
+ const fs = require('fs');
6
+ const path = require('path');
7
+ const rl = require('readline');
8
+
9
+ const TEMPLATES = path.join(__dirname, '..', 'templates');
10
+ const CWD = process.cwd();
11
+ const VERSION = require('../package.json').version;
12
+ const useColor = process.stdout.isTTY && !process.env.NO_COLOR;
13
+
14
+ const c = useColor
15
+ ? { reset: '\x1b[0m', bold: '\x1b[1m', green: '\x1b[32m',
16
+ yellow: '\x1b[33m', cyan: '\x1b[36m', red: '\x1b[31m', dim: '\x1b[2m' }
17
+ : { reset: '', bold: '', green: '', yellow: '', cyan: '', red: '', dim: '' };
18
+
19
+ const log = (msg = '') => console.log(msg);
20
+ const ok = (msg) => console.log(`${c.green}✔${c.reset} ${msg}`);
21
+ const warn = (msg) => console.log(`${c.yellow}⚠${c.reset} ${msg}`);
22
+ const info = (msg) => console.log(`${c.cyan}ℹ${c.reset} ${msg}`);
23
+ const error = (msg) => console.log(`${c.red}✖${c.reset} ${msg}`);
24
+ const bold = (msg) => `${c.bold}${msg}${c.reset}`;
25
+ const dim = (msg) => `${c.dim}${msg}${c.reset}`;
26
+
27
+ function ask(prompt) {
28
+ const iface = rl.createInterface({ input: process.stdin, output: process.stdout });
29
+ return new Promise(resolve =>
30
+ iface.question(prompt, answer => { iface.close(); resolve(answer.trim()); })
31
+ );
32
+ }
33
+
34
+ function copy(src, dest) {
35
+ fs.mkdirSync(path.dirname(dest), { recursive: true });
36
+ fs.copyFileSync(src, dest);
37
+ }
38
+
39
+ function copyDir(src, dest, exclude = []) {
40
+ fs.mkdirSync(dest, { recursive: true });
41
+ for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
42
+ if (exclude.includes(entry.name)) continue;
43
+ const srcPath = path.join(src, entry.name);
44
+ const destPath = path.join(dest, entry.name);
45
+ entry.isDirectory() ? copyDir(srcPath, destPath) : copy(srcPath, destPath);
46
+ }
47
+ }
48
+
49
+ const HARNESS_CONFIG = {
50
+ '2': {
51
+ name: 'claude-code',
52
+ commandsDest: path.join(CWD, '.claude', 'commands'),
53
+ },
54
+ '3': {
55
+ name: 'opencode',
56
+ commandsDest: path.join(CWD, '.opencode', 'commands'),
57
+ },
58
+ };
59
+
60
+ function showSlashCommands() {
61
+ log(bold('Slash commands disponíveis:'));
62
+ log(` ${c.cyan}/sdd-research${c.reset} 001-nome-da-feature`);
63
+ log(` ${c.cyan}/sdd-plan${c.reset} 001-nome-da-feature`);
64
+ log(` ${c.cyan}/sdd-implement${c.reset} 001-nome-da-feature`);
65
+ log(` ${c.cyan}/sdd-validate${c.reset} 001-nome-da-feature`);
66
+ }
67
+
68
+ function removeSddCommands(commandsDest) {
69
+ if (!fs.existsSync(commandsDest)) return;
70
+ for (const f of fs.readdirSync(commandsDest)) {
71
+ if (f.startsWith('sdd-')) fs.rmSync(path.join(commandsDest, f));
72
+ }
73
+ }
74
+
75
+ async function init() {
76
+ log();
77
+ log(bold('sdd-cli') + dim(' — Spec Driven Development workflow'));
78
+ log();
79
+
80
+ const agentsDir = path.join(CWD, 'agents');
81
+ if (fs.existsSync(agentsDir)) {
82
+ warn('A pasta agents/ já existe neste projeto.');
83
+ const answer = await ask(' Deseja sobrescrever os arquivos do workflow? (s/N) ');
84
+ if (answer.toLowerCase() !== 's') {
85
+ info('Operação cancelada. Use ' + bold('sdd update') + ' para atualizar prompts e regras.');
86
+ log();
87
+ process.exit(0);
88
+ }
89
+ log();
90
+ }
91
+
92
+ copy(path.join(TEMPLATES, 'AGENTS.md'), path.join(CWD, 'AGENTS.md'));
93
+ ok('AGENTS.md criado na raiz do projeto');
94
+
95
+ copy(path.join(TEMPLATES, 'QUICKSTART.md'), path.join(CWD, 'QUICKSTART.md'));
96
+ ok('QUICKSTART.md criado na raiz do projeto');
97
+
98
+ copyDir(path.join(TEMPLATES, 'agents'), agentsDir, ['harness']);
99
+ ok('Workflow instalado em agents/');
100
+
101
+ log();
102
+ info('O harness instala hooks de segurança e slash commands ' + dim('(opcional)'));
103
+ log(' 1) Pular esta etapa');
104
+ log(' 2) Claude Code');
105
+ log(' 3) OpenCode');
106
+ const choice = await ask(' Escolha [1]: ');
107
+
108
+ const harnessCfg = HARNESS_CONFIG[choice];
109
+ let harnessInstalled = false;
110
+
111
+ if (harnessCfg) {
112
+ const { name, commandsDest } = harnessCfg;
113
+ const harnessSrc = path.join(TEMPLATES, 'agents', 'harness', name);
114
+
115
+ if (fs.existsSync(harnessSrc)) {
116
+ copyDir(harnessSrc, path.join(agentsDir, 'harness', name), ['commands']);
117
+ ok(`Harness instalado: ${name}`);
118
+
119
+ const cmdSrc = path.join(harnessSrc, 'commands');
120
+ if (fs.existsSync(cmdSrc)) {
121
+ copyDir(cmdSrc, commandsDest);
122
+ ok(`Slash commands instalados em ${path.relative(CWD, commandsDest)}/`);
123
+ }
124
+
125
+ harnessInstalled = true;
126
+ } else {
127
+ warn(`Harness "${name}" não encontrado. Use sdd harness para instalar depois.`);
128
+ }
129
+ } else {
130
+ info('Harness ignorado. Use ' + bold('sdd harness') + ' para instalar depois.');
131
+ }
132
+
133
+ log();
134
+ log(bold('Próximos passos:'));
135
+ log(` ${c.cyan}1.${c.reset} Abra uma sessão do seu agente no projeto`);
136
+ log(` ${c.cyan}2.${c.reset} Instrua: ${dim('"Leia e siga agents/SETUP.md"')}`);
137
+ log(` ${c.cyan}3.${c.reset} Forneça seu PRD ou descreva o projeto`);
138
+ log(` ${c.cyan}4.${c.reset} Revise os arquivos gerados e delete agents/SETUP.md`);
139
+ log();
140
+
141
+ if (harnessInstalled) {
142
+ showSlashCommands();
143
+ } else {
144
+ log(dim(' Sem slash commands — consulte QUICKSTART.md para instruções manuais.'));
145
+ log(dim(' Para instalar depois: sdd harness'));
146
+ }
147
+
148
+ log();
149
+ log(dim(' Documentação: https://github.com/moisesuailab/spec-driven-workflow'));
150
+ log();
151
+ }
152
+
153
+ async function harness() {
154
+ log();
155
+ log(bold('sdd harness'));
156
+ log();
157
+
158
+ const agentsDir = path.join(CWD, 'agents');
159
+ if (!fs.existsSync(agentsDir)) {
160
+ error('Pasta agents/ não encontrada. Rode ' + bold('sdd init') + ' primeiro.');
161
+ log();
162
+ process.exit(1);
163
+ }
164
+
165
+ info('O que deseja fazer?');
166
+ log(' 1) Remover harness atual');
167
+ log(' 2) Instalar / trocar para Claude Code');
168
+ log(' 3) Instalar / trocar para OpenCode');
169
+ const choice = await ask(' Escolha: ');
170
+
171
+ if (choice === '1') {
172
+ const harnessDir = path.join(agentsDir, 'harness');
173
+ if (fs.existsSync(harnessDir)) {
174
+ fs.rmSync(harnessDir, { recursive: true });
175
+ ok('Hooks removidos de agents/harness/');
176
+ }
177
+ for (const cfg of Object.values(HARNESS_CONFIG)) {
178
+ removeSddCommands(cfg.commandsDest);
179
+ if (fs.existsSync(cfg.commandsDest)) {
180
+ ok(`Slash commands removidos de ${path.relative(CWD, cfg.commandsDest)}/`);
181
+ }
182
+ }
183
+ log();
184
+ ok('Harness desinstalado.');
185
+ log();
186
+ return;
187
+ }
188
+
189
+ const harnessCfg = HARNESS_CONFIG[choice];
190
+ if (!harnessCfg) {
191
+ info('Operação cancelada.');
192
+ log();
193
+ process.exit(0);
194
+ }
195
+
196
+ const { name, commandsDest } = harnessCfg;
197
+ const harnessSrc = path.join(TEMPLATES, 'agents', 'harness', name);
198
+
199
+ if (!fs.existsSync(harnessSrc)) {
200
+ error(`Harness "${name}" não encontrado nos templates.`);
201
+ process.exit(1);
202
+ }
203
+
204
+ for (const cfg of Object.values(HARNESS_CONFIG)) {
205
+ removeSddCommands(cfg.commandsDest);
206
+ }
207
+
208
+ copyDir(harnessSrc, path.join(agentsDir, 'harness', name), ['commands']);
209
+ ok(`Harness instalado: ${name}`);
210
+
211
+ const cmdSrc = path.join(harnessSrc, 'commands');
212
+ if (fs.existsSync(cmdSrc)) {
213
+ copyDir(cmdSrc, commandsDest);
214
+ ok(`Slash commands instalados em ${path.relative(CWD, commandsDest)}/`);
215
+ }
216
+
217
+ log();
218
+ showSlashCommands();
219
+ log();
220
+ }
221
+
222
+ async function update() {
223
+ log();
224
+ log(bold('sdd update'));
225
+ log();
226
+
227
+ const agentsDir = path.join(CWD, 'agents');
228
+ if (!fs.existsSync(agentsDir)) {
229
+ error('Pasta agents/ não encontrada. Rode ' + bold('sdd init') + ' primeiro.');
230
+ log();
231
+ process.exit(1);
232
+ }
233
+
234
+ warn('Isso atualizará AGENTS.md, RULES.md, QUICKSTART.md e todos os prompts.');
235
+ const answer = await ask(' Deseja continuar? (s/N) ');
236
+ if (answer.toLowerCase() !== 's') {
237
+ info('Operação cancelada.');
238
+ log();
239
+ process.exit(0);
240
+ }
241
+ log();
242
+
243
+ const coreFiles = [
244
+ { rel: ['AGENTS.md'], dest: path.join(CWD, 'AGENTS.md') },
245
+ { rel: ['QUICKSTART.md'], dest: path.join(CWD, 'QUICKSTART.md') },
246
+ { rel: ['agents', 'AGENTS.md'], dest: path.join(agentsDir, 'AGENTS.md') },
247
+ { rel: ['agents', 'RULES.md'], dest: path.join(agentsDir, 'RULES.md') },
248
+ ];
249
+
250
+ for (const { rel, dest } of coreFiles) {
251
+ copy(path.join(TEMPLATES, ...rel), dest);
252
+ ok(`Atualizado: ${rel.join('/')}`);
253
+ }
254
+
255
+ copyDir(
256
+ path.join(TEMPLATES, 'agents', 'prompts'),
257
+ path.join(agentsDir, 'prompts')
258
+ );
259
+ ok('Atualizado: agents/prompts/');
260
+
261
+ log();
262
+ info('Preservados (dados do projeto):');
263
+ ['agents/PROJECT.md', 'agents/DECISIONS.md', 'agents/skills/', 'agents/specs/', 'agents/harness/']
264
+ .forEach(f => log(` ${dim(f)}`));
265
+ log();
266
+ ok('Workflow atualizado com sucesso.');
267
+ log();
268
+ }
269
+
270
+ function nextSpecNumber(specsDir) {
271
+ if (!fs.existsSync(specsDir)) return '001';
272
+ const entries = fs.readdirSync(specsDir, { withFileTypes: true })
273
+ .filter(e => e.isDirectory())
274
+ .map(e => parseInt(e.name.slice(0, 3), 10))
275
+ .filter(n => !isNaN(n));
276
+ const max = entries.length ? Math.max(...entries) : 0;
277
+ return String(max + 1).padStart(3, '0');
278
+ }
279
+
280
+ function newSpec(rawName) {
281
+ log();
282
+ log(bold('sdd new'));
283
+ log();
284
+
285
+ const agentsDir = path.join(CWD, 'agents');
286
+ if (!fs.existsSync(agentsDir)) {
287
+ error('Pasta agents/ não encontrada. Rode ' + bold('sdd init') + ' primeiro.');
288
+ log();
289
+ process.exit(1);
290
+ }
291
+
292
+ if (!rawName) {
293
+ error('Informe o nome da feature: ' + bold('sdd new <nome-da-feature>'));
294
+ log(' Exemplo: ' + dim('sdd new user-authentication'));
295
+ log();
296
+ process.exit(1);
297
+ }
298
+
299
+ const name = rawName.toLowerCase().trim().replace(/\s+/g, '-').replace(/[^a-z0-9-]/g, '');
300
+ if (!name) {
301
+ error('Nome inválido. Use apenas letras, números e hífens.');
302
+ log();
303
+ process.exit(1);
304
+ }
305
+
306
+ const specsDir = path.join(agentsDir, 'specs');
307
+ const num = nextSpecNumber(specsDir);
308
+ const slug = num + '-' + name;
309
+ const specDir = path.join(specsDir, slug);
310
+
311
+ if (fs.existsSync(specDir)) {
312
+ error('Spec já existe: agents/specs/' + slug + '/');
313
+ log();
314
+ process.exit(1);
315
+ }
316
+
317
+ fs.mkdirSync(specDir, { recursive: true });
318
+ fs.writeFileSync(
319
+ path.join(specDir, 'DECISIONS.md'),
320
+ '# DECISIONS — ' + name + '\n\n(decisões arquiteturais registradas durante o ciclo)\n'
321
+ );
322
+
323
+ ok('Spec criada: agents/specs/' + slug + '/');
324
+ log();
325
+ log(bold('Próximo passo — inicie a fase de Research:'));
326
+ log(' ' + c.cyan + '/sdd-research' + c.reset + ' ' + slug);
327
+ log(' ' + dim('"Leia e siga agents/prompts/rpi-research.md. Spec: ' + slug + '"'));
328
+ log();
329
+ }
330
+
331
+ function help() {
332
+ log();
333
+ log(bold('sdd-cli') + dim(' — Spec Driven Development workflow'));
334
+ log();
335
+ log('Uso:');
336
+ log(` sdd-cli ${c.cyan}init${c.reset} Instala o workflow no projeto atual`);
337
+ log(` sdd-cli ${c.cyan}new <nome>${c.reset} Cria pasta da spec com numeração automática`);
338
+ log(` sdd-cli ${c.cyan}harness${c.reset} Instala, troca ou remove o harness do agente`);
339
+ log(` sdd-cli ${c.cyan}update${c.reset} Atualiza prompts e regras, preserva dados do projeto`);
340
+ log(` sdd-cli ${c.cyan}help${c.reset} Exibe esta mensagem`);
341
+ log(` sdd-cli ${c.cyan}--version${c.reset} Exibe a versão instalada`);
342
+ log();
343
+ log(dim(' Alias: sdd init / sdd new / sdd harness / sdd update / sdd help / sdd --version'));
344
+ log();
345
+ log(dim(' Documentação: https://github.com/moisesuailab/spec-driven-workflow'));
346
+ log();
347
+ }
348
+
349
+ const cmd = process.argv[2];
350
+
351
+ switch (cmd) {
352
+ case 'init':
353
+ init().catch(e => { error(e.message); process.exit(1); });
354
+ break;
355
+ case 'new':
356
+ newSpec(process.argv[3]);
357
+ break;
358
+ case 'harness':
359
+ harness().catch(e => { error(e.message); process.exit(1); });
360
+ break;
361
+ case 'update':
362
+ update().catch(e => { error(e.message); process.exit(1); });
363
+ break;
364
+ case 'help':
365
+ case '--help':
366
+ case '-h':
367
+ help();
368
+ break;
369
+ case '--version':
370
+ case '-v':
371
+ log(VERSION);
372
+ break;
373
+ case undefined:
374
+ help();
375
+ break;
376
+ default:
377
+ error(`Comando desconhecido: "${cmd}"`);
378
+ help();
379
+ process.exit(1);
380
+ }