@agentrules/cli 0.0.13 → 0.0.14

package/dist/index.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 import { createRequire } from "module";
-import { AGENT_RULES_DIR, API_ENDPOINTS, COMMON_LICENSES, LATEST_VERSION, PLATFORMS, PLATFORM_IDS, PRESET_CONFIG_FILENAME, PRESET_SCHEMA_URL, STATIC_BUNDLE_DIR, buildPresetPublishInput, buildPresetRegistry, createDiffPreview, decodeBundledFile, descriptionSchema, fetchBundle, getPlatformFromDir, isLikelyText, isPlatformDir, isSupportedPlatform, licenseSchema, normalizeBundlePath, normalizePlatformInput, resolvePreset, slugSchema, tagsSchema, titleSchema, toUtf8String, validatePresetConfig, verifyBundledFileChecksum } from "@agentrules/core";
+import { AGENT_RULES_DIR, API_ENDPOINTS, COMMON_LICENSES, LATEST_VERSION, PLATFORMS, PLATFORM_IDS, PRESET_CONFIG_FILENAME, PRESET_SCHEMA_URL, STATIC_BUNDLE_DIR, buildPresetPublishInput, buildPresetRegistry, createDiffPreview, decodeBundledFile, descriptionSchema, fetchBundle, getInstallPath, getPlatformFromDir, isLikelyText, isPlatformDir, isSupportedPlatform, licenseSchema, normalizeBundlePath, normalizePlatformInput, resolvePreset, slugSchema, tagsSchema, titleSchema, toUtf8String, validatePresetConfig, verifyBundledFileChecksum } from "@agentrules/core";
 import { Command } from "commander";
 import { basename, dirname, join, relative, resolve, sep } from "path";
 import { exec } from "child_process";
@@ -712,6 +712,34 @@ async function unpublishPreset(baseUrl, token, slug, platform, version$1) {
 	}
 }
 
