grimoire-framework 1.0.20 → 1.1.0

package/.grimoire/install-manifest.yaml

@@ -7,8 +7,8 @@
 # - SHA256 hashes for change detection
 # - File types for categorization
 #
-version: 1.0.20
-generated_at: "2026-02-22T14:39:48.383Z"
+version: 1.1.0
+generated_at: "2026-02-22T14:53:32.130Z"
 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/metrics.js

@@ -1,107 +1,265 @@
 /**
- * Grimoire Metrics CLI Command - Advanced Aggregator
+ * Grimoire Metrics CLI Command — Dashboard + Period Filters + CSV Export
  *
- * Aggregates productivity and usage metrics from daily logs.
+ * grimoire metrics                   # Resumo do mês atual
+ * grimoire metrics --period week     # Últimos 7 dias
+ * grimoire metrics --period month    # Últimos 30 dias
+ * grimoire metrics --period all      # Todo o histórico
+ * grimoire metrics export --csv      # Exporta para CSV
+ * grimoire metrics track <event>     # Registra um evento manualmente
  */
 
+'use strict';
+
 const path = require('path');
 const fs = require('fs/promises');
-const existsSync = require('fs').existsSync;
+const fsSync = require('fs');
 
-/**
- * Run the metrics command
- * @param {string[]} args - Command arguments
- */
+// ── Agent personas catalogue ───────────────────────────────────────────────────
+const AGENT_ICONS = {
+  'dev': '🎨', 'qa': '🖌️', 'architect': '🏛️', 'pm': '📋', 'sm': '🌊',
+  'devops': '⚡', 'data-engineer': '📊', 'analyst': '🔍',
+  'ux-design-expert': '🎭', 'po': '🎯', 'squad-creator': '🗿',
+  'grimoire-master': '👑',
+};
+
+// ── Entry point ────────────────────────────────────────────────────────────────
 async function run(args) {
   let baseDir = process.cwd();
-  if (!existsSync(path.join(baseDir, '.grimoire')) && existsSync(path.join(baseDir, 'grimoire', '.grimoire'))) {
+  if (!fsSync.existsSync(path.join(baseDir, '.grimoire')) &&
+    fsSync.existsSync(path.join(baseDir, 'grimoire', '.grimoire'))) {
     baseDir = path.join(baseDir, 'grimoire');
   }
 
   const metricsDir = path.join(baseDir, '.grimoire', 'metrics');
 
-  if (!existsSync(metricsDir)) {
-    console.error('❌ Metrics system not found.');
-    return;
+  // Auto-create metrics dir if .grimoire exists
+  if (!fsSync.existsSync(metricsDir)) {
+    if (fsSync.existsSync(path.join(baseDir, '.grimoire'))) {
+      await fs.mkdir(path.join(metricsDir, 'daily'), { recursive: true });
+      console.log('✅ Metrics directory initialized at .grimoire/metrics/');
+    } else {
+      console.error('❌ Grimoire not installed. Run: npx grimoire-framework install');
+      return;
+    }
   }
 
+  // Sub-commands
+  const sub = args[0];
+  if (sub === 'export') { await exportMetrics(metricsDir, args.slice(1)); return; }
+  if (sub === 'track') { await trackEvent(metricsDir, args.slice(1)); return; }
+  if (sub === 'help') { showHelp(); return; }
+
+  // Parse period
+  const periodIdx = args.indexOf('--period');
+  const period = periodIdx !== -1 ? args[periodIdx + 1] : 'month';
+
   try {
-    const stats = await aggregateMetrics(metricsDir);
-    showDashboard(stats);
-  } catch (error) {
-    console.error(`❌ Error aggregating metrics: ${error.message}`);
+    const stats = await aggregateMetrics(metricsDir, period);
+    showDashboard(stats, period);
+  } catch (e) {
+    console.error(`❌ Error: ${e.message}`);
   }
 }
 
-async function aggregateMetrics(metricsDir) {
+// ── Period utilities ───────────────────────────────────────────────────────────
+function cutoffDate(period) {
+  const d = new Date();
+  if (period === 'week') d.setDate(d.getDate() - 7);
+  else if (period === 'month') d.setDate(d.getDate() - 30);
+  else if (period === 'all') return new Date(0);
+  else d.setDate(d.getDate() - 30); // default month
+  return d;
+}
+
+function periodLabel(period) {
+  const months = ['Janeiro', 'Fevereiro', 'Março', 'Abril', 'Maio', 'Junho',
+    'Julho', 'Agosto', 'Setembro', 'Outubro', 'Novembro', 'Dezembro'];
+  if (period === 'week') return 'Últimos 7 dias';
+  if (period === 'all') return 'Histórico completo';
+  return `${months[new Date().getMonth()]} ${new Date().getFullYear()}`;
+}
+
+// ── Aggregator ─────────────────────────────────────────────────────────────────
+async function aggregateMetrics(metricsDir, period) {
   const dailyDir = path.join(metricsDir, 'daily');
+  const cutoff = cutoffDate(period);
+
   const stats = {
-    totalSessions: 0,
-    totalStories: 0,
-    totalTokens: 0,
-    agentUsage: {},
-    daysActive: 0
+    sessions: 0, stories: 0, tokens: 0,
+    agentUsage: {}, daysActive: 0,
+    memoryEntries: 0, commandsRun: 0,
+    firstDate: null, lastDate: null,
   };
 
-  if (!existsSync(dailyDir)) return stats;
+  if (!fsSync.existsSync(dailyDir)) return stats;
+
+  const files = (await fs.readdir(dailyDir))
+    .filter(f => f.match(/^\d{4}-\d{2}-\d{2}/) && (f.endsWith('.jsonl') || f.endsWith('.json')))
+    .filter(f => new Date(f.substring(0, 10)) >= cutoff)
+    .sort();
 
-  const files = (await fs.readdir(dailyDir)).filter(f => f.endsWith('.jsonl'));
   stats.daysActive = files.length;
+  if (files.length > 0) {
+    stats.firstDate = files[0].substring(0, 10);
+    stats.lastDate = files[files.length - 1].substring(0, 10);
+  }
 
   for (const file of files) {
     const content = await fs.readFile(path.join(dailyDir, file), 'utf8');
     const lines = content.split('\n').filter(l => l.trim());
-    
-    stats.totalSessions += lines.length;
+    stats.sessions += lines.length;
 
-    lines.forEach(line => {
+    for (const line of lines) {
       try {
         const entry = JSON.parse(line);
-        // Increment tokens if present
-        if (entry.tokens) stats.totalTokens += entry.tokens;
-        // Increment stories if entry marks completion
-        if (entry.type === 'story_complete') stats.totalStories += 1;
-        // Track agent usage
+        if (entry.tokens) stats.tokens += entry.tokens;
+        if (entry.type === 'story_complete') stats.stories += 1;
+        if (entry.type === 'memory_save') stats.memoryEntries += 1;
+        if (entry.type === 'command') stats.commandsRun += 1;
         if (entry.agent) {
           stats.agentUsage[entry.agent] = (stats.agentUsage[entry.agent] || 0) + 1;
         }
-      } catch (e) {
-        // Skip malformed lines
-      }
-    });
+      } catch (_) { /* skip bad lines */ }
+    }
   }
 
   return stats;
 }
 
-function showDashboard(stats) {
-  const monthNames = ["Janeiro", "Fevereiro", "Março", "Abril", "Maio", "Junho", "Julho", "Agosto", "Setembro", "Outubro", "Novembro", "Dezembro"];
-  const now = new Date();
-  
+// ── Manual event tracking ──────────────────────────────────────────────────────
+async function trackEvent(metricsDir, args) {
+  const type = args[0] || 'custom';
+  const content = args.slice(1).join(' ');
+  const today = new Date().toISOString().split('T')[0];
+  const dailyDir = path.join(metricsDir, 'daily');
+  if (!fsSync.existsSync(dailyDir)) await fs.mkdir(dailyDir, { recursive: true });
+
+  const entry = {
+    timestamp: new Date().toISOString(),
+    type,
+    content: content || type,
+  };
+  const file = path.join(dailyDir, `${today}.jsonl`);
+  await fs.appendFile(file, JSON.stringify(entry) + '\n', 'utf8');
+  console.log(`✅ Event tracked: [${type}] ${content || ''}`);
+}
+
+// ── Dashboard renderer ─────────────────────────────────────────────────────────
+function bar(value, max, width = 20) {
+  const filled = max > 0 ? Math.round((value / max) * width) : 0;
+  return '█'.repeat(filled) + '░'.repeat(width - filled);
+}
+
+function showDashboard(stats, period) {
+  const topAgents = Object.entries(stats.agentUsage).sort((a, b) => b[1] - a[1]).slice(0, 5);
+  const maxUsage = topAgents.length > 0 ? topAgents[0][1] : 0;
+
+  const sep = '─'.repeat(51);
+
   console.log(`
-📊 Grimoire Pro Metrics — ${monthNames[now.getMonth()]} ${now.getFullYear()}
-─────────────────────────────────────────────────
-  Sessões Totais:        ${stats.totalSessions}
-  Dias de Atividade:     ${stats.daysActive}
-  Stories Completas:     ${stats.totalStories}
-  Tokens Estimados:      ~${(stats.totalTokens / 1000).toFixed(1)}k
-─────────────────────────────────────────────────
-  Agentes mais ativos:`);
-
-  const topAgents = Object.entries(stats.agentUsage)
-    .sort((a, b) => b[1] - a[1])
-    .slice(0, 3);
+📊 Grimoire Metrics — ${periodLabel(period)}
+${sep}
+  📅 Período           ${stats.firstDate || 'hoje'} → ${stats.lastDate || 'hoje'}
+  📆 Dias ativos       ${stats.daysActive}
+  🔄 Sessões totais    ${stats.sessions}
+  📖 Stories concluídas ${stats.stories}
+  💾 Entradas de memória ${stats.memoryEntries}
+  ⚡ Tokens estimados   ${stats.tokens > 0 ? '~' + (stats.tokens / 1000).toFixed(1) + 'k' : '(sem dados de hooks)'}
+${sep}
+  🤖 Agentes mais usados:`);
 
   if (topAgents.length > 0) {
     topAgents.forEach(([agent, count]) => {
-      console.log(`  - ${agent}: ${count} interações`);
+      const icon = AGENT_ICONS[agent] || '🎭';
+      const b = bar(count, maxUsage, 15);
+      console.log(`  ${icon} @${agent.padEnd(20)} ${b}  ${count}×`);
     });
   } else {
-    console.log('  (Nenhum dado de agente coletado ainda)');
+    console.log('  (Nenhum evento de agente registrado ainda)');
+    console.log('\n  💡 Para registrar uso: grimoire metrics track agent dev');
   }
 
-  console.log(`─────────────────────────────────────────────────
-💡 Dica: Os dados são coletados automaticamente via hooks.`);
+  console.log(`${sep}
+  💡 Dica: Use hooks para coletar dados automaticamente
+     grimoire metrics track story_complete "Login implementado"
+     grimoire metrics --period week
+     grimoire metrics export --csv
+`);
+}
+
+// ── CSV / Markdown export ──────────────────────────────────────────────────────
+async function exportMetrics(metricsDir, args) {
+  const format = args.includes('--csv') ? 'csv' : 'markdown';
+  const dailyDir = path.join(metricsDir, 'daily');
+
+  if (!fsSync.existsSync(dailyDir)) {
+    console.error('❌ No metrics data found.'); return;
+  }
+
+  const files = (await fs.readdir(dailyDir)).filter(f => f.match(/^\d{4}-\d{2}-\d{2}/)).sort();
+  const allEntries = [];
+
+  for (const file of files) {
+    const date = file.substring(0, 10);
+    const content = await fs.readFile(path.join(dailyDir, file), 'utf8');
+    const lines = content.split('\n').filter(l => l.trim());
+    for (const line of lines) {
+      try { allEntries.push({ date, ...JSON.parse(line) }); } catch (_) { }
+    }
+  }
+
+  const outPath = path.join(process.cwd(),
+    `grimoire-metrics-${new Date().toISOString().split('T')[0]}.${format === 'csv' ? 'csv' : 'md'}`);
+
+  if (format === 'csv') {
+    const headers = ['date', 'timestamp', 'type', 'agent', 'tokens', 'content'];
+    const rows = allEntries.map(e =>
+      headers.map(h => JSON.stringify(e[h] ?? '')).join(',')
+    );
+    await fs.writeFile(outPath, [headers.join(','), ...rows].join('\n'), 'utf8');
+  } else {
+    let md = '# Grimoire Metrics Export\n\n';
+    md += `> Exported: ${new Date().toISOString()}\n\n`;
+    md += `| Date | Time | Type | Agent | Tokens | Content |\n`;
+    md += `|------|------|------|-------|--------|---------|\n`;
+    allEntries.forEach(e => {
+      const time = e.timestamp ? e.timestamp.split('T')[1]?.split('.')[0] : '';
+      md += `| ${e.date} | ${time} | ${e.type || ''} | ${e.agent || ''} | ${e.tokens || ''} | ${e.content || ''} |\n`;
+    });
+    await fs.writeFile(outPath, md, 'utf8');
+  }
+
+  console.log(`✅ Metrics exported (${allEntries.length} events) → ${outPath}`);
+}
+
+// ── Help ───────────────────────────────────────────────────────────────────────
+function showHelp() {
+  console.log(`
+📊 Grimoire Metrics — Dashboard de Produtividade
+
+USO:
+  grimoire metrics                     Resumo do mês atual
+  grimoire metrics --period week       Últimos 7 dias
+  grimoire metrics --period month      Últimos 30 dias
+  grimoire metrics --period all        Histórico completo
+  grimoire metrics export --csv        Exportar para CSV
+  grimoire metrics export              Exportar para Markdown
+  grimoire metrics track <type> [msg]  Registrar evento manualmente
+
+TIPOS DE EVENTO:
+  story_complete  "Nome da story"   Marcar story como concluída
+  agent <name>                      Registrar uso de agente
+  command <cmd>                     Registrar comando executado
+  memory_save                       Registrar uso de memória
+  custom <desc>                     Evento personalizado
+
+EXEMPLOS:
+  grimoire metrics --period week
+  grimoire metrics track story_complete "Implementar login"
+  grimoire metrics track agent dev
+  grimoire metrics export --csv
+`);
 }
 
 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/commands/sync.js

@@ -0,0 +1,203 @@
+/**
+ * grimoire sync — Global Agent Synchronization
+ *
+ * Copies agents from the current project to a global ~/.grimoire/agents/
+ * and optionally syncs them to other projects on the machine.
+ *
+ * grimoire sync --global           Sync agents to global store
+ * grimoire sync --from-global      Pull global agents into current project
+ * grimoire sync --list             List global agents
+ * grimoire sync --projects         Show projects registered in global store
+ */
+
+'use strict';
+
+const path = require('path');
+const fs = require('fs');
+const os = require('os');
+
+const GLOBAL_DIR = path.join(os.homedir(), '.grimoire');
+const GLOBAL_AGENTS = path.join(GLOBAL_DIR, 'agents');
+const GLOBAL_REGISTRY = path.join(GLOBAL_DIR, 'projects.json');
+
+// ── Utilities ──────────────────────────────────────────────────────────────────
+function ensureGlobalDir() {
+    if (!fs.existsSync(GLOBAL_AGENTS)) fs.mkdirSync(GLOBAL_AGENTS, { recursive: true });
+}
+
+function loadRegistry() {
+    if (!fs.existsSync(GLOBAL_REGISTRY)) return { projects: [], lastSync: null };
+    try { return JSON.parse(fs.readFileSync(GLOBAL_REGISTRY, 'utf8')); }
+    catch (_) { return { projects: [], lastSync: null }; }
+}
+
+function saveRegistry(data) {
+    fs.writeFileSync(GLOBAL_REGISTRY, JSON.stringify(data, null, 2), 'utf8');
+}
+
+function getLocalAgentsDir() {
+    const cwd = process.cwd();
+    const dir = path.join(cwd, '.codex', 'agents');
+    if (!fs.existsSync(dir)) return null;
+    return dir;
+}
+
+function copyAgent(src, dest) {
+    const content = fs.readFileSync(src, 'utf8');
+    fs.writeFileSync(dest, content, 'utf8');
+}
+
+// ── Commands ───────────────────────────────────────────────────────────────────
+async function run(args) {
+    const sub = args.find(a => a.startsWith('--')) || '--global';
+
+    switch (sub) {
+        case '--global': await syncToGlobal(); break;
+        case '--from-global': await syncFromGlobal(); break;
+        case '--list': listGlobalAgents(); break;
+        case '--projects': listProjects(); break;
+        case '--help':
+        default: showHelp(); break;
+    }
+}
+
+// ── Sync local → global ────────────────────────────────────────────────────────
+async function syncToGlobal() {
+    const localDir = getLocalAgentsDir();
+    if (!localDir) {
+        console.error('❌ No .codex/agents/ found. Run: npx grimoire-framework install');
+        return;
+    }
+
+    ensureGlobalDir();
+
+    const agents = fs.readdirSync(localDir).filter(f => f.endsWith('.md'));
+    let synced = 0, skipped = 0;
+
+    console.log(`\n🌐 Syncing ${agents.length} agents to global store (~/.grimoire/agents/)...\n`);
+
+    for (const file of agents) {
+        const src = path.join(localDir, file);
+        const dest = path.join(GLOBAL_AGENTS, file);
+        const exists = fs.existsSync(dest);
+
+        // Compare content to decide if update is needed
+        if (exists) {
+            const srcContent = fs.readFileSync(src, 'utf8');
+            const destContent = fs.readFileSync(dest, 'utf8');
+            if (srcContent === destContent) { skipped++; continue; }
+        }
+
+        copyAgent(src, dest);
+        console.log(`  ✅ ${file.replace('.md', '')}`);
+        synced++;
+    }
+
+    if (skipped > 0) console.log(`  ⏩ ${skipped} already up-to-date (skipped)`);
+
+    // Register this project
+    const registry = loadRegistry();
+    const cwd = process.cwd();
+    if (!registry.projects.includes(cwd)) registry.projects.push(cwd);
+    registry.lastSync = new Date().toISOString();
+    saveRegistry(registry);
+
+    console.log(`\n✅ ${synced} agent${synced === 1 ? '' : 's'} synced to global store`);
+    console.log(`   ${GLOBAL_AGENTS}`);
+    console.log(`\n💡 Use "grimoire sync --from-global" in other projects to pull these agents`);
+}
+
+// ── Sync global → local ────────────────────────────────────────────────────────
+async function syncFromGlobal() {
+    if (!fs.existsSync(GLOBAL_AGENTS)) {
+        console.error('❌ No global agents found. Run "grimoire sync --global" first.');
+        return;
+    }
+
+    const localDir = getLocalAgentsDir();
+    if (!localDir) {
+        console.error('❌ No .codex/agents/ found. Run: npx grimoire-framework install');
+        return;
+    }
+
+    const globalAgents = fs.readdirSync(GLOBAL_AGENTS).filter(f => f.endsWith('.md'));
+    const localAgents = new Set(fs.readdirSync(localDir).filter(f => f.endsWith('.md')));
+
+    // Only pull agents that DON'T exist locally (preserve local customizations)
+    const newAgents = globalAgents.filter(f => !localAgents.has(f));
+
+    console.log(`\n📥 Pulling from global store (~/.grimoire/agents/)...\n`);
+    console.log(`  Global agents:  ${globalAgents.length}`);
+    console.log(`  Local agents:   ${localAgents.size}`);
+    console.log(`  New to pull:    ${newAgents.length}\n`);
+
+    if (newAgents.length === 0) {
+        console.log('✅ Local agents are already up-to-date with global store.');
+        return;
+    }
+
+    for (const file of newAgents) {
+        copyAgent(path.join(GLOBAL_AGENTS, file), path.join(localDir, file));
+        console.log(`  ✅ Added: @${file.replace('.md', '')}`);
+    }
+
+    console.log(`\n✅ ${newAgents.length} agent${newAgents.length === 1 ? '' : 's'} pulled from global store`);
+}
+
+// ── List global agents ─────────────────────────────────────────────────────────
+function listGlobalAgents() {
+    if (!fs.existsSync(GLOBAL_AGENTS)) {
+        console.log('ℹ️  No global agents yet. Run: grimoire sync --global');
+        return;
+    }
+
+    const agents = fs.readdirSync(GLOBAL_AGENTS).filter(f => f.endsWith('.md'));
+    const registry = loadRegistry();
+
+    console.log(`\n🌐 Global Grimoire Agents (${agents.length})`);
+    console.log(`   Store: ${GLOBAL_AGENTS}`);
+    if (registry.lastSync) console.log(`   Last sync: ${registry.lastSync.split('T')[0]}\n`);
+
+    agents.forEach(f => console.log(`  🤖 @${f.replace('.md', '')}`));
+}
+
+// ── List registered projects ───────────────────────────────────────────────────
+function listProjects() {
+    const registry = loadRegistry();
+    console.log(`\n📁 Projects using Grimoire global store (${registry.projects.length}):\n`);
+    if (registry.projects.length === 0) {
+        console.log('  (No projects registered yet — run "grimoire sync --global")');
+        return;
+    }
+    registry.projects.forEach(p => {
+        const exists = fs.existsSync(p);
+        console.log(`  ${exists ? '✅' : '❌'} ${p}`);
+    });
+}
+
+// ── Help ───────────────────────────────────────────────────────────────────────
+function showHelp() {
+    console.log(`
+🌐 Grimoire Sync — Sincronização Global de Agentes
+
+USO:
+  grimoire sync --global           Envia agentes locais para ~/.grimoire/agents/
+  grimoire sync --from-global      Puxa agentes globais para o projeto atual
+  grimoire sync --list             Lista agentes no store global
+  grimoire sync --projects         Lista projetos registrados
+
+FLUXO TÍPICO:
+  # No projeto A (onde você criou um agente customizado):
+  grimoire agent create  →  grimoire sync --global
+
+  # No projeto B (onde você quer esse agente):
+  grimoire sync --from-global
+
+NOTAS:
+  - --from-global nunca sobrescreve agentes existentes localmente
+  - --global sobrescreve apenas se o conteúdo mudou
+  - O store global fica em: ${GLOBAL_DIR}
+`);
+}
+
+module.exports = { run };

package/bin/grimoire-cli.js

@@ -115,6 +115,15 @@ async function main() {
     case 'agent':
       await require('./commands/agent').run(args.slice(1));
       break;
+    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;

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.20",
+  "version": "1.1.0",
   "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"
   ],