@cg3/equip 0.2.16 → 0.2.17

package/README.md

@@ -44,9 +44,9 @@ Some platforms support **lifecycle hooks** — scripts that run automatically at
 | Claude Code | ✅ | `PostToolUseFailure`, `Stop`, `PreToolUse`, `PostToolUse` |
 | All others | ❌ | — |
 
-When hooks are supported, equip installs lightweight Node.js scripts to `~/.prior/hooks/` and registers them in the platform's settings. Hooks are a **silent enhancement** — if the platform doesn't support them, equip installs only MCP + rules without any error or warning.
+When hooks are supported, equip writes the consumer-provided scripts to a configurable directory (default: `~/.${name}/hooks/`) and registers them in the platform's settings. Hooks are a **silent enhancement** — if the platform doesn't support them, equip installs only MCP + rules without any error or warning.
 
-Hooks are opt-in per platform via the capabilities model. As more platforms add hook support, equip can enable them without consumer code changes.
+Hook scripts and event bindings are defined by the consumer (your package), not by equip. Equip provides only the installation infrastructure — capabilities detection, file writing, settings registration, and cleanup. As more platforms add hook support, equip can enable them without consumer code changes.
 
 ## Quick Start
 

package/index.js

@@ -3,6 +3,9 @@
 
 "use strict";
 
+const path = require("path");
+const os = require("os");
+
 const { detectPlatforms, whichSync, dirExists, fileExists } = require("./lib/detect");
 const { readMcpEntry, buildHttpConfig, buildHttpConfigWithAuth, buildStdioConfig, installMcp, installMcpJson, installMcpToml, uninstallMcp, updateMcpKey, parseTomlServerEntry, parseTomlSubTables, buildTomlEntry, removeTomlEntry } = require("./lib/mcp");
 const { parseRulesVersion, installRules, uninstallRules, markerPatterns } = require("./lib/rules");
@@ -42,7 +45,7 @@ class Equip {
    * @param {string} [config.hooks[].matcher] - Regex matcher for event filtering (e.g., "Bash")
    * @param {string} config.hooks[].script - Hook script content (Node.js)
    * @param {string} config.hooks[].name - Script filename (without .js extension)
-   * @param {string} [config.hookDir] - Directory for hook scripts (default: ~/.prior/hooks)
+   * @param {string} [config.hookDir] - Directory for hook scripts (default: ~/.${name}/hooks)
    */
   constructor(config) {
     if (!config.name) throw new Error("Equip: name is required");
@@ -53,7 +56,7 @@ class Equip {
     this.rules = config.rules || null;
     this.stdio = config.stdio || null;
     this.hookDefs = config.hooks || null;
-    this.hookDir = config.hookDir || null;
+    this.hookDir = config.hookDir || path.join(os.homedir(), `.${config.name}`, "hooks");
   }
 
   /**

package/lib/hooks.js

@@ -78,9 +78,9 @@ function installHooks(platform, hookDefs, options = {}) {
   const caps = getHookCapabilities(platform.platform);
   if (!caps || !hookDefs || hookDefs.length === 0) return null;
 
-  const hookDir = options.hookDir || path.join(os.homedir(), ".prior", "hooks");
+  if (!options.hookDir) throw new Error("hookDir is required");
+  const hookDir = options.hookDir;
   const dryRun = options.dryRun || false;
-  const marker = options.marker || "prior";
 
   // 1. Write hook scripts
   const installedScripts = [];
@@ -145,7 +145,8 @@ function uninstallHooks(platform, hookDefs, options = {}) {
   const caps = getHookCapabilities(platform.platform);
   if (!caps || !hookDefs || hookDefs.length === 0) return false;
 
-  const hookDir = options.hookDir || path.join(os.homedir(), ".prior", "hooks");
+  if (!options.hookDir) throw new Error("hookDir is required");
+  const hookDir = options.hookDir;
   const dryRun = options.dryRun || false;
   let removed = false;
 
@@ -206,7 +207,8 @@ function hasHooks(platform, hookDefs, options = {}) {
   const caps = getHookCapabilities(platform.platform);
   if (!caps || !hookDefs || hookDefs.length === 0) return false;
 
-  const hookDir = options.hookDir || path.join(os.homedir(), ".prior", "hooks");
+  if (!options.hookDir) throw new Error("hookDir is required");
+  const hookDir = options.hookDir;
 
   // Check scripts exist
   for (const def of hookDefs) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cg3/equip",
-  "version": "0.2.16",
+  "version": "0.2.17",
   "description": "Universal MCP + behavioral rules installer for AI coding agents",
   "main": "index.js",
   "bin": {