@theihtisham/agent-shadow-brain 5.1.1 → 6.0.0

package/dist/brain/global-brain.js

@@ -0,0 +1,348 @@
+// src/brain/global-brain.ts — Singleton Global Brain (v5.2.0)
+//
+// One brain. Every project. Every agent. Every machine.
+//
+// The Global Brain is a singleton store at ~/.shadow-brain/global.json that
+// every Shadow Brain instance reads from and writes to. Insights from project
+// A using Cursor are immediately available to project B using Claude Code.
+//
+// Storage: append-friendly JSON store (no native deps), persisted on every
+// flush. Combined with l0-cache.ts, hot recalls return in <1ms.
+//
+// Concurrency: write queue + atomic file replace prevents conflicts when
+// multiple agents write simultaneously.
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import * as crypto from 'crypto';
+const DEFAULT_DIR = path.join(os.homedir(), '.shadow-brain');
+const DEFAULT_DB_PATH = path.join(DEFAULT_DIR, 'global.json');
+const DEFAULT_CONFIG = {
+    dbPath: DEFAULT_DB_PATH,
+    walMode: true,
+    writeQueueSize: 1000,
+    autoVacuumMB: 500,
+    autoPruneMB: 1000,
+    syncIntervalMs: 5000,
+};
+/**
+ * Singleton Global Brain — the source of truth for all projects + agents.
+ *
+ * Storage: JSON file at ~/.shadow-brain/global.json (zero new deps).
+ * In-memory Map keyed by entry.id for O(1) ID lookups.
+ */
+export class GlobalBrain {
+    constructor(config = {}) {
+        this.entries = new Map();
+        this.projects = new Map();
+        this.agents = new Map();
+        this.writeQueue = [];
+        this.syncTimer = null;
+        this.initialized = false;
+        this.dirty = false;
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.startedAt = Date.now();
+        this.stats = {
+            totalProjects: 0,
+            totalAgents: 0,
+            totalEntries: 0,
+            totalSizeMB: 0,
+            pendingWrites: 0,
+            hits: 0,
+            misses: 0,
+            hitRate: 0,
+            lastSync: new Date(),
+            lastVacuum: null,
+            lastPrune: null,
+            uptime: 0,
+        };
+    }
+    static getInstance(config) {
+        if (!GlobalBrain.instance) {
+            GlobalBrain.instance = new GlobalBrain(config);
+        }
+        return GlobalBrain.instance;
+    }
+    async init() {
+        if (this.initialized)
+            return;
+        fs.mkdirSync(path.dirname(this.config.dbPath), { recursive: true });
+        if (fs.existsSync(this.config.dbPath)) {
+            try {
+                const raw = fs.readFileSync(this.config.dbPath, 'utf-8');
+                const parsed = JSON.parse(raw);
+                for (const e of parsed.entries ?? []) {
+                    // Re-hydrate Date instances
+                    this.entries.set(e.id, {
+                        ...e,
+                        createdAt: new Date(e.createdAt),
+                        lastAccessed: new Date(e.lastAccessed),
+                    });
+                }
+                for (const p of parsed.projects ?? [])
+                    this.projects.set(p.id, p);
+                for (const a of parsed.agents ?? [])
+                    this.agents.set(a.tool, a);
+            }
+            catch {
+                // Corrupted file → start fresh, back up the bad one
+                try {
+                    fs.renameSync(this.config.dbPath, this.config.dbPath + '.corrupt-' + Date.now());
+                }
+                catch { /* ignore */ }
+            }
+        }
+        this.startSyncLoop();
+        this.refreshStats();
+        this.initialized = true;
+    }
+    /** Generate a stable project ID from absolute path */
+    static projectIdFor(rootDir) {
+        const abs = path.resolve(rootDir);
+        return crypto.createHash('sha1').update(abs).digest('hex').slice(0, 16);
+    }
+    registerProject(rootDir, name) {
+        if (!this.initialized)
+            throw new Error('GlobalBrain not initialized — call init() first');
+        const id = GlobalBrain.projectIdFor(rootDir);
+        const projectName = name || path.basename(rootDir);
+        const now = Date.now();
+        const existing = this.projects.get(id);
+        this.projects.set(id, {
+            id,
+            name: projectName,
+            rootDir: path.resolve(rootDir),
+            firstSeen: existing?.firstSeen ?? now,
+            lastSeen: now,
+        });
+        this.dirty = true;
+        return id;
+    }
+    registerAgent(agent) {
+        if (!this.initialized)
+            return;
+        const now = Date.now();
+        const existing = this.agents.get(agent);
+        this.agents.set(agent, {
+            tool: agent,
+            firstSeen: existing?.firstSeen ?? now,
+            lastSeen: now,
+            sessionCount: (existing?.sessionCount ?? 0) + 1,
+        });
+        this.dirty = true;
+    }
+    /** Queue a write — resolves true on success */
+    async write(entry) {
+        if (!this.initialized)
+            await this.init();
+        const fullEntry = {
+            ...entry,
+            id: crypto.randomUUID(),
+            createdAt: new Date(),
+            lastAccessed: new Date(),
+            accessCount: 0,
+        };
+        if (this.writeQueue.length >= this.config.writeQueueSize) {
+            return false;
+        }
+        return new Promise((resolve) => {
+            this.writeQueue.push({ entry: fullEntry, resolve });
+        });
+    }
+    /** Direct synchronous write — bypasses queue */
+    writeSync(entry) {
+        if (!this.initialized)
+            throw new Error('GlobalBrain not initialized');
+        const id = crypto.randomUUID();
+        const fullEntry = {
+            ...entry,
+            id,
+            createdAt: new Date(),
+            lastAccessed: new Date(),
+            accessCount: 0,
+        };
+        this.entries.set(id, fullEntry);
+        this.dirty = true;
+        this.stats.totalEntries = this.entries.size;
+        return id;
+    }
+    /** Recall entries — cross-project + cross-agent */
+    recall(opts = {}) {
+        if (!this.initialized)
+            return [];
+        const limit = opts.limit ?? 20;
+        const minImp = opts.minImportance ?? 0;
+        const kwLower = opts.keywords?.map(k => k.toLowerCase()) ?? null;
+        const matches = [];
+        for (const e of this.entries.values()) {
+            if (opts.projectId && e.projectId !== opts.projectId)
+                continue;
+            if (opts.agentTool && e.agentTool !== opts.agentTool)
+                continue;
+            if (opts.category && e.category !== opts.category)
+                continue;
+            if (e.importance < minImp)
+                continue;
+            if (kwLower) {
+                const hay = e.content.toLowerCase();
+                if (!kwLower.some(k => hay.includes(k)))
+                    continue;
+            }
+            matches.push(e);
+        }
+        matches.sort((a, b) => {
+            if (b.importance !== a.importance)
+                return b.importance - a.importance;
+            return b.lastAccessed.getTime() - a.lastAccessed.getTime();
+        });
+        const result = matches.slice(0, limit);
+        if (result.length)
+            this.stats.hits++;
+        else
+            this.stats.misses++;
+        return result;
+    }
+    /** Bump access count for an entry */
+    touch(id) {
+        const entry = this.entries.get(id);
+        if (!entry)
+            return;
+        entry.accessCount++;
+        entry.lastAccessed = new Date();
+        this.dirty = true;
+    }
+    recallByIds(ids) {
+        const out = [];
+        for (const id of ids) {
+            const e = this.entries.get(id);
+            if (e)
+                out.push(e);
+        }
+        return out;
+    }
+    /** Chronological proof stream for dashboards, handoffs, and launch demos. */
+    timeline(opts = {}) {
+        if (!this.initialized)
+            return [];
+        const limit = opts.limit ?? 50;
+        return Array.from(this.entries.values())
+            .filter(e => !opts.projectId || e.projectId === opts.projectId)
+            .filter(e => !opts.agentTool || e.agentTool === opts.agentTool)
+            .filter(e => !opts.category || e.category === opts.category)
+            .sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime())
+            .slice(0, limit)
+            .map(e => ({
+            id: e.id,
+            projectId: e.projectId,
+            projectName: e.projectName,
+            agentTool: e.agentTool,
+            category: e.category,
+            content: e.content,
+            importance: e.importance,
+            createdAt: e.createdAt,
+            lastAccessed: e.lastAccessed,
+            metadata: e.metadata,
+        }));
+    }
+    getStats() {
+        this.refreshStats();
+        return { ...this.stats };
+    }
+    /** Force a sync of pending writes to disk */
+    async sync() {
+        if (!this.initialized)
+            return;
+        if (this.writeQueue.length > 0) {
+            const pending = this.writeQueue.splice(0, this.writeQueue.length);
+            for (const { entry, resolve } of pending) {
+                try {
+                    this.entries.set(entry.id, entry);
+                    resolve(true);
+                }
+                catch {
+                    resolve(false);
+                }
+            }
+            this.dirty = true;
+        }
+        if (this.dirty) {
+            this.persist();
+            this.stats.lastSync = new Date();
+            this.dirty = false;
+        }
+        this.maybeAutoMaintenance();
+    }
+    maybeAutoMaintenance() {
+        const sizeMB = this.estimateSizeMB();
+        this.stats.totalSizeMB = sizeMB;
+        if (sizeMB > this.config.autoPruneMB)
+            this.prune();
+    }
+    /** Auto-prune: drop low-importance, rarely-accessed entries when over threshold */
+    prune() {
+        const cutoff = Date.now() - 90 * 24 * 60 * 60 * 1000; // 90 days
+        const toDelete = [];
+        for (const [id, e] of this.entries) {
+            if (e.importance < 0.3 && e.accessCount < 2 && e.lastAccessed.getTime() < cutoff) {
+                toDelete.push(id);
+            }
+        }
+        for (const id of toDelete)
+            this.entries.delete(id);
+        if (toDelete.length) {
+            this.dirty = true;
+            this.stats.lastPrune = new Date();
+        }
+    }
+    persist() {
+        const shape = {
+            schemaVersion: 1,
+            entries: Array.from(this.entries.values()),
+            projects: Array.from(this.projects.values()),
+            agents: Array.from(this.agents.values()),
+        };
+        // Atomic write — write to .tmp then rename
+        const tmp = this.config.dbPath + '.tmp';
+        fs.writeFileSync(tmp, JSON.stringify(shape));
+        fs.renameSync(tmp, this.config.dbPath);
+    }
+    startSyncLoop() {
+        if (this.syncTimer)
+            clearInterval(this.syncTimer);
+        this.syncTimer = setInterval(() => {
+            this.sync().catch(() => { });
+        }, this.config.syncIntervalMs);
+    }
+    refreshStats() {
+        if (!this.initialized)
+            return;
+        this.stats.totalProjects = this.projects.size;
+        this.stats.totalAgents = this.agents.size;
+        this.stats.totalEntries = this.entries.size;
+        this.stats.pendingWrites = this.writeQueue.length;
+        const totalChecks = this.stats.hits + this.stats.misses;
+        this.stats.hitRate = totalChecks > 0 ? this.stats.hits / totalChecks : 0;
+        this.stats.uptime = Date.now() - this.startedAt;
+    }
+    estimateSizeMB() {
+        try {
+            const stat = fs.statSync(this.config.dbPath);
+            return stat.size / (1024 * 1024);
+        }
+        catch {
+            return 0;
+        }
+    }
+    async shutdown() {
+        if (this.syncTimer)
+            clearInterval(this.syncTimer);
+        await this.sync();
+        this.initialized = false;
+        GlobalBrain.instance = null;
+    }
+}
+GlobalBrain.instance = null;
+export function getGlobalBrain(config) {
+    return GlobalBrain.getInstance(config);
+}
+//# sourceMappingURL=global-brain.js.map

