sdlc-agent-4-enterprise-server 1.0.0

package/dist/engine/graph/traverser.js

@@ -0,0 +1,171 @@
+/**
+ * KSA-157: Graph Traverser - generic BFS/DFS engine with edge/node type filtering.
+ * Provides the core traversal logic for the code_traverse MCP tool.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+export class GraphTraverser {
+    db;
+    resolver;
+    workspace;
+    constructor(db, resolver, workspace) {
+        this.db = db;
+        this.resolver = resolver;
+        this.workspace = workspace;
+    }
+    /** Resolve a symbol identifier to a graph node. */
+    resolveNode(identifier) {
+        const resolved = this.resolver.resolve(identifier);
+        if (resolved.length === 0)
+            return null;
+        if (resolved.length > 1) {
+            // Return first match but could throw AmbiguousError
+            return {
+                id: resolved[0].id,
+                name: resolved[0].name,
+                kind: resolved[0].kind,
+                filePath: resolved[0].filePath,
+                startLine: resolved[0].line,
+            };
+        }
+        return {
+            id: resolved[0].id,
+            name: resolved[0].name,
+            kind: resolved[0].kind,
+            filePath: resolved[0].filePath,
+            startLine: resolved[0].line,
+        };
+    }
+    /** BFS traversal from a start node with edge/node type filters. */
+    traverse(startNode, config) {
+        const visited = new Set();
+        const queue = [
+            { node: startNode, depth: 0, path: [startNode.name] },
+        ];
+        const results = [];
+        while (queue.length > 0 && results.length < config.maxResults) {
+            const { node, depth, path: currentPath } = queue.shift();
+            if (visited.has(node.id))
+                continue;
+            visited.add(node.id);
+            // Add to results (skip start node)
+            if (depth > 0) {
+                if (config.nodeTypes.length === 0 || config.nodeTypes.includes(node.kind)) {
+                    results.push({
+                        node,
+                        depth,
+                        path: currentPath,
+                        edgeType: node._incomingEdgeType || 'unknown',
+                    });
+                }
+            }
+            // Expand neighbors if within depth limit
+            if (depth < config.maxDepth) {
+                const neighbors = this.getNeighbors(node.id, config);
+                for (const neighbor of neighbors) {
+                    if (!visited.has(neighbor.id)) {
+                        queue.push({
+                            node: neighbor,
+                            depth: depth + 1,
+                            path: [...currentPath, neighbor.name],
+                        });
+                    }
+                }
+            }
+        }
+        return results.sort((a, b) => a.depth - b.depth);
+    }
+    /** Format traversal results into the MCP response format. */
+    formatResponse(startNode, results, includeSource, sourceLines, executionTimeMs) {
+        const formattedResults = results.map(r => {
+            const formatted = {
+                name: r.node.name,
+                kind: r.node.kind,
+                file: r.node.filePath,
+                line: r.node.startLine,
+                depth: r.depth,
+                edge_type: r.edgeType,
+            };
+            if (includeSource) {
+                formatted.source = this.getSourceSnippet(r.node.filePath, r.node.startLine, sourceLines);
+            }
+            return formatted;
+        });
+        return {
+            start: { name: startNode.name, kind: startNode.kind, file: startNode.filePath, line: startNode.startLine },
+            results: formattedResults,
+            metadata: {
+                total_traversed: results.length,
+                total_results: formattedResults.length,
+                max_depth_reached: Math.max(...results.map(r => r.depth), 0),
+                truncated: results.length >= 50,
+                execution_time_ms: executionTimeMs,
+            },
+        };
+    }
+    getNeighbors(nodeId, config) {
+        const edgeFilter = config.edgeTypes.length > 0
+            ? `AND r.kind IN (${config.edgeTypes.map(e => `'${e}'`).join(',')})`
+            : '';
+        let rows = [];
+        switch (config.direction) {
+            case 'outgoing':
+                rows = this.db.prepare(`
+          SELECT s.id, s.name, s.kind, f.relative_path as filePath, s.start_line as startLine, r.kind as _incomingEdgeType
+          FROM relationships r
+          JOIN symbols s ON s.id = r.target_symbol_id
+          JOIN files f ON s.file_id = f.id
+          WHERE r.source_symbol_id = ? ${edgeFilter}
+          LIMIT 100
+        `).all(nodeId);
+                break;
+            case 'incoming':
+                rows = this.db.prepare(`
+          SELECT s.id, s.name, s.kind, f.relative_path as filePath, s.start_line as startLine, r.kind as _incomingEdgeType
+          FROM relationships r
+          JOIN symbols s ON s.id = r.source_symbol_id
+          JOIN files f ON s.file_id = f.id
+          WHERE r.target_symbol_id = ? ${edgeFilter}
+          LIMIT 100
+        `).all(nodeId);
+                break;
+            case 'both': {
+                const outgoing = this.db.prepare(`
+          SELECT s.id, s.name, s.kind, f.relative_path as filePath, s.start_line as startLine, r.kind as _incomingEdgeType
+          FROM relationships r
+          JOIN symbols s ON s.id = r.target_symbol_id
+          JOIN files f ON s.file_id = f.id
+          WHERE r.source_symbol_id = ? ${edgeFilter}
+          LIMIT 50
+        `).all(nodeId);
+                const incoming = this.db.prepare(`
+          SELECT s.id, s.name, s.kind, f.relative_path as filePath, s.start_line as startLine, r.kind as _incomingEdgeType
+          FROM relationships r
+          JOIN symbols s ON s.id = r.source_symbol_id
+          JOIN files f ON s.file_id = f.id
+          WHERE r.target_symbol_id = ? ${edgeFilter}
+          LIMIT 50
+        `).all(nodeId);
+                rows = [...outgoing, ...incoming];
+                break;
+            }
+        }
+        return rows;
+    }
+    getSourceSnippet(filePath, startLine, contextLines) {
+        try {
+            const fullPath = path.resolve(this.workspace, filePath);
+            if (!fs.existsSync(fullPath))
+                return null;
+            const content = fs.readFileSync(fullPath, 'utf-8');
+            const lines = content.split('\n');
+            const start = Math.max(0, startLine - 1);
+            const end = Math.min(lines.length, start + contextLines);
+            return lines.slice(start, end).join('\n');
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=traverser.js.map

package/dist/engine/graph/traverser.js.map

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

package/dist/engine/indexer/__tests__/tree-sitter-pipeline.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * KSA-145: Integration test — Verify tree-sitter is wired into IndexingEngine.
+ * Tests that IndexingEngine uses TreeSitterIndexer for supported languages
+ * and falls back to regex for unsupported ones.
+ */
+export {};

package/dist/engine/indexer/__tests__/tree-sitter-pipeline.test.js

@@ -0,0 +1,167 @@
+/**
+ * KSA-145: Integration test — Verify tree-sitter is wired into IndexingEngine.
+ * Tests that IndexingEngine uses TreeSitterIndexer for supported languages
+ * and falls back to regex for unsupported ones.
+ */
+import { describe, it, before, after } from 'node:test';
+import assert from 'node:assert/strict';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { DatabaseManager } from '../../db/database-manager.js';
+import { IndexingEngine } from '../indexing-engine.js';
+describe('KSA-145: Tree-sitter Pipeline Integration', () => {
+    let tmpDir;
+    let dbPath;
+    let db;
+    let dbManager;
+    let config;
+    before(() => {
+        // Create temp workspace with test files
+        tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'ksa145-test-'));
+        const srcDir = path.join(tmpDir, 'src', 'example');
+        fs.mkdirSync(srcDir, { recursive: true });
+        // Write a TypeScript file
+        fs.writeFileSync(path.join(srcDir, 'service.ts'), [
+            'export class UserService {',
+            '  private db: Database;',
+            '',
+            '  constructor(db: Database) {',
+            '    this.db = db;',
+            '  }',
+            '',
+            '  async getUser(id: string): Promise<User> {',
+            '    return this.db.findById(id);',
+            '  }',
+            '',
+            '  async createUser(data: CreateUserDto): Promise<User> {',
+            '    const user = new User(data);',
+            '    return this.db.save(user);',
+            '  }',
+            '}',
+            '',
+            'export interface User {',
+            '  id: string;',
+            '  name: string;',
+            '  email: string;',
+            '}',
+            '',
+            'export function validateEmail(email: string): boolean {',
+            '  return email.includes("@");',
+            '}',
+        ].join('\n'));
+        // Write a Python file
+        fs.writeFileSync(path.join(srcDir, 'utils.py'), [
+            'class DataProcessor:',
+            '    def __init__(self, config):',
+            '        self.config = config',
+            '',
+            '    def process(self, data):',
+            '        return self._transform(data)',
+            '',
+            'def helper_function(x, y):',
+            '    return x + y',
+        ].join('\n'));
+        // Setup database
+        dbPath = path.join(tmpDir, '.code-intel', 'index.db');
+        fs.mkdirSync(path.dirname(dbPath), { recursive: true });
+        dbManager = new DatabaseManager(dbPath);
+        dbManager.initialize();
+        db = dbManager.getDb();
+        config = {
+            workspace: tmpDir,
+            viewerPort: 0,
+            dbPath,
+            configPath: path.join(tmpDir, '.code-intel', 'config.json'),
+            watchEnabled: false,
+            watchDebounceMs: 500,
+            ollamaUrl: null,
+            ollamaModel: 'nomic-embed-text',
+            excludePatterns: ['node_modules', '.git', '.code-intel'],
+            includeExtensions: ['.ts', '.tsx', '.js', '.py', '.kt', '.java', '.go', '.rs'],
+            maxFileSize: 512_000,
+        };
+    });
+    after(() => {
+        if (db)
+            db.close();
+        if (tmpDir)
+            fs.rmSync(tmpDir, { recursive: true, force: true });
+    });
+    it('should initialize IndexingEngine with tree-sitter support', () => {
+        const engine = new IndexingEngine(dbManager, config);
+        const stats = engine.getTreeSitterStats();
+        console.error(`[test] Tree-sitter ready: ${stats.ready}, languages: ${stats.languages.join(', ')}`);
+        assert.ok(typeof stats.ready === 'boolean');
+        assert.ok(Array.isArray(stats.languages));
+        engine.stop();
+    });
+    it('should run full index without errors', async () => {
+        const engine = new IndexingEngine(dbManager, config);
+        await engine.runFullIndex();
+        const fileCount = db.prepare('SELECT COUNT(*) as c FROM files').get();
+        assert.ok(fileCount.c >= 2, `Expected at least 2 files, got ${fileCount.c}`);
+        const symbolCount = db.prepare('SELECT COUNT(*) as c FROM symbols').get();
+        assert.ok(symbolCount.c > 0, `Expected symbols, got ${symbolCount.c}`);
+        console.error(`[test] Indexed ${fileCount.c} files, ${symbolCount.c} symbols`);
+        engine.stop();
+    });
+    it('should extract class and function symbols', async () => {
+        const engine = new IndexingEngine(dbManager, config);
+        await engine.runFullIndex();
+        const userService = db.prepare("SELECT * FROM symbols WHERE name = 'UserService'").get();
+        assert.ok(userService, 'UserService class should be indexed');
+        assert.equal(userService.kind, 'class');
+        const validateEmail = db.prepare("SELECT * FROM symbols WHERE name = 'validateEmail'").get();
+        assert.ok(validateEmail, 'validateEmail function should be indexed');
+        assert.equal(validateEmail.kind, 'function');
+        engine.stop();
+    });
+    it('should populate relationships table when tree-sitter is active', async () => {
+        const engine = new IndexingEngine(dbManager, config);
+        const stats = engine.getTreeSitterStats();
+        await engine.runFullIndex();
+        if (stats.ready) {
+            const relCount = db.prepare('SELECT COUNT(*) as c FROM relationships').get();
+            console.error(`[test] Relationships: ${relCount.c}`);
+            assert.ok(relCount.c >= 0, 'Relationships table should exist');
+        }
+        else {
+            console.error('[test] Tree-sitter not available — skipping relationship check');
+        }
+        engine.stop();
+    });
+    it('should handle incremental file updates', async () => {
+        const engine = new IndexingEngine(dbManager, config);
+        await engine.runFullIndex();
+        const initialCount = db.prepare('SELECT COUNT(*) as c FROM symbols').get().c;
+        const newFile = path.join(tmpDir, 'src', 'example', 'new-module.ts');
+        fs.writeFileSync(newFile, [
+            'export function newFunction(): void {',
+            '  console.log("hello");',
+            '}',
+            '',
+            'export class NewClass {',
+            '  method(): string { return "test"; }',
+            '}',
+        ].join('\n'));
+        await engine.indexSingleFile(newFile);
+        const afterCount = db.prepare('SELECT COUNT(*) as c FROM symbols').get().c;
+        assert.ok(afterCount > initialCount, `Expected more symbols: ${afterCount} > ${initialCount}`);
+        engine.stop();
+    });
+    it('should clean up relationships when file is removed', async () => {
+        const engine = new IndexingEngine(dbManager, config);
+        await engine.runFullIndex();
+        const testFile = path.join(tmpDir, 'src', 'example', 'to-remove.ts');
+        fs.writeFileSync(testFile, 'export function toRemove(): void {}');
+        await engine.indexSingleFile(testFile);
+        const before = db.prepare("SELECT COUNT(*) as c FROM files WHERE relative_path LIKE '%to-remove%'").get();
+        assert.equal(before.c, 1);
+        engine.removeFile('src/example/to-remove.ts');
+        const afterFiles = db.prepare("SELECT COUNT(*) as c FROM files WHERE relative_path LIKE '%to-remove%'").get();
+        assert.equal(afterFiles.c, 0);
+        engine.stop();
+    });
+});
+//# sourceMappingURL=tree-sitter-pipeline.test.js.map

