brainbank 0.1.0-beta.1

package/src/cli/commands/context.ts

@@ -0,0 +1,179 @@
+/**
+ * brainbank context <task> — Get formatted context for a task
+ * brainbank context add <collection> <path> <description>
+ * brainbank context list
+ *
+ * Source filtering (same as search commands):
+ *   --code 20    Max code results (default: 20)
+ *   --git 5      Max git results
+ *   --no-git     Skip git results
+ *   --no-code    Skip code results
+ *   --path <dir>  Filter results to files under path prefix(es) (comma-separated for multiple)
+ *   --ignore <paths> Exclude paths (comma-separated or repeated: --ignore a,b --ignore c)
+ */
+
+import { c, args, stripFlags, getFlag, getFlagAll, findDocsPlugin } from '@/cli/utils.ts';
+import { createBrain } from '@/cli/factory/index.ts';
+import { tryServerContext } from '@/cli/server-client.ts';
+
+/** Parse --code N, --git N, --no-git, --no-code flags into sources map. */
+function parseContextFlags(): Record<string, number> {
+    const NON_SOURCE = new Set([
+        'repo', 'depth', 'collection', 'pattern', 'context', 'name',
+        'keep', 'pruner', 'only', 'docs-path', 'mode', 'limit',
+        'ignore', 'meta', 'k', 'yes', 'y', 'force', 'verbose', 'path',
+    ]);
+    const sources: Record<string, number> = {};
+    for (let i = 0; i < args.length; i++) {
+        if (!args[i].startsWith('--')) continue;
+        const name = args[i].slice(2);
+        // --no-git, --no-code → set to 0
+        if (name.startsWith('no-')) {
+            sources[name.slice(3)] = 0;
+            continue;
+        }
+        // --code 20, --git 5
+        const next = args[i + 1];
+        if (next !== undefined && /^\d+$/.test(next) && !NON_SOURCE.has(name)) {
+            sources[name] = parseInt(next, 10);
+            i++;
+        }
+    }
+    return sources;
+}
+
+export async function cmdContext(): Promise<void> {
+    const pos = stripFlags(args);
+    const sub = pos[1];
+
+    // brainbank context add <collection> <path> <description>
+    if (sub === 'add') {
+        const collection = pos[2];
+        const path = pos[3];
+        const desc = pos.slice(4).join(' ');
+
+        if (!collection || !path || !desc) {
+            console.log(c.red('Usage: brainbank context add <collection> <path> <description>'));
+            process.exit(1);
+        }
+
+        const brain = await createBrain();
+        await brain.initialize();
+        const docsPlugin = findDocsPlugin(brain);
+        if (!docsPlugin) { console.log(c.red('Docs plugin not loaded.')); process.exit(1); }
+        docsPlugin.addContext(collection, path, desc);
+        console.log(c.green(`✓ Context added: ${collection}:${path} → "${desc}"`));
+        brain.close();
+        return;
+    }
+
+    // brainbank context list
+    if (sub === 'list') {
+        const brain = await createBrain();
+        await brain.initialize();
+        const docsPlugin = findDocsPlugin(brain);
+        if (!docsPlugin) { console.log(c.yellow('  Docs plugin not loaded.')); brain.close(); return; }
+        const contexts = docsPlugin.listContexts();
+        if (contexts.length === 0) {
+            console.log(c.yellow('  No contexts configured.'));
+        } else {
+            console.log(c.bold('\n━━━ Contexts ━━━\n'));
+            for (const ctx of contexts) {
+                console.log(`  ${c.cyan(ctx.collection)}:${ctx.path} → ${c.dim(ctx.context)}`);
+            }
+        }
+        brain.close();
+        return;
+    }
+
+    // brainbank context <task> — get formatted context
+    const task = stripFlags(args).slice(1).join(' ');
+    if (!task) {
+        console.log(c.red('Usage: brainbank context <task description>'));
+        console.log(c.dim('       brainbank context add <collection> <path> <description>'));
+        console.log(c.dim('       brainbank context list'));
+        process.exit(1);
+    }
+
+    const sources = parseContextFlags();
+    const rawPath = getFlag('path');
+    const pathPrefix = rawPath
+        ? rawPath.split(',').map(p => p.trim()).filter(Boolean)
+        : undefined;
+    // Normalize single-element array to string
+    const normalizedPath = pathPrefix && pathPrefix.length === 1 ? pathPrefix[0] : pathPrefix;
+    const ignorePaths = getFlagAll('ignore');
+    const repo = getFlag('repo');
+
+    // Parse BrainBankQL field flags
+    const fields = parseFieldFlags();
+
+    // Try HTTP server delegation first
+    const serverResult = await tryServerContext({
+        task,
+        repo: repo ?? process.cwd(),
+        sources: Object.keys(sources).length > 0 ? sources : undefined,
+        pathPrefix: normalizedPath,
+    });
+
+    if (serverResult !== null) {
+        console.log(serverResult);
+        return;
+    }
+
+    // Fall back to local
+    const brain = await createBrain();
+    const context = await brain.getContext(task, {
+        sources: Object.keys(sources).length > 0 ? sources : undefined,
+        pathPrefix: normalizedPath,
+        ignorePaths: ignorePaths.length > 0 ? ignorePaths : undefined,
+        source: 'cli',
+        fields: Object.keys(fields).length > 0 ? fields : undefined,
+    });
+    console.log(context);
+    brain.close();
+}
+
+/** Parse BrainBankQL field flags: --lines, --symbols, --compact, --no-callTree, --callTree.depth=N, etc. */
+function parseFieldFlags(): Record<string, unknown> {
+    const FIELD_BOOLEANS = new Set(['lines', 'symbols', 'compact', 'expander']);
+    const FIELD_NEGATABLE = new Set(['callTree', 'imports']);
+    const fields: Record<string, unknown> = {};
+
+    for (let i = 0; i < args.length; i++) {
+        if (!args[i].startsWith('--')) continue;
+        const raw = args[i].slice(2);
+
+        // --no-callTree, --no-imports → set to false
+        if (raw.startsWith('no-')) {
+            const name = raw.slice(3);
+            if (FIELD_NEGATABLE.has(name)) {
+                fields[name] = false;
+            }
+            continue;
+        }
+
+        // --callTree.depth=4 → { depth: 4 }
+        const dotIdx = raw.indexOf('.');
+        if (dotIdx > 0) {
+            const fieldName = raw.slice(0, dotIdx);
+            const rest = raw.slice(dotIdx + 1);
+            const eqIdx = rest.indexOf('=');
+            if (eqIdx > 0) {
+                const key = rest.slice(0, eqIdx);
+                const val = parseInt(rest.slice(eqIdx + 1), 10);
+                if (!isNaN(val)) {
+                    fields[fieldName] = { [key]: val };
+                }
+            }
+            continue;
+        }
+
+        // --lines, --symbols, --compact, --expander → true
+        if (FIELD_BOOLEANS.has(raw)) {
+            fields[raw] = true;
+        }
+    }
+
+    return fields;
+}

