@stackmemoryai/stackmemory 0.2.7 → 0.2.9

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

@@ -0,0 +1,257 @@
+/**
+ * Types for LLM-Driven Context Retrieval System
+ * Implements intelligent context selection based on compressed summaries
+ */
+import { Frame, Anchor, Event } from '../context/frame-manager.js';
+import { StackMemoryQuery } from '../query/query-parser.js';
+/**
+ * Compressed summary of recent session activity
+ */
+export interface RecentSessionSummary {
+    /** Recent frames with their key attributes */
+    frames: FrameSummary[];
+    /** Dominant operations performed */
+    dominantOperations: OperationSummary[];
+    /** Files that were touched */
+    filesTouched: FileSummary[];
+    /** Errors encountered */
+    errorsEncountered: ErrorSummary[];
+    /** Time range covered */
+    timeRange: {
+        start: number;
+        end: number;
+        durationMs: number;
+    };
+}
+export interface FrameSummary {
+    frameId: string;
+    name: string;
+    type: string;
+    depth: number;
+    eventCount: number;
+    anchorCount: number;
+    score: number;
+    createdAt: number;
+    closedAt?: number;
+    digestPreview?: string;
+}
+export interface OperationSummary {
+    operation: string;
+    count: number;
+    lastOccurrence: number;
+    successRate: number;
+}
+export interface FileSummary {
+    path: string;
+    operationCount: number;
+    lastModified: number;
+    operations: string[];
+}
+export interface ErrorSummary {
+    errorType: string;
+    message: string;
+    count: number;
+    lastOccurrence: number;
+    resolved: boolean;
+}
+/**
+ * Historical patterns extracted from memory
+ */
+export interface HistoricalPatterns {
+    /** Frame counts by topic */
+    topicFrameCounts: Record<string, number>;
+    /** Key decisions made */
+    keyDecisions: DecisionSummary[];
+    /** Recurring issues */
+    recurringIssues: IssueSummary[];
+    /** Common tool sequences */
+    commonToolSequences: ToolSequence[];
+    /** Time-based activity patterns */
+    activityPatterns: ActivityPattern[];
+}
+export interface DecisionSummary {
+    id: string;
+    text: string;
+    frameId: string;
+    timestamp: number;
+    impact: 'low' | 'medium' | 'high';
+    relatedFiles?: string[];
+}
+export interface IssueSummary {
+    issueType: string;
+    occurrenceCount: number;
+    lastSeen: number;
+    resolutionRate: number;
+    commonFixes?: string[];
+}
+export interface ToolSequence {
+    pattern: string;
+    frequency: number;
+    avgDuration: number;
+    successRate: number;
+}
+export interface ActivityPattern {
+    periodType: 'hourly' | 'daily' | 'weekly';
+    peakPeriods: string[];
+    avgEventsPerPeriod: number;
+}
+/**
+ * Queryable indices for fast retrieval
+ */
+export interface QueryableIndices {
+    /** Index by error type */
+    byErrorType: Record<string, string[]>;
+    /** Index by timeframe */
+    byTimeframe: Record<string, string[]>;
+    /** Index by contributor */
+    byContributor: Record<string, string[]>;
+    /** Index by topic */
+    byTopic: Record<string, string[]>;
+    /** Index by file */
+    byFile: Record<string, string[]>;
+}
+/**
+ * Complete compressed summary for LLM analysis
+ */
+export interface CompressedSummary {
+    /** Project identifier */
+    projectId: string;
+    /** Generation timestamp */
+    generatedAt: number;
+    /** Recent session summary */
+    recentSession: RecentSessionSummary;
+    /** Historical patterns */
+    historicalPatterns: HistoricalPatterns;
+    /** Queryable indices */
+    queryableIndices: QueryableIndices;
+    /** Summary statistics */
+    stats: SummaryStats;
+}
+export interface SummaryStats {
+    totalFrames: number;
+    totalEvents: number;
+    totalAnchors: number;
+    totalDecisions: number;
+    oldestFrame: number;
+    newestFrame: number;
+    avgFrameDepth: number;
+    avgEventsPerFrame: number;
+}
+/**
+ * LLM analysis request
+ */
+export interface LLMAnalysisRequest {
+    /** Current user query */
+    currentQuery: string;
+    /** Parsed structured query */
+    parsedQuery?: StackMemoryQuery;
+    /** Compressed summary */
+    compressedSummary: CompressedSummary;
+    /** Token budget for context */
+    tokenBudget: number;
+    /** Optional hints for retrieval */
+    hints?: RetrievalHints;
+}
+export interface RetrievalHints {
+    /** Prefer recent frames */
+    preferRecent?: boolean;
+    /** Focus on specific topics */
+    focusTopics?: string[];
+    /** Include error context */
+    includeErrors?: boolean;
+    /** Include decision history */
+    includeDecisions?: boolean;
+    /** Minimum relevance score */
+    minRelevance?: number;
+}
+/**
+ * LLM analysis response
+ */
+export interface LLMAnalysisResponse {
+    /** Reasoning for the retrieval decision (auditable) */
+    reasoning: string;
+    /** Frames to retrieve with priority order */
+    framesToRetrieve: FrameRetrievalPlan[];
+    /** Confidence score (0.0 - 1.0) */
+    confidenceScore: number;
+    /** Additional context recommendations */
+    recommendations: ContextRecommendation[];
+    /** Analysis metadata */
+    metadata: AnalysisMetadata;
+}
+export interface FrameRetrievalPlan {
+    frameId: string;
+    priority: number;
+    reason: string;
+    includeEvents: boolean;
+    includeAnchors: boolean;
+    includeDigest: boolean;
+    estimatedTokens: number;
+}
+export interface ContextRecommendation {
+    type: 'include' | 'exclude' | 'summarize';
+    target: string;
+    reason: string;
+    impact: 'low' | 'medium' | 'high';
+}
+export interface AnalysisMetadata {
+    analysisTimeMs: number;
+    summaryTokens: number;
+    queryComplexity: 'simple' | 'moderate' | 'complex';
+    matchedPatterns: string[];
+    fallbackUsed: boolean;
+}
+/**
+ * Retrieved context result
+ */
+export interface RetrievedContext {
+    /** Assembled context string */
+    context: string;
+    /** Frames included */
+    frames: Frame[];
+    /** Anchors included */
+    anchors: Anchor[];
+    /** Events included */
+    events: Event[];
+    /** LLM analysis that drove retrieval */
+    analysis: LLMAnalysisResponse;
+    /** Token usage */
+    tokenUsage: {
+        budget: number;
+        used: number;
+        remaining: number;
+    };
+    /** Retrieval metadata */
+    metadata: RetrievalMetadata;
+}
+export interface RetrievalMetadata {
+    retrievalTimeMs: number;
+    cacheHit: boolean;
+    framesScanned: number;
+    framesIncluded: number;
+    compressionRatio: number;
+}
+/**
+ * Configuration for the retrieval system
+ */
+export interface RetrievalConfig {
+    /** Maximum frames to include in summary */
+    maxSummaryFrames: number;
+    /** Default token budget */
+    defaultTokenBudget: number;
+    /** Cache TTL in seconds */
+    cacheTtlSeconds: number;
+    /** Minimum confidence to use LLM suggestions */
+    minConfidenceThreshold: number;
+    /** Enable fallback to heuristic retrieval */
+    enableFallback: boolean;
+    /** LLM provider configuration */
+    llmConfig: {
+        provider: 'anthropic' | 'openai' | 'local';
+        model: string;
+        maxTokens: number;
+        temperature: number;
+    };
+}
+export declare const DEFAULT_RETRIEVAL_CONFIG: RetrievalConfig;
+//# sourceMappingURL=types.d.ts.map

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

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

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

