grimoire-framework 1.2.0 → 1.4.0

package/bin/commands/exportall.js

@@ -0,0 +1,200 @@
+/**
+ * grimoire export — Full Export
+ *
+ * grimoire export --all             Markdown bundle de tudo
+ * grimoire export --all --json      JSON bundle de tudo
+ * grimoire export --all --out <dir> Diretório de saída customizado
+ */
+
+'use strict';
+
+const path = require('path');
+const fs = require('fs');
+
+function findGrimoireDir() {
+    const cwd = process.cwd();
+    const direct = path.join(cwd, '.grimoire');
+    const sub = path.join(cwd, 'grimoire', '.grimoire');
+    if (fs.existsSync(direct)) return direct;
+    if (fs.existsSync(sub)) return sub;
+    return null;
+}
+
+// ── Loaders ───────────────────────────────────────────────────────────────────
+function loadAllStories(grimoireDir) {
+    const dir = path.join(grimoireDir, 'stories');
+    if (!fs.existsSync(dir)) return [];
+    return fs.readdirSync(dir)
+        .filter(f => f.endsWith('.json'))
+        .map(f => { try { return JSON.parse(fs.readFileSync(path.join(dir, f), 'utf8')); } catch (_) { return null; } })
+        .filter(Boolean)
+        .sort((a, b) => a.createdAt > b.createdAt ? 1 : -1);
+}
+
+function loadAllMemory(grimoireDir) {
+    const sessionsDir = path.join(grimoireDir, 'memory', 'sessions');
+    if (!fs.existsSync(sessionsDir)) return [];
+    const entries = [];
+    const files = fs.readdirSync(sessionsDir).filter(f => f.endsWith('.jsonl')).sort();
+    for (const f of files) {
+        const raw = fs.readFileSync(path.join(sessionsDir, f), 'utf8');
+        for (const line of raw.split('\n').filter(l => l.trim())) {
+            try { entries.push({ date: f.slice(0, 10), ...JSON.parse(line) }); } catch (_) { }
+        }
+    }
+    return entries;
+}
+
+function loadMetrics(grimoireDir) {
+    const dir = path.join(grimoireDir, 'metrics');
+    if (!fs.existsSync(dir)) return { sessions: 0, commits: 0, storiesDone: 0 };
+    let sessions = 0, commits = 0, storiesDone = 0;
+    for (const f of fs.readdirSync(dir).filter(f => f.endsWith('.jsonl'))) {
+        const raw = fs.readFileSync(path.join(dir, f), 'utf8');
+        for (const line of raw.split('\n').filter(l => l.trim())) {
+            try {
+                const e = JSON.parse(line);
+                if (e.type === 'session_start' || e.type === 'agent_session') sessions++;
+                if (e.type === 'commit') commits++;
+                if (e.type === 'story_complete') storiesDone++;
+            } catch (_) { }
+        }
+    }
+    return { sessions, commits, storiesDone };
+}
+
+// ── Markdown export ───────────────────────────────────────────────────────────
+function buildMarkdown(stories, memory, metrics, projectName) {
+    const now = new Date().toISOString().split('T')[0];
+    const lines = [];
+
+    lines.push(`# Grimoire Export — ${projectName}`);
+    lines.push(`\n> Exportado em: ${now}\n`);
+
+    // Stats
+    lines.push(`## 📈 Resumo\n`);
+    lines.push(`| Métrica | Valor |`);
+    lines.push(`|---|---|`);
+    lines.push(`| Stories totais | ${stories.length} |`);
+    lines.push(`| Sessões | ${metrics.sessions} |`);
+    lines.push(`| Commits | ${metrics.commits} |`);
+    lines.push(`| Stories concluídas | ${metrics.storiesDone} |`);
+    lines.push(`| Entradas de memória | ${memory.length} |`);
+    lines.push('');
+
+    // Stories
+    lines.push(`## 📋 Stories\n`);
+    const openStories = stories.filter(s => s.status !== 'done');
+    const doneStories = stories.filter(s => s.status === 'done');
+
+    if (openStories.length) {
+        lines.push(`### Em andamento\n`);
+        openStories.forEach(s => {
+            lines.push(`#### 🔄 [${s.id}] ${s.title}`);
+            lines.push(`- **Criada:** ${s.createdAt.slice(0, 10)}`);
+            if (s.notes && s.notes.length) {
+                lines.push(`- **Notas:**`);
+                s.notes.forEach(n => lines.push(`  - ${n}`));
+            }
+            lines.push('');
+        });
+    }
+    if (doneStories.length) {
+        lines.push(`### Concluídas\n`);
+        doneStories.forEach(s => {
+            lines.push(`- ✅ **[${s.id}]** ${s.title}${s.doneAt ? ` — ${s.doneAt.slice(0, 10)}` : ''}`);
+        });
+        lines.push('');
+    }
+
+    // Memory by tag
+    lines.push(`## 🧠 Memória\n`);
+    const byTag = {};
+    const noTag = [];
+    for (const e of memory) {
+        if (e.tag) { byTag[e.tag] = byTag[e.tag] || []; byTag[e.tag].push(e); }
+        else noTag.push(e);
+    }
+
+    for (const [tag, entries] of Object.entries(byTag)) {
+        lines.push(`### #${tag}\n`);
+        entries.forEach(e => {
+            const story = e.story ? ` \`[${e.story}]\`` : '';
+            lines.push(`- **${e.date}**  ${e.content}${story}`);
+        });
+        lines.push('');
+    }
+
+    if (noTag.length) {
+        lines.push(`### Sem tag\n`);
+        noTag.slice(0, 20).forEach(e => lines.push(`- **${e.date}**  ${e.content}`));
+        if (noTag.length > 20) lines.push(`- *(e mais ${noTag.length - 20} entradas...)*`);
+        lines.push('');
+    }
+
+    return lines.join('\n');
+}
+
+// ── JSON export ───────────────────────────────────────────────────────────────
+function buildJSON(stories, memory, metrics, projectName) {
+    return JSON.stringify({
+        exportedAt: new Date().toISOString(),
+        project: projectName,
+        metrics,
+        stories,
+        memory,
+    }, null, 2);
+}
+
+// ── run ───────────────────────────────────────────────────────────────────────
+function run(args) {
+    if (!args.includes('--all')) {
+        console.log('\nUsage:\n');
+        console.log('  grimoire export --all           Markdown bundle de tudo');
+        console.log('  grimoire export --all --json    JSON bundle de tudo\n');
+        return;
+    }
+
+    const grimoireDir = findGrimoireDir();
+    if (!grimoireDir) {
+        console.error('❌ .grimoire/ not found. Run: npx grimoire-framework install');
+        return;
+    }
+
+    // Project name
+    let projectName = path.basename(process.cwd());
+    try {
+        const pkg = JSON.parse(fs.readFileSync(path.join(process.cwd(), 'package.json'), 'utf8'));
+        projectName = pkg.name || projectName;
+    } catch (_) { }
+
+    // Output dir
+    const outIdx = args.indexOf('--out');
+    const outDir = outIdx !== -1 && args[outIdx + 1]
+        ? args[outIdx + 1]
+        : path.join(grimoireDir, 'exports');
+    if (!fs.existsSync(outDir)) fs.mkdirSync(outDir, { recursive: true });
+
+    const now = new Date().toISOString().split('T')[0];
+    const isJson = args.includes('--json');
+    const ext = isJson ? 'json' : 'md';
+    const outFile = path.join(outDir, `${now}-export.${ext}`);
+
+    console.log('\n⏳ Exportando dados do .grimoire/ ...\n');
+
+    const stories = loadAllStories(grimoireDir);
+    const memory = loadAllMemory(grimoireDir);
+    const metrics = loadMetrics(grimoireDir);
+
+    const content = isJson
+        ? buildJSON(stories, memory, metrics, projectName)
+        : buildMarkdown(stories, memory, metrics, projectName);
+
+    fs.writeFileSync(outFile, content, 'utf8');
+
+    const rel = path.relative(process.cwd(), outFile);
+    console.log(`✅ Export gerado: ${rel}`);
+    console.log(`   Stories: ${stories.length}  ·  Memória: ${memory.length}  ·  Formato: ${isJson ? 'JSON' : 'Markdown'}\n`);
+}
+
+module.exports = { run };

