@hasna/hooks 0.2.4 → 0.2.6

package/bin/index.js

@@ -3905,6 +3905,25 @@ function writeSettings(settings, scope = "global", target = "claude") {
 function getTargetEventName(internalEvent, target) {
   return EVENT_MAP[target]?.[internalEvent] || internalEvent;
 }
+function detectConflict(name, scope, target) {
+  const meta = getHook(name);
+  if (!meta || !meta.matcher)
+    return;
+  const registered = getRegisteredHooksForTarget(scope, target);
+  for (const existingName of registered) {
+    if (existingName === name)
+      continue;
+    const existing = getHook(existingName);
+    if (!existing || existing.event !== meta.event || !existing.matcher)
+      continue;
+    const a = meta.matcher.toLowerCase();
+    const b = existing.matcher.toLowerCase();
+    if (a === b || a.includes(b) || b.includes(a)) {
+      return `conflicts with '${existingName}' (same event ${meta.event}, overlapping matcher '${existing.matcher}')`;
+    }
+  }
+  return;
+}
 function installForTarget(name, scope, overwrite, target, profile) {
   const shortName = shortHookName(name);
   if (!hookExists(shortName)) {
@@ -3914,9 +3933,10 @@ function installForTarget(name, scope, overwrite, target, profile) {
   if (registered.includes(shortName) && !overwrite) {
     return { hook: shortName, success: false, error: "Already installed. Use --overwrite to replace.", scope, target };
   }
+  const conflict = detectConflict(shortName, scope, target);
   try {
     registerHook(shortName, scope, target, profile);
-    return { hook: shortName, success: true, scope, target };
+    return { hook: shortName, success: true, scope, target, ...conflict ? { conflict } : {} };
   } catch (error) {
     return {
       hook: shortName,
@@ -4104,6 +4124,29 @@ function touchProfile(id) {
   writeFileSync2(profilePath(id), JSON.stringify(profile, null, 2) + `
 `);
 }
+function exportProfiles() {
+  return listProfiles();
+}
+function importProfiles(profiles) {
+  ensureProfilesDir();
+  let imported = 0;
+  let skipped = 0;
+  for (const profile of profiles) {
+    if (!profile.agent_id || !profile.agent_type) {
+      skipped++;
+      continue;
+    }
+    const path = profilePath(profile.agent_id);
+    if (existsSync2(path)) {
+      skipped++;
+      continue;
+    }
+    writeFileSync2(path, JSON.stringify(profile, null, 2) + `
+`);
+    imported++;
+  }
+  return { imported, skipped };
+}
 var PROFILES_DIR;
 var init_profiles = __esm(() => {
   PROFILES_DIR = join2(homedir2(), ".hooks", "profiles");
@@ -4140,13 +4183,20 @@ function createHooksServer() {
     name: "@hasna/hooks",
     version: pkg.version
   });
-  server.tool("hooks_list", "List all available hooks, optionally filtered by category", { category: z.string().optional().describe("Filter by category name (e.g. 'Git Safety', 'Code Quality', 'Security', 'Notifications', 'Context Management')") }, async ({ category }) => {
+  server.tool("hooks_list", "List all available hooks, optionally filtered by category. Use compact:true to get minimal output (name+event+matcher only) \u2014 saves tokens.", {
+    category: z.string().optional().describe("Filter by category name (e.g. 'Git Safety', 'Code Quality', 'Security')"),
+    compact: z.boolean().default(false).describe("Return minimal fields only: name, event, matcher. Reduces token usage.")
+  }, async ({ category, compact }) => {
+    const slim = (hooks) => compact ? hooks.map((h) => ({ name: h.name, event: h.event, matcher: h.matcher })) : hooks;
     if (category) {
       const cat = CATEGORIES.find((c) => c.toLowerCase() === category.toLowerCase());
       if (!cat) {
         return { content: [{ type: "text", text: JSON.stringify({ error: `Unknown category: ${category}`, available: [...CATEGORIES] }) }] };
       }
-      return { content: [{ type: "text", text: JSON.stringify(getHooksByCategory(cat)) }] };
+      return { content: [{ type: "text", text: JSON.stringify(slim(getHooksByCategory(cat))) }] };
+    }
+    if (compact) {
+      return { content: [{ type: "text", text: JSON.stringify(slim(HOOKS)) }] };
     }
     const result = {};
     for (const cat of CATEGORIES) {
@@ -4154,9 +4204,13 @@ function createHooksServer() {
     }
     return { content: [{ type: "text", text: JSON.stringify(result) }] };
   });
-  server.tool("hooks_search", "Search for hooks by name, description, or tags", { query: z.string().describe("Search query") }, async ({ query }) => {
+  server.tool("hooks_search", "Search for hooks by name, description, or tags. Use compact:true for minimal output to save tokens.", {
+    query: z.string().describe("Search query"),
+    compact: z.boolean().default(false).describe("Return minimal fields only: name, event, matcher.")
+  }, async ({ query, compact }) => {
     const results = searchHooks(query);
-    return { content: [{ type: "text", text: JSON.stringify(results) }] };
+    const out = compact ? results.map((h) => ({ name: h.name, event: h.event, matcher: h.matcher })) : results;
+    return { content: [{ type: "text", text: JSON.stringify(out) }] };
   });
   server.tool("hooks_info", "Get detailed information about a specific hook including install status", { name: z.string().describe("Hook name (e.g. 'gitguard', 'checkpoint')") }, async ({ name }) => {
     const meta = getHook(name);
@@ -4243,7 +4297,7 @@ function createHooksServer() {
       if (hookHealthy)
         healthy.push(name);
     }
-    return { content: [{ type: "text", text: JSON.stringify({ healthy, issues, registered, scope }) }] };
+    return { content: [{ type: "text", text: JSON.stringify({ healthy: issues.length === 0, healthy_hooks: healthy, issues, registered, scope }) }] };
   });
   server.tool("hooks_categories", "List all hook categories with counts", {}, async () => {
     const result = CATEGORIES.map((cat) => ({
@@ -4296,15 +4350,16 @@ function createHooksServer() {
     const registered = getRegisteredHooks(scope);
     const result = registered.map((name) => {
       const meta = getHook(name);
-      return { name, event: meta?.event, version: meta?.version, description: meta?.description };
+      return { name, event: meta?.event, matcher: meta?.matcher ?? "", version: meta?.version, description: meta?.description };
     });
     return { content: [{ type: "text", text: JSON.stringify(result) }] };
   });
   server.tool("hooks_run", "Execute a hook programmatically with the given input and return its output", {
     name: z.string().describe("Hook name (e.g. 'gitguard', 'checkpoint')"),
     input: z.record(z.string(), z.unknown()).default(() => ({})).describe("Hook input as JSON object (HookInput)"),
-    profile: z.string().optional().describe("Agent profile ID to inject into hook input")
-  }, async ({ name, input, profile }) => {
+    profile: z.string().optional().describe("Agent profile ID to inject into hook input"),
+    timeout_ms: z.number().default(1e4).describe("Timeout in milliseconds (default: 10000)")
+  }, async ({ name, input, profile, timeout_ms }) => {
     const meta = getHook(name);
     if (!meta) {
       return { content: [{ type: "text", text: JSON.stringify({ error: `Hook '${name}' not found` }) }] };
@@ -4332,24 +4387,253 @@ function createHooksServer() {
       stderr: "pipe",
       env: process.env
     });
-    const [stdoutText, stderrText, exitCode] = await Promise.all([
-      new Response(proc.stdout).text(),
-      new Response(proc.stderr).text(),
-      proc.exited
+    const timeoutPromise = new Promise((resolve) => setTimeout(() => resolve(null), timeout_ms));
+    const result = await Promise.race([
+      Promise.all([
+        new Response(proc.stdout).text(),
+        new Response(proc.stderr).text(),
+        proc.exited
+      ]).then(([stdout, stderr, exitCode]) => ({ stdout, stderr, exitCode, timedOut: false })),
+      timeoutPromise.then(() => {
+        proc.kill();
+        return { stdout: "", stderr: "", exitCode: -1, timedOut: true };
+      })
     ]);
     let output = {};
     try {
-      output = JSON.parse(stdoutText);
+      output = JSON.parse(result.stdout);
     } catch {
-      output = { raw: stdoutText };
+      output = result.stdout ? { raw: result.stdout } : {};
+    }
+    return {
+      content: [{
+        type: "text",
+        text: JSON.stringify({
+          hook: name,
+          output,
+          stderr: result.stderr || undefined,
+          exitCode: result.exitCode,
+          ...result.timedOut ? { timedOut: true, timeout_ms } : {}
+        })
+      }]
+    };
+  });
+  server.tool("hooks_update", "Re-register installed hooks to pick up new package version (reinstalls with overwrite)", {
+    hooks: z.array(z.string()).optional().describe("Hook names to update (omit to update all installed hooks)"),
+    scope: z.enum(["global", "project"]).default("global").describe("Scope to update")
+  }, async ({ hooks, scope }) => {
+    const installed = getRegisteredHooks(scope);
+    const toUpdate = hooks && hooks.length > 0 ? hooks : installed;
+    if (toUpdate.length === 0) {
+      return { content: [{ type: "text", text: JSON.stringify({ updated: [], error: "No hooks installed" }) }] };
+    }
+    const results = toUpdate.map((name) => {
+      if (!installed.includes(name)) {
+        return { hook: name, success: false, error: "Not installed" };
+      }
+      return installHook(name, { scope, overwrite: true });
+    });
+    const updated = results.filter((r) => r.success).map((r) => r.hook);
+    const failed = results.filter((r) => !r.success).map((r) => ({ hook: r.hook, error: r.error }));
+    return { content: [{ type: "text", text: JSON.stringify({ updated, failed, total: results.length }) }] };
+  });
+  server.tool("hooks_context", "Get full agent context in one call: installed hooks (with event+matcher), active profile, settings path, and doctor status. Call this once at session start instead of making 4 separate calls.", {
+    scope: z.enum(["global", "project"]).default("global").describe("Scope to inspect"),
+    profile: z.string().optional().describe("Agent profile ID to include in context")
+  }, async ({ scope, profile }) => {
+    const settingsPath = getSettingsPath(scope);
+    const registered = getRegisteredHooks(scope);
+    const hooks = registered.map((name) => {
+      const meta = getHook(name);
+      return { name, event: meta?.event, matcher: meta?.matcher ?? "", version: meta?.version };
+    });
+    const issues = [];
+    for (const name of registered) {
+      if (!hookExists(name)) {
+        issues.push({ hook: name, issue: "Hook not found in package", severity: "error" });
+      }
+    }
+    const healthy = issues.length === 0;
+    const ctx = {
+      scope,
+      settings_path: settingsPath,
+      settings_exists: existsSync3(settingsPath),
+      registered_hooks: hooks,
+      hook_count: hooks.length,
+      healthy,
+      issues,
+      version: pkg.version
+    };
+    if (profile) {
+      const p = getProfile(profile);
+      ctx.profile = p ?? null;
     }
+    return { content: [{ type: "text", text: JSON.stringify(ctx) }] };
+  });
+  server.tool("hooks_preview", "Simulate which installed PreToolUse hooks would fire for a given tool call and what decision each returns. Use this to understand your hook environment before taking an action.", {
+    tool_name: z.string().describe("Tool name to simulate (e.g. 'Bash', 'Write', 'Edit')"),
+    tool_input: z.record(z.string(), z.unknown()).default(() => ({})).describe("Tool input to pass to matching hooks"),
+    scope: z.enum(["global", "project"]).default("global").describe("Scope to check"),
+    timeout_ms: z.number().default(5000).describe("Per-hook timeout in milliseconds")
+  }, async ({ tool_name, tool_input, scope, timeout_ms }) => {
+    const registered = getRegisteredHooks(scope);
+    const matchingHooks = registered.filter((name) => {
+      const meta = getHook(name);
+      if (!meta || meta.event !== "PreToolUse")
+        return false;
+      if (!meta.matcher)
+        return true;
+      try {
+        return new RegExp(meta.matcher).test(tool_name);
+      } catch {
+        return false;
+      }
+    });
+    if (matchingHooks.length === 0) {
+      return { content: [{ type: "text", text: JSON.stringify({ tool_name, matching_hooks: [], result: "no_hooks_match", decision: "approve" }) }] };
+    }
+    const input = { tool_name, tool_input };
+    const results = await Promise.all(matchingHooks.map(async (name) => {
+      const hookDir = getHookPath(name);
+      const hookScript = join3(hookDir, "src", "hook.ts");
+      if (!existsSync3(hookScript))
+        return { name, decision: "approve", error: "script not found" };
+      const proc = Bun.spawn(["bun", "run", hookScript], {
+        stdin: new Response(JSON.stringify(input)),
+        stdout: "pipe",
+        stderr: "pipe",
+        env: process.env
+      });
+      const timeout = new Promise((r) => setTimeout(() => r(null), timeout_ms));
+      const res = await Promise.race([
+        Promise.all([new Response(proc.stdout).text(), proc.exited]).then(([stdout]) => ({ stdout, timedOut: false })),
+        timeout.then(() => {
+          proc.kill();
+          return { stdout: "", timedOut: true };
+        })
+      ]);
+      if (res.timedOut)
+        return { name, decision: "approve", timedOut: true };
+      let output = {};
+      try {
+        output = JSON.parse(res.stdout);
+      } catch {}
+      return { name, decision: output.decision ?? "approve", reason: output.reason, raw: output };
+    }));
+    const blocked = results.find((r) => r.decision === "block");
+    return {
+      content: [{
+        type: "text",
+        text: JSON.stringify({
+          tool_name,
+          matching_hooks: matchingHooks,
+          results,
+          decision: blocked ? "block" : "approve",
+          blocked_by: blocked?.name ?? null,
+          blocked_reason: blocked?.reason ?? null
+        })
+      }]
+    };
+  });
+  server.tool("hooks_setup", "Single-shot agent onboarding: create an agent profile + install recommended hooks in one call. Ideal for agents setting up hooks at session start.", {
+    agent_type: z.enum(["claude", "gemini", "custom"]).default("claude").describe("Type of AI agent"),
+    name: z.string().optional().describe("Optional display name for the agent"),
+    hooks: z.array(z.string()).optional().describe("Hook names to install (omit for sensible defaults: gitguard, checkpoint, checktests, protectfiles)"),
+    scope: z.enum(["global", "project"]).default("global").describe("Install scope")
+  }, async ({ agent_type, name, hooks, scope }) => {
+    const profile = createProfile({ agent_type, name });
+    const toInstall = hooks && hooks.length > 0 ? hooks : ["gitguard", "checkpoint", "checktests", "protectfiles"];
+    const results = toInstall.map((h) => installHook(h, { scope, overwrite: false, profile: profile.agent_id }));
+    const installed = results.filter((r) => r.success).map((r) => r.hook);
+    const failed = results.filter((r) => !r.success).map((r) => ({ hook: r.hook, error: r.error }));
     return {
       content: [{
         type: "text",
-        text: JSON.stringify({ hook: name, output, stderr: stderrText || undefined, exitCode })
+        text: JSON.stringify({ profile, installed, failed, scope, run_with: `hooks run <name> --profile ${profile.agent_id}` })
       }]
     };
   });
+  server.tool("hooks_batch_run", "Run multiple hooks in parallel in a single call. Returns all results at once \u2014 more efficient than N separate hooks_run calls.", {
+    hooks: z.array(z.object({
+      name: z.string().describe("Hook name"),
+      input: z.record(z.string(), z.unknown()).default(() => ({})).describe("Hook input JSON")
+    })).describe("List of hooks to run with their inputs"),
+    timeout_ms: z.number().default(1e4).describe("Per-hook timeout in milliseconds")
+  }, async ({ hooks, timeout_ms }) => {
+    const results = await Promise.all(hooks.map(async ({ name, input }) => {
+      const meta = getHook(name);
+      if (!meta)
+        return { name, error: `Hook '${name}' not found` };
+      const hookScript = join3(getHookPath(name), "src", "hook.ts");
+      if (!existsSync3(hookScript))
+        return { name, error: "script not found" };
+      const proc = Bun.spawn(["bun", "run", hookScript], {
+        stdin: new Response(JSON.stringify(input)),
+        stdout: "pipe",
+        stderr: "pipe",
+        env: process.env
+      });
+      const timeout = new Promise((r) => setTimeout(() => r(null), timeout_ms));
+      const res = await Promise.race([
+        Promise.all([new Response(proc.stdout).text(), new Response(proc.stderr).text(), proc.exited]).then(([stdout, stderr, exitCode]) => ({ stdout, stderr, exitCode, timedOut: false })),
+        timeout.then(() => {
+          proc.kill();
+          return { stdout: "", stderr: "", exitCode: -1, timedOut: true };
+        })
+      ]);
+      let output = {};
+      try {
+        output = JSON.parse(res.stdout);
+      } catch {
+        output = res.stdout ? { raw: res.stdout } : {};
+      }
+      return { name, output, exitCode: res.exitCode, ...res.timedOut ? { timedOut: true } : {} };
+    }));
+    return { content: [{ type: "text", text: JSON.stringify({ results, count: results.length }) }] };
+  });
+  server.tool("hooks_disable", "Temporarily disable a registered hook without removing it. Stores disabled list in settings under hooks.__disabled.", {
+    name: z.string().describe("Hook name to disable"),
+    scope: z.enum(["global", "project"]).default("global").describe("Scope")
+  }, async ({ name, scope }) => {
+    const settingsPath = getSettingsPath(scope);
+    let settings = {};
+    try {
+      if (existsSync3(settingsPath))
+        settings = JSON.parse(readFileSync3(settingsPath, "utf-8"));
+    } catch {}
+    if (!settings.hooks)
+      settings.hooks = {};
+    const disabled = settings.hooks.__disabled ?? [];
+    if (!disabled.includes(name))
+      disabled.push(name);
+    settings.hooks.__disabled = disabled;
+    const { writeFileSync: writeFileSync3, mkdirSync: mkdirSync3 } = await import("fs");
+    const { dirname: dirname3 } = await import("path");
+    mkdirSync3(dirname3(settingsPath), { recursive: true });
+    writeFileSync3(settingsPath, JSON.stringify(settings, null, 2) + `
+`);
+    return { content: [{ type: "text", text: JSON.stringify({ hook: name, disabled: true, scope }) }] };
+  });
+  server.tool("hooks_enable", "Re-enable a previously disabled hook.", {
+    name: z.string().describe("Hook name to enable"),
+    scope: z.enum(["global", "project"]).default("global").describe("Scope")
+  }, async ({ name, scope }) => {
+    const settingsPath = getSettingsPath(scope);
+    let settings = {};
+    try {
+      if (existsSync3(settingsPath))
+        settings = JSON.parse(readFileSync3(settingsPath, "utf-8"));
+    } catch {}
+    if (settings.hooks?.__disabled) {
+      settings.hooks.__disabled = settings.hooks.__disabled.filter((n) => n !== name);
+      if (settings.hooks.__disabled.length === 0)
+        delete settings.hooks.__disabled;
+      const { writeFileSync: writeFileSync3 } = await import("fs");
+      writeFileSync3(settingsPath, JSON.stringify(settings, null, 2) + `
+`);
+    }
+    return { content: [{ type: "text", text: JSON.stringify({ hook: name, disabled: false, scope }) }] };
+  });
   server.tool("hooks_init", "Register a new agent profile \u2014 returns a unique agent_id for use with hook installation and execution", {
     agent_type: z.enum(["claude", "gemini", "custom"]).default("claude").describe("Type of AI agent"),
     name: z.string().optional().describe("Optional display name for the agent")
@@ -5617,6 +5901,28 @@ function resolveScope(options) {
     return "project";
   return "global";
 }
+function resolveTarget(options) {
+  if (options.target === "gemini")
+    return "gemini";
+  if (options.target === "all")
+    return "all";
+  return "claude";
+}
+function editDistance(a, b) {
+  const m = a.length, n = b.length;
+  const dp = Array.from({ length: m + 1 }, (_, i) => [i, ...Array(n).fill(0)]);
+  for (let j = 0;j <= n; j++)
+    dp[0][j] = j;
+  for (let i = 1;i <= m; i++) {
+    for (let j = 1;j <= n; j++) {
+      dp[i][j] = a[i - 1] === b[j - 1] ? dp[i - 1][j - 1] : 1 + Math.min(dp[i - 1][j], dp[i][j - 1], dp[i - 1][j - 1]);
+    }
+  }
+  return dp[m][n];
+}
+function suggestHooks(name, max = 3) {
+  return HOOKS.map((h) => ({ name: h.name, dist: editDistance(name.toLowerCase(), h.name.toLowerCase()) })).filter(({ dist }) => dist <= 4).sort((a, b) => a.dist - b.dist).slice(0, max).map(({ name: n }) => n);
+}
 program2.name("hooks").description("Install hooks for AI coding agents").version(pkg2.version);
 program2.command("interactive", { isDefault: true }).alias("i").description("Interactive hook browser").action(() => {
   render(/* @__PURE__ */ jsxDEV8(App, {}, undefined, false, undefined, this));
@@ -5696,8 +6002,9 @@ program2.command("run").argument("<hook>", "Hook to run").option("--profile <id>
     process.stderr.write(stderr);
   process.exit(exitCode);
 });
-program2.command("install").alias("add").argument("[hooks...]", "Hooks to install").option("-o, --overwrite", "Overwrite existing hooks", false).option("-a, --all", "Install all available hooks", false).option("-c, --category <category>", "Install all hooks in a category").option("-g, --global", "Install globally (~/.claude/settings.json)", false).option("-p, --project", "Install for current project (.claude/settings.json)", false).option("--profile <id>", "Agent profile ID to scope hooks to").option("-j, --json", "Output as JSON", false).description("Install one or more hooks").action((hooks, options) => {
+program2.command("install").alias("add").argument("[hooks...]", "Hooks to install").option("-o, --overwrite", "Overwrite existing hooks", false).option("-a, --all", "Install all available hooks", false).option("-c, --category <category>", "Install all hooks in a category").option("-g, --global", "Install globally (~/.claude/settings.json)", false).option("-p, --project", "Install for current project (.claude/settings.json)", false).option("-t, --target <target>", "Agent target: claude, gemini, all (default: claude)", "claude").option("--profile <id>", "Agent profile ID to scope hooks to").option("--dry-run", "Preview what would be installed without writing to settings", false).option("-j, --json", "Output as JSON", false).description("Install one or more hooks").action((hooks, options) => {
   const scope = resolveScope(options);
+  const target = resolveTarget(options);
   let toInstall = hooks;
   if (options.all) {
     toInstall = HOOKS.map((h) => h.name);
@@ -5718,9 +6025,38 @@ program2.command("install").alias("add").argument("[hooks...]", "Hooks to instal
     render(/* @__PURE__ */ jsxDEV8(App, {}, undefined, false, undefined, this));
     return;
   }
+  if (options.dryRun) {
+    const known = toInstall.filter((n) => getHook(n));
+    const unknown = toInstall.filter((n) => !getHook(n));
+    if (options.json) {
+      console.log(JSON.stringify({ dryRun: true, would_install: known, unknown, scope, target }));
+      return;
+    }
+    console.log(chalk2.bold(`
+Dry run \u2014 would install (${scope}, ${target}):
+`));
+    for (const name of known) {
+      const meta = getHook(name);
+      console.log(chalk2.cyan(`  ${name}`) + chalk2.dim(` [${meta.event}${meta.matcher ? ` ${meta.matcher}` : ""}]`));
+    }
+    if (unknown.length > 0) {
+      console.log();
+      for (const name of unknown) {
+        const suggestions = suggestHooks(name);
+        console.log(chalk2.red(`  \u2717 unknown: ${name}`) + (suggestions.length ? chalk2.dim(` \u2014 did you mean: ${suggestions.join(", ")}?`) : ""));
+      }
+    }
+    return;
+  }
   const results = [];
   for (const name of toInstall) {
-    const result = installHook(name, { scope, overwrite: options.overwrite, profile: options.profile });
+    if (!getHook(name)) {
+      const suggestions = suggestHooks(name);
+      const hint = suggestions.length ? ` \u2014 did you mean: ${suggestions.join(", ")}?` : "";
+      results.push({ hook: name, success: false, error: `Hook '${name}' not found${hint}` });
+      continue;
+    }
+    const result = installHook(name, { scope, overwrite: options.overwrite, target, profile: options.profile });
     results.push(result);
   }
   if (options.json) {
@@ -5729,13 +6065,14 @@ program2.command("install").alias("add").argument("[hooks...]", "Hooks to instal
       failed: results.filter((r) => !r.success).map((r) => ({ hook: r.hook, error: r.error })),
       total: results.length,
       success: results.filter((r) => r.success).length,
-      scope
+      scope,
+      target
     }));
     return;
   }
   const settingsFile = scope === "project" ? ".claude/settings.json" : "~/.claude/settings.json";
   console.log(chalk2.bold(`
-Installing hooks (${scope})...
+Installing hooks (${scope}, ${target})...
 `));
   for (const result of results) {
     if (result.success) {
@@ -5744,6 +6081,9 @@ Installing hooks (${scope})...
       if (meta) {
         console.log(chalk2.dim(`  ${meta.event}${meta.matcher ? ` [${meta.matcher}]` : ""} \u2192 hooks run ${result.hook}`));
       }
+      if (result.conflict) {
+        console.log(chalk2.yellow(`  \u26A0 Warning: ${result.conflict}`));
+      }
     } else {
       console.log(chalk2.red(`\u2717 ${result.hook}: ${result.error}`));
     }
@@ -5838,17 +6178,28 @@ Found ${results.length} hook(s):
     console.log(`    ${h.description}`);
   }
 });
-program2.command("remove").alias("rm").argument("<hook>", "Hook to remove").option("-g, --global", "Remove from global settings", false).option("-p, --project", "Remove from project settings", false).option("-j, --json", "Output as JSON", false).description("Remove an installed hook").action((hook, options) => {
+program2.command("remove").alias("rm").argument("<hook>", "Hook to remove").option("-g, --global", "Remove from global settings", false).option("-p, --project", "Remove from project settings", false).option("-t, --target <target>", "Agent target: claude, gemini, all (default: claude)", "claude").option("-j, --json", "Output as JSON", false).description("Remove an installed hook").action((hook, options) => {
   const scope = resolveScope(options);
-  const removed = removeHook(hook, scope);
+  const target = resolveTarget(options);
+  if (!getHook(hook)) {
+    const suggestions = suggestHooks(hook);
+    const hint = suggestions.length ? ` \u2014 did you mean: ${suggestions.join(", ")}?` : "";
+    if (options.json) {
+      console.log(JSON.stringify({ hook, removed: false, scope, target, error: `Hook '${hook}' not found${hint}`, suggestions }));
+    } else {
+      console.log(chalk2.red(`\u2717 Hook '${hook}' not found${hint}`));
+    }
+    return;
+  }
+  const removed = removeHook(hook, scope, target);
   if (options.json) {
-    console.log(JSON.stringify({ hook, removed, scope }));
+    console.log(JSON.stringify({ hook, removed, scope, target }));
     return;
   }
   if (removed) {
-    console.log(chalk2.green(`\u2713 Removed ${hook} (${scope})`));
+    console.log(chalk2.green(`\u2713 Removed ${hook} (${scope}, ${target})`));
   } else {
-    console.log(chalk2.red(`\u2717 ${hook} is not installed (${scope})`));
+    console.log(chalk2.red(`\u2717 ${hook} is not installed (${scope}, ${target})`));
   }
 });
 program2.command("categories").option("-j, --json", "Output as JSON", false).description("List all categories").action((options) => {
@@ -5871,10 +6222,12 @@ Categories:
 program2.command("info").argument("<hook>", "Hook name").option("-j, --json", "Output as JSON", false).description("Show detailed info about a hook").action((hook, options) => {
   const meta = getHook(hook);
   if (!meta) {
+    const suggestions = suggestHooks(hook);
+    const hint = suggestions.length ? ` \u2014 did you mean: ${suggestions.join(", ")}?` : "";
     if (options.json) {
-      console.log(JSON.stringify({ error: `Hook '${hook}' not found` }));
+      console.log(JSON.stringify({ error: `Hook '${hook}' not found${hint}`, suggestions }));
     } else {
-      console.log(chalk2.red(`Hook '${hook}' not found`));
+      console.log(chalk2.red(`Hook '${hook}' not found${hint}`));
     }
     return;
   }
@@ -5950,7 +6303,7 @@ program2.command("doctor").option("-g, --global", "Check global settings", false
     }
   }
   if (options.json) {
-    console.log(JSON.stringify({ healthy, issues, registered, scope }));
+    console.log(JSON.stringify({ healthy: issues.length === 0, healthy_hooks: healthy, issues, registered, scope }));
     return;
   }
   console.log(chalk2.bold(`
@@ -6199,6 +6552,56 @@ Upgrading @hasna/hooks (${pm})...
 \u2713 Upgraded: ${current} \u2192 ${latest}`));
   }
 });
+program2.command("profile-export").description("Export all agent profiles as JSON (for backup/cross-machine setup)").option("-o, --output <file>", "Write to file instead of stdout").option("-j, --json", "Output as JSON (default: true)", false).action(async (options) => {
+  const profiles = exportProfiles();
+  const json = JSON.stringify(profiles, null, 2);
+  if (options.output) {
+    const { writeFileSync: writeFileSync3 } = await import("fs");
+    writeFileSync3(options.output, json + `
+`);
+    console.log(chalk2.green(`\u2713 Exported ${profiles.length} profile(s) to ${options.output}`));
+  } else {
+    console.log(json);
+  }
+});
+program2.command("profile-import").argument("<file>", "JSON file to import profiles from (use - for stdin)").description("Import agent profiles from a JSON export file").option("-j, --json", "Output result as JSON", false).action(async (file, options) => {
+  let raw;
+  if (file === "-") {
+    raw = await new Response(Bun.stdin.stream()).text();
+  } else {
+    const { readFileSync: readFileSync5 } = await import("fs");
+    try {
+      raw = readFileSync5(file, "utf-8");
+    } catch {
+      if (options.json) {
+        console.log(JSON.stringify({ error: `Cannot read file: ${file}` }));
+      } else {
+        console.log(chalk2.red(`\u2717 Cannot read file: ${file}`));
+      }
+      return;
+    }
+  }
+  let profiles;
+  try {
+    const parsed = JSON.parse(raw);
+    profiles = Array.isArray(parsed) ? parsed : [parsed];
+  } catch {
+    if (options.json) {
+      console.log(JSON.stringify({ error: "Invalid JSON" }));
+    } else {
+      console.log(chalk2.red("\u2717 Invalid JSON"));
+    }
+    return;
+  }
+  const result = importProfiles(profiles);
+  if (options.json) {
+    console.log(JSON.stringify(result));
+  } else {
+    console.log(chalk2.green(`\u2713 Imported ${result.imported} profile(s)`));
+    if (result.skipped > 0)
+      console.log(chalk2.dim(`  Skipped ${result.skipped} (already exist or invalid)`));
+  }
+});
 program2.command("mcp").option("-s, --stdio", "Use stdio transport (for agent MCP integration)", false).option("-p, --port <port>", "Port for SSE transport", "39427").description("Start MCP server for AI agent integration").action(async (options) => {
   if (options.stdio) {
     const { startStdioServer: startStdioServer2 } = await Promise.resolve().then(() => (init_server(), exports_server));

package/dist/index.js

@@ -17,8 +17,10 @@ __export(exports_profiles, {
   updateProfile: () => updateProfile,
   touchProfile: () => touchProfile,
   listProfiles: () => listProfiles,
+  importProfiles: () => importProfiles,
   getProfilesDir: () => getProfilesDir,
   getProfile: () => getProfile,
+  exportProfiles: () => exportProfiles,
   deleteProfile: () => deleteProfile,
   createProfile: () => createProfile
 });
@@ -115,6 +117,29 @@ function touchProfile(id) {
   writeFileSync2(profilePath(id), JSON.stringify(profile, null, 2) + `
 `);
 }
+function exportProfiles() {
+  return listProfiles();
+}
+function importProfiles(profiles) {
+  ensureProfilesDir();
+  let imported = 0;
+  let skipped = 0;
+  for (const profile of profiles) {
+    if (!profile.agent_id || !profile.agent_type) {
+      skipped++;
+      continue;
+    }
+    const path = profilePath(profile.agent_id);
+    if (existsSync2(path)) {
+      skipped++;
+      continue;
+    }
+    writeFileSync2(path, JSON.stringify(profile, null, 2) + `
+`);
+    imported++;
+  }
+  return { imported, skipped };
+}
 var PROFILES_DIR;
 var init_profiles = __esm(() => {
   PROFILES_DIR = join2(homedir2(), ".hooks", "profiles");
@@ -529,6 +554,25 @@ function writeSettings(settings, scope = "global", target = "claude") {
 function getTargetEventName(internalEvent, target) {
   return EVENT_MAP[target]?.[internalEvent] || internalEvent;
 }
+function detectConflict(name, scope, target) {
+  const meta = getHook(name);
+  if (!meta || !meta.matcher)
+    return;
+  const registered = getRegisteredHooksForTarget(scope, target);
+  for (const existingName of registered) {
+    if (existingName === name)
+      continue;
+    const existing = getHook(existingName);
+    if (!existing || existing.event !== meta.event || !existing.matcher)
+      continue;
+    const a = meta.matcher.toLowerCase();
+    const b = existing.matcher.toLowerCase();
+    if (a === b || a.includes(b) || b.includes(a)) {
+      return `conflicts with '${existingName}' (same event ${meta.event}, overlapping matcher '${existing.matcher}')`;
+    }
+  }
+  return;
+}
 function installForTarget(name, scope, overwrite, target, profile) {
   const shortName = shortHookName(name);
   if (!hookExists(shortName)) {
@@ -538,9 +582,10 @@ function installForTarget(name, scope, overwrite, target, profile) {
   if (registered.includes(shortName) && !overwrite) {
     return { hook: shortName, success: false, error: "Already installed. Use --overwrite to replace.", scope, target };
   }
+  const conflict = detectConflict(shortName, scope, target);
   try {
     registerHook(shortName, scope, target, profile);
-    return { hook: shortName, success: true, scope, target };
+    return { hook: shortName, success: true, scope, target, ...conflict ? { conflict } : {} };
   } catch (error) {
     return {
       hook: shortName,
@@ -711,6 +756,7 @@ export {
   installHooks,
   installHookForProject,
   installHook,
+  importProfiles,
   hookExists,
   getSettingsPath,
   getRegisteredHooksForTarget,
@@ -721,6 +767,7 @@ export {
   getHooksByCategory,
   getHookPath,
   getHook,
+  exportProfiles,
   deleteProfile,
   createProfile,
   HOOKS,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/hooks",
-  "version": "0.2.4",
+  "version": "0.2.6",
   "description": "Open source hooks library for AI coding agents - Install safety, quality, and automation hooks with a single command",
   "type": "module",
   "bin": {