@hasna/hooks 0.2.4 → 0.2.5

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");
@@ -4303,8 +4346,9 @@ function createHooksServer() {
   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 +4376,56 @@ 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: stderrText || undefined, exitCode })
+        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_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 +5693,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 +5794,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 +5817,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 +5857,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 +5873,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 +5970,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 +6014,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;
   }
@@ -6199,6 +6344,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.5",
   "description": "Open source hooks library for AI coding agents - Install safety, quality, and automation hooks with a single command",
   "type": "module",
   "bin": {