Update project with latest changes and new features

Author: AI Assistant

.env.example

@@ -1,2 +1,5 @@
 # Copy this file to .env and set your server-side Gemini API key
 GEMINI_API_KEY=
+
+# Optional client-side Sentry DSN for error monitoring
+VITE_SENTRY_DSN=

.github/workflows/ci.yml

@@ -0,0 +1,32 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  quality:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+
+      - name: Install Dependencies
+        run: npm ci --legacy-peer-deps
+
+      - name: Lint
+        run: npm run lint
+
+      - name: Test
+        run: npm run test
+
+      - name: Build
+        run: npm run build

.github/workflows/preview-artifact.yml

@@ -0,0 +1,30 @@
+name: Preview Artifact
+
+on:
+  pull_request:
+    branches: [main]
+
+jobs:
+  preview:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+
+      - name: Install Dependencies
+        run: npm ci --legacy-peer-deps
+
+      - name: Build Preview
+        run: npm run build
+
+      - name: Upload Preview Artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: web-preview-dist
+          path: dist

.github/workflows/release.yml

@@ -0,0 +1,21 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Generate GitHub Release Notes
+        uses: softprops/action-gh-release@v2
+        with:
+          generate_release_notes: true

.github/workflows/uptime.yml

@@ -0,0 +1,24 @@
+name: Uptime Checks
+
+on:
+  schedule:
+    - cron: '*/30 * * * *'
+  workflow_dispatch:
+
+jobs:
+  uptime:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - name: Run Uptime Checks
+        env:
+          UPTIME_WEB_URL: https://abdullahmalik-ctrl.github.io/Jarvis-Cali/
+          UPTIME_API_HEALTH_URL: ${{ secrets.UPTIME_API_HEALTH_URL }}
+        run: node scripts/uptime-check.mjs

README.md

@@ -162,6 +162,9 @@ Notes:
 ### 🧠 Practice Mode Feature
 
 - AI-generated quizzes based on topic, difficulty, and question count.
+- Curated question bank with difficulty tags and curriculum mapping (General, Common Core, IGCSE, SAT).
+- Hybrid generation strategy: approved curated items first, then AI fallback for missing coverage.
+- Built-in solution quality review queue for AI-generated questions (approve / needs work workflow).
 - Topic presets: Algebra, Calculus, Geometry, Trigonometry, Arithmetic, Statistics.
 - Per-question feedback with explanation.
 - End-of-quiz summary with score/percentage and retry flow.
@@ -173,6 +176,20 @@ Notes:
 - Select and persist preferred model.
 - Theme toggling.
 - Progressive Web App install prompt integration when available.
+- Offline action queue for tutor/practice requests.
+- Background sync trigger for queued actions when connectivity returns.
+- Conflict-safe queue replay strategy (last-write-wins per conflict key).
+- In-app update toast when a new service worker version is available.
+
+### 🧪 Content Quality Workflow
+
+- `curatedQuestionBank.js` stores approved baseline content with metadata:
+  - `topic`
+  - `difficulty`
+  - `curriculumTag`
+  - `quality.status`
+- `questionBankService.js` handles filtering and review override state.
+- `qualityReviewService.js` tracks generated-question review queue and outcomes.
 
 ## 🏗️ Architecture Highlights
 
@@ -194,10 +211,28 @@ Notes:
 - `npm run dev` - run proxy server + Vite together 🚀
 - `npm run server` - run secure proxy server only 🔐
 - `npm run build` - create production bundle 🏗️
+- `npm run test` - run smoke tests ✅
 - `npm run preview` - preview production build locally 👀
 - `npm run lint` - run ESLint 🧹
 - `npm run deploy` - deploy `dist` to GitHub Pages 🌐
 
+## 🔁 Professional DevOps
+
+GitHub Actions workflows included:
+
+- `.github/workflows/ci.yml`
+  - Runs lint, tests, and production build on push/PR.
+- `.github/workflows/preview-artifact.yml`
+  - Builds PR preview artifact (`dist`) for quick QA download.
+- `.github/workflows/uptime.yml`
+  - Scheduled uptime checks for live web URL and optional API health URL.
+- `.github/workflows/release.yml`
+  - Auto-generates GitHub release notes for `v*` tags.
+
+Optional monitoring:
+
+- Frontend Sentry via `VITE_SENTRY_DSN`.
+
 ## 🚢 Deployment
 
 ### 🐙 GitHub Pages (configured)

index.html

@@ -13,19 +13,6 @@
 <body>
   <div id="root"></div>
   <script type="module" src="/src/main.jsx"></script>
-  <script>
-    if ('serviceWorker' in navigator) {
-      window.addEventListener('load', () => {
-        navigator.serviceWorker.register('/Jarvis-Cali/sw.js')
-          .then(registration => {
-            console.log('SW registered: ', registration);
-          })
-          .catch(registrationError => {
-            console.log('SW registration failed: ', registrationError);
-          });
-      });
-    }
-  </script>
 </body>
 
 </html>

package-lock.json

@@ -8,6 +8,7 @@
     "dev": "concurrently \"npm run server\" \"vite\"",
     "server": "node server/index.js",
     "build": "vite build",
+    "test": "node --test tests",
     "lint": "eslint . --ext js,jsx --report-unused-disable-directives --max-warnings 0",
     "preview": "vite preview",
     "predeploy": "npm run build",
@@ -25,6 +26,7 @@
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
     "react-markdown": "^10.1.0",
+    "@sentry/react": "^10.17.0",
     "rehype-katex": "^7.0.1",
     "remark-math": "^6.0.0",
     "three": "^0.183.0"

package.json

@@ -1,4 +1,4 @@
-const CACHE_NAME = 'jarvis-math-v5';
+const CACHE_NAME = 'jarvis-math-v6';
 const urlsToCache = [
     './',
     './index.html',
@@ -16,6 +16,27 @@ self.addEventListener('install', (event) => {
     );
 });
 
+const notifyClients = async (message) => {
+    const clients = await self.clients.matchAll({ includeUncontrolled: true, type: 'window' });
+    clients.forEach((client) => client.postMessage(message));
+};
+
+self.addEventListener('message', (event) => {
+    if (event.data?.type === 'SKIP_WAITING') {
+        self.skipWaiting();
+    }
+
+    if (event.data?.type === 'REQUEST_SYNC') {
+        event.waitUntil(notifyClients({ type: 'jarvis-sync-now' }));
+    }
+});
+
+self.addEventListener('sync', (event) => {
+    if (event.tag === 'jarvis-sync') {
+        event.waitUntil(notifyClients({ type: 'jarvis-sync-now' }));
+    }
+});
+
 self.addEventListener('fetch', (event) => {
     event.respondWith(
         fetch(event.request)