@goodfoot/claude-code-hooks 1.0.1 → 1.0.3

package/README.md

@@ -1,6 +1,6 @@
 # @goodfoot/claude-code-hooks
 
-> **Build Claude Code hooks in TypeScript.**
+**Build Claude Code hooks in TypeScript.**
 
 This package is not just a library; it is a **build system** and a **runtime wrapper**. You write TypeScript, this package compiles it into self-contained executables, and _those_ are what Claude runs.
 
@@ -10,11 +10,11 @@ Load the "claude-code-hooks:sdk" skill to enable Claude to use this package.
 
 Run:
 
-```bash
-claude plugin marketplace add goodfoot-io/marketplace && claude plugin install claude-code-hooks@goodfoot"
+`claude plugin marketplace add goodfoot-io/marketplace && claude plugin install claude-code-hooks@goodfoot"`
 
-claude -p "Load the 'claude-code-hooks:sdk' skill then scaffold a new hook package in ./packages/hooks that outputs to '.claude/hooks/hooks.json' and contains an example SessionStart hook."
-```
+then:
+
+`claude -p "Load the 'claude-code-hooks:sdk' skill then scaffold a new hook package in ./packages/hooks that outputs to '.claude/hooks/hooks.json' and contains an example SessionStart hook."`
 
 ## ⚡ Quick Start
 
@@ -157,9 +157,9 @@ Violating these rules will cause your hooks to fail silently or block Claude ent
 
 1.  **NO `console.log`**: The hook communicates with Claude via `stdout`. If you print "Hello world", you corrupt the JSON protocol.
     - **Bad:** `console.log("Checking command")`
-    - **Good:** `context.logger.info("Checking command")`
-2.  **Relative Paths via Environment Variable**: The generated `hooks.json` uses `node $CLAUDE_PLUGIN_ROOT/hooks/build/` paths.
-    - Compiled hooks are placed in a `build/` subdirectory relative to `hooks.json`.
+    - **Good:** `logger.info("Checking command")`
+2.  **Relative Paths via Environment Variable**: The generated `hooks.json` uses `node $CLAUDE_PLUGIN_ROOT/hooks/bin/` paths.
+    - Compiled hooks are placed in a `bin/` subdirectory relative to `hooks.json`.
     - The `$CLAUDE_PLUGIN_ROOT` environment variable is set by Claude Code at runtime.
     - Use the `--executable` CLI option to specify a custom executable (e.g., `bun`, `/usr/local/bin/node22`).
 3.  **`export default` is Mandatory**: The CLI uses static analysis to find your hooks. It looks specifically for `export default factory(...)`.
@@ -252,7 +252,7 @@ plugins/my-plugin/
 │       ├── block-dangerous.ts
 │       └── inject-context.ts
 ├── hooks.json                    # Build output (auto-loaded by plugin)
-└── build/
+└── bin/
     ├── block-dangerous.abc123.mjs
     └── inject-context.def456.mjs
 ```

package/dist/cli.js

@@ -89,7 +89,7 @@ Examples:
      npx -y @goodfoot/claude-code-hooks -i "hooks/**/*.ts" -o "dist/hooks.json"
 
   2. With Runtime Logging:
-     npx -y @goodfoot/claude-code-hooks -i "src/hooks/*.ts" -o "build/hooks.json" --log /tmp/claude-hooks.log
+     npx -y @goodfoot/claude-code-hooks -i "src/hooks/*.ts" -o "bin/hooks.json" --log /tmp/claude-hooks.log
 
   3. Scaffold a New Hook Project:
      npx -y @goodfoot/claude-code-hooks --scaffold ./my-hooks --hooks Stop,SubagentStop -o dist/hooks.json
