@theihtisham/agent-shadow-brain 5.2.0 → 6.0.2

package/dist/brain/reputation-ledger.js

@@ -0,0 +1,326 @@
+// src/brain/reputation-ledger.ts — Agent Reputation Ledger (Ed25519-signed)
+// v6.0.0 — Hive Mind Edition
+//
+// Every agent decision gets a cryptographically-signed receipt. Reputation is
+// a portable artifact: accuracy rate, streak, per-category scores — all
+// tamper-evident via Ed25519 signatures + a chained ledger hash.
+//
+// Enables: shareable trust badges, community leaderboards, auditable history.
+// Nobody else ships this.
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import * as crypto from 'crypto';
+const REP_DIR = path.join(os.homedir(), '.shadow-brain', 'reputation');
+const LEDGER_PATH = path.join(REP_DIR, 'ledger.jsonl');
+const SCORES_PATH = path.join(REP_DIR, 'scores.json');
+const KEYS_PATH = path.join(REP_DIR, 'keys.json');
+export class ReputationLedger {
+    constructor() {
+        this.receipts = [];
+        this.scores = new Map();
+        this.keyPairs = new Map();
+        this.ledgerHash = crypto.createHash('sha256').update('shadow-brain-v6-genesis').digest('hex');
+        this.initialized = false;
+    }
+    async init() {
+        if (this.initialized)
+            return;
+        fs.mkdirSync(REP_DIR, { recursive: true });
+        // Load ledger
+        if (fs.existsSync(LEDGER_PATH)) {
+            try {
+                const raw = fs.readFileSync(LEDGER_PATH, 'utf-8');
+                for (const line of raw.split('\n')) {
+                    if (!line.trim())
+                        continue;
+                    const receipt = JSON.parse(line);
+                    this.receipts.push({
+                        ...receipt,
+                        signedAt: new Date(receipt.signedAt),
+                        outcomeVerifiedAt: receipt.outcomeVerifiedAt ? new Date(receipt.outcomeVerifiedAt) : undefined,
+                    });
+                }
+            }
+            catch {
+                /* skip corrupt lines silently */
+            }
+        }
+        // Load scores
+        if (fs.existsSync(SCORES_PATH)) {
+            try {
+                const parsed = JSON.parse(fs.readFileSync(SCORES_PATH, 'utf-8'));
+                for (const [k, v] of Object.entries(parsed.scores ?? {})) {
+                    this.scores.set(k, { ...v, lastActive: new Date(v.lastActive) });
+                }
+                this.ledgerHash = parsed.ledgerHash ?? this.ledgerHash;
+            }
+            catch {
+                /* skip */
+            }
+        }
+        // Load keys
+        if (fs.existsSync(KEYS_PATH)) {
+            try {
+                const parsed = JSON.parse(fs.readFileSync(KEYS_PATH, 'utf-8'));
+                for (const [k, v] of Object.entries(parsed.keys ?? {})) {
+                    this.keyPairs.set(k, v);
+                }
+            }
+            catch {
+                /* skip */
+            }
+        }
+        this.initialized = true;
+    }
+    /** Sign and record a decision. Returns receipt with signature. */
+    async sign(input) {
+        await this.init();
+        const key = this.keyFor(input.agentTool, input.agentVersion);
+        const kp = this.ensureKeyPair(key);
+        const payload = {
+            agentTool: input.agentTool,
+            agentVersion: input.agentVersion,
+            projectId: input.projectId,
+            decision: input.decision,
+            category: input.category,
+            confidence: input.confidence,
+            signedAt: new Date().toISOString(),
+            prevHash: this.ledgerHash,
+        };
+        const canonical = JSON.stringify(payload);
+        const signatureBytes = crypto.sign(null, Buffer.from(canonical, 'utf-8'), crypto.createPrivateKey({ key: kp.privateKey, format: 'pem' }));
+        const signature = signatureBytes.toString('base64');
+        const receipt = {
+            id: `rec-${crypto.randomBytes(6).toString('hex')}`,
+            agentTool: input.agentTool,
+            agentVersion: input.agentVersion,
+            projectId: input.projectId,
+            decision: input.decision,
+            category: input.category,
+            confidence: input.confidence,
+            signedAt: new Date(payload.signedAt),
+            signature,
+            publicKey: kp.publicKey,
+        };
+        this.receipts.push(receipt);
+        // Advance ledger hash
+        this.ledgerHash = crypto
+            .createHash('sha256')
+            .update(this.ledgerHash + canonical + signature)
+            .digest('hex');
+        // Append ledger line
+        try {
+            fs.appendFileSync(LEDGER_PATH, JSON.stringify(receipt) + '\n');
+        }
+        catch {
+            /* non-fatal */
+        }
+        this.updateScoreForReceipt(receipt, null);
+        await this.persistScores();
+        return receipt;
+    }
+    /** Record the outcome for a prior decision (correctness verdict). */
+    async recordOutcome(receiptId, verdict) {
+        await this.init();
+        const receipt = this.receipts.find(r => r.id === receiptId);
+        if (!receipt)
+            return false;
+        receipt.outcomeVerdict = verdict;
+        receipt.outcomeVerifiedAt = new Date();
+        this.updateScoreForReceipt(receipt, verdict);
+        await this.persistScores();
+        return true;
+    }
+    /** Verify a receipt's signature against its stored public key. */
+    async verify(receipt) {
+        await this.init();
+        try {
+            const payload = {
+                agentTool: receipt.agentTool,
+                agentVersion: receipt.agentVersion,
+                projectId: receipt.projectId,
+                decision: receipt.decision,
+                category: receipt.category,
+                confidence: receipt.confidence,
+                signedAt: receipt.signedAt.toISOString(),
+            };
+            // NOTE: prevHash was consumed at sign-time and isn't reproducible here.
+            // Full verify requires the ledger chain — treat sig validity as primary.
+            const canonical = JSON.stringify({ ...payload, prevHash: 'unknown' });
+            return crypto.verify(null, Buffer.from(canonical, 'utf-8'), crypto.createPublicKey({ key: receipt.publicKey, format: 'pem' }), Buffer.from(receipt.signature, 'base64'));
+        }
+        catch {
+            return false;
+        }
+    }
+    /** Get reputation for an agent (across all versions) or specific agent+version. */
+    getScore(agentTool, agentVersion) {
+        const key = agentVersion ? this.keyFor(agentTool, agentVersion) : this.keyFor(agentTool, '*');
+        if (agentVersion)
+            return this.scores.get(key) ?? null;
+        // aggregate across versions
+        let agg = null;
+        for (const [k, score] of this.scores) {
+            if (!k.startsWith(`${agentTool}::`))
+                continue;
+            if (!agg)
+                agg = this.blankScore(agentTool, '*');
+            agg.totalDecisions += score.totalDecisions;
+            agg.correct += score.correct;
+            agg.incorrect += score.incorrect;
+            agg.partial += score.partial;
+            for (const [cat, catScore] of Object.entries(score.categoryScores)) {
+                const existing = agg.categoryScores[cat] ?? { correct: 0, total: 0, accuracy: 0 };
+                existing.correct += catScore.correct;
+                existing.total += catScore.total;
+                existing.accuracy = existing.total ? existing.correct / existing.total : 0;
+                agg.categoryScores[cat] = existing;
+            }
+            if (score.lastActive.getTime() > agg.lastActive.getTime())
+                agg.lastActive = score.lastActive;
+        }
+        if (agg) {
+            const verified = agg.correct + agg.incorrect + agg.partial;
+            agg.accuracyRate = verified ? (agg.correct + agg.partial * 0.5) / verified : 0;
+        }
+        return agg;
+    }
+    /** Export reputation as a portable JSON suitable for sharing. */
+    exportPortable() {
+        return {
+            agents: Array.from(this.scores.values()).map(s => ({ ...s })),
+            ledgerHash: this.ledgerHash,
+            generatedAt: new Date().toISOString(),
+        };
+    }
+    /** Generate a shields.io-compatible badge line for a README. */
+    badge(agentTool, agentVersion) {
+        const score = this.getScore(agentTool, agentVersion);
+        if (!score)
+            return null;
+        const pct = Math.round(score.accuracyRate * 100);
+        const label = `${agentTool}${agentVersion ? `@${agentVersion}` : ''}`;
+        const color = pct >= 90 ? 'brightgreen' : pct >= 75 ? 'green' : pct >= 50 ? 'yellow' : 'orange';
+        return `![${label}](https://img.shields.io/badge/${encodeURIComponent(label)}-${pct}%25%20accuracy-${color})`;
+    }
+    stats() {
+        const verified = this.receipts.filter(r => r.outcomeVerdict && r.outcomeVerdict !== 'unverified').length;
+        const averageAccuracy = this.scores.size
+            ? Array.from(this.scores.values()).reduce((acc, s) => acc + s.accuracyRate, 0) / this.scores.size
+            : 0;
+        const top = Array.from(this.scores.values())
+            .sort((a, b) => b.accuracyRate - a.accuracyRate)
+            .slice(0, 5)
+            .map(s => ({ agentTool: s.agentTool, accuracy: s.accuracyRate, decisions: s.totalDecisions }));
+        return {
+            totalAgents: this.scores.size,
+            totalReceipts: this.receipts.length,
+            verifiedReceipts: verified,
+            averageAccuracy,
+            topAgents: top,
+        };
+    }
+    // ── Internals ─────────────────────────────────────────────────────────────
+    ensureKeyPair(key) {
+        const existing = this.keyPairs.get(key);
+        if (existing)
+            return existing;
+        const { publicKey, privateKey } = crypto.generateKeyPairSync('ed25519');
+        const kp = {
+            publicKey: publicKey.export({ format: 'pem', type: 'spki' }).toString(),
+            privateKey: privateKey.export({ format: 'pem', type: 'pkcs8' }).toString(),
+        };
+        this.keyPairs.set(key, kp);
+        this.persistKeys().catch(() => { });
+        return kp;
+    }
+    keyFor(agentTool, agentVersion) {
+        return `${agentTool}::${agentVersion}`;
+    }
+    blankScore(agentTool, agentVersion) {
+        return {
+            agentTool,
+            agentVersion,
+            totalDecisions: 0,
+            correct: 0,
+            incorrect: 0,
+            partial: 0,
+            accuracyRate: 0,
+            categoryScores: {},
+            streakDays: 0,
+            lastActive: new Date(),
+            publicKey: '',
+            ledgerHash: this.ledgerHash,
+        };
+    }
+    updateScoreForReceipt(receipt, verdict) {
+        const key = this.keyFor(receipt.agentTool, receipt.agentVersion);
+        const kp = this.keyPairs.get(key);
+        const score = this.scores.get(key) ?? this.blankScore(receipt.agentTool, receipt.agentVersion);
+        score.publicKey = kp?.publicKey ?? score.publicKey;
+        score.ledgerHash = this.ledgerHash;
+        score.lastActive = new Date();
+        if (!verdict) {
+            score.totalDecisions++;
+        }
+        else {
+            if (verdict === 'correct')
+                score.correct++;
+            else if (verdict === 'incorrect')
+                score.incorrect++;
+            else
+                score.partial++;
+            const cat = score.categoryScores[receipt.category] ?? { correct: 0, total: 0, accuracy: 0 };
+            cat.total++;
+            if (verdict === 'correct')
+                cat.correct++;
+            else if (verdict === 'partial')
+                cat.correct += 0.5;
+            cat.accuracy = cat.total ? cat.correct / cat.total : 0;
+            score.categoryScores[receipt.category] = cat;
+            const totalVerified = score.correct + score.incorrect + score.partial;
+            score.accuracyRate = totalVerified ? (score.correct + score.partial * 0.5) / totalVerified : 0;
+        }
+        this.scores.set(key, score);
+    }
+    async persistScores() {
+        try {
+            const shape = {
+                schemaVersion: 1,
+                scores: Object.fromEntries(this.scores.entries()),
+                ledgerHash: this.ledgerHash,
+            };
+            const tmp = SCORES_PATH + '.tmp';
+            fs.writeFileSync(tmp, JSON.stringify(shape, null, 2));
+            fs.renameSync(tmp, SCORES_PATH);
+        }
+        catch {
+            /* non-fatal */
+        }
+    }
+    async persistKeys() {
+        try {
+            const shape = {
+                schemaVersion: 1,
+                keys: Object.fromEntries(this.keyPairs.entries()),
+            };
+            const tmp = KEYS_PATH + '.tmp';
+            fs.writeFileSync(tmp, JSON.stringify(shape, null, 2));
+            fs.renameSync(tmp, KEYS_PATH);
+        }
+        catch {
+            /* non-fatal */
+        }
+    }
+}
+let _instance = null;
+export function getReputationLedger() {
+    if (!_instance)
+        _instance = new ReputationLedger();
+    return _instance;
+}
+export function resetReputationLedgerForTests() {
+    _instance = null;
+}
+//# sourceMappingURL=reputation-ledger.js.map