package/src/cli/commands/daemon.ts

@@ -0,0 +1,100 @@
+/**
+ * brainbank daemon — HTTP daemon for CLI delegation.
+ *
+ *   brainbank daemon              → Start foreground
+ *   brainbank daemon start        → Start background (fork + PID file)
+ *   brainbank daemon stop         → Stop background daemon
+ *   brainbank daemon restart      → Stop + start
+ */
+
+import { c, args, getFlag, stripFlags } from '@/cli/utils.ts';
+import { isServerRunning, removePid, DEFAULT_PORT } from '@/services/daemon.ts';
+import { createBrain } from '@/cli/factory/index.ts';
+
+export async function cmdDaemon(): Promise<void> {
+    const pos = stripFlags(args);
+    const sub = pos[1]; // start | stop | undefined
+
+    if (sub === 'stop') return stopDaemon();
+    if (sub === 'restart') { stopDaemon(); return forkDaemon(); }
+    if (sub === 'start') return forkDaemon();
+    return startForeground();
+}
+
+// ── Foreground ──────────────────────────────────
+
+async function startForeground(): Promise<void> {
+    const port = parseInt(getFlag('port') ?? String(DEFAULT_PORT), 10);
+    const { HttpServer } = await import('@/services/http-server.ts');
+
+    const server = new HttpServer({
+        port,
+        factory: async (repoPath: string) => {
+            const brain = await createBrain(repoPath);
+            await brain.initialize();
+            return brain;
+        },
+        onError: (repo, err) => {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.error(c.red(`  Pool error [${repo}]: ${msg}`));
+        },
+        onLog: (msg) => console.log(c.dim(`  ${msg}`)),
+    });
+
+    console.log(c.bold('\n━━━ BrainBank HTTP Daemon ━━━\n'));
+
+    await server.start();
+
+    console.log(c.dim(`  Port: ${port}`));
+    console.log(c.dim('  Press Ctrl+C to stop.\n'));
+
+    const shutdown = () => {
+        console.log(c.dim('\n  Shutting down...'));
+        server.close();
+        process.exit(0);
+    };
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+
+    await new Promise(() => {});
+}
+
+// ── Background ──────────────────────────────────
+
+async function forkDaemon(): Promise<void> {
+    const port = parseInt(getFlag('port') ?? String(DEFAULT_PORT), 10);
+    const { fork } = await import('node:child_process');
+
+    const existing = isServerRunning();
+    if (existing) {
+        console.log(c.yellow(`  Daemon already running (PID ${existing.pid}, port ${existing.port})`));
+        return;
+    }
+
+    const child = fork(process.argv[1], ['daemon', '--port', String(port)], {
+        detached: true,
+        stdio: 'ignore',
+    });
+
+    child.unref();
+
+    console.log(c.green(`  ✓ Daemon started (PID ${child.pid}, port ${port})`));
+    console.log(c.dim('  Stop with: brainbank daemon stop'));
+}
+
+function stopDaemon(): void {
+    const info = isServerRunning();
+    if (!info) {
+        console.log(c.yellow('  No daemon running.'));
+        return;
+    }
+
+    try {
+        process.kill(info.pid, 'SIGTERM');
+        removePid();
+        console.log(c.green(`  ✓ Daemon stopped (PID ${info.pid})`));
+    } catch {
+        removePid();
+        console.log(c.yellow(`  PID ${info.pid} not found. Cleaned up stale PID file.`));
+    }
+}

