@fuzzle/opencode-accountant 0.0.11-next.1 → 0.0.11
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/agent/accountant.md +12 -6
- package/package.json +1 -1
package/agent/accountant.md
CHANGED
|
@@ -29,9 +29,13 @@ permission:
|
|
|
29
29
|
- `ledger/currencies/` - Currency exchange rate files
|
|
30
30
|
- `ledger/YYYY.journal` - Annual hledger journal files
|
|
31
31
|
- `ledger/rules` - hledger rules files
|
|
32
|
+
- `statements/` - Bank and broker account statements
|
|
33
|
+
- `statements/import` - Upload folder for new statements to process
|
|
34
|
+
- `statements/{provider}/YYYY` - Processed statements organized by source and year
|
|
35
|
+
- `doc/agent/todo/` - Agent's task work directory
|
|
36
|
+
- `doc/agent/done/` - Tasks completed by the agent
|
|
32
37
|
- `config/conventions/` - Accounting conventions
|
|
33
|
-
- `config/
|
|
34
|
-
- `config/prices.yaml` - currency pairs configuration file
|
|
38
|
+
- `config/rules/` - import rules files
|
|
35
39
|
|
|
36
40
|
## Conventions & Workflow
|
|
37
41
|
|
|
@@ -54,11 +58,13 @@ When working with accounting tasks:
|
|
|
54
58
|
|
|
55
59
|
## Statement Import Workflow
|
|
56
60
|
|
|
57
|
-
Use the `import-statements` tool to import bank statements.
|
|
61
|
+
Use the `import-statements` tool to import bank statements. The workflow:
|
|
58
62
|
|
|
59
|
-
1. **Prepare**: Drop CSV files into
|
|
60
|
-
2. **Classify**: Run `classify-statements` tool to move files to
|
|
63
|
+
1. **Prepare**: Drop CSV files into `statements/import/`
|
|
64
|
+
2. **Classify**: Run `classify-statements` tool to move files to `doc/agent/todo/import/<provider>/<currency>/`
|
|
61
65
|
3. **Validate (check mode)**: Run `import-statements(checkOnly: true)` to validate transactions
|
|
66
|
+
- Tool runs `hledger print` dry run to check for unknown postings
|
|
67
|
+
- Unknown postings appear as `income:unknown` or `expenses:unknown`
|
|
62
68
|
4. **Handle unknowns**: If unknown postings found:
|
|
63
69
|
- Tool returns full CSV row data for each unknown posting
|
|
64
70
|
- Analyze the CSV row data to understand the transaction
|
|
@@ -69,7 +75,7 @@ Use the `import-statements` tool to import bank statements. Do not edit the ledg
|
|
|
69
75
|
|
|
70
76
|
### Rules Files
|
|
71
77
|
|
|
72
|
-
-
|
|
78
|
+
- Rules files are in `config/rules/` directory
|
|
73
79
|
- Match CSV to rules file via the `source` directive in each `.rules` file
|
|
74
80
|
- Use field names from the `fields` directive for matching
|
|
75
81
|
- Unknown account pattern: `income:unknown` (positive amounts) / `expenses:unknown` (negative amounts)
|