brainbank 0.1.3 → 0.1.4

package/src/cli/commands/context.ts

@@ -0,0 +1,59 @@
+/**
+ * brainbank context — DEPRECATED, use `brainbank query` instead.
+ *
+ * Kept as fallback. Subcommands (add/list) remain here since they are
+ * context-metadata specific, not query-related.
+ */
+
+import { c, args, stripFlags, findDocsPlugin } from '@/cli/utils.ts';
+import { createBrain } from '@/cli/factory/index.ts';
+import { cmdQuery } from './query.ts';
+
+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> → delegate to query (deprecated)
+    console.error(c.yellow('⚠ `brainbank context` is deprecated — use `brainbank query` instead.\n'));
+    return cmdQuery();
+}

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,82 @@
+/** 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('Query:'));
+    console.log(`  ${c.cyan('query')} ${c.dim('(q)')} <task>                  Get AI-pruned context for a task`);
+    console.log(`  ${c.cyan('context')} <task>                     ${c.dim('(deprecated → use query)')}`);
+    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('reindex')} [path]                     Nuke data + re-index from scratch`);
+    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>')}        General task context for pruner (inline or @file)`);
+    console.log(`  ${c.dim('--pruner <desc>')}         Specific pruning focus (inline or @file)`);
+    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 query "auth flow" | pbcopy              # → clipboard'));
+    console.log(c.dim('  brainbank query "auth" --context @issue.md        # with task context'));
+    console.log(c.dim('  brainbank query "auth" --pruner "JWT refresh"     # focused pruning'));
+    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'));
+}