specmem-hardwicksoftware 3.5.99

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

@@ -0,0 +1,284 @@
+/**
+ * Code Explanation System - Main Index
+ *
+ * Active recall system for storing and retrieving code explanations.
+ * Links code to prompts/conversations for contextual memory.
+ */
+export { initializeCodeExplanationSchema, schemaExists, getSchemaStats } from './schema.js';
+export * from './types.js';
+export { ExplainCode } from './explainCode.js';
+export { RecallCodeExplanation } from './recallExplanation.js';
+export { LinkCodeToPrompt } from './linkCodeToPrompt.js';
+export { GetRelatedCode } from './getRelatedCode.js';
+export { SemanticSearchExplanations } from './semanticSearch.js';
+export { ProvideFeedback, ExplanationLearningSystem } from './feedback.js';
+import { DatabaseManager } from '../database.js';
+import { EmbeddingProvider } from '../types/index.js';
+import { MCPTool } from '../mcp/toolRegistry.js';
+import { ExplanationLearningSystem } from './feedback.js';
+/**
+ * Code Explanation System Context
+ */
+export interface CodeExplanationContext {
+    tools: MCPTool[];
+    learningSystem: ExplanationLearningSystem;
+    initialized: boolean;
+}
+/**
+ * Initialize the Code Explanation System
+ *
+ * This sets up the schema and creates all tools for code explanations.
+ *
+ * @param db Database manager
+ * @param embeddingProvider Provider for generating embeddings
+ * @returns Context with tools and learning system
+ */
+export declare function initializeCodeExplanationSystem(db: DatabaseManager, embeddingProvider: EmbeddingProvider): Promise<CodeExplanationContext>;
+/**
+ * Create code explanation tools without initializing schema
+ * Use this when schema is already set up
+ */
+export declare function createCodeExplanationTools(db: DatabaseManager, embeddingProvider: EmbeddingProvider): MCPTool[];
+/**
+ * Tool API Documentation for Engineer 3
+ *
+ * This describes all tools provided by the Code Explanation System
+ * for integration into the monitoring dashboard.
+ */
+export declare const TOOL_API_DOCUMENTATION: {
+    name: string;
+    version: string;
+    description: string;
+    tools: ({
+        name: string;
+        description: string;
+        params: {
+            filePath: string;
+            lineStart: string;
+            lineEnd: string;
+            explanationType: string;
+            context: string;
+            forceRegenerate: string;
+            codeId?: undefined;
+            query?: undefined;
+            minQuality?: undefined;
+            limit?: undefined;
+            memoryId?: undefined;
+            relationshipType?: undefined;
+            strength?: undefined;
+            relationshipTypes?: undefined;
+            minStrength?: undefined;
+            threshold?: undefined;
+            explanationTypes?: undefined;
+            explanationId?: undefined;
+            positive?: undefined;
+        };
+        returns: {
+            success: string;
+            explanation: string;
+            wasReused: string;
+            message: string;
+            explanations?: undefined;
+            total?: undefined;
+            link?: undefined;
+            relatedCode?: undefined;
+            results?: undefined;
+            newQualityScore?: undefined;
+        };
+    } | {
+        name: string;
+        description: string;
+        params: {
+            codeId: string;
+            filePath: string;
+            query: string;
+            explanationType: string;
+            minQuality: string;
+            limit: string;
+            lineStart?: undefined;
+            lineEnd?: undefined;
+            context?: undefined;
+            forceRegenerate?: undefined;
+            memoryId?: undefined;
+            relationshipType?: undefined;
+            strength?: undefined;
+            relationshipTypes?: undefined;
+            minStrength?: undefined;
+            threshold?: undefined;
+            explanationTypes?: undefined;
+            explanationId?: undefined;
+            positive?: undefined;
+        };
+        returns: {
+            success: string;
+            explanations: string;
+            total: string;
+            message: string;
+            explanation?: undefined;
+            wasReused?: undefined;
+            link?: undefined;
+            relatedCode?: undefined;
+            results?: undefined;
+            newQualityScore?: undefined;
+        };
+    } | {
+        name: string;
+        description: string;
+        params: {
+            codeId: string;
+            filePath: string;
+            memoryId: string;
+            relationshipType: string;
+            context: string;
+            strength: string;
+            lineStart?: undefined;
+            lineEnd?: undefined;
+            explanationType?: undefined;
+            forceRegenerate?: undefined;
+            query?: undefined;
+            minQuality?: undefined;
+            limit?: undefined;
+            relationshipTypes?: undefined;
+            minStrength?: undefined;
+            threshold?: undefined;
+            explanationTypes?: undefined;
+            explanationId?: undefined;
+            positive?: undefined;
+        };
+        returns: {
+            success: string;
+            link: string;
+            message: string;
+            explanation?: undefined;
+            wasReused?: undefined;
+            explanations?: undefined;
+            total?: undefined;
+            relatedCode?: undefined;
+            results?: undefined;
+            newQualityScore?: undefined;
+        };
+    } | {
+        name: string;
+        description: string;
+        params: {
+            memoryId: string;
+            query: string;
+            relationshipTypes: string;
+            minStrength: string;
+            limit: string;
+            filePath?: undefined;
+            lineStart?: undefined;
+            lineEnd?: undefined;
+            explanationType?: undefined;
+            context?: undefined;
+            forceRegenerate?: undefined;
+            codeId?: undefined;
+            minQuality?: undefined;
+            relationshipType?: undefined;
+            strength?: undefined;
+            threshold?: undefined;
+            explanationTypes?: undefined;
+            explanationId?: undefined;
+            positive?: undefined;
+        };
+        returns: {
+            success: string;
+            relatedCode: string;
+            total: string;
+            message: string;
+            explanation?: undefined;
+            wasReused?: undefined;
+            explanations?: undefined;
+            link?: undefined;
+            results?: undefined;
+            newQualityScore?: undefined;
+        };
+    } | {
+        name: string;
+        description: string;
+        params: {
+            query: string;
+            limit: string;
+            threshold: string;
+            explanationTypes: string;
+            minQuality: string;
+            filePath?: undefined;
+            lineStart?: undefined;
+            lineEnd?: undefined;
+            explanationType?: undefined;
+            context?: undefined;
+            forceRegenerate?: undefined;
+            codeId?: undefined;
+            memoryId?: undefined;
+            relationshipType?: undefined;
+            strength?: undefined;
+            relationshipTypes?: undefined;
+            minStrength?: undefined;
+            explanationId?: undefined;
+            positive?: undefined;
+        };
+        returns: {
+            success: string;
+            results: string;
+            total: string;
+            message: string;
+            explanation?: undefined;
+            wasReused?: undefined;
+            explanations?: undefined;
+            link?: undefined;
+            relatedCode?: undefined;
+            newQualityScore?: undefined;
+        };
+    } | {
+        name: string;
+        description: string;
+        params: {
+            explanationId: string;
+            positive: string;
+            filePath?: undefined;
+            lineStart?: undefined;
+            lineEnd?: undefined;
+            explanationType?: undefined;
+            context?: undefined;
+            forceRegenerate?: undefined;
+            codeId?: undefined;
+            query?: undefined;
+            minQuality?: undefined;
+            limit?: undefined;
+            memoryId?: undefined;
+            relationshipType?: undefined;
+            strength?: undefined;
+            relationshipTypes?: undefined;
+            minStrength?: undefined;
+            threshold?: undefined;
+            explanationTypes?: undefined;
+        };
+        returns: {
+            success: string;
+            newQualityScore: string;
+            message: string;
+            explanation?: undefined;
+            wasReused?: undefined;
+            explanations?: undefined;
+            total?: undefined;
+            link?: undefined;
+            relatedCode?: undefined;
+            results?: undefined;
+        };
+    })[];
+    tables: {
+        code_explanations: {
+            description: string;
+            columns: string[];
+        };
+        code_prompt_links: {
+            description: string;
+            columns: string[];
+        };
+        code_access_patterns: {
+            description: string;
+            columns: string[];
+        };
+    };
+};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/code-explanations/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,+BAA+B,EAC/B,YAAY,EACZ,cAAc,EACf,MAAM,aAAa,CAAC;AAGrB,cAAc,YAAY,CAAC;AAG3B,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAG3E,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AASjD,OAAO,EAAmB,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,cAAc,EAAE,yBAAyB,CAAC;IAC1C,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;;GAQG;AACH,wBAAsB,+BAA+B,CACnD,EAAE,EAAE,eAAe,EACnB,iBAAiB,EAAE,iBAAiB,GACnC,OAAO,CAAC,sBAAsB,CAAC,CAqCjC;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,EAAE,EAAE,eAAe,EACnB,iBAAiB,EAAE,iBAAiB,GACnC,OAAO,EAAE,CASX;AAED;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkKlC,CAAC"}

