@fuzzle/opencode-accountant 0.0.13 → 0.0.14-next.1

package/dist/index.js

@@ -17689,6 +17689,18 @@ function countTransactions(hledgerOutput) {
   }
   return count;
 }
+function extractTransactionYears(hledgerOutput) {
+  const years = new Set;
+  const lines = hledgerOutput.split(`
+`);
+  for (const line of lines) {
+    const match = line.match(/^(\d{4})-\d{2}-\d{2}\s+/);
+    if (match) {
+      years.add(parseInt(match[1], 10));
+    }
+  }
+  return years;
+}
 
 // src/utils/rulesParser.ts
 function parseSkipRows(rulesContent) {
@@ -17903,6 +17915,36 @@ function findMatchingCsvRow(posting, csvRows, config2) {
 }
 
 // src/tools/import-statements.ts
+function ensureYearJournalExists(directory, year) {
+  const ledgerDir = path6.join(directory, "ledger");
+  const yearJournalPath = path6.join(ledgerDir, `${year}.journal`);
+  const mainJournalPath = path6.join(directory, ".hledger.journal");
+  if (!fs7.existsSync(ledgerDir)) {
+    fs7.mkdirSync(ledgerDir, { recursive: true });
+  }
+  if (!fs7.existsSync(yearJournalPath)) {
+    fs7.writeFileSync(yearJournalPath, `; ${year} transactions
+`);
+  }
+  if (!fs7.existsSync(mainJournalPath)) {
+    throw new Error(`.hledger.journal not found at ${mainJournalPath}. Create it first with appropriate includes.`);
+  }
+  const mainJournalContent = fs7.readFileSync(mainJournalPath, "utf-8");
+  const includeDirective = `include ledger/${year}.journal`;
+  const lines = mainJournalContent.split(`
+`);
+  const includeExists = lines.some((line) => {
+    const trimmed = line.trim();
+    return trimmed === includeDirective || trimmed.startsWith(includeDirective + " ");
+  });
+  if (!includeExists) {
+    const newContent = mainJournalContent.trimEnd() + `
+` + includeDirective + `
+`;
+    fs7.writeFileSync(mainJournalPath, newContent);
+  }
+  return yearJournalPath;
+}
 function findPendingCsvFiles(pendingDir, provider, currency) {
   const csvFiles = [];
   if (!fs7.existsSync(pendingDir)) {
@@ -18006,18 +18048,32 @@ async function importStatementsCore(directory, agent, options, configLoader = lo
     const unknownPostings = parseUnknownPostings(result.stdout);
     const transactionCount = countTransactions(result.stdout);
     const matchedCount = transactionCount - unknownPostings.length;
+    const years = extractTransactionYears(result.stdout);
+    if (years.size > 1) {
+      const yearList = Array.from(years).sort().join(", ");
+      filesWithErrors++;
+      fileResults.push({
+        csv: path6.relative(directory, csvFile),
+        rulesFile: path6.relative(directory, rulesFile),
+        totalTransactions: transactionCount,
+        matchedTransactions: matchedCount,
+        unknownPostings: [],
+        error: `CSV contains transactions from multiple years (${yearList}). Split the CSV by year before importing.`
+      });
+      continue;
+    }
+    const transactionYear = years.size === 1 ? Array.from(years)[0] : undefined;
     if (unknownPostings.length > 0) {
       try {
         const rulesContent = fs7.readFileSync(rulesFile, "utf-8");
         const rulesConfig = parseRulesFile(rulesContent);
         const csvRows = parseCsvFile(csvFile, rulesConfig);
         for (const posting of unknownPostings) {
-          const csvRow = findMatchingCsvRow({
+          posting.csvRow = findMatchingCsvRow({
             date: posting.date,
             description: posting.description,
             amount: posting.amount
           }, csvRows, rulesConfig);
-          posting.csvRow = csvRow;
         }
       } catch {
         for (const posting of unknownPostings) {
@@ -18033,7 +18089,8 @@ async function importStatementsCore(directory, agent, options, configLoader = lo
       rulesFile: path6.relative(directory, rulesFile),
       totalTransactions: transactionCount,
       matchedTransactions: matchedCount,
-      unknownPostings
+      unknownPostings,
+      transactionYear
     });
   }
   const hasUnknowns = totalUnknown > 0;
@@ -18077,11 +18134,53 @@ async function importStatementsCore(directory, agent, options, configLoader = lo
     });
   }
   const importedFiles = [];
-  for (const csvFile of csvFiles) {
-    const rulesFile = findRulesForCsv(csvFile, rulesMapping);
+  for (const fileResult of fileResults) {
+    const csvFile = path6.join(directory, fileResult.csv);
+    const rulesFile = fileResult.rulesFile ? path6.join(directory, fileResult.rulesFile) : null;
     if (!rulesFile)
       continue;
-    const result = await hledgerExecutor(["import", csvFile, "--rules-file", rulesFile]);
+    const year = fileResult.transactionYear;
+    if (!year) {
+      return JSON.stringify({
+        success: false,
+        files: fileResults,
+        summary: {
+          filesProcessed: csvFiles.length,
+          filesWithErrors: 1,
+          filesWithoutRules,
+          totalTransactions,
+          matched: totalMatched,
+          unknown: totalUnknown
+        },
+        error: `No transactions found in ${fileResult.csv}`
+      });
+    }
+    let yearJournalPath;
+    try {
+      yearJournalPath = ensureYearJournalExists(directory, year);
+    } catch (error45) {
+      return JSON.stringify({
+        success: false,
+        files: fileResults,
+        summary: {
+          filesProcessed: csvFiles.length,
+          filesWithErrors: 1,
+          filesWithoutRules,
+          totalTransactions,
+          matched: totalMatched,
+          unknown: totalUnknown
+        },
+        error: error45 instanceof Error ? error45.message : String(error45)
+      });
+    }
+    const result = await hledgerExecutor([
+      "import",
+      "-f",
+      yearJournalPath,
+      csvFile,
+      "--rules-file",
+      rulesFile
+    ]);
     if (result.exitCode !== 0) {
       return JSON.stringify({
         success: false,
@@ -18094,7 +18193,7 @@ async function importStatementsCore(directory, agent, options, configLoader = lo
           matched: totalMatched,
           unknown: totalUnknown
         },
-        error: `Import failed for ${path6.relative(directory, csvFile)}: ${result.stderr.trim()}`
+        error: `Import failed for ${fileResult.csv}: ${result.stderr.trim()}`
       });
     }
     importedFiles.push(csvFile);

package/docs/tools/import-statements.md

@@ -5,6 +5,20 @@ The `import-statements` tool imports classified CSV bank statements into hledger
 - **Check mode** (`checkOnly: true`, default): Validates transactions and reports any that cannot be categorized
 - **Import mode** (`checkOnly: false`): Imports validated transactions and moves processed files to the done directory
 
+## Year-Based Journal Routing
+
+Transactions are automatically routed to year-specific journal files based on transaction dates:
+
+- Transactions from 2025 → `ledger/2025.journal`
+- Transactions from 2026 → `ledger/2026.journal`
+
+**Automatic setup:**
+
+- If the year journal doesn't exist, it is created automatically
+- The include directive (`include ledger/YYYY.journal`) is added to `.hledger.journal` if not already present
+
+**Constraint:** Each CSV file must contain transactions from a single year. CSVs with transactions spanning multiple years are rejected during check mode with an error message listing the years found.
+
 ## Arguments
 
 | Argument    | Type    | Default | Description                                 |
@@ -33,7 +47,8 @@ When all transactions have matching rules:
       "csv": "{paths.pending}/ubs/chf/transactions-ubs-0235-90250546.0.csv",
       "rulesFile": "{paths.rules}/ubs-0235-90250546.0.rules",
       "transactions": 25,
-      "unknownPostings": []
+      "unknownPostings": [],
+      "transactionYear": 2026
     }
   ],
   "summary": {
@@ -250,3 +265,41 @@ If the config file is missing or invalid:
   "hint": "Ensure config/import/providers.yaml exists with a 'rules' path configured"
 }
 ```
+
+### Multi-Year CSV Error
+
+If a CSV contains transactions from multiple years:
+
+```json
+{
+  "success": false,
+  "files": [
+    {
+      "csv": "{paths.pending}/ubs/chf/transactions.csv",
+      "rulesFile": "{paths.rules}/ubs.rules",
+      "totalTransactions": 10,
+      "matchedTransactions": 10,
+      "unknownPostings": [],
+      "error": "CSV contains transactions from multiple years (2025, 2026). Split the CSV by year before importing."
+    }
+  ],
+  "summary": {
+    "filesProcessed": 1,
+    "filesWithErrors": 1,
+    "totalTransactions": 0,
+    "matched": 0,
+    "unknown": 0
+  }
+}
+```
+
+### Missing Main Journal
+
+If `.hledger.journal` doesn't exist when attempting import:
+
+```json
+{
+  "success": false,
+  "error": ".hledger.journal not found at /path/to/.hledger.journal. Create it first with appropriate includes."
+}
+```

package/package.json

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