@milo4jo/contextkit 0.5.1 → 0.5.6

package/README.md

@@ -7,7 +7,7 @@
 [![npm downloads](https://img.shields.io/npm/dw/@milo4jo/contextkit)](https://www.npmjs.com/package/@milo4jo/contextkit)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-**🆕 v0.5:** Import-aware scoring — files that import your selected code get boosted automatically!
+**🆕 v0.5.5:** Symbol search & call graph! Find code by name, trace dependencies across your codebase.
 
 ---
 
@@ -185,10 +185,57 @@ contextkit select "query" --format plain     # Plain text, no formatting
 # Include imported files (follows dependency graph)
 contextkit select "query" --include-imports
 
+# Repo map mode (signatures only, saves tokens)
+contextkit select "query" --mode map
+
 # Pipe to clipboard (macOS)
 contextkit select "query" --format plain | pbcopy
 ```
 
+### `contextkit symbol`
+
+Search for code by symbol name (faster than semantic search when you know the name).
+
+```bash
+# Find a function or class by name
+contextkit symbol "UserService"
+
+# Exact match only
+contextkit symbol "handleAuth" --exact
+
+# Limit results
+contextkit symbol "parse" --limit 10
+```
+
+**Output:**
+```
+📄 src/services/user.ts
+│ ◆ UserService (line 12)
+│   export class UserService
+```
+
+### `contextkit graph`
+
+Show call relationships for a function.
+
+```bash
+contextkit graph "handlePayment"
+```
+
+**Output:**
+```
+🎯 Call graph for: handlePayment
+
+📥 Callers (2):
+   ← processOrder (src/orders/service.ts:45)
+   ← checkout (src/cart/checkout.ts:89)
+
+📤 Calls (3):
+   → validateCard (src/payments/validation.ts)
+   → chargeCard (src/payments/stripe.ts)
+   → sendReceipt (src/notifications/email.ts)
+```
+
 ---
 
 ## 🤖 MCP Server (Claude Desktop Integration)
@@ -294,6 +341,17 @@ settings:
 
 ---
 
+## 📚 Documentation
+
+- **[Getting Started Guide](./docs/getting-started.md)** — Detailed walkthrough
+- **[MCP Setup Guide](./docs/mcp-setup.md)** — Claude Desktop integration
+- **[Examples](./examples/README.md)** — Real-world use cases
+  - [Bug Investigation](./examples/bug-investigation.md)
+  - [Scripting & Automation](./examples/scripting.md)
+- **[Architecture](./docs/ARCHITECTURE.md)** — How ContextKit works
+
+---
+
 ## Technical Details
 
 ### How Selection Works

package/dist/commands/doctor.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const doctorCommand: Command;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmSpC,eAAO,MAAM,aAAa,SAGN,CAAC"}

package/dist/commands/doctor.js

@@ -0,0 +1,254 @@
+import { Command } from 'commander';
+import { existsSync, statSync } from 'fs';
+import { join } from 'path';
+import chalk from 'chalk';
+import { loadConfig, getDbPath } from '../config/index.js';
+import { openDatabase } from '../db/index.js';
+import { writeMessage } from '../utils/streams.js';
+const CHECK_OK = chalk.green('✓');
+const CHECK_WARN = chalk.yellow('⚠');
+const CHECK_ERROR = chalk.red('✗');
+function formatResult(result) {
+    const icon = result.status === 'ok' ? CHECK_OK : result.status === 'warn' ? CHECK_WARN : CHECK_ERROR;
+    let output = `${icon} ${result.name}: ${result.message}`;
+    if (result.detail) {
+        output += chalk.dim(`\n    ${result.detail}`);
+    }
+    return output;
+}
+async function checkNodeVersion() {
+    const version = process.version;
+    const major = parseInt(version.slice(1).split('.')[0], 10);
+    if (major >= 18) {
+        return {
+            name: 'Node.js version',
+            status: 'ok',
+            message: version,
+        };
+    }
+    return {
+        name: 'Node.js version',
+        status: 'error',
+        message: `${version} (requires >= 18)`,
+        detail: 'Upgrade Node.js: https://nodejs.org/',
+    };
+}
+async function checkConfig() {
+    try {
+        const config = await loadConfig();
+        const sourceCount = config.sources?.length || 0;
+        if (sourceCount === 0) {
+            return {
+                name: 'Configuration',
+                status: 'warn',
+                message: 'No sources configured',
+                detail: 'Run: contextkit source add ./src',
+            };
+        }
+        return {
+            name: 'Configuration',
+            status: 'ok',
+            message: `${sourceCount} source(s) configured`,
+        };
+    }
+    catch {
+        return {
+            name: 'Configuration',
+            status: 'error',
+            message: 'Not initialized',
+            detail: 'Run: contextkit init',
+        };
+    }
+}
+async function checkDatabase() {
+    try {
+        const dbPath = getDbPath();
+        if (!existsSync(dbPath)) {
+            return {
+                name: 'Index database',
+                status: 'warn',
+                message: 'Not indexed yet',
+                detail: 'Run: contextkit index',
+            };
+        }
+        const stats = statSync(dbPath);
+        const sizeMB = (stats.size / 1024 / 1024).toFixed(2);
+        const db = openDatabase();
+        const chunks = db.prepare('SELECT COUNT(*) as count FROM chunks').get();
+        const files = db.prepare('SELECT COUNT(*) as count FROM files').get();
+        db.close();
+        return {
+            name: 'Index database',
+            status: 'ok',
+            message: `${chunks.count} chunks, ${files.count} files (${sizeMB} MB)`,
+        };
+    }
+    catch (error) {
+        return {
+            name: 'Index database',
+            status: 'error',
+            message: 'Database error',
+            detail: error instanceof Error ? error.message : 'Unknown error',
+        };
+    }
+}
+async function checkEmbeddings() {
+    try {
+        const dbPath = getDbPath();
+        if (!existsSync(dbPath)) {
+            return {
+                name: 'Embeddings',
+                status: 'warn',
+                message: 'No index yet',
+            };
+        }
+        const db = openDatabase();
+        const result = db.prepare('SELECT COUNT(*) as count FROM chunks WHERE embedding IS NOT NULL').get();
+        const total = db.prepare('SELECT COUNT(*) as count FROM chunks').get();
+        db.close();
+        if (result.count === 0) {
+            return {
+                name: 'Embeddings',
+                status: 'warn',
+                message: 'No embeddings generated',
+                detail: 'Run: contextkit index --full',
+            };
+        }
+        const coverage = ((result.count / total.count) * 100).toFixed(0);
+        return {
+            name: 'Embeddings',
+            status: 'ok',
+            message: `${result.count}/${total.count} chunks (${coverage}%)`,
+        };
+    }
+    catch (error) {
+        return {
+            name: 'Embeddings',
+            status: 'error',
+            message: 'Error checking embeddings',
+            detail: error instanceof Error ? error.message : 'Unknown error',
+        };
+    }
+}
+async function checkDiskSpace() {
+    try {
+        const dbPath = getDbPath();
+        const dir = join(dbPath, '..');
+        if (!existsSync(dir)) {
+            return {
+                name: 'Disk space',
+                status: 'ok',
+                message: 'Not yet initialized',
+            };
+        }
+        // Simple check - just report db size
+        if (existsSync(dbPath)) {
+            const stats = statSync(dbPath);
+            const sizeMB = stats.size / 1024 / 1024;
+            if (sizeMB > 500) {
+                return {
+                    name: 'Disk space',
+                    status: 'warn',
+                    message: `Database is ${sizeMB.toFixed(0)} MB`,
+                    detail: 'Consider: contextkit cache clear',
+                };
+            }
+        }
+        return {
+            name: 'Disk space',
+            status: 'ok',
+            message: 'OK',
+        };
+    }
+    catch {
+        return {
+            name: 'Disk space',
+            status: 'ok',
+            message: 'Could not check',
+        };
+    }
+}
+async function checkQueryCache() {
+    try {
+        const dbPath = getDbPath();
+        if (!existsSync(dbPath)) {
+            return {
+                name: 'Query cache',
+                status: 'ok',
+                message: 'No cache yet',
+            };
+        }
+        const db = openDatabase();
+        // Check if query_cache table exists
+        const tableExists = db
+            .prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='query_cache'")
+            .get();
+        if (!tableExists) {
+            db.close();
+            return {
+                name: 'Query cache',
+                status: 'ok',
+                message: 'Not enabled',
+            };
+        }
+        const result = db.prepare('SELECT COUNT(*) as count FROM query_cache').get();
+        db.close();
+        return {
+            name: 'Query cache',
+            status: 'ok',
+            message: `${result.count} cached queries`,
+        };
+    }
+    catch {
+        return {
+            name: 'Query cache',
+            status: 'ok',
+            message: 'Could not check',
+        };
+    }
+}
+async function runDoctor(options) {
+    const checks = [];
+    writeMessage(chalk.bold('\n🩺 ContextKit Doctor\n'));
+    writeMessage('Running diagnostics...\n');
+    // Run all checks
+    checks.push(await checkNodeVersion());
+    checks.push(await checkConfig());
+    checks.push(await checkDatabase());
+    checks.push(await checkEmbeddings());
+    checks.push(await checkQueryCache());
+    checks.push(await checkDiskSpace());
+    if (options.json) {
+        console.log(JSON.stringify(checks, null, 2));
+        return;
+    }
+    // Output results
+    for (const result of checks) {
+        writeMessage(formatResult(result));
+    }
+    // Summary
+    const errors = checks.filter((c) => c.status === 'error').length;
+    const warnings = checks.filter((c) => c.status === 'warn').length;
+    writeMessage('');
+    if (errors > 0) {
+        writeMessage(chalk.red(`\n${errors} error(s) found. Fix these issues to use ContextKit.`));
+        process.exit(1);
+    }
+    else if (warnings > 0) {
+        writeMessage(chalk.yellow(`\n${warnings} warning(s). ContextKit will work but may be limited.`));
+    }
+    else {
+        writeMessage(chalk.green('\n✓ All checks passed! ContextKit is ready to use.'));
+    }
+    // Quick tips
+    writeMessage(chalk.dim('\nQuick commands:'));
+    writeMessage(chalk.dim('  contextkit init           # Initialize project'));
+    writeMessage(chalk.dim('  contextkit source add .   # Add sources'));
+    writeMessage(chalk.dim('  contextkit index          # Build index'));
+    writeMessage(chalk.dim('  contextkit select "query" # Find context\n'));
+}
+export const doctorCommand = new Command('doctor')
+    .description('Diagnose ContextKit setup and configuration')
+    .option('--json', 'Output as JSON')
+    .action(runDoctor);
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/graph.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Call Graph Command
+ *
+ * Analyze function call relationships:
+ * - What functions call a given function (callers)
+ * - What functions a given function calls (callees)
+ */
+import { Command } from 'commander';
+export declare const graphCommand: Command;
+//# sourceMappingURL=graph.d.ts.map

package/dist/commands/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../src/commands/graph.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsUpC,eAAO,MAAM,YAAY,SA4BrB,CAAC"}

package/dist/commands/graph.js

@@ -0,0 +1,289 @@
+/**
+ * Call Graph Command
+ *
+ * Analyze function call relationships:
+ * - What functions call a given function (callers)
+ * - What functions a given function calls (callees)
+ */
+import { Command } from 'commander';
+import { ensureInitialized } from '../config/index.js';
+import { openDatabase } from '../db/index.js';
+import { writeData, writeMessage, writeWarning } from '../utils/streams.js';
+import { formatDim } from '../utils/format.js';
+import { getGlobalOpts } from '../utils/cli.js';
+/** Extract function definitions from content */
+function extractFunctionDefs(content, filePath) {
+    const functions = new Map();
+    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();
+        // TypeScript/JavaScript
+        if (ext === 'ts' || ext === 'tsx' || ext === 'js' || ext === 'jsx') {
+            // function name()
+            const funcMatch = trimmed.match(/^(export\s+)?(async\s+)?function\s+(\w+)/);
+            if (funcMatch) {
+                const name = funcMatch[3];
+                const endLine = findBlockEnd(lines, i);
+                functions.set(name, { startLine: i + 1, endLine });
+                continue;
+            }
+            // const name = () =>
+            const arrowMatch = trimmed.match(/^(export\s+)?(const|let|var)\s+(\w+)\s*=\s*(async\s+)?\(/);
+            if (arrowMatch) {
+                const name = arrowMatch[3];
+                const endLine = findBlockEnd(lines, i);
+                functions.set(name, { startLine: i + 1, endLine });
+                continue;
+            }
+            // Method in class: name() or async name()
+            const methodMatch = trimmed.match(/^(public|private|protected|static|async)?\s*(async\s+)?(\w+)\s*\([^)]*\)\s*[:{]/);
+            if (methodMatch && !['if', 'while', 'for', 'switch', 'catch'].includes(methodMatch[3])) {
+                const name = methodMatch[3];
+                const endLine = findBlockEnd(lines, i);
+                functions.set(name, { startLine: i + 1, endLine });
+                continue;
+            }
+        }
+        // Python
+        if (ext === 'py') {
+            const defMatch = trimmed.match(/^(async\s+)?def\s+(\w+)/);
+            if (defMatch) {
+                const name = defMatch[2];
+                const endLine = findPythonBlockEnd(lines, i);
+                functions.set(name, { startLine: i + 1, endLine });
+                continue;
+            }
+        }
+        // Go
+        if (ext === 'go') {
+            const funcMatch = trimmed.match(/^func\s+(?:\([^)]+\)\s+)?(\w+)/);
+            if (funcMatch) {
+                const name = funcMatch[1];
+                const endLine = findBlockEnd(lines, i);
+                functions.set(name, { startLine: i + 1, endLine });
+                continue;
+            }
+        }
+        // Rust
+        if (ext === 'rs') {
+            const fnMatch = trimmed.match(/^(pub\s+)?(async\s+)?fn\s+(\w+)/);
+            if (fnMatch) {
+                const name = fnMatch[3];
+                const endLine = findBlockEnd(lines, i);
+                functions.set(name, { startLine: i + 1, endLine });
+                continue;
+            }
+        }
+    }
+    return functions;
+}
+/** Find function calls in a range of lines */
+function findFunctionCalls(content, startLine, endLine, knownFunctions) {
+    const calls = [];
+    const lines = content.split('\n');
+    // Simple regex to find function calls: name(
+    const callPattern = /\b(\w+)\s*\(/g;
+    for (let i = startLine - 1; i < Math.min(endLine, lines.length); i++) {
+        const line = lines[i];
+        const trimmed = line.trim();
+        // Skip comments
+        if (trimmed.startsWith('//') || trimmed.startsWith('#') || trimmed.startsWith('*')) {
+            continue;
+        }
+        let match;
+        while ((match = callPattern.exec(line)) !== null) {
+            const name = match[1];
+            // Skip keywords and common non-function patterns
+            const keywords = ['if', 'else', 'while', 'for', 'switch', 'catch', 'return', 'throw', 'new', 'typeof', 'import', 'export', 'const', 'let', 'var', 'function', 'class', 'interface', 'type', 'async', 'await', 'try', 'finally'];
+            if (keywords.includes(name))
+                continue;
+            // Only include if it's a known function or looks like a function call
+            if (knownFunctions.has(name) || name[0] === name[0].toLowerCase()) {
+                calls.push({
+                    name,
+                    line: i + 1,
+                    context: trimmed.substring(0, 80),
+                });
+            }
+        }
+    }
+    return calls;
+}
+/** Find block end (brace-delimited) */
+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 Python block end (indentation-based) */
+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;
+        const indent = line.length - line.trimStart().length;
+        if (indent <= startIndent) {
+            return i;
+        }
+    }
+    return lines.length;
+}
+/** Build call graph for a target function */
+function buildCallGraph(db, targetName, options) {
+    const { sources } = options;
+    // Get all chunks
+    let sql = 'SELECT 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);
+    // Build function index (file -> functions)
+    const functionsByFile = new Map();
+    const allFunctions = new Set();
+    for (const row of rows) {
+        const funcs = extractFunctionDefs(row.content, row.file_path);
+        if (funcs.size > 0) {
+            functionsByFile.set(row.file_path, funcs);
+            for (const name of funcs.keys()) {
+                allFunctions.add(name);
+            }
+        }
+    }
+    // Find callers (who calls targetName)
+    const callers = [];
+    for (const row of rows) {
+        const fileFuncs = functionsByFile.get(row.file_path);
+        if (!fileFuncs)
+            continue;
+        for (const [funcName, { startLine, endLine }] of fileFuncs) {
+            const calls = findFunctionCalls(row.content, startLine, endLine, allFunctions);
+            for (const call of calls) {
+                if (call.name === targetName && funcName !== targetName) {
+                    callers.push({
+                        file: row.file_path,
+                        function: funcName,
+                        line: call.line,
+                        context: call.context,
+                    });
+                }
+            }
+        }
+    }
+    // Find callees (what targetName calls)
+    const callees = [];
+    for (const row of rows) {
+        const fileFuncs = functionsByFile.get(row.file_path);
+        if (!fileFuncs)
+            continue;
+        const targetFunc = fileFuncs.get(targetName);
+        if (!targetFunc)
+            continue;
+        const calls = findFunctionCalls(row.content, targetFunc.startLine, targetFunc.endLine, allFunctions);
+        for (const call of calls) {
+            if (call.name !== targetName) {
+                // Find where this function is defined
+                let definedIn = '';
+                for (const [file, funcs] of functionsByFile) {
+                    if (funcs.has(call.name)) {
+                        definedIn = file;
+                        break;
+                    }
+                }
+                callees.push({
+                    file: definedIn || '(external)',
+                    function: call.name,
+                    line: call.line,
+                    context: call.context,
+                });
+            }
+        }
+    }
+    // Deduplicate
+    const uniqueCallers = Array.from(new Map(callers.map(c => [`${c.file}:${c.function}`, c])).values());
+    const uniqueCallees = Array.from(new Map(callees.map(c => [`${c.file}:${c.function}`, c])).values());
+    return {
+        target: targetName,
+        callers: uniqueCallers,
+        callees: uniqueCallees,
+    };
+}
+/** Format call graph output */
+function formatCallGraph(result, json) {
+    if (json) {
+        return JSON.stringify(result, null, 2);
+    }
+    const lines = [];
+    lines.push(`🎯 Call graph for: ${result.target}`);
+    lines.push('');
+    // Callers
+    lines.push(`📥 Callers (${result.callers.length}):`);
+    if (result.callers.length === 0) {
+        lines.push('   (none found)');
+    }
+    else {
+        for (const caller of result.callers) {
+            lines.push(`   ← ${caller.function} (${caller.file}:${caller.line})`);
+        }
+    }
+    lines.push('');
+    // Callees
+    lines.push(`📤 Calls (${result.callees.length}):`);
+    if (result.callees.length === 0) {
+        lines.push('   (none found)');
+    }
+    else {
+        for (const callee of result.callees) {
+            const location = callee.file === '(external)' ? '(external)' : `${callee.file}`;
+            lines.push(`   → ${callee.function} (${location})`);
+        }
+    }
+    return lines.join('\n');
+}
+export const graphCommand = new Command('graph')
+    .description('Show call graph for a function')
+    .argument('<function>', 'Function name to analyze')
+    .option('-s, --sources <sources>', 'Filter sources (comma-separated)')
+    .action(async (functionName, options) => {
+    ensureInitialized();
+    const opts = getGlobalOpts(graphCommand);
+    const sources = options.sources
+        ? options.sources.split(',').map((s) => s.trim())
+        : undefined;
+    const db = openDatabase();
+    try {
+        const result = buildCallGraph(db, functionName, { sources });
+        if (result.callers.length === 0 && result.callees.length === 0) {
+            writeWarning(`No call relationships found for "${functionName}"`);
+            writeMessage(formatDim('Make sure the function exists and the codebase is indexed.'));
+            return;
+        }
+        const output = formatCallGraph(result, opts.json ?? false);
+        writeData(output);
+    }
+    finally {
+        db.close();
+    }
+});
+//# sourceMappingURL=graph.js.map