@timmeck/brain 1.9.0 → 2.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 (253) hide show
  1. package/README.md +33 -0
  2. package/brain.log +3876 -0
  3. package/{src/cli/commands/dashboard.ts → dashboard.html} +694 -807
  4. package/dist/api/server.d.ts +4 -18
  5. package/dist/api/server.js +4 -173
  6. package/dist/api/server.js.map +1 -1
  7. package/dist/brain.d.ts +2 -0
  8. package/dist/brain.js +15 -4
  9. package/dist/brain.js.map +1 -1
  10. package/dist/cli/colors.d.ts +4 -25
  11. package/dist/cli/colors.js +3 -89
  12. package/dist/cli/colors.js.map +1 -1
  13. package/dist/cli/commands/dashboard.js +21 -2
  14. package/dist/cli/commands/dashboard.js.map +1 -1
  15. package/dist/cli/commands/peers.d.ts +2 -0
  16. package/dist/cli/commands/peers.js +38 -0
  17. package/dist/cli/commands/peers.js.map +1 -0
  18. package/dist/cli/commands/status.js +0 -1
  19. package/dist/cli/commands/status.js.map +1 -1
  20. package/dist/config.js +2 -29
  21. package/dist/config.js.map +1 -1
  22. package/dist/db/connection.d.ts +1 -2
  23. package/dist/db/connection.js +1 -18
  24. package/dist/db/connection.js.map +1 -1
  25. package/dist/index.js +3 -1
  26. package/dist/index.js.map +1 -1
  27. package/dist/ipc/__tests__/protocol.test.d.ts +1 -0
  28. package/dist/ipc/__tests__/protocol.test.js +117 -0
  29. package/dist/ipc/__tests__/protocol.test.js.map +1 -0
  30. package/dist/ipc/client.d.ts +1 -16
  31. package/dist/ipc/client.js +1 -100
  32. package/dist/ipc/client.js.map +1 -1
  33. package/dist/ipc/protocol.d.ts +1 -8
  34. package/dist/ipc/protocol.js +1 -28
  35. package/dist/ipc/protocol.js.map +1 -1
  36. package/dist/ipc/router.d.ts +2 -0
  37. package/dist/ipc/router.js +30 -0
  38. package/dist/ipc/router.js.map +1 -1
  39. package/dist/ipc/server.d.ts +1 -22
  40. package/dist/ipc/server.js +1 -163
  41. package/dist/ipc/server.js.map +1 -1
  42. package/dist/learning/confidence-scorer.d.ts +2 -5
  43. package/dist/learning/confidence-scorer.js +4 -19
  44. package/dist/learning/confidence-scorer.js.map +1 -1
  45. package/dist/learning/decay.js +2 -3
  46. package/dist/learning/decay.js.map +1 -1
  47. package/dist/learning/learning-engine.d.ts +2 -5
  48. package/dist/learning/learning-engine.js +3 -15
  49. package/dist/learning/learning-engine.js.map +1 -1
  50. package/dist/mcp/http-server.d.ts +1 -7
  51. package/dist/mcp/http-server.js +6 -117
  52. package/dist/mcp/http-server.js.map +1 -1
  53. package/dist/mcp/server.js +5 -61
  54. package/dist/mcp/server.js.map +1 -1
  55. package/dist/mcp/tools.js +36 -0
  56. package/dist/mcp/tools.js.map +1 -1
  57. package/dist/parsing/parsers/compiler.js +1 -1
  58. package/dist/parsing/parsers/compiler.js.map +1 -1
  59. package/dist/research/research-engine.d.ts +2 -6
  60. package/dist/research/research-engine.js +3 -23
  61. package/dist/research/research-engine.js.map +1 -1
  62. package/dist/services/synapse.service.d.ts +3 -3
  63. package/dist/signals/__tests__/fingerprint.test.d.ts +1 -0
  64. package/dist/signals/__tests__/fingerprint.test.js +118 -0
  65. package/dist/signals/__tests__/fingerprint.test.js.map +1 -0
  66. package/dist/synapses/activation.d.ts +3 -13
  67. package/dist/synapses/activation.js +2 -49
  68. package/dist/synapses/activation.js.map +1 -1
  69. package/dist/synapses/decay.d.ts +2 -11
  70. package/dist/synapses/decay.js +2 -26
  71. package/dist/synapses/decay.js.map +1 -1
  72. package/dist/synapses/hebbian.d.ts +2 -13
  73. package/dist/synapses/hebbian.js +2 -35
  74. package/dist/synapses/hebbian.js.map +1 -1
  75. package/dist/synapses/pathfinder.d.ts +2 -14
  76. package/dist/synapses/pathfinder.js +2 -49
  77. package/dist/synapses/pathfinder.js.map +1 -1
  78. package/dist/synapses/synapse-manager.d.ts +7 -23
  79. package/dist/synapses/synapse-manager.js +6 -63
  80. package/dist/synapses/synapse-manager.js.map +1 -1
  81. package/dist/types/ipc.types.d.ts +1 -11
  82. package/dist/utils/__tests__/hash.test.d.ts +1 -0
  83. package/dist/utils/__tests__/hash.test.js +32 -0
  84. package/dist/utils/__tests__/hash.test.js.map +1 -0
  85. package/dist/utils/__tests__/paths.test.d.ts +1 -0
  86. package/dist/utils/__tests__/paths.test.js +75 -0
  87. package/dist/utils/__tests__/paths.test.js.map +1 -0
  88. package/dist/utils/events.d.ts +4 -8
  89. package/dist/utils/events.js +2 -14
  90. package/dist/utils/events.js.map +1 -1
  91. package/dist/utils/hash.d.ts +1 -1
  92. package/dist/utils/hash.js +1 -4
  93. package/dist/utils/hash.js.map +1 -1
  94. package/dist/utils/logger.d.ts +3 -2
  95. package/dist/utils/logger.js +8 -35
  96. package/dist/utils/logger.js.map +1 -1
  97. package/dist/utils/paths.d.ts +2 -1
  98. package/dist/utils/paths.js +4 -13
  99. package/dist/utils/paths.js.map +1 -1
  100. package/eslint.config.js +14 -0
  101. package/package.json +56 -49
  102. package/BRAIN_PLAN.md +0 -3324
  103. package/reddit_post.md +0 -45
  104. package/src/api/server.ts +0 -395
  105. package/src/brain.ts +0 -313
  106. package/src/cli/colors.ts +0 -116
  107. package/src/cli/commands/config.ts +0 -169
  108. package/src/cli/commands/doctor.ts +0 -124
  109. package/src/cli/commands/explain.ts +0 -83
  110. package/src/cli/commands/export.ts +0 -31
  111. package/src/cli/commands/import.ts +0 -199
  112. package/src/cli/commands/insights.ts +0 -65
  113. package/src/cli/commands/learn.ts +0 -24
  114. package/src/cli/commands/modules.ts +0 -53
  115. package/src/cli/commands/network.ts +0 -67
  116. package/src/cli/commands/projects.ts +0 -42
  117. package/src/cli/commands/query.ts +0 -120
  118. package/src/cli/commands/start.ts +0 -105
  119. package/src/cli/commands/status.ts +0 -75
  120. package/src/cli/commands/stop.ts +0 -34
  121. package/src/cli/ipc-helper.ts +0 -22
  122. package/src/cli/update-check.ts +0 -63
  123. package/src/code/analyzer.ts +0 -117
  124. package/src/code/fingerprint.ts +0 -87
  125. package/src/code/matcher.ts +0 -129
  126. package/src/code/parsers/generic.ts +0 -29
  127. package/src/code/parsers/python.ts +0 -54
  128. package/src/code/parsers/typescript.ts +0 -65
  129. package/src/code/registry.ts +0 -60
  130. package/src/code/scorer.ts +0 -120
  131. package/src/config.ts +0 -135
  132. package/src/dashboard/server.ts +0 -142
  133. package/src/db/connection.ts +0 -22
  134. package/src/db/migrations/001_core_schema.ts +0 -120
  135. package/src/db/migrations/002_learning_schema.ts +0 -38
  136. package/src/db/migrations/003_code_schema.ts +0 -53
  137. package/src/db/migrations/004_synapses_schema.ts +0 -57
  138. package/src/db/migrations/005_fts_indexes.ts +0 -78
  139. package/src/db/migrations/006_synapses_phase3.ts +0 -17
  140. package/src/db/migrations/007_feedback.ts +0 -13
  141. package/src/db/migrations/008_git_integration.ts +0 -38
  142. package/src/db/migrations/009_embeddings.ts +0 -8
  143. package/src/db/migrations/index.ts +0 -70
  144. package/src/db/repositories/antipattern.repository.ts +0 -66
  145. package/src/db/repositories/code-module.repository.ts +0 -142
  146. package/src/db/repositories/error.repository.ts +0 -189
  147. package/src/db/repositories/insight.repository.ts +0 -99
  148. package/src/db/repositories/notification.repository.ts +0 -66
  149. package/src/db/repositories/project.repository.ts +0 -93
  150. package/src/db/repositories/rule.repository.ts +0 -108
  151. package/src/db/repositories/solution.repository.ts +0 -154
  152. package/src/db/repositories/synapse.repository.ts +0 -163
  153. package/src/db/repositories/terminal.repository.ts +0 -101
  154. package/src/embeddings/engine.ts +0 -238
  155. package/src/hooks/post-tool-use.ts +0 -92
  156. package/src/hooks/post-write.ts +0 -129
  157. package/src/index.ts +0 -63
  158. package/src/ipc/client.ts +0 -118
  159. package/src/ipc/protocol.ts +0 -35
  160. package/src/ipc/router.ts +0 -133
  161. package/src/ipc/server.ts +0 -176
  162. package/src/learning/confidence-scorer.ts +0 -80
  163. package/src/learning/decay.ts +0 -46
  164. package/src/learning/learning-engine.ts +0 -170
  165. package/src/learning/pattern-extractor.ts +0 -90
  166. package/src/learning/rule-generator.ts +0 -74
  167. package/src/main.rs:10:5 +0 -0
  168. package/src/matching/error-matcher.ts +0 -166
  169. package/src/matching/fingerprint.ts +0 -34
  170. package/src/matching/similarity.ts +0 -61
  171. package/src/matching/tfidf.ts +0 -74
  172. package/src/matching/tokenizer.ts +0 -41
  173. package/src/mcp/auto-detect.ts +0 -93
  174. package/src/mcp/http-server.ts +0 -140
  175. package/src/mcp/server.ts +0 -73
  176. package/src/mcp/tools.ts +0 -328
  177. package/src/parsing/error-parser.ts +0 -28
  178. package/src/parsing/parsers/compiler.ts +0 -93
  179. package/src/parsing/parsers/generic.ts +0 -28
  180. package/src/parsing/parsers/go.ts +0 -97
  181. package/src/parsing/parsers/node.ts +0 -69
  182. package/src/parsing/parsers/python.ts +0 -62
  183. package/src/parsing/parsers/rust.ts +0 -50
  184. package/src/parsing/parsers/shell.ts +0 -42
  185. package/src/parsing/types.ts +0 -47
  186. package/src/research/gap-analyzer.ts +0 -135
  187. package/src/research/insight-generator.ts +0 -123
  188. package/src/research/research-engine.ts +0 -116
  189. package/src/research/synergy-detector.ts +0 -126
  190. package/src/research/template-extractor.ts +0 -130
  191. package/src/research/trend-analyzer.ts +0 -127
  192. package/src/services/analytics.service.ts +0 -226
  193. package/src/services/code.service.ts +0 -271
  194. package/src/services/error.service.ts +0 -266
  195. package/src/services/git.service.ts +0 -132
  196. package/src/services/notification.service.ts +0 -41
  197. package/src/services/prevention.service.ts +0 -159
  198. package/src/services/research.service.ts +0 -98
  199. package/src/services/solution.service.ts +0 -174
  200. package/src/services/synapse.service.ts +0 -59
  201. package/src/services/terminal.service.ts +0 -81
  202. package/src/synapses/activation.ts +0 -80
  203. package/src/synapses/decay.ts +0 -38
  204. package/src/synapses/hebbian.ts +0 -69
  205. package/src/synapses/pathfinder.ts +0 -81
  206. package/src/synapses/synapse-manager.ts +0 -113
  207. package/src/types/code.types.ts +0 -52
  208. package/src/types/config.types.ts +0 -103
  209. package/src/types/error.types.ts +0 -67
  210. package/src/types/ipc.types.ts +0 -8
  211. package/src/types/mcp.types.ts +0 -53
  212. package/src/types/research.types.ts +0 -28
  213. package/src/types/solution.types.ts +0 -30
  214. package/src/types/synapse.types.ts +0 -50
  215. package/src/utils/events.ts +0 -45
  216. package/src/utils/hash.ts +0 -5
  217. package/src/utils/logger.ts +0 -48
  218. package/src/utils/paths.ts +0 -19
  219. package/tests/e2e/test_code_intelligence.py +0 -1015
  220. package/tests/e2e/test_error_memory.py +0 -451
  221. package/tests/e2e/test_full_integration.py +0 -534
  222. package/tests/fixtures/code-modules/modules.ts +0 -83
  223. package/tests/fixtures/errors/go.ts +0 -9
  224. package/tests/fixtures/errors/node.ts +0 -24
  225. package/tests/fixtures/errors/python.ts +0 -21
  226. package/tests/fixtures/errors/rust.ts +0 -25
  227. package/tests/fixtures/errors/shell.ts +0 -15
  228. package/tests/fixtures/solutions/solutions.ts +0 -27
  229. package/tests/helpers/setup-db.ts +0 -52
  230. package/tests/integration/code-flow.test.ts +0 -86
  231. package/tests/integration/error-flow.test.ts +0 -83
  232. package/tests/integration/ipc-flow.test.ts +0 -166
  233. package/tests/integration/learning-cycle.test.ts +0 -82
  234. package/tests/integration/synapse-flow.test.ts +0 -117
  235. package/tests/unit/code/analyzer.test.ts +0 -58
  236. package/tests/unit/code/fingerprint.test.ts +0 -51
  237. package/tests/unit/code/scorer.test.ts +0 -55
  238. package/tests/unit/learning/confidence-scorer.test.ts +0 -60
  239. package/tests/unit/learning/decay.test.ts +0 -45
  240. package/tests/unit/learning/pattern-extractor.test.ts +0 -50
  241. package/tests/unit/matching/error-matcher.test.ts +0 -69
  242. package/tests/unit/matching/fingerprint.test.ts +0 -47
  243. package/tests/unit/matching/similarity.test.ts +0 -65
  244. package/tests/unit/matching/tfidf.test.ts +0 -71
  245. package/tests/unit/matching/tokenizer.test.ts +0 -83
  246. package/tests/unit/parsing/parsers.test.ts +0 -113
  247. package/tests/unit/research/gap-analyzer.test.ts +0 -45
  248. package/tests/unit/research/trend-analyzer.test.ts +0 -45
  249. package/tests/unit/synapses/activation.test.ts +0 -80
  250. package/tests/unit/synapses/decay.test.ts +0 -27
  251. package/tests/unit/synapses/hebbian.test.ts +0 -96
  252. package/tests/unit/synapses/pathfinder.test.ts +0 -72
  253. package/tsconfig.json +0 -18