package/dist/engine/indexer/__tests__/tree-sitter-pipeline.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-sitter-pipeline.test.js","sourceRoot":"","sources":["../../../../src/engine/indexer/__tests__/tree-sitter-pipeline.test.ts"],"names":[],"mappings":"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"}

package/dist/engine/indexer/file-watcher.d.ts

@@ -0,0 +1,22 @@
+/**
+ * File Watcher — chokidar-based file system watcher with debounce.
+ * Gracefully degrades if chokidar is not installed.
+ */
+import { AppConfig } from '../config.js';
+type WatchEvent = 'add' | 'change' | 'unlink';
+type WatchCallback = (filePath: string, event: WatchEvent) => void;
+export declare class FileWatcher {
+    private config;
+    private callback;
+    private watcher;
+    private debounceTimers;
+    constructor(config: AppConfig, callback: WatchCallback);
+    /** Start watching the workspace for file changes. */
+    start(): void;
+    /** Stop the file watcher. */
+    stop(): void;
+    private initChokidar;
+    private handleEvent;
+    private debounce;
+}
+export {};

package/dist/engine/indexer/file-watcher.js

@@ -0,0 +1,63 @@
+/**
+ * File Watcher — chokidar-based file system watcher with debounce.
+ * Gracefully degrades if chokidar is not installed.
+ */
+import { detectLanguage } from '../scanner/file-scanner.js';
+export class FileWatcher {
+    config;
+    callback;
+    watcher = null;
+    debounceTimers = new Map();
+    constructor(config, callback) {
+        this.config = config;
+        this.callback = callback;
+    }
+    /** Start watching the workspace for file changes. */
+    start() {
+        this.initChokidar().catch(err => {
+            console.error('[watcher] chokidar not available, file watching disabled:', err.message);
+        });
+    }
+    /** Stop the file watcher. */
+    stop() {
+        if (this.watcher) {
+            this.watcher.close();
+            this.watcher = null;
+        }
+        for (const timer of this.debounceTimers.values()) {
+            clearTimeout(timer);
+        }
+        this.debounceTimers.clear();
+        console.error('[watcher] Stopped');
+    }
+    async initChokidar() {
+        const chokidar = await import('chokidar');
+        const ignored = this.config.excludePatterns.map(p => `**/${p}/**`);
+        this.watcher = chokidar.watch(this.config.workspace, {
+            ignored: [...ignored, /(^|[\/\\])\./],
+            persistent: true,
+            ignoreInitial: true,
+            awaitWriteFinish: { stabilityThreshold: 200, pollInterval: 50 },
+        });
+        this.watcher.on('add', (p) => this.handleEvent(p, 'add'));
+        this.watcher.on('change', (p) => this.handleEvent(p, 'change'));
+        this.watcher.on('unlink', (p) => this.handleEvent(p, 'unlink'));
+        console.error('[watcher] Watching for file changes');
+    }
+    handleEvent(filePath, event) {
+        if (event !== 'unlink' && !detectLanguage(filePath))
+            return;
+        this.debounce(filePath, () => this.callback(filePath, event));
+    }
+    debounce(key, fn) {
+        const existing = this.debounceTimers.get(key);
+        if (existing)
+            clearTimeout(existing);
+        const timer = setTimeout(() => {
+            this.debounceTimers.delete(key);
+            fn();
+        }, this.config.watchDebounceMs);
+        this.debounceTimers.set(key, timer);
+    }
+}
+//# sourceMappingURL=file-watcher.js.map

