@agentrules/cli 0.3.0 → 0.3.1

package/README.md

@@ -193,8 +193,9 @@ agentrules publish [path] [options]
 # Publish current directory
 agentrules publish
 
-# Publish a specific rule
+# Publish a specific directory or file (interactive if no agentrules.json)
 agentrules publish ./my-rule
+agentrules publish .claude/commands/deploy.md
 
 # Publish to major version 2
 agentrules publish --version 2

package/dist/index.js

@@ -9,6 +9,7 @@ import { chmod, constants as constants$1 } from "fs";
 import * as client from "openid-client";
 import { promisify } from "util";
 import { exec } from "child_process";
+import * as p$2 from "@clack/prompts";
 import * as p$1 from "@clack/prompts";
 import * as p from "@clack/prompts";
 
@@ -1989,7 +1990,7 @@ const $ZodUnion = /* @__PURE__ */ $constructor("$ZodUnion", (inst, def) => {
 	defineLazy(inst._zod, "pattern", () => {
 		if (def.options.every((o) => o._zod.pattern)) {
 			const patterns = def.options.map((o) => o._zod.pattern);
-			return new RegExp(`^(${patterns.map((p$2) => cleanRegex(p$2.source)).join("|")})$`);
+			return new RegExp(`^(${patterns.map((p$3) => cleanRegex(p$3.source)).join("|")})$`);
 		}
 		return void 0;
 	});
@@ -2368,9 +2369,9 @@ var $ZodRegistry = class {
 		return this;
 	}
 	get(schema) {
-		const p$2 = schema._zod.parent;
-		if (p$2) {
-			const pm = { ...this.get(p$2) ?? {} };
+		const p$3 = schema._zod.parent;
+		if (p$3) {
+			const pm = { ...this.get(p$3) ?? {} };
 			delete pm.id;
 			const f = {
 				...pm,
@@ -4375,8 +4376,8 @@ function command(cmd) {
 	return theme.command(cmd);
 }
 /** Format a file path */
-function path(p$2) {
-	return theme.path(p$2);
+function path(p$3) {
+	return theme.path(p$3);
 }
 /** Format as muted/secondary text */
 function muted(text) {
@@ -4694,6 +4695,22 @@ function fileTree(files, options) {
 	});
 	return lines.join("\n");
 }
+function rulePreview(options) {
+	const lines = [];
+	lines.push(header(options.header));
+	if (options.path) lines.push(keyValue(options.pathLabel ?? "Path", path(options.path)));
+	lines.push(keyValue("Name", code(options.name)));
+	lines.push(keyValue("Title", options.title));
+	lines.push(keyValue("Description", options.description || dim("—")));
+	lines.push(keyValue("Platforms", options.platforms.join(", ")));
+	if (options.type) lines.push(keyValue("Type", options.type));
+	if (options.tags && options.tags.length > 0) lines.push(keyValue("Tags", options.tags.join(", ")));
+	else if (options.showHints) lines.push(keyValue("Tags", dim("— (add to improve discoverability)")));
+	if (options.features && options.features.length > 0) lines.push(keyValue("Features", options.features.join(", ")));
+	else if (options.showHints) lines.push(keyValue("Features", dim("— (highlight what this rule does)")));
+	if (options.license) lines.push(keyValue("License", options.license));
+	return lines.join("\n");
+}
 const ui = {
 	theme,
 	symbols,
@@ -4730,6 +4747,7 @@ const ui = {
 	fileCounts,
 	hint,
 	link,
+	rulePreview,
 	stripAnsi,
 	truncate,
 	formatBytes: formatBytes$1,
@@ -5882,6 +5900,20 @@ async function directoryExists(path$1) {
 	}
 }
 
+//#endregion
+//#region src/lib/zod-validator.ts
+/**
+* Creates a validator function from a Zod schema.
+* Returns error message if invalid, undefined if valid.
+*/
+function check(schema) {
+	return (value) => {
+		const result = schema.safeParse(value);
+		if (!result.success) return result.error.issues[0]?.message;
+		return;
+	};
+}
+
 //#endregion
 //#region src/lib/rule-utils.ts
 const SKILL_FILENAME = "SKILL.md";
@@ -6005,7 +6037,7 @@ async function loadConfig(inputPath, overrides) {
 		platforms
 	};
 	const configDir = dirname(configPath);
-	const platformNames = platforms.map((p$2) => p$2.platform).join(", ");
+	const platformNames = platforms.map((plat) => plat.platform).join(", ");
 	log.debug(`Loaded config: ${config$1.name}, platforms: ${platformNames}`);
 	return {
 		configPath,
@@ -6191,18 +6223,270 @@ async function readFirstMatch(dir, filenames) {
 	}
 	return;
 }
+/**
+* Detect if directory contains SKILL.md and extract frontmatter defaults.
+*/
+async function detectSkillDirectory$1(directory) {
+	const skillPath = join(directory, SKILL_FILENAME);
+	if (!await fileExists(skillPath)) return;
+	const content = await readFile(skillPath, "utf8");
+	const frontmatter = parseSkillFrontmatter(content);
+	return {
+		name: frontmatter.name,
+		license: frontmatter.license
+	};
+}
+function parseTags(input) {
+	if (typeof input !== "string") return [];
+	if (input.trim().length === 0) return [];
+	return input.split(",").map((tag) => tag.trim().toLowerCase()).filter((tag) => tag.length > 0);
+}
+function checkTags(value) {
+	const tags = parseTags(value);
+	const result = tagsSchema.safeParse(tags);
+	if (!result.success) return result.error.issues[0]?.message;
+}
+/**
+* Collect rule inputs via interactive prompts or defaults.
+*
+* Handles:
+* - Skill detection with SKILL.md frontmatter
+* - Platform multiselect with keyboard hints
+* - Per-platform path prompting (for non-skill multi-platform)
+* - Name, title, description, tags, license prompts
+*/
+async function collectRuleInputs(options) {
+	const { directory, defaults = {}, nonInteractive = false } = options;
+	const skillInfo = await detectSkillDirectory$1(directory);
+	let isSkill = false;
+	if (skillInfo && !nonInteractive) {
+		const confirm = await p$2.confirm({
+			message: `Detected SKILL.md${skillInfo.name ? ` (${skillInfo.name})` : ""}. Initialize as skill?`,
+			initialValue: true
+		});
+		if (p$2.isCancel(confirm)) throw new Error("Cancelled");
+		isSkill = confirm;
+	} else if (skillInfo && nonInteractive) isSkill = true;
+	const defaultName = isSkill && skillInfo?.name ? normalizeName(skillInfo.name) : defaults.name ?? "my-rule";
+	const defaultLicense = isSkill && skillInfo?.license ? skillInfo.license : defaults.license ?? "MIT";
+	const validatedPlatforms = [];
+	if (defaults.platforms) for (const platform of defaults.platforms) {
+		if (!isSupportedPlatform(platform)) throw new Error(`Unknown platform "${platform}"`);
+		validatedPlatforms.push(platform);
+	}
+	const selectedPlatforms = validatedPlatforms.length > 0 ? validatedPlatforms : await (async () => {
+		if (nonInteractive) throw new Error("Missing --platform in non-interactive mode");
+		const platformChoices = await p$2.multiselect({
+			message: `Platforms ${ui.dim("(space to toggle, 'a' to select all)")}`,
+			options: PLATFORM_IDS.map((id) => ({
+				value: id,
+				label: id
+			})),
+			required: true
+		});
+		if (p$2.isCancel(platformChoices)) throw new Error("Cancelled");
+		return platformChoices;
+	})();
+	const platformPaths = {};
+	if (selectedPlatforms.length > 1 && !isSkill && !nonInteractive) {
+		const hasCompletePathMapping = selectedPlatforms.every((platform) => {
+			const value = defaults.platformPaths?.[platform];
+			return typeof value === "string" && value.trim().length > 0;
+		});
+		if (hasCompletePathMapping && defaults.platformPaths) for (const platform of selectedPlatforms) {
+			const pathVal = defaults.platformPaths[platform]?.trim();
+			if (pathVal && pathVal !== ".") platformPaths[platform] = pathVal;
+		}
+		else for (const platform of selectedPlatforms) {
+			const mappedPath = defaults.platformPaths?.[platform]?.trim();
+			const suggestedPath = mappedPath ?? (await directoryExists(join(directory, platform)) ? platform : ".");
+			const input = await p$2.text({
+				message: `Folder for ${platform} files ('.' = same folder as agentrules.json)`,
+				placeholder: suggestedPath,
+				defaultValue: suggestedPath
+			});
+			if (p$2.isCancel(input)) throw new Error("Cancelled");
+			const trimmed = input.trim();
+			const resolvedPath = trimmed.length > 0 ? trimmed : suggestedPath;
+			if (resolvedPath !== ".") platformPaths[platform] = resolvedPath;
+		}
+	} else if (defaults.platformPaths) for (const platform of selectedPlatforms) {
+		const pathVal = defaults.platformPaths[platform]?.trim();
+		if (pathVal && pathVal !== ".") platformPaths[platform] = pathVal;
+	}
+	if (nonInteractive) {
+		const name = normalizeName(defaults.name ?? defaultName);
+		const nameCheck = nameSchema.safeParse(name);
+		if (!nameCheck.success) throw new Error(nameCheck.error.issues[0]?.message ?? "Invalid name");
+		return {
+			platforms: selectedPlatforms,
+			platformPaths,
+			name,
+			title: defaults.title ?? toTitleCase(name),
+			description: defaults.description ?? "",
+			tags: defaults.tags ?? [],
+			license: defaultLicense,
+			isSkill,
+			ruleType: isSkill ? "skill" : defaults.ruleType
+		};
+	}
+	const result = await p$2.group({
+		name: () => {
+			const normalizedDefault = normalizeName(defaultName);
+			return p$2.text({
+				message: "Rule name",
+				placeholder: normalizedDefault,
+				defaultValue: normalizedDefault,
+				validate: (value) => {
+					if (!value || value.trim() === "") return;
+					return check(nameSchema)(value);
+				}
+			});
+		},
+		title: ({ results }) => {
+			const defaultTitle = defaults.title ?? toTitleCase(results.name ?? defaultName);
+			return p$2.text({
+				message: "Title",
+				defaultValue: defaultTitle,
+				placeholder: defaultTitle
+			});
+		},
+		description: () => p$2.text({
+			message: "Description",
+			placeholder: "Describe what this rule does...",
+			defaultValue: defaults.description,
+			validate: check(descriptionSchema)
+		}),
+		tags: () => p$2.text({
+			message: "Tags (comma-separated, optional)",
+			placeholder: "e.g., typescript, testing, react",
+			validate: checkTags
+		}),
+		license: async () => {
+			const choice = await p$2.select({
+				message: "License",
+				options: [...COMMON_LICENSES.map((id) => ({
+					value: id,
+					label: id
+				})), {
+					value: "__other__",
+					label: "Other (enter SPDX identifier)"
+				}],
+				initialValue: defaultLicense
+			});
+			if (p$2.isCancel(choice)) throw new Error("Cancelled");
+			if (choice === "__other__") {
+				const custom = await p$2.text({
+					message: "License (SPDX identifier)",
+					placeholder: "e.g., MPL-2.0, AGPL-3.0-only",
+					validate: check(licenseSchema)
+				});
+				if (p$2.isCancel(custom)) throw new Error("Cancelled");
+				return custom;
+			}
+			return choice;
+		}
+	}, { onCancel: () => {
+		throw new Error("Cancelled");
+	} });
+	const tags = parseTags(result.tags);
+	return {
+		platforms: selectedPlatforms,
+		platformPaths,
+		name: result.name,
+		title: result.title.trim() || toTitleCase(result.name),
+		description: result.description ?? "",
+		tags,
+		license: result.license,
+		isSkill,
+		ruleType: isSkill ? "skill" : defaults.ruleType
+	};
+}
 
 //#endregion
-//#region src/lib/zod-validator.ts
+//#region src/commands/rule/init.ts
+/** Default rule name when none specified */
+const DEFAULT_RULE_NAME = "my-rule";
 /**
-* Creates a validator function from a Zod schema.
-* Returns error message if invalid, undefined if valid.
+* Detect if directory contains SKILL.md and extract frontmatter defaults.
 */
-function check(schema) {
-	return (value) => {
-		const result = schema.safeParse(value);
-		if (!result.success) return result.error.issues[0]?.message;
-		return;
+async function detectSkillDirectory(directory) {
+	const skillPath = join(directory, SKILL_FILENAME);
+	if (!await fileExists(skillPath)) return;
+	const content = await readFile(skillPath, "utf8");
+	const frontmatter = parseSkillFrontmatter(content);
+	return {
+		name: frontmatter.name,
+		license: frontmatter.license
+	};
+}
+/**
+* Initialize a rule in a directory (rule root).
+*
+* Structure:
+* - ruleDir/agentrules.json - rule config
+* - ruleDir/* - rule files (collected by default)
+* - ruleDir/README.md, ruleDir/LICENSE.md, ruleDir/INSTALL.txt - optional metadata (not bundled)
+*/
+async function initRule(options) {
+	const ruleDir = options.directory ?? process.cwd();
+	log.debug(`Initializing rule in: ${ruleDir}`);
+	const skillInfo = await detectSkillDirectory(ruleDir);
+	const isSkillDirectory = skillInfo !== void 0;
+	const inferredPlatform = getPlatformFromDir(basename(ruleDir));
+	const platformInputs = options.platforms ?? (inferredPlatform ? [inferredPlatform] : []);
+	if (platformInputs.length === 0) throw new Error(`Cannot determine platform. Specify --platform (${PLATFORM_IDS.join(", ")}).`);
+	const platforms = platformInputs.map(normalizePlatformEntryInput);
+	const name = normalizeName(options.name ?? skillInfo?.name ?? DEFAULT_RULE_NAME);
+	const title = options.title ?? toTitleCase(name);
+	const description = options.description ?? "";
+	const license = options.license ?? skillInfo?.license ?? "MIT";
+	const ruleType = isSkillDirectory ? "skill" : options.type;
+	const platformLabels = platforms.map((p$3) => typeof p$3 === "string" ? p$3 : p$3.platform).join(", ");
+	log.debug(`Rule name: ${name}, platforms: ${platformLabels}`);
+	const configPath = join(ruleDir, RULE_CONFIG_FILENAME);
+	if (!options.force && await fileExists(configPath)) throw new Error(`${RULE_CONFIG_FILENAME} already exists. Use --force to overwrite.`);
+	const config$1 = {
+		$schema: RULE_SCHEMA_URL,
+		name,
+		...ruleType && { type: ruleType },
+		title,
+		version: 1,
+		description,
+		tags: options.tags ?? [],
+		license,
+		platforms
+	};
+	let createdDir;
+	if (await directoryExists(ruleDir)) log.debug(`Directory exists: ${ruleDir}`);
+	else {
+		await mkdir(ruleDir, { recursive: true });
+		createdDir = ruleDir;
+		log.debug(`Created directory: ${ruleDir}`);
+	}
+	const content = `${JSON.stringify(config$1, null, 2)}\n`;
+	await writeFile(configPath, content, "utf8");
+	log.debug(`Wrote config file: ${configPath}`);
+	log.debug("Rule initialization complete.");
+	return {
+		configPath,
+		rule: config$1,
+		createdDir
+	};
+}
+function normalizePlatform(input) {
+	const normalized = input.toLowerCase();
+	if (!isSupportedPlatform(normalized)) throw new Error(`Unknown platform "${input}". Supported: ${PLATFORM_IDS.join(", ")}`);
+	return normalized;
+}
+function normalizePlatformEntryInput(input) {
+	if (typeof input === "string") return normalizePlatform(input);
+	const platform = normalizePlatform(input.platform);
+	const path$1 = typeof input.path === "string" ? input.path.trim() : "";
+	if (path$1.length === 0 || path$1 === ".") return platform;
+	return {
+		platform,
+		path: path$1
 	};
 }
 
@@ -6210,14 +6494,46 @@ function check(schema) {
 //#region src/commands/publish.ts
 /** Maximum size per variant/platform bundle in bytes (1MB) */
 const MAX_VARIANT_SIZE_BYTES = 1 * 1024 * 1024;
-/** Schema for parsing comma-separated tags input */
-const tagsInputSchema = string().transform((input) => input.split(",").map((t) => t.trim().toLowerCase()).filter((t) => t.length > 0)).pipe(tagsSchema);
 function formatBytes(bytes) {
 	if (bytes < 1024) return `${bytes} B`;
 	if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
 	return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
 }
 /**
+* Prompts to create agentrules.json after quick publish (or dry run).
+* With --yes, creates without prompting.
+*/
+async function promptToCreateConfig(quickPublish, yes) {
+	if (!quickPublish) return false;
+	let createConfig = yes ?? false;
+	if (!yes && process.stdin.isTTY) {
+		log.print("");
+		const answer = await p$1.confirm({
+			message: "Create agentrules.json for future publishes?",
+			initialValue: true
+		});
+		createConfig = !p$1.isCancel(answer) && answer;
+	}
+	if (createConfig) {
+		const sourceDir = quickPublish.source.type === "directory" ? quickPublish.source.path : void 0;
+		const configDir = sourceDir ?? (quickPublish.source.path.replace(/[/\\][^/\\]+$/, "") || ".");
+		await initRule({
+			directory: configDir,
+			name: quickPublish.name,
+			title: quickPublish.title,
+			description: quickPublish.description || void 0,
+			platforms: quickPublish.platforms,
+			type: quickPublish.ruleType,
+			tags: quickPublish.tags,
+			license: quickPublish.license,
+			force: false
+		});
+		log.success(`Created ${ui.path(join(configDir, "agentrules.json"))}`);
+		return true;
+	}
+	return false;
+}
+/**
 * Publishes a rule to the registry.
 *
 * Supports:
@@ -6287,7 +6603,9 @@ async function publish(options = {}) {
 			dryRun,
 			version: version$2,
 			spinner: fileSpinner,
-			ctx
+			ctx,
+			quickPublish: resolved,
+			yes
 		});
 	}
 	if (quickDir) {
@@ -6303,8 +6621,7 @@ async function publish(options = {}) {
 				license
 			}, {
 				type: "directory",
-				path: quickDir.path,
-				entryFile: quickDir.entryFile
+				path: quickDir
 			}, {
 				dryRun,
 				yes
@@ -6338,7 +6655,9 @@ async function publish(options = {}) {
 			dryRun,
 			version: version$2,
 			spinner: dirSpinner,
-			ctx
+			ctx,
+			quickPublish: resolved,
+			yes
 		});
 	}
 	const spinner$1 = await log.spinner("Validating rule...");
@@ -6435,14 +6754,7 @@ async function getQuickPublishDirectory(inputPath) {
 	if (!pathStat?.isDirectory()) return;
 	const configStat = await stat(`${inputPath}/${RULE_CONFIG_FILENAME}`).catch(() => null);
 	if (configStat?.isFile()) return;
-	const skillPath = `${inputPath}/${SKILL_FILENAME}`;
-	const skillStat = await stat(skillPath).catch(() => null);
-	if (skillStat?.isFile()) return {
-		path: inputPath,
-		type: "skill",
-		entryFile: skillPath
-	};
-	return;
+	return inputPath;
 }
 function normalizePathForInference(value) {
 	return value.replace(/\\/g, "/");
@@ -6469,17 +6781,6 @@ function inferFileDefaults(filePath) {
 	}
 	return result;
 }
-async function inferDirectoryDefaults(_dirPath, entryFile, dirType) {
-	const result = {};
-	if (dirType === "skill") {
-		result.ruleType = "skill";
-		const content = await readFile(entryFile, "utf8");
-		const frontmatter = parseSkillFrontmatter(content);
-		if (frontmatter.name) result.name = normalizeName(frontmatter.name);
-		if (frontmatter.license) result.license = frontmatter.license;
-	}
-	return result;
-}
 function buildConfigPublishOverrides(options) {
 	const overrides = {};
 	if (options.name !== void 0) overrides.name = options.name;
@@ -6492,37 +6793,23 @@ function buildConfigPublishOverrides(options) {
 	return Object.keys(overrides).length > 0 ? overrides : void 0;
 }
 async function resolveQuickPublishInputs(options, source, ctx) {
-	const inferred = source.type === "file" ? inferFileDefaults(source.path) : await inferDirectoryDefaults(source.path, source.entryFile, "skill");
 	const isInteractive = !ctx.yes && process.stdin.isTTY;
 	const isDirectory = source.type === "directory";
-	const hasRequiredArgs = isDirectory ? options.platform !== void 0 && (options.name !== void 0 || inferred.name !== void 0) : options.name !== void 0 && options.platform !== void 0 && options.type !== void 0;
-	if (!(isInteractive || hasRequiredArgs)) {
-		if (isDirectory) throw new Error("Publishing a directory in non-interactive mode requires --platform (and --name if not in frontmatter).");
-		throw new Error("Publishing a single file in non-interactive mode requires --name, --platform, and --type.");
-	}
-	const selectedPlatforms = options.platform ? parsePlatformSelection(options.platform) : void 0;
-	if (selectedPlatforms && selectedPlatforms.length > 1) throw new Error("Quick publish requires exactly one --platform value.");
-	let selectedPlatform = selectedPlatforms?.[0] ? normalizePlatformInput(selectedPlatforms[0]) : inferred.platform;
-	if (!selectedPlatform) {
-		if (!isInteractive) throw new Error("Missing --platform");
-		const selection = await p$1.select({
-			message: "Platform",
-			options: PLATFORM_IDS.map((id) => ({
-				value: id,
-				label: id
-			}))
-		});
-		if (p$1.isCancel(selection)) throw new Error("Cancelled");
-		selectedPlatform = selection;
-	}
-	let selectedType = options.type ?? inferred.ruleType;
-	if (!selectedType) {
-		if (!isInteractive) throw new Error("Missing --type");
-		const candidates = getValidTypes(selectedPlatform).filter((t) => supportsInstallPath({
-			platform: selectedPlatform,
+	const isFile = source.type === "file";
+	const fileInferred = isFile ? inferFileDefaults(source.path) : {};
+	const parsedPlatforms = options.platform ? parsePlatformSelection(options.platform).map(normalizePlatformInput) : void 0;
+	let selectedType = options.type ?? fileInferred.ruleType;
+	const platformsForTypeCheck = parsedPlatforms && parsedPlatforms.length > 0 ? parsedPlatforms : fileInferred.platform ? [fileInferred.platform] : [];
+	if (isFile && !selectedType) {
+		if (!isInteractive) throw new Error("Publishing a single file in non-interactive mode requires --name, --platform, and --type.");
+		if (platformsForTypeCheck.length === 0) throw new Error("Missing --platform");
+		const candidateSets = platformsForTypeCheck.map((plat) => getValidTypes(plat).filter((t) => supportsInstallPath({
+			platform: plat,
 			type: t,
 			scope: "project"
-		}));
+		})));
+		const candidates = candidateSets.length === 1 ? candidateSets[0] : candidateSets.reduce((acc, set) => acc.filter((t) => set.includes(t)));
+		if (candidates.length === 0) throw new Error(`No common type supports all selected platforms: ${platformsForTypeCheck.join(", ")}`);
 		const selection = await p$1.select({
 			message: "Type",
 			options: candidates.map((t) => ({
@@ -6533,64 +6820,48 @@ async function resolveQuickPublishInputs(options, source, ctx) {
 		if (p$1.isCancel(selection)) throw new Error("Cancelled");
 		selectedType = selection;
 	}
-	const platform = selectedPlatform;
-	const ruleType = selectedType;
-	const nameValue = options.name ?? inferred.name ?? await (async () => {
-		if (!isInteractive) throw new Error("Missing --name");
-		const input = await p$1.text({
-			message: "Rule name",
-			placeholder: "my-rule",
-			validate: check(nameSchema)
-		});
-		if (p$1.isCancel(input)) throw new Error("Cancelled");
-		return input;
-	})();
-	const normalizedName = normalizeName(nameValue);
-	const nameCheck = nameSchema.safeParse(normalizedName);
-	if (!nameCheck.success) throw new Error(nameCheck.error.issues[0]?.message ?? "Invalid name");
-	const defaultTitle = toTitleCase(normalizedName);
-	const finalTitle = options.title ?? await (async () => {
-		if (!isInteractive) return defaultTitle;
-		const input = await p$1.text({
-			message: "Title",
-			defaultValue: defaultTitle,
-			placeholder: defaultTitle
-		});
-		if (p$1.isCancel(input)) throw new Error("Cancelled");
-		return input;
-	})();
-	const finalDescription = options.description ?? await (async () => {
-		if (!isInteractive) return "";
-		const input = await p$1.text({
-			message: "Description (optional)",
-			placeholder: "Describe what this rule does...",
-			validate: check(descriptionSchema)
-		});
-		if (p$1.isCancel(input)) throw new Error("Cancelled");
-		return input;
-	})();
-	const finalTags = await (async () => {
-		if (options.tags) return tagsSchema.parse(options.tags);
-		if (!isInteractive) return [];
-		const input = await p$1.text({
-			message: "Tags (optional)",
-			placeholder: "comma-separated, e.g. typescript, react",
-			validate: check(tagsInputSchema)
-		});
-		if (p$1.isCancel(input)) throw new Error("Cancelled");
-		return tagsInputSchema.parse(input);
-	})();
-	const finalLicense = options.license ?? inferred.license ?? "MIT";
+	if (options.type && platformsForTypeCheck.length > 0) {
+		const ruleType = selectedType;
+		for (const platform of platformsForTypeCheck) if (!supportsInstallPath({
+			platform,
+			type: ruleType,
+			scope: "project"
+		})) throw new Error(`Type "${ruleType}" is not supported for project installs on platform "${platform}".`);
+	}
+	const collected = await collectRuleInputs({
+		directory: isDirectory ? source.path : dirname(source.path),
+		defaults: {
+			name: options.name ?? fileInferred.name,
+			title: options.title,
+			description: options.description,
+			platforms: parsedPlatforms,
+			license: options.license ?? fileInferred.license,
+			tags: options.tags,
+			ruleType: selectedType
+		},
+		nonInteractive: !isInteractive,
+		detectType: isDirectory
+	});
+	const finalRuleType = isFile ? selectedType : collected.ruleType ?? (collected.isSkill ? "skill" : "instruction");
+	for (const platform of collected.platforms) if (!supportsInstallPath({
+		platform,
+		type: finalRuleType,
+		scope: "project"
+	})) throw new Error(`Type "${finalRuleType}" is not supported for project installs on platform "${platform}".`);
 	if (isInteractive && !ctx.dryRun) {
 		log.print("");
-		log.print(ui.header("Quick publish"));
-		log.print(ui.keyValue(isDirectory ? "Directory" : "File", ui.path(source.path)));
-		log.print(ui.keyValue("Name", ui.code(normalizedName)));
-		log.print(ui.keyValue("Title", finalTitle));
-		log.print(ui.keyValue("Description", finalDescription));
-		log.print(ui.keyValue("Platform", platform));
-		log.print(ui.keyValue("Type", ruleType));
-		if (finalTags.length > 0) log.print(ui.keyValue("Tags", finalTags.join(", ")));
+		log.print(ui.rulePreview({
+			header: "Quick publish",
+			path: source.path,
+			pathLabel: isDirectory ? "Directory" : "File",
+			name: collected.name,
+			title: collected.title,
+			description: collected.description,
+			platforms: collected.platforms,
+			type: finalRuleType,
+			tags: collected.tags,
+			showHints: true
+		}));
 		log.print("");
 		const confirm = await p$1.confirm({
 			message: isDirectory ? "Publish this directory?" : "Publish this file?",
@@ -6600,16 +6871,24 @@ async function resolveQuickPublishInputs(options, source, ctx) {
 	}
 	return {
 		source,
-		name: normalizedName,
-		platform,
-		ruleType,
-		title: finalTitle,
-		description: finalDescription,
-		tags: finalTags,
-		license: finalLicense
+		name: collected.name,
+		platforms: collected.platforms,
+		platformPaths: isFile ? {} : collected.platformPaths,
+		ruleType: finalRuleType,
+		title: collected.title,
+		description: collected.description,
+		tags: collected.tags,
+		license: collected.license
 	};
 }
 async function buildRuleInputFromQuickPublish(inputs) {
+	const platformEntries = inputs.platforms.map((platform) => {
+		const path$1 = inputs.platformPaths[platform];
+		return path$1 ? {
+			platform,
+			path: path$1
+		} : { platform };
+	});
 	const config$1 = {
 		$schema: RULE_SCHEMA_URL,
 		name: inputs.name,
@@ -6618,34 +6897,38 @@ async function buildRuleInputFromQuickPublish(inputs) {
 		description: inputs.description,
 		license: inputs.license,
 		tags: inputs.tags,
-		platforms: [{ platform: inputs.platform }]
+		platforms: platformEntries
 	};
 	if (inputs.source.type === "file") {
 		const content = await readFile(inputs.source.path);
-		const bundlePath = getInstallPath({
-			platform: inputs.platform,
-			type: inputs.ruleType,
-			name: inputs.name,
-			scope: "project"
-		});
-		if (!bundlePath) throw new Error(`Type "${inputs.ruleType}" is not supported for project installs on platform "${inputs.platform}".`);
-		return {
-			name: inputs.name,
-			config: config$1,
-			platformFiles: [{
-				platform: inputs.platform,
+		const platformFiles$1 = [];
+		for (const platform of inputs.platforms) {
+			const bundlePath = getInstallPath({
+				platform,
+				type: inputs.ruleType,
+				name: inputs.name,
+				scope: "project"
+			});
+			if (!bundlePath) throw new Error(`Type "${inputs.ruleType}" is not supported for project installs on platform "${platform}".`);
+			platformFiles$1.push({
+				platform,
 				files: [{
 					path: bundlePath,
 					content
 				}]
-			}]
+			});
+		}
+		return {
+			name: inputs.name,
+			config: config$1,
+			platformFiles: platformFiles$1
 		};
 	}
 	const loadedConfig = {
 		configPath: `${inputs.source.path}/agentrules.json`,
 		config: {
 			...config$1,
-			platforms: [{ platform: inputs.platform }]
+			platforms: platformEntries
 		},
 		configDir: inputs.source.path
 	};
@@ -6657,7 +6940,7 @@ async function buildRuleInputFromQuickPublish(inputs) {
 	};
 }
 async function finalizePublish(options) {
-	const { publishInput, dryRun, version: version$2, spinner: spinner$1, ctx } = options;
+	const { publishInput, dryRun, version: version$2, spinner: spinner$1, ctx, quickPublish, yes } = options;
 	const totalFileCount = publishInput.variants.reduce((sum, v) => sum + v.files.length, 0);
 	const platformList = publishInput.variants.map((v) => v.platform).join(", ");
 	let totalSize = 0;
@@ -6696,6 +6979,7 @@ async function finalizePublish(options) {
 			log.print("");
 		}
 		log.print(ui.hint("Run without --dry-run to publish."));
+		await promptToCreateConfig(quickPublish, yes);
 		return {
 			success: true,
 			preview: {
@@ -6743,6 +7027,7 @@ async function finalizePublish(options) {
 	}
 	log.info("");
 	log.info(ui.keyValue("Now live at", ui.link(data.url)));
+	await promptToCreateConfig(quickPublish, yes);
 	return {
 		success: true,
 		rule: {
@@ -6833,196 +7118,15 @@ async function discoverRuleDirs(inputDir) {
 	return ruleDirs.sort();
 }
 
-//#endregion
-//#region src/commands/rule/init.ts
-/** Default rule name when none specified */
-const DEFAULT_RULE_NAME$1 = "my-rule";
-/**
-* Detect if directory contains SKILL.md and extract frontmatter defaults.
-*/
-async function detectSkillDirectory(directory) {
-	const skillPath = join(directory, SKILL_FILENAME);
-	if (!await fileExists(skillPath)) return;
-	const content = await readFile(skillPath, "utf8");
-	const frontmatter = parseSkillFrontmatter(content);
-	return {
-		name: frontmatter.name,
-		license: frontmatter.license
-	};
-}
-/**
-* Initialize a rule in a directory (rule root).
-*
-* Structure:
-* - ruleDir/agentrules.json - rule config
-* - ruleDir/* - rule files (collected by default)
-* - ruleDir/README.md, ruleDir/LICENSE.md, ruleDir/INSTALL.txt - optional metadata (not bundled)
-*/
-async function initRule(options) {
-	const ruleDir = options.directory ?? process.cwd();
-	log.debug(`Initializing rule in: ${ruleDir}`);
-	const skillInfo = await detectSkillDirectory(ruleDir);
-	const isSkillDirectory = skillInfo !== void 0;
-	const inferredPlatform = getPlatformFromDir(basename(ruleDir));
-	const platformInputs = options.platforms ?? (inferredPlatform ? [inferredPlatform] : []);
-	if (platformInputs.length === 0) throw new Error(`Cannot determine platform. Specify --platform (${PLATFORM_IDS.join(", ")}).`);
-	const platforms = platformInputs.map(normalizePlatformEntryInput);
-	const name = normalizeName(options.name ?? skillInfo?.name ?? DEFAULT_RULE_NAME$1);
-	const title = options.title ?? toTitleCase(name);
-	const description = options.description ?? "";
-	const license = options.license ?? skillInfo?.license ?? "MIT";
-	const ruleType = isSkillDirectory ? "skill" : options.type;
-	const platformLabels = platforms.map((p$2) => typeof p$2 === "string" ? p$2 : p$2.platform).join(", ");
-	log.debug(`Rule name: ${name}, platforms: ${platformLabels}`);
-	const configPath = join(ruleDir, RULE_CONFIG_FILENAME);
-	if (!options.force && await fileExists(configPath)) throw new Error(`${RULE_CONFIG_FILENAME} already exists. Use --force to overwrite.`);
-	const config$1 = {
-		$schema: RULE_SCHEMA_URL,
-		name,
-		...ruleType && { type: ruleType },
-		title,
-		version: 1,
-		description,
-		tags: options.tags ?? [],
-		license,
-		platforms
-	};
-	let createdDir;
-	if (await directoryExists(ruleDir)) log.debug(`Directory exists: ${ruleDir}`);
-	else {
-		await mkdir(ruleDir, { recursive: true });
-		createdDir = ruleDir;
-		log.debug(`Created directory: ${ruleDir}`);
-	}
-	const content = `${JSON.stringify(config$1, null, 2)}\n`;
-	await writeFile(configPath, content, "utf8");
-	log.debug(`Wrote config file: ${configPath}`);
-	log.debug("Rule initialization complete.");
-	return {
-		configPath,
-		rule: config$1,
-		createdDir
-	};
-}
-function normalizePlatform(input) {
-	const normalized = input.toLowerCase();
-	if (!isSupportedPlatform(normalized)) throw new Error(`Unknown platform "${input}". Supported: ${PLATFORM_IDS.join(", ")}`);
-	return normalized;
-}
-function normalizePlatformEntryInput(input) {
-	if (typeof input === "string") return normalizePlatform(input);
-	const platform = normalizePlatform(input.platform);
-	const path$1 = typeof input.path === "string" ? input.path.trim() : "";
-	if (path$1.length === 0 || path$1 === ".") return platform;
-	return {
-		platform,
-		path: path$1
-	};
-}
-
 //#endregion
 //#region src/commands/rule/init-interactive.ts
-const DEFAULT_RULE_NAME = "my-rule";
-/**
-* Parse comma-separated tags string into array.
-*/
-function parseTags(input) {
-	if (typeof input !== "string") return [];
-	if (input.trim().length === 0) return [];
-	return input.split(",").map((tag) => tag.trim().toLowerCase()).filter((tag) => tag.length > 0);
-}
-/**
-* Validator for comma-separated tags input.
-*/
-function checkTags(value) {
-	const tags = parseTags(value);
-	const result = tagsSchema.safeParse(tags);
-	if (!result.success) return result.error.issues[0]?.message;
-}
 /**
 * Run interactive init flow with clack prompts.
 */
 async function initInteractive(options) {
-	const { directory, name: nameOption, title: titleOption, description: descriptionOption, platforms: platformsOption, platformPaths, license: licenseOption } = options;
+	const { directory, platformPaths } = options;
 	let { force } = options;
 	p.intro("Create a new rule");
-	const skillInfo = await detectSkillDirectory(directory);
-	let useSkillDefaults = false;
-	if (skillInfo) {
-		const confirm = await p.confirm({
-			message: `Detected SKILL.md${skillInfo.name ? ` (${skillInfo.name})` : ""}. Initialize as skill?`,
-			initialValue: true
-		});
-		if (p.isCancel(confirm)) {
-			p.cancel("Cancelled");
-			process.exit(0);
-		}
-		useSkillDefaults = confirm;
-	}
-	const defaultName = useSkillDefaults && skillInfo?.name ? skillInfo.name : nameOption ?? DEFAULT_RULE_NAME;
-	const defaultLicense = useSkillDefaults && skillInfo?.license ? skillInfo.license : licenseOption ?? "MIT";
-	const validatedPlatforms = [];
-	if (platformsOption) for (const platform of platformsOption) {
-		if (!isSupportedPlatform(platform)) {
-			p.cancel(`Unknown platform "${platform}"`);
-			process.exit(1);
-		}
-		validatedPlatforms.push(platform);
-	}
-	const selectedPlatforms = validatedPlatforms.length > 0 ? validatedPlatforms : await (async () => {
-		const platformChoices = await p.multiselect({
-			message: "Platforms (select one or more)",
-			options: PLATFORM_IDS.map((id) => ({
-				value: id,
-				label: id
-			})),
-			required: true
-		});
-		if (p.isCancel(platformChoices)) {
-			p.cancel("Cancelled");
-			process.exit(0);
-		}
-		return platformChoices;
-	})();
-	const platformEntries = await (async () => {
-		if (selectedPlatforms.length === 0) return [];
-		if (useSkillDefaults) return selectedPlatforms;
-		const hasCompletePathMapping = selectedPlatforms.every((platform) => {
-			const value = platformPaths?.[platform];
-			return typeof value === "string" && value.trim().length > 0;
-		});
-		if (hasCompletePathMapping) return selectedPlatforms.map((platform) => {
-			const path$1 = platformPaths?.[platform]?.trim();
-			if (!path$1 || path$1 === ".") return platform;
-			return {
-				platform,
-				path: path$1
-			};
-		});
-		if (selectedPlatforms.length === 1) return selectedPlatforms;
-		const entries = [];
-		for (const platform of selectedPlatforms) {
-			const mappedPath = platformPaths?.[platform]?.trim();
-			const suggestedPath = mappedPath ?? (await directoryExists(join(directory, platform)) ? platform : ".");
-			const input = await p.text({
-				message: `Folder for ${platform} files ('.' = same folder as agentrules.json)`,
-				placeholder: suggestedPath,
-				defaultValue: suggestedPath
-			});
-			if (p.isCancel(input)) {
-				p.cancel("Cancelled");
-				process.exit(0);
-			}
-			const trimmed = input.trim();
-			const resolvedPath = trimmed.length > 0 ? trimmed : suggestedPath;
-			if (resolvedPath === ".") entries.push(platform);
-			else entries.push({
-				platform,
-				path: resolvedPath
-			});
-		}
-		return entries;
-	})();
 	const configPath = join(directory, RULE_CONFIG_FILENAME);
 	if (!force && await fileExists(configPath)) {
 		const overwrite = await p.confirm({
@@ -7035,81 +7139,58 @@ async function initInteractive(options) {
 		}
 		force = true;
 	}
-	const result = await p.group({
-		name: () => {
-			const normalizedDefault = normalizeName(defaultName);
-			return p.text({
-				message: "Rule name",
-				placeholder: normalizedDefault,
-				defaultValue: normalizedDefault,
-				validate: (value) => {
-					if (!value || value.trim() === "") return;
-					return check(nameSchema)(value);
-				}
-			});
-		},
-		title: ({ results }) => {
-			const defaultTitle = titleOption ?? toTitleCase(results.name ?? defaultName);
-			return p.text({
-				message: "Title",
-				defaultValue: defaultTitle,
-				placeholder: defaultTitle
-			});
-		},
-		description: () => p.text({
-			message: "Description",
-			placeholder: "Describe what this rule does...",
-			defaultValue: descriptionOption,
-			validate: check(descriptionSchema)
-		}),
-		tags: () => p.text({
-			message: "Tags (comma-separated, optional)",
-			placeholder: "e.g., typescript, testing, react",
-			validate: checkTags
-		}),
-		license: async () => {
-			const choice = await p.select({
-				message: "License",
-				options: [...COMMON_LICENSES.map((id) => ({
-					value: id,
-					label: id
-				})), {
-					value: "__other__",
-					label: "Other (enter SPDX identifier)"
-				}],
-				initialValue: defaultLicense
-			});
-			if (p.isCancel(choice)) {
-				p.cancel("Cancelled");
-				process.exit(0);
-			}
-			if (choice === "__other__") {
-				const custom = await p.text({
-					message: "License (SPDX identifier)",
-					placeholder: "e.g., MPL-2.0, AGPL-3.0-only",
-					validate: check(licenseSchema)
-				});
-				if (p.isCancel(custom)) {
-					p.cancel("Cancelled");
-					process.exit(0);
-				}
-				return custom;
-			}
-			return choice;
+	let collected;
+	try {
+		collected = await collectRuleInputs({
+			directory,
+			defaults: {
+				name: options.name,
+				title: options.title,
+				description: options.description,
+				platforms: options.platforms,
+				platformPaths,
+				license: options.license
+			},
+			nonInteractive: false
+		});
+	} catch (error$2) {
+		if (error$2 instanceof Error && error$2.message === "Cancelled") {
+			p.cancel("Cancelled");
+			process.exit(0);
 		}
-	}, { onCancel: () => {
-		p.cancel("Cancelled");
-		return process.exit(0);
-	} });
+		throw error$2;
+	}
+	const platformEntries = collected.platforms.map((platform) => {
+		const path$1 = collected.platformPaths[platform];
+		return path$1 ? {
+			platform,
+			path: path$1
+		} : platform;
+	});
+	log.print("");
+	log.print(ui.rulePreview({
+		header: "Rule configuration",
+		path: directory,
+		pathLabel: "Directory",
+		name: collected.name,
+		title: collected.title || toTitleCase(collected.name),
+		description: collected.description,
+		platforms: collected.platforms,
+		type: collected.isSkill ? "skill" : void 0,
+		tags: collected.tags,
+		license: collected.license,
+		showHints: true
+	}));
+	log.print("");
 	const initOptions = {
 		directory,
-		name: result.name,
-		type: useSkillDefaults ? "skill" : void 0,
-		title: result.title.trim() || void 0,
-		description: result.description,
-		tags: parseTags(result.tags),
+		name: collected.name,
+		type: collected.isSkill ? "skill" : void 0,
+		title: collected.title || void 0,
+		description: collected.description,
+		tags: collected.tags,
 		platforms: platformEntries,
-		license: result.license,
+		license: collected.license,
 		force
 	};
 	const initResult = await initRule(initOptions);
@@ -7582,7 +7663,7 @@ program.command("add <item>").description("Download and install a rule from the
 program.command("init").description("Initialize a new rule").argument("[directory]", "Directory to initialize (created if it doesn't exist)").option("-y, --yes", "Accept defaults without prompting").option("-n, --name <name>", "Rule name").option("-t, --title <title>", "Display title").option("--description <text>", "Rule description").option("-p, --platform <platform>", "Target platform(s). Repeatable, accepts comma-separated. Supports <platform>=<path> mappings.", (value, previous) => previous ? [...previous, value] : [value]).option("-l, --license <license>", "License (e.g., MIT)").option("-f, --force", "Overwrite existing agentrules.json").action(handle(async (directory, options) => {
 	const targetDir = directory ?? process.cwd();
 	const defaultName = directory ? basename(directory) : void 0;
-	const platformInputs = options.platform?.flatMap((p$2) => p$2.split(",").map((s) => s.trim())).filter((p$2) => p$2.length > 0);
+	const platformInputs = options.platform?.flatMap((p$3) => p$3.split(",").map((s) => s.trim())).filter((p$3) => p$3.length > 0);
 	const platformIds = [];
 	const platformPaths = {};
 	if (platformInputs) for (const input of platformInputs) {
@@ -7623,7 +7704,7 @@ program.command("init").description("Initialize a new rule").argument("[director
 		}
 		const nextSteps$1 = [
 			"Add your rule files in this directory",
-			"Add tags (recommended) and features (recommended) to agentrules.json",
+			"Add tags and features to agentrules.json",
 			`Run ${ui.command("agentrules publish")} to publish your rule`
 		];
 		log.print(`\n${ui.header("Next steps")}`);
@@ -7647,7 +7728,7 @@ program.command("init").description("Initialize a new rule").argument("[director
 	}
 	const nextSteps = [
 		"Add your rule files in this directory",
-		"Add tags (recommended) and features (recommended) to agentrules.json",
+		"Add tags and features to agentrules.json",
 		`Run ${ui.command("agentrules publish")} to publish your rule`
 	];
 	log.print(`\n${ui.header("Next steps")}`);
@@ -7656,13 +7737,13 @@ program.command("init").description("Initialize a new rule").argument("[director
 program.command("validate").description("Validate an agentrules.json configuration").argument("[path]", "Path to agentrules.json or directory").action(handle(async (path$1) => {
 	const result = await validateRule({ path: path$1 });
 	if (result.valid && result.rule) {
-		const p$2 = result.rule;
-		const platforms = p$2.platforms.map((entry) => entry.platform).join(", ");
-		log.success(p$2.title);
-		if (p$2.description) log.print(ui.keyValue("Description", p$2.description));
-		log.print(ui.keyValue("License", p$2.license));
+		const p$3 = result.rule;
+		const platforms = p$3.platforms.map((entry) => entry.platform).join(", ");
+		log.success(p$3.title);
+		if (p$3.description) log.print(ui.keyValue("Description", p$3.description));
+		log.print(ui.keyValue("License", p$3.license));
 		log.print(ui.keyValue("Platforms", platforms));
-		if (p$2.tags?.length) log.print(ui.keyValue("Tags", p$2.tags.join(", ")));
+		if (p$3.tags?.length) log.print(ui.keyValue("Tags", p$3.tags.join(", ")));
 	} else if (!result.valid) log.error(`Invalid: ${ui.path(result.configPath)}`);
 	if (result.errors.length > 0) {
 		log.print("");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentrules/cli",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "author": "Brian Cheung <bcheung.dev@gmail.com> (https://github.com/bcheung)",
   "license": "MIT",
   "homepage": "https://agentrules.directory",