@yahoo/uds 3.108.1 → 3.109.0-beta.1

package/dist/automated-config/dist/mapTextVariantFixtureToValue.cjs

@@ -1,9 +1,20 @@
 /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
 const require_index = require('../../css-tokens/dist/index.cjs');
+const require_assertUnreachable = require('./utils/assertUnreachable.cjs');
 
 //#region ../automated-config/dist/mapTextVariantFixtureToValue.js
 /*! © 2026 Yahoo, Inc. UDS Default Config v0.0.0-development */
-const mapTextVariantFixtureToValue = (key) => (selected, value) => `typography.${key}.${require_index.textVariantsSafe(value)}`;
+const mapTextVariantFixtureToValue = (key) => (selected, value) => {
+	switch (key) {
+		case "fontFamily": return `udsFontFamily[${require_index.textVariantsSafe(value)}]`;
+		case "fontSize": return `udsFontSize[${require_index.textVariantsSafe(value)}]`;
+		case "lineHeight": return `udsLineHeight[${require_index.textVariantsSafe(value)}]`;
+		case "letterSpacing": return `udsLetterSpacing[${require_index.textVariantsSafe(value)}]`;
+		case "textTransform": return `udsTextTransform[${require_index.textVariantsSafe(value)}]`;
+		case "fontWeight": return `udsFontWeight[${require_index.textVariantsSafe(value)}]`;
+	}
+	return require_assertUnreachable.assertUnreachable(key);
+};
 
 //#endregion
 exports.mapTextVariantFixtureToValue = mapTextVariantFixtureToValue;

package/dist/automated-config/dist/mapTextVariantFixtureToValue.js

@@ -1,9 +1,20 @@
 /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
 import { textVariantsSafe } from "../../css-tokens/dist/index.js";
+import { assertUnreachable } from "./utils/assertUnreachable.js";
 
 //#region ../automated-config/dist/mapTextVariantFixtureToValue.js
 /*! © 2026 Yahoo, Inc. UDS Default Config v0.0.0-development */
-const mapTextVariantFixtureToValue = (key) => (selected, value) => `typography.${key}.${textVariantsSafe(value)}`;
+const mapTextVariantFixtureToValue = (key) => (selected, value) => {
+	switch (key) {
+		case "fontFamily": return `udsFontFamily[${textVariantsSafe(value)}]`;
+		case "fontSize": return `udsFontSize[${textVariantsSafe(value)}]`;
+		case "lineHeight": return `udsLineHeight[${textVariantsSafe(value)}]`;
+		case "letterSpacing": return `udsLetterSpacing[${textVariantsSafe(value)}]`;
+		case "textTransform": return `udsTextTransform[${textVariantsSafe(value)}]`;
+		case "fontWeight": return `udsFontWeight[${textVariantsSafe(value)}]`;
+	}
+	return assertUnreachable(key);
+};
 
 //#endregion
 export { mapTextVariantFixtureToValue };

package/dist/automated-config/dist/properties.cjs

@@ -1,7 +1,7 @@
 /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
 const require_index = require('../../css-tokens/dist/index.cjs');
-const require_mapTextVariantFixtureToValue = require('./mapTextVariantFixtureToValue.cjs');
 const require_assertUnreachable = require('./utils/assertUnreachable.cjs');
+const require_mapTextVariantFixtureToValue = require('./mapTextVariantFixtureToValue.cjs');
 const require_mapColorFixtureToValue = require('./utils/mapColorFixtureToValue.cjs');
 const require_index$1 = require('../../motion-tokens/dist/index.cjs');
 

package/dist/automated-config/dist/properties.js

@@ -1,7 +1,7 @@
 /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
 import { BACKGROUND_BLUR_COLOR_PREFIX, BACKGROUND_BLUR_FALLBACK_COLOR_PREFIX, BORDER_RADIUS_PREFIX, BUTTON_SCALE_EFFECT, DROP_SHADOW_PREFIX, getShadowLayerValue, textVariantsSafe } from "../../css-tokens/dist/index.js";
