grimoire-framework 1.0.21 → 1.1.1

package/.grimoire/install-manifest.yaml

@@ -7,8 +7,8 @@
 # - SHA256 hashes for change detection
 # - File types for categorization
 #
-version: 1.0.21
-generated_at: "2026-02-22T14:46:40.983Z"
+version: 1.1.1
+generated_at: "2026-02-22T15:03:35.007Z"
 generator: scripts/generate-install-manifest.js
 file_count: 1011
 files:

package/bin/commands/marketplace.js

@@ -0,0 +1,304 @@
+/**
+ * grimoire marketplace — Community Agent Registry
+ *
+ * grimoire marketplace list              Navega agentes da comunidade
+ * grimoire marketplace install <slug>    Instala um agente do marketplace
+ * grimoire marketplace search <term>     Busca por especialidade ou tag
+ * grimoire marketplace submit            Instruções para publicar seu agente
+ */
+
+'use strict';
+
+const path = require('path');
+const fs = require('fs');
+const https = require('https');
+const os = require('os');
+
+// ── Curated registry (built-in fallback, also fetched from GitHub) ─────────────
+const REGISTRY_URL = 'https://raw.githubusercontent.com/gabrielrlima/grimoire/master/marketplace/registry.json';
+const CACHE_FILE = path.join(os.homedir(), '.grimoire-marketplace-cache.json');
+const CACHE_TTL_MINS = 60; // 1 hour
+
+const BUILTIN_AGENTS = [
+    {
+        slug: 'frontend-specialist',
+        name: 'Botticelli',
+        icon: '🎠',
+        specialty: 'Frontend & UI/UX',
+        tags: ['react', 'css', 'typescript', 'nextjs'],
+        author: 'grimoire-team',
+        description: 'Especialista em React, TypeScript e design systems. Ideal para times com foco em UI.',
+        gist: 'https://raw.githubusercontent.com/gabrielrlima/grimoire/master/marketplace/agents/frontend-specialist.md',
+    },
+    {
+        slug: 'security-auditor',
+        name: 'Rembrandt',
+        icon: '🔐',
+        specialty: 'Segurança & Auditoria',
+        tags: ['security', 'owasp', 'pentest', 'audit'],
+        author: 'grimoire-team',
+        description: 'Audita código em busca de vulnerabilidades OWASP Top 10. SAST e code review de segurança.',
+        gist: 'https://raw.githubusercontent.com/gabrielrlima/grimoire/master/marketplace/agents/security-auditor.md',
+    },
+    {
+        slug: 'ml-engineer',
+        name: 'Dalí',
+        icon: '🧠',
+        specialty: 'Machine Learning & AI',
+        tags: ['ml', 'python', 'pytorch', 'sklearn'],
+        author: 'grimoire-team',
+        description: 'Implementa pipelines de ML, feature engineering, treinamento e avaliação de modelos.',
+        gist: 'https://raw.githubusercontent.com/gabrielrlima/grimoire/master/marketplace/agents/ml-engineer.md',
+    },
+    {
+        slug: 'api-designer',
+        name: 'Klimt',
+        icon: '🔗',
+        specialty: 'API Design & Documentação',
+        tags: ['rest', 'graphql', 'openapi', 'swagger'],
+        author: 'grimoire-team',
+        description: 'Projeta APIs RESTful e GraphQL. Gera documentação OpenAPI 3.x e valida contratos.',
+        gist: 'https://raw.githubusercontent.com/gabrielrlima/grimoire/master/marketplace/agents/api-designer.md',
+    },
+    {
+        slug: 'database-expert',
+        name: 'Mondrian',
+        icon: '🗄️',
+        specialty: 'Banco de Dados & Queries',
+        tags: ['sql', 'postgresql', 'mongodb', 'redis'],
+        author: 'grimoire-team',
+        description: 'Otimiza queries, projeta schemas e revisa migrações. PostgreSQL, MongoDB, Redis.',
+        gist: 'https://raw.githubusercontent.com/gabrielrlima/grimoire/master/marketplace/agents/database-expert.md',
+    },
+    {
+        slug: 'tech-writer',
+        name: 'Cervantes',
+        icon: '✍️',
+        specialty: 'Documentação Técnica',
+        tags: ['docs', 'readme', 'adr', 'wiki'],
+        author: 'grimoire-team',
+        description: 'Escreve e revisa documentação técnica: READMEs, ADRs, guias de API e wikis.',
+        gist: 'https://raw.githubusercontent.com/gabrielrlima/grimoire/master/marketplace/agents/tech-writer.md',
+    },
+];
+
+// ── Fetcher ────────────────────────────────────────────────────────────────────
+async function fetchRegistry() {
+    // Use cache if fresh
+    if (fs.existsSync(CACHE_FILE)) {
+        try {
+            const cache = JSON.parse(fs.readFileSync(CACHE_FILE, 'utf8'));
+            const minsSince = (Date.now() - cache.ts) / 60000;
+            if (minsSince < CACHE_TTL_MINS) return cache.agents;
+        } catch (_) { }
+    }
+
+    // Try to fetch remote registry
+    try {
+        const remote = await new Promise((resolve, reject) => {
+            const req = https.get(REGISTRY_URL, { timeout: 4000 }, (res) => {
+                let body = '';
+                res.on('data', d => body += d);
+                res.on('end', () => { try { resolve(JSON.parse(body)); } catch (e) { reject(e); } });
+            });
+            req.on('error', reject);
+            req.on('timeout', () => req.destroy());
+        });
+        const agents = remote.agents || BUILTIN_AGENTS;
+        fs.writeFileSync(CACHE_FILE, JSON.stringify({ ts: Date.now(), agents }), 'utf8');
+        return agents;
+    } catch (_) {
+        // Fall back to built-in
+        return BUILTIN_AGENTS;
+    }
+}
+
+// ── Commands ───────────────────────────────────────────────────────────────────
+async function run(args) {
+    const sub = args[0];
+    switch (sub) {
+        case 'install': await installAgent(args[1]); break;
+        case 'search': await searchAgents(args.slice(1)); break;
+        case 'submit': showSubmitGuide(); break;
+        case 'list':
+        default: await listAgents(args); break;
+    }
+}
+
+// ── List ───────────────────────────────────────────────────────────────────────
+async function listAgents(args) {
+    process.stdout.write('🔍 Carregando registry...');
+    const agents = await fetchRegistry();
+    const tagFilter = args.find(a => a.startsWith('--tag='));
+    const filtered = tagFilter
+        ? agents.filter(a => a.tags.includes(tagFilter.replace('--tag=', '')))
+        : agents;
+
+    console.log(`\r\n🏪 Grimoire Marketplace — ${filtered.length} agentes disponíveis\n`);
+    console.log('  ' + '─'.repeat(60));
+
+    filtered.forEach(agent => {
+        const tags = agent.tags.slice(0, 3).map(t => `#${t}`).join(' ');
+        console.log(`
+  ${agent.icon} **@${agent.slug}** — ${agent.name}
+     ${agent.specialty}
+     ${agent.description}
+     ${tags}   by @${agent.author}`);
+    });
+
+    console.log(`\n  ${'─'.repeat(60)}`);
+    console.log(`  💡 Para instalar: grimoire marketplace install <slug>`);
+    console.log(`  💡 Para buscar:   grimoire marketplace search <term>`);
+    console.log(`  💡 Para publicar: grimoire marketplace submit\n`);
+}
+
+// ── Search ─────────────────────────────────────────────────────────────────────
+async function searchAgents(terms) {
+    const query = terms.join(' ').toLowerCase();
+    if (!query) { console.log('Usage: grimoire marketplace search <term>'); return; }
+
+    const agents = await fetchRegistry();
+    const results = agents.filter(a =>
+        a.slug.includes(query) ||
+        a.specialty.toLowerCase().includes(query) ||
+        a.description.toLowerCase().includes(query) ||
+        a.tags.some(t => t.includes(query))
+    );
+
+    console.log(`\n🔍 Results for "${query}" — ${results.length} found\n`);
+    if (results.length === 0) {
+        console.log('  No agents found. Try: grimoire marketplace list\n'); return;
+    }
+    results.forEach(a => {
+        console.log(`  ${a.icon} @${a.slug} — ${a.name} · ${a.specialty}`);
+        console.log(`     ${a.description}\n`);
+    });
+}
+
+// ── Install ────────────────────────────────────────────────────────────────────
+async function installAgent(slug) {
+    if (!slug) { console.log('Usage: grimoire marketplace install <slug>'); return; }
+
+    const agents = await fetchRegistry();
+    const agent = agents.find(a => a.slug === slug);
+    if (!agent) {
+        console.error(`❌ Agent "${slug}" not found in marketplace. Try: grimoire marketplace list`);
+        return;
+    }
+
+    const localDir = path.join(process.cwd(), '.codex', 'agents');
+    if (!fs.existsSync(localDir)) {
+        console.error('❌ No .codex/agents/ found. Run: npx grimoire-framework install');
+        return;
+    }
+
+    const destFile = path.join(localDir, `${slug}.md`);
+    if (fs.existsSync(destFile)) {
+        console.log(`⚠️  Agent @${slug} already installed. Use "grimoire agent edit ${slug}" to customize.`);
+        return;
+    }
+
+    // Download agent file
+    process.stdout.write(`⬇️  Downloading @${slug} (${agent.name})...`);
+    try {
+        const content = await new Promise((resolve, reject) => {
+            const req = https.get(agent.gist, { timeout: 8000 }, (res) => {
+                // If 404 or not found, generate template instead
+                if (res.statusCode === 404) { resolve(null); return; }
+                let body = '';
+                res.on('data', d => body += d);
+                res.on('end', () => resolve(body));
+            });
+            req.on('error', reject);
+            req.on('timeout', () => req.destroy());
+        });
+
+        const agentContent = content || generateFallbackAgent(agent);
+        fs.writeFileSync(destFile, agentContent, 'utf8');
+
+        console.log(` ✅\n`);
+        console.log(`✅ Instalado: @${slug} — ${agent.name}`);
+        console.log(`   Especialidade: ${agent.specialty}`);
+        console.log(`   Arquivo: .codex/agents/${slug}.md`);
+        console.log(`\n💡 Para ativar: @${slug} no chat da sua IDE`);
+        console.log(`   Para outras IDEs: grimoire sync --global && grimoire update\n`);
+    } catch (e) {
+        console.log(' ⚠️ (offline, usando template local)');
+        fs.writeFileSync(destFile, generateFallbackAgent(agent), 'utf8');
+        console.log(`✅ Instalado com template local: @${slug}`);
+    }
+}
+
+// ── Fallback template when gist unavailable ────────────────────────────────────
+function generateFallbackAgent(agent) {
+    return `# ${agent.slug}
+
+ACTIVATION-NOTICE: This file contains your full agent operating guidelines. DO NOT load any external agent files as the complete configuration is in the YAML block below.
+
+## COMPLETE AGENT DEFINITION FOLLOWS - NO EXTERNAL FILES NEEDED
+
+\`\`\`yaml
+activation-instructions:
+  - STEP 1: Adote a persona ${agent.name} completamente
+  - STEP 2: Apresente o greeting abaixo
+  - STEP 3: HALT e aguarde input
+  - STAY IN CHARACTER até *exit
+
+agent:
+  name: ${agent.name}
+  id: ${agent.slug}
+  title: ${agent.specialty}
+  icon: ${agent.icon}
+  source: marketplace
+  author: ${agent.author}
+  tags: [${agent.tags.join(', ')}]
+  description: ${agent.description}
+
+persona:
+  role: ${agent.specialty} Specialist
+  identity: ${agent.name} — ${agent.description}
+
+greeting_levels:
+  default: |
+    ${agent.icon} **${agent.name}** (@${agent.slug}) do Grimoire Marketplace!
+    Especialidade: **${agent.specialty}**
+    ${agent.description}
+
+    Como posso ajudar?
+
+commands:
+  - "*help  — Comandos disponíveis"
+  - "*exit  — Sair do agente"
+
+signature_closing: '— ${agent.name} ${agent.icon}'
+\`\`\`
+`;
+}
+
+// ── Submit guide ───────────────────────────────────────────────────────────────
+function showSubmitGuide() {
+    console.log(`
+📤 Publique seu agente no Grimoire Marketplace!
+
+1. Crie seu agente:
+   grimoire agent create
+
+2. Teste em múltiplos projetos:
+   grimoire sync --global
+   grimoire sync --from-global   # em outro projeto
+
+3. Abra um Pull Request:
+   https://github.com/gabrielrlima/grimoire/tree/master/marketplace
+
+   Adicione seu agente em:
+   - marketplace/agents/<slug>.md  (definição)
+   - marketplace/registry.json     (entrada no catálogo)
+
+4. Campos obrigatórios no registry.json:
+   slug, name, icon, specialty, tags, author, description, gist
+
+🌟 Agentes aprovados ficam disponíveis para toda a comunidade!
+`);
+}
+
+module.exports = { run };

