@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
@@ -3,656 +3,724 @@
3
3
  * Tests the full flow from analysis → recommendations with realistic data
4
4
  */
5
5
 
6
- import { describe, it, expect } from 'vitest';
7
- import { analyzeReconciliation } from '../analyzer.js';
8
- import type * as ynab from 'ynab';
9
- import type { ActionableRecommendation } from '../types.js';
6
+ import { describe, expect, it } from "vitest";
7
+ import type * as ynab from "ynab";
8
+ import { analyzeReconciliation } from "../analyzer.js";
9
+ import type { ActionableRecommendation } from "../types.js";
10
10
 
11
11
  /**
12
12
  * Helper to create a mock YNAB transaction
13
13
  */
14
14
  function createYNABTransaction(
15
- id: string,
16
- date: string,
17
- amount: number, // in milliunits
18
- payeeName: string,
19
- cleared: 'cleared' | 'uncleared' | 'reconciled' = 'uncleared',
15
+ id: string,
16
+ date: string,
17
+ amount: number, // in milliunits
18
+ payeeName: string,
19
+ cleared: "cleared" | "uncleared" | "reconciled" = "uncleared",
20
20
  ): ynab.TransactionDetail {
21
- return {
22
- id,
23
- date,
24
- amount,
25
- payee_name: payeeName,
26
- category_name: 'Test Category',
27
- cleared,
28
- approved: true,
29
- memo: null,
30
- account_id: 'test-account',
31
- account_name: 'Test Account',
32
- deleted: false,
33
- flag_color: null,
34
- flag_name: null,
35
- category_id: 'test-category',
36
- payee_id: 'test-payee',
37
- transfer_account_id: null,
38
- transfer_transaction_id: null,
39
- matched_transaction_id: null,
40
- import_id: null,
41
- import_payee_name: null,
42
- import_payee_name_original: null,
43
- debt_transaction_type: null,
44
- subtransactions: [],
45
- } as ynab.TransactionDetail;
21
+ return {
22
+ id,
23
+ date,
24
+ amount,
25
+ payee_name: payeeName,
26
+ category_name: "Test Category",
27
+ cleared,
28
+ approved: true,
29
+ memo: null,
30
+ account_id: "test-account",
31
+ account_name: "Test Account",
32
+ deleted: false,
33
+ flag_color: null,
34
+ flag_name: null,
35
+ category_id: "test-category",
36
+ payee_id: "test-payee",
37
+ transfer_account_id: null,
38
+ transfer_transaction_id: null,
39
+ matched_transaction_id: null,
40
+ import_id: null,
41
+ import_payee_name: null,
42
+ import_payee_name_original: null,
43
+ debt_transaction_type: null,
44
+ subtransactions: [],
45
+ } as ynab.TransactionDetail;
46
46
  }
47
47
 
