vireum-spec-cli 0.1.0

package/dist/commands/verify-mcps.js

@@ -0,0 +1,148 @@
+"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.runVerifyMcps = runVerifyMcps;
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+async function runVerifyMcps() {
+    console.log(chalk_1.default.hex('#2D7DD2').bold('\n  Vireum Spec — Verify MCPs\n'));
+    const specDir = path.join(process.cwd(), '.spec');
+    const archPath = path.join(specDir, 'architecture.md');
+    if (!fs.existsSync(archPath)) {
+        console.log(chalk_1.default.red('\n❌ architecture.md não encontrado.'));
+        console.log(chalk_1.default.gray('   Execute primeiro: ') + chalk_1.default.white('vireum-spec setup\n'));
+        process.exit(1);
+    }
+    const spinner = (0, ora_1.default)('Lendo MCPs do projeto...').start();
+    await sleep(400);
+    const arch = fs.readFileSync(archPath, 'utf-8');
+    const mcpsProjeto = extrairMcpsProjeto(arch);
+    spinner.stop();
+    if (mcpsProjeto.length === 0) {
+        console.log(chalk_1.default.yellow('\n⚠️  Nenhum MCP configurado neste projeto.\n'));
+        console.log(chalk_1.default.gray('   Execute: ') + chalk_1.default.white('vireum-spec setup\n'));
+        process.exit(0);
+    }
+    console.log(chalk_1.default.gray(`  MCPs necessários: ${mcpsProjeto.join(', ')}\n`));
+    // ── Detectar configs dos clientes ─────────────────────────────────────────
+    const home = os.homedir();
+    const clientes = [
+        {
+            nome: 'Claude Code',
+            paths: [
+                path.join(home, '.claude', 'settings.json'),
+                path.join(home, '.claude.json'),
+            ],
+        },
+        {
+            nome: 'Cursor',
+            paths: [
+                path.join(home, '.cursor', 'mcp.json'),
+                path.join(home, 'AppData', 'Roaming', 'Cursor', 'User', 'globalStorage', 'mcp.json'),
+            ],
+        },
+        {
+            nome: 'Codex CLI',
+            paths: [
+                path.join(home, '.codex', 'config.json'),
+                path.join(home, '.config', 'codex', 'config.json'),
+            ],
+        },
+    ];
+    // ── Checar cada cliente ────────────────────────────────────────────────────
+    for (const cliente of clientes) {
+        console.log(chalk_1.default.white.bold(`  ${cliente.nome}`));
+        const configPath = cliente.paths.find(p => fs.existsSync(p));
+        if (!configPath) {
+            console.log(chalk_1.default.gray(`    Config não encontrada — cliente pode não estar instalado\n`));
+            continue;
+        }
+        let config = {};
+        try {
+            config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+        }
+        catch {
+            console.log(chalk_1.default.yellow(`    ⚠ Erro ao ler config em ${configPath}\n`));
+            continue;
+        }
+        const mcpsInstalados = extrairMcpsInstalados(config);
+        for (const mcp of mcpsProjeto) {
+            const instalado = mcpsInstalados.some(m => m.toLowerCase().includes(mcp.toLowerCase()));
+            if (instalado) {
+                console.log(chalk_1.default.green(`    ✓ ${mcp}`));
+            }
+            else {
+                console.log(chalk_1.default.red(`    ✗ ${mcp} — não encontrado`));
+            }
+        }
+        console.log('');
+    }
+    // ── Instruções ─────────────────────────────────────────────────────────────
+    console.log(chalk_1.default.gray('  Para instalar MCPs faltantes consulte: ') + chalk_1.default.white('.spec/mcp-setup.md\n'));
+}
+// ─── HELPERS ──────────────────────────────────────────────────────────────────
+function extrairMcpsProjeto(arch) {
+    const idx = arch.indexOf('## MCPs Ativos');
+    if (idx === -1)
+        return [];
+    const secao = arch.slice(idx + '## MCPs Ativos'.length);
+    const linhas = secao.split('\n').filter(l => l.startsWith('- '));
+    return linhas.map(l => l.replace('- ', '').trim()).filter(Boolean);
+}
+function extrairMcpsInstalados(config) {
+    const nomes = [];
+    // Claude Code formato: { mcpServers: { "nome": {...} } }
+    if (config.mcpServers) {
+        nomes.push(...Object.keys(config.mcpServers));
+    }
+    // Cursor formato: { mcpServers: { "nome": {...} } }
+    if (config.mcp?.servers) {
+        nomes.push(...Object.keys(config.mcp.servers));
+    }
+    // Codex formato: { tools: [...] }
+    if (config.tools && Array.isArray(config.tools)) {
+        nomes.push(...config.tools.map((t) => t.name || t));
+    }
+    return nomes;
+}
+function sleep(ms) {
+    return new Promise(r => setTimeout(r, ms));
+}

