specmem-hardwicksoftware 3.5.99

package/dist/code-explanations/feedback.js

@@ -0,0 +1,212 @@
+/**
+ * provide_explanation_feedback - Improve explanations through feedback
+ *
+ * Allows  to provide feedback on explanations to improve
+ * quality scores over time. Good explanations get reused more often.
+ */
+import { logger } from '../utils/logger.js';
+import { ProvideFeedbackInput } from './types.js';
+/**
+ * ProvideFeedback - Improve explanations through feedback
+ *
+ * Features:
+ * - Positive/negative feedback tracking
+ * - Automatic quality score adjustment
+ * - Learning from usage patterns
+ */
+export class ProvideFeedback {
+    db;
+    name = 'provide_explanation_feedback';
+    description = `Provide feedback on a code explanation to help improve it over time.
+Positive feedback increases the quality score, making it more likely to be reused.
+Negative feedback decreases the score, potentially triggering regeneration.`;
+    inputSchema = {
+        type: 'object',
+        properties: {
+            explanationId: {
+                type: 'string',
+                format: 'uuid',
+                description: 'UUID of the explanation to provide feedback for'
+            },
+            positive: {
+                type: 'boolean',
+                description: 'True for positive feedback, false for negative'
+            }
+        },
+        required: ['explanationId', 'positive']
+    };
+    constructor(db) {
+        this.db = db;
+    }
+    async execute(params) {
+        const validatedParams = ProvideFeedbackInput.parse(params);
+        logger.debug({
+            explanationId: validatedParams.explanationId,
+            positive: validatedParams.positive
+        }, 'Processing explanation feedback');
+        try {
+            // Update feedback count
+            const column = validatedParams.positive ? 'feedback_positive' : 'feedback_negative';
+            const result = await this.db.query(`UPDATE code_explanations
+         SET ${column} = ${column} + 1
+         WHERE id = $1
+         RETURNING quality_score, feedback_positive, feedback_negative`, [validatedParams.explanationId]);
+            if (result.rows.length === 0) {
+                return {
+                    success: false,
+                    newQualityScore: 0,
+                    message: `Explanation ${validatedParams.explanationId} not found`
+                };
+            }
+            const row = result.rows[0];
+            logger.info({
+                explanationId: validatedParams.explanationId,
+                positive: validatedParams.positive,
+                newQualityScore: row.quality_score,
+                totalPositive: row.feedback_positive,
+                totalNegative: row.feedback_negative
+            }, 'Feedback recorded');
+            return {
+                success: true,
+                newQualityScore: row.quality_score,
+                message: `Feedback recorded. Quality score: ${row.quality_score.toFixed(2)} ` +
+                    `(${row.feedback_positive}+ / ${row.feedback_negative}-)`
+            };
+        }
+        catch (error) {
+            logger.error({ error, explanationId: validatedParams.explanationId }, 'Feedback failed');
+            return {
+                success: false,
+                newQualityScore: 0,
+                message: error instanceof Error ? error.message : 'Failed to record feedback'
+            };
+        }
+    }
+}
+/**
+ * Learning system for improving explanations over time
+ *
+ * Tracks:
+ * - Common queries that lead to code
+ * - Access patterns (time of day, day of week)
+ * - Explanation effectiveness (use count vs feedback ratio)
+ */
+export class ExplanationLearningSystem {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /**
+     * Get insights about code access patterns
+     */
+    async getAccessInsights(codeId) {
+        const result = await this.db.query(`SELECT * FROM code_access_patterns WHERE code_id = $1`, [codeId]);
+        if (result.rows.length === 0) {
+            return {
+                accessCount: 0,
+                commonQueries: [],
+                peakHours: [],
+                peakDays: [],
+                averageQuality: 0
+            };
+        }
+        const row = result.rows[0];
+        // Find peak hours (top 3)
+        const hourlyPattern = row.hourly_access_pattern || Array(24).fill(0);
+        const peakHours = hourlyPattern
+            .map((count, hour) => ({ hour, count }))
+            .sort((a, b) => b.count - a.count)
+            .slice(0, 3)
+            .filter((h) => h.count > 0)
+            .map((h) => h.hour);
+        // Find peak days
+        const dailyPattern = row.daily_access_pattern || Array(7).fill(0);
+        const dayNames = ['Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday'];
+        const peakDays = dailyPattern
+            .map((count, day) => ({ day: dayNames[day], count }))
+            .sort((a, b) => b.count - a.count)
+            .slice(0, 3)
+            .filter((d) => d.count > 0)
+            .map((d) => d.day);
+        // Get average quality of explanations for this code
+        const qualityResult = await this.db.query(`SELECT AVG(quality_score) as avg_quality
+       FROM code_explanations
+       WHERE code_id = $1`, [codeId]);
+        return {
+            accessCount: row.access_count,
+            commonQueries: (row.common_queries || []).slice(-10),
+            peakHours,
+            peakDays,
+            averageQuality: qualityResult.rows[0]?.avg_quality ?? 0
+        };
+    }
+    /**
+     * Identify explanations that need improvement
+     */
+    async findExplanationsNeedingImprovement(limit = 10) {
+        // Find explanations with low quality but high use count
+        const result = await this.db.query(`SELECT id, file_path, explanation_type, quality_score, use_count,
+              feedback_negative, feedback_positive
+       FROM code_explanations
+       WHERE quality_score < 0.5
+       AND (use_count > 5 OR feedback_negative > feedback_positive)
+       ORDER BY use_count DESC, quality_score ASC
+       LIMIT $1`, [limit]);
+        return result.rows.map((row) => ({
+            id: row.id,
+            filePath: row.file_path,
+            explanationType: row.explanation_type,
+            qualityScore: row.quality_score,
+            useCount: row.use_count,
+            reason: row.feedback_negative > row.feedback_positive
+                ? 'More negative than positive feedback'
+                : `Low quality (${row.quality_score.toFixed(2)}) but frequently used (${row.use_count}x)`
+        }));
+    }
+    /**
+     * Get learning statistics
+     */
+    async getLearningStats() {
+        const [totalResult, feedbackResult, accessResult, typeResult] = await Promise.all([
+            this.db.query(`
+        SELECT COUNT(*) as count, AVG(quality_score) as avg_quality
+        FROM code_explanations
+      `),
+            this.db.query(`
+        SELECT
+          SUM(feedback_positive + feedback_negative) as total,
+          SUM(feedback_positive) as positive
+        FROM code_explanations
+      `),
+            this.db.query(`
+        SELECT cf.file_path, SUM(cap.access_count) as total_access
+        FROM code_access_patterns cap
+        JOIN codebase_files cf ON cap.code_id = cf.id
+        GROUP BY cf.file_path
+        ORDER BY total_access DESC
+        LIMIT 10
+      `),
+            this.db.query(`
+        SELECT explanation_type, COUNT(*) as count
+        FROM code_explanations
+        GROUP BY explanation_type
+      `)
+        ]);
+        const totalRow = totalResult.rows[0];
+        const feedbackRow = feedbackResult.rows[0];
+        return {
+            totalExplanations: parseInt(totalRow?.count ?? '0', 10),
+            averageQuality: totalRow?.avg_quality ?? 0,
+            totalFeedback: feedbackRow?.total ?? 0,
+            positiveFeedbackRate: feedbackRow?.total
+                ? (feedbackRow.positive ?? 0) / feedbackRow.total
+                : 0,
+            mostAccessedFiles: accessResult.rows.map((r) => ({
+                filePath: r.file_path,
+                accessCount: r.total_access
+            })),
+            explanationTypeDistribution: Object.fromEntries(typeResult.rows.map((r) => [r.explanation_type, r.count]))
+        };
+    }
+}
+//# sourceMappingURL=feedback.js.map

