@theihtisham/agent-shadow-brain 5.1.1 → 5.2.0

package/dist/brain/subconscious.js

@@ -0,0 +1,275 @@
+// src/brain/subconscious.ts — Subconscious Engine (v5.2.0)
+//
+// On every new agent session, the Subconscious proactively injects a tight
+// briefing of relevant context — recent decisions, similar past work, project
+// state, cross-agent insights — so the agent doesn't have to ask.
+//
+// "Subconscious" because the agent doesn't actively retrieve this — the brain
+// makes it available implicitly. Like human intuition: the relevant memory
+// surfaces before you consciously look for it.
+//
+// Token budget: hard-capped (default 2000) to never bloat the agent's context.
+// Relevance ranked: each section competes for budget by importance × recency.
+import { getGlobalBrain, GlobalBrain } from './global-brain.js';
+import { getCache } from './l0-cache.js';
+import * as crypto from 'crypto';
+const DEFAULT_CONFIG = {
+    enabled: true,
+    tokenBudget: 2000,
+    lookbackHours: 24,
+    relevanceThreshold: 0.3,
+    alwaysInclude: ['decision', 'pattern', 'warning'],
+    enabledAgents: [],
+};
+/** ~4 chars per token (rough English heuristic) */
+function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+export class SubconsciousEngine {
+    constructor(config = {}, brain) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+        this.brain = brain ?? getGlobalBrain();
+        this.stats = {
+            totalBriefings: 0,
+            avgTokenCount: 0,
+            avgGenerationMs: 0,
+            acceptedRate: 1,
+            byAgent: {},
+            lastBriefing: null,
+        };
+    }
+    /** Generate a session-start briefing for the agent — proactive context injection */
+    async generateBriefing(opts) {
+        const start = Date.now();
+        const sessionId = crypto.randomUUID();
+        const projectId = opts.projectId ?? GlobalBrain.projectIdFor(opts.projectDir);
+        const projectName = opts.projectName ?? opts.projectDir.split(/[/\\]/).pop() ?? 'unknown';
+        // L0 cache check — if we briefed this agent for this project recently, reuse
+        const cacheKey = `subconscious:${opts.agentTool}:${projectId}`;
+        const cache = getCache('subconscious');
+        const cached = cache.get(cacheKey);
+        if (cached && Date.now() - cached.generatedAt.getTime() < 60000) {
+            return cached;
+        }
+        // Skip if disabled or agent not in enabled list
+        if (!this.config.enabled || (this.config.enabledAgents.length > 0 && !this.config.enabledAgents.includes(opts.agentTool))) {
+            return this.emptyBriefing(opts.agentTool, opts.projectDir, sessionId);
+        }
+        if (!('init' in this.brain)) {
+            return this.emptyBriefing(opts.agentTool, opts.projectDir, sessionId);
+        }
+        try {
+            await this.brain.init();
+        }
+        catch { /* already initialized */ }
+        // Build sections within budget
+        const lookbackMs = this.config.lookbackHours * 60 * 60 * 1000;
+        const cutoff = Date.now() - lookbackMs;
+        const recentDecisions = this.fetchSection(projectId, ['decision'], cutoff, 5);
+        const activeTasks = this.fetchSection(projectId, ['task', 'todo'], cutoff, 5);
+        const projectState = this.fetchProjectStateSummary(projectId);
+        const crossAgentInsights = this.fetchCrossAgentInsights(projectId, opts.agentTool, cutoff, 5);
+        const warnings = this.fetchSection(projectId, ['warning', 'critical', 'security'], cutoff, 3);
+        const similarPastWork = opts.currentTask
+            ? this.fetchSimilarWork(opts.currentTask, opts.agentTool, 3)
+            : this.fetchTopPatterns(projectId, 3);
+        const briefing = {
+            agentTool: opts.agentTool,
+            projectDir: opts.projectDir,
+            sessionId,
+            generatedAt: new Date(),
+            tokenCount: 0,
+            sections: {
+                recentDecisions: recentDecisions.map(e => this.formatEntry(e)),
+                activeTasks: activeTasks.map(e => this.formatEntry(e)),
+                similarPastWork: similarPastWork.map(e => this.formatEntry(e)),
+                projectState,
+                crossAgentInsights: crossAgentInsights.map(e => `[${e.agentTool}] ${this.formatEntry(e)}`),
+                warnings: warnings.map(e => this.formatEntry(e)),
+            },
+            fullText: '',
+        };
+        briefing.fullText = this.assembleBriefing(briefing, projectName);
+        briefing.tokenCount = estimateTokens(briefing.fullText);
+        // Trim if over budget — drop lowest-priority sections first
+        if (briefing.tokenCount > this.config.tokenBudget) {
+            briefing.fullText = this.trimToBudget(briefing, projectName);
+            briefing.tokenCount = estimateTokens(briefing.fullText);
+        }
+        // Cache it
+        cache.set(cacheKey, briefing);
+        // Update stats
+        this.stats.totalBriefings++;
+        this.stats.avgTokenCount = this.runningAvg(this.stats.avgTokenCount, briefing.tokenCount, this.stats.totalBriefings);
+        this.stats.avgGenerationMs = this.runningAvg(this.stats.avgGenerationMs, Date.now() - start, this.stats.totalBriefings);
+        this.stats.byAgent[opts.agentTool] = (this.stats.byAgent[opts.agentTool] ?? 0) + 1;
+        this.stats.lastBriefing = new Date();
+        return briefing;
+    }
+    /** Get current stats */
+    getStats() {
+        return { ...this.stats };
+    }
+    /** Update config at runtime */
+    configure(patch) {
+        this.config = { ...this.config, ...patch };
+    }
+    getConfig() {
+        return { ...this.config };
+    }
+    // ─── Private helpers ────────────────────────────────────────────────────────
+    fetchSection(projectId, categories, cutoffMs, limit) {
+        const results = [];
+        for (const category of categories) {
+            const entries = this.brain.recall({
+                projectId,
+                category,
+                limit,
+                minImportance: this.config.relevanceThreshold,
+            });
+            for (const e of entries) {
+                if (e.lastAccessed.getTime() >= cutoffMs || e.createdAt.getTime() >= cutoffMs) {
+                    results.push(e);
+                }
+            }
+        }
+        return results
+            .sort((a, b) => b.importance - a.importance)
+            .slice(0, limit);
+    }
+    fetchCrossAgentInsights(projectId, currentAgent, cutoffMs, limit) {
+        const all = this.brain.recall({
+            projectId,
+            limit: limit * 3,
+            minImportance: this.config.relevanceThreshold,
+        });
+        return all
+            .filter(e => e.agentTool !== currentAgent && (e.lastAccessed.getTime() >= cutoffMs || e.createdAt.getTime() >= cutoffMs))
+            .slice(0, limit);
+    }
+    fetchProjectStateSummary(projectId) {
+        const recent = this.brain.recall({ projectId, category: 'state', limit: 1 });
+        if (recent.length)
+            return recent[0].content.slice(0, 300);
+        const top = this.brain.recall({ projectId, limit: 3 });
+        if (!top.length)
+            return '';
+        return top.map(e => `${e.category}: ${e.content.slice(0, 80)}`).join('; ');
+    }
+    fetchSimilarWork(taskHint, agentTool, limit) {
+        const keywords = this.extractKeywords(taskHint);
+        if (!keywords.length)
+            return [];
+        return this.brain.recall({
+            keywords,
+            limit,
+            minImportance: this.config.relevanceThreshold,
+        });
+    }
+    fetchTopPatterns(projectId, limit) {
+        return this.brain.recall({ projectId, category: 'pattern', limit });
+    }
+    extractKeywords(text) {
+        const stop = new Set(['the', 'and', 'or', 'a', 'an', 'is', 'are', 'was', 'were', 'in', 'on', 'at', 'to', 'for', 'of', 'with', 'by', 'this', 'that']);
+        return text
+            .toLowerCase()
+            .split(/\W+/)
+            .filter(w => w.length > 3 && !stop.has(w))
+            .slice(0, 5);
+    }
+    formatEntry(entry) {
+        const content = entry.content.length > 200 ? entry.content.slice(0, 197) + '...' : entry.content;
+        return content;
+    }
+    assembleBriefing(briefing, projectName) {
+        const parts = [];
+        parts.push(`# 🧠 Shadow Brain — Subconscious Briefing`);
+        parts.push(`_Project: ${projectName} | Agent: ${briefing.agentTool} | Auto-generated by Shadow Brain v5.2.0_`);
+        parts.push('');
+        if (briefing.sections.warnings.length) {
+            parts.push(`## ⚠️ Warnings`);
+            for (const w of briefing.sections.warnings)
+                parts.push(`- ${w}`);
+            parts.push('');
+        }
+        if (briefing.sections.recentDecisions.length) {
+            parts.push(`## Recent Decisions`);
+            for (const d of briefing.sections.recentDecisions)
+                parts.push(`- ${d}`);
+            parts.push('');
+        }
+        if (briefing.sections.activeTasks.length) {
+            parts.push(`## Active Tasks`);
+            for (const t of briefing.sections.activeTasks)
+                parts.push(`- ${t}`);
+            parts.push('');
+        }
+        if (briefing.sections.projectState) {
+            parts.push(`## Project State`);
+            parts.push(briefing.sections.projectState);
+            parts.push('');
+        }
+        if (briefing.sections.crossAgentInsights.length) {
+            parts.push(`## Cross-Agent Insights`);
+            for (const i of briefing.sections.crossAgentInsights)
+                parts.push(`- ${i}`);
+            parts.push('');
+        }
+        if (briefing.sections.similarPastWork.length) {
+            parts.push(`## Similar Past Work`);
+            for (const s of briefing.sections.similarPastWork)
+                parts.push(`- ${s}`);
+            parts.push('');
+        }
+        return parts.join('\n').trim();
+    }
+    trimToBudget(briefing, projectName) {
+        // Drop sections in this priority order until under budget:
+        // similarPastWork → crossAgentInsights → activeTasks → recentDecisions → warnings (warnings last)
+        const trimmedSections = { ...briefing.sections };
+        const dropOrder = ['similarPastWork', 'crossAgentInsights', 'activeTasks', 'recentDecisions'];
+        for (const key of dropOrder) {
+            let text = this.assembleBriefing({ ...briefing, sections: trimmedSections }, projectName);
+            if (estimateTokens(text) <= this.config.tokenBudget)
+                return text;
+            const arr = trimmedSections[key];
+            if (Array.isArray(arr)) {
+                trimmedSections[key] = [];
+            }
+            else {
+                trimmedSections[key] = '';
+            }
+        }
+        return this.assembleBriefing({ ...briefing, sections: trimmedSections }, projectName);
+    }
+    emptyBriefing(agentTool, projectDir, sessionId) {
+        return {
+            agentTool,
+            projectDir,
+            sessionId,
+            generatedAt: new Date(),
+            tokenCount: 0,
+            sections: {
+                recentDecisions: [],
+                activeTasks: [],
+                similarPastWork: [],
+                projectState: '',
+                crossAgentInsights: [],
+                warnings: [],
+            },
+            fullText: '',
+        };
+    }
+    runningAvg(prev, next, n) {
+        return prev + (next - prev) / n;
+    }
+}
+let defaultEngine = null;
+export function getSubconscious(config) {
+    if (!defaultEngine)
+        defaultEngine = new SubconsciousEngine(config);
+    else if (config)
+        defaultEngine.configure(config);
+    return defaultEngine;
+}
+//# sourceMappingURL=subconscious.js.map

