rulesync 7.12.0 → 7.12.2

package/dist/{chunk-WAWBAZPA.js → chunk-VAGOPUDS.js}

@@ -906,7 +906,7 @@ var ToolCommand = class extends AiFile {
 
 // src/features/commands/simulated-command.ts
 var SimulatedCommandFrontmatterSchema = z4.object({
-  description: z4.string()
+  description: z4.optional(z4.string())
 });
 var SimulatedCommand = class _SimulatedCommand extends ToolCommand {
   frontmatter;
@@ -1093,7 +1093,7 @@ var RulesyncFile = class extends AiFile {
 // src/features/commands/rulesync-command.ts
 var RulesyncCommandFrontmatterSchema = z5.looseObject({
   targets: z5._default(RulesyncTargetsSchema, ["*"]),
-  description: z5.string()
+  description: z5.optional(z5.string())
 });
 var RulesyncCommand = class _RulesyncCommand extends RulesyncFile {
   frontmatter;
@@ -1181,7 +1181,7 @@ var AntigravityWorkflowFrontmatterSchema = z6.looseObject({
   turbo: z6.optional(z6.boolean())
 });
 var AntigravityCommandFrontmatterSchema = z6.looseObject({
-  description: z6.string(),
+  description: z6.optional(z6.string()),
   // Support for workflow-specific configuration
   ...AntigravityWorkflowFrontmatterSchema.shape
 });
@@ -1354,7 +1354,7 @@ ${body}${turboDirective}`;
 import { join as join8 } from "path";
 import { z as z7 } from "zod/mini";
 var ClaudecodeCommandFrontmatterSchema = z7.looseObject({
-  description: z7.string(),
+  description: z7.optional(z7.string()),
   "allowed-tools": z7.optional(z7.union([z7.string(), z7.array(z7.string())])),
   "argument-hint": z7.optional(z7.string()),
   model: z7.optional(z7.string()),
@@ -1509,8 +1509,7 @@ var ClineCommand = class _ClineCommand extends ToolCommand {
   }
   toRulesyncCommand() {
     const rulesyncFrontmatter = {
-      targets: ["*"],
-      description: ""
+      targets: ["*"]
     };
     return new RulesyncCommand({
       baseDir: process.cwd(),
@@ -1595,8 +1594,7 @@ var CodexcliCommand = class _CodexcliCommand extends ToolCommand {
   }
   toRulesyncCommand() {
     const rulesyncFrontmatter = {
-      targets: ["*"],
-      description: ""
+      targets: ["*"]
     };
     return new RulesyncCommand({
       baseDir: ".",
@@ -1674,7 +1672,7 @@ import { join as join11 } from "path";
 import { z as z8 } from "zod/mini";
 var CopilotCommandFrontmatterSchema = z8.looseObject({
   mode: z8.optional(z8.string()),
-  description: z8.string()
+  description: z8.optional(z8.string())
 });
 var CopilotCommand = class _CopilotCommand extends ToolCommand {
   frontmatter;
@@ -1857,7 +1855,7 @@ var CursorCommand = class _CursorCommand extends ToolCommand {
     return this.frontmatter;
   }
   toRulesyncCommand() {
-    const { description = "", ...restFields } = this.frontmatter;
+    const { description, ...restFields } = this.frontmatter;
     const rulesyncFrontmatter = {
       targets: ["*"],
       description,
@@ -2051,7 +2049,7 @@ var GeminiCliCommand = class _GeminiCliCommand extends ToolCommand {
       }
       return {
         ...result.data,
-        description: result.data.description || ""
+        description: result.data.description
       };
     } catch (error) {
       throw new Error(
@@ -2073,7 +2071,7 @@ var GeminiCliCommand = class _GeminiCliCommand extends ToolCommand {
     const { description, prompt: _prompt, ...restFields } = this.frontmatter;
     const rulesyncFrontmatter = {
       targets: ["geminicli"],
-      description: description ?? "",
+      description,
       // Preserve extra fields in geminicli section (excluding prompt which is the body)
       ...Object.keys(restFields).length > 0 && { geminicli: restFields }
     };
@@ -2102,8 +2100,9 @@ var GeminiCliCommand = class _GeminiCliCommand extends ToolCommand {
       prompt: rulesyncCommand.getBody(),
       ...geminicliFields
     };
-    const tomlContent = `description = "${geminiFrontmatter.description}"
-prompt = """
+    const descriptionLine = geminiFrontmatter.description !== void 0 ? `description = "${geminiFrontmatter.description}"
+` : "";
+    const tomlContent = `${descriptionLine}prompt = """
 ${geminiFrontmatter.prompt}
 """`;
     const paths = this.getSettablePaths({ global });
@@ -2173,8 +2172,7 @@ var KiloCommand = class _KiloCommand extends ToolCommand {
   }
   toRulesyncCommand() {
     const rulesyncFrontmatter = {
-      targets: ["*"],
-      description: ""
+      targets: ["*"]
     };
     return new RulesyncCommand({
       baseDir: process.cwd(),
@@ -2254,8 +2252,7 @@ var KiroCommand = class _KiroCommand extends ToolCommand {
   }
   toRulesyncCommand() {
     const rulesyncFrontmatter = {
-      targets: ["*"],
-      description: ""
+      targets: ["*"]
     };
     return new RulesyncCommand({
       baseDir: process.cwd(),
@@ -2329,7 +2326,7 @@ var KiroCommand = class _KiroCommand extends ToolCommand {
 import { join as join17 } from "path";
 import { optional as optional2, z as z11 } from "zod/mini";
 var OpenCodeCommandFrontmatterSchema = z11.looseObject({
-  description: z11.string(),
+  description: z11.optional(z11.string()),
   agent: optional2(z11.string()),
   subtask: optional2(z11.boolean()),
   model: optional2(z11.string())
@@ -2469,7 +2466,7 @@ var OpenCodeCommand = class _OpenCodeCommand extends ToolCommand {
 import { join as join18 } from "path";
 import { optional as optional3, z as z12 } from "zod/mini";
 var RooCommandFrontmatterSchema = z12.looseObject({
-  description: z12.string(),
+  description: z12.optional(z12.string()),
   "argument-hint": optional3(z12.string())
 });
 var RooCommand = class _RooCommand extends ToolCommand {
@@ -3008,7 +3005,7 @@ var HookDefinitionSchema = z14.looseObject({
   type: z14.optional(z14.enum(["command", "prompt"])),
   timeout: z14.optional(z14.number()),
   matcher: z14.optional(safeString),
-  prompt: z14.optional(z14.string()),
+  prompt: z14.optional(safeString),
   loop_limit: z14.optional(z14.nullable(z14.number())),
   name: z14.optional(safeString),
   description: z14.optional(safeString)
@@ -3060,7 +3057,7 @@ var OPENCODE_HOOK_EVENTS = [
 var COPILOT_HOOK_EVENTS = [
   "sessionStart",
   "sessionEnd",
-  "afterSubmitPrompt",
+  "beforeSubmitPrompt",
   "preToolUse",
   "postToolUse",
   "afterError"
@@ -3171,7 +3168,7 @@ var CANONICAL_TO_OPENCODE_EVENT_NAMES = {
 var CANONICAL_TO_COPILOT_EVENT_NAMES = {
   sessionStart: "sessionStart",
   sessionEnd: "sessionEnd",
-  afterSubmitPrompt: "userPromptSubmitted",
+  beforeSubmitPrompt: "userPromptSubmitted",
   preToolUse: "preToolUse",
   postToolUse: "postToolUse",
   afterError: "errorOccurred"
@@ -3199,6 +3196,107 @@ var GEMINICLI_TO_CANONICAL_EVENT_NAMES = Object.fromEntries(
 // src/features/hooks/claudecode-hooks.ts
 import { join as join21 } from "path";
 
+// src/features/hooks/tool-hooks-converter.ts
+function isToolMatcherEntry(x) {
+  if (x === null || typeof x !== "object") {
+    return false;
+  }
+  if ("matcher" in x && typeof x.matcher !== "string") {
+    return false;
+  }
+  if ("hooks" in x && !Array.isArray(x.hooks)) {
+    return false;
+  }
+  return true;
+}
+function canonicalToToolHooks({
+  config,
+  toolOverrideHooks,
+  converterConfig
+}) {
+  const supported = new Set(converterConfig.supportedEvents);
+  const sharedHooks = {};
+  for (const [event, defs] of Object.entries(config.hooks)) {
+    if (supported.has(event)) {
+      sharedHooks[event] = defs;
+    }
+  }
+  const effectiveHooks = {
+    ...sharedHooks,
+    ...toolOverrideHooks
+  };
+  const result = {};
+  for (const [eventName, definitions] of Object.entries(effectiveHooks)) {
+    const toolEventName = converterConfig.canonicalToToolEventNames[eventName] ?? eventName;
+    const byMatcher = /* @__PURE__ */ new Map();
+    for (const def of definitions) {
+      const key = def.matcher ?? "";
+      const list = byMatcher.get(key);
+      if (list) list.push(def);
+      else byMatcher.set(key, [def]);
+    }
+    const entries = [];
+    for (const [matcherKey, defs] of byMatcher) {
+      const hooks = defs.map((def) => {
+        const commandText = def.command;
+        const trimmedCommand = typeof commandText === "string" ? commandText.trimStart() : void 0;
+        const shouldPrefix = typeof trimmedCommand === "string" && !trimmedCommand.startsWith("$") && (!converterConfig.prefixDotRelativeCommandsOnly || trimmedCommand.startsWith("."));
+        const command = shouldPrefix && typeof trimmedCommand === "string" ? `${converterConfig.projectDirVar}/${trimmedCommand.replace(/^\.\//, "")}` : def.command;
+        return {
+          type: def.type ?? "command",
+          ...command !== void 0 && command !== null && { command },
+          ...def.timeout !== void 0 && def.timeout !== null && { timeout: def.timeout },
+          ...def.prompt !== void 0 && def.prompt !== null && { prompt: def.prompt }
+        };
+      });
+      entries.push(matcherKey ? { matcher: matcherKey, hooks } : { hooks });
+    }
+    result[toolEventName] = entries;
+  }
+  return result;
+}
+function toolHooksToCanonical({
+  hooks,
+  converterConfig
+}) {
+  if (hooks === null || hooks === void 0 || typeof hooks !== "object") {
+    return {};
+  }
+  const canonical = {};
+  for (const [toolEventName, matcherEntries] of Object.entries(hooks)) {
+    const eventName = converterConfig.toolToCanonicalEventNames[toolEventName] ?? toolEventName;
+    if (!Array.isArray(matcherEntries)) continue;
+    const defs = [];
+    for (const rawEntry of matcherEntries) {
+      if (!isToolMatcherEntry(rawEntry)) continue;
+      const hookDefs = rawEntry.hooks ?? [];
+      for (const h of hookDefs) {
+        const cmd = typeof h.command === "string" ? h.command : void 0;
+        const command = typeof cmd === "string" && cmd.includes(`${converterConfig.projectDirVar}/`) ? cmd.replace(
+          new RegExp(
+            `^${converterConfig.projectDirVar.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\\/?`
+          ),
+          "./"
+        ) : cmd;
+        const hookType = h.type === "command" || h.type === "prompt" ? h.type : "command";
+        const timeout = typeof h.timeout === "number" ? h.timeout : void 0;
+        const prompt = typeof h.prompt === "string" ? h.prompt : void 0;
+        defs.push({
+          type: hookType,
+          ...command !== void 0 && command !== null && { command },
+          ...timeout !== void 0 && timeout !== null && { timeout },
+          ...prompt !== void 0 && prompt !== null && { prompt },
+          ...rawEntry.matcher !== void 0 && rawEntry.matcher !== null && rawEntry.matcher !== "" && { matcher: rawEntry.matcher }
+        });
+      }
+    }
+    if (defs.length > 0) {
+      canonical[eventName] = defs;
+    }
+  }
+  return canonical;
+}
+
 // src/types/tool-file.ts
 var ToolFile = class extends AiFile {
 };
@@ -3289,91 +3387,13 @@ var ToolHooks = class extends ToolFile {
 };
 
 // src/features/hooks/claudecode-hooks.ts
-function canonicalToClaudeHooks(config) {
-  const claudeSupported = new Set(CLAUDE_HOOK_EVENTS);
-  const sharedHooks = {};
-  for (const [event, defs] of Object.entries(config.hooks)) {
-    if (claudeSupported.has(event)) {
-      sharedHooks[event] = defs;
-    }
-  }
-  const effectiveHooks = {
-    ...sharedHooks,
-    ...config.claudecode?.hooks
-  };
-  const claude = {};
-  for (const [eventName, definitions] of Object.entries(effectiveHooks)) {
-    const claudeEventName = CANONICAL_TO_CLAUDE_EVENT_NAMES[eventName] ?? eventName;
-    const byMatcher = /* @__PURE__ */ new Map();
-    for (const def of definitions) {
-      const key = def.matcher ?? "";
-      const list = byMatcher.get(key);
-      if (list) list.push(def);
-      else byMatcher.set(key, [def]);
-    }
-    const entries = [];
-    for (const [matcherKey, defs] of byMatcher) {
-      const hooks = defs.map((def) => {
-        const command = def.command !== void 0 && def.command !== null && !def.command.startsWith("$") ? `$CLAUDE_PROJECT_DIR/${def.command.replace(/^\.\//, "")}` : def.command;
-        return {
-          type: def.type ?? "command",
-          ...command !== void 0 && command !== null && { command },
-          ...def.timeout !== void 0 && def.timeout !== null && { timeout: def.timeout },
-          ...def.prompt !== void 0 && def.prompt !== null && { prompt: def.prompt }
-        };
-      });
-      entries.push(matcherKey ? { matcher: matcherKey, hooks } : { hooks });
-    }
-    claude[claudeEventName] = entries;
-  }
-  return claude;
-}
-function isClaudeMatcherEntry(x) {
-  if (x === null || typeof x !== "object") {
-    return false;
-  }
-  if ("matcher" in x && typeof x.matcher !== "string") {
-    return false;
-  }
-  if ("hooks" in x && !Array.isArray(x.hooks)) {
-    return false;
-  }
-  return true;
-}
-function claudeHooksToCanonical(claudeHooks) {
-  if (claudeHooks === null || claudeHooks === void 0 || typeof claudeHooks !== "object") {
-    return {};
-  }
-  const canonical = {};
-  for (const [claudeEventName, matcherEntries] of Object.entries(claudeHooks)) {
-    const eventName = CLAUDE_TO_CANONICAL_EVENT_NAMES[claudeEventName] ?? claudeEventName;
-    if (!Array.isArray(matcherEntries)) continue;
-    const defs = [];
-    for (const rawEntry of matcherEntries) {
-      if (!isClaudeMatcherEntry(rawEntry)) continue;
-      const entry = rawEntry;
-      const hooks = entry.hooks ?? [];
-      for (const h of hooks) {
-        const cmd = typeof h.command === "string" ? h.command : void 0;
-        const command = typeof cmd === "string" && cmd.includes("$CLAUDE_PROJECT_DIR/") ? cmd.replace(/^\$CLAUDE_PROJECT_DIR\/?/, "./") : cmd;
-        const hookType = h.type === "command" || h.type === "prompt" ? h.type : "command";
-        const timeout = typeof h.timeout === "number" ? h.timeout : void 0;
-        const prompt = typeof h.prompt === "string" ? h.prompt : void 0;
-        defs.push({
-          type: hookType,
-          ...command !== void 0 && command !== null && { command },
-          ...timeout !== void 0 && timeout !== null && { timeout },
-          ...prompt !== void 0 && prompt !== null && { prompt },
-          ...entry.matcher !== void 0 && entry.matcher !== null && entry.matcher !== "" && { matcher: entry.matcher }
-        });
-      }
-    }
-    if (defs.length > 0) {
-      canonical[eventName] = defs;
-    }
-  }
-  return canonical;
-}
+var CLAUDE_CONVERTER_CONFIG = {
+  supportedEvents: CLAUDE_HOOK_EVENTS,
+  canonicalToToolEventNames: CANONICAL_TO_CLAUDE_EVENT_NAMES,
+  toolToCanonicalEventNames: CLAUDE_TO_CANONICAL_EVENT_NAMES,
+  projectDirVar: "$CLAUDE_PROJECT_DIR",
+  prefixDotRelativeCommandsOnly: true
+};
 var ClaudecodeHooks = class _ClaudecodeHooks extends ToolHooks {
   constructor(params) {
     super({
@@ -3425,7 +3445,11 @@ var ClaudecodeHooks = class _ClaudecodeHooks extends ToolHooks {
       );
     }
     const config = rulesyncHooks.getJson();
-    const claudeHooks = canonicalToClaudeHooks(config);
+    const claudeHooks = canonicalToToolHooks({
+      config,
+      toolOverrideHooks: config.claudecode?.hooks,
+      converterConfig: CLAUDE_CONVERTER_CONFIG
+    });
     const merged = { ...settings, hooks: claudeHooks };
     const fileContent = JSON.stringify(merged, null, 2);
     return new _ClaudecodeHooks({
@@ -3448,7 +3472,10 @@ var ClaudecodeHooks = class _ClaudecodeHooks extends ToolHooks {
         }
       );
     }
-    const hooks = claudeHooksToCanonical(settings.hooks);
+    const hooks = toolHooksToCanonical({
+      hooks: settings.hooks,
+      converterConfig: CLAUDE_CONVERTER_CONFIG
+    });
     return this.toRulesyncHooksDefault({
       fileContent: JSON.stringify({ version: 1, hooks }, null, 2)
     });
@@ -3757,91 +3784,12 @@ var CursorHooks = class _CursorHooks extends ToolHooks {
 
 // src/features/hooks/factorydroid-hooks.ts
 import { join as join24 } from "path";
-function canonicalToFactorydroidHooks(config) {
-  const supported = new Set(FACTORYDROID_HOOK_EVENTS);
-  const sharedHooks = {};
-  for (const [event, defs] of Object.entries(config.hooks)) {
-    if (supported.has(event)) {
-      sharedHooks[event] = defs;
-    }
-  }
-  const effectiveHooks = {
-    ...sharedHooks,
-    ...config.factorydroid?.hooks
-  };
-  const result = {};
-  for (const [eventName, definitions] of Object.entries(effectiveHooks)) {
-    const pascalEventName = CANONICAL_TO_FACTORYDROID_EVENT_NAMES[eventName] ?? eventName;
-    const byMatcher = /* @__PURE__ */ new Map();
-    for (const def of definitions) {
-      const key = def.matcher ?? "";
-      const list = byMatcher.get(key);
-      if (list) list.push(def);
-      else byMatcher.set(key, [def]);
-    }
-    const entries = [];
-    for (const [matcherKey, defs] of byMatcher) {
-      const hooks = defs.map((def) => {
-        const command = def.command !== void 0 && def.command !== null && !def.command.startsWith("$") ? `$FACTORY_PROJECT_DIR/${def.command.replace(/^\.\//, "")}` : def.command;
-        return {
-          type: def.type ?? "command",
-          ...command !== void 0 && command !== null && { command },
-          ...def.timeout !== void 0 && def.timeout !== null && { timeout: def.timeout },
-          ...def.prompt !== void 0 && def.prompt !== null && { prompt: def.prompt }
-        };
-      });
-      entries.push(matcherKey ? { matcher: matcherKey, hooks } : { hooks });
-    }
-    result[pascalEventName] = entries;
-  }
-  return result;
-}
-function isFactorydroidMatcherEntry(x) {
-  if (x === null || typeof x !== "object") {
-    return false;
-  }
-  if ("matcher" in x && typeof x.matcher !== "string") {
-    return false;
-  }
-  if ("hooks" in x && !Array.isArray(x.hooks)) {
-    return false;
-  }
-  return true;
-}
-function factorydroidHooksToCanonical(hooks) {
-  if (hooks === null || hooks === void 0 || typeof hooks !== "object") {
-    return {};
-  }
-  const canonical = {};
-  for (const [pascalEventName, matcherEntries] of Object.entries(hooks)) {
-    const eventName = FACTORYDROID_TO_CANONICAL_EVENT_NAMES[pascalEventName] ?? pascalEventName;
-    if (!Array.isArray(matcherEntries)) continue;
-    const defs = [];
-    for (const rawEntry of matcherEntries) {
-      if (!isFactorydroidMatcherEntry(rawEntry)) continue;
-      const entry = rawEntry;
-      const hookDefs = entry.hooks ?? [];
-      for (const h of hookDefs) {
-        const cmd = typeof h.command === "string" ? h.command : void 0;
-        const command = typeof cmd === "string" && cmd.includes("$FACTORY_PROJECT_DIR/") ? cmd.replace(/^\$FACTORY_PROJECT_DIR\/?/, "./") : cmd;
-        const hookType = h.type === "command" || h.type === "prompt" ? h.type : "command";
-        const timeout = typeof h.timeout === "number" ? h.timeout : void 0;
-        const prompt = typeof h.prompt === "string" ? h.prompt : void 0;
-        defs.push({
-          type: hookType,
-          ...command !== void 0 && command !== null && { command },
-          ...timeout !== void 0 && timeout !== null && { timeout },
-          ...prompt !== void 0 && prompt !== null && { prompt },
-          ...entry.matcher !== void 0 && entry.matcher !== null && entry.matcher !== "" && { matcher: entry.matcher }
-        });
-      }
-    }
-    if (defs.length > 0) {
-      canonical[eventName] = defs;
-    }
-  }
-  return canonical;
-}
+var FACTORYDROID_CONVERTER_CONFIG = {
+  supportedEvents: FACTORYDROID_HOOK_EVENTS,
+  canonicalToToolEventNames: CANONICAL_TO_FACTORYDROID_EVENT_NAMES,
+  toolToCanonicalEventNames: FACTORYDROID_TO_CANONICAL_EVENT_NAMES,
+  projectDirVar: "$FACTORY_PROJECT_DIR"
+};
 var FactorydroidHooks = class _FactorydroidHooks extends ToolHooks {
   constructor(params) {
     super({
@@ -3893,7 +3841,11 @@ var FactorydroidHooks = class _FactorydroidHooks extends ToolHooks {
       );
     }
     const config = rulesyncHooks.getJson();
-    const factorydroidHooks = canonicalToFactorydroidHooks(config);
+    const factorydroidHooks = canonicalToToolHooks({
+      config,
+      toolOverrideHooks: config.factorydroid?.hooks,
+      converterConfig: FACTORYDROID_CONVERTER_CONFIG
+    });
     const merged = { ...settings, hooks: factorydroidHooks };
     const fileContent = JSON.stringify(merged, null, 2);
     return new _FactorydroidHooks({
@@ -3916,7 +3868,10 @@ var FactorydroidHooks = class _FactorydroidHooks extends ToolHooks {
         }
       );
     }
-    const hooks = factorydroidHooksToCanonical(settings.hooks);
+    const hooks = toolHooksToCanonical({
+      hooks: settings.hooks,
+      converterConfig: FACTORYDROID_CONVERTER_CONFIG
+    });
     return this.toRulesyncHooksDefault({
       fileContent: JSON.stringify({ version: 1, hooks }, null, 2)
     });
@@ -3967,7 +3922,10 @@ function canonicalToGeminicliHooks(config) {
     const entries = [];
     for (const [matcherKey, defs] of byMatcher) {
       const hooks = defs.map((def) => {
-        const command = def.command !== void 0 && def.command !== null && !def.command.startsWith("$") ? `$GEMINI_PROJECT_DIR/${def.command.replace(/^\.\//, "")}` : def.command;
+        const commandText = def.command;
+        const trimmedCommand = typeof commandText === "string" ? commandText.trimStart() : void 0;
+        const shouldPrefix = typeof trimmedCommand === "string" && !trimmedCommand.startsWith("$") && trimmedCommand.startsWith(".");
+        const command = shouldPrefix && typeof trimmedCommand === "string" ? `$GEMINI_PROJECT_DIR/${trimmedCommand.replace(/^\.\//, "")}` : def.command;
         return {
           type: def.type ?? "command",
           ...command !== void 0 && command !== null && { command },
@@ -7444,7 +7402,7 @@ var McpProcessor = class extends FeatureProcessor {
 };
 
 // src/features/rules/rules-processor.ts
-import { basename as basename10, join as join113, relative as relative5 } from "path";
+import { basename as basename10, dirname as dirname3, join as join113, relative as relative5 } from "path";
 import { encode } from "@toon-format/toon";
 import { z as z54 } from "zod/mini";
 
@@ -10713,7 +10671,7 @@ var ToolSubagent = class extends ToolFile {
 // src/features/subagents/simulated-subagent.ts
 var SimulatedSubagentFrontmatterSchema = z39.object({
   name: z39.string(),
-  description: z39.string()
+  description: z39.optional(z39.string())
 });
 var SimulatedSubagent = class extends ToolSubagent {
   frontmatter;
@@ -10937,7 +10895,7 @@ import { z as z40 } from "zod/mini";
 var RulesyncSubagentFrontmatterSchema = z40.looseObject({
   targets: z40._default(RulesyncTargetsSchema, ["*"]),
   name: z40.string(),
-  description: z40.string()
+  description: z40.optional(z40.string())
 });
 var RulesyncSubagent = class _RulesyncSubagent extends RulesyncFile {
   frontmatter;
@@ -11008,7 +10966,7 @@ var RulesyncSubagent = class _RulesyncSubagent extends RulesyncFile {
 // src/features/subagents/claudecode-subagent.ts
 var ClaudecodeSubagentFrontmatterSchema = z41.looseObject({
   name: z41.string(),
-  description: z41.string(),
+  description: z41.optional(z41.string()),
   model: z41.optional(z41.string()),
   tools: z41.optional(z41.union([z41.string(), z41.array(z41.string())])),
   permissionMode: z41.optional(z41.string()),
@@ -11218,7 +11176,7 @@ var CodexCliSubagent = class _CodexCliSubagent extends ToolSubagent {
     const rulesyncFrontmatter = {
       targets: ["codexcli"],
       name,
-      description: description ?? "",
+      description,
       // Only include codexcli section if there are fields
       ...Object.keys(codexcliSection).length > 0 && { codexcli: codexcliSection }
     };
@@ -11331,7 +11289,7 @@ import { z as z43 } from "zod/mini";
 var REQUIRED_TOOL = "agent/runSubagent";
 var CopilotSubagentFrontmatterSchema = z43.looseObject({
   name: z43.string(),
-  description: z43.string(),
+  description: z43.optional(z43.string()),
   tools: z43.optional(z43.union([z43.string(), z43.array(z43.string())]))
 });
 var normalizeTools = (tools) => {
@@ -11496,7 +11454,7 @@ import { join as join85 } from "path";
 import { z as z44 } from "zod/mini";
 var CursorSubagentFrontmatterSchema = z44.looseObject({
   name: z44.string(),
-  description: z44.string()
+  description: z44.optional(z44.string())
 });
 var CursorSubagent = class _CursorSubagent extends ToolSubagent {
   frontmatter;
@@ -11701,7 +11659,7 @@ var KiroSubagent = class _KiroSubagent extends ToolSubagent {
     const rulesyncFrontmatter = {
       targets: ["kiro"],
       name,
-      description: description ?? "",
+      description: description ?? void 0,
       // Only include kiro section if there are fields
       ...Object.keys(kiroSection).length > 0 && { kiro: kiroSection }
     };
@@ -11812,7 +11770,7 @@ var KiroSubagent = class _KiroSubagent extends ToolSubagent {
 import { basename as basename8, join as join87 } from "path";
 import { z as z46 } from "zod/mini";
 var OpenCodeSubagentFrontmatterSchema = z46.looseObject({
-  description: z46.string(),
+  description: z46.optional(z46.string()),
   mode: z46._default(z46.string(), "subagent"),
   name: z46.optional(z46.string())
 });
@@ -12642,7 +12600,7 @@ var globStrategy = {
   },
   exportRulesyncData: ({ description, ...frontmatter }) => ({
     globs: parseGlobsString(frontmatter.globs),
-    description: description || "",
+    description,
     antigravity: frontmatter
   })
 };
@@ -12654,7 +12612,7 @@ var manualStrategy = {
   }),
   exportRulesyncData: ({ description, ...frontmatter }) => ({
     globs: [],
-    description: description || "",
+    description,
     antigravity: frontmatter
   })
 };
@@ -12666,7 +12624,7 @@ var alwaysOnStrategy = {
   }),
   exportRulesyncData: ({ description, ...frontmatter }) => ({
     globs: ["**/*"],
-    description: description || "",
+    description,
     antigravity: frontmatter
   })
 };
@@ -12679,7 +12637,7 @@ var modelDecisionStrategy = {
   }),
   exportRulesyncData: ({ description, ...frontmatter }) => ({
     globs: [],
-    description: description || "",
+    description,
     antigravity: frontmatter
   })
 };
@@ -12694,7 +12652,7 @@ var unknownStrategy = {
   },
   exportRulesyncData: ({ description, ...frontmatter }) => ({
     globs: frontmatter.globs ? parseGlobsString(frontmatter.globs) : ["**/*"],
-    description: description || "",
+    description,
     antigravity: frontmatter
   })
 };
@@ -12716,7 +12674,7 @@ var inferenceStrategy = {
   },
   exportRulesyncData: ({ description, ...frontmatter }) => ({
     globs: frontmatter.globs ? parseGlobsString(frontmatter.globs) : ["**/*"],
-    description: description || "",
+    description,
     antigravity: frontmatter
   })
 };
@@ -12846,7 +12804,6 @@ var AntigravityRule = class _AntigravityRule extends ToolRule {
     const strategy = STRATEGIES.find((s) => s.canHandle(this.frontmatter.trigger));
     let rulesyncData = {
       globs: [],
-      description: "",
       antigravity: this.frontmatter
     };
     if (strategy) {
@@ -12916,7 +12873,6 @@ var AugmentcodeLegacyRule = class _AugmentcodeLegacyRule extends ToolRule {
     const rulesyncFrontmatter = {
       root: this.isRoot(),
       targets: ["*"],
-      description: "",
       globs: this.isRoot() ? ["**/*"] : []
     };
     return new RulesyncRule({
@@ -13091,6 +13047,12 @@ var ClaudecodeLegacyRule = class _ClaudecodeLegacyRule extends ToolRule {
         relativeDirPath: ".",
         relativeFilePath: "CLAUDE.md"
       },
+      alternativeRoots: [
+        {
+          relativeDirPath: ".claude",
+          relativeFilePath: "CLAUDE.md"
+        }
+      ],
       nonRoot: {
         relativeDirPath: buildToolPath(".claude", "memories", excludeToolDir)
       }
@@ -13100,18 +13062,19 @@ var ClaudecodeLegacyRule = class _ClaudecodeLegacyRule extends ToolRule {
     baseDir = process.cwd(),
     relativeFilePath,
     validate = true,
-    global = false
+    global = false,
+    relativeDirPath: overrideDirPath
   }) {
     const paths = this.getSettablePaths({ global });
     const isRoot = relativeFilePath === paths.root.relativeFilePath;
     if (isRoot) {
-      const relativePath2 = paths.root.relativeFilePath;
+      const rootDirPath = overrideDirPath ?? paths.root.relativeDirPath;
       const fileContent2 = await readFileContent(
-        join95(baseDir, paths.root.relativeDirPath, relativePath2)
+        join95(baseDir, rootDirPath, paths.root.relativeFilePath)
       );
       return new _ClaudecodeLegacyRule({
         baseDir,
-        relativeDirPath: paths.root.relativeDirPath,
+        relativeDirPath: rootDirPath,
         relativeFilePath: paths.root.relativeFilePath,
         fileContent: fileContent2,
         validate,
@@ -13206,6 +13169,12 @@ var ClaudecodeRule = class _ClaudecodeRule extends ToolRule {
         relativeDirPath: ".",
         relativeFilePath: "CLAUDE.md"
       },
+      alternativeRoots: [
+        {
+          relativeDirPath: ".claude",
+          relativeFilePath: "CLAUDE.md"
+        }
+      ],
       nonRoot: {
         relativeDirPath: buildToolPath(".claude", "rules", excludeToolDir)
       }
@@ -13238,17 +13207,19 @@ var ClaudecodeRule = class _ClaudecodeRule extends ToolRule {
     baseDir = process.cwd(),
     relativeFilePath,
     validate = true,
-    global = false
+    global = false,
+    relativeDirPath: overrideDirPath
   }) {
     const paths = this.getSettablePaths({ global });
     const isRoot = relativeFilePath === paths.root.relativeFilePath;
     if (isRoot) {
+      const rootDirPath = overrideDirPath ?? paths.root.relativeDirPath;
       const fileContent2 = await readFileContent(
-        join96(baseDir, paths.root.relativeDirPath, paths.root.relativeFilePath)
+        join96(baseDir, rootDirPath, paths.root.relativeFilePath)
       );
       return new _ClaudecodeRule({
         baseDir,
-        relativeDirPath: paths.root.relativeDirPath,
+        relativeDirPath: rootDirPath,
         relativeFilePath: paths.root.relativeFilePath,
         frontmatter: {},
         body: fileContent2.trim(),
@@ -15605,35 +15576,62 @@ var RulesProcessor = class extends FeatureProcessor {
       const settablePaths = factory.class.getSettablePaths({
         global: this.global
       });
+      const resolveRelativeDirPath = (filePath) => {
+        const dirName = dirname3(relative5(this.baseDir, filePath));
+        return dirName === "" ? "." : dirName;
+      };
+      const findFilesWithFallback = async (primaryGlob, alternativeRoots, buildAltGlob) => {
+        const primaryFilePaths = await findFilesByGlobs(primaryGlob);
+        if (primaryFilePaths.length > 0) {
+          return primaryFilePaths;
+        }
+        if (alternativeRoots) {
+          return findFilesByGlobs(alternativeRoots.map(buildAltGlob));
+        }
+        return [];
+      };
       const rootToolRules = await (async () => {
         if (!settablePaths.root) {
           return [];
         }
-        const rootFilePaths = await findFilesByGlobs(
+        const uniqueRootFilePaths = await findFilesWithFallback(
           join113(
             this.baseDir,
             settablePaths.root.relativeDirPath ?? ".",
             settablePaths.root.relativeFilePath
-          )
+          ),
+          settablePaths.alternativeRoots,
+          (alt) => join113(this.baseDir, alt.relativeDirPath, alt.relativeFilePath)
         );
         if (forDeletion) {
-          return rootFilePaths.map(
-            (filePath) => factory.class.forDeletion({
+          return uniqueRootFilePaths.map((filePath) => {
+            const relativeDirPath = resolveRelativeDirPath(filePath);
+            checkPathTraversal({
+              relativePath: relativeDirPath,
+              intendedRootDir: this.baseDir
+            });
+            return factory.class.forDeletion({
               baseDir: this.baseDir,
-              relativeDirPath: settablePaths.root?.relativeDirPath ?? ".",
+              relativeDirPath,
               relativeFilePath: basename10(filePath),
               global: this.global
-            })
-          ).filter((rule) => rule.isDeletable());
+            });
+          }).filter((rule) => rule.isDeletable());
         }
         return await Promise.all(
-          rootFilePaths.map(
-            (filePath) => factory.class.fromFile({
+          uniqueRootFilePaths.map((filePath) => {
+            const relativeDirPath = resolveRelativeDirPath(filePath);
+            checkPathTraversal({
+              relativePath: relativeDirPath,
+              intendedRootDir: this.baseDir
+            });
+            return factory.class.fromFile({
               baseDir: this.baseDir,
               relativeFilePath: basename10(filePath),
+              relativeDirPath,
               global: this.global
-            })
-          )
+            });
+          })
         );
       })();
       logger.debug(`Found ${rootToolRules.length} root tool rule files`);
@@ -15647,17 +15645,24 @@ var RulesProcessor = class extends FeatureProcessor {
         if (!settablePaths.root) {
           return [];
         }
-        const localRootFilePaths = await findFilesByGlobs(
-          join113(this.baseDir, settablePaths.root.relativeDirPath ?? ".", "CLAUDE.local.md")
+        const uniqueLocalRootFilePaths = await findFilesWithFallback(
+          join113(this.baseDir, settablePaths.root.relativeDirPath ?? ".", "CLAUDE.local.md"),
+          settablePaths.alternativeRoots,
+          (alt) => join113(this.baseDir, alt.relativeDirPath, "CLAUDE.local.md")
         );
-        return localRootFilePaths.map(
-          (filePath) => factory.class.forDeletion({
+        return uniqueLocalRootFilePaths.map((filePath) => {
+          const relativeDirPath = resolveRelativeDirPath(filePath);
+          checkPathTraversal({
+            relativePath: relativeDirPath,
+            intendedRootDir: this.baseDir
+          });
+          return factory.class.forDeletion({
             baseDir: this.baseDir,
-            relativeDirPath: settablePaths.root?.relativeDirPath ?? ".",
+            relativeDirPath,
             relativeFilePath: basename10(filePath),
             global: this.global
-          })
-        ).filter((rule) => rule.isDeletable());
+          });
+        }).filter((rule) => rule.isDeletable());
       })();
       logger.debug(`Found ${localRootToolRules.length} local root tool rule files for deletion`);
       const nonRootToolRules = await (async () => {