package/dist/code-explanations/index.js

@@ -0,0 +1,249 @@
+/**
+ * Code Explanation System - Main Index
+ *
+ * Active recall system for storing and retrieving code explanations.
+ * Links code to prompts/conversations for contextual memory.
+ */
+// Schema
+export { initializeCodeExplanationSchema, schemaExists, getSchemaStats } from './schema.js';
+// Types
+export * from './types.js';
+// Tools
+export { ExplainCode } from './explainCode.js';
+export { RecallCodeExplanation } from './recallExplanation.js';
+export { LinkCodeToPrompt } from './linkCodeToPrompt.js';
+export { GetRelatedCode } from './getRelatedCode.js';
+export { SemanticSearchExplanations } from './semanticSearch.js';
+export { ProvideFeedback, ExplanationLearningSystem } from './feedback.js';
+import { logger } from '../utils/logger.js';
+import { initializeCodeExplanationSchema, schemaExists } from './schema.js';
+import { ExplainCode } from './explainCode.js';
+import { RecallCodeExplanation } from './recallExplanation.js';
+import { LinkCodeToPrompt } from './linkCodeToPrompt.js';
+import { GetRelatedCode } from './getRelatedCode.js';
+import { SemanticSearchExplanations } from './semanticSearch.js';
+import { ProvideFeedback, ExplanationLearningSystem } from './feedback.js';
+/**
+ * Initialize the Code Explanation System
+ *
+ * This sets up the schema and creates all tools for code explanations.
+ *
+ * @param db Database manager
+ * @param embeddingProvider Provider for generating embeddings
+ * @returns Context with tools and learning system
+ */
+export async function initializeCodeExplanationSystem(db, embeddingProvider) {
+    logger.info('Initializing Code Explanation System...');
+    // Check if schema already exists
+    const exists = await schemaExists(db);
+    if (!exists) {
+        // Create schema
+        await initializeCodeExplanationSchema(db);
+        logger.info('Code explanation schema created');
+    }
+    else {
+        logger.info('Code explanation schema already exists');
+    }
+    // Create tools
+    const tools = [
+        new ExplainCode(db, embeddingProvider),
+        new RecallCodeExplanation(db, embeddingProvider),
+        new LinkCodeToPrompt(db),
+        new GetRelatedCode(db, embeddingProvider),
+        new SemanticSearchExplanations(db, embeddingProvider),
+        new ProvideFeedback(db)
+    ];
+    // Create learning system
+    const learningSystem = new ExplanationLearningSystem(db);
+    logger.info({
+        toolCount: tools.length,
+        toolNames: tools.map(t => t.name)
+    }, 'Code Explanation System initialized');
+    return {
+        tools,
+        learningSystem,
+        initialized: true
+    };
+}
+/**
+ * Create code explanation tools without initializing schema
+ * Use this when schema is already set up
+ */
+export function createCodeExplanationTools(db, embeddingProvider) {
+    return [
+        new ExplainCode(db, embeddingProvider),
+        new RecallCodeExplanation(db, embeddingProvider),
+        new LinkCodeToPrompt(db),
+        new GetRelatedCode(db, embeddingProvider),
+        new SemanticSearchExplanations(db, embeddingProvider),
+        new ProvideFeedback(db)
+    ];
+}
+/**
+ * Tool API Documentation for Engineer 3
+ *
+ * This describes all tools provided by the Code Explanation System
+ * for integration into the monitoring dashboard.
+ */
+export const TOOL_API_DOCUMENTATION = {
+    name: 'Code Explanation System',
+    version: '1.0.0',
+    description: 'Active recall system for code explanations and prompt linking',
+    tools: [
+        {
+            name: 'explain_code',
+            description: 'Store an explanation for a code location',
+            params: {
+                filePath: 'string (required) - Path to the file',
+                lineStart: 'number (optional) - Starting line',
+                lineEnd: 'number (optional) - Ending line',
+                explanationType: 'string (optional) - Type of explanation',
+                context: 'string (optional) - Additional context',
+                forceRegenerate: 'boolean (optional) - Force new explanation'
+            },
+            returns: {
+                success: 'boolean',
+                explanation: 'CodeExplanation object',
+                wasReused: 'boolean',
+                message: 'string'
+            }
+        },
+        {
+            name: 'recall_code_explanation',
+            description: 'Retrieve stored code explanations',
+            params: {
+                codeId: 'string (optional) - UUID of code file',
+                filePath: 'string (optional) - File path pattern',
+                query: 'string (optional) - Semantic search query',
+                explanationType: 'string (optional) - Filter by type',
+                minQuality: 'number (optional) - Minimum quality score',
+                limit: 'number (optional) - Max results'
+            },
+            returns: {
+                success: 'boolean',
+                explanations: 'Array of CodeExplanation objects',
+                total: 'number',
+                message: 'string'
+            }
+        },
+        {
+            name: 'link_code_to_prompt',
+            description: 'Create a link between code and conversation memory',
+            params: {
+                codeId: 'string (optional) - UUID of code file',
+                filePath: 'string (optional) - File path',
+                memoryId: 'string (required) - UUID of memory',
+                relationshipType: 'string (optional) - Type of relationship',
+                context: 'string (optional) - Context about the link',
+                strength: 'number (optional) - Link strength (0-1)'
+            },
+            returns: {
+                success: 'boolean',
+                link: 'CodePromptLink object',
+                message: 'string'
+            }
+        },
+        {
+            name: 'get_related_code',
+            description: 'Find code related to a conversation or topic',
+            params: {
+                memoryId: 'string (optional) - UUID of memory',
+                query: 'string (optional) - Search query',
+                relationshipTypes: 'array (optional) - Filter by types',
+                minStrength: 'number (optional) - Minimum link strength',
+                limit: 'number (optional) - Max results'
+            },
+            returns: {
+                success: 'boolean',
+                relatedCode: 'Array of related code items',
+                total: 'number',
+                message: 'string'
+            }
+        },
+        {
+            name: 'semantic_search_explanations',
+            description: 'Search explanations using natural language',
+            params: {
+                query: 'string (required) - Natural language query',
+                limit: 'number (optional) - Max results',
+                threshold: 'number (optional) - Similarity threshold',
+                explanationTypes: 'array (optional) - Filter by types',
+                minQuality: 'number (optional) - Minimum quality'
+            },
+            returns: {
+                success: 'boolean',
+                results: 'Array of search results with similarity scores',
+                total: 'number',
+                message: 'string'
+            }
+        },
+        {
+            name: 'provide_explanation_feedback',
+            description: 'Provide feedback to improve explanation quality',
+            params: {
+                explanationId: 'string (required) - UUID of explanation',
+                positive: 'boolean (required) - Positive or negative feedback'
+            },
+            returns: {
+                success: 'boolean',
+                newQualityScore: 'number',
+                message: 'string'
+            }
+        }
+    ],
+    tables: {
+        code_explanations: {
+            description: 'Stores explanations for code locations',
+            columns: [
+                'id UUID PRIMARY KEY',
+                'code_id UUID REFERENCES codebase_files',
+                'file_path TEXT',
+                'line_start INTEGER',
+                'line_end INTEGER',
+                'code_snippet TEXT',
+                'explanation_text TEXT',
+                'explanation_type VARCHAR(50)',
+                'embedding vector(DYNAMIC)', // Dimension auto-detected from database
+                'quality_score FLOAT',
+                'use_count INTEGER',
+                'feedback_positive INTEGER',
+                'feedback_negative INTEGER',
+                'created_at TIMESTAMPTZ',
+                'updated_at TIMESTAMPTZ',
+                'created_by VARCHAR(100)',
+                'metadata JSONB'
+            ]
+        },
+        code_prompt_links: {
+            description: 'Links code to conversation memories',
+            columns: [
+                'id UUID PRIMARY KEY',
+                'code_id UUID REFERENCES codebase_files',
+                'memory_id UUID REFERENCES memories',
+                'explanation_id UUID REFERENCES code_explanations',
+                'relationship_type VARCHAR(50)',
+                'context TEXT',
+                'strength FLOAT',
+                'created_at TIMESTAMPTZ',
+                'metadata JSONB'
+            ]
+        },
+        code_access_patterns: {
+            description: 'Tracks access patterns for learning',
+            columns: [
+                'id UUID PRIMARY KEY',
+                'code_id UUID REFERENCES codebase_files',
+                'access_count INTEGER',
+                'last_accessed TIMESTAMPTZ',
+                'common_queries TEXT[]',
+                'query_embeddings JSONB',
+                'access_contexts TEXT[]',
+                'hourly_access_pattern INTEGER[]',
+                'daily_access_pattern INTEGER[]',
+                'first_accessed TIMESTAMPTZ',
+                'metadata JSONB'
+            ]
+        }
+    }
+};
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,79 @@
+/**
+ * link_code_to_prompt - Associate code with conversation context
+ *
+ * Creates relationships between code files and memories/prompts
+ * to enable active recall of relevant code during conversations.
+ */
+import { MCPTool } from '../mcp/toolRegistry.js';
+import { DatabaseManager } from '../database.js';
+import { LinkCodeToPromptParams, LinkCodeResult } from './types.js';
+/**
+ * LinkCodeToPrompt - Create code-to-conversation links
+ *
+ * Features:
+ * - Multiple relationship types
+ * - Strength scoring
+ * - Context preservation
+ * - Duplicate prevention
+ */
+export declare class LinkCodeToPrompt implements MCPTool<LinkCodeToPromptParams, LinkCodeResult> {
+    private db;
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            codeId: {
+                type: string;
+                format: string;
+                description: string;
+            };
+            filePath: {
+                type: string;
+                description: string;
+            };
+            memoryId: {
+                type: string;
+                format: string;
+                description: string;
+            };
+            relationshipType: {
+                type: string;
+                enum: string[];
+                default: string;
+                description: string;
+            };
+            context: {
+                type: string;
+                description: string;
+            };
+            strength: {
+                type: string;
+                minimum: number;
+                maximum: number;
+                default: number;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    constructor(db: DatabaseManager);
+    execute(params: LinkCodeToPromptParams): Promise<LinkCodeResult>;
+    /**
+     * Find code file by path
+     */
+    private findCodeFileByPath;
+    /**
+     * Verify memory exists
+     */
+    private verifyMemoryExists;
+    /**
+     * Find existing link
+     */
+    private findExistingLink;
+    /**
+     * Update existing link strength
+     */
+    private updateLinkStrength;
+}
+//# sourceMappingURL=linkCodeToPrompt.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"linkCodeToPrompt.d.ts","sourceRoot":"","sources":["../../src/code-explanations/linkCodeToPrompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,EAEL,sBAAsB,EACtB,cAAc,EAGf,MAAM,YAAY,CAAC;AAEpB;;;;;;;;GAQG;AACH,qBAAa,gBAAiB,YAAW,OAAO,CAAC,sBAAsB,EAAE,cAAc,CAAC;IAoD1E,OAAO,CAAC,EAAE;IAnDtB,IAAI,SAAyB;IAC7B,WAAW,SAS+B;IAE1C,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAqCT;gBAEkB,EAAE,EAAE,eAAe;IAEjC,OAAO,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,cAAc,CAAC;IAmHtE;;OAEG;YACW,kBAAkB;IAWhC;;OAEG;YACW,kBAAkB;IAShC;;OAEG;YACW,gBAAgB;IAwC9B;;OAEG;YACW,kBAAkB;CAajC"}