package/dist/brain/subconscious.js.map

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

package/dist/cli.js

@@ -2495,8 +2495,7 @@ const offCmd = new Command('off')
     .action(async () => {
     console.log(chalk.magenta.bold('\n  SHADOW BRAIN v' + VERSION + ' — Shutting down'));
     try {
-        const { default: execaDefault } = await import('execa');
-        const exec = execaDefault;
+        const { execa: exec } = await import('execa');
         try {
             if (process.platform === 'win32') {
                 await exec('taskkill', ['/F', '/IM', 'node.exe', '/FI', 'WINDOWTITLE eq shadow-brain*'], { reject: false });
@@ -2929,5 +2928,171 @@ program.addCommand(cacheCmd);
 program.addCommand(intentCmd);
 program.addCommand(dnaCmd);
 program.addCommand(temporalCmd);
+// ─── v5.2.0 — SUBCONSCIOUS SINGULARITY ──────────────────────────────────────
+const attachCmd = new Command('attach-all')
+    .description('Auto-detect every installed AI agent and install Shadow Brain hooks (v5.2.0)')
+    .argument('[project-dir]', 'Project directory', process.cwd())
+    .option('--dry-run', 'Show what would be attached without installing')
+    .action(async (projectDir, opts) => {
+    console.log(chalk.magenta.bold(`\n  SHADOW BRAIN v${VERSION} — Universal Bootstrap`));
+    const { getHookInstaller } = await import('./brain/session-hooks.js');
+    const installer = getHookInstaller();
+    if (opts.dryRun) {
+        const detected = await installer.detectInstalled(projectDir);
+        console.log(chalk.cyan(`  Detected agents: ${detected.length}`));
+        for (const agent of detected) {
+            console.log(`    ${chalk.green('✓')} ${agent}`);
+        }
+        console.log(chalk.dim('\n  Run without --dry-run to install hooks.'));
+        return;
+    }
+    const report = await installer.attachAll(projectDir);
+    console.log(chalk.cyan(`  Detected: ${report.detected.length} agents (${report.durationMs}ms)`));
+    for (const agent of report.attached) {
+        console.log(`    ${chalk.green('✓')} ${agent} attached`);
+    }
+    for (const fail of report.failed) {
+        console.log(`    ${chalk.red('✗')} ${fail.agent}: ${fail.reason}`);
+    }
+    console.log(chalk.dim(`\n  ${report.hooks.length} hook(s) installed across ${report.attached.length} agent(s).`));
+    console.log(chalk.dim('  Every agent will now call Shadow Brain on session start.'));
+});
+const subconsciousCmd = new Command('subconscious')
+    .description('Manage the Subconscious Engine — proactive context injection')
+    .addCommand(new Command('inject')
+    .description('Generate + emit a session-start briefing for the current agent')
+    .option('--agent <agent>', 'Agent tool name (auto-detected if omitted)')
+    .option('--task <hint>', 'Current task hint for similarity search')
+    .option('--json', 'Output JSON instead of formatted text')
+    .action(async (opts) => {
+    const { getSubconscious } = await import('./brain/subconscious.js');
+    const { GlobalBrain } = await import('./brain/global-brain.js');
+    const projectDir = process.cwd();
+    const projectId = GlobalBrain.projectIdFor(projectDir);
+    let agentTool = opts.agent;
+    if (!agentTool) {
+        const detected = await detectRunningAgents(projectDir);
+        agentTool = detected[0]?.name || 'claude-code';
+    }
+    const sub = getSubconscious();
+    const briefing = await sub.generateBriefing({
+        agentTool,
+        projectDir,
+        projectId,
+        currentTask: opts.task,
+    });
+    if (opts.json) {
+        console.log(JSON.stringify(briefing, null, 2));
+    }
+    else {
+        console.log(briefing.fullText || chalk.dim('(no relevant context yet — brain is empty)'));
+    }
+}))
+    .addCommand(new Command('status')
+    .description('Show subconscious engine stats')
+    .action(async () => {
+    const { getSubconscious } = await import('./brain/subconscious.js');
+    const stats = getSubconscious().getStats();
+    console.log(chalk.magenta.bold(`\n  SHADOW BRAIN v${VERSION} — Subconscious Stats`));
+    console.log(`    Total briefings: ${chalk.cyan(stats.totalBriefings)}`);
+    console.log(`    Avg tokens: ${chalk.cyan(stats.avgTokenCount.toFixed(0))}`);
+    console.log(`    Avg generation: ${chalk.cyan(stats.avgGenerationMs.toFixed(1) + 'ms')}`);
+    console.log(`    By agent:`);
+    for (const [agent, count] of Object.entries(stats.byAgent)) {
+        console.log(`      ${chalk.dim('•')} ${agent}: ${count}`);
+    }
+}))
+    .addCommand(new Command('configure')
+    .description('Update subconscious config')
+    .option('--budget <tokens>', 'Token budget (default 2000)')
+    .option('--lookback <hours>', 'Lookback hours (default 24)')
+    .option('--threshold <score>', 'Relevance threshold 0-1')
+    .option('--enable', 'Enable subconscious')
+    .option('--disable', 'Disable subconscious')
+    .action(async (opts) => {
+    const { getSubconscious } = await import('./brain/subconscious.js');
+    const sub = getSubconscious();
+    const patch = {};
+    if (opts.budget)
+        patch.tokenBudget = parseInt(opts.budget, 10);
+    if (opts.lookback)
+        patch.lookbackHours = parseFloat(opts.lookback);
+    if (opts.threshold)
+        patch.relevanceThreshold = parseFloat(opts.threshold);
+    if (opts.enable)
+        patch.enabled = true;
+    if (opts.disable)
+        patch.enabled = false;
+    sub.configure(patch);
+    console.log(chalk.green('  ✓ Subconscious config updated.'));
+    console.log(JSON.stringify(sub.getConfig(), null, 2));
+}));
+const globalBrainCmd = new Command('global')
+    .description('Manage the Singleton Global Brain — one brain, all projects, all agents')
+    .addCommand(new Command('stats')
+    .description('Show global brain stats')
+    .action(async () => {
+    const { getGlobalBrain } = await import('./brain/global-brain.js');
+    const brain = getGlobalBrain();
+    await brain.init();
+    const s = brain.getStats();
+    console.log(chalk.magenta.bold(`\n  SHADOW BRAIN v${VERSION} — Global Brain`));
+    console.log(`    Projects: ${chalk.cyan(s.totalProjects)}`);
+    console.log(`    Agents:   ${chalk.cyan(s.totalAgents)}`);
+    console.log(`    Entries:  ${chalk.cyan(s.totalEntries)}`);
+    console.log(`    Size:     ${chalk.cyan(s.totalSizeMB.toFixed(2) + ' MB')}`);
+    console.log(`    Hit rate: ${chalk.cyan((s.hitRate * 100).toFixed(1) + '%')} (${s.hits}/${s.hits + s.misses})`);
+    console.log(`    Pending:  ${chalk.cyan(s.pendingWrites)}`);
+    console.log(`    Uptime:   ${chalk.cyan(Math.round(s.uptime / 1000) + 's')}`);
+    console.log(`    Last sync: ${chalk.dim(s.lastSync.toISOString())}`);
+}))
+    .addCommand(new Command('recall')
+    .description('Recall entries from the global brain — works across projects + agents')
+    .option('-q, --query <text>', 'Keyword search')
+    .option('--agent <agent>', 'Filter by agent tool')
+    .option('--category <cat>', 'Filter by category')
+    .option('--limit <n>', 'Max results', '20')
+    .option('--json', 'Output JSON')
+    .action(async (opts) => {
+    const { getGlobalBrain } = await import('./brain/global-brain.js');
+    const brain = getGlobalBrain();
+    await brain.init();
+    const results = brain.recall({
+        keywords: opts.query ? opts.query.split(/\s+/) : undefined,
+        agentTool: opts.agent,
+        category: opts.category,
+        limit: parseInt(opts.limit, 10),
+    });
+    if (opts.json) {
+        console.log(JSON.stringify(results, null, 2));
+        return;
+    }
+    console.log(chalk.magenta.bold(`\n  SHADOW BRAIN v${VERSION} — Global Recall (${results.length})`));
+    for (const r of results) {
+        console.log(`    ${chalk.cyan('[' + r.agentTool + ']')} ${chalk.dim(r.category)} ${chalk.white(r.content.slice(0, 100))}`);
+    }
+}))
+    .addCommand(new Command('cache')
+    .description('Show L0 in-memory cache stats')
+    .action(async () => {
+    const { getAllCacheStats } = await import('./brain/l0-cache.js');
+    const all = getAllCacheStats();
+    console.log(chalk.magenta.bold(`\n  SHADOW BRAIN v${VERSION} — L0 Cache`));
+    for (const [name, s] of Object.entries(all)) {
+        console.log(`    ${chalk.cyan(name)}: ${s.entries} entries, ${(s.bytesUsed / 1024).toFixed(1)} KB / ${(s.bytesLimit / 1024 / 1024).toFixed(0)} MB, ${(s.hitRate * 100).toFixed(1)}% hits, ${s.avgAccessNs.toFixed(0)}ns avg`);
+    }
+}))
+    .addCommand(new Command('sync')
+    .description('Force flush of pending writes to disk')
+    .action(async () => {
+    const { getGlobalBrain } = await import('./brain/global-brain.js');
+    const brain = getGlobalBrain();
+    await brain.init();
+    await brain.sync();
+    console.log(chalk.green('  ✓ Synced to disk.'));
+}));
+program.addCommand(attachCmd);
+program.addCommand(subconsciousCmd);
+program.addCommand(globalBrainCmd);
 program.parse();
 //# sourceMappingURL=cli.js.map