create-writerkit 1.0.0 → 1.1.1

package/bin/cli.js

@@ -3,51 +3,127 @@
 import fs from 'fs';
 import path from 'path';
 import chalk from 'chalk';
+import { runInteractiveMenu } from '../src/interactiveMenu.js';
 import { injectSkills } from '../src/injectSkills.js';
-// Adicione a importação da nossa nova função:
 import { checkEnvironment } from '../src/checkEnvironment.js';
+import { processTemplate } from '../src/templateProcessor.js';
 
-const projectName = process.argv[2];
+async function main() {
+  const folderName = process.argv[2];
 
-if (!projectName) {
-  console.error(chalk.red('Erro: Por favor, forneça o nome do projeto!'));
-  console.log(chalk.cyan('Exemplo de uso: npx create-writerkit o-meu-livro'));
-  process.exit(1);
-}
+  if (!folderName) {
+    console.error(chalk.red('Erro: Por favor, forneça o nome da pasta do projeto!'));
+    console.log(chalk.cyan('Exemplo de uso: npx create-writerkit nome-da-pasta'));
+    process.exit(1);
+  }
 
-const projectPath = path.join(process.cwd(), projectName);
+  const projectPath = path.join(process.cwd(), folderName);
 
-if (fs.existsSync(projectPath)) {
-  console.error(chalk.red(`Erro: A pasta "${projectName}" já existe neste diretório. Escolha outro nome.`));
-  process.exit(1);
-}
+  if (fs.existsSync(projectPath)) {
+    console.error(chalk.red(`Erro: A pasta "${folderName}" já existe neste diretório.`));
+    process.exit(1);
+  }
+
+  // 1. CHAMA O MENU INTERATIVO
+  const userConfig = await runInteractiveMenu();
+
+  if (!userConfig.acceptsStructure) {
+    console.log(chalk.yellow('\nOperação cancelada pelo utilizador. O WriterKit requer a sua estrutura de pastas para funcionar.'));
+    process.exit(0);
+  }
+
+  console.log(chalk.blue(`\n🚀 A construir o canteiro de obras em ./${folderName}...\n`));
+  fs.mkdirSync(projectPath);
 
-console.log(chalk.blue(`\n🚀 Iniciando a engenharia editorial do WriterKit em ./${projectName}...\n`));
+  // 2. CRIA A ESTRUTURA DE PASTAS
+  const folders = ['chapters', 'codes', 'images', 'configs', 'fonts', 'templates', 'output', 'memory'];
+  folders.forEach(folder => {
+    fs.mkdirSync(path.join(projectPath, folder));
+  });
+  console.log(chalk.green(`   ✅ Árvore de diretórios gerada.`));
 
-fs.mkdirSync(projectPath);
+  // Cria o main.tex padrão do WriterKit
+  const mainTexContent = `\\documentclass{article}\n\\usepackage[utf8]{inputenc}\n\n\\title{Ainda Não Definido}\n\\author{Autor}\n\n\\begin{document}\n\n\\maketitle\n\n% Ficheiro mestre gerado pelo WriterKit\n\\end{document}`;
+  fs.writeFileSync(path.join(projectPath, 'main.tex'), mainTexContent);
 
-const folders = ['chapters', 'codes', 'images', 'configs', 'fonts', 'templates', 'output', 'memory'];
+  // Variável para armazenar o DNA do template (agora com a propriedade guidelines vazia por padrão)
+  let extractedDNA = {
+    commands: [],
+    environments: [],
+    colors: [],
+    guidelines: [],
+    listingsConfig: "N/A"
+  };
 
-folders.forEach(folder => {
-  fs.mkdirSync(path.join(projectPath, folder));
-  console.log(chalk.green(`   ✅ Pasta ${folder}/ criada.`));
-});
+  // SE O UTILIZADOR TEM UM TEMPLATE, ACIONA O PROCESSADOR AQUI
+  if (userConfig.hasLatexTemplate && userConfig.templatePath) {
+    const dnaResult = processTemplate(userConfig.templatePath, projectPath);
+    if (dnaResult) {
+      extractedDNA = dnaResult;
+    }
+  }
 
-const mainTexContent = `\\documentclass{article}\n\\usepackage[utf8]{inputenc}\n\n\\title{Ainda Não Definido}\n\\author{Autor}\n\n\\begin{document}\n\n\\maketitle\n\n% Ficheiro mestre gerado pelo WriterKit\n\\end{document}`;
-fs.writeFileSync(path.join(projectPath, 'main.tex'), mainTexContent);
-console.log(chalk.green(`   ✅ Ficheiro main.tex gerado.`));
+  // --- INÍCIO DA CRIAÇÃO DA MEMÓRIA ---
 
-const memoryJsonContent = JSON.stringify({ project: { title: "Pendente" }, chapters: [], decision_log: [] }, null, 2);
-fs.writeFileSync(path.join(projectPath, 'memory', 'memory.json'), memoryJsonContent);
-console.log(chalk.green(`   ✅ Ficheiro memory/memory.json gerado.`));
+  // Constrói o histórico inicial do log de decisões
+  const initialDecisionLog = [
+    {
+      timestamp: new Date().toISOString(),
+      phase: "Initial Setup",
+      notes: "Projeto estruturado e template analisado via assistente npx."
+    }
+  ];
 
-// CHAMA A INJEÇÃO DE SKILLS AQUI
-injectSkills();
+  // SE EXISTIREM REGRAS NO TEMPLATE, INJETA ELAS NO LOG PARA A IA LER
+  if (extractedDNA.guidelines && extractedDNA.guidelines.length > 0) {
+    extractedDNA.guidelines.forEach(rule => {
+      initialDecisionLog.push({
+        timestamp: new Date().toISOString(),
+        phase: "Template Guidelines",
+        status: "MANDATORY RULE",
+        notes: `Orientação extraída dos ficheiros do template: ${rule}`
+      });
+    });
+  }
 
-// CHAMA A VERIFICAÇÃO DE AMBIENTE PYTHON E VENV AQUI
-checkEnvironment(projectPath);
+  // 3. INJETA OS DADOS DO MENU E O DNA DIRETAMENTE NA MEMÓRIA DA IA
+  const memoryJsonContent = JSON.stringify({
+    project: {
+      title: userConfig.bookTitle,
+      type: userConfig.bookType,
+      tone: userConfig.writingTone,
+      language: "pt-BR",
+      code_language: userConfig.hasCode ? userConfig.codeLanguage : "Nenhum",
+      status: "Configurado via npx",
+      latex_template: userConfig.hasLatexTemplate ? `Template importado de: ${userConfig.templatePath}` : "Padrão do sistema"
+    },
+    template_dna: {
+      allowed_commands: extractedDNA.commands,
+      allowed_environments: extractedDNA.environments,
+      official_colors: extractedDNA.colors
+    },
+    latex_config: {
+      listings_literate: userConfig.hasCode ? "Pendente mapeamento para " + userConfig.codeLanguage : "N/A",
+      listings_setup: extractedDNA.listingsConfig
+    },
+    chapters: [],
+    decision_log: initialDecisionLog // Agora usa a array dinâmica que criámos!
+  }, null, 2);
+
+  fs.writeFileSync(path.join(projectPath, 'memory', 'memory.json'), memoryJsonContent);
+  console.log(chalk.green(`   ✅ Ficheiro memory.json populado com o DNA e as Regras do seu template.`));
+  
+  // --- FIM DA CRIAÇÃO DA MEMÓRIA ---
+
+  // 4. CHAMA OS DEMAIS SCRIPTS (Skills e Python)
+  injectSkills();
+  checkEnvironment(projectPath);
+
+  console.log(chalk.blue(`\n🎉 Tudo pronto, ${userConfig.bookTitle} configurado!`));
+  console.log(chalk.yellow(`👉 Próximos passos:`));
+  console.log(chalk.white(`   cd ${folderName}`));
+  console.log(chalk.gray(`   Abra o Gemini CLI e peça para iniciar o projeto!\n`));
+}
 
