memory-journal-mcp 4.4.2 → 5.0.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 (291) hide show
  1. package/.github/workflows/codeql.yml +1 -6
  2. package/.github/workflows/docker-publish.yml +15 -49
  3. package/.github/workflows/lint-and-test.yml +1 -1
  4. package/.github/workflows/secrets-scanning.yml +4 -3
  5. package/.github/workflows/security-update.yml +3 -3
  6. package/CHANGELOG.md +213 -0
  7. package/CONTRIBUTING.md +132 -97
  8. package/DOCKER_README.md +184 -235
  9. package/Dockerfile +27 -24
  10. package/README.md +218 -190
  11. package/SECURITY.md +27 -35
  12. package/dist/cli.js +16 -1
  13. package/dist/cli.js.map +1 -1
  14. package/dist/constants/ServerInstructions.d.ts +5 -1
  15. package/dist/constants/ServerInstructions.d.ts.map +1 -1
  16. package/dist/constants/ServerInstructions.js +133 -73
  17. package/dist/constants/ServerInstructions.js.map +1 -1
  18. package/dist/constants/icons.d.ts +2 -2
  19. package/dist/constants/icons.d.ts.map +1 -1
  20. package/dist/constants/icons.js +7 -6
  21. package/dist/constants/icons.js.map +1 -1
  22. package/dist/database/SqliteAdapter.d.ts +37 -24
  23. package/dist/database/SqliteAdapter.d.ts.map +1 -1
  24. package/dist/database/SqliteAdapter.js +319 -157
  25. package/dist/database/SqliteAdapter.js.map +1 -1
  26. package/dist/database/schema.d.ts +45 -0
  27. package/dist/database/schema.d.ts.map +1 -0
  28. package/dist/database/schema.js +92 -0
  29. package/dist/database/schema.js.map +1 -0
  30. package/dist/filtering/ToolFilter.d.ts +1 -1
  31. package/dist/filtering/ToolFilter.d.ts.map +1 -1
  32. package/dist/filtering/ToolFilter.js +13 -2
  33. package/dist/filtering/ToolFilter.js.map +1 -1
  34. package/dist/github/GitHubIntegration.d.ts.map +1 -1
  35. package/dist/github/GitHubIntegration.js +1 -3
  36. package/dist/github/GitHubIntegration.js.map +1 -1
  37. package/dist/handlers/prompts/github.d.ts +12 -0
  38. package/dist/handlers/prompts/github.d.ts.map +1 -0
  39. package/dist/handlers/prompts/github.js +178 -0
  40. package/dist/handlers/prompts/github.js.map +1 -0
  41. package/dist/handlers/prompts/index.d.ts +23 -2
  42. package/dist/handlers/prompts/index.d.ts.map +1 -1
  43. package/dist/handlers/prompts/index.js +7 -432
  44. package/dist/handlers/prompts/index.js.map +1 -1
  45. package/dist/handlers/prompts/workflow.d.ts +12 -0
  46. package/dist/handlers/prompts/workflow.d.ts.map +1 -0
  47. package/dist/handlers/prompts/workflow.js +277 -0
  48. package/dist/handlers/prompts/workflow.js.map +1 -0
  49. package/dist/handlers/resources/core.d.ts +11 -0
  50. package/dist/handlers/resources/core.d.ts.map +1 -0
  51. package/dist/handlers/resources/core.js +433 -0
  52. package/dist/handlers/resources/core.js.map +1 -0
  53. package/dist/handlers/resources/github.d.ts +11 -0
  54. package/dist/handlers/resources/github.d.ts.map +1 -0
  55. package/dist/handlers/resources/github.js +314 -0
  56. package/dist/handlers/resources/github.js.map +1 -0
  57. package/dist/handlers/resources/graph.d.ts +11 -0
  58. package/dist/handlers/resources/graph.d.ts.map +1 -0
  59. package/dist/handlers/resources/graph.js +204 -0
  60. package/dist/handlers/resources/graph.js.map +1 -0
  61. package/dist/handlers/resources/index.d.ts +5 -20
  62. package/dist/handlers/resources/index.d.ts.map +1 -1
  63. package/dist/handlers/resources/index.js +16 -1278
  64. package/dist/handlers/resources/index.js.map +1 -1
  65. package/dist/handlers/resources/shared.d.ts +60 -0
  66. package/dist/handlers/resources/shared.d.ts.map +1 -0
  67. package/dist/handlers/resources/shared.js +49 -0
  68. package/dist/handlers/resources/shared.js.map +1 -0
  69. package/dist/handlers/resources/team.d.ts +13 -0
  70. package/dist/handlers/resources/team.d.ts.map +1 -0
  71. package/dist/handlers/resources/team.js +119 -0
  72. package/dist/handlers/resources/team.js.map +1 -0
  73. package/dist/handlers/resources/templates.d.ts +13 -0
  74. package/dist/handlers/resources/templates.d.ts.map +1 -0
  75. package/dist/handlers/resources/templates.js +310 -0
  76. package/dist/handlers/resources/templates.js.map +1 -0
  77. package/dist/handlers/tools/admin.d.ts +8 -0
  78. package/dist/handlers/tools/admin.d.ts.map +1 -0
  79. package/dist/handlers/tools/admin.js +270 -0
  80. package/dist/handlers/tools/admin.js.map +1 -0
  81. package/dist/handlers/tools/analytics.d.ts +8 -0
  82. package/dist/handlers/tools/analytics.d.ts.map +1 -0
  83. package/dist/handlers/tools/analytics.js +256 -0
  84. package/dist/handlers/tools/analytics.js.map +1 -0
  85. package/dist/handlers/tools/backup.d.ts +8 -0
  86. package/dist/handlers/tools/backup.d.ts.map +1 -0
  87. package/dist/handlers/tools/backup.js +224 -0
  88. package/dist/handlers/tools/backup.js.map +1 -0
  89. package/dist/handlers/tools/core.d.ts +9 -0
  90. package/dist/handlers/tools/core.d.ts.map +1 -0
  91. package/dist/handlers/tools/core.js +326 -0
  92. package/dist/handlers/tools/core.js.map +1 -0
  93. package/dist/handlers/tools/export.d.ts +8 -0
  94. package/dist/handlers/tools/export.d.ts.map +1 -0
  95. package/dist/handlers/tools/export.js +89 -0
  96. package/dist/handlers/tools/export.js.map +1 -0
  97. package/dist/handlers/tools/github/helpers.d.ts +34 -0
  98. package/dist/handlers/tools/github/helpers.d.ts.map +1 -0
  99. package/dist/handlers/tools/github/helpers.js +52 -0
  100. package/dist/handlers/tools/github/helpers.js.map +1 -0
  101. package/dist/handlers/tools/github/insights-tools.d.ts +8 -0
  102. package/dist/handlers/tools/github/insights-tools.d.ts.map +1 -0
  103. package/dist/handlers/tools/github/insights-tools.js +104 -0
  104. package/dist/handlers/tools/github/insights-tools.js.map +1 -0
  105. package/dist/handlers/tools/github/issue-tools.d.ts +8 -0
  106. package/dist/handlers/tools/github/issue-tools.d.ts.map +1 -0
  107. package/dist/handlers/tools/github/issue-tools.js +359 -0
  108. package/dist/handlers/tools/github/issue-tools.js.map +1 -0
  109. package/dist/handlers/tools/github/kanban-tools.d.ts +8 -0
  110. package/dist/handlers/tools/github/kanban-tools.d.ts.map +1 -0
  111. package/dist/handlers/tools/github/kanban-tools.js +108 -0
  112. package/dist/handlers/tools/github/kanban-tools.js.map +1 -0
  113. package/dist/handlers/tools/github/milestone-tools.d.ts +9 -0
  114. package/dist/handlers/tools/github/milestone-tools.d.ts.map +1 -0
  115. package/dist/handlers/tools/github/milestone-tools.js +302 -0
  116. package/dist/handlers/tools/github/milestone-tools.js.map +1 -0
  117. package/dist/handlers/tools/github/mutation-tools.d.ts +12 -0
  118. package/dist/handlers/tools/github/mutation-tools.d.ts.map +1 -0
  119. package/dist/handlers/tools/github/mutation-tools.js +15 -0
  120. package/dist/handlers/tools/github/mutation-tools.js.map +1 -0
  121. package/dist/handlers/tools/github/read-tools.d.ts +8 -0
  122. package/dist/handlers/tools/github/read-tools.d.ts.map +1 -0
  123. package/dist/handlers/tools/github/read-tools.js +260 -0
  124. package/dist/handlers/tools/github/read-tools.js.map +1 -0
  125. package/dist/handlers/tools/github/schemas.d.ts +467 -0
  126. package/dist/handlers/tools/github/schemas.d.ts.map +1 -0
  127. package/dist/handlers/tools/github/schemas.js +335 -0
  128. package/dist/handlers/tools/github/schemas.js.map +1 -0
  129. package/dist/handlers/tools/github.d.ts +14 -0
  130. package/dist/handlers/tools/github.d.ts.map +1 -0
  131. package/dist/handlers/tools/github.js +28 -0
  132. package/dist/handlers/tools/github.js.map +1 -0
  133. package/dist/handlers/tools/index.d.ts +15 -20
  134. package/dist/handlers/tools/index.d.ts.map +1 -1
  135. package/dist/handlers/tools/index.js +117 -2909
  136. package/dist/handlers/tools/index.js.map +1 -1
  137. package/dist/handlers/tools/relationships.d.ts +8 -0
  138. package/dist/handlers/tools/relationships.d.ts.map +1 -0
  139. package/dist/handlers/tools/relationships.js +308 -0
  140. package/dist/handlers/tools/relationships.js.map +1 -0
  141. package/dist/handlers/tools/schemas.d.ts +108 -0
  142. package/dist/handlers/tools/schemas.d.ts.map +1 -0
  143. package/dist/handlers/tools/schemas.js +122 -0
  144. package/dist/handlers/tools/schemas.js.map +1 -0
  145. package/dist/handlers/tools/search.d.ts +8 -0
  146. package/dist/handlers/tools/search.d.ts.map +1 -0
  147. package/dist/handlers/tools/search.js +282 -0
  148. package/dist/handlers/tools/search.js.map +1 -0
  149. package/dist/handlers/tools/team.d.ts +11 -0
  150. package/dist/handlers/tools/team.d.ts.map +1 -0
  151. package/dist/handlers/tools/team.js +239 -0
  152. package/dist/handlers/tools/team.js.map +1 -0
  153. package/dist/server/McpServer.d.ts +4 -0
  154. package/dist/server/McpServer.d.ts.map +1 -1
  155. package/dist/server/McpServer.js +48 -297
  156. package/dist/server/McpServer.js.map +1 -1
  157. package/dist/server/Scheduler.d.ts +91 -0
  158. package/dist/server/Scheduler.d.ts.map +1 -0
  159. package/dist/server/Scheduler.js +201 -0
  160. package/dist/server/Scheduler.js.map +1 -0
  161. package/dist/transports/http.d.ts +66 -0
  162. package/dist/transports/http.d.ts.map +1 -0
  163. package/dist/transports/http.js +519 -0
  164. package/dist/transports/http.js.map +1 -0
  165. package/dist/types/entities.d.ts +101 -0
  166. package/dist/types/entities.d.ts.map +1 -0
  167. package/dist/types/entities.js +5 -0
  168. package/dist/types/entities.js.map +1 -0
  169. package/dist/types/filtering.d.ts +34 -0
  170. package/dist/types/filtering.d.ts.map +1 -0
  171. package/dist/types/filtering.js +5 -0
  172. package/dist/types/filtering.js.map +1 -0
  173. package/dist/types/github.d.ts +166 -0
  174. package/dist/types/github.d.ts.map +1 -0
  175. package/dist/types/github.js +5 -0
  176. package/dist/types/github.js.map +1 -0
  177. package/dist/types/index.d.ts +35 -292
  178. package/dist/types/index.d.ts.map +1 -1
  179. package/dist/types/index.js +2 -2
  180. package/dist/types/index.js.map +1 -1
  181. package/dist/utils/error-helpers.d.ts +37 -0
  182. package/dist/utils/error-helpers.d.ts.map +1 -0
  183. package/dist/utils/error-helpers.js +47 -0
  184. package/dist/utils/error-helpers.js.map +1 -0
  185. package/dist/utils/logger.d.ts.map +1 -1
  186. package/dist/utils/logger.js +6 -3
  187. package/dist/utils/logger.js.map +1 -1
  188. package/dist/utils/security-utils.d.ts +0 -21
  189. package/dist/utils/security-utils.d.ts.map +1 -1
  190. package/dist/utils/security-utils.js +0 -47
  191. package/dist/utils/security-utils.js.map +1 -1
  192. package/dist/vector/VectorSearchManager.d.ts.map +1 -1
  193. package/dist/vector/VectorSearchManager.js +9 -32
  194. package/dist/vector/VectorSearchManager.js.map +1 -1
  195. package/docker-compose.yml +11 -2
  196. package/hooks/README.md +107 -0
  197. package/hooks/cursor/hooks.json +10 -0
  198. package/hooks/cursor/memory-journal.mdc +22 -0
  199. package/hooks/cursor/session-end.sh +19 -0
  200. package/hooks/kilo-code/session-end-mode.json +11 -0
  201. package/hooks/kiro/session-end.md +13 -0
  202. package/mcp-config-example.json +1 -0
  203. package/package.json +11 -9
  204. package/playwright.config.ts +29 -0
  205. package/releases/v4.5.0.md +116 -0
  206. package/releases/v5.0.0.md +105 -0
  207. package/scripts/generate-server-instructions.ts +176 -0
  208. package/scripts/server-instructions-function-body.ts +77 -0
  209. package/server.json +3 -3
  210. package/src/cli.ts +45 -1
  211. package/src/constants/ServerInstructions.ts +133 -73
  212. package/src/constants/icons.ts +8 -7
  213. package/src/constants/server-instructions.md +268 -0
  214. package/src/database/SqliteAdapter.ts +358 -192
  215. package/src/database/schema.ts +125 -0
  216. package/src/filtering/ToolFilter.ts +13 -2
  217. package/src/github/GitHubIntegration.ts +1 -3
  218. package/src/handlers/prompts/github.ts +209 -0
  219. package/src/handlers/prompts/index.ts +10 -499
  220. package/src/handlers/prompts/workflow.ts +314 -0
  221. package/src/handlers/resources/core.ts +528 -0
  222. package/src/handlers/resources/github.ts +358 -0
  223. package/src/handlers/resources/graph.ts +254 -0
  224. package/src/handlers/resources/index.ts +23 -1570
  225. package/src/handlers/resources/shared.ts +103 -0
  226. package/src/handlers/resources/team.ts +133 -0
  227. package/src/handlers/resources/templates.ts +374 -0
  228. package/src/handlers/tools/admin.ts +285 -0
  229. package/src/handlers/tools/analytics.ts +301 -0
  230. package/src/handlers/tools/backup.ts +242 -0
  231. package/src/handlers/tools/core.ts +350 -0
  232. package/src/handlers/tools/export.ts +115 -0
  233. package/src/handlers/tools/github/helpers.ts +86 -0
  234. package/src/handlers/tools/github/insights-tools.ts +119 -0
  235. package/src/handlers/tools/github/issue-tools.ts +439 -0
  236. package/src/handlers/tools/github/kanban-tools.ts +134 -0
  237. package/src/handlers/tools/github/milestone-tools.ts +392 -0
  238. package/src/handlers/tools/github/mutation-tools.ts +17 -0
  239. package/src/handlers/tools/github/read-tools.ts +328 -0
  240. package/src/handlers/tools/github/schemas.ts +369 -0
  241. package/src/handlers/tools/github.ts +36 -0
  242. package/src/handlers/tools/index.ts +144 -3325
  243. package/src/handlers/tools/relationships.ts +358 -0
  244. package/src/handlers/tools/schemas.ts +132 -0
  245. package/src/handlers/tools/search.ts +343 -0
  246. package/src/handlers/tools/team.ts +273 -0
  247. package/src/server/McpServer.ts +63 -358
  248. package/src/server/Scheduler.ts +278 -0
  249. package/src/transports/http.ts +635 -0
  250. package/src/types/entities.ts +145 -0
  251. package/src/types/filtering.ts +54 -0
  252. package/src/types/github.ts +180 -0
  253. package/src/types/index.ts +67 -375
  254. package/src/utils/error-helpers.ts +52 -0
  255. package/src/utils/logger.ts +6 -3
  256. package/src/utils/security-utils.ts +0 -52
  257. package/src/vector/VectorSearchManager.ts +9 -33
  258. package/tests/constants/icons.test.ts +1 -2
  259. package/tests/constants/server-instructions.test.ts +30 -4
  260. package/tests/database/sqlite-adapter.test.ts +91 -7
  261. package/tests/e2e/auth.spec.ts +154 -0
  262. package/tests/e2e/health.spec.ts +63 -0
  263. package/tests/e2e/protocols.spec.ts +134 -0
  264. package/tests/e2e/resources.spec.ts +103 -0
  265. package/tests/e2e/scheduler.spec.ts +79 -0
  266. package/tests/e2e/security.spec.ts +91 -0
  267. package/tests/e2e/sessions.spec.ts +95 -0
  268. package/tests/e2e/stateless.spec.ts +121 -0
  269. package/tests/e2e/tools.spec.ts +111 -0
  270. package/tests/filtering/tool-filter.test.ts +46 -0
  271. package/tests/handlers/error-path-coverage.test.ts +324 -0
  272. package/tests/handlers/github-resource-handlers.test.ts +453 -0
  273. package/tests/handlers/github-tool-handlers.test.ts +899 -0
  274. package/tests/handlers/prompt-handler-coverage.test.ts +106 -0
  275. package/tests/handlers/prompt-handlers.test.ts +40 -0
  276. package/tests/handlers/resource-handler-coverage.test.ts +181 -0
  277. package/tests/handlers/resource-handlers.test.ts +33 -9
  278. package/tests/handlers/search-tool-handlers.test.ts +272 -0
  279. package/tests/handlers/targeted-gap-closure.test.ts +387 -0
  280. package/tests/handlers/team-resource-handlers.test.ts +156 -0
  281. package/tests/handlers/team-tool-handlers.test.ts +301 -0
  282. package/tests/handlers/tool-handler-coverage.test.ts +469 -0
  283. package/tests/handlers/tool-handlers.test.ts +2 -2
  284. package/tests/security/sql-injection.test.ts +3 -54
  285. package/tests/server/mcp-server.test.ts +503 -8
  286. package/tests/server/scheduler.test.ts +400 -0
  287. package/tests/transports/http-transport.test.ts +620 -0
  288. package/tests/vector/vector-search-manager.test.ts +60 -0
  289. package/vitest.config.ts +4 -1
  290. package/.memory-journal-team.db +0 -0
  291. package/.vscode/settings.json +0 -84
