@theihtisham/agent-shadow-brain 5.2.0 → 6.0.2

package/dist/brain/calibration-monitor.js

@@ -0,0 +1,144 @@
+// src/brain/calibration-monitor.ts — Confidence calibration tracking
+// v6.0.0 — Hive Mind Edition
+//
+// Does the AI know when it's right? Track every claim's confidence → outcome.
+// Compute the Brier score per agent per category. Auto-adjust trust weights so
+// downstream consumers can discount overconfident agents.
+//
+// Brier = mean squared error between claimed confidence and 0/1 outcome.
+// Lower = better calibrated.
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+const DATA_PATH = path.join(os.homedir(), '.shadow-brain', 'calibration.json');
+export class CalibrationMonitor {
+    constructor() {
+        this.records = [];
+        this.scores = new Map();
+        this.initialized = false;
+    }
+    async init() {
+        if (this.initialized)
+            return;
+        fs.mkdirSync(path.dirname(DATA_PATH), { recursive: true });
+        if (fs.existsSync(DATA_PATH)) {
+            try {
+                const parsed = JSON.parse(fs.readFileSync(DATA_PATH, 'utf-8'));
+                this.records = (parsed.records ?? []).map(r => ({
+                    ...r,
+                    recordedAt: new Date(r.recordedAt),
+                    outcomeAt: new Date(r.outcomeAt),
+                }));
+                for (const s of parsed.scores ?? []) {
+                    this.scores.set(this.keyFor(s.agentTool, s.category), { ...s, updatedAt: new Date(s.updatedAt) });
+                }
+            }
+            catch {
+                /* skip */
+            }
+        }
+        this.initialized = true;
+    }
+    async record(rec) {
+        await this.init();
+        const full = {
+            ...rec,
+            recordedAt: rec.recordedAt ?? new Date(),
+            outcomeAt: rec.outcomeAt ?? new Date(),
+        };
+        this.records.push(full);
+        const score = this.recomputeScore(full.agentTool, full.category);
+        await this.persist();
+        return score;
+    }
+    getScore(agentTool, category) {
+        return this.scores.get(this.keyFor(agentTool, category)) ?? null;
+    }
+    listScores(limit = 50) {
+        return Array.from(this.scores.values())
+            .sort((a, b) => a.brierScore - b.brierScore)
+            .slice(0, limit);
+    }
+    /** Multiplicative trust weight for a given agent+category (1.0 = as claimed). */
+    trustWeight(agentTool, category) {
+        const s = this.getScore(agentTool, category);
+        if (!s)
+            return 1.0;
+        return s.trustWeight;
+    }
+    // ── Internals ─────────────────────────────────────────────────────────────
+    recomputeScore(agentTool, category) {
+        const relevant = this.records.filter(r => r.agentTool === agentTool && r.category === category);
+        const sampleSize = relevant.length;
+        if (!sampleSize) {
+            const blank = {
+                agentTool,
+                category,
+                sampleSize: 0,
+                brierScore: 0,
+                calibrationError: 0,
+                overconfidenceRatio: 0,
+                trustWeight: 1.0,
+                updatedAt: new Date(),
+            };
+            this.scores.set(this.keyFor(agentTool, category), blank);
+            return blank;
+        }
+        let brierSum = 0;
+        let calErrSum = 0;
+        let overconfidentCount = 0;
+        for (const r of relevant) {
+            const outcomeBinary = r.actualOutcome === 'correct' ? 1 : r.actualOutcome === 'partial' ? 0.5 : 0;
+            const delta = r.claimedConfidence - outcomeBinary;
+            brierSum += delta * delta;
+            calErrSum += Math.abs(delta);
+            if (r.claimedConfidence > 0.7 && outcomeBinary < 0.5)
+                overconfidentCount++;
+        }
+        const brier = brierSum / sampleSize;
+        const calErr = calErrSum / sampleSize;
+        const overconfidenceRatio = overconfidentCount / sampleSize;
+        // Trust weight: 1.0 when calibrated, approaches 0.4 when badly over-confident
+        const trustWeight = +Math.max(0.4, 1 - calErr * 0.8 - overconfidenceRatio * 0.4).toFixed(3);
+        const score = {
+            agentTool,
+            category,
+            sampleSize,
+            brierScore: +brier.toFixed(4),
+            calibrationError: +calErr.toFixed(4),
+            overconfidenceRatio: +overconfidenceRatio.toFixed(3),
+            trustWeight,
+            updatedAt: new Date(),
+        };
+        this.scores.set(this.keyFor(agentTool, category), score);
+        return score;
+    }
+    keyFor(agent, category) {
+        return `${agent}::${category}`;
+    }
+    async persist() {
+        try {
+            const payload = {
+                schemaVersion: 1,
+                records: this.records,
+                scores: Array.from(this.scores.values()),
+            };
+            const tmp = DATA_PATH + '.tmp';
+            fs.writeFileSync(tmp, JSON.stringify(payload, null, 2));
+            fs.renameSync(tmp, DATA_PATH);
+        }
+        catch {
+            /* non-fatal */
+        }
+    }
+}
+let _instance = null;
+export function getCalibrationMonitor() {
+    if (!_instance)
+        _instance = new CalibrationMonitor();
+    return _instance;
+}
+export function resetCalibrationMonitorForTests() {
+    _instance = null;
+}
+//# sourceMappingURL=calibration-monitor.js.map

