grimoire-framework 1.0.16 → 1.0.18

package/.grimoire/install-manifest.yaml

@@ -7,8 +7,8 @@
 # - SHA256 hashes for change detection
 # - File types for categorization
 #
-version: 1.0.16
-generated_at: "2026-02-22T13:45:24.988Z"
+version: 1.0.18
+generated_at: "2026-02-22T14:00:42.557Z"
 generator: scripts/generate-install-manifest.js
 file_count: 1011
 files:

package/README.md

@@ -10,74 +10,121 @@
 
 ## 🚀 Início Rápido
 
-Nenhuma instalação global necessária — use diretamente via `npx`:
-
 ```bash
 # Instalar o Grimoire em um projeto existente
-npx grimoire-framework
-
-# Ou explicitamente
 npx grimoire-framework install
+
+# Atualizar para a versão mais recente (preserva customizações)
+npx grimoire-framework update
 ```
 
+Após a instalação, abra o **Gemini CLI** no diretório do projeto:
+
 ```bash
-# Criar um novo projeto do zero
-npx grimoire-framework init meu-projeto
+gemini
+# 👑 Michelangelo (grimoire-master) pronto para orquestrar!
 ```
 
 ---
 
-## 🛠️ Comandos da CLI
+## 🛠️ Comandos CLI
+
+### Gerenciamento do Framework
 
 | Comando | Descrição |
 |---|---|
-| `npx grimoire-framework` | Wizard interativo de instalação |
 | `npx grimoire-framework install` | Instalar no projeto atual |
-| `npx grimoire-framework init <nome>` | Criar novo projeto |
-| `npx grimoire-framework update` | Atualizar para a versão mais recente |
-| `npx grimoire-framework validate` | Validar integridade da instalação |
-| `npx grimoire-framework doctor` | Diagnóstico e auto-reparação |
-| `npx grimoire-framework info` | Informações do sistema |
-| `npx grimoire-framework --version` | Versão instalada |
+| `npx grimoire-framework update` | Atualizar preservando customizações |
+| `npx grimoire-framework update --force` | Forçar resync de todos os arquivos |
+| `npx grimoire-framework update --dry-run` | Simular update (sem aplicar) |
 
----
+### Diagnóstico
 
-## 🧠 O que é o Grimoire?
+| Comando | Descrição |
+|---|---|
+| `grimoire status` | Saúde do framework + integração IDE |
+| `grimoire doctor` | Diagnóstico detalhado com dicas de fix |
+| `grimoire agents list` | Listar agentes com personas |
+| `grimoire whoami` | Contexto da sessão atual |
+| `grimoire --version` | Versão instalada |
 
-O Grimoire não é apenas um assistente de código — é uma **equipe de engenharia completa na sua linha de comando**. Ele usa o **Autonomous Development Engine (ADE)** para planejar, executar, testar e revisar código de forma independente.
+> 💡 **CLI vs Agentes:** `grimoire` (terminal) gerencia o framework. `@dev`, `@qa`, `@architect` (chat da IDE) são os agentes de IA — interfaces completamente diferentes.
 
-### Filosofia: CLI First
-Toda a inteligência reside nos arquivos de configuração instalados em `.grimoire/`. Seus agentes são ativados diretamente pela sua IDE favorita, sem servidores externos.
+---
+
+## 🧙 Agentes Disponíveis
 
