@theihtisham/agent-shadow-brain 5.2.0 → 6.0.2

package/dist/brain/pr-auto-review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr-auto-review.d.ts","sourceRoot":"","sources":["../../src/brain/pr-auto-review.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,eAAe,EAEhB,MAAM,aAAa,CAAC;AAGrB,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAc;;IAMrB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,CAAC;IAiD9D,OAAO,CAAC,YAAY;CAQrB;AAID,wBAAgB,eAAe,IAAI,YAAY,CAG9C;AAED,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD"}

package/dist/brain/pr-auto-review.js

@@ -0,0 +1,73 @@
+// src/brain/pr-auto-review.ts — PR review with brain context
+// v6.0.0 — Hive Mind Edition
+//
+// Generates a Markdown review comment for a PR that cites brain memories.
+// Does NOT post — returns a string you can post via gh CLI or github API.
+import { getGlobalBrain, GlobalBrain } from './global-brain.js';
+export class PRAutoReview {
+    constructor() {
+        this.brain = getGlobalBrain();
+    }
+    async generate(input) {
+        await this.brain.init();
+        const projectId = GlobalBrain.projectIdFor(input.projectDir);
+        const terms = this.extractTerms(`${input.diffSummary} ${input.changedFiles.join(' ')}`);
+        const relevant = this.brain.recall({ projectId, keywords: terms, limit: 30 });
+        const matches = [];
+        const contradictions = [];
+        const suggestions = [];
+        const citations = [];
+        for (const entry of relevant.slice(0, 12)) {
+            const snippet = entry.content.slice(0, 160);
+            citations.push({ memoryId: entry.id, snippet });
+            const category = entry.category.toLowerCase();
+            if (category.includes('warning') || category.includes('pitfall') || category.includes('failure')) {
+                contradictions.push(`⚠️  Prior issue: ${snippet}`);
+            }
+            else if (category.includes('pattern') || category.includes('decision')) {
+                matches.push(`✅ Matches pattern: ${snippet}`);
+            }
+            else {
+                suggestions.push(`💡 Related memory: ${snippet}`);
+            }
+        }
+        if (!matches.length && !contradictions.length && !suggestions.length) {
+            suggestions.push('No directly related project memories found. Brain is still learning.');
+        }
+        const body = [
+            `## Shadow Brain Review (${relevant.length} memories considered)`,
+            ``,
+            `**Changed files:** ${input.changedFiles.slice(0, 10).join(', ')}`,
+            ``,
+            matches.length ? `### Pattern matches\n${matches.join('\n')}` : '',
+            contradictions.length ? `\n### Past issues to re-check\n${contradictions.join('\n')}` : '',
+            suggestions.length ? `\n### Suggestions\n${suggestions.join('\n')}` : '',
+            `\n---\n<sub>_Shadow Brain v6.0 · Hive Mind — https://github.com/theihtisham/agent-shadow-brain_</sub>`,
+        ].filter(Boolean).join('\n');
+        return {
+            prNumber: input.prNumber,
+            repo: input.repo,
+            body,
+            sections: { matches, contradictions, suggestions, citations },
+            generatedAt: new Date(),
+        };
+    }
+    extractTerms(text) {
+        return text
+            .toLowerCase()
+            .replace(/[^a-z0-9\s-_./]/g, ' ')
+            .split(/\s+/)
+            .filter(w => w.length > 3 && !['file', 'files', 'diff', 'added', 'removed', 'changed', 'modified'].includes(w))
+            .slice(0, 15);
+    }
+}
+let _instance = null;
+export function getPRAutoReview() {
+    if (!_instance)
+        _instance = new PRAutoReview();
+    return _instance;
+}
+export function resetPRAutoReviewForTests() {
+    _instance = null;
+}
+//# sourceMappingURL=pr-auto-review.js.map

package/dist/brain/pr-auto-review.js.map

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

package/dist/brain/pre-mortem.d.ts

