@dizzlkheinz/ynab-mcpb 0.18.4 → 0.19.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 (343) hide show
  1. package/CLAUDE.md +87 -8
  2. package/bin/ynab-mcp-server.cjs +2 -2
  3. package/bin/ynab-mcp-server.js +3 -3
  4. package/biome.json +39 -0
  5. package/dist/bundle/index.cjs +67 -67
  6. package/dist/index.d.ts +1 -1
  7. package/dist/index.js +27 -27
  8. package/dist/server/YNABMCPServer.d.ts +3 -4
  9. package/dist/server/YNABMCPServer.js +111 -116
  10. package/dist/server/budgetResolver.d.ts +6 -5
  11. package/dist/server/budgetResolver.js +46 -36
  12. package/dist/server/cacheKeys.js +6 -6
  13. package/dist/server/cacheManager.js +14 -11
  14. package/dist/server/completions.d.ts +2 -2
  15. package/dist/server/completions.js +20 -15
  16. package/dist/server/config.d.ts +10 -5
  17. package/dist/server/config.js +24 -7
  18. package/dist/server/deltaCache.d.ts +2 -2
  19. package/dist/server/deltaCache.js +22 -16
  20. package/dist/server/deltaCache.merge.d.ts +2 -2
  21. package/dist/server/diagnostics.d.ts +4 -4
  22. package/dist/server/diagnostics.js +38 -32
  23. package/dist/server/errorHandler.d.ts +5 -12
  24. package/dist/server/errorHandler.js +219 -217
  25. package/dist/server/prompts.d.ts +2 -2
  26. package/dist/server/prompts.js +45 -45
  27. package/dist/server/rateLimiter.js +4 -4
  28. package/dist/server/requestLogger.d.ts +1 -1
  29. package/dist/server/requestLogger.js +40 -35
  30. package/dist/server/resources.d.ts +3 -3
  31. package/dist/server/resources.js +55 -52
  32. package/dist/server/responseFormatter.js +6 -6
  33. package/dist/server/securityMiddleware.d.ts +2 -2
  34. package/dist/server/securityMiddleware.js +22 -20
  35. package/dist/server/serverKnowledgeStore.js +1 -1
  36. package/dist/server/toolRegistry.d.ts +3 -3
  37. package/dist/server/toolRegistry.js +47 -40
  38. package/dist/tools/__tests__/deltaTestUtils.d.ts +3 -3
  39. package/dist/tools/__tests__/deltaTestUtils.js +2 -2
  40. package/dist/tools/accountTools.d.ts +9 -8
  41. package/dist/tools/accountTools.js +47 -47
  42. package/dist/tools/adapters.d.ts +13 -8
  43. package/dist/tools/adapters.js +21 -11
  44. package/dist/tools/budgetTools.d.ts +8 -7
  45. package/dist/tools/budgetTools.js +22 -22
  46. package/dist/tools/categoryTools.d.ts +9 -8
  47. package/dist/tools/categoryTools.js +68 -59
  48. package/dist/tools/compareTransactions/formatter.d.ts +3 -3
  49. package/dist/tools/compareTransactions/formatter.js +9 -9
  50. package/dist/tools/compareTransactions/index.d.ts +6 -6
  51. package/dist/tools/compareTransactions/index.js +58 -43
  52. package/dist/tools/compareTransactions/matcher.d.ts +1 -1
  53. package/dist/tools/compareTransactions/matcher.js +28 -15
  54. package/dist/tools/compareTransactions/parser.d.ts +2 -2
  55. package/dist/tools/compareTransactions/parser.js +144 -138
  56. package/dist/tools/compareTransactions/types.d.ts +4 -4
  57. package/dist/tools/compareTransactions.d.ts +1 -1
  58. package/dist/tools/compareTransactions.js +1 -1
  59. package/dist/tools/deltaFetcher.d.ts +2 -2
  60. package/dist/tools/deltaFetcher.js +16 -15
  61. package/dist/tools/deltaSupport.d.ts +4 -4
  62. package/dist/tools/deltaSupport.js +35 -41
  63. package/dist/tools/exportTransactions.d.ts +5 -4
  64. package/dist/tools/exportTransactions.js +61 -59
  65. package/dist/tools/monthTools.d.ts +7 -6
  66. package/dist/tools/monthTools.js +31 -29
  67. package/dist/tools/payeeTools.d.ts +7 -6
  68. package/dist/tools/payeeTools.js +28 -28
  69. package/dist/tools/reconcileAdapter.d.ts +2 -2
  70. package/dist/tools/reconcileAdapter.js +19 -12
  71. package/dist/tools/reconciliation/analyzer.d.ts +4 -4
  72. package/dist/tools/reconciliation/analyzer.js +73 -59
  73. package/dist/tools/reconciliation/csvParser.d.ts +3 -3
  74. package/dist/tools/reconciliation/csvParser.js +128 -104
  75. package/dist/tools/reconciliation/executor.d.ts +4 -4
  76. package/dist/tools/reconciliation/executor.js +148 -109
  77. package/dist/tools/reconciliation/index.d.ts +10 -10
  78. package/dist/tools/reconciliation/index.js +96 -83
  79. package/dist/tools/reconciliation/matcher.d.ts +3 -3
  80. package/dist/tools/reconciliation/matcher.js +17 -16
  81. package/dist/tools/reconciliation/payeeNormalizer.js +19 -8
  82. package/dist/tools/reconciliation/recommendationEngine.d.ts +1 -1
  83. package/dist/tools/reconciliation/recommendationEngine.js +40 -40
  84. package/dist/tools/reconciliation/reportFormatter.d.ts +2 -2
  85. package/dist/tools/reconciliation/reportFormatter.js +59 -58
  86. package/dist/tools/reconciliation/signDetector.d.ts +1 -1
  87. package/dist/tools/reconciliation/types.d.ts +16 -16
  88. package/dist/tools/reconciliation/ynabAdapter.d.ts +2 -2
  89. package/dist/tools/schemas/common.d.ts +1 -1
  90. package/dist/tools/schemas/common.js +1 -1
  91. package/dist/tools/schemas/outputs/accountOutputs.d.ts +1 -1
  92. package/dist/tools/schemas/outputs/accountOutputs.js +24 -18
  93. package/dist/tools/schemas/outputs/budgetOutputs.d.ts +1 -1
  94. package/dist/tools/schemas/outputs/budgetOutputs.js +14 -11
  95. package/dist/tools/schemas/outputs/categoryOutputs.d.ts +1 -1
  96. package/dist/tools/schemas/outputs/categoryOutputs.js +49 -29
  97. package/dist/tools/schemas/outputs/comparisonOutputs.d.ts +1 -1
  98. package/dist/tools/schemas/outputs/comparisonOutputs.js +12 -12
  99. package/dist/tools/schemas/outputs/index.d.ts +14 -14
  100. package/dist/tools/schemas/outputs/index.js +14 -14
  101. package/dist/tools/schemas/outputs/monthOutputs.d.ts +1 -1
  102. package/dist/tools/schemas/outputs/monthOutputs.js +56 -41
  103. package/dist/tools/schemas/outputs/payeeOutputs.d.ts +1 -1
  104. package/dist/tools/schemas/outputs/payeeOutputs.js +10 -10
  105. package/dist/tools/schemas/outputs/reconciliationOutputs.d.ts +2 -2
  106. package/dist/tools/schemas/outputs/reconciliationOutputs.js +45 -45
  107. package/dist/tools/schemas/outputs/transactionMutationOutputs.d.ts +1 -1
  108. package/dist/tools/schemas/outputs/transactionMutationOutputs.js +28 -22
  109. package/dist/tools/schemas/outputs/transactionOutputs.d.ts +1 -1
  110. package/dist/tools/schemas/outputs/transactionOutputs.js +43 -35
  111. package/dist/tools/schemas/outputs/utilityOutputs.d.ts +1 -1
  112. package/dist/tools/schemas/outputs/utilityOutputs.js +5 -3
  113. package/dist/tools/schemas/shared/commonOutputs.d.ts +1 -1
  114. package/dist/tools/schemas/shared/commonOutputs.js +15 -9
  115. package/dist/tools/transactionReadTools.d.ts +11 -0
  116. package/dist/tools/transactionReadTools.js +202 -0
  117. package/dist/tools/transactionSchemas.d.ts +7 -7
  118. package/dist/tools/transactionSchemas.js +77 -57
  119. package/dist/tools/transactionTools.d.ts +6 -24
  120. package/dist/tools/transactionTools.js +7 -1499
  121. package/dist/tools/transactionUtils.d.ts +6 -6
  122. package/dist/tools/transactionUtils.js +78 -63
  123. package/dist/tools/transactionWriteTools.d.ts +20 -0
  124. package/dist/tools/transactionWriteTools.js +1342 -0
  125. package/dist/tools/utilityTools.d.ts +5 -4
  126. package/dist/tools/utilityTools.js +11 -11
  127. package/dist/types/index.d.ts +7 -7
  128. package/dist/types/index.js +6 -6
  129. package/dist/types/reconciliation.d.ts +1 -1
  130. package/dist/types/toolRegistration.d.ts +14 -12
  131. package/dist/utils/amountUtils.js +1 -1
  132. package/dist/utils/dateUtils.js +4 -4
  133. package/dist/utils/errors.d.ts +3 -3
  134. package/dist/utils/errors.js +4 -4
  135. package/dist/utils/money.d.ts +2 -2
  136. package/dist/utils/money.js +8 -8
  137. package/dist/utils/validationError.d.ts +1 -1
  138. package/dist/utils/validationError.js +1 -1
  139. package/docs/assets/examples/reconciliation-with-recommendations.json +66 -66
  140. package/docs/assets/schemas/reconciliation-v2.json +360 -336
  141. package/esbuild.config.mjs +53 -50
  142. package/meta.json +12548 -12548
  143. package/package.json +98 -111
  144. package/scripts/analyze-bundle.mjs +33 -30
  145. package/scripts/create-pr-description.js +169 -120
  146. package/scripts/run-all-tests.js +178 -169
  147. package/scripts/run-domain-integration-tests.js +28 -18
  148. package/scripts/run-generate-mcpb.js +19 -17
  149. package/scripts/run-throttled-integration-tests.js +92 -83
  150. package/scripts/test-delta-params.mjs +149 -120
  151. package/scripts/test-recommendations.ts +36 -32
  152. package/scripts/tmpTransaction.ts +80 -43
  153. package/scripts/validate-env.js +98 -91
  154. package/scripts/verify-build.js +78 -76
  155. package/src/__tests__/comprehensive.integration.test.ts +1281 -1154
  156. package/src/__tests__/performance.test.ts +723 -671
  157. package/src/__tests__/setup.ts +442 -395
  158. package/src/__tests__/smoke.e2e.test.ts +41 -39
  159. package/src/__tests__/testRunner.ts +314 -295
  160. package/src/__tests__/testUtils.ts +456 -364
  161. package/src/__tests__/tools/reconciliation/csvParser.integration.test.ts +109 -107
  162. package/src/__tests__/tools/reconciliation/real-world.integration.test.ts +41 -41
  163. package/src/index.ts +68 -59
  164. package/src/server/CLAUDE.md +480 -0
  165. package/src/server/YNABMCPServer.ts +821 -794
  166. package/src/server/__tests__/YNABMCPServer.integration.test.ts +929 -893
  167. package/src/server/__tests__/YNABMCPServer.test.ts +903 -899
  168. package/src/server/__tests__/budgetResolver.test.ts +466 -423
  169. package/src/server/__tests__/cacheManager.test.ts +891 -874
  170. package/src/server/__tests__/completions.integration.test.ts +115 -106
  171. package/src/server/__tests__/completions.test.ts +334 -313
  172. package/src/server/__tests__/config.test.ts +98 -86
  173. package/src/server/__tests__/deltaCache.merge.test.ts +774 -703
  174. package/src/server/__tests__/deltaCache.swr.test.ts +198 -153
  175. package/src/server/__tests__/deltaCache.test.ts +946 -759
  176. package/src/server/__tests__/diagnostics.test.ts +825 -792
  177. package/src/server/__tests__/errorHandler.integration.test.ts +512 -462
  178. package/src/server/__tests__/errorHandler.test.ts +402 -397
  179. package/src/server/__tests__/prompts.test.ts +424 -347
  180. package/src/server/__tests__/rateLimiter.test.ts +313 -309
  181. package/src/server/__tests__/requestLogger.test.ts +443 -403
  182. package/src/server/__tests__/resources.template.test.ts +196 -185
  183. package/src/server/__tests__/resources.test.ts +294 -288
  184. package/src/server/__tests__/security.integration.test.ts +487 -421
  185. package/src/server/__tests__/securityMiddleware.test.ts +519 -444
  186. package/src/server/__tests__/server-startup.integration.test.ts +509 -490
  187. package/src/server/__tests__/serverKnowledgeStore.test.ts +174 -173
  188. package/src/server/__tests__/toolRegistration.test.ts +239 -210
  189. package/src/server/__tests__/toolRegistry.test.ts +907 -845
  190. package/src/server/budgetResolver.ts +221 -181
  191. package/src/server/cacheKeys.ts +6 -6
  192. package/src/server/cacheManager.ts +498 -484
  193. package/src/server/completions.ts +267 -243
  194. package/src/server/config.ts +35 -14
  195. package/src/server/deltaCache.merge.ts +146 -128
  196. package/src/server/deltaCache.ts +352 -309
  197. package/src/server/diagnostics.ts +257 -242
  198. package/src/server/errorHandler.ts +747 -744
  199. package/src/server/prompts.ts +181 -176
  200. package/src/server/rateLimiter.ts +131 -129
  201. package/src/server/requestLogger.ts +350 -322
  202. package/src/server/resources.ts +442 -374
  203. package/src/server/responseFormatter.ts +41 -37
  204. package/src/server/securityMiddleware.ts +223 -205
  205. package/src/server/serverKnowledgeStore.ts +67 -67
  206. package/src/server/toolRegistry.ts +508 -474
  207. package/src/tools/CLAUDE.md +604 -0
  208. package/src/tools/__tests__/accountTools.delta.integration.test.ts +128 -111
  209. package/src/tools/__tests__/accountTools.integration.test.ts +129 -111
  210. package/src/tools/__tests__/accountTools.test.ts +685 -638
  211. package/src/tools/__tests__/adapters.test.ts +142 -108
  212. package/src/tools/__tests__/budgetTools.delta.integration.test.ts +73 -73
  213. package/src/tools/__tests__/budgetTools.integration.test.ts +132 -124
  214. package/src/tools/__tests__/budgetTools.test.ts +442 -413
  215. package/src/tools/__tests__/categoryTools.delta.integration.test.ts +76 -68
  216. package/src/tools/__tests__/categoryTools.integration.test.ts +314 -288
  217. package/src/tools/__tests__/categoryTools.test.ts +656 -625
  218. package/src/tools/__tests__/compareTransactions/formatter.test.ts +535 -462
  219. package/src/tools/__tests__/compareTransactions/index.test.ts +378 -358
  220. package/src/tools/__tests__/compareTransactions/matcher.test.ts +497 -398
  221. package/src/tools/__tests__/compareTransactions/parser.test.ts +765 -747
  222. package/src/tools/__tests__/compareTransactions.test.ts +352 -332
  223. package/src/tools/__tests__/compareTransactions.window.test.ts +150 -146
  224. package/src/tools/__tests__/deltaFetcher.scheduled.integration.test.ts +69 -65
  225. package/src/tools/__tests__/deltaFetcher.test.ts +325 -265
  226. package/src/tools/__tests__/deltaSupport.test.ts +211 -184
  227. package/src/tools/__tests__/deltaTestUtils.ts +37 -33
  228. package/src/tools/__tests__/exportTransactions.test.ts +205 -200
  229. package/src/tools/__tests__/monthTools.delta.integration.test.ts +68 -68
  230. package/src/tools/__tests__/monthTools.integration.test.ts +178 -166
  231. package/src/tools/__tests__/monthTools.test.ts +561 -512
  232. package/src/tools/__tests__/payeeTools.delta.integration.test.ts +68 -68
  233. package/src/tools/__tests__/payeeTools.integration.test.ts +158 -142
  234. package/src/tools/__tests__/payeeTools.test.ts +486 -434
  235. package/src/tools/__tests__/transactionSchemas.test.ts +1202 -1186
  236. package/src/tools/__tests__/transactionTools.integration.test.ts +875 -825
  237. package/src/tools/__tests__/transactionTools.test.ts +4923 -4366
  238. package/src/tools/__tests__/transactionUtils.test.ts +1004 -977
  239. package/src/tools/__tests__/utilityTools.integration.test.ts +32 -32
  240. package/src/tools/__tests__/utilityTools.test.ts +68 -58
  241. package/src/tools/accountTools.ts +293 -271
  242. package/src/tools/adapters.ts +120 -63
  243. package/src/tools/budgetTools.ts +121 -116
  244. package/src/tools/categoryTools.ts +379 -339
  245. package/src/tools/compareTransactions/formatter.ts +131 -119
  246. package/src/tools/compareTransactions/index.ts +249 -214
  247. package/src/tools/compareTransactions/matcher.ts +259 -209
  248. package/src/tools/compareTransactions/parser.ts +517 -487
  249. package/src/tools/compareTransactions/types.ts +38 -38
  250. package/src/tools/compareTransactions.ts +1 -1
  251. package/src/tools/deltaFetcher.ts +281 -260
  252. package/src/tools/deltaSupport.ts +264 -259
  253. package/src/tools/exportTransactions.ts +230 -218
  254. package/src/tools/monthTools.ts +180 -165
  255. package/src/tools/payeeTools.ts +152 -140
  256. package/src/tools/reconcileAdapter.ts +297 -252
  257. package/src/tools/reconciliation/CLAUDE.md +506 -0
  258. package/src/tools/reconciliation/__tests__/adapter.causes.test.ts +133 -124
  259. package/src/tools/reconciliation/__tests__/adapter.test.ts +249 -230
  260. package/src/tools/reconciliation/__tests__/analyzer.test.ts +408 -400
  261. package/src/tools/reconciliation/__tests__/csvParser.test.ts +71 -69
  262. package/src/tools/reconciliation/__tests__/executor.integration.test.ts +348 -323
  263. package/src/tools/reconciliation/__tests__/executor.progress.test.ts +503 -457
  264. package/src/tools/reconciliation/__tests__/executor.test.ts +898 -831
  265. package/src/tools/reconciliation/__tests__/matcher.test.ts +667 -663
  266. package/src/tools/reconciliation/__tests__/payeeNormalizer.test.ts +296 -276
  267. package/src/tools/reconciliation/__tests__/recommendationEngine.integration.test.ts +692 -624
  268. package/src/tools/reconciliation/__tests__/recommendationEngine.test.ts +1008 -989
  269. package/src/tools/reconciliation/__tests__/reconciliation.delta.integration.test.ts +187 -146
  270. package/src/tools/reconciliation/__tests__/reportFormatter.test.ts +583 -533
  271. package/src/tools/reconciliation/__tests__/scenarios/adapterCurrency.scenario.test.ts +75 -74
  272. package/src/tools/reconciliation/__tests__/scenarios/extremes.scenario.test.ts +70 -62
  273. package/src/tools/reconciliation/__tests__/scenarios/repeatAmount.scenario.test.ts +102 -88
  274. package/src/tools/reconciliation/__tests__/schemaUrl.test.ts +56 -55
  275. package/src/tools/reconciliation/__tests__/signDetector.test.ts +209 -206
  276. package/src/tools/reconciliation/__tests__/ynabAdapter.test.ts +66 -60
  277. package/src/tools/reconciliation/analyzer.ts +564 -504
  278. package/src/tools/reconciliation/csvParser.ts +656 -609
  279. package/src/tools/reconciliation/executor.ts +1290 -1128
  280. package/src/tools/reconciliation/index.ts +580 -528
  281. package/src/tools/reconciliation/matcher.ts +256 -240
  282. package/src/tools/reconciliation/payeeNormalizer.ts +92 -78
  283. package/src/tools/reconciliation/recommendationEngine.ts +357 -345
  284. package/src/tools/reconciliation/reportFormatter.ts +343 -307
  285. package/src/tools/reconciliation/signDetector.ts +89 -83
  286. package/src/tools/reconciliation/types.ts +164 -159
  287. package/src/tools/reconciliation/ynabAdapter.ts +17 -15
  288. package/src/tools/schemas/CLAUDE.md +546 -0
  289. package/src/tools/schemas/common.ts +1 -1
  290. package/src/tools/schemas/outputs/__tests__/accountOutputs.test.ts +410 -409
  291. package/src/tools/schemas/outputs/__tests__/budgetOutputs.test.ts +305 -299
  292. package/src/tools/schemas/outputs/__tests__/categoryOutputs.test.ts +431 -430
  293. package/src/tools/schemas/outputs/__tests__/comparisonOutputs.test.ts +510 -495
  294. package/src/tools/schemas/outputs/__tests__/dateValidation.test.ts +179 -153
  295. package/src/tools/schemas/outputs/__tests__/discrepancyDirection.test.ts +293 -254
  296. package/src/tools/schemas/outputs/__tests__/monthOutputs.test.ts +457 -457
  297. package/src/tools/schemas/outputs/__tests__/payeeOutputs.test.ts +362 -356
  298. package/src/tools/schemas/outputs/__tests__/reconciliationOutputs.test.ts +402 -399
  299. package/src/tools/schemas/outputs/__tests__/transactionMutationSchemas.test.ts +225 -211
  300. package/src/tools/schemas/outputs/__tests__/transactionOutputs.test.ts +457 -454
  301. package/src/tools/schemas/outputs/__tests__/utilityOutputs.test.ts +316 -315
  302. package/src/tools/schemas/outputs/accountOutputs.ts +40 -34
  303. package/src/tools/schemas/outputs/budgetOutputs.ts +24 -19
  304. package/src/tools/schemas/outputs/categoryOutputs.ts +76 -56
  305. package/src/tools/schemas/outputs/comparisonOutputs.ts +192 -169
  306. package/src/tools/schemas/outputs/index.ts +163 -163
  307. package/src/tools/schemas/outputs/monthOutputs.ts +95 -80
  308. package/src/tools/schemas/outputs/payeeOutputs.ts +18 -18
  309. package/src/tools/schemas/outputs/reconciliationOutputs.ts +386 -373
  310. package/src/tools/schemas/outputs/transactionMutationOutputs.ts +259 -231
  311. package/src/tools/schemas/outputs/transactionOutputs.ts +81 -71
  312. package/src/tools/schemas/outputs/utilityOutputs.ts +90 -84
  313. package/src/tools/schemas/shared/commonOutputs.ts +27 -19
  314. package/src/tools/toolCategories.ts +114 -114
  315. package/src/tools/transactionReadTools.ts +327 -0
  316. package/src/tools/transactionSchemas.ts +322 -291
  317. package/src/tools/transactionTools.ts +84 -2246
  318. package/src/tools/transactionUtils.ts +507 -422
  319. package/src/tools/transactionWriteTools.ts +2110 -0
  320. package/src/tools/utilityTools.ts +46 -41
  321. package/src/types/CLAUDE.md +477 -0
  322. package/src/types/__tests__/index.test.ts +51 -51
  323. package/src/types/index.ts +43 -39
  324. package/src/types/integration-tests.d.ts +26 -26
  325. package/src/types/reconciliation.ts +29 -29
  326. package/src/types/toolAnnotations.ts +30 -30
  327. package/src/types/toolRegistration.ts +43 -32
  328. package/src/utils/CLAUDE.md +508 -0
  329. package/src/utils/__tests__/dateUtils.test.ts +174 -168
  330. package/src/utils/__tests__/money.test.ts +193 -187
  331. package/src/utils/amountUtils.ts +5 -5
  332. package/src/utils/baseError.ts +5 -5
  333. package/src/utils/dateUtils.ts +29 -26
  334. package/src/utils/errors.ts +14 -14
  335. package/src/utils/money.ts +66 -52
  336. package/src/utils/validationError.ts +1 -1
  337. package/tsconfig.json +29 -29
  338. package/tsconfig.prod.json +16 -16
  339. package/vitest-reporters/split-json-reporter.ts +247 -204
  340. package/vitest.config.ts +99 -95
  341. package/.prettierignore +0 -10
  342. package/.prettierrc.json +0 -10
  343. package/eslint.config.js +0 -49
