@dizzlkheinz/ynab-mcpb 0.16.0 → 0.16.1

package/fix-types.sh

@@ -1,17 +0,0 @@
-#!/bin/bash
-
-# Fix index.ts errors
-
-# Fix currency_code -> iso_code
-sed -i 's/currency_format?.currency_code/currency_format?.iso_code/g' src/tools/reconciliation/index.ts
-
-# Fix exact optional property types in index.ts
-# The csvFormat can be undefined, so we need to handle that properly
-
-# Fix coerceString calls to handle null properly
-sed -i "s/coerceString(format.thousands_separator ?? null, null)/coerceString(format.thousands_separator ?? null, '')/g" src/tools/reconciliation/index.ts
-sed -i "s/coerceString(format.date_column ?? null, null)/coerceString(format.date_column ?? null, '')/g" src/tools/reconciliation/index.ts
-sed -i "s/coerceString(format.amount_column ?? null, null)/coerceString(format.amount_column ?? null, '')/g" src/tools/reconciliation/index.ts
-sed -i "s/coerceString(format.description_column ?? null, null)/coerceString(format.description_column ?? null, '')/g" src/tools/reconciliation/index.ts
-
-echo "Type fixes applied"

package/test-csv-sample.csv

@@ -1,28 +0,0 @@
-Date,Description,Amount,Balance
-2024-01-15,"GROCERY STORE PURCHASE",-45.67,1234.56
-2024-01-16,"PAYCHECK DEPOSIT",2500.00,3734.56
-2024-01-17,"COFFEE SHOP",-4.25,3730.31
-2024-01-18,"ATM WITHDRAWAL",-60.00,3670.31
-2024-01-19,"ONLINE PURCHASE - AMAZON",-23.45,3646.86
-2024-01-20,"RESTAURANT DINNER",-78.90,3567.96
-2024-01-22,"GAS STATION",-52.34,3515.62
-2024-01-23,"PHARMACY",-12.67,3502.95
-2024-01-24,"UTILITY PAYMENT",-125.00,3377.95
-2024-01-25,"GROCERY STORE PURCHASE",-67.89,3310.06
-2024-01-26,"MOBILE PHONE BILL",-85.00,3225.06
-2024-01-29,"RESTAURANT LUNCH",-18.45,3206.61
-2024-01-30,"BANK INTEREST EARNED",2.15,3208.76
-2024-01-31,"MONTHLY RENT",-1200.00,2008.76
-2024-02-01,"COFFEE SHOP",-4.75,2004.01
-2024-02-02,"GROCERY STORE PURCHASE",-89.23,1914.78
-2024-02-03,"MOVIE THEATER",-24.00,1890.78
-2024-02-05,"ONLINE SUBSCRIPTION",-9.99,1880.79
-2024-02-06,"RESTAURANT DINNER",-56.78,1823.01
-2024-02-07,"GAS STATION",-48.90,1774.11
-2024-02-08,"PHARMACY",-15.67,1758.44
-2024-02-09,"GROCERY STORE PURCHASE",-34.56,1723.88
-2024-02-12,"PAYCHECK DEPOSIT",2500.00,4223.88
-2024-02-13,"INSURANCE PAYMENT",-150.00,4073.88
-2024-02-14,"RESTAURANT VALENTINE",-95.67,3978.21
-2024-02-15,"DUPLICATE AMOUNT TEST",-45.67,3932.54
-2024-02-16,"PENDING TRANSACTION",-123.45,3809.09

package/test-exports/sample_bank_statement.csv

@@ -1,7 +0,0 @@
-Date,Amount,Description
-01/15/2025,25.50,Coffee Shop Purchase
-01/16/2025,-100.00,ATM Withdrawal
-01/17/2025,45.75,Grocery Store
-01/18/2025,15.99,Netflix Subscription
-01/19/2025,200.00,Paycheck Deposit
-01/20/2025,32.45,Gas Station

package/test-reconcile-autodetect.js