package/dist/brain/global-brain.js.map

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

package/dist/brain/hallucination-quarantine.d.ts

@@ -0,0 +1,26 @@
+import { QuarantineEntry } from '../types.js';
+export declare class HallucinationQuarantine {
+    private entries;
+    private brain;
+    private initialized;
+    constructor();
+    init(): Promise<void>;
+    flag(source: string, claim: string, reasonFlagged: string, evidence?: string[]): Promise<QuarantineEntry>;
+    promote(entryId: string, projectId: string, agentTool: string): Promise<boolean>;
+    reject(entryId: string): Promise<boolean>;
+    list(opts?: {
+        pendingOnly?: boolean;
+        limit?: number;
+    }): QuarantineEntry[];
+    stats(): {
+        pending: number;
+        promoted: number;
+        deleted: number;
+        total: number;
+    };
+    private autoExpire;
+    private persist;
+}
+export declare function getHallucinationQuarantine(): HallucinationQuarantine;
+export declare function resetHallucinationQuarantineForTests(): void;
+//# sourceMappingURL=hallucination-quarantine.d.ts.map

package/dist/brain/hallucination-quarantine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hallucination-quarantine.d.ts","sourceRoot":"","sources":["../../src/brain/hallucination-quarantine.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAW9C,qBAAa,uBAAuB;IAClC,OAAO,CAAC,OAAO,CAA2C;IAC1D,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,WAAW,CAAS;;IAMtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBrB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAM,EAAO,GAAG,OAAO,CAAC,eAAe,CAAC;IAgB7G,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAmBhF,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAS/C,IAAI,CAAC,IAAI,GAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,eAAe,EAAE;IAQ7E,KAAK,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;IAc9E,OAAO,CAAC,UAAU;YASJ,OAAO;CAatB;AAID,wBAAgB,0BAA0B,IAAI,uBAAuB,CAGpE;AAED,wBAAgB,oCAAoC,IAAI,IAAI,CAE3D"}

