npm - @scoutello/i18n-magic - Versions diffs - 0.59.1 → 0.61.0 - Mend

@scoutello/i18n-magic 0.59.1 → 0.61.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (17) hide show

package/README.md +20 -14
package/dist/cli.js +16 -4
package/dist/cli.js.map +1 -1
package/dist/commands/remove-key.d.ts +3 -0
package/dist/commands/remove-key.d.ts.map +1 -0
package/dist/commands/remove-key.js +93 -0
package/dist/commands/remove-key.js.map +1 -0
package/dist/lib/utils.d.ts.map +1 -1
package/dist/lib/utils.js +94 -65
package/dist/lib/utils.js.map +1 -1
package/dist/mcp-server.js +50 -103
package/dist/mcp-server.js.map +1 -1
package/package.json +1 -1
package/src/cli.ts +18 -5
package/src/commands/remove-key.ts +123 -0
package/src/lib/utils.ts +102 -74
package/src/mcp-server.ts +61 -131

package/README.md CHANGED Viewed

@@ -30,11 +30,12 @@ Stop context switching. Let AI handle your translations while you stay in your c
 ## CLI Commands
 ```bash
-npx @scoutello/i18n-magic scan          # Find & add missing translations
-npx @scoutello/i18n-magic sync          # Translate to all languages
-npx @scoutello/i18n-magic replace [key] # Update existing translation
-npx @scoutello/i18n-magic clean         # Remove unused keys
-npx @scoutello/i18n-magic check-missing # CI/CD validation
+npx @scoutello/i18n-magic scan            # Find & add missing translations
+npx @scoutello/i18n-magic sync            # Translate to all languages
+npx @scoutello/i18n-magic replace [key]   # Update existing translation
+npx @scoutello/i18n-magic remove-key [key] # Remove a specific key
+npx @scoutello/i18n-magic clean           # Remove unused keys
+npx @scoutello/i18n-magic check-missing   # CI/CD validation
 ```
 **`scan`** - Scans your codebase for missing keys, prompts you for values, auto-translates to all locales.
@@ -43,6 +44,8 @@ npx @scoutello/i18n-magic check-missing # CI/CD validation
 **`replace`** - Update an existing translation key across all locales. Detects which namespaces use the key automatically.
+**`remove-key`** - Remove a specific translation key from all namespaces and locales. Useful when deprecating keys.
 **`clean`** - Removes unused translation keys from all locales. Great for keeping files lean.
 **`check-missing`** - Dry-run check. Exits with error code if translations are missing. Perfect for CI pipelines.
