ray-finance 0.2.3 → 0.2.4

package/README.md

@@ -59,10 +59,16 @@ Open Ray and it shows your net worth, spending vs last month, budget pacing, and
 - **Scheduled daily sync** — Automatic bank sync via launchd (macOS) or cron (Linux)
 - **Export/import** — Back up and restore your financial data
 
+## Install
+
+```bash
+npm install -g ray-finance
+```
+
 ## Quick Start
 
 ```bash
-npx ray-finance setup
+ray setup
 ```
 
 The setup wizard offers two modes:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ray-finance",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "Local-first CLI that turns your bank data into a personal AI financial advisor",
   "type": "module",
   "license": "MIT",
@@ -25,6 +25,9 @@
   "engines": {
     "node": ">=18"
   },
+  "files": [
+    "dist/"
+  ],
   "bin": {
     "ray": "./dist/cli/index.js"
   },

package/.claude/settings.local.json

@@ -1,18 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(npm install:*)",
-      "Bash(gh api:*)",
-      "mcp__paper__create_artboard",
-      "mcp__paper__write_html",
-      "mcp__paper__get_screenshot",
-      "mcp__paper__delete_nodes",
-      "Bash(npx next:*)",
-      "Bash(npx tsc:*)",
-      "Bash(git add:*)",
-      "Bash(git commit:*)",
-      "Bash(npm run:*)",
-      "Bash(npm test:*)"
-    ]
-  }
-}

package/.env.example

@@ -1,13 +0,0 @@
-# Anthropic API key for AI chat — https://console.anthropic.com
-ANTHROPIC_API_KEY=
-
-# Plaid credentials for bank sync — https://dashboard.plaid.com
-PLAID_CLIENT_ID=
-PLAID_SECRET=
-PLAID_ENV=production
-
-# Database encryption key (any strong passphrase)
-DB_ENCRYPTION_KEY=
-
-# Separate key for encrypting stored Plaid access tokens (any strong passphrase)
-PLAID_TOKEN_SECRET=

package/.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,19 +0,0 @@
----
-name: Bug Report
-about: Report a bug
-labels: bug
----
-
-**What happened?**
-
-**What did you expect?**
-
-**Steps to reproduce**
-1.
-2.
-3.
-
-**Environment**
-- OS:
-- Node.js version:
-- Ray version (`ray --version`):

package/.github/ISSUE_TEMPLATE/feature_request.md

@@ -1,9 +0,0 @@
----
-name: Feature Request
-about: Suggest a feature
-labels: enhancement
----
-
-**What problem does this solve?**
-
-**Describe the solution you'd like**

package/.github/PULL_REQUEST_TEMPLATE.md

@@ -1,5 +0,0 @@
-## What
-
-## Why
-
-## Test plan

package/.github/workflows/ci.yml

@@ -1,22 +0,0 @@
-name: CI
-
-on:
-  push:
-    branches: [main]
-  pull_request:
-    branches: [main]
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        node-version: [18, 20, 22]
-    steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
-        with:
-          node-version: ${{ matrix.node-version }}
-      - run: npm install
-      - run: npm run build
-      - run: npm test

package/CHANGELOG.md

@@ -1,16 +0,0 @@
-# Changelog
-
-## 0.2.0
-
-Initial open source release.
-
-- CLI interface with 13 commands (`ray`, `setup`, `sync`, `link`, `status`, `transactions`, `spending`, `budgets`, `goals`, `score`, `alerts`, `export`, `import`)
-- AI financial advisor powered by Claude with 13+ tools
-- Plaid integration for bank sync (checking, savings, credit cards, investments, loans)
-- Encrypted local SQLite database (AES-256)
-- Daily financial scoring (0-100) with streaks and 14 achievements
-- Budget tracking with overage alerts
-- Financial goal tracking
-- Transaction auto-recategorization via user-defined rules
-- Conversation memory and persistent financial context
-- Data export/import for backup and restore

package/CODE_OF_CONDUCT.md