48
- describe('Recommendation Engine Integration', () => {
49
- describe('with account_id and budget_id provided', () => {
50
- it(
51
- 'should generate recommendations for unmatched bank transactions',
52
- { meta: { tier: 'domain', domain: 'reconciliation' } },
53
- () => {
54
- // Create CSV with unmatched bank transaction
55
- const csvContent = 'Date,Description,Amount\n2024-01-15,Coffee Shop,22.22';
56
- const ynabTransactions: ynab.TransactionDetail[] = [];
57
-
58
- const analysis = analyzeReconciliation(
59
- csvContent,
60
- undefined,
61
- ynabTransactions,
62
- 22.22, // statement balance
63
- {
64
- dateToleranceDays: 2,
65
- amountToleranceCents: 1,
66
- descriptionSimilarityThreshold: 0.8,
67
- autoMatchThreshold: 90,
68
- suggestionThreshold: 60,
69
- },
70
- 'USD',
71
- 'test-account-id',
72
- 'test-budget-id',
73
- );
74
-
75
- // Verify recommendations are generated
76
- expect(analysis.recommendations).toBeDefined();
77
- expect(analysis.recommendations!.length).toBeGreaterThan(0);
78
-
79
- // Verify recommendation details
80
- const rec = analysis.recommendations![0]!;
81
- expect(rec.action_type).toBe('create_transaction');
82
- expect(rec.priority).toMatch(/^(high|medium|low)$/);
83
- expect(rec.account_id).toBe('test-account-id');
84
-
85
- if (rec.action_type === 'create_transaction') {
86
- expect(rec.parameters.payee_name).toContain('Coffee Shop');
87
- expect(rec.parameters.amount).toBe(22220); // In milliunits
88
- expect(rec.parameters.date).toBe('2024-01-15');
89
- expect(rec.parameters.cleared).toBe('cleared');
90
- }
91
- },
92
- );
93
-
94
- it(
95
- 'should handle the EvoCarShare scenario correctly',
96
- { meta: { tier: 'domain', domain: 'reconciliation' } },
97
- () => {
98
- // Test the exact scenario from documentation
99
- // YNAB cleared balance: $100
100
- // Statement balance: $122.22
101
- // Missing transaction: EvoCarShare $22.22
102
- // Should generate high-priority create_transaction recommendation
103
-
104
- const csvContent =
105
- 'Date,Description,Amount\n2024-01-15,EvoCarShare,22.22\n2024-01-10,Grocery Store,100.00';
106
-
107
- const ynabTransactions: ynab.TransactionDetail[] = [
108
- createYNABTransaction('ynab-1', '2024-01-10', 100000, 'Grocery Store', 'cleared'),
109
- ];
110
-
111
- const analysis = analyzeReconciliation(
112
- csvContent,
113
- undefined,
114
- ynabTransactions,
115
- 122.22, // statement balance
116
- {
117
- dateToleranceDays: 2,
118
- amountToleranceCents: 1,
119
- descriptionSimilarityThreshold: 0.8,
120
- autoMatchThreshold: 90,
121
- suggestionThreshold: 60,
122
- },
123
- 'USD',
124
- 'test-account-id',
125
- 'test-budget-id',
126
- );
127
-
128
- // Verify recommendations exist
129
- expect(analysis.recommendations).toBeDefined();
130
- expect(analysis.recommendations!.length).toBeGreaterThan(0);
131
-
132
- // Find the EvoCarShare recommendation
133
- const evoCarShareRec = analysis.recommendations!.find(
134
- (rec) =>
135
- rec.action_type === 'create_transaction' &&
136
- rec.action_type === 'create_transaction' &&
137
- rec.parameters.payee_name.includes('EvoCarShare'),
138
- ) as Extract<ActionableRecommendation, { action_type: 'create_transaction' }> | undefined;
139
-
140
- expect(evoCarShareRec).toBeDefined();
141
- expect(evoCarShareRec!.parameters.amount).toBe(22220); // In milliunits
142
- expect(evoCarShareRec!.parameters.date).toBe('2024-01-15');
143
- expect(evoCarShareRec!.priority).toMatch(/^(high|medium)$/); // Should be high or medium priority
144
- expect(evoCarShareRec!.confidence).toBeGreaterThan(0.5); // Reasonable confidence
145
- },
146
- );
147
-
148
- it(
149
- 'should generate update_cleared recommendations for unmatched uncleared YNAB transactions',
150
- { meta: { tier: 'domain', domain: 'reconciliation' } },
151
- () => {
152
- const csvContent = 'Date,Description,Amount\n2024-01-15,Coffee Shop,10.00';
153
-
154
- const ynabTransactions: ynab.TransactionDetail[] = [
155
- createYNABTransaction('ynab-1', '2024-01-15', 10000, 'Coffee Shop', 'uncleared'),
156
- ];
157
-
158
- const analysis = analyzeReconciliation(
159
- csvContent,
160
- undefined,
161
- ynabTransactions,
162
- 10.0, // statement balance
163
- {
164
- dateToleranceDays: 2,
165
- amountToleranceCents: 1,
166
- descriptionSimilarityThreshold: 0.8,
167
- autoMatchThreshold: 90,
168
- suggestionThreshold: 60,
169
- },
170
- 'USD',
171
- 'test-account-id',
172
- 'test-budget-id',
173
- );
174
-
175
- expect(analysis.recommendations).toBeDefined();
176
-
177
- // High confidence match should generate review_duplicate or update_cleared
178
- const updateRecs = analysis.recommendations!.filter(
179
- (rec) => rec.action_type === 'update_cleared',
180
- );
181
-
182
- // Depending on matching score, this could be an auto-match (no recommendation)
183
- // or an update_cleared recommendation
184
- // The key is that recommendations exist and are properly formatted
185
- expect(analysis.recommendations!.length).toBeGreaterThan(0);
186
-
187
- // Verify any update_cleared recommendations are properly formed
188
- for (const rec of updateRecs) {
189
- if (rec.action_type === 'update_cleared') {
190
- expect(rec.parameters.transaction_id).toBeDefined();
191
- expect(rec.parameters.cleared).toMatch(/^(cleared|reconciled)$/);
192
- }
193
- }
194
- },
195
- );
196
-
197
- it(
198
- 'should generate review_duplicate for suggested matches',
199
- { meta: { tier: 'domain', domain: 'reconciliation' } },
200
- () => {
201
- // Create a near match that should be suggested but not auto-matched
202
- const csvContent = 'Date,Description,Amount\n2024-01-15,Amazon Online Purchase,49.99';
203
-
204
- const ynabTransactions: ynab.TransactionDetail[] = [
205
- createYNABTransaction(
206
- 'ynab-1',
207
- '2024-01-14', // 1 day off
208
- 49990,
209
- 'Amazon.com',
210
- 'uncleared',
211
- ),
212
- ];
213
-
214
- const analysis = analyzeReconciliation(
215
- csvContent,
216
- undefined,
217
- ynabTransactions,
218
- 49.99,
219
- {
220
- dateToleranceDays: 2,
221
- amountToleranceCents: 1,
222
- descriptionSimilarityThreshold: 0.8,
223
- autoMatchThreshold: 90,
224
- suggestionThreshold: 60,
225
- },
226
- 'USD',
227
- 'test-account-id',
228
- 'test-budget-id',
229
- );
230
-
231
- expect(analysis.recommendations).toBeDefined();
232
-
233
- // Should have at least one recommendation
234
- expect(analysis.recommendations!.length).toBeGreaterThan(0);
235
-
236
- // Could be create_transaction or review_duplicate depending on match score
237
- const hasRelevantRec = analysis.recommendations!.some(
238
- (rec) =>
239
- rec.action_type === 'create_transaction' || rec.action_type === 'review_duplicate',
240
- );
241
- expect(hasRelevantRec).toBe(true);
242
- },
243
- );
244
- });
245
-
246
- describe('without account_id and budget_id (backward compatibility)', () => {
247
- it(
248
- 'should NOT generate recommendations when IDs are missing',
249
- { meta: { tier: 'domain', domain: 'reconciliation' } },
250
- () => {
251
- const csvContent = 'Date,Description,Amount\n2024-01-15,Test Transaction,10.00';
252
- const ynabTransactions: ynab.TransactionDetail[] = [];
253
-
254
- const analysis = analyzeReconciliation(
255
- csvContent,
256
- undefined,
257
- ynabTransactions,
258
- 10.0,
259
- {
260
- dateToleranceDays: 2,
261
- amountToleranceCents: 1,
262
- descriptionSimilarityThreshold: 0.8,
263
- autoMatchThreshold: 90,
264
- suggestionThreshold: 60,
265
- },
266
- 'USD',
267
- // No accountId or budgetId provided
268
- );
269
-
270
- // Should still work, but no recommendations
271
- expect(analysis.success).toBe(true);
272
- expect(analysis.recommendations).toBeUndefined();
273
- expect(analysis.unmatched_bank.length).toBe(1);
274
- },
275
- );
276
-
277
- it(
278
- 'should still perform analysis correctly without recommendations',
279
- { meta: { tier: 'domain', domain: 'reconciliation' } },
280
- () => {
281
- const csvContent =
282
- 'Date,Description,Amount\n2024-01-15,Store A,25.00\n2024-01-16,Store B,35.00';
283
-
284
- const ynabTransactions: ynab.TransactionDetail[] = [
285
- createYNABTransaction('ynab-1', '2024-01-15', 25000, 'Store A', 'cleared'),
286
- ];
287
-
288
- const analysis = analyzeReconciliation(
289
- csvContent,
290
- undefined,
291
- ynabTransactions,
292
- 60.0,
293
- {
294
- dateToleranceDays: 2,
295
- amountToleranceCents: 1,
296
- descriptionSimilarityThreshold: 0.8,
297
- autoMatchThreshold: 90,
298
- suggestionThreshold: 60,
299
- },
300
- 'USD',
301
- // No IDs
302
- );
303
-
304
- expect(analysis.success).toBe(true);
305
- expect(analysis.recommendations).toBeUndefined();
306
- expect(analysis.summary).toBeDefined();
307
- expect(analysis.balance_info).toBeDefined();
308
- expect(analysis.insights).toBeDefined();
309
-
310
- // Should still have matches and unmatched items
311
- expect(analysis.summary.bank_transactions_count).toBe(2);
312
- expect(analysis.summary.ynab_transactions_count).toBe(1);
313
- },
314
- );
315
- });
316
-
317
- describe('complex scenarios', () => {
318
- it(
319
- 'should generate multiple recommendations for multiple unmatched transactions',
320
- { meta: { tier: 'domain', domain: 'reconciliation' } },
321
- () => {
322
- const csvContent = `Date,Description,Amount
48
+ describe("Recommendation Engine Integration", () => {
49
+ describe("with account_id and budget_id provided", () => {
50
+ it(
51
+ "should generate recommendations for unmatched bank transactions",
52
+ { meta: { tier: "domain", domain: "reconciliation" } },
53
+ () => {
54
+ // Create CSV with unmatched bank transaction
55
+ const csvContent =
56
+ "Date,Description,Amount\n2024-01-15,Coffee Shop,22.22";
57
+ const ynabTransactions: ynab.TransactionDetail[] = [];
58
+
59
+ const analysis = analyzeReconciliation(
60
+ csvContent,
61
+ undefined,
62
+ ynabTransactions,
63
+ 22.22, // statement balance
64
+ {
65
+ dateToleranceDays: 2,
66
+ amountToleranceCents: 1,
67
+ descriptionSimilarityThreshold: 0.8,
68
+ autoMatchThreshold: 90,
69
+ suggestionThreshold: 60,
70
+ },
71
+ "USD",
72
+ "test-account-id",
73
+ "test-budget-id",
74
+ );
75
+
76
+ // Verify recommendations are generated
77
+ expect(analysis.recommendations).toBeDefined();
78
+ expect(analysis.recommendations?.length).toBeGreaterThan(0);
79
+
80
+ // Verify recommendation details
81
+ const rec = analysis.recommendations?.[0]!;
82
+ expect(rec.action_type).toBe("create_transaction");
83
+ expect(rec.priority).toMatch(/^(high|medium|low)$/);
84
+ expect(rec.account_id).toBe("test-account-id");
85
+
86
+ if (rec.action_type === "create_transaction") {
87
+ expect(rec.parameters.payee_name).toContain("Coffee Shop");
88
+ expect(rec.parameters.amount).toBe(22220); // In milliunits
89
+ expect(rec.parameters.date).toBe("2024-01-15");
90
+ expect(rec.parameters.cleared).toBe("cleared");
91
+ }
92
+ },
93
+ );
94
+
95
+ it(
96
+ "should handle the EvoCarShare scenario correctly",
97
+ { meta: { tier: "domain", domain: "reconciliation" } },
98
+ () => {
99
+ // Test the exact scenario from documentation
100
+ // YNAB cleared balance: $100
101
+ // Statement balance: $122.22
102
+ // Missing transaction: EvoCarShare $22.22
103
+ // Should generate high-priority create_transaction recommendation
104
+
105
+ const csvContent =
106
+ "Date,Description,Amount\n2024-01-15,EvoCarShare,22.22\n2024-01-10,Grocery Store,100.00";
107
+
108
+ const ynabTransactions: ynab.TransactionDetail[] = [
109
+ createYNABTransaction(
110
+ "ynab-1",
111
+ "2024-01-10",
112
+ 100000,
113
+ "Grocery Store",
114
+ "cleared",
115
+ ),
116
+ ];
117
+
118
+ const analysis = analyzeReconciliation(
119
+ csvContent,
120
+ undefined,
121
+ ynabTransactions,
122
+ 122.22, // statement balance
123
+ {
124
+ dateToleranceDays: 2,
125
+ amountToleranceCents: 1,
126
+ descriptionSimilarityThreshold: 0.8,
127
+ autoMatchThreshold: 90,
128
+ suggestionThreshold: 60,
129
+ },
130
+ "USD",
131
+ "test-account-id",
132
+ "test-budget-id",
133
+ );
134
+
135
+ // Verify recommendations exist
136
+ expect(analysis.recommendations).toBeDefined();
137
+ expect(analysis.recommendations?.length).toBeGreaterThan(0);
138
+
139
+ // Find the EvoCarShare recommendation
140
+ const evoCarShareRec = analysis.recommendations?.find(
141
+ (rec) =>
142
+ rec.action_type === "create_transaction" &&
143
+ rec.action_type === "create_transaction" &&
144
+ rec.parameters.payee_name.includes("EvoCarShare"),
145
+ ) as
146
+ | Extract<
147
+ ActionableRecommendation,
148
+ { action_type: "create_transaction" }
149
+ >
150
+ | undefined;
151
+
152
+ expect(evoCarShareRec).toBeDefined();
153
+ expect(evoCarShareRec?.parameters.amount).toBe(22220); // In milliunits
154
+ expect(evoCarShareRec?.parameters.date).toBe("2024-01-15");
155
+ expect(evoCarShareRec?.priority).toMatch(/^(high|medium)$/); // Should be high or medium priority
156
+ expect(evoCarShareRec?.confidence).toBeGreaterThan(0.5); // Reasonable confidence
157
+ },
158
+ );
159
+
160
+ it(
161
+ "should generate update_cleared recommendations for unmatched uncleared YNAB transactions",
162
+ { meta: { tier: "domain", domain: "reconciliation" } },
163
+ () => {
164
+ const csvContent =
165
+ "Date,Description,Amount\n2024-01-15,Coffee Shop,10.00";
166
+
167
+ const ynabTransactions: ynab.TransactionDetail[] = [
168
+ createYNABTransaction(
169
+ "ynab-1",
170
+ "2024-01-15",
171
+ 10000,
172
+ "Coffee Shop",
173
+ "uncleared",
174
+ ),
175
+ ];
176
+
177
+ const analysis = analyzeReconciliation(
178
+ csvContent,
179
+ undefined,
180
+ ynabTransactions,
181
+ 10.0, // statement balance
182
+ {
183
+ dateToleranceDays: 2,
184
+ amountToleranceCents: 1,
185
+ descriptionSimilarityThreshold: 0.8,
186
+ autoMatchThreshold: 90,
187
+ suggestionThreshold: 60,
188
+ },
189
+ "USD",
190
+ "test-account-id",
191
+ "test-budget-id",
192
+ );
193
+
194
+ expect(analysis.recommendations).toBeDefined();
195
+
196
+ // High confidence match should generate review_duplicate or update_cleared
197
+ const updateRecs = analysis.recommendations?.filter(
198
+ (rec) => rec.action_type === "update_cleared",
199
+ );
200
+
201
+ // Depending on matching score, this could be an auto-match (no recommendation)
202
+ // or an update_cleared recommendation
203
+ // The key is that recommendations exist and are properly formatted
204
+ expect(analysis.recommendations?.length).toBeGreaterThan(0);
205
+
206
+ // Verify any update_cleared recommendations are properly formed
207
+ for (const rec of updateRecs) {
208
+ if (rec.action_type === "update_cleared") {
209
+ expect(rec.parameters.transaction_id).toBeDefined();
210
+ expect(rec.parameters.cleared).toMatch(/^(cleared|reconciled)$/);
211
+ }
212
+ }
213
+ },
214
+ );
215
+
216
+ it(
217
+ "should generate review_duplicate for suggested matches",
218
+ { meta: { tier: "domain", domain: "reconciliation" } },
219
+ () => {
220
+ // Create a near match that should be suggested but not auto-matched
221
+ const csvContent =
222
+ "Date,Description,Amount\n2024-01-15,Amazon Online Purchase,49.99";
223
+
224
+ const ynabTransactions: ynab.TransactionDetail[] = [
225
+ createYNABTransaction(
226
+ "ynab-1",
227
+ "2024-01-14", // 1 day off
228
+ 49990,
229
+ "Amazon.com",
230
+ "uncleared",
231
+ ),
232
+ ];
233
+
234
+ const analysis = analyzeReconciliation(
235
+ csvContent,
236
+ undefined,
237
+ ynabTransactions,
238
+ 49.99,
239
+ {
240
+ dateToleranceDays: 2,
241
+ amountToleranceCents: 1,
242
+ descriptionSimilarityThreshold: 0.8,
243
+ autoMatchThreshold: 90,
244
+ suggestionThreshold: 60,
245
+ },
246
+ "USD",
247
+ "test-account-id",
248
+ "test-budget-id",
249
+ );
250
+
251
+ expect(analysis.recommendations).toBeDefined();
252
+
253
+ // Should have at least one recommendation
254
+ expect(analysis.recommendations?.length).toBeGreaterThan(0);
255
+
256
+ // Could be create_transaction or review_duplicate depending on match score
257
+ const hasRelevantRec = analysis.recommendations?.some(
258
+ (rec) =>
259
+ rec.action_type === "create_transaction" ||
260
+ rec.action_type === "review_duplicate",
261
+ );
262
+ expect(hasRelevantRec).toBe(true);
263
+ },
264
+ );
265
+ });
266
+
267
+ describe("without account_id and budget_id (backward compatibility)", () => {
268
+ it(
269
+ "should NOT generate recommendations when IDs are missing",
270
+ { meta: { tier: "domain", domain: "reconciliation" } },
271
+ () => {
272
+ const csvContent =
273
+ "Date,Description,Amount\n2024-01-15,Test Transaction,10.00";
274
+ const ynabTransactions: ynab.TransactionDetail[] = [];
275
+
276
+ const analysis = analyzeReconciliation(
277
+ csvContent,
278
+ undefined,
279
+ ynabTransactions,
280
+ 10.0,
281
+ {
282
+ dateToleranceDays: 2,
283
+ amountToleranceCents: 1,
284
+ descriptionSimilarityThreshold: 0.8,
285
+ autoMatchThreshold: 90,
286
+ suggestionThreshold: 60,
287
+ },
288
+ "USD",
289
+ // No accountId or budgetId provided
290
+ );
291
+
292
+ // Should still work, but no recommendations
293
+ expect(analysis.success).toBe(true);
294
+ expect(analysis.recommendations).toBeUndefined();
295
+ expect(analysis.unmatched_bank.length).toBe(1);
296
+ },
297
+ );
298
+
299
+ it(
300
+ "should still perform analysis correctly without recommendations",
301
+ { meta: { tier: "domain", domain: "reconciliation" } },
302
+ () => {
303
+ const csvContent =
304
+ "Date,Description,Amount\n2024-01-15,Store A,25.00\n2024-01-16,Store B,35.00";
305
+
306
+ const ynabTransactions: ynab.TransactionDetail[] = [
307
+ createYNABTransaction(
308
+ "ynab-1",
309
+ "2024-01-15",
310
+ 25000,
311
+ "Store A",
312
+ "cleared",
313
+ ),
314
+ ];
315
+
316
+ const analysis = analyzeReconciliation(
317
+ csvContent,
318
+ undefined,
319
+ ynabTransactions,
320
+ 60.0,
321
+ {
322
+ dateToleranceDays: 2,
323
+ amountToleranceCents: 1,
324
+ descriptionSimilarityThreshold: 0.8,
325
+ autoMatchThreshold: 90,
326
+ suggestionThreshold: 60,
327
+ },
328
+ "USD",
329
+ // No IDs
330
+ );
331
+
332
+ expect(analysis.success).toBe(true);
333
+ expect(analysis.recommendations).toBeUndefined();
334
+ expect(analysis.summary).toBeDefined();
335
+ expect(analysis.balance_info).toBeDefined();
336
+ expect(analysis.insights).toBeDefined();
337
+
338
+ // Should still have matches and unmatched items
339
+ expect(analysis.summary.bank_transactions_count).toBe(2);
340
+ expect(analysis.summary.ynab_transactions_count).toBe(1);
341
+ },
342
+ );
343
+ });
344
+
345
+ describe("complex scenarios", () => {
346
+ it(
347
+ "should generate multiple recommendations for multiple unmatched transactions",
348
+ { meta: { tier: "domain", domain: "reconciliation" } },
349
+ () => {
350
+ const csvContent = `Date,Description,Amount
323
351
  2024-01-15,Coffee Shop,5.00
324
352
  2024-01-16,Gas Station,45.00
325
353
  2024-01-17,Restaurant,25.00`;
326
354
 
327
- const ynabTransactions: ynab.TransactionDetail[] = [];
328
-
329
- const analysis = analyzeReconciliation(
330
- csvContent,
331
- undefined,
332
- ynabTransactions,
333
- 75.0,
334
- {
335
- dateToleranceDays: 2,
336
- amountToleranceCents: 1,
337
- descriptionSimilarityThreshold: 0.8,
338
- autoMatchThreshold: 90,
339
- suggestionThreshold: 60,
340
- },
341
- 'USD',
342
- 'test-account-id',
343
- 'test-budget-id',
344
- );
345
-
346
- expect(analysis.recommendations).toBeDefined();
347
- expect(analysis.recommendations!.length).toBeGreaterThanOrEqual(3);
348
-
349
- // All should be create_transaction recommendations
350
- const createRecs = analysis.recommendations!.filter(
351
- (rec) => rec.action_type === 'create_transaction',
352
- );
353
- expect(createRecs.length).toBeGreaterThanOrEqual(3);
354
- },
355
- );
356
-
357
- it(
358
- 'should handle repeat amounts with recommendations',
359
- { meta: { tier: 'domain', domain: 'reconciliation' } },
360
- () => {
361
- const csvContent = `Date,Description,Amount
355
+ const ynabTransactions: ynab.TransactionDetail[] = [];
356
+
357
+ const analysis = analyzeReconciliation(
358
+ csvContent,
359
+ undefined,
360
+ ynabTransactions,
361
+ 75.0,
362
+ {
363
+ dateToleranceDays: 2,
364
+ amountToleranceCents: 1,
365
+ descriptionSimilarityThreshold: 0.8,
366
+ autoMatchThreshold: 90,
367
+ suggestionThreshold: 60,
368
+ },
369
+ "USD",
370
+ "test-account-id",
371
+ "test-budget-id",
372
+ );
373
+
374
+ expect(analysis.recommendations).toBeDefined();
375
+ expect(analysis.recommendations?.length).toBeGreaterThanOrEqual(3);
376
+
377
+ // All should be create_transaction recommendations
378
+ const createRecs = analysis.recommendations?.filter(
379
+ (rec) => rec.action_type === "create_transaction",
380
+ );
381
+ expect(createRecs.length).toBeGreaterThanOrEqual(3);
382
+ },
383
+ );
384
+
385
+ it(
386
+ "should handle repeat amounts with recommendations",
387
+ { meta: { tier: "domain", domain: "reconciliation" } },
388
+ () => {
389
+ const csvContent = `Date,Description,Amount
362
390
  2024-01-15,Netflix,15.99
363
391
  2024-02-15,Netflix,15.99
364
392
  2024-03-15,Netflix,15.99`;
365
393
 
366
- const ynabTransactions: ynab.TransactionDetail[] = [];
367
-
368
- const analysis = analyzeReconciliation(
369
- csvContent,
370
- undefined,
371
- ynabTransactions,
372
- 47.97,
373
- {
374
- dateToleranceDays: 2,
375
- amountToleranceCents: 1,
376
- descriptionSimilarityThreshold: 0.8,
377
- autoMatchThreshold: 90,
378
- suggestionThreshold: 60,
379
- },
380
- 'USD',
381
- 'test-account-id',
382
- 'test-budget-id',
383
- );
384
-
385
- expect(analysis.recommendations).toBeDefined();
386
- expect(analysis.recommendations!.length).toBeGreaterThanOrEqual(3);
387
-
388
- // Should have insights about repeat amounts
389
- const repeatInsight = analysis.insights.find((insight) => insight.type === 'repeat_amount');
390
- expect(repeatInsight).toBeDefined();
391
-
392
- // Should have recommendations (create_transaction or manual_review)
393
- const relevantRecs = analysis.recommendations!.filter(
394
- (rec) => rec.action_type === 'create_transaction' || rec.action_type === 'manual_review',
395
- );
396
- expect(relevantRecs.length).toBeGreaterThan(0);
397
- },
398
- );
399
-
400
- it(
401
- 'should generate mixed recommendation types for complex scenario',
402
- { meta: { tier: 'domain', domain: 'reconciliation' } },
403
- () => {
404
- const csvContent = `Date,Description,Amount
394
+ const ynabTransactions: ynab.TransactionDetail[] = [];
395
+
396
+ const analysis = analyzeReconciliation(
397
+ csvContent,
398
+ undefined,
399
+ ynabTransactions,
400
+ 47.97,
401
+ {
402
+ dateToleranceDays: 2,
403
+ amountToleranceCents: 1,
404
+ descriptionSimilarityThreshold: 0.8,
405
+ autoMatchThreshold: 90,
406
+ suggestionThreshold: 60,
407
+ },
408
+ "USD",
409
+ "test-account-id",
410
+ "test-budget-id",
411
+ );
412
+
413
+ expect(analysis.recommendations).toBeDefined();
414
+ expect(analysis.recommendations?.length).toBeGreaterThanOrEqual(3);
415
+
416
+ // Should have insights about repeat amounts
417
+ const repeatInsight = analysis.insights.find(
418
+ (insight) => insight.type === "repeat_amount",
419
+ );
420
+ expect(repeatInsight).toBeDefined();
421
+
422
+ // Should have recommendations (create_transaction or manual_review)
423
+ const relevantRecs = analysis.recommendations?.filter(
424
+ (rec) =>
425
+ rec.action_type === "create_transaction" ||
426
+ rec.action_type === "manual_review",
427
+ );
428
+ expect(relevantRecs.length).toBeGreaterThan(0);
429
+ },
430
+ );
431
+
432
+ it(
433
+ "should generate mixed recommendation types for complex scenario",
434
+ { meta: { tier: "domain", domain: "reconciliation" } },
435
+ () => {
436
+ const csvContent = `Date,Description,Amount
405
437
  2024-01-15,New Store,25.00
406
438
  2024-01-16,Coffee,5.00
407
439
  2024-01-17,Gas Station,45.00`;
408
440
 
409
- const ynabTransactions: ynab.TransactionDetail[] = [
410
- // Near match - might be Coffee
411
- createYNABTransaction('ynab-1', '2024-01-16', 4500, 'Starbucks Coffee', 'uncleared'),
412
- // Exact amount but different payee - might be Gas Station
413
- createYNABTransaction('ynab-2', '2024-01-17', 45000, 'Shell', 'uncleared'),
414
- // Unrelated uncleared transaction
415
- createYNABTransaction('ynab-3', '2024-01-10', 10000, 'Grocery', 'uncleared'),
416
- ];
417
-
418
- const analysis = analyzeReconciliation(
419
- csvContent,
420
- undefined,
421
- ynabTransactions,
422
- 75.0,
423
- {
424
- dateToleranceDays: 2,
425
- amountToleranceCents: 1,
426
- descriptionSimilarityThreshold: 0.8,
427
- autoMatchThreshold: 90,
428
- suggestionThreshold: 60,
429
- },
430
- 'USD',
431
- 'test-account-id',
432
- 'test-budget-id',
433
- );
434
-
435
- expect(analysis.recommendations).toBeDefined();
436
- expect(analysis.recommendations!.length).toBeGreaterThan(0);
437
-
438
- // Should have various recommendation types
439
- const actionTypes = new Set(analysis.recommendations!.map((rec) => rec.action_type));
440
-
441
- // Should have at least 2 different action types
442
- expect(actionTypes.size).toBeGreaterThanOrEqual(1);
443
-
444
- // Verify all recommendations have required fields
445
- for (const rec of analysis.recommendations!) {
446
- expect(rec.id).toBeDefined();
447
- expect(rec.priority).toMatch(/^(high|medium|low)$/);
448
- expect(rec.confidence).toBeGreaterThanOrEqual(0);
449
- expect(rec.confidence).toBeLessThanOrEqual(1);
450
- expect(rec.message).toBeDefined();
451
- expect(rec.reason).toBeDefined();
452
- expect(rec.estimated_impact).toBeDefined();
453
- expect(rec.account_id).toBe('test-account-id');
454
- expect(rec.metadata).toBeDefined();
455
- expect(rec.metadata.version).toBe('1.0');
456
- expect(rec.metadata.created_at).toBeDefined();
457
- }
458
- },
459
- );
460
-
461
- it(
462
- 'should prioritize recommendations by priority and confidence',
463
- { meta: { tier: 'domain', domain: 'reconciliation' } },
464
- () => {
465
- const csvContent = `Date,Description,Amount
441
+ const ynabTransactions: ynab.TransactionDetail[] = [
442
+ // Near match - might be Coffee
443
+ createYNABTransaction(
444
+ "ynab-1",
445
+ "2024-01-16",
446
+ 4500,
447
+ "Starbucks Coffee",
448
+ "uncleared",
449
+ ),
450
+ // Exact amount but different payee - might be Gas Station
451
+ createYNABTransaction(
452
+ "ynab-2",
453
+ "2024-01-17",
454
+ 45000,
455
+ "Shell",
456
+ "uncleared",
457
+ ),
458
+ // Unrelated uncleared transaction
459
+ createYNABTransaction(
460
+ "ynab-3",
461
+ "2024-01-10",
462
+ 10000,
463
+ "Grocery",
464
+ "uncleared",
465
+ ),
466
+ ];
467
+
468
+ const analysis = analyzeReconciliation(
469
+ csvContent,
470
+ undefined,
471
+ ynabTransactions,
472
+ 75.0,
473
+ {
474
+ dateToleranceDays: 2,
475
+ amountToleranceCents: 1,
476
+ descriptionSimilarityThreshold: 0.8,
477
+ autoMatchThreshold: 90,
478
+ suggestionThreshold: 60,
479
+ },
480
+ "USD",
481
+ "test-account-id",
482
+ "test-budget-id",
483
+ );
484
+
485
+ expect(analysis.recommendations).toBeDefined();
486
+ expect(analysis.recommendations?.length).toBeGreaterThan(0);
487
+
488
+ // Should have various recommendation types
489
+ const actionTypes = new Set(
490
+ analysis.recommendations?.map((rec) => rec.action_type),
491
+ );
492
+
493
+ // Should have at least 2 different action types
494
+ expect(actionTypes.size).toBeGreaterThanOrEqual(1);
495
+
496
+ // Verify all recommendations have required fields
497
+ for (const rec of analysis.recommendations!) {
498
+ expect(rec.id).toBeDefined();
499
+ expect(rec.priority).toMatch(/^(high|medium|low)$/);
500
+ expect(rec.confidence).toBeGreaterThanOrEqual(0);
501
+ expect(rec.confidence).toBeLessThanOrEqual(1);
502
+ expect(rec.message).toBeDefined();
503
+ expect(rec.reason).toBeDefined();
504
+ expect(rec.estimated_impact).toBeDefined();
505
+ expect(rec.account_id).toBe("test-account-id");
506
+ expect(rec.metadata).toBeDefined();
507
+ expect(rec.metadata.version).toBe("1.0");
508
+ expect(rec.metadata.created_at).toBeDefined();
509
+ }
510
+ },
511
+ );
512
+
513
+ it(
514
+ "should prioritize recommendations by priority and confidence",
515
+ { meta: { tier: "domain", domain: "reconciliation" } },
516
+ () => {
517
+ const csvContent = `Date,Description,Amount
466
518
  2024-01-15,Important Transaction,100.00
467
519
  2024-01-16,Small Purchase,5.00
468
520
  2024-01-17,Medium Transaction,25.00`;
469
521
 
470
- const ynabTransactions: ynab.TransactionDetail[] = [];
471
-
472
- const analysis = analyzeReconciliation(
473
- csvContent,
474
- undefined,
475
- ynabTransactions,
476
- 130.0,
477
- {
478
- dateToleranceDays: 2,
479
- amountToleranceCents: 1,
480
- descriptionSimilarityThreshold: 0.8,
481
- autoMatchThreshold: 90,
482
- suggestionThreshold: 60,
483
- },
484
- 'USD',
485
- 'test-account-id',
486
- 'test-budget-id',
487
- );
488
-
489
- expect(analysis.recommendations).toBeDefined();
490
- expect(analysis.recommendations!.length).toBeGreaterThanOrEqual(3);
491
-
492
- // Verify recommendations are sorted by priority (high > medium > low)
493
- const priorities = analysis.recommendations!.map((rec) => rec.priority);
494
- const priorityValues = { high: 3, medium: 2, low: 1 };
495
-
496
- for (let i = 0; i < priorities.length - 1; i++) {
497
- const currentPriorityValue = priorityValues[priorities[i]!];
498
- const nextPriorityValue = priorityValues[priorities[i + 1]!];
499
- expect(currentPriorityValue).toBeGreaterThanOrEqual(nextPriorityValue);
500
- }
501
- },
502
- );
503
-
504
- it(
505
- 'should handle large discrepancies with appropriate recommendations',
506
- { meta: { tier: 'domain', domain: 'reconciliation' } },
507
- () => {
508
- const csvContent = `Date,Description,Amount
522
+ const ynabTransactions: ynab.TransactionDetail[] = [];
523
+
524
+ const analysis = analyzeReconciliation(
525
+ csvContent,
526
+ undefined,
527
+ ynabTransactions,
528
+ 130.0,
529
+ {
530
+ dateToleranceDays: 2,
531
+ amountToleranceCents: 1,
532
+ descriptionSimilarityThreshold: 0.8,
533
+ autoMatchThreshold: 90,
534
+ suggestionThreshold: 60,
535
+ },
536
+ "USD",
537
+ "test-account-id",
538
+ "test-budget-id",
539
+ );
540
+
541
+ expect(analysis.recommendations).toBeDefined();
542
+ expect(analysis.recommendations?.length).toBeGreaterThanOrEqual(3);
543
+
544
+ // Verify recommendations are sorted by priority (high > medium > low)
545
+ const priorities = analysis.recommendations?.map((rec) => rec.priority);
546
+ const priorityValues = { high: 3, medium: 2, low: 1 };
547
+
548
+ for (let i = 0; i < priorities.length - 1; i++) {
549
+ const currentPriorityValue = priorityValues[priorities[i]!];
550
+ const nextPriorityValue = priorityValues[priorities[i + 1]!];
551
+ expect(currentPriorityValue).toBeGreaterThanOrEqual(
552
+ nextPriorityValue,
553
+ );
554
+ }
555
+ },
556
+ );
557
+
558
+ it(
559
+ "should handle large discrepancies with appropriate recommendations",
560
+ { meta: { tier: "domain", domain: "reconciliation" } },
561
+ () => {
562
+ const csvContent = `Date,Description,Amount
509
563
  2024-01-15,Large Transaction A,500.00
510
564
  2024-01-16,Large Transaction B,750.00
511
565
  2024-01-17,Large Transaction C,1000.00`;
512
566
 
513
- const ynabTransactions: ynab.TransactionDetail[] = [
514
- createYNABTransaction('ynab-1', '2024-01-15', 500000, 'Transaction A', 'cleared'),
515
- ];
516
-
517
- const analysis = analyzeReconciliation(
518
- csvContent,
519
- undefined,
520
- ynabTransactions,
521
- 2250.0, // Large statement balance
522
- {
523
- dateToleranceDays: 2,
524
- amountToleranceCents: 1,
525
- descriptionSimilarityThreshold: 0.8,
526
- autoMatchThreshold: 90,
527
- suggestionThreshold: 60,
528
- },
529
- 'USD',
530
- 'test-account-id',
531
- 'test-budget-id',
532
- );
533
-
534
- expect(analysis.recommendations).toBeDefined();
535
-
536
- // Should have insights about large discrepancy
537
- const anomalyInsight = analysis.insights.find((insight) => insight.type === 'anomaly');
538
- expect(anomalyInsight).toBeDefined();
539
-
540
- // Should have recommendations for the unmatched transactions
541
- const createRecs = analysis.recommendations!.filter(
542
- (rec) => rec.action_type === 'create_transaction',
543
- );
544
- expect(createRecs.length).toBeGreaterThanOrEqual(2);
545
-
546
- // Large amounts should have high or medium priority
547
- for (const rec of createRecs) {
548
- if (
549
- rec.action_type === 'create_transaction' &&
550
- Math.abs(rec.parameters.amount) >= 500000
551
- ) {
552
- // 500 dollars in milliunits
553
- expect(rec.priority).toMatch(/^(high|medium)$/);
554
- }
555
- }
556
- },
557
- );
558
- });
559
-
560
- describe('recommendation field validation', () => {
561
- it(
562
- 'should include all required metadata fields',
563
- { meta: { tier: 'domain', domain: 'reconciliation' } },
564
- () => {
565
- const csvContent = 'Date,Description,Amount\n2024-01-15,Test,10.00';
566
- const ynabTransactions: ynab.TransactionDetail[] = [];
567
-
568
- const analysis = analyzeReconciliation(
569
- csvContent,
570
- undefined,
571
- ynabTransactions,
572
- 10.0,
573
- {
574
- dateToleranceDays: 2,
575
- amountToleranceCents: 1,
576
- descriptionSimilarityThreshold: 0.8,
577
- autoMatchThreshold: 90,
578
- suggestionThreshold: 60,
579
- },
580
- 'USD',
581
- 'test-account-id',
582
- 'test-budget-id',
583
- );
584
-
585
- expect(analysis.recommendations).toBeDefined();
586
- expect(analysis.recommendations!.length).toBeGreaterThan(0);
587
-
588
- for (const rec of analysis.recommendations!) {
589
- // Base recommendation fields
590
- expect(rec.id).toBeDefined();
591
- expect(typeof rec.id).toBe('string');
592
- expect(rec.priority).toMatch(/^(high|medium|low)$/);
593
- expect(typeof rec.confidence).toBe('number');
594
- expect(rec.confidence).toBeGreaterThanOrEqual(0);
595
- expect(rec.confidence).toBeLessThanOrEqual(1);
596
- expect(typeof rec.message).toBe('string');
597
- expect(rec.message.length).toBeGreaterThan(0);
598
- expect(typeof rec.reason).toBe('string');
599
- expect(rec.reason.length).toBeGreaterThan(0);
600
- expect(rec.estimated_impact).toBeDefined();
601
- expect(rec.estimated_impact.value).toBeDefined();
602
- expect(rec.estimated_impact.currency).toBe('USD');
603
- expect(rec.account_id).toBe('test-account-id');
604
-
605
- // Metadata
606
- expect(rec.metadata).toBeDefined();
607
- expect(rec.metadata.version).toBe('1.0');
608
- expect(rec.metadata.created_at).toBeDefined();
609
- expect(Date.parse(rec.metadata.created_at)).not.toBeNaN();
610
-
611
- // Action-specific fields
612
- expect(rec.action_type).toMatch(
613
- /^(create_transaction|update_cleared|review_duplicate|manual_review)$/,
614
- );
615
- expect(rec.parameters).toBeDefined();
616
- }
617
- },
618
- );
619
-
620
- it(
621
- 'should generate valid create_transaction parameters',
622
- { meta: { tier: 'domain', domain: 'reconciliation' } },
623
- () => {
624
- const csvContent = 'Date,Description,Amount\n2024-01-15,Test Store,25.50';
625
- const ynabTransactions: ynab.TransactionDetail[] = [];
626
-
627
- const analysis = analyzeReconciliation(
628
- csvContent,
629
- undefined,
630
- ynabTransactions,
631
- 25.5,
632
- {
633
- dateToleranceDays: 2,
634
- amountToleranceCents: 1,
635
- descriptionSimilarityThreshold: 0.8,
636
- autoMatchThreshold: 90,
637
- suggestionThreshold: 60,
638
- },
639
- 'USD',
640
- 'test-account-id',
641
- 'test-budget-id',
642
- );
643
-
644
- const createRec = analysis.recommendations!.find(
645
- (rec) => rec.action_type === 'create_transaction',
646
- ) as Extract<ActionableRecommendation, { action_type: 'create_transaction' }> | undefined;
647
-
648
- expect(createRec).toBeDefined();
649
- expect(createRec!.parameters.account_id).toBe('test-account-id');
650
- expect(createRec!.parameters.date).toBe('2024-01-15');
651
- expect(createRec!.parameters.amount).toBe(25500); // In milliunits
652
- expect(createRec!.parameters.payee_name).toBe('Test Store');
653
- expect(createRec!.parameters.cleared).toMatch(/^(cleared|uncleared)$/);
654
- expect(typeof createRec!.parameters.approved).toBe('boolean');
655
- },
656
- );
657
- });
567
+ const ynabTransactions: ynab.TransactionDetail[] = [
568
+ createYNABTransaction(
569
+ "ynab-1",
570
+ "2024-01-15",
571
+ 500000,
572
+ "Transaction A",
573
+ "cleared",
574
+ ),
575
+ ];
576
+
577
+ const analysis = analyzeReconciliation(
578
+ csvContent,
579
+ undefined,
580
+ ynabTransactions,
581
+ 2250.0, // Large statement balance
582
+ {
583
+ dateToleranceDays: 2,
584
+ amountToleranceCents: 1,
585
+ descriptionSimilarityThreshold: 0.8,
586
+ autoMatchThreshold: 90,
587
+ suggestionThreshold: 60,
588
+ },
589
+ "USD",
590
+ "test-account-id",
591
+ "test-budget-id",
592
+ );
593
+
594
+ expect(analysis.recommendations).toBeDefined();
595
+
596
+ // Should have insights about large discrepancy
597
+ const anomalyInsight = analysis.insights.find(
598
+ (insight) => insight.type === "anomaly",
599
+ );
600
+ expect(anomalyInsight).toBeDefined();
601
+
602
+ // Should have recommendations for the unmatched transactions
603
+ const createRecs = analysis.recommendations?.filter(
604
+ (rec) => rec.action_type === "create_transaction",
605
+ );
606
+ expect(createRecs.length).toBeGreaterThanOrEqual(2);
607
+
608
+ // Large amounts should have high or medium priority
609
+ for (const rec of createRecs) {
610
+ if (
611
+ rec.action_type === "create_transaction" &&
612
+ Math.abs(rec.parameters.amount) >= 500000
613
+ ) {
614
+ // 500 dollars in milliunits
615
+ expect(rec.priority).toMatch(/^(high|medium)$/);
616
+ }
617
+ }
618
+ },
619
+ );
620
+ });
621
+
622
+ describe("recommendation field validation", () => {
623
+ it(
624
+ "should include all required metadata fields",
625
+ { meta: { tier: "domain", domain: "reconciliation" } },
626
+ () => {
627
+ const csvContent = "Date,Description,Amount\n2024-01-15,Test,10.00";
628
+ const ynabTransactions: ynab.TransactionDetail[] = [];
629
+
630
+ const analysis = analyzeReconciliation(
631
+ csvContent,
632
+ undefined,
633
+ ynabTransactions,
634
+ 10.0,
635
+ {
636
+ dateToleranceDays: 2,
637
+ amountToleranceCents: 1,
638
+ descriptionSimilarityThreshold: 0.8,
639
+ autoMatchThreshold: 90,
640
+ suggestionThreshold: 60,
641
+ },
642
+ "USD",
643
+ "test-account-id",
644
+ "test-budget-id",
645
+ );
646
+
647
+ expect(analysis.recommendations).toBeDefined();
648
+ expect(analysis.recommendations?.length).toBeGreaterThan(0);
649
+
650
+ for (const rec of analysis.recommendations!) {
651
+ // Base recommendation fields
652
+ expect(rec.id).toBeDefined();
653
+ expect(typeof rec.id).toBe("string");
654
+ expect(rec.priority).toMatch(/^(high|medium|low)$/);
655
+ expect(typeof rec.confidence).toBe("number");
656
+ expect(rec.confidence).toBeGreaterThanOrEqual(0);
657
+ expect(rec.confidence).toBeLessThanOrEqual(1);
658
+ expect(typeof rec.message).toBe("string");
659
+ expect(rec.message.length).toBeGreaterThan(0);
660
+ expect(typeof rec.reason).toBe("string");
661
+ expect(rec.reason.length).toBeGreaterThan(0);
662
+ expect(rec.estimated_impact).toBeDefined();
663
+ expect(rec.estimated_impact.value).toBeDefined();
664
+ expect(rec.estimated_impact.currency).toBe("USD");
665
+ expect(rec.account_id).toBe("test-account-id");
666
+
667
+ // Metadata
668
+ expect(rec.metadata).toBeDefined();
669
+ expect(rec.metadata.version).toBe("1.0");
670
+ expect(rec.metadata.created_at).toBeDefined();
671
+ expect(Date.parse(rec.metadata.created_at)).not.toBeNaN();
672
+
673
+ // Action-specific fields
674
+ expect(rec.action_type).toMatch(
675
+ /^(create_transaction|update_cleared|review_duplicate|manual_review)$/,
676
+ );
677
+ expect(rec.parameters).toBeDefined();
678
+ }
679
+ },
680
+ );
681
+
682
+ it(
683
+ "should generate valid create_transaction parameters",
684
+ { meta: { tier: "domain", domain: "reconciliation" } },
685
+ () => {
686
+ const csvContent =
687
+ "Date,Description,Amount\n2024-01-15,Test Store,25.50";
688
+ const ynabTransactions: ynab.TransactionDetail[] = [];
689
+
690
+ const analysis = analyzeReconciliation(
691
+ csvContent,
692
+ undefined,
693
+ ynabTransactions,
694
+ 25.5,
695
+ {
696
+ dateToleranceDays: 2,
697
+ amountToleranceCents: 1,
698
+ descriptionSimilarityThreshold: 0.8,
699
+ autoMatchThreshold: 90,
700
+ suggestionThreshold: 60,
701
+ },
702
+ "USD",
703
+ "test-account-id",
704
+ "test-budget-id",
705
+ );
706
+
707
+ const createRec = analysis.recommendations?.find(
708
+ (rec) => rec.action_type === "create_transaction",
709
+ ) as
710
+ | Extract<
711
+ ActionableRecommendation,
712
+ { action_type: "create_transaction" }
713
+ >
714
+ | undefined;
715
+
716
+ expect(createRec).toBeDefined();
717
+ expect(createRec?.parameters.account_id).toBe("test-account-id");
718
+ expect(createRec?.parameters.date).toBe("2024-01-15");
719
+ expect(createRec?.parameters.amount).toBe(25500); // In milliunits
720
+ expect(createRec?.parameters.payee_name).toBe("Test Store");
721
+ expect(createRec?.parameters.cleared).toMatch(/^(cleared|uncleared)$/);
722
+ expect(typeof createRec?.parameters.approved).toBe("boolean");
723
+ },
724
+ );
725
+ });
658
726
  });