@stackguide/mcp-server 3.0.0 → 3.2.0

package/dist/services/parsers/baseParser.js

@@ -0,0 +1,177 @@
+/**
+ * Base Language Parser
+ * Abstract base class for language-specific parsers
+ * @version 3.2.0
+ */
+import { logger } from '../../utils/logger.js';
+/**
+ * Abstract base class for language parsers
+ */
+export class BaseLanguageParser {
+    rules = [];
+    /**
+     * Get language-specific rules
+     */
+    getRules() {
+        return this.rules.filter(r => r.enabled);
+    }
+    /**
+     * Check if parser can handle this file
+     */
+    canHandle(filePath) {
+        const ext = filePath.substring(filePath.lastIndexOf('.')).toLowerCase();
+        return this.extensions.includes(ext);
+    }
+    /**
+     * Analyze code using language-specific rules
+     */
+    analyze(code, filePath) {
+        const startTime = Date.now();
+        const issues = [];
+        try {
+            const parseResult = this.parse(code, filePath);
+            const context = this.createContext(code, filePath, parseResult);
+            for (const rule of this.getRules()) {
+                try {
+                    const result = rule.check(context);
+                    if (result?.hasIssue) {
+                        issues.push({
+                            severity: rule.severity,
+                            rule: rule.id,
+                            category: rule.category,
+                            message: result.message,
+                            line: result.line,
+                            column: result.column,
+                            source: 'builtin',
+                            suggestion: result.suggestion,
+                            details: result.details
+                        });
+                    }
+                }
+                catch (error) {
+                    logger.warn(`Rule ${rule.id} failed`, { error, filePath });
+                }
+            }
+            logger.debug(`${this.language} analysis complete`, {
+                filePath,
+                issues: issues.length,
+                duration: Date.now() - startTime
+            });
+        }
+        catch (error) {
+            logger.error(`${this.language} parsing failed`, { error, filePath });
+        }
+        return issues;
+    }
+    /**
+     * Create parse context for rules
+     */
+    createContext(code, filePath, parseResult) {
+        const lines = code.split('\n');
+        return {
+            code,
+            filePath,
+            language: this.language,
+            symbols: parseResult.symbols,
+            imports: parseResult.imports,
+            functions: parseResult.functions,
+            classes: parseResult.classes,
+            variables: parseResult.variables,
+            comments: parseResult.comments,
+            getLine: (lineNumber) => lines[lineNumber - 1] || '',
+            getLines: (start, end) => lines.slice(start - 1, end),
+            containsPattern: (pattern) => pattern.test(code),
+            findPatternMatches: (pattern) => {
+                const matches = [];
+                const globalPattern = new RegExp(pattern.source, 'gm');
+                let match;
+                while ((match = globalPattern.exec(code)) !== null) {
+                    const beforeMatch = code.substring(0, match.index);
+                    const lineNumber = beforeMatch.split('\n').length;
+                    const lastNewline = beforeMatch.lastIndexOf('\n');
+                    const column = match.index - lastNewline;
+                    matches.push({
+                        match: match[0],
+                        line: lineNumber,
+                        column,
+                        groups: match.groups
+                    });
+                }
+                return matches;
+            }
+        };
+    }
+    /**
+     * Helper: Extract comments from code
+     */
+    extractComments(code, lineCommentPrefix, blockStart, blockEnd) {
+        const comments = [];
+        const lines = code.split('\n');
+        // Line comments
+        const lineCommentRegex = new RegExp(`${escapeRegex(lineCommentPrefix)}(.*)$`, 'gm');
+        let match;
+        while ((match = lineCommentRegex.exec(code)) !== null) {
+            const beforeMatch = code.substring(0, match.index);
+            const lineNumber = beforeMatch.split('\n').length;
+            const text = match[1].trim();
+            comments.push({
+                text,
+                line: lineNumber,
+                type: 'line',
+                isTodo: /\bTODO\b/i.test(text),
+                isFixme: /\bFIXME\b/i.test(text)
+            });
+        }
+        // Block comments
+        if (blockStart && blockEnd) {
+            const blockRegex = new RegExp(`${escapeRegex(blockStart)}([\\s\\S]*?)${escapeRegex(blockEnd)}`, 'gm');
+            while ((match = blockRegex.exec(code)) !== null) {
+                const beforeMatch = code.substring(0, match.index);
+                const startLine = beforeMatch.split('\n').length;
+                const endLine = startLine + match[0].split('\n').length - 1;
+                const text = match[1].trim();
+                comments.push({
+                    text,
+                    line: startLine,
+                    endLine,
+                    type: text.startsWith('*') ? 'doc' : 'block',
+                    isTodo: /\bTODO\b/i.test(text),
+                    isFixme: /\bFIXME\b/i.test(text)
+                });
+            }
+        }
+        return comments;
+    }
+    /**
+     * Helper: Count complexity (basic cyclomatic)
+     */
+    calculateComplexity(code) {
+        // Count decision points
+        const decisionPatterns = [
+            /\bif\b/g,
+            /\belse\s+if\b/g,
+            /\bwhile\b/g,
+            /\bfor\b/g,
+            /\bcase\b/g,
+            /\bcatch\b/g,
+            /\b\?\s*:/g, // ternary
+            /\&\&/g,
+            /\|\|/g
+        ];
+        let complexity = 1; // Base complexity
+        for (const pattern of decisionPatterns) {
+            const matches = code.match(pattern);
+            if (matches) {
+                complexity += matches.length;
+            }
+        }
+        return complexity;
+    }
+}
+/**
+ * Escape special regex characters
+ */
+function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+//# sourceMappingURL=baseParser.js.map

package/dist/services/parsers/baseParser.js.map

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

package/dist/services/parsers/goParser.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Go Language Parser
+ * Semantic analysis for Go code
+ * @version 3.2.0
+ */
+import { BaseLanguageParser } from './baseParser.js';
+import type { ParseResult, LanguageRule } from './types.js';
+/**
+ * Go-specific parser with semantic rules
+ */
+export declare class GoParser extends BaseLanguageParser {
+    readonly language: "go";
+    readonly extensions: string[];
+    constructor();
+    parse(code: string, filePath: string): ParseResult;
+    private extractImports;
+    private extractFunctions;
+    private parseGoParams;
+    private splitGoParams;
+    private extractStructs;
+    private extractVariables;
+}
+/**
+ * Go-specific semantic rules
+ */
+declare const GO_RULES: LanguageRule[];
+export { GO_RULES };
+//# sourceMappingURL=goParser.d.ts.map

package/dist/services/parsers/goParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"goParser.d.ts","sourceRoot":"","sources":["../../../src/services/parsers/goParser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EACV,WAAW,EASX,YAAY,EAEb,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,qBAAa,QAAS,SAAQ,kBAAkB;IAC9C,QAAQ,CAAC,QAAQ,EAAG,IAAI,CAAU;IAClC,QAAQ,CAAC,UAAU,WAAW;;IAO9B,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,WAAW;IAwElD,OAAO,CAAC,cAAc;IA6CtB,OAAO,CAAC,gBAAgB;IAuDxB,OAAO,CAAC,aAAa;IAiCrB,OAAO,CAAC,aAAa;IAqBrB,OAAO,CAAC,cAAc;IAkDtB,OAAO,CAAC,gBAAgB;CAyBzB;AAED;;GAEG;AACH,QAAA,MAAM,QAAQ,EAAE,YAAY,EA2T3B,CAAC;AAEF,OAAO,EAAE,QAAQ,EAAE,CAAC"}