@timmeck/brain 1.8.0 → 1.8.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.
Files changed (177) hide show
  1. package/BRAIN_PLAN.md +3324 -3324
  2. package/LICENSE +21 -21
  3. package/dist/api/server.d.ts +4 -0
  4. package/dist/api/server.js +73 -0
  5. package/dist/api/server.js.map +1 -1
  6. package/dist/brain.js +2 -1
  7. package/dist/brain.js.map +1 -1
  8. package/dist/cli/commands/dashboard.js +606 -572
  9. package/dist/cli/commands/dashboard.js.map +1 -1
  10. package/dist/dashboard/server.js +25 -25
  11. package/dist/db/migrations/001_core_schema.js +115 -115
  12. package/dist/db/migrations/002_learning_schema.js +33 -33
  13. package/dist/db/migrations/003_code_schema.js +48 -48
  14. package/dist/db/migrations/004_synapses_schema.js +52 -52
  15. package/dist/db/migrations/005_fts_indexes.js +73 -73
  16. package/dist/db/migrations/007_feedback.js +8 -8
  17. package/dist/db/migrations/008_git_integration.js +33 -33
  18. package/dist/db/migrations/009_embeddings.js +3 -3
  19. package/dist/db/repositories/antipattern.repository.js +3 -3
  20. package/dist/db/repositories/code-module.repository.js +32 -32
  21. package/dist/db/repositories/notification.repository.js +3 -3
  22. package/dist/db/repositories/project.repository.js +21 -21
  23. package/dist/db/repositories/rule.repository.js +24 -24
  24. package/dist/db/repositories/solution.repository.js +50 -50
  25. package/dist/db/repositories/synapse.repository.js +18 -18
  26. package/dist/db/repositories/terminal.repository.js +24 -24
  27. package/dist/embeddings/engine.d.ts +2 -2
  28. package/dist/embeddings/engine.js +17 -4
  29. package/dist/embeddings/engine.js.map +1 -1
  30. package/dist/index.js +1 -1
  31. package/dist/ipc/server.d.ts +8 -0
  32. package/dist/ipc/server.js +67 -1
  33. package/dist/ipc/server.js.map +1 -1
  34. package/dist/matching/error-matcher.js +5 -5
  35. package/dist/matching/fingerprint.js +6 -1
  36. package/dist/matching/fingerprint.js.map +1 -1
  37. package/dist/mcp/http-server.js +8 -2
  38. package/dist/mcp/http-server.js.map +1 -1
  39. package/dist/services/code.service.d.ts +3 -0
  40. package/dist/services/code.service.js +33 -4
  41. package/dist/services/code.service.js.map +1 -1
  42. package/dist/services/error.service.js +4 -3
  43. package/dist/services/error.service.js.map +1 -1
  44. package/dist/services/git.service.js +14 -14
  45. package/package.json +49 -49
  46. package/src/api/server.ts +395 -321
  47. package/src/brain.ts +266 -265
  48. package/src/cli/colors.ts +116 -116
  49. package/src/cli/commands/config.ts +169 -169
  50. package/src/cli/commands/dashboard.ts +755 -720
  51. package/src/cli/commands/doctor.ts +118 -118
  52. package/src/cli/commands/explain.ts +83 -83
  53. package/src/cli/commands/export.ts +31 -31
  54. package/src/cli/commands/import.ts +199 -199
  55. package/src/cli/commands/insights.ts +65 -65
  56. package/src/cli/commands/learn.ts +24 -24
  57. package/src/cli/commands/modules.ts +53 -53
  58. package/src/cli/commands/network.ts +67 -67
  59. package/src/cli/commands/projects.ts +42 -42
  60. package/src/cli/commands/query.ts +120 -120
  61. package/src/cli/commands/start.ts +62 -62
  62. package/src/cli/commands/status.ts +75 -75
  63. package/src/cli/commands/stop.ts +34 -34
  64. package/src/cli/ipc-helper.ts +22 -22
  65. package/src/cli/update-check.ts +63 -63
  66. package/src/code/fingerprint.ts +87 -87
  67. package/src/code/parsers/generic.ts +29 -29
  68. package/src/code/parsers/python.ts +54 -54
  69. package/src/code/parsers/typescript.ts +65 -65
  70. package/src/code/registry.ts +60 -60
  71. package/src/dashboard/server.ts +142 -142
  72. package/src/db/connection.ts +22 -22
  73. package/src/db/migrations/001_core_schema.ts +120 -120
  74. package/src/db/migrations/002_learning_schema.ts +38 -38
  75. package/src/db/migrations/003_code_schema.ts +53 -53
  76. package/src/db/migrations/004_synapses_schema.ts +57 -57
  77. package/src/db/migrations/005_fts_indexes.ts +78 -78
  78. package/src/db/migrations/006_synapses_phase3.ts +17 -17
  79. package/src/db/migrations/007_feedback.ts +13 -13
  80. package/src/db/migrations/008_git_integration.ts +38 -38
  81. package/src/db/migrations/009_embeddings.ts +8 -8
  82. package/src/db/repositories/antipattern.repository.ts +66 -66
  83. package/src/db/repositories/code-module.repository.ts +142 -142
  84. package/src/db/repositories/notification.repository.ts +66 -66
  85. package/src/db/repositories/project.repository.ts +93 -93
  86. package/src/db/repositories/rule.repository.ts +108 -108
  87. package/src/db/repositories/solution.repository.ts +154 -154
  88. package/src/db/repositories/synapse.repository.ts +153 -153
  89. package/src/db/repositories/terminal.repository.ts +101 -101
  90. package/src/embeddings/engine.ts +238 -217
  91. package/src/index.ts +63 -63
  92. package/src/ipc/client.ts +118 -118
  93. package/src/ipc/protocol.ts +35 -35
  94. package/src/ipc/router.ts +133 -133
  95. package/src/ipc/server.ts +176 -110
  96. package/src/learning/decay.ts +46 -46
  97. package/src/learning/pattern-extractor.ts +90 -90
  98. package/src/learning/rule-generator.ts +74 -74
  99. package/src/matching/error-matcher.ts +5 -5
  100. package/src/matching/fingerprint.ts +34 -29
  101. package/src/matching/similarity.ts +61 -61
  102. package/src/matching/tfidf.ts +74 -74
  103. package/src/matching/tokenizer.ts +41 -41
  104. package/src/mcp/auto-detect.ts +93 -93
  105. package/src/mcp/http-server.ts +140 -137
  106. package/src/mcp/server.ts +73 -73
  107. package/src/parsing/error-parser.ts +28 -28
  108. package/src/parsing/parsers/compiler.ts +93 -93
  109. package/src/parsing/parsers/generic.ts +28 -28
  110. package/src/parsing/parsers/go.ts +97 -97
  111. package/src/parsing/parsers/node.ts +69 -69
  112. package/src/parsing/parsers/python.ts +62 -62
  113. package/src/parsing/parsers/rust.ts +50 -50
  114. package/src/parsing/parsers/shell.ts +42 -42
  115. package/src/parsing/types.ts +47 -47
  116. package/src/research/gap-analyzer.ts +135 -135
  117. package/src/research/insight-generator.ts +123 -123
  118. package/src/research/research-engine.ts +116 -116
  119. package/src/research/synergy-detector.ts +126 -126
  120. package/src/research/template-extractor.ts +130 -130
  121. package/src/research/trend-analyzer.ts +127 -127
  122. package/src/services/code.service.ts +271 -238
  123. package/src/services/error.service.ts +4 -3
  124. package/src/services/git.service.ts +132 -132
  125. package/src/services/notification.service.ts +41 -41
  126. package/src/services/synapse.service.ts +59 -59
  127. package/src/services/terminal.service.ts +81 -81
  128. package/src/synapses/activation.ts +80 -80
  129. package/src/synapses/decay.ts +38 -38
  130. package/src/synapses/hebbian.ts +69 -69
  131. package/src/synapses/pathfinder.ts +81 -81
  132. package/src/synapses/synapse-manager.ts +109 -109
  133. package/src/types/code.types.ts +52 -52
  134. package/src/types/error.types.ts +67 -67
  135. package/src/types/ipc.types.ts +8 -8
  136. package/src/types/mcp.types.ts +53 -53
  137. package/src/types/research.types.ts +28 -28
  138. package/src/types/solution.types.ts +30 -30
  139. package/src/utils/events.ts +45 -45
  140. package/src/utils/hash.ts +5 -5
  141. package/src/utils/logger.ts +48 -48
  142. package/src/utils/paths.ts +19 -19
  143. package/tests/e2e/test_code_intelligence.py +1015 -0
  144. package/tests/e2e/test_error_memory.py +451 -0
  145. package/tests/e2e/test_full_integration.py +534 -0
  146. package/tests/fixtures/code-modules/modules.ts +83 -83
  147. package/tests/fixtures/errors/go.ts +9 -9
  148. package/tests/fixtures/errors/node.ts +24 -24
  149. package/tests/fixtures/errors/python.ts +21 -21
  150. package/tests/fixtures/errors/rust.ts +25 -25
  151. package/tests/fixtures/errors/shell.ts +15 -15
  152. package/tests/fixtures/solutions/solutions.ts +27 -27
  153. package/tests/helpers/setup-db.ts +52 -52
  154. package/tests/integration/code-flow.test.ts +86 -86
  155. package/tests/integration/error-flow.test.ts +83 -83
  156. package/tests/integration/ipc-flow.test.ts +166 -166
  157. package/tests/integration/learning-cycle.test.ts +82 -82
  158. package/tests/integration/synapse-flow.test.ts +117 -117
  159. package/tests/unit/code/analyzer.test.ts +58 -58
  160. package/tests/unit/code/fingerprint.test.ts +51 -51
  161. package/tests/unit/code/scorer.test.ts +55 -55
  162. package/tests/unit/learning/confidence-scorer.test.ts +60 -60
  163. package/tests/unit/learning/decay.test.ts +45 -45
  164. package/tests/unit/learning/pattern-extractor.test.ts +50 -50
  165. package/tests/unit/matching/error-matcher.test.ts +69 -69
  166. package/tests/unit/matching/fingerprint.test.ts +47 -47
  167. package/tests/unit/matching/similarity.test.ts +65 -65
  168. package/tests/unit/matching/tfidf.test.ts +71 -71
  169. package/tests/unit/matching/tokenizer.test.ts +83 -83
  170. package/tests/unit/parsing/parsers.test.ts +113 -113
  171. package/tests/unit/research/gap-analyzer.test.ts +45 -45
  172. package/tests/unit/research/trend-analyzer.test.ts +45 -45
  173. package/tests/unit/synapses/activation.test.ts +80 -80
  174. package/tests/unit/synapses/decay.test.ts +27 -27
  175. package/tests/unit/synapses/hebbian.test.ts +96 -96
  176. package/tests/unit/synapses/pathfinder.test.ts +72 -72
  177. package/tsconfig.json +18 -18