@@ -1,40 +0,0 @@
-/**
- * Test the auto-detect date range functionality
- */
-
-import {
-  extractDateRangeFromCSV,
-  autoDetectCSVFormat,
-} from './dist/tools/compareTransactions/parser.js';
-
-const csvContent = `Date,Description,Debit,Credit,Balance
-11/10/2025,DOLLARAMA # 109,10.91,,
-10/15/2025,Uber Trip,30.50,,
-09/22/2025,CIRCLE K # 05844 A,18.84,,`;
-
-console.log('Testing auto-detection...');
-
-try {
-  // Test 1: Auto-detect format
-  console.log('\n1. Auto-detecting CSV format...');
-  const csvFormat = autoDetectCSVFormat(csvContent);
-  console.log('  ✓ Format detected:', JSON.stringify(csvFormat, null, 2));
-
-  // Test 2: Extract date range
-  console.log('\n2. Extracting date range...');
-  const { minDate, maxDate } = extractDateRangeFromCSV(csvContent, csvFormat);
-  console.log(`  ✓ Date range: ${minDate} to ${maxDate}`);
-
-  // Test 3: Calculate buffer date
-  console.log('\n3. Calculating YNAB fetch date with 7-day buffer...');
-  const minDateObj = new Date(minDate);
-  minDateObj.setDate(minDateObj.getDate() - 7);
-  const fetchDate = minDateObj.toISOString().split('T')[0];
-  console.log(`  ✓ YNAB fetch from: ${fetchDate}`);
-
-  console.log('\n✅ All tests passed!');
-} catch (error) {
-  console.error('\n❌ ERROR:', error.message);
-  console.error(error.stack);
-  process.exit(1);
-}

package/test-reconcile-tool.js