-### IDEs Suportadas
-- **Claude Code** — Ative agentes com `/architect`, `/dev`, `/qa`
-- **Gemini CLI** — Use `/grimoire-menu` ou `/grimoire-dev`
-- **Cursor** — Sincronização automática via `.cursorrules`
-- **VS Code / Codex** — Integração nativa via arquivos de regras
+Após instalar, ative os agentes diretamente no chat da sua IDE:
+
+| Comando | Persona | Especialidade |
+|---|---|---|
+| `@grimoire-master` | 👑 Michelangelo | Orquestração & framework |
+| `@dev` | 🎨 Da Vinci | Desenvolvimento Full-Stack |
+| `@qa` | 🖌️ Dürer | Quality Assurance & Testes |
+| `@architect` | 🏛️ Gaudí | Arquitetura de Sistemas |
+| `@pm` | 📋 Raphael | Product Manager |
+| `@sm` | 🌊 Monet | Scrum Master |
+| `@devops` | ⚡ Boccioni | DevOps & Infraestrutura |
+| `@data-engineer` | 📊 Escher | Engenharia de Dados |
+| `@analyst` | 🔍 Vermeer | Pesquisa & Análise |
+| `@ux-design-expert` | 🎭 Matisse | UX/UI Design |
+| `@po` | 🎯 Velázquez | Product Owner |
 
 ---
 
-## 🏗️ Arquitetura
+## 💻 Integração com IDEs
+
+### Gemini CLI (Recomendado)
+O Grimoire configura automaticamente o arquivo `GEMINI.md` na raiz do projeto. O Michelangelo se apresenta ao abrir o Gemini CLI.
+
+```bash
+gemini
+# 👑 Michelangelo (grimoire-master) pronto para orquestrar!
+# Projeto: meu-projeto
+```
+
+Para ativar um agente especializado:
+```
+@dev  ou  Da Vinci  ou  ative o @architect
+```
+
+### Claude Code
+Agentes disponíveis em `.claude/commands/grimoire/`. Use `/dev`, `/qa`, `/architect`.
 
-Após a instalação, o Grimoire cria o diretório `.grimoire/` no seu projeto com:
+### Cursor
+Regras instaladas em `.cursor/rules/agents/`. Agentes ativados via contexto do chat.
+
+---
+
+## 🏗️ Estrutura Instalada
 
 ```
-.grimoire/
-├── development/
-│   ├── agents/        # Analista, Arquiteto, Dev, QA, etc.
-│   ├── tasks/         # Tarefas reutilizáveis
-│   └── workflows/     # Fluxos de desenvolvimento
-├── infrastructure/    # Scripts de integração e hooks
-├── product/           # Templates e checklists
-└── core/              # Configurações do framework
+projeto/
+├── GEMINI.md              ← Config principal do Gemini CLI (Michelangelo)
+├── .gemini/
+│   ├── rules.md           ← Compatibilidade com versões antigas do Gemini CLI
+│   └── rules/grimoire/    ← Definições de agentes para Gemini
+├── .codex/agents/         ← Definições de todos os agentes (12 core)
+├── .cursor/rules/agents/  ← Agentes para Cursor
+├── .claude/commands/      ← Comandos para Claude Code
+└── .grimoire/             ← Memória, métricas e configurações
 ```
 
-### Componentes Principais
+---
 
-1. **Spec Pipeline** — Transforma prompts em especificações técnicas executáveis
-2. **Execution Engine** — Implementação autônoma com autocrítica de código
-3. **Recovery System** — Detecção automática de erros com rollback e retry
-4. **QA Loop** — Revisão de código em múltiplas fases (80%+ cobertura)
+## 🔄 Fluxo de Update
+
+O `grimoire update` é inteligente — preserva as suas customizações:
+
+- ✅ **Atualiza** arquivos do framework (agentes core, GEMINI.md)
+- 🔒 **Preserva** arquivos que só existem no seu projeto (agentes customizados)
+- ➕ **Adiciona** arquivos novos do framework
+
+```bash
+npx grimoire-framework update          # Update normal
+npx grimoire-framework update --force  # Forçar re-sync completo
+npx grimoire-framework update --dry-run # Ver o que mudaria
+```
 
 ---
 
@@ -91,6 +138,10 @@ Após a instalação, o Grimoire cria o diretório `.grimoire/` no seu projeto c
 
 ## 🗺️ Roadmap
 