@@ -0,0 +1,18 @@
+/**
+ * Types for LLM-Driven Context Retrieval System
+ * Implements intelligent context selection based on compressed summaries
+ */
+export const DEFAULT_RETRIEVAL_CONFIG = {
+    maxSummaryFrames: 15,
+    defaultTokenBudget: 8000,
+    cacheTtlSeconds: 300,
+    minConfidenceThreshold: 0.6,
+    enableFallback: true,
+    llmConfig: {
+        provider: 'anthropic',
+        model: 'claude-3-haiku-20240307',
+        maxTokens: 1024,
+        temperature: 0.3,
+    },
+};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/core/retrieval/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAoRH,MAAM,CAAC,MAAM,wBAAwB,GAAoB;IACvD,gBAAgB,EAAE,EAAE;IACpB,kBAAkB,EAAE,IAAI;IACxB,eAAe,EAAE,GAAG;IACpB,sBAAsB,EAAE,GAAG;IAC3B,cAAc,EAAE,IAAI;IACpB,SAAS,EAAE;QACT,QAAQ,EAAE,WAAW;QACrB,KAAK,EAAE,yBAAyB;QAChC,SAAS,EAAE,IAAI;QACf,WAAW,EAAE,GAAG;KACjB;CACF,CAAC"}

package/dist/src/core/trace/trace-detector.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Trace Detection and Bundling System
+ * Identifies chains of related tool calls and bundles them as single traces
+ */
+import { ToolCall, Trace, TraceType, TraceBoundaryConfig } from './types';
+import { ConfigManager } from '../config/config-manager';
+import Database from 'better-sqlite3';
+export declare class TraceDetector {
+    private config;
+    private activeTrace;
+    private lastToolTime;
+    private traces;
+    private configManager;
+    private traceStore?;
+    constructor(config?: Partial<TraceBoundaryConfig>, configManager?: ConfigManager, db?: Database.Database);
+    /**
+     * Load traces from the database
+     */
+    private loadTracesFromStore;
+    /**
+     * Add a tool call and check if it belongs to current trace
+     */
+    addToolCall(tool: ToolCall): void;
+    /**
+     * Determine if a tool call should start a new trace
+     */
+    private shouldStartNewTrace;
+    /**
+     * Check if a tool is attempting to fix an error from previous tool
+     */
+    private isFixAttempt;
+    /**
+     * Finalize current trace and add to traces list
+     */
+    private finalizeTrace;
+    /**
+     * Create a trace from a sequence of tool calls
+     */
+    private createTrace;
+    /**
+     * Detect the type of trace based on tool patterns
+     */
+    private detectTraceType;
+    /**
+     * Check if tool sequence matches a pattern
+     */
+    private matchesPattern;
+    /**
+     * Extract metadata from tool calls
+     */
+    private extractMetadata;
+    /**
+     * Calculate importance score for a trace
+     */
+    private calculateTraceScore;
+    /**
+     * Check if a tool call represents a permanent change
+     */
+    private isPermanentChange;
+    /**
+     * Generate a summary for the trace
+     */
+    private generateSummary;
+    /**
+     * Compress a trace for long-term storage
+     */
+    private compressTrace;
+    /**
+     * Get directory from file path
+     */
+    private getDirectory;
+    /**
+     * Flush any pending trace
+     */
+    flush(): void;
+    /**
+     * Get all detected traces
+     */
+    getTraces(): Trace[];
+    /**
+     * Get traces by type
+     */
+    getTracesByType(type: TraceType): Trace[];
+    /**
+     * Get high-importance traces
+     */
+    getHighImportanceTraces(threshold?: number): Trace[];
+    /**
+     * Compress old traces
+     */
+    compressOldTraces(ageHours?: number): number;
+    /**
+     * Export traces for analysis
+     */
+    exportTraces(): string;
+    /**
+     * Get statistics about traces
+     */
+    getStatistics(): {
+        totalTraces: number;
+        tracesByType: Record<string, number>;
+        averageScore: number;
+        averageLength: number;
+        compressedCount: number;
+        highImportanceCount: number;
+    };
+}
+//# sourceMappingURL=trace-detector.d.ts.map

