feat(rules): introduce RuleInputPlugin and related functionality

Added the RuleInputPlugin to handle rule prompts with glob patterns, enabling project and global scope rules. Updated various components to integrate rule processing, including output plugins and configuration types. Version updated across package.json files to reflect new features.

- Introduced validation for rule metadata.
- Enhanced output plugins to support rule file generation.
- Added tests for rule input and output functionalities.
- Updated configuration types to include shadowRulesDir and rule-related structures.

Author: TrueNine

cli/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@truenine/memory-sync-cli",
   "type": "module",
-  "version": "2026.10214.1083059",
+  "version": "2026.10217.12221",
   "description": "TrueNine Memory Synchronization CLI",
   "author": "TrueNine",
   "license": "AGPL-3.0-only",

cli/src/PluginPipeline.ts

@@ -647,6 +647,11 @@ export class PluginPipeline {
         ? [...base.skills ?? [], ...addition.skills]
         : base.skills
 
+    const rules: CollectedInputContext['rules'] | undefined
+      = addition.rules != null
+        ? [...base.rules ?? [], ...addition.rules]
+        : base.rules
+
     const aiAgentIgnoreConfigFiles: CollectedInputContext['aiAgentIgnoreConfigFiles'] | undefined
       = addition.aiAgentIgnoreConfigFiles != null
         ? [...base.aiAgentIgnoreConfigFiles ?? [], ...addition.aiAgentIgnoreConfigFiles]
@@ -675,6 +680,7 @@ export class PluginPipeline {
       ...fastCommands != null ? {fastCommands} : {},
       ...subAgents != null ? {subAgents} : {},
       ...skills != null ? {skills} : {},
+      ...rules != null ? {rules} : {},
       ...aiAgentIgnoreConfigFiles != null ? {aiAgentIgnoreConfigFiles} : {},
       ...globalMemory != null ? {globalMemory} : {},
       ...shadowSourceProjectDir != null ? {shadowSourceProjectDir} : {},

cli/src/config.ts

@@ -39,6 +39,7 @@ function userConfigToPluginOptions(userConfig: UserConfigFile): Partial<PluginOp
     ...userConfig.shadowSkillSourceDir != null ? {shadowSkillSourceDir: userConfig.shadowSkillSourceDir} : {},
     ...userConfig.shadowFastCommandDir != null ? {shadowFastCommandDir: userConfig.shadowFastCommandDir} : {},
     ...userConfig.shadowSubAgentDir != null ? {shadowSubAgentDir: userConfig.shadowSubAgentDir} : {},
+    ...userConfig.shadowRulesDir != null ? {shadowRulesDir: userConfig.shadowRulesDir} : {},
     ...userConfig.globalMemoryFile != null ? {globalMemoryFile: userConfig.globalMemoryFile} : {},
     ...userConfig.shadowProjectsDir != null ? {shadowProjectsDir: userConfig.shadowProjectsDir} : {},
     ...userConfig.externalProjects != null ? {externalProjects: userConfig.externalProjects} : {},
@@ -232,6 +233,7 @@ export async function defineConfig(options: PluginOptions | DefineConfigOptions
     ...merged.fastCommands != null && {fastCommands: merged.fastCommands},
     ...merged.subAgents != null && {subAgents: merged.subAgents},
     ...merged.skills != null && {skills: merged.skills},
+    ...merged.rules != null && {rules: merged.rules},
     ...merged.globalMemory != null && {globalMemory: merged.globalMemory},
     ...merged.aiAgentIgnoreConfigFiles != null && {aiAgentIgnoreConfigFiles: merged.aiAgentIgnoreConfigFiles},
     ...merged.shadowSourceProjectDir != null && {shadowSourceProjectDir: merged.shadowSourceProjectDir},

cli/src/plugin.config.ts

@@ -24,6 +24,7 @@ import {ProjectPromptInputPlugin} from '@/plugins/ProjectPromptInputPlugin'
 import {QoderIDEPluginOutputPlugin} from '@/plugins/QoderIDEPluginOutputPlugin'
 import {ReadmeMdConfigFileOutputPlugin} from '@/plugins/ReadmeMdConfigFileOutputPlugin'
 import {ReadmeMdInputPlugin} from '@/plugins/ReadmeMdInputPlugin'
+import {RuleInputPlugin} from '@/plugins/RuleInputPlugin'
 import {ShadowProjectInputPlugin} from '@/plugins/ShadowProjectInputPlugin'
 import {SkillInputPlugin} from '@/plugins/SkillInputPlugin'
 import {SkillNonSrcFileSyncEffectInputPlugin} from '@/plugins/SkillNonSrcFileSyncEffectInputPlugin'
@@ -68,6 +69,7 @@ export default defineConfig({
     new SkillInputPlugin(),
     new FastCommandInputPlugin(),
     new SubAgentInputPlugin(),
+    new RuleInputPlugin(),
     new GlobalMemoryInputPlugin(),
     new ProjectPromptInputPlugin(),
     new ReadmeMdInputPlugin(),

cli/src/plugins/CursorOutputPlugin.ts

@@ -3,6 +3,7 @@ import type {
   OutputPluginContext,
   OutputWriteContext,
   Project,
+  RulePrompt,
   SkillPrompt,
   WriteResult,
   WriteResults
@@ -22,6 +23,7 @@ const RULES_SUBDIR = 'rules'
 const GLOBAL_RULE_FILE = 'global.mdc'
 const SKILLS_CURSOR_SUBDIR = 'skills-cursor'
 const SKILL_FILE_NAME = 'SKILL.md'
+const RULE_FILE_PREFIX = 'rule-'
 
 const PRESERVED_SKILLS = new Set<string>([
   'create-rule',
@@ -75,7 +77,7 @@ export class CursorOutputPlugin extends AbstractOutputPlugin {
   async registerGlobalOutputDirs(ctx: OutputPluginContext): Promise<RelativePath[]> {
     const results: RelativePath[] = []
     const globalDir = this.getGlobalConfigDir()
-    const {fastCommands, skills} = ctx.collectedInputContext
+    const {fastCommands, skills, rules} = ctx.collectedInputContext
 
     if (fastCommands != null && fastCommands.length > 0) {
       const commandsDir = this.getGlobalCommandsDir()
@@ -104,6 +106,17 @@ export class CursorOutputPlugin extends AbstractOutputPlugin {
       }
     }
 
+    const globalRules = rules?.filter(r => r.scope === 'global')
+    if (globalRules == null || globalRules.length === 0) return results
+
+    const globalRulesDir = path.join(globalDir, RULES_SUBDIR)
+    results.push({
+      pathKind: FilePathKind.Relative,
+      path: RULES_SUBDIR,
+      basePath: globalDir,
+      getDirectoryName: () => RULES_SUBDIR,
+      getAbsolutePath: () => globalRulesDir
+    })
     return results
   }
 
@@ -140,6 +153,22 @@ export class CursorOutputPlugin extends AbstractOutputPlugin {
       }
     }
 
+    const globalRules = ctx.collectedInputContext.rules?.filter(r => r.scope === 'global')
+    if (globalRules != null && globalRules.length > 0) {
+      const globalRulesDir = path.join(globalDir, RULES_SUBDIR)
+      for (const rule of globalRules) {
+        const fileName = this.buildRuleFileName(rule)
+        const fullPath = path.join(globalRulesDir, fileName)
+        results.push({
+          pathKind: FilePathKind.Relative,
+          path: path.join(RULES_SUBDIR, fileName),
+          basePath: globalDir,
+          getDirectoryName: () => RULES_SUBDIR,
+          getAbsolutePath: () => fullPath
+        })
+      }
+    }
+
     if (skills == null || skills.length === 0) return results
 
     const skillsCursorDir = this.getSkillsCursorDir()
@@ -196,8 +225,10 @@ export class CursorOutputPlugin extends AbstractOutputPlugin {
 
   async registerProjectOutputDirs(ctx: OutputPluginContext): Promise<RelativePath[]> {
     const results: RelativePath[] = []
-    const {workspace, globalMemory} = ctx.collectedInputContext
-    if (globalMemory == null) return results
+    const {workspace, globalMemory, rules} = ctx.collectedInputContext
+    const hasProjectRules = rules?.some(r => r.scope === 'project') ?? false
+
+    if (globalMemory == null && !hasProjectRules) return results
 
     for (const project of workspace.projects) {
       const projectDir = project.dirFromWorkspacePath
@@ -209,35 +240,53 @@ export class CursorOutputPlugin extends AbstractOutputPlugin {
 
   async registerProjectOutputFiles(ctx: OutputPluginContext): Promise<RelativePath[]> {
     const results: RelativePath[] = []
-    const {workspace, globalMemory} = ctx.collectedInputContext
-    if (globalMemory == null) return results
+    const {workspace, globalMemory, rules} = ctx.collectedInputContext
+    const projectRules = rules?.filter(r => r.scope === 'project')
+    const hasProjectRules = projectRules != null && projectRules.length > 0
 
-    for (const project of workspace.projects) {
-      const projectDir = project.dirFromWorkspacePath
-      if (projectDir == null) continue
-      results.push(this.createProjectRuleFileRelativePath(projectDir, GLOBAL_RULE_FILE))
+    if (globalMemory == null && !hasProjectRules) return results
+
+    if (globalMemory != null) {
+      for (const project of workspace.projects) {
+        const projectDir = project.dirFromWorkspacePath
+        if (projectDir == null) continue
+        results.push(this.createProjectRuleFileRelativePath(projectDir, GLOBAL_RULE_FILE))
+      }
+    }
+
+    if (hasProjectRules) {
+      for (const project of workspace.projects) {
+        const projectDir = project.dirFromWorkspacePath
+        if (projectDir == null) continue
+        for (const rule of projectRules) {
+          const fileName = this.buildRuleFileName(rule)
+          results.push(this.createProjectRuleFileRelativePath(projectDir, fileName))
+        }
+      }
     }
+
     results.push(...this.registerProjectIgnoreOutputFiles(workspace.projects))
     return results
   }
 
   async canWrite(ctx: OutputWriteContext): Promise<boolean> {
-    const {workspace, skills, fastCommands, globalMemory, aiAgentIgnoreConfigFiles} = ctx.collectedInputContext
+    const {workspace, skills, fastCommands, globalMemory, rules, aiAgentIgnoreConfigFiles} = ctx.collectedInputContext
     const hasSkills = (skills?.length ?? 0) > 0
     const hasFastCommands = (fastCommands?.length ?? 0) > 0
+    const hasRules = (rules?.length ?? 0) > 0
     const hasGlobalRuleOutput
       = globalMemory != null
         && workspace.projects.some(p => p.dirFromWorkspacePath != null)
     const hasCursorIgnore = aiAgentIgnoreConfigFiles?.some(f => f.fileName === '.cursorignore') ?? false
 
-    if (hasSkills || hasFastCommands || hasGlobalRuleOutput || hasCursorIgnore) return true
+    if (hasSkills || hasFastCommands || hasGlobalRuleOutput || hasRules || hasCursorIgnore) return true
 
     this.log.trace({action: 'skip', reason: 'noOutputs'})
     return false
   }
 
   async writeGlobalOutputs(ctx: OutputWriteContext): Promise<WriteResults> {
-    const {skills, fastCommands} = ctx.collectedInputContext
+    const {skills, fastCommands, rules} = ctx.collectedInputContext
     const fileResults: WriteResult[] = []
     const dirResults: WriteResult[] = []
 
@@ -255,20 +304,30 @@ export class CursorOutputPlugin extends AbstractOutputPlugin {
       }
     }
 
-    if (fastCommands == null || fastCommands.length === 0) return {files: fileResults, dirs: dirResults}
+    if (fastCommands != null && fastCommands.length > 0) {
+      const commandsDir = this.getGlobalCommandsDir()
+      for (const cmd of fastCommands) {
+        const result = await this.writeGlobalFastCommand(ctx, commandsDir, cmd)
+        fileResults.push(result)
+      }
+    }
 
-    const commandsDir = this.getGlobalCommandsDir()
-    for (const cmd of fastCommands) {
-      const result = await this.writeGlobalFastCommand(ctx, commandsDir, cmd)
-      fileResults.push(result)
+    const globalRules = rules?.filter(r => r.scope === 'global')
+    if (globalRules != null && globalRules.length > 0) {
+      const globalRulesDir = path.join(this.getGlobalConfigDir(), RULES_SUBDIR)
+      for (const rule of globalRules) {
+        const result = await this.writeRuleMdcFile(ctx, globalRulesDir, rule, this.getGlobalConfigDir())
+        fileResults.push(result)
+      }
     }
+
     return {files: fileResults, dirs: dirResults}
   }
 
   async writeProjectOutputs(ctx: OutputWriteContext): Promise<WriteResults> {
     const fileResults: WriteResult[] = []
     const dirResults: WriteResult[] = []
-    const {workspace, globalMemory} = ctx.collectedInputContext
+    const {workspace, globalMemory, rules} = ctx.collectedInputContext
     if (globalMemory != null) {
       const content = this.buildGlobalRuleContent(globalMemory.content as string)
       for (const project of workspace.projects) {
@@ -279,6 +338,19 @@ export class CursorOutputPlugin extends AbstractOutputPlugin {
       }
     }
 
+    const projectRules = rules?.filter(r => r.scope === 'project')
+    if (projectRules != null && projectRules.length > 0) {
+      for (const project of workspace.projects) {
+        const projectDir = project.dirFromWorkspacePath
+        if (projectDir == null) continue
+        const rulesDir = path.join(projectDir.basePath, projectDir.path, GLOBAL_CONFIG_DIR, RULES_SUBDIR)
+        for (const rule of projectRules) {
+          const result = await this.writeRuleMdcFile(ctx, rulesDir, rule, projectDir.basePath)
+          fileResults.push(result)
+        }
+      }
+    }
+
     const ignoreResults = await this.writeProjectIgnoreFiles(ctx)
     fileResults.push(...ignoreResults)
 
@@ -662,4 +734,55 @@ export class CursorOutputPlugin extends AbstractOutputPlugin {
       return {path: relativePath, success: false, error: error as Error}
     }
   }
+
+  private buildRuleFileName(rule: RulePrompt): string {
+    return `${RULE_FILE_PREFIX}${rule.series}-${rule.ruleName}.mdc`
+  }
+
+  private buildRuleMdcContent(rule: RulePrompt): string {
+    const description = rule.yamlFrontMatter?.description ?? ''
+    const fmData: Record<string, unknown> = {
+      description,
+      globs: [...rule.globs],
+      alwaysApply: false
+    }
+    return buildMarkdownWithFrontMatter(fmData, rule.content)
+  }
+
+  private async writeRuleMdcFile(
+    ctx: OutputWriteContext,
+    rulesDir: string,
+    rule: RulePrompt,
+    basePath: string
+  ): Promise<WriteResult> {
+    const fileName = this.buildRuleFileName(rule)
+    const fullPath = path.join(rulesDir, fileName)
+
+    const relativePath: RelativePath = {
+      pathKind: FilePathKind.Relative,
+      path: path.join(GLOBAL_CONFIG_DIR, RULES_SUBDIR, fileName),
+      basePath,
+      getDirectoryName: () => RULES_SUBDIR,
+      getAbsolutePath: () => fullPath
+    }
+
+    const content = this.buildRuleMdcContent(rule)
+
+    if (ctx.dryRun === true) {
+      this.log.trace({action: 'dryRun', type: 'ruleFile', path: fullPath})
+      return {path: relativePath, success: true, skipped: false}
+    }
+
+    try {
+      this.ensureDirectory(rulesDir)
+      this.writeFileSync(fullPath, content)
+      this.log.trace({action: 'write', type: 'ruleFile', path: fullPath})
+      return {path: relativePath, success: true}
+    }
+    catch (error) {
+      const errMsg = error instanceof Error ? error.message : String(error)
+      this.log.error({action: 'write', type: 'ruleFile', path: fullPath, error: errMsg})
+      return {path: relativePath, success: false, error: error as Error}
+    }
+  }
 }