@@ -1,152 +0,0 @@
-#!/usr/bin/env node
-/**
- * Test script for reconcile_account_v2 tool
- *
- * Usage:
- *   node test-reconcile-tool.js <csv-file> <budget-id> <account-id> <statement-balance>
- *
- * Example:
- *   node test-reconcile-tool.js test.csv last-used checking -1500.00
- */
-
-import { API } from 'ynab';
-import { handleReconcileAccountV2 } from './dist/tools/reconciliation/index.js';
-import { readFileSync } from 'fs';
-
-async function testReconciliation() {
-  // Parse arguments
-  const csvFile = process.argv[2];
-  const budgetId = process.argv[3] || 'last-used';
-  const accountId = process.argv[4];
-  const statementBalance = parseFloat(process.argv[5] || '0');
-
-  if (!csvFile || !accountId) {
-    console.error(
-      'Usage: node test-reconcile-tool.js <csv-file> <budget-id> <account-id> <statement-balance>',
-    );
-    console.error('Example: node test-reconcile-tool.js test.csv last-used checking -1500.00');
-    process.exit(1);
-  }
-
-  // Check for YNAB token
-  const token = process.env.YNAB_ACCESS_TOKEN;
-  if (!token) {
-    console.error('❌ YNAB_ACCESS_TOKEN environment variable not set');
-    process.exit(1);
-  }
-
-  // Initialize YNAB API
-  const ynabAPI = new API(token);
-
-  console.log('🔍 Testing reconcile_account_v2...\n');
-  console.log(`CSV File: ${csvFile}`);
-  console.log(`Budget ID: ${budgetId}`);
-  console.log(`Account ID: ${accountId}`);
-  console.log(`Statement Balance: $${statementBalance}`);
-  console.log('\n---\n');
-
-  try {
-    // Read CSV content
-    const csvContent = readFileSync(csvFile, 'utf-8');
-
-    // Call the tool
-    const result = await handleReconcileAccountV2(ynabAPI, {
-      budget_id: budgetId,
-      account_id: accountId,
-      csv_data: csvContent,
-      statement_balance: statementBalance,
-      date_tolerance_days: 2,
-      amount_tolerance_cents: 1,
-      auto_match_threshold: 90,
-      suggestion_threshold: 60,
-    });
-
-    // Parse and display results
-    const analysis = JSON.parse(result.content[0].text);
-
-    console.log('✅ Analysis Complete!\n');
-    console.log('📊 Summary:');
-    console.log(`  Bank Transactions: ${analysis.summary.bank_transactions_count}`);
-    console.log(`  YNAB Transactions: ${analysis.summary.ynab_transactions_count}`);
-    console.log(`  Auto-Matched: ${analysis.summary.auto_matched} (≥90% confidence)`);
-    console.log(`  Suggested Matches: ${analysis.summary.suggested_matches} (60-89% confidence)`);
-    console.log(`  Unmatched Bank: ${analysis.summary.unmatched_bank}`);
-    console.log(`  Unmatched YNAB: ${analysis.summary.unmatched_ynab}`);
-    console.log('\n💰 Balance:');
-    console.log(`  Current Cleared: $${analysis.balance_info.current_cleared.toFixed(2)}`);
-    console.log(`  Target Statement: $${analysis.balance_info.target_statement.toFixed(2)}`);
-    console.log(`  Discrepancy: $${analysis.balance_info.discrepancy.toFixed(2)}`);
-    console.log(`  On Track: ${analysis.balance_info.on_track ? '✅' : '❌'}`);
-
-    if (analysis.auto_matches.length > 0) {
-      console.log('\n✨ Auto-Matched Transactions:');
-      analysis.auto_matches.slice(0, 5).forEach((match, i) => {
-        console.log(
-          `  ${i + 1}. ${match.bank_transaction.payee} - $${match.bank_transaction.amount.toFixed(2)}`,
-        );
-        console.log(`     → Matched to YNAB: ${match.ynab_transaction.payee_name}`);
-        console.log(`     Confidence: ${match.confidence_score}%`);
-      });
-      if (analysis.auto_matches.length > 5) {
-        console.log(`  ... and ${analysis.auto_matches.length - 5} more`);
-      }
-    }
-
-    if (analysis.suggested_matches.length > 0) {
-      console.log('\n💡 Suggested Matches (need review):');
-      analysis.suggested_matches.slice(0, 3).forEach((match, i) => {
-        console.log(
-          `  ${i + 1}. ${match.bank_transaction.payee} - $${match.bank_transaction.amount.toFixed(2)}`,
-        );
-        if (match.candidates && match.candidates.length > 0) {
-          console.log(
-            `     Top candidate: ${match.candidates[0].ynab_transaction.payee_name} (${match.candidates[0].confidence}%)`,
-          );
-        }
-      });
-      if (analysis.suggested_matches.length > 3) {
-        console.log(`  ... and ${analysis.suggested_matches.length - 3} more`);
-      }
-    }
-
-    if (analysis.unmatched_bank.length > 0) {
-      console.log('\n❓ Unmatched Bank Transactions (not in YNAB):');
-      analysis.unmatched_bank.slice(0, 3).forEach((txn, i) => {
-        console.log(`  ${i + 1}. ${txn.payee} - $${txn.amount.toFixed(2)} on ${txn.date}`);
-      });
-      if (analysis.unmatched_bank.length > 3) {
-        console.log(`  ... and ${analysis.unmatched_bank.length - 3} more`);
-      }
-    }
-
-    if (analysis.insights && analysis.insights.length > 0) {
-      console.log('\n💡 Insights:');
-      analysis.insights.forEach((insight) => {
-        const icon =
-          insight.severity === 'critical' ? '🔴' : insight.severity === 'warning' ? '⚠️' : 'ℹ️';
-        console.log(`  ${icon} ${insight.title}`);
-        console.log(`     ${insight.description}`);
-      });
-    }
-
-    console.log('\n📋 Next Steps:');
-    analysis.next_steps.forEach((step, i) => {
-      console.log(`  ${i + 1}. ${step}`);
-    });
-
-    console.log('\n✅ Test complete!');
-    console.log('\nFull results saved to: reconcile-analysis-result.json');
-
-    // Save full results
-    require('fs').writeFileSync(
-      'reconcile-analysis-result.json',
-      JSON.stringify(analysis, null, 2),
-    );
-  } catch (error) {
-    console.error('❌ Error:', error.message);
-    console.error(error);
-    process.exit(1);
-  }
-}
-
-testReconciliation();

package/test-reconcile-with-csv.cjs