@@ -0,0 +1,256 @@
1
+ /**
2
+ * Analytics Tool Group - 2 tools
3
+ *
4
+ * Tools: get_statistics, get_cross_project_insights
5
+ */
6
+ import { z } from 'zod';
7
+ import { formatHandlerError } from '../../utils/error-helpers.js';
8
+ import { DATE_FORMAT_REGEX, DATE_FORMAT_MESSAGE, TagOutputSchema } from './schemas.js';
9
+ // ============================================================================
10
+ // Output Schemas
11
+ // ============================================================================
12
+ const StatisticsOutputSchema = z.object({
13
+ groupBy: z.string().optional(),
14
+ totalEntries: z.number().optional(),
15
+ entriesByType: z.record(z.string(), z.number()).optional(),
16
+ entriesByPeriod: z
17
+ .array(z.object({
18
+ period: z.string(),
19
+ count: z.number(),
20
+ }))
21
+ .optional(),
22
+ decisionDensity: z
23
+ .array(z.object({
24
+ period: z.string(),
25
+ significantCount: z.number(),
26
+ }))
27
+ .optional(),
28
+ relationshipComplexity: z
29
+ .object({
30
+ totalRelationships: z.number(),
31
+ avgPerEntry: z.number(),
32
+ })
33
+ .optional(),
34
+ activityTrend: z
35
+ .object({
36
+ currentPeriod: z.string(),
37
+ previousPeriod: z.string(),
38
+ growthPercent: z.number().nullable(),
39
+ })
40
+ .optional(),
41
+ causalMetrics: z
42
+ .object({
43
+ blocked_by: z.number(),
44
+ resolved: z.number(),
45
+ caused: z.number(),
46
+ })
47
+ .optional(),
48
+ success: z.boolean().optional(),
49
+ error: z.string().optional(),
50
+ });
51
+ const ProjectSummaryOutputSchema = z.object({
52
+ project_number: z.number(),
53
+ entry_count: z.number(),
54
+ first_entry: z.string(),
55
+ last_entry: z.string(),
56
+ active_days: z.number(),
57
+ top_tags: z.array(TagOutputSchema),
58
+ });
59
+ const CrossProjectInsightsOutputSchema = z.object({
60
+ project_count: z.number().optional(),
61
+ total_entries: z.number().optional(),
62
+ projects: z.array(ProjectSummaryOutputSchema).optional(),
63
+ inactive_projects: z
64
+ .array(z.object({
65
+ project_number: z.number(),
66
+ last_entry_date: z.string(),
67
+ }))
68
+ .optional(),
69
+ inactiveThresholdDays: z.number().optional(),
70
+ time_distribution: z
71
+ .array(z.object({
72
+ project_number: z.number(),
73
+ percentage: z.string(),
74
+ }))
75
+ .optional(),
76
+ message: z.string().optional(),
77
+ success: z.boolean().optional(),
78
+ error: z.string().optional(),
79
+ });
80
+ // ============================================================================
81
+ // Input Schemas
82
+ // ============================================================================
83
+ /** Strict schema — used inside handler for structured Zod errors */
84
+ const GetStatisticsSchema = z.object({
85
+ group_by: z.enum(['day', 'week', 'month']).optional().default('week'),
86
+ start_date: z.string().regex(DATE_FORMAT_REGEX, DATE_FORMAT_MESSAGE).optional(),
87
+ end_date: z.string().regex(DATE_FORMAT_REGEX, DATE_FORMAT_MESSAGE).optional(),
88
+ project_breakdown: z.boolean().optional().default(false),
89
+ });
90
+ /** Relaxed schema — passed to SDK inputSchema so Zod errors reach the handler */
91
+ const GetStatisticsSchemaMcp = z.object({
92
+ group_by: z.string().optional().default('week'),
93
+ start_date: z.string().optional(),
94
+ end_date: z.string().optional(),
95
+ project_breakdown: z.boolean().optional().default(false),
96
+ });
97
+ /** Strict schema — used inside handler for structured Zod errors */
98
+ const CrossProjectInsightsInputSchema = z.object({
99
+ start_date: z
100
+ .string()
101
+ .regex(DATE_FORMAT_REGEX, DATE_FORMAT_MESSAGE)
102
+ .optional()
103
+ .describe('Start date (YYYY-MM-DD)'),
104
+ end_date: z
105
+ .string()
106
+ .regex(DATE_FORMAT_REGEX, DATE_FORMAT_MESSAGE)
107
+ .optional()
108
+ .describe('End date (YYYY-MM-DD)'),
109
+ min_entries: z.number().optional().default(3).describe('Minimum entries to include project'),
110
+ });
111
+ /** Relaxed schema — passed to SDK inputSchema so Zod errors reach the handler */
112
+ const CrossProjectInsightsInputSchemaMcp = z.object({
113
+ start_date: z.string().optional().describe('Start date (YYYY-MM-DD)'),
114
+ end_date: z.string().optional().describe('End date (YYYY-MM-DD)'),
115
+ min_entries: z.number().optional().default(3).describe('Minimum entries to include project'),
116
+ });
117
+ // ============================================================================
118
+ // Tool Definitions
119
+ // ============================================================================
120
+ export function getAnalyticsTools(context) {
121
+ const { db } = context;
122
+ return [
123
+ {
124
+ name: 'get_statistics',
125
+ title: 'Get Statistics',
126
+ description: 'Get journal statistics and analytics (Phase 2: includes project breakdown)',
127
+ group: 'analytics',
128
+ inputSchema: GetStatisticsSchemaMcp,
129
+ outputSchema: StatisticsOutputSchema,
130
+ annotations: { readOnlyHint: true, idempotentHint: true },
131
+ handler: (params) => {
132
+ try {
133
+ const { group_by } = GetStatisticsSchema.parse(params);
134
+ const stats = db.getStatistics(group_by);
135
+ return { ...stats, groupBy: group_by };
136
+ }
137
+ catch (err) {
138
+ return formatHandlerError(err);
139
+ }
140
+ },
141
+ },
142
+ {
143
+ name: 'get_cross_project_insights',
144
+ title: 'Get Cross-Project Insights',
145
+ description: 'Analyze patterns across all GitHub Projects tracked in journal entries',
146
+ group: 'analytics',
147
+ inputSchema: CrossProjectInsightsInputSchemaMcp,
148
+ outputSchema: CrossProjectInsightsOutputSchema,
149
+ annotations: { readOnlyHint: true, idempotentHint: true },
150
+ handler: (params) => {
151
+ try {
152
+ const input = CrossProjectInsightsInputSchema.parse(params);
153
+ const rawDb = db.getRawDb();
154
+ // Build WHERE clause
155
+ let where = 'WHERE deleted_at IS NULL AND project_number IS NOT NULL';
156
+ const sqlParams = [];
157
+ if (input.start_date) {
158
+ where += ' AND DATE(timestamp) >= DATE(?)';
159
+ sqlParams.push(input.start_date);
160
+ }
161
+ if (input.end_date) {
162
+ where += ' AND DATE(timestamp) <= DATE(?)';
163
+ sqlParams.push(input.end_date);
164
+ }
165
+ // Get active projects with stats
166
+ const projectsResult = rawDb.exec(`
167
+ SELECT project_number, COUNT(*) as entry_count,
168
+ MIN(DATE(timestamp)) as first_entry,
169
+ MAX(DATE(timestamp)) as last_entry,
170
+ COUNT(DISTINCT DATE(timestamp)) as active_days
171
+ FROM memory_journal ${where}
172
+ GROUP BY project_number
173
+ HAVING entry_count >= ?
174
+ ORDER BY entry_count DESC
175
+ `, [...sqlParams, input.min_entries]);
176
+ if (!projectsResult[0] || projectsResult[0].values.length === 0) {
177
+ return {
178
+ project_count: 0,
179
+ total_entries: 0,
180
+ projects: [],
181
+ inactive_projects: [],
182
+ inactiveThresholdDays: 7,
183
+ time_distribution: [],
184
+ message: `No projects found with at least ${String(input.min_entries)} entries`,
185
+ };
186
+ }
187
+ const columns = projectsResult[0].columns;
188
+ const projects = projectsResult[0].values.map((row) => {
189
+ const obj = {};
190
+ columns.forEach((col, i) => {
191
+ obj[col] = row[i];
192
+ });
193
+ return obj;
194
+ });
195
+ // Get top tags per project
196
+ const projectTags = {};
197
+ for (const proj of projects) {
198
+ const projNum = proj['project_number'];
199
+ const tagsResult = rawDb.exec(`
200
+ SELECT t.name, COUNT(*) as count
201
+ FROM tags t
202
+ JOIN entry_tags et ON t.id = et.tag_id
203
+ JOIN memory_journal m ON et.entry_id = m.id
204
+ WHERE m.project_number = ? AND m.deleted_at IS NULL
205
+ GROUP BY t.name
206
+ ORDER BY count DESC
207
+ LIMIT 5
208
+ `, [projNum]);
209
+ if (tagsResult[0]) {
210
+ projectTags[projNum] = tagsResult[0].values.map((row) => ({
211
+ name: row[0],
212
+ count: row[1],
213
+ }));
214
+ }
215
+ }
216
+ // Find inactive projects (last entry > 7 days ago)
217
+ const cutoffDate = new Date(Date.now() - 7 * 86400000)
218
+ .toISOString()
219
+ .split('T')[0];
220
+ const inactiveResult = rawDb.exec(`
221
+ SELECT project_number, MAX(DATE(timestamp)) as last_entry_date
222
+ FROM memory_journal
223
+ WHERE deleted_at IS NULL AND project_number IS NOT NULL
224
+ GROUP BY project_number
225
+ HAVING last_entry_date < ?
226
+ `, [cutoffDate]);
227
+ const inactiveProjects = inactiveResult[0]?.values.map((row) => ({
228
+ project_number: row[0],
229
+ last_entry_date: row[1],
230
+ })) ?? [];
231
+ // Calculate time distribution
232
+ const totalEntries = projects.reduce((sum, p) => sum + p['entry_count'], 0);
233
+ const distribution = projects.slice(0, 5).map((p) => ({
234
+ project_number: p['project_number'],
235
+ percentage: ((p['entry_count'] / totalEntries) * 100).toFixed(1),
236
+ }));
237
+ return {
238
+ project_count: projects.length,
239
+ total_entries: totalEntries,
240
+ projects: projects.map((p) => ({
241
+ ...p,
242
+ top_tags: projectTags[p['project_number']] ?? [],
243
+ })),
244
+ inactive_projects: inactiveProjects,
245
+ inactiveThresholdDays: 7,
246
+ time_distribution: distribution,
247
+ };
248
+ }
249
+ catch (err) {
250
+ return formatHandlerError(err);
251
+ }
252
+ },
253
+ },
254
+ ];
255
+ }
256
+ //# sourceMappingURL=analytics.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"analytics.js","sourceRoot":"","sources":["../../../src/handlers/tools/analytics.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,8 @@
1
+ /**
2
+ * Backup Tool Group - 4 tools
3
+ *
4
+ * Tools: backup_journal, list_backups, restore_backup, cleanup_backups
5
+ */
6
+ import type { ToolDefinition, ToolContext } from '../../types/index.js';
7
+ export declare function getBackupTools(context: ToolContext): ToolDefinition[];
8
+ //# sourceMappingURL=backup.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"backup.d.ts","sourceRoot":"","sources":["../../../src/handlers/tools/backup.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AA6DvE,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,EAAE,CA6KrE"}
@@ -0,0 +1,224 @@
1
+ /**
2
+ * Backup Tool Group - 4 tools
3
+ *
4
+ * Tools: backup_journal, list_backups, restore_backup, cleanup_backups
5
+ */
6
+ import { z } from 'zod';
7
+ import { formatHandlerError } from '../../utils/error-helpers.js';
8
+ import { sendProgress } from '../../utils/progress-utils.js';
9
+ // ============================================================================
10
+ // Output Schemas
11
+ // ============================================================================
12
+ const BackupResultOutputSchema = z.object({
13
+ success: z.boolean(),
14
+ message: z.string().optional(),
15
+ filename: z.string().optional(),
16
+ path: z.string().optional(),
17
+ sizeBytes: z.number().optional(),
18
+ error: z.string().optional(),
19
+ });
20
+ const BackupInfoSchema = z.object({
21
+ filename: z.string(),
22
+ sizeBytes: z.number(),
23
+ createdAt: z.string(),
24
+ });
25
+ const BackupsListOutputSchema = z.object({
26
+ success: z.boolean().optional(),
27
+ backups: z.array(BackupInfoSchema).optional(),
28
+ total: z.number().optional(),
29
+ backupsDirectory: z.string().optional(),
30
+ hint: z.string().optional(),
31
+ error: z.string().optional(),
32
+ });
33
+ const RestoreResultOutputSchema = z.object({
34
+ success: z.boolean(),
35
+ message: z.string().optional(),
36
+ restoredFrom: z.string().optional(),
37
+ previousEntryCount: z.number().optional(),
38
+ newEntryCount: z.number().optional(),
39
+ warning: z.string().optional(),
40
+ revertedChanges: z
41
+ .object({
42
+ tagMerges: z.string().optional(),
43
+ entries: z.string().optional(),
44
+ })
45
+ .optional(),
46
+ error: z.string().optional(),
47
+ });
48
+ const CleanupBackupsOutputSchema = z.object({
49
+ success: z.boolean(),
50
+ deleted: z.array(z.string()).optional(),
51
+ deletedCount: z.number().optional(),
52
+ keptCount: z.number().optional(),
53
+ message: z.string().optional(),
54
+ error: z.string().optional(),
55
+ });
56
+ // ============================================================================
57
+ // Tool Definitions
58
+ // ============================================================================
59
+ export function getBackupTools(context) {
60
+ const { db, progress } = context;
61
+ return [
62
+ {
63
+ name: 'backup_journal',
64
+ title: 'Backup Journal Database',
65
+ description: 'Create a timestamped backup of the journal database. Backups are stored in the backups/ directory.',
66
+ group: 'backup',
67
+ inputSchema: z.object({
68
+ name: z
69
+ .string()
70
+ .optional()
71
+ .describe('Custom backup name (optional, defaults to timestamp)'),
72
+ }),
73
+ outputSchema: BackupResultOutputSchema,
74
+ annotations: { readOnlyHint: false, idempotentHint: true },
75
+ handler: (params) => {
76
+ try {
77
+ const input = z
78
+ .object({
79
+ name: z.string().optional(),
80
+ })
81
+ .parse(params);
82
+ const result = db.exportToFile(input.name);
83
+ return {
84
+ success: true,
85
+ message: `Backup created successfully`,
86
+ filename: result.filename,
87
+ path: result.path,
88
+ sizeBytes: result.sizeBytes,
89
+ };
90
+ }
91
+ catch (err) {
92
+ return formatHandlerError(err);
93
+ }
94
+ },
95
+ },
96
+ {
97
+ name: 'list_backups',
98
+ title: 'List Journal Backups',
99
+ description: 'List all available backup files with their sizes and creation dates',
100
+ group: 'backup',
101
+ inputSchema: z.object({}),
102
+ outputSchema: BackupsListOutputSchema,
103
+ annotations: { readOnlyHint: true, idempotentHint: true },
104
+ handler: (_params) => {
105
+ try {
106
+ const backups = db.listBackups();
107
+ return {
108
+ backups,
109
+ total: backups.length,
110
+ backupsDirectory: db.getBackupsDir(),
111
+ hint: backups.length === 0
112
+ ? 'No backups found. Use backup_journal to create one.'
113
+ : undefined,
114
+ };
115
+ }
116
+ catch (err) {
117
+ return formatHandlerError(err);
118
+ }
119
+ },
120
+ },
121
+ {
122
+ name: 'restore_backup',
123
+ title: 'Restore Journal from Backup',
124
+ description: 'Restore the journal database from a backup file. WARNING: This replaces all current data. An automatic backup is created before restore.',
125
+ group: 'backup',
126
+ inputSchema: z.object({
127
+ filename: z
128
+ .string()
129
+ .describe('Backup filename to restore from (e.g., backup_2025-01-01.db)'),
130
+ confirm: z
131
+ .literal(true)
132
+ .describe('Must be set to true to confirm the restore operation'),
133
+ }),
134
+ outputSchema: RestoreResultOutputSchema,
135
+ annotations: { readOnlyHint: false, idempotentHint: false, destructiveHint: true },
136
+ handler: async (params) => {
137
+ try {
138
+ const input = z
139
+ .object({
140
+ filename: z.string(),
141
+ confirm: z.literal(true),
142
+ })
143
+ .parse(params);
144
+ // Capture progress context values BEFORE any async operations
145
+ const progressServer = progress?.server;
146
+ const progressTokenValue = progress?.progressToken;
147
+ await sendProgress(progress, 1, 3, 'Preparing restore...');
148
+ await sendProgress(progress, 2, 3, 'Restoring database from backup...');
149
+ const result = await db.restoreFromFile(input.filename);
150
+ // Send directly using captured primitives (db.restoreFromFile reinitializes DB)
151
+ if (progressServer !== undefined && progressTokenValue !== undefined) {
152
+ try {
153
+ await progressServer.notification({
154
+ method: 'notifications/progress',
155
+ params: {
156
+ progressToken: progressTokenValue,
157
+ progress: 3,
158
+ total: 3,
159
+ message: 'Restore complete',
160
+ },
161
+ });
162
+ }
163
+ catch {
164
+ // Best-effort notification
165
+ }
166
+ }
167
+ return {
168
+ success: true,
169
+ message: `Database restored from ${input.filename}`,
170
+ restoredFrom: result.restoredFrom,
171
+ previousEntryCount: result.previousEntryCount,
172
+ newEntryCount: result.newEntryCount,
173
+ warning: 'A pre-restore backup was automatically created. Any changes made since this backup (including tag merges, new entries, and relationships) have been reverted.',
174
+ revertedChanges: {
175
+ tagMerges: 'Any merge_tags operations since this backup are reverted. Previously merged tags will reappear as separate tags.',
176
+ entries: result.previousEntryCount !== result.newEntryCount
177
+ ? `Entry count changed from ${String(result.previousEntryCount)} to ${String(result.newEntryCount)}`
178
+ : undefined,
179
+ },
180
+ };
181
+ }
182
+ catch (err) {
183
+ return formatHandlerError(err);
184
+ }
185
+ },
186
+ },
187
+ {
188
+ name: 'cleanup_backups',
189
+ title: 'Cleanup Old Backups',
190
+ description: 'Delete old backup files, keeping only the most recent N backups. Use list_backups to preview before cleanup.',
191
+ group: 'backup',
192
+ inputSchema: z.object({
193
+ keep_count: z
194
+ .number()
195
+ .min(1)
196
+ .default(5)
197
+ .describe('Number of most recent backups to keep (default: 5)'),
198
+ }),
199
+ outputSchema: CleanupBackupsOutputSchema,
200
+ annotations: { readOnlyHint: false, idempotentHint: false },
201
+ handler: (params) => {
202
+ try {
203
+ const { keep_count } = z
204
+ .object({ keep_count: z.number().min(1).default(5) })
205
+ .parse(params);
206
+ const result = db.deleteOldBackups(keep_count);
207
+ return {
208
+ success: true,
209
+ deleted: result.deleted,
210
+ deletedCount: result.deleted.length,
211
+ keptCount: result.kept,
212
+ message: result.deleted.length > 0
213
+ ? `Deleted ${String(result.deleted.length)} old backup(s), kept ${String(result.kept)}`
214
+ : `No backups to delete. Currently have ${String(result.kept)} backup(s).`,
215
+ };
216
+ }
217
+ catch (err) {
218
+ return formatHandlerError(err);
219
+ }
220
+ },
221
+ },
222
+ ];
223
+ }
224
+ //# sourceMappingURL=backup.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"backup.js","sourceRoot":"","sources":["../../../src/handlers/tools/backup.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,9 @@
1
+ /**
2
+ * Core Tool Group - 6 tools
3
+ *
4
+ * Tools: create_entry, get_entry_by_id, get_recent_entries,
5
+ * create_entry_minimal, test_simple, list_tags
6
+ */
7
+ import type { ToolDefinition, ToolContext } from '../../types/index.js';
8
+ export declare function getCoreTools(context: ToolContext): ToolDefinition[];
9
+ //# sourceMappingURL=core.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../../src/handlers/tools/core.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAqIvE,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,EAAE,CA+MnE"}