@dizzlkheinz/ynab-mcpb 0.18.4 → 0.19.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (343) hide show
  1. package/CLAUDE.md +87 -8
  2. package/bin/ynab-mcp-server.cjs +2 -2
  3. package/bin/ynab-mcp-server.js +3 -3
  4. package/biome.json +39 -0
  5. package/dist/bundle/index.cjs +67 -67
  6. package/dist/index.d.ts +1 -1
  7. package/dist/index.js +27 -27
  8. package/dist/server/YNABMCPServer.d.ts +3 -4
  9. package/dist/server/YNABMCPServer.js +111 -116
  10. package/dist/server/budgetResolver.d.ts +6 -5
  11. package/dist/server/budgetResolver.js +46 -36
  12. package/dist/server/cacheKeys.js +6 -6
  13. package/dist/server/cacheManager.js +14 -11
  14. package/dist/server/completions.d.ts +2 -2
  15. package/dist/server/completions.js +20 -15
  16. package/dist/server/config.d.ts +10 -5
  17. package/dist/server/config.js +24 -7
  18. package/dist/server/deltaCache.d.ts +2 -2
  19. package/dist/server/deltaCache.js +22 -16
  20. package/dist/server/deltaCache.merge.d.ts +2 -2
  21. package/dist/server/diagnostics.d.ts +4 -4
  22. package/dist/server/diagnostics.js +38 -32
  23. package/dist/server/errorHandler.d.ts +5 -12
  24. package/dist/server/errorHandler.js +219 -217
  25. package/dist/server/prompts.d.ts +2 -2
  26. package/dist/server/prompts.js +45 -45
  27. package/dist/server/rateLimiter.js +4 -4
  28. package/dist/server/requestLogger.d.ts +1 -1
  29. package/dist/server/requestLogger.js +40 -35
  30. package/dist/server/resources.d.ts +3 -3
  31. package/dist/server/resources.js +55 -52
  32. package/dist/server/responseFormatter.js +6 -6
  33. package/dist/server/securityMiddleware.d.ts +2 -2
  34. package/dist/server/securityMiddleware.js +22 -20
  35. package/dist/server/serverKnowledgeStore.js +1 -1
  36. package/dist/server/toolRegistry.d.ts +3 -3
  37. package/dist/server/toolRegistry.js +47 -40
  38. package/dist/tools/__tests__/deltaTestUtils.d.ts +3 -3
  39. package/dist/tools/__tests__/deltaTestUtils.js +2 -2
  40. package/dist/tools/accountTools.d.ts +9 -8
  41. package/dist/tools/accountTools.js +47 -47
  42. package/dist/tools/adapters.d.ts +13 -8
  43. package/dist/tools/adapters.js +21 -11
  44. package/dist/tools/budgetTools.d.ts +8 -7
  45. package/dist/tools/budgetTools.js +22 -22
  46. package/dist/tools/categoryTools.d.ts +9 -8
  47. package/dist/tools/categoryTools.js +68 -59
  48. package/dist/tools/compareTransactions/formatter.d.ts +3 -3
  49. package/dist/tools/compareTransactions/formatter.js +9 -9
  50. package/dist/tools/compareTransactions/index.d.ts +6 -6
  51. package/dist/tools/compareTransactions/index.js +58 -43
  52. package/dist/tools/compareTransactions/matcher.d.ts +1 -1
  53. package/dist/tools/compareTransactions/matcher.js +28 -15
  54. package/dist/tools/compareTransactions/parser.d.ts +2 -2
  55. package/dist/tools/compareTransactions/parser.js +144 -138
  56. package/dist/tools/compareTransactions/types.d.ts +4 -4
  57. package/dist/tools/compareTransactions.d.ts +1 -1
  58. package/dist/tools/compareTransactions.js +1 -1
  59. package/dist/tools/deltaFetcher.d.ts +2 -2
  60. package/dist/tools/deltaFetcher.js +16 -15
  61. package/dist/tools/deltaSupport.d.ts +4 -4
  62. package/dist/tools/deltaSupport.js +35 -41
  63. package/dist/tools/exportTransactions.d.ts +5 -4
  64. package/dist/tools/exportTransactions.js +61 -59
  65. package/dist/tools/monthTools.d.ts +7 -6
  66. package/dist/tools/monthTools.js +31 -29
  67. package/dist/tools/payeeTools.d.ts +7 -6
  68. package/dist/tools/payeeTools.js +28 -28
  69. package/dist/tools/reconcileAdapter.d.ts +2 -2
  70. package/dist/tools/reconcileAdapter.js +19 -12
  71. package/dist/tools/reconciliation/analyzer.d.ts +4 -4
  72. package/dist/tools/reconciliation/analyzer.js +73 -59
  73. package/dist/tools/reconciliation/csvParser.d.ts +3 -3
  74. package/dist/tools/reconciliation/csvParser.js +128 -104
  75. package/dist/tools/reconciliation/executor.d.ts +4 -4
  76. package/dist/tools/reconciliation/executor.js +148 -109
  77. package/dist/tools/reconciliation/index.d.ts +10 -10
  78. package/dist/tools/reconciliation/index.js +96 -83
  79. package/dist/tools/reconciliation/matcher.d.ts +3 -3
  80. package/dist/tools/reconciliation/matcher.js +17 -16
  81. package/dist/tools/reconciliation/payeeNormalizer.js +19 -8
  82. package/dist/tools/reconciliation/recommendationEngine.d.ts +1 -1
  83. package/dist/tools/reconciliation/recommendationEngine.js +40 -40
  84. package/dist/tools/reconciliation/reportFormatter.d.ts +2 -2
  85. package/dist/tools/reconciliation/reportFormatter.js +59 -58
  86. package/dist/tools/reconciliation/signDetector.d.ts +1 -1
  87. package/dist/tools/reconciliation/types.d.ts +16 -16
  88. package/dist/tools/reconciliation/ynabAdapter.d.ts +2 -2
  89. package/dist/tools/schemas/common.d.ts +1 -1
  90. package/dist/tools/schemas/common.js +1 -1
  91. package/dist/tools/schemas/outputs/accountOutputs.d.ts +1 -1
  92. package/dist/tools/schemas/outputs/accountOutputs.js +24 -18
  93. package/dist/tools/schemas/outputs/budgetOutputs.d.ts +1 -1
  94. package/dist/tools/schemas/outputs/budgetOutputs.js +14 -11
  95. package/dist/tools/schemas/outputs/categoryOutputs.d.ts +1 -1
  96. package/dist/tools/schemas/outputs/categoryOutputs.js +49 -29
  97. package/dist/tools/schemas/outputs/comparisonOutputs.d.ts +1 -1
  98. package/dist/tools/schemas/outputs/comparisonOutputs.js +12 -12
  99. package/dist/tools/schemas/outputs/index.d.ts +14 -14
  100. package/dist/tools/schemas/outputs/index.js +14 -14
  101. package/dist/tools/schemas/outputs/monthOutputs.d.ts +1 -1
  102. package/dist/tools/schemas/outputs/monthOutputs.js +56 -41
  103. package/dist/tools/schemas/outputs/payeeOutputs.d.ts +1 -1
  104. package/dist/tools/schemas/outputs/payeeOutputs.js +10 -10
  105. package/dist/tools/schemas/outputs/reconciliationOutputs.d.ts +2 -2
  106. package/dist/tools/schemas/outputs/reconciliationOutputs.js +45 -45
  107. package/dist/tools/schemas/outputs/transactionMutationOutputs.d.ts +1 -1
  108. package/dist/tools/schemas/outputs/transactionMutationOutputs.js +28 -22
  109. package/dist/tools/schemas/outputs/transactionOutputs.d.ts +1 -1
  110. package/dist/tools/schemas/outputs/transactionOutputs.js +43 -35
  111. package/dist/tools/schemas/outputs/utilityOutputs.d.ts +1 -1
  112. package/dist/tools/schemas/outputs/utilityOutputs.js +5 -3
  113. package/dist/tools/schemas/shared/commonOutputs.d.ts +1 -1
  114. package/dist/tools/schemas/shared/commonOutputs.js +15 -9
  115. package/dist/tools/transactionReadTools.d.ts +11 -0
  116. package/dist/tools/transactionReadTools.js +202 -0
  117. package/dist/tools/transactionSchemas.d.ts +7 -7
  118. package/dist/tools/transactionSchemas.js +77 -57
  119. package/dist/tools/transactionTools.d.ts +6 -24
  120. package/dist/tools/transactionTools.js +7 -1499
  121. package/dist/tools/transactionUtils.d.ts +6 -6
  122. package/dist/tools/transactionUtils.js +78 -63
  123. package/dist/tools/transactionWriteTools.d.ts +20 -0
  124. package/dist/tools/transactionWriteTools.js +1342 -0
  125. package/dist/tools/utilityTools.d.ts +5 -4
  126. package/dist/tools/utilityTools.js +11 -11
  127. package/dist/types/index.d.ts +7 -7
  128. package/dist/types/index.js +6 -6
  129. package/dist/types/reconciliation.d.ts +1 -1
  130. package/dist/types/toolRegistration.d.ts +14 -12
  131. package/dist/utils/amountUtils.js +1 -1
  132. package/dist/utils/dateUtils.js +4 -4
  133. package/dist/utils/errors.d.ts +3 -3
  134. package/dist/utils/errors.js +4 -4
  135. package/dist/utils/money.d.ts +2 -2
  136. package/dist/utils/money.js +8 -8
  137. package/dist/utils/validationError.d.ts +1 -1
  138. package/dist/utils/validationError.js +1 -1
  139. package/docs/assets/examples/reconciliation-with-recommendations.json +66 -66
  140. package/docs/assets/schemas/reconciliation-v2.json +360 -336
  141. package/esbuild.config.mjs +53 -50
  142. package/meta.json +12548 -12548
  143. package/package.json +98 -111
  144. package/scripts/analyze-bundle.mjs +33 -30
  145. package/scripts/create-pr-description.js +169 -120
  146. package/scripts/run-all-tests.js +178 -169
  147. package/scripts/run-domain-integration-tests.js +28 -18
  148. package/scripts/run-generate-mcpb.js +19 -17
  149. package/scripts/run-throttled-integration-tests.js +92 -83
  150. package/scripts/test-delta-params.mjs +149 -120
  151. package/scripts/test-recommendations.ts +36 -32
  152. package/scripts/tmpTransaction.ts +80 -43
  153. package/scripts/validate-env.js +98 -91
  154. package/scripts/verify-build.js +78 -76
  155. package/src/__tests__/comprehensive.integration.test.ts +1281 -1154
  156. package/src/__tests__/performance.test.ts +723 -671
  157. package/src/__tests__/setup.ts +442 -395
  158. package/src/__tests__/smoke.e2e.test.ts +41 -39
  159. package/src/__tests__/testRunner.ts +314 -295
  160. package/src/__tests__/testUtils.ts +456 -364
  161. package/src/__tests__/tools/reconciliation/csvParser.integration.test.ts +109 -107
  162. package/src/__tests__/tools/reconciliation/real-world.integration.test.ts +41 -41
  163. package/src/index.ts +68 -59
  164. package/src/server/CLAUDE.md +480 -0
  165. package/src/server/YNABMCPServer.ts +821 -794
  166. package/src/server/__tests__/YNABMCPServer.integration.test.ts +929 -893
  167. package/src/server/__tests__/YNABMCPServer.test.ts +903 -899
  168. package/src/server/__tests__/budgetResolver.test.ts +466 -423
  169. package/src/server/__tests__/cacheManager.test.ts +891 -874
  170. package/src/server/__tests__/completions.integration.test.ts +115 -106
  171. package/src/server/__tests__/completions.test.ts +334 -313
  172. package/src/server/__tests__/config.test.ts +98 -86
  173. package/src/server/__tests__/deltaCache.merge.test.ts +774 -703
  174. package/src/server/__tests__/deltaCache.swr.test.ts +198 -153
  175. package/src/server/__tests__/deltaCache.test.ts +946 -759
  176. package/src/server/__tests__/diagnostics.test.ts +825 -792
  177. package/src/server/__tests__/errorHandler.integration.test.ts +512 -462
  178. package/src/server/__tests__/errorHandler.test.ts +402 -397
  179. package/src/server/__tests__/prompts.test.ts +424 -347
  180. package/src/server/__tests__/rateLimiter.test.ts +313 -309
  181. package/src/server/__tests__/requestLogger.test.ts +443 -403
  182. package/src/server/__tests__/resources.template.test.ts +196 -185
  183. package/src/server/__tests__/resources.test.ts +294 -288
  184. package/src/server/__tests__/security.integration.test.ts +487 -421
  185. package/src/server/__tests__/securityMiddleware.test.ts +519 -444
  186. package/src/server/__tests__/server-startup.integration.test.ts +509 -490
  187. package/src/server/__tests__/serverKnowledgeStore.test.ts +174 -173
  188. package/src/server/__tests__/toolRegistration.test.ts +239 -210
  189. package/src/server/__tests__/toolRegistry.test.ts +907 -845
  190. package/src/server/budgetResolver.ts +221 -181
  191. package/src/server/cacheKeys.ts +6 -6
  192. package/src/server/cacheManager.ts +498 -484
  193. package/src/server/completions.ts +267 -243
  194. package/src/server/config.ts +35 -14
  195. package/src/server/deltaCache.merge.ts +146 -128
  196. package/src/server/deltaCache.ts +352 -309
  197. package/src/server/diagnostics.ts +257 -242
  198. package/src/server/errorHandler.ts +747 -744
  199. package/src/server/prompts.ts +181 -176
  200. package/src/server/rateLimiter.ts +131 -129
  201. package/src/server/requestLogger.ts +350 -322
  202. package/src/server/resources.ts +442 -374
  203. package/src/server/responseFormatter.ts +41 -37
  204. package/src/server/securityMiddleware.ts +223 -205
  205. package/src/server/serverKnowledgeStore.ts +67 -67
  206. package/src/server/toolRegistry.ts +508 -474
  207. package/src/tools/CLAUDE.md +604 -0
  208. package/src/tools/__tests__/accountTools.delta.integration.test.ts +128 -111
  209. package/src/tools/__tests__/accountTools.integration.test.ts +129 -111
  210. package/src/tools/__tests__/accountTools.test.ts +685 -638
  211. package/src/tools/__tests__/adapters.test.ts +142 -108
  212. package/src/tools/__tests__/budgetTools.delta.integration.test.ts +73 -73
  213. package/src/tools/__tests__/budgetTools.integration.test.ts +132 -124
  214. package/src/tools/__tests__/budgetTools.test.ts +442 -413
  215. package/src/tools/__tests__/categoryTools.delta.integration.test.ts +76 -68
  216. package/src/tools/__tests__/categoryTools.integration.test.ts +314 -288
  217. package/src/tools/__tests__/categoryTools.test.ts +656 -625
  218. package/src/tools/__tests__/compareTransactions/formatter.test.ts +535 -462
  219. package/src/tools/__tests__/compareTransactions/index.test.ts +378 -358
  220. package/src/tools/__tests__/compareTransactions/matcher.test.ts +497 -398
  221. package/src/tools/__tests__/compareTransactions/parser.test.ts +765 -747
  222. package/src/tools/__tests__/compareTransactions.test.ts +352 -332
  223. package/src/tools/__tests__/compareTransactions.window.test.ts +150 -146
  224. package/src/tools/__tests__/deltaFetcher.scheduled.integration.test.ts +69 -65
  225. package/src/tools/__tests__/deltaFetcher.test.ts +325 -265
  226. package/src/tools/__tests__/deltaSupport.test.ts +211 -184
  227. package/src/tools/__tests__/deltaTestUtils.ts +37 -33
  228. package/src/tools/__tests__/exportTransactions.test.ts +205 -200
  229. package/src/tools/__tests__/monthTools.delta.integration.test.ts +68 -68
  230. package/src/tools/__tests__/monthTools.integration.test.ts +178 -166
  231. package/src/tools/__tests__/monthTools.test.ts +561 -512
  232. package/src/tools/__tests__/payeeTools.delta.integration.test.ts +68 -68
  233. package/src/tools/__tests__/payeeTools.integration.test.ts +158 -142
  234. package/src/tools/__tests__/payeeTools.test.ts +486 -434
  235. package/src/tools/__tests__/transactionSchemas.test.ts +1202 -1186
  236. package/src/tools/__tests__/transactionTools.integration.test.ts +875 -825
  237. package/src/tools/__tests__/transactionTools.test.ts +4923 -4366
  238. package/src/tools/__tests__/transactionUtils.test.ts +1004 -977
  239. package/src/tools/__tests__/utilityTools.integration.test.ts +32 -32
  240. package/src/tools/__tests__/utilityTools.test.ts +68 -58
  241. package/src/tools/accountTools.ts +293 -271
  242. package/src/tools/adapters.ts +120 -63
  243. package/src/tools/budgetTools.ts +121 -116
  244. package/src/tools/categoryTools.ts +379 -339
  245. package/src/tools/compareTransactions/formatter.ts +131 -119
  246. package/src/tools/compareTransactions/index.ts +249 -214
  247. package/src/tools/compareTransactions/matcher.ts +259 -209
  248. package/src/tools/compareTransactions/parser.ts +517 -487
  249. package/src/tools/compareTransactions/types.ts +38 -38
  250. package/src/tools/compareTransactions.ts +1 -1
  251. package/src/tools/deltaFetcher.ts +281 -260
  252. package/src/tools/deltaSupport.ts +264 -259
  253. package/src/tools/exportTransactions.ts +230 -218
  254. package/src/tools/monthTools.ts +180 -165
  255. package/src/tools/payeeTools.ts +152 -140
  256. package/src/tools/reconcileAdapter.ts +297 -252
  257. package/src/tools/reconciliation/CLAUDE.md +506 -0
  258. package/src/tools/reconciliation/__tests__/adapter.causes.test.ts +133 -124
  259. package/src/tools/reconciliation/__tests__/adapter.test.ts +249 -230
  260. package/src/tools/reconciliation/__tests__/analyzer.test.ts +408 -400
  261. package/src/tools/reconciliation/__tests__/csvParser.test.ts +71 -69
  262. package/src/tools/reconciliation/__tests__/executor.integration.test.ts +348 -323
  263. package/src/tools/reconciliation/__tests__/executor.progress.test.ts +503 -457
  264. package/src/tools/reconciliation/__tests__/executor.test.ts +898 -831
  265. package/src/tools/reconciliation/__tests__/matcher.test.ts +667 -663
  266. package/src/tools/reconciliation/__tests__/payeeNormalizer.test.ts +296 -276
  267. package/src/tools/reconciliation/__tests__/recommendationEngine.integration.test.ts +692 -624
  268. package/src/tools/reconciliation/__tests__/recommendationEngine.test.ts +1008 -989
  269. package/src/tools/reconciliation/__tests__/reconciliation.delta.integration.test.ts +187 -146
  270. package/src/tools/reconciliation/__tests__/reportFormatter.test.ts +583 -533
  271. package/src/tools/reconciliation/__tests__/scenarios/adapterCurrency.scenario.test.ts +75 -74
  272. package/src/tools/reconciliation/__tests__/scenarios/extremes.scenario.test.ts +70 -62
  273. package/src/tools/reconciliation/__tests__/scenarios/repeatAmount.scenario.test.ts +102 -88
  274. package/src/tools/reconciliation/__tests__/schemaUrl.test.ts +56 -55
  275. package/src/tools/reconciliation/__tests__/signDetector.test.ts +209 -206
  276. package/src/tools/reconciliation/__tests__/ynabAdapter.test.ts +66 -60
  277. package/src/tools/reconciliation/analyzer.ts +564 -504
  278. package/src/tools/reconciliation/csvParser.ts +656 -609
  279. package/src/tools/reconciliation/executor.ts +1290 -1128
  280. package/src/tools/reconciliation/index.ts +580 -528
  281. package/src/tools/reconciliation/matcher.ts +256 -240
  282. package/src/tools/reconciliation/payeeNormalizer.ts +92 -78
  283. package/src/tools/reconciliation/recommendationEngine.ts +357 -345
  284. package/src/tools/reconciliation/reportFormatter.ts +343 -307
  285. package/src/tools/reconciliation/signDetector.ts +89 -83
  286. package/src/tools/reconciliation/types.ts +164 -159
  287. package/src/tools/reconciliation/ynabAdapter.ts +17 -15
  288. package/src/tools/schemas/CLAUDE.md +546 -0
  289. package/src/tools/schemas/common.ts +1 -1
  290. package/src/tools/schemas/outputs/__tests__/accountOutputs.test.ts +410 -409
  291. package/src/tools/schemas/outputs/__tests__/budgetOutputs.test.ts +305 -299
  292. package/src/tools/schemas/outputs/__tests__/categoryOutputs.test.ts +431 -430
  293. package/src/tools/schemas/outputs/__tests__/comparisonOutputs.test.ts +510 -495
  294. package/src/tools/schemas/outputs/__tests__/dateValidation.test.ts +179 -153
  295. package/src/tools/schemas/outputs/__tests__/discrepancyDirection.test.ts +293 -254
  296. package/src/tools/schemas/outputs/__tests__/monthOutputs.test.ts +457 -457
  297. package/src/tools/schemas/outputs/__tests__/payeeOutputs.test.ts +362 -356
  298. package/src/tools/schemas/outputs/__tests__/reconciliationOutputs.test.ts +402 -399
  299. package/src/tools/schemas/outputs/__tests__/transactionMutationSchemas.test.ts +225 -211
  300. package/src/tools/schemas/outputs/__tests__/transactionOutputs.test.ts +457 -454
  301. package/src/tools/schemas/outputs/__tests__/utilityOutputs.test.ts +316 -315
  302. package/src/tools/schemas/outputs/accountOutputs.ts +40 -34
  303. package/src/tools/schemas/outputs/budgetOutputs.ts +24 -19
  304. package/src/tools/schemas/outputs/categoryOutputs.ts +76 -56
  305. package/src/tools/schemas/outputs/comparisonOutputs.ts +192 -169
  306. package/src/tools/schemas/outputs/index.ts +163 -163
  307. package/src/tools/schemas/outputs/monthOutputs.ts +95 -80
  308. package/src/tools/schemas/outputs/payeeOutputs.ts +18 -18
  309. package/src/tools/schemas/outputs/reconciliationOutputs.ts +386 -373
  310. package/src/tools/schemas/outputs/transactionMutationOutputs.ts +259 -231
  311. package/src/tools/schemas/outputs/transactionOutputs.ts +81 -71
  312. package/src/tools/schemas/outputs/utilityOutputs.ts +90 -84
  313. package/src/tools/schemas/shared/commonOutputs.ts +27 -19
  314. package/src/tools/toolCategories.ts +114 -114
  315. package/src/tools/transactionReadTools.ts +327 -0
  316. package/src/tools/transactionSchemas.ts +322 -291
  317. package/src/tools/transactionTools.ts +84 -2246
  318. package/src/tools/transactionUtils.ts +507 -422
  319. package/src/tools/transactionWriteTools.ts +2110 -0
  320. package/src/tools/utilityTools.ts +46 -41
  321. package/src/types/CLAUDE.md +477 -0
  322. package/src/types/__tests__/index.test.ts +51 -51
  323. package/src/types/index.ts +43 -39
  324. package/src/types/integration-tests.d.ts +26 -26
  325. package/src/types/reconciliation.ts +29 -29
  326. package/src/types/toolAnnotations.ts +30 -30
  327. package/src/types/toolRegistration.ts +43 -32
  328. package/src/utils/CLAUDE.md +508 -0
  329. package/src/utils/__tests__/dateUtils.test.ts +174 -168
  330. package/src/utils/__tests__/money.test.ts +193 -187
  331. package/src/utils/amountUtils.ts +5 -5
  332. package/src/utils/baseError.ts +5 -5
  333. package/src/utils/dateUtils.ts +29 -26
  334. package/src/utils/errors.ts +14 -14
  335. package/src/utils/money.ts +66 -52
  336. package/src/utils/validationError.ts +1 -1
  337. package/tsconfig.json +29 -29
  338. package/tsconfig.prod.json +16 -16
  339. package/vitest-reporters/split-json-reporter.ts +247 -204
  340. package/vitest.config.ts +99 -95
  341. package/.prettierignore +0 -10
  342. package/.prettierrc.json +0 -10
  343. package/eslint.config.js +0 -49