package/bin/commands/memory.js

@@ -85,6 +85,19 @@ async function saveMemory(args, memoryDir) {
     else { filteredArgs = filteredArgs.filter(a => a !== args[tagIdx] && a !== tag); }
   }
 
+  // Extract --story value if present
+  const storyIdx = filteredArgs.findIndex(a => a === '--story' || a.startsWith('--story='));
+  let storyId = null;
+  if (storyIdx !== -1) {
+    if (filteredArgs[storyIdx].includes('=')) {
+      storyId = filteredArgs[storyIdx].split('=')[1];
+      filteredArgs.splice(storyIdx, 1);
+    } else {
+      storyId = filteredArgs[storyIdx + 1];
+      filteredArgs.splice(storyIdx, 2);
+    }
+  }
+
   const content = filteredArgs.join(' ');
   if (!content) {
     console.error('❌ Please provide content to save.');
@@ -98,6 +111,7 @@ async function saveMemory(args, memoryDir) {
     timestamp: new Date().toISOString(),
     content: content,
     ...(tag ? { tag } : {}),
+    ...(storyId ? { story: storyId } : {}),
   };
 
   // Ensure file exists for lockfile

package/bin/commands/report.js

@@ -0,0 +1,200 @@
+/**
+ * grimoire report — Daily / Weekly Consolidated Report
+ *
+ * grimoire report               Relatório de hoje
+ * grimoire report --period week Última semana (7 dias)
+ * grimoire report --period all  Histórico completo
+ * grimoire report --md          Exporta para .grimoire/reports/YYYY-MM-DD.md
+ */
+
+'use strict';
+
+const path = require('path');
+const fs = require('fs');
+
+function findGrimoireDir() {
+    const cwd = process.cwd();
+    const direct = path.join(cwd, '.grimoire');
+    const sub = path.join(cwd, 'grimoire', '.grimoire');
+    if (fs.existsSync(direct)) return direct;
+    if (fs.existsSync(sub)) return sub;
+    return null;
+}
+
+// ── Date helpers ───────────────────────────────────────────────────────────────
+function today() { return new Date().toISOString().split('T')[0]; }
+function daysAgo(n) {
+    const d = new Date();
+    d.setDate(d.getDate() - n);
+    return d.toISOString().split('T')[0];
+}
+function dateRange(period) {
+    if (period === 'week') return { from: daysAgo(6), to: today(), label: 'semana' };
+    if (period === 'month') return { from: daysAgo(29), to: today(), label: 'mês' };
+    return { from: '2000-01-01', to: today(), label: 'histórico' };
+}
+
+// ── Helpers: read JSONL sessions ───────────────────────────────────────────────
+function readSessionEntries(grimoireDir, from, to) {
+    const sessionsDir = path.join(grimoireDir, 'memory', 'sessions');
+    if (!fs.existsSync(sessionsDir)) return [];
+    const files = fs.readdirSync(sessionsDir)
+        .filter(f => f.endsWith('.jsonl') && f.slice(0, 10) >= from && f.slice(0, 10) <= to);
+    const entries = [];
+    for (const f of files) {
+        const raw = fs.readFileSync(path.join(sessionsDir, f), 'utf8');
+        for (const line of raw.split('\n').filter(l => l.trim())) {
+            try { entries.push({ date: f.slice(0, 10), ...JSON.parse(line) }); } catch (_) { }
+        }
+    }
+    return entries;
+}
+
+// ── Helpers: read metrics JSONL ────────────────────────────────────────────────
+function readMetricsEntries(grimoireDir, from, to) {
+    const metricsDir = path.join(grimoireDir, 'metrics');
+    if (!fs.existsSync(metricsDir)) return [];
+    const files = fs.readdirSync(metricsDir)
+        .filter(f => f.endsWith('.jsonl') && f.slice(0, 10) >= from && f.slice(0, 10) <= to);
+    const entries = [];
+    for (const f of files) {
+        const raw = fs.readFileSync(path.join(metricsDir, f), 'utf8');
+        for (const line of raw.split('\n').filter(l => l.trim())) {
+            try { entries.push({ date: f.slice(0, 10), ...JSON.parse(line) }); } catch (_) { }
+        }
+    }
+    return entries;
+}
+
+// ── Read stories ───────────────────────────────────────────────────────────────
+function readStories(grimoireDir, from, to) {
+    const storiesDir = path.join(grimoireDir, 'stories');
+    if (!fs.existsSync(storiesDir)) return [];
+    return fs.readdirSync(storiesDir)
+        .filter(f => f.endsWith('.json'))
+        .map(f => { try { return JSON.parse(fs.readFileSync(path.join(storiesDir, f), 'utf8')); } catch (_) { return null; } })
+        .filter(Boolean)
+        .filter(s => s.createdAt && s.createdAt.slice(0, 10) >= from);
+}
+
+// ── Build report object ────────────────────────────────────────────────────────
+function buildReport(grimoireDir, period) {
+    const { from, to, label } = dateRange(period);
+    const memEntries = readSessionEntries(grimoireDir, from, to);
+    const metricEntries = readMetricsEntries(grimoireDir, from, to);
+    const stories = readStories(grimoireDir, from, to);
+
+    // Tag buckets
+    const byTag = {};
+    for (const e of memEntries) {
+        if (e.tag) {
+            byTag[e.tag] = byTag[e.tag] || [];
+            byTag[e.tag].push(e);
+        }
+    }
+
+    // Agent usage from metrics
+    const agentUse = {};
+    for (const e of metricEntries) {
+        if (e.agent) agentUse[e.agent] = (agentUse[e.agent] || 0) + 1;
+        if (e.type === 'agent_session' && e.agent) agentUse[e.agent] = (agentUse[e.agent] || 0) + 1;
+    }
+    const topAgents = Object.entries(agentUse).sort((a, b) => b[1] - a[1]).slice(0, 5);
+
+    // Metrics summary
+    const sessions = metricEntries.filter(e => e.type === 'session_start' || e.type === 'session' || e.type === 'agent_session').length;
+    const commits = metricEntries.filter(e => e.type === 'commit').length;
+    const done = stories.filter(s => s.status === 'done').length;
+    const open = stories.filter(s => s.status !== 'done').length;
+
+    return { from, to, label, memEntries, byTag, topAgents, sessions, commits, stories, done, open };
+}
+
+// ── Render text report ─────────────────────────────────────────────────────────
+function renderReport(r) {
+    const lines = [];
+    const sep = '═'.repeat(50);
+    lines.push(`\n📊 Grimoire Report — ${r.to}  (${r.label}: ${r.from} → ${r.to})`);
+    lines.push(sep);
+
+    // Metrics
+    lines.push('\n📈 Métricas:');
+    lines.push(`  Sessões:  ${r.sessions}   Commits: ${r.commits}   Stories: ${r.done} concluídas / ${r.open} abertas`);
+    if (r.topAgents.length) {
+        lines.push(`  Agentes: ${r.topAgents.map(([a, n]) => `@${a} (${n}×)`).join(' · ')}`);
+    }
+
+    // Memory by tag
+    const tagKeys = Object.keys(r.byTag);
+    if (tagKeys.length > 0) {
+        lines.push('\n🧠 Memória por tag:');
+        for (const tag of tagKeys) {
+            lines.push(`\n  #${tag}:`);
+            for (const e of r.byTag[tag].slice(0, 5)) {
+                lines.push(`    ${e.date}  ${e.content}`);
+            }
+        }
+    }
+
+    // Untagged entries summary
+    const untagged = r.memEntries.filter(e => !e.tag);
+    if (untagged.length) {
+        lines.push(`\n🗒️  Memórias sem tag: ${untagged.length} entradas`);
+        untagged.slice(0, 3).forEach(e => lines.push(`  ${e.date}  ${e.content}`));
+        if (untagged.length > 3) lines.push(`  ... e mais ${untagged.length - 3}`);
+    }
+
+    // Stories
+    if (r.stories.length > 0) {
+        lines.push('\n📋 Stories:');
+        r.stories.filter(s => s.status === 'done').forEach(s =>
+            lines.push(`  ✅ [${s.id}] ${s.title} — concluída`)
+        );
+        r.stories.filter(s => s.status !== 'done').forEach(s =>
+            lines.push(`  🔄 [${s.id}] ${s.title} — em andamento`)
+        );
+    }
+
+    if (r.memEntries.length === 0 && r.sessions === 0 && r.stories.length === 0) {
+        lines.push('\n  (nenhuma atividade registrada no período)');
+        lines.push('  Dica: grimoire memory save "texto" · grimoire metrics track session');
+    }
+
+    lines.push('\n' + sep + '\n');
+    return lines.join('\n');
+}
+
+// ── Main run ───────────────────────────────────────────────────────────────────
+function run(args) {
+    const grimoireDir = findGrimoireDir();
+    if (!grimoireDir) {
+        console.error('❌ .grimoire/ not found. Run: npx grimoire-framework install');
+        return;
+    }
+
+    const periodIdx = args.findIndex(a => a === '--period' || a.startsWith('--period='));
+    let period = 'day';
+    if (periodIdx !== -1) {
+        period = args[periodIdx].includes('=')
+            ? args[periodIdx].split('=')[1]
+            : (args[periodIdx + 1] || 'day');
+    } else if (args.includes('week')) {
+        period = 'week';
+    }
+
+    const exportMd = args.includes('--md');
+    const report = buildReport(grimoireDir, period);
+    const text = renderReport(report);
+
+    console.log(text);
+
+    if (exportMd) {
+        const reportsDir = path.join(grimoireDir, 'reports');
+        if (!fs.existsSync(reportsDir)) fs.mkdirSync(reportsDir, { recursive: true });
+        const filename = path.join(reportsDir, `${report.to}-${period}.md`);
+        fs.writeFileSync(filename, text.replace(/\n/g, '\n'), 'utf8');
+        console.log(`✅ Relatório exportado: ${path.relative(process.cwd(), filename)}\n`);
+    }
+}
+
+module.exports = { run };

package/bin/commands/search.js

@@ -0,0 +1,171 @@
+/**
+ * grimoire search — Global Search
+ *
+ * grimoire search "termo"           Busca em memory + stories + agents
+ * grimoire search "JWT" --memory    Só memória
+ * grimoire search "JWT" --stories   Só stories
+ * grimoire search "JWT" --agents    Só agentes
+ */
+
+'use strict';
+
+const path = require('path');
+const fs = require('fs');
+
+function findGrimoireDir() {
+    const cwd = process.cwd();
+    const direct = path.join(cwd, '.grimoire');
+    const sub = path.join(cwd, 'grimoire', '.grimoire');
+    if (fs.existsSync(direct)) return direct;
+    if (fs.existsSync(sub)) return sub;
+    return null;
+}
+
+function findAgentsDir() {
+    const cwd = process.cwd();
+    const dirs = [
+        path.join(cwd, '.codex', 'agents'),
+        path.join(cwd, 'node_modules', 'grimoire-framework', '.codex', 'agents'),
+    ];
+    return dirs.find(d => fs.existsSync(d)) || null;
+}
+
+function hl(text, query) {
+    if (!query) return text;
+    const re = new RegExp(query.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'), 'gi');
+    return text.replace(re, m => `\x1b[33m${m}\x1b[0m`);
+}
+
+// ── Search memory sessions ────────────────────────────────────────────────────
+function searchMemory(grimoireDir, query) {
+    const sessionsDir = path.join(grimoireDir, 'memory', 'sessions');
+    if (!fs.existsSync(sessionsDir)) return [];
+    const lq = query.toLowerCase();
+    const results = [];
+    const files = fs.readdirSync(sessionsDir).filter(f => f.endsWith('.jsonl')).sort().reverse();
+    for (const f of files) {
+        const raw = fs.readFileSync(path.join(sessionsDir, f), 'utf8');
+        for (const line of raw.split('\n').filter(l => l.trim())) {
+            try {
+                const e = JSON.parse(line);
+                if ((e.content || '').toLowerCase().includes(lq)) {
+                    results.push({ date: f.slice(0, 10), content: e.content, tag: e.tag || null, story: e.story || null });
+                }
+            } catch (_) { }
+        }
+        if (results.length >= 20) break;
+    }
+    return results;
+}
+
+// ── Search stories ────────────────────────────────────────────────────────────
+function searchStories(grimoireDir, query) {
+    const storiesDir = path.join(grimoireDir, 'stories');
+    if (!fs.existsSync(storiesDir)) return [];
+    const lq = query.toLowerCase();
+    return fs.readdirSync(storiesDir)
+        .filter(f => f.endsWith('.json'))
+        .map(f => { try { return JSON.parse(fs.readFileSync(path.join(storiesDir, f), 'utf8')); } catch (_) { return null; } })
+        .filter(Boolean)
+        .filter(s => (s.title || '').toLowerCase().includes(lq) ||
+            (s.notes || []).some(n => n.toLowerCase().includes(lq)));
+}
+
+// ── Search agents ─────────────────────────────────────────────────────────────
+function searchAgents(agentsDir, query) {
+    if (!agentsDir) return [];
+    const lq = query.toLowerCase();
+    const results = [];
+    for (const f of fs.readdirSync(agentsDir).filter(f => f.endsWith('.md'))) {
+        const raw = fs.readFileSync(path.join(agentsDir, f), 'utf8').toLowerCase();
+        if (raw.includes(lq)) {
+            const id = f.replace('.md', '');
+            // Extract name from yaml block
+            let name = id;
+            const nameMatch = raw.match(/name:\s*([^\n]+)/);
+            if (nameMatch) name = nameMatch[1].trim();
+            const titleMatch = raw.match(/title:\s*([^\n]+)/);
+            const title = titleMatch ? titleMatch[1].trim() : '';
+            results.push({ id, name, title });
+        }
+    }
+    return results;
+}
+
+// ── run ───────────────────────────────────────────────────────────────────────
+function run(args) {
+    const query = args.filter(a => !a.startsWith('-')).join(' ');
+    if (!query) {
+        console.log('Usage: grimoire search "termo"\n');
+        console.log('Busca em: memória · stories · agentes\n');
+        return;
+    }
+
+    const onlyMemory = args.includes('--memory');
+    const onlyStories = args.includes('--stories');
+    const onlyAgents = args.includes('--agents');
+    const all = !onlyMemory && !onlyStories && !onlyAgents;
+
+    const grimoireDir = findGrimoireDir();
+    const agentsDir = findAgentsDir();
+
+    let totalResults = 0;
+
+    console.log(`\n🔍 Grimoire Search — "${query}"\n${'─'.repeat(44)}`);
+
+    // Memory
+    if (all || onlyMemory) {
+        if (grimoireDir) {
+            const memResults = searchMemory(grimoireDir, query);
+            if (memResults.length > 0) {
+                console.log('\n🧠 Memória:');
+                for (const r of memResults) {
+                    const tag = r.tag ? ` [#${r.tag}]` : '';
+                    const story = r.story ? ` [${r.story}]` : '';
+                    console.log(`  ${r.date}  ${hl(r.content, query)}${tag}${story}`);
+                }
+                totalResults += memResults.length;
+            }
+        }
+    }
+
+    // Stories
+    if (all || onlyStories) {
+        if (grimoireDir) {
+            const storyResults = searchStories(grimoireDir, query);
+            if (storyResults.length > 0) {
+                console.log('\n📋 Stories:');
+                for (const s of storyResults) {
+                    const icon = s.status === 'done' ? '✅' : '🔄';
+                    console.log(`  ${icon} [${s.id}] ${hl(s.title, query)}`);
+                    for (const n of (s.notes || []).filter(n => n.toLowerCase().includes(query.toLowerCase()))) {
+                        console.log(`       📝 ${hl(n, query)}`);
+                    }
+                }
+                totalResults += storyResults.length;
+            }
+        }
+    }
+
+    // Agents
+    if (all || onlyAgents) {
+        const agentResults = searchAgents(agentsDir, query);
+        if (agentResults.length > 0) {
+            console.log('\n🤖 Agentes:');
+            for (const a of agentResults) {
+                console.log(`  @${hl(a.id, query)} — ${a.name}${a.title ? '  ' + a.title : ''}`);
+            }
+            totalResults += agentResults.length;
+        }
+    }
+
+    if (totalResults === 0) {
+        console.log('\n  (nenhum resultado encontrado)');
+        console.log(`  Dica: tente termos mais curtos ou use --memory / --stories / --agents\n`);
+    } else {
+        console.log(`\n${'─'.repeat(44)}`);
+        console.log(`  ${totalResults} resultado(s)\n`);
+    }
+}
+
+module.exports = { run };