@milo4jo/contextkit 0.5.0 → 0.5.6

package/dist/commands/symbol.js

@@ -0,0 +1,420 @@
+/**
+ * Symbol Search Command
+ *
+ * Find code by symbol name (exact/fuzzy match).
+ * Faster than semantic search when you know the name.
+ */
+import { Command } from 'commander';
+import { ensureInitialized } from '../config/index.js';
+import { openDatabase } from '../db/index.js';
+import { writeData, writeMessage } from '../utils/streams.js';
+import { formatDim } from '../utils/format.js';
+import { getGlobalOpts } from '../utils/cli.js';
+/** Extract symbols from chunk content */
+function extractSymbols(content, filePath) {
+    const symbols = [];
+    const lines = content.split('\n');
+    const ext = filePath.split('.').pop()?.toLowerCase();
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const trimmed = line.trim();
+        const lineNum = i + 1;
+        // TypeScript/JavaScript patterns
+        if (ext === 'ts' || ext === 'tsx' || ext === 'js' || ext === 'jsx') {
+            // Function declaration
+            const funcMatch = trimmed.match(/^(export\s+)?(async\s+)?function\s+(\w+)/);
+            if (funcMatch) {
+                symbols.push({
+                    filePath,
+                    symbolName: funcMatch[3],
+                    symbolType: 'function',
+                    startLine: lineNum,
+                    endLine: findBlockEnd(lines, i),
+                    signature: extractSignatureLine(trimmed),
+                    content: '',
+                });
+                continue;
+            }
+            // Class declaration
+            const classMatch = trimmed.match(/^(export\s+)?(abstract\s+)?class\s+(\w+)/);
+            if (classMatch) {
+                symbols.push({
+                    filePath,
+                    symbolName: classMatch[3],
+                    symbolType: 'class',
+                    startLine: lineNum,
+                    endLine: findBlockEnd(lines, i),
+                    signature: extractSignatureLine(trimmed),
+                    content: '',
+                });
+                continue;
+            }
+            // Interface declaration
+            const interfaceMatch = trimmed.match(/^(export\s+)?interface\s+(\w+)/);
+            if (interfaceMatch) {
+                symbols.push({
+                    filePath,
+                    symbolName: interfaceMatch[2],
+                    symbolType: 'interface',
+                    startLine: lineNum,
+                    endLine: findBlockEnd(lines, i),
+                    signature: extractSignatureLine(trimmed),
+                    content: '',
+                });
+                continue;
+            }
+            // Type alias
+            const typeMatch = trimmed.match(/^(export\s+)?type\s+(\w+)/);
+            if (typeMatch) {
+                symbols.push({
+                    filePath,
+                    symbolName: typeMatch[2],
+                    symbolType: 'type',
+                    startLine: lineNum,
+                    endLine: findTypeEnd(lines, i),
+                    signature: trimmed,
+                    content: '',
+                });
+                continue;
+            }
+            // Const/let/var with arrow function or value
+            const constMatch = trimmed.match(/^(export\s+)?(const|let|var)\s+(\w+)/);
+            if (constMatch) {
+                const isFunction = trimmed.includes('=>') || trimmed.includes('function');
+                symbols.push({
+                    filePath,
+                    symbolName: constMatch[3],
+                    symbolType: isFunction ? 'function' : 'constant',
+                    startLine: lineNum,
+                    endLine: findStatementEnd(lines, i),
+                    signature: extractSignatureLine(trimmed),
+                    content: '',
+                });
+                continue;
+            }
+        }
+        // Python patterns
+        if (ext === 'py') {
+            // Function/method definition
+            const pyFuncMatch = trimmed.match(/^(async\s+)?def\s+(\w+)/);
+            if (pyFuncMatch) {
+                symbols.push({
+                    filePath,
+                    symbolName: pyFuncMatch[2],
+                    symbolType: 'function',
+                    startLine: lineNum,
+                    endLine: findPythonBlockEnd(lines, i),
+                    signature: trimmed.replace(/:$/, ''),
+                    content: '',
+                });
+                continue;
+            }
+            // Class definition
+            const pyClassMatch = trimmed.match(/^class\s+(\w+)/);
+            if (pyClassMatch) {
+                symbols.push({
+                    filePath,
+                    symbolName: pyClassMatch[1],
+                    symbolType: 'class',
+                    startLine: lineNum,
+                    endLine: findPythonBlockEnd(lines, i),
+                    signature: trimmed.replace(/:$/, ''),
+                    content: '',
+                });
+                continue;
+            }
+        }
+        // Go patterns
+        if (ext === 'go') {
+            // Function declaration
+            const goFuncMatch = trimmed.match(/^func\s+(\w+)/);
+            if (goFuncMatch) {
+                symbols.push({
+                    filePath,
+                    symbolName: goFuncMatch[1],
+                    symbolType: 'function',
+                    startLine: lineNum,
+                    endLine: findBlockEnd(lines, i),
+                    signature: trimmed.replace(/\s*\{$/, ''),
+                    content: '',
+                });
+                continue;
+            }
+            // Method declaration (func (r Receiver) Name)
+            const goMethodMatch = trimmed.match(/^func\s+\([^)]+\)\s+(\w+)/);
+            if (goMethodMatch) {
+                symbols.push({
+                    filePath,
+                    symbolName: goMethodMatch[1],
+                    symbolType: 'method',
+                    startLine: lineNum,
+                    endLine: findBlockEnd(lines, i),
+                    signature: trimmed.replace(/\s*\{$/, ''),
+                    content: '',
+                });
+                continue;
+            }
+            // Type declaration
+            const goTypeMatch = trimmed.match(/^type\s+(\w+)/);
+            if (goTypeMatch) {
+                symbols.push({
+                    filePath,
+                    symbolName: goTypeMatch[1],
+                    symbolType: 'type',
+                    startLine: lineNum,
+                    endLine: findBlockEnd(lines, i),
+                    signature: trimmed.replace(/\s*\{$/, ''),
+                    content: '',
+                });
+                continue;
+            }
+        }
+        // Rust patterns
+        if (ext === 'rs') {
+            // Function
+            const rustFuncMatch = trimmed.match(/^(pub\s+)?(async\s+)?fn\s+(\w+)/);
+            if (rustFuncMatch) {
+                symbols.push({
+                    filePath,
+                    symbolName: rustFuncMatch[3],
+                    symbolType: 'function',
+                    startLine: lineNum,
+                    endLine: findBlockEnd(lines, i),
+                    signature: trimmed.replace(/\s*\{$/, ''),
+                    content: '',
+                });
+                continue;
+            }
+            // Struct/Enum
+            const rustStructMatch = trimmed.match(/^(pub\s+)?(struct|enum)\s+(\w+)/);
+            if (rustStructMatch) {
+                symbols.push({
+                    filePath,
+                    symbolName: rustStructMatch[3],
+                    symbolType: 'class',
+                    startLine: lineNum,
+                    endLine: findBlockEnd(lines, i),
+                    signature: trimmed.replace(/\s*\{$/, ''),
+                    content: '',
+                });
+                continue;
+            }
+            // Trait
+            const rustTraitMatch = trimmed.match(/^(pub\s+)?trait\s+(\w+)/);
+            if (rustTraitMatch) {
+                symbols.push({
+                    filePath,
+                    symbolName: rustTraitMatch[2],
+                    symbolType: 'interface',
+                    startLine: lineNum,
+                    endLine: findBlockEnd(lines, i),
+                    signature: trimmed.replace(/\s*\{$/, ''),
+                    content: '',
+                });
+                continue;
+            }
+        }
+    }
+    return symbols;
+}
+/** Find end of a brace-delimited block */
+function findBlockEnd(lines, startIdx) {
+    let braceCount = 0;
+    let started = false;
+    for (let i = startIdx; i < lines.length; i++) {
+        const line = lines[i];
+        for (const char of line) {
+            if (char === '{') {
+                braceCount++;
+                started = true;
+            }
+            else if (char === '}') {
+                braceCount--;
+                if (started && braceCount === 0) {
+                    return i + 1;
+                }
+            }
+        }
+    }
+    return lines.length;
+}
+/** Find end of a Python indented block */
+function findPythonBlockEnd(lines, startIdx) {
+    const startLine = lines[startIdx];
+    const startIndent = startLine.length - startLine.trimStart().length;
+    for (let i = startIdx + 1; i < lines.length; i++) {
+        const line = lines[i];
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue; // Skip empty lines
+        const indent = line.length - line.trimStart().length;
+        if (indent <= startIndent) {
+            return i;
+        }
+    }
+    return lines.length;
+}
+/** Find end of a type declaration */
+function findTypeEnd(lines, startIdx) {
+    // Types can span multiple lines until semicolon
+    for (let i = startIdx; i < lines.length; i++) {
+        if (lines[i].includes(';')) {
+            return i + 1;
+        }
+    }
+    return startIdx + 1;
+}
+/** Find end of a const/let/var statement */
+function findStatementEnd(lines, startIdx) {
+    // Check if it's a simple one-liner
+    const startLine = lines[startIdx];
+    if (startLine.trim().endsWith(';')) {
+        return startIdx + 1;
+    }
+    // Check for arrow function or object literal
+    if (startLine.includes('=>') || startLine.includes('{')) {
+        return findBlockEnd(lines, startIdx);
+    }
+    // Multi-line statement ending with semicolon
+    for (let i = startIdx; i < Math.min(startIdx + 20, lines.length); i++) {
+        if (lines[i].trim().endsWith(';')) {
+            return i + 1;
+        }
+    }
+    return startIdx + 1;
+}
+/** Extract signature from a line (remove body) */
+function extractSignatureLine(line) {
+    const braceIdx = line.indexOf('{');
+    if (braceIdx > 0) {
+        return line.substring(0, braceIdx).trim();
+    }
+    return line.trim();
+}
+/** Search for symbols by name */
+function searchSymbols(db, query, options) {
+    const { exact = false, limit = 20, sources } = options;
+    // Build SQL query
+    let sql = 'SELECT DISTINCT file_path, content FROM chunks';
+    const params = [];
+    if (sources && sources.length > 0) {
+        sql += ' WHERE source_id IN (' + sources.map(() => '?').join(',') + ')';
+        params.push(...sources);
+    }
+    const rows = db.prepare(sql).all(...params);
+    // Extract and filter symbols
+    const allSymbols = [];
+    const queryLower = query.toLowerCase();
+    for (const row of rows) {
+        const symbols = extractSymbols(row.content, row.file_path);
+        for (const sym of symbols) {
+            const nameLower = sym.symbolName.toLowerCase();
+            if (exact) {
+                if (nameLower === queryLower) {
+                    allSymbols.push(sym);
+                }
+            }
+            else {
+                // Fuzzy match: name must contain the query as a substring
+                // Skip very short names (< 3 chars) unless exact match
+                const isExactMatch = nameLower === queryLower;
+                const containsQuery = nameLower.includes(queryLower);
+                const isSignificantName = sym.symbolName.length >= 3;
+                if (isExactMatch || (containsQuery && isSignificantName)) {
+                    allSymbols.push(sym);
+                }
+            }
+        }
+    }
+    // Sort by relevance (exact matches first, then by name length)
+    allSymbols.sort((a, b) => {
+        const aExact = a.symbolName.toLowerCase() === queryLower;
+        const bExact = b.symbolName.toLowerCase() === queryLower;
+        if (aExact && !bExact)
+            return -1;
+        if (!aExact && bExact)
+            return 1;
+        return a.symbolName.length - b.symbolName.length;
+    });
+    return allSymbols.slice(0, limit);
+}
+/** Format symbol output */
+function formatSymbolOutput(symbols, json) {
+    if (json) {
+        return JSON.stringify(symbols, null, 2);
+    }
+    if (symbols.length === 0) {
+        return '';
+    }
+    const lines = [];
+    // Group by file
+    const byFile = new Map();
+    for (const sym of symbols) {
+        const existing = byFile.get(sym.filePath) || [];
+        existing.push(sym);
+        byFile.set(sym.filePath, existing);
+    }
+    for (const [filePath, fileSymbols] of byFile) {
+        lines.push(`📄 ${filePath}`);
+        for (const sym of fileSymbols) {
+            const typeIcon = getTypeIcon(sym.symbolType);
+            lines.push(`│ ${typeIcon} ${sym.symbolName} (line ${sym.startLine})`);
+            lines.push(`│   ${sym.signature}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+/** Get icon for symbol type */
+function getTypeIcon(type) {
+    switch (type) {
+        case 'function': return '𝑓';
+        case 'class': return '◆';
+        case 'method': return '◇';
+        case 'interface': return '◈';
+        case 'type': return '⊤';
+        case 'constant': return '●';
+        case 'variable': return '○';
+        default: return '•';
+    }
+}
+export const symbolCommand = new Command('symbol')
+    .description('Search for symbols by name')
+    .argument('<name>', 'Symbol name to search for')
+    .option('-e, --exact', 'Exact match only')
+    .option('-l, --limit <n>', 'Maximum results', '20')
+    .option('-s, --sources <sources>', 'Filter sources (comma-separated)')
+    .action(async (name, options) => {
+    ensureInitialized();
+    const opts = getGlobalOpts(symbolCommand);
+    const limit = parseInt(options.limit, 10) || 20;
+    const sources = options.sources
+        ? options.sources.split(',').map((s) => s.trim())
+        : undefined;
+    const db = openDatabase();
+    try {
+        const symbols = searchSymbols(db, name, {
+            exact: options.exact,
+            limit,
+            sources,
+        });
+        if (symbols.length === 0) {
+            writeMessage('');
+            writeMessage(formatDim(`No symbols found matching "${name}"`));
+            writeMessage(formatDim('Try a different name or remove --exact flag.'));
+            writeMessage('');
+            return;
+        }
+        const output = formatSymbolOutput(symbols, opts.json ?? false);
+        writeData(output);
+        // Summary
+        if (!opts.json) {
+            writeMessage('');
+            writeMessage(formatDim(`Found ${symbols.length} symbol(s)`));
+        }
+    }
+    finally {
+        db.close();
+    }
+});
+//# sourceMappingURL=symbol.js.map

package/dist/commands/symbol.js.map

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

package/dist/db/index.d.ts

@@ -11,4 +11,52 @@ export declare function openDatabase(): Database.Database;
  * Close the database connection
  */
 export declare function closeDatabase(db: Database.Database): void;
+/** Cache entry structure */
+export interface CacheEntry {
+    cacheKey: string;
+    result: string;
+    indexVersion: string;
+    createdAt: string;
+    hitCount: number;
+}
+/** Parameters that affect cache key */
+export interface CacheKeyParams {
+    query: string;
+    budget: number;
+    sources?: string[];
+    format: string;
+    mode?: string;
+    includeImports?: boolean;
+}
+/**
+ * Compute index version hash based on chunk count and last indexed time
+ * This invalidates cache when the index changes
+ */
+export declare function computeIndexVersion(db: Database.Database): string;
+/**
+ * Generate cache key from query parameters
+ */
+export declare function generateCacheKey(params: CacheKeyParams): string;
+/**
+ * Get cached result if valid
+ * Returns null if not found or index has changed
+ */
+export declare function getCachedResult(db: Database.Database, cacheKey: string, currentIndexVersion: string): string | null;
+/**
+ * Store result in cache
+ */
+export declare function setCachedResult(db: Database.Database, cacheKey: string, result: string, indexVersion: string): void;
+/**
+ * Clear all cache entries
+ */
+export declare function clearCache(db: Database.Database): number;
+/**
+ * Get cache statistics
+ */
+export declare function getCacheStats(db: Database.Database): {
+    entryCount: number;
+    totalHits: number;
+    oldestEntry: string | null;
+    newestEntry: string | null;
+};
 //# sourceMappingURL=index.d.ts.map

package/dist/db/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/db/index.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AA+CtC;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAU9D;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,QAAQ,CAAC,QAAQ,CAKhD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAEzD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/db/index.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AA0DtC;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAU9D;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,QAAQ,CAAC,QAAQ,CAKhD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,IAAI,CAEzD;AAMD,4BAA4B;AAC5B,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,uCAAuC;AACvC,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,MAAM,CAcjE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAY/D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,QAAQ,EAAE,MAAM,EAChB,mBAAmB,EAAE,MAAM,GAC1B,MAAM,GAAG,IAAI,CAyBf;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,GACnB,IAAI,CAKN;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,MAAM,CAGxD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,CAgBA"}

package/dist/db/index.js

@@ -1,4 +1,5 @@
 import Database from 'better-sqlite3';
+import { createHash } from 'crypto';
 import { getDbPath } from '../config/index.js';
 /**
  * Database schema for ContextKit
@@ -37,11 +38,21 @@ CREATE TABLE IF NOT EXISTS chunks (
   created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
 );
 
+-- Query cache table
+CREATE TABLE IF NOT EXISTS query_cache (
+  cache_key TEXT PRIMARY KEY,
+  result JSON NOT NULL,
+  index_version TEXT NOT NULL,
+  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
+  hit_count INTEGER DEFAULT 0
+);
+
 -- Indexes for performance
 CREATE INDEX IF NOT EXISTS idx_chunks_source ON chunks(source_id);
 CREATE INDEX IF NOT EXISTS idx_chunks_file ON chunks(file_path);
 CREATE INDEX IF NOT EXISTS idx_files_source ON files(source_id);
 CREATE INDEX IF NOT EXISTS idx_files_path ON files(source_id, file_path);
+CREATE INDEX IF NOT EXISTS idx_cache_created ON query_cache(created_at);
 `;
 /**
  * Initialize the database with schema
@@ -69,4 +80,92 @@ export function openDatabase() {
 export function closeDatabase(db) {
     db.close();
 }
+/**
+ * Compute index version hash based on chunk count and last indexed time
+ * This invalidates cache when the index changes
+ */
+export function computeIndexVersion(db) {
+    const stats = db.prepare(`
+    SELECT 
+      COUNT(*) as chunkCount,
+      MAX(created_at) as lastIndexed
+    FROM chunks
+  `).get();
+    const sourceStats = db.prepare(`
+    SELECT COUNT(*) as sourceCount FROM sources
+  `).get();
+    const versionData = `${stats.chunkCount}:${sourceStats.sourceCount}:${stats.lastIndexed || ''}`;
+    return createHash('sha256').update(versionData).digest('hex').slice(0, 16);
+}
+/**
+ * Generate cache key from query parameters
+ */
+export function generateCacheKey(params) {
+    const normalized = {
+        query: params.query,
+        budget: params.budget,
+        sources: params.sources?.slice().sort() || [],
+        format: params.format,
+        mode: params.mode || 'full',
+        includeImports: params.includeImports || false,
+    };
+    const keyData = JSON.stringify(normalized);
+    return createHash('sha256').update(keyData).digest('hex');
+}
+/**
+ * Get cached result if valid
+ * Returns null if not found or index has changed
+ */
+export function getCachedResult(db, cacheKey, currentIndexVersion) {
+    const row = db.prepare(`
+    SELECT result, index_version, hit_count
+    FROM query_cache
+    WHERE cache_key = ?
+  `).get(cacheKey);
+    if (!row) {
+        return null;
+    }
+    // Invalidate if index has changed
+    if (row.index_version !== currentIndexVersion) {
+        db.prepare('DELETE FROM query_cache WHERE cache_key = ?').run(cacheKey);
+        return null;
+    }
+    // Update hit count
+    db.prepare(`
+    UPDATE query_cache 
+    SET hit_count = hit_count + 1 
+    WHERE cache_key = ?
+  `).run(cacheKey);
+    return row.result;
+}
+/**
+ * Store result in cache
+ */
+export function setCachedResult(db, cacheKey, result, indexVersion) {
+    db.prepare(`
+    INSERT OR REPLACE INTO query_cache (cache_key, result, index_version, created_at, hit_count)
+    VALUES (?, ?, ?, datetime('now'), 0)
+  `).run(cacheKey, result, indexVersion);
+}
+/**
+ * Clear all cache entries
+ */
+export function clearCache(db) {
+    const result = db.prepare('DELETE FROM query_cache').run();
+    return result.changes;
+}
+/**
+ * Get cache statistics
+ */
+export function getCacheStats(db) {
+    const stats = db.prepare(`
+    SELECT 
+      COUNT(*) as entryCount,
+      COALESCE(SUM(hit_count), 0) as totalHits,
+      MIN(created_at) as oldestEntry,
+      MAX(created_at) as newestEntry
+    FROM query_cache
+  `).get();
+    return stats;
+}
 //# sourceMappingURL=index.js.map

package/dist/db/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/db/index.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C;;GAEG;AACH,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuCd,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IAEhC,sBAAsB;IACtB,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAE/B,gBAAgB;IAChB,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEhB,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IAChC,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAC/B,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,EAAqB;IACjD,EAAE,CAAC,KAAK,EAAE,CAAC;AACb,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/db/index.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAE/C;;GAEG;AACH,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiDd,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IAEhC,sBAAsB;IACtB,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAE/B,gBAAgB;IAChB,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEhB,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IAChC,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAC/B,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,EAAqB;IACjD,EAAE,CAAC,KAAK,EAAE,CAAC;AACb,CAAC;AAyBD;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,EAAqB;IACvD,MAAM,KAAK,GAAG,EAAE,CAAC,OAAO,CAAC;;;;;GAKxB,CAAC,CAAC,GAAG,EAAwD,CAAC;IAE/D,MAAM,WAAW,GAAG,EAAE,CAAC,OAAO,CAAC;;GAE9B,CAAC,CAAC,GAAG,EAA6B,CAAC;IAEpC,MAAM,WAAW,GAAG,GAAG,KAAK,CAAC,UAAU,IAAI,WAAW,CAAC,WAAW,IAAI,KAAK,CAAC,WAAW,IAAI,EAAE,EAAE,CAAC;IAChG,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC7E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAsB;IACrD,MAAM,UAAU,GAAG;QACjB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE;QAC7C,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,MAAM;QAC3B,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,KAAK;KAC/C,CAAC;IAEF,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IAC3C,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC5D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,EAAqB,EACrB,QAAgB,EAChB,mBAA2B;IAE3B,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC;;;;GAItB,CAAC,CAAC,GAAG,CAAC,QAAQ,CAA6E,CAAC;IAE7F,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,IAAI,CAAC;IACd,CAAC;IAED,kCAAkC;IAClC,IAAI,GAAG,CAAC,aAAa,KAAK,mBAAmB,EAAE,CAAC;QAC9C,EAAE,CAAC,OAAO,CAAC,6CAA6C,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACxE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,mBAAmB;IACnB,EAAE,CAAC,OAAO,CAAC;;;;GAIV,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAEjB,OAAO,GAAG,CAAC,MAAM,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,EAAqB,EACrB,QAAgB,EAChB,MAAc,EACd,YAAoB;IAEpB,EAAE,CAAC,OAAO,CAAC;;;GAGV,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,EAAqB;IAC9C,MAAM,MAAM,GAAG,EAAE,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAC,GAAG,EAAE,CAAC;IAC3D,OAAO,MAAM,CAAC,OAAO,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,EAAqB;IAMjD,MAAM,KAAK,GAAG,EAAE,CAAC,OAAO,CAAC;;;;;;;GAOxB,CAAC,CAAC,GAAG,EAKL,CAAC;IAEF,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/index.js

@@ -7,8 +7,12 @@ import { initCommand } from './commands/init.js';
 import { sourceCommand } from './commands/source/index.js';
 import { indexCommand } from './commands/index-cmd.js';
 import { selectCommand } from './commands/select.js';
+import { symbolCommand } from './commands/symbol.js';
+import { graphCommand } from './commands/graph.js';
+import { cacheCommand } from './commands/cache.js';
 import { mcpCommand } from './commands/mcp.js';
 import { watchCommand } from './commands/watch.js';
+import { doctorCommand } from './commands/doctor.js';
 import { ContextKitError, InvalidUsageError } from './errors/index.js';
 import { writeError, writeMessage } from './utils/streams.js';
 // Get version from package.json
@@ -62,8 +66,12 @@ program.addCommand(initCommand);
 program.addCommand(sourceCommand);
 program.addCommand(indexCommand);
 program.addCommand(selectCommand);
+program.addCommand(symbolCommand);
+program.addCommand(graphCommand);
+program.addCommand(cacheCommand);
 program.addCommand(mcpCommand);
 program.addCommand(watchCommand);
+program.addCommand(doctorCommand);
 // Default action when no command given
 program.action(() => {
     console.log(`
@@ -80,8 +88,12 @@ Commands:
   source        Manage source directories
   index         Index all sources (incremental by default)
   select        Select context for a query
+  symbol        Search for symbols by name
+  graph         Show call graph for a function
+  cache         Manage query cache
   watch         Watch sources and auto-reindex on changes
   mcp           Start MCP server for AI assistants
+  doctor        Diagnose setup issues
 
 Global Options:
   --json        Output as JSON