package/docs/assets/schemas/reconciliation-v2.json CHANGED
@@ -1,338 +1,362 @@
1
1
  {
2
- "$schema": "http://json-schema.org/draft-07/schema#",
3
- "title": "YNAB MCP Reconciliation v2 Payload",
4
- "type": "object",
5
- "properties": {
6
- "version": { "const": "2.0" },
7
- "schema_url": { "type": "string", "format": "uri" },
8
- "generated_at": { "type": "string", "format": "date-time" },
9
- "account": {
10
- "type": "object",
11
- "properties": {
12
- "id": { "type": ["string", "null"] },
13
- "name": { "type": ["string", "null"] }
14
- },
15
- "required": ["id"],
16
- "additionalProperties": false
17
- },
18
- "summary": { "$ref": "#/definitions/summary" },
19
- "balance": { "$ref": "#/definitions/balance" },
20
- "insights": {
21
- "type": "array",
22
- "items": { "$ref": "#/definitions/insight" }
23
- },
24
- "next_steps": {
25
- "type": "array",
26
- "items": { "type": "string" }
27
- },
28
- "csv_format": { "$ref": "#/definitions/csvFormat" },
29
- "matches": {
30
- "type": "object",
31
- "properties": {
32
- "auto": {
33
- "type": "array",
34
- "items": { "$ref": "#/definitions/match" }
35
- },
36
- "suggested": {
37
- "type": "array",
38
- "items": { "$ref": "#/definitions/match" }
39
- }
40
- },
41
- "required": ["auto", "suggested"],
42
- "additionalProperties": false
43
- },
44
- "unmatched": {
45
- "type": "object",
46
- "properties": {
47
- "bank": {
48
- "type": "array",
49
- "items": { "$ref": "#/definitions/bankTransaction" }
50
- },
51
- "ynab": {
52
- "type": "array",
53
- "items": { "$ref": "#/definitions/ynabTransaction" }
54
- }
55
- },
56
- "required": ["bank", "ynab"],
57
- "additionalProperties": false
58
- },
59
- "execution": {
60
- "type": ["object", "null"],
61
- "properties": {
62
- "summary": { "$ref": "#/definitions/executionSummary" },
63
- "account_balance": {
64
- "type": "object",
65
- "properties": {
66
- "before": { "$ref": "#/definitions/accountSnapshot" },
67
- "after": { "$ref": "#/definitions/accountSnapshot" }
68
- },
69
- "required": ["before", "after"],
70
- "additionalProperties": false
71
- },
72
- "actions_taken": {
73
- "type": "array",
74
- "items": {
75
- "type": "object",
76
- "properties": {
77
- "type": { "type": "string" },
78
- "transaction": { "type": ["object", "null"] },
79
- "reason": { "type": "string" }
80
- },
81
- "required": ["type", "reason"],
82
- "additionalProperties": true
83
- }
84
- },
85
- "recommendations": {
86
- "type": "array",
87
- "items": { "type": "string" }
88
- },
89
- "balance_reconciliation": {
90
- "type": ["object", "null"],
91
- "properties": {
92
- "status": { "type": "string" },
93
- "precision_calculations": {
94
- "type": ["object", "null"],
95
- "properties": {
96
- "bank_statement_balance": { "$ref": "#/definitions/moneyValue" },
97
- "ynab_calculated_balance": { "$ref": "#/definitions/moneyValue" },
98
- "discrepancy": { "$ref": "#/definitions/moneyValue" },
99
- "discrepancy_decimal": { "$ref": "#/definitions/moneyValue" }
100
- },
101
- "additionalProperties": false
102
- },
103
- "discrepancy_analysis": { "$ref": "#/definitions/discrepancyAnalysis" },
104
- "final_verification": {
105
- "type": "object",
106
- "properties": {
107
- "balance_matches_exactly": { "type": "boolean" },
108
- "all_transactions_accounted": { "type": "boolean" },
109
- "audit_trail_complete": { "type": "boolean" },
110
- "reconciliation_complete": { "type": "boolean" }
111
- },
112
- "required": [
113
- "balance_matches_exactly",
114
- "all_transactions_accounted",
115
- "audit_trail_complete",
116
- "reconciliation_complete"
117
- ],
118
- "additionalProperties": false
119
- }
120
- },
121
- "additionalProperties": false
122
- }
123
- },
124
- "additionalProperties": false
125
- }
126
- },
127
- "required": ["version", "generated_at", "summary", "balance", "matches", "unmatched"],
128
- "additionalProperties": false,
129
- "definitions": {
130
- "moneyValue": {
131
- "type": "object",
132
- "properties": {
133
- "value_milliunits": { "type": "number" },
134
- "value": { "type": "number" },
135
- "value_display": { "type": "string" },
136
- "currency": { "type": "string" },
137
- "direction": { "type": "string", "enum": ["credit", "debit", "balanced"] }
138
- },
139
- "required": ["value_milliunits", "value_display", "currency", "direction"],
140
- "additionalProperties": false
141
- },
142
- "csvFormat": {
143
- "type": "object",
144
- "properties": {
145
- "delimiter": { "type": "string" },
146
- "decimal_separator": { "type": "string" },
147
- "thousands_separator": { "type": ["string", "null"] },
148
- "date_format": { "type": "string" },
149
- "header_row": { "type": "boolean" },
150
- "date_column": { "type": ["string", "null"] },
151
- "amount_column": { "type": ["string", "null"] },
152
- "payee_column": { "type": ["string", "null"] }
153
- },
154
- "additionalProperties": false
155
- },
156
- "summary": {
157
- "type": "object",
158
- "properties": {
159
- "statement_date_range": { "type": "string" },
160
- "bank_transactions_count": { "type": "number" },
161
- "ynab_transactions_count": { "type": "number" },
162
- "auto_matched": { "type": "number" },
163
- "suggested_matches": { "type": "number" },
164
- "unmatched_bank": { "type": "number" },
165
- "unmatched_ynab": { "type": "number" },
166
- "current_cleared_balance": { "$ref": "#/definitions/moneyValue" },
167
- "target_statement_balance": { "$ref": "#/definitions/moneyValue" },
168
- "discrepancy": { "$ref": "#/definitions/moneyValue" },
169
- "discrepancy_explanation": { "type": "string" }
170
- },
171
- "required": [
172
- "statement_date_range",
173
- "bank_transactions_count",
174
- "ynab_transactions_count",
175
- "auto_matched",
176
- "suggested_matches",
177
- "unmatched_bank",
178
- "unmatched_ynab",
179
- "current_cleared_balance",
180
- "target_statement_balance",
181
- "discrepancy"
182
- ],
183
- "additionalProperties": false
184
- },
185
- "balance": {
186
- "type": "object",
187
- "properties": {
188
- "current_cleared": { "$ref": "#/definitions/moneyValue" },
189
- "current_uncleared": { "$ref": "#/definitions/moneyValue" },
190
- "current_total": { "$ref": "#/definitions/moneyValue" },
191
- "target_statement": { "$ref": "#/definitions/moneyValue" },
192
- "discrepancy": { "$ref": "#/definitions/moneyValue" },
193
- "discrepancy_direction": {
194
- "type": "string",
195
- "enum": ["bank_higher", "ynab_higher", "balanced"]
196
- },
197
- "on_track": { "type": "boolean" }
198
- },
199
- "required": [
200
- "current_cleared",
201
- "current_uncleared",
202
- "current_total",
203
- "target_statement",
204
- "discrepancy",
205
- "discrepancy_direction"
206
- ],
207
- "additionalProperties": false
208
- },
209
- "insight": {
210
- "type": "object",
211
- "properties": {
212
- "id": { "type": "string" },
213
- "type": { "type": "string" },
214
- "severity": { "type": "string", "enum": ["info", "warning", "critical"] },
215
- "title": { "type": "string" },
216
- "description": { "type": "string" },
217
- "evidence": { "type": "object" }
218
- },
219
- "required": ["id", "type", "severity", "title"],
220
- "additionalProperties": false
221
- },
222
- "match": {
223
- "type": "object",
224
- "properties": {
225
- "bank_transaction": { "$ref": "#/definitions/bankTransaction" },
226
- "ynab_transaction": { "$ref": "#/definitions/ynabTransaction" },
227
- "candidates": {
228
- "type": "array",
229
- "items": {
230
- "type": "object",
231
- "properties": {
232
- "ynab_transaction": { "$ref": "#/definitions/ynabTransaction" },
233
- "confidence": { "type": "number" },
234
- "match_reason": { "type": "string" },
235
- "explanation": { "type": "string" }
236
- },
237
- "required": ["ynab_transaction", "confidence"],
238
- "additionalProperties": true
239
- }
240
- },
241
- "confidence": { "type": "string" },
242
- "confidence_score": { "type": "number" },
243
- "match_reason": { "type": "string" }
244
- },
245
- "required": ["bank_transaction", "confidence"],
246
- "additionalProperties": true
247
- },
248
- "bankTransaction": {
249
- "type": "object",
250
- "properties": {
251
- "id": { "type": "string" },
252
- "date": { "type": "string", "format": "date" },
253
- "amount": { "type": "number" },
254
- "payee": { "type": ["string", "null"] },
255
- "memo": { "type": ["string", "null"] },
256
- "original_csv_row": { "type": "integer" },
257
- "amount_money": { "$ref": "#/definitions/moneyValue" }
258
- },
259
- "required": ["id", "date", "amount"],
260
- "additionalProperties": true
261
- },
262
- "ynabTransaction": {
263
- "type": "object",
264
- "properties": {
265
- "id": { "type": "string" },
266
- "date": { "type": "string", "format": "date" },
267
- "amount": { "type": "number" },
268
- "payee_name": { "type": ["string", "null"] },
269
- "category_name": { "type": ["string", "null"] },
270
- "cleared": { "type": "string" },
271
- "approved": { "type": "boolean" },
272
- "memo": { "type": ["string", "null"] },
273
- "amount_money": { "$ref": "#/definitions/moneyValue" }
274
- },
275
- "required": ["id", "date", "amount", "cleared"],
276
- "additionalProperties": true
277
- },
278
- "accountSnapshot": {
279
- "type": "object",
280
- "properties": {
281
- "balance": { "$ref": "#/definitions/moneyValue" },
282
- "cleared_balance": { "$ref": "#/definitions/moneyValue" },
283
- "uncleared_balance": { "$ref": "#/definitions/moneyValue" }
284
- },
285
- "required": ["balance", "cleared_balance", "uncleared_balance"],
286
- "additionalProperties": false
287
- },
288
- "executionSummary": {
289
- "type": "object",
290
- "properties": {
291
- "bank_transactions_count": { "type": "number" },
292
- "ynab_transactions_count": { "type": "number" },
293
- "matches_found": { "type": "number" },
294
- "missing_in_ynab": { "type": "number" },
295
- "missing_in_bank": { "type": "number" },
296
- "transactions_created": { "type": "number" },
297
- "transactions_updated": { "type": "number" },
298
- "dates_adjusted": { "type": "number" },
299
- "dry_run": { "type": "boolean" }
300
- },
301
- "required": [
302
- "bank_transactions_count",
303
- "ynab_transactions_count",
304
- "matches_found",
305
- "missing_in_ynab",
306
- "missing_in_bank",
307
- "transactions_created",
308
- "transactions_updated",
309
- "dry_run"
310
- ],
311
- "additionalProperties": false
312
- },
313
- "discrepancyAnalysis": {
314
- "type": "object",
315
- "properties": {
316
- "confidence_level": { "type": "number" },
317
- "risk_assessment": { "type": "string" },
318
- "likely_causes": {
319
- "type": "array",
320
- "items": {
321
- "type": "object",
322
- "properties": {
323
- "type": { "type": "string" },
324
- "description": { "type": "string" },
325
- "confidence": { "type": "number" },
326
- "suggested_action": { "type": "string" },
327
- "amount": { "$ref": "#/definitions/moneyValue" },
328
- "evidence": { "type": "array" }
329
- },
330
- "required": ["type", "description", "amount"],
331
- "additionalProperties": true
332
- }
333
- }
334
- },
335
- "additionalProperties": false
336
- }
337
- }
2
+ "$schema": "http://json-schema.org/draft-07/schema#",
3
+ "title": "YNAB MCP Reconciliation v2 Payload",
4
+ "type": "object",
5
+ "properties": {
6
+ "version": { "const": "2.0" },
7
+ "schema_url": { "type": "string", "format": "uri" },
8
+ "generated_at": { "type": "string", "format": "date-time" },
9
+ "account": {
10
+ "type": "object",
11
+ "properties": {
12
+ "id": { "type": ["string", "null"] },
13
+ "name": { "type": ["string", "null"] }
14
+ },
15
+ "required": ["id"],
16
+ "additionalProperties": false
17
+ },
18
+ "summary": { "$ref": "#/definitions/summary" },
19
+ "balance": { "$ref": "#/definitions/balance" },
20
+ "insights": {
21
+ "type": "array",
22
+ "items": { "$ref": "#/definitions/insight" }
23
+ },
24
+ "next_steps": {
25
+ "type": "array",
26
+ "items": { "type": "string" }
27
+ },
28
+ "csv_format": { "$ref": "#/definitions/csvFormat" },
29
+ "matches": {
30
+ "type": "object",
31
+ "properties": {
32
+ "auto": {
33
+ "type": "array",
34
+ "items": { "$ref": "#/definitions/match" }
35
+ },
36
+ "suggested": {
37
+ "type": "array",
38
+ "items": { "$ref": "#/definitions/match" }
39
+ }
40
+ },
41
+ "required": ["auto", "suggested"],
42
+ "additionalProperties": false
43
+ },
44
+ "unmatched": {
45
+ "type": "object",
46
+ "properties": {
47
+ "bank": {
48
+ "type": "array",
49
+ "items": { "$ref": "#/definitions/bankTransaction" }
50
+ },
51
+ "ynab": {
52
+ "type": "array",
53
+ "items": { "$ref": "#/definitions/ynabTransaction" }
54
+ }
55
+ },
56
+ "required": ["bank", "ynab"],
57
+ "additionalProperties": false
58
+ },
59
+ "execution": {
60
+ "type": ["object", "null"],
61
+ "properties": {
62
+ "summary": { "$ref": "#/definitions/executionSummary" },
63
+ "account_balance": {
64
+ "type": "object",
65
+ "properties": {
66
+ "before": { "$ref": "#/definitions/accountSnapshot" },
67
+ "after": { "$ref": "#/definitions/accountSnapshot" }
68
+ },
69
+ "required": ["before", "after"],
70
+ "additionalProperties": false
71
+ },
72
+ "actions_taken": {
73
+ "type": "array",
74
+ "items": {
75
+ "type": "object",
76
+ "properties": {
77
+ "type": { "type": "string" },
78
+ "transaction": { "type": ["object", "null"] },
79
+ "reason": { "type": "string" }
80
+ },
81
+ "required": ["type", "reason"],
82
+ "additionalProperties": true
83
+ }
84
+ },
85
+ "recommendations": {
86
+ "type": "array",
87
+ "items": { "type": "string" }
88
+ },
89
+ "balance_reconciliation": {
90
+ "type": ["object", "null"],
91
+ "properties": {
92
+ "status": { "type": "string" },
93
+ "precision_calculations": {
94
+ "type": ["object", "null"],
95
+ "properties": {
96
+ "bank_statement_balance": {
97
+ "$ref": "#/definitions/moneyValue"
98
+ },
99
+ "ynab_calculated_balance": {
100
+ "$ref": "#/definitions/moneyValue"
101
+ },
102
+ "discrepancy": { "$ref": "#/definitions/moneyValue" },
103
+ "discrepancy_decimal": { "$ref": "#/definitions/moneyValue" }
104
+ },
105
+ "additionalProperties": false
106
+ },
107
+ "discrepancy_analysis": {
108
+ "$ref": "#/definitions/discrepancyAnalysis"
109
+ },
110
+ "final_verification": {
111
+ "type": "object",
112
+ "properties": {
113
+ "balance_matches_exactly": { "type": "boolean" },
114
+ "all_transactions_accounted": { "type": "boolean" },
115
+ "audit_trail_complete": { "type": "boolean" },
116
+ "reconciliation_complete": { "type": "boolean" }
117
+ },
118
+ "required": [
119
+ "balance_matches_exactly",
120
+ "all_transactions_accounted",
121
+ "audit_trail_complete",
122
+ "reconciliation_complete"
123
+ ],
124
+ "additionalProperties": false
125
+ }
126
+ },
127
+ "additionalProperties": false
128
+ }
129
+ },
130
+ "additionalProperties": false
131
+ }
132
+ },
133
+ "required": [
134
+ "version",
135
+ "generated_at",
136
+ "summary",
137
+ "balance",
138
+ "matches",
139
+ "unmatched"
140
+ ],
141
+ "additionalProperties": false,
142
+ "definitions": {
143
+ "moneyValue": {
144
+ "type": "object",
145
+ "properties": {
146
+ "value_milliunits": { "type": "number" },
147
+ "value": { "type": "number" },
148
+ "value_display": { "type": "string" },
149
+ "currency": { "type": "string" },
150
+ "direction": {
151
+ "type": "string",
152
+ "enum": ["credit", "debit", "balanced"]
153
+ }
154
+ },
155
+ "required": [
156
+ "value_milliunits",
157
+ "value_display",
158
+ "currency",
159
+ "direction"
160
+ ],
161
+ "additionalProperties": false
162
+ },
163
+ "csvFormat": {
164
+ "type": "object",
165
+ "properties": {
166
+ "delimiter": { "type": "string" },
167
+ "decimal_separator": { "type": "string" },
168
+ "thousands_separator": { "type": ["string", "null"] },
169
+ "date_format": { "type": "string" },
170
+ "header_row": { "type": "boolean" },
171
+ "date_column": { "type": ["string", "null"] },
172
+ "amount_column": { "type": ["string", "null"] },
173
+ "payee_column": { "type": ["string", "null"] }
174
+ },
175
+ "additionalProperties": false
176
+ },
177
+ "summary": {
178
+ "type": "object",
179
+ "properties": {
180
+ "statement_date_range": { "type": "string" },
181
+ "bank_transactions_count": { "type": "number" },
182
+ "ynab_transactions_count": { "type": "number" },
183
+ "auto_matched": { "type": "number" },
184
+ "suggested_matches": { "type": "number" },
185
+ "unmatched_bank": { "type": "number" },
186
+ "unmatched_ynab": { "type": "number" },
187
+ "current_cleared_balance": { "$ref": "#/definitions/moneyValue" },
188
+ "target_statement_balance": { "$ref": "#/definitions/moneyValue" },
189
+ "discrepancy": { "$ref": "#/definitions/moneyValue" },
190
+ "discrepancy_explanation": { "type": "string" }
191
+ },
192
+ "required": [
193
+ "statement_date_range",
194
+ "bank_transactions_count",
195
+ "ynab_transactions_count",
196
+ "auto_matched",
197
+ "suggested_matches",
198
+ "unmatched_bank",
199
+ "unmatched_ynab",
200
+ "current_cleared_balance",
201
+ "target_statement_balance",
202
+ "discrepancy"
203
+ ],
204
+ "additionalProperties": false
205
+ },
206
+ "balance": {
207
+ "type": "object",
208
+ "properties": {
209
+ "current_cleared": { "$ref": "#/definitions/moneyValue" },
210
+ "current_uncleared": { "$ref": "#/definitions/moneyValue" },
211
+ "current_total": { "$ref": "#/definitions/moneyValue" },
212
+ "target_statement": { "$ref": "#/definitions/moneyValue" },
213
+ "discrepancy": { "$ref": "#/definitions/moneyValue" },
214
+ "discrepancy_direction": {
215
+ "type": "string",
216
+ "enum": ["bank_higher", "ynab_higher", "balanced"]
217
+ },
218
+ "on_track": { "type": "boolean" }
219
+ },
220
+ "required": [
221
+ "current_cleared",
222
+ "current_uncleared",
223
+ "current_total",
224
+ "target_statement",
225
+ "discrepancy",
226
+ "discrepancy_direction"
227
+ ],
228
+ "additionalProperties": false
229
+ },
230
+ "insight": {
231
+ "type": "object",
232
+ "properties": {
233
+ "id": { "type": "string" },
234
+ "type": { "type": "string" },
235
+ "severity": {
236
+ "type": "string",
237
+ "enum": ["info", "warning", "critical"]
238
+ },
239
+ "title": { "type": "string" },
240
+ "description": { "type": "string" },
241
+ "evidence": { "type": "object" }
242
+ },
243
+ "required": ["id", "type", "severity", "title"],
244
+ "additionalProperties": false
245
+ },
246
+ "match": {
247
+ "type": "object",
248
+ "properties": {
249
+ "bank_transaction": { "$ref": "#/definitions/bankTransaction" },
250
+ "ynab_transaction": { "$ref": "#/definitions/ynabTransaction" },
251
+ "candidates": {
252
+ "type": "array",
253
+ "items": {
254
+ "type": "object",
255
+ "properties": {
256
+ "ynab_transaction": { "$ref": "#/definitions/ynabTransaction" },
257
+ "confidence": { "type": "number" },
258
+ "match_reason": { "type": "string" },
259
+ "explanation": { "type": "string" }
260
+ },
261
+ "required": ["ynab_transaction", "confidence"],
262
+ "additionalProperties": true
263
+ }
264
+ },
265
+ "confidence": { "type": "string" },
266
+ "confidence_score": { "type": "number" },
267
+ "match_reason": { "type": "string" }
268
+ },
269
+ "required": ["bank_transaction", "confidence"],
270
+ "additionalProperties": true
271
+ },
272
+ "bankTransaction": {
273
+ "type": "object",
274
+ "properties": {
275
+ "id": { "type": "string" },
276
+ "date": { "type": "string", "format": "date" },
277
+ "amount": { "type": "number" },
278
+ "payee": { "type": ["string", "null"] },
279
+ "memo": { "type": ["string", "null"] },
280
+ "original_csv_row": { "type": "integer" },
281
+ "amount_money": { "$ref": "#/definitions/moneyValue" }
282
+ },
283
+ "required": ["id", "date", "amount"],
284
+ "additionalProperties": true
285
+ },
286
+ "ynabTransaction": {
287
+ "type": "object",
288
+ "properties": {
289
+ "id": { "type": "string" },
290
+ "date": { "type": "string", "format": "date" },
291
+ "amount": { "type": "number" },
292
+ "payee_name": { "type": ["string", "null"] },
293
+ "category_name": { "type": ["string", "null"] },
294
+ "cleared": { "type": "string" },
295
+ "approved": { "type": "boolean" },
296
+ "memo": { "type": ["string", "null"] },
297
+ "amount_money": { "$ref": "#/definitions/moneyValue" }
298
+ },
299
+ "required": ["id", "date", "amount", "cleared"],
300
+ "additionalProperties": true
301
+ },
302
+ "accountSnapshot": {
303
+ "type": "object",
304
+ "properties": {
305
+ "balance": { "$ref": "#/definitions/moneyValue" },
306
+ "cleared_balance": { "$ref": "#/definitions/moneyValue" },
307
+ "uncleared_balance": { "$ref": "#/definitions/moneyValue" }
308
+ },
309
+ "required": ["balance", "cleared_balance", "uncleared_balance"],
310
+ "additionalProperties": false
311
+ },
312
+ "executionSummary": {
313
+ "type": "object",
314
+ "properties": {
315
+ "bank_transactions_count": { "type": "number" },
316
+ "ynab_transactions_count": { "type": "number" },
317
+ "matches_found": { "type": "number" },
318
+ "missing_in_ynab": { "type": "number" },
319
+ "missing_in_bank": { "type": "number" },
320
+ "transactions_created": { "type": "number" },
321
+ "transactions_updated": { "type": "number" },
322
+ "dates_adjusted": { "type": "number" },
323
+ "dry_run": { "type": "boolean" }
324
+ },
325
+ "required": [
326
+ "bank_transactions_count",
327
+ "ynab_transactions_count",
328
+ "matches_found",
329
+ "missing_in_ynab",
330
+ "missing_in_bank",
331
+ "transactions_created",
332
+ "transactions_updated",
333
+ "dry_run"
334
+ ],
335
+ "additionalProperties": false
336
+ },
337
+ "discrepancyAnalysis": {
338
+ "type": "object",
339
+ "properties": {
340
+ "confidence_level": { "type": "number" },
341
+ "risk_assessment": { "type": "string" },
342
+ "likely_causes": {
343
+ "type": "array",
344
+ "items": {
345
+ "type": "object",
346
+ "properties": {
347
+ "type": { "type": "string" },
348
+ "description": { "type": "string" },
349
+ "confidence": { "type": "number" },
350
+ "suggested_action": { "type": "string" },
351
+ "amount": { "$ref": "#/definitions/moneyValue" },
352
+ "evidence": { "type": "array" }
353
+ },
354
+ "required": ["type", "description", "amount"],
355
+ "additionalProperties": true
356
+ }
357
+ }
358
+ },
359
+ "additionalProperties": false
360
+ }
361
+ }
338
362
  }