feat: implement strict AI feedback branching and contextual lesson menu with history

apps/api/src/routes/ai.ts

@@ -243,14 +243,25 @@ export async function aiRoutes(fastify: FastifyInstance) {
                 isDeepDive, iterationCount, imageUrl ?? undefined, isButtonChoice
             );
 
-            // 🌟 Standard Feedback UX: 3 lines 🌟
-            // 1. Encouragement/Validation (VALIDATION)
-            // 2. Diagnostic (ENRICHED VERSION)
-            // 3. Action / Help (ACTIONABLE ADVICE)
-            const formattedFeedback = `✨ *Coach XAMLÉ* :\n\n` +
-                `🌟 ${feedback.validation}\n\n` +
-                `🚀 ${feedback.enrichedVersion}\n\n` +
-                `💡 ${feedback.actionableAdvice}`;
+            // 🌟 Standard Feedback UX: 2-stage branching (Lead UX Requirement) 🌟
+            let formattedFeedback = `✨ *Coach XAMLÉ* :\n\n`;
+
+            if (feedback.isQualified === false) {
+                // ÉCHEC (Branching 1)
+                formattedFeedback += `${feedback.validation}\n\n` +
+                    (userLanguage === 'WOLOF'
+                        ? `🚨 Am na yenn mbir yu laaj gëna dëgër. Xoolal li ma la digal te fexe tontu waat ci exercice bi !`
+                        : `🚨 Certains points sont encore à renforcer. Regarde mes conseils et réessaie de répondre à l'exercice !`);
+            } else {
+                // SUCCÈS (Branching 2)
+                formattedFeedback += `🌟 ${feedback.validation}\n\n` +
+                    `🚀 ${feedback.enrichedVersion}\n\n` +
+                    `💡 ${feedback.actionableAdvice}\n\n` +
+                    (userLanguage === 'WOLOF'
+                        ? `Soo bëggé gëna xóotal pënd bi ak li ngay dund ci yaw ci terrain bi, bindal 1️⃣ *APPROFONDIR*, soo ko bëggul bindal 2️⃣ *SUITE*.`
+                        : `Si tu veux affiner ce point avec une donnée de ton propre terrain, tape 1️⃣ *APPROFONDIR*, sinon tape 2️⃣ *SUITE*.`);
+            }
+
 
             return {
                 success: true,

apps/whatsapp-worker/src/handlers/CommandHandler.ts

@@ -10,6 +10,7 @@ export class CommandHandler implements MessageHandler {
         const { normalizedText } = ctx;
         
         if (isFuzzyMatch(normalizedText, 'SEED')) return true;
+        if (isFuzzyMatch(normalizedText, 'MENU_HISTORIQUE')) return true;
         
         const dayActionMatch = normalizedText.match(/^DAY(\d+)_(EXERCISE|REPLAY|CONTINUE|PROMPT)$/);
         if (dayActionMatch) return true;
@@ -18,11 +19,14 @@ export class CommandHandler implements MessageHandler {
     }
 
     async handle(ctx: MessageContext): Promise<boolean> {
-        const { user, normalizedText, whatsappQueue, traceId } = ctx;
+        const { user, normalizedText, whatsappQueue, traceId, activeEnrollment } = ctx;
         if (!user) return false;
 
+        const isWolof = user.language === 'WOLOF';
+
         // --- 1. SEED ---
         if (isFuzzyMatch(normalizedText, 'SEED')) {
+            // ... (existing seed logic)
             logger.info({ traceId, userId: user.id }, "Database Seeding requested");
             try {
                 // @ts-ignore
@@ -43,24 +47,74 @@ export class CommandHandler implements MessageHandler {
             return true;
         }
 
-        // --- 2. DAY ACTIONS (List menus) ---
+        // --- 2. MENU_HISTORIQUE ---
+        if (isFuzzyMatch(normalizedText, 'MENU_HISTORIQUE')) {
+            if (!activeEnrollment) return false;
+
+            logger.info({ traceId, userId: user.id }, "User requested LESSON HISTORY");
+
+            const pastDays = await prisma.trackDay.findMany({
+                where: {
+                    trackId: activeEnrollment.trackId,
+                    dayNumber: { lt: activeEnrollment.currentDay }
+                },
+                orderBy: { dayNumber: 'asc' }
+            });
+
+            if (pastDays.length === 0) {
+                const msg = isWolof ? "Amul bés yu passé ba pare !" : "Tu n'as pas encore d'anciennes leçons !";
+                await whatsappQueue.add('send-message', { userId: user.id, text: msg });
+                return true;
+            }
+
+            const rows = pastDays.map(day => ({
+                id: `DAY${day.dayNumber}_REPLAY`,
+                title: isWolof ? `Bés ${day.dayNumber}` : `Leçon ${day.dayNumber}`,
+                description: isWolof ? "Revoir cette leçon" : "Revoir cette leçon"
+            }));
+
+            // WhatsApp list limit is 10 per section. Let's take the last 10 if too many.
+            const limitedRows = rows.slice(-10);
+
+            const { sendInteractiveListMessage } = await import('../whatsapp-cloud');
+            await sendInteractiveListMessage(
+                user.phone,
+                isWolof ? "Sa njàng" : "Ton parcours",
+                isWolof ? "Tànnal bés bi nga bëgg tontu waat :" : "Choisis la leçon que tu souhaites revoir :",
+                isWolof ? "Seeti" : "Parcourir",
+                [{
+                    title: isWolof ? "Bés yu passé" : "Leçons passées",
+                    rows: limitedRows
+                }]
+            );
+            return true;
+        }
+
+        // --- 3. DAY ACTIONS (List menus) ---
         const dayActionMatch = normalizedText.match(/^DAY(\d+)_(EXERCISE|REPLAY|CONTINUE|PROMPT)$/);
         if (dayActionMatch) {
             const action = dayActionMatch[2];
-            const enrollment = await prisma.enrollment.findFirst({ where: { userId: user.id, status: 'ACTIVE' } });
+            const enrollment = activeEnrollment || await prisma.enrollment.findFirst({ where: { userId: user.id, status: 'ACTIVE' } });
             
             logger.info({ traceId, userId: user.id, action, day: dayActionMatch[1] }, "Day action triggered");
 
             if (action === 'REPLAY' && enrollment) {
-                await whatsappQueue.add('send-content', { userId: user.id, trackId: enrollment.trackId, dayNumber: enrollment.currentDay });
+                // Important: Trigger a full content send for the historical day
+                await whatsappQueue.add('send-content', { 
+                    userId: user.id, 
+                    trackId: enrollment.trackId, 
+                    dayNumber: parseFloat(dayActionMatch[1]),
+                    isHistorical: true // Signal to skip progress update
+                });
                 return true;
             } else if (action === 'EXERCISE') {
-                const msg = user.language === 'WOLOF' ? "🎙️ Yónnee sa tontu :" : "🎙️ Envoie ta réponse :";
+                const msg = isWolof ? "🎙️ J'écoute ta réponse (vocal wala mbind) :" : "🎙️ J'écoute ta réponse (vocal ou texte) :";
                 await whatsappQueue.add('send-message', { userId: user.id, text: msg });
                 return true;
             }
         }
 
+
         return false;
     }
 }

apps/whatsapp-worker/src/index.ts

@@ -134,27 +134,22 @@ const worker = new Worker('whatsapp-queue', async (job: Job) => {
                 if (feedbackRes.ok) {
                     feedbackData = await feedbackRes.json();
 
-                    const callToAction = language === 'WOLOF'
-                        ? "\n\nSu nga bëggee yokk leneen ci li nga xam, bindal 1️⃣ APPROFONDIR, wala nga bind 2️⃣ SUITE."
-                        : "\n\nSi tu veux affiner ce point avec une donnée de ton propre terrain, tape 1️⃣ APPROFONDIR, sinon tape 2️⃣ SUITE.";
+                    if (feedbackData.text) {
 
-                    if (feedbackData.validation && feedbackData.enrichedVersion && feedbackData.actionableAdvice) {
-                        feedbackMsg = `🌟 ${feedbackData.validation}\n\n🚀 ${feedbackData.enrichedVersion}\n\n💡 Conseil de Terrain :\n${feedbackData.actionableAdvice}`;
-                        if (!isDeepDive || (isDeepDive && iterationCount < 3 && !feedbackData.isForcedClosure)) {
-                            feedbackMsg += callToAction;
-                        } else if (feedbackData.isForcedClosure) {
-                            feedbackMsg += (language === 'WOLOF' ? "\n\nBindal 2️⃣ SUITE ngir wéy." : "\n\nTape 2️⃣ SUITE pour continuer.");
-                        }
-                    } else if (feedbackData.text) {
                         feedbackMsg = feedbackData.text;
+                    } else if (feedbackData.validation && feedbackData.enrichedVersion && feedbackData.actionableAdvice) {
+                        // LEGACY FALLBACK: Construct message if API didn't return .text (Branching already better in .text)
+                        feedbackMsg = `🌟 ${feedbackData.validation}\n\n🚀 ${feedbackData.enrichedVersion}\n\n💡 Conseil de Terrain :\n${feedbackData.actionableAdvice}`;
+                        const callToAction = language === 'WOLOF'
+                            ? "\n\nSoo bëggé gëna xóotal pënd bi ak li ngay dund ci yaw ci terrain bi, bindal 1️⃣ *APPROFONDIR*, soo ko bëggul bindal 2️⃣ *SUITE*."
+                            : "\n\nSi tu veux affiner ce point avec une donnée de ton propre terrain, tape 1️⃣ *APPROFONDIR*, sinon tape 2️⃣ *SUITE*.";
                         if (!isDeepDive || (isDeepDive && iterationCount < 3 && !feedbackData.isForcedClosure)) {
                             feedbackMsg += callToAction;
-                        } else if (feedbackData.isForcedClosure) {
-                            feedbackMsg += (language === 'WOLOF' ? "\n\nBindal 2️⃣ SUITE ngir wéy." : "\n\nTape 2️⃣ SUITE pour continuer.");
                         }
                     } else {
                         feedbackMsg = '✅ Analyse terminée.';
                     }
+
                 } else if (feedbackRes.status === 429) {
                     logger.warn(`[WORKER] 429 Error during generate-feedback`);
                     const fallbackMsg = language === 'WOLOF'
@@ -811,16 +806,8 @@ const worker = new Worker('whatsapp-queue', async (job: Job) => {
             }
         }
         else if (job.name === 'send-content') {
-            const { userId, trackId, dayNumber, testImageUrl } = job.data;
+            const { userId, trackId, dayNumber } = job.data;
 
-            if (testImageUrl && userId) {
-                const u = await prisma.user.findUnique({ where: { id: userId } });
-                if (u?.phone) {
-                    await sendImageMessage(u.phone, testImageUrl, "Branding XAMLÉ 🇸🇳");
-                    logger.info(`[WhatsApp] ✅ Image message sent to ${u.phone}`);
-                }
-                return;
-            }
 
             const user = await prisma.user.findUnique({ where: { id: userId } });
             const trackDay = await prisma.trackDay.findFirst({

apps/whatsapp-worker/src/pedagogy.ts

@@ -320,7 +320,9 @@ export async function sendLessonDay(
 
     // 🌟 3. Send Action LIST menu ────────────────────────────────────────────────
     // Shown after every lesson so the user knows their options
-    if (dayNumber === 1) {
+    const isHistorical = options?.skipProgressUpdate === true || dayNumber < currentDay;
+
+    if (dayNumber === 1 && !isHistorical) {
         // Direct invitation to respond for Day 1 to reduce friction
         await sendTextMessage(
             user.phone,
@@ -329,31 +331,49 @@ export async function sendLessonDay(
                 : "🎙️ À toi de jouer ! Réponds à l'exercice ci-dessus par message vocal ou texte."
         );
     } else {
-        await sendInteractiveListMessage(
-            user.phone,
-            isWolof ? `Jour ${dayNumber}` : `Leçon ${dayNumber}`,
-            isWolof
-                ? "Seetee ci suuf ban jëf ngay def :"
-                : "Que veux-tu faire maintenant ?",
-            isWolof ? "Tànnal" : "Choisir",
-            [{
+        const sections = [];
+        
+        if (isHistorical) {
+            // MODE REPLAY: Just show the Refaire button
+            sections.push({
+                title: isWolof ? "Revoir" : "Revue",
+                rows: [{
+                    id: `DAY${dayNumber}_REPLAY`,
+                    title: isWolof ? `🎧 Refaire Bés ${dayNumber}` : `🎧 Refaire Leçon ${dayNumber}`,
+                    description: isWolof ? "Waxtu bi ci kaw" : "Réécouter la leçon"
+                }]
+            });
+        } else {
+            // MODE NOUVEAU: Let user answer or see history
+            sections.push({
                 title: isWolof ? "Jëfandikoo" : "Actions",
                 rows: [
-                    {
-                        id: `DAY${dayNumber}_REPLAY`,
-                        title: isWolof ? `🎧 Refaire Bés ${dayNumber}` : `🎧 Refaire Leçon ${dayNumber}`,
-                        description: isWolof ? "Waxtu bi ci kaw" : "Réécouter la leçon"
-                    },
                     {
                         id: `DAY${dayNumber}_EXERCISE`,
-                        title: isWolof ? "🎙️ Yónni tontu" : "🎙️ Répondre",
+                        title: isWolof ? "📝 Tontul exercice" : "📝 Répondre",
                         description: isWolof ? "Dëbb (vocal) walla mbind" : "Message vocal ou texte"
+                    },
+                    {
+                        id: `MENU_HISTORIQUE`,
+                        title: isWolof ? "📚 Li nekk ci ginnaaw" : "📚 Revoir anciennes leçons",
+                        description: isWolof ? "Seeti lu passé" : "Historique des leçons"
                     }
                 ]
-            }]
+            });
+        }
+
+        await sendInteractiveListMessage(
+            user.phone,
+            isWolof ? `Jour ${dayNumber}` : `Leçon ${dayNumber}`,
+            isWolof
+                ? "Seetee ci suuf ban jëf ngay def :"
+                : "Que veux-tu faire maintenant ?",
+            isWolof ? "Tànnal" : "Choisir",
+            sections
         );
     }
 
+
     // 🌟 4 & 5. Update User Progress and Enrollment.currentDay 🌟
     // ⚠️ Skipped when skipProgressUpdate=true (REPLAY of a historical lesson)
     if (!options?.skipProgressUpdate) {