@theihtisham/agent-shadow-brain 5.2.0 → 6.0.0

package/dist/brain/brain-exchange.js

@@ -0,0 +1,106 @@
+// src/brain/brain-exchange.ts — Curated shareable brain slices
+// v6.0.0 — Hive Mind Edition
+//
+// Export a curated subset of your brain as a shareable JSON package. Import
+// someone else's package to instantly get expert knowledge for a domain.
+// Zero-server design: packages are plain JSON files on disk (or shared via
+// gist/HTTP/IPFS — transport is up to the user).
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import * as crypto from 'crypto';
+import { getGlobalBrain, GlobalBrain } from './global-brain.js';
+const EXCHANGE_DIR = path.join(os.homedir(), '.shadow-brain', 'exchange');
+export class BrainExchange {
+    constructor() {
+        this.brain = getGlobalBrain();
+    }
+    async export(opts) {
+        await this.brain.init();
+        fs.mkdirSync(EXCHANGE_DIR, { recursive: true });
+        const categories = opts.categories ?? [];
+        const keywords = opts.tags ?? [];
+        const limit = opts.limit ?? 500;
+        const minImportance = opts.minImportance ?? 0.5;
+        let entries = this.brain.recall({ keywords: keywords.length ? keywords : undefined, minImportance, limit });
+        if (categories.length) {
+            const allowed = new Set(categories.map(c => c.toLowerCase()));
+            entries = entries.filter(e => allowed.has(e.category.toLowerCase()));
+        }
+        const pkg = {
+            id: `pkg-${crypto.randomBytes(6).toString('hex')}`,
+            name: opts.name,
+            description: opts.description,
+            author: opts.author,
+            version: '1.0.0',
+            tags: opts.tags ?? [],
+            categories: Array.from(new Set(entries.map(e => e.category))),
+            memoryCount: entries.length,
+            memories: entries.map(e => ({
+                content: this.redact(e.content),
+                category: e.category,
+                importance: e.importance,
+            })),
+            createdAt: new Date(),
+            license: opts.license ?? 'MIT',
+        };
+        const safeName = opts.name.toLowerCase().replace(/[^a-z0-9_-]+/g, '-');
+        const filePath = path.join(EXCHANGE_DIR, `${safeName}-${pkg.id.slice(-6)}.json`);
+        fs.writeFileSync(filePath, JSON.stringify(pkg, null, 2));
+        return { filePath, package: pkg };
+    }
+    async import(filePath, opts = { projectDir: process.cwd() }) {
+        await this.brain.init();
+        const raw = fs.readFileSync(filePath, 'utf-8');
+        const pkg = JSON.parse(raw);
+        const projectId = GlobalBrain.projectIdFor(opts.projectDir);
+        const projectName = path.basename(opts.projectDir);
+        let imported = 0;
+        for (const m of pkg.memories) {
+            this.brain.writeSync({
+                projectId,
+                projectName,
+                agentTool: opts.agentTool ?? 'claude-code',
+                category: m.category,
+                content: m.content,
+                importance: m.importance,
+                metadata: { origin: 'brain-exchange', packageId: pkg.id, packageName: pkg.name, author: pkg.author },
+            });
+            imported++;
+        }
+        return { imported, pkg };
+    }
+    listLocal() {
+        fs.mkdirSync(EXCHANGE_DIR, { recursive: true });
+        const files = fs.readdirSync(EXCHANGE_DIR).filter(f => f.endsWith('.json'));
+        const out = [];
+        for (const f of files) {
+            try {
+                const raw = fs.readFileSync(path.join(EXCHANGE_DIR, f), 'utf-8');
+                const pkg = JSON.parse(raw);
+                out.push({ ...pkg, createdAt: new Date(pkg.createdAt) });
+            }
+            catch {
+                /* skip */
+            }
+        }
+        return out.sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime());
+    }
+    redact(content) {
+        return content
+            .replace(/(api[_-]?key|secret|token|password|passwd|pwd)\s*[:=]\s*["'][^"']{8,}["']/gi, '$1: [REDACTED]')
+            .replace(/[A-Za-z0-9+/=]{40,}/g, '[REDACTED_BLOB]')
+            .replace(/\b[\w.+-]+@[\w.-]+\.\w{2,}\b/g, '[REDACTED_EMAIL]')
+            .replace(/\b(?:\d{1,3}\.){3}\d{1,3}\b/g, '[REDACTED_IP]');
+    }
+}
+let _instance = null;
+export function getBrainExchange() {
+    if (!_instance)
+        _instance = new BrainExchange();
+    return _instance;
+}
+export function resetBrainExchangeForTests() {
+    _instance = null;
+}
+//# sourceMappingURL=brain-exchange.js.map

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

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