@@ -0,0 +1,21 @@
+import { PreMortemReport } from '../types.js';
+export declare class PreMortem {
+    private brain;
+    private llm;
+    constructor();
+    /** Run a pre-mortem on an upcoming task. */
+    run(taskDescription: string, projectDir: string, opts?: {
+        limit?: number;
+    }): Promise<PreMortemReport>;
+    private semanticRerank;
+    private extractTerms;
+    private estimateProbability;
+    private mapImportanceToSeverity;
+    private deriveMitigation;
+    private scoreRisk;
+    private summarize;
+    private llmPredictions;
+}
+export declare function getPreMortem(): PreMortem;
+export declare function resetPreMortemForTests(): void;
+//# sourceMappingURL=pre-mortem.d.ts.map

package/dist/brain/pre-mortem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pre-mortem.d.ts","sourceRoot":"","sources":["../../src/brain/pre-mortem.ts"],"names":[],"mappings":"AAYA,OAAO,EAEL,eAAe,EAEhB,MAAM,aAAa,CAAC;AAWrB,qBAAa,SAAS;IACpB,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,GAAG,CAAW;;IAOtB,4CAA4C;IACtC,GAAG,CAAC,eAAe,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,eAAe,CAAC;YA6DjG,cAAc;IAkB5B,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,mBAAmB;IAQ3B,OAAO,CAAC,uBAAuB;IAO/B,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,SAAS;IAUjB,OAAO,CAAC,SAAS;YAQH,cAAc;CA2D7B;AAID,wBAAgB,YAAY,IAAI,SAAS,CAGxC;AAED,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}

package/dist/brain/pre-mortem.js

