@yahoo/uds 3.109.0 → 3.110.0

package/dist/cli/commands/sync.cjs

@@ -8,6 +8,8 @@ const require_runtime_tooltipConfig = require('../../runtime/tooltipConfig.cjs')
 const require_analytics = require('../dist/utils/analytics.cjs');
 const require_colors = require('../dist/lib/colors.cjs');
 const require_print = require('../dist/lib/print.cjs');
+const require_box = require('../dist/lib/box.cjs');
+const require_config = require('../dist/utils/rules/config.cjs');
 const require_cli_commands_utils_sortKeys = require('./utils/sortKeys.cjs');
 let node_path = require("node:path");
 node_path = require_runtime.__toESM(node_path);
@@ -87,6 +89,8 @@ const syncCommand = {
 			const configContentJs = `${exportsJS.join("\n\n")}\n`;
 			(0, node_fs.writeFileSync)(fullPath, outFileExtension === "js" ? configContentJs : configContentTs);
 			require_print.print(require_colors.green(`✅ Synced UDS config ${id} to ${fullPath}`));
+			const staleEditors = require_config.getEditorsWithStaleRules(process.cwd());
+			if (staleEditors.length > 0) require_box.printBox([require_colors.bold(`Updated UDS rules are available for ${staleEditors.join(" and ")}.`), `Run ${require_colors.cyan("`uds editor-rules`")} to update.`]);
 			await require_analytics.trackEvent("sync", { id });
 		} catch (error) {
 			require_print.print(require_colors.red(`❌ ${error.message}`));

package/dist/cli/commands/sync.js

@@ -4,8 +4,10 @@ import { configToBreakpointsConfigContext } from "../../runtime/breakpointsConfi
 import { configToToastConfigContext } from "../../runtime/toastConfig.js";
 import { configToTooltipConfigContext } from "../../runtime/tooltipConfig.js";
 import { trackEvent } from "../dist/utils/analytics.js";
-import { green, magenta, red, yellow } from "../dist/lib/colors.js";
+import { bold, cyan, green, magenta, red, yellow } from "../dist/lib/colors.js";
 import { print } from "../dist/lib/print.js";
+import { printBox } from "../dist/lib/box.js";
+import { getEditorsWithStaleRules } from "../dist/utils/rules/config.js";
 import { sortKeys } from "./utils/sortKeys.js";
 import path from "node:path";
 import { writeFileSync } from "node:fs";
@@ -84,6 +86,8 @@ const syncCommand = {
 			const configContentJs = `${exportsJS.join("\n\n")}\n`;
 			writeFileSync(fullPath, outFileExtension === "js" ? configContentJs : configContentTs);
 			print(green(`✅ Synced UDS config ${id} to ${fullPath}`));
+			const staleEditors = getEditorsWithStaleRules(process.cwd());
+			if (staleEditors.length > 0) printBox([bold(`Updated UDS rules are available for ${staleEditors.join(" and ")}.`), `Run ${cyan("`uds editor-rules`")} to update.`]);
 			await trackEvent("sync", { id });
 		} catch (error) {
 			print(red(`❌ ${error.message}`));

package/dist/cli/dist/commands/editor-rules.cjs

@@ -20,7 +20,6 @@ var editor_rules_default = {
 			require_print.print(require_colors.green("Description: Generate editor rules for various code editors and AI tools"));
 			require_print.print("");
 			require_print.print(require_colors.yellow("Options:"));
-			require_print.print("  --force, -f     Force overwrite existing rules directory");
 			require_print.print("  --output, -o    Output directory (defaults to workspace root)");
 			require_print.print("  --editor, -e    Specific editor/tool (defaults to all)");
 			require_print.print("");
@@ -34,17 +33,17 @@ var editor_rules_default = {
 			require_print.print(require_colors.blue("Examples:"));
 			require_print.print("  uds editor-rules                    # Generate all rules in current directory");
 			require_print.print("  uds editor-rules --editor cursor    # Generate only Cursor rules");
+			require_print.print("  uds editor-rules --editor claude    # Generate only Claude Code rules");
 			require_print.print("  uds editor-rules --output /path     # Generate rules in specific directory");
-			require_print.print("  uds editor-rules --force            # Force overwrite existing rules");
 			require_print.print("");
 			require_print.print(require_colors.green("What it generates:"));
-			require_print.print("  • Cursor Rules (.cursor/uds/)");
+			require_print.print("  • Cursor Rules (.cursor/rules/uds/)");
+			require_print.print("  • Claude Code Rules (.claude/rules/uds/)");
 			return;
 		}
 		try {
 			const outputDir = options.output || process.cwd();
 			const selectedEditor = options.editor?.toLowerCase();
-			const force = options.force === "true" || options.force === true;
 			require_print.print(require_colors.blue(`📁 Generating editor rules in: ${outputDir}`));
 			if (selectedEditor) {
 				const editorConfig = require_config.getEditorConfig(selectedEditor);
@@ -58,19 +57,18 @@ var editor_rules_default = {
 					}
 					return;
 				}
-				await generateEditorRules(outputDir, selectedEditor, editorConfig, force);
+				await generateEditorRules(outputDir, editorConfig);
 			} else {
 				const editors = require_config.getAvailableEditors();
 				for (const editor of editors) {
 					const editorConfig = require_config.getEditorConfig(editor);
-					if (editorConfig) await generateEditorRules(outputDir, editor, editorConfig, force);
+					if (editorConfig) await generateEditorRules(outputDir, editorConfig);
 				}
 			}
 			require_print.print(require_colors.green("🎉 Editor rules generated successfully!"));
 			require_print.print(require_colors.blue("📝 Rules are now available for your development environment"));
 			await require_analytics.trackEvent("editor_rules_generated", {
 				output_dir: outputDir,
-				force: force || false,
 				editor: selectedEditor || "all"
 			});
 		} catch (error) {
@@ -79,7 +77,7 @@ var editor_rules_default = {
 		}
 	}
 };
-async function generateEditorRules(outputDir, editorName, editorConfig, force = false) {
+async function generateEditorRules(outputDir, editorConfig) {
 	require_print.print(require_colors.blue(`\n🔧 Generating ${editorConfig.name} rules...`));
 	for (const rule of editorConfig.rules) {
 		require_print.print(require_colors.yellow(`  📝 ${rule.name}: ${rule.description}`));
@@ -87,15 +85,20 @@ async function generateEditorRules(outputDir, editorName, editorConfig, force =
 			const targetPath = (0, node_path.join)(outputDir, file.target);
 			const targetDir = (0, node_path.join)(targetPath, "..");
 			if (!(0, node_fs.existsSync)(targetDir)) (0, node_fs.mkdirSync)(targetDir, { recursive: true });
-			if ((0, node_fs.existsSync)(targetPath)) if (force) require_print.print(require_colors.yellow(`    🗑️  Overwriting: ${file.target}`));
-			else {
-				require_print.print(require_colors.red(`    ❌ File already exists: ${file.target}`));
-				require_print.print(require_colors.yellow("    Use --force to overwrite existing files"));
-				continue;
-			}
+			const exists = (0, node_fs.existsSync)(targetPath);
 			try {
-				(0, node_fs.writeFileSync)(targetPath, require_config.getRuleContent(file.source));
-				require_print.print(require_colors.green(`    ✅ Created: ${file.target}`));
+				const content = require_config.getRuleContent(file.source);
+				if (exists) {
+					if ((0, node_fs.readFileSync)(targetPath, "utf-8") === content) {
+						require_print.print(require_colors.green(`    ✅ Up to date: ${file.target}`));
+						continue;
+					}
+					(0, node_fs.writeFileSync)(targetPath, content);
+					require_print.print(require_colors.green(`    ✅ Updated: ${file.target}`));
+				} else {
+					(0, node_fs.writeFileSync)(targetPath, content);
+					require_print.print(require_colors.green(`    ✅ Created: ${file.target}`));
+				}
 			} catch (error) {
 				require_print.print(require_colors.red(`    ❌ Error creating ${file.target}: ${error}`));
 			}

package/dist/cli/dist/commands/editor-rules.js

@@ -4,7 +4,7 @@ import { blue, green, red, yellow } from "../lib/colors.js";
 import { print } from "../lib/print.js";
 import { getAvailableEditors, getEditorConfig, getRuleContent } from "../utils/rules/config.js";
 import { join } from "node:path";
-import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 
 //#region ../cli/dist/commands/editor-rules.mjs
 /*! © 2026 Yahoo, Inc. UDS CLI v0.0.0-development */
@@ -19,7 +19,6 @@ var editor_rules_default = {
 			print(green("Description: Generate editor rules for various code editors and AI tools"));
 			print("");
 			print(yellow("Options:"));
-			print("  --force, -f     Force overwrite existing rules directory");
 			print("  --output, -o    Output directory (defaults to workspace root)");
 			print("  --editor, -e    Specific editor/tool (defaults to all)");
 			print("");
@@ -33,17 +32,17 @@ var editor_rules_default = {
 			print(blue("Examples:"));
 			print("  uds editor-rules                    # Generate all rules in current directory");
 			print("  uds editor-rules --editor cursor    # Generate only Cursor rules");
+			print("  uds editor-rules --editor claude    # Generate only Claude Code rules");
 			print("  uds editor-rules --output /path     # Generate rules in specific directory");
-			print("  uds editor-rules --force            # Force overwrite existing rules");
 			print("");
 			print(green("What it generates:"));
-			print("  • Cursor Rules (.cursor/uds/)");
+			print("  • Cursor Rules (.cursor/rules/uds/)");
+			print("  • Claude Code Rules (.claude/rules/uds/)");
 			return;
 		}
 		try {
 			const outputDir = options.output || process.cwd();
 			const selectedEditor = options.editor?.toLowerCase();
-			const force = options.force === "true" || options.force === true;
 			print(blue(`📁 Generating editor rules in: ${outputDir}`));
 			if (selectedEditor) {
 				const editorConfig = getEditorConfig(selectedEditor);
@@ -57,19 +56,18 @@ var editor_rules_default = {
 					}
 					return;
 				}
-				await generateEditorRules(outputDir, selectedEditor, editorConfig, force);
+				await generateEditorRules(outputDir, editorConfig);
 			} else {
 				const editors = getAvailableEditors();
 				for (const editor of editors) {
 					const editorConfig = getEditorConfig(editor);
-					if (editorConfig) await generateEditorRules(outputDir, editor, editorConfig, force);
+					if (editorConfig) await generateEditorRules(outputDir, editorConfig);
 				}
 			}
 			print(green("🎉 Editor rules generated successfully!"));
 			print(blue("📝 Rules are now available for your development environment"));
 			await trackEvent("editor_rules_generated", {
 				output_dir: outputDir,
-				force: force || false,
 				editor: selectedEditor || "all"
 			});
 		} catch (error) {
@@ -78,7 +76,7 @@ var editor_rules_default = {
 		}
 	}
 };
-async function generateEditorRules(outputDir, editorName, editorConfig, force = false) {
+async function generateEditorRules(outputDir, editorConfig) {
 	print(blue(`\n🔧 Generating ${editorConfig.name} rules...`));
 	for (const rule of editorConfig.rules) {
 		print(yellow(`  📝 ${rule.name}: ${rule.description}`));
@@ -86,15 +84,20 @@ async function generateEditorRules(outputDir, editorName, editorConfig, force =
 			const targetPath = join(outputDir, file.target);
 			const targetDir = join(targetPath, "..");
 			if (!existsSync(targetDir)) mkdirSync(targetDir, { recursive: true });
-			if (existsSync(targetPath)) if (force) print(yellow(`    🗑️  Overwriting: ${file.target}`));
-			else {
-				print(red(`    ❌ File already exists: ${file.target}`));
-				print(yellow("    Use --force to overwrite existing files"));
-				continue;
-			}
+			const exists = existsSync(targetPath);
 			try {
-				writeFileSync(targetPath, getRuleContent(file.source));
-				print(green(`    ✅ Created: ${file.target}`));
+				const content = getRuleContent(file.source);
+				if (exists) {
+					if (readFileSync(targetPath, "utf-8") === content) {
+						print(green(`    ✅ Up to date: ${file.target}`));
+						continue;
+					}
+					writeFileSync(targetPath, content);
+					print(green(`    ✅ Updated: ${file.target}`));
+				} else {
+					writeFileSync(targetPath, content);
+					print(green(`    ✅ Created: ${file.target}`));
+				}
 			} catch (error) {
 				print(red(`    ❌ Error creating ${file.target}: ${error}`));
 			}

package/dist/cli/dist/lib/box.cjs

@@ -0,0 +1,44 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+const require_colors = require('./colors.cjs');
+const require_print = require('./print.cjs');
+
+//#region ../cli/dist/lib/box.mjs
+/*! © 2026 Yahoo, Inc. UDS CLI v0.0.0-development */
+/**
+* Strips ANSI escape codes from a string to get the visible character length.
+*/
+function stripAnsi(str) {
+	return str.replace(/\x1b\[[0-9;]*m/g, "");
+}
+/**
+* Prints lines inside a bordered box, similar to npm/turbo update notifications.
+*
+* Example output:
+* ╭──────────────────────────────────────────────────────╮
+* │                                                      │
+* │   Updated UDS rules are available for Cursor and     │
+* │   Claude Code. Run `uds editor-rules` to update.     │
+* │                                                      │
+* ╰──────────────────────────────────────────────────────╯
+*/
+function printBox(lines) {
+	const padding = 3;
+	const innerWidth = Math.max(...lines.map((l) => stripAnsi(l).length)) + padding * 2;
+	const top = require_colors.yellow(`╭${"─".repeat(innerWidth)}╮`);
+	const bottom = require_colors.yellow(`╰${"─".repeat(innerWidth)}╯`);
+	const emptyLine = require_colors.yellow("│") + " ".repeat(innerWidth) + require_colors.yellow("│");
+	require_print.print("");
+	require_print.print(top);
+	require_print.print(emptyLine);
+	for (const line of lines) {
+		const visibleLength = stripAnsi(line).length;
+		const rightPad = innerWidth - padding - visibleLength;
+		require_print.print(require_colors.yellow("│") + " ".repeat(padding) + line + " ".repeat(rightPad) + require_colors.yellow("│"));
+	}
+	require_print.print(emptyLine);
+	require_print.print(bottom);
+	require_print.print("");
+}
+
+//#endregion
+exports.printBox = printBox;

package/dist/cli/dist/lib/box.js

@@ -0,0 +1,44 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+import { yellow } from "./colors.js";
+import { print } from "./print.js";
+
+//#region ../cli/dist/lib/box.mjs
+/*! © 2026 Yahoo, Inc. UDS CLI v0.0.0-development */
+/**
+* Strips ANSI escape codes from a string to get the visible character length.
+*/
+function stripAnsi(str) {
+	return str.replace(/\x1b\[[0-9;]*m/g, "");
+}
+/**
+* Prints lines inside a bordered box, similar to npm/turbo update notifications.
+*
+* Example output:
+* ╭──────────────────────────────────────────────────────╮
+* │                                                      │
+* │   Updated UDS rules are available for Cursor and     │
+* │   Claude Code. Run `uds editor-rules` to update.     │
+* │                                                      │
+* ╰──────────────────────────────────────────────────────╯
+*/
+function printBox(lines) {
+	const padding = 3;
+	const innerWidth = Math.max(...lines.map((l) => stripAnsi(l).length)) + padding * 2;
+	const top = yellow(`╭${"─".repeat(innerWidth)}╮`);
+	const bottom = yellow(`╰${"─".repeat(innerWidth)}╯`);
+	const emptyLine = yellow("│") + " ".repeat(innerWidth) + yellow("│");
+	print("");
+	print(top);
+	print(emptyLine);
+	for (const line of lines) {
+		const visibleLength = stripAnsi(line).length;
+		const rightPad = innerWidth - padding - visibleLength;
+		print(yellow("│") + " ".repeat(padding) + line + " ".repeat(rightPad) + yellow("│"));
+	}
+	print(emptyLine);
+	print(bottom);
+	print("");
+}
+
+//#endregion
+export { printBox };

package/dist/cli/dist/lib/colors.cjs

@@ -14,9 +14,11 @@ const magenta = (text) => `\x1b[35m${text}\x1b[0m`;
 const cyan = (text) => `\x1b[36m${text}\x1b[0m`;
 const white = (text) => `\x1b[37m${text}\x1b[0m`;
 const gray = (text) => `\x1b[2m${text}\x1b[0m`;
+const bold = (text) => `\x1b[1m${text}\x1b[0m`;
 
 //#endregion
 exports.blue = blue;
+exports.bold = bold;
 exports.cyan = cyan;
 exports.gray = gray;
 exports.green = green;

package/dist/cli/dist/lib/colors.js

@@ -13,6 +13,7 @@ const magenta = (text) => `\x1b[35m${text}\x1b[0m`;
 const cyan = (text) => `\x1b[36m${text}\x1b[0m`;
 const white = (text) => `\x1b[37m${text}\x1b[0m`;
 const gray = (text) => `\x1b[2m${text}\x1b[0m`;
+const bold = (text) => `\x1b[1m${text}\x1b[0m`;
 
 //#endregion
-export { blue, cyan, gray, green, magenta, red, white, yellow };
+export { blue, bold, cyan, gray, green, magenta, red, white, yellow };

package/dist/cli/dist/utils/rules/config.cjs

@@ -7,68 +7,152 @@ let node_url = require("node:url");
 //#region ../cli/dist/utils/rules/config.mjs
 /*! © 2026 Yahoo, Inc. UDS CLI v0.0.0-development */
 const __dirname$1 = (0, node_path.dirname)((0, node_url.fileURLToPath)(require("url").pathToFileURL(__filename).href));
-const EDITOR_CONFIGS = { cursor: {
-	name: "Cursor",
-	description: "AI-powered coding assistant rules for UDS development",
-	rules: [
-		{
-			name: "UDS Components",
-			description: "Component development guidelines and patterns",
-			files: [{
-				source: "rules/cursor/uds/components.mdc",
-				target: ".cursor/rules/uds/components.mdc",
-				type: "file"
-			}]
-		},
-		{
-			name: "UDS Tailwind",
-			description: "Tailwind CSS configuration and setup guidelines",
-			files: [{
-				source: "rules/cursor/uds/tailwind.mdc",
-				target: ".cursor/rules/uds/tailwind.mdc",
-				type: "file"
-			}]
-		},
-		{
-			name: "UDS Icons",
-			description: "Icon usage and documentation guidelines",
-			files: [{
-				source: "rules/cursor/uds/icons.mdc",
-				target: ".cursor/rules/uds/icons.mdc",
-				type: "file"
-			}]
-		},
-		{
-			name: "UDS Elevation",
-			description: "Elevation prop usage for layered surfaces",
-			files: [{
-				source: "rules/cursor/uds/elevation.mdc",
-				target: ".cursor/rules/uds/elevation.mdc",
-				type: "file"
-			}]
-		},
-		{
-			name: "UDS Styling",
-			description: "Color palette and styling guidelines",
-			files: [{
-				source: "rules/cursor/uds/styling.mdc",
-				target: ".cursor/rules/uds/styling.mdc",
-				type: "file"
-			}]
-		}
-	]
-} };
+const EDITOR_CONFIGS = {
+	cursor: {
+		name: "Cursor",
+		description: "AI-powered coding assistant rules for UDS development",
+		rules: [
+			{
+				name: "UDS Components",
+				description: "Component development guidelines and patterns",
+				files: [{
+					source: "rules/cursor/uds/components.mdc",
+					target: ".cursor/rules/uds/components.mdc",
+					type: "file"
+				}]
+			},
+			{
+				name: "UDS Tailwind",
+				description: "Tailwind CSS configuration and setup guidelines",
+				files: [{
+					source: "rules/cursor/uds/tailwind.mdc",
+					target: ".cursor/rules/uds/tailwind.mdc",
+					type: "file"
+				}]
+			},
+			{
+				name: "UDS Icons",
+				description: "Icon usage and documentation guidelines",
+				files: [{
+					source: "rules/cursor/uds/icons.mdc",
+					target: ".cursor/rules/uds/icons.mdc",
+					type: "file"
+				}]
+			},
+			{
+				name: "UDS Elevation",
+				description: "Elevation prop usage for layered surfaces",
+				files: [{
+					source: "rules/cursor/uds/elevation.mdc",
+					target: ".cursor/rules/uds/elevation.mdc",
+					type: "file"
+				}]
+			},
+			{
+				name: "UDS Styling",
+				description: "Color palette and styling guidelines",
+				files: [{
+					source: "rules/cursor/uds/styling.mdc",
+					target: ".cursor/rules/uds/styling.mdc",
+					type: "file"
+				}]
+			}
+		]
+	},
+	claude: {
+		name: "Claude Code",
+		description: "AI-powered coding assistant rules for UDS development",
+		rules: [
+			{
+				name: "UDS Components",
+				description: "Component development guidelines and patterns",
+				files: [{
+					source: "rules/claude/uds/components.md",
+					target: ".claude/rules/uds/components.md",
+					type: "file"
+				}]
+			},
+			{
+				name: "UDS Tailwind",
+				description: "Tailwind CSS configuration and setup guidelines",
+				files: [{
+					source: "rules/claude/uds/tailwind.md",
+					target: ".claude/rules/uds/tailwind.md",
+					type: "file"
+				}]
+			},
+			{
+				name: "UDS Icons",
+				description: "Icon usage and documentation guidelines",
+				files: [{
+					source: "rules/claude/uds/icons.md",
+					target: ".claude/rules/uds/icons.md",
+					type: "file"
+				}]
+			},
+			{
+				name: "UDS Elevation",
+				description: "Elevation prop usage for layered surfaces",
+				files: [{
+					source: "rules/claude/uds/elevation.md",
+					target: ".claude/rules/uds/elevation.md",
+					type: "file"
+				}]
+			},
+			{
+				name: "UDS Styling",
+				description: "Color palette and styling guidelines",
+				files: [{
+					source: "rules/claude/uds/styling.md",
+					target: ".claude/rules/uds/styling.md",
+					type: "file"
+				}]
+			}
+		]
+	}
+};
 function getAvailableEditors() {
 	return Object.keys(EDITOR_CONFIGS);
 }
 function getEditorConfig(editor) {
 	return EDITOR_CONFIGS[editor];
 }
+const AUTO_GENERATED_HEADER = "<!-- Auto-generated by UDS CLI (`uds editor-rules`). Do not edit manually. -->";
 function getRuleContent(rulePath) {
-	return (0, node_fs.readFileSync)((0, node_path.join)(__dirname$1, "..", "..", "..", rulePath), "utf-8");
+	return addAutoGeneratedHeader((0, node_fs.readFileSync)((0, node_path.join)(__dirname$1, "..", "..", "..", rulePath), "utf-8"));
+}
+function addAutoGeneratedHeader(content) {
+	if (content.startsWith("---\n")) {
+		const closingIndex = content.indexOf("\n---\n", 4);
+		if (closingIndex !== -1) return `${content.slice(0, closingIndex + 5)}${AUTO_GENERATED_HEADER}\n${content.slice(closingIndex + 5)}`;
+	}
+	return `${AUTO_GENERATED_HEADER}\n\n${content}`;
+}
+/**
+* Checks which editors have installed UDS rules that are out of date
+* compared to the latest rules shipped with the CLI.
+* Only checks editors whose rule directories already exist.
+*/
+function getEditorsWithStaleRules(projectDir) {
+	const staleEditors = [];
+	for (const [_editorId, editorConfig] of Object.entries(EDITOR_CONFIGS)) {
+		let hasAnyRule = false;
+		let hasStaleRule = false;
+		for (const rule of editorConfig.rules) for (const file of rule.files) {
+			const targetPath = (0, node_path.join)(projectDir, file.target);
+			if (!(0, node_fs.existsSync)(targetPath)) continue;
+			hasAnyRule = true;
+			try {
+				if ((0, node_fs.readFileSync)(targetPath, "utf-8") !== getRuleContent(file.source)) hasStaleRule = true;
+			} catch {}
+		}
+		if (hasAnyRule && hasStaleRule) staleEditors.push(editorConfig.name);
+	}
+	return staleEditors;
 }
 
 //#endregion
 exports.getAvailableEditors = getAvailableEditors;
 exports.getEditorConfig = getEditorConfig;
+exports.getEditorsWithStaleRules = getEditorsWithStaleRules;
 exports.getRuleContent = getRuleContent;