@@ -1,127 +1,127 @@
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 { InsightRepository } from '../db/repositories/insight.repository.js';
6
- import { getLogger } from '../utils/logger.js';
7
-
8
- /**
9
- * Analyzes error frequency and solution success rate trends over time windows.
10
- */
11
- export class TrendAnalyzer {
12
- private logger = getLogger();
13
-
14
- constructor(
15
- private errorRepo: ErrorRepository,
16
- private solutionRepo: SolutionRepository,
17
- private projectRepo: ProjectRepository,
18
- private insightRepo: InsightRepository,
19
- private config: ResearchConfig,
20
- ) {}
21
-
22
- analyze(): number {
23
- const projects = this.projectRepo.getAll();
24
- let insightsCreated = 0;
25
-
26
- for (const project of projects) {
27
- insightsCreated += this.analyzeErrorTrend(project.id, project.name);
28
- insightsCreated += this.analyzeSolutionTrend(project.id, project.name);
29
- }
30
-
31
- this.logger.info(`Trend analysis complete: ${insightsCreated} insights`);
32
- return insightsCreated;
33
- }
34
-
35
- private analyzeErrorTrend(projectId: number, projectName: string): number {
36
- const windowDays = this.config.trendWindowDays;
37
- const now = Date.now();
38
- const recentSince = new Date(now - windowDays * 86400000).toISOString();
39
- const previousSince = new Date(now - windowDays * 2 * 86400000).toISOString();
40
-
41
- const recentErrors = this.errorRepo.countSince(recentSince, projectId);
42
- const allSinceDouble = this.errorRepo.countSince(previousSince, projectId);
43
- const previousErrors = allSinceDouble - recentErrors;
44
-
45
- if (previousErrors <= 0) return 0;
46
-
47
- const changeRate = (recentErrors - previousErrors) / previousErrors;
48
- const expiresAt = new Date(Date.now() + this.config.insightExpiryDays * 86400000).toISOString();
49
-
50
- if (changeRate > 0.5) {
51
- this.insightRepo.create({
52
- type: 'warning',
53
- title: `Error rate rising in ${projectName}`,
54
- description: `${Math.round(changeRate * 100)}% more errors in the last ${windowDays} days vs previous window. Check recent changes: new dependencies, refactoring, or API changes.`,
55
- evidence: JSON.stringify({ recentErrors, previousErrors, changeRate, windowDays }),
56
- priority: Math.min(90, 50 + Math.round(changeRate * 30)),
57
- project_id: projectId,
58
- active: 1,
59
- expires_at: expiresAt,
60
- });
61
- return 1;
62
- }
63
-
64
- if (changeRate < -0.3) {
65
- this.insightRepo.create({
66
- type: 'pattern',
67
- title: `Error rate declining in ${projectName}`,
68
- description: `${Math.round(-changeRate * 100)}% fewer errors in the last ${windowDays} days. Whatever you're doing is working.`,
69
- evidence: JSON.stringify({ recentErrors, previousErrors, changeRate, windowDays }),
70
- priority: 20,
71
- project_id: projectId,
72
- active: 1,
73
- expires_at: expiresAt,
74
- });
75
- return 1;
76
- }
77
-
78
- return 0;
79
- }
80
-
81
- private analyzeSolutionTrend(projectId: number, projectName: string): number {
82
- const errors = this.errorRepo.findByProject(projectId);
83
- if (errors.length < this.config.minDataPoints) return 0;
84
-
85
- let totalRate = 0;
86
- let recentRate = 0;
87
- let totalCount = 0;
88
- let recentCount = 0;
89
- const recentCutoff = new Date(Date.now() - this.config.trendWindowDays * 86400000).toISOString();
90
-
91
- for (const error of errors) {
92
- const solutions = this.solutionRepo.findForError(error.id);
93
- for (const sol of solutions) {
94
- const rate = this.solutionRepo.successRate(sol.id);
95
- totalRate += rate;
96
- totalCount++;
97
-
98
- if (sol.updated_at >= recentCutoff) {
99
- recentRate += rate;
100
- recentCount++;
101
- }
102
- }
103
- }
104
-
105
- if (totalCount === 0 || recentCount === 0) return 0;
106
-
107
- const avgTotal = totalRate / totalCount;
108
- const avgRecent = recentRate / recentCount;
109
-
110
- if (avgRecent < avgTotal - 0.15 && totalCount >= this.config.minDataPoints) {
111
- const expiresAt = new Date(Date.now() + this.config.insightExpiryDays * 86400000).toISOString();
112
- this.insightRepo.create({
113
- type: 'warning',
114
- title: `Solution quality declining in ${projectName}`,
115
- description: `Recent success rate ${Math.round(avgRecent * 100)}% vs overall ${Math.round(avgTotal * 100)}%. Solutions are becoming less effective.`,
116
- evidence: JSON.stringify({ avgRecent, avgTotal, recentCount, totalCount }),
117
- priority: 60,
118
- project_id: projectId,
119
- active: 1,
120
- expires_at: expiresAt,
121
- });
122
- return 1;
123
- }
124
-
125
- return 0;
126
- }
127
- }
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 { InsightRepository } from '../db/repositories/insight.repository.js';
6
+ import { getLogger } from '../utils/logger.js';
7
+
8
+ /**
9
+ * Analyzes error frequency and solution success rate trends over time windows.
10
+ */
11
+ export class TrendAnalyzer {
12
+ private logger = getLogger();
13
+
14
+ constructor(
15
+ private errorRepo: ErrorRepository,
16
+ private solutionRepo: SolutionRepository,
17
+ private projectRepo: ProjectRepository,
18
+ private insightRepo: InsightRepository,
19
+ private config: ResearchConfig,
20
+ ) {}
21
+
22
+ analyze(): number {
23
+ const projects = this.projectRepo.getAll();
24
+ let insightsCreated = 0;
25
+
26
+ for (const project of projects) {
27
+ insightsCreated += this.analyzeErrorTrend(project.id, project.name);
28
+ insightsCreated += this.analyzeSolutionTrend(project.id, project.name);
29
+ }
30
+
31
+ this.logger.info(`Trend analysis complete: ${insightsCreated} insights`);
32
+ return insightsCreated;
33
+ }
34
+
35
+ private analyzeErrorTrend(projectId: number, projectName: string): number {
36
+ const windowDays = this.config.trendWindowDays;
37
+ const now = Date.now();
38
+ const recentSince = new Date(now - windowDays * 86400000).toISOString();
39
+ const previousSince = new Date(now - windowDays * 2 * 86400000).toISOString();
40
+
41
+ const recentErrors = this.errorRepo.countSince(recentSince, projectId);
42
+ const allSinceDouble = this.errorRepo.countSince(previousSince, projectId);
43
+ const previousErrors = allSinceDouble - recentErrors;
44
+
45
+ if (previousErrors <= 0) return 0;
46
+
47
+ const changeRate = (recentErrors - previousErrors) / previousErrors;
48
+ const expiresAt = new Date(Date.now() + this.config.insightExpiryDays * 86400000).toISOString();
49
+
50
+ if (changeRate > 0.5) {
51
+ this.insightRepo.create({
52
+ type: 'warning',
53
+ title: `Error rate rising in ${projectName}`,
54
+ description: `${Math.round(changeRate * 100)}% more errors in the last ${windowDays} days vs previous window. Check recent changes: new dependencies, refactoring, or API changes.`,
55
+ evidence: JSON.stringify({ recentErrors, previousErrors, changeRate, windowDays }),
56
+ priority: Math.min(90, 50 + Math.round(changeRate * 30)),
57
+ project_id: projectId,
58
+ active: 1,
59
+ expires_at: expiresAt,
60
+ });
61
+ return 1;
62
+ }
63
+
64
+ if (changeRate < -0.3) {
65
+ this.insightRepo.create({
66
+ type: 'pattern',
67
+ title: `Error rate declining in ${projectName}`,
68
+ description: `${Math.round(-changeRate * 100)}% fewer errors in the last ${windowDays} days. Whatever you're doing is working.`,
69
+ evidence: JSON.stringify({ recentErrors, previousErrors, changeRate, windowDays }),
70
+ priority: 20,
71
+ project_id: projectId,
72
+ active: 1,
73
+ expires_at: expiresAt,
74
+ });
75
+ return 1;
76
+ }
77
+
78
+ return 0;
79
+ }
80
+
81
+ private analyzeSolutionTrend(projectId: number, projectName: string): number {
82
+ const errors = this.errorRepo.findByProject(projectId);
83
+ if (errors.length < this.config.minDataPoints) return 0;
84
+
85
+ let totalRate = 0;
86
+ let recentRate = 0;
87
+ let totalCount = 0;
88
+ let recentCount = 0;
89
+ const recentCutoff = new Date(Date.now() - this.config.trendWindowDays * 86400000).toISOString();
90
+
91
+ for (const error of errors) {
92
+ const solutions = this.solutionRepo.findForError(error.id);
93
+ for (const sol of solutions) {
94
+ const rate = this.solutionRepo.successRate(sol.id);
95
+ totalRate += rate;
96
+ totalCount++;
97
+
98
+ if (sol.updated_at >= recentCutoff) {
99
+ recentRate += rate;
100
+ recentCount++;
101
+ }
102
+ }
103
+ }
104
+
105
+ if (totalCount === 0 || recentCount === 0) return 0;
106
+
107
+ const avgTotal = totalRate / totalCount;
108
+ const avgRecent = recentRate / recentCount;
109
+
110
+ if (avgRecent < avgTotal - 0.15 && totalCount >= this.config.minDataPoints) {
111
+ const expiresAt = new Date(Date.now() + this.config.insightExpiryDays * 86400000).toISOString();
112
+ this.insightRepo.create({
113
+ type: 'warning',
114
+ title: `Solution quality declining in ${projectName}`,
115
+ description: `Recent success rate ${Math.round(avgRecent * 100)}% vs overall ${Math.round(avgTotal * 100)}%. Solutions are becoming less effective.`,
116
+ evidence: JSON.stringify({ avgRecent, avgTotal, recentCount, totalCount }),
117
+ priority: 60,
118
+ project_id: projectId,
119
+ active: 1,
120
+ expires_at: expiresAt,
121
+ });
122
+ return 1;
123
+ }
124
+
125
+ return 0;
126
+ }
127
+ }