lingo.dev 0.111.3 → 0.111.5

package/build/cli.mjs

@@ -216,6 +216,7 @@ var docLinks = {
 };
 var CLIError = class extends Error {
   docUrl;
+  errorType = "cli_error";
   constructor({ message, docUrl }) {
     super(message);
     this.docUrl = docLinks[docUrl];
@@ -223,6 +224,137 @@ var CLIError = class extends Error {
  visit: ${this.docUrl}`;
   }
 };
+var ConfigError = class extends CLIError {
+  errorType = "config_error";
+  constructor({ message, docUrl }) {
+    super({ message, docUrl });
+    this.name = "ConfigError";
+  }
+};
+var AuthenticationError = class extends CLIError {
+  errorType = "auth_error";
+  constructor({ message, docUrl }) {
+    super({ message, docUrl });
+    this.name = "AuthenticationError";
+  }
+};
+var ValidationError = class extends CLIError {
+  errorType = "validation_error";
+  constructor({ message, docUrl }) {
+    super({ message, docUrl });
+    this.name = "ValidationError";
+  }
+};
+var LocalizationError = class extends Error {
+  errorType = "locale_error";
+  bucket;
+  sourceLocale;
+  targetLocale;
+  pathPattern;
+  constructor(message, context) {
+    super(message);
+    this.name = "LocalizationError";
+    this.bucket = context?.bucket;
+    this.sourceLocale = context?.sourceLocale;
+    this.targetLocale = context?.targetLocale;
+    this.pathPattern = context?.pathPattern;
+  }
+};
+var BucketProcessingError = class extends Error {
+  errorType = "bucket_error";
+  bucket;
+  constructor(message, bucket) {
+    super(message);
+    this.name = "BucketProcessingError";
+    this.bucket = bucket;
+  }
+};
+function isConfigError(error) {
+  return error instanceof ConfigError || error.errorType === "config_error";
+}
+function isAuthenticationError(error) {
+  return error instanceof AuthenticationError || error.errorType === "auth_error";
+}
+function isValidationError(error) {
+  return error instanceof ValidationError || error.errorType === "validation_error";
+}
+function isLocalizationError(error) {
+  return error instanceof LocalizationError || error.errorType === "locale_error";
+}
+function isBucketProcessingError(error) {
+  return error instanceof BucketProcessingError || error.errorType === "bucket_error";
+}
+function getCLIErrorType(error) {
+  if (isConfigError(error)) return "config_error";
+  if (isAuthenticationError(error)) return "auth_error";
+  if (isValidationError(error)) return "validation_error";
+  if (isLocalizationError(error)) return "locale_error";
+  if (isBucketProcessingError(error)) return "bucket_error";
+  if (error instanceof CLIError) return "cli_error";
+  return "unknown_error";
+}
+function createPreviousErrorContext(errorDetails) {
+  if (errorDetails.length === 0) return void 0;
+  return {
+    count: errorDetails.length,
+    types: [...new Set(errorDetails.map((e) => e.type))],
+    buckets: [...new Set(errorDetails.map((e) => e.bucket).filter(Boolean))]
+  };
+}
+function aggregateErrorAnalytics(errorDetails, buckets, targetLocales, i18nConfig) {
+  if (errorDetails.length === 0) {
+    return {
+      errorCount: 0,
+      errorTypes: [],
+      errorsByBucket: {},
+      errorsByType: {},
+      firstError: void 0,
+      bucketCount: buckets.length,
+      localeCount: targetLocales.length,
+      i18nConfig: {
+        sourceLocale: i18nConfig.locale.source,
+        targetLocales: i18nConfig.locale.targets,
+        bucketTypes: Object.keys(i18nConfig.buckets)
+      }
+    };
+  }
+  const errorsByBucket = errorDetails.reduce(
+    (acc, error) => {
+      if (error.bucket) {
+        acc[error.bucket] = (acc[error.bucket] || 0) + 1;
+      }
+      return acc;
+    },
+    {}
+  );
+  const errorsByType = errorDetails.reduce(
+    (acc, error) => {
+      acc[error.type] = (acc[error.type] || 0) + 1;
+      return acc;
+    },
+    {}
+  );
+  return {
+    errorCount: errorDetails.length,
+    errorTypes: [...new Set(errorDetails.map((e) => e.type))],
+    errorsByBucket,
+    errorsByType,
+    firstError: {
+      type: errorDetails[0].type,
+      bucket: errorDetails[0].bucket,
+      locale: errorDetails[0].locale,
+      pathPattern: errorDetails[0].pathPattern,
+      message: errorDetails[0].message
+    },
+    bucketCount: buckets.length,
+    localeCount: targetLocales.length,
+    i18nConfig: {
+      sourceLocale: i18nConfig.locale.source,
+      targetLocales: i18nConfig.locale.targets,
+      bucketTypes: Object.keys(i18nConfig.buckets)
+    }
+  };
+}
 
 // src/cli/utils/cloudflare-status.ts
 async function checkCloudflareStatus() {
@@ -926,9 +1058,9 @@ function makeGitlabInitializer(spinner) {
 
 // src/cli/cmd/init.ts
 import open2 from "open";
-var openUrl = (path17) => {
+var openUrl = (path18) => {
   const settings = getSettings(void 0);
-  open2(`${settings.auth.webUrl}${path17}`, { wait: false });
+  open2(`${settings.auth.webUrl}${path18}`, { wait: false });
 };
 var throwHelpError = (option, value) => {
   if (value === "help") {
@@ -1348,8 +1480,8 @@ var files_default = new Command6().command("files").description("Print out the l
           } else if (type.target) {
             result.push(...targetPaths);
           }
-          result.forEach((path17) => {
-            console.log(path17);
+          result.forEach((path18) => {
+            console.log(path18);
           });
         }
       }
@@ -1667,8 +1799,8 @@ function extractCommentsFromJsonc(jsoncString) {
         const keyMatch = line.match(/^\s*["']?([^"':,\s]+)["']?\s*:/);
         if (keyMatch) {
           const key = keyMatch[1];
-          const path17 = contextStack.map((ctx) => ctx.key).filter(Boolean);
-          keyInfo = { key, path: path17 };
+          const path18 = contextStack.map((ctx) => ctx.key).filter(Boolean);
+          keyInfo = { key, path: path18 };
         }
       } else {
         keyInfo = findAssociatedKey(lines, commentData.lineIndex, contextStack);
@@ -1752,8 +1884,8 @@ function findAssociatedKey(lines, commentLineIndex, contextStack) {
     const keyMatch = line.match(/^\s*["']?([^"':,\s]+)["']?\s*:/);
     if (keyMatch) {
       const key = keyMatch[1];
-      const path17 = contextStack.map((ctx) => ctx.key).filter(Boolean);
-      return { key, path: path17 };
+      const path18 = contextStack.map((ctx) => ctx.key).filter(Boolean);
+      return { key, path: path18 };
     }
   }
   return { key: null, path: [] };
@@ -1772,9 +1904,9 @@ function updateContext(contextStack, line, parsedJson) {
     }
   }
 }
-function setCommentAtPath(comments, path17, key, hint) {
+function setCommentAtPath(comments, path18, key, hint) {
   let current = comments;
-  for (const pathKey of path17) {
+  for (const pathKey of path18) {
     if (!current[pathKey]) {
       current[pathKey] = {};
     }
@@ -2435,9 +2567,9 @@ function createHtmlLoader() {
         const bDepth = b.split("/").length;
         return aDepth - bDepth;
       });
-      paths.forEach((path17) => {
-        const value = data[path17];
-        const [nodePath, attribute] = path17.split("#");
+      paths.forEach((path18) => {
+        const value = data[path18];
+        const [nodePath, attribute] = path18.split("#");
         const [rootTag, ...indices] = nodePath.split("/");
         let parent = rootTag === "head" ? document.head : document.body;
         let current = parent;
@@ -4080,24 +4212,24 @@ function createRawDatoValue(parsedDatoValue, originalRawDatoValue, isClean = fal
 }
 function serializeStructuredText(rawStructuredText) {
   return serializeStructuredTextNode(rawStructuredText);
-  function serializeStructuredTextNode(node, path17 = [], acc = {}) {
+  function serializeStructuredTextNode(node, path18 = [], acc = {}) {
     if ("document" in node) {
       return serializeStructuredTextNode(
         node.document,
-        [...path17, "document"],
+        [...path18, "document"],
         acc
       );
     }
     if (!_18.isNil(node.value)) {
-      acc[[...path17, "value"].join(".")] = node.value;
+      acc[[...path18, "value"].join(".")] = node.value;
     } else if (_18.get(node, "type") === "block") {
-      acc[[...path17, "item"].join(".")] = serializeBlock(node.item);
+      acc[[...path18, "item"].join(".")] = serializeBlock(node.item);
     }
     if (node.children) {
       for (let i = 0; i < node.children.length; i++) {
         serializeStructuredTextNode(
           node.children[i],
-          [...path17, i.toString()],
+          [...path18, i.toString()],
           acc
         );
       }
@@ -4164,8 +4296,8 @@ function deserializeBlockList(parsedBlockList, originalRawBlockList, isClean = f
 }
 function deserializeStructuredText(parsedStructuredText, originalRawStructuredText) {
   const result = _18.cloneDeep(originalRawStructuredText);
-  for (const [path17, value] of _18.entries(parsedStructuredText)) {
-    const realPath = _18.chain(path17.split(".")).flatMap((s) => !_18.isNaN(_18.toNumber(s)) ? ["children", s] : s).value();
+  for (const [path18, value] of _18.entries(parsedStructuredText)) {
+    const realPath = _18.chain(path18.split(".")).flatMap((s) => !_18.isNaN(_18.toNumber(s)) ? ["children", s] : s).value();
     const deserializedValue = createRawDatoValue(
       value,
       _18.get(originalRawStructuredText, realPath),
@@ -4591,15 +4723,15 @@ function parseTypeScript(input2) {
 function extractStringsFromDefaultExport(ast) {
   let extracted = {};
   traverse(ast, {
-    ExportDefaultDeclaration(path17) {
-      const { declaration } = path17.node;
+    ExportDefaultDeclaration(path18) {
+      const { declaration } = path18.node;
       const decl = unwrapTSAsExpression(declaration);
       if (t.isObjectExpression(decl)) {
         extracted = objectExpressionToObject(decl);
       } else if (t.isArrayExpression(decl)) {
         extracted = arrayExpressionToArray(decl);
       } else if (t.isIdentifier(decl)) {
-        const binding = path17.scope.bindings[decl.name];
+        const binding = path18.scope.bindings[decl.name];
         if (binding && t.isVariableDeclarator(binding.path.node) && binding.path.node.init) {
           const initRaw = binding.path.node.init;
           const init = initRaw ? unwrapTSAsExpression(initRaw) : initRaw;
@@ -4664,8 +4796,8 @@ function arrayExpressionToArray(arrayExpression) {
 function updateStringsInDefaultExport(ast, data) {
   let modified = false;
   traverse(ast, {
-    ExportDefaultDeclaration(path17) {
-      const { declaration } = path17.node;
+    ExportDefaultDeclaration(path18) {
+      const { declaration } = path18.node;
       const decl = unwrapTSAsExpression(declaration);
       if (t.isObjectExpression(decl)) {
         modified = updateStringsInObjectExpression(decl, data) || modified;
@@ -4674,7 +4806,7 @@ function updateStringsInDefaultExport(ast, data) {
           modified = updateStringsInArrayExpression(decl, data) || modified;
         }
       } else if (t.isIdentifier(decl)) {
-        modified = updateStringsInExportedIdentifier(path17, data) || modified;
+        modified = updateStringsInExportedIdentifier(path18, data) || modified;
       }
     }
   });
@@ -4745,9 +4877,9 @@ function updateStringsInArrayExpression(arrayExpression, incoming) {
   });
   return modified;
 }
-function updateStringsInExportedIdentifier(path17, data) {
-  const exportName = path17.node.declaration.name;
-  const binding = path17.scope.bindings[exportName];
+function updateStringsInExportedIdentifier(path18, data) {
+  const exportName = path18.node.declaration.name;
+  const binding = path18.scope.bindings[exportName];
   if (!binding || !binding.path.node) return false;
   if (t.isVariableDeclarator(binding.path.node) && binding.path.node.init) {
     const initRaw = binding.path.node.init;
@@ -6349,11 +6481,11 @@ function _getAllKeys(obj, prefix = "") {
   let keys = [];
   for (const key in obj) {
     if (!Object.prototype.hasOwnProperty.call(obj, key)) continue;
-    const path17 = prefix ? `${prefix}.${key}` : key;
+    const path18 = prefix ? `${prefix}.${key}` : key;
     if (typeof obj[key] === "object" && obj[key] !== null && !Array.isArray(obj[key])) {
-      keys = keys.concat(_getAllKeys(obj[key], path17));
+      keys = keys.concat(_getAllKeys(obj[key], path18));
     } else {
-      keys.push(path17);
+      keys.push(path18);
     }
   }
   return keys;
@@ -6866,19 +6998,19 @@ function createJsonDictionaryLoader() {
         );
         return input2;
       }
-      function walk(obj, dataNode, path17 = []) {
+      function walk(obj, dataNode, path18 = []) {
         if (Array.isArray(obj) && Array.isArray(dataNode)) {
           obj.forEach(
-            (item, idx) => walk(item, dataNode[idx], [...path17, String(idx)])
+            (item, idx) => walk(item, dataNode[idx], [...path18, String(idx)])
           );
         } else if (obj && typeof obj === "object" && dataNode && typeof dataNode === "object" && !Array.isArray(dataNode)) {
           for (const key of Object.keys(obj)) {
             if (dataNode.hasOwnProperty(key)) {
-              walk(obj[key], dataNode[key], [...path17, key]);
+              walk(obj[key], dataNode[key], [...path18, key]);
             }
           }
         } else if (obj && typeof obj === "object" && !Array.isArray(obj) && typeof dataNode === "string") {
-          setNestedLocale(input2, path17, locale, dataNode, originalLocale);
+          setNestedLocale(input2, path18, locale, dataNode, originalLocale);
         }
       }
       walk(input2, data);
@@ -6906,14 +7038,14 @@ function extractTranslatables(obj, locale) {
 function isTranslatableObject(obj, locale) {
   return obj && typeof obj === "object" && !Array.isArray(obj) && Object.prototype.hasOwnProperty.call(obj, locale);
 }
-function setNestedLocale(obj, path17, locale, value, originalLocale) {
+function setNestedLocale(obj, path18, locale, value, originalLocale) {
   let curr = obj;
-  for (let i = 0; i < path17.length - 1; i++) {
-    const key = path17[i];
+  for (let i = 0; i < path18.length - 1; i++) {
+    const key = path18[i];
     if (!(key in curr)) curr[key] = {};
     curr = curr[key];
   }
-  const last = path17[path17.length - 1];
+  const last = path18[path18.length - 1];
   if (curr[last] && typeof curr[last] === "object") {
     curr[last][locale] = value;
     if (originalLocale && curr[last][originalLocale]) {
@@ -7483,7 +7615,11 @@ function trackEvent(distinctId, event, properties) {
         properties: {
           ...properties,
           $lib: "lingo.dev-cli",
-          $lib_version: process.env.npm_package_version || "unknown"
+          $lib_version: process.env.npm_package_version || "unknown",
+          // Essential debugging context only
+          node_version: process.version,
+          is_ci: !!process.env.CI,
+          debug_enabled: process.env.DEBUG === "true"
         },
         timestamp: (/* @__PURE__ */ new Date()).toISOString()
       };
@@ -7683,7 +7819,21 @@ var i18n_default = new Command12().command("i18n").description("Run Localization
 ).action(async function(options) {
   updateGitignore();
   const ora = Ora7();
-  const flags = parseFlags(options);
+  let flags;
+  try {
+    flags = parseFlags(options);
+  } catch (parseError) {
+    await trackEvent("unknown", "cmd.i18n.error", {
+      errorType: "validation_error",
+      errorName: parseError.name || "ValidationError",
+      errorMessage: parseError.message || "Invalid command line options",
+      errorStack: parseError.stack,
+      fatal: true,
+      errorCount: 1,
+      stage: "flag_validation"
+    });
+    throw parseError;
+  }
   if (flags.debug) {
     const { debug } = await inquirer2.prompt([
       {
@@ -7695,6 +7845,7 @@ var i18n_default = new Command12().command("i18n").description("Run Localization
   }
   let hasErrors = false;
   let authId = null;
+  const errorDetails = [];
   try {
     ora.start("Loading configuration...");
     const i18nConfig = getConfig();
@@ -7727,7 +7878,7 @@ var i18n_default = new Command12().command("i18n").description("Run Localization
     if (flags.file?.length) {
       buckets = buckets.map((bucket) => {
         const paths = bucket.paths.filter(
-          (path17) => flags.file.find((file) => path17.pathPattern?.includes(file))
+          (path18) => flags.file.find((file) => path18.pathPattern?.includes(file))
         );
         return { ...bucket, paths };
       }).filter((bucket) => bucket.paths.length > 0);
@@ -7742,8 +7893,8 @@ var i18n_default = new Command12().command("i18n").description("Run Localization
         ora.info(`\x1B[36mProcessing only filtered buckets:\x1B[0m`);
         buckets.map((bucket) => {
           ora.info(`  ${bucket.type}:`);
-          bucket.paths.forEach((path17) => {
-            ora.info(`    - ${path17.pathPattern}`);
+          bucket.paths.forEach((path18) => {
+            ora.info(`    - ${path18.pathPattern}`);
           });
         });
       }
@@ -7996,9 +8147,23 @@ var i18n_default = new Command12().command("i18n").description("Run Localization
                 );
               }
             } catch (_error) {
-              const error = new Error(
-                `[${sourceLocale} -> ${targetLocale}] Localization failed: ${_error.message}`
+              const error = new LocalizationError(
+                `[${sourceLocale} -> ${targetLocale}] Localization failed: ${_error.message}`,
+                {
+                  bucket: bucket.type,
+                  sourceLocale,
+                  targetLocale,
+                  pathPattern: bucketPath.pathPattern
+                }
               );
+              errorDetails.push({
+                type: "locale_error",
+                bucket: bucket.type,
+                locale: `${sourceLocale} -> ${targetLocale}`,
+                pathPattern: bucketPath.pathPattern,
+                message: _error.message,
+                stack: _error.stack
+              });
               if (flags.strict) {
                 throw error;
               } else {
@@ -8014,9 +8179,16 @@ var i18n_default = new Command12().command("i18n").description("Run Localization
           }
         }
       } catch (_error) {
-        const error = new Error(
-          `Failed to process bucket ${bucket.type}: ${_error.message}`
+        const error = new BucketProcessingError(
+          `Failed to process bucket ${bucket.type}: ${_error.message}`,
+          bucket.type
         );
+        errorDetails.push({
+          type: "bucket_error",
+          bucket: bucket.type,
+          message: _error.message,
+          stack: _error.stack
+        });
         if (flags.strict) {
           throw error;
         } else {
@@ -8029,20 +8201,54 @@ var i18n_default = new Command12().command("i18n").description("Run Localization
     if (!hasErrors) {
       ora.succeed("Localization completed.");
       await trackEvent(authId, "cmd.i18n.success", {
-        i18nConfig,
-        flags
+        i18nConfig: {
+          sourceLocale: i18nConfig.locale.source,
+          targetLocales: i18nConfig.locale.targets,
+          bucketTypes: Object.keys(i18nConfig.buckets)
+        },
+        flags,
+        bucketCount: buckets.length,
+        localeCount: targetLocales.length,
+        processedSuccessfully: true
       });
     } else {
       ora.warn("Localization completed with errors.");
       await trackEvent(authId || "unknown", "cmd.i18n.error", {
-        flags
+        flags,
+        ...aggregateErrorAnalytics(
+          errorDetails,
+          buckets,
+          targetLocales,
+          i18nConfig
+        )
       });
     }
   } catch (error) {
     ora.fail(error.message);
+    const errorType = getCLIErrorType(error);
+    let errorContext = {};
+    if (isLocalizationError(error)) {
+      errorContext = {
+        bucket: error.bucket,
+        sourceLocale: error.sourceLocale,
+        targetLocale: error.targetLocale,
+        pathPattern: error.pathPattern
+      };
+    } else if (isBucketProcessingError(error)) {
+      errorContext = {
+        bucket: error.bucket
+      };
+    }
     await trackEvent(authId || "unknown", "cmd.i18n.error", {
       flags,
-      error
+      errorType,
+      errorName: error.name || "Error",
+      errorMessage: error.message,
+      errorStack: error.stack,
+      errorContext,
+      fatal: true,
+      errorCount: errorDetails.length + 1,
+      previousErrors: createPreviousErrorContext(errorDetails)
     });
   }
 });
@@ -8063,7 +8269,7 @@ function parseFlags(options) {
 }
 async function validateAuth(settings) {
   if (!settings.auth.apiKey) {
-    throw new CLIError({
+    throw new AuthenticationError({
       message: "Not authenticated. Please run `lingo.dev login` to authenticate.",
       docUrl: "authError"
     });
@@ -8074,7 +8280,7 @@ async function validateAuth(settings) {
   });
   const user = await authenticator.whoami();
   if (!user) {
-    throw new CLIError({
+    throw new AuthenticationError({
       message: "Invalid API key. Please run `lingo.dev login` to authenticate.",
       docUrl: "authError"
     });
@@ -8083,24 +8289,24 @@ async function validateAuth(settings) {
 }
 function validateParams(i18nConfig, flags) {
   if (!i18nConfig) {
-    throw new CLIError({
+    throw new ConfigError({
       message: "i18n.json not found. Please run `lingo.dev init` to initialize the project.",
       docUrl: "i18nNotFound"
     });
   } else if (!i18nConfig.buckets || !Object.keys(i18nConfig.buckets).length) {
-    throw new CLIError({
+    throw new ConfigError({
       message: "No buckets found in i18n.json. Please add at least one bucket containing i18n content.",
       docUrl: "bucketNotFound"
     });
   } else if (flags.locale?.some((locale) => !i18nConfig.locale.targets.includes(locale))) {
-    throw new CLIError({
+    throw new ValidationError({
       message: `One or more specified locales do not exist in i18n.json locale.targets. Please add them to the list and try again.`,
       docUrl: "localeTargetNotFound"
     });
   } else if (flags.bucket?.some(
     (bucket) => !i18nConfig.buckets[bucket]
   )) {
-    throw new CLIError({
+    throw new ValidationError({
       message: `One or more specified buckets do not exist in i18n.json. Please add them to the list and try again.`,
       docUrl: "bucketNotFound"
     });
@@ -8533,7 +8739,7 @@ import { execSync as execSync2 } from "child_process";
 
 // src/cli/cmd/ci/flows/in-branch.ts
 import { execSync } from "child_process";
-import path16 from "path";
+import path17 from "path";
 
 // src/cli/cmd/ci/flows/_base.ts
 var IntegrationFlow = class {
@@ -8553,6 +8759,10 @@ function escapeShellArg(arg) {
 
 // src/cli/cmd/run/index.ts
 import { Command as Command16 } from "interactive-commander";
+import { exec } from "child_process";
+import path16 from "path";
+import { fileURLToPath } from "url";
+import os2 from "os";
 
 // src/cli/cmd/run/setup.ts
 import chalk10 from "chalk";
@@ -9296,14 +9506,14 @@ async function watch2(ctx) {
       pollInterval: 100
     }
   });
-  watcher.on("change", (path17) => {
-    handleFileChange(path17, state, ctx);
+  watcher.on("change", (path18) => {
+    handleFileChange(path18, state, ctx);
   });
-  watcher.on("add", (path17) => {
-    handleFileChange(path17, state, ctx);
+  watcher.on("add", (path18) => {
+    handleFileChange(path18, state, ctx);
   });
-  watcher.on("unlink", (path17) => {
-    handleFileChange(path17, state, ctx);
+  watcher.on("unlink", (path18) => {
+    handleFileChange(path18, state, ctx);
   });
   watcher.on("error", (error) => {
     console.error(
@@ -9414,8 +9624,9 @@ var flagsSchema2 = z2.object({
   sourceLocale: z2.string().optional(),
   targetLocale: z2.array(z2.string()).optional(),
   watch: z2.boolean().default(false),
-  debounce: z2.number().positive().default(5e3)
+  debounce: z2.number().positive().default(5e3),
   // 5 seconds default
+  sound: z2.boolean().optional()
 });
 
 // src/cli/cmd/run/_utils.ts
@@ -9434,6 +9645,32 @@ async function determineAuthId(ctx) {
 }
 
 // src/cli/cmd/run/index.ts
+var __dirname = path16.dirname(fileURLToPath(import.meta.url));
+function playSound(type) {
+  const platform = os2.platform();
+  return new Promise((resolve) => {
+    const assetDir = path16.join(__dirname, "../assets");
+    const soundFiles = [path16.join(assetDir, `${type}.mp3`)];
+    let command = "";
+    if (platform === "linux") {
+      command = soundFiles.map(
+        (file) => `mpg123 -q "${file}" 2>/dev/null || aplay "${file}" 2>/dev/null`
+      ).join(" || ");
+    } else if (platform === "darwin") {
+      command = soundFiles.map((file) => `afplay "${file}"`).join(" || ");
+    } else if (platform === "win32") {
+      command = `powershell -c "try { (New-Object Media.SoundPlayer '${soundFiles[1]}').PlaySync() } catch { Start-Process -FilePath '${soundFiles[0]}' -WindowStyle Hidden -Wait }"`;
+    } else {
+      command = soundFiles.map(
+        (file) => `aplay "${file}" 2>/dev/null || afplay "${file}" 2>/dev/null`
+      ).join(" || ");
+    }
+    exec(command, () => {
+      resolve();
+    });
+    setTimeout(resolve, 3e3);
+  });
+}
 var run_default = new Command16().command("run").description("Run Lingo.dev localization engine").helpOption("-h, --help", "Show help").option(
   "--source-locale <source-locale>",
   "Locale to use as source locale. Defaults to i18n.json locale.source"
@@ -9473,6 +9710,9 @@ var run_default = new Command16().command("run").description("Run Lingo.dev loca
   "--debounce <milliseconds>",
   "Debounce delay in milliseconds for watch mode (default: 5000ms)",
   (val) => parseInt(val)
+).option(
+  "--sound",
+  "Play sound on completion, partially completion and failed of the task"
 ).action(async (args) => {
   let authId = null;
   try {
@@ -9502,6 +9742,9 @@ var run_default = new Command16().command("run").description("Run Lingo.dev loca
     await renderSpacer();
     await renderSummary(ctx.results);
     await renderSpacer();
+    if (ctx.flags.sound) {
+      await playSound("success");
+    }
     if (ctx.flags.watch) {
       await watch2(ctx);
     }
@@ -9511,6 +9754,9 @@ var run_default = new Command16().command("run").description("Run Lingo.dev loca
     });
   } catch (error) {
     await trackEvent(authId || "unknown", "cmd.run.error", {});
+    if (args.sound) {
+      await playSound("failure");
+    }
     throw error;
   }
 });
@@ -9601,7 +9847,7 @@ var InBranchFlow = class extends IntegrationFlow {
         return false;
       }
     }
-    const workingDir = path16.resolve(
+    const workingDir = path17.resolve(
       process.cwd(),
       this.platformKit.config.workingDir
     );
@@ -10340,8 +10586,8 @@ var status_default = new Command18().command("status").description("Show the sta
     if (flags.file?.length) {
       buckets = buckets.map((bucket) => {
         const paths = bucket.paths.filter(
-          (path17) => flags.file.find(
-            (file) => path17.pathPattern?.includes(file) || path17.pathPattern?.match(file) || minimatch(path17.pathPattern, file)
+          (path18) => flags.file.find(
+            (file) => path18.pathPattern?.includes(file) || path18.pathPattern?.match(file) || minimatch(path18.pathPattern, file)
           )
         );
         return { ...bucket, paths };
@@ -10355,8 +10601,8 @@ var status_default = new Command18().command("status").description("Show the sta
         ora.info(`\x1B[36mProcessing only filtered buckets:\x1B[0m`);
         buckets.map((bucket) => {
           ora.info(`  ${bucket.type}:`);
-          bucket.paths.forEach((path17) => {
-            ora.info(`    - ${path17.pathPattern}`);
+          bucket.paths.forEach((path18) => {
+            ora.info(`    - ${path18.pathPattern}`);
           });
         });
       }
@@ -10640,10 +10886,10 @@ var status_default = new Command18().command("status").description("Show the sta
     if (flags.confirm && Object.keys(fileStats).length > 0) {
       console.log(chalk14.bold(`
 \u{1F4D1} BREAKDOWN BY FILE:`));
-      Object.entries(fileStats).sort((a, b) => b[1].wordCount - a[1].wordCount).forEach(([path17, stats]) => {
+      Object.entries(fileStats).sort((a, b) => b[1].wordCount - a[1].wordCount).forEach(([path18, stats]) => {
         if (stats.sourceKeys === 0) return;
         console.log(chalk14.bold(`
-\u2022 ${path17}:`));
+\u2022 ${path18}:`));
         console.log(
           `  ${stats.sourceKeys} source keys, ~${stats.wordCount.toLocaleString()} source words`
         );
@@ -10863,7 +11109,7 @@ async function renderHero2() {
 // package.json
 var package_default = {
   name: "lingo.dev",
-  version: "0.111.3",
+  version: "0.111.5",
   description: "Lingo.dev CLI",
   private: false,
   publishConfig: {
@@ -10961,7 +11207,8 @@ var package_default = {
   },
   files: [
     "bin",
-    "build"
+    "build",
+    "assets"
   ],
   scripts: {
     "lingo.dev": "node --inspect=9229 ./bin/cli.mjs",