package/dist/src/core/trace/trace-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-detector.d.ts","sourceRoot":"","sources":["../../../../src/core/trace/trace-detector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,QAAQ,EACR,KAAK,EACL,SAAS,EACT,mBAAmB,EAOpB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,UAAU,CAAC,CAAa;gBAG9B,MAAM,GAAE,OAAO,CAAC,mBAAmB,CAAM,EACzC,aAAa,CAAC,EAAE,aAAa,EAC7B,EAAE,CAAC,EAAE,QAAQ,CAAC,QAAQ;IAYxB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAgB3B;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI;IAwBjC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAyC3B;;OAEG;IACH,OAAO,CAAC,YAAY;IAiBpB;;OAEG;IACH,OAAO,CAAC,aAAa;IAkBrB;;OAEG;IACH,OAAO,CAAC,WAAW;IAyBnB;;OAEG;IACH,OAAO,CAAC,eAAe;IAiCvB;;OAEG;IACH,OAAO,CAAC,cAAc;IAwBtB;;OAEG;IACH,OAAO,CAAC,eAAe;IA8CvB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAqC3B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAKzB;;OAEG;IACH,OAAO,CAAC,eAAe;IAuCvB;;OAEG;IACH,OAAO,CAAC,aAAa;IAcrB;;OAEG;IACH,OAAO,CAAC,YAAY;IAMpB;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,SAAS,IAAI,KAAK,EAAE;IAIpB;;OAEG;IACH,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,KAAK,EAAE;IAIzC;;OAEG;IACH,uBAAuB,CAAC,SAAS,GAAE,MAAY,GAAG,KAAK,EAAE;IAIzD;;OAEG;IACH,iBAAiB,CAAC,QAAQ,GAAE,MAAW,GAAG,MAAM;IAiBhD;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,aAAa;;sBAGW,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;;;;;;CAuC/C"}

