@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,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
+ }