@dizzlkheinz/ynab-mcpb 0.18.3 → 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 (346) hide show
  1. package/CHANGELOG.md +17 -0
  2. package/CLAUDE.md +87 -8
  3. package/bin/ynab-mcp-server.cjs +2 -2
  4. package/bin/ynab-mcp-server.js +3 -3
  5. package/biome.json +39 -0
  6. package/dist/bundle/index.cjs +67 -67
  7. package/dist/index.d.ts +1 -1
  8. package/dist/index.js +27 -27
  9. package/dist/server/YNABMCPServer.d.ts +3 -4
  10. package/dist/server/YNABMCPServer.js +111 -116
  11. package/dist/server/budgetResolver.d.ts +6 -5
  12. package/dist/server/budgetResolver.js +46 -36
  13. package/dist/server/cacheKeys.js +6 -6
  14. package/dist/server/cacheManager.js +14 -11
  15. package/dist/server/completions.d.ts +2 -2
  16. package/dist/server/completions.js +20 -15
  17. package/dist/server/config.d.ts +10 -5
  18. package/dist/server/config.js +24 -7
  19. package/dist/server/deltaCache.d.ts +2 -2
  20. package/dist/server/deltaCache.js +22 -16
  21. package/dist/server/deltaCache.merge.d.ts +2 -2
  22. package/dist/server/diagnostics.d.ts +4 -4
  23. package/dist/server/diagnostics.js +38 -32
  24. package/dist/server/errorHandler.d.ts +5 -12
  25. package/dist/server/errorHandler.js +219 -217
  26. package/dist/server/prompts.d.ts +2 -2
  27. package/dist/server/prompts.js +45 -45
  28. package/dist/server/rateLimiter.js +4 -4
  29. package/dist/server/requestLogger.d.ts +1 -1
  30. package/dist/server/requestLogger.js +40 -35
  31. package/dist/server/resources.d.ts +3 -3
  32. package/dist/server/resources.js +55 -52
  33. package/dist/server/responseFormatter.js +6 -6
  34. package/dist/server/securityMiddleware.d.ts +2 -2
  35. package/dist/server/securityMiddleware.js +22 -20
  36. package/dist/server/serverKnowledgeStore.js +1 -1
  37. package/dist/server/toolRegistry.d.ts +3 -3
  38. package/dist/server/toolRegistry.js +47 -40
  39. package/dist/tools/__tests__/deltaTestUtils.d.ts +3 -3
  40. package/dist/tools/__tests__/deltaTestUtils.js +2 -2
  41. package/dist/tools/accountTools.d.ts +9 -8
  42. package/dist/tools/accountTools.js +47 -47
  43. package/dist/tools/adapters.d.ts +13 -8
  44. package/dist/tools/adapters.js +21 -11
  45. package/dist/tools/budgetTools.d.ts +8 -7
  46. package/dist/tools/budgetTools.js +22 -22
  47. package/dist/tools/categoryTools.d.ts +9 -8
  48. package/dist/tools/categoryTools.js +68 -59
  49. package/dist/tools/compareTransactions/formatter.d.ts +3 -3
  50. package/dist/tools/compareTransactions/formatter.js +9 -9
  51. package/dist/tools/compareTransactions/index.d.ts +6 -6
  52. package/dist/tools/compareTransactions/index.js +58 -43
  53. package/dist/tools/compareTransactions/matcher.d.ts +1 -1
  54. package/dist/tools/compareTransactions/matcher.js +28 -15
  55. package/dist/tools/compareTransactions/parser.d.ts +2 -2
  56. package/dist/tools/compareTransactions/parser.js +144 -138
  57. package/dist/tools/compareTransactions/types.d.ts +4 -4
  58. package/dist/tools/compareTransactions.d.ts +1 -1
  59. package/dist/tools/compareTransactions.js +1 -1
  60. package/dist/tools/deltaFetcher.d.ts +2 -2
  61. package/dist/tools/deltaFetcher.js +16 -15
  62. package/dist/tools/deltaSupport.d.ts +4 -4
  63. package/dist/tools/deltaSupport.js +35 -41
  64. package/dist/tools/exportTransactions.d.ts +5 -4
  65. package/dist/tools/exportTransactions.js +61 -59
  66. package/dist/tools/monthTools.d.ts +7 -6
  67. package/dist/tools/monthTools.js +31 -29
  68. package/dist/tools/payeeTools.d.ts +7 -6
  69. package/dist/tools/payeeTools.js +28 -28
  70. package/dist/tools/reconcileAdapter.d.ts +2 -2
  71. package/dist/tools/reconcileAdapter.js +21 -11
  72. package/dist/tools/reconciliation/analyzer.d.ts +4 -4
  73. package/dist/tools/reconciliation/analyzer.js +136 -57
  74. package/dist/tools/reconciliation/csvParser.d.ts +3 -3
  75. package/dist/tools/reconciliation/csvParser.js +128 -104
  76. package/dist/tools/reconciliation/executor.d.ts +4 -4
  77. package/dist/tools/reconciliation/executor.js +148 -109
  78. package/dist/tools/reconciliation/index.d.ts +10 -10
  79. package/dist/tools/reconciliation/index.js +96 -83
  80. package/dist/tools/reconciliation/matcher.d.ts +3 -3
  81. package/dist/tools/reconciliation/matcher.js +17 -16
  82. package/dist/tools/reconciliation/payeeNormalizer.js +19 -8
  83. package/dist/tools/reconciliation/recommendationEngine.d.ts +1 -1
  84. package/dist/tools/reconciliation/recommendationEngine.js +40 -40
  85. package/dist/tools/reconciliation/reportFormatter.d.ts +2 -2
  86. package/dist/tools/reconciliation/reportFormatter.js +79 -54
  87. package/dist/tools/reconciliation/signDetector.d.ts +1 -1
  88. package/dist/tools/reconciliation/types.d.ts +19 -16
  89. package/dist/tools/reconciliation/ynabAdapter.d.ts +2 -2
  90. package/dist/tools/schemas/common.d.ts +1 -1
  91. package/dist/tools/schemas/common.js +1 -1
  92. package/dist/tools/schemas/outputs/accountOutputs.d.ts +1 -1
  93. package/dist/tools/schemas/outputs/accountOutputs.js +24 -18
  94. package/dist/tools/schemas/outputs/budgetOutputs.d.ts +1 -1
  95. package/dist/tools/schemas/outputs/budgetOutputs.js +14 -11
  96. package/dist/tools/schemas/outputs/categoryOutputs.d.ts +1 -1
  97. package/dist/tools/schemas/outputs/categoryOutputs.js +49 -29
  98. package/dist/tools/schemas/outputs/comparisonOutputs.d.ts +1 -1
  99. package/dist/tools/schemas/outputs/comparisonOutputs.js +12 -12
  100. package/dist/tools/schemas/outputs/index.d.ts +14 -14
  101. package/dist/tools/schemas/outputs/index.js +14 -14
  102. package/dist/tools/schemas/outputs/monthOutputs.d.ts +1 -1
  103. package/dist/tools/schemas/outputs/monthOutputs.js +56 -41
  104. package/dist/tools/schemas/outputs/payeeOutputs.d.ts +1 -1
  105. package/dist/tools/schemas/outputs/payeeOutputs.js +10 -10
  106. package/dist/tools/schemas/outputs/reconciliationOutputs.d.ts +2 -2
  107. package/dist/tools/schemas/outputs/reconciliationOutputs.js +45 -45
  108. package/dist/tools/schemas/outputs/transactionMutationOutputs.d.ts +1 -1
  109. package/dist/tools/schemas/outputs/transactionMutationOutputs.js +28 -22
  110. package/dist/tools/schemas/outputs/transactionOutputs.d.ts +1 -1
  111. package/dist/tools/schemas/outputs/transactionOutputs.js +43 -35
  112. package/dist/tools/schemas/outputs/utilityOutputs.d.ts +1 -1
  113. package/dist/tools/schemas/outputs/utilityOutputs.js +5 -3
  114. package/dist/tools/schemas/shared/commonOutputs.d.ts +1 -1
  115. package/dist/tools/schemas/shared/commonOutputs.js +15 -9
  116. package/dist/tools/transactionReadTools.d.ts +11 -0
  117. package/dist/tools/transactionReadTools.js +202 -0
  118. package/dist/tools/transactionSchemas.d.ts +309 -0
  119. package/dist/tools/transactionSchemas.js +235 -0
  120. package/dist/tools/transactionTools.d.ts +6 -302
  121. package/dist/tools/transactionTools.js +7 -2054
  122. package/dist/tools/transactionUtils.d.ts +31 -0
  123. package/dist/tools/transactionUtils.js +364 -0
  124. package/dist/tools/transactionWriteTools.d.ts +20 -0
  125. package/dist/tools/transactionWriteTools.js +1342 -0
  126. package/dist/tools/utilityTools.d.ts +5 -4
  127. package/dist/tools/utilityTools.js +11 -11
  128. package/dist/types/index.d.ts +7 -7
  129. package/dist/types/index.js +6 -6
  130. package/dist/types/reconciliation.d.ts +1 -1
  131. package/dist/types/toolRegistration.d.ts +14 -12
  132. package/dist/utils/amountUtils.js +1 -1
  133. package/dist/utils/dateUtils.js +4 -4
  134. package/dist/utils/errors.d.ts +3 -3
  135. package/dist/utils/errors.js +4 -4
  136. package/dist/utils/money.d.ts +2 -2
  137. package/dist/utils/money.js +8 -8
  138. package/dist/utils/validationError.d.ts +1 -1
  139. package/dist/utils/validationError.js +1 -1
  140. package/docs/assets/examples/reconciliation-with-recommendations.json +66 -66
  141. package/docs/assets/schemas/reconciliation-v2.json +360 -336
  142. package/docs/plans/2025-12-25-transaction-tools-refactor-design.md +211 -0
  143. package/docs/plans/2025-12-25-transaction-tools-refactor.md +905 -0
  144. package/esbuild.config.mjs +53 -50
  145. package/meta.json +12548 -12548
  146. package/package.json +98 -109
  147. package/scripts/analyze-bundle.mjs +33 -30
  148. package/scripts/create-pr-description.js +169 -120
  149. package/scripts/run-all-tests.js +205 -0
  150. package/scripts/run-domain-integration-tests.js +28 -18
  151. package/scripts/run-generate-mcpb.js +19 -17
  152. package/scripts/run-throttled-integration-tests.js +92 -83
  153. package/scripts/test-delta-params.mjs +149 -120
  154. package/scripts/test-recommendations.ts +36 -32
  155. package/scripts/tmpTransaction.ts +80 -43
  156. package/scripts/validate-env.js +98 -91
  157. package/scripts/verify-build.js +78 -76
  158. package/src/__tests__/comprehensive.integration.test.ts +1281 -1154
  159. package/src/__tests__/performance.test.ts +723 -671
  160. package/src/__tests__/setup.ts +442 -395
  161. package/src/__tests__/smoke.e2e.test.ts +41 -39
  162. package/src/__tests__/testRunner.ts +314 -295
  163. package/src/__tests__/testUtils.ts +456 -364
  164. package/src/__tests__/tools/reconciliation/csvParser.integration.test.ts +109 -107
  165. package/src/__tests__/tools/reconciliation/real-world.integration.test.ts +41 -41
  166. package/src/index.ts +68 -59
  167. package/src/server/CLAUDE.md +480 -0
  168. package/src/server/YNABMCPServer.ts +821 -794
  169. package/src/server/__tests__/YNABMCPServer.integration.test.ts +929 -893
  170. package/src/server/__tests__/YNABMCPServer.test.ts +903 -899
  171. package/src/server/__tests__/budgetResolver.test.ts +466 -423
  172. package/src/server/__tests__/cacheManager.test.ts +891 -874
  173. package/src/server/__tests__/completions.integration.test.ts +115 -106
  174. package/src/server/__tests__/completions.test.ts +334 -313
  175. package/src/server/__tests__/config.test.ts +98 -86
  176. package/src/server/__tests__/deltaCache.merge.test.ts +774 -703
  177. package/src/server/__tests__/deltaCache.swr.test.ts +198 -153
  178. package/src/server/__tests__/deltaCache.test.ts +946 -759
  179. package/src/server/__tests__/diagnostics.test.ts +825 -792
  180. package/src/server/__tests__/errorHandler.integration.test.ts +512 -462
  181. package/src/server/__tests__/errorHandler.test.ts +402 -397
  182. package/src/server/__tests__/prompts.test.ts +424 -347
  183. package/src/server/__tests__/rateLimiter.test.ts +313 -309
  184. package/src/server/__tests__/requestLogger.test.ts +443 -403
  185. package/src/server/__tests__/resources.template.test.ts +196 -185
  186. package/src/server/__tests__/resources.test.ts +294 -288
  187. package/src/server/__tests__/security.integration.test.ts +487 -421
  188. package/src/server/__tests__/securityMiddleware.test.ts +519 -444
  189. package/src/server/__tests__/server-startup.integration.test.ts +509 -490
  190. package/src/server/__tests__/serverKnowledgeStore.test.ts +174 -173
  191. package/src/server/__tests__/toolRegistration.test.ts +239 -210
  192. package/src/server/__tests__/toolRegistry.test.ts +907 -845
  193. package/src/server/budgetResolver.ts +221 -181
  194. package/src/server/cacheKeys.ts +6 -6
  195. package/src/server/cacheManager.ts +498 -484
  196. package/src/server/completions.ts +267 -243
  197. package/src/server/config.ts +35 -14
  198. package/src/server/deltaCache.merge.ts +146 -128
  199. package/src/server/deltaCache.ts +352 -309
  200. package/src/server/diagnostics.ts +257 -242
  201. package/src/server/errorHandler.ts +747 -744
  202. package/src/server/prompts.ts +181 -176
  203. package/src/server/rateLimiter.ts +131 -129
  204. package/src/server/requestLogger.ts +350 -322
  205. package/src/server/resources.ts +442 -374
  206. package/src/server/responseFormatter.ts +41 -37
  207. package/src/server/securityMiddleware.ts +223 -205
  208. package/src/server/serverKnowledgeStore.ts +67 -67
  209. package/src/server/toolRegistry.ts +508 -474
  210. package/src/tools/CLAUDE.md +604 -0
  211. package/src/tools/__tests__/accountTools.delta.integration.test.ts +128 -111
  212. package/src/tools/__tests__/accountTools.integration.test.ts +129 -111
  213. package/src/tools/__tests__/accountTools.test.ts +685 -638
  214. package/src/tools/__tests__/adapters.test.ts +142 -108
  215. package/src/tools/__tests__/budgetTools.delta.integration.test.ts +73 -73
  216. package/src/tools/__tests__/budgetTools.integration.test.ts +132 -124
  217. package/src/tools/__tests__/budgetTools.test.ts +442 -413
  218. package/src/tools/__tests__/categoryTools.delta.integration.test.ts +76 -68
  219. package/src/tools/__tests__/categoryTools.integration.test.ts +314 -288
  220. package/src/tools/__tests__/categoryTools.test.ts +656 -625
  221. package/src/tools/__tests__/compareTransactions/formatter.test.ts +535 -462
  222. package/src/tools/__tests__/compareTransactions/index.test.ts +378 -358
  223. package/src/tools/__tests__/compareTransactions/matcher.test.ts +497 -398
  224. package/src/tools/__tests__/compareTransactions/parser.test.ts +765 -747
  225. package/src/tools/__tests__/compareTransactions.test.ts +352 -332
  226. package/src/tools/__tests__/compareTransactions.window.test.ts +150 -146
  227. package/src/tools/__tests__/deltaFetcher.scheduled.integration.test.ts +69 -65
  228. package/src/tools/__tests__/deltaFetcher.test.ts +325 -265
  229. package/src/tools/__tests__/deltaSupport.test.ts +211 -184
  230. package/src/tools/__tests__/deltaTestUtils.ts +37 -33
  231. package/src/tools/__tests__/exportTransactions.test.ts +205 -200
  232. package/src/tools/__tests__/monthTools.delta.integration.test.ts +68 -68
  233. package/src/tools/__tests__/monthTools.integration.test.ts +178 -166
  234. package/src/tools/__tests__/monthTools.test.ts +561 -512
  235. package/src/tools/__tests__/payeeTools.delta.integration.test.ts +68 -68
  236. package/src/tools/__tests__/payeeTools.integration.test.ts +158 -142
  237. package/src/tools/__tests__/payeeTools.test.ts +486 -434
  238. package/src/tools/__tests__/transactionSchemas.test.ts +1204 -0
  239. package/src/tools/__tests__/transactionTools.integration.test.ts +875 -825
  240. package/src/tools/__tests__/transactionTools.test.ts +4923 -4366
  241. package/src/tools/__tests__/transactionUtils.test.ts +1016 -0
  242. package/src/tools/__tests__/utilityTools.integration.test.ts +32 -32
  243. package/src/tools/__tests__/utilityTools.test.ts +68 -58
  244. package/src/tools/accountTools.ts +293 -271
  245. package/src/tools/adapters.ts +120 -63
  246. package/src/tools/budgetTools.ts +121 -116
  247. package/src/tools/categoryTools.ts +379 -339
  248. package/src/tools/compareTransactions/formatter.ts +131 -119
  249. package/src/tools/compareTransactions/index.ts +249 -214
  250. package/src/tools/compareTransactions/matcher.ts +259 -209
  251. package/src/tools/compareTransactions/parser.ts +517 -487
  252. package/src/tools/compareTransactions/types.ts +38 -38
  253. package/src/tools/compareTransactions.ts +1 -1
  254. package/src/tools/deltaFetcher.ts +281 -260
  255. package/src/tools/deltaSupport.ts +264 -259
  256. package/src/tools/exportTransactions.ts +230 -218
  257. package/src/tools/monthTools.ts +180 -165
  258. package/src/tools/payeeTools.ts +152 -140
  259. package/src/tools/reconcileAdapter.ts +297 -246
  260. package/src/tools/reconciliation/CLAUDE.md +506 -0
  261. package/src/tools/reconciliation/__tests__/adapter.causes.test.ts +135 -112
  262. package/src/tools/reconciliation/__tests__/adapter.test.ts +249 -227
  263. package/src/tools/reconciliation/__tests__/analyzer.test.ts +408 -335
  264. package/src/tools/reconciliation/__tests__/csvParser.test.ts +71 -69
  265. package/src/tools/reconciliation/__tests__/executor.integration.test.ts +348 -323
  266. package/src/tools/reconciliation/__tests__/executor.progress.test.ts +503 -457
  267. package/src/tools/reconciliation/__tests__/executor.test.ts +898 -831
  268. package/src/tools/reconciliation/__tests__/matcher.test.ts +667 -663
  269. package/src/tools/reconciliation/__tests__/payeeNormalizer.test.ts +296 -276
  270. package/src/tools/reconciliation/__tests__/recommendationEngine.integration.test.ts +692 -624
  271. package/src/tools/reconciliation/__tests__/recommendationEngine.test.ts +1008 -986
  272. package/src/tools/reconciliation/__tests__/reconciliation.delta.integration.test.ts +187 -146
  273. package/src/tools/reconciliation/__tests__/reportFormatter.test.ts +583 -530
  274. package/src/tools/reconciliation/__tests__/scenarios/adapterCurrency.scenario.test.ts +75 -71
  275. package/src/tools/reconciliation/__tests__/scenarios/extremes.scenario.test.ts +70 -58
  276. package/src/tools/reconciliation/__tests__/scenarios/repeatAmount.scenario.test.ts +102 -88
  277. package/src/tools/reconciliation/__tests__/schemaUrl.test.ts +58 -43
  278. package/src/tools/reconciliation/__tests__/signDetector.test.ts +209 -206
  279. package/src/tools/reconciliation/__tests__/ynabAdapter.test.ts +66 -60
  280. package/src/tools/reconciliation/analyzer.ts +582 -406
  281. package/src/tools/reconciliation/csvParser.ts +656 -609
  282. package/src/tools/reconciliation/executor.ts +1290 -1128
  283. package/src/tools/reconciliation/index.ts +580 -528
  284. package/src/tools/reconciliation/matcher.ts +256 -240
  285. package/src/tools/reconciliation/payeeNormalizer.ts +92 -78
  286. package/src/tools/reconciliation/recommendationEngine.ts +357 -345
  287. package/src/tools/reconciliation/reportFormatter.ts +349 -276
  288. package/src/tools/reconciliation/signDetector.ts +89 -83
  289. package/src/tools/reconciliation/types.ts +164 -153
  290. package/src/tools/reconciliation/ynabAdapter.ts +17 -15
  291. package/src/tools/schemas/CLAUDE.md +546 -0
  292. package/src/tools/schemas/common.ts +1 -1
  293. package/src/tools/schemas/outputs/__tests__/accountOutputs.test.ts +410 -409
  294. package/src/tools/schemas/outputs/__tests__/budgetOutputs.test.ts +305 -299
  295. package/src/tools/schemas/outputs/__tests__/categoryOutputs.test.ts +431 -430
  296. package/src/tools/schemas/outputs/__tests__/comparisonOutputs.test.ts +510 -495
  297. package/src/tools/schemas/outputs/__tests__/dateValidation.test.ts +179 -153
  298. package/src/tools/schemas/outputs/__tests__/discrepancyDirection.test.ts +293 -254
  299. package/src/tools/schemas/outputs/__tests__/monthOutputs.test.ts +457 -457
  300. package/src/tools/schemas/outputs/__tests__/payeeOutputs.test.ts +362 -356
  301. package/src/tools/schemas/outputs/__tests__/reconciliationOutputs.test.ts +402 -399
  302. package/src/tools/schemas/outputs/__tests__/transactionMutationSchemas.test.ts +225 -211
  303. package/src/tools/schemas/outputs/__tests__/transactionOutputs.test.ts +457 -454
  304. package/src/tools/schemas/outputs/__tests__/utilityOutputs.test.ts +316 -315
  305. package/src/tools/schemas/outputs/accountOutputs.ts +40 -34
  306. package/src/tools/schemas/outputs/budgetOutputs.ts +24 -19
  307. package/src/tools/schemas/outputs/categoryOutputs.ts +76 -56
  308. package/src/tools/schemas/outputs/comparisonOutputs.ts +192 -169
  309. package/src/tools/schemas/outputs/index.ts +163 -163
  310. package/src/tools/schemas/outputs/monthOutputs.ts +95 -80
  311. package/src/tools/schemas/outputs/payeeOutputs.ts +18 -18
  312. package/src/tools/schemas/outputs/reconciliationOutputs.ts +386 -373
  313. package/src/tools/schemas/outputs/transactionMutationOutputs.ts +259 -231
  314. package/src/tools/schemas/outputs/transactionOutputs.ts +81 -71
  315. package/src/tools/schemas/outputs/utilityOutputs.ts +90 -84
  316. package/src/tools/schemas/shared/commonOutputs.ts +27 -19
  317. package/src/tools/toolCategories.ts +114 -114
  318. package/src/tools/transactionReadTools.ts +327 -0
  319. package/src/tools/transactionSchemas.ts +484 -0
  320. package/src/tools/transactionTools.ts +107 -2990
  321. package/src/tools/transactionUtils.ts +621 -0
  322. package/src/tools/transactionWriteTools.ts +2110 -0
  323. package/src/tools/utilityTools.ts +46 -41
  324. package/src/types/CLAUDE.md +477 -0
  325. package/src/types/__tests__/index.test.ts +51 -51
  326. package/src/types/index.ts +43 -39
  327. package/src/types/integration-tests.d.ts +26 -26
  328. package/src/types/reconciliation.ts +29 -29
  329. package/src/types/toolAnnotations.ts +30 -30
  330. package/src/types/toolRegistration.ts +43 -32
  331. package/src/utils/CLAUDE.md +508 -0
  332. package/src/utils/__tests__/dateUtils.test.ts +174 -168
  333. package/src/utils/__tests__/money.test.ts +193 -187
  334. package/src/utils/amountUtils.ts +5 -5
  335. package/src/utils/baseError.ts +5 -5
  336. package/src/utils/dateUtils.ts +29 -26
  337. package/src/utils/errors.ts +14 -14
  338. package/src/utils/money.ts +66 -52
  339. package/src/utils/validationError.ts +1 -1
  340. package/tsconfig.json +29 -29
  341. package/tsconfig.prod.json +16 -16
  342. package/vitest-reporters/split-json-reporter.ts +247 -204
  343. package/vitest.config.ts +99 -95
  344. package/.prettierignore +0 -10
  345. package/.prettierrc.json +0 -10
  346. package/eslint.config.js +0 -49
