rulesync 0.54.0 → 0.56.0

package/README.ja.md

@@ -9,7 +9,7 @@
 
 ## 対応ツール
 
-rulesyncは以下のAI開発ツールの**生成**と**インポート**の両方をサポートしています：
+rulesyncは以下の**10のAI開発ツール**の**生成**と**インポート**の両方をサポートしています：
 
 - **GitHub Copilot Custom Instructions** (`.github/copilot-instructions.md` + `.github/instructions/*.instructions.md`)
 - **Cursor Project Rules** (`.cursor/rules/*.mdc` + `.cursorrules`) 
@@ -20,6 +20,7 @@ rulesyncは以下の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`)
 - **Kiro IDE カスタムステアリングドキュメント** (`.kiro/steering/*.md`) + **AI除外ファイル** (`.aiignore`)
 
 ## インストール
@@ -74,6 +75,7 @@ yarn global add rulesync
    npx rulesync import --roo                # .roo/instructions.mdから
    npx rulesync import --geminicli   # GEMINI.mdと.gemini/memories/*.mdから
    npx rulesync import --junie       # .junie/guidelines.mdから
+   npx rulesync import --windsurf    # .windsurfrules と .windsurf/rules/*.mdから
    ```
 
 2. **`.rulesync/`ディレクトリのインポートされたルールを確認・編集**
@@ -102,9 +104,10 @@ AI開発ツールは新しいツールが頻繁に登場し、急速に進化し
 - OpenAI Codex CLI：GPT-4を活用した開発
 - Gemini CLI：知的コード解析
 - JetBrains Junie：自律的AIコーディング
+- Windsurf：高度なAIコードエディティング
 
 ### 🔓 **ベンダーロックインなし**
-ベンダーロックインを完全に回避できます。rulesyncの使用を停止することを決定した場合でも、生成されたルールファイル（`.github/instructions/`、`.cursor/rules/`、`.clinerules/`、`CLAUDE.md`、`codex.md`、`GEMINI.md`、`.junie/guidelines.md`など）をそのまま使い続けることができます。
+ベンダーロックインを完全に回避できます。rulesyncの使用を停止することを決定した場合でも、生成されたルールファイル（`.github/instructions/`、`.cursor/rules/`、`.clinerules/`、`CLAUDE.md`、`codex.md`、`GEMINI.md`、`.junie/guidelines.md`、`.windsurfrules`など）をそのまま使い続けることができます。
 
 ### 🎯 **ツール間の一貫性**
 すべてのAIツールに一貫したルールを適用し、チーム全体のコード品質と開発体験を向上させます。
@@ -191,6 +194,59 @@ npx rulesync generate --codexcli --base-dir ./packages/frontend
 - `.codex/mcp-config.json` MCPラッパーサーバー統合用
 - `.codexignore` プライバシー制御強化用（`.rulesyncignore`が存在する場合）
 
+## Windsurf AI統合
+
+### 包括的なWindsurf対応
+
+rulesyncは**Windsurf AIコードエディター**の完全統合を提供し、ルール/メモリー管理、Model Context Protocol (MCP)サーバー、AIファイル除外の3つの主要領域をサポートしています。
+
+**主要機能**：
+- **統一ルールシステム**: プロジェクト固有のAIルールと開発ガイドライン
+- **MCP統合**: Model Context Protocolサーバー設定で外部ツールとの拡張可能性
+- **プライバシー制御**: 機密ファイルをAIアクセスから除外するスマートな除外システム
+- **プロジェクトレベル設定**: チーム全体で一貫したAI支援開発体験
+
+### 生成されるファイル構造
+
+rulesyncはWindsurf用に以下のファイルを生成します：
+
+- **`.windsurfrules`**: メインのプロジェクトルール（ルートルールから生成）
+- **`.windsurf/rules/<filename>.md`**: 追加のルールファイル（非ルートルールから生成）
+- **`.windsurf/mcp.json`**: Model Context Protocol サーバー設定
+- **`.windsurfignore`**: AIアクセス除外ファイル（`.rulesyncignore`から生成）
+
+### Windsurf設定の生成
+
+Windsurf設定ファイルを生成する：
+
+```bash
+# Windsurf専用で生成
+npx rulesync generate --windsurf
+
+# MCPサーバー設定の詳細出力付きで生成
+npx rulesync generate --windsurf --verbose
+
+# 特定のディレクトリに生成（monorepoに便利）
+npx rulesync generate --windsurf --base-dir ./packages/frontend
+```
+
+これにより以下が作成されます：
+- `.windsurfrules` プロジェクトレベルのルール
+- `.windsurf/rules/` ディレクトリの詳細ルールファイル
+- `.windsurf/mcp.json` Model Context Protocolサーバー統合用
+- `.windsurfignore` プライバシー保護用（`.rulesyncignore`が存在する場合）
+
+### アーキテクチャ改善
+
+Windsurfサポートの実装により、rulesyncのアーキテクチャは大幅に改善されました：
+
+- **レジストリパターン**: すべてのルールジェネレーターを統一されたレジストリシステムで管理
+- **共有ファクトリー**: ジェネレーター間でコードの重複を削減
+- **関心事の分離**: より良い保守性とテストのためのモジュラー設計
+- **包括的なテスト**: 新機能の広範なテストカバレッジ
+
+これらの改善により、すべてのAI開発ツールにおいて、より一貫性があり信頼性の高い設定生成が可能になりました。
+
 ## Claude Code統合
 
 ### カスタムスラッシュコマンドの作成
@@ -261,6 +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フォーマット    |
 
 ### 3. 設定ファイルの生成
 
@@ -278,13 +335,14 @@ npx rulesync generate --augmentcode
 npx rulesync generate --roo
 npx rulesync generate --geminicli
 npx rulesync generate --junie
+npx rulesync generate --windsurf
 npx rulesync generate --kiro
 
 # クリーンビルド（既存ファイルを最初に削除）
 npx rulesync generate --delete
 
 # 特定ツール用のクリーンビルド
-npx rulesync generate --copilot --cursor --codexcli --delete
+npx rulesync generate --copilot --cursor --codexcli --windsurf --delete
 
 # 詳細出力
 npx rulesync generate --verbose
@@ -300,7 +358,7 @@ npx rulesync generate --base-dir ./apps/web,./apps/api,./packages/shared
 
 - `--delete`: 新しいファイルを作成する前に既存の生成済みファイルをすべて削除
 - `--verbose`: 生成プロセス中に詳細出力を表示
-- `--copilot`, `--cursor`, `--cline`, `--claudecode`, `--codexcli`, `--augmentcode`, `--roo`, `--geminicli`, `--junie`, `--kiro`: 指定されたツールのみ生成
+- `--copilot`, `--cursor`, `--cline`, `--claudecode`, `--codexcli`, `--augmentcode`, `--roo`, `--geminicli`, `--junie`, `--windsurf`, `--kiro`: 指定されたツールのみ生成
 - `--base-dir <paths>`: 指定されたベースディレクトリに設定ファイルを生成（複数パスの場合はカンマ区切り）。異なるプロジェクトディレクトリにツール固有の設定を生成したいmonorepoセットアップに便利。
 - `--config <path>`: 特定の設定ファイルを使用
 - `--no-config`: 設定ファイルの読み込みを無効化
@@ -319,6 +377,7 @@ npx rulesync import --augmentcode # .augment/rules/*.mdからインポート
 npx rulesync import --roo        # .roo/instructions.mdからインポート
 npx rulesync import --geminicli  # GEMINI.mdと.gemini/memories/*.mdからインポート
 npx rulesync import --junie      # .junie/guidelines.mdからインポート
+npx rulesync import --windsurf   # .windsurfrules と .windsurf/rules/*.mdからインポート
 
 # 各ツールを個別にインポート
 npx rulesync import --claudecode
@@ -524,6 +583,7 @@ draft-*.md
    - Cline用の`.clineignore`
    - Roo Code用の`.rooignore`
    - GitHub Copilot用の`.copilotignore`（コミュニティツール用）
+   - Windsurf用の`.windsurfignore`
    - Gemini CLI用の`.aiexclude`
    - Kiro IDE用の`.aiignore`
    - Claude Code用に`.claude/settings.json`のpermissions.denyに`Read()`ルールを追加
@@ -596,6 +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ファイルを含む包括的統合                                                                                              |
 | **Kiro IDE**       | `.kiro/steering/*.md` + `.aiignore`                          | プレーンMarkdown + 除外パターン | カスタムステアリングドキュメントで両レベルとも同じフォーマット使用<br>AI除外ファイルで機密パターンを除外                                                                                                       |
 
 ## バリデーション
@@ -625,6 +686,7 @@ rulesyncは、対応するAIツール用のMCPサーバー設定も管理でき
 - **OpenAI Codex CLI** (`.codex/mcp-config.json`)
 - **Gemini CLI** (`.gemini/settings.json`)
 - **JetBrains Junie** (`.junie/mcp.json`)
+- **Windsurf** (`.windsurf/mcp.json`)
 - **Kiro IDE** (`.kiro/mcp.json`)
 - **Roo Code** (`.roo/mcp.json`)
 
@@ -696,7 +758,7 @@ MCP設定はルールファイルと一緒に生成されます：
 npx rulesync generate
 
 # 特定のツールのみ生成
-npx rulesync generate --claudecode --cursor --codexcli --junie --kiro
+npx rulesync generate --claudecode --cursor --codexcli --windsurf --junie --kiro
 
 # 特定のディレクトリに生成（monorepo）
 npx rulesync generate --base-dir ./packages/frontend

package/README.md

@@ -21,6 +21,7 @@ rulesync supports both **generation** and **import** for the following AI develo
 - **Gemini CLI** (`GEMINI.md` + `.gemini/memories/*.md`)
 - **JetBrains Junie Guidelines** (`.junie/guidelines.md`)
 - **Kiro IDE Custom Steering Documents** (`.kiro/steering/*.md`) + **AI Ignore Files** (`.aiignore`)
+- **Windsurf AI Code Editor** (`.windsurf/rules/*.md` + `.windsurf/mcp.json` + `.codeiumignore`)
 
 ## Installation
 
@@ -74,6 +75,7 @@ If you already have AI tool configurations, you can import them into rulesync fo
    npx rulesync import --roo                # From .roo/instructions.md
    npx rulesync import --geminicli   # From GEMINI.md and .gemini/memories/*.md
    npx rulesync import --junie       # From .junie/guidelines.md
+   npx rulesync import --windsurf    # From .windsurf/rules/*.md
    ```
 
 2. **Review and edit** the imported rules in `.rulesync/` directory
@@ -102,9 +104,10 @@ Enable hybrid development workflows combining multiple AI tools:
 - OpenAI Codex CLI for GPT-4 powered development
 - Gemini CLI for intelligent code analysis
 - JetBrains Junie for autonomous AI coding
+- Windsurf for comprehensive AI-assisted editing with Cascade AI
 
 ### 🔓 **No Vendor Lock-in**
-Avoid vendor lock-in completely. If you decide to stop using rulesync, you can continue using the generated rule files (`.github/instructions/`, `.cursor/rules/`, `.clinerules/`, `CLAUDE.md`, `codex.md`, `GEMINI.md`, `.junie/guidelines.md`, etc.) as-is.
+Avoid vendor lock-in completely. If you decide to stop using rulesync, you can continue using the generated rule files (`.github/instructions/`, `.cursor/rules/`, `.clinerules/`, `CLAUDE.md`, `codex.md`, `GEMINI.md`, `.junie/guidelines.md`, `.windsurf/rules/`, etc.) as-is.
 
 ### 🎯 **Consistency Across Tools**
 Apply consistent rules across all AI tools, improving code quality and development experience for the entire team.
@@ -191,6 +194,69 @@ This will create:
 - `.codex/mcp-config.json` for MCP wrapper server integration
 - `.codexignore` for enhanced privacy control (if `.rulesyncignore` exists)
 
+## Windsurf AI Code Editor Integration
+
+### Comprehensive AI-Assisted Development
+
+rulesync provides full integration with **Windsurf AI Code Editor**, supporting its complete ecosystem of features including rules/memories, MCP servers, and ignore file patterns.
+
+**Key Features**:
+- **Unified Rule System**: Supports both workspace rules and global rules with automatic memory integration
+- **Cascade AI Enhancement**: Provides persistent context to Windsurf's Cascade AI for better code understanding
+- **MCP Integration**: Model Context Protocol support for extended functionality through external services
+- **Privacy Controls**: Advanced ignore file generation for sensitive data protection
+
+### File Structure
+
+rulesync generates the following files for Windsurf:
+
+- **`.windsurf/rules/*.md`**: Project-specific rules (generated from both root and detail rules)
+- **`.windsurf/mcp.json`**: MCP server configuration for external tool integration  
+- **`.codeiumignore`**: Ignore file for excluding sensitive files from Cascade AI analysis
+
+### Rule Integration Options
+
+Windsurf supports multiple rule placement strategies:
+
+#### Directory Variant (Recommended)
+- **Location**: `.windsurf/rules/` directory
+- **Files**: Multiple Markdown files for organized rule categorization
+- **Benefits**: Better organization, team collaboration, version control friendly
+
+#### Single-File Alternative  
+- **Location**: `.windsurf-rules` file at project root
+- **Format**: Single Markdown file with all rules
+- **Use Case**: Simple projects or minimal rule sets
+
+### Cascade AI Memory System
+
+Windsurf's Cascade AI automatically integrates with both:
+- **Workspace Rules**: Project-specific guidelines in `.windsurf/rules/`
+- **Auto-generated Memories**: Context learned from development patterns
+- **Global Rules**: User-wide preferences (not managed by rulesync)
+
+The combination provides comprehensive context for AI-assisted development.
+
+### Example Usage
+
+Generate Windsurf configuration files:
+
+```bash
+# Generate only for Windsurf
+npx rulesync generate --windsurf
+
+# Generate with verbose output
+npx rulesync generate --windsurf --verbose
+
+# Generate in specific directory (useful for monorepos)
+npx rulesync generate --windsurf --base-dir ./packages/frontend
+```
+
+This will create:
+- `.windsurf/rules/*.md` with your project rules organized by category
+- `.windsurf/mcp.json` for MCP server integration
+- `.codeiumignore` for enhanced privacy control (if `.rulesyncignore` exists)
+
 ## Claude Code Integration
 
 ### Creating Custom Slash Commands
@@ -279,12 +345,13 @@ npx rulesync generate --roo
 npx rulesync generate --geminicli
 npx rulesync generate --junie
 npx rulesync generate --kiro
+npx rulesync generate --windsurf
 
 # Clean build (delete existing files first)
 npx rulesync generate --delete
 
 # Clean build for specific tools
-npx rulesync generate --copilot --cursor --codexcli --delete
+npx rulesync generate --copilot --cursor --codexcli --windsurf --delete
 
 # Verbose output
 npx rulesync generate --verbose
@@ -300,7 +367,7 @@ npx rulesync generate --base-dir ./apps/web,./apps/api,./packages/shared
 
 - `--delete`: Remove all existing generated files before creating new ones
 - `--verbose`: Show detailed output during generation process
-- `--copilot`, `--cursor`, `--cline`, `--claudecode`, `--codexcli`, `--augmentcode`, `--roo`, `--geminicli`, `--junie`, `--kiro`: Generate only for specified tools
+- `--copilot`, `--cursor`, `--cline`, `--claudecode`, `--codexcli`, `--augmentcode`, `--roo`, `--geminicli`, `--junie`, `--kiro`, `--windsurf`: Generate only for specified tools
 - `--base-dir <paths>`: Generate configuration files in specified base directories (comma-separated for multiple paths). Useful for monorepo setups where you want to generate tool-specific configurations in different project directories.
 - `--config <path>`: Use a specific configuration file
 - `--no-config`: Disable configuration file loading
@@ -322,7 +389,7 @@ rulesync supports configuration files to avoid repetitive command-line arguments
 ```jsonc
 {
   // List of tools to generate configurations for
-  "targets": ["copilot", "cursor", "claudecode", "codexcli"],
+  "targets": ["copilot", "cursor", "claudecode", "codexcli", "windsurf"],
   
   // Tools to exclude from generation (overrides targets)
   "exclude": ["roo"],
@@ -358,7 +425,7 @@ rulesync supports configuration files to avoid repetitive command-line arguments
 import type { ConfigOptions } from "rulesync";
 
 const config: ConfigOptions = {
-  targets: ["copilot", "cursor", "claudecode", "codexcli"],
+  targets: ["copilot", "cursor", "claudecode", "codexcli", "windsurf"],
   exclude: ["roo"],
   outputPaths: {
     copilot: ".github/copilot-instructions.md"
@@ -413,6 +480,7 @@ npx rulesync import --augmentcode # Import from .augment/rules/*.md
 npx rulesync import --roo        # Import from .roo/instructions.md
 npx rulesync import --geminicli  # Import from GEMINI.md and .gemini/memories/*.md
 npx rulesync import --junie      # Import from .junie/guidelines.md
+npx rulesync import --windsurf   # Import from .windsurf/rules/*.md
 
 # Import each tool individually
 npx rulesync import --claudecode
@@ -528,6 +596,7 @@ When `.rulesyncignore` exists, rulesync will:
    - `.copilotignore` for GitHub Copilot (community tools)
    - `.aiexclude` for Gemini CLI
    - `.aiignore` for Kiro IDE
+   - `.codeiumignore` for Windsurf
    - Update `.claude/settings.json` permissions.deny with `Read()` rules for Claude Code
 
 ### Frontmatter Schema
@@ -599,6 +668,7 @@ globs: ["**/*.ts", "**/*.tsx"]
 | **Gemini CLI** | `GEMINI.md` (root)<br>`.gemini/memories/*.md` (non-root) | Plain Markdown | Root goes to GEMINI.md<br>Non-root go to separate memory files<br>GEMINI.md includes `@filename` references |
 | **JetBrains Junie** | `.junie/guidelines.md` | Plain Markdown | All rules combined into single guidelines file |
 | **Kiro IDE** | `.kiro/steering/*.md` + `.aiignore` | Plain Markdown + Ignore patterns | Both levels use same format for custom steering docs<br>AI ignore file excludes sensitive patterns |
+| **Windsurf** | `.windsurf/rules/*.md` | Plain Markdown | Both levels use same format with auto-generated memory integration |
 
 ## Validation
 
@@ -629,6 +699,7 @@ rulesync can also manage MCP server configurations for supported AI tools. This
 - **JetBrains Junie** (`.junie/mcp.json`)
 - **Kiro IDE** (`.kiro/mcp.json`)
 - **Roo Code** (`.roo/mcp.json`)
+- **Windsurf** (`.windsurf/mcp.json`)
 
 ### MCP Configuration
 
@@ -698,7 +769,7 @@ MCP configurations are generated alongside rule files:
 npx rulesync generate
 
 # Generate only for specific tools
-npx rulesync generate --claudecode --cursor --codexcli --junie --kiro
+npx rulesync generate --claudecode --cursor --codexcli --junie --kiro --windsurf
 
 # Generate in specific directories (monorepo)
 npx rulesync generate --base-dir ./packages/frontend

package/dist/{augmentcode-MJYD2Y4S.js → augmentcode-HIZIQG2W.js}

@@ -1,8 +1,8 @@
 import {
   generateAugmentcodeMcp,
   generateAugmentcodeMcpConfiguration
-} from "./chunk-ORNO5MOO.js";
-import "./chunk-VI6SBYFB.js";
+} from "./chunk-YTU3SCQO.js";
+import "./chunk-AUUSMVCT.js";
 export {
   generateAugmentcodeMcp,
   generateAugmentcodeMcpConfiguration

package/dist/chunk-7E4U4YAB.js

@@ -0,0 +1,17 @@
+import {
+  generateMcpConfigurationFilesFromRegistry,
+  generateMcpFromRegistry
+} from "./chunk-J3TBR5EP.js";
+
+// src/generators/mcp/windsurf.ts
+function generateWindsurfMcp(config) {
+  return generateMcpFromRegistry("windsurf", config);
+}
+function generateWindsurfMcpConfiguration(mcpServers, baseDir = "") {
+  return generateMcpConfigurationFilesFromRegistry("windsurf", mcpServers, baseDir);
+}
+
+export {
+  generateWindsurfMcp,
+  generateWindsurfMcpConfiguration
+};

package/dist/{chunk-D7XQ4OHK.js → chunk-7UBF4OLN.js}

@@ -1,7 +1,7 @@
 import {
   generateMcpConfig,
   generateMcpConfigurationFiles
-} from "./chunk-PPAQWVXX.js";
+} from "./chunk-J3TBR5EP.js";
 
 // src/generators/mcp/codexcli.ts
 function generateCodexMcp(config) {

package/dist/{chunk-VI6SBYFB.js → chunk-AUUSMVCT.js}

@@ -11,7 +11,8 @@ var ALL_TOOL_TARGETS = [
   "roo",
   "geminicli",
   "kiro",
-  "junie"
+  "junie",
+  "windsurf"
 ];
 var ToolTargetSchema = z.enum(ALL_TOOL_TARGETS);
 var ToolTargetsSchema = z.array(ToolTargetSchema);