@phuetz/code-buddy 0.3.0 → 1.0.0-rc.8

package/dist/knowledge/process-detector.js

@@ -0,0 +1,305 @@
+/**
+ * Process Detection — GitNexus Knowledge Graph
+ *
+ * Detects execution flows by BFS from entry points in the code graph.
+ * Entry points are functions with no internal callers (or matching
+ * main/handler/route patterns).
+ *
+ * Each process is a named sequence of steps (calls/imports/extends)
+ * starting from an entry point, with a minimum of 3 steps.
+ */
+import { logger } from '../utils/logger.js';
+// ============================================================================
+// Entry Point Detection
+// ============================================================================
+/** Pattern names that suggest entry points */
+const ENTRY_POINT_PATTERNS = [
+    /^main$/i,
+    /^handle/i,
+    /^route/i,
+    /^on[A-Z]/,
+    /^process/i,
+    /^execute/i,
+    /^start/i,
+    /^init/i,
+    /^run/i,
+    /^serve/i,
+    /^listen/i,
+    /^dispatch/i,
+    /^controller/i,
+    /^middleware/i,
+    /^endpoint/i,
+];
+/**
+ * Score a symbol as a potential entry point.
+ * Higher score = more likely to be an entry point.
+ */
+function scoreEntryPoint(symbol, graph) {
+    let score = 0;
+    // Check if the symbol has internal callers (is called by others)
+    const callers = graph.query({ predicate: 'calls', object: symbol });
+    if (callers.length === 0) {
+        score += 8; // No callers → likely an entry point
+    }
+    // Check if the symbol is used by other modules
+    const usedBy = graph.query({ predicate: 'usedBy', object: symbol });
+    if (usedBy.length === 0) {
+        score += 3;
+    }
+    // Extract bare name from prefixed IDs (e.g., "fn:handleLogin" → "handleLogin")
+    const bareName = symbol.includes(':') ? symbol.split(':').pop() : symbol;
+    // Strip path components if present
+    const simpleName = bareName.includes('/') ? bareName.split('/').pop() : bareName;
+    // Pattern matching bonus
+    for (const pattern of ENTRY_POINT_PATTERNS) {
+        if (pattern.test(simpleName)) {
+            score += 5;
+            break;
+        }
+    }
+    // Public/exported symbols get a bonus
+    const exports = graph.query({ predicate: 'exports', object: symbol });
+    const exposes = graph.query({ predicate: 'exposes', object: symbol });
+    if (exports.length > 0 || exposes.length > 0) {
+        score += 10;
+    }
+    // Must have outgoing calls to be a meaningful entry point
+    const callees = graph.query({ subject: symbol, predicate: 'calls' });
+    if (callees.length === 0) {
+        score -= 5; // Leaf nodes are not interesting entry points
+    }
+    return score;
+}
+// ============================================================================
+// Process Name Heuristic
+// ============================================================================
+/**
+ * Generate a human-readable process name from an entry point symbol.
+ * e.g., "handleLogin" → "Login Flow", "processPayment" → "Payment Processing"
+ */
+function nameFromEntryPoint(symbol) {
+    // Extract bare name
+    let name = symbol.includes(':') ? symbol.split(':').pop() : symbol;
+    name = name.includes('/') ? name.split('/').pop() : name;
+    // Remove common prefixes
+    const prefixes = ['handle', 'process', 'execute', 'on', 'do', 'run', 'start', 'init'];
+    let stripped = name;
+    for (const prefix of prefixes) {
+        if (name.toLowerCase().startsWith(prefix) && name.length > prefix.length) {
+            stripped = name.slice(prefix.length);
+            // Ensure first char is uppercase
+            stripped = stripped.charAt(0).toUpperCase() + stripped.slice(1);
+            break;
+        }
+    }
+    // Split camelCase/PascalCase into words
+    const words = stripped.replace(/([a-z])([A-Z])/g, '$1 $2').split(/[\s_-]+/);
+    // Build name
+    const cleanWords = words.filter(w => w.length > 0).map(w => w.charAt(0).toUpperCase() + w.slice(1).toLowerCase());
+    const lastWord = cleanWords[cleanWords.length - 1];
+    if (lastWord === undefined)
+        return `${name} Flow`;
+    // Add suffix based on context
+    const last = lastWord.toLowerCase();
+    if (['flow', 'process', 'processing', 'pipeline', 'workflow', 'handler'].includes(last)) {
+        return cleanWords.join(' ');
+    }
+    return cleanWords.join(' ') + ' Flow';
+}
+// ============================================================================
+// BFS Process Detection
+// ============================================================================
+/**
+ * Extract file path from a symbol's metadata or definedIn relations.
+ */
+function getFilePath(symbol, graph) {
+    // Check definedIn relation
+    const definedIn = graph.query({ subject: symbol, predicate: 'definedIn' });
+    const definedInFirst = definedIn[0];
+    if (definedInFirst !== undefined) {
+        return definedInFirst.object.replace(/^mod:/, '');
+    }
+    // Check belongsTo relation
+    const belongsTo = graph.query({ subject: symbol, predicate: 'belongsTo' });
+    const belongsToFirst = belongsTo[0];
+    if (belongsToFirst !== undefined) {
+        return belongsToFirst.object.replace(/^mod:/, '');
+    }
+    // Try extracting from the symbol name itself (e.g., "fn:src/auth/login")
+    if (symbol.includes('/')) {
+        const parts = symbol.split(':');
+        const path = parts.length > 1 ? parts.slice(1).join(':') : parts[0];
+        return path ?? symbol;
+    }
+    return 'unknown';
+}
+/**
+ * BFS from an entry point through CALLS/imports/extends edges.
+ */
+function bfsFromEntry(entryPoint, graph, maxSteps = 30) {
+    const visited = new Set();
+    const steps = [];
+    const queue = [
+        { symbol: entryPoint, depth: 0 },
+    ];
+    visited.add(entryPoint);
+    while (queue.length > 0 && steps.length < maxSteps) {
+        const { symbol, depth } = queue.shift();
+        const filePath = getFilePath(symbol, graph);
+        steps.push({
+            symbolName: symbol,
+            filePath,
+            stepIndex: steps.length,
+            type: depth === 0 ? 'call' : 'call',
+        });
+        // Follow CALLS edges
+        const callees = graph.query({ subject: symbol, predicate: 'calls' });
+        for (const triple of callees) {
+            if (!visited.has(triple.object)) {
+                visited.add(triple.object);
+                queue.push({ symbol: triple.object, depth: depth + 1 });
+            }
+        }
+        // Follow imports edges (less common but relevant)
+        const imports = graph.query({ subject: symbol, predicate: 'imports' });
+        for (const triple of imports) {
+            if (!visited.has(triple.object)) {
+                visited.add(triple.object);
+                queue.push({ symbol: triple.object, depth: depth + 1 });
+            }
+        }
+        // Follow extends edges
+        const extends_ = graph.query({ subject: symbol, predicate: 'extends' });
+        for (const triple of extends_) {
+            if (!visited.has(triple.object)) {
+                visited.add(triple.object);
+                queue.push({ symbol: triple.object, depth: depth + 1 });
+            }
+        }
+    }
+    // Set correct types based on edge type
+    // Re-walk to fix types
+    const typeMap = new Map();
+    typeMap.set(entryPoint, 'call');
+    for (const step of steps) {
+        const sym = step.symbolName;
+        const calls = graph.query({ predicate: 'calls', object: sym });
+        const imports = graph.query({ predicate: 'imports', object: sym });
+        const extends_ = graph.query({ predicate: 'extends', object: sym });
+        if (calls.length > 0)
+            step.type = 'call';
+        else if (imports.length > 0)
+            step.type = 'import';
+        else if (extends_.length > 0)
+            step.type = 'extend';
+    }
+    return steps;
+}
+/**
+ * Check if process A's steps are a subset of process B's steps.
+ */
+function isSubsetProcess(a, b) {
+    if (a.steps.length >= b.steps.length)
+        return false;
+    const bSymbols = new Set(b.steps.map(s => s.symbolName));
+    return a.steps.every(s => bSymbols.has(s.symbolName));
+}
+// ============================================================================
+// Public API
+// ============================================================================
+const MAX_PROCESSES = 50;
+const MIN_STEPS = 3;
+/**
+ * Detect execution processes in the code graph.
+ *
+ * Finds entry points (functions with no internal callers), performs BFS
+ * from each one, and returns named processes with at least 3 steps.
+ *
+ * @param graph - KnowledgeGraph to analyze
+ * @param options - Optional configuration
+ * @returns Array of detected execution processes
+ */
+export function detectProcesses(graph, options) {
+    const minSteps = options?.minSteps ?? MIN_STEPS;
+    const maxProcesses = options?.maxProcesses ?? MAX_PROCESSES;
+    // If a specific entry point is requested, just BFS from it
+    if (options?.entryPoint) {
+        const resolved = graph.findEntity(options.entryPoint);
+        if (!resolved) {
+            logger.debug(`ProcessDetector: entry point "${options.entryPoint}" not found`);
+            return [];
+        }
+        const steps = bfsFromEntry(resolved, graph);
+        if (steps.length < minSteps)
+            return [];
+        const files = [...new Set(steps.map(s => s.filePath))];
+        return [{
+                name: nameFromEntryPoint(resolved),
+                entryPoint: resolved,
+                steps,
+                files,
+            }];
+    }
+    // Collect all candidate entry points
+    const allSubjects = new Set();
+    for (const t of graph.toJSON()) {
+        // Only consider function-like entities
+        if (t.subject.startsWith('fn:') || t.predicate === 'containsFunction') {
+            if (t.predicate === 'containsFunction') {
+                allSubjects.add(t.object);
+            }
+            else {
+                allSubjects.add(t.subject);
+            }
+        }
+    }
+    // Also check subjects of 'calls' edges
+    for (const t of graph.query({ predicate: 'calls' })) {
+        allSubjects.add(t.subject);
+        allSubjects.add(t.object);
+    }
+    // Score and rank candidates
+    const scored = [];
+    for (const symbol of allSubjects) {
+        const score = scoreEntryPoint(symbol, graph);
+        if (score > 5) {
+            scored.push({ symbol, score });
+        }
+    }
+    scored.sort((a, b) => b.score - a.score);
+    // BFS from top candidates
+    const processes = [];
+    const usedSymbols = new Set();
+    for (const { symbol } of scored) {
+        if (processes.length >= maxProcesses)
+            break;
+        if (usedSymbols.has(symbol))
+            continue;
+        const steps = bfsFromEntry(symbol, graph);
+        if (steps.length < minSteps)
+            continue;
+        const files = [...new Set(steps.map(s => s.filePath))];
+        const process = {
+            name: nameFromEntryPoint(symbol),
+            entryPoint: symbol,
+            steps,
+            files,
+        };
+        // Mark symbols as used
+        for (const step of steps) {
+            usedSymbols.add(step.symbolName);
+        }
+        processes.push(process);
+    }
+    // Deduplicate: remove processes that are subsets of larger ones
+    const deduplicated = [];
+    for (const proc of processes) {
+        const isSubset = processes.some(other => other !== proc && isSubsetProcess(proc, other));
+        if (!isSubset) {
+            deduplicated.push(proc);
+        }
+    }
+    logger.debug(`ProcessDetector: found ${deduplicated.length} processes from ${scored.length} candidates`);
+    return deduplicated.slice(0, maxProcesses);
+}
+//# sourceMappingURL=process-detector.js.map

