@timmeck/brain 1.0.0 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (198) hide show
  1. package/BRAIN_PLAN.md +3324 -3324
  2. package/LICENSE +21 -21
  3. package/README.md +194 -188
  4. package/dist/brain.js +2 -0
  5. package/dist/brain.js.map +1 -1
  6. package/dist/cli/colors.d.ts +50 -0
  7. package/dist/cli/colors.js +106 -0
  8. package/dist/cli/colors.js.map +1 -0
  9. package/dist/cli/commands/config.d.ts +2 -0
  10. package/dist/cli/commands/config.js +165 -0
  11. package/dist/cli/commands/config.js.map +1 -0
  12. package/dist/cli/commands/dashboard.js +222 -8
  13. package/dist/cli/commands/dashboard.js.map +1 -1
  14. package/dist/cli/commands/export.js +3 -0
  15. package/dist/cli/commands/export.js.map +1 -1
  16. package/dist/cli/commands/import.js +24 -15
  17. package/dist/cli/commands/import.js.map +1 -1
  18. package/dist/cli/commands/insights.js +33 -6
  19. package/dist/cli/commands/insights.js.map +1 -1
  20. package/dist/cli/commands/learn.d.ts +2 -0
  21. package/dist/cli/commands/learn.js +22 -0
  22. package/dist/cli/commands/learn.js.map +1 -0
  23. package/dist/cli/commands/modules.js +25 -6
  24. package/dist/cli/commands/modules.js.map +1 -1
  25. package/dist/cli/commands/network.js +15 -9
  26. package/dist/cli/commands/network.js.map +1 -1
  27. package/dist/cli/commands/query.js +92 -25
  28. package/dist/cli/commands/query.js.map +1 -1
  29. package/dist/cli/commands/start.js +5 -4
  30. package/dist/cli/commands/start.js.map +1 -1
  31. package/dist/cli/commands/status.js +19 -16
  32. package/dist/cli/commands/status.js.map +1 -1
  33. package/dist/cli/commands/stop.js +5 -4
  34. package/dist/cli/commands/stop.js.map +1 -1
  35. package/dist/cli/ipc-helper.js +4 -3
  36. package/dist/cli/ipc-helper.js.map +1 -1
  37. package/dist/db/migrations/001_core_schema.js +115 -115
  38. package/dist/db/migrations/002_learning_schema.js +33 -33
  39. package/dist/db/migrations/003_code_schema.js +48 -48
  40. package/dist/db/migrations/004_synapses_schema.js +52 -52
  41. package/dist/db/migrations/005_fts_indexes.js +73 -73
  42. package/dist/db/migrations/index.js +6 -6
  43. package/dist/db/repositories/antipattern.repository.js +3 -3
  44. package/dist/db/repositories/code-module.repository.d.ts +1 -0
  45. package/dist/db/repositories/code-module.repository.js +8 -0
  46. package/dist/db/repositories/code-module.repository.js.map +1 -1
  47. package/dist/db/repositories/error.repository.js +46 -46
  48. package/dist/db/repositories/insight.repository.js +3 -3
  49. package/dist/db/repositories/notification.repository.js +3 -3
  50. package/dist/db/repositories/project.repository.js +21 -21
  51. package/dist/db/repositories/rule.repository.js +24 -24
  52. package/dist/db/repositories/solution.repository.js +50 -50
  53. package/dist/db/repositories/synapse.repository.js +18 -18
  54. package/dist/db/repositories/terminal.repository.js +24 -24
  55. package/dist/index.js +4 -0
  56. package/dist/index.js.map +1 -1
  57. package/dist/ipc/router.d.ts +2 -0
  58. package/dist/ipc/router.js +7 -1
  59. package/dist/ipc/router.js.map +1 -1
  60. package/dist/services/code.service.d.ts +1 -1
  61. package/dist/services/code.service.js +5 -2
  62. package/dist/services/code.service.js.map +1 -1
  63. package/package.json +5 -4
  64. package/src/brain.ts +3 -0
  65. package/src/cli/colors.ts +116 -0
  66. package/src/cli/commands/config.ts +169 -0
  67. package/src/cli/commands/dashboard.ts +231 -8
  68. package/src/cli/commands/export.ts +4 -0
  69. package/src/cli/commands/import.ts +24 -15
  70. package/src/cli/commands/insights.ts +37 -5
  71. package/src/cli/commands/learn.ts +24 -0
  72. package/src/cli/commands/modules.ts +28 -5
  73. package/src/cli/commands/network.ts +15 -9
  74. package/src/cli/commands/query.ts +103 -26
  75. package/src/cli/commands/start.ts +5 -4
  76. package/src/cli/commands/status.ts +19 -16
  77. package/src/cli/commands/stop.ts +5 -4
  78. package/src/cli/ipc-helper.ts +4 -3
  79. package/src/code/analyzer.ts +77 -77
  80. package/src/code/fingerprint.ts +87 -87
  81. package/src/code/matcher.ts +64 -64
  82. package/src/code/parsers/generic.ts +29 -29
  83. package/src/code/parsers/python.ts +54 -54
  84. package/src/code/parsers/typescript.ts +65 -65
  85. package/src/code/registry.ts +60 -60
  86. package/src/code/scorer.ts +108 -108
  87. package/src/config.ts +111 -111
  88. package/src/db/connection.ts +22 -22
  89. package/src/db/migrations/001_core_schema.ts +120 -120
  90. package/src/db/migrations/002_learning_schema.ts +38 -38
  91. package/src/db/migrations/003_code_schema.ts +53 -53
  92. package/src/db/migrations/004_synapses_schema.ts +57 -57
  93. package/src/db/migrations/005_fts_indexes.ts +78 -78
  94. package/src/db/migrations/006_synapses_phase3.ts +17 -17
  95. package/src/db/migrations/index.ts +64 -64
  96. package/src/db/repositories/antipattern.repository.ts +66 -66
  97. package/src/db/repositories/code-module.repository.ts +9 -0
  98. package/src/db/repositories/error.repository.ts +149 -149
  99. package/src/db/repositories/insight.repository.ts +78 -78
  100. package/src/db/repositories/notification.repository.ts +66 -66
  101. package/src/db/repositories/project.repository.ts +93 -93
  102. package/src/db/repositories/rule.repository.ts +108 -108
  103. package/src/db/repositories/solution.repository.ts +154 -154
  104. package/src/db/repositories/synapse.repository.ts +153 -153
  105. package/src/db/repositories/terminal.repository.ts +101 -101
  106. package/src/hooks/post-tool-use.ts +90 -90
  107. package/src/hooks/post-write.ts +117 -117
  108. package/src/index.ts +4 -0
  109. package/src/ipc/client.ts +118 -118
  110. package/src/ipc/protocol.ts +35 -35
  111. package/src/ipc/router.ts +9 -1
  112. package/src/ipc/server.ts +110 -110
  113. package/src/learning/confidence-scorer.ts +47 -47
  114. package/src/learning/decay.ts +46 -46
  115. package/src/learning/learning-engine.ts +162 -162
  116. package/src/learning/pattern-extractor.ts +90 -90
  117. package/src/learning/rule-generator.ts +74 -74
  118. package/src/matching/error-matcher.ts +115 -115
  119. package/src/matching/fingerprint.ts +29 -29
  120. package/src/matching/similarity.ts +61 -61
  121. package/src/matching/tfidf.ts +74 -74
  122. package/src/matching/tokenizer.ts +41 -41
  123. package/src/mcp/auto-detect.ts +93 -93
  124. package/src/mcp/server.ts +73 -73
  125. package/src/mcp/tools.ts +290 -290
  126. package/src/parsing/error-parser.ts +28 -28
  127. package/src/parsing/parsers/compiler.ts +93 -93
  128. package/src/parsing/parsers/generic.ts +28 -28
  129. package/src/parsing/parsers/go.ts +97 -97
  130. package/src/parsing/parsers/node.ts +69 -69
  131. package/src/parsing/parsers/python.ts +62 -62
  132. package/src/parsing/parsers/rust.ts +50 -50
  133. package/src/parsing/parsers/shell.ts +42 -42
  134. package/src/parsing/types.ts +47 -47
  135. package/src/research/gap-analyzer.ts +135 -135
  136. package/src/research/insight-generator.ts +123 -123
  137. package/src/research/research-engine.ts +116 -116
  138. package/src/research/synergy-detector.ts +126 -126
  139. package/src/research/template-extractor.ts +130 -130
  140. package/src/research/trend-analyzer.ts +127 -127
  141. package/src/services/analytics.service.ts +87 -87
  142. package/src/services/code.service.ts +5 -2
  143. package/src/services/error.service.ts +164 -164
  144. package/src/services/notification.service.ts +41 -41
  145. package/src/services/prevention.service.ts +119 -119
  146. package/src/services/research.service.ts +93 -93
  147. package/src/services/solution.service.ts +116 -116
  148. package/src/services/synapse.service.ts +59 -59
  149. package/src/services/terminal.service.ts +81 -81
  150. package/src/synapses/activation.ts +80 -80
  151. package/src/synapses/decay.ts +38 -38
  152. package/src/synapses/hebbian.ts +69 -69
  153. package/src/synapses/pathfinder.ts +81 -81
  154. package/src/synapses/synapse-manager.ts +109 -109
  155. package/src/types/code.types.ts +52 -52
  156. package/src/types/config.types.ts +79 -79
  157. package/src/types/error.types.ts +67 -67
  158. package/src/types/ipc.types.ts +8 -8
  159. package/src/types/mcp.types.ts +53 -53
  160. package/src/types/research.types.ts +28 -28
  161. package/src/types/solution.types.ts +30 -30
  162. package/src/types/synapse.types.ts +49 -49
  163. package/src/utils/events.ts +45 -45
  164. package/src/utils/hash.ts +5 -5
  165. package/src/utils/logger.ts +48 -48
  166. package/src/utils/paths.ts +19 -19
  167. package/tests/fixtures/code-modules/modules.ts +83 -83
  168. package/tests/fixtures/errors/go.ts +9 -9
  169. package/tests/fixtures/errors/node.ts +24 -24
  170. package/tests/fixtures/errors/python.ts +21 -21
  171. package/tests/fixtures/errors/rust.ts +25 -25
  172. package/tests/fixtures/errors/shell.ts +15 -15
  173. package/tests/fixtures/solutions/solutions.ts +27 -27
  174. package/tests/helpers/setup-db.ts +52 -52
  175. package/tests/integration/code-flow.test.ts +86 -86
  176. package/tests/integration/error-flow.test.ts +83 -83
  177. package/tests/integration/ipc-flow.test.ts +166 -166
  178. package/tests/integration/learning-cycle.test.ts +82 -82
  179. package/tests/integration/synapse-flow.test.ts +117 -117
  180. package/tests/unit/code/analyzer.test.ts +58 -58
  181. package/tests/unit/code/fingerprint.test.ts +51 -51
  182. package/tests/unit/code/scorer.test.ts +55 -55
  183. package/tests/unit/learning/confidence-scorer.test.ts +60 -60
  184. package/tests/unit/learning/decay.test.ts +45 -45
  185. package/tests/unit/learning/pattern-extractor.test.ts +50 -50
  186. package/tests/unit/matching/error-matcher.test.ts +69 -69
  187. package/tests/unit/matching/fingerprint.test.ts +47 -47
  188. package/tests/unit/matching/similarity.test.ts +65 -65
  189. package/tests/unit/matching/tfidf.test.ts +71 -71
  190. package/tests/unit/matching/tokenizer.test.ts +83 -83
  191. package/tests/unit/parsing/parsers.test.ts +113 -113
  192. package/tests/unit/research/gap-analyzer.test.ts +45 -45
  193. package/tests/unit/research/trend-analyzer.test.ts +45 -45
  194. package/tests/unit/synapses/activation.test.ts +80 -80
  195. package/tests/unit/synapses/decay.test.ts +27 -27
  196. package/tests/unit/synapses/hebbian.test.ts +96 -96
  197. package/tests/unit/synapses/pathfinder.test.ts +72 -72
  198. package/tsconfig.json +18 -18
@@ -1,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
+ }