rulesync 0.56.0 → 0.57.0

package/README.ja.md

@@ -20,7 +20,7 @@ rulesyncは以下の**10のAI開発ツール**の**生成**と**インポート*
 - **Roo Code Rules** (`.roo/rules/*.md` + `.roo/instructions.md`)
 - **Gemini CLI** (`GEMINI.md` + `.gemini/memories/*.md`)
 - **JetBrains Junie Guidelines** (`.junie/guidelines.md`)
-- **Windsurf AIコードエディター** (`.windsurfrules` + `.windsurfignore` + `.windsurf/mcp.json`)
+- **Windsurf AIコードエディター** (`.windsurf/rules/*.md` + `.codeiumignore` + `.windsurf/mcp.json`)
 - **Kiro IDE カスタムステアリングドキュメント** (`.kiro/steering/*.md`) + **AI除外ファイル** (`.aiignore`)
 
 ## インストール
@@ -317,7 +317,7 @@ rulesyncは2レベルのルールシステムを使用します：
 | **Cline**          | 標準フォーマット   | 標準フォーマット         | すべてのルールがプレーンMarkdownフォーマットを使用                   |
 | **Roo Code**       | 標準フォーマット   | 標準フォーマット         | すべてのルールが説明ヘッダー付きのプレーンMarkdownフォーマットを使用 |
 | **Gemini CLI**     | `GEMINI.md`        | `.gemini/memories/*.md`  | GEMINI.mdがメモリファイルへの`@filename`参照を含む                   |
-| **Windsurf**       | `.windsurfrules`   | `.windsurf/rules/*.md`   | 包括的統合：MCP設定、ignoreファイル、プレーンMarkdownフォーマット    |
+| **Windsurf**       | `.windsurf/rules/*.md`   | `.windsurf/rules/*.md`   | 包括的統合：MCP設定、ignoreファイル、プレーンMarkdownフォーマット    |
 
 ### 3. 設定ファイルの生成
 
@@ -656,7 +656,7 @@ globs: ["**/*.ts", "**/*.tsx"]
 | **Roo Code**       | `.roo/rules/*.md`                                            | プレーンMarkdown              | 両レベルとも説明ヘッダー付きの同じフォーマットを使用                                                                                                                                                            |
 | **Gemini CLI**     | `GEMINI.md` (ルート)<br>`.gemini/memories/*.md` (非ルート)   | プレーンMarkdown              | ルートはGEMINI.mdに移動<br>非ルートは別メモリファイルに移動<br>GEMINI.mdは`@filename`参照を含む                                                      |
 | **JetBrains Junie** | `.junie/guidelines.md`                                      | プレーンMarkdown              | すべてのルールを単一のガイドラインファイルに統合                                                                                                                                                                |
-| **Windsurf**       | `.windsurfrules` (ルート)<br>`.windsurf/rules/*.md` (非ルート) | プレーンMarkdown           | ルートはメインルールファイルに移動<br>非ルートは別ルールファイルに移動<br>MCP設定とignoreファイルを含む包括的統合                                                                                              |
+| **Windsurf**       | `.windsurf/rules/*.md` (ルート)<br>`.windsurf/rules/*.md` (非ルート) | プレーンMarkdown           | 両レベルとも`.windsurf/rules/`ディレクトリに統合<br>MCP設定とignoreファイルを含む包括的統合                                                                                              |
 | **Kiro IDE**       | `.kiro/steering/*.md` + `.aiignore`                          | プレーンMarkdown + 除外パターン | カスタムステアリングドキュメントで両レベルとも同じフォーマット使用<br>AI除外ファイルで機密パターンを除外                                                                                                       |
 
 ## バリデーション

package/README.md

@@ -601,30 +601,46 @@ When `.rulesyncignore` exists, rulesync will:
 
 ### Frontmatter Schema
 
