rulesync 7.12.0 → 7.12.1

package/dist/cli/index.cjs

@@ -608,7 +608,7 @@ var ToolCommand = class extends AiFile {
 
 // src/features/commands/simulated-command.ts
 var SimulatedCommandFrontmatterSchema = import_mini2.z.object({
-  description: import_mini2.z.string()
+  description: import_mini2.z.optional(import_mini2.z.string())
 });
 var SimulatedCommand = class _SimulatedCommand extends ToolCommand {
   frontmatter;
@@ -828,7 +828,7 @@ var RulesyncTargetsSchema = import_mini3.z.array(import_mini3.z.enum(ALL_TOOL_TA
 // src/features/commands/rulesync-command.ts
 var RulesyncCommandFrontmatterSchema = import_mini4.z.looseObject({
   targets: import_mini4.z._default(RulesyncTargetsSchema, ["*"]),
-  description: import_mini4.z.string()
+  description: import_mini4.z.optional(import_mini4.z.string())
 });
 var RulesyncCommand = class _RulesyncCommand extends RulesyncFile {
   frontmatter;
@@ -916,7 +916,7 @@ var AntigravityWorkflowFrontmatterSchema = import_mini5.z.looseObject({
   turbo: import_mini5.z.optional(import_mini5.z.boolean())
 });
 var AntigravityCommandFrontmatterSchema = import_mini5.z.looseObject({
-  description: import_mini5.z.string(),
+  description: import_mini5.z.optional(import_mini5.z.string()),
   // Support for workflow-specific configuration
   ...AntigravityWorkflowFrontmatterSchema.shape
 });
@@ -1089,7 +1089,7 @@ ${body}${turboDirective}`;
 var import_node_path8 = require("path");
 var import_mini6 = require("zod/mini");
 var ClaudecodeCommandFrontmatterSchema = import_mini6.z.looseObject({
-  description: import_mini6.z.string(),
+  description: import_mini6.z.optional(import_mini6.z.string()),
   "allowed-tools": import_mini6.z.optional(import_mini6.z.union([import_mini6.z.string(), import_mini6.z.array(import_mini6.z.string())])),
   "argument-hint": import_mini6.z.optional(import_mini6.z.string()),
   model: import_mini6.z.optional(import_mini6.z.string()),
@@ -1244,8 +1244,7 @@ var ClineCommand = class _ClineCommand extends ToolCommand {
   }
   toRulesyncCommand() {
     const rulesyncFrontmatter = {
-      targets: ["*"],
-      description: ""
+      targets: ["*"]
     };
     return new RulesyncCommand({
       baseDir: process.cwd(),
@@ -1330,8 +1329,7 @@ var CodexcliCommand = class _CodexcliCommand extends ToolCommand {
   }
   toRulesyncCommand() {
     const rulesyncFrontmatter = {
-      targets: ["*"],
-      description: ""
+      targets: ["*"]
     };
     return new RulesyncCommand({
       baseDir: ".",
@@ -1409,7 +1407,7 @@ var import_node_path11 = require("path");
 var import_mini7 = require("zod/mini");
 var CopilotCommandFrontmatterSchema = import_mini7.z.looseObject({
   mode: import_mini7.z.optional(import_mini7.z.string()),
-  description: import_mini7.z.string()
+  description: import_mini7.z.optional(import_mini7.z.string())
 });
 var CopilotCommand = class _CopilotCommand extends ToolCommand {
   frontmatter;
@@ -1592,7 +1590,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,
@@ -1786,7 +1784,7 @@ var GeminiCliCommand = class _GeminiCliCommand extends ToolCommand {
       }
       return {
         ...result.data,
-        description: result.data.description || ""
+        description: result.data.description
       };
     } catch (error) {
       throw new Error(
@@ -1808,7 +1806,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 }
     };
@@ -1837,8 +1835,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 });
@@ -1908,8 +1907,7 @@ var KiloCommand = class _KiloCommand extends ToolCommand {
   }
   toRulesyncCommand() {
     const rulesyncFrontmatter = {
-      targets: ["*"],
-      description: ""
+      targets: ["*"]
     };
     return new RulesyncCommand({
       baseDir: process.cwd(),
@@ -1989,8 +1987,7 @@ var KiroCommand = class _KiroCommand extends ToolCommand {
   }
   toRulesyncCommand() {
     const rulesyncFrontmatter = {
-      targets: ["*"],
-      description: ""
+      targets: ["*"]
     };
     return new RulesyncCommand({
       baseDir: process.cwd(),
@@ -2064,7 +2061,7 @@ var KiroCommand = class _KiroCommand extends ToolCommand {
 var import_node_path17 = require("path");
 var import_mini10 = require("zod/mini");
 var OpenCodeCommandFrontmatterSchema = import_mini10.z.looseObject({
-  description: import_mini10.z.string(),
+  description: import_mini10.z.optional(import_mini10.z.string()),
   agent: (0, import_mini10.optional)(import_mini10.z.string()),
   subtask: (0, import_mini10.optional)(import_mini10.z.boolean()),
   model: (0, import_mini10.optional)(import_mini10.z.string())
@@ -2204,7 +2201,7 @@ var OpenCodeCommand = class _OpenCodeCommand extends ToolCommand {
 var import_node_path18 = require("path");
 var import_mini11 = require("zod/mini");
 var RooCommandFrontmatterSchema = import_mini11.z.looseObject({
-  description: import_mini11.z.string(),
+  description: import_mini11.z.optional(import_mini11.z.string()),
   "argument-hint": (0, import_mini11.optional)(import_mini11.z.string())
 });
 var RooCommand = class _RooCommand extends ToolCommand {
@@ -2743,7 +2740,7 @@ var HookDefinitionSchema = import_mini13.z.looseObject({
   type: import_mini13.z.optional(import_mini13.z.enum(["command", "prompt"])),
   timeout: import_mini13.z.optional(import_mini13.z.number()),
   matcher: import_mini13.z.optional(safeString),
-  prompt: import_mini13.z.optional(import_mini13.z.string()),
+  prompt: import_mini13.z.optional(safeString),
   loop_limit: import_mini13.z.optional(import_mini13.z.nullable(import_mini13.z.number())),
   name: import_mini13.z.optional(safeString),
   description: import_mini13.z.optional(safeString)
@@ -2795,7 +2792,7 @@ var OPENCODE_HOOK_EVENTS = [
 var COPILOT_HOOK_EVENTS = [
   "sessionStart",
   "sessionEnd",
-  "afterSubmitPrompt",
+  "beforeSubmitPrompt",
   "preToolUse",
   "postToolUse",
   "afterError"
@@ -2906,7 +2903,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"
@@ -2934,6 +2931,104 @@ var GEMINICLI_TO_CANONICAL_EVENT_NAMES = Object.fromEntries(
 // src/features/hooks/claudecode-hooks.ts
 var import_node_path21 = require("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 command = def.command !== void 0 && def.command !== null && !def.command.startsWith("$") ? `${converterConfig.projectDirVar}/${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[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 {
 };
@@ -3024,91 +3119,12 @@ 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"
+};
 var ClaudecodeHooks = class _ClaudecodeHooks extends ToolHooks {
   constructor(params) {
     super({
@@ -3160,7 +3176,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({
@@ -3183,7 +3203,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)
     });
@@ -3492,91 +3515,12 @@ var CursorHooks = class _CursorHooks extends ToolHooks {
 
 // src/features/hooks/factorydroid-hooks.ts
 var import_node_path24 = require("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({
@@ -3628,7 +3572,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({
@@ -3651,7 +3599,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)
     });
@@ -10448,7 +10399,7 @@ var ToolSubagent = class extends ToolFile {
 // src/features/subagents/simulated-subagent.ts
 var SimulatedSubagentFrontmatterSchema = import_mini38.z.object({
   name: import_mini38.z.string(),
-  description: import_mini38.z.string()
+  description: import_mini38.z.optional(import_mini38.z.string())
 });
 var SimulatedSubagent = class extends ToolSubagent {
   frontmatter;
@@ -10672,7 +10623,7 @@ var import_mini39 = require("zod/mini");
 var RulesyncSubagentFrontmatterSchema = import_mini39.z.looseObject({
   targets: import_mini39.z._default(RulesyncTargetsSchema, ["*"]),
   name: import_mini39.z.string(),
-  description: import_mini39.z.string()
+  description: import_mini39.z.optional(import_mini39.z.string())
 });
 var RulesyncSubagent = class _RulesyncSubagent extends RulesyncFile {
   frontmatter;
@@ -10743,7 +10694,7 @@ var RulesyncSubagent = class _RulesyncSubagent extends RulesyncFile {
 // src/features/subagents/claudecode-subagent.ts
 var ClaudecodeSubagentFrontmatterSchema = import_mini40.z.looseObject({
   name: import_mini40.z.string(),
-  description: import_mini40.z.string(),
+  description: import_mini40.z.optional(import_mini40.z.string()),
   model: import_mini40.z.optional(import_mini40.z.string()),
   tools: import_mini40.z.optional(import_mini40.z.union([import_mini40.z.string(), import_mini40.z.array(import_mini40.z.string())])),
   permissionMode: import_mini40.z.optional(import_mini40.z.string()),
@@ -10953,7 +10904,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 }
     };
@@ -11066,7 +11017,7 @@ var import_mini42 = require("zod/mini");
 var REQUIRED_TOOL = "agent/runSubagent";
 var CopilotSubagentFrontmatterSchema = import_mini42.z.looseObject({
   name: import_mini42.z.string(),
-  description: import_mini42.z.string(),
+  description: import_mini42.z.optional(import_mini42.z.string()),
   tools: import_mini42.z.optional(import_mini42.z.union([import_mini42.z.string(), import_mini42.z.array(import_mini42.z.string())]))
 });
 var normalizeTools = (tools) => {
@@ -11231,7 +11182,7 @@ var import_node_path85 = require("path");
 var import_mini43 = require("zod/mini");
 var CursorSubagentFrontmatterSchema = import_mini43.z.looseObject({
   name: import_mini43.z.string(),
-  description: import_mini43.z.string()
+  description: import_mini43.z.optional(import_mini43.z.string())
 });
 var CursorSubagent = class _CursorSubagent extends ToolSubagent {
   frontmatter;
@@ -11436,7 +11387,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 }
     };
@@ -11547,7 +11498,7 @@ var KiroSubagent = class _KiroSubagent extends ToolSubagent {
 var import_node_path87 = require("path");
 var import_mini45 = require("zod/mini");
 var OpenCodeSubagentFrontmatterSchema = import_mini45.z.looseObject({
-  description: import_mini45.z.string(),
+  description: import_mini45.z.optional(import_mini45.z.string()),
   mode: import_mini45.z._default(import_mini45.z.string(), "subagent"),
   name: import_mini45.z.optional(import_mini45.z.string())
 });
@@ -12377,7 +12328,7 @@ var globStrategy = {
   },
   exportRulesyncData: ({ description, ...frontmatter }) => ({
     globs: parseGlobsString(frontmatter.globs),
-    description: description || "",
+    description,
     antigravity: frontmatter
   })
 };
@@ -12389,7 +12340,7 @@ var manualStrategy = {
   }),
   exportRulesyncData: ({ description, ...frontmatter }) => ({
     globs: [],
-    description: description || "",
+    description,
     antigravity: frontmatter
   })
 };
@@ -12401,7 +12352,7 @@ var alwaysOnStrategy = {
   }),
   exportRulesyncData: ({ description, ...frontmatter }) => ({
     globs: ["**/*"],
-    description: description || "",
+    description,
     antigravity: frontmatter
   })
 };
@@ -12414,7 +12365,7 @@ var modelDecisionStrategy = {
   }),
   exportRulesyncData: ({ description, ...frontmatter }) => ({
     globs: [],
-    description: description || "",
+    description,
     antigravity: frontmatter
   })
 };
@@ -12429,7 +12380,7 @@ var unknownStrategy = {
   },
   exportRulesyncData: ({ description, ...frontmatter }) => ({
     globs: frontmatter.globs ? parseGlobsString(frontmatter.globs) : ["**/*"],
-    description: description || "",
+    description,
     antigravity: frontmatter
   })
 };
@@ -12451,7 +12402,7 @@ var inferenceStrategy = {
   },
   exportRulesyncData: ({ description, ...frontmatter }) => ({
     globs: frontmatter.globs ? parseGlobsString(frontmatter.globs) : ["**/*"],
-    description: description || "",
+    description,
     antigravity: frontmatter
   })
 };
@@ -12581,7 +12532,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) {
@@ -12651,7 +12601,6 @@ var AugmentcodeLegacyRule = class _AugmentcodeLegacyRule extends ToolRule {
     const rulesyncFrontmatter = {
       root: this.isRoot(),
       targets: ["*"],
-      description: "",
       globs: this.isRoot() ? ["**/*"] : []
     };
     return new RulesyncRule({
@@ -12826,6 +12775,12 @@ var ClaudecodeLegacyRule = class _ClaudecodeLegacyRule extends ToolRule {
         relativeDirPath: ".",
         relativeFilePath: "CLAUDE.md"
       },
+      alternativeRoots: [
+        {
+          relativeDirPath: ".claude",
+          relativeFilePath: "CLAUDE.md"
+        }
+      ],
       nonRoot: {
         relativeDirPath: buildToolPath(".claude", "memories", excludeToolDir)
       }
@@ -12835,18 +12790,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(
-        (0, import_node_path95.join)(baseDir, paths.root.relativeDirPath, relativePath2)
+        (0, import_node_path95.join)(baseDir, rootDirPath, paths.root.relativeFilePath)
       );
       return new _ClaudecodeLegacyRule({
         baseDir,
-        relativeDirPath: paths.root.relativeDirPath,
+        relativeDirPath: rootDirPath,
         relativeFilePath: paths.root.relativeFilePath,
         fileContent: fileContent2,
         validate,
@@ -12941,6 +12897,12 @@ var ClaudecodeRule = class _ClaudecodeRule extends ToolRule {
         relativeDirPath: ".",
         relativeFilePath: "CLAUDE.md"
       },
+      alternativeRoots: [
+        {
+          relativeDirPath: ".claude",
+          relativeFilePath: "CLAUDE.md"
+        }
+      ],
       nonRoot: {
         relativeDirPath: buildToolPath(".claude", "rules", excludeToolDir)
       }
@@ -12973,17 +12935,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(
-        (0, import_node_path96.join)(baseDir, paths.root.relativeDirPath, paths.root.relativeFilePath)
+        (0, import_node_path96.join)(baseDir, rootDirPath, paths.root.relativeFilePath)
       );
       return new _ClaudecodeRule({
         baseDir,
-        relativeDirPath: paths.root.relativeDirPath,
+        relativeDirPath: rootDirPath,
         relativeFilePath: paths.root.relativeFilePath,
         frontmatter: {},
         body: fileContent2.trim(),
@@ -15340,35 +15304,62 @@ var RulesProcessor = class extends FeatureProcessor {
       const settablePaths = factory.class.getSettablePaths({
         global: this.global
       });
+      const resolveRelativeDirPath = (filePath) => {
+        const dirName = (0, import_node_path113.dirname)((0, import_node_path113.relative)(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(
           (0, import_node_path113.join)(
             this.baseDir,
             settablePaths.root.relativeDirPath ?? ".",
             settablePaths.root.relativeFilePath
-          )
+          ),
+          settablePaths.alternativeRoots,
+          (alt) => (0, import_node_path113.join)(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: (0, import_node_path113.basename)(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: (0, import_node_path113.basename)(filePath),
+              relativeDirPath,
               global: this.global
-            })
-          )
+            });
+          })
         );
       })();
       logger.debug(`Found ${rootToolRules.length} root tool rule files`);
@@ -15382,17 +15373,24 @@ var RulesProcessor = class extends FeatureProcessor {
         if (!settablePaths.root) {
           return [];
         }
-        const localRootFilePaths = await findFilesByGlobs(
-          (0, import_node_path113.join)(this.baseDir, settablePaths.root.relativeDirPath ?? ".", "CLAUDE.local.md")
+        const uniqueLocalRootFilePaths = await findFilesWithFallback(
+          (0, import_node_path113.join)(this.baseDir, settablePaths.root.relativeDirPath ?? ".", "CLAUDE.local.md"),
+          settablePaths.alternativeRoots,
+          (alt) => (0, import_node_path113.join)(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: (0, import_node_path113.basename)(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 () => {
@@ -20194,7 +20192,7 @@ async function updateCommand(currentVersion, options) {
 }
 
 // src/cli/index.ts
-var getVersion = () => "7.12.0";
+var getVersion = () => "7.12.1";
 var main = async () => {
   const program = new import_commander.Command();
   const version = getVersion();