"CLI-Anything: Making ALL Software Agent-Native" -- CLI-Hub: https://clianything.cc/
Python
fix: complete firefly iii harness review items
yuhao37a9affb9122
diff --git a/firefly-iii/agent-harness/cli_anything/firefly_iii/firefly_iii_cli.py b/firefly-iii/agent-harness/cli_anything/firefly_iii/firefly_iii_cli.pyindex b427aeca3..5069f0cf1 100644--- a/firefly-iii/agent-harness/cli_anything/firefly_iii/firefly_iii_cli.py+++ b/firefly-iii/agent-harness/cli_anything/firefly_iii/firefly_iii_cli.py@@ -9,6 +9,7 @@ converted from MCP mode to stateless CLI mode to avoid Node residual process issimport clickimport jsonimport os+import shleximport sysfrom typing import Dict, Any, Optional@@ -175,16 +176,30 @@ def repl():_repl_skin.help(cli.commands)continue- # Parse command- parts = user_input.split()+ # Parse command through shell-like rules so quoted arguments survive.+ try:+ parts = shlex.split(user_input)+ except ValueError as e:+ _repl_skin.error(f"Parse error: {e}")+ continue+command_name = parts[0]args = parts[1:]if command_name in cli.commands:- # Build command context- ctx = click.Context(cli.commands[command_name])- # Simplified handling, actual parsing should be implemented- click.echo(f"Executing: {command_name} {' '.join(args)}")+ try:+ cli.commands[command_name].main(+ args=args,+ prog_name=command_name,+ standalone_mode=False,+ )+ except click.ClickException as e:+ _repl_skin.error(e.format_message())+ except click.Abort:+ _repl_skin.error("Command aborted")+ except click.exceptions.Exit as e:+ if e.exit_code:+ _repl_skin.error(f"Command exited with status {e.exit_code}")else:_repl_skin.error(f"Unknown command: {command_name}")diff --git a/firefly-iii/agent-harness/cli_anything/firefly_iii/tests/test_core.py b/firefly-iii/agent-harness/cli_anything/firefly_iii/tests/test_core.pyindex 21cd7ca36..ebf0b45fb 100644--- a/firefly-iii/agent-harness/cli_anything/firefly_iii/tests/test_core.py+++ b/firefly-iii/agent-harness/cli_anything/firefly_iii/tests/test_core.py@@ -6,6 +6,8 @@ Test core functionality with synthetic data, no external dependenciesimport pytestimport json+import click+from click.testing import CliRunnerfrom unittest.mock import Mock, patch, MagicMockfrom datetime import datetime@@ -491,3 +493,114 @@ class TestCLIClick:expected = ['list', 'get', 'create', 'update', 'delete', 'trigger']for cmd in expected:assert cmd in webhooks.commands, f"webhooks.{cmd} not found"++ def test_repl_dispatches_click_command_with_quoted_args(self):+ """Test REPL dispatches parsed input through Click and preserves quotes"""+ import cli_anything.firefly_iii.firefly_iii_cli as cli_module++ class FakeReplSkin:+ prompts = ['probe "two words"', 'exit']++ def __init__(self, *args, **kwargs):+ pass++ def print_banner(self):+ pass++ def info(self, message):+ pass++ def prompt(self, prompt_name):+ return self.prompts.pop(0)++ def print_goodbye(self):+ pass++ def error(self, message):+ raise AssertionError(f"Unexpected REPL error: {message}")++ def help(self, commands):+ pass++ @click.command(name="probe")+ @click.argument("value")+ def probe(value):+ click.echo(f"value={value}")++ original_probe = cli_module.cli.commands.get("probe")+ cli_module.cli.add_command(probe)++ try:+ runner = CliRunner()+ with patch.object(cli_module, "FireflyIIIBackend", return_value=Mock()), \+ patch.object(cli_module, "ReplSkin", FakeReplSkin):+ result = runner.invoke(+ cli_module.cli,+ ["--base-url", "https://firefly.example.com", "--pat", "test-pat"],+ )+ finally:+ if original_probe is None:+ cli_module.cli.commands.pop("probe", None)+ else:+ cli_module.cli.commands["probe"] = original_probe++ assert result.exit_code == 0+ assert "value=two words" in result.output++ def test_repl_click_error_remains_interactive(self):+ """Test Click parser errors are reported without exiting the REPL"""+ import cli_anything.firefly_iii.firefly_iii_cli as cli_module++ class FakeReplSkin:+ prompts = ["probe-error --unknown", "exit"]+ instances = []++ def __init__(self, *args, **kwargs):+ self.errors = []+ self.goodbye_printed = False+ self.instances.append(self)++ def print_banner(self):+ pass++ def info(self, message):+ pass++ def prompt(self, prompt_name):+ return self.prompts.pop(0)++ def print_goodbye(self):+ self.goodbye_printed = True++ def error(self, message):+ self.errors.append(message)++ def help(self, commands):+ pass++ @click.command(name="probe-error")+ @click.option("--known")+ def probe_error(known):+ click.echo(f"known={known}")++ original_probe = cli_module.cli.commands.get("probe-error")+ cli_module.cli.add_command(probe_error)++ try:+ runner = CliRunner()+ with patch.object(cli_module, "FireflyIIIBackend", return_value=Mock()), \+ patch.object(cli_module, "ReplSkin", FakeReplSkin):+ result = runner.invoke(+ cli_module.cli,+ ["--base-url", "https://firefly.example.com", "--pat", "test-pat"],+ )+ finally:+ if original_probe is None:+ cli_module.cli.commands.pop("probe-error", None)+ else:+ cli_module.cli.commands["probe-error"] = original_probe++ assert result.exit_code == 0+ skin = FakeReplSkin.instances[-1]+ assert any("No such option" in error for error in skin.errors)+ assert skin.goodbye_printed is Truediff --git a/registry.json b/registry.jsonindex 7deef2280..4c5b5850a 100644--- a/registry.json+++ b/registry.json@@ -176,6 +176,25 @@}]},+ {+ "name": "firefly-iii",+ "display_name": "Firefly III",+ "version": "1.0.0",+ "description": "Personal finance management via the Firefly III REST API",+ "requires": "Firefly III instance and personal access token",+ "homepage": "https://www.firefly-iii.org",+ "source_url": null,+ "install_cmd": "pip install git+https://github.com/HKUDS/CLI-Anything.git#subdirectory=firefly-iii/agent-harness",+ "entry_point": "cli-anything-firefly-iii",+ "skill_md": "skills/cli-anything-firefly-iii/SKILL.md",+ "category": "finance",+ "contributors": [+ {+ "name": "CLI-Anything Community",+ "url": "https://github.com/HKUDS/CLI-Anything"+ }+ ]+ },{"name": "gimp","display_name": "GIMP",diff --git a/skills/cli-anything-firefly-iii/SKILL.md b/skills/cli-anything-firefly-iii/SKILL.mdnew file mode 100644index 000000000..c1836d611--- /dev/null+++ b/skills/cli-anything-firefly-iii/SKILL.md@@ -0,0 +1,709 @@+---+name: "cli-anything-firefly-iii"+description: "Firefly III CLI - Personal finance management via CLI-Anything"+version: "2.0.0"+author: "CLI-Anything Community"+---++# Firefly III CLI++Firefly III command-line interface based on CLI-Anything specification. Converts MCP mode to stateless CLI mode to avoid Node residual process issues.++## Installation++```bash+pip install cli-anything-firefly-iii+```++## Prerequisites++- Python 3.10++- Running Firefly III instance+- Personal Access Token (PAT)++## Configuration++### Environment Variables (Recommended)++```bash+export FIREFLY_III_BASE_URL="https://firefly.yourdomain.com"+export FIREFLY_III_PAT="your-personal-access-token"+```++### Command Line Arguments++```bash+cli-anything-firefly-iii --base-url https://firefly.yourdomain.com --pat your-token+```++## Command Groups++| Command Group | Description | Corresponding API |+|--------------|-------------|-------------------|+| `accounts` | Account management (CRUD) | `/api/v1/accounts` |+| `transactions` | Transaction management (CRUD) | `/api/v1/transactions` |+| `budgets` | Budget management (CRUD + limits) | `/api/v1/budgets` |+| `categories` | Category management (CRUD) | `/api/v1/categories` |+| `tags` | Tag management (CRUD) | `/api/v1/tags` |+| `bills` | Bill management (CRUD) | `/api/v1/bills` |+| `piggy-banks` | Piggy bank management (CRUD + events) | `/api/v1/piggy-banks` |+| `autocomplete` | Autocomplete for various entities | `/api/v1/autocomplete/*` |+| `currencies` | Currency management (CRUD) | `/api/v1/currencies` |+| `recurrences` | Recurring transaction management (CRUD) | `/api/v1/recurrences` |+| `rules` | Rule management (CRUD + test/execute) | `/api/v1/rules` |+| `rule-groups` | Rule group management (CRUD + execute) | `/api/v1/rule-groups` |+| `summary` | Financial summaries | `/api/v1/summary/*` |+| `webhooks` | Webhook management (CRUD + trigger) | `/api/v1/webhooks` |+| `insights` | Insights and reports | `/api/v1/insight/*` |+| `search` | Search | `/api/v1/search/*` |+| `export` | Data export | `/api/v1/data/export/*` |+| `info` | System information | `/api/v1/about` |++## Usage Examples++### Account Management++```bash+# List all accounts+cli-anything-firefly-iii --json accounts list++# List asset accounts+cli-anything-firefly-iii --json accounts list --type asset++# Get account details+cli-anything-firefly-iii --json accounts get --id 123++# Create account+cli-anything-firefly-iii --json accounts create --name "Cash" --type asset --currency-code USD++# Update account+cli-anything-firefly-iii --json accounts update --id 123 --name "New Name"++# Delete account+cli-anything-firefly-iii accounts delete --id 123+```++### Transaction Management++```bash+# List transactions+cli-anything-firefly-iii --json transactions list --limit 10++# List transactions with date range+cli-anything-firefly-iii --json transactions list --start 2024-01-01 --end 2024-01-31++# Create transaction+cli-anything-firefly-iii --json transactions create \+ --description "Grocery" \+ --amount 50.00 \+ --source-account 1 \+ --category "Food"++# Update transaction+cli-anything-firefly-iii --json transactions update --id 456 --description "Updated"++# Delete transaction+cli-anything-firefly-iii transactions delete --id 456+```++### Budget Management++```bash+# List budgets+cli-anything-firefly-iii --json budgets list++# Get budget details+cli-anything-firefly-iii --json budgets get --id 1++# Create budget+cli-anything-firefly-iii --json budgets create --name "Monthly Budget"++# Update budget+cli-anything-firefly-iii --json budgets update --id 1 --name "New Budget Name"++# Delete budget+cli-anything-firefly-iii budgets delete --id 1++# List budget limits+cli-anything-firefly-iii --json budgets limits --budget-id 1++# Create budget limit+cli-anything-firefly-iii --json budgets limit-create --budget-id 1 --amount 1000 --start 2024-01-01 --end 2024-01-31++# Update budget limit+cli-anything-firefly-iii --json budgets limit-update --id 1 --amount 1500++# Delete budget limit+cli-anything-firefly-iii budgets limit-delete --id 1+```++### Category Management++```bash+# List categories+cli-anything-firefly-iii --json categories list++# Get category+cli-anything-firefly-iii --json categories get --id 1++# Create category+cli-anything-firefly-iii --json categories create --name "Food"++# Update category+cli-anything-firefly-iii --json categories update --id 1 --name "Food & Dining"++# Delete category+cli-anything-firefly-iii categories delete --id 1+```++### Tag Management++```bash+# List tags+cli-anything-firefly-iii --json tags list++# Get tag+cli-anything-firefly-iii --json tags get --id "uuid-here"++# Create tag+cli-anything-firefly-iii --json tags create --tag "important"++# Update tag+cli-anything-firefly-iii --json tags update --id "uuid-here" --tag "important-updated"++# Delete tag+cli-anything-firefly-iii tags delete --id "uuid-here"+```++### Bill Management++```bash+# List bills+cli-anything-firefly-iii --json bills list++# Get bill+cli-anything-firefly-iii --json bills get --id 1++# Create bill+cli-anything-firefly-iii --json bills create \+ --name "Netflix" \+ --amount-min 15.99 \+ --amount-max 15.99 \+ --frequency monthly++# Update bill+cli-anything-firefly-iii --json bills update --id 1 --amount-min 19.99++# Delete bill+cli-anything-firefly-iii bills delete --id 1+```++### Piggy Bank Management++```bash+# List piggy banks+cli-anything-firefly-iii --json piggy-banks list++# Get piggy bank+cli-anything-firefly-iii --json piggy-banks get --id 1++# Create piggy bank+cli-anything-firefly-iii --json piggy-banks create \+ --name "Vacation Fund" \+ --account-id 1 \+ --target-amount 5000++# Update piggy bank+cli-anything-firefly-iii --json piggy-banks update --id 1 --name "New Name"++# Delete piggy bank+cli-anything-firefly-iii piggy-banks delete --id 1++# List piggy bank events+cli-anything-firefly-iii --json piggy-banks events --id 1++# Add money to piggy bank+cli-anything-firefly-iii --json piggy-banks add-money --id 1 --amount 100+```++### Autocomplete++```bash+# Autocomplete accounts+cli-anything-firefly-iii --json autocomplete accounts --query "bank"++# Autocomplete categories+cli-anything-firefly-iii --json autocomplete categories --query "food"++# Autocomplete tags+cli-anything-firefly-iii --json autocomplete tags --query "important"++# Autocomplete transactions+cli-anything-firefly-iii --json autocomplete transactions --query "grocery"++# Autocomplete budgets+cli-anything-firefly-iii --json autocomplete budgets --query "monthly"++# Autocomplete bills+cli-anything-firefly-iii --json autocomplete bills --query "netflix"++# Autocomplete piggy banks+cli-anything-firefly-iii --json autocomplete piggy-banks --query "vacation"++# Autocomplete currencies+cli-anything-firefly-iii --json autocomplete currencies --query "dollar"++# Autocomplete rules+cli-anything-firefly-iii --json autocomplete rules --query "auto"++# Autocomplete rule groups+cli-anything-firefly-iii --json autocomplete rule-groups --query "finances"++# Autocomplete recurring+cli-anything-firefly-iii --json autocomplete recurring --query "rent"++# Autocomplete object groups+cli-anything-firefly-iii --json autocomplete object-groups --query "group"++# Autocomplete transaction types+cli-anything-firefly-iii --json autocomplete transaction-types --query "with"+```++### Currency Management++```bash+# List currencies+cli-anything-firefly-iii --json currencies list++# Get currency+cli-anything-firefly-iii --json currencies get --id 1++# Create currency+cli-anything-firefly-iii --json currencies create \+ --code "CNY" \+ --name "Chinese Yuan" \+ --symbol "¥"++# Update currency+cli-anything-firefly-iii --json currencies update --id 1 --symbol "元"++# Delete currency+cli-anything-firefly-iii currencies delete --id 1++# Get exchange rates+cli-anything-firefly-iii --json currencies exchange-rates --from USD --to EUR+```++### Recurring Transaction Management++```bash+# List recurring transactions+cli-anything-firefly-iii --json recurrences list++# Get recurring transaction+cli-anything-firefly-iii --json recurrences get --id 1++# Create recurring transaction+cli-anything-firefly-iii --json recurrences create \+ --title "Rent Payment" \+ --type withdrawal \+ --amount 1500 \+ --source-account 1 \+ --destination-account 2 \+ --frequency monthly++# Update recurring transaction+cli-anything-firefly-iii --json recurrences update --id 1 --amount 1600++# Delete recurring transaction+cli-anything-firefly-iii recurrences delete --id 1+```++### Rule Management++```bash+# List rules+cli-anything-firefly-iii --json rules list++# Get rule+cli-anything-firefly-iii --json rules get --id 1++# Create rule+cli-anything-firefly-iii --json rules create \+ --title "Auto-tag groceries" \+ --trigger "description_contains" \+ --value "grocery" \+ --action set_category \+ --action-value "Food"++# Update rule+cli-anything-firefly-iii --json rules update --id 1 --title "New Title"++# Delete rule+cli-anything-firefly-iii rules delete --id 1++# Test rule+cli-anything-firefly-iii --json rules test --id 1++# Execute rule+cli-anything-firefly-iii --json rules execute --id 1+```++### Rule Group Management++```bash+# List rule groups+cli-anything-firefly-iii --json rule-groups list++# Get rule group+cli-anything-firefly-iii --json rule-groups get --id 1++# Create rule group+cli-anything-firefly-iii --json rule-groups create --title "Finance Rules"++# Update rule group+cli-anything-firefly-iii --json rule-groups update --id 1 --title "New Title"++# Delete rule group+cli-anything-firefly-iii rule-groups delete --id 1++# Execute rule group+cli-anything-firefly-iii --json rule-groups execute --id 1+```++### Summary Reports++```bash+# Default summary set+cli-anything-firefly-iii --json summary default-set --start 2024-01-01 --end 2024-01-31++# Account summary+cli-anything-firefly-iii --json summary account-summary --start 2024-01-01 --end 2024-01-31++# Available budget summary+cli-anything-firefly-iii --json summary available-budget --start 2024-01-01 --end 2024-01-31++# Bill summary+cli-anything-firefly-iii --json summary bill-summary --start 2024-01-01 --end 2024-01-31++# Budget summary+cli-anything-firefly-iii --json summary budget-summary --start 2024-01-01 --end 2024-01-31++# Category summary+cli-anything-firefly-iii --json summary category-summary --start 2024-01-01 --end 2024-01-31++# Tag summary+cli-anything-firefly-iii --json summary tag-summary --start 2024-01-01 --end 2024-01-31++# Transfer summary+cli-anything-firefly-iii --json summary transfer-summary --start 2024-01-01 --end 2024-01-31+```++### Webhook Management++```bash+# List webhooks+cli-anything-firefly-iii --json webhooks list++# Get webhook+cli-anything-firefly-iii --json webhooks get --id 1++# Create webhook+cli-anything-firefly-iii --json webhooks create \+ --title "My Webhook" \+ --trigger create \+ --url "https://example.com/webhook" \+ --secret "my-secret"++# Update webhook+cli-anything-firefly-iii --json webhooks update --id 1 --title "New Title"++# Delete webhook+cli-anything-firefly-iii webhooks delete --id 1++# Trigger webhook manually+cli-anything-firefly-iii --json webhooks trigger --id 1+```++### Insights and Reports++```bash+# Expense report (by category)+cli-anything-firefly-iii --json insights expense \+ --start 2024-01-01 \+ --end 2024-01-31 \+ --group-by category++# Income report+cli-anything-firefly-iii --json insights income \+ --start 2024-01-01 \+ --end 2024-01-31++# Transfer insights+cli-anything-firefly-iii --json insights transfer \+ --start 2024-01-01 \+ --end 2024-01-31++# Account overview+cli-anything-firefly-iii --json insights overview \+ --start 2024-01-01 \+ --end 2024-01-31+```++### Search++```bash+# Search transactions+cli-anything-firefly-iii --json search transactions --query "grocery"+```++### Data Export++```bash+# Export transactions+cli-anything-firefly-iii --json export transactions \+ --start 2024-01-01 \+ --end 2024-01-31++# Export accounts+cli-anything-firefly-iii --json export accounts++# Export budgets+cli-anything-firefly-iii --json export budgets++# Export categories+cli-anything-firefly-iii --json export categories+```++### System Information++```bash+# System information+cli-anything-firefly-iii --json info about++# Connection status+cli-anything-firefly-iii info status+```++## Preset Filtering++Use `--preset` parameter to filter available commands:++```bash+# Default preset+cli-anything-firefly-iii --preset default accounts list++# Full preset+cli-anything-firefly-iii --preset full accounts list++# Budget preset+cli-anything-firefly-iii --preset budget budgets list++# Reporting preset+cli-anything-firefly-iii --preset reporting insights expense --start 2024-01-01 --end 2024-01-31+```++Available presets:+- `default`: Core features (accounts, transactions, categories, tags, bills, search)+- `full`: All features+- `basic`: Basic features (accounts, transactions, categories, tags, search)+- `budget`: Budget-related (accounts, budgets, transactions, summary, insight)+- `reporting`: Reporting-related (accounts, transactions, categories, insight, summary, search)+- `admin`: Admin features (about, configuration, currencies, users, preferences)+- `automation`: Automation (rules, recurrences, webhooks, transactions)++## Agent Guidelines++### Basic Usage++1. **Use `--json` for structured output**: All commands support `--json` flag, returning JSON format data+2. **Call `info status` first to check connection**: Confirm Firefly III connection is normal before executing operations+3. **Use presets to reduce command count**: Filter unnecessary commands via `--preset`++### Common Workflows++#### View Account Balances++```bash+# 1. Check connection+cli-anything-firefly-iii info status++# 2. List asset accounts+cli-anything-firefly-iii --json accounts list --type asset++# 3. View account details (get balance)+cli-anything-firefly-iii --json accounts get --id <account_id>+```++#### Record Expense++```bash+# 1. Find expense accounts+cli-anything-firefly-iii --json accounts list --type expense++# 2. Create transaction+cli-anything-firefly-iii --json transactions create \+ --description "Lunch" \+ --amount 15.50 \+ --source-account <asset_account_id> \+ --destination-account <expense_account_id> \+ --category "Food"+```++#### Set Up Recurring Budget++```bash+# 1. Create budget+cli-anything-firefly-iii --json budgets create --name "Monthly Groceries"++# 2. Set budget limit+cli-anything-firefly-iii --json budgets limit-create \+ --budget-id <budget_id> \+ --amount 500 \+ --start 2024-01-01 \+ --end 2024-01-31+```++#### Create Automation Rule++```bash+# 1. List rule groups+cli-anything-firefly-iii --json rule-groups list++# 2. Create rule+cli-anything-firefly-iii --json rules create \+ --title "Auto-tag groceries" \+ --trigger description_contains \+ --value "grocery" \+ --action set_category \+ --action-value "Food"++# 3. Execute rule to apply to existing transactions+cli-anything-firefly-iii --json rules execute --id <rule_id>+```++#### Monthly Financial Report++```bash+# 1. Expense report+cli-anything-firefly-iii --json insights expense \+ --start 2024-01-01 \+ --end 2024-01-31 \+ --group-by category++# 2. Income report+cli-anything-firefly-iii --json insights income \+ --start 2024-01-01 \+ --end 2024-01-31++# 3. Budget summary+cli-anything-firefly-iii --json summary budget-summary \+ --start 2024-01-01 \+ --end 2024-01-31++# 4. Export data+cli-anything-firefly-iii --json export transactions \+ --start 2024-01-01 \+ --end 2024-01-31+```++### Error Handling++Common errors and solutions:++1. **Connection failed**: Check if FIREFLY_III_BASE_URL is correct+2. **Authentication failed**: Check if FIREFLY_III_PAT is valid+3. **Resource not found**: Check if ID is correct+4. **Parameter error**: Check if required parameters are provided+5. **Validation error**: Check API documentation for valid parameter values++### Best Practices++1. **Use environment variables for credentials**: Avoid exposing PAT in command line+2. **Use `--json` for scripting**: Facilitates parsing and processing output+3. **Use presets to control permissions**: Choose appropriate preset based on scenario+4. **Query before modifying**: Avoid accidental operations+5. **Use autocomplete for quick lookups**: Great for finding existing entities++## Troubleshooting++### Connection Issues++```+Error: Cannot connect to Firefly III instance+```++- Check if Firefly III instance is running+- Check network connection+- Check if base URL is correct++### Authentication Issues++```+Error: Authentication failed: Personal Access Token is invalid+```++- Check if PAT is correct+- Generate new PAT in Firefly III Options > Profile > OAuth+- Ensure PAT has not expired++### Parameter Validation Errors++```+Error: Request parameter error: [details]+```++- Check required parameters are provided+- Verify date formats (YYYY-MM-DD)+- Verify currency codes (ISO 4217)+- Verify enum values match allowed choices++## Comparison with MCP Version++| Feature | MCP Version | CLI-Anything Version |+|---------|------------|---------------------|+| Process Lifecycle | Long-running | Single call, immediate exit |+| Memory Usage | Continuous | On-demand, released after |+| Communication | Stdio/SSE | Command args + stdout |+| State Management | Stateful | Stateless |+| Preset Filtering | Supported | Supported |+| JSON Output | Built-in | `--json` flag |+| Full API Coverage | Partial | Full API coverage |++## API Coverage++This CLI covers the following Firefly III API endpoints:++- [x] `/api/v1/about` - System information+- [x] `/api/v1/accounts` - Account management (full CRUD)+- [x] `/api/v1/transactions` - Transaction management (full CRUD)+- [x] `/api/v1/budgets` - Budget management (full CRUD + limits)+- [x] `/api/v1/categories` - Category management (full CRUD)+- [x] `/api/v1/tags` - Tag management (full CRUD)+- [x] `/api/v1/bills` - Bill management (full CRUD)+- [x] `/api/v1/piggy-banks` - Piggy bank management (full CRUD + events)+- [x] `/api/v1/autocomplete/*` - All autocomplete endpoints+- [x] `/api/v1/currencies` - Currency management (full CRUD)+- [x] `/api/v1/recurrences` - Recurring transaction management (full CRUD)+- [x] `/api/v1/rules` - Rule management (full CRUD + test/execute)+- [x] `/api/v1/rule-groups` - Rule group management (full CRUD + execute)+- [x] `/api/v1/summary/*` - Summary endpoints+- [x] `/api/v1/webhooks` - Webhook management (full CRUD + trigger)+- [x] `/api/v1/insight/*` - Insight endpoints+- [x] `/api/v1/search/*` - Search endpoints+- [x] `/api/v1/data/export/*` - Export endpoints+- [x] `/api/v1/chart/*` - Chart endpoints+- [x] `/api/v1/configuration` - Configuration+- [x] `/api/v1/preferences` - User preferences+- [x] `/api/v1/available_budgets` - Available budgets+- [x] `/api/v1/object-groups` - Object groups+- [x] `/api/v1/links` - Transaction links+- [x] `/api/v1/attachments` - Attachments+- [x] `/api/v1/currency_exchange_rates` - Exchange rates+- [x] `/api/v1/data/bulk` - Bulk operations+- [x] `/api/v1/user-groups` - User groups (read-only)+- [x] `/api/v1/users` - User management (admin)++## License++MIT License