@timmeck/brain 1.0.0 → 1.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (202) hide show
  1. package/BRAIN_PLAN.md +3324 -3324
  2. package/LICENSE +21 -21
  3. package/README.md +194 -188
  4. package/dist/brain.js +2 -0
  5. package/dist/brain.js.map +1 -1
  6. package/dist/cli/colors.d.ts +50 -0
  7. package/dist/cli/colors.js +106 -0
  8. package/dist/cli/colors.js.map +1 -0
  9. package/dist/cli/commands/config.d.ts +2 -0
  10. package/dist/cli/commands/config.js +165 -0
  11. package/dist/cli/commands/config.js.map +1 -0
  12. package/dist/cli/commands/dashboard.js +222 -8
  13. package/dist/cli/commands/dashboard.js.map +1 -1
  14. package/dist/cli/commands/export.js +3 -0
  15. package/dist/cli/commands/export.js.map +1 -1
  16. package/dist/cli/commands/import.js +24 -15
  17. package/dist/cli/commands/import.js.map +1 -1
  18. package/dist/cli/commands/insights.js +33 -6
  19. package/dist/cli/commands/insights.js.map +1 -1
  20. package/dist/cli/commands/learn.d.ts +2 -0
  21. package/dist/cli/commands/learn.js +22 -0
  22. package/dist/cli/commands/learn.js.map +1 -0
  23. package/dist/cli/commands/modules.js +25 -6
  24. package/dist/cli/commands/modules.js.map +1 -1
  25. package/dist/cli/commands/network.js +15 -9
  26. package/dist/cli/commands/network.js.map +1 -1
  27. package/dist/cli/commands/query.js +92 -25
  28. package/dist/cli/commands/query.js.map +1 -1
  29. package/dist/cli/commands/start.js +8 -5
  30. package/dist/cli/commands/start.js.map +1 -1
  31. package/dist/cli/commands/status.js +21 -16
  32. package/dist/cli/commands/status.js.map +1 -1
  33. package/dist/cli/commands/stop.js +5 -4
  34. package/dist/cli/commands/stop.js.map +1 -1
  35. package/dist/cli/ipc-helper.js +4 -3
  36. package/dist/cli/ipc-helper.js.map +1 -1
  37. package/dist/cli/update-check.d.ts +2 -0
  38. package/dist/cli/update-check.js +58 -0
  39. package/dist/cli/update-check.js.map +1 -0
  40. package/dist/db/migrations/001_core_schema.js +115 -115
  41. package/dist/db/migrations/002_learning_schema.js +33 -33
  42. package/dist/db/migrations/003_code_schema.js +48 -48
  43. package/dist/db/migrations/004_synapses_schema.js +52 -52
  44. package/dist/db/migrations/005_fts_indexes.js +73 -73
  45. package/dist/db/migrations/index.js +6 -6
  46. package/dist/db/repositories/antipattern.repository.js +3 -3
  47. package/dist/db/repositories/code-module.repository.d.ts +1 -0
  48. package/dist/db/repositories/code-module.repository.js +8 -0
  49. package/dist/db/repositories/code-module.repository.js.map +1 -1
  50. package/dist/db/repositories/error.repository.js +46 -46
  51. package/dist/db/repositories/insight.repository.js +3 -3
  52. package/dist/db/repositories/notification.repository.js +3 -3
  53. package/dist/db/repositories/project.repository.js +21 -21
  54. package/dist/db/repositories/rule.repository.js +24 -24
  55. package/dist/db/repositories/solution.repository.js +50 -50
  56. package/dist/db/repositories/synapse.repository.js +18 -18
  57. package/dist/db/repositories/terminal.repository.js +24 -24
  58. package/dist/index.js +4 -0
  59. package/dist/index.js.map +1 -1
  60. package/dist/ipc/router.d.ts +2 -0
  61. package/dist/ipc/router.js +7 -1
  62. package/dist/ipc/router.js.map +1 -1
  63. package/dist/services/code.service.d.ts +1 -1
  64. package/dist/services/code.service.js +5 -2
  65. package/dist/services/code.service.js.map +1 -1
  66. package/package.json +5 -4
  67. package/src/brain.ts +3 -0
  68. package/src/cli/colors.ts +116 -0
  69. package/src/cli/commands/config.ts +169 -0
  70. package/src/cli/commands/dashboard.ts +231 -8
  71. package/src/cli/commands/export.ts +4 -0
  72. package/src/cli/commands/import.ts +24 -15
  73. package/src/cli/commands/insights.ts +37 -5
  74. package/src/cli/commands/learn.ts +24 -0
  75. package/src/cli/commands/modules.ts +28 -5
  76. package/src/cli/commands/network.ts +15 -9
  77. package/src/cli/commands/query.ts +103 -26
  78. package/src/cli/commands/start.ts +8 -5
  79. package/src/cli/commands/status.ts +22 -16
  80. package/src/cli/commands/stop.ts +5 -4
  81. package/src/cli/ipc-helper.ts +4 -3
  82. package/src/cli/update-check.ts +63 -0
  83. package/src/code/analyzer.ts +77 -77
  84. package/src/code/fingerprint.ts +87 -87
  85. package/src/code/matcher.ts +64 -64
  86. package/src/code/parsers/generic.ts +29 -29
  87. package/src/code/parsers/python.ts +54 -54
  88. package/src/code/parsers/typescript.ts +65 -65
  89. package/src/code/registry.ts +60 -60
  90. package/src/code/scorer.ts +108 -108
  91. package/src/config.ts +111 -111
  92. package/src/db/connection.ts +22 -22
  93. package/src/db/migrations/001_core_schema.ts +120 -120
  94. package/src/db/migrations/002_learning_schema.ts +38 -38
  95. package/src/db/migrations/003_code_schema.ts +53 -53
  96. package/src/db/migrations/004_synapses_schema.ts +57 -57
  97. package/src/db/migrations/005_fts_indexes.ts +78 -78
  98. package/src/db/migrations/006_synapses_phase3.ts +17 -17
  99. package/src/db/migrations/index.ts +64 -64
  100. package/src/db/repositories/antipattern.repository.ts +66 -66
  101. package/src/db/repositories/code-module.repository.ts +9 -0
  102. package/src/db/repositories/error.repository.ts +149 -149
  103. package/src/db/repositories/insight.repository.ts +78 -78
  104. package/src/db/repositories/notification.repository.ts +66 -66
  105. package/src/db/repositories/project.repository.ts +93 -93
  106. package/src/db/repositories/rule.repository.ts +108 -108
  107. package/src/db/repositories/solution.repository.ts +154 -154
  108. package/src/db/repositories/synapse.repository.ts +153 -153
  109. package/src/db/repositories/terminal.repository.ts +101 -101
  110. package/src/hooks/post-tool-use.ts +90 -90
  111. package/src/hooks/post-write.ts +117 -117
  112. package/src/index.ts +4 -0
  113. package/src/ipc/client.ts +118 -118
  114. package/src/ipc/protocol.ts +35 -35
  115. package/src/ipc/router.ts +9 -1
  116. package/src/ipc/server.ts +110 -110
  117. package/src/learning/confidence-scorer.ts +47 -47
  118. package/src/learning/decay.ts +46 -46
  119. package/src/learning/learning-engine.ts +162 -162
  120. package/src/learning/pattern-extractor.ts +90 -90
  121. package/src/learning/rule-generator.ts +74 -74
  122. package/src/matching/error-matcher.ts +115 -115
  123. package/src/matching/fingerprint.ts +29 -29
  124. package/src/matching/similarity.ts +61 -61
  125. package/src/matching/tfidf.ts +74 -74
  126. package/src/matching/tokenizer.ts +41 -41
  127. package/src/mcp/auto-detect.ts +93 -93
  128. package/src/mcp/server.ts +73 -73
  129. package/src/mcp/tools.ts +290 -290
  130. package/src/parsing/error-parser.ts +28 -28
  131. package/src/parsing/parsers/compiler.ts +93 -93
  132. package/src/parsing/parsers/generic.ts +28 -28
  133. package/src/parsing/parsers/go.ts +97 -97
  134. package/src/parsing/parsers/node.ts +69 -69
  135. package/src/parsing/parsers/python.ts +62 -62
  136. package/src/parsing/parsers/rust.ts +50 -50
  137. package/src/parsing/parsers/shell.ts +42 -42
  138. package/src/parsing/types.ts +47 -47
  139. package/src/research/gap-analyzer.ts +135 -135
  140. package/src/research/insight-generator.ts +123 -123
  141. package/src/research/research-engine.ts +116 -116
  142. package/src/research/synergy-detector.ts +126 -126
  143. package/src/research/template-extractor.ts +130 -130
  144. package/src/research/trend-analyzer.ts +127 -127
  145. package/src/services/analytics.service.ts +87 -87
  146. package/src/services/code.service.ts +5 -2
  147. package/src/services/error.service.ts +164 -164
  148. package/src/services/notification.service.ts +41 -41
  149. package/src/services/prevention.service.ts +119 -119
  150. package/src/services/research.service.ts +93 -93
  151. package/src/services/solution.service.ts +116 -116
  152. package/src/services/synapse.service.ts +59 -59
  153. package/src/services/terminal.service.ts +81 -81
  154. package/src/synapses/activation.ts +80 -80
  155. package/src/synapses/decay.ts +38 -38
  156. package/src/synapses/hebbian.ts +69 -69
  157. package/src/synapses/pathfinder.ts +81 -81
  158. package/src/synapses/synapse-manager.ts +109 -109
  159. package/src/types/code.types.ts +52 -52
  160. package/src/types/config.types.ts +79 -79
  161. package/src/types/error.types.ts +67 -67
  162. package/src/types/ipc.types.ts +8 -8
  163. package/src/types/mcp.types.ts +53 -53
  164. package/src/types/research.types.ts +28 -28
  165. package/src/types/solution.types.ts +30 -30
  166. package/src/types/synapse.types.ts +49 -49
  167. package/src/utils/events.ts +45 -45
  168. package/src/utils/hash.ts +5 -5
  169. package/src/utils/logger.ts +48 -48
  170. package/src/utils/paths.ts +19 -19
  171. package/tests/fixtures/code-modules/modules.ts +83 -83
  172. package/tests/fixtures/errors/go.ts +9 -9
  173. package/tests/fixtures/errors/node.ts +24 -24
  174. package/tests/fixtures/errors/python.ts +21 -21
  175. package/tests/fixtures/errors/rust.ts +25 -25
  176. package/tests/fixtures/errors/shell.ts +15 -15
  177. package/tests/fixtures/solutions/solutions.ts +27 -27
  178. package/tests/helpers/setup-db.ts +52 -52
  179. package/tests/integration/code-flow.test.ts +86 -86
  180. package/tests/integration/error-flow.test.ts +83 -83
  181. package/tests/integration/ipc-flow.test.ts +166 -166
  182. package/tests/integration/learning-cycle.test.ts +82 -82
  183. package/tests/integration/synapse-flow.test.ts +117 -117
  184. package/tests/unit/code/analyzer.test.ts +58 -58
  185. package/tests/unit/code/fingerprint.test.ts +51 -51
  186. package/tests/unit/code/scorer.test.ts +55 -55
  187. package/tests/unit/learning/confidence-scorer.test.ts +60 -60
  188. package/tests/unit/learning/decay.test.ts +45 -45
  189. package/tests/unit/learning/pattern-extractor.test.ts +50 -50
  190. package/tests/unit/matching/error-matcher.test.ts +69 -69
  191. package/tests/unit/matching/fingerprint.test.ts +47 -47
  192. package/tests/unit/matching/similarity.test.ts +65 -65
  193. package/tests/unit/matching/tfidf.test.ts +71 -71
  194. package/tests/unit/matching/tokenizer.test.ts +83 -83
  195. package/tests/unit/parsing/parsers.test.ts +113 -113
  196. package/tests/unit/research/gap-analyzer.test.ts +45 -45
  197. package/tests/unit/research/trend-analyzer.test.ts +45 -45
  198. package/tests/unit/synapses/activation.test.ts +80 -80
  199. package/tests/unit/synapses/decay.test.ts +27 -27
  200. package/tests/unit/synapses/hebbian.test.ts +96 -96
  201. package/tests/unit/synapses/pathfinder.test.ts +72 -72
  202. package/tsconfig.json +18 -18
