@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,86 +1,86 @@
1
- import { describe, it, expect, beforeEach } from 'vitest';
2
- import { createTestDb, type TestDb } from '../helpers/setup-db.js';
3
- import { CodeService } from '../../src/services/code.service.js';
4
- import { SynapseManager } from '../../src/synapses/synapse-manager.js';
5
- import { retryModule, hashModule } from '../fixtures/code-modules/modules.js';
6
-
7
- const synapsesConfig = {
8
- initialWeight: 0.1,
9
- learningRate: 0.15,
10
- decayHalfLifeDays: 45,
11
- pruneThreshold: 0.05,
12
- decayAfterDays: 14,
13
- maxDepth: 3,
14
- minActivationWeight: 0.2,
15
- };
16
-
17
- describe('Code Flow Integration', () => {
18
- let testDb: TestDb;
19
- let codeService: CodeService;
20
-
21
- beforeEach(() => {
22
- testDb = createTestDb();
23
- const synapseManager = new SynapseManager(testDb.repos.synapse, synapsesConfig);
24
- codeService = new CodeService(testDb.repos.codeModule, testDb.repos.project, synapseManager);
25
- });
26
-
27
- it('registers a code module and retrieves it', () => {
28
- const result = codeService.analyzeAndRegister({
29
- project: 'utils-lib',
30
- name: retryModule.name,
31
- filePath: retryModule.filePath,
32
- language: retryModule.language,
33
- source: retryModule.source,
34
- description: retryModule.description,
35
- });
36
-
37
- expect(result.moduleId).toBeTruthy();
38
- expect(result.isNew).toBe(true);
39
- expect(result.reusabilityScore).toBeGreaterThan(0);
40
-
41
- const mod = codeService.getById(result.moduleId);
42
- expect(mod).toBeTruthy();
43
- });
44
-
45
- it('finds reusable modules by query', () => {
46
- codeService.analyzeAndRegister({
47
- project: 'utils-lib',
48
- name: retryModule.name,
49
- filePath: retryModule.filePath,
50
- language: retryModule.language,
51
- source: retryModule.source,
52
- description: retryModule.description,
53
- });
54
-
55
- const results = codeService.findReusable({ query: 'retry backoff' });
56
- // FTS matching may or may not find results
57
- expect(results).toBeDefined();
58
- });
59
-
60
- it('lists all modules', () => {
61
- codeService.analyzeAndRegister({
62
- project: 'project-a',
63
- name: retryModule.name,
64
- filePath: retryModule.filePath,
65
- language: retryModule.language,
66
- source: retryModule.source,
67
- });
68
-
69
- // listModules requires a projectId — project is created with id=1 by analyzeAndRegister
70
- const modules = codeService.listModules(1);
71
- expect(modules.length).toBe(1);
72
- });
73
-
74
- it('detects similar code', () => {
75
- codeService.analyzeAndRegister({
76
- project: 'project-a',
77
- name: retryModule.name,
78
- filePath: retryModule.filePath,
79
- language: retryModule.language,
80
- source: retryModule.source,
81
- });
82
-
83
- const similarities = codeService.checkSimilarity(retryModule.source, 'typescript');
84
- expect(similarities).toBeDefined();
85
- });
86
- });
1
+ import { describe, it, expect, beforeEach } from 'vitest';
2
+ import { createTestDb, type TestDb } from '../helpers/setup-db.js';
3
+ import { CodeService } from '../../src/services/code.service.js';
4
+ import { SynapseManager } from '../../src/synapses/synapse-manager.js';
5
+ import { retryModule, hashModule } from '../fixtures/code-modules/modules.js';
6
+
7
+ const synapsesConfig = {
8
+ initialWeight: 0.1,
9
+ learningRate: 0.15,
10
+ decayHalfLifeDays: 45,
11
+ pruneThreshold: 0.05,
12
+ decayAfterDays: 14,
13
+ maxDepth: 3,
14
+ minActivationWeight: 0.2,
15
+ };
16
+
17
+ describe('Code Flow Integration', () => {
18
+ let testDb: TestDb;
19
+ let codeService: CodeService;
20
+
21
+ beforeEach(() => {
22
+ testDb = createTestDb();
23
+ const synapseManager = new SynapseManager(testDb.repos.synapse, synapsesConfig);
24
+ codeService = new CodeService(testDb.repos.codeModule, testDb.repos.project, synapseManager);
25
+ });
26
+
27
+ it('registers a code module and retrieves it', () => {
28
+ const result = codeService.analyzeAndRegister({
29
+ project: 'utils-lib',
30
+ name: retryModule.name,
31
+ filePath: retryModule.filePath,
32
+ language: retryModule.language,
33
+ source: retryModule.source,
34
+ description: retryModule.description,
35
+ });
36
+
37
+ expect(result.moduleId).toBeTruthy();
38
+ expect(result.isNew).toBe(true);
39
+ expect(result.reusabilityScore).toBeGreaterThan(0);
40
+
41
+ const mod = codeService.getById(result.moduleId);
42
+ expect(mod).toBeTruthy();
43
+ });
44
+
45
+ it('finds reusable modules by query', () => {
46
+ codeService.analyzeAndRegister({
47
+ project: 'utils-lib',
48
+ name: retryModule.name,
49
+ filePath: retryModule.filePath,
50
+ language: retryModule.language,
51
+ source: retryModule.source,
52
+ description: retryModule.description,
53
+ });
54
+
55
+ const results = codeService.findReusable({ query: 'retry backoff' });
56
+ // FTS matching may or may not find results
57
+ expect(results).toBeDefined();
58
+ });
59
+
60
+ it('lists all modules', () => {
61
+ codeService.analyzeAndRegister({
62
+ project: 'project-a',
63
+ name: retryModule.name,
64
+ filePath: retryModule.filePath,
65
+ language: retryModule.language,
66
+ source: retryModule.source,
67
+ });
68
+
69
+ // listModules requires a projectId — project is created with id=1 by analyzeAndRegister
70
+ const modules = codeService.listModules(1);
71
+ expect(modules.length).toBe(1);
72
+ });
73
+
74
+ it('detects similar code', () => {
75
+ codeService.analyzeAndRegister({
76
+ project: 'project-a',
77
+ name: retryModule.name,
78
+ filePath: retryModule.filePath,
79
+ language: retryModule.language,
80
+ source: retryModule.source,
81
+ });
82
+
83
+ const similarities = codeService.checkSimilarity(retryModule.source, 'typescript');
84
+ expect(similarities).toBeDefined();
85
+ });
86
+ });
@@ -1,83 +1,83 @@
1
- import { describe, it, expect, beforeEach } from 'vitest';
2
- import { createTestDb, type TestDb } from '../helpers/setup-db.js';
3
- import { ErrorService } from '../../src/services/error.service.js';
4
- import { SolutionService } from '../../src/services/solution.service.js';
5
- import { SynapseManager } from '../../src/synapses/synapse-manager.js';
6
-
7
- const synapsesConfig = {
8
- initialWeight: 0.1,
9
- learningRate: 0.15,
10
- decayHalfLifeDays: 45,
11
- pruneThreshold: 0.05,
12
- decayAfterDays: 14,
13
- maxDepth: 3,
14
- minActivationWeight: 0.2,
15
- };
16
-
17
- describe('Error Flow Integration', () => {
18
- let testDb: TestDb;
19
- let errorService: ErrorService;
20
- let solutionService: SolutionService;
21
- let synapseManager: SynapseManager;
22
-
23
- beforeEach(() => {
24
- testDb = createTestDb();
25
- synapseManager = new SynapseManager(testDb.repos.synapse, synapsesConfig);
26
- errorService = new ErrorService(testDb.repos.error, testDb.repos.project, synapseManager);
27
- solutionService = new SolutionService(testDb.repos.solution, synapseManager);
28
- });
29
-
30
- it('reports error and queries it back', () => {
31
- const result = errorService.report({
32
- project: 'test-project',
33
- errorOutput: "TypeError: Cannot read properties of undefined (reading 'map')",
34
- });
35
- expect(result.errorId).toBeTruthy();
36
- expect(result.isNew).toBe(true);
37
-
38
- const errors = errorService.query({ resolved: false });
39
- expect(errors.length).toBe(1);
40
- });
41
-
42
- it('adds and finds solutions for errors', () => {
43
- const errResult = errorService.report({
44
- project: 'test-project',
45
- errorOutput: "TypeError: Cannot read properties of undefined",
46
- });
47
-
48
- const solutionId = solutionService.report({
49
- errorId: errResult.errorId,
50
- description: 'Add null check before accessing .map()',
51
- });
52
- expect(solutionId).toBeTruthy();
53
-
54
- const solutions = solutionService.findForError(errResult.errorId);
55
- expect(solutions.length).toBeGreaterThanOrEqual(0); // may need error_solution join
56
- });
57
-
58
- it('matches similar errors', () => {
59
- const first = errorService.report({
60
- project: 'project-a',
61
- errorOutput: "TypeError: Cannot read properties of undefined (reading 'map')",
62
- });
63
-
64
- const second = errorService.report({
65
- project: 'project-a',
66
- errorOutput: "TypeError: Cannot read properties of undefined (reading 'filter')",
67
- });
68
-
69
- const matches = errorService.matchSimilar(second.errorId);
70
- expect(matches).toBeDefined();
71
- });
72
-
73
- it('creates project on first error report', () => {
74
- errorService.report({
75
- project: 'new-project',
76
- errorOutput: 'Error: something broke',
77
- });
78
-
79
- const projects = testDb.repos.project.getAll();
80
- expect(projects.length).toBe(1);
81
- expect(projects[0].name).toBe('new-project');
82
- });
83
- });
1
+ import { describe, it, expect, beforeEach } from 'vitest';
2
+ import { createTestDb, type TestDb } from '../helpers/setup-db.js';
3
+ import { ErrorService } from '../../src/services/error.service.js';
4
+ import { SolutionService } from '../../src/services/solution.service.js';
5
+ import { SynapseManager } from '../../src/synapses/synapse-manager.js';
6
+
7
+ const synapsesConfig = {
8
+ initialWeight: 0.1,
9
+ learningRate: 0.15,
10
+ decayHalfLifeDays: 45,
11
+ pruneThreshold: 0.05,
12
+ decayAfterDays: 14,
13
+ maxDepth: 3,
14
+ minActivationWeight: 0.2,
15
+ };
16
+
17
+ describe('Error Flow Integration', () => {
18
+ let testDb: TestDb;
19
+ let errorService: ErrorService;
20
+ let solutionService: SolutionService;
21
+ let synapseManager: SynapseManager;
22
+
23
+ beforeEach(() => {
24
+ testDb = createTestDb();
25
+ synapseManager = new SynapseManager(testDb.repos.synapse, synapsesConfig);
26
+ errorService = new ErrorService(testDb.repos.error, testDb.repos.project, synapseManager);
27
+ solutionService = new SolutionService(testDb.repos.solution, synapseManager);
28
+ });
29
+
30
+ it('reports error and queries it back', () => {
31
+ const result = errorService.report({
32
+ project: 'test-project',
33
+ errorOutput: "TypeError: Cannot read properties of undefined (reading 'map')",
34
+ });
35
+ expect(result.errorId).toBeTruthy();
36
+ expect(result.isNew).toBe(true);
37
+
38
+ const errors = errorService.query({ resolved: false });
39
+ expect(errors.length).toBe(1);
40
+ });
41
+
42
+ it('adds and finds solutions for errors', () => {
43
+ const errResult = errorService.report({
44
+ project: 'test-project',
45
+ errorOutput: "TypeError: Cannot read properties of undefined",
46
+ });
47
+
48
+ const solutionId = solutionService.report({
49
+ errorId: errResult.errorId,
50
+ description: 'Add null check before accessing .map()',
51
+ });
52
+ expect(solutionId).toBeTruthy();
53
+
54
+ const solutions = solutionService.findForError(errResult.errorId);
55
+ expect(solutions.length).toBeGreaterThanOrEqual(0); // may need error_solution join
56
+ });
57
+
58
+ it('matches similar errors', () => {
59
+ const first = errorService.report({
60
+ project: 'project-a',
61
+ errorOutput: "TypeError: Cannot read properties of undefined (reading 'map')",
62
+ });
63
+
64
+ const second = errorService.report({
65
+ project: 'project-a',
66
+ errorOutput: "TypeError: Cannot read properties of undefined (reading 'filter')",
67
+ });
68
+
69
+ const matches = errorService.matchSimilar(second.errorId);
70
+ expect(matches).toBeDefined();
71
+ });
72
+
73
+ it('creates project on first error report', () => {
74
+ errorService.report({
75
+ project: 'new-project',
76
+ errorOutput: 'Error: something broke',
77
+ });
78
+
79
+ const projects = testDb.repos.project.getAll();
80
+ expect(projects.length).toBe(1);
81
+ expect(projects[0].name).toBe('new-project');
82
+ });
83
+ });