@kernel.chat/kbot 3.64.0 → 3.66.0

package/README.md

@@ -2,7 +2,7 @@
 
 <p align="center">
   <strong>kbot</strong><br>
-  Open-source terminal AI agent. 35 agents. 670+ tools. 20 providers. Science, finance, security, and more.
+  Open-source terminal AI agent. 35 agents. 686+ tools. 20 providers. Science, finance, security, and more.
 </p>
 
 <p align="center">
@@ -30,17 +30,42 @@ Most terminal AI agents lock you into one provider, one model, one way of workin
 - **Runs fully offline** — Embedded llama.cpp, Ollama, LM Studio, or Jan. $0, fully private.
 - **Learns your patterns** — Bayesian skill ratings + pattern extraction. Gets faster over time.
 - **35 specialist agents** — auto-routes your request to the right expert (coder, researcher, writer, guardian, quant, and 30 more).
-- **670+ tools** — files, bash, git, GitHub, web search, deploy, database, game dev, VFX, research, science, finance, security, and more.
+- **686+ tools** — files, bash, git, GitHub, web search, deploy, database, game dev, VFX, research, science, finance, security, and more.
 - **Programmatic SDK** — use kbot as a library in your own apps.
 - **MCP server built in** — plug kbot into Claude Code, Cursor, VS Code, Zed, or Neovim as a tool provider.
 
+## Highlights
+
+### Dream Engine — Your AI Remembers You
+
+After each session, kbot "dreams" — consolidating what it learned about you into durable insights using local Ollama models. $0 cost. Insights feed back into future sessions automatically.
+
+```
+kbot dream run        # Trigger consolidation
+kbot dream status     # See what kbot learned
+kbot dream journal    # Full insight history
+kbot dream search     # Find specific memories
+```
+
+5-tier memory: pattern cache -> solution index -> user profile -> dream journal -> passive scanner. All tiers feed each other through the dream engine.
+
+### Audit Any Repo in One Command
+
+```
+kbot audit facebook/react
+kbot audit --share vercel/next.js   # Creates a public Gist
+kbot audit --badge your/repo        # Badge for your README
+```
+
+Checks security, documentation, code quality, CI/CD, community health, and DevOps. Scored out of 100, graded A-F. Add the badge to your README.
+
 ### How it compares
 
 | | kbot | Claude Code | Codex CLI | Aider | OpenCode |
 |---|---|---|---|---|---|
 | AI providers | 20 | 1 | 1 | 6 | 75+ |
 | Specialist agents | 35 | 0 | 0 | 0 | 0 |
-| Built-in tools | 600+ | ~20 | ~15 | ~10 | ~15 |
+| Built-in tools | 686+ | ~20 | ~15 | ~10 | ~15 |
 | Science tools | 114 | 0 | 0 | 0 | 0 |
 | Learning engine | Yes | No | No | No | No |
 | Offline mode | Embedded + Ollama | No | No | Ollama | Ollama |
