bobo-ai-cli 2.1.0 → 3.0.1

package/dist/dream.js

@@ -0,0 +1,324 @@
+/**
+ * KAIROS Dream Mode — Memory consolidation and insight extraction
+ *
+ * Inspired by biological memory consolidation during sleep, this module
+ * processes accumulated experiences and distills them into structured knowledge.
+ *
+ * Features:
+ * - /dream command to manually trigger consolidation
+ * - Auto-trigger on session-end if sufficient new experiences
+ * - LLM-powered distillation of logs → structured preferences & learnings
+ * - Deduplication and organization of memory entries
+ */
+import { readFileSync, writeFileSync, readdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import OpenAI from 'openai';
+import { loadConfig } from './config.js';
+import { getMemoryDir } from './memory.js';
+/**
+ * Determine if dream mode should be triggered automatically.
+ * Criteria:
+ * - More than 50 new memory entries since last consolidation
+ * - Last consolidation was more than 24 hours ago
+ */
+export function shouldAutoDream() {
+    const memoryDir = getMemoryDir();
+    if (!existsSync(memoryDir))
+        return false;
+    const lastDreamPath = join(memoryDir, '.last-dream');
+    let lastDreamTime = 0;
+    if (existsSync(lastDreamPath)) {
+        try {
+            lastDreamTime = parseInt(readFileSync(lastDreamPath, 'utf-8'), 10);
+        }
+        catch (_) {
+            /* intentionally ignored: optional dream source unreadable */
+            // Invalid timestamp, treat as never dreamed
+        }
+    }
+    const now = Date.now();
+    const hoursSinceLastDream = (now - lastDreamTime) / (1000 * 60 * 60);
+    // Check if more than 24 hours since last dream
+    if (hoursSinceLastDream < 24)
+        return false;
+    // Count memory entries
+    const files = readdirSync(memoryDir).filter(f => f.endsWith('.md') || f.endsWith('.txt'));
+    let entryCount = 0;
+    for (const file of files) {
+        try {
+            const content = readFileSync(join(memoryDir, file), 'utf-8');
+            // Count entries (rough heuristic: lines starting with - or ##)
+            entryCount += (content.match(/^[-#]/gm) || []).length;
+        }
+        catch (_) {
+            /* intentionally ignored: optional dream source unreadable */
+            // Skip unreadable files
+        }
+    }
+    return entryCount > 50;
+}
+/**
+ * Run dream mode consolidation.
+ */
+export async function runDream(options = {}) {
+    const config = loadConfig();
+    const memoryDir = getMemoryDir();
+    if (!existsSync(memoryDir)) {
+        return {
+            insights: [],
+            preferencesUpdated: 0,
+            duplicatesRemoved: 0,
+            summary: 'No memory directory found. Nothing to consolidate.',
+        };
+    }
+    // Step 1: Load all memory files
+    const memoryContent = loadAllMemories(memoryDir);
+    if (memoryContent.length === 0) {
+        return {
+            insights: [],
+            preferencesUpdated: 0,
+            duplicatesRemoved: 0,
+            summary: 'No memory content found.',
+        };
+    }
+    // Step 2: Use LLM to distill insights
+    const insights = await distillInsights(memoryContent, config);
+    // Step 3: Deduplicate and organize
+    const { preferencesUpdated, duplicatesRemoved } = options.dryRun
+        ? { preferencesUpdated: 0, duplicatesRemoved: 0 }
+        : consolidateMemories(insights, memoryDir);
+    // Step 4: Record dream timestamp
+    if (!options.dryRun) {
+        writeFileSync(join(memoryDir, '.last-dream'), Date.now().toString());
+    }
+    const summary = generateDreamSummary(insights, preferencesUpdated, duplicatesRemoved);
+    return {
+        insights,
+        preferencesUpdated,
+        duplicatesRemoved,
+        summary,
+    };
+}
+/**
+ * Load all memory files into a single text blob.
+ */
+function loadAllMemories(memoryDir) {
+    const files = readdirSync(memoryDir).filter(f => (f.endsWith('.md') || f.endsWith('.txt')) && !f.startsWith('.'));
+    const sections = [];
+    for (const file of files) {
+        try {
+            const content = readFileSync(join(memoryDir, file), 'utf-8');
+            if (content.trim()) {
+                sections.push(`## Source: ${file}\n\n${content}`);
+            }
+        }
+        catch (_) {
+            /* intentionally ignored: optional dream source unreadable */
+            // Skip unreadable files
+        }
+    }
+    return sections.join('\n\n---\n\n');
+}
+/**
+ * Use LLM to distill insights from memory content.
+ */
+async function distillInsights(memoryContent, config) {
+    if (!config.apiKey) {
+        throw new Error('API key not configured');
+    }
+    const client = new OpenAI({
+        apiKey: config.apiKey,
+        baseURL: config.baseUrl,
+    });
+    const prompt = `You are analyzing accumulated memory logs to extract structured insights.
+
+Memory Content:
+${memoryContent.slice(0, 20000)} ${memoryContent.length > 20000 ? '\n\n[... truncated ...]' : ''}
+
+Task: Extract and categorize insights from these memories.
+
+Categories:
+1. user-preference: User's explicit preferences, habits, or corrections
+2. technical-pattern: Code patterns, architectural decisions, or technical learnings
+3. project-context: Project-specific knowledge, file structure, or domain concepts
+4. workflow-optimization: Process improvements, shortcuts, or efficiency tips
+
+For each insight:
+- Provide clear, actionable content
+- Assign confidence level (high/medium/low)
+- Note which source it came from
+
+Output format (JSON array):
+[
+  {
+    "category": "user-preference",
+    "content": "User prefers TypeScript strict mode and explicit type annotations",
+    "confidence": "high",
+    "source": "user.md"
+  },
+  ...
+]
+
+Output ONLY the JSON array, no explanation:`;
+    try {
+        const completion = await client.chat.completions.create({
+            model: config.model,
+            messages: [{ role: 'user', content: prompt }],
+            temperature: 0.3, // Lower temperature for consistent extraction
+            max_tokens: 2000,
+        });
+        const response = completion.choices[0]?.message?.content || '[]';
+        // Extract JSON from response (might be wrapped in code blocks)
+        const jsonMatch = response.match(/\[[\s\S]*\]/);
+        const jsonText = jsonMatch ? jsonMatch[0] : '[]';
+        const insights = JSON.parse(jsonText);
+        return insights;
+    }
+    catch (e) {
+        console.error('Failed to distill insights:', e.message);
+        return [];
+    }
+}
+/**
+ * Consolidate insights into memory files, removing duplicates.
+ */
+function consolidateMemories(insights, memoryDir) {
+    let preferencesUpdated = 0;
+    let duplicatesRemoved = 0;
+    // Group insights by category
+    const grouped = new Map();
+    for (const insight of insights) {
+        const category = insight.category;
+        if (!grouped.has(category)) {
+            grouped.set(category, []);
+        }
+        grouped.get(category).push(insight);
+    }
+    // Write consolidated insights to category files
+    for (const [category, categoryInsights] of grouped.entries()) {
+        const fileName = categoryToCategoryFile(category);
+        const filePath = join(memoryDir, fileName);
+        // Load existing content
+        let existingContent = '';
+        if (existsSync(filePath)) {
+            existingContent = readFileSync(filePath, 'utf-8');
+        }
+        // Deduplicate: only add insights that aren't already present
+        const newInsights = [];
+        for (const insight of categoryInsights) {
+            if (!existingContent.includes(insight.content)) {
+                newInsights.push(`- ${insight.content} (confidence: ${insight.confidence})`);
+                preferencesUpdated++;
+            }
+            else {
+                duplicatesRemoved++;
+            }
+        }
+        // Append new insights
+        if (newInsights.length > 0) {
+            const timestamp = new Date().toISOString().split('T')[0];
+            const newSection = `\n\n## Consolidated: ${timestamp}\n\n${newInsights.join('\n')}`;
+            writeFileSync(filePath, existingContent + newSection);
+        }
+    }
+    return { preferencesUpdated, duplicatesRemoved };
+}
+/**
+ * Map insight category to memory file name.
+ */
+function categoryToCategoryFile(category) {
+    switch (category) {
+        case 'user-preference':
+            return 'user.md';
+        case 'technical-pattern':
+            return 'experience.md';
+        case 'project-context':
+            return 'project.md';
+        case 'workflow-optimization':
+            return 'reference.md';
+        default:
+            return 'feedback.md';
+    }
+}
+/**
+ * Generate human-readable dream summary.
+ */
+function generateDreamSummary(insights, preferencesUpdated, duplicatesRemoved) {
+    const lines = [];
+    lines.push('🌙 Dream Mode Consolidation Complete');
+    lines.push('');
+    lines.push(`✨ Extracted ${insights.length} insights from memory logs`);
+    lines.push(`📝 Updated ${preferencesUpdated} preferences`);
+    lines.push(`🗑️  Removed ${duplicatesRemoved} duplicate entries`);
+    lines.push('');
+    // Group by category
+    const grouped = new Map();
+    for (const insight of insights) {
+        if (!grouped.has(insight.category)) {
+            grouped.set(insight.category, []);
+        }
+        grouped.get(insight.category).push(insight);
+    }
+    lines.push('Insights by category:');
+    for (const [category, categoryInsights] of grouped.entries()) {
+        const highConf = categoryInsights.filter(i => i.confidence === 'high').length;
+        lines.push(`  • ${category}: ${categoryInsights.length} insights (${highConf} high confidence)`);
+    }
+    lines.push('');
+    lines.push('Memory has been consolidated and organized. 💤');
+    return lines.join('\n');
+}
+/**
+ * Format dream result for user display.
+ */
+export function formatDreamResult(result) {
+    const lines = [];
+    lines.push('');
+    lines.push('╔═══════════════════════════════════════════════════════════════');
+    lines.push('║ 🌙 KAIROS DREAM MODE — Memory Consolidation');
+    lines.push('╠═══════════════════════════════════════════════════════════════');
+    lines.push(`║ ${result.summary.split('\n')[0]}`);
+    lines.push('╠═══════════════════════════════════════════════════════════════');
+    if (result.insights.length > 0) {
+        lines.push('║ TOP INSIGHTS:');
+        lines.push('║');
+        // Show top 5 high-confidence insights
+        const topInsights = result.insights
+            .filter(i => i.confidence === 'high')
+            .slice(0, 5);
+        for (const insight of topInsights) {
+            const icon = getCategoryIcon(insight.category);
+            lines.push(`║ ${icon} ${insight.content.slice(0, 55)}`);
+            if (insight.content.length > 55) {
+                lines.push(`║     ${insight.content.slice(55, 110)}`);
+            }
+            lines.push('║');
+        }
+    }
+    lines.push('╠═══════════════════════════════════════════════════════════════');
+    lines.push(`║ Statistics:`);
+    lines.push(`║   • ${result.insights.length} insights extracted`);
+    lines.push(`║   • ${result.preferencesUpdated} new entries added`);
+    lines.push(`║   • ${result.duplicatesRemoved} duplicates removed`);
+    lines.push('╚═══════════════════════════════════════════════════════════════');
+    lines.push('');
+    return lines.join('\n');
+}
+/**
+ * Get icon for insight category.
+ */
+function getCategoryIcon(category) {
+    switch (category) {
+        case 'user-preference':
+            return '👤';
+        case 'technical-pattern':
+            return '🔧';
+        case 'project-context':
+            return '📁';
+        case 'workflow-optimization':
+            return '⚡';
+        default:
+            return '💡';
+    }
+}
+//# sourceMappingURL=dream.js.map

package/dist/dream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dream.js","sourceRoot":"","sources":["../src/dream.ts"],"names":[],"mappings":"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"}

package/dist/hooks.d.ts

@@ -11,7 +11,7 @@
  *   post-commit — after git commit
  *   session-end — when REPL exits
  */
-export type HookEvent = 'pre-edit' | 'post-edit' | 'pre-shell' | 'post-shell' | 'pre-commit' | 'post-commit' | 'session-end';
+export type HookEvent = 'pre-edit' | 'post-edit' | 'pre-shell' | 'post-shell' | 'pre-commit' | 'post-commit' | 'pre-tool-use' | 'post-tool-use' | 'session-end';
 interface HookConfig {
     [event: string]: string[];
 }

package/dist/hooks.js

@@ -40,7 +40,7 @@ export function loadHooks() {
                     }
                 }
             }
-            catch { /* skip malformed */ }
+            catch (_) { /* intentionally ignored: skip malformed hook config */ }
         }
     }
     cachedHooks = merged;
@@ -66,7 +66,8 @@ export function runHooks(event, context) {
                 cwd: process.cwd(),
             });
         }
-        catch {
+        catch (_) {
+            /* intentionally ignored: hook script execution failure */
             allOk = false;
         }
     }
@@ -89,6 +90,8 @@ export function initHooksTemplate() {
         'post-shell': [],
         'pre-commit': [],
         'post-commit': [],
+        'pre-tool-use': [],
+        'post-tool-use': [],
         'session-end': [],
         '_examples': {
             'pre-edit': ['echo "Editing: $BOBO_FILE"'],
@@ -96,6 +99,8 @@ export function initHooksTemplate() {
             'pre-shell': ['echo "Running: $BOBO_COMMAND"'],
             'pre-commit': ['npm run lint'],
             'post-commit': ['echo "Committed: $BOBO_COMMIT_MSG"'],
+            'pre-tool-use': ['echo "Tool: $BOBO_TOOL_NAME (risk: $BOBO_TOOL_RISK)"'],
+            'post-tool-use': ['echo "Tool completed: $BOBO_TOOL_NAME"'],
         },
     }, null, 2);
 }

package/dist/hooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"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"}