grimoire-framework 1.0.9 → 1.0.11

package/.grimoire/install-manifest.yaml

@@ -7,8 +7,8 @@
 # - SHA256 hashes for change detection
 # - File types for categorization
 #
-version: 1.0.9
-generated_at: "2026-02-22T12:01:52.134Z"
+version: 1.0.11
+generated_at: "2026-02-22T12:28:20.727Z"
 generator: scripts/generate-install-manifest.js
 file_count: 1011
 files:
@@ -3553,9 +3553,9 @@ files:
     type: template
     size: 3073
   - path: product/templates/ide-rules/gemini-rules.md
-    hash: sha256:99515bd21ab26ca10bde3d14b61a0dfc3cd4d31a3f7b98729b8ebfba3d9de1d5
+    hash: sha256:325b227bb6b1bb2006e5b1b62f724b0aba51b60e03cdb113e27ff485f7f35aae
     type: template
-    size: 2551
+    size: 4546
   - path: product/templates/index-strategy-tmpl.yaml
     hash: sha256:6db2b40f6eef47f4faa31ce513ee7b0d5f04d9a5e081a72e0cdbad402eb444ae
     type: template

package/.grimoire/product/templates/ide-rules/gemini-rules.md

@@ -1,16 +1,97 @@
-# Gemini Rules - Grimoire
-
-Este arquivo define as instrucoes do projeto para Gemini CLI neste repositorio.
+# Grimoire Framework — {{projectName}}
+
+<!-- grimoire-MANAGED-START: default-agent -->
+## 👑 Agente Padrão: Michelangelo (grimoire-master)
+
+**INSTRUÇÃO OBRIGATÓRIA AO INICIAR:** Você é o **Michelangelo**, o Mestre Orquestrador do Grimoire Framework. Adote esta persona imediatamente.
+
+Ao iniciar a sessão, apresente-se assim:
+
+> 👑 **Michelangelo** (grimoire-master) pronto para orquestrar!
+> Projeto: **{{projectName}}**
+>
+> Posso ajudá-lo com qualquer tarefa. Para ativar um agente especializado, diga o nome ou use:
+> - `@dev` → Da Vinci (Desenvolvedor Full-Stack)
+> - `@qa` → Dürer (Quality Assurance)
+> - `@architect` → Gaudí (Arquitetura de Sistemas)
+> - `@pm` → Raphael (Product Manager)
+> - `@sm` → Monet (Scrum Master)
+> - `@ux-design-expert` → Matisse (UX/Design)
+> - `@devops` → Boccioni (DevOps)
+> - `@data-engineer` → Escher (Engenharia de Dados)
+> - `@analyst` → Vermeer (Análise & Pesquisa)
+> - `@po` → Velázquez (Product Owner)
+>
+> Digite `*help` para ver todos os comandos. — Michelangelo 🎯
+
+### Definição do agente
+
+```yaml
+activation-instructions:
+  - STEP 1: Adote a persona Michelangelo imediatamente
+  - STEP 2: Apresente o greeting acima ao usuário
+  - STEP 3: Aguarde input do usuário — NÃO faça varredura do filesystem
+  - STAY IN CHARACTER como Michelangelo até o usuário digitar *exit
+  - CRITICAL: NÃO carregue arquivos externos durante ativação
+
+agent:
+  name: Michelangelo
+  id: grimoire-master
+  title: Grimoire Master Orchestrator & Framework Developer
+  icon: 👑
+  whenToUse: Use para orquestração, criação de componentes do framework, e quando precisar de expertise cross-domínio.
+
+commands:
+  - "*help       — Lista todos os comandos"
+  - "*status     — Contexto atual e progresso"
+  - "*task {x}   — Execute tarefa específica"
+  - "*workflow {x} — Inicie workflow"
+  - "*exit       — Sair do modo agente"
+
+signature_closing: '— Michelangelo, orquestrando o sistema 🎯'
+```
+<!-- grimoire-MANAGED-END: default-agent -->
+
+---
+
+<!-- grimoire-MANAGED-START: agent-roster -->
+## 🧙 Roster de Agentes — Grimoire
+
+| Agente | Persona | Especialidade |
+|--------|---------|---------------|
+| `@grimoire-master` | 👑 Michelangelo | Orquestração & framework |
+| `@dev` | 🎨 Da Vinci | Desenvolvimento full-stack |
+| `@qa` | 🖌️ Dürer | Qualidade & testes |
+| `@architect` | 🏛️ Gaudí | Arquitetura de sistemas |
+| `@pm` | 📋 Raphael | Produto & estratégia |
+| `@sm` | 🌊 Monet | Scrum Master |
+| `@devops` | ⚡ Boccioni | DevOps & infraestrutura |
+| `@data-engineer` | 📊 Escher | Dados & banco |
+| `@analyst` | 🔍 Vermeer | Pesquisa & análise |
+| `@ux-design-expert` | 🎭 Matisse | UX/UI Design |
+| `@po` | 🎯 Velázquez | Product Owner |
+| `@squad-creator` | 🗿 Rodin | Criação de squads |
+
+### Como ativar um agente especializado
+
+Diga no chat: `ative o @dev` ou `quero falar com Da Vinci` ou simplesmente `@architect`.
+
+O agente carregará sua definição completa de `.gemini/rules/grimoire/agents/{agente}.md`.
+<!-- grimoire-MANAGED-END: agent-roster -->
+
+---
 
 <!-- grimoire-MANAGED-START: core -->
 ## Core Rules
 
 1. Siga a Constitution em `.grimoire/constitution.md`
