grimoire-framework 1.2.0 → 1.4.0

package/bin/commands/session.js

@@ -0,0 +1,217 @@
+/**
+ * grimoire session — Session Bootstrap Command
+ *
+ * grimoire session start                   Gera prompt de início de sessão
+ * grimoire session start --squad <squad>   Com squad específico
+ * grimoire session start --copy            (legacy alias)
+ */
+
+'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 findSquadsDir() {
+    const cwd = process.cwd();
+    const home = path.join(cwd, '.grimoire', 'squads');
+    const local = path.join(cwd, 'squads');
+    const pkg = path.join(cwd, 'node_modules', 'grimoire-framework', 'squads');
+    if (fs.existsSync(home)) return home;
+    if (fs.existsSync(local)) return local;
+    if (fs.existsSync(pkg)) return pkg;
+    return null;
+}
+
+function readSquadYaml(squadDir) {
+    const yamlFile = path.join(squadDir, 'squad.yaml');
+    if (!fs.existsSync(yamlFile)) return null;
+    const raw = fs.readFileSync(yamlFile, 'utf8');
+    const squad = { agents: [] };
+    for (const line of raw.split('\n')) {
+        const s = line.trim();
+        if (s.startsWith('name:')) squad.name = s.slice(5).trim().replace(/^"|"$/g, '');
+        if (s.startsWith('description:')) squad.description = s.slice(12).trim().replace(/^"|"$/g, '');
+        if (s.startsWith('- ') && squad._inAgents) squad.agents.push(s.slice(2).trim());
+        if (s === 'agents:') squad._inAgents = true;
+        else if (s.endsWith(':')) squad._inAgents = false;
+    }
+    delete squad._inAgents;
+    return squad;
+}
+
+function getLastMemoryEntries(grimoireDir, tag, n = 3) {
+    const sessionsDir = path.join(grimoireDir, 'memory', 'sessions');
+    if (!fs.existsSync(sessionsDir)) return [];
+    const files = fs.readdirSync(sessionsDir).filter(f => f.endsWith('.jsonl')).sort().reverse();
+    const results = [];
+    for (const f of files) {
+        if (results.length >= n) break;
+        const raw = fs.readFileSync(path.join(sessionsDir, f), 'utf8');
+        const lines = raw.split('\n').filter(l => l.trim()).reverse();
+        for (const line of lines) {
+            if (results.length >= n) break;
+            try {
+                const e = JSON.parse(line);
+                if (!tag || e.tag === tag) results.push(e);
+            } catch (_) { }
+        }
+    }
+    return results;
+}
+
+function loadConfig(grimoireDir) {
+    const file = path.join(grimoireDir, 'config.yaml');
+    if (!fs.existsSync(file)) return {};
+    const result = {};
+    for (const line of fs.readFileSync(file, 'utf8').split('\n')) {
+        const s = line.trim();
+        if (!s || s.startsWith('#')) continue;
+        const i = s.indexOf(':');
+        if (i === -1) continue;
+        let val = s.slice(i + 1).trim();
+        if (val === 'true') val = true;
+        else if (val === 'false') val = false;
+        result[s.slice(0, i).trim()] = val;
+    }
+    return result;
+}
+
+// ── run ───────────────────────────────────────────────────────────────────────
+function run(args) {
+    const sub = args[0];
+    if (sub === 'start' || !sub) {
+        sessionStart(args.slice(sub === 'start' ? 1 : 0));
+    } else {
+        console.log('Usage: grimoire session start [--squad <squad>]\n');
+    }
+}
+
+function sessionStart(args) {
+    const grimoireDir = findGrimoireDir();
+    if (!grimoireDir) {
+        console.error('❌ .grimoire/ not found. Run: npx grimoire-framework install');
+        return;
+    }
+
+    // Detect project name
+    let projectName = '';
+    try {
+        const pkg = JSON.parse(fs.readFileSync(path.join(process.cwd(), 'package.json'), 'utf8'));
+        projectName = pkg.name || '';
+    } catch (_) { }
+
+    // Squad
+    const squadIdx = args.findIndex(a => a === '--squad' || a.startsWith('--squad='));
+    let squadName = null;
+    if (squadIdx !== -1) {
+        squadName = args[squadIdx].includes('=') ? args[squadIdx].split('=')[1] : args[squadIdx + 1];
+    }
+    // Fallback to config
+    const config = loadConfig(grimoireDir);
+    if (!squadName && config.default_squad) squadName = config.default_squad;
+
+    let squadInfo = null;
+    if (squadName) {
+        const squadsDir = findSquadsDir();
+        if (squadsDir && fs.existsSync(path.join(squadsDir, squadName))) {
+            squadInfo = readSquadYaml(path.join(squadsDir, squadName));
+            if (squadInfo) squadInfo.id = squadName;
+        }
+    }
+
+    // Active stories
+    let activeStories = [];
+    try {
+        const { getActiveStories } = require('./story');
+        activeStories = getActiveStories(grimoireDir).slice(0, 5);
+    } catch (_) { }
+
+    // Recent memory by tag
+    const decisions = getLastMemoryEntries(grimoireDir, 'decisão', 3);
+    const patterns = getLastMemoryEntries(grimoireDir, 'padrão', 2);
+
+    // Default agent
+    const defaultAgent = config.default_agent || 'dev';
+
+    // Build prompt
+    const now = new Date();
+    const dateStr = now.toLocaleDateString('pt-BR');
+    const timeStr = now.toTimeString().slice(0, 5);
+    const sep = '═'.repeat(52);
+
+    const lines = [];
+    lines.push(`${sep}`);
+    lines.push(`🚀 INÍCIO DE SESSÃO — ${projectName || 'projeto'}`);
+    lines.push(`Data: ${dateStr} ${timeStr}${squadInfo ? ` | Squad: ${squadInfo.id}` : ''}`);
+    lines.push('');
+
+    if (squadInfo) {
+        const agentList = squadInfo.agents.map(a => `@${a}`).join(' · ');
+        lines.push(`Squad ativo: ${agentList}`);
+    } else {
+        lines.push(`Agente padrão: @${defaultAgent}`);
+    }
+
+    if (config.metrics_enabled !== false) lines.push('Métricas: ✅ ativas');
+    if (config.hooks_enabled) lines.push('Hooks: ✅ instalado');
+    lines.push('');
+
+    if (activeStories.length > 0) {
+        lines.push('Stories abertas:');
+        activeStories.forEach(s => lines.push(`  [IN PROGRESS] [${s.id}] — ${s.title}`));
+        lines.push('');
+    }
+
+    if (decisions.length > 0) {
+        lines.push('Últimas decisões (#decisão):');
+        decisions.forEach(d => lines.push(`  - ${d.content}`));
+        lines.push('');
+    }
+
+    if (patterns.length > 0) {
+        lines.push('Padrões ativos (#padrão):');
+        patterns.forEach(p => lines.push(`  - ${p.content}`));
+        lines.push('');
+    }
+
+    const firstStory = activeStories[0];
+    const firstAgent = squadInfo?.agents[0] || defaultAgent;
+    if (firstStory) {
+        lines.push(`Contexto: Continue o desenvolvimento com base nas stories abertas.`);
+        lines.push(`Para iniciar: @${firstAgent} apresente o estado atual de [${firstStory.id}] ${firstStory.title}.`);
+    } else {
+        lines.push(`Para iniciar: @${firstAgent} apresente-se e sugira o próximo passo.`);
+    }
+
+    lines.push(sep);
+
+    const prompt = lines.join('\n');
+
+    console.log('\n📋 Prompt de sessão (copie e cole no chat da IDE):\n');
+    console.log(prompt);
+    console.log('\n💡 Atalhos:');
+    console.log('  grimoire story create "título"     ← criar nova story');
+    console.log('  grimoire memory save "observação"  ← salvar decisão');
+    console.log('  grimoire report --period week      ← relatório da semana\n');
+
+    // Track session start in metrics
+    try {
+        const metricsDir = path.join(grimoireDir, 'metrics');
+        if (fs.existsSync(metricsDir)) {
+            const today = now.toISOString().split('T')[0];
+            const mFile = path.join(metricsDir, `${today}.jsonl`);
+            fs.appendFileSync(mFile, JSON.stringify({ timestamp: now.toISOString(), type: 'session_start', squad: squadName || null }) + '\n');
+        }
+    } catch (_) { }
+}
+
+module.exports = { run };

