@stackmemoryai/stackmemory 0.2.7 → 0.2.9

package/dist/src/core/query/query-parser.js

@@ -0,0 +1,347 @@
+/**
+ * Query Parser for StackMemory
+ * Handles both natural language and structured queries
+ */
+export var FrameType;
+(function (FrameType) {
+    FrameType["TASK"] = "task";
+    FrameType["DEBUG"] = "debug";
+    FrameType["FEATURE"] = "feature";
+    FrameType["ARCHITECTURE"] = "architecture";
+    FrameType["BUG"] = "bug";
+    FrameType["REFACTOR"] = "refactor";
+})(FrameType || (FrameType = {}));
+export var FrameStatus;
+(function (FrameStatus) {
+    FrameStatus["OPEN"] = "open";
+    FrameStatus["CLOSED"] = "closed";
+    FrameStatus["STALLED"] = "stalled";
+})(FrameStatus || (FrameStatus = {}));
+export class QueryParser {
+    shortcuts = new Map([
+        ['today', { time: { last: '24h' } }],
+        [
+            'yesterday',
+            { time: { last: '48h', since: new Date(Date.now() - 48 * 3600000) } },
+        ],
+        ['this week', { time: { last: '7d' } }],
+        ['bugs', { frame: { type: [FrameType.BUG, FrameType.DEBUG] } }],
+        ['features', { frame: { type: [FrameType.FEATURE] } }],
+        ['critical', { frame: { score: { min: 0.8 } } }],
+        ['recent', { time: { last: '4h' } }],
+    ]);
+    /**
+     * Parse natural language query into structured format
+     */
+    parseNaturalLanguage(query) {
+        const result = {};
+        const lowerQuery = query.toLowerCase();
+        // Time-based patterns
+        this.parseTimePatterns(lowerQuery, result);
+        // Topic-based patterns
+        this.parseTopicPatterns(lowerQuery, result);
+        // People-based patterns
+        this.parsePeoplePatterns(lowerQuery, result);
+        // Shortcut expansion
+        this.expandShortcuts(lowerQuery, result);
+        // Default output settings if not specified
+        if (!result.output) {
+            result.output = {
+                limit: 50,
+                sort: 'time',
+                format: 'summary',
+            };
+        }
+        return result;
+    }
+    /**
+     * Parse structured query with validation
+     */
+    parseStructured(query) {
+        // Validate and normalize the query
+        if (query.frame?.score) {
+            if (query.frame.score.min !== undefined) {
+                query.frame.score.min = Math.max(0, Math.min(1, query.frame.score.min));
+            }
+            if (query.frame.score.max !== undefined) {
+                query.frame.score.max = Math.max(0, Math.min(1, query.frame.score.max));
+            }
+        }
+        // Apply defaults
+        if (!query.output) {
+            query.output = {
+                limit: 50,
+                sort: 'time',
+                format: 'full',
+            };
+        }
+        return query;
+    }
+    /**
+     * Parse hybrid query (natural language with structured modifiers)
+     */
+    parseHybrid(naturalQuery, modifiers) {
+        const nlQuery = this.parseNaturalLanguage(naturalQuery);
+        return this.mergeQueries(nlQuery, modifiers || {});
+    }
+    parseTimePatterns(query, result) {
+        // "last day", "last week", "last month"
+        const lastPattern = /last\s+(\d+)?\s*(day|hour|week|month)s?/i;
+        const match = query.match(lastPattern);
+        if (match) {
+            const quantity = match[1] ? parseInt(match[1]) : 1;
+            const unit = match[2].toLowerCase();
+            const unitMap = {
+                hour: 'h',
+                day: 'd',
+                week: 'w',
+                month: 'm',
+            };
+            result.time = { last: `${quantity}${unitMap[unit]}` };
+        }
+        // "yesterday", "today", "this week"
+        for (const [shortcut, value] of this.shortcuts) {
+            if (query.includes(shortcut) && value.time) {
+                result.time = { ...result.time, ...value.time };
+            }
+        }
+        // Date patterns "December 15", "2024-12-20"
+        const datePattern = /(\d{4}-\d{2}-\d{2})|((jan|feb|mar|apr|may|jun|jul|aug|sep|oct|nov|dec)\w*\s+\d{1,2})/i;
+        const dateMatch = query.match(datePattern);
+        if (dateMatch) {
+            try {
+                const date = new Date(dateMatch[0]);
+                if (!isNaN(date.getTime())) {
+                    result.time = { ...result.time, specific: date };
+                }
+            }
+            catch {
+                // Invalid date, ignore
+            }
+        }
+    }
+    parseTopicPatterns(query, result) {
+        // Common topics
+        const topics = [
+            'auth',
+            'authentication',
+            'login',
+            'oauth',
+            'database',
+            'migration',
+            'cache',
+            'api',
+            'bug',
+            'error',
+            'fix',
+            'feature',
+            'test',
+            'security',
+            'performance',
+        ];
+        const foundTopics = [];
+        for (const topic of topics) {
+            if (query.includes(topic)) {
+                foundTopics.push(topic);
+            }
+        }
+        if (foundTopics.length > 0) {
+            result.content = { ...result.content, topic: foundTopics };
+        }
+        // File patterns
+        const filePattern = /(\w+\.\w+)|(\*\.\w+)/g;
+        const files = query.match(filePattern);
+        if (files) {
+            result.content = { ...result.content, files };
+        }
+    }
+    parsePeoplePatterns(query, result) {
+        // "@alice", "@bob" mentions
+        const mentionPattern = /@(\w+)/g;
+        const mentions = [...query.matchAll(mentionPattern)].map((m) => m[1]);
+        if (mentions.length > 0) {
+            result.people = { owner: mentions };
+        }
+        // "alice's work", "bob's changes"
+        const possessivePattern = /(\w+)'s\s+(work|changes|commits|frames)/i;
+        const possMatch = query.match(possessivePattern);
+        if (possMatch) {
+            const person = possMatch[1].toLowerCase();
+            result.people = { ...result.people, owner: [person] };
+        }
+        // "team work"
+        if (query.includes('team')) {
+            result.people = { ...result.people, team: '$current_team' };
+        }
+    }
+    expandShortcuts(query, result) {
+        // Priority shortcuts
+        if (query.includes('critical')) {
+            result.frame = {
+                ...result.frame,
+                score: { min: 0.8 },
+            };
+        }
+        else if (query.includes('high')) {
+            result.frame = {
+                ...result.frame,
+                score: { min: 0.7 },
+            };
+        }
+        if (query.includes('low priority')) {
+            result.frame = {
+                ...result.frame,
+                score: { max: 0.3 },
+            };
+        }
+        // Status shortcuts
+        if (query.includes('open') || query.includes('active')) {
+            result.frame = {
+                ...result.frame,
+                status: [FrameStatus.OPEN],
+            };
+        }
+        if (query.includes('closed') || query.includes('done')) {
+            result.frame = {
+                ...result.frame,
+                status: [FrameStatus.CLOSED],
+            };
+        }
+    }
+    mergeQueries(base, overlay) {
+        return {
+            time: { ...base.time, ...overlay.time },
+            content: { ...base.content, ...overlay.content },
+            frame: { ...base.frame, ...overlay.frame },
+            people: { ...base.people, ...overlay.people },
+            output: { ...base.output, ...overlay.output },
+        };
+    }
+    /**
+     * Expand query with synonyms and related terms
+     */
+    expandQuery(query) {
+        const synonyms = {
+            auth: ['authentication', 'oauth', 'login', 'session', 'jwt'],
+            bug: ['error', 'issue', 'problem', 'fix', 'defect'],
+            database: ['db', 'sql', 'postgres', 'migration', 'schema'],
+            test: ['testing', 'spec', 'unit', 'integration', 'e2e'],
+        };
+        if (query.content?.topic) {
+            const expandedTopics = new Set(query.content.topic);
+            for (const topic of query.content.topic) {
+                const syns = synonyms[topic.toLowerCase()];
+                if (syns) {
+                    syns.forEach((s) => expandedTopics.add(s));
+                }
+            }
+            query.content.topic = Array.from(expandedTopics);
+        }
+        return query;
+    }
+    /**
+     * Main parse method that returns a complete QueryResponse
+     */
+    parse(query) {
+        const original = typeof query === 'string' ? query : JSON.stringify(query);
+        // Parse based on input type (clone to avoid mutation)
+        const interpreted = typeof query === 'string'
+            ? this.parseNaturalLanguage(query)
+            : this.parseStructured(JSON.parse(JSON.stringify(query)));
+        // Validate the query
+        const validationErrors = this.validateQuery(interpreted);
+        // Expand with synonyms
+        const expanded = this.expandQuery(JSON.parse(JSON.stringify(interpreted)));
+        // Generate suggestions
+        const suggestions = this.generateSuggestions(interpreted, validationErrors);
+        return {
+            original,
+            interpreted,
+            expanded,
+            suggestions,
+            validationErrors: validationErrors.length > 0 ? validationErrors : undefined,
+        };
+    }
+    /**
+     * Validate query for errors and inconsistencies
+     */
+    validateQuery(query) {
+        const errors = [];
+        // Validate time filters
+        if (query.time) {
+            if (query.time.since && query.time.until) {
+                if (query.time.since > query.time.until) {
+                    errors.push('Time filter: "since" date is after "until" date');
+                }
+            }
+            if (query.time.between) {
+                if (query.time.between[0] > query.time.between[1]) {
+                    errors.push('Time filter: Invalid date range in "between"');
+                }
+            }
+        }
+        // Validate score ranges
+        if (query.frame?.score) {
+            if (query.frame.score.min !== undefined &&
+                query.frame.score.max !== undefined) {
+                if (query.frame.score.min > query.frame.score.max) {
+                    errors.push('Frame filter: Minimum score is greater than maximum score');
+                }
+            }
+        }
+        // Validate depth ranges
+        if (query.frame?.depth) {
+            if (query.frame.depth.min !== undefined &&
+                query.frame.depth.max !== undefined) {
+                if (query.frame.depth.min > query.frame.depth.max) {
+                    errors.push('Frame filter: Minimum depth is greater than maximum depth');
+                }
+            }
+        }
+        // Validate output limit
+        if (query.output?.limit !== undefined) {
+            if (query.output.limit < 1 || query.output.limit > 1000) {
+                errors.push('Output limit must be between 1 and 1000');
+            }
+        }
+        return errors;
+    }
+    /**
+     * Generate query suggestions based on the interpreted query
+     */
+    generateSuggestions(query, errors) {
+        const suggestions = [];
+        // If no time filter, suggest adding one
+        if (!query.time) {
+            suggestions.push('Try adding a time filter like "last 24h" or "today"');
+        }
+        // If very broad query, suggest refinement
+        if (!query.content?.topic && !query.frame?.type && !query.people) {
+            suggestions.push('Consider filtering by topic, frame type, or people to narrow results');
+        }
+        // If searching for bugs/errors without time limit
+        if (query.frame?.type?.includes(FrameType.BUG) && !query.time) {
+            suggestions.push('Add a time filter to focus on recent bugs');
+        }
+        // If high score threshold without type filter
+        if (query.frame?.score?.min &&
+            query.frame.score.min >= 0.8 &&
+            !query.frame?.type) {
+            suggestions.push('Consider adding frame type filter with high score threshold');
+        }
+        // Suggest shortcuts if applicable
+        if (query.time?.last === '24h') {
+            suggestions.push('You can use "today" as a shortcut for last 24 hours');
+        }
+        if (query.frame?.type?.includes(FrameType.BUG) &&
+            query.frame?.type?.includes(FrameType.DEBUG)) {
+            suggestions.push('You can use "bugs" as a shortcut for bug and debug frames');
+        }
+        // If there are errors, suggest corrections
+        if (errors.length > 0) {
+            suggestions.push('Please correct the validation errors before running the query');
+        }
+        return suggestions;
+    }
+}
+//# sourceMappingURL=query-parser.js.map