package/src/ipc/router.ts DELETED
@@ -1,133 +0,0 @@
1
- import { getLogger } from '../utils/logger.js';
2
-
3
- const logger = getLogger();
4
- import type { ErrorService } from '../services/error.service.js';
5
- import type { SolutionService } from '../services/solution.service.js';
6
- import type { TerminalService } from '../services/terminal.service.js';
7
- import type { PreventionService } from '../services/prevention.service.js';
8
- import type { CodeService } from '../services/code.service.js';
9
- import type { SynapseService } from '../services/synapse.service.js';
10
- import type { ResearchService } from '../services/research.service.js';
11
- import type { NotificationService } from '../services/notification.service.js';
12
- import type { AnalyticsService } from '../services/analytics.service.js';
13
- import type { GitService } from '../services/git.service.js';
14
- import type { LearningEngine, LearningCycleResult } from '../learning/learning-engine.js';
15
-
16
- export interface Services {
17
- error: ErrorService;
18
- solution: SolutionService;
19
- terminal: TerminalService;
20
- prevention: PreventionService;
21
- code: CodeService;
22
- synapse: SynapseService;
23
- research: ResearchService;
24
- notification: NotificationService;
25
- analytics: AnalyticsService;
26
- git: GitService;
27
- learning?: LearningEngine;
28
- }
29
-
30
- type MethodHandler = (params: unknown) => unknown;
31
-
32
- export class IpcRouter {
33
- private methods: Map<string, MethodHandler>;
34
-
35
- constructor(private services: Services) {
36
- this.methods = this.buildMethodMap();
37
- }
38
-
39
- handle(method: string, params: unknown): unknown {
40
- const handler = this.methods.get(method);
41
- if (!handler) {
42
- throw new Error(`Unknown method: ${method}`);
43
- }
44
-
45
- logger.debug(`IPC: ${method}`, { params });
46
- const result = handler(params);
47
- logger.debug(`IPC: ${method} → done`);
48
- return result;
49
- }
50
-
51
- listMethods(): string[] {
52
- return [...this.methods.keys()];
53
- }
54
-
55
- private buildMethodMap(): Map<string, MethodHandler> {
56
- const s = this.services;
57
- // eslint-disable-next-line @typescript-eslint/no-explicit-any
58
- const p = (params: unknown) => params as any;
59
-
60
- return new Map<string, MethodHandler>([
61
- // Terminal Lifecycle
62
- ['terminal.register', (params) => s.terminal.register(p(params))],
63
- ['terminal.heartbeat', (params) => s.terminal.heartbeat(p(params).uuid)],
64
- ['terminal.disconnect', (params) => s.terminal.disconnect(p(params).uuid)],
65
-
66
- // Error Brain
67
- ['error.report', (params) => s.error.report(p(params))],
68
- ['error.query', (params) => s.error.query(p(params))],
69
- ['error.match', (params) => s.error.matchSimilar(p(params).error_id ?? p(params).errorId)],
70
- ['error.resolve', (params) => s.error.resolve(p(params).error_id ?? p(params).errorId, p(params).solution_id ?? p(params).solutionId)],
71
- ['error.get', (params) => s.error.getById(p(params).id)],
72
- ['error.chain', (params) => s.error.getErrorChain(p(params).error_id ?? p(params).errorId ?? p(params).id)],
73
-
74
- // Solutions
75
- ['solution.report', (params) => s.solution.report(p(params))],
76
- ['solution.query', (params) => s.solution.findForError(p(params).error_id ?? p(params).errorId)],
77
- ['solution.rate', (params) => s.solution.rateOutcome(p(params))],
78
- ['solution.attempt', (params) => s.solution.rateOutcome({ ...p(params), success: false })],
79
- ['solution.efficiency', () => s.solution.analyzeEfficiency()],
80
-
81
- // Projects
82
- ['project.list', () => s.code.listProjects()],
83
-
84
- // Code Brain
85
- ['code.analyze', (params) => s.code.analyzeAndRegister(p(params))],
86
- ['code.find', (params) => s.code.findReusable(p(params))],
87
- ['code.similarity', (params) => s.code.checkSimilarity(p(params).source, p(params).language)],
88
- ['code.modules', (params) => s.code.listModules(p(params)?.projectId, p(params)?.language, p(params)?.limit)],
89
- ['code.get', (params) => s.code.getById(p(params).id)],
90
-
91
- // Prevention
92
- ['prevention.check', (params) => s.prevention.checkRules(p(params).errorType, p(params).message, p(params).projectId)],
93
- ['prevention.antipatterns', (params) => s.prevention.checkAntipatterns(p(params).errorType ?? '', p(params).message ?? p(params).error_output ?? '', p(params).projectId)],
94
- ['prevention.checkCode', (params) => s.prevention.checkCodeForPatterns(p(params).source, p(params).filePath)],
95
-
96
- // Synapses
97
- ['synapse.context', (params) => s.synapse.getErrorContext(p(params).errorId ?? p(params).error_id ?? p(params).node_id)],
98
- ['synapse.path', (params) => s.synapse.findPath(p(params).from_type ?? p(params).fromType, p(params).from_id ?? p(params).fromId, p(params).to_type ?? p(params).toType, p(params).to_id ?? p(params).toId)],
99
- ['synapse.related', (params) => s.synapse.getRelated(p(params))],
100
- ['synapse.stats', () => s.synapse.getNetworkStats()],
101
-
102
- // Research / Insights
103
- ['research.insights', (params) => s.research.getInsights(p(params))],
104
- ['insight.rate', (params) => s.research.rateInsight(p(params).id, p(params).rating, p(params).comment)],
105
- ['research.suggest', (params) => s.research.getInsights({ limit: 10, activeOnly: true, ...p(params) })],
106
- ['research.trends', (params) => s.research.getTrends(p(params)?.projectId, p(params)?.windowDays)],
107
-
108
- // Notifications
109
- ['notification.list', (params) => s.notification.list(p(params)?.projectId)],
110
- ['notification.ack', (params) => s.notification.acknowledge(p(params).id)],
111
-
112
- // Analytics
113
- ['analytics.summary', (params) => s.analytics.getSummary(p(params)?.projectId)],
114
- ['analytics.network', (params) => s.analytics.getNetworkOverview(p(params)?.limit)],
115
- ['analytics.health', (params) => s.analytics.computeHealthScore(p(params)?.projectId)],
116
- ['analytics.timeline', (params) => s.analytics.getTimeSeries(p(params)?.projectId, p(params)?.days)],
117
- ['analytics.explain', (params) => s.analytics.explainError(p(params).errorId ?? p(params).error_id)],
118
-
119
- // Git
120
- ['git.context', (params) => s.git.getGitContext(p(params)?.cwd)],
121
- ['git.linkError', (params) => s.git.linkErrorToCommit(p(params).errorId, p(params).projectId, p(params).commitHash, p(params).relationship)],
122
- ['git.errorCommits', (params) => s.git.findIntroducingCommit(p(params).errorId ?? p(params).error_id)],
123
- ['git.commitErrors', (params) => s.git.findErrorsByCommit(p(params).commitHash ?? p(params).commit_hash)],
124
- ['git.diff', (params) => s.git.captureDiff(p(params)?.cwd)],
125
-
126
- // Learning
127
- ['learning.run', () => {
128
- if (!s.learning) throw new Error('Learning engine not available');
129
- return s.learning.runCycle();
130
- }],
131
- ]);
132
- }
133
- }
package/src/ipc/server.ts DELETED
@@ -1,176 +0,0 @@
1
- import net from 'node:net';
2
- import fs from 'node:fs';
3
- import { randomUUID } from 'node:crypto';
4
- import { getLogger } from '../utils/logger.js';
5
-
6
- const logger = getLogger();
7
- import type { IpcMessage } from '../types/ipc.types.js';
8
- import { encodeMessage, MessageDecoder } from './protocol.js';
9
- import type { IpcRouter } from './router.js';
10
-
11
- export class IpcServer {
12
- private server: net.Server | null = null;
13
- private clients = new Map<string, net.Socket>();
14
-
15
- constructor(
16
- private router: IpcRouter,
17
- private pipeName: string,
18
- ) {}
19
-
20
- start(): void {
21
- this.createServer();
22
- this.listen();
23
- }
24
-
25
- private createServer(): void {
26
- this.server = net.createServer((socket) => {
27
- const clientId = randomUUID();
28
- this.clients.set(clientId, socket);
29
- const decoder = new MessageDecoder();
30
-
31
- logger.info(`IPC client connected: ${clientId}`);
32
-
33
- socket.on('data', (chunk) => {
34
- const messages = decoder.feed(chunk);
35
- for (const msg of messages) {
36
- this.handleMessage(clientId, msg, socket);
37
- }
38
- });
39
-
40
- socket.on('close', () => {
41
- logger.info(`IPC client disconnected: ${clientId}`);
42
- this.clients.delete(clientId);
43
- });
44
-
45
- socket.on('error', (err) => {
46
- logger.error(`IPC client ${clientId} error:`, err);
47
- this.clients.delete(clientId);
48
- });
49
- });
50
- }
51
-
52
- private listen(retried = false): void {
53
- if (!this.server) return;
54
-
55
- this.server.on('error', (err: NodeJS.ErrnoException) => {
56
- if (err.code === 'EADDRINUSE' && !retried) {
57
- logger.warn(`IPC pipe in use, attempting to recover stale pipe: ${this.pipeName}`);
58
- this.recoverStalePipe();
59
- } else {
60
- logger.error('IPC server error:', err);
61
- }
62
- });
63
-
64
- this.server.listen(this.pipeName, () => {
65
- logger.info(`IPC server listening on ${this.pipeName}`);
66
- });
67
- }
68
-
69
- /**
70
- * On Windows, named pipes can remain after a crashed daemon.
71
- * Try to connect as a client — if it fails, the pipe is stale and we can reclaim it.
72
- * On Unix, simply unlink the socket file and retry.
73
- */
74
- private recoverStalePipe(): void {
75
- const probe = net.createConnection(this.pipeName);
76
-
77
- probe.on('connect', () => {
78
- // Pipe is alive — another daemon is actually running
79
- probe.destroy();
80
- logger.error('IPC pipe is held by another running daemon. Stop it first with: brain stop');
81
- });
82
-
83
- probe.on('error', () => {
84
- // Pipe is stale — no one is listening. Clean up and retry.
85
- probe.destroy();
86
- logger.info('Stale IPC pipe detected, reclaiming...');
87
-
88
- // On Unix, unlink the socket file
89
- if (process.platform !== 'win32') {
90
- try { fs.unlinkSync(this.pipeName); } catch { /* ignore */ }
91
- }
92
-
93
- // Recreate server and retry (Windows auto-reclaims dead named pipes on re-listen)
94
- this.createServer();
95
- this.server!.on('error', (err) => {
96
- logger.error('IPC server error after recovery:', err);
97
- });
98
- this.server!.listen(this.pipeName, () => {
99
- logger.info(`IPC server recovered and listening on ${this.pipeName}`);
100
- });
101
- });
102
-
103
- // Timeout: if probe hangs, treat pipe as stale
104
- probe.setTimeout(2000, () => {
105
- probe.destroy();
106
- logger.warn('IPC pipe probe timed out, treating as stale');
107
- if (process.platform !== 'win32') {
108
- try { fs.unlinkSync(this.pipeName); } catch { /* ignore */ }
109
- }
110
- this.createServer();
111
- this.server!.on('error', (err) => {
112
- logger.error('IPC server error after timeout recovery:', err);
113
- });
114
- this.server!.listen(this.pipeName, () => {
115
- logger.info(`IPC server recovered (timeout) and listening on ${this.pipeName}`);
116
- });
117
- });
118
- }
119
-
120
- private handleMessage(clientId: string, msg: IpcMessage, socket: net.Socket): void {
121
- if (msg.type !== 'request' || !msg.method) return;
122
-
123
- try {
124
- const result = this.router.handle(msg.method, msg.params);
125
- const response: IpcMessage = {
126
- id: msg.id,
127
- type: 'response',
128
- result,
129
- };
130
- socket.write(encodeMessage(response));
131
- } catch (err) {
132
- const response: IpcMessage = {
133
- id: msg.id,
134
- type: 'response',
135
- error: { code: -1, message: err instanceof Error ? err.message : String(err) },
136
- };
137
- socket.write(encodeMessage(response));
138
- }
139
- }
140
-
141
- notify(clientId: string | null, notification: Omit<IpcMessage, 'id' | 'type'>): void {
142
- const msg: IpcMessage = {
143
- id: randomUUID(),
144
- type: 'notification',
145
- ...notification,
146
- };
147
- const encoded = encodeMessage(msg);
148
-
149
- if (clientId) {
150
- const socket = this.clients.get(clientId);
151
- if (socket && !socket.destroyed) {
152
- socket.write(encoded);
153
- }
154
- } else {
155
- for (const socket of this.clients.values()) {
156
- if (!socket.destroyed) {
157
- socket.write(encoded);
158
- }
159
- }
160
- }
161
- }
162
-
163
- getClientCount(): number {
164
- return this.clients.size;
165
- }
166
-
167
- stop(): void {
168
- for (const socket of this.clients.values()) {
169
- socket.destroy();
170
- }
171
- this.clients.clear();
172
- this.server?.close();
173
- this.server = null;
174
- logger.info('IPC server stopped');
175
- }
176
- }
@@ -1,80 +0,0 @@
1
- /**
2
- * Wilson Score Interval for low-sample-size confidence.
3
- * Prevents unrealistic 100% from single success/failure.
4
- */
5
- export function wilsonScore(successes: number, total: number, z: number = 1.96): number {
6
- if (total === 0) return 0;
7
-
8
- const p = successes / total;
9
- const z2 = z * z;
10
- const n = total;
11
-
12
- const numerator = p + z2 / (2 * n);
13
- const denominator = 1 + z2 / n;
14
- const margin = z * Math.sqrt((p * (1 - p) + z2 / (4 * n)) / n) / denominator;
15
-
16
- // Lower bound of Wilson interval = conservative estimate
17
- return Math.max(0, numerator / denominator - margin);
18
- }
19
-
20
- /**
21
- * Time-decayed confidence: recent successes count more.
22
- */
23
- export function timeDecayedConfidence(
24
- successes: number,
25
- total: number,
26
- lastUsedAt: string,
27
- halfLifeDays: number,
28
- ): number {
29
- const base = wilsonScore(successes, total);
30
- const ageDays = (Date.now() - new Date(lastUsedAt).getTime()) / (1000 * 60 * 60 * 24);
31
- const decay = Math.pow(0.5, ageDays / halfLifeDays);
32
- return base * decay;
33
- }
34
-
35
- /**
36
- * Combined confidence from success rate + usage frequency + recency.
37
- */
38
- export function computeConfidence(
39
- successCount: number,
40
- failCount: number,
41
- lastUsedAt: string,
42
- halfLifeDays: number = 30,
43
- ): number {
44
- const total = successCount + failCount;
45
- if (total === 0) return 0;
46
- return timeDecayedConfidence(successCount, total, lastUsedAt, halfLifeDays);
47
- }
48
-
49
- export interface AdaptiveThresholds {
50
- minOccurrences: number;
51
- minSuccessRate: number;
52
- minConfidence: number;
53
- pruneThreshold: number;
54
- }
55
-
56
- /**
57
- * Compute adaptive thresholds based on data volume.
58
- * Users with lots of data need stricter thresholds; users with little data need looser ones.
59
- */
60
- export function computeAdaptiveThresholds(
61
- totalErrors: number,
62
- totalSolutions: number,
63
- baseConfig: { minOccurrences: number; minSuccessRate: number; minConfidence: number; pruneThreshold: number },
64
- ): AdaptiveThresholds {
65
- // Scale factor: 1.0 at 50 errors, increases with more data
66
- const errorScale = Math.min(2.0, Math.max(0.5, totalErrors / 50));
67
- const solutionScale = Math.min(2.0, Math.max(0.5, totalSolutions / 20));
68
- const dataScale = (errorScale + solutionScale) / 2;
69
-
70
- return {
71
- // More data → require more occurrences before learning
72
- minOccurrences: Math.max(2, Math.round(baseConfig.minOccurrences * dataScale)),
73
- // More data → can afford higher success rate requirement
74
- minSuccessRate: Math.min(0.95, baseConfig.minSuccessRate * (0.85 + dataScale * 0.15)),
75
- // More data → higher confidence threshold
76
- minConfidence: Math.min(0.90, baseConfig.minConfidence * (0.85 + dataScale * 0.15)),
77
- // More data → stricter pruning
78
- pruneThreshold: Math.max(0.10, baseConfig.pruneThreshold * (1.1 - dataScale * 0.1)),
79
- };
80
- }
@@ -1,46 +0,0 @@
1
- import type { SolutionRepository } from '../db/repositories/solution.repository.js';
2
- import { wilsonScore } from './confidence-scorer.js';
3
-
4
- /**
5
- * Update confidence scores for all solutions based on their attempt history.
6
- */
7
- export function updateSolutionConfidences(solutionRepo: SolutionRepository): number {
8
- const solutions = solutionRepo.getAll();
9
- let updated = 0;
10
-
11
- for (const sol of solutions) {
12
- const total = sol.success_count + sol.fail_count;
13
- if (total === 0) continue;
14
-
15
- const newConfidence = wilsonScore(sol.success_count, total);
16
- if (Math.abs(newConfidence - sol.confidence) > 0.001) {
17
- solutionRepo.update(sol.id, { confidence: newConfidence });
18
- updated++;
19
- }
20
- }
21
-
22
- return updated;
23
- }
24
-
25
- /**
26
- * Compute relevance decay factor for a timestamp.
27
- */
28
- export function relevanceDecay(timestamp: string, halfLifeDays: number): number {
29
- const ageDays = (Date.now() - new Date(timestamp).getTime()) / (1000 * 60 * 60 * 24);
30
- return Math.pow(0.5, ageDays / halfLifeDays);
31
- }
32
-
33
- /**
34
- * Determine if a rule should be pruned based on its performance.
35
- */
36
- export function shouldPruneRule(
37
- confidence: number,
38
- rejectionCount: number,
39
- totalUsage: number,
40
- pruneThreshold: number,
41
- maxRejectionRate: number,
42
- ): boolean {
43
- if (confidence < pruneThreshold) return true;
44
- if (totalUsage > 0 && rejectionCount / totalUsage > maxRejectionRate) return true;
45
- return false;
46
- }
@@ -1,170 +0,0 @@
1
- import type { LearningConfig } 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 { RuleRepository } from '../db/repositories/rule.repository.js';
5
- import type { AntipatternRepository } from '../db/repositories/antipattern.repository.js';
6
- import type { SynapseManager } from '../synapses/synapse-manager.js';
7
- import { extractPatterns } from './pattern-extractor.js';
8
- import { generateRules, persistRules } from './rule-generator.js';
9
- import { shouldPruneRule } from './decay.js';
10
- import { computeAdaptiveThresholds, type AdaptiveThresholds } from './confidence-scorer.js';
11
- import { getLogger } from '../utils/logger.js';
12
-
13
- export interface LearningCycleResult {
14
- newPatterns: number;
15
- updatedRules: number;
16
- prunedRules: number;
17
- newAntipatterns: number;
18
- duration: number;
19
- }
20
-
21
- export class LearningEngine {
22
- private timer: ReturnType<typeof setInterval> | null = null;
23
- private logger = getLogger();
24
- private lastCycleAt: string | null = null;
25
-
26
- constructor(
27
- private config: LearningConfig,
28
- private errorRepo: ErrorRepository,
29
- private solutionRepo: SolutionRepository,
30
- private ruleRepo: RuleRepository,
31
- private antipatternRepo: AntipatternRepository,
32
- private synapseManager: SynapseManager,
33
- ) {}
34
-
35
- start(): void {
36
- this.logger.info(`Learning engine starting (interval: ${this.config.intervalMs}ms)`);
37
- this.timer = setInterval(() => this.runCycle(), this.config.intervalMs);
38
- }
39
-
40
- stop(): void {
41
- if (this.timer) {
42
- clearInterval(this.timer);
43
- this.timer = null;
44
- }
45
- this.logger.info('Learning engine stopped');
46
- }
47
-
48
- runCycle(): LearningCycleResult {
49
- const start = Date.now();
50
- this.logger.info('Learning cycle starting');
51
-
52
- const result: LearningCycleResult = {
53
- newPatterns: 0,
54
- updatedRules: 0,
55
- prunedRules: 0,
56
- newAntipatterns: 0,
57
- duration: 0,
58
- };
59
-
60
- // Phase 0: Compute adaptive thresholds
61
- const totalErrors = this.errorRepo.findUnresolved().length + this.errorRepo.countSince(new Date(0).toISOString());
62
- const totalSolutions = this.solutionRepo.getAll().length;
63
- const adaptive = computeAdaptiveThresholds(totalErrors, totalSolutions, this.config);
64
- this.logger.debug(`Adaptive thresholds: minOcc=${adaptive.minOccurrences}, minSuccess=${adaptive.minSuccessRate.toFixed(2)}, minConf=${adaptive.minConfidence.toFixed(2)}`);
65
-
66
- // Phase 1: Collect recent errors
67
- const since = this.lastCycleAt ?? new Date(Date.now() - this.config.intervalMs).toISOString();
68
- const recentErrors = this.errorRepo.findUnresolved();
69
-
70
- // Phase 2: Extract patterns
71
- const patterns = extractPatterns(recentErrors, adaptive.minSuccessRate);
72
- result.newPatterns = patterns.length;
73
-
74
- // Phase 3: Enrich patterns with solution data
75
- for (const pattern of patterns) {
76
- let totalSuccess = 0;
77
- let totalAttempts = 0;
78
-
79
- for (const errorId of pattern.errorIds) {
80
- const solutions = this.solutionRepo.findForError(errorId);
81
- pattern.solutionIds.push(...solutions.map(s => s.id));
82
-
83
- for (const sol of solutions) {
84
- const rate = this.solutionRepo.successRate(sol.id);
85
- totalSuccess += rate;
86
- totalAttempts++;
87
- }
88
- }
89
-
90
- pattern.successRate = totalAttempts > 0 ? totalSuccess / totalAttempts : 0;
91
- pattern.confidence = Math.min(
92
- 0.95,
93
- pattern.successRate * 0.6 + Math.min(1, pattern.occurrences / 10) * 0.4,
94
- );
95
- }
96
-
97
- // Phase 4: Generate rules from patterns (using adaptive thresholds)
98
- const adaptiveConfig = { ...this.config, ...adaptive };
99
- const rules = generateRules(patterns, adaptiveConfig);
100
- result.updatedRules = persistRules(rules, this.ruleRepo);
101
-
102
- // Phase 5: Prune weak rules (using adaptive thresholds)
103
- const activeRules = this.ruleRepo.findActive();
104
- for (const rule of activeRules) {
105
- if (shouldPruneRule(
106
- rule.confidence,
107
- 0, // rejection count not tracked yet
108
- rule.occurrences,
109
- adaptive.pruneThreshold,
110
- this.config.maxRejectionRate,
111
- )) {
112
- this.ruleRepo.update(rule.id, { active: 0 });
113
- result.prunedRules++;
114
- }
115
- }
116
-
117
- // Phase 6: Detect antipatterns
118
- result.newAntipatterns = this.detectAntipatterns();
119
-
120
- // Phase 7: Run synapse decay
121
- this.synapseManager.runDecay();
122
-
123
- this.lastCycleAt = new Date().toISOString();
124
- result.duration = Date.now() - start;
125
- this.logger.info(`Learning cycle complete: ${result.newPatterns} patterns, ${result.updatedRules} rules, ${result.prunedRules} pruned, ${result.newAntipatterns} antipatterns (${result.duration}ms)`);
126
-
127
- return result;
128
- }
129
-
130
- private detectAntipatterns(): number {
131
- const unresolvedErrors = this.errorRepo.findUnresolved();
132
- const recurring = unresolvedErrors.filter(e => e.occurrence_count >= this.config.minOccurrences);
133
- let count = 0;
134
-
135
- for (const error of recurring) {
136
- const solutions = this.solutionRepo.findForError(error.id);
137
- const allFailed = solutions.length > 0 && solutions.every(s => {
138
- const rate = this.solutionRepo.successRate(s.id);
139
- return rate < 0.3;
140
- });
141
-
142
- if (solutions.length >= 2 && allFailed) {
143
- // Check if antipattern already exists
144
- const existing = this.antipatternRepo.findByProject(error.project_id);
145
- const alreadyDetected = existing.some(ap =>
146
- ap.pattern.includes(error.type) && ap.description.includes(error.message.substring(0, 30))
147
- );
148
-
149
- if (!alreadyDetected) {
150
- this.antipatternRepo.create({
151
- pattern: `${error.type}.*${error.message.substring(0, 40).replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}`,
152
- description: `Recurring error without solution: ${error.type}: ${error.message}`,
153
- severity: solutions.length >= 4 ? 'critical' : 'warning',
154
- suggestion: null,
155
- occurrences: error.occurrence_count,
156
- project_id: error.project_id,
157
- global: 0,
158
- });
159
- count++;
160
- }
161
- }
162
- }
163
-
164
- return count;
165
- }
166
-
167
- getLastCycleAt(): string | null {
168
- return this.lastCycleAt;
169
- }
170
- }
@@ -1,90 +0,0 @@
1
- import type { ErrorRecord } from '../types/error.types.js';
2
- import { tokenize } from '../matching/tokenizer.js';
3
- import { cosineSimilarity } from '../matching/similarity.js';
4
-
5
- export interface ErrorPattern {
6
- errorType: string;
7
- messageTemplate: string;
8
- messageRegex: string;
9
- filePattern: string | null;
10
- occurrences: number;
11
- errorIds: number[];
12
- solutionIds: number[];
13
- confidence: number;
14
- successRate: number;
15
- }
16
-
17
- interface Centroid {
18
- errorType: string;
19
- tokens: string[];
20
- errorIds: number[];
21
- filePattern: string | null;
22
- }
23
-
24
- /**
25
- * Extract patterns from error records using centroid-based clustering.
26
- */
27
- export function extractPatterns(
28
- errors: ErrorRecord[],
29
- similarityThreshold: number = 0.7,
30
- ): ErrorPattern[] {
31
- const centroids: Centroid[] = [];
32
-
33
- for (const error of errors) {
34
- const tokens = tokenize(`${error.type} ${error.message}`);
35
- let merged = false;
36
-
37
- for (const centroid of centroids) {
38
- if (centroid.errorType !== error.type) continue;
39
-
40
- const sim = cosineSimilarity(centroid.tokens, tokens);
41
- if (sim >= similarityThreshold) {
42
- // Merge into existing centroid (running average)
43
- const allTokens = [...centroid.tokens, ...tokens];
44
- centroid.tokens = [...new Set(allTokens)];
45
- centroid.errorIds.push(error.id);
46
- if (!centroid.filePattern && error.file_path) {
47
- centroid.filePattern = extractFilePattern(error.file_path);
48
- }
49
- merged = true;
50
- break;
51
- }
52
- }
53
-
54
- if (!merged) {
55
- centroids.push({
56
- errorType: error.type,
57
- tokens,
58
- errorIds: [error.id],
59
- filePattern: error.file_path ? extractFilePattern(error.file_path) : null,
60
- });
61
- }
62
- }
63
-
64
- return centroids
65
- .filter(c => c.errorIds.length >= 2)
66
- .map(c => ({
67
- errorType: c.errorType,
68
- messageTemplate: c.tokens.join(' '),
69
- messageRegex: buildRegex(c.tokens),
70
- filePattern: c.filePattern,
71
- occurrences: c.errorIds.length,
72
- errorIds: c.errorIds,
73
- solutionIds: [],
74
- confidence: 0,
75
- successRate: 0,
76
- }));
77
- }
78
-
79
- function extractFilePattern(filePath: string): string {
80
- // Extract the meaningful part: last directory + extension
81
- const parts = filePath.replace(/\\/g, '/').split('/');
82
- const fileName = parts[parts.length - 1] ?? '';
83
- const ext = fileName.split('.').pop() ?? '';
84
- return ext ? `*.${ext}` : '*';
85
- }
86
-
87
- function buildRegex(tokens: string[]): string {
88
- const escaped = tokens.map(t => t.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'));
89
- return escaped.join('.*');
90
- }