package/src/cli/commands/docs.ts

@@ -0,0 +1,71 @@
+/**
+ * brainbank docs — Index document collections
+ * brainbank dsearch — Search documents only
+ */
+
+import { c, args, getFlag, stripFlags, findDocsPlugin } from '@/cli/utils.ts';
+import { createBrain } from '@/cli/factory/index.ts';
+
+export async function cmdDocs(): Promise<void> {
+    const collection = getFlag('collection');
+    const brain = await createBrain();
+
+    console.log(c.bold('\n━━━ BrainBank Docs Index ━━━\n'));
+
+    const opts: { collections?: string[]; onProgress?: (collection: string, file: string, current: number, total: number) => void } = {};
+    if (collection) opts.collections = [collection];
+    opts.onProgress = (col: string, file: string, cur: number, total: number) => {
+        process.stdout.write(`\r  ${c.cyan(col)} [${cur}/${total}] ${file}                    `);
+    };
+
+    const docsPlugin = findDocsPlugin(brain);
+    if (!docsPlugin) { console.log(c.red('  Docs plugin not loaded. Install @brainbank/docs.')); process.exit(1); }
+
+    const results = await docsPlugin.indexDocs(opts);
+
+    console.log('\n');
+    for (const [name, stat] of Object.entries(results) as [string, { indexed: number; skipped: number; removed: number; chunks: number }][]) {
+        const removedStr = stat.removed > 0 ? `, ${c.red(String(stat.removed) + ' removed')}` : '';
+        console.log(`  ${c.green(name)}: ${stat.indexed} indexed, ${stat.skipped} skipped${removedStr}, ${stat.chunks} chunks`);
+    }
+
+    brain.close();
+}
+
+export async function cmdDocSearch(): Promise<void> {
+    const query = stripFlags(args).slice(1).join(' ');
+    if (!query) {
+        console.log(c.red('Usage: brainbank dsearch <query>'));
+        process.exit(1);
+    }
+
+    const brain = await createBrain();
+    const collection = getFlag('collection');
+    const k = parseInt(getFlag('k') || '8', 10);
+
+    console.log(c.bold(`\n━━━ BrainBank Doc Search: "${query}" ━━━\n`));
+
+    const docsPlugin = findDocsPlugin(brain);
+    if (!docsPlugin) {
+        console.log(c.red('Docs plugin not loaded. Install @brainbank/docs.'));
+        process.exit(1);
+    }
+    const results = await docsPlugin.search(query, { collection: collection ?? undefined, k });
+
+    if (results.length === 0) {
+        console.log(c.yellow('  No results found.'));
+        brain.close();
+        return;
+    }
+
+    for (const r of results) {
+        const score = Math.round(r.score * 100);
+        const ctx = r.context ? ` — ${c.dim(r.context)}` : '';
+        console.log(`${c.magenta(`[DOC ${score}%]`)} ${c.bold(r.filePath!)} [${r.type === 'document' ? r.metadata.collection ?? '' : ''}]${ctx}`);
+        const preview = r.content.split('\n').slice(0, 4).join('\n');
+        console.log(c.dim(preview));
+        console.log('');
+    }
+
+    brain.close();
+}

