brainbank 0.9.0 → 0.9.1

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "brainbank",
-    "version": "0.9.0",
+    "version": "0.9.1",
     "description": "Pluggable semantic memory for AI agents — hybrid search (vector + BM25) in a single SQLite file. Built-in code, git, and docs indexers. Bring your own.",
     "type": "module",
     "main": "dist/index.js",

package/src/cli/commands/help.ts

@@ -36,11 +36,13 @@ export function showHelp(): void {
     console.log(`  ${c.cyan('reembed')}                            Re-embed all vectors`);
     console.log(`  ${c.cyan('watch')}                              Watch files, auto-re-index`);
     console.log(`  ${c.cyan('mcp')}                                Start MCP server (stdio)`);
+    console.log(`  ${c.cyan('mcp:export')} [target]                Export MCP config (antigravity)`);
     console.log(`  ${c.cyan('daemon')}                             Start HTTP daemon (foreground)`);
     console.log(`  ${c.cyan('daemon start')}                       Start HTTP daemon (background)`);
     console.log(`  ${c.cyan('daemon stop')}                        Stop background daemon`);
     console.log(`  ${c.cyan('daemon restart')}                     Restart background daemon`);
     console.log(`  ${c.cyan('status')}                             Show daemon status`);
+    console.log(`  ${c.cyan('--version')} ${c.dim('(-v)')}                      Show version`);
     console.log('');
     console.log(c.bold('Options:'));
     console.log(`  ${c.dim('--repo <path>')}           Repository path (default: .)`);
@@ -69,4 +71,5 @@ export function showHelp(): void {
     console.log(c.dim('  brainbank context "auth flow" | pbcopy               # → clipboard'));
     console.log(c.dim('  brainbank daemon start                               # background HTTP'));
     console.log(c.dim('  brainbank mcp                                        # MCP stdio'));
+    console.log(c.dim('  brainbank mcp:export antigravity                     # export MCP config'));
 }

package/src/cli/commands/index.ts

@@ -12,6 +12,7 @@ import * as path from 'node:path';
 import { c, args, getFlag, hasFlag, stripFlags } from '@/cli/utils.ts';
 import { createBrain, getConfig, registerConfigCollections } from '@/cli/factory/index.ts';
 import { findDocsPlugin } from '@/cli/utils.ts';
+import { autoExportMcp } from './mcp-export.ts';
 import { scanRepo } from './scan.ts';
 
 export async function cmdIndex(): Promise<void> {
@@ -126,6 +127,9 @@ export async function cmdIndex(): Promise<void> {
     }
 
     brain.close();
+
+    // Auto-export MCP config to Antigravity if detected and not already configured
+    await autoExportMcp(repoPath);
 }
 
 
@@ -220,7 +224,7 @@ function capitalizeFirst(s: string): string {
 
 /** Generate .brainbank/config.json from the selected modules. */
 async function saveConfig(repoPath: string, modules: string[]): Promise<void> {
-    const { select } = await import('@inquirer/prompts');
+    const { select, confirm } = await import('@inquirer/prompts');
 
     // Embedding provider selection
     const envEmbedding = process.env.BRAINBANK_EMBEDDING;
@@ -252,15 +256,15 @@ async function saveConfig(repoPath: string, modules: string[]): Promise<void> {
         message: 'Noise pruner:',
         choices: [
             {
-                name: 'none   — no pruning (default)',
-                value: 'none',
+                name: 'haiku  — AI-powered noise filter (recommended)',
+                value: 'haiku',
             },
             {
-                name: 'haiku  — AI-powered noise filter (Claude Haiku)',
-                value: 'haiku',
+                name: 'none   — no pruning',
+                value: 'none',
             },
         ],
-        default: 'none',
+        default: 'haiku',
     });
 
     const configDir = path.join(repoPath, '.brainbank');
@@ -275,6 +279,33 @@ async function saveConfig(repoPath: string, modules: string[]): Promise<void> {
         config.pruner = pruner;
     }
 
+    // Key management: detect available keys and offer to save
+    const detectedKeys: Record<string, string> = {};
+    const needsPerplexity = embedding.startsWith('perplexity');
+    const needsAnthropic = pruner === 'haiku';
+    const needsOpenai = embedding === 'openai';
+
+    if (needsPerplexity && process.env.PERPLEXITY_API_KEY) {
+        detectedKeys.perplexity = process.env.PERPLEXITY_API_KEY;
+    }
+    if (needsAnthropic && process.env.ANTHROPIC_API_KEY) {
+        detectedKeys.anthropic = process.env.ANTHROPIC_API_KEY;
+    }
+    if (needsOpenai && process.env.OPENAI_API_KEY) {
+        detectedKeys.openai = process.env.OPENAI_API_KEY;
+    }
+
+    if (Object.keys(detectedKeys).length > 0) {
+        const keyNames = Object.keys(detectedKeys).join(', ');
+        const saveKeys = await confirm({
+            message: `Save API keys (${keyNames}) to config.json? (portable, no env vars needed)`,
+            default: true,
+        });
+        if (saveKeys) {
+            config.keys = detectedKeys;
+        }
+    }
+
     fs.mkdirSync(configDir, { recursive: true });
     fs.writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n');
     console.log(c.green(`  ✓ Saved ${path.relative(process.cwd(), configPath)}`));

package/src/cli/commands/mcp-export.ts

@@ -0,0 +1,163 @@
+/**
+ * brainbank mcp:export [target] — Export MCP server config for AI IDEs.
+ *
+ * Generates the MCP server config block for brainbank and merges it into
+ * the target IDE's config file. Currently supports: antigravity.
+ *
+ * Detects: node path, cli.js path, API keys from config or env vars.
+ */
+
+import type { ProjectConfig } from '@/cli/factory/config-loader.ts';
+
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { c, args, getFlag } from '@/cli/utils.ts';
+import { getConfig } from '@/cli/factory/index.ts';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+/** Supported export targets and their config file paths. */
+const TARGETS: Record<string, { configPath: string; label: string }> = {
+    antigravity: {
+        configPath: path.join(process.env.HOME ?? '~', '.gemini', 'antigravity', 'mcp_config.json'),
+        label: 'Gemini Antigravity',
+    },
+};
+
+interface McpServerConfig {
+    command: string;
+    args: string[];
+    env?: Record<string, string>;
+    cwd?: string;
+}
+
+interface McpConfig {
+    mcpServers: Record<string, McpServerConfig>;
+}
+
+/**
+ * Build the brainbank MCP server config block.
+ * Resolves node binary, dist/cli.js path, and API keys.
+ */
+function buildBrainbankMcpBlock(config: ProjectConfig | null): McpServerConfig {
+    const nodeBin = process.execPath;
+
+    // Resolve dist/cli.js from the global install location (node_prefix/lib/node_modules/brainbank/dist/cli.js)
+    const globalCliJs = path.join(path.dirname(nodeBin), '..', 'lib', 'node_modules', 'brainbank', 'dist', 'cli.js');
+    // Fallback: relative to this file (dev / npm link)
+    const localCliJs = path.resolve(__dirname, '..', '..', 'dist', 'cli.js');
+    const resolvedCliJs = fs.existsSync(globalCliJs) ? globalCliJs : localCliJs;
+
+    const env: Record<string, string> = {};
+
+    // Resolve API keys: config.keys > env vars
+    const keys = config?.keys;
+    const perplexityKey = keys?.perplexity ?? process.env.PERPLEXITY_API_KEY;
+    const anthropicKey = keys?.anthropic ?? process.env.ANTHROPIC_API_KEY;
+    const openaiKey = keys?.openai ?? process.env.OPENAI_API_KEY;
+
+    if (perplexityKey) env.PERPLEXITY_API_KEY = perplexityKey;
+    if (anthropicKey) env.ANTHROPIC_API_KEY = anthropicKey;
+    if (openaiKey) env.OPENAI_API_KEY = openaiKey;
+
+    const block: McpServerConfig = {
+        command: nodeBin,
+        args: [resolvedCliJs, 'mcp'],
+    };
+
+    if (Object.keys(env).length > 0) {
+        block.env = env;
+    }
+
+    return block;
+}
+
+/**
+ * Load existing MCP config, merge brainbank entry, and write back.
+ * Preserves all other server entries.
+ */
+function mergeAndWrite(targetPath: string, block: McpServerConfig): { created: boolean } {
+    let existing: McpConfig = { mcpServers: {} };
+    const created = !fs.existsSync(targetPath);
+
+    if (!created) {
+        try {
+            const raw = fs.readFileSync(targetPath, 'utf-8');
+            existing = JSON.parse(raw) as McpConfig;
+            if (!existing.mcpServers) existing.mcpServers = {};
+        } catch {
+            // Corrupt or empty file — start fresh
+            existing = { mcpServers: {} };
+        }
+    }
+
+    existing.mcpServers.brainbank = block;
+
+    fs.mkdirSync(path.dirname(targetPath), { recursive: true });
+    fs.writeFileSync(targetPath, JSON.stringify(existing, null, 2) + '\n');
+
+    return { created };
+}
+
+/** Check if an MCP config already has a brainbank entry. */
+export function hasBrainbankMcpEntry(targetPath: string): boolean {
+    if (!fs.existsSync(targetPath)) return false;
+    try {
+        const raw = fs.readFileSync(targetPath, 'utf-8');
+        const config = JSON.parse(raw) as McpConfig;
+        return !!config.mcpServers?.brainbank;
+    } catch {
+        return false;
+    }
+}
+
+/** Auto-export: called after index when Antigravity is detected. */
+export async function autoExportMcp(repoPath: string): Promise<void> {
+    const target = TARGETS.antigravity;
+    if (!target) return;
+
+    // Only auto-export if Antigravity dir exists
+    const antigravityDir = path.dirname(target.configPath);
+    if (!fs.existsSync(antigravityDir)) return;
+
+    // Only auto-export if brainbank isn't already configured
+    if (hasBrainbankMcpEntry(target.configPath)) return;
+
+    const config = await getConfig(repoPath);
+    const block = buildBrainbankMcpBlock(config);
+    mergeAndWrite(target.configPath, block);
+    console.log(`  ${c.green('✓')} Exported MCP config to ${c.dim(path.relative(process.env.HOME ?? '', target.configPath))}`);
+}
+
+/** CLI command: brainbank mcp:export [target] */
+export async function cmdMcpExport(): Promise<void> {
+    const targetName = args[1] || getFlag('target') || 'antigravity';
+    const repoPath = getFlag('repo') || '.';
+
+    const target = TARGETS[targetName];
+    if (!target) {
+        console.error(c.red(`Unknown export target: ${targetName}`));
+        console.error(c.dim(`  Available: ${Object.keys(TARGETS).join(', ')}`));
+        process.exit(1);
+    }
+
+    const config = await getConfig(repoPath);
+    const block = buildBrainbankMcpBlock(config);
+    const { created } = mergeAndWrite(target.configPath, block);
+
+    console.log(c.bold(`\n━━━ MCP Export: ${target.label} ━━━\n`));
+    console.log(`  ${c.green('✓')} ${created ? 'Created' : 'Updated'} ${c.dim(target.configPath)}`);
+    console.log(`  ${c.dim('Node:')}    ${block.command}`);
+    console.log(`  ${c.dim('CLI:')}     ${block.args[0]}`);
+
+    const envKeys = block.env ? Object.keys(block.env) : [];
+    if (envKeys.length > 0) {
+        console.log(`  ${c.dim('Keys:')}    ${envKeys.join(', ')}`);
+    } else {
+        console.log(`  ${c.yellow('⚠')} No API keys found. Set env vars or add keys to .brainbank/config.json`);
+    }
+
+    console.log(`\n  ${c.dim('Restart your IDE to apply changes.')}\n`);
+}

package/src/cli/index.ts

@@ -18,14 +18,20 @@ import { cmdStats } from './commands/stats.ts';
 import { cmdReembed } from './commands/reembed.ts';
 import { cmdWatch } from './commands/watch.ts';
 import { cmdMcp } from './commands/mcp.ts';
+import { cmdMcpExport } from './commands/mcp-export.ts';
 import { cmdDaemon } from './commands/daemon.ts';
 import { cmdStatus } from './commands/status.ts';
 import { showHelp } from './commands/help.ts';
+import { VERSION } from '@/constants.ts';
 
 const command = args[0];
 
 async function main(): Promise<void> {
     switch (command) {
+        case '--version':
+        case '-v':
+            console.log(`brainbank v${VERSION}`);
+            break;
         case 'i':
         case 'index':       return cmdIndex();
         case 'collection':  return cmdCollection();
@@ -41,6 +47,7 @@ async function main(): Promise<void> {
         case 'reembed':     return cmdReembed();
         case 'watch':       return cmdWatch();
         case 'mcp':         return cmdMcp();
+        case 'mcp:export':  return cmdMcpExport();
         case 'serve':        return cmdMcp(); // backward compat
         case 'daemon':      return cmdDaemon();
         case 'status':      return cmdStatus();

package/src/constants.ts

@@ -5,6 +5,14 @@
  * to their respective packages. Only keys owned by the core live here.
  */
 
+import { createRequire } from 'node:module';
+
+const require = createRequire(import.meta.url);
+const pkg = require('../package.json') as { version: string };
+
+/** Package version from package.json. */
+export const VERSION: string = pkg.version;
+
 /** HNSW index key for KV collections (core-owned). */
 export const HNSW = {
     KV: 'kv',