-2. Priorize `CLI First -> Observability Second -> UI Third`
+2. Priorize `CLI First → Observability Second → UI Third`
 3. Trabalhe por stories em `docs/stories/`
 4. Nao invente requisitos fora dos artefatos existentes
 <!-- grimoire-MANAGED-END: core -->
 
+---
+
 <!-- grimoire-MANAGED-START: quality -->
 ## Quality Gates
 
@@ -20,70 +101,28 @@ Este arquivo define as instrucoes do projeto para Gemini CLI neste repositorio.
 - Atualize checklist e file list da story antes de concluir
 <!-- grimoire-MANAGED-END: quality -->
 
-<!-- grimoire-MANAGED-START: codebase -->
-## Project Map
-
-- Core framework: `.grimoire/`
-- CLI entrypoints: `bin/`
-- Shared packages: `packages/`
-- Tests: `tests/`
-- Docs: `docs/`
-<!-- grimoire-MANAGED-END: codebase -->
-
-<!-- grimoire-MANAGED-START: gemini-integration -->
-## Gemini Integration
-
-Fonte de verdade de agentes:
-- Canonico: `.grimoire/development/agents/*.md`
-- Espelhado para Gemini: `.gemini/rules/grimoire/agents/*.md`
-
-Hooks e settings:
-- Hooks locais: `.gemini/hooks/`
-- Settings locais: `.gemini/settings.json`
-
-Sempre que houver drift, execute:
-- `npm run sync:ide:gemini`
-- `npm run validate:gemini-sync`
-- `npm run validate:gemini-integration`
-<!-- grimoire-MANAGED-END: gemini-integration -->
-
-<!-- grimoire-MANAGED-START: parity -->
-## Multi-IDE Parity
-
-Para garantir paridade entre Claude Code, Codex e Gemini:
-- `npm run validate:parity`
-- `npm run validate:paths`
-<!-- grimoire-MANAGED-END: parity -->
+---
 
 <!-- grimoire-MANAGED-START: activation -->
-## Agent Activation
+## Ativação de Agente Especializado
 
-Preferencia de ativacao:
-1. Use agentes em `.gemini/rules/grimoire/agents/`
-2. Se necessario, use fonte canonica em `.grimoire/development/agents/`
+Quando o usuário solicitar um agente especializado (ex: `@dev`, `@qa`, etc.):
+1. Carregue `.gemini/rules/grimoire/agents/{agente-id}.md`
+2. Adote completamente a persona definida no arquivo
+3. Apresente o greeting definido em `greeting_levels`
+4. Mantenha a persona até `*exit`
 