+//#endregion
+//#region src/lib/api/rule.ts
+async function getRule(baseUrl, slug) {
+	const url = `${baseUrl}${API_ENDPOINTS.rule.get(slug)}`;
+	log.debug(`GET ${url}`);
+	try {
+		const response = await fetch(url);
+		log.debug(`Response status: ${response.status}`);
+		if (!response.ok) {
+			const errorData = await response.json();
+			return {
+				success: false,
+				error: errorData.error || `HTTP ${response.status}`
+			};
+		}
+		const data = await response.json();
+		return {
+			success: true,
+			data
+		};
+	} catch (error$2) {
+		return {
+			success: false,
+			error: `Failed to connect to registry: ${getErrorMessage(error$2)}`
+		};
+	}
+}
+
 //#endregion
 //#region src/lib/api/session.ts
 /**
@@ -1322,7 +1350,7 @@ function parsePresetInput(input, explicitPlatform, explicitVersion) {
 function resolveInstallTarget(platform, options) {
 	const { projectDir, globalDir } = PLATFORMS[platform];
 	if (options.directory) {
-		const customRoot = resolve(expandHome(options.directory));
+		const customRoot = resolve(expandHome$1(options.directory));
 		return {
 			root: customRoot,
 			mode: "custom",
@@ -1332,7 +1360,8 @@ function resolveInstallTarget(platform, options) {
 		};
 	}
 	if (options.global) {
-		const globalRoot = resolve(expandHome(globalDir));
+		if (!globalDir) throw new Error(`Platform "${platform}" does not support global installation`);
+		const globalRoot = resolve(expandHome$1(globalDir));
 		return {
 			root: globalRoot,
 			mode: "global",
@@ -1362,7 +1391,7 @@ async function writeBundleFiles(bundle, target, behavior) {
 		const destResult = computeDestinationPath(file.path, target);
 		const destination = destResult.path;
 		if (!behavior.dryRun) await mkdir(dirname(destination), { recursive: true });
-		const existing = await readExistingFile(destination);
+		const existing = await readExistingFile$1(destination);
 		const relativePath = relativize(destination, target.root);
 		if (!existing) {
 			if (!behavior.dryRun) await writeFile(destination, data);
@@ -1434,7 +1463,7 @@ function computeDestinationPath(pathInput, target) {
 	ensureWithinRoot(destination, target.root);
 	return { path: destination };
 }
-async function readExistingFile(pathname) {
+async function readExistingFile$1(pathname) {
 	try {
 		return await readFile(pathname);
 	} catch (error$2) {
@@ -1463,7 +1492,7 @@ function ensureWithinRoot(candidate, root) {
 	if (candidate === root) return;
 	if (!candidate.startsWith(normalizedRoot)) throw new Error(`Refusing to write outside of ${root}. Derived path: ${candidate}`);
 }
-function expandHome(value) {
+function expandHome$1(value) {
 	if (value.startsWith("~")) {
 		const remainder = value.slice(1);
 		if (!remainder) return homedir();
@@ -1557,7 +1586,7 @@ async function loadPreset(presetDir) {
 	const configObj = configJson;
 	const identifier = typeof configObj?.name === "string" ? configObj.name : configPath;
 	const config = validatePresetConfig(configJson, identifier);
-	const slug = config.name;
+	const name = config.name;
 	const dirName = basename(presetDir);
 	const isConfigInPlatformDir = isPlatformDir(dirName);
 	let filesDir;
@@ -1586,7 +1615,7 @@ async function loadPreset(presetDir) {
 	const files = await collectFiles(filesDir, rootExclude, ignorePatterns);
 	if (files.length === 0) throw new Error(`No files found in ${filesDir}. Presets must include at least one file.`);
 	return {
-		slug,
+		name,
 		config,
 		files,
 		installMessage,
@@ -2019,7 +2048,7 @@ async function validatePreset(options) {
 			warnings
 		};
 	}
-	log.debug(`Preset slug: ${preset.name}`);
+	log.debug(`Preset name: ${preset.name}`);
 	const presetDir = dirname(configPath);
 	const platform = preset.platform;
 	log.debug(`Checking platform: ${platform}`);
@@ -2107,7 +2136,7 @@ async function publish(options = {}) {
 	let presetInput;
 	try {
 		presetInput = await loadPreset(presetDir);
-		log.debug(`Loaded preset "${presetInput.slug}" for platform ${presetInput.config.platform}`);
+		log.debug(`Loaded preset "${presetInput.name}" for platform ${presetInput.config.platform}`);
 	} catch (error$2) {
 		const message = getErrorMessage(error$2);
 		spinner$1.fail("Failed to load preset");
@@ -2152,7 +2181,7 @@ async function publish(options = {}) {
 		log.print("");
 		log.print(ui.header("Publish Preview"));
 		log.print(ui.keyValue("Preset", publishInput.title));
-		log.print(ui.keyValue("Slug", publishInput.slug));
+		log.print(ui.keyValue("Name", publishInput.name));
 		log.print(ui.keyValue("Platform", publishInput.platform));
 		log.print(ui.keyValue("Version", version$1 ? `${version$1}.x (auto-assigned minor)` : "1.x (auto-assigned)"));
 		log.print(ui.keyValue("Files", `${fileCount} file${fileCount === 1 ? "" : "s"}`));
@@ -2165,7 +2194,7 @@ async function publish(options = {}) {
 		return {
 			success: true,
 			preview: {
-				slug: publishInput.slug,
+				slug: publishInput.name,
 				platform: publishInput.platform,
 				title: publishInput.title,
 				totalSize: inputSize,
@@ -2296,6 +2325,116 @@ async function discoverPresetDirs(inputDir) {
 	return presetDirs.sort();
 }
 
+//#endregion
+//#region src/commands/rule/add.ts
+async function addRule(options) {
+	const ctx = useAppContext();
+	const dryRun = Boolean(options.dryRun);
+	log.debug(`Fetching rule: ${options.slug}`);
+	const result = await getRule(ctx.registry.url, options.slug);
+	if (!result.success) throw new Error(result.error);
+	const rule = result.data;
+	const platform = rule.platform;
+	const targetPath = resolveTargetPath(platform, rule.type, rule.slug, {
+		global: options.global,
+		directory: options.directory
+	});
+	log.debug(`Target path: ${targetPath}`);
+	const existing = await readExistingFile(targetPath);
+	if (existing !== null) {
+		if (existing === rule.content) return {
+			slug: rule.slug,
+			platform: rule.platform,
+			type: rule.type,
+			title: rule.title,
+			targetPath,
+			status: "unchanged",
+			dryRun
+		};
+		if (!options.force) return {
+			slug: rule.slug,
+			platform: rule.platform,
+			type: rule.type,
+			title: rule.title,
+			targetPath,
+			status: "conflict",
+			dryRun
+		};
+		if (!dryRun) {
+			await mkdir(dirname(targetPath), { recursive: true });
+			await writeFile(targetPath, rule.content, "utf-8");
+		}
+		return {
+			slug: rule.slug,
+			platform: rule.platform,
+			type: rule.type,
+			title: rule.title,
+			targetPath,
+			status: "overwritten",
+			dryRun
+		};
+	}
+	if (!dryRun) {
+		await mkdir(dirname(targetPath), { recursive: true });
+		await writeFile(targetPath, rule.content, "utf-8");
+	}
+	return {
+		slug: rule.slug,
+		platform: rule.platform,
+		type: rule.type,
+		title: rule.title,
+		targetPath,
+		status: "created",
+		dryRun
+	};
+}
+function resolveTargetPath(platform, type, slug, options) {
+	const location = options.global ? "global" : "project";
+	const pathTemplate = getInstallPath(platform, type, slug, location);
+	if (!pathTemplate) {
+		const locationLabel = options.global ? "globally" : "to a project";
+		throw new Error(`Rule type "${type}" cannot be installed ${locationLabel} for platform "${platform}"`);
+	}
+	if (options.directory) {
+		const resolvedTemplate = pathTemplate.replace("{name}", slug);
+		const filename = resolvedTemplate.split("/").pop() ?? `${slug}.md`;
+		return resolve(expandHome(options.directory), filename);
+	}
+	const expanded = expandHome(pathTemplate);
+	if (expanded.startsWith("/")) return expanded;
+	return resolve(process.cwd(), expanded);
+}
+async function readExistingFile(pathname) {
+	try {
+		return await readFile(pathname, "utf-8");
+	} catch (error$2) {
+		if (error$2.code === "ENOENT") return null;
+		throw error$2;
+	}
+}
+function expandHome(value) {
+	if (value.startsWith("~")) {
+		const remainder = value.slice(1);
+		if (!remainder) return homedir();
+		if (remainder.startsWith("/") || remainder.startsWith("\\")) return `${homedir()}${remainder}`;
+		return `${homedir()}/${remainder}`;
+	}
+	return value;
+}
+/**
+* Check if input looks like a rule reference (r/ prefix)
+*/
+function isRuleReference(input) {
+	return input.toLowerCase().startsWith("r/");
+}
+/**
+* Extract slug from rule reference (removes r/ prefix)
+*/
+function extractRuleSlug(input) {
+	if (isRuleReference(input)) return input.slice(2);
+	return input;
+}
+
 //#endregion
 //#region src/commands/unpublish.ts
 /**
@@ -2680,14 +2819,47 @@ program.name("agentrules").description("The AI Agent Directory CLI").version(pac
 		log.debug(`Failed to init context: ${getErrorMessage(error$2)}`);
 	}
 }).showHelpAfterError();
-program.command("add <preset>").description("Download and install a preset from the registry").option("-p, --platform <platform>", "Target platform (opencode, codex, claude, cursor)").option("-V, --version <version>", "Install a specific version").option("-r, --registry <alias>", "Use a specific registry alias").option("-g, --global", "Install to global directory").option("--dir <path>", "Install to a custom directory").option("-f, --force", "Overwrite existing files (backs up originals)").option("-y, --yes", "Alias for --force").option("--dry-run", "Preview changes without writing").option("--skip-conflicts", "Skip conflicting files").option("--no-backup", "Don't backup files before overwriting (use with --force)").action(handle(async (preset, options) => {
-	const platform = options.platform ? normalizePlatformInput(options.platform) : void 0;
+program.command("add <item>").description("Download and install a preset or rule from the registry (use r/<slug> for rules)").option("-p, --platform <platform>", "Target platform (opencode, codex, claude, cursor)").option("-V, --version <version>", "Install a specific version (presets only)").option("-r, --registry <alias>", "Use a specific registry alias").option("-g, --global", "Install to global directory").option("--dir <path>", "Install to a custom directory").option("-f, --force", "Overwrite existing files (backs up originals)").option("-y, --yes", "Alias for --force").option("--dry-run", "Preview changes without writing").option("--skip-conflicts", "Skip conflicting files (presets only)").option("--no-backup", "Don't backup files before overwriting (use with --force)").action(handle(async (item, options) => {
 	const dryRun = Boolean(options.dryRun);
+	if (isRuleReference(item)) {
+		const slug = extractRuleSlug(item);
+		const spinner$2 = await log.spinner(`Fetching rule "${slug}"...`);
+		try {
+			const result$1 = await addRule({
+				slug,
+				global: Boolean(options.global),
+				directory: options.dir,
+				force: Boolean(options.force || options.yes),
+				dryRun
+			});
+			spinner$2.stop();
+			if (result$1.status === "conflict") {
+				log.error(`File already exists: ${result$1.targetPath}. Use ${ui.command("--force")} to overwrite.`);
+				process.exitCode = 1;
+				return;
+			}
+			if (result$1.status === "unchanged") {
+				log.info(`Already up to date: ${ui.path(result$1.targetPath)}`);
+				return;
+			}
+			const verb$1 = dryRun ? "Would install" : "Installed";
+			const action = result$1.status === "overwritten" ? "updated" : "created";
+			log.print(ui.fileStatus(action, result$1.targetPath, { dryRun }));
+			log.print("");
+			log.success(`${verb$1} ${ui.bold(result$1.title)} ${ui.muted(`(${result$1.platform}/${result$1.type})`)}`);
+			if (dryRun) log.print(ui.hint("\nDry run complete. No files were written."));
+		} catch (err) {
+			spinner$2.stop();
+			throw err;
+		}
+		return;
+	}
+	const platform = options.platform ? normalizePlatformInput(options.platform) : void 0;
 	const spinner$1 = await log.spinner("Fetching preset...");
 	let result;
 	try {
 		result = await addPreset({
-			preset,
+			preset: item,
 			platform,
 			version: options.version,
 			global: Boolean(options.global),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentrules/cli",
-  "version": "0.0.13",
+  "version": "0.0.14",
   "author": "Brian Cheung <bcheung.dev@gmail.com> (https://github.com/bcheung)",
   "license": "MIT",
   "homepage": "https://agentrules.directory",
@@ -48,7 +48,7 @@
     "clean": "rm -rf node_modules dist .turbo"
   },
   "dependencies": {
-    "@agentrules/core": "0.0.10",
+    "@agentrules/core": "0.0.11",
     "@clack/prompts": "^0.11.0",
     "chalk": "^5.4.1",
     "commander": "^12.1.0",