rulesync 14.2.0 → 15.0.0

package/README.md

@@ -53,7 +53,7 @@ See [Installation docs](https://dyoshikawa.github.io/rulesync/getting-started/in
 rulesync init
 
 # Install official skills (recommended)
-rulesync fetch dyoshikawa/rulesync --features skills
+rulesync fetch dyoshikawa/rulesync
 
 # Generate unified configurations with all features
 rulesync generate --targets "*" --features "*"
@@ -86,41 +86,44 @@ The tables below show whether each tool supports a given feature (✅ = supporte
 
 <!-- SUPPORTED_TOOLS_AI:BEGIN -->
 
-| Tool                   | rules | ignore | mcp | commands | subagents | skills | hooks | permissions | checks |
-| ---------------------- | :---: | :----: | :-: | :------: | :-------: | :----: | :---: | :---------: | :----: |
-| Amp                    |  ✅   |        | ✅  |          |           |   ✅   |  ✅   |     ✅      |   ✅   |
-| Claude Code            |  ✅   |   ✅   | ✅  |    ✅    |    ✅     |   ✅   |  ✅   |     ✅      |        |
-| Codex CLI              |  ✅   |        | ✅  |    ✅    |    ✅     |   ✅   |  ✅   |     ✅      |        |
-| GitHub Copilot         |  ✅   |        | ✅  |    ✅    |    ✅     |   ✅   |  ✅   |     ✅      |        |
-| GitHub Copilot CLI     |  ✅   |        | ✅  |          |    ✅     |   ✅   |  ✅   |             |        |
-| Goose                  |  ✅   |   ✅   | ✅  |    ✅    |    ✅     |   ✅   |  ✅   |     ✅      |        |
-| Hermes Agent           |  ✅   |   ✅   | ✅  |    ✅    |    ✅     |   ✅   |  ✅   |     ✅      |   ✅   |
-| Grok CLI               |  ✅   |        | ✅  |          |    ✅     |   ✅   |  ✅   |     ✅      |        |
-| Cursor                 |  ✅   |   ✅   | ✅  |    ✅    |    ✅     |   ✅   |  ✅   |     ✅      |        |
-| deepagents-cli         |  ✅   |        | ✅  |          |    ✅     |   ✅   |  ✅   |             |        |
-| Factory Droid          |  ✅   |        | ✅  |    ✅    |    ✅     |   ✅   |  ✅   |     ✅      |        |
-| OpenCode               |  ✅   |        | ✅  |    ✅    |    ✅     |   ✅   |  ✅   |     ✅      |        |
-| Cline                  |  ✅   |   ✅   | ✅  |    ✅    |    ✅     |   ✅   |       |     ✅      |        |
-| Kilo Code              |  ✅   |   ✅   | ✅  |    ✅    |    ✅     |   ✅   |  ✅   |     ✅      |        |
-| Roo Code               |  ✅   |   ✅   | ✅  |    ✅    |    ✅     |   ✅   |       |             |        |
-| Rovodev (Atlassian)    |  ✅   |        | ✅  |    ✅    |    ✅     |   ✅   |       |     ✅      |        |
-| Takt                   |  ✅   |        | ✅  |    ✅    |    ✅     |   ✅   |       |     ✅      |        |
-| Vibe Code              |  ✅   |   ✅   | ✅  |          |    ✅     |   ✅   |  ✅   |     ✅      |        |
-| Qwen Code              |  ✅   |   ✅   | ✅  |    ✅    |    ✅     |   ✅   |  ✅   |     ✅      |        |
-| Reasonix               |  ✅   |        | ✅  |    ✅    |    ✅     |   ✅   |  ✅   |     ✅      |        |
-| Kiro ⚠️                |  ✅   |   ✅   | ✅  |    ✅    |    ✅     |   ✅   |  ✅   |     ✅      |        |
-| Kiro CLI               |  ✅   |   ✅   | ✅  |    ✅    |    ✅     |   ✅   |  ✅   |     ✅      |        |
-| Kiro IDE               |  ✅   |   ✅   | ✅  |    ✅    |    ✅     |   ✅   |  ✅   |     ✅      |        |
-| Google Antigravity IDE |  ✅   |        | ✅  |    ✅    |           |   ✅   |  ✅   |     ✅      |        |
-| Google Antigravity CLI |  ✅   |   ✅   | ✅  |    ✅    |           |   ✅   |  ✅   |     ✅      |        |
-| JetBrains AI Assistant |  ✅   |   ✅   | ✅  |          |           |   ✅   |       |             |        |
-| JetBrains Junie        |  ✅   |   ✅   | ✅  |    ✅    |    ✅     |   ✅   |  ✅   |     ✅      |        |
-| AugmentCode            |  ✅   |   ✅   | ✅  |    ✅    |    ✅     |   ✅   |  ✅   |     ✅      |        |
-| Devin Desktop          |  ✅   |   ✅   | ✅  |    ✅    |    ✅     |   ✅   |  ✅   |     ✅      |        |
-| Warp                   |  ✅   |   ✅   | ✅  |          |           |   ✅   |       |     ✅      |        |
-| Replit                 |  ✅   |        |     |          |           |   ✅   |       |             |        |
-| Pi Coding Agent        |  ✅   |        |     |    ✅    |           |   ✅   |  ✅   |             |        |
-| Zed                    |  ✅   |   ✅   | ✅  |          |           |   ✅   |       |     ✅      |        |
+| Tool                      | rules | ignore | mcp | commands | subagents | skills | hooks | permissions | checks |
+| ------------------------- | :---: | :----: | :-: | :------: | :-------: | :----: | :---: | :---------: | :----: |
+| Amp                       |  ✅   |        | ✅  |          |           |   ✅   |  ✅   |     ✅      |   ✅   |
+| Claude Code               |  ✅   |   ✅   | ✅  |    ✅    |    ✅     |   ✅   |  ✅   |     ✅      |        |
+| Claude Code plugin        |       |        | ✅  |    ✅    |    ✅     |   ✅   |  ✅   |             |        |
+| Codex CLI                 |  ✅   |        | ✅  |    ✅    |    ✅     |   ✅   |  ✅   |     ✅      |        |
+| GitHub Copilot            |  ✅   |        | ✅  |    ✅    |    ✅     |   ✅   |  ✅   |     ✅      |        |
+| GitHub Copilot CLI        |  ✅   |        | ✅  |          |    ✅     |   ✅   |  ✅   |             |        |
+| Goose                     |  ✅   |   ✅   | ✅  |    ✅    |    ✅     |   ✅   |  ✅   |     ✅      |        |
+| Hermes Agent              |  ✅   |   ✅   | ✅  |    ✅    |    ✅     |   ✅   |  ✅   |     ✅      |   ✅   |
+| Grok CLI                  |  ✅   |        | ✅  |          |    ✅     |   ✅   |  ✅   |     ✅      |        |
+| Cursor                    |  ✅   |   ✅   | ✅  |    ✅    |    ✅     |   ✅   |  ✅   |     ✅      |        |
+| deepagents-cli            |  ✅   |        | ✅  |          |    ✅     |   ✅   |  ✅   |             |        |
+| Factory Droid             |  ✅   |        | ✅  |    ✅    |    ✅     |   ✅   |  ✅   |     ✅      |        |
+| OpenCode                  |  ✅   |        | ✅  |    ✅    |    ✅     |   ✅   |  ✅   |     ✅      |        |
+| Cline                     |  ✅   |   ✅   | ✅  |    ✅    |    ✅     |   ✅   |       |     ✅      |        |
+| Kilo Code                 |  ✅   |   ✅   | ✅  |    ✅    |    ✅     |   ✅   |  ✅   |     ✅      |        |
+| Kimi Code                 |  ✅   |        | ✅  |          |    ✅     |   ✅   |  ✅   |     ✅      |        |
+| Roo Code                  |  ✅   |   ✅   | ✅  |    ✅    |    ✅     |   ✅   |       |             |        |
+| Rovodev (Atlassian)       |  ✅   |        | ✅  |    ✅    |    ✅     |   ✅   |       |     ✅      |        |
+| Takt                      |  ✅   |        | ✅  |    ✅    |    ✅     |   ✅   |       |     ✅      |        |
+| Vibe Code                 |  ✅   |   ✅   | ✅  |          |    ✅     |   ✅   |  ✅   |     ✅      |        |
+| Qwen Code                 |  ✅   |   ✅   | ✅  |    ✅    |    ✅     |   ✅   |  ✅   |     ✅      |        |
+| Reasonix                  |  ✅   |        | ✅  |    ✅    |    ✅     |   ✅   |  ✅   |     ✅      |        |
+| Kiro ⚠️                   |  ✅   |   ✅   | ✅  |    ✅    |    ✅     |   ✅   |  ✅   |     ✅      |        |
+| Kiro CLI                  |  ✅   |   ✅   | ✅  |    ✅    |    ✅     |   ✅   |  ✅   |     ✅      |        |
+| Kiro IDE                  |  ✅   |   ✅   | ✅  |    ✅    |    ✅     |   ✅   |  ✅   |     ✅      |        |
+| Google Antigravity IDE    |  ✅   |        | ✅  |    ✅    |           |   ✅   |  ✅   |     ✅      |        |
+| Google Antigravity CLI    |  ✅   |   ✅   | ✅  |    ✅    |           |   ✅   |  ✅   |     ✅      |        |
+| Google Antigravity plugin |  ✅   |        | ✅  |          |           |   ✅   |  ✅   |             |        |
+| JetBrains AI Assistant    |  ✅   |   ✅   | ✅  |          |           |   ✅   |       |             |        |
+| JetBrains Junie           |  ✅   |   ✅   | ✅  |    ✅    |    ✅     |   ✅   |  ✅   |     ✅      |        |
+| AugmentCode               |  ✅   |   ✅   | ✅  |    ✅    |    ✅     |   ✅   |  ✅   |     ✅      |        |
+| Devin Desktop             |  ✅   |   ✅   | ✅  |    ✅    |    ✅     |   ✅   |  ✅   |     ✅      |        |
+| Warp                      |  ✅   |   ✅   | ✅  |          |           |   ✅   |       |     ✅      |        |
+| Replit                    |  ✅   |        |     |          |           |   ✅   |       |             |        |
+| Pi Coding Agent           |  ✅   |        |     |    ✅    |           |   ✅   |  ✅   |             |        |
+| Zed                       |  ✅   |   ✅   | ✅  |          |           |   ✅   |       |     ✅      |        |
 
 <!-- SUPPORTED_TOOLS_AI:END -->
 
@@ -137,12 +140,14 @@ The tables below show whether each tool supports a given feature (✅ = supporte
 
 - ⚠️: Deprecated — still supported, but see the note below
 
-### Deprecation notes
+### Target and deprecation notes
 
+- **Ignore feature** — The `ignore` feature is deprecated in favor of the more expressive `permissions` feature. Existing ignore configurations remain supported throughout Rulesync 14.x; removal, if any, will be decided separately and will not occur before a future major release. New `rulesync init` projects scaffold permissions without enabling or creating ignore files. See the [migration guide](https://dyoshikawa.github.io/rulesync/reference/file-formats#rulesync-aiignore-or-rulesyncignore-deprecated).
 - **Google Antigravity (`antigravity-ide` / `antigravity-cli`)** — Antigravity 2.0 splits into two products with separate global config trees: the desktop **`antigravity-ide`** and the **`antigravity-cli`** (`agy`). For project-scope rules, **both `antigravity-ide` and `antigravity-cli`** emit the root rule as a plain cross-tool **`AGENTS.md`** at the project root (the Gemini-lineage discovery order is `AGENTS.md`, `CONTEXT.md`, `GEMINI.md`; the IDE has read `AGENTS.md` since v1.20.3) and non-root rules under `.agents/rules/`.
-- **Kiro (`kiro`)** — Kiro's IDE and CLI use diverging config formats (IDE: Markdown subagents `.kiro/agents/*.md` and structured JSON hooks `.kiro/hooks/*.json`; CLI: JSON agent-config subagents `.kiro/agents/*.json` and hooks in `.kiro/agents/default.json`), so `kiro` is split into **`kiro-cli`** and **`kiro-ide`**. The legacy `kiro` target remains as a **deprecated alias** with its current behavior unchanged. The two targets share every surface except **subagents** (Markdown vs JSON) and **hooks**; Kiro IDE hooks are emitted as a single `.kiro/hooks/rulesync.json` (`{ "version": "v1", "hooks": [ ... ] }`) in project (`.kiro/hooks/`) and global (`~/.kiro/hooks/`) scope, while the CLI uses `.kiro/agents/default.json`. Global skills (`~/.kiro/skills/`) and global Kiro IDE subagents (`~/.kiro/agents/`) are supported too, as are global Kiro CLI commands (`~/.kiro/prompts/`) and subagents (`~/.kiro/agents/`).
+- **Plugin packaging (`claudecode-plugin` / `antigravity-plugin`)** — These project-only targets generate and import Rulesync-managed components inside an existing plugin directory selected with `--output-roots` (generate) or `--output-root` (import). They are excluded from `--targets "*"` to avoid writing package-level `skills/`, `rules/`, or `commands/` directories into ordinary projects. Rulesync preserves plugin manifests, marketplace metadata, scripts, and other non-component assets. See the [Plugin Packaging guide](https://dyoshikawa.github.io/rulesync/guide/plugin-packaging).
+- **Kiro (`kiro`)** — Kiro's IDE and CLI use diverging config formats (IDE: Markdown subagents `.kiro/agents/*.md` and structured JSON hooks `.kiro/hooks/*.json`; CLI: JSON agent-config subagents `.kiro/agents/*.json` and hooks in `.kiro/agents/default.json`), so `kiro` is split into **`kiro-cli`** and **`kiro-ide`**. The legacy `kiro` target remains as a **deprecated alias** with its current behavior unchanged. The two targets share every surface except **subagents** (Markdown vs JSON) and **hooks**; Kiro IDE hooks are emitted as a single `.kiro/hooks/rulesync.json` (`{ "version": "v1", "hooks": [ ... ] }`) in project (`.kiro/hooks/`) and global (`~/.kiro/hooks/`) scope, while the CLI uses `.kiro/agents/default.json`. Global skills (`~/.kiro/skills/`), global ignore (`~/.kiro/settings/kiroignore`), and global Kiro IDE subagents (`~/.kiro/agents/`) are supported too, as are global Kiro CLI commands (`~/.kiro/prompts/`) and subagents (`~/.kiro/agents/`). Kiro MCP generation preserves per-server `disabledTools`, and Kiro CLI hook caching maps `cacheTtl` to `cache_ttl_seconds`.
 
-Some features accept per-feature options (e.g., Claude Code's `ignore` feature supports `fileMode: "local"` to write to `settings.local.json` instead of `settings.json`). See [Configuration > Per-feature options](https://dyoshikawa.github.io/rulesync/guide/configuration#per-feature-options) for details.
+Some features accept per-feature options. See [Configuration > Per-feature options](https://dyoshikawa.github.io/rulesync/guide/configuration#per-feature-options) for details.
 
 ## Documentation
 

package/dist/cli/index.cjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-const require_import = require("../import-Ds8vYv6h.cjs");
+const require_import = require("../import-DRN7goJ_.cjs");
 let commander = require("commander");
 let zod_mini = require("zod/mini");
 let node_fs_promises = require("node:fs/promises");
@@ -278,8 +278,14 @@ function singletonTemplate(feature) {
       "src/**": "allow"
     },
     "read": {
-      ".env": "deny"
+      ".env": "deny",
+      "credentials/**": "deny"
     }
+  },
+  "codexcli": {
+    "approval_policy": "on-request",
+    "approvals_reviewer": "auto_review",
+    "base_permission_profile": ":danger-full-access"
   }
 }
 `;
@@ -319,25 +325,19 @@ function createFeatureScaffold({ feature, name }) {
 		});
 		case "mcp": {
 			const paths = require_import.RulesyncMcp.getSettablePaths();
-			const relativeFilePath = (0, node_path.join)(paths.recommended.relativeDirPath, paths.recommended.relativeFilePath);
 			return {
 				feature,
-				relativeFilePath,
-				candidateRelativeFilePaths: [
-					...paths.jsonc ? [(0, node_path.join)(paths.jsonc.relativeDirPath, paths.jsonc.relativeFilePath)] : [],
-					relativeFilePath,
-					...paths.legacy ? [(0, node_path.join)(paths.legacy.relativeDirPath, paths.legacy.relativeFilePath)] : []
-				],
+				relativeFilePath: (0, node_path.join)(paths.recommended.relativeDirPath, paths.recommended.relativeFilePath),
+				candidateRelativeFilePaths: require_import.getRulesyncSourceCandidates({ paths }).map((candidate) => (0, node_path.join)(candidate.relativeDirPath, candidate.relativeFilePath)),
 				content: singletonTemplate(feature)
 			};
 		}
 		case "hooks": {
 			const paths = require_import.RulesyncHooks.getSettablePaths();
-			const relativeFilePath = (0, node_path.join)(paths.relativeDirPath, paths.relativeFilePath);
 			return {
 				feature,
-				relativeFilePath,
-				candidateRelativeFilePaths: [...paths.jsonc ? [(0, node_path.join)(paths.jsonc.relativeDirPath, paths.jsonc.relativeFilePath)] : [], relativeFilePath],
+				relativeFilePath: (0, node_path.join)(paths.recommended.relativeDirPath, paths.recommended.relativeFilePath),
+				candidateRelativeFilePaths: require_import.getRulesyncSourceCandidates({ paths }).map((candidate) => (0, node_path.join)(candidate.relativeDirPath, candidate.relativeFilePath)),
 				content: singletonTemplate(feature)
 			};
 		}
@@ -353,11 +353,10 @@ function createFeatureScaffold({ feature, name }) {
 		}
 		case "permissions": {
 			const paths = require_import.RulesyncPermissions.getSettablePaths();
-			const relativeFilePath = (0, node_path.join)(paths.relativeDirPath, paths.relativeFilePath);
 			return {
 				feature,
-				relativeFilePath,
-				candidateRelativeFilePaths: [...paths.jsonc ? [(0, node_path.join)(paths.jsonc.relativeDirPath, paths.jsonc.relativeFilePath)] : [], relativeFilePath],
+				relativeFilePath: (0, node_path.join)(paths.recommended.relativeDirPath, paths.recommended.relativeFilePath),
+				candidateRelativeFilePaths: require_import.getRulesyncSourceCandidates({ paths }).map((candidate) => (0, node_path.join)(candidate.relativeDirPath, candidate.relativeFilePath)),
 				content: singletonTemplate(feature)
 			};
 		}
@@ -3797,6 +3796,8 @@ async function convertCommand(logger, options) {
 	const fromTool = parseToolTarget$1(options.from ?? "", "source");
 	const toToolsRaw = (options.to ?? []).map((t) => parseToolTarget$1(t, "destination"));
 	const toTools = Array.from(new Set(toToolsRaw));
+	const packagingTarget = [fromTool, ...toTools].find(require_import.isPackagingToolTarget);
+	if (packagingTarget) throw new require_import.CLIError(`Plugin packaging target '${packagingTarget}' is not supported by convert. Use import --output-root and generate --output-roots with an explicit plugin directory.`, require_import.ErrorCodes.CONVERT_FAILED);
 	if (toTools.includes(fromTool)) throw new require_import.CLIError(`Destination tools must not include the source tool '${fromTool}'. Converting a tool onto itself is likely a mistake and may cause lossy round-trips.`, require_import.ErrorCodes.CONVERT_FAILED);
 	const config = await require_import.ConfigResolver.resolve({
 		...options,
@@ -3861,9 +3862,9 @@ const FEATURE_PATHS = {
 	skills: ["skills"],
 	checks: ["checks"],
 	ignore: [require_import.RULESYNC_AIIGNORE_FILE_NAME],
-	mcp: [require_import.RULESYNC_MCP_FILE_NAME, require_import.RULESYNC_MCP_JSONC_FILE_NAME],
-	hooks: [require_import.RULESYNC_HOOKS_FILE_NAME, require_import.RULESYNC_HOOKS_JSONC_FILE_NAME],
-	permissions: [require_import.RULESYNC_PERMISSIONS_FILE_NAME, require_import.RULESYNC_PERMISSIONS_JSONC_FILE_NAME]
+	mcp: [require_import.RULESYNC_MCP_FILE_NAME, require_import.RULESYNC_MCP_LEGACY_FILE_NAME],
+	hooks: [require_import.RULESYNC_HOOKS_FILE_NAME, require_import.RULESYNC_HOOKS_LEGACY_FILE_NAME],
+	permissions: [require_import.RULESYNC_PERMISSIONS_FILE_NAME, require_import.RULESYNC_PERMISSIONS_LEGACY_FILE_NAME]
 };
 /**
 * Check if target is a tool target (not rulesync)
@@ -4001,10 +4002,11 @@ async function convertFetchedFilesToRulesync(params) {
 	};
 }
 /**
-* Resolve features from options, handling wildcard
+* Resolve features from options, defaulting to skills and handling wildcard.
 */
 function resolveFeatures(features) {
-	if (!features || features.length === 0 || features.includes("*")) return [...require_import.ALL_FEATURES];
+	if (features === void 0) return ["skills"];
+	if (features.includes("*")) return [...require_import.ALL_FEATURES];
 	return features.filter((f) => require_import.ALL_FEATURES.includes(f));
 }
 /**
@@ -4823,6 +4825,7 @@ const ALL_GITIGNORE_ENTRIES = (() => {
 	const seen = /* @__PURE__ */ new Set();
 	const result = [];
 	for (const tag of GITIGNORE_ENTRY_REGISTRY) {
+		if (normalizeGitignoreEntryTargets(tag.target).every((target) => require_import.PACKAGING_TOOL_TARGETS.includes(target))) continue;
 		if (seen.has(tag.entry)) continue;
 		seen.add(tag.entry);
 		result.push(tag.entry);
@@ -4832,14 +4835,13 @@ const ALL_GITIGNORE_ENTRIES = (() => {
 const isTargetSelected = (target, selectedTargets) => {
 	const targets = normalizeGitignoreEntryTargets(target);
 	if (targets.includes("common")) return true;
-	if (!selectedTargets || selectedTargets.length === 0) return true;
-	if (selectedTargets.includes("*")) return true;
+	if (!selectedTargets || selectedTargets.length === 0 || selectedTargets.includes("*")) return targets.some((candidate) => selectedTargets?.includes(candidate) || !require_import.PACKAGING_TOOL_TARGETS.includes(candidate));
 	return targets.some((candidate) => selectedTargets.includes(candidate));
 };
 const getSelectedGitignoreEntryTargets = (target, selectedTargets) => {
 	const targets = normalizeGitignoreEntryTargets(target);
 	if (targets.includes("common")) return ["common"];
-	if (!selectedTargets || selectedTargets.length === 0 || selectedTargets.includes("*")) return targets;
+	if (!selectedTargets || selectedTargets.length === 0 || selectedTargets.includes("*")) return targets.filter((candidate) => selectedTargets?.includes(candidate) || !require_import.PACKAGING_TOOL_TARGETS.includes(candidate));
 	return targets.filter((candidate) => selectedTargets.includes(candidate));
 };
 const isFeatureSelected = (feature, features) => {
@@ -5160,16 +5162,13 @@ async function createConfigFile() {
 	await require_import.writeFileContent(path, JSON.stringify({
 		$schema: require_import.RULESYNC_CONFIG_SCHEMA_URL,
 		targets: [
-			"copilot",
-			"cursor",
+			"codexcli",
 			"claudecode",
-			"codexcli"
+			"opencode"
 		],
 		features: [
 			"rules",
-			"ignore",
 			"mcp",
-			"commands",
 			"subagents",
 			"skills",
 			"hooks",
@@ -5197,10 +5196,6 @@ async function createSampleFiles() {
 			name: "overview"
 		}),
 		createFeatureScaffold({ feature: "mcp" }),
-		createFeatureScaffold({
-			feature: "command",
-			name: "review-pr"
-		}),
 		createFeatureScaffold({
 			feature: "subagent",
 			name: "planner"
@@ -5209,21 +5204,24 @@ async function createSampleFiles() {
 			feature: "skill",
 			name: "project-context"
 		}),
-		createFeatureScaffold({ feature: "ignore" }),
 		createFeatureScaffold({ feature: "hooks" }),
 		createFeatureScaffold({ feature: "permissions" })
 	];
 	const results = [];
 	for (const sample of samples) {
 		await require_import.ensureDir((0, node_path.dirname)(sample.relativeFilePath));
-		results.push(await writeIfNotExists(sample.relativeFilePath, sample.content));
+		results.push(await writeIfNotExists({
+			path: sample.relativeFilePath,
+			candidatePaths: sample.candidateRelativeFilePaths,
+			content: sample.content
+		}));
 	}
 	return results;
 }
-async function writeIfNotExists(path, content) {
-	if (await require_import.fileExists(path)) return {
+async function writeIfNotExists({ path, candidatePaths, content }) {
+	for (const candidatePath of candidatePaths) if (await require_import.fileExists(candidatePath)) return {
 		created: false,
-		path
+		path: candidatePath
 	};
 	await require_import.writeFileContent(path, content);
 	return {
@@ -5259,7 +5257,7 @@ async function initCommand(logger) {
 	}
 	logger.success("rulesync initialized successfully!");
 	logger.info("Next steps:");
-	logger.info(`1. Edit ${require_import.RULESYNC_RELATIVE_DIR_PATH}/**/*.md, ${require_import.RULESYNC_RELATIVE_DIR_PATH}/skills/*/${require_import.SKILL_FILE_NAME}, ${require_import.RULESYNC_MCP_RELATIVE_FILE_PATH}, ${require_import.RULESYNC_HOOKS_RELATIVE_FILE_PATH}, ${require_import.RULESYNC_PERMISSIONS_RELATIVE_FILE_PATH} and ${require_import.RULESYNC_AIIGNORE_RELATIVE_FILE_PATH}`);
+	logger.info(`1. Edit ${require_import.RULESYNC_RELATIVE_DIR_PATH}/**/*.md, ${require_import.RULESYNC_RELATIVE_DIR_PATH}/skills/*/${require_import.SKILL_FILE_NAME}, ${require_import.RULESYNC_MCP_RELATIVE_FILE_PATH}, ${require_import.RULESYNC_HOOKS_RELATIVE_FILE_PATH} and ${require_import.RULESYNC_PERMISSIONS_RELATIVE_FILE_PATH}`);
 	logger.info("2. Run 'rulesync generate' to create configuration files");
 }
 //#endregion
@@ -7237,17 +7235,16 @@ async function getHooksFile() {
 async function putHooksFile({ content }) {
 	if (content.length > maxHooksSizeBytes) throw new Error(`Hooks file size ${content.length} bytes exceeds maximum ${maxHooksSizeBytes} bytes (1MB) for ${require_import.RULESYNC_HOOKS_RELATIVE_FILE_PATH}`);
 	try {
-		JSON.parse(content);
+		require_import.parseJsonc(content);
 	} catch (error) {
-		throw new Error(`Invalid JSON format in hooks file (${require_import.RULESYNC_HOOKS_RELATIVE_FILE_PATH}): ${require_import.formatError(error)}`, { cause: error });
+		throw new Error(`Invalid JSONC format in hooks file (${require_import.RULESYNC_HOOKS_RELATIVE_FILE_PATH}): ${require_import.formatError(error)}`, { cause: error });
 	}
 	try {
 		const outputRoot = process.cwd();
-		const paths = require_import.RulesyncHooks.getSettablePaths();
-		const jsoncRelativePath = (0, node_path.join)(paths.jsonc.relativeDirPath, paths.jsonc.relativeFilePath);
-		if (await require_import.fileExists((0, node_path.join)(outputRoot, jsoncRelativePath))) throw new Error(`${jsoncRelativePath} exists and takes precedence over ${require_import.RULESYNC_HOOKS_RELATIVE_FILE_PATH}. Edit ${jsoncRelativePath} directly instead.`);
-		const relativeDirPath = paths.relativeDirPath;
-		const relativeFilePath = paths.relativeFilePath;
+		const { relativeDirPath, relativeFilePath } = await require_import.resolveRulesyncSourceWritePath({
+			outputRoot,
+			paths: require_import.RulesyncHooks.getSettablePaths()
+		});
 		const fullPath = (0, node_path.join)(outputRoot, relativeDirPath, relativeFilePath);
 		const rulesyncHooks = new require_import.RulesyncHooks({
 			outputRoot,
@@ -7273,9 +7270,8 @@ async function deleteHooksFile() {
 	try {
 		const outputRoot = process.cwd();
 		const paths = require_import.RulesyncHooks.getSettablePaths();
-		await require_import.removeFile((0, node_path.join)(outputRoot, paths.relativeDirPath, paths.relativeFilePath));
-		await require_import.removeFile((0, node_path.join)(outputRoot, paths.jsonc.relativeDirPath, paths.jsonc.relativeFilePath));
-		return { relativePathFromCwd: (0, node_path.join)(paths.relativeDirPath, paths.relativeFilePath) };
+		for (const candidate of require_import.getRulesyncSourceCandidates({ paths })) await require_import.removeFile((0, node_path.join)(outputRoot, candidate.relativeDirPath, candidate.relativeFilePath));
+		return { relativePathFromCwd: (0, node_path.join)(paths.recommended.relativeDirPath, paths.recommended.relativeFilePath) };
 	} catch (error) {
 		throw new Error(`Failed to delete hooks file (${require_import.RULESYNC_HOOKS_RELATIVE_FILE_PATH}): ${require_import.formatError(error)}`, { cause: error });
 	}
@@ -7303,7 +7299,7 @@ const hooksTools = {
 	},
 	putHooksFile: {
 		name: "putHooksFile",
-		description: "Create or update the hooks configuration file (upsert operation). content parameter is required and must be valid JSON.",
+		description: "Create or update the hooks configuration file (upsert operation). content parameter is required and must be valid JSONC.",
 		parameters: hooksToolSchemas.putHooksFile,
 		execute: async (args) => {
 			const result = await putHooksFile({ content: args.content });
@@ -7519,17 +7515,16 @@ async function getMcpFile() {
 async function putMcpFile({ content }) {
 	if (content.length > maxMcpSizeBytes) throw new Error(`MCP file size ${content.length} bytes exceeds maximum ${maxMcpSizeBytes} bytes (1MB) for ${require_import.RULESYNC_MCP_RELATIVE_FILE_PATH}`);
 	try {
-		JSON.parse(content);
+		require_import.parseJsonc(content);
 	} catch (error) {
-		throw new Error(`Invalid JSON format in MCP file (${require_import.RULESYNC_MCP_RELATIVE_FILE_PATH}): ${require_import.formatError(error)}`, { cause: error });
+		throw new Error(`Invalid JSONC format in MCP file (${require_import.RULESYNC_MCP_RELATIVE_FILE_PATH}): ${require_import.formatError(error)}`, { cause: error });
 	}
 	try {
 		const outputRoot = process.cwd();
-		const paths = require_import.RulesyncMcp.getSettablePaths();
-		const jsoncRelativePath = (0, node_path.join)(paths.jsonc.relativeDirPath, paths.jsonc.relativeFilePath);
-		if (await require_import.fileExists((0, node_path.join)(outputRoot, jsoncRelativePath))) throw new Error(`${jsoncRelativePath} exists and takes precedence over ${require_import.RULESYNC_MCP_RELATIVE_FILE_PATH}. Edit ${jsoncRelativePath} directly instead.`);
-		const relativeDirPath = paths.recommended.relativeDirPath;
-		const relativeFilePath = paths.recommended.relativeFilePath;
+		const { relativeDirPath, relativeFilePath } = await require_import.resolveRulesyncSourceWritePath({
+			outputRoot,
+			paths: require_import.RulesyncMcp.getSettablePaths()
+		});
 		const fullPath = (0, node_path.join)(outputRoot, relativeDirPath, relativeFilePath);
 		const rulesyncMcp = new require_import.RulesyncMcp({
 			outputRoot,
@@ -7555,11 +7550,7 @@ async function deleteMcpFile() {
 	try {
 		const outputRoot = process.cwd();
 		const paths = require_import.RulesyncMcp.getSettablePaths();
-		const recommendedPath = (0, node_path.join)(outputRoot, paths.recommended.relativeDirPath, paths.recommended.relativeFilePath);
-		const legacyPath = (0, node_path.join)(outputRoot, paths.legacy.relativeDirPath, paths.legacy.relativeFilePath);
-		await require_import.removeFile(recommendedPath);
-		await require_import.removeFile((0, node_path.join)(outputRoot, paths.jsonc.relativeDirPath, paths.jsonc.relativeFilePath));
-		await require_import.removeFile(legacyPath);
+		for (const candidate of require_import.getRulesyncSourceCandidates({ paths })) await require_import.removeFile((0, node_path.join)(outputRoot, candidate.relativeDirPath, candidate.relativeFilePath));
 		return { relativePathFromCwd: (0, node_path.join)(paths.recommended.relativeDirPath, paths.recommended.relativeFilePath) };
 	} catch (error) {
 		throw new Error(`Failed to delete MCP file (${require_import.RULESYNC_MCP_RELATIVE_FILE_PATH}): ${require_import.formatError(error)}`, { cause: error });
@@ -7588,7 +7579,7 @@ const mcpTools = {
 	},
 	putMcpFile: {
 		name: "putMcpFile",
-		description: "Create or update the MCP configuration file (upsert operation). content parameter is required and must be valid JSON.",
+		description: "Create or update the MCP configuration file (upsert operation). content parameter is required and must be valid JSONC.",
 		parameters: mcpToolSchemas.putMcpFile,
 		execute: async (args) => {
 			const result = await putMcpFile({ content: args.content });
@@ -7628,17 +7619,16 @@ async function getPermissionsFile() {
 async function putPermissionsFile({ content }) {
 	if (content.length > maxPermissionsSizeBytes) throw new Error(`Permissions file size ${content.length} bytes exceeds maximum ${maxPermissionsSizeBytes} bytes (1MB) for ${require_import.RULESYNC_PERMISSIONS_RELATIVE_FILE_PATH}`);
 	try {
-		JSON.parse(content);
+		require_import.parseJsonc(content);
 	} catch (error) {
-		throw new Error(`Invalid JSON format in permissions file (${require_import.RULESYNC_PERMISSIONS_RELATIVE_FILE_PATH}): ${require_import.formatError(error)}`, { cause: error });
+		throw new Error(`Invalid JSONC format in permissions file (${require_import.RULESYNC_PERMISSIONS_RELATIVE_FILE_PATH}): ${require_import.formatError(error)}`, { cause: error });
 	}
 	try {
 		const outputRoot = process.cwd();
-		const paths = require_import.RulesyncPermissions.getSettablePaths();
-		const jsoncRelativePath = (0, node_path.join)(paths.jsonc.relativeDirPath, paths.jsonc.relativeFilePath);
-		if (await require_import.fileExists((0, node_path.join)(outputRoot, jsoncRelativePath))) throw new Error(`${jsoncRelativePath} exists and takes precedence over ${require_import.RULESYNC_PERMISSIONS_RELATIVE_FILE_PATH}. Edit ${jsoncRelativePath} directly instead.`);
-		const relativeDirPath = paths.relativeDirPath;
-		const relativeFilePath = paths.relativeFilePath;
+		const { relativeDirPath, relativeFilePath } = await require_import.resolveRulesyncSourceWritePath({
+			outputRoot,
+			paths: require_import.RulesyncPermissions.getSettablePaths()
+		});
 		const fullPath = (0, node_path.join)(outputRoot, relativeDirPath, relativeFilePath);
 		const rulesyncPermissions = new require_import.RulesyncPermissions({
 			outputRoot,
@@ -7664,9 +7654,8 @@ async function deletePermissionsFile() {
 	try {
 		const outputRoot = process.cwd();
 		const paths = require_import.RulesyncPermissions.getSettablePaths();
-		await require_import.removeFile((0, node_path.join)(outputRoot, paths.relativeDirPath, paths.relativeFilePath));
-		await require_import.removeFile((0, node_path.join)(outputRoot, paths.jsonc.relativeDirPath, paths.jsonc.relativeFilePath));
-		return { relativePathFromCwd: (0, node_path.join)(paths.relativeDirPath, paths.relativeFilePath) };
+		for (const candidate of require_import.getRulesyncSourceCandidates({ paths })) await require_import.removeFile((0, node_path.join)(outputRoot, candidate.relativeDirPath, candidate.relativeFilePath));
+		return { relativePathFromCwd: (0, node_path.join)(paths.recommended.relativeDirPath, paths.recommended.relativeFilePath) };
 	} catch (error) {
 		throw new Error(`Failed to delete permissions file (${require_import.RULESYNC_PERMISSIONS_RELATIVE_FILE_PATH}): ${require_import.formatError(error)}`, { cause: error });
 	}
@@ -7694,7 +7683,7 @@ const permissionsTools = {
 	},
 	putPermissionsFile: {
 		name: "putPermissionsFile",
-		description: "Create or update the permissions configuration file (upsert operation). content parameter is required and must be valid JSON.",
+		description: "Create or update the permissions configuration file (upsert operation). content parameter is required and must be valid JSONC.",
 		parameters: permissionsToolSchemas.putPermissionsFile,
 		execute: async (args) => {
 			const result = await putPermissionsFile({ content: args.content });
@@ -8991,8 +8980,9 @@ function wrapCommand$1({ name, errorCode, handler, getVersion, loggerFactory = c
 	};
 }
 //#endregion
-//#region src/cli/index.ts
-const getVersion = () => "14.2.0";
+//#region src/cli/program.ts
+const getVersion = () => "15.0.0";
+const FEATURES_HELP = `${require_import.ALL_FEATURES.join(",")}; ignore is deprecated, use permissions`;
 function wrapCommand(name, errorCode, handler) {
 	return wrapCommand$1({
 		name,
@@ -9001,14 +8991,14 @@ function wrapCommand(name, errorCode, handler) {
 		getVersion
 	});
 }
-const main = async () => {
+function createProgram() {
 	const program = new commander.Command();
 	const version = getVersion();
 	program.name("rulesync").description("Unified AI rules management CLI tool").version(version, "-v, --version", "Show version").option("-j, --json", "Output results as JSON");
 	program.command("init").description("Initialize rulesync in current directory").option("-V, --verbose", "Verbose output").option("-s, --silent", "Suppress all output").action(wrapCommand("init", "INIT_FAILED", async (logger) => {
 		await initCommand(logger);
 	}));
-	program.command("gitignore").description("Add generated files to .gitignore").option("-t, --targets <tools>", "Comma-separated list of tools to include (e.g., 'claudecode,copilot' or '*' for all)", parseCommaSeparatedList).option("-f, --features <features>", `Comma-separated list of features to include (${require_import.ALL_FEATURES.join(",")}) or '*' for all`, parseCommaSeparatedList).option("-V, --verbose", "Verbose output").option("-s, --silent", "Suppress all output").action(wrapCommand("gitignore", "GITIGNORE_FAILED", async (logger, options) => {
+	program.command("gitignore").description("Add generated files to .gitignore").option("-t, --targets <tools>", "Comma-separated list of tools to include (e.g., 'claudecode,copilot' or '*' for all)", parseCommaSeparatedList).option("-f, --features <features>", `Comma-separated list of features to include (${FEATURES_HELP}) or '*' for all`, parseCommaSeparatedList).option("-V, --verbose", "Verbose output").option("-s, --silent", "Suppress all output").action(wrapCommand("gitignore", "GITIGNORE_FAILED", async (logger, options) => {
 		const cliTargets = options.targets;
 		const cliFeatures = options.features;
 		const resolvedTargets = await resolveGitignoreTargets({ cliTargets });
@@ -9019,7 +9009,7 @@ const main = async () => {
 			silent: options.silent
 		});
 	}));
-	program.command("add <source>").description("Add a Rulesync feature file or install a declarative rule or skill source").option("--name <name>", "Name for a rule, command, subagent, skill, or check scaffold").option("-f, --force", "Overwrite an existing scaffold file without prompting").option("--skills <skills>", "Comma-separated skill names to install", parseCommaSeparatedList).option("--rules <rules>", "Comma-separated rule names to install", parseCommaSeparatedList).option("--transport <transport>", "Source transport: github, git, or npm").option("-r, --ref <ref>", "Git ref, npm version, or npm dist-tag").option("-p, --path <path>", "Skills path within the source").option("--rules-path <path>", "Rules path within the source").option("--registry <url>", "npm-compatible registry URL").option("--token-env <name>", "Environment variable containing the npm registry token").option("--token <token>", "GitHub token for private repositories").option("-c, --config <path>", "Path to configuration file").option("-V, --verbose", "Verbose output").option("-s, --silent", "Suppress all output").action(wrapCommand("add", "ADD_FAILED", async (logger, options, _globalOpts, positionalArgs) => {
+	program.command("add <source>").description("Add a Rulesync feature file (ignore is deprecated; use permissions) or install a declarative rule or skill source").option("--name <name>", "Name for a rule, command, subagent, skill, or check scaffold").option("-f, --force", "Overwrite an existing scaffold file without prompting").option("--skills <skills>", "Comma-separated skill names to install", parseCommaSeparatedList).option("--rules <rules>", "Comma-separated rule names to install", parseCommaSeparatedList).option("--transport <transport>", "Source transport: github, git, or npm").option("-r, --ref <ref>", "Git ref, npm version, or npm dist-tag").option("-p, --path <path>", "Skills path within the source").option("--rules-path <path>", "Rules path within the source").option("--registry <url>", "npm-compatible registry URL").option("--token-env <name>", "Environment variable containing the npm registry token").option("--token <token>", "GitHub token for private repositories").option("-c, --config <path>", "Path to configuration file").option("-V, --verbose", "Verbose output").option("-s, --silent", "Suppress all output").action(wrapCommand("add", "ADD_FAILED", async (logger, options, _globalOpts, positionalArgs) => {
 		const source = positionalArgs[0];
 		const addOptions = options;
 		await addCommand(logger, {
@@ -9028,17 +9018,21 @@ const main = async () => {
 			configPath: addOptions.config
 		});
 	}));
-	program.command("fetch <source>").description("Fetch files from a Git repository (GitHub/GitLab)").option("-t, --target <target>", "Target format to interpret files as (e.g., 'rulesync', 'claudecode'). Default: rulesync").option("-f, --features <features>", `Comma-separated list of features to fetch (${require_import.ALL_FEATURES.join(",")}) or '*' for all`, parseCommaSeparatedList).option("-r, --ref <ref>", "Branch, tag, or commit SHA to fetch from").option("-p, --path <path>", "Subdirectory path within the repository").option("-o, --output <dir>", "Output directory (default: .rulesync)").option("-c, --conflict <strategy>", "Conflict resolution strategy: skip, overwrite (default: overwrite)").option("--token <token>", "Git provider token for private repositories").option("-V, --verbose", "Verbose output").option("-s, --silent", "Suppress all output").action(wrapCommand("fetch", "FETCH_FAILED", async (logger, options, _globalOpts, positionalArgs) => {
+	program.command("fetch <source>").description("Fetch files from a Git repository (GitHub/GitLab)").option("-t, --target <target>", "Target format to interpret files as (e.g., 'rulesync', 'claudecode'). Default: rulesync").option("-f, --features <features>", `Comma-separated list of features to fetch (${FEATURES_HELP}) or '*' for all. Default: skills`, parseCommaSeparatedList).option("-r, --ref <ref>", "Branch, tag, or commit SHA to fetch from").option("-p, --path <path>", "Subdirectory path within the repository").option("-o, --output <dir>", "Output directory (default: .rulesync)").option("-c, --conflict <strategy>", "Conflict resolution strategy: skip, overwrite (default: overwrite)").option("--token <token>", "Git provider token for private repositories").option("-V, --verbose", "Verbose output").option("-s, --silent", "Suppress all output").action(wrapCommand("fetch", "FETCH_FAILED", async (logger, options, _globalOpts, positionalArgs) => {
 		const source = positionalArgs[0];
 		await fetchCommand(logger, {
 			...options,
 			source
 		});
 	}));
-	program.command("import").description("Import configurations from AI tools to rulesync format").option("-t, --targets <tool>", "Tool to import from (e.g., 'copilot', 'cursor', 'cline')", parseCommaSeparatedList).option("-f, --features <features>", `Comma-separated list of features to import (${require_import.ALL_FEATURES.join(",")}) or '*' for all`, parseCommaSeparatedList).option("-V, --verbose", "Verbose output").option("-s, --silent", "Suppress all output").option("-g, --global", "Import for global(user scope) configuration files").action(wrapCommand("import", "IMPORT_FAILED", async (logger, options) => {
-		await importCommand(logger, options);
+	program.command("import").description("Import configurations from AI tools to rulesync format").option("-t, --targets <tool>", "Tool to import from (e.g., 'copilot', 'cursor', 'cline')", parseCommaSeparatedList).option("-f, --features <features>", `Comma-separated list of features to import (${FEATURES_HELP}) or '*' for all`, parseCommaSeparatedList).option("-V, --verbose", "Verbose output").option("-s, --silent", "Suppress all output").option("-g, --global", "Import for global(user scope) configuration files").option("-o, --output-root <path>", "Root directory containing the tool configuration to import").action(wrapCommand("import", "IMPORT_FAILED", async (logger, options) => {
+		const { outputRoot, ...importOptions } = options;
+		await importCommand(logger, {
+			...importOptions,
+			outputRoots: outputRoot ? [outputRoot] : void 0
+		});
 	}));
-	program.command("convert").description("Convert configurations from one AI tool to other AI tools without writing .rulesync/ files").requiredOption("--from <tool>", "Source tool to convert from (e.g., 'cursor', 'claudecode')").requiredOption("--to <tools>", "Comma-separated list of destination tools (e.g., 'copilot,claudecode')", parseCommaSeparatedList).option("-f, --features <features>", `Comma-separated list of features to convert (${require_import.ALL_FEATURES.join(",")}) or '*' for all`, parseCommaSeparatedList).option("-V, --verbose", "Verbose output").option("-s, --silent", "Suppress all output").option("-g, --global", "Convert for global(user scope) configuration files").option("--dry-run", "Dry run: show changes without writing files").action(wrapCommand("convert", "CONVERT_FAILED", async (logger, options) => {
+	program.command("convert").description("Convert configurations from one AI tool to other AI tools without writing .rulesync/ files").requiredOption("--from <tool>", "Source tool to convert from (e.g., 'cursor', 'claudecode')").requiredOption("--to <tools>", "Comma-separated list of destination tools (e.g., 'copilot,claudecode')", parseCommaSeparatedList).option("-f, --features <features>", `Comma-separated list of features to convert (${FEATURES_HELP}) or '*' for all`, parseCommaSeparatedList).option("-V, --verbose", "Verbose output").option("-s, --silent", "Suppress all output").option("-g, --global", "Convert for global(user scope) configuration files").option("--dry-run", "Dry run: show changes without writing files").action(wrapCommand("convert", "CONVERT_FAILED", async (logger, options) => {
 		await convertCommand(logger, options);
 	}));
 	program.command("mcp").description("Start MCP server for rulesync").action(wrapCommand("mcp", "MCP_FAILED", async (logger, _options) => {
@@ -9056,20 +9050,25 @@ const main = async () => {
 			silent: options.silent
 		});
 	}));
-	program.command("generate").description("Generate configuration files for AI tools").option("-t, --targets <tools>", "Comma-separated list of tools to generate for (e.g., 'copilot,cursor,cline' or '*' for all)", parseCommaSeparatedList).option("-f, --features <features>", `Comma-separated list of features to generate (${require_import.ALL_FEATURES.join(",")}) or '*' for all`, parseCommaSeparatedList).option("--delete", "Delete all existing files in output directories before generating").option("-o, --output-roots <paths>", "Output root directories to generate files into (comma-separated for multiple paths)", parseCommaSeparatedList).option("-V, --verbose", "Verbose output").option("-s, --silent", "Suppress all output").option("-c, --config <path>", "Path to configuration file").option("-g, --global", "Generate for global(user scope) configuration files").option("--simulate-commands", "Generate simulated commands. This feature is only available for copilot, cursor and codexcli.").option("--simulate-subagents", "Generate simulated subagents. This feature is only available for copilot and codexcli.").option("--simulate-skills", "Generate simulated skills. This feature is only available for copilot, cursor and codexcli.").option("--input-root <path>", "Path to the directory containing .rulesync/ (parent of .rulesync/)").option("--dry-run", "Dry run: show changes without writing files").option("--check", "Check if files are up to date (exits with code 1 if changes needed)").action(wrapCommand("generate", "GENERATION_FAILED", async (logger, options) => {
+	program.command("generate").description("Generate configuration files for AI tools").option("-t, --targets <tools>", "Comma-separated list of tools to generate for (e.g., 'copilot,cursor,cline' or '*' for all)", parseCommaSeparatedList).option("-f, --features <features>", `Comma-separated list of features to generate (${FEATURES_HELP}) or '*' for all`, parseCommaSeparatedList).option("--delete", "Delete all existing files in output directories before generating").option("-o, --output-roots <paths>", "Output root directories to generate files into (comma-separated for multiple paths)", parseCommaSeparatedList).option("-V, --verbose", "Verbose output").option("-s, --silent", "Suppress all output").option("-c, --config <path>", "Path to configuration file").option("-g, --global", "Generate for global(user scope) configuration files").option("--simulate-commands", "Generate simulated commands. This feature is only available for copilot, cursor and codexcli.").option("--simulate-subagents", "Generate simulated subagents. This feature is only available for copilot and codexcli.").option("--simulate-skills", "Generate simulated skills. This feature is only available for copilot, cursor and codexcli.").option("--input-root <path>", "Path to the directory containing .rulesync/ (parent of .rulesync/)").option("--dry-run", "Dry run: show changes without writing files").option("--check", "Check if files are up to date (exits with code 1 if changes needed)").action(wrapCommand("generate", "GENERATION_FAILED", async (logger, options) => {
 		await generateCommand(logger, options);
 	}));
 	program.command("update").description("Update rulesync to the latest version").option("--check", "Check for updates without installing").option("--force", "Force update even if already at latest version").option("--token <token>", "GitHub token for API access").option("-V, --verbose", "Verbose output").option("-s, --silent", "Suppress all output").action(wrapCommand("update", "UPDATE_FAILED", async (logger, options) => {
 		await updateCommand(logger, version, options);
 	}));
-	program.parse();
-};
+	return program;
+}
 function parseInstallMode(raw) {
 	if (raw === void 0) return void 0;
 	const match = INSTALL_MODES.find((m) => m === raw);
 	if (!match) throw new Error(`Invalid --mode value "${raw}". Expected one of: ${INSTALL_MODES.join(", ")}.`);
 	return match;
 }
+//#endregion
+//#region src/cli/index.ts
+async function main() {
+	createProgram().parse();
+}
 main().catch((error) => {
 	console.error(require_import.formatError(error));
 	process.exit(1);