Fix Arabic brand spelling by normalizing incorrect variants in AI replies and strengthen system prompt guidance

app/ai/orchestrator.py

@@ -1,5 +1,6 @@
 import json
 import logging
+import re
 from typing import Any
 
 from app.ai.providers import (
@@ -120,7 +121,7 @@ class AIOrchestrator:
                 temperature=temperature,
             )
             if not response.tool_calls:
-                content = (response.content or "").strip()
+                content = _normalize_brand_name((response.content or "").strip())
                 if content:
                     return content
                 raise RetryableProviderError(f"{provider.name} returned an empty response")
@@ -163,6 +164,26 @@ def _assistant_tool_message(response: AIProviderResponse) -> dict[str, Any]:
     }
 
 
+def _normalize_brand_name(text: str) -> str:
+    if not text:
+        return text
+
+    replacements = {
+        "فلسا": "فلزة",
+        "فلظ": "فلزة",
+        "فلظة": "فلزة",
+        "فلز": "فلزة",
+        "فلِزة": "فلزة",
+        "فلَزة": "فلزة",
+        "فلٰزة": "فلزة",
+    }
+
+    for wrong, correct in sorted(replacements.items(), key=lambda item: -len(item[0])):
+        pattern = rf"(?<![\w\u0600-\u06FF]){re.escape(wrong)}(?![\w\u0600-\u06FF])"
+        text = re.sub(pattern, correct, text)
+    return text
+
+
 async def _execute_tool_call(registry: ToolRegistry, tool_call: ToolCall) -> ToolResult:
     try:
         arguments = json.loads(tool_call.arguments or "{}")

prompts/system.md

@@ -1,7 +1,8 @@
-You are FALZH, a WhatsApp travel booking assistant.
+You are FALZH | فلزة, a WhatsApp travel booking assistant.
 
 Rules:
 - Reply in sender's language (Arabic/English). Be concise, warm, practical.
+- When writing in Arabic, the brand name must always be spelled exactly "فلزة" (ف-ل-ز-ا). Never use "فلسا", "فلظ", "فلظة", "فلز", or any other variant.
 - For new users: be extra warm and welcoming. Greet them, introduce FALZH briefly, and guide them to their first action.
 - Use `about_falzh` for company/FAQ/policy/pricing/support.
 - Tool args: Arabic for departure/destination/vehicle_type/time labels. English for digits/times.

prompts/system_new_user.md

@@ -8,4 +8,4 @@ It is the sender's first message. Welcome them warmly and introduce FALZH with a
 4. Use emojis (🚗, 🚚, etc.) and friendly tone. Be warm, not robotic.
 5. Keep it short — 4-5 lines max. Do not over-explain.
 6. Never ask for name of a passenger. Only ask for name if they want to become a driver.
-7. The brand name is ALWAYS "فلزة" (ف-ل-ز-ا) — never "فلسا" or any other variant.
+7. The brand name is ALWAYS "فلزة" (ف-ل-ز-ا) — never "فلسا", "فلظ", "فلظة", "فلز", or any other variant.

tests/test_ai_orchestrator.py

@@ -109,6 +109,24 @@ async def test_ai_executes_tool_call_and_returns_final_response():
     assert '"ok": true' in second_call_messages[-1]["content"]
 
 
+@pytest.mark.asyncio
+async def test_ai_normalizes_incorrect_arabic_brand_spelling():
+    primary = ScriptedProvider(
+        "groq",
+        [AIProviderResponse(content="أهلاً بك في فلظ! أتمنى أحجز لك رحلة.")],
+    )
+    orchestrator = AIOrchestrator(
+        primary=primary,
+        fallback=ScriptedProvider("openrouter", []),
+        temperature=0.2,
+        max_tool_iterations=3,
+    )
+
+    reply = await orchestrator.generate_reply(messages=[], tools=[], registry=ToolRegistry())
+
+    assert reply == "أهلاً بك في فلزة! أتمنى أحجز لك رحلة."
+
+
 @pytest.mark.asyncio
 async def test_ai_reports_invalid_tool_arguments_to_model():
     primary = ScriptedProvider(