package/dist/index.js

@@ -0,0 +1,55 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const init_1 = require("./commands/init");
+const distill_1 = require("./commands/distill");
+const setup_1 = require("./commands/setup");
+const prioritize_1 = require("./commands/prioritize");
+const health_1 = require("./commands/health");
+const brief_1 = require("./commands/brief");
+const verify_mcps_1 = require("./commands/verify-mcps");
+const skills_1 = require("./commands/skills");
+const program = new commander_1.Command();
+program
+    .name('vireum-spec')
+    .description('Spec Driven Development framework by Vireum Desenvolvimento')
+    .version('0.1.0');
+program
+    .command('init')
+    .description('Inicia um novo projeto com briefing interativo')
+    .action(async () => { await (0, init_1.runInit)(); });
+program
+    .command('distill')
+    .description('Gera os arquivos de spec a partir do briefing')
+    .action(async () => { await (0, distill_1.runDistill)(); });
+program
+    .command('setup')
+    .description('Configura stack, infra, MCPs e protocolo da IA')
+    .action(async () => { await (0, setup_1.runSetup)(); });
+program
+    .command('prioritize')
+    .description('Classifica features em MVP, Fase 2 ou fora do escopo')
+    .action(async () => { await (0, prioritize_1.runPrioritize)(); });
+program
+    .command('health')
+    .description('Verifica inconsistencias nos arquivos de spec')
+    .action(async () => { await (0, health_1.runHealth)(); });
+program
+    .command('brief')
+    .description('Gera resumo do estado atual do projeto')
+    .action(async () => { await (0, brief_1.runBrief)(); });
+program
+    .command('verify-mcps')
+    .description('Verifica se os MCPs do projeto estao instalados')
+    .action(async () => { await (0, verify_mcps_1.runVerifyMcps)(); });
+program
+    .command('skills')
+    .description('Instala as skills do framework no cliente de IA')
+    .action(async () => { await (0, skills_1.runSkills)(); });
+console.log(chalk_1.default.hex('#2D7DD2').bold('\n  Vireum Spec Framework\n'));
+program.parse(process.argv);

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "vireum-spec-cli",
+  "version": "0.1.0",
+  "description": "Spec Driven Development framework by Vireum Desenvolvimento",
+  "main": "dist/index.js",
+  "bin": {
+    "vireum-spec": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "ts-node src/index.ts",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist/",
+    "src/skills/"
+  ],
+  "keywords": [
+    "spec",
+    "cli",
+    "development",
+    "spec-driven",
+    "vireum"
+  ],
+  "author": "Vireum Desenvolvimento",
+  "license": "ISC",
+  "dependencies": {
+    "@inquirer/prompts": "^7.0.0",
+    "chalk": "^5.3.0",
+    "commander": "^12.0.0",
+    "ora": "^8.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "ts-node": "^10.9.0",
+    "typescript": "^5.0.0"
+  }
+}

package/src/skills/bug-fix.md

@@ -0,0 +1,14 @@
+# Skill — Corrigir Bug
+
+Quando o dev reportar um erro ou bug:
+
+1. Crie um hotfix em `.spec/tasks/active.md`:
+   - Formato: `## [FEATURE-H001] Fix: descrição do bug`
+   - Tag: [H] — prioridade crítica
+   - Origem: bug reportado em data atual
+2. Identifique a causa raiz antes de corrigir
+3. Corrija o bug
+4. Registre em `.spec/changelog.md`:
+   - Data, descrição do bug, causa raiz, solução aplicada
+5. Verifique se o bug afeta outras tasks em active.md
+6. Marque o hotfix como done e mova para tasks/done.md

