vireum-spec-cli 0.4.1 → 0.5.0

package/dist/commands/enrich.js

@@ -0,0 +1,144 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runEnrich = runEnrich;
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+async function runEnrich() {
+    console.log(chalk_1.default.hex('#2D7DD2').bold('\n  Vireum Spec — Enrich\n'));
+    console.log(chalk_1.default.gray('  Gera um prompt para a IA identificar gaps no spec\n'));
+    const specDir = path.join(process.cwd(), '.spec');
+    if (!fs.existsSync(path.join(specDir, 'INDEX.md'))) {
+        console.log(chalk_1.default.red('\n❌ Spec não encontrado.'));
+        console.log(chalk_1.default.gray('   Execute primeiro: ') + chalk_1.default.white('vireum-spec retrofit') + chalk_1.default.gray(' ou ') + chalk_1.default.white('vireum-spec distill\n'));
+        process.exit(1);
+    }
+    const spinner = (0, ora_1.default)('Lendo spec...').start();
+    await sleep(600);
+    const arquivos = [
+        { nome: 'INDEX.md', path: path.join(specDir, 'INDEX.md') },
+        { nome: 'briefing.md', path: path.join(specDir, 'briefing.md') },
+        { nome: 'requirements.md', path: path.join(specDir, 'requirements.md') },
+        { nome: 'architecture.md', path: path.join(specDir, 'architecture.md') },
+        { nome: 'users.md', path: path.join(specDir, 'users.md') },
+        { nome: 'risks.md', path: path.join(specDir, 'risks.md') },
+        { nome: 'rules.md', path: path.join(specDir, 'rules.md') },
+        { nome: 'tasks/active.md', path: path.join(specDir, 'tasks', 'active.md') },
+        { nome: 'tasks/backlog.md', path: path.join(specDir, 'tasks', 'backlog.md') },
+    ];
+    const conteudos = [];
+    for (const arq of arquivos) {
+        if (fs.existsSync(arq.path)) {
+            const conteudo = fs.readFileSync(arq.path, 'utf-8');
+            conteudos.push(`### ${arq.nome}\n\`\`\`\n${conteudo}\n\`\`\``);
+        }
+    }
+    spinner.succeed('Spec lido');
+    const prompt = gerarPrompt(conteudos.join('\n\n'));
+    const promptPath = path.join(specDir, 'enrich-prompt.md');
+    const s2 = (0, ora_1.default)('Gerando prompt...').start();
+    await sleep(400);
+    fs.writeFileSync(promptPath, prompt, 'utf-8');
+    s2.succeed('.spec/enrich-prompt.md gerado');
+    console.log(chalk_1.default.green.bold('\n✅ Prompt pronto!\n'));
+    console.log(chalk_1.default.white('  Proximos passos:\n'));
+    console.log(chalk_1.default.gray('  1. Abra o arquivo: ') + chalk_1.default.white('.spec/enrich-prompt.md'));
+    console.log(chalk_1.default.gray('  2. Cole o conteudo no seu agente de IA (Claude Code, Cursor, Codex)'));
+    console.log(chalk_1.default.gray('  3. Responda as perguntas que a IA fizer'));
+    console.log(chalk_1.default.gray('  4. Salve as respostas nos arquivos de spec relevantes\n'));
+    console.log(chalk_1.default.hex('#2D7DD2')('  Dica: use o modo 4 do protocolo Vireum para garantir que as respostas\n  sejam incorporadas corretamente ao spec.\n'));
+}
+// ─── GERADOR DE PROMPT ────────────────────────────────────────────────────────
+function gerarPrompt(specConteudo) {
+    return `# Vireum Spec — Enrich Prompt
+
+> Cole este prompt inteiro no seu agente de IA (Claude Code, Cursor, Codex CLI).
+> O agente vai analisar o spec e fazer perguntas para preencher os gaps.
+> Responda as perguntas e salve as respostas nos arquivos de spec relevantes.
+
+---
+
+## Instrucao para a IA
+
+Voce e um especialista em desenvolvimento de software e analise de requisitos.
+Analise o spec abaixo de um projeto em desenvolvimento e identifique:
+
+1. **Gaps de negocio** — informacoes sobre o negocio que estao faltando ou vagas
+2. **Gaps tecnicos** — decisoes arquiteturais nao documentadas ou ambiguas
+3. **Riscos nao mapeados** — situacoes de risco que nao foram identificadas
+4. **Regras de negocio implicitas** — comportamentos que provavelmente existem mas nao estao documentados
+5. **Ambiguidades** — partes do spec que podem ser interpretadas de formas diferentes
+
+Para cada gap identificado, faca UMA pergunta clara e direta ao dev.
+Organize as perguntas por prioridade — comece pelas mais criticas para o desenvolvimento.
+Limite a no maximo 15 perguntas — foque no que realmente importa.
+
+Apos o dev responder, indique em qual arquivo de spec cada resposta deve ser salva:
+- Regras de negocio → .spec/requirements.md
+- Decisoes tecnicas → .spec/architecture.md
+- Riscos → .spec/risks.md
+- Perfis de usuario → .spec/users.md
+- Regras do projeto → .spec/rules.md
+
+---
+
+## Spec atual do projeto
+
+${specConteudo}
+
+---
+
+## Formato esperado da sua resposta
+
+Comece com um resumo de 2-3 linhas do que voce entendeu sobre o projeto.
+Depois liste as perguntas numeradas, cada uma com:
+- A pergunta em si
+- Por que essa informacao e importante
+- Onde a resposta deve ser salva
+
+Exemplo:
+**Pergunta 1:** Como o sistema lida com usuarios inativos?
+**Importancia:** Afeta logica de autenticacao e limpeza de dados
+**Salvar em:** .spec/requirements.md e .spec/rules.md
+`;
+}
+function sleep(ms) {
+    return new Promise(r => setTimeout(r, ms));
+}