-Each rule file must include frontmatter with the following fields:
+Each rule file includes frontmatter with the following fields. **As of v0.56.0, all frontmatter keys are now optional with sensible default values applied automatically**:
 
 ```yaml
 ---
-root: true | false               # Required: Rule level (true for overview, false for details)
-targets: ["*"]                   # Required: Target tools (* = all, or specific tools)
-description: "Brief description" # Required: Rule description
-globs: ["**/*"]                  # Required: File patterns (array format)
+root: true | false               # Optional: Rule level (default: false)
+targets: ["*"]                   # Optional: Target tools (default: ["*"] = all tools)
+description: "Brief description" # Optional: Rule description (default: generated from filename)
+globs: ["**/*"]                  # Optional: File patterns (default: ["**/*"])
 cursorRuleType: "always"         # Optional: Cursor-specific rule type (always, manual, specificFiles, intelligently)
+windsurfActivationMode: "always" # Optional: Windsurf-specific activation mode (always, manual, model-decision, glob)
+windsurfOutputFormat: "directory" # Optional: Windsurf output format (single-file, directory)
+tags: ["security", "typescript"]  # Optional: Rule tags for categorization
 ---
 ```
 
-#### cursorRuleType Field (Optional)
-
-Additional metadata field for Cursor tool:
+#### Optional Frontmatter Fields
 
+**cursorRuleType** - Cursor-specific rule behavior:
 - **`always`**: Rules applied to the entire project constantly
 - **`manual`**: Rules applied manually (default)
 - **`specificFiles`**: Rules automatically applied to specific file patterns
 - **`intelligently`**: Rules applied by AI judgment
 
+**windsurfActivationMode** - Windsurf AI activation behavior:
+- **`always`**: Always-on rules injected in every prompt
+- **`manual`**: Only when explicitly @mentioned
+- **`model-decision`**: AI model decides when rule is relevant
+- **`glob`**: Apply only when editing files matching glob pattern
+
+**windsurfOutputFormat** - Windsurf file organization:
+- **`single-file`**: Generate `.windsurf-rules` file
+- **`directory`**: Generate `.windsurf/rules/*.md` files (default)
+
+**tags** - Rule categorization and filtering:
+- Array of strings for organizing and filtering rules
+- Useful for complex projects with many rule files
+
 ### Example Files
 
-**Root file** (`.rulesync/overview.md`):
+**Root file** (`.rulesync/overview.md`) - With explicit frontmatter:
 ```markdown
 ---
 root: true
@@ -638,12 +654,10 @@ globs: ["src/**/*.ts"]
 This project follows TypeScript-first development with clean architecture principles.
 ```
 
-**Non-root file** (`.rulesync/coding-rules.md`):
+**Non-root file** (`.rulesync/coding-rules.md`) - With minimal frontmatter (using defaults):
 ```markdown
 ---
-root: false
 targets: ["copilot", "cursor", "roo"]
-description: "TypeScript coding standards"
 globs: ["**/*.ts", "**/*.tsx"]
 ---
 
@@ -654,6 +668,20 @@ globs: ["**/*.ts", "**/*.tsx"]
 - Use meaningful variable names
 ```
 
+**Windsurf-specific rule** (`.rulesync/windsurf-ui-rules.md`):
+```markdown
+---
+windsurfActivationMode: "glob"
+windsurfOutputFormat: "directory"
+globs: ["**/*.tsx", "**/*.jsx"]
+tags: ["ui", "react"]
+---
+
+# React UI Component Rules
+
+Specific rules for React components that activate only when editing UI files.
+```
+
 ## Generated Configuration Files
 
 | Tool | Output Path | Format | Rule Level Handling |

package/dist/index.cjs

