@rustledger/mcp-server 0.2.0 → 0.5.2

package/dist/docs/bql-functions.md

@@ -0,0 +1,41 @@
+# BQL Functions Reference
+
+## Aggregate Functions
+| Function | Description |
+|----------|-------------|
+| `sum(x)` | Sum of values |
+| `count()` | Count of rows |
+| `first(x)` | First value |
+| `last(x)` | Last value |
+| `min(x)` | Minimum value |
+| `max(x)` | Maximum value |
+
+## Date Functions
+| Function | Description |
+|----------|-------------|
+| `year(date)` | Extract year (integer) |
+| `month(date)` | Extract month (1-12) |
+| `day(date)` | Extract day of month |
+| `quarter(date)` | Extract quarter (1-4) |
+| `weekday(date)` | Day of week (0=Monday) |
+
+## String Functions
+| Function | Description |
+|----------|-------------|
+| `length(s)` | String length |
+| `upper(s)` | Uppercase string |
+| `lower(s)` | Lowercase string |
+
+## Account Functions
+| Function | Description |
+|----------|-------------|
+| `root(account, n)` | First n components |
+| `leaf(account)` | Last component |
+| `parent(account)` | Parent account |
+
+## Conversion Functions
+| Function | Description |
+|----------|-------------|
+| `cost(position)` | Convert to cost basis |
+| `value(position)` | Market value (needs prices) |
+| `units(position)` | Just the units |

package/dist/docs/bql-tables.md

@@ -0,0 +1,26 @@
+# BQL Tables
+
+BQL queries run against these implicit tables:
+
+## entries (default)
+The main table containing all postings from transactions.
+
+| Column | Type | Description |
+|--------|------|-------------|
+| date | date | Transaction date |
+| flag | string | Transaction flag (* or !) |
+| payee | string | Transaction payee |
+| narration | string | Transaction narration |
+| account | string | Posting account |
+| position | position | Posting amount with cost |
+| balance | inventory | Running balance |
+| tags | set | Transaction tags |
+| links | set | Transaction links |
+
+## balances
+Pre-aggregated account balances.
+
+| Column | Type | Description |
+|--------|------|-------------|
+| account | string | Account name |
+| balance | inventory | Total balance |

package/dist/docs/bql.md

@@ -0,0 +1,62 @@
+# BQL - Beancount Query Language
+
+BQL is a SQL-like query language for querying Beancount ledgers.
+
+## Basic Syntax
+
+```sql
+SELECT [DISTINCT] <target-spec>, ...
+[FROM <from-spec>]
+[WHERE <where-expression>]
+[GROUP BY <group-spec>, ...]
+[ORDER BY <order-spec>, ...]
+[LIMIT <limit>]
+```
+
+## Common Queries
+
+### Account Balances
+```sql
+BALANCES
+-- or equivalently:
+SELECT account, sum(position) GROUP BY account
+```
+
+### Filter by Account
+```sql
+SELECT date, narration, position
+WHERE account ~ "Expenses:Food"
+```
+
+### Filter by Date Range
+```sql
+SELECT date, account, position
+WHERE date >= 2024-01-01 AND date < 2024-02-01
+```
+
+### Monthly Summary
+```sql
+SELECT year(date), month(date), sum(position)
+WHERE account ~ "Expenses"
+GROUP BY year(date), month(date)
+ORDER BY year(date), month(date)
+```
+
+### Journal Entries
+```sql
+JOURNAL "Assets:Checking"
+```
+
+## Available Functions
+
+- `year(date)`, `month(date)`, `day(date)` - Extract date parts
+- `sum(position)` - Sum positions
+- `count()` - Count entries
+- `first(x)`, `last(x)` - First/last values
+- `min(x)`, `max(x)` - Min/max values
+
+## Operators
+
+- `~` - Regex match (e.g., `account ~ "Expenses:.*"`)
+- `=`, `!=`, `<`, `>`, `<=`, `>=` - Comparisons
+- `AND`, `OR`, `NOT` - Boolean operators

package/dist/docs/directives.md

@@ -0,0 +1,67 @@
+# Beancount Directives Reference
+
+## Transaction
+```beancount
+2024-01-15 * "Payee" "Narration"
+  Assets:Checking  -50.00 USD
+  Expenses:Food     50.00 USD
+```
+
+## Open Account
+```beancount
+2024-01-01 open Assets:Checking USD,EUR
+```
+
+## Close Account
+```beancount
+2024-12-31 close Assets:OldAccount
+```
+
+## Balance Assertion
+```beancount
+2024-01-31 balance Assets:Checking 1000.00 USD
+```
+
+## Pad
+```beancount
+2024-01-01 pad Assets:Checking Equity:Opening-Balances
+```
+
+## Commodity
+```beancount
+2024-01-01 commodity USD
+  name: "US Dollar"
+```
+
+## Price
+```beancount
+2024-01-15 price AAPL 185.50 USD
+```
+
+## Event
+```beancount
+2024-01-01 event "location" "New York"
+```
+
+## Note
+```beancount
+2024-01-15 note Assets:Checking "Called bank about fees"
+```
+
+## Document
+```beancount
+2024-01-15 document Assets:Checking "/path/to/statement.pdf"
+```
+
+## Query
+```beancount
+2024-01-01 query "monthly-expenses" "
+  SELECT month, sum(position) WHERE account ~ 'Expenses'
+  GROUP BY month
+"
+```
+
+## Custom
+```beancount
+2024-01-01 custom "budget" "Expenses:Food" 500 USD
+```

package/dist/docs/validation-errors.md

@@ -0,0 +1,40 @@
+# Validation Errors Reference
+
+rustledger validates ledgers and reports these error types:
+
+## Account Errors
+- **E0001**: Account not opened before use
+- **E0002**: Account already opened
+- **E0003**: Account closed but still has transactions
+- **E0004**: Invalid account name format
+
+## Balance Errors
+- **E0101**: Balance assertion failed
+- **E0102**: Negative balance not allowed
+
+## Transaction Errors
+- **E0201**: Transaction does not balance
+- **E0202**: Missing posting amount (only one allowed)
+- **E0203**: Currency mismatch in transaction
+
+## Booking Errors
+- **E0301**: Ambiguous lot matching
+- **E0302**: Insufficient lots for reduction
+- **E0303**: Cost basis mismatch
+
+## Date Errors
+- **E0401**: Future date not allowed
+- **E0402**: Date out of order
+
+## Document/Note Errors
+- **E0501**: Document file not found
+- **E0502**: Invalid document path
+
+## Plugin Errors
+- **E0601**: Plugin not found
+- **E0602**: Plugin execution error
+
+## Parse Errors
+- **E0701**: Syntax error
+- **E0702**: Invalid directive format
+- **E0703**: Duplicate option

package/dist/handlers.d.ts

@@ -0,0 +1,6 @@
+import type { ToolResponse, ToolArguments } from "./types.js";
+/**
+ * Handle a tool call and return the response.
+ */
+export declare function handleToolCall(name: string, args: ToolArguments | undefined): ToolResponse;
+//# sourceMappingURL=handlers.d.ts.map

package/dist/handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../src/handlers.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAGV,YAAY,EACZ,aAAa,EACd,MAAM,YAAY,CAAC;AAWpB;;GAEG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,aAAa,GAAG,SAAS,GAC9B,YAAY,CAmEd"}