rook-cli 1.0.1 → 1.0.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rook-cli",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "CLI para instalar componentes Shopify de um repositório centralizado",
   "repository": {
     "type": "git",

package/src/app.js

@@ -60,7 +60,7 @@ export class App {
         this.programa
             .name(CLI_NAME)
             .description('CLI para instalar componentes Shopify de um repositório centralizado')
-            .version('1.0.0');
+            .version('1.0.1');
 
         // Comando: rook add
         this.programa

package/src/commands/AddCommand.js

@@ -59,18 +59,75 @@ export class AddCommand {
     }
 
     /**
-     * Fluxo de instalação de um kit completo.
+     * Fluxo de instalação de um kit completo (nova arquitetura de composição).
+     * 
+     * Segue o padrão descrito no PRD (Seção 5.3):
+     * 1. Lista kits disponíveis (com dados do kit.json)
+     * 2. Usuário seleciona o kit
+     * 3. Instala cada componente referenciado no manifesto
+     * 4. Instala os arquivos locais exclusivos do kit
+     * 
      * @private
      */
     async _instalarKit() {
-        // Lista kits disponíveis
+        // 1. Lista kits disponíveis (já enriquecidos com dados do kit.json)
         const kits = await this.githubService.listarKits();
+
+        if (kits.length === 0) {
+            this.logger.aviso('Nenhum kit disponível no repositório.');
+            return;
+        }
+
+        // 2. Usuário seleciona o kit
         const kitSelecionado = await this.promptUI.selecionarKit(kits);
 
         this.logger.destaque(`\n📥 Instalando kit: ${kitSelecionado.nome}\n`);
 
-        // Baixa e distribui
-        await this._baixarEDistribuir(kitSelecionado.caminho, kitSelecionado.nome);
+        if (kitSelecionado.descricao) {
+            this.logger.sutil(kitSelecionado.descricao);
+            console.log('');
+        }
+
+        let totalComponentesInstalados = 0;
+        let totalArquivosCopiados = 0;
+
+        // 3. Instala cada componente referenciado no manifesto (kit.json)
+        if (kitSelecionado.componentes.length > 0) {
+            this.logger.destaque(`🧩 Instalando ${kitSelecionado.componentes.length} componente(s) do manifesto...\n`);
+
+            for (const nomeComponente of kitSelecionado.componentes) {
+                const caminhoComponente = `components/${nomeComponente}`;
+
+                try {
+                    this.logger.info(`[${totalComponentesInstalados + 1}/${kitSelecionado.componentes.length}] ${nomeComponente}`);
+                    const copiados = await this._baixarEDistribuir(caminhoComponente, nomeComponente);
+                    totalArquivosCopiados += copiados;
+                    totalComponentesInstalados++;
+                } catch (erro) {
+                    this.logger.erro(`Falha ao instalar componente "${nomeComponente}": ${erro.message}`);
+                    this.logger.aviso('Continuando com os próximos componentes...');
+                }
+            }
+        }
+
+        // 4. Instala os arquivos locais exclusivos do kit (ex: layout/theme.liquid, config/)
+        this.logger.destaque(`\n📁 Instalando arquivos base do kit "${kitSelecionado.slug}"...\n`);
+
+        try {
+            const copiadosKit = await this._baixarEDistribuir(kitSelecionado.caminho, `kit:${kitSelecionado.slug}`);
+            totalArquivosCopiados += copiadosKit;
+        } catch (erro) {
+            this.logger.erro(`Falha ao instalar arquivos base do kit: ${erro.message}`);
+        }
+
+        // 5. Resumo final
+        console.log('');
+        this.logger.destaque('═══════════════════════════════════════════');
+        this.logger.sucesso(`🎉 Kit "${kitSelecionado.nome}" instalado com sucesso!`);
+        this.logger.sutil(`   Componentes: ${totalComponentesInstalados}/${kitSelecionado.componentes.length}`);
+        this.logger.sutil(`   Arquivos copiados: ${totalArquivosCopiados}`);
+        this.logger.destaque('═══════════════════════════════════════════');
+        console.log('');
     }
 
     /**
@@ -84,10 +141,16 @@ export class AddCommand {
 
         this.logger.destaque(`\n📥 Instalando ${selecionados.length} componente(s)...\n`);
 
+        let totalArquivosCopiados = 0;
+
         // Baixa e distribui cada componente
         for (const componente of selecionados) {
-            await this._baixarEDistribuir(componente.caminho, componente.nome);
+            const copiados = await this._baixarEDistribuir(componente.caminho, componente.nome);
+            totalArquivosCopiados += copiados;
         }
+
+        console.log('');
+        this.logger.sucesso(`🎉 ${selecionados.length} componente(s) instalado(s)! (${totalArquivosCopiados} arquivo(s) copiados)\n`);
     }
 
     /**
@@ -95,6 +158,7 @@ export class AddCommand {
      * 
      * @param {string} caminhoRemoto - Caminho no repositório (ex: "components/whatsapp-btn")
      * @param {string} nomePacote - Nome do pacote para exibição nos logs
+     * @returns {Promise<number>} Número de arquivos copiados
      * @private
      */
     async _baixarEDistribuir(caminhoRemoto, nomePacote) {
@@ -104,14 +168,16 @@ export class AddCommand {
         try {
             await fs.ensureDir(pastaTmp);
 
-            // Download via tiged
+            // Download via tiged ou GitHub API
             await this.downloadService.baixar(caminhoRemoto, pastaTmp);
 
             // Distribui nas pastas Shopify locais
             const diretorioAtual = process.cwd();
             const totalCopiados = await this.fileMapper.distribuir(pastaTmp, diretorioAtual);
 
-            this.logger.sucesso(`\n🎉 "${nomePacote}" instalado! (${totalCopiados} arquivo(s) copiados)\n`);
+            this.logger.sucesso(`  ✔ "${nomePacote}" — ${totalCopiados} arquivo(s)`);
+
+            return totalCopiados;
 
         } finally {
             // Limpa pasta temporária

package/src/services/GitHubService.js

@@ -65,19 +65,66 @@ export class GitHubService {
 
     /**
      * Lista os kits disponíveis no repositório.
-     * @returns {Promise<Array<{nome: string, caminho: string}>>} Lista de kits
+     * Busca o kit.json de cada kit para obter nome e descrição.
+     * 
+     * @returns {Promise<Array<{nome: string, slug: string, descricao: string, componentes: string[], caminho: string}>>} Lista de kits
      */
     async listarKits() {
         this.logger.info('Buscando kits disponíveis...');
 
         const itens = await this.listarDiretorio(REMOTE_PATHS.KITS);
+        const pastasKit = itens.filter(item => item.type === 'dir');
 
-        return itens
-            .filter(item => item.type === 'dir')
-            .map(item => ({
-                nome: item.name,
-                caminho: `${REMOTE_PATHS.KITS}/${item.name}`,
-            }));
+        const kits = [];
+
+        for (const pasta of pastasKit) {
+            try {
+                const manifesto = await this.buscarKitManifesto(pasta.name);
+                kits.push({
+                    nome: manifesto.name || pasta.name,
+                    slug: pasta.name,
+                    descricao: manifesto.description || '',
+                    componentes: manifesto.components || [],
+                    caminho: `${REMOTE_PATHS.KITS}/${pasta.name}`,
+                });
+            } catch {
+                // Se o kit não tem kit.json válido, lista com dados básicos
+                this.logger.aviso(`Kit "${pasta.name}" sem kit.json válido. Ignorando.`);
+            }
+        }
+
+        return kits;
+    }
+
+    /**
+     * Busca e parseia o manifesto (kit.json) de um kit específico.
+     * 
+     * @param {string} nomeKit - Nome/slug da pasta do kit (ex: "starter-base")
+     * @returns {Promise<{name: string, version: string, description: string, components: string[]}>} Manifesto do kit
+     */
+    async buscarKitManifesto(nomeKit) {
+        const caminho = `${REMOTE_PATHS.KITS}/${nomeKit}/kit.json`;
+        const url = `${GITHUB_API_BASE}/${caminho}`;
+        const headers = await this.tokenManager.obterHeaders();
+
+        try {
+            const resposta = await fetch(url, { headers });
+
+            if (!resposta.ok) {
+                throw new Error(`kit.json não encontrado para "${nomeKit}" (HTTP ${resposta.status})`);
+            }
+
+            const dados = await resposta.json();
+
+            // A API do GitHub retorna o conteúdo em base64
+            const conteudo = Buffer.from(dados.content, 'base64').toString('utf-8');
+            const manifesto = JSON.parse(conteudo);
+
+            return manifesto;
+        } catch (erro) {
+            this.logger.erro(`Falha ao ler kit.json de "${nomeKit}": ${erro.message}`);
+            throw erro;
+        }
     }
 
     /**

package/src/ui/PromptUI.js

@@ -39,24 +39,26 @@ export class PromptUI {
 
     /**
      * Exibe a lista de kits disponíveis para seleção.
+     * Mostra nome e descrição vindos do kit.json (manifesto).
      * 
-     * @param {Array<{nome: string, caminho: string}>} kits - Kits disponíveis
-     * @returns {Promise<{nome: string, caminho: string}>} Kit selecionado
+     * @param {Array<{nome: string, slug: string, descricao: string, componentes: string[], caminho: string}>} kits - Kits disponíveis
+     * @returns {Promise<{nome: string, slug: string, descricao: string, componentes: string[], caminho: string}>} Kit selecionado
      */
     async selecionarKit(kits) {
         if (kits.length === 0) {
             throw new Error('Nenhum kit disponível no repositório.');
         }
 
-        const caminho = await select({
+        const slug = await select({
             message: '🎯 Selecione o kit para instalar:',
             choices: kits.map(kit => ({
-                name: `📁 ${kit.nome}`,
-                value: kit.caminho,
+                name: `📁 ${kit.nome} (${kit.componentes.length} componentes)`,
+                value: kit.slug,
+                description: kit.descricao || undefined,
             })),
         });
 
-        return kits.find(k => k.caminho === caminho);
+        return kits.find(k => k.slug === slug);
     }
 
     /**

package/src/utils/logger.js

@@ -48,10 +48,10 @@ export class Logger {
      */
     banner() {
         console.log('');
-        console.log(pc.bold(pc.magenta('  ╔══════════════════════════════╗')));
-        console.log(pc.bold(pc.magenta('  ║    🚀  ROOK CLI  v1.0.0    ║')));
-        console.log(pc.bold(pc.magenta('  ║   Shopify Component Tool    ║')));
-        console.log(pc.bold(pc.magenta('  ╚══════════════════════════════╝')));
+        console.log(pc.bold(pc.white('  ╔══════════════════════════════╗')));
+        console.log(pc.bold(pc.white('  ║    ♟️  ROOK CLI  v1.0.3       ║')));
+        console.log(pc.bold(pc.white('  ║   Shopify Component Tool     ║')));
+        console.log(pc.bold(pc.white('  ╚══════════════════════════════╝')));
         console.log('');
     }