fix(cli): decode URL-encoded keys before minimatch comparison in --key filtering

Author: AndreyHirsa

.changeset/salty-sails-sell.md

@@ -0,0 +1,5 @@
+---
+"lingo.dev": patch
+---
+
+Fixed --key pattern matching in run and purge commands by decoding URL-encoded keys before minimatch comparison

packages/cli/src/cli/cmd/purge.ts

@@ -123,7 +123,10 @@ export default new Command()
               if (options.key) {
                 // minimatch for key patterns
                 keysToRemove = Object.keys(newData).filter((k) =>
-                  minimatch(k, options.key!),
+                  minimatch(
+                    decodeURIComponent(k),
+                    decodeURIComponent(options.key!),
+                  ),
                 );
               } else {
                 // No key specified: remove all keys
@@ -133,7 +136,7 @@ export default new Command()
                 // Show what will be deleted
                 if (options.key) {
                   bucketOra.info(
-                    `About to delete ${keysToRemove.length} key(s) matching '${options.key}' from ${bucketPath.pathPattern} [${targetLocale}]:\n  ${keysToRemove.slice(0, 10).join(", ")}${keysToRemove.length > 10 ? ", ..." : ""}`,
+                    `About to delete ${keysToRemove.length} key(s) matching '${decodeURIComponent(options.key)}' from ${bucketPath.pathPattern} [${targetLocale}]:\n  ${keysToRemove.slice(0, 10).join(", ")}${keysToRemove.length > 10 ? ", ..." : ""}`,
                   );
                 } else {
                   bucketOra.info(
@@ -161,7 +164,7 @@ export default new Command()
                 await bucketLoader.push(targetLocale, newData);
                 if (options.key) {
                   bucketOra.succeed(
-                    `Removed ${keysToRemove.length} key(s) matching '${options.key}' from ${bucketPath.pathPattern} [${targetLocale}]`,
+                    `Removed ${keysToRemove.length} key(s) matching '${decodeURIComponent(options.key)}' from ${bucketPath.pathPattern} [${targetLocale}]`,
                   );
                 } else {
                   bucketOra.succeed(
@@ -170,7 +173,7 @@ export default new Command()
                 }
               } else if (options.key) {
                 bucketOra.info(
-                  `No keys matching '${options.key}' found in ${bucketPath.pathPattern} [${targetLocale}]`,
+                  `No keys matching '${decodeURIComponent(options.key)}' found in ${bucketPath.pathPattern} [${targetLocale}]`,
                 );
               } else {
                 bucketOra.info("No keys to remove.");

packages/cli/src/cli/cmd/run/execute.ts

@@ -231,7 +231,10 @@ function createWorkerTask(args: {
                 ([key]) =>
                   !assignedTask.onlyKeys.length ||
                   assignedTask.onlyKeys?.some((pattern) =>
-                    minimatch(key, pattern),
+                    minimatch(
+                      decodeURIComponent(key),
+                      decodeURIComponent(pattern),
+                    ),
                   ),
               )
               .fromPairs()

packages/cli/src/cli/utils/key-matching.ts

@@ -3,7 +3,7 @@ import { minimatch } from "minimatch";
 /**
  * Checks if a key matches any of the provided patterns using exact, separator-bounded prefix, or glob matching.
  * Separator-bounded means the key must equal the pattern exactly, or continue with a ".", "/", or "-" separator.
- * This prevents "inbox" from matching "inbox_url" while still matching "inbox.title", "inbox/details", or "heading-0".
+ * This prevents "inbox" from matching "inbox_url" while still matching "inbox.title", "inbox/details", or "inbox-0".
  */
 export function matchesKeyPattern(key: string, patterns: string[]): boolean {
   return patterns.some(