@firela/billclaw-cli 0.1.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 fire-la
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,204 @@
+# @firela/billclaw-cli
+
+Standalone command-line interface for BillClaw financial data management.
+
+## Overview
+
+The CLI package provides a command-line tool for managing financial data without requiring any AI framework. It includes:
+
+- Interactive setup wizard for connecting accounts
+- Manual transaction sync from Plaid and Gmail
+- Account status monitoring
+- Configuration management
+- Export to Beancount and Ledger formats
+- Import from CSV, OFX, and QFX files
+
+## Installation
+
+### Global Installation
+
+```bash
+npm install -g @firela/billclaw-cli
+```
+
+### Local Installation
+
+```bash
+npm install @firela/billclaw-cli
+npx billclaw
+```
+
+## Quick Start
+
+```bash
+# Interactive setup wizard
+billclaw setup
+
+# Sync all accounts
+billclaw sync
+
+# Sync specific account
+billclaw sync --account plaid-123
+
+# Show account status
+billclaw status
+
+# Export transactions
+billclaw export --format beancount --output transactions.beancount
+```
+
+## Commands
+
+### setup
+
+Interactive setup wizard for connecting accounts.
+
+```bash
+billclaw setup
+```
+
+Supports:
+- Plaid (bank accounts via Plaid Link)
+- Gmail (email bills)
+- GoCardless (European open banking)
+
+### sync
+
+Manually trigger transaction sync.
+
+```bash
+# Sync all accounts
+billclaw sync
+
+# Sync specific account
+billclaw sync --account <id>
+
+# Sync all (explicit)
+billclaw sync --all
+```
+
+### status
+
+Show connection status and recent sync results.
+
+```bash
+billclaw status
+```
+
+Displays:
+- Account ID and type
+- Connection status
+- Last sync time
+
+### config
+
+Manage plugin configuration.
+
+```bash
+# List all configuration
+billclaw config --list
+
+# Get specific value
+billclaw config --key storage.path
+
+# Set value
+billclaw config --key storage.format --value json
+```
+
+### export
+
+Export transactions to Beancount or Ledger format.
+
+```bash
+# Export to Beancount
+billclaw export --format beancount --output transactions.beancount
+
+# Export specific account
+billclaw export --account plaid-123 --format ledger
+
+# Export specific period
+billclaw export --year 2024 --month 1
+```
+
+### import
+
+Import transactions from external files.
+
+```bash
+# Import from CSV
+billclaw import transactions.csv
+
+# Import from OFX
+billclaw import statement.ofx --account checking-123
+```
+
+## Configuration
+
+Configuration is stored in `~/.billclaw/config.json`:
+
+```json
+{
+  "accounts": [],
+  "webhooks": [],
+  "storage": {
+    "path": "~/.billclaw",
+    "format": "json",
+    "encryption": { "enabled": false }
+  },
+  "sync": {
+    "defaultFrequency": "daily",
+    "maxRetries": 3,
+    "retryOnFailure": true
+  },
+  "plaid": {
+    "environment": "sandbox"
+  }
+}
+```
+
+## Data Storage
+
+By default, data is stored in `~/.billclaw/`:
+
+```
+~/.billclaw/
+├── config.json           # Configuration
+├── data/                 # Transaction storage
+│   ├── transactions/     # Per-account transactions
+│   └── accounts/         # Account metadata
+└── exports/              # Exported files
+```
+
+## Exit Codes
+
+- `0` - Success
+- `1` - Error occurred
+
+## Examples
+
+### Complete Workflow
+
+```bash
+# 1. Setup accounts
+billclaw setup
+
+# 2. Sync transactions
+billclaw sync
+
+# 3. Check status
+billclaw status
+
+# 4. Export to Beancount
+billclaw export --format beancount -o main.beancount
+```
+
+### Monthly Accounting Export
+
+```bash
+# Export last month's transactions
+billclaw export   --format beancount   --year 2024   --month 1   --output january.beancount
+```
+
+## License
+
+MIT