package/dist/brain/calibration-monitor.js.map

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

package/dist/brain/causal-chains.d.ts

@@ -0,0 +1,37 @@
+import { CausalLink, CausalChain } from '../types.js';
+import { GlobalBrain } from './global-brain.js';
+export declare class CausalChains {
+    private brain;
+    private links;
+    private byEffect;
+    private byCause;
+    private initialized;
+    constructor(brain?: GlobalBrain);
+    init(): Promise<void>;
+    /** Record that `effectId` was caused by `causeId`. */
+    link(effectId: string, causeId: string, rationale?: string, strength?: number): Promise<CausalLink>;
+    /** Walk back from an effect to trace all ancestor causes. */
+    trace(effectId: string, opts?: {
+        maxDepth?: number;
+    }): Promise<CausalChain>;
+    /** Walk forward from a cause to find all effects it influenced. */
+    influence(causeId: string, opts?: {
+        maxDepth?: number;
+    }): Promise<CausalChain>;
+    /** Simple stats for dashboards. */
+    stats(): {
+        totalLinks: number;
+        effects: number;
+        causes: number;
+    };
+    /** Remove a single link. */
+    unlink(linkId: string): Promise<boolean>;
+    private index;
+    private rebuildIndexes;
+    private nodeFromMemoryId;
+    private renderDot;
+    private persist;
+}
+export declare function getCausalChains(): CausalChains;
+export declare function resetCausalChainsForTests(): void;
+//# sourceMappingURL=causal-chains.d.ts.map

package/dist/brain/causal-chains.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"causal-chains.d.ts","sourceRoot":"","sources":["../../src/brain/causal-chains.ts"],"names":[],"mappings":"AAiBA,OAAO,EACL,UAAU,EACV,WAAW,EAGZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAkB,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAShE,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,QAAQ,CAAwC;IACxD,OAAO,CAAC,OAAO,CAAwC;IACvD,OAAO,CAAC,WAAW,CAAS;gBAEhB,KAAK,CAAC,EAAE,WAAW;IAIzB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAuB3B,sDAAsD;IAChD,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,QAAQ,SAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAgBtG,6DAA6D;IACvD,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,WAAW,CAAC;IA8CrF,mEAAmE;IAC7D,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,WAAW,CAAC;IA6CxF,mCAAmC;IACnC,KAAK,IAAI;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAQhE,4BAA4B;IACtB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAY9C,OAAO,CAAC,KAAK;IASb,OAAO,CAAC,cAAc;YAMR,gBAAgB;IA2B9B,OAAO,CAAC,SAAS;YAcH,OAAO;CAatB;AAID,wBAAgB,eAAe,IAAI,YAAY,CAG9C;AAED,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD"}