package/dist/commands/setup.js

@@ -246,6 +246,24 @@ async function runSetup() {
         fs.writeFileSync(arq.path, arq.conteudo, 'utf-8');
         s.succeed(path.relative(process.cwd(), arq.path));
     }
+    // ── Git hook ───────────────────────────────────────────────────────────────
+    const gitHookDir = path.join(process.cwd(), '.git', 'hooks');
+    const hookPath = path.join(gitHookDir, 'pre-push');
+    if (fs.existsSync(path.join(process.cwd(), '.git'))) {
+        const sHook = (0, ora_1.default)('Configurando git hook pre-push...').start();
+        await sleep(400);
+        if (!fs.existsSync(gitHookDir))
+            fs.mkdirSync(gitHookDir, { recursive: true });
+        fs.writeFileSync(hookPath, gerarPrePushHook(), 'utf-8');
+        try {
+            fs.chmodSync(hookPath, '755');
+        }
+        catch { }
+        sHook.succeed('.git/hooks/pre-push configurado');
+    }
+    else {
+        console.log(chalk_1.default.yellow('  ⚠ Repositorio git nao encontrado — hook nao configurado'));
+    }
     console.log(chalk_1.default.green.bold('\n✅ Setup concluído!\n'));
     console.log(chalk_1.default.gray('  Protocolo da IA configurado para Claude Code, Codex CLI e Cursor\n'));
     console.log(chalk_1.default.gray('  Próximo passo: ') + chalk_1.default.white('vireum-spec prioritize') + chalk_1.default.gray(' para classificar as features\n'));
@@ -265,6 +283,30 @@ function sleep(ms) {
     return new Promise(r => setTimeout(r, ms));
 }
 // ─── GERADORES ────────────────────────────────────────────────────────────────
