pabal-resource-mcp 1.10.4 → 1.10.6

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 });
         }
       }
     }
@@ -597,6 +629,8 @@ function prepareAsoDataForPush(configData) {
     const locales = isAppStoreMultilingual(appStoreData) ? appStoreData.locales : { [appStoreData.locale || DEFAULT_LOCALE]: appStoreData };
     const appLevelSupportUrl = isAppStoreMultilingual(appStoreData) ? appStoreData.supportUrl : void 0;
     const appLevelMarketingUrl = isAppStoreMultilingual(appStoreData) ? appStoreData.marketingUrl : void 0;
+    const appLevelPrivacyPolicyUrl = isAppStoreMultilingual(appStoreData) ? appStoreData.privacyPolicyUrl : void 0;
+    const appLevelTermsUrl = isAppStoreMultilingual(appStoreData) ? appStoreData.termsUrl : void 0;
     const convertedLocales = {};
     for (const [unifiedLocale, localeData] of Object.entries(locales)) {
       const appStoreLocale = unifiedToAppStore(unifiedLocale);
@@ -605,7 +639,9 @@ function prepareAsoDataForPush(configData) {
           ...localeData,
           locale: appStoreLocale,
           supportUrl: localeData.supportUrl || appLevelSupportUrl,
-          marketingUrl: localeData.marketingUrl || appLevelMarketingUrl
+          marketingUrl: localeData.marketingUrl || appLevelMarketingUrl,
+          privacyPolicyUrl: localeData.privacyPolicyUrl || appLevelPrivacyPolicyUrl,
+          termsUrl: localeData.termsUrl || appLevelTermsUrl
         };
       }
     }
@@ -890,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) {
@@ -1045,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:
@@ -1345,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) {
@@ -1381,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`,
@@ -1438,7 +1478,16 @@ ${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.`,
+  "`aso.title`: keep app name + the most relevant high-priority keyword, usually `App Name: Primary Keyword`.",
+  "`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.",
+  "`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,
@@ -1453,6 +1502,12 @@ function generatePrimaryOptimizationPrompt(args) {
 `;
   prompt += `Product: ${slug} | Category: ${category || "N/A"} | Primary: ${primaryLocale}
 
+`;
+  prompt += `## ASO Basics
+
+`;
+  prompt += `- ${ASO_RULES_SUMMARY}
+
 `;
   prompt += `## Task
 
@@ -1510,18 +1565,18 @@ ${researchSections.join("\n")}
 `;
   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
 `;
@@ -1562,11 +1617,15 @@ ${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 += `- Maximize keyword field utilization: target 90-100/100 chars when enough relevant keywords exist; explain any lower count
 `;
-  prompt += `- Ensure App Store/Play Store rules from ${FIELD_LIMITS_DOC_PATH2} are satisfied (no disallowed characters/formatting)
+  prompt += `- Remove keyword duplicates (unique list; avoid repeating title/subtitle terms verbatim; 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
@@ -1610,18 +1669,18 @@ ${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)
 `;
   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 += `---
@@ -1665,6 +1724,12 @@ function generateKeywordLocalizationPrompt(args) {
     ", "
   )}
 
+`;
+  prompt += `## ASO Basics
+
+`;
+  prompt += `- ${ASO_RULES_SUMMARY}
+
 `;
   if (batchIndex !== void 0 && totalBatches !== void 0) {
     prompt += `**\u26A0\uFE0F BATCH PROCESSING MODE**
@@ -1694,7 +1759,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)
 
@@ -1798,17 +1863,17 @@ ${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 should not repeat title/subtitle terms verbatim
 `;
   prompt += `5. **Replace keywords in existing sentences** - swap ONLY the keywords, keep everything else:
 `;
@@ -1850,11 +1915,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)
@@ -1895,7 +1960,7 @@ ${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; avoid repeating title/subtitle terms verbatim; no spaces after commas)
 `;
   prompt += `5. **SAVE the updated JSON to file** using save-locale-file tool
 `;
@@ -1975,13 +2040,13 @@ ${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; not repeating title/subtitle)
 `;
   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**
@@ -2382,6 +2447,7 @@ This tool returns a PROMPT containing:
 - 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
@@ -2571,8 +2637,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
@@ -2695,10 +2762,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("");
   }
@@ -2713,7 +2796,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.4",
+  "version": "1.10.6",
   "type": "module",
   "description": "MCP server for ASO data management with shared types and utilities",
   "author": "skyu",
@@ -57,6 +57,7 @@
   "scripts": {
     "build": "tsup src/index.ts src/browser.ts src/bin/mcp-server.ts --format esm --dts --external node:fs --external node:path --external node:os",
     "dev": "tsx src/bin/mcp-server.ts",
+    "test": "tsx --test \"tests/**/*.test.ts\"",
     "typecheck": "tsc --noEmit",
     "prepublishOnly": "npm run build"
   },