@zeph-to/cli 1.24.0 → 1.25.0

package/README.md

@@ -43,6 +43,12 @@ on *every* notification. For notifications only, with no phone control,
 `npx @zeph-to/cli install` is a lighter alternative that skips the global
 binary.
 
+Once installed, the hooks fire in **every** session of each configured
+agent — `zeph cc` is the phone-control bridge, not the notification
+switch. Turn the volume down without uninstalling: `/zeph-quiet --global`
+(blockers only, all projects), `/zeph-mute` (silence, current project),
+`/zeph-status` (what's in effect). See [Mute & push mode](#mute--push-mode).
+
 `~/.zeph/config.json` is the single source of truth — the CLI, the MCP
 server, the plugin hooks, and the listener all read it. You never need
 `ZEPH_API_KEY`-style env vars for a normal setup; they exist as overrides
@@ -363,7 +369,7 @@ zeph notify --title "Hello" --json
 | `--priority <p>` | Priority: `low`, `normal`, `high`, `urgent` |
 | `--device <id>` | Target device ID |
 | `--session <id>` | AI session ID so the push threads into that session's chat (or `ZEPH_SESSION_ID` env) |
-| `--auto` | Apply the push gate before sending — honors the `/zeph-quiet` / `/zeph-loud` push-mode dial; gated-out exits silently with code 0 |
+| `--auto` | Apply the push gate before sending — honors the `/zeph-quiet` / `/zeph-loud` push-mode dial, per project or machine-wide (`--global`); gated-out exits silently with code 0 |
 | `--marker <m>` | Push Signal marker for `--auto`: `skip`, `push`, `high` |
 | `--tools <n>`, `--nonreadonly <n>` | Turn tool counts feeding `--auto`'s heuristic (defaults assume real work) |
 
@@ -401,23 +407,45 @@ code 3 instead of looping forever — fix the key and restart.
 | `--json` | Output JSON format |
 | `--version` | Print version |
 
-### Mute
+### Mute & push mode
 
-Mute is project-scoped (uses project directory hash). Created by Claude
-Code `/zeph-mute` command.
+Both live as state files under `${XDG_STATE_HOME:-~/.local/state}/zeph`,
+keyed by a `cksum` hash of the project directory. Claude Code's
+`/zeph-mute` / `/zeph-quiet` / `/zeph-loud` / `/zeph-normal` write them;
+the CLI reads them (mute on every `notify`, push mode on `--auto`).
 
 Notifications are silently skipped when a mute file exists for the
 current project:
 
 ```bash
-# Mute (created by /zeph-mute in Claude Code plugin)
-HASH=$(echo -n "$PROJECT_DIR" | cksum | cut -d' ' -f1)
-touch /tmp/zeph-muted-$HASH
+STATE_DIR="${XDG_STATE_HOME:-$HOME/.local/state}/zeph"
+HASH=$(printf '%s' "$PROJECT_DIR" | cksum | cut -d' ' -f1)
+
+# Mute (created by /zeph-mute in the Claude Code plugin)
+mkdir -p "$STATE_DIR" && touch "$STATE_DIR/muted-$HASH"
 
 # Unmute
-rm /tmp/zeph-muted-$HASH
+rm -f "$STATE_DIR/muted-$HASH"
 ```
 
+Push mode is a one-word file (`quiet` / `loud` / `normal`) resolved in
+this order — first hit wins:
+
+| Order | File | Set by |
+|-------|------|--------|
+| 1 | `$STATE_DIR/pushmode-<hash>` | `/zeph-quiet` · `/zeph-loud` · `/zeph-normal` |
+| 2 | `/tmp/zeph-pushmode-<hash>` | older versions (honored only when you own the file) |
+| 3 | `$STATE_DIR/pushmode-default` | `/zeph-quiet --global` — the machine-wide default |
+| 4 | *(none)* | `normal` |
+
+So `/zeph-quiet --global` quiets every project that has no dial of its
+own, and a per-project dial always overrides it. Mute has no `-default`
+form on purpose: it is keyed on presence, not content, so a global mute
+could never be lifted for a single project.
+
+Legacy `/tmp/zeph-muted-<hash>` files are still honored when owned by the
+current user (the state dir moved out of world-writable `/tmp`).
+
 The CLI checks `CLAUDE_PROJECT_DIR`, `CURSOR_PROJECT_DIR`,
 `WINDSURF_PROJECT_DIR`, and falls back to `cwd`.
 

package/dist/gate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gate.d.ts","sourceRoot":"","sources":["../src/gate.ts"],"names":[],"mappings":"AAyBA,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAC3D,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEvD,MAAM,WAAW,SAAS;IACxB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,gBAAgB,EAAE,MAAM,CAAC;IACzB,yDAAyD;IACzD,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAAC;CAC7B;AAED;;;;;GAKG;AACH,eAAO,MAAM,aAAa;;;;CAIhB,CAAC;AAEX,eAAO,MAAM,eAAe,GAAI,KAAK,MAAM,GAAG,SAAS,KAAG,UACS,CAAC;AAEpE,eAAO,MAAM,iBAAiB,GAAI,KAAK,MAAM,GAAG,SAAS,KAAG,YACR,CAAC;AAErD,eAAO,MAAM,UAAU,GAAI,OAAO,SAAS,KAAG,WAW7C,CAAC;AAeF,eAAO,MAAM,QAAQ,QAAO,MACoD,CAAC;AAmBjF,eAAO,MAAM,WAAW,GAAI,KAAK,MAAM,KAAG,MAAM,GAAG,IAOlD,CAAC;AAWF,+EAA+E;AAC/E,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,KAAG,MAA4C,CAAC;AAE7F;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,KAAG,MAG1B,CAAC;AAEnB,0DAA0D;AAC1D,eAAO,MAAM,OAAO,GAAI,KAAK,MAAM,KAAG,OAGrC,CAAC;AAEF,oFAAoF;AACpF,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,KAAG,YAU1C,CAAC"}
+{"version":3,"file":"gate.d.ts","sourceRoot":"","sources":["../src/gate.ts"],"names":[],"mappings":"AAyBA,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAC3D,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEvD,MAAM,WAAW,SAAS;IACxB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,qDAAqD;IACrD,gBAAgB,EAAE,MAAM,CAAC;IACzB,yDAAyD;IACzD,YAAY,EAAE,OAAO,CAAC;IACtB,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAAC;CAC7B;AAED;;;;;GAKG;AACH,eAAO,MAAM,aAAa;;;;CAIhB,CAAC;AAEX,eAAO,MAAM,eAAe,GAAI,KAAK,MAAM,GAAG,SAAS,KAAG,UACS,CAAC;AAEpE,eAAO,MAAM,iBAAiB,GAAI,KAAK,MAAM,GAAG,SAAS,KAAG,YACR,CAAC;AAErD,eAAO,MAAM,UAAU,GAAI,OAAO,SAAS,KAAG,WAW7C,CAAC;AAeF,eAAO,MAAM,QAAQ,QAAO,MACoD,CAAC;AA2BjF,eAAO,MAAM,WAAW,GAAI,KAAK,MAAM,KAAG,MAAM,GAAG,IAOlD,CAAC;AAWF,+EAA+E;AAC/E,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,KAAG,MAA4C,CAAC;AAE7F;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,KAAG,MAG1B,CAAC;AAEnB,0DAA0D;AAC1D,eAAO,MAAM,OAAO,GAAI,KAAK,MAAM,KAAG,OAGrC,CAAC;AAEF,oFAAoF;AACpF,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,KAAG,YAU1C,CAAC"}

package/dist/gate.js

@@ -78,13 +78,23 @@ const ownedByCurrentUser = (path) => {
         return false;
     }
 };
