rulesync 16.39.1 → 17.1.0

package/dist/{import-DS3OrTAl.cjs → import-BtKWW__v.cjs}

@@ -44319,14 +44319,10 @@ function convertRulesyncToCodexProfile({ config, logger }) {
 		}
 		logger?.warn(`Codex CLI permissions support only read/edit/write/webfetch categories. Skipping: ${toolName}`);
 	}
-	for (const [pattern, access] of mergeFilesystemCategoryRules({
+	addCodexFilesystemRules({
 		categoryRules: filesystemCategoryRules,
-		logger
-	})) addFilesystemRule({
 		filesystem,
 		workspaceRootFilesystem,
-		pattern,
-		access,
 		logger
 	});
 	applyDefaultGitWriteRules({
@@ -44351,6 +44347,29 @@ function convertRulesyncToCodexProfile({ config, logger }) {
 		...network ? { network } : {}
 	};
 }
+function addCodexFilesystemRules({ categoryRules, filesystem, workspaceRootFilesystem, logger }) {
+	for (const rule of mergeFilesystemCategoryRules({
+		categoryRules,
+		logger
+	})) {
+		const access = normalizeCodexFilesystemAccess({
+			pattern: rule.pattern,
+			access: rule.access,
+			writeRestriction: rule.writeRestriction,
+			logger
+		});
+		if (access === void 0) continue;
+		if (access === "read" && rule.writeRestriction === "ask") logger?.warn(`Codex CLI cannot express "ask" for filesystem write permissions: pattern "${rule.pattern}" will be emitted as read-only.`);
+		if (access === "read" && rule.writeRestriction === "deny") logger?.warn(`Codex CLI maps a write-side deny to read-only access: pattern "${rule.pattern}" will be emitted as "read". A broader read deny may be overridden by this more-specific path.`);
+		addFilesystemRule({
+			filesystem,
+			workspaceRootFilesystem,
+			pattern: rule.pattern,
+			access,
+			logger
+		});
+	}
+}
 function applyDefaultGitWriteRules({ config, filesystem, workspaceRootFilesystem }) {
 	if (config.codexcli?.git_write_rules === false) return;
 	if (config.codexcli?.base_permission_profile === CODEX_READ_ONLY_BASELINE) return;
@@ -44500,6 +44519,23 @@ function addFilesystemRule({ filesystem, workspaceRootFilesystem, pattern, acces
 	}
 	workspaceRootFilesystem[pattern] = access;
 }
+function normalizeCodexFilesystemAccess({ pattern, access, writeRestriction, logger }) {
+	if ((access === "read" || access === "write") && hasUnsupportedCodexFilesystemGlob(pattern)) {
+		if (writeRestriction !== void 0) {
+			logger?.warn(`Codex CLI only supports deny access for non-trailing filesystem globs: pattern "${pattern}" will be emitted as "deny" because its write-side ${writeRestriction} restriction cannot be represented as read-only access. Use an exact path or trailing "/**" for read/write access.`);
+			return "deny";
+		}
+		logger?.warn(`Skipping unsupported Codex CLI ${access} filesystem glob "${pattern}"; the base permission profile remains in effect. Use an exact path or trailing "/**" for read/write access.`);
+		return;
+	}
+	return access;
+}
+function hasCodexFilesystemGlob(pattern) {
+	return pattern.includes("*") || pattern.includes("?") || pattern.includes("[") || pattern.includes("]");
+}
+function hasUnsupportedCodexFilesystemGlob(pattern) {
+	return hasCodexFilesystemGlob(pattern.endsWith("/**") ? pattern.slice(0, -3) : pattern);
+}
 function canBeCodexFilesystemRoot(pattern) {
 	return (0, node_path.isAbsolute)(pattern) || /^[A-Za-z]:[\\/]/.test(pattern) || pattern.startsWith("~/") || pattern === "~" || pattern.startsWith(":");
 }
@@ -44636,30 +44672,8 @@ function mapReadAction(action) {
 	return action === "allow" ? "read" : "deny";
 }
 function mapWriteAction(action) {
-	return action === "allow" ? "write" : "deny";
-}
-/**
-* Merge the canonical read/edit/write category rules into one Codex access
-* level per path pattern (Codex models a single `deny` < `read` < `write`
-* level, with no `ask`).
-*
-* - `edit` and `write` collapse onto Codex's write side; when both carry the
-*   same pattern, the more restrictive action wins (`deny` > `ask` > `allow`).
-* - `read: allow` + write-side `allow` → `"write"`.
-* - `read: allow` + write-side non-allow → `"read"` (readable but not
-*   writable — exactly what Codex's `"read"` level expresses).
-* - `read` non-allow → `"deny"` regardless of the write side; a contradictory
-*   write-side `allow` (unreadable but writable is not expressible in Codex)
-*   is warned about.
-* - Single-category patterns keep the existing mapReadAction/mapWriteAction
-*   mappings.
-*
-* Iteration order is read → edit → write with first-seen pattern order, so
-* the emitted table is stable regardless of the authored category order.
-* Note the merge is one-way: `"{path}" = "read"` imports back as
-* `read: allow` only (the explicit write-side deny is implied by Codex's
-* access level and not re-materialized).
-*/
+	return action === "allow" ? "write" : "read";
+}
 function mergeFilesystemCategoryRules({ categoryRules, logger }) {
 	const readRules = categoryRules.read ?? {};
 	const writeSideRestrictiveness = {
@@ -44683,19 +44697,33 @@ function mergeFilesystemCategoryRules({ categoryRules, logger }) {
 		const readAction = readRules[pattern];
 		const writeAction = writeSideRules[pattern];
 		if (readAction === void 0) {
-			merged.push([pattern, mapWriteAction(writeAction)]);
+			merged.push({
+				pattern,
+				access: mapWriteAction(writeAction),
+				...writeAction === "ask" || writeAction === "deny" ? { writeRestriction: writeAction } : {}
+			});
 			continue;
 		}
 		if (writeAction === void 0) {
-			merged.push([pattern, mapReadAction(readAction)]);
+			merged.push({
+				pattern,
+				access: mapReadAction(readAction)
+			});
 			continue;
 		}
 		if (readAction === "allow") {
-			merged.push([pattern, writeAction === "allow" ? "write" : "read"]);
+			merged.push({
+				pattern,
+				access: writeAction === "allow" ? "write" : "read",
+				...writeAction === "ask" || writeAction === "deny" ? { writeRestriction: writeAction } : {}
+			});
 			continue;
 		}
 		if (writeAction === "allow") logger?.warn(`Codex CLI cannot express "writable but not readable": pattern "${pattern}" has read: ${readAction} and a write-side allow. Emitting "deny".`);
-		merged.push([pattern, "deny"]);
+		merged.push({
+			pattern,
+			access: "deny"
+		});
 	}
 	return merged;
 }
@@ -78573,7 +78601,8 @@ const RulesProcessorToolTargetSchema = zod_mini.z.enum(rulesProcessorToolTargetT
 const formatRulePaths = (rules) => rules.map((r) => (0, node_path.join)(r.getRelativeDirPath(), r.getRelativeFilePath())).join(", ");
 const RulesFeatureOptionsSchema = zod_mini.z.looseObject({
 	ruleDiscoveryMode: zod_mini.z.optional(zod_mini.z.enum(["none", "explicit"])),
-	includeLocalRoot: zod_mini.z.optional(zod_mini.z.boolean())
+	includeLocalRoot: zod_mini.z.optional(zod_mini.z.boolean()),
+	includeRoot: zod_mini.z.optional(zod_mini.z.boolean())
 });
 const resolveRuleDiscoveryMode = ({ defaultMode, options }) => {
 	if (defaultMode === "claudecode-legacy") return defaultMode;
@@ -78590,6 +78619,13 @@ const resolveIncludeLocalRoot = (options) => {
 	if (!parsed.success) throw new Error(`Invalid options for rules feature: ${parsed.error.message}. \`includeLocalRoot\` must be a boolean.`);
 	return parsed.data.includeLocalRoot ?? true;
 };
+const IncludeRootSchema = zod_mini.z.looseObject({ includeRoot: zod_mini.z.optional(zod_mini.z.boolean()) });
+const resolveIncludeRoot = (options) => {
+	if (!options) return true;
+	const parsed = IncludeRootSchema.safeParse(options);
+	if (!parsed.success) throw new Error(`Invalid options for rules feature: ${parsed.error.message}. \`includeRoot\` must be a boolean.`);
+	return parsed.data.includeRoot ?? true;
+};
 /**
 * Whether `candidate` is `base` itself or a class that extends it.
 *
@@ -79135,11 +79171,12 @@ var RulesProcessor = class extends FeatureProcessor {
 	async convertRulesyncFilesToToolFiles(rulesyncFiles) {
 		const rulesyncRules = rulesyncFiles.filter((file) => file instanceof RulesyncRule);
 		const alignedRules = this.alignPiContextFile(rulesyncRules);
-		const localRootRules = alignedRules.filter((rule) => rule.getFrontmatter().localRoot);
-		const nonLocalRootRules = alignedRules.filter((rule) => !rule.getFrontmatter().localRoot);
 		const factory = this.getFactory(this.toolTarget);
 		const { meta } = factory;
-		const convertedRules = nonLocalRootRules.map((rulesyncRule) => {
+		this.warnForIncludeRootOption(meta);
+		const emittedRules = this.omitsRootFiles() ? alignedRules.filter((rule) => !rule.getFrontmatter().root && !rule.getFrontmatter().localRoot) : alignedRules;
+		const localRootRules = emittedRules.filter((rule) => rule.getFrontmatter().localRoot);
+		const convertedRules = emittedRules.filter((rule) => !rule.getFrontmatter().localRoot).map((rulesyncRule) => {
 			if (!factory.class.isTargetedByRulesyncRule(rulesyncRule)) return null;
 			return {
 				toolRule: factory.class.fromRulesyncRule({
@@ -79276,6 +79313,57 @@ var RulesProcessor = class extends FeatureProcessor {
 	getPromptBlockLanguage() {
 		return this.isClaudecodeTarget() ? void 0 : this.language;
 	}
+	/**
+	* `includeRoot: false` on the `claudecode` target (project scope only)
+	* drops the root `CLAUDE.md` and the personal `CLAUDE.local.md`, keeping the
+	* non-root `.claude/rules/*.md`. Claude Code falls back to `AGENTS.md` only
+	* when none of `CLAUDE.md`, `.claude/CLAUDE.md` or `CLAUDE.local.md` exists,
+	* so emitting either root file would shadow an `AGENTS.md` written by another
+	* target. Stale root files are swept by the regular orphan deletion because
+	* they are no longer part of the generated output. Global scope keeps the
+	* root file: `~/.claude/CLAUDE.md` never shadows `AGENTS.md`, and Claude Code
+	* reads no global `AGENTS.md` to fall back to. `claudecode-legacy` is not
+	* covered: its `.claude/memories/*.md` are only reachable through the
+	* references listed in the root file.
+	* @see https://code.claude.com/docs/en/memory#when-claude-code-reads-agents-md
+	*/
+	omitsRootFiles() {
+		return this.toolTarget === "claudecode" && !this.global && !resolveIncludeRoot(this.featureOptions);
+	}
+	/**
+	* Warn when `includeRoot: false` is set where it has no effect, or where it
+	* silently disables another option that writes into the root file.
+	*/
+	warnForIncludeRootOption(meta) {
+		if (resolveIncludeRoot(this.featureOptions)) return;
+		if (this.toolTarget !== "claudecode") {
+			this.logger.warn(`The rules option \`includeRoot\` is only supported by the claudecode target; ignoring it for ${this.toolTarget}.`);
+			return;
+		}
+		if (this.global) {
+			this.logger.warn("The rules option `includeRoot: false` has no effect in global mode: ~/.claude/CLAUDE.md does not shadow AGENTS.md, so it is still generated.");
+			return;
+		}
+		if (resolveRuleDiscoveryMode({
+			defaultMode: meta.ruleDiscoveryMode,
+			options: this.featureOptions
+		}) !== "auto") this.logger.warn("The rules option `ruleDiscoveryMode` has no effect with `includeRoot: false` on claudecode: the rule references it adds are written into CLAUDE.md, which is not generated.");
+	}
+	/**
+	* With `includeRoot: false`, a hand-authored root file at an alternative
+	* location (`.claude/CLAUDE.md`, `.claude/CLAUDE.local.md`) still keeps
+	* Claude Code from reading `AGENTS.md`. Rulesync never writes those files, so
+	* it leaves them in place and tells the user instead of deleting them.
+	*/
+	async warnForShadowingAlternativeRoots(alternativeRoots) {
+		const localRootFileName = this.getFactory(this.toolTarget).meta.localRootFileName;
+		const globs = alternativeRoots.flatMap((alt) => [rootRelativeGlob(alt.relativeDirPath, alt.relativeFilePath), ...localRootFileName ? [rootRelativeGlob(alt.relativeDirPath, localRootFileName)] : []]);
+		if (globs.length === 0) return;
+		const filePaths = await findFilesByGlobs(globs, { cwd: this.outputRoot });
+		if (filePaths.length === 0) return;
+		const names = filePaths.map((filePath) => stripControlCharacters((0, node_path.relative)(this.outputRoot, filePath)));
+		this.logger.warn(`${names.join(", ")} still ${names.length === 1 ? "keeps" : "keep"} Claude Code from reading AGENTS.md although \`includeRoot: false\` is set for claudecode. Rulesync does not delete ${names.length === 1 ? "it" : "them"}; remove ${names.length === 1 ? "it" : "them"} by hand once the content is covered by AGENTS.md.`);
+	}
 	isClaudecodeTarget() {
 		return this.toolTarget === "claudecode" || this.toolTarget === "claudecode-legacy";
 	}
@@ -79910,9 +79998,14 @@ As this project's AI coding tool, you must follow the additional conventions bel
 			* Resolved once, up front, so the two blocks that need it do not depend
 			* on each other's evaluation order.
 			*/
+			const omitsRootFiles = this.omitsRootFiles();
 			const primaryRootFilePaths = settablePaths.root ? await findFilesByGlobs(rootRelativeGlob(settablePaths.root.relativeDirPath ?? ".", settablePaths.root.relativeFilePath), { cwd: this.outputRoot }) : [];
 			const rootToolRules = await (async () => {
 				if (!settablePaths.root) return [];
+				if (forDeletion && omitsRootFiles) {
+					await this.warnForShadowingAlternativeRoots(settablePaths.alternativeRoots ?? []);
+					return buildDeletionRulesFromPaths(primaryRootFilePaths);
+				}
 				const uniqueRootFilePaths = await findFilesWithFallback(primaryRootFilePaths, settablePaths.alternativeRoots, (alt) => rootRelativeGlob(alt.relativeDirPath, alt.relativeFilePath), this.outputRoot);
 				if (forDeletion) return buildDeletionRulesFromPaths(uniqueRootFilePaths);
 				return await buildImportRulesFromPaths(uniqueRootFilePaths);
@@ -79924,7 +80017,9 @@ As this project's AI coding tool, you must follow the additional conventions bel
 				const filePaths = await (async () => {
 					if (factory.class.getLocalRootFileGlob) return await findFilesByGlobs(factory.class.getLocalRootFileGlob({ fileName }), { cwd: this.outputRoot });
 					if (!settablePaths.root) return [];
-					return await findFilesWithFallback(await findFilesByGlobs(rootRelativeGlob(settablePaths.root.relativeDirPath ?? ".", fileName), { cwd: this.outputRoot }), settablePaths.alternativeRoots, (alt) => rootRelativeGlob(alt.relativeDirPath, fileName), this.outputRoot);
+					const primaryLocalFilePaths = await findFilesByGlobs(rootRelativeGlob(settablePaths.root.relativeDirPath ?? ".", fileName), { cwd: this.outputRoot });
+					if (forDeletion && omitsRootFiles) return primaryLocalFilePaths;
+					return await findFilesWithFallback(primaryLocalFilePaths, settablePaths.alternativeRoots, (alt) => rootRelativeGlob(alt.relativeDirPath, fileName), this.outputRoot);
 				})();
 				if (forDeletion) return buildDeletionRulesFromPaths(filePaths);
 				return (await Promise.all(filePaths.map(async (filePath) => {

package/dist/{import-B2ANxi1V.js → import-Csmx6n4n.js}

@@ -44294,14 +44294,10 @@ function convertRulesyncToCodexProfile({ config, logger }) {
 		}
 		logger?.warn(`Codex CLI permissions support only read/edit/write/webfetch categories. Skipping: ${toolName}`);
 	}
-	for (const [pattern, access] of mergeFilesystemCategoryRules({
+	addCodexFilesystemRules({
 		categoryRules: filesystemCategoryRules,
-		logger
-	})) addFilesystemRule({
 		filesystem,
 		workspaceRootFilesystem,
-		pattern,
-		access,
 		logger
 	});
 	applyDefaultGitWriteRules({
@@ -44326,6 +44322,29 @@ function convertRulesyncToCodexProfile({ config, logger }) {
 		...network ? { network } : {}
 	};
 }
+function addCodexFilesystemRules({ categoryRules, filesystem, workspaceRootFilesystem, logger }) {
+	for (const rule of mergeFilesystemCategoryRules({
+		categoryRules,
+		logger
+	})) {
+		const access = normalizeCodexFilesystemAccess({
+			pattern: rule.pattern,
+			access: rule.access,
+			writeRestriction: rule.writeRestriction,
+			logger
+		});
+		if (access === void 0) continue;
+		if (access === "read" && rule.writeRestriction === "ask") logger?.warn(`Codex CLI cannot express "ask" for filesystem write permissions: pattern "${rule.pattern}" will be emitted as read-only.`);
+		if (access === "read" && rule.writeRestriction === "deny") logger?.warn(`Codex CLI maps a write-side deny to read-only access: pattern "${rule.pattern}" will be emitted as "read". A broader read deny may be overridden by this more-specific path.`);
+		addFilesystemRule({
+			filesystem,
+			workspaceRootFilesystem,
+			pattern: rule.pattern,
+			access,
+			logger
+		});
+	}
+}
 function applyDefaultGitWriteRules({ config, filesystem, workspaceRootFilesystem }) {
 	if (config.codexcli?.git_write_rules === false) return;
 	if (config.codexcli?.base_permission_profile === CODEX_READ_ONLY_BASELINE) return;
@@ -44475,6 +44494,23 @@ function addFilesystemRule({ filesystem, workspaceRootFilesystem, pattern, acces
 	}
 	workspaceRootFilesystem[pattern] = access;
 }
+function normalizeCodexFilesystemAccess({ pattern, access, writeRestriction, logger }) {
+	if ((access === "read" || access === "write") && hasUnsupportedCodexFilesystemGlob(pattern)) {
+		if (writeRestriction !== void 0) {
+			logger?.warn(`Codex CLI only supports deny access for non-trailing filesystem globs: pattern "${pattern}" will be emitted as "deny" because its write-side ${writeRestriction} restriction cannot be represented as read-only access. Use an exact path or trailing "/**" for read/write access.`);
+			return "deny";
+		}
+		logger?.warn(`Skipping unsupported Codex CLI ${access} filesystem glob "${pattern}"; the base permission profile remains in effect. Use an exact path or trailing "/**" for read/write access.`);
+		return;
+	}
+	return access;
+}
+function hasCodexFilesystemGlob(pattern) {
+	return pattern.includes("*") || pattern.includes("?") || pattern.includes("[") || pattern.includes("]");
+}
+function hasUnsupportedCodexFilesystemGlob(pattern) {
+	return hasCodexFilesystemGlob(pattern.endsWith("/**") ? pattern.slice(0, -3) : pattern);
+}
 function canBeCodexFilesystemRoot(pattern) {
 	return isAbsolute(pattern) || /^[A-Za-z]:[\\/]/.test(pattern) || pattern.startsWith("~/") || pattern === "~" || pattern.startsWith(":");
 }
@@ -44611,30 +44647,8 @@ function mapReadAction(action) {
 	return action === "allow" ? "read" : "deny";
 }
 function mapWriteAction(action) {
-	return action === "allow" ? "write" : "deny";
-}
-/**
-* Merge the canonical read/edit/write category rules into one Codex access
-* level per path pattern (Codex models a single `deny` < `read` < `write`
-* level, with no `ask`).
-*
-* - `edit` and `write` collapse onto Codex's write side; when both carry the
-*   same pattern, the more restrictive action wins (`deny` > `ask` > `allow`).
-* - `read: allow` + write-side `allow` → `"write"`.
-* - `read: allow` + write-side non-allow → `"read"` (readable but not
-*   writable — exactly what Codex's `"read"` level expresses).
-* - `read` non-allow → `"deny"` regardless of the write side; a contradictory
-*   write-side `allow` (unreadable but writable is not expressible in Codex)
-*   is warned about.
-* - Single-category patterns keep the existing mapReadAction/mapWriteAction
-*   mappings.
-*
-* Iteration order is read → edit → write with first-seen pattern order, so
-* the emitted table is stable regardless of the authored category order.
-* Note the merge is one-way: `"{path}" = "read"` imports back as
-* `read: allow` only (the explicit write-side deny is implied by Codex's
-* access level and not re-materialized).
-*/
+	return action === "allow" ? "write" : "read";
+}
 function mergeFilesystemCategoryRules({ categoryRules, logger }) {
 	const readRules = categoryRules.read ?? {};
 	const writeSideRestrictiveness = {
@@ -44658,19 +44672,33 @@ function mergeFilesystemCategoryRules({ categoryRules, logger }) {
 		const readAction = readRules[pattern];
 		const writeAction = writeSideRules[pattern];
 		if (readAction === void 0) {
-			merged.push([pattern, mapWriteAction(writeAction)]);
+			merged.push({
+				pattern,
+				access: mapWriteAction(writeAction),
+				...writeAction === "ask" || writeAction === "deny" ? { writeRestriction: writeAction } : {}
+			});
 			continue;
 		}
 		if (writeAction === void 0) {
-			merged.push([pattern, mapReadAction(readAction)]);
+			merged.push({
+				pattern,
+				access: mapReadAction(readAction)
+			});
 			continue;
 		}
 		if (readAction === "allow") {
-			merged.push([pattern, writeAction === "allow" ? "write" : "read"]);
+			merged.push({
+				pattern,
+				access: writeAction === "allow" ? "write" : "read",
+				...writeAction === "ask" || writeAction === "deny" ? { writeRestriction: writeAction } : {}
+			});
 			continue;
 		}
 		if (writeAction === "allow") logger?.warn(`Codex CLI cannot express "writable but not readable": pattern "${pattern}" has read: ${readAction} and a write-side allow. Emitting "deny".`);
-		merged.push([pattern, "deny"]);
+		merged.push({
+			pattern,
+			access: "deny"
+		});
 	}
 	return merged;
 }
@@ -78548,7 +78576,8 @@ const RulesProcessorToolTargetSchema = z.enum(rulesProcessorToolTargetTuple);
 const formatRulePaths = (rules) => rules.map((r) => join(r.getRelativeDirPath(), r.getRelativeFilePath())).join(", ");
 const RulesFeatureOptionsSchema = z.looseObject({
 	ruleDiscoveryMode: z.optional(z.enum(["none", "explicit"])),
-	includeLocalRoot: z.optional(z.boolean())
+	includeLocalRoot: z.optional(z.boolean()),
+	includeRoot: z.optional(z.boolean())
 });
 const resolveRuleDiscoveryMode = ({ defaultMode, options }) => {
 	if (defaultMode === "claudecode-legacy") return defaultMode;
@@ -78565,6 +78594,13 @@ const resolveIncludeLocalRoot = (options) => {
 	if (!parsed.success) throw new Error(`Invalid options for rules feature: ${parsed.error.message}. \`includeLocalRoot\` must be a boolean.`);
 	return parsed.data.includeLocalRoot ?? true;
 };
+const IncludeRootSchema = z.looseObject({ includeRoot: z.optional(z.boolean()) });
+const resolveIncludeRoot = (options) => {
+	if (!options) return true;
+	const parsed = IncludeRootSchema.safeParse(options);
+	if (!parsed.success) throw new Error(`Invalid options for rules feature: ${parsed.error.message}. \`includeRoot\` must be a boolean.`);
+	return parsed.data.includeRoot ?? true;
+};
 /**
 * Whether `candidate` is `base` itself or a class that extends it.
 *
@@ -79110,11 +79146,12 @@ var RulesProcessor = class extends FeatureProcessor {
 	async convertRulesyncFilesToToolFiles(rulesyncFiles) {
 		const rulesyncRules = rulesyncFiles.filter((file) => file instanceof RulesyncRule);
 		const alignedRules = this.alignPiContextFile(rulesyncRules);
-		const localRootRules = alignedRules.filter((rule) => rule.getFrontmatter().localRoot);
-		const nonLocalRootRules = alignedRules.filter((rule) => !rule.getFrontmatter().localRoot);
 		const factory = this.getFactory(this.toolTarget);
 		const { meta } = factory;
-		const convertedRules = nonLocalRootRules.map((rulesyncRule) => {
+		this.warnForIncludeRootOption(meta);
+		const emittedRules = this.omitsRootFiles() ? alignedRules.filter((rule) => !rule.getFrontmatter().root && !rule.getFrontmatter().localRoot) : alignedRules;
+		const localRootRules = emittedRules.filter((rule) => rule.getFrontmatter().localRoot);
+		const convertedRules = emittedRules.filter((rule) => !rule.getFrontmatter().localRoot).map((rulesyncRule) => {
 			if (!factory.class.isTargetedByRulesyncRule(rulesyncRule)) return null;
 			return {
 				toolRule: factory.class.fromRulesyncRule({
@@ -79251,6 +79288,57 @@ var RulesProcessor = class extends FeatureProcessor {
 	getPromptBlockLanguage() {
 		return this.isClaudecodeTarget() ? void 0 : this.language;
 	}
+	/**
+	* `includeRoot: false` on the `claudecode` target (project scope only)
+	* drops the root `CLAUDE.md` and the personal `CLAUDE.local.md`, keeping the
+	* non-root `.claude/rules/*.md`. Claude Code falls back to `AGENTS.md` only
+	* when none of `CLAUDE.md`, `.claude/CLAUDE.md` or `CLAUDE.local.md` exists,
+	* so emitting either root file would shadow an `AGENTS.md` written by another
+	* target. Stale root files are swept by the regular orphan deletion because
+	* they are no longer part of the generated output. Global scope keeps the
+	* root file: `~/.claude/CLAUDE.md` never shadows `AGENTS.md`, and Claude Code
+	* reads no global `AGENTS.md` to fall back to. `claudecode-legacy` is not
+	* covered: its `.claude/memories/*.md` are only reachable through the
+	* references listed in the root file.
+	* @see https://code.claude.com/docs/en/memory#when-claude-code-reads-agents-md
+	*/
+	omitsRootFiles() {
+		return this.toolTarget === "claudecode" && !this.global && !resolveIncludeRoot(this.featureOptions);
+	}
+	/**
+	* Warn when `includeRoot: false` is set where it has no effect, or where it
+	* silently disables another option that writes into the root file.
+	*/
+	warnForIncludeRootOption(meta) {
+		if (resolveIncludeRoot(this.featureOptions)) return;
+		if (this.toolTarget !== "claudecode") {
+			this.logger.warn(`The rules option \`includeRoot\` is only supported by the claudecode target; ignoring it for ${this.toolTarget}.`);
+			return;
+		}
+		if (this.global) {
+			this.logger.warn("The rules option `includeRoot: false` has no effect in global mode: ~/.claude/CLAUDE.md does not shadow AGENTS.md, so it is still generated.");
+			return;
+		}
+		if (resolveRuleDiscoveryMode({
+			defaultMode: meta.ruleDiscoveryMode,
+			options: this.featureOptions
+		}) !== "auto") this.logger.warn("The rules option `ruleDiscoveryMode` has no effect with `includeRoot: false` on claudecode: the rule references it adds are written into CLAUDE.md, which is not generated.");
+	}
+	/**
+	* With `includeRoot: false`, a hand-authored root file at an alternative
+	* location (`.claude/CLAUDE.md`, `.claude/CLAUDE.local.md`) still keeps
+	* Claude Code from reading `AGENTS.md`. Rulesync never writes those files, so
+	* it leaves them in place and tells the user instead of deleting them.
+	*/
+	async warnForShadowingAlternativeRoots(alternativeRoots) {
+		const localRootFileName = this.getFactory(this.toolTarget).meta.localRootFileName;
+		const globs = alternativeRoots.flatMap((alt) => [rootRelativeGlob(alt.relativeDirPath, alt.relativeFilePath), ...localRootFileName ? [rootRelativeGlob(alt.relativeDirPath, localRootFileName)] : []]);
+		if (globs.length === 0) return;
+		const filePaths = await findFilesByGlobs(globs, { cwd: this.outputRoot });
+		if (filePaths.length === 0) return;
+		const names = filePaths.map((filePath) => stripControlCharacters(relative(this.outputRoot, filePath)));
+		this.logger.warn(`${names.join(", ")} still ${names.length === 1 ? "keeps" : "keep"} Claude Code from reading AGENTS.md although \`includeRoot: false\` is set for claudecode. Rulesync does not delete ${names.length === 1 ? "it" : "them"}; remove ${names.length === 1 ? "it" : "them"} by hand once the content is covered by AGENTS.md.`);
+	}
 	isClaudecodeTarget() {
 		return this.toolTarget === "claudecode" || this.toolTarget === "claudecode-legacy";
 	}
@@ -79885,9 +79973,14 @@ As this project's AI coding tool, you must follow the additional conventions bel
 			* Resolved once, up front, so the two blocks that need it do not depend
 			* on each other's evaluation order.
 			*/
+			const omitsRootFiles = this.omitsRootFiles();
 			const primaryRootFilePaths = settablePaths.root ? await findFilesByGlobs(rootRelativeGlob(settablePaths.root.relativeDirPath ?? ".", settablePaths.root.relativeFilePath), { cwd: this.outputRoot }) : [];
 			const rootToolRules = await (async () => {
 				if (!settablePaths.root) return [];
+				if (forDeletion && omitsRootFiles) {
+					await this.warnForShadowingAlternativeRoots(settablePaths.alternativeRoots ?? []);
+					return buildDeletionRulesFromPaths(primaryRootFilePaths);
+				}
 				const uniqueRootFilePaths = await findFilesWithFallback(primaryRootFilePaths, settablePaths.alternativeRoots, (alt) => rootRelativeGlob(alt.relativeDirPath, alt.relativeFilePath), this.outputRoot);
 				if (forDeletion) return buildDeletionRulesFromPaths(uniqueRootFilePaths);
 				return await buildImportRulesFromPaths(uniqueRootFilePaths);
@@ -79899,7 +79992,9 @@ As this project's AI coding tool, you must follow the additional conventions bel
 				const filePaths = await (async () => {
 					if (factory.class.getLocalRootFileGlob) return await findFilesByGlobs(factory.class.getLocalRootFileGlob({ fileName }), { cwd: this.outputRoot });
 					if (!settablePaths.root) return [];
-					return await findFilesWithFallback(await findFilesByGlobs(rootRelativeGlob(settablePaths.root.relativeDirPath ?? ".", fileName), { cwd: this.outputRoot }), settablePaths.alternativeRoots, (alt) => rootRelativeGlob(alt.relativeDirPath, fileName), this.outputRoot);
+					const primaryLocalFilePaths = await findFilesByGlobs(rootRelativeGlob(settablePaths.root.relativeDirPath ?? ".", fileName), { cwd: this.outputRoot });
+					if (forDeletion && omitsRootFiles) return primaryLocalFilePaths;
+					return await findFilesWithFallback(primaryLocalFilePaths, settablePaths.alternativeRoots, (alt) => rootRelativeGlob(alt.relativeDirPath, fileName), this.outputRoot);
 				})();
 				if (forDeletion) return buildDeletionRulesFromPaths(filePaths);
 				return (await Promise.all(filePaths.map(async (filePath) => {
@@ -82224,4 +82319,4 @@ async function importChecksCore(params) {
 //#endregion
 export { RulesyncCommand as $, toPosixPath as $t, CLAUDECODE_MEMORIES_DIR_NAME as A, RULESYNC_XDG_CONFIG_HOME_DEFAULT_DIR_NAME as An, checkPathTraversal as At, RulesyncSubagent as B, stripControlCharacters as Bn, listDirectoryEntryNames as Bt, COMMANDCODE_DIR as C, RULESYNC_PERMISSIONS_SCHEMA_URL as Cn, withWarnOnceScope as Ct, CODEXCLI_DIR as D, RULESYNC_SOURCES_LOCK_RELATIVE_FILE_PATH as Dn, assertDirectoryIfExists as Dt, CODEXCLI_BASH_RULES_FILE_NAME as E, RULESYNC_SKILLS_RELATIVE_DIR_PATH as En, applyFileMode as Et, caseFoldIdentity as F, formatError as Fn, getFileSize as Ft, RulesyncRuleFrontmatterSchema as G, readFileContentOrNull as Gt, RulesyncSkill as H, stripHiddenCharacters as Hn, listSubdirectoryNames as Ht, groupSpellingsByCaseFoldedIdentity as I, truncateText as In, getHomeDirectory as It, RulesyncIgnore as J, removeFile as Jt, RulesyncPermissions as K, removeDirectory as Kt, AUGMENTCODE_DIR as L, hasDeceptiveHiddenCharacters as Ln, isFileNotFoundError as Lt, CLAUDECODE_SKILLS_DIR_PATH as M, ALL_FEATURES as Mn, directoryExists as Mt, FACTORYDROID_DIR as N, ALL_FEATURES_WITH_WILDCARD as Nn, ensureDir as Nt, CLAUDECODE_DIR as O, RULESYNC_SUBAGENTS_RELATIVE_DIR_PATH as On, assertTreeContainsNoSymlinks as Ot, FACTORYDROID_SETTINGS_LOCAL_FILE_NAME as P, DEPRECATED_FEATURE_REPLACEMENTS as Pn, fileExists as Pt, parseJsonc as Q, runWithDirectoryRollback as Qt, AUGMENTCODE_SETTINGS_LOCAL_FILE_NAME as R, hasEnclosingMarkOutsideKeycap as Rn, isFileSystemError as Rt, QWENCODE_LOCAL_RULE_FILE_NAME as S, RULESYNC_PERMISSIONS_RELATIVE_FILE_PATH as Sn, resetRunWarningState as St, ChecksProcessor as T, RULESYNC_RULES_RELATIVE_DIR_PATH as Tn, ErrorCodes as Tt, RulesyncSkillFrontmatterSchema as U, pathEscapesRoot as Ut, RulesyncSubagentFrontmatterSchema as V, stripControlCharactersKeepingLineFeeds as Vn, listFilePathsRecursively as Vt, RulesyncRule as W, readFileContent as Wt, getRulesyncSourceCandidates as X, removeTempDirectory as Xt, RulesyncHooks as Y, removeFileStrict as Yt, resolveRulesyncSourceWritePath as Z, resolvePath as Zt, IgnoreProcessor as _, RULESYNC_IGNORE_RELATIVE_FILE_PATH as _n, JsonLogger as _t, getProcessorRegistryEntry as a, ToolTargetSchema as an, SHARED_USER_MANAGED_CONFIG_PATHS as at, CommandsProcessor as b, RULESYNC_MCP_SCHEMA_URL as bn, warnOnConflictingFlags as bt, RulesProcessor as c, MAX_FILE_SIZE as cn, mergeInputRootConfigs as ct, CODEBUDDY_DIR as d, RULESYNC_COMMANDS_RELATIVE_DIR_PATH as dn, ConfigFileSchema as dt, writeFileBuffer as en, RulesyncCommandFrontmatterSchema as et, CODEBUDDY_LOCAL_RULE_FILE_NAME as f, RULESYNC_CONFIG_RELATIVE_FILE_PATH as fn, GITIGNORE_DESTINATION_KEY as ft, McpProcessor as g, RULESYNC_HOOKS_RELATIVE_FILE_PATH as gn, ConsoleLogger as gt, shortenToWidth as h, RULESYNC_CURATED_SKILLS_RELATIVE_DIR_PATH as hn, findControlCharacter as ht, inspectInputRoots as i, PACKAGING_TOOL_TARGETS as in, loadYaml as it, CLAUDECODE_SETTINGS_LOCAL_FILE_NAME as j, parseCommaSeparatedList as jn, createTempDirectory as jt, CLAUDECODE_LOCAL_RULE_FILE_NAME as k, RULESYNC_USER_CONFIG_DIR_NAME as kn, assertWritablePathInsideRoot as kt, SubagentsProcessor as l, RULESYNC_AIIGNORE_RELATIVE_FILE_PATH as ln, resolveEffectiveInputRoots as lt, displayWidthOf as m, RULESYNC_CURATED_RULES_RELATIVE_DIR_PATH as mn, assertTargetsFeaturesExclusive as mt, formatSourceLoadFailure as n, ALL_TOOL_TARGETS as nn, RulesyncCheckFrontmatterSchema as nt, convertFromTool as o, CURATED_RULES_FEATURE_SUBDIR as on, SKILL_FILE_NAME as ot, ELLIPSIS_WIDTH as p, RULESYNC_CONFIG_SCHEMA_URL as pn, SourceEntrySchema as pt, RulesyncMcp as q, removeDirectoryStrict as qt, generate as r, ALL_TOOL_TARGETS_WITH_WILDCARD as rn, stringifyFrontmatter as rt, isPackagingToolTarget as s, FEATURE_SOURCE_TREE_ENTRIES as sn, ConfigResolver as st, importFromTool as t, writeFileContent as tn, RulesyncCheck as tt, SkillsProcessor as u, RULESYNC_CHECKS_RELATIVE_DIR_PATH as un, CONFLICTING_TARGET_PAIRS as ut, HooksProcessor as v, RULESYNC_LOCAL_CONFIG_RELATIVE_FILE_PATH as vn, WarningCollectingLogger as vt, COMMANDCODE_SETTINGS_LOCAL_FILE_NAME as w, RULESYNC_RELATIVE_DIR_PATH as wn, CLIError as wt, QWENCODE_DIR as x, RULESYNC_NPM_SOURCES_LOCK_RELATIVE_FILE_PATH as xn, withFallbackLoggerTarget as xt, CRUSH_LOCAL_RULE_FILE_NAME as y, RULESYNC_MCP_RELATIVE_FILE_PATH as yn, fallbackLogger as yt, getLocalSkillDirNames as z, quoteForLog as zn, isSymlink as zt };
 
-//# sourceMappingURL=import-B2ANxi1V.js.map
+//# sourceMappingURL=import-Csmx6n4n.js.map