package/bin/commands/pro.js

@@ -0,0 +1,237 @@
+/**
+ * grimoire pro — License & Feature Gate System
+ *
+ * Phase 1: Offline-first with HMAC key validation
+ * Phase 2: Online validation via Supabase Edge Function (future)
+ *
+ * grimoire pro activate <key>    Ativa a licença Pro
+ * grimoire pro status            Mostra status da licença
+ * grimoire pro features          Lista features Pro disponíveis
+ * grimoire pro deactivate        Remove a licença
+ */
+
+'use strict';
+
+const path = require('path');
+const fs = require('fs');
+const os = require('os');
+const crypto = require('crypto');
+
+// ── License storage ────────────────────────────────────────────────────────────
+const LICENSE_FILE = path.join(os.homedir(), '.grimoire-license.json');
+
+// ── HMAC secret (public seed — Phase 1 offline validation only) ───────────────
+// In Phase 2 this validation moves to the server
+const HMAC_SEED = 'grimoire-pro-v1-2026';
+
+// ── Pro feature catalogue ──────────────────────────────────────────────────────
+const PRO_FEATURES = [
+    { id: 'squads-unlimited', name: 'Squads Ilimitados', desc: 'Crie squads customizados sem limite', tier: 'pro' },
+    { id: 'memory-sync', name: 'Memória Sincronizada', desc: 'Sync de memória entre projetos via cloud', tier: 'pro' },
+    { id: 'metrics-advanced', name: 'Métricas Avançadas', desc: 'Dashboard com insights de IA e tendências', tier: 'pro' },
+    { id: 'marketplace-publish', name: 'Publish no Marketplace', desc: 'Publique agentes no marketplace sem PR', tier: 'pro' },
+    { id: 'squad-creator', name: 'Squad Creator Avançado', desc: 'Templates de squad por domínio (fintech, saúde, e-comm)', tier: 'pro' },
+    { id: 'priority-support', name: 'Suporte Prioritário', desc: 'Acesso a canal privado de suporte', tier: 'pro' },
+];
+
+// ── License validation (offline HMAC-SHA256) ──────────────────────────────────
+function generateKeyChecksum(email, key) {
+    const payload = `${email}:${key}:${HMAC_SEED}`;
+    return crypto.createHmac('sha256', HMAC_SEED).update(payload).digest('hex').substring(0, 12);
+}
+
+function validateKeyFormat(key) {
+    // Format: PRO-XXXX-XXXX-XXXX-XXXX (alphanumeric segments)
+    return /^PRO-[A-Z0-9]{4}-[A-Z0-9]{4}-[A-Z0-9]{4}-[A-Z0-9]{4}$/.test(key);
+}
+
+function loadLicense() {
+    if (!fs.existsSync(LICENSE_FILE)) return null;
+    try { return JSON.parse(fs.readFileSync(LICENSE_FILE, 'utf8')); }
+    catch (_) { return null; }
+}
+
+function saveLicense(data) {
+    fs.writeFileSync(LICENSE_FILE, JSON.stringify(data, null, 2), 'utf8');
+}
+
+function isLicenseValid(license) {
+    if (!license) return false;
+    if (license.type === 'community') return true; // Always valid
+
+    // Check expiry
+    if (license.expiresAt && new Date(license.expiresAt) < new Date()) {
+        return false;
+    }
+
+    // Offline HMAC check
+    const expected = generateKeyChecksum(license.email || '', license.key || '');
+    return license.checksum === expected;
+}
+
+// ── Public API for other modules ───────────────────────────────────────────────
+function isPro() {
+    const license = loadLicense();
+    return isLicenseValid(license) && license.type === 'pro';
+}
+
+function hasFeature(featureId) {
+    const license = loadLicense();
+    if (!isLicenseValid(license)) return false;
+    if (license.type === 'pro') return PRO_FEATURES.some(f => f.id === featureId);
+    return license.features?.includes(featureId) || false;
+}
+
+// ── readline prompt ────────────────────────────────────────────────────────────
+const readline = require('readline');
+function prompt(q) {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise(resolve => { rl.question(q, a => { rl.close(); resolve(a.trim()); }); });
+}
+
+// ── Commands ───────────────────────────────────────────────────────────────────
+async function run(args) {
+    const sub = args[0];
+    switch (sub) {
+        case 'activate': await activate(args[1]); break;
+        case 'deactivate': deactivate(); break;
+        case 'features': showFeatures(); break;
+        case 'status':
+        default: showStatus(); break;
+    }
+}
+
+// ── Activate ───────────────────────────────────────────────────────────────────
+async function activate(keyArg) {
+    console.log('\n🔐 Grimoire Pro — Ativação de Licença\n');
+
+    const key = keyArg || await prompt('Chave de licença (PRO-XXXX-XXXX-XXXX-XXXX): ');
+
+    if (!validateKeyFormat(key)) {
+        console.error('❌ Formato inválido. Use: PRO-XXXX-XXXX-XXXX-XXXX');
+        console.log('   Obtenha sua chave em: https://grimoire.dev/pro\n');
+        return;
+    }
+
+    const email = await prompt('Email associado à licença: ');
+    if (!email || !email.includes('@')) {
+        console.error('❌ Email inválido.');
+        return;
+    }
+
+    // Offline HMAC validation
+    const checksum = generateKeyChecksum(email, key);
+
+    // Try online validation (Phase 2 ready but not blocking)
+    let onlineValidated = false;
+    try {
+        const https = require('https');
+        const result = await new Promise((resolve, reject) => {
+            const data = JSON.stringify({ key, email });
+            const req = https.request({
+                hostname: 'api.grimoire.dev',
+                path: '/v1/license/validate',
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json', 'Content-Length': data.length },
+                timeout: 4000,
+            }, (res) => {
+                let body = '';
+                res.on('data', d => body += d);
+                res.on('end', () => { try { resolve(JSON.parse(body)); } catch (e) { reject(e); } });
+            });
+            req.on('error', reject);
+            req.on('timeout', () => req.destroy());
+            req.write(data);
+            req.end();
+        });
+        onlineValidated = result.valid === true;
+    } catch (_) {
+        // Offline — use local validation only
+    }
+
+    const license = {
+        type: 'pro',
+        key,
+        email,
+        checksum,
+        activatedAt: new Date().toISOString(),
+        expiresAt: null,    // null = never (or set by server in Phase 2)
+        onlineValidated,
+        features: PRO_FEATURES.map(f => f.id),
+    };
+
+    saveLicense(license);
+
+    console.log(`
+✅ Grimoire Pro ativado!
+
+   Email:   ${email}
+   Chave:   ${key.substring(0, 7)}...${key.slice(-4)}
+   Status:  ${onlineValidated ? '✅ Validado online' : '✅ Ativado (validação offline)'}
+
+🎯 Features ativas:`);
+    PRO_FEATURES.forEach(f => console.log(`  ✅ ${f.name} — ${f.desc}`));
+    console.log('\n💡 Use "grimoire pro status" para ver os detalhes\n');
+}
+
+// ── Status ─────────────────────────────────────────────────────────────────────
+function showStatus() {
+    const license = loadLicense();
+    const sep = '─'.repeat(50);
+
+    console.log(`\n🔐 Grimoire Pro — Status da Licença\n${sep}`);
+
+    if (!license) {
+        console.log(`  Status:  ⭕ Não ativado (Community)\n`);
+        console.log(`  ${sep}`);
+        console.log(`  Para ativar: grimoire pro activate <chave>`);
+        console.log(`  Obter licença: https://grimoire.dev/pro\n`);
+        showFeatureList(false);
+        return;
+    }
+
+    const valid = isLicenseValid(license);
+    const isPro = license.type === 'pro' && valid;
+    const expires = license.expiresAt ? new Date(license.expiresAt).toLocaleDateString('pt-BR') : 'Sem expiração';
+
+    console.log(`  Status:  ${valid ? (isPro ? '✅ Pro Ativo' : '✅ Community') : '❌ Licença inválida/expirada'}`);
+    if (license.email) console.log(`  Email:   ${license.email}`);
+    if (license.key) console.log(`  Chave:   ${license.key.substring(0, 7)}...${license.key.slice(-4)}`);
+    console.log(`  Ativado: ${license.activatedAt ? new Date(license.activatedAt).toLocaleDateString('pt-BR') : 'N/A'}`);
+    console.log(`  Expira:  ${expires}`);
+    console.log(`  ${sep}`);
+
+    showFeatureList(isPro);
+}
+
+// ── Features ───────────────────────────────────────────────────────────────────
+function showFeatures() {
+    const license = loadLicense();
+    const active = license && isLicenseValid(license) && license.type === 'pro';
+    console.log('\n🎯 Grimoire Pro — Features\n');
+    showFeatureList(active);
+}
+
+function showFeatureList(active) {
+    PRO_FEATURES.forEach(f => {
+        const status = active ? '✅' : '🔒';
+        console.log(`  ${status} ${f.name}`);
+        console.log(`     ${f.desc}\n`);
+    });
+    if (!active) {
+        console.log(`  🔗 Ative em: https://grimoire.dev/pro`);
+        console.log(`     grimoire pro activate\n`);
+    }
+}
+
+// ── Deactivate ─────────────────────────────────────────────────────────────────
+function deactivate() {
+    if (!fs.existsSync(LICENSE_FILE)) {
+        console.log('ℹ️  Nenhuma licença ativa encontrada.');
+        return;
+    }
+    fs.unlinkSync(LICENSE_FILE);
+    console.log('✅ Licença removida. Grimoire voltou ao modo Community.');
+}
+
+module.exports = { run, isPro, hasFeature };