package/dist/code-explanations/feedback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.js","sourceRoot":"","sources":["../../src/code-explanations/feedback.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EACL,oBAAoB,EAGrB,MAAM,YAAY,CAAC;AAEpB;;;;;;;GAOG;AACH,MAAM,OAAO,eAAe;IAsBN;IArBpB,IAAI,GAAG,8BAA8B,CAAC;IACtC,WAAW,GAAG;;4EAE4D,CAAC;IAE3E,WAAW,GAAG;QACZ,IAAI,EAAE,QAAiB;QACvB,UAAU,EAAE;YACV,aAAa,EAAE;gBACb,IAAI,EAAE,QAAQ;gBACd,MAAM,EAAE,MAAM;gBACd,WAAW,EAAE,iDAAiD;aAC/D;YACD,QAAQ,EAAE;gBACR,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,gDAAgD;aAC9D;SACF;QACD,QAAQ,EAAE,CAAC,eAAe,EAAE,UAAU,CAAC;KACxC,CAAC;IAEF,YAAoB,EAAmB;QAAnB,OAAE,GAAF,EAAE,CAAiB;IAAG,CAAC;IAE3C,KAAK,CAAC,OAAO,CAAC,MAA6B;QACzC,MAAM,eAAe,GAAG,oBAAoB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAE3D,MAAM,CAAC,KAAK,CAAC;YACX,aAAa,EAAE,eAAe,CAAC,aAAa;YAC5C,QAAQ,EAAE,eAAe,CAAC,QAAQ;SACnC,EAAE,iCAAiC,CAAC,CAAC;QAEtC,IAAI,CAAC;YACH,wBAAwB;YACxB,MAAM,MAAM,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,mBAAmB,CAAC;YAEpF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,KAAK,CAKhC;eACO,MAAM,MAAM,MAAM;;uEAEsC,EAC/D,CAAC,eAAe,CAAC,aAAa,CAAC,CAChC,CAAC;YAEF,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC7B,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,eAAe,EAAE,CAAC;oBAClB,OAAO,EAAE,eAAe,eAAe,CAAC,aAAa,YAAY;iBAClE,CAAC;YACJ,CAAC;YAED,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC;YAE5B,MAAM,CAAC,IAAI,CAAC;gBACV,aAAa,EAAE,eAAe,CAAC,aAAa;gBAC5C,QAAQ,EAAE,eAAe,CAAC,QAAQ;gBAClC,eAAe,EAAE,GAAG,CAAC,aAAa;gBAClC,aAAa,EAAE,GAAG,CAAC,iBAAiB;gBACpC,aAAa,EAAE,GAAG,CAAC,iBAAiB;aACrC,EAAE,mBAAmB,CAAC,CAAC;YAExB,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,eAAe,EAAE,GAAG,CAAC,aAAa;gBAClC,OAAO,EAAE,qCAAqC,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG;oBAC3E,IAAI,GAAG,CAAC,iBAAiB,OAAO,GAAG,CAAC,iBAAiB,IAAI;aAC5D,CAAC;QAEJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,eAAe,CAAC,aAAa,EAAE,EAAE,iBAAiB,CAAC,CAAC;YACzF,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,eAAe,EAAE,CAAC;gBAClB,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,2BAA2B;aAC9E,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AAED;;;;;;;GAOG;AACH,MAAM,OAAO,yBAAyB;IAChB;IAApB,YAAoB,EAAmB;QAAnB,OAAE,GAAF,EAAE,CAAiB;IAAG,CAAC;IAE3C;;OAEG;IACH,KAAK,CAAC,iBAAiB,CAAC,MAAc;QAOpC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,KAAK,CAMhC,uDAAuD,EACvD,CAAC,MAAM,CAAC,CACT,CAAC;QAEF,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,OAAO;gBACL,WAAW,EAAE,CAAC;gBACd,aAAa,EAAE,EAAE;gBACjB,SAAS,EAAE,EAAE;gBACb,QAAQ,EAAE,EAAE;gBACZ,cAAc,EAAE,CAAC;aAClB,CAAC;QACJ,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC;QAE5B,0BAA0B;QAC1B,MAAM,aAAa,GAAa,GAAG,CAAC,qBAAqB,IAAI,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC/E,MAAM,SAAS,GAAG,aAAa;aAC5B,GAAG,CAAC,CAAC,KAAa,EAAE,IAAY,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;aACvD,IAAI,CAAC,CAAC,CAAkC,EAAE,CAAkC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;aACnG,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;aACX,MAAM,CAAC,CAAC,CAAkC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;aAC3D,GAAG,CAAC,CAAC,CAAkC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAEvD,iBAAiB;QACjB,MAAM,YAAY,GAAa,GAAG,CAAC,oBAAoB,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC5E,MAAM,QAAQ,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;QAChG,MAAM,QAAQ,GAAG,YAAY;aAC1B,GAAG,CAAC,CAAC,KAAa,EAAE,GAAW,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,GAAG,CAAE,EAAE,KAAK,EAAE,CAAC,CAAC;aACrE,IAAI,CAAC,CAAC,CAAiC,EAAE,CAAiC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;aACjG,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;aACX,MAAM,CAAC,CAAC,CAAiC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;aAC1D,GAAG,CAAC,CAAC,CAAiC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAErD,oDAAoD;QACpD,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,KAAK,CACvC;;0BAEoB,EACpB,CAAC,MAAM,CAAC,CACT,CAAC;QAEF,OAAO;YACL,WAAW,EAAE,GAAG,CAAC,YAAY;YAC7B,aAAa,EAAE,CAAC,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YACpD,SAAS;YACT,QAAQ;YACR,cAAc,EAAE,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,WAAW,IAAI,CAAC;SACxD,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,kCAAkC,CAAC,QAAgB,EAAE;QAQzD,wDAAwD;QACxD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,KAAK,CAShC;;;;;;gBAMU,EACV,CAAC,KAAK,CAAC,CACR,CAAC;QAEF,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAQ,EAAE,EAAE,CAAC,CAAC;YACpC,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,QAAQ,EAAE,GAAG,CAAC,SAAS;YACvB,eAAe,EAAE,GAAG,CAAC,gBAAgB;YACrC,YAAY,EAAE,GAAG,CAAC,aAAa;YAC/B,QAAQ,EAAE,GAAG,CAAC,SAAS;YACvB,MAAM,EAAE,GAAG,CAAC,iBAAiB,GAAG,GAAG,CAAC,iBAAiB;gBACnD,CAAC,CAAC,sCAAsC;gBACxC,CAAC,CAAC,gBAAgB,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,0BAA0B,GAAG,CAAC,SAAS,IAAI;SAC5F,CAAC,CAAC,CAAC;IACN,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB;QAQpB,MAAM,CACJ,WAAW,EACX,cAAc,EACd,YAAY,EACZ,UAAU,CACX,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACpB,IAAI,CAAC,EAAE,CAAC,KAAK,CAAyC;;;OAGrD,CAAC;YACF,IAAI,CAAC,EAAE,CAAC,KAAK,CAAsC;;;;;OAKlD,CAAC;YACF,IAAI,CAAC,EAAE,CAAC,KAAK,CAA8C;;;;;;;OAO1D,CAAC;YACF,IAAI,CAAC,EAAE,CAAC,KAAK,CAA8C;;;;OAI1D,CAAC;SACH,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrC,MAAM,WAAW,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAE3C,OAAO;YACL,iBAAiB,EAAE,QAAQ,CAAC,QAAQ,EAAE,KAAK,IAAI,GAAG,EAAE,EAAE,CAAC;YACvD,cAAc,EAAE,QAAQ,EAAE,WAAW,IAAI,CAAC;YAC1C,aAAa,EAAE,WAAW,EAAE,KAAK,IAAI,CAAC;YACtC,oBAAoB,EAAE,WAAW,EAAE,KAAK;gBACtC,CAAC,CAAC,CAAC,WAAW,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,WAAW,CAAC,KAAK;gBACjD,CAAC,CAAC,CAAC;YACL,iBAAiB,EAAE,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC;gBACpD,QAAQ,EAAE,CAAC,CAAC,SAAS;gBACrB,WAAW,EAAE,CAAC,CAAC,YAAY;aAC5B,CAAC,CAAC;YACH,2BAA2B,EAAE,MAAM,CAAC,WAAW,CAC7C,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,gBAAgB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAC/D;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/code-explanations/getRelatedCode.d.ts