package/dist/brain/causal-chains.js

@@ -0,0 +1,250 @@
+// src/brain/causal-chains.ts — Causal Memory Chains
+// v6.0.0 — Hive Mind Edition
+//
+// Every other tool logs events. Shadow Brain tracks CAUSES.
+//
+// When a brain write happens, it can optionally record its "parent cause" — the
+// prior memory/decision that led to this new one. Over time this builds a DAG
+// where you can ask: "Why did Claude use bcrypt@12?" and get a rendered chain
+// all the way back to the user's original prompt weeks earlier.
+//
+// Storage: ~/.shadow-brain/causal-chains.json
+// Output: Graphviz DOT + JSON chain trees.
+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 CHAINS_PATH = path.join(os.homedir(), '.shadow-brain', 'causal-chains.json');
+export class CausalChains {
+    constructor(brain) {
+        this.links = new Map();
+        this.byEffect = new Map();
+        this.byCause = new Map();
+        this.initialized = false;
+        this.brain = brain ?? getGlobalBrain();
+    }
+    async init() {
+        if (this.initialized)
+            return;
+        fs.mkdirSync(path.dirname(CHAINS_PATH), { recursive: true });
+        await this.brain.init();
+        if (fs.existsSync(CHAINS_PATH)) {
+            try {
+                const raw = fs.readFileSync(CHAINS_PATH, 'utf-8');
+                const parsed = JSON.parse(raw);
+                if (Array.isArray(parsed.links)) {
+                    for (const link of parsed.links) {
+                        const rehydrated = { ...link, createdAt: new Date(link.createdAt) };
+                        this.links.set(rehydrated.id, rehydrated);
+                        this.index(rehydrated);
+                    }
+                }
+            }
+            catch {
+                /* corrupt file — start fresh */
+            }
+        }
+        this.initialized = true;
+    }
+    /** Record that `effectId` was caused by `causeId`. */
+    async link(effectId, causeId, rationale, strength = 1.0) {
+        await this.init();
+        const link = {
+            id: `cl-${crypto.randomBytes(6).toString('hex')}`,
+            effectId,
+            causeId,
+            rationale,
+            strength: Math.max(0, Math.min(1, strength)),
+            createdAt: new Date(),
+        };
+        this.links.set(link.id, link);
+        this.index(link);
+        await this.persist();
+        return link;
+    }
+    /** Walk back from an effect to trace all ancestor causes. */
+    async trace(effectId, opts = {}) {
+        await this.init();
+        const maxDepth = opts.maxDepth ?? 8;
+        const visited = new Set();
+        const nodesById = new Map();
+        const collectedLinks = [];
+        const queue = [{ id: effectId, depth: 0 }];
+        let maxReachedDepth = 0;
+        while (queue.length) {
+            const { id, depth } = queue.shift();
+            if (visited.has(id))
+                continue;
+            visited.add(id);
+            maxReachedDepth = Math.max(maxReachedDepth, depth);
+            const node = await this.nodeFromMemoryId(id, depth);
+            nodesById.set(id, node);
+            if (depth >= maxDepth)
+                continue;
+            const parents = this.byEffect.get(id) ?? [];
+            for (const link of parents) {
+                collectedLinks.push(link);
+                queue.push({ id: link.causeId, depth: depth + 1 });
+            }
+        }
+        // Fill parents/children
+        for (const link of collectedLinks) {
+            const effect = nodesById.get(link.effectId);
+            const cause = nodesById.get(link.causeId);
+            if (effect && !effect.parents.includes(link.causeId))
+                effect.parents.push(link.causeId);
+            if (cause && !cause.children.includes(link.effectId))
+                cause.children.push(link.effectId);
+        }
+        const nodes = Array.from(nodesById.values());
+        return {
+            rootId: effectId,
+            nodes,
+            links: collectedLinks,
+            maxDepth: maxReachedDepth,
+            generatedAt: new Date(),
+            dot: this.renderDot(nodes, collectedLinks),
+        };
+    }
+    /** Walk forward from a cause to find all effects it influenced. */
+    async influence(causeId, opts = {}) {
+        await this.init();
+        const maxDepth = opts.maxDepth ?? 8;
+        const visited = new Set();
+        const nodesById = new Map();
+        const collectedLinks = [];
+        const queue = [{ id: causeId, depth: 0 }];
+        let maxReachedDepth = 0;
+        while (queue.length) {
+            const { id, depth } = queue.shift();
+            if (visited.has(id))
+                continue;
+            visited.add(id);
+            maxReachedDepth = Math.max(maxReachedDepth, depth);
+            const node = await this.nodeFromMemoryId(id, depth);
+            nodesById.set(id, node);
+            if (depth >= maxDepth)
+                continue;
+            const children = this.byCause.get(id) ?? [];
+            for (const link of children) {
+                collectedLinks.push(link);
+                queue.push({ id: link.effectId, depth: depth + 1 });
+            }
+        }
+        for (const link of collectedLinks) {
+            const effect = nodesById.get(link.effectId);
+            const cause = nodesById.get(link.causeId);
+            if (effect && !effect.parents.includes(link.causeId))
+                effect.parents.push(link.causeId);
+            if (cause && !cause.children.includes(link.effectId))
+                cause.children.push(link.effectId);
+        }
+        const nodes = Array.from(nodesById.values());
+        return {
+            rootId: causeId,
+            nodes,
+            links: collectedLinks,
+            maxDepth: maxReachedDepth,
+            generatedAt: new Date(),
+            dot: this.renderDot(nodes, collectedLinks),
+        };
+    }
+    /** Simple stats for dashboards. */
+    stats() {
+        return {
+            totalLinks: this.links.size,
+            effects: this.byEffect.size,
+            causes: this.byCause.size,
+        };
+    }
+    /** Remove a single link. */
+    async unlink(linkId) {
+        await this.init();
+        const link = this.links.get(linkId);
+        if (!link)
+            return false;
+        this.links.delete(linkId);
+        this.rebuildIndexes();
+        await this.persist();
+        return true;
+    }
+    // ── Internals ─────────────────────────────────────────────────────────────
+    index(link) {
+        const effects = this.byEffect.get(link.effectId) ?? [];
+        effects.push(link);
+        this.byEffect.set(link.effectId, effects);
+        const causes = this.byCause.get(link.causeId) ?? [];
+        causes.push(link);
+        this.byCause.set(link.causeId, causes);
+    }
+    rebuildIndexes() {
+        this.byEffect.clear();
+        this.byCause.clear();
+        for (const link of this.links.values())
+            this.index(link);
+    }
+    async nodeFromMemoryId(id, depth) {
+        const entries = this.brain.recallByIds([id]);
+        const entry = entries[0];
+        if (entry) {
+            return {
+                id,
+                content: entry.content,
+                agentTool: entry.agentTool,
+                category: entry.category,
+                createdAt: entry.createdAt,
+                parents: [],
+                children: [],
+                depth,
+            };
+        }
+        return {
+            id,
+            content: `(memory ${id.slice(0, 8)} not found in global brain)`,
+            agentTool: 'claude-code',
+            category: 'unknown',
+            createdAt: new Date(0),
+            parents: [],
+            children: [],
+            depth,
+        };
+    }
+    renderDot(nodes, links) {
+        const lines = ['digraph CausalChain {', '  rankdir=LR;', '  node [shape=box, style=rounded];'];
+        for (const node of nodes) {
+            const label = `${node.agentTool}\\n[${node.category}]\\n${node.content.slice(0, 60).replace(/"/g, "'")}`;
+            lines.push(`  "${node.id}" [label="${label}"];`);
+        }
+        for (const link of links) {
+            const rationale = link.rationale ? ` [label="${link.rationale.slice(0, 20).replace(/"/g, "'")}"]` : '';
+            lines.push(`  "${link.causeId}" -> "${link.effectId}"${rationale};`);
+        }
+        lines.push('}');
+        return lines.join('\n');
+    }
+    async persist() {
+        try {
+            const payload = {
+                schemaVersion: 1,
+                links: Array.from(this.links.values()),
+            };
+            const tmp = CHAINS_PATH + '.tmp';
+            fs.writeFileSync(tmp, JSON.stringify(payload, null, 2));
+            fs.renameSync(tmp, CHAINS_PATH);
+        }
+        catch {
+            /* persistence non-fatal */
+        }
+    }
+}
+let _instance = null;
+export function getCausalChains() {
+    if (!_instance)
+        _instance = new CausalChains();
+    return _instance;
+}
+export function resetCausalChainsForTests() {
+    _instance = null;
+}
+//# sourceMappingURL=causal-chains.js.map