package/src/cli/commands/files.ts

@@ -0,0 +1,69 @@
+/**
+ * brainbank files <path|glob> [...paths] [--lines]
+ *
+ * Fetch full file contents from the index.
+ * Use after `brainbank context` to view complete files identified by search.
+ */
+
+import { c, args, getFlag } from '@/cli/utils.ts';
+import { createBrain } from '@/cli/factory/index.ts';
+
+export async function cmdFiles(): Promise<void> {
+    // Collect positional args (file patterns) — skip 'files' command itself
+    const patterns: string[] = [];
+    const showLines = args.includes('--lines');
+
+    for (let i = 1; i < args.length; i++) {
+        if (args[i].startsWith('--')) {
+            // Skip --lines and --repo <value>
+            if (args[i] === '--repo') {
+                i++; // skip value
+            }
+            continue;
+        }
+        patterns.push(args[i]);
+    }
+
+    if (patterns.length === 0) {
+        console.log(c.red('Usage: brainbank files <path|glob> [...paths] [--lines]'));
+        console.log(c.dim('  Exact:     brainbank files src/auth/login.ts'));
+        console.log(c.dim('  Directory: brainbank files src/graph/'));
+        console.log(c.dim('  Glob:      brainbank files "src/**/*.service.ts"'));
+        console.log(c.dim('  Fuzzy:     brainbank files plugin.ts'));
+        console.log(c.dim('  Lines:     brainbank files src/plugin.ts --lines'));
+        process.exit(1);
+    }
+
+    const brain = await createBrain();
+    await brain.initialize();
+    const results = brain.resolveFiles(patterns);
+
+    if (results.length === 0) {
+        console.log(c.yellow('No matching files found in the index.'));
+        console.log(c.dim('Run `brainbank index` first to index your codebase.'));
+        brain.close();
+        return;
+    }
+
+    // Format output
+    for (const r of results) {
+        const meta = r.metadata as Record<string, unknown>;
+        const startLine = (meta.startLine as number) ?? 1;
+
+        console.log(c.bold(`\n── ${r.filePath} ──\n`));
+
+        if (showLines) {
+            const codeLines = r.content.split('\n');
+            const pad = String(startLine + codeLines.length - 1).length;
+            for (let i = 0; i < codeLines.length; i++) {
+                const lineNum = c.dim(`${String(startLine + i).padStart(pad)}|`);
+                console.log(`${lineNum} ${codeLines[i]}`);
+            }
+        } else {
+            console.log(r.content);
+        }
+    }
+
+    console.log(c.dim(`\n${results.length} file(s) resolved.`));
+    brain.close();
+}

package/src/cli/commands/help.ts