package/dist/brain/brain-garden.d.ts

@@ -0,0 +1,18 @@
+import { GardenNode } from '../types.js';
+export declare class BrainGarden {
+    private brain;
+    private forgetting;
+    private causal;
+    constructor();
+    snapshot(limit?: number): Promise<GardenNode[]>;
+    /** Compact stats used by the dashboard widget. */
+    stats(): Promise<{
+        nodes: number;
+        avgBloom: number;
+        linkedFraction: number;
+    }>;
+    private kindFromCategory;
+}
+export declare function getBrainGarden(): BrainGarden;
+export declare function resetBrainGardenForTests(): void;
+//# sourceMappingURL=brain-garden.d.ts.map

package/dist/brain/brain-garden.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brain-garden.d.ts","sourceRoot":"","sources":["../../src/brain/brain-garden.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,UAAU,EACX,MAAM,aAAa,CAAC;AAKrB,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,MAAM,CAAe;;IAQvB,QAAQ,CAAC,KAAK,SAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAyClD,kDAAkD;IAC5C,KAAK,IAAI,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE,CAAC;IAUnF,OAAO,CAAC,gBAAgB;CAMzB;AAID,wBAAgB,cAAc,IAAI,WAAW,CAG5C;AAED,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C"}

package/dist/brain/brain-garden.js

@@ -0,0 +1,81 @@
+// src/brain/brain-garden.ts — Aesthetic brain-as-garden visualizer data source
+// v6.0.0 — Hive Mind Edition
+//
+// Returns a GardenNode[] snapshot of the brain state formatted for a D3 /
+// three.js / Canvas visualization. Memories "bloom" based on strength; links
+// become "vines" between them. Decaying memories dim. It's a living
+// constellation.
+import { getGlobalBrain } from './global-brain.js';
+import { getForgettingCurve } from './forgetting-curve.js';
+import { getCausalChains } from './causal-chains.js';
+export class BrainGarden {
+    constructor() {
+        this.brain = getGlobalBrain();
+        this.forgetting = getForgettingCurve();
+        this.causal = getCausalChains();
+    }
+    async snapshot(limit = 200) {
+        await this.brain.init();
+        await this.forgetting.init();
+        await this.causal.init();
+        const timeline = this.brain.timeline({ limit });
+        const nodes = [];
+        for (const event of timeline) {
+            const state = this.forgetting.getState(event.id);
+            const strength = state?.currentStrength ?? event.importance;
+            const ageMs = Date.now() - event.createdAt.getTime();
+            const ageDays = ageMs / (1000 * 60 * 60 * 24);
+            nodes.push({
+                id: event.id,
+                kind: this.kindFromCategory(event.category),
+                label: event.content.slice(0, 80),
+                age: +ageDays.toFixed(1),
+                strength: +strength.toFixed(3),
+                connections: [],
+                bloom: Math.max(0.1, Math.min(1, strength * (1 - Math.min(1, ageDays / 90)))),
+            });
+        }
+        // Enrich connections from causal chains (fire-and-forget — keep cheap)
+        for (const node of nodes) {
+            try {
+                const chain = await this.causal.trace(node.id, { maxDepth: 2 });
+                node.connections = chain.nodes
+                    .filter(n => n.id !== node.id)
+                    .slice(0, 6)
+                    .map(n => n.id);
+            }
+            catch {
+                node.connections = [];
+            }
+        }
+        return nodes;
+    }
+    /** Compact stats used by the dashboard widget. */
+    async stats() {
+        const nodes = await this.snapshot(150);
+        if (!nodes.length)
+            return { nodes: 0, avgBloom: 0, linkedFraction: 0 };
+        const avg = nodes.reduce((a, n) => a + n.bloom, 0) / nodes.length;
+        const linked = nodes.filter(n => n.connections.length > 0).length / nodes.length;
+        return { nodes: nodes.length, avgBloom: +avg.toFixed(3), linkedFraction: +linked.toFixed(3) };
+    }
+    // ── Internals ─────────────────────────────────────────────────────────────
+    kindFromCategory(category) {
+        const c = category.toLowerCase();
+        if (c.includes('decision') || c.includes('adr'))
+            return 'decision';
+        if (c.includes('pattern'))
+            return 'pattern';
+        return 'memory';
+    }
+}
+let _instance = null;
+export function getBrainGarden() {
+    if (!_instance)
+        _instance = new BrainGarden();
+    return _instance;
+}
+export function resetBrainGardenForTests() {
+    _instance = null;
+}
+//# sourceMappingURL=brain-garden.js.map

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

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