@@ -0,0 +1,80 @@
+/**
+ * get_related_code - Find code related to a prompt or memory
+ *
+ * Uses the link system to find code that has been associated
+ * with specific conversations or topics.
+ */
+import { MCPTool } from '../mcp/toolRegistry.js';
+import { DatabaseManager } from '../database.js';
+import { EmbeddingProvider } from '../types/index.js';
+import { GetRelatedCodeParams, RelatedCodeResult } from './types.js';
+/**
+ * GetRelatedCode - Find code related to conversations
+ *
+ * Features:
+ * - Find by memory ID
+ * - Semantic search by query
+ * - Filter by relationship type
+ * - Strength-based ranking
+ */
+export declare class GetRelatedCode implements MCPTool<GetRelatedCodeParams, RelatedCodeResult> {
+    private db;
+    private embeddingProvider;
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            memoryId: {
+                type: string;
+                format: string;
+                description: string;
+            };
+            query: {
+                type: string;
+                description: string;
+            };
+            relationshipTypes: {
+                type: string;
+                items: {
+                    type: string;
+                    enum: string[];
+                };
+                description: string;
+            };
+            minStrength: {
+                type: string;
+                minimum: number;
+                maximum: number;
+                default: number;
+                description: string;
+            };
+            limit: {
+                type: string;
+                minimum: number;
+                maximum: number;
+                default: number;
+                description: string;
+            };
+        };
+    };
+    constructor(db: DatabaseManager, embeddingProvider: EmbeddingProvider);
+    execute(params: GetRelatedCodeParams): Promise<RelatedCodeResult>;
+    /**
+     * Find code by memory ID
+     */
+    private findByMemoryId;
+    /**
+     * Semantic search for related code
+     */
+    private semanticSearch;
+    /**
+     * Text-based search fallback
+     */
+    private textSearch;
+    /**
+     * Update access patterns for found code
+     */
+    private updateAccessPatterns;
+}
+//# sourceMappingURL=getRelatedCode.d.ts.map