@@ -66,21 +69,24 @@ Result: Separate files per feature (`common.json`, `dashboard.json`, `mobile.jso
 **MCP (Model Context Protocol)** = API for AI agents.
-Install the i18n-magic MCP server in Cursor, and your AI gets 5 new tools:
+Install the i18n-magic MCP server in Cursor, and your AI gets 6 tools:
 ### 1. `search_translations` - Prevent Duplicates
 Fuzzy search across all translations. AI searches before adding anything.
 ### 2. `add_translation_key` - Add New Keys
-Adds key to English (`en`) locale. Run `sync` afterward to translate to other languages.
+Adds a single key. If API translation is configured, it auto-translates to other locales; otherwise run `sync`.
+### 3. `add_translation_keys` - Add Multiple Keys Fast
+Batch add 2+ keys in one call with better performance than multiple single-key calls.
-### 3. `get_translation_key` - Check What Exists
+### 4. `get_translation_key` - Check What Exists
 Retrieve current value for any key.
-### 4. `update_translation_key` - Fix & Auto-Translate
+### 5. `update_translation_key` - Fix & Auto-Translate
 Update a key and **instantly translate to all languages**. No sync needed!
-### 5. `list_untranslated_keys` - Batch Check
+### 6. `list_untranslated_keys` - Batch Check
 Show all missing keys across your codebase.
 ---
@@ -160,9 +166,9 @@ Done! Test by asking: *"Search for translations with 'password'"*
 **Result**: No duplicate keys, instant code.
 If nothing exists:
-- AI adds key to English: `add_translation_key`
-- You run: `npx @scoutello/i18n-magic sync`
-- Translated to all languages!
+- AI adds key(s): `add_translation_key` or `add_translation_keys`
+- If API translation is configured, other locales are updated automatically
+- If not configured, run: `npx @scoutello/i18n-magic sync`
 ### Pattern 2: Updating Translations
@@ -329,7 +335,7 @@ ls -la i18n-magic.js
 npx @scoutello/i18n-magic sync
 ```
-`add_translation_key` only adds English. `sync` translates to other languages.
+`add_translation_key`/`add_translation_keys` translate automatically when API translation is configured; otherwise run `sync`.
 ### MCP Tools Not Appearing

package/dist/cli.js CHANGED Viewed

@@ -4,6 +4,7 @@ import dotenv from "dotenv";
 import OpenAI from "openai";
 import { checkMissing } from "./commands/check-missing.js";
 import { removeUnusedKeys } from "./commands/clean.js";
+import { removeKey } from "./commands/remove-key.js";
 import { replaceTranslation } from "./commands/replace.js";
 import { restoreFromNamespaces } from "./commands/restore-from-namespaces.js";
 import { translateMissing } from "./commands/scan.js";
@@ -47,18 +48,29 @@ const commands = [
         description: "Restore missing keys by searching for them in other namespace files across all locales.",
         action: restoreFromNamespaces,
     },
+    {
+        name: "remove-key",
+        description: "Remove a specific translation key from all namespaces and locales.",
+        action: removeKey,
+    },
 ];
 for (const command of commands) {
     const cmd = program.command(command.name).description(command.description);
-    // Add key option to replace command
+    // Add key option to replace and remove-key commands
     if (command.name === "replace") {
         cmd
             .option("-k, --key <key>", "translation key to replace")
             .allowExcessArguments(true)
             .argument("[key]", "translation key to replace");
     }
+    if (command.name === "remove-key") {
+        cmd
+            .option("-k, --key <key>", "translation key to remove")
+            .allowExcessArguments(true)
+            .argument("[key]", "translation key to remove");
+    }
     cmd.action(async (arg, options) => {
-        const res = dotenv.config({
+        dotenv.config({
             path: program.opts().env || ".env",
         });
         const config = await loadConfig({
@@ -81,8 +93,8 @@ for (const command of commands) {
                 baseURL: "https://generativelanguage.googleapis.com/v1beta/openai/",
             }),
         });
-        // For replace command, check for key in argument or option
-        if (command.name === "replace") {
+        // For replace and remove-key commands, check for key in argument or option
+        if (command.name === "replace" || command.name === "remove-key") {
             // If key is provided as positional argument, use that first
             const keyToUse = typeof arg === "string" ? arg : options.key;
             command.action({ ...config, openai }, keyToUse);

package/dist/cli.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,MAAM,MAAM,QAAQ,CAAA;AAC3B,OAAO,MAAM,MAAM,QAAQ,CAAA;AAC3B,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;~~AAEtD~~,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAA;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAA;AAExD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AAE3C,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAA;AAE7B,OAAO;KACJ,IAAI,CAAC,YAAY,CAAC;KAClB,WAAW,CACV,6FAA6F,CAC9F;KACA,OAAO,CAAC,OAAO,CAAC;KAChB,MAAM,CAAC,qBAAqB,EAAE,qBAAqB,CAAC;KACpD,MAAM,CAAC,kBAAkB,EAAE,mBAAmB,CAAC,CAAA;AAElD,MAAM,QAAQ,GAAkB;IAC9B;QACE,IAAI,EAAE,MAAM;QACZ,WAAW,EACT,uHAAuH;QACzH,MAAM,EAAE,gBAAgB;KACzB;IACD;QACE,IAAI,EAAE,SAAS;QACf,WAAW,EACT,6GAA6G;QAC/G,MAAM,EAAE,kBAAkB;KAC3B;IACD;QACE,IAAI,EAAE,eAAe;QACrB,WAAW,EACT,yFAAyF;QAC3F,MAAM,EAAE,YAAY;KACrB;IACD;QACE,IAAI,EAAE,MAAM;QACZ,WAAW,EACT,gHAAgH;QAClH,MAAM,EAAE,WAAW;KACpB;IACD;QACE,IAAI,EAAE,OAAO;QACb,WAAW,EACT,yFAAyF;QAC3F,MAAM,EAAE,gBAAgB;KACzB;IACD;QACE,IAAI,EAAE,yBAAyB;QAC/B,WAAW,EACT,yFAAyF;QAC3F,MAAM,EAAE,qBAAqB;KAC9B;CACF,CAAA;AAED,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;IAC/B,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,WAAW,CAAC,CAAA;IAE1E,~~oCAAoC~~;~~IACpC~~,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC/B,GAAG;aACA,MAAM,CAAC,iBAAiB,EAAE,4BAA4B,CAAC;aACvD,oBAAoB,CAAC,IAAI,CAAC;aAC1B,QAAQ,CAAC,OAAO,EAAE,4BAA4B,CAAC,CAAA;IACpD,CAAC;IAED,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE;QAChC,MAAM,~~GAAG,GAAG,MAAM,~~CAAC,MAAM,CAAC;~~YACxB~~,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,MAAM;SACnC,CAAC,CAAA;QAEF,MAAM,MAAM,GAAkB,MAAM,UAAU,CAAC;YAC7C,UAAU,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM;SAClC,CAAC,CAAA;QAEF,MAAM,QAAQ,GAAI,MAAM,CAAC,KAAgB,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAA;QAE7D,+BAA+B;QAC/B,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAA;QACvC,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAA;QAEvC,6CAA6C;QAC7C,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAA;QAE5C,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,gBAAgB,CAAA;YAC9D,OAAO,CAAC,KAAK,CACX,mBAAmB,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,8CAA8C,OAAO,GAAG,CAC7G,CAAA;YACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACjB,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC;YACxB,MAAM,EAAE,GAAG;YACX,GAAG,CAAC,QAAQ,IAAI;gBACd,OAAO,EAAE,0DAA0D;aACpE,CAAC;SACH,CAAC,CAAA;QAEF,~~2DAA2D~~;~~QAC3D~~,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;~~YAC/B~~,4DAA4D;YAC5D,MAAM,QAAQ,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAA;YAC5D,OAAO,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,EAAE,QAAQ,CAAC,CAAA;QACjD,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;QACvC,CAAC;IACH,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA"}
1	+ {"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/commands/remove-key.d.ts ADDED Viewed

@@ -0,0 +1,3 @@
+import type { Configuration } from "../lib/types.js";
+export declare const removeKey: (config: Configuration, key?: string) => Promise<void>;
+//# sourceMappingURL=remove-key.d.ts.map

package/dist/commands/remove-key.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"remove-key.d.ts","sourceRoot":"","sources":["../../src/commands/remove-key.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAGpD,eAAO,MAAM,SAAS,GAAU,QAAQ,aAAa,EAAE,MAAM,MAAM,kBAsHlE,CAAA"}

package/dist/commands/remove-key.js ADDED Viewed

@@ -0,0 +1,93 @@
+import prompts from "prompts";
+import { loadLocalesFile, writeLocalesFile } from "../lib/utils.js";
+export const removeKey = async (config, key) => {
+    const { namespaces, locales, loadPath, savePath } = config;
+    if (!key) {
+        const response = await prompts({
+            type: "text",
+            name: "key",
+            message: "Enter the translation key to remove:",
+            validate: (value) => (value ? true : "Key cannot be empty"),
+            onState: (state) => {
+                if (state.aborted) {
+                    process.nextTick(() => {
+                        process.exit(0);
+                    });
+                }
+            },
+        });
+        key = response.key;
+    }
+    if (!key) {
+        console.log("\n❌ Operation cancelled. No key was provided.");
+        return;
+    }
+    console.log(`\n🔍 Searching for key "${key}" across all namespaces and locales...`);
+    const foundIn = [];
+    for (const namespace of namespaces) {
+        for (const locale of locales) {
+            try {
+                const existingKeys = await loadLocalesFile(loadPath, locale, namespace, {
+                    silent: true,
+                });
+                if (Object.hasOwn(existingKeys, key)) {
+                    foundIn.push({ namespace, locale });
+                }
+            }
+            catch {
+                // Skip if file doesn't exist or can't be read
+            }
+        }
+    }
+    if (foundIn.length === 0) {
+        console.log(`\n❌ Key "${key}" not found in any namespace or locale.`);
+        return;
+    }
+    console.log(`\n⚠️  Key "${key}" found in ${foundIn.length} location(s):\n`);
+    const maxToShow = 20;
+    const itemsToShow = foundIn.slice(0, maxToShow);
+    for (const { namespace, locale } of itemsToShow) {
+        console.log(`   • ${locale}:${namespace}`);
+    }
+    if (foundIn.length > maxToShow) {
+        console.log(`   ... and ${foundIn.length - maxToShow} more`);
+    }
+    console.log("");
+    const { confirmed } = await prompts({
+        type: "confirm",
+        name: "confirmed",
+        message: `Do you want to remove "${key}" from ${foundIn.length} location(s)?`,
+        initial: false,
+        onState: (state) => {
+            if (state.aborted) {
+                process.nextTick(() => {
+                    process.exit(0);
+                });
+            }
+        },
+    });
+    if (!confirmed) {
+        console.log("\n❌ Operation cancelled. No keys were removed.");
+        return;
+    }
+    console.log(`\n🗑️  Removing key "${key}"...`);
+    let removedCount = 0;
+    for (const { namespace, locale } of foundIn) {
+        try {
+            const existingKeys = await loadLocalesFile(loadPath, locale, namespace, {
+                silent: true,
+            });
+            if (Object.hasOwn(existingKeys, key)) {
+                delete existingKeys[key];
+                await writeLocalesFile(savePath, locale, namespace, existingKeys);
+                removedCount++;
+                console.log(`   ✓ Removed from ${locale}:${namespace}`);
+            }
+        }
+        catch (error) {
+            console.error(`   ✗ Failed to remove from ${locale}:${namespace}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    console.log(`\n✅ Successfully removed key "${key}" from ${removedCount} location(s)`);
+};
+//# sourceMappingURL=remove-key.js.map

package/dist/commands/remove-key.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"remove-key.js","sourceRoot":"","sources":["../../src/commands/remove-key.ts"],"names":[],"mappings":"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"}

package/dist/lib/utils.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/lib/utils.ts"],"names":[],"mappings":"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~~EA6UA~~,CAAA;AAED,eAAO,MAAM,iBAAiB,GAAU,mCAKrC;IACD,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,aAAa,CAAA;CACtB;;;;;EAYA,CAAA"}
1	+ {"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/lib/utils.ts"],"names":[],"mappings":"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"}

package/dist/lib/utils.js CHANGED Viewed

@@ -590,43 +590,86 @@ export const addTranslationKeys = async ({ keys, config, }) => {
     const scanTime = performance.now() - scanStartTime;
     log(`⏱️  Codebase scan completed in ${scanTime.toFixed(2)}ms`);
     // Step 2: Determine namespaces for each key
-    const keyToNamespaces = new Map();
-    for (const { key, language = "en" } of keys) {
-        const affectedNamespaces = [];
-        // Find entries for this specific key
-        const keyEntries = keysWithNamespaces.filter((entry) => entry.key === key || entry.key === `${defaultNamespace}:${key}`);
-        // Collect unique namespaces where this key is used
-        const foundNamespaces = new Set();
-        for (const entry of keyEntries) {
-            for (const ns of entry.namespaces) {
-                foundNamespaces.add(ns);
-            }
+    // Resolution order:
+    // 1) Explicit namespace prefix (e.g. "dashboard:welcome")
+    // 2) Code usage scan matches
+    // 3) Existing key in default locale namespace files
+    // 4) Key prefix matching a namespace (e.g. "dashboard.title")
+    // 5) Default namespace fallback
+    const defaultLocaleKeysByNamespace = new Map();
+    await Promise.all(namespaces.map(async (namespace) => {
+        try {
+            const nsKeys = await loadLocalesFile(loadPath, defaultLocale, namespace, {
+                silent: true,
+            });
+            defaultLocaleKeysByNamespace.set(namespace, nsKeys);
+        }
+        catch {
+            defaultLocaleKeysByNamespace.set(namespace, {});
         }
-        if (foundNamespaces.size > 0) {
-            affectedNamespaces.push(...Array.from(foundNamespaces));
+    }));
+    const preparedKeys = keys.map(({ key, value, language = "en" }) => {
+        const splitKey = key.split(":");
+        const hasExplicitNamespace = splitKey.length > 1 && namespaces.includes(splitKey[0]);
+        const normalizedKey = hasExplicitNamespace ? splitKey.slice(1).join(":") : key;
+        const explicitNamespace = hasExplicitNamespace ? splitKey[0] : null;
+        const foundNamespaces = new Set();
+        if (explicitNamespace) {
+            foundNamespaces.add(explicitNamespace);
         }
         else {
-            // If the key is not found in the codebase, use the default namespace
-            affectedNamespaces.push(defaultNamespace);
+            for (const entry of keysWithNamespaces) {
+                for (const namespace of entry.namespaces) {
+                    const pureKey = getPureKey(entry.key, namespace, namespace === defaultNamespace);
+                    if (entry.key === normalizedKey || pureKey === normalizedKey) {
+                        foundNamespaces.add(namespace);
+                    }
+                }
+            }
+            if (foundNamespaces.size === 0) {
+                for (const namespace of namespaces) {
+                    const namespaceKeys = defaultLocaleKeysByNamespace.get(namespace) || {};
+                    if (Object.hasOwn(namespaceKeys, normalizedKey)) {
+                        foundNamespaces.add(namespace);
+                    }
+                }
+            }
+            if (foundNamespaces.size === 0) {
+                const keyPrefix = normalizedKey.split(".")[0];
+                if (namespaces.includes(keyPrefix)) {
+                    foundNamespaces.add(keyPrefix);
+                }
+            }
         }
-        keyToNamespaces.set(key, new Set(affectedNamespaces));
-    }
+        if (foundNamespaces.size === 0) {
+            foundNamespaces.add(defaultNamespace);
+        }
+        return {
+            key: normalizedKey,
+            value,
+            language,
+            namespaces: foundNamespaces,
+        };
+    });
     // Step 3: Group keys by namespace and locale
     const namespaceLocaleToKeys = new Map();
-    for (const { key, value, language = "en" } of keys) {
-        const namespaces = keyToNamespaces.get(key) || new Set([defaultNamespace]);
-        for (const namespace of namespaces) {
-            const mapKey = `${namespace}:${language}`;
+    for (const keyEntry of preparedKeys) {
+        for (const namespace of keyEntry.namespaces) {
+            const mapKey = `${namespace}:${keyEntry.language}`;
             if (!namespaceLocaleToKeys.has(mapKey)) {
                 namespaceLocaleToKeys.set(mapKey, []);
             }
-            namespaceLocaleToKeys.get(mapKey).push({ key, value, language });
+            namespaceLocaleToKeys.get(mapKey).push({
+                key: keyEntry.key,
+                value: keyEntry.value,
+                language: keyEntry.language,
+            });
         }
     }
     // Step 4: Collect all unique namespaces that will be affected
     const affectedNamespaces = new Set();
-    for (const namespaces of keyToNamespaces.values()) {
-        for (const ns of namespaces) {
+    for (const keyEntry of preparedKeys) {
+        for (const ns of keyEntry.namespaces) {
             affectedNamespaces.add(ns);
         }
     }
@@ -634,25 +677,27 @@ export const addTranslationKeys = async ({ keys, config, }) => {
     // This ensures we preserve existing keys in all locales
     const fileIOStartTime = performance.now();
     const localeFiles = new Map();
+    const originalKeyCounts = new Map();
     const loadErrors = [];
-    // Load files for all locales × all affected namespaces - SEQUENTIALLY to avoid race conditions
+    // Load files for all locales × all affected namespaces in parallel (read-only)
+    const localeLoadPromises = [];
     for (const namespace of affectedNamespaces) {
         for (const locale of config.locales) {
             const fileKey = `${locale}:${namespace}`;
-            if (!localeFiles.has(fileKey)) {
-                try {
-                    const existingKeys = await loadLocalesFile(loadPath, locale, namespace, { silent: true });
-                    localeFiles.set(fileKey, existingKeys);
-                }
-                catch (error) {
-                    // Don't silently ignore - track the error and DO NOT set empty object
-                    const errorMsg = error instanceof Error ? error.message : String(error);
-                    loadErrors.push({ fileKey, error: errorMsg });
-                    log(`⚠️  Failed to load ${fileKey}: ${errorMsg}`);
-                }
-            }
-        }
-    }
+            localeLoadPromises.push(loadLocalesFile(loadPath, locale, namespace, { silent: true })
+                .then((existingKeys) => {
+                localeFiles.set(fileKey, existingKeys);
+                originalKeyCounts.set(fileKey, Object.keys(existingKeys).length);
+            })
+                .catch((error) => {
+                // Don't silently ignore - track the error and DO NOT set empty object
+                const errorMsg = error instanceof Error ? error.message : String(error);
+                loadErrors.push({ fileKey, error: errorMsg });
+                log(`⚠️  Failed to load ${fileKey}: ${errorMsg}`);
+            }));
+        }
+    }
+    await Promise.all(localeLoadPromises);
     // If any files failed to load, abort to prevent data loss
     if (loadErrors.length > 0) {
         throw new Error(`Failed to load ${loadErrors.length} locale file(s). Aborting to prevent data loss.\n` +
@@ -677,14 +722,14 @@ export const addTranslationKeys = async ({ keys, config, }) => {
     if (openai) {
         // Group keys by input language
         const keysByLanguage = new Map();
-        for (const { key, value, language = "en" } of keys) {
-            if (!keysByLanguage.has(language)) {
-                keysByLanguage.set(language, []);
+        for (const keyEntry of preparedKeys) {
+            if (!keysByLanguage.has(keyEntry.language)) {
+                keysByLanguage.set(keyEntry.language, []);
             }
-            keysByLanguage.get(language).push({
-                key,
-                value,
-                namespaces: keyToNamespaces.get(key) || new Set([defaultNamespace]),
+            keysByLanguage.get(keyEntry.language).push({
+                key: keyEntry.key,
+                value: keyEntry.value,
+                namespaces: keyEntry.namespaces,
             });
         }
         // Translate each language group to all other locales
@@ -741,22 +786,6 @@ export const addTranslationKeys = async ({ keys, config, }) => {
     // Step 8: Validate and write all files
     // Safety check: ensure we're not accidentally removing keys (only adding)
     const writeStartTime = performance.now();
-    const originalKeyCounts = new Map();
-    // Store original key counts for validation
-    for (const namespace of affectedNamespaces) {
-        for (const locale of config.locales) {
-            const fileKey = `${locale}:${namespace}`;
-            try {
-                const original = await loadLocalesFile(loadPath, locale, namespace, {
-                    silent: true,
-                });
-                originalKeyCounts.set(fileKey, Object.keys(original).length);
-            }
-            catch {
-                originalKeyCounts.set(fileKey, 0);
-            }
-        }
-    }
     // Validate: new file should have at least as many keys as original
     for (const [fileKey, newKeys] of localeFiles) {
         const originalCount = originalKeyCounts.get(fileKey) || 0;
@@ -776,8 +805,8 @@ export const addTranslationKeys = async ({ keys, config, }) => {
     const totalTime = performance.now() - startTime;
     log(`✅ Batch operation completed in ${totalTime.toFixed(2)}ms (${(totalTime / keys.length).toFixed(2)}ms per key)`);
     // Build results
-    const results = keys.map(({ key, value, language = "en" }) => {
-        const namespaces = Array.from(keyToNamespaces.get(key) || new Set([defaultNamespace]));
+    const results = preparedKeys.map(({ key, value, language, namespaces }) => {
+        const resolvedNamespaces = Array.from(namespaces);
         const savedLocales = new Set([language]);
         if (openai) {
             config.locales.forEach((locale) => {
@@ -792,7 +821,7 @@ export const addTranslationKeys = async ({ keys, config, }) => {
         return {
             key,
             value,
-            namespace: namespaces.join(", "),
+            namespace: resolvedNamespaces.join(", "),
             locale: Array.from(savedLocales).sort().join(", "),
         };
     });