package/dist/brain/causal-chains.js.map

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

package/dist/brain/collision-detective.d.ts

@@ -0,0 +1,32 @@
+import { AgentEditIntent, CollisionAlert, CollisionStats, AgentTool } from '../types.js';
+export declare class CollisionDetective {
+    private intents;
+    private alerts;
+    private stats;
+    private initialized;
+    init(): Promise<void>;
+    /** Agent declares intent to edit a file range. Returns immediate collision alert if any. */
+    declareIntent(agentTool: AgentTool, sessionId: string, filePath: string, startLine: number, endLine: number, intent: string, ttlMs?: number): Promise<{
+        intent: AgentEditIntent;
+        collision: CollisionAlert | null;
+    }>;
+    /** Release an intent — agent finished or cancelled. */
+    releaseIntent(agentTool: AgentTool, sessionId: string, filePath: string): Promise<number>;
+    /** Mark a collision as resolved (by reassignment, merge, or user action). */
+    resolveCollision(alertId: string, resolution: string): Promise<boolean>;
+    /** All active (unresolved) alerts. */
+    activeAlerts(): CollisionAlert[];
+    /** Current stats snapshot. */
+    getStats(): CollisionStats;
+    /** List active intents (for dashboards / debugging). */
+    activeIntents(): AgentEditIntent[];
+    private detectForIntent;
+    private buildResolutionSuggestion;
+    private keyForIntent;
+    private sameSession;
+    private evictExpired;
+    private persist;
+}
+export declare function getCollisionDetective(): CollisionDetective;
+export declare function resetCollisionDetectiveForTests(): void;
+//# sourceMappingURL=collision-detective.d.ts.map

