@ai-coders/context 0.6.1 → 0.7.0

package/dist/services/qa/patternInferer.js

@@ -0,0 +1,366 @@
+"use strict";
+/**
+ * Pattern Inferer
+ *
+ * Infers functional patterns (auth, database, API, etc.) from codebase-map.json
+ * without re-analyzing the codebase. This is an optimization that uses
+ * pre-computed symbol data to detect capabilities.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PatternInferer = void 0;
+/**
+ * Pattern Inferer - derives functional patterns from codebase-map.json
+ */
+class PatternInferer {
+    /**
+     * Infer functional patterns from a pre-computed codebase map
+     */
+    inferFromMap(map) {
+        const patterns = [];
+        const allSymbols = this.getAllSymbols(map);
+        // Authentication pattern detection
+        const authPattern = this.detectAuthPattern(allSymbols, map);
+        if (authPattern)
+            patterns.push(authPattern);
+        // Database pattern detection
+        const dbPattern = this.detectDatabasePattern(allSymbols, map);
+        if (dbPattern)
+            patterns.push(dbPattern);
+        // API pattern detection
+        const apiPattern = this.detectApiPattern(allSymbols, map);
+        if (apiPattern)
+            patterns.push(apiPattern);
+        // Cache pattern detection
+        const cachePattern = this.detectCachePattern(allSymbols);
+        if (cachePattern)
+            patterns.push(cachePattern);
+        // Queue/messaging pattern detection
+        const queuePattern = this.detectQueuePattern(allSymbols);
+        if (queuePattern)
+            patterns.push(queuePattern);
+        // WebSocket pattern detection
+        const wsPattern = this.detectWebSocketPattern(allSymbols);
+        if (wsPattern)
+            patterns.push(wsPattern);
+        // Logging pattern detection
+        const loggingPattern = this.detectLoggingPattern(allSymbols);
+        if (loggingPattern)
+            patterns.push(loggingPattern);
+        // Validation pattern detection
+        const validationPattern = this.detectValidationPattern(allSymbols);
+        if (validationPattern)
+            patterns.push(validationPattern);
+        // Error handling pattern detection
+        const errorPattern = this.detectErrorHandlingPattern(allSymbols);
+        if (errorPattern)
+            patterns.push(errorPattern);
+        // Testing pattern detection
+        const testingPattern = this.detectTestingPattern(allSymbols, map);
+        if (testingPattern)
+            patterns.push(testingPattern);
+        return {
+            hasAuthPattern: patterns.some((p) => p.type === 'auth'),
+            hasDatabasePattern: patterns.some((p) => p.type === 'database'),
+            hasApiPattern: patterns.some((p) => p.type === 'api'),
+            hasCachePattern: patterns.some((p) => p.type === 'cache'),
+            hasQueuePattern: patterns.some((p) => p.type === 'queue'),
+            hasWebSocketPattern: patterns.some((p) => p.type === 'websocket'),
+            hasLoggingPattern: patterns.some((p) => p.type === 'logging'),
+            hasValidationPattern: patterns.some((p) => p.type === 'validation'),
+            hasErrorHandlingPattern: patterns.some((p) => p.type === 'error-handling'),
+            hasTestingPattern: patterns.some((p) => p.type === 'testing'),
+            patterns,
+        };
+    }
+    /**
+     * Get all symbols from the map as a flat array
+     */
+    getAllSymbols(map) {
+        return [
+            ...map.symbols.classes,
+            ...map.symbols.interfaces,
+            ...map.symbols.functions,
+            ...map.symbols.types,
+            ...map.symbols.enums,
+        ];
+    }
+    /**
+     * Find symbols matching any of the given patterns
+     */
+    findSymbolsMatching(symbols, patterns) {
+        return symbols.filter((s) => patterns.some((p) => p.test(s.name) || (s.file && p.test(s.file))));
+    }
+    /**
+     * Create pattern indicators from matched symbols
+     */
+    createIndicators(matches, reasonPrefix) {
+        return matches.slice(0, 10).map((s) => ({
+            file: s.file,
+            symbol: s.name,
+            line: s.line,
+            reason: `${reasonPrefix}: ${s.name}`,
+        }));
+    }
+    // Pattern detection methods
+    detectAuthPattern(symbols, map) {
+        const indicators = [];
+        // Check for auth-related symbols
+        const authPatterns = [
+            /^(auth|login|logout|verify|jwt|token|session|password|credential|oauth)/i,
+            /Auth$/i,
+            /Authentication$/i,
+            /Authenticator$/i,
+        ];
+        const authSymbols = this.findSymbolsMatching(symbols, authPatterns);
+        indicators.push(...this.createIndicators(authSymbols, 'Auth-related symbol'));
+        // Check for auth-related file paths
+        const authFilePaths = symbols.filter((s) => /\/(auth|login|session|middleware)\//i.test(s.file));
+        for (const s of authFilePaths.slice(0, 5)) {
+            indicators.push({
+                file: s.file,
+                reason: 'Auth-related file path',
+            });
+        }
+        // Check architecture layers for auth indicators
+        if (map.architecture.layers.some((l) => /auth/i.test(l.name))) {
+            indicators.push({
+                file: '',
+                reason: 'Auth-related architecture layer detected',
+            });
+        }
+        if (indicators.length === 0)
+            return null;
+        return {
+            type: 'auth',
+            confidence: Math.min(1, indicators.length * 0.15),
+            indicators: indicators.slice(0, 10),
+            description: 'Authentication and authorization functionality',
+        };
+    }
+    detectDatabasePattern(symbols, map) {
+        const indicators = [];
+        // Check for database-related symbols
+        const dbPatterns = [
+            /^(repository|model|entity|schema|migration|query|database|db)/i,
+            /Repository$/i,
+            /Model$/i,
+            /Entity$/i,
+            /Schema$/i,
+        ];
+        const dbSymbols = this.findSymbolsMatching(symbols, dbPatterns);
+        indicators.push(...this.createIndicators(dbSymbols, 'Database-related symbol'));
+        // Check for database-related file paths
+        const dbFilePaths = symbols.filter((s) => /\/(models?|repositories|entities|migrations?|schemas?|database)\//i.test(s.file));
+        for (const s of dbFilePaths.slice(0, 5)) {
+            indicators.push({
+                file: s.file,
+                reason: 'Database-related file path',
+            });
+        }
+        // Check architecture layers for data layer
+        const hasDataLayer = map.architecture.layers.some((l) => /repository|model|data/i.test(l.name));
+        if (hasDataLayer) {
+            indicators.push({
+                file: '',
+                reason: 'Data layer detected in architecture',
+            });
+        }
+        if (indicators.length === 0)
+            return null;
+        return {
+            type: 'database',
+            confidence: Math.min(1, indicators.length * 0.15),
+            indicators: indicators.slice(0, 10),
+            description: 'Database access and ORM functionality',
+        };
+    }
+    detectApiPattern(symbols, map) {
+        const indicators = [];
+        // Check for API-related symbols
+        const apiPatterns = [
+            /^(controller|handler|router|route|endpoint|api|rest|graphql|resolver)/i,
+            /Controller$/i,
+            /Handler$/i,
+            /Router$/i,
+            /Resolver$/i,
+        ];
+        const apiSymbols = this.findSymbolsMatching(symbols, apiPatterns);
+        indicators.push(...this.createIndicators(apiSymbols, 'API-related symbol'));
+        // Check for API-related file paths
+        const apiFilePaths = symbols.filter((s) => /\/(routes?|controllers?|handlers?|api|endpoints?|resolvers?)\//i.test(s.file));
+        for (const s of apiFilePaths.slice(0, 5)) {
+            indicators.push({
+                file: s.file,
+                reason: 'API-related file path',
+            });
+        }
+        // Check architecture layers for controller layer
+        const hasControllerLayer = map.architecture.layers.some((l) => /controller|handler|route/i.test(l.name));
+        if (hasControllerLayer) {
+            indicators.push({
+                file: '',
+                reason: 'Controller layer detected in architecture',
+            });
+        }
+        // Check for API frameworks in stack
+        const apiFrameworks = ['express', 'fastify', 'nestjs', 'koa', 'hapi', 'graphql'];
+        if (map.stack.frameworks.some((f) => apiFrameworks.includes(f.toLowerCase()))) {
+            indicators.push({
+                file: '',
+                reason: `API framework detected: ${map.stack.frameworks.filter((f) => apiFrameworks.includes(f.toLowerCase())).join(', ')}`,
+            });
+        }
+        if (indicators.length === 0)
+            return null;
+        return {
+            type: 'api',
+            confidence: Math.min(1, indicators.length * 0.15),
+            indicators: indicators.slice(0, 10),
+            description: 'API endpoints and routing',
+        };
+    }
+    detectCachePattern(symbols) {
+        const indicators = [];
+        // Check for cache-related symbols
+        const cachePatterns = [/^(cache|redis|memcache|lru|ttl)/i, /Cache$/i];
+        const cacheSymbols = this.findSymbolsMatching(symbols, cachePatterns);
+        indicators.push(...this.createIndicators(cacheSymbols, 'Cache-related symbol'));
+        if (indicators.length === 0)
+            return null;
+        return {
+            type: 'cache',
+            confidence: Math.min(1, indicators.length * 0.2),
+            indicators: indicators.slice(0, 10),
+            description: 'Caching and data memoization',
+        };
+    }
+    detectQueuePattern(symbols) {
+        const indicators = [];
+        // Check for queue-related symbols
+        const queuePatterns = [
+            /^(queue|worker|job|task|consumer|producer|message)/i,
+            /Queue$/i,
+            /Worker$/i,
+            /Job$/i,
+        ];
+        const queueSymbols = this.findSymbolsMatching(symbols, queuePatterns);
+        indicators.push(...this.createIndicators(queueSymbols, 'Queue-related symbol'));
+        if (indicators.length === 0)
+            return null;
+        return {
+            type: 'queue',
+            confidence: Math.min(1, indicators.length * 0.2),
+            indicators: indicators.slice(0, 10),
+            description: 'Message queues and background jobs',
+        };
+    }
+    detectWebSocketPattern(symbols) {
+        const indicators = [];
+        // Check for WebSocket-related symbols
+        const wsPatterns = [
+            /^(websocket|socket|ws|realtime|broadcast|subscribe)/i,
+            /Socket$/i,
+            /WebSocket$/i,
+        ];
+        const wsSymbols = this.findSymbolsMatching(symbols, wsPatterns);
+        indicators.push(...this.createIndicators(wsSymbols, 'WebSocket-related symbol'));
+        if (indicators.length === 0)
+            return null;
+        return {
+            type: 'websocket',
+            confidence: Math.min(1, indicators.length * 0.2),
+            indicators: indicators.slice(0, 10),
+            description: 'Real-time WebSocket communication',
+        };
+    }
+    detectLoggingPattern(symbols) {
+        const indicators = [];
+        // Check for logging-related symbols
+        const logPatterns = [/^(logger|log|logging|telemetry|metrics)/i, /Logger$/i];
+        const logSymbols = this.findSymbolsMatching(symbols, logPatterns);
+        indicators.push(...this.createIndicators(logSymbols, 'Logging-related symbol'));
+        if (indicators.length === 0)
+            return null;
+        return {
+            type: 'logging',
+            confidence: Math.min(1, indicators.length * 0.2),
+            indicators: indicators.slice(0, 10),
+            description: 'Logging and observability',
+        };
+    }
+    detectValidationPattern(symbols) {
+        const indicators = [];
+        // Check for validation-related symbols
+        const validPatterns = [
+            /^(valid|schema|sanitize|parse|check|assert)/i,
+            /Validator$/i,
+            /Schema$/i,
+        ];
+        const validSymbols = this.findSymbolsMatching(symbols, validPatterns);
+        indicators.push(...this.createIndicators(validSymbols, 'Validation-related symbol'));
+        if (indicators.length === 0)
+            return null;
+        return {
+            type: 'validation',
+            confidence: Math.min(1, indicators.length * 0.2),
+            indicators: indicators.slice(0, 10),
+            description: 'Input validation and schema enforcement',
+        };
+    }
+    detectErrorHandlingPattern(symbols) {
+        const indicators = [];
+        // Check for error-related symbols
+        const errorPatterns = [
+            /^(error|exception|handler|catch|fallback)/i,
+            /Error$/i,
+            /Exception$/i,
+        ];
+        const errorSymbols = this.findSymbolsMatching(symbols, errorPatterns);
+        indicators.push(...this.createIndicators(errorSymbols, 'Error handling symbol'));
+        // Check for error-related file paths
+        const errorFilePaths = symbols.filter((s) => /\/(errors?|exceptions?)\//i.test(s.file));
+        for (const s of errorFilePaths.slice(0, 5)) {
+            indicators.push({
+                file: s.file,
+                reason: 'Error handling file path',
+            });
+        }
+        if (indicators.length === 0)
+            return null;
+        return {
+            type: 'error-handling',
+            confidence: Math.min(1, indicators.length * 0.15),
+            indicators: indicators.slice(0, 10),
+            description: 'Error handling and exception management',
+        };
+    }
+    detectTestingPattern(symbols, map) {
+        const indicators = [];
+        // Check for test frameworks in stack
+        if (map.stack.testFrameworks.length > 0) {
+            indicators.push({
+                file: '',
+                reason: `Test frameworks: ${map.stack.testFrameworks.join(', ')}`,
+            });
+        }
+        // Check for test-related file paths
+        const testFilePaths = symbols.filter((s) => /\.(test|spec)\.(ts|tsx|js|jsx)$/.test(s.file) ||
+            /\/__tests__\//.test(s.file));
+        for (const s of testFilePaths.slice(0, 5)) {
+            indicators.push({
+                file: s.file,
+                reason: 'Test file',
+            });
+        }
+        if (indicators.length === 0)
+            return null;
+        return {
+            type: 'testing',
+            confidence: Math.min(1, indicators.length * 0.15),
+            indicators: indicators.slice(0, 10),
+            description: 'Testing infrastructure and test files',
+        };
+    }
+}
+exports.PatternInferer = PatternInferer;
+//# sourceMappingURL=patternInferer.js.map

package/dist/services/qa/patternInferer.js.map

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

package/dist/services/qa/qaService.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Q&A Service
+ *
+ * Generates and manages Q&A content for the codebase.
+ * Pre-answers common questions to reduce token usage during sessions.
+ *
+ * OPTIMIZATION: Uses codebase-map.json when available to avoid re-analyzing
+ * the codebase. This provides ~10x faster Q&A generation when the map exists.
+ */
+import { type TopicDetectionResult } from './topicDetector';
+/**
+ * Q&A Entry structure
+ */
+export interface QAEntry {
+    slug: string;
+    question: string;
+    answer: string;
+    category: string;
+    generatedAt: string;
+    relevantFiles: string[];
+}
+/**
+ * Q&A Search result
+ */
+export interface QASearchResult {
+    entry: QAEntry;
+    score: number;
+    matchReason: string;
+}
+/**
+ * Q&A Generation result
+ */
+export interface QAGenerationResult {
+    generated: QAEntry[];
+    skipped: string[];
+    topicDetection: TopicDetectionResult;
+}
+/**
+ * Q&A Service for generating and searching Q&A content
+ */
+export declare class QAService {
+    private analyzer;
+    private stackDetector;
+    private topicDetector;
+    private patternInferer;
+    constructor(options?: {
+        useLSP?: boolean;
+    });
+    /**
+     * Generate Q&A from codebase analysis
+     *
+     * OPTIMIZATION: Uses codebase-map.json when available to avoid re-analyzing.
+     * If the map doesn't exist, falls back to full analysis.
+     */
+    generateFromCodebase(repoPath: string): Promise<QAGenerationResult>;
+    /**
+     * Search Q&A entries for a query
+     */
+    search(repoPath: string, query: string): Promise<QASearchResult[]>;
+    /**
+     * Get all Q&A entries
+     */
+    getAll(repoPath: string): Promise<QAEntry[]>;
+    /**
+     * Get a specific Q&A entry by slug
+     */
+    getBySlug(repoPath: string, slug: string): Promise<QAEntry | null>;
+    /**
+     * Generate Q&A entry for a specific topic
+     */
+    private generateQAForTopic;
+    private generateGettingStartedAnswer;
+    private generateProjectStructureAnswer;
+    private generateCLICommandsAnswer;
+    private generateCLIArgumentsAnswer;
+    private generateRoutingAnswer;
+    private generateMiddlewareAnswer;
+    private generateAuthAnswer;
+    private generateDatabaseAnswer;
+    private generateAPIEndpointsAnswer;
+    private generateTestingAnswer;
+    private generateErrorHandlingAnswer;
+    private generateCachingAnswer;
+    private generateRealtimeAnswer;
+    private generateBackgroundJobsAnswer;
+    private generateDeploymentAnswer;
+    private getPatternFiles;
+    private findRelevantFiles;
+    private saveQAEntries;
+    private formatQAEntry;
+    private generateQAReadme;
+    private parseQAEntry;
+    private calculateRelevance;
+    /**
+     * Load codebase-map.json if it exists
+     */
+    private loadCodebaseMap;
+    /**
+     * Convert codebase-map stack section to StackInfo format
+     */
+    private convertMapStackToStackInfo;
+    /**
+     * Shutdown analyzer resources
+     */
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=qaService.d.ts.map

package/dist/services/qa/qaService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qaService.d.ts","sourceRoot":"","sources":["../../../src/services/qa/qaService.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,OAAO,EAA+B,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAKzF;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,OAAO,EAAE,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,cAAc,EAAE,oBAAoB,CAAC;CACtC;AAED;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAmB;IACnC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,cAAc,CAAiB;gBAE3B,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE;IAO1C;;;;;OAKG;IACG,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAuDzE;;OAEG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IA0CxE;;OAEG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IA2BlD;;OAEG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAexE;;OAEG;YACW,kBAAkB;IAsGhC,OAAO,CAAC,4BAA4B;YA+EtB,8BAA8B;IA+C5C,OAAO,CAAC,yBAAyB;IAqBjC,OAAO,CAAC,0BAA0B;YAqBpB,qBAAqB;YAiDrB,wBAAwB;IA0BtC,OAAO,CAAC,kBAAkB;IAkB1B,OAAO,CAAC,sBAAsB;YAkBhB,0BAA0B;IAuBxC,OAAO,CAAC,qBAAqB;IA4B7B,OAAO,CAAC,2BAA2B;IAkBnC,OAAO,CAAC,qBAAqB;IAkB7B,OAAO,CAAC,sBAAsB;IAkB9B,OAAO,CAAC,4BAA4B;IAkBpC,OAAO,CAAC,wBAAwB;IAwBhC,OAAO,CAAC,eAAe;YAST,iBAAiB;YA+BjB,aAAa;IAmB3B,OAAO,CAAC,aAAa;IAqBrB,OAAO,CAAC,gBAAgB;IA2BxB,OAAO,CAAC,YAAY;IAgDpB,OAAO,CAAC,kBAAkB;IAkD1B;;OAEG;YACW,eAAe;IAe7B;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAmClC;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAGhC"}