@bonginkan/maria 2.0.7 → 2.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -2,70 +2,11 @@ export { createCLI } from './cli.js';
2
2
  import { EventEmitter } from 'events';
3
3
  import 'commander';
4
4
 
5
- interface ConversationMessage {
6
- id: string;
7
- role: 'user' | 'assistant' | 'system';
8
- content: string;
9
- timestamp: Date;
10
- model?: string;
11
- tokensUsed?: number;
12
- metadata?: Record<string, unknown>;
13
- }
14
- interface ConversationContext {
15
- id: string;
16
- messages: ConversationMessage[];
17
- sessionId: string;
18
- userId?: string;
19
- startTime: Date;
20
- lastActivity: Date;
21
- config: ConversationConfig;
22
- preferences?: UserPreferences;
23
- history?: ConversationHistory[];
24
- currentTask?: string;
25
- hasErrors?: boolean;
26
- isUrgent?: boolean;
27
- isInteractive?: boolean;
28
- metadata?: Record<string, unknown>;
29
- }
30
- interface ConversationHistory {
31
- timestamp: Date;
32
- action: string;
33
- data?: Record<string, unknown>;
34
- }
35
- interface UserPreferences {
36
- mode?: 'chat' | 'research' | 'command' | 'creative';
37
- defaultModel?: string;
38
- temperature?: number;
39
- maxTokens?: number;
40
- autoSave?: boolean;
41
- language?: string;
42
- theme?: 'light' | 'dark' | 'auto';
43
- verbosity?: 'normal' | 'verbose' | 'quiet';
44
- autoMode?: boolean;
45
- }
46
- interface ConversationConfig {
47
- model: string;
48
- maxTokens?: number;
49
- temperature?: number;
50
- stream?: boolean;
51
- systemPrompt?: string;
52
- tools?: string[];
53
- safetySettings?: SafetySettings;
54
- }
55
- interface SafetySettings {
56
- enableContentFilter: boolean;
57
- restrictedTopics: string[];
58
- maxPromptLength: number;
59
- allowFileAccess: boolean;
60
- allowNetworkAccess: boolean;
61
- }
62
-
63
5
  /**
64
6
  * Slash Command Type Definitions
65
7
  * Core types for the microservice-based command architecture
66
8
  */
67
-
68
- type CommandCategory = 'auth' | 'config' | 'project' | 'development' | 'media' | 'conversation' | 'advanced' | 'system';
9
+ type CommandCategory = 'core' | 'auth' | 'config' | 'configuration' | 'project' | 'development' | 'generation' | 'analysis' | 'media' | 'conversation' | 'utilities' | 'integration' | 'advanced' | 'system';
69
10
  interface CommandArgs {
70
11
  raw: string[];
71
12
  parsed: Record<string, unknown>;
@@ -73,21 +14,20 @@ interface CommandArgs {
73
14
  options: Record<string, string>;
74
15
  }
75
16
  interface CommandContext {
76
- conversation: ConversationContext;
77
17
  user?: {
78
18
  id: string;
79
19
  email?: string;
80
20
  role?: string;
81
- };
21
+ } | null;
82
22
  session: {
83
23
  id: string;
84
- startTime: Date;
85
24
  commandHistory: string[];
86
25
  };
26
+ conversation?: {
27
+ history: any[];
28
+ };
87
29
  environment: {
88
30
  cwd: string;
89
- platform: string;
90
- nodeVersion: string;
91
31
  };
92
32
  }