-console.log(chalk.blue(`\n🎉 Tudo pronto! O seu canteiro de obras foi construído com sucesso.`));
-console.log(chalk.yellow(`\n👉 Próximos passos:`));
-console.log(chalk.white(`   cd ${projectName}`));
-console.log(chalk.gray(`   Abra o Gemini CLI e digite: "Ative a skill writerkit-init..."\n`));
+// Executa a função principal
+main();

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "create-writerkit",
-  "version": "1.0.0",
+  "version": "1.1.1",
   "description": "CLI para inicializar projetos de livros técnicos em LaTeX com o WriterKit",
   "main": "bin/cli.js",
   "type": "module",
   "bin": {
-    "create-writerkit": "./bin/cli.js"
+    "create-writerkit": "bin/cli.js"
   },
   "keywords": [
     "writerkit",
@@ -17,6 +17,7 @@
   "author": "Ricardo Sekeff",
   "license": "MIT",
   "dependencies": {
-    "chalk": "^5.3.0"
+    "chalk": "^5.3.0",
+    "inquirer": "^14.0.2"
   }
 }

package/src/interactiveMenu.js

@@ -0,0 +1,97 @@
+import inquirer from 'inquirer';
+import chalk from 'chalk';
+import fs from 'fs';
+import path from 'path';
+
+export async function runInteractiveMenu() {
+  console.log(chalk.cyan('\nBem-vindo ao assistente de configuração do WriterKit! 🚀'));
+  console.log(chalk.gray('Vamos configurar os parâmetros iniciais da sua obra.\n'));
+
+  const answers = await inquirer.prompt([
+    {
+      type: 'input',
+      name: 'bookTitle',
+      message: 'Qual é o nome do livro/projeto?',
+      default: 'Meu Livro Tecnico',
+      validate: input => input.trim() !== '' ? true : 'O nome do livro não pode ser vazio.'
+    },
+    {
+      type: 'select',
+      name: 'bookType',
+      message: 'Qual é o tipo desta obra?',
+      choices: [
+        'Livro-texto (Didático)',
+        'Manual Técnico / Documentação',
+        'Tese / Dissertação Acadêmica',
+        'Monografia / TCC',
+        'Artigo Científico Extenso'
+      ]
+    },
+    {
+      type: 'select',
+      name: 'writingTone',
+      message: 'Qual será o tom principal da escrita?',
+      choices: [
+        'Científico Rigoroso (Foco em formalismo matemático e teórico)',
+        'Acadêmico Padrão (Linguagem formal, foco em citações e pesquisa)',
+        'Técnico / Pragmático (Direto ao ponto, focado no mercado e execução)',
+        'Didático / Acessível (Linguagem amigável, analogias, passo a passo)'
+      ]
+    },
+    {
+      type: 'confirm',
+      name: 'hasLatexTemplate',
+      message: 'Você já possui um template LaTeX próprio (arquivos .cls, .sty, estrutura de pastas)?',
+      default: false
+    },
+    {
+      type: 'input',
+      name: 'templatePath',
+      message: 'Qual é o caminho (diretório absoluto ou relativo) onde o seu template está localizado?',
+      // Esta pergunta só aparece se o usuário confirmou que tem um template
+      when: (answers) => answers.hasLatexTemplate,
+      validate: (input) => {
+        const resolvedPath = path.resolve(input);
+        if (fs.existsSync(resolvedPath) && fs.statSync(resolvedPath).isDirectory()) {
+          return true;
+        }
+        return 'Diretório não encontrado. Por favor, insira um caminho válido.';
+      }
+    },
+    {
+      type: 'confirm',
+      name: 'acceptsStructure',
+      message: 'O WriterKit gerará as pastas bases (chapters/, codes/, etc). Podemos prosseguir?',
+      default: true
+    },
+    {
+      type: 'confirm',
+      name: 'hasCode',
+      message: 'O livro terá exemplos de código-fonte (algoritmos, scripts)?',
+      default: true
+    },
+    {
+      type: 'select',
+      name: 'codeLanguage',
+      message: 'Qual será a linguagem de programação principal?',
+      when: (answers) => answers.hasCode,
+      choices: [
+        'Python',
+        'JavaScript',
+        'TypeScript',
+        'Java',
+        'C / C++',
+        'C#',
+        'Rust',
+        'Go',
+        'Dart',
+        'Node.js (Ecossistema)',
+        'React (Ecossistema)',
+        'SQL / Banco de Dados',
+        'Outra / Múltiplas'
+      ]
+    }
+  ]);
+
+  return answers;
+}