@@ -2,274 +2,287 @@
2
2
  * Comprehensive test runner and coverage reporter
3
3
  */
4
4
 
5
- import { execSync } from 'child_process';
6
- import { existsSync, readFileSync, writeFileSync } from 'fs';
7
- import { join } from 'path';
5
+ import { execSync } from "node:child_process";
6
+ import { existsSync, readFileSync, writeFileSync } from "node:fs";
7
+ import { join } from "node:path";
8
8
 
9
9
  interface TestResults {
10
- unit: TestSuiteResult;
11
- integration: TestSuiteResult;
12
- e2e: TestSuiteResult;
13
- performance: TestSuiteResult;
14
- coverage: CoverageResult;
10
+ unit: TestSuiteResult;
11
+ integration: TestSuiteResult;
12
+ e2e: TestSuiteResult;
13
+ performance: TestSuiteResult;
14
+ coverage: CoverageResult;
15
15
  }
16
16
 
17
17
  interface TestSuiteResult {
18
- passed: number;
19
- failed: number;
20
- skipped: number;
21
- duration: number;
22
- success: boolean;
18
+ passed: number;
19
+ failed: number;
20
+ skipped: number;
21
+ duration: number;
22
+ success: boolean;
23
23
  }
24
24
 
25
25
  interface CoverageResult {
26
- lines: CoverageMetric;
27
- functions: CoverageMetric;
28
- branches: CoverageMetric;
29
- statements: CoverageMetric;
30
- overall: number;
26
+ lines: CoverageMetric;
27
+ functions: CoverageMetric;
28
+ branches: CoverageMetric;
29
+ statements: CoverageMetric;
30
+ overall: number;
31
31
  }