package/bin/billclaw.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * BillClaw CLI binary
+ *
+ * Entry point for the billclaw command.
+ */
+
+import { main } from "../dist/index.js";
+
+main(process.argv);

package/dist/commands/config.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Config command
+ *
+ * Manage plugin configuration.
+ */
+import type { CliCommand } from "./registry.js";
+/**
+ * Config command definition
+ */
+export declare const configCommand: CliCommand;
+//# sourceMappingURL=config.d.ts.map

package/dist/commands/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAc,MAAM,eAAe,CAAA;AAuG3D;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,UAyB3B,CAAA"}

package/dist/commands/config.js

@@ -0,0 +1,112 @@
+/**
+ * Config command
+ *
+ * Manage plugin configuration.
+ */
+import { success, error } from "../utils/format.js";
+/**
+ * Run config command
+ */
+async function runConfig(context, args) {
+    const { runtime } = context;
+    const list = args?.list ?? false;
+    const key = args?.key;
+    const value = args?.value;
+    if (list || (!key && !value)) {
+        await listConfig(runtime);
+    }
+    else if (key && value) {
+        await setConfig(runtime, key, value);
+    }
+    else if (key) {
+        await getConfig(runtime, key);
+    }
+}
+/**
+ * List all configuration
+ */
+async function listConfig(runtime) {
+    const config = await runtime.config.getConfig();
+    console.log(JSON.stringify(config, null, 2));
+}
+/**
+ * Get a config value
+ */
+async function getConfig(runtime, key) {
+    const config = await runtime.config.getConfig();
+    // Support dot notation for nested keys
+    const keys = key.split(".");
+    let value = config;
+    for (const k of keys) {
+        value = value?.[k];
+    }
+    if (value === undefined) {
+        console.log(`Config key '${key}' not found`);
+        return;
+    }
+    if (typeof value === "object") {
+        console.log(JSON.stringify(value, null, 2));
+    }
+    else {
+        console.log(String(value));
+    }
+}
+/**
+ * Set a config value
+ */
+async function setConfig(runtime, key, valueStr) {
+    const config = await runtime.config.getConfig();
+    // Support dot notation for nested keys
+    const keys = key.split(".");
+    let target = config;
+    for (let i = 0; i < keys.length - 1; i++) {
+        if (!(keys[i] in target)) {
+            target[keys[i]] = {};
+        }
+        target = target[keys[i]];
+    }
+    // Try to parse as JSON first
+    let parsedValue;
+    try {
+        parsedValue = JSON.parse(valueStr);
+    }
+    catch {
+        parsedValue = valueStr;
+    }
+    target[keys[keys.length - 1]] = parsedValue;
+    // Save the updated config
+    const provider = runtime.config;
+    if (typeof provider.saveConfig === "function") {
+        await provider.saveConfig(config);
+        success(`Config '${key}' updated`);
+    }
+    else {
+        error("Saving config not supported");
+    }
+}
+/**
+ * Config command definition
+ */
+export const configCommand = {
+    name: "config",
+    description: "Manage plugin configuration",
+    options: [
+        {
+            flags: "-l, --list",
+            description: "List all configuration",
+        },
+        {
+            flags: "-k, --key <key>",
+            description: "Config key to view/set",
+        },
+        {
+            flags: "-v, --value <value>",
+            description: "Config value to set",
+        },
+    ],
+    handler: (context, args) => {
+        const typedArgs = args;
+        return runConfig(context, typedArgs ?? {});
+    },
+};
+//# sourceMappingURL=config.js.map

package/dist/commands/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"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"}

package/dist/commands/export.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Export command
+ *
+ * Export transactions to Beancount or Ledger format.
+ */
+import type { CliCommand } from "./registry.js";
+/**
+ * Export command definition
+ */
+export declare const exportCommand: CliCommand;
+//# sourceMappingURL=export.d.ts.map

package/dist/commands/export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../src/commands/export.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAc,MAAM,eAAe,CAAA;AAuG3D;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,UAmC3B,CAAA"}

package/dist/commands/export.js