93
33
  interface CommandResult {
@@ -181,7 +121,7 @@ declare abstract class BaseCommand implements ISlashCommand {
181
121
  /**
182
122
  * Validate command arguments
183
123
  */
184
- validate(args: CommandArgs): Promise<ValidationResult>;
124
+ validate(_args: CommandArgs): Promise<ValidationResult>;
185
125
  /**
186
126
  * Execute the command - must be implemented by subclasses
187
127
  */
@@ -300,7 +240,7 @@ declare const commandRegistry: CommandRegistry;
300
240
  */
301
241
  declare function initializeSlashCommands(): Promise<void>;
302
242
  /**
303
- * Get command suggestions for auto-complete with fuzzy matching
243
+ * Get command suggestions for auto-complete
304
244
  */
305
245
  declare function getCommandSuggestions(input: string): string[];
306
246
  /**
@@ -821,6 +761,163 @@ interface PerformanceConfig {
821
761
  batchSize: number;
822
762
  timeout: number;
823
763
  memoryLimit: number;
764
+ targetLatency?: number;
765
+ }
766
+
767
+ /**
768
+ * MARIA Memory System - System 1 Memory Implementation
769
+ *
770
+ * Fast, intuitive memory patterns for immediate responses
771
+ * Handles programming concepts, code patterns, and user preferences
772
+ */
773
+
774
+ declare class System1MemoryManager implements System1Memory {
775
+ private knowledgeNodes;
776
+ userPreferences: UserPreferenceSet;
777
+ private conceptGraph;
778
+ private interactionHistory;
779
+ private patternLibrary;
780
+ private config;
781
+ private cache;
782
+ private lastAccessTimes;
783
+ constructor(config: System1Config);
784
+ get programmingConcepts(): KnowledgeNode[];
785
+ get businessLogic(): ConceptGraph;
786
+ get pastInteractions(): InteractionHistory;
787
+ get codePatterns(): PatternLibrary;
788
+ addKnowledgeNode(type: KnowledgeNode['type'], name: string, content: string, embedding: number[], metadata?: Partial<NodeMetadata>): Promise<KnowledgeNode>;
789
+ getKnowledgeNode(id: string): Promise<KnowledgeNode | null>;
790
+ searchKnowledgeNodes(query: string, queryEmbedding: number[], limit?: number): Promise<KnowledgeNode[]>;
791
+ updateKnowledgeNode(id: string, updates: Partial<KnowledgeNode>): Promise<boolean>;
792
+ addConceptEdge(sourceId: string, targetId: string, type: ConceptEdge['type'], weight?: number, confidence?: number): Promise<ConceptEdge>;
793
+ getRelatedConcepts(nodeId: string, maxDepth?: number): Promise<KnowledgeNode[]>;
794
+ addCodePattern(pattern: Omit<CodePattern, 'id'>): Promise<CodePattern>;
795
+ findCodePatterns(language?: string, framework?: string, useCase?: string, limit?: number): Promise<CodePattern[]>;
796
+ addAntiPattern(antiPattern: Omit<AntiPattern, 'id'>): Promise<AntiPattern>;
797
+ detectAntiPatterns(code: string): Promise<AntiPattern[]>;
798
+ recordSession(session: SessionRecord): Promise<void>;
799
+ updateCommandHistory(command: string): Promise<void>;
800
+ getFrequentCommands(limit?: number): Promise<CommandHistory[]>;
801
+ getRecentCommands(limit?: number): Promise<CommandHistory[]>;
802
+ updateUserPreferences(updates: Partial<UserPreferenceSet>): Promise<void>;
803
+ getUserPreference<K extends keyof UserPreferenceSet>(key: K): Promise<UserPreferenceSet[K]>;
804
+ processMemoryEvent(event: MemoryEvent): Promise<void>;
805
+ cleanupLeastUsedNodes(): Promise<void>;
806
+ compressMemory(): Promise<void>;
807
+ private generateNodeId;
808
+ private generatePatternId;
809
+ private calculateCosineSimilarity;
810
+ private applyAccessDecay;
811
+ private calculateUsageScore;
812
+ private invalidateCache;
813
+ private detectUsagePatterns;
814
+ private processCodeGenerationEvent;
815
+ private processPatternRecognitionEvent;
816
+ private processLearningUpdateEvent;
817
+ private extractCodePatterns;
818
+ private adaptUserPreferences;
819
+ private mergeimilarPatterns;
820
+ private calculatePatternSimilarity;
821
+ private mergePatterns;
822
+ private initializeDefaultPreferences;
823
+ }
824
+
825
+ /**
826
+ * MARIA Memory System - System 2 Memory Implementation
827
+ *
828
+ * Deliberate reasoning and quality traces for complex decision making
829
+ * Handles reasoning steps, quality evaluation, and improvement suggestions
830
+ */
831
+
832
+ declare class System2MemoryManager implements System2Memory {
833
+ private reasoningTraces;
834
+ private qualityMetrics;
835
+ private decisionTrees;
836
+ private enhancements;
837
+ private reflectionEntries;
838
+ private config;
839
+ private analysisCache;
840
+ constructor(config: System2Config);
841
+ get reasoningSteps(): ReasoningTrace[];
842
+ get qualityEvaluation(): QualityMetrics;
843
+ get decisionContext(): DecisionTree;
844
+ get improvementSuggestions(): Enhancement[];
845
+ get reflectionData(): ReflectionEntry[];
846
+ startReasoningTrace(context: ReasoningContext, initialStep?: string): Promise<ReasoningTrace>;
847
+ addReasoningStep(traceId: string, stepData: Omit<ReasoningStep, 'id' | 'confidence' | 'duration' | 'dependencies'>): Promise<ReasoningStep>;
848
+ completeReasoningTrace(traceId: string, conclusion: string, confidence: number): Promise<ReasoningTrace>;
849
+ addAlternativeReasoning(traceId: string, alternative: Omit<AlternativeReasoning, 'id'>): Promise<AlternativeReasoning>;
850
+ getReasoningTrace(traceId: string): Promise<ReasoningTrace | null>;
851
+ searchReasoningTraces(query: {
852
+ domain?: string;
853
+ complexity?: string;
854
+ minQuality?: number;
855
+ timeframe?: {
856
+ start: Date;
857
+ end: Date;
858
+ };
859
+ }, limit?: number): Promise<ReasoningTrace[]>;
860
+ createDecisionTree(domain: string, initialCondition: string): Promise<DecisionTree>;
861
+ addDecisionNode(treeId: string, parentNodeId: string, node: Omit<DecisionNode, 'id'>): Promise<DecisionNode>;
862
+ addEvidence(treeId: string, nodeId: string, evidence: Evidence): Promise<void>;
863
+ queryDecisionTree(treeId: string, context: Record<string, unknown>): Promise<DecisionNode[]>;
864
+ proposeEnhancement(enhancement: Omit<Enhancement, 'id' | 'status'>): Promise<Enhancement>;
865
+ updateEnhancementStatus(enhancementId: string, status: Enhancement['status'], feedback?: string): Promise<boolean>;
866
+ getEnhancementsByType(type: Enhancement['type']): Promise<Enhancement[]>;
867
+ addReflectionEntry(trigger: string, observation: string, analysis: string, insight: string, confidence?: number): Promise<ReflectionEntry>;
868
+ addActionItem(reflectionId: string, actionItem: Omit<ActionItem, 'id' | 'status'>): Promise<ActionItem>;
869
+ getReflectionInsights(timeframe?: {
870
+ start: Date;
871
+ end: Date;
872
+ }, minConfidence?: number): Promise<ReflectionEntry[]>;
873
+ processMemoryEvent(event: MemoryEvent): Promise<void>;
874
+ assessCodeQuality(code: string, _language: string, context?: Record<string, unknown>): Promise<CodeQualityMetrics>;
875
+ updateQualityMetrics(metrics: Partial<QualityMetrics>): Promise<void>;
876
+ private generateTraceId;
877
+ private generateStepId;
878
+ private generateAlternativeId;
879
+ private generateDecisionTreeId;
880
+ private generateNodeId;
881
+ private generateEnhancementId;
882
+ private generateReflectionId;
883
+ private generateActionItemId;
884
+ private assessComplexity;
885
+ private identifyDomain;
886
+ private calculateStepConfidence;
887
+ private identifyDependencies;
888
+ private updateTraceQuality;
889
+ private calculateReasoningQuality;
890
+ private calculateCoherence;
891
+ private calculateCompleteness;
892
+ private calculateAccuracy;
893
+ private calculateEfficiency;
894
+ private calculateCreativity;
895
+ private generateImprovementSuggestions;
896
+ private updateGlobalQualityMetrics;
897
+ private createEmptyDecisionTree;
898
+ private findDecisionNode;
899
+ private calculateTreeComplexity;
900
+ private calculateNodeConfidence;
901
+ private traverseDecisionTree;
902
+ private evaluateCondition;
903
+ private shouldAutoApprove;
904
+ private evaluateEnhancementImpact;
905
+ private generateActionItems;
906
+ private processCodeGenerationEvent;
907
+ private processBugFixEvent;
908
+ private processQualityImprovementEvent;
909
+ private processGenericEvent;
910
+ private manageTraceLimit;
911
+ private calculateMaintainability;
912
+ private calculateReadability;
913
+ private calculateTestability;
914
+ private calculatePerformance;
915
+ private calculateSecurity;
916
+ private calculateBugDensity;
917
+ private calculateCyclomaticComplexity;
918
+ private calculateBasicComplexity;
919
+ private hashCode;
920
+ private initializeQualityMetrics;
824
921
  }
825
922
 
826
923
  /**
@@ -897,13 +994,23 @@ declare class DualMemoryEngine {
897
994
  private executeCombinedOperation;
898
995
  private combineResults;
899
996
  private generateCombinedSuggestions;
900
- private processEvent;
997
+ processEvent(event: MemoryEvent): Promise<void>;
901
998
  private determineEventRouting;
902
999
  private adaptFromEvent;
903
1000
  private startBackgroundProcessing;
904
1001
  private processEventQueue;
905
1002
  private cleanupCache;
906
1003
  private optimizeMemory;
1004
+ /**
1005
+ * Get System 1 memory manager instance
1006
+ * @returns System1MemoryManager instance
1007
+ */
1008
+ getSystem1(): System1MemoryManager;
1009
+ /**
1010
+ * Get System 2 memory manager instance
1011
+ * @returns System2MemoryManager instance
1012
+ */
1013
+ getSystem2(): System2MemoryManager;
907
1014
  private generateCacheKey;
908
1015
  private isCacheValid;
909
1016
  private updateOperationMetrics;
@@ -1064,162 +1171,6 @@ declare class MemoryCoordinator {
1064
1171
  destroy(): void;
1065
1172
  }
1066
1173
 
1067
- /**
1068
- * MARIA Memory System - System 1 Memory Implementation
1069
- *
1070
- * Fast, intuitive memory patterns for immediate responses
1071
- * Handles programming concepts, code patterns, and user preferences
1072
- */
1073
-
1074
- declare class System1MemoryManager implements System1Memory {
1075
- private knowledgeNodes;
1076
- userPreferences: UserPreferenceSet;
1077
- private conceptGraph;
1078
- private interactionHistory;
1079
- private patternLibrary;
1080
- private config;
1081
- private cache;
1082
- private lastAccessTimes;
1083
- constructor(config: System1Config);
1084
- get programmingConcepts(): KnowledgeNode[];
1085
- get businessLogic(): ConceptGraph;
1086
- get pastInteractions(): InteractionHistory;
1087
- get codePatterns(): PatternLibrary;
1088
- addKnowledgeNode(type: KnowledgeNode['type'], name: string, content: string, embedding: number[], metadata?: Partial<NodeMetadata>): Promise<KnowledgeNode>;
1089
- getKnowledgeNode(id: string): Promise<KnowledgeNode | null>;
1090
- searchKnowledgeNodes(query: string, queryEmbedding: number[], limit?: number): Promise<KnowledgeNode[]>;
1091
- updateKnowledgeNode(id: string, updates: Partial<KnowledgeNode>): Promise<boolean>;
1092
- addConceptEdge(sourceId: string, targetId: string, type: ConceptEdge['type'], weight?: number, confidence?: number): Promise<ConceptEdge>;
1093
- getRelatedConcepts(nodeId: string, maxDepth?: number): Promise<KnowledgeNode[]>;
1094
- addCodePattern(pattern: Omit<CodePattern, 'id'>): Promise<CodePattern>;
1095
- findCodePatterns(language?: string, framework?: string, useCase?: string, limit?: number): Promise<CodePattern[]>;
1096
- addAntiPattern(antiPattern: Omit<AntiPattern, 'id'>): Promise<AntiPattern>;
1097
- detectAntiPatterns(code: string): Promise<AntiPattern[]>;
1098
- recordSession(session: SessionRecord): Promise<void>;
1099
- updateCommandHistory(command: string): Promise<void>;
1100
- getFrequentCommands(limit?: number): Promise<CommandHistory[]>;
1101
- getRecentCommands(limit?: number): Promise<CommandHistory[]>;
1102
- updateUserPreferences(updates: Partial<UserPreferenceSet>): Promise<void>;
1103
- getUserPreference<K extends keyof UserPreferenceSet>(key: K): Promise<UserPreferenceSet[K]>;
1104
- processMemoryEvent(event: MemoryEvent): Promise<void>;
1105
- cleanupLeastUsedNodes(): Promise<void>;
1106
- compressMemory(): Promise<void>;
1107
- private generateNodeId;
1108
- private generatePatternId;
1109
- private calculateCosineSimilarity;
1110
- private applyAccessDecay;
1111
- private calculateUsageScore;
1112
- private invalidateCache;
1113
- private detectUsagePatterns;
1114
- private processCodeGenerationEvent;
1115
- private processPatternRecognitionEvent;
1116
- private processLearningUpdateEvent;
1117
- private extractCodePatterns;
1118
- private adaptUserPreferences;
1119
- private mergeimilarPatterns;
1120
- private calculatePatternSimilarity;
1121
- private mergePatterns;
1122
- private initializeDefaultPreferences;
1123
- }
1124
-
1125
- /**
1126
- * MARIA Memory System - System 2 Memory Implementation
1127
- *
1128
- * Deliberate reasoning and quality traces for complex decision making
1129
- * Handles reasoning steps, quality evaluation, and improvement suggestions
1130
- */
1131
-
1132
- declare class System2MemoryManager implements System2Memory {
1133
- private reasoningTraces;
1134
- private qualityMetrics;
1135
- private decisionTrees;
1136
- private enhancements;
1137
- private reflectionEntries;
1138
- private config;
1139
- private analysisCache;
1140
- constructor(config: System2Config);
1141
- get reasoningSteps(): ReasoningTrace[];
1142
- get qualityEvaluation(): QualityMetrics;
1143
- get decisionContext(): DecisionTree;
1144
- get improvementSuggestions(): Enhancement[];
1145
- get reflectionData(): ReflectionEntry[];
1146
- startReasoningTrace(context: ReasoningContext, initialStep?: string): Promise<ReasoningTrace>;
1147
- addReasoningStep(traceId: string, stepData: Omit<ReasoningStep, 'id' | 'confidence' | 'duration' | 'dependencies'>): Promise<ReasoningStep>;
1148
- completeReasoningTrace(traceId: string, conclusion: string, confidence: number): Promise<ReasoningTrace>;
1149
- addAlternativeReasoning(traceId: string, alternative: Omit<AlternativeReasoning, 'id'>): Promise<AlternativeReasoning>;
1150
- getReasoningTrace(traceId: string): Promise<ReasoningTrace | null>;
1151
- searchReasoningTraces(query: {
1152
- domain?: string;
1153
- complexity?: string;
1154
- minQuality?: number;
1155
- timeframe?: {
1156
- start: Date;
1157
- end: Date;
1158
- };
1159
- }, limit?: number): Promise<ReasoningTrace[]>;
1160
- createDecisionTree(domain: string, initialCondition: string): Promise<DecisionTree>;
1161
- addDecisionNode(treeId: string, parentNodeId: string, node: Omit<DecisionNode, 'id'>): Promise<DecisionNode>;
1162
- addEvidence(treeId: string, nodeId: string, evidence: Evidence): Promise<void>;
1163
- queryDecisionTree(treeId: string, context: Record<string, unknown>): Promise<DecisionNode[]>;
1164
- proposeEnhancement(enhancement: Omit<Enhancement, 'id' | 'status'>): Promise<Enhancement>;
1165
- updateEnhancementStatus(enhancementId: string, status: Enhancement['status'], feedback?: string): Promise<boolean>;
1166
- getEnhancementsByType(type: Enhancement['type']): Promise<Enhancement[]>;
1167
- addReflectionEntry(trigger: string, observation: string, analysis: string, insight: string, confidence?: number): Promise<ReflectionEntry>;
1168
- addActionItem(reflectionId: string, actionItem: Omit<ActionItem, 'id' | 'status'>): Promise<ActionItem>;
1169
- getReflectionInsights(timeframe?: {
1170
- start: Date;
1171
- end: Date;
1172
- }, minConfidence?: number): Promise<ReflectionEntry[]>;
1173
- processMemoryEvent(event: MemoryEvent): Promise<void>;
1174
- assessCodeQuality(code: string, _language: string, context?: Record<string, unknown>): Promise<CodeQualityMetrics>;
1175
- updateQualityMetrics(metrics: Partial<QualityMetrics>): Promise<void>;
1176
- private generateTraceId;
1177
- private generateStepId;
1178
- private generateAlternativeId;
1179
- private generateDecisionTreeId;
1180
- private generateNodeId;
1181
- private generateEnhancementId;
1182
- private generateReflectionId;
1183
- private generateActionItemId;
1184
- private assessComplexity;
1185
- private identifyDomain;
1186
- private calculateStepConfidence;
1187
- private identifyDependencies;
1188
- private updateTraceQuality;
1189
- private calculateReasoningQuality;
1190
- private calculateCoherence;
1191
- private calculateCompleteness;
1192
- private calculateAccuracy;
1193
- private calculateEfficiency;
1194
- private calculateCreativity;
1195
- private generateImprovementSuggestions;
1196
- private updateGlobalQualityMetrics;
1197
- private createEmptyDecisionTree;
1198
- private findDecisionNode;
1199
- private calculateTreeComplexity;
1200
- private calculateNodeConfidence;
1201
- private traverseDecisionTree;
1202
- private evaluateCondition;
1203
- private shouldAutoApprove;
1204
- private evaluateEnhancementImpact;
1205
- private generateActionItems;
1206
- private processCodeGenerationEvent;
1207
- private processBugFixEvent;
1208
- private processQualityImprovementEvent;
1209
- private processGenericEvent;
1210
- private manageTraceLimit;
1211
- private calculateMaintainability;
1212
- private calculateReadability;
1213
- private calculateTestability;
1214
- private calculatePerformance;
1215
- private calculateSecurity;
1216
- private calculateBugDensity;
1217
- private calculateCyclomaticComplexity;
1218
- private calculateBasicComplexity;
1219
- private hashCode;
1220
- private initializeQualityMetrics;
1221
- }
1222
-
1223
1174
  /**
1224
1175
  * Internal Mode System - Type Definitions
1225
1176
  *