@agentrules/core 0.0.10 → 0.0.11

package/dist/index.d.ts

@@ -42,9 +42,12 @@ declare const bundledFileSchema: z.ZodObject<{
 /**
  * Schema for what clients send to publish a preset.
  * Version is optional major version. Registry assigns full MAJOR.MINOR.
+ *
+ * Note: Clients send `name` (e.g., "my-preset"), and the registry defines the format of the slug.
+ * For example, a namespaced slug could be returned as "username/my-preset"
  */
 declare const presetPublishInputSchema: z.ZodObject<{
-  slug: z.ZodString;
+  name: z.ZodString;
   platform: z.ZodEnum<{
     opencode: "opencode";
     codex: "codex";
@@ -69,7 +72,7 @@ declare const presetPublishInputSchema: z.ZodObject<{
 }, z.core.$strip>;
 /**
  * Schema for what registries store and return.
- * Includes version (required) - full MAJOR.MINOR format assigned by registry.
+ * Includes full namespaced slug and version assigned by registry.
  */
 declare const presetBundleSchema: z.ZodObject<{
   title: z.ZodString;
@@ -83,7 +86,6 @@ declare const presetBundleSchema: z.ZodObject<{
     cursor: "cursor";
   }>;
   features: z.ZodOptional<z.ZodArray<z.ZodString>>;
-  slug: z.ZodString;
   licenseContent: z.ZodOptional<z.ZodString>;
   readmeContent: z.ZodOptional<z.ZodString>;
   installMessage: z.ZodOptional<z.ZodString>;
@@ -93,6 +95,7 @@ declare const presetBundleSchema: z.ZodObject<{
     checksum: z.ZodString;
     contents: z.ZodString;
   }, z.core.$strip>>;
+  slug: z.ZodString;
   version: z.ZodString;
 }, z.core.$strip>;
 declare const presetSchema: z.ZodObject<{
@@ -137,29 +140,192 @@ declare const presetIndexSchema: z.ZodRecord<z.ZodString, z.ZodObject<{
 //#endregion
 //#region src/platform/types.d.ts
 /**
- * Single source of truth for platform IDs.
- * Add new platforms here - types and config will follow.
+ * Platform and rule type definitions.
  */
 declare const PLATFORM_ID_TUPLE: readonly ["opencode", "codex", "claude", "cursor"];
-/** Union type of supported platform IDs, derived from PLATFORM_ID_TUPLE */
+/** Union type of supported platform IDs */
 type PlatformId = (typeof PLATFORM_ID_TUPLE)[number];
-/** Configuration for a platform's directory paths */
-type PlatformConfig = {
-  /** Directory name for project installs (e.g., ".opencode") */
+/** File format for a rule type */
+type RuleFileFormat = "markdown" | "typescript" | "mdc";
+/** Configuration for a single rule type */
+type RuleTypeConfig = {
+  /** Human-readable description */
+  description: string;
+  /** File format */
+  format: RuleFileFormat;
+  /** File extension (without dot) */
+  extension: string;
+  /**
+   * Install path pattern relative to project root.
+   * Use {name} as placeholder for the rule slug/filename.
+   * null if project install not supported.
+   */
+  projectPath: string | null;
+  /**
+   * Install path pattern for global/user install.
+   * Use ~ for home directory.
+   * null if global install not supported.
+   */
+  globalPath: string | null;
+};
+/** Platform configuration with all its rule types */
+type PlatformRuleConfig = {
+  /** Human-readable platform name */
+  label: string;
+  /** Platform's project directory (e.g., ".opencode") */
   projectDir: string;
-  /** Path for global installs (e.g., "~/.config/opencode") */
-  globalDir: string;
+  /** Platform's global config directory (null if not supported) */
+  globalDir: string | null;
+  /** Rule types supported by this platform */
+  types: Record<string, RuleTypeConfig>;
+};
+/**
+ * Discriminated union of valid platform + type combinations.
+ * Must be kept in sync with PLATFORMS in config.ts.
+ */
+type PlatformRuleType = {
+  platform: "opencode";
+  type: "instruction" | "agent" | "command" | "tool";
+} | {
+  platform: "claude";
+  type: "instruction" | "command" | "skill";
+} | {
+  platform: "cursor";
+  type: "rule";
+} | {
+  platform: "codex";
+  type: "instruction" | "command";
 };
+/** Extract rule type for a specific platform */
+type RuleTypeForPlatform<P extends PlatformId> = Extract<PlatformRuleType, {
+  platform: P;
+}>["type"];
+/** Union of all valid rule types across all platforms */
+type RuleType = PlatformRuleType["type"];
 
 //#endregion
 //#region src/platform/config.d.ts
-/** List of supported platform IDs as a readonly tuple */
-declare const PLATFORM_IDS: readonly ["opencode", "codex", "claude", "cursor"];
+declare const PLATFORM_IDS: [PlatformId, ...PlatformId[]];
 /**
- * Platform-specific configuration.
- * Single source of truth for all platform paths.
+ * Platform configuration including supported rule types and install paths.
  */
-declare const PLATFORMS: Record<PlatformId, PlatformConfig>;
+declare const PLATFORMS: {
+  readonly opencode: {
+    readonly label: "OpenCode";
+    readonly projectDir: ".opencode";
+    readonly globalDir: "~/.config/opencode";
+    readonly types: {
+      readonly instruction: {
+        readonly description: "Project instructions (AGENTS.md)";
+        readonly format: "markdown";
+        readonly extension: "md";
+        readonly projectPath: "AGENTS.md";
+        readonly globalPath: "~/.config/opencode/AGENTS.md";
+      };
+      readonly agent: {
+        readonly description: "Specialized AI agent definition";
+        readonly format: "markdown";
+        readonly extension: "md";
+        readonly projectPath: ".opencode/agent/{name}.md";
+        readonly globalPath: "~/.config/opencode/agent/{name}.md";
+      };
+      readonly command: {
+        readonly description: "Custom slash command";
+        readonly format: "markdown";
+        readonly extension: "md";
+        readonly projectPath: ".opencode/command/{name}.md";
+        readonly globalPath: "~/.config/opencode/command/{name}.md";
+      };
+      readonly tool: {
+        readonly description: "Custom tool definition";
+        readonly format: "typescript";
+        readonly extension: "ts";
+        readonly projectPath: ".opencode/tool/{name}.ts";
+        readonly globalPath: "~/.config/opencode/tool/{name}.ts";
+      };
+    };
+  };
+  readonly claude: {
+    readonly label: "Claude Code";
+    readonly projectDir: ".claude";
+    readonly globalDir: "~/.claude";
+    readonly types: {
+      readonly instruction: {
+        readonly description: "Project instructions (CLAUDE.md)";
+        readonly format: "markdown";
+        readonly extension: "md";
+        readonly projectPath: "CLAUDE.md";
+        readonly globalPath: "~/.claude/CLAUDE.md";
+      };
+      readonly command: {
+        readonly description: "Custom slash command";
+        readonly format: "markdown";
+        readonly extension: "md";
+        readonly projectPath: ".claude/commands/{name}.md";
+        readonly globalPath: "~/.claude/commands/{name}.md";
+      };
+      readonly skill: {
+        readonly description: "Custom skill definition";
+        readonly format: "markdown";
+        readonly extension: "md";
+        readonly projectPath: ".claude/skills/{name}/SKILL.md";
+        readonly globalPath: "~/.claude/skills/{name}/SKILL.md";
+      };
+    };
+  };
+  readonly cursor: {
+    readonly label: "Cursor";
+    readonly projectDir: ".cursor";
+    readonly globalDir: null;
+    readonly types: {
+      readonly rule: {
+        readonly description: "Project rule (MDC format)";
+        readonly format: "mdc";
+        readonly extension: "mdc";
+        readonly projectPath: ".cursor/rules/{name}.mdc";
+        readonly globalPath: null;
+      };
+    };
+  };
+  readonly codex: {
+    readonly label: "Codex";
+    readonly projectDir: "";
+    readonly globalDir: "~/.codex";
+    readonly types: {
+      readonly instruction: {
+        readonly description: "Project instructions (AGENTS.md)";
+        readonly format: "markdown";
+        readonly extension: "md";
+        readonly projectPath: "AGENTS.md";
+        readonly globalPath: "~/.codex/AGENTS.md";
+      };
+      readonly command: {
+        readonly description: "Custom prompt (global only)";
+        readonly format: "markdown";
+        readonly extension: "md";
+        readonly projectPath: null;
+        readonly globalPath: "~/.codex/prompts/{name}.md";
+      };
+    };
+  };
+};
+/** Valid rule types for each platform. Must be kept in sync with PLATFORMS. */
+declare const PLATFORM_RULE_TYPES: {
+  readonly opencode: readonly ["instruction", "agent", "command", "tool"];
+  readonly claude: readonly ["instruction", "command", "skill"];
+  readonly cursor: readonly ["rule"];
+  readonly codex: readonly ["instruction", "command"];
+};
+/** Get valid rule types for a specific platform */
+declare function getValidRuleTypes(platform: PlatformId): readonly string[];
+/** Check if a type is valid for a given platform */
+declare function isValidRuleType(platform: PlatformId, type: string): boolean;
+/** Get the configuration for a specific platform + type combination */
+declare function getRuleTypeConfig(platform: PlatformId, type: string): RuleTypeConfig | undefined;
+/** Get the install path for a rule, replacing {name} placeholder */
+declare function getInstallPath(platform: PlatformId, type: string, name: string, location?: "project" | "global"): string | null;
+/** Get platform configuration */
+declare function getPlatformConfig(platform: PlatformId): PlatformRuleConfig;
 
 //#endregion
 //#region src/platform/utils.d.ts
@@ -202,9 +368,12 @@ type BundledFile = {
 /**
  * What clients send to publish a preset.
  * Version is optional major version. Registry assigns full MAJOR.MINOR.
+ *
+ * Note: Clients send `name` (e.g., "my-preset"), and the registry defines the format of the slug.
+ * For example, a namespaced slug could be returned as "username/my-preset"
  */
 type PresetPublishInput = {
-  slug: string;
+  name: string;
   platform: PlatformId;
   title: string;
   description: string;
@@ -220,9 +389,11 @@ type PresetPublishInput = {
 };
 /**
  * What registries store and return.
- * Includes version (required) - full MAJOR.MINOR format assigned by registry.
+ * Includes full namespaced slug and version assigned by registry.
  */
-type PresetBundle = Omit<PresetPublishInput, "version"> & {
+type PresetBundle = Omit<PresetPublishInput, "name" | "version"> & {
+  /** Full namespaced slug (e.g., "username/my-preset") */
+  slug: string;
   /** Full version in MAJOR.MINOR format (e.g., "1.3", "2.1") */
   version: string;
 };
@@ -246,7 +417,7 @@ type PresetFileInput = {
   contents: ArrayBuffer | ArrayBufferView | string;
 };
 type PresetInput = {
-  slug: string;
+  name: string;
   config: PresetConfig;
   files: PresetFileInput[];
   /** Install message from INSTALL.txt file */
@@ -261,7 +432,7 @@ type PresetInput = {
  * Directory name for bundle files in static registry output.
  * Used by `agentrules registry build` to structure output.
  */
-declare const STATIC_BUNDLE_DIR = "r";
+declare const STATIC_BUNDLE_DIR = "registry";
 /**
  * Options for building a PresetPublishInput (for CLI publish command).
  */
@@ -351,12 +522,20 @@ declare const PRESET_SCHEMA_URL = "https://agentrules.directory/schema/agentrule
 declare const LATEST_VERSION = "latest";
 /**
  * API endpoint paths (relative to registry base URL).
+ *
+ * Note: Path parameters (slug, platform, version) are NOT URI-encoded.
+ * - Slugs may contain slashes (e.g., "username/my-preset") which should flow
+ *   through as path segments for static registry compatibility
+ * - Platform and version are constrained values (enums, validated formats)
+ *   that only contain URL-safe characters
+ *
+ * The client is responsible for validating these values before making requests.
  */
 declare const API_ENDPOINTS: {
   /** Preset endpoints */
   readonly presets: {
     /** Base path for preset operations */
-    readonly base: "api/presets";
+    readonly base: "api/preset";
     /** Get preset by slug, platform, and version (defaults to "latest") */
     readonly get: (slug: string, platform: string, version?: string) => string;
     /** Unpublish preset version */
@@ -371,10 +550,112 @@ declare const API_ENDPOINTS: {
     /** Device token exchange */
     readonly deviceToken: "api/auth/device/token";
   };
+  /** Rule endpoints */
+  readonly rule: {
+    /** Base path for rule operations */
+    readonly base: "api/rule";
+    /** Get or update rule by slug */
+    readonly get: (slug: string) => string;
+  };
 };
 
+//#endregion
+//#region src/rule/schema.d.ts
+/**
+ * Schema for the rule name.
+ * This is what users provide when creating a rule.
+ */
+declare const ruleNameSchema: z.ZodString;
+declare const ruleTitleSchema: z.ZodString;
+declare const ruleDescriptionSchema: z.ZodString;
+declare const rulePlatformSchema: z.ZodEnum<{
+  opencode: "opencode";
+  codex: "codex";
+  claude: "claude";
+  cursor: "cursor";
+}>;
+declare const ruleTypeSchema: z.ZodString;
+declare const ruleContentSchema: z.ZodString;
+declare const ruleTagSchema: z.ZodString;
+declare const ruleTagsSchema: z.ZodArray<z.ZodString>;
+/**
+ * Discriminated union schema for platform + type combinations.
+ * Each platform has its own set of valid types.
+ */
+declare const rulePlatformTypeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+  platform: z.ZodLiteral<"opencode">;
+  type: z.ZodEnum<{
+    instruction: "instruction";
+    agent: "agent";
+    command: "command";
+    tool: "tool";
+  }>;
+}, z.core.$strip>, z.ZodObject<{
+  platform: z.ZodLiteral<"claude">;
+  type: z.ZodEnum<{
+    instruction: "instruction";
+    command: "command";
+    skill: "skill";
+  }>;
+}, z.core.$strip>, z.ZodObject<{
+  platform: z.ZodLiteral<"cursor">;
+  type: z.ZodEnum<{
+    rule: "rule";
+  }>;
+}, z.core.$strip>, z.ZodObject<{
+  platform: z.ZodLiteral<"codex">;
+  type: z.ZodEnum<{
+    instruction: "instruction";
+    command: "command";
+  }>;
+}, z.core.$strip>], "platform">;
+/** Schema for rule creation with discriminated union for platform+type */
+declare const ruleCreateInputSchema: z.ZodIntersection<z.ZodObject<{
+  name: z.ZodString;
+  title: z.ZodString;
+  description: z.ZodOptional<z.ZodString>;
+  content: z.ZodString;
+  tags: z.ZodArray<z.ZodString>;
+}, z.core.$strip>, z.ZodDiscriminatedUnion<[z.ZodObject<{
+  platform: z.ZodLiteral<"opencode">;
+  type: z.ZodEnum<{
+    instruction: "instruction";
+    agent: "agent";
+    command: "command";
+    tool: "tool";
+  }>;
+}, z.core.$strip>, z.ZodObject<{
+  platform: z.ZodLiteral<"claude">;
+  type: z.ZodEnum<{
+    instruction: "instruction";
+    command: "command";
+    skill: "skill";
+  }>;
+}, z.core.$strip>, z.ZodObject<{
+  platform: z.ZodLiteral<"cursor">;
+  type: z.ZodEnum<{
+    rule: "rule";
+  }>;
+}, z.core.$strip>, z.ZodObject<{
+  platform: z.ZodLiteral<"codex">;
+  type: z.ZodEnum<{
+    instruction: "instruction";
+    command: "command";
+  }>;
+}, z.core.$strip>], "platform">>;
+declare const ruleUpdateInputSchema: z.ZodObject<{
+  name: z.ZodString;
+  title: z.ZodOptional<z.ZodString>;
+  description: z.ZodOptional<z.ZodString>;
+  content: z.ZodOptional<z.ZodString>;
+  tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+type RuleCreateInput = z.infer<typeof ruleCreateInputSchema>;
+type RuleUpdateInput = z.infer<typeof ruleUpdateInputSchema>;
+
 //#endregion
 //#region src/utils/diff.d.ts
+/** Re-export platform-rule types for convenience */
 type DiffPreviewOptions = {
   context?: number;
   maxLines?: number;
@@ -397,4 +678,4 @@ declare function toUint8Array(payload: ArrayBuffer | ArrayBufferView): Uint8Arra
 declare function normalizeBundlePath(value: string): string;
 
 //#endregion
-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, tagSchema, tagsSchema, 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, PLATFORM_RULE_TYPES, PRESET_CONFIG_FILENAME, PRESET_SCHEMA_URL, PlatformId, PlatformRuleConfig, PlatformRuleType, Preset, PresetBundle, PresetConfig, PresetFileInput, PresetIndex, PresetInput, PresetPublishInput, ResolvedPreset, RuleCreateInput, RuleFileFormat, RuleType, RuleTypeConfig, RuleTypeForPlatform, RuleUpdateInput, STATIC_BUNDLE_DIR, buildPresetPublishInput, buildPresetRegistry, bundledFileSchema, cleanInstallMessage, createDiffPreview, decodeBundledFile, decodeUtf8, descriptionSchema, encodeItemName, encodeUtf8, fetchBundle, getInstallPath, getPlatformConfig, getPlatformFromDir, getRuleTypeConfig, getValidRuleTypes, isLikelyText, isPlatformDir, isSupportedPlatform, isValidRuleType, licenseSchema, normalizeBundlePath, normalizePlatformInput, platformIdSchema, presetBundleSchema, presetConfigSchema, presetIndexSchema, presetPublishInputSchema, presetSchema, resolvePreset, ruleContentSchema, ruleCreateInputSchema, ruleDescriptionSchema, ruleNameSchema, rulePlatformSchema, rulePlatformTypeSchema, ruleTagSchema, ruleTagsSchema, ruleTitleSchema, ruleTypeSchema, ruleUpdateInputSchema, slugSchema, tagSchema, tagsSchema, titleSchema, toPosixPath, toUint8Array, toUtf8String, validatePresetConfig, verifyBundledFileChecksum };

package/dist/index.js

@@ -17,25 +17,36 @@ const API_PATH = "api";
 const LATEST_VERSION = "latest";
 /**
 * API endpoint paths (relative to registry base URL).
+*
+* Note: Path parameters (slug, platform, version) are NOT URI-encoded.
+* - Slugs may contain slashes (e.g., "username/my-preset") which should flow
+*   through as path segments for static registry compatibility
+* - Platform and version are constrained values (enums, validated formats)
+*   that only contain URL-safe characters
+*
+* The client is responsible for validating these values before making requests.
 */
 const API_ENDPOINTS = {
 	presets: {
-		base: `${API_PATH}/presets`,
-		get: (slug, platform, version = LATEST_VERSION) => `${API_PATH}/presets/${encodeURIComponent(slug)}/${encodeURIComponent(platform)}/${encodeURIComponent(version)}`,
-		unpublish: (slug, platform, version) => `${API_PATH}/presets/${encodeURIComponent(slug)}/${encodeURIComponent(platform)}/${encodeURIComponent(version)}`
+		base: `${API_PATH}/preset`,
+		get: (slug, platform, version = LATEST_VERSION) => `${API_PATH}/preset/${slug}/${platform}/${version}`,
+		unpublish: (slug, platform, version) => `${API_PATH}/preset/${slug}/${platform}/${version}`
 	},
 	auth: {
 		session: `${API_PATH}/auth/get-session`,
 		deviceCode: `${API_PATH}/auth/device/code`,
 		deviceToken: `${API_PATH}/auth/device/token`
+	},
+	rule: {
+		base: `${API_PATH}/rule`,
+		get: (slug) => `${API_PATH}/rule/${slug}`
 	}
 };
 
 //#endregion
 //#region src/platform/types.ts
 /**
-* Single source of truth for platform IDs.
-* Add new platforms here - types and config will follow.
+* Platform and rule type definitions.
 */
 const PLATFORM_ID_TUPLE = [
 	"opencode",
@@ -46,30 +57,149 @@ const PLATFORM_ID_TUPLE = [
 
 //#endregion
 //#region src/platform/config.ts
-/** List of supported platform IDs as a readonly tuple */
 const PLATFORM_IDS = PLATFORM_ID_TUPLE;
 /**
-* Platform-specific configuration.
-* Single source of truth for all platform paths.
+* Platform configuration including supported rule types and install paths.
 */
 const PLATFORMS = {
 	opencode: {
+		label: "OpenCode",
 		projectDir: ".opencode",
-		globalDir: "~/.config/opencode"
-	},
-	codex: {
-		projectDir: ".codex",
-		globalDir: "~/.codex"
+		globalDir: "~/.config/opencode",
+		types: {
+			instruction: {
+				description: "Project instructions (AGENTS.md)",
+				format: "markdown",
+				extension: "md",
+				projectPath: "AGENTS.md",
+				globalPath: "~/.config/opencode/AGENTS.md"
+			},
+			agent: {
+				description: "Specialized AI agent definition",
+				format: "markdown",
+				extension: "md",
+				projectPath: ".opencode/agent/{name}.md",
+				globalPath: "~/.config/opencode/agent/{name}.md"
+			},
+			command: {
+				description: "Custom slash command",
+				format: "markdown",
+				extension: "md",
+				projectPath: ".opencode/command/{name}.md",
+				globalPath: "~/.config/opencode/command/{name}.md"
+			},
+			tool: {
+				description: "Custom tool definition",
+				format: "typescript",
+				extension: "ts",
+				projectPath: ".opencode/tool/{name}.ts",
+				globalPath: "~/.config/opencode/tool/{name}.ts"
+			}
+		}
 	},
 	claude: {
+		label: "Claude Code",
 		projectDir: ".claude",
-		globalDir: "~/.claude"
+		globalDir: "~/.claude",
+		types: {
+			instruction: {
+				description: "Project instructions (CLAUDE.md)",
+				format: "markdown",
+				extension: "md",
+				projectPath: "CLAUDE.md",
+				globalPath: "~/.claude/CLAUDE.md"
+			},
+			command: {
+				description: "Custom slash command",
+				format: "markdown",
+				extension: "md",
+				projectPath: ".claude/commands/{name}.md",
+				globalPath: "~/.claude/commands/{name}.md"
+			},
+			skill: {
+				description: "Custom skill definition",
+				format: "markdown",
+				extension: "md",
+				projectPath: ".claude/skills/{name}/SKILL.md",
+				globalPath: "~/.claude/skills/{name}/SKILL.md"
+			}
+		}
 	},
 	cursor: {
+		label: "Cursor",
 		projectDir: ".cursor",
-		globalDir: "~/.cursor"
+		globalDir: null,
+		types: { rule: {
+			description: "Project rule (MDC format)",
+			format: "mdc",
+			extension: "mdc",
+			projectPath: ".cursor/rules/{name}.mdc",
+			globalPath: null
+		} }
+	},
+	codex: {
+		label: "Codex",
+		projectDir: "",
+		globalDir: "~/.codex",
+		types: {
+			instruction: {
+				description: "Project instructions (AGENTS.md)",
+				format: "markdown",
+				extension: "md",
+				projectPath: "AGENTS.md",
+				globalPath: "~/.codex/AGENTS.md"
+			},
+			command: {
+				description: "Custom prompt (global only)",
+				format: "markdown",
+				extension: "md",
+				projectPath: null,
+				globalPath: "~/.codex/prompts/{name}.md"
+			}
+		}
 	}
 };
+/** Valid rule types for each platform. Must be kept in sync with PLATFORMS. */
+const PLATFORM_RULE_TYPES = {
+	opencode: [
+		"instruction",
+		"agent",
+		"command",
+		"tool"
+	],
+	claude: [
+		"instruction",
+		"command",
+		"skill"
+	],
+	cursor: ["rule"],
+	codex: ["instruction", "command"]
+};
+/** Get valid rule types for a specific platform */
+function getValidRuleTypes(platform) {
+	return PLATFORM_RULE_TYPES[platform];
+}
+/** Check if a type is valid for a given platform */
+function isValidRuleType(platform, type) {
+	return PLATFORM_RULE_TYPES[platform].includes(type);
+}
+/** Get the configuration for a specific platform + type combination */
+function getRuleTypeConfig(platform, type) {
+	const platformConfig = PLATFORMS[platform];
+	return platformConfig.types[type];
+}
+/** Get the install path for a rule, replacing {name} placeholder */
+function getInstallPath(platform, type, name, location = "project") {
+	const config = getRuleTypeConfig(platform, type);
+	if (!config) return null;
+	const pathTemplate = location === "project" ? config.projectPath : config.globalPath;
+	if (!pathTemplate) return null;
+	return pathTemplate.replace("{name}", name);
+}
+/** Get platform configuration */
+function getPlatformConfig(platform) {
+	return PLATFORMS[platform];
+}
 
 //#endregion
 //#region src/platform/utils.ts
@@ -170,9 +300,12 @@ const bundledFileSchema = z.object({
 /**
 * Schema for what clients send to publish a preset.
 * Version is optional major version. Registry assigns full MAJOR.MINOR.
+*
+* Note: Clients send `name` (e.g., "my-preset"), and the registry defines the format of the slug.
+* For example, a namespaced slug could be returned as "username/my-preset"
 */
 const presetPublishInputSchema = z.object({
-	slug: z.string().trim().min(1),
+	name: slugSchema,
 	platform: platformIdSchema,
 	title: titleSchema,
 	description: descriptionSchema,
@@ -187,9 +320,15 @@ const presetPublishInputSchema = z.object({
 });
 /**
 * Schema for what registries store and return.
-* Includes version (required) - full MAJOR.MINOR format assigned by registry.
+* Includes full namespaced slug and version assigned by registry.
 */
-const presetBundleSchema = presetPublishInputSchema.omit({ version: true }).extend({ version: versionSchema });
+const presetBundleSchema = presetPublishInputSchema.omit({
+	name: true,
+	version: true
+}).extend({
+	slug: z.string().trim().min(1),
+	version: versionSchema
+});
 const presetSchema = presetBundleSchema.omit({
 	files: true,
 	readmeContent: true,
@@ -235,7 +374,7 @@ const NAME_PATTERN = /^[a-z0-9-]+$/;
 * Directory name for bundle files in static registry output.
 * Used by `agentrules registry build` to structure output.
 */
-const STATIC_BUNDLE_DIR = "r";
+const STATIC_BUNDLE_DIR = "registry";
 /**
 * Compute SHA-256 hash using Web Crypto API (works in browser and Node.js 15+)
 */
@@ -250,11 +389,11 @@ async function sha256(data) {
 */
 async function buildPresetPublishInput(options) {
 	const { preset: presetInput, version } = options;
-	if (!NAME_PATTERN.test(presetInput.slug)) throw new Error(`Invalid slug "${presetInput.slug}". Slugs must be lowercase kebab-case.`);
-	const presetConfig = validatePresetConfig(presetInput.config, presetInput.slug);
+	if (!NAME_PATTERN.test(presetInput.name)) throw new Error(`Invalid name "${presetInput.name}". Names must be lowercase kebab-case.`);
+	const presetConfig = validatePresetConfig(presetInput.config, presetInput.name);
 	const platform = presetConfig.platform;
-	ensureKnownPlatform(platform, presetInput.slug);
-	if (presetInput.files.length === 0) throw new Error(`Preset ${presetInput.slug} does not include any files.`);
+	ensureKnownPlatform(platform, presetInput.name);
+	if (presetInput.files.length === 0) throw new Error(`Preset ${presetInput.name} does not include any files.`);
 	const files = await createBundledFilesFromInputs(presetInput.files);
 	const installMessage = cleanInstallMessage(presetInput.installMessage);
 	const features = presetConfig.features ?? [];
@@ -262,7 +401,7 @@ async function buildPresetPublishInput(options) {
 	const licenseContent = presetInput.licenseContent?.trim() || void 0;
 	const majorVersion = version ?? presetConfig.version;
 	return {
-		slug: presetInput.slug,
+		name: presetInput.name,
 		platform,
 		title: presetConfig.title,
 		description: presetConfig.description,
@@ -286,11 +425,11 @@ async function buildPresetRegistry(options) {
 	const entries = [];
 	const bundles = [];
 	for (const presetInput of options.presets) {
-		if (!NAME_PATTERN.test(presetInput.slug)) throw new Error(`Invalid slug "${presetInput.slug}". Slugs must be lowercase kebab-case.`);
-		const presetConfig = validatePresetConfig(presetInput.config, presetInput.slug);
+		if (!NAME_PATTERN.test(presetInput.name)) throw new Error(`Invalid name "${presetInput.name}". Names must be lowercase kebab-case.`);
+		const presetConfig = validatePresetConfig(presetInput.config, presetInput.name);
 		const platform = presetConfig.platform;
-		ensureKnownPlatform(platform, presetInput.slug);
-		if (presetInput.files.length === 0) throw new Error(`Preset ${presetInput.slug} does not include any files.`);
+		ensureKnownPlatform(platform, presetInput.name);
+		if (presetInput.files.length === 0) throw new Error(`Preset ${presetInput.name} does not include any files.`);
 		const files = await createBundledFilesFromInputs(presetInput.files);
 		const totalSize = files.reduce((sum, file) => sum + file.size, 0);
 		const installMessage = cleanInstallMessage(presetInput.installMessage);
@@ -299,9 +438,10 @@ async function buildPresetRegistry(options) {
 		const licenseContent = presetInput.licenseContent?.trim() || void 0;
 		const majorVersion = presetConfig.version ?? 1;
 		const version = `${majorVersion}.0`;
+		const slug = presetInput.name;
 		const entry = {
-			name: encodeItemName(presetInput.slug, platform),
-			slug: presetInput.slug,
+			name: encodeItemName(slug, platform),
+			slug,
 			platform,
 			title: presetConfig.title,
 			version,
@@ -309,13 +449,13 @@ async function buildPresetRegistry(options) {
 			tags: presetConfig.tags ?? [],
 			license: presetConfig.license,
 			features,
-			bundleUrl: getBundlePath(bundleBase, presetInput.slug, platform, version),
+			bundleUrl: getBundlePath(bundleBase, slug, platform, version),
 			fileCount: files.length,
 			totalSize
 		};
 		entries.push(entry);
 		const bundle = {
-			slug: presetInput.slug,
+			slug,
 			platform,
 			title: presetConfig.title,
 			version,
@@ -471,6 +611,61 @@ async function fetchBundle(bundleUrl) {
 	}
 }
 
+//#endregion
+//#region src/rule/schema.ts
+const NAME_REGEX = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+/**
+* Schema for the rule name.
+* This is what users provide when creating a rule.
+*/
+const ruleNameSchema = z.string().trim().min(1, "Name is required").max(64, "Name must be 64 characters or less").regex(NAME_REGEX, "Must be lowercase alphanumeric with hyphens");
+const ruleTitleSchema = z.string().trim().min(1, "Title is required").max(80, "Title must be 80 characters or less");
+const ruleDescriptionSchema = z.string().trim().max(500, "Description must be 500 characters or less");
+const rulePlatformSchema = z.enum(PLATFORM_IDS);
+const ruleTypeSchema = z.string().trim().min(1).max(32);
+const ruleContentSchema = z.string().min(1, "Content is required").max(1e5, "Content must be 100KB or less");
+const ruleTagSchema = z.string().trim().min(1).max(32).regex(/^[a-z0-9]+(?:-[a-z0-9]+)*$/, "Tags must be lowercase alphanumeric with single hyphens between words");
+const ruleTagsSchema = z.array(ruleTagSchema).min(1, "At least 1 tag is required").max(10, "Maximum 10 tags allowed");
+/** Common fields shared across all platform-type combinations */
+const ruleCommonFields = {
+	name: ruleNameSchema,
+	title: ruleTitleSchema,
+	description: ruleDescriptionSchema.optional(),
+	content: ruleContentSchema,
+	tags: ruleTagsSchema
+};
+/**
+* Discriminated union schema for platform + type combinations.
+* Each platform has its own set of valid types.
+*/
+const rulePlatformTypeSchema = z.discriminatedUnion("platform", [
+	z.object({
+		platform: z.literal("opencode"),
+		type: z.enum(PLATFORM_RULE_TYPES.opencode)
+	}),
+	z.object({
+		platform: z.literal("claude"),
+		type: z.enum(PLATFORM_RULE_TYPES.claude)
+	}),
+	z.object({
+		platform: z.literal("cursor"),
+		type: z.enum(PLATFORM_RULE_TYPES.cursor)
+	}),
+	z.object({
+		platform: z.literal("codex"),
+		type: z.enum(PLATFORM_RULE_TYPES.codex)
+	})
+]);
+/** Schema for rule creation with discriminated union for platform+type */
+const ruleCreateInputSchema = z.object(ruleCommonFields).and(rulePlatformTypeSchema);
+const ruleUpdateInputSchema = z.object({
+	name: ruleNameSchema,
+	title: ruleTitleSchema.optional(),
+	description: ruleDescriptionSchema.optional(),
+	content: ruleContentSchema.optional(),
+	tags: ruleTagsSchema.optional()
+});
+
 //#endregion
 //#region src/utils/diff.ts
 const DEFAULT_CONTEXT = 2;
@@ -495,4 +690,4 @@ function normalizeBundlePath(value) {
 }
 
 //#endregion
-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, tagSchema, tagsSchema, titleSchema, toPosixPath, toUint8Array, toUtf8String, validatePresetConfig, verifyBundledFileChecksum };
+export { AGENT_RULES_DIR, API_ENDPOINTS, COMMON_LICENSES, LATEST_VERSION, PLATFORMS, PLATFORM_IDS, PLATFORM_ID_TUPLE, PLATFORM_RULE_TYPES, PRESET_CONFIG_FILENAME, PRESET_SCHEMA_URL, STATIC_BUNDLE_DIR, buildPresetPublishInput, buildPresetRegistry, bundledFileSchema, cleanInstallMessage, createDiffPreview, decodeBundledFile, decodeUtf8, descriptionSchema, encodeItemName, encodeUtf8, fetchBundle, getInstallPath, getPlatformConfig, getPlatformFromDir, getRuleTypeConfig, getValidRuleTypes, isLikelyText, isPlatformDir, isSupportedPlatform, isValidRuleType, licenseSchema, normalizeBundlePath, normalizePlatformInput, platformIdSchema, presetBundleSchema, presetConfigSchema, presetIndexSchema, presetPublishInputSchema, presetSchema, resolvePreset, ruleContentSchema, ruleCreateInputSchema, ruleDescriptionSchema, ruleNameSchema, rulePlatformSchema, rulePlatformTypeSchema, ruleTagSchema, ruleTagsSchema, ruleTitleSchema, ruleTypeSchema, ruleUpdateInputSchema, slugSchema, tagSchema, tagsSchema, titleSchema, toPosixPath, toUint8Array, toUtf8String, validatePresetConfig, verifyBundledFileChecksum };

package/package.json

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