+- [x] Smart Update com preservação de customizações
+- [x] Publisher Quality Gate (CI/CD)
+- [x] Integração Gemini CLI via `GEMINI.md`
+- [x] 12 agentes com personas artísticas (Michelangelo, Da Vinci, Dürer...)
 - [ ] **Sistema de Login & Autenticação** — Governança para equipes
 - [ ] **Project Models** — Templates para SaaS, Mobile, API
 - [ ] **Persistent Memory Layer** — Aprendizado de padrões do seu código
@@ -103,14 +154,9 @@ Após a instalação, o Grimoire cria o diretório `.grimoire/` no seu projeto c
 Contribuições são bem-vindas! Veja [CONTRIBUTING.md](CONTRIBUTING.md) para detalhes.
 
 ```bash
-# Clone o repositório
 git clone https://github.com/gabrielrlima/grimoire.git
 cd grimoire
-
-# Instale as dependências
 npm install
-
-# Rode os testes
 npm test
 ```
 

package/bin/grimoire-cli.js

@@ -132,12 +132,22 @@ function handleStatus() {
   const check = (p) => fs.existsSync(p);
   const icon = (v) => v ? '✅' : '❌';
 
-  // Detect project root (has .codex or .grimoire)
   const hasCodex = check(path.join(cwd, '.codex'));
   const hasGrimoire = check(path.join(cwd, '.grimoire'));
   const hasGemini = check(path.join(cwd, '.gemini'));
   const hasCursor = check(path.join(cwd, '.cursor'));
   const hasClaude = check(path.join(cwd, '.claude'));
+  const hasGeminiMd = check(path.join(cwd, 'GEMINI.md'));
+  const hasGeminiRules = check(path.join(cwd, '.gemini', 'rules.md'));
+
+  // Check GEMINI.md has correct persona
+  let geminiPersonaOk = false;
+  if (hasGeminiMd) {
+    try {
+      const content = fs.readFileSync(path.join(cwd, 'GEMINI.md'), 'utf8');
+      geminiPersonaOk = content.includes('Michelangelo');
+    } catch (e) { /* ignore */ }
+  }
 
   // Hooks check
   const settingsPath = path.join(cwd, '.gemini', 'settings.json');
@@ -162,44 +172,41 @@ function handleStatus() {
   const memDir = path.join(cwd, '.grimoire', 'memory');
   const hasMemory = check(memDir);
 
-  // Session log (last agent used)
-  const sessionLog = path.join(cwd, '.grimoire', 'logs', 'session.log');
-  let lastAgent = null;
-  if (check(sessionLog)) {
-    try {
-      const lines = fs.readFileSync(sessionLog, 'utf8').trim().split('\n');
-      const last = lines.filter(l => l.includes('agent:')).pop();
-      if (last) lastAgent = last.split('agent:')[1]?.trim();
-    } catch (e) { /* ignore */ }
+  // Installed version vs package.json
+  const installedPkgPath = path.join(cwd, 'node_modules', 'grimoire-framework', 'package.json');
+  let installedVersion = null;
+  if (check(installedPkgPath)) {
+    try { installedVersion = JSON.parse(fs.readFileSync(installedPkgPath, 'utf8')).version; } catch (e) { }
   }
+  const versionMatch = installedVersion === packageJson.version;
 
   console.log(`
 🔮 Grimoire Framework Status
 ${'='.repeat(40)}
-📎  Version:   v${packageJson.version}
-📁  Project:   ${cwd}
+📎  Version:   v${packageJson.version}${installedVersion && !versionMatch ? ` (project has v${installedVersion})` : ''}
+📁  Project:   ${path.basename(cwd)}
 
 🔧 Core
   ${icon(hasCodex)}  .codex         (agents & config)
   ${icon(hasGrimoire)}  .grimoire      (memory & metrics)
   ${icon(agentCount > 0)}  Agents:   ${agentCount} loaded
 
-🪝 Hooks (Gemini CLI)
-  ${icon(check(settingsPath))}  settings.json
-  ${icon(hooksActive)}  Hooks active:   ${hooksActive ? hooks.length + ' configured' : 'none found'}
-
 💻 IDE Integration
-  ${icon(hasGemini)}  .gemini        (Gemini CLI rules)
+  ${icon(hasGeminiMd)}  GEMINI.md      (Gemini CLI — primary config)
+  ${icon(geminiPersonaOk)}  Michelangelo persona active
+  ${icon(hasGeminiRules)}  .gemini/rules.md  (compatibility fallback)
   ${icon(hasCursor)}  .cursor        (Cursor rules)
   ${icon(hasClaude)}  .claude        (Claude commands)
 
+🪝 Hooks (Gemini CLI)
+  ${icon(check(settingsPath))}  settings.json
+  ${icon(hooksActive)}  Hooks:   ${hooksActive ? hooks.length + ' configured' : 'none'}
+
 💾 Memory Layer
   ${icon(hasMemory)}  Memory store   ${hasMemory ? '(active)' : '(not initialized)'}
-${lastAgent ? `
-🧙 Last Agent:  @${lastAgent}` : ''}
 
-  Run 'grimoire agents list' to see all agents.
-  Run 'grimoire whoami'     to see session context.
+${!hasGeminiMd || !geminiPersonaOk ? '⚠️  Run: npx grimoire-framework update --force    to fix missing files\n' : ''}  Run 'grimoire agents list' to see all agents.
+  Run 'grimoire doctor'     for diagnostics with tips.
 `);
 }
 
@@ -276,29 +283,95 @@ ${config.squad ? `👥  Squad:        ${config.squad}` : ''}
 function handleDoctor() {
   const cwd = process.cwd();
   const check = (p) => fs.existsSync(p);
-  const ok = (v, msg) => console.log(`  ${v ? '✅' : '❌'}  ${msg}`);
+  const ok = (v, msg, hint) => {
+    console.log(`  ${v ? '✅' : '❌'}  ${msg}`);
+    if (!v && hint) console.log(`       💡 ${hint}`);
+  };
+  const warn = (v, msg, hint) => {
+    console.log(`  ${v ? '✅' : '⚠️ '}  ${msg}`);
+    if (!v && hint) console.log(`       💡 ${hint}`);
+  };
 
   console.log('\n🏥 Grimoire Doctor\n' + '='.repeat(40));
 
-  ok(check(path.join(cwd, '.codex', 'agents')), '.codex/agents directory exists');
-  ok(check(path.join(cwd, '.grimoire')), '.grimoire directory exists');
-  ok(check(path.join(cwd, '.gemini', 'settings.json')), '.gemini/settings.json (hooks configured)');
-  ok(check(path.join(cwd, '.gemini', 'rules')), '.gemini/rules (agent rules installed)');
-  ok(check(path.join(cwd, '.cursor', 'rules')), '.cursor/rules (Cursor integration)');
+  // ── Gemini CLI Integration ──────────────────────────────────────
+  console.log('\n💻 Gemini CLI Integration:');
+  const geminiMdPath = path.join(cwd, 'GEMINI.md');
+  const rulesPath = path.join(cwd, '.gemini', 'rules.md');
+  const hasGeminiMd = check(geminiMdPath);
+  const hasRulesMd = check(rulesPath);
+
+  ok(hasGeminiMd, 'GEMINI.md (primary config for modern Gemini CLI)',
+    'Run: npx grimoire-framework update --force');
+  warn(hasRulesMd, '.gemini/rules.md (compatibility fallback)',
+    'Run: npx grimoire-framework update --force');
 
-  // Check package.json has grimoire
+  if (hasGeminiMd) {
+    try {
+      const content = fs.readFileSync(geminiMdPath, 'utf8');
+      ok(content.includes('Michelangelo'), 'Michelangelo persona in GEMINI.md',
+        'GEMINI.md may be outdated — run: npx grimoire-framework update --force');
+      ok(content.includes('@dev'), 'Agent roster in GEMINI.md',
+        'GEMINI.md is missing the agent roster');
+    } catch (e) { ok(false, 'GEMINI.md readable'); }
+  }
+
+  // ── Agents ─────────────────────────────────────────────────────
+  console.log('\n🤖 Agents:');
+  const agentsDir = path.join(cwd, '.codex', 'agents');
+  ok(check(agentsDir), '.codex/agents directory', 'Run: npx grimoire-framework update --force');
+  if (check(agentsDir)) {
+    const agents = fs.readdirSync(agentsDir).filter(f => f.endsWith('.md'));
+    ok(agents.length >= 10, `Core agents installed (${agents.length} found, need ≥10)`,
+      'Run: npx grimoire-framework update --force');
+
+    const requiredAgents = ['grimoire-master.md', 'dev.md', 'qa.md', 'architect.md', 'pm.md'];
+    for (const a of requiredAgents) {
+      warn(agents.includes(a), `Agent: ${a.replace('.md', '')}`);
+    }
+
+    // Check grimoire-master has Michelangelo
+    const masterPath = path.join(agentsDir, 'grimoire-master.md');
+    if (check(masterPath)) {
+      try {
+        const content = fs.readFileSync(masterPath, 'utf8');
+        ok(content.includes('Michelangelo'), 'grimoire-master has Michelangelo persona',
+          'Outdated agent — run: npx grimoire-framework update --force');
+      } catch (e) { }
+    }
+  }
+
+  // ── Framework Package ──────────────────────────────────────────
+  console.log('\n📦 Package:');
   const pkgPath = path.join(cwd, 'package.json');
   if (check(pkgPath)) {
     try {
       const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
       const deps = { ...pkg.dependencies, ...pkg.devDependencies };
-      ok(!!deps['grimoire-framework'], 'grimoire-framework in package.json');
+      ok(!!deps['grimoire-framework'], 'grimoire-framework in package.json',
+        'Run: npm install grimoire-framework');
+
+      // Check installed version vs latest
+      const installedPkgPath = path.join(cwd, 'node_modules', 'grimoire-framework', 'package.json');
+      if (check(installedPkgPath)) {
+        try {
+          const installedVer = JSON.parse(fs.readFileSync(installedPkgPath, 'utf8')).version;
+          const declaredVer = (deps['grimoire-framework'] || '').replace(/[^0-9.]/g, '');
+          ok(true, `Installed version: v${installedVer}`);
+        } catch (e) { }
+      }
     } catch (e) { ok(false, 'package.json readable'); }
   } else {
     ok(false, 'package.json found');
   }
 
-  console.log('\n  Run \'grimoire status\' for full framework state.\n');
+  // ── Other IDEs ────────────────────────────────────────────────
+  console.log('\n🔗 Other IDE Integration:');
+  warn(check(path.join(cwd, '.cursor', 'rules')), '.cursor/rules (Cursor)');
+  warn(check(path.join(cwd, '.claude')), '.claude/ (Claude Code)');
+
+  console.log('\n  Run \'grimoire status\' for full framework state.');
+  console.log('  Run \'npx grimoire-framework update --force\' to resync all files.\n');
 }
 
 function showHelp() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "grimoire-framework",
-  "version": "1.0.16",
+  "version": "1.0.18",
   "description": "Grimoire: AI-Orchestrated System for Full Stack Development - Core Framework",
   "publishConfig": {
     "access": "public"

package/packages/installer/src/updater/index.js

@@ -5,6 +5,10 @@
  * @module packages/installer/src/updater
  * @story Epic 7 - CLI Update Command
  * @version 1.0.0
+ * @deprecated Use bin/commands/update.js instead.
+ *   The new smart update command (grimoire-framework@1.0.10+) replaces this class.
+ *   This file is kept for backwards compatibility of the installer wizard only.
+ *   DO NOT add new update logic here — use bin/commands/update.js.
  *
  * Features:
  * - Detects installed version vs latest available