Dev

.env.example

@@ -1,21 +1,50 @@
-# MUX API
+# ===============================
+# Core Auth & Database (Required)
+# ===============================
+
+# Secret used by Better Auth for signing/encryption
+BETTER_AUTH_SECRET={your_better_auth_secret_here}
+
+# Postgres / Neon connection URL
+# Example: postgresql://user:password@host:5432/dbname?sslmode=require
+DATABASE_URL={your_database_url_here}
+
+
+# ===============================
+# Mux Video (Optional)
+# ===============================
+
+# Only needed if you use Mux API/token-based workflows
 MUX_TOKEN_ID={your_mux_token_here}
 MUX_TOKEN_SECRET={your_mux_secret_here}
 
-# Tavus API Configuration
-# Get your API credentials at: https://www.tavus.io/
-# Documentation: https://docs.tavus.io/api-reference/conversations/create-conversation
+
+# ==========================================
+# Tavus Learning Check Feature (Optional)
+# ==========================================
+
+# Get your Tavus API credentials at: https://www.tavus.io/
+# Docs: https://docs.tavus.io/api-reference/conversations/create-conversation
 
 # Required: Your Tavus API key
 TAVUS_API_KEY=your_tavus_api_key_here
 
-# Required: Your Tavus replica ID (AI avatar)
-TAVUS_REPLICA_ID=your_replica_id_here
+# Required: Tavus persona ID (e.g. "pd8#1eb0d8e")
+# This should reference the "8p3p - AI Instructor Assistant" persona
+TAVUS_PERSONA_ID=your_persona_id_here
+
+# Webhook configuration (Phase 2+: perception / callbacks)
+
+# Secret for verifying Tavus webhook signatures (HMAC)
+TAVUS_WEBHOOK_SECRET=your_webhook_secret_here
 
-# Optional: Persona ID for custom AI personality
-# Leave commented out to use default persona
-# TAVUS_PERSONA_ID=your_persona_id_here
+# Public webhook URL for perception analysis callbacks
+# Example: https://your-app.vercel.app/api/learning-checks/perception-analysis
+TAVUS_WEBHOOK_URL=your_webhook_endpoint_here
 
-# Optional: Default conversation duration in seconds
-# Default: 240 (4 minutes)
-# TAVUS_DEFAULT_CALL_DURATION=240
+# Learning Check assets (IDs can be public)
+NEXT_PUBLIC_TAVUS_LEARNING_CHECK_OBJECTIVES_ID=your_objectives_id_here
+NEXT_PUBLIC_TAVUS_LEARNING_CHECK_GUARDRAILS_ID=your_guardrails_id_here
+# Helper: create via API routes (local dev)
+# curl -X POST http://localhost:3000/api/learning-checks/objectives -H "Content-Type: application/json" -d '{}'
+# curl -X POST http://localhost:3000/api/learning-checks/guardrails -H "Content-Type: application/json" -d '{}'

.github/workflows/pr-checks.yml

@@ -24,35 +24,9 @@ jobs:
       - name: Run ESLint checks
         run: npm run lint:strict
 
-      - name: Create mock amplify_outputs.json for CI
-        run: |
-          if [ ! -f "amplify_outputs.json" ]; then
-            echo "Creating mock amplify_outputs.json for CI build..."
-            cat > amplify_outputs.json << 'EOF'
-          {
-            "auth": {
-              "aws_region": "us-east-1",
-              "user_pool_id": "mock-pool-id",
-              "user_pool_client_id": "mock-client-id",
-              "identity_pool_id": "mock-identity-pool-id"
-            },
-            "data": {
-              "aws_region": "us-east-1",
-              "url": "https://mock-api.amazonaws.com/graphql"
-            }
-          }
-          EOF
-          fi
-
       - name: Run TypeScript check
         run: npm run type-check
 
-      - name: Run build check (with mock amplify outputs)
-        run: |
-          echo "🏗️ Testing build with mock Amplify configuration..."
-          npm run build
-        continue-on-error: false
-
       - name: Upload logs (on failure)
         if: failure()
         uses: actions/upload-artifact@v4

.gitignore

@@ -13,6 +13,9 @@
 # testing
 /coverage
 
+# logs
+/logs/*
+
 # next.js
 /.next/
 /out/
@@ -52,10 +55,10 @@ amplifyconfiguration*
 logs/*
 
 # windsurf
-.windsurf/*
-!.windsurf/rules/
-.windsurf/rules/*
-!.windsurf/rules/project-standards.md
+# .windsurf/*
+# !.windsurf/rules/
+# .windsurf/rules/*
+# !.windsurf/rules/project-standards.md
 
 # next-video
 videos/*
@@ -69,4 +72,5 @@ scripts/*-output.json
 scripts/*.log
 
 # specs archive (historical files not tracked)
-specs/archive/
+**/archive/
+