@timmeck/brain 1.0.0 → 1.1.0

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.
Files changed (198) hide show
  1. package/BRAIN_PLAN.md +3324 -3324
  2. package/LICENSE +21 -21
  3. package/README.md +194 -188
  4. package/dist/brain.js +2 -0
  5. package/dist/brain.js.map +1 -1
  6. package/dist/cli/colors.d.ts +50 -0
  7. package/dist/cli/colors.js +106 -0
  8. package/dist/cli/colors.js.map +1 -0
  9. package/dist/cli/commands/config.d.ts +2 -0
  10. package/dist/cli/commands/config.js +165 -0
  11. package/dist/cli/commands/config.js.map +1 -0
  12. package/dist/cli/commands/dashboard.js +222 -8
  13. package/dist/cli/commands/dashboard.js.map +1 -1
  14. package/dist/cli/commands/export.js +3 -0
  15. package/dist/cli/commands/export.js.map +1 -1
  16. package/dist/cli/commands/import.js +24 -15
  17. package/dist/cli/commands/import.js.map +1 -1
  18. package/dist/cli/commands/insights.js +33 -6
  19. package/dist/cli/commands/insights.js.map +1 -1
  20. package/dist/cli/commands/learn.d.ts +2 -0
  21. package/dist/cli/commands/learn.js +22 -0
  22. package/dist/cli/commands/learn.js.map +1 -0
  23. package/dist/cli/commands/modules.js +25 -6
  24. package/dist/cli/commands/modules.js.map +1 -1
  25. package/dist/cli/commands/network.js +15 -9
  26. package/dist/cli/commands/network.js.map +1 -1
  27. package/dist/cli/commands/query.js +92 -25
  28. package/dist/cli/commands/query.js.map +1 -1
  29. package/dist/cli/commands/start.js +5 -4
  30. package/dist/cli/commands/start.js.map +1 -1
  31. package/dist/cli/commands/status.js +19 -16
  32. package/dist/cli/commands/status.js.map +1 -1
  33. package/dist/cli/commands/stop.js +5 -4
  34. package/dist/cli/commands/stop.js.map +1 -1
  35. package/dist/cli/ipc-helper.js +4 -3
  36. package/dist/cli/ipc-helper.js.map +1 -1
  37. package/dist/db/migrations/001_core_schema.js +115 -115
  38. package/dist/db/migrations/002_learning_schema.js +33 -33
  39. package/dist/db/migrations/003_code_schema.js +48 -48
  40. package/dist/db/migrations/004_synapses_schema.js +52 -52
  41. package/dist/db/migrations/005_fts_indexes.js +73 -73
  42. package/dist/db/migrations/index.js +6 -6
  43. package/dist/db/repositories/antipattern.repository.js +3 -3
  44. package/dist/db/repositories/code-module.repository.d.ts +1 -0
  45. package/dist/db/repositories/code-module.repository.js +8 -0
  46. package/dist/db/repositories/code-module.repository.js.map +1 -1
  47. package/dist/db/repositories/error.repository.js +46 -46
  48. package/dist/db/repositories/insight.repository.js +3 -3
  49. package/dist/db/repositories/notification.repository.js +3 -3
  50. package/dist/db/repositories/project.repository.js +21 -21
  51. package/dist/db/repositories/rule.repository.js +24 -24
  52. package/dist/db/repositories/solution.repository.js +50 -50
  53. package/dist/db/repositories/synapse.repository.js +18 -18
  54. package/dist/db/repositories/terminal.repository.js +24 -24
  55. package/dist/index.js +4 -0
  56. package/dist/index.js.map +1 -1
  57. package/dist/ipc/router.d.ts +2 -0
  58. package/dist/ipc/router.js +7 -1
  59. package/dist/ipc/router.js.map +1 -1
  60. package/dist/services/code.service.d.ts +1 -1
  61. package/dist/services/code.service.js +5 -2
  62. package/dist/services/code.service.js.map +1 -1
  63. package/package.json +5 -4
  64. package/src/brain.ts +3 -0
  65. package/src/cli/colors.ts +116 -0
  66. package/src/cli/commands/config.ts +169 -0
  67. package/src/cli/commands/dashboard.ts +231 -8
  68. package/src/cli/commands/export.ts +4 -0
  69. package/src/cli/commands/import.ts +24 -15
  70. package/src/cli/commands/insights.ts +37 -5
  71. package/src/cli/commands/learn.ts +24 -0
  72. package/src/cli/commands/modules.ts +28 -5
  73. package/src/cli/commands/network.ts +15 -9
  74. package/src/cli/commands/query.ts +103 -26
  75. package/src/cli/commands/start.ts +5 -4
  76. package/src/cli/commands/status.ts +19 -16
  77. package/src/cli/commands/stop.ts +5 -4
  78. package/src/cli/ipc-helper.ts +4 -3
  79. package/src/code/analyzer.ts +77 -77
  80. package/src/code/fingerprint.ts +87 -87
  81. package/src/code/matcher.ts +64 -64
  82. package/src/code/parsers/generic.ts +29 -29
  83. package/src/code/parsers/python.ts +54 -54
  84. package/src/code/parsers/typescript.ts +65 -65
  85. package/src/code/registry.ts +60 -60
  86. package/src/code/scorer.ts +108 -108
  87. package/src/config.ts +111 -111
  88. package/src/db/connection.ts +22 -22
  89. package/src/db/migrations/001_core_schema.ts +120 -120
  90. package/src/db/migrations/002_learning_schema.ts +38 -38
  91. package/src/db/migrations/003_code_schema.ts +53 -53
  92. package/src/db/migrations/004_synapses_schema.ts +57 -57
  93. package/src/db/migrations/005_fts_indexes.ts +78 -78
  94. package/src/db/migrations/006_synapses_phase3.ts +17 -17
  95. package/src/db/migrations/index.ts +64 -64
  96. package/src/db/repositories/antipattern.repository.ts +66 -66
  97. package/src/db/repositories/code-module.repository.ts +9 -0
  98. package/src/db/repositories/error.repository.ts +149 -149
  99. package/src/db/repositories/insight.repository.ts +78 -78
  100. package/src/db/repositories/notification.repository.ts +66 -66
  101. package/src/db/repositories/project.repository.ts +93 -93
  102. package/src/db/repositories/rule.repository.ts +108 -108
  103. package/src/db/repositories/solution.repository.ts +154 -154
  104. package/src/db/repositories/synapse.repository.ts +153 -153
  105. package/src/db/repositories/terminal.repository.ts +101 -101
  106. package/src/hooks/post-tool-use.ts +90 -90
  107. package/src/hooks/post-write.ts +117 -117
  108. package/src/index.ts +4 -0
  109. package/src/ipc/client.ts +118 -118
  110. package/src/ipc/protocol.ts +35 -35
  111. package/src/ipc/router.ts +9 -1
  112. package/src/ipc/server.ts +110 -110
  113. package/src/learning/confidence-scorer.ts +47 -47
  114. package/src/learning/decay.ts +46 -46
  115. package/src/learning/learning-engine.ts +162 -162
  116. package/src/learning/pattern-extractor.ts +90 -90
  117. package/src/learning/rule-generator.ts +74 -74
  118. package/src/matching/error-matcher.ts +115 -115
  119. package/src/matching/fingerprint.ts +29 -29
  120. package/src/matching/similarity.ts +61 -61
  121. package/src/matching/tfidf.ts +74 -74
  122. package/src/matching/tokenizer.ts +41 -41
  123. package/src/mcp/auto-detect.ts +93 -93
  124. package/src/mcp/server.ts +73 -73
  125. package/src/mcp/tools.ts +290 -290
  126. package/src/parsing/error-parser.ts +28 -28
  127. package/src/parsing/parsers/compiler.ts +93 -93
  128. package/src/parsing/parsers/generic.ts +28 -28
  129. package/src/parsing/parsers/go.ts +97 -97
  130. package/src/parsing/parsers/node.ts +69 -69
  131. package/src/parsing/parsers/python.ts +62 -62
  132. package/src/parsing/parsers/rust.ts +50 -50
  133. package/src/parsing/parsers/shell.ts +42 -42
  134. package/src/parsing/types.ts +47 -47
  135. package/src/research/gap-analyzer.ts +135 -135
  136. package/src/research/insight-generator.ts +123 -123
  137. package/src/research/research-engine.ts +116 -116
  138. package/src/research/synergy-detector.ts +126 -126
  139. package/src/research/template-extractor.ts +130 -130
  140. package/src/research/trend-analyzer.ts +127 -127
  141. package/src/services/analytics.service.ts +87 -87
  142. package/src/services/code.service.ts +5 -2
  143. package/src/services/error.service.ts +164 -164
  144. package/src/services/notification.service.ts +41 -41
  145. package/src/services/prevention.service.ts +119 -119
  146. package/src/services/research.service.ts +93 -93
  147. package/src/services/solution.service.ts +116 -116
  148. package/src/services/synapse.service.ts +59 -59
  149. package/src/services/terminal.service.ts +81 -81
  150. package/src/synapses/activation.ts +80 -80
  151. package/src/synapses/decay.ts +38 -38
  152. package/src/synapses/hebbian.ts +69 -69
  153. package/src/synapses/pathfinder.ts +81 -81
  154. package/src/synapses/synapse-manager.ts +109 -109
  155. package/src/types/code.types.ts +52 -52
  156. package/src/types/config.types.ts +79 -79
  157. package/src/types/error.types.ts +67 -67
  158. package/src/types/ipc.types.ts +8 -8
  159. package/src/types/mcp.types.ts +53 -53
  160. package/src/types/research.types.ts +28 -28
  161. package/src/types/solution.types.ts +30 -30
  162. package/src/types/synapse.types.ts +49 -49
  163. package/src/utils/events.ts +45 -45
  164. package/src/utils/hash.ts +5 -5
  165. package/src/utils/logger.ts +48 -48
  166. package/src/utils/paths.ts +19 -19
  167. package/tests/fixtures/code-modules/modules.ts +83 -83
  168. package/tests/fixtures/errors/go.ts +9 -9
  169. package/tests/fixtures/errors/node.ts +24 -24
  170. package/tests/fixtures/errors/python.ts +21 -21
  171. package/tests/fixtures/errors/rust.ts +25 -25
  172. package/tests/fixtures/errors/shell.ts +15 -15
  173. package/tests/fixtures/solutions/solutions.ts +27 -27
  174. package/tests/helpers/setup-db.ts +52 -52
  175. package/tests/integration/code-flow.test.ts +86 -86
  176. package/tests/integration/error-flow.test.ts +83 -83
  177. package/tests/integration/ipc-flow.test.ts +166 -166
  178. package/tests/integration/learning-cycle.test.ts +82 -82
  179. package/tests/integration/synapse-flow.test.ts +117 -117
  180. package/tests/unit/code/analyzer.test.ts +58 -58
  181. package/tests/unit/code/fingerprint.test.ts +51 -51
  182. package/tests/unit/code/scorer.test.ts +55 -55
  183. package/tests/unit/learning/confidence-scorer.test.ts +60 -60
  184. package/tests/unit/learning/decay.test.ts +45 -45
  185. package/tests/unit/learning/pattern-extractor.test.ts +50 -50
  186. package/tests/unit/matching/error-matcher.test.ts +69 -69
  187. package/tests/unit/matching/fingerprint.test.ts +47 -47
  188. package/tests/unit/matching/similarity.test.ts +65 -65
  189. package/tests/unit/matching/tfidf.test.ts +71 -71
  190. package/tests/unit/matching/tokenizer.test.ts +83 -83
  191. package/tests/unit/parsing/parsers.test.ts +113 -113
  192. package/tests/unit/research/gap-analyzer.test.ts +45 -45
  193. package/tests/unit/research/trend-analyzer.test.ts +45 -45
  194. package/tests/unit/synapses/activation.test.ts +80 -80
  195. package/tests/unit/synapses/decay.test.ts +27 -27
  196. package/tests/unit/synapses/hebbian.test.ts +96 -96
  197. package/tests/unit/synapses/pathfinder.test.ts +72 -72
  198. package/tsconfig.json +18 -18