-Ao ativar agente:
-- carregar definicao completa do agente
-- renderizar greeting via `node .grimoire/development/scripts/generate-greeting.js <agent-id>`
-- manter persona ativa ate `*exit`
-
-Atalhos recomendados no Gemini:
-- `/grimoire-menu` para listar agentes
-- `/grimoire-<agent-id>` (ex.: `/grimoire-dev`, `/grimoire-architect`)
-- `/grimoire-agent <agent-id>` para launcher generico
+Shortcuts:
+- `/grimoire-menu` — lista todos os agentes
+- `/grimoire-{id}` ex: `/grimoire-dev`, `/grimoire-architect`
 <!-- grimoire-MANAGED-END: activation -->
 
-<!-- grimoire-MANAGED-START: commands -->
-## Common Commands
-
-- `npm run sync:ide`
-- `npm run sync:ide:check`
-- `npm run sync:ide:gemini`
-- `npm run validate:gemini-sync`
-- `npm run validate:gemini-integration`
-- `npm run validate:parity`
-- `npm run validate:structure`
-- `npm run validate:agents`
-<!-- grimoire-MANAGED-END: commands -->
-
-
+---
+
+<!-- grimoire-MANAGED-START: framework -->
+## Framework vs CLI
+
+- **CLI (terminal):** `grimoire status` · `grimoire whoami` · `grimoire agents list`
+- **Agentes (chat):** `@dev` · `@qa` · `@architect` — ativados no chat do IDE
+- Estes são interfaces DIFERENTES — CLI gerencia o framework, agentes respondem no chat.
+<!-- grimoire-MANAGED-END: framework -->

package/bin/commands/update.js

