vireum-spec-cli 0.4.2 → 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/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.2",
+  "version": "0.5.0",
   "description": "Spec Driven Development framework by Vireum Desenvolvimento",
   "main": "dist/index.js",
   "bin": {