feat: gold standards tests (15 days + STT + vision) & botName editable in AI setup

- ai-gold-standards: 40 test cases covering all 15 lesson days, STT smoke, vision
(day 11 imageUrl), CRM broadcast/conversation, curriculum (FR+EN), pitch deck EN,
business profile extraction days 1-6 with quality assertions
- AIAgentSetup: botName field now editable (was hardcoded 'Agent IA'); loaded from
personality API on mount, saved with PATCH; falls back to 'Agent IA' if blank
- i18n: add bot_name_label/placeholder/hint keys to FR, EN, ES, PT locales

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

apps/admin/src/locales/en.json

@@ -213,7 +213,10 @@
     "no_kb_hint": "Add your FAQs, pricing, or product sheets to activate the agent.",
     "stats_status_label": "Status",
     "stats_active_label": "Active",
-    "words_covered": "Words covered"
+    "words_covered": "Words covered",
+    "bot_name_label": "Agent name",
+    "bot_name_placeholder": "E.g. Kora, Awa, SupportBot...",
+    "bot_name_hint": "The name your agent will use to introduce itself on WhatsApp."
   },
   "livefeed": {
     "title": "Live Feed",

apps/admin/src/locales/es.json

@@ -335,7 +335,10 @@
     "no_kb_hint": "Agrega tus FAQ, tarifas o fichas de producto para activar el agente.",
     "stats_status_label": "Estado",
     "stats_active_label": "Activo",
-    "words_covered": "Palabras cubiertas"
+    "words_covered": "Palabras cubiertas",
+    "bot_name_label": "Nombre del agente",
+    "bot_name_placeholder": "Ej. Kora, Awa, SupportBot...",
+    "bot_name_hint": "El nombre que su agente usará para presentarse en WhatsApp."
   },
   "tracks": {
     "title": "Cursos",

apps/admin/src/locales/fr.json

@@ -335,7 +335,10 @@
     "no_kb_hint": "Ajoutez vos FAQ, tarifs ou fiches produit pour activer l'agent.",
     "stats_status_label": "Statut",
     "stats_active_label": "Actif",
-    "words_covered": "Mots couverts"
+    "words_covered": "Mots couverts",
+    "bot_name_label": "Nom de l'agent",
+    "bot_name_placeholder": "Ex: Kora, Awa, SupportBot...",
+    "bot_name_hint": "Le prénom que votre agent utilisera pour se présenter sur WhatsApp."
   },
   "tracks": {
     "title": "Parcours",

apps/admin/src/locales/pt.json

@@ -335,7 +335,10 @@
     "no_kb_hint": "Adicione as suas FAQs, preços ou fichas de produto para ativar o agente.",
     "stats_status_label": "Estado",
     "stats_active_label": "Ativo",
-    "words_covered": "Palavras cobertas"
+    "words_covered": "Palavras cobertas",
+    "bot_name_label": "Nome do agente",
+    "bot_name_placeholder": "Ex: Kora, Awa, SupportBot...",
+    "bot_name_hint": "O nome que seu agente usará para se apresentar no WhatsApp."
   },
   "tracks": {
     "title": "Cursos",

apps/admin/src/pages/AIAgentSetup.tsx

@@ -44,6 +44,7 @@ export default function AIAgentSetup() {
     const [uploadStatus, setUploadStatus] = useState<'IDLE' | 'UPLOADING' | 'SUCCESS' | 'ERROR'>('IDLE');
     const [uploadError, setUploadError] = useState('');
 
+    const [botName, setBotName] = useState('');
     const [role, setRole] = useState('');
     const [selectedTone, setSelectedTone] = useState<string>('Professionnel');
     const [recommendedTone, setRecommendedTone] = useState<string | null>(null);
@@ -81,6 +82,7 @@ export default function AIAgentSetup() {
                 if (!personality?.toneDescription) setSelectedTone(rec);
             }
             if (personality) {
+                setBotName(personality.botName || '');
                 setRole(personality.coreMission || '');
                 if (personality.toneDescription) setSelectedTone(personality.toneDescription);
                 setSelectedTemplateName(personality.notificationTemplateName || '');
@@ -129,7 +131,7 @@ export default function AIAgentSetup() {
         setSaveStatus('SAVING');
         try {
             await api.patch(`/v1/organizations/${selectedOrgId}/personality`, {
-                botName: 'Agent IA',
+                botName: botName.trim() || 'Agent IA',
                 coreMission: role,
                 toneDescription: selectedTone,
                 notificationTemplateName: selectedTemplateName || null,
@@ -235,6 +237,18 @@ export default function AIAgentSetup() {
                             <span>🧠</span> {t('ai_setup.personality_title')}
                         </h2>
                         <div className="space-y-4">
+                            <div>
+                                <label className="block text-sm font-medium text-slate-600 mb-1">{t('ai_setup.bot_name_label')}</label>
+                                <input
+                                    type="text"
+                                    value={botName}
+                                    onChange={e => setBotName(e.target.value)}
+                                    placeholder={t('ai_setup.bot_name_placeholder')}
+                                    maxLength={50}
+                                    className="w-full px-4 py-3 border border-slate-200 rounded-xl focus:ring-2 focus:ring-emerald-500 outline-none"
+                                />
+                                <p className="text-[11px] text-slate-400 mt-1.5">{t('ai_setup.bot_name_hint')}</p>
+                            </div>
                             <div>
                                 <label className="block text-sm font-medium text-slate-600 mb-1">{t('ai_setup.role_label')}</label>
                                 <input

apps/api/test/regression/ai-gold-standards.test.ts

@@ -1,6 +1,7 @@
 /**
  * Gold Standards — AI Regression Suite
- * Covers: feedback quality, lesson generation, CRM, multi-language, business profiling
+ * Covers: feedback quality, lesson generation (days 1-15), CRM, multi-language,
+ *         business profiling, curriculum, STT smoke test, vision feedback
  * Run: pnpm --filter api exec vitest run test/regression/ai-gold-standards.test.ts
  */
 import { describe, it, expect, beforeAll } from 'vitest';
@@ -10,8 +11,8 @@ import path from 'path';
 dotenv.config({ path: path.resolve(__dirname, '../../../.env') });
 
 const TIMEOUT = 45_000;
+const LONG_TIMEOUT = 75_000;
 
-// Shared service instance (dynamic import after dotenv)
 let ai: Awaited<ReturnType<typeof import('../../src/services/ai')>>['aiService'];
 
 beforeAll(async () => {
@@ -19,6 +20,27 @@ beforeAll(async () => {
     ai = mod.aiService;
 });
 
+// ---------------------------------------------------------------------------
+// Sample lesson content used across day coverage tests
+// ---------------------------------------------------------------------------
+const LESSONS: Record<number, string> = {
+    1:  "Bienvenue dans la formation. Aujourd'hui tu vas explorer ton idée de business et définir ton activité principale.",
+    2:  "Jour 2 : Identifie ton client idéal. Qui achète ton produit ? Quels sont ses problèmes quotidiens ?",
+    3:  "Jour 3 : Modèle de revenus. Comment gagnes-tu de l'argent ? Vente directe, abonnement, commission ?",
+    4:  "Jour 4 : Analyse de tes coûts. Quelles sont les charges fixes et variables de ton activité ?",
+    5:  "Jour 5 : Stratégie marketing. Comment attires-tu tes clients ? WhatsApp, bouche-à-oreille, réseaux ?",
+    6:  "Jour 6 : Concurrence. Qui sont tes concurrents directs ? Quelle est ta différence ?",
+    7:  "Jour 7 : Plan marketing complet. Définis ton budget communication et tes canaux prioritaires.",
+    8:  "Jour 8 : Communication client. Comment fidélises-tu tes acheteurs après la vente ?",
+    9:  "Jour 9 : Prévisions financières. Projette tes revenus sur les 3 prochains mois.",
+    10: "Jour 10 : Business plan simplifié. Consolide tous les éléments de ta stratégie.",
+    11: "Jour 11 : Ton équipe. Qui travaille avec toi ? Quelles compétences manquent dans ton équipe ?",
+    12: "Jour 12 : Le pitch. Présente ton projet en 2 minutes de manière convaincante.",
+    13: "Jour 13 : Revue complète. Analyse tes forces et tes axes d'amélioration.",
+    14: "Jour 14 : Plan d'action. Définis 3 objectifs SMART pour les 30 prochains jours.",
+    15: "Jour 15 : Certification. Tu as complété la formation. Fais le bilan de ton parcours.",
+};
+
 // ---------------------------------------------------------------------------
 // Feedback quality
 // ---------------------------------------------------------------------------
@@ -28,7 +50,7 @@ describe('Feedback — Language & Quality Guards', () => {
         const result = await ai.generateFeedback(
             'Damay jaay jus guir am xaliss ci Dakar',
             'Décris ton projet de vente.',
-            'Leçon sur le Business Model de vente directe.',
+            LESSONS[3],
             'WOLOF',
             { activityLabel: 'Vente de jus', region: 'Dakar' }
         );
@@ -45,7 +67,7 @@ describe('Feedback — Language & Quality Guards', () => {
         const result = await ai.generateFeedback(
             'Je vends des pagnes au marché',
             'Décris ton modèle économique.',
-            'Leçon Jour 3 — Modèle de revenus.',
+            LESSONS[3],
             'FR',
             { activityLabel: 'Commerce de pagnes', region: 'Thiès' }
         );
@@ -58,19 +80,37 @@ describe('Feedback — Language & Quality Guards', () => {
         const result = await ai.generateFeedback(
             'I sell handmade jewelry online',
             'Describe your revenue model.',
-            'Day 3 lesson — Revenue streams.',
+            LESSONS[3],
             'EN',
             { activityLabel: 'Jewelry', region: 'Abidjan' }
         );
         if (result.aiSource === 'MOCK') return;
         const text = result.validation.toLowerCase();
-        // Simple heuristic: should not start with common French phrases
         expect(text).not.toMatch(/^(bonjour|salut|bien)/);
     }, TIMEOUT);
+
+    it('Day 11 feedback with imageUrl: vision path does not crash', async () => {
+        const result = await ai.generateFeedback(
+            'Voici mon équipe : Fatou est chargée des ventes et Moussa gère la logistique.',
+            'Décris les membres de ton équipe.',
+            LESSONS[11],
+            'FR',
+            { activityLabel: 'Vente de vêtements', region: 'Dakar' }, // businessProfile
+            undefined,          // exerciseCriteria
+            'Vente de vêtements', // userActivity
+            'Dakar',            // userRegion
+            11,                 // dayNumber
+            undefined,          // previousResponses
+            false,              // isDeepDive
+            0,                  // iterationCount
+            'https://upload.wikimedia.org/wikipedia/commons/thumb/3/3f/Fronalpstock_big.jpg/800px-Fronalpstock_big.jpg' // imageUrl
+        );
+        expect(result.validation).toBeDefined();
+    }, TIMEOUT);
 });
 
 // ---------------------------------------------------------------------------
-// Business profile extraction
+// Business profile extraction — days 1-6
 // ---------------------------------------------------------------------------
 
 describe('Business Profile Extraction', () => {
@@ -87,41 +127,121 @@ describe('Business Profile Extraction', () => {
         expect(result.activityLabel.toLowerCase()).toMatch(/épicerie|commerce|alimentation|vente/);
     }, TIMEOUT);
 
-    it('Day 2 — extracts region from context', async () => {
-        const result = await ai.extractBusinessProfile('Je travaille à Saint-Louis du Sénégal', 2, 'FR');
+    it('Day 2 — extracts customer profile from French input', async () => {
+        const result = await ai.extractBusinessProfile('Mes clients sont des femmes qui cherchent des tontines en ligne', 2, 'FR');
+        if (result.aiSource === 'MOCK') return;
+        expect(result).toBeDefined();
+        expect(result.mainCustomer).toBeTruthy();
+    }, TIMEOUT);
+
+    it('Day 3 — revenue model extraction', async () => {
+        const result = await ai.extractBusinessProfile('Je vends mes services en forfait mensuel à 15 000 FCFA', 3, 'FR');
+        if (result.aiSource === 'MOCK') return;
+        expect(result).toBeDefined();
+    }, TIMEOUT);
+
+    it('Day 4 — cost analysis extraction', async () => {
+        const result = await ai.extractBusinessProfile('Mon loyer est 50 000 FCFA et matières premières 20 000 FCFA par mois', 4, 'FR');
+        if (result.aiSource === 'MOCK') return;
+        expect(result).toBeDefined();
+    }, TIMEOUT);
+
+    it('Day 5 — marketing channel extraction', async () => {
+        const result = await ai.extractBusinessProfile("J'utilise WhatsApp et les marchés hebdomadaires pour attirer des clients", 5, 'FR');
+        if (result.aiSource === 'MOCK') return;
+        expect(result).toBeDefined();
+    }, TIMEOUT);
+
+    it('Day 6 — competitive analysis extraction', async () => {
+        const result = await ai.extractBusinessProfile("Il y a 3 boutiques similaires dans mon quartier mais elles ne livrent pas", 6, 'FR');
         if (result.aiSource === 'MOCK') return;
         expect(result).toBeDefined();
     }, TIMEOUT);
 });
 
 // ---------------------------------------------------------------------------
-// Personalized lesson generation
+// Personalized lesson generation — days 1-15
 // ---------------------------------------------------------------------------
 
-describe('Lesson Generation — Personalization', () => {
-    it('generates lesson for Jour 3 (modèle de revenus) with correct structure', async () => {
+describe('Lesson Generation — Full Day Coverage', () => {
+    const userActivity = 'Vente de beignets';
+
+    for (const [dayStr, lessonText] of Object.entries(LESSONS)) {
+        const day = Number(dayStr);
+        it(`Day ${day} — personalizes lesson in FR`, async () => {
+            const result = await ai.generatePersonalizedLesson(
+                lessonText,
+                userActivity,
+                'FR'
+            );
+            expect(result.lessonText).toBeDefined();
+            if (result.aiSource === 'MOCK') return;
+            expect(result.lessonText.length).toBeGreaterThan(20);
+        }, TIMEOUT);
+    }
+
+    it('Day 7 — personalizes lesson in WOLOF', async () => {
         const result = await ai.generatePersonalizedLesson(
-            3,
-            { activityLabel: 'Vente de beignets', region: 'Dakar', language: 'FR' },
+            LESSONS[7],
+            'Couture traditionnelle',
+            'WOLOF'
+        );
+        expect(result.lessonText).toBeDefined();
+    }, TIMEOUT);
+
+    it('Day 3 — lesson references user activity', async () => {
+        const result = await ai.generatePersonalizedLesson(
+            LESSONS[3],
+            'Atelier de couture',
             'FR'
         );
-        expect(result).toBeDefined();
         if (result.aiSource === 'MOCK') return;
-        // Lesson should reference the user's activity
-        const text = JSON.stringify(result).toLowerCase();
-        expect(text).toMatch(/beignet|vente|revenu/);
+        // The personalized lesson should acknowledge the activity domain
+        expect(result.lessonText.toLowerCase()).toMatch(/couture|vêtement|tissu|atelier|revenu/);
     }, TIMEOUT);
 
-    it('generates lesson for Jour 7 (stratégie marketing) in Wolof', async () => {
+    it('Day 15 — lesson with previous responses context', async () => {
         const result = await ai.generatePersonalizedLesson(
-            7,
-            { activityLabel: 'Couture traditionnelle', region: 'Thiès', language: 'WOLOF' },
-            'WOLOF'
+            LESSONS[15],
+            'Livraison de repas',
+            'FR',
+            [
+                { day: 1, response: "Je livre des plats cuisinés à domicile" },
+                { day: 3, response: "Je facture 3 000 FCFA par livraison" },
+            ]
         );
-        expect(result).toBeDefined();
+        expect(result.lessonText).toBeDefined();
     }, TIMEOUT);
 });
 
+// ---------------------------------------------------------------------------
+// Curriculum generation
+// ---------------------------------------------------------------------------
+
+describe('Curriculum Generation', () => {
+    it('generates 5-day curriculum for a Dakar market', async () => {
+        const result = await ai.generateCurriculum(
+            'Formation à la vente et au digital pour commerçantes de Dakar',
+            5,
+            'FR',
+            'Femmes entrepreneures, marché informel'
+        );
+        expect(result.days).toHaveLength(5);
+        expect(result.days[0]).toHaveProperty('title');
+        expect(result.days[0]).toHaveProperty('content');
+    }, LONG_TIMEOUT);
+
+    it('generates 10-day curriculum in English', async () => {
+        const result = await ai.generateCurriculum(
+            'Digital marketing fundamentals for SME owners in Abidjan',
+            10,
+            'EN',
+            'Small business owners, 25-45 years'
+        );
+        expect(result.days).toHaveLength(10);
+    }, LONG_TIMEOUT);
+});
+
 // ---------------------------------------------------------------------------
 // CRM — campaign & broadcast
 // ---------------------------------------------------------------------------
@@ -136,7 +256,7 @@ describe('CRM — Campaign Generation', () => {
     }, TIMEOUT);
 
     it('generates broadcast message in campaign format', async () => {
-        const result = await ai.generateBroadcastMessage('Invite tous les contacts à notre webinaire gratuit sur l\'entrepreneuriat féminin');
+        const result = await ai.generateBroadcastMessage("Invite tous les contacts à notre webinaire gratuit sur l'entrepreneuriat féminin");
         expect(result.text).toBeDefined();
         expect(['campaign', 'support']).toContain(result.type);
     }, TIMEOUT);
@@ -149,10 +269,18 @@ describe('CRM — Campaign Generation', () => {
         );
         expect(result.message).toBeDefined();
         if (result.aiSource === 'MOCK') return;
-        // Should guide toward importing
         const text = result.message.toLowerCase();
         expect(text).toMatch(/import|fichier|liste|contact/);
     }, TIMEOUT);
+
+    it('CRM conversation: responds to broadcast request', async () => {
+        const result = await ai.handleCrmConversation(
+            "Je veux envoyer un message promotionnel à tous mes clients",
+            [],
+            { hasContactList: true, contactCount: 150 }
+        );
+        expect(result.message).toBeDefined();
+    }, TIMEOUT);
 });
 
 // ---------------------------------------------------------------------------
@@ -166,7 +294,7 @@ describe('Pitch Deck & One-Pager', () => {
             'FR'
         );
         expect(result.slides).toHaveLength(13);
-    }, 60_000);
+    }, LONG_TIMEOUT);
 
     it('one-pager: returns expected top-level keys', async () => {
         const result = await ai.generateOnePagerData(
@@ -176,10 +304,46 @@ describe('Pitch Deck & One-Pager', () => {
         expect(result).toHaveProperty('summary');
         expect(result).toHaveProperty('sections');
     }, TIMEOUT);
+
+    it('pitch deck: generated in English', async () => {
+        const result = await ai.generatePitchDeckData(
+            'Mobile payment solution for informal traders in West Africa.',
+            'EN'
+        );
+        expect(result.slides).toHaveLength(13);
+        if (result.aiSource === 'MOCK') return;
+        expect(JSON.stringify(result.slides).toLowerCase()).toMatch(/market|revenue|product|team/);
+    }, LONG_TIMEOUT);
 });
 
 // ---------------------------------------------------------------------------
-// Free text generation (generic guard)
+// STT smoke test (skipped if no real audio — requires OPENAI_API_KEY)
+// ---------------------------------------------------------------------------
+
+describe('Audio Transcription — STT Smoke', () => {
+    it('transcribeAudio: returns defined result or throws provider error (not crash)', async () => {
+        if (!process.env.OPENAI_API_KEY) {
+            console.log('[SKIP] OPENAI_API_KEY not set — skipping STT smoke test');
+            return;
+        }
+        // Minimal silent OGG/Opus frame (24 bytes header) — Whisper will return empty string, not crash
+        const silentOgg = Buffer.from(
+            '4f67675300020000000000000000a2a2a21e00000000000000000000000000',
+            'hex'
+        );
+        try {
+            const result = await ai.transcribeAudio(silentOgg, 'test.ogg', 'fr');
+            // Either returns empty transcription or throws a provider error — both are acceptable
+            expect(result).toBeDefined();
+        } catch (err: any) {
+            // Provider-level error (invalid audio) is acceptable; a crash/unhandled rejection is not
+            expect(err.message).toBeDefined();
+        }
+    }, TIMEOUT);
+});
+
+// ---------------------------------------------------------------------------
+// Free text generation
 // ---------------------------------------------------------------------------
 
 describe('generateText — safety & format', () => {
@@ -190,4 +354,14 @@ describe('generateText — safety & format', () => {
         );
         expect(result.text.trim().length).toBeGreaterThan(5);
     }, TIMEOUT);
+
+    it('responds to English prompt in English', async () => {
+        const result = await ai.generateText(
+            'You are a business coach.',
+            'Give me one sales tip in one sentence.'
+        );
+        if (result.aiSource === 'MOCK') return;
+        expect(result.text.trim().length).toBeGreaterThan(5);
+        expect(result.text.toLowerCase()).not.toMatch(/^(bonjour|salut)/);
+    }, TIMEOUT);
 });