@theihtisham/agent-shadow-brain 6.0.0 → 6.0.3

package/dist/brain/brain-working-memory.js

@@ -0,0 +1,367 @@
+// src/brain/brain-working-memory.ts — Predictive prefetch LRU for brain recall
+// v6.0.2 — Hive Mind Edition
+//
+// The "RAM" of the brain. A small hot cache of "what's about to be needed"
+// keyed by query string. Predicts next likely queries from session context
+// (active file, recent edits, agent type, recent queries) and pre-warms the
+// embeddings index so in-context recall is sub-10ms on hit.
+//
+// Heuristics are deterministic (no LLM):
+//   - File-pattern: auth.ts → "auth handling", "session", "login"
+//   - Recent-query continuation: pulls related neighbors from the brain
+//   - Agent-specific: Cursor leans completion-style; Claude Code diagnostic
+//
+// Persisted to ~/.shadow-brain/working-memory.json so warm survives restarts.
+// LRU evictions are tracked; capacity auto-grows (256 → 1024) when hit rate
+// drops below 0.5.
+//
+// Exposed: BrainWorkingMemory, getBrainWorkingMemory(),
+//          resetBrainWorkingMemoryForTests().
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { getEmbeddingsV2 } from './embeddings-v2.js';
+const STORE_DIR = path.join(os.homedir(), '.shadow-brain');
+const STORE_PATH = path.join(STORE_DIR, 'working-memory.json');
+const CONFIG_PATH = path.join(STORE_DIR, 'config.json');
+const DEFAULT_CAPACITY = 256;
+const MAX_CAPACITY = 1024;
+const GROW_THRESHOLD = 0.5;
+const MIN_SAMPLES_BEFORE_GROW = 50;
+const PERSIST_EVERY_N_WRITES = 10;
+const FILE_PATTERN_HINTS = [
+    { match: /auth/i, queries: ['auth handling', 'session', 'login', 'token', 'permissions'] },
+    { match: /login|signin/i, queries: ['login flow', 'credentials', 'session', 'oauth'] },
+    { match: /pay|billing|invoice|stripe/i, queries: ['payment', 'billing', 'invoice', 'refund'] },
+    { match: /user|account|profile/i, queries: ['user model', 'profile', 'account settings'] },
+    { match: /db|database|schema|migration|prisma|drizzle/i, queries: ['schema', 'migration', 'query', 'index'] },
+    { match: /route|router|controller/i, queries: ['routing', 'endpoint', 'handler', 'middleware'] },
+    { match: /test|spec/i, queries: ['testing', 'mock', 'fixture', 'coverage'] },
+    { match: /config|env|settings/i, queries: ['configuration', 'environment', 'settings'] },
+    { match: /cache|redis|memcache/i, queries: ['caching', 'ttl', 'eviction', 'hit rate'] },
+    { match: /queue|worker|job/i, queries: ['background job', 'queue', 'worker', 'retry'] },
+    { match: /api|client|fetch|axios/i, queries: ['api client', 'request', 'response', 'error handling'] },
+    { match: /component|view|page/i, queries: ['component', 'render', 'state', 'props'] },
+    { match: /style|css|theme/i, queries: ['styling', 'theme', 'css', 'responsive'] },
+    { match: /security|crypt|hash/i, queries: ['security', 'encryption', 'hash', 'token'] },
+    { match: /log|monitor|metric|trace/i, queries: ['logging', 'monitoring', 'metrics'] },
+    { match: /websocket|socket|realtime|sse/i, queries: ['realtime', 'websocket', 'event stream'] },
+    { match: /upload|file|media|image/i, queries: ['file upload', 'storage', 'media handling'] },
+];
+const AGENT_BIASES = {
+    cursor: ['autocomplete context', 'symbol reference', 'usage example', 'inline doc'],
+    'claude-code': ['root cause', 'why does', 'fix for', 'related test', 'recent change'],
+    copilot: ['similar function', 'imports', 'type definition'],
+    windsurf: ['workspace layout', 'related file', 'pattern reference'],
+    cline: ['plan step', 'todo', 'next action'],
+};
+export class BrainWorkingMemory {
+    constructor(opts) {
+        this.capacity = DEFAULT_CAPACITY;
+        this.lru = new Map();
+        this.hits = 0;
+        this.misses = 0;
+        this.prefetchHits = 0;
+        this.prefetchedTotal = 0;
+        this.evictionsCount = 0;
+        this.prefetchedKeys = new Set();
+        this.writesSinceFlush = 0;
+        this.latestContext = null;
+        this.initialized = false;
+        this.index = opts?.index ?? getEmbeddingsV2();
+    }
+    /** Lazy init — loads persisted entries + config. Safe to call repeatedly. */
+    init() {
+        if (this.initialized)
+            return;
+        try {
+            fs.mkdirSync(STORE_DIR, { recursive: true });
+        }
+        catch { /* non-fatal */ }
+        this.loadConfig();
+        this.loadStore();
+        this.initialized = true;
+    }
+    /** Feed the latest session context. Used for predictions on next get/prefetch. */
+    observe(context) {
+        this.init();
+        this.latestContext = { ...context };
+    }
+    /** Sub-10ms fast path. Returns null if not cached. */
+    async get(query) {
+        this.init();
+        const key = this.keyOf(query, this.latestContext?.project);
+        const entry = this.lru.get(key);
+        if (!entry) {
+            this.misses++;
+            return null;
+        }
+        // LRU touch — re-insert at end.
+        this.lru.delete(key);
+        this.lru.set(key, entry);
+        this.hits++;
+        if (this.prefetchedKeys.has(key)) {
+            this.prefetchHits++;
+            this.prefetchedKeys.delete(key);
+        }
+        this.maybeGrow();
+        return entry;
+    }
+    /** Predict next likely queries from the latest context. Deterministic, no LLM. */
+    async predictNext(opts) {
+        this.init();
+        const topK = Math.max(1, Math.min(64, opts?.topK ?? 8));
+        const ctx = this.latestContext;
+        if (!ctx)
+            return [];
+        const scored = new Map();
+        const bump = (q, w) => {
+            const norm = q.trim().toLowerCase();
+            if (!norm)
+                return;
+            scored.set(norm, (scored.get(norm) ?? 0) + w);
+        };
+        // File-pattern hints (active file weighs more than recent).
+        if (ctx.activeFile) {
+            for (const q of hintsForPath(ctx.activeFile))
+                bump(q, 3);
+        }
+        for (const rf of (ctx.recentFiles ?? []).slice(0, 5)) {
+            for (const q of hintsForPath(rf))
+                bump(q, 1.5);
+        }
+        for (const e of (ctx.recentEdits ?? []).slice(0, 5)) {
+            for (const q of hintsForPath(e.file))
+                bump(q, 2);
+        }
+        // Agent bias.
+        const agentKey = (ctx.activeAgent ?? '').toLowerCase();
+        const biases = AGENT_BIASES[agentKey] ?? AGENT_BIASES[agentKey.replace(/[^a-z]/g, '')] ?? [];
+        for (const b of biases)
+            bump(b, 1);
+        // Recent-query continuation — pull neighbor candidates from the brain index.
+        const recentQ = (ctx.recentQueries ?? []).slice(-3);
+        for (const rq of recentQ) {
+            bump(rq, 0.5); // baseline weight for the query itself
+            try {
+                const hits = await this.index.search(rq, 4);
+                for (const h of hits) {
+                    // Use the first sentence of the brain text as a "follow-up" candidate query.
+                    const seed = firstSentence(h.text);
+                    if (seed)
+                        bump(seed, 0.6);
+                }
+            }
+            catch { /* ignore index errors */ }
+        }
+        return Array.from(scored.entries())
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, topK)
+            .map(([q]) => q);
+    }
+    /** Fire-and-forget warm. Queries are embedded + searched, results cached. */
+    async prefetch(queries, project) {
+        this.init();
+        const t0 = Date.now();
+        let prefetched = 0;
+        const unique = Array.from(new Set(queries.map(q => q.trim()).filter(Boolean)));
+        for (const q of unique) {
+            const key = this.keyOf(q, project);
+            if (this.lru.has(key))
+                continue;
+            try {
+                const hits = await this.index.search(q, 10);
+                const value = {
+                    query: q,
+                    project,
+                    hits: hits.map(h => ({ id: h.id, score: h.score, text: h.text })),
+                    storedAt: Date.now(),
+                    source: 'prefetch',
+                };
+                this.putEntry(key, value);
+                this.prefetchedKeys.add(key);
+                prefetched++;
+                this.prefetchedTotal++;
+            }
+            catch { /* skip on error */ }
+        }
+        return { prefetched, durationMs: Date.now() - t0 };
+    }
+    stats() {
+        this.init();
+        const total = this.hits + this.misses;
+        const hitRate = total > 0 ? +(this.hits / total).toFixed(4) : 0;
+        const prefetchHitRate = this.prefetchedTotal > 0
+            ? +(this.prefetchHits / this.prefetchedTotal).toFixed(4)
+            : 0;
+        return {
+            capacity: this.capacity,
+            used: this.lru.size,
+            hitRate,
+            evictionsCount: this.evictionsCount,
+            prefetchHitRate,
+        };
+    }
+    /** Persist current contents to disk. */
+    async flush() {
+        this.init();
+        await this.persist();
+    }
+    /** Wipe contents + metrics. Persistence is cleared. */
+    reset() {
+        this.lru.clear();
+        this.prefetchedKeys.clear();
+        this.hits = 0;
+        this.misses = 0;
+        this.prefetchHits = 0;
+        this.prefetchedTotal = 0;
+        this.evictionsCount = 0;
+        this.writesSinceFlush = 0;
+        try {
+            if (fs.existsSync(STORE_PATH))
+                fs.unlinkSync(STORE_PATH);
+        }
+        catch { /* non-fatal */ }
+    }
+    // ── Internals ─────────────────────────────────────────────────────────
+    putEntry(key, value) {
+        if (this.lru.has(key))
+            this.lru.delete(key);
+        this.lru.set(key, value);
+        while (this.lru.size > this.capacity) {
+            const oldest = this.lru.keys().next().value;
+            if (oldest === undefined)
+                break;
+            this.lru.delete(oldest);
+            this.prefetchedKeys.delete(oldest);
+            this.evictionsCount++;
+        }
+        this.writesSinceFlush++;
+        if (this.writesSinceFlush >= PERSIST_EVERY_N_WRITES) {
+            this.writesSinceFlush = 0;
+            this.persist().catch(() => { });
+        }
+    }
+    maybeGrow() {
+        const total = this.hits + this.misses;
+        if (total < MIN_SAMPLES_BEFORE_GROW)
+            return;
+        if (this.capacity >= MAX_CAPACITY)
+            return;
+        const hitRate = this.hits / total;
+        if (hitRate < GROW_THRESHOLD) {
+            this.capacity = Math.min(MAX_CAPACITY, Math.max(this.capacity * 2, this.capacity + 64));
+            this.persistConfig().catch(() => { });
+        }
+    }
+    keyOf(query, project) {
+        const p = (project ?? '').trim().toLowerCase();
+        const q = query.trim().toLowerCase();
+        return p + '
' + q;
+    }
+    loadConfig() {
+        try {
+            if (!fs.existsSync(CONFIG_PATH))
+                return;
+            const raw = JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf-8'));
+            const cap = raw.workingMemory?.capacity;
+            if (typeof cap === 'number' && cap > 0 && cap <= MAX_CAPACITY)
+                this.capacity = Math.floor(cap);
+        }
+        catch { /* fall back to defaults */ }
+    }
+    async persistConfig() {
+        try {
+            let existing = {};
+            if (fs.existsSync(CONFIG_PATH)) {
+                try {
+                    existing = JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf-8'));
+                }
+                catch {
+                    existing = {};
+                }
+            }
+            existing.workingMemory = { capacity: this.capacity };
+            const tmp = CONFIG_PATH + '.tmp';
+            fs.writeFileSync(tmp, JSON.stringify(existing, null, 2));
+            fs.renameSync(tmp, CONFIG_PATH);
+        }
+        catch { /* non-fatal */ }
+    }
+    loadStore() {
+        try {
+            if (!fs.existsSync(STORE_PATH))
+                return;
+            const raw = fs.readFileSync(STORE_PATH, 'utf-8');
+            const parsed = JSON.parse(raw);
+            if (parsed.schemaVersion !== 1)
+                return;
+            this.capacity = Math.min(MAX_CAPACITY, Math.max(parsed.capacity || DEFAULT_CAPACITY, 1));
+            this.hits = parsed.metrics?.hits ?? 0;
+            this.misses = parsed.metrics?.misses ?? 0;
+            this.prefetchHits = parsed.metrics?.prefetchHits ?? 0;
+            this.prefetchedTotal = parsed.metrics?.prefetchedTotal ?? 0;
+            this.evictionsCount = parsed.metrics?.evictionsCount ?? 0;
+            for (const { key, value } of parsed.entries ?? []) {
+                this.lru.set(key, value);
+                if (this.lru.size > this.capacity) {
+                    const oldest = this.lru.keys().next().value;
+                    if (oldest !== undefined)
+                        this.lru.delete(oldest);
+                }
+            }
+        }
+        catch { /* skip corrupt store */ }
+    }
+    async persist() {
+        try {
+            const payload = {
+                schemaVersion: 1,
+                capacity: this.capacity,
+                entries: Array.from(this.lru.entries()).map(([key, value]) => ({ key, value })),
+                metrics: {
+                    hits: this.hits,
+                    misses: this.misses,
+                    prefetchHits: this.prefetchHits,
+                    prefetchedTotal: this.prefetchedTotal,
+                    evictionsCount: this.evictionsCount,
+                },
+            };
+            const tmp = STORE_PATH + '.tmp';
+            fs.writeFileSync(tmp, JSON.stringify(payload));
+            fs.renameSync(tmp, STORE_PATH);
+        }
+        catch { /* non-fatal */ }
+    }
+}
+function hintsForPath(filePath) {
+    const base = filePath.split(/[\\/]/).pop() ?? filePath;
+    const out = [];
+    for (const rule of FILE_PATTERN_HINTS) {
+        if (rule.match.test(base) || rule.match.test(filePath)) {
+            for (const q of rule.queries)
+                out.push(q);
+        }
+    }
+    // Also seed a query from the bare module name (auth.ts → "auth").
+    const stem = base.replace(/\.[^.]+$/, '').replace(/[-_]/g, ' ').trim();
+    if (stem && stem.length <= 40)
+        out.push(stem);
+    return out;
+}
+function firstSentence(text) {
+    if (!text)
+        return '';
+    const t = text.replace(/\s+/g, ' ').trim();
+    const cut = t.search(/[.!?]\s/);
+    const seed = cut > 0 ? t.slice(0, cut) : t.slice(0, 80);
+    return seed.length > 4 ? seed : '';
+}
+let _instance = null;
+export function getBrainWorkingMemory() {
+    if (!_instance)
+        _instance = new BrainWorkingMemory();
+    return _instance;
+}
+export function resetBrainWorkingMemoryForTests() { _instance = null; }
+//# sourceMappingURL=brain-working-memory.js.map