@@ -0,0 +1,106 @@
+/**
+ * Export command
+ *
+ * Export transactions to Beancount or Ledger format.
+ */
+import { Spinner } from "../utils/progress.js";
+import { Billclaw, exportToBeancount, exportToLedger, } from "@firela/billclaw-core";
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+/**
+ * Run export command
+ */
+async function runExport(context, args) {
+    const { runtime } = context;
+    const billclaw = new Billclaw(runtime);
+    const format = args.format ?? "beancount";
+    const outputPath = args.output ?? getDefaultExportPath(format);
+    const spinner = new Spinner({
+        text: `Exporting transactions to ${format}...`,
+    }).start();
+    try {
+        const now = new Date();
+        const year = args.year ? parseInt(args.year, 10) : now.getFullYear();
+        const month = args.month ? parseInt(args.month, 10) : now.getMonth() + 1;
+        const accountId = args.account;
+        // Get transactions for the specified period
+        const transactions = await billclaw.getTransactions(accountId || "all", year, month);
+        // Export to requested format
+        let content;
+        switch (format) {
+            case "beancount": {
+                const options = {
+                    accountId: accountId || "all",
+                    year,
+                    month,
+                    commodity: "USD",
+                };
+                content = await exportToBeancount(transactions, options);
+                break;
+            }
+            case "ledger": {
+                const options = {
+                    accountId: accountId || "all",
+                    year,
+                    month,
+                    commodity: "USD",
+                };
+                content = await exportToLedger(transactions, options);
+                break;
+            }
+            default:
+                throw new Error(`Unknown export format: ${format}`);
+        }
+        // Ensure output directory exists
+        const outputDir = path.dirname(outputPath);
+        await fs.mkdir(outputDir, { recursive: true });
+        // Write to file
+        await fs.writeFile(outputPath, content, "utf-8");
+        spinner.succeed(`Exported ${transactions.length} transactions to ${outputPath}`);
+    }
+    catch (err) {
+        spinner.fail(`Export failed: ${err.message}`);
+        throw err;
+    }
+}
+/**
+ * Get default export path
+ */
+function getDefaultExportPath(format) {
+    const date = new Date().toISOString().split("T")[0];
+    return `~/.billclaw/exports/${format}-${date}.${format === "beancount" ? "beancount" : "ldg"}`;
+}
+/**
+ * Export command definition
+ */
+export const exportCommand = {
+    name: "export",
+    description: "Export transactions to Beancount or Ledger format",
+    options: [
+        {
+            flags: "-f, --format <format>",
+            description: "Export format: beancount or ledger (default: beancount)",
+        },
+        {
+            flags: "-o, --output <path>",
+            description: "Output file path",
+        },
+        {
+            flags: "-a, --account <id>",
+            description: "Account ID to export (default: all)",
+        },
+        {
+            flags: "-y, --year <year>",
+            description: "Year to export (default: current year)",
+        },
+        {
+            flags: "-m, --month <month>",
+            description: "Month to export (default: current month)",
+        },
+    ],
+    handler: (context, args) => {
+        const typedArgs = args;
+        return runExport(context, typedArgs ?? {});
+    },
+};
+//# sourceMappingURL=export.js.map

package/dist/commands/export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.js","sourceRoot":"","sources":["../../src/commands/export.ts"],"names":[],"mappings":"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"}

package/dist/commands/index.d.ts