package/src/skills/contract-first.md

@@ -0,0 +1,21 @@
+# Skill — Contrato de Interface
+
+Antes de implementar qualquer feature que envolva frontend E backend:
+
+1. Defina o contrato da API primeiro:
+   - Método e rota: `POST /auth/login`
+   - Request body com tipos
+   - Response de sucesso com tipos
+   - Responses de erro possíveis
+2. Registre o contrato em `.spec/architecture.md`
+3. Só depois implemente backend e frontend
+4. Frontend e backend podem rodar em paralelo após contrato definido
+
+## Formato do contrato
+```
+### [FEATURE] Nome da feature
+- Rota: METHOD /path
+- Body: { campo: tipo }
+- Response 200: { campo: tipo }
+- Response 4xx: { error: string }
+```

package/src/skills/new-demand.md

@@ -0,0 +1,14 @@
+# Skill — Nova Demanda do Cliente
+
+Quando o dev mencionar que o cliente pediu algo novo:
+
+1. Verifique se já existe em `.spec/requirements.md`
+2. Se não existir:
+   - Crie task com tag [PENDING] em `.spec/tasks/backlog.md`
+   - Formato: `- [ ] [FEATURE-TXXX] nome — [PENDING: aguarda priorização]`
+   - Estime o impacto: quais tasks existentes são afetadas?
+3. Informe o dev:
+   - O que foi criado no backlog
+   - Quais tasks existentes são impactadas
+   - Aguarde decisão antes de implementar
+4. NUNCA implemente demanda nova sem aprovação explícita do dev

package/src/skills/scope-check.md

@@ -0,0 +1,21 @@
+# Skill — Verificar Escopo
+
+Antes de implementar qualquer coisa, verificar:
+
+1. A solicitação está em `.spec/requirements.md`?
+   - Sim → prosseguir normalmente
+   - Não → PARAR e avisar o dev (escopo creep)
+
+2. A solicitação está em `.spec/tasks/active.md`?
+   - Sim → prosseguir
+   - Não → verificar se está no backlog ou é demanda nova
+
+3. Se escopo creep identificado, informar:
+   - O que foi solicitado
+   - Por que está fora do escopo atual
+   - Sugerir criar task [PENDING] no backlog
+
+## Nunca
+- Implementar silenciosamente algo fora do spec
+- Assumir que o dev "já sabe" que é escopo extra
+- Deixar para avisar depois de implementar

package/src/skills/spec-update.md

@@ -0,0 +1,30 @@
+# Skill — Atualizar Spec
+
+Quando e como atualizar cada arquivo de spec:
+
+## INDEX.md
+- Atualizar após cada task concluída
+- Atualizar estado do MVP (checkboxes)
+- Manter enxuto — máximo 50 linhas
+
+## tasks/active.md
+- Marcar task como [x] ao concluir
+- Adicionar hotfixes [H] quando bug identificado
+- Mover tasks concluídas para done.md
+
+## tasks/backlog.md
+- Adicionar [PENDING] quando nova demanda chega
+- Nunca mover para active sem aprovação humana
+
+## architecture.md
+- Registrar TODA decisão técnica relevante
+- Formato: Data | Decisão | Alternativas | Motivo
+- Nunca só registrar o quê — sempre o porquê
+
+## risks.md
+- Adicionar risco novo antes de continuar implementação
+- Formato: Data | Risco | Impacto | Mitigação
+
+## changelog.md
+- Registrar: decisões importantes, causa raiz de bugs, mudanças de escopo
+- Formato: ## DATA — Descrição

package/src/skills/task-implement.md

@@ -0,0 +1,14 @@
+# Skill — Implementar Task
+
+Quando o dev pedir para implementar uma task:
+
+1. Leia `.spec/tasks/active.md` e identifique a task solicitada
+2. Leia `.spec/requirements.md` para contexto da feature
+3. Leia `.spec/architecture.md` para decisões técnicas já tomadas
+4. Verifique os critérios de aceitação da task antes de começar
+5. Implemente seguindo a camada definida (Backend / Frontend / Integração)
+6. Ao concluir:
+   - Marque o status como [x] em active.md
+   - Mova a task para tasks/done.md
+   - Atualize o INDEX.md
+   - Se tomou decisão arquitetural, registre em architecture.md