pabal-resource-mcp 1.10.5 → 1.10.7

package/dist/bin/mcp-server.js

@@ -14,7 +14,7 @@ import {
   getPushDataDir,
   loadAsoFromConfig,
   saveAsoToAsoDir
-} from "../chunk-4JFBWKY4.js";
+} from "../chunk-H4MYWLFK.js";
 import {
   DEFAULT_LOCALE,
   appStoreToUnified,
@@ -189,7 +189,7 @@ This locale has data from BOTH Google Play and App Store. Use the following merg
 - Keep proper nouns and technical terms in English when translating
 - Keep terms like "Always-On Display", "E-Ink", "Android", brand names (e.g., "Boox", "Meebook"), and other technical/proper nouns in English
 - Only translate descriptive text, not technical terminology or proper nouns
-- Example: "Always-On Display" should remain "Always-On Display" in Korean, not translated to "\uD56D\uC0C1 \uCF1C\uC9C4 \uD654\uBA74"
+- Example: "Always-On Display" should remain "Always-On Display" in translated locales, not translated into a generic phrase like "screen that is always on"
 
 ${screenshotPaths ? `
 **Screenshot Paths:**
@@ -358,6 +358,7 @@ import path4 from "path";
 
 // src/utils/aso-validation.util.ts
 var FIELD_LIMITS_DOC_PATH = "docs/aso/ASO_FIELD_LIMITS.md";
+var ASO_OVERVIEW_DOC_PATH = "docs/aso/ASO_OVERVIEW.md";
 var APP_STORE_LIMITS = {
   name: 30,
   subtitle: 30,
@@ -542,6 +543,32 @@ function checkKeywordDuplicates(keywords) {
     uniqueKeywords
   };
 }
+var normalizeKeyword = (value) => value.trim().toLowerCase();
+function getTitleAndSubtitleKeywordSet(name, subtitle) {
+  const sourceText = [name, subtitle].filter((value) => Boolean(value)).join(" ").toLowerCase();
+  const terms = sourceText.split(/[^\p{L}\p{N}]+/u).map((term) => term.trim()).filter(Boolean);
+  return new Set(terms);
+}
+function validateKeywordRules(keywords, name, subtitle) {
+  const duplicateResult = checkKeywordDuplicates(keywords);
+  const keywordList = keywords.split(",").map(normalizeKeyword).filter(Boolean);
+  const titleAndSubtitleKeywords = getTitleAndSubtitleKeywordSet(
+    name,
+    subtitle
+  );
+  const formatting = [];
+  if (/\s/.test(keywords)) {
+    formatting.push("Use comma-only keywords with no spaces");
+  }
+  const repeatedFromTitleOrSubtitle = keywordList.filter((keyword) => {
+    return titleAndSubtitleKeywords.has(keyword);
+  });
+  return {
+    duplicates: duplicateResult.duplicates,
+    formatting,
+    repeatedFromTitleOrSubtitle
+  };
+}
 function validateKeywords(configData) {
   const issues = [];
   if (configData.appStore) {
@@ -549,9 +576,14 @@ function validateKeywords(configData) {
     const locales = isAppStoreMultilingual(appStoreData) ? appStoreData.locales : { [appStoreData.locale || DEFAULT_LOCALE]: appStoreData };
     for (const [locale, data] of Object.entries(locales)) {
       if (data.keywords) {
-        const result = checkKeywordDuplicates(data.keywords);
-        if (result.hasDuplicates) {
-          issues.push({ locale, duplicates: result.duplicates });
+        const result = validateKeywordRules(
+          data.keywords,
+          data.name,
+          data.subtitle
+        );
+        const hasIssues = result.duplicates.length > 0 || result.formatting.length > 0 || result.repeatedFromTitleOrSubtitle.length > 0;
+        if (hasIssues) {
+          issues.push({ locale, ...result });
         }
       }
     }
@@ -894,7 +926,7 @@ This tool:
 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.`,
+Before running, review ${ASO_OVERVIEW_DOC_PATH} for ASO strategy and ${FIELD_LIMITS_DOC_PATH} for per-store limits. This prepares data for pushing to stores without actually uploading.`,
   inputSchema: inputSchema2
 };
 async function handlePublicToAso(input) {
@@ -1049,7 +1081,7 @@ ${validationMessage}`
   responseText += `
 Next step: Push to stores using pabal-store-api-mcp's aso-push tool`;
   responseText += `
-Reference: ${FIELD_LIMITS_DOC_PATH}`;
+References: ${ASO_OVERVIEW_DOC_PATH}, ${FIELD_LIMITS_DOC_PATH}`;
   if (sanitizeWarnings.length > 0) {
     responseText += `
 Sanitized invalid characters:
@@ -1349,7 +1381,11 @@ function generateKeywordSuggestions(args) {
 `;
   suggestions += `6. **template.intro**: Use up to 300 chars to naturally incorporate more keywords and provide richer context
 `;
-  suggestions += `7. **App Store Keywords**: 100 char limit, comma-separated, avoid duplicates from name/subtitle
+  suggestions += `7. **App Store Keywords**: 100 char limit, comma-separated with commas only/no spaces, avoid duplicates from name/subtitle, prefer singular forms, order important keywords first, and fill as close to 100 chars as possible with relevant keywords only
+`;
+  suggestions += `8. **Keyword Selection**: Follow ${ASO_OVERVIEW_DOC_PATH}: popularity >=20 when available, achievable difficulty, beatable top-10 competitors, strong relevance, and target-user search intent
+`;
+  suggestions += `9. **Field Limits**: Follow ${FIELD_LIMITS_DOC_PATH}
 
 `;
   if (category) {
@@ -1385,7 +1421,7 @@ function formatLocaleSection(args) {
   const screenshots = landing.screenshots?.images || [];
   const features = landing.features?.items || [];
   const lengthOf = (value) => value ? value.length : 0;
-  const keywordsLength = Array.isArray(aso.keywords) ? aso.keywords.join(", ").length : lengthOf(typeof aso.keywords === "string" ? aso.keywords : void 0);
+  const keywordsLength = Array.isArray(aso.keywords) ? aso.keywords.join(",").length : lengthOf(typeof aso.keywords === "string" ? aso.keywords : void 0);
   const header = `--- ${locale}${locale === primaryLocale ? " (primary)" : ""} ---`;
   const stats = [
     `Path: public/products/${slug}/locales/${locale}.json`,
@@ -1442,7 +1478,24 @@ ${json}
 }
 
 // src/tools/aso/utils/improve/generate-aso-prompt.util.ts
-var FIELD_LIMITS_DOC_PATH2 = "docs/aso/ASO_FIELD_LIMITS.md";
+var ASO_RULES_SUMMARY = [
+  `Use ${ASO_OVERVIEW_DOC_PATH} for keyword strategy and ${FIELD_LIMITS_DOC_PATH} for hard limits.`,
+  "Keyword source priority: product-level manual CSV files in `.aso/keywordResearch/products/[slug]/*.csv` first. Check the target country Store Domain first; if missing, translate/localize US CSV keywords for the target locale. Then use locale saved keyword research alongside the CSV to validate and fill remaining opportunities.",
+  "Distribute important terms in this order: title first, subtitle second, keywords third.",
+  "Assign tracked keywords by relevance and current rank: best keyword that fits 30 chars -> title; next best keyword that fits 30 chars -> subtitle; remaining high-value keywords within 100 chars -> keyword field.",
+  "`aso.title`: keep app name + the most relevant high-priority keyword, usually `App Name: Primary Keyword`; remember `&`, `:`, and `-` count as 2 characters in title limits.",
+  "`aso.subtitle`: use important keywords that do not repeat the title.",
+  "`aso.keywords`: comma-separated with commas only, no spaces, no duplicates, no title/subtitle repetition; every word can appear in only one of title, subtitle, or keywords.",
+  "Do not split multi-word keywords across fields; keep the full phrase in one field.",
+  "Use singular forms only because Apple indexes plurals automatically.",
+  "Exclude stop words that Apple ignores, such as `a`, `and`, `the`, `for`, `with`, `app`, and `to`.",
+  "Exclude company/app names and inherited category terms, such as the app brand and categories like `Health & Fitness`.",
+  "For US Store keyword suggestions, find suggestions for the app and only add keywords with popularity >25 and difficulty <75.",
+  "`aso.keywords`: use as much of the 100-character limit as possible with relevant keywords; do not leave meaningful capacity unused and do not use filler.",
+  '`aso.keywords`: split phrase intent into reusable single terms when appropriate, e.g. `sound,relaxing,rain` for "relaxing sound" + "rain sound".',
+  "`aso.keywords`: prefer singular forms, allow real searched misspellings, and order by importance.",
+  "Choose keywords with popularity >=20, achievable difficulty, beatable top-10 competitors, strong relevance, and likely target-user search intent."
+].join("\n- ");
 function generatePrimaryOptimizationPrompt(args) {
   const {
     slug,
@@ -1457,23 +1510,34 @@ function generatePrimaryOptimizationPrompt(args) {
 `;
   prompt += `Product: ${slug} | Category: ${category || "N/A"} | Primary: ${primaryLocale}
 
+`;
+  prompt += `## ASO Basics
+
+`;
+  prompt += `- ${ASO_RULES_SUMMARY}
+
 `;
   prompt += `## Task
 
 `;
-  prompt += `Optimize the PRIMARY locale (${primaryLocale}) using **saved keyword research** + full ASO field optimization.
+  prompt += `Optimize the PRIMARY locale (${primaryLocale}) using **manual CSV priority keywords first**, then saved keyword research + full ASO field optimization.
 
 `;
-  prompt += `## Step 1: Use Saved Keyword Research (${primaryLocale})
+  prompt += `## Step 1: Use Keyword Sources (${primaryLocale})
 
 `;
   const researchSections = keywordResearchByLocale[primaryLocale] || [];
   const researchDir = keywordResearchDirByLocale[primaryLocale];
   if (researchSections.length > 0) {
-    prompt += `**CRITICAL: Use ONLY the saved keyword research below. Do NOT invent or research new keywords.**
+    prompt += `**CRITICAL: Use ONLY the keyword sources below. Do NOT invent or research new keywords.**
+
+`;
+    prompt += `**Source priority:** If a "Manual Priority Keywords CSV" section exists, apply those keywords before generated keyword research. If the CSV section says it is using US fallback rows, translate/localize those US keywords into ${primaryLocale} before applying them. Still review the saved locale keyword research alongside the CSV to validate relevance and fill remaining relevant opportunities.
 
 `;
     prompt += `The research data includes:
+`;
+    prompt += `- **Manual Priority Keywords CSV:** Human-curated product-level keyword list. Check target country rows first; if missing, use US rows as a translation source. Apply before saved research, while still considering saved research.
 `;
     prompt += `- **Tier 1 (Core):** Use these in title and subtitle - highest traffic, best opportunity
 `;
@@ -1490,7 +1554,7 @@ function generatePrimaryOptimizationPrompt(args) {
     prompt += `- **User Language Patterns:** Phrases real users use in reviews - incorporate naturally
 
 `;
-    prompt += `Saved research:
+    prompt += `Keyword sources:
 ${researchSections.join("\n")}
 
 `;
@@ -1509,23 +1573,35 @@ ${researchSections.join("\n")}
 `;
   prompt += `**Apply keywords strategically based on tier priority:**
 
+`;
+  prompt += `**Assignment rule:** Tag tracked keywords by relevance and current rank: best keyword that fits the 30-character title limit as \`title\`, next best keyword that fits the 30-character subtitle limit as \`subtitle\`, and remaining high-value keywords that fit the 100-character keyword field as \`keyword field\`.
+`;
+  prompt += `**Ordering rule:** Place the strongest important terms on the left in every field. A word used in \`aso.title\`, \`aso.subtitle\`, or \`aso.keywords\` must not appear in either of the other two fields.
+`;
+  prompt += `**Phrase rule:** Do not split multi-word keywords across fields. Keep the complete phrase together in one field.
+`;
+  prompt += `**Cleanup rule:** Use singular forms, remove Apple-ignored stop words (a/and/the/for/with/app/to/etc.), and exclude the company/app name plus inherited category keywords such as "Health & Fitness".
+
+`;
+  prompt += `**US Store suggestion rule:** For US Store keyword suggestions, find suggestions for this app and only add keywords with popularity >25 and difficulty <75.
+
 `;
   prompt += `### Tier 1 Keywords (Core) \u2192 Title & Subtitle
 `;
   prompt += `- \`aso.title\` (\u226430): **"App Name: [Tier1 Keyword]"** format
 `;
-  prompt += `  - App name in English, keyword in target language, uppercase after colon
+  prompt += `  - App name in English, keyword in target language with natural casing
 `;
   prompt += `  - **Do NOT translate/rename the app name**
 `;
-  prompt += `- \`aso.subtitle\` (\u226430): Use remaining Tier 1 keywords
+  prompt += `- \`aso.subtitle\` (\u226430): Use remaining Tier 1 keywords without repeating title terms
 `;
   prompt += `- \`aso.shortDescription\` (\u226480): Tier 1 + Tier 2 keywords (no emojis/CAPS)
 
 `;
   prompt += `### Tier 2 Keywords (Feature) \u2192 Keywords Field & Descriptions
 `;
-  prompt += `- \`aso.keywords\` (\u2264100): ALL tiers, comma-separated (Tier 1 first, then Tier 2, then Tier 3)
+  prompt += `- \`aso.keywords\` (\u2264100): ALL tiers, comma-separated with commas only and no spaces (Tier 1 first, then Tier 2, then Tier 3); fill as close to 100 chars as possible using relevant keywords only
 `;
   prompt += `- \`landing.hero.title\`: Tier 1 + Tier 2 keywords
 `;
@@ -1566,11 +1642,21 @@ ${researchSections.join("\n")}
   prompt += `## Step 3: Validate (after applying all keywords)
 
 `;
-  prompt += `Check all limits using ${FIELD_LIMITS_DOC_PATH2}: title \u226430, subtitle \u226430, shortDescription \u226480, keywords \u2264100, intro \u2264300, outro \u2264200
+  prompt += `Check all limits using ${FIELD_LIMITS_DOC_PATH}: title \u226430, subtitle \u226430, shortDescription \u226480, keywords \u2264100, intro \u2264300, outro \u2264200
+`;
+  prompt += `- Apply ${ASO_OVERVIEW_DOC_PATH}: keyword popularity \u226520 where available, achievable difficulty, relevance, likely user intent, singular forms, important keywords first
 `;
-  prompt += `- Remove keyword duplicates (unique list; avoid repeating title/subtitle terms verbatim)
+  prompt += `- Confirm title/subtitle/keywords priority placement: title gets the most important fitting keyword, subtitle gets the next important fitting non-overlapping keyword, keywords gets remaining non-overlapping terms
 `;
-  prompt += `- Ensure App Store/Play Store rules from ${FIELD_LIMITS_DOC_PATH2} are satisfied (no disallowed characters/formatting)
+  prompt += `- Confirm multi-word keywords are not split across fields and stop words/category/company terms were excluded
+`;
+  prompt += `- For US Store keyword suggestions, confirm every added suggestion has popularity >25 and difficulty <75
+`;
+  prompt += `- Maximize keyword field utilization: target 90-100/100 chars when enough relevant keywords exist; explain any lower count
+`;
+  prompt += `- Remove keyword duplicates across all metadata fields: no duplicate terms inside keywords and no overlap between title, subtitle, and keywords; no spaces after commas
+`;
+  prompt += `- Ensure App Store/Play Store rules from ${FIELD_LIMITS_DOC_PATH} are satisfied (no disallowed characters/formatting)
 
 `;
   prompt += `## Current Data
@@ -1582,11 +1668,15 @@ ${researchSections.join("\n")}
   prompt += `## Output Format
 
 `;
-  prompt += `**1. Keyword Research (from saved data)**
+  prompt += `**1. Keyword Research (from provided sources)**
 `;
   prompt += `   - Cite file(s) used and list the selected top 10 keywords (no new research)
 `;
-  prompt += `   - Rationale: why these 10 were chosen from saved research
+  prompt += `   - If a Manual Priority Keywords CSV was provided, cite it first, state whether target-country or US fallback rows were used, and explain how those keywords were placed before generated research keywords
+`;
+  prompt += `   - Tag each selected tracked keyword as \`title\`, \`subtitle\`, or \`keyword field\` according to relevance/current rank and field limits
+`;
+  prompt += `   - Rationale: why these 10 were chosen from the provided sources
 
 `;
   prompt += `**2. Optimized JSON** (complete ${primaryLocale} locale structure)
@@ -1614,18 +1704,20 @@ ${researchSections.join("\n")}
 `;
   prompt += `   - shortDescription: X/80 \u2713/\u2717
 `;
-  prompt += `   - keywords: X/100 \u2713/\u2717 (deduped \u2713/\u2717)
+  prompt += `   - keywords: X/100 \u2713/\u2717 (target 90-100 when possible; deduped \u2713/\u2717; no title/subtitle/keywords overlap \u2713/\u2717)
+`;
+  prompt += `   - phrase integrity / singular / stop-word / category-name checks: \u2713/\u2717
 `;
   prompt += `   - intro: X/300 \u2713/\u2717
 `;
   prompt += `   - outro: X/200 \u2713/\u2717
 `;
-  prompt += `   - Store rules (${FIELD_LIMITS_DOC_PATH2}): \u2713/\u2717
+  prompt += `   - Store rules (${FIELD_LIMITS_DOC_PATH}): \u2713/\u2717
 `;
   prompt += `   - Density: X% (2.5-3%) \u2713/\u2717
 
 `;
-  prompt += `**Reference**: ${FIELD_LIMITS_DOC_PATH2}
+  prompt += `**References**: ${ASO_OVERVIEW_DOC_PATH}, ${FIELD_LIMITS_DOC_PATH}
 
 `;
   prompt += `---
@@ -1669,6 +1761,12 @@ function generateKeywordLocalizationPrompt(args) {
     ", "
   )}
 
+`;
+  prompt += `## ASO Basics
+
+`;
+  prompt += `- ${ASO_RULES_SUMMARY}
+
 `;
   if (batchIndex !== void 0 && totalBatches !== void 0) {
     prompt += `**\u26A0\uFE0F BATCH PROCESSING MODE**
@@ -1698,7 +1796,7 @@ function generateKeywordLocalizationPrompt(args) {
 `;
   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. After all keywords are applied, validate character limits + store rules (${FIELD_LIMITS_DOC_PATH2}) + keyword duplication
+  prompt += `3. After all keywords are applied, validate ASO basics (${ASO_OVERVIEW_DOC_PATH}) + character limits/store rules (${FIELD_LIMITS_DOC_PATH}) + keyword duplication
 `;
   prompt += `4. **SAVE the updated JSON to file** using the save-locale-file tool (only if file exists)
 
@@ -1723,7 +1821,7 @@ ${optimizedPrimary}
   prompt += `## Keyword Research (Per Locale)
 
 `;
-  prompt += `**Priority:** Use each locale's own keyword research. English fallback is ONLY used when locale-specific research is missing.
+  prompt += `**Priority:** Use product-level Manual Priority Keywords CSV first when present: check target-country Store Domain rows first; if missing, translate/localize US CSV rows for the target locale. Then review each locale's own keyword research alongside the CSV. English fallback research is ONLY used when locale-specific research is missing.
 `;
   prompt += `When both iOS and Android research exist for a locale, treat iOS keywords as primary; use Android keywords only if space remains after fitting iOS keywords within character limits.
 
@@ -1791,6 +1889,18 @@ ${optimizedPrimary}
 
 `;
   prompt += `For EACH locale:
+`;
+  prompt += `- Source priority: Manual Priority Keywords CSV first (target-country rows, or translated/localized US rows if target-country rows are missing), locale saved keyword research second, translated fallback research third.
+`;
+  prompt += `- Even when CSV exists, still review the locale saved keyword research and use it to validate choices and fill remaining relevant capacity.
+`;
+  prompt += `- Metadata placement priority: best fitting keyword by relevance/current rank to title, next best fitting keyword to subtitle, remaining high-value keywords to keyword field.
+`;
+  prompt += `- Do not repeat the same word across title, subtitle, and keywords. Do not split multi-word keywords across fields.
+`;
+  prompt += `- Use singular forms, remove Apple-ignored stop words, and exclude company/app/category names.
+`;
+  prompt += `- For US Store keyword suggestions, find suggestions for this app and only add keywords with popularity >25 and difficulty <75.
 `;
   prompt += `- Priority: Keep iOS-sourced keywords first; add Android keywords only if there is remaining space after iOS keywords fit within field limits.
 `;
@@ -1802,17 +1912,23 @@ ${optimizedPrimary}
 `;
   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)
+  prompt += `   - Primary keyword: **In target language** (e.g., "aurora forecast" for English, "pronostico de auroras" for Spanish)
 `;
-  prompt += `   - Example: "Aurora EOS: \uC624\uB85C\uB77C \uC608\uBCF4" (Korean), "Aurora EOS: \u30AA\u30FC\u30ED\u30E9\u4E88\u5831" (Japanese)
+  prompt += `   - Example: "Aurora EOS: Aurora Forecast" (English), "Aurora EOS: Pronostico de Auroras" (Spanish)
 `;
-  prompt += `   - The keyword after the colon must start with an uppercase letter
+  prompt += `   - Use natural casing for the target language
 `;
   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 += `4. Deduplicate keywords: final \`aso.keywords\` must be unique, comma-only without spaces, as close to 100 chars as possible, and must not repeat any title/subtitle keyword terms
+`;
+  prompt += `   - Do not split multi-word keywords between title/subtitle/keywords; assign the full phrase to a single field
+`;
+  prompt += `   - Use singular forms only; remove stop words such as a/and/the/for/with/app/to; exclude app/company/category names
+`;
+  prompt += `   - For US Store keyword suggestions, only add suggestions with popularity >25 and difficulty <75
 `;
   prompt += `5. **Replace keywords in existing sentences** - swap ONLY the keywords, keep everything else:
 `;
@@ -1854,11 +1970,11 @@ ${optimizedPrimary}
 `;
   prompt += `- Original: "Track aurora with real-time forecasts"
 `;
-  prompt += `- Optimized keywords: \uC624\uB85C\uB77C, \uC608\uBCF4, \uC2E4\uC2DC\uAC04
+  prompt += `- Optimized keywords: aurora,forecast,real-time
 `;
-  prompt += `- Result: "Track \uC624\uB85C\uB77C with \uC2E4\uC2DC\uAC04 \uC608\uBCF4" (keywords replaced, structure kept)
+  prompt += `- Result: "Track aurora with real-time forecasts" (keywords replaced, structure kept)
 `;
-  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 += `  OR: "Track real-time aurora forecasts" (if natural keyword placement requires minor word order, but keep meaning identical)
 
 `;
   prompt += `## Current Translated Locales (This Batch)
@@ -1877,7 +1993,7 @@ ${optimizedPrimary}
 `;
   prompt += `Process EACH locale in this batch sequentially:
 `;
-  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 += `1. Use Manual Priority Keywords CSV first when present. If target-country CSV rows are missing and US CSV rows are shown, **TRANSLATE/LOCALIZE those US CSV keywords** to the target locale before applying them. Then use saved keyword research (in target language), OR **TRANSLATE English fallback research from primary locale** if missing (see fallback strategy above - MUST translate, not use English directly)
 `;
   prompt += `2. **Replace keywords ONLY** in ALL fields (keep existing content structure unchanged):
 `;
@@ -1899,7 +2015,9 @@ ${optimizedPrimary}
 `;
   prompt += `3. **CRITICAL**: Ensure ALL landing fields are translated (not English)
 `;
-  prompt += `4. After swapping keywords, validate limits + store rules (${FIELD_LIMITS_DOC_PATH2}) + keyword duplication (unique list; avoid repeating title/subtitle terms verbatim)
+  prompt += `4. After swapping keywords, validate ASO basics (${ASO_OVERVIEW_DOC_PATH}) + limits/store rules (${FIELD_LIMITS_DOC_PATH}) + keyword utilization (target 90-100/100 when enough relevant keywords exist) + keyword duplication (unique list; no overlap between title/subtitle/keywords; no spaces after commas)
+`;
+  prompt += `   - Also validate no multi-word keyword was split across fields, singular forms are used, stop words are removed, and company/app/category names are excluded
 `;
   prompt += `5. **SAVE the updated JSON to file** using save-locale-file tool
 `;
@@ -1940,10 +2058,14 @@ ${optimizedPrimary}
 
 `;
   prompt += `**1. Keyword Source**
+`;
+  prompt += `   - If Manual Priority Keywords CSV exists: Cite it first; state whether target-country rows or translated US fallback rows were used; list selected CSV keywords and where they were placed
 `;
   prompt += `   - If saved research exists: Cite file(s) used; list selected top 10 keywords (in target language)
 `;
   prompt += `   - If using fallback: List **TRANSLATED** keywords from primary locale (English \u2192 target language) with translation rationale
+`;
+  prompt += `   - Tag each selected tracked keyword as \`title\`, \`subtitle\`, or \`keyword field\` according to relevance/current rank and field limits
 `;
   prompt += `   - Show final 10 keywords **IN TARGET LANGUAGE** with tier assignments - DO NOT show English keywords
 
@@ -1979,13 +2101,15 @@ ${optimizedPrimary}
 `;
   prompt += `   - shortDescription: X/80 \u2713/\u2717
 `;
-  prompt += `   - keywords: X/100 \u2713/\u2717 (deduped \u2713/\u2717; not repeating title/subtitle)
+  prompt += `   - keywords: X/100 \u2713/\u2717 (target 90-100 when possible; deduped \u2713/\u2717; comma-only/no spaces \u2713/\u2717; no title/subtitle/keywords overlap \u2713/\u2717)
+`;
+  prompt += `   - phrase integrity / singular / stop-word / category-name checks: \u2713/\u2717
 `;
   prompt += `   - intro: X/300 \u2713/\u2717
 `;
   prompt += `   - outro: X/200 \u2713/\u2717
 `;
-  prompt += `   - Store rules (${FIELD_LIMITS_DOC_PATH2}): \u2713/\u2717
+  prompt += `   - Store rules (${FIELD_LIMITS_DOC_PATH}): \u2713/\u2717
 
 `;
   prompt += `**4. File Save Confirmation**
@@ -2033,6 +2157,168 @@ validate-aso(slug="${slug}")
 // src/tools/aso/utils/improve/load-keyword-research.util.ts
 import fs6 from "fs";
 import path6 from "path";
+var LOCALE_STORE_DOMAIN_OVERRIDES = {
+  ar: "sa",
+  en: "us",
+  "en-US": "us",
+  "zh-Hans": "cn",
+  "zh-Hant": "tw"
+};
+function parseCsvLine(line) {
+  const values = [];
+  let current = "";
+  let isQuoted = false;
+  for (let index = 0; index < line.length; index += 1) {
+    const char = line[index];
+    const nextChar = line[index + 1];
+    if (char === '"' && isQuoted && nextChar === '"') {
+      current += '"';
+      index += 1;
+      continue;
+    }
+    if (char === '"') {
+      isQuoted = !isQuoted;
+      continue;
+    }
+    if (char === "," && !isQuoted) {
+      values.push(current);
+      current = "";
+      continue;
+    }
+    current += char;
+  }
+  values.push(current);
+  return values;
+}
+function getLocaleStoreDomain(locale) {
+  const override = LOCALE_STORE_DOMAIN_OVERRIDES[locale];
+  if (override) {
+    return override;
+  }
+  const localeParts = locale.split("-");
+  return (localeParts[1] || localeParts[0] || "").toLowerCase();
+}
+function loadManualKeywordCsvRowsForStoreDomain(slug, storeDomain) {
+  const productResearchDir = path6.join(getKeywordResearchDir(), "products", slug);
+  if (!fs6.existsSync(productResearchDir)) {
+    return [];
+  }
+  const csvFiles = fs6.readdirSync(productResearchDir).filter((file) => file.endsWith(".csv")).sort();
+  if (csvFiles.length === 0) {
+    return [];
+  }
+  const rows = [];
+  for (const file of csvFiles) {
+    const filePath = path6.join(productResearchDir, file);
+    const raw = fs6.readFileSync(filePath, "utf-8").trim();
+    if (!raw) {
+      continue;
+    }
+    const [headerLine, ...dataLines] = raw.split(/\r?\n/);
+    if (!headerLine) {
+      continue;
+    }
+    const headers = parseCsvLine(headerLine).map((header) => header.trim());
+    const getValue = (values, header) => {
+      const index = headers.indexOf(header);
+      return index >= 0 ? values[index]?.trim() || "" : "";
+    };
+    for (const line of dataLines) {
+      if (!line.trim()) {
+        continue;
+      }
+      const values = parseCsvLine(line);
+      const rowStoreDomain = getValue(values, "Store Domain").toLowerCase();
+      if (rowStoreDomain !== storeDomain) {
+        continue;
+      }
+      const keyword = getValue(values, "Keyword");
+      if (!keyword) {
+        continue;
+      }
+      rows.push({
+        filePath,
+        keyword,
+        platform: getValue(values, "Platform"),
+        storeDomain: rowStoreDomain,
+        store: getValue(values, "Store"),
+        ranking: getValue(values, "Ranking"),
+        popularity: getValue(values, "Popularity"),
+        difficulty: getValue(values, "Difficulty"),
+        lastUpdate: getValue(values, "Last Update")
+      });
+    }
+  }
+  const seenKeywords = /* @__PURE__ */ new Set();
+  return rows.filter((row) => {
+    const normalized = row.keyword.toLowerCase();
+    if (seenKeywords.has(normalized)) {
+      return false;
+    }
+    seenKeywords.add(normalized);
+    return true;
+  });
+}
+function loadManualKeywordCsv(slug, locale) {
+  const targetStoreDomain = getLocaleStoreDomain(locale);
+  const localeRows = loadManualKeywordCsvRowsForStoreDomain(
+    slug,
+    targetStoreDomain
+  );
+  if (localeRows.length > 0) {
+    return {
+      rows: localeRows,
+      isFallback: false,
+      sourceStoreDomain: targetStoreDomain,
+      targetStoreDomain
+    };
+  }
+  const usRows = targetStoreDomain === "us" ? [] : loadManualKeywordCsvRowsForStoreDomain(slug, "us");
+  return {
+    rows: usRows,
+    isFallback: usRows.length > 0,
+    sourceStoreDomain: "us",
+    targetStoreDomain
+  };
+}
+function formatManualKeywordCsvRows(result, locale) {
+  const { rows, isFallback, sourceStoreDomain, targetStoreDomain } = result;
+  const sourceFiles = [...new Set(rows.map((row) => row.filePath))];
+  const lines = [];
+  lines.push(
+    `### Manual Priority Keywords CSV (${locale} / ${targetStoreDomain})`
+  );
+  lines.push(`Source: ${sourceFiles.join(", ")}`);
+  if (isFallback) {
+    lines.push(
+      `Fallback: No CSV rows found for Store Domain "${targetStoreDomain}". Using "${sourceStoreDomain}" CSV keywords as translation source for ${locale}.`
+    );
+    lines.push(
+      "Translation rule: translate/localize these US keywords into the target locale before placing them in title, subtitle, keywords, or landing copy."
+    );
+  }
+  lines.push(
+    "Priority: Apply these CSV keywords before saved keyword research, but still use locale saved research alongside them to validate relevance and fill remaining opportunities."
+  );
+  lines.push(
+    "Placement rule: put the strongest terms in title first, then subtitle, then the keywords field. Do not duplicate the same keyword across title, subtitle, and keywords."
+  );
+  lines.push("");
+  lines.push("**CSV Priority Keywords:**");
+  rows.slice(0, 30).forEach((row, index) => {
+    const metrics = [
+      row.platform ? `platform: ${row.platform}` : "",
+      row.store ? `store: ${row.store}` : "",
+      row.ranking ? `rank: ${row.ranking}` : "",
+      row.popularity ? `popularity: ${row.popularity}` : "",
+      row.difficulty ? `difficulty: ${row.difficulty}` : "",
+      row.lastUpdate ? `updated: ${row.lastUpdate}` : ""
+    ].filter(Boolean);
+    lines.push(`${index + 1}. **${row.keyword}**${metrics.length > 0 ? ` (${metrics.join(", ")})` : ""}`);
+  });
+  lines.push("\n----");
+  return lines.join("\n");
+}
 function extractRecommended(data) {
   const summary = data?.summary || data?.data?.summary;
   const recommended = summary?.recommendedKeywords;
@@ -2326,9 +2612,15 @@ function loadKeywordResearchForLocale(slug, locale) {
     "locales",
     locale
   );
+  const manualKeywordCsv = loadManualKeywordCsv(slug, locale);
+  const manualKeywordSections = manualKeywordCsv.rows.length > 0 ? [formatManualKeywordCsvRows(manualKeywordCsv, locale)] : [];
   const result = loadKeywordResearchForLocaleInternal(slug, locale);
   if (result) {
-    return { ...result, isFallback: false };
+    return {
+      ...result,
+      sections: [...manualKeywordSections, ...result.sections],
+      isFallback: false
+    };
   }
   for (const fallbackLocale of FALLBACK_LOCALES) {
     if (fallbackLocale === locale) continue;
@@ -2344,14 +2636,19 @@ function loadKeywordResearchForLocale(slug, locale) {
       );
       return {
         entries: fallbackResult.entries,
-        sections: sectionsWithNotice,
+        sections: [...manualKeywordSections, ...sectionsWithNotice],
         researchDir: fallbackResult.researchDir,
         isFallback: true,
         fallbackLocale
       };
     }
   }
-  return { entries: [], sections: [], researchDir, isFallback: false };
+  return {
+    entries: [],
+    sections: manualKeywordSections,
+    researchDir,
+    isFallback: false
+  };
 }
 
 // src/tools/aso/improve-public.ts
@@ -2383,9 +2680,11 @@ var improvePublicTool = {
 
 ## HOW THIS TOOL WORKS
 This tool returns a PROMPT containing:
+- Product-level manual CSV keyword data from .aso/keywordResearch/products/[slug]/*.csv when present
 - Saved keyword research data (Tier 1/2/3 keywords with traffic/difficulty scores)
 - Current locale data
 - Optimization instructions
+- ASO basics from ${ASO_OVERVIEW_DOC_PATH} and field limits from ${FIELD_LIMITS_DOC_PATH}
 
 **YOU MUST:**
 1. Read the returned prompt carefully
@@ -2403,9 +2702,11 @@ This tool returns a PROMPT containing:
 - **Stage 2:** Localize to other languages - **each locale uses its OWN keyword research**
 
 ## KEYWORD SOURCES (Per Locale)
-- **Priority 1:** Uses each locale's SAVED keyword research from .aso/keywordResearch/products/[slug]/locales/[locale]/
-- **Priority 2 (Fallback):** If locale-specific research is missing, falls back to en-US/en keywords and TRANSLATES them
+- **Priority 1:** Uses product-level manual CSV keywords from .aso/keywordResearch/products/[slug]/*.csv. It checks the target locale's country Store Domain first; if missing, it uses US CSV keywords as a translation/localization source.
+- **Priority 2:** Uses each locale's SAVED keyword research from .aso/keywordResearch/products/[slug]/locales/[locale]/ alongside the CSV to validate relevance and fill remaining opportunities.
+- **Priority 3 (Fallback):** If locale-specific saved research is missing, falls back to en-US/en saved research and TRANSLATES it
 - iOS and Android research are automatically combined per locale (iOS prioritized)
+- Title, subtitle, and keywords must be filled in that importance order, with no repeated keyword terms across the three fields
 
 **CRITICAL:** Only processes existing locale files. Does NOT create new files.`,
   inputSchema: inputSchema3
@@ -2575,8 +2876,9 @@ var validateAsoTool = {
    - App Store: name \u2264${APP_STORE_LIMITS.name}, subtitle \u2264${APP_STORE_LIMITS.subtitle}, keywords \u2264${APP_STORE_LIMITS.keywords}, description \u2264${APP_STORE_LIMITS.description}
    - Google Play: title \u2264${GOOGLE_PLAY_LIMITS.title}, shortDescription \u2264${GOOGLE_PLAY_LIMITS.shortDescription}, fullDescription \u2264${GOOGLE_PLAY_LIMITS.fullDescription}
 
-2. **Keyword Duplicates** (App Store only):
-   - Checks for duplicate keywords in comma-separated list
+2. **Keyword Rules** (App Store only):
+   - Checks duplicate keywords, comma-only/no-space formatting, and title/subtitle repetition
+   - Strategy reference: ${ASO_OVERVIEW_DOC_PATH}
 
 3. **Invalid Characters**:
    - Control characters, BOM, zero-width/invisible characters, variation selectors
@@ -2699,10 +3001,26 @@ async function handleValidateAso(input) {
   const keywordIssues = validateKeywords(dataToValidate);
   const filteredKeywordIssues = locale ? keywordIssues.filter((issue) => issue.locale === locale) : keywordIssues;
   if (filteredKeywordIssues.length > 0) {
-    results.push(`## Keyword Duplicates
+    results.push(`## Keyword Rule Violations
 `);
     for (const issue of filteredKeywordIssues) {
-      results.push(`- [${issue.locale}]: ${issue.duplicates.join(", ")}`);
+      if (issue.duplicates.length > 0) {
+        results.push(
+          `- [${issue.locale}] duplicates: ${issue.duplicates.join(", ")}`
+        );
+      }
+      if (issue.formatting.length > 0) {
+        results.push(
+          `- [${issue.locale}] formatting: ${issue.formatting.join(", ")}`
+        );
+      }
+      if (issue.repeatedFromTitleOrSubtitle.length > 0) {
+        results.push(
+          `- [${issue.locale}] repeats title/subtitle: ${issue.repeatedFromTitleOrSubtitle.join(
+            ", "
+          )}`
+        );
+      }
     }
     results.push("");
   }
@@ -2717,7 +3035,7 @@ async function handleValidateAso(input) {
       `\u274C **Validation failed** - Fix the issues above before pushing to stores.`
     );
     results.push(`
-Reference: ${FIELD_LIMITS_DOC_PATH}`);
+References: ${ASO_OVERVIEW_DOC_PATH}, ${FIELD_LIMITS_DOC_PATH}`);
   } else if (hasSanitizeWarnings && !fix) {
     results.push(
       `\u26A0\uFE0F **Invalid characters detected** - Run with \`fix: true\` to auto-remove.`

package/dist/chunk-H4MYWLFK.js

@@ -0,0 +1,418 @@
+import {
+  DEFAULT_LOCALE,
+  isAppStoreLocale,
+  isGooglePlayLocale,
+  isSupportedLocale
+} from "./chunk-BOWRBVVV.js";
+
+// src/utils/config.util.ts
+import fs from "fs";
+import path from "path";
+import os from "os";
+function getAsoDataDir() {
+  const configPath = path.join(
+    os.homedir(),
+    ".config",
+    "pabal-mcp",
+    "config.json"
+  );
+  if (!fs.existsSync(configPath)) {
+    throw new Error(
+      `Config file not found at ${configPath}. Please create the config file and set the 'dataDir' property to specify the ASO data directory.`
+    );
+  }
+  try {
+    const configContent = fs.readFileSync(configPath, "utf-8");
+    const config = JSON.parse(configContent);
+    if (!config.dataDir) {
+      throw new Error(
+        `'dataDir' property is not set in ${configPath}. Please set 'dataDir' to specify the ASO data directory.`
+      );
+    }
+    if (path.isAbsolute(config.dataDir)) {
+      return config.dataDir;
+    }
+    return path.resolve(os.homedir(), config.dataDir);
+  } catch (error) {
+    if (error instanceof Error && error.message.includes("dataDir")) {
+      throw error;
+    }
+    throw new Error(
+      `Failed to read config from ${configPath}: ${error instanceof Error ? error.message : String(error)}`
+    );
+  }
+}
+function getPullDataDir() {
+  return path.join(getAsoDataDir(), ".aso", "pullData");
+}
+function getPushDataDir() {
+  return path.join(getAsoDataDir(), ".aso", "pushData");
+}
+function getPublicDir() {
+  return path.join(getAsoDataDir(), "public");
+}
+function getKeywordResearchDir() {
+  return path.join(getAsoDataDir(), ".aso", "keywordResearch");
+}
+function getProductsDir() {
+  return path.join(getPublicDir(), "products");
+}
+function loadConfig() {
+  const configPath = path.join(
+    os.homedir(),
+    ".config",
+    "pabal-mcp",
+    "config.json"
+  );
+  if (!fs.existsSync(configPath)) {
+    return {};
+  }
+  try {
+    const configContent = fs.readFileSync(configPath, "utf-8");
+    return JSON.parse(configContent);
+  } catch {
+    return {};
+  }
+}
+function getGeminiApiKey() {
+  const config = loadConfig();
+  if (config.gemini?.apiKey) {
+    return config.gemini.apiKey;
+  }
+  const envKey = process.env.GEMINI_API_KEY || process.env.GOOGLE_API_KEY;
+  if (envKey) {
+    return envKey;
+  }
+  throw new Error(
+    `Gemini API key not found. Set it in ~/.config/pabal-mcp/config.json under "gemini.apiKey" or use GEMINI_API_KEY environment variable.`
+  );
+}
+
+// src/utils/aso-converter.ts
+import fs2 from "fs";
+import path2 from "path";
+function generateFullDescription(localeData, metadata = {}) {
+  const { aso, landing } = localeData;
+  const template = aso?.template;
+  if (!template) {
+    return "";
+  }
+  const landingFeatures = landing?.features?.items || [];
+  const landingScreenshots = landing?.screenshots?.images || [];
+  const keyHeading = template.keyFeaturesHeading || "Key Features";
+  const featuresHeading = template.featuresHeading || "Additional Features";
+  const parts = [template.intro];
+  if (landingFeatures.length > 0) {
+    parts.push(
+      "",
+      keyHeading,
+      "",
+      ...landingFeatures.map(
+        (feature) => [`\u25B6\uFE0E ${feature.title}`, feature.body || ""].filter(Boolean).join("\n")
+      )
+    );
+  }
+  if (landingScreenshots.length > 0) {
+    parts.push("", featuresHeading, "");
+    parts.push(
+      ...landingScreenshots.map(
+        (screenshot) => [`\u25B6\uFE0E ${screenshot.title}`, screenshot.description || ""].filter(Boolean).join("\n")
+      )
+    );
+  }
+  parts.push("", template.outro);
+  const includeSupport = template.includeSupportLinks ?? true;
+  if (includeSupport) {
+    const contactLines = [
+      metadata.instagram ? `Instagram: ${metadata.instagram}` : null,
+      metadata.contactEmail ? `Email: ${metadata.contactEmail}` : null,
+      metadata.termsUrl ? `- Terms of Use: ${metadata.termsUrl}` : null,
+      metadata.privacyUrl ? `- Privacy Policy: ${metadata.privacyUrl}` : null
+    ].filter((line) => line !== null);
+    if (contactLines.length > 0) {
+      parts.push("", "[Contact & Support]", "", ...contactLines);
+    }
+  }
+  return parts.join("\n");
+}
+function loadAsoFromConfig(slug) {
+  const productsDir = getProductsDir();
+  const configPath = path2.join(productsDir, slug, "config.json");
+  console.debug(`[loadAsoFromConfig] Looking for ${slug}:`);
+  console.debug(`  - productsDir: ${productsDir}`);
+  console.debug(`  - configPath: ${configPath}`);
+  console.debug(`  - configPath exists: ${fs2.existsSync(configPath)}`);
+  if (!fs2.existsSync(configPath)) {
+    console.warn(`[loadAsoFromConfig] Config file not found at ${configPath}`);
+    return {};
+  }
+  try {
+    const configContent = fs2.readFileSync(configPath, "utf-8");
+    const config = JSON.parse(configContent);
+    const localesDir = path2.join(productsDir, slug, "locales");
+    console.debug(`  - localesDir: ${localesDir}`);
+    console.debug(`  - localesDir exists: ${fs2.existsSync(localesDir)}`);
+    if (!fs2.existsSync(localesDir)) {
+      console.warn(
+        `[loadAsoFromConfig] Locales directory not found at ${localesDir}`
+      );
+      return {};
+    }
+    const localeFiles = fs2.readdirSync(localesDir).filter((f) => f.endsWith(".json"));
+    const locales = {};
+    for (const file of localeFiles) {
+      const localeCode = file.replace(".json", "");
+      const localePath = path2.join(localesDir, file);
+      const localeContent = fs2.readFileSync(localePath, "utf-8");
+      locales[localeCode] = JSON.parse(localeContent);
+    }
+    console.debug(
+      `  - Found ${Object.keys(locales).length} locale file(s): ${Object.keys(
+        locales
+      ).join(", ")}`
+    );
+    if (Object.keys(locales).length === 0) {
+      console.warn(
+        `[loadAsoFromConfig] No locale files found in ${localesDir}`
+      );
+    }
+    const defaultLocale = config.content?.defaultLocale || DEFAULT_LOCALE;
+    const asoData = {};
+    if (config.packageName) {
+      const googlePlayLocales = {};
+      const metadata = config.metadata || {};
+      const screenshots = metadata.screenshots || {};
+      for (const [locale, localeData] of Object.entries(locales)) {
+        if (!isSupportedLocale(locale)) {
+          console.debug(
+            `Skipping locale ${locale} - not a valid unified locale`
+          );
+          continue;
+        }
+        if (!isGooglePlayLocale(locale)) {
+          console.debug(
+            `Skipping locale ${locale} - not supported by Google Play`
+          );
+          continue;
+        }
+        const aso = localeData.aso || {};
+        if (!aso || !aso.title && !aso.shortDescription) {
+          console.warn(
+            `Locale ${locale} has no ASO data (title or shortDescription)`
+          );
+        }
+        const screenshotsDir = path2.join(
+          productsDir,
+          slug,
+          "screenshots",
+          locale
+        );
+        const phoneDir = path2.join(screenshotsDir, "phone");
+        const tabletDir = path2.join(screenshotsDir, "tablet");
+        const featureGraphicPath = path2.join(
+          screenshotsDir,
+          "feature-graphic.png"
+        );
+        const hasPhoneScreenshots = fs2.existsSync(phoneDir);
+        const hasTabletScreenshots = fs2.existsSync(tabletDir);
+        const hasFeatureGraphic = fs2.existsSync(featureGraphicPath);
+        const localeScreenshots = {
+          phone: hasPhoneScreenshots ? screenshots.phone?.map(
+            (p) => p.replace(/\/screenshots\/[^/]+\//, `/screenshots/${locale}/`)
+          ) : void 0,
+          tablet: hasTabletScreenshots ? screenshots.tablet?.map(
+            (p) => p.replace(/\/screenshots\/[^/]+\//, `/screenshots/${locale}/`)
+          ) : void 0
+        };
+        googlePlayLocales[locale] = {
+          title: aso.title || "",
+          shortDescription: aso.shortDescription || "",
+          fullDescription: generateFullDescription(localeData, metadata),
+          packageName: config.packageName,
+          defaultLanguage: locale,
+          screenshots: {
+            phone: localeScreenshots.phone || [],
+            tablet: localeScreenshots.tablet
+          },
+          featureGraphic: hasFeatureGraphic ? `/products/${slug}/screenshots/${locale}/feature-graphic.png` : metadata.featureGraphic
+        };
+      }
+      const googleLocaleKeys = Object.keys(googlePlayLocales);
+      if (googleLocaleKeys.length > 0) {
+        const hasConfigDefault = isGooglePlayLocale(defaultLocale) && Boolean(googlePlayLocales[defaultLocale]);
+        const resolvedDefault = hasConfigDefault ? defaultLocale : googlePlayLocales[DEFAULT_LOCALE] ? DEFAULT_LOCALE : googleLocaleKeys[0];
+        asoData.googlePlay = {
+          locales: googlePlayLocales,
+          defaultLocale: resolvedDefault,
+          // App-level contact information
+          contactEmail: metadata.contactEmail,
+          contactWebsite: metadata.supportUrl,
+          youtubeUrl: metadata.youtubeUrl
+        };
+      }
+    }
+    if (config.bundleId) {
+      const appStoreLocales = {};
+      const metadata = config.metadata || {};
+      const screenshots = metadata.screenshots || {};
+      for (const [locale, localeData] of Object.entries(locales)) {
+        if (!isSupportedLocale(locale)) {
+          console.debug(
+            `Skipping locale ${locale} - not a valid unified locale`
+          );
+          continue;
+        }
+        if (!isAppStoreLocale(locale)) {
+          console.debug(
+            `Skipping locale ${locale} - not supported by App Store`
+          );
+          continue;
+        }
+        const aso = localeData.aso || {};
+        if (!aso || !aso.title && !aso.shortDescription) {
+          console.warn(
+            `Locale ${locale} has no ASO data (title or shortDescription)`
+          );
+        }
+        const screenshotsDir = path2.join(
+          productsDir,
+          slug,
+          "screenshots",
+          locale
+        );
+        const phoneDir = path2.join(screenshotsDir, "phone");
+        const tabletDir = path2.join(screenshotsDir, "tablet");
+        const hasPhoneScreenshots = fs2.existsSync(phoneDir);
+        const hasTabletScreenshots = fs2.existsSync(tabletDir);
+        const localeScreenshots = {
+          phone: hasPhoneScreenshots ? screenshots.phone?.map(
+            (p) => p.replace(/\/screenshots\/[^/]+\//, `/screenshots/${locale}/`)
+          ) : void 0,
+          tablet: hasTabletScreenshots ? screenshots.tablet?.map(
+            (p) => p.replace(/\/screenshots\/[^/]+\//, `/screenshots/${locale}/`)
+          ) : void 0
+        };
+        appStoreLocales[locale] = {
+          name: aso.title || "",
+          subtitle: aso.subtitle,
+          description: generateFullDescription(localeData, metadata),
+          keywords: Array.isArray(aso.keywords) ? aso.keywords.join(",") : aso.keywords,
+          promotionalText: void 0,
+          bundleId: config.bundleId,
+          locale,
+          screenshots: {
+            // Map phone screenshots to iphone65
+            iphone65: localeScreenshots.phone || [],
+            // Map tablet screenshots to ipadPro129
+            ipadPro129: localeScreenshots.tablet
+          }
+        };
+      }
+      const appStoreLocaleKeys = Object.keys(appStoreLocales);
+      if (appStoreLocaleKeys.length > 0) {
+        const hasConfigDefault = isAppStoreLocale(defaultLocale) && Boolean(appStoreLocales[defaultLocale]);
+        const resolvedDefault = hasConfigDefault ? defaultLocale : appStoreLocales[DEFAULT_LOCALE] ? DEFAULT_LOCALE : appStoreLocaleKeys[0];
+        asoData.appStore = {
+          locales: appStoreLocales,
+          defaultLocale: resolvedDefault,
+          // App-level contact information
+          contactEmail: metadata.contactEmail,
+          supportUrl: metadata.supportUrl,
+          marketingUrl: metadata.marketingUrl,
+          privacyPolicyUrl: metadata.privacyUrl,
+          termsUrl: metadata.termsUrl
+        };
+      }
+    }
+    const hasGooglePlay = !!asoData.googlePlay;
+    const hasAppStore = !!asoData.appStore;
+    console.debug(`[loadAsoFromConfig] Result for ${slug}:`);
+    console.debug(
+      `  - Google Play data: ${hasGooglePlay ? "found" : "not found"}`
+    );
+    console.debug(`  - App Store data: ${hasAppStore ? "found" : "not found"}`);
+    if (!hasGooglePlay && !hasAppStore) {
+      console.warn(`[loadAsoFromConfig] No ASO data generated for ${slug}`);
+    }
+    return asoData;
+  } catch (error) {
+    console.error(
+      `[loadAsoFromConfig] Failed to load ASO data from config for ${slug}:`,
+      error
+    );
+    return {};
+  }
+}
+function saveAsoToConfig(slug, config) {
+  const productsDir = getProductsDir();
+  const configPath = path2.join(productsDir, slug, "config.json");
+  fs2.writeFileSync(configPath, JSON.stringify(config, null, 2) + "\n", "utf-8");
+}
+function saveAsoToAsoDir(slug, asoData) {
+  const rootDir = getPushDataDir();
+  if (asoData.googlePlay) {
+    const asoPath = path2.join(
+      rootDir,
+      "products",
+      slug,
+      "store",
+      "google-play",
+      "aso-data.json"
+    );
+    const dir = path2.dirname(asoPath);
+    if (!fs2.existsSync(dir)) {
+      fs2.mkdirSync(dir, { recursive: true });
+    }
+    const googlePlayData = asoData.googlePlay;
+    const multilingualData = "locales" in googlePlayData ? googlePlayData : {
+      locales: {
+        [googlePlayData.defaultLanguage || DEFAULT_LOCALE]: googlePlayData
+      },
+      defaultLocale: googlePlayData.defaultLanguage || DEFAULT_LOCALE
+    };
+    fs2.writeFileSync(
+      asoPath,
+      JSON.stringify({ googlePlay: multilingualData }, null, 2) + "\n",
+      "utf-8"
+    );
+  }
+  if (asoData.appStore) {
+    const asoPath = path2.join(
+      rootDir,
+      "products",
+      slug,
+      "store",
+      "app-store",
+      "aso-data.json"
+    );
+    const dir = path2.dirname(asoPath);
+    if (!fs2.existsSync(dir)) {
+      fs2.mkdirSync(dir, { recursive: true });
+    }
+    const appStoreData = asoData.appStore;
+    const multilingualData = "locales" in appStoreData ? appStoreData : {
+      locales: {
+        [appStoreData.locale || DEFAULT_LOCALE]: appStoreData
+      },
+      defaultLocale: appStoreData.locale || DEFAULT_LOCALE
+    };
+    fs2.writeFileSync(
+      asoPath,
+      JSON.stringify({ appStore: multilingualData }, null, 2) + "\n",
+      "utf-8"
+    );
+  }
+}
+
+export {
+  getAsoDataDir,
+  getPullDataDir,
+  getPushDataDir,
+  getPublicDir,
+  getKeywordResearchDir,
+  getProductsDir,
+  getGeminiApiKey,
+  loadAsoFromConfig,
+  saveAsoToConfig,
+  saveAsoToAsoDir
+};

package/dist/index.d.ts

@@ -6,20 +6,20 @@ import 'appstore-connect-sdk/openapi';
 /**
  * ASO Data Converter
  *
- * config.json (source of truth) ↔ aso-data.json (build artifact) 변환 유틸리티
+ * Converts between config.json (source of truth) and aso-data.json (build artifact).
  */
 
 /**
- * config.json에서 ASO 데이터를 읽어옵니다
- * 새 구조: config.json (메타데이터) + locales/{locale}.json (콘텐츠)
+ * Read ASO data from config.json.
+ * New structure: config.json (metadata) + locales/{locale}.json (content)
  */
 declare function loadAsoFromConfig(slug: string): AsoData;
 /**
- * config.json에 ASO 데이터를 저장합니다
+ * Save ASO data to config.json.
  */
 declare function saveAsoToConfig(slug: string, config: ProductConfig): void;
 /**
- * ASO 데이터를 지정한 ASO 디렉토리에 저장합니다
+ * Save ASO data to the configured ASO directory.
  */
 declare function saveAsoToAsoDir(slug: string, asoData: AsoData): void;
 

package/dist/index.js

@@ -9,7 +9,7 @@ import {
   loadAsoFromConfig,
   saveAsoToAsoDir,
   saveAsoToConfig
-} from "./chunk-4JFBWKY4.js";
+} from "./chunk-H4MYWLFK.js";
 import {
   APP_STORE_TO_UNIFIED,
   DEFAULT_LOCALE,

package/package.json

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