@timmeck/brain-core 2.36.24 → 2.36.26

package/dist/proactive/__tests__/proactive-engine.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proactive-engine.test.js","sourceRoot":"","sources":["../../../src/proactive/__tests__/proactive-engine.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC,EAAE,CAAC,IAAI,CAAC,uBAAuB,EAAE,GAAG,EAAE,CAAC,CAAC;IACtC,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;QAChB,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE;KAC7D,CAAC;CACH,CAAC,CAAC,CAAC;AAEJ,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAEhF,SAAS,QAAQ;IACf,OAAO,IAAI,QAAQ,CAAC,UAAU,CAAC,CAAC;AAClC,CAAC;AAED,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,IAAI,EAAqB,CAAC;IAE1B,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,GAAG,QAAQ,EAAE,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;QAC9D,MAAM,EAAE,GAAG,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,GAAG,CAAC,CAAC;QACpG,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEtB,MAAM,WAAW,GAAG,MAAM,CAAC,cAAc,EAAE,CAAC;QAC5C,MAAM,CAAC,WAAW,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACtD,MAAM,CAAC,WAAW,CAAC,CAAC,CAAE,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC3C,MAAM,CAAC,WAAW,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;QAC9D,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;QAC1E,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,eAAe,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;QAC5E,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;QAE1E,MAAM,WAAW,GAAG,MAAM,CAAC,cAAc,EAAE,CAAC;QAC5C,MAAM,CAAC,WAAW,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QACpD,MAAM,CAAC,WAAW,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACnD,MAAM,CAAC,WAAW,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAChC,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;QAC9D,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;QAEtD,MAAM,MAAM,GAAG,MAAM,CAAC,cAAc,EAAE,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAE/B,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,EAAG,CAAC,CAAC;QAE/B,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,EAAE,CAAC;QACtC,MAAM,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,EAAE;YACrC,SAAS,EAAE,MAAM;YACjB,qBAAqB,EAAE,CAAC;SACzB,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzD,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1D,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,eAAe;IAC5E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,EAAE;YACrC,SAAS,EAAE,MAAM;YACjB,kBAAkB,EAAE,CAAC;SACtB,CAAC,CAAC;QAEH,yCAAyC;QACzC,EAAE,CAAC,IAAI,CAAC;;;;;;KAMP,CAAC,CAAC;QACH,wCAAwC;QACxC,MAAM,MAAM,GAAG,EAAE,CAAC,OAAO,CAAC,+DAA+D,CAAC,CAAC;QAC3F,MAAM,CAAC,GAAG,CAAC,cAAc,EAAE,8BAA8B,CAAC,CAAC;QAC3D,MAAM,CAAC,GAAG,CAAC,cAAc,EAAE,8BAA8B,CAAC,CAAC;QAC3D,MAAM,CAAC,GAAG,CAAC,cAAc,EAAE,8BAA8B,CAAC,CAAC;QAE3D,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACvC,MAAM,CAAC,OAAO,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;QAE1C,MAAM,WAAW,GAAG,MAAM,CAAC,cAAc,EAAE,CAAC;QAC5C,MAAM,eAAe,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,iBAAiB,CAAC,CAAC;QAC5E,MAAM,CAAC,eAAe,CAAC,CAAC,WAAW,EAAE,CAAC;QACtC,MAAM,CAAC,eAAgB,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,GAAG,EAAE;QACxC,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,EAAE;YACrC,SAAS,EAAE,MAAM;YACjB,SAAS,EAAE,EAAE;SACd,CAAC,CAAC;QAEH,yDAAyD;QACzD,EAAE,CAAC,IAAI,CAAC;;;;;;;KAOP,CAAC,CAAC;QACH,EAAE,CAAC,OAAO,CAAC;;;KAGV,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAEpB,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACvC,MAAM,CAAC,OAAO,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;QAE1C,MAAM,WAAW,GAAG,MAAM,CAAC,cAAc,EAAE,CAAC;QAC5C,MAAM,eAAe,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,iBAAiB,CAAC,CAAC;QAC5E,MAAM,CAAC,eAAe,CAAC,CAAC,WAAW,EAAE,CAAC;QACtC,MAAM,CAAC,eAAgB,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;QAC1C,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;QAC9D,MAAM,CAAC,gBAAgB,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QACzC,MAAM,CAAC,gBAAgB,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QAEzC,MAAM,WAAW,GAAG,MAAM,CAAC,cAAc,EAAE,CAAC;QAC5C,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAE,CAAC,EAAG,CAAC,CAAC;QAEpC,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;QAClC,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACxC,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACzC,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,sBAAsB;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjC,MAAM,OAAO,GAAG,IAAI,eAAe,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;QAC/D,OAAO,CAAC,gBAAgB,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;QAEvD,sBAAsB;QACtB,qBAAqB,CAAC,EAAE,CAAC,CAAC;QAC1B,MAAM,OAAO,GAAG,IAAI,eAAe,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;QAE/D,MAAM,WAAW,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;QAC7C,MAAM,CAAC,WAAW,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;QAC9D,wDAAwD;QACxD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACvC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;QAC9D,MAAM,CAAC,gBAAgB,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QACxC,MAAM,CAAC,gBAAgB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAEvC,MAAM,GAAG,GAAG,MAAM,CAAC,cAAc,EAAE,CAAC;QACpC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAE,CAAC,EAAG,CAAC,CAAC;QAEzD,MAAM,MAAM,GAAG,MAAM,CAAC,cAAc,EAAE,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAEzC,MAAM,aAAa,GAAG,MAAM,CAAC,cAAc,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QACtD,MAAM,CAAC,aAAa,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAClD,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;QAC9D,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9D,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY;QAE5E,MAAM,WAAW,GAAG,MAAM,CAAC,cAAc,EAAE,CAAC;QAC5C,MAAM,CAAC,WAAW,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;QAE9D,0BAA0B;QAC1B,EAAE,CAAC,IAAI,CAAC;;;;;;;;;;KAUP,CAAC,CAAC;QAEH,qDAAqD;QACrD,MAAM,MAAM,GAAG,EAAE,CAAC,OAAO,CAAC,2DAA2D,CAAC,CAAC;QACvF,MAAM,CAAC,GAAG,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC;QACvC,MAAM,CAAC,GAAG,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC;QACvC,MAAM,CAAC,GAAG,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC;QAEvC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACvC,MAAM,CAAC,OAAO,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;QAE1C,MAAM,WAAW,GAAG,MAAM,CAAC,cAAc,EAAE,CAAC;QAC5C,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;QAC/D,MAAM,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;QAC/B,MAAM,CAAC,QAAS,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/proactive/index.d.ts