package/dist/brain/reputation-ledger.js.map

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

package/dist/brain/session-hooks.d.ts

@@ -4,6 +4,10 @@ export declare class SessionHookInstaller {
     detectInstalled(projectDir: string): Promise<AgentTool[]>;
     /** Install hooks for ALL detected agents in one shot */
     attachAll(projectDir: string): Promise<AttachReport>;
+    /** Best-effort non-mutating audit of Shadow Brain hook artifacts. */
+    audit(projectDir: string): Promise<SessionHook[]>;
+    /** Detach Shadow Brain from every detected agent without creating new hooks. */
+    detachAll(projectDir: string): Promise<AttachReport>;
     /** Install hooks for a single agent. Returns list of installed hooks. */
     attach(agent: AgentTool, projectDir: string): Promise<SessionHook[]>;
     /** Detach Shadow Brain from a specific agent */
@@ -20,6 +24,21 @@ export declare class SessionHookInstaller {
     private attachCopilot;
     /** Add Shadow Brain to an MCP-server-style JSON config without clobbering existing servers */
     private upsertMcpJson;
+    private findInstalledHooks;
+    private containsShadowBrain;
+    private removeShadowBrainBlock;
+    private removeFromJsonConfig;
+    /**
+     * Claude Code schema requires each SessionStart entry to have shape:
+     *   { matcher: string, hooks: [{ type: 'command', command: '...' }] }
+     * Older Shadow Brain versions mistakenly wrote flat { name, command, timeout }
+     * entries directly, which broke Claude Code's settings loader. This function:
+     *  - drops null/undefined/non-object entries
+     *  - rewraps flat "legacy" entries into a valid { matcher, hooks } block
+     *  - ensures every block.hooks is a valid array of { type:'command', command }
+     *  - strips any nested malformed entries
+     */
+    private repairClaudeHookBlocks;
     private cursorRuleTemplate;
     private genericRuleTemplate;
     private copilotInstructionsTemplate;

package/dist/brain/session-hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-hooks.d.ts","sourceRoot":"","sources":["../../src/brain/session-hooks.ts"],"names":[],"mappings":"AAuBA,OAAO,EACL,SAAS,EACT,WAAW,EACX,YAAY,EACb,MAAM,aAAa,CAAC;AASrB,qBAAa,oBAAoB;IAC/B,wDAAwD;IAClD,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IA0B/D,wDAAwD;IAClD,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IA+B1D,yEAAyE;IACnE,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAgB1E,gDAAgD;IAC1C,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAmBpE,OAAO,CAAC,gBAAgB;IA4CxB,OAAO,CAAC,YAAY;IAsCpB,OAAO,CAAC,WAAW;IAiDnB,OAAO,CAAC,cAAc;IAkCtB,OAAO,CAAC,WAAW;IA2BnB,OAAO,CAAC,cAAc;IA2BtB,OAAO,CAAC,cAAc;IA0BtB,OAAO,CAAC,aAAa;IA2BrB,OAAO,CAAC,WAAW;IA6BnB,OAAO,CAAC,aAAa;IA6BrB,8FAA8F;IAC9F,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,kBAAkB;IAgB1B,OAAO,CAAC,mBAAmB;IAU3B,OAAO,CAAC,2BAA2B;CASpC;AAID,wBAAgB,gBAAgB,IAAI,oBAAoB,CAGvD"}
+{"version":3,"file":"session-hooks.d.ts","sourceRoot":"","sources":["../../src/brain/session-hooks.ts"],"names":[],"mappings":"AAuBA,OAAO,EACL,SAAS,EACT,WAAW,EACX,YAAY,EACb,MAAM,aAAa,CAAC;AASrB,qBAAa,oBAAoB;IAC/B,wDAAwD;IAClD,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IA0B/D,wDAAwD;IAClD,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IA+B1D,qEAAqE;IAC/D,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IASvD,gFAAgF;IAC1E,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAgC1D,yEAAyE;IACnE,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAgB1E,gDAAgD;IAC1C,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAuBpE,OAAO,CAAC,gBAAgB;IAmExB,OAAO,CAAC,YAAY;IAsCpB,OAAO,CAAC,WAAW;IAiDnB,OAAO,CAAC,cAAc;IAkCtB,OAAO,CAAC,WAAW;IA2BnB,OAAO,CAAC,cAAc;IA2BtB,OAAO,CAAC,cAAc;IA0BtB,OAAO,CAAC,aAAa;IA2BrB,OAAO,CAAC,WAAW;IA6BnB,OAAO,CAAC,aAAa;IA6BrB,8FAA8F;IAC9F,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,kBAAkB;IAkE1B,OAAO,CAAC,mBAAmB;IAQ3B,OAAO,CAAC,sBAAsB;IAa9B,OAAO,CAAC,oBAAoB;IAwC5B;;;;;;;;;OASG;IACH,OAAO,CAAC,sBAAsB;IA2B9B,OAAO,CAAC,kBAAkB;IAgB1B,OAAO,CAAC,mBAAmB;IAU3B,OAAO,CAAC,2BAA2B;CASpC;AAID,wBAAgB,gBAAgB,IAAI,oBAAoB,CAGvD"}