specmem-hardwicksoftware 3.5.99

package/dist/cli/deploy-to-claude.js.map

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

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

@@ -0,0 +1,86 @@
+/**
+ * explain_code - Generate and store explanations for code
+ *
+ * This tool takes a code location, generates an explanation, and stores it
+ * for future recall. It supports different explanation types and can
+ * reuse existing high-quality explanations.
+ */
+import { MCPTool } from '../mcp/toolRegistry.js';
+import { DatabaseManager } from '../database.js';
+import { EmbeddingProvider } from '../types/index.js';
+import { ExplainCodeParams, ExplainCodeResult } from './types.js';
+/**
+ * ExplainCode - Store and manage code explanations
+ *
+ * Features:
+ * - Generate explanations for code locations
+ * - Reuse existing high-quality explanations
+ * - Track explanation usage
+ * - Support multiple explanation types
+ */
+export declare class ExplainCode implements MCPTool<ExplainCodeParams, ExplainCodeResult> {
+    private db;
+    private embeddingProvider;
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            filePath: {
+                type: string;
+                description: string;
+            };
+            lineStart: {
+                type: string;
+                description: string;
+            };
+            lineEnd: {
+                type: string;
+                description: string;
+            };
+            explanationType: {
+                type: string;
+                enum: string[];
+                default: string;
+                description: string;
+            };
+            context: {
+                type: string;
+                description: string;
+            };
+            forceRegenerate: {
+                type: string;
+                default: boolean;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    constructor(db: DatabaseManager, embeddingProvider: EmbeddingProvider);
+    execute(params: ExplainCodeParams): Promise<ExplainCodeResult>;
+    /**
+     * Find existing explanation for the same location
+     */
+    private findExistingExplanation;
+    /**
+     * Find code file by path
+     */
+    private findCodeFile;
+    /**
+     * Extract code snippet from file
+     */
+    private extractCodeSnippet;
+    /**
+     * Create text for embedding generation
+     */
+    private createEmbeddingText;
+    /**
+     * Increment use count for an explanation
+     */
+    private incrementUseCount;
+    /**
+     * Update access pattern for code file
+     */
+    private updateAccessPattern;
+}
+//# sourceMappingURL=explainCode.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"explainCode.d.ts","sourceRoot":"","sources":["../../src/code-explanations/explainCode.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,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,iBAAiB,EACjB,iBAAiB,EAGlB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;GAQG;AACH,qBAAa,WAAY,YAAW,OAAO,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;IAkD7E,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,iBAAiB;IAlD3B,IAAI,SAAkB;IACtB,WAAW,SAUqB;IAEhC,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAiCT;gBAGQ,EAAE,EAAE,eAAe,EACnB,iBAAiB,EAAE,iBAAiB;IAGxC,OAAO,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA4IpE;;OAEG;YACW,uBAAuB;IAyDrC;;OAEG;YACW,YAAY;IAW1B;;OAEG;YACW,kBAAkB;IAmBhC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAiB3B;;OAEG;YACW,iBAAiB;IAS/B;;OAEG;YACW,mBAAmB;CA8BlC"}

package/dist/code-explanations/explainCode.js

@@ -0,0 +1,286 @@
+/**
+ * explain_code - Generate and store explanations for code
+ *
+ * This tool takes a code location, generates an explanation, and stores it
+ * for future recall. It supports different explanation types and can
+ * reuse existing high-quality explanations.
+ */
+import { v4 as uuidv4 } from 'uuid';
+import { logger } from '../utils/logger.js';
+import { ExplainCodeInput } from './types.js';
+/**
+ * ExplainCode - Store and manage code explanations
+ *
+ * Features:
+ * - Generate explanations for code locations
+ * - Reuse existing high-quality explanations
+ * - Track explanation usage
+ * - Support multiple explanation types
+ */
+export class ExplainCode {
+    db;
+    embeddingProvider;
+    name = 'explain_code';
+    description = `Store an explanation for a code location. Supports different explanation types:
+- general: What the code does
+- architectural: How it fits in the system
+- algorithmic: Algorithm details
+- usage: How to use it
+- gotchas: Pitfalls and edge cases
+- performance: Performance notes
+- security: Security implications
+- debugging: Debug tips
+- history: Why it exists
+- todo: Things needing attention`;
+    inputSchema = {
+        type: 'object',
+        properties: {
+            filePath: {
+                type: 'string',
+                description: 'Path to the file (relative to codebase root)'
+            },
+            lineStart: {
+                type: 'number',
+                description: 'Starting line number (optional - for specific code regions)'
+            },
+            lineEnd: {
+                type: 'number',
+                description: 'Ending line number (optional)'
+            },
+            explanationType: {
+                type: 'string',
+                enum: ['general', 'architectural', 'algorithmic', 'usage', 'gotchas',
+                    'performance', 'security', 'debugging', 'history', 'todo'],
+                default: 'general',
+                description: 'Type of explanation to store'
+            },
+            context: {
+                type: 'string',
+                description: 'Additional context about why this explanation is being created'
+            },
+            forceRegenerate: {
+                type: 'boolean',
+                default: false,
+                description: 'Force creation even if a similar explanation exists'
+            }
+        },
+        required: ['filePath']
+    };
+    constructor(db, embeddingProvider) {
+        this.db = db;
+        this.embeddingProvider = embeddingProvider;
+    }
+    async execute(params) {
+        const validatedParams = ExplainCodeInput.parse(params);
+        logger.debug({ filePath: validatedParams.filePath }, 'Creating code explanation');
+        try {
+            // First, check if we have an existing explanation for this location
+            if (!validatedParams.forceRegenerate) {
+                const existing = await this.findExistingExplanation(validatedParams.filePath, validatedParams.lineStart, validatedParams.lineEnd, validatedParams.explanationType);
+                if (existing && existing.qualityScore >= 0.7) {
+                    // Increment use count
+                    await this.incrementUseCount(existing.id);
+                    logger.debug({
+                        explanationId: existing.id,
+                        qualityScore: existing.qualityScore
+                    }, 'Reusing existing high-quality explanation');
+                    return {
+                        success: true,
+                        explanation: existing,
+                        wasReused: true,
+                        message: `Reused existing ${existing.explanationType} explanation (quality: ${existing.qualityScore.toFixed(2)})`
+                    };
+                }
+            }
+            // Look up the code file
+            const codeFile = await this.findCodeFile(validatedParams.filePath);
+            // Get code snippet if line range specified
+            let codeSnippet;
+            if (codeFile && validatedParams.lineStart && validatedParams.lineEnd) {
+                codeSnippet = await this.extractCodeSnippet(codeFile.id, validatedParams.lineStart, validatedParams.lineEnd);
+            }
+            else if (codeFile) {
+                // Get first 50 lines as snippet
+                codeSnippet = await this.extractCodeSnippet(codeFile.id, 1, 50);
+            }
+            // For now, we store a placeholder explanation
+            // In real use,  would provide the explanation text
+            const explanationText = validatedParams.context ||
+                `Explanation for ${validatedParams.filePath}` +
+                    (validatedParams.lineStart ? ` (lines ${validatedParams.lineStart}-${validatedParams.lineEnd})` : '');
+            // Generate embedding for the explanation
+            const textForEmbedding = this.createEmbeddingText(validatedParams.filePath, explanationText, codeSnippet, validatedParams.explanationType);
+            const embedding = await this.embeddingProvider.generateEmbedding(textForEmbedding);
+            // Create the explanation record
+            const id = uuidv4();
+            const now = new Date();
+            await this.db.query(`INSERT INTO code_explanations (
+          id, code_id, file_path, line_start, line_end,
+          code_snippet, explanation_text, explanation_type,
+          embedding, quality_score, created_at, updated_at, metadata
+        ) VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12, $13)`, [
+                id,
+                codeFile?.id ?? null,
+                validatedParams.filePath,
+                validatedParams.lineStart ?? null,
+                validatedParams.lineEnd ?? null,
+                codeSnippet ?? null,
+                explanationText,
+                validatedParams.explanationType,
+                embedding?.length > 0 ? `[${embedding.join(',')}]` : null,
+                0.5, // Initial quality score
+                now,
+                now,
+                JSON.stringify({ context: validatedParams.context })
+            ]);
+            // Update access patterns
+            if (codeFile) {
+                await this.updateAccessPattern(codeFile.id, validatedParams.context);
+            }
+            const explanation = {
+                id,
+                codeId: codeFile?.id,
+                filePath: validatedParams.filePath,
+                lineStart: validatedParams.lineStart,
+                lineEnd: validatedParams.lineEnd,
+                codeSnippet,
+                explanationText,
+                explanationType: validatedParams.explanationType,
+                embedding,
+                qualityScore: 0.5,
+                useCount: 1,
+                feedbackPositive: 0,
+                feedbackNegative: 0,
+                createdAt: now,
+                updatedAt: now,
+                createdBy: 'assistant',
+                metadata: { context: validatedParams.context }
+            };
+            logger.info({
+                explanationId: id,
+                filePath: validatedParams.filePath,
+                type: validatedParams.explanationType
+            }, 'Code explanation stored');
+            return {
+                success: true,
+                explanation,
+                wasReused: false,
+                message: `Stored new ${validatedParams.explanationType} explanation for ${validatedParams.filePath}`
+            };
+        }
+        catch (error) {
+            logger.error({ error, filePath: validatedParams.filePath }, 'Failed to create explanation');
+            return {
+                success: false,
+                wasReused: false,
+                message: error instanceof Error ? error.message : 'Failed to create explanation'
+            };
+        }
+    }
+    /**
+     * Find existing explanation for the same location
+     */
+    async findExistingExplanation(filePath, lineStart, lineEnd, explanationType) {
+        const result = await this.db.query(`SELECT * FROM code_explanations
+       WHERE file_path = $1
+       AND ($2::integer IS NULL OR line_start = $2)
+       AND ($3::integer IS NULL OR line_end = $3)
+       AND ($4::varchar IS NULL OR explanation_type = $4)
+       ORDER BY quality_score DESC, use_count DESC
+       LIMIT 1`, [filePath, lineStart ?? null, lineEnd ?? null, explanationType ?? null]);
+        if (result.rows.length === 0)
+            return null;
+        const row = result.rows[0];
+        return {
+            id: row.id,
+            codeId: row.code_id ?? undefined,
+            filePath: row.file_path,
+            lineStart: row.line_start ?? undefined,
+            lineEnd: row.line_end ?? undefined,
+            codeSnippet: row.code_snippet ?? undefined,
+            explanationText: row.explanation_text,
+            explanationType: row.explanation_type,
+            qualityScore: row.quality_score,
+            useCount: row.use_count,
+            feedbackPositive: row.feedback_positive,
+            feedbackNegative: row.feedback_negative,
+            createdAt: row.created_at,
+            updatedAt: row.updated_at,
+            createdBy: row.created_by,
+            metadata: row.metadata
+        };
+    }
+    /**
+     * Find code file by path
+     */
+    async findCodeFile(filePath) {
+        const result = await this.db.query(`SELECT id, content FROM codebase_files
+       WHERE file_path = $1 OR file_path LIKE $2
+       LIMIT 1`, [filePath, `%${filePath}`]);
+        return result.rows[0] ?? null;
+    }
+    /**
+     * Extract code snippet from file
+     */
+    async extractCodeSnippet(codeId, lineStart, lineEnd) {
+        const result = await this.db.query(`SELECT content FROM codebase_files WHERE id = $1`, [codeId]);
+        if (result.rows.length === 0)
+            return undefined;
+        const lines = result.rows[0].content.split('\n');
+        const start = Math.max(0, lineStart - 1);
+        const end = Math.min(lines.length, lineEnd);
+        return lines.slice(start, end).join('\n');
+    }
+    /**
+     * Create text for embedding generation
+     */
+    createEmbeddingText(filePath, explanation, codeSnippet, explanationType) {
+        let text = `File: ${filePath}\n`;
+        if (explanationType) {
+            text += `Type: ${explanationType}\n`;
+        }
+        text += `Explanation: ${explanation}\n`;
+        if (codeSnippet) {
+            text += `Code:\n${codeSnippet.slice(0, 2000)}`;
+        }
+        return text;
+    }
+    /**
+     * Increment use count for an explanation
+     */
+    async incrementUseCount(explanationId) {
+        await this.db.query(`UPDATE code_explanations
+       SET use_count = use_count + 1
+       WHERE id = $1`, [explanationId]);
+    }
+    /**
+     * Update access pattern for code file
+     */
+    async updateAccessPattern(codeId, context) {
+        const hour = new Date().getHours();
+        const day = new Date().getDay();
+        await this.db.query(`INSERT INTO code_access_patterns (code_id, access_count, last_accessed, access_contexts)
+       VALUES ($1, 1, NOW(), $2)
+       ON CONFLICT (code_id) DO UPDATE SET
+         access_count = code_access_patterns.access_count + 1,
+         last_accessed = NOW(),
+         access_contexts = CASE
+           WHEN $3::text IS NOT NULL AND $3 != ''
+           THEN array_append(
+             (SELECT access_contexts[array_length(access_contexts, 1) - 9:array_length(access_contexts, 1)]
+              FROM code_access_patterns WHERE code_id = $1),
+             $3
+           )
+           ELSE code_access_patterns.access_contexts
+         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,
+            context ? [context] : [],
+            context ?? null,
+            hour + 1, // PostgreSQL arrays are 1-indexed
+            day + 1
+        ]);
+    }
+}
+//# sourceMappingURL=explainCode.js.map

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

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

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

@@ -0,0 +1,87 @@
+/**
+ * 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 { MCPTool } from '../mcp/toolRegistry.js';
+import { DatabaseManager } from '../database.js';
+import { ProvideFeedbackParams, FeedbackResult } from './types.js';
+/**
+ * ProvideFeedback - Improve explanations through feedback
+ *
+ * Features:
+ * - Positive/negative feedback tracking
+ * - Automatic quality score adjustment
+ * - Learning from usage patterns
+ */
+export declare class ProvideFeedback implements MCPTool<ProvideFeedbackParams, FeedbackResult> {
+    private db;
+    name: string;
+    description: string;
+    inputSchema: {
+        type: "object";
+        properties: {
+            explanationId: {
+                type: string;
+                format: string;
+                description: string;
+            };
+            positive: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    constructor(db: DatabaseManager);
+    execute(params: ProvideFeedbackParams): Promise<FeedbackResult>;
+}
+/**
+ * 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 declare class ExplanationLearningSystem {
+    private db;
+    constructor(db: DatabaseManager);
+    /**
+     * Get insights about code access patterns
+     */
+    getAccessInsights(codeId: string): Promise<{
+        accessCount: number;
+        commonQueries: string[];
+        peakHours: number[];
+        peakDays: string[];
+        averageQuality: number;
+    }>;
+    /**
+     * Identify explanations that need improvement
+     */
+    findExplanationsNeedingImprovement(limit?: number): Promise<Array<{
+        id: string;
+        filePath: string;
+        explanationType: string;
+        qualityScore: number;
+        useCount: number;
+        reason: string;
+    }>>;
+    /**
+     * Get learning statistics
+     */
+    getLearningStats(): Promise<{
+        totalExplanations: number;
+        averageQuality: number;
+        totalFeedback: number;
+        positiveFeedbackRate: number;
+        mostAccessedFiles: Array<{
+            filePath: string;
+            accessCount: number;
+        }>;
+        explanationTypeDistribution: Record<string, number>;
+    }>;
+}
+//# sourceMappingURL=feedback.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.d.ts","sourceRoot":"","sources":["../../src/code-explanations/feedback.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,EAEL,qBAAqB,EACrB,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB;;;;;;;GAOG;AACH,qBAAa,eAAgB,YAAW,OAAO,CAAC,qBAAqB,EAAE,cAAc,CAAC;IAsBxE,OAAO,CAAC,EAAE;IArBtB,IAAI,SAAkC;IACtC,WAAW,SAEgE;IAE3E,WAAW;;;;;;;;;;;;;;MAcT;gBAEkB,EAAE,EAAE,eAAe;IAEjC,OAAO,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,cAAc,CAAC;CA0DtE;AAED;;;;;;;GAOG;AACH,qBAAa,yBAAyB;IACxB,OAAO,CAAC,EAAE;gBAAF,EAAE,EAAE,eAAe;IAEvC;;OAEG;IACG,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAC/C,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IA2DF;;OAEG;IACG,kCAAkC,CAAC,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,KAAK,CAAC;QAC1E,EAAE,EAAE,MAAM,CAAC;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,eAAe,EAAE,MAAM,CAAC;QACxB,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;IAiCH;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC;QAChC,iBAAiB,EAAE,MAAM,CAAC;QAC1B,cAAc,EAAE,MAAM,CAAC;QACvB,aAAa,EAAE,MAAM,CAAC;QACtB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,iBAAiB,EAAE,KAAK,CAAC;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACpE,2BAA2B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACrD,CAAC;CAmDH"}