@@ -1,74 +1,74 @@
1
- export class TfIdfIndex {
2
- private documents = new Map<number, string[]>();
3
- private df = new Map<string, number>();
4
- private idf = new Map<string, number>();
5
- private documentCount = 0;
6
-
7
- addDocument(id: number, tokens: string[]): void {
8
- if (this.documents.has(id)) {
9
- this.removeDocument(id);
10
- }
11
- const unique = new Set(tokens);
12
- for (const token of unique) {
13
- this.df.set(token, (this.df.get(token) ?? 0) + 1);
14
- }
15
- this.documents.set(id, tokens);
16
- this.documentCount++;
17
- this.recomputeIdfForTerms(unique);
18
- }
19
-
20
- removeDocument(id: number): void {
21
- const tokens = this.documents.get(id);
22
- if (!tokens) return;
23
-
24
- const unique = new Set(tokens);
25
- for (const token of unique) {
26
- const count = this.df.get(token) ?? 0;
27
- if (count <= 1) {
28
- this.df.delete(token);
29
- this.idf.delete(token);
30
- } else {
31
- this.df.set(token, count - 1);
32
- }
33
- }
34
- this.documents.delete(id);
35
- this.documentCount--;
36
- }
37
-
38
- query(tokens: string[], topK: number = 10): Array<{ id: number; score: number }> {
39
- const scores = new Map<number, number>();
40
-
41
- for (const token of tokens) {
42
- const idfVal = this.idf.get(token) ?? 0;
43
- if (idfVal === 0) continue;
44
-
45
- for (const [docId, docTokens] of this.documents) {
46
- const tf = docTokens.filter(t => t === token).length / docTokens.length;
47
- const score = (scores.get(docId) ?? 0) + tf * idfVal;
48
- scores.set(docId, score);
49
- }
50
- }
51
-
52
- return Array.from(scores.entries())
53
- .map(([id, score]) => ({ id, score }))
54
- .sort((a, b) => b.score - a.score)
55
- .slice(0, topK);
56
- }
57
-
58
- getDocumentCount(): number {
59
- return this.documentCount;
60
- }
61
-
62
- getIdf(): ReadonlyMap<string, number> {
63
- return this.idf;
64
- }
65
-
66
- private recomputeIdfForTerms(terms: Set<string>): void {
67
- for (const term of terms) {
68
- const dfVal = this.df.get(term) ?? 0;
69
- if (dfVal > 0 && this.documentCount > 0) {
70
- this.idf.set(term, Math.log(this.documentCount / dfVal));
71
- }
72
- }
73
- }
74
- }
1
+ export class TfIdfIndex {
2
+ private documents = new Map<number, string[]>();
3
+ private df = new Map<string, number>();
4
+ private idf = new Map<string, number>();
5
+ private documentCount = 0;
6
+
7
+ addDocument(id: number, tokens: string[]): void {
8
+ if (this.documents.has(id)) {
9
+ this.removeDocument(id);
10
+ }
11
+ const unique = new Set(tokens);
12
+ for (const token of unique) {
13
+ this.df.set(token, (this.df.get(token) ?? 0) + 1);
14
+ }
15
+ this.documents.set(id, tokens);
16
+ this.documentCount++;
17
+ this.recomputeIdfForTerms(unique);
18
+ }
19
+
20
+ removeDocument(id: number): void {
21
+ const tokens = this.documents.get(id);
22
+ if (!tokens) return;
23
+
24
+ const unique = new Set(tokens);
25
+ for (const token of unique) {
26
+ const count = this.df.get(token) ?? 0;
27
+ if (count <= 1) {
28
+ this.df.delete(token);
29
+ this.idf.delete(token);
30
+ } else {
31
+ this.df.set(token, count - 1);
32
+ }
33
+ }
34
+ this.documents.delete(id);
35
+ this.documentCount--;
36
+ }
37
+
38
+ query(tokens: string[], topK: number = 10): Array<{ id: number; score: number }> {
39
+ const scores = new Map<number, number>();
40
+
41
+ for (const token of tokens) {
42
+ const idfVal = this.idf.get(token) ?? 0;
43
+ if (idfVal === 0) continue;
44
+
45
+ for (const [docId, docTokens] of this.documents) {
46
+ const tf = docTokens.filter(t => t === token).length / docTokens.length;
47
+ const score = (scores.get(docId) ?? 0) + tf * idfVal;
48
+ scores.set(docId, score);
49
+ }
50
+ }
51
+
52
+ return Array.from(scores.entries())
53
+ .map(([id, score]) => ({ id, score }))
54
+ .sort((a, b) => b.score - a.score)
55
+ .slice(0, topK);
56
+ }
57
+
58
+ getDocumentCount(): number {
59
+ return this.documentCount;
60
+ }
61
+
62
+ getIdf(): ReadonlyMap<string, number> {
63
+ return this.idf;
64
+ }
65
+
66
+ private recomputeIdfForTerms(terms: Set<string>): void {
67
+ for (const term of terms) {
68
+ const dfVal = this.df.get(term) ?? 0;
69
+ if (dfVal > 0 && this.documentCount > 0) {
70
+ this.idf.set(term, Math.log(this.documentCount / dfVal));
71
+ }
72
+ }
73
+ }
74
+ }
@@ -1,41 +1,41 @@
1
- const STOPWORDS = new Set([
2
- 'the', 'is', 'are', 'a', 'an', 'and', 'or', 'not', 'in', 'at', 'by', 'for',
3
- 'from', 'of', 'on', 'to', 'with', 'as', 'error', 'exception', 'throw', 'catch',
4
- 'was', 'be', 'been', 'being', 'have', 'has', 'had', 'do', 'does', 'did',
5
- 'will', 'would', 'could', 'should', 'may', 'might', 'can', 'it', 'its',
6
- 'this', 'that', 'these', 'those', 'i', 'we', 'you', 'he', 'she', 'they',
7
- ]);
8
-
9
- export function splitCamelCase(text: string): string[] {
10
- return text
11
- .replace(/([A-Z]+)([A-Z][a-z])/g, '$1 $2')
12
- .replace(/([a-z\d])([A-Z])/g, '$1 $2')
13
- .split(/\s+/)
14
- .filter(t => t.length > 0);
15
- }
16
-
17
- export function splitSnakeCase(text: string): string[] {
18
- return text.split(/[_\-]+/).filter(t => t.length > 0);
19
- }
20
-
21
- export function removeStopwords(tokens: string[]): string[] {
22
- return tokens.filter(t => !STOPWORDS.has(t.toLowerCase()));
23
- }
24
-
25
- export function tokenize(text: string): string[] {
26
- const words = text
27
- .replace(/[^\w\s]/g, ' ')
28
- .split(/\s+/)
29
- .filter(t => t.length > 0);
30
-
31
- const tokens: string[] = [];
32
- for (const word of words) {
33
- tokens.push(...splitCamelCase(word));
34
- if (word.includes('_') || word.includes('-')) {
35
- tokens.push(...splitSnakeCase(word));
36
- }
37
- }
38
-
39
- const cleaned = removeStopwords(tokens);
40
- return [...new Set(cleaned.map(t => t.toLowerCase()))];
41
- }
1
+ const STOPWORDS = new Set([
2
+ 'the', 'is', 'are', 'a', 'an', 'and', 'or', 'not', 'in', 'at', 'by', 'for',
3
+ 'from', 'of', 'on', 'to', 'with', 'as', 'error', 'exception', 'throw', 'catch',
4
+ 'was', 'be', 'been', 'being', 'have', 'has', 'had', 'do', 'does', 'did',
5
+ 'will', 'would', 'could', 'should', 'may', 'might', 'can', 'it', 'its',
6
+ 'this', 'that', 'these', 'those', 'i', 'we', 'you', 'he', 'she', 'they',
7
+ ]);
8
+
9
+ export function splitCamelCase(text: string): string[] {
10
+ return text
11
+ .replace(/([A-Z]+)([A-Z][a-z])/g, '$1 $2')
12
+ .replace(/([a-z\d])([A-Z])/g, '$1 $2')
13
+ .split(/\s+/)
14
+ .filter(t => t.length > 0);
15
+ }
16
+
17
+ export function splitSnakeCase(text: string): string[] {
18
+ return text.split(/[_\-]+/).filter(t => t.length > 0);
19
+ }
20
+
21
+ export function removeStopwords(tokens: string[]): string[] {
22
+ return tokens.filter(t => !STOPWORDS.has(t.toLowerCase()));
23
+ }
24
+
25
+ export function tokenize(text: string): string[] {
26
+ const words = text
27
+ .replace(/[^\w\s]/g, ' ')
28
+ .split(/\s+/)
29
+ .filter(t => t.length > 0);
30
+
31
+ const tokens: string[] = [];
32
+ for (const word of words) {
33
+ tokens.push(...splitCamelCase(word));
34
+ if (word.includes('_') || word.includes('-')) {
35
+ tokens.push(...splitSnakeCase(word));
36
+ }
37
+ }
38
+
39
+ const cleaned = removeStopwords(tokens);
40
+ return [...new Set(cleaned.map(t => t.toLowerCase()))];
41
+ }
@@ -1,93 +1,93 @@
1
- import { IpcClient } from '../ipc/client.js';
2
- import { getPipeName } from '../utils/paths.js';
3
-
4
- interface HookInput {
5
- tool_name: string;
6
- tool_input: { command?: string; file_path?: string };
7
- tool_output: string;
8
- exit_code?: number;
9
- }
10
-
11
- const ERROR_PATTERNS = [
12
- /Error:/i,
13
- /error\[E\d+\]/, // Rust errors
14
- /Traceback \(most recent call last\)/, // Python
15
- /FATAL|PANIC/i,
16
- /npm ERR!/,
17
- /SyntaxError|TypeError|ReferenceError|RangeError/,
18
- /ENOENT|EACCES|ECONNREFUSED|ETIMEDOUT/,
19
- /ModuleNotFoundError|ImportError/,
20
- /failed to compile/i,
21
- /BUILD FAILED/i,
22
- /Cannot find module/,
23
- /command not found/,
24
- /Permission denied/,
25
- ];
26
-
27
- function isError(input: HookInput): boolean {
28
- if (input.exit_code !== undefined && input.exit_code !== 0) return true;
29
- return ERROR_PATTERNS.some(p => p.test(input.tool_output));
30
- }
31
-
32
- function readStdin(): Promise<string> {
33
- return new Promise((resolve) => {
34
- let data = '';
35
- process.stdin.setEncoding('utf8');
36
- process.stdin.on('data', (chunk) => { data += chunk; });
37
- process.stdin.on('end', () => resolve(data));
38
- });
39
- }
40
-
41
- async function main(): Promise<void> {
42
- const raw = await readStdin();
43
- if (!raw.trim()) return;
44
-
45
- let input: HookInput;
46
- try {
47
- input = JSON.parse(raw);
48
- } catch {
49
- return;
50
- }
51
-
52
- if (!isError(input)) return;
53
-
54
- const client = new IpcClient(getPipeName(), 3000);
55
- try {
56
- await client.connect();
57
-
58
- // Report error to Brain
59
- // eslint-disable-next-line @typescript-eslint/no-explicit-any
60
- const result: any = await client.request('error.report', {
61
- project: 'auto-detected',
62
- errorOutput: input.tool_output,
63
- command: input.tool_input.command,
64
- autoDetected: true,
65
- });
66
-
67
- // If Brain knows a solution, output as feedback
68
- if (result.matches?.length > 0) {
69
- const best = result.matches[0];
70
- process.stderr.write(`Brain: Similar error found (#${best.errorId}, ${Math.round(best.score * 100)}% match)\n`);
71
- if (best.solutions?.length > 0) {
72
- process.stderr.write(`Brain: Solution available — use brain_query_error to see details\n`);
73
- }
74
- }
75
-
76
- // Anti-pattern check
77
- // eslint-disable-next-line @typescript-eslint/no-explicit-any
78
- const antipatterns: any = await client.request('prevention.antipatterns', {
79
- errorType: '',
80
- message: input.tool_output,
81
- });
82
- if (antipatterns?.length > 0 && antipatterns[0].matched) {
83
- process.stderr.write(`Brain WARNING: Known anti-pattern detected: ${antipatterns[0].description}\n`);
84
- }
85
-
86
- } catch {
87
- // Hook must never block the workflow — silent failure
88
- } finally {
89
- client.disconnect();
90
- }
91
- }
92
-
93
- main();
1
+ import { IpcClient } from '../ipc/client.js';
2
+ import { getPipeName } from '../utils/paths.js';
3
+
4
+ interface HookInput {
5
+ tool_name: string;
6
+ tool_input: { command?: string; file_path?: string };
7
+ tool_output: string;
8
+ exit_code?: number;
9
+ }
10
+
11
+ const ERROR_PATTERNS = [
12
+ /Error:/i,
13
+ /error\[E\d+\]/, // Rust errors
14
+ /Traceback \(most recent call last\)/, // Python
15
+ /FATAL|PANIC/i,
16
+ /npm ERR!/,
17
+ /SyntaxError|TypeError|ReferenceError|RangeError/,
18
+ /ENOENT|EACCES|ECONNREFUSED|ETIMEDOUT/,
19
+ /ModuleNotFoundError|ImportError/,
20
+ /failed to compile/i,
21
+ /BUILD FAILED/i,
22
+ /Cannot find module/,
23
+ /command not found/,
24
+ /Permission denied/,
25
+ ];
26
+
27
+ function isError(input: HookInput): boolean {
28
+ if (input.exit_code !== undefined && input.exit_code !== 0) return true;
29
+ return ERROR_PATTERNS.some(p => p.test(input.tool_output));
30
+ }
31
+
32
+ function readStdin(): Promise<string> {
33
+ return new Promise((resolve) => {
34
+ let data = '';
35
+ process.stdin.setEncoding('utf8');
36
+ process.stdin.on('data', (chunk) => { data += chunk; });
37
+ process.stdin.on('end', () => resolve(data));
38
+ });
39
+ }
40
+
41
+ async function main(): Promise<void> {
42
+ const raw = await readStdin();
43
+ if (!raw.trim()) return;
44
+
45
+ let input: HookInput;
46
+ try {
47
+ input = JSON.parse(raw);
48
+ } catch {
49
+ return;
50
+ }
51
+
52
+ if (!isError(input)) return;
53
+
54
+ const client = new IpcClient(getPipeName(), 3000);
55
+ try {
56
+ await client.connect();
57
+
58
+ // Report error to Brain
59
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
60
+ const result: any = await client.request('error.report', {
61
+ project: 'auto-detected',
62
+ errorOutput: input.tool_output,
63
+ command: input.tool_input.command,
64
+ autoDetected: true,
65
+ });
66
+
67
+ // If Brain knows a solution, output as feedback
68
+ if (result.matches?.length > 0) {
69
+ const best = result.matches[0];
70
+ process.stderr.write(`Brain: Similar error found (#${best.errorId}, ${Math.round(best.score * 100)}% match)\n`);
71
+ if (best.solutions?.length > 0) {
72
+ process.stderr.write(`Brain: Solution available — use brain_query_error to see details\n`);
73
+ }
74
+ }
75
+
76
+ // Anti-pattern check
77
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
78
+ const antipatterns: any = await client.request('prevention.antipatterns', {
79
+ errorType: '',
80
+ message: input.tool_output,
81
+ });
82
+ if (antipatterns?.length > 0 && antipatterns[0].matched) {
83
+ process.stderr.write(`Brain WARNING: Known anti-pattern detected: ${antipatterns[0].description}\n`);
84
+ }
85
+
86
+ } catch {
87
+ // Hook must never block the workflow — silent failure
88
+ } finally {
89
+ client.disconnect();
90
+ }
91
+ }
92
+
93
+ main();
package/src/mcp/server.ts CHANGED
@@ -1,73 +1,73 @@
1
- import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
2
- import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
3
- import { spawn } from 'node:child_process';
4
- import path from 'node:path';
5
- import { IpcClient } from '../ipc/client.js';
6
- import { getPipeName } from '../utils/paths.js';
7
- import { registerTools } from './tools.js';
8
-
9
- function spawnDaemon(): void {
10
- const entryPoint = path.resolve(import.meta.dirname, '../index.ts');
11
- const child = spawn(process.execPath, [
12
- '--import', 'tsx',
13
- entryPoint, 'daemon',
14
- ], {
15
- detached: true,
16
- stdio: 'ignore',
17
- cwd: path.resolve(import.meta.dirname, '../..'),
18
- });
19
- child.unref();
20
- process.stderr.write(`Brain: Auto-started daemon (PID: ${child.pid})\n`);
21
- }
22
-
23
- async function connectWithRetry(ipc: IpcClient, retries: number, delayMs: number): Promise<void> {
24
- for (let i = 0; i < retries; i++) {
25
- try {
26
- await ipc.connect();
27
- return;
28
- } catch {
29
- if (i < retries - 1) {
30
- await new Promise(r => setTimeout(r, delayMs));
31
- }
32
- }
33
- }
34
- throw new Error('Could not connect to daemon after retries');
35
- }
36
-
37
- export async function startMcpServer(): Promise<void> {
38
- const server = new McpServer({
39
- name: 'brain',
40
- version: '1.0.0',
41
- });
42
-
43
- const ipc = new IpcClient(getPipeName());
44
-
45
- try {
46
- await ipc.connect();
47
- } catch {
48
- // Daemon not running — auto-start it
49
- process.stderr.write('Brain: Daemon not running, starting automatically...\n');
50
- spawnDaemon();
51
- try {
52
- await connectWithRetry(ipc, 10, 500);
53
- } catch {
54
- process.stderr.write('Brain: Could not connect to daemon after auto-start. Check logs.\n');
55
- process.exit(1);
56
- }
57
- }
58
-
59
- registerTools(server, ipc);
60
-
61
- const transport = new StdioServerTransport();
62
- await server.connect(transport);
63
-
64
- process.on('SIGINT', () => {
65
- ipc.disconnect();
66
- process.exit(0);
67
- });
68
-
69
- process.on('SIGTERM', () => {
70
- ipc.disconnect();
71
- process.exit(0);
72
- });
73
- }
1
+ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
2
+ import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
3
+ import { spawn } from 'node:child_process';
4
+ import path from 'node:path';
5
+ import { IpcClient } from '../ipc/client.js';
6
+ import { getPipeName } from '../utils/paths.js';
7
+ import { registerTools } from './tools.js';
8
+
9
+ function spawnDaemon(): void {
10
+ const entryPoint = path.resolve(import.meta.dirname, '../index.ts');
11
+ const child = spawn(process.execPath, [
12
+ '--import', 'tsx',
13
+ entryPoint, 'daemon',
14
+ ], {
15
+ detached: true,
16
+ stdio: 'ignore',
17
+ cwd: path.resolve(import.meta.dirname, '../..'),
18
+ });
19
+ child.unref();
20
+ process.stderr.write(`Brain: Auto-started daemon (PID: ${child.pid})\n`);
21
+ }
22
+
23
+ async function connectWithRetry(ipc: IpcClient, retries: number, delayMs: number): Promise<void> {
24
+ for (let i = 0; i < retries; i++) {
25
+ try {
26
+ await ipc.connect();
27
+ return;
28
+ } catch {
29
+ if (i < retries - 1) {
30
+ await new Promise(r => setTimeout(r, delayMs));
31
+ }
32
+ }
33
+ }
34
+ throw new Error('Could not connect to daemon after retries');
35
+ }
36
+
37
+ export async function startMcpServer(): Promise<void> {
38
+ const server = new McpServer({
39
+ name: 'brain',
40
+ version: '1.0.0',
41
+ });
42
+
43
+ const ipc = new IpcClient(getPipeName());
44
+
45
+ try {
46
+ await ipc.connect();
47
+ } catch {
48
+ // Daemon not running — auto-start it
49
+ process.stderr.write('Brain: Daemon not running, starting automatically...\n');
50
+ spawnDaemon();
51
+ try {
52
+ await connectWithRetry(ipc, 10, 500);
53
+ } catch {
54
+ process.stderr.write('Brain: Could not connect to daemon after auto-start. Check logs.\n');
55
+ process.exit(1);
56
+ }
57
+ }
58
+
59
+ registerTools(server, ipc);
60
+
61
+ const transport = new StdioServerTransport();
62
+ await server.connect(transport);
63
+
64
+ process.on('SIGINT', () => {
65
+ ipc.disconnect();
66
+ process.exit(0);
67
+ });
68
+
69
+ process.on('SIGTERM', () => {
70
+ ipc.disconnect();
71
+ process.exit(0);
72
+ });
73
+ }