@@ -0,0 +1,2 @@
+export { ProactiveEngine, runProactiveMigration } from './proactive-engine.js';
+export type { ProactiveEngineConfig, ProactiveDataSources, ProactiveSuggestion, Suggestion, ProactiveStatus, } from './proactive-engine.js';

package/dist/proactive/index.js

@@ -0,0 +1,2 @@
+export { ProactiveEngine, runProactiveMigration } from './proactive-engine.js';
+//# sourceMappingURL=index.js.map

package/dist/proactive/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/proactive/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/proactive/proactive-engine.d.ts

@@ -0,0 +1,86 @@
+import type Database from 'better-sqlite3';
+import type { ThoughtStream } from '../consciousness/thought-stream.js';
+import type { LLMService } from '../llm/llm-service.js';
+export interface ProactiveEngineConfig {
+    brainName: string;
+    maxSuggestionsPerHour?: number;
+    staleDays?: number;
+    recurringThreshold?: number;
+}
+export interface ProactiveDataSources {
+    db: Database.Database;
+}
+export interface ProactiveSuggestion {
+    id?: number;
+    type: string;
+    title: string;
+    description: string | null;
+    action: string | null;
+    priority: number;
+    dismissed: number;
+    created_at: string;
+}
+/** Alias for convenience */
+export type Suggestion = ProactiveSuggestion;
+export interface ProactiveStatus {
+    totalSuggestions: number;
+    activeSuggestions: number;
+    dismissedCount: number;
+    lastAnalysis: string | null;
+}
+export declare function runProactiveMigration(db: Database.Database): void;
+export declare class ProactiveEngine {
+    private db;
+    private config;
+    private ts;
+    private llm;
+    private log;
+    private lastAnalysis;
+    private stmtInsert;
+    private stmtGetActive;
+    private stmtGetAll;
+    private stmtDismiss;
+    private stmtTotal;
+    private stmtActiveCount;
+    private stmtDismissedCount;
+    private stmtRecentCount;
+    private stmtCheckDuplicate;
+    constructor(db: Database.Database, config: ProactiveEngineConfig);
+    /** Set the ThoughtStream for consciousness integration. */
+    setThoughtStream(stream: ThoughtStream): void;
+    /** Set the LLMService for enhanced analysis. */
+    setLLMService(llm: LLMService): void;
+    /**
+     * Analyze data sources and create suggestions based on triggers.
+     * Returns number of new suggestions created.
+     */
+    analyze(dataSources: ProactiveDataSources): number;
+    /**
+     * Create a suggestion, respecting rate limits and dedup.
+     * Returns true if the suggestion was created, false if rate-limited or duplicate.
+     */
+    createSuggestion(type: string, title: string, description?: string, action?: string, priority?: number): boolean;
+    /**
+     * Get suggestions, sorted by priority descending.
+     * By default excludes dismissed suggestions.
+     */
+    getSuggestions(limit?: number, includeDismissed?: boolean): ProactiveSuggestion[];
+    /** Dismiss a suggestion by ID. */
+    dismiss(id: number): void;
+    /** Get engine status summary. */
+    getStatus(): ProactiveStatus;
+    /**
+     * Check for recurring errors: same error fingerprint appearing
+     * `recurringThreshold` or more times.
+     */
+    private checkRecurringErrors;
+    /**
+     * Check for stale knowledge: insights older than staleDays
+     * with high priority that haven't been refreshed.
+     */
+    private checkStaleKnowledge;
+    /**
+     * Check for quick wins: tools with high success rate but low usage count.
+     */
+    private checkQuickWins;
+}