@@ -1,89 +0,0 @@
-/**
- * Test reconciliation with merged CSV data
- * Run this script using the YNAB MCP server in your other context
- */
-
-const fs = require('fs');
-const path = require('path');
-
-// Read the CSV files
-const downloadsPath = path.join(process.env.USERPROFILE, 'Downloads');
-const csv1Path = path.join(downloadsPath, 'accountactivity.csv');
-const csv2Path = path.join(downloadsPath, 'accountactivity1.csv');
-const csv3Path = path.join(downloadsPath, 'accountactivity2.csv');
-
-let csv1, csv2, csv3;
-try {
-  csv1 = fs.readFileSync(csv1Path, 'utf-8');
-  csv2 = fs.readFileSync(csv2Path, 'utf-8');
-  csv3 = fs.readFileSync(csv3Path, 'utf-8');
-} catch (error) {
-  console.error('Error reading CSV files:', error.message);
-  process.exit(1);
-}
-// Merge CSVs (skip header from second and third files)
-const lines1 = csv1.split('\n');
-const lines2 = csv2.split('\n');
-const lines3 = csv3.split('\n');
-
-// Get header from first file
-const header = lines1[0];
-
-// Get data rows (skip header from all files, skip empty lines)
-const data1 = lines1.slice(1).filter(line => line.trim());
-const data2 = lines2.slice(1).filter(line => line.trim());
-const data3 = lines3.slice(1).filter(line => line.trim());
-
-// Combine and deduplicate
-const allData = [...data1, ...data2, ...data3];
-const uniqueData = [...new Set(allData)];
-
-// Reconstruct CSV
-const mergedCsv = [header, ...uniqueData].join('\n');
-
-const BUDGET_ID = process.env.YNAB_BUDGET_ID || '00dd8b56-cca8-4a1f-a3ea-02b13df8c2ff';
-const ACCOUNT_ID = process.env.YNAB_ACCOUNT_ID || '083f96c0-ed01-497d-93ab-f94c5ba89509';
-const STATEMENT_BALANCE = parseFloat(process.env.STATEMENT_BALANCE || '-1234.91');
-if (isNaN(STATEMENT_BALANCE)) {
-  console.error('Invalid STATEMENT_BALANCE value');
-  process.exit(1);
-}const STATEMENT_DATE = process.env.STATEMENT_DATE || '2025-01-11';
-
-const reconciliationCall = {
-  tool: 'reconcile_account',
-  params: {
-    budget_id: BUDGET_ID,
-    account_id: ACCOUNT_ID,
-    statement_balance: STATEMENT_BALANCE,
-    statement_date: STATEMENT_DATE,
-    csv_data: mergedCsv,
-    csv_format: {
-      date_column: 'Transaction Date',
-      description_column: 'Description',
-      amount_column: 'Amount',
-      date_format: 'YYYY-MM-DD',
-      has_header: true,
-      delimiter: ','
-    },
-    dry_run: false,
-    auto_create_transactions: true,
-    auto_update_cleared_status: true,
-    auto_unclear_missing: true,
-    include_structured_data: false
-  }
-};    auto_update_cleared_status: true,
-    auto_unclear_missing: true,
-    include_structured_data: false
-  }
-};
-const mergedCsvPath = path.join(downloadsPath, 'accountactivity-merged.csv');
-try {
-  fs.writeFileSync(mergedCsvPath, mergedCsv);
-  console.log(`\n\nMerged CSV saved to: ${mergedCsvPath}`);
-} catch (error) {
-  console.error('Error saving merged CSV:', error.message);
-}
-// Also save the merged CSV for reference
-const mergedCsvPath = path.join(downloadsPath, 'accountactivity-merged.csv');
-fs.writeFileSync(mergedCsvPath, mergedCsv);
-console.log(`\n\nMerged CSV saved to: ${mergedCsvPath}`);

package/test-statement.csv

@@ -1,8 +0,0 @@
-Date,Description,Amount
-2025-10-23,EvoCarShare,-2.24
-2025-10-22,Amazon.ca*NU6MP0D91,-23.47
-2025-10-22,Amazon.ca*NU1G88CB2,-9.49
-2025-10-20,OXIO.CA,-54.88
-2025-10-20,PAYMENT - THANK YOU,1097.27
-2025-10-20,BURGER KING # 6271,-23.09
-2025-10-30,EvoCarShare,-22.22

