refactor: Address code review feedback

- Add comment explaining fallback config matches site-config.ts defaults
- Only show missing translation warnings in development mode
- Improve code quality and production readiness

Co-authored-by: huangyiirene <[email protected]>

Author: Copilot

packages/cli/src/utils/translate.mjs

@@ -11,6 +11,7 @@ function loadSiteConfig() {
 
   if (!fs.existsSync(configPath)) {
     console.warn(`Warning: docs.site.json not found at ${configPath}, using defaults`);
+    // Fallback matches the default configuration in packages/site/lib/site-config.ts
     return {
       i18n: {
         enabled: true,

packages/site/lib/translations.ts

@@ -88,7 +88,10 @@ export function getTranslations(): Record<string, LanguageTranslations> {
       translations[lang] = defaultTranslations[lang];
     } else {
       // If no translation exists for a configured language, provide a minimal fallback
-      console.warn(`Warning: No translations found for language "${lang}". Using minimal fallback.`);
+      // Only log warning in development
+      if (process.env.NODE_ENV === 'development') {
+        console.warn(`Warning: No translations found for language "${lang}". Using minimal fallback.`);
+      }
       translations[lang] = {
         displayName: lang.toUpperCase(),
       };