actual-mcp-server 0.22.19 → 0.22.20

package/README.md

@@ -835,7 +835,7 @@ The software is provided **as-is**, without warranty of any kind. The author acc
 
 ---
 
-**Version:** 0.22.19 | **Tool Count:** 83 (verified LibreChat-compatible)
+**Version:** 0.22.20 | **Tool Count:** 83 (verified LibreChat-compatible)
 
 ## Sponsor
 

package/dist/src/lib/actual-adapter.js

@@ -1868,6 +1868,28 @@ export async function setBudgetAmount(month, categoryId, amount) {
         return result;
     }, { preservesListings: ['accounts', 'categories', 'categoryGroups', 'payees'] });
 }
+/**
+ * Budget transfer between two categories within a single month.
+ *
+ * Reads the current budget amounts, validates source-side sufficient funds,
+ * and writes both adjustments inside ONE `queueWriteOperation` cycle. This
+ * is the structural fix for issue #141: the previous tool body did three
+ * separate lock cycles (read + write + write) which could hang for the
+ * full Playwright timeout when the upstream server's mutator queue stalled
+ * between cycles. The month read and the funds check run before either write.
+ *
+ * NOT atomic and no rollback (#518). Both writes run inside
+ * `rawBatchBudgetUpdates`, upstream's `batch-budget-start` /
+ * `batch-budget-end` bracket around `batchMessages`, which batches sync
+ * messages; it is not a database transaction. If the second write fails, the
+ * first stays applied, so a partial transfer is possible. A returned result
+ * means both writes were queued, not that both landed: `batch-budget-start`
+ * runs `batchMessages` un-awaited and `batch-budget-end` returns before the
+ * queued messages are applied, so a later apply failure is a detached
+ * rejection that is never returned to the caller (#539). The upstream trace is the
+ * `actual_budget_updates_batch` row of `docs/audit/write-effect-audit.md`,
+ * which shares this bracket (#516).
+ */
 export async function transferBudgetAmount(month, fromCategoryId, toCategoryId, amount) {
     observability.incrementToolCall('actual.budgets.transfer').catch(() => { });
     return queueWriteOperation(async () => {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "actual-mcp-server",
   "displayName": "Actual MCP Server",
-  "version": "0.22.19",
+  "version": "0.22.20",
   "engines": {
     "node": ">=22.0.0",
     "npm": ">=10.0.0"