package/test_debug.js

@@ -1,47 +0,0 @@
-import { handleCreateTransaction } from './dist/tools/transactionTools.js';
-import * as ynab from 'ynab';
-import { vi } from 'vitest';
-
-const mockYnabAPI = {
-  transactions: {
-    createTransaction: async () => ({
-      data: {
-        transaction: {
-          id: 'new-transaction-123',
-          date: '2024-01-01',
-          amount: -50000,
-          memo: null,
-          cleared: 'cleared',
-          approved: true,
-          flag_color: 'red',
-          account_id: 'account-456',
-        },
-      },
-    }),
-  },
-  accounts: {
-    getAccountById: async () => ({
-      data: {
-        account: {
-          id: 'account-456',
-          balance: 100000,
-          cleared_balance: 95000,
-        },
-      },
-    }),
-  },
-};
-
-const params = {
-  budget_id: 'budget-123',
-  account_id: 'account-456',
-  amount: -50000,
-  date: '2024-01-01',
-};
-
-try {
-  const result = await handleCreateTransaction(mockYnabAPI, params);
-  console.log('Result:', JSON.stringify(result, null, 2));
-} catch (error) {
-  console.error('Error:', error);
-}

package/test_mcp_tools.mjs

@@ -1,75 +0,0 @@
-import { spawn } from 'child_process';
-
-const server = spawn('node', ['dist/index.js'], {
-  stdio: ['pipe', 'pipe', 'inherit'],
-  env: process.env,
-});
-
-// Send initialize request
-const initRequest = {
-  jsonrpc: '2.0',
-  id: 1,
-  method: 'initialize',
-  params: {
-    protocolVersion: '2024-11-05',
-    capabilities: {},
-    clientInfo: {
-      name: 'test-client',
-      version: '1.0.0',
-    },
-  },
-};
-
-// Send list tools request
-const listToolsRequest = {
-  jsonrpc: '2.0',
-  id: 2,
-  method: 'tools/list',
-  params: {},
-};
-
-let buffer = '';
-server.stdout.on('data', (data) => {
-  buffer += data.toString();
-  const lines = buffer.split('\n');
-  buffer = lines.pop() || '';
-
-  for (const line of lines) {
-    if (line.trim()) {
-      try {
-        const response = JSON.parse(line);
-        console.log('Response:', JSON.stringify(response, null, 2));
-
-        if (response.id === 1) {
-          // After init, send list tools
-          server.stdin.write(JSON.stringify(listToolsRequest) + '\n');
-        } else if (response.id === 2) {
-          // Got tools list
-          if (response.result && response.result.tools) {
-            console.log(`\n✅ Found ${response.result.tools.length} tools`);
-            response.result.tools.forEach((tool) => {
-              const desc = tool.description.substring(0, 60);
-              console.log(`  - ${tool.name}: ${desc}...`);
-            });
-          } else {
-            console.log('\n❌ No tools found in response');
-          }
-          server.kill();
-        }
-      } catch (e) {
-        // Ignore parse errors for non-JSON output
-      }
-    }
-  }
-});
-
-setTimeout(() => {
-  console.log('\n⏱️ Timeout - sending requests');
-  server.stdin.write(JSON.stringify(initRequest) + '\n');
-}, 1000);
-
-setTimeout(() => {
-  console.log('❌ Test timed out');
-  server.kill();
-  process.exit(1);
-}, 10000);

package/test_simple.mjs

@@ -1,16 +0,0 @@
-// Simplified test to debug the issue
-const mockResponse = {
-  data: {
-    transaction: {
-      id: 'new-transaction-123',
-      date: '2024-01-01',
-      amount: -50000,
-      account_id: 'account-456',
-    },
-    server_knowledge: 1,
-  },
-};
-
-console.log('Mock response:', JSON.stringify(mockResponse, null, 2));
-console.log('Transaction:', mockResponse.data.transaction);
-console.log('Server knowledge:', mockResponse.data.server_knowledge);