vireum-spec-cli 0.2.0 → 0.3.0

package/dist/commands/retrofit.js

@@ -114,11 +114,11 @@ async function runRetrofit() {
         default: false,
     });
     const featuresAtivas = await (0, prompts_1.input)({
-        message: 'Liste as funcionalidades JA implementadas (separadas por virgula):',
-        default: analise.features.join(', '),
+        message: 'Liste as funcionalidades JA implementadas (separadas por virgula — Enter para pular):',
+        default: analise.features.length ? analise.features.join(', ') : '',
     });
     const featuresPendentes = await (0, prompts_1.input)({
-        message: 'Liste as funcionalidades PENDENTES ou em desenvolvimento:',
+        message: 'Liste as funcionalidades PENDENTES (separadas por virgula — Enter para pular):',
     });
     const riscos = await (0, prompts_1.input)({
         message: 'Riscos tecnicos identificados:',
@@ -128,8 +128,8 @@ async function runRetrofit() {
     const dados = {
         projeto, cliente, objetivo, problema, prioridade,
         usuarios, regras, fase, multiTenant, lgpd,
-        featuresAtivas: featuresAtivas.split(',').map(f => f.trim()).filter(Boolean),
-        featuresPendentes: featuresPendentes.split(',').map(f => f.trim()).filter(Boolean),
+        featuresAtivas: featuresAtivas ? featuresAtivas.split(',').map(f => f.trim()).filter(Boolean) : [],
+        featuresPendentes: featuresPendentes ? featuresPendentes.split(',').map(f => f.trim()).filter(Boolean) : [],
         riscos, analise,
         data: new Date().toLocaleDateString('pt-BR'),
     };
@@ -154,7 +154,6 @@ async function runRetrofit() {
         fs.writeFileSync(path.join(specDir, arq.nome), arq.conteudo, 'utf-8');
         s.succeed(arq.nome);
     }
-    // tasks
     const s1 = (0, ora_1.default)('Gerando tasks...').start();
     await sleep(400);
     fs.writeFileSync(path.join(tasksDir, 'active.md'), gerarTasksActive(dados), 'utf-8');
@@ -185,7 +184,6 @@ function analisarProjeto(cwd) {
             cache: '',
         },
     };
-    // package.json
     const pkgPath = path.join(cwd, 'package.json');
     if (fs.existsSync(pkgPath)) {
         try {
@@ -193,7 +191,6 @@ function analisarProjeto(cwd) {
             resultado.nome = pkg.name || '';
             resultado.descricao = pkg.description || '';
             const deps = { ...pkg.dependencies, ...pkg.devDependencies };
-            // Frontend
             if (deps['next'])
                 resultado.stack.frontend = 'Next.js';
             else if (deps['react'])
@@ -202,14 +199,12 @@ function analisarProjeto(cwd) {
                 resultado.stack.frontend = 'Vue';
             else if (deps['nuxt'])
                 resultado.stack.frontend = 'Nuxt';
-            // Backend
             if (deps['fastify'])
                 resultado.stack.backend = 'Node.js + Fastify';
             else if (deps['express'])
                 resultado.stack.backend = 'Node.js + Express';
             else if (deps['@nestjs/core'])
                 resultado.stack.backend = 'NestJS';
-            // Banco
             if (deps['pg'] || deps['postgres'])
                 resultado.stack.banco = 'PostgreSQL';
             else if (deps['mysql2'])
@@ -218,29 +213,25 @@ function analisarProjeto(cwd) {
                 resultado.stack.banco = 'SQLite';
             else if (deps['mongoose'])
                 resultado.stack.banco = 'MongoDB';
-            // ORM
             if (deps['prisma'] || deps['@prisma/client'])
                 resultado.stack.orm = 'Prisma';
             else if (deps['typeorm'])
                 resultado.stack.orm = 'TypeORM';
             else if (deps['drizzle-orm'])
                 resultado.stack.orm = 'Drizzle';
-            // Auth
             if (deps['jsonwebtoken'])
                 resultado.stack.auth = 'JWT';
             else if (deps['next-auth'])
                 resultado.stack.auth = 'NextAuth';
             else if (deps['@clerk/nextjs'])
                 resultado.stack.auth = 'Clerk';
-            // Cache
-            if (deps['ioredis'] || deps['redis'])
-                resultado.stack.cache = 'Redis';
             if (deps['bullmq'])
                 resultado.stack.cache = 'Redis + BullMQ';
+            else if (deps['ioredis'] || deps['redis'])
+                resultado.stack.cache = 'Redis';
         }
         catch { }
     }
-    // README
     const readmePath = path.join(cwd, 'README.md');
     if (fs.existsSync(readmePath)) {
         resultado.readme = true;
@@ -249,41 +240,63 @@ function analisarProjeto(cwd) {
         if (desc)
             resultado.descricao = resultado.descricao || desc.trim();
     }
-    // Rotas — procura em src/
-    const srcDir = path.join(cwd, 'src');
-    if (fs.existsSync(srcDir)) {
-        resultado.features = extrairRotas(srcDir);
-        resultado.arquivos = contarArquivos(srcDir);
+    const pastasCodigo = ['src', 'app', 'pages', 'components', 'server', 'api'];
+    let totalArquivos = 0;
+    const todasRotas = [];
+    for (const pasta of pastasCodigo) {
+        const dir = path.join(cwd, pasta);
+        if (fs.existsSync(dir)) {
+            todasRotas.push(...extrairRotas(dir));
+            totalArquivos += contarArquivos(dir);
+        }
     }
+    resultado.features = [...new Set(todasRotas)].slice(0, 20);
+    resultado.arquivos = totalArquivos;
     return resultado;
 }
 function extrairRotas(dir) {
     const rotas = [];
-    const exts = ['.ts', '.js'];
+    const exts = ['.ts', '.tsx', '.js', '.jsx'];
     function walk(d) {
         if (!fs.existsSync(d))
             return;
         for (const entry of fs.readdirSync(d)) {
             const full = path.join(d, entry);
             const stat = fs.statSync(full);
-            if (stat.isDirectory() && !entry.includes('node_modules')) {
+            if (stat.isDirectory() && !['node_modules', '.next', 'dist', '.git'].includes(entry)) {
                 walk(full);
             }
             else if (exts.includes(path.extname(entry))) {
-                const content = fs.readFileSync(full, 'utf-8');
-                const matches = content.match(/\.(get|post|put|patch|delete|route)\(['"`]([^'"`]+)/gi);
-                if (matches) {
-                    matches.forEach(m => {
-                        const rota = m.replace(/\.(get|post|put|patch|delete|route)\(['"`]/i, '').trim();
-                        if (rota && !rotas.includes(rota))
-                            rotas.push(rota);
-                    });
+                try {
+                    const content = fs.readFileSync(full, 'utf-8');
+                    const apiMatches = content.match(/\.(get|post|put|patch|delete|route)\(['"`]([^'"`]+)/gi);
+                    if (apiMatches) {
+                        apiMatches.forEach(m => {
+                            const rota = m.replace(/\.(get|post|put|patch|delete|route)\(['"`]/i, '').trim();
+                            if (rota && !rotas.includes(rota))
+                                rotas.push(rota);
+                        });
+                    }
+                    if (entry === 'page.tsx' || entry === 'page.ts') {
+                        const relativo = path.relative(dir, full)
+                            .replace(/\\/g, '/')
+                            .replace('/page.tsx', '')
+                            .replace('/page.ts', '');
+                        if (relativo && !rotas.includes(relativo))
+                            rotas.push(`page: /${relativo}`);
+                    }
+                    if (d.includes('pages') && (entry.endsWith('.tsx') || entry.endsWith('.ts')) && !entry.startsWith('_')) {
+                        const pagina = entry.replace('.tsx', '').replace('.ts', '');
+                        if (!rotas.includes(pagina))
+                            rotas.push(`page: ${pagina}`);
+                    }
                 }
+                catch { }
             }
         }
     }
     walk(dir);
-    return rotas.slice(0, 20);
+    return rotas;
 }
 function contarArquivos(dir) {
     let count = 0;
@@ -292,8 +305,9 @@ function contarArquivos(dir) {
             return;
         for (const entry of fs.readdirSync(d)) {
             const full = path.join(d, entry);
-            if (fs.statSync(full).isDirectory() && !entry.includes('node_modules'))
+            if (fs.statSync(full).isDirectory() && !['node_modules', '.next', 'dist', '.git'].includes(entry)) {
                 walk(full);
+            }
             else
                 count++;
         }

package/dist/commands/setup.js

@@ -149,6 +149,7 @@ async function runSetup() {
     const mcpsSelecionados = await (0, prompts_1.checkbox)({
         message: 'Selecione os MCPs para este projeto:',
         choices: [
+            { name: 'context7   — docs atualizadas das libs do projeto', value: 'context7', checked: true },
             { name: 'github     — PRs, issues, branches', value: 'github', checked: true },
             { name: 'database   — consultar banco em dev', value: 'database', checked: true },
             { name: 'browser    — testar endpoints e fluxos', value: 'browser', checked: true },
@@ -157,10 +158,14 @@ async function runSetup() {
             { name: 'redis      — inspecionar cache e filas', value: 'redis', checked: false },
         ],
     });
+    // Context7 sempre presente
+    const mcpsFinais = mcpsSelecionados.includes('context7')
+        ? mcpsSelecionados
+        : ['context7', ...mcpsSelecionados];
     // ── Gerar arquivos ─────────────────────────────────────────────────────────
     console.log('');
     const projeto = extrairProjeto(path.join(specDir, 'INDEX.md'));
-    const dados = { stack, infra, mcps: mcpsSelecionados, projeto };
+    const dados = { stack, infra, mcps: mcpsFinais, projeto };
     for (const dir of [vireumDir, cursorDir]) {
         if (!fs.existsSync(dir))
             fs.mkdirSync(dir, { recursive: true });
@@ -236,6 +241,7 @@ ${mcps.map((m) => `- ${m}`).join('\n')}
 }
 function gerarMcpSetup(d) {
     const mcpInfo = {
+        context7: 'https://github.com/upstash/context7',
         github: 'https://github.com/modelcontextprotocol/servers/tree/main/src/github',
         database: 'https://github.com/modelcontextprotocol/servers/tree/main/src/postgres',
         browser: 'https://github.com/modelcontextprotocol/servers/tree/main/src/puppeteer',
@@ -256,7 +262,7 @@ ${lista}
 1. Acesse o link de cada MCP acima
 2. Siga as instruções de instalação
 3. Configure as credenciais manualmente no seu cliente (Claude Code / Cursor)
-4. Execute: vireum-spec verify-mcps (em breve)
+4. Execute: vireum-spec verify-mcps
 `;
 }
 function gerarRulesGlobal() {
@@ -300,18 +306,20 @@ function gerarMcpsGlobal(d) {
 > MCPs ativos por projeto estão em .spec/architecture.md
 
 ## Stack Padrão
-- filesystem  — leitura e escrita no projeto (nativo)
-- github      — PRs, issues, branches referenciando tasks
-- database    — validar schema e dados em desenvolvimento
-- browser     — testar endpoints e validar fluxos
-- puppeteer   — testes de jornada de UI
-- docker      — gerenciar containers em desenvolvimento
-- redis       — inspecionar cache e filas (quando aplicável)
+- context7   — documentação atualizada das libs (sempre ativo)
+- filesystem — leitura e escrita no projeto (nativo)
+- github     — PRs, issues, branches referenciando tasks
+- database   — validar schema e dados em desenvolvimento
+- browser    — testar endpoints e validar fluxos
+- puppeteer  — testes de jornada de UI
+- docker     — gerenciar containers em desenvolvimento
+- redis      — inspecionar cache e filas (quando aplicável)
 
 ## MCPs Ativos Neste Projeto
 ${d.mcps.map((m) => `- ${m}`).join('\n')}
 
 ## Quando usar cada MCP
+- Antes de usar qualquer lib → context7: buscar docs atualizadas
 - Task concluída → github: criar PR referenciando a task
 - Bug identificado → github: abrir issue com contexto
 - Decisão de schema → database: validar antes de implementar
@@ -323,6 +331,9 @@ function gerarClaudeMd(d) {
     const { projeto, stack, mcps } = d;
     const tenant = stack.multiTenant
         ? '\n- NUNCA fazer query sem filtro de tenantId — projeto multi-tenant' : '';
+    const libs = [stack.frontend, stack.backend, stack.orm, stack.cache]
+        .filter((l) => l && l !== 'Nenhum' && l !== 'Outro')
+        .join(', ');
     return `# ${projeto} — Vireum Spec Protocol
 
 > Este projeto usa Spec Driven Development pela Vireum Desenvolvimento.
@@ -339,9 +350,10 @@ function gerarClaudeMd(d) {
 Acionado por: "desenvolve", "implementa", "cria", + nome de task
 1. Leia \`.spec/tasks/active.md\`
 2. Leia \`.spec/requirements.md\` para contexto da feature
-3. Implemente seguindo os critérios de aceitação da task
-4. Ao concluir: marque como done, mova para \`tasks/done.md\`, atualize \`INDEX.md\`
-5. Se decisão arquitetural tomada: registre em \`architecture.md\`
+3. Consulte o Context7 para docs atualizadas da lib que vai usar
+4. Implemente seguindo os critérios de aceitação da task
+5. Ao concluir: marque como done, mova para \`tasks/done.md\`, atualize \`INDEX.md\`
+6. Se decisão arquitetural tomada: registre em \`architecture.md\`
 
 ### Modo 2 — Bug
 Acionado por: "erro", "bug", "quebrou", "não funciona"
@@ -362,6 +374,11 @@ Acionado por: "como deve funcionar", "o que foi combinado", "qual o comportament
 1. Leia \`.spec/requirements.md\`
 2. Responda com base no spec — não invente comportamento
 
+## Context7 — Documentação atualizada
+Sempre que for usar uma lib do projeto, consulte a documentação atualizada via Context7 antes de implementar.
+Nunca assuma que você conhece a API mais recente — sempre verifique.
+Libs deste projeto: ${libs}
+
 ## Regras globais
 Leia \`.vireum/rules.md\` — aplicam-se a todas as sessões.
 
@@ -394,10 +411,13 @@ function gerarAgentsMd(d) {
 2. Identifique o modo pela solicitação
 3. Siga o protocolo em CLAUDE.md
 
+## Context7
+Sempre consultar docs atualizadas via Context7 antes de usar qualquer lib.
+
 ## Regras globais
 Ver \`.vireum/rules.md\`
 
-## Regras do projeto  
+## Regras do projeto
 Ver \`.spec/rules.md\`
 
 ## Stack
@@ -421,9 +441,13 @@ Este projeto usa Spec Driven Development pela Vireum Desenvolvimento.
 - Sempre leia \`.spec/INDEX.md\` primeiro
 - Carregue outros arquivos de spec apenas quando necessário
 
+## Context7
+- Sempre consultar Context7 antes de usar qualquer lib do projeto
+- Nunca assumir que conhece a API mais recente
+
 ## Modos
-- Implementar → leia tasks/active.md, siga critérios de aceitação
-- Bug → crie hotfix [H] em active.md, registre causa raiz em changelog.md  
+- Implementar → leia tasks/active.md, consulte Context7, siga critérios de aceitação
+- Bug → crie hotfix [H] em active.md, registre causa raiz em changelog.md
 - Nova demanda → crie [PENDING] em backlog.md, aguarde aprovação
 - Dúvida de escopo → consulte requirements.md
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vireum-spec-cli",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Spec Driven Development framework by Vireum Desenvolvimento",
   "main": "dist/index.js",
   "bin": {