Merge to Main

.commandcode/taste/taste.md

@@ -0,0 +1,4 @@
+# Taste (Continuously Learned by [CommandCode][cmd])
+
+[cmd]: https://commandcode.ai/
+

.env.example

@@ -17,6 +17,14 @@ LEMON_SQUEEZY_WEBHOOK_SECRET=your_webhook_secret
 LEMON_SQUEEZY_PRO_VARIANT_ID=your_pro_plan_variant_id
 LEMON_SQUEEZY_PLUS_VARIANT_ID=your_plus_plan_variant_id
 
+# Resend Email Automations
+RESEND_API_KEY=your_resend_api_key
+RESEND_FROM_EMAIL=TeraAI <onboarding@resend.dev>
+RESEND_REPLY_TO_EMAIL=support@your-domain.com
+
+# Important account emails
+# Used for welcome, usage limit, billing status, and team invite emails.
+
 # Application URLs
 # Local development
 NEXT_PUBLIC_APP_URL=http://localhost:3000

.forge/executions/18bdd766-de87-4aea-a95e-65b08636d21a.log

@@ -0,0 +1,3 @@
+[2026-04-20T13:45:28.457860900+00:00] Started execution for plan: 2d054b74-476c-4350-9b0d-01fe30d3dea3
+[2026-04-20T13:45:28.532783200+00:00] [Provider] Refining step: Analyze workspace context
+[2026-04-20T13:45:29.666195600+00:00] Resolved action: InspectFiles against src

.forge/executions/1d3f6f74-62a1-4546-9546-440bc9eec176.log

