@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,101 +1,101 @@
1
- import type Database from 'better-sqlite3';
2
- import type { Statement } from 'better-sqlite3';
3
-
4
- export interface TerminalRecord {
5
- id: number;
6
- uuid: string;
7
- project_id: number | null;
8
- pid: number | null;
9
- shell: string | null;
10
- cwd: string | null;
11
- connected_at: string;
12
- last_seen: string;
13
- disconnected_at: string | null;
14
- }
15
-
16
- type CreateTerminalData = Omit<TerminalRecord, 'id' | 'connected_at' | 'last_seen' | 'disconnected_at'>;
17
- type UpdateTerminalData = Partial<Omit<TerminalRecord, 'id' | 'connected_at'>>;
18
-
19
- export class TerminalRepository {
20
- private stmts: Record<string, Statement>;
21
-
22
- constructor(private db: Database.Database) {
23
- this.stmts = {
24
- create: this.db.prepare(`
25
- INSERT INTO terminals (uuid, project_id, pid, shell, cwd)
26
- VALUES (@uuid, @project_id, @pid, @shell, @cwd)
27
- `),
28
- getById: this.db.prepare(`
29
- SELECT * FROM terminals WHERE id = ?
30
- `),
31
- update: this.db.prepare(`
32
- UPDATE terminals
33
- SET project_id = COALESCE(@project_id, project_id),
34
- pid = COALESCE(@pid, pid),
35
- shell = COALESCE(@shell, shell),
36
- cwd = COALESCE(@cwd, cwd),
37
- last_seen = COALESCE(@last_seen, last_seen),
38
- disconnected_at = COALESCE(@disconnected_at, disconnected_at)
39
- WHERE id = @id
40
- `),
41
- delete: this.db.prepare(`
42
- DELETE FROM terminals WHERE id = ?
43
- `),
44
- findByUuid: this.db.prepare(`
45
- SELECT * FROM terminals WHERE uuid = ?
46
- `),
47
- findConnected: this.db.prepare(`
48
- SELECT * FROM terminals WHERE disconnected_at IS NULL ORDER BY connected_at DESC
49
- `),
50
- cleanupStale: this.db.prepare(`
51
- UPDATE terminals
52
- SET disconnected_at = datetime('now')
53
- WHERE disconnected_at IS NULL AND last_seen < ?
54
- `),
55
- };
56
- }
57
-
58
- create(data: CreateTerminalData): number {
59
- const result = this.stmts.create.run({
60
- uuid: data.uuid,
61
- project_id: data.project_id ?? null,
62
- pid: data.pid ?? null,
63
- shell: data.shell ?? null,
64
- cwd: data.cwd ?? null,
65
- });
66
- return result.lastInsertRowid as number;
67
- }
68
-
69
- getById(id: number): TerminalRecord | undefined {
70
- return this.stmts.getById.get(id) as TerminalRecord | undefined;
71
- }
72
-
73
- update(id: number, data: UpdateTerminalData): void {
74
- this.stmts.update.run({
75
- id,
76
- project_id: data.project_id ?? null,
77
- pid: data.pid ?? null,
78
- shell: data.shell ?? null,
79
- cwd: data.cwd ?? null,
80
- last_seen: data.last_seen ?? null,
81
- disconnected_at: data.disconnected_at ?? null,
82
- });
83
- }
84
-
85
- delete(id: number): void {
86
- this.stmts.delete.run(id);
87
- }
88
-
89
- findByUuid(uuid: string): TerminalRecord | undefined {
90
- return this.stmts.findByUuid.get(uuid) as TerminalRecord | undefined;
91
- }
92
-
93
- findConnected(): TerminalRecord[] {
94
- return this.stmts.findConnected.all() as TerminalRecord[];
95
- }
96
-
97
- cleanupStale(olderThan: string): number {
98
- const result = this.stmts.cleanupStale.run(olderThan);
99
- return result.changes;
100
- }
101
- }
1
+ import type Database from 'better-sqlite3';
2
+ import type { Statement } from 'better-sqlite3';
3
+
4
+ export interface TerminalRecord {
5
+ id: number;
6
+ uuid: string;
7
+ project_id: number | null;
8
+ pid: number | null;
9
+ shell: string | null;
10
+ cwd: string | null;
11
+ connected_at: string;
12
+ last_seen: string;
13
+ disconnected_at: string | null;
14
+ }
15
+
16
+ type CreateTerminalData = Omit<TerminalRecord, 'id' | 'connected_at' | 'last_seen' | 'disconnected_at'>;
17
+ type UpdateTerminalData = Partial<Omit<TerminalRecord, 'id' | 'connected_at'>>;
18
+
19
+ export class TerminalRepository {
20
+ private stmts: Record<string, Statement>;
21
+
22
+ constructor(private db: Database.Database) {
23
+ this.stmts = {
24
+ create: this.db.prepare(`
25
+ INSERT INTO terminals (uuid, project_id, pid, shell, cwd)
26
+ VALUES (@uuid, @project_id, @pid, @shell, @cwd)
27
+ `),
28
+ getById: this.db.prepare(`
29
+ SELECT * FROM terminals WHERE id = ?
30
+ `),
31
+ update: this.db.prepare(`
32
+ UPDATE terminals
33
+ SET project_id = COALESCE(@project_id, project_id),
34
+ pid = COALESCE(@pid, pid),
35
+ shell = COALESCE(@shell, shell),
36
+ cwd = COALESCE(@cwd, cwd),
37
+ last_seen = COALESCE(@last_seen, last_seen),
38
+ disconnected_at = COALESCE(@disconnected_at, disconnected_at)
39
+ WHERE id = @id
40
+ `),
41
+ delete: this.db.prepare(`
42
+ DELETE FROM terminals WHERE id = ?
43
+ `),
44
+ findByUuid: this.db.prepare(`
45
+ SELECT * FROM terminals WHERE uuid = ?
46
+ `),
47
+ findConnected: this.db.prepare(`
48
+ SELECT * FROM terminals WHERE disconnected_at IS NULL ORDER BY connected_at DESC
49
+ `),
50
+ cleanupStale: this.db.prepare(`
51
+ UPDATE terminals
52
+ SET disconnected_at = datetime('now')
53
+ WHERE disconnected_at IS NULL AND last_seen < ?
54
+ `),
55
+ };
56
+ }
57
+
58
+ create(data: CreateTerminalData): number {
59
+ const result = this.stmts.create.run({
60
+ uuid: data.uuid,
61
+ project_id: data.project_id ?? null,
62
+ pid: data.pid ?? null,
63
+ shell: data.shell ?? null,
64
+ cwd: data.cwd ?? null,
65
+ });
66
+ return result.lastInsertRowid as number;
67
+ }
68
+
69
+ getById(id: number): TerminalRecord | undefined {
70
+ return this.stmts.getById.get(id) as TerminalRecord | undefined;
71
+ }
72
+
73
+ update(id: number, data: UpdateTerminalData): void {
74
+ this.stmts.update.run({
75
+ id,
76
+ project_id: data.project_id ?? null,
77
+ pid: data.pid ?? null,
78
+ shell: data.shell ?? null,
79
+ cwd: data.cwd ?? null,
80
+ last_seen: data.last_seen ?? null,
81
+ disconnected_at: data.disconnected_at ?? null,
82
+ });
83
+ }
84
+
85
+ delete(id: number): void {
86
+ this.stmts.delete.run(id);
87
+ }
88
+
89
+ findByUuid(uuid: string): TerminalRecord | undefined {
90
+ return this.stmts.findByUuid.get(uuid) as TerminalRecord | undefined;
91
+ }
92
+
93
+ findConnected(): TerminalRecord[] {
94
+ return this.stmts.findConnected.all() as TerminalRecord[];
95
+ }
96
+
97
+ cleanupStale(olderThan: string): number {
98
+ const result = this.stmts.cleanupStale.run(olderThan);
99
+ return result.changes;
100
+ }
101
+ }
@@ -1,90 +1,90 @@
1
- #!/usr/bin/env node
2
-
3
- // PostToolUse hook for Bash tool — auto-detects errors and reports to Brain
4
- // Configured in .claude/settings.json:
5
- // { "hooks": { "PostToolUse": [{ "matcher": { "tool_name": "Bash" }, "command": "node <brain-dist>/hooks/post-tool-use.js" }] } }
6
-
7
- import { IpcClient } from '../ipc/client.js';
8
- import { getPipeName } from '../utils/paths.js';
9
-
10
- interface HookInput {
11
- tool_name: string;
12
- tool_input: { command?: string };
13
- tool_output: string;
14
- exit_code?: number;
15
- }
16
-
17
- const ERROR_PATTERNS = [
18
- /Error:/i,
19
- /error\[E\d+\]/,
20
- /Traceback \(most recent call last\)/,
21
- /FATAL|PANIC/i,
22
- /npm ERR!/,
23
- /SyntaxError|TypeError|ReferenceError|RangeError/,
24
- /ENOENT|EACCES|ECONNREFUSED|ETIMEDOUT/,
25
- /ModuleNotFoundError|ImportError/,
26
- /failed to compile/i,
27
- /BUILD FAILED/i,
28
- /Cannot find module/,
29
- /command not found/,
30
- /Permission denied/,
31
- ];
32
-
33
- function isError(input: HookInput): boolean {
34
- if (input.exit_code !== undefined && input.exit_code !== 0) return true;
35
- return ERROR_PATTERNS.some(p => p.test(input.tool_output));
36
- }
37
-
38
- function readStdin(): Promise<string> {
39
- return new Promise((resolve) => {
40
- let data = '';
41
- process.stdin.setEncoding('utf8');
42
- process.stdin.on('data', (chunk) => { data += chunk; });
43
- process.stdin.on('end', () => resolve(data));
44
- });
45
- }
46
-
47
- async function main(): Promise<void> {
48
- const raw = await readStdin();
49
- if (!raw.trim()) return;
50
-
51
- let input: HookInput;
52
- try {
53
- input = JSON.parse(raw);
54
- } catch {
55
- return;
56
- }
57
-
58
- if (!isError(input)) return;
59
-
60
- const client = new IpcClient(getPipeName(), 3000);
61
- try {
62
- await client.connect();
63
-
64
- // eslint-disable-next-line @typescript-eslint/no-explicit-any
65
- const result: any = await client.request('error.report', {
66
- project: 'auto-detected',
67
- errorOutput: input.tool_output,
68
- });
69
-
70
- if (result.matches?.length > 0) {
71
- const best = result.matches[0];
72
- process.stderr.write(`Brain: Similar error found (#${best.errorId}, ${Math.round(best.score * 100)}% match)\n`);
73
- }
74
-
75
- // eslint-disable-next-line @typescript-eslint/no-explicit-any
76
- const antipatterns: any = await client.request('prevention.antipatterns', {
77
- errorType: '',
78
- message: input.tool_output,
79
- });
80
- if (antipatterns?.length > 0 && antipatterns[0].matched) {
81
- process.stderr.write(`Brain WARNING: Known anti-pattern: ${antipatterns[0].description}\n`);
82
- }
83
- } catch {
84
- // Hook must never block workflow
85
- } finally {
86
- client.disconnect();
87
- }
88
- }
89
-
90
- main();
1
+ #!/usr/bin/env node
2
+
3
+ // PostToolUse hook for Bash tool — auto-detects errors and reports to Brain
4
+ // Configured in .claude/settings.json:
5
+ // { "hooks": { "PostToolUse": [{ "matcher": { "tool_name": "Bash" }, "command": "node <brain-dist>/hooks/post-tool-use.js" }] } }
6
+
7
+ import { IpcClient } from '../ipc/client.js';
8
+ import { getPipeName } from '../utils/paths.js';
9
+
10
+ interface HookInput {
11
+ tool_name: string;
12
+ tool_input: { command?: string };
13
+ tool_output: string;
14
+ exit_code?: number;
15
+ }
16
+
17
+ const ERROR_PATTERNS = [
18
+ /Error:/i,
19
+ /error\[E\d+\]/,
20
+ /Traceback \(most recent call last\)/,
21
+ /FATAL|PANIC/i,
22
+ /npm ERR!/,
23
+ /SyntaxError|TypeError|ReferenceError|RangeError/,
24
+ /ENOENT|EACCES|ECONNREFUSED|ETIMEDOUT/,
25
+ /ModuleNotFoundError|ImportError/,
26
+ /failed to compile/i,
27
+ /BUILD FAILED/i,
28
+ /Cannot find module/,
29
+ /command not found/,
30
+ /Permission denied/,
31
+ ];
32
+
33
+ function isError(input: HookInput): boolean {
34
+ if (input.exit_code !== undefined && input.exit_code !== 0) return true;
35
+ return ERROR_PATTERNS.some(p => p.test(input.tool_output));
36
+ }
37
+
38
+ function readStdin(): Promise<string> {
39
+ return new Promise((resolve) => {
40
+ let data = '';
41
+ process.stdin.setEncoding('utf8');
42
+ process.stdin.on('data', (chunk) => { data += chunk; });
43
+ process.stdin.on('end', () => resolve(data));
44
+ });
45
+ }
46
+
47
+ async function main(): Promise<void> {
48
+ const raw = await readStdin();
49
+ if (!raw.trim()) return;
50
+
51
+ let input: HookInput;
52
+ try {
53
+ input = JSON.parse(raw);
54
+ } catch {
55
+ return;
56
+ }
57
+
58
+ if (!isError(input)) return;
59
+
60
+ const client = new IpcClient(getPipeName(), 3000);
61
+ try {
62
+ await client.connect();
63
+
64
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
65
+ const result: any = await client.request('error.report', {
66
+ project: 'auto-detected',
67
+ errorOutput: input.tool_output,
68
+ });
69
+
70
+ if (result.matches?.length > 0) {
71
+ const best = result.matches[0];
72
+ process.stderr.write(`Brain: Similar error found (#${best.errorId}, ${Math.round(best.score * 100)}% match)\n`);
73
+ }
74
+
75
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
76
+ const antipatterns: any = await client.request('prevention.antipatterns', {
77
+ errorType: '',
78
+ message: input.tool_output,
79
+ });
80
+ if (antipatterns?.length > 0 && antipatterns[0].matched) {
81
+ process.stderr.write(`Brain WARNING: Known anti-pattern: ${antipatterns[0].description}\n`);
82
+ }
83
+ } catch {
84
+ // Hook must never block workflow
85
+ } finally {
86
+ client.disconnect();
87
+ }
88
+ }
89
+
90
+ main();
@@ -1,117 +1,117 @@
1
- #!/usr/bin/env node
2
-
3
- // PostToolUse hook for Write/Edit tool — auto-analyzes code for reusability
4
- // Configured in .claude/settings.json:
5
- // { "hooks": { "PostToolUse": [{ "matcher": { "tool_name": "Write" }, "command": "node <brain-dist>/hooks/post-write.js" }] } }
6
-
7
- import { IpcClient } from '../ipc/client.js';
8
- import { getPipeName } from '../utils/paths.js';
9
-
10
- interface HookInput {
11
- tool_name: string;
12
- tool_input: { file_path?: string; content?: string };
13
- tool_output: string;
14
- }
15
-
16
- const SOURCE_EXTENSIONS = new Set([
17
- '.ts', '.tsx', '.js', '.jsx', '.py', '.rs', '.go',
18
- '.java', '.c', '.cpp', '.h', '.hpp', '.rb', '.sh',
19
- ]);
20
-
21
- const IGNORE_PATHS = [
22
- 'node_modules', 'dist', '.git', '__pycache__',
23
- 'vendor', 'build', '.next', 'coverage',
24
- ];
25
-
26
- function isSourceFile(filePath: string): boolean {
27
- const ext = filePath.slice(filePath.lastIndexOf('.'));
28
- if (!SOURCE_EXTENSIONS.has(ext)) return false;
29
- return !IGNORE_PATHS.some(p => filePath.includes(p));
30
- }
31
-
32
- function detectProject(filePath: string): string {
33
- const normalized = filePath.replace(/\\/g, '/');
34
- // Extract project name from path — look for common project root indicators
35
- const parts = normalized.split('/');
36
- // Find the directory just above src/, lib/, app/ etc., or use the parent of the file
37
- for (let i = parts.length - 1; i >= 0; i--) {
38
- if (['src', 'lib', 'app', 'components', 'pages', 'tests', 'test'].includes(parts[i]) && i > 0) {
39
- return parts[i - 1];
40
- }
41
- }
42
- // Fallback: use the directory two levels up from the file, or immediate parent
43
- return parts[Math.max(parts.length - 3, 0)] || 'default';
44
- }
45
-
46
- function detectLanguage(filePath: string): string {
47
- const ext = filePath.split('.').pop()?.toLowerCase() ?? '';
48
- const map: Record<string, string> = {
49
- ts: 'typescript', tsx: 'typescript', js: 'javascript', jsx: 'javascript',
50
- py: 'python', rs: 'rust', go: 'go', java: 'java',
51
- c: 'c', cpp: 'cpp', h: 'c', hpp: 'cpp',
52
- rb: 'ruby', sh: 'shell',
53
- };
54
- return map[ext] ?? ext;
55
- }
56
-
57
- function readStdin(): Promise<string> {
58
- return new Promise((resolve) => {
59
- let data = '';
60
- process.stdin.setEncoding('utf8');
61
- process.stdin.on('data', (chunk) => { data += chunk; });
62
- process.stdin.on('end', () => resolve(data));
63
- });
64
- }
65
-
66
- async function main(): Promise<void> {
67
- const raw = await readStdin();
68
- if (!raw.trim()) return;
69
-
70
- let input: HookInput;
71
- try {
72
- input = JSON.parse(raw);
73
- } catch {
74
- return;
75
- }
76
-
77
- const filePath = input.tool_input?.file_path;
78
- if (!filePath || !isSourceFile(filePath)) return;
79
-
80
- const client = new IpcClient(getPipeName(), 3000);
81
- try {
82
- await client.connect();
83
-
84
- // Check for similar existing code
85
- // eslint-disable-next-line @typescript-eslint/no-explicit-any
86
- const similarities: any = await client.request('code.similarity', {
87
- source: input.tool_input.content ?? '',
88
- language: detectLanguage(filePath),
89
- });
90
-
91
- if (similarities?.length > 0) {
92
- const best = similarities[0];
93
- if (best.score > 0.8) {
94
- process.stderr.write(`Brain: Very similar code exists (module #${best.moduleId}, ${Math.round(best.score * 100)}% match). Consider reusing.\n`);
95
- }
96
- }
97
-
98
- // Auto-register the written file into Brain
99
- const fileName = filePath.replace(/\\/g, '/').split('/').pop() ?? 'unknown';
100
- const projectName = detectProject(filePath);
101
- // eslint-disable-next-line @typescript-eslint/no-explicit-any
102
- const result: any = await client.request('code.analyze', {
103
- project: projectName,
104
- name: fileName,
105
- filePath,
106
- language: detectLanguage(filePath),
107
- source: input.tool_input.content ?? '',
108
- });
109
- process.stderr.write(`Brain: Registered ${fileName} (score: ${result.reusabilityScore?.toFixed(2) ?? '?'}, ${result.isNew ? 'new' : 'updated'})\n`);
110
- } catch {
111
- // Hook must never block workflow
112
- } finally {
113
- client.disconnect();
114
- }
115
- }
116
-
117
- main();
1
+ #!/usr/bin/env node
2
+
3
+ // PostToolUse hook for Write/Edit tool — auto-analyzes code for reusability
4
+ // Configured in .claude/settings.json:
5
+ // { "hooks": { "PostToolUse": [{ "matcher": { "tool_name": "Write" }, "command": "node <brain-dist>/hooks/post-write.js" }] } }
6
+
7
+ import { IpcClient } from '../ipc/client.js';
8
+ import { getPipeName } from '../utils/paths.js';
9
+
10
+ interface HookInput {
11
+ tool_name: string;
12
+ tool_input: { file_path?: string; content?: string };
13
+ tool_output: string;
14
+ }
15
+
16
+ const SOURCE_EXTENSIONS = new Set([
17
+ '.ts', '.tsx', '.js', '.jsx', '.py', '.rs', '.go',
18
+ '.java', '.c', '.cpp', '.h', '.hpp', '.rb', '.sh',
19
+ ]);
20
+
21
+ const IGNORE_PATHS = [
22
+ 'node_modules', 'dist', '.git', '__pycache__',
23
+ 'vendor', 'build', '.next', 'coverage',
24
+ ];
25
+
26
+ function isSourceFile(filePath: string): boolean {
27
+ const ext = filePath.slice(filePath.lastIndexOf('.'));
28
+ if (!SOURCE_EXTENSIONS.has(ext)) return false;
29
+ return !IGNORE_PATHS.some(p => filePath.includes(p));
30
+ }
31
+
32
+ function detectProject(filePath: string): string {
33
+ const normalized = filePath.replace(/\\/g, '/');
34
+ // Extract project name from path — look for common project root indicators
35
+ const parts = normalized.split('/');
36
+ // Find the directory just above src/, lib/, app/ etc., or use the parent of the file
37
+ for (let i = parts.length - 1; i >= 0; i--) {
38
+ if (['src', 'lib', 'app', 'components', 'pages', 'tests', 'test'].includes(parts[i]) && i > 0) {
39
+ return parts[i - 1];
40
+ }
41
+ }
42
+ // Fallback: use the directory two levels up from the file, or immediate parent
43
+ return parts[Math.max(parts.length - 3, 0)] || 'default';
44
+ }
45
+
46
+ function detectLanguage(filePath: string): string {
47
+ const ext = filePath.split('.').pop()?.toLowerCase() ?? '';
48
+ const map: Record<string, string> = {
49
+ ts: 'typescript', tsx: 'typescript', js: 'javascript', jsx: 'javascript',
50
+ py: 'python', rs: 'rust', go: 'go', java: 'java',
51
+ c: 'c', cpp: 'cpp', h: 'c', hpp: 'cpp',
52
+ rb: 'ruby', sh: 'shell',
53
+ };
54
+ return map[ext] ?? ext;
55
+ }
56
+
57
+ function readStdin(): Promise<string> {
58
+ return new Promise((resolve) => {
59
+ let data = '';
60
+ process.stdin.setEncoding('utf8');
61
+ process.stdin.on('data', (chunk) => { data += chunk; });
62
+ process.stdin.on('end', () => resolve(data));
63
+ });
64
+ }
65
+
66
+ async function main(): Promise<void> {
67
+ const raw = await readStdin();
68
+ if (!raw.trim()) return;
69
+
70
+ let input: HookInput;
71
+ try {
72
+ input = JSON.parse(raw);
73
+ } catch {
74
+ return;
75
+ }
76
+
77
+ const filePath = input.tool_input?.file_path;
78
+ if (!filePath || !isSourceFile(filePath)) return;
79
+
80
+ const client = new IpcClient(getPipeName(), 3000);
81
+ try {
82
+ await client.connect();
83
+
84
+ // Check for similar existing code
85
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
86
+ const similarities: any = await client.request('code.similarity', {
87
+ source: input.tool_input.content ?? '',
88
+ language: detectLanguage(filePath),
89
+ });
90
+
91
+ if (similarities?.length > 0) {
92
+ const best = similarities[0];
93
+ if (best.score > 0.8) {
94
+ process.stderr.write(`Brain: Very similar code exists (module #${best.moduleId}, ${Math.round(best.score * 100)}% match). Consider reusing.\n`);
95
+ }
96
+ }
97
+
98
+ // Auto-register the written file into Brain
99
+ const fileName = filePath.replace(/\\/g, '/').split('/').pop() ?? 'unknown';
100
+ const projectName = detectProject(filePath);
101
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
102
+ const result: any = await client.request('code.analyze', {
103
+ project: projectName,
104
+ name: fileName,
105
+ filePath,
106
+ language: detectLanguage(filePath),
107
+ source: input.tool_input.content ?? '',
108
+ });
109
+ process.stderr.write(`Brain: Registered ${fileName} (score: ${result.reusabilityScore?.toFixed(2) ?? '?'}, ${result.isNew ? 'new' : 'updated'})\n`);
110
+ } catch {
111
+ // Hook must never block workflow
112
+ } finally {
113
+ client.disconnect();
114
+ }
115
+ }
116
+
117
+ main();
package/src/index.ts CHANGED
@@ -11,6 +11,8 @@ import { networkCommand } from './cli/commands/network.js';
11
11
  import { exportCommand } from './cli/commands/export.js';
12
12
  import { importCommand } from './cli/commands/import.js';
13
13
  import { dashboardCommand } from './cli/commands/dashboard.js';
14
+ import { learnCommand } from './cli/commands/learn.js';
15
+ import { configCommand } from './cli/commands/config.js';
14
16
 
15
17
  const program = new Command();
16
18
 
@@ -29,6 +31,8 @@ program.addCommand(networkCommand());
29
31
  program.addCommand(exportCommand());
30
32
  program.addCommand(importCommand());
31
33
  program.addCommand(dashboardCommand());
34
+ program.addCommand(learnCommand());
35
+ program.addCommand(configCommand());
32
36
 
33
37
  // Hidden command: run MCP server (called by Claude Code)
34
38
  program