pabal-web-mcp 1.4.5 → 1.4.6

package/dist/bin/mcp-server.js

@@ -1620,16 +1620,35 @@ ${primaryResearchSections.join("\n")}
 
 `;
   }
+  const { keywordResearchFallbackByLocale } = args;
   nonPrimaryLocales.forEach((loc) => {
     const researchSections = keywordResearchByLocale[loc] || [];
     const researchDir = keywordResearchDirByLocale[loc];
+    const fallbackInfo = keywordResearchFallbackByLocale?.[loc];
     if (researchSections.length > 0) {
-      prompt += `### Locale ${loc}: \u2705 Saved research found
+      if (fallbackInfo?.isFallback && fallbackInfo.fallbackLocale) {
+        prompt += `### Locale ${loc}: \u{1F504} Using ${fallbackInfo.fallbackLocale} keywords as fallback - MUST TRANSLATE TO ${loc.toUpperCase()}
+`;
+        prompt += researchSections.join("\n");
+        prompt += `
+
+**CRITICAL:** The keywords above are in ${fallbackInfo.fallbackLocale}. You MUST:
+`;
+        prompt += `1. **TRANSLATE each keyword into ${loc}** - use natural, native expressions
+`;
+        prompt += `2. Ensure translated keywords are what ${loc} users would actually search for
+`;
+        prompt += `3. **DO NOT use ${fallbackInfo.fallbackLocale} keywords directly** - all keywords must be in ${loc} language
+
+`;
+      } else {
+        prompt += `### Locale ${loc}: \u2705 Saved research found (locale-specific)
 ${researchSections.join(
-        "\n"
-      )}
+          "\n"
+        )}
 
 `;
+      }
     } else if (hasPrimaryResearch) {
       prompt += `### Locale ${loc}: \u26A0\uFE0F No saved research - TRANSLATE ENGLISH KEYWORDS TO ${loc.toUpperCase()}
 `;
@@ -2130,7 +2149,7 @@ function formatMergedData(merged, researchDir) {
   lines.push("\n----");
   return lines.join("\n");
 }
-function loadKeywordResearchForLocale(slug, locale) {
+function loadKeywordResearchForLocaleInternal(slug, locale) {
   const researchDir = path6.join(
     getKeywordResearchDir(),
     "products",
@@ -2139,9 +2158,12 @@ function loadKeywordResearchForLocale(slug, locale) {
     locale
   );
   if (!fs6.existsSync(researchDir)) {
-    return { entries: [], sections: [], researchDir };
+    return null;
   }
   const files = fs6.readdirSync(researchDir).filter((file) => file.endsWith(".json"));
+  if (files.length === 0) {
+    return null;
+  }
   const entries = [];
   for (const file of files) {
     const filePath = path6.join(researchDir, file);
@@ -2159,17 +2181,53 @@ function loadKeywordResearchForLocale(slug, locale) {
     }
   }
   const validEntries = entries.filter((e) => !e.data?.parseError);
+  if (validEntries.length === 0) {
+    return null;
+  }
   if (validEntries.length > 1) {
     const merged = mergeKeywordData(validEntries);
     const mergedSection = formatMergedData(merged, researchDir);
     return { entries, sections: [mergedSection], researchDir };
-  } else if (validEntries.length === 1) {
-    const sections2 = entries.map(formatEntry);
-    return { entries, sections: sections2, researchDir };
   }
   const sections = entries.map(formatEntry);
   return { entries, sections, researchDir };
 }
+var FALLBACK_LOCALES = ["en-US", "en"];
+function loadKeywordResearchForLocale(slug, locale) {
+  const researchDir = path6.join(
+    getKeywordResearchDir(),
+    "products",
+    slug,
+    "locales",
+    locale
+  );
+  const result = loadKeywordResearchForLocaleInternal(slug, locale);
+  if (result) {
+    return { ...result, isFallback: false };
+  }
+  for (const fallbackLocale of FALLBACK_LOCALES) {
+    if (fallbackLocale === locale) continue;
+    const fallbackResult = loadKeywordResearchForLocaleInternal(
+      slug,
+      fallbackLocale
+    );
+    if (fallbackResult) {
+      const fallbackNotice = `\u26A0\uFE0F **FALLBACK: Using ${fallbackLocale} keywords** - No research found for ${locale}. You MUST TRANSLATE these keywords to ${locale}.
+`;
+      const sectionsWithNotice = fallbackResult.sections.map(
+        (section) => fallbackNotice + section
+      );
+      return {
+        entries: fallbackResult.entries,
+        sections: sectionsWithNotice,
+        researchDir: fallbackResult.researchDir,
+        isFallback: true,
+        fallbackLocale
+      };
+    }
+  }
+  return { entries: [], sections: [], researchDir, isFallback: false };
+}
 
 // src/tools/improve-public.ts
 var toJsonSchema3 = zodToJsonSchema3;
@@ -2279,10 +2337,15 @@ async function handleImprovePublic(input) {
   }
   const keywordResearchByLocale = {};
   const keywordResearchDirByLocale = {};
+  const keywordResearchFallbackByLocale = {};
   for (const loc of targetLocales) {
     const research = loadKeywordResearchForLocale(slug, loc);
     keywordResearchByLocale[loc] = research.sections;
     keywordResearchDirByLocale[loc] = research.researchDir;
+    keywordResearchFallbackByLocale[loc] = {
+      isFallback: research.isFallback,
+      fallbackLocale: research.fallbackLocale
+    };
   }
   const baseArgs = {
     slug,
@@ -2291,7 +2354,8 @@ async function handleImprovePublic(input) {
     targetLocales,
     localeSections,
     keywordResearchByLocale,
-    keywordResearchDirByLocale
+    keywordResearchDirByLocale,
+    keywordResearchFallbackByLocale
   };
   if (stage === "1" || stage === "both") {
     const prompt = generatePrimaryOptimizationPrompt(baseArgs);
@@ -2339,6 +2403,7 @@ async function handleImprovePublic(input) {
         localeSections: baseArgs.localeSections,
         keywordResearchByLocale: baseArgs.keywordResearchByLocale,
         keywordResearchDirByLocale: baseArgs.keywordResearchDirByLocale,
+        keywordResearchFallbackByLocale: baseArgs.keywordResearchFallbackByLocale,
         optimizedPrimary,
         batchLocales,
         batchIndex: currentBatchIndex,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pabal-web-mcp",
-  "version": "1.4.5",
+  "version": "1.4.6",
   "type": "module",
   "description": "MCP server for ASO data management with shared types and utilities",
   "author": "skyu",