@@ -575,19 +575,19 @@ function detectHookContext(outputPath) {
 /**
  * Generates a command path based on the hook context.
  *
- * Calculates the relative path from the root directory to the build directory.
+ * Calculates the relative path from the root directory to the bin directory.
  * Prepends the node executable.
  *
- * - `plugin`: Uses `node $CLAUDE_PLUGIN_ROOT/hooks/build/filename`
- * - `agent`: Uses `node "$CLAUDE_PROJECT_DIR"/.claude/hooks/build/filename`
+ * - `plugin`: Uses `node $CLAUDE_PLUGIN_ROOT/hooks/bin/filename`
+ * - `agent`: Uses `node "$CLAUDE_PROJECT_DIR"/.claude/hooks/bin/filename`
  * @param filename - The compiled hook filename
- * @param buildDir - Absolute path to the build directory
+ * @param buildDir - Absolute path to the bin directory
  * @param contextInfo - Hook context info including root directory
  * @param executable - Node executable path (default: "node")
  * @returns The command path string
  */
 function generateCommandPath(filename, buildDir, contextInfo, executable = 'node') {
-  // Calculate relative path from root to build directory
+  // Calculate relative path from root to bin directory
   const relativeBuildPath = path.relative(contextInfo.rootDir, buildDir);
   // Normalize to forward slashes for cross-platform compatibility
   const normalizedRelativePath = relativeBuildPath.replace(/\\/g, '/');
@@ -603,7 +603,7 @@ function generateCommandPath(filename, buildDir, contextInfo, executable = 'node
  *
  * Format: { hooks: { EventType: [ { matcher?, hooks: [...] } ] } }
  * @param compiledHooks - Array of compiled hooks
- * @param buildDir - Absolute path to the build directory
+ * @param buildDir - Absolute path to the bin directory
  * @param contextInfo - Hook context info for path resolution
  * @param executable - Node executable path (default: "node")
  * @returns The hooks.json structure
@@ -802,8 +802,8 @@ async function main() {
     const cwd = process.cwd();
     const outputPath = path.resolve(cwd, args.output);
     const hooksJsonDir = path.dirname(outputPath);
-    // Compiled hooks go in a 'build' subdirectory relative to hooks.json
-    const buildDir = path.join(hooksJsonDir, 'build');
+    // Compiled hooks go in a 'bin' subdirectory relative to hooks.json
+    const buildDir = path.join(hooksJsonDir, 'bin');
     // Resolve log file path to absolute if provided
     const logFilePath = args.log !== undefined ? path.resolve(cwd, args.log) : undefined;
     log('info', 'Starting hook compilation', {

package/dist/scaffold.js

@@ -181,7 +181,7 @@ function generateBiomeConfig() {
     }
   },
   "files": {
-    "ignore": ["node_modules", "dist", "build", "*.json"]
+    "ignore": ["node_modules", "dist", "bin", "*.json"]
   }
 }
 `;
@@ -220,7 +220,7 @@ node_modules/
 
 # Build outputs
 dist/
-build/
+bin/
 *.mjs
 
 # Generated files
@@ -357,8 +357,8 @@ function generateTestFile(eventName, hookFilename) {
  * Tests for the ${eventName} hook.
  */
 
-import { describe, expect, it } from "vitest";
 import { Logger } from "@goodfoot/claude-code-hooks";
+import { describe, expect, it } from "vitest";
 import hook from "../src/${hookFilename}.js";
 
 // Logger is silent by default (no stdout/stderr output) — no mocking needed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodfoot/claude-code-hooks",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Type-safe Claude Code hooks library with camelCase types and output builders",
   "type": "module",
   "sideEffects": false,
@@ -27,28 +27,18 @@
   },
   "exports": {
     ".": {
-      "import": "./src/index.ts",
-      "types": "./src/index.ts"
+      "import": "./dist/index.js",
+      "types": "./types/index.d.ts"
     },
     "./*": {
-      "import": "./src/*.ts",
-      "types": "./src/*.ts"
+      "import": "./dist/*.js",
+      "types": "./types/*.d.ts"
     }
   },
   "bin": "./dist/cli.js",
   "publishConfig": {
     "bin": {
       "claude-code-hooks": "./dist/cli.js"
-    },
-    "exports": {
-      ".": {
-        "import": "./dist/index.js",
-        "types": "./types/index.d.ts"
-      },
-      "./*": {
-        "import": "./dist/*.js",
-        "types": "./types/*.d.ts"
-      }
     }
   },
   "dependencies": {

package/types/cli.d.ts

@@ -197,13 +197,13 @@ declare function detectHookContext(outputPath: string): HookContextInfo;
 /**
  * Generates a command path based on the hook context.
  *
- * Calculates the relative path from the root directory to the build directory.
+ * Calculates the relative path from the root directory to the bin directory.
  * Prepends the node executable.
  *
- * - `plugin`: Uses `node $CLAUDE_PLUGIN_ROOT/hooks/build/filename`
- * - `agent`: Uses `node "$CLAUDE_PROJECT_DIR"/.claude/hooks/build/filename`
+ * - `plugin`: Uses `node $CLAUDE_PLUGIN_ROOT/hooks/bin/filename`
+ * - `agent`: Uses `node "$CLAUDE_PROJECT_DIR"/.claude/hooks/bin/filename`
  * @param filename - The compiled hook filename
- * @param buildDir - Absolute path to the build directory
+ * @param buildDir - Absolute path to the bin directory
  * @param contextInfo - Hook context info including root directory
  * @param executable - Node executable path (default: "node")
  * @returns The command path string
@@ -219,7 +219,7 @@ declare function generateCommandPath(
  *
  * Format: { hooks: { EventType: [ { matcher?, hooks: [...] } ] } }
  * @param compiledHooks - Array of compiled hooks
- * @param buildDir - Absolute path to the build directory
+ * @param buildDir - Absolute path to the bin directory
  * @param contextInfo - Hook context info for path resolution
  * @param executable - Node executable path (default: "node")
  * @returns The hooks.json structure