actual-mcp-server 0.17.0 → 0.18.0

package/README.md

@@ -24,13 +24,13 @@ Actual MCP Server is a [Model Context Protocol](https://modelcontextprotocol.io/
 ┌─────────────┐   MCP/HTTP    ┌──────────────────┐   Actual API   ┌──────────────┐
 │  LibreChat  │ ◄───────────► │  Actual MCP      │ ◄───────────► │   Actual     │
 │  LobeChat   │               │  Server          │               │   Budget     │
-│  (remote)   │               │  (75 tools)      │               │   Server     │
+│  (remote)   │               │  (76 tools)      │               │   Server     │
 └─────────────┘               └──────────────────┘               └──────────────┘
 
 ┌─────────────┐   MCP/stdio   ┌──────────────────┐   Actual API   ┌──────────────┐
 │  Claude     │ ◄───────────► │  Actual MCP      │ ◄───────────► │   Actual     │
 │  Desktop    │               │  Server          │               │   Budget     │
-│  (local)    │               │  (75 tools)      │               │   Server     │
+│  (local)    │               │  (76 tools)      │               │   Server     │
 └─────────────┘               └──────────────────┘               └──────────────┘
 ```
 
@@ -38,14 +38,14 @@ Actual MCP Server is a [Model Context Protocol](https://modelcontextprotocol.io/
 
 Most Actual Budget MCP implementations are simple stdio bridges designed for single-user, local use with Claude Desktop. This project goes further:
 
-- **75 tools, the most comprehensive coverage available.** Accounts, transactions, categories, payees, tags, notes, rules, budgets, batch operations, bank sync, and more. Covers the reachable Actual Budget API with no genuine gaps.
+- **76 tools, the most comprehensive coverage available.** Accounts, transactions, categories, payees, tags, notes, rules, budgets, batch operations, bank sync, and more. Covers the reachable Actual Budget API with no genuine gaps.
 - **HTTP and stdio transport.** Runs as a real remote server for LibreChat/LobeChat (`--http`), or as a direct local process for Claude Desktop (`--stdio`). No Docker or HTTP server is needed for local use.
 - **6 exclusive ActualQL-powered tools.** Search and summarise transactions by month, amount, category, or payee using Actual Budget's native query engine. Aggregated results, no raw data dumped into the AI context window.
 - **Multi-budget switching at runtime.** Configure multiple budget files and let the AI switch between them mid-conversation with `actual_budgets_switch`. Works on both transports: HTTP keys the active budget to the MCP session, and stdio (Claude Desktop, Claude Code, Cursor) gets a synthetic per-process session so a switch is scoped to that process rather than shared globally (#348).
 - **Multi-user ready with OIDC.** Secure every session with JWKS-validated JWTs and per-user budget ACLs. No shared tokens required.
 - **Production-grade reliability on both transports.** HTTP connection pooling (up to 15 concurrent sessions), and a long-lived stdio process that logs in ONCE and reuses that connection for every tool call instead of re-authenticating per call, so Claude Desktop and Claude Code stay fast and a burst of calls no longer risks a per-call login storm against the upstream limiter. Automatic retry with exponential backoff, and a full test suite (unit + E2E + integration).
 
-> **Verified working** with [LibreChat](https://www.librechat.ai/), [LobeChat](https://lobehub.com/home), and [Claude Desktop](https://claude.ai/download). All 75 tools tested end-to-end. Any MCP-compatible client should work.
+> **Verified working** with [LibreChat](https://www.librechat.ai/), [LobeChat](https://lobehub.com/home), and [Claude Desktop](https://claude.ai/download). All 76 tools tested end-to-end. Any MCP-compatible client should work.
 
 ---
 
@@ -178,7 +178,7 @@ Add to `claude_desktop_config.json` (see [docs/guides/MCP_CLIENTS_SETUP.md](docs
 }
 ```
 
-> **No token needed.** stdio runs as a local process owned by your user. The transport itself is the security boundary. All 75 tools are available.
+> **No token needed.** stdio runs as a local process owned by your user. The transport itself is the security boundary. All 76 tools are available.
 >
 > **`MCP_BRIDGE_DATA_DIR` should be an absolute path.** Without one, the data directory resolves relative to wherever the client spawns the process, which can be unpredictable. The directory is created automatically on first run.
 
@@ -304,9 +304,9 @@ For Claude Desktop (stdio), restart Claude after upgrading.
 
 ## Available Tools
 
-**75 tools** across all categories. All tools use the `actual_<category>_<action>` naming convention.
+**76 tools** across all categories. All tools use the `actual_<category>_<action>` naming convention.
 
-### Accounts (7)
+### Accounts (8)
 
 | Tool | Description |
 |------|-------------|
@@ -317,6 +317,7 @@ For Claude Desktop (stdio), restart Claude after upgrading.
 | `actual_accounts_close` | Close account. An account with NO transactions is REMOVED by Actual, not closed |
 | `actual_accounts_reopen` | Reopen closed account. An id that is not an account is refused rather than creating one |
 | `actual_accounts_get_balance` | Get account balance at a date |
+| `actual_account_flow_summary` | Explain the exact balance change across a set of accounts over a date range: external income, expense outflow, credits, uncategorized inflows, and transfers into, out of, or within the selection, with an exact reconciliation |
 
 ### Transactions (15)
 
@@ -592,7 +593,7 @@ stdio is the simplest way to connect Claude Desktop directly to Actual Budget. T
 - No auth token. Process ownership is the security boundary.
 - All logs go to stderr so they never corrupt the JSON-RPC framing on stdout
 - The process exits when stdin closes (Claude Desktop shutting down)
-- All 75 tools are available, identical to HTTP mode
+- All 76 tools are available, identical to HTTP mode
 
 **Start manually to verify:**
 
@@ -691,7 +692,7 @@ See [AI Client Setup, OIDC](docs/guides/AI_CLIENT_SETUP.md#oidc-authentication-m
 | Command | What It Tests | Requires Live Server |
 |---------|---------------|---------------------|
 | `npm run build` | TypeScript compilation | No |
-| `npm run test:unit-js` | 75-tool smoke, schema validation, auth ACL | No |
+| `npm run test:unit-js` | 76-tool smoke, schema validation, auth ACL | No |
 | `npm run test:adapter` | Adapter, retry logic, concurrency | No |
 | `npm run test:e2e` | MCP protocol compliance (Playwright) | No |
 | `npm run test:e2e:docker:full` | Full stack integration | Yes (Docker) |
@@ -776,7 +777,7 @@ The software is provided **as-is**, without warranty of any kind. The author acc
 
 ---
 
-**Version:** 0.17.0 | **Tool Count:** 75 (verified LibreChat-compatible)
+**Version:** 0.18.0 | **Tool Count:** 76 (verified LibreChat-compatible)
 
 ## Sponsor
 

package/dist/src/actualToolsManager.js

@@ -4,6 +4,7 @@ import { formatZodError } from './lib/zod-error-format.js';
 // ✅ List of tools already implemented in this class.
 // Adding the tool name here is considered fully implemented.
 const IMPLEMENTED_TOOLS = [
+    'actual_account_flow_summary',
     'actual_accounts_close',
     'actual_accounts_create',
     'actual_accounts_delete',

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

@@ -2849,7 +2849,37 @@ export async function getFinancialAnalysisSnapshot(params) {
         const categories = await queryData(q('categories').select(['id', 'name', 'is_income', 'group']));
         const categoryGroups = await queryData(q('category_groups').options({ categories: 'none' }).select(['id', 'name', 'is_income']));
         const payees = await queryData(q('payees').select(['id', 'name', 'transfer_acct']));
-        return { transactions, accounts, categories, categoryGroups, payees };
+        // #425: the transfer counterparts (the OTHER leg of each transfer), so account-flow can name the
+        // funding account. splits:'all' here (not inline/grouped) so a split transfer leg is still seen.
+        const transferIds = [...new Set(transactions.flatMap(t => [t, ...(t.subtransactions ?? [])])
+                .map(t => t.transfer_id)
+                .filter((id) => typeof id === 'string' && id.length > 0))];
+        const transferCounterparts = transferIds.length > 0
+            ? await queryData(q('transactions').options({ splits: 'all' }).filter({ id: { $oneof: transferIds } }).select('*'))
+            : [];
+        // #425: opening (strictly before startDate) and closing (through endDate) balances for the
+        // selected accounts. splits:'inline' expands a split to its children so each posting is summed
+        // ONCE; splits:'all' would double-count a split parent plus its children and break reconciliation.
+        const openingBalances = {};
+        const closingBalances = {};
+        const balanceAccountIds = params.balanceAccountIds ?? [];
+        if (balanceAccountIds.length > 0) {
+            const openingRows = await queryData(q('transactions').options({ splits: 'inline' })
+                .filter({ $and: [{ account: { $oneof: balanceAccountIds } }, { date: { $lt: params.startDate } }] })
+                .groupBy('account').select(['account', { balance: { $sum: '$amount' } }]));
+            const closingRows = await queryData(q('transactions').options({ splits: 'inline' })
+                .filter({ $and: [{ account: { $oneof: balanceAccountIds } }, { date: { $lte: params.endDate } }] })
+                .groupBy('account').select(['account', { balance: { $sum: '$amount' } }]));
+            for (const id of balanceAccountIds) {
+                openingBalances[id] = 0;
+                closingBalances[id] = 0;
+            }
+            for (const row of openingRows)
+                openingBalances[row.account] = row.balance ?? 0;
+            for (const row of closingRows)
+                closingBalances[row.account] = row.balance ?? 0;
+        }
+        return { transactions, transferCounterparts, accounts, categories, categoryGroups, payees, openingBalances, closingBalances };
     });
 }
 // WHERE-clause translation extracted to ./actual-adapter/query.ts (#166).

package/dist/src/lib/financial-analysis.js

@@ -212,3 +212,119 @@ export function aggregateTransactions(snapshot, input) {
         addAggregate(totals, entry.values);
     return { dateRange: { startDate: input.startDate, endDate: input.endDate }, groups, totals };
 }
+export function summarizeAccountFlow(snapshot, input) {
+    const maps = buildMaps(snapshot);
+    const selected = new Set(input.accountIds);
+    // Dedupe once. The balance reduces and the accounts list below MUST key off the same unique set
+    // the rows are filtered against, or a repeated id (two display names resolving to one account, say)
+    // doubles the balances while the Set counts postings once, making reconciliation.difference non-zero
+    // and falsifying the tool's exact-by-construction guarantee.
+    const uniqueAccountIds = [...selected];
+    const rows = postingRows(snapshot.transactions).filter(transaction => selected.has(transaction.account) && transaction.date >= input.startDate && transaction.date <= input.endDate);
+    let income = 0;
+    let incomeReversals = 0;
+    let expenseOutflow = 0;
+    let credits = 0;
+    let uncategorizedInflows = 0;
+    let startingBalance = 0;
+    let intoSelection = 0;
+    let outOfSelection = 0;
+    let withinSelection = 0;
+    let withinSelectionTimingEffect = 0;
+    let netTransferEffect = 0;
+    const seenPairs = new Set();
+    const transfersByAccount = [];
+    for (const transaction of rows) {
+        const amount = integer(transaction.amount, `Transaction ${transaction.id} amount`);
+        const category = transaction.category ? maps.categories.get(transaction.category) : undefined;
+        const classification = classifyExternal(transaction, category);
+        if (classification === 'expense')
+            expenseOutflow += Math.abs(amount);
+        if (classification === 'credit')
+            credits += amount;
+        if (classification === 'income') {
+            if (amount >= 0)
+                income += amount;
+            else
+                incomeReversals += Math.abs(amount);
+        }
+        if (classification === 'uncategorized-inflow')
+            uncategorizedInflows += amount;
+        if (classification === 'adjustment')
+            startingBalance += amount;
+        if (classification !== 'transfer')
+            continue;
+        netTransferEffect += amount;
+        const counterpart = transaction.transfer_id ? maps.transactions.get(transaction.transfer_id) : undefined;
+        const payee = transaction.payee ? maps.payees.get(transaction.payee) : undefined;
+        const counterpartAccountId = counterpart?.account ?? payee?.transfer_acct ?? null;
+        const counterpartSelected = counterpartAccountId ? selected.has(counterpartAccountId) : false;
+        if (counterpartSelected) {
+            withinSelectionTimingEffect += amount;
+            const pairKey = [transaction.id, transaction.transfer_id ?? transaction.id].sort().join(':');
+            if (!seenPairs.has(pairKey)) {
+                seenPairs.add(pairKey);
+                withinSelection += Math.abs(amount);
+            }
+        }
+        else if (amount >= 0) {
+            intoSelection += amount;
+        }
+        else {
+            outOfSelection += Math.abs(amount);
+        }
+        const pairKey = [transaction.id, transaction.transfer_id ?? transaction.id].sort().join(':');
+        if (!seenPairs.has(`detail:${pairKey}`)) {
+            seenPairs.add(`detail:${pairKey}`);
+            const fromId = amount < 0 ? transaction.account : counterpartAccountId;
+            const toId = amount < 0 ? counterpartAccountId : transaction.account;
+            transfersByAccount.push({
+                fromAccountId: fromId,
+                fromAccountName: fromId ? maps.accounts.get(fromId)?.name ?? fromId : null,
+                toAccountId: toId,
+                toAccountName: toId ? maps.accounts.get(toId)?.name ?? toId : null,
+                amount: Math.abs(amount),
+                date: transaction.date,
+                withinSelection: counterpartSelected,
+                matchedCounterpart: counterpart != null,
+            });
+        }
+    }
+    // The tool handler always supplies balances (via balanceAccountIds), so difference is exact here.
+    // If a future caller omits them, both reduce to 0 and difference reads as a false "exact": #428.
+    const openingBalance = uniqueAccountIds.reduce((sum, id) => sum + integer(snapshot.openingBalances?.[id] ?? 0, `Opening balance for ${id}`), 0);
+    const closingBalance = uniqueAccountIds.reduce((sum, id) => sum + integer(snapshot.closingBalances?.[id] ?? 0, `Closing balance for ${id}`), 0);
+    const balanceChange = closingBalance - openingBalance;
+    const netExternalCashFlow = income - incomeReversals + credits + uncategorizedInflows - expenseOutflow;
+    const totalAdjustments = startingBalance;
+    const calculatedBalanceChange = netExternalCashFlow + netTransferEffect + totalAdjustments;
+    return {
+        dateRange: { startDate: input.startDate, endDate: input.endDate },
+        accounts: uniqueAccountIds.map(id => ({ id, name: maps.accounts.get(id)?.name ?? id })),
+        openingBalance,
+        closingBalance,
+        balanceChange,
+        external: {
+            income,
+            incomeReversals,
+            expenseOutflow,
+            credits,
+            uncategorizedInflows,
+            netExternalCashFlow,
+        },
+        transfers: {
+            intoSelection,
+            outOfSelection,
+            withinSelection,
+            withinSelectionTimingEffect,
+            netTransferEffect,
+        },
+        transfersByAccount: transfersByAccount.sort((a, b) => `${a.date}:${a.fromAccountId}:${a.toAccountId}`.localeCompare(`${b.date}:${b.fromAccountId}:${b.toAccountId}`)),
+        adjustments: { startingBalance, total: totalAdjustments },
+        reconciliation: {
+            calculatedBalanceChange,
+            actualBalanceChange: balanceChange,
+            difference: balanceChange - calculatedBalanceChange,
+        },
+    };
+}

package/dist/src/lib/tool-annotations.js

@@ -55,6 +55,7 @@ const OPEN_WORLD = new Set(['actual_bank_sync']);
  *   actual_session_close   closes a pooled connection: server state, not budget data.
  */
 const READ_ONLY = new Set([
+    'actual_account_flow_summary',
     'actual_accounts_get_balance',
     'actual_accounts_list',
     'actual_budgets_get_all',

package/dist/src/tools/account_flow_summary.js

@@ -0,0 +1,52 @@
+// #425: deterministic, read-only account-flow reconciliation.
+//
+// Original implementation by @maxvanweenen (PR #399), the "deferred secondary" tool from #398. The
+// accounting lives in src/lib/financial-analysis.ts (summarizeAccountFlow); this file is the tool
+// surface plus the #388 filter-id resolution.
+import { z } from 'zod';
+import { createTool } from '../lib/toolFactory.js';
+import { CommonSchemas } from '../lib/schemas/common.js';
+import adapter from '../lib/actual-adapter.js';
+import { summarizeAccountFlow } from '../lib/financial-analysis.js';
+// Bare-string ids (#388): a NAME resolves via adapter.resolveFilterId rather than being rejected.
+const InputSchema = z.object({
+    startDate: CommonSchemas.date,
+    endDate: CommonSchemas.date,
+    accountIds: z.array(z.string().min(1)).min(1, 'Select at least one account').max(100),
+}).strict().superRefine((input, ctx) => {
+    if (input.startDate > input.endDate) {
+        ctx.addIssue({ code: 'custom', path: ['endDate'], message: 'endDate must be on or after startDate' });
+    }
+});
+export default createTool({
+    name: 'actual_account_flow_summary',
+    description: [
+        'Explain the exact balance change across a selected set of accounts over an inclusive date range, in integer cents.',
+        'Separates external income, expense outflow, credits, uncategorized inflows, starting-balance adjustments, and transfers into, out of, or within the selection.',
+        'Transfers are detected from transfer_id and are never spending or income.',
+        'openingBalance is immediately before startDate and closingBalance is at the end of the inclusive endDate; reconciliation.difference is exact and transfersByAccount names the funding counterparties.',
+        'Amounts are in cents: $100.00 = 10000. Dates are YYYY-MM-DD.',
+    ].join(' '),
+    schema: InputSchema,
+    handler: async (input) => {
+        // Fetch with the raw ids so the balance queries run in the same session. A NAME here filters the
+        // balance query to nothing (0), which is harmless because the resolveFilterId pass below refuses
+        // the name before the result is used.
+        const snapshot = await adapter.getFinancialAnalysisSnapshot({
+            startDate: input.startDate,
+            endDate: input.endDate,
+            balanceAccountIds: input.accountIds,
+        });
+        const accountIds = [];
+        for (const id of input.accountIds) {
+            accountIds.push(await adapter.resolveFilterId('account', id, { verifyExists: true, rows: snapshot.accounts }));
+        }
+        return summarizeAccountFlow(snapshot, { startDate: input.startDate, endDate: input.endDate, accountIds });
+    },
+    examples: [
+        {
+            description: 'Reconcile the flow across two accounts for a month',
+            input: { startDate: '2025-01-01', endDate: '2025-01-31', accountIds: ['<account-uuid-1>', '<account-uuid-2>'] },
+        },
+    ],
+});

package/dist/src/tools/index.js

@@ -1,5 +1,6 @@
 // Auto-generated index for all tool modules
 export { default as entities_search } from './entities_search.js';
+export { default as account_flow_summary } from './account_flow_summary.js';
 export { default as accounts_close } from './accounts_close.js';
 export { default as accounts_create } from './accounts_create.js';
 export { default as accounts_delete } from './accounts_delete.js';

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "actual-mcp-server",
   "displayName": "Actual MCP Server",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "engines": {
     "node": ">=22.0.0",
     "npm": ">=10.0.0"
   },
-  "description": "MCP server with 75 tools for AI-driven financial management with Actual Budget. HTTP and stdio transports for LibreChat, Claude Desktop, Cursor, VS Code, Gemini CLI",
+  "description": "MCP server with 76 tools for AI-driven financial management with Actual Budget. HTTP and stdio transports for LibreChat, Claude Desktop, Cursor, VS Code, Gemini CLI",
   "homepage": "https://github.com/agigante80/actual-mcp-server#readme",
   "repository": {
     "type": "git",
@@ -30,7 +30,7 @@
     "verify-tools": "npm run build && node scripts/verify-tools.js",
     "check:coverage": "node scripts/list-actual-api-methods.mjs",
     "direct-sync": "node scripts/direct-sync/bank-sync-direct.mjs",
-    "test:unit-js": "node tests/unit/transactions_create.test.js && node tests/unit/transactions_aggregate.test.js && node tests/unit/generated_tools.smoke.test.js &&node tests/unit/schema_validation.test.js && node tests/unit/schema_json_openai_compat.test.js && node tests/unit/config_https_validation.test.js && node tests/unit/config_data_dir.test.js && node tests/unit/config_drift.test.js && node tests/unit/port_alignment.test.js && node tests/unit/dockerfile_data_dir_alignment.test.js && node tests/unit/unraid_template_alignment.test.js && node tests/unit/entrypoint_invariants.test.js && node tests/unit/e2e_spec_collection.test.js && node tests/unit/compose_profile_sync.test.js && node tests/unit/advertised_tools_sync.test.js && node tests/unit/knip_config.test.js && node tests/unit/readme_stats_sync.test.js && node tests/unit/config_insecure_upstream.test.js && node tests/unit/workflow_release_guards.test.js && node tests/unit/report_train_failure.test.js && node tests/unit/unit_chain_membership.test.js && node tests/unit/api_surface_drift.test.js && node tests/unit/write_effect_audit_staleness.test.js && node tests/unit/write_effect_audit_membership.test.js && node tests/unit/tool_annotations.test.js && node tests/unit/tool_id_schema_drift.test.js && node tests/unit/filter_id_resolution.test.js && node tests/unit/filter_id_tool_wiring.test.js && node tests/unit/api_coverage_baseline.test.js && node tests/unit/train_preflight.test.js && node tests/unit/verify_published_artifacts.test.js && node tests/unit/report_train_stale.test.js && node tests/unit/stdio_framing_check.test.js && node tests/unit/server_info.test.js && node tests/unit/transfers_create.test.js && node tests/unit/bot_target_branch.test.js && node tests/unit/auth_posture.test.js && node tests/unit/auth_posture_wiring.test.js && node tests/unit/auth-acl.test.js && node tests/unit/bug76.test.js && node tests/unit/budgets_setAmount.test.js && node tests/unit/budgets_hold_for_next_month.test.js && node tests/unit/budgets_transfer.test.js && node tests/unit/transactions_uncategorized.test.js && node tests/unit/httpServer_session_init.test.js && node tests/unit/httpServer_session_not_found.test.js && node tests/unit/manual_mcp_client_retry.test.js && node tests/unit/manual_mcp_client_session.test.js && node tests/unit/manual_mcp_client_circuit.test.js && node tests/unit/manual_runner_killswitch.test.js && node tests/unit/adapter_auth_rate_limit.test.js && node tests/unit/adapter_session_reuse.test.js && node tests/unit/retry_classifier.test.js && node tests/unit/adapter_module_surface.test.js && node tests/unit/adapter_nonidempotent_no_retry.test.js && node tests/unit/pool_liveness.test.js && node tests/unit/pool_shutdown_all.test.js && node tests/unit/query_where_operators.test.js && node tests/unit/query_run_validation.test.js && node tests/unit/adapter_with_write_session.test.js && node tests/unit/category_groups_delete.test.js && node tests/unit/rules_delete.test.js && node tests/unit/schedules_delete.test.js && node tests/unit/accounts_delete.test.js && node tests/unit/update_tools_not_found.test.js && node tests/unit/accounts_close.test.js && node tests/unit/accounts_reopen.test.js && node tests/unit/payees_delete.test.js && node tests/unit/payees_merge.test.js && node tests/unit/rules_create_or_update.test.js && node tests/unit/unhandled-rejection.test.js && node tests/unit/rejection-allowlist-purity.test.js && node tests/unit/httpServer_bearer_auth.test.js && node tests/unit/httpServer_oidc_audience.test.js && node tests/unit/httpServer_oidc_auth_verification.test.js && node tests/unit/httpServer_oidc_jwks_discovery.test.js && node tests/unit/httpServer_body_limit.test.js && node tests/unit/httpServer_bind_host.test.js && node tests/unit/adapter_write_pool_cooperation.test.js && node tests/unit/adapter_drain_listing_cache.test.js && node tests/unit/budget_acl_enforcement.test.js && node tests/unit/budget_selection_precondition.test.js && node tests/unit/budget_load_abandonment.test.js && node tests/unit/budget_loader_postcondition.test.js && node tests/unit/budget_loader_import_allowlist.test.js && node tests/unit/budget_import_tracking.test.js && node tests/unit/pool_shutdown_under_lock.test.js && node tests/unit/api_lock_affinity.test.js && node tests/unit/commit_message_closing_keyword.test.js && node tests/unit/write_queue_stranding.test.js && node tests/unit/write_queue_stranded_bound.test.js && node tests/unit/budget_preference_store.test.js && node tests/unit/budget_preference_restore.test.js && node tests/unit/tags_list.test.js && node tests/unit/tags_create.test.js && node tests/unit/tags_update.test.js && node tests/unit/tags_delete.test.js && node tests/unit/notes_get.test.js && node tests/unit/notes_update.test.js && node tests/unit/payees_common_list.test.js && node tests/unit/transactions_update_guard.test.js && node tests/unit/transactions_update_splits.test.js && node tests/unit/entities_search.test.js && node tests/unit/transactions_import_schema.test.js && node tests/unit/tool_schema_shape.test.js && node tests/unit/zod_error_format.test.js && node tests/unit/tool_count_sync.test.js && node tests/unit/stdio_transport.test.js && node tests/unit/stdio_budget_switch.test.js && node tests/unit/logger_structured.test.js && node tests/unit/logger_redaction.test.js && node tests/unit/logger_correlation.test.js && node tests/unit/check_coverage.test.js && node tests/unit/adapter_op_timeout.test.js && node tests/unit/adapter_write_queue_wakeup.test.js && node tests/unit/ci_workflow_guards.test.js && node tests/unit/node_version_guard.test.js && node tests/unit/node_version_drift.test.js && node tests/unit/playwright_version_drift.test.js && node tests/unit/observability_smoke.test.js && node tests/unit/residue_pattern.test.js && node tests/unit/dual_transport_gate.test.js && node tests/unit/manual_assertions_use_helper.test.js && node tests/unit/server_version_guard.test.js && node tests/unit/payee_rules_reference_filter.test.js && node tests/unit/oidc_metadata_discovery.test.js && node tests/unit/httpServer_oauth_metadata_route.test.js && node tests/unit/httpServer_mcp_info_route.test.js && node tests/unit/residue_sweep_balance_account.test.js && node tests/unit/tool_factory.test.js && node tests/unit/budget_registry_parse.test.js && node tests/unit/preferences_get.test.js && node tests/unit/budgets_export.test.js && node tests/unit/budgets_import.test.js && node tests/unit/budgets_import_syncid.test.js && node tests/unit/budget_acl_dynamic.test.js && node tests/unit/budget_acl_identity_map.test.js && node tests/unit/budget_acl_userinfo.test.js && node tests/unit/acl_e2e_fixture_contract.test.js && node tests/unit/budget_acl_middleware.test.js && node tests/unit/rules_stage.test.js",
+    "test:unit-js": "node tests/unit/transactions_create.test.js && node tests/unit/transactions_aggregate.test.js && node tests/unit/account_flow_summary.test.js && node tests/unit/generated_tools.smoke.test.js &&node tests/unit/schema_validation.test.js && node tests/unit/schema_json_openai_compat.test.js && node tests/unit/config_https_validation.test.js && node tests/unit/config_data_dir.test.js && node tests/unit/config_drift.test.js && node tests/unit/port_alignment.test.js && node tests/unit/dockerfile_data_dir_alignment.test.js && node tests/unit/unraid_template_alignment.test.js && node tests/unit/entrypoint_invariants.test.js && node tests/unit/e2e_spec_collection.test.js && node tests/unit/compose_profile_sync.test.js && node tests/unit/advertised_tools_sync.test.js && node tests/unit/knip_config.test.js && node tests/unit/readme_stats_sync.test.js && node tests/unit/config_insecure_upstream.test.js && node tests/unit/workflow_release_guards.test.js && node tests/unit/report_train_failure.test.js && node tests/unit/unit_chain_membership.test.js && node tests/unit/api_surface_drift.test.js && node tests/unit/write_effect_audit_staleness.test.js && node tests/unit/write_effect_audit_membership.test.js && node tests/unit/tool_annotations.test.js && node tests/unit/tool_id_schema_drift.test.js && node tests/unit/filter_id_resolution.test.js && node tests/unit/filter_id_tool_wiring.test.js && node tests/unit/api_coverage_baseline.test.js && node tests/unit/train_preflight.test.js && node tests/unit/verify_published_artifacts.test.js && node tests/unit/report_train_stale.test.js && node tests/unit/stdio_framing_check.test.js && node tests/unit/server_info.test.js && node tests/unit/transfers_create.test.js && node tests/unit/bot_target_branch.test.js && node tests/unit/auth_posture.test.js && node tests/unit/auth_posture_wiring.test.js && node tests/unit/auth-acl.test.js && node tests/unit/bug76.test.js && node tests/unit/budgets_setAmount.test.js && node tests/unit/budgets_hold_for_next_month.test.js && node tests/unit/budgets_transfer.test.js && node tests/unit/transactions_uncategorized.test.js && node tests/unit/httpServer_session_init.test.js && node tests/unit/httpServer_session_not_found.test.js && node tests/unit/manual_mcp_client_retry.test.js && node tests/unit/manual_mcp_client_session.test.js && node tests/unit/manual_mcp_client_circuit.test.js && node tests/unit/manual_runner_killswitch.test.js && node tests/unit/adapter_auth_rate_limit.test.js && node tests/unit/adapter_session_reuse.test.js && node tests/unit/retry_classifier.test.js && node tests/unit/adapter_module_surface.test.js && node tests/unit/adapter_nonidempotent_no_retry.test.js && node tests/unit/pool_liveness.test.js && node tests/unit/pool_shutdown_all.test.js && node tests/unit/query_where_operators.test.js && node tests/unit/query_run_validation.test.js && node tests/unit/adapter_with_write_session.test.js && node tests/unit/category_groups_delete.test.js && node tests/unit/rules_delete.test.js && node tests/unit/schedules_delete.test.js && node tests/unit/accounts_delete.test.js && node tests/unit/update_tools_not_found.test.js && node tests/unit/accounts_close.test.js && node tests/unit/accounts_reopen.test.js && node tests/unit/payees_delete.test.js && node tests/unit/payees_merge.test.js && node tests/unit/rules_create_or_update.test.js && node tests/unit/unhandled-rejection.test.js && node tests/unit/rejection-allowlist-purity.test.js && node tests/unit/httpServer_bearer_auth.test.js && node tests/unit/httpServer_oidc_audience.test.js && node tests/unit/httpServer_oidc_auth_verification.test.js && node tests/unit/httpServer_oidc_jwks_discovery.test.js && node tests/unit/httpServer_body_limit.test.js && node tests/unit/httpServer_bind_host.test.js && node tests/unit/adapter_write_pool_cooperation.test.js && node tests/unit/adapter_drain_listing_cache.test.js && node tests/unit/budget_acl_enforcement.test.js && node tests/unit/budget_selection_precondition.test.js && node tests/unit/budget_load_abandonment.test.js && node tests/unit/budget_loader_postcondition.test.js && node tests/unit/budget_loader_import_allowlist.test.js && node tests/unit/budget_import_tracking.test.js && node tests/unit/pool_shutdown_under_lock.test.js && node tests/unit/api_lock_affinity.test.js && node tests/unit/commit_message_closing_keyword.test.js && node tests/unit/write_queue_stranding.test.js && node tests/unit/write_queue_stranded_bound.test.js && node tests/unit/budget_preference_store.test.js && node tests/unit/budget_preference_restore.test.js && node tests/unit/tags_list.test.js && node tests/unit/tags_create.test.js && node tests/unit/tags_update.test.js && node tests/unit/tags_delete.test.js && node tests/unit/notes_get.test.js && node tests/unit/notes_update.test.js && node tests/unit/payees_common_list.test.js && node tests/unit/transactions_update_guard.test.js && node tests/unit/transactions_update_splits.test.js && node tests/unit/entities_search.test.js && node tests/unit/transactions_import_schema.test.js && node tests/unit/tool_schema_shape.test.js && node tests/unit/zod_error_format.test.js && node tests/unit/tool_count_sync.test.js && node tests/unit/stdio_transport.test.js && node tests/unit/stdio_budget_switch.test.js && node tests/unit/logger_structured.test.js && node tests/unit/logger_redaction.test.js && node tests/unit/logger_correlation.test.js && node tests/unit/check_coverage.test.js && node tests/unit/adapter_op_timeout.test.js && node tests/unit/adapter_write_queue_wakeup.test.js && node tests/unit/ci_workflow_guards.test.js && node tests/unit/node_version_guard.test.js && node tests/unit/node_version_drift.test.js && node tests/unit/playwright_version_drift.test.js && node tests/unit/observability_smoke.test.js && node tests/unit/residue_pattern.test.js && node tests/unit/dual_transport_gate.test.js && node tests/unit/manual_assertions_use_helper.test.js && node tests/unit/server_version_guard.test.js && node tests/unit/payee_rules_reference_filter.test.js && node tests/unit/oidc_metadata_discovery.test.js && node tests/unit/httpServer_oauth_metadata_route.test.js && node tests/unit/httpServer_mcp_info_route.test.js && node tests/unit/residue_sweep_balance_account.test.js && node tests/unit/tool_factory.test.js && node tests/unit/budget_registry_parse.test.js && node tests/unit/preferences_get.test.js && node tests/unit/budgets_export.test.js && node tests/unit/budgets_import.test.js && node tests/unit/budgets_import_syncid.test.js && node tests/unit/budget_acl_dynamic.test.js && node tests/unit/budget_acl_identity_map.test.js && node tests/unit/budget_acl_userinfo.test.js && node tests/unit/acl_e2e_fixture_contract.test.js && node tests/unit/budget_acl_middleware.test.js && node tests/unit/rules_stage.test.js",
     "test:adapter": "npm run build && node dist/src/tests_adapter_runner.js",
     "test:e2e": "npx playwright test",
     "test:e2e:docker": "./tests/e2e/run-docker-e2e.sh",