grimoire-framework 1.2.0 → 1.4.0

package/.grimoire/install-manifest.yaml

@@ -7,8 +7,8 @@
 # - SHA256 hashes for change detection
 # - File types for categorization
 #
-version: 1.2.0
-generated_at: "2026-02-22T16:41:00.136Z"
+version: 1.4.0
+generated_at: "2026-02-22T17:13:01.000Z"
 generator: scripts/generate-install-manifest.js
 file_count: 1011
 files:

package/README.md

@@ -1,171 +1,209 @@
-# Grimoire: AI-Orchestrated System for Full Stack Development 🧙‍♂️
+# 🔮 Grimoire Framework
 
-[![npm version](https://img.shields.io/npm/v/grimoire-framework.svg)](https://www.npmjs.com/package/grimoire-framework)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-[![Node.js](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen)](https://nodejs.org)
+> **CLI de gestão para frameworks de agentes de IA** — instale uma vez, use em todos os seus projetos
 
-> Framework de desenvolvimento autônomo orientado por IA que orquestra equipes de agentes especializados para transformar requisitos em software funcional.
+[![npm](https://img.shields.io/npm/v/grimoire-framework.svg)](https://www.npmjs.com/package/grimoire-framework)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org)
 
 ---
 
-## 🚀 Início Rápido
+## ⚡ Quick Start (5 passos)
 
 ```bash
-# Instalar o Grimoire em um projeto existente
+# 1. Instale no projeto
 npx grimoire-framework install
 
-# Atualizar para a versão mais recente (preserva customizações)
-npx grimoire-framework update
-```
+# 2. Gere o prompt de início de sessão
+grimoire session start
 
-Após a instalação, abra o **Gemini CLI** no diretório do projeto:
+# 3. Cole o prompt no chat da sua IDE e ative um agente
+# @dev  @qa  @architect  @grimoire-master
 
-```bash
-gemini
-# 👑 Michelangelo (grimoire-master) pronto para orquestrar!
+# 4. Crie e rastreie stories
+grimoire story create "Implementar autenticação JWT"
+
+# 5. Veja o relatório ao final do dia
+grimoire report
 ```
 
 ---
 
-## 🛠️ Comandos CLI
-
-### Gerenciamento do Framework
-
-| Comando | Descrição |
-|---|---|
-| `npx grimoire-framework install` | Instalar no projeto atual |
-| `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 é um framework que adiciona **agentes de IA especializados** ao chat da sua IDE (Gemini CLI, Cursor, VS Code, Claude). Cada agente tem uma persona, expertise e estilo próprios.
 
-> 💡 **CLI vs Agentes:** `grimoire` (terminal) gerencia o framework. `@dev`, `@qa`, `@architect` (chat da IDE) são os agentes de IA — interfaces completamente diferentes.
+```
+CLI (terminal)  →  gerencia o framework
+Agentes (IDE)   →  @dev, @qa, @architect no chat da IDE
+```
 
 ---
 
-## 🧙 Agentes Disponíveis
-
-Após instalar, ative os agentes diretamente no chat da sua IDE:
+## 🤖 Agentes incluídos
 
-| Comando | Persona | Especialidade |
+| Agente | 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 |
+| `@grimoire-master` | 👑 Michelangelo | Orquestração |
+| `@dev` | 🎨 Da Vinci | Full-stack |
+| `@qa` | 🖌️ Dürer | QA & testes |
+| `@architect` | 🏛️ Gaudí | Arquitetura |
+| `@pm` | 📋 Raphael | Produto |
+| `@ux-design-expert` | 🎭 Matisse | UX/Design |
+| `@devops` | ⚡ Boccioni | DevOps |
+| `@data-engineer` | 📊 Escher | Dados |
+| `@analyst` | 🔍 Vermeer | Pesquisa |
 | `@po` | 🎯 Velázquez | Product Owner |
+| `@sm` | 🌊 Monet | Scrum Master |
+| `@squad-creator` | 🗿 Rodin | Criação de squads |
 
 ---
 
-## 💻 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.
+## 📋 Referência de comandos
 
+### Essenciais
 ```bash
-gemini
-# 👑 Michelangelo (grimoire-master) pronto para orquestrar!
-# Projeto: meu-projeto
+grimoire status              # saúde do framework
+grimoire whoami              # contexto completo (config+pro+stories)
+grimoire doctor              # diagnóstico completo com dicas
+grimoire update              # atualiza agentes e arquivos
+grimoire update --dry-run    # preview sem aplicar
 ```
 
-Para ativar um agente especializado:
-```
-@dev  ou  Da Vinci  ou  ative o @architect
+### Sessão & Workflow
+```bash
+grimoire session start               # prompt para IDE (squad+stories+memória)
+grimoire session start --squad dev   # com squad específico
+grimoire story create "Título"       # nova story
+grimoire story list                  # stories ativas
+grimoire story done US-001           # marcar concluída
+grimoire story note US-001 "obs"     # adicionar nota
+grimoire story show US-001           # detalhes + memórias linkadas
+grimoire report                      # relatório de hoje
+grimoire report --period week        # relatório da semana (7 dias)
+grimoire report --md                 # exportar relatório para Markdown
 ```
 
-### Claude Code
-Agentes disponíveis em `.claude/commands/grimoire/`. Use `/dev`, `/qa`, `/architect`.
-
-### Cursor
-Regras instaladas em `.cursor/rules/agents/`. Agentes ativados via contexto do chat.
-
----
+### Agentes
+```bash
+grimoire agents list          # lista com personas
+grimoire agent create         # wizard interativo
+grimoire agent validate dev   # valida YAML e campos (score 0-100)
+grimoire agent edit dev       # abre no $EDITOR
+grimoire agent remove dev     # remove agente customizado
+```
 
-## 🏗️ Estrutura Instalada
+### Squads
+```bash
+grimoire squads list                # lista squads disponíveis
+grimoire squads use fullstack       # prompt de ativação para IDE
+grimoire squads info fullstack      # detalhes do squad
+```
 
+### Memória
+```bash
+grimoire memory save "texto"                # salvar entrada
+grimoire memory save --tag decisão "txt"    # com tag
+grimoire memory save --story US-001 "txt"   # linkada a story
+grimoire memory show                        # entradas de hoje
+grimoire memory search "termo"              # buscar em sessões
+grimoire memory list-tags                   # tags únicas com contagem
+grimoire memory export                      # exportar para Markdown
+grimoire memory clear --older-than 30       # limpar antigas
 ```
-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
+
+### Busca & Backup
+```bash
+grimoire search "JWT"               # busca global (memória+stories+agentes)
+grimoire search "JWT" --memory      # só memória
+grimoire search "JWT" --stories     # só stories
+grimoire backup                     # backup de .grimoire/
+grimoire backup --list              # listar backups
+grimoire backup --restore <arq>     # restaurar backup
+grimoire export --all               # bundle Markdown completo
+grimoire export --all --json        # bundle JSON completo
 ```
 
----
+### Métricas
+```bash
+grimoire metrics                       # dashboard do mês
+grimoire metrics --period week         # últimos 7 dias
+grimoire metrics --period all          # histórico completo
+grimoire metrics export --csv          # exportar para CSV
+grimoire metrics track session "desc"  # registrar evento manual
+```
 
-## 🔄 Fluxo de Update
+### Config & Hooks
+```bash
+grimoire config list               # todas as configurações
+grimoire config get default_agent  # valor de uma chave
+grimoire config set default_agent dev  # definir valor
+grimoire config reset              # restaurar defaults
+grimoire hooks install             # git post-commit (auto-tracking)
+grimoire hooks status              # verificar status do hook
+grimoire hooks uninstall           # remover hook
+```
 
-O `grimoire update` é inteligente — preserva as suas customizações:
+### Sync Global
+```bash
+grimoire sync --global       # envia agentes → ~/.grimoire/agents/
+grimoire sync --from-global  # puxa agentes do store global
+grimoire sync --list         # lista agentes no store
+```
 
-- ✅ **Atualiza** arquivos do framework (agentes core, GEMINI.md)
-- 🔒 **Preserva** arquivos que só existem no seu projeto (agentes customizados)
-- ➕ **Adiciona** arquivos novos do framework
+### Marketplace
+```bash
+grimoire marketplace list           # navega agentes da comunidade
+grimoire marketplace install slug   # instala agente
+grimoire marketplace search "termo" # busca por especialidade
+grimoire marketplace submit         # guia para publicar
+```
 
+### Grimoire Pro
 ```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
+grimoire pro activate <chave>   # ativa licença Pro
+grimoire pro status             # status e features
+grimoire pro features           # lista features Pro
+grimoire pro deactivate         # remove licença
 ```
 
 ---
 
-## ⚙️ Requisitos
+## 📁 Estrutura do projeto
 
-- **Node.js** >= 18.0.0
-- **npm** >= 9.0.0
-- **Git** (recomendado)
+```
+seu-projeto/
+├── .grimoire/
+│   ├── memory/sessions/     # memória JSONL
+│   ├── metrics/             # métricas JSONL
+│   ├── stories/             # stories JSON
+│   ├── backups/             # backups .grimbak
+│   ├── exports/             # bundles exportados
+│   └── config.yaml          # configurações do projeto
+├── .codex/agents/           # agentes Gemini CLI
+├── .gemini/                 # config Gemini CLI
+├── .cursor/                 # regras Cursor
+└── GEMINI.md                # persona principal
+```
 
 ---
 
-## 🗺️ Roadmap
+## 📦 Versões
 
-- [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
-- [ ] **Enterprise Connectors** — Integração com Jira, Notion e Slack
+| Versão | Features |
+|---|---|
+| v1.0.x | Setup, agents, sync global |
+| v1.1.x | Marketplace, Grimoire Pro |
+| v1.2.0 | Squads use, config, hooks, agent validate, memory tags |
+| v1.3.0 | Report, story, session start, doctor v3, whoami v2 |
+| **v1.4.0** | **Search global, backup, export --all, memory --story, story note** |
 
 ---
 
 ## 🤝 Contribuindo
 
-Contribuições são bem-vindas! Veja [CONTRIBUTING.md](CONTRIBUTING.md) para detalhes.
-
-```bash
-git clone https://github.com/gabrielrlima/grimoire.git
-cd grimoire
-npm install
-npm test
-```
-
----
-
-## 📄 Licença
-
-Distribuído sob a licença MIT. Veja [LICENSE](LICENSE) para mais informações.
+Veja [CONTRIBUTING.md](CONTRIBUTING.md) e [docs/CHANGELOG.md](docs/CHANGELOG.md).
 
 ---
 
-Built with ❤️ by the **Grimoire Team** • [npm](https://www.npmjs.com/package/grimoire-framework) • [GitHub](https://github.com/gabrielrlima/grimoire)
+*Grimoire Framework · MIT License · Made with ❤️ by the community*

package/bin/commands/backup.js

@@ -0,0 +1,165 @@
+/**
+ * grimoire backup — Backup & Restore .grimoire/
+ *
+ * grimoire backup                  Cria backup zip de .grimoire/
+ * grimoire backup --restore <file> Restaura a partir de um zip
+ * grimoire backup --list           Lista backups existentes
+ */
+
+'use strict';
+
+const path = require('path');
+const fs = require('fs');
+const zlib = require('zlib');
+
+function findGrimoireDir() {
+    const cwd = process.cwd();
+    const direct = path.join(cwd, '.grimoire');
+    const sub = path.join(cwd, 'grimoire', '.grimoire');
+    if (fs.existsSync(direct)) return { dir: direct, root: cwd };
+    if (fs.existsSync(sub)) return { dir: sub, root: path.join(cwd, 'grimoire') };
+    return null;
+}
+
+function getBackupDir(grimoireDir) {
+    const d = path.join(grimoireDir, 'backups');
+    if (!fs.existsSync(d)) fs.mkdirSync(d, { recursive: true });
+    return d;
+}
+
+// Simple tar-like serialization using NDJSON (no native zip without deps)
+// Format: one header line + files as base64 encoded NDJSON entries
+function createBackup(grimoireDir, backupDir) {
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
+    const backupFile = path.join(backupDir, `backup-${timestamp}.grimbak`);
+
+    const SKIP_DIRS = new Set(['backups', 'exports']);
+    const entries = [];
+
+    function walk(dir, rel = '') {
+        for (const item of fs.readdirSync(dir, { withFileTypes: true })) {
+            const relPath = rel ? `${rel}/${item.name}` : item.name;
+            const abs = path.join(dir, item.name);
+            if (item.isDirectory()) {
+                if (!SKIP_DIRS.has(item.name)) walk(abs, relPath);
+            } else {
+                try {
+                    const content = fs.readFileSync(abs).toString('base64');
+                    entries.push({ path: relPath, content, size: fs.statSync(abs).size });
+                } catch (_) { }
+            }
+        }
+    }
+
+    walk(grimoireDir);
+
+    const header = JSON.stringify({
+        version: 1,
+        createdAt: new Date().toISOString(),
+        files: entries.length,
+        source: grimoireDir
+    });
+
+    const lines = [header, ...entries.map(e => JSON.stringify(e))];
+    const raw = lines.join('\n');
+    const buf = zlib.gzipSync(Buffer.from(raw, 'utf8'));
+    fs.writeFileSync(backupFile, buf);
+
+    return { file: backupFile, count: entries.length, size: buf.length };
+}
+
+function restoreBackup(backupFile, grimoireDir) {
+    if (!fs.existsSync(backupFile)) {
+        throw new Error(`Arquivo não encontrado: ${backupFile}`);
+    }
+    const buf = fs.readFileSync(backupFile);
+    const raw = zlib.gunzipSync(buf).toString('utf8');
+    const lines = raw.split('\n').filter(l => l.trim());
+    const header = JSON.parse(lines[0]);
+
+    let restored = 0;
+    for (const line of lines.slice(1)) {
+        try {
+            const entry = JSON.parse(line);
+            const dest = path.join(grimoireDir, entry.path);
+            fs.mkdirSync(path.dirname(dest), { recursive: true });
+            fs.writeFileSync(dest, Buffer.from(entry.content, 'base64'));
+            restored++;
+        } catch (_) { }
+    }
+    return { count: restored, header };
+}
+
+function listBackups(backupDir) {
+    if (!fs.existsSync(backupDir)) return [];
+    return fs.readdirSync(backupDir)
+        .filter(f => f.endsWith('.grimbak'))
+        .map(f => {
+            const stat = fs.statSync(path.join(backupDir, f));
+            return { name: f, size: stat.size, mtime: stat.mtime };
+        })
+        .sort((a, b) => b.mtime - a.mtime);
+}
+
+// ── run ───────────────────────────────────────────────────────────────────────
+function run(args) {
+    const found = findGrimoireDir();
+    if (!found) {
+        console.error('❌ .grimoire/ not found. Run: npx grimoire-framework install');
+        return;
+    }
+    const { dir: grimoireDir } = found;
+    const backupDir = getBackupDir(grimoireDir);
+
+    if (args.includes('--list')) {
+        const backups = listBackups(backupDir);
+        console.log(`\n💾 Backups (${backups.length}):\n`);
+        if (backups.length === 0) {
+            console.log('  (nenhum backup encontrado)');
+            console.log('  grimoire backup    ← criar agora\n');
+        } else {
+            backups.forEach(b => {
+                const kb = (b.size / 1024).toFixed(1);
+                const d = b.mtime.toLocaleDateString('pt-BR');
+                console.log(`  📦 ${b.name}  (${kb} KB · ${d})`);
+            });
+            console.log(`\n  grimoire backup --restore <arquivo>  ← restaurar\n`);
+        }
+        return;
+    }
+
+    const restoreIdx = args.indexOf('--restore');
+    if (restoreIdx !== -1) {
+        const file = args[restoreIdx + 1];
+        if (!file) {
+            console.log('Usage: grimoire backup --restore <arquivo.grimbak>\n');
+            return;
+        }
+        const absFile = path.isAbsolute(file) ? file : path.join(backupDir, file);
+        console.log(`\n⏳ Restaurando backup: ${path.basename(absFile)}...\n`);
+        try {
+            const { count, header } = restoreBackup(absFile, grimoireDir);
+            console.log(`✅ ${count} arquivos restaurados`);
+            console.log(`   Backup criado em: ${new Date(header.createdAt).toLocaleString('pt-BR')}\n`);
+        } catch (e) {
+            console.error(`❌ Erro ao restaurar: ${e.message}\n`);
+        }
+        return;
+    }
+
+    // Default: create backup
+    console.log('\n⏳ Criando backup de .grimoire/ ...\n');
+    try {
+        const { file, count, size } = createBackup(grimoireDir, backupDir);
+        const kb = (size / 1024).toFixed(1);
+        const rel = path.relative(process.cwd(), file);
+        console.log(`✅ Backup criado: ${rel}`);
+        console.log(`   ${count} arquivos · ${kb} KB\n`);
+        console.log(`💡 Para restaurar: grimoire backup --restore ${path.basename(file)}`);
+        console.log(`   Para listar:    grimoire backup --list\n`);
+    } catch (e) {
+        console.error(`❌ Erro ao criar backup: ${e.message}\n`);
+    }
+}
+
+module.exports = { run };