@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,81 +1,81 @@
1
- import type { TerminalRepository } from '../db/repositories/terminal.repository.js';
2
- import { getEventBus } from '../utils/events.js';
3
- import { getLogger } from '../utils/logger.js';
4
-
5
- export interface RegisterTerminalInput {
6
- uuid: string;
7
- projectId?: number;
8
- pid?: number;
9
- shell?: string;
10
- cwd?: string;
11
- }
12
-
13
- export class TerminalService {
14
- private logger = getLogger();
15
- private eventBus = getEventBus();
16
-
17
- constructor(
18
- private terminalRepo: TerminalRepository,
19
- private staleTimeout: number,
20
- ) {}
21
-
22
- register(input: RegisterTerminalInput): number {
23
- const existing = this.terminalRepo.findByUuid(input.uuid);
24
- if (existing) {
25
- this.terminalRepo.update(existing.id, {
26
- last_seen: new Date().toISOString(),
27
- disconnected_at: null,
28
- project_id: input.projectId ?? existing.project_id,
29
- cwd: input.cwd ?? existing.cwd,
30
- });
31
- this.logger.info(`Terminal reconnected (id=${existing.id}, uuid=${input.uuid})`);
32
- this.eventBus.emit('terminal:connected', { terminalId: existing.id, uuid: input.uuid });
33
- return existing.id;
34
- }
35
-
36
- const id = this.terminalRepo.create({
37
- uuid: input.uuid,
38
- project_id: input.projectId ?? null,
39
- pid: input.pid ?? null,
40
- shell: input.shell ?? null,
41
- cwd: input.cwd ?? null,
42
- });
43
-
44
- this.logger.info(`Terminal registered (id=${id}, uuid=${input.uuid})`);
45
- this.eventBus.emit('terminal:connected', { terminalId: id, uuid: input.uuid });
46
- return id;
47
- }
48
-
49
- heartbeat(uuid: string): void {
50
- const terminal = this.terminalRepo.findByUuid(uuid);
51
- if (terminal) {
52
- this.terminalRepo.update(terminal.id, {
53
- last_seen: new Date().toISOString(),
54
- });
55
- }
56
- }
57
-
58
- disconnect(uuid: string): void {
59
- const terminal = this.terminalRepo.findByUuid(uuid);
60
- if (terminal) {
61
- this.terminalRepo.update(terminal.id, {
62
- disconnected_at: new Date().toISOString(),
63
- });
64
- this.eventBus.emit('terminal:disconnected', { terminalId: terminal.id });
65
- this.logger.info(`Terminal disconnected (id=${terminal.id}, uuid=${uuid})`);
66
- }
67
- }
68
-
69
- cleanup(): number {
70
- const cutoff = new Date(Date.now() - this.staleTimeout).toISOString();
71
- const count = this.terminalRepo.cleanupStale(cutoff);
72
- if (count > 0) {
73
- this.logger.info(`Cleaned up ${count} stale terminal(s)`);
74
- }
75
- return count;
76
- }
77
-
78
- getConnected() {
79
- return this.terminalRepo.findConnected();
80
- }
81
- }
1
+ import type { TerminalRepository } from '../db/repositories/terminal.repository.js';
2
+ import { getEventBus } from '../utils/events.js';
3
+ import { getLogger } from '../utils/logger.js';
4
+
5
+ export interface RegisterTerminalInput {
6
+ uuid: string;
7
+ projectId?: number;
8
+ pid?: number;
9
+ shell?: string;
10
+ cwd?: string;
11
+ }
12
+
13
+ export class TerminalService {
14
+ private logger = getLogger();
15
+ private eventBus = getEventBus();
16
+
17
+ constructor(
18
+ private terminalRepo: TerminalRepository,
19
+ private staleTimeout: number,
20
+ ) {}
21
+
22
+ register(input: RegisterTerminalInput): number {
23
+ const existing = this.terminalRepo.findByUuid(input.uuid);
24
+ if (existing) {
25
+ this.terminalRepo.update(existing.id, {
26
+ last_seen: new Date().toISOString(),
27
+ disconnected_at: null,
28
+ project_id: input.projectId ?? existing.project_id,
29
+ cwd: input.cwd ?? existing.cwd,
30
+ });
31
+ this.logger.info(`Terminal reconnected (id=${existing.id}, uuid=${input.uuid})`);
32
+ this.eventBus.emit('terminal:connected', { terminalId: existing.id, uuid: input.uuid });
33
+ return existing.id;
34
+ }
35
+
36
+ const id = this.terminalRepo.create({
37
+ uuid: input.uuid,
38
+ project_id: input.projectId ?? null,
39
+ pid: input.pid ?? null,
40
+ shell: input.shell ?? null,
41
+ cwd: input.cwd ?? null,
42
+ });
43
+
44
+ this.logger.info(`Terminal registered (id=${id}, uuid=${input.uuid})`);
45
+ this.eventBus.emit('terminal:connected', { terminalId: id, uuid: input.uuid });
46
+ return id;
47
+ }
48
+
49
+ heartbeat(uuid: string): void {
50
+ const terminal = this.terminalRepo.findByUuid(uuid);
51
+ if (terminal) {
52
+ this.terminalRepo.update(terminal.id, {
53
+ last_seen: new Date().toISOString(),
54
+ });
55
+ }
56
+ }
57
+
58
+ disconnect(uuid: string): void {
59
+ const terminal = this.terminalRepo.findByUuid(uuid);
60
+ if (terminal) {
61
+ this.terminalRepo.update(terminal.id, {
62
+ disconnected_at: new Date().toISOString(),
63
+ });
64
+ this.eventBus.emit('terminal:disconnected', { terminalId: terminal.id });
65
+ this.logger.info(`Terminal disconnected (id=${terminal.id}, uuid=${uuid})`);
66
+ }
67
+ }
68
+
69
+ cleanup(): number {
70
+ const cutoff = new Date(Date.now() - this.staleTimeout).toISOString();
71
+ const count = this.terminalRepo.cleanupStale(cutoff);
72
+ if (count > 0) {
73
+ this.logger.info(`Cleaned up ${count} stale terminal(s)`);
74
+ }
75
+ return count;
76
+ }
77
+
78
+ getConnected() {
79
+ return this.terminalRepo.findConnected();
80
+ }
81
+ }
@@ -1,80 +1,80 @@
1
- import type { NodeType } from '../types/synapse.types.js';
2
- import type { SynapseRepository } from '../db/repositories/synapse.repository.js';
3
-
4
- export interface ActivationNode {
5
- type: NodeType;
6
- id: number;
7
- }
8
-
9
- export interface ActivationResult {
10
- node: ActivationNode;
11
- activation: number;
12
- depth: number;
13
- path: string[];
14
- }
15
-
16
- export function spreadingActivation(
17
- repo: SynapseRepository,
18
- startNode: ActivationNode,
19
- maxDepth: number = 3,
20
- minWeight: number = 0.2,
21
- ): ActivationResult[] {
22
- const visited = new Set<string>();
23
- const results: ActivationResult[] = [];
24
-
25
- const queue: Array<{
26
- node: ActivationNode;
27
- depth: number;
28
- pathWeight: number;
29
- path: string[];
30
- }> = [{ node: startNode, depth: 0, pathWeight: 1.0, path: [] }];
31
-
32
- while (queue.length > 0) {
33
- const current = queue.shift()!;
34
- const key = `${current.node.type}:${current.node.id}`;
35
-
36
- if (visited.has(key)) continue;
37
- if (current.depth > maxDepth) continue;
38
- if (current.pathWeight < minWeight) continue;
39
-
40
- visited.add(key);
41
-
42
- if (current.depth > 0) {
43
- results.push({
44
- node: current.node,
45
- activation: current.pathWeight,
46
- depth: current.depth,
47
- path: current.path,
48
- });
49
- }
50
-
51
- const outgoing = repo.getOutgoing(current.node.type, current.node.id);
52
- const incoming = repo.getIncoming(current.node.type, current.node.id);
53
-
54
- for (const synapse of outgoing) {
55
- const nextWeight = current.pathWeight * synapse.weight;
56
- if (nextWeight >= minWeight) {
57
- queue.push({
58
- node: { type: synapse.target_type, id: synapse.target_id },
59
- depth: current.depth + 1,
60
- pathWeight: nextWeight,
61
- path: [...current.path, `--${synapse.synapse_type}-->`],
62
- });
63
- }
64
- }
65
-
66
- for (const synapse of incoming) {
67
- const nextWeight = current.pathWeight * synapse.weight;
68
- if (nextWeight >= minWeight) {
69
- queue.push({
70
- node: { type: synapse.source_type, id: synapse.source_id },
71
- depth: current.depth + 1,
72
- pathWeight: nextWeight,
73
- path: [...current.path, `<--${synapse.synapse_type}--`],
74
- });
75
- }
76
- }
77
- }
78
-
79
- return results.sort((a, b) => b.activation - a.activation);
80
- }
1
+ import type { NodeType } from '../types/synapse.types.js';
2
+ import type { SynapseRepository } from '../db/repositories/synapse.repository.js';
3
+
4
+ export interface ActivationNode {
5
+ type: NodeType;
6
+ id: number;
7
+ }
8
+
9
+ export interface ActivationResult {
10
+ node: ActivationNode;
11
+ activation: number;
12
+ depth: number;
13
+ path: string[];
14
+ }
15
+
16
+ export function spreadingActivation(
17
+ repo: SynapseRepository,
18
+ startNode: ActivationNode,
19
+ maxDepth: number = 3,
20
+ minWeight: number = 0.2,
21
+ ): ActivationResult[] {
22
+ const visited = new Set<string>();
23
+ const results: ActivationResult[] = [];
24
+
25
+ const queue: Array<{
26
+ node: ActivationNode;
27
+ depth: number;
28
+ pathWeight: number;
29
+ path: string[];
30
+ }> = [{ node: startNode, depth: 0, pathWeight: 1.0, path: [] }];
31
+
32
+ while (queue.length > 0) {
33
+ const current = queue.shift()!;
34
+ const key = `${current.node.type}:${current.node.id}`;
35
+
36
+ if (visited.has(key)) continue;
37
+ if (current.depth > maxDepth) continue;
38
+ if (current.pathWeight < minWeight) continue;
39
+
40
+ visited.add(key);
41
+
42
+ if (current.depth > 0) {
43
+ results.push({
44
+ node: current.node,
45
+ activation: current.pathWeight,
46
+ depth: current.depth,
47
+ path: current.path,
48
+ });
49
+ }
50
+
51
+ const outgoing = repo.getOutgoing(current.node.type, current.node.id);
52
+ const incoming = repo.getIncoming(current.node.type, current.node.id);
53
+
54
+ for (const synapse of outgoing) {
55
+ const nextWeight = current.pathWeight * synapse.weight;
56
+ if (nextWeight >= minWeight) {
57
+ queue.push({
58
+ node: { type: synapse.target_type, id: synapse.target_id },
59
+ depth: current.depth + 1,
60
+ pathWeight: nextWeight,
61
+ path: [...current.path, `--${synapse.synapse_type}-->`],
62
+ });
63
+ }
64
+ }
65
+
66
+ for (const synapse of incoming) {
67
+ const nextWeight = current.pathWeight * synapse.weight;
68
+ if (nextWeight >= minWeight) {
69
+ queue.push({
70
+ node: { type: synapse.source_type, id: synapse.source_id },
71
+ depth: current.depth + 1,
72
+ pathWeight: nextWeight,
73
+ path: [...current.path, `<--${synapse.synapse_type}--`],
74
+ });
75
+ }
76
+ }
77
+ }
78
+
79
+ return results.sort((a, b) => b.activation - a.activation);
80
+ }
@@ -1,38 +1,38 @@
1
- import type { SynapseRepository } from '../db/repositories/synapse.repository.js';
2
-
3
- export interface DecayConfig {
4
- decayHalfLifeDays: number;
5
- decayAfterDays: number;
6
- pruneThreshold: number;
7
- }
8
-
9
- export function timeDecayFactor(lastActivatedAt: string, halfLifeDays: number): number {
10
- const now = Date.now();
11
- const activated = new Date(lastActivatedAt).getTime();
12
- const ageDays = (now - activated) / (1000 * 60 * 60 * 24);
13
- return Math.pow(0.5, ageDays / halfLifeDays);
14
- }
15
-
16
- export function decayAll(repo: SynapseRepository, config: DecayConfig): { decayed: number; pruned: number } {
17
- const cutoff = new Date();
18
- cutoff.setDate(cutoff.getDate() - config.decayAfterDays);
19
-
20
- const stale = repo.findInactiveSince(cutoff.toISOString());
21
- let pruned = 0;
22
- let decayed = 0;
23
-
24
- for (const synapse of stale) {
25
- const factor = timeDecayFactor(synapse.last_activated_at, config.decayHalfLifeDays);
26
- const newWeight = synapse.weight * factor;
27
-
28
- if (newWeight < config.pruneThreshold) {
29
- repo.delete(synapse.id);
30
- pruned++;
31
- } else {
32
- repo.update(synapse.id, { weight: newWeight });
33
- decayed++;
34
- }
35
- }
36
-
37
- return { decayed, pruned };
38
- }
1
+ import type { SynapseRepository } from '../db/repositories/synapse.repository.js';
2
+
3
+ export interface DecayConfig {
4
+ decayHalfLifeDays: number;
5
+ decayAfterDays: number;
6
+ pruneThreshold: number;
7
+ }
8
+
9
+ export function timeDecayFactor(lastActivatedAt: string, halfLifeDays: number): number {
10
+ const now = Date.now();
11
+ const activated = new Date(lastActivatedAt).getTime();
12
+ const ageDays = (now - activated) / (1000 * 60 * 60 * 24);
13
+ return Math.pow(0.5, ageDays / halfLifeDays);
14
+ }
15
+
16
+ export function decayAll(repo: SynapseRepository, config: DecayConfig): { decayed: number; pruned: number } {
17
+ const cutoff = new Date();
18
+ cutoff.setDate(cutoff.getDate() - config.decayAfterDays);
19
+
20
+ const stale = repo.findInactiveSince(cutoff.toISOString());
21
+ let pruned = 0;
22
+ let decayed = 0;
23
+
24
+ for (const synapse of stale) {
25
+ const factor = timeDecayFactor(synapse.last_activated_at, config.decayHalfLifeDays);
26
+ const newWeight = synapse.weight * factor;
27
+
28
+ if (newWeight < config.pruneThreshold) {
29
+ repo.delete(synapse.id);
30
+ pruned++;
31
+ } else {
32
+ repo.update(synapse.id, { weight: newWeight });
33
+ decayed++;
34
+ }
35
+ }
36
+
37
+ return { decayed, pruned };
38
+ }
@@ -1,69 +1,69 @@
1
- import type { SynapseRecord, NodeType, SynapseType } from '../types/synapse.types.js';
2
- import type { SynapseRepository } from '../db/repositories/synapse.repository.js';
3
-
4
- export interface HebbianConfig {
5
- initialWeight: number;
6
- learningRate: number;
7
- pruneThreshold: number;
8
- }
9
-
10
- export interface NodeRef {
11
- type: NodeType;
12
- id: number;
13
- }
14
-
15
- export function strengthen(
16
- repo: SynapseRepository,
17
- source: NodeRef,
18
- target: NodeRef,
19
- synapseType: SynapseType,
20
- config: HebbianConfig,
21
- context?: Record<string, unknown>,
22
- ): SynapseRecord {
23
- const existing = repo.findBySourceTarget(
24
- source.type, source.id, target.type, target.id, synapseType,
25
- );
26
-
27
- if (existing) {
28
- // Hebbian: weight grows logarithmically, saturates at 1.0
29
- const newWeight = Math.min(
30
- 1.0,
31
- existing.weight + (1.0 - existing.weight) * config.learningRate,
32
- );
33
- repo.update(existing.id, {
34
- weight: newWeight,
35
- activation_count: existing.activation_count + 1,
36
- last_activated_at: new Date().toISOString(),
37
- });
38
- return { ...existing, weight: newWeight, activation_count: existing.activation_count + 1 };
39
- }
40
-
41
- const id = repo.create({
42
- source_type: source.type,
43
- source_id: source.id,
44
- target_type: target.type,
45
- target_id: target.id,
46
- synapse_type: synapseType,
47
- weight: config.initialWeight,
48
- metadata: context ? JSON.stringify(context) : null,
49
- });
50
-
51
- return repo.getById(id)!;
52
- }
53
-
54
- export function weaken(
55
- repo: SynapseRepository,
56
- synapseId: number,
57
- config: HebbianConfig,
58
- factor: number = 0.5,
59
- ): void {
60
- const synapse = repo.getById(synapseId);
61
- if (!synapse) return;
62
-
63
- const newWeight = synapse.weight * factor;
64
- if (newWeight < config.pruneThreshold) {
65
- repo.delete(synapseId);
66
- } else {
67
- repo.update(synapseId, { weight: newWeight });
68
- }
69
- }
1
+ import type { SynapseRecord, NodeType, SynapseType } from '../types/synapse.types.js';
2
+ import type { SynapseRepository } from '../db/repositories/synapse.repository.js';
3
+
4
+ export interface HebbianConfig {
5
+ initialWeight: number;
6
+ learningRate: number;
7
+ pruneThreshold: number;
8
+ }
9
+
10
+ export interface NodeRef {
11
+ type: NodeType;
12
+ id: number;
13
+ }
14
+
15
+ export function strengthen(
16
+ repo: SynapseRepository,
17
+ source: NodeRef,
18
+ target: NodeRef,
19
+ synapseType: SynapseType,
20
+ config: HebbianConfig,
21
+ context?: Record<string, unknown>,
22
+ ): SynapseRecord {
23
+ const existing = repo.findBySourceTarget(
24
+ source.type, source.id, target.type, target.id, synapseType,
25
+ );
26
+
27
+ if (existing) {
28
+ // Hebbian: weight grows logarithmically, saturates at 1.0
29
+ const newWeight = Math.min(
30
+ 1.0,
31
+ existing.weight + (1.0 - existing.weight) * config.learningRate,
32
+ );
33
+ repo.update(existing.id, {
34
+ weight: newWeight,
35
+ activation_count: existing.activation_count + 1,
36
+ last_activated_at: new Date().toISOString(),
37
+ });
38
+ return { ...existing, weight: newWeight, activation_count: existing.activation_count + 1 };
39
+ }
40
+
41
+ const id = repo.create({
42
+ source_type: source.type,
43
+ source_id: source.id,
44
+ target_type: target.type,
45
+ target_id: target.id,
46
+ synapse_type: synapseType,
47
+ weight: config.initialWeight,
48
+ metadata: context ? JSON.stringify(context) : null,
49
+ });
50
+
51
+ return repo.getById(id)!;
52
+ }
53
+
54
+ export function weaken(
55
+ repo: SynapseRepository,
56
+ synapseId: number,
57
+ config: HebbianConfig,
58
+ factor: number = 0.5,
59
+ ): void {
60
+ const synapse = repo.getById(synapseId);
61
+ if (!synapse) return;
62
+
63
+ const newWeight = synapse.weight * factor;
64
+ if (newWeight < config.pruneThreshold) {
65
+ repo.delete(synapseId);
66
+ } else {
67
+ repo.update(synapseId, { weight: newWeight });
68
+ }
69
+ }