@@ -1,29 +1,31 @@
1
1
  #!/usr/bin/env node
2
- import { spawnSync } from 'node:child_process';
3
- import process from 'node:process';
2
+ import { spawnSync } from "node:child_process";
3
+ import process from "node:process";
4
4
 
5
- if (process.env['SKIP_MCPB'] === '1') {
6
- console.log('Skipping MCPB generation because SKIP_MCPB=1');
7
- process.exit(0);
5
+ if (process.env.SKIP_MCPB === "1") {
6
+ console.log("Skipping MCPB generation because SKIP_MCPB=1");
7
+ process.exit(0);
8
8
  }
9
9
 
10
10
  const commands = [];
11
- if (process.platform === 'win32') {
12
- commands.push([
13
- 'powershell',
14
- ['-ExecutionPolicy', 'Bypass', '-File', 'scripts/generate-mcpb.ps1'],
15
- ]);
16
- commands.push(['pwsh', ['-File', 'scripts/generate-mcpb.ps1']]);
11
+ if (process.platform === "win32") {
12
+ commands.push([
13
+ "powershell",
14
+ ["-ExecutionPolicy", "Bypass", "-File", "scripts/generate-mcpb.ps1"],
15
+ ]);
16
+ commands.push(["pwsh", ["-File", "scripts/generate-mcpb.ps1"]]);
17
17
  } else {
18
- commands.push(['pwsh', ['-File', 'scripts/generate-mcpb.ps1']]);
18
+ commands.push(["pwsh", ["-File", "scripts/generate-mcpb.ps1"]]);
19
19
  }
20
20
 
21
21
  for (const [cmd, args] of commands) {
22
- const result = spawnSync(cmd, args, { stdio: 'inherit' });
23
- if (result.status === 0) {
24
- process.exit(0);
25
- }
22
+ const result = spawnSync(cmd, args, { stdio: "inherit" });
23
+ if (result.status === 0) {
24
+ process.exit(0);
25
+ }
26
26
  }
27
27
 
28
- console.log('PowerShell is not available on this runner; skipping MCPB generation.');
28
+ console.log(
29
+ "PowerShell is not available on this runner; skipping MCPB generation.",
30
+ );
29
31
  process.exit(0);
@@ -2,21 +2,25 @@
2
2
  /**
3
3
  * Runs the full integration suite with simple rate-limit-aware throttling.
4
4
  */
5
- import { spawn } from 'node:child_process';
6
- import { readdirSync } from 'node:fs';
7
- import path from 'node:path';
5
+ import { spawn } from "node:child_process";
6
+ import { readdirSync } from "node:fs";
7
+ import path from "node:path";
8
8
 
9
- const RATE_LIMIT = Number(process.env['RATE_LIMIT_PER_HOUR'] ?? 200);
10
- const RATE_LIMIT_BUFFER = Number(process.env['RATE_LIMIT_BUFFER'] ?? 20);
11
- const RATE_LIMIT_WINDOW_MS = Number(process.env['RATE_LIMIT_WINDOW_MS'] ?? 60 * 60 * 1000);
12
- const MAX_WAIT_MS = Number(process.env['RATE_LIMIT_MAX_WAIT_MS'] ?? 60 * 60 * 1000);
9
+ const RATE_LIMIT = Number(process.env.RATE_LIMIT_PER_HOUR ?? 200);
10
+ const RATE_LIMIT_BUFFER = Number(process.env.RATE_LIMIT_BUFFER ?? 20);
11
+ const RATE_LIMIT_WINDOW_MS = Number(
12
+ process.env.RATE_LIMIT_WINDOW_MS ?? 60 * 60 * 1000,
13
+ );
14
+ const MAX_WAIT_MS = Number(
15
+ process.env.RATE_LIMIT_MAX_WAIT_MS ?? 60 * 60 * 1000,
16
+ );
13
17
  const projectRoot = process.cwd();
14
18
 
15
- const testFiles = collectIntegrationTests(path.join(projectRoot, 'src'));
19
+ const testFiles = collectIntegrationTests(path.join(projectRoot, "src"));
16
20
  const toPosixPath = (value) => value.split(path.sep).join(path.posix.sep);
17
21
  if (testFiles.length === 0) {
18
- console.error('No integration test files found.');
19
- process.exit(1);
22
+ console.error("No integration test files found.");
23
+ process.exit(1);
20
24
  }
21
25
 
22
26
  const requestHistory = [];
@@ -24,99 +28,104 @@ const requestHistory = [];
24
28
  await runSequentially(testFiles);
25
29
 
26
30
  async function runSequentially(files) {
27
- for (const filePath of files) {
28
- const estimatedCalls = estimateCalls(filePath);
29
- await throttleIfNeeded(estimatedCalls);
30
- const relativePath = path.relative(projectRoot, filePath);
31
- console.log(`▶️ Running ${relativePath} (estimated ${estimatedCalls} API calls)`);
32
- await runVitestFile(relativePath);
33
- requestHistory.push({ timestamp: Date.now(), calls: estimatedCalls });
34
- }
31
+ for (const filePath of files) {
32
+ const estimatedCalls = estimateCalls(filePath);
33
+ await throttleIfNeeded(estimatedCalls);
34
+ const relativePath = path.relative(projectRoot, filePath);
35
+ console.log(
36
+ `▶️ Running ${relativePath} (estimated ${estimatedCalls} API calls)`,
37
+ );
38
+ await runVitestFile(relativePath);
39
+ requestHistory.push({ timestamp: Date.now(), calls: estimatedCalls });
40
+ }
35
41
  }
36
42
 
37
43
  function collectIntegrationTests(dir) {
38
- const entries = readdirSync(dir, { withFileTypes: true });
39
- const files = [];
40
- for (const entry of entries) {
41
- const fullPath = path.join(dir, entry.name);
42
- if (entry.isDirectory()) {
43
- files.push(...collectIntegrationTests(fullPath));
44
- } else if (entry.isFile() && entry.name.endsWith('.integration.test.ts')) {
45
- files.push(fullPath);
46
- }
47
- }
48
- return files.sort((a, b) => a.localeCompare(b));
44
+ const entries = readdirSync(dir, { withFileTypes: true });
45
+ const files = [];
46
+ for (const entry of entries) {
47
+ const fullPath = path.join(dir, entry.name);
48
+ if (entry.isDirectory()) {
49
+ files.push(...collectIntegrationTests(fullPath));
50
+ } else if (entry.isFile() && entry.name.endsWith(".integration.test.ts")) {
51
+ files.push(fullPath);
52
+ }
53
+ }
54
+ return files.sort((a, b) => a.localeCompare(b));
49
55
  }
50
56
 
51
57
  async function throttleIfNeeded(nextCalls) {
52
- pruneHistory();
53
- while (getRecentCalls() + nextCalls > RATE_LIMIT - RATE_LIMIT_BUFFER) {
54
- const nextWindowTime = requestHistory[0]?.timestamp ?? Date.now();
55
- const waitUntil = nextWindowTime + RATE_LIMIT_WINDOW_MS;
56
- const waitMs = Math.min(Math.max(waitUntil - Date.now(), 1000), MAX_WAIT_MS);
57
- const minutes = Math.max(1, Math.round(waitMs / 60000));
58
- console.warn(
59
- `⏳ Approaching rate limit (${getRecentCalls()}/${RATE_LIMIT}). Waiting ${minutes} minute${
60
- minutes === 1 ? '' : 's'
61
- }...`,
62
- );
63
- await sleep(waitMs);
64
- pruneHistory();
65
- }
58
+ pruneHistory();
59
+ while (getRecentCalls() + nextCalls > RATE_LIMIT - RATE_LIMIT_BUFFER) {
60
+ const nextWindowTime = requestHistory[0]?.timestamp ?? Date.now();
61
+ const waitUntil = nextWindowTime + RATE_LIMIT_WINDOW_MS;
62
+ const waitMs = Math.min(
63
+ Math.max(waitUntil - Date.now(), 1000),
64
+ MAX_WAIT_MS,
65
+ );
66
+ const minutes = Math.max(1, Math.round(waitMs / 60000));
67
+ console.warn(
68
+ `⏳ Approaching rate limit (${getRecentCalls()}/${RATE_LIMIT}). Waiting ${minutes} minute${
69
+ minutes === 1 ? "" : "s"
70
+ }...`,
71
+ );
72
+ await sleep(waitMs);
73
+ pruneHistory();
74
+ }
66
75
  }
67
76
 
68
77
  function pruneHistory() {
69
- const cutoff = Date.now() - RATE_LIMIT_WINDOW_MS;
70
- while (requestHistory.length && requestHistory[0].timestamp < cutoff) {
71
- requestHistory.shift();
72
- }
78
+ const cutoff = Date.now() - RATE_LIMIT_WINDOW_MS;
79
+ while (requestHistory.length && requestHistory[0].timestamp < cutoff) {
80
+ requestHistory.shift();
81
+ }
73
82
  }
74
83
 
75
84
  function getRecentCalls() {
76
- return requestHistory.reduce((sum, entry) => sum + entry.calls, 0);
85
+ return requestHistory.reduce((sum, entry) => sum + entry.calls, 0);
77
86
  }
78
87
 
79
88
  function estimateCalls(filePath) {
80
- const name = filePath.toLowerCase();
81
- if (name.includes('delta')) return 15;
82
- if (name.includes('reconciliation')) return 25;
83
- if (name.includes('transaction')) return 12;
84
- if (name.includes('budget')) return 8;
85
- if (name.includes('account')) return 8;
86
- if (name.includes('payee')) return 10;
87
- if (name.includes('category')) return 10;
88
- if (name.includes('month')) return 10;
89
- return 10;
89
+ const name = filePath.toLowerCase();
90
+ if (name.includes("delta")) return 15;
91
+ if (name.includes("reconciliation")) return 25;
92
+ if (name.includes("transaction")) return 12;
93
+ if (name.includes("budget")) return 8;
94
+ if (name.includes("account")) return 8;
95
+ if (name.includes("payee")) return 10;
96
+ if (name.includes("category")) return 10;
97
+ if (name.includes("month")) return 10;
98
+ return 10;
90
99
  }
91
100
 
92
101
  async function runVitestFile(testFile) {
93
- const normalized = toPosixPath(testFile);
94
- const vitestBin = path.join(
95
- projectRoot,
96
- 'node_modules',
97
- '.bin',
98
- process.platform === 'win32' ? 'vitest.cmd' : 'vitest',
99
- );
100
- const vitestArgs = ['run', '--project', 'integration:full', normalized];
101
- const child = spawn(vitestBin, vitestArgs, {
102
- stdio: 'inherit',
103
- shell: process.platform === 'win32',
104
- env: {
105
- ...process.env,
106
- INTEGRATION_TEST_TIER: 'full',
107
- INTEGRATION_TEST_DOMAINS: '',
108
- },
109
- });
102
+ const normalized = toPosixPath(testFile);
103
+ const vitestBin = path.join(
104
+ projectRoot,
105
+ "node_modules",
106
+ ".bin",
107
+ process.platform === "win32" ? "vitest.cmd" : "vitest",
108
+ );
109
+ const vitestArgs = ["run", "--project", "integration:full", normalized];
110
+ const child = spawn(vitestBin, vitestArgs, {
111
+ stdio: "inherit",
112
+ shell: process.platform === "win32",
113
+ env: {
114
+ ...process.env,
115
+ INTEGRATION_TEST_TIER: "full",
116
+ INTEGRATION_TEST_DOMAINS: "",
117
+ },
118
+ });
110
119
 
111
- await new Promise((resolve, reject) => {
112
- child.on('close', (code) => {
113
- if (code === 0) resolve();
114
- else reject(new Error(`Vitest exited with code ${code}`));
115
- });
116
- child.on('error', reject);
117
- });
120
+ await new Promise((resolve, reject) => {
121
+ child.on("close", (code) => {
122
+ if (code === 0) resolve();
123
+ else reject(new Error(`Vitest exited with code ${code}`));
124
+ });
125
+ child.on("error", reject);
126
+ });
118
127
  }
119
128
 
120
129
  function sleep(ms) {
121
- return new Promise((resolve) => setTimeout(resolve, ms));
130
+ return new Promise((resolve) => setTimeout(resolve, ms));
122
131
  }
@@ -1,10 +1,10 @@
1
- import * as ynab from 'ynab';
1
+ import * as ynab from "ynab";
2
2
 
3
3
  const ACCESS_TOKEN = process.env.YNAB_ACCESS_TOKEN;
4
4
 
5
5
  if (!ACCESS_TOKEN) {
6
- console.error('Missing YNAB_ACCESS_TOKEN environment variable.');
7
- process.exit(1);
6
+ console.error("Missing YNAB_ACCESS_TOKEN environment variable.");
7
+ process.exit(1);
8
8
  }
9
9
 
10
10
  const ynabAPI = new ynab.API(ACCESS_TOKEN);
@@ -12,129 +12,158 @@ const ynabAPI = new ynab.API(ACCESS_TOKEN);
12
12
  const results = [];
13
13
 
14
14
  function recordResult(name, signature, supported, notes, error) {
15
- results.push({ name, signature, supported, notes, error: error?.message ?? null });
16
- const status = supported ? '✓' : '✗';
17
- const suffix = notes ? ` - ${notes}` : '';
18
- console.log(`${status} ${name} (${signature})${suffix}`);
19
- if (error) {
20
- console.log(` Error: ${error.message}`);
21
- }
15
+ results.push({
16
+ name,
17
+ signature,
18
+ supported,
19
+ notes,
20
+ error: error?.message ?? null,
21
+ });
22
+ const status = supported ? "✓" : "✗";
23
+ const suffix = notes ? ` - ${notes}` : "";
24
+ console.log(`${status} ${name} (${signature})${suffix}`);
25
+ if (error) {
26
+ console.log(` Error: ${error.message}`);
27
+ }
22
28
  }
23
29
 
24
- async function verifySimpleEndpoint({ name, signature, fetchFull, fetchDelta }) {
25
- try {
26
- const full = await fetchFull();
27
- const knowledge = full?.data?.server_knowledge;
28
- if (typeof knowledge !== 'number') {
29
- throw new Error('Response missing server_knowledge');
30
- }
31
-
32
- await fetchDelta(knowledge);
33
- recordResult(name, signature, true, `server_knowledge=${knowledge}`);
34
- } catch (error) {
35
- recordResult(name, signature, false, '', error);
36
- }
30
+ async function verifySimpleEndpoint({
31
+ name,
32
+ signature,
33
+ fetchFull,
34
+ fetchDelta,
35
+ }) {
36
+ try {
37
+ const full = await fetchFull();
38
+ const knowledge = full?.data?.server_knowledge;
39
+ if (typeof knowledge !== "number") {
40
+ throw new Error("Response missing server_knowledge");
41
+ }
42
+
43
+ await fetchDelta(knowledge);
44
+ recordResult(name, signature, true, `server_knowledge=${knowledge}`);
45
+ } catch (error) {
46
+ recordResult(name, signature, false, "", error);
47
+ }
37
48
  }
38
49
 
39
50
  async function main() {
40
- console.log('Verifying YNAB SDK delta request signatures...\n');
41
- const budgetsResponse = await ynabAPI.budgets.getBudgets();
42
- const budget = budgetsResponse?.data?.budgets?.[0];
43
- if (!budget) {
44
- throw new Error('No budget available to test.');
45
- }
46
- const budgetId = budget.id;
47
- console.log(`Using budget: ${budget.name} (${budgetId})\n`);
48
-
49
- // Budgets API
50
- await verifySimpleEndpoint({
51
- name: 'budgets.getBudgetById',
52
- signature: 'getBudgetById(budgetId, lastKnowledge?)',
53
- fetchFull: () => ynabAPI.budgets.getBudgetById(budgetId),
54
- fetchDelta: (knowledge) => ynabAPI.budgets.getBudgetById(budgetId, knowledge),
55
- });
56
-
57
- // Accounts API
58
- await verifySimpleEndpoint({
59
- name: 'accounts.getAccounts',
60
- signature: 'getAccounts(budgetId, lastKnowledge?)',
61
- fetchFull: () => ynabAPI.accounts.getAccounts(budgetId),
62
- fetchDelta: (knowledge) => ynabAPI.accounts.getAccounts(budgetId, knowledge),
63
- });
64
-
65
- // Categories API
66
- await verifySimpleEndpoint({
67
- name: 'categories.getCategories',
68
- signature: 'getCategories(budgetId, lastKnowledge?)',
69
- fetchFull: () => ynabAPI.categories.getCategories(budgetId),
70
- fetchDelta: (knowledge) => ynabAPI.categories.getCategories(budgetId, knowledge),
71
- });
72
-
73
- // Payees API
74
- await verifySimpleEndpoint({
75
- name: 'payees.getPayees',
76
- signature: 'getPayees(budgetId, lastKnowledge?)',
77
- fetchFull: () => ynabAPI.payees.getPayees(budgetId),
78
- fetchDelta: (knowledge) => ynabAPI.payees.getPayees(budgetId, knowledge),
79
- });
80
-
81
- // Months API
82
- await verifySimpleEndpoint({
83
- name: 'months.getBudgetMonths',
84
- signature: 'getBudgetMonths(budgetId, lastKnowledge?)',
85
- fetchFull: () => ynabAPI.months.getBudgetMonths(budgetId),
86
- fetchDelta: (knowledge) => ynabAPI.months.getBudgetMonths(budgetId, knowledge),
87
- });
88
-
89
- // Scheduled Transactions API
90
- await verifySimpleEndpoint({
91
- name: 'scheduledTransactions.getScheduledTransactions',
92
- signature: 'getScheduledTransactions(budgetId, lastKnowledge?)',
93
- fetchFull: () => ynabAPI.scheduledTransactions.getScheduledTransactions(budgetId),
94
- fetchDelta: (knowledge) =>
95
- ynabAPI.scheduledTransactions.getScheduledTransactions(budgetId, knowledge),
96
- });
97
-
98
- // Transactions API
99
- try {
100
- const full = await ynabAPI.transactions.getTransactions(budgetId);
101
- const knowledge = full?.data?.server_knowledge;
102
- if (typeof knowledge !== 'number') {
103
- throw new Error('Response missing server_knowledge');
104
- }
105
-
106
- let supported = false;
107
- let notes = '';
108
-
109
- try {
110
- await ynabAPI.transactions.getTransactions(budgetId, undefined, undefined, knowledge);
111
- supported = true;
112
- notes = 'Signature: (budgetId, sinceDate?, type?, lastKnowledge?)';
113
- } catch (error) {
114
- notes = 'Failed with lastKnowledge as 4th parameter';
115
- throw error;
116
- }
117
-
118
- recordResult('transactions.getTransactions', notes, supported, `server_knowledge=${knowledge}`);
119
- } catch (error) {
120
- recordResult(
121
- 'transactions.getTransactions',
122
- 'getTransactions(budgetId, since?, type?, lastKnowledge?)',
123
- false,
124
- '',
125
- error,
126
- );
127
- }
128
-
129
- console.log('\nSummary:\n');
130
- for (const row of results) {
131
- console.log(
132
- `${row.supported ? '✓' : '✗'} ${row.name} -> ${row.supported ? 'supports delta' : 'no delta'} (${row.signature})`,
133
- );
134
- }
51
+ console.log("Verifying YNAB SDK delta request signatures...\n");
52
+ const budgetsResponse = await ynabAPI.budgets.getBudgets();
53
+ const budget = budgetsResponse?.data?.budgets?.[0];
54
+ if (!budget) {
55
+ throw new Error("No budget available to test.");
56
+ }
57
+ const budgetId = budget.id;
58
+ console.log(`Using budget: ${budget.name} (${budgetId})\n`);
59
+
60
+ // Budgets API
61
+ await verifySimpleEndpoint({
62
+ name: "budgets.getBudgetById",
63
+ signature: "getBudgetById(budgetId, lastKnowledge?)",
64
+ fetchFull: () => ynabAPI.budgets.getBudgetById(budgetId),
65
+ fetchDelta: (knowledge) =>
66
+ ynabAPI.budgets.getBudgetById(budgetId, knowledge),
67
+ });
68
+
69
+ // Accounts API
70
+ await verifySimpleEndpoint({
71
+ name: "accounts.getAccounts",
72
+ signature: "getAccounts(budgetId, lastKnowledge?)",
73
+ fetchFull: () => ynabAPI.accounts.getAccounts(budgetId),
74
+ fetchDelta: (knowledge) =>
75
+ ynabAPI.accounts.getAccounts(budgetId, knowledge),
76
+ });
77
+
78
+ // Categories API
79
+ await verifySimpleEndpoint({
80
+ name: "categories.getCategories",
81
+ signature: "getCategories(budgetId, lastKnowledge?)",
82
+ fetchFull: () => ynabAPI.categories.getCategories(budgetId),
83
+ fetchDelta: (knowledge) =>
84
+ ynabAPI.categories.getCategories(budgetId, knowledge),
85
+ });
86
+
87
+ // Payees API
88
+ await verifySimpleEndpoint({
89
+ name: "payees.getPayees",
90
+ signature: "getPayees(budgetId, lastKnowledge?)",
91
+ fetchFull: () => ynabAPI.payees.getPayees(budgetId),
92
+ fetchDelta: (knowledge) => ynabAPI.payees.getPayees(budgetId, knowledge),
93
+ });
94
+
95
+ // Months API
96
+ await verifySimpleEndpoint({
97
+ name: "months.getBudgetMonths",
98
+ signature: "getBudgetMonths(budgetId, lastKnowledge?)",
99
+ fetchFull: () => ynabAPI.months.getBudgetMonths(budgetId),
100
+ fetchDelta: (knowledge) =>
101
+ ynabAPI.months.getBudgetMonths(budgetId, knowledge),
102
+ });
103
+
104
+ // Scheduled Transactions API
105
+ await verifySimpleEndpoint({
106
+ name: "scheduledTransactions.getScheduledTransactions",
107
+ signature: "getScheduledTransactions(budgetId, lastKnowledge?)",
108
+ fetchFull: () =>
109
+ ynabAPI.scheduledTransactions.getScheduledTransactions(budgetId),
110
+ fetchDelta: (knowledge) =>
111
+ ynabAPI.scheduledTransactions.getScheduledTransactions(
112
+ budgetId,
113
+ knowledge,
114
+ ),
115
+ });
116
+
117
+ // Transactions API
118
+ try {
119
+ const full = await ynabAPI.transactions.getTransactions(budgetId);
120
+ const knowledge = full?.data?.server_knowledge;
121
+ if (typeof knowledge !== "number") {
122
+ throw new Error("Response missing server_knowledge");
123
+ }
124
+
125
+ let supported = false;
126
+ let notes = "";
127
+
128
+ try {
129
+ await ynabAPI.transactions.getTransactions(
130
+ budgetId,
131
+ undefined,
132
+ undefined,
133
+ knowledge,
134
+ );
135
+ supported = true;
136
+ notes = "Signature: (budgetId, sinceDate?, type?, lastKnowledge?)";
137
+ } catch (error) {
138
+ notes = "Failed with lastKnowledge as 4th parameter";
139
+ throw error;
140
+ }
141
+
142
+ recordResult(
143
+ "transactions.getTransactions",
144
+ notes,
145
+ supported,
146
+ `server_knowledge=${knowledge}`,
147
+ );
148
+ } catch (error) {
149
+ recordResult(
150
+ "transactions.getTransactions",
151
+ "getTransactions(budgetId, since?, type?, lastKnowledge?)",
152
+ false,
153
+ "",
154
+ error,
155
+ );
156
+ }
157
+
158
+ console.log("\nSummary:\n");
159
+ for (const row of results) {
160
+ console.log(
161
+ `${row.supported ? "✓" : "✗"} ${row.name} -> ${row.supported ? "supports delta" : "no delta"} (${row.signature})`,
162
+ );
163
+ }
135
164
  }
136
165
 
137
166
  main().catch((error) => {
138
- console.error('Verification failed:', error);
139
- process.exit(1);
167
+ console.error("Verification failed:", error);
168
+ process.exit(1);
140
169
  });
@@ -3,8 +3,8 @@
3
3
  * Tests the EvoCarShare scenario from user feedback
4
4
  */
5
5
 
6
- import { analyzeReconciliation } from '../src/tools/reconciliation/analyzer.js';
7
- import { DEFAULT_CONFIG as DEFAULT_MATCHING_CONFIG } from '../src/tools/reconciliation/matcher.js';
6
+ import { analyzeReconciliation } from "../src/tools/reconciliation/analyzer.js";
7
+ import { DEFAULT_CONFIG as DEFAULT_MATCHING_CONFIG } from "../src/tools/reconciliation/matcher.js";
8
8
 
9
9
  // Test data from user's scenario
10
10
  const csvContent = `Date,Description,Amount
@@ -13,41 +13,45 @@ const csvContent = `Date,Description,Amount
13
13
  const ynabTransactions = []; // No YNAB transactions
14
14
 
15
15
  const analysis = analyzeReconciliation(
16
- csvContent,
17
- undefined,
18
- ynabTransactions,
19
- 122.22, // Statement balance
20
- DEFAULT_MATCHING_CONFIG,
21
- 'USD',
22
- 'test-account',
23
- 'test-budget',
16
+ csvContent,
17
+ undefined,
18
+ ynabTransactions,
19
+ 122.22, // Statement balance
20
+ DEFAULT_MATCHING_CONFIG,
21
+ "USD",
22
+ "test-account",
23
+ "test-budget",
24
24
  );
25
25
 
26
- console.log('=== RECONCILIATION ANALYSIS ===');
26
+ console.log("=== RECONCILIATION ANALYSIS ===");
27
27
  console.log(`On Track: ${analysis.balance_info.on_track}`);
28
28
  console.log(`Discrepancy: ${analysis.balance_info.discrepancy.value_display}`);
29
- console.log(`\n=== RECOMMENDATIONS (${analysis.recommendations?.length || 0}) ===`);
29
+ console.log(
30
+ `\n=== RECOMMENDATIONS (${analysis.recommendations?.length || 0}) ===`,
31
+ );
30
32
 
31
33
  if (analysis.recommendations && analysis.recommendations.length > 0) {
32
- for (const rec of analysis.recommendations) {
33
- console.log(`\n[${rec.priority.toUpperCase()}] ${rec.message}`);
34
- console.log(` Type: ${rec.action_type}`);
35
- console.log(` Confidence: ${(rec.confidence * 100).toFixed(0)}%`);
36
- console.log(` Reason: ${rec.reason}`);
37
- console.log(` Impact: ${rec.estimated_impact.value_display}`);
38
-
39
- if (rec.action_type === 'create_transaction') {
40
- console.log(` Parameters:`);
41
- console.log(` - Date: ${rec.parameters.date}`);
42
- console.log(` - Amount: $${(rec.parameters.amount / 1000).toFixed(2)}`);
43
- console.log(` - Payee: ${rec.parameters.payee_name}`);
44
- console.log(` - Cleared: ${rec.parameters.cleared}`);
45
- }
46
- }
47
-
48
- console.log('\n✅ All checks passed!');
49
- console.log('Recommendation engine is working correctly.');
34
+ for (const rec of analysis.recommendations) {
35
+ console.log(`\n[${rec.priority.toUpperCase()}] ${rec.message}`);
36
+ console.log(` Type: ${rec.action_type}`);
37
+ console.log(` Confidence: ${(rec.confidence * 100).toFixed(0)}%`);
38
+ console.log(` Reason: ${rec.reason}`);
39
+ console.log(` Impact: ${rec.estimated_impact.value_display}`);
40
+
41
+ if (rec.action_type === "create_transaction") {
42
+ console.log(" Parameters:");
43
+ console.log(` - Date: ${rec.parameters.date}`);
44
+ console.log(
45
+ ` - Amount: $${(rec.parameters.amount / 1000).toFixed(2)}`,
46
+ );
47
+ console.log(` - Payee: ${rec.parameters.payee_name}`);
48
+ console.log(` - Cleared: ${rec.parameters.cleared}`);
49
+ }
50
+ }
51
+
52
+ console.log("\n✅ All checks passed!");
53
+ console.log("Recommendation engine is working correctly.");
50
54
  } else {
51
- console.log('❌ No recommendations generated!');
52
- process.exit(1);
55
+ console.log("❌ No recommendations generated!");
56
+ process.exit(1);
53
57
  }