grimoire-framework 1.0.18 → 1.0.21

package/.grimoire/install-manifest.yaml

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

package/bin/commands/agent.js

@@ -0,0 +1,216 @@
+/**
+ * grimoire agent — Agent Management CLI
+ *
+ * Commands:
+ *   grimoire agent create    — interative wizard to create a custom agent
+ *   grimoire agent list      — alias for grimoire agents list
+ *   grimoire agent edit <n>  — open agent in $EDITOR
+ *   grimoire agent remove <n>— delete a custom agent
+ */
+
+'use strict';
+
+const path = require('path');
+const fs = require('fs');
+const { execSync } = require('child_process');
+
+// ── Personas catalogue for the wizard ─────────────────────────────────────────
+const BASE_AGENTS = [
+    { id: 'dev', icon: '🎨', name: 'Da Vinci', specialty: 'Full-Stack Development' },
+    { id: 'qa', icon: '🖌️', name: 'Dürer', specialty: 'Quality Assurance' },
+    { id: 'architect', icon: '🏛️', name: 'Gaudí', specialty: 'System Architecture' },
+    { id: 'analyst', icon: '🔍', name: 'Vermeer', specialty: 'Research & Analysis' },
+    { id: 'grimoire-master', icon: '👑', name: 'Michelangelo', specialty: 'Orchestration' },
+];
+
+const ICON_OPTIONS = ['🎭', '🎪', '🌟', '⚡', '🔮', '🦊', '🐉', '🌊', '🔥', '🌙', '🎯', '🗡️', '🧙', '🎸', '🦅'];
+
+// ── Template generator ─────────────────────────────────────────────────────────
+function generateAgentTemplate({ id, name, icon, specialty, baseAgent, description }) {
+    const base = BASE_AGENTS.find(a => a.id === baseAgent);
+    const baseRef = base ? `Based on ${base.name} (${base.id})` : 'Custom Agent';
+
+    return `# ${id}
+
+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.
+
+CRITICAL: Read the full YAML BLOCK that FOLLOWS IN THIS FILE to understand your operating params, start and follow exactly your activation-instructions to alter your state of being, stay in this being until told to exit this mode:
+
+## COMPLETE AGENT DEFINITION FOLLOWS - NO EXTERNAL FILES NEEDED
+
+\`\`\`yaml
+activation-instructions:
+  - STEP 1: Read THIS ENTIRE FILE to understand your persona
+  - STEP 2: Adopt the ${name} persona completely
+  - STEP 3: Present your greeting to the user
+  - STEP 4: HALT and await user input
+  - STAY IN CHARACTER until user types *exit
+
+agent:
+  name: ${name}
+  id: ${id}
+  title: ${specialty}
+  icon: ${icon}
+  base: ${baseRef}
+  whenToUse: ${description}
+
+persona:
+  role: ${specialty} Specialist
+  style: Collaborative and focused on ${specialty.toLowerCase()}
+  identity: ${name} — ${description}
+
+greeting_levels:
+  default: |
+    ${icon} **${name}** (${id}) pronto!
+    Especialidade: **${specialty}**
+
+    Como posso ajudar?
+
+commands:
+  - "*help  — Show available commands"
+  - "*exit  — Exit agent mode"
+
+signature_closing: '— ${name} ${icon}'
+\`\`\`
+`;
+}
+
+// ── Prompt helpers (without @clack/prompts dependency) ─────────────────────────
+const readline = require('readline');
+
+function prompt(question) {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise(resolve => {
+        rl.question(question, answer => { rl.close(); resolve(answer.trim()); });
+    });
+}
+
+async function select(question, options) {
+    console.log(`\n${question}`);
+    options.forEach((opt, i) => console.log(`  ${i + 1}. ${opt.label || opt}`));
+    const answer = await prompt('  Escolha (número): ');
+    const idx = parseInt(answer) - 1;
+    if (idx >= 0 && idx < options.length) return options[idx].value || options[idx];
+    return options[0].value || options[0];
+}
+
+// ── Commands ───────────────────────────────────────────────────────────────────
+async function run(args) {
+    const sub = args[0];
+    switch (sub) {
+        case 'create': await createWizard(); break;
+        case 'edit': await editAgent(args[1]); break;
+        case 'remove':
+        case 'delete': await removeAgent(args[1]); break;
+        case 'list':
+        default: listAgents(); break;
+    }
+}
+
+function listAgents() {
+    const cwd = process.cwd();
+    const agentsDir = path.join(cwd, '.codex', 'agents');
+    if (!fs.existsSync(agentsDir)) {
+        console.log('❌ Agents directory not found. Run: npx grimoire-framework install');
+        return;
+    }
+    const agents = fs.readdirSync(agentsDir).filter(f => f.endsWith('.md'));
+    console.log(`\n🤖 Grimoire Agents (${agents.length}):\n`);
+    agents.forEach(f => {
+        const name = f.replace('.md', '');
+        const base = BASE_AGENTS.find(a => a.id === name);
+        const icon = base ? base.icon : '🎭';
+        const persona = base ? ` — ${base.name} (${base.specialty})` : ' — Custom Agent';
+        console.log(`  ${icon} @${name}${persona}`);
+    });
+    console.log('\n💡 Para criar um agente customizado: grimoire agent create');
+}
+
+async function createWizard() {
+    console.log('\n🧙 Grimoire Agent Creator\n');
+
+    // Step 1: Name/ID
+    const id = await prompt('Nome do agente (ex: caravaggio): ');
+    if (!id || !/^[a-z0-9-]+$/.test(id)) {
+        console.log('❌ Nome inválido. Use apenas letras minúsculas, números e hífens.');
+        return;
+    }
+
+    const cwd = process.cwd();
+    const agentsDir = path.join(cwd, '.codex', 'agents');
+    const agentFile = path.join(agentsDir, `${id}.md`);
+
+    if (fs.existsSync(agentFile)) {
+        console.log(`❌ Agente "${id}" já existe em ${agentFile}`);
+        return;
+    }
+
+    // Step 2: Display name
+    const name = await prompt(`Nome de exibição (ex: Caravaggio): `);
+
+    // Step 3: Specialty
+    const specialty = await prompt('Especialidade (ex: Arte Generativa e Criatividade): ');
+
+    // Step 4: Icon
+    const iconChoice = await select(
+        'Ícone do agente:',
+        ICON_OPTIONS.map((i, idx) => ({ label: `${i} (${idx + 1})`, value: i }))
+    );
+
+    // Step 5: Base agent (inherit style from)
+    const baseChoice = await select(
+        'Baseado em (herda o estilo de):',
+        [...BASE_AGENTS.map(a => ({ label: `${a.icon} ${a.name} — ${a.specialty}`, value: a.id })),
+        { label: '🆕 Custom (do zero)', value: 'custom' }]
+    );
+
+    // Step 6: Short description
+    const description = await prompt('Descrição curta (ex: Especialista em arte e criatividade visual): ');
+
+    // Generate & write
+    if (!fs.existsSync(agentsDir)) fs.mkdirSync(agentsDir, { recursive: true });
+
+    const content = generateAgentTemplate({
+        id, name: name || id, icon: iconChoice, specialty: specialty || 'Custom Specialist',
+        baseAgent: baseChoice !== 'custom' ? baseChoice : null,
+        description: description || `Custom agent: ${id}`
+    });
+
+    fs.writeFileSync(agentFile, content, 'utf8');
+
+    console.log(`
+✅ Agente criado: .codex/agents/${id}.md
+
+🎭 ${iconChoice} ${name || id} — ${specialty}
+
+Para ativar no Gemini CLI:
+  @${id}
+
+Para sincronizar com outras IDEs:
+  npx grimoire-framework update
+`);
+}
+
+async function editAgent(id) {
+    if (!id) { console.log('Usage: grimoire agent edit <name>'); return; }
+    const file = path.join(process.cwd(), '.codex', 'agents', `${id}.md`);
+    if (!fs.existsSync(file)) { console.log(`❌ Agent "${id}" not found.`); return; }
+    const editor = process.env.EDITOR || process.env.VISUAL || 'notepad';
+    try { execSync(`${editor} "${file}"`, { stdio: 'inherit' }); }
+    catch (e) { console.log(`❌ Could not open editor. Edit manually: ${file}`); }
+}
+
+async function removeAgent(id) {
+    if (!id) { console.log('Usage: grimoire agent remove <name>'); return; }
+    const file = path.join(process.cwd(), '.codex', 'agents', `${id}.md`);
+    if (!fs.existsSync(file)) { console.log(`❌ Agent "${id}" not found.`); return; }
+    const confirmed = await prompt(`Remove @${id}? (y/N): `);
+    if (confirmed.toLowerCase() === 'y') {
+        fs.unlinkSync(file);
+        console.log(`✅ Agent "${id}" removed.`);
+    } else {
+        console.log('Cancelled.');
+    }
+}
+
+module.exports = { run };

