auriga-cli 1.1.0 → 1.2.0

package/README.md

@@ -76,7 +76,7 @@ Installs Claude Code hooks into a chosen scope. Each hook is self-contained unde
 
 | Hook | Description |
 |---|---|
-| notify | Native macOS notification when Claude needs your attention. Auto-installs `terminal-notifier` via Homebrew. Customize sound and icon by editing `.claude/hooks/notify/config.json` and replacing `.claude/hooks/notify/icon.png`. macOS-only at runtime; silent no-op on other platforms. |
+| notify | Native macOS notification when Claude needs your attention. Shows the brand mark in the small app-icon position, with click-to-activate that brings the originating terminal back to the foreground. Auto-installs `alerter` via Homebrew (`vjeantet/tap/alerter`). Customize sound and icon by editing `.claude/hooks/notify/config.json` and replacing `.claude/hooks/notify/icon.png`. macOS-only at runtime; silent no-op on other platforms. |
 
 Scope choices:
 
@@ -90,7 +90,7 @@ Re-running the installer preserves your customized `config.json` and `icon.png`,
 
 - Node.js >= 18
 - [Claude Code](https://docs.anthropic.com/en/docs/claude-code) (required for Plugins and Hooks modules)
-- [Homebrew](https://brew.sh) (recommended for the `notify` hook to install `terminal-notifier`)
+- [Homebrew](https://brew.sh) (recommended for the `notify` hook to install `alerter`)
 
 ## License
 

package/README.zh-CN.md

@@ -76,7 +76,7 @@ npx auriga-cli
 
 | Hook | 说明 |
 |---|---|
-| notify | 当 Claude 需要你关注时弹一条原生 macOS 通知。会自动通过 Homebrew 安装 `terminal-notifier`。改 `.claude/hooks/notify/config.json` 即可换提示音、替换 `.claude/hooks/notify/icon.png` 即可换图标。仅 macOS 运行时生效，其它平台静默 no-op。 |
+| notify | 当 Claude 需要你关注时弹一条原生 macOS 通知。在通知小图标位显示品牌图，点击通知可把发起 Claude 的终端拉回前台。会自动通过 Homebrew 安装 `alerter`（`vjeantet/tap/alerter`）。改 `.claude/hooks/notify/config.json` 即可换提示音、替换 `.claude/hooks/notify/icon.png` 即可换图标。仅 macOS 运行时生效，其它平台静默 no-op。 |
 
 作用域选择：
 
@@ -90,7 +90,7 @@ npx auriga-cli
 
 - Node.js >= 18
 - [Claude Code](https://docs.anthropic.com/en/docs/claude-code)（Plugins 和 Hooks 模块需要）
-- [Homebrew](https://brew.sh)（`notify` hook 用来安装 `terminal-notifier`，可选）
+- [Homebrew](https://brew.sh)（`notify` hook 用来安装 `alerter`，可选）
 
 ## License
 

package/dist/hooks.d.ts

@@ -73,6 +73,7 @@ export declare function removeHookFromSettings(settings: SettingsFile, marker: s
     removed: number;
 };
 type Scope = "project-local" | "project" | "user";
+export declare function depBinary(dep: HookDep): string;
 export declare function loadHooksConfig(packageRoot: string): HooksConfig;
 export interface InstallHookResult {
     hook: string;

package/dist/hooks.js

@@ -12,7 +12,12 @@ import { exec, fetchExtraContentBinary, log, withEsc, } from "./utils.js";
 // for every user running `npx auriga-cli`. Validate every untrusted value
 // once at load time, then trust it through the rest of the install flow.
 const HOOK_NAME_RE = /^[a-z][a-z0-9-]*$/;
-const DEP_NAME_RE = /^[a-z0-9][a-z0-9._+-]*$/;
+// Matches a flat brew formula name (`jq`, `pngquant`) OR a fully
+// qualified tap-prefixed name (`vjeantet/tap/alerter`) — up to 2
+// slashes separating segments. Each segment is the same charset as
+// the flat-name form. No shell metachars; safe to pass to `brew install`
+// as a single argv item.
+const DEP_NAME_RE = /^[a-z0-9][a-z0-9._+-]*(\/[a-z0-9][a-z0-9._+-]*){0,2}$/;
 const EVENT_NAME_RE = /^[A-Za-z][A-Za-z0-9_-]*$/;
 // Whitelist for hook command templates. The registry is fetched from raw
 // GitHub at runtime, and the command string is written verbatim into
@@ -252,9 +257,19 @@ function scopeChoices() {
         },
     ];
 }
+// brew package names can be tap-prefixed (`vjeantet/tap/alerter`) but
+// the binary the formula installs into PATH is the bare formula name
+// (`alerter`). Strip the tap prefix to get the binary to `which` for.
+// Hook authors with a brew package whose binary name doesn't match the
+// formula name will need to ship a wrapper `bin` field in the future;
+// no such hook exists today.
+export function depBinary(dep) {
+    const segments = dep.name.split("/");
+    return segments[segments.length - 1];
+}
 function depReady(dep) {
     try {
-        exec(`which ${dep.name}`);
+        exec(`which ${depBinary(dep)}`);
         return true;
     }
     catch {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "auriga-cli",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Interactive CLI to install Claude Code harness modules (Workflow, Skills, Recommended Skills, Plugins, Hooks)",
   "type": "module",
   "bin": {