package/dist/brain/hallucination-quarantine.js

@@ -0,0 +1,135 @@
+// src/brain/hallucination-quarantine.ts — Suspect memory isolation
+// v6.0.0 — Hive Mind Edition
+//
+// When Shadow Brain's adversarial defense flags a claim as potentially
+// hallucinated, it goes here instead of the global brain. You can review,
+// promote, or delete. Auto-deletes after 7 days by default.
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import * as crypto from 'crypto';
+import { getGlobalBrain } from './global-brain.js';
+const QUARANTINE_PATH = path.join(os.homedir(), '.shadow-brain', 'hallucination-quarantine.json');
+const AUTO_DELETE_AFTER_MS = 7 * 24 * 60 * 60 * 1000; // 7 days
+export class HallucinationQuarantine {
+    constructor() {
+        this.entries = new Map();
+        this.initialized = false;
+        this.brain = getGlobalBrain();
+    }
+    async init() {
+        if (this.initialized)
+            return;
+        fs.mkdirSync(path.dirname(QUARANTINE_PATH), { recursive: true });
+        if (fs.existsSync(QUARANTINE_PATH)) {
+            try {
+                const parsed = JSON.parse(fs.readFileSync(QUARANTINE_PATH, 'utf-8'));
+                for (const e of parsed.entries ?? []) {
+                    this.entries.set(e.id, { ...e, quarantinedAt: new Date(e.quarantinedAt) });
+                }
+            }
+            catch {
+                /* skip */
+            }
+        }
+        this.autoExpire();
+        this.initialized = true;
+    }
+    async flag(source, claim, reasonFlagged, evidence = []) {
+        await this.init();
+        const entry = {
+            id: `hq-${crypto.randomBytes(6).toString('hex')}`,
+            source,
+            claim: claim.slice(0, 800),
+            evidence,
+            reasonFlagged,
+            quarantinedAt: new Date(),
+            decision: 'pending',
+        };
+        this.entries.set(entry.id, entry);
+        await this.persist();
+        return entry;
+    }
+    async promote(entryId, projectId, agentTool) {
+        await this.init();
+        const entry = this.entries.get(entryId);
+        if (!entry)
+            return false;
+        await this.brain.init();
+        this.brain.writeSync({
+            projectId,
+            projectName: 'promoted-quarantine',
+            agentTool: agentTool,
+            category: 'promoted-from-quarantine',
+            content: entry.claim,
+            importance: 0.6,
+            metadata: { origin: 'quarantine-promoted', quarantineId: entryId, evidence: entry.evidence },
+        });
+        entry.decision = 'promoted';
+        await this.persist();
+        return true;
+    }
+    async reject(entryId) {
+        await this.init();
+        const entry = this.entries.get(entryId);
+        if (!entry)
+            return false;
+        entry.decision = 'deleted';
+        await this.persist();
+        return true;
+    }
+    list(opts = {}) {
+        this.autoExpire();
+        const all = Array.from(this.entries.values())
+            .filter(e => !opts.pendingOnly || e.decision === 'pending')
+            .sort((a, b) => b.quarantinedAt.getTime() - a.quarantinedAt.getTime());
+        return all.slice(0, opts.limit ?? 50);
+    }
+    stats() {
+        let pending = 0;
+        let promoted = 0;
+        let deleted = 0;
+        for (const e of this.entries.values()) {
+            if (e.decision === 'pending')
+                pending++;
+            else if (e.decision === 'promoted')
+                promoted++;
+            else
+                deleted++;
+        }
+        return { pending, promoted, deleted, total: this.entries.size };
+    }
+    // ── Internals ─────────────────────────────────────────────────────────────
+    autoExpire() {
+        const now = Date.now();
+        for (const [id, entry] of this.entries) {
+            if (entry.decision === 'pending' && now - entry.quarantinedAt.getTime() > AUTO_DELETE_AFTER_MS) {
+                entry.decision = 'deleted';
+            }
+        }
+    }
+    async persist() {
+        try {
+            const payload = {
+                schemaVersion: 1,
+                entries: Array.from(this.entries.values()),
+            };
+            const tmp = QUARANTINE_PATH + '.tmp';
+            fs.writeFileSync(tmp, JSON.stringify(payload, null, 2));
+            fs.renameSync(tmp, QUARANTINE_PATH);
+        }
+        catch {
+            /* non-fatal */
+        }
+    }
+}
+let _instance = null;
+export function getHallucinationQuarantine() {
+    if (!_instance)
+        _instance = new HallucinationQuarantine();
+    return _instance;
+}
+export function resetHallucinationQuarantineForTests() {
+    _instance = null;
+}
+//# sourceMappingURL=hallucination-quarantine.js.map