-/** Resolve a state file: current location first, then user-owned legacy /tmp. */
+/**
+ * Resolve a state file: current location first, then user-owned legacy /tmp,
+ * then — for `pushmode` only — the machine-wide default written by
+ * `/zeph-quiet --global`. Mirrors plugin/hooks/gate.sh zeph_state_present,
+ * including the deliberate absence of a global mute (see the comment there).
+ */
 const findStateFile = (kind, hash) => {
     const current = (0, path_1.join)((0, exports.stateDir)(), `${kind}-${hash}`);
     if ((0, fs_1.existsSync)(current))
         return current;
     const legacy = `/tmp/zeph-${kind}-${hash}`;
-    return ownedByCurrentUser(legacy) ? legacy : null;
+    if (ownedByCurrentUser(legacy))
+        return legacy;
+    if (kind !== 'pushmode')
+        return null;
+    const globalDefault = (0, path_1.join)((0, exports.stateDir)(), 'pushmode-default');
+    return (0, fs_1.existsSync)(globalDefault) ? globalDefault : null;
 };
 const projectHash = (dir) => {
     try {

package/dist/installer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../src/installer.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AA4BzC;;;GAGG;AACH;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,YAAY,MAAM,GAAG,SAAS,EAAE,SAAS,OAAO,KAAG,OACxD,CAAC;AAoBzB;6EAC6E;AAC7E,eAAO,MAAM,aAAa,GAAI,UAAU,MAAM,EAAE,OAAO,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,IAqBhF,CAAC;AAgQF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAAI,UAAU,KAAK,EAAE,EAAE,MAAM,MAAM,KAAG,KAAK,EAKxE,CAAC;AA8EF,eAAO,MAAM,aAAa,GAAU,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAG,OAAO,CAAC,MAAM,CAkG1F,CAAC"}
+{"version":3,"file":"installer.d.ts","sourceRoot":"","sources":["../src/installer.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AA4BzC;;;GAGG;AACH;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,YAAY,MAAM,GAAG,SAAS,EAAE,SAAS,OAAO,KAAG,OACxD,CAAC;AAoBzB;6EAC6E;AAC7E,eAAO,MAAM,aAAa,GAAI,UAAU,MAAM,EAAE,OAAO,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,IAqBhF,CAAC;AAgQF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,GAAI,UAAU,KAAK,EAAE,EAAE,MAAM,MAAM,KAAG,KAAK,EAKxE,CAAC;AA8EF,eAAO,MAAM,aAAa,GAAU,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAG,OAAO,CAAC,MAAM,CA4G1F,CAAC"}

package/dist/installer.js

@@ -485,6 +485,15 @@ const handleInstall = async (args) => {
     console.log('\n  Testing connection...');
     await testConnection(apiKey, baseUrl);
     console.log('\n  Done! Restart your agents.\n');
+    // The single most-reported surprise: pushes are not scoped to `zeph cc`.
+    // Hooks fire for every session of every configured agent, so say it here —
+    // at the moment the hooks get installed — together with the volume dials.
+    console.log('  Notifications now fire for EVERY session of each agent above');
+    console.log('  (not only sessions launched with `zeph cc`). Dial the volume');
+    console.log('  any time — in Claude Code:');
+    console.log('    /zeph-quiet --global   only blockers + high-priority, all projects');
+    console.log('    /zeph-mute             full silence, current project');
+    console.log('    /zeph-status           show what is in effect\n');
     return 0;
 };
 exports.handleInstall = handleInstall;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zeph-to/cli",
-  "version": "1.24.0",
+  "version": "1.25.0",
   "description": "Zeph CLI + push notification SDK for AI agents",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",