@timmeck/brain 1.0.0 → 1.1.1

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 (202) 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 +8 -5
  30. package/dist/cli/commands/start.js.map +1 -1
  31. package/dist/cli/commands/status.js +21 -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/cli/update-check.d.ts +2 -0
  38. package/dist/cli/update-check.js +58 -0
  39. package/dist/cli/update-check.js.map +1 -0
  40. package/dist/db/migrations/001_core_schema.js +115 -115
  41. package/dist/db/migrations/002_learning_schema.js +33 -33
  42. package/dist/db/migrations/003_code_schema.js +48 -48
  43. package/dist/db/migrations/004_synapses_schema.js +52 -52
  44. package/dist/db/migrations/005_fts_indexes.js +73 -73
  45. package/dist/db/migrations/index.js +6 -6
  46. package/dist/db/repositories/antipattern.repository.js +3 -3
  47. package/dist/db/repositories/code-module.repository.d.ts +1 -0
  48. package/dist/db/repositories/code-module.repository.js +8 -0
  49. package/dist/db/repositories/code-module.repository.js.map +1 -1
  50. package/dist/db/repositories/error.repository.js +46 -46
  51. package/dist/db/repositories/insight.repository.js +3 -3
  52. package/dist/db/repositories/notification.repository.js +3 -3
  53. package/dist/db/repositories/project.repository.js +21 -21
  54. package/dist/db/repositories/rule.repository.js +24 -24
  55. package/dist/db/repositories/solution.repository.js +50 -50
  56. package/dist/db/repositories/synapse.repository.js +18 -18
  57. package/dist/db/repositories/terminal.repository.js +24 -24
  58. package/dist/index.js +4 -0
  59. package/dist/index.js.map +1 -1
  60. package/dist/ipc/router.d.ts +2 -0
  61. package/dist/ipc/router.js +7 -1
  62. package/dist/ipc/router.js.map +1 -1
  63. package/dist/services/code.service.d.ts +1 -1
  64. package/dist/services/code.service.js +5 -2
  65. package/dist/services/code.service.js.map +1 -1
  66. package/package.json +5 -4
  67. package/src/brain.ts +3 -0
  68. package/src/cli/colors.ts +116 -0
  69. package/src/cli/commands/config.ts +169 -0
  70. package/src/cli/commands/dashboard.ts +231 -8
  71. package/src/cli/commands/export.ts +4 -0
  72. package/src/cli/commands/import.ts +24 -15
  73. package/src/cli/commands/insights.ts +37 -5
  74. package/src/cli/commands/learn.ts +24 -0
  75. package/src/cli/commands/modules.ts +28 -5
  76. package/src/cli/commands/network.ts +15 -9
  77. package/src/cli/commands/query.ts +103 -26
  78. package/src/cli/commands/start.ts +8 -5
  79. package/src/cli/commands/status.ts +22 -16
  80. package/src/cli/commands/stop.ts +5 -4
  81. package/src/cli/ipc-helper.ts +4 -3
  82. package/src/cli/update-check.ts +63 -0
  83. package/src/code/analyzer.ts +77 -77
  84. package/src/code/fingerprint.ts +87 -87
  85. package/src/code/matcher.ts +64 -64
  86. package/src/code/parsers/generic.ts +29 -29
  87. package/src/code/parsers/python.ts +54 -54
  88. package/src/code/parsers/typescript.ts +65 -65
  89. package/src/code/registry.ts +60 -60
  90. package/src/code/scorer.ts +108 -108
  91. package/src/config.ts +111 -111
  92. package/src/db/connection.ts +22 -22
  93. package/src/db/migrations/001_core_schema.ts +120 -120
  94. package/src/db/migrations/002_learning_schema.ts +38 -38
  95. package/src/db/migrations/003_code_schema.ts +53 -53
  96. package/src/db/migrations/004_synapses_schema.ts +57 -57
  97. package/src/db/migrations/005_fts_indexes.ts +78 -78
  98. package/src/db/migrations/006_synapses_phase3.ts +17 -17
  99. package/src/db/migrations/index.ts +64 -64
  100. package/src/db/repositories/antipattern.repository.ts +66 -66
  101. package/src/db/repositories/code-module.repository.ts +9 -0
  102. package/src/db/repositories/error.repository.ts +149 -149
  103. package/src/db/repositories/insight.repository.ts +78 -78
  104. package/src/db/repositories/notification.repository.ts +66 -66
  105. package/src/db/repositories/project.repository.ts +93 -93
  106. package/src/db/repositories/rule.repository.ts +108 -108
  107. package/src/db/repositories/solution.repository.ts +154 -154
  108. package/src/db/repositories/synapse.repository.ts +153 -153
  109. package/src/db/repositories/terminal.repository.ts +101 -101
  110. package/src/hooks/post-tool-use.ts +90 -90
  111. package/src/hooks/post-write.ts +117 -117
  112. package/src/index.ts +4 -0
  113. package/src/ipc/client.ts +118 -118
  114. package/src/ipc/protocol.ts +35 -35
  115. package/src/ipc/router.ts +9 -1
  116. package/src/ipc/server.ts +110 -110
  117. package/src/learning/confidence-scorer.ts +47 -47
  118. package/src/learning/decay.ts +46 -46
  119. package/src/learning/learning-engine.ts +162 -162
  120. package/src/learning/pattern-extractor.ts +90 -90
  121. package/src/learning/rule-generator.ts +74 -74
  122. package/src/matching/error-matcher.ts +115 -115
  123. package/src/matching/fingerprint.ts +29 -29
  124. package/src/matching/similarity.ts +61 -61
  125. package/src/matching/tfidf.ts +74 -74
  126. package/src/matching/tokenizer.ts +41 -41
  127. package/src/mcp/auto-detect.ts +93 -93
  128. package/src/mcp/server.ts +73 -73
  129. package/src/mcp/tools.ts +290 -290
  130. package/src/parsing/error-parser.ts +28 -28
  131. package/src/parsing/parsers/compiler.ts +93 -93
  132. package/src/parsing/parsers/generic.ts +28 -28
  133. package/src/parsing/parsers/go.ts +97 -97
  134. package/src/parsing/parsers/node.ts +69 -69
  135. package/src/parsing/parsers/python.ts +62 -62
  136. package/src/parsing/parsers/rust.ts +50 -50
  137. package/src/parsing/parsers/shell.ts +42 -42
  138. package/src/parsing/types.ts +47 -47
  139. package/src/research/gap-analyzer.ts +135 -135
  140. package/src/research/insight-generator.ts +123 -123
  141. package/src/research/research-engine.ts +116 -116
  142. package/src/research/synergy-detector.ts +126 -126
  143. package/src/research/template-extractor.ts +130 -130
  144. package/src/research/trend-analyzer.ts +127 -127
  145. package/src/services/analytics.service.ts +87 -87
  146. package/src/services/code.service.ts +5 -2
  147. package/src/services/error.service.ts +164 -164
  148. package/src/services/notification.service.ts +41 -41
  149. package/src/services/prevention.service.ts +119 -119
  150. package/src/services/research.service.ts +93 -93
  151. package/src/services/solution.service.ts +116 -116
  152. package/src/services/synapse.service.ts +59 -59
  153. package/src/services/terminal.service.ts +81 -81
  154. package/src/synapses/activation.ts +80 -80
  155. package/src/synapses/decay.ts +38 -38
  156. package/src/synapses/hebbian.ts +69 -69
  157. package/src/synapses/pathfinder.ts +81 -81
  158. package/src/synapses/synapse-manager.ts +109 -109
  159. package/src/types/code.types.ts +52 -52
  160. package/src/types/config.types.ts +79 -79
  161. package/src/types/error.types.ts +67 -67
  162. package/src/types/ipc.types.ts +8 -8
  163. package/src/types/mcp.types.ts +53 -53
  164. package/src/types/research.types.ts +28 -28
  165. package/src/types/solution.types.ts +30 -30
  166. package/src/types/synapse.types.ts +49 -49
  167. package/src/utils/events.ts +45 -45
  168. package/src/utils/hash.ts +5 -5
  169. package/src/utils/logger.ts +48 -48
  170. package/src/utils/paths.ts +19 -19
  171. package/tests/fixtures/code-modules/modules.ts +83 -83
  172. package/tests/fixtures/errors/go.ts +9 -9
  173. package/tests/fixtures/errors/node.ts +24 -24
  174. package/tests/fixtures/errors/python.ts +21 -21
  175. package/tests/fixtures/errors/rust.ts +25 -25
  176. package/tests/fixtures/errors/shell.ts +15 -15
  177. package/tests/fixtures/solutions/solutions.ts +27 -27
  178. package/tests/helpers/setup-db.ts +52 -52
  179. package/tests/integration/code-flow.test.ts +86 -86
  180. package/tests/integration/error-flow.test.ts +83 -83
  181. package/tests/integration/ipc-flow.test.ts +166 -166
  182. package/tests/integration/learning-cycle.test.ts +82 -82
  183. package/tests/integration/synapse-flow.test.ts +117 -117
  184. package/tests/unit/code/analyzer.test.ts +58 -58
  185. package/tests/unit/code/fingerprint.test.ts +51 -51
  186. package/tests/unit/code/scorer.test.ts +55 -55
  187. package/tests/unit/learning/confidence-scorer.test.ts +60 -60
  188. package/tests/unit/learning/decay.test.ts +45 -45
  189. package/tests/unit/learning/pattern-extractor.test.ts +50 -50
  190. package/tests/unit/matching/error-matcher.test.ts +69 -69
  191. package/tests/unit/matching/fingerprint.test.ts +47 -47
  192. package/tests/unit/matching/similarity.test.ts +65 -65
  193. package/tests/unit/matching/tfidf.test.ts +71 -71
  194. package/tests/unit/matching/tokenizer.test.ts +83 -83
  195. package/tests/unit/parsing/parsers.test.ts +113 -113
  196. package/tests/unit/research/gap-analyzer.test.ts +45 -45
  197. package/tests/unit/research/trend-analyzer.test.ts +45 -45
  198. package/tests/unit/synapses/activation.test.ts +80 -80
  199. package/tests/unit/synapses/decay.test.ts +27 -27
  200. package/tests/unit/synapses/hebbian.test.ts +96 -96
  201. package/tests/unit/synapses/pathfinder.test.ts +72 -72
  202. 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
+ }