package/dist/brain/hallucination-quarantine.js.map

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

package/dist/brain/hive-accelerator.d.ts

@@ -0,0 +1,39 @@
+import { CausalLink, TurboVector } from '../types.js';
+export interface AcceleratorStatus {
+    ssspNodes: number;
+    ssspEdges: number;
+    turboEntries: number;
+    turboCompressionRatio: number;
+}
+export declare class HiveAccelerator {
+    private sssp;
+    private turbo;
+    private initialized;
+    constructor();
+    init(): Promise<void>;
+    /**
+     * Rebuild the SSSP graph from causal links for O(m log^(2/3) n) traversal.
+     * Each link contributes two directed edges (cause → effect).
+     */
+    buildCausalGraph(links: CausalLink[]): void;
+    /** Run BMSSP from a source node — returns distances + predecessors. */
+    traverseCausal(sourceId: string): any;
+    /**
+     * Store a compressed vector representation of a memory for faster SABB /
+     * heatmap similarity scoring. Uses PolarQuant + QJL (3 bits/dim).
+     */
+    storeCompressed(id: string, vector: number[], metadata?: Record<string, unknown>): Promise<TurboVector | null>;
+    /** Semantic similarity search — returns top-K matching memories. */
+    similaritySearch(queryVector: number[], k?: number): Promise<Array<{
+        id: string;
+        score: number;
+    }>>;
+    /** Convert text to a simple 64-dim vector (character n-gram hash). Cheap, deterministic. */
+    static textToVector(text: string, dim?: number): number[];
+    /** Cosine similarity between two vectors. */
+    static cosine(a: number[], b: number[]): number;
+    status(): AcceleratorStatus;
+}
+export declare function getHiveAccelerator(): HiveAccelerator;
+export declare function resetHiveAcceleratorForTests(): void;
+//# sourceMappingURL=hive-accelerator.d.ts.map

package/dist/brain/hive-accelerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hive-accelerator.d.ts","sourceRoot":"","sources":["../../src/brain/hive-accelerator.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEtD,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,WAAW,CAAS;;IAOtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAK3B;;;OAGG;IACH,gBAAgB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,IAAI;IAc3C,uEAAuE;IACvE,cAAc,CAAC,QAAQ,EAAE,MAAM;IAa/B;;;OAGG;IACG,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAYxH,oEAAoE;IAC9D,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,CAAC,SAAI,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAYnG,4FAA4F;IAC5F,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAK,GAAG,MAAM,EAAE;IAiBrD,6CAA6C;IAC7C,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM;IAY/C,MAAM,IAAI,iBAAiB;CAU5B;AAID,wBAAgB,kBAAkB,IAAI,eAAe,CAGpD;AAED,wBAAgB,4BAA4B,IAAI,IAAI,CAEnD"}