32
32
 
33
33
  interface CoverageMetric {
34
- total: number;
35
- covered: number;
36
- percentage: number;
34
+ total: number;
35
+ covered: number;
36
+ percentage: number;
37
37
  }
38
38
 
39
39
  /**
40
40
  * Test runner class for comprehensive testing
41
41
  */
42
42
  export class ComprehensiveTestRunner {
43
- private results: Partial<TestResults> = {};
44
- private startTime: number = 0;
45
- private endTime: number = 0;
46
-
47
- /**
48
- * Run all test suites
49
- */
50
- async runAllTests(): Promise<TestResults> {
51
- console.warn('🚀 Starting comprehensive test suite...\n');
52
- this.startTime = Date.now();
53
-
54
- try {
55
- // Run unit tests
56
- console.warn('📋 Running unit tests...');
57
- this.results.unit = await this.runTestSuite('unit');
58
-
59
- // Run integration tests
60
- console.warn('🔗 Running integration tests...');
61
- this.results.integration = await this.runTestSuite('integration');
62
-
63
- // Run performance tests
64
- console.warn('⚡ Running performance tests...');
65
- this.results.performance = await this.runTestSuite('performance');
66
-
67
- // Run E2E tests (may be skipped if no API key)
68
- console.warn('🌐 Running end-to-end tests...');
69
- this.results.e2e = await this.runTestSuite('e2e');
70
-
71
- // Generate coverage report
72
- console.warn('📊 Generating coverage report...');
73
- this.results.coverage = await this.generateCoverageReport();
74
-
75
- this.endTime = Date.now();
76
-
77
- // Generate comprehensive report
78
- const finalResults = this.results as TestResults;
79
- await this.generateComprehensiveReport(finalResults);
80
-
81
- return finalResults;
82
- } catch (error) {
83
- console.error('❌ Test suite failed:', error);
84
- throw error;
85
- }
86
- }
87
-
88
- /**
89
- * Run a specific test suite
90
- */
91
- private async runTestSuite(suite: string): Promise<TestSuiteResult> {
92
- const startTime = Date.now();
93
-
94
- try {
95
- let command: string;
96
-
97
- switch (suite) {
98
- case 'unit':
99
- command = 'npm run test:unit';
100
- break;
101
- case 'integration':
102
- command = 'npm run test:integration';
103
- break;
104
- case 'e2e':
105
- command = 'npm run test:e2e';
106
- break;
107
- case 'performance':
108
- command = 'vitest run src/__tests__/performance.test.ts';
109
- break;
110
- default:
111
- throw new Error(`Unknown test suite: ${suite}`);
112
- }
113
-
114
- const output = execSync(command, {
115
- encoding: 'utf8',
116
- stdio: 'pipe',
117
- });
118
-
119
- const duration = Date.now() - startTime;
120
- const result = this.parseTestOutput(output, duration);
121
-
122
- console.warn(
123
- `✅ ${suite} tests completed: ${result.passed} passed, ${result.failed} failed, ${result.skipped} skipped (${duration}ms)\n`,
124
- );
125
-
126
- return result;
127
- } catch (error: any) {
128
- const duration = Date.now() - startTime;
129
-
130
- // Parse error output for test results
131
- const output = error.stdout || error.stderr || '';
132
- const result = this.parseTestOutput(output, duration);
133
-
134
- if (suite === 'e2e' && output.includes('Skipping E2E tests')) {
135
- console.warn(`⏭️ E2E tests skipped (no API key or SKIP_E2E_TESTS=true)\n`);
136
- return { ...result, success: true }; // Don't fail overall suite for skipped E2E
137
- }
138
-
139
- console.warn(
140
- `❌ ${suite} tests failed: ${result.passed} passed, ${result.failed} failed, ${result.skipped} skipped (${duration}ms)\n`,
141
- );
142
- return result;
143
- }
144
- }
145
-
146
- /**
147
- * Parse test output to extract results
148
- */
149
- private parseTestOutput(output: string, duration: number): TestSuiteResult {
150
- // Default values
151
- let passed = 0;
152
- let failed = 0;
153
- let skipped = 0;
154
- let success = false;
155
-
156
- try {
157
- // Look for vitest output patterns
158
- const passedMatch = output.match(/(\d+) passed/);
159
- const failedMatch = output.match(/(\d+) failed/);
160
- const skippedMatch = output.match(/(\d+) skipped/);
161
- const successMatch = output.includes('Test Files') && !output.includes('failed');
162
-
163
- if (passedMatch) passed = parseInt(passedMatch[1]!);
164
- if (failedMatch) failed = parseInt(failedMatch[1]!);
165
- if (skippedMatch) skipped = parseInt(skippedMatch[1]!);
166
-
167
- success = successMatch && failed === 0;
168
- } catch (error) {
169
- console.warn('Failed to parse test output:', error);
170
- }
171
-
172
- return {
173
- passed,
174
- failed,
175
- skipped,
176
- duration,
177
- success,
178
- };
179
- }
180
-
181
- /**
182
- * Generate coverage report
183
- */
184
- private async generateCoverageReport(): Promise<CoverageResult> {
185
- try {
186
- // Run coverage
187
- execSync('npm run test:coverage', {
188
- encoding: 'utf8',
189
- stdio: 'pipe',
190
- });
191
-
192
- // Read coverage report
193
- const coverageFile = join(process.cwd(), 'coverage', 'coverage-summary.json');
194
-
195
- if (!existsSync(coverageFile)) {
196
- throw new Error('Coverage report not found');
197
- }
198
-
199
- const coverageData = JSON.parse(readFileSync(coverageFile, 'utf8'));
200
- const total = coverageData.total;
201
-
202
- return {
203
- lines: {
204
- total: total.lines.total,
205
- covered: total.lines.covered,
206
- percentage: total.lines.pct,
207
- },
208
- functions: {
209
- total: total.functions.total,
210
- covered: total.functions.covered,
211
- percentage: total.functions.pct,
212
- },
213
- branches: {
214
- total: total.branches.total,
215
- covered: total.branches.covered,
216
- percentage: total.branches.pct,
217
- },
218
- statements: {
219
- total: total.statements.total,
220
- covered: total.statements.covered,
221
- percentage: total.statements.pct,
222
- },
223
- overall: Math.round(
224
- (total.lines.pct + total.functions.pct + total.branches.pct + total.statements.pct) / 4,
225
- ),
226
- };
227
- } catch (error) {
228
- console.warn('Failed to generate coverage report:', error);
229
- return {
230
- lines: { total: 0, covered: 0, percentage: 0 },
231
- functions: { total: 0, covered: 0, percentage: 0 },
232
- branches: { total: 0, covered: 0, percentage: 0 },
233
- statements: { total: 0, covered: 0, percentage: 0 },
234
- overall: 0,
235
- };
236
- }
237
- }
238
-
239
- /**
240
- * Generate comprehensive test report
241
- */
242
- private async generateComprehensiveReport(results: TestResults): Promise<void> {
243
- const totalDuration = this.endTime - this.startTime;
244
- const totalTests =
245
- results.unit.passed +
246
- results.unit.failed +
247
- results.integration.passed +
248
- results.integration.failed +
249
- results.e2e.passed +
250
- results.e2e.failed +
251
- results.performance.passed +
252
- results.performance.failed;
253
-
254
- const totalPassed =
255
- results.unit.passed +
256
- results.integration.passed +
257
- results.e2e.passed +
258
- results.performance.passed;
259
-
260
- const totalFailed =
261
- results.unit.failed +
262
- results.integration.failed +
263
- results.e2e.failed +
264
- results.performance.failed;
265
-
266
- const overallSuccess =
267
- results.unit.success &&
268
- results.integration.success &&
269
- results.e2e.success &&
270
- results.performance.success;
271
-
272
- const report = `
43
+ private results: Partial<TestResults> = {};
44
+ private startTime = 0;
45
+ private endTime = 0;
46
+
47
+ /**
48
+ * Run all test suites
49
+ */
50
+ async runAllTests(): Promise<TestResults> {
51
+ console.warn("🚀 Starting comprehensive test suite...\n");
52
+ this.startTime = Date.now();
53
+
54
+ try {
55
+ // Run unit tests
56
+ console.warn("📋 Running unit tests...");
57
+ this.results.unit = await this.runTestSuite("unit");
58
+
59
+ // Run integration tests
60
+ console.warn("🔗 Running integration tests...");
61
+ this.results.integration = await this.runTestSuite("integration");
62
+
63
+ // Run performance tests
64
+ console.warn("⚡ Running performance tests...");
65
+ this.results.performance = await this.runTestSuite("performance");
66
+
67
+ // Run E2E tests (may be skipped if no API key)
68
+ console.warn("🌐 Running end-to-end tests...");
69
+ this.results.e2e = await this.runTestSuite("e2e");
70
+
71
+ // Generate coverage report
72
+ console.warn("📊 Generating coverage report...");
73
+ this.results.coverage = await this.generateCoverageReport();
74
+
75
+ this.endTime = Date.now();
76
+
77
+ // Generate comprehensive report
78
+ const finalResults = this.results as TestResults;
79
+ await this.generateComprehensiveReport(finalResults);
80
+
81
+ return finalResults;
82
+ } catch (error) {
83
+ console.error("❌ Test suite failed:", error);
84
+ throw error;
85
+ }
86
+ }
87
+
88
+ /**
89
+ * Run a specific test suite
90
+ */
91
+ private async runTestSuite(suite: string): Promise<TestSuiteResult> {
92
+ const startTime = Date.now();
93
+
94
+ try {
95
+ let command: string;
96
+
97
+ switch (suite) {
98
+ case "unit":
99
+ command = "npm run test:unit";
100
+ break;
101
+ case "integration":
102
+ command = "npm run test:integration";
103
+ break;
104
+ case "e2e":
105
+ command = "npm run test:e2e";
106
+ break;
107
+ case "performance":
108
+ command = "vitest run src/__tests__/performance.test.ts";
109
+ break;
110
+ default:
111
+ throw new Error(`Unknown test suite: ${suite}`);
112
+ }
113
+
114
+ const output = execSync(command, {
115
+ encoding: "utf8",
116
+ stdio: "pipe",
117
+ });
118
+
119
+ const duration = Date.now() - startTime;
120
+ const result = this.parseTestOutput(output, duration);
121
+
122
+ console.warn(
123
+ `✅ ${suite} tests completed: ${result.passed} passed, ${result.failed} failed, ${result.skipped} skipped (${duration}ms)\n`,
124
+ );
125
+
126
+ return result;
127
+ } catch (error: any) {
128
+ const duration = Date.now() - startTime;
129
+
130
+ // Parse error output for test results
131
+ const output = error.stdout || error.stderr || "";
132
+ const result = this.parseTestOutput(output, duration);
133
+
134
+ if (suite === "e2e" && output.includes("Skipping E2E tests")) {
135
+ console.warn(
136
+ "⏭️ E2E tests skipped (no API key or SKIP_E2E_TESTS=true)\n",
137
+ );
138
+ return { ...result, success: true }; // Don't fail overall suite for skipped E2E
139
+ }
140
+
141
+ console.warn(
142
+ `❌ ${suite} tests failed: ${result.passed} passed, ${result.failed} failed, ${result.skipped} skipped (${duration}ms)\n`,
143
+ );
144
+ return result;
145
+ }
146
+ }
147
+
148
+ /**
149
+ * Parse test output to extract results
150
+ */
151
+ private parseTestOutput(output: string, duration: number): TestSuiteResult {
152
+ // Default values
153
+ let passed = 0;
154
+ let failed = 0;
155
+ let skipped = 0;
156
+ let success = false;
157
+
158
+ try {
159
+ // Look for vitest output patterns
160
+ const passedMatch = output.match(/(\d+) passed/);
161
+ const failedMatch = output.match(/(\d+) failed/);
162
+ const skippedMatch = output.match(/(\d+) skipped/);
163
+ const successMatch =
164
+ output.includes("Test Files") && !output.includes("failed");
165
+
166
+ if (passedMatch) passed = Number.parseInt(passedMatch[1]!);
167
+ if (failedMatch) failed = Number.parseInt(failedMatch[1]!);
168
+ if (skippedMatch) skipped = Number.parseInt(skippedMatch[1]!);
169
+
170
+ success = successMatch && failed === 0;
171
+ } catch (error) {
172
+ console.warn("Failed to parse test output:", error);
173
+ }
174
+
175
+ return {
176
+ passed,
177
+ failed,
178
+ skipped,
179
+ duration,
180
+ success,
181
+ };
182
+ }
183
+
184
+ /**
185
+ * Generate coverage report
186
+ */
187
+ private async generateCoverageReport(): Promise<CoverageResult> {
188
+ try {
189
+ // Run coverage
190
+ execSync("npm run test:coverage", {
191
+ encoding: "utf8",
192
+ stdio: "pipe",
193
+ });
194
+
195
+ // Read coverage report
196
+ const coverageFile = join(
197
+ process.cwd(),
198
+ "coverage",
199
+ "coverage-summary.json",
200
+ );
201
+
202
+ if (!existsSync(coverageFile)) {
203
+ throw new Error("Coverage report not found");
204
+ }
205
+
206
+ const coverageData = JSON.parse(readFileSync(coverageFile, "utf8"));
207
+ const total = coverageData.total;
208
+
209
+ return {
210
+ lines: {
211
+ total: total.lines.total,
212
+ covered: total.lines.covered,
213
+ percentage: total.lines.pct,
214
+ },
215
+ functions: {
216
+ total: total.functions.total,
217
+ covered: total.functions.covered,
218
+ percentage: total.functions.pct,
219
+ },
220
+ branches: {
221
+ total: total.branches.total,
222
+ covered: total.branches.covered,
223
+ percentage: total.branches.pct,
224
+ },
225
+ statements: {
226
+ total: total.statements.total,
227
+ covered: total.statements.covered,
228
+ percentage: total.statements.pct,
229
+ },
230
+ overall: Math.round(
231
+ (total.lines.pct +
232
+ total.functions.pct +
233
+ total.branches.pct +
234
+ total.statements.pct) /
235
+ 4,
236
+ ),
237
+ };
238
+ } catch (error) {
239
+ console.warn("Failed to generate coverage report:", error);
240
+ return {
241
+ lines: { total: 0, covered: 0, percentage: 0 },
242
+ functions: { total: 0, covered: 0, percentage: 0 },
243
+ branches: { total: 0, covered: 0, percentage: 0 },
244
+ statements: { total: 0, covered: 0, percentage: 0 },
245
+ overall: 0,
246
+ };
247
+ }
248
+ }
249
+
250
+ /**
251
+ * Generate comprehensive test report
252
+ */
253
+ private async generateComprehensiveReport(
254
+ results: TestResults,
255
+ ): Promise<void> {
256
+ const totalDuration = this.endTime - this.startTime;
257
+ const totalTests =
258
+ results.unit.passed +
259
+ results.unit.failed +
260
+ results.integration.passed +
261
+ results.integration.failed +
262
+ results.e2e.passed +
263
+ results.e2e.failed +
264
+ results.performance.passed +
265
+ results.performance.failed;
266
+
267
+ const totalPassed =
268
+ results.unit.passed +
269
+ results.integration.passed +
270
+ results.e2e.passed +
271
+ results.performance.passed;
272
+
273
+ const totalFailed =
274
+ results.unit.failed +
275
+ results.integration.failed +
276
+ results.e2e.failed +
277
+ results.performance.failed;
278
+
279
+ const overallSuccess =
280
+ results.unit.success &&
281
+ results.integration.success &&
282
+ results.e2e.success &&
283
+ results.performance.success;
284
+
285
+ const report = `
273
286
  # YNAB MCP Server - Comprehensive Test Report
274
287
 
275
288
  Generated: ${new Date().toISOString()}
@@ -280,7 +293,7 @@ Duration: ${totalDuration}ms
280
293
  - **Total Tests**: ${totalTests}
281
294
  - **Passed**: ${totalPassed}
282
295
  - **Failed**: ${totalFailed}
283
- - **Overall Success**: ${overallSuccess ? '✅ PASS' : '❌ FAIL'}
296
+ - **Overall Success**: ${overallSuccess ? "✅ PASS" : "❌ FAIL"}
284
297
 
285
298
  ## Test Suite Results
286
299
 
@@ -289,28 +302,28 @@ Duration: ${totalDuration}ms
289
302
  - Failed: ${results.unit.failed}
290
303
  - Skipped: ${results.unit.skipped}
291
304
  - Duration: ${results.unit.duration}ms
292
- - Status: ${results.unit.success ? '✅ PASS' : '❌ FAIL'}
305
+ - Status: ${results.unit.success ? "✅ PASS" : "❌ FAIL"}
293
306
 
294
307
  ### Integration Tests
295
308
  - Passed: ${results.integration.passed}
296
309
  - Failed: ${results.integration.failed}
297
310
  - Skipped: ${results.integration.skipped}
298
311
  - Duration: ${results.integration.duration}ms
299
- - Status: ${results.integration.success ? '✅ PASS' : '❌ FAIL'}
312
+ - Status: ${results.integration.success ? "✅ PASS" : "❌ FAIL"}
300
313
 
301
314
  ### End-to-End Tests
302
315
  - Passed: ${results.e2e.passed}
303
316
  - Failed: ${results.e2e.failed}
304
317
  - Skipped: ${results.e2e.skipped}
305
318
  - Duration: ${results.e2e.duration}ms
306
- - Status: ${results.e2e.success ? '✅ PASS' : '❌ FAIL'}
319
+ - Status: ${results.e2e.success ? "✅ PASS" : "❌ FAIL"}
307
320
 
308
321
  ### Performance Tests
309
322
  - Passed: ${results.performance.passed}
310
323
  - Failed: ${results.performance.failed}
311
324
  - Skipped: ${results.performance.skipped}
312
325
  - Duration: ${results.performance.duration}ms
313
- - Status: ${results.performance.success ? '✅ PASS' : '❌ FAIL'}
326
+ - Status: ${results.performance.success ? "✅ PASS" : "❌ FAIL"}
314
327
 
315
328
  ## Code Coverage
316
329
 
@@ -322,7 +335,7 @@ Duration: ${totalDuration}ms
322
335
 
323
336
  ## Coverage Status
324
337
 
325
- ${results.coverage.overall >= 80 ? '✅ Coverage target met (≥80%)' : '⚠️ Coverage below target (<80%)'}
338
+ ${results.coverage.overall >= 80 ? "✅ Coverage target met (≥80%)" : "⚠️ Coverage below target (<80%)"}
326
339
 
327
340
  ## Requirements Validation
328
341
 
@@ -387,15 +400,15 @@ This comprehensive test suite validates all requirements from the YNAB MCP Serve
387
400
  ## Recommendations
388
401
 
389
402
  ${
390
- overallSuccess
391
- ? '🎉 All tests passing! The YNAB MCP Server is ready for deployment.'
392
- : '⚠️ Some tests are failing. Please review the failed tests and fix issues before deployment.'
403
+ overallSuccess
404
+ ? "🎉 All tests passing! The YNAB MCP Server is ready for deployment."
405
+ : "⚠️ Some tests are failing. Please review the failed tests and fix issues before deployment."
393
406
  }
394
407
 
395
408
  ${
396
- results.coverage.overall < 80
397
- ? '📈 Consider adding more tests to improve code coverage above 80%.'
398
- : '✅ Code coverage meets the target threshold.'
409
+ results.coverage.overall < 80
410
+ ? "📈 Consider adding more tests to improve code coverage above 80%."
411
+ : "✅ Code coverage meets the target threshold."
399
412
  }
400
413
 
401
414
  ---
@@ -403,42 +416,48 @@ ${
403
416
  For detailed test results, check the individual test output files and coverage reports in the \`coverage/\` directory.
404
417
  `;
405
418
 
406
- // Write report to file
407
- writeFileSync('test-report.md', report);
408
-
409
- // Console output
410
- console.warn('\n' + '='.repeat(80));
411
- console.warn('📊 COMPREHENSIVE TEST REPORT');
412
- console.warn('='.repeat(80));
413
- console.warn(`Total Tests: ${totalTests} | Passed: ${totalPassed} | Failed: ${totalFailed}`);
414
- console.warn(`Coverage: ${results.coverage.overall}% | Duration: ${totalDuration}ms`);
415
- console.warn(`Status: ${overallSuccess ? '✅ ALL TESTS PASS' : '❌ SOME TESTS FAILED'}`);
416
- console.warn('='.repeat(80));
417
- console.warn(`📄 Detailed report saved to: test-report.md`);
418
- console.warn(`📊 Coverage report available at: coverage/index.html`);
419
- console.warn('='.repeat(80) + '\n');
420
- }
419
+ // Write report to file
420
+ writeFileSync("test-report.md", report);
421
+
422
+ // Console output
423
+ console.warn(`\n${"=".repeat(80)}`);
424
+ console.warn("📊 COMPREHENSIVE TEST REPORT");
425
+ console.warn("=".repeat(80));
426
+ console.warn(
427
+ `Total Tests: ${totalTests} | Passed: ${totalPassed} | Failed: ${totalFailed}`,
428
+ );
429
+ console.warn(
430
+ `Coverage: ${results.coverage.overall}% | Duration: ${totalDuration}ms`,
431
+ );
432
+ console.warn(
433
+ `Status: ${overallSuccess ? "✅ ALL TESTS PASS" : "❌ SOME TESTS FAILED"}`,
434
+ );
435
+ console.warn("=".repeat(80));
436
+ console.warn("📄 Detailed report saved to: test-report.md");
437
+ console.warn("📊 Coverage report available at: coverage/index.html");
438
+ console.warn(`${"=".repeat(80)}\n`);
439
+ }
421
440
  }
422
441
 
423
442
  /**
424
443
  * CLI runner
425
444
  */
426
445
  if (require.main === module) {
427
- const runner = new ComprehensiveTestRunner();
428
-
429
- runner
430
- .runAllTests()
431
- .then((results) => {
432
- const allPassed =
433
- results.unit.success &&
434
- results.integration.success &&
435
- results.e2e.success &&
436
- results.performance.success;
437
-
438
- process.exit(allPassed ? 0 : 1);
439
- })
440
- .catch((error) => {
441
- console.error('Test runner failed:', error);
442
- process.exit(1);
443
- });
446
+ const runner = new ComprehensiveTestRunner();
447
+
448
+ runner
449
+ .runAllTests()
450
+ .then((results) => {
451
+ const allPassed =
452
+ results.unit.success &&
453
+ results.integration.success &&
454
+ results.e2e.success &&
455
+ results.performance.success;
456
+
457
+ process.exit(allPassed ? 0 : 1);
458
+ })
459
+ .catch((error) => {
460
+ console.error("Test runner failed:", error);
461
+ process.exit(1);
462
+ });
444
463
  }