package/bin/commands/memory.js

@@ -16,13 +16,13 @@ const lockfile = require('proper-lockfile');
  */
 async function run(args) {
   const subCommand = args[0];
-  
+
   // Look for .grimoire directory in cwd or in grimoire/ subdirectory
   let baseDir = process.cwd();
   if (!existsSync(path.join(baseDir, '.grimoire')) && existsSync(path.join(baseDir, 'grimoire', '.grimoire'))) {
     baseDir = path.join(baseDir, 'grimoire');
   }
-  
+
   const memoryDir = path.join(baseDir, '.grimoire', 'memory');
 
   if (!existsSync(memoryDir)) {
@@ -41,6 +41,15 @@ async function run(args) {
       case 'show':
         await showSession(args.slice(1), memoryDir);
         break;
+      case 'search':
+        await searchMemory(args.slice(1), memoryDir);
+        break;
+      case 'export':
+        await exportMemory(args.slice(1), memoryDir);
+        break;
+      case 'clear':
+        await clearMemory(args.slice(1), memoryDir);
+        break;
       case 'digest':
         await digestMemory(args.slice(1), memoryDir);
         break;
@@ -80,7 +89,7 @@ async function saveMemory(args, memoryDir) {
   let release;
   try {
     // Acquire lock with retry logic
-    release = await lockfile.lock(sessionFile, { 
+    release = await lockfile.lock(sessionFile, {
       retries: {
         retries: 5,
         factor: 3,
@@ -115,8 +124,14 @@ async function listSessions(memoryDir) {
  * Shows session parsing JSONL or legacy JSON
  */
 async function showSession(args, memoryDir) {
-  const date = args[0] || new Date().toISOString().split('T')[0];
-  
+  // Support: grimoire memory show --last 5
+  let date, lastN;
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '--last' && args[i + 1]) lastN = parseInt(args[i + 1]);
+    else if (!args[i].startsWith('-')) date = args[i];
+  }
+  date = date || new Date().toISOString().split('T')[0];
+
   let sessionFile = path.join(memoryDir, 'sessions', `${date}.jsonl`);
   let isJsonl = true;
 
@@ -131,20 +146,101 @@ async function showSession(args, memoryDir) {
   }
 
   const rawContent = await fs.readFile(sessionFile, 'utf8');
-  console.log(`\n📖 Session: ${date}`);
-
+  let entries;
   if (isJsonl) {
-    const lines = rawContent.split('\n').filter(l => l.trim());
-    lines.forEach(line => {
-      const e = JSON.parse(line);
-      console.log(`  [${e.timestamp.split('T')[1].split('.')[0]}] ${e.content}`);
-    });
+    entries = rawContent.split('\n').filter(l => l.trim()).map(l => JSON.parse(l));
   } else {
-    const data = JSON.parse(rawContent);
-    data.entries.forEach(e => {
-      console.log(`  [${e.timestamp.split('T')[1].split('.')[0]}] ${e.content}`);
+    entries = JSON.parse(rawContent).entries;
+  }
+
+  if (lastN) entries = entries.slice(-lastN);
+
+  console.log(`\n📖 Session: ${date} (${entries.length} entr${entries.length === 1 ? 'y' : 'ies'})`);
+  entries.forEach(e => {
+    console.log(`  [${e.timestamp.split('T')[1].split('.')[0]}] ${e.content}`);
+  });
+}
+
+/**
+ * Search entries across all sessions
+ */
+async function searchMemory(args, memoryDir) {
+  const keyword = args.join(' ');
+  if (!keyword) { console.error('❌ Provide a search term.'); return; }
+
+  const sessionsDir = path.join(memoryDir, 'sessions');
+  const files = (await fs.readdir(sessionsDir)).filter(f => f.endsWith('.jsonl') || f.endsWith('.json'));
+
+  let matches = [];
+  for (const file of files) {
+    const raw = await fs.readFile(path.join(sessionsDir, file), 'utf8');
+    const entries = file.endsWith('.jsonl')
+      ? raw.split('\n').filter(l => l.trim()).map(l => JSON.parse(l))
+      : JSON.parse(raw).entries || [];
+    const date = file.replace(/\.(jsonl|json)$/, '');
+    for (const e of entries) {
+      if (e.content.toLowerCase().includes(keyword.toLowerCase())) {
+        matches.push({ date, time: e.timestamp.split('T')[1].split('.')[0], content: e.content });
+      }
+    }
+  }
+
+  console.log(`\n🔍 Search: "${keyword}" — ${matches.length} result${matches.length === 1 ? '' : 's'}`);
+  if (matches.length === 0) { console.log('  (No entries found)'); return; }
+  matches.forEach(m => console.log(`  [${m.date} ${m.time}] ${m.content}`));
+}
+
+/**
+ * Export all sessions to a Markdown file
+ */
+async function exportMemory(args, memoryDir) {
+  const format = args.includes('--format') ? args[args.indexOf('--format') + 1] : 'markdown';
+  const sessionsDir = path.join(memoryDir, 'sessions');
+  const files = (await fs.readdir(sessionsDir)).filter(f => f.endsWith('.jsonl') || f.endsWith('.json')).sort();
+
+  let output = '# Grimoire Memory Export\n\n';
+  output += `> Exported: ${new Date().toISOString()}\n\n`;
+
+  for (const file of files) {
+    const date = file.replace(/\.(jsonl|json)$/, '');
+    const raw = await fs.readFile(path.join(sessionsDir, file), 'utf8');
+    const entries = file.endsWith('.jsonl')
+      ? raw.split('\n').filter(l => l.trim()).map(l => JSON.parse(l))
+      : JSON.parse(raw).entries || [];
+
+    output += `## ${date}\n\n`;
+    entries.forEach(e => {
+      output += `- \`${e.timestamp.split('T')[1].split('.')[0]}\` ${e.content}\n`;
     });
+    output += '\n';
   }
+
+  const outFile = path.join(process.cwd(), `grimoire-memory-export-${Date.now()}.md`);
+  await fs.writeFile(outFile, output, 'utf8');
+  console.log(`✅ Memory exported to: ${outFile}`);
+}
+
+/**
+ * Clear sessions older than N days
+ */
+async function clearMemory(args, memoryDir) {
+  const olderThan = args.find(a => a.startsWith('--older-than'));
+  const days = olderThan ? parseInt(olderThan.replace('--older-than=', '').replace('--older-than', '') || args[args.indexOf(olderThan) + 1] || '30') : 30;
+
+  const sessionsDir = path.join(memoryDir, 'sessions');
+  const files = (await fs.readdir(sessionsDir)).filter(f => f.match(/^\d{4}-\d{2}-\d{2}/));
+  const cutoff = new Date();
+  cutoff.setDate(cutoff.getDate() - days);
+
+  let removed = 0;
+  for (const file of files) {
+    const datePart = file.replace(/\.(jsonl|json)$/, '');
+    if (new Date(datePart) < cutoff) {
+      await fs.unlink(path.join(sessionsDir, file));
+      removed++;
+    }
+  }
+  console.log(`✅ Cleared ${removed} session${removed === 1 ? '' : 's'} older than ${days} days.`);
 }
 
 /**
@@ -175,7 +271,7 @@ async function digestMemory(args, memoryDir) {
   categories.misc = entries.filter(e => !categorizedIds.has(e));
 
   console.log(`📊 Analysis complete: ${entries.length} entries processed.`);
-  
+
   if (categories.decisions.length > 0) {
     console.log('\n🏛️  PROPOSED DECISIONS (Update entities/decisions.md):');
     categories.decisions.forEach(e => console.log(`  - ${e.content}`));
@@ -194,21 +290,31 @@ async function digestMemory(args, memoryDir) {
   console.log('\n--- SESSION ARCHIVING ---');
   const archiveDir = path.join(memoryDir, 'sessions', 'archived');
   if (!existsSync(archiveDir)) await fs.mkdir(archiveDir);
-  
+
   await fs.rename(sessionFile, path.join(archiveDir, `${date}.jsonl`));
   console.log(`✅ Session ${date} digested and archived.`);
 }
 
 function showHelp() {
   console.log(`
-📊 Grimoire Memory Management (Turbo I/O)
-
-USAGE:
-  grimoire memory save "<text>"   # Save a new entry (Fast Append)
-  grimoire memory list            # List all recorded sessions
-  grimoire memory show <date>     # Show entries for a specific date
-  grimoire memory digest <date>   # Consolidate daily logs into permanent docs
-  grimoire memory help            # Show this help
+💾 Grimoire Memory — Gestão de Contexto
+
+USO:
+  grimoire memory save "<texto>"        Salva uma entrada na sessão de hoje
+  grimoire memory list                  Lista todas as sessões
+  grimoire memory show [data]           Mostra entradas de uma data (padrão: hoje)
+  grimoire memory show --last 5         Mostra as últimas 5 entradas de hoje
+  grimoire memory search "<termo>"      Busca em todas as sessões
+  grimoire memory export                Exporta tudo para Markdown
+  grimoire memory digest [data]         Categoriza e arquiva uma sessão
+  grimoire memory clear --older-than 30d   Remove sessões antigas
+
+EXEMPLOS:
+  grimoire memory save "Decidimos usar PostgreSQL por performance"
+  grimoire memory show --last 10
+  grimoire memory search "PostgreSQL"
+  grimoire memory export --format markdown
+  grimoire memory clear --older-than 30
 `);
 }