@agentrules/core 0.0.7 → 0.0.9

package/dist/index.d.ts

@@ -29,6 +29,7 @@ declare const presetConfigSchema: z.ZodObject<{
     cursor: "cursor";
   }>;
   path: z.ZodOptional<z.ZodString>;
+  ignore: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strict>;
 declare const bundledFileSchema: z.ZodObject<{
   path: z.ZodString;
@@ -157,16 +158,20 @@ declare const PLATFORM_IDS: readonly ["opencode", "codex", "claude", "cursor"];
  * Single source of truth for all platform paths.
  */
 declare const PLATFORMS: Record<PlatformId, PlatformConfig>;
-/**
- * Convention: preset files under this directory map to the platform config directory.
- * e.g., `config/agent.md` → `.opencode/agent.md` (project) or `agent.md` (global)
- */
-declare const CONFIG_DIR_NAME = "config";
 
 //#endregion
 //#region src/platform/utils.d.ts
 declare function isSupportedPlatform(value: string): value is PlatformId;
 declare function normalizePlatformInput(value: string): PlatformId;
+/**
+ * Check if a directory name matches a platform's projectDir.
+ * Used to detect if a preset config is inside a platform directory (in-project mode).
+ */
+declare function isPlatformDir(dirName: string): boolean;
+/**
+ * Get the platform ID from a directory name, if it matches a platform's projectDir.
+ */
+declare function getPlatformFromDir(dirName: string): PlatformId | undefined;
 
 //#endregion
 //#region src/preset/types.d.ts
@@ -182,6 +187,8 @@ type PresetConfig = {
   platform: PlatformId;
   /** Path to config files. Defaults to platform's projectDir (e.g., ".claude") */
   path?: string;
+  /** Additional patterns to exclude from bundle (glob patterns) */
+  ignore?: string[];
 };
 type BundledFile = {
   path: string;
@@ -334,6 +341,8 @@ declare function fetchBundle(bundleUrl: string): Promise<PresetBundle>;
  */
 /** Filename for preset configuration */
 declare const PRESET_CONFIG_FILENAME = "agentrules.json";
+/** Directory name for preset metadata (README, LICENSE, etc.) */
+declare const AGENT_RULES_DIR = ".agentrules";
 /** JSON Schema URL for preset configuration */
 declare const PRESET_SCHEMA_URL = "https://agentrules.directory/schema/agentrules.json";
 /** Default version identifier for latest preset version */
@@ -373,15 +382,17 @@ declare function createDiffPreview(path: string, currentText: string, incomingTe
 //#endregion
 //#region src/utils/encoding.d.ts
 declare function toPosixPath(pathValue: string): string;
-declare function encodeUtf8(value: string): Uint8Array<ArrayBuffer>;
+declare function encodeUtf8(value: string): Uint8Array<ArrayBufferLike>;
 declare function decodeUtf8(payload: ArrayBuffer | ArrayBufferView): string;
 declare function toUint8Array(payload: ArrayBuffer | ArrayBufferView): Uint8Array<ArrayBufferLike>;
 
 //#endregion
 //#region src/utils/paths.d.ts
+/**
+ * Normalize a bundle file path by converting backslashes to forward slashes
+ * and removing leading ./ or / prefixes.
+ */
 declare function normalizeBundlePath(value: string): string;
-declare function normalizePathFragment(value?: string): string | undefined;
-declare function maybeStripPrefix(pathInput: string, prefix?: string): string;
 
 //#endregion
-export { API_ENDPOINTS, BuildPresetPublishInputOptions, BuildPresetRegistryOptions, BuildPresetRegistryResult, BundledFile, COMMON_LICENSES, CONFIG_DIR_NAME, CommonLicense, DiffPreviewOptions, LATEST_VERSION, PLATFORMS, PLATFORM_IDS, PLATFORM_ID_TUPLE, PRESET_CONFIG_FILENAME, PRESET_SCHEMA_URL, PlatformConfig, PlatformId, Preset, PresetBundle, PresetConfig, PresetFileInput, PresetIndex, PresetInput, PresetPublishInput, ResolvedPreset, STATIC_BUNDLE_DIR, buildPresetPublishInput, buildPresetRegistry, bundledFileSchema, cleanInstallMessage, createDiffPreview, decodeBundledFile, decodeUtf8, descriptionSchema, encodeItemName, encodeUtf8, fetchBundle, isLikelyText, isSupportedPlatform, licenseSchema, maybeStripPrefix, normalizeBundlePath, normalizePathFragment, normalizePlatformInput, platformIdSchema, presetBundleSchema, presetConfigSchema, presetIndexSchema, presetPublishInputSchema, presetSchema, resolvePreset, slugSchema, titleSchema, toPosixPath, toUint8Array, toUtf8String, validatePresetConfig, verifyBundledFileChecksum };
+export { AGENT_RULES_DIR, API_ENDPOINTS, BuildPresetPublishInputOptions, BuildPresetRegistryOptions, BuildPresetRegistryResult, BundledFile, COMMON_LICENSES, CommonLicense, DiffPreviewOptions, LATEST_VERSION, PLATFORMS, PLATFORM_IDS, PLATFORM_ID_TUPLE, PRESET_CONFIG_FILENAME, PRESET_SCHEMA_URL, PlatformConfig, PlatformId, Preset, PresetBundle, PresetConfig, PresetFileInput, PresetIndex, PresetInput, PresetPublishInput, ResolvedPreset, STATIC_BUNDLE_DIR, buildPresetPublishInput, buildPresetRegistry, bundledFileSchema, cleanInstallMessage, createDiffPreview, decodeBundledFile, decodeUtf8, descriptionSchema, encodeItemName, encodeUtf8, fetchBundle, getPlatformFromDir, isLikelyText, isPlatformDir, isSupportedPlatform, licenseSchema, normalizeBundlePath, normalizePlatformInput, platformIdSchema, presetBundleSchema, presetConfigSchema, presetIndexSchema, presetPublishInputSchema, presetSchema, resolvePreset, slugSchema, titleSchema, toPosixPath, toUint8Array, toUtf8String, validatePresetConfig, verifyBundledFileChecksum };

package/dist/index.js

@@ -7,6 +7,8 @@ import { createTwoFilesPatch } from "diff";
 */
 /** Filename for preset configuration */
 const PRESET_CONFIG_FILENAME = "agentrules.json";
+/** Directory name for preset metadata (README, LICENSE, etc.) */
+const AGENT_RULES_DIR = ".agentrules";
 /** JSON Schema URL for preset configuration */
 const PRESET_SCHEMA_URL = "https://agentrules.directory/schema/agentrules.json";
 /** API root path segment */
@@ -68,11 +70,6 @@ const PLATFORMS = {
 		globalDir: "~/.cursor"
 	}
 };
-/**
-* Convention: preset files under this directory map to the platform config directory.
-* e.g., `config/agent.md` → `.opencode/agent.md` (project) or `agent.md` (global)
-*/
-const CONFIG_DIR_NAME = "config";
 
 //#endregion
 //#region src/platform/utils.ts
@@ -84,6 +81,20 @@ function normalizePlatformInput(value) {
 	if (isSupportedPlatform(normalized)) return normalized;
 	throw new Error(`Unknown platform "${value}". Supported platforms: ${PLATFORM_IDS.join(", ")}.`);
 }
+/**
+* Check if a directory name matches a platform's projectDir.
+* Used to detect if a preset config is inside a platform directory (in-project mode).
+*/
+function isPlatformDir(dirName) {
+	return PLATFORM_IDS.some((id) => PLATFORMS[id].projectDir === dirName);
+}
+/**
+* Get the platform ID from a directory name, if it matches a platform's projectDir.
+*/
+function getPlatformFromDir(dirName) {
+	for (const id of PLATFORM_IDS) if (PLATFORMS[id].projectDir === dirName) return id;
+	return;
+}
 
 //#endregion
 //#region src/utils/encoding.ts
@@ -107,13 +118,16 @@ function toUint8Array(payload) {
 
 //#endregion
 //#region src/preset/schema.ts
+const PLATFORM_ID_SET = new Set(PLATFORM_IDS);
 const VERSION_REGEX = /^[1-9]\d*\.\d+$/;
 const platformIdSchema = z.enum(PLATFORM_IDS);
 const titleSchema = z.string().trim().min(1, "Title is required").max(80, "Title must be 80 characters or less");
 const descriptionSchema = z.string().trim().min(1, "Description is required").max(500, "Description must be 500 characters or less");
 const versionSchema = z.string().trim().regex(VERSION_REGEX, "Version must be in MAJOR.MINOR format (e.g., 1.3)");
 const majorVersionSchema = z.number().int().positive("Major version must be a positive integer");
-const tagSchema = z.string().trim().min(1, "Tag cannot be empty").max(35, "Tag must be 35 characters or less");
+const TAG_REGEX = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+const TAG_ERROR = "Must be lowercase alphanumeric with hyphens (e.g., my-tag)";
+const tagSchema = z.string().trim().min(1, "Tag cannot be empty").max(35, "Tag must be 35 characters or less").regex(TAG_REGEX, TAG_ERROR).refine((tag) => !PLATFORM_ID_SET.has(tag), { message: "Platform names cannot be used as tags (redundant with platform field)" });
 const tagsSchema = z.array(tagSchema).min(1, "At least one tag is required").max(10, "Maximum 10 tags allowed");
 const featureSchema = z.string().trim().min(1, "Feature cannot be empty").max(100, "Feature must be 100 characters or less");
 const featuresSchema = z.array(featureSchema).max(5, "Maximum 5 features allowed");
@@ -132,6 +146,8 @@ const COMMON_LICENSES = [
 ];
 const licenseSchema = z.string().trim().min(1, "License is required").max(128, "License must be 128 characters or less");
 const pathSchema = z.string().trim().min(1);
+const ignorePatternSchema = z.string().trim().min(1, "Ignore pattern cannot be empty");
+const ignoreSchema = z.array(ignorePatternSchema).max(50, "Maximum 50 ignore patterns allowed");
 const presetConfigSchema = z.object({
 	$schema: z.string().optional(),
 	name: slugSchema,
@@ -142,7 +158,8 @@ const presetConfigSchema = z.object({
 	features: featuresSchema.optional(),
 	license: licenseSchema,
 	platform: platformIdSchema,
-	path: pathSchema.optional()
+	path: pathSchema.optional(),
+	ignore: ignoreSchema.optional()
 }).strict();
 const bundledFileSchema = z.object({
 	path: z.string().min(1),
@@ -469,20 +486,13 @@ function createDiffPreview(path, currentText, incomingText, options = {}) {
 
 //#endregion
 //#region src/utils/paths.ts
+/**
+* Normalize a bundle file path by converting backslashes to forward slashes
+* and removing leading ./ or / prefixes.
+*/
 function normalizeBundlePath(value) {
 	return value.replace(/\\/g, "/").replace(/^\.\/+/, "").replace(/^\/+/, "");
 }
-function normalizePathFragment(value) {
-	if (!value) return;
-	const normalized = value.replace(/\\/g, "/").replace(/^\/+/, "");
-	return normalized.replace(/\/+$/, "");
-}
-function maybeStripPrefix(pathInput, prefix) {
-	if (!prefix) return pathInput;
-	if (pathInput === prefix) return "";
-	if (pathInput.startsWith(`${prefix}/`)) return pathInput.slice(prefix.length + 1);
-	return pathInput;
-}
 
 //#endregion
-export { API_ENDPOINTS, COMMON_LICENSES, CONFIG_DIR_NAME, LATEST_VERSION, PLATFORMS, PLATFORM_IDS, PLATFORM_ID_TUPLE, PRESET_CONFIG_FILENAME, PRESET_SCHEMA_URL, STATIC_BUNDLE_DIR, buildPresetPublishInput, buildPresetRegistry, bundledFileSchema, cleanInstallMessage, createDiffPreview, decodeBundledFile, decodeUtf8, descriptionSchema, encodeItemName, encodeUtf8, fetchBundle, isLikelyText, isSupportedPlatform, licenseSchema, maybeStripPrefix, normalizeBundlePath, normalizePathFragment, normalizePlatformInput, platformIdSchema, presetBundleSchema, presetConfigSchema, presetIndexSchema, presetPublishInputSchema, presetSchema, resolvePreset, slugSchema, titleSchema, toPosixPath, toUint8Array, toUtf8String, validatePresetConfig, verifyBundledFileChecksum };
+export { AGENT_RULES_DIR, API_ENDPOINTS, COMMON_LICENSES, LATEST_VERSION, PLATFORMS, PLATFORM_IDS, PLATFORM_ID_TUPLE, PRESET_CONFIG_FILENAME, PRESET_SCHEMA_URL, STATIC_BUNDLE_DIR, buildPresetPublishInput, buildPresetRegistry, bundledFileSchema, cleanInstallMessage, createDiffPreview, decodeBundledFile, decodeUtf8, descriptionSchema, encodeItemName, encodeUtf8, fetchBundle, getPlatformFromDir, isLikelyText, isPlatformDir, isSupportedPlatform, licenseSchema, normalizeBundlePath, normalizePlatformInput, platformIdSchema, presetBundleSchema, presetConfigSchema, presetIndexSchema, presetPublishInputSchema, presetSchema, resolvePreset, slugSchema, titleSchema, toPosixPath, toUint8Array, toUtf8String, validatePresetConfig, verifyBundledFileChecksum };

package/package.json

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