-import { mapTextVariantFixtureToValue } from "./mapTextVariantFixtureToValue.js";
 import { assertUnreachable } from "./utils/assertUnreachable.js";
+import { mapTextVariantFixtureToValue } from "./mapTextVariantFixtureToValue.js";
 import { mapColorFixtureToValue } from "./utils/mapColorFixtureToValue.js";
 import { SCALE_EFFECTS } from "../../motion-tokens/dist/index.js";
 

package/dist/cli/commands/sync.cjs

@@ -5,13 +5,14 @@ const require_defaultTokensConfig = require('../../defaultTokensConfig.cjs');
 const require_runtime_breakpointsConfig = require('../../runtime/breakpointsConfig.cjs');
 const require_runtime_toastConfig = require('../../runtime/toastConfig.cjs');
 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_fs = require("node:fs");
 let node_path = require("node:path");
 node_path = require_runtime.__toESM(node_path);
-let node_fs = require("node:fs");
 
 //#region src/cli/commands/sync.ts
 const PRODUCTION_ENDPOINT = "https://config.uds.build/api/config";
@@ -87,7 +88,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}`));
-			await require_analytics.trackEvent("sync", { id });
+			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.`]);
 		} catch (error) {
 			require_print.print(require_colors.red(`❌ ${error.message}`));
 			require_print.print(require_colors.yellow("Please reach out to #uds-ask channel for support."));

package/dist/cli/commands/sync.d.cts

@@ -1,5 +1,5 @@
 
-import { Props } from "@yahoo/uds-cli";
+import { Props } from "@yahoo/uds-cli/lib";
 
 //#region src/cli/commands/sync.d.ts
 declare const syncCommand: {

package/dist/cli/commands/sync.d.ts

@@ -1,5 +1,5 @@
 
-import { Props } from "@yahoo/uds-cli";
+import { Props } from "@yahoo/uds-cli/lib";
 
 //#region src/cli/commands/sync.d.ts
 declare const syncCommand: {

package/dist/cli/commands/sync.js

@@ -3,12 +3,13 @@ import { defaultTokensConfig } from "../../defaultTokensConfig.js";
 import { configToBreakpointsConfigContext } from "../../runtime/breakpointsConfig.js";
 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";
+import path from "node:path";
 
 //#region src/cli/commands/sync.ts
 const PRODUCTION_ENDPOINT = "https://config.uds.build/api/config";
@@ -84,7 +85,8 @@ const syncCommand = {
 			const configContentJs = `${exportsJS.join("\n\n")}\n`;
 			writeFileSync(fullPath, outFileExtension === "js" ? configContentJs : configContentTs);
 			print(green(`✅ Synced UDS config ${id} to ${fullPath}`));
-			await trackEvent("sync", { id });
+			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.`]);
 		} catch (error) {
 			print(red(`❌ ${error.message}`));
 			print(yellow("Please reach out to #uds-ask channel for support."));

package/dist/cli/commands/version.cjs

@@ -1,7 +1,6 @@
 /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const require_runtime = require('../../_virtual/_rolldown/runtime.cjs');
-const require_analytics = require('../dist/utils/analytics.cjs');
 const require_print = require('../dist/lib/print.cjs');
 let _yahoo_uds_package_json = require("@yahoo/uds/package.json");
 _yahoo_uds_package_json = require_runtime.__toESM(_yahoo_uds_package_json);
@@ -13,7 +12,6 @@ const versionCommand = {
 	description: `Display CLI version (${version})`,
 	run: async () => {
 		require_print.print(version);
-		await require_analytics.trackEvent("version", { version });
 	}
 };
 

package/dist/cli/commands/version.d.cts

@@ -1,5 +1,5 @@
 
-import { Command } from "@yahoo/uds-cli";
+import { Command } from "@yahoo/uds-cli/lib";
 
 //#region src/cli/commands/version.d.ts
 declare const versionCommand: Command;

package/dist/cli/commands/version.d.ts

@@ -1,5 +1,5 @@
 
-import { Command } from "@yahoo/uds-cli";
+import { Command } from "@yahoo/uds-cli/lib";
 
 //#region src/cli/commands/version.d.ts
 declare const versionCommand: Command;

package/dist/cli/commands/version.js

@@ -1,5 +1,4 @@
 /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
-import { trackEvent } from "../dist/utils/analytics.js";
 import { print } from "../dist/lib/print.js";
 import pkg from "@yahoo/uds/package.json" with { type: "json" };
 
@@ -10,7 +9,6 @@ const versionCommand = {
 	description: `Display CLI version (${version})`,
 	run: async () => {
 		print(version);
-		await trackEvent("version", { version });
 	}
 };
 

package/dist/cli/dist/cli.cjs

@@ -1,8 +1,8 @@
 /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
-const require_analytics = require('./utils/analytics.cjs');
 const require_args = require('./lib/args.cjs');
 const require_colors = require('./lib/colors.cjs');
 const require_print = require('./lib/print.cjs');
+const require_analytics = require('./utils/analytics.cjs');
 const require_getCommandHelp = require('./utils/getCommandHelp.cjs');
 const require_codemod = require('./commands/codemod/codemod.cjs');
 const require_editor_rules = require('./commands/editor-rules.cjs');

package/dist/cli/dist/cli.js

@@ -1,8 +1,8 @@
 /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
-import { trackEvent } from "./utils/analytics.js";
 import { parseArgs } from "./lib/args.js";
 import { cyan, gray, green, magenta, red, white } from "./lib/colors.js";
 import { print } from "./lib/print.js";
+import { trackEvent } from "./utils/analytics.js";
 import { CODEMOD_SUBCOMMANDS } from "./utils/getCommandHelp.js";
 import { codemod_default } from "./commands/codemod/codemod.js";
 import { editor_rules_default } from "./commands/editor-rules.js";

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

@@ -1,11 +1,11 @@
 /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
 const require_runtime = require('../../../_virtual/_rolldown/runtime.cjs');
-const require_analytics = require('../utils/analytics.cjs');
 const require_colors = require('../lib/colors.cjs');
 const require_print = require('../lib/print.cjs');
+const require_analytics = require('../utils/analytics.cjs');
 const require_config = require('../utils/rules/config.cjs');
-let node_path = require("node:path");
 let node_fs = require("node:fs");
+let node_path = require("node:path");
 
 //#region ../cli/dist/commands/editor-rules.mjs
 /*! © 2026 Yahoo, Inc. UDS CLI v0.0.0-development */
@@ -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

@@ -1,10 +1,10 @@
 /*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
-import { trackEvent } from "../utils/analytics.js";
 import { blue, green, red, yellow } from "../lib/colors.js";
 import { print } from "../lib/print.js";
+import { trackEvent } from "../utils/analytics.js";
 import { getAvailableEditors, getEditorConfig, getRuleContent } from "../utils/rules/config.js";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
-import { existsSync, mkdirSync, 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/lib/logger.cjs

@@ -0,0 +1,66 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+const require_colors = require('./colors.cjs');
+const require_print = require('./print.cjs');
+const require_spinner = require('./spinner.cjs');
+
+//#region ../cli/dist/lib/logger.mjs
+/*! © 2026 Yahoo, Inc. UDS CLI v0.0.0-development */
+/**
+* Logger utility for CLI commands.
+* Centralizes logging behavior with support for silent mode.
+*/
+/**
+* Create a logger instance with optional silent mode.
+* When silent, all logging methods become no-ops.
+*/
+function createLogger(options = {}) {
+	const isSilent = options.silent ?? false;
+	return {
+		isSilent,
+		print: (message) => {
+			if (!isSilent) require_print.print(message);
+		},
+		printAlways: (message) => {
+			require_print.print(message);
+		},
+		spinStart: (message) => {
+			if (!isSilent) require_spinner.spinStart(message);
+		},
+		spinStop: (icon, message) => {
+			if (!isSilent) require_spinner.spinStop(icon, message);
+		},
+		success: (message) => {
+			if (!isSilent) require_print.print(require_colors.green(`✅ ${message}`));
+		},
+		warn: (message) => {
+			if (!isSilent) require_print.print(require_colors.yellow(`⚠️  ${message}`));
+		},
+		error: (message) => {
+			require_print.print(require_colors.red(`❌ ${message}`));
+		},
+		info: (message) => {
+			if (!isSilent) require_print.print(require_colors.cyan(message));
+		},
+		label: (label, value) => {
+			if (!isSilent) require_print.print(`${require_colors.magenta(label)} ${require_colors.cyan(value)}`);
+		},
+		listItem: (text) => {
+			if (!isSilent) require_print.print(`   ${require_colors.gray("•")} ${text}`);
+		},
+		timestamp: (message, color = "green") => {
+			if (isSilent) return;
+			const time = (/* @__PURE__ */ new Date()).toLocaleTimeString();
+			const colorFn = color === "green" ? require_colors.green : color === "yellow" ? require_colors.yellow : require_colors.red;
+			require_print.print(`${require_colors.gray(`[${time}]`)} ${colorFn(message)}`);
+		},
+		newline: () => {
+			if (!isSilent) require_print.print("");
+		},
+		child: (childOptions = {}) => {
+			return createLogger({ silent: childOptions.silent ?? isSilent });
+		}
+	};
+}
+
+//#endregion
+exports.createLogger = createLogger;

package/dist/cli/dist/lib/logger.js

@@ -0,0 +1,66 @@
+/*! © 2026 Yahoo, Inc. UDS v0.0.0-development */
+import { cyan, gray, green, magenta, red, yellow } from "./colors.js";
+import { print } from "./print.js";
+import { spinStart, spinStop } from "./spinner.js";
+
+//#region ../cli/dist/lib/logger.mjs
+/*! © 2026 Yahoo, Inc. UDS CLI v0.0.0-development */
+/**
+* Logger utility for CLI commands.
+* Centralizes logging behavior with support for silent mode.
+*/
+/**
+* Create a logger instance with optional silent mode.
+* When silent, all logging methods become no-ops.
+*/
+function createLogger(options = {}) {
+	const isSilent = options.silent ?? false;
+	return {
+		isSilent,
+		print: (message) => {
+			if (!isSilent) print(message);
+		},
+		printAlways: (message) => {
+			print(message);
+		},
+		spinStart: (message) => {
+			if (!isSilent) spinStart(message);
+		},
+		spinStop: (icon, message) => {
+			if (!isSilent) spinStop(icon, message);
+		},
+		success: (message) => {
+			if (!isSilent) print(green(`✅ ${message}`));
+		},
+		warn: (message) => {
+			if (!isSilent) print(yellow(`⚠️  ${message}`));
+		},
+		error: (message) => {
+			print(red(`❌ ${message}`));
+		},
+		info: (message) => {
+			if (!isSilent) print(cyan(message));
+		},
+		label: (label, value) => {
+			if (!isSilent) print(`${magenta(label)} ${cyan(value)}`);
+		},
+		listItem: (text) => {
+			if (!isSilent) print(`   ${gray("•")} ${text}`);
+		},
+		timestamp: (message, color = "green") => {
+			if (isSilent) return;
+			const time = (/* @__PURE__ */ new Date()).toLocaleTimeString();
+			const colorFn = color === "green" ? green : color === "yellow" ? yellow : red;
+			print(`${gray(`[${time}]`)} ${colorFn(message)}`);
+		},
+		newline: () => {
+			if (!isSilent) print("");
+		},
+		child: (childOptions = {}) => {
+			return createLogger({ silent: childOptions.silent ?? isSilent });
+		}
+	};
+}
+
+//#endregion
+export { createLogger };