package/dist/proactive/proactive-engine.js

@@ -0,0 +1,252 @@
+// ── Proactive Engine — Suggestion Generation & Management ────
+//
+// Analyzes data sources to proactively suggest improvements,
+// flag recurring errors, stale knowledge, and quick wins.
+import { getLogger } from '../utils/logger.js';
+// ── Migration ───────────────────────────────────────────
+export function runProactiveMigration(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS proactive_suggestions (
+      id INTEGER PRIMARY KEY,
+      type TEXT NOT NULL,
+      title TEXT NOT NULL,
+      description TEXT,
+      action TEXT,
+      priority REAL DEFAULT 0.5,
+      dismissed INTEGER DEFAULT 0,
+      created_at TEXT DEFAULT (datetime('now'))
+    );
+    CREATE INDEX IF NOT EXISTS idx_proactive_type ON proactive_suggestions(type);
+    CREATE INDEX IF NOT EXISTS idx_proactive_dismissed ON proactive_suggestions(dismissed);
+  `);
+}
+// ── Engine ──────────────────────────────────────────────
+export class ProactiveEngine {
+    db;
+    config;
+    ts = null;
+    llm = null;
+    log = getLogger();
+    lastAnalysis = null;
+    // Prepared statements
+    stmtInsert;
+    stmtGetActive;
+    stmtGetAll;
+    stmtDismiss;
+    stmtTotal;
+    stmtActiveCount;
+    stmtDismissedCount;
+    stmtRecentCount;
+    stmtCheckDuplicate;
+    constructor(db, config) {
+        this.db = db;
+        this.config = {
+            brainName: config.brainName,
+            maxSuggestionsPerHour: config.maxSuggestionsPerHour ?? 3,
+            staleDays: config.staleDays ?? 30,
+            recurringThreshold: config.recurringThreshold ?? 3,
+        };
+        runProactiveMigration(db);
+        // Prepare all statements
+        this.stmtInsert = db.prepare(`
+      INSERT INTO proactive_suggestions (type, title, description, action, priority)
+      VALUES (?, ?, ?, ?, ?)
+    `);
+        this.stmtGetActive = db.prepare(`
+      SELECT * FROM proactive_suggestions
+      WHERE dismissed = 0
+      ORDER BY priority DESC
+      LIMIT ?
+    `);
+        this.stmtGetAll = db.prepare(`
+      SELECT * FROM proactive_suggestions
+      ORDER BY priority DESC
+      LIMIT ?
+    `);
+        this.stmtDismiss = db.prepare(`
+      UPDATE proactive_suggestions SET dismissed = 1 WHERE id = ?
+    `);
+        this.stmtTotal = db.prepare(`
+      SELECT COUNT(*) AS total FROM proactive_suggestions
+    `);
+        this.stmtActiveCount = db.prepare(`
+      SELECT COUNT(*) AS active FROM proactive_suggestions WHERE dismissed = 0
+    `);
+        this.stmtDismissedCount = db.prepare(`
+      SELECT COUNT(*) AS dismissed FROM proactive_suggestions WHERE dismissed = 1
+    `);
+        this.stmtRecentCount = db.prepare(`
+      SELECT COUNT(*) AS cnt FROM proactive_suggestions
+      WHERE created_at >= datetime('now', '-1 hour')
+    `);
+        this.stmtCheckDuplicate = db.prepare(`
+      SELECT id FROM proactive_suggestions WHERE title = ? AND dismissed = 0 LIMIT 1
+    `);
+        this.log.info(`[proactive] Engine initialized for ${config.brainName}`);
+    }
+    /** Set the ThoughtStream for consciousness integration. */
+    setThoughtStream(stream) {
+        this.ts = stream;
+    }
+    /** Set the LLMService for enhanced analysis. */
+    setLLMService(llm) {
+        this.llm = llm;
+    }
+    /**
+     * Analyze data sources and create suggestions based on triggers.
+     * Returns number of new suggestions created.
+     */
+    analyze(dataSources) {
+        let created = 0;
+        try {
+            created += this.checkRecurringErrors(dataSources.db);
+        }
+        catch (err) {
+            this.log.debug(`[proactive] checkRecurringErrors skipped: ${err.message}`);
+        }
+        try {
+            created += this.checkStaleKnowledge(dataSources.db);
+        }
+        catch (err) {
+            this.log.debug(`[proactive] checkStaleKnowledge skipped: ${err.message}`);
+        }
+        try {
+            created += this.checkQuickWins(dataSources.db);
+        }
+        catch (err) {
+            this.log.debug(`[proactive] checkQuickWins skipped: ${err.message}`);
+        }
+        this.lastAnalysis = new Date().toISOString();
+        this.ts?.emit('proactive', 'analyzing', `Analysis complete: ${created} new suggestions`, created > 0 ? 'notable' : 'routine');
+        return created;
+    }
+    /**
+     * Create a suggestion, respecting rate limits and dedup.
+     * Returns true if the suggestion was created, false if rate-limited or duplicate.
+     */
+    createSuggestion(type, title, description, action, priority = 0.5) {
+        // Check rate limit
+        const recentCount = this.stmtRecentCount.get().cnt;
+        if (recentCount >= this.config.maxSuggestionsPerHour) {
+            this.log.debug(`[proactive] Rate limit reached (${recentCount}/${this.config.maxSuggestionsPerHour})`);
+            return false;
+        }
+        // Check dedup — same title not created twice if active
+        const existing = this.stmtCheckDuplicate.get(title);
+        if (existing) {
+            this.log.debug(`[proactive] Duplicate suggestion skipped: ${title}`);
+            return false;
+        }
+        this.stmtInsert.run(type, title, description ?? null, action ?? null, priority);
+        return true;
+    }
+    /**
+     * Get suggestions, sorted by priority descending.
+     * By default excludes dismissed suggestions.
+     */
+    getSuggestions(limit = 20, includeDismissed = false) {
+        if (includeDismissed) {
+            return this.stmtGetAll.all(limit);
+        }
+        return this.stmtGetActive.all(limit);
+    }
+    /** Dismiss a suggestion by ID. */
+    dismiss(id) {
+        this.stmtDismiss.run(id);
+    }
+    /** Get engine status summary. */
+    getStatus() {
+        const total = this.stmtTotal.get().total;
+        const active = this.stmtActiveCount.get().active;
+        const dismissed = this.stmtDismissedCount.get().dismissed;
+        return {
+            totalSuggestions: total,
+            activeSuggestions: active,
+            dismissedCount: dismissed,
+            lastAnalysis: this.lastAnalysis,
+        };
+    }
+    // ── Private Triggers ──────────────────────────────────
+    /**
+     * Check for recurring errors: same error fingerprint appearing
+     * `recurringThreshold` or more times.
+     */
+    checkRecurringErrors(sourceDb) {
+        // Check if error_memory table exists (brain-specific)
+        const table = sourceDb.prepare(`
+      SELECT name FROM sqlite_master WHERE type='table' AND name='error_memory'
+    `).get();
+        if (!table)
+            return 0;
+        const rows = sourceDb.prepare(`
+      SELECT fingerprint, COUNT(*) AS cnt, MAX(message) AS message
+      FROM error_memory
+      GROUP BY fingerprint
+      HAVING cnt >= ?
+    `).all(this.config.recurringThreshold);
+        let created = 0;
+        for (const row of rows) {
+            const ok = this.createSuggestion('recurring_error', `Fix recurring error: ${row.fingerprint}`, `Error "${row.message}" has occurred ${row.cnt} times. Consider a permanent fix.`, `Investigate error fingerprint: ${row.fingerprint}`, 0.8);
+            if (ok)
+                created++;
+        }
+        return created;
+    }
+    /**
+     * Check for stale knowledge: insights older than staleDays
+     * with high priority that haven't been refreshed.
+     */
+    checkStaleKnowledge(sourceDb) {
+        // Check if insights table exists
+        const table = sourceDb.prepare(`
+      SELECT name FROM sqlite_master WHERE type='table' AND name='insights'
+    `).get();
+        if (!table)
+            return 0;
+        const rows = sourceDb.prepare(`
+      SELECT topic, created_at, confidence
+      FROM insights
+      WHERE created_at < datetime('now', '-' || ? || ' days')
+        AND confidence > 0.7
+      ORDER BY confidence DESC
+      LIMIT 10
+    `).all(this.config.staleDays);
+        let created = 0;
+        for (const row of rows) {
+            const ok = this.createSuggestion('stale_knowledge', `Review stale insight: ${row.topic}`, `High-confidence insight from ${row.created_at} may be outdated. Still relevant?`, `Re-research topic: ${row.topic}`, 0.6);
+            if (ok)
+                created++;
+        }
+        return created;
+    }
+    /**
+     * Check for quick wins: tools with high success rate but low usage count.
+     */
+    checkQuickWins(sourceDb) {
+        // Check if tool_usage table exists
+        const table = sourceDb.prepare(`
+      SELECT name FROM sqlite_master WHERE type='table' AND name='tool_usage'
+    `).get();
+        if (!table)
+            return 0;
+        const rows = sourceDb.prepare(`
+      SELECT
+        tool_name,
+        COUNT(*) AS uses,
+        CAST(SUM(CASE WHEN outcome = 'success' THEN 1 ELSE 0 END) AS REAL) / COUNT(*) AS success_rate
+      FROM tool_usage
+      GROUP BY tool_name
+      HAVING success_rate >= 0.8 AND uses <= 5
+      ORDER BY success_rate DESC
+      LIMIT 10
+    `).all();
+        let created = 0;
+        for (const row of rows) {
+            const ok = this.createSuggestion('quick_win', `Use ${row.tool_name} more often`, `Tool "${row.tool_name}" has ${(row.success_rate * 100).toFixed(0)}% success rate but only ${row.uses} uses. Consider using it more.`, `Try ${row.tool_name} in more contexts`, 0.5);
+            if (ok)
+                created++;
+        }
+        return created;
+    }
+}
+//# sourceMappingURL=proactive-engine.js.map

package/dist/proactive/proactive-engine.js.map

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

package/dist/rag/__tests__/rag-engine.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/rag/__tests__/rag-engine.test.js

@@ -0,0 +1,235 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import Database from 'better-sqlite3';
+vi.mock('../../utils/logger.js', () => ({
+    getLogger: () => ({
+        info: vi.fn(), warn: vi.fn(), error: vi.fn(), debug: vi.fn(),
+    }),
+}));
+import { RAGEngine, runRAGMigration } from '../rag-engine.js';
+import { RAGIndexer } from '../rag-indexer.js';
+// ── Helpers ──────────────────────────────────────────────────
+function createTestDb() {
+    return new Database(':memory:');
+}
+function createMockEmbedding(dims = 4, seed = 0) {
+    const arr = new Float32Array(dims);
+    for (let i = 0; i < dims; i++) {
+        arr[i] = Math.sin(seed + i);
+    }
+    // Normalize
+    let norm = 0;
+    for (let i = 0; i < dims; i++)
+        norm += arr[i] * arr[i];
+    norm = Math.sqrt(norm);
+    if (norm > 0)
+        for (let i = 0; i < dims; i++)
+            arr[i] /= norm;
+    return arr;
+}
+function createMockEmbeddingEngine() {
+    let callCount = 0;
+    return {
+        embed: vi.fn(async (_text) => createMockEmbedding(4, callCount++)),
+        embedBatch: vi.fn(async (texts) => texts.map((_, i) => createMockEmbedding(4, callCount + i))),
+    };
+}
+// ── RAGEngine Tests ──────────────────────────────────────────
+describe('RAGEngine', () => {
+    let db;
+    beforeEach(() => { db = createTestDb(); });
+    afterEach(() => { try {
+        db.close();
+    }
+    catch { /* ignore */ } });
+    it('creates rag_vectors table on migration', () => {
+        runRAGMigration(db);
+        const tables = db.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='rag_vectors'").all();
+        expect(tables).toHaveLength(1);
+    });
+    it('migration is idempotent', () => {
+        runRAGMigration(db);
+        runRAGMigration(db);
+        const tables = db.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='rag_vectors'").all();
+        expect(tables).toHaveLength(1);
+    });
+    it('creates engine with defaults', () => {
+        const rag = new RAGEngine(db, { brainName: 'test' });
+        const status = rag.getStatus();
+        expect(status.totalVectors).toBe(0);
+        expect(status.collections).toEqual([]);
+    });
+    it('indexes a single item', async () => {
+        const rag = new RAGEngine(db, { brainName: 'test' });
+        rag.setEmbeddingEngine(createMockEmbeddingEngine());
+        const result = await rag.index('insights', 1, 'Test insight about TypeScript patterns');
+        expect(result).toBe(true);
+        const status = rag.getStatus();
+        expect(status.totalVectors).toBe(1);
+        expect(status.collections[0]?.collection).toBe('insights');
+    });
+    it('skips indexing when text unchanged', async () => {
+        const rag = new RAGEngine(db, { brainName: 'test' });
+        rag.setEmbeddingEngine(createMockEmbeddingEngine());
+        await rag.index('insights', 1, 'Same text');
+        const result = await rag.index('insights', 1, 'Same text');
+        expect(result).toBe(false);
+        const status = rag.getStatus();
+        expect(status.totalVectors).toBe(1);
+    });
+    it('updates index when text changes', async () => {
+        const rag = new RAGEngine(db, { brainName: 'test' });
+        rag.setEmbeddingEngine(createMockEmbeddingEngine());
+        await rag.index('insights', 1, 'Old text');
+        const result = await rag.index('insights', 1, 'New text');
+        expect(result).toBe(true);
+        const status = rag.getStatus();
+        expect(status.totalVectors).toBe(1); // Still 1, updated in place
+    });
+    it('searches and returns results sorted by similarity', async () => {
+        const rag = new RAGEngine(db, { brainName: 'test' });
+        const mockEmbed = createMockEmbeddingEngine();
+        rag.setEmbeddingEngine(mockEmbed);
+        await rag.index('insights', 1, 'TypeScript error handling');
+        await rag.index('insights', 2, 'JavaScript async patterns');
+        await rag.index('errors', 3, 'Null pointer exception');
+        const results = await rag.search('TypeScript error', { threshold: 0 });
+        expect(results.length).toBeGreaterThan(0);
+        // Results should be sorted by similarity descending
+        for (let i = 1; i < results.length; i++) {
+            expect(results[i - 1].similarity).toBeGreaterThanOrEqual(results[i].similarity);
+        }
+    });
+    it('filters by collection', async () => {
+        const rag = new RAGEngine(db, { brainName: 'test' });
+        rag.setEmbeddingEngine(createMockEmbeddingEngine());
+        await rag.index('insights', 1, 'An insight');
+        await rag.index('errors', 1, 'An error');
+        const results = await rag.search('test', { collections: ['insights'], threshold: 0 });
+        expect(results.every(r => r.collection === 'insights')).toBe(true);
+    });
+    it('respects limit', async () => {
+        const rag = new RAGEngine(db, { brainName: 'test' });
+        rag.setEmbeddingEngine(createMockEmbeddingEngine());
+        for (let i = 0; i < 10; i++) {
+            await rag.index('insights', i, `Insight number ${i}`);
+        }
+        const results = await rag.search('insight', { limit: 3, threshold: 0 });
+        expect(results.length).toBeLessThanOrEqual(3);
+    });
+    it('respects threshold', async () => {
+        const rag = new RAGEngine(db, { brainName: 'test' });
+        rag.setEmbeddingEngine(createMockEmbeddingEngine());
+        await rag.index('insights', 1, 'Test');
+        const highThreshold = await rag.search('completely different', { threshold: 0.99 });
+        // With mock embeddings, very high threshold likely returns nothing
+        expect(highThreshold.length).toBeLessThanOrEqual(1);
+    });
+    it('batch indexes items', async () => {
+        const rag = new RAGEngine(db, { brainName: 'test' });
+        rag.setEmbeddingEngine(createMockEmbeddingEngine());
+        const items = Array.from({ length: 5 }, (_, i) => ({
+            collection: 'insights',
+            sourceId: i + 1,
+            text: `Insight ${i + 1} about programming`,
+        }));
+        const count = await rag.indexBatch(items);
+        expect(count).toBe(5);
+        const status = rag.getStatus();
+        expect(status.totalVectors).toBe(5);
+    });
+    it('removes items', async () => {
+        const rag = new RAGEngine(db, { brainName: 'test' });
+        rag.setEmbeddingEngine(createMockEmbeddingEngine());
+        await rag.index('insights', 1, 'Test insight');
+        expect(rag.getStatus().totalVectors).toBe(1);
+        rag.remove('insights', 1);
+        expect(rag.getStatus().totalVectors).toBe(0);
+    });
+    it('augments query with context', () => {
+        const rag = new RAGEngine(db, { brainName: 'test' });
+        const augmented = rag.augment('How to fix?', [
+            { collection: 'insights', sourceId: 1, text: 'Use try-catch', similarity: 0.9 },
+            { collection: 'errors', sourceId: 2, text: 'NullPointer', similarity: 0.7 },
+        ]);
+        expect(augmented).toContain('Context from knowledge base');
+        expect(augmented).toContain('Use try-catch');
+        expect(augmented).toContain('How to fix?');
+    });
+    it('augment returns plain query when no context', () => {
+        const rag = new RAGEngine(db, { brainName: 'test' });
+        expect(rag.augment('test', [])).toBe('test');
+    });
+    it('returns empty results without embedding engine', async () => {
+        const rag = new RAGEngine(db, { brainName: 'test' });
+        const results = await rag.search('test');
+        expect(results).toEqual([]);
+    });
+    it('index returns false without embedding engine', async () => {
+        const rag = new RAGEngine(db, { brainName: 'test' });
+        const result = await rag.index('test', 1, 'text');
+        expect(result).toBe(false);
+    });
+    it('getCollections returns distinct collections', async () => {
+        const rag = new RAGEngine(db, { brainName: 'test' });
+        rag.setEmbeddingEngine(createMockEmbeddingEngine());
+        await rag.index('insights', 1, 'test');
+        await rag.index('errors', 1, 'test');
+        await rag.index('insights', 2, 'test2');
+        const collections = rag.getCollections();
+        expect(collections.sort()).toEqual(['errors', 'insights']);
+    });
+    it('stores and returns metadata', async () => {
+        const rag = new RAGEngine(db, { brainName: 'test' });
+        rag.setEmbeddingEngine(createMockEmbeddingEngine());
+        await rag.index('insights', 1, 'Test', { category: 'patterns', priority: 5 });
+        const results = await rag.search('test', { threshold: 0 });
+        expect(results.length).toBeGreaterThan(0);
+        expect(results[0]?.metadata).toEqual({ category: 'patterns', priority: 5 });
+    });
+});
+// ── RAGIndexer Tests ─────────────────────────────────────────
+describe('RAGIndexer', () => {
+    let db;
+    beforeEach(() => { db = createTestDb(); });
+    afterEach(() => { try {
+        db.close();
+    }
+    catch { /* ignore */ } });
+    it('creates indexer without error', () => {
+        const indexer = new RAGIndexer(db);
+        expect(indexer.getStatus().totalIndexed).toBe(0);
+    });
+    it('returns 0 without RAG engine', async () => {
+        const indexer = new RAGIndexer(db);
+        const count = await indexer.indexAll();
+        expect(count).toBe(0);
+    });
+    it('indexes custom source', async () => {
+        // Create a test table
+        db.exec(`CREATE TABLE test_items (id INTEGER PRIMARY KEY, content TEXT, category TEXT)`);
+        db.prepare('INSERT INTO test_items (content, category) VALUES (?, ?)').run('Test content', 'test');
+        db.prepare('INSERT INTO test_items (content, category) VALUES (?, ?)').run('Another content', 'test');
+        const rag = new RAGEngine(db, { brainName: 'test' });
+        rag.setEmbeddingEngine(createMockEmbeddingEngine());
+        const indexer = new RAGIndexer(db);
+        indexer.setRAGEngine(rag);
+        indexer.addSource({
+            collection: 'test_items',
+            query: 'SELECT id, content, category FROM test_items',
+            textColumns: ['content'],
+        });
+        const count = await indexer.indexAll();
+        expect(count).toBe(2);
+        expect(indexer.getStatus().totalIndexed).toBe(2);
+    });
+    it('skips missing tables gracefully', async () => {
+        const rag = new RAGEngine(db, { brainName: 'test' });
+        rag.setEmbeddingEngine(createMockEmbeddingEngine());
+        const indexer = new RAGIndexer(db);
+        indexer.setRAGEngine(rag);
+        // Default sources reference tables that don't exist in test DB
+        const count = await indexer.indexAll();
+        expect(count).toBe(0);
+    });
+});
+//# sourceMappingURL=rag-engine.test.js.map

package/dist/rag/__tests__/rag-engine.test.js.map

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

package/dist/rag/index.d.ts

@@ -0,0 +1,4 @@
+export { RAGEngine, runRAGMigration } from './rag-engine.js';
+export type { RAGEngineConfig, RAGSearchOptions, RAGResult, RAGIndexStats, RAGStatus } from './rag-engine.js';
+export { RAGIndexer } from './rag-indexer.js';
+export type { RAGIndexerConfig, IndexSource, IndexerStatus } from './rag-indexer.js';

package/dist/rag/index.js

@@ -0,0 +1,3 @@
+export { RAGEngine, runRAGMigration } from './rag-engine.js';
+export { RAGIndexer } from './rag-indexer.js';
+//# sourceMappingURL=index.js.map

package/dist/rag/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/rag/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAE7D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC"}