@stackguide/mcp-server 2.4.0 → 3.1.0

package/dist/services/analysisCache.js

@@ -0,0 +1,233 @@
+/**
+ * Analysis Cache Service
+ * Caches code analysis results by file hash to avoid re-analyzing unchanged files
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import * as crypto from 'crypto';
+import { logger } from '../utils/logger.js';
+const CACHE_VERSION = '1.0.0';
+const CACHE_TTL = 24 * 60 * 60 * 1000; // 24 hours
+const CACHE_DIR = '.stackguide';
+const CACHE_FILE = 'analysis-cache.json';
+/**
+ * Compute SHA256 hash of file content
+ */
+export function computeFileHash(content) {
+    return crypto.createHash('sha256').update(content).digest('hex').slice(0, 16);
+}
+/**
+ * Get cache directory path for a project
+ */
+export function getCacheDir(projectPath) {
+    return path.join(projectPath, CACHE_DIR);
+}
+/**
+ * Get cache file path for a project
+ */
+export function getCacheFilePath(projectPath) {
+    return path.join(getCacheDir(projectPath), CACHE_FILE);
+}
+/**
+ * Load cache from disk
+ */
+export function loadCache(projectPath) {
+    const cachePath = getCacheFilePath(projectPath);
+    try {
+        if (fs.existsSync(cachePath)) {
+            const data = fs.readFileSync(cachePath, 'utf-8');
+            const cache = JSON.parse(data);
+            // Invalidate cache if version mismatch
+            if (cache.version !== CACHE_VERSION) {
+                logger.debug('Cache version mismatch, starting fresh');
+                return createEmptyCache();
+            }
+            return cache;
+        }
+    }
+    catch (error) {
+        logger.debug('Failed to load cache, starting fresh', { error });
+    }
+    return createEmptyCache();
+}
+/**
+ * Save cache to disk
+ */
+export function saveCache(projectPath, cache) {
+    const cacheDir = getCacheDir(projectPath);
+    const cachePath = getCacheFilePath(projectPath);
+    try {
+        // Ensure cache directory exists
+        if (!fs.existsSync(cacheDir)) {
+            fs.mkdirSync(cacheDir, { recursive: true });
+        }
+        // Clean expired entries before saving
+        const cleanedCache = cleanExpiredEntries(cache);
+        fs.writeFileSync(cachePath, JSON.stringify(cleanedCache, null, 2));
+        logger.debug('Cache saved', { entries: Object.keys(cleanedCache.entries).length });
+    }
+    catch (error) {
+        logger.debug('Failed to save cache', { error });
+    }
+}
+/**
+ * Create empty cache store
+ */
+export function createEmptyCache() {
+    return {
+        version: CACHE_VERSION,
+        entries: {}
+    };
+}
+/**
+ * Clean expired entries from cache
+ */
+export function cleanExpiredEntries(cache) {
+    const now = Date.now();
+    const cleanedEntries = {};
+    for (const [filePath, entry] of Object.entries(cache.entries)) {
+        if (now - entry.timestamp < CACHE_TTL) {
+            cleanedEntries[filePath] = entry;
+        }
+    }
+    return {
+        version: cache.version,
+        entries: cleanedEntries
+    };
+}
+/**
+ * Get cached analysis result if valid
+ */
+export function getCachedResult(cache, filePath, content) {
+    const entry = cache.entries[filePath];
+    if (!entry) {
+        return null;
+    }
+    const currentHash = computeFileHash(content);
+    // Check if hash matches and entry is not expired
+    if (entry.hash === currentHash && Date.now() - entry.timestamp < CACHE_TTL) {
+        logger.debug('Cache hit', { filePath });
+        return entry.result;
+    }
+    logger.debug('Cache miss', { filePath, reason: entry.hash !== currentHash ? 'hash mismatch' : 'expired' });
+    return null;
+}
+/**
+ * Store analysis result in cache
+ */
+export function setCachedResult(cache, filePath, content, result) {
+    cache.entries[filePath] = {
+        hash: computeFileHash(content),
+        result,
+        timestamp: Date.now(),
+        version: CACHE_VERSION
+    };
+}
+/**
+ * Invalidate cache entry for a file
+ */
+export function invalidateCacheEntry(cache, filePath) {
+    delete cache.entries[filePath];
+}
+/**
+ * Clear all cache entries
+ */
+export function clearCache(projectPath) {
+    const cachePath = getCacheFilePath(projectPath);
+    try {
+        if (fs.existsSync(cachePath)) {
+            fs.unlinkSync(cachePath);
+            logger.debug('Cache cleared');
+        }
+    }
+    catch (error) {
+        logger.debug('Failed to clear cache', { error });
+    }
+}
+/**
+ * Get cache statistics
+ */
+export function getCacheStats(cache) {
+    const now = Date.now();
+    let validEntries = 0;
+    let expiredEntries = 0;
+    let oldestEntry = null;
+    let newestEntry = null;
+    for (const entry of Object.values(cache.entries)) {
+        if (now - entry.timestamp < CACHE_TTL) {
+            validEntries++;
+        }
+        else {
+            expiredEntries++;
+        }
+        if (oldestEntry === null || entry.timestamp < oldestEntry) {
+            oldestEntry = entry.timestamp;
+        }
+        if (newestEntry === null || entry.timestamp > newestEntry) {
+            newestEntry = entry.timestamp;
+        }
+    }
+    return {
+        totalEntries: Object.keys(cache.entries).length,
+        validEntries,
+        expiredEntries,
+        oldestEntry,
+        newestEntry
+    };
+}
+/**
+ * AnalysisCacheManager - High-level API for managing analysis cache
+ */
+export class AnalysisCacheManager {
+    projectPath;
+    cache;
+    dirty = false;
+    constructor(projectPath) {
+        this.projectPath = projectPath;
+        this.cache = loadCache(projectPath);
+    }
+    /**
+     * Get cached result or null if not found/invalid
+     */
+    get(filePath, content) {
+        return getCachedResult(this.cache, filePath, content);
+    }
+    /**
+     * Store result in cache
+     */
+    set(filePath, content, result) {
+        setCachedResult(this.cache, filePath, content, result);
+        this.dirty = true;
+    }
+    /**
+     * Invalidate a specific file
+     */
+    invalidate(filePath) {
+        invalidateCacheEntry(this.cache, filePath);
+        this.dirty = true;
+    }
+    /**
+     * Save cache to disk if modified
+     */
+    save() {
+        if (this.dirty) {
+            saveCache(this.projectPath, this.cache);
+            this.dirty = false;
+        }
+    }
+    /**
+     * Get cache statistics
+     */
+    getStats() {
+        return getCacheStats(this.cache);
+    }
+    /**
+     * Clear all cache
+     */
+    clear() {
+        clearCache(this.projectPath);
+        this.cache = createEmptyCache();
+        this.dirty = false;
+    }
+}
+//# sourceMappingURL=analysisCache.js.map