package/dist/knowledge/process-detector.js.map

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

package/dist/knowledge/scanners/framework-plugins.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Framework Plugins — Declare dynamic entry points per framework/tool
+ *
+ * Inspired by Knip's plugin system: each plugin knows which functions
+ * are invoked dynamically (registries, event emitters, CLI handlers, etc.)
+ * and which file patterns are implicit entry points.
+ *
+ * Used by dead code detection to avoid false positives.
+ */
+export interface FrameworkPlugin {
+    /** Plugin identifier */
+    name: string;
+    /** How to detect this framework (file patterns or package.json deps) */
+    detect: FrameworkDetector;
+    /** Function/method names that are called dynamically (not via static call site) */
+    dynamicEntryMethods: string[];
+    /** Regex patterns for function FQNs that are entry points */
+    entryPatterns?: RegExp[];
+    /** File patterns that are implicit entry points (glob-style) */
+    entryFilePatterns?: RegExp[];
+    /** Module path patterns where all exports are considered used */
+    publicApiModules?: RegExp[];
+}
+export interface FrameworkDetector {
+    /** Check if package.json has any of these deps */
+    packageDeps?: string[];
+    /** Check if any of these files exist */
+    filePatterns?: string[];
+}
+/**
+ * Get all framework plugins.
+ * In the future, this can be extended to load user-defined plugins from config.
+ */
+export declare function getFrameworkPlugins(): FrameworkPlugin[];
+/**
+ * Collect all dynamic entry method names from all plugins.
+ * Returns a set for O(1) lookup.
+ */
+export declare function getAllDynamicEntryMethods(): Set<string>;
+/**
+ * Collect all entry FQN patterns from all plugins.
+ */
+export declare function getAllEntryPatterns(): RegExp[];
+/**
+ * Collect all public API module patterns from all plugins.
+ */
+export declare function getAllPublicApiModulePatterns(): RegExp[];

