@kernel.chat/kbot 3.65.0 → 3.67.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,7 +17,9 @@ 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 { captureUserBehavior } from './user-behavior.js';
 import { autoCompact, compressToolResult } from './context-manager.js';
 import { learnedRoute, recordRoute } from './learned-router.js';
 import { buildCacheablePrompt, createPromptSections } from './prompt-cache.js';
@@ -1003,8 +1005,12 @@ 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();
+    // Capture a behavior snapshot (what apps are open, active window, etc.)
+    // Non-blocking, macOS only, purely local storage
+    captureUserBehavior();
     // ── Gödel limits: detect undecidable loops and hand off to human ──
     const loopDetector = new LoopDetector({
         maxToolRepeats: 5,
@@ -1531,6 +1537,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 +1606,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 +1625,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);
@@ -1003,6 +1005,113 @@ async function main() {
             process.stderr.write(formatMachineProfile(profile));
         }
     });
+    // ── Watchdog — Service & System Status Dashboard ──
+    program
+        .command('watchdog')
+        .alias('wd')
+        .description('Service watchdog — live status of all kbot background services and system health')
+        .option('--json', 'Output as JSON')
+        .option('--restart <service>', 'Restart a specific service (email-agent, discovery, serve, discord, mlx, collective-sync, daemon, kbot-local)')
+        .action(async (opts) => {
+        const { getSystemHealth, getServiceStatus, restartService } = await import('./tools/watchdog.js');
+        // ── Restart mode ──
+        if (opts.restart) {
+            const result = restartService(opts.restart);
+            if (result.success) {
+                console.log();
+                console.log(`  ${chalk.hex('#4ADE80')('✓')} ${result.message}`);
+                console.log();
+            }
+            else {
+                console.log();
+                console.log(`  ${chalk.hex('#F87171')('✗')} ${result.message}`);
+                console.log();
+            }
+            return;
+        }
+        const h = getSystemHealth();
+        // ── JSON mode ──
+        if (opts.json) {
+            console.log(JSON.stringify(h, null, 2));
+            return;
+        }
+        // ── Dashboard rendering ──
+        const ACCENT = chalk.hex('#A78BFA');
+        const GREEN = chalk.hex('#4ADE80');
+        const YELLOW = chalk.hex('#FBBF24');
+        const RED = chalk.hex('#F87171');
+        const DIM = chalk.dim;
+        const running = h.services.filter(s => s.status === 'running').length;
+        const total = h.services.length;
+        const allUp = running === total;
+        // Box drawing
+        const W = 42;
+        const box = {
+            tl: '\u256D', tr: '\u256E', bl: '\u2570', br: '\u256F', h: '\u2500', v: '\u2502',
+            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 row = (content) => {
+            return ACCENT(box.v) + ' ' + box.pad(content, W - 2) + ' ' + ACCENT(box.v);
+        };
+        console.log();
+        console.log('  ' + ACCENT(`${box.tl}${box.h.repeat(W)}${box.tr}`));
+        console.log('  ' + row(`${ACCENT.bold('\u25C6 KBOT SYSTEM STATUS')}`));
+        console.log('  ' + ACCENT(`${box.tl}${box.h.repeat(W)}${box.tr}`.replace(box.tl, '\u251C').replace(box.tr, '\u2524')));
+        // Service count
+        const svcColor = allUp ? GREEN : running > 0 ? YELLOW : RED;
+        console.log('  ' + row(`Services:  ${svcColor(`${running}/${total} running`)}`));
+        // CPU
+        console.log('  ' + row(`CPU Load:  ${chalk.white(h.loadAvg)}`));
+        // RAM
+        console.log('  ' + row(`RAM:       ${chalk.white(h.memUsed)} / ${DIM(h.memTotal)}`));
+        // Disk
+        console.log('  ' + row(`Disk:      ${chalk.white(h.diskFree)} free ${DIM(`/ ${h.diskTotal}`)}`));
+        // Ollama
+        const ollamaColor = h.ollamaStatus === 'online' ? GREEN : RED;
+        const ollamaInfo = h.ollamaModels.length > 0 ? ` ${DIM(`(${h.ollamaModels.length} models)`)}` : '';
+        console.log('  ' + row(`Ollama:    ${ollamaColor(h.ollamaStatus)}${ollamaInfo}`));
+        // Dreams
+        console.log('  ' + row(`Dreams:    ${ACCENT(`${h.dreamCycles}`)} cycles, ${ACCENT(`${h.dreamInsights}`)} insights`));
+        // Memory
+        console.log('  ' + row(`Memory:    ${chalk.white(h.kbotMemorySize)}`));
+        console.log('  ' + ACCENT(`${box.bl}${box.h.repeat(W)}${box.br}`));
+        console.log();
+        // ── Services table ──
+        console.log(`  ${chalk.bold('SERVICES')}`);
+        console.log(`  ${DIM('\u2500'.repeat(64))}`);
+        for (const s of h.services) {
+            const icon = s.status === 'running' ? GREEN('\u2713')
+                : s.status === 'dead' ? RED('\u2717')
+                    : DIM('\u2500');
+            const nameStr = chalk.bold(s.shortName.padEnd(18));
+            const pidStr = s.pid ? DIM(`PID ${String(s.pid).padEnd(8)}`) : DIM('PID -'.padEnd(12));
+            let statusStr;
+            if (s.status === 'running') {
+                statusStr = `CPU ${chalk.white(s.cpu.padEnd(7))} MEM ${chalk.white(s.mem.padEnd(7))} up ${GREEN(s.uptime)}`;
+            }
+            else if (s.status === 'dead') {
+                statusStr = RED('dead — restart with: kbot wd --restart ' + s.shortName);
+            }
+            else {
+                statusStr = DIM('not loaded');
+            }
+            console.log(`  ${icon} ${nameStr} ${pidStr} ${statusStr}`);
+        }
+        console.log();
+        // Ollama model list
+        if (h.ollamaModels.length > 0) {
+            console.log(`  ${chalk.bold('OLLAMA MODELS')}`);
+            console.log(`  ${DIM('\u2500'.repeat(64))}`);
+            for (const m of h.ollamaModels) {
+                console.log(`  ${ACCENT('\u25B8')} ${chalk.white(m)}`);
+            }
+            console.log();
+        }
+    });
     program
         .command('hardware')
         .description('Detect your hardware tier and get personalized model recommendations for local AI')
@@ -2439,7 +2548,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 +2562,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:`);
@@ -4157,6 +4268,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

package/dist/collective-dreams.js

@@ -0,0 +1,182 @@
+// kbot Collective Dreams — Anonymized Dream Sharing
+//
+// The dream engine consolidates personal insights. This module prepares
+// those insights for anonymous sharing with the collective, and merges
+// collective wisdom back into the local journal.
+//
+// What gets shared (anonymized):
+//   - Dream category (pattern, preference, skill, project, music)
+//   - Keywords (stripped of names, paths, identifiers)
+//   - Generalized content (personal details removed, abstracted)
+//
+// What NEVER gets shared:
+//   - Raw insight content, file paths, project names, user identity
+//   - API keys, source code, conversation content
+//   - Anything from ~/.kbot/config.json
+//
+// The flywheel:
+//   Your dreams → anonymized → collective pool
+//   Collective pool → filtered, deduplicated → enriches your journal
+//   Every kbot dreamer makes every other kbot smarter.
+import { createHash } from 'node:crypto';
+// ── PII Stripping ──
+/** Patterns that indicate PII or project-specific content */
+const PII_PATTERNS = [
+    /\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Z|a-z]{2,}\b/g, // emails
+    /\b(?:\/[^\s/]+){2,}\b/g, // file paths
+    /\b(?:https?:\/\/)[^\s]+/g, // URLs
+    /\b(?:sk-|pk-|key-|token-|ghp_|gho_|kn_)[A-Za-z0-9_-]+/g, // API keys/tokens
+    /\b[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\b/gi, // UUIDs
+    /\b(?:Isaac|openclaw)\b/gi, // known user names
+];
+/** Words that should be stripped from keywords (project-specific, PII-ish) */
+const KEYWORD_BLOCKLIST = new Set([
+    'isaac', 'openclaw', 'kernel', 'kbot', 'supabase',
+    'eoxxpyixdieprsxlpwcs', 'isaacsight', 'isaachernandez',
+]);
+/** Strip PII from a text string, replacing matches with generic placeholders */
+function stripPII(text) {
+    let cleaned = text;
+    for (const pattern of PII_PATTERNS) {
+        cleaned = cleaned.replace(pattern, '[REDACTED]');
+    }
+    return cleaned;
+}
+/** Remove blocklisted and PII-ish keywords */
+function sanitizeKeywords(keywords) {
+    return keywords
+        .map(k => k.toLowerCase().trim())
+        .filter(k => k.length >= 2 &&
+        k.length <= 30 &&
+        !KEYWORD_BLOCKLIST.has(k) &&
+        !/^[0-9a-f-]{8,}$/.test(k) && // hex strings / UUIDs
+        !/[@/\\]/.test(k) // paths / emails
+    );
+}
+// ── Generalization ──
+/**
+ * Generalize insight content by:
+ *   1. Stripping PII
+ *   2. Replacing specific project/file references with generic terms
+ *   3. Keeping the abstract pattern intact
+ */
+function generalizeContent(content) {
+    let text = stripPII(content);
+    // Replace specific filenames with generic references
+    text = text.replace(/\b\w+\.(ts|tsx|js|jsx|py|rs|go|css|html|json|yaml|yml|toml)\b/g, '[file]');
+    // Replace specific variable/function names that look project-specific
+    // (camelCase or snake_case longer than 15 chars — likely domain-specific)
+    text = text.replace(/\b[a-z][a-zA-Z0-9]{15,}\b/g, '[identifier]');
+    text = text.replace(/\b[a-z][a-z0-9_]{15,}\b/g, '[identifier]');
+    // Collapse multiple [REDACTED] into one
+    text = text.replace(/(\[REDACTED\]\s*)+/g, '[REDACTED] ');
+    return text.trim();
+}
+// ── Core Functions ──
+/**
+ * Anonymize a single dream insight for collective sharing.
+ * Strips personal info, keeps only category, keywords, and generalized content.
+ */
+export function anonymizeDreamInsight(insight) {
+    const now = new Date().toISOString();
+    return {
+        category: insight.category,
+        keywords: sanitizeKeywords(insight.keywords),
+        generalizedContent: generalizeContent(insight.content),
+        contributorCount: 1,
+        firstSeen: now,
+        lastSeen: now,
+    };
+}
+/**
+ * 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 function prepareCollectiveDreams(insights) {
+    // Step 1: Filter to high-relevance only
+    const highRelevance = insights.filter(i => i.relevance > 0.7);
+    if (highRelevance.length === 0)
+        return [];
+    // Step 2: Anonymize
+    const anonymized = highRelevance.map(i => anonymizeDreamInsight(i));
+    // Step 3: Deduplicate by content hash
+    const seen = new Map();
+    for (const insight of anonymized) {
+        // Skip if generalized content is too short or entirely redacted
+        if (insight.generalizedContent.length < 10)
+            continue;
+        if (insight.generalizedContent.replace(/\[REDACTED\]/g, '').trim().length < 10)
+            continue;
+        const hash = createHash('sha256')
+            .update(insight.category + ':' + insight.generalizedContent.toLowerCase().replace(/\s+/g, ' '))
+            .digest('hex')
+            .slice(0, 16);
+        if (!seen.has(hash)) {
+            seen.set(hash, insight);
+        }
+        else {
+            // Merge: bump contributor count, keep the one with more keywords
+            const existing = seen.get(hash);
+            existing.contributorCount++;
+            if (insight.keywords.length > existing.keywords.length) {
+                existing.keywords = insight.keywords;
+            }
+        }
+    }
+    return Array.from(seen.values());
+}
+/**
+ * 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 function mergeCollectiveDreams(local, collective) {
+    const merged = [...local];
+    const now = new Date().toISOString();
+    // Build a set of content hashes from local insights for dedup
+    const localHashes = new Set();
+    for (const insight of local) {
+        const hash = createHash('sha256')
+            .update(insight.category + ':' + insight.content.toLowerCase().replace(/\s+/g, ' ').slice(0, 100))
+            .digest('hex')
+            .slice(0, 16);
+        localHashes.add(hash);
+    }
+    for (const collective_insight of collective) {
+        // Skip low-quality collective insights
+        if (collective_insight.generalizedContent.length < 10)
+            continue;
+        if (collective_insight.contributorCount < 2)
+            continue; // Need at least 2 contributors
+        // Check for duplication against local
+        const hash = createHash('sha256')
+            .update(collective_insight.category + ':' +
+            collective_insight.generalizedContent.toLowerCase().replace(/\s+/g, ' ').slice(0, 100))
+            .digest('hex')
+            .slice(0, 16);
+        if (localHashes.has(hash))
+            continue;
+        // Convert to DreamInsight with lower relevance
+        const dreamInsight = {
+            id: `collective_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`,
+            content: collective_insight.generalizedContent,
+            category: collective_insight.category,
+            keywords: collective_insight.keywords,
+            relevance: 0.5, // Lower base relevance for collective insights
+            sessions: collective_insight.contributorCount,
+            created: collective_insight.firstSeen,
+            lastReinforced: collective_insight.lastSeen,
+            source: `collective:${collective_insight.contributorCount}_contributors`,
+        };
+        merged.push(dreamInsight);
+        localHashes.add(hash); // Prevent duplicates within the collective batch
+    }
+    // Sort by relevance descending — local insights (higher relevance) surface first
+    merged.sort((a, b) => b.relevance - a.relevance);
+    return merged;
+}
+//# sourceMappingURL=collective-dreams.js.map

package/dist/dream.d.ts

@@ -18,7 +18,7 @@ export interface DreamInsight {
     /** Source: which sessions/topics generated this */
     source: string;
 }
-export type DreamCategory = 'pattern' | 'preference' | 'skill' | 'project' | 'relationship';
+export type DreamCategory = 'pattern' | 'preference' | 'skill' | 'project' | 'relationship' | 'music';
 export interface DreamState {
     /** Total dream cycles completed */
     cycles: number;
@@ -53,6 +53,7 @@ export interface ApplyResult {
     preferencesApplied: number;
     patternsHinted: number;
     factsLearned: number;
+    promptAmendments: number;
 }
 /** Run a full dream cycle — consolidate, reinforce, age */
 export declare function dream(sessionId?: string): Promise<DreamResult>;