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>
1.9 KiB
1.9 KiB
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 auser_idfilter in every tool, so a partner's shared accounts never show).
- One exception, the person's own explicit choice: an MCP token made with "Full detail" on Connect your AI (
- 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_tokenhave no policies, so only the server's secret key reads them. - Advice depends on country. Use
countryOfand the tax modules insrc/lib/countries.ts. Never assume the US. - Never show test data to someone on real banks.
- Tests use throwaway
@broke.testusers, 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 withnpm run migrate. - Checks:
npm run lint,npx tsc --noEmit, and pure libraries withnode src/lib/<name>.test.ts. scripts/e2e-sandbox.mjsruns a throwaway user through every page.