package/dist/src/core/trace/trace-detector.demo.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Demo script to showcase Trace Detection functionality
+ */
+export {};
+//# sourceMappingURL=trace-detector.demo.d.ts.map

package/dist/src/core/trace/trace-detector.demo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-detector.demo.d.ts","sourceRoot":"","sources":["../../../../src/core/trace/trace-detector.demo.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/src/core/trace/trace-detector.demo.js

@@ -0,0 +1,145 @@
+/**
+ * Demo script to showcase Trace Detection functionality
+ */
+import { TraceDetector } from './trace-detector';
+import { v4 as uuidv4 } from 'uuid';
+// Create a new trace detector
+const detector = new TraceDetector();
+console.log('🔍 Trace Detection Demo\n');
+console.log('='.repeat(50));
+// Simulate a search-driven modification trace
+console.log('\n📋 Simulating Search-Driven Modification:');
+const baseTime = Date.now();
+const searchDrivenTools = [
+    {
+        id: uuidv4(),
+        tool: 'search',
+        timestamp: baseTime,
+        arguments: { query: 'authentication bug' },
+    },
+    {
+        id: uuidv4(),
+        tool: 'grep',
+        timestamp: baseTime + 1000,
+        arguments: { pattern: 'auth.*error' },
+    },
+    {
+        id: uuidv4(),
+        tool: 'read',
+        timestamp: baseTime + 2000,
+        filesAffected: ['/src/auth/login.ts'],
+    },
+    {
+        id: uuidv4(),
+        tool: 'edit',
+        timestamp: baseTime + 3000,
+        filesAffected: ['/src/auth/login.ts'],
+    },
+];
+searchDrivenTools.forEach((tool) => {
+    detector.addToolCall(tool);
+    console.log(`  Added: ${tool.tool}`);
+});
+// Simulate an error recovery trace (separate due to time gap)
+console.log('\n🔧 Simulating Error Recovery:');
+const errorTime = baseTime + 40000; // 40 seconds later
+const errorRecoveryTools = [
+    {
+        id: uuidv4(),
+        tool: 'bash',
+        timestamp: errorTime,
+        arguments: { command: 'npm test' },
+        error: 'Test failed: TypeError',
+    },
+    {
+        id: uuidv4(),
+        tool: 'edit',
+        timestamp: errorTime + 1000,
+        filesAffected: ['/src/utils/validator.ts'],
+    },
+    {
+        id: uuidv4(),
+        tool: 'bash',
+        timestamp: errorTime + 2000,
+        arguments: { command: 'npm test' },
+        result: 'All tests passing',
+    },
+];
+errorRecoveryTools.forEach((tool) => {
+    detector.addToolCall(tool);
+    console.log(`  Added: ${tool.tool}${tool.error ? ' (with error)' : ''}`);
+});
+// Simulate a feature implementation trace
+console.log('\n✨ Simulating Feature Implementation:');
+const featureTime = baseTime + 80000; // 80 seconds later
+const featureTools = [
+    {
+        id: uuidv4(),
+        tool: 'write',
+        timestamp: featureTime,
+        filesAffected: ['/src/components/Dashboard.tsx'],
+    },
+    {
+        id: uuidv4(),
+        tool: 'edit',
+        timestamp: featureTime + 1000,
+        filesAffected: ['/src/components/Dashboard.tsx'],
+    },
+    {
+        id: uuidv4(),
+        tool: 'test',
+        timestamp: featureTime + 2000,
+        arguments: { file: 'Dashboard.test.tsx' },
+    },
+];
+featureTools.forEach((tool) => {
+    detector.addToolCall(tool);
+    console.log(`  Added: ${tool.tool}`);
+});
+// Flush any pending traces
+detector.flush();
+// Get statistics
+console.log('\n📊 Trace Statistics:');
+console.log('='.repeat(50));
+const stats = detector.getStatistics();
+console.log(`Total Traces: ${stats.totalTraces}`);
+console.log(`Average Score: ${stats.averageScore.toFixed(2)}`);
+console.log(`Average Length: ${stats.averageLength.toFixed(1)} tools`);
+console.log(`High Importance (>0.7): ${stats.highImportanceCount}`);
+console.log('\nTrace Types:');
+Object.entries(stats.tracesByType).forEach(([type, count]) => {
+    console.log(`  ${type}: ${count}`);
+});
+// Display all traces
+console.log('\n📝 Detected Traces:');
+console.log('='.repeat(50));
+const traces = detector.getTraces();
+traces.forEach((trace, index) => {
+    console.log(`\nTrace ${index + 1}:`);
+    console.log(`  Type: ${trace.type}`);
+    console.log(`  Score: ${trace.score.toFixed(2)}`);
+    console.log(`  Tools: ${trace.tools.map((t) => t.tool).join(' → ')}`);
+    console.log(`  Summary: ${trace.summary}`);
+    console.log(`  Duration: ${((trace.metadata.endTime - trace.metadata.startTime) / 1000).toFixed(1)}s`);
+    if (trace.metadata.filesModified.length > 0) {
+        console.log(`  Files Modified: ${trace.metadata.filesModified.join(', ')}`);
+    }
+    if (trace.metadata.errorsEncountered.length > 0) {
+        console.log(`  Errors: ${trace.metadata.errorsEncountered.join(', ')}`);
+    }
+    if (trace.metadata.causalChain) {
+        console.log(`  ✓ Causal Chain Detected (error→fix→verify)`);
+    }
+});
+// Test high-importance trace filtering
+console.log('\n⭐ High Importance Traces (score > 0.3):');
+const highImportance = detector.getHighImportanceTraces(0.3);
+highImportance.forEach((trace) => {
+    console.log(`  [${trace.type}] Score: ${trace.score.toFixed(2)} - ${trace.summary}`);
+});
+// Export traces as JSON
+console.log('\n💾 Exporting traces to JSON...');
+const exported = detector.exportTraces();
+console.log(`Exported ${exported.length} characters of JSON data`);
+console.log('\n✅ Demo complete!');
+//# sourceMappingURL=trace-detector.demo.js.map

package/dist/src/core/trace/trace-detector.demo.js.map

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