@@ -0,0 +1,210 @@
+// src/brain/pre-mortem.ts — Pre-Mortem Assistant
+// v6.0.0 — Hive Mind Edition
+//
+// Before any significant task, surface past failures from THIS project as a
+// pre-flight checklist. Inspired by Karpathy's red-team pillar — codified as
+// brain infrastructure.
+//
+// Query: "Adding payment processing"
+// Answer: "Here are 3 ways this could fail, each with a memory citation."
+import * as crypto from 'crypto';
+import { getGlobalBrain, GlobalBrain } from './global-brain.js';
+import { getLocalLLM } from './local-llm.js';
+import { getEmbeddings } from './embeddings.js';
+import { generateJson, z } from './json-output.js';
+const FAILURE_CATEGORIES = new Set([
+    'incident', 'bug', 'failure', 'regression', 'rollback',
+    'outage', 'pitfall', 'warning', 'security',
+]);
+export class PreMortem {
+    constructor() {
+        this.brain = getGlobalBrain();
+        this.llm = getLocalLLM();
+    }
+    /** Run a pre-mortem on an upcoming task. */
+    async run(taskDescription, projectDir, opts = {}) {
+        await this.brain.init();
+        const projectId = GlobalBrain.projectIdFor(projectDir);
+        const terms = this.extractTerms(taskDescription);
+        // Broad initial recall — we re-rank semantically next
+        const projectPool = this.brain.recall({ projectId, limit: 120 })
+            .filter(e => FAILURE_CATEGORIES.has(e.category.toLowerCase()));
+        const crossPool = this.brain.recall({ limit: 120, minImportance: 0.5 })
+            .filter(e => FAILURE_CATEGORIES.has(e.category.toLowerCase()) && e.projectId !== projectId);
+        // Semantic re-rank using embeddings for sharper failure retrieval
+        const pastFailures = await this.semanticRerank(taskDescription, projectPool, 10);
+        const crossProject = await this.semanticRerank(taskDescription, crossPool, 6);
+        void terms; // retained for future keyword fallback
+        const failures = [];
+        for (const entry of pastFailures.slice(0, opts.limit ?? 5)) {
+            failures.push({
+                id: `pm-${crypto.randomBytes(4).toString('hex')}`,
+                description: entry.content.slice(0, 220),
+                source: 'past-incident',
+                probability: this.estimateProbability(entry),
+                severity: this.mapImportanceToSeverity(entry.importance),
+                mitigation: this.deriveMitigation(entry),
+                relatedMemoryIds: [entry.id],
+            });
+        }
+        for (const entry of crossProject.slice(0, 3)) {
+            failures.push({
+                id: `pm-${crypto.randomBytes(4).toString('hex')}`,
+                description: `(similar project ${entry.projectName}) ${entry.content.slice(0, 180)}`,
+                source: 'similar-project',
+                probability: 0.35,
+                severity: this.mapImportanceToSeverity(entry.importance),
+                mitigation: this.deriveMitigation(entry),
+                relatedMemoryIds: [entry.id],
+            });
+        }
+        // LLM-predicted failures (best-effort, local-first)
+        if (failures.length < 3) {
+            const predicted = await this.llmPredictions(taskDescription, 3 - failures.length);
+            failures.push(...predicted);
+        }
+        const riskScore = this.scoreRisk(failures);
+        return {
+            taskDescription,
+            generatedAt: new Date(),
+            failures,
+            riskScore,
+            summary: this.summarize(taskDescription, failures, riskScore),
+        };
+    }
+    // ── Internals ─────────────────────────────────────────────────────────────
+    async semanticRerank(query, candidates, topK) {
+        if (!candidates.length)
+            return [];
+        try {
+            const emb = getEmbeddings();
+            await emb.init();
+            const ranked = await emb.semanticSearch(query, candidates.map(c => ({ id: c.id, text: `${c.category}: ${c.content}` })), topK);
+            const byId = new Map(candidates.map(c => [c.id, c]));
+            return ranked.map(r => byId.get(r.id)).filter((c) => !!c);
+        }
+        catch {
+            // Fall back to naive importance ordering
+            return candidates.slice(0, topK);
+        }
+    }
+    extractTerms(task) {
+        return task
+            .toLowerCase()
+            .replace(/[^a-z0-9\s-]/g, ' ')
+            .split(/\s+/)
+            .filter(w => w.length > 3)
+            .slice(0, 10);
+    }
+    estimateProbability(entry) {
+        // Heuristic: recent + high-access failures are more likely to recur
+        const ageDays = (Date.now() - new Date(entry.createdAt).getTime()) / (1000 * 60 * 60 * 24);
+        const recencyBoost = Math.max(0.2, 1 - ageDays / 180);
+        const accessBoost = Math.min(0.6, entry.accessCount * 0.05);
+        return Math.min(0.9, 0.2 + recencyBoost * 0.5 + accessBoost);
+    }
+    mapImportanceToSeverity(imp) {
+        if (imp >= 0.85)
+            return 'critical';
+        if (imp >= 0.7)
+            return 'high';
+        if (imp >= 0.4)
+            return 'medium';
+        return 'low';
+    }
+    deriveMitigation(entry) {
+        const mitigationHint = entry.metadata?.mitigation
+            ?? entry.metadata?.fix
+            ?? null;
+        if (mitigationHint)
+            return mitigationHint.slice(0, 200);
+        return `Review "${entry.content.slice(0, 80)}" before this task; the same pitfall happened on ${new Date(entry.createdAt).toDateString()}.`;
+    }
+    scoreRisk(failures) {
+        if (!failures.length)
+            return 0.05;
+        const severityWeights = { critical: 1, high: 0.7, medium: 0.4, low: 0.15 };
+        let score = 0;
+        for (const f of failures) {
+            score = Math.max(score, f.probability * severityWeights[f.severity]);
+        }
+        return Math.min(1, score);
+    }
+    summarize(task, failures, risk) {
+        if (!failures.length) {
+            return `No relevant past failures found for "${task.slice(0, 60)}". Proceed with standard best-practices.`;
+        }
+        const pct = Math.round(risk * 100);
+        return `${failures.length} failure modes surfaced (risk ${pct}%). Top: "${failures[0].description.slice(0, 120)}".`;
+    }
+    async llmPredictions(task, n) {
+        if (n <= 0)
+            return [];
+        // Use structured JSON output via ModelRegistry for reliability
+        const FailureSchema = z.object({
+            failures: z.array(z.object({
+                description: z.string().min(4).max(280),
+                probability: z.number().min(0).max(1),
+                severity: z.enum(['low', 'medium', 'high', 'critical']),
+                mitigation: z.string().min(4).max(260),
+            })).max(6),
+        });
+        try {
+            const result = await generateJson(`Task to pre-mortem: "${task}"\n\nList up to ${n} realistic ways this task could fail, each with severity, probability, and a one-sentence mitigation. Return JSON: {"failures": [{"description": "...", "probability": 0.0-1.0, "severity": "low|medium|high|critical", "mitigation": "..."}]}`, FailureSchema, {
+                system: 'You are a skeptical senior engineer running a pre-mortem. Be concrete, never generic. Output JSON only.',
+                featureName: 'pre-mortem',
+                maxTokens: 500,
+                fallback: { failures: [] },
+            });
+            return result.value.failures.slice(0, n).map(f => ({
+                id: `pm-${crypto.randomBytes(4).toString('hex')}`,
+                description: f.description,
+                source: 'llm-predicted',
+                probability: f.probability,
+                severity: f.severity,
+                mitigation: f.mitigation,
+                relatedMemoryIds: [],
+            }));
+        }
+        catch {
+            // Fall back to LocalLLM free-text parsing
+            try {
+                const prompt = `Task: ${task}\n\nList up to ${n} ways this task could realistically fail. For each give: 1) failure 2) mitigation.`;
+                const res = await this.llm.generate(prompt, 'You are a skeptical engineer.');
+                const text = res.text.trim();
+                if (!text)
+                    return [];
+                const failures = [];
+                const blocks = text.split(/\n(?=\d+\.)/).slice(0, n);
+                for (const block of blocks) {
+                    const clean = block.replace(/^\d+\.\s*/, '').trim();
+                    if (!clean)
+                        continue;
+                    const [fail, mit = ''] = clean.split(/Mitigation[:\-]\s*|mitigation[:\-]\s*|\n/).filter(Boolean);
+                    failures.push({
+                        id: `pm-${crypto.randomBytes(4).toString('hex')}`,
+                        description: (fail ?? '').slice(0, 220),
+                        source: 'llm-predicted',
+                        probability: 0.3, severity: 'medium',
+                        mitigation: (mit || 'Add validation/defensive logging.').slice(0, 200),
+                        relatedMemoryIds: [],
+                    });
+                }
+                return failures;
+            }
+            catch {
+                return [];
+            }
+        }
+    }
+}
+let _instance = null;
+export function getPreMortem() {
+    if (!_instance)
+        _instance = new PreMortem();
+    return _instance;
+}
+export function resetPreMortemForTests() {
+    _instance = null;
+}
+//# sourceMappingURL=pre-mortem.js.map