@@ -0,0 +1,251 @@
+'use strict';
+
+/**
+ * grimoire Smart Update Command
+ * Updates grimoire-framework preserving project customizations.
+ *
+ * Strategy:
+ *  1. Check installed vs latest version on npm
+ *  2. npm install grimoire-framework@latest
+ *  3. Selectively copy framework files (agents, rules, hooks)
+ *     - OVERWRITE files that are part of the framework source
+ *     - PRESERVE files that only exist in the project (custom agents, etc.)
+ *  4. Report what was updated/preserved
+ */
+
+const fs = require('fs');
+const path = require('path');
+const https = require('https');
+const { execSync } = require('child_process');
+
+// Framework source directories (relative to node_modules/grimoire-framework)
+const FRAMEWORK_SYNC_DIRS = [
+    { src: '.codex/agents', dest: '.codex/agents' },
+    { src: '.gemini/rules/grimoire', dest: '.gemini/rules/grimoire' },
+    { src: '.cursor/rules/agents', dest: '.cursor/rules/agents' },
+    { src: '.claude/commands/grimoire', dest: '.claude/commands/grimoire' },
+];
+
+/**
+ * Fetch latest version from npm registry
+ */
+function getLatestVersion() {
+    return new Promise((resolve) => {
+        const req = https.get(
+            'https://registry.npmjs.org/grimoire-framework/latest',
+            { timeout: 10000 },
+            (res) => {
+                let data = '';
+                res.on('data', (chunk) => { data += chunk; });
+                res.on('end', () => {
+                    try { resolve(JSON.parse(data).version || null); }
+                    catch { resolve(null); }
+                });
+            }
+        );
+        req.on('error', () => resolve(null));
+        req.on('timeout', () => { req.destroy(); resolve(null); });
+    });
+}
+
+/**
+ * Get installed version from node_modules
+ */
+function getInstalledVersion(cwd) {
+    const pkgPath = path.join(cwd, 'node_modules', 'grimoire-framework', 'package.json');
+    if (fs.existsSync(pkgPath)) {
+        try { return JSON.parse(fs.readFileSync(pkgPath, 'utf8')).version; }
+        catch { /* ignore */ }
+    }
+    // Fallback: check project package.json dependencies
+    const projPkg = path.join(cwd, 'package.json');
+    if (fs.existsSync(projPkg)) {
+        try {
+            const pkg = JSON.parse(fs.readFileSync(projPkg, 'utf8'));
+            return (pkg.dependencies || {})['grimoire-framework'] ||
+                (pkg.devDependencies || {})['grimoire-framework'] || null;
+        } catch { /* ignore */ }
+    }
+    return null;
+}
+
+/**
+ * Compare semver strings. Returns: -1 (v1<v2), 0 (equal), 1 (v1>v2)
+ */
+function compareVersions(v1, v2) {
+    const parse = (v) => v.replace(/[^0-9.]/g, '').split('.').map(Number);
+    const [a, b] = [parse(v1), parse(v2)];
+    for (let i = 0; i < 3; i++) {
+        if ((a[i] || 0) > (b[i] || 0)) return 1;
+        if ((a[i] || 0) < (b[i] || 0)) return -1;
+    }
+    return 0;
+}
+
+/**
+ * Recursively get all .md files in a directory
+ */
+function listMdFiles(dir) {
+    if (!fs.existsSync(dir)) return [];
+    const results = [];
+    for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+        const full = path.join(dir, entry.name);
+        if (entry.isDirectory()) results.push(...listMdFiles(full));
+        else if (entry.name.endsWith('.md')) results.push(full);
+    }
+    return results;
+}
+
+/**
+ * Sync a directory from framework source to project destination.
+ * - Overwrites files that exist in source (framework files)
+ * - Preserves files that only exist in destination (custom files)
+ * Returns stats: { updated, preserved, added }
+ */
+function syncDir(srcDir, destDir) {
+    const stats = { updated: [], preserved: [], added: [] };
+
+    if (!fs.existsSync(srcDir)) return stats;
+    fs.mkdirSync(destDir, { recursive: true });
+
+    // Get files in both dirs
+    const srcFiles = new Set(
+        fs.readdirSync(srcDir).filter(f => f.endsWith('.md') || f.endsWith('.json') || f.endsWith('.yaml'))
+    );
+    const destFiles = new Set(
+        fs.existsSync(destDir)
+            ? fs.readdirSync(destDir).filter(f => f.endsWith('.md') || f.endsWith('.json') || f.endsWith('.yaml'))
+            : []
+    );
+
+    // Copy/overwrite source files to dest
+    for (const file of srcFiles) {
+        const srcFile = path.join(srcDir, file);
+        const destFile = path.join(destDir, file);
+        const existed = destFiles.has(file);
+        fs.copyFileSync(srcFile, destFile);
+        if (existed) stats.updated.push(file);
+        else stats.added.push(file);
+    }
+
+    // Files in dest but NOT in source = custom files → preserve (do nothing)
+    for (const file of destFiles) {
+        if (!srcFiles.has(file)) {
+            stats.preserved.push(file);
+        }
+    }
+
+    return stats;
+}
+
+/**
+ * Main run function called by the CLI
+ */
+async function run(args = []) {
+    const cwd = process.cwd();
+    const dryRun = args.includes('--dry-run') || args.includes('--check');
+    const force = args.includes('--force');
+    const verbose = args.includes('--verbose') || args.includes('-v');
+
+    console.log('\n🔮 Grimoire Smart Update\n' + '='.repeat(40));
+
+    // 1. Get versions
+    const installed = getInstalledVersion(cwd);
+    process.stdout.write('📡 Checking latest version on npm...');
+    const latest = await getLatestVersion();
+    console.log(latest ? ` v${latest}` : ' (offline)');
+
+    console.log(`📦 Installed: ${installed ? `v${installed}` : '❌ not found in node_modules'}`);
+    console.log(`📦 Latest:    ${latest ? `v${latest}` : '❌ could not fetch'}\n`);
+
+    if (!installed) {
+        console.log('⚠️  grimoire-framework not found in this project.\n   Run: npx grimoire-framework install\n');
+        return;
+    }
+
+    if (!latest) {
+        console.log('⚠️  Could not reach npm registry. Check your internet connection.\n');
+        return;
+    }
+
+    const cmp = compareVersions(installed.replace(/[\^~><=]/g, ''), latest);
+
+    if (cmp >= 0 && !force) {
+        console.log('✅ Already up to date! No update needed.\n');
+        console.log('   Use --force to reinstall anyway.\n');
+        return;
+    }
+
+    if (dryRun) {
+        console.log(`🔍 DRY RUN — would update v${installed} → v${latest}\n`);
+        console.log('   Directories that would be synced:');
+        for (const { dest } of FRAMEWORK_SYNC_DIRS) {
+            console.log(`   • ${dest}`);
+        }
+        console.log('\n   Custom files (only in project) would be PRESERVED.');
+        console.log('   Run without --dry-run to apply.\n');
+        return;
+    }
+
+    // 2. Update npm package
+    console.log(`⬇️  Updating grimoire-framework v${installed} → v${latest}...`);
+    try {
+        execSync('npm install grimoire-framework@latest', {
+            cwd,
+            stdio: verbose ? 'inherit' : 'pipe',
+            timeout: 120000,
+        });
+        console.log('✅ npm package updated.\n');
+    } catch (err) {
+        console.error(`❌ npm install failed: ${err.message}\n`);
+        return;
+    }
+
+    // 3. Sync framework files selectively
+    const frameworkRoot = path.join(cwd, 'node_modules', 'grimoire-framework');
+
+    if (!fs.existsSync(frameworkRoot)) {
+        console.log('❌ Could not find grimoire-framework in node_modules after install.\n');
+        return;
+    }
+
+    console.log('🔄 Syncing framework files...\n');
+
+    const totalStats = { updated: 0, added: 0, preserved: 0 };
+    const report = [];
+
+    for (const { src, dest } of FRAMEWORK_SYNC_DIRS) {
+        const srcPath = path.join(frameworkRoot, src);
+        const destPath = path.join(cwd, dest);
+
+        if (!fs.existsSync(srcPath)) {
+            if (verbose) console.log(`  ⏭️  Skip (not in source): ${src}`);
+            continue;
+        }
+
+        const stats = syncDir(srcPath, destPath);
+        totalStats.updated += stats.updated.length;
+        totalStats.added += stats.added.length;
+        totalStats.preserved += stats.preserved.length;
+
+        report.push({ dir: dest, stats });
+
+        if (stats.updated.length || stats.added.length || stats.preserved.length) {
+            console.log(`  📁 ${dest}`);
+            if (stats.updated.length) console.log(`     ✅ Updated:   ${stats.updated.join(', ')}`);
+            if (stats.added.length) console.log(`     ➕ Added:     ${stats.added.join(', ')}`);
+            if (stats.preserved.length) console.log(`     🔒 Preserved: ${stats.preserved.join(', ')} (custom)`);
+        }
+    }
+
+    // 4. Summary
+    console.log('\n' + '='.repeat(40));
+    console.log(`✅ Updated to v${latest}\n`);
+    console.log(`   📝 Files updated:   ${totalStats.updated}`);
+    console.log(`   ➕ Files added:     ${totalStats.added}`);
+    console.log(`   🔒 Files preserved: ${totalStats.preserved} (custom — untouched)\n`);
+    console.log('   Run: grimoire status   to verify the framework is healthy.');
+    console.log('   Run: grimoire doctor   for full diagnostics.\n');
+}
+
+module.exports = { run };

package/bin/grimoire-cli.js

@@ -33,11 +33,13 @@ async function main() {
     case 'whoami':
       handleWhoami();
       break;
+    case 'update':
+      await require('./commands/update').run(args.slice(1));
+      break;
     case 'doctor':
       handleDoctor();
       break;
     case 'install':
-    case 'update':
     case 'validate':
     case 'info':
       console.log(`Delegating ${command} to core logic...`);

package/package.json

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