Chad/prototype

.cursor/mcp.json

@@ -0,0 +1,12 @@
+{
+  "mcpServers": {
+    "supabase": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@modelcontextprotocol/server-postgres",
+        "postgresql://postgres:postgres@127.0.0.1:54322/postgres"
+      ]
+    }
+  }
+}

.cursor/rules/psql.mdc

@@ -0,0 +1,8 @@
+---
+description: 
+globs: *.sql, *.psql
+alwaysApply: false
+---
+1. All psql should be written in lowercase syntax
+2. When creating psql indices we should be as concise as we can, omitting defaults like the index name and the type. So we rather do `create index on table(column)` instead of `create idx_table_column on table using btree (column)`
+3. We should add indices to columns that reference other tables and columns that are queried frequently. e.g. if the column is `slug` it will most likely be queried on that instead of `id` so we should create an index on it.

.cursor/rules/typescript.mdc

@@ -0,0 +1,25 @@
+---
+description: These rules are helpful for contrubuting to the front-end Nextjs code and the typescript code.
+globs: *.tsx, *.ts
+alwaysApply: false
+---
+
+# Agentsmith tsx contributing rules for cursor AI
+
+1. Only use named exports (`export const thing`, not `export default`)¹
+2. All pages should have a single top level page component in page-components
+3. All components should be in components folder either as a single file named after the component or in a subfolder named after the component¹
+4. All functions should be declared in const rocket format: `const rocket = async (payload: any) => { ... }`¹
+5. All props should be explicitly typed as `type ComponentProps = { ... }` and not typed inline ex: `props: { foo: any }` is bad `props: ComponentProps` is good. DO NOT deconstruct props, if a component has props, it should be named as `props` and deconstructed in the body of the component. Write `const foo = (props: FooProps) => { const { arg, arg2 } = props; }` rather than `const foo = ({ arg, arg2 }: FooProps) => {}`
+6. Only use icons from `lucide-react`
+7. Only use tailwind css
+8. Each component file should have at most 2 react components, any more than that and it should be split up into multiple component files/folders.
+9. Any links to pages that exist under the web-studio should be prefixed with /app
+10. All functions that take more than 1 argument, should use an `options` syntax instead of adding many arguments. i.e. `const foo = (options: FooOptions) => {}` rather than `const foo = (bar: string, baz: string, quux: string) => {}`
+11. If the response for a function is an object, then it should be typed separately rather than inline. i.e. `const foo = (): FooResult => {}` instead of `const foo = (): { foo: string; bar: string; baz: string } => {}` 
+12. DO NOT edit any generated files within the `__generated__` folder.
+13. DO NOT create new types if they can be inferred from the supabase generated types OR can be inferred from the return of a supabase.from call using `Awaited<ReturnType><>`
+
+
+¹ Exception for the Nextjs page.tsx files. They should only have one default function export.
+

.env.example

@@ -0,0 +1,36 @@
+# FREE_MODELS_ONLY=true
+
+NEXT_PUBLIC_SITE_URL="http://localhost:3000"
+
+NEXT_PUBLIC_SUPABASE_URL=
+NEXT_PUBLIC_SUPABASE_ANON_KEY=
+
+NEXT_PUBLIC_POSTHOG_KEY=
+NEXT_PUBLIC_POSTHOG_HOST=
+
+SUPABASE_AUTH_GITHUB_CLIENT_ID=
+SUPABASE_AUTH_GITHUB_SECRET=
+
+SUPABASE_JWT_SECRET=
+
+# used for testing local dev
+SMEE_WEBHOOK_PROXY_URL=
+
+GITHUB_APP_NAME=
+GITHUB_APP_ID=
+GITHUB_APP_PRIVATE_KEY=
+GITHUB_APP_WEBHOOK_SECRET=
+GITHUB_WEBHOOK_SERVICE_USER_ID=
+
+
+# TESTING TURNSTILE LOCALLY
+# NEXT_PUBLIC_CF_TURNSTILE_SITE_KEY=1x00000000000000000000AA	# Always passes	visible
+# NEXT_PUBLIC_CF_TURNSTILE_SITE_KEY=2x00000000000000000000AB	# Always blocks	visible
+NEXT_PUBLIC_CF_TURNSTILE_SITE_KEY=1x00000000000000000000BB	# Always passes	invisible
+# NEXT_PUBLIC_CF_TURNSTILE_SITE_KEY=2x00000000000000000000BB	# Always blocks	invisible
+# NEXT_PUBLIC_CF_TURNSTILE_SITE_KEY=3x00000000000000000000FF	# Forces an interactive challenge	visible
+
+# unused right now, but good to have in case we validate on our end
+CF_TURNSTILE_SECRET_KEY=1x0000000000000000000000000000000AA #	Always passes
+# CF_TURNSTILE_SECRET_KEY=2x0000000000000000000000000000000AA #	Always fails
+# CF_TURNSTILE_SECRET_KEY=3x0000000000000000000000000000000AA #	Yields a "token already spent" error