package/dist/brain/pre-mortem.js.map

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

package/dist/brain/prompt-cache.d.ts

@@ -0,0 +1,54 @@
+export interface PromptCacheEntry {
+    key: string;
+    response: any;
+    storedAt: number;
+    hits: number;
+    lastAccessed: number;
+    bytes: number;
+}
+export interface PromptCacheStats {
+    entries: number;
+    bytes: number;
+    hits: number;
+    misses: number;
+    hitRate: number;
+    savings: {
+        estimatedTokensSaved: number;
+        estimatedUsdSaved: number;
+    };
+}
+export declare class PromptCache {
+    private maxEntries;
+    private byteBudget;
+    private ttlMs;
+    private map;
+    private bytes;
+    private hits;
+    private misses;
+    private tokensSaved;
+    private usdSaved;
+    constructor(maxEntries?: number, byteBudget?: number, ttlMs?: number);
+    private keyFor;
+    /** Wrap a call. If cached and fresh, return cached. Otherwise call fn, store, return. */
+    wrap<T>(inputs: {
+        prompt: string;
+        system?: string;
+        model?: string;
+        provider?: string;
+        estimatedTokens?: number;
+        estimatedCostUsd?: number;
+    }, fn: () => Promise<T>): Promise<T>;
+    invalidate(inputs: {
+        prompt: string;
+        system?: string;
+        model?: string;
+        provider?: string;
+    }): boolean;
+    stats(): PromptCacheStats;
+    clear(): void;
+    private store;
+    private evictLRU;
+}
+export declare function getPromptCache(): PromptCache;
+export declare function resetPromptCacheForTests(): void;
+//# sourceMappingURL=prompt-cache.d.ts.map