package/dist/brain/collision-detective.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collision-detective.d.ts","sourceRoot":"","sources":["../../src/brain/collision-detective.ts"],"names":[],"mappings":"AAYA,OAAO,EACL,eAAe,EACf,cAAc,EACd,cAAc,EACd,SAAS,EACV,MAAM,aAAa,CAAC;AAuBrB,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,OAAO,CAA2C;IAC1D,OAAO,CAAC,MAAM,CAA0C;IACxD,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,WAAW,CAAS;IAEtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAqC3B,4FAA4F;IACtF,aAAa,CACjB,SAAS,EAAE,SAAS,EACpB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,KAAK,GAAE,MAA8B,GACpC,OAAO,CAAC;QAAE,MAAM,EAAE,eAAe,CAAC;QAAC,SAAS,EAAE,cAAc,GAAG,IAAI,CAAA;KAAE,CAAC;IAsCzE,uDAAuD;IACjD,aAAa,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAiB/F,6EAA6E;IACvE,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAW7E,sCAAsC;IACtC,YAAY,IAAI,cAAc,EAAE;IAIhC,8BAA8B;IAC9B,QAAQ,IAAI,cAAc;IAM1B,wDAAwD;IACxD,aAAa,IAAI,eAAe,EAAE;IAOlC,OAAO,CAAC,eAAe;IAuCvB,OAAO,CAAC,yBAAyB;IAYjC,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,YAAY;YAQN,OAAO;CAetB;AAID,wBAAgB,qBAAqB,IAAI,kBAAkB,CAG1D;AAED,wBAAgB,+BAA+B,IAAI,IAAI,CAEtD"}