package/dist/services/analysisCache.js.map

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

package/dist/services/astAnalyzer.d.ts

@@ -0,0 +1,21 @@
+/**
+ * AST Analyzer Service - Phase 2
+ * Provides semantic code analysis using ts-morph
+ */
+import { SourceFile, Node, SyntaxKind } from 'ts-morph';
+import { ASTRule, CodeIssue } from '../config/types.js';
+/**
+ * Clear the cached project (useful for testing or memory management)
+ */
+export declare function clearASTCache(): void;
+/**
+ * Parse source code into a ts-morph SourceFile
+ */
+export declare function parseCode(filePath: string, content: string): SourceFile | null;
+/**
+ * Run AST rules against a source file
+ */
+export declare function analyzeWithAST(filePath: string, content: string, rules: ASTRule[]): CodeIssue[];
+export declare const BUILTIN_AST_RULES: ASTRule[];
+export { SyntaxKind, Node, SourceFile };
+//# sourceMappingURL=astAnalyzer.d.ts.map

package/dist/services/astAnalyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"astAnalyzer.d.ts","sourceRoot":"","sources":["../../src/services/astAnalyzer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAW,UAAU,EAAE,IAAI,EAAE,UAAU,EAAM,MAAM,UAAU,CAAC;AAErE,OAAO,EAAE,OAAO,EAAmC,SAAS,EAAiB,MAAM,oBAAoB,CAAC;AA6BxG;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAMpC;AAMD;;GAEG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAkB9E;AAoFD;;GAEG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,OAAO,EAAE,GACf,SAAS,EAAE,CAmEb;AAMD,eAAO,MAAM,iBAAiB,EAAE,OAAO,EAybtC,CAAC;AAMF,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC"}