@@ -1,31 +0,0 @@
-# Code of Conduct
-
-## Our Pledge
-
-We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, caste, color, religion, or sexual identity and orientation.
-
-## Our Standards
-
-Examples of behavior that contributes to a positive environment:
-
-- Being respectful of differing viewpoints and experiences
-- Giving and gracefully accepting constructive feedback
-- Focusing on what is best for the community
-- Showing empathy towards other community members
-
-Examples of unacceptable behavior:
-
-- Trolling, insulting/derogatory comments, and personal or political attacks
-- Public or private harassment
-- Publishing others' private information without explicit permission
-- Other conduct which could reasonably be considered inappropriate in a professional setting
-
-## Enforcement
-
-Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the project maintainer at clark@rayfinance.app.
-
-All complaints will be reviewed and investigated and will result in a response that is deemed necessary and appropriate to the circumstances.
-
-## Attribution
-
-This Code of Conduct is adapted from the [Contributor Covenant](https://www.contributor-covenant.org), version 2.1.

package/CONTRIBUTING.md

@@ -1,41 +0,0 @@
-# Contributing
-
-Thanks for your interest in contributing to Ray.
-
-## Development Setup
-
-```bash
-git clone https://github.com/cdinnison/ray-finance.git
-cd ray-finance
-npm install
-npm run build
-npm link
-```
-
-You'll need Plaid and Anthropic API keys to test. Copy `.env.example` to `.env` and fill in your credentials.
-
-## Making Changes
-
-1. Fork the repo and create a branch from `main`
-2. Make your changes
-3. Run `npm run build` to verify the project compiles
-4. Open a pull request
-
-## Code Style
-
-- TypeScript with strict mode
-- ES modules (`"type": "module"`)
-- Prefer simple, direct code over abstractions
-- No unnecessary dependencies
-
-## Reporting Bugs
-
-Open a GitHub issue with:
-- What you expected to happen
-- What actually happened
-- Steps to reproduce
-- Your Node.js version and OS
-
-## Security Issues
-
-See [SECURITY.md](SECURITY.md) for reporting security vulnerabilities. Do not open public issues for security bugs.

package/Dockerfile

@@ -1,8 +0,0 @@
-FROM node:20-slim
-WORKDIR /app
-COPY package*.json ./
-RUN npm ci --production
-COPY dist/ ./dist/
-COPY src/public/ ./dist/public/
-EXPOSE 9876
-CMD ["node", "dist/cli/index.js"]

package/SECURITY.md

@@ -1,36 +0,0 @@
-# Security
-
-## Architecture
-
-Ray is local-first. All financial data is stored on your machine in an encrypted SQLite database. No data is sent to Ray servers because there are no Ray servers.
-
-### Encryption
-
-- **Database encryption**: The SQLite database is encrypted at rest using AES-256 via [SQLCipher](https://www.zetetic.net/sqlcipher/) (better-sqlite3-multiple-ciphers). The encryption key is provided during setup and stored in your local config.
-- **Plaid token encryption**: Plaid access tokens are encrypted separately using AES-256-GCM with scrypt key derivation before being stored in the database.
-- **File permissions**: Config and database files are created with `0600` permissions (owner read/write only).
-
-### Data Flow
-
-Ray makes outbound API calls to two services:
-
-| Service | Purpose | When |
-|---------|---------|------|
-| Plaid | Sync bank transactions and balances | `ray sync`, `ray link` |
-| Anthropic | AI-powered chat responses | `ray` (interactive chat) |
-
-No telemetry, analytics, or usage data is collected or transmitted.
-
-### PII Handling
-
-When sending data to the Anthropic API for AI chat, Ray redacts personally identifiable information (account numbers, routing numbers) before transmission and restores it in the response for display.
-
-## Reporting a Vulnerability
-
-If you discover a security vulnerability, please report it responsibly:
-
-1. **Do not** open a public GitHub issue
-2. Email **clark@rayfinance.app** with details
-3. Include steps to reproduce if possible
-
-I will respond within 48 hours and work with you to address the issue before any public disclosure.

package/docker-compose.yml

@@ -1,9 +0,0 @@
-services:
-  ray:
-    build: .
-    env_file: .env
-    volumes:
-      - ./data:/app/data
-    ports:
-      - "3000:3000"
-    restart: unless-stopped

package/site/next-env.d.ts

@@ -1,6 +0,0 @@
-/// <reference types="next" />
-/// <reference types="next/image-types/global" />
-/// <reference path="./.next/types/routes.d.ts" />
-
-// NOTE: This file should not be edited
-// see https://nextjs.org/docs/app/api-reference/config/typescript for more information.

package/site/next.config.ts

@@ -1,7 +0,0 @@
-import type { NextConfig } from "next";
-
-const nextConfig: NextConfig = {
-  output: "export",
-};
-
-export default nextConfig;