@@ -1,123 +1,123 @@
1
- import type { ResearchConfig } from '../types/config.types.js';
2
- import type { ProjectRepository } from '../db/repositories/project.repository.js';
3
- import type { ErrorRepository } from '../db/repositories/error.repository.js';
4
- import type { SolutionRepository } from '../db/repositories/solution.repository.js';
5
- import type { CodeModuleRepository } from '../db/repositories/code-module.repository.js';
6
- import type { InsightRepository } from '../db/repositories/insight.repository.js';
7
- import { getLogger } from '../utils/logger.js';
8
-
9
- /**
10
- * Generates project suggestions, tool ideas, and optimization hints.
11
- */
12
- export class InsightGenerator {
13
- private logger = getLogger();
14
-
15
- constructor(
16
- private projectRepo: ProjectRepository,
17
- private errorRepo: ErrorRepository,
18
- private solutionRepo: SolutionRepository,
19
- private codeModuleRepo: CodeModuleRepository,
20
- private insightRepo: InsightRepository,
21
- private config: ResearchConfig,
22
- ) {}
23
-
24
- generate(): number {
25
- let insightsCreated = 0;
26
-
27
- insightsCreated += this.suggestRefactoring();
28
- insightsCreated += this.suggestErrorTypeTools();
29
- this.reprioritizeInsights();
30
-
31
- this.logger.info(`Insight generation complete: ${insightsCreated} new insights`);
32
- return insightsCreated;
33
- }
34
-
35
- private suggestRefactoring(): number {
36
- const projects = this.projectRepo.getAll();
37
- let count = 0;
38
- const expiresAt = new Date(Date.now() + this.config.insightExpiryDays * 86400000).toISOString();
39
-
40
- for (const project of projects) {
41
- const modules = this.codeModuleRepo.findByProject(project.id);
42
- const problematic = modules.filter(m =>
43
- (m.complexity ?? 0) > 10 && m.reusability_score < 0.3 && m.lines_of_code > 50,
44
- );
45
-
46
- if (problematic.length > 0) {
47
- this.insightRepo.create({
48
- type: 'optimization',
49
- title: `${problematic.length} complex modules need refactoring in ${project.name}`,
50
- description: `These modules have high complexity (>10), low reusability (<30%), and are non-trivial (>50 LOC). Refactoring would improve maintainability.`,
51
- evidence: JSON.stringify({
52
- modules: problematic.map(m => ({
53
- id: m.id,
54
- name: m.name,
55
- complexity: m.complexity,
56
- reusability: m.reusability_score,
57
- loc: m.lines_of_code,
58
- })),
59
- }),
60
- priority: Math.min(70, 30 + problematic.length * 10),
61
- project_id: project.id,
62
- active: 1,
63
- expires_at: expiresAt,
64
- });
65
- count++;
66
- }
67
- }
68
-
69
- return count;
70
- }
71
-
72
- private suggestErrorTypeTools(): number {
73
- const projects = this.projectRepo.getAll();
74
- let count = 0;
75
- const expiresAt = new Date(Date.now() + this.config.insightExpiryDays * 86400000).toISOString();
76
-
77
- for (const project of projects) {
78
- const errors = this.errorRepo.findByProject(project.id);
79
- if (errors.length < this.config.minDataPoints) continue;
80
-
81
- // Group errors by type
82
- const byType = new Map<string, number>();
83
- for (const error of errors) {
84
- byType.set(error.type, (byType.get(error.type) ?? 0) + error.occurrence_count);
85
- }
86
-
87
- // Find dominant error types
88
- for (const [errorType, totalOccurrences] of byType) {
89
- if (totalOccurrences >= this.config.gapMinOccurrences * 3) {
90
- this.insightRepo.create({
91
- type: 'suggestion',
92
- title: `Frequent error type: ${errorType} in ${project.name}`,
93
- description: `${errorType} has ${totalOccurrences} total occurrences. Consider adding linting rules, type checking, or tooling to prevent this class of errors.`,
94
- evidence: JSON.stringify({ errorType, totalOccurrences, projectId: project.id }),
95
- priority: Math.min(65, 30 + Math.round(totalOccurrences / 5)),
96
- project_id: project.id,
97
- active: 1,
98
- expires_at: expiresAt,
99
- });
100
- count++;
101
- }
102
- }
103
- }
104
-
105
- return count;
106
- }
107
-
108
- private reprioritizeInsights(): void {
109
- const activeInsights = this.insightRepo.findActive();
110
-
111
- for (const insight of activeInsights) {
112
- if (insight.type === 'warning') {
113
- const ageMs = Date.now() - new Date(insight.created_at).getTime();
114
- const ageDays = ageMs / 86400000;
115
- if (ageDays > 3 && insight.priority < 80) {
116
- this.insightRepo.update(insight.id, {
117
- priority: Math.min(85, insight.priority + 10),
118
- });
119
- }
120
- }
121
- }
122
- }
123
- }
1
+ import type { ResearchConfig } from '../types/config.types.js';
2
+ import type { ProjectRepository } from '../db/repositories/project.repository.js';
3
+ import type { ErrorRepository } from '../db/repositories/error.repository.js';
4
+ import type { SolutionRepository } from '../db/repositories/solution.repository.js';
5
+ import type { CodeModuleRepository } from '../db/repositories/code-module.repository.js';
6
+ import type { InsightRepository } from '../db/repositories/insight.repository.js';
7
+ import { getLogger } from '../utils/logger.js';
8
+
9
+ /**
10
+ * Generates project suggestions, tool ideas, and optimization hints.
11
+ */
12
+ export class InsightGenerator {
13
+ private logger = getLogger();
14
+
15
+ constructor(
16
+ private projectRepo: ProjectRepository,
17
+ private errorRepo: ErrorRepository,
18
+ private solutionRepo: SolutionRepository,
19
+ private codeModuleRepo: CodeModuleRepository,
20
+ private insightRepo: InsightRepository,
21
+ private config: ResearchConfig,
22
+ ) {}
23
+
24
+ generate(): number {
25
+ let insightsCreated = 0;
26
+
27
+ insightsCreated += this.suggestRefactoring();
28
+ insightsCreated += this.suggestErrorTypeTools();
29
+ this.reprioritizeInsights();
30
+
31
+ this.logger.info(`Insight generation complete: ${insightsCreated} new insights`);
32
+ return insightsCreated;
33
+ }
34
+
35
+ private suggestRefactoring(): number {
36
+ const projects = this.projectRepo.getAll();
37
+ let count = 0;
38
+ const expiresAt = new Date(Date.now() + this.config.insightExpiryDays * 86400000).toISOString();
39
+
40
+ for (const project of projects) {
41
+ const modules = this.codeModuleRepo.findByProject(project.id);
42
+ const problematic = modules.filter(m =>
43
+ (m.complexity ?? 0) > 10 && m.reusability_score < 0.3 && m.lines_of_code > 50,
44
+ );
45
+
46
+ if (problematic.length > 0) {
47
+ this.insightRepo.create({
48
+ type: 'optimization',
49
+ title: `${problematic.length} complex modules need refactoring in ${project.name}`,
50
+ description: `These modules have high complexity (>10), low reusability (<30%), and are non-trivial (>50 LOC). Refactoring would improve maintainability.`,
51
+ evidence: JSON.stringify({
52
+ modules: problematic.map(m => ({
53
+ id: m.id,
54
+ name: m.name,
55
+ complexity: m.complexity,
56
+ reusability: m.reusability_score,
57
+ loc: m.lines_of_code,
58
+ })),
59
+ }),
60
+ priority: Math.min(70, 30 + problematic.length * 10),
61
+ project_id: project.id,
62
+ active: 1,
63
+ expires_at: expiresAt,
64
+ });
65
+ count++;
66
+ }
67
+ }
68
+
69
+ return count;
70
+ }
71
+
72
+ private suggestErrorTypeTools(): number {
73
+ const projects = this.projectRepo.getAll();
74
+ let count = 0;
75
+ const expiresAt = new Date(Date.now() + this.config.insightExpiryDays * 86400000).toISOString();
76
+
77
+ for (const project of projects) {
78
+ const errors = this.errorRepo.findByProject(project.id);
79
+ if (errors.length < this.config.minDataPoints) continue;
80
+
81
+ // Group errors by type
82
+ const byType = new Map<string, number>();
83
+ for (const error of errors) {
84
+ byType.set(error.type, (byType.get(error.type) ?? 0) + error.occurrence_count);
85
+ }
86
+
87
+ // Find dominant error types
88
+ for (const [errorType, totalOccurrences] of byType) {
89
+ if (totalOccurrences >= this.config.gapMinOccurrences * 3) {
90
+ this.insightRepo.create({
91
+ type: 'suggestion',
92
+ title: `Frequent error type: ${errorType} in ${project.name}`,
93
+ description: `${errorType} has ${totalOccurrences} total occurrences. Consider adding linting rules, type checking, or tooling to prevent this class of errors.`,
94
+ evidence: JSON.stringify({ errorType, totalOccurrences, projectId: project.id }),
95
+ priority: Math.min(65, 30 + Math.round(totalOccurrences / 5)),
96
+ project_id: project.id,
97
+ active: 1,
98
+ expires_at: expiresAt,
99
+ });
100
+ count++;
101
+ }
102
+ }
103
+ }
104
+
105
+ return count;
106
+ }
107
+
108
+ private reprioritizeInsights(): void {
109
+ const activeInsights = this.insightRepo.findActive();
110
+
111
+ for (const insight of activeInsights) {
112
+ if (insight.type === 'warning') {
113
+ const ageMs = Date.now() - new Date(insight.created_at).getTime();
114
+ const ageDays = ageMs / 86400000;
115
+ if (ageDays > 3 && insight.priority < 80) {
116
+ this.insightRepo.update(insight.id, {
117
+ priority: Math.min(85, insight.priority + 10),
118
+ });
119
+ }
120
+ }
121
+ }
122
+ }
123
+ }
@@ -1,116 +1,116 @@
1
- import type { ResearchConfig } from '../types/config.types.js';
2
- import type { ErrorRepository } from '../db/repositories/error.repository.js';
3
- import type { SolutionRepository } from '../db/repositories/solution.repository.js';
4
- import type { ProjectRepository } from '../db/repositories/project.repository.js';
5
- import type { CodeModuleRepository } from '../db/repositories/code-module.repository.js';
6
- import type { SynapseRepository } from '../db/repositories/synapse.repository.js';
7
- import type { InsightRepository } from '../db/repositories/insight.repository.js';
8
- import type { SynapseManager } from '../synapses/synapse-manager.js';
9
- import type { ResearchCycleResult } from '../types/research.types.js';
10
- import { TrendAnalyzer } from './trend-analyzer.js';
11
- import { GapAnalyzer } from './gap-analyzer.js';
12
- import { SynergyDetector } from './synergy-detector.js';
13
- import { TemplateExtractor } from './template-extractor.js';
14
- import { InsightGenerator } from './insight-generator.js';
15
- import { getLogger } from '../utils/logger.js';
16
-
17
- export class ResearchEngine {
18
- private timer: ReturnType<typeof setInterval> | null = null;
19
- private delayTimer: ReturnType<typeof setTimeout> | null = null;
20
- private logger = getLogger();
21
-
22
- private trendAnalyzer: TrendAnalyzer;
23
- private gapAnalyzer: GapAnalyzer;
24
- private synergyDetector: SynergyDetector;
25
- private templateExtractor: TemplateExtractor;
26
- private insightGenerator: InsightGenerator;
27
-
28
- constructor(
29
- private config: ResearchConfig,
30
- private errorRepo: ErrorRepository,
31
- private solutionRepo: SolutionRepository,
32
- private projectRepo: ProjectRepository,
33
- private codeModuleRepo: CodeModuleRepository,
34
- private synapseRepo: SynapseRepository,
35
- private insightRepo: InsightRepository,
36
- private synapseManager: SynapseManager,
37
- ) {
38
- this.trendAnalyzer = new TrendAnalyzer(errorRepo, solutionRepo, projectRepo, insightRepo, config);
39
- this.gapAnalyzer = new GapAnalyzer(errorRepo, solutionRepo, synapseRepo, projectRepo, insightRepo, config);
40
- this.synergyDetector = new SynergyDetector(synapseRepo, codeModuleRepo, solutionRepo, errorRepo, projectRepo, insightRepo, config);
41
- this.templateExtractor = new TemplateExtractor(codeModuleRepo, projectRepo, insightRepo, config);
42
- this.insightGenerator = new InsightGenerator(projectRepo, errorRepo, solutionRepo, codeModuleRepo, insightRepo, config);
43
- }
44
-
45
- start(): void {
46
- this.logger.info(`Research engine starting (interval: ${this.config.intervalMs}ms, initial delay: ${this.config.initialDelayMs}ms)`);
47
- this.delayTimer = setTimeout(() => {
48
- this.runCycle();
49
- this.timer = setInterval(() => this.runCycle(), this.config.intervalMs);
50
- }, this.config.initialDelayMs);
51
- }
52
-
53
- stop(): void {
54
- if (this.delayTimer) {
55
- clearTimeout(this.delayTimer);
56
- this.delayTimer = null;
57
- }
58
- if (this.timer) {
59
- clearInterval(this.timer);
60
- this.timer = null;
61
- }
62
- this.logger.info('Research engine stopped');
63
- }
64
-
65
- runCycle(): ResearchCycleResult {
66
- const start = Date.now();
67
- this.logger.info('Research cycle starting');
68
-
69
- const result: ResearchCycleResult = {
70
- insightsGenerated: 0,
71
- patternsFound: 0,
72
- correlationsFound: 0,
73
- duration: 0,
74
- };
75
-
76
- // Phase 1: Trend analysis
77
- const trends = this.trendAnalyzer.analyze();
78
- result.patternsFound += trends;
79
- result.insightsGenerated += trends;
80
-
81
- // Phase 2: Gap analysis
82
- const gaps = this.gapAnalyzer.analyze();
83
- result.insightsGenerated += gaps;
84
-
85
- // Phase 3: Synergy detection
86
- const synergies = this.synergyDetector.detect();
87
- result.correlationsFound += synergies;
88
- result.insightsGenerated += synergies;
89
-
90
- // Phase 4: Template extraction
91
- const templates = this.templateExtractor.extract();
92
- result.patternsFound += templates;
93
- result.insightsGenerated += templates;
94
-
95
- // Phase 5: Insight generation
96
- const generated = this.insightGenerator.generate();
97
- result.insightsGenerated += generated;
98
-
99
- // Phase 6: Insight prioritization (expire old insights)
100
- const expired = this.insightRepo.expire();
101
- if (expired > 0) {
102
- this.logger.info(`Expired ${expired} outdated insights`);
103
- }
104
-
105
- // Phase 7: Synapse maintenance
106
- const decay = this.synapseManager.runDecay();
107
- this.logger.debug(`Synapse maintenance: ${decay.decayed} decayed, ${decay.pruned} pruned`);
108
-
109
- result.duration = Date.now() - start;
110
- this.logger.info(
111
- `Research cycle complete: ${result.insightsGenerated} insights, ${result.patternsFound} patterns, ${result.correlationsFound} correlations (${result.duration}ms)`,
112
- );
113
-
114
- return result;
115
- }
116
- }
1
+ import type { ResearchConfig } from '../types/config.types.js';
2
+ import type { ErrorRepository } from '../db/repositories/error.repository.js';
3
+ import type { SolutionRepository } from '../db/repositories/solution.repository.js';
4
+ import type { ProjectRepository } from '../db/repositories/project.repository.js';
5
+ import type { CodeModuleRepository } from '../db/repositories/code-module.repository.js';
6
+ import type { SynapseRepository } from '../db/repositories/synapse.repository.js';
7
+ import type { InsightRepository } from '../db/repositories/insight.repository.js';
8
+ import type { SynapseManager } from '../synapses/synapse-manager.js';
9
+ import type { ResearchCycleResult } from '../types/research.types.js';
10
+ import { TrendAnalyzer } from './trend-analyzer.js';
11
+ import { GapAnalyzer } from './gap-analyzer.js';
12
+ import { SynergyDetector } from './synergy-detector.js';
13
+ import { TemplateExtractor } from './template-extractor.js';
14
+ import { InsightGenerator } from './insight-generator.js';
15
+ import { getLogger } from '../utils/logger.js';
16
+
17
+ export class ResearchEngine {
18
+ private timer: ReturnType<typeof setInterval> | null = null;
19
+ private delayTimer: ReturnType<typeof setTimeout> | null = null;
20
+ private logger = getLogger();
21
+
22
+ private trendAnalyzer: TrendAnalyzer;
23
+ private gapAnalyzer: GapAnalyzer;
24
+ private synergyDetector: SynergyDetector;
25
+ private templateExtractor: TemplateExtractor;
26
+ private insightGenerator: InsightGenerator;
27
+
28
+ constructor(
29
+ private config: ResearchConfig,
30
+ private errorRepo: ErrorRepository,
31
+ private solutionRepo: SolutionRepository,
32
+ private projectRepo: ProjectRepository,
33
+ private codeModuleRepo: CodeModuleRepository,
34
+ private synapseRepo: SynapseRepository,
35
+ private insightRepo: InsightRepository,
36
+ private synapseManager: SynapseManager,
37
+ ) {
38
+ this.trendAnalyzer = new TrendAnalyzer(errorRepo, solutionRepo, projectRepo, insightRepo, config);
39
+ this.gapAnalyzer = new GapAnalyzer(errorRepo, solutionRepo, synapseRepo, projectRepo, insightRepo, config);
40
+ this.synergyDetector = new SynergyDetector(synapseRepo, codeModuleRepo, solutionRepo, errorRepo, projectRepo, insightRepo, config);
41
+ this.templateExtractor = new TemplateExtractor(codeModuleRepo, projectRepo, insightRepo, config);
42
+ this.insightGenerator = new InsightGenerator(projectRepo, errorRepo, solutionRepo, codeModuleRepo, insightRepo, config);
43
+ }
44
+
45
+ start(): void {
46
+ this.logger.info(`Research engine starting (interval: ${this.config.intervalMs}ms, initial delay: ${this.config.initialDelayMs}ms)`);
47
+ this.delayTimer = setTimeout(() => {
48
+ this.runCycle();
49
+ this.timer = setInterval(() => this.runCycle(), this.config.intervalMs);
50
+ }, this.config.initialDelayMs);
51
+ }
52
+
53
+ stop(): void {
54
+ if (this.delayTimer) {
55
+ clearTimeout(this.delayTimer);
56
+ this.delayTimer = null;
57
+ }
58
+ if (this.timer) {
59
+ clearInterval(this.timer);
60
+ this.timer = null;
61
+ }
62
+ this.logger.info('Research engine stopped');
63
+ }
64
+
65
+ runCycle(): ResearchCycleResult {
66
+ const start = Date.now();
67
+ this.logger.info('Research cycle starting');
68
+
69
+ const result: ResearchCycleResult = {
70
+ insightsGenerated: 0,
71
+ patternsFound: 0,
72
+ correlationsFound: 0,
73
+ duration: 0,
74
+ };
75
+
76
+ // Phase 1: Trend analysis
77
+ const trends = this.trendAnalyzer.analyze();
78
+ result.patternsFound += trends;
79
+ result.insightsGenerated += trends;
80
+
81
+ // Phase 2: Gap analysis
82
+ const gaps = this.gapAnalyzer.analyze();
83
+ result.insightsGenerated += gaps;
84
+
85
+ // Phase 3: Synergy detection
86
+ const synergies = this.synergyDetector.detect();
87
+ result.correlationsFound += synergies;
88
+ result.insightsGenerated += synergies;
89
+
90
+ // Phase 4: Template extraction
91
+ const templates = this.templateExtractor.extract();
92
+ result.patternsFound += templates;
93
+ result.insightsGenerated += templates;
94
+
95
+ // Phase 5: Insight generation
96
+ const generated = this.insightGenerator.generate();
97
+ result.insightsGenerated += generated;
98
+
99
+ // Phase 6: Insight prioritization (expire old insights)
100
+ const expired = this.insightRepo.expire();
101
+ if (expired > 0) {
102
+ this.logger.info(`Expired ${expired} outdated insights`);
103
+ }
104
+
105
+ // Phase 7: Synapse maintenance
106
+ const decay = this.synapseManager.runDecay();
107
+ this.logger.debug(`Synapse maintenance: ${decay.decayed} decayed, ${decay.pruned} pruned`);
108
+
109
+ result.duration = Date.now() - start;
110
+ this.logger.info(
111
+ `Research cycle complete: ${result.insightsGenerated} insights, ${result.patternsFound} patterns, ${result.correlationsFound} correlations (${result.duration}ms)`,
112
+ );
113
+
114
+ return result;
115
+ }
116
+ }