@hasna/hooks 0.1.1 → 0.2.1

package/LICENSE

@@ -0,0 +1,191 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to the Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by the Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding any notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2025 Hasna
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -1,6 +1,6 @@
 # Hooks
 
-Open source library of 15 Claude Code hooks. Install any hook with a single command.
+Open source library of 30 Claude Code hooks. Install any hook with a single command.
 
 ## Quick Start
 
@@ -87,7 +87,7 @@ hooks list --registered
 hooks remove gitguard
 ```
 
-## Available Hooks (15)
+## Available Hooks (30)
 
 ### Git Safety (3)
 | Hook | Event | Description |
@@ -102,21 +102,24 @@ hooks remove gitguard
 | checktests | PostToolUse | Checks for missing tests after file edits |
 | checklint | PostToolUse | Runs linting after file edits and creates tasks for errors |
 | checkfiles | PostToolUse | Runs headless agent to review files and create tasks |
-| checkbugs | PostToolUse | Checks for bugs via Codex headless agent |
+| checkbugs | PostToolUse | Checks for bugs via headless agent |
 | checkdocs | PostToolUse | Checks for missing documentation and creates tasks |
 | checktasks | PostToolUse | Validates task completion and tracks progress |
 
 ### Security (2)
 | Hook | Event | Description |
 |------|-------|-------------|
-| checksecurity | PostToolUse | Runs security checks via Claude and Codex headless agents |
+| checksecurity | PostToolUse | Runs security checks via headless agents |
 | packageage | PreToolUse | Checks package age before install to prevent typosquatting |
 
-### Notifications (2)
+### Notifications (5)
 | Hook | Event | Description |
 |------|-------|-------------|
 | phonenotify | Stop | Sends push notifications to phone via ntfy.sh |
 | agentmessages | Stop | Inter-agent messaging integration for service-message |
+| desktopnotify | Stop | Sends native desktop notifications via osascript (macOS) or notify-send (Linux) |
+| slacknotify | Stop | Sends Slack webhook notifications when Claude finishes |
+| soundnotify | Stop | Plays a system sound when Claude finishes (macOS/Linux) |
 
 ### Context Management (2)
 | Hook | Event | Description |
@@ -124,6 +127,38 @@ hooks remove gitguard
 | contextrefresh | Notification | Re-injects important context every N prompts to prevent drift |
 | precompact | Notification | Saves session state before context compaction |
 
+### Workflow Automation (3)
+| Hook | Event | Description |
+|------|-------|-------------|
+| autoformat | PostToolUse | Runs project formatter (Prettier, Biome, Ruff, Black, gofmt) after file edits |
+| autostage | PostToolUse | Automatically git-stages files after Claude edits them |
+| tddguard | PreToolUse | Blocks implementation edits unless corresponding test files exist |
+
+### Environment (1)
+| Hook | Event | Description |
+|------|-------|-------------|
+| envsetup | PreToolUse | Warns when nvm, virtualenv, asdf, or rbenv may need activation before commands |
+
+### Permissions (3)
+| Hook | Event | Description |
+|------|-------|-------------|
+| permissionguard | PreToolUse | Auto-approves safe read-only commands and blocks dangerous operations |
+| protectfiles | PreToolUse | Blocks access to .env, secrets, SSH keys, and lock files |
+| promptguard | PreToolUse | Blocks prompt injection attempts and credential access requests |
+
+### Observability (4)
+| Hook | Event | Description |
+|------|-------|-------------|
+| sessionlog | PostToolUse | Logs every tool call to .claude/session-log-\<date\>.jsonl |
+| commandlog | PostToolUse | Logs every bash command Claude runs to .claude/commands.log |
+| costwatch | Stop | Estimates session token usage and warns when budget threshold is exceeded |
+| errornotify | PostToolUse | Detects tool failures and logs errors to .claude/errors.log |
+
+### Agent Teams (1)
+| Hook | Event | Description |
+|------|-------|-------------|
+| taskgate | PostToolUse | Validates task completion criteria before allowing tasks to be marked done |
+
 ## How Hooks Work
 
 Claude Code hooks are lifecycle interceptors that run during agent sessions:
@@ -229,4 +264,4 @@ bun run typecheck
 
 ## License
 
-MIT
+Apache-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,6 +3842,15 @@ import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
 import { join, dirname } from "path";
 import { homedir } from "os";
 import { fileURLToPath } from "url";
+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";
@@ -3855,8 +3864,7 @@ function getSettingsPath(scope = "global", target = "claude") {
   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));
@@ -3867,7 +3875,9 @@ function readSettings(scope = "global", target = "claude") {
     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", target = "claude") {
@@ -3883,8 +3893,7 @@ function getTargetEventName(internalEvent, target) {
   return EVENT_MAP[target]?.[internalEvent] || internalEvent;
 }
 function installForTarget(name, scope, overwrite, target) {
-  const hookName = name.startsWith("hook-") ? name : `hook-${name}`;
-  const shortName = hookName.replace("hook-", "");
+  const shortName = shortHookName(name);
   if (!hookExists(shortName)) {
     return { hook: shortName, success: false, error: `Hook '${shortName}' not found`, target };
   }
@@ -3924,7 +3933,7 @@ function registerHook(name, scope = "global", target = "claude") {
   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 }]
   };
@@ -3945,7 +3954,7 @@ function unregisterHook(name, scope = "global", target = "claude") {
   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];
   }
@@ -3976,12 +3985,8 @@ function getRegisteredHooksForTarget(scope = "global", target = "claude") {
 function getRegisteredHooks(scope = "global") {
   return getRegisteredHooksForTarget(scope, "claude");
 }
-function getInstalledHooks(scope = "global") {
-  return getRegisteredHooks(scope);
-}
 function removeHook(name, scope = "global", target = "claude") {
-  const hookName = name.startsWith("hook-") ? name : `hook-${name}`;
-  const shortName = hookName.replace("hook-", "");
+  const shortName = shortHookName(name);
   if (target === "all") {
     const claudeRemoved = removeHookForTarget(shortName, scope, "claude");
     const geminiRemoved = removeHookForTarget(shortName, scope, "gemini");
@@ -3997,7 +4002,7 @@ function removeHookForTarget(name, scope, target) {
   unregisterHook(name, scope, target);
   return true;
 }
-var __dirname2, HOOKS_DIR, EVENT_MAP;
+var __dirname2, HOOKS_DIR, EVENT_MAP, getInstalledHooks;
 var init_installer = __esm(() => {
   init_registry();
   __dirname2 = dirname(fileURLToPath(import.meta.url));
@@ -4016,6 +4021,7 @@ var init_installer = __esm(() => {
       Notification: "Notification"
     }
   };
+  getInstalledHooks = getRegisteredHooks;
 });
 
 // src/mcp/server.ts
@@ -4032,11 +4038,22 @@ 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 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) {
@@ -4071,18 +4088,7 @@ function createHooksServer() {
     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"),
@@ -4095,35 +4101,14 @@ 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 agent settings", {
     name: z.string().describe("Hook name to remove"),
@@ -4252,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, () => {
@@ -4265,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
@@ -4293,7 +4280,8 @@ var {
 // src/cli/index.tsx
 import chalk2 from "chalk";
 import { existsSync as existsSync3, readFileSync as readFileSync3 } from "fs";
-import { join as join3 } from "path";
+import { join as join3, dirname as dirname3 } from "path";
+import { fileURLToPath as fileURLToPath3 } from "url";
 
 // src/cli/components/App.tsx
 import { useState as useState7 } from "react";
@@ -4745,10 +4733,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,
@@ -5311,9 +5301,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,
@@ -5359,11 +5351,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",
@@ -5462,13 +5456,15 @@ function App({ initialHooks, overwrite = false }) {
 init_registry();
 init_installer();
 import { jsxDEV as jsxDEV8 } from "react/jsx-dev-runtime";
+var __dirname4 = dirname3(fileURLToPath3(import.meta.url));
+var pkg2 = JSON.parse(readFileSync3(join3(__dirname4, "..", "package.json"), "utf-8"));
 var program2 = new Command;
 function resolveScope(options) {
   if (options.project)
     return "project";
   return "global";
 }
-program2.name("hooks").description("Install hooks for AI coding agents").version("0.1.1");
+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));
 });

package/dist/index.js

@@ -76,7 +76,7 @@ var HOOKS = [
   {
     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",
@@ -106,7 +106,7 @@ var HOOKS = [
   {
     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",
@@ -331,6 +331,15 @@ import { homedir } from "os";
 import { fileURLToPath } from "url";
 var __dirname2 = dirname(fileURLToPath(import.meta.url));
 var HOOKS_DIR = existsSync(join(__dirname2, "..", "..", "hooks", "hook-gitguard")) ? join(__dirname2, "..", "..", "hooks") : join(__dirname2, "..", "hooks");
+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));
+}
 var EVENT_MAP = {
   claude: {
     PreToolUse: "PreToolUse",
@@ -358,8 +367,7 @@ function getSettingsPath(scope = "global", target = "claude") {
   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));
@@ -370,7 +378,9 @@ function readSettings(scope = "global", target = "claude") {
     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", target = "claude") {
@@ -386,8 +396,7 @@ function getTargetEventName(internalEvent, target) {
   return EVENT_MAP[target]?.[internalEvent] || internalEvent;
 }
 function installForTarget(name, scope, overwrite, target) {
-  const hookName = name.startsWith("hook-") ? name : `hook-${name}`;
-  const shortName = hookName.replace("hook-", "");
+  const shortName = shortHookName(name);
   if (!hookExists(shortName)) {
     return { hook: shortName, success: false, error: `Hook '${shortName}' not found`, target };
   }
@@ -427,7 +436,7 @@ function registerHook(name, scope = "global", target = "claude") {
   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 }]
   };
@@ -448,7 +457,7 @@ function unregisterHook(name, scope = "global", target = "claude") {
   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];
   }
@@ -482,12 +491,9 @@ function getRegisteredHooksForTarget(scope = "global", target = "claude") {
 function getRegisteredHooks(scope = "global") {
   return getRegisteredHooksForTarget(scope, "claude");
 }
-function getInstalledHooks(scope = "global") {
-  return getRegisteredHooks(scope);
-}
+var getInstalledHooks = getRegisteredHooks;
 function removeHook(name, scope = "global", target = "claude") {
-  const hookName = name.startsWith("hook-") ? name : `hook-${name}`;
-  const shortName = hookName.replace("hook-", "");
+  const shortName = shortHookName(name);
   if (target === "all") {
     const claudeRemoved = removeHookForTarget(shortName, scope, "claude");
     const geminiRemoved = removeHookForTarget(shortName, scope, "gemini");