@theihtisham/agent-shadow-brain 5.2.0 → 6.0.2

package/dist/brain/constitution.js

@@ -0,0 +1,315 @@
+// src/brain/constitution.ts — Project invariants ("constitution") layer
+// v6.0.2 — Hive Mind Edition
+//
+// Reads <project_root>/.shadow-brain/constitution.md, parses Markdown rules
+// under `## Rule N` headings, and exposes them to other parts of the brain
+// for prompt injection and post-hoc validation.
+//
+// Each rule is one of:
+//   - must    : hard requirement, violations always flagged
+//   - should  : strong preference, flagged with lower confidence
+//   - never   : prohibition, treated like must but inverted
+//
+// Rule format inside constitution.md:
+//
+//   ## Rule 1: short title
+//   severity: must|should|never
+//   scope: all|code|commits|tests
+//   No secrets in commits. Use env vars only.
+//
+// Why no LLM call in proposeRule? The point is to draft a rule the user can
+// review and edit; an LLM round-trip would slow that loop. The template-based
+// proposer is "good enough" — humans confirm before persisting.
+//
+// Exposed: Constitution, getConstitution(), resetConstitutionForTests().
+//   .injectInto(prompt, opts)
+//   .validate(text)
+//   .proposeRule(observation)
+//   .approve(rule), .listRules()
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { getEmbeddings } from './embeddings.js';
+const HOME_DIR = path.join(os.homedir(), '.shadow-brain');
+const VIOLATIONS_LOG = path.join(HOME_DIR, 'constitution-violations.jsonl');
+const PROJECT_REL_PATH = path.join('.shadow-brain', 'constitution.md');
+const APPROVED_REL_PATH = path.join('.shadow-brain', 'constitution-approved.json');
+const DEFAULT_MAX_RULES = 6;
+export class Constitution {
+    constructor(projectRoot = process.cwd()) {
+        this.rules = [];
+        this.approved = [];
+        this.watcher = null;
+        this.initialized = false;
+        this.embeddings = getEmbeddings();
+        this.vectorCache = new Map();
+        this.projectRoot = projectRoot;
+    }
+    async init() {
+        if (this.initialized)
+            return;
+        fs.mkdirSync(HOME_DIR, { recursive: true });
+        this.loadFromDisk();
+        this.startWatcher();
+        this.initialized = true;
+    }
+    /** Prepend the most relevant constitution rules to a prompt as a preamble. */
+    injectInto(prompt, opts = {}) {
+        const scope = opts.scope ?? 'all';
+        const max = opts.maxRules ?? DEFAULT_MAX_RULES;
+        const relevant = this.allRules()
+            .filter(r => r.scope === 'all' || r.scope === scope)
+            .slice(0, max);
+        if (!relevant.length)
+            return prompt;
+        const preamble = [
+            '## Project Constitution (binding rules)',
+            ...relevant.map((r, i) => `${i + 1}. [${r.severity.toUpperCase()}] ${r.title} — ${r.text}`),
+            '',
+            '## Task',
+        ].join('\n');
+        return `${preamble}\n${prompt}`;
+    }
+    /**
+     * Score `text` against every rule. Uses both keyword matching (fast, precise)
+     * and semantic similarity (slower, fuzzy). Reports a confidence in [0,1].
+     */
+    async validate(text) {
+        await this.init();
+        const violations = [];
+        const passed = [];
+        const haystack = text.toLowerCase();
+        for (const rule of this.allRules()) {
+            const keywordHit = rule.keywords.some(k => haystack.includes(k));
+            let semanticScore = 0;
+            try {
+                const q = await this.embeddings.embed(text.slice(0, 4000));
+                const r = await this.cachedEmbed(rule.text);
+                semanticScore = cosine(q, r);
+            }
+            catch { /* embeddings optional */ }
+            const triggers = rule.severity === 'never'
+                ? keywordHit || semanticScore > 0.55
+                : keywordHit && semanticScore > 0.35;
+            if (triggers) {
+                const confidence = clamp(0.4 * (keywordHit ? 1 : 0) + 0.6 * semanticScore, 0, 1);
+                const evidence = this.extractEvidence(text, rule.keywords);
+                violations.push({ rule, confidence: +confidence.toFixed(3), evidence });
+                this.logViolation(rule, confidence, evidence);
+            }
+            else {
+                passed.push(rule);
+            }
+        }
+        return { violations, passed };
+    }
+    /** Build a candidate rule from an observed pattern. Template-only, no LLM. */
+    proposeRule(observation) {
+        const trimmed = observation.trim().slice(0, 600);
+        const severity = guessSeverity(trimmed);
+        const scope = guessScope(trimmed);
+        const title = trimmed.split(/[.\n]/)[0].slice(0, 80) || 'Untitled rule';
+        return {
+            id: `proposed-${Date.now().toString(36)}`,
+            severity,
+            scope,
+            title,
+            text: trimmed,
+            keywords: extractKeywords(trimmed),
+            source: 'proposed',
+        };
+    }
+    /** Persist a user-approved rule to constitution-approved.json. */
+    async approve(rule) {
+        const approved = { ...rule, source: 'approved' };
+        this.approved.push(approved);
+        const dir = path.join(this.projectRoot, '.shadow-brain');
+        fs.mkdirSync(dir, { recursive: true });
+        const file = path.join(this.projectRoot, APPROVED_REL_PATH);
+        fs.writeFileSync(file, JSON.stringify(this.approved, null, 2));
+        return approved;
+    }
+    listRules() { return this.allRules(); }
+    dispose() {
+        if (this.watcher) {
+            this.watcher.close();
+            this.watcher = null;
+        }
+    }
+    // -- Internals -----------------------------------------------------------
+    allRules() { return [...this.rules, ...this.approved]; }
+    loadFromDisk() {
+        const file = path.join(this.projectRoot, PROJECT_REL_PATH);
+        if (fs.existsSync(file)) {
+            try {
+                this.rules = parseConstitutionMarkdown(fs.readFileSync(file, 'utf-8'));
+            }
+            catch {
+                this.rules = [];
+            }
+        }
+        else {
+            this.rules = [];
+        }
+        const approvedFile = path.join(this.projectRoot, APPROVED_REL_PATH);
+        if (fs.existsSync(approvedFile)) {
+            try {
+                this.approved = JSON.parse(fs.readFileSync(approvedFile, 'utf-8'));
+            }
+            catch {
+                this.approved = [];
+            }
+        }
+        else {
+            this.approved = [];
+        }
+        this.vectorCache.clear();
+    }
+    startWatcher() {
+        const dir = path.join(this.projectRoot, '.shadow-brain');
+        if (!fs.existsSync(dir))
+            return;
+        try {
+            this.watcher = fs.watch(dir, { persistent: false }, (_event, filename) => {
+                if (!filename)
+                    return;
+                if (filename.toString().endsWith('constitution.md') ||
+                    filename.toString().endsWith('constitution-approved.json')) {
+                    this.loadFromDisk();
+                }
+            });
+        }
+        catch { /* watcher not critical */ }
+    }
+    async cachedEmbed(text) {
+        const cached = this.vectorCache.get(text);
+        if (cached)
+            return cached;
+        const v = await this.embeddings.embed(text);
+        this.vectorCache.set(text, v);
+        return v;
+    }
+    extractEvidence(text, keywords) {
+        const lower = text.toLowerCase();
+        for (const k of keywords) {
+            const idx = lower.indexOf(k);
+            if (idx >= 0) {
+                const start = Math.max(0, idx - 40);
+                const end = Math.min(text.length, idx + k.length + 40);
+                return text.slice(start, end).replace(/\s+/g, ' ');
+            }
+        }
+        return text.slice(0, 120).replace(/\s+/g, ' ');
+    }
+    logViolation(rule, confidence, evidence) {
+        try {
+            const entry = {
+                ts: new Date().toISOString(),
+                projectRoot: this.projectRoot,
+                ruleId: rule.id,
+                severity: rule.severity,
+                confidence,
+                evidence,
+            };
+            fs.appendFileSync(VIOLATIONS_LOG, JSON.stringify(entry) + '\n');
+        }
+        catch { /* non-fatal */ }
+    }
+}
+// -- Markdown parser ------------------------------------------------------
+export function parseConstitutionMarkdown(md) {
+    const out = [];
+    // Split on H2 headings that start with "Rule".
+    const blocks = md.split(/^##\s+Rule\s+/im).slice(1);
+    for (const block of blocks) {
+        const lines = block.split(/\r?\n/);
+        const headLine = lines.shift() ?? '';
+        const m = headLine.match(/^(\S+)\s*[:\-—]?\s*(.*)$/);
+        const id = `rule-${(m?.[1] ?? out.length + 1).toString().replace(/[^\w-]/g, '')}`;
+        const title = (m?.[2] ?? '').trim() || `Rule ${out.length + 1}`;
+        let severity = 'must';
+        let scope = 'all';
+        const bodyLines = [];
+        for (const line of lines) {
+            const sev = line.match(/^severity\s*:\s*(must|should|never)/i);
+            const sco = line.match(/^scope\s*:\s*(all|code|commits|tests)/i);
+            if (sev) {
+                severity = sev[1].toLowerCase();
+                continue;
+            }
+            if (sco) {
+                scope = sco[1].toLowerCase();
+                continue;
+            }
+            bodyLines.push(line);
+        }
+        const text = bodyLines.join('\n').trim();
+        if (!text)
+            continue;
+        out.push({
+            id,
+            severity,
+            scope,
+            title,
+            text,
+            keywords: extractKeywords(`${title} ${text}`),
+            source: 'file',
+        });
+    }
+    return out;
+}
+function extractKeywords(text) {
+    const stop = new Set(['the', 'a', 'an', 'and', 'or', 'of', 'to', 'for', 'in', 'on', 'is', 'it', 'this', 'that', 'as', 'by', 'be', 'do', 'not', 'no', 'use', 'with', 'must', 'should', 'never', 'only']);
+    const seen = new Set();
+    const out = [];
+    const norm = text.toLowerCase().replace(/[^a-z0-9\s]/g, ' ');
+    for (const tok of norm.split(/\s+/)) {
+        if (tok.length < 4 || stop.has(tok) || seen.has(tok))
+            continue;
+        seen.add(tok);
+        out.push(tok);
+        if (out.length >= 8)
+            break;
+    }
+    return out;
+}
+function guessSeverity(text) {
+    const lower = text.toLowerCase();
+    if (/\b(never|don'?t|prohibit|forbid|disallow|do not)\b/.test(lower))
+        return 'never';
+    if (/\b(should|prefer|avoid|try to)\b/.test(lower))
+        return 'should';
+    return 'must';
+}
+function guessScope(text) {
+    const lower = text.toLowerCase();
+    if (/\b(commit|git|push|branch|merge)\b/.test(lower))
+        return 'commits';
+    if (/\b(test|spec|coverage|assert)\b/.test(lower))
+        return 'tests';
+    if (/\b(code|function|class|import|api)\b/.test(lower))
+        return 'code';
+    return 'all';
+}
+function cosine(a, b) {
+    let d = 0;
+    const n = Math.min(a.length, b.length);
+    for (let i = 0; i < n; i++)
+        d += a[i] * b[i];
+    return d;
+}
+function clamp(x, lo, hi) {
+    return x < lo ? lo : x > hi ? hi : x;
+}
+let _instance = null;
+export function getConstitution(projectRoot) {
+    if (!_instance)
+        _instance = new Constitution(projectRoot);
+    return _instance;
+}
+export function resetConstitutionForTests() {
+    if (_instance)
+        _instance.dispose();
+    _instance = null;
+}
+//# sourceMappingURL=constitution.js.map

package/dist/brain/constitution.js.map

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

package/dist/brain/cost-aware-spawner.d.ts

@@ -0,0 +1,7 @@
+import { SpawnCostEstimate, SubAgentSpawnRequest } from '../types.js';
+export declare class CostAwareSpawner {
+    /** Estimate cost + recommendation for a planned sub-agent spawn. */
+    estimate(req: SubAgentSpawnRequest, desiredModel?: string): SpawnCostEstimate;
+}
+export declare function getCostAwareSpawner(): CostAwareSpawner;
+//# sourceMappingURL=cost-aware-spawner.d.ts.map

package/dist/brain/cost-aware-spawner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-aware-spawner.d.ts","sourceRoot":"","sources":["../../src/brain/cost-aware-spawner.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAyBtE,qBAAa,gBAAgB;IAC3B,oEAAoE;IACpE,QAAQ,CAAC,GAAG,EAAE,oBAAoB,EAAE,YAAY,SAAoB,GAAG,iBAAiB;CA2CzF;AAID,wBAAgB,mBAAmB,IAAI,gBAAgB,CAGtD"}

package/dist/brain/cost-aware-spawner.js

@@ -0,0 +1,77 @@
+// src/brain/cost-aware-spawner.ts — Spawn sub-agents cost-aware
+// v6.0.0 — Hive Mind Edition
+//
+// Before Shadow Brain spawns a sub-agent, estimate token cost and compare
+// against the value of the decision. Route to a cheaper model (or local) when
+// the trivial-task heuristic matches.
+const MODEL_PRICING = {
+    'claude-opus-4-7': { input: 15, output: 75 },
+    'claude-sonnet-4-6': { input: 3, output: 15 },
+    'claude-haiku-4-5': { input: 0.8, output: 4 },
+    'gpt-5.4': { input: 10, output: 30 },
+    'gpt-5.4-codex': { input: 10, output: 30 },
+    'glm-5.1': { input: 0.5, output: 2 },
+    'minimax-m2.7': { input: 0.6, output: 2.4 },
+    'gemini-2.5-flash': { input: 0.15, output: 0.6 },
+    'qwen2.5-coder:7b': { input: 0, output: 0 },
+    'local': { input: 0, output: 0 },
+};
+const CHEAP_KEYWORDS = new Set([
+    'typo', 'rename', 'format', 'lint', 'comment', 'docs',
+    'readme', 'style', 'indent', 'whitespace', 'todo',
+]);
+const EXPENSIVE_KEYWORDS = new Set([
+    'architecture', 'security', 'migration', 'refactor',
+    'auth', 'payment', 'crypto', 'billing', 'compliance',
+]);
+export class CostAwareSpawner {
+    /** Estimate cost + recommendation for a planned sub-agent spawn. */
+    estimate(req, desiredModel = 'claude-opus-4-7') {
+        const tokenBudget = req.tokenBudget ?? 4000;
+        const estimatedInput = tokenBudget;
+        const estimatedOutput = Math.floor(tokenBudget * 0.4);
+        const pricing = MODEL_PRICING[desiredModel] ?? MODEL_PRICING['claude-opus-4-7'];
+        const cost = (estimatedInput * pricing.input + estimatedOutput * pricing.output) / 1000000;
+        const taskLower = req.taskDescription.toLowerCase();
+        const cheapHit = Array.from(CHEAP_KEYWORDS).some(k => taskLower.includes(k));
+        const expensiveHit = Array.from(EXPENSIVE_KEYWORDS).some(k => taskLower.includes(k));
+        let cheaperAlternative = null;
+        let recommendation = 'proceed';
+        let rationale = `Estimated $${cost.toFixed(4)} (${estimatedInput}+${estimatedOutput} tokens on ${desiredModel}).`;
+        if (cheapHit && !expensiveHit) {
+            const altPricing = MODEL_PRICING['qwen2.5-coder:7b'];
+            const altCost = (estimatedInput * altPricing.input + estimatedOutput * altPricing.output) / 1000000;
+            cheaperAlternative = { model: 'qwen2.5-coder:7b', costUsd: +altCost.toFixed(4) };
+            recommendation = 'use-alternative';
+            rationale = `Trivial task — route to local model (free) instead of ${desiredModel} ($${cost.toFixed(4)}).`;
+        }
+        else if (expensiveHit) {
+            recommendation = 'proceed';
+            rationale = `Critical task — ${desiredModel} is appropriate. Estimated $${cost.toFixed(4)}.`;
+        }
+        else if (cost > 0.05 && tokenBudget < 2000) {
+            const altPricing = MODEL_PRICING['claude-haiku-4-5'];
+            const altCost = (estimatedInput * altPricing.input + estimatedOutput * altPricing.output) / 1000000;
+            cheaperAlternative = { model: 'claude-haiku-4-5', costUsd: +altCost.toFixed(4) };
+            recommendation = 'use-alternative';
+            rationale = `Small task at $${cost.toFixed(4)} — Haiku can handle for ~$${altCost.toFixed(4)}.`;
+        }
+        return {
+            subAgentModel: desiredModel,
+            estimatedInputTokens: estimatedInput,
+            estimatedOutputTokens: estimatedOutput,
+            estimatedCostUsd: +cost.toFixed(4),
+            expectedValueScore: expensiveHit ? 1.0 : cheapHit ? 0.2 : 0.5,
+            cheaperAlternative,
+            recommendation,
+            rationale,
+        };
+    }
+}
+let _instance = null;
+export function getCostAwareSpawner() {
+    if (!_instance)
+        _instance = new CostAwareSpawner();
+    return _instance;
+}
+//# sourceMappingURL=cost-aware-spawner.js.map

package/dist/brain/cost-aware-spawner.js.map

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

package/dist/brain/dream-engine.d.ts

@@ -0,0 +1,35 @@
+import { DreamInsight, DreamType, DreamEngineConfig, DreamEngineStats } from '../types.js';
+export declare class DreamEngine {
+    private brain;
+    private llm;
+    private config;
+    private dreams;
+    private stats;
+    private lastActivityAt;
+    private cycleTimer;
+    private initialized;
+    constructor(opts?: Partial<DreamEngineConfig>);
+    init(): Promise<void>;
+    /** Record that SOMETHING happened (agent activity). Resets idle timer. */
+    noteActivity(): void;
+    /** Start background reflection loop. Safe to call once; no-op if already running. */
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    /** Run a single reflection pass. Exposed for tests + manual triggering. */
+    dreamOnce(): Promise<DreamInsight[]>;
+    listDreams(opts?: {
+        type?: DreamType;
+        unacknowledgedOnly?: boolean;
+        limit?: number;
+    }): DreamInsight[];
+    acknowledge(dreamId: string): Promise<boolean>;
+    getStats(): DreamEngineStats;
+    private tick;
+    private generate;
+    private promptForType;
+    private syntheticDream;
+    private persist;
+}
+export declare function getDreamEngine(opts?: Partial<DreamEngineConfig>): DreamEngine;
+export declare function resetDreamEngineForTests(): void;
+//# sourceMappingURL=dream-engine.d.ts.map

package/dist/brain/dream-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dream-engine.d.ts","sourceRoot":"","sources":["../../src/brain/dream-engine.ts"],"names":[],"mappings":"AAiBA,OAAO,EACL,YAAY,EACZ,SAAS,EACT,iBAAiB,EACjB,gBAAgB,EAEjB,MAAM,aAAa,CAAC;AAoCrB,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,GAAG,CAAW;IACtB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,MAAM,CAAwC;IACtD,OAAO,CAAC,KAAK,CAAkC;IAC/C,OAAO,CAAC,cAAc,CAAsB;IAC5C,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,WAAW,CAAS;gBAEhB,IAAI,GAAE,OAAO,CAAC,iBAAiB,CAAM;IAM3C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA2B3B,0EAA0E;IAC1E,YAAY,IAAI,IAAI;IAIpB,qFAAqF;IAC/E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAStB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B,2EAA2E;IACrE,SAAS,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAmC1C,UAAU,CAAC,IAAI,GAAE;QAAE,IAAI,CAAC,EAAE,SAAS,CAAC;QAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,YAAY,EAAE;IAQnG,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAUpD,QAAQ,IAAI,gBAAgB;YAMd,IAAI;YAMJ,QAAQ;IA2DtB,OAAO,CAAC,aAAa;IAerB,OAAO,CAAC,cAAc;YAgBR,OAAO;CAetB;AAID,wBAAgB,cAAc,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,WAAW,CAG7E;AAED,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C"}