contributing

## 1. Overview Contributor guide for the Butterbase monorepo. Covers architecture, how to add MCP tools, API routes, database migrations, and coding conventions. --- ## 2. Monorepo Map | Directory | Package | Purpose | |-----------|---------|---------| | `packages/cli` | `@butterbase/cli` (v0.1.3) | Published CLI tool (Commander.js). Commands: init, apps, schema, functions, storage, deploy, data, env, keys, realtime, status, open | | `packages/sdk` | `@butterbase/sdk` (v1.2.1) | Published TypeScript SDK. Modules: auth, storage, functions, AI, billing, realtime, admin | | `packages/shared` | `@butterbase/shared` | Internal shared types, constants, schema DSL, error types | | `packages/plugin` | `@butterbase/plugin` | Claude Code plugin (this package — skills for AI agents) | | `services/control-api` | `@butterbase/control-api` | Fastify API server — the brain. Routes, plugins, services. Port 4000 | | `services/mcp-server` | `@butterbase/mcp-server` | MCP server with ~28 tools (consolidated `manage_*` action-based tools + a few standalone ones like `init_app`, `deploy_function`, `select_rows`). Runs via stdio or HTTP (served by control-api at `/mcp`) | | `services/deno-runtime` | — | Serverless function executor. Deno-based worker isolation. Port 7133 | | `services/cron-scheduler` | `@butterbase/cron-scheduler` | Cron job runner using node-cron + cron-parser | | `services/dashboard` | — | React management UI (Vite + Radix UI) | | `services/dashboard-api` | — | Dashboard bac...