+function gerarPrePushHook() {
+    return `#!/bin/sh
+# Vireum Spec — Health Check automatico pre-push
+# Gerado por vireum-spec setup
+
+echo ""
+echo "  Vireum Spec — verificando consistencia do spec..."
+echo ""
+
+npx vireum-spec-cli health
+
+STATUS=$?
+
+if [ $STATUS -ne 0 ]; then
+  echo ""
+  echo "  Spec com problemas criticos. Corrija antes de fazer push."
+  echo "  Execute: vireum-spec health para detalhes"
+  echo ""
+  exit 1
+fi
+
+exit 0
+`;
+}
 function gerarArchitecture(d) {
     const { stack, infra, mcps, projeto } = d;
     const tenant = stack.multiTenant
@@ -347,6 +389,11 @@ function gerarRulesGlobal() {
 - Nunca hardcodar cores — usar sempre os tokens definidos em design.md
 - Nunca misturar design systems
 
+## Regras de Health
+- Verificar consistencia do spec no inicio de cada sessao
+- Avisar o dev sobre inconsistencias antes de qualquer implementacao
+- Tasks sem criterios de aceitacao devem ser sinalizadas antes de implementar
+
 ## Regras de Spec
 - Nunca marcar task como done sem validar os critérios de aceitação
 - Nunca tomar decisão de arquitetura sem registrar em architecture.md com justificativa
@@ -414,8 +461,13 @@ function gerarClaudeMd(d) {
 
 ## Início de cada sessão
 1. Leia \`.spec/INDEX.md\` — estado atual do projeto
-2. Identifique o modo da sessão pela solicitação do dev
-3. Carregue arquivos adicionais apenas se a task exigir
+2. Verifique consistencia do spec:
+   - tasks/active.md tem tasks sem criterios de aceitacao? → avisar o dev
+   - architecture.md tem stack definida? → se nao, avisar
+   - INDEX.md reflete o estado real do MVP? → se desatualizado, avisar
+3. Se encontrar inconsistencias criticas → avisar antes de qualquer implementacao
+4. Identifique o modo da sessão pela solicitação do dev
+5. Carregue arquivos adicionais apenas se a task exigir
 
 ## Modos de operação
 
@@ -485,6 +537,7 @@ ${mcps.map((m) => `- ${m}`).join('\n')}
 - Decisão de lib nova: registrar em architecture.md antes de usar
 - Risco identificado: adicionar em risks.md antes de continuar
 - UI sem consultar design.md → PARAR e consultar primeiro
+- Spec inconsistente → avisar o dev antes de implementar
 `;
 }
 function gerarAgentsMd(d) {
@@ -495,8 +548,10 @@ function gerarAgentsMd(d) {
 
 ## Início de cada sessão
 1. Leia \`.spec/INDEX.md\`
-2. Identifique o modo pela solicitação
-3. Siga o protocolo em CLAUDE.md
+2. Verifique consistencia do spec — tasks sem criterios, stack indefinida, INDEX desatualizado
+3. Avise o dev sobre inconsistencias antes de implementar
+4. Identifique o modo pela solicitação
+5. Siga o protocolo em CLAUDE.md
 
 ## Planejamento obrigatorio
 Antes de qualquer implementacao:
@@ -535,6 +590,8 @@ Este projeto usa Spec Driven Development pela Vireum Desenvolvimento.
 
 ## Início de sessão
 - Sempre leia \`.spec/INDEX.md\` primeiro
+- Verifique consistencia: tasks sem criterios, stack indefinida, INDEX desatualizado
+- Avise inconsistencias antes de qualquer implementacao
 - Carregue outros arquivos de spec apenas quando necessário
 
 ## Planejamento obrigatorio

package/dist/index.js

@@ -15,6 +15,7 @@ const brief_1 = require("./commands/brief");
 const verify_mcps_1 = require("./commands/verify-mcps");
 const skills_1 = require("./commands/skills");
 const retrofit_1 = require("./commands/retrofit");
+const enrich_1 = require("./commands/enrich");
 const program = new commander_1.Command();
 program
     .name('vireum-spec')
@@ -56,5 +57,9 @@ program
     .command('retrofit')
     .description('Gera o spec a partir de um projeto ja em andamento')
     .action(async () => { await (0, retrofit_1.runRetrofit)(); });
+program
+    .command('enrich')
+    .description('Gera prompt para a IA identificar gaps no spec')
+    .action(async () => { await (0, enrich_1.runEnrich)(); });
 console.log(chalk_1.default.hex('#2D7DD2').bold('\n  Vireum Spec Framework\n'));
 program.parse(process.argv);

package/package.json

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