package/bin/commands/story.js

@@ -0,0 +1,254 @@
+/**
+ * grimoire story — Story Tracking CLI
+ *
+ * grimoire story create "Título da story"   Cria nova story
+ * grimoire story list                       Lista stories ativas
+ * grimoire story list --all                 Lista todas (inclui concluídas)
+ * grimoire story done <id>                  Marca story como concluída
+ * grimoire story show <id>                  Detalhes da story
+ * grimoire story delete <id>               Remove story
+ */
+
+'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 getStoriesDir(grimoireDir) {
+    const d = path.join(grimoireDir, 'stories');
+    if (!fs.existsSync(d)) fs.mkdirSync(d, { recursive: true });
+    return d;
+}
+
+function loadStories(storiesDir) {
+    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)
+        .sort((a, b) => a.createdAt > b.createdAt ? 1 : -1);
+}
+
+function nextId(stories) {
+    const nums = stories.map(s => parseInt(s.id.replace(/\D/g, '')) || 0);
+    const max = nums.length ? Math.max(...nums) : 0;
+    return `US-${String(max + 1).padStart(3, '0')}`;
+}
+
+// ── run ───────────────────────────────────────────────────────────────────────
+function run(args) {
+    const sub = args[0];
+    const rest = args.slice(1);
+
+    const grimoireDir = findGrimoireDir();
+    if (!grimoireDir) {
+        console.error('❌ .grimoire/ not found. Run: npx grimoire-framework install');
+        return;
+    }
+    const storiesDir = getStoriesDir(grimoireDir);
+
+    switch (sub) {
+        case 'create': storyCreate(rest, storiesDir, grimoireDir); break;
+        case 'done': storyDone(rest[0], storiesDir, grimoireDir); break;
+        case 'note': storyNote(rest[0], rest.slice(1), storiesDir); break;
+        case 'delete':
+        case 'remove': storyDelete(rest[0], storiesDir); break;
+        case 'show': storyShow(rest[0], storiesDir, grimoireDir); break;
+        case 'list':
+        default: storyList(rest, storiesDir); break;
+    }
+}
+
+// ── create ────────────────────────────────────────────────────────────────────
+function storyCreate(args, storiesDir, grimoireDir) {
+    const title = args.filter(a => !a.startsWith('--')).join(' ');
+    if (!title) {
+        console.log('Usage: grimoire story create "Título da story"\n');
+        return;
+    }
+    const stories = loadStories(storiesDir);
+    const id = nextId(stories);
+    const story = {
+        id,
+        title,
+        status: 'in_progress',
+        createdAt: new Date().toISOString(),
+        doneAt: null,
+        tags: [],
+        notes: [],
+    };
+    const filename = path.join(storiesDir, `${id}.json`);
+    fs.writeFileSync(filename, JSON.stringify(story, null, 2), 'utf8');
+
+    // Track in metrics
+    try {
+        const metricsDir = path.join(grimoireDir, 'metrics');
+        if (fs.existsSync(metricsDir)) {
+            const today = new Date().toISOString().split('T')[0];
+            const mFile = path.join(metricsDir, `${today}.jsonl`);
+            fs.appendFileSync(mFile, JSON.stringify({ timestamp: new Date().toISOString(), type: 'story_create', story: id, title }) + '\n');
+        }
+    } catch (_) { }
+
+    console.log(`\n✅ Story criada: [${id}] ${title}\n`);
+    console.log(`  Status: 🔄 em andamento`);
+    console.log(`  Para concluir: grimoire story done ${id}`);
+    console.log(`  Para ver: grimoire story show ${id}\n`);
+}
+
+// ── list ──────────────────────────────────────────────────────────────────────
+function storyList(args, storiesDir) {
+    const all = args.includes('--all');
+    const stories = loadStories(storiesDir);
+    const filtered = all ? stories : stories.filter(s => s.status !== 'done');
+
+    console.log(`\n📋 Stories${all ? '' : ' ativas'} (${filtered.length}):\n`);
+
+    if (filtered.length === 0) {
+        if (!all) {
+            console.log('  (nenhuma story ativa)');
+            console.log('  grimoire story create "Título" para criar uma nova\n');
+        } else {
+            console.log('  (nenhuma story)\n');
+        }
+        return;
+    }
+
+    const done = filtered.filter(s => s.status === 'done');
+    const open = filtered.filter(s => s.status !== 'done');
+
+    open.forEach(s => console.log(`  🔄 [${s.id}] ${s.title}`));
+    done.forEach(s => {
+        const d = s.doneAt ? ` — concluída ${s.doneAt.slice(0, 10)}` : '';
+        console.log(`  ✅ [${s.id}] ${s.title}${d}`);
+    });
+    console.log(`\n  grimoire story done <id>   ← marcar como concluída`);
+    console.log(`  grimoire story show <id>   ← ver detalhes\n`);
+}
+
+// ── done ──────────────────────────────────────────────────────────────────────
+function storyDone(id, storiesDir, grimoireDir) {
+    if (!id) { console.log('Usage: grimoire story done <id>\nEx:    grimoire story done US-001\n'); return; }
+    const storyFile = path.join(storiesDir, id.endsWith('.json') ? id : `${id}.json`);
+    if (!fs.existsSync(storyFile)) {
+        console.log(`❌ Story "${id}" not found. Use: grimoire story list\n`); return;
+    }
+    const story = JSON.parse(fs.readFileSync(storyFile, 'utf8'));
+    story.status = 'done';
+    story.doneAt = new Date().toISOString();
+    fs.writeFileSync(storyFile, JSON.stringify(story, null, 2), 'utf8');
+
+    // Track in metrics
+    try {
+        const metricsDir = path.join(grimoireDir, 'metrics');
+        if (fs.existsSync(metricsDir)) {
+            const today = new Date().toISOString().split('T')[0];
+            const mFile = path.join(metricsDir, `${today}.jsonl`);
+            fs.appendFileSync(mFile, JSON.stringify({ timestamp: new Date().toISOString(), type: 'story_complete', story: id, title: story.title }) + '\n');
+        }
+    } catch (_) { }
+
+    console.log(`\n✅ [${story.id}] ${story.title} — marcada como concluída! 🎉\n`);
+}
+
+// ── note ─────────────────────────────────────────────────────────────────────────
+function storyNote(id, args, storiesDir) {
+    if (!id) { console.log('Usage: grimoire story note <id> "nota"\n'); return; }
+    const note = args.filter(a => !a.startsWith('-')).join(' ');
+    if (!note) { console.log('Usage: grimoire story note <id> "nota"\n'); return; }
+    const storyFile = path.join(storiesDir, id.endsWith('.json') ? id : `${id}.json`);
+    if (!fs.existsSync(storyFile)) { console.log(`❌ Story "${id}" not found.\n`); return; }
+    const story = JSON.parse(fs.readFileSync(storyFile, 'utf8'));
+    story.notes = story.notes || [];
+    story.notes.push(note);
+    fs.writeFileSync(storyFile, JSON.stringify(story, null, 2), 'utf8');
+    console.log(`\n📝 Nota adicionada a [${id}]:\n  ${note}\n`);
+}
+
+// ── show ─────────────────────────────────────────────────────────────────────────
+function storyShow(id, storiesDir, grimoireDir) {
+    if (!id) { storyList([], storiesDir); return; }
+    const storyFile = path.join(storiesDir, id.endsWith('.json') ? id : `${id}.json`);
+    if (!fs.existsSync(storyFile)) {
+        console.log(`❌ Story "${id}" not found.\n`); return;
+    }
+    const s = JSON.parse(fs.readFileSync(storyFile, 'utf8'));
+    const statusIcon = s.status === 'done' ? '✅' : '🔄';
+    console.log(`\n${statusIcon} [${s.id}] ${s.title}`);
+    console.log(`${'\u2500'.repeat(50)}`);
+    console.log(`  Status:    ${s.status}`);
+    console.log(`  Criada:    ${s.createdAt.slice(0, 10)}`);
+    if (s.doneAt) console.log(`  Concluída: ${s.doneAt.slice(0, 10)}`);
+    if (s.notes && s.notes.length) {
+        console.log('\n  📝 Notas:');
+        s.notes.forEach(n => console.log(`    - ${n}`));
+    }
+    // Linked memory entries
+    if (grimoireDir) {
+        const sessionsDir = path.join(grimoireDir, 'memory', 'sessions');
+        if (fs.existsSync(sessionsDir)) {
+            const linked = [];
+            for (const f of fs.readdirSync(sessionsDir).filter(f => f.endsWith('.jsonl'))) {
+                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.story === s.id) linked.push({ date: f.slice(0, 10), ...e });
+                    } catch (_) { }
+                }
+            }
+            if (linked.length > 0) {
+                console.log('\n  🧠 Memórias linkadas:');
+                linked.forEach(e => {
+                    const tag = e.tag ? ` [#${e.tag}]` : '';
+                    console.log(`    ${e.date}  ${e.content}${tag}`);
+                });
+            }
+        }
+    }
+    console.log(`\n  grimoire story note ${s.id} "obs"  ← adicionar nota`);
+    console.log(`  grimoire memory save --story ${s.id} "texto"  ← linkar memória\n`);
+}
+
+// ── delete ────────────────────────────────────────────────────────────────────
+function storyDelete(id, storiesDir) {
+    if (!id) { console.log('Usage: grimoire story delete <id>\n'); return; }
+    const storyFile = path.join(storiesDir, id.endsWith('.json') ? id : `${id}.json`);
+    if (!fs.existsSync(storyFile)) { console.log(`❌ Story "${id}" not found.\n`); return; }
+    fs.unlinkSync(storyFile);
+    console.log(`✅ Story "${id}" removida.\n`);
+}
+
+// ── Public API for use by other modules ───────────────────────────────────────
+function getActiveStories(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)
+        .filter(s => s.status !== 'done')
+        .sort((a, b) => a.createdAt > b.createdAt ? -1 : 1);
+}
+
+function getAllStories(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);
+}
+
+module.exports = { run, getActiveStories, getAllStories };