From c7881edbd1f7ff26e90c91ad9836a72d2b52013c Mon Sep 17 00:00:00 2001
From: Hannes Rudolph <hrudolph@gmail.com>
Date: Wed, 10 Dec 2025 00:33:53 -0700
Subject: [PATCH] feat: add debug logging for invalid toolAliases specs

Adds console.warn when invalid alias specs are ignored (missing colon,
colon at start/end) to help users troubleshoot misconfigured aliases.
---
 src/core/prompts/tools/filter-tools-for-mode.ts | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/src/core/prompts/tools/filter-tools-for-mode.ts b/src/core/prompts/tools/filter-tools-for-mode.ts
index 67d73cee93..5463a1252d 100644
--- a/src/core/prompts/tools/filter-tools-for-mode.ts
+++ b/src/core/prompts/tools/filter-tools-for-mode.ts
@@ -25,6 +25,11 @@ export function parseToolAliases(toolAliases: string[] | undefined): Map<string,
 			const originalName = aliasSpec.substring(0, colonIndex)
 			const aliasName = aliasSpec.substring(colonIndex + 1)
 			aliasMap.set(originalName, aliasName)
+		} else {
+			// Log invalid alias specs to help users troubleshoot misconfigured aliases
+			console.warn(
+				`[toolAliases] Ignoring invalid alias spec "${aliasSpec}". Expected format: "originalName:aliasName"`,
+			)
 		}
 	}