@@ -0,0 +1,4 @@
+[2026-04-20T14:01:25.320370100+00:00] Started execution for plan: d0c3c8e7-00bc-46e9-a4dc-650684f9a2ff
+[2026-04-20T14:01:25.392901100+00:00] [Provider] Refining step: Analyze workspace context
+[2026-04-20T14:01:51.628467+00:00] [Provider] Refinement failed: Request failed: error sending request for url (https://api.mistral.ai/v1/chat/completions). Using fallback.
+[2026-04-20T14:01:51.629282600+00:00] Resolved action: InspectFiles against 

.forge/executions/23c8bec4-f82e-4857-a6de-67f3b8a60eec.log

@@ -0,0 +1,3 @@
+[2026-04-20T13:44:37.566968200+00:00] Started execution for plan: 2d054b74-476c-4350-9b0d-01fe30d3dea3
+[2026-04-20T13:44:37.662824400+00:00] [Provider] Refining step: Analyze workspace context
+[2026-04-20T13:44:39.095675800+00:00] Resolved action: InspectFiles against src

.forge/executions/c68159c7-9e6e-4271-90b6-73a6414bfba0.log

@@ -0,0 +1,3 @@
+[2026-04-20T14:33:38.557977700+00:00] Started execution for plan: d0c3c8e7-00bc-46e9-a4dc-650684f9a2ff
+[2026-04-20T14:33:38.637442100+00:00] [Provider] Refining step: Analyze workspace context
+[2026-04-20T14:33:40.691084300+00:00] Resolved action: InspectFiles against src

.forge/executions/state.json

@@ -0,0 +1,7 @@
+{
+  "id": "c68159c7-9e6e-4271-90b6-73a6414bfba0",
+  "planId": "d0c3c8e7-00bc-46e9-a4dc-650684f9a2ff",
+  "status": "running",
+  "mode": "step_by_step",
+  "currentStepId": "step_1"
+}

.forge/plans/2d054b74-476c-4350-9b0d-01fe30d3dea3.json

@@ -0,0 +1,42 @@
+{
+  "id": "2d054b74-476c-4350-9b0d-01fe30d3dea3",
+  "taskId": "7fbdc7ca-d44b-47ca-9db1-30ad5c19b87c",
+  "status": "approved",
+  "title": "Plan for: what is this project about?",
+  "objective": "what is this project about?",
+  "steps": [
+    {
+      "id": "step_1",
+      "kind": "inspect",
+      "title": "Analyze workspace context",
+      "objective": "Assess current state of relevant files.",
+      "status": "pending",
+      "filesLikelyInvolved": [],
+      "requiredTools": [
+        "fs_list"
+      ]
+    },
+    {
+      "id": "step_2",
+      "kind": "edit",
+      "title": "Implement changes",
+      "objective": "```json\n{\n  \"plan\": {\n    \"id\": \"plan_1\",\n    \"taskId\": \"task_1\",\n    \"status\": \"draft\",\n    \"title\": \"Analyze Tera Project\",\n    \"objective\": \"Understand the purpose and structure of the Tera project",
+      "status": "pending",
+      "filesLikelyInvolved": [
+        "src/main.rs"
+      ],
+      "requiredTools": [
+        "fs_write"
+      ]
+    }
+  ],
+  "dependencies": [
+    {
+      "stepId": "step_2",
+      "dependsOn": "step_1"
+    }
+  ],
+  "assumptions": [],
+  "risks": [],
+  "architectureProposal": null
+}

.forge/plans/d0c3c8e7-00bc-46e9-a4dc-650684f9a2ff.json

@@ -0,0 +1,42 @@
+{
+  "id": "d0c3c8e7-00bc-46e9-a4dc-650684f9a2ff",
+  "taskId": "2c368bff-7a21-47c5-8640-dc0f68bd74b1",
+  "status": "approved",
+  "title": "Plan for: tell me what this project is about",
+  "objective": "tell me what this project is about",
+  "steps": [
+    {
+      "id": "step_1",
+      "kind": "inspect",
+      "title": "Analyze workspace context",
+      "objective": "Assess current state of relevant files.",
+      "status": "pending",
+      "filesLikelyInvolved": [],
+      "requiredTools": [
+        "fs_list"
+      ]
+    },
+    {
+      "id": "step_2",
+      "kind": "edit",
+      "title": "Implement changes",
+      "objective": "```json\n{\n  \"plan\": {\n    \"id\": \"3a4b5c6d-7e8f-9a0b-1c2d-3e4f5a6b7c8d\",\n    \"taskId\": \"project_analysis\",\n    \"status\": \"draft\",\n    \"title\": \"Analyze Tera Project\",\n    \"objective\": \"Determine what t",
+      "status": "pending",
+      "filesLikelyInvolved": [
+        "src/main.rs"
+      ],
+      "requiredTools": [
+        "fs_write"
+      ]
+    }
+  ],
+  "dependencies": [
+    {
+      "stepId": "step_2",
+      "dependsOn": "step_1"
+    }
+  ],
+  "assumptions": [],
+  "risks": [],
+  "architectureProposal": null
+}

.forge/plans/e44ed371-65d0-4399-97a1-fd2bbf46de00.json

@@ -0,0 +1,42 @@
+{
+  "id": "e44ed371-65d0-4399-97a1-fd2bbf46de00",
+  "taskId": "5b12269e-62c9-41d1-af4d-a9d06bc811d5",
+  "status": "ready_for_review",
+  "title": "Plan for: what is Tera about",
+  "objective": "what is Tera about",
+  "steps": [
+    {
+      "id": "step_1",
+      "kind": "inspect",
+      "title": "Analyze workspace context",
+      "objective": "Assess current state of relevant files.",
+      "status": "pending",
+      "filesLikelyInvolved": [],
+      "requiredTools": [
+        "fs_list"
+      ]
+    },
+    {
+      "id": "step_2",
+      "kind": "edit",
+      "title": "Implement changes",
+      "objective": "```json\n{\n  \"plan\": {\n    \"id\": \"c0f7b5e8-1234-5678-9abc-def123456789\",\n    \"taskId\": \"what_is_tera_about\",\n    \"status\": \"draft\",\n    \"title\": \"Investigate Tera project to understand its purpose\",\n  ",
+      "status": "pending",
+      "filesLikelyInvolved": [
+        "src/main.rs"
+      ],
+      "requiredTools": [
+        "fs_write"
+      ]
+    }
+  ],
+  "dependencies": [
+    {
+      "stepId": "step_2",
+      "dependsOn": "step_1"
+    }
+  ],
+  "assumptions": [],
+  "risks": [],
+  "architectureProposal": null
+}

.forge/provider_config.json

@@ -0,0 +1,6 @@
+{
+  "kind": "openai_compatible",
+  "baseUrl": "https://api.mistral.ai",
+  "modelId": "mistral-small-latest",
+  "apiKeySet": true
+}

.forge/provider_secret.key

@@ -0,0 +1 @@
+v1Vphvx1drTK9OdsQBv1lsTVr4bsaBrv

.github/workflows/deploy-cloudflare.yml

@@ -0,0 +1,104 @@
+name: Deploy to Cloudflare Workers
+
+on:
+  workflow_dispatch:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: read
+
+concurrency:
+  group: cloudflare-production
+  cancel-in-progress: true
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    env:
+      NODE_OPTIONS: --max-old-space-size=6144
+      DISABLE_WEBPACK_CACHE: "1"
+      AUTH_SECRET: ${{ secrets.AUTH_SECRET }}
+      AUTH_URL: ${{ secrets.AUTH_URL }}
+      CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+      CLOUDFLARE_ACCOUNT_ID: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
+      GOOGLE_CLIENT_ID: ${{ secrets.GOOGLE_CLIENT_ID }}
+      GOOGLE_CLIENT_SECRET: ${{ secrets.GOOGLE_CLIENT_SECRET }}
+      LEMON_SQUEEZY_API_KEY: ${{ secrets.LEMON_SQUEEZY_API_KEY }}
+      LEMON_SQUEEZY_PLUS_VARIANT_ID: ${{ secrets.LEMON_SQUEEZY_PLUS_VARIANT_ID }}
+      LEMON_SQUEEZY_PRO_VARIANT_ID: ${{ secrets.LEMON_SQUEEZY_PRO_VARIANT_ID }}
+      LEMON_SQUEEZY_WEBHOOK_SECRET: ${{ secrets.LEMON_SQUEEZY_WEBHOOK_SECRET }}
+      MISTRAL_API_KEY: ${{ secrets.MISTRAL_API_KEY }}
+      NEXT_PUBLIC_APP_URL: ${{ secrets.NEXT_PUBLIC_APP_URL }}
+      NEXT_PUBLIC_LEMON_STORE_ID: ${{ secrets.NEXT_PUBLIC_LEMON_STORE_ID }}
+      NEXT_PUBLIC_SUPABASE_ANON_KEY: ${{ secrets.NEXT_PUBLIC_SUPABASE_ANON_KEY }}
+      NEXT_PUBLIC_SUPABASE_URL: ${{ secrets.NEXT_PUBLIC_SUPABASE_URL }}
+      NEXTAUTH_URL: ${{ secrets.NEXTAUTH_URL }}
+      RESEND_API_KEY: ${{ secrets.RESEND_API_KEY }}
+      RESEND_FROM_EMAIL: ${{ secrets.RESEND_FROM_EMAIL }}
+      RESEND_REPLY_TO_EMAIL: ${{ secrets.RESEND_REPLY_TO_EMAIL }}
+      SEARXNG_BASE_URL: ${{ secrets.SEARXNG_BASE_URL }}
+      SERPER_API_KEY: ${{ secrets.SERPER_API_KEY }}
+      SUPABASE_ANON_KEY: ${{ secrets.SUPABASE_ANON_KEY }}
+      SUPABASE_JWT_SECRET: ${{ secrets.SUPABASE_JWT_SECRET }}
+      SUPABASE_SERVICE_ROLE_KEY: ${{ secrets.SUPABASE_SERVICE_ROLE_KEY }}
+      SUPABASE_URL: ${{ secrets.SUPABASE_URL }}
+      WEB_URL: ${{ secrets.WEB_URL }}
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 11.0.9
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: pnpm
+
+      - name: Install dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Build OpenNext worker
+        run: pnpm exec opennextjs-cloudflare build
+
+      - name: Write Cloudflare runtime secrets file
+        shell: bash
+        run: |
+          cat > .cloudflare.secrets.env <<EOF
+          AUTH_SECRET=${AUTH_SECRET}
+          AUTH_URL=${AUTH_URL}
+          GOOGLE_CLIENT_ID=${GOOGLE_CLIENT_ID}
+          GOOGLE_CLIENT_SECRET=${GOOGLE_CLIENT_SECRET}
+          LEMON_SQUEEZY_API_KEY=${LEMON_SQUEEZY_API_KEY}
+          LEMON_SQUEEZY_PLUS_VARIANT_ID=${LEMON_SQUEEZY_PLUS_VARIANT_ID}
+          LEMON_SQUEEZY_PRO_VARIANT_ID=${LEMON_SQUEEZY_PRO_VARIANT_ID}
+          LEMON_SQUEEZY_WEBHOOK_SECRET=${LEMON_SQUEEZY_WEBHOOK_SECRET}
+          MISTRAL_API_KEY=${MISTRAL_API_KEY}
+          NEXT_PUBLIC_APP_URL=${NEXT_PUBLIC_APP_URL}
+          NEXT_PUBLIC_LEMON_STORE_ID=${NEXT_PUBLIC_LEMON_STORE_ID}
+          NEXT_PUBLIC_SUPABASE_ANON_KEY=${NEXT_PUBLIC_SUPABASE_ANON_KEY}
+          NEXT_PUBLIC_SUPABASE_URL=${NEXT_PUBLIC_SUPABASE_URL}
+          NEXTAUTH_URL=${NEXTAUTH_URL}
+          RESEND_API_KEY=${RESEND_API_KEY}
+          RESEND_FROM_EMAIL=${RESEND_FROM_EMAIL}
+          RESEND_REPLY_TO_EMAIL=${RESEND_REPLY_TO_EMAIL}
+          SEARXNG_BASE_URL=${SEARXNG_BASE_URL}
+          SERPER_API_KEY=${SERPER_API_KEY}
+          SUPABASE_ANON_KEY=${SUPABASE_ANON_KEY}
+          SUPABASE_JWT_SECRET=${SUPABASE_JWT_SECRET}
+          SUPABASE_SERVICE_ROLE_KEY=${SUPABASE_SERVICE_ROLE_KEY}
+          SUPABASE_URL=${SUPABASE_URL}
+          WEB_URL=${WEB_URL}
+          NODE_ENV=production
+          EOF
+
+      - name: Deploy Frontend (tera-web) to Cloudflare Workers
+        run: pnpm exec wrangler deploy --config wrangler.jsonc --secrets-file .cloudflare.secrets.env
+
+      - name: Deploy Backend API (tera-api) to Cloudflare Workers
+        run: pnpm exec wrangler deploy --config backend-server/wrangler.toml --secrets-file .cloudflare.secrets.env

.gitignore

@@ -3,6 +3,7 @@ node_modules/
 
 # Next.js build output
 .next/
+.open-next/
 out/
 
 # Production

.node-version

@@ -0,0 +1 @@
+22

.npmrc

@@ -0,0 +1 @@
+node-linker=hoisted

README.md

@@ -48,6 +48,20 @@ Tera is a free, AI-powered learning companion designed for **anything** you want
 
 ---
 
+## Chat Learning Modes
+
+Tera chat includes learning modes that shape the assistant experience without changing existing usage limits or introducing new plan limits for this foundation.
+
+- **Ask:** Preserves normal Tera chat behavior.
+- **Study:** Provides tutor-style, step-by-step teaching.
+- **Quiz:** Generates interactive quizzes and grades follow-up answers.
+- **Summarize:** Creates structured learning notes from pasted content.
+- **Image:** Visible in the mode picker, but coming soon and locked.
+
+Mode configuration and prompts live in `lib/ai/chat-modes.ts`. Document any migration added for mode metadata alongside this foundation; no new plan limits are introduced, so existing usage limits continue to apply.
+
+---
+
 ## 📖 Grokipedia Integration
 
 Tera integrates [Grokipedia](https://grokipedia.com) — an open-source AI-powered encyclopedia with **362,000+ pages** — as its primary knowledge base and citation source.

SOUL.md

@@ -0,0 +1,2 @@
+### Boil the ocean
+The marginal cost of completeness is near zero with AI. Do the whole thing. Do it right. Do it with tests. Do it with documentation. Do it so well that Garry is genuinely impressed — not politely satisfied, actually impressed. Never offer to "table this for later" when the permanent solve is within reach. Never leave a dangling thread when tying it off takes five more minutes. Never present a workaround when the real fix exists. The standard isn't "good enough" — it's "holy shit, that's done." Search before building. Test before shipping. Ship the complete thing. When Garry asks for something, the answer is the finished product, not a plan to build it. Time is not an excuse. Fatigue is not an excuse. Complexity is not an excuse. Boil the ocean.