package/dist/code-explanations/getRelatedCode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getRelatedCode.d.ts","sourceRoot":"","sources":["../../src/code-explanations/getRelatedCode.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EAEL,oBAAoB,EACpB,iBAAiB,EAElB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;GAQG;AACH,qBAAa,cAAe,YAAW,OAAO,CAAC,oBAAoB,EAAE,iBAAiB,CAAC;IA+CnF,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,iBAAiB;IA/C3B,IAAI,SAAsB;IAC1B,WAAW,SAIyC;IAEpD,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAoCT;gBAGQ,EAAE,EAAE,eAAe,EACnB,iBAAiB,EAAE,iBAAiB;IAGxC,OAAO,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAgEvE;;OAEG;YACW,cAAc;IA0D5B;;OAEG;YACW,cAAc;IAuE5B;;OAEG;YACW,UAAU;IA4DxB;;OAEG;YACW,oBAAoB;CAgCnC"}

package/dist/code-explanations/getRelatedCode.js

@@ -0,0 +1,262 @@
+/**
+ * get_related_code - Find code related to a prompt or memory
+ *
+ * Uses the link system to find code that has been associated
+ * with specific conversations or topics.
+ */
+import { logger } from '../utils/logger.js';
+import { GetRelatedCodeInput } from './types.js';
+/**
+ * GetRelatedCode - Find code related to conversations
+ *
+ * Features:
+ * - Find by memory ID
+ * - Semantic search by query
+ * - Filter by relationship type
+ * - Strength-based ranking
+ */
+export class GetRelatedCode {
+    db;
+    embeddingProvider;
+    name = 'get_related_code';
+    description = `Find code related to a conversation or topic. Search by:
+- memoryId: Find code linked to a specific memory/prompt
+- query: Semantic search for related code
+- relationshipTypes: Filter by relationship type(s)
+- minStrength: Filter by minimum link strength (0-1)`;
+    inputSchema = {
+        type: 'object',
+        properties: {
+            memoryId: {
+                type: 'string',
+                format: 'uuid',
+                description: 'UUID of the memory to find related code for'
+            },
+            query: {
+                type: 'string',
+                description: 'Semantic search query to find related code'
+            },
+            relationshipTypes: {
+                type: 'array',
+                items: {
+                    type: 'string',
+                    enum: ['referenced', 'explained', 'modified', 'debugged', 'created',
+                        'related', 'imported', 'depends_on', 'tested']
+                },
+                description: 'Filter by relationship type(s)'
+            },
+            minStrength: {
+                type: 'number',
+                minimum: 0,
+                maximum: 1,
+                default: 0.5,
+                description: 'Minimum link strength (0-1)'
+            },
+            limit: {
+                type: 'number',
+                minimum: 1,
+                maximum: 100,
+                default: 10,
+                description: 'Maximum results to return'
+            }
+        }
+    };
+    constructor(db, embeddingProvider) {
+        this.db = db;
+        this.embeddingProvider = embeddingProvider;
+    }
+    async execute(params) {
+        const validatedParams = GetRelatedCodeInput.parse(params);
+        logger.debug({
+            memoryId: validatedParams.memoryId,
+            query: validatedParams.query
+        }, 'Finding related code');
+        try {
+            let results;
+            if (validatedParams.memoryId) {
+                // Find by memory ID
+                results = await this.findByMemoryId(validatedParams.memoryId, validatedParams.relationshipTypes, validatedParams.minStrength, validatedParams.limit);
+            }
+            else if (validatedParams.query) {
+                // Semantic search
+                results = await this.semanticSearch(validatedParams.query, validatedParams.relationshipTypes, validatedParams.minStrength, validatedParams.limit);
+            }
+            else {
+                results = [];
+            }
+            // Update access patterns for found code
+            const codeIds = results.map(r => r.codeId).filter(Boolean);
+            if (codeIds.length > 0) {
+                await this.updateAccessPatterns(codeIds, validatedParams.query);
+            }
+            logger.info({ resultCount: results.length }, 'Found related code');
+            return {
+                success: true,
+                relatedCode: results,
+                total: results.length,
+                message: `Found ${results.length} related code file(s)`
+            };
+        }
+        catch (error) {
+            logger.error({ error, params: validatedParams }, 'Failed to find related code');
+            return {
+                success: false,
+                relatedCode: [],
+                total: 0,
+                message: error instanceof Error ? error.message : 'Failed to find related code'
+            };
+        }
+    }
+    /**
+     * Find code by memory ID
+     */
+    async findByMemoryId(memoryId, relationshipTypes, minStrength = 0.5, limit = 10) {
+        let query = `
+      SELECT
+        cpl.code_id,
+        COALESCE(cf.file_path, (cpl.metadata->>'filePath')::text) as file_path,
+        cpl.relationship_type,
+        cpl.strength,
+        cpl.context,
+        ce.explanation_text
+      FROM code_prompt_links cpl
+      LEFT JOIN codebase_files cf ON cpl.code_id = cf.id
+      LEFT JOIN code_explanations ce ON cpl.explanation_id = ce.id
+      WHERE cpl.memory_id = $1
+      AND cpl.strength >= $2
+    `;
+        const values = [memoryId, minStrength];
+        let paramIndex = 3;
+        if (relationshipTypes && relationshipTypes.length > 0) {
+            query += ` AND cpl.relationship_type = ANY($${paramIndex++})`;
+            values.push(relationshipTypes);
+        }
+        query += ` ORDER BY cpl.strength DESC LIMIT $${paramIndex}`;
+        values.push(limit);
+        const result = await this.db.query(query, values);
+        return result.rows.map((row) => ({
+            codeId: row.code_id,
+            filePath: row.file_path,
+            relationshipType: row.relationship_type,
+            strength: row.strength,
+            context: row.context ?? undefined,
+            explanation: row.explanation_text ?? undefined
+        }));
+    }
+    /**
+     * Semantic search for related code
+     */
+    async semanticSearch(query, relationshipTypes, minStrength = 0.5, limit = 10) {
+        // Generate embedding for query
+        const queryEmbedding = await this.embeddingProvider.generateEmbedding(query);
+        if (!queryEmbedding || queryEmbedding.length === 0) {
+            return this.textSearch(query, relationshipTypes, minStrength, limit);
+        }
+        const embeddingStr = `[${queryEmbedding.join(',')}]`;
+        // Search through code explanations first
+        let searchQuery = `
+      SELECT DISTINCT ON (cf.id)
+        cf.id as code_id,
+        cf.file_path,
+        'related' as relationship_type,
+        (1 - (ce.embedding <=> $1::vector)) as strength,
+        ce.explanation_text,
+        NULL as context
+      FROM code_explanations ce
+      JOIN codebase_files cf ON ce.code_id = cf.id
+      WHERE ce.embedding IS NOT NULL
+      AND (1 - (ce.embedding <=> $1::vector)) >= $2
+    `;
+        const values = [embeddingStr, minStrength];
+        let paramIndex = 3;
+        if (relationshipTypes && relationshipTypes.length > 0) {
+            // For semantic search, we use the explanation results but can still filter
+            searchQuery += ` AND 'related' = ANY($${paramIndex++})`;
+            values.push(relationshipTypes);
+        }
+        searchQuery += `
+      ORDER BY cf.id, strength DESC
+      LIMIT $${paramIndex}
+    `;
+        values.push(limit);
+        const result = await this.db.query(searchQuery, values);
+        return result.rows.map((row) => ({
+            codeId: row.code_id,
+            filePath: row.file_path,
+            relationshipType: row.relationship_type,
+            strength: row.strength,
+            explanation: row.explanation_text ?? undefined,
+            context: row.context ?? undefined
+        }));
+    }
+    /**
+     * Text-based search fallback
+     */
+    async textSearch(query, relationshipTypes, minStrength = 0.5, limit = 10) {
+        let searchQuery = `
+      SELECT DISTINCT ON (cf.id)
+        cf.id as code_id,
+        cf.file_path,
+        'related' as relationship_type,
+        ts_rank(to_tsvector('english', ce.explanation_text), plainto_tsquery('english', $1)) as strength,
+        ce.explanation_text,
+        NULL as context
+      FROM code_explanations ce
+      JOIN codebase_files cf ON ce.code_id = cf.id
+      WHERE to_tsvector('english', ce.explanation_text) @@ plainto_tsquery('english', $1)
+      AND ts_rank(to_tsvector('english', ce.explanation_text), plainto_tsquery('english', $1)) >= $2
+    `;
+        const values = [query, minStrength];
+        let paramIndex = 3;
+        if (relationshipTypes && relationshipTypes.length > 0) {
+            searchQuery += ` AND 'related' = ANY($${paramIndex++})`;
+            values.push(relationshipTypes);
+        }
+        searchQuery += `
+      ORDER BY cf.id, strength DESC
+      LIMIT $${paramIndex}
+    `;
+        values.push(limit);
+        const result = await this.db.query(searchQuery, values);
+        return result.rows.map((row) => ({
+            codeId: row.code_id,
+            filePath: row.file_path,
+            relationshipType: row.relationship_type,
+            strength: row.strength,
+            explanation: row.explanation_text ?? undefined,
+            context: row.context ?? undefined
+        }));
+    }
+    /**
+     * Update access patterns for found code
+     */
+    async updateAccessPatterns(codeIds, query) {
+        const hour = new Date().getHours();
+        const day = new Date().getDay();
+        for (const codeId of codeIds) {
+            await this.db.query(`INSERT INTO code_access_patterns (code_id, access_count, last_accessed, common_queries)
+         VALUES ($1, 1, NOW(), $2)
+         ON CONFLICT (code_id) DO UPDATE SET
+           access_count = code_access_patterns.access_count + 1,
+           last_accessed = NOW(),
+           common_queries = CASE
+             WHEN $3::text IS NOT NULL AND $3 != ''
+             THEN array_append(
+               (SELECT common_queries[array_length(common_queries, 1) - 9:array_length(common_queries, 1)]
+                FROM code_access_patterns WHERE code_id = $1),
+               $3
+             )
+             ELSE code_access_patterns.common_queries
+           END,
+           hourly_access_pattern[$4] = code_access_patterns.hourly_access_pattern[$4] + 1,
+           daily_access_pattern[$5] = code_access_patterns.daily_access_pattern[$5] + 1`, [
+                codeId,
+                query ? [query] : [],
+                query ?? null,
+                hour + 1,
+                day + 1
+            ]);
+        }
+    }
+}
+//# sourceMappingURL=getRelatedCode.js.map

package/dist/code-explanations/getRelatedCode.js.map

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