ray-finance 0.1.0

package/dist/cli/commands.js

@@ -0,0 +1,201 @@
+import chalk from "chalk";
+import { getDb } from "../db/connection.js";
+import { getNetWorth, getTransactionsFiltered, getBudgetStatuses, getGoals, getCashFlowThisMonth, formatMoney as rawFormatMoney, categoryLabel, } from "../queries/index.js";
+import { getLatestScore, getAchievements, getMonthlySavings } from "../scoring/index.js";
+import { generateAlerts } from "../alerts/index.js";
+import { runDailySync } from "../daily-sync.js";
+import { startLinkServer } from "../server.js";
+import { heading, progressBar, formatMoney, formatMoneyColored, dim } from "./format.js";
+export async function runSync() {
+    const ora = (await import("ora")).default;
+    const spinner = ora("Syncing transactions...").start();
+    try {
+        const db = getDb();
+        await runDailySync(db);
+        spinner.succeed("Sync complete.");
+    }
+    catch (err) {
+        spinner.fail(`Sync failed: ${err.message}`);
+    }
+}
+export async function runLink() {
+    const open = (await import("open")).default;
+    const ora = (await import("ora")).default;
+    const { url, waitForComplete, stop } = startLinkServer();
+    console.log(`\n${heading("Link Account")}\n`);
+    console.log(`Opening Plaid Link in your browser...\n`);
+    console.log(dim(`  ${url}\n`));
+    await open(url);
+    const spinner = ora("Waiting for bank connection...").start();
+    await waitForComplete();
+    stop();
+    spinner.succeed("Bank account linked successfully!");
+}
+export function showStatus() {
+    const db = getDb();
+    const nw = getNetWorth(db);
+    const cashFlow = getCashFlowThisMonth(db);
+    const score = getLatestScore(db);
+    const savings = getMonthlySavings(db);
+    const alerts = generateAlerts(db);
+    console.log(`\n${heading("Financial Overview")}\n`);
+    // Net worth
+    const change = nw.prev_net_worth !== null ? nw.net_worth - nw.prev_net_worth : null;
+    let nwLine = `Net worth: ${chalk.bold(formatMoney(nw.net_worth))}`;
+    if (change !== null) {
+        nwLine += `  ${change >= 0 ? chalk.green("+" + rawFormatMoney(change)) : chalk.red(rawFormatMoney(change))} from yesterday`;
+    }
+    console.log(nwLine);
+    console.log(dim(`  Assets: ${rawFormatMoney(nw.assets)}  Liabilities: ${rawFormatMoney(nw.liabilities)}`));
+    if (nw.investments > 0)
+        console.log(dim(`  Investments: ${rawFormatMoney(nw.investments)}  Cash: ${rawFormatMoney(nw.cash)}`));
+    // Cash flow
+    console.log(`\n${heading("This Month")}`);
+    console.log(`  Income: ${formatMoneyColored(cashFlow.income)}  Expenses: ${formatMoney(cashFlow.expenses)}  Net: ${formatMoneyColored(cashFlow.net)}`);
+    if (savings.baselineMonth) {
+        const savingsColor = savings.saved >= 0 ? chalk.green : chalk.red;
+        console.log(`  vs ${savings.baselineMonth}: ${savingsColor((savings.saved >= 0 ? "+" : "") + rawFormatMoney(savings.saved))}`);
+    }
+    // Score
+    if (score) {
+        console.log(`\n${heading("Daily Score")}`);
+        console.log(`  ${chalk.bold(String(score.score))}/100  ${progressBar(score.score)}`);
+        console.log(dim(`  Streaks: ${score.no_restaurant_streak}d no restaurants | ${score.no_shopping_streak}d no shopping | ${score.on_pace_streak}d on pace`));
+    }
+    // Budgets (brief)
+    const budgets = getBudgetStatuses(db);
+    if (budgets.length > 0) {
+        console.log(`\n${heading("Budgets")}`);
+        for (const b of budgets) {
+            const status = b.over_budget ? chalk.red("OVER") : `${b.pct_used}%`;
+            console.log(`  ${b.over_budget ? chalk.red("!") : "•"} ${categoryLabel(b.category)}: ${rawFormatMoney(b.spent)} / ${rawFormatMoney(b.budget)} (${status})`);
+        }
+    }
+    // Alerts
+    if (alerts.length > 0) {
+        console.log(`\n${heading("Alerts")}`);
+        for (const a of alerts) {
+            const icon = a.severity === "critical" ? chalk.red("●") : a.severity === "warning" ? chalk.yellow("●") : chalk.blue("●");
+            console.log(`  ${icon} ${a.message}`);
+        }
+    }
+    console.log();
+}
+export function showTransactions(options = {}) {
+    const db = getDb();
+    const txns = getTransactionsFiltered(db, {
+        limit: options.limit || 20,
+        category: options.category,
+        merchant: options.merchant,
+    });
+    if (txns.length === 0) {
+        console.log("\nNo transactions found.");
+        return;
+    }
+    console.log(`\n${heading("Recent Transactions")}\n`);
+    for (const t of txns) {
+        const amount = t.amount > 0 ? chalk.red(rawFormatMoney(t.amount)) : chalk.green(rawFormatMoney(Math.abs(t.amount)));
+        const merchant = t.merchant_name || t.name;
+        console.log(`  ${dim(t.date)}  ${amount.padEnd(22)}  ${merchant}  ${dim(categoryLabel(t.category))}`);
+    }
+    console.log();
+}
+export async function showSpending(period = "this_month") {
+    const db = getDb();
+    const { resolvePeriod } = await import("../db/helpers.js");
+    const { start, end } = resolvePeriod(period);
+    const rows = db.prepare(`SELECT category, SUM(amount) as total, COUNT(*) as count FROM transactions
+     WHERE amount > 0 AND date BETWEEN ? AND ? AND pending = 0
+     AND category NOT IN ('TRANSFER_OUT', 'TRANSFER_IN', 'LOAN_PAYMENTS')
+     GROUP BY category ORDER BY total DESC`).all(start, end);
+    if (rows.length === 0) {
+        console.log("\nNo spending found for that period.");
+        return;
+    }
+    const grandTotal = rows.reduce((s, r) => s + r.total, 0);
+    console.log(`\n${heading("Spending")} ${dim(`${start} to ${end}`)}`);
+    console.log(`  Total: ${chalk.bold(rawFormatMoney(grandTotal))}\n`);
+    for (const r of rows) {
+        const pct = Math.round((r.total / grandTotal) * 100);
+        console.log(`  ${categoryLabel(r.category).padEnd(20)} ${rawFormatMoney(r.total).padStart(10)}  ${progressBar(pct, 15)}  ${dim(`${r.count} txns`)}`);
+    }
+    console.log();
+}
+export function showBudgets() {
+    const db = getDb();
+    const budgets = getBudgetStatuses(db);
+    if (budgets.length === 0) {
+        console.log("\nNo budgets set up. Use the chat to create budgets (e.g., 'set a budget for food at $500').");
+        return;
+    }
+    const now = new Date();
+    const daysInMonth = new Date(now.getFullYear(), now.getMonth() + 1, 0).getDate();
+    const monthPct = Math.round((now.getDate() / daysInMonth) * 100);
+    console.log(`\n${heading("Budgets")} ${dim(`${monthPct}% through the month`)}\n`);
+    for (const b of budgets) {
+        const label = categoryLabel(b.category).padEnd(20);
+        const spent = rawFormatMoney(b.spent).padStart(10);
+        const limit = rawFormatMoney(b.budget);
+        const bar = progressBar(b.pct_used, 15);
+        const over = b.over_budget ? chalk.red(` ${rawFormatMoney(Math.abs(b.remaining))} over`) : "";
+        console.log(`  ${label} ${spent} / ${limit}  ${bar}${over}`);
+    }
+    console.log();
+}
+export function showGoals() {
+    const db = getDb();
+    const goals = getGoals(db);
+    if (goals.length === 0) {
+        console.log("\nNo goals set up. Use the chat to create goals (e.g., 'set a goal for emergency fund at $10000').");
+        return;
+    }
+    console.log(`\n${heading("Goals")}\n`);
+    for (const g of goals) {
+        console.log(`  ${chalk.bold(g.name)}`);
+        console.log(`    ${rawFormatMoney(g.current)} / ${rawFormatMoney(g.target)}  ${progressBar(g.progress_pct, 20)}`);
+        if (g.target_date)
+            console.log(dim(`    Target: ${g.target_date}`));
+        if (g.monthly_needed > 0)
+            console.log(dim(`    Need: ${rawFormatMoney(g.monthly_needed)}/mo`));
+    }
+    console.log();
+}
+export function showScore() {
+    const db = getDb();
+    const score = getLatestScore(db);
+    const achievements = getAchievements(db);
+    if (!score) {
+        console.log("\nNo daily scores yet. Run 'ray sync' first.");
+        return;
+    }
+    console.log(`\n${heading("Daily Score")} ${dim(score.date)}\n`);
+    console.log(`  Score: ${chalk.bold(String(score.score))}/100  ${progressBar(score.score, 25)}`);
+    console.log(`  Spend: ${rawFormatMoney(score.total_spend)}${score.zero_spend ? chalk.green("  Zero-spend day!") : ""}`);
+    console.log(`  Restaurants: ${score.restaurant_count}  Shopping: ${score.shopping_count}`);
+    console.log();
+    console.log(`  ${heading("Streaks")}`);
+    console.log(`    No restaurants: ${chalk.bold(String(score.no_restaurant_streak))} days`);
+    console.log(`    No shopping:    ${chalk.bold(String(score.no_shopping_streak))} days`);
+    console.log(`    On pace:        ${chalk.bold(String(score.on_pace_streak))} days`);
+    if (achievements.length > 0) {
+        console.log(`\n  ${heading("Achievements")}`);
+        for (const a of achievements) {
+            console.log(`    🏆 ${chalk.bold(a.name)} — ${a.description}`);
+        }
+    }
+    console.log();
+}
+export function showAlerts() {
+    const db = getDb();
+    const alerts = generateAlerts(db);
+    if (alerts.length === 0) {
+        console.log("\nNo active alerts. Everything looks good!");
+        return;
+    }
+    console.log(`\n${heading("Alerts")}\n`);
+    for (const a of alerts) {
+        const icon = a.severity === "critical" ? chalk.red("●") : a.severity === "warning" ? chalk.yellow("●") : chalk.blue("●");
+        console.log(`  ${icon} ${a.message}`);
+    }
+    console.log();
+}