@@ -0,0 +1,46 @@
+/**
+ * CLI commands module
+ *
+ * All available CLI commands.
+ */
+export { CommandRegistry, type CliCommand, type CliContext, type CliCommandHandler, } from "./registry.js";
+export { setupCommand } from "./setup.js";
+export { syncCommand } from "./sync.js";
+export { statusCommand } from "./status.js";
+export { configCommand } from "./config.js";
+export { exportCommand } from "./export.js";
+/**
+ * All commands to register
+ */
+export declare const allCommands: ({
+    setup: () => Promise<import("./registry.js").CliCommand>;
+    sync?: undefined;
+    status?: undefined;
+    config?: undefined;
+    export?: undefined;
+} | {
+    sync: () => Promise<import("./registry.js").CliCommand>;
+    setup?: undefined;
+    status?: undefined;
+    config?: undefined;
+    export?: undefined;
+} | {
+    status: () => Promise<import("./registry.js").CliCommand>;
+    setup?: undefined;
+    sync?: undefined;
+    config?: undefined;
+    export?: undefined;
+} | {
+    config: () => Promise<import("./registry.js").CliCommand>;
+    setup?: undefined;
+    sync?: undefined;
+    status?: undefined;
+    export?: undefined;
+} | {
+    export: () => Promise<import("./registry.js").CliCommand>;
+    setup?: undefined;
+    sync?: undefined;
+    status?: undefined;
+    config?: undefined;
+})[];
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,eAAe,EACf,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,iBAAiB,GACvB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAMvB,CAAA"}

package/dist/commands/index.js

@@ -0,0 +1,22 @@
+/**
+ * CLI commands module
+ *
+ * All available CLI commands.
+ */
+export { CommandRegistry, } from "./registry.js";
+export { setupCommand } from "./setup.js";
+export { syncCommand } from "./sync.js";
+export { statusCommand } from "./status.js";
+export { configCommand } from "./config.js";
+export { exportCommand } from "./export.js";
+/**
+ * All commands to register
+ */
+export const allCommands = [
+    { setup: () => import("./setup.js").then((m) => m.setupCommand) },
+    { sync: () => import("./sync.js").then((m) => m.syncCommand) },
+    { status: () => import("./status.js").then((m) => m.statusCommand) },
+    { config: () => import("./config.js").then((m) => m.configCommand) },
+    { export: () => import("./export.js").then((m) => m.exportCommand) },
+];
+//# sourceMappingURL=index.js.map

package/dist/commands/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,eAAe,GAIhB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE;IACjE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE;IAC9D,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE;IACpE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE;IACpE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,EAAE;CACrE,CAAA"}

package/dist/commands/registry.d.ts

@@ -0,0 +1,62 @@
+/**
+ * CLI command framework
+ *
+ * Base command interface and utilities using Commander.js.
+ */
+import { Command } from "commander";
+import type { CliRuntimeContext } from "../runtime/context.js";
+/**
+ * CLI execution context
+ */
+export interface CliContext {
+    runtime: CliRuntimeContext;
+    program: Command;
+}
+/**
+ * CLI command handler
+ */
+export type CliCommandHandler = (context: CliContext, args?: Record<string, unknown>) => Promise<void> | void;
+/**
+ * CLI command option
+ */
+export interface CliCommandOption {
+    flags: string;
+    description: string;
+    default?: string | boolean | string[];
+}
+/**
+ * CLI command configuration
+ */
+export interface CliCommand {
+    name: string;
+    description: string;
+    aliases?: string[];
+    arguments?: string;
+    options?: CliCommandOption[];
+    handler: CliCommandHandler;
+}
+/**
+ * CLI command registry
+ */
+export declare class CommandRegistry {
+    private commands;
+    private program;
+    constructor(program: Command);
+    /**
+     * Register a command
+     */
+    register(command: CliCommand): void;
+    /**
+     * Get a registered command
+     */
+    get(name: string): CliCommand | undefined;
+    /**
+     * Get all registered commands
+     */
+    getAll(): CliCommand[];
+    /**
+     * Check if a command exists
+     */
+    has(name: string): boolean;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/commands/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/commands/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAE9D;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,iBAAiB,CAAA;IAC1B,OAAO,EAAE,OAAO,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAC9B,OAAO,EAAE,UAAU,EACnB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC3B,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;AAEzB;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,CAAA;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAA;IAC5B,OAAO,EAAE,iBAAiB,CAAA;CAC3B;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAgC;IAChD,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,OAAO;IAI5B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI;IAgDnC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAIzC;;OAEG;IACH,MAAM,IAAI,UAAU,EAAE;IAItB;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAG3B"}