vireum-spec-cli 0.2.1 → 0.3.0

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.1",
+  "version": "0.3.0",
   "description": "Spec Driven Development framework by Vireum Desenvolvimento",
   "main": "dist/index.js",
   "bin": {