package/dist/engine/indexer/file-watcher.js.map

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

package/dist/engine/indexer/indexing-engine.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Indexing Engine — Full scan and incremental indexing.
+ * Coordinates file scanning, symbol extraction, and database updates.
+ * KSA-145: Uses TreeSitterIndexer for AST-based parsing with regex fallback.
+ */
+import { DatabaseManager } from '../db/database-manager.js';
+import { AppConfig } from '../config.js';
+export declare class IndexingEngine {
+    private db;
+    private config;
+    private watcher;
+    private running;
+    private indexing;
+    private treeSitterIndexer;
+    private grammarRegistry;
+    private graphRepo;
+    private treeSitterReady;
+    constructor(dbManager: DatabaseManager, config: AppConfig);
+    /** Initialize tree-sitter infrastructure (grammar registry + indexer). */
+    private initTreeSitter;
+    /** Start background indexing: full scan then watch. */
+    startBackgroundIndexing(): Promise<void>;
+    /** Run a full workspace index. */
+    runFullIndex(): Promise<void>;
+    /** KSA-191: Get SFDX project stats from database. */
+    getSfdxStats(): {
+        detected: boolean;
+        projectRoot: string | null;
+        packageDirectories: string[];
+        stats: {
+            apex_classes: number;
+            apex_triggers: number;
+            flows: number;
+            objects: number;
+            lwc_components: number;
+        };
+        lastIndexed: string | null;
+        relationships: Record<string, number>;
+    } | null;
+    /** KSA-191: Log SFDX-specific stats after indexing. */
+    private logSfdxStats;
+    /** Index a single file (for incremental updates). */
+    indexSingleFile(filePath: string): Promise<void>;
+    /** Remove a file from the index. */
+    removeFile(filePath: string): void;
+    /** Check if indexer is currently running. */
+    isRunning(): boolean;
+    /** Stop the indexer and file watcher. */
+    stop(): void;
+    /** Get tree-sitter indexer stats. */
+    getTreeSitterStats(): {
+        ready: boolean;
+        languages: string[];
+        unavailableGrammars: string[];
+    };
+    private indexFiles;
+    /** Legacy regex-based symbol extraction (used when tree-sitter unavailable). */
+    private indexFileSymbolsRegex;
+    private isFileUnchanged;
+    private upsertFile;
+    private updateModules;
+    private detectAndStorePatterns;
+    /** Detect SFDX project structure. */
+    private detectSfdxProject;
+    private startWatcher;
+}