package/dist/src/core/query/query-parser.js.map

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

package/dist/src/core/retrieval/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * LLM-Driven Context Retrieval Module
+ * Exports all retrieval functionality
+ */
+export * from './types.js';
+export * from './summary-generator.js';
+export * from './llm-context-retrieval.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/core/retrieval/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/retrieval/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC"}

package/dist/src/core/retrieval/index.js

@@ -0,0 +1,8 @@
+/**
+ * LLM-Driven Context Retrieval Module
+ * Exports all retrieval functionality
+ */
+export * from './types.js';
+export * from './summary-generator.js';
+export * from './llm-context-retrieval.js';
+//# sourceMappingURL=index.js.map

package/dist/src/core/retrieval/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/retrieval/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC"}

package/dist/src/core/retrieval/llm-context-retrieval.d.ts

@@ -0,0 +1,71 @@
+/**
+ * LLM-Driven Context Retrieval System
+ * Uses LLM analysis to intelligently select relevant context
+ */
+import Database from 'better-sqlite3';
+import { FrameManager } from '../context/frame-manager.js';
+import { CompressedSummary, RetrievedContext, RetrievalConfig, RetrievalHints } from './types.js';
+/**
+ * LLM provider interface for context analysis
+ */
+export interface LLMProvider {
+    analyze(prompt: string, maxTokens: number): Promise<string>;
+}
+/**
+ * Main LLM Context Retrieval class
+ */
+export declare class LLMContextRetrieval {
+    private db;
+    private frameManager;
+    private summaryGenerator;
+    private queryParser;
+    private heuristicAnalyzer;
+    private llmProvider?;
+    private config;
+    private projectId;
+    constructor(db: Database.Database, frameManager: FrameManager, projectId: string, config?: Partial<RetrievalConfig>, llmProvider?: LLMProvider);
+    /**
+     * Retrieve context based on query using LLM analysis
+     */
+    retrieveContext(query: string, options?: {
+        tokenBudget?: number;
+        hints?: RetrievalHints;
+        forceRefresh?: boolean;
+    }): Promise<RetrievedContext>;
+    /**
+     * Perform LLM analysis or fall back to heuristics
+     */
+    private analyzeWithLLM;
+    /**
+     * Build the prompt for LLM analysis
+     */
+    private buildAnalysisPrompt;
+    /**
+     * Parse LLM response into structured analysis
+     */
+    private parseAnalysisResponse;
+    private assessQueryComplexity;
+    /**
+     * Retrieve frames based on analysis
+     */
+    private retrieveFrames;
+    private getFrameAnchors;
+    /**
+     * Assemble final context string
+     */
+    private assembleContext;
+    private summarizeEvents;
+    /**
+     * Get just the compressed summary (useful for external analysis)
+     */
+    getSummary(forceRefresh?: boolean): CompressedSummary;
+    /**
+     * Set LLM provider
+     */
+    setLLMProvider(provider: LLMProvider): void;
+    /**
+     * Clear caches
+     */
+    clearCache(): void;
+}
+//# sourceMappingURL=llm-context-retrieval.d.ts.map