package/dist/brain/brain-portability.js

@@ -35,7 +35,7 @@ export class BrainPortability {
         const fileName = `brain-${projectName}-${timestamp}.json`;
         const filePath = path.join(this.exportDir, fileName);
         const data = {
-            version: '5.0.1',
+            version: '5.2.0',
             exportedAt: new Date(),
             projectName,
             projectDir: this.projectDir,

package/dist/brain/branch-brain.d.ts

@@ -0,0 +1,23 @@
+import { BranchBrainState, BranchMemoryTag } from '../types.js';
+export declare class BranchBrain {
+    private brain;
+    private tags;
+    private lastBranchByProject;
+    private initialized;
+    constructor();
+    init(): Promise<void>;
+    /** Current branch from git for the given project dir. */
+    currentBranch(projectDir: string): Promise<string>;
+    /** Tag a memory as either global or branch-scoped. */
+    tag(memoryId: string, branch: string, scope?: 'branch' | 'global'): Promise<BranchMemoryTag>;
+    /** Return the set of memory IDs active for a branch (branch-scoped + global). */
+    activeMemoryIds(branch: string): string[];
+    /** Compute + return the current branch brain state. */
+    getState(projectDir: string): Promise<BranchBrainState>;
+    /** Promote a branch-scoped memory to global (e.g., after merging). */
+    promoteToGlobal(memoryId: string): Promise<boolean>;
+    private persist;
+}
+export declare function getBranchBrain(): BranchBrain;
+export declare function resetBranchBrainForTests(): void;
+//# sourceMappingURL=branch-brain.d.ts.map

package/dist/brain/branch-brain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch-brain.d.ts","sourceRoot":"","sources":["../../src/brain/branch-brain.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,gBAAgB,EAChB,eAAe,EAChB,MAAM,aAAa,CAAC;AAWrB,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,IAAI,CAA6C;IACzD,OAAO,CAAC,mBAAmB,CAAkC;IAC7D,OAAO,CAAC,WAAW,CAAS;;IAMtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB3B,yDAAyD;IACnD,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAUxD,sDAAsD;IAChD,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,QAAQ,GAAG,QAAmB,GAAG,OAAO,CAAC,eAAe,CAAC;IAe5G,iFAAiF;IACjF,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE;IAazC,uDAAuD;IACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAyC7D,sEAAsE;IAChE,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;YAW3C,OAAO;CAgBtB;AAID,wBAAgB,cAAc,IAAI,WAAW,CAG5C;AAED,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C"}

package/dist/brain/branch-brain.js

@@ -0,0 +1,159 @@
+// src/brain/branch-brain.ts — Branch Brains (git-aware memory context)
+// v6.0.0 — Hive Mind Edition
+//
+// When you switch git branches, the brain's active memory set switches too.
+// Memories are tagged `branch:<name>` or `global` when created. Git-aware
+// filtering keeps the mental model aligned with the branch you're on.
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { getGlobalBrain, GlobalBrain } from './global-brain.js';
+const TAGS_PATH = path.join(os.homedir(), '.shadow-brain', 'branch-tags.json');
+export class BranchBrain {
+    constructor() {
+        this.tags = new Map(); // memoryId → tags
+        this.lastBranchByProject = new Map();
+        this.initialized = false;
+        this.brain = getGlobalBrain();
+    }
+    async init() {
+        if (this.initialized)
+            return;
+        fs.mkdirSync(path.dirname(TAGS_PATH), { recursive: true });
+        await this.brain.init();
+        if (fs.existsSync(TAGS_PATH)) {
+            try {
+                const parsed = JSON.parse(fs.readFileSync(TAGS_PATH, 'utf-8'));
+                for (const t of parsed.tags ?? []) {
+                    const rehy = { ...t, taggedAt: new Date(t.taggedAt) };
+                    const existing = this.tags.get(rehy.memoryId) ?? [];
+                    existing.push(rehy);
+                    this.tags.set(rehy.memoryId, existing);
+                }
+                for (const [proj, br] of Object.entries(parsed.lastBranchByProject ?? {})) {
+                    this.lastBranchByProject.set(proj, br);
+                }
+            }
+            catch {
+                /* skip */
+            }
+        }
+        this.initialized = true;
+    }
+    /** Current branch from git for the given project dir. */
+    async currentBranch(projectDir) {
+        try {
+            const { execa } = await import('execa');
+            const { stdout } = await execa('git', ['branch', '--show-current'], { cwd: projectDir, reject: false });
+            return stdout.trim() || 'HEAD';
+        }
+        catch {
+            return 'HEAD';
+        }
+    }
+    /** Tag a memory as either global or branch-scoped. */
+    async tag(memoryId, branch, scope = 'branch') {
+        await this.init();
+        const tag = {
+            memoryId,
+            branch,
+            scope,
+            taggedAt: new Date(),
+        };
+        const existing = this.tags.get(memoryId) ?? [];
+        existing.push(tag);
+        this.tags.set(memoryId, existing);
+        await this.persist();
+        return tag;
+    }
+    /** Return the set of memory IDs active for a branch (branch-scoped + global). */
+    activeMemoryIds(branch) {
+        const ids = new Set();
+        for (const [memoryId, tagList] of this.tags) {
+            for (const t of tagList) {
+                if (t.scope === 'global' || t.branch === branch) {
+                    ids.add(memoryId);
+                    break;
+                }
+            }
+        }
+        return Array.from(ids);
+    }
+    /** Compute + return the current branch brain state. */
+    async getState(projectDir) {
+        await this.init();
+        const branch = await this.currentBranch(projectDir);
+        const projectId = GlobalBrain.projectIdFor(projectDir);
+        const last = this.lastBranchByProject.get(projectId);
+        let branchCount = 0;
+        let globalCount = 0;
+        const branchCategories = new Set();
+        const activeIds = this.activeMemoryIds(branch);
+        const branchActiveOnly = new Set();
+        for (const [memoryId, tagList] of this.tags) {
+            const hasGlobal = tagList.some(t => t.scope === 'global');
+            const hasThisBranch = tagList.some(t => t.scope === 'branch' && t.branch === branch);
+            if (hasGlobal)
+                globalCount++;
+            if (hasThisBranch) {
+                branchCount++;
+                branchActiveOnly.add(memoryId);
+            }
+        }
+        // Enrich branch categories from the brain
+        const branchEntries = this.brain.recallByIds(Array.from(branchActiveOnly));
+        for (const e of branchEntries)
+            branchCategories.add(e.category);
+        if (last !== branch) {
+            this.lastBranchByProject.set(projectId, branch);
+            await this.persist();
+        }
+        return {
+            currentBranch: branch,
+            activeMemoryIds: activeIds,
+            branchMemoryCount: branchCount,
+            globalMemoryCount: globalCount,
+            lastSwitchAt: new Date(),
+            branchSpecificCategories: Array.from(branchCategories),
+        };
+    }
+    /** Promote a branch-scoped memory to global (e.g., after merging). */
+    async promoteToGlobal(memoryId) {
+        await this.init();
+        const list = this.tags.get(memoryId);
+        if (!list)
+            return false;
+        list.push({ memoryId, branch: '*', scope: 'global', taggedAt: new Date() });
+        await this.persist();
+        return true;
+    }
+    // ── Internals ─────────────────────────────────────────────────────────────
+    async persist() {
+        try {
+            const flat = [];
+            for (const list of this.tags.values())
+                flat.push(...list);
+            const payload = {
+                schemaVersion: 1,
+                tags: flat,
+                lastBranchByProject: Object.fromEntries(this.lastBranchByProject.entries()),
+            };
+            const tmp = TAGS_PATH + '.tmp';
+            fs.writeFileSync(tmp, JSON.stringify(payload, null, 2));
+            fs.renameSync(tmp, TAGS_PATH);
+        }
+        catch {
+            /* non-fatal */
+        }
+    }
+}
+let _instance = null;
+export function getBranchBrain() {
+    if (!_instance)
+        _instance = new BranchBrain();
+    return _instance;
+}
+export function resetBranchBrainForTests() {
+    _instance = null;
+}
+//# sourceMappingURL=branch-brain.js.map

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

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

package/dist/brain/calibration-monitor.d.ts

@@ -0,0 +1,20 @@
+import { AgentTool, CalibrationRecord, CalibrationScore } from '../types.js';
+export declare class CalibrationMonitor {
+    private records;
+    private scores;
+    private initialized;
+    init(): Promise<void>;
+    record(rec: Omit<CalibrationRecord, 'recordedAt'> & {
+        recordedAt?: Date;
+    }): Promise<CalibrationScore>;
+    getScore(agentTool: AgentTool, category: string): CalibrationScore | null;
+    listScores(limit?: number): CalibrationScore[];
+    /** Multiplicative trust weight for a given agent+category (1.0 = as claimed). */
+    trustWeight(agentTool: AgentTool, category: string): number;
+    private recomputeScore;
+    private keyFor;
+    private persist;
+}
+export declare function getCalibrationMonitor(): CalibrationMonitor;
+export declare function resetCalibrationMonitorForTests(): void;
+//# sourceMappingURL=calibration-monitor.d.ts.map

package/dist/brain/calibration-monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calibration-monitor.d.ts","sourceRoot":"","sources":["../../src/brain/calibration-monitor.ts"],"names":[],"mappings":"AAaA,OAAO,EACL,SAAS,EACT,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,aAAa,CAAC;AAUrB,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,MAAM,CAA4C;IAC1D,OAAO,CAAC,WAAW,CAAS;IAEtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBrB,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,iBAAiB,EAAE,YAAY,CAAC,GAAG;QAAE,UAAU,CAAC,EAAE,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAa3G,QAAQ,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAIzE,UAAU,CAAC,KAAK,SAAK,GAAG,gBAAgB,EAAE;IAM1C,iFAAiF;IACjF,WAAW,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAQ3D,OAAO,CAAC,cAAc;IAiDtB,OAAO,CAAC,MAAM;YAIA,OAAO;CActB;AAID,wBAAgB,qBAAqB,IAAI,kBAAkB,CAG1D;AAED,wBAAgB,+BAA+B,IAAI,IAAI,CAEtD"}

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