.github/workflows/supabase_migrations_ci.yml

@@ -0,0 +1,36 @@
+name: Supabase Tests
+
+on:
+  pull_request:
+  workflow_dispatch:
+
+jobs:
+  supabase_tests:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v3
+
+      - uses: supabase/setup-cli@v1
+        with:
+          version: latest
+
+      - name: Overwrite Supabase db version
+        run: |
+          mkdir -p supabase/.temp
+          echo "15.8.1.038" > supabase/.temp/postgres-version
+
+      - name: Start Supabase local development setup
+        run: supabase db start
+
+      - name: Run Tests
+        run: supabase test db
+
+      - name: Verify generated types are checked in
+        run: |
+          supabase gen types typescript --local > types.gen.ts
+          if ! git diff --ignore-space-at-eol --exit-code --quiet types.gen.ts; then
+            echo "Detected uncommitted changes after build. See status below:"
+            git diff
+            exit 1
+          fi

.github/workflows/supabase_migrations_prod.yml

@@ -0,0 +1,27 @@
+name: Push Supabase Migrations to Production
+
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+jobs:
+  push_supabase_migrations_production:
+    environment: Production
+    runs-on: ubuntu-latest
+
+    env:
+      SUPABASE_ACCESS_TOKEN: ${{ secrets.SUPABASE_ACCESS_TOKEN }}
+      SUPABASE_DB_PASSWORD: ${{ secrets.SUPABASE_DB_PASSWORD }}
+      SUPABASE_PROJECT_ID: ${{ secrets.SUPABASE_PROJECT_ID }}
+
+    steps:
+      - uses: actions/checkout@v3
+
+      - uses: supabase/setup-cli@v1
+        with:
+          version: latest
+
+      - run: supabase link --project-ref $SUPABASE_PROJECT_ID
+      - run: supabase db push

.github/workflows/supabase_migrations_staging.yml

@@ -0,0 +1,27 @@
+name: Push Supabase Migrations to Staging
+
+on:
+  push:
+    branches:
+      - staging
+  workflow_dispatch:
+
+jobs:
+  push_supabase_migrations_staging:
+    environment: Staging
+    runs-on: ubuntu-latest
+
+    env:
+      SUPABASE_ACCESS_TOKEN: ${{ secrets.SUPABASE_ACCESS_TOKEN }}
+      SUPABASE_DB_PASSWORD: ${{ secrets.SUPABASE_DB_PASSWORD }}
+      SUPABASE_PROJECT_ID: ${{ secrets.SUPABASE_PROJECT_ID }}
+
+    steps:
+      - uses: actions/checkout@v3
+
+      - uses: supabase/setup-cli@v1
+        with:
+          version: latest
+
+      - run: supabase link --project-ref $SUPABASE_PROJECT_ID
+      - run: supabase db push

.nvmrc

@@ -1 +1 @@
-22.13.1
+22.14.0

.prettierrc.json

@@ -0,0 +1,8 @@
+{
+  "singleQuote": true,
+  "trailingComma": "all",
+  "printWidth": 100,
+  "tabWidth": 2,
+  "useTabs": false,
+  "semi": true
+}

CLAUDE.md

@@ -0,0 +1,28 @@
+# CLAUDE.md - AgentSmith Development Guidelines
+
+## Build and Test Commands
+
+- **Development**: `npm run dev` - Start Next.js dev server
+- **Build**: `npm run build` - Build the Next.js application
+- **Start**: `npm run start` - Start production server
+- **Test**: `npm run test` - Run all tests with Jest
+- **Test (Watch)**: `npm run test:watch` - Run tests in watch mode
+- **Test Single File**: `npm run test -- -t "test name"` or `npm run test -- path/to/file.test.ts`
+- **Type Generation**: `npm run typegen` - Generate Supabase TypeScript types
+
+## Code Style Guidelines
+
+- **Components**: Use named exports only; default exports only for Next.js page files
+- **Functions**: Declare with const arrow format: `const myFunc = (params: Type) => {}`
+- **Types**: Always explicitly type props as separate types, not inline
+- **File Structure**:
+  - Components in `/components` folder with max 2 components per file
+  - Page components in `/page-components`
+- **Imports**: Use path aliases: `@/` for src, `&/` for lib, `~/` for root
+- **Naming**: PascalCase for components, camelCase for functions, kebab-case for files
+- **Icons**: Only use icons from `lucide-react`
+- **Styling**: Only use Tailwind CSS, no custom CSS
+- **SQL**: Lowercase syntax for queries, concise index declarations with `create index concurrently`
+- **Error Handling**: Use try/catch with appropriate error logging
+
+Always follow existing patterns in the codebase.