@@ -873,10 +873,10 @@ var RulesyncMcpConfigSchema = import_mini5.z.object({
 var import_mini6 = require("zod/mini");
 init_tool_targets();
 var RuleFrontmatterSchema = import_mini6.z.object({
-  root: import_mini6.z.boolean(),
-  targets: RulesyncTargetsSchema,
-  description: import_mini6.z.string(),
-  globs: import_mini6.z.array(import_mini6.z.string()),
+  root: import_mini6.z.optional(import_mini6.z.boolean()),
+  targets: import_mini6.z.optional(RulesyncTargetsSchema),
+  description: import_mini6.z.optional(import_mini6.z.string()),
+  globs: import_mini6.z.optional(import_mini6.z.array(import_mini6.z.string())),
   cursorRuleType: import_mini6.z.optional(import_mini6.z.enum(["always", "manual", "specificFiles", "intelligently"])),
   windsurfActivationMode: import_mini6.z.optional(import_mini6.z.enum(["always", "manual", "model-decision", "glob"])),
   windsurfOutputFormat: import_mini6.z.optional(import_mini6.z.enum(["single-file", "directory"])),
@@ -2942,7 +2942,23 @@ async function parseRuleFile(filepath) {
   const content = await readFileContent(filepath);
   const parsed = (0, import_gray_matter.default)(content);
   try {
-    const frontmatter = RuleFrontmatterSchema.parse(parsed.data);
+    const validatedData = RuleFrontmatterSchema.parse(parsed.data);
+    const frontmatter = {
+      root: validatedData.root ?? false,
+      targets: validatedData.targets ?? ["*"],
+      description: validatedData.description ?? "",
+      globs: validatedData.globs ?? [],
+      ...validatedData.cursorRuleType !== void 0 && {
+        cursorRuleType: validatedData.cursorRuleType
+      },
+      ...validatedData.windsurfActivationMode !== void 0 && {
+        windsurfActivationMode: validatedData.windsurfActivationMode
+      },
+      ...validatedData.windsurfOutputFormat !== void 0 && {
+        windsurfOutputFormat: validatedData.windsurfOutputFormat
+      },
+      ...validatedData.tags !== void 0 && { tags: validatedData.tags }
+    };
     const filename = (0, import_node_path9.basename)(filepath, ".md");
     return {
       frontmatter,
@@ -4603,7 +4619,7 @@ async function watchCommand() {
 
 // src/cli/index.ts
 var program = new import_commander.Command();
-program.name("rulesync").description("Unified AI rules management CLI tool").version("0.56.0");
+program.name("rulesync").description("Unified AI rules management CLI tool").version("0.57.0");
 program.command("init").description("Initialize rulesync in current directory").action(initCommand);
 program.command("add <filename>").description("Add a new rule file").action(addCommand);
 program.command("gitignore").description("Add generated files to .gitignore").action(gitignoreCommand);

package/dist/index.js

@@ -227,10 +227,10 @@ var RulesyncMcpConfigSchema = z4.object({
 // src/types/rules.ts
 import { z as z5 } from "zod/mini";
 var RuleFrontmatterSchema = z5.object({
-  root: z5.boolean(),
-  targets: RulesyncTargetsSchema,
-  description: z5.string(),
-  globs: z5.array(z5.string()),
+  root: z5.optional(z5.boolean()),
+  targets: z5.optional(RulesyncTargetsSchema),
+  description: z5.optional(z5.string()),
+  globs: z5.optional(z5.array(z5.string())),
   cursorRuleType: z5.optional(z5.enum(["always", "manual", "specificFiles", "intelligently"])),
   windsurfActivationMode: z5.optional(z5.enum(["always", "manual", "model-decision", "glob"])),
   windsurfOutputFormat: z5.optional(z5.enum(["single-file", "directory"])),
@@ -2293,7 +2293,23 @@ async function parseRuleFile(filepath) {
   const content = await readFileContent(filepath);
   const parsed = matter(content);
   try {
-    const frontmatter = RuleFrontmatterSchema.parse(parsed.data);
+    const validatedData = RuleFrontmatterSchema.parse(parsed.data);
+    const frontmatter = {
+      root: validatedData.root ?? false,
+      targets: validatedData.targets ?? ["*"],
+      description: validatedData.description ?? "",
+      globs: validatedData.globs ?? [],
+      ...validatedData.cursorRuleType !== void 0 && {
+        cursorRuleType: validatedData.cursorRuleType
+      },
+      ...validatedData.windsurfActivationMode !== void 0 && {
+        windsurfActivationMode: validatedData.windsurfActivationMode
+      },
+      ...validatedData.windsurfOutputFormat !== void 0 && {
+        windsurfOutputFormat: validatedData.windsurfOutputFormat
+      },
+      ...validatedData.tags !== void 0 && { tags: validatedData.tags }
+    };
     const filename = basename(filepath, ".md");
     return {
       frontmatter,
@@ -3941,7 +3957,7 @@ async function watchCommand() {
 
 // src/cli/index.ts
 var program = new Command();
-program.name("rulesync").description("Unified AI rules management CLI tool").version("0.56.0");
+program.name("rulesync").description("Unified AI rules management CLI tool").version("0.57.0");
 program.command("init").description("Initialize rulesync in current directory").action(initCommand);
 program.command("add <filename>").description("Add a new rule file").action(addCommand);
 program.command("gitignore").description("Add generated files to .gitignore").action(gitignoreCommand);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rulesync",
-  "version": "0.56.0",
+  "version": "0.57.0",
   "description": "Unified AI rules management CLI tool that generates configuration files for various AI development tools",
   "keywords": [
     "ai",