package/dist/knowledge/scanners/framework-plugins.js

@@ -0,0 +1,164 @@
+/**
+ * Framework Plugins — Declare dynamic entry points per framework/tool
+ *
+ * Inspired by Knip's plugin system: each plugin knows which functions
+ * are invoked dynamically (registries, event emitters, CLI handlers, etc.)
+ * and which file patterns are implicit entry points.
+ *
+ * Used by dead code detection to avoid false positives.
+ */
+// ============================================================================
+// Built-in Plugins
+// ============================================================================
+const vitestPlugin = {
+    name: 'vitest',
+    detect: { packageDeps: ['vitest'] },
+    dynamicEntryMethods: ['describe', 'it', 'test', 'expect', 'beforeEach', 'afterEach', 'beforeAll', 'afterAll'],
+    entryFilePatterns: [/\.test\.[tj]sx?$/, /\.spec\.[tj]sx?$/, /vitest\.config/],
+};
+const expressPlugin = {
+    name: 'express',
+    detect: { packageDeps: ['express', 'fastify', 'koa', 'hono'] },
+    dynamicEntryMethods: ['get', 'post', 'put', 'delete', 'patch', 'use', 'all', 'listen', 'route'],
+    entryPatterns: [/^fn:create\w*Server$/, /^fn:create\w*Router$/, /^fn:setup\w*Routes$/],
+    publicApiModules: [/\/routes\//, /\/middleware\//],
+};
+const reactPlugin = {
+    name: 'react',
+    detect: { packageDeps: ['react', 'preact', 'solid-js'] },
+    dynamicEntryMethods: [
+        'render', 'createElement', 'useState', 'useEffect', 'useCallback',
+        'useMemo', 'useRef', 'useContext', 'useReducer', 'useLayoutEffect',
+        'forwardRef', 'memo', 'lazy', 'Suspense',
+    ],
+    entryFilePatterns: [/\.tsx$/],
+    entryPatterns: [/^fn:[A-Z]\w+$/, /^cls:[A-Z]\w+$/], // PascalCase components
+};
+const commanderPlugin = {
+    name: 'commander',
+    detect: { packageDeps: ['commander', 'yargs', 'cac', 'meow', 'citty'] },
+    dynamicEntryMethods: ['command', 'option', 'action', 'parseAsync', 'parse'],
+    entryPatterns: [/^fn:register\w*Command/, /^fn:setup\w*CLI/],
+    publicApiModules: [/\/commands\//, /\/cli\//],
+};
+const eventEmitterPlugin = {
+    name: 'events',
+    detect: { packageDeps: ['events', 'eventemitter3'] },
+    dynamicEntryMethods: [
+        'on', 'once', 'emit', 'addListener', 'removeListener',
+        'addEventListener', 'removeEventListener', 'off',
+        'handleMessage', 'handleEvent', 'onMessage', 'onError', 'onClose',
+    ],
+    publicApiModules: [/\/channels\//, /\/handlers\//],
+};
+const playwrightPlugin = {
+    name: 'playwright',
+    detect: { packageDeps: ['playwright', 'playwright-core', 'puppeteer'] },
+    dynamicEntryMethods: ['goto', 'click', 'fill', 'type', 'press', 'waitForSelector', 'evaluate'],
+    entryFilePatterns: [/\.e2e\.[tj]sx?$/, /playwright\.config/],
+};
+const inkPlugin = {
+    name: 'ink',
+    detect: { packageDeps: ['ink', 'ink-testing-library'] },
+    dynamicEntryMethods: ['render', 'useApp', 'useInput', 'useStdin', 'useStdout'],
+    entryFilePatterns: [/\.tsx$/],
+};
+const toolRegistryPlugin = {
+    name: 'tool-registry',
+    detect: { filePatterns: ['src/tools/registry/'] },
+    dynamicEntryMethods: [
+        'execute', 'validate', 'getSchema', 'getMetadata', 'isAvailable',
+        'run', 'init', 'dispose', 'cleanup',
+    ],
+    entryPatterns: [/^fn:create\w+Tools?$/, /^fn:register\w+/],
+    publicApiModules: [/\/tools\/registry\//, /\/tools\/[^/]+$/],
+};
+const middlewarePlugin = {
+    name: 'middleware',
+    detect: { filePatterns: ['src/agent/middleware/'] },
+    dynamicEntryMethods: ['beforeTurn', 'afterTurn', 'beforeResponse', 'afterResponse'],
+    publicApiModules: [/\/middleware\//],
+};
+const channelPlugin = {
+    name: 'channels',
+    detect: { filePatterns: ['src/channels/'] },
+    dynamicEntryMethods: [
+        'start', 'stop', 'handleMessage', 'sendMessage', 'connect', 'disconnect',
+        'onMessage', 'onReady', 'onError',
+    ],
+    entryPatterns: [/^fn:create\w+Adapter$/, /^cls:\w+Adapter$/],
+    publicApiModules: [/\/channels\/[^/]+$/],
+};
+const agentPlugin = {
+    name: 'agents',
+    detect: { filePatterns: ['src/agent/specialized/'] },
+    dynamicEntryMethods: ['execute', 'run', 'think', 'act', 'plan', 'delegate'],
+    entryPatterns: [/^fn:get\w+Agent$/, /^cls:\w+Agent$/],
+    publicApiModules: [/\/agent\/specialized\//, /\/agent\/flow\//],
+};
+const scannerPlugin = {
+    name: 'scanners',
+    detect: { filePatterns: ['src/knowledge/scanners/'] },
+    dynamicEntryMethods: ['scanFile', 'initialize', 'isReady'],
+    publicApiModules: [/\/scanners\//],
+};
+// ============================================================================
+// Plugin Registry
+// ============================================================================
+const BUILTIN_PLUGINS = [
+    vitestPlugin,
+    expressPlugin,
+    reactPlugin,
+    commanderPlugin,
+    eventEmitterPlugin,
+    playwrightPlugin,
+    inkPlugin,
+    toolRegistryPlugin,
+    middlewarePlugin,
+    channelPlugin,
+    agentPlugin,
+    scannerPlugin,
+];
+/**
+ * Get all framework plugins.
+ * In the future, this can be extended to load user-defined plugins from config.
+ */
+export function getFrameworkPlugins() {
+    return BUILTIN_PLUGINS;
+}
+/**
+ * Collect all dynamic entry method names from all plugins.
+ * Returns a set for O(1) lookup.
+ */
+export function getAllDynamicEntryMethods() {
+    const methods = new Set();
+    for (const plugin of BUILTIN_PLUGINS) {
+        for (const method of plugin.dynamicEntryMethods) {
+            methods.add(method);
+        }
+    }
+    return methods;
+}
+/**
+ * Collect all entry FQN patterns from all plugins.
+ */
+export function getAllEntryPatterns() {
+    const patterns = [];
+    for (const plugin of BUILTIN_PLUGINS) {
+        if (plugin.entryPatterns)
+            patterns.push(...plugin.entryPatterns);
+    }
+    return patterns;
+}
+/**
+ * Collect all public API module patterns from all plugins.
+ */
+export function getAllPublicApiModulePatterns() {
+    const patterns = [];
+    for (const plugin of BUILTIN_PLUGINS) {
+        if (plugin.publicApiModules)
+            patterns.push(...plugin.publicApiModules);
+    }
+    return patterns;
+}
+//# sourceMappingURL=framework-plugins.js.map

package/dist/knowledge/scanners/framework-plugins.js.map

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

package/dist/knowledge/scanners/go.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Go Scanner — brace-based scoping, struct embedding, method receivers
+ */
+import type { LanguageScanner, ScanResult } from './types.js';
+export declare class GoScanner implements LanguageScanner {
+    readonly extensions: string[];
+    readonly language = "Go";
+    scanFile(content: string, moduleId: string): ScanResult;
+}