pabal-web-mcp 1.4.2 → 1.4.4

package/dist/bin/mcp-server.js

@@ -517,6 +517,19 @@ function convertToMultilingual(data, locale) {
 // src/tools/public-to-aso.ts
 import fs4 from "fs";
 var FIELD_LIMITS_DOC_PATH = "docs/aso/ASO_FIELD_LIMITS.md";
+var APP_STORE_LIMITS = {
+  name: 30,
+  subtitle: 30,
+  keywords: 100,
+  promotionalText: 170,
+  description: 4e3,
+  whatsNew: 4e3
+};
+var GOOGLE_PLAY_LIMITS = {
+  title: 50,
+  shortDescription: 80,
+  fullDescription: 4e3
+};
 var toJsonSchema2 = zodToJsonSchema2;
 var publicToAsoInputSchema = z2.object({
   slug: z2.string().describe("Product slug"),
@@ -527,6 +540,51 @@ var jsonSchema2 = toJsonSchema2(publicToAsoInputSchema, {
   $refStrategy: "none"
 });
 var inputSchema2 = jsonSchema2.definitions?.PublicToAsoInput || jsonSchema2;
+function validateFieldLimits(configData) {
+  const issues = [];
+  if (configData.appStore) {
+    const appStoreData = configData.appStore;
+    const locales = isAppStoreMultilingual(appStoreData) ? appStoreData.locales : { [appStoreData.locale || DEFAULT_LOCALE]: appStoreData };
+    for (const [locale, data] of Object.entries(locales)) {
+      const { name, subtitle, keywords, promotionalText, description, whatsNew } = data;
+      const push = (field, value, limit) => {
+        if (typeof value === "string" && value.length > limit) {
+          issues.push(
+            `App Store [${locale}].${field}: ${value.length}/${limit}`
+          );
+        }
+      };
+      push("name", name, APP_STORE_LIMITS.name);
+      push("subtitle", subtitle, APP_STORE_LIMITS.subtitle);
+      push("keywords", keywords, APP_STORE_LIMITS.keywords);
+      push("promotionalText", promotionalText, APP_STORE_LIMITS.promotionalText);
+      push("description", description, APP_STORE_LIMITS.description);
+      push("whatsNew", whatsNew, APP_STORE_LIMITS.whatsNew);
+    }
+  }
+  if (configData.googlePlay) {
+    const googlePlayData = configData.googlePlay;
+    const locales = isGooglePlayMultilingual(googlePlayData) ? googlePlayData.locales : { [googlePlayData.defaultLanguage || DEFAULT_LOCALE]: googlePlayData };
+    for (const [locale, data] of Object.entries(locales)) {
+      const { title, shortDescription, fullDescription } = data;
+      const push = (field, value, limit) => {
+        if (typeof value === "string" && value.length > limit) {
+          issues.push(
+            `Google Play [${locale}].${field}: ${value.length}/${limit}`
+          );
+        }
+      };
+      push("title", title, GOOGLE_PLAY_LIMITS.title);
+      push(
+        "shortDescription",
+        shortDescription,
+        GOOGLE_PLAY_LIMITS.shortDescription
+      );
+      push("fullDescription", fullDescription, GOOGLE_PLAY_LIMITS.fullDescription);
+    }
+  }
+  return issues;
+}
 async function downloadScreenshotsToAsoDir(slug, asoData) {
   const rootDir = getPushDataDir();
   const productStoreRoot = path4.join(rootDir, "products", slug, "store");
@@ -672,6 +730,7 @@ This tool:
 2. Converts to store-compatible format (removes screenshots from metadata, sets contactWebsite/marketingUrl)
 3. Saves metadata to .aso/pushData/products/[slug]/store/ (path from ~/.config/pabal-mcp/config.json dataDir)
 4. Copies/downloads screenshots to .aso/pushData/products/[slug]/store/screenshots/
+5. Validates text field lengths against ${FIELD_LIMITS_DOC_PATH} (fails if over limits)
 
 Before running, review ${FIELD_LIMITS_DOC_PATH} for per-store limits. This prepares data for pushing to stores without actually uploading.`,
   inputSchema: inputSchema2
@@ -761,6 +820,11 @@ Possible causes:
     );
   }
   const storeData = prepareAsoDataForPush(slug, configData);
+  const validationIssues = validateFieldLimits(configData);
+  const validationMessage = validationIssues.length > 0 ? `\u26A0\uFE0F Field limit issues (see ${FIELD_LIMITS_DOC_PATH}):
+- ${validationIssues.join(
+    "\n- "
+  )}` : `Field limits OK (checked against ${FIELD_LIMITS_DOC_PATH})`;
   const pushDataRoot = getPushDataDir();
   if (dryRun) {
     return {
@@ -773,11 +837,19 @@ ${JSON.stringify(
             storeData,
             null,
             2
-          )}`
+          )}
+
+${validationMessage}`
         }
       ]
     };
   }
+  if (validationIssues.length > 0) {
+    throw new Error(
+      `Field limit violations detected. Fix before pushing.
+${validationMessage}`
+    );
+  }
   saveRawAsoData(slug, storeData);
   await downloadScreenshotsToAsoDir(slug, configData);
   const localeCounts = {};
@@ -1314,10 +1386,10 @@ ${researchSections.join("\n")}
   prompt += `**CRITICAL**: You MUST include the complete \`landing\` object in your optimized JSON output.
 
 `;
-  prompt += `## Step 3: Validate
+  prompt += `## Step 3: Validate (after applying all keywords)
 
 `;
-  prompt += `Check all limits: title \u226430, subtitle \u226430, shortDescription \u226480, keywords \u2264100, intro \u2264300, outro \u2264200
+  prompt += `Check all limits using ${FIELD_LIMITS_DOC_PATH2}: title \u226430, subtitle \u226430, shortDescription \u226480, keywords \u2264100, intro \u2264300, outro \u2264200
 `;
   prompt += `- Remove keyword duplicates (unique list; avoid repeating title/subtitle terms verbatim)
 `;
@@ -1434,9 +1506,9 @@ function generateKeywordLocalizationPrompt(args) {
 `;
   prompt += `1. Use SAVED keyword research (see per-locale data below). Do NOT invent keywords.
 `;
-  prompt += `2. Replace keywords in translated content (preserve structure/tone/context)
+  prompt += `2. **Replace ONLY keywords with optimized keywords** - keep ALL existing content, structure, tone, and context unchanged. Only swap keywords for better ASO keywords.
 `;
-  prompt += `3. Validate character limits + store rules (${FIELD_LIMITS_DOC_PATH2}) + keyword duplication
+  prompt += `3. After all keywords are applied, validate character limits + store rules (${FIELD_LIMITS_DOC_PATH2}) + keyword duplication
 `;
   prompt += `4. **SAVE the updated JSON to file** using the save-locale-file tool (only if file exists)
 
@@ -1520,18 +1592,21 @@ ${researchSections.join(
   });
   prompt += `## Keyword Replacement Strategy
 
+`;
+  prompt += `**CRITICAL: Keep ALL existing content unchanged. Only replace keywords with optimized keywords.**
+
 `;
   prompt += `For EACH locale:
 `;
   prompt += `- Priority: Keep iOS-sourced keywords first; add Android keywords only if there is remaining space after iOS keywords fit within field limits.
 `;
-  prompt += `1. Take the TRANSLATED content (below)
+  prompt += `1. Take the EXISTING translated content (below) - **DO NOT change the content itself**
 `;
-  prompt += `2. Replace \`aso.keywords\` array with new 10 keywords
+  prompt += `2. Replace \`aso.keywords\` array with optimized keywords (keep same count/structure)
 `;
   prompt += `3. **TITLE FORMAT**: \`aso.title\` must follow **"App Name: Primary Keyword"** format:
 `;
-  prompt += `   - App name: **ALWAYS in English** (e.g., "Aurora EOS", "Timeline", "Recaply")
+  prompt += `   - App name: **ALWAYS in English** (e.g., "Aurora EOS", "Timeline", "Recaply)
 `;
   prompt += `   - Primary keyword: **In target language** (e.g., "\uC624\uB85C\uB77C \uC608\uBCF4" for Korean, "\u30AA\u30FC\u30ED\u30E9\u4E88\u5831" for Japanese)
 `;
@@ -1540,52 +1615,56 @@ ${researchSections.join(
   prompt += `   - The keyword after the colon must start with an uppercase letter
 `;
   prompt += `   - **Do NOT translate/rename the app name**; keep the original English app name across all locales.
+`;
+  prompt += `   - **Only replace the keyword part** - keep the app name and format structure unchanged
 `;
   prompt += `4. Deduplicate keywords: final \`aso.keywords\` must be unique and should not repeat title/subtitle terms verbatim
 `;
-  prompt += `5. Swap keywords in sentences while keeping:
+  prompt += `5. **Replace keywords in existing sentences** - swap ONLY the keywords, keep everything else:
 `;
-  prompt += `   - Original sentence structure
+  prompt += `   - **Keep original sentence structure exactly as is**
 `;
-  prompt += `   - Tone and messaging
+  prompt += `   - **Keep original tone and messaging unchanged**
 `;
-  prompt += `   - Context and flow
+  prompt += `   - **Keep original context and flow unchanged**
 `;
-  prompt += `   - Character limits
+  prompt += `   - **Only swap individual keywords** for better ASO keywords
+`;
+  prompt += `   - Maintain character limits
 
 `;
-  prompt += `6. **CRITICAL**: Update ALL \`landing\` sections:
+  prompt += `6. **CRITICAL**: Update keywords in ALL \`landing\` sections (replace keywords only, keep content structure):
 `;
-  prompt += `   - \`landing.hero.title\` and \`landing.hero.description\`: Include keywords naturally
+  prompt += `   - \`landing.hero.title\` and \`landing.hero.description\`: Replace keywords only, keep existing text structure
 `;
-  prompt += `   - \`landing.screenshots.images[].title\`: Incorporate keywords in all screenshot titles
+  prompt += `   - \`landing.screenshots.images[].title\`: Replace keywords in existing titles, keep structure
 `;
-  prompt += `   - \`landing.screenshots.images[].description\`: Include keywords in all screenshot descriptions
+  prompt += `   - \`landing.screenshots.images[].description\`: Replace keywords in existing descriptions, keep structure
 `;
-  prompt += `   - \`landing.features.items[].title\`: Add keywords to feature titles where natural
+  prompt += `   - \`landing.features.items[].title\`: Replace keywords in existing titles, keep structure
 `;
-  prompt += `   - \`landing.features.items[].body\`: Weave keywords into feature descriptions
+  prompt += `   - \`landing.features.items[].body\`: Replace keywords in existing descriptions, keep structure
 `;
-  prompt += `   - \`landing.reviews.title\` and \`landing.reviews.description\`: Include keywords if applicable
+  prompt += `   - \`landing.reviews.title\` and \`landing.reviews.description\`: Replace keywords if applicable, keep structure
 `;
-  prompt += `   - \`landing.cta.headline\` and \`landing.cta.description\`: Include keywords if applicable
+  prompt += `   - \`landing.cta.headline\` and \`landing.cta.description\`: Replace keywords if applicable, keep structure
 `;
-  prompt += `   - Maintain original context and meaning
+  prompt += `   - **Maintain ALL original context, meaning, and structure**
 `;
-  prompt += `   - Use language-specific terms that users actually search for
+  prompt += `   - Use optimized keywords that users actually search for
 `;
-  prompt += `   - **DO NOT leave any landing fields in English** - all must be translated
+  prompt += `   - **DO NOT rewrite or restructure content** - only replace keywords
 
 `;
-  prompt += `**Example**:
+  prompt += `**Example** (keyword replacement only, content unchanged):
 `;
   prompt += `- Original: "Track aurora with real-time forecasts"
 `;
-  prompt += `- Korean keywords: \uC624\uB85C\uB77C, \uC608\uBCF4, \uC2E4\uC2DC\uAC04
+  prompt += `- Optimized keywords: \uC624\uB85C\uB77C, \uC608\uBCF4, \uC2E4\uC2DC\uAC04
 `;
-  prompt += `- Result: "\uC2E4\uC2DC\uAC04 \uC608\uBCF4\uB85C \uC624\uB85C\uB77C \uCD94\uC801"
+  prompt += `- Result: "Track \uC624\uB85C\uB77C with \uC2E4\uC2DC\uAC04 \uC608\uBCF4" (keywords replaced, structure kept)
 `;
-  prompt += `  (structure changed for Korean, but context preserved)
+  prompt += `  OR: "\uC2E4\uC2DC\uAC04 \uC608\uBCF4\uB85C \uC624\uB85C\uB77C \uCD94\uC801" (if natural keyword placement requires minor word order, but keep meaning identical)
 
 `;
   prompt += `## Current Translated Locales (This Batch)
@@ -1606,7 +1685,7 @@ ${researchSections.join(
 `;
   prompt += `1. Use saved keyword research (in target language) OR **TRANSLATE English keywords from primary locale** if missing (see fallback strategy above - MUST translate, not use English directly)
 `;
-  prompt += `2. Replace keywords in ALL fields (use translated keywords in target language):
+  prompt += `2. **Replace keywords ONLY** in ALL fields (keep existing content structure unchanged):
 `;
   prompt += `   - \`aso.keywords\` array
 `;
@@ -1622,11 +1701,11 @@ ${researchSections.join(
 `;
   prompt += `   - \`landing.reviews.title\` and \`landing.reviews.description\`
 `;
-  prompt += `   - \`landing.cta.headline\` and \`landing.cta.description\`
+  prompt += `   - **For each field: Replace keywords only, keep existing content structure and meaning unchanged**
 `;
   prompt += `3. **CRITICAL**: Ensure ALL landing fields are translated (not English)
 `;
-  prompt += `4. Validate limits + store rules (${FIELD_LIMITS_DOC_PATH2}) + keyword duplication (unique list; avoid repeating title/subtitle terms verbatim)
+  prompt += `4. After swapping keywords, validate limits + store rules (${FIELD_LIMITS_DOC_PATH2}) + keyword duplication (unique list; avoid repeating title/subtitle terms verbatim)
 `;
   prompt += `5. **SAVE the updated JSON to file** using save-locale-file tool
 `;
@@ -1669,23 +1748,27 @@ ${researchSections.join(
   prompt += `   - Show final 10 keywords **IN TARGET LANGUAGE** with tier assignments - DO NOT show English keywords
 
 `;
-  prompt += `**2. Updated JSON** (complete locale structure with keyword replacements)
+  prompt += `**2. Updated JSON** (complete locale structure with keyword replacements only)
+`;
+  prompt += `   - **CRITICAL**: Keep ALL existing content structure and meaning unchanged - only replace keywords
 `;
-  prompt += `   - MUST include complete \`aso\` object
+  prompt += `   - MUST include complete \`aso\` object (keywords replaced, content structure kept)
 `;
-  prompt += `   - MUST include complete \`landing\` object with ALL sections:
+  prompt += `   - MUST include complete \`landing\` object with ALL sections (keywords replaced, content structure kept):
 `;
-  prompt += `     * hero (title, description, titleHighlight)
+  prompt += `     * hero (title, description, titleHighlight) - replace keywords only
 `;
-  prompt += `     * screenshots.images[] (all items with translated title and description)
+  prompt += `     * screenshots.images[] (all items with keywords replaced in existing titles/descriptions)
 `;
-  prompt += `     * features.items[] (all items with translated title and body)
+  prompt += `     * features.items[] (all items with keywords replaced in existing titles/bodies)
 `;
-  prompt += `     * reviews (title, description, icons, rating, testimonials)
+  prompt += `     * reviews (title, description, icons, rating, testimonials) - replace keywords if applicable
 `;
-  prompt += `     * cta (headline, icons, rating, description)
+  prompt += `     * cta (headline, icons, rating, description) - replace keywords if applicable
 `;
   prompt += `   - **NO English text in landing sections** - everything must be translated
+`;
+  prompt += `   - **DO NOT rewrite or restructure content** - only swap keywords for optimized keywords
 
 `;
   prompt += `**3. Validation**

package/package.json

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