@@ -93,7 +118,7 @@ kbot auto-routes to the right agent for each task. Or pick one with `--agent <na
 | **Domain** | infrastructure, quant, investigator, oracle, chronist, sage, communicator, adapter |
 | **Presets** | claude-code, cursor, copilot, creative, developer |
 
-## 600+ Tools
+## 686+ Tools
 
 | Category | Examples |
 |----------|---------|
@@ -185,7 +210,7 @@ graph TD
     D -->|Multi-step| F[Autonomous Planner]
     E --> G[Provider API + Tool Loop]
     F --> G
-    G --> H{600+ Tools}
+    G --> H{686+ Tools}
     H --> I[File ops, bash, git, GitHub, search, deploy, DB, game dev...]
     G --> J[Learning Engine]
     J --> K[Patterns + Solutions + User Profile]
@@ -218,7 +243,11 @@ Works with Claude Code, Cursor, VS Code, Windsurf, Zed, Neovim.
 | `kbot auth` | Configure API key |
 | `kbot local` | Use local AI (Ollama, embedded, LM Studio, Jan) |
 | `kbot serve` | Start HTTP REST + SSE streaming server |
-| `kbot audit <repo>` | Security + quality audit of any GitHub repo |
+| `kbot audit <repo>` | Security + quality audit of any GitHub repo (A-F grade) |
+| `kbot dream run` | Consolidate session learnings into durable insights |
+| `kbot dream status` | See what kbot has learned about you |
+| `kbot dream journal` | Full insight history |
+| `kbot dream search` | Find specific memories |
 | `kbot contribute <repo>` | Find good-first-issues and quick wins |
 | `kbot share` | Share conversation as GitHub Gist |
 | `kbot pair` | File watcher with auto-analysis |

package/dist/agent.js

@@ -17,6 +17,7 @@ import { getMatrixSystemPrompt } from './matrix.js';
 import { buildFullLearningContext, findPattern, recordPattern, cacheSolution, updateProfile, classifyTask, extractKeywords, learnFromExchange, updateProjectMemory, shouldAutoTrain, selfTrain, } from './learning.js';
 import { getMemoryPrompt, addTurn, getPreviousMessages, getHistory } from './memory.js';
 import { getDreamPrompt, dreamAfterSession } from './dream.js';
+import { setBuddyMood } from './buddy.js';
 import { notifyTurn, startMemoryScanner, stopMemoryScanner } from './memory-scanner.js';
 import { autoCompact, compressToolResult } from './context-manager.js';
 import { learnedRoute, recordRoute } from './learned-router.js';
@@ -1003,6 +1004,7 @@ Always quote file paths that contain spaces. Never reference internal system nam
         model: options.model || 'auto',
         message: originalMessage.slice(0, 200),
     });
+    setBuddyMood('thinking');
     // Start passive memory scanner for this session
     startMemoryScanner();
     // ── Gödel limits: detect undecidable loops and hand off to human ──
@@ -1531,6 +1533,8 @@ Always quote file paths that contain spaces. Never reference internal system nam
                 };
                 results.push(result);
                 ui.onToolCallEnd(call.name, result.result, result.error ? result.result : undefined, result.duration_ms);
+                // Update buddy mood based on tool outcome
+                setBuddyMood(result.error ? 'error' : 'success');
                 // ── Observer: record tool call for cross-session learning ──
                 try {
                     const { recordObservation } = await import('./observer.js');
@@ -1598,6 +1602,7 @@ Always quote file paths that contain spaces. Never reference internal system nam
         }
         catch (err) {
             spinnerHandle?.stop();
+            setBuddyMood('error');
             // ── Telemetry: session failure ──
             telemetry.emit('session_end', { status: 'failed', error: String(err), toolCallCount });
             telemetry.destroy().catch(() => { });
@@ -1616,7 +1621,10 @@ Always quote file paths that contain spaces. Never reference internal system nam
     // ── Memory Scanner: stop and persist session stats ──
     stopMemoryScanner();
     // ── Dream Engine: consolidate session memories (non-blocking, $0 via Ollama) ──
+    setBuddyMood('learning');
     dreamAfterSession(sessionId);
+    // Session complete — buddy returns to idle
+    setBuddyMood('idle');
     const content = lastResponse?.content || 'Reached maximum tool iterations.';
     return {
         content,

package/dist/cli.js

@@ -11,6 +11,7 @@
 import { createInterface } from 'node:readline';
 import { existsSync } from 'node:fs';
 import { join, basename } from 'node:path';
+import { homedir } from 'node:os';
 import { Command } from 'commander';
 import { loadConfig, setupByok, setupEmbedded, isByokEnabled, isLocalProvider, disableByok, detectProvider, getByokProvider, PROVIDERS, setupOllama, setupKbotLocal, isOllamaRunning, listOllamaModels, warmOllamaModelCache } from './auth.js';
 import { runAndPrint, runAgent, runAgentFromCheckpoint } from './agent.js';
@@ -26,6 +27,7 @@ import { banner, bannerCompact, bannerAuth, prompt as kbotPrompt, printError, pr
 import { checkForUpdate, selfUpdate } from './updater.js';
 import { runTutorial } from './tutorial.js';
 import { syncOnStartup, schedulePush, flushCloudSync, isCloudSyncEnabled, setCloudToken, getCloudToken } from './cloud-sync.js';
+import { getBuddy, getBuddyGreeting, formatBuddyStatus } from './buddy.js';
 import chalk from 'chalk';
 import { createRequire } from 'node:module';
 const __require = createRequire(import.meta.url);
@@ -2439,7 +2441,7 @@ async function main() {
         .option('--json', 'Output raw JSON')
         .option('--badge', 'Print only the badge markdown (for adding to READMEs)')
         .action(async (repo, auditOpts) => {
-        const { auditRepo, formatAuditReport } = await import('./tools/audit.js');
+        const { auditRepo, formatAuditReport, formatAuditTerminal } = await import('./tools/audit.js');
         printInfo(`Auditing ${repo}...`);
         try {
             const result = await auditRepo(repo);
@@ -2453,14 +2455,16 @@ async function main() {
                 console.log(`[![kbot audit: ${result.grade}](https://img.shields.io/badge/kbot_audit-${result.grade}_(${pct}%25)-${badgeColor})](https://www.npmjs.com/package/@kernel.chat/kbot)`);
                 return;
             }
-            const report = formatAuditReport(result);
-            console.log(report);
-            // Auto-share as gist
+            // Terminal gets the styled version; --share gist gets markdown
+            const terminalReport = formatAuditTerminal(result);
+            console.log(terminalReport);
+            // Auto-share as gist (uses markdown format for portability)
             if (auditOpts.share) {
                 printInfo('Sharing audit report...');
                 try {
+                    const markdownReport = formatAuditReport(result);
                     const { createGist } = await import('./share.js');
-                    const url = createGist(report, `kbot-audit-${repo.replace('/', '-')}.md`, `kbot Audit: ${repo} — Grade ${result.grade}`, true);
+                    const url = createGist(markdownReport, `kbot-audit-${repo.replace('/', '-')}.md`, `kbot Audit: ${repo} — Grade ${result.grade}`, true);
                     if (url?.startsWith('http')) {
                         printSuccess(`Shared! ${url}`);
                         printInfo(`Badge for ${repo}'s README:`);
@@ -3167,20 +3171,28 @@ async function main() {
         .description('Run a dream cycle now (uses local Ollama)')
         .action(async () => {
         const { dream } = await import('./dream.js');
-        printInfo('Dreaming... consolidating session memories with local AI');
+        console.log();
+        console.log(`  ${chalk.hex('#A78BFA')('◆')} ${chalk.bold('Dream Engine')}  ${chalk.dim('consolidating memories...')}`);
+        console.log();
         const result = await dream();
         if (result.success) {
-            printSuccess(`Dream cycle #${result.cycle} complete`);
-            console.log(`  New insights: ${result.newInsights}`);
-            console.log(`  Reinforced: ${result.reinforced}`);
-            console.log(`  Archived: ${result.archived} aged-out`);
-            console.log(`  Duration: ${result.duration}ms`);
+            console.log(`  ${chalk.hex('#4ADE80')('✓')} ${chalk.bold(`Cycle #${result.cycle} complete`)}  ${chalk.dim(`${result.duration}ms`)}`);
+            console.log();
+            console.log(`    ${chalk.hex('#4ADE80')('+')} ${chalk.bold(String(result.newInsights))} new insights`);
+            console.log(`    ${chalk.hex('#A78BFA')('↻')} ${chalk.bold(String(result.reinforced))} reinforced`);
+            if (result.archived > 0) {
+                console.log(`    ${chalk.dim('↓')} ${chalk.dim(`${result.archived} archived (aged out)`)}`);
+            }
+            console.log();
+            console.log(`  ${chalk.dim('View results:')} ${chalk.hex('#A78BFA')('kbot dream status')}`);
         }
         else {
-            printWarn(result.error || 'Dream cycle failed');
-            if (result.archived > 0)
-                console.log(`  (Still archived ${result.archived} aged-out insights)`);
+            console.log(`  ${chalk.hex('#FBBF24')('!')} ${result.error || 'Dream cycle failed'}`);
+            if (result.archived > 0) {
+                console.log(`    ${chalk.dim('↓')} ${chalk.dim(`${result.archived} insights archived (aging only)`)}`);
+            }
         }
+        console.log();
     });
     dreamCmd
         .command('status')
@@ -3188,23 +3200,86 @@ async function main() {
         .action(async () => {
         const { getDreamStatus } = await import('./dream.js');
         const { state, insights, archiveCount } = getDreamStatus();
-        console.log(chalk.bold('\nDream Engine'));
-        console.log(chalk.dim('═══════════════════'));
-        console.log(`Cycles:    ${state.cycles}`);
-        console.log(`Last:      ${state.lastDream || 'never'}`);
-        console.log(`Active:    ${state.activeInsights} insights`);
-        console.log(`Archived:  ${state.totalArchived} (${archiveCount} files)`);
+        // ── Helper functions ──
+        const W = 56; // inner width
+        const box = {
+            tl: '╭', tr: '╮', bl: '╰', br: '╯', h: '─', v: '│',
+            pad: (s, w) => {
+                // Pad string to width, accounting for chalk ANSI codes
+                const visible = s.replace(/\x1b\[[0-9;]*m/g, '');
+                const diff = w - visible.length;
+                return diff > 0 ? s + ' '.repeat(diff) : s;
+            },
+        };
+        const relevanceBar = (pct, len = 20) => {
+            const filled = Math.round((pct / 100) * len);
+            const empty = len - filled;
+            const color = pct >= 70 ? chalk.hex('#4ADE80') : pct >= 40 ? chalk.hex('#FBBF24') : chalk.hex('#F87171');
+            return color('█'.repeat(filled)) + chalk.dim('░'.repeat(empty));
+        };
+        const categoryColor = (cat) => {
+            const colors = {
+                pattern: '#A78BFA', preference: '#67E8F9', skill: '#4ADE80',
+                project: '#FB923C', relationship: '#F472B6',
+            };
+            return chalk.hex(colors[cat] || '#A78BFA');
+        };
+        const categoryChip = (cat) => {
+            const c = categoryColor(cat);
+            return c(` ${cat.toUpperCase()} `);
+        };
+        // ── Header box ──
+        console.log();
+        console.log(chalk.hex('#A78BFA')(`  ${box.tl}${box.h.repeat(W)}${box.tr}`));
+        console.log(chalk.hex('#A78BFA')(`  ${box.v}`) + box.pad(`  ${chalk.hex('#A78BFA').bold('◆ DREAM ENGINE')}  ${chalk.dim('memory consolidation')}`, W) + chalk.hex('#A78BFA')(box.v));
+        console.log(chalk.hex('#A78BFA')(`  ${box.bl}${box.h.repeat(W)}${box.br}`));
+        console.log();
+        // ── Stats row ──
+        const lastDreamDisplay = state.lastDream
+            ? new Date(state.lastDream).toLocaleDateString('en-US', { month: 'short', day: 'numeric', hour: '2-digit', minute: '2-digit' })
+            : chalk.dim('never');
+        console.log(`  ${chalk.bold('Cycles')}  ${chalk.hex('#A78BFA')(String(state.cycles))}    ${chalk.bold('Last')}  ${lastDreamDisplay}    ${chalk.bold('Active')}  ${chalk.hex('#4ADE80')(String(state.activeInsights))}`);
+        console.log(`  ${chalk.bold('Total')}   ${chalk.dim(String(state.totalInsights))}    ${chalk.bold('Archived')}  ${chalk.dim(`${state.totalArchived} (${archiveCount} files)`)}`);
+        console.log();
         if (insights.length > 0) {
+            // ── Average relevance bar ──
             const avgRel = Math.round(insights.reduce((s, i) => s + i.relevance, 0) / insights.length * 100);
-            console.log(`Avg relevance: ${avgRel}%`);
-            console.log(chalk.bold('\nTop insights:'));
+            console.log(`  ${chalk.bold('Avg Relevance')}  ${relevanceBar(avgRel, 24)}  ${chalk.bold(`${avgRel}%`)}`);
+            console.log();
+            // ── Category breakdown ──
+            const catCounts = {};
+            for (const i of insights)
+                catCounts[i.category] = (catCounts[i.category] || 0) + 1;
+            const chips = Object.entries(catCounts)
+                .sort((a, b) => b[1] - a[1])
+                .map(([cat, count]) => `${categoryChip(cat)} ${chalk.dim(`${count}`)}`)
+                .join('  ');
+            console.log(`  ${chalk.bold('Categories')}  ${chips}`);
+            console.log();
+            // ── Divider ──
+            console.log(chalk.dim(`  ${'─'.repeat(W)}`));
+            console.log();
+            // ── Top insights ──
+            console.log(`  ${chalk.bold('Top Insights')}`);
+            console.log();
             for (const i of insights.slice(0, 8)) {
                 const pct = Math.round(i.relevance * 100);
-                console.log(`  ${chalk.green(`${pct}%`)} [${chalk.cyan(i.category)}] ${i.content}`);
+                const bar = relevanceBar(pct, 12);
+                const tag = categoryChip(i.category);
+                console.log(`  ${bar} ${chalk.bold(`${pct}%`)}  ${tag}`);
+                console.log(`  ${chalk.white(i.content)}`);
+                if (i.keywords.length > 0) {
+                    console.log(`  ${chalk.dim(i.keywords.map(k => `#${k}`).join('  '))}  ${chalk.dim('·')}  ${chalk.dim(`${i.sessions} sessions`)}`);
+                }
+                console.log();
             }
         }
         else {
-            console.log(chalk.dim('\nNo insights yet. Run: kbot dream run'));
+            console.log(chalk.dim(`  ${'─'.repeat(W)}`));
+            console.log();
+            console.log(`  ${chalk.dim('No insights yet.')}`);
+            console.log(`  ${chalk.dim('Run:')} ${chalk.hex('#A78BFA')('kbot dream run')} ${chalk.dim('to start consolidating memories')}`);
+            console.log();
         }
     });
     dreamCmd
@@ -3213,24 +3288,137 @@ async function main() {
         .action(async (query) => {
         const { searchDreams } = await import('./dream.js');
         const results = searchDreams(query);
+        // Helpers
+        const relevanceBar = (pct, len = 12) => {
+            const filled = Math.round((pct / 100) * len);
+            const empty = len - filled;
+            const color = pct >= 70 ? chalk.hex('#4ADE80') : pct >= 40 ? chalk.hex('#FBBF24') : chalk.hex('#F87171');
+            return color('█'.repeat(filled)) + chalk.dim('░'.repeat(empty));
+        };
+        const categoryColor = (cat) => {
+            const colors = {
+                pattern: '#A78BFA', preference: '#67E8F9', skill: '#4ADE80',
+                project: '#FB923C', relationship: '#F472B6',
+            };
+            return chalk.hex(colors[cat] || '#A78BFA');
+        };
+        const highlightQuery = (text, q) => {
+            const terms = q.toLowerCase().split(/\s+/);
+            let result = text;
+            for (const term of terms) {
+                const regex = new RegExp(`(${term.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')})`, 'gi');
+                result = result.replace(regex, chalk.hex('#FBBF24').bold.underline('$1'));
+            }
+            return result;
+        };
         if (results.length === 0) {
-            printInfo(`No insights match "${query}"`);
+            console.log();
+            console.log(`  ${chalk.hex('#A78BFA')('◆')} ${chalk.bold('Dream Search')}  ${chalk.dim(`"${query}"`)}`);
+            console.log();
+            console.log(`  ${chalk.dim('No insights match this query.')}`);
+            console.log(`  ${chalk.dim('Try broader keywords or run')} ${chalk.hex('#A78BFA')('kbot dream run')} ${chalk.dim('first.')}`);
+            console.log();
             return;
         }
-        console.log(chalk.bold(`\n${results.length} insights matching "${query}":\n`));
+        console.log();
+        console.log(`  ${chalk.hex('#A78BFA')('◆')} ${chalk.bold('Dream Search')}  ${chalk.dim(`"${query}"`)}  ${chalk.hex('#4ADE80')(`${results.length} found`)}`);
+        console.log(chalk.dim(`  ${'─'.repeat(52)}`));
+        console.log();
         for (const i of results.slice(0, 15)) {
             const pct = Math.round(i.relevance * 100);
-            console.log(`  ${chalk.green(`${pct}%`)} [${chalk.cyan(i.category)}] ${i.content}`);
-            console.log(chalk.dim(`         ${i.keywords.join(', ')} | ${i.sessions} sessions | ${i.created.split('T')[0]}`));
+            const bar = relevanceBar(pct);
+            const tag = categoryColor(i.category)(` ${i.category.toUpperCase()} `);
+            console.log(`  ${bar} ${chalk.bold(`${pct}%`)}  ${tag}`);
+            console.log(`  ${highlightQuery(i.content, query)}`);
+            const keywordsHighlighted = i.keywords.map(k => highlightQuery(`#${k}`, query)).join('  ');
+            console.log(`  ${keywordsHighlighted}  ${chalk.dim('·')}  ${chalk.dim(`${i.sessions} sessions`)}  ${chalk.dim('·')}  ${chalk.dim(i.created.split('T')[0])}`);
+            console.log();
         }
     });
     dreamCmd
         .command('journal')
         .description('Print the full dream journal')
         .action(async () => {
-        const { getDreamPrompt } = await import('./dream.js');
-        const journal = getDreamPrompt(50);
-        console.log(journal || chalk.dim('Dream journal is empty. Run: kbot dream run'));
+        const { getDreamStatus } = await import('./dream.js');
+        const { state, insights } = getDreamStatus();
+        // Helpers
+        const W = 56;
+        const box = {
+            tl: '╭', tr: '╮', bl: '╰', br: '╯', h: '─', v: '│',
+            pad: (s, w) => {
+                const visible = s.replace(/\x1b\[[0-9;]*m/g, '');
+                const diff = w - visible.length;
+                return diff > 0 ? s + ' '.repeat(diff) : s;
+            },
+        };
+        const relevanceBar = (pct, len = 16) => {
+            const filled = Math.round((pct / 100) * len);
+            const empty = len - filled;
+            const color = pct >= 70 ? chalk.hex('#4ADE80') : pct >= 40 ? chalk.hex('#FBBF24') : chalk.hex('#F87171');
+            return color('█'.repeat(filled)) + chalk.dim('░'.repeat(empty));
+        };
+        const categoryColors = {
+            pattern: '#A78BFA', preference: '#67E8F9', skill: '#4ADE80',
+            project: '#FB923C', relationship: '#F472B6',
+        };
+        const categoryIcon = {
+            pattern: '◇', preference: '♡', skill: '⚡', project: '▸', relationship: '◈',
+        };
+        const categoryColor = (cat) => chalk.hex(categoryColors[cat] || '#A78BFA');
+        if (insights.length === 0) {
+            console.log();
+            console.log(`  ${chalk.hex('#A78BFA')('◆')} ${chalk.bold('Dream Journal')}`);
+            console.log();
+            console.log(`  ${chalk.dim('The journal is empty.')}`);
+            console.log(`  ${chalk.dim('Run')} ${chalk.hex('#A78BFA')('kbot dream run')} ${chalk.dim('after a session to consolidate memories.')}`);
+            console.log();
+            return;
+        }
+        // ── Header ──
+        console.log();
+        console.log(chalk.hex('#A78BFA')(`  ${box.tl}${box.h.repeat(W)}${box.tr}`));
+        const headerContent = `  ${chalk.hex('#A78BFA').bold('◆ DREAM JOURNAL')}  ${chalk.dim(`${insights.length} insights · cycle ${state.cycles}`)}`;
+        console.log(chalk.hex('#A78BFA')(`  ${box.v}`) + box.pad(headerContent, W) + chalk.hex('#A78BFA')(box.v));
+        console.log(chalk.hex('#A78BFA')(`  ${box.bl}${box.h.repeat(W)}${box.br}`));
+        console.log();
+        // ── Group by category ──
+        const grouped = {};
+        for (const i of insights) {
+            if (!grouped[i.category])
+                grouped[i.category] = [];
+            grouped[i.category].push(i);
+        }
+        // Sort categories by total insight count descending
+        const catOrder = Object.entries(grouped).sort((a, b) => b[1].length - a[1].length);
+        for (const [cat, catInsights] of catOrder) {
+            const icon = categoryIcon[cat] || '●';
+            const cc = categoryColor(cat);
+            // ── Category section header ──
+            console.log(`  ${cc(`${icon} ${cat.toUpperCase()}`)}  ${chalk.dim(`(${catInsights.length})`)}`);
+            console.log(`  ${cc('─'.repeat(W))}`);
+            console.log();
+            for (const i of catInsights) {
+                const pct = Math.round(i.relevance * 100);
+                const bar = relevanceBar(pct);
+                const date = i.created.split('T')[0];
+                const reinforced = i.lastReinforced !== i.created
+                    ? chalk.dim(` · reinforced ${i.lastReinforced.split('T')[0]}`)
+                    : '';
+                // Card: relevance bar + content + metadata
+                console.log(`  ${bar} ${chalk.bold(`${pct}%`)}  ${chalk.dim(`${i.sessions} sessions`)}${reinforced}`);
+                console.log(`  ${chalk.white(i.content)}`);
+                if (i.keywords.length > 0) {
+                    console.log(`  ${chalk.dim(i.keywords.map(k => `#${k}`).join('  '))}`);
+                }
+                console.log(`  ${chalk.dim(`${date} · ${i.source} · ${i.id}`)}`);
+                console.log();
+            }
+        }
+        // ── Footer ──
+        console.log(chalk.dim(`  ${'─'.repeat(W)}`));
+        const avgRel = Math.round(insights.reduce((s, i) => s + i.relevance, 0) / insights.length * 100);
+        console.log(`  ${chalk.dim(`${insights.length} active insights · avg relevance ${avgRel}% · ${state.totalArchived} archived`)}`);
+        console.log();
     });
     program.parse(process.argv);
     const opts = program.opts();
@@ -3973,6 +4161,17 @@ async function startRepl(agentOpts, context, tier, byokActive = false, localActi
             printInfo(`${p.name}`);
     }
     const sessionCount = incrementSessions();
+    // Buddy greeting — Tamagotchi companion appears at startup
+    {
+        const buddy = getBuddy();
+        const isFirstRun = sessionCount <= 1 && !existsSync(join(homedir(), '.kbot', 'config.json'));
+        const greeting = isFirstRun
+            ? `Hey! I'm ${buddy.name} the ${buddy.species}. Let's set up your API key!`
+            : getBuddyGreeting();
+        console.log();
+        console.log(formatBuddyStatus(greeting));
+        console.log();
+    }
     // Seed knowledge on first run — give new users a head start
     if (sessionCount <= 2) {
         try {

package/dist/collective-dreams.d.ts

@@ -0,0 +1,36 @@
+import type { DreamInsight, DreamCategory } from './dream.js';
+export interface AnonymizedInsight {
+    /** Category preserved as-is */
+    category: DreamCategory;
+    /** Keywords with PII stripped */
+    keywords: string[];
+    /** Generalized version of the content (no personal details) */
+    generalizedContent: string;
+    /** How many contributors have shared similar insights */
+    contributorCount: number;
+    /** First time this insight appeared in the collective */
+    firstSeen: string;
+    /** Most recent contribution timestamp */
+    lastSeen: string;
+}
+/**
+ * Anonymize a single dream insight for collective sharing.
+ * Strips personal info, keeps only category, keywords, and generalized content.
+ */
+export declare function anonymizeDreamInsight(insight: DreamInsight): AnonymizedInsight;
+/**
+ * Prepare a batch of dream insights for collective sharing.
+ *   1. Filter to high-relevance insights (> 0.7)
+ *   2. Anonymize each
+ *   3. Deduplicate by content similarity
+ */
+export declare function prepareCollectiveDreams(insights: DreamInsight[]): AnonymizedInsight[];
+/**
+ * Merge collective wisdom into the local dream journal.
+ *
+ * Collective insights are injected with a lower base relevance (0.5) so they
+ * don't drown out the user's own insights but still surface when relevant.
+ * Deduplicates against existing local insights by content similarity.
+ */
+export declare function mergeCollectiveDreams(local: DreamInsight[], collective: AnonymizedInsight[]): DreamInsight[];
+//# sourceMappingURL=collective-dreams.d.ts.map