package/dist/brain/prompt-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-cache.d.ts","sourceRoot":"","sources":["../../src/brain/prompt-cache.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,GAAG,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE;QACP,oBAAoB,EAAE,MAAM,CAAC;QAC7B,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;CACH;AAMD,qBAAa,WAAW;IASpB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,KAAK;IAVf,OAAO,CAAC,GAAG,CAA4C;IACvD,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,IAAI,CAAK;IACjB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,QAAQ,CAAK;gBAGX,UAAU,SAAsB,EAChC,UAAU,SAAuB,EACjC,KAAK,SAAiB;IAGhC,OAAO,CAAC,MAAM;IAId,yFAAyF;IACnF,IAAI,CAAC,CAAC,EACV,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAE,EACnI,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC,CAAC,CAAC;IAkBb,UAAU,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO;IASnG,KAAK,IAAI,gBAAgB;IAYzB,KAAK,IAAI,IAAI;IAQb,OAAO,CAAC,KAAK;IAWb,OAAO,CAAC,QAAQ;CAUjB;AAGD,wBAAgB,cAAc,IAAI,WAAW,CAG5C;AACD,wBAAgB,wBAAwB,IAAI,IAAI,CAAsB"}

package/dist/brain/prompt-cache.js

@@ -0,0 +1,105 @@
+// src/brain/prompt-cache.ts — LRU cache for LLM responses
+// v6.0.0 — Hive Mind Edition
+//
+// Wraps any async generate function with deterministic response caching.
+// SHA-256 of (prompt + system + model) → response. Hit rate tracked for
+// observability in the dashboard.
+import * as crypto from 'crypto';
+const DEFAULT_MAX_ENTRIES = 500;
+const DEFAULT_BYTES_BUDGET = 32 * 1024 * 1024; // 32MB
+const DEFAULT_TTL_MS = 60 * 60 * 1000; // 1h
+export class PromptCache {
+    constructor(maxEntries = DEFAULT_MAX_ENTRIES, byteBudget = DEFAULT_BYTES_BUDGET, ttlMs = DEFAULT_TTL_MS) {
+        this.maxEntries = maxEntries;
+        this.byteBudget = byteBudget;
+        this.ttlMs = ttlMs;
+        this.map = new Map();
+        this.bytes = 0;
+        this.hits = 0;
+        this.misses = 0;
+        this.tokensSaved = 0;
+        this.usdSaved = 0;
+    }
+    keyFor(inputs) {
+        return crypto.createHash('sha256').update(JSON.stringify({ p: inputs.prompt, s: inputs.system ?? '', m: inputs.model ?? '', v: inputs.provider ?? '' })).digest('hex');
+    }
+    /** Wrap a call. If cached and fresh, return cached. Otherwise call fn, store, return. */
+    async wrap(inputs, fn) {
+        const key = this.keyFor(inputs);
+        const now = Date.now();
+        const hit = this.map.get(key);
+        if (hit && now - hit.storedAt < this.ttlMs) {
+            hit.hits++;
+            hit.lastAccessed = now;
+            this.hits++;
+            this.tokensSaved += inputs.estimatedTokens ?? 0;
+            this.usdSaved += inputs.estimatedCostUsd ?? 0;
+            return hit.response;
+        }
+        this.misses++;
+        const response = await fn();
+        this.store(key, response, now);
+        return response;
+    }
+    invalidate(inputs) {
+        const key = this.keyFor(inputs);
+        const hit = this.map.get(key);
+        if (!hit)
+            return false;
+        this.bytes -= hit.bytes;
+        this.map.delete(key);
+        return true;
+    }
+    stats() {
+        const total = this.hits + this.misses;
+        return {
+            entries: this.map.size,
+            bytes: this.bytes,
+            hits: this.hits,
+            misses: this.misses,
+            hitRate: total ? this.hits / total : 0,
+            savings: { estimatedTokensSaved: this.tokensSaved, estimatedUsdSaved: +this.usdSaved.toFixed(4) },
+        };
+    }
+    clear() {
+        this.map.clear();
+        this.bytes = 0;
+        this.hits = 0;
+        this.misses = 0;
+        this.tokensSaved = 0;
+        this.usdSaved = 0;
+    }
+    // ── internals ────────────────────────────────────────────────────────
+    store(key, value, now) {
+        const serialized = JSON.stringify(value);
+        const size = serialized.length * 2;
+        while ((this.map.size >= this.maxEntries || this.bytes + size > this.byteBudget) && this.map.size > 0) {
+            this.evictLRU();
+        }
+        const entry = { key, response: value, storedAt: now, hits: 0, lastAccessed: now, bytes: size };
+        this.map.set(key, entry);
+        this.bytes += size;
+    }
+    evictLRU() {
+        let oldestKey = null;
+        let oldestTime = Infinity;
+        for (const [k, v] of this.map)
+            if (v.lastAccessed < oldestTime) {
+                oldestTime = v.lastAccessed;
+                oldestKey = k;
+            }
+        if (oldestKey) {
+            const v = this.map.get(oldestKey);
+            this.bytes -= v.bytes;
+            this.map.delete(oldestKey);
+        }
+    }
+}
+let _instance = null;
+export function getPromptCache() {
+    if (!_instance)
+        _instance = new PromptCache();
+    return _instance;
+}
+export function resetPromptCacheForTests() { _instance = null; }
+//# sourceMappingURL=prompt-cache.js.map