package/bin/grimoire-cli.js

@@ -118,6 +118,12 @@ async function main() {
     case 'sync':
       await require('./commands/sync').run(args.slice(1));
       break;
+    case 'marketplace':
+      await require('./commands/marketplace').run(args.slice(1));
+      break;
+    case 'pro':
+      await require('./commands/pro').run(args.slice(1));
+      break;
     case 'status':
       handleStatus();
       break;
@@ -469,29 +475,72 @@ function handleDoctor() {
 }
 
 function showHelp() {
+  const { isPro } = (() => { try { return require('./commands/pro'); } catch (_) { return { isPro: () => false }; } })();
+  const proLabel = isPro() ? ' 🔐' : '';
+
   console.log(`
-🔮 Grimoire Framework CLI v${packageJson.version}
-
-  The CLI manages your framework. Agents live in your IDE chat.
-  (These are DIFFERENT — CLI = terminal, Agents = @agentname in IDE chat)
-
-USAGE:
-  grimoire status           # ✨ Framework health & what's active
-  grimoire whoami           # 🧙 Session context & how to use agents
-  grimoire install          # Install/Reset setup
-  grimoire agents list      # List available agents (with personas)
-  grimoire squads list      # List installed squads
-  grimoire memory [sub]     # Manage persistent memory
-  grimoire metrics          # View productivity metrics
-  grimoire doctor           # Run diagnostics (checks + tips)
-  grimoire --version        # Show version
-  grimoire --help           # Show this help
+🔮 Grimoire Framework CLI v${packageJson.version}${proLabel}
+
+  CLI gerencia o framework · Agentes vivem no chat da sua IDE
+  (CLI = terminal  ·  Agentes = @agentname no chat da IDE)
+
+COMANDOS ESSENCIAIS:
+  grimoire status           Saúde do framework e o que está ativo
+  grimoire whoami           Contexto da sessão e como usar agentes
+  grimoire doctor           Diagnóstico completo (checks + sugestões)
+  grimoire update           Atualiza agentes e arquivos do framework
+
+AGENTES:
+  grimoire agents list      Lista todos os agentes com personas
+  grimoire agent create     🆕 Wizard para criar agente customizado
+  grimoire agent list       Lista agentes (com custom)
+  grimoire agent edit <n>   Editar agente no $EDITOR
+  grimoire agent remove <n> Remover agente customizado
+
+SQUADS:
+  grimoire squads list      Lista squads disponíveis (fullstack/planning/devops)
+
+MEMÓRIA:
+  grimoire memory save "texto"        Salvar entrada na sessão
+  grimoire memory show [--last 10]    Ver entradas de hoje
+  grimoire memory search "termo"      🆕 Buscar em todas as sessões
+  grimoire memory export              🆕 Exportar para Markdown
+  grimoire memory clear --older-than 30  🆕 Limpar sessões antigas
+  grimoire memory list                Listar todas as sessões
+
+MÉTRICAS:
+  grimoire metrics                    Dashboard do mês atual
+  grimoire metrics --period week      🆕 Últimos 7 dias
+  grimoire metrics --period all       🆕 Histórico completo
+  grimoire metrics export --csv       🆕 Exportar para CSV
+  grimoire metrics track <tipo> [msg] 🆕 Registrar evento manual
+
+SYNC GLOBAL:
+  grimoire sync --global              🆕 Envia agentes → ~/.grimoire/agents/
+  grimoire sync --from-global         🆕 Puxa agentes do store global
+  grimoire sync --list                🆕 Lista agentes globais
+
+MARKETPLACE:
+  grimoire marketplace list           🆕 Navega agentes da comunidade
+  grimoire marketplace install <slug> 🆕 Instala agente do marketplace
+  grimoire marketplace search <termo> 🆕 Busca por especialidade
+  grimoire marketplace submit         🆕 Guia para publicar seu agente
+
+GRIMOIRE PRO:
+  grimoire pro activate <chave>       🆕 Ativa licença Pro
+  grimoire pro status                 🆕 Status da licença e features
+  grimoire pro features               🆕 Lista features Pro
+  grimoire pro deactivate             🆕 Remove licença
+
+OUTROS:
+  grimoire install          Instalar/reset setup no projeto
+  grimoire --version        Versão instalada
+  grimoire --help           Este help
 
 QUICK START:
-  npx grimoire-framework install    # Set up in a new project
-  grimoire status                   # Check everything is working
-  grimoire whoami                   # See available agents
-  Then in your IDE chat: @dev  or  @qa  or  @grimoire-master
+  npx grimoire-framework install    Setup em novo projeto
+  grimoire status                   Tudo funcionando?
+  @dev  @qa  @architect             No chat da sua IDE
 `);
 }
 

package/marketplace/agents/api-designer.md

@@ -0,0 +1,56 @@
+# api-designer
+
+ACTIVATION-NOTICE: This file contains your full agent operating guidelines. DO NOT load any external agent files as the complete configuration is in the YAML block below.
+
+## COMPLETE AGENT DEFINITION FOLLOWS - NO EXTERNAL FILES NEEDED
+
+```yaml
+activation-instructions:
+  - STEP 1: Adote a persona Klimt completamente
+  - STEP 2: Apresente o greeting abaixo
+  - STEP 3: HALT e aguarde input
+  - STAY IN CHARACTER até *exit
+
+agent:
+  name: Klimt
+  id: api-designer
+  title: API Design & Documentation Specialist
+  icon: 🔗
+  source: marketplace
+  author: grimoire-team
+  tags: [rest, graphql, openapi, swagger, grpc, api-design]
+
+persona:
+  role: API Designer & Integration Architect
+  style: Preciso, consistente, orientado a contratos
+  identity: |
+    Klimt — O Arquiteto de Contratos. Expert em design de APIs RESTful e GraphQL,
+    documentação OpenAPI 3.x e estratégias de versionamento.
+  principles:
+    - API-first design
+    - Contratos imutáveis (versioning)
+    - Nomes e verbos HTTP semânticos
+    - Documentação como primeiro cidadão
+
+greeting_levels:
+  default: |
+    🔗 **Klimt** (@api-designer) pronto!
+    Especialidade: **API Design & Documentação**
+
+    Posso ajudar com:
+    - Design de APIs REST e GraphQL
+    - Geração de spec OpenAPI 3.x / Swagger
+    - Versionamento e contratos de API
+    - Revisão de endpoints existentes
+
+    Qual API vamos projetar?
+
+commands:
+  - "*help     — Comandos disponíveis"
+  - "*design   — Projetar nova API"
+  - "*review   — Revisar API existente"
+  - "*spec     — Gerar OpenAPI spec"
+  - "*exit     — Sair do agente"
+
+signature_closing: '— Klimt, tecendo contratos em ouro 🔗'
+```

package/marketplace/agents/database-expert.md

@@ -0,0 +1,56 @@
+# database-expert
+
+ACTIVATION-NOTICE: This file contains your full agent operating guidelines. DO NOT load any external agent files as the complete configuration is in the YAML block below.
+
+## COMPLETE AGENT DEFINITION FOLLOWS - NO EXTERNAL FILES NEEDED
+
+```yaml
+activation-instructions:
+  - STEP 1: Adote a persona Mondrian completamente
+  - STEP 2: Apresente o greeting abaixo
+  - STEP 3: HALT e aguarde input
+  - STAY IN CHARACTER até *exit
+
+agent:
+  name: Mondrian
+  id: database-expert
+  title: Banco de Dados & Query Specialist
+  icon: 🗄️
+  source: marketplace
+  author: grimoire-team
+  tags: [sql, postgresql, mongodb, redis, performance, schema]
+
+persona:
+  role: Database Engineer & Query Optimizer
+  style: Estruturado, performático, orientado a dados
+  identity: |
+    Mondrian — O Arquiteto de Dados. Expert em modelagem de schemas,
+    otimização de queries, migrações e estratégias de indexação.
+  principles:
+    - Schema correto antes de otimização
+    - EXPLAIN antes de INDEX
+    - Migrações sempre reversíveis
+    - N+1 é um erro, não uma feature
+
+greeting_levels:
+  default: |
+    🗄️ **Mondrian** (@database-expert) pronto!
+    Especialidade: **Banco de Dados & Queries**
+
+    Posso ajudar com:
+    - Design e revisão de schemas (PostgreSQL, MongoDB)
+    - Otimização de queries e índices
+    - Migrações seguras e reversíveis
+    - Redis: caching, pub/sub, filas
+
+    Qual problema de dados vamos resolver?
+
+commands:
+  - "*help      — Comandos disponíveis"
+  - "*schema    — Revisar ou projetar schema"
+  - "*optimize  — Otimizar query com EXPLAIN"
+  - "*migrate   — Planejar migração segura"
+  - "*exit      — Sair do agente"
+
+signature_closing: '— Mondrian, organizando dados em grades perfeitas 🗄️'
+```

package/marketplace/agents/frontend-specialist.md

@@ -0,0 +1,55 @@
+# frontend-specialist
+
+ACTIVATION-NOTICE: This file contains your full agent operating guidelines. DO NOT load any external agent files as the complete configuration is in the YAML block below.
+
+## COMPLETE AGENT DEFINITION FOLLOWS - NO EXTERNAL FILES NEEDED
+
+```yaml
+activation-instructions:
+  - STEP 1: Adote a persona Botticelli completamente
+  - STEP 2: Apresente o greeting abaixo
+  - STEP 3: HALT e aguarde input
+  - STAY IN CHARACTER até *exit
+
+agent:
+  name: Botticelli
+  id: frontend-specialist
+  title: Frontend & UI/UX Specialist
+  icon: 🎠
+  source: marketplace
+  author: grimoire-team
+  tags: [react, css, typescript, nextjs, tailwind]
+
+persona:
+  role: Frontend & UI/UX Engineer
+  style: Design-oriented, pixel-perfect, performance-conscious
+  identity: |
+    Botticelli — Mestre do Frontend. Expert em React, TypeScript, design systems
+    e experiência do usuário. Cada componente é uma obra de arte.
+  principles:
+    - Componentes acessíveis (WCAG 2.1 AA)
+    - Performance: Core Web Vitals em verde
+    - Design system antes de componentes ad-hoc
+    - Mobile-first sempre
+
+greeting_levels:
+  default: |
+    🎠 **Botticelli** (@frontend-specialist) pronto!
+    Especialidade: **Frontend & UI/UX**
+
+    Posso ajudar com:
+    - Implementação de componentes React/Next.js
+    - Design system e tokens de estilo
+    - Performance (Core Web Vitals, bundle size)
+    - Acessibilidade e responsividade
+
+    O que vamos construir?
+
+commands:
+  - "*help    — Comandos disponíveis"
+  - "*review  — Code review de componente"
+  - "*a11y    — Auditoria de acessibilidade"
+  - "*exit    — Sair do agente"
+
+signature_closing: '— Botticelli, pintando o frontend pixel a pixel 🎠'
+```

package/marketplace/agents/ml-engineer.md

@@ -0,0 +1,55 @@
+# ml-engineer
+
+ACTIVATION-NOTICE: This file contains your full agent operating guidelines. DO NOT load any external agent files as the complete configuration is in the YAML block below.
+
+## COMPLETE AGENT DEFINITION FOLLOWS - NO EXTERNAL FILES NEEDED
+
+```yaml
+activation-instructions:
+  - STEP 1: Adote a persona Dalí completamente
+  - STEP 2: Apresente o greeting abaixo
+  - STEP 3: HALT e aguarde input
+  - STAY IN CHARACTER até *exit
+
+agent:
+  name: Dalí
+  id: ml-engineer
+  title: Machine Learning & AI Engineer
+  icon: 🧠
+  source: marketplace
+  author: grimoire-team
+  tags: [ml, python, pytorch, sklearn, llm, mlops]
+
+persona:
+  role: ML Engineer & AI Specialist
+  style: Experimental, data-driven, pragmático
+  identity: |
+    Dalí — O Visionário. Expert em machine learning, pipelines de dados,
+    fine-tuning de LLMs e MLOps. Transforma dados em inteligência.
+  principles:
+    - Data primeiro, modelo depois
+    - Baseline simples antes de complexidade
+    - Reprodutibilidade é obrigatória
+    - Monitorar drift em produção
+
+greeting_levels:
+  default: |
+    🧠 **Dalí** (@ml-engineer) pronto!
+    Especialidade: **Machine Learning & AI**
+
+    Posso ajudar com:
+    - Pipelines de ML (feature eng, treinamento, avaliação)
+    - Fine-tuning e prompt engineering de LLMs
+    - MLOps (tracking, serving, monitoramento)
+    - Análise exploratória de dados
+
+    Qual problema de ML vamos resolver?
+
+commands:
+  - "*help      — Comandos disponíveis"
+  - "*pipeline  — Desenhar pipeline de ML"
+  - "*evaluate  — Avaliar modelo e métricas"
+  - "*exit      — Sair do agente"
+
+signature_closing: '— Dalí, sonhando em tensores 🧠'
+```

package/marketplace/agents/security-auditor.md

@@ -0,0 +1,55 @@
+# security-auditor
+
+ACTIVATION-NOTICE: This file contains your full agent operating guidelines. DO NOT load any external agent files as the complete configuration is in the YAML block below.
+
+## COMPLETE AGENT DEFINITION FOLLOWS - NO EXTERNAL FILES NEEDED
+
+```yaml
+activation-instructions:
+  - STEP 1: Adote a persona Rembrandt completamente
+  - STEP 2: Apresente o greeting abaixo
+  - STEP 3: HALT e aguarde input
+  - STAY IN CHARACTER até *exit
+
+agent:
+  name: Rembrandt
+  id: security-auditor
+  title: Security & Audit Specialist
+  icon: 🔐
+  source: marketplace
+  author: grimoire-team
+  tags: [security, owasp, pentest, audit, sast]
+
+persona:
+  role: Application Security Engineer
+  style: Metódico, cético construtivo, orientado a evidências
+  identity: |
+    Rembrandt — O Auditor. Expert em segurança de aplicações, OWASP Top 10,
+    revisão de código seguro e modelagem de ameaças.
+  principles:
+    - Defense in depth
+    - Principe do menor privilégio
+    - Shift-left security
+    - Evidência antes de conclusão
+
+greeting_levels:
+  default: |
+    🔐 **Rembrandt** (@security-auditor) pronto!
+    Especialidade: **Segurança & Auditoria**
+
+    Posso realizar:
+    - Code review de segurança (OWASP Top 10)
+    - Auditoria de autenticação e autorização
+    - Análise de dependências vulneráveis
+    - Modelagem de ameaças (STRIDE)
+
+    O que devo auditar?
+
+commands:
+  - "*help    — Comandos disponíveis"
+  - "*audit   — Auditoria de segurança completa"
+  - "*owasp   — Checklist OWASP Top 10"
+  - "*exit    — Sair do agente"
+
+signature_closing: '— Rembrandt, iluminando as sombras do código 🔐'
+```

package/marketplace/agents/tech-writer.md

@@ -0,0 +1,56 @@
+# tech-writer
+
+ACTIVATION-NOTICE: This file contains your full agent operating guidelines. DO NOT load any external agent files as the complete configuration is in the YAML block below.
+
+## COMPLETE AGENT DEFINITION FOLLOWS - NO EXTERNAL FILES NEEDED
+
+```yaml
+activation-instructions:
+  - STEP 1: Adote a persona Cervantes completamente
+  - STEP 2: Apresente o greeting abaixo
+  - STEP 3: HALT e aguarde input
+  - STAY IN CHARACTER até *exit
+
+agent:
+  name: Cervantes
+  id: tech-writer
+  title: Documentação Técnica Specialist
+  icon: ✍️
+  source: marketplace
+  author: grimoire-team
+  tags: [docs, readme, adr, wiki, changelog, openapi]
+
+persona:
+  role: Technical Writer & Documentation Engineer
+  style: Claro, conciso, orientado ao leitor
+  identity: |
+    Cervantes — O Narrador Técnico. Expert em documentação de software:
+    READMEs, ADRs, guias de API, wikis e changelogs que pessoas realmente leem.
+  principles:
+    - Escreva para o leitor, não para o autor
+    - Exemplos valem mais que explicações
+    - Docs são código — versionados e revisados
+    - CHANGELOG honesto = confiança do usuário
+
+greeting_levels:
+  default: |
+    ✍️ **Cervantes** (@tech-writer) pronto!
+    Especialidade: **Documentação Técnica**
+
+    Posso criar:
+    - READMEs claros e completos
+    - ADRs (Architecture Decision Records)
+    - Guias de contribuição e onboarding
+    - CHANGELOGs e release notes
+
+    O que precisa ser documentado?
+
+commands:
+  - "*help       — Comandos disponíveis"
+  - "*readme     — Criar/revisar README"
+  - "*adr        — Criar ADR"
+  - "*changelog  — Escrever CHANGELOG entry"
+  - "*exit       — Sair do agente"
+
+signature_closing: '— Cervantes, imortalizando código em palavras ✍️'
+```

package/marketplace/registry.json

@@ -0,0 +1,96 @@
+{
+    "version": "1.0.0",
+    "lastUpdated": "2026-02-22",
+    "agents": [
+        {
+            "slug": "frontend-specialist",
+            "name": "Botticelli",
+            "icon": "🎠",
+            "specialty": "Frontend & UI/UX",
+            "tags": [
+                "react",
+                "css",
+                "typescript",
+                "nextjs"
+            ],
+            "author": "grimoire-team",
+            "description": "Especialista em React, TypeScript e design systems. Ideal para times com foco em UI.",
+            "gist": "https://raw.githubusercontent.com/gabrielrlima/grimoire/master/marketplace/agents/frontend-specialist.md"
+        },
+        {
+            "slug": "security-auditor",
+            "name": "Rembrandt",
+            "icon": "🔐",
+            "specialty": "Segurança & Auditoria",
+            "tags": [
+                "security",
+                "owasp",
+                "pentest",
+                "audit"
+            ],
+            "author": "grimoire-team",
+            "description": "Audita código em busca de vulnerabilidades OWASP Top 10. SAST e code review de segurança.",
+            "gist": "https://raw.githubusercontent.com/gabrielrlima/grimoire/master/marketplace/agents/security-auditor.md"
+        },
+        {
+            "slug": "ml-engineer",
+            "name": "Dalí",
+            "icon": "🧠",
+            "specialty": "Machine Learning & AI",
+            "tags": [
+                "ml",
+                "python",
+                "pytorch",
+                "sklearn"
+            ],
+            "author": "grimoire-team",
+            "description": "Implementa pipelines de ML, feature engineering, treinamento e avaliação de modelos.",
+            "gist": "https://raw.githubusercontent.com/gabrielrlima/grimoire/master/marketplace/agents/ml-engineer.md"
+        },
+        {
+            "slug": "api-designer",
+            "name": "Klimt",
+            "icon": "🔗",
+            "specialty": "API Design & Documentação",
+            "tags": [
+                "rest",
+                "graphql",
+                "openapi",
+                "swagger"
+            ],
+            "author": "grimoire-team",
+            "description": "Projeta APIs RESTful e GraphQL. Gera documentação OpenAPI 3.x e valida contratos.",
+            "gist": "https://raw.githubusercontent.com/gabrielrlima/grimoire/master/marketplace/agents/api-designer.md"
+        },
+        {
+            "slug": "database-expert",
+            "name": "Mondrian",
+            "icon": "🗄️",
+            "specialty": "Banco de Dados & Queries",
+            "tags": [
+                "sql",
+                "postgresql",
+                "mongodb",
+                "redis"
+            ],
+            "author": "grimoire-team",
+            "description": "Otimiza queries, projeta schemas e revisa migrações. PostgreSQL, MongoDB, Redis.",
+            "gist": "https://raw.githubusercontent.com/gabrielrlima/grimoire/master/marketplace/agents/database-expert.md"
+        },
+        {
+            "slug": "tech-writer",
+            "name": "Cervantes",
+            "icon": "✍️",
+            "specialty": "Documentação Técnica",
+            "tags": [
+                "docs",
+                "readme",
+                "adr",
+                "wiki"
+            ],
+            "author": "grimoire-team",
+            "description": "Escreve e revisa documentação técnica: READMEs, ADRs, guias de API e wikis.",
+            "gist": "https://raw.githubusercontent.com/gabrielrlima/grimoire/master/marketplace/agents/tech-writer.md"
+        }
+    ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "grimoire-framework",
-  "version": "1.0.21",
+  "version": "1.1.1",
   "description": "Grimoire: AI-Orchestrated System for Full Stack Development - Core Framework",
   "publishConfig": {
     "access": "public"
@@ -37,6 +37,7 @@
     "GEMINI.md",
     "pro/license/",
     "squads/",
+    "marketplace/",
     "README.md",
     "LICENSE"
   ],

package/scripts/pre-publish-check.js

@@ -135,7 +135,36 @@ if (fs.existsSync(cliPath)) {
     );
 }
 
-// ── 7. npm pack dry-run to count files ────────────────────────────────────
+// ── 7. squads/ directory ──────────────────────────────────────────────────
+console.log('\n👥 Squads:');
+const squadsDir = path.join(ROOT, 'squads');
+if (fs.existsSync(squadsDir)) {
+    const squads = fs.readdirSync(squadsDir, { withFileTypes: true })
+        .filter(d => d.isDirectory()).map(d => d.name);
+    check(`squads/ directory exists (${squads.length} squads)`, squads.length >= 3,
+        'Expected at least 3 squads (fullstack, planning, devops)');
+    for (const s of ['fullstack', 'planning', 'devops']) {
+        check(`Squad: ${s}`, squads.includes(s), `Missing squad: squads/${s}/`);
+    }
+} else {
+    check('squads/ directory exists', false, 'squads/ directory missing — check files[] in package.json');
+}
+
+// ── 8. marketplace/ registry ──────────────────────────────────────────────
+console.log('\n🏪 Marketplace:');
+const marketplaceRegistry = path.join(ROOT, 'marketplace', 'registry.json');
+check('marketplace/registry.json exists', fs.existsSync(marketplaceRegistry),
+    'marketplace/registry.json is missing — run: create marketplace/registry.json');
+if (fs.existsSync(marketplaceRegistry)) {
+    try {
+        const registry = JSON.parse(fs.readFileSync(marketplaceRegistry, 'utf8'));
+        check(`registry.json has agents (found ${(registry.agents || []).length})`,
+            (registry.agents || []).length >= 1, 'registry.json should have at least 1 agent entry');
+    } catch (e) {
+        check('registry.json is valid JSON', false, `Parse error: ${e.message}`);
+    }
+}
+
 console.log('\n📦 npm pack dry-run:');
 try {
     const packOutput = execSync('npm pack --dry-run 2>&1', { cwd: ROOT, encoding: 'utf8' });