package/src/templateProcessor.js

@@ -0,0 +1,102 @@
+import fs from 'fs';
+import path from 'path';
+import chalk from 'chalk';
+
+// Função auxiliar para extrair definições LaTeX via Regex
+function extractLatexDNA(folderPath) {
+  const dna = {
+    commands: new Set(),
+    environments: new Set(),
+    colors: new Set(),
+    listingsConfig: "",
+    guidelines: new Set() // NOVA PROPRIEDADE: Guarda as regras e anotações
+  };
+
+  function walkDir(currentDir) {
+    const files = fs.readdirSync(currentDir);
+    for (const file of files) {
+      const fullPath = path.join(currentDir, file);
+      
+      if (fs.statSync(fullPath).isDirectory()) {
+        walkDir(fullPath);
+      } else if (fullPath.endsWith('.cls') || fullPath.endsWith('.sty') || fullPath.endsWith('.tex')) {
+        const content = fs.readFileSync(fullPath, 'utf8');
+        let match;
+
+        // 1. Extrai Regras e Anotações Gerais (Comentários com palavras-chave)
+        const generalRuleRegex = /^[ \t]*%[ \t]*(REGRA|USO|ATEN[ÇC][ÃA]O|NOTA|IMPORTANTE):\s*(.*)$/gmi;
+        while ((match = generalRuleRegex.exec(content)) !== null) {
+          dna.guidelines.add(`${match[1].toUpperCase()}: ${match[2].trim()}`);
+        }
+
+        // 2. Extrai Comentários diretamente acima de definições (\newcommand, \definecolor, etc)
+        const docRegex = /((?:^[ \t]*%.*\r?\n)+)[ \t]*\\(?:newcommand|renewcommand|def|newenvironment|definecolor)\[?\{?\\([a-zA-Z0-9_]+)/gm;
+        while ((match = docRegex.exec(content)) !== null) {
+          const cleanDoc = match[1].replace(/^[ \t]*%/gm, '').replace(/\r?\n/g, ' ').trim();
+          const commandName = match[2];
+          if (cleanDoc.length > 5) {
+            dna.guidelines.add(`Referente a \\${commandName}: ${cleanDoc}`);
+          }
+        }
+
+        // 3. Extrai \newcommand ou \renewcommand
+        const cmdRegex = /\\(?:re)?newcommand(?:\[\d+\])?(?:\[.*?\])?\{\\([a-zA-Z0-9_]+)\}/g;
+        while ((match = cmdRegex.exec(content)) !== null) dna.commands.add(`\\${match[1]}`);
+
+        // 4. Extrai \def
+        const defRegex = /\\def\\([a-zA-Z0-9_]+)/g;
+        while ((match = defRegex.exec(content)) !== null) dna.commands.add(`\\${match[1]}`);
+
+        // 5. Extrai \newenvironment
+        const envRegex = /\\newenvironment\{([a-zA-Z0-9_]+)\}/g;
+        while ((match = envRegex.exec(content)) !== null) dna.environments.add(match[1]);
+
+        // 6. Extrai \definecolor
+        const colorRegex = /\\definecolor\{([a-zA-Z0-9_]+)\}/g;
+        while ((match = colorRegex.exec(content)) !== null) dna.colors.add(match[1]);
+
+        // 7. Extrai configurações de \lstset
+        const lstsetRegex = /\\lstset\{([\s\S]*?)\}/g;
+        while ((match = lstsetRegex.exec(content)) !== null) {
+          dna.listingsConfig += match[1].trim() + "\n";
+        }
+      }
+    }
+  }
+
+  walkDir(folderPath);
+
+  return {
+    commands: Array.from(dna.commands),
+    environments: Array.from(dna.environments),
+    colors: Array.from(dna.colors),
+    guidelines: Array.from(dna.guidelines),
+    listingsConfig: dna.listingsConfig ? "Configurações encontradas." : "Nenhuma configuração de listings detectada."
+  };
+}
+
+export function processTemplate(templateSource, projectPath) {
+  console.log(chalk.blue(`\n📂 Processando e analisando o template fornecido...`));
+  
+  const resolvedSource = path.resolve(templateSource);
+  const templateDestFolder = path.join(projectPath, 'templates');
+  
+  try {
+    fs.cpSync(resolvedSource, templateDestFolder, { recursive: true });
+    fs.cpSync(resolvedSource, projectPath, { recursive: true, force: true });
+    console.log(chalk.green(`   ✅ Estrutura de diretórios do template clonada com sucesso.`));
+
+    console.log(chalk.blue(`   🧬 Analisando arquivos .cls, .sty e .tex...`));
+    const templateDNA = extractLatexDNA(resolvedSource);
+    
+    console.log(chalk.green(`   ✅ DNA do Template extraído:`));
+    console.log(chalk.gray(`      - Comandos mapeados: ${templateDNA.commands.length}`));
+    console.log(chalk.gray(`      - Diretrizes/Anotações encontradas: ${templateDNA.guidelines.length}`));
+
+    return templateDNA;
+    
+  } catch (error) {
+    console.error(chalk.red(`   ❌ Erro ao processar o template: ${error.message}`));
+    return null;
+  }
+}

package/livro-final/main.tex

@@ -1,51 +0,0 @@
-\documentclass[12pt,oneside,a4paper]{book}
-
-% --- Pacotes Básicos ---
-\usepackage[utf8]{inputenc}
-\usepackage[T1]{fontenc}
-\usepackage[brazilian]{babel}
-\usepackage{graphicx}
-\usepackage{microtype}
-\usepackage{hyperref}
-\usepackage{amsmath,amssymb,amsfonts}
-\usepackage{booktabs}
-\usepackage{listings}
-
-% --- Configurações Extras ---
-% Configurações adicionais podem ser importadas de ./configs/custom.sty
-\IfFileExists{./configs/custom.sty}{\usepackage{./configs/custom}}{}
-
-\title{Ainda Não Definido}
-\author{Autor}
-\date{\today}
-
-\begin{document}
-
-% --- Capa ---
-\begin{titlepage}
-    \centering
-    \vspace*{2cm}
-    {\huge\bfseries Ainda Não Definido \par}
-    \vspace{1.5cm}
-    {\large\bfseries Autor \par}
-    \vfill
-    {\large \today \par}
-\end{titlepage}
-
-% --- Elementos Pré-textuais ---
-\frontmatter
-\tableofcontents
-\listoffigures
-\listoftables
-
-% --- Elementos Textuais ---
-\mainmatter
-
-% Os capítulos serão incluídos aqui usando \include{chapters/chapter01} etc.
-% \include{chapters/chapter01}
-
-% --- Elementos Pós-textuais ---
-\backmatter
-% \bibliography{references}
-
-\end{document}

package/livro-final/memory/memory.json

@@ -1,23 +0,0 @@
-{
-  "project": {
-    "title": "Ainda Não Definido",
-    "tone": "Pendente",
-    "language": "Pendente",
-    "code_language": "Pendente",
-    "bibliography_standard": "Pendente",
-    "status": "Ready for Setup",
-    "latex_template": "Pendente"
-  },
-  "latex_config": {
-    "listings_literate": ""
-  },
-  "chapters": [],
-  "decision_log": [
-    {
-      "timestamp": "2026-07-06T21:45:00-03:00",
-      "phase": "Initialization",
-      "action": "writerkit-init",
-      "details": "Initialized project directory structure, copied schema.md, memory.json, and created main.tex templates."
-    }
-  ]
-}

package/livro-final/memory/schema.md

@@ -1,18 +0,0 @@
-# Módulo de Memória e Estado
-
-O arquivo de memória (ex: `memory.json`) deve ser mantido e atualizado constantemente pelas *skills*.
-
-## Estrutura de Metadados do Projeto
-* **`title`**: Título da obra.
-* **`theme`**: Tema central e escopo.
-* **`language`**: Idioma da obra (ex: pt-BR).
-* **`depth`**: Nível de profundidade (Graduação, Mestrado, Técnico).
-* **`rigor`**: Nível de formalismo matemático/teórico.
-* **`tone`**: Personalidade do texto (Formal, Professoral, Crítico).
-* **`code_style`**: Linguagem e guia de estilo de código.
-* **`visual_style`**: Padrão para imagens e diagramas (ex: TikZ, preto e branco).
-* **`latex_template`**: Referências aos arquivos `.tex`, `.cls` e `.sty` utilizados.
-
-## Logs e Controle
-* **`chapters`**: Status e metadados de cada capítulo.
-* **`decision_log`**: Histórico temporal (timestamps) de todas as decisões tomadas.