@@ -0,0 +1,77 @@
+/** brainbank help — Show CLI usage. */
+
+import { c } from '@/cli/utils.ts';
+
+export function showHelp(): void {
+    console.log(c.bold('\n━━━ BrainBank — Semantic Knowledge Bank ━━━\n'));
+    console.log(c.bold('Indexing:'));
+    console.log(`  ${c.cyan('index')} ${c.dim('(i)')} [path]                  Index code + git history`);
+    console.log(`  ${c.cyan('collection add')} <path> --name      Add a document collection`);
+    console.log(`  ${c.cyan('collection list')}                    List collections`);
+    console.log(`  ${c.cyan('collection remove')} <name>           Remove a collection`);
+    console.log(`  ${c.cyan('docs')} [--collection <name>]         Index document collections`);
+    console.log('');
+    console.log(c.bold('Search:'));
+    console.log(`  ${c.cyan('search')} <query>                     Semantic search (vector)`);
+    console.log(`  ${c.cyan('hsearch')} <query>                    Hybrid search (${c.bold('best quality')})`);
+    console.log(`  ${c.cyan('ksearch')} <query>                    Keyword search (BM25, instant)`);
+    console.log(`  ${c.cyan('dsearch')} <query>                    Document search`);
+    console.log(c.dim('    All accept --repo <path> --path <dir> --<source> <n>'));
+    console.log('');
+    console.log(c.bold('Context:'));
+    console.log(`  ${c.cyan('context')} <task>                     Get formatted context for a task`);
+    console.log(`  ${c.cyan('context add')} <col> <path> <desc>    Add context metadata`);
+    console.log(`  ${c.cyan('context list')}                       List all context metadata`);
+    console.log(`  ${c.cyan('files')} <path|glob> [...] [--lines]  View full indexed files directly`);
+    console.log('');
+    console.log(c.bold('KV Store:'));
+    console.log(`  ${c.cyan('kv add')} <coll> <content>            Add item to a collection`);
+    console.log(`  ${c.cyan('kv search')} <coll> <query>           Search a collection`);
+    console.log(`  ${c.cyan('kv list')} [coll]                     List collections or items`);
+    console.log(`  ${c.cyan('kv trim')} <coll> --keep <n>          Keep only N most recent`);
+    console.log(`  ${c.cyan('kv clear')} <coll>                    Clear all items`);
+    console.log('');
+    console.log(c.bold('Utility:'));
+    console.log(`  ${c.cyan('stats')}                              Show index statistics`);
+    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: .)`);
+    console.log(`  ${c.dim('--force')}                 Force re-index all files`);
+    console.log(`  ${c.dim('--depth <n>')}             Git history depth (default: 500)`);
+    console.log(`  ${c.dim('--collection <name>')}     Filter by collection`);
+    console.log(`  ${c.dim('--pattern <glob>')}        Collection glob (default: **/*.md)`);
+    console.log(`  ${c.dim('--context <desc>')}        Context description`);
+    console.log(`  ${c.dim('--<source> <n>')}          Source filter: max results from <source> (0 = skip)`);
+    console.log(`  ${c.dim('--path <dir>')}            Filter context results to files under this path prefix`);
+    console.log(`  ${c.dim('--ignore <globs>')}        Ignore glob patterns for code indexing (comma-separated)`);
+    console.log(`  ${c.dim('--include <globs>')}       Include only these paths for code indexing (comma-separated)`);
+    console.log(`  ${c.dim('--yes / -y')}              Skip interactive prompt (auto-select all available)`);
+    console.log(`  ${c.dim('--setup')}                 Re-run interactive setup (modules, folders, config)`);
+    console.log(`  ${c.dim('--port <n>')}              HTTP daemon port (default: 8181)`);
+    console.log('');
+    console.log(c.bold('Examples:'));
+    console.log(c.dim('  brainbank index .'));
+    console.log(c.dim('  brainbank index . --ignore "sdk/**,vendor/**"'));
+    console.log(c.dim('  brainbank index . --include "src/**,lib/**"'));
+    console.log(c.dim('  brainbank kv add errors "Fixed null pointer in api.ts"'));
+    console.log(c.dim('  brainbank kv search errors "null pointer"'));
+    console.log(c.dim('  brainbank kv list'));
+    console.log(c.dim('  brainbank hsearch "authentication middleware"'));
+    console.log(c.dim('  brainbank hsearch "auth" --code 0 --git 10           # git only'));
+    console.log(c.dim('  brainbank search "handler" --git 0                   # code only'));
+    console.log(c.dim('  brainbank hsearch "api" --docs 10 --code 0 --git 0   # docs only'));
+    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'));
+}