@hasna/hooks 0.1.0 → 0.2.0

package/bin/index.js

@@ -1957,7 +1957,7 @@ var init_registry = __esm(() => {
     {
       name: "checkbugs",
       displayName: "Check Bugs",
-      description: "Checks for bugs via Codex headless agent",
+      description: "Checks for bugs via headless agent",
       version: "0.1.6",
       category: "Code Quality",
       event: "PostToolUse",
@@ -1987,7 +1987,7 @@ var init_registry = __esm(() => {
     {
       name: "checksecurity",
       displayName: "Check Security",
-      description: "Runs security checks via Claude and Codex headless agents",
+      description: "Runs security checks via headless agents",
       version: "0.1.6",
       category: "Security",
       event: "PostToolUse",
@@ -3842,30 +3842,46 @@ import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
 import { join, dirname } from "path";
 import { homedir } from "os";
 import { fileURLToPath } from "url";
-function getSettingsPath(scope = "global") {
+function normalizeHookName(name) {
+  return name.startsWith("hook-") ? name : `hook-${name}`;
+}
+function shortHookName(name) {
+  return normalizeHookName(name).replace("hook-", "");
+}
+function removeHookEntries(entries, hookCommand) {
+  return entries.filter((entry) => !entry.hooks?.some((h) => h.command === hookCommand));
+}
+function getTargetSettingsDir(target) {
+  if (target === "gemini")
+    return ".gemini";
+  return ".claude";
+}
+function getSettingsPath(scope = "global", target = "claude") {
+  const dir = getTargetSettingsDir(target);
   if (scope === "project") {
-    return join(process.cwd(), ".claude", "settings.json");
+    return join(process.cwd(), dir, "settings.json");
   }
-  return join(homedir(), ".claude", "settings.json");
+  return join(homedir(), dir, "settings.json");
 }
 function getHookPath(name) {
-  const hookName = name.startsWith("hook-") ? name : `hook-${name}`;
-  return join(HOOKS_DIR, hookName);
+  return join(HOOKS_DIR, normalizeHookName(name));
 }
 function hookExists(name) {
   return existsSync(getHookPath(name));
 }
-function readSettings(scope = "global") {
-  const path = getSettingsPath(scope);
+function readSettings(scope = "global", target = "claude") {
+  const path = getSettingsPath(scope, target);
   try {
     if (existsSync(path)) {
       return JSON.parse(readFileSync(path, "utf-8"));
     }
-  } catch {}
+  } catch (error) {
+    console.warn(`[hooks] Failed to read settings at ${path}: ${error instanceof Error ? error.message : String(error)}`);
+  }
   return {};
 }
-function writeSettings(settings, scope = "global") {
-  const path = getSettingsPath(scope);
+function writeSettings(settings, scope = "global", target = "claude") {
+  const path = getSettingsPath(scope, target);
   const dir = dirname(path);
   if (!existsSync(dir)) {
     mkdirSync(dir, { recursive: true });
@@ -3873,40 +3889,51 @@ function writeSettings(settings, scope = "global") {
   writeFileSync(path, JSON.stringify(settings, null, 2) + `
 `);
 }
-function installHook(name, options = {}) {
-  const { scope = "global", overwrite = false } = options;
-  const hookName = name.startsWith("hook-") ? name : `hook-${name}`;
-  const shortName = hookName.replace("hook-", "");
+function getTargetEventName(internalEvent, target) {
+  return EVENT_MAP[target]?.[internalEvent] || internalEvent;
+}
+function installForTarget(name, scope, overwrite, target) {
+  const shortName = shortHookName(name);
   if (!hookExists(shortName)) {
-    return { hook: shortName, success: false, error: `Hook '${shortName}' not found` };
+    return { hook: shortName, success: false, error: `Hook '${shortName}' not found`, target };
   }
-  const registered = getRegisteredHooks(scope);
+  const registered = getRegisteredHooksForTarget(scope, target);
   if (registered.includes(shortName) && !overwrite) {
-    return { hook: shortName, success: false, error: "Already installed. Use --overwrite to replace.", scope };
+    return { hook: shortName, success: false, error: "Already installed. Use --overwrite to replace.", scope, target };
   }
   try {
-    registerHook(shortName, scope);
-    return { hook: shortName, success: true, scope };
+    registerHook(shortName, scope, target);
+    return { hook: shortName, success: true, scope, target };
   } catch (error) {
     return {
       hook: shortName,
       success: false,
-      error: error instanceof Error ? error.message : "Unknown error"
+      error: error instanceof Error ? error.message : "Unknown error",
+      target
     };
   }
 }
-function registerHook(name, scope = "global") {
+function installHook(name, options = {}) {
+  const { scope = "global", overwrite = false, target = "claude" } = options;
+  if (target === "all") {
+    const claudeResult = installForTarget(name, scope, overwrite, "claude");
+    installForTarget(name, scope, overwrite, "gemini");
+    return { ...claudeResult, target: "all" };
+  }
+  return installForTarget(name, scope, overwrite, target);
+}
+function registerHook(name, scope = "global", target = "claude") {
   const meta = getHook(name);
   if (!meta)
     return;
-  const settings = readSettings(scope);
+  const settings = readSettings(scope, target);
   if (!settings.hooks)
     settings.hooks = {};
-  const eventKey = meta.event;
+  const eventKey = getTargetEventName(meta.event, target);
   if (!settings.hooks[eventKey])
     settings.hooks[eventKey] = [];
   const hookCommand = `hooks run ${name}`;
-  settings.hooks[eventKey] = settings.hooks[eventKey].filter((entry2) => !entry2.hooks?.some((h) => h.command === hookCommand));
+  settings.hooks[eventKey] = removeHookEntries(settings.hooks[eventKey], hookCommand);
   const entry = {
     hooks: [{ type: "command", command: hookCommand }]
   };
@@ -3914,30 +3941,30 @@ function registerHook(name, scope = "global") {
     entry.matcher = meta.matcher;
   }
   settings.hooks[eventKey].push(entry);
-  writeSettings(settings, scope);
+  writeSettings(settings, scope, target);
 }
-function unregisterHook(name, scope = "global") {
+function unregisterHook(name, scope = "global", target = "claude") {
   const meta = getHook(name);
   if (!meta)
     return;
-  const settings = readSettings(scope);
+  const settings = readSettings(scope, target);
   if (!settings.hooks)
     return;
-  const eventKey = meta.event;
+  const eventKey = getTargetEventName(meta.event, target);
   if (!settings.hooks[eventKey])
     return;
   const hookCommand = `hooks run ${name}`;
-  settings.hooks[eventKey] = settings.hooks[eventKey].filter((entry) => !entry.hooks?.some((h) => h.command === hookCommand));
+  settings.hooks[eventKey] = removeHookEntries(settings.hooks[eventKey], hookCommand);
   if (settings.hooks[eventKey].length === 0) {
     delete settings.hooks[eventKey];
   }
   if (Object.keys(settings.hooks).length === 0) {
     delete settings.hooks;
   }
-  writeSettings(settings, scope);
+  writeSettings(settings, scope, target);
 }
-function getRegisteredHooks(scope = "global") {
-  const settings = readSettings(scope);
+function getRegisteredHooksForTarget(scope = "global", target = "claude") {
+  const settings = readSettings(scope, target);
   if (!settings.hooks)
     return [];
   const registered = [];
@@ -3955,24 +3982,46 @@ function getRegisteredHooks(scope = "global") {
   }
   return [...new Set(registered)];
 }
-function getInstalledHooks(scope = "global") {
-  return getRegisteredHooks(scope);
+function getRegisteredHooks(scope = "global") {
+  return getRegisteredHooksForTarget(scope, "claude");
+}
+function removeHook(name, scope = "global", target = "claude") {
+  const shortName = shortHookName(name);
+  if (target === "all") {
+    const claudeRemoved = removeHookForTarget(shortName, scope, "claude");
+    const geminiRemoved = removeHookForTarget(shortName, scope, "gemini");
+    return claudeRemoved || geminiRemoved;
+  }
+  return removeHookForTarget(shortName, scope, target);
 }
-function removeHook(name, scope = "global") {
-  const hookName = name.startsWith("hook-") ? name : `hook-${name}`;
-  const shortName = hookName.replace("hook-", "");
-  const registered = getRegisteredHooks(scope);
-  if (!registered.includes(shortName)) {
+function removeHookForTarget(name, scope, target) {
+  const registered = getRegisteredHooksForTarget(scope, target);
+  if (!registered.includes(name)) {
     return false;
   }
-  unregisterHook(shortName, scope);
+  unregisterHook(name, scope, target);
   return true;
 }
-var __dirname2, HOOKS_DIR;
+var __dirname2, HOOKS_DIR, EVENT_MAP, getInstalledHooks;
 var init_installer = __esm(() => {
   init_registry();
   __dirname2 = dirname(fileURLToPath(import.meta.url));
   HOOKS_DIR = existsSync(join(__dirname2, "..", "..", "hooks", "hook-gitguard")) ? join(__dirname2, "..", "..", "hooks") : join(__dirname2, "..", "hooks");
+  EVENT_MAP = {
+    claude: {
+      PreToolUse: "PreToolUse",
+      PostToolUse: "PostToolUse",
+      Stop: "Stop",
+      Notification: "Notification"
+    },
+    gemini: {
+      PreToolUse: "BeforeTool",
+      PostToolUse: "AfterTool",
+      Stop: "AfterAgent",
+      Notification: "Notification"
+    }
+  };
+  getInstalledHooks = getRegisteredHooks;
 });
 
 // src/mcp/server.ts
@@ -3989,13 +4038,24 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { z } from "zod";
 import { createServer } from "http";
 import { existsSync as existsSync2, readFileSync as readFileSync2 } from "fs";
-import { join as join2 } from "path";
+import { join as join2, dirname as dirname2 } from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
+function formatInstallResults(results, extra) {
+  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({ installed, failed, total: results.length, success: installed.length, ...extra })
+    }]
+  };
+}
 function createHooksServer() {
   const server = new McpServer({
     name: "@hasna/hooks",
-    version: "0.0.7"
+    version: pkg.version
   });
-  server.tool("hooks_list", "List all available Claude Code 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", { category: z.string().optional().describe("Filter by category name (e.g. 'Git Safety', 'Code Quality', 'Security', 'Notifications', 'Context Management')") }, async ({ category }) => {
     if (category) {
       const cat = CATEGORIES.find((c) => c.toLowerCase() === category.toLowerCase());
       if (!cat) {
@@ -4022,24 +4082,13 @@ function createHooksServer() {
     const projectInstalled = getRegisteredHooks("project").includes(meta.name);
     return { content: [{ type: "text", text: JSON.stringify({ ...meta, global: globalInstalled, project: projectInstalled }) }] };
   });
-  server.tool("hooks_install", "Install one or more hooks by registering them in Claude settings. Use scope 'global' for ~/.claude/settings.json or 'project' for .claude/settings.json", {
+  server.tool("hooks_install", "Install one or more hooks by registering them in agent settings", {
     hooks: z.array(z.string()).describe("Hook names to install"),
     scope: z.enum(["global", "project"]).default("global").describe("Install scope"),
     overwrite: z.boolean().default(false).describe("Overwrite if already installed")
   }, async ({ hooks, scope, overwrite }) => {
     const results = hooks.map((name) => installHook(name, { scope, overwrite }));
-    return {
-      content: [{
-        type: "text",
-        text: JSON.stringify({
-          installed: results.filter((r) => r.success).map((r) => r.hook),
-          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
-        })
-      }]
-    };
+    return formatInstallResults(results, { scope });
   });
   server.tool("hooks_install_category", "Install all hooks in a category", {
     category: z.string().describe("Category name"),
@@ -4052,37 +4101,16 @@ function createHooksServer() {
     }
     const hooks = getHooksByCategory(cat).map((h) => h.name);
     const results = hooks.map((name) => installHook(name, { scope, overwrite }));
-    return {
-      content: [{
-        type: "text",
-        text: JSON.stringify({
-          installed: results.filter((r) => r.success).map((r) => r.hook),
-          failed: results.filter((r) => !r.success).map((r) => ({ hook: r.hook, error: r.error })),
-          category: cat,
-          scope
-        })
-      }]
-    };
+    return formatInstallResults(results, { category: cat, scope });
   });
   server.tool("hooks_install_all", "Install all available hooks", {
     scope: z.enum(["global", "project"]).default("global").describe("Install scope"),
     overwrite: z.boolean().default(false).describe("Overwrite if already installed")
   }, async ({ scope, overwrite }) => {
     const results = HOOKS.map((h) => installHook(h.name, { scope, overwrite }));
-    return {
-      content: [{
-        type: "text",
-        text: JSON.stringify({
-          installed: results.filter((r) => r.success).map((r) => r.hook),
-          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
-        })
-      }]
-    };
+    return formatInstallResults(results, { scope });
   });
-  server.tool("hooks_remove", "Remove (unregister) a hook from Claude settings", {
+  server.tool("hooks_remove", "Remove (unregister) a hook from agent settings", {
     name: z.string().describe("Hook name to remove"),
     scope: z.enum(["global", "project"]).default("global").describe("Scope to remove from")
   }, async ({ name, scope }) => {
@@ -4153,7 +4181,7 @@ function createHooksServer() {
       content: [{
         type: "text",
         text: JSON.stringify({
-          overview: "Claude Code hooks are scripts that run at specific points in a Claude Code session. Install @hasna/hooks globally, then register hooks \u2014 no files are copied to your project.",
+          overview: "Hooks are scripts that run at specific points in an AI coding agent session. Install @hasna/hooks globally, then register hooks \u2014 no files are copied to your project.",
           events: {
             PreToolUse: "Fires before a tool executes. Can block the operation.",
             PostToolUse: "Fires after a tool executes. Runs asynchronously.",
@@ -4209,7 +4237,7 @@ async function startSSEServer(port = MCP_PORT) {
       await transport.handlePostMessage(req, res, body);
     } else {
       res.writeHead(200, { "Content-Type": "application/json" });
-      res.end(JSON.stringify({ name: "@hasna/hooks", version: "0.0.7", transport: "sse", port }));
+      res.end(JSON.stringify({ name: "@hasna/hooks", version: pkg.version, transport: "sse", port }));
     }
   });
   httpServer.listen(port, () => {
@@ -4222,10 +4250,12 @@ async function startStdioServer() {
   const transport = new StdioServerTransport;
   await server.connect(transport);
 }
-var MCP_PORT = 39427;
+var __dirname3, pkg, MCP_PORT = 39427;
 var init_server = __esm(() => {
   init_registry();
   init_installer();
+  __dirname3 = dirname2(fileURLToPath2(import.meta.url));
+  pkg = JSON.parse(readFileSync2(join2(__dirname3, "..", "..", "package.json"), "utf-8"));
 });
 
 // src/cli/index.tsx
@@ -4702,10 +4732,12 @@ function CategorySelect({ onSelect, onBack }) {
   return /* @__PURE__ */ jsxDEV2(Box4, {
     flexDirection: "column",
     children: [
-      /* @__PURE__ */ jsxDEV2(Text4, {
-        bold: true,
+      /* @__PURE__ */ jsxDEV2(Box4, {
         marginBottom: 1,
-        children: "Select a category:"
+        children: /* @__PURE__ */ jsxDEV2(Text4, {
+          bold: true,
+          children: "Select a category:"
+        }, undefined, false, undefined, this)
       }, undefined, false, undefined, this),
       /* @__PURE__ */ jsxDEV2(SelectInput_default, {
         items,
@@ -5268,9 +5300,11 @@ function App({ initialHooks, overwrite = false }) {
       view === "main" && /* @__PURE__ */ jsxDEV7(Box8, {
         flexDirection: "column",
         children: [
-          /* @__PURE__ */ jsxDEV7(Text10, {
+          /* @__PURE__ */ jsxDEV7(Box8, {
             marginBottom: 1,
-            children: "What would you like to do?"
+            children: /* @__PURE__ */ jsxDEV7(Text10, {
+              children: "What would you like to do?"
+            }, undefined, false, undefined, this)
           }, undefined, false, undefined, this),
           /* @__PURE__ */ jsxDEV7(SelectInput_default, {
             items: mainMenuItems,
@@ -5316,11 +5350,13 @@ function App({ initialHooks, overwrite = false }) {
       view === "done" && /* @__PURE__ */ jsxDEV7(Box8, {
         flexDirection: "column",
         children: [
-          /* @__PURE__ */ jsxDEV7(Text10, {
-            bold: true,
-            color: "green",
+          /* @__PURE__ */ jsxDEV7(Box8, {
             marginBottom: 1,
-            children: "Installation complete!"
+            children: /* @__PURE__ */ jsxDEV7(Text10, {
+              bold: true,
+              color: "green",
+              children: "Installation complete!"
+            }, undefined, false, undefined, this)
           }, undefined, false, undefined, this),
           results.filter((r) => r.success).length > 0 && /* @__PURE__ */ jsxDEV7(Box8, {
             flexDirection: "column",
@@ -5425,11 +5461,11 @@ function resolveScope(options) {
     return "project";
   return "global";
 }
-program2.name("hooks").description("Install Claude Code hooks for your project").version("0.1.0");
+program2.name("hooks").description("Install hooks for AI coding agents").version("0.1.1");
 program2.command("interactive", { isDefault: true }).alias("i").description("Interactive hook browser").action(() => {
   render(/* @__PURE__ */ jsxDEV8(App, {}, undefined, false, undefined, this));
 });
-program2.command("run").argument("<hook>", "Hook to run").description("Execute a hook (called by Claude Code)").action(async (hook) => {
+program2.command("run").argument("<hook>", "Hook to run").description("Execute a hook (called by AI coding agents)").action(async (hook) => {
   const meta = getHook(hook);
   if (!meta) {
     console.error(JSON.stringify({ error: `Hook '${hook}' not found` }));
@@ -5512,7 +5548,7 @@ Installing hooks (${scope})...
   console.log(chalk2.dim(`
 Registered in ${settingsFile}`));
 });
-program2.command("list").alias("ls").option("-c, --category <category>", "Filter by category").option("-a, --all", "Show all available hooks", false).option("-i, --installed", "Show only installed hooks", false).option("-r, --registered", "Show hooks registered in Claude settings", false).option("-g, --global", "Check global settings", false).option("-p, --project", "Check project settings", false).option("-j, --json", "Output as JSON", false).description("List available or installed hooks").action((options) => {
+program2.command("list").alias("ls").option("-c, --category <category>", "Filter by category").option("-a, --all", "Show all available hooks", false).option("-i, --installed", "Show only installed hooks", false).option("-r, --registered", "Show registered hooks", false).option("-g, --global", "Check global settings", false).option("-p, --project", "Check project settings", false).option("-j, --json", "Output as JSON", false).description("List available or installed hooks").action((options) => {
   const scope = resolveScope(options);
   if (options.registered || options.installed) {
     const registered = getRegisteredHooks(scope);
@@ -5822,11 +5858,11 @@ ${meta.displayName} v${meta.version}
     return;
   }
   const generalDocs = {
-    overview: "Claude Code hooks are scripts that run at specific points in a Claude Code session. Install @hasna/hooks globally, then register hooks \u2014 no files are copied to your project.",
+    overview: "Hooks are scripts that run at specific points in an AI coding agent session. Install @hasna/hooks globally, then register hooks \u2014 no files are copied to your project.",
     events: {
       PreToolUse: 'Fires before a tool executes. Can block the operation by returning { "decision": "block" }.',
       PostToolUse: "Fires after a tool executes. Runs asynchronously, cannot block.",
-      Stop: "Fires when a Claude Code session ends. Useful for notifications and cleanup.",
+      Stop: "Fires when a session ends. Useful for notifications and cleanup.",
       Notification: "Fires on notification events like context compaction."
     },
     installation: {
@@ -5848,7 +5884,7 @@ ${meta.displayName} v${meta.version}
     howItWorks: {
       install: "bun install -g @hasna/hooks",
       register: "hooks install gitguard \u2192 writes to ~/.claude/settings.json",
-      execution: "Claude Code runs 'hooks run gitguard' \u2192 executes hook from global package",
+      execution: "Agent runs 'hooks run gitguard' \u2192 executes hook from global package",
       noFileCopy: "No files are copied to your project. Hooks run from the global @hasna/hooks package."
     }
   };
@@ -5894,7 +5930,7 @@ ${meta.displayName} v${meta.version}
   console.log(`    hooks docs --json     Machine-readable documentation`);
   console.log();
 });
-program2.command("mcp").option("-s, --stdio", "Use stdio transport (for Claude Code integration)", false).option("-p, --port <port>", "Port for SSE transport", "39427").description("Start MCP server for AI agent integration").action(async (options) => {
+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));
     await startStdioServer2();