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