@fuzzle/opencode-accountant 0.4.0 → 0.4.1

package/README.md

@@ -122,12 +122,21 @@ providers:
         currencyField: Currency
         skipRows: 9
         delimiter: ';'
-        renamePattern: 'transactions-ubs-{account-number}.csv'
+        renamePattern: 'ubs-{account-number}-transactions-{from-date}-to-{until-date}.csv'
         metadata:
           - field: account-number
             row: 0
             column: 1
             normalize: spaces-to-dashes
+          - field: from-date
+            row: 2
+            column: 1
+          - field: until-date
+            row: 3
+            column: 1
+          - field: closing-balance
+            row: 5
+            column: 1
     currencies:
       CHF: chf
       EUR: eur
@@ -226,7 +235,14 @@ The `import-pipeline` tool is the single entry point for importing bank statemen
 
 #### Rules File Matching
 
-The tool matches CSV files to their rules files by parsing the `source` directive in each `.rules` file. For example, if `ubs-account.rules` contains:
+The tool matches CSV files to their rules files using multiple methods:
+
+1. **Source directive matching** (primary): Parses the `source` directive in each `.rules` file and supports glob patterns
+2. **Filename matching** (fallback): If path matching fails, matches based on the rules filename prefix
+
+**Example using source directive:**
+
+If `ubs-account.rules` contains:
 
 ```
 source ../../import/pending/ubs/chf/transactions.csv
@@ -234,7 +250,13 @@ source ../../import/pending/ubs/chf/transactions.csv
 
 The tool will use that rules file when processing `transactions.csv`.
 
-**Note:** The `source` path should match your configured `{paths.pending}` directory structure.
+**Example using filename matching:**
+
+If you have a rules file named `ubs-1234-567890.rules` and a CSV file named `ubs-1234-567890-transactions-2026-01-05-to-2026-01-31.csv`, the tool will automatically match them based on the common prefix `ubs-1234-567890`.
+
+This is particularly useful when CSV files move between directories (e.g., from `pending/` to `done/`) or when maintaining exact source paths is impractical.
+
+**Note:** Name your rules files to match the prefix of your CSV files for automatic matching.
 
 See the hledger documentation for details on rules file format and syntax.
 
@@ -265,13 +287,13 @@ Configure metadata extraction in `providers.yaml`:
 
 ```yaml
 metadata:
-  - field: closing_balance
+  - field: closing-balance
     row: 5
     column: 1
-  - field: from_date
+  - field: from-date
     row: 2
     column: 1
-  - field: until_date
+  - field: until-date
     row: 3
     column: 1
 ```

package/agent/accountant.md

@@ -105,7 +105,9 @@ The `import-pipeline` tool provides an **atomic, safe workflow** using git workt
 ### Rules Files
 
 - The location of the rules files is configured in `config/import/providers.yaml`
-- Match CSV to rules file via the `source` directive in each `.rules` file
+- Match CSV to rules file via the `source` directive in each `.rules` file, with automatic fallback to filename-based matching
+- **Filename matching example:** If the rules file is named `ubs-1234-567890.rules`, it will automatically match CSV files like `ubs-1234-567890-transactions-2026-01.csv` based on the common prefix. This works even when CSV files move between directories.
+- When account detection fails, recommend users either fix their `source` directive or rename their rules file to match the CSV filename prefix
 - Use field names from the `fields` directive for matching
 - Unknown account pattern: `income:unknown` (positive amounts) / `expenses:unknown` (negative amounts)
 

package/dist/index.js

@@ -23458,6 +23458,18 @@ function findRulesForCsv(csvPath, mapping) {
       return rulesFile;
     }
   }
+  const csvBasename = path9.basename(csvPath);
+  const matches = [];
+  for (const rulesFile of Object.values(mapping)) {
+    const rulesBasename = path9.basename(rulesFile, ".rules");
+    if (csvBasename.startsWith(rulesBasename)) {
+      matches.push({ rulesFile, prefixLength: rulesBasename.length });
+    }
+  }
+  if (matches.length > 0) {
+    matches.sort((a, b) => b.prefixLength - a.prefixLength);
+    return matches[0].rulesFile;
+  }
   return null;
 }
 
@@ -24240,10 +24252,11 @@ function determineClosingBalance(csvFile, config2, options, relativeCsvPath, rul
     metadata = undefined;
   }
   let closingBalance = options.closingBalance;
-  if (!closingBalance && metadata?.closing_balance) {
-    const { closing_balance, currency } = metadata;
-    closingBalance = closing_balance;
-    if (currency && !closingBalance.includes(currency)) {
+  if (!closingBalance && metadata?.["closing-balance"]) {
+    const closingBalanceValue = metadata["closing-balance"];
+    const currency = metadata.currency;
+    closingBalance = closingBalanceValue;
+    if (currency && closingBalance && !closingBalance.includes(currency)) {
       closingBalance = `${currency} ${closingBalance}`;
     }
   }
@@ -24324,7 +24337,7 @@ function tryExtractClosingBalanceFromCSV(csvFile, rulesDir) {
       "balance",
       "Balance",
       "BALANCE",
-      "closing_balance",
+      "closing-balance",
       "Closing Balance",
       "account_balance",
       "Account Balance",
@@ -24875,8 +24888,8 @@ async function executeMergeStep(context, worktree) {
     throw new Error("Import or reconcile step not completed before merge");
   }
   const commitInfo = {
-    fromDate: reconcileDetails.metadata?.from_date,
-    untilDate: reconcileDetails.metadata?.until_date
+    fromDate: reconcileDetails.metadata?.["from-date"],
+    untilDate: reconcileDetails.metadata?.["until-date"]
   };
   const transactionCount = importDetails.summary?.totalTransactions || 0;
   const commitMessage = buildCommitMessage(context.options.provider, context.options.currency, commitInfo.fromDate, commitInfo.untilDate, transactionCount);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fuzzle/opencode-accountant",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "An OpenCode accounting agent, specialized in double-entry-bookkepping with hledger",
   "author": {
     "name": "ali bengali",