package/dist/cli/format.d.ts

@@ -0,0 +1,14 @@
+export declare function formatMoney(n: number): string;
+export declare function formatMoneyColored(n: number, invert?: boolean): string;
+export declare function progressBar(pct: number, width?: number): string;
+export declare function heading(text: string): string;
+export declare function dim(text: string): string;
+export declare function padColumns(rows: [string, string][], gap?: number): string;
+export declare function banner(): string;
+export declare function helpScreen(commands: {
+    name: string;
+    desc: string;
+}[]): string;
+/** Colorize AI response text for the terminal */
+export declare function formatResponse(text: string): string;
+export declare const DISCLAIMER: string;

package/dist/cli/format.js

@@ -0,0 +1,144 @@
+import chalk from "chalk";
+export function formatMoney(n) {
+    const abs = Math.abs(n);
+    const formatted = "$" + abs.toLocaleString("en-US", { minimumFractionDigits: 2, maximumFractionDigits: 2 });
+    if (n < 0)
+        return chalk.red("-" + formatted);
+    return formatted;
+}
+export function formatMoneyColored(n, invert = false) {
+    const formatted = formatMoney(n);
+    if (invert)
+        return n <= 0 ? chalk.green(formatted) : chalk.red(formatted);
+    return n >= 0 ? chalk.green(formatted) : chalk.red(formatted);
+}
+export function progressBar(pct, width = 20) {
+    const clamped = Math.max(0, Math.min(100, pct));
+    const filled = Math.round((clamped / 100) * width);
+    const empty = width - filled;
+    const color = pct > 100 ? chalk.red : pct > 80 ? chalk.yellow : chalk.green;
+    return color("█".repeat(filled)) + chalk.gray("░".repeat(empty)) + ` ${Math.round(pct)}%`;
+}
+export function heading(text) {
+    return chalk.bold.underline(text);
+}
+export function dim(text) {
+    return chalk.dim(text);
+}
+export function padColumns(rows, gap = 2) {
+    const maxLeft = Math.max(...rows.map(r => stripAnsi(r[0]).length));
+    return rows.map(([left, right]) => {
+        const pad = maxLeft - stripAnsi(left).length + gap;
+        return left + " ".repeat(pad) + right;
+    }).join("\n");
+}
+// Strip ANSI escape codes for length calculation
+function stripAnsi(str) {
+    return str.replace(/\x1b\[[0-9;]*m/g, "");
+}
+// ─── CLI Banner ─── //
+const BLOCK_CHARS = "░▒▓█";
+function noiseRow(width, seed) {
+    let row = "";
+    for (let i = 0; i < width; i++) {
+        const v = Math.abs(Math.sin(seed * 9301 + i * 4973 + 1997)) * BLOCK_CHARS.length;
+        row += BLOCK_CHARS[Math.min(Math.floor(v), BLOCK_CHARS.length - 1)];
+    }
+    return row;
+}
+const LOGO_LINES = [
+    "▌▙▀▖▝▀▖▌ ▌▐",
+    "▌▌  ▞▀▌▝▀▌▐",
+    "▌▘  ▝▀▘▗▄▘▐",
+];
+function blendLogoRow(noise, logoLine, offset) {
+    const chars = noise.split("");
+    for (let i = 0; i < logoLine.length; i++) {
+        chars[offset + i] = logoLine[i];
+    }
+    return chars.join("");
+}
+function box(label, lines) {
+    const cols = process.stdout.columns || 100;
+    const inner = cols - 4;
+    const top = `┌─── ${label} ${"─".repeat(Math.max(0, inner - label.length - 5))}┐`;
+    const bot = `└${"─".repeat(inner + 2)}┘`;
+    const pad = `│${" ".repeat(inner + 2)}│`;
+    const body = lines.map((l) => {
+        const vis = stripAnsi(l).length;
+        return `│  ${l}${" ".repeat(Math.max(0, inner - vis))}│`;
+    });
+    return [top, pad, ...body, pad, bot].join("\n");
+}
+export function banner() {
+    const cols = process.stdout.columns || 100;
+    const width = Math.min(cols, 120);
+    // Generate noise rows with logo blended in
+    const logoWidth = LOGO_LINES[0].length;
+    const logoOffset = 1; // left-aligned with small indent
+    const headerLines = [];
+    // 1 noise row above logo
+    headerLines.push(chalk.dim(noiseRow(width, 0)));
+    // 3 rows with logo blended
+    for (let i = 0; i < LOGO_LINES.length; i++) {
+        const noise = noiseRow(width, i + 1);
+        const blended = blendLogoRow(noise, LOGO_LINES[i], logoOffset);
+        // Color the logo portion bold white, rest dim
+        const before = chalk.dim(blended.slice(0, logoOffset));
+        const logoLine = LOGO_LINES[i];
+        const logo = chalk.black(logoLine[0]) + chalk.bold.white(logoLine.slice(1, -1)) + chalk.black(logoLine[logoLine.length - 1]);
+        const after = chalk.dim(blended.slice(logoOffset + logoWidth));
+        headerLines.push(before + logo + after);
+    }
+    // 1 noise row below logo
+    headerLines.push(chalk.dim(noiseRow(width, LOGO_LINES.length + 1)));
+    return headerLines.join("\n");
+}
+export function helpScreen(commands) {
+    const sections = [];
+    sections.push(banner());
+    sections.push("");
+    sections.push(box("Usage", [
+        "ray <command> [OPTIONS]",
+        "ray                       Start chat session",
+    ]));
+    sections.push("");
+    const nameWidth = Math.max(...commands.map((c) => c.name.length));
+    const cmdLines = commands.map((c) => `${chalk.white(c.name.padEnd(nameWidth))}    ${chalk.dim(c.desc)}`);
+    sections.push(box("Commands", cmdLines));
+    sections.push("");
+    sections.push(box("Options", [
+        `${chalk.white("--version".padEnd(nameWidth))}    ${chalk.dim("Show the version and exit")}`,
+        `${chalk.white("--help".padEnd(nameWidth))}    ${chalk.dim("Show this help screen")}`,
+    ]));
+    sections.push("");
+    sections.push(chalk.dim(DISCLAIMER));
+    return sections.join("\n");
+}
+/** Colorize AI response text for the terminal */
+export function formatResponse(text) {
+    return text
+        .split("\n")
+        .map((line) => {
+        // Section headers: ## Header or ### Header
+        if (/^#{1,3}\s+/.test(line)) {
+            return chalk.bold(line.replace(/^#{1,3}\s+/, ""));
+        }
+        // Bold: **text**
+        line = line.replace(/\*\*(.+?)\*\*/g, (_, t) => chalk.bold(t));
+        // Money amounts: $1,234 or $1,234.56 or -$500
+        line = line.replace(/-?\$[\d,]+(?:\.\d{1,2})?/g, (m) => {
+            return m.startsWith("-") ? chalk.red(m) : chalk.green(m);
+        });
+        // Percentages
+        line = line.replace(/(\d+(?:\.\d+)?%)/g, (m) => chalk.yellow(m));
+        // Bullet points
+        if (/^\s*[-•]\s/.test(line)) {
+            line = line.replace(/^(\s*)([-•])(\s)/, (_, sp, b, s) => sp + chalk.dim(b) + s);
+        }
+        return line;
+    })
+        .join("\n");
+}
+export const DISCLAIMER = "Ray is an AI tool, not a licensed financial advisor. Output is informational, " +
+    "may be inaccurate, and does not constitute financial advice.";

package/dist/cli/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli/index.js

@@ -0,0 +1,186 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { createRequire } from "module";
+import { config, isConfigured, useManaged, RAY_PROXY_BASE } from "../config.js";
+import { helpScreen } from "./format.js";
+const require = createRequire(import.meta.url);
+const { version } = require("../../package.json");
+const program = new Command();
+program
+    .name("ray")
+    .description("Personal finance AI assistant")
+    .version(version)
+    .addHelpCommand(false)
+    .action(async () => {
+    if (!isConfigured()) {
+        console.log("Ray is not configured yet. Running setup...\n");
+        const { runSetup } = await import("./setup.js");
+        await runSetup();
+        return;
+    }
+    const { startChat } = await import("./chat.js");
+    await startChat();
+});
+program
+    .command("setup")
+    .description("Configure Ray (API keys, preferences)")
+    .action(async () => {
+    const { runSetup } = await import("./setup.js");
+    await runSetup();
+});
+program
+    .command("sync")
+    .description("Sync transactions from linked banks")
+    .action(async () => {
+    ensureConfigured();
+    const { runSync } = await import("./commands.js");
+    await runSync();
+});
+program
+    .command("link")
+    .description("Link a new financial account via Plaid")
+    .action(async () => {
+    ensureConfigured();
+    if (!useManaged() && (!config.plaidClientId || !config.plaidSecret)) {
+        console.error("Plaid credentials not configured. Run 'ray setup' to add them, or use a Ray API key for easy setup.");
+        process.exit(1);
+    }
+    const { runLink } = await import("./commands.js");
+    await runLink();
+});
+program
+    .command("status")
+    .description("Show financial overview")
+    .action(async () => {
+    ensureConfigured();
+    const { showStatus } = await import("./commands.js");
+    showStatus();
+});
+program
+    .command("transactions")
+    .description("Show recent transactions")
+    .option("-n, --limit <number>", "Number of transactions", "20")
+    .option("-c, --category <category>", "Filter by category")
+    .option("-m, --merchant <name>", "Filter by merchant")
+    .action(async (opts) => {
+    ensureConfigured();
+    const { showTransactions } = await import("./commands.js");
+    showTransactions({ limit: Number(opts.limit), category: opts.category, merchant: opts.merchant });
+});
+program
+    .command("spending")
+    .description("Show spending breakdown")
+    .argument("[period]", "Period: this_month, last_month, last_30, last_90", "this_month")
+    .action(async (period) => {
+    ensureConfigured();
+    const { showSpending } = await import("./commands.js");
+    await showSpending(period);
+});
+program
+    .command("budgets")
+    .description("Show budget statuses")
+    .action(async () => {
+    ensureConfigured();
+    const { showBudgets } = await import("./commands.js");
+    showBudgets();
+});
+program
+    .command("goals")
+    .description("Show financial goals")
+    .action(async () => {
+    ensureConfigured();
+    const { showGoals } = await import("./commands.js");
+    showGoals();
+});
+program
+    .command("score")
+    .description("Show daily financial score and streaks")
+    .action(async () => {
+    ensureConfigured();
+    const { showScore } = await import("./commands.js");
+    showScore();
+});
+program
+    .command("alerts")
+    .description("Show financial alerts")
+    .action(async () => {
+    ensureConfigured();
+    const { showAlerts } = await import("./commands.js");
+    showAlerts();
+});
+program
+    .command("export")
+    .description("Export user data (goals, budgets, memories, context) to a backup file")
+    .argument("[path]", "Output file path", undefined)
+    .action(async (path) => {
+    ensureConfigured();
+    const { runExport } = await import("./backup.js");
+    runExport(path);
+});
+program
+    .command("import")
+    .description("Restore user data from a backup file")
+    .argument("<path>", "Backup file path")
+    .action(async (path) => {
+    ensureConfigured();
+    const { runImport } = await import("./backup.js");
+    runImport(path);
+});
+program
+    .command("billing")
+    .description("Manage your Ray subscription")
+    .action(async () => {
+    ensureConfigured();
+    if (!useManaged()) {
+        console.log("You're using self-hosted keys. No subscription to manage.");
+        return;
+    }
+    const open = (await import("open")).default;
+    console.log("Opening billing portal...");
+    try {
+        const resp = await fetch(`${RAY_PROXY_BASE.replace("/v1", "")}/stripe/portal`, {
+            method: "POST",
+            headers: {
+                "content-type": "application/json",
+                "Authorization": `Bearer ${config.rayApiKey}`,
+            },
+        });
+        const { url } = await resp.json();
+        // Only open URLs from trusted domains
+        const parsed = new URL(url);
+        if (!parsed.hostname.endsWith("stripe.com") && !parsed.hostname.endsWith("rayfinance.app")) {
+            console.error("Unexpected billing URL. Visit https://rayfinance.app/billing");
+        }
+        else {
+            await open(url);
+        }
+    }
+    catch {
+        console.error("Could not open billing portal. Visit https://rayfinance.app/billing");
+    }
+});
+function ensureConfigured() {
+    if (!isConfigured()) {
+        console.error("Ray is not configured. Run 'ray setup' first.");
+        process.exit(1);
+    }
+}
+// Custom help screen
+program.configureHelp({
+    formatHelp: () => helpScreen([
+        { name: "setup", desc: "Configure Ray (API keys, preferences)" },
+        { name: "link", desc: "Link a new financial account via Plaid" },
+        { name: "sync", desc: "Sync transactions from linked banks" },
+        { name: "status", desc: "Show financial overview" },
+        { name: "transactions", desc: "Show recent transactions" },
+        { name: "spending", desc: "Show spending breakdown" },
+        { name: "budgets", desc: "Show budget statuses" },
+        { name: "goals", desc: "Show financial goals" },
+        { name: "score", desc: "Show daily financial score and streaks" },
+        { name: "alerts", desc: "Show financial alerts" },
+        { name: "export", desc: "Export data to a backup file" },
+        { name: "import", desc: "Restore data from a backup file" },
+        { name: "billing", desc: "Manage your Ray subscription" },
+    ]),
+});
+program.parse();

package/dist/cli/scheduler.d.ts

@@ -0,0 +1,2 @@
+export declare function installSyncSchedule(time: string): void;
+export declare function uninstallSyncSchedule(): void;

package/dist/cli/scheduler.js

@@ -0,0 +1,114 @@
+import { platform } from "os";
+import { resolve, dirname } from "path";
+import { existsSync, writeFileSync, unlinkSync, mkdirSync } from "fs";
+import { execSync } from "child_process";
+import { homedir } from "os";
+const PLIST_LABEL = "com.ray-finance.daily-sync";
+function getPlistPath() {
+    return resolve(homedir(), "Library", "LaunchAgents", `${PLIST_LABEL}.plist`);
+}
+function getRayBin() {
+    // Use the installed `ray` binary if available, otherwise fall back to npx
+    try {
+        return execSync("which ray", { encoding: "utf-8" }).trim();
+    }
+    catch {
+        return resolve(dirname(process.execPath), "npx");
+    }
+}
+function installLaunchd(hour, minute) {
+    const rayBin = getRayBin();
+    const plist = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+\t<key>Label</key>
+\t<string>${PLIST_LABEL}</string>
+\t<key>ProgramArguments</key>
+\t<array>
+\t\t<string>${rayBin}</string>
+\t\t<string>sync</string>
+\t</array>
+\t<key>StartCalendarInterval</key>
+\t<dict>
+\t\t<key>Hour</key>
+\t\t<integer>${hour}</integer>
+\t\t<key>Minute</key>
+\t\t<integer>${minute}</integer>
+\t</dict>
+\t<key>StandardOutPath</key>
+\t<string>${resolve(homedir(), ".ray", "sync.log")}</string>
+\t<key>StandardErrorPath</key>
+\t<string>${resolve(homedir(), ".ray", "sync.log")}</string>
+</dict>
+</plist>`;
+    const plistPath = getPlistPath();
+    const dir = dirname(plistPath);
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    // Unload existing if present
+    if (existsSync(plistPath)) {
+        try {
+            execSync(`launchctl unload "${plistPath}" 2>/dev/null`);
+        }
+        catch { }
+    }
+    writeFileSync(plistPath, plist);
+    execSync(`launchctl load "${plistPath}"`);
+}
+function uninstallLaunchd() {
+    const plistPath = getPlistPath();
+    if (existsSync(plistPath)) {
+        try {
+            execSync(`launchctl unload "${plistPath}" 2>/dev/null`);
+        }
+        catch { }
+        unlinkSync(plistPath);
+    }
+}
+const CRON_MARKER = "# ray-finance daily sync";
+function installCron(hour, minute) {
+    const rayBin = getRayBin();
+    const cronLine = `${minute} ${hour} * * * ${rayBin} sync >> ${resolve(homedir(), ".ray", "sync.log")} 2>&1 ${CRON_MARKER}`;
+    // Remove existing ray cron entry, add new one
+    try {
+        const existing = execSync("crontab -l 2>/dev/null", { encoding: "utf-8" });
+        const filtered = existing.split("\n").filter(l => !l.includes(CRON_MARKER)).join("\n");
+        const updated = filtered.trimEnd() + "\n" + cronLine + "\n";
+        execSync(`echo ${JSON.stringify(updated)} | crontab -`);
+    }
+    catch {
+        // No existing crontab
+        execSync(`echo ${JSON.stringify(cronLine + "\n")} | crontab -`);
+    }
+}
+function uninstallCron() {
+    try {
+        const existing = execSync("crontab -l 2>/dev/null", { encoding: "utf-8" });
+        const filtered = existing.split("\n").filter(l => !l.includes(CRON_MARKER)).join("\n").trimEnd();
+        if (filtered) {
+            execSync(`echo ${JSON.stringify(filtered + "\n")} | crontab -`);
+        }
+        else {
+            execSync("crontab -r 2>/dev/null");
+        }
+    }
+    catch { }
+}
+export function installSyncSchedule(time) {
+    const [hour, minute] = time.split(":").map(Number);
+    if (platform() === "darwin") {
+        installLaunchd(hour, minute);
+    }
+    else {
+        installCron(hour, minute);
+    }
+}
+export function uninstallSyncSchedule() {
+    if (platform() === "darwin") {
+        uninstallLaunchd();
+    }
+    else {
+        uninstallCron();
+    }
+}

package/dist/cli/setup.d.ts

@@ -0,0 +1 @@
+export declare function runSetup(): Promise<void>;