package/dist/brain/brain-working-memory.js.map

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

package/dist/brain/confidence-gate.d.ts

@@ -0,0 +1,69 @@
+export type GateMode = 'block' | 'downgrade' | 'flag';
+export interface GatedInput {
+    text: string;
+    confidence: number;
+    [k: string]: unknown;
+}
+export interface GateOpts {
+    threshold?: number;
+    mode: GateMode;
+    hedgeHint?: string;
+}
+export interface GatedResultBlocked {
+    blocked: true;
+    reason: string;
+    predicted: number;
+    threshold: number;
+}
+export interface GatedResultPassed<T extends GatedInput> {
+    blocked: false;
+    result: T & {
+        _warning?: string;
+    };
+    mode: GateMode;
+    predicted: number;
+    threshold: number;
+    downgraded: boolean;
+}
+export type GateOutcome<T extends GatedInput> = GatedResultBlocked | GatedResultPassed<T>;
+export interface CalibrationEntry {
+    ts: string;
+    predicted: number;
+    wasCorrect: 0 | 0.5 | 1;
+    meta?: Record<string, unknown>;
+}
+export interface CalibrationStats {
+    sampleSize: number;
+    brierScore: number;
+    expectedCalibrationError: number;
+    bucketBreakdown: Array<{
+        bucket: string;
+        samples: number;
+        meanPredicted: number;
+        meanOutcome: number;
+        gap: number;
+    }>;
+    threshold: number;
+}
+export declare class ConfidenceGate {
+    private threshold;
+    private historyCache;
+    private initialized;
+    init(): Promise<void>;
+    /** Apply the gate. Synchronous because the threshold is already loaded. */
+    gate<T extends GatedInput>(result: T, opts: GateOpts): GateOutcome<T>;
+    /** Record what actually happened so we can compute calibration stats later. */
+    recordOutcome(predicted: number, wasCorrect: boolean | 'partial', meta?: Record<string, unknown>): Promise<void>;
+    /** Brier + ECE over all recorded outcomes. */
+    stats(): Promise<CalibrationStats>;
+    setThreshold(t: number): void;
+    getThreshold(): number;
+    /** Convenience wrapper for promise-returning functions. */
+    wrap<T extends GatedInput>(fn: () => Promise<T>, opts: GateOpts): Promise<GateOutcome<T>>;
+    private loadHistory;
+    private readConfiguredThreshold;
+    private writeConfiguredThreshold;
+}
+export declare function getConfidenceGate(): ConfidenceGate;
+export declare function resetConfidenceGateForTests(): void;
+//# sourceMappingURL=confidence-gate.d.ts.map

package/dist/brain/confidence-gate.d.ts.map

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