Merge pull request #28 from TrueNine/dev

Dev

Author: TrueNine

cli/package.json

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

cli/public/tnmsc.example.json

@@ -1,5 +1,5 @@
 {
-  "version": "2026.10219.12050",
+  "version": "2026.10219.12358",
   "workspaceDir": "~/project",
   "shadowSourceProject": {
     "name": "tnmsc-shadow",

cli/src/plugins/ClaudeCodeCLIOutputPlugin.ts

@@ -10,6 +10,15 @@ const GLOBAL_CONFIG_DIR = '.claude'
 const RULES_SUBDIR = 'rules'
 const RULE_FILE_PREFIX = 'rule-'
 
+/**
+ * Output plugin for Claude Code CLI.
+ *
+ * Outputs rules to `.claude/rules/` directory with frontmatter format.
+ *
+ * @see https://github.com/anthropics/claude-code/issues/26868
+ * Known bug: Claude Code CLI has issues with `.claude/rules` directory handling.
+ * This may affect rule loading behavior in certain scenarios.
+ */
 export class ClaudeCodeCLIOutputPlugin extends BaseCLIOutputPlugin {
   constructor() {
     super('ClaudeCodeCLIOutputPlugin', {

cli/src/plugins/WindsurfOutputPlugin.test.ts

@@ -3,6 +3,7 @@ import type {
   GlobalMemoryPrompt,
   OutputPluginContext,
   OutputWriteContext,
+  RulePrompt,
   SkillPrompt
 } from '@/types'
 import type {RelativePath} from '@/types/FileSystemTypes'
@@ -11,7 +12,7 @@ import * as os from 'node:os'
 import * as path from 'node:path'
 import {afterEach, beforeEach, describe, expect, it} from 'vitest'
 import {createLogger} from '@/log'
-import {FilePathKind, PromptKind} from '@/types'
+import {FilePathKind, NamingCaseKind, PromptKind} from '@/types'
 import {WindsurfOutputPlugin} from './WindsurfOutputPlugin'
 
 function createMockRelativePath(pathStr: string, basePath: string): RelativePath {
@@ -24,14 +25,46 @@ function createMockRelativePath(pathStr: string, basePath: string): RelativePath
   }
 }
 
+function createMockRulePrompt(
+  series: string,
+  ruleName: string,
+  globs: readonly string[],
+  scope: 'global' | 'project',
+  seriName?: string
+): RulePrompt {
+  const content = '# Rule body\n\nFollow this rule.'
+  return {
+    type: PromptKind.Rule,
+    content,
+    length: content.length,
+    filePathKind: FilePathKind.Relative,
+    dir: createMockRelativePath('.', ''),
+    markdownContents: [],
+    yamlFrontMatter: {
+      description: 'Rule description',
+      globs,
+      namingCase: NamingCaseKind.KebabCase
+    },
+    series,
+    ruleName,
+    globs,
+    scope,
+    ...seriName != null && {seriName}
+  } as RulePrompt
+}
+
 function createMockGlobalMemoryPrompt(content: string, basePath: string): GlobalMemoryPrompt {
   return {
     type: PromptKind.GlobalMemory,
     content,
     length: content.length,
     filePathKind: FilePathKind.Relative,
     dir: createMockRelativePath('.', basePath),
-    markdownContents: []
+    markdownContents: [],
+    parentDirectoryPath: {
+      type: 'UserHome',
+      directory: createMockRelativePath('.codeium/windsurf', basePath)
+    }
   } as GlobalMemoryPrompt
 }
 
@@ -48,7 +81,7 @@ function createMockFastCommandPrompt(
     filePathKind: FilePathKind.Relative,
     dir: createMockRelativePath('.', basePath),
     markdownContents: [],
-    yamlFrontMatter: {description: 'Fast command'},
+    yamlFrontMatter: {description: 'Fast command', namingCase: NamingCaseKind.KebabCase},
     ...series != null && {series},
     commandName
   } as FastCommandPrompt
@@ -61,15 +94,15 @@ function createMockSkillPrompt(
   options?: {childDocs?: {relativePath: string, content: unknown}[], resources?: {relativePath: string, content: string, encoding: 'text' | 'base64'}[]}
 ): SkillPrompt {
   return {
-    yamlFrontMatter: {name, description: 'A skill'},
+    yamlFrontMatter: {name, description: 'A skill', namingCase: NamingCaseKind.KebabCase},
     dir: createMockRelativePath(name, basePath),
     content,
     length: content.length,
     type: PromptKind.Skill,
     filePathKind: FilePathKind.Relative,
     markdownContents: [],
     ...options
-  } as SkillPrompt
+  } as unknown as SkillPrompt
 }
 
 class TestableWindsurfOutputPlugin extends WindsurfOutputPlugin {
@@ -134,8 +167,8 @@ describe('windsurf output plugin', () => {
 
       const results = await plugin.registerGlobalOutputDirs(ctx)
       expect(results).toHaveLength(1)
-      expect(results[0].path).toBe('global_workflows')
-      expect(results[0].getAbsolutePath()).toBe(path.join(tempDir, '.codeium', 'windsurf', 'global_workflows'))
+      expect(results[0]?.path).toBe('global_workflows')
+      expect(results[0]?.getAbsolutePath()).toBe(path.join(tempDir, '.codeium', 'windsurf', 'global_workflows'))
     })
 
     it('should register skills/<skillName> dir when skills exist', async () => {
@@ -148,8 +181,8 @@ describe('windsurf output plugin', () => {
 
       const results = await plugin.registerGlobalOutputDirs(ctx)
       expect(results).toHaveLength(1)
-      expect(results[0].path).toBe(path.join('skills', 'custom-skill'))
-      expect(results[0].getAbsolutePath()).toBe(path.join(tempDir, '.codeium', 'windsurf', 'skills', 'custom-skill'))
+      expect(results[0]?.path).toBe(path.join('skills', 'custom-skill'))
+      expect(results[0]?.getAbsolutePath()).toBe(path.join(tempDir, '.codeium', 'windsurf', 'skills', 'custom-skill'))
     })
 
     it('should register both workflows and skills dirs when both exist', async () => {
@@ -320,7 +353,7 @@ describe('windsurf output plugin', () => {
 
       const results = await plugin.writeGlobalOutputs(ctx)
       expect(results.files.length).toBeGreaterThanOrEqual(1)
-      expect(results.files[0].success).toBe(true)
+      expect(results.files[0]?.success).toBe(true)
 
       const memoryPath = path.join(tempDir, '.codeium', 'windsurf', 'memories', 'global_rules.md')
       expect(fs.existsSync(memoryPath)).toBe(true)
@@ -442,15 +475,42 @@ describe('windsurf output plugin', () => {
 
       const results = await plugin.writeGlobalOutputs(ctx)
       expect(results.files.length).toBeGreaterThanOrEqual(1)
-      expect(results.files[0].success).toBe(true)
+      expect(results.files[0]?.success).toBe(true)
 
       const memoryPath = path.join(tempDir, '.codeium', 'windsurf', 'memories', 'global_rules.md')
       expect(fs.existsSync(memoryPath)).toBe(false)
     })
+
+    it('should write global rule files with trigger/globs frontmatter', async () => {
+      const ctx = {
+        collectedInputContext: {
+          workspace: {projects: [], directory: createMockRelativePath('.', tempDir)},
+          skills: [],
+          fastCommands: [],
+          rules: [
+            createMockRulePrompt('test', 'glob', ['src/**/*.ts', '**/*.tsx'], 'global')
+          ]
+        },
+        logger: createLogger('test', 'debug'),
+        dryRun: false
+      } as unknown as OutputWriteContext
+
+      const results = await plugin.writeGlobalOutputs(ctx)
+      expect(results.files).toHaveLength(1)
+
+      const rulePath = path.join(tempDir, '.codeium', 'windsurf', 'memories', 'rule-test-glob.md')
+      expect(fs.existsSync(rulePath)).toBe(true)
+
+      const content = fs.readFileSync(rulePath, 'utf8')
+      expect(content).toContain('trigger: glob')
+      expect(content).toContain('globs: src/**/*.ts, **/*.tsx')
+      expect(content).not.toContain('globs: "src/**/*.ts, **/*.tsx"')
+      expect(content).toContain('Follow this rule.')
+    })
   })
 
   describe('writeProjectOutputs', () => {
-    it('should return empty results (no project outputs)', async () => {
+    it('should return empty results when no project rules', async () => {
       const ctx = {
         collectedInputContext: {
           workspace: {projects: [], directory: createMockRelativePath('.', tempDir)},
@@ -464,6 +524,45 @@ describe('windsurf output plugin', () => {
       expect(results.files).toHaveLength(0)
       expect(results.dirs).toHaveLength(0)
     })
+
+    it('should write project rules and apply seriName include filter from projectConfig', async () => {
+      const ctx = {
+        collectedInputContext: {
+          workspace: {
+            projects: [
+              {
+                name: 'proj1',
+                dirFromWorkspacePath: createMockRelativePath('proj1', tempDir),
+                projectConfig: {rules: {include: ['uniapp']}}
+              }
+            ],
+            directory: createMockRelativePath('.', tempDir)
+          },
+          rules: [
+            createMockRulePrompt('test', 'uniapp-only', ['src/**/*.vue'], 'project', 'uniapp'),
+            createMockRulePrompt('test', 'vue-only', ['src/**/*.ts'], 'project', 'vue')
+          ]
+        },
+        logger: createLogger('test', 'debug'),
+        dryRun: false
+      } as unknown as OutputWriteContext
+
+      const results = await plugin.writeProjectOutputs(ctx)
+      const outputPaths = results.files.map(file => file.path.path.replaceAll('\\', '/'))
+
+      expect(outputPaths.some(p => p.endsWith('rule-test-uniapp-only.md'))).toBe(true)
+      expect(outputPaths.some(p => p.endsWith('rule-test-vue-only.md'))).toBe(false)
+
+      const includedRulePath = path.join(tempDir, 'proj1', '.windsurf', 'rules', 'rule-test-uniapp-only.md')
+      const excludedRulePath = path.join(tempDir, 'proj1', '.windsurf', 'rules', 'rule-test-vue-only.md')
+
+      expect(fs.existsSync(includedRulePath)).toBe(true)
+      expect(fs.existsSync(excludedRulePath)).toBe(false)
+
+      const includedRuleContent = fs.readFileSync(includedRulePath, 'utf8')
+      expect(includedRuleContent).toContain('trigger: glob')
+      expect(includedRuleContent).toContain('globs: src/**/*.vue')
+    })
   })
 
   describe('clean support', () => {

cli/src/plugins/WindsurfOutputPlugin.ts

@@ -70,7 +70,7 @@ export class WindsurfOutputPlugin extends AbstractOutputPlugin {
       }
     }
 
-    const globalRules = rules?.filter(r => r.scope === 'global')
+    const globalRules = rules?.filter(r => this.normalizeRuleScope(r) === 'global')
     if (globalRules == null || globalRules.length === 0) return results
 
     const codeiumDir = this.getCodeiumWindsurfDir()
@@ -105,7 +105,7 @@ export class WindsurfOutputPlugin extends AbstractOutputPlugin {
       }
     }
 
-    const globalRules = ctx.collectedInputContext.rules?.filter(r => r.scope === 'global')
+    const globalRules = ctx.collectedInputContext.rules?.filter(r => this.normalizeRuleScope(r) === 'global')
     if (globalRules != null && globalRules.length > 0) {
       const codeiumDir = this.getCodeiumWindsurfDir()
       const memoriesDir = path.join(codeiumDir, MEMORIES_SUBDIR)
@@ -205,7 +205,7 @@ export class WindsurfOutputPlugin extends AbstractOutputPlugin {
       }
     }
 
-    const globalRules = rules?.filter(r => r.scope === 'global')
+    const globalRules = rules?.filter(r => this.normalizeRuleScope(r) === 'global')
     if (globalRules == null || globalRules.length === 0) return {files: fileResults, dirs: dirResults}
 
     const memoriesDir = this.getGlobalMemoriesDir()
@@ -227,7 +227,7 @@ export class WindsurfOutputPlugin extends AbstractOutputPlugin {
       if (projectDir == null) continue
       const projectRules = applySubSeriesGlobPrefix(
         filterRulesByProjectConfig(
-          rules.filter(r => r.scope === 'project'),
+          rules.filter(r => this.normalizeRuleScope(r) === 'project'),
           project.projectConfig
         ),
         project.projectConfig
@@ -255,7 +255,7 @@ export class WindsurfOutputPlugin extends AbstractOutputPlugin {
         if (projectDir == null) continue
         const projectRules = applySubSeriesGlobPrefix(
           filterRulesByProjectConfig(
-            rules.filter(r => r.scope === 'project'),
+            rules.filter(r => this.normalizeRuleScope(r) === 'project'),
             project.projectConfig
           ),
           project.projectConfig
@@ -288,7 +288,7 @@ export class WindsurfOutputPlugin extends AbstractOutputPlugin {
         if (projectDir == null) continue
         const projectRules = applySubSeriesGlobPrefix(
           filterRulesByProjectConfig(
-            rules.filter(r => r.scope === 'project'),
+            rules.filter(r => this.normalizeRuleScope(r) === 'project'),
             project.projectConfig
           ),
           project.projectConfig
@@ -548,14 +548,25 @@ export class WindsurfOutputPlugin extends AbstractOutputPlugin {
   }
 
   private buildRuleContent(rule: RulePrompt): string {
-    const description = rule.yamlFrontMatter?.description ?? ''
-    const patterns = rule.globs.join(', ')
-    const comment = [
-      `<!-- Activation: Glob | Patterns: ${patterns} -->`,
-      `<!-- Description: ${description} -->`,
-      '<!-- Configure activation mode in Windsurf UI: Customizations > Rules -->'
-    ].join('\n')
-    return `${comment}\n\n${rule.content}`
+    const fmData: Record<string, unknown> = {
+      trigger: 'glob',
+      globs: rule.globs.length > 0 ? rule.globs.join(', ') : ''
+    }
+
+    const raw = buildMarkdownWithFrontMatter(fmData, rule.content)
+    const lines = raw.split('\n')
+    const transformedLines = lines.map(line => {
+      const match = /^(\s*globs:\s*)(['"])(.*)\2\s*$/.exec(line)
+      if (match == null) return line
+
+      const prefix = match[1] ?? 'globs: '
+      const value = match[3] ?? ''
+      if (value.trim().length === 0) return line
+
+      return `${prefix}${value}`
+    })
+
+    return transformedLines.join('\n')
   }
 
   private async writeRuleFile(

cli/src/utils/ruleFilter.property.test.ts

@@ -196,7 +196,7 @@ describe('applySubSeriesGlobPrefix property tests', () => {
     )
   })
 
-  it('should produce same number or more globs when matched', async () => {
+  it('should produce at least one glob per unique subdir when matched', async () => {
     await fc.assert(
       fc.asyncProperty(
         seriNameGen,
@@ -208,7 +208,8 @@ describe('applySubSeriesGlobPrefix property tests', () => {
           for (const subdir of subdirs) subSeries[subdir] = [seriName]
           const projectConfig: ProjectConfig = {rules: {subSeries}}
           const result = applySubSeriesGlobPrefix(rules, projectConfig)
-          expect(result[0].globs.length).toBeGreaterThanOrEqual(globs.length)
+          const uniqueSubdirs = new Set(subdirs).size
+          expect(result[0].globs.length).toBeGreaterThanOrEqual(uniqueSubdirs)
         }
       ),
       {numRuns: 100}

doc/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@truenine/memory-sync-docs",
   "private": true,
-  "version": "2026.10219.12050",
+  "version": "2026.10219.12358",
   "description": "Documentation site for @truenine/memory-sync, built with Next.js 16 and MDX.",
   "scripts": {
     "dev": "next dev",

gui/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@truenine/memory-sync-gui",
-  "version": "2026.10219.12050",
+  "version": "2026.10219.12358",
   "private": true,
   "engines": {
     "node": ">=25.2.1",

gui/src-tauri/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "memory-sync-gui"
-version = "2026.10219.12050"
+version = "2026.10219.12358"
 description = "Memory Sync desktop GUI application"
 authors = ["TrueNine"]
 edition = "2021"

gui/src-tauri/tauri.conf.json

@@ -1,6 +1,6 @@
 {
   "$schema": "https://schema.tauri.app/config/2",
-  "version": "2026.10219.12050",
+  "version": "2026.10219.12358",
   "productName": "Memory Sync",
   "identifier": "org.truenine.memory-sync",
   "build": {