package/dist/src/core/retrieval/llm-context-retrieval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm-context-retrieval.d.ts","sourceRoot":"","sources":["../../../../src/core/retrieval/llm-context-retrieval.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EACL,YAAY,EAIb,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EACL,iBAAiB,EAGjB,gBAAgB,EAGhB,eAAe,EAEf,cAAc,EAEf,MAAM,YAAY,CAAC;AAGpB;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC7D;AAoND;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,gBAAgB,CAA6B;IACrD,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,WAAW,CAAC,CAAc;IAClC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,SAAS,CAAS;gBAGxB,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,YAAY,EAAE,YAAY,EAC1B,SAAS,EAAE,MAAM,EACjB,MAAM,GAAE,OAAO,CAAC,eAAe,CAAM,EACrC,WAAW,CAAC,EAAE,WAAW;IAiB3B;;OAEG;IACU,eAAe,CAC1B,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;QACP,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,cAAc,CAAC;QACvB,YAAY,CAAC,EAAE,OAAO,CAAC;KACnB,GACL,OAAO,CAAC,gBAAgB,CAAC;IAmE5B;;OAEG;YACW,cAAc;IA8D5B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAqD3B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA2D7B,OAAO,CAAC,qBAAqB;IAS7B;;OAEG;IACH,OAAO,CAAC,cAAc;IAgDtB,OAAO,CAAC,eAAe;IAoBvB;;OAEG;IACH,OAAO,CAAC,eAAe;IA8EvB,OAAO,CAAC,eAAe;IAWvB;;OAEG;IACI,UAAU,CAAC,YAAY,UAAQ,GAAG,iBAAiB;IAI1D;;OAEG;IACI,cAAc,CAAC,QAAQ,EAAE,WAAW,GAAG,IAAI;IAIlD;;OAEG;IACI,UAAU,IAAI,IAAI;CAG1B"}