Tokens get a level (migration 0034). Summary stays the default; Full detail is the person's explicit choice on Connect your AI, with a confirmation, and is written into CLAUDE.md as the one exception to summary-only cloud AI. Full tokens get the full tools plus list_transactions, update_transactions and mark_transfer_pair; IBANs and long account numbers are shortened in everything they return (ids stay intact). Isolation tested with two users and an accepted partner share: RLS alone lets the partner read the owner's shared rows, but every tool also filters on the token's user, so nothing leaked and no change landed (own ids, rule id, names). Also fixes the full spending_summary crashing on rows without a category. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
26 lines
1.9 KiB
Markdown
26 lines
1.9 KiB
Markdown
# broke
|
|
|
|
Personal finance app. Next.js 15 (app router), Supabase (sign-in, Postgres, row-level security), Plaid and other bank feeds.
|
|
|
|
## Rules for any change
|
|
|
|
- **Bank data stays private.** Every AI path goes through `src/lib/llm/gate.ts`. A cloud model gets the summary only: rounded amounts, names replaced by tokens. Full detail goes only to a local model. Never add another path.
|
|
- One exception, the person's own explicit choice: an MCP token made with "Full detail" on Connect your AI (`src/app/api/mcp`, migration 0034). Summary stays the default, IBANs and account numbers stay shortened, and a token only ever reaches its own user's rows (their session, plus a `user_id` filter in every tool, so a partner's shared accounts never show).
|
|
- **No AI API keys.** AI runs on the person's own signed-in app (Claude Code, Codex, Gemini CLI, opencode), a local model, or their OpenRouter sign-in.
|
|
- **Tools stay off for prompts from a website.** The helper (`public/broke-connect.cjs`) only runs AI apps with no tools at all. Don't add one that can read files.
|
|
- **Every table has row-level security.** Secrets like `plaid_items.access_token` have no policies, so only the server's secret key reads them.
|
|
- **Advice depends on country.** Use `countryOf` and the tax modules in `src/lib/countries.ts`. Never assume the US.
|
|
- **Never show test data to someone on real banks.**
|
|
- **Tests use throwaway `@broke.test` users**, created and deleted with the admin client. Never read a real person's rows to test.
|
|
|
|
## Writing
|
|
|
|
Sentence case. Plain short sentences. No em dashes.
|
|
|
|
## Working here
|
|
|
|
- `npm run dev`: reloads on every edit. Keys go in on http://localhost:3000/setup.
|
|
- Database changes: add the next numbered file in `supabase/migrations/`. It applies on start, or with `npm run migrate`.
|
|
- Checks: `npm run lint`, `npx tsc --noEmit`, and pure libraries with `node src/lib/<name>.test.ts`.
|
|
- `scripts/e2e-sandbox.mjs` runs a throwaway user through every page.
|