package/dist/brain/prompt-cache.js.map

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

package/dist/brain/reputation-ledger.d.ts

@@ -0,0 +1,42 @@
+import { AgentDecisionReceipt, AgentTool, ReputationLedgerStats, ReputationScore } from '../types.js';
+export declare class ReputationLedger {
+    private receipts;
+    private scores;
+    private keyPairs;
+    private ledgerHash;
+    private initialized;
+    init(): Promise<void>;
+    /** Sign and record a decision. Returns receipt with signature. */
+    sign(input: {
+        agentTool: AgentTool;
+        agentVersion: string;
+        projectId: string;
+        decision: string;
+        category: string;
+        confidence: number;
+    }): Promise<AgentDecisionReceipt>;
+    /** Record the outcome for a prior decision (correctness verdict). */
+    recordOutcome(receiptId: string, verdict: 'correct' | 'incorrect' | 'partial'): Promise<boolean>;
+    /** Verify a receipt's signature against its stored public key. */
+    verify(receipt: AgentDecisionReceipt): Promise<boolean>;
+    /** Get reputation for an agent (across all versions) or specific agent+version. */
+    getScore(agentTool: AgentTool, agentVersion?: string): ReputationScore | null;
+    /** Export reputation as a portable JSON suitable for sharing. */
+    exportPortable(): {
+        agents: ReputationScore[];
+        ledgerHash: string;
+        generatedAt: string;
+    };
+    /** Generate a shields.io-compatible badge line for a README. */
+    badge(agentTool: AgentTool, agentVersion?: string): string | null;
+    stats(): ReputationLedgerStats;
+    private ensureKeyPair;
+    private keyFor;
+    private blankScore;
+    private updateScoreForReceipt;
+    private persistScores;
+    private persistKeys;
+}
+export declare function getReputationLedger(): ReputationLedger;
+export declare function resetReputationLedgerForTests(): void;
+//# sourceMappingURL=reputation-ledger.d.ts.map

package/dist/brain/reputation-ledger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reputation-ledger.d.ts","sourceRoot":"","sources":["../../src/brain/reputation-ledger.ts"],"names":[],"mappings":"AAcA,OAAO,EACL,oBAAoB,EACpB,SAAS,EACT,qBAAqB,EACrB,eAAe,EAChB,MAAM,aAAa,CAAC;AAkBrB,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,MAAM,CAA2C;IACzD,OAAO,CAAC,QAAQ,CAAqE;IACrF,OAAO,CAAC,UAAU,CAAuF;IACzG,OAAO,CAAC,WAAW,CAAS;IAEtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAkD3B,kEAAkE;IAC5D,IAAI,CAAC,KAAK,EAAE;QAChB,SAAS,EAAE,SAAS,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAyDjC,qEAAqE;IAC/D,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC;IAWtG,kEAAkE;IAC5D,MAAM,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IA0B7D,mFAAmF;IACnF,QAAQ,CAAC,SAAS,EAAE,SAAS,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;IA4B7E,iEAAiE;IACjE,cAAc,IAAI;QAAE,MAAM,EAAE,eAAe,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE;IAQxF,gEAAgE;IAChE,KAAK,CAAC,SAAS,EAAE,SAAS,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IASjE,KAAK,IAAI,qBAAqB;IAoB9B,OAAO,CAAC,aAAa;IAarB,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,UAAU;IAiBlB,OAAO,CAAC,qBAAqB;YA6Bf,aAAa;YAeb,WAAW;CAa1B;AAID,wBAAgB,mBAAmB,IAAI,gBAAgB,CAGtD;AAED,wBAAgB,6BAA6B,IAAI,IAAI,CAEpD"}