forge-server 0.1.0

package/dist/ingestion/parser.js

@@ -0,0 +1,429 @@
+/**
+ * Tree-sitter AST parser for TypeScript/TSX/JavaScript/JSX (ADR-3).
+ * Extracts entities: functions, classes, interfaces, type aliases, exported variables, imports, exports.
+ * Falls back to empty result on parse error (error-tolerant).
+ */
+import { readFile } from 'fs/promises';
+import { extname } from 'path';
+import { logger } from '../util/logger.js';
+// tree-sitter imports - native C addon
+// We use dynamic import with fallback to web-tree-sitter (WASM)
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+let Parser = null;
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+let TypeScriptGrammar = null;
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+let TSXGrammar = null;
+let parserInitialized = false;
+// Eagerly kick off initialization when the module loads.
+// This allows synchronous callers (parseContent) to find the parser ready
+// by the time test fixtures set up via async beforeAll blocks.
+let _initPromiseEager = null;
+// Start loading immediately (non-blocking, fire-and-forget in module scope)
+// The promise is stored so callers can await it if needed.
+_initPromiseEager = (async () => {
+    try {
+        const treeSitter = await import('tree-sitter');
+        Parser = treeSitter.default;
+        const tsGrammar = await import('tree-sitter-typescript');
+        TypeScriptGrammar = tsGrammar.default.typescript;
+        TSXGrammar = tsGrammar.default.tsx;
+        parserInitialized = true;
+        return true;
+    }
+    catch {
+        parserInitialized = true;
+        return false;
+    }
+})();
+export async function initParser() {
+    // Reuse the eager init promise if it's still running.
+    if (_initPromiseEager) {
+        const result = await _initPromiseEager;
+        _initPromiseEager = null;
+        if (result) {
+            logger.info('tree-sitter parser initialized (native)');
+        }
+        else {
+            logger.warn('tree-sitter native addon failed to load, parser will return empty results', {});
+        }
+        return result;
+    }
+    return Parser !== null;
+}
+/**
+ * Determine language from file extension.
+ */
+export function getLanguage(filePath) {
+    const ext = extname(filePath).toLowerCase();
+    const map = {
+        '.ts': 'typescript',
+        '.tsx': 'tsx',
+        '.js': 'javascript',
+        '.jsx': 'tsx',
+        '.mts': 'typescript',
+        '.cts': 'typescript',
+        '.mjs': 'javascript',
+        '.cjs': 'javascript',
+    };
+    return map[ext] ?? null;
+}
+/**
+ * Parse a TypeScript/JavaScript file and extract entities.
+ */
+export async function parseFile(filePath, repoId) {
+    await initParser();
+    const lang = getLanguage(filePath);
+    if (!lang) {
+        return {
+            entities: [],
+            imports: [],
+            filePath,
+            language: 'unknown',
+            success: false,
+            error: 'Unsupported file extension',
+        };
+    }
+    let content;
+    try {
+        content = await readFile(filePath, 'utf8');
+    }
+    catch (err) {
+        return {
+            entities: [],
+            imports: [],
+            filePath,
+            language: lang,
+            success: false,
+            error: `Failed to read file: ${String(err)}`,
+        };
+    }
+    return parseContent(content, filePath, repoId, lang);
+}
+/**
+ * Parse content string (useful for testing without filesystem).
+ */
+export function parseContent(content, filePath, repoId, language) {
+    if (!Parser || !TypeScriptGrammar) {
+        // Parser not available - return empty but successful result
+        return {
+            entities: [],
+            imports: [],
+            filePath,
+            language,
+            success: false,
+            error: 'Parser not initialized (WASM fallback not implemented)',
+        };
+    }
+    try {
+        const parser = new Parser();
+        if (language === 'tsx') {
+            parser.setLanguage(TSXGrammar);
+        }
+        else {
+            parser.setLanguage(TypeScriptGrammar);
+        }
+        const tree = parser.parse(content);
+        const rootNode = tree.rootNode;
+        const entities = [];
+        const imports = [];
+        // Walk the AST
+        walkNode(rootNode, content, filePath, repoId, entities, imports);
+        return {
+            entities,
+            imports,
+            filePath,
+            language,
+            success: true,
+        };
+    }
+    catch (err) {
+        logger.warn('AST parse error', { filePath, error: String(err) });
+        return {
+            entities: [],
+            imports: [],
+            filePath,
+            language,
+            success: false,
+            error: String(err),
+        };
+    }
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function walkNode(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+node, content, filePath, repoId, entities, imports) {
+    const type = node.type;
+    // Import declarations — tree-sitter-typescript uses `import_statement`
+    if (type === 'import_statement' || type === 'import_declaration') {
+        const importNode = extractImport(node, content);
+        if (importNode)
+            imports.push(importNode);
+        return; // Don't recurse into imports
+    }
+    // Export statements - check what they export
+    // tree-sitter-typescript uses `export_statement`
+    if (type === 'export_statement') {
+        extractExportedEntities(node, content, filePath, repoId, entities);
+        return;
+    }
+    // Function declarations at top level
+    if (type === 'function_declaration' || type === 'generator_function_declaration') {
+        const entity = extractFunction(node, content, filePath, repoId, false);
+        if (entity)
+            entities.push(entity);
+        return;
+    }
+    // Class declarations at top level
+    if (type === 'class_declaration') {
+        const entity = extractClass(node, content, filePath, repoId, false);
+        if (entity)
+            entities.push(entity);
+        return;
+    }
+    // Interface declarations (TypeScript)
+    if (type === 'interface_declaration') {
+        const entity = extractInterface(node, content, filePath, repoId, false);
+        if (entity)
+            entities.push(entity);
+        return;
+    }
+    // Type alias declarations (TypeScript)
+    if (type === 'type_alias_declaration') {
+        const entity = extractTypeAlias(node, content, filePath, repoId, false);
+        if (entity)
+            entities.push(entity);
+        return;
+    }
+    // Lexical declarations (const/let/var) at top level - only exported ones captured in export_statement
+    // Variable declarations handled in export context
+    // Recurse into children for top-level nodes only
+    // We only care about top-level declarations
+    if (type === 'program' ||
+        type === 'module' ||
+        type === 'statement_block') {
+        for (let i = 0; i < node.childCount; i++) {
+            walkNode(node.child(i), content, filePath, repoId, entities, imports);
+        }
+    }
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function extractImport(node, content) {
+    try {
+        // Find the string source (module specifier)
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        let fromPath = '';
+        let specifiers = '';
+        let isDefault = false;
+        for (let i = 0; i < node.childCount; i++) {
+            const child = node.child(i);
+            if (child.type === 'string') {
+                fromPath = content.slice(child.startIndex + 1, child.endIndex - 1); // strip quotes
+            }
+            if (child.type === 'import_clause') {
+                const clauseText = content.slice(child.startIndex, child.endIndex);
+                specifiers = clauseText.trim();
+                isDefault = !clauseText.includes('{');
+            }
+        }
+        if (!fromPath)
+            return null;
+        return { fromPath, specifiers, isDefault };
+    }
+    catch {
+        return null;
+    }
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function extractExportedEntities(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+node, content, filePath, repoId, entities) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    let isDefault = false;
+    for (let i = 0; i < node.childCount; i++) {
+        const child = node.child(i);
+        if (child.type === 'default') {
+            isDefault = true;
+            continue;
+        }
+        if (child.type === 'function_declaration' || child.type === 'generator_function_declaration') {
+            const entity = extractFunction(child, content, filePath, repoId, true);
+            if (entity) {
+                entity.isDefault = isDefault;
+                entities.push(entity);
+            }
+        }
+        else if (child.type === 'class_declaration') {
+            const entity = extractClass(child, content, filePath, repoId, true);
+            if (entity) {
+                entity.isDefault = isDefault;
+                entities.push(entity);
+            }
+        }
+        else if (child.type === 'interface_declaration') {
+            const entity = extractInterface(child, content, filePath, repoId, true);
+            if (entity)
+                entities.push(entity);
+        }
+        else if (child.type === 'type_alias_declaration') {
+            const entity = extractTypeAlias(child, content, filePath, repoId, true);
+            if (entity)
+                entities.push(entity);
+        }
+        else if (child.type === 'lexical_declaration' || child.type === 'variable_declaration') {
+            // export const foo = ...
+            extractVariables(child, content, filePath, repoId, true, entities);
+        }
+    }
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function extractFunction(node, content, filePath, repoId, isExported) {
+    try {
+        let name = '';
+        let params = '';
+        let isAsync = false;
+        for (let i = 0; i < node.childCount; i++) {
+            const child = node.child(i);
+            if (child.type === 'async')
+                isAsync = true;
+            if (child.type === 'identifier')
+                name = content.slice(child.startIndex, child.endIndex);
+            if (child.type === 'formal_parameters') {
+                params = content.slice(child.startIndex, child.endIndex);
+            }
+        }
+        if (!name)
+            return null;
+        return {
+            name,
+            type: 'function',
+            filePath,
+            repoId,
+            startLine: node.startPosition.row + 1,
+            endLine: node.endPosition.row + 1,
+            isExported,
+            isAsync,
+            params,
+            sourceText: content.slice(node.startIndex, node.endIndex),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function extractClass(node, content, filePath, repoId, isExported) {
+    try {
+        let name = '';
+        for (let i = 0; i < node.childCount; i++) {
+            const child = node.child(i);
+            if (child.type === 'type_identifier' || child.type === 'identifier') {
+                name = content.slice(child.startIndex, child.endIndex);
+                break;
+            }
+        }
+        if (!name)
+            return null;
+        return {
+            name,
+            type: 'class',
+            filePath,
+            repoId,
+            startLine: node.startPosition.row + 1,
+            endLine: node.endPosition.row + 1,
+            isExported,
+            sourceText: content.slice(node.startIndex, node.endIndex),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function extractInterface(node, content, filePath, repoId, isExported) {
+    try {
+        let name = '';
+        for (let i = 0; i < node.childCount; i++) {
+            const child = node.child(i);
+            if (child.type === 'type_identifier' || child.type === 'identifier') {
+                name = content.slice(child.startIndex, child.endIndex);
+                break;
+            }
+        }
+        if (!name)
+            return null;
+        return {
+            name,
+            type: 'interface',
+            filePath,
+            repoId,
+            startLine: node.startPosition.row + 1,
+            endLine: node.endPosition.row + 1,
+            isExported,
+            sourceText: content.slice(node.startIndex, node.endIndex),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function extractTypeAlias(node, content, filePath, repoId, isExported) {
+    try {
+        let name = '';
+        for (let i = 0; i < node.childCount; i++) {
+            const child = node.child(i);
+            if (child.type === 'type_identifier' || child.type === 'identifier') {
+                name = content.slice(child.startIndex, child.endIndex);
+                break;
+            }
+        }
+        if (!name)
+            return null;
+        return {
+            name,
+            type: 'type_alias',
+            filePath,
+            repoId,
+            startLine: node.startPosition.row + 1,
+            endLine: node.endPosition.row + 1,
+            isExported,
+            sourceText: content.slice(node.startIndex, node.endIndex),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function extractVariables(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+node, content, filePath, repoId, isExported, entities) {
+    try {
+        const isConst = content.slice(node.startIndex, node.startIndex + 5).startsWith('const');
+        for (let i = 0; i < node.childCount; i++) {
+            const child = node.child(i);
+            if (child.type === 'variable_declarator') {
+                const nameNode = child.child(0);
+                if (nameNode && (nameNode.type === 'identifier' || nameNode.type === 'type_identifier')) {
+                    const name = content.slice(nameNode.startIndex, nameNode.endIndex);
+                    entities.push({
+                        name,
+                        type: 'variable',
+                        filePath,
+                        repoId,
+                        startLine: node.startPosition.row + 1,
+                        endLine: node.endPosition.row + 1,
+                        isExported,
+                        isConst,
+                        sourceText: content.slice(node.startIndex, node.endIndex),
+                    });
+                }
+            }
+        }
+    }
+    catch {
+        // Skip malformed variable declarations
+    }
+}
+//# sourceMappingURL=parser.js.map

package/dist/ingestion/parser.js.map

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

package/dist/ingestion/watcher.d.ts

@@ -0,0 +1,28 @@
+/**
+ * File system watcher using chokidar (ADR, section 4.5).
+ * Watches configured repo directories, debounces rapid saves (500ms),
+ * respects .gitignore patterns, and detects git HEAD changes for branch switches.
+ */
+import { EventEmitter } from 'events';
+import type { RepoConfig } from '../util/types.js';
+type WatchEvent = 'add' | 'change' | 'unlink';
+export interface FileChangeEvent {
+    type: WatchEvent;
+    filePath: string;
+    repoId: string;
+}
+export declare class FileWatcher extends EventEmitter {
+    private watchers;
+    private debounceTimers;
+    private gitHeadValues;
+    private readonly debounceMs;
+    constructor(debounceMs?: number);
+    watch(repoConfig: RepoConfig, additionalIgnored?: string[]): Promise<void>;
+    stop(repoId?: string): Promise<void>;
+    private handleChange;
+    private handleFileChangeDebounced;
+    private initGitHead;
+    private handleGitHeadChange;
+}
+export {};
+//# sourceMappingURL=watcher.d.ts.map

package/dist/ingestion/watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../../src/ingestion/watcher.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAGtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AASnD,KAAK,UAAU,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE9C,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAsBD,qBAAa,WAAY,SAAQ,YAAY;IAC3C,OAAO,CAAC,QAAQ,CAA2C;IAC3D,OAAO,CAAC,cAAc,CAAyD;IAC/E,OAAO,CAAC,aAAa,CAAkC;IACvD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,UAAU,GAAE,MAAY;IAK9B,KAAK,CAAC,UAAU,EAAE,UAAU,EAAE,iBAAiB,GAAE,MAAM,EAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAoD9E,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAe1C,OAAO,CAAC,YAAY;YAkBN,yBAAyB;YAgBzB,WAAW;YASX,mBAAmB;CAclC"}

package/dist/ingestion/watcher.js

@@ -0,0 +1,147 @@
+/**
+ * File system watcher using chokidar (ADR, section 4.5).
+ * Watches configured repo directories, debounces rapid saves (500ms),
+ * respects .gitignore patterns, and detects git HEAD changes for branch switches.
+ */
+import { EventEmitter } from 'events';
+import { join } from 'path';
+import { readFile } from 'fs/promises';
+import { logger } from '../util/logger.js';
+const WATCHED_EXTENSIONS = new Set([
+    '.ts', '.tsx', '.js', '.jsx', '.mts', '.cts', '.mjs', '.cjs',
+    '.json', '.yaml', '.yml', '.md', '.mdx', '.graphql', '.gql', '.sql',
+]);
+const DEFAULT_IGNORED = [
+    '**/node_modules/**',
+    '**/.git/**',
+    '**/dist/**',
+    '**/build/**',
+    '**/.cache/**',
+    '**/*.map',
+    '**/*.min.js',
+    '**/*.min.css',
+    '**/package-lock.json',
+    '**/pnpm-lock.yaml',
+    '**/.DS_Store',
+    '**/Thumbs.db',
+];
+export class FileWatcher extends EventEmitter {
+    watchers = new Map();
+    debounceTimers = new Map();
+    gitHeadValues = new Map();
+    debounceMs;
+    constructor(debounceMs = 500) {
+        super();
+        this.debounceMs = debounceMs;
+    }
+    async watch(repoConfig, additionalIgnored = []) {
+        const { id: repoId, path: repoPath } = repoConfig;
+        try {
+            const { default: chokidar } = await import('chokidar');
+            const ignored = [...DEFAULT_IGNORED, ...additionalIgnored];
+            const watcher = chokidar.watch(repoPath, {
+                ignored,
+                persistent: true,
+                ignoreInitial: true,
+                awaitWriteFinish: {
+                    stabilityThreshold: 100,
+                    pollInterval: 50,
+                },
+                usePolling: false,
+                // Windows-specific: use polling as fallback for network drives
+                interval: 500,
+                binaryInterval: 1000,
+            });
+            // Watch git HEAD for branch switches
+            const gitHeadPath = join(repoPath, '.git', 'HEAD');
+            await this.initGitHead(repoId, gitHeadPath);
+            watcher.on('add', (filePath) => this.handleChange('add', filePath, repoId));
+            watcher.on('change', (filePath) => this.handleChange('change', filePath, repoId));
+            watcher.on('unlink', (filePath) => this.handleChange('unlink', filePath, repoId));
+            watcher.on('error', (error) => {
+                const msg = error instanceof Error ? error.message : String(error);
+                logger.error('Watcher error', { repoId, error: msg });
+            });
+            // Watch .git/HEAD separately for branch switch detection.
+            // The main watcher ignores .git/** so we need a dedicated watcher.
+            const gitHeadWatcher = chokidar.watch(gitHeadPath, {
+                persistent: true,
+                ignoreInitial: true,
+                awaitWriteFinish: { stabilityThreshold: 100, pollInterval: 50 },
+                usePolling: false,
+                interval: 500,
+            });
+            gitHeadWatcher.on('change', () => this.handleGitHeadChange(repoId, gitHeadPath));
+            this.watchers.set(repoId, watcher);
+            logger.info('Watching repo', { repoId, path: repoPath });
+        }
+        catch (err) {
+            logger.error('Failed to start watcher', { repoId, error: String(err) });
+        }
+    }
+    async stop(repoId) {
+        if (repoId) {
+            const watcher = this.watchers.get(repoId);
+            if (watcher) {
+                await watcher.close();
+                this.watchers.delete(repoId);
+            }
+        }
+        else {
+            for (const [id, watcher] of this.watchers) {
+                await watcher.close();
+                this.watchers.delete(id);
+            }
+        }
+    }
+    handleChange(type, filePath, repoId) {
+        // Filter by extension
+        const ext = filePath.slice(filePath.lastIndexOf('.')).toLowerCase();
+        if (!WATCHED_EXTENSIONS.has(ext) && !filePath.endsWith('HEAD'))
+            return;
+        // Debounce
+        const debounceKey = `${repoId}:${filePath}`;
+        const existing = this.debounceTimers.get(debounceKey);
+        if (existing)
+            clearTimeout(existing);
+        const timer = setTimeout(() => {
+            this.debounceTimers.delete(debounceKey);
+            this.handleFileChangeDebounced(type, filePath, repoId);
+        }, this.debounceMs);
+        this.debounceTimers.set(debounceKey, timer);
+    }
+    async handleFileChangeDebounced(type, filePath, repoId) {
+        // Check for git HEAD changes (branch switch detection)
+        if (filePath.endsWith('.git/HEAD') || filePath.endsWith('.git\\HEAD')) {
+            await this.handleGitHeadChange(repoId, filePath);
+            return;
+        }
+        const event = { type, filePath, repoId };
+        this.emit('file-change', event);
+        logger.debug('File change detected', { type, filePath, repoId });
+    }
+    async initGitHead(repoId, headPath) {
+        try {
+            const content = await readFile(headPath, 'utf8');
+            this.gitHeadValues.set(repoId, content.trim());
+        }
+        catch {
+            // .git/HEAD may not exist for non-git repos
+        }
+    }
+    async handleGitHeadChange(repoId, headPath) {
+        try {
+            const newHead = (await readFile(headPath, 'utf8')).trim();
+            const oldHead = this.gitHeadValues.get(repoId);
+            if (oldHead !== newHead) {
+                this.gitHeadValues.set(repoId, newHead);
+                logger.info('Git branch switch detected', { repoId, from: oldHead, to: newHead });
+                this.emit('branch-switch', { repoId, from: oldHead, to: newHead });
+            }
+        }
+        catch {
+            // Ignore errors reading git HEAD
+        }
+